bsmnt 0.0.2 → 0.1.0

package/tasks/prd.json

@@ -1,22 +1,24 @@
 {
   "project": "basement-cli",
-  "branchName": "ralph/next-starter-dynamic-layers",
-  "description": "Replace 4 static templates with next-starter clone + dynamic technology layers to eliminate maintenance burden",
+  "branchName": "BertovDev/project-restructure",
+  "description": "Restructure basement-cli into a bun workspaces monorepo with separated CLI and template scaffolding packages",
   "userStories": [
     {
       "id": "US-001",
-      "title": "Create layer configuration system",
-      "description": "As a CLI maintainer, I want technology layers defined in a config file so that adding or modifying layers only requires changing one file.",
+      "title": "Create monorepo skeleton with workspace config",
+      "description": "As a maintainer, I want the project organized as a bun workspaces monorepo so packages are properly isolated.",
       "acceptanceCriteria": [
-        "Add LAYER_CONFIG export to src/mergers/config.js alongside existing CMS_CONFIG",
-        "Each layer config defines: replaceFiles, additivePaths, dependencies, devDependencies",
-        "Add getLayerConfig(layer) helper function export",
-        "Config contains entries for webgl, webgpu, and experiment",
-        "webgpu is a deps-only layer (empty replaceFiles and additivePaths arrays)",
-        "webgl dependencies: @react-three/fiber ^9.5.0, @react-three/drei ^10.7.7, three ^0.182.0, @gsap/react ^2.0.0, @radix-ui/react-navigation-menu ^1.2.5, leva ^0.9.35, devDeps: @types/three ^0.182.0",
-        "webgpu dependencies: @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, devDeps: @types/three ^0.182.0",
-        "experiment dependencies: @react-three/fiber ^9.5.0, @react-three/drei ^10.7.7, three ^0.172.0, leva ^0.9.35, lucide-react ^0.474.0, @radix-ui/react-navigation-menu ^1.2.5, devDeps: @types/three ^0.182.0",
-        "Typecheck passes"
+        "Create packages/cli/ directory",
+        "Create packages/create-basement-app/ directory",
+        "Create packages/create-basement-app/templates/ directory",
+        "Create packages/create-basement-app/integrations/ directory",
+        "Create packages/create-basement-app/template-hooks/ directory",
+        "Create packages/create-basement-app/plugins/ directory",
+        "Update root package.json: add \"workspaces\": [\"packages/*\"], keep existing name/version/type/scripts",
+        "Root biome.json stays at root (shared across all packages)",
+        "Create packages/cli/package.json with name @basementstudio/cli, bin basement pointing to ./bin/index.js, type module",
+        "Create packages/create-basement-app/package.json with name @basementstudio/create-basement-app, type module",
+        "Typecheck passes (no syntax errors in JS files)"
       ],
       "priority": 1,
       "passes": true,
@@ -24,130 +26,264 @@
     },
     {
       "id": "US-002",
-      "title": "Extract layer files from templates",
-      "description": "As a CLI maintainer, I need the unique files from each template extracted into a layers/ directory so they can be overlaid on next-starter.",
+      "title": "Move CLI code to packages/cli",
+      "description": "As a developer, I want CLI argument parsing and command routing isolated in its own package.",
       "acceptanceCriteria": [
-        "Create layers/webgl/app/page.tsx copied from template/webgl/app/page.tsx (the one that imports DynamicCanvas)",
-        "Create layers/webgl/components/webgl/canvas/dynamic.tsx from template/webgl/components/webgl/canvas/dynamic.tsx",
-        "Create layers/webgl/components/webgl/canvas/index.tsx from template/webgl/components/webgl/canvas/index.tsx",
-        "Create layers/webgl/components/webgl/components/scene/index.tsx from template/webgl/components/webgl/components/scene/index.tsx",
-        "Create layers/experiment/components/layout/header/index.tsx from template/experiment/components/layout/header/index.tsx",
-        "Create layers/experiment/components/layout/navigation-menu.tsx from template/experiment/components/layout/navigation-menu.tsx",
-        "Create layers/experiment/lib/constats.ts from template/experiment/lib/constats.ts",
-        "Create layers/experiment/lib/utils/cn.ts from template/experiment/lib/utils/cn.ts",
-        "Create empty layers/webgpu/ directory with a .gitkeep file",
-        "All copied files are byte-for-byte identical to their template source files",
-        "Typecheck passes"
+        "Move bin/index.js to packages/cli/bin/index.js",
+        "Move src/commands/create.js to packages/cli/src/commands/create.js",
+        "Move src/commands/add-integration.js to packages/cli/src/commands/add-integration.js",
+        "Move src/commands/worktree.js to packages/cli/src/commands/worktree.js",
+        "Move src/commands/setup-sanity.js to packages/cli/src/commands/setup-sanity.js",
+        "Update all import paths in bin/index.js to reference new ../src/commands/ locations",
+        "Update packages/cli/package.json dependencies: add fs-extra, ora, picocolors, prompts, tiged, dotenv from root package.json",
+        "Remove chalk from packages/cli dependencies (standardize on picocolors)",
+        "Replace any chalk usage in bin/index.js with picocolors",
+        "Verify: node packages/cli/bin/index.js --help shows help text without errors",
+        "Typecheck passes (no syntax errors)"
       ],
       "priority": 2,
       "passes": true,
-      "notes": ""
+      "notes": "bin/index.js uses chalk for banner - replace with picocolors. All src/commands/ files use picocolors already."
     },
     {
       "id": "US-003",
-      "title": "Implement layer injection function",
-      "description": "As the CLI system, I need to overlay layer-specific files on top of the next-starter base so that WebGL/WebGPU/Experiment projects get their unique components.",
+      "title": "Move merger code to create-basement-app package",
+      "description": "As a maintainer, I want all scaffolding and merge logic in the create-basement-app package.",
       "acceptanceCriteria": [
-        "Add injectLayer(targetDir, layer, spinner) function to src/mergers/index.js",
-        "Function resolves layer directory from CLI repo's layers/{type}/ path using __dirname",
-        "Function calls existing detectPathPrefix() to handle src/ directory structure",
-        "Function copies additive files from local layers/ directory (no tiged clone needed)",
-        "Function replaces files listed in replaceFiles config (overwrites base version with overwrite: true)",
-        "Function uses existing transformPath() for path prefix support",
-        "Function returns results object with replaced, copied, skipped, and failed arrays",
-        "When layer is 'default' or not found in config, function returns early with skipped result (no error)",
-        "Extend formatMergeResults() to display replaced entries with checkmark prefix",
-        "Typecheck passes"
+        "Move src/mergers/index.js to packages/create-basement-app/src/mergers/index.js",
+        "Move src/mergers/config.js to packages/create-basement-app/src/mergers/config.js",
+        "Move src/mergers/layout-merger.js to packages/create-basement-app/src/mergers/layout-merger.js",
+        "Move src/mergers/sitemap-merger.js to packages/create-basement-app/src/mergers/sitemap-merger.js",
+        "Move src/mergers/check-integration-merger.js to packages/create-basement-app/src/mergers/check-integration-merger.js",
+        "Delete orphaned src/mergers/next-config-merger.js (defined but never registered in CMS_MERGERS)",
+        "Update import paths in packages/cli/src/commands/create.js to reference create-basement-app mergers",
+        "Update import paths in packages/cli/src/commands/add-integration.js similarly",
+        "Add fs-extra, picocolors, tiged as dependencies in packages/create-basement-app/package.json",
+        "Create packages/create-basement-app/src/index.js that re-exports injectLayer, injectIntegration, formatMergeResults, getLayerConfig, getCmsConfig",
+        "Typecheck passes (no syntax errors)"
       ],
       "priority": 3,
       "passes": true,
-      "notes": "Reuses existing detectPathPrefix() and transformPath() from src/mergers/index.js. Layer files are local (no network request)."
+      "notes": "next-config-merger.js is orphaned (not in CMS_MERGERS) - delete it. Merger functions use __dirname to resolve layers/ path - this will need updating in later stories."
     },
     {
       "id": "US-004",
-      "title": "Change create.js to clone next-starter instead of template",
-      "description": "As a developer using the CLI, I want my project scaffolded from the latest next-starter repo so I always get the most up-to-date base.",
+      "title": "Generate default template from next-starter",
+      "description": "As a contributor, I want a complete default template so I can preview and test it independently.",
       "acceptanceCriteria": [
-        "Change tiged source on line 124 of src/commands/create.js from 'github:basementstudio/basement-cli/template/${type}#${branch}' to 'github:basementstudio/next-starter#main'",
-        "Remove the BASEMENT_CLI_BRANCH env var usage for template (keep if used elsewhere)",
-        "Delete bun.lock file after clone if it exists (since dependencies will be modified)",
-        "Update download spinner text to say 'Downloading next-starter from GitHub...' instead of mentioning template type",
-        "Update error/troubleshooting message in catch block to reference basementstudio/next-starter instead of basementstudio/basement-cli/template/{type}",
-        "Typecheck passes"
+        "Clone basementstudio/next-starter#main into packages/create-basement-app/templates/default/ using tiged",
+        "Rename .gitignore to _gitignore in the template (npm strips dotfiles from published packages)",
+        "Template has a valid package.json with next, react, react-dom dependencies",
+        "Template directory contains app/, components/, lib/ directories",
+        "Delete any bun.lock or package-lock.json from the template",
+        "The template is a complete Next.js project (not a partial overlay)",
+        "Typecheck passes (no syntax errors)"
       ],
       "priority": 4,
       "passes": true,
-      "notes": ""
+      "notes": "Used gh repo clone (private repo requires auth). Cloned next-starter#main, removed .git, renamed .gitignore to _gitignore, deleted bun.lock, removed .tldr cache."
     },
     {
       "id": "US-005",
-      "title": "Wire layer injection into create flow",
-      "description": "As the CLI system, I need the layer injection step between template download and CMS integration so layers are applied at the right time.",
+      "title": "Generate webgl template from default plus layer",
+      "description": "As a contributor, I want a standalone WebGL template with R3F components and dependencies pre-configured.",
       "acceptanceCriteria": [
-        "Add new step between template download (step 3) and CMS integration (step 3.5) in src/commands/create.js",
-        "Layer injection only runs when type !== 'default'",
-        "Import injectLayer and formatMergeResults from src/mergers/index.js",
-        "Show ora spinner with layer name during injection (e.g. 'Applying webgl layer...')",
-        "Display injection results to user using formatMergeResults",
-        "On failure, show warning (not hard error) and continue with project creation",
-        "Typecheck passes"
+        "Copy packages/create-basement-app/templates/default/ to packages/create-basement-app/templates/webgl/",
+        "Copy layers/webgl/app/page.tsx to templates/webgl/app/page.tsx (overwrite the default page)",
+        "Copy layers/webgl/components/webgl/ directory into templates/webgl/components/webgl/",
+        "Merge WebGL dependencies into templates/webgl/package.json: @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",
+        "Merge WebGL devDependencies: @types/three ^0.182.0",
+        "Rename .gitignore to _gitignore if not already done",
+        "Template webgl/ is a complete Next.js project with WebGL components included",
+        "Typecheck passes (no syntax errors)"
       ],
       "priority": 5,
       "passes": true,
-      "notes": "Must run BEFORE CMS integration because layers don't modify layout.tsx, and CMS mergers need the base layout intact."
+      "notes": "Copied default template, overlaid WebGL page.tsx + 3 component files (canvas/dynamic.tsx, canvas/index.tsx, components/scene/index.tsx), injected 5 deps + 1 devDep into package.json."
     },
     {
       "id": "US-006",
-      "title": "Config-driven dependency injection in package.json hydration",
-      "description": "As the CLI system, I need package.json hydration to read layer dependencies from LAYER_CONFIG instead of being hardcoded.",
+      "title": "Generate webgpu template from default plus deps",
+      "description": "As a contributor, I want a standalone WebGPU template with alpha R3F dependencies pre-configured.",
       "acceptanceCriteria": [
-        "Import getLayerConfig from src/mergers/config.js in create.js",
-        "Read layer dependencies from LAYER_CONFIG and merge into package.json: pkg.dependencies = { ...pkg.dependencies, ...layerConfig.dependencies }",
-        "Also merge devDependencies from layer config",
-        "CMS dependency injection (Sanity/BaseHub) still works unchanged",
-        "Animation library injection (GSAP/Framer Motion) still works unchanged",
-        "Simplify package.json handling: next-starter uses package.json directly (not package.template.json), remove the rename logic",
-        "Project name still set to user-provided name, version still set to 0.1.0",
-        "Typecheck passes"
+        "Copy packages/create-basement-app/templates/default/ to packages/create-basement-app/templates/webgpu/",
+        "Merge WebGPU dependencies into templates/webgpu/package.json: @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",
+        "Merge WebGPU devDependencies: @types/three ^0.182.0",
+        "Rename .gitignore to _gitignore if not already done",
+        "WebGPU template has no additional component files (deps-only, matching current behavior)",
+        "Template webgpu/ is a complete Next.js project",
+        "Typecheck passes (no syntax errors)"
       ],
       "priority": 6,
       "passes": true,
-      "notes": "next-starter uses package.json not package.template.json, so the existsSync check for package.template.json can be simplified."
+      "notes": "Copied default template, injected 6 deps + 1 devDep into package.json. Deps-only (no overlay files). Uses alpha R3F versions."
     },
     {
       "id": "US-007",
-      "title": "Delete template directory",
-      "description": "As a CLI maintainer, I want the template/ directory removed so there's no duplicated code to maintain.",
+      "title": "Generate experiment template from default plus layer",
+      "description": "As a contributor, I want a standalone experiment template with navigation components and dependencies.",
       "acceptanceCriteria": [
-        "Delete template/default/ directory and all contents",
-        "Delete template/webgl/ directory and all contents",
-        "Delete template/webgpu/ directory and all contents",
-        "Delete template/experiment/ directory and all contents",
-        "Grep source code for any remaining references to 'template/' paths and remove them",
-        "Grep source code for any remaining references to 'basementstudio/basement-cli/template/' and remove them",
-        "Typecheck passes"
+        "Copy packages/create-basement-app/templates/default/ to packages/create-basement-app/templates/experiment/",
+        "Copy layers/experiment/components/layout/header/index.tsx to templates/experiment/components/layout/header/index.tsx (overwrite default header)",
+        "Copy layers/experiment/components/layout/navigation-menu.tsx to templates/experiment/components/layout/navigation-menu.tsx",
+        "Copy layers/experiment/lib/constants.ts to templates/experiment/lib/constants.ts",
+        "Merge experiment dependencies into templates/experiment/package.json: @react-three/fiber ^9.5.0, @react-three/drei ^10.7.7, three ^0.172.0, class-variance-authority latest, leva ^0.9.35, lucide-react ^0.474.0, @radix-ui/react-navigation-menu ^1.2.5",
+        "Merge experiment devDependencies: @types/three ^0.182.0",
+        "Rename .gitignore to _gitignore if not already done",
+        "Template experiment/ is a complete Next.js project with experiment navigation",
+        "Typecheck passes (no syntax errors)"
       ],
       "priority": 7,
       "passes": true,
-      "notes": ""
+      "notes": "Copied default template, overlaid 3 files (header/index.tsx replace, navigation-menu.tsx additive, constants.ts additive), injected 6 deps + 1 devDep. Used actual LAYER_CONFIG values (three ^0.182.0, cva ^0.7.0 already satisfied by ^0.7.1)."
     },
     {
       "id": "US-008",
-      "title": "End-to-end verification of all template types",
-      "description": "As a CLI maintainer, I need to verify all template + CMS + animation combinations produce working projects.",
+      "title": "Move Sanity integration files locally with config manifest",
+      "description": "As a maintainer, I want Sanity integration files local to create-basement-app with a single config manifest.",
       "acceptanceCriteria": [
-        "Run npm link to install CLI locally",
-        "Run: basement -c test-default -d -no-cms -no-animation -claude -no-hooks — project creates successfully",
-        "Run: basement -c test-webgl -webgl -no-cms -no-animation -claude -no-hooks — project has R3F components in components/webgl/",
-        "Run: basement -c test-webgpu -webgpu -no-cms -no-animation -claude -no-hooks — project has WebGPU deps in package.json",
-        "Run: basement -c test-experiment -exp -no-cms -no-animation -claude -no-hooks — project has custom header with NavigationMenu",
-        "Run: basement -c test-sanity -webgl -sanity -gsap -claude -no-hooks — project has CMS + animation + layer deps",
-        "All generated projects pass bun install without errors",
-        "Typecheck passes"
+        "Copy all files from integrations/sanity/ to packages/create-basement-app/integrations/sanity/files/",
+        "Move merger files to packages/create-basement-app/integrations/sanity/mergers/: layout-merger.js, sitemap-merger.js, check-integration-merger.js (copy from packages/create-basement-app/src/mergers/)",
+        "Create packages/create-basement-app/integrations/sanity/config.js with single-source-of-truth config containing: name, dependencies (@sanity/asset-utils, @sanity/image-url, @sanity/visual-editing, next-sanity), devDependencies (sanity, @sanity/vision), scripts (sanity:extract, sanity:typegen), additivePaths, mergeFiles",
+        "Sanity dependencies come from what is currently hardcoded in create.js lines 239-266",
+        "Sanity scripts come from what is currently hardcoded in create.js lines 254-259",
+        "Config additivePaths and mergeFiles match current CMS_CONFIG.sanity in config.js",
+        "Typecheck passes (no syntax errors)"
       ],
       "priority": 8,
       "passes": true,
-      "notes": "This is the final validation step. Each test project should be cleaned up after verification."
+      "notes": "Copied 35 integration files to integrations/sanity/files/, 3 mergers to integrations/sanity/mergers/, created config.js with deps/devDeps/scripts/additivePaths/mergeFiles unified from create.js + CMS_CONFIG."
+    },
+    {
+      "id": "US-009",
+      "title": "Move BaseHub integration, template-hooks, and plugins",
+      "description": "As a maintainer, I want all scaffolding assets co-located in create-basement-app.",
+      "acceptanceCriteria": [
+        "Copy integrations/basehub/ to packages/create-basement-app/integrations/basehub/files/",
+        "Create packages/create-basement-app/integrations/basehub/config.js with: name, dependencies (basehub ^3.0.0), additivePaths",
+        "Move template-hooks/*.ts to packages/create-basement-app/template-hooks/",
+        "Create packages/create-basement-app/template-hooks/config.js exporting array of hook configs with: name, file, dependencies (e.g. use-battery needs lodash-es, use-device-perf needs detect-gpu + react-device-detect + zustand)",
+        "Move plugins/*.grit to packages/create-basement-app/plugins/",
+        "Typecheck passes (no syntax errors)"
+      ],
+      "priority": 9,
+      "passes": true,
+      "notes": "Copied basehub README to integrations/basehub/files/, created config.js with deps. Copied 4 hooks to template-hooks/ with config.js declaring npm deps. Copied 3 grit plugins + README to plugins/."
+    },
+    {
+      "id": "US-010",
+      "title": "Update merger paths to use create-basement-app locations",
+      "description": "As a maintainer, I want the merger system to resolve files from create-basement-app paths instead of old root-relative paths.",
+      "acceptanceCriteria": [
+        "Update packages/create-basement-app/src/mergers/index.js: change layer path resolution from path.resolve(__dirname, '../../layers', layer) to path.resolve(__dirname, '../../templates', layer)",
+        "Update injectIntegration to read integration files from local packages/create-basement-app/integrations/{cms}/files/ instead of cloning from remote GitHub branch via tiged",
+        "Update CMS_MERGERS to import mergers from integrations/{cms}/mergers/ instead of co-located merger files",
+        "Update packages/create-basement-app/src/mergers/config.js: CMS_CONFIG no longer needs 'branch' field (files are local now)",
+        "Update packages/cli/src/commands/create.js: read CMS deps/scripts from integration config.js instead of hardcoded values",
+        "Remove tiged dependency from create-basement-app if no longer needed (check if anything else uses it)",
+        "Verify injectLayer still works by checking path resolution against templates/ directory structure",
+        "Verify injectIntegration still works by checking path resolution against integrations/ directory structure",
+        "Typecheck passes (no syntax errors)"
+      ],
+      "priority": 10,
+      "passes": true,
+      "notes": "Updated injectIntegration to use local fs.copy from integrations/{cms}/files/ instead of tiged remote clone. Updated injectLayer path from ../../layers to ../../templates. CMS_MERGERS now import from integrations/sanity/mergers/. Removed branch field from CMS_CONFIG. CLI create.js and add-integration.js now read CMS deps/scripts from integration config manifests. Removed tiged dep from create-basement-app."
+    },
+    {
+      "id": "US-011",
+      "title": "Update CLI create command to use centralized configs",
+      "description": "As a maintainer, I want create.js to read all dependency info from config manifests with zero hardcoded versions.",
+      "acceptanceCriteria": [
+        "In packages/cli/src/commands/create.js: replace hardcoded Sanity deps (lines 239-266 equivalent) with import from integrations/sanity/config.js",
+        "Replace hardcoded BaseHub deps with import from integrations/basehub/config.js",
+        "Replace hardcoded animation deps with a new configs/animations.js manifest in create-basement-app: gsap -> {gsap: ^3.12.0, @gsap/react: ^2.0.0}, motion -> {motion: ^12.0.0}",
+        "Replace hardcoded CMS scripts with import from integration config.js",
+        "Hook copying reads from template-hooks/config.js for hook dependencies to inject",
+        "Template prompt reads available template names by listing packages/create-basement-app/templates/ directory",
+        "Zero hardcoded dependency version strings remain in create.js",
+        "Remove unused inquirer from root package.json dependencies",
+        "Remove dotenv if only used for CLI development (move to devDependencies or remove)",
+        "Typecheck passes (no syntax errors)"
+      ],
+      "priority": 11,
+      "passes": true,
+      "notes": "Created animations.js config manifest. Animation deps, hook deps, CMS deps/scripts all config-driven. Template prompt dynamic from templates/ dir. Removed inquirer and chalk from root. dotenv kept (used at runtime in create.js for .env loading)."
+    },
+    {
+      "id": "US-012",
+      "title": "Update template download to copy local templates",
+      "description": "As a maintainer, I want the CLI to copy templates from local create-basement-app instead of cloning from GitHub.",
+      "acceptanceCriteria": [
+        "In packages/cli/src/commands/create.js: replace tiged clone of basementstudio/next-starter#main with fs-extra copy from packages/create-basement-app/templates/{type}/",
+        "Remove the separate layer injection step (step 3.2) since templates are already complete standalone projects",
+        "Keep CMS integration injection step (step 3.5) since integrations still use the merge approach",
+        "Rename _gitignore back to .gitignore after copying template to target dir",
+        "Update spinner text from 'Downloading next-starter...' to 'Copying template...'",
+        "Template copy is instant (no network call) which improves CLI speed",
+        "Verify: running the CLI with each template type produces a valid project directory",
+        "Typecheck passes (no syntax errors)"
+      ],
+      "priority": 12,
+      "passes": true,
+      "notes": "Replaced tiged remote clone with fs.copy from local templates. Removed layer injection step 3.2 (templates are standalone). Added _gitignore->. gitignore rename. Removed layer dep injection from hydration (already in template package.json). Removed tiged dep from CLI package."
+    },
+    {
+      "id": "US-013",
+      "title": "Clean up old root directories and dead code",
+      "description": "As a maintainer, I want all old root-level directories removed since content has moved to packages.",
+      "acceptanceCriteria": [
+        "Delete root layers/ directory (files now in templates)",
+        "Delete root integrations/ directory (files now in packages/create-basement-app/integrations/)",
+        "Delete root template-hooks/ directory (files now in packages/create-basement-app/template-hooks/)",
+        "Delete root plugins/ directory (files now in packages/create-basement-app/plugins/)",
+        "Delete root src/ directory (code moved to packages/cli/src/ and packages/create-basement-app/src/)",
+        "Delete root bin/ directory (moved to packages/cli/bin/)",
+        "Remove chalk from root package.json dependencies",
+        "Remove inquirer from root package.json dependencies",
+        "Remove fs-extra, ora, picocolors, prompts, tiged, dotenv from root package.json (they're now in workspace packages)",
+        "Root package.json only has: workspaces config, shared scripts (build, lint, typecheck), devDependencies (biome, changesets)",
+        "Grep entire codebase for any remaining references to old paths (../../layers, ../../template-hooks, etc.) and fix them",
+        "Typecheck passes (no syntax errors)"
+      ],
+      "priority": 13,
+      "passes": true,
+      "notes": "Deleted 6 root dirs (layers, integrations, template-hooks, plugins, src, bin). Cleaned root package.json: renamed to basement-starter-cli, added private:true, removed bin field, removed test script, removed all runtime deps (now in workspace packages). Removed dotenv from CLI. Added workspace:* dep. Added main field to create-basement-app. 8605 lines deleted."
+    },
+    {
+      "id": "US-014",
+      "title": "Update changeset config and CI for workspaces",
+      "description": "As a maintainer, I want the release pipeline to publish both packages independently.",
+      "acceptanceCriteria": [
+        "Update .changeset/config.json for workspace-aware publishing (add access: public if scoped packages)",
+        "Update .github/workflows/release.yml to build both packages before publishing",
+        "Each package has its own changeset-compatible version field",
+        "packages/cli/package.json has @basementstudio/create-basement-app as workspace dependency: workspace:*",
+        "CLAUDE.md at project root updated to reflect new architecture (packages/, no more layers/, templates in create-basement-app/)",
+        "README.md updated with new project structure overview",
+        "Typecheck passes (no syntax errors)"
+      ],
+      "priority": 14,
+      "passes": true,
+      "notes": "Changeset config already workspace-ready (access: public, updateInternalDependencies: patch). Added NPM_TOKEN/NODE_AUTH_TOKEN to CI for npm publishing. Updated CLAUDE.md architecture, CLI flow, integration sources, plugin paths. Updated README.md with monorepo structure overview."
+    },
+    {
+      "id": "US-015",
+      "title": "End-to-end verification of restructured CLI",
+      "description": "As a maintainer, I need to verify the restructured CLI produces working projects identical to the old version.",
+      "acceptanceCriteria": [
+        "Run npm link from packages/cli/ to install CLI locally",
+        "Run: basement -c /tmp/test-default -d -no-cms -claude -no-hooks — project creates successfully with default template",
+        "Run: basement -c /tmp/test-webgl -webgl -no-cms -claude -no-hooks — project has R3F components and deps",
+        "Run: basement -c /tmp/test-webgpu -webgpu -no-cms -claude -no-hooks — project has WebGPU deps in package.json",
+        "Run: basement -c /tmp/test-experiment -experiment -no-cms -claude -no-hooks — project has experiment header and nav",
+        "All generated projects have valid package.json with correct dependencies",
+        "All generated projects pass bun install without errors",
+        "Clean up test projects after verification",
+        "Typecheck passes (no syntax errors)"
+      ],
+      "priority": 15,
+      "passes": true,
+      "notes": "All 4 templates verified: default, webgl, webgpu, experiment. npm link + basement -c works for all. 26/26 checks pass (deps, .gitignore rename, template-specific files). bun install succeeds on generated projects."
     }
   ]
 }