gsd-lite 0.5.0 → 0.5.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.5.0",
+      "version": "0.5.3",
       "keywords": [
         "orchestration",
         "mcp",

package/.claude-plugin/plugin.json

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

package/commands/doctor.md

@@ -19,7 +19,7 @@ Check if `.gsd/state.json` exists:
 
 ## STEP 2: MCP Server Health
 
-Call the `gsd health` MCP tool:
+Call the `health` MCP tool:
 - If returns `status: "ok"`: record PASS with server version
 - If returns error or unreachable: record FAIL with error message
 - Note: if MCP server is not available at all (tool not found), record FAIL "MCP server not registered"
@@ -51,7 +51,7 @@ Check if `.gsd/.state-lock` exists:
 
 Check for update-related information:
 - Read `~/.claude/gsd/package.json` for installed version
-- Compare with the version from `gsd health` tool response
+- Compare with the version from `health` tool response
 - If versions match: record PASS with version number
 - If mismatch: record WARN "Version mismatch: installed={x}, server={y}"
 - If `~/.claude/gsd/.update-pending` exists: record INFO "Update pending, will apply on next session"

package/commands/start.md

@@ -10,6 +10,15 @@ argument-hint: Optional feature or project description
 
 <process>
 
+## STEP 0 — 已有项目检测
+
+调用 `health` 工具（MCP tool 名称: health）。如果返回 state_exists=true:
+- 告知用户: "检测到进行中的 GSD 项目。"
+- 提供选项:
+  - (a) 恢复执行 → 转到 `/gsd:resume`
+  - (b) 重新开始 → 继续 STEP 1（现有 state.json 将被覆盖）
+- 等待用户选择后再继续
+
 ## STEP 1 — 语言检测
 
 用户输入语言 = 后续所有输出语言。不需要读 CLAUDE.md 来判断语言。

package/hooks/gsd-session-init.cjs

@@ -66,7 +66,38 @@ setTimeout(() => process.exit(0), 4000).unref();
     }
   } catch { /* silent */ }
 
-  // ── Phase 3: Show notification from previous background auto-install ──
+  // ── Phase 3: Self-heal .mcp.json in plugin directories ──
+  // If .mcp.json is missing (e.g. git operations deleted it), regenerate it
+  // so the plugin system can register the GSD MCP server.
+  try {
+    const pluginsPath = path.join(claudeDir, 'plugins', 'installed_plugins.json');
+    if (fs.existsSync(pluginsPath)) {
+      const plugins = JSON.parse(fs.readFileSync(pluginsPath, 'utf8'));
+      const gsdEntry = plugins.plugins?.['gsd@gsd']?.[0];
+      if (gsdEntry) {
+        const mcpContent = JSON.stringify({
+          mcpServers: {
+            gsd: { command: 'node', args: ['${CLAUDE_PLUGIN_ROOT}/launcher.js'] },
+          },
+        }, null, 2) + '\n';
+        // Check marketplace dir
+        const marketplaceDir = path.join(claudeDir, 'plugins', 'marketplaces', 'gsd');
+        const marketplaceMcp = path.join(marketplaceDir, '.mcp.json');
+        if (fs.existsSync(marketplaceDir) && !fs.existsSync(marketplaceMcp)) {
+          fs.writeFileSync(marketplaceMcp, mcpContent);
+        }
+        // Check plugin cache dir
+        if (gsdEntry.installPath) {
+          const cacheMcp = path.join(gsdEntry.installPath, '.mcp.json');
+          if (fs.existsSync(gsdEntry.installPath) && !fs.existsSync(cacheMcp)) {
+            fs.writeFileSync(cacheMcp, mcpContent);
+          }
+        }
+      }
+    }
+  } catch { /* silent */ }
+
+  // ── Phase 4: Show notification from previous background auto-update ──
   try {
     const notifPath = path.join(claudeDir, 'gsd', 'runtime', 'update-notification.json');
     if (fs.existsSync(notifPath)) {
@@ -82,7 +113,7 @@ setTimeout(() => process.exit(0), 4000).unref();
     }
   } catch { /* silent */ }
 
