@opengsd/gsd-pi 1.0.2-dev.867e002 → 1.0.2-dev.88c4dc5

package/dist/resources/extensions/gsd/unit-context-manifest.js

@@ -13,6 +13,8 @@
 //
 // Phased rollout tracking:
 //   - Phase 1 (this PR): schema + manifests + coverage test.
+//   - Phase 1b (skill token savings): skills policy wired via skill-scope.ts
+//     and setVisibleSkills(); allowlists derived from skill-manifest.ts.
 //   - Phase 2: add composeSystemPromptForUnit(); migrate one low-risk
 //     unit type (e.g. reassess-roadmap) as the pilot.
 //   - Phase 3: migrate remaining unit types, tighten manifests per
@@ -60,11 +62,18 @@ export const ARTIFACT_KEYS = [
     "templates",
 ];
 // ─── Manifests ────────────────────────────────────────────────────────────
-// Phase 1 policy: every manifest encodes today's behavior. Skills = "all"
-// unless the unit type was already narrowed via the existing skill-manifest
-// resolver (#4779). Memory/knowledge policies reflect the defaults in
-// `bootstrap/system-context.ts`. Artifact classifications follow what
-// `auto-prompts.ts` inlines today for each unit type.
+// Phase 1 policy: skills policy is derived from skill-manifest.ts allowlists
+// via `skillPolicyForUnit()`; units without an allowlist keep mode "all".
+// Explicit mode "none" remains for lightweight config units.
+import { resolveSkillManifest } from "./skill-manifest.js";
+/** Derive skills policy from skill-manifest allowlists; default to full catalog. */
+function skillPolicyForUnit(unitType) {
+    const allowlist = resolveSkillManifest(unitType);
+    if (allowlist) {
+        return { mode: "allowlist", skills: allowlist };
+    }
+    return { mode: "all" };
+}
 const COMMON_BUDGET_LARGE = 1_500_000; // ~400K tokens
 const COMMON_BUDGET_MEDIUM = 750_000; // ~200K tokens
 const COMMON_BUDGET_SMALL = 250_000; // ~65K tokens
