bsmnt 0.1.2 → 0.2.0

package/changelog/04-02-26.md

@@ -1,86 +0,0 @@
-# Changelog
-
-## [Unreleased] - Worktree Management
-
-### Added
-
-#### Git Worktree Management (`-w`, `--worktree`)
-
-A new CLI mode for managing git worktrees, enabling isolated development environments for parallel feature work.
-
-**New Commands:**
-
-| Flag | Long Flag | Description |
-|------|-----------|-------------|
-| `-w` | `--worktree` | Interactive worktree menu |
-| `-wc` | `--worktree-create` | Create new worktree(s) |
-| `-wl` | `--worktree-list` | List all worktrees for current project |
-| `-ws` | `--worktree-switch` | Get cd command to switch to a worktree |
-| `-wr` | `--worktree-remove` | Remove a worktree |
-| `-wp` | `--worktree-prune` | Clean up stale worktrees |
-
-**Options:**
-
-| Flag | Description |
-|------|-------------|
-| `-b=<name>` | Specify branch name (supports comma-separated for multiple) |
-| `-db`, `--delete-branch` | Delete branch when removing worktree |
-| `-f`, `--force` | Skip confirmation prompts |
-
-**Features:**
-
-- **Multiple worktree creation**: Create several worktrees at once via interactive prompts or comma-separated flag values
-- **Auto-dependency installation**: Detects and installs dependencies based on lock files:
-  - `bun.lock` / `bun.lockb` → `bun install`
-  - `pnpm-lock.yaml` → `pnpm install`
-  - `yarn.lock` → `yarn install`
-  - `package.json` (no lock) → `npm install`
-  - `Cargo.toml` → `cargo build`
-  - `requirements.txt` → `pip install -r requirements.txt`
-  - `pyproject.toml` → `poetry install` or `pip install -e .`
-  - `go.mod` → `go mod download`
-- **Smart directory structure**: Worktrees stored in `~/.claude/worktrees/<project>/<branch>`
-- **Branch name sanitization**: Converts `feature/auth` to `feature-auth` for directory names
-- **Prune command**: Cleans up stale git references and orphaned directories
-
-**Examples:**
-
-```bash
-# Interactive worktree management
-basement -w
-
-# Create single worktree
-basement -wc -b=feature/auth
-
-# Create multiple worktrees at once
-basement -wc -b=feature/auth,feature/dashboard,fix/bug-123
-
-# List all worktrees
-basement -wl
-
-# Remove worktree and delete branch
-basement -wr -b=feature/auth -db -f
-
-# Clean up stale worktrees
-basement -wp
-```
-
-### Files Added
-
-- `src/commands/worktree.js` - Worktree command implementation
-
-### Files Modified
-
-- `bin/index.js` - Added worktree mode, flags, routing, and help text
-
----
-
-## Previous Releases
-
-### Sanity Integration Branch
-
-- Added `add-integration` command (`-a`, `--add`)
-- Sanity CMS integration with revalidate API
-- Support for Next.js projects with `src/` directory structure
-- Layout merging for Sanity integration
-- Updated sitemap paths for Sanity content

package/changelog/05-02-26.md

