@ouro.bot/cli 0.1.0-alpha.445 → 0.1.0-alpha.446

package/README.md

@@ -99,7 +99,7 @@ Task docs do not live in this repo anymore. Planning and doing docs live in the
 - Vault unlock material is local machine state. Prefer macOS Keychain, Windows DPAPI, or Linux Secret Service; plaintext fallback is allowed only by explicit human choice.
 - New vault unlock secrets are confirmed before use and rejected if they do not meet the minimum strength requirements.
 - Provider and runtime credentials are loaded into process memory at startup/auth/unlock/refresh and reused. The remote vault is not queried for every model or sense request.
-- Human TTY commands share one CLI surface family: bare `ouro` opens the home deck, `ouro up`/`ouro connect`/`ouro auth verify`/`ouro repair` reuse the same readiness truth, and `ouro help`/`ouro whoami`/`ouro versions`/`ouro hatch` render from the same Ouro-branded board layer.
+- Human TTY commands share one CLI surface family: bare `ouro` opens the home deck, `ouro up` uses the boot checklist, `ouro connect`/`ouro auth verify`/`ouro repair` reuse the same readiness truth, and `ouro help`/`ouro whoami`/`ouro versions`/`ouro hatch` render through the same Ouro-branded wizard/guide language instead of raw transcript walls.
 - Human-facing CLI commands that can wait on browser auth, vault IO, daemon startup, daemon restart, provider checks, or connector setup use a shared progress checklist. If a cursor may blink for more than a few seconds, the command should print or animate the current step instead of going quiet.
 - CLI commands that mutate bundle config, such as vault setup or `ouro connect bluebubbles`, run bundle sync after the change when `sync.enabled` is true and report a compact `bundle sync:` line.
 - The daemon discovers bundles dynamically from `~/AgentBundles`.

package/changelog.json

