@opengsd/gsd-pi 1.1.1-dev.74e8dd1 → 1.1.1-dev.9bb7453

package/dist/resources/extensions/browser-tools/package.json

@@ -4,7 +4,7 @@
   "version": "1.0.0",
   "type": "module",
   "scripts": {
-    "test": "node --test tests/*.test.mjs"
+    "test": "node --import ../gsd/tests/resolve-ts.mjs --experimental-strip-types --test tests/*.test.mjs"
   },
   "pi": {
     "extensions": [
@@ -12,10 +12,14 @@
     ]
   },
   "peerDependencies": {
+    "@opengsd/gsd-browser": ">=0.1.27",
     "playwright": ">=1.40.0",
     "sharp": ">=0.33.0"
   },
   "peerDependenciesMeta": {
+    "@opengsd/gsd-browser": {
+      "optional": true
+    },
     "playwright": {
       "optional": true
     },

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

@@ -256,7 +256,6 @@ export class AutoOrchestrator {
             this.status.activeUnit = { unitType: decision.unitType, unitId: decision.unitId };
             this.status.phase = "running";
             this.lastAdvanceKey = nextKey;
-            this.lastFinalizedUnitKey = null;
             this.bumpTransition();
             await this.deps.runtime.journalTransition({
                 name: "advance",

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

@@ -1,6 +1,6 @@
 // gsd-pi + src/resources/extensions/gsd/auto-dashboard.ts - Auto-mode progress widget rendering and dashboard helpers.
 import { getActiveHook } from "./post-unit-hooks.js";
-import { getLedger } from "./metrics.js";
+import { getLedger, getProjectTotals } from "./metrics.js";
 import { getErrorMessage } from "./error-utils.js";
 import { nativeIsRepo } from "./native-git-bridge.js";
 import { isDbAvailable, getMilestoneSlices, getSliceTasks } from "./gsd-db.js";
@@ -196,6 +196,39 @@ export function formatRuntimeHealthSignal(record, now = Date.now()) {
 export function shouldRenderRoadmapProgress(progress) {
     return !!progress && progress.total > 0;
 }
+function widgetGridLabel(theme, text, color = "borderAccent") {
+    return theme.fg(color, theme.bold(text.toUpperCase()));
+}
+function widgetGridColumn(content, width) {
+    return padRightVisible(truncateToWidth(content, width, "…"), width);
+}
+function widgetGridColumns(theme, width, parts) {
+    if (parts.length === 0)
+        return "";
+    const gap = theme.fg("dim", " │ ");
+    const gapWidth = visibleWidth(gap) * (parts.length - 1);
+    const available = Math.max(parts.length * 8, width - gapWidth);
+    const base = Math.floor(available / parts.length);
+    let remaining = available - base * parts.length;
+    const columns = parts.map((part) => {
+        const columnWidth = base + (remaining > 0 ? 1 : 0);
+        remaining--;
+        return widgetGridColumn(part, columnWidth);
+    });
+    return truncateToWidth(columns.join(gap), width, "…");
+}
+function formatSmallWidgetSpend() {
+    const ledger = getLedger();
+    if (!ledger || ledger.units.length === 0)
+        return "--";
+    const totals = getProjectTotals(ledger.units);
+    const parts = [];
+    if (totals.tokens.total > 0)
+        parts.push(formatWidgetTokens(totals.tokens.total));
+    if (totals.cost > 0)
+        parts.push(`$${totals.cost.toFixed(2)}`);
+    return parts.length > 0 ? parts.join(" · ") : "--";
+}
 // ─── ETA Estimation ──────────────────────────────────────────────────────────
 /**
  * Estimate remaining time based on average unit duration from the metrics ledger.
@@ -642,26 +675,57 @@ export function updateProgressWidget(ctx, unitType, unitId, state, accessors, ti
                     cachedWidth = width;
                     return lines;
                 }
-                // ── Mode: small — header + active work progress ───────────────
+                // ── Mode: small — dense horizontal grid ───────────────────────
                 if (widgetMode === "small") {
-                    lines.push("");
-                    // Action line
-                    const target = task ? `${task.id}: ${task.title}` : unitId;
-                    const actionLeft = `${pad}${theme.fg("accent", "▸")} ${theme.fg("accent", verb)}  ${theme.fg("text", target)}`;
-                    lines.push(rightAlign(actionLeft, theme.fg("dim", phaseLabel), width));
-                    // Progress bar
+                    lines.length = 0;
+                    lines.push(...ui.bar());
                     const roadmapSlices = mid ? getRoadmapSlicesSync() : null;
+                    const unitLabel = unitId || [mid?.id, slice?.id, task?.id].filter(Boolean).join("/");
+                    const statusParts = [
+                        spinner,
+                        theme.fg("success", modeTag),
+                        theme.fg(stateColor, activeState),
+                    ];
+                    if (runtimeSignal?.summary) {
+                        statusParts.push(theme.fg(healthColor, healthSummary));
+                    }
+                    else if (healthLevel !== "green") {
+                        statusParts.push(`${theme.fg(healthColor, healthIcon)} ${theme.fg(healthColor, healthSummary)}`);
+                    }
+                    const timeValue = [elapsed, etaShort].filter(Boolean).join(" · ") || "--";
+                    const rowOne = widgetGridColumns(theme, width, [
+                        `${widgetGridLabel(theme, "status", "border")} ${statusParts.join(" ")}`,
+                        `${widgetGridLabel(theme, "unit")} ${theme.fg("text", unitLabel || "--")}`,
+                        `${widgetGridLabel(theme, "spend", "border")} ${theme.fg("dim", formatSmallWidgetSpend())}`,
+                        `${widgetGridLabel(theme, "time")} ${theme.fg("dim", timeValue)}`,
+                    ]);
+                    const target = task
+                        ? `${task.id}: ${task.title}`
+                        : slice
+                            ? `${slice.id}: ${slice.title}`
+                            : unitId;
+                    let taskValue = task?.id ?? "--";
+                    let sliceValue = slice?.id ?? "--";
                     if (shouldRenderRoadmapProgress(roadmapSlices)) {
                         const { done, total, activeSliceTasks } = roadmapSlices;
-                        const barWidth = Math.max(6, Math.min(18, Math.floor(width * 0.25)));
+                        const barWidth = Math.max(4, Math.min(14, Math.floor(width * 0.12)));
                         const bar = renderProgressBar(theme, done, total, barWidth);
-                        let meta = `${theme.fg("text", `${done}`)}${theme.fg("dim", `/${total} slices`)}`;
+                        sliceValue = `${bar} ${theme.fg("text", `${done}/${total}`)}`;
                         if (activeSliceTasks && activeSliceTasks.total > 0) {
-                            const tn = Math.min(activeSliceTasks.done + 1, activeSliceTasks.total);
-                            meta += `${theme.fg("dim", " · task ")}${theme.fg("accent", `${tn}`)}${theme.fg("dim", `/${activeSliceTasks.total}`)}`;
+                            const taskNum = isHook
+                                ? Math.max(activeSliceTasks.done, 1)
+                                : Math.min(activeSliceTasks.done + 1, activeSliceTasks.total);
+                            taskValue = `${theme.fg("accent", `${taskNum}`)}${theme.fg("dim", `/${activeSliceTasks.total}`)}`;
                         }
-                        lines.push(`${pad}${bar} ${meta}`);
                     }
+                    const rowTwo = widgetGridColumns(theme, width, [
+                        `${widgetGridLabel(theme, "phase", "border")} ${theme.fg("dim", unitType)}`,
+                        `${widgetGridLabel(theme, "work")} ${theme.fg("text", target || "--")}`,
+                        `${widgetGridLabel(theme, "task", "border")} ${taskValue}`,
+                        `${widgetGridLabel(theme, "slice")} ${sliceValue}`,
+                    ]);
+                    lines.push(rowOne);
+                    lines.push(rowTwo);
                     lines.push(...ui.bar());
                     cachedLines = lines;
                     cachedWidth = width;

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

@@ -443,6 +443,7 @@ export const DISPATCH_RULES = [
                 unitType: "discuss-milestone",
                 unitId: mid,
                 prompt: await buildDiscussMilestonePrompt(mid, midTitle, basePath, structuredQuestionsAvailable, { headless: !!process.env.GSD_HEADLESS }),
+                pauseAfterDispatch: !process.env.GSD_HEADLESS,
             };
         },
     },
@@ -578,6 +579,7 @@ export const DISPATCH_RULES = [
                 unitType: "discuss-milestone",
                 unitId: mid,
                 prompt: await buildDiscussMilestonePrompt(mid, midTitle, basePath, structuredQuestionsAvailable, { headless: !!process.env.GSD_HEADLESS }),
+                pauseAfterDispatch: !process.env.GSD_HEADLESS,
             };
         },
     },
@@ -617,6 +619,7 @@ export const DISPATCH_RULES = [
                 unitType: "discuss-project",
                 unitId: "PROJECT",
                 prompt: await buildDiscussProjectPrompt(basePath, structuredQuestionsAvailable),
+                pauseAfterDispatch: !process.env.GSD_HEADLESS,
             };
         },
     },
@@ -642,6 +645,7 @@ export const DISPATCH_RULES = [
                 unitType: "discuss-requirements",
                 unitId: "REQUIREMENTS",
                 prompt: await buildDiscussRequirementsPrompt(basePath, structuredQuestionsAvailable),
+                pauseAfterDispatch: !process.env.GSD_HEADLESS,
             };
         },
     },
@@ -757,6 +761,7 @@ export const DISPATCH_RULES = [
                 unitType: "discuss-milestone",
                 unitId: mid,
                 prompt: await buildDiscussMilestonePrompt(mid, midTitle, basePath, structuredQuestionsAvailable, { headless: !!process.env.GSD_HEADLESS }),
+                pauseAfterDispatch: !process.env.GSD_HEADLESS,
             };
         },
     },

package/dist/resources/extensions/gsd/auto-post-unit.js

@@ -32,7 +32,7 @@ import { isDbAvailable, getDbPath, refreshOpenDatabaseFromDisk, getTask, getSlic
 import { renderPlanCheckboxes, renderRoadmapFromDb } from "./markdown-renderer.js";
 import { parseRoadmap as parseLegacyRoadmap } from "./parsers-legacy.js";
 import { consumeSignal } from "./session-status-io.js";
-import { checkPostUnitHooks, isRetryPending, consumeRetryTrigger, persistHookState, resolveHookArtifactPath, } from "./post-unit-hooks.js";
+import { checkPostUnitHooks, consumeHookFailure, isRetryPending, consumeRetryTrigger, consumeGateBlock, persistHookState, resolveHookArtifactPath, } from "./post-unit-hooks.js";
 import { hasPendingCaptures, loadPendingCaptures, revertExecutorResolvedCaptures } from "./captures.js";
 import { debugLog } from "./debug-logger.js";
 import { runSafely } from "./auto-utils.js";
@@ -1860,18 +1860,25 @@ export async function postUnitPostVerification(pctx) {
     // ── Post-unit hooks ──
     if (s.currentUnit && !s.stepMode) {
         const hookUnit = checkPostUnitHooks(s.currentUnit.type, s.currentUnit.id, s.basePath);
+        persistHookState(s.basePath);
         if (hookUnit) {
             if (s.currentUnit) {
                 await closeoutUnit(ctx, s.basePath, s.currentUnit.type, s.currentUnit.id, s.currentUnit.startedAt, buildSnapshotOpts(s.currentUnit.type, s.currentUnit.id));
             }
-            persistHookState(s.basePath);
             return enqueueSidecar(s, ctx, { kind: "hook", unitType: hookUnit.unitType, unitId: hookUnit.unitId, prompt: hookUnit.prompt, model: hookUnit.model }, { hookName: hookUnit.hookName });
         }
+        const hookFailure = consumeHookFailure();
+        if (hookFailure) {
+            ctx.ui.notify(`Post-unit hook ${hookFailure.hookName} failed for ${hookFailure.unitId}: ${hookFailure.reason}. Pausing auto-mode.`, "warning");
+            await pauseAuto(ctx, pi);
+            return "stopped";
+        }
         // Check if a hook requested a retry of the trigger unit
         if (isRetryPending()) {
             const trigger = consumeRetryTrigger();
             if (trigger) {
-                ctx.ui.notify(`Hook requested retry of ${trigger.unitType} ${trigger.unitId} — resetting task state.`, "info");
+                persistHookState(s.basePath);
+                ctx.ui.notify(`Hook requested retry of ${trigger.unitType} ${trigger.unitId} — resetting trigger unit state.`, "info");
                 await s.orchestration?.retryActiveUnit({
                     unitType: trigger.unitType,
                     unitId: trigger.unitId,
@@ -1918,6 +1925,17 @@ export async function postUnitPostVerification(pctx) {
                 // Fall through to normal dispatch — deriveState will re-derive the unit
             }
         }
+        const gateBlock = consumeGateBlock();
+        if (gateBlock) {
+            persistHookState(s.basePath);
+            const verdict = gateBlock.verdict ? ` verdict=${gateBlock.verdict};` : "";
+            const artifact = gateBlock.artifact ? ` artifact=${gateBlock.artifact};` : "";
+            const message = `Post-unit gate "${gateBlock.hookName}" blocked ${gateBlock.triggerUnitType} ${gateBlock.triggerUnitId}:` +
+                `${verdict}${artifact} ${gateBlock.reason}. Run /gsd status to inspect, then /gsd auto after recovery.`;
+            ctx.ui.notify(message, "warning");
+            await pauseAuto(ctx, pi);
+            return "stopped";
+        }
     }
     // ── Fast-path stop detection (#3487) ──
     // Before waiting for triage, check if any PENDING captures contain explicit

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

@@ -30,6 +30,7 @@ import { classifyProject } from "./detection.js";
 import { hasBrowserRequiredText } from "./browser-evidence.js";
 import { debugLog } from "./debug-logger.js";
 import { buildSkillActivationBlock, buildSkillDiscoveryVars } from "./skill-activation.js";
+import { findMilestoneIds } from "./milestone-ids.js";
 export { buildSkillActivationBlock, buildSkillDiscoveryVars };
 // ─── Preamble Cap ─────────────────────────────────────────────────────────────
 /**
@@ -1270,7 +1271,7 @@ export async function checkNeedsRunUat(base, mid, state, prefs) {
                     if (hasVerdict(uatContent))
                         continue;
                     // Also check the ASSESSMENT file — the run-uat prompt writes the verdict
-                    // there (via gsd_summary_save artifact_type:"ASSESSMENT"), not into the
+                    // there (via gsd_uat_result_save), not into the
                     // UAT spec file. Without this check the unit re-dispatches indefinitely.
                     const assessmentFile = resolveSliceFile(base, mid, sid, "ASSESSMENT");
                     if (assessmentFile) {
@@ -1325,21 +1326,44 @@ export async function checkNeedsRunUat(base, mid, state, prefs) {
     }
     return null;
 }
-// ─── Prompt Builders ──────────────────────────────────────────────────────
-/**
- * Build a prompt for the discuss-milestone unit type.
- * Loads the guided-discuss-milestone template and inlines the CONTEXT-DRAFT
- * as a seed when present. The discussion agent interviews the user, writes
- * a full CONTEXT.md, and the phase transitions to pre-planning automatically.
- */
-export async function buildDiscussMilestonePrompt(mid, midTitle, base, structuredQuestionsAvailable = "false", { headless = false } = {}) {
-    const discussTemplates = inlineTemplate("context", "Context");
+export async function buildDiscussMilestoneInlinedContext(mid, base) {
+    const inlined = [];
+    const roadmapInline = await inlineFileOptional(resolveMilestoneFile(base, mid, "ROADMAP"), relMilestoneFile(base, mid, "ROADMAP"), "Milestone Roadmap");
+    if (roadmapInline)
+        inlined.push(roadmapInline);
+    const contextInline = await inlineFileOptional(resolveMilestoneFile(base, mid, "CONTEXT"), relMilestoneFile(base, mid, "CONTEXT"), "Milestone Context");
+    if (contextInline)
+        inlined.push(contextInline);
+    const researchInline = await inlineFileOptional(resolveMilestoneFile(base, mid, "RESEARCH"), relMilestoneFile(base, mid, "RESEARCH"), "Milestone Research");
+    if (researchInline)
+        inlined.push(researchInline);
+    const decisionsPath = resolveGsdRootFile(base, "DECISIONS");
+    if (existsSync(decisionsPath)) {
+        const decisionsContent = await loadFile(decisionsPath);
+        if (decisionsContent) {
+            inlined.push(`### Decisions Register\nSource: \`${relGsdRootFile("DECISIONS")}\`\n\n${decisionsContent.trim()}`);
+        }
+    }
+    const milestoneIds = findMilestoneIds(base);
+    const currentIndex = milestoneIds.indexOf(mid);
+    const priorMilestoneIds = currentIndex >= 0 ? milestoneIds.slice(0, currentIndex) : milestoneIds;
+    for (const priorMid of priorMilestoneIds) {
+        const summaryInline = await inlineFileOptional(resolveMilestoneFile(base, priorMid, "SUMMARY"), relMilestoneFile(base, priorMid, "SUMMARY"), `${priorMid} Prior Milestone Summary`);
+        if (summaryInline)
+            inlined.push(summaryInline);
+    }
+    return inlined.length > 0
+        ? `## Inlined Context (preloaded — do not re-read these files)\n\n${inlined.join("\n\n---\n\n")}`
+        : "## Inlined Context\n\n_(no milestone context files found yet — go in blind and ask broad questions)_";
+}
+export async function buildDiscussMilestonePrompt(mid, midTitle, base, structuredQuestionsAvailable = "false", { headless = false, commitInstruction = "Do not commit planning artifacts — .gsd/ is managed externally.", fastPathInstruction = "", includeDraftSeed = true, includeContextMode = true, } = {}) {
+    const contextTemplate = inlineTemplate("context", "Context");
     if (headless) {
         const roadmapPath = resolveMilestoneFile(base, mid, "ROADMAP");
         const roadmapContent = roadmapPath ? await loadFile(roadmapPath) : null;
         return loadPrompt("discuss-headless", {
             seedContext: roadmapContent ?? "",
-            inlinedTemplates: discussTemplates,
+            inlinedTemplates: contextTemplate,
             workingDirectory: base,
             milestoneId: mid,
             contextPath: relMilestoneFile(base, mid, "CONTEXT"),
@@ -1347,24 +1371,28 @@ export async function buildDiscussMilestonePrompt(mid, midTitle, base, structure
             multiMilestoneCommitInstruction: "Do not commit planning artifacts — .gsd/ is managed externally.",
         });
     }
-    const contextModeInstructions = renderContextModeForPrompt("discuss-milestone", base);
+    const rawInlinedContext = await buildDiscussMilestoneInlinedContext(mid, base);
+    const cappedInlinedContext = capPreamble(rawInlinedContext);
+    const discussTemplates = [cappedInlinedContext, contextTemplate].join("\n\n---\n\n");
     const basePrompt = loadPrompt("guided-discuss-milestone", {
         workingDirectory: base,
         milestoneId: mid,
         milestoneTitle: midTitle,
         inlinedTemplates: discussTemplates,
         structuredQuestionsAvailable,
-        commitInstruction: "Do not commit planning artifacts — .gsd/ is managed externally.",
-        fastPathInstruction: "",
+        commitInstruction,
+        fastPathInstruction,
     });
-    const promptWithContextMode = prependContextModeToBlock("discuss-milestone", base, basePrompt);
+    const promptWithContextMode = includeContextMode
+        ? prependContextModeToBlock("discuss-milestone", base, basePrompt)
+        : basePrompt;
     // If a CONTEXT-DRAFT.md exists, append it as seed material
     const draftPath = resolveMilestoneFile(base, mid, "CONTEXT-DRAFT");
     const draftContent = draftPath ? await loadFile(draftPath) : null;
-    if (draftContent) {
+    if (includeDraftSeed && draftContent) {
         return `${promptWithContextMode}\n\n## Prior Discussion (Draft Seed)\n\nThe following draft was captured from a prior multi-milestone discussion. Use it as seed material — the user has already provided this context. Start with a brief reflection on what the draft covers, then probe for any gaps or open questions before writing the full CONTEXT.md.\n\n${draftContent}`;
     }
-    return contextModeInstructions ? promptWithContextMode : basePrompt;
+    return promptWithContextMode;
 }
 /**
  * Build a prompt for the workflow-preferences unit type (deep mode).
@@ -2540,17 +2568,26 @@ export async function buildValidateMilestonePrompt(mid, midTitle, base, level) {
         if (isDbAvailable()) {
             const milestone = getMilestone(mid);
             if (milestone) {
+                const escapeCell = (value) => value.replace(/[\\|]/g, (char) => `\\${char}`).replace(/\r?\n/g, " ");
                 const classes = [];
                 if (milestone.verification_contract)
-                    classes.push(`- **Contract:** ${milestone.verification_contract}`);
+                    classes.push(`| Contract | ${escapeCell(milestone.verification_contract)} |`);
                 if (milestone.verification_integration)
-                    classes.push(`- **Integration:** ${milestone.verification_integration}`);
+                    classes.push(`| Integration | ${escapeCell(milestone.verification_integration)} |`);
                 if (milestone.verification_operational)
-                    classes.push(`- **Operational:** ${milestone.verification_operational}`);
+                    classes.push(`| Operational | ${escapeCell(milestone.verification_operational)} |`);
                 if (milestone.verification_uat)
-                    classes.push(`- **UAT:** ${milestone.verification_uat}`);
+                    classes.push(`| UAT | ${escapeCell(milestone.verification_uat)} |`);
                 if (classes.length > 0) {
-                    const verificationClasses = `### Verification Classes (from planning)\n\nThese verification tiers were defined during milestone planning. Each non-empty class must be checked for evidence during validation.\n\n${classes.join("\n")}`;
+                    const verificationClasses = [
+                        "### Verification Classes (from planning)",
+                        "",
+                        "These verification tiers were defined during milestone planning. Every row in this table must appear in `verificationClasses` with the same canonical class name.",
+                        "",
+                        "| Class | Planned Check |",
+                        "| --- | --- |",
+                        ...classes,
+                    ].join("\n");
                     inlined.push(verificationClasses);
                     trackPromptContext(contextTelemetry, "verification-classes", "inline", verificationClasses);
                 }

package/dist/resources/extensions/gsd/auto-runtime-state.js

@@ -20,6 +20,9 @@ export function isAutoActive() {
 export function isAutoPaused() {
     return autoSession.paused;
 }
+export function isAutoCompletionStopInProgress() {
+    return autoSession.completionStopInProgress;
+}
 export function markToolStart(toolCallId, toolName) {
     markTrackedToolStart(toolCallId, autoSession.active, toolName);
 }

package/dist/resources/extensions/gsd/auto-tool-tracking.js

@@ -83,7 +83,7 @@ export function clearInFlightTools() {
  * from the tool handler. When these errors occur, retrying the same unit will
  * produce the same failure, so the retry loop must be broken.
  */
-const TOOL_INVOCATION_ERROR_RE = /Validation failed for tool|Expected ',' or '\}'(?: after property value)?(?: in JSON)?|Unexpected end of JSON|Unexpected token.*in JSON|does not provide an export named|Named export .* not found|Cannot find module|ERR_MODULE_NOT_FOUND|ERR_MODULE_NOT_EXPORTED|ERR_PACKAGE_PATH_NOT_EXPORTED/i;
+const TOOL_INVOCATION_ERROR_RE = /Validation failed for tool|Input validation error|Invalid arguments for tool|MCP error -32602|No such tool available|Expected ',' or '\}'(?: after property value)?(?: in JSON)?|Unexpected end of JSON|Unexpected token.*in JSON|does not provide an export named|Named export .* not found|Cannot find module|ERR_MODULE_NOT_FOUND|ERR_MODULE_NOT_EXPORTED|ERR_PACKAGE_PATH_NOT_EXPORTED/i;
 const DETERMINISTIC_POLICY_ERROR_RE = /(?:^|\b)(?:HARD BLOCK:|Blocked: \/gsd queue is a planning tool|Direct writes to \.gsd\/STATE\.md and \.gsd\/gsd\.db are blocked|This is a mechanical gate)/i;
 /**
  * Returns true if the error message indicates a deterministic invocation or

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

@@ -1774,10 +1774,17 @@ export function createWiredAutoOrchestrationModule(ctx, pi, dispatchBasePath, ru
             async reconcileBeforeDispatch() {
                 const activeBasePath = getLiveDispatchBasePath();
                 const result = await reconcileBeforeDispatch(activeBasePath);
-                if (result.blockers.length > 0) {
+                // Failure-path summaries written by gsd_summary_save create
+                // artifact-db-status-divergence blockers for tasks that are still
+                // pending (gsd_task_complete never ran). These tasks can still be
+                // dispatched and the drift self-heals once they complete successfully.
+                const hardBlockers = result.blockers.filter((b) => !b.includes("has SUMMARY artifact while DB status is") &&
+                    !b.includes("has SUMMARY on disk while DB status is") &&
+                    !b.includes("has task SUMMARY artifacts but no DB tasks"));
+                if (hardBlockers.length > 0) {
                     return {
                         ok: false,
-                        reason: result.blockers[0],
+                        reason: hardBlockers[0],
                         stateSnapshot: result.stateSnapshot,
                     };
                 }

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

@@ -788,7 +788,7 @@ export function registerDbTools(pi) {
                 recommendation: Type.String({ description: "Option id the executor recommends." }),
                 recommendationRationale: Type.String({ description: "Why the recommendation — 1–2 sentences." }),
                 continueWithDefault: Type.Boolean({
-                    description: "When true, loop continues (artifact logged for later review). When false, auto-mode pauses until the user resolves via /gsd escalate resolve.",
+                    description: "When true, the recommendation is recorded as the default, but auto-mode still pauses until the user resolves via /gsd escalate resolve.",
                 }),
             }, { description: "ADR-011 Phase 2: optional escalation payload. Only honored when phases.mid_execution_escalation is true." })),
             verificationEvidence: Type.Optional(Type.Array(Type.Object({
@@ -829,7 +829,7 @@ export function registerDbTools(pi) {
             sliceTitle: Type.String({ description: "Title of the slice" }),
             oneLiner: Type.String({ description: "One-line summary of what the slice accomplished" }),
             narrative: Type.String({ description: "Detailed narrative of what happened across all tasks" }),
-            verification: Type.String({ description: "What was verified across all tasks" }),
+            verification: Type.Optional(Type.String({ description: "What was verified across all tasks — if omitted, summary records verification as passed without detail." })),
             uatContent: Type.String({ description: "UAT test content (markdown body)" }),
             // ── Enrichment metadata (optional — defaults to empty) ────────────
             deviations: Type.Optional(Type.String({ description: "Deviations from the slice plan, or 'None.'" })),
@@ -1010,7 +1010,7 @@ export function registerDbTools(pi) {
         promptGuidelines: [
             "Use gsd_validate_milestone when all slices are done and the milestone needs validation before completion.",
             "Parameters: milestoneId, verdict, remediationRound, successCriteriaChecklist, sliceDeliveryAudit, crossSliceIntegration, requirementCoverage, verificationClasses (optional), verdictRationale, remediationPlan (optional).",
-            "If verification classes were planned, verificationClasses must include canonical class rows using the exact class names Contract, Integration, Operational, and UAT when present in planning.",
+            "If verification classes were planned, verificationClasses must be a complete canonical table with one row for every applicable planned class using the exact class names Contract, Integration, Operational, and UAT. Do not submit a partial table.",
             "Planned verification text marked as none/not required/not applicable/N/A (including suffixed variants such as 'not required - backend-only') is treated as not applicable and does not require a class row.",
             "If verdict is 'needs-remediation', also provide remediationPlan and use gsd_reassess_roadmap to add remediation slices to the roadmap.",
             "On success, returns validationPath where VALIDATION.md was written.",
@@ -1023,7 +1023,7 @@ export function registerDbTools(pi) {
             sliceDeliveryAudit: Type.String({ description: "Markdown table auditing each slice's claimed vs delivered output" }),
             crossSliceIntegration: Type.String({ description: "Markdown describing any cross-slice boundary mismatches" }),
             requirementCoverage: Type.String({ description: "Markdown describing any unaddressed requirements" }),
-            verificationClasses: Type.Optional(Type.String({ description: "Markdown describing verification class compliance and gaps using canonical class names (Contract, Integration, Operational, UAT) for each applicable planned class" })),
+            verificationClasses: Type.Optional(Type.String({ description: "Complete markdown table describing verification class compliance and gaps; include one canonical row for every applicable planned class (Contract, Integration, Operational, UAT)" })),
             verdictRationale: Type.String({ description: "Why this verdict was chosen" }),
             remediationPlan: Type.Optional(Type.String({ description: "Remediation plan (required if verdict is needs-remediation)" })),
         }),

package/dist/resources/extensions/gsd/bootstrap/register-hooks.js

@@ -11,7 +11,7 @@ import { canonicalToolName, clearDiscussionFlowState, isDepthConfirmationAnswer,
 import { resolveManifest } from "../unit-context-manifest.js";
 import { isBlockedStateFile, isBashWriteToStateFile, BLOCKED_WRITE_ERROR } from "../write-intercept.js";
 import { loadFile, saveFile, formatContinue } from "../files.js";
-import { clearToolInvocationError, getAutoRuntimeSnapshot, isAutoActive, isAutoPaused, markToolEnd, markToolStart, recordToolInvocationError } from "../auto-runtime-state.js";
+import { clearToolInvocationError, getAutoRuntimeSnapshot, isAutoActive, isAutoCompletionStopInProgress, isAutoPaused, markToolEnd, markToolStart, recordToolInvocationError } from "../auto-runtime-state.js";
 import { checkToolCallLoop, resetToolCallLoopGuard } from "./tool-call-loop-guard.js";
 import { maybePauseAutoForApprovalGate, resetPendingGatePauseGuard } from "./pending-gate-pause.js";
 import { saveActivityLog } from "../activity-log.js";
@@ -424,8 +424,9 @@ export function registerHooks(pi, ecosystemHandlers) {
     registerPlanMilestoneSchemaRecovery(pi);
     pi.on("session_start", async (_event, ctx) => {
         const basePath = contextBasePath(ctx);
+        const preserveCloseoutSurface = isAutoCompletionStopInProgress();
         initSessionNotifications(ctx);
-        if (!isAutoActive()) {
+        if (!isAutoActive() && !preserveCloseoutSurface) {
             const { initHealthWidget } = await import("../health-widget.js");
             initHealthWidget(ctx);
         }
@@ -445,14 +446,17 @@ export function registerHooks(pi, ecosystemHandlers) {
             process.env.GSD_SHOW_TOKEN_COST = prefs?.preferences.show_token_cost ? "1" : "";
         }
         catch { /* non-fatal */ }
-        await installWelcomeHeader(ctx);
+        if (!preserveCloseoutSurface) {
+            await installWelcomeHeader(ctx);
+        }
         await loadToolApiKeysForSession();
-        if (isAutoActive()) {
+        if (isAutoActive() || preserveCloseoutSurface) {
             ctx.ui.setWidget("gsd-health", undefined);
         }
     });
     pi.on("session_switch", async (_event, ctx) => {
         const basePath = contextBasePath(ctx);
+        const preserveCloseoutSurface = isAutoCompletionStopInProgress();
         initSessionNotifications(ctx);
         resetWriteGateState(basePath);
         resetToolCallLoopGuard();
@@ -464,7 +468,7 @@ export function registerHooks(pi, ecosystemHandlers) {
         await applyCompactionThresholdOverride(ctx);
         await prepareWorkflowMcpForHookContext(ctx, basePath);
         await loadToolApiKeysForSession();
-        if (!isAutoActive()) {
+        if (!isAutoActive() && !preserveCloseoutSurface) {
             ctx.ui.setWidget("gsd-progress", undefined);
             ctx.ui.setWidget("gsd-outcome", undefined);
             const { initHealthWidget } = await import("../health-widget.js");

package/dist/resources/extensions/gsd/browser-evidence.js

@@ -1,17 +1,44 @@
 // Project/App: gsd-pi
 // File Purpose: Shared browser-observable UAT requirement and evidence detection.
-export const BROWSER_REQUIREMENT_RE = /\b(?:browser|file:\/\/|localhost|dom|localstorage|click(?:ing|ed)?|button|screenshot|snapshot|reload(?:ed)?|page refresh|user-visible|strikethrough|search box)\b/i;
+export const BROWSER_REQUIREMENT_RE = /\b(?:file:\/\/|localhost|playwright|chrome|screenshot|snapshot|browser_(?:assert|batch|find|verify|snapshot_refs))\b|\b(?:open|launch|navigate|load|visit|serve|start)\b.{0,80}\b(?:browser|page|localhost|file:\/\/)\b|\bbrowser\s+(?:check|session|test|uat|tool|automation|interaction|flow)\b/i;
 export const NO_BROWSER_EVIDENCE_RE = /\b(?:no|without|not|wasn'?t|isn'?t)\s+(?:automated\s+)?(?:live\s+)?browser(?:\s+(?:session|test|uat))?|\bno\s+automated\s+browser\b|\bnot\s+conducted\b/i;
 export const BROWSER_RUNTIME_RE = /\b(?:browser|playwright|chrome|camoufox|browser_(?:assert|batch|find|verify|snapshot_refs)|screenshot|snapshot|file:\/\/|localhost)\b/i;
 export const BROWSER_ACTION_RE = /\b(?:open(?:ed)?|navigate(?:d)?|click(?:ed)?|type(?:d)?|reload(?:ed)?|capture(?:d)?|screenshot|snapshot)\b/i;
 export const BROWSER_ASSERTION_RE = /\b(?:assert(?:ed|ion)?|observed|confirmed|verified|expected|visible|text|count|label|strikethrough|localstorage|screenshot|snapshot|passed)\b/i;
+const NON_REQUIREMENT_BROWSER_HEADING_RE = /^(?:not\s+proven|not\s+covered|out\s+of\s+scope|deferred|follow-?ups?|known\s+limitations|notes\s+for\s+tester)\b/i;
+const NON_REQUIREMENT_BROWSER_LINE_RE = /\b(?:deferred|not\s+proven|not\s+covered|out\s+of\s+scope|future\s+slice|follow-?up|no\s+(?:live\s+)?browser|without\s+(?:a\s+)?browser|not\s+(?:a\s+)?browser)\b/i;
 export function compactTextParts(parts) {
     return parts.flatMap((part) => Array.isArray(part) ? part : [part])
         .filter((part) => typeof part === "string" && part.trim().length > 0)
         .join("\n");
 }
 export function hasBrowserRequiredText(text) {
-    return BROWSER_REQUIREMENT_RE.test(text);
+    let inNonRequirementSection = false;
+    let nonRequirementDepth = 0;
+    for (const line of text.split(/\r?\n/)) {
+        const headingMatch = line.match(/^(#{1,6})\s+(.+?)\s*$/);
+        if (headingMatch) {
+            const depth = headingMatch[1].length;
+            const title = headingMatch[2] ?? "";
+            // Only update section context when at the same or higher level than the
+            // heading that opened the non-requirement zone. A sub-heading deeper than
+            // the opening heading must not escape or re-enter the zone on its own.
+            if (!inNonRequirementSection || depth <= nonRequirementDepth) {
+                inNonRequirementSection = NON_REQUIREMENT_BROWSER_HEADING_RE.test(title);
+                nonRequirementDepth = inNonRequirementSection ? depth : 0;
+            }
+            // Check the heading title itself — section state is already updated, so
+            // we correctly skip headings that opened a non-requirement zone.
+            if (!inNonRequirementSection && BROWSER_REQUIREMENT_RE.test(title))
+                return true;
+            continue;
+        }
+        if (inNonRequirementSection || NON_REQUIREMENT_BROWSER_LINE_RE.test(line))
+            continue;
+        if (BROWSER_REQUIREMENT_RE.test(line))
+            return true;
+    }
+    return false;
 }
 export function hasBrowserEvidenceText(text) {
     if (!text.trim())

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

@@ -266,8 +266,8 @@ Examples:
         await handleInspect(ctx);
         return true;
     }
-    if (trimmed === "update" || trimmed === "upgrade") {
-        await handleUpdate(ctx);
+    if (trimmed === "update" || trimmed.startsWith("update ") || trimmed === "upgrade" || trimmed.startsWith("upgrade ")) {
+        await handleUpdate(ctx, trimmed.replace(/^(?:update|upgrade)\s*/, "").trim());
         return true;
     }
     if (trimmed === "fast" || trimmed.startsWith("fast ")) {