gsd-pi 2.67.0-dev.2142d3e → 2.67.0-dev.2367d7e

package/dist/resources/extensions/gsd/auto.js

@@ -11,6 +11,7 @@
  */
 import { deriveState } from "./state.js";
 import { parseUnitId } from "./unit-id.js";
+import { assessInterruptedSession, readPausedSessionMetadata, } from "./interrupted-session.js";
 import { getManifestStatus } from "./files.js";
 export { inlinePriorMilestoneSummary } from "./files.js";
 import { collectSecretsFromManifest } from "../get-secrets-from-user.js";
@@ -18,7 +19,7 @@ import { gsdRoot, resolveMilestoneFile, resolveMilestonePath, resolveDir, milest
 import { invalidateAllCaches } from "./cache.js";
 import { clearActivityLogState } from "./activity-log.js";
 import { synthesizeCrashRecovery, getDeepDiagnostic, readActiveMilestoneId, } from "./session-forensics.js";
-import { writeLock, clearLock, readCrashLock, isLockProcessAlive, } from "./crash-recovery.js";
+import { writeLock, clearLock, readCrashLock, isLockProcessAlive, formatCrashInfo, } from "./crash-recovery.js";
 import { acquireSessionLock, getSessionLockStatus, releaseSessionLock, updateSessionLock, } from "./session-lock.js";
 import { resolveAutoSupervisorConfig, loadEffectiveGSDPreferences, getIsolationMode, } from "./preferences.js";
 import { sendDesktopNotification } from "./notifications.js";
@@ -34,7 +35,8 @@ import { clearSkillSnapshot } from "./skill-discovery.js";
 import { captureAvailableSkills, resetSkillTelemetry, } from "./skill-telemetry.js";
 import { getRtkSessionSavings } from "../shared/rtk-session-stats.js";
 import { initMetrics, resetMetrics, getLedger, getProjectTotals, formatCost, formatTokenCount, } from "./metrics.js";
-import { setLogBasePath, logWarning } from "./workflow-logger.js";
+import { logWarning } from "./workflow-logger.js";
+import { homedir } from "node:os";
 import { join } from "node:path";
 import { readFileSync, existsSync, mkdirSync, writeFileSync, unlinkSync } from "node:fs";
 import { atomicWriteSync } from "./atomic-write.js";
@@ -79,6 +81,27 @@ export { MAX_UNIT_DISPATCHES, STUB_RECOVERY_THRESHOLD, MAX_LIFETIME_DISPATCHES,
 const s = new AutoSession();
 /** Throttle STATE.md rebuilds — at most once per 30 seconds */
 const STATE_REBUILD_MIN_INTERVAL_MS = 30_000;
+function captureProjectRootEnv(projectRoot) {
+    if (!s.projectRootEnvCaptured) {
+        s.hadProjectRootEnv = Object.prototype.hasOwnProperty.call(process.env, "GSD_PROJECT_ROOT");
+        s.previousProjectRootEnv = process.env.GSD_PROJECT_ROOT ?? null;
+        s.projectRootEnvCaptured = true;
+    }
+    process.env.GSD_PROJECT_ROOT = projectRoot;
+}
+function restoreProjectRootEnv() {
+    if (!s.projectRootEnvCaptured)
+        return;
+    if (s.hadProjectRootEnv && s.previousProjectRootEnv !== null) {
+        process.env.GSD_PROJECT_ROOT = s.previousProjectRootEnv;
+    }
+    else {
+        delete process.env.GSD_PROJECT_ROOT;
+    }
+    s.previousProjectRootEnv = null;
+    s.hadProjectRootEnv = false;
+    s.projectRootEnvCaptured = false;
+}
 export function shouldUseWorktreeIsolation() {
     const prefs = loadEffectiveGSDPreferences()?.preferences?.git;
     if (prefs?.isolation === "worktree")
@@ -315,6 +338,7 @@ function handleLostSessionLock(ctx, lockStatus) {
     s.active = false;
     s.paused = false;
     clearUnitTimeout();
+    restoreProjectRootEnv();
     deregisterSigtermHandler();
     clearCmuxSidebar(loadEffectiveGSDPreferences()?.preferences);
     const base = lockBase();
@@ -345,6 +369,7 @@ function cleanupAfterLoopExit(ctx) {
     s.currentUnit = null;
     s.active = false;
     clearUnitTimeout();
+    restoreProjectRootEnv();
     // Clear crash lock and release session lock so the next `/gsd next` does
     // not see a stale lock with the current PID and treat it as a "remote"
     // session (which would cause it to SIGTERM itself). (#2730)
@@ -601,6 +626,7 @@ export async function stopAuto(ctx, pi, reason) {
         ctx?.ui.setStatus("gsd-auto", undefined);
         ctx?.ui.setWidget("gsd-progress", undefined);
         ctx?.ui.setFooter(undefined);
+        restoreProjectRootEnv();
         // Reset all session state in one call
         s.reset();
     }
@@ -641,6 +667,8 @@ export async function pauseAuto(ctx, _pi, _errorContext) {
             stepMode: s.stepMode,
             pausedAt: new Date().toISOString(),
             sessionFile: s.pausedSessionFile,
+            unitType: s.currentUnit?.type ?? undefined,
+            unitId: s.currentUnit?.id ?? undefined,
             activeEngineId: s.activeEngineId,
             activeRunDir: s.activeRunDir,
             autoStartTime: s.autoStartTime,
@@ -674,6 +702,7 @@ export async function pauseAuto(ctx, _pi, _errorContext) {
     _resetPendingResolve();
     s.active = false;
     s.paused = true;
+    restoreProjectRootEnv();
     s.pendingVerificationRetry = null;
     s.verificationRetryCount.clear();
     ctx?.ui.setStatus("gsd-auto", "paused");
@@ -828,38 +857,54 @@ export async function startAuto(ctx, pi, base, verboseMode, options) {
         return;
     }
     const requestedStepMode = options?.step ?? false;
+    const interruptedAssessment = options?.interrupted ?? null;
     // Escape stale worktree cwd from a previous milestone (#608).
     base = escapeStaleWorktree(base);
+    const freshStartAssessment = interruptedAssessment
+        ?? await assessInterruptedSession(base);
+    if (freshStartAssessment.classification === "running") {
+        const pid = freshStartAssessment.lock?.pid;
+        ctx.ui.notify(pid
+            ? `Another auto-mode session (PID ${pid}) appears to be running.\nStop it with \`kill ${pid}\` before starting a new session.`
+            : "Another auto-mode session appears to be running.", "error");
+        return;
+    }
     // If resuming from paused state, just re-activate and dispatch next unit.
     // Check persisted paused-session first (#1383) — survives /exit.
     if (!s.paused) {
         try {
+            const meta = freshStartAssessment.pausedSession ?? readPausedSessionMetadata(base);
             const pausedPath = join(gsdRoot(base), "runtime", "paused-session.json");
-            if (existsSync(pausedPath)) {
-                const meta = JSON.parse(readFileSync(pausedPath, "utf-8"));
-                if (meta.activeEngineId && meta.activeEngineId !== "dev") {
-                    // Custom workflow resume — restore engine state
-                    s.activeEngineId = meta.activeEngineId;
-                    s.activeRunDir = meta.activeRunDir ?? null;
-                    s.originalBasePath = meta.originalBasePath || base;
-                    s.stepMode = meta.stepMode ?? requestedStepMode;
-                    s.autoStartTime = meta.autoStartTime || Date.now();
-                    s.paused = true;
-                    // Don't delete pause file yet — defer until lock is acquired.
-                    // If lock fails, the file must survive for retry.
-                    s.pausedSessionFile = pausedPath;
-                    ctx.ui.notify(`Resuming paused custom workflow${meta.activeRunDir ? ` (${meta.activeRunDir})` : ""}.`, "info");
+            if (meta?.activeEngineId && meta.activeEngineId !== "dev") {
+                // Custom workflow resume — restore engine state
+                s.activeEngineId = meta.activeEngineId;
+                s.activeRunDir = meta.activeRunDir ?? null;
+                s.originalBasePath = meta.originalBasePath || base;
+                s.stepMode = meta.stepMode ?? requestedStepMode;
+                s.autoStartTime = meta.autoStartTime || Date.now();
+                s.paused = true;
+                try {
+                    unlinkSync(pausedPath);
                 }
-                else if (meta.milestoneId) {
+                catch (e) {
+                    logWarning("session", `pause file cleanup failed: ${e instanceof Error ? e.message : String(e)}`, { file: "auto.ts" });
+                }
+                ctx.ui.notify(`Resuming paused custom workflow${meta.activeRunDir ? ` (${meta.activeRunDir})` : ""}.`, "info");
+            }
+            else if (meta?.milestoneId) {
+                const shouldResumePausedSession = freshStartAssessment.classification === "recoverable"
+                    && (freshStartAssessment.hasResumableDiskState
+                        || !!freshStartAssessment.recoveryPrompt
+                        || !!freshStartAssessment.lock);
+                if (shouldResumePausedSession) {
                     // Validate the milestone still exists and isn't already complete (#1664).
                     const mDir = resolveMilestonePath(base, meta.milestoneId);
                     const summaryFile = resolveMilestoneFile(base, meta.milestoneId, "SUMMARY");
                     if (!mDir || summaryFile) {
-                        // Stale milestone — clean up and fall through to fresh bootstrap
                         try {
                             unlinkSync(pausedPath);
                         }
-                        catch (err) { /* non-fatal */
+                        catch (err) {
                             logWarning("session", `pause file cleanup failed: ${err instanceof Error ? err.message : String(err)}`, { file: "auto.ts" });
                         }
                         ctx.ui.notify(`Paused milestone ${meta.milestoneId} is ${!mDir ? "missing" : "already complete"}. Starting fresh.`, "info");
@@ -868,12 +913,26 @@ export async function startAuto(ctx, pi, base, verboseMode, options) {
                         s.currentMilestoneId = meta.milestoneId;
                         s.originalBasePath = meta.originalBasePath || base;
                         s.stepMode = meta.stepMode ?? requestedStepMode;
+                        s.pausedSessionFile = meta.sessionFile ?? null;
+                        s.pausedUnitType = meta.unitType ?? null;
+                        s.pausedUnitId = meta.unitId ?? null;
                         s.autoStartTime = meta.autoStartTime || Date.now();
                         s.paused = true;
-                        // Don't delete pause file yet — defer until lock is acquired.
-                        // If lock fails, the file must survive for retry.
-                        s.pausedSessionFile = pausedPath;
-                        ctx.ui.notify(`Resuming paused session for ${meta.milestoneId}${meta.worktreePath ? ` (worktree)` : ""}.`, "info");
+                        try {
+                            unlinkSync(pausedPath);
+                        }
+                        catch (e) {
+                            logWarning("session", `pause file cleanup failed: ${e instanceof Error ? e.message : String(e)}`, { file: "auto.ts" });
+                        }
+                        ctx.ui.notify(`Resuming paused session for ${meta.milestoneId}${meta.worktreePath && existsSync(meta.worktreePath) ? ` (worktree)` : ""}.`, "info");
+                    }
+                }
+                else if (existsSync(pausedPath)) {
+                    try {
+                        unlinkSync(pausedPath);
+                    }
+                    catch (e) {
+                        logWarning("session", `stale pause file cleanup failed: ${e instanceof Error ? e.message : String(e)}`, { file: "auto.ts" });
                     }
                 }
             }
@@ -882,6 +941,30 @@ export async function startAuto(ctx, pi, base, verboseMode, options) {
             // Malformed or missing — proceed with fresh bootstrap
             logWarning("session", `paused-session restore failed: ${err instanceof Error ? err.message : String(err)}`, { file: "auto.ts" });
         }
+        // Guard against zero/missing autoStartTime after resume (#3585)
+        if (!s.autoStartTime || s.autoStartTime <= 0)
+            s.autoStartTime = Date.now();
+    }
+    if (!s.paused) {
+        s.stepMode = requestedStepMode;
+    }
+    if (freshStartAssessment.lock) {
+        clearLock(base);
+    }
+    if (!s.paused) {
+        s.pendingCrashRecovery =
+            freshStartAssessment.classification === "recoverable"
+                ? freshStartAssessment.recoveryPrompt
+                : null;
+        if (freshStartAssessment.classification === "recoverable" && freshStartAssessment.lock) {
+            const info = formatCrashInfo(freshStartAssessment.lock);
+            if (freshStartAssessment.recoveryToolCallCount > 0) {
+                ctx.ui.notify(`${info}\nRecovered ${freshStartAssessment.recoveryToolCallCount} tool calls from crashed session. Resuming with full context.`, "warning");
+            }
+            else if (freshStartAssessment.hasResumableDiskState) {
+                ctx.ui.notify(`${info}\nResuming from disk state.`, "warning");
+            }
+        }
     }
     if (s.paused) {
         const resumeLock = acquireSessionLock(base);
@@ -906,29 +989,19 @@ export async function startAuto(ctx, pi, base, verboseMode, options) {
         s.active = true;
         s.verbose = verboseMode;
         s.stepMode = requestedStepMode;
-        // Preserve the original cmdCtx (ExtensionCommandContext with newSession)
-        // when resuming from a provider-error pause. The resume callback receives
-        // an ExtensionContext (from the agent_end hook) which lacks newSession —
-        // using it would crash runUnit with "newSession is not a function".
-        // Only override if the new ctx actually has newSession (user-initiated resume).
-        if ("newSession" in ctx && typeof ctx.newSession === "function") {
-            s.cmdCtx = ctx;
-        }
-        else if (!s.cmdCtx) {
-            // No saved cmdCtx — this shouldn't happen, but handle gracefully
-            s.cmdCtx = ctx;
-        }
-        // else: keep existing s.cmdCtx which has the real newSession
+        s.cmdCtx = ctx;
         s.basePath = base;
-        setLogBasePath(base);
-        if (!s.autoStartTime || s.autoStartTime <= 0)
-            s.autoStartTime = Date.now();
         s.unitDispatchCount.clear();
         s.unitLifetimeDispatches.clear();
         if (!getLedger())
             initMetrics(base);
         if (s.currentMilestoneId)
             setActiveMilestoneId(base, s.currentMilestoneId);
+        // Re-register health level notification callback lost across process restart
+        setLevelChangeCallback((_from, to, summary) => {
+            const level = to === "red" ? "error" : to === "yellow" ? "warning" : "info";
+            ctx.ui.notify(summary, level);
+        });
         // ── Auto-worktree: re-enter worktree on resume ──
         if (s.currentMilestoneId &&
             shouldUseWorktreeIsolation() &&
@@ -945,6 +1018,11 @@ export async function startAuto(ctx, pi, base, verboseMode, options) {
         ctx.ui.setFooter(hideFooter);
         ctx.ui.notify(s.stepMode ? "Step-mode resumed." : "Auto-mode resumed.", "info");
         restoreHookState(s.basePath);
+        // Re-sync managed resources on resume so long-lived auto sessions pick up
+        // bundled extension updates before resume-time verification/state logic runs.
+        const agentDir = process.env.GSD_CODING_AGENT_DIR || join(process.env.GSD_HOME || homedir(), ".gsd", "agent");
+        const { initResources } = await import("../../../" + "resource-loader.js");
+        initResources(agentDir);
         // Open the project DB before rebuild/derive so resume uses DB-backed
         // state instead of falling back to stale markdown parsing (#2940).
         await openProjectDbIfPresent(s.basePath);
@@ -971,7 +1049,7 @@ export async function startAuto(ctx, pi, base, verboseMode, options) {
         invalidateAllCaches();
         if (s.pausedSessionFile) {
             const activityDir = join(gsdRoot(s.basePath), "activity");
-            const recovery = synthesizeCrashRecovery(s.basePath, s.currentUnit?.type ?? "unknown", s.currentUnit?.id ?? "unknown", s.pausedSessionFile ?? undefined, activityDir);
+            const recovery = synthesizeCrashRecovery(s.basePath, s.currentUnit?.type ?? s.pausedUnitType ?? "unknown", s.currentUnit?.id ?? s.pausedUnitId ?? "unknown", s.pausedSessionFile ?? undefined, activityDir);
             if (recovery && recovery.trace.toolCallCount > 0) {
                 s.pendingCrashRecovery = recovery.prompt;
                 ctx.ui.notify(`Recovered ${recovery.trace.toolCallCount} tool calls from paused session. Resuming with context.`, "info");
@@ -981,6 +1059,7 @@ export async function startAuto(ctx, pi, base, verboseMode, options) {
         updateSessionLock(lockBase(), "resuming", s.currentMilestoneId ?? "unknown");
         writeLock(lockBase(), "resuming", s.currentMilestoneId ?? "unknown");
         logCmuxEvent(loadEffectiveGSDPreferences()?.preferences, s.stepMode ? "Step-mode resumed." : "Auto-mode resumed.", "progress");
+        captureProjectRootEnv(s.originalBasePath || s.basePath);
         await autoLoop(ctx, pi, s, buildLoopDeps());
         cleanupAfterLoopExit(ctx);
         return;
@@ -992,9 +1071,10 @@ export async function startAuto(ctx, pi, base, verboseMode, options) {
         lockBase,
         buildResolver,
     };
-    const ready = await bootstrapAutoSession(s, ctx, pi, base, verboseMode, requestedStepMode, bootstrapDeps);
+    const ready = await bootstrapAutoSession(s, ctx, pi, base, verboseMode, requestedStepMode, bootstrapDeps, freshStartAssessment);
     if (!ready)
         return;
+    captureProjectRootEnv(s.originalBasePath || s.basePath);
     try {
         syncCmuxSidebar(loadEffectiveGSDPreferences()?.preferences, await deriveState(s.basePath));
     }
@@ -1074,24 +1154,6 @@ function ensurePreconditions(unitType, unitId, base, state) {
         }
     }
 }
-// ─── Diagnostics ──────────────────────────────────────────────────────────────
-/** Build recovery context from module state for recoverTimedOutUnit */
-function buildRecoveryContext() {
-    return {
-        basePath: s.basePath,
-        verbose: s.verbose,
-        currentUnitStartedAt: s.currentUnit?.startedAt ?? Date.now(),
-        unitRecoveryCount: s.unitRecoveryCount,
-    };
-}
-/**
- * Test-only: expose skip-loop state for unit tests.
- * Not part of the public API.
- */
-/**
- * Dispatch a hook unit directly, bypassing normal pre-dispatch hooks.
- * Used for manual hook triggers via /gsd run-hook.
- */
 export async function dispatchHookUnit(ctx, pi, hookName, triggerUnitType, triggerUnitId, hookPrompt, hookModel, targetBasePath) {
     if (!s.active) {
         s.active = true;

package/dist/resources/extensions/gsd/bootstrap/system-context.js

@@ -141,7 +141,7 @@ export async function buildBeforeAgentStartResult(event, ctx) {
     warnDeprecatedAgentInstructions();
     const injection = await buildGuidedExecuteContextInjection(event.prompt, process.cwd());
     // Re-inject forensics context on follow-up turns (#2941)
-    const forensicsInjection = !injection ? buildForensicsContextInjection(process.cwd()) : null;
+    const forensicsInjection = !injection ? buildForensicsContextInjection(process.cwd(), event.prompt) : null;
     const worktreeBlock = buildWorktreeContextBlock();
     const fullSystem = `${event.systemPrompt}\n\n[SYSTEM CONTEXT — GSD]\n\n${systemContent}${preferenceBlock}${knowledgeBlock}${codebaseBlock}${memoryBlock}${newSkillsBlock}${worktreeBlock}`;
     stopContextTimer({
@@ -425,7 +425,7 @@ function oneLine(text) {
  * Check for an active forensics session and return the prompt content
  * so it can be re-injected on follow-up turns.
  */
-function buildForensicsContextInjection(basePath) {
+export function buildForensicsContextInjection(basePath, prompt) {
     const marker = readForensicsMarker(basePath);
     if (!marker)
         return null;
@@ -435,6 +435,11 @@ function buildForensicsContextInjection(basePath) {
         clearForensicsMarker(basePath);
         return null;
     }
+    const trimmed = prompt.trim().toLowerCase().replace(/[.!?,]+$/g, "");
+    if (trimmed && !RESUME_INTENT_PATTERNS.test(trimmed)) {
+        clearForensicsMarker(basePath);
+        return null;
+    }
     return marker.promptContent;
 }
 /**

package/dist/resources/extensions/gsd/commands/catalog.js

@@ -58,7 +58,7 @@ export const TOP_LEVEL_SUBCOMMANDS = [
     { cmd: "templates", desc: "List available workflow templates" },
     { cmd: "extensions", desc: "Manage extensions (list, enable, disable, info)" },
     { cmd: "fast", desc: "Toggle OpenAI service tier (on/off/flex/status)" },
-    { cmd: "mcp", desc: "MCP server status and connectivity check (status, check <server>)" },
+    { cmd: "mcp", desc: "MCP server status, connectivity, and local config bootstrap (status, check, init)" },
     { cmd: "rethink", desc: "Conversational project reorganization — reorder, park, discard, add milestones" },
     { cmd: "workflow", desc: "Custom workflow lifecycle (new, run, list, validate, pause, resume)" },
     { cmd: "codebase", desc: "Generate, refresh, and inspect the codebase map cache (.gsd/CODEBASE.md)" },
@@ -188,6 +188,7 @@ const NESTED_COMPLETIONS = {
     mcp: [
         { cmd: "status", desc: "Show all MCP server statuses (default)" },
         { cmd: "check", desc: "Detailed status for a specific server" },
+        { cmd: "init", desc: "Write .mcp.json for the local GSD workflow MCP server" },
     ],
     doctor: [
         { cmd: "fix", desc: "Auto-fix detected issues" },

package/dist/resources/extensions/gsd/commands/handlers/core.js

@@ -55,7 +55,7 @@ export function showHelp(ctx) {
         "  /gsd hooks          Show post-unit hook configuration",
         "  /gsd extensions     Manage extensions  [list|enable|disable|info]",
         "  /gsd fast           Toggle OpenAI service tier  [on|off|flex|status]",
-        "  /gsd mcp            MCP server status and connectivity  [status|check <server>]",
+        "  /gsd mcp            MCP server status and connectivity  [status|check <server>|init [dir]]",
         "",
         "MAINTENANCE",
         "  /gsd doctor         Diagnose and repair .gsd/ state  [audit|fix|heal] [scope]",

package/dist/resources/extensions/gsd/commands-mcp-status.js

@@ -7,9 +7,26 @@
  *   /gsd mcp             — Overview of all servers (alias: /gsd mcp status)
  *   /gsd mcp status      — Same as bare /gsd mcp
  *   /gsd mcp check <srv> — Detailed status for a specific server
+ *   /gsd mcp init [dir]  — Write project-local GSD workflow MCP config
  */
 import { existsSync, readFileSync } from "node:fs";
-import { join } from "node:path";
+import { join, resolve } from "node:path";
+import { ensureProjectWorkflowMcpConfig } from "./mcp-project-config.js";
+export function formatMcpInitResult(status, configPath, targetPath) {
+    const summary = status === "created"
+        ? "Created project MCP config."
+        : status === "updated"
+            ? "Updated project MCP config."
+            : "Project MCP config is already up to date.";
+    return [
+        summary,
+        "",
+        `Project: ${targetPath}`,
+        `Config:   ${configPath}`,
+        "",
+        "Claude Code can now load the GSD workflow MCP server from this folder.",
+    ].join("\n");
+}
 function readMcpConfigs() {
     const servers = [];
     const seen = new Set();
@@ -61,6 +78,7 @@ export function formatMcpStatusReport(servers) {
             "No MCP servers configured.",
             "",
             "Add servers to .mcp.json or .gsd/mcp.json to enable MCP integrations.",
+            "Tip: run /gsd mcp init . to write the local GSD workflow MCP config.",
             "See: https://modelcontextprotocol.io/quickstart",
         ].join("\n");
     }
@@ -109,11 +127,28 @@ export function formatMcpServerDetail(server) {
  * Handle `/gsd mcp [status|check <server>]`.
  */
 export async function handleMcpStatus(args, ctx) {
-    const trimmed = args.trim().toLowerCase();
+    const trimmed = args.trim();
+    const lowered = trimmed.toLowerCase();
     const configs = readMcpConfigs();
+    // /gsd mcp init [dir]
+    if (!lowered || lowered === "status") {
+        // handled below
+    }
+    else if (lowered === "init" || lowered.startsWith("init ")) {
+        const rawPath = trimmed.slice("init".length).trim();
+        const targetPath = resolve(rawPath || ".");
+        try {
+            const result = ensureProjectWorkflowMcpConfig(targetPath);
+            ctx.ui.notify(formatMcpInitResult(result.status, result.configPath, targetPath), "info");
+        }
+        catch (err) {
+            ctx.ui.notify(`Failed to prepare MCP config for ${targetPath}: ${err instanceof Error ? err.message : String(err)}`, "error");
+        }
+        return;
+    }
     // /gsd mcp check <server>
-    if (trimmed.startsWith("check ")) {
-        const serverName = args.trim().slice("check ".length).trim();
+    if (lowered.startsWith("check ")) {
+        const serverName = trimmed.slice("check ".length).trim();
         const config = configs.find((c) => c.name === serverName);
         if (!config) {
             const available = configs.map((c) => c.name).join(", ") || "(none)";
@@ -149,7 +184,7 @@ export async function handleMcpStatus(args, ctx) {
         return;
     }
     // /gsd mcp or /gsd mcp status
-    if (!trimmed || trimmed === "status") {
+    if (!lowered || lowered === "status") {
         // Build status for each server
         const statuses = [];
         for (const config of configs) {
@@ -181,7 +216,8 @@ export async function handleMcpStatus(args, ctx) {
         return;
     }
     // Unknown subcommand
-    ctx.ui.notify("Usage: /gsd mcp [status|check <server>]\n\n" +
+    ctx.ui.notify("Usage: /gsd mcp [status|check <server>|init [dir]]\n\n" +
         "  status           Show all MCP server statuses (default)\n" +
-        "  check <server>   Detailed status for a specific server", "warning");
+        "  check <server>   Detailed status for a specific server\n" +
+        "  init [dir]       Write .mcp.json for the local GSD workflow MCP server", "warning");
 }

package/dist/resources/extensions/gsd/doctor-git-checks.js

@@ -8,7 +8,7 @@ import { deriveState, isMilestoneComplete } from "./state.js";
 import { listWorktrees, resolveGitDir, worktreesDir } from "./worktree-manager.js";
 import { abortAndReset } from "./git-self-heal.js";
 import { RUNTIME_EXCLUSION_PATHS, resolveMilestoneIntegrationBranch, writeIntegrationBranch } from "./git-service.js";
-import { nativeIsRepo, nativeWorktreeList, nativeWorktreeRemove, nativeBranchList, nativeBranchDelete, nativeLsFiles, nativeRmCached, nativeHasChanges, nativeLastCommitEpoch, nativeGetCurrentBranch, nativeAddAllWithExclusions, nativeCommit } from "./native-git-bridge.js";
+import { nativeIsRepo, nativeWorktreeList, nativeWorktreeRemove, nativeBranchList, nativeBranchDelete, nativeLsFiles, nativeRmCached, nativeHasChanges, nativeLastCommitEpoch, nativeGetCurrentBranch, nativeAddTracked, nativeCommit } from "./native-git-bridge.js";
 import { getAllWorktreeHealth } from "./worktree-health.js";
 import { loadEffectiveGSDPreferences } from "./preferences.js";
 /**
@@ -380,19 +380,19 @@ export async function checkGitHealth(basePath, issues, fixesApplied, shouldFix,
                         code: "stale_uncommitted_changes",
                         scope: "project",
                         unitId: "project",
-                        message: `Uncommitted changes detected with no commit in ${mins} minute${mins === 1 ? "" : "s"} (threshold: ${thresholdMinutes}m). Snapshotting uncommitted changes.`,
+                        message: `Uncommitted changes detected with no commit in ${mins} minute${mins === 1 ? "" : "s"} (threshold: ${thresholdMinutes}m). Snapshotting tracked files.`,
                         fixable: true,
                     });
                     if (shouldFix("stale_uncommitted_changes")) {
                         try {
-                            nativeAddAllWithExclusions(basePath, RUNTIME_EXCLUSION_PATHS);
+                            nativeAddTracked(basePath);
                             const commitMsg = `gsd snapshot: uncommitted changes after ${mins}m inactivity`;
                             const result = nativeCommit(basePath, commitMsg);
                             if (result) {
                                 fixesApplied.push(`created gsd snapshot after ${mins}m of uncommitted changes`);
                             }
                             else {
-                                fixesApplied.push("gsd snapshot skipped — nothing to commit after staging changes");
+                                fixesApplied.push("gsd snapshot skipped — nothing to commit after staging tracked files");
                             }
                         }
                         catch {

package/dist/resources/extensions/gsd/doctor-proactive.js

@@ -20,8 +20,8 @@ import { readCrashLock, isLockProcessAlive, clearLock } from "./crash-recovery.j
 import { abortAndReset } from "./git-self-heal.js";
 import { rebuildState } from "./doctor.js";
 import { deriveState } from "./state.js";
-import { RUNTIME_EXCLUSION_PATHS, resolveMilestoneIntegrationBranch } from "./git-service.js";
-import { nativeIsRepo, nativeHasChanges, nativeLastCommitEpoch, nativeGetCurrentBranch, nativeAddAllWithExclusions, nativeCommit } from "./native-git-bridge.js";
+import { resolveMilestoneIntegrationBranch } from "./git-service.js";
+import { nativeIsRepo, nativeHasChanges, nativeLastCommitEpoch, nativeGetCurrentBranch, nativeAddTracked, nativeCommit } from "./native-git-bridge.js";
 import { loadEffectiveGSDPreferences } from "./preferences.js";
 import { runEnvironmentChecks } from "./doctor-environment.js";
 /** In-memory health history for the current auto-mode session. */
@@ -247,7 +247,7 @@ export async function preDispatchHealthGate(basePath) {
                 if (minutesSinceCommit >= thresholdMinutes) {
                     const mins = Math.floor(minutesSinceCommit);
                     try {
-                        nativeAddAllWithExclusions(basePath, RUNTIME_EXCLUSION_PATHS);
+                        nativeAddTracked(basePath);
                         const commitMsg = `gsd snapshot: pre-dispatch, uncommitted changes after ${mins}m inactivity`;
                         const result = nativeCommit(basePath, commitMsg);
                         if (result) {

package/dist/resources/extensions/gsd/doctor.js

@@ -7,6 +7,7 @@ import { resolveMilestoneFile, resolveMilestonePath, resolveSliceFile, resolveSl
 import { deriveState, isMilestoneComplete } from "./state.js";
 import { invalidateAllCaches } from "./cache.js";
 import { loadEffectiveGSDPreferences } from "./preferences.js";
+import { isClosedStatus } from "./status-guards.js";
 import { GLOBAL_STATE_CODES } from "./doctor-types.js";
 import { checkGitHealth, checkRuntimeHealth, checkGlobalHealth, checkEngineHealth } from "./doctor-checks.js";
 import { checkEnvironmentHealth } from "./doctor-environment.js";
@@ -443,8 +444,9 @@ export async function runGSDDoctor(basePath, options) {
             slices = dbSlices.map(s => ({
                 id: s.id,
                 title: s.title,
-                done: s.status === "complete",
+                done: isClosedStatus(s.status),
                 pending: s.status === "pending",
+                skipped: s.status === "skipped",
                 risk: (s.risk || "medium"),
                 depends: s.depends,
                 demo: s.demo,
@@ -541,8 +543,9 @@ export async function runGSDDoctor(basePath, options) {
             const slicePath = resolveSlicePath(basePath, milestoneId, slice.id);
             if (!slicePath) {
                 // Pending slices haven't been planned yet — directories are created
-                // lazily by ensurePreconditions() at dispatch time. Skip them.
-                if (slice.pending)
+                // lazily by ensurePreconditions() at dispatch time. Skipped slices are
+                // intentionally allowed to remain summary-less and directory-less.
+                if (slice.pending || slice.skipped)
                     continue;
                 const expectedPath = relSlicePath(basePath, milestoneId, slice.id);
                 issues.push({
@@ -566,7 +569,8 @@ export async function runGSDDoctor(basePath, options) {
             const tasksDir = resolveTasksDir(basePath, milestoneId, slice.id);
             if (!tasksDir) {
                 // Pending slices haven't been planned yet — tasks/ is created on demand.
-                if (slice.pending)
+                // Skipped slices may legitimately never create tasks/.
+                if (slice.pending || slice.skipped)
                     continue;
                 issues.push({
                     severity: slice.done ? "warning" : "error",

package/dist/resources/extensions/gsd/gsd-db.js

@@ -701,6 +701,7 @@ let currentDb = null;
 let currentPath = null;
 let currentPid = 0;
 let _exitHandlerRegistered = false;
+let _dbOpenAttempted = false;
 export function getDbProvider() {
     loadProvider();
     return providerName;
@@ -708,7 +709,17 @@ export function getDbProvider() {
 export function isDbAvailable() {
     return currentDb !== null;
 }
+/**
+ * Returns true if openDatabase() has been called at least once this session.
+ * Used to distinguish "DB not yet initialized" from "DB genuinely unavailable"
+ * so that early callers (e.g. before_agent_start context injection) don't
+ * trigger a false degraded-mode warning.
+ */
+export function wasDbOpenAttempted() {
+    return _dbOpenAttempted;
+}
 export function openDatabase(path) {
+    _dbOpenAttempted = true;
     if (currentDb && currentPath !== path)
         closeDatabase();
     if (currentDb && currentPath === path)