feat: add monorepo to template

docs/superpowers/plans/2026-03-16-typescript-monorepo-template.md

@@ -0,0 +1,99 @@
+# TypeScript Monorepo Template Implementation Plan
+
+> **For agentic workers:** REQUIRED: Use superpowers:subagent-driven-development (if subagents available) or superpowers:executing-plans to implement this plan. Steps use checkbox (`- [ ]`) syntax for tracking.
+
+**Goal:** Replace the minimal starter template with a Bun-only Moonrepo + TypeScript + Varlock monorepo template exposed through the existing flake template.
+
+**Architecture:** Expand `template/` into a complete repository skeleton while keeping `repo-lib.lib.mkRepo` as the integration point. Adapt the strict TypeScript config layout and Varlock command pattern from `../moon`, and update release tests so they evaluate the full template contents.
+
+**Tech Stack:** Nix flakes, repo-lib, Bun, Moonrepo, Varlock, TypeScript
+
+---
+
+## Chunk 1: Documentation Baseline
+
+### Task 1: Update public template docs
+
+**Files:**
+- Modify: `README.md`
+
+- [ ] **Step 1: Write the failing expectation mentally against current docs**
+
+Current docs describe only a minimal starter template and do not mention Bun, Moonrepo, or Varlock.
+
+- [ ] **Step 2: Update the README to describe the new template**
+
+Document the generated workspace shape and first-run commands.
+
+- [ ] **Step 3: Verify the README content is consistent with the template files**
+
+Check all commands and filenames against the final template layout.
+
+## Chunk 2: Template Skeleton
+
+### Task 2: Replace the minimal template with a real monorepo skeleton
+
+**Files:**
+- Modify: `template/flake.nix`
+- Create: `template/package.json`
+- Create: `template/bunfig.toml`
+- Create: `template/moon.yml`
+- Create: `template/tsconfig.json`
+- Create: `template/tsconfig.options.json`
+- Create: `template/tsconfig/browser.json`
+- Create: `template/tsconfig/bun.json`
+- Create: `template/tsconfig/package.json`
+- Create: `template/tsconfig/runtime.json`
+- Create: `template/.env.schema`
+- Modify: `template/.gitignore`
+- Create: `template/README.md`
+- Create: `template/apps/.gitkeep`
+- Create: `template/packages/.gitkeep`
+
+- [ ] **Step 1: Add or update template files**
+
+Use `../moon` as the source for Moonrepo, Varlock, and TypeScript patterns, removing product-specific details.
+
+- [ ] **Step 2: Verify the template tree is coherent**
+
+Check that all referenced files exist and that scripts reference only template-safe commands.
+
+## Chunk 3: Test Coverage
+
+### Task 3: Update release tests for the full template
+
+**Files:**
+- Modify: `tests/release.sh`
+
+- [ ] **Step 1: Add a failing test expectation**
+
+The current template fixture copies only `template/flake.nix`, which is insufficient for the new template layout.
+
+- [ ] **Step 2: Update fixture creation to copy the full template**
+
+Rewrite template URL references in copied files as needed for local test evaluation.
+
+- [ ] **Step 3: Verify the existing template evaluation case now uses the real skeleton**
+
+Confirm `nix flake show` runs against the expanded template fixture.
+
+## Chunk 4: Verification
+
+### Task 4: Run template verification
+
+**Files:**
+- Verify: `README.md`
+- Verify: `template/**/*`
+- Verify: `tests/release.sh`
+
+- [ ] **Step 1: Run the release test suite**
+
+Run: `nix develop -c bash tests/release.sh`
+
+- [ ] **Step 2: Inspect the template file tree**
+
+Run: `find template -maxdepth 3 -type f | sort`
+
+- [ ] **Step 3: Verify the README examples still match the tagged template release pattern**
+
+Check that versioned `repo-lib` URLs remain in the documented commands and release replacements.

docs/superpowers/specs/2026-03-16-typescript-monorepo-template-design.md

@@ -0,0 +1,88 @@
+# TypeScript Monorepo Template Design
+
+## Goal
+
+Add a new default template to this repository that generates a Bun-only TypeScript monorepo using Moonrepo, Varlock, and the shared TypeScript configuration pattern from `../moon`.
+
+## Scope
+
+The generated template should include:
+
+- a Nix flake wired through `repo-lib.lib.mkRepo`
+- Bun-only JavaScript tooling
+- Moonrepo root configuration
+- strict shared TypeScript configs adapted from `../moon`
+- Varlock enabled from day one
+- a committed `.env.schema`
+- empty `apps/` and `packages/` directories
+- minimal documentation for first-run setup
+
+The template should not include:
+
+- demo apps or packages
+- product-specific environment variables or OpenBao paths from `../moon`
+- Node or pnpm support
+
+## Architecture
+
+The existing `template/` directory remains the exported flake template. Instead of containing only a starter `flake.nix`, it will become a complete repository skeleton.
+
+The generated repository will keep the current `repo-lib` integration pattern:
+
+- `template/flake.nix` calls `repo-lib.lib.mkRepo`
+- the shell provisions Bun, Moonrepo CLI, Varlock, and supporting tooling
+- repo checks remain driven through `mkRepo` and Lefthook
+
+Moonrepo and Varlock will be configured at the workspace root. The template will expose root tasks and scripts that work even before any projects are added.
+
+## Template Contents
+
+The template should contain:
+
+- `flake.nix`
+- `package.json`
+- `bunfig.toml`
+- `moon.yml`
+- `tsconfig.json`
+- `tsconfig.options.json`
+- `tsconfig/browser.json`
+- `tsconfig/bun.json`
+- `tsconfig/package.json`
+- `tsconfig/runtime.json`
+- `.env.schema`
+- `.gitignore`
+- `README.md`
+- `apps/.gitkeep`
+- `packages/.gitkeep`
+
+It may also keep generic repo support files already useful in templates, such as `.envrc`, `.gitlint`, `.gitleaks.toml`, `.vscode/settings.json`, and `flake.lock`, as long as they remain template-safe.
+
+## Data And Command Flow
+
+On first use:
+
+1. the user creates a repo from the flake template
+2. the shell provides Bun, Moonrepo, Varlock, and release support
+3. `bun install` installs `@moonrepo/cli`, `varlock`, and TypeScript-related dependencies
+4. entering the repo loads `varlock/auto-load`
+5. root commands like `bun run env:check`, `bun run env:scan`, and `moon run :typecheck` work without any sample projects
+
+## Varlock Design
+
+The template will include a minimal `.env.schema` with:
+
+- one canonical environment selector
+- safe local defaults where practical
+- placeholders for OpenBao-backed secrets using generic template paths
+
+Root scripts in `package.json` will follow the `../moon` pattern for `env:check` and `env:scan`, including `BAO_*` and `OPENBAO_*` compatibility exports. The template will not encode any product-specific namespace names.
+
+## Testing
+
+Existing release tests must continue to validate the exported template. The template fixture helper in `tests/release.sh` will need to copy the full template directory, not only `template/flake.nix`, so `nix flake show` exercises the real generated repository structure.
+
+## Risks
+
+- Moonrepo root task behavior must remain valid with no projects present.
+- Template-safe Varlock defaults must avoid broken first-run behavior while still demonstrating the intended pattern.
+- The release test harness must not accidentally preserve upstream URLs inside the copied template.