gsd-pi 2.75.0-dev.063e5a3 → 2.75.0-dev.fd2382b9f

package/dist/resources/extensions/gsd/bootstrap/agent-end-recovery.js

@@ -1,6 +1,6 @@
 import { logWarning } from "../workflow-logger.js";
 import { checkAutoStartAfterDiscuss } from "../guided-flow.js";
-import { getAutoDashboardData, getAutoModeStartModel, isAutoActive, pauseAuto } from "../auto.js";
+import { getAutoDashboardData, getAutoModeStartModel, isAutoActive, pauseAuto, setCurrentDispatchedModelId } from "../auto.js";
 import { getNextFallbackModel, resolveModelWithFallbacksForUnit } from "../preferences.js";
 import { pauseAutoForProviderError } from "../provider-error-pause.js";
 import { isSessionSwitchInFlight, resolveAgentEnd } from "../auto-loop.js";
@@ -106,26 +106,11 @@ export async function handleAgentEnd(pi, event, ctx) {
         const explicitRetryAfterMs = ("retryAfterMs" in lastMsg && typeof lastMsg.retryAfterMs === "number") ? lastMsg.retryAfterMs : undefined;
         // ── 1. Classify using rawErrorMsg to avoid prose false-positives ────
         const cls = classifyError(rawErrorMsg, explicitRetryAfterMs);
-        // ── 1b. Defer to Core RetryHandler for transient errors ─────────────
-        // The Core RetryHandler (agent-session.ts) processes retryable errors
-        // AFTER this extension handler, in the same _processAgentEvent() call.
-        // For transient errors (overloaded, rate limit, server), the Core will
-        // retry in-context — same session, same conversation — which is strictly
-        // better than our Layer 2 pause+resume (which creates a new session).
-        //
-        // If we react here AND the Core also retries, we race: pauseAuto tears
-        // down the session while agent.continue() starts a new turn.
-        //
-        // Solution: Do nothing for transient errors. The Core RetryHandler
-        // runs next in _processAgentEvent and will either:
-        //   a) Retry successfully → new agent_end (success) → we see it next time
-        //   b) Exhaust retries → the agent stays idle, autoLoop's unit timeout
-        //      or stuck detection handles it
-        //
-        // We do NOT call resolveAgentEnd here — that would unblock autoLoop
-        // prematurely while the Core is still retrying in the same session.
-        // We do NOT call pauseAuto — that would tear down the session.
-        if (isTransient(cls)) {
+        // ── 1b. Defer to Core RetryHandler for most transient errors ────────
+        // Core retries transient failures in-session after this handler.
+        // Keep that behavior for non-rate-limit classes to avoid pause/retry races,
+        // but let rate-limit continue into model fallback logic below (#4373).
+        if (isTransient(cls) && cls.kind !== "rate-limit") {
             return;
         }
         // Cap rate-limit backoff for CLI-style providers (openai-codex, google-gemini-cli)
@@ -177,6 +162,7 @@ export async function handleAgentEnd(pi, event, ctx) {
                         if (modelToSet) {
                             const ok = await pi.setModel(modelToSet, { persist: false });
                             if (ok) {
+                                setCurrentDispatchedModelId({ provider: modelToSet.provider, id: modelToSet.id });
                                 ctx.ui.notify(`Model error${errorDetail}. Switched to fallback: ${nextModelId} and resuming.`, "warning");
                                 pi.sendMessage({ customType: "gsd-auto-timeout-recovery", content: "Continue execution.", display: false }, { triggerTurn: true });
                                 return;
@@ -193,6 +179,7 @@ export async function handleAgentEnd(pi, event, ctx) {
                     if (startModel) {
                         const ok = await pi.setModel(startModel, { persist: false });
                         if (ok) {
+                            setCurrentDispatchedModelId({ provider: startModel.provider, id: startModel.id });
                             retryState.networkRetryCount = 0;
                             retryState.currentRetryModelId = undefined;
                             ctx.ui.notify(`Model error${errorDetail}. Restored session model: ${sessionModel.provider}/${sessionModel.id} and resuming.`, "warning");

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

@@ -421,10 +421,14 @@ export function registerDbTools(pi) {
                 depends: Type.Array(Type.String(), { description: "Slice dependency IDs" }),
                 demo: Type.String({ description: "Roadmap demo text / After this" }),
                 goal: Type.String({ description: "Slice goal" }),
-                successCriteria: Type.String({ description: "Slice success criteria block" }),
-                proofLevel: Type.String({ description: "Slice proof level" }),
-                integrationClosure: Type.String({ description: "Slice integration closure" }),
-                observabilityImpact: Type.String({ description: "Slice observability impact" }),
+                // ADR-011: heavy planning fields are optional for sketch slices; required for full slices.
+                successCriteria: Type.Optional(Type.String({ description: "Slice success criteria block (required for full slices; omit for sketches)" })),
+                proofLevel: Type.Optional(Type.String({ description: "Slice proof level (required for full slices; omit for sketches)" })),
+                integrationClosure: Type.Optional(Type.String({ description: "Slice integration closure (required for full slices; omit for sketches)" })),
+                observabilityImpact: Type.Optional(Type.String({ description: "Slice observability impact (required for full slices; omit for sketches)" })),
+                // ADR-011 sketch-then-refine fields.
+                isSketch: Type.Optional(Type.Boolean({ description: "ADR-011: true marks this slice as a sketch awaiting refine-slice expansion" })),
+                sketchScope: Type.Optional(Type.String({ description: "ADR-011: 2–3 sentence scope boundary, required when isSketch=true" })),
             }), { description: "Planned slices for the milestone" }),
             // ── Enrichment metadata (optional — defaults to empty) ────────────
             status: Type.Optional(Type.String({ description: "Milestone status (defaults to active)" })),
@@ -589,6 +593,20 @@ export function registerDbTools(pi) {
             keyFiles: Type.Optional(Type.Array(Type.String(), { description: "List of key files created or modified" })),
             keyDecisions: Type.Optional(Type.Array(Type.String(), { description: "List of key decisions made during this task" })),
             blockerDiscovered: Type.Optional(Type.Boolean({ description: "Whether a plan-invalidating blocker was discovered" })),
+            // ADR-011 Phase 2: mid-execution escalation — agent asks the user to resolve an ambiguity.
+            escalation: Type.Optional(Type.Object({
+                question: Type.String({ description: "The question the user needs to answer — one clear sentence." }),
+                options: Type.Array(Type.Object({
+                    id: Type.String({ description: "Short id (e.g. 'A', 'B') used by /gsd escalate resolve." }),
+                    label: Type.String({ description: "One-line label." }),
+                    tradeoffs: Type.String({ description: "1-2 sentences on the tradeoffs of this option." }),
+                }), { minItems: 2, maxItems: 4, description: "2–4 options the user can choose between." }),
+                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: "ADR-011 Phase 2: optional escalation payload. Only honored when phases.mid_execution_escalation is true." })),
             verificationEvidence: Type.Optional(Type.Array(Type.Union([
                 Type.Object({
                     command: Type.String({ description: "Verification command that was run" }),

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

@@ -2,6 +2,7 @@
 import { Type } from "@sinclair/typebox";
 import { ensureDbOpen } from "./dynamic-tools.js";
 import { executeMilestoneStatus } from "../tools/workflow-tool-executors.js";
+import { checkpointDatabase } from "../gsd-db.js";
 export function registerQueryTools(pi) {
     pi.registerTool({
         name: "gsd_milestone_status",
@@ -27,4 +28,32 @@ export function registerQueryTools(pi) {
             return executeMilestoneStatus(params);
         },
     });
+    pi.registerTool({
+        name: "gsd_checkpoint_db",
+        label: "Checkpoint GSD Database",
+        description: "Flush the SQLite WAL (Write-Ahead Log) into the base gsd.db file. " +
+            "Call this before `git add .gsd/gsd.db` to ensure the committed database " +
+            "contains current milestone/slice/task state rather than stale pre-session content. " +
+            "Safe to call at any time while GSD is running.",
+        promptSnippet: "Flush WAL into gsd.db so git add stages current state",
+        promptGuidelines: [
+            "Call gsd_checkpoint_db immediately before staging .gsd/gsd.db with git add.",
+            "Do not use sqlite3 or shell commands to checkpoint — they are blocked. Use this tool instead.",
+        ],
+        parameters: Type.Object({}),
+        async execute(_toolCallId, _params, _signal, _onUpdate, _ctx) {
+            const dbAvailable = await ensureDbOpen();
+            if (!dbAvailable) {
+                return {
+                    content: [{ type: "text", text: "Error: GSD database is not available. Cannot checkpoint." }],
+                    details: { operation: "checkpoint_db", error: "db_unavailable" },
+                };
+            }
+            checkpointDatabase();
+            return {
+                content: [{ type: "text", text: "WAL checkpoint complete. gsd.db is now up to date and safe to stage with git add." }],
+                details: { operation: "checkpoint_db", status: "ok" },
+            };
+        },
+    });
 }

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

@@ -13,6 +13,7 @@ import { loadToolApiKeys } from "../commands-config.js";
 import { loadFile, saveFile, formatContinue } from "../files.js";
 import { deriveState } from "../state.js";
 import { getAutoDashboardData, isAutoActive, isAutoPaused, markToolEnd, markToolStart, recordToolInvocationError } from "../auto.js";
+import { hideFooter } from "../auto-dashboard.js";
 import { isParallelActive, shutdownParallel } from "../parallel-orchestrator.js";
 import { checkToolCallLoop, resetToolCallLoopGuard } from "./tool-call-loop-guard.js";
 import { saveActivityLog } from "../activity-log.js";
@@ -77,6 +78,9 @@ export function registerHooks(pi, ecosystemHandlers) {
             catch { /* non-fatal */ }
         }
         loadToolApiKeys();
+        if (isAutoActive()) {
+            ctx.ui.setFooter(hideFooter);
+        }
     });
     pi.on("session_switch", async (_event, ctx) => {
         initNotificationStore(process.cwd());
@@ -96,6 +100,9 @@ export function registerHooks(pi, ecosystemHandlers) {
             prepareWorkflowMcpForProject(ctx, process.cwd());
         }
         loadToolApiKeys();
+        if (isAutoActive()) {
+            ctx.ui.setFooter(hideFooter);
+        }
     });
     pi.on("before_agent_start", async (event, ctx) => {
         // Wait for ecosystem loader to finish (no-op after first turn).
@@ -292,6 +299,7 @@ export function registerHooks(pi, ecosystemHandlers) {
     pi.on("tool_call", async (event, ctx) => {
         if (!isAutoActive())
             return;
+        markToolStart(event.toolCallId, event.toolName);
         safetyRecordToolCall(event.toolCallId, event.toolName, event.input);
         // Destructive command classification (warn only, never block)
         if (isToolCallEventType("bash", event)) {
@@ -305,6 +313,20 @@ export function registerHooks(pi, ecosystemHandlers) {
         }
     });
     pi.on("tool_result", async (event) => {
+        if (isAutoActive() && typeof event.toolCallId === "string") {
+            markToolEnd(event.toolCallId);
+        }
+        if (isAutoActive() && event.isError && event.toolName.startsWith("gsd_")) {
+            const resultPayload = ("result" in event ? event.result : undefined);
+            const errorText = typeof resultPayload === "string"
+                ? resultPayload
+                : (typeof resultPayload?.content?.[0]?.text === "string"
+                    ? resultPayload.content[0].text
+                    : (typeof event.content === "string"
+                        ? event.content
+                        : String(resultPayload ?? "")));
+            recordToolInvocationError(event.toolName, errorText);
+        }
         if (event.toolName !== "ask_user_questions")
             return;
         const milestoneId = getDiscussionMilestoneId(process.cwd());

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

@@ -4,7 +4,7 @@ import { join } from "node:path";
 import { loadRegistry } from "../workflow-templates.js";
 import { resolveProjectRoot } from "../worktree.js";
 const gsdHome = process.env.GSD_HOME || join(homedir(), ".gsd");
-export const GSD_COMMAND_DESCRIPTION = "GSD — Get Shit Done: /gsd help|start|templates|next|auto|stop|pause|status|widget|visualize|queue|quick|discuss|capture|triage|dispatch|history|undo|undo-task|reset-slice|rate|skip|export|cleanup|model|mode|prefs|config|keys|hooks|run-hook|skill-health|doctor|logs|forensics|changelog|migrate|remote|steer|knowledge|new-milestone|parallel|cmux|park|unpark|init|setup|inspect|extensions|update|fast|mcp|rethink|codebase|notifications|ship|do|session-report|backlog|pr-branch|add-tests|language";
+export const GSD_COMMAND_DESCRIPTION = "GSD — Get Shit Done: /gsd help|start|templates|next|auto|stop|pause|status|widget|visualize|queue|quick|discuss|capture|triage|dispatch|history|undo|undo-task|reset-slice|rate|skip|export|cleanup|model|mode|prefs|config|keys|hooks|run-hook|skill-health|doctor|debug|logs|forensics|changelog|migrate|remote|steer|knowledge|new-milestone|parallel|cmux|park|unpark|init|setup|inspect|extensions|update|fast|mcp|rethink|codebase|notifications|ship|do|session-report|backlog|pr-branch|add-tests|scan|language";
 export const TOP_LEVEL_SUBCOMMANDS = [
     { cmd: "help", desc: "Categorized command reference with descriptions" },
     { cmd: "next", desc: "Explicit step mode (same as /gsd)" },
@@ -40,6 +40,7 @@ export const TOP_LEVEL_SUBCOMMANDS = [
     { cmd: "notifications", desc: "View, filter, and clear persistent notification history" },
     { cmd: "doctor", desc: "Runtime health checks with auto-fix" },
     { cmd: "logs", desc: "Browse activity logs, debug logs, and metrics" },
+    { cmd: "debug", desc: "Create and inspect persistent /gsd debug sessions" },
     { cmd: "forensics", desc: "Examine execution logs" },
     { cmd: "init", desc: "Project init wizard — detect, configure, bootstrap .gsd/" },
     { cmd: "setup", desc: "Global setup status and configuration" },
@@ -60,7 +61,7 @@ export const TOP_LEVEL_SUBCOMMANDS = [
     { cmd: "fast", desc: "Toggle OpenAI service tier (on/off/flex/status)" },
     { 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: "workflow", desc: "Custom workflow lifecycle (new, run, list, info, install, uninstall, validate, pause, resume) or run <name> directly" },
     { cmd: "codebase", desc: "Generate, refresh, and inspect the codebase map cache (.gsd/CODEBASE.md)" },
     { cmd: "ship", desc: "Create PR from milestone artifacts and open for review" },
     { cmd: "do", desc: "Route freeform text to the right GSD command" },
@@ -68,6 +69,7 @@ export const TOP_LEVEL_SUBCOMMANDS = [
     { cmd: "backlog", desc: "Manage backlog items (add, promote, remove, list)" },
     { cmd: "pr-branch", desc: "Create clean PR branch filtering .gsd/ commits" },
     { cmd: "add-tests", desc: "Generate tests for completed slices" },
+    { cmd: "scan", desc: "Rapid codebase assessment — lightweight alternative to full map (--focus tech|arch|quality|concerns|tech+arch)" },
     { cmd: "language", desc: "Set or clear the global response language (e.g. /gsd language Chinese)" },
 ];
 const NESTED_COMPLETIONS = {
@@ -116,6 +118,12 @@ const NESTED_COMPLETIONS = {
         { cmd: "tail", desc: "Show last N activity log summaries" },
         { cmd: "clear", desc: "Remove old activity and debug logs" },
     ],
+    debug: [
+        { cmd: "list", desc: "List persisted debug sessions" },
+        { cmd: "status", desc: "Show status for one debug session slug" },
+        { cmd: "continue", desc: "Resume an existing debug session slug" },
+        { cmd: "--diagnose", desc: "Inspect malformed artifacts and session health" },
+    ],
     keys: [
         { cmd: "list", desc: "Show key status dashboard" },
         { cmd: "add", desc: "Add a key for a provider" },
@@ -222,8 +230,11 @@ const NESTED_COMPLETIONS = {
     ],
     workflow: [
         { cmd: "new", desc: "Create a new workflow definition (via skill)" },
-        { cmd: "run", desc: "Create a run and start auto-mode" },
+        { cmd: "run", desc: "Create a YAML run and start auto-mode" },
         { cmd: "list", desc: "List workflow runs" },
+        { cmd: "info", desc: "Show plugin details (source, mode, phases)" },
+        { cmd: "install", desc: "Install a plugin from a URL / gist: / gh:" },
+        { cmd: "uninstall", desc: "Remove an installed plugin" },
         { cmd: "validate", desc: "Validate a workflow definition YAML" },
         { cmd: "pause", desc: "Pause custom workflow auto-mode" },
         { cmd: "resume", desc: "Resume paused custom workflow auto-mode" },
@@ -257,6 +268,13 @@ const NESTED_COMPLETIONS = {
         { cmd: "--dry-run", desc: "Preview what would be filtered" },
         { cmd: "--name", desc: "Custom branch name" },
     ],
+    scan: [
+        { cmd: "--focus tech", desc: "Technology stack and external integrations" },
+        { cmd: "--focus arch", desc: "Architecture patterns and directory structure" },
+        { cmd: "--focus quality", desc: "Coding conventions and testing patterns" },
+        { cmd: "--focus concerns", desc: "Technical debt and risk areas" },
+        { cmd: "--focus tech+arch", desc: "Tech + Architecture (default)" },
+    ],
     language: [
         { cmd: "off", desc: "Clear the language preference (revert to default)" },
         { cmd: "clear", desc: "Alias for off — clear the language preference" },
@@ -377,6 +395,52 @@ export function getGsdArgumentCompletions(prefix) {
         }
         return [];
     }
+    // Completion for `/gsd workflow info <name>` — list all discoverable plugins (project + global).
+    if (command === "workflow" && subcommand === "info" && parts.length <= 3) {
+        const results = [];
+        const seen = new Set();
+        const scanDir = (dir, source) => {
+            if (!existsSync(dir))
+                return;
+            try {
+                for (const f of readdirSync(dir)) {
+                    if (!/\.(ya?ml|md)$/i.test(f))
+                        continue;
+                    const name = f.replace(/\.(ya?ml|md)$/i, "");
+                    if (!name.startsWith(third))
+                        continue;
+                    if (seen.has(name))
+                        continue;
+                    seen.add(name);
+                    results.push({ cmd: name, desc: `Workflow plugin (${source})` });
+                }
+            }
+            catch { /* ignore */ }
+        };
+        try {
+            const base = resolveProjectRoot(process.cwd());
+            scanDir(join(base, ".gsd", "workflows"), "project");
+            scanDir(join(base, ".gsd", "workflow-defs"), "project-legacy");
+            scanDir(join(gsdHome, "workflows"), "global");
+        }
+        catch { /* ignore */ }
+        // Also include bundled template names.
+        try {
+            const registry = loadRegistry();
+            for (const id of Object.keys(registry.templates)) {
+                if (seen.has(id) || !id.startsWith(third))
+                    continue;
+                seen.add(id);
+                results.push({ cmd: id, desc: "Workflow plugin (bundled)" });
+            }
+        }
+        catch { /* ignore */ }
+        return results.map((r) => ({
+            value: `workflow info ${r.cmd}`,
+            label: r.cmd,
+            description: r.desc,
+        }));
+    }
     const nested = NESTED_COMPLETIONS[command];
     if (nested && parts.length <= 2) {
         return filterOptions(subcommand, nested, command);

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

@@ -31,6 +31,10 @@ export function showHelp(ctx, args = "") {
         "  /gsd undo           Revert last completed unit  [--force]",
         "  /gsd rethink        Conversational project reorganization",
         "",
+        "OBSERVABILITY",
+        "  /gsd logs           Browse activity and debug logs",
+        "  /gsd debug          Create/list/continue persistent debug sessions",
+        "",
         "SETUP",
         "  /gsd init           Project init wizard",
         "  /gsd setup          Global setup status  [llm|search|remote|keys|prefs]",
@@ -61,6 +65,8 @@ export function showHelp(ctx, args = "") {
         "  /gsd history        View execution history  [--cost] [--phase] [--model] [N]",
         "  /gsd changelog      Show categorized release notes  [version]",
         `  /gsd notifications  View persistent notification history  [clear|tail|filter]  (${formattedShortcutPair("notifications")})`,
+        "  /gsd logs           Browse activity logs, debug logs, and metrics",
+        "  /gsd debug          Create/list/continue persistent debug sessions",
         "",
         "COURSE CORRECTION",
         "  /gsd steer <desc>   Apply user override to active work",

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

@@ -0,0 +1,171 @@
+// GSD Extension — /gsd escalate Command Handler (ADR-011 Phase 2)
+// Surface and resolve mid-execution escalations from the CLI.
+import { projectRoot } from "../context.js";
+import { getActiveMilestoneId } from "../../state.js";
+import { readEscalationArtifact, formatEscalationForDisplay, resolveEscalation, listActionableEscalations, listAllEscalations, } from "../../escalation.js";
+import { saveDecisionToDb } from "../../db-writer.js";
+import { loadEffectiveGSDPreferences } from "../../preferences.js";
+import { invalidateStateCache } from "../../state.js";
+import { emitUokAuditEvent, buildAuditEnvelope } from "../../uok/audit.js";
+function helpMessage() {
+    return [
+        "/gsd escalate — manage mid-execution escalations (ADR-011 Phase 2)",
+        "",
+        "Subcommands:",
+        "  list [--all]           show pending escalations (use --all to include resolved)",
+        "  show <taskId>          print the escalation artifact",
+        "  resolve <taskId> <choice> [rationale...]",
+        "                         resolve an escalation — choice is an option id,",
+        "                         `accept` (use recommendation), or `reject-blocker`",
+        "                         (convert to a blocker and trigger slice replan)",
+        "",
+        "Note: disabling `phases.mid_execution_escalation` does NOT clear pending",
+        "escalations. If you need to drain them, re-enable the flag, resolve via",
+        "`/gsd escalate resolve`, then disable.",
+    ].join("\n");
+}
+function formatListEntries(rows, basePath) {
+    if (rows.length === 0)
+        return "No escalations.";
+    return rows.map((t) => {
+        const art = t.escalation_artifact_path ? readEscalationArtifact(t.escalation_artifact_path) : null;
+        const status = t.escalation_pending ? "PENDING (paused)" : t.escalation_awaiting_review ? "awaiting-review" : "resolved";
+        const question = art?.question ?? "(artifact missing)";
+        return `  ${t.slice_id}/${t.id}  [${status}]  ${question}`;
+    }).join("\n");
+}
+export async function handleEscalateCommand(args, ctx, pi) {
+    void pi;
+    const trimmed = args.trim();
+    if (trimmed === "" || trimmed === "help") {
+        ctx.ui.notify(helpMessage(), "info");
+        return;
+    }
+    const basePath = projectRoot();
+    const prefs = loadEffectiveGSDPreferences()?.preferences;
+    if (prefs?.phases?.mid_execution_escalation !== true) {
+        ctx.ui.notify("Escalation is off. Enable with `phases: { mid_execution_escalation: true }` in your PREFERENCES.md.", "warning");
+        return;
+    }
+    const milestoneId = await getActiveMilestoneId(basePath);
+    if (!milestoneId) {
+        ctx.ui.notify("No active milestone — cannot list escalations.", "warning");
+        return;
+    }
+    // ── list ────────────────────────────────────────────────────────────────
+    if (trimmed === "list" || trimmed === "list --all" || trimmed === "--all") {
+        const includeAll = trimmed.includes("--all");
+        const rows = includeAll ? listAllEscalations(milestoneId) : listActionableEscalations(milestoneId);
+        const body = formatListEntries(rows, basePath);
+        ctx.ui.notify(`${includeAll ? "All escalations" : "Actionable escalations"} for ${milestoneId}:\n${body}`, "info");
+        return;
+    }
+    // Parse a possibly-slice-qualified task id: "Sxx/Tyy" or plain "Tyy".
+    // Returns { sliceId?, taskId }.
+    const parseTaskRef = (ref) => {
+        const slash = ref.indexOf("/");
+        if (slash > 0) {
+            return { sliceId: ref.slice(0, slash), taskId: ref.slice(slash + 1) };
+        }
+        return { taskId: ref };
+    };
+    // Resolve a task ref to a single row, surfacing ambiguity when a bare task
+    // id matches more than one slice.
+    const locateRow = (ref) => {
+        const { sliceId, taskId } = parseTaskRef(ref);
+        const rows = listAllEscalations(milestoneId).filter((t) => t.id === taskId && (sliceId === undefined || t.slice_id === sliceId));
+        if (rows.length === 0)
+            return "not-found";
+        if (rows.length > 1)
+            return "ambiguous";
+        return rows[0];
+    };
+    // ── show <taskRef> ──────────────────────────────────────────────────────
+    if (trimmed.startsWith("show ")) {
+        const ref = trimmed.slice(5).trim();
+        const row = locateRow(ref);
+        if (row === "ambiguous") {
+            ctx.ui.notify(`Task ${ref} matches multiple slices. Use Sxx/Tyy format.`, "warning");
+            return;
+        }
+        if (row === "not-found" || !row.escalation_artifact_path) {
+            ctx.ui.notify(`No escalation found for ${ref} in ${milestoneId}.`, "warning");
+            return;
+        }
+        const art = readEscalationArtifact(row.escalation_artifact_path);
+        if (!art) {
+            ctx.ui.notify(`Escalation artifact at ${row.escalation_artifact_path} is missing or malformed.`, "error");
+            return;
+        }
+        ctx.ui.notify(formatEscalationForDisplay(art), "info");
+        return;
+    }
+    // ── resolve <taskRef> <choice> [rationale...] ───────────────────────────
+    if (trimmed.startsWith("resolve ")) {
+        const parts = trimmed.slice(8).trim().split(/\s+/);
+        const ref = parts[0];
+        const choice = parts[1];
+        const rationale = parts.slice(2).join(" ").trim();
+        if (!ref || !choice) {
+            ctx.ui.notify("Usage: /gsd escalate resolve <taskId|Sxx/Tyy> <choice> [rationale...]", "warning");
+            return;
+        }
+        const row = locateRow(ref);
+        if (row === "ambiguous") {
+            ctx.ui.notify(`Task ${ref} matches multiple slices. Use Sxx/Tyy format.`, "warning");
+            return;
+        }
+        if (row === "not-found") {
+            ctx.ui.notify(`No escalation found for ${ref} in ${milestoneId}.`, "warning");
+            return;
+        }
+        const taskId = row.id;
+        const result = resolveEscalation(basePath, milestoneId, row.slice_id, taskId, choice, rationale);
+        invalidateStateCache();
+        if (result.status !== "resolved" && result.status !== "rejected-to-blocker") {
+            ctx.ui.notify(result.message, result.status === "invalid-choice" ? "warning" : "error");
+            return;
+        }
+        // Persist the user's choice as a decision (only for resolved, not reject-blocker).
+        if (result.status === "resolved") {
+            try {
+                const art = row.escalation_artifact_path ? readEscalationArtifact(row.escalation_artifact_path) : null;
+                const scope = `${milestoneId}/${row.slice_id}/${taskId}`;
+                const decisionText = art?.question ?? `escalation on ${taskId}`;
+                const choiceLabel = choice === "accept"
+                    ? `${art?.recommendation ?? "accepted"} (recommended)`
+                    : (result.chosenOption?.label ?? choice);
+                const { id: decisionId } = await saveDecisionToDb({
+                    scope,
+                    decision: decisionText,
+                    choice: choiceLabel,
+                    rationale: rationale || result.chosenOption?.tradeoffs || "User-resolved escalation.",
+                    made_by: "human",
+                    source: "escalation",
+                    when_context: `ADR-011 escalation resolved ${new Date().toISOString()}`,
+                }, basePath);
+                emitUokAuditEvent(basePath, buildAuditEnvelope({
+                    traceId: `escalation:${milestoneId}:${row.slice_id}:${taskId}`,
+                    category: "gate",
+                    type: "escalation-decision-persisted",
+                    payload: {
+                        milestoneId,
+                        sliceId: row.slice_id,
+                        taskId,
+                        decisionId,
+                        choice,
+                    },
+                }));
+                ctx.ui.notify(`${result.message}\nDecision recorded as ${decisionId}. Run /gsd auto to continue.`, "success");
+            }
+            catch (decErr) {
+                ctx.ui.notify(`${result.message}\nWARN: decision persistence failed: ${decErr.message}`, "warning");
+            }
+            return;
+        }
+        // rejected-to-blocker path
+        ctx.ui.notify(`${result.message} Run /gsd auto to trigger the replan.`, "success");
+        return;
+    }
+    ctx.ui.notify(`Unknown subcommand. ${helpMessage()}`, "warning");
+}

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

@@ -3,6 +3,7 @@ import { handleConfig } from "../../commands-config.js";
 import { handleDoctor, handleCapture, handleKnowledge, handleRunHook, handleSkillHealth, handleSteer, handleTriage, handleUpdate } from "../../commands-handlers.js";
 import { handleInspect } from "../../commands-inspect.js";
 import { handleLogs } from "../../commands-logs.js";
+import { handleDebug } from "../../commands-debug.js";
 import { handleCleanupBranches, handleCleanupSnapshots, handleSkip, handleCleanupProjects, handleCleanupWorktrees, handleRecover } from "../../commands-maintenance.js";
 import { handleExport } from "../../export.js";
 import { handleHistory } from "../../history.js";
@@ -39,6 +40,10 @@ export async function handleOpsCommand(trimmed, ctx, pi) {
         await handleLogs(trimmed.replace(/^logs\s*/, "").trim(), ctx);
         return true;
     }
+    if (trimmed === "debug" || trimmed.startsWith("debug ")) {
+        await handleDebug(trimmed.replace(/^debug\s*/, "").trim(), ctx, pi);
+        return true;
+    }
     if (trimmed === "forensics" || trimmed.startsWith("forensics ")) {
         const { handleForensics } = await import("../../forensics.js");
         await handleForensics(trimmed.replace(/^forensics\s*/, "").trim(), ctx, pi);
@@ -183,6 +188,11 @@ Examples:
         await handleNotificationsCommand(trimmed.replace(/^notifications\s*/, "").trim(), ctx, pi);
         return true;
     }
+    if (trimmed === "escalate" || trimmed.startsWith("escalate ")) {
+        const { handleEscalateCommand } = await import("./escalate.js");
+        await handleEscalateCommand(trimmed.replace(/^escalate\s*/, "").trim(), ctx, pi);
+        return true;
+    }
     if (trimmed === "inspect") {
         await handleInspect(ctx);
         return true;
@@ -238,5 +248,11 @@ Examples:
         await handleExtractLearnings(trimmed.replace(/^extract-learnings\s*/, "").trim(), ctx, pi);
         return true;
     }
+    if (trimmed === "scan" || trimmed.startsWith("scan ")) {
+        const { handleScan } = await import("../../commands-scan.js");
+        // \s* (not \s+) is intentional: handles both /gsd scan (no args) and /gsd scan --focus X
+        await handleScan(trimmed.replace(/^scan\s*/, "").trim(), ctx, pi);
+        return true;
+    }
     return false;
 }