-  // ── Phase 4: Spawn background auto-update (non-blocking) ──
+  // ── Phase 5: Spawn background auto-update (non-blocking) ──
   // Detached child handles check + download + install; throttled by shouldCheck()
   try {
     const { spawn } = require('node:child_process');

package/hooks/gsd-statusline.cjs

@@ -49,7 +49,10 @@ process.stdin.on('end', () => {
       if (state.current_task && state.current_phase) {
         const phase = (state.phases || []).find(p => p.id === state.current_phase);
         const t = phase?.todo?.find(t => t.id === state.current_task);
-        if (t) task = `${t.id} ${t.name}`;
+        if (t) {
+          const name = t.name.length > 40 ? t.name.substring(0, 40) + '...' : t.name;
+          task = `${t.id} ${name}`;
+        }
       }
     } catch {
       // No state.json or parse error — skip task display
@@ -57,10 +60,11 @@ process.stdin.on('end', () => {
 
     // Context window display (USED percentage scaled to usable context)
     // Claude Code reserves ~16.5% for autocompact buffer (configurable via env)
-    const AUTO_COMPACT_BUFFER_PCT = Number(process.env.GSD_AUTOCOMPACT_BUFFER) || 16.5;
+    const AUTO_COMPACT_BUFFER_PCT = Math.min(99, Math.max(0, Number(process.env.GSD_AUTOCOMPACT_BUFFER) || 16.5));
     let ctx = '';
     if (remaining != null) {
-      const usableRemaining = Math.max(0, ((remaining - AUTO_COMPACT_BUFFER_PCT) / (100 - AUTO_COMPACT_BUFFER_PCT)) * 100);
+      const divisor = 100 - AUTO_COMPACT_BUFFER_PCT;
+      const usableRemaining = divisor > 0 ? Math.max(0, ((remaining - AUTO_COMPACT_BUFFER_PCT) / divisor) * 100) : 0;
       const used = Math.max(0, Math.min(100, Math.round(100 - usableRemaining)));
 
       // Write bridge file for context-monitor PostToolUse hook (skip if remaining unchanged)

package/install.js

@@ -23,6 +23,16 @@ const HOOK_REGISTRY = [
 
 function log(msg) { console.log(msg); }
 
+function isInstalledAsPlugin(claudeDir) {
+  try {
+    const pluginsPath = join(claudeDir, 'plugins', 'installed_plugins.json');
+    const data = JSON.parse(readFileSync(pluginsPath, 'utf-8'));
+    return !!data.plugins?.['gsd@gsd'];
+  } catch {
+    return false;
+  }
+}
+
 function registerStatusLine(settings, statuslineScriptPath) {
   const command = `node ${JSON.stringify(statuslineScriptPath)}`;
   // Don't overwrite non-GSD statusLine
@@ -142,8 +152,11 @@ export function main() {
     log('  [dry-run] Would install runtime dependencies');
   }
 
-  // 8. Register MCP server in settings.json
+  // 8. Register MCP server + hooks in settings.json
+  //    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 {
@@ -157,10 +170,20 @@ export function main() {
     if (!settings.mcpServers) settings.mcpServers = {};
     // Remove legacy "gsd-lite" server entry from older versions
     delete settings.mcpServers['gsd-lite'];
-    settings.mcpServers.gsd = {
-      command: 'node',
-      args: [join(RUNTIME_DIR, 'src', 'server.js')],
-    };
+
+    if (isPluginInstall) {
+      // Plugin system handles MCP via .mcp.json — remove stale manual entry
+      if (settings.mcpServers.gsd) {
+        delete settings.mcpServers.gsd;
+        log('  ✓ Removed manual MCP entry (plugin .mcp.json handles registration)');
+      }
+    } else {
+      settings.mcpServers.gsd = {
+        command: 'node',
+        args: [join(RUNTIME_DIR, 'src', 'server.js')],
+      };
+      log('  ✓ MCP server registered in settings.json');
+    }
 
     // Register statusLine (top-level setting) and hooks
     if (!settings.hooks) settings.hooks = {};
@@ -174,7 +197,6 @@ export function main() {
     const tmpSettings = settingsPath + `.${process.pid}-${Date.now()}.tmp`;
     writeFileSync(tmpSettings, JSON.stringify(settings, null, 2) + '\n');
     renameSync(tmpSettings, settingsPath);
-    log('  ✓ MCP server registered in settings.json');
     if (statusLineRegistered || hooksRegistered) {
       log('  ✓ GSD-Lite hooks registered in settings.json');
     }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "gsd-lite",
-  "version": "0.5.0",
+  "version": "0.5.3",
   "description": "AI orchestration tool for Claude Code — GSD management shell + Superpowers quality core",
   "type": "module",
   "bin": {

package/src/schema.js

@@ -98,8 +98,12 @@ export function validateResearchDecisionIndex(decisionIndex, requiredIds = []) {
     if ('source' in entry && (typeof entry.source !== 'string' || entry.source.length === 0)) {
       errors.push(`decision_index.${id}.source must be a non-empty string`);
     }
-    if ('expires_at' in entry && (typeof entry.expires_at !== 'string' || entry.expires_at.length === 0)) {
-      errors.push(`decision_index.${id}.expires_at must be a non-empty string`);
+    if ('expires_at' in entry) {
+      if (typeof entry.expires_at !== 'string' || entry.expires_at.length === 0) {
+        errors.push(`decision_index.${id}.expires_at must be a non-empty string`);
+      } else if (Number.isNaN(Date.parse(entry.expires_at))) {
+        errors.push(`decision_index.${id}.expires_at must be a valid ISO 8601 date (got "${entry.expires_at}")`);
+      }
     }
   }
 
@@ -169,6 +173,12 @@ export function validateStateUpdate(state, updates) {
         if (updates.current_review !== null && !isPlainObject(updates.current_review)) {
           errors.push('current_review must be an object or null');
         }
+        if (isPlainObject(updates.current_review) && 'scope' in updates.current_review) {
+          const validScopes = ['task', 'phase'];
+          if (!validScopes.includes(updates.current_review.scope)) {
+            errors.push(`current_review.scope must be one of: ${validScopes.join(', ')} (got "${updates.current_review.scope}")`);
+          }
+        }
         break;
       case 'git_head':
         if (updates.git_head !== null && typeof updates.git_head !== 'string') {
@@ -306,9 +316,12 @@ export function validateState(state) {
     if ('volatility' in state.research && !['low', 'medium', 'high'].includes(state.research.volatility)) {
       errors.push('research.volatility must be low|medium|high');
     }
-    if ('expires_at' in state.research
-      && (typeof state.research.expires_at !== 'string' || state.research.expires_at.length === 0)) {
-      errors.push('research.expires_at must be a non-empty string');
+    if ('expires_at' in state.research) {
+      if (typeof state.research.expires_at !== 'string' || state.research.expires_at.length === 0) {
+        errors.push('research.expires_at must be a non-empty string');
+      } else if (Number.isNaN(Date.parse(state.research.expires_at))) {
+        errors.push(`research.expires_at must be a valid ISO 8601 date (got "${state.research.expires_at}")`);
+      }
     }
     if ('files' in state.research && !Array.isArray(state.research.files)) {
       errors.push('research.files must be an array');
@@ -335,6 +348,12 @@ export function validateState(state) {
   if (state.current_review !== null && !isPlainObject(state.current_review)) {
     errors.push('current_review must be an object or null');
   }
+  if (isPlainObject(state.current_review) && 'scope' in state.current_review) {
+    const validScopes = ['task', 'phase'];
+    if (!validScopes.includes(state.current_review.scope)) {
+      errors.push(`current_review.scope must be one of: ${validScopes.join(', ')} (got "${state.current_review.scope}")`);
+    }
+  }
   if (!isPlainObject(state.evidence)) {
     errors.push('evidence must be an object');
   } else {
@@ -669,6 +688,33 @@ export function createInitialState({ project, phases }) {
     }
   }
 
+  // Validate requires references: must be structured objects with valid targets
+  for (const [pi, p] of phases.entries()) {
+    for (const [ti, t] of (p.tasks || []).entries()) {
+      const taskId = `${pi + 1}.${t.index ?? (ti + 1)}`;
+      for (const dep of (t.requires || [])) {
+        if (typeof dep === 'string') {
+          return { error: true, message: `Task ${taskId}: requires entry "${dep}" must be an object {kind: "task"|"phase", id: "..."}, not a string` };
+        }
+        if (!isPlainObject(dep) || !dep.kind || !dep.id) {
+          return { error: true, message: `Task ${taskId}: requires entries must be objects with kind ("task"|"phase") and id` };
+        }
+        if (!['task', 'phase'].includes(dep.kind)) {
+          return { error: true, message: `Task ${taskId}: requires entry kind must be "task" or "phase" (got "${dep.kind}")` };
+        }
+        if (dep.kind === 'task' && !seenIds.has(String(dep.id))) {
+          return { error: true, message: `Task ${taskId}: requires references non-existent task "${dep.id}" (valid IDs: ${[...seenIds].join(', ')})` };
+        }
+        if (dep.kind === 'phase') {
+          const phaseId = Number(dep.id);
+          if (!Number.isFinite(phaseId) || phaseId < 1 || phaseId > phases.length) {
+            return { error: true, message: `Task ${taskId}: requires references non-existent phase "${dep.id}" (valid: 1-${phases.length})` };
+          }
+        }
+      }
+    }
+  }
+
   // M-7: Detect circular dependencies within each phase (Kahn's algorithm)
   for (const [pi, p] of phases.entries()) {
     const tasks = p.tasks || [];

package/src/server.js

@@ -52,7 +52,7 @@ const TOOLS = [
                     name: { type: 'string', description: 'Task name (required)' },
                     index: { type: 'number', description: 'Task index within phase (default: auto)' },
                     level: { type: 'string', description: 'Complexity level: L0/L1/L2/L3 (default: L1)' },
-                    requires: { type: 'array', description: 'Dependency list (default: [])' },
+                    requires: { type: 'array', description: 'Dependencies: [{kind: "task"|"phase", id: "1.1", gate?: "checkpoint"|"accepted"|"phase_complete"}] (default: [])' },
                     review_required: { type: 'boolean', description: 'Whether review is needed (default: true)' },
                     verification_required: { type: 'boolean', description: 'Whether verification is needed (default: true)' },
                   },
@@ -105,7 +105,7 @@ const TOOLS = [
         phase_id: { type: 'number', description: 'Phase number to complete' },
         verification: {
           type: 'object',
-          description: 'Optional precomputed verification result object with lint/typecheck/test exit codes',
+          description: 'Optional precomputed verification: {lint: {exit_code: number}, typecheck: {exit_code: number}, test: {exit_code: number}} — all three keys required, exit_code 0 = passed',
         },
         run_verify: {
           type: 'boolean',
@@ -133,7 +133,10 @@ const TOOLS = [
     inputSchema: {
       type: 'object',
       properties: {
-        result: { type: 'object', description: 'Executor result payload' },
+        result: {
+          type: 'object',
+          description: 'Executor result: {task_id: string, outcome: "checkpointed"|"blocked"|"failed", summary: string, checkpoint_commit: string|null, files_changed: string[], decisions: string[], blockers: object[], contract_changed: boolean, evidence: object[]}',
+        },
       },
       required: ['result'],
     },
@@ -144,7 +147,10 @@ const TOOLS = [
     inputSchema: {
       type: 'object',
       properties: {
-        result: { type: 'object', description: 'Debugger result payload' },
+        result: {
+          type: 'object',
+          description: 'Debugger result: {task_id: string, outcome: "root_cause_found"|"fix_suggested"|"failed", root_cause: string, evidence: object[], hypothesis_tested: [{hypothesis: string, result: "confirmed"|"rejected", evidence: string}], fix_direction: string, fix_attempts: integer, blockers: object[], architecture_concern: boolean}',
+        },
       },
       required: ['result'],
     },
@@ -155,9 +161,12 @@ const TOOLS = [
     inputSchema: {
       type: 'object',
       properties: {
-        result: { type: 'object', description: 'Researcher result payload' },
-        decision_index: { type: 'object', description: 'Decision index keyed by decision id' },
-        artifacts: { type: 'object', description: 'Markdown artifact contents keyed by file name' },
+        result: {
+          type: 'object',
+          description: 'Researcher result: {decision_ids: string[], volatility: "low"|"medium"|"high", expires_at: ISO8601 string, sources: [{id: string, type: string, ref: string}]}',
+        },
+        decision_index: { type: 'object', description: 'Decision index keyed by decision id, each value: {summary: string, source?: string, expires_at?: ISO8601}' },
+        artifacts: { type: 'object', description: 'Markdown contents keyed by filename: {STACK.md, ARCHITECTURE.md, PITFALLS.md, SUMMARY.md}' },
       },
       required: ['result', 'decision_index', 'artifacts'],
     },
@@ -168,7 +177,10 @@ const TOOLS = [
     inputSchema: {
       type: 'object',
       properties: {
-        result: { type: 'object', description: 'Reviewer result payload' },
+        result: {
+          type: 'object',
+          description: 'Reviewer result: {scope: "task"|"phase", scope_id: string|number, review_level: "L2"|"L1-batch", spec_passed: boolean, quality_passed: boolean, critical_issues: object[], important_issues: object[], minor_issues: object[], accepted_tasks: string[], rework_tasks: string[], evidence: object[]}',
+        },
       },
       required: ['result'],
     },