bsmnt 0.0.2 → 0.1.0

package/tasks/progress.txt

@@ -5,111 +5,305 @@
 - src/mergers/index.js holds injection/merge logic (injectIntegration for CMS, injectLayer for layers)
 - src/commands/create.js is the main CLI flow
 - next-starter uses package.json directly (no template rename needed)
-- Layer files are local (in layers/ directory), CMS integration files are remote (fetched via tiged)
-- ESM requires __dirname workaround: `path.dirname(fileURLToPath(import.meta.url))`
+- Layer files are in templates/{type}/ directory, CMS integration files are LOCAL in integrations/{cms}/files/ (no more tiged remote clone)
+- ESM requires __dirname workaround: `const __dirname = path.dirname(fileURLToPath(import.meta.url))`
 - CLI binary is basement (defined in package.json bin field)
-- Dependency injection order in create.js: layer deps → CMS deps → animation deps
+- Dependency injection order in create.js: layer deps -> CMS deps -> animation deps
+- bin/index.js now uses picocolors (chalk replaced in US-002), all files use picocolors
+- CMS deps now come from integration config manifests (sanityConfig, basehubConfig) imported in create.js and add-integration.js
+- Layer deps still in LAYER_CONFIG in config.js — animation deps now in src/configs/animations.js (centralized in US-011)
+- Animation config pattern: ANIMATION_CONFIG object + getAnimationConfig(name) helper in src/configs/animations.js
+- Dependency injection order in create.js: layer deps -> CMS deps -> animation deps -> hook deps
+- Hook deps are now injected into target package.json during hydration (from hooksConfig)
+- Template prompt is dynamic: reads directory listing from create-basement-app/templates/
+- Hook prompt choices are config-driven: from hooksConfig (not fs.readdir)
+- inquirer and chalk removed from root package.json (unused — prompts and picocolors used instead)
+- Integration config pattern: `integrations/{cms}/config.js` exports `{name}Config` with deps, devDeps, scripts, additivePaths, mergeFiles
+- Sanity has 35 source files, 3 mergers, and a config manifest in packages/create-basement-app/integrations/sanity/
+- Sanity deps: @sanity/asset-utils, @sanity/image-url, @sanity/visual-editing, @sanity/vision, next-sanity (deps) + sanity (devDep)
+- next-config-merger.js was orphaned (deleted in US-003)
+
+- Hook deps: use-battery -> lodash-es; use-device-perf -> detect-gpu, react-device-detect, zustand; use-intersection-observer -> none; use-media -> none
+- BaseHub integration is minimal: basehub ^3.0.0 dep only, one additivePath, no mergeFiles, no scripts
+- Root biome.json `includes` now covers packages/** (updated in US-002)
+- `bun run lint` fails with "nested root configuration" error — templates/ contain their own biome.json with root:true, which conflicts with the root biome.json. This is pre-existing and expected (templates are standalone projects).
+- Empty directories in packages/ won't be tracked by git unless they have files - each has package.json
+- CLI commands now import mergers from ../../../create-basement-app/src/mergers/ (updated in US-003)
+- Merger code lives in packages/create-basement-app/src/mergers/ with barrel export at src/index.js
+- Old root dirs (layers, integrations, template-hooks, plugins, src, bin) deleted in US-013 — all code lives in packages/
+- injectIntegration resolves integration files via: path.resolve(__dirname, "../../integrations", cms, "files")
+- injectLayer resolves layer files via: path.resolve(__dirname, "../../templates", layer)
+- CMS_MERGERS imports from ../../integrations/sanity/mergers/ (not co-located ./layout-merger.js)
+- tiged fully removed from all packages (no longer needed anywhere)
+- CMS_CONFIG no longer has `branch` field (files are local, no remote clone needed)
+- Templates are standalone: fs.copy from create-basement-app/templates/{type}/ directly to target dir (no tiged, no layer overlay)
+- _gitignore must be renamed to .gitignore after copying template to target dir
+- Root package.json is now "basement-starter-cli" with private:true, no bin, no runtime deps — only workspaces + devDeps (biome, changesets)
+- dotenv removed from CLI (was only for dev .env loading from source tree)
+- packages/cli has workspace:* dep on @basementstudio/create-basement-app
+- packages/create-basement-app has "main": "src/index.js"
 
 ---
 
-## 2026-02-09 - US-001
-- Implemented LAYER_CONFIG export with webgl, webgpu, experiment entries
-- Added getLayerConfig() helper function
-- Each layer config has: replaceFiles, additivePaths, dependencies, devDependencies
-- webgpu is deps-only (empty replaceFiles and additivePaths)
-- Files changed: src/mergers/config.js
+## 2026-02-11 - US-001
+- What was implemented: Monorepo skeleton with bun workspaces
+- Files changed:
+  - package.json (added "workspaces": ["packages/*"])
+  - packages/cli/package.json (new)
+  - packages/create-basement-app/package.json (new)
+  - packages/create-basement-app/templates/ (new dir)
+  - packages/create-basement-app/integrations/ (new dir)
+  - packages/create-basement-app/template-hooks/ (new dir)
+  - packages/create-basement-app/plugins/ (new dir)
 - **Learnings for future iterations:**
-  - The CLI project is plain JS ESM, verified by running `node --input-type=module -e "import {...}"`
-  - Config pattern follows existing CMS_CONFIG style - object + getter helper
-  - experiment uses three ^0.172.0 (not ^0.182.0 like webgl/webgpu) per PRD
+  - biome.json includes list doesn't cover packages/ - will need updating when code moves there
+  - bun workspaces use "workspaces" field in root package.json (same as npm/yarn)
+  - Empty subdirectories (templates, integrations, etc.) are created but won't be git-tracked until they contain files
 ---
 
-## 2026-02-09 - US-002
-- Created layers/webgl/ with app/page.tsx and 3 webgl component files from template/webgl/
-- Created layers/experiment/ with header, navigation-menu, constats.ts, cn.ts from template/experiment/
-- Created layers/webgpu/.gitkeep (empty layer, deps-only)
-- Verified all files are byte-for-byte identical using diff
-- Files changed: 9 new files in layers/
+## 2026-02-11 - US-002
+- What was implemented: Moved CLI code (bin/index.js, src/commands/*) to packages/cli/
+- Files changed:
+  - packages/cli/bin/index.js (new - copied from bin/index.js, chalk replaced with picocolors)
+  - packages/cli/src/commands/create.js (new - copied from src/commands/create.js, merger paths updated)
+  - packages/cli/src/commands/add-integration.js (new - copied, merger paths updated)
+  - packages/cli/src/commands/worktree.js (new - copied as-is, no external imports to update)
+  - packages/cli/src/commands/setup-sanity.js (new - copied as-is)
+  - packages/cli/package.json (updated with runtime dependencies)
+  - biome.json (added packages/** to includes)
+  - package.json (fixed formatting for biome compliance)
 - **Learnings for future iterations:**
-  - Layer files are local to CLI repo (no network clone needed, unlike CMS integrations)
-  - webgl is the only layer with a different app/page.tsx (imports DynamicCanvas)
-  - experiment has its own header and navigation-menu components
----
-
-## 2026-02-09 - US-003
-- Added injectLayer(targetDir, layer, spinner) function to src/mergers/index.js
-- Uses __dirname (via import.meta.url + fileURLToPath) to resolve layers/ directory
-- Reuses detectPathPrefix() and transformPath() for src/ directory support
-- Handles replaceFiles (overwrite: true) and additivePaths (overwrite: false) separately
-- Returns results with replaced, copied, skipped, failed arrays
-- Extended formatMergeResults() with defensive optional chaining for replaced/merged/copied/etc
-- Files changed: src/mergers/index.js
+  - chalk.bold.hex("#FF4D00") has no picocolors equivalent - use ANSI escape codes: `\x1b[1m\x1b[38;2;255;77;0m${text}\x1b[0m`
+  - Static imports in ESM fail at module load time even for --help - merger imports in create.js are mostly dynamic (await import) except getLayerConfig which is static
+  - For intermediate stories, import paths to not-yet-moved modules use `../../../../src/mergers/` - these will be cleaned up in US-003
+  - `node --check file.js` validates syntax without executing (useful for ESM files that would fail on missing deps)
+  - dotenv path in create.js uses __dirname-relative resolution - needs updating when file moves
+---
+
+## 2026-02-11 - US-003
+- What was implemented: Moved all merger code to packages/create-basement-app/src/mergers/
+- Files changed:
+  - packages/create-basement-app/src/mergers/index.js (new - copied from src/mergers/index.js)
+  - packages/create-basement-app/src/mergers/config.js (new - copied from src/mergers/config.js)
+  - packages/create-basement-app/src/mergers/layout-merger.js (new - copied from src/mergers/layout-merger.js)
+  - packages/create-basement-app/src/mergers/sitemap-merger.js (new - copied from src/mergers/sitemap-merger.js)
+  - packages/create-basement-app/src/mergers/check-integration-merger.js (new - copied from src/mergers/check-integration-merger.js)
+  - packages/create-basement-app/src/index.js (new - barrel re-export of public API)
+  - packages/create-basement-app/package.json (added fs-extra, picocolors, tiged deps)
+  - packages/cli/src/commands/create.js (3 import paths updated to create-basement-app)
+  - packages/cli/src/commands/add-integration.js (1 import path updated to create-basement-app)
+  - src/mergers/next-config-merger.js (DELETED - orphaned, never in CMS_MERGERS)
 - **Learnings for future iterations:**
-  - ESM doesn't have __dirname, must use: `const __dirname = path.dirname(fileURLToPath(import.meta.url))`
-  - Layer injection is purely local file copy (no network), unlike CMS integration which uses tiged
-  - formatMergeResults now handles both CMS results (merged) and layer results (replaced) gracefully
----
-
-## 2026-02-09 - US-004
-- Changed tiged source from basement/template/${type} to basementstudio/next-starter#main
-- Removed BASEMENT_CLI_BRANCH env var usage (was only used for template, not used elsewhere)
-- Added bun.lock deletion after clone (since deps will be modified by layers/CMS/animation)
-- Updated spinner text to "Downloading next-starter from GitHub..."
-- Updated troubleshooting message to reference basementstudio/next-starter
-- Kept dotenv import as it may be used by merger modules
-- Files changed: src/commands/create.js
+  - From packages/cli/src/commands/ to packages/create-basement-app/src/mergers/ the relative path is ../../../create-basement-app/src/mergers/
+  - Old src/mergers/ files are preserved (not deleted) until US-013 cleanup to avoid breaking anything
+  - index.js barrel export pattern: re-export named exports from submodules for clean public API
+  - Merger code deps (fs-extra, tiged) need to be declared in create-basement-app's package.json since that's where the code now lives
+- next-starter is a PRIVATE repo — tiged can't clone it. Use `gh repo clone` instead for authenticated access.
+- Default template is the base for all other templates (webgl, webgpu, experiment will copy from it)
+- Template cleanup: remove .tldr cache, .tldrignore; rename .gitignore to _gitignore; delete bun.lock
+---
+
+## 2026-02-11 - US-004
+- What was implemented: Generated default template by cloning basementstudio/next-starter#main
+- Files changed:
+  - packages/create-basement-app/templates/default/ (84 files — complete Next.js project)
+  - Renamed .gitignore to _gitignore (npm strips dotfiles)
+  - Deleted bun.lock (should not be committed in templates)
+  - Removed .tldr/ cache and .tldrignore (repo-specific caches)
 - **Learnings for future iterations:**
-  - dotenv is loaded in create.js but env vars are only used in merger modules (check-integration-merger.js)
-  - bun.lock must be deleted before modifying package.json deps, otherwise bun install may conflict
+  - basementstudio/next-starter is a private repo — `npx tiged` fails. Use `gh repo clone` with `--depth 1` for auth.
+  - After cloning, remove .git/ before copying to template directory
+  - next-starter includes .biome/plugins (Grit lint rules), .cursor/rules, .vscode, .github, .editorconfig — all part of the project template
+  - Template package.json has: next 16.1.4, react 19.2.4, react-dom 19.2.4, plus tailwindcss, biome, zustand, etc.
+  - Template includes lib/scripts/ for code generation (generate-component.ts, generate-page.ts)
 ---
 
-## 2026-02-09 - US-005
-- Added layer injection step (3.2) between template download and CMS integration (3.5)
-- Layer injection only runs when type !== 'default'
-- Uses dynamic import for injectLayer and formatMergeResults from mergers/index.js
-- Shows ora spinner with layer name during injection
-- On failure, shows warning and continues (not a hard error)
-- Files changed: src/commands/create.js
+## 2026-02-11 - US-005
+- What was implemented: Generated WebGL template from default template + layer overlay files
+- Files changed:
+  - packages/create-basement-app/templates/webgl/ (87 files — complete Next.js project with WebGL)
+  - app/page.tsx overwritten with WebGL version (imports DynamicCanvas)
+  - components/webgl/canvas/dynamic.tsx (new — client-side dynamic loader for R3F canvas)
+  - components/webgl/canvas/index.tsx (new — R3F Canvas with production GL settings)
+  - components/webgl/components/scene/index.tsx (new — demo rotating orange cube)
+  - package.json updated with WebGL deps: @react-three/fiber ^9.5.0, @react-three/drei ^10.7.7, three ^0.182.0, @radix-ui/react-navigation-menu ^1.2.5, leva ^0.9.35, @types/three ^0.182.0
 - **Learnings for future iterations:**
-  - Layer injection MUST happen before CMS integration to keep layout.tsx intact for CMS mergers
-  - Uses dynamic import (await import) consistent with existing CMS integration pattern
+  - Template generation pattern: cp -r default/ {name}/, overlay files, edit package.json deps
+  - WebGL layer has 1 replaceFile (app/page.tsx) and 3 additivePaths (canvas + scene components)
+  - Dependencies are alphabetically sorted in package.json to keep diffs clean
+  - _gitignore already present from default template copy (no need to rename again)
+  - No bun.lock in templates (already cleaned in default template)
 ---
 
-## 2026-02-09 - US-006
-- Imported getLayerConfig from src/mergers/config.js at top of create.js
-- Layer deps injected from LAYER_CONFIG before CMS and animation deps
-- Simplified package.json handling: removed package.template.json logic (next-starter uses package.json directly)
-- CMS and animation dependency injection unchanged
-- Project name and version still set correctly
-- Files changed: src/commands/create.js
+## 2026-02-11 - US-006
+- What was implemented: Generated WebGPU template from default template + alpha R3F dependencies
+- Files changed:
+  - packages/create-basement-app/templates/webgpu/ (84 files — complete Next.js project, deps-only)
+  - package.json updated with WebGPU deps: @react-three/fiber 10.0.0-alpha.2, @react-three/drei ^11.0.0-alpha.4, three ^0.182.0, leva ^0.9.35, lucide-react ^0.474.0, @radix-ui/react-navigation-menu ^1.2.5, @types/three ^0.182.0
 - **Learnings for future iterations:**
-  - Dependency injection order matters: layer deps first, then CMS, then animation (later ones override earlier)
-  - next-starter uses package.json directly, no need for package.template.json rename logic
+  - WebGPU is deps-only — no overlay files, simplest template generation (just copy + edit package.json)
+  - WebGPU uses ALPHA versions of R3F (10.0.0-alpha.2 for fiber, ^11.0.0-alpha.4 for drei) — different from webgl which uses stable versions
+  - File count matches default template exactly (84 files) since no components were added
 ---
 
-## 2026-02-09 - US-007
-- Deleted template/default/, template/webgl/, template/webgpu/, template/experiment/ directories
-- Removed entire template/ directory (281 files, -27,778 lines)
-- Verified no remaining references to template/ paths in source code (src/)
-- Updated CLAUDE.md to reflect new architecture (layers/ instead of template/)
-- Files changed: template/ deleted, CLAUDE.md updated
+## 2026-02-11 - US-007
+- What was implemented: Generated experiment template from default template + experiment layer overlay files
+- Files changed:
+  - packages/create-basement-app/templates/experiment/ (86 files — complete Next.js project with experiment nav)
+  - components/layout/header/index.tsx overwritten with experiment version (Radix NavigationMenu-based header with experiment links)
+  - components/layout/navigation-menu.tsx (new — full Radix NavigationMenu component library with CVA styling)
+  - lib/constants.ts (new — EXPERIMENTS array with route definitions)
+  - package.json updated with experiment deps: @radix-ui/react-navigation-menu ^1.2.5, @react-three/fiber ^9.5.0, @react-three/drei ^10.7.7, three ^0.182.0, leva ^0.9.35, lucide-react ^0.474.0, @types/three ^0.182.0
 - **Learnings for future iterations:**
-  - CLAUDE.md should be kept in sync with architecture changes
-  - Only documentation files (CLAUDE.md, PRD) had remaining references to template/ paths, not source code
----
-
-## 2026-02-09 - US-008
-- Installed CLI locally via npm link
-- E2E test results (all passed):
-  - test-default: Created successfully, name=test-default, version=0.1.0, has next dep, no R3F deps
-  - test-webgl: Created with layer applied (replaced page.tsx, added 3 webgl components), R3F ^9.5.0, three ^0.182.0, @types/three ^0.182.0
-  - test-webgpu: Created with deps-only layer, R3F 10.0.0-alpha.2, drei ^11.0.0-alpha.4, lucide-react ^0.474.0
-  - test-experiment: Created with layer (header, navigation-menu, constats.ts, cn.ts), three ^0.172.0
-  - test-sanity: Combined webgl + sanity + gsap - all deps present (R3F, next-sanity, sanity, gsap, @gsap/react, sanity:extract script)
-- All 4 projects pass bun install without errors
-- CLI command is basement (not basement-starter as PRD mentions)
+  - Experiment layer has 1 replaceFile (header/index.tsx) and 2 additivePaths (navigation-menu.tsx, constants.ts) — different from webgl which has 1 replace + 3 additive
+  - class-variance-authority already exists in default template at ^0.7.1, LAYER_CONFIG declares ^0.7.0 — no need to downgrade, existing version satisfies the constraint
+  - PRD notes said three ^0.172.0 but actual LAYER_CONFIG uses ^0.182.0 — always check the source code config, not PRD notes
+  - Dependencies should be alphabetically sorted in package.json devDependencies too (caught and fixed @types/three ordering)
+  - 86 files = 84 default + 2 additive files (navigation-menu.tsx + constants.ts). replaceFile doesn't change count.
+---
+
+## 2026-02-11 - US-008
+- What was implemented: Moved Sanity integration files locally into create-basement-app with a unified config manifest
+- Files changed:
+  - packages/create-basement-app/integrations/sanity/config.js (new — single source of truth: deps, devDeps, scripts, additivePaths, mergeFiles)
+  - packages/create-basement-app/integrations/sanity/files/ (35 files — complete Sanity integration: app/, components/, lib/)
+  - packages/create-basement-app/integrations/sanity/mergers/layout-merger.js (copied from src/mergers/)
+  - packages/create-basement-app/integrations/sanity/mergers/sitemap-merger.js (copied from src/mergers/)
+  - packages/create-basement-app/integrations/sanity/mergers/check-integration-merger.js (copied from src/mergers/)
 - **Learnings for future iterations:**
-  - Skills installation may fail without network (bunx skills add), but it's non-blocking
-  - The sanity integration triggers an interactive Sanity setup prompt after project creation
-  - bun install correctly resolves all dependency versions including alpha packages
+  - Integration config pattern: export const {name}Config with name, dependencies, devDependencies, scripts, additivePaths, mergeFiles
+  - Sanity has 5 deps, 1 devDep, 2 scripts, 9 additivePaths, 3 mergeFiles
+  - additivePaths and mergeFiles were sourced from CMS_CONFIG.sanity in config.js; deps/scripts from hardcoded values in create.js lines 239-260
+  - PRD acceptance criteria listed @sanity/vision as a dep, but in create.js it's actually listed alongside other @sanity/* deps (version ^5.7.0)
+  - Mergers are COPIES (not moves) — originals in src/mergers/ stay until US-013 cleanup. US-010 will rewire imports.
 ---
+
+## 2026-02-11 - US-009
+- What was implemented: Moved BaseHub integration, template-hooks, and plugins into packages/create-basement-app
+- Files changed:
+  - packages/create-basement-app/integrations/basehub/config.js (new — basehubConfig with deps, additivePaths, mergeFiles)
+  - packages/create-basement-app/integrations/basehub/files/README.md (copied from integrations/basehub/)
+  - packages/create-basement-app/template-hooks/config.js (new — hooksConfig array with 4 hook entries + deps)
+  - packages/create-basement-app/template-hooks/use-battery.ts (copied from template-hooks/)
+  - packages/create-basement-app/template-hooks/use-device-perf.ts (copied from template-hooks/)
+  - packages/create-basement-app/template-hooks/use-intersection-observer.ts (copied from template-hooks/)
+  - packages/create-basement-app/template-hooks/use-media.ts (copied from template-hooks/)
+  - packages/create-basement-app/plugins/no-anchor-element.grit (copied from plugins/)
+  - packages/create-basement-app/plugins/no-unnecessary-forwardref.grit (copied from plugins/)
+  - packages/create-basement-app/plugins/no-relative-parent-imports.grit (copied from plugins/)
+  - packages/create-basement-app/plugins/README.md (copied from plugins/)
+- **Learnings for future iterations:**
+  - BaseHub integration is minimal — only adds basehub: ^3.0.0 as a dependency, no scripts, no mergeFiles, one additivePath
+  - Hook dependency discovery: use-battery imports lodash-es/isEqual; use-device-perf imports detect-gpu, react-device-detect, zustand; use-intersection-observer and use-media have zero npm deps
+  - use-device-perf also has an internal dependency on use-battery (imports ./use-battery) — this is a file-level dep, not an npm dep
+  - Hooks are currently just copied as files — create.js does NOT inject hook npm deps into the target project's package.json (that will need US-011 to wire up)
+  - The config.js pattern for hooks mirrors the integration config pattern: name, file, dependencies, devDependencies
+---
+
+## 2026-02-11 - US-010
+- What was implemented: Updated merger paths to use local create-basement-app locations instead of remote GitHub clones
+- Files changed:
+  - packages/create-basement-app/src/mergers/index.js (replaced tiged remote clone with local fs.copy from integrations/{cms}/files/; updated injectLayer path from ../../layers to ../../templates; removed os and tiged imports)
+  - packages/create-basement-app/src/mergers/config.js (removed `branch` field from CMS_CONFIG for both sanity and basehub)
+  - packages/cli/src/commands/create.js (added imports for sanityConfig/basehubConfig; replaced hardcoded CMS deps/devDeps/scripts with config manifest reads)
+  - packages/cli/src/commands/add-integration.js (added imports for sanityConfig/basehubConfig; replaced hardcoded addDependencies function with config-driven approach)
+  - packages/create-basement-app/package.json (removed tiged dependency)
+  - CMS_MERGERS updated to import from ../../integrations/sanity/mergers/ instead of co-located ./layout-merger.js
+- **Learnings for future iterations:**
+  - injectIntegration path resolution: path.resolve(__dirname, "../../integrations", cms, "files") from src/mergers/index.js
+  - injectLayer path resolution: path.resolve(__dirname, "../../templates", layer) from src/mergers/index.js
+  - CMS deps are now config-driven: import { sanityConfig } from "../../../create-basement-app/integrations/sanity/config.js"
+  - The addDependencies function in add-integration.js was duplicating deps from create.js — both now use config manifests
+  - tiged is still needed in packages/cli/ (for template download from GitHub in create.js) but NOT in create-basement-app
+  - With this change, adding a new integration only requires: 1) files in integrations/{name}/files/, 2) config.js with deps, 3) optional mergers
+---
+
+## 2026-02-12 - US-011
+- What was implemented: Centralized all dependency configs — zero hardcoded version strings remain in create.js
+- Files changed:
+  - packages/create-basement-app/src/configs/animations.js (new — ANIMATION_CONFIG with gsap and motion deps + getAnimationConfig helper)
+  - packages/create-basement-app/src/index.js (added export for getAnimationConfig and ANIMATION_CONFIG)
+  - packages/cli/src/commands/create.js (replaced hardcoded animation deps with config; added hooksConfig import; dynamic template discovery; hook dep injection into package.json; updated hooks source path to create-basement-app)
+  - package.json (removed unused inquirer and chalk from root dependencies)
+- **Learnings for future iterations:**
+  - Animation config follows same pattern as CMS config: ANIMATION_CONFIG object + getAnimationConfig(name) helper
+  - Hook dependency injection is a NEW behavior: previously hooks were copied as files but their npm deps were NOT injected. Now hooksConfig is used to inject deps during hydration step.
+  - Template prompt choices are dynamically generated from fs.readdir of templates/ dir, with a templateLabels lookup for friendly names
+  - dotenv is kept in root deps (not just devDeps) because create.js loads .env at runtime for CLI dev — could be moved in US-013 cleanup
+  - Biome auto-fix reorders imports alphabetically and formats long conditionals across multiple lines — run `biome check --write` after edits
+  - Hook source path: from packages/cli/src/commands/ to create-basement-app/template-hooks/ is ../../../create-basement-app/template-hooks
+---
+
+## 2026-02-12 - US-012
+- What was implemented: Replaced tiged remote clone with local fs.copy from standalone templates
+- Files changed:
+  - packages/cli/src/commands/create.js (replaced tiged clone with fs.copy; removed layer injection step 3.2; removed layer dep injection from hydration; added _gitignore rename; updated error messages)
+  - packages/cli/package.json (removed tiged dependency)
+- **Learnings for future iterations:**
+  - Templates are now fully standalone — no more two-step "download base + overlay layer" process
+  - _gitignore -> .gitignore rename is needed because npm strips dotfiles from published packages
+  - Layer deps no longer need injection during hydration — they're already in each template's package.json
+  - tiged is no longer needed anywhere in packages/ (still referenced in old root src/ which will be cleaned in US-013)
+  - The template copy is instant (no network call), making CLI significantly faster
+  - Template path resolution from create.js: path.resolve(__dirname, "../../../create-basement-app/templates", type)
+---
+
+## 2026-02-12 - US-013
+- What was implemented: Deleted all old root directories and cleaned up dead code/dependencies
+- Files changed:
+  - DELETED: bin/ (262 lines — old CLI entry point, now in packages/cli/bin/)
+  - DELETED: src/ (4 commands + 5 mergers — all moved to packages/)
+  - DELETED: layers/ (3 layer directories — content in packages/create-basement-app/templates/)
+  - DELETED: integrations/ (sanity + basehub — content in packages/create-basement-app/integrations/)
+  - DELETED: template-hooks/ (4 hooks — content in packages/create-basement-app/template-hooks/)
+  - DELETED: plugins/ (3 grit rules + README — content in packages/create-basement-app/plugins/)
+  - package.json (cleaned: renamed to basement-starter-cli, added private:true, removed bin field, removed test script, removed all runtime deps)
+  - packages/cli/package.json (removed dotenv dep, added workspace:* dep on create-basement-app)
+  - packages/cli/src/commands/create.js (removed dotenv import and config call)
+  - packages/create-basement-app/package.json (removed unused picocolors dep, added "main": "src/index.js")
+  - bun.lock (regenerated — 4 packages installed, 8 removed)
+- **Learnings for future iterations:**
+  - 67 files changed, 8605 lines deleted — the bulk of this story is deletions
+  - Root package.json should be private:true and have no bin/deps (those belong in workspace packages)
+  - dotenv was loading .env from CLI source tree for dev convenience — not needed in production, removed
+  - picocolors was declared in create-basement-app but never imported — always verify deps are actually used
+  - workspace:* protocol links packages without publishing — bun resolves it to the local package
+  - After cleanup, the project root only has: package.json, biome.json, bun.lock, .changeset/, .github/, packages/
+---
+
+## 2026-02-12 - US-014
+- What was implemented: Updated changeset config, CI workflow, CLAUDE.md, and README.md for workspace-aware publishing
+- Files changed:
+  - .github/workflows/release.yml (added NPM_TOKEN and NODE_AUTH_TOKEN env vars for npm publishing)
+  - CLAUDE.md (rewrote Architecture section for monorepo, updated CLI flow, integration sources, plugin paths, dev commands)
+  - README.md (added Project Structure section with monorepo layout and package table)
+- **Learnings for future iterations:**
+  - Changeset config was already workspace-ready — `access: "public"` and `updateInternalDependencies: "patch"` were set from the original single-package setup
+  - CI release workflow needs both GITHUB_TOKEN (for PR creation) and NPM_TOKEN/NODE_AUTH_TOKEN (for npm publishing) — the original only had GITHUB_TOKEN
+  - `changesets/action@v1` handles workspace publishing automatically — `changeset publish` publishes all packages with pending version bumps
+  - `workspace:*` is resolved at publish time — changesets replace it with the actual semver version in the published package.json
+  - Biome lint fails on this repo due to nested root configs in templates/ — this is pre-existing and not related to any story changes
+  - CLAUDE.md Architecture section should match actual directory structure — the old section described layers/, integrations/, template-hooks/ at root which no longer exist
+---
+
+## 2026-02-12 - US-015
+- What was implemented: End-to-end verification of all 4 template types
+- Verification results:
+  - npm link from packages/cli/ succeeded
+  - basement -c /tmp/test-default -d -no-cms -no-animation -claude -no-hooks — SUCCESS
+  - basement -c /tmp/test-webgl -webgl -no-cms -no-animation -claude -no-hooks — SUCCESS
+  - basement -c /tmp/test-webgpu -webgpu -no-cms -no-animation -claude -no-hooks — SUCCESS
+  - basement -c /tmp/test-experiment -experiment -no-cms -no-animation -claude -no-hooks — SUCCESS
+  - 26/26 structural checks pass (deps, .gitignore rename, template-specific files/dirs)
+  - bun install succeeds on generated projects (392 packages, 5.25s)
+- **Learnings:**
+  - All templates produce valid Next.js projects with react@19.2.4, next@16.1.4, react-dom@19.2.4
+  - _gitignore -> .gitignore rename works correctly for all templates
+  - Local template copy is instant (no network call) — significantly faster than the old tiged-based approach
+  - WebGL template includes components/webgl/ with canvas/ and components/ subdirectories
+  - WebGPU template is deps-only (alpha R3F versions, no extra component files)
+  - Experiment template includes navigation-menu.tsx and lib/constants.ts
+
+## RESTRUCTURE COMPLETE — 15/15 stories pass
+---
+

package/tasks/ralph.sh

@@ -0,0 +1,113 @@
+#!/bin/bash
+# Ralph Wiggum - Long-running AI agent loop
+# Usage: ./ralph.sh [--tool amp|claude] [max_iterations]
+
+set -e
+
+# Parse arguments
+TOOL="amp"  # Default to amp for backwards compatibility
+MAX_ITERATIONS=10
+
+while [[ $# -gt 0 ]]; do
+  case $1 in
+    --tool)
+      TOOL="$2"
+      shift 2
+      ;;
+    --tool=*)
+      TOOL="${1#*=}"
+      shift
+      ;;
+    *)
+      # Assume it's max_iterations if it's a number
+      if [[ "$1" =~ ^[0-9]+$ ]]; then
+        MAX_ITERATIONS="$1"
+      fi
+      shift
+      ;;
+  esac
+done
+
+# Validate tool choice
+if [[ "$TOOL" != "amp" && "$TOOL" != "claude" ]]; then
+  echo "Error: Invalid tool '$TOOL'. Must be 'amp' or 'claude'."
+  exit 1
+fi
+SCRIPT_DIR="$(cd "$(dirname "${BASH_SOURCE[0]}")" && pwd)"
+PRD_FILE="$SCRIPT_DIR/prd.json"
+PROGRESS_FILE="$SCRIPT_DIR/progress.txt"
+ARCHIVE_DIR="$SCRIPT_DIR/archive"
+LAST_BRANCH_FILE="$SCRIPT_DIR/.last-branch"
+
+# Archive previous run if branch changed
+if [ -f "$PRD_FILE" ] && [ -f "$LAST_BRANCH_FILE" ]; then
+  CURRENT_BRANCH=$(jq -r '.branchName // empty' "$PRD_FILE" 2>/dev/null || echo "")
+  LAST_BRANCH=$(cat "$LAST_BRANCH_FILE" 2>/dev/null || echo "")
+  
+  if [ -n "$CURRENT_BRANCH" ] && [ -n "$LAST_BRANCH" ] && [ "$CURRENT_BRANCH" != "$LAST_BRANCH" ]; then
+    # Archive the previous run
+    DATE=$(date +%Y-%m-%d)
+    # Strip "ralph/" prefix from branch name for folder
+    FOLDER_NAME=$(echo "$LAST_BRANCH" | sed 's|^ralph/||')
+    ARCHIVE_FOLDER="$ARCHIVE_DIR/$DATE-$FOLDER_NAME"
+    
+    echo "Archiving previous run: $LAST_BRANCH"
+    mkdir -p "$ARCHIVE_FOLDER"
+    [ -f "$PRD_FILE" ] && cp "$PRD_FILE" "$ARCHIVE_FOLDER/"
+    [ -f "$PROGRESS_FILE" ] && cp "$PROGRESS_FILE" "$ARCHIVE_FOLDER/"
+    echo "   Archived to: $ARCHIVE_FOLDER"
+    
+    # Reset progress file for new run
+    echo "# Ralph Progress Log" > "$PROGRESS_FILE"
+    echo "Started: $(date)" >> "$PROGRESS_FILE"
+    echo "---" >> "$PROGRESS_FILE"
+  fi
+fi
+
+# Track current branch
+if [ -f "$PRD_FILE" ]; then
+  CURRENT_BRANCH=$(jq -r '.branchName // empty' "$PRD_FILE" 2>/dev/null || echo "")
+  if [ -n "$CURRENT_BRANCH" ]; then
+    echo "$CURRENT_BRANCH" > "$LAST_BRANCH_FILE"
+  fi
+fi
+
+# Initialize progress file if it doesn't exist
+if [ ! -f "$PROGRESS_FILE" ]; then
+  echo "# Ralph Progress Log" > "$PROGRESS_FILE"
+  echo "Started: $(date)" >> "$PROGRESS_FILE"
+  echo "---" >> "$PROGRESS_FILE"
+fi
+
+echo "Starting Ralph - Tool: $TOOL - Max iterations: $MAX_ITERATIONS"
+
+for i in $(seq 1 $MAX_ITERATIONS); do
+  echo ""
+  echo "==============================================================="
+  echo "  Ralph Iteration $i of $MAX_ITERATIONS ($TOOL)"
+  echo "==============================================================="
+
+  # Run the selected tool with the ralph prompt
+  if [[ "$TOOL" == "amp" ]]; then
+    OUTPUT=$(cat "$SCRIPT_DIR/prompt.md" | amp --dangerously-allow-all 2>&1 | tee /dev/stderr) || true
+  else
+    # Claude Code: use --dangerously-skip-permissions for autonomous operation, --print for output
+    OUTPUT=$(claude --dangerously-skip-permissions --print < "$SCRIPT_DIR/CLAUDE.md" 2>&1 | tee /dev/stderr) || true
+  fi
+  
+  # Check for completion signal
+  if echo "$OUTPUT" | grep -q "<promise>COMPLETE</promise>"; then
+    echo ""
+    echo "Ralph completed all tasks!"
+    echo "Completed at iteration $i of $MAX_ITERATIONS"
+    exit 0
+  fi
+  
+  echo "Iteration $i complete. Continuing..."
+  sleep 2
+done
+
+echo ""
+echo "Ralph reached max iterations ($MAX_ITERATIONS) without completing all tasks."
+echo "Check $PROGRESS_FILE for status."
+exit 1

package/layers/experiment/components/layout/header/index.tsx

@@ -1,58 +0,0 @@
-"use client";
-
-import { usePathname } from "next/navigation";
-import { Link } from "@/components/ui/link";
-import EXPERIMENTS from "@/lib/constants";
-import { cn } from "@/lib/styles/cn";
-import {
-	NavigationMenu,
-	NavigationMenuContent,
-	NavigationMenuItem,
-	NavigationMenuLink,
-	NavigationMenuList,
-	NavigationMenuTrigger,
-} from "../navigation-menu";
-
-export const Header = () => {
-	const pathname = usePathname();
-
-	return (
-		<nav className="fixed top-0 z-50 w-full py-2">
-			<div className="mx-auto flex items-center justify-between px-4">
-				<Link href="/" className="flex items-center gap-2 text-xl font-bold">
-					Basement Experiments Starter
-				</Link>
-				<NavigationMenu>
-					<NavigationMenuList>
-						<NavigationMenuItem>
-							<NavigationMenuTrigger className="text-sm font-medium px-8 py-6">
-								Experiments
-							</NavigationMenuTrigger>
-							<NavigationMenuContent>
-								<ul className="grid w-48 p-2 gap-1 bg-indigo-950/70 backdrop-blur-3xl text-white">
-									{EXPERIMENTS.map((experiment) => (
-										<li key={experiment.path}>
-											<NavigationMenuLink asChild>
-												<Link
-													href={experiment.path}
-													className={cn(
-														"block px-2 py-2 text-sm transition-colors duration-200 rounded-sm font-medium",
-														pathname === experiment.path
-															? "bg-purple-600 text-white"
-															: "text-white hover:bg-purple-500/20",
-													)}
-												>
-													{experiment.name}
-												</Link>
-											</NavigationMenuLink>
-										</li>
-									))}
-								</ul>
-							</NavigationMenuContent>
-						</NavigationMenuItem>
-					</NavigationMenuList>
-				</NavigationMenu>
-			</div>
-		</nav>
-	);
-};