@@ -1,6 +1,14 @@
 {
   "_note": "This changelog is maintained as part of the PR/version-bump workflow. Agent-curated, not auto-generated. Agents read this file directly via read_file to understand what changed between versions.",
   "versions": [
+    {
+      "version": "0.1.0-alpha.446",
+      "changes": [
+        "`ouro connect`, the home deck, readiness repair prompts, and the interactive repair queue now render through one shared wizard language instead of a mix of framed panels and transcript walls. Humans can choose by number or name, see one recommended next step, and keep the same visual footing across setup and repair.",
+        "Connector, auth, vault, hatch, and other info-heavy command flows now use a matching guide surface with the same Ouro masthead, ruled sections, and `Next moves` treatment, so the CLI stops jumping between unrelated visual grammars as soon as a command leaves the root menu.",
+        "The new surfaces stay truthful to the underlying work: connect still runs the shared live provider verification path before rendering, repair prompts surface the real next command without dead air, and new renderer plus command-layer coverage lock the wizard/guide family into the shipped CLI."
+      ]
+    },
     {
       "version": "0.1.0-alpha.445",
       "changes": [

package/dist/heart/daemon/agentic-repair.js

@@ -52,6 +52,8 @@ function makeInteractiveRepairDeps(deps) {
         runAuthFlow: deps.runAuthFlow ?? (async () => undefined),
         runVaultUnlock: deps.runVaultUnlock,
         skipQueueSummary: deps.skipQueueSummary,
+        isTTY: deps.isTTY,
+        stdoutColumns: deps.stdoutColumns,
     };
 }
 async function runDeterministicRepair(degraded, deps) {

package/dist/heart/daemon/cli-exec.js

@@ -4316,6 +4316,8 @@ async function runOuroCli(args, deps = (0, cli_defaults_1.createDefaultOuroCliDe
                             await executeVaultUnlock({ kind: "vault.unlock", agent }, deps);
                         },
                         skipQueueSummary: true,
+                        isTTY: deps.isTTY ?? process.stdout.isTTY === true,
+                        stdoutColumns: deps.stdoutColumns ?? process.stdout.columns,
                     });
                     if (repairResult.repairsAttempted) {
                         repairsAttempted = true;

package/dist/heart/daemon/connect-bay.js

@@ -17,52 +17,6 @@ const CONNECT_STATUS_PRIORITY = {
     ready: 6,
     attached: 6,
 };
-const RESET = "\x1b[0m";
-const BOLD = "\x1b[1m";
-const TEAL = "\x1b[38;2;78;201;176m";
-const GREEN = "\x1b[38;2;46;204;64m";
-const GOLD = "\x1b[38;2;230;190;50m";
-const BONE = "\x1b[38;2;238;242;234m";
-const MIST = "\x1b[38;2;165;184;168m";
-const ANSI_RE = /\x1b\[[0-9;]*m/g;
-function stripAnsi(text) {
-    return text.replace(ANSI_RE, "");
-}
-function visibleLength(text) {
-    return stripAnsi(text).length;
-}
-function padAnsi(text, width) {
-    const missing = Math.max(0, width - visibleLength(text));
-    return `${text}${" ".repeat(missing)}`;
-}
-function wrapPlain(text, width) {
-    const normalized = text.trim();
-    if (!normalized)
-        return [""];
-    const words = normalized.split(/\s+/);
-    const lines = [];
-    let current = "";
-    for (const word of words) {
-        if (!current) {
-            current = word;
-            continue;
-        }
-        const candidate = `${current} ${word}`;
-        if (candidate.length <= width) {
-            current = candidate;
-            continue;
-        }
-        lines.push(current);
-        current = word;
-    }
-    lines.push(current);
-    return lines;
-}
-function tty(text, color, bold = false) {
-    if (bold)
-        return `${color}${BOLD}${text}${RESET}`;
-    return `${color}${text}${RESET}`;
-}
 function escapeRegExp(value) {
     return value.replace(/[.*+?^${}()|[\]\\]/g, "\\$&");
 }
@@ -133,213 +87,65 @@ function resolveProviderHealthCommand(providerHealth, status) {
 function isProblemStatus(status) {
     return status !== "ready" && status !== "attached";
 }
-function statusChip(status) {
-    const symbol = status === "ready" || status === "attached"
-        ? "●"
-        : status === "not attached"
-            ? "◌"
-            : "◆";
-    const label = `${symbol} ${status}`;
-    if (status === "ready" || status === "attached")
-        return tty(label, GREEN, true);
-    if (status === "not attached")
-        return tty(label, MIST);
-    return tty(label, GOLD, true);
-}
-function sectionTitle(title, width) {
-    const plain = `╭─ ${title} `;
-    const rule = "─".repeat(Math.max(0, width - plain.length - 1));
-    return `${tty("╭─ ", TEAL)}${tty(title, BONE, true)}${tty(` ${rule}╮`, TEAL)}`;
-}
-function bottomRule(width) {
-    const line = `╰${"─".repeat(Math.max(0, width - 2))}╯`;
-    return tty(line, TEAL);
-}
-function bodyLine(text, width) {
-    const padded = padAnsi(text, Math.max(0, width - 4));
-    return `${tty("│ ", TEAL)}${padded}${tty(" │", TEAL)}`;
-}
-function panel(title, body, width) {
-    const lines = [sectionTitle(title, width)];
-    for (const line of body) {
-        lines.push(bodyLine(line, width));
-    }
-    lines.push(bottomRule(width));
-    return lines;
-}
-function renderHeader(agent, width) {
-    return panel(`${agent} connections`, [
-        tty("Set up or review one capability at a time.", BONE, true),
-        tty("Everything on this screen was checked live just now.", MIST),
-    ], width);
+function providerEntrySummary(entry) {
+    return entry.description ?? "Selected provider lanes for this machine.";
 }
-function nextMoveBody(entry) {
-    if (!entry) {
-        return [
-            tty("Everything here is ready.", BONE, true),
-            tty("Pick what you want to review or refresh.", MIST),
-        ];
-    }
-    const lines = [
-        `${entry.name}  ${statusChip(entry.status)}`,
-    ];
-    if (entry.nextNote)
-        lines.push(entry.nextNote);
-    if (entry.nextAction)
-        lines.push(tty(entry.nextAction, MIST));
-    return lines;
-}
-function renderProviderBody(entry, width) {
-    const lines = [
-        `${entry.option}  ${entry.name}  ${statusChip(entry.status)}`,
-    ];
-    const lanes = entry.laneSummaries ?? [];
-    for (const [index, lane] of lanes.entries()) {
-        if (index > 0)
-            lines.push("");
-        const laneLabel = lane.lane === "outward" ? "Outward lane" : "Inner lane";
-        lines.push(tty(laneLabel, BONE, true));
-        lines.push(lane.title);
-        lines.push(isProblemStatus(lane.status) ? lane.detail : tty(lane.detail, MIST));
-    }
-    if (lanes.length === 0) {
-        for (const detail of entry.detailLines ?? [])
-            lines.push(detail);
-    }
-    return normalizeWrappedBody(lines, width);
-}
-function renderCapabilityBody(entries, width) {
+function providerEntryDetailLines(entry) {
     const lines = [];
-    for (const [index, entry] of entries.entries()) {
-        if (index > 0)
-            lines.push("");
-        lines.push(`${entry.option}  ${entry.name}  ${statusChip(entry.status)}`);
-        if (entry.description) {
-            lines.push(isProblemStatus(entry.status) ? entry.description : tty(entry.description, MIST));
-        }
-        for (const detail of entry.detailLines ?? []) {
-            lines.push(detail);
-        }
+    if (entry.nextNote && !/^(Outward|Inner) lane: /.test(entry.nextNote)) {
+        lines.push(entry.nextNote);
     }
-    return normalizeWrappedBody(lines, width);
-}
-function normalizeWrappedBody(lines, width) {
-    const wrapped = [];
-    for (const line of lines) {
-        if (!line) {
-            wrapped.push("");
-            continue;
-        }
-        const plain = stripAnsi(line);
-        if (plain.length <= width - 4) {
-            wrapped.push(line);
-            continue;
+    if (entry.laneSummaries && entry.laneSummaries.length > 0) {
+        for (const lane of entry.laneSummaries) {
+            const laneLabel = lane.lane === "outward" ? "Outward lane" : "Inner lane";
+            lines.push(`${laneLabel}: ${lane.title} — ${lane.detail}`);
         }
-        const segments = wrapPlain(plain, width - 4);
-        wrapped.push(...segments);
+        return lines;
     }
-    return wrapped;
+    return [...lines, ...(entry.detailLines ?? [])];
 }
-function stackPanels(panels) {
-    const lines = [];
-    for (const [index, panelLines] of panels.entries()) {
-        if (index > 0)
-            lines.push("");
-        lines.push(...panelLines);
-    }
-    return lines;
-}
-function combineColumns(left, right, leftWidth, rightWidth, gap = 2) {
-    const total = Math.max(left.length, right.length);
-    const lines = [];
-    for (let index = 0; index < total; index += 1) {
-        const leftLine = left[index] ?? " ".repeat(leftWidth);
-        const rightLine = right[index] ?? " ".repeat(rightWidth);
-        lines.push(`${padAnsi(leftLine, leftWidth)}${" ".repeat(gap)}${padAnsi(rightLine, rightWidth)}`);
-    }
-    return lines;
-}
-function renderTtyBay(entries, options) {
-    const columns = Math.max(options.columns ?? 108, 72);
-    const fullWidth = Math.max(56, columns - 2);
-    const masthead = (0, terminal_ui_1.renderOuroMasthead)({
-        isTTY: true,
-        columns,
-        subtitle: "Set up connections one step at a time.",
-    }).trimEnd();
-    const header = renderHeader(options.agent, fullWidth);
-    const nextEntry = entries.find((entry) => isProblemStatus(entry.status));
-    const providerEntry = entries.find((entry) => entry.section === "Providers");
-    const portableEntries = entries.filter((entry) => entry.section === "Portable");
-    const machineEntries = entries.filter((entry) => entry.section === "This machine");
-    const wide = columns >= 118;
-    const footer = [
-        tty("Choose a number, or type the capability name.", MIST),
-        options.prompt,
+function capabilityEntryDetailLines(entry) {
+    return [
+        ...(entry.detailLines ?? []),
+        ...(entry.nextNote ? [entry.nextNote] : []),
     ];
-    if (!wide) {
-        const panels = [
-            header,
-            panel("Recommended next step", nextMoveBody(nextEntry), fullWidth),
-            panel("Providers", renderProviderBody(providerEntry, fullWidth), fullWidth),
-            panel("Portable", renderCapabilityBody(portableEntries, fullWidth), fullWidth),
-            panel("This machine", renderCapabilityBody(machineEntries, fullWidth), fullWidth),
-        ];
-        return [masthead, "", ...stackPanels(panels), "", ...footer].join("\n");
-    }
-    const gap = 2;
-    const leftWidth = Math.max(52, Math.floor((fullWidth - gap) / 2));
-    const rightWidth = Math.max(40, fullWidth - gap - leftWidth);
-    const topRow = combineColumns(panel("Recommended next step", nextMoveBody(nextEntry), leftWidth), panel("This machine", renderCapabilityBody(machineEntries, rightWidth), rightWidth), leftWidth, rightWidth, gap);
-    const bottomRow = combineColumns(panel("Providers", renderProviderBody(providerEntry, leftWidth), leftWidth), panel("Portable", renderCapabilityBody(portableEntries, rightWidth), rightWidth), leftWidth, rightWidth, gap);
-    return [masthead, "", ...header, "", ...topRow, "", ...bottomRow, "", ...footer].join("\n");
 }
-function renderNonTtyBay(entries, options) {
+function entryToWizardItem(entry) {
+    return {
+        key: entry.option,
+        label: entry.name,
+        status: entry.status,
+        ...(entry.section === "Providers"
+            ? { summary: providerEntrySummary(entry) }
+            : entry.description
+                ? { summary: entry.description }
+                : {}),
+        detailLines: entry.section === "Providers"
+            ? providerEntryDetailLines(entry)
+            : capabilityEntryDetailLines(entry),
+        ...(entry.nextAction ? { command: entry.nextAction } : {}),
+    };
+}
+function nextStepFor(entries) {
     const nextEntry = entries.find((entry) => isProblemStatus(entry.status));
-    const lines = [
-        `${options.agent} connections`,
-        "Set up or review one capability at a time. Provider status was checked live just now.",
-        "",
-        "Recommended next step",
-        "---------------------",
-    ];
     if (!nextEntry) {
-        lines.push("Everything here is ready. Pick what you want to review or refresh.");
-    }
-    else {
-        lines.push(`${nextEntry.name} - ${nextEntry.status}`);
-        if (nextEntry.nextNote)
-            lines.push(nextEntry.nextNote);
-        if (nextEntry.nextAction)
-            lines.push(`run: ${nextEntry.nextAction}`);
-    }
-    lines.push("");
-    for (const section of ["Providers", "Portable", "This machine"]) {
-        lines.push(section);
-        lines.push("-".repeat(Math.max(6, section.length + 4)));
-        for (const entry of entries.filter((candidate) => candidate.section === section)) {
-            lines.push(`${entry.option}. ${entry.name} [${entry.status}]`);
-            if (entry.laneSummaries && entry.laneSummaries.length > 0) {
-                for (const lane of entry.laneSummaries) {
-                    const laneLabel = lane.lane === "outward" ? "Outward lane" : "Inner lane";
-                    lines.push(`   ${laneLabel}: ${lane.title}`);
-                    lines.push(`     ${lane.detail}`);
-                }
-            }
-            else {
-                for (const detail of entry.detailLines ?? [])
-                    lines.push(`   ${detail}`);
-            }
-            if (entry.description)
-                lines.push(`   ${entry.description}`);
-            lines.push("");
-        }
+        return {
+            label: "Everything here is already connected.",
+            detail: "Pick any capability if you want to review it, refresh it, or change its setup.",
+        };
     }
-    lines.push("6. Not now");
-    lines.push("");
-    lines.push("Choose a number, or type the capability name.");
-    lines.push(options.prompt);
-    return lines.join("\n");
+    return {
+        label: `Start with ${nextEntry.name}.`,
+        detail: nextEntry.nextNote ?? nextEntry.description ?? `Status: ${nextEntry.status}.`,
+        command: nextEntry.nextAction,
+    };
+}
+function sectionToWizard(entries, section, summary) {
+    return {
+        title: section,
+        summary,
+        items: entries.filter((entry) => entry.section === section).map((entry) => entryToWizardItem(entry)),
+    };
 }
 function summarizeProviderLane(agent, lane, providerHealth) {
     const providerHealthStatus = resolveProviderHealthStatus(providerHealth);
@@ -450,7 +256,25 @@ function renderConnectBay(entries, options) {
             columns: options.columns ?? null,
         },
     });
-    if (!options.isTTY)
-        return renderNonTtyBay(entries, options);
-    return renderTtyBay(entries, options);
+    return (0, terminal_ui_1.renderTerminalWizard)({
+        isTTY: options.isTTY,
+        columns: options.columns,
+        masthead: {
+            subtitle: "Set up connections one step at a time.",
+        },
+        title: `Connect ${options.agent}`,
+        summary: "Choose one capability to bring online. Each row tells you whether Ouro checked it live just now or is showing saved setup on this machine.",
+        nextStep: nextStepFor(entries),
+        sections: [
+            sectionToWizard(entries, "Providers", "Selected outward and inner lanes for this machine."),
+            sectionToWizard(entries, "Portable", "These travel with the agent bundle when their secrets are portable."),
+            sectionToWizard(entries, "This machine", "These depend on local attachments or machine-specific setup."),
+        ],
+        footerLines: [
+            "6. Not now",
+            "Choose a number, or type the capability name.",
+        ],
+        prompt: options.prompt,
+        suppressEvent: true,
+    });
 }

package/dist/heart/daemon/human-command-screens.js

@@ -17,6 +17,34 @@ function renderScreenEvent(screen) {
         meta: { screen },
     });
 }
+function homeActionSummary(action) {
+    switch (action.kind) {
+        case "chat":
+            return `Open chat with ${action.agent}.`;
+        case "up":
+            return "Start the local runtime and check what still needs attention.";
+        case "connect":
+            return "Set up providers, portable tools, and machine-specific attachments.";
+        case "repair":
+            return "Walk through repairs for anything blocking startup or chat.";
+        case "help":
+            return "Show the command guide.";
+        case "hatch":
+            return "Create a new agent on this machine.";
+        case "clone":
+            return "Bring an existing bundle onto this machine.";
+        case "exit":
+            return "Leave the prompt.";
+    }
+}
+function actionToWizardItem(action) {
+    return {
+        key: action.key,
+        label: action.label,
+        summary: homeActionSummary(action),
+        ...(action.key === "1" ? { recommended: true } : {}),
+    };
+}
 function buildOuroHomeActions(agents) {
     if (agents.length === 0) {
         return [
@@ -57,21 +85,28 @@ function resolveOuroHomeAction(answer, actions) {
 function renderOuroHomeScreen(options) {
     renderScreenEvent("home");
     const actions = buildOuroHomeActions(options.agents);
-    const sections = [
-        {
-            title: options.agents.length === 0 ? "Start here" : "Available agents",
-            lines: options.agents.length === 0
-                ? ["No agents are set up on this machine yet."]
-                : options.agents.map((agent) => `${agent} is available.`),
-        },
-    ];
-    const actionRows = actions.map((action, index) => ({
-        label: action.label,
-        actor: "agent-runnable",
-        command: action.command,
-        ...(index === 0 ? { recommended: true } : {}),
-    }));
-    return (0, terminal_ui_1.renderTerminalBoard)({
+    const chatActions = actions.filter((action) => action.kind === "chat");
+    const setupActions = actions.filter((action) => action.kind !== "chat");
+    const sections = options.agents.length === 0
+        ? [
+            {
+                title: "Start here",
+                summary: "There are no agents on this machine yet.",
+                items: setupActions.map((action) => actionToWizardItem(action)),
+            },
+        ]
+        : [
+            {
+                title: "Agents",
+                summary: "Jump straight into conversation or pick a setup path below.",
+                items: chatActions.map((action) => actionToWizardItem(action)),
+            },
+            {
+                title: "System",
+                items: setupActions.map((action) => actionToWizardItem(action)),
+            },
+        ];
+    return (0, terminal_ui_1.renderTerminalWizard)({
         isTTY: options.isTTY,
         columns: options.columns,
         masthead: {
@@ -84,13 +119,18 @@ function renderOuroHomeScreen(options) {
             ? "Create a new agent or clone an existing bundle to get started."
             : "Choose an agent or a setup task without memorizing commands.",
         sections,
-        actions: actionRows,
+        nextStep: {
+            label: options.agents.length === 0 ? "Start by creating or cloning an agent." : `Start with ${actions[0].label}.`,
+            detail: options.agents.length === 0
+                ? "Once one agent bundle exists here, the rest of the command surface becomes interactive."
+                : "You can always type the number or the agent name instead of remembering a command.",
+        },
         prompt: `Choose [1-${actions.length}] or type a name: `,
     });
 }
 function renderAgentPickerScreen(options) {
     renderScreenEvent("agent-picker");
-    return (0, terminal_ui_1.renderTerminalBoard)({
+    return (0, terminal_ui_1.renderTerminalWizard)({
         isTTY: options.isTTY,
         columns: options.columns,
         masthead: {
@@ -101,7 +141,12 @@ function renderAgentPickerScreen(options) {
         sections: [
             {
                 title: "Agents",
-                lines: options.agents.map((agent, index) => `${index + 1}. ${agent}`),
+                items: options.agents.map((agent, index) => ({
+                    key: String(index + 1),
+                    label: agent,
+                    summary: "Available on this machine.",
+                    ...(index === 0 ? { recommended: true } : {}),
+                })),
             },
         ],
         prompt: `Choose [1-${options.agents.length}] or type a name: `,
@@ -116,32 +161,65 @@ function resolveNamedAgentSelection(answer, agents) {
         return agents[numbered - 1];
     return agents.find((agent) => agent.toLowerCase() === normalized);
 }
-function statusLabel(status) {
-    return status.replace(/-/g, " ");
-}
 function renderHumanReadinessBoard(options) {
     renderScreenEvent("readiness");
-    const sections = options.snapshot.items.map((item) => ({
-        title: item.title,
-        lines: [
-            `${statusLabel(item.status)} — ${item.summary}`,
-            ...item.detailLines,
-        ],
+    const issueItems = options.snapshot.items.map((item) => ({
+        label: item.title,
+        status: item.status,
+        summary: item.summary,
+        detailLines: item.detailLines,
     }));
-    return renderHumanCommandBoard({
-        title: options.title,
-        subtitle: options.subtitle,
-        summary: options.snapshot.summary,
+    const actionItems = options.snapshot.nextActions.map((action, index) => ({
+        key: String(index + 1),
+        label: action.label,
+        actor: action.actor,
+        command: action.command,
+        ...(action.recommended ? { recommended: true } : {}),
+    }));
+    if (options.prompt) {
+        actionItems.push({
+            key: String(actionItems.length + 1),
+            label: "Skip for now",
+        });
+    }
+    return (0, terminal_ui_1.renderTerminalWizard)({
         isTTY: options.isTTY,
         columns: options.columns,
-        sections,
-        actions: options.snapshot.nextActions,
+        masthead: {
+            subtitle: options.subtitle,
+        },
+        title: options.title,
+        summary: options.snapshot.summary,
+        nextStep: options.snapshot.primaryAction
+            ? {
+                label: options.snapshot.primaryAction.label,
+                detail: options.snapshot.summary,
+                command: options.snapshot.primaryAction.command,
+            }
+            : options.snapshot.status === "ready" || options.snapshot.status === "attached"
+                ? {
+                    label: "Everything needed here is ready.",
+                    detail: "You can keep going or leave this area alone.",
+                }
+                : undefined,
+        sections: [
+            {
+                title: "What needs attention",
+                items: issueItems,
+            },
+            ...(actionItems.length > 0
+                ? [{
+                        title: "Ways forward",
+                        items: actionItems,
+                    }]
+                : []),
+        ],
         prompt: options.prompt,
     });
 }
 function renderHumanCommandBoard(options) {
     renderScreenEvent("command-board");
-    return (0, terminal_ui_1.renderTerminalBoard)({
+    return (0, terminal_ui_1.renderTerminalGuide)({
         isTTY: options.isTTY,
         columns: options.columns,
         masthead: {

package/dist/heart/daemon/interactive-repair.js

@@ -11,6 +11,7 @@ exports.isAffirmativeAnswer = isAffirmativeAnswer;
 exports.runInteractiveRepair = runInteractiveRepair;
 const runtime_1 = require("../../nerves/runtime");
 const identity_1 = require("../identity");
+const terminal_ui_1 = require("./terminal-ui");
 function isCredentialIssue(degraded) {
     const reason = degraded.errorReason.toLowerCase();
     const hint = degraded.fixHint.toLowerCase();
@@ -90,6 +91,9 @@ function fallbackCommandsFor(degraded, primaryCommand) {
 function renderRepairChoices(prefix, commands) {
     return commands.map((command, index) => `  ${index === 0 ? prefix : "or"}: ${command}`);
 }
+function repairStatusFor(action) {
+    return action.kind === "vault-unlock" ? "locked" : "needs credentials";
+}
 function renderRepairQueueSummaryLines(degraded) {
     const repairable = degraded
         .map((entry) => ({ entry, action: runnableRepairActionFor(entry) }))
@@ -109,6 +113,34 @@ function renderRepairQueueSummaryLines(degraded) {
     });
     return lines;
 }
+function renderRepairQueueSummary(degraded, deps) {
+    const repairable = degraded
+        .map((entry) => ({ entry, action: runnableRepairActionFor(entry) }))
+        .filter((item) => item.action !== undefined);
+    if (!deps.isTTY) {
+        return renderRepairQueueSummaryLines(degraded).join("\n");
+    }
+    return (0, terminal_ui_1.renderTerminalWizard)({
+        isTTY: true,
+        columns: deps.stdoutColumns,
+        masthead: {
+            subtitle: "Repair paths ready.",
+        },
+        title: "Needs attention before startup can finish",
+        summary: "Ouro found repair steps it can open right now. It will walk through them one at a time.",
+        sections: [{
+                title: "Repair queue",
+                items: repairable.map(({ entry, action }) => ({
+                    label: entry.agent,
+                    status: repairStatusFor(action),
+                    summary: action.label,
+                    detailLines: [entry.errorReason],
+                    command: action.command,
+                })),
+            }],
+        suppressEvent: true,
+    }).trimEnd();
+}
 function renderActionPromptLines(agent, action) {
     const lines = [
         `${agent}`,
@@ -120,11 +152,66 @@ function renderActionPromptLines(agent, action) {
     }
     return lines;
 }
-function renderDeferredRepair(agent, commands) {
-    return [
-        `Leaving ${agent} for later.`,
-        ...renderRepairChoices("next", commands),
-    ].join("\n");
+function renderActionPrompt(entry, action, deps) {
+    if (!deps.isTTY)
+        return renderActionPromptLines(entry.agent, action).join("\n");
+    const footer = action.kind === "vault-unlock"
+        ? "Only say yes if you have the saved vault unlock secret."
+        : "Say yes if you want Ouro to open the auth flow now.";
+    return (0, terminal_ui_1.renderTerminalWizard)({
+        isTTY: true,
+        columns: deps.stdoutColumns,
+        masthead: {
+            subtitle: "One repair step at a time.",
+        },
+        title: `Repair ${entry.agent}`,
+        summary: "Ouro found one clear next move for this agent.",
+        nextStep: {
+            label: action.kind === "vault-unlock"
+                ? "Unlock the credential vault on this machine."
+                : "Refresh provider authentication.",
+            detail: action.kind === "vault-unlock"
+                ? "Use the saved unlock secret if you have it. If not, leave this for later and choose a replacement or recovery path."
+                : "This opens the provider login or refresh flow for the selected provider.",
+            command: action.command,
+        },
+        sections: [{
+                title: "Why startup paused",
+                items: [{
+                        label: entry.agent,
+                        status: repairStatusFor(action),
+                        summary: entry.errorReason,
+                    }],
+            }],
+        footerLines: [footer],
+        suppressEvent: true,
+    }).trimEnd();
+}
+function renderDeferredRepair(agent, commands, deps) {
+    if (!deps.isTTY) {
+        return [
+            `Leaving ${agent} for later.`,
+            ...renderRepairChoices("next", commands),
+        ].join("\n");
+    }
+    return (0, terminal_ui_1.renderTerminalWizard)({
+        isTTY: true,
+        columns: deps.stdoutColumns,
+        masthead: {
+            subtitle: "Nothing changed yet.",
+        },
+        title: `Leaving ${agent} for later`,
+        summary: "Ouro did not open this repair flow right now.",
+        sections: [{
+                title: "Next time",
+                items: commands.map((command, index) => ({
+                    key: String(index + 1),
+                    label: index === 0 ? "Start here" : "Or try this",
+                    command,
+                })),
+            }],
+        suppressEvent: true,
+    }).trimEnd();
 }
 function renderManualRepairHint(agent, fixHint) {
     return [
@@ -140,7 +227,7 @@ function renderUnknownRepair(agent, errorReason) {
     ].join("\n");
 }
 function writeDeclinedRepair(degraded, command, deps) {
-    deps.writeStdout(renderDeferredRepair(degraded.agent, fallbackCommandsFor(degraded, command)));
+    deps.writeStdout(renderDeferredRepair(degraded.agent, fallbackCommandsFor(degraded, command), deps));
 }
 function runnableRepairActionFor(degraded) {
     const typedAction = degraded.issue?.actions
@@ -180,10 +267,10 @@ function typedActionToRunnable(degraded, action) {
 function writeRepairQueueSummary(degraded, deps) {
     const lines = renderRepairQueueSummaryLines(degraded);
     if (lines.length > 0)
-        deps.writeStdout(lines.join("\n"));
+        deps.writeStdout(renderRepairQueueSummary(degraded, deps));
 }
 async function attemptVaultUnlock(entry, action, deps) {
-    deps.writeStdout(renderActionPromptLines(entry.agent, action).join("\n"));
+    deps.writeStdout(renderActionPrompt(entry, action, deps));
     const answer = await deps.promptInput(`Unlock ${entry.agent}'s vault now? [y/N] `);
     if (!isAffirmativeAnswer(answer)) {
         writeDeclinedRepair(entry, action.command, deps);
@@ -211,7 +298,7 @@ async function attemptVaultUnlock(entry, action, deps) {
     }
 }
 async function attemptProviderAuth(entry, action, deps) {
-    deps.writeStdout(renderActionPromptLines(entry.agent, action).join("\n"));
+    deps.writeStdout(renderActionPrompt(entry, action, deps));
     const answer = await deps.promptInput(`Open the auth flow for ${entry.agent} now? [y/N] `);
     if (!isAffirmativeAnswer(answer)) {
         writeDeclinedRepair(entry, action.command, deps);

package/dist/heart/daemon/terminal-ui.js

@@ -7,7 +7,9 @@ exports.wrapPlain = wrapPlain;
 exports.renderOverwriteFrame = renderOverwriteFrame;
 exports.renderOuroMasthead = renderOuroMasthead;
 exports.formatActionActorLabel = formatActionActorLabel;
+exports.renderTerminalWizard = renderTerminalWizard;
 exports.renderTerminalBoard = renderTerminalBoard;
+exports.renderTerminalGuide = renderTerminalGuide;
 exports.renderTerminalOperation = renderTerminalOperation;
 const runtime_1 = require("../../nerves/runtime");
 const RESET = "\x1b[0m";
@@ -145,6 +147,154 @@ function renderOuroMasthead(options) {
 function formatActionActorLabel(actor) {
     return actor.replace(/-/g, " ");
 }
+function formatWizardStatusLabel(status) {
+    return status;
+}
+function isQuietWizardStatus(status) {
+    return status === "ready" || status === "attached" || status === "not attached";
+}
+function renderWizardStatusBadge(status, isTTY) {
+    const symbol = status === "ready" || status === "attached"
+        ? "●"
+        : status === "not attached"
+            ? "◌"
+            : "◆";
+    const label = `${symbol} ${formatWizardStatusLabel(status)}`;
+    if (!isTTY)
+        return label;
+    if (status === "ready" || status === "attached")
+        return color(label, GLOW, true);
+    if (status === "not attached")
+        return color(label, MIST);
+    return color(label, ALERT, true);
+}
+function renderWizardActorBadge(actor, isTTY) {
+    const label = `[${formatActionActorLabel(actor)}]`;
+    if (!isTTY)
+        return label;
+    if (actor === "human-required")
+        return color(label, ALERT, true);
+    if (actor === "human-choice")
+        return color(label, SCALE, true);
+    return color(label, MIST);
+}
+function renderWizardRecommendedBadge(isTTY) {
+    if (!isTTY)
+        return "[recommended]";
+    return color("[recommended]", GLOW, true);
+}
+function wrapWizardDetailLines(lines, width, isTTY, tone) {
+    const rendered = [];
+    for (const line of lines) {
+        const wrapped = wrapPlain(line, width);
+        for (const segment of wrapped) {
+            rendered.push(isTTY ? color(segment, tone) : segment);
+        }
+    }
+    return rendered;
+}
+function renderWizardItem(item, width, isTTY) {
+    const badges = [
+        ...(item.status ? [renderWizardStatusBadge(item.status, isTTY)] : []),
+        ...(item.actor ? [renderWizardActorBadge(item.actor, isTTY)] : []),
+        ...(item.recommended ? [renderWizardRecommendedBadge(isTTY)] : []),
+    ];
+    const keyPrefix = item.key ? `${item.key}. ` : "";
+    const header = `${keyPrefix}${item.label}${badges.length > 0 ? `  ${badges.join("  ")}` : ""}`;
+    const detailWidth = Math.max(18, width - 6);
+    const detailTone = item.status && !isQuietWizardStatus(item.status) ? BONE : MIST;
+    const lines = [isTTY ? color(header, BONE, true) : header];
+    if (item.summary) {
+        lines.push(...wrapWizardDetailLines([item.summary], detailWidth, isTTY, detailTone));
+    }
+    if (item.detailLines && item.detailLines.length > 0) {
+        lines.push(...wrapWizardDetailLines(item.detailLines, detailWidth, isTTY, detailTone));
+    }
+    if (item.command) {
+        lines.push(...wrapWizardDetailLines([`run: ${item.command}`], detailWidth, isTTY, MIST));
+    }
+    return lines.flatMap((line, index) => index === 0 ? [line] : [`   ${line}`]);
+}
+function renderWizardSectionTTY(section, width) {
+    const lines = [];
+    if (section.summary) {
+        lines.push(...wrapWizardDetailLines([section.summary], Math.max(18, width - 4), true, MIST));
+    }
+    for (const [index, item] of section.items.entries()) {
+        if (index > 0)
+            lines.push("");
+        lines.push(...renderWizardItem(item, width, true));
+    }
+    return renderOperationSectionTTY(section.title, lines, width);
+}
+function renderWizardSectionPlain(section, width) {
+    const lines = [];
+    if (section.summary) {
+        lines.push(...wrapWizardDetailLines([section.summary], Math.max(18, width - 4), false, MIST));
+    }
+    for (const [index, item] of section.items.entries()) {
+        if (index > 0)
+            lines.push("");
+        lines.push(...renderWizardItem(item, width, false));
+    }
+    return renderOperationSectionPlain(section.title, lines);
+}
+function renderTerminalWizard(options) {
+    if (!options.suppressEvent) {
+        (0, runtime_1.emitNervesEvent)({
+            component: "daemon",
+            event: "daemon.terminal_wizard_rendered",
+            message: "rendered shared terminal wizard",
+            meta: {
+                title: options.title,
+                sections: options.sections?.length ?? 0,
+                items: options.sections?.reduce((count, section) => count + section.items.length, 0) ?? 0,
+                hasNextStep: !!options.nextStep,
+                tty: options.isTTY,
+            },
+        });
+    }
+    const width = boardWidth(options.columns);
+    const blocks = [];
+    blocks.push(renderOuroMasthead({
+        isTTY: options.isTTY,
+        columns: width,
+        subtitle: options.masthead?.subtitle,
+    }).trimEnd());
+    const introLines = [
+        options.isTTY ? color(options.title, BONE, true) : options.title,
+        ...(options.summary
+            ? wrapPlain(options.summary, Math.max(20, width - 2)).map((line) => options.isTTY ? color(line, MIST) : line)
+            : []),
+    ];
+    blocks.push(introLines.join("\n"));
+    if (options.nextStep) {
+        const nextStepLines = [
+            options.isTTY ? color(options.nextStep.label, BONE, true) : options.nextStep.label,
+            ...(options.nextStep.detail
+                ? wrapPlain(options.nextStep.detail, Math.max(18, width - 4)).map((line) => options.isTTY ? color(line, MIST) : line)
+                : []),
+            ...(options.nextStep.command
+                ? wrapPlain(`run: ${options.nextStep.command}`, Math.max(18, width - 4)).map((line) => options.isTTY ? color(line, MIST) : line)
+                : []),
+        ];
+        blocks.push((options.isTTY
+            ? renderOperationSectionTTY("Recommended next step", nextStepLines, width)
+            : renderOperationSectionPlain("Recommended next step", nextStepLines)).join("\n"));
+    }
+    for (const section of options.sections ?? []) {
+        blocks.push((options.isTTY
+            ? renderWizardSectionTTY(section, width)
+            : renderWizardSectionPlain(section, width)).join("\n"));
+    }
+    if (options.footerLines && options.footerLines.length > 0) {
+        blocks.push(options.footerLines.map((line) => options.isTTY ? color(line, MIST) : line).join("\n"));
+    }
+    if (options.prompt) {
+        blocks.push(options.isTTY ? color(options.prompt, BONE, true) : options.prompt);
+    }
+    return `${blocks.join("\n\n")}\n`;
+}
 function renderActionLine(action) {
     const chips = [`[${formatActionActorLabel(action.actor)}]`];
     if (action.recommended)
@@ -195,6 +345,56 @@ function renderTerminalBoard(options) {
     }
     return `${blocks.join("\n\n")}\n`;
 }
+function renderTerminalGuide(options) {
+    if (!options.suppressEvent) {
+        (0, runtime_1.emitNervesEvent)({
+            component: "daemon",
+            event: "daemon.terminal_guide_rendered",
+            message: "rendered shared terminal guide",
+            meta: {
+                title: options.title,
+                sections: options.sections?.length ?? 0,
+                actions: options.actions?.length ?? 0,
+                tty: options.isTTY,
+            },
+        });
+    }
+    const width = boardWidth(options.columns);
+    const blocks = [];
+    blocks.push(renderOuroMasthead({
+        isTTY: options.isTTY,
+        columns: width,
+        subtitle: options.masthead?.subtitle,
+    }).trimEnd());
+    const introLines = [
+        options.isTTY ? color(options.title, BONE, true) : options.title,
+        ...(options.summary
+            ? wrapPlain(options.summary, Math.max(20, width - 2)).map((line) => options.isTTY ? color(line, MIST) : line)
+            : []),
+    ];
+    blocks.push(introLines.join("\n"));
+    for (const section of options.sections ?? []) {
+        const lines = section.lines.map((line) => options.isTTY ? color(line, BONE) : line);
+        blocks.push((options.isTTY
+            ? renderOperationSectionTTY(section.title, lines, width)
+            : renderOperationSectionPlain(section.title, lines)).join("\n"));
+    }
+    const actionList = options.actions ?? [];
+    if (actionList.length > 0) {
+        const lines = [];
+        for (const [index, action] of actionList.entries()) {
+            lines.push(options.isTTY ? color(`${index + 1}. ${renderActionLine(action)}`, BONE, true) : `${index + 1}. ${renderActionLine(action)}`);
+            lines.push(options.isTTY ? color(`run: ${action.command}`, MIST) : `run: ${action.command}`);
+        }
+        blocks.push((options.isTTY
+            ? renderOperationSectionTTY("Next moves", lines, width)
+            : renderOperationSectionPlain("Next moves", lines)).join("\n"));
+    }
+    if (options.prompt) {
+        blocks.push(options.isTTY ? color(options.prompt, BONE, true) : options.prompt);
+    }
+    return `${blocks.join("\n\n")}\n`;
+}
 function formatOperationStep(step) {
     const marker = step.status === "done"
         ? "✓"

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@ouro.bot/cli",
-  "version": "0.1.0-alpha.445",
+  "version": "0.1.0-alpha.446",
   "main": "dist/heart/daemon/ouro-entry.js",
   "bin": {
     "cli": "dist/heart/daemon/ouro-bot-entry.js",