gsd-pi 2.64.0 → 2.65.0-dev.16e10d7

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

@@ -18,6 +18,9 @@ import { resetAskUserQuestionsCache } from "../../ask-user-questions.js";
 import { recordToolCall as safetyRecordToolCall, recordToolResult as safetyRecordToolResult } from "../safety/evidence-collector.js";
 import { classifyCommand } from "../safety/destructive-guard.js";
 import { logWarning as safetyLogWarning } from "../workflow-logger.js";
+import { installNotifyInterceptor } from "./notify-interceptor.js";
+import { initNotificationStore } from "../notification-store.js";
+import { initNotificationWidget } from "../notification-widget.js";
 // Skip the welcome screen on the very first session_start — cli.ts already
 // printed it before the TUI launched. Only re-print on /clear (subsequent sessions).
 let isFirstSession = true;
@@ -27,6 +30,9 @@ async function syncServiceTierStatus(ctx) {
 }
 export function registerHooks(pi) {
     pi.on("session_start", async (_event, ctx) => {
+        initNotificationStore(process.cwd());
+        installNotifyInterceptor(ctx);
+        initNotificationWidget(ctx);
         resetWriteGateState();
         resetToolCallLoopGuard();
         resetAskUserQuestionsCache();
@@ -63,6 +69,8 @@ export function registerHooks(pi) {
         loadToolApiKeys();
     });
     pi.on("session_switch", async (_event, ctx) => {
+        initNotificationStore(process.cwd());
+        installNotifyInterceptor(ctx);
         resetWriteGateState();
         resetToolCallLoopGuard();
         resetAskUserQuestionsCache();
@@ -90,7 +98,10 @@ export function registerHooks(pi) {
         }
     });
     pi.on("session_before_compact", async () => {
-        if (isAutoActive() || isAutoPaused()) {
+        // Only cancel compaction while auto-mode is actively running.
+        // Paused auto-mode should allow compaction — the user may be doing
+        // interactive work (#3165).
+        if (isAutoActive()) {
             return { cancel: true };
         }
         const basePath = process.cwd();

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

@@ -2,6 +2,7 @@ import { existsSync } from "node:fs";
 import { join } from "node:path";
 import { Key } from "@gsd/pi-tui";
 import { GSDDashboardOverlay } from "../dashboard-overlay.js";
+import { GSDNotificationOverlay } from "../notification-overlay.js";
 import { ParallelMonitorOverlay } from "../parallel-monitor-overlay.js";
 import { shortcutDesc } from "../../shared/mod.js";
 export function registerShortcuts(pi) {
@@ -23,6 +24,21 @@ export function registerShortcuts(pi) {
             });
         },
     });
+    pi.registerShortcut(Key.ctrlAlt("n"), {
+        description: shortcutDesc("Open notification history", "/gsd notifications"),
+        handler: async (ctx) => {
+            await ctx.ui.custom((tui, theme, _kb, done) => new GSDNotificationOverlay(tui, theme, () => done()), {
+                overlay: true,
+                overlayOptions: {
+                    width: "80%",
+                    minWidth: 60,
+                    maxHeight: "88%",
+                    anchor: "center",
+                    backdrop: true,
+                },
+            });
+        },
+    });
     pi.registerShortcut(Key.ctrlAlt("p"), {
         description: shortcutDesc("Open parallel worker monitor", "/gsd parallel watch"),
         handler: async (ctx) => {

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

@@ -229,6 +229,12 @@ function buildWorktreeContextBlock() {
     }
     return "";
 }
+/**
+ * Low-entropy resume intent patterns — short phrases a user types to
+ * continue work after a pause, rate limit, or context reset (#3615).
+ * Tested against the trimmed, lowercased prompt with trailing punctuation stripped.
+ */
+const RESUME_INTENT_PATTERNS = /^(continue|resume|ok|go|go ahead|proceed|keep going|carry on|next|yes|yeah|yep|sure|do it|let's go|pick up where you left off)$/;
 async function buildGuidedExecuteContextInjection(prompt, basePath) {
     const executeMatch = prompt.match(/Execute the next task:\s+(T\d+)\s+\("([^"]+)"\)\s+in slice\s+(S\d+)\s+of milestone\s+(M\d+(?:-[a-z0-9]{6})?)/i);
     if (executeMatch) {
@@ -243,6 +249,20 @@ async function buildGuidedExecuteContextInjection(prompt, basePath) {
             return buildTaskExecutionContextInjection(basePath, milestoneId, sliceId, state.activeTask.id, state.activeTask.title);
         }
     }
+    // Fallback: low-entropy resume prompt (e.g., "continue", "ok", "go ahead")
+    // during an active executing task — inject task context so the agent
+    // doesn't rebuild from scratch (#3615).
+    // Intent-gated: only fire for short, resume-like prompts to avoid hijacking
+    // control/help/diagnostic prompts with unrelated execution context.
+    // Phase-gated: only fire during "executing" to avoid misrouting during
+    // replanning, gate evaluation, or other non-execution phases.
+    const trimmed = prompt.trim().toLowerCase().replace(/[.!?,]+$/g, "");
+    if (RESUME_INTENT_PATTERNS.test(trimmed)) {
+        const state = await deriveState(basePath);
+        if (state.phase === "executing" && state.activeTask && state.activeMilestone && state.activeSlice) {
+            return buildTaskExecutionContextInjection(basePath, state.activeMilestone.id, state.activeSlice.id, state.activeTask.id, state.activeTask.title);
+        }
+    }
     return null;
 }
 async function buildTaskExecutionContextInjection(basePath, milestoneId, sliceId, taskId, taskTitle) {

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|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";
+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|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";
 export const TOP_LEVEL_SUBCOMMANDS = [
     { cmd: "help", desc: "Categorized command reference with descriptions" },
     { cmd: "next", desc: "Explicit step mode (same as /gsd)" },
@@ -36,6 +36,7 @@ export const TOP_LEVEL_SUBCOMMANDS = [
     { cmd: "hooks", desc: "Show configured post-unit and pre-dispatch hooks" },
     { cmd: "run-hook", desc: "Manually trigger a specific hook" },
     { cmd: "skill-health", desc: "Skill lifecycle dashboard" },
+    { 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: "forensics", desc: "Examine execution logs" },
@@ -97,6 +98,11 @@ const NESTED_COMPLETIONS = {
         { cmd: "keys", desc: "Manage API keys" },
         { cmd: "prefs", desc: "Configure global preferences" },
     ],
+    notifications: [
+        { cmd: "clear", desc: "Clear all notifications" },
+        { cmd: "tail", desc: "Show last N notifications (default: 20)" },
+        { cmd: "filter", desc: "Filter by severity (error|warning|info|success)" },
+    ],
     logs: [
         { cmd: "debug", desc: "List or view debug log files" },
         { cmd: "tail", desc: "Show last N activity log summaries" },

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

@@ -4,7 +4,14 @@ import { resolveProjectRoot } from "../worktree.js";
 import { showNextAction } from "../../shared/tui.js";
 import { handleStatus } from "./handlers/core.js";
 export function projectRoot() {
-    const cwd = process.cwd();
+    let cwd;
+    try {
+        cwd = process.cwd();
+    }
+    catch {
+        // cwd directory was deleted (e.g. worktree teardown) — fall back to HOME (#3598)
+        cwd = process.env.HOME ?? "/";
+    }
     const root = resolveProjectRoot(cwd);
     if (root !== cwd) {
         assertSafeDirectory(cwd);

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

@@ -25,6 +25,7 @@ export function showHelp(ctx) {
         "  /gsd queue          Show queued/dispatched units and execution order",
         "  /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]  (Ctrl+Alt+N)",
         "",
         "COURSE CORRECTION",
         "  /gsd steer <desc>   Apply user override to active work",
@@ -47,6 +48,7 @@ export function showHelp(ctx) {
         "  /gsd cmux           Manage cmux integration  [status|on|off|notifications|sidebar|splits|browser]",
         "  /gsd config         Set API keys for external tools",
         "  /gsd keys           API key manager  [list|add|remove|test|rotate|doctor]",
+        "  /gsd show-config    Show effective configuration (models, routing, toggles)",
         "  /gsd hooks          Show post-unit hook configuration",
         "  /gsd extensions     Manage extensions  [list|enable|disable|info]",
         "  /gsd fast           Toggle OpenAI service tier  [on|off|flex|status]",
@@ -65,6 +67,9 @@ export function showHelp(ctx) {
 }
 export async function handleStatus(ctx) {
     const basePath = projectRoot();
+    // Open DB in cold sessions so status uses DB-backed state, not filesystem fallback (#3385)
+    const { ensureDbOpen } = await import("../../bootstrap/dynamic-tools.js");
+    await ensureDbOpen();
     const state = await deriveState(basePath);
     if (state.registry.length === 0) {
         ctx.ui.notify("No GSD milestones found. Run /gsd to start.", "info");
@@ -187,6 +192,22 @@ export async function handleCoreCommand(trimmed, ctx) {
         await handleCmux(trimmed.replace(/^cmux\s*/, "").trim(), ctx);
         return true;
     }
+    if (trimmed === "show-config") {
+        const { GSDConfigOverlay, formatConfigText } = await import("../../config-overlay.js");
+        const result = await ctx.ui.custom((tui, theme, _kb, done) => new GSDConfigOverlay(tui, theme, () => done()), {
+            overlay: true,
+            overlayOptions: {
+                width: "65%",
+                minWidth: 55,
+                maxHeight: "85%",
+                anchor: "center",
+            },
+        });
+        if (result === undefined) {
+            ctx.ui.notify(formatConfigText(), "info");
+        }
+        return true;
+    }
     if (trimmed === "setup" || trimmed.startsWith("setup ")) {
         await handleSetup(trimmed.replace(/^setup\s*/, "").trim(), ctx);
         return true;

package/dist/resources/extensions/gsd/commands/handlers/notifications-handler.js

@@ -0,0 +1,104 @@
+// GSD Extension — /gsd notifications Command Handler
+// View, filter, and clear the persistent notification history.
+import { readNotifications, clearNotifications, getUnreadCount, suppressPersistence, unsuppressPersistence, } from "../../notification-store.js";
+import { GSDNotificationOverlay } from "../../notification-overlay.js";
+function severityIcon(severity) {
+    switch (severity) {
+        case "error": return "✗";
+        case "warning": return "⚠";
+        case "success": return "✓";
+        case "info":
+        default: return "●";
+    }
+}
+function formatTimestamp(ts) {
+    try {
+        const d = new Date(ts);
+        return d.toLocaleString("en-US", { hour12: false, month: "short", day: "numeric", hour: "2-digit", minute: "2-digit" });
+    }
+    catch {
+        return ts.slice(0, 19);
+    }
+}
+export async function handleNotificationsCommand(args, ctx, pi) {
+    // /gsd notifications clear
+    if (args === "clear") {
+        clearNotifications();
+        // Suppress persistence so the confirmation toast doesn't re-populate the store
+        suppressPersistence();
+        try {
+            ctx.ui.notify("All notifications cleared.", "success");
+        }
+        finally {
+            unsuppressPersistence();
+        }
+        return true;
+    }
+    // /gsd notifications tail [N]
+    if (args === "tail" || args.startsWith("tail ")) {
+        const countStr = args.replace(/^tail\s*/, "").trim();
+        const count = countStr ? parseInt(countStr, 10) : 20;
+        const n = isNaN(count) || count < 1 ? 20 : Math.min(count, 100);
+        const entries = readNotifications().slice(0, n);
+        if (entries.length === 0) {
+            ctx.ui.notify("No notifications.", "info");
+            return true;
+        }
+        const lines = entries.map((e) => `${severityIcon(e.severity)} [${formatTimestamp(e.ts)}] ${e.message}`);
+        ctx.ui.notify(`Last ${entries.length} notification(s):\n${lines.join("\n")}`, "info");
+        return true;
+    }
+    // /gsd notifications filter <severity>
+    if (args.startsWith("filter ")) {
+        const severity = args.replace(/^filter\s+/, "").trim().toLowerCase();
+        if (!["error", "warning", "info", "success"].includes(severity)) {
+            ctx.ui.notify("Usage: /gsd notifications filter <error|warning|info|success>", "warning");
+            return true;
+        }
+        const entries = readNotifications().filter((e) => e.severity === severity);
+        if (entries.length === 0) {
+            ctx.ui.notify(`No ${severity} notifications.`, "info");
+            return true;
+        }
+        const lines = entries.slice(0, 20).map((e) => `${severityIcon(e.severity)} [${formatTimestamp(e.ts)}] ${e.message}`);
+        const suffix = entries.length > 20 ? `\n... and ${entries.length - 20} more` : "";
+        ctx.ui.notify(`${severity} notifications (${entries.length}):\n${lines.join("\n")}${suffix}`, "info");
+        return true;
+    }
+    // /gsd notifications (no args) — open overlay in TUI, or print summary
+    if (args === "" || args === "status") {
+        // Try overlay first (TUI mode)
+        if (ctx.hasUI) {
+            try {
+                await ctx.ui.custom((tui, theme, _kb, done) => new GSDNotificationOverlay(tui, theme, () => done()), {
+                    overlay: true,
+                    overlayOptions: {
+                        width: "80%",
+                        minWidth: 60,
+                        maxHeight: "88%",
+                        anchor: "center",
+                        backdrop: true,
+                    },
+                });
+                return true;
+            }
+            catch {
+                // Fall through to text output if overlay fails
+            }
+        }
+        // Text fallback (RPC/headless mode)
+        const unread = getUnreadCount();
+        const entries = readNotifications().slice(0, 10);
+        if (entries.length === 0) {
+            ctx.ui.notify("No notifications.", "info");
+            return true;
+        }
+        const lines = entries.map((e) => `${severityIcon(e.severity)} [${formatTimestamp(e.ts)}] ${e.message}`);
+        const header = unread > 0 ? `${unread} unread — ` : "";
+        ctx.ui.notify(`${header}Recent notifications:\n${lines.join("\n")}`, "info");
+        return true;
+    }
+    // Unknown subcommand
+    ctx.ui.notify("Usage: /gsd notifications [clear|tail [N]|filter <severity>]", "warning");
+    return true;
+}

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

@@ -175,6 +175,11 @@ Examples:
         await dispatchDirectPhase(ctx, pi, phase, projectRoot());
         return true;
     }
+    if (trimmed === "notifications" || trimmed.startsWith("notifications ")) {
+        const { handleNotificationsCommand } = await import("./notifications-handler.js");
+        await handleNotificationsCommand(trimmed.replace(/^notifications\s*/, "").trim(), ctx, pi);
+        return true;
+    }
     if (trimmed === "inspect") {
         await handleInspect(ctx);
         return true;

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

@@ -68,7 +68,7 @@ function discoverManifests() {
     if (!existsSync(extDir))
         return manifests;
     for (const entry of readdirSync(extDir, { withFileTypes: true })) {
-        if (!entry.isDirectory())
+        if (!entry.isDirectory() && !entry.isSymbolicLink())
             continue;
         const m = readManifest(join(extDir, entry.name));
         if (m)

package/dist/resources/extensions/gsd/config-overlay.js

@@ -0,0 +1,312 @@
+/**
+ * GSD Configuration Overlay
+ *
+ * Read-only TUI overlay showing the effective GSD configuration:
+ * token profile, model assignments, dynamic routing, git settings,
+ * budget, workflow toggles, and preference file sources.
+ * Opened via `/gsd show-config` or `/gsd config`.
+ */
+import { matchesKey, Key, truncateToWidth } from "@gsd/pi-tui";
+import { loadEffectiveGSDPreferences, loadGlobalGSDPreferences, loadProjectGSDPreferences, getGlobalGSDPreferencesPath, getProjectGSDPreferencesPath, resolveDynamicRoutingConfig, resolveEffectiveProfile, resolveModelWithFallbacksForUnit, resolveAutoSupervisorConfig, } from "./preferences.js";
+function collectConfigSections() {
+    const sections = [];
+    const globalPrefs = loadGlobalGSDPreferences();
+    const projectPrefs = loadProjectGSDPreferences();
+    const effective = loadEffectiveGSDPreferences();
+    const prefs = effective?.preferences;
+    // ─── Sources ─────────────────────────────────────────────────────────
+    sections.push({
+        title: "Sources",
+        rows: [
+            { label: "Global", value: globalPrefs ? globalPrefs.path : `(none) ${getGlobalGSDPreferencesPath()}` },
+            { label: "Project", value: projectPrefs ? projectPrefs.path : `(none) ${getProjectGSDPreferencesPath()}` },
+        ],
+    });
+    // ─── Profile ─────────────────────────────────────────────────────────
+    const profile = resolveEffectiveProfile();
+    const profileRows = [
+        { label: "Token profile", value: `${profile}${!prefs?.token_profile ? " (default)" : ""}`, accent: true },
+    ];
+    if (prefs?.mode)
+        profileRows.push({ label: "Workflow mode", value: prefs.mode });
+    sections.push({ title: "Profile", rows: profileRows });
+    // ─── Models ──────────────────────────────────────────────────────────
+    const unitTypes = [
+        ["research", "research-milestone"],
+        ["planning", "plan-milestone"],
+        ["discuss", "discuss-milestone"],
+        ["execution", "execute-task"],
+        ["completion", "complete-slice"],
+        ["validation", "run-uat"],
+    ];
+    const modelRows = [];
+    for (const [label, unitType] of unitTypes) {
+        const resolved = resolveModelWithFallbacksForUnit(unitType);
+        if (resolved) {
+            let val = resolved.primary;
+            if (resolved.fallbacks.length > 0) {
+                val += ` \u2192 ${resolved.fallbacks.join(" \u2192 ")}`;
+            }
+            modelRows.push({ label, value: val });
+        }
+        else {
+            modelRows.push({ label, value: "(inherit)" });
+        }
+    }
+    // subagent is a direct config key
+    const models = prefs?.models;
+    const subVal = models?.subagent;
+    if (subVal) {
+        const model = typeof subVal === "string" ? subVal : subVal?.model ?? "?";
+        modelRows.push({ label: "subagent", value: model });
+    }
+    else {
+        modelRows.push({ label: "subagent", value: "(inherit)" });
+    }
+    sections.push({ title: "Models", rows: modelRows });
+    // ─── Dynamic Routing ─────────────────────────────────────────────────
+    const routing = resolveDynamicRoutingConfig();
+    const routingRows = [
+        { label: "Enabled", value: routing.enabled ? "yes" : "no", accent: routing.enabled },
+    ];
+    if (routing.enabled) {
+        routingRows.push({ label: "Escalate on fail", value: routing.escalate_on_failure !== false ? "yes" : "no" });
+        routingRows.push({ label: "Budget pressure", value: routing.budget_pressure !== false ? "yes" : "no" });
+        routingRows.push({ label: "Cross-provider", value: routing.cross_provider !== false ? "yes" : "no" });
+        if (routing.tier_models) {
+            const tm = routing.tier_models;
+            if (tm.light)
+                routingRows.push({ label: "[L] light", value: tm.light });
+            if (tm.standard)
+                routingRows.push({ label: "[S] standard", value: tm.standard });
+            if (tm.heavy)
+                routingRows.push({ label: "[H] heavy", value: tm.heavy });
+        }
+    }
+    sections.push({ title: "Dynamic Routing", rows: routingRows });
+    // ─── Git ─────────────────────────────────────────────────────────────
+    if (prefs?.git) {
+        const g = prefs.git;
+        const gitRows = [];
+        if (g.isolation !== undefined)
+            gitRows.push({ label: "Isolation", value: String(g.isolation) });
+        if (g.auto_push !== undefined)
+            gitRows.push({ label: "Auto push", value: String(g.auto_push) });
+        if (g.push_branches !== undefined)
+            gitRows.push({ label: "Push branches", value: String(g.push_branches) });
+        if (g.merge_strategy)
+            gitRows.push({ label: "Merge strategy", value: g.merge_strategy });
+        if (g.main_branch)
+            gitRows.push({ label: "Main branch", value: g.main_branch });
+        if (g.remote)
+            gitRows.push({ label: "Remote", value: g.remote });
+        if (gitRows.length > 0)
+            sections.push({ title: "Git", rows: gitRows });
+    }
+    // ─── Budget ──────────────────────────────────────────────────────────
+    if (prefs?.budget_ceiling !== undefined || prefs?.budget_enforcement) {
+        const budgetRows = [];
+        if (prefs.budget_ceiling !== undefined)
+            budgetRows.push({ label: "Ceiling", value: `$${prefs.budget_ceiling}` });
+        if (prefs.budget_enforcement)
+            budgetRows.push({ label: "Enforcement", value: String(prefs.budget_enforcement) });
+        sections.push({ title: "Budget", rows: budgetRows });
+    }
+    // ─── Auto Supervisor ─────────────────────────────────────────────────
+    if (prefs?.auto_supervisor) {
+        const sup = resolveAutoSupervisorConfig();
+        const supRows = [];
+        if (sup.model)
+            supRows.push({ label: "Model", value: sup.model });
+        supRows.push({ label: "Soft timeout", value: `${sup.soft_timeout_minutes}m` });
+        supRows.push({ label: "Idle timeout", value: `${sup.idle_timeout_minutes}m` });
+        supRows.push({ label: "Hard timeout", value: `${sup.hard_timeout_minutes}m` });
+        sections.push({ title: "Auto Supervisor", rows: supRows });
+    }
+    // ─── Toggles ─────────────────────────────────────────────────────────
+    const toggleRows = [];
+    if (prefs?.phases) {
+        const p = prefs.phases;
+        if (p.skip_research)
+            toggleRows.push({ label: "skip_research", value: "on" });
+        if (p.skip_reassess)
+            toggleRows.push({ label: "skip_reassess", value: "on" });
+        if (p.skip_slice_research)
+            toggleRows.push({ label: "skip_slice_research", value: "on" });
+        if (p.skip_milestone_validation)
+            toggleRows.push({ label: "skip_milestone_validation", value: "on" });
+        if (p.require_slice_discussion)
+            toggleRows.push({ label: "require_slice_discussion", value: "on" });
+    }
+    if (prefs?.uat_dispatch)
+        toggleRows.push({ label: "uat_dispatch", value: "on" });
+    if (prefs?.auto_visualize)
+        toggleRows.push({ label: "auto_visualize", value: "on" });
+    if (prefs?.auto_report === false)
+        toggleRows.push({ label: "auto_report", value: "off" });
+    if (prefs?.show_token_cost)
+        toggleRows.push({ label: "show_token_cost", value: "on" });
+    if (prefs?.forensics_dedup)
+        toggleRows.push({ label: "forensics_dedup", value: "on" });
+    if (prefs?.unique_milestone_ids)
+        toggleRows.push({ label: "unique_milestone_ids", value: "on" });
+    if (prefs?.service_tier)
+        toggleRows.push({ label: "service_tier", value: prefs.service_tier });
+    if (prefs?.search_provider && prefs.search_provider !== "auto")
+        toggleRows.push({ label: "search_provider", value: prefs.search_provider });
+    if (prefs?.context_selection)
+        toggleRows.push({ label: "context_selection", value: prefs.context_selection });
+    if (prefs?.widget_mode && prefs.widget_mode !== "full")
+        toggleRows.push({ label: "widget_mode", value: prefs.widget_mode });
+    if (prefs?.experimental?.rtk)
+        toggleRows.push({ label: "experimental.rtk", value: "on" });
+    if (toggleRows.length > 0)
+        sections.push({ title: "Toggles", rows: toggleRows });
+    // ─── Parallel ────────────────────────────────────────────────────────
+    if (prefs?.parallel) {
+        const pc = prefs.parallel;
+        const parallelRows = [];
+        if (pc.max_workers !== undefined)
+            parallelRows.push({ label: "Max workers", value: String(pc.max_workers) });
+        if (pc.merge_strategy)
+            parallelRows.push({ label: "Merge strategy", value: pc.merge_strategy });
+        if (pc.auto_merge)
+            parallelRows.push({ label: "Auto merge", value: pc.auto_merge });
+        if (parallelRows.length > 0)
+            sections.push({ title: "Parallel", rows: parallelRows });
+    }
+    // ─── Hooks ───────────────────────────────────────────────────────────
+    const postHooks = prefs?.post_unit_hooks?.filter(h => h.enabled !== false) ?? [];
+    const preHooks = prefs?.pre_dispatch_hooks?.filter(h => h.enabled !== false) ?? [];
+    if (postHooks.length > 0 || preHooks.length > 0) {
+        const hookRows = [];
+        if (preHooks.length > 0)
+            hookRows.push({ label: "Pre-dispatch", value: `${preHooks.length} active` });
+        if (postHooks.length > 0)
+            hookRows.push({ label: "Post-unit", value: `${postHooks.length} active` });
+        sections.push({ title: "Hooks", rows: hookRows });
+    }
+    // ─── Warnings ────────────────────────────────────────────────────────
+    const warnings = [
+        ...(globalPrefs?.warnings ?? []),
+        ...(projectPrefs?.warnings ?? []),
+    ];
+    if (warnings.length > 0) {
+        sections.push({
+            title: "Warnings",
+            rows: warnings.map(w => ({ label: "\u26a0", value: w })),
+        });
+    }
+    return sections;
+}
+// ─── Plain Text Formatter (headless/RPC fallback) ─────────────────────────
+export function formatConfigText() {
+    const sections = collectConfigSections();
+    const lines = ["GSD Configuration\n"];
+    let maxLabel = 0;
+    for (const section of sections) {
+        for (const row of section.rows) {
+            if (row.label.length > maxLabel)
+                maxLabel = row.label.length;
+        }
+    }
+    const pad = Math.min(maxLabel + 2, 24);
+    for (const section of sections) {
+        lines.push("");
+        lines.push(section.title.toUpperCase());
+        for (const row of section.rows) {
+            lines.push(`  ${row.label.padEnd(pad)}${row.value}`);
+        }
+    }
+    return lines.join("\n");
+}
+// ─── Overlay Class ────────────────────────────────────────────────────────
+export class GSDConfigOverlay {
+    tui;
+    theme;
+    onClose;
+    sections;
+    cachedLines;
+    scrollOffset = 0;
+    disposed = false;
+    constructor(tui, theme, onClose) {
+        this.tui = tui;
+        this.theme = theme;
+        this.onClose = onClose;
+        this.sections = collectConfigSections();
+    }
+    invalidate() {
+        this.cachedLines = undefined;
+    }
+    dispose() {
+        this.disposed = true;
+    }
+    handleInput(data) {
+        if (matchesKey(data, Key.escape) || data === "q") {
+            this.dispose();
+            this.onClose();
+            return;
+        }
+        if (matchesKey(data, Key.down) || data === "j") {
+            this.scrollOffset++;
+            this.cachedLines = undefined;
+            this.tui.requestRender();
+            return;
+        }
+        if (matchesKey(data, Key.up) || data === "k") {
+            this.scrollOffset = Math.max(0, this.scrollOffset - 1);
+            this.cachedLines = undefined;
+            this.tui.requestRender();
+            return;
+        }
+        if (matchesKey(data, Key.pageDown)) {
+            this.scrollOffset += 10;
+            this.cachedLines = undefined;
+            this.tui.requestRender();
+            return;
+        }
+        if (matchesKey(data, Key.pageUp)) {
+            this.scrollOffset = Math.max(0, this.scrollOffset - 10);
+            this.cachedLines = undefined;
+            this.tui.requestRender();
+            return;
+        }
+    }
+    render(width) {
+        if (this.cachedLines)
+            return this.cachedLines;
+        const t = this.theme;
+        const w = Math.max(width, 50);
+        const allLines = [];
+        // Header
+        allLines.push(t.bold(t.fg("accent", " GSD Configuration ")));
+        allLines.push(t.fg("muted", "\u2500".repeat(w)));
+        // Find max label width for alignment
+        let maxLabel = 0;
+        for (const section of this.sections) {
+            for (const row of section.rows) {
+                if (row.label.length > maxLabel)
+                    maxLabel = row.label.length;
+            }
+        }
+        const labelPad = Math.min(maxLabel + 2, 24);
+        for (const section of this.sections) {
+            allLines.push("");
+            allLines.push(t.bold(t.fg("accent", `  ${section.title}`)));
+            for (const row of section.rows) {
+                const label = t.fg("muted", `    ${row.label.padEnd(labelPad)}`);
+                const value = row.accent ? t.bold(row.value) : row.value;
+                allLines.push(truncateToWidth(`${label}${value}`, w));
+            }
+        }
+        allLines.push("");
+        allLines.push(t.fg("muted", `  ${"\u2500".repeat(w - 4)}`));
+        allLines.push(t.fg("muted", "  esc/q close  \u2502  \u2191\u2193/jk scroll  \u2502  /gsd prefs to edit"));
+        // Apply scroll
+        const maxScroll = Math.max(0, allLines.length - 20);
+        this.scrollOffset = Math.min(this.scrollOffset, maxScroll);
+        const visible = allLines.slice(this.scrollOffset);
+        this.cachedLines = visible;
+        return visible;
+    }
+}

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

@@ -945,7 +945,7 @@ function resolveVersionCatalogAccessors(basePath, versionCatalogFiles, settingsF
     }
     return accessors;
 }
-function scanProjectFiles(basePath) {
+export function scanProjectFiles(basePath) {
     const files = [];
     const queue = [{ path: basePath, depth: 0 }];
     while (queue.length > 0 && files.length < MAX_RECURSIVE_SCAN_FILES) {