@@ -1,101 +0,0 @@
-# Changelog — February 5, 2026
-
-## Sanity Integration Overhaul
-
-### Added
-
-#### Automated Sanity Project Setup (`setup-sanity.js`)
-
-A new 8-step automated setup flow that provisions a Sanity project without leaving the CLI.
-
-**Steps performed automatically:**
-1. Verify Sanity CLI is available
-2. Check user authentication (prompts `sanity login` if needed)
-3. Create Sanity project via `sanity projects create`
-4. Create an API read token via the Sanity Management API
-5. Write credentials to `.env.local`
-6. Deploy a CORS origin for `localhost:3000`
-7. Create an initial dataset (`production`)
-8. Display a summary with project ID, dataset, and Studio URL
-
-Wired into both `create.js` (step 5.5) and `add-integration.js` (step 7) — if auto-setup is skipped or fails, the CLI falls back to manual credential instructions.
-
-#### `add-integration` Command (`-a`, `--add`)
-
-Post-scaffold command to inject a CMS integration into an existing Next.js project.
-
-- Validates the target is a Next.js App Router project
-- Supports Sanity and BaseHub integrations
-- Automatically injects dependencies, scripts, and CMS files
-- Registers the Sanity MCP server (`claude mcp add`) when Claude Code is detected
-- Installs `sanity-io/agent-toolkit` skills for AI-assisted workflows
-- Conditional next-steps messaging based on whether auto-setup succeeded
-
-#### Smart Merge System (`src/mergers/`)
-
-CMS-specific file mergers that intelligently inject integration code into existing project files instead of blindly overwriting them.
-
-| Merger | File | What it does |
-|--------|------|--------------|
-| `layout-merger.js` | `app/layout.tsx` | Injects Sanity providers, draft-mode components, and imports |
-| `sitemap-merger.js` | `app/sitemap.ts` | Adds Sanity content routes to the sitemap generator |
-| `check-integration-merger.js` | `lib/integrations/check-integration.ts` | Registers Sanity in the integration check map |
-| `config.js` | — | File classification config (merge vs. copy vs. skip) |
-| `index.js` | — | Orchestrator: detects `src/` prefix, resolves mergers, handles fallbacks |
-
-**Key features:**
-- Auto-detects `src/` directory structure and adjusts all paths accordingly
-- Downloads integration files from a dedicated branch (`#sanity-integration`)
-- Falls back to direct copy when no merger is defined for a file
-
-#### Sanity MCP Server & Agent Toolkit
-
-- Registers `https://mcp.sanity.io` as an MCP server during setup (Claude Code projects)
-- Installs `sanity-io/agent-toolkit` skills via `bunx skills add`
-
-#### Integration Files (moved to `integrations/sanity/`)
-
-Sanity CMS files are now centralized under `integrations/sanity/` instead of being duplicated across all four templates:
-
-- `app/studio/[[...tool]]/page.tsx` — Embedded Sanity Studio route
-- `app/studio/layout.tsx` — Studio layout (passthrough, no nested `<html>`)
-- `app/api/revalidate/route.ts` — On-demand ISR revalidation webhook
-- `app/api/draft-mode/{enable,disable}/route.ts` — Draft mode toggle
-- `app/layout.tsx` — Layout with Sanity providers
-- `app/sitemap.ts` — Sitemap with Sanity content routes
-- `lib/integrations/sanity/` — Client, schemas, queries, types, structure
-- `lib/integrations/check-integration.ts` — Integration checker
-- `lib/scripts/generate-page.ts` — Page scaffolding with Sanity schema support
-- `lib/utils/metadata.ts` — Sanity-aware metadata helpers
-- `components/ui/sanity-image/` — Sanity image component
-
-### Fixed
-
-#### Studio Hydration Errors
-
-`app/studio/layout.tsx` previously rendered its own `<html>` and `<body>` tags, causing React hydration mismatches when nested inside the root layout. The layout now passes `children` through directly.
-
-### Changed
-
-- **Templates cleaned up** — Removed duplicated Sanity files from `template/{default,webgl,webgpu,experiment}/`. Sanity is now injected at build time via the merger system.
-- **Removed `sanity:mcp` script** — The `copy-sanity-mcp.ts` script and its `package.json` entry were removed in favor of direct MCP registration via `claude mcp add`.
-- **`create.js` updated** — Sanity auto-setup (step 5.5), MCP registration (step 5.6), and conditional next-steps messaging added.
-- **`CLAUDE.md` updated** — Added guidance that nested layouts must not render `<html>` or `<body>` tags.
-
-### Files Added
-
-- `src/commands/setup-sanity.js`
-- `src/commands/add-integration.js`
-- `src/mergers/index.js`
-- `src/mergers/config.js`
-- `src/mergers/layout-merger.js`
-- `src/mergers/sitemap-merger.js`
-- `src/mergers/check-integration-merger.js`
-- `integrations/sanity/` (all CMS files)
-
-### Files Modified
-
-- `bin/index.js` — Added `--add` / `-a` flag routing
-- `src/commands/create.js` — Sanity auto-setup, MCP registration, agent toolkit
-- `CLAUDE.md` — Nested layout guidance
-- `package.json` — Updated dependencies

package/changelog/09-02-26.md

@@ -1,83 +0,0 @@
-# Changelog — February 9, 2026
-
-## Dynamic Layer Architecture (next-starter migration)
-
-Replaced the duplicated full-template system with a layer-based architecture. The CLI now clones `basementstudio/next-starter` as the base for all project types and overlays technology-specific layers on top, eliminating ~27,000 lines of duplicated code.
-
-### Added
-
-#### Layer Configuration System (`src/mergers/config.js`)
-
-Centralized configuration that defines per-layer dependencies, scripts, and dev dependencies.
-
-**Supported layers:**
-
-| Layer | Key Dependencies |
-|-------|-----------------|
-| `default` | (base next-starter, no extra deps) |
-| `webgl` | `@react-three/fiber`, `@react-three/drei`, `three`, `@types/three` |
-| `webgpu` | `three` (WebGPU renderer) |
-| `experiment` | (navigation/header components, no extra deps) |
-
-Each layer config specifies `dependencies`, `devDependencies`, and `scripts` that get injected into `package.json` during project hydration.
-
-#### Layer Files (`layers/`)
-
-Technology-specific files extracted from the old full templates into minimal overlay directories:
-
-- `layers/webgl/` — Custom `app/page.tsx`, WebGL canvas, and scene components
-- `layers/webgpu/` — `.gitkeep` placeholder (deps-only layer)
-- `layers/experiment/` — Header component, navigation menu, and constants
-
-#### Layer Injection Function (`src/mergers/index.js`)
-
-New `injectLayer()` function that copies layer-specific files on top of the cloned next-starter base. Handles file overlay with proper path resolution.
-
-#### Config-Driven Package Hydration
-
-`package.json` hydration now reads dependencies from `LAYER_CONFIG` instead of hardcoding them per template. The `hydratePackageJson()` function in `create.js` merges layer-specific deps, scripts, and devDeps into the base `package.json`.
-
-### Changed
-
-- **`create.js` — Clone source changed**: All template types now clone from `basementstudio/next-starter#main` instead of per-type template directories. Layer injection happens as a post-clone step.
-- **`create.js` — Template directory deleted after injection**: The CLI cleans up the local `layers/` artifacts from the generated project after overlay.
-- **`bin/index.js` — Command renamed**: Updated CLI command name.
-- **`src/commands/worktree.js`** — Minor update.
-- **`src/mergers/config.js`** — Added `LAYER_CONFIG` export with per-layer dependency maps.
-- **`src/mergers/index.js`** — Added `injectLayer()` alongside existing merger functions.
-
-### Removed
-
-- **`template/` directory** — Deleted all four full template directories (`default/`, `webgl/`, `webgpu/`, `experiment/`), removing ~27,000 lines of duplicated boilerplate. Each template previously contained a full copy of the next-starter codebase.
-
-### Files Added
-
-- `layers/webgl/app/page.tsx`
-- `layers/webgl/components/webgl/canvas/dynamic.tsx`
-- `layers/webgl/components/webgl/canvas/index.tsx`
-- `layers/webgl/components/webgl/components/scene/index.tsx`
-- `layers/webgpu/.gitkeep`
-- `layers/experiment/components/layout/header/index.tsx`
-- `layers/experiment/components/layout/navigation-menu.tsx`
-- `layers/experiment/lib/constants.ts`
-- `tasks/prd-next-starter-dynamic-layers.md`
-- `tasks/prd.json`
-- `tasks/progress.txt`
-
-### Files Modified
-
-- `bin/index.js`
-- `src/commands/create.js`
-- `src/commands/worktree.js`
-- `src/mergers/config.js`
-- `src/mergers/index.js`
-- `CLAUDE.md`
-- `README.md`
-- `package.json`
-
-### Files Deleted
-
-- `template/default/` (all files)
-- `template/webgl/` (all files)
-- `template/webgpu/` (all files)
-- `template/experiment/` (all files)

