gsd-lite 0.7.0 → 0.7.3

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.3",
       "keywords": [
         "orchestration",
         "mcp",

package/.claude-plugin/plugin.json

@@ -1,6 +1,6 @@
 {
   "name": "gsd",
-  "version": "0.7.0",
+  "version": "0.7.3",
   "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/package.json

@@ -1,6 +1,6 @@
 {
   "name": "gsd-lite",
-  "version": "0.7.0",
+  "version": "0.7.3",
   "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);