code-as-plan 2.0.0 → 2.0.3

package/cap/workflows/update.md

@@ -1,5 +1,5 @@
 <purpose>
-Check for GSD updates via npm, display changelog for versions between installed and latest, obtain user confirmation, and execute clean installation with cache clearing.
+Check for CAP updates via npm, display changelog for versions between installed and latest, obtain user confirmation, and execute clean installation with cache clearing.
 </purpose>
 
 <required_reading>
@@ -9,7 +9,7 @@ Read all files referenced by the invoking prompt's execution_context before star
 <process>
 
 <step name="get_installed_version">
-Detect whether GSD is installed locally or globally by checking both locations and validating install integrity.
+Detect whether CAP is installed locally or globally by checking both locations and validating install integrity.
 
 First, derive `PREFERRED_RUNTIME` from the invoking prompt's `execution_context` path:
 - Path contains `/.codex/` -> `codex`
@@ -17,7 +17,7 @@ First, derive `PREFERRED_RUNTIME` from the invoking prompt's `execution_context`
 - Path contains `/.config/opencode/` or `/.opencode/` -> `opencode`
 - Otherwise -> `claude`
 
-Use `PREFERRED_RUNTIME` as the first runtime checked so `/gsd:update` targets the runtime that invoked it.
+Use `PREFERRED_RUNTIME` as the first runtime checked so `/cap:update` targets the runtime that invoked it.
 
 ```bash
 # Runtime candidates: "<runtime>:<config-dir>" stored as an array.
@@ -130,7 +130,7 @@ If multiple runtime installs are detected and the invoking runtime cannot be det
 
 **If VERSION file missing:**
 ```
-## GSD Update
+## CAP Update
 
 **Installed version:** Unknown
 
@@ -146,14 +146,14 @@ Proceed to install step (treat as version 0.0.0 for comparison).
 Check npm for latest version:
 
 ```bash
-npm view gsd-code-first version 2>/dev/null
+npm view code-as-plan version 2>/dev/null
 ```
 
 **If npm check fails:**
 ```
 Couldn't check for updates (offline or npm unavailable).
 
-To update manually: `npx gsd-code-first --global`
+To update manually: `npx code-as-plan@latest --global`
 ```
 
 Exit.
@@ -164,7 +164,7 @@ Compare installed vs latest:
 
 **If installed == latest:**
 ```
-## GSD Update
+## CAP Update
 
 **Installed:** X.Y.Z
 **Latest:** X.Y.Z
@@ -176,7 +176,7 @@ Exit.
 
 **If installed > latest:**
 ```
-## GSD Update
+## CAP Update
 
 **Installed:** X.Y.Z
 **Latest:** A.B.C
@@ -195,7 +195,7 @@ Exit.
 3. Display preview and ask for confirmation:
 
 ```
-## GSD Update Available
+## CAP Update Available
 
 **Installed:** 1.5.10
 **Latest:** 1.5.15
@@ -215,22 +215,22 @@ Exit.
 
 ────────────────────────────────────────────────────────────
 
-⚠️  **Note:** The installer performs a clean install of GSD folders:
-- `commands/gsd/` will be wiped and replaced
+⚠️  **Note:** The installer performs a clean install of CAP folders:
+- `commands/cap/` will be wiped and replaced
 - `cap/` will be wiped and replaced
-- `agents/gsd-*` files will be replaced
+- `agents/cap-*` files will be replaced
 
 (Paths are relative to detected runtime install location:
 global: `~/.claude/`, `~/.config/opencode/`, `~/.opencode/`, `~/.gemini/`, or `~/.codex/`
 local: `./.claude/`, `./.config/opencode/`, `./.opencode/`, `./.gemini/`, or `./.codex/`)
 
 Your custom files in other locations are preserved:
-- Custom commands not in `commands/gsd/` ✓
-- Custom agents not prefixed with `gsd-` ✓
+- Custom commands not in `commands/cap/` ✓
+- Custom agents not prefixed with `cap-` ✓
 - Custom hooks ✓
 - Your CLAUDE.md files ✓
 
-If you've modified any GSD files directly, they'll be automatically backed up to `gsd-local-patches/` and can be reapplied with `/gsd:reapply-patches` after the update.
+If you've modified any CAP files directly, they'll be automatically backed up to `cap-local-patches/` and can be reapplied with `/cap:reapply-patches` after the update.
 ```
 
 Use AskUserQuestion:
@@ -252,17 +252,17 @@ RUNTIME_FLAG="--$TARGET_RUNTIME"
 
 **If LOCAL install:**
 ```bash
-npx -y gsd-code-first@latest "$RUNTIME_FLAG" --local
+npx -y code-as-plan@latest "$RUNTIME_FLAG" --local
 ```
 
 **If GLOBAL install:**
 ```bash
-npx -y gsd-code-first@latest "$RUNTIME_FLAG" --global
+npx -y code-as-plan@latest "$RUNTIME_FLAG" --global
 ```
 
 **If UNKNOWN install:**
 ```bash
-npx -y gsd-code-first@latest --claude --global
+npx -y code-as-plan@latest --claude --global
 ```
 
 Capture output. If install fails, show error and exit.
@@ -272,8 +272,8 @@ Clear the update cache so statusline indicator disappears:
 ```bash
 # Clear update cache across all runtime directories
 for dir in .claude .config/opencode .opencode .gemini .codex; do
-  rm -f "./$dir/cache/gsd-update-check.json"
-  rm -f "$HOME/$dir/cache/gsd-update-check.json"
+  rm -f "./$dir/cache/cap-update-check.json"
+  rm -f "$HOME/$dir/cache/cap-update-check.json"
 done
 ```
 
@@ -285,12 +285,12 @@ Format completion message (changelog was already shown in confirmation step):
 
 ```
 ╔═══════════════════════════════════════════════════════════╗
-║  GSD Updated: v1.5.10 → v1.5.15                           ║
+║  CAP Updated: v1.5.10 → v1.5.15                            ║
 ╚═══════════════════════════════════════════════════════════╝
 
 ⚠️  Restart your runtime to pick up the new commands.
 
-[View full changelog](https://github.com/gsd-build/cap/blob/main/CHANGELOG.md)
+[View full changelog](https://github.com/dwall-sys/code-as-plan/blob/main/CHANGELOG.md)
 ```
 </step>
 
@@ -298,13 +298,13 @@ Format completion message (changelog was already shown in confirmation step):
 <step name="check_local_patches">
 After update completes, check if the installer detected and backed up any locally modified files:
 
-Check for gsd-local-patches/backup-meta.json in the config directory.
+Check for cap-local-patches/backup-meta.json in the config directory.
 
 **If patches found:**
 
 ```
 Local patches were backed up before the update.
-Run /gsd:reapply-patches to merge your modifications into the new version.
+Run /cap:reapply-patches to merge your modifications into the new version.
 ```
 
 **If no patches:** Continue normally.

package/commands/cap/migrate.md