package/docs/architecture.drawio

@@ -1,250 +0,0 @@
-<mxfile host="app.diagrams.net" modified="2026-02-12T00:00:00.000Z" agent="Claude Code" version="24.0.0" type="device">
-  <diagram id="architecture" name="Project Structure">
-    <mxGraphModel dx="1422" dy="794" grid="1" gridSize="10" guides="1" tooltips="1" connect="1" arrows="1" fold="1" page="1" pageScale="1" pageWidth="1600" pageHeight="1200" math="0" shadow="0">
-      <root>
-        <mxCell id="0" />
-        <mxCell id="1" parent="0" />
-
-        <!-- ROOT -->
-        <mxCell id="root" value="" style="rounded=1;whiteSpace=wrap;html=1;fillColor=#1a1a2e;strokeColor=#e94560;arcSize=8;" vertex="1" parent="1">
-          <mxGeometry x="20" y="20" width="1560" height="1160" as="geometry" />
-        </mxCell>
-        <mxCell id="root_label" value="&lt;b&gt;basement-starter-cli&lt;/b&gt; (root)" style="text;html=1;align=left;verticalAlign=top;resizable=0;points=[];autosize=1;strokeColor=none;fillColor=none;fontColor=#e94560;fontSize=16;" vertex="1" parent="1">
-          <mxGeometry x="40" y="30" width="250" height="30" as="geometry" />
-        </mxCell>
-
-        <!-- Root files -->
-        <mxCell id="root_pkg" value="package.json&#xa;workspaces: [packages/*]" style="rounded=1;whiteSpace=wrap;html=1;fillColor=#2d2d44;strokeColor=#e94560;fontColor=#fff;fontSize=10;align=center;" vertex="1" parent="1">
-          <mxGeometry x="40" y="70" width="160" height="40" as="geometry" />
-        </mxCell>
-        <mxCell id="root_biome" value="biome.json&#xa;shared linting" style="rounded=1;whiteSpace=wrap;html=1;fillColor=#2d2d44;strokeColor=#e94560;fontColor=#fff;fontSize=10;align=center;" vertex="1" parent="1">
-          <mxGeometry x="210" y="70" width="120" height="40" as="geometry" />
-        </mxCell>
-        <mxCell id="root_changeset" value=".changeset/&#xa;versioning" style="rounded=1;whiteSpace=wrap;html=1;fillColor=#2d2d44;strokeColor=#e94560;fontColor=#fff;fontSize=10;align=center;" vertex="1" parent="1">
-          <mxGeometry x="340" y="70" width="120" height="40" as="geometry" />
-        </mxCell>
-        <mxCell id="root_ci" value=".github/workflows/&#xa;release pipeline" style="rounded=1;whiteSpace=wrap;html=1;fillColor=#2d2d44;strokeColor=#e94560;fontColor=#fff;fontSize=10;align=center;" vertex="1" parent="1">
-          <mxGeometry x="470" y="70" width="140" height="40" as="geometry" />
-        </mxCell>
-
-        <!-- CLI PACKAGE -->
-        <mxCell id="cli" value="" style="rounded=1;whiteSpace=wrap;html=1;fillColor=#16213e;strokeColor=#0f3460;arcSize=6;" vertex="1" parent="1">
-          <mxGeometry x="40" y="140" width="360" height="420" as="geometry" />
-        </mxCell>
-        <mxCell id="cli_label" value="&lt;b&gt;packages/cli&lt;/b&gt;&#xa;@basementstudio/cli" style="text;html=1;align=left;verticalAlign=top;resizable=0;points=[];autosize=1;strokeColor=none;fillColor=none;fontColor=#4da6ff;fontSize=14;" vertex="1" parent="1">
-          <mxGeometry x="55" y="150" width="200" height="40" as="geometry" />
-        </mxCell>
-
-        <mxCell id="cli_bin" value="&lt;b&gt;bin/index.js&lt;/b&gt;&#xa;CLI entry point&#xa;&#x27;basement&#x27; command&#xa;arg parsing + routing" style="rounded=1;whiteSpace=wrap;html=1;fillColor=#1e3a5f;strokeColor=#4da6ff;fontColor=#fff;fontSize=10;align=center;" vertex="1" parent="1">
-          <mxGeometry x="60" y="200" width="150" height="70" as="geometry" />
-        </mxCell>
-
-        <mxCell id="cli_create" value="&lt;b&gt;src/commands/create.js&lt;/b&gt;&#xa;Orchestrates scaffolding&#xa;Calls create-basement-app" style="rounded=1;whiteSpace=wrap;html=1;fillColor=#1e3a5f;strokeColor=#4da6ff;fontColor=#fff;fontSize=10;align=center;" vertex="1" parent="1">
-          <mxGeometry x="60" y="285" width="160" height="60" as="geometry" />
-        </mxCell>
-
-        <mxCell id="cli_add" value="&lt;b&gt;src/commands/&#xa;add-integration.js&lt;/b&gt;&#xa;Add CMS to existing project" style="rounded=1;whiteSpace=wrap;html=1;fillColor=#1e3a5f;strokeColor=#4da6ff;fontColor=#fff;fontSize=10;align=center;" vertex="1" parent="1">
-          <mxGeometry x="230" y="285" width="155" height="60" as="geometry" />
-        </mxCell>
-
-        <mxCell id="cli_worktree" value="&lt;b&gt;src/commands/&#xa;worktree.js&lt;/b&gt;&#xa;Git worktree mgmt" style="rounded=1;whiteSpace=wrap;html=1;fillColor=#1e3a5f;strokeColor=#4da6ff;fontColor=#fff;fontSize=10;align=center;" vertex="1" parent="1">
-          <mxGeometry x="60" y="360" width="130" height="55" as="geometry" />
-        </mxCell>
-
-        <mxCell id="cli_sanity" value="&lt;b&gt;src/commands/&#xa;setup-sanity.js&lt;/b&gt;&#xa;Sanity project setup" style="rounded=1;whiteSpace=wrap;html=1;fillColor=#1e3a5f;strokeColor=#4da6ff;fontColor=#fff;fontSize=10;align=center;" vertex="1" parent="1">
-          <mxGeometry x="200" y="360" width="140" height="55" as="geometry" />
-        </mxCell>
-
-        <mxCell id="cli_pkg" value="&lt;b&gt;package.json&lt;/b&gt;&#xa;deps: fs-extra, ora, picocolors,&#xa;prompts, dotenv" style="rounded=1;whiteSpace=wrap;html=1;fillColor=#1e3a5f;strokeColor=#4da6ff;fontColor=#fff;fontSize=10;align=center;" vertex="1" parent="1">
-          <mxGeometry x="60" y="430" width="200" height="50" as="geometry" />
-        </mxCell>
-
-        <mxCell id="cli_dep_label" value="depends on&#xa;create-basement-app&#xa;(workspace:*)" style="text;html=1;align=center;verticalAlign=middle;resizable=0;points=[];autosize=1;strokeColor=none;fillColor=none;fontColor=#ff6b6b;fontSize=10;fontStyle=2;" vertex="1" parent="1">
-          <mxGeometry x="60" y="490" width="130" height="50" as="geometry" />
-        </mxCell>
-
-        <!-- CREATE-BASEMENT-APP PACKAGE -->
-        <mxCell id="cba" value="" style="rounded=1;whiteSpace=wrap;html=1;fillColor=#0f3460;strokeColor=#533483;arcSize=4;" vertex="1" parent="1">
-          <mxGeometry x="420" y="140" width="1140" height="1020" as="geometry" />
-        </mxCell>
-        <mxCell id="cba_label" value="&lt;b&gt;packages/create-basement-app&lt;/b&gt;&#xa;@basementstudio/create-basement-app" style="text;html=1;align=left;verticalAlign=top;resizable=0;points=[];autosize=1;strokeColor=none;fillColor=none;fontColor=#b388ff;fontSize=14;" vertex="1" parent="1">
-          <mxGeometry x="440" y="150" width="350" height="40" as="geometry" />
-        </mxCell>
-
-        <!-- SRC -->
-        <mxCell id="cba_src" value="" style="rounded=1;whiteSpace=wrap;html=1;fillColor=#1a2744;strokeColor=#533483;arcSize=6;" vertex="1" parent="1">
-          <mxGeometry x="440" y="200" width="520" height="200" as="geometry" />
-        </mxCell>
-        <mxCell id="cba_src_label" value="&lt;b&gt;src/&lt;/b&gt; — scaffolding logic" style="text;html=1;align=left;verticalAlign=top;resizable=0;points=[];autosize=1;strokeColor=none;fillColor=none;fontColor=#b388ff;fontSize=12;" vertex="1" parent="1">
-          <mxGeometry x="450" y="205" width="180" height="25" as="geometry" />
-        </mxCell>
-
-        <mxCell id="cba_index" value="&lt;b&gt;index.js&lt;/b&gt;&#xa;Public API&#xa;barrel export" style="rounded=1;whiteSpace=wrap;html=1;fillColor=#2a3f5f;strokeColor=#b388ff;fontColor=#fff;fontSize=10;align=center;" vertex="1" parent="1">
-          <mxGeometry x="455" y="235" width="100" height="55" as="geometry" />
-        </mxCell>
-
-        <mxCell id="cba_mergers" value="&lt;b&gt;mergers/&lt;/b&gt;&#xa;index.js — injectLayer, injectIntegration&#xa;config.js — CMS_CONFIG, LAYER_CONFIG" style="rounded=1;whiteSpace=wrap;html=1;fillColor=#2a3f5f;strokeColor=#b388ff;fontColor=#fff;fontSize=10;align=center;" vertex="1" parent="1">
-          <mxGeometry x="570" y="235" width="250" height="55" as="geometry" />
-        </mxCell>
-
-        <mxCell id="cba_configs" value="&lt;b&gt;configs/&lt;/b&gt;&#xa;animations.js&#xa;GSAP + Motion deps" style="rounded=1;whiteSpace=wrap;html=1;fillColor=#2a3f5f;strokeColor=#b388ff;fontColor=#fff;fontSize=10;align=center;" vertex="1" parent="1">
-          <mxGeometry x="835" y="235" width="110" height="55" as="geometry" />
-        </mxCell>
-
-        <mxCell id="cba_pkg" value="&lt;b&gt;package.json&lt;/b&gt; — deps: fs-extra, picocolors" style="rounded=1;whiteSpace=wrap;html=1;fillColor=#2a3f5f;strokeColor=#b388ff;fontColor=#fff;fontSize=10;align=center;" vertex="1" parent="1">
-          <mxGeometry x="455" y="310" width="280" height="30" as="geometry" />
-        </mxCell>
-
-        <!-- TEMPLATES -->
-        <mxCell id="templates" value="" style="rounded=1;whiteSpace=wrap;html=1;fillColor=#3d1f6d;strokeColor=#e94560;arcSize=6;" vertex="1" parent="1">
-          <mxGeometry x="440" y="420" width="520" height="280" as="geometry" />
-        </mxCell>
-        <mxCell id="templates_label" value="&lt;b&gt;templates/&lt;/b&gt; — full standalone Next.js projects" style="text;html=1;align=left;verticalAlign=top;resizable=0;points=[];autosize=1;strokeColor=none;fillColor=none;fontColor=#ff6b9d;fontSize=12;" vertex="1" parent="1">
-          <mxGeometry x="450" y="425" width="330" height="25" as="geometry" />
-        </mxCell>
-
-        <mxCell id="t_default" value="&lt;b&gt;default/&lt;/b&gt;&#xa;84 files&#xa;Base next-starter&#xa;&#xa;next 16.1.4&#xa;react 19.2.4&#xa;tailwindcss v4&#xa;zustand&#xa;biome" style="rounded=1;whiteSpace=wrap;html=1;fillColor=#4a2080;strokeColor=#ff6b9d;fontColor=#fff;fontSize=10;align=center;" vertex="1" parent="1">
-          <mxGeometry x="455" y="460" width="110" height="130" as="geometry" />
-        </mxCell>
-
-        <mxCell id="t_webgl" value="&lt;b&gt;webgl/&lt;/b&gt;&#xa;87 files&#xa;default + R3F&#xa;&#xa;@react-three/fiber&#xa;@react-three/drei&#xa;three ^0.182.0&#xa;+ canvas/scene" style="rounded=1;whiteSpace=wrap;html=1;fillColor=#4a2080;strokeColor=#ff6b9d;fontColor=#fff;fontSize=10;align=center;" vertex="1" parent="1">
-          <mxGeometry x="580" y="460" width="115" height="130" as="geometry" />
-        </mxCell>
-
-        <mxCell id="t_webgpu" value="&lt;b&gt;webgpu/&lt;/b&gt;&#xa;84 files&#xa;default + alpha R3F&#xa;&#xa;fiber 10.0.0-alpha&#xa;drei ^11.0.0-alpha&#xa;(deps only,&#xa;no extra files)" style="rounded=1;whiteSpace=wrap;html=1;fillColor=#4a2080;strokeColor=#ff6b9d;fontColor=#fff;fontSize=10;align=center;" vertex="1" parent="1">
-          <mxGeometry x="710" y="460" width="115" height="130" as="geometry" />
-        </mxCell>
-
-        <mxCell id="t_experiment" value="&lt;b&gt;experiment/&lt;/b&gt;&#xa;86 files&#xa;default + nav&#xa;&#xa;Radix NavMenu&#xa;CVA styling&#xa;+ header/nav&#xa;+ constants.ts" style="rounded=1;whiteSpace=wrap;html=1;fillColor=#4a2080;strokeColor=#ff6b9d;fontColor=#fff;fontSize=10;align=center;" vertex="1" parent="1">
-          <mxGeometry x="840" y="460" width="110" height="130" as="geometry" />
-        </mxCell>
-
-        <mxCell id="t_note" value="Each template is independently runnable:&#xa;cd templates/webgl &amp;&amp; bun install &amp;&amp; bun dev" style="text;html=1;align=left;verticalAlign=middle;resizable=0;points=[];autosize=1;strokeColor=none;fillColor=none;fontColor=#ff6b9d;fontSize=10;fontStyle=2;" vertex="1" parent="1">
-          <mxGeometry x="455" y="605" width="280" height="35" as="geometry" />
-        </mxCell>
-
-        <!-- INTEGRATIONS -->
-        <mxCell id="integrations" value="" style="rounded=1;whiteSpace=wrap;html=1;fillColor=#5c1a1a;strokeColor=#ff4d4d;arcSize=6;" vertex="1" parent="1">
-          <mxGeometry x="980" y="200" width="560" height="310" as="geometry" />
-        </mxCell>
-        <mxCell id="int_label" value="&lt;b&gt;integrations/&lt;/b&gt; — CMS overlays (applied on top of any template)" style="text;html=1;align=left;verticalAlign=top;resizable=0;points=[];autosize=1;strokeColor=none;fillColor=none;fontColor=#ff6b6b;fontSize=12;" vertex="1" parent="1">
-          <mxGeometry x="990" y="205" width="400" height="25" as="geometry" />
-        </mxCell>
-
-        <!-- Sanity -->
-        <mxCell id="sanity" value="" style="rounded=1;whiteSpace=wrap;html=1;fillColor=#6b2020;strokeColor=#ff4d4d;arcSize=8;" vertex="1" parent="1">
-          <mxGeometry x="995" y="240" width="340" height="250" as="geometry" />
-        </mxCell>
-        <mxCell id="sanity_label" value="&lt;b&gt;sanity/&lt;/b&gt;" style="text;html=1;align=left;verticalAlign=top;resizable=0;points=[];autosize=1;strokeColor=none;fillColor=none;fontColor=#ff8a8a;fontSize=11;" vertex="1" parent="1">
-          <mxGeometry x="1005" y="245" width="70" height="22" as="geometry" />
-        </mxCell>
-
-        <mxCell id="s_config" value="&lt;b&gt;config.js&lt;/b&gt;&#xa;Single source of truth&#xa;deps: @sanity/*, next-sanity&#xa;devDeps: sanity&#xa;scripts: extract, typegen&#xa;additivePaths: 9&#xa;mergeFiles: 3" style="rounded=1;whiteSpace=wrap;html=1;fillColor=#7a2a2a;strokeColor=#ff8a8a;fontColor=#fff;fontSize=9;align=center;" vertex="1" parent="1">
-          <mxGeometry x="1010" y="270" width="150" height="100" as="geometry" />
-        </mxCell>
-
-        <mxCell id="s_files" value="&lt;b&gt;files/&lt;/b&gt;&#xa;35 Sanity files&#xa;app/ components/&#xa;lib/integrations/sanity/" style="rounded=1;whiteSpace=wrap;html=1;fillColor=#7a2a2a;strokeColor=#ff8a8a;fontColor=#fff;fontSize=9;align=center;" vertex="1" parent="1">
-          <mxGeometry x="1175" y="270" width="145" height="70" as="geometry" />
-        </mxCell>
-
-        <mxCell id="s_mergers" value="&lt;b&gt;mergers/&lt;/b&gt;&#xa;layout-merger.js&#xa;sitemap-merger.js&#xa;check-integration-merger.js" style="rounded=1;whiteSpace=wrap;html=1;fillColor=#7a2a2a;strokeColor=#ff8a8a;fontColor=#fff;fontSize=9;align=center;" vertex="1" parent="1">
-          <mxGeometry x="1175" y="355" width="145" height="70" as="geometry" />
-        </mxCell>
-
-        <!-- HOOKS -->
-        <mxCell id="hooks" value="" style="rounded=1;whiteSpace=wrap;html=1;fillColor=#1a3a4a;strokeColor=#4ecdc4;arcSize=6;" vertex="1" parent="1">
-          <mxGeometry x="980" y="530" width="560" height="170" as="geometry" />
-        </mxCell>
-        <mxCell id="hooks_label" value="&lt;b&gt;template-hooks/&lt;/b&gt; — optional hooks copied during scaffolding" style="text;html=1;align=left;verticalAlign=top;resizable=0;points=[];autosize=1;strokeColor=none;fillColor=none;fontColor=#4ecdc4;fontSize=12;" vertex="1" parent="1">
-          <mxGeometry x="990" y="535" width="380" height="25" as="geometry" />
-        </mxCell>
-
-        <mxCell id="h_config" value="&lt;b&gt;config.js&lt;/b&gt;&#xa;Hook metadata&#xa;+ npm deps per hook" style="rounded=1;whiteSpace=wrap;html=1;fillColor=#1e4a5a;strokeColor=#4ecdc4;fontColor=#fff;fontSize=10;align=center;" vertex="1" parent="1">
-          <mxGeometry x="1000" y="570" width="120" height="55" as="geometry" />
-        </mxCell>
-
-        <mxCell id="h_battery" value="use-battery.ts&#xa;deps: lodash-es" style="rounded=1;whiteSpace=wrap;html=1;fillColor=#1e4a5a;strokeColor=#4ecdc4;fontColor=#fff;fontSize=9;align=center;" vertex="1" parent="1">
-          <mxGeometry x="1135" y="570" width="100" height="40" as="geometry" />
-        </mxCell>
-
-        <mxCell id="h_perf" value="use-device-perf.ts&#xa;deps: detect-gpu,&#xa;react-device-detect, zustand" style="rounded=1;whiteSpace=wrap;html=1;fillColor=#1e4a5a;strokeColor=#4ecdc4;fontColor=#fff;fontSize=9;align=center;" vertex="1" parent="1">
-          <mxGeometry x="1250" y="570" width="130" height="55" as="geometry" />
-        </mxCell>
-
-        <mxCell id="h_observer" value="use-intersection-&#xa;observer.ts&#xa;(no deps)" style="rounded=1;whiteSpace=wrap;html=1;fillColor=#1e4a5a;strokeColor=#4ecdc4;fontColor=#fff;fontSize=9;align=center;" vertex="1" parent="1">
-          <mxGeometry x="1395" y="570" width="100" height="50" as="geometry" />
-        </mxCell>
-
-        <mxCell id="h_media" value="use-media.ts&#xa;(no deps)" style="rounded=1;whiteSpace=wrap;html=1;fillColor=#1e4a5a;strokeColor=#4ecdc4;fontColor=#fff;fontSize=9;align=center;" vertex="1" parent="1">
-          <mxGeometry x="1135" y="625" width="100" height="35" as="geometry" />
-        </mxCell>
-
-        <!-- PLUGINS -->
-        <mxCell id="plugins" value="&lt;b&gt;plugins/&lt;/b&gt;&#xa;no-anchor-element.grit&#xa;no-unnecessary-forwardref.grit&#xa;no-relative-parent-imports.grit" style="rounded=1;whiteSpace=wrap;html=1;fillColor=#2a3a2a;strokeColor=#66bb6a;fontColor=#fff;fontSize=10;align=center;" vertex="1" parent="1">
-          <mxGeometry x="980" y="720" width="220" height="70" as="geometry" />
-        </mxCell>
-
-        <!-- ARROWS: CLI -> CBA -->
-        <mxCell id="arrow1" value="" style="endArrow=block;endFill=1;html=1;strokeColor=#ff6b6b;strokeWidth=2;entryX=0;entryY=0.5;exitX=1;exitY=0.5;" edge="1" parent="1" source="cli_create" target="cba_index">
-          <mxGeometry relative="1" as="geometry" />
-        </mxCell>
-        <mxCell id="arrow1_label" value="imports" style="edgeLabel;html=1;align=center;verticalAlign=middle;resizable=0;points=[];fontColor=#ff6b6b;fontSize=10;" vertex="1" connectable="0" parent="arrow1">
-          <mxGeometry x="-0.2" relative="1" as="geometry">
-            <mxPoint as="offset" />
-          </mxGeometry>
-        </mxCell>
-
-        <!-- ARROW: CLI create -> templates -->
-        <mxCell id="arrow2" value="" style="endArrow=block;endFill=1;html=1;strokeColor=#ff6b9d;strokeWidth=2;dashed=1;exitX=1;exitY=1;entryX=0;entryY=0;" edge="1" parent="1" source="cli_create" target="templates">
-          <mxGeometry relative="1" as="geometry" />
-        </mxCell>
-        <mxCell id="arrow2_label" value="fs.copy" style="edgeLabel;html=1;align=center;verticalAlign=middle;resizable=0;points=[];fontColor=#ff6b9d;fontSize=10;" vertex="1" connectable="0" parent="arrow2">
-          <mxGeometry x="-0.2" relative="1" as="geometry">
-            <mxPoint as="offset" />
-          </mxGeometry>
-        </mxCell>
-
-        <!-- ARROW: CLI create -> integrations -->
-        <mxCell id="arrow3" value="" style="endArrow=block;endFill=1;html=1;strokeColor=#ff4d4d;strokeWidth=2;dashed=1;exitX=1;exitY=0.3;entryX=0;entryY=0.5;" edge="1" parent="1" source="cli" target="integrations">
-          <mxGeometry relative="1" as="geometry" />
-        </mxCell>
-        <mxCell id="arrow3_label" value="merge + copy" style="edgeLabel;html=1;align=center;verticalAlign=middle;resizable=0;points=[];fontColor=#ff4d4d;fontSize=10;" vertex="1" connectable="0" parent="arrow3">
-          <mxGeometry x="-0.3" relative="1" as="geometry">
-            <mxPoint as="offset" />
-          </mxGeometry>
-        </mxCell>
-
-        <!-- ARROW: mergers -> sanity mergers -->
-        <mxCell id="arrow4" value="" style="endArrow=block;endFill=1;html=1;strokeColor=#ff8a8a;strokeWidth=1;dashed=1;" edge="1" parent="1" source="cba_mergers" target="s_mergers">
-          <mxGeometry relative="1" as="geometry" />
-        </mxCell>
-        <mxCell id="arrow4_label" value="imports" style="edgeLabel;html=1;align=center;verticalAlign=middle;resizable=0;points=[];fontColor=#ff8a8a;fontSize=9;" vertex="1" connectable="0" parent="arrow4">
-          <mxGeometry x="-0.2" relative="1" as="geometry">
-            <mxPoint as="offset" />
-          </mxGeometry>
-        </mxCell>
-
-        <!-- DATA FLOW LEGEND -->
-        <mxCell id="legend" value="" style="rounded=1;whiteSpace=wrap;html=1;fillColor=#1a1a2e;strokeColor=#555;arcSize=8;" vertex="1" parent="1">
-          <mxGeometry x="440" y="730" width="500" height="110" as="geometry" />
-        </mxCell>
-        <mxCell id="legend_title" value="&lt;b&gt;Data Flow&lt;/b&gt;" style="text;html=1;align=left;verticalAlign=top;resizable=0;points=[];autosize=1;strokeColor=none;fillColor=none;fontColor=#fff;fontSize=11;" vertex="1" parent="1">
-          <mxGeometry x="455" y="735" width="80" height="22" as="geometry" />
-        </mxCell>
-        <mxCell id="legend1" value="1. User runs &lt;b&gt;basement&lt;/b&gt; → CLI parses args, prompts for choices" style="text;html=1;align=left;verticalAlign=middle;resizable=0;points=[];autosize=1;strokeColor=none;fillColor=none;fontColor=#4da6ff;fontSize=10;" vertex="1" parent="1">
-          <mxGeometry x="455" y="758" width="340" height="22" as="geometry" />
-        </mxCell>
-        <mxCell id="legend2" value="2. CLI copies selected &lt;b&gt;template&lt;/b&gt; to target dir (instant, no network)" style="text;html=1;align=left;verticalAlign=middle;resizable=0;points=[];autosize=1;strokeColor=none;fillColor=none;fontColor=#ff6b9d;fontSize=10;" vertex="1" parent="1">
-          <mxGeometry x="455" y="778" width="380" height="22" as="geometry" />
-        </mxCell>
-        <mxCell id="legend3" value="3. CLI applies CMS &lt;b&gt;integration&lt;/b&gt; via merge + copy (if selected)" style="text;html=1;align=left;verticalAlign=middle;resizable=0;points=[];autosize=1;strokeColor=none;fillColor=none;fontColor=#ff4d4d;fontSize=10;" vertex="1" parent="1">
-          <mxGeometry x="455" y="798" width="350" height="22" as="geometry" />
-        </mxCell>
-        <mxCell id="legend4" value="4. CLI hydrates package.json from &lt;b&gt;config manifests&lt;/b&gt; (zero hardcoded deps)" style="text;html=1;align=left;verticalAlign=middle;resizable=0;points=[];autosize=1;strokeColor=none;fillColor=none;fontColor=#b388ff;fontSize=10;" vertex="1" parent="1">
-          <mxGeometry x="455" y="818" width="420" height="22" as="geometry" />
-        </mxCell>
-
-      </root>
-    </mxGraphModel>
-  </diagram>
-</mxfile>

