gsd-lite 0.7.0 → 0.7.4

package/.claude-plugin/marketplace.json

@@ -13,7 +13,7 @@
       "name": "gsd",
       "source": "./",
       "description": "AI orchestration tool — GSD management shell + Superpowers quality core. 5 commands, 4 agents, 5 workflows, MCP server, context monitoring.",
-      "version": "0.7.0",
+      "version": "0.7.4",
       "keywords": [
         "orchestration",
         "mcp",

package/.claude-plugin/plugin.json

@@ -1,6 +1,6 @@
 {
   "name": "gsd",
-  "version": "0.7.0",
+  "version": "0.7.4",
   "description": "AI orchestration tool for Claude Code — GSD management shell + Superpowers quality core",
   "author": {
     "name": "sdsrss",

package/README.md

@@ -291,7 +291,7 @@ gsd-lite/
 │   ├── gsd-session-stop.cjs   # Graceful shutdown with crash markers
 │   ├── gsd-statusline.cjs     # StatusLine display (composite-aware)
 │   └── lib/                   # Shared hook utilities (gsd-finder, composite statusline, semver)
-├── tests/                  # 909 tests (unit + simulation + E2E integration)
+├── tests/                  # 966 tests (unit + simulation + E2E integration)
 ├── cli.js                  # Install/uninstall CLI entry
 ├── install.js              # Installation script (plugin-aware, idempotent)
 └── uninstall.js            # Uninstall script
@@ -300,7 +300,7 @@ gsd-lite/
 ## Testing
 
 ```bash
-npm test                    # Run all 909 tests
+npm test                    # Run all 966 tests
 npm run test:coverage       # Tests + coverage report (94%+ lines, 83%+ branches)
 npm run lint                # Biome lint
 node --test tests/file.js   # Run a single test file

package/commands/doctor.md

@@ -28,18 +28,25 @@ Call the `health` MCP tool:
 
 Check if GSD hooks are registered in Claude settings:
 - Read `~/.claude/settings.json` (or `~/.claude/settings.local.json`)
-- StatusLine check (check BOTH paths):
-  1. Direct: `statusLine` entry containing `gsd-statusline`
-  2. Composite: read `~/.cache/code-graph/statusline-registry.json` — if any entry's `command` contains `gsd-statusline`, it is registered through the composite statusline system
-  - Either path present: StatusLine = registered
-- Check for `PostToolUse` hook entry containing `gsd-context-monitor`
-- Both present: record PASS
-- Partial: record WARN with which hook is missing
-- Neither: record FAIL "No GSD hooks registered"
-
-Also verify the hook files exist on disk:
+- StatusLine check (registered if ANY path matches):
+  1. Direct: `statusLine.command` contains `gsd-statusline`
+  2. Composite cache registry: `~/.cache/code-graph/statusline-registry.json` — any entry whose `command` contains `gsd-statusline`
+  3. Composite backup mirror: `~/.claude/statusline-providers.json` — same match rule (durable mirror written by code-graph's chain CLI)
+  - Any path present: StatusLine = registered
+- Check the three hook arrays in `settings.hooks`:
+  - `PostToolUse` entry referencing `gsd-context-monitor`
+  - `SessionStart` entry referencing `gsd-session-init`
+  - `Stop` entry referencing `gsd-session-stop`
+- All four (statusLine + three hooks) present: record PASS
+- Partial: record WARN naming each missing hook
+- None: record FAIL "No GSD hooks registered"
+
+Also verify the hook files exist on disk (install.js copies all five):
 - `~/.claude/hooks/gsd-statusline.cjs`
 - `~/.claude/hooks/gsd-context-monitor.cjs`
+- `~/.claude/hooks/gsd-session-init.cjs`
+- `~/.claude/hooks/gsd-session-stop.cjs`
+- `~/.claude/hooks/gsd-auto-update.cjs`
 - Files missing but settings present: record WARN "Hook registered but file missing"
 
 ## STEP 4: Lock File Check

package/commands/status.md

@@ -91,6 +91,7 @@ Blocked 任务:
 
 | workflow_mode | 建议 |
 |---|---|
+| planning | "仍在计划阶段，运行 /gsd:start 或 /gsd:prd 重新启动计划" |
 | executing_task | "自动执行中，等待完成" |
 | reviewing_task | "L2 审查进行中" |
 | reviewing_phase | "L1 阶段审查进行中" |

package/hooks/lib/statusline-composite.cjs

@@ -1,14 +1,26 @@
 'use strict';
 // Detect and register with composite statusline systems (e.g., code-graph).
 // Used by install.js, gsd-session-init.cjs, and uninstall.js.
+//
+// Preferred path (code-graph ≥ shipping statusline-chain.js): invoke that CLI
+// with `register gsd <cmd> --stdin` / `unregister gsd`. The CLI owns both the
+// primary cache registry and the ~/.claude/statusline-providers.json backup
+// mirror, so we do not have to know their layout.
+// Fallback path (older code-graph without the CLI): write the cache registry
+// directly, same as the original behavior.
 
 const fs = require('node:fs');
 const path = require('node:path');
 const os = require('node:os');
+const { execFileSync } = require('node:child_process');
+const { semverSortComparator } = require('./semver-sort.cjs');
 
-// Known composite statusline registry paths
+const CLAUDE_DIR = process.env.CLAUDE_CONFIG_DIR || path.join(os.homedir(), '.claude');
+
+// Known composite statusline registry paths (fallback-only — chain CLI is preferred).
 const REGISTRY_PATHS = [
   path.join(os.homedir(), '.cache', 'code-graph', 'statusline-registry.json'),
+  path.join(CLAUDE_DIR, 'statusline-providers.json'),
 ];
 
 function isCompositeStatusLine(command) {
@@ -22,13 +34,46 @@ function findCompositeRegistry() {
   return null;
 }
 
+/**
+ * Find code-graph's statusline-chain.js in the plugin cache (newest semver).
+ * Returns absolute path or null if the CLI hasn't shipped yet.
+ */
+function findChainScript() {
+  const base = path.join(CLAUDE_DIR, 'plugins', 'cache', 'code-graph-mcp', 'code-graph-mcp');
+  if (!fs.existsSync(base)) return null;
+  let versions;
+  try {
+    versions = fs.readdirSync(base).filter(v => /^\d+\.\d+\.\d+/.test(v));
+  } catch { return null; }
+  versions.sort(semverSortComparator).reverse();
+  for (const v of versions) {
+    const p = path.join(base, v, 'scripts', 'statusline-chain.js');
+    if (fs.existsSync(p)) return p;
+  }
+  return null;
+}
+
+function runChainCLI(args) {
+  const chainScript = findChainScript();
+  if (!chainScript) return false;
+  try {
+    execFileSync(process.execPath, [chainScript, ...args], { stdio: 'pipe', timeout: 5000 });
+    return true;
+  } catch { return false; }
+}
+
 /**
  * Register GSD as a provider in the composite statusline registry.
+ * Prefers code-graph's statusline-chain.js CLI when available; falls back to
+ * writing the cache registry directly for older code-graph versions.
  * Idempotent: updates existing entry or inserts before code-graph.
  * @param {string} statuslineScriptPath - Absolute path to gsd-statusline.cjs
  * @returns {boolean} true if registered/updated
  */
 function registerProvider(statuslineScriptPath) {
+  const command = `node ${JSON.stringify(statuslineScriptPath)}`;
+  if (runChainCLI(['register', 'gsd', command, '--stdin'])) return true;
+
   let registryPath = findCompositeRegistry();
 
   // If composite statusLine is configured but registry file is missing,
@@ -54,7 +99,6 @@ function registerProvider(statuslineScriptPath) {
     }
     if (!Array.isArray(registry)) return false;
 
-    const command = `node ${JSON.stringify(statuslineScriptPath)}`;
     const provider = { id: 'gsd', command, needsStdin: true };
 
     // Find existing GSD entry (by id or command)
@@ -82,9 +126,13 @@ function registerProvider(statuslineScriptPath) {
 
 /**
  * Remove GSD entry from composite statusline registry.
+ * Prefers code-graph's statusline-chain.js CLI when available; falls back to
+ * rewriting the cache registry directly for older code-graph versions.
  * @returns {boolean} true if an entry was removed
  */
 function removeProvider() {
+  if (runChainCLI(['unregister', 'gsd'])) return true;
+
   const registryPath = findCompositeRegistry();
   if (!registryPath) return false;
 

package/install.js

@@ -158,17 +158,45 @@ export function main() {
     }
   }
 
-  // 1. Commands
-  copyDir(join(__dirname, 'commands'), join(CLAUDE_DIR, 'commands', 'gsd'), 'commands → ~/.claude/commands/gsd/');
-
-  // 2. Agents (namespaced under gsd/ to avoid collisions) [I-5]
-  copyDir(join(__dirname, 'agents'), join(CLAUDE_DIR, 'agents', 'gsd'), 'agents → ~/.claude/agents/gsd/');
-
-  // 3. Workflows
-  copyDir(join(__dirname, 'workflows'), join(CLAUDE_DIR, 'workflows', 'gsd'), 'workflows → ~/.claude/workflows/gsd/');
+  // Decide install mode once — plugin-system-managed vs npx/manual.
+  // In plugin mode, Claude Code loads commands/agents/workflows/references directly
+  // from ~/.claude/plugins/cache/gsd/gsd/<version>/, so writing user-scope copies at
+  // ~/.claude/{commands,agents,workflows,references}/gsd/ produces duplicate slash-command
+  // entries and silent drift against the plugin cache.
+  const isPluginInstall = isInstalledAsPlugin(CLAUDE_DIR);
 
-  // 4. References
-  copyDir(join(__dirname, 'references'), join(CLAUDE_DIR, 'references', 'gsd'), 'references → ~/.claude/references/gsd/');
+  // 1-4. Commands / agents / workflows / references
+  // Only deliver these user-scope copies in non-plugin installs (npx / manual / npm -g),
+  // where no plugin cache exists to serve them.
+  const userScopeCopies = [
+    ['commands', 'commands → ~/.claude/commands/gsd/'],
+    ['agents', 'agents → ~/.claude/agents/gsd/'],
+    ['workflows', 'workflows → ~/.claude/workflows/gsd/'],
+    ['references', 'references → ~/.claude/references/gsd/'],
+  ];
+  if (isPluginInstall) {
+    // Clean up stale copies left by earlier install.js versions (< 0.7.4) that wrote
+    // user-scope copies unconditionally. Keeping them around caused 2× skill-list
+    // entries and could shadow plugin-cache versions.
+    if (!DRY_RUN) {
+      for (const [sub] of userScopeCopies) {
+        const dest = join(CLAUDE_DIR, sub, 'gsd');
+        if (existsSync(dest)) {
+          rmSync(dest, { recursive: true, force: true });
+          log(`  ✓ Removed legacy user-scope ${sub}/gsd/ (served by plugin cache)`);
+        }
+      }
+    } else {
+      for (const [sub] of userScopeCopies) {
+        const dest = join(CLAUDE_DIR, sub, 'gsd');
+        if (existsSync(dest)) log(`  [dry-run] Would remove legacy ${dest}`);
+      }
+    }
+  } else {
+    for (const [sub, label] of userScopeCopies) {
+      copyDir(join(__dirname, sub), join(CLAUDE_DIR, sub, 'gsd'), label);
+    }
+  }
 
   // 5. Hooks (copy scripts only, skip hooks.json to avoid overwriting other plugins)
   for (const hookFile of HOOK_FILES) {
@@ -213,7 +241,6 @@ export function main() {
   //    When installed as a plugin, the plugin system handles MCP via .mcp.json,
   //    so we skip manual MCP registration to avoid name collisions.
   const settingsPath = join(CLAUDE_DIR, 'settings.json');
-  const isPluginInstall = isInstalledAsPlugin(CLAUDE_DIR);
   if (!DRY_RUN) {
     let settings = {};
     try {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "gsd-lite",
-  "version": "0.7.0",
+  "version": "0.7.4",
   "description": "AI orchestration tool for Claude Code — GSD management shell + Superpowers quality core",
   "type": "module",
   "bin": {
@@ -50,6 +50,10 @@
   "dependencies": {
     "@modelcontextprotocol/sdk": "^1.27.1"
   },
+  "overrides": {
+    "hono": "^4.12.14",
+    "@hono/node-server": "^1.19.14"
+  },
   "devDependencies": {
     "@biomejs/biome": "^2.4.6",
     "c8": "^11.0.0"

package/src/tools/orchestrator/resume.js

@@ -493,8 +493,8 @@ export async function resumeWorkflow({ basePath = process.cwd(), _depth = 0, unb
           success: true,
           action: 'await_manual_intervention',
           workflow_mode: state.workflow_mode,
-          guidance: 'Complete planning and call state-init to initialize the project',
-          message: 'Project is in planning mode; complete the plan and initialize with state-init',
+          guidance: 'Plan is being revised. Run /gsd:start or /gsd:prd to continue planning, or state-update workflow_mode back to executing_task when ready.',
+          message: 'Project is in planning mode (plan revision). Finish the plan then set workflow_mode back to executing_task.',
         };
         break;
       case 'reconcile_workspace': {

package/src/tools/state/crud.js

@@ -156,7 +156,7 @@ export async function init({ project, phases, research, force = false, basePath
 export async function read({ fields, basePath = process.cwd(), validate = false } = {}) {
   const statePath = await getStatePath(basePath);
   if (!statePath) {
-    return { error: true, code: ERROR_CODES.NO_PROJECT_DIR, message: 'No .gsd directory found' };
+    return { error: true, code: ERROR_CODES.NO_PROJECT_DIR, message: 'No GSD project found (.gsd directory missing). Run /gsd:start or /gsd:prd to begin.' };
   }
 
   const result = await readJson(statePath);
@@ -207,7 +207,7 @@ export async function update({ updates, basePath = process.cwd(), expectedVersio
 
   const statePath = await getStatePath(basePath);
   if (!statePath) {
-    return { error: true, code: ERROR_CODES.NO_PROJECT_DIR, message: 'No .gsd directory found' };
+    return { error: true, code: ERROR_CODES.NO_PROJECT_DIR, message: 'No GSD project found (.gsd directory missing). Run /gsd:start or /gsd:prd to begin.' };
   }
   ensureLockPathFromStatePath(statePath);
 
@@ -425,7 +425,7 @@ export async function phaseComplete({
   }
   const statePath = await getStatePath(basePath);
   if (!statePath) {
-    return { error: true, code: ERROR_CODES.NO_PROJECT_DIR, message: 'No .gsd directory found' };
+    return { error: true, code: ERROR_CODES.NO_PROJECT_DIR, message: 'No GSD project found (.gsd directory missing). Run /gsd:start or /gsd:prd to begin.' };
   }
   ensureLockPathFromStatePath(statePath);
 
@@ -612,7 +612,7 @@ export async function addEvidence({ id, data, basePath = process.cwd() }) {
 
   const statePath = await getStatePath(basePath);
   if (!statePath) {
-    return { error: true, code: ERROR_CODES.NO_PROJECT_DIR, message: 'No .gsd directory found' };
+    return { error: true, code: ERROR_CODES.NO_PROJECT_DIR, message: 'No GSD project found (.gsd directory missing). Run /gsd:start or /gsd:prd to begin.' };
   }
   ensureLockPathFromStatePath(statePath);
 
@@ -693,7 +693,7 @@ export async function pruneEvidence({ currentPhase, basePath = process.cwd() })
   }
   const statePath = await getStatePath(basePath);
   if (!statePath) {
-    return { error: true, code: ERROR_CODES.NO_PROJECT_DIR, message: 'No .gsd directory found' };
+    return { error: true, code: ERROR_CODES.NO_PROJECT_DIR, message: 'No GSD project found (.gsd directory missing). Run /gsd:start or /gsd:prd to begin.' };
   }
   ensureLockPathFromStatePath(statePath);
 
@@ -733,7 +733,7 @@ export async function patchPlan({ operations, basePath = process.cwd() } = {}) {
 
   const statePath = await getStatePath(basePath);
   if (!statePath) {
-    return { error: true, code: ERROR_CODES.NO_PROJECT_DIR, message: 'No .gsd directory found' };
+    return { error: true, code: ERROR_CODES.NO_PROJECT_DIR, message: 'No GSD project found (.gsd directory missing). Run /gsd:start or /gsd:prd to begin.' };
   }
   ensureLockPathFromStatePath(statePath);
 

package/src/tools/state/logic.js

@@ -430,7 +430,7 @@ export async function storeResearch({ result, artifacts, decision_index, basePat
 
   const statePath = await getStatePath(basePath);
   if (!statePath) {
-    return { error: true, code: ERROR_CODES.NO_PROJECT_DIR, message: 'No .gsd directory found' };
+    return { error: true, code: ERROR_CODES.NO_PROJECT_DIR, message: 'No GSD project found (.gsd directory missing). Run /gsd:start or /gsd:prd to begin.' };
   }
   ensureLockPathFromStatePath(statePath);