pi-gsd 2.0.22 → 2.0.23

package/.gsd/harnesses/pi/hooks/gsd-context-monitor.js

@@ -39,121 +39,121 @@ const stdinTimeout = setTimeout(() => process.exit(0), 10000);
 process.stdin.setEncoding('utf8');
 process.stdin.on('data', chunk => input += chunk);
 process.stdin.on('end', () => {
-  clearTimeout(stdinTimeout);
-  try {
-    const data = JSON.parse(input);
-    const sessionId = data.session_id;
+    clearTimeout(stdinTimeout);
+    try {
+        const data = JSON.parse(input);
+        const sessionId = data.session_id;
 
-    if (!sessionId) {
-      process.exit(0);
-    }
+        if (!sessionId) {
+            process.exit(0);
+        }
 
-    // Check if context warnings are disabled via config
-    const cwd = data.cwd || process.cwd();
-    const configPath = path.join(cwd, '.planning', 'config.json');
-    if (fs.existsSync(configPath)) {
-      try {
-        const config = JSON.parse(fs.readFileSync(configPath, 'utf8'));
-        if (config.hooks?.context_warnings === false) {
-          process.exit(0);
+        // Check if context warnings are disabled via config
+        const cwd = data.cwd || process.cwd();
+        const configPath = path.join(cwd, '.planning', 'config.json');
+        if (fs.existsSync(configPath)) {
+            try {
+                const config = JSON.parse(fs.readFileSync(configPath, 'utf8'));
+                if (config.hooks?.context_warnings === false) {
+                    process.exit(0);
+                }
+            } catch (e) {
+                // Ignore config parse errors
+            }
         }
-      } catch (e) {
-        // Ignore config parse errors
-      }
-    }
 
-    const tmpDir = os.tmpdir();
-    const metricsPath = path.join(tmpDir, `claude-ctx-${sessionId}.json`);
+        const tmpDir = os.tmpdir();
+        const metricsPath = path.join(tmpDir, `claude-ctx-${sessionId}.json`);
 
-    // If no metrics file, this is a subagent or fresh session -- exit silently
-    if (!fs.existsSync(metricsPath)) {
-      process.exit(0);
-    }
+        // If no metrics file, this is a subagent or fresh session -- exit silently
+        if (!fs.existsSync(metricsPath)) {
+            process.exit(0);
+        }
 
-    const metrics = JSON.parse(fs.readFileSync(metricsPath, 'utf8'));
-    const now = Math.floor(Date.now() / 1000);
+        const metrics = JSON.parse(fs.readFileSync(metricsPath, 'utf8'));
+        const now = Math.floor(Date.now() / 1000);
 
-    // Ignore stale metrics
-    if (metrics.timestamp && (now - metrics.timestamp) > STALE_SECONDS) {
-      process.exit(0);
-    }
+        // Ignore stale metrics
+        if (metrics.timestamp && (now - metrics.timestamp) > STALE_SECONDS) {
+            process.exit(0);
+        }
 
-    const remaining = metrics.remaining_percentage;
-    const usedPct = metrics.used_pct;
+        const remaining = metrics.remaining_percentage;
+        const usedPct = metrics.used_pct;
 
-    // No warning needed
-    if (remaining > WARNING_THRESHOLD) {
-      process.exit(0);
-    }
+        // No warning needed
+        if (remaining > WARNING_THRESHOLD) {
+            process.exit(0);
+        }
 
-    // Debounce: check if we warned recently
-    const warnPath = path.join(tmpDir, `claude-ctx-${sessionId}-warned.json`);
-    let warnData = { callsSinceWarn: 0, lastLevel: null };
-    let firstWarn = true;
-
-    if (fs.existsSync(warnPath)) {
-      try {
-        warnData = JSON.parse(fs.readFileSync(warnPath, 'utf8'));
-        firstWarn = false;
-      } catch (e) {
-        // Corrupted file, reset
-      }
-    }
+        // Debounce: check if we warned recently
+        const warnPath = path.join(tmpDir, `claude-ctx-${sessionId}-warned.json`);
+        let warnData = { callsSinceWarn: 0, lastLevel: null };
+        let firstWarn = true;
+
+        if (fs.existsSync(warnPath)) {
+            try {
+                warnData = JSON.parse(fs.readFileSync(warnPath, 'utf8'));
+                firstWarn = false;
+            } catch (e) {
+                // Corrupted file, reset
+            }
+        }
 
-    warnData.callsSinceWarn = (warnData.callsSinceWarn || 0) + 1;
+        warnData.callsSinceWarn = (warnData.callsSinceWarn || 0) + 1;
 
-    const isCritical = remaining <= CRITICAL_THRESHOLD;
-    const currentLevel = isCritical ? 'critical' : 'warning';
+        const isCritical = remaining <= CRITICAL_THRESHOLD;
+        const currentLevel = isCritical ? 'critical' : 'warning';
 
-    // Emit immediately on first warning, then debounce subsequent ones
-    // Severity escalation (WARNING -> CRITICAL) bypasses debounce
-    const severityEscalated = currentLevel === 'critical' && warnData.lastLevel === 'warning';
-    if (!firstWarn && warnData.callsSinceWarn < DEBOUNCE_CALLS && !severityEscalated) {
-      // Update counter and exit without warning
-      fs.writeFileSync(warnPath, JSON.stringify(warnData));
-      process.exit(0);
-    }
+        // Emit immediately on first warning, then debounce subsequent ones
+        // Severity escalation (WARNING -> CRITICAL) bypasses debounce
+        const severityEscalated = currentLevel === 'critical' && warnData.lastLevel === 'warning';
+        if (!firstWarn && warnData.callsSinceWarn < DEBOUNCE_CALLS && !severityEscalated) {
+            // Update counter and exit without warning
+            fs.writeFileSync(warnPath, JSON.stringify(warnData));
+            process.exit(0);
+        }
 
-    // Reset debounce counter
-    warnData.callsSinceWarn = 0;
-    warnData.lastLevel = currentLevel;
-    fs.writeFileSync(warnPath, JSON.stringify(warnData));
-
-    // Detect if GSD is active (has .planning/STATE.md in working directory)
-    const isGsdActive = fs.existsSync(path.join(cwd, '.planning', 'STATE.md'));
-
-    // Build advisory warning message (never use imperative commands that
-    // override user preferences - see #884)
-    let message;
-    if (isCritical) {
-      message = isGsdActive
-        ? `CONTEXT CRITICAL: Usage at ${usedPct}%. Remaining: ${remaining}%. ` +
-          'Context is nearly exhausted. Do NOT start new complex work or write handoff files - ' +
-          'GSD state is already tracked in STATE.md. Inform the user so they can run ' +
-          '/gsd:pause-work at the next natural stopping point.'
-        : `CONTEXT CRITICAL: Usage at ${usedPct}%. Remaining: ${remaining}%. ` +
-          'Context is nearly exhausted. Inform the user that context is low and ask how they ' +
-          'want to proceed. Do NOT autonomously save state or write handoff files unless the user asks.';
-    } else {
-      message = isGsdActive
-        ? `CONTEXT WARNING: Usage at ${usedPct}%. Remaining: ${remaining}%. ` +
-          'Context is getting limited. Avoid starting new complex work. If not between ' +
-          'defined plan steps, inform the user so they can prepare to pause.'
-        : `CONTEXT WARNING: Usage at ${usedPct}%. Remaining: ${remaining}%. ` +
-          'Be aware that context is getting limited. Avoid unnecessary exploration or ' +
-          'starting new complex work.';
-    }
+        // Reset debounce counter
+        warnData.callsSinceWarn = 0;
+        warnData.lastLevel = currentLevel;
+        fs.writeFileSync(warnPath, JSON.stringify(warnData));
+
+        // Detect if GSD is active (has .planning/STATE.md in working directory)
+        const isGsdActive = fs.existsSync(path.join(cwd, '.planning', 'STATE.md'));
+
+        // Build advisory warning message (never use imperative commands that
+        // override user preferences - see #884)
+        let message;
+        if (isCritical) {
+            message = isGsdActive
+                ? `CONTEXT CRITICAL: Usage at ${usedPct}%. Remaining: ${remaining}%. ` +
+                'Context is nearly exhausted. Do NOT start new complex work or write handoff files - ' +
+                'GSD state is already tracked in STATE.md. Inform the user so they can run ' +
+                '/gsd-pause-work at the next natural stopping point.'
+                : `CONTEXT CRITICAL: Usage at ${usedPct}%. Remaining: ${remaining}%. ` +
+                'Context is nearly exhausted. Inform the user that context is low and ask how they ' +
+                'want to proceed. Do NOT autonomously save state or write handoff files unless the user asks.';
+        } else {
+            message = isGsdActive
+                ? `CONTEXT WARNING: Usage at ${usedPct}%. Remaining: ${remaining}%. ` +
+                'Context is getting limited. Avoid starting new complex work. If not between ' +
+                'defined plan steps, inform the user so they can prepare to pause.'
+                : `CONTEXT WARNING: Usage at ${usedPct}%. Remaining: ${remaining}%. ` +
+                'Be aware that context is getting limited. Avoid unnecessary exploration or ' +
+                'starting new complex work.';
+        }
 
-    const output = {
-      hookSpecificOutput: {
-        hookEventName: process.env.GEMINI_API_KEY ? "AfterTool" : "PostToolUse",
-        additionalContext: message
-      }
-    };
-
-    process.stdout.write(JSON.stringify(output));
-  } catch (e) {
-    // Silent fail -- never block tool execution
-    process.exit(0);
-  }
+        const output = {
+            hookSpecificOutput: {
+                hookEventName: process.env.GEMINI_API_KEY ? "AfterTool" : "PostToolUse",
+                additionalContext: message
+            }
+        };
+
+        process.stdout.write(JSON.stringify(output));
+    } catch (e) {
+        // Silent fail -- never block tool execution
+        process.exit(0);
+    }
 });

package/.gsd/harnesses/pi/hooks/gsd-statusline.js

@@ -105,10 +105,10 @@ process.stdin.on('end', () => {
             try {
                 const cache = JSON.parse(fs.readFileSync(cacheFile, 'utf8'));
                 if (cache.update_available) {
-                    gsdUpdate = '\x1b[33m⬆ /gsd:update\x1b[0m │ ';
+                    gsdUpdate = '\x1b[33m⬆ /gsd-update\x1b[0m │ ';
                 }
                 if (cache.stale_hooks && cache.stale_hooks.length > 0) {
-                    gsdUpdate += '\x1b[31m⚠ stale hooks - run /gsd:update\x1b[0m │ ';
+                    gsdUpdate += '\x1b[31m⚠ stale hooks - run /gsd-update\x1b[0m │ ';
                 }
             } catch (e) { }
         }

package/.gsd/harnesses/pi/hooks/gsd-workflow-guard.js

@@ -5,10 +5,10 @@
 // Do NOT hardcode harness-specific paths here. See HOOKS_ARCHITECTURE.md.
 // GSD Workflow Guard - PreToolUse hook
 // Detects when Claude attempts file edits outside a GSD workflow context
-// (no active /gsd: command or Task subagent) and injects an advisory warning.
+// (no active /gsd- command or Task subagent) and injects an advisory warning.
 //
 // This is a SOFT guard - it advises, not blocks. The edit still proceeds.
-// The warning nudges Claude to use /gsd:quick or /gsd:fast instead of
+// The warning nudges Claude to use /gsd-quick or /gsd-fast instead of
 // making direct edits that bypass state tracking.
 //
 // Enable via config: hooks.workflow_guard: true (default: false)
@@ -22,76 +22,76 @@ const stdinTimeout = setTimeout(() => process.exit(0), 3000);
 process.stdin.setEncoding('utf8');
 process.stdin.on('data', chunk => input += chunk);
 process.stdin.on('end', () => {
-  clearTimeout(stdinTimeout);
-  try {
-    const data = JSON.parse(input);
-    const toolName = data.tool_name;
+    clearTimeout(stdinTimeout);
+    try {
+        const data = JSON.parse(input);
+        const toolName = data.tool_name;
 
-    // Only guard Write and Edit tool calls
-    if (toolName !== 'Write' && toolName !== 'Edit') {
-      process.exit(0);
-    }
+        // Only guard Write and Edit tool calls
+        if (toolName !== 'Write' && toolName !== 'Edit') {
+            process.exit(0);
+        }
 
-    // Check if we're inside a GSD workflow (Task subagent or /gsd: command)
-    // Subagents have a session_id that differs from the parent
-    // and typically have a description field set by the orchestrator
-    if (data.tool_input?.is_subagent || data.session_type === 'task') {
-      process.exit(0);
-    }
+        // Check if we're inside a GSD workflow (Task subagent or /gsd- command)
+        // Subagents have a session_id that differs from the parent
+        // and typically have a description field set by the orchestrator
+        if (data.tool_input?.is_subagent || data.session_type === 'task') {
+            process.exit(0);
+        }
 
-    // Check the file being edited
-    const filePath = data.tool_input?.file_path || data.tool_input?.path || '';
+        // Check the file being edited
+        const filePath = data.tool_input?.file_path || data.tool_input?.path || '';
 
-    // Allow edits to .planning/ files (GSD state management)
-    if (filePath.includes('.planning/') || filePath.includes('.planning\\')) {
-      process.exit(0);
-    }
+        // Allow edits to .planning/ files (GSD state management)
+        if (filePath.includes('.planning/') || filePath.includes('.planning\\')) {
+            process.exit(0);
+        }
 
-    // Allow edits to common config/docs files that don't need GSD tracking
-    const allowedPatterns = [
-      /\.gitignore$/,
-      /\.env/,
-      /CLAUDE\.md$/,
-      /AGENTS\.md$/,
-      /GEMINI\.md$/,
-      /settings\.json$/,
-    ];
-    if (allowedPatterns.some(p => p.test(filePath))) {
-      process.exit(0);
-    }
+        // Allow edits to common config/docs files that don't need GSD tracking
+        const allowedPatterns = [
+            /\.gitignore$/,
+            /\.env/,
+            /CLAUDE\.md$/,
+            /AGENTS\.md$/,
+            /GEMINI\.md$/,
+            /settings\.json$/,
+        ];
+        if (allowedPatterns.some(p => p.test(filePath))) {
+            process.exit(0);
+        }
 
-    // Check if workflow guard is enabled
-    const cwd = data.cwd || process.cwd();
-    const configPath = path.join(cwd, '.planning', 'config.json');
-    if (fs.existsSync(configPath)) {
-      try {
-        const config = JSON.parse(fs.readFileSync(configPath, 'utf8'));
-        if (!config.hooks?.workflow_guard) {
-          process.exit(0); // Guard disabled (default)
+        // Check if workflow guard is enabled
+        const cwd = data.cwd || process.cwd();
+        const configPath = path.join(cwd, '.planning', 'config.json');
+        if (fs.existsSync(configPath)) {
+            try {
+                const config = JSON.parse(fs.readFileSync(configPath, 'utf8'));
+                if (!config.hooks?.workflow_guard) {
+                    process.exit(0); // Guard disabled (default)
+                }
+            } catch (e) {
+                process.exit(0);
+            }
+        } else {
+            process.exit(0); // No GSD project - don't guard
         }
-      } catch (e) {
-        process.exit(0);
-      }
-    } else {
-      process.exit(0); // No GSD project - don't guard
-    }
 
-    // If we get here: GSD project, guard enabled, file edit outside .planning/,
-    // not in a subagent context. Inject advisory warning.
-    const output = {
-      hookSpecificOutput: {
-        hookEventName: "PreToolUse",
-        additionalContext: `⚠️ WORKFLOW ADVISORY: You're editing ${path.basename(filePath)} directly without a GSD command. ` +
-          'This edit will not be tracked in STATE.md or produce a SUMMARY.md. ' +
-          'Consider using /gsd:fast for trivial fixes or /gsd:quick for larger changes ' +
-          'to maintain project state tracking. ' +
-          'If this is intentional (e.g., user explicitly asked for a direct edit), proceed normally.'
-      }
-    };
+        // If we get here: GSD project, guard enabled, file edit outside .planning/,
+        // not in a subagent context. Inject advisory warning.
+        const output = {
+            hookSpecificOutput: {
+                hookEventName: "PreToolUse",
+                additionalContext: `⚠️ WORKFLOW ADVISORY: You're editing ${path.basename(filePath)} directly without a GSD command. ` +
+                    'This edit will not be tracked in STATE.md or produce a SUMMARY.md. ' +
+                    'Consider using /gsd-fast for trivial fixes or /gsd-quick for larger changes ' +
+                    'to maintain project state tracking. ' +
+                    'If this is intentional (e.g., user explicitly asked for a direct edit), proceed normally.'
+            }
+        };
 
-    process.stdout.write(JSON.stringify(output));
-  } catch (e) {
-    // Silent fail - never block tool execution
-    process.exit(0);
-  }
+        process.stdout.write(JSON.stringify(output));
+    } catch (e) {
+        // Silent fail - never block tool execution
+        process.exit(0);
+    }
 });

package/README.md

@@ -49,7 +49,7 @@ Then start your first project:
                                 └─► (next phase or /gsd-complete-milestone)
 ```
 
-All project state lives in `.planning/` - committed to git, survives `/clear` and context resets.
+All project state lives in `.planning/` - committed to git, survives `/new` and context resets.
 
 ---
 

package/dist/pi-gsd-hooks.js

@@ -933,8 +933,10 @@ function pi_gsd_hooks_default(pi) {
       }
     }
     if (raw === null) {
-      errors.push("File not found: " + filePath);
-      return null;
+      return `
+> \u26A0\uFE0F **GSD include error:** workflow \`${filePath}\` not found.
+> Run \`/gsd-health\` to diagnose, or reinstall with \`npm install pi-gsd\`.
+`;
     }
     let result = raw;
     if (!selectExpr) return result;
@@ -1028,7 +1030,6 @@ function pi_gsd_hooks_default(pi) {
     }
     if (errors.length > 0) {
       ctx.ui.notify("\u274C GSD include failed:\n" + errors.map((e) => "  \u2022 " + e).join("\n"), "error");
-      return { messages: [] };
     }
     const extFile2 = typeof __filename !== "undefined" ? __filename : "";
     const pkgRoot2 = (0, import_node_path4.join)((0, import_node_path4.dirname)(extFile2), "..");
@@ -1066,6 +1067,19 @@ function pi_gsd_hooks_default(pi) {
       ],
       shellTimeoutMs: projectSettings.shellTimeoutMs ?? globalSettings.shellTimeoutMs ?? 3e4
     };
+    const preWxpSnapshots = /* @__PURE__ */ new Map();
+    for (let msgIdx = 0; msgIdx < messages.length; msgIdx++) {
+      const msg = messages[msgIdx];
+      if (msg.role !== "user") continue;
+      if (typeof msg.content === "string" && msg.content.includes("<gsd-")) {
+        preWxpSnapshots.set(msgIdx, msg.content);
+      } else if (Array.isArray(msg.content)) {
+        const blocks = msg.content;
+        if (blocks.some((b) => b.type === "text" && b.text?.includes("<gsd-"))) {
+          preWxpSnapshots.set(msgIdx, blocks.map((b) => ({ ...b })));
+        }
+      }
+    }
     try {
       for (let msgIdx = 0; msgIdx < messages.length; msgIdx++) {
         const msg = messages[msgIdx];
@@ -1087,10 +1101,23 @@ function pi_gsd_hooks_default(pi) {
     } catch (wxpErr) {
       if (wxpErr instanceof WxpProcessingError) {
         ctx.ui.notify(wxpErr.message, "error");
-        return { messages: [] };
+        for (let msgIdx = 0; msgIdx < messages.length; msgIdx++) {
+          const snap = preWxpSnapshots.get(msgIdx);
+          if (snap === void 0) continue;
+          const msg = messages[msgIdx];
+          if (typeof msg.content === "string") {
+            msg.content = snap;
+          } else if (Array.isArray(msg.content)) {
+            const snapArr = snap;
+            const blocks = msg.content;
+            for (let bi = 0; bi < blocks.length; bi++) {
+              const b = blocks[bi];
+              const sb = snapArr[bi];
+              if (b.type === "text" && sb?.text !== void 0) b.text = sb.text;
+            }
+          }
+        }
       }
-      const errMsg = wxpErr instanceof Error ? wxpErr.message : String(wxpErr);
-      ctx.ui.notify(`GSD WXP: unexpected context error: ${errMsg}`, "info");
     }
     return { messages };
   });