@@ -0,0 +1,177 @@
+---
+name: cap:migrate
+description: "Migrate GSD Code-First v1.x projects to CAP v2.0 -- converts @gsd-* tags, planning artifacts, and session format."
+argument-hint: "[--dry-run] [--tags-only] [--force]"
+allowed-tools:
+  - Read
+  - Write
+  - Bash
+  - Glob
+  - Grep
+  - AskUserQuestion
+---
+
+<!-- @cap-feature(feature:F-MIGRATE) Migration command -- converts GSD v1.x projects to CAP v2.0 format. -->
+<!-- @cap-todo Supports --dry-run, --tags-only, and --force flags. -->
+
+<objective>
+Migrate a GSD Code-First v1.x project to CAP v2.0 format. Converts @gsd-* tags to @cap-* equivalents, transforms planning artifacts into FEATURE-MAP.md entries, and migrates .planning/SESSION.json to .cap/SESSION.json.
+</objective>
+
+<context>
+$ARGUMENTS
+
+@FEATURE-MAP.md
+</context>
+
+<process>
+
+## Step 0: Parse flags
+
+Check `$ARGUMENTS` for:
+- `--dry-run` — show what would change without writing files
+- `--tags-only` — only migrate tags, skip artifact and session migration
+- `--force` — skip user confirmation gate
+
+## Step 1: Analyze migration scope
+
+Run the analysis to determine what needs migrating:
+
+```bash
+node -e "
+const migrate = require('./cap/bin/lib/cap-migrate.cjs');
+const report = migrate.analyzeMigration(process.cwd());
+console.log(JSON.stringify(report, null, 2));
+"
+```
+
+Store as `analysis`. Present a summary to the user:
+
+```
+Migration Analysis
+==================
+
+@gsd-* tags found:     {gsdTagCount}
+Legacy artifacts:       {gsdArtifacts.length} ({list})
+.planning/ directory:   {yes/no}
+SESSION.json (v1.x):   {yes/no}
+
+Recommendations:
+{For each recommendation:}
+  - {recommendation}
+```
+
+## Step 2: Confirm with user (unless --force)
+
+If `--force` is NOT set and this is NOT `--dry-run`, use AskUserQuestion to confirm:
+
+> "Proceed with migration? This will modify source files and create CAP v2.0 artifacts. Use --dry-run first if you want to preview changes."
+
+If user declines, abort with message: "Migration cancelled. Run with --dry-run to preview changes."
+
+## Step 3: Migrate tags
+
+```bash
+node -e "
+const migrate = require('./cap/bin/lib/cap-migrate.cjs');
+const dryRun = process.argv[1] === 'true';
+const result = migrate.migrateTags(process.cwd(), { dryRun });
+console.log(JSON.stringify(result, null, 2));
+" '<DRY_RUN_VALUE>'
+```
+
+Store as `tag_result`. Report:
+
+```
+Tag Migration
+=============
+Files scanned:    {filesScanned}
+Files modified:   {filesModified}
+Tags converted:   {tagsConverted}
+Tags removed:     {tagsRemoved}
+
+{If changes.length > 0, show first 20 changes:}
+Changes:
+  {file}:{line} [{action}]
+    - {original}
+    + {replaced}
+```
+
+If `--tags-only` is set, skip to Step 6.
+
+## Step 4: Migrate artifacts
+
+```bash
+node -e "
+const migrate = require('./cap/bin/lib/cap-migrate.cjs');
+const dryRun = process.argv[1] === 'true';
+const result = migrate.migrateArtifacts(process.cwd(), { dryRun });
+console.log(JSON.stringify(result, null, 2));
+" '<DRY_RUN_VALUE>'
+```
+
+Store as `artifact_result`. Report:
+
+```
+Artifact Migration
+==================
+Source:            {source}
+Features found:    {featuresFound}
+Feature Map:       {featureMapCreated ? 'created/updated' : 'no changes'}
+```
+
+## Step 5: Migrate session
+
+```bash
+node -e "
+const migrate = require('./cap/bin/lib/cap-migrate.cjs');
+const dryRun = process.argv[1] === 'true';
+const result = migrate.migrateSession(process.cwd(), { dryRun });
+console.log(JSON.stringify(result, null, 2));
+" '<DRY_RUN_VALUE>'
+```
+
+Store as `session_result`. Report:
+
+```
+Session Migration
+=================
+Old format:   {oldFormat}
+New format:   {newFormat}
+Migrated:     {migrated ? 'yes' : 'no'}
+```
+
+## Step 6: Final report and session update
+
+```
+Migration Complete
+==================
+
+Tags:       {tagsConverted} converted, {tagsRemoved} removed
+Artifacts:  {featuresFound} features extracted → FEATURE-MAP.md
+Session:    {migrated ? 'migrated to .cap/SESSION.json' : 'no session to migrate'}
+
+{If dry run:}
+NOTE: This was a dry run. No files were modified. Run without --dry-run to apply changes.
+
+{If not dry run:}
+Next steps:
+  1. Review changes with `git diff`
+  2. Run /cap:scan to verify tag migration
+  3. Run /cap:status to see project state from Feature Map
+  4. Commit migrated files
+```
+
+Update session state (unless dry run):
+
+```bash
+node -e "
+const session = require('./cap/bin/lib/cap-session.cjs');
+session.updateSession(process.cwd(), {
+  lastCommand: '/cap:migrate',
+  lastCommandTimestamp: new Date().toISOString()
+});
+"
+```
+
+</process>

