gsd-pi 2.81.0 → 2.82.0-dev.20138ae42

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

@@ -1,7 +1,6 @@
 // GSD-2 + src/resources/extensions/gsd/auto-dashboard.ts - Auto-mode progress widget rendering and dashboard helpers.
-import { getCurrentBranch } from "./worktree.js";
 import { getActiveHook } from "./post-unit-hooks.js";
-import { getLedger, getProjectTotals } from "./metrics.js";
+import { getLedger } from "./metrics.js";
 import { getErrorMessage } from "./error-utils.js";
 import { nativeIsRepo } from "./native-git-bridge.js";
 import { isDbAvailable, getMilestoneSlices, getSliceTasks } from "./gsd-db.js";
@@ -10,15 +9,12 @@ import { execFileSync } from "node:child_process";
 import { truncateToWidth, visibleWidth } from "@gsd/pi-tui";
 import { makeUI } from "../shared/tui.js";
 import { GLYPH, INDENT } from "../shared/mod.js";
+import { padRightVisible, renderFrame, renderProgressBar, rightAlign, wrapVisibleText } from "./tui/render-kit.js";
 import { computeProgressScore } from "./progress-score.js";
-import { getActiveWorktreeName } from "./worktree-command.js";
 import { getGlobalGSDPreferencesPath, getProjectGSDPreferencesPath, parsePreferencesMarkdown, } from "./preferences.js";
-import { resolveServiceTierIcon, getEffectiveServiceTier } from "./service-tier.js";
 import { parseUnitId } from "./unit-id.js";
-import { formatRtkSavingsLabel, getRtkSessionSavings, } from "../shared/rtk-session-stats.js";
 import { logWarning } from "./workflow-logger.js";
 import { formattedShortcutPair } from "./shortcut-defs.js";