@@ -136,7 +145,7 @@ export const KNOWN_UNIT_TYPES = [
 export const UNIT_MANIFESTS = {
     // ─── Milestone-scoped ────────────────────────────────────────────────
     "research-milestone": {
-        skills: { mode: "all" },
+        skills: skillPolicyForUnit("research-milestone"),
         knowledge: "full",
         memory: "prompt-relevant",
         codebaseMap: true,
@@ -153,7 +162,7 @@ export const UNIT_MANIFESTS = {
         maxSystemPromptChars: COMMON_BUDGET_MEDIUM,
     },
     "plan-milestone": {
-        skills: { mode: "all" },
+        skills: skillPolicyForUnit("plan-milestone"),
         knowledge: "full",
         memory: "prompt-relevant",
         codebaseMap: true,
@@ -168,7 +177,7 @@ export const UNIT_MANIFESTS = {
         maxSystemPromptChars: COMMON_BUDGET_LARGE,
     },
     "discuss-milestone": {
-        skills: { mode: "all" },
+        skills: skillPolicyForUnit("discuss-milestone"),
         knowledge: "full",
         memory: "prompt-relevant",
         codebaseMap: true,
@@ -183,7 +192,7 @@ export const UNIT_MANIFESTS = {
         maxSystemPromptChars: COMMON_BUDGET_MEDIUM,
     },
     "validate-milestone": {
-        skills: { mode: "all" },
+        skills: skillPolicyForUnit("validate-milestone"),
         knowledge: "scoped",
         memory: "prompt-relevant",
         codebaseMap: false,
@@ -200,7 +209,7 @@ export const UNIT_MANIFESTS = {
         maxSystemPromptChars: COMMON_BUDGET_LARGE,
     },
     "complete-milestone": {
-        skills: { mode: "all" },
+        skills: skillPolicyForUnit("complete-milestone"),
         knowledge: "scoped",
         memory: "prompt-relevant",
         codebaseMap: false,
@@ -221,7 +230,7 @@ export const UNIT_MANIFESTS = {
     },
     // ─── Slice-scoped ────────────────────────────────────────────────────
     "research-slice": {
-        skills: { mode: "all" },
+        skills: skillPolicyForUnit("research-slice"),
         knowledge: "full",
         memory: "prompt-relevant",
         codebaseMap: true,
@@ -238,7 +247,7 @@ export const UNIT_MANIFESTS = {
         maxSystemPromptChars: COMMON_BUDGET_MEDIUM,
     },
     "plan-slice": {
-        skills: { mode: "all" },
+        skills: skillPolicyForUnit("plan-slice"),
         knowledge: "full",
         memory: "prompt-relevant",
         codebaseMap: true,
@@ -256,7 +265,7 @@ export const UNIT_MANIFESTS = {
         maxSystemPromptChars: COMMON_BUDGET_LARGE,
     },
     "refine-slice": {
-        skills: { mode: "all" },
+        skills: skillPolicyForUnit("refine-slice"),
         knowledge: "scoped",
         memory: "prompt-relevant",
         codebaseMap: true,
@@ -274,7 +283,7 @@ export const UNIT_MANIFESTS = {
         maxSystemPromptChars: COMMON_BUDGET_MEDIUM,
     },
     "replan-slice": {
-        skills: { mode: "all" },
+        skills: skillPolicyForUnit("replan-slice"),
         knowledge: "scoped",
         memory: "prompt-relevant",
         codebaseMap: true,
@@ -289,7 +298,7 @@ export const UNIT_MANIFESTS = {
         maxSystemPromptChars: COMMON_BUDGET_MEDIUM,
     },
     "complete-slice": {
-        skills: { mode: "all" },
+        skills: skillPolicyForUnit("complete-slice"),
         knowledge: "scoped",
         memory: "prompt-relevant",
         codebaseMap: false,
@@ -310,7 +319,7 @@ export const UNIT_MANIFESTS = {
         maxSystemPromptChars: COMMON_BUDGET_LARGE,
     },
     "reassess-roadmap": {
-        skills: { mode: "all" },
+        skills: skillPolicyForUnit("reassess-roadmap"),
         knowledge: "scoped",
         memory: "critical-only",
         codebaseMap: false,
@@ -326,7 +335,7 @@ export const UNIT_MANIFESTS = {
     },
     // ─── Task-scoped ─────────────────────────────────────────────────────
     "execute-task": {
-        skills: { mode: "all" },
+        skills: skillPolicyForUnit("execute-task"),
         knowledge: "scoped",
         memory: "prompt-relevant",
         codebaseMap: true,
@@ -341,7 +350,7 @@ export const UNIT_MANIFESTS = {
         maxSystemPromptChars: COMMON_BUDGET_LARGE,
     },
     "reactive-execute": {
-        skills: { mode: "all" },
+        skills: skillPolicyForUnit("reactive-execute"),
         knowledge: "scoped",
         memory: "prompt-relevant",
         codebaseMap: true,
@@ -357,7 +366,7 @@ export const UNIT_MANIFESTS = {
     },
     // ─── Ancillary units ─────────────────────────────────────────────────
     "run-uat": {
-        skills: { mode: "all" },
+        skills: skillPolicyForUnit("run-uat"),
         knowledge: "critical-only",
         memory: "critical-only",
         codebaseMap: false,
@@ -372,7 +381,7 @@ export const UNIT_MANIFESTS = {
         maxSystemPromptChars: COMMON_BUDGET_SMALL,
     },
     "gate-evaluate": {
-        skills: { mode: "all" },
+        skills: skillPolicyForUnit("gate-evaluate"),
         knowledge: "critical-only",
         memory: "critical-only",
         codebaseMap: false,
@@ -389,7 +398,7 @@ export const UNIT_MANIFESTS = {
         maxSystemPromptChars: COMMON_BUDGET_SMALL,
     },
     "rewrite-docs": {
-        skills: { mode: "all" },
+        skills: skillPolicyForUnit("rewrite-docs"),
         knowledge: "scoped",
         memory: "prompt-relevant",
         codebaseMap: true,
@@ -404,7 +413,7 @@ export const UNIT_MANIFESTS = {
         maxSystemPromptChars: COMMON_BUDGET_MEDIUM,
     },
     "triage-captures": {
-        skills: { mode: "all" },
+        skills: skillPolicyForUnit("triage-captures"),
         knowledge: "scoped",
         memory: "prompt-relevant",
         codebaseMap: false,
@@ -419,7 +428,7 @@ export const UNIT_MANIFESTS = {
         maxSystemPromptChars: COMMON_BUDGET_MEDIUM,
     },
     "quick-task": {
-        skills: { mode: "all" },
+        skills: skillPolicyForUnit("quick-task"),
         knowledge: "full",
         memory: "prompt-relevant",
         codebaseMap: true,
@@ -456,7 +465,7 @@ export const UNIT_MANIFESTS = {
     // discussion runs before any milestone exists, so milestone artifacts are
     // not loaded. Keeps templates available for PROJECT.md scaffolding.
     "discuss-project": {
-        skills: { mode: "all" },
+        skills: skillPolicyForUnit("discuss-project"),
         knowledge: "scoped",
         memory: "prompt-relevant",
         codebaseMap: true,
@@ -473,7 +482,7 @@ export const UNIT_MANIFESTS = {
     // discuss-requirements: REQUIREMENTS.md interview. PROJECT.md is the
     // primary context input; templates carry the requirements format.
     "discuss-requirements": {
-        skills: { mode: "all" },
+        skills: skillPolicyForUnit("discuss-requirements"),
         knowledge: "scoped",
         memory: "prompt-relevant",
         codebaseMap: true,
@@ -509,7 +518,7 @@ export const UNIT_MANIFESTS = {
     // planning-dispatch policy to dispatch them. PROJECT.md + REQUIREMENTS.md
     // give the orchestrator the framing context.
     "research-project": {
-        skills: { mode: "all" },
+        skills: skillPolicyForUnit("research-project"),
         knowledge: "scoped",
         memory: "prompt-relevant",
         codebaseMap: true,

package/dist/resources/extensions/gsd/user-input-boundary.js

@@ -29,7 +29,7 @@ function extractTextFromMessage(msg) {
     }
     return parts.join("\n");
 }
-function lastAssistantText(messages) {
+export function lastAssistantText(messages) {
     if (!Array.isArray(messages))
         return "";
     for (let i = messages.length - 1; i >= 0; i--) {

package/dist/resources/extensions/gsd/vision-ask.js

@@ -0,0 +1,22 @@
+/**
+ * Natural-language openers for milestone discussion.
+ *
+ * Keep these short and conversational. They are often the user's first prompt
+ * when GSD starts shaping a project or milestone, so they should feel like a
+ * collaborator starting a working session rather than a form field.
+ */
+import { randomInt } from "node:crypto";
+export const VISION_ASK_VARIANTS = [
+    "What are we building?",
+    "What do you want to make next?",
+    "What should this become?",
+    "What are you picturing?",
+    "Where should we take this?",
+    "What should this milestone unlock?",
+    "Tell me what you want to build.",
+    "What should GSD help you shape?",
+];
+export function chooseVisionAskVariant(pickIndex = randomInt) {
+    const index = pickIndex(VISION_ASK_VARIANTS.length);
+    return VISION_ASK_VARIANTS[index] ?? VISION_ASK_VARIANTS[0];
+}

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

@@ -1,4 +1,4 @@
-import { truncateToWidth, visibleWidth, matchesKey, Key } from "@gsd/pi-tui";
+import { visibleWidth, matchesKey, Key } from "@gsd/pi-tui";
 import { loadVisualizerData } from "./visualizer-data.js";
 import { renderProgressView, renderDepsView, renderMetricsView, renderTimelineView, renderAgentView, renderChangelogView, renderExportView, renderKnowledgeView, renderCapturesView, renderHealthView, } from "./visualizer-views.js";
 import { writeFileSync, mkdirSync } from "node:fs";
@@ -6,6 +6,7 @@ import { join } from "node:path";
 import { writeExportFile } from "./export.js";
 import { gsdRoot } from "./paths.js";
 import { stripAnsi } from "../shared/mod.js";
+import { renderDialogFrame, renderKeyHints } from "./tui/render-kit.js";
 export const TAB_COUNT = 10;
 const TAB_LABELS = [
     "1 Progress",
@@ -440,51 +441,22 @@ export class GSDVisualizerOverlay {
         }
         // Apply scroll
         const viewportHeight = Math.max(5, process.stdout.rows ? process.stdout.rows - 8 : 24);
-        const chromeHeight = 2;
-        const visibleContentRows = Math.max(1, viewportHeight - chromeHeight);
+        const visibleContentRows = Math.max(1, viewportHeight - 4);
         this.lastVisibleRows = visibleContentRows;
         const totalLines = content.length;
         const maxScroll = Math.max(0, content.length - visibleContentRows);
         this.scrollOffsets[this.activeTab] = Math.min(this.scrollOffsets[this.activeTab], maxScroll);
         const offset = this.scrollOffsets[this.activeTab];
         const visibleContent = content.slice(offset, offset + visibleContentRows);
-        const lines = this.wrapInBox(visibleContent, width, offset, visibleContentRows, totalLines);
-        // Footer hint
-        const hint = th.fg("dim", "Tab/Shift+Tab/1-9,0 switch \u00b7 / filter \u00b7 PgUp/PgDn scroll \u00b7 ? help \u00b7 esc close");
-        const hintVis = visibleWidth(hint);
-        const hintPad = Math.max(0, Math.floor((width - hintVis) / 2));
-        lines.push(" ".repeat(hintPad) + hint);
+        const footer = renderKeyHints(th, ["Tab/Shift+Tab/1-9,0 switch", "/ filter", "PgUp/PgDn scroll", "? help", "esc close"], Math.max(1, width - 4));
+        const lines = renderDialogFrame(th, "GSD Visualizer", visibleContent, width, {
+            footer,
+            scroll: { offset, visibleRows: visibleContentRows, totalRows: totalLines },
+        });
         this.cachedWidth = width;
         this.cachedLines = lines;
         return lines;
     }
-    wrapInBox(inner, width, offset, visibleRows, totalLines) {
-        const th = this.theme;
-        const border = (s) => th.fg("borderAccent", s);
-        const innerWidth = width - 4;
-        const lines = [];
-        lines.push(border("\u256d" + "\u2500".repeat(width - 2) + "\u256e"));
-        // Compute scroll indicator positions
-        const scrollable = totalLines !== undefined && visibleRows !== undefined && totalLines > visibleRows;
-        let thumbStart = -1;
-        let thumbLen = 0;
-        const innerRows = inner.length;
-        if (scrollable && innerRows > 0 && totalLines > 0) {
-            thumbStart = Math.round(((offset ?? 0) / totalLines) * innerRows);
-            thumbLen = Math.max(1, Math.round((visibleRows / totalLines) * innerRows));
-        }
-        for (let i = 0; i < inner.length; i++) {
-            const line = inner[i];
-            const truncated = truncateToWidth(line, innerWidth);
-            const padWidth = Math.max(0, innerWidth - visibleWidth(truncated));
-            const rightBorder = scrollable && i >= thumbStart && i < thumbStart + thumbLen
-                ? border("\u2503")
-                : border("\u2502");
-            lines.push(border("\u2502") + " " + truncated + " ".repeat(padWidth) + " " + rightBorder);
-        }
-        lines.push(border("\u2570" + "\u2500".repeat(width - 2) + "\u256f"));
-        return lines;
-    }
     invalidate() {
         this.cachedWidth = undefined;
         this.cachedLines = undefined;

package/dist/resources/extensions/gsd/worktree-lifecycle.js

@@ -203,7 +203,7 @@ function validateMilestoneId(milestoneId) {
  *   - emits worktree-created telemetry on successful entry
  *   - notifies the caller via `ctx.notify` for every user-visible outcome
  */
-export function _enterMilestoneCore(s, deps, milestoneId, ctx) {
+export function _enterMilestoneCore(s, deps, milestoneId, ctx, opts = {}) {
     if (!isValidMilestoneId(milestoneId)) {
         debugLog("WorktreeLifecycle", {
             action: "enterMilestone",
@@ -305,7 +305,7 @@ export function _enterMilestoneCore(s, deps, milestoneId, ctx) {
     // Handles the case where originalBasePath is falsy and basePath is itself
     // a worktree path — prevents double-nested worktree paths (#3729).
     const basePath = resolveWorktreeProjectRoot(s.basePath, s.originalBasePath);
-    const mode = getIsolationMode(basePath);
+    const mode = opts.modeOverride ?? getIsolationMode(basePath);
     if (s.isolationDegraded) {
         if (mode === "worktree") {
             try {
@@ -841,7 +841,8 @@ export function mergeMilestoneStandalone(deps, mctx) {
             pushed: false,
         };
     }
-    const mode = getIsolationMode(originalBasePath || worktreeBasePath);
+    const mode = mctx.isolationModeOverride ??
+        getIsolationMode(originalBasePath || worktreeBasePath);
     debugLog("WorktreeLifecycle", {
         action: "mergeAndExit",
         milestoneId,
@@ -1137,6 +1138,7 @@ export class WorktreeLifecycle {
                 originalBasePath: this.s.originalBasePath,
                 worktreeBasePath: this.s.basePath,
                 milestoneId,
+                isolationModeOverride: this.s.strandedRecoveryIsolationMode ?? undefined,
                 isolationDegraded: this.s.isolationDegraded,
                 notify: ctx.notify,
             });
@@ -1223,6 +1225,7 @@ export class WorktreeLifecycle {
             // Rebuild GitService after merge (branch HEAD changed)
             rebuildGitService(this.s, this.deps);
         }
+        this.s.strandedRecoveryIsolationMode = null;
         return result;
     }
     // ── Removed: _mergeWorktreeMode / _mergeBranchMode bodies ────────────
@@ -1345,6 +1348,24 @@ export class WorktreeLifecycle {
     resumeFromPausedSession(base, persistedWorktreePath) {
         this.s.basePath = resolvePausedResumeBasePath(base, persistedWorktreePath);
     }
+    /**
+     * Adopt in-progress stranded work during bootstrap.
+     *
+     * Unlike completed-orphan recovery, this does not merge, delete, or commit.
+     * It only moves the live session onto the branch/worktree proven by the
+     * audit evidence, while preserving that mode for the eventual merge.
+     */
+    adoptStrandedMilestone(milestoneId, base, ctx, opts) {
+        this.adoptSessionRoot(base);
+        this.s.strandedRecoveryIsolationMode = opts.mode;
+        const result = _enterMilestoneCore(this.s, this.deps, milestoneId, ctx, {
+            modeOverride: opts.mode,
+        });
+        if (!result.ok) {
+            this.s.strandedRecoveryIsolationMode = null;
+        }
+        return result;
+    }
     /**
      * Adopt an orphan worktree for a bootstrap-time merge (ADR-016 phase 2 / B4,
      * issue #5622).

package/dist/resources/extensions/search-the-web/native-search.js

@@ -12,6 +12,45 @@ export const BRAVE_TOOL_NAMES = ["search-the-web", "search_and_read"];
 export const CUSTOM_SEARCH_TOOL_NAMES = ["search-the-web", "search_and_read", "google_search"];
 /** Thinking block types that require signature validation by the API */
 const THINKING_TYPES = new Set(["thinking", "redacted_thinking"]);
+const NATIVE_SERVER_TOOL_USE_TYPES = new Set([
+    "server_tool_use",
+    "serverToolUse",
+]);
+const NATIVE_WEB_SEARCH_RESULT_TYPES = new Set([
+    "web_search_tool_result",
+    "webSearchResult",
+]);
+function nativeServerToolId(block) {
+    if (!NATIVE_SERVER_TOOL_USE_TYPES.has(block?.type))
+        return undefined;
+    return typeof block.id === "string" ? block.id : undefined;
+}
+function nativeWebSearchResultId(block) {
+    if (!NATIVE_WEB_SEARCH_RESULT_TYPES.has(block?.type))
+        return undefined;
+    const id = block.type === "webSearchResult" ? block.toolUseId : block.tool_use_id;
+    return typeof id === "string" ? id : undefined;
+}
+function hasCompleteNativeServerToolReplay(content) {
+    const pendingToolUseIds = new Set();
+    let sawNativeServerToolUse = false;
+    for (const block of content) {
+        const toolUseId = nativeServerToolId(block);
+        if (toolUseId !== undefined) {
+            if (pendingToolUseIds.has(toolUseId))
+                return false;
+            sawNativeServerToolUse = true;
+            pendingToolUseIds.add(toolUseId);
+            continue;
+        }
+        const resultId = nativeWebSearchResultId(block);
+        if (resultId !== undefined) {
+            if (!pendingToolUseIds.delete(resultId))
+                return false;
+        }
+    }
+    return sawNativeServerToolUse && pendingToolUseIds.size === 0;
+}
 /**
  * Providers whose Anthropic-Messages endpoint is known to accept the native
  * `web_search_20250305` server tool. Anthropic-shaped transports NOT in this
@@ -30,6 +69,10 @@ const NATIVE_WEB_SEARCH_PROVIDERS = new Set([
     "anthropic-vertex",
     "vercel-ai-gateway",
 ]);
+function looksLikeAnthropicModelName(modelName) {
+    const normalized = modelName.trim().toLowerCase();
+    return normalized.startsWith("claude-") || normalized.startsWith("anthropic/claude-");
+}
 /**
  * True when the model is an Anthropic-shaped transport AND the provider is
  * known to accept the native `web_search_20250305` tool. Gate both on api
@@ -74,11 +117,10 @@ export function preferBraveSearch() {
  * those blocks. The Anthropic API detects the modification and rejects the
  * request with "thinking blocks cannot be modified."
  *
- * Fix: Remove thinking blocks from all assistant messages in the history.
- * In Anthropic's Messages API, the messages array always ends with a user
- * message, so every assistant message is from a previous turn that has been
- * through a store/replay cycle. The model generates fresh thinking for the
- * current turn regardless.
+ * Fix: Remove thinking blocks only from assistant messages that do not carry
+ * native server-tool blocks. Complete native server-tool histories can be
+ * replayed as-is; stripping thinking from those messages is itself a latest
+ * assistant message modification.
  */
 export function stripThinkingFromHistory(messages) {
     for (const msg of messages) {
@@ -87,6 +129,9 @@ export function stripThinkingFromHistory(messages) {
         const content = msg.content;
         if (!Array.isArray(content))
             continue;
+        if (hasCompleteNativeServerToolReplay(content)) {
+            continue;
+        }
         msg.content = content.filter((block) => !THINKING_TYPES.has(block?.type));
     }
 }
@@ -152,6 +197,8 @@ export function registerNativeSearchHooks(pi) {
         // The model name heuristic is needed for session restores where
         // modelsAreEqual suppresses model_select AND the SDK doesn't pass model.
         const eventModel = event.model;
+        const payloadModelName = typeof payload.model === "string" ? payload.model : "";
+        const payloadLooksAnthropic = payloadModelName ? looksLikeAnthropicModelName(payloadModelName) : undefined;
         let isAnthropic;
         if (eventModel?.api || eventModel?.provider) {
             // Preferred path: gate on api shape + provider allowlist. Both fields
@@ -161,13 +208,15 @@ export function registerNativeSearchHooks(pi) {
             isAnthropic = supportsNativeWebSearch(eventModel);
         }
         else if (modelSelectFired) {
-            isAnthropic = isAnthropicProvider;
+            // The model_select flag can be stale if the next request omits event.model
+            // after a provider switch. A concrete non-Claude payload must win so an
+            // Anthropic-only tool never leaks into OpenAI Responses requests.
+            isAnthropic = isAnthropicProvider && payloadLooksAnthropic !== false;
         }
         else {
             // Last resort: session-restore paths where the SDK doesn't pass model.
             // The model-name prefix is best-effort and assumes direct Anthropic.
-            const modelName = typeof payload.model === "string" ? payload.model : "";
-            isAnthropic = modelName.startsWith("claude-");
+            isAnthropic = payloadLooksAnthropic === true;
         }
         if (!isAnthropic)
             return;

package/dist/resources/extensions/shared/confirm-ui.js

@@ -15,6 +15,7 @@
  *   if (!confirmed) return textResult("Cancelled.");
  */
 import { Key, matchesKey, truncateToWidth } from "@gsd/pi-tui";
+import { renderSharedDialogFrame } from "./dialog-frame.js";
 import { makeUI, GLYPH } from "./ui.js";
 /**
  * Show a themed yes/no confirmation dialog.
@@ -69,12 +70,13 @@ export async function showConfirm(ctx, opts) {
         function render(width) {
             if (cachedLines)
                 return cachedLines;
-            const ui = makeUI(theme, width);
+            const contentWidth = Math.max(1, width - 4);
+            const ui = makeUI(theme, contentWidth);
             const lines = [];
             const push = (...rows) => { for (const r of rows)
                 lines.push(...r); };
-            push(ui.bar(), ui.blank(), ui.header(`  ${opts.title}`), ui.blank(), ui.subtitle(`  ${opts.message}`), ui.blank());
-            const add = (s) => truncateToWidth(s, width);
+            push(ui.blank(), ui.subtitle(`  ${opts.message}`), ui.blank());
+            const add = (s) => truncateToWidth(s, contentWidth);
             const option = (num, label, selected) => {
                 if (selected) {
                     return add(`  ${theme.fg("accent", GLYPH.cursor)} ${theme.fg("accent", `${num}. ${label}`)}`);
@@ -83,9 +85,10 @@ export async function showConfirm(ctx, opts) {
             };
             lines.push(option(1, yesLabel, cursor === 0));
             lines.push(option(2, noLabel, cursor === 1));
-            push(ui.blank(), ui.hints(["↑/↓ to choose", "y/n to quick-select", "enter to confirm"]), ui.bar());
-            cachedLines = lines;
-            return lines;
+            push(ui.blank());
+            const footer = ui.hints(["↑/↓ to choose", "y/n to quick-select", "enter to confirm"])[0] ?? "";
+            cachedLines = renderSharedDialogFrame(theme, opts.title, lines, width, { footer });
+            return cachedLines;
         }
         return {
             render,

package/dist/resources/extensions/shared/dialog-frame.js

@@ -0,0 +1,42 @@
+import { truncateToWidth, visibleWidth } from "@gsd/pi-tui";
+function safeLine(text, width) {
+    return truncateToWidth(text, width, "");
+}
+function padVisible(text, width) {
+    const clipped = safeLine(text, width);
+    return clipped + " ".repeat(Math.max(0, width - visibleWidth(clipped)));
+}
+function renderTopBorder(theme, title, width, border) {
+    const trimmedTitle = title.trim();
+    if (!trimmedTitle || width < 10) {
+        return border("╭" + "─".repeat(width - 2) + "╮");
+    }
+    const safeTitle = safeLine(trimmedTitle, Math.max(0, width - 7));
+    const fill = Math.max(0, width - visibleWidth(safeTitle) - 5);
+    return border("╭─ ") + theme.bold(theme.fg("accent", safeTitle)) + border(" " + "─".repeat(fill) + "╮");
+}
+export function renderSharedDialogFrame(theme, title, inner, width, options = {}) {
+    if (width < 4)
+        return inner.map((line) => safeLine(line, width));
+    const paddingX = Math.max(0, options.paddingX ?? 1);
+    const contentWidth = Math.max(0, width - 2 - paddingX * 2);
+    const border = (text) => theme.fg(options.borderColor ?? "borderAccent", text);
+    const pad = " ".repeat(paddingX);
+    const lines = [renderTopBorder(theme, title, width, border)];
+    for (const line of inner) {
+        lines.push(border("│") + pad + padVisible(line, contentWidth) + pad + border("│"));
+    }
+    const footer = Array.isArray(options.footer)
+        ? options.footer
+        : options.footer
+            ? [options.footer]
+            : [];
+    if (footer.length > 0) {
+        lines.push(border("├" + "─".repeat(width - 2) + "┤"));
+        for (const line of footer) {
+            lines.push(border("│") + pad + padVisible(line, contentWidth) + pad + border("│"));
+        }
+    }
+    lines.push(border("╰" + "─".repeat(width - 2) + "╯"));
+    return lines;
+}