package/docs/architecture.mermaid

@@ -1,85 +0,0 @@
-graph TD
-    subgraph ROOT["basement-starter-cli (root)"]
-        PKG_ROOT["package.json<br/><i>workspaces: packages/*</i>"]
-        BIOME["biome.json<br/><i>shared linting</i>"]
-        CHANGESET[".changeset/<br/><i>versioning</i>"]
-        CI[".github/workflows/<br/><i>release pipeline</i>"]
-    end
-
-    subgraph CLI["packages/cli — @basementstudio/cli"]
-        CLI_BIN["bin/index.js<br/><i>CLI entry point</i><br/><i>basement command</i>"]
-        CLI_CREATE["src/commands/create.js<br/><i>orchestrates scaffolding</i>"]
-        CLI_ADD["src/commands/add-integration.js<br/><i>add CMS to existing project</i>"]
-        CLI_WORKTREE["src/commands/worktree.js<br/><i>git worktree management</i>"]
-        CLI_SANITY["src/commands/setup-sanity.js<br/><i>automated Sanity setup</i>"]
-        CLI_PKG["package.json<br/><i>depends on create-basement-app</i>"]
-    end
-
-    subgraph CBA["packages/create-basement-app — @basementstudio/create-basement-app"]
-        CBA_INDEX["src/index.js<br/><i>public API barrel export</i>"]
-
-        subgraph MERGERS["src/mergers/"]
-            MERGER_INDEX["index.js<br/><i>injectLayer, injectIntegration</i>"]
-            MERGER_CONFIG["config.js<br/><i>CMS_CONFIG, LAYER_CONFIG</i>"]
-        end
-
-        subgraph CONFIGS["src/configs/"]
-            ANIM_CONFIG["animations.js<br/><i>GSAP, Motion deps</i>"]
-        end
-
-        subgraph TEMPLATES["templates/ — standalone Next.js projects"]
-            T_DEFAULT["default/<br/><i>84 files, base starter</i>"]
-            T_WEBGL["webgl/<br/><i>87 files, R3F + canvas</i>"]
-            T_WEBGPU["webgpu/<br/><i>84 files, alpha R3F deps</i>"]
-            T_EXPERIMENT["experiment/<br/><i>86 files, nav components</i>"]
-        end
-
-        subgraph INTEGRATIONS["integrations/ — CMS overlays"]
-            subgraph SANITY["sanity/"]
-                S_CONFIG["config.js<br/><i>deps, scripts, paths</i>"]
-                S_FILES["files/<br/><i>35 Sanity files</i>"]
-                S_MERGERS["mergers/<br/><i>layout, sitemap, check</i>"]
-            end
-        end
-
-        subgraph HOOKS["template-hooks/"]
-            H_CONFIG["config.js<br/><i>hook metadata + deps</i>"]
-            H_BATTERY["use-battery.ts"]
-            H_PERF["use-device-perf.ts"]
-            H_OBSERVER["use-intersection-observer.ts"]
-            H_MEDIA["use-media.ts"]
-        end
-
-        PLUGINS["plugins/<br/><i>3 Biome Grit rules</i>"]
-    end
-
-    %% Dependencies
-    CLI_BIN --> CLI_CREATE
-    CLI_BIN --> CLI_ADD
-    CLI_BIN --> CLI_WORKTREE
-    CLI_CREATE --> CBA_INDEX
-    CLI_CREATE --> S_CONFIG
-    CLI_CREATE --> H_CONFIG
-    CLI_ADD --> CBA_INDEX
-    CLI_ADD --> S_CONFIG
-    CBA_INDEX --> MERGER_INDEX
-    CBA_INDEX --> ANIM_CONFIG
-    MERGER_INDEX --> MERGER_CONFIG
-    MERGER_INDEX --> S_MERGERS
-    CLI_CREATE --> TEMPLATES
-    CLI_CREATE --> CLI_SANITY
-
-    %% Styling
-    classDef root fill:#1a1a2e,stroke:#e94560,color:#fff
-    classDef cli fill:#16213e,stroke:#0f3460,color:#fff
-    classDef cba fill:#0f3460,stroke:#533483,color:#fff
-    classDef template fill:#533483,stroke:#e94560,color:#fff
-    classDef integration fill:#e94560,stroke:#fff,color:#fff
-    classDef hook fill:#0f3460,stroke:#e94560,color:#fff
-
-    class ROOT root
-    class CLI cli
-    class CBA cba
-    class TEMPLATES,T_DEFAULT,T_WEBGL,T_WEBGPU,T_EXPERIMENT template
-    class INTEGRATIONS,SANITY integration
-    class HOOKS hook