package/commands/cap/update.md

@@ -0,0 +1,48 @@
+---
+name: cap:update
+description: "Update CAP to the latest version -- checks npm, shows changelog, performs clean install with cache clearing."
+allowed-tools:
+  - Read
+  - Bash
+  - Glob
+  - Grep
+---
+
+<objective>
+Check for CAP updates via npm, display the changelog for versions between installed and latest, obtain user confirmation, and execute a clean installation with cache clearing.
+
+This command orchestrates the update workflow defined in `cap/workflows/update.md`.
+</objective>
+
+<context>
+$ARGUMENTS
+
+execution_context: commands/cap/update.md
+</context>
+
+<process>
+
+## Step 1: Load and execute the update workflow
+
+Read and follow the full workflow defined in:
+
+```
+cap/workflows/update.md
+```
+
+That workflow handles:
+1. Detecting installed version and install scope (local/global)
+2. Checking npm for the latest `code-as-plan` version
+3. Comparing versions and showing changelog
+4. Obtaining user confirmation before updating
+5. Running `npx code-as-plan@latest` with correct flags
+6. Clearing `cap-update-check.json` cache files
+7. Checking for local patches that need reapplication
+
+Follow every step in that workflow exactly as written.
+
+</process>
+
+<output>
+The workflow produces its own formatted output at each step. Do not add extra framing -- let the workflow messages speak for themselves.
+</output>

package/hooks/dist/gsd-check-update.js

@@ -1,6 +1,6 @@
 #!/usr/bin/env node
-// gsd-hook-version: {{GSD_VERSION}}
-// Check for GSD updates in background, write result to cache
+// cap-hook-version: {{GSD_VERSION}}
+// Check for CAP updates in background, write result to cache
 // Called by SessionStart hook - runs once per session
 
 const fs = require('fs');
@@ -30,7 +30,7 @@ function detectConfigDir(baseDir) {
 const globalConfigDir = detectConfigDir(homeDir);
 const projectConfigDir = detectConfigDir(cwd);
 const cacheDir = path.join(globalConfigDir, 'cache');
-const cacheFile = path.join(cacheDir, 'gsd-update-check.json');
+const cacheFile = path.join(cacheDir, 'cap-update-check.json');
 
 // VERSION file locations (check project first, then global)
 const projectVersionFile = path.join(projectConfigDir, 'cap', 'VERSION');
@@ -71,11 +71,11 @@ const child = spawn(process.execPath, ['-e', `
     const hooksDir = path.join(configDir, 'cap', 'hooks');
     try {
       if (fs.existsSync(hooksDir)) {
-        const hookFiles = fs.readdirSync(hooksDir).filter(f => f.startsWith('gsd-') && f.endsWith('.js'));
+        const hookFiles = fs.readdirSync(hooksDir).filter(f => (f.startsWith('gsd-') || f.startsWith('cap-')) && f.endsWith('.js'));
         for (const hookFile of hookFiles) {
           try {
             const content = fs.readFileSync(path.join(hooksDir, hookFile), 'utf8');
-            const versionMatch = content.match(/\\/\\/ gsd-hook-version:\\s*(.+)/);
+            const versionMatch = content.match(/\\/\\/ (?:gsd|cap)-hook-version:\\s*(.+)/);
             if (versionMatch) {
               const hookVersion = versionMatch[1].trim();
               if (hookVersion !== installed && !hookVersion.includes('{{')) {
@@ -93,7 +93,7 @@ const child = spawn(process.execPath, ['-e', `
 
   let latest = null;
   try {
-    latest = execSync('npm view gsd-code-first version', { encoding: 'utf8', timeout: 10000, windowsHide: true }).trim();
+    latest = execSync('npm view code-as-plan version', { encoding: 'utf8', timeout: 10000, windowsHide: true }).trim();
   } catch (e) {}
 
   const result = {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "code-as-plan",
-  "version": "2.0.0",
+  "version": "2.0.3",
   "description": "CAP — Code as Plan. Build first, plan from code. Farley-aligned engineering framework for Claude Code.",
   "bin": {
     "cap": "bin/install.js"