gsd-lite 0.5.14 → 0.5.15

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.14",
+      "version": "0.5.15",
       "keywords": [
         "orchestration",
         "mcp",

package/.claude-plugin/plugin.json

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

package/hooks/gsd-auto-update.cjs

@@ -337,7 +337,7 @@ function validateExtractedPackage(extractDir) {
 // ── Download & Install ─────────────────────────────────────
 async function downloadAndInstall(tarballUrl, verbose = false, token = null) {
   const tmpDir = path.join(os.tmpdir(), `gsd-update-${Date.now()}`);
-  const backupPath = path.join(pluginRoot, 'package.json.bak');
+  const backupPath = path.join(runtimeDir, 'package.json.bak');
   let backedUp = false;
   try {
     fs.mkdirSync(tmpDir, { recursive: true });
@@ -450,6 +450,35 @@ function writeNotification(notification) {
   }
 }
 
+// ── Cache Cleanup ─────────────────────────────────────────
+// Remove old plugin cache versions, keeping the N most recent.
+function pruneOldCacheVersions(cacheBase, keepCount = 3, verbose = false) {
+  try {
+    if (!fs.existsSync(cacheBase)) return;
+    const entries = fs.readdirSync(cacheBase, { withFileTypes: true })
+      .filter(e => e.isDirectory())
+      .map(e => e.name);
+    if (entries.length <= keepCount) return;
+
+    // Sort by semver: split into [major, minor, patch] and compare numerically
+    const sorted = entries.slice().sort((a, b) => {
+      const pa = a.split('.').map(Number);
+      const pb = b.split('.').map(Number);
+      for (let i = 0; i < 3; i++) {
+        if ((pa[i] || 0) !== (pb[i] || 0)) return (pa[i] || 0) - (pb[i] || 0);
+      }
+      return 0;
+    });
+
+    const toRemove = sorted.slice(0, sorted.length - keepCount);
+    for (const ver of toRemove) {
+      const verPath = path.join(cacheBase, ver);
+      fs.rmSync(verPath, { recursive: true, force: true });
+      if (verbose) console.log(`  Pruned old cache: ${ver}`);
+    }
+  } catch { /* best effort */ }
+}
+
 // ── Plugin Cache Sync ─────────────────────────────────────
 // When installed as a plugin, the MCP server runs from plugins/cache/gsd/gsd/<version>/
 // The auto-update installs to ~/.claude/gsd/ (runtime dir) via install.js,
@@ -492,11 +521,17 @@ function syncPluginCache(extractedDir, verbose = false) {
 
     // Install dependencies in cache dir
     if (!fs.existsSync(path.join(newCachePath, 'node_modules', '@modelcontextprotocol'))) {
-      spawnSync('npm', ['install', '--omit=dev', '--ignore-scripts'], {
+      const npmResult = spawnSync('npm', ['install', '--omit=dev', '--ignore-scripts'], {
         cwd: newCachePath,
         stdio: 'pipe',
         timeout: 60000,
       });
+      if (npmResult.status !== 0) {
+        // npm install failed — don't update registry to point to broken cache
+        if (verbose) console.error('  npm install failed in cache dir, aborting cache sync');
+        fs.rmSync(newCachePath, { recursive: true, force: true });
+        return;
+      }
     }
 
     // Update installed_plugins.json to point to new cache path
@@ -507,6 +542,26 @@ function syncPluginCache(extractedDir, verbose = false) {
     fs.writeFileSync(tmpPlugins, JSON.stringify(plugins, null, 2) + '\n');
     fs.renameSync(tmpPlugins, pluginsFile);
 
+    // Update settings.json statusLine if it points to the old cache path
+    try {
+      const settingsPath = path.join(claudeDir, 'settings.json');
+      const settings = JSON.parse(fs.readFileSync(settingsPath, 'utf8'));
+      if (settings.statusLine?.command?.includes('/plugins/cache/gsd/gsd/')) {
+        const oldCmd = settings.statusLine.command;
+        const updated = oldCmd.replace(/\/plugins\/cache\/gsd\/gsd\/[^/]+\//g, `/plugins/cache/gsd/gsd/${newVersion}/`);
+        if (updated !== oldCmd) {
+          settings.statusLine.command = updated;
+          const tmpSettings = settingsPath + `.${process.pid}.tmp`;
+          fs.writeFileSync(tmpSettings, JSON.stringify(settings, null, 2) + '\n');
+          fs.renameSync(tmpSettings, settingsPath);
+          if (verbose) console.log('  StatusLine path updated to new version');
+        }
+      }
+    } catch {}
+
+    // Prune old cache versions — keep only the 3 most recent
+    pruneOldCacheVersions(cacheBase, 3, verbose);
+
     if (verbose) console.log(`  Plugin cache synced to v${newVersion}`);
   } catch (err) {
     // Best effort — don't fail the update if cache sync fails

package/install.js

@@ -1,7 +1,7 @@
 #!/usr/bin/env node
 // Plugin installer for GSD-Lite
 
-import { existsSync, mkdirSync, cpSync, readFileSync, writeFileSync, renameSync, rmSync } from 'node:fs';
+import { existsSync, mkdirSync, cpSync, readFileSync, writeFileSync, renameSync, rmSync, readdirSync } from 'node:fs';
 import { join, dirname } from 'node:path';
 import { homedir } from 'node:os';
 import { fileURLToPath, pathToFileURL } from 'node:url';
@@ -13,12 +13,13 @@ const RUNTIME_DIR = join(CLAUDE_DIR, 'gsd');
 const DRY_RUN = process.argv.includes('--dry-run');
 
 // Single source of truth for hook files (used by copy loop and registration)
-const HOOK_FILES = ['gsd-session-init.cjs', 'gsd-auto-update.cjs', 'gsd-context-monitor.cjs', 'gsd-statusline.cjs'];
+const HOOK_FILES = ['gsd-session-init.cjs', 'gsd-auto-update.cjs', 'gsd-context-monitor.cjs', 'gsd-statusline.cjs', 'gsd-session-stop.cjs'];
 
 // Hook registration config: hookType → { file identifier, matcher, timeout? }
 const HOOK_REGISTRY = [
   { hookType: 'SessionStart', identifier: 'gsd-session-init', matcher: 'startup', timeout: 5 },
   { hookType: 'PostToolUse', identifier: 'gsd-context-monitor', matcher: '*' },
+  { hookType: 'Stop', identifier: 'gsd-session-stop', matcher: '*', timeout: 3 },
 ];
 
 function log(msg) { console.log(msg); }
@@ -135,6 +136,11 @@ export function main() {
   for (const hookFile of HOOK_FILES) {
     copyFile(join(__dirname, 'hooks', hookFile), join(CLAUDE_DIR, 'hooks', hookFile), `hooks/${hookFile}`);
   }
+  // 5b. Hook library dependencies (e.g. gsd-finder.cjs used by statusline + session-init)
+  const hookLibDir = join(__dirname, 'hooks', 'lib');
+  if (existsSync(hookLibDir)) {
+    copyDir(hookLibDir, join(CLAUDE_DIR, 'hooks', 'lib'), 'hooks/lib → ~/.claude/hooks/lib/');
+  }
 
   // 6. Stable runtime for MCP server
   copyDir(join(__dirname, 'src'), join(RUNTIME_DIR, 'src'), 'runtime/src → ~/.claude/gsd/src/');
@@ -186,12 +192,36 @@ export function main() {
     }
 
     // Register statusLine (top-level setting) and hooks
-    if (!settings.hooks) settings.hooks = {};
-    const statuslinePath = join(CLAUDE_DIR, 'hooks', 'gsd-statusline.cjs');
-    const statusLineRegistered = registerStatusLine(settings, statuslinePath);
+    // When installed as a plugin, hooks are managed by hooks.json via the plugin system.
+    // Only register in settings.json for manual installs to avoid double execution.
+    let statusLineRegistered = false;
     let hooksRegistered = false;
-    for (const config of HOOK_REGISTRY) {
-      if (registerHookEntry(settings.hooks, config)) hooksRegistered = true;
+    if (!isPluginInstall) {
+      if (!settings.hooks) settings.hooks = {};
+      const statuslinePath = join(CLAUDE_DIR, 'hooks', 'gsd-statusline.cjs');
+      statusLineRegistered = registerStatusLine(settings, statuslinePath);
+      for (const config of HOOK_REGISTRY) {
+        if (registerHookEntry(settings.hooks, config)) hooksRegistered = true;
+      }
+    } else {
+      // Clean up stale manual hook entries left from previous install.js runs
+      if (settings.hooks) {
+        let cleaned = false;
+        for (const [hookType, identifier] of [
+          ['PostToolUse', 'gsd-context-monitor'],
+          ['SessionStart', 'gsd-session-init'],
+          ['Stop', 'gsd-session-stop'],
+        ]) {
+          if (Array.isArray(settings.hooks[hookType])) {
+            const before = settings.hooks[hookType].length;
+            settings.hooks[hookType] = settings.hooks[hookType].filter(e =>
+              !e.hooks?.some(h => h.command?.includes(identifier)));
+            if (settings.hooks[hookType].length < before) cleaned = true;
+            if (settings.hooks[hookType].length === 0) delete settings.hooks[hookType];
+          }
+        }
+        if (cleaned) log('  ✓ Removed stale manual hook entries (plugin hooks.json handles registration)');
+      }
     }
 
     const tmpSettings = settingsPath + `.${process.pid}-${Date.now()}.tmp`;
@@ -204,6 +234,32 @@ export function main() {
     log('  [dry-run] Would register MCP server in settings.json');
   }
 
+  // 9. Prune old plugin cache versions (keep latest 3)
+  if (!DRY_RUN && isPluginInstall) {
+    const cacheBase = join(CLAUDE_DIR, 'plugins', 'cache', 'gsd', 'gsd');
+    if (existsSync(cacheBase)) {
+      try {
+        const entries = readdirSync(cacheBase, { withFileTypes: true })
+          .filter(e => e.isDirectory()).map(e => e.name);
+        if (entries.length > 3) {
+          const sorted = entries.slice().sort((a, b) => {
+            const pa = a.split('.').map(Number);
+            const pb = b.split('.').map(Number);
+            for (let i = 0; i < 3; i++) {
+              if ((pa[i] || 0) !== (pb[i] || 0)) return (pa[i] || 0) - (pb[i] || 0);
+            }
+            return 0;
+          });
+          const toRemove = sorted.slice(0, sorted.length - 3);
+          for (const ver of toRemove) {
+            rmSync(join(cacheBase, ver), { recursive: true, force: true });
+          }
+          log(`  ✓ Pruned ${toRemove.length} old cache version(s), kept latest 3`);
+        }
+      } catch { /* best effort */ }
+    }
+  }
+
   log('\n✓ GSD-Lite installed successfully!');
   log('  Use /gsd:start to begin a new project');
   log('  Use /gsd:resume to continue an existing project');

package/package.json

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

package/src/tools/orchestrator/executor.js

@@ -30,6 +30,16 @@ export async function handleExecutorResult({ result, basePath = process.cwd() }
     return { error: true, message: `Task ${result.task_id} not found` };
   }
 
+  // Auto-start parallel tasks: if a task is still pending (dispatched via parallel_available
+  // but not explicitly started by orchestrator-resume), transition it to running first.
+  if (task.lifecycle === 'pending') {
+    const startError = await persist(basePath, {
+      phases: [{ id: phase.id, todo: [{ id: task.id, lifecycle: 'running' }] }],
+    });
+    if (startError) return startError;
+    task.lifecycle = 'running';
+  }
+
   // Build new decision entries — actual append happens atomically inside update()'s lock
   const newDecisions = buildDecisionEntries(result.decisions, phase.id, task.id, (state.decisions || []).length);
 

package/uninstall.js

@@ -38,13 +38,23 @@ export function main() {
   removeDir(join(CLAUDE_DIR, 'gsd-lite'), 'legacy gsd-lite runtime/');
 
   // Remove hook files (both legacy and current names)
-  for (const name of ['context-monitor.js', 'gsd-statusline.cjs', 'gsd-context-monitor.cjs', 'gsd-session-init.cjs', 'gsd-auto-update.cjs']) {
+  for (const name of ['context-monitor.js', 'gsd-statusline.cjs', 'gsd-context-monitor.cjs', 'gsd-session-init.cjs', 'gsd-auto-update.cjs', 'gsd-session-stop.cjs']) {
     const hookFile = join(CLAUDE_DIR, 'hooks', name);
     if (existsSync(hookFile)) {
       rmSync(hookFile);
       log(`  ✓ Removed hooks/${name}`);
     }
   }
+  // Remove hook library dependencies
+  const hookLibDir = join(CLAUDE_DIR, 'hooks', 'lib');
+  if (existsSync(hookLibDir)) {
+    // Only remove GSD-owned files, not other plugins' libs
+    const gsdLibFile = join(hookLibDir, 'gsd-finder.cjs');
+    if (existsSync(gsdLibFile)) {
+      rmSync(gsdLibFile);
+      log('  ✓ Removed hooks/lib/gsd-finder.cjs');
+    }
+  }
 
   // Clean up plugin system directories (from /plugin install)
   removeDir(join(CLAUDE_DIR, 'plugins', 'marketplaces', 'gsd'), 'plugins/marketplaces/gsd/');
@@ -123,6 +133,7 @@ export function main() {
         ['PostToolUse', 'gsd-context-monitor'],
         ['PostToolUse', 'context-monitor.js'],
         ['SessionStart', 'gsd-session-init'],
+        ['Stop', 'gsd-session-stop'],
       ]) {
         if (Array.isArray(settings.hooks[hookType])) {
           const len = settings.hooks[hookType].length;