-import { homedir } from "node:os";
 import { readUnitRuntimeRecord } from "./unit-runtime.js";
 // ─── UAT Slice Extraction ─────────────────────────────────────────────────────
 /**
@@ -31,6 +27,19 @@ export function extractUatSliceId(unitId) {
         return slice;
     return null;
 }
+export function buildPhaseHandoffOutcome(input) {
+    const phase = unitPhaseLabel(input.unitType);
+    const detail = extractLastAssistantSummary(input.agentEndMessages) ??
+        `Completed ${unitVerb(input.unitType)} ${input.unitId}.`;
+    return {
+        status: "complete",
+        title: `${phase} complete`,
+        detail,
+        unitLabel: `${unitVerb(input.unitType)} ${input.unitId}`,
+        nextAction: "Preparing the next phase. Review this handoff while the next session starts.",
+        commands: ["/gsd status for overview", "/gsd visualize to inspect", "/gsd notifications for history"],
+    };
+}
 // ─── Unit Description Helpers ─────────────────────────────────────────────────
 export function unitVerb(unitType) {
     if (unitType.startsWith("hook/"))
@@ -497,53 +506,11 @@ export function updateProgressWidget(ctx, unitType, unitId, state, accessors, ti
     if (mid) {
         updateSliceProgressCache(accessors.getBasePath(), mid.id, slice?.id);
     }
-    // Cache git branch at widget creation time (not per render)
-    let cachedBranch = null;
-    try {
-        cachedBranch = getCurrentBranch(accessors.getBasePath());
-    }
-    catch (err) { /* not in git repo */
-        logWarning("dashboard", `git branch detection failed: ${err instanceof Error ? err.message : String(err)}`);
-    }
-    // Cache short pwd (last 2 path segments only) + worktree/branch info
-    let widgetPwd;
-    {
-        let fullPwd = process.cwd();
-        const widgetHome = homedir();
-        if (widgetHome && (fullPwd === widgetHome || fullPwd.startsWith(widgetHome + "/") || fullPwd.startsWith(widgetHome + "\\"))) {
-            fullPwd = `~${fullPwd.slice(widgetHome.length)}`;
-        }
-        const parts = fullPwd.split("/");
-        widgetPwd = parts.length > 2 ? parts.slice(-2).join("/") : fullPwd;
-    }
-    const worktreeName = getActiveWorktreeName();
-    if (worktreeName && cachedBranch) {
-        widgetPwd = `${widgetPwd} (\u2387 ${cachedBranch})`;
-    }
-    else if (cachedBranch) {
-        widgetPwd = `${widgetPwd} (${cachedBranch})`;
-    }
-    // Pre-fetch last commit for display
-    refreshLastCommit(accessors.getBasePath());
-    // Cache the effective service tier at widget creation time (reads preferences)
-    const effectiveServiceTier = getEffectiveServiceTier();
     ctx.ui.setWidget("gsd-progress", (tui, theme) => {
         let pulseBright = true;
         let cachedLines;
         let cachedWidth;
-        let cachedRtkLabel;
         let cachedRuntimeRecord = null;
-        const refreshRtkLabel = () => {
-            try {
-                const sessionId = ctx.sessionManager.getSessionId();
-                const savings = sessionId ? getRtkSessionSavings(accessors.getBasePath(), sessionId) : null;
-                cachedRtkLabel = formatRtkSavingsLabel(savings);
-            }
-            catch (err) {
-                logWarning("dashboard", `RTK savings lookup failed: ${err instanceof Error ? err.message : String(err)}`);
-                cachedRtkLabel = null;
-            }
-        };
         const refreshRuntimeRecord = () => {
             try {
                 cachedRuntimeRecord = readUnitRuntimeRecord(accessors.getBasePath(), unitType, unitId);
@@ -552,7 +519,6 @@ export function updateProgressWidget(ctx, unitType, unitId, state, accessors, ti
                 cachedRuntimeRecord = null;
             }
         };
-        refreshRtkLabel();
         refreshRuntimeRecord();
         const pulseTimer = setInterval(() => {
             pulseBright = !pulseBright;
@@ -568,7 +534,6 @@ export function updateProgressWidget(ctx, unitType, unitId, state, accessors, ti
                 if (mid) {
                     updateSliceProgressCache(accessors.getBasePath(), mid.id, slice?.id);
                 }
-                refreshRtkLabel();
                 refreshRuntimeRecord();
                 cachedLines = undefined;
             }
@@ -635,44 +600,6 @@ export function updateProgressWidget(ctx, unitType, unitId, state, accessors, ti
                         lines.push(`${pad}  ${signalStr}`);
                     }
                 }
-                // ── Gather stats (needed by multiple modes) ─────────────────────
-                const cmdCtx = accessors.getCmdCtx();
-                let totalInput = 0;
-                let totalCacheRead = 0;
-                if (cmdCtx) {
-                    for (const entry of cmdCtx.sessionManager.getEntries()) {
-                        if (entry.type === "message") {
-                            const msgEntry = entry;
-                            if (msgEntry.message?.role === "assistant") {
-                                const u = msgEntry.message.usage;
-                                if (u) {
-                                    totalInput += u.input || 0;
-                                    totalCacheRead += u.cacheRead || 0;
-                                }
-                            }
-                        }
-                    }
-                }
-                const mLedger = getLedger();
-                const autoTotals = mLedger ? getProjectTotals(mLedger.units) : null;
-                const cumulativeCost = autoTotals?.cost ?? 0;
-                const cxUsage = cmdCtx?.getContextUsage?.();
-                const cxWindow = cxUsage?.contextWindow ?? cmdCtx?.model?.contextWindow ?? 0;
-                const cxPctVal = cxUsage?.percent ?? 0;
-                const cxPct = cxUsage?.percent !== null ? cxPctVal.toFixed(1) : "?";
-                // Model display — prefer dispatched model ID (set after selectAndApplyModel
-                // + hook overrides) over cmdCtx?.model which can be stale (#2899).
-                const dispatchedModelId = accessors.getCurrentDispatchedModelId();
-                const modelId = dispatchedModelId
-                    ? dispatchedModelId.split("/").slice(1).join("/") || dispatchedModelId
-                    : (cmdCtx?.model?.id ?? "");
-                const modelProvider = dispatchedModelId
-                    ? dispatchedModelId.split("/")[0] || ""
-                    : (cmdCtx?.model?.provider ?? "");
-                const tierIcon = resolveServiceTierIcon(effectiveServiceTier, modelId);
-                const modelDisplay = (modelProvider && modelId
-                    ? `${modelProvider}/${modelId}`
-                    : modelId) + (tierIcon ? ` ${tierIcon}` : "");
                 // ── Mode: off — return empty ──────────────────────────────────
                 if (widgetMode === "off") {
                     cachedLines = [];
@@ -686,7 +613,7 @@ export function updateProgressWidget(ctx, unitType, unitId, state, accessors, ti
                     cachedWidth = width;
                     return lines;
                 }
-                // ── Mode: small — header + progress bar + compact stats ───────
+                // ── Mode: small — header + active work progress ───────────────
                 if (widgetMode === "small") {
                     lines.push("");
                     // Action line
@@ -698,10 +625,7 @@ export function updateProgressWidget(ctx, unitType, unitId, state, accessors, ti
                     if (shouldRenderRoadmapProgress(roadmapSlices)) {
                         const { done, total, activeSliceTasks } = roadmapSlices;
                         const barWidth = Math.max(6, Math.min(18, Math.floor(width * 0.25)));
-                        const pct = total > 0 ? done / total : 0;
-                        const filled = Math.round(pct * barWidth);
-                        const bar = theme.fg("success", "━".repeat(filled))
-                            + theme.fg("dim", "─".repeat(barWidth - filled));
+                        const bar = renderProgressBar(theme, done, total, barWidth);
                         let meta = `${theme.fg("text", `${done}`)}${theme.fg("dim", `/${total} slices`)}`;
                         if (activeSliceTasks && activeSliceTasks.total > 0) {
                             const tn = Math.min(activeSliceTasks.done + 1, activeSliceTasks.total);
@@ -709,20 +633,6 @@ export function updateProgressWidget(ctx, unitType, unitId, state, accessors, ti
                         }
                         lines.push(`${pad}${bar} ${meta}`);
                     }
-                    // Compact stats: cost + context only
-                    const smallStats = [];
-                    if (cumulativeCost)
-                        smallStats.push(theme.fg("warning", `$${cumulativeCost.toFixed(2)}`));
-                    const cxDisplay = `${cxPct}%ctx`;
-                    if (cxPctVal > 90)
-                        smallStats.push(theme.fg("error", cxDisplay));
-                    else if (cxPctVal > 70)
-                        smallStats.push(theme.fg("warning", cxDisplay));
-                    else
-                        smallStats.push(theme.fg("dim", cxDisplay));
-                    if (smallStats.length > 0) {
-                        lines.push(rightAlign("", smallStats.join(theme.fg("dim", "  ")), width));
-                    }
                     lines.push(...ui.bar());
                     cachedLines = lines;
                     cachedWidth = width;
@@ -730,11 +640,10 @@ export function updateProgressWidget(ctx, unitType, unitId, state, accessors, ti
                 }
                 // ── Mode: full — complete two-column layout ───────────────────
                 lines.push("");
-                // Context section: milestone + slice + model
+                // Context section: milestone + slice. Footer owns model/cost/context.
                 const hasContext = !!(mid || (slice && unitType !== "research-milestone" && unitType !== "plan-milestone"));
                 if (mid) {
-                    const modelTag = modelDisplay ? theme.fg("muted", `  ${modelDisplay}`) : "";
-                    lines.push(truncateToWidth(`${pad}${theme.fg("dim", mid.title)}${modelTag}`, width, "…"));
+                    lines.push(truncateToWidth(`${pad}${theme.fg("dim", mid.title)}`, width, "…"));
                 }
                 if (slice && unitType !== "research-milestone" && unitType !== "plan-milestone") {
                     lines.push(truncateToWidth(`${pad}${theme.fg("text", theme.bold(`${slice.id}: ${slice.title}`))}`, width, "…"));
@@ -759,10 +668,7 @@ export function updateProgressWidget(ctx, unitType, unitId, state, accessors, ti
                 if (shouldRenderRoadmapProgress(roadmapSlices)) {
                     const { done, total, activeSliceTasks } = roadmapSlices;
                     const barWidth = Math.max(6, Math.min(18, Math.floor(leftColWidth * 0.4)));
-                    const pct = total > 0 ? done / total : 0;
-                    const filled = Math.round(pct * barWidth);
-                    const bar = theme.fg("success", "━".repeat(filled))
-                        + theme.fg("dim", "─".repeat(barWidth - filled));
+                    const bar = renderProgressBar(theme, done, total, barWidth);
                     let meta = `${theme.fg("text", `${done}`)}${theme.fg("dim", `/${total} slices`)}`;
                     if (activeSliceTasks && activeSliceTasks.total > 0) {
                         const taskNum = isHook
@@ -818,7 +724,7 @@ export function updateProgressWidget(ctx, unitType, unitId, state, accessors, ti
                     if (maxRows > 0) {
                         lines.push("");
                         for (let i = 0; i < maxRows; i++) {
-                            const left = padToWidth(truncateToWidth(leftLines[i] ?? "", leftColWidth, "…"), leftColWidth);
+                            const left = padRightVisible(truncateToWidth(leftLines[i] ?? "", leftColWidth, "…"), leftColWidth);
                             const right = rightLines[i] ?? "";
                             lines.push(`${left}${right}`);
                         }
@@ -831,46 +737,8 @@ export function updateProgressWidget(ctx, unitType, unitId, state, accessors, ti
                             lines.push(truncateToWidth(l, width, "…"));
                     }
                 }
-                // ── Footer: simplified stats + pwd + last commit + hints ────────
+                // ── Auto controls. Footer owns cwd/branch/model/cost/context. ───
                 lines.push("");
-                {
-                    const sp = [];
-                    if (totalCacheRead + totalInput > 0) {
-                        const hitRate = Math.round((totalCacheRead / (totalCacheRead + totalInput)) * 100);
-                        const hitColor = hitRate >= 70 ? "success" : hitRate >= 40 ? "warning" : "error";
-                        sp.push(theme.fg(hitColor, `${hitRate}%hit`));
-                    }
-                    if (cumulativeCost)
-                        sp.push(theme.fg("warning", `$${cumulativeCost.toFixed(2)}`));
-                    const CX_BAR_WIDTH = 8;
-                    const cxBarFilled = Math.min(CX_BAR_WIDTH, Math.max(0, Math.round((cxPctVal / 100) * CX_BAR_WIDTH)));
-                    const cxBarColor = cxPctVal > 90 ? "error" : cxPctVal > 70 ? "warning" : "success";
-                    const cxBar = theme.fg(cxBarColor, "━".repeat(cxBarFilled)) +
-                        theme.fg("dim", "─".repeat(CX_BAR_WIDTH - cxBarFilled));
-                    const cxPctText = `${cxPct}%/${formatWidgetTokens(cxWindow)}`;
-                    const cxColorized = cxPctVal > 90
-                        ? theme.fg("error", cxPctText)
-                        : cxPctVal > 70
-                            ? theme.fg("warning", cxPctText)
-                            : cxPctText;
-                    sp.push(`${cxBar} ${cxColorized}`);
-                    const statsLine = sp.map(p => p.includes("\x1b[") ? p : theme.fg("dim", p))
-                        .join(theme.fg("dim", "  "));
-                    if (statsLine) {
-                        lines.push(rightAlign("", statsLine, width));
-                    }
-                    if (cachedRtkLabel) {
-                        lines.push(rightAlign("", theme.fg("dim", cachedRtkLabel), width));
-                    }
-                }
-                // Last commit info
-                const lastCommit = getLastCommit(accessors.getBasePath());
-                const maxCommitLen = 65;
-                const commitMsg = lastCommit
-                    ? lastCommit.message.length > maxCommitLen
-                        ? lastCommit.message.slice(0, maxCommitLen - 1) + "…"
-                        : lastCommit.message
-                    : "";
                 // Step-mode guidance — shown above keyboard hints when auto is paused
                 if (accessors.isStepMode()) {
                     lines.push(`${pad}${theme.fg("accent", "→")} ${theme.fg("dim", "Ctrl+N to advance to next step  ·  /gsd status for overview")}`);
@@ -881,16 +749,7 @@ export function updateProgressWidget(ctx, unitType, unitId, state, accessors, ti
                 hintParts.push(`${formattedShortcutPair("dashboard")} dashboard`);
                 hintParts.push(`${formattedShortcutPair("parallel")} parallel`);
                 const hintStr = theme.fg("dim", hintParts.join(" | "));
-                const commitStr = lastCommit
-                    ? theme.fg("dim", `${lastCommit.timeAgo} ago: ${commitMsg}`)
-                    : "";
-                const locationStr = theme.fg("dim", widgetPwd);
-                if (commitStr) {
-                    lines.push(rightAlign(`${pad}${locationStr} · ${commitStr}`, hintStr, width));
-                }
-                else {
-                    lines.push(rightAlign(`${pad}${locationStr}`, hintStr, width));
-                }
+                lines.push(rightAlign("", hintStr, width));
                 lines.push(...ui.bar());
                 cachedLines = lines;
                 cachedWidth = width;
@@ -908,18 +767,228 @@ export function updateProgressWidget(ctx, unitType, unitId, state, accessors, ti
         };
     });
 }
-// ─── Right-align Helper ───────────────────────────────────────────────────────
-/** Right-align helper: build a line with left content and right content. */
-function rightAlign(left, right, width) {
-    const leftVis = visibleWidth(left);
-    const rightVis = visibleWidth(right);
-    const gap = Math.max(1, width - leftVis - rightVis);
-    return truncateToWidth(left + " ".repeat(gap) + right, width, "…");
-}
-/** Pad a string with trailing spaces to fill exactly `colWidth` (ANSI-aware). */
-function padToWidth(s, colWidth) {
-    const vis = visibleWidth(s);
-    if (vis >= colWidth)
-        return truncateToWidth(s, colWidth, "…");
-    return s + " ".repeat(colWidth - vis);
+export function setCompletionProgressWidget(ctx, snapshot) {
+    if (!ctx.hasUI)
+        return;
+    ctx.ui.setWidget("gsd-outcome", undefined);
+    if (typeof ctx.ui?.setHeader === "function") {
+        ctx.ui.setHeader(() => ({
+            render() { return []; },
+            invalidate() { },
+        }));
+    }
+    if (typeof ctx.ui?.setStatus === "function") {
+        ctx.ui.setStatus("gsd-step", undefined);
+    }
+    ctx.ui.setWidget("gsd-progress", (_tui, theme) => ({
+        render(width) {
+            const ui = makeUI(theme, width);
+            const pad = INDENT.base;
+            const lines = [];
+            const contentWidth = Math.max(20, width - visibleWidth(pad));
+            const add = (line = "") => {
+                lines.push(line ? truncateToWidth(`${pad}${line}`, width, "…") : "");
+            };
+            const addSection = (label, value, indent = "") => {
+                const clean = normalizeRollupText(value);
+                if (!clean)
+                    return;
+                add(`${indent}${theme.fg("accent", label)} ${theme.fg("text", truncateToWidth(clean, contentWidth - indent.length - label.length - 1, "…"))}`);
+            };
+            const addList = (label, values, limit, indent = "") => {
+                const clean = (values ?? []).map(normalizeRollupText).filter((v) => !!v);
+                if (clean.length === 0)
+                    return;
+                const shown = clean.slice(0, limit);
+                const more = clean.length > shown.length ? ` (+${clean.length - shown.length} more)` : "";
+                add(`${indent}${theme.fg("accent", label)} ${theme.fg("text", truncateToWidth(shown.join("; ") + more, contentWidth - indent.length - label.length - 1, "…"))}`);
+            };
+            lines.push(...ui.bar());
+            const elapsed = formatAutoElapsed(snapshot.startedAt);
+            const heading = snapshot.allMilestonesComplete
+                ? "All milestones complete"
+                : snapshot.milestoneId
+                    ? `Milestone ${snapshot.milestoneId} roll-up`
+                    : "Milestone roll-up";
+            lines.push(rightAlign(`${pad}${theme.fg("accent", theme.bold(heading))}`, elapsed ? theme.fg("dim", elapsed) : "", width));
+            if (snapshot.milestoneTitle) {
+                add(theme.fg("text", snapshot.milestoneTitle));
+            }
+            lines.push("");
+            add(theme.fg("accent", "Outcome"));
+            addSection("", snapshot.oneLiner, "  ");
+            const changed = [
+                ...(snapshot.successCriteriaResults ? [snapshot.successCriteriaResults] : []),
+                ...(snapshot.requirementOutcomes ? [snapshot.requirementOutcomes] : []),
+                ...(snapshot.keyDecisions ?? []),
+            ].map(normalizeRollupText).filter((v) => !!v).slice(0, 4);
+            if (changed.length > 0) {
+                lines.push("");
+                add(theme.fg("accent", "What changed"));
+                for (const item of changed)
+                    add(`  - ${theme.fg("text", item)}`);
+            }
+            const verification = [
+                snapshot.definitionOfDoneResults,
+                snapshot.deviations ? `Deviations: ${snapshot.deviations}` : null,
+                snapshot.followUps ? `Follow-ups: ${snapshot.followUps}` : null,
+            ].map(normalizeRollupText).filter((v) => !!v);
+            if (verification.length > 0 || (snapshot.keyFiles?.length ?? 0) > 0) {
+                lines.push("");
+                add(theme.fg("accent", "Verification"));
+                for (const item of verification.slice(0, 3))
+                    add(`  - ${theme.fg("text", item)}`);
+                addList("Files:", snapshot.keyFiles, 4, "  ");
+            }
+            if ((snapshot.lessonsLearned?.length ?? 0) > 0) {
+                lines.push("");
+                addList("Lessons:", snapshot.lessonsLearned, 2);
+            }
+            const hasSliceTotals = typeof snapshot.completedSlices === "number" && typeof snapshot.totalSlices === "number" && snapshot.totalSlices > 0;
+            lines.push("");
+            const stats = [];
+            if (hasSliceTotals)
+                stats.push(theme.fg("success", `${snapshot.completedSlices}/${snapshot.totalSlices} slices`));
+            if (snapshot.unitCount > 0)
+                stats.push(theme.fg("dim", `${snapshot.unitCount} units`));
+            if (snapshot.totalTokens > 0)
+                stats.push(theme.fg("dim", `${formatWidgetTokens(snapshot.totalTokens)} tokens`));
+            if (snapshot.totalCost > 0)
+                stats.push(theme.fg("warning", `$${snapshot.totalCost.toFixed(2)}`));
+            if (typeof snapshot.cacheHitRate === "number") {
+                const hitColor = snapshot.cacheHitRate >= 70 ? "success" : snapshot.cacheHitRate >= 40 ? "warning" : "error";
+                stats.push(theme.fg(hitColor, `${Math.round(snapshot.cacheHitRate)}% cache hit`));
+            }
+            if (stats.length > 0) {
+                add(`${theme.fg("accent", "Run totals")} ${stats.join(theme.fg("dim", " · "))}`);
+            }
+            lines.push("");
+            const nextAction = snapshot.allMilestonesComplete
+                ? "Review the roll-up, then start a new milestone when ready."
+                : "Review the roll-up, inspect status, or continue to the next milestone.";
+            const commands = snapshot.allMilestonesComplete
+                ? ["/gsd status for overview", "/gsd visualize to inspect", "/gsd notifications for history", "/gsd start for new work"]
+                : ["/gsd status for overview", "/gsd visualize to inspect", "/gsd notifications for history", "/gsd auto for next milestone"];
+            add(`${theme.fg("success", "Next")} ${theme.fg("text", nextAction)}`);
+            add(theme.fg("dim", commands.join("  ·  ")));
+            const location = snapshot.basePath ? theme.fg("dim", snapshot.basePath) : "";
+            const reason = theme.fg("dim", snapshot.reason);
+            lines.push(rightAlign(`${pad}${truncateToWidth(location, Math.max(0, width - 32), "…")}`, reason, width));
+            lines.push(...ui.bar());
+            return lines;
+        },
+        invalidate() { },
+        dispose() { },
+    }));
+}
+export function setAutoOutcomeWidget(ctx, snapshot) {
+    if (!ctx.hasUI)
+        return;
+    ctx.ui.setWidget("gsd-outcome", (_tui, theme) => ({
+        render(width) {
+            const color = snapshot.status === "failed" || snapshot.status === "blocked"
+                ? "warning"
+                : snapshot.status === "complete"
+                    ? "success"
+                    : "borderAccent";
+            const icon = snapshot.status === "complete" ? "✓"
+                : snapshot.status === "failed" ? "x"
+                    : snapshot.status === "blocked" ? "!"
+                        : snapshot.status === "paused" ? "||"
+                            : "●";
+            const innerWidth = Math.max(8, width - 4);
+            const maxLines = 7;
+            const lines = [];
+            const elapsed = snapshot.startedAt ? formatAutoElapsed(snapshot.startedAt) : "";
+            const heading = `${theme.fg(color, icon)} ${theme.fg("accent", theme.bold("GSD"))} ${theme.fg("text", snapshot.title)}`;
+            lines.push(rightAlign(heading, elapsed ? theme.fg("dim", elapsed) : "", innerWidth));
+            const commands = snapshot.commands?.filter(Boolean) ?? [];
+            const commandLine = commands.length > 0 ? theme.fg("dim", commands.join("  ·  ")) : null;
+            const addWrapped = (text, prefix = "") => {
+                const reserve = commandLine ? 1 : 0;
+                const remaining = Math.max(0, maxLines - reserve - lines.length);
+                if (remaining === 0)
+                    return;
+                const available = Math.max(8, innerWidth - visibleWidth(prefix));
+                for (const [idx, line] of wrapVisibleText(text, available).slice(0, remaining).entries()) {
+                    lines.push(`${idx === 0 ? prefix : " ".repeat(visibleWidth(prefix))}${line}`);
+                }
+            };
+            if (snapshot.detail) {
+                addWrapped(snapshot.detail, `${theme.fg("dim", "Reason")} `);
+            }
+            if (snapshot.unitLabel) {
+                addWrapped(snapshot.unitLabel, `${theme.fg("dim", "Last")}   `);
+            }
+            addWrapped(snapshot.nextAction, `${theme.fg("success", "Next")}   `);
+            if (commandLine && lines.length < maxLines) {
+                lines.push(commandLine);
+            }
+            return renderFrame(theme, lines, width, { borderColor: color, paddingX: 1 });
+        },
+        invalidate() { },
+        dispose() { },
+    }));
+}
+function normalizeRollupText(value) {
+    const clean = value
+        ?.replace(/\s+/g, " ")
+        .replace(/^[-*]\s+/, "")
+        .trim();
+    if (!clean || clean === "(none)" || clean === "None." || clean === "Not provided.")
+        return null;
+    return clean;
+}
+function isAssistantMessage(value) {
+    if (!value || typeof value !== "object")
+        return false;
+    const record = value;
+    if (record.role === "assistant")
+        return true;
+    const message = record.message;
+    if (message && typeof message === "object") {
+        return message.role === "assistant";
+    }
+    return false;
+}
+function extractLastAssistantSummary(messages) {
+    if (!messages || messages.length === 0)
+        return null;
+    for (let i = messages.length - 1; i >= 0; i--) {
+        if (!isAssistantMessage(messages[i]))
+            continue;
+        const text = extractMessageText(messages[i]);
+        const clean = normalizeRollupText(text);
+        if (clean)
+            return truncateToWidth(clean, 220, "…");
+    }
+    return null;
+}
+function extractMessageText(value) {
+    if (typeof value === "string")
+        return value;
+    if (!value || typeof value !== "object")
+        return null;
+    const record = value;
+    if (typeof record.content === "string")
+        return record.content;
+    const message = record.message;
+    if (message && typeof message === "object") {
+        return extractMessageText(message);
+    }
+    const content = record.content;
+    if (Array.isArray(content)) {
+        const parts = content
+            .map((part) => {
+            if (typeof part === "string")
+                return part;
+            if (!part || typeof part !== "object")
+                return "";
+            const partRecord = part;
+            return typeof partRecord.text === "string" ? partRecord.text : "";
+        })
+            .filter(Boolean);
+        return parts.length > 0 ? parts.join(" ") : null;
+    }
+    return null;
 }

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

@@ -1,13 +1,5 @@
-/**
- * Auto-mode Dispatch Table — declarative phase → unit mapping.
- *
- * Each rule maps a GSD state to the unit type, unit ID, and prompt builder
- * that should be dispatched. Rules are evaluated in order; the first match wins.
- *
- * This replaces the 130-line if-else chain in dispatchNextUnit with a
- * data structure that is inspectable, testable per-rule, and extensible
- * without modifying orchestration code.
- */
+// Project/App: GSD-2
+// File Purpose: Declarative auto-mode dispatch rules and dispatch resolver.
 import { loadFile, extractUatType, loadActiveOverrides } from "./files.js";
 import { isDbAvailable, getMilestoneSlices, getPendingGates, markAllGatesOmitted, getMilestone, insertAssessment, transaction } from "./gsd-db.js";
 import { isClosedStatus } from "./status-guards.js";
@@ -110,6 +102,9 @@ function missingSliceStop(mid, phase) {
         level: "error",
     };
 }
+function isRegistryMilestoneComplete(state, mid) {
+    return state.registry.some((milestone) => milestone.id === mid && milestone.status === "complete");
+}
 /**
  * Check for milestone slices missing SUMMARY files.
  * Returns array of missing slice IDs, or empty array if all present or DB unavailable.
@@ -255,6 +250,8 @@ export const DISPATCH_RULES = [
                 return null;
             if (!MILESTONE_ID_RE.test(mid))
                 return null;
+            if (isRegistryMilestoneComplete(state, mid))
+                return null;
             // Align with the plan-v2 gate's lookup semantics: whitespace-only counts
             // as missing, and an auto worktree may fall back to GSD_PROJECT_ROOT.
             if (hasFinalizedMilestoneContext(basePath, mid))
@@ -565,6 +562,8 @@ export const DISPATCH_RULES = [
         match: async ({ state, mid, midTitle, basePath, prefs, structuredQuestionsAvailable }) => {
             if (state.phase !== "pre-planning")
                 return null;
+            if (isRegistryMilestoneComplete(state, mid))
+                return null;
             const contextFile = resolveMilestoneFile(basePath, mid, "CONTEXT");
             const hasContext = !!(contextFile && (await loadFile(contextFile)));
             if (hasContext)
@@ -1099,19 +1098,19 @@ export const DISPATCH_RULES = [
                     return { action: "skip" };
                 }
             }
-            // Safety guard (#2675): block completion when VALIDATION verdict is
-            // needs-remediation. The state machine treats needs-remediation as
-            // terminal (to prevent validate-milestone loops per #832), but
-            // completing-milestone should NOT proceed — remediation work is needed.
+            // Safety guard (#2675, #5747): block completion when VALIDATION
+            // verdict is non-passing. The state machine treats these verdicts as
+            // terminal, but completing-milestone should NOT proceed — remediation
+            // or human attention is needed.
             const validationFile = resolveMilestoneFile(basePath, mid, "VALIDATION");
             if (validationFile) {
                 const validationContent = await loadFile(validationFile);
                 if (validationContent) {
                     const verdict = extractVerdict(validationContent);
-                    if (verdict === "needs-remediation") {
+                    if (verdict === "needs-remediation" || verdict === "needs-attention") {
                         return {
                             action: "stop",
-                            reason: `Cannot complete milestone ${mid}: VALIDATION verdict is "needs-remediation". Address the remediation findings and re-run validation, or update the verdict manually.`,
+                            reason: `Cannot complete milestone ${mid}: VALIDATION verdict is "${verdict}". Address the validation findings and re-run validation, or update the verdict manually.`,
                             level: "warning",
                         };
                     }
@@ -1191,9 +1190,20 @@ export const DISPATCH_RULES = [
     },
     {
         name: "complete → stop",
-        match: async ({ state }) => {
+        match: async ({ state, mid, midTitle, basePath }) => {
             if (state.phase !== "complete")
                 return null;
+            if (mid && isDbAvailable()) {
+                const milestone = getMilestone(mid);
+                if (milestone && !isClosedStatus(milestone.status)) {
+                    return {
+                        action: "dispatch",
+                        unitType: "complete-milestone",
+                        unitId: mid,
+                        prompt: await buildCompleteMilestonePrompt(mid, midTitle, basePath),
+                    };
+                }
+            }
             return {
                 action: "stop",
                 reason: "All milestones complete.",

package/dist/resources/extensions/gsd/auto-model-selection.js

@@ -494,6 +494,8 @@ autoModeStartThinkingLevel) {
  * Handles formats: "provider/model", "bare-id", "org/model-name" (OpenRouter).
  */
 export function resolveModelId(modelId, availableModels, currentProvider) {
+    if (!modelId)
+        return undefined;
     const slashIdx = modelId.indexOf("/");
     if (slashIdx !== -1) {
         const maybeProvider = modelId.substring(0, slashIdx);