@trenchwork/erosolar 1.1.35 → 1.1.37

package/dist/ui/ink/HitlDecisionMenu.js

@@ -0,0 +1,124 @@
+import { jsx as _jsx, jsxs as _jsxs } from "react/jsx-runtime";
+/**
+ * HitlDecisionMenu — Ink-rendered HUMAN DECISION REQUIRED prompt.
+ *
+ * Replaces the manual `\x1b[2J\x1b[H` + chalk-bordered ASCII box +
+ * stdin raw-mode keypress loop in src/core/hitl.ts. Owns its own
+ * Ink mount via showHitlDecision(); the caller awaits the resolve.
+ *
+ * Three states:
+ *   1. menu      — arrow-key list, last item is "Enter your own"
+ *   2. custom    — single-line text input for the operator's freeform answer
+ *   3. cancelled — Ctrl+C handled by parent (signal handler) → unmounts
+ */
+import React, { useState } from 'react';
+import { Box, Text, useInput, useApp } from 'ink';
+function buildMenuItems(req) {
+    return [
+        ...req.options.map((opt) => ({
+            id: opt.id,
+            label: opt.label,
+            description: opt.description ?? '',
+        })),
+        {
+            id: req.customId ?? '__custom__',
+            label: 'Enter your own',
+            description: 'Type a custom plan, instruction, or alternative approach',
+            isCustom: true,
+        },
+    ];
+}
+function HitlDecision({ request, onResolve, }) {
+    const items = React.useMemo(() => buildMenuItems(request), [request]);
+    // Default focus on "Enter your own" — matches the prior CLI behavior
+    // where the operator could just hit Enter to compose a free-form answer.
+    const [selected, setSelected] = useState(items.length - 1);
+    const [phase, setPhase] = useState('menu');
+    const [customInput, setCustomInput] = useState('');
+    const { exit } = useApp();
+    useInput((input, key) => {
+        if (phase === 'menu') {
+            if (key.upArrow || input === 'k') {
+                setSelected((i) => Math.max(0, i - 1));
+                return;
+            }
+            if (key.downArrow || input === 'j') {
+                setSelected((i) => Math.min(items.length - 1, i + 1));
+                return;
+            }
+            if (key.return) {
+                const item = items[selected];
+                if (item.isCustom) {
+                    setPhase('custom');
+                }
+                else {
+                    onResolve({ selectedOptionId: item.id });
+                    exit();
+                }
+                return;
+            }
+            if (key.ctrl && input === 'c') {
+                // Surface as a cancelled-by-default selection — the parent
+                // (hitl.ts) decides what to do with the cancel (it currently
+                // hooks Ctrl+C globally and shuts down).
+                const fallback = items[0]?.id ?? '__cancelled__';
+                onResolve({ selectedOptionId: fallback });
+                exit();
+                return;
+            }
+            return;
+        }
+        // phase === 'custom'
+        if (key.return) {
+            const trimmed = customInput.trim();
+            const customId = items[items.length - 1].id;
+            if (trimmed) {
+                onResolve({ selectedOptionId: customId, userInput: trimmed });
+            }
+            else {
+                const fallback = items[0]?.id ?? customId;
+                onResolve({ selectedOptionId: fallback });
+            }
+            exit();
+            return;
+        }
+        if (key.escape) {
+            setPhase('menu');
+            setCustomInput('');
+            return;
+        }
+        if (key.backspace || key.delete) {
+            setCustomInput((s) => s.slice(0, -1));
+            return;
+        }
+        if (input && !key.ctrl && !key.meta) {
+            setCustomInput((s) => s + input);
+        }
+    });
+    return (_jsxs(Box, { flexDirection: "column", paddingX: 1, paddingY: 0, children: [_jsxs(Box, { borderStyle: "round", borderColor: "cyan", paddingX: 1, flexDirection: "column", children: [_jsx(Text, { bold: true, color: "cyan", children: "\u25A3 HUMAN DECISION REQUIRED" }), _jsx(Box, { marginTop: 1, children: _jsx(Text, { bold: true, children: request.title }) }), request.description && (_jsx(Box, { children: _jsx(Text, { color: "gray", children: request.description }) })), request.context && (_jsxs(Box, { marginTop: 1, flexDirection: "column", children: [_jsx(Text, { color: "blue", children: "\u25BE Context" }), _jsx(Text, { color: "gray", children: request.context })] }))] }), phase === 'menu' && (_jsxs(Box, { flexDirection: "column", marginTop: 1, children: [_jsx(Text, { color: "green", children: "\u2191\u2193 to select \u00B7 Enter to confirm \u00B7 Ctrl+C to cancel" }), _jsx(Box, { flexDirection: "column", marginTop: 1, children: items.map((item, i) => {
+                            const active = i === selected;
+                            return (_jsxs(Box, { flexDirection: "column", marginBottom: 1, children: [_jsx(Box, { children: _jsxs(Text, { color: active ? 'cyan' : undefined, bold: active, children: [active ? '▸ ' : '  ', item.label] }) }), item.description && (_jsx(Box, { paddingLeft: 2, children: _jsx(Text, { color: active ? 'cyan' : 'gray', dimColor: !active, children: item.description }) }))] }, item.id));
+                        }) })] })), phase === 'custom' && (_jsxs(Box, { flexDirection: "column", marginTop: 1, children: [_jsx(Text, { color: "cyan", children: "\u21B3 Enter your custom plan \u00B7 Esc to go back \u00B7 Enter to submit" }), _jsxs(Box, { marginTop: 1, children: [_jsx(Text, { color: "magenta", bold: true, children: "\uD83D\uDC49 " }), _jsx(Text, { children: customInput }), _jsx(Text, { color: "cyan", children: "\u2588" })] })] }))] }));
+}
+/**
+ * Mount the Ink decision menu, await the operator's selection, unmount.
+ * The caller (hitl.ts) handles bookkeeping (event emit, history, etc.).
+ */
+export async function showHitlDecision(request) {
+    const { render } = await import('ink');
+    return new Promise((resolve) => {
+        let result = null;
+        const inst = render(React.createElement(HitlDecision, {
+            request,
+            onResolve: (r) => { result = r; },
+        }));
+        inst.waitUntilExit().finally(() => {
+            try {
+                inst.unmount();
+            }
+            catch (_) { /* already torn down */ }
+            resolve(result ?? { selectedOptionId: request.options[0]?.id ?? '__cancelled__' });
+        });
+    });
+}
+//# sourceMappingURL=HitlDecisionMenu.js.map

package/dist/ui/ink/HitlDecisionMenu.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"HitlDecisionMenu.js","sourceRoot":"","sources":["../../../src/ui/ink/HitlDecisionMenu.tsx"],"names":[],"mappings":"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"}

package/dist/ui/ink/OffsecInstallApp.d.ts

@@ -0,0 +1,31 @@
+import { EventEmitter } from 'node:events';
+export type OffsecRowStatus = 'pending' | 'already-present' | 'no-native-channel' | 'installing' | 'installed' | 'failed' | 'skipped' | 'dry-run';
+export interface OffsecRowState {
+    bin: string;
+    capability: string;
+    description: string;
+    status: OffsecRowStatus;
+    command?: string | null;
+    channel?: string | null;
+    note?: string | null;
+    error?: string | null;
+}
+export interface OffsecSummary {
+    installed: number;
+    alreadyPresent: number;
+    noNativeChannel: number;
+    failed: number;
+    failures: Array<{
+        bin: string;
+        reason: string;
+    }>;
+}
+export declare class OffsecEventBus extends EventEmitter {
+    emitHeader(text: string): void;
+    emitRow(row: OffsecRowState): void;
+    emitSummary(summary: OffsecSummary): void;
+}
+export declare function OffsecInstallApp({ bus }: {
+    bus: OffsecEventBus;
+}): import("react/jsx-runtime").JSX.Element;
+//# sourceMappingURL=OffsecInstallApp.d.ts.map

package/dist/ui/ink/OffsecInstallApp.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"OffsecInstallApp.d.ts","sourceRoot":"","sources":["../../../src/ui/ink/OffsecInstallApp.tsx"],"names":[],"mappings":"AAYA,OAAO,EAAE,YAAY,EAAE,MAAM,aAAa,CAAC;AAE3C,MAAM,MAAM,eAAe,GACvB,SAAS,GACT,iBAAiB,GACjB,mBAAmB,GACnB,YAAY,GACZ,WAAW,GACX,QAAQ,GACR,SAAS,GACT,SAAS,CAAC;AAEd,MAAM,WAAW,cAAc;IAC7B,GAAG,EAAE,MAAM,CAAC;IACZ,UAAU,EAAE,MAAM,CAAC;IACnB,WAAW,EAAE,MAAM,CAAC;IACpB,MAAM,EAAE,eAAe,CAAC;IACxB,OAAO,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IACxB,OAAO,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IACxB,IAAI,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IACrB,KAAK,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;CACvB;AAED,MAAM,WAAW,aAAa;IAC5B,SAAS,EAAE,MAAM,CAAC;IAClB,cAAc,EAAE,MAAM,CAAC;IACvB,eAAe,EAAE,MAAM,CAAC;IACxB,MAAM,EAAE,MAAM,CAAC;IACf,QAAQ,EAAE,KAAK,CAAC;QAAE,GAAG,EAAE,MAAM,CAAC;QAAC,MAAM,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC;CAClD;AAED,qBAAa,cAAe,SAAQ,YAAY;IAC9C,UAAU,CAAC,IAAI,EAAE,MAAM;IACvB,OAAO,CAAC,GAAG,EAAE,cAAc;IAC3B,WAAW,CAAC,OAAO,EAAE,aAAa;CACnC;AAaD,wBAAgB,gBAAgB,CAAC,EAAE,GAAG,EAAE,EAAE;IAAE,GAAG,EAAE,cAAc,CAAA;CAAE,2CAmFhE"}

package/dist/ui/ink/OffsecInstallApp.js

@@ -0,0 +1,62 @@
+import { jsxs as _jsxs, jsx as _jsx } from "react/jsx-runtime";
+/**
+ * OffsecInstallApp — Ink-rendered live view for `erosolar offsec install` /
+ * `erosolar offsec status`.
+ *
+ * Replaces the raw console.log + readline.question dance with one
+ * panel per binary: spinner while installing, ✓ on success, ✗ on
+ * failure, ⊘ when there's no native install path. The runner emits
+ * row events on the bus; the React tree re-renders in place.
+ */
+import { useEffect, useState } from 'react';
+import { Box, Text } from 'ink';
+import Spinner from 'ink-spinner';
+import { EventEmitter } from 'node:events';
+export class OffsecEventBus extends EventEmitter {
+    emitHeader(text) { this.emit('header', text); }
+    emitRow(row) { this.emit('row', row); }
+    emitSummary(summary) { this.emit('summary', summary); }
+}
+const STATUS_GLYPH = {
+    pending: { glyph: '·', color: 'gray' },
+    'already-present': { glyph: '✓', color: 'green' },
+    'no-native-channel': { glyph: '⊘', color: 'gray' },
+    installing: { glyph: '·', color: 'cyan' }, // overridden by Spinner
+    installed: { glyph: '✓', color: 'green' },
+    failed: { glyph: '✗', color: 'red' },
+    skipped: { glyph: '–', color: 'yellow' },
+    'dry-run': { glyph: '◦', color: 'cyan' },
+};
+export function OffsecInstallApp({ bus }) {
+    const [header, setHeader] = useState('');
+    const [rows, setRows] = useState({});
+    const [order, setOrder] = useState([]);
+    const [summary, setSummary] = useState(null);
+    useEffect(() => {
+        const onHeader = (text) => setHeader(text);
+        const onRow = (row) => {
+            setRows((r) => ({ ...r, [row.bin]: row }));
+            setOrder((o) => o.includes(row.bin) ? o : [...o, row.bin]);
+        };
+        const onSummary = (s) => setSummary(s);
+        bus.on('header', onHeader);
+        bus.on('row', onRow);
+        bus.on('summary', onSummary);
+        return () => {
+            bus.off('header', onHeader);
+            bus.off('row', onRow);
+            bus.off('summary', onSummary);
+        };
+    }, [bus]);
+    return (_jsxs(Box, { flexDirection: "column", paddingX: 1, children: [header && (_jsx(Box, { marginBottom: 1, children: _jsxs(Text, { bold: true, color: "cyan", children: ["\u25A3 ", header] }) })), order.map((bin) => {
+                const row = rows[bin];
+                const sg = STATUS_GLYPH[row.status];
+                const isSpinning = row.status === 'installing';
+                return (_jsxs(Box, { flexDirection: "column", marginBottom: isSpinning ? 0 : 0, children: [_jsxs(Box, { children: [_jsx(Box, { width: 3, children: isSpinning
+                                        ? _jsx(Text, { color: "cyan", children: _jsx(Spinner, { type: "dots" }) })
+                                        : _jsx(Text, { color: sg.color, children: sg.glyph }) }), _jsxs(Text, { color: "gray", children: ["[", row.capability, "] "] }), _jsx(Text, { bold: true, children: row.bin }), row.command && row.status !== 'installed' && row.status !== 'failed' && (_jsxs(Text, { color: "gray", children: ["  ", row.channel, ": ", row.command] }))] }), row.note && row.status !== 'installed' && (_jsx(Box, { paddingLeft: 3, children: _jsxs(Text, { color: "gray", children: ["note: ", row.note] }) })), row.error && (_jsx(Box, { paddingLeft: 3, children: _jsx(Text, { color: "red", children: row.error }) }))] }, bin));
+            }), summary && (_jsxs(Box, { marginTop: 1, flexDirection: "column", children: [_jsx(Text, { bold: true, color: "white", children: "\u2550 Summary \u2550" }), _jsxs(Text, { children: ["  installed:           ", summary.installed] }), _jsxs(Text, { children: ["  already present:     ", summary.alreadyPresent] }), _jsxs(Text, { children: ["  skipped (no native): ", summary.noNativeChannel] }), summary.failed > 0
+                        ? _jsxs(Text, { color: "red", children: ["  failed:              ", summary.failed] })
+                        : _jsx(Text, { color: "green", children: "  failed:              0" }), summary.failures.length > 0 && (_jsx(Box, { flexDirection: "column", marginTop: 1, children: summary.failures.map((f, i) => (_jsxs(Text, { color: "red", children: ["  \u00B7 ", f.bin, ": ", f.reason] }, i))) }))] }))] }));
+}
+//# sourceMappingURL=OffsecInstallApp.js.map

package/dist/ui/ink/OffsecInstallApp.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"OffsecInstallApp.js","sourceRoot":"","sources":["../../../src/ui/ink/OffsecInstallApp.tsx"],"names":[],"mappings":"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"}

package/dist/ui/ink/SelfTestApp.d.ts

@@ -0,0 +1,23 @@
+import { EventEmitter } from 'node:events';
+export interface SelfTestRowState {
+    name: string;
+    phase: string;
+    status: 'pending' | 'pass' | 'fail';
+    durationMs?: number;
+    error?: string;
+}
+export interface SelfTestSummary {
+    total: number;
+    passed: number;
+    failed: number;
+    durationMs: number;
+}
+export declare class SelfTestEventBus extends EventEmitter {
+    emitPhase(phase: string): void;
+    emitRow(row: SelfTestRowState): void;
+    emitSummary(summary: SelfTestSummary): void;
+}
+export declare function SelfTestApp({ bus }: {
+    bus: SelfTestEventBus;
+}): import("react/jsx-runtime").JSX.Element;
+//# sourceMappingURL=SelfTestApp.d.ts.map

package/dist/ui/ink/SelfTestApp.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"SelfTestApp.d.ts","sourceRoot":"","sources":["../../../src/ui/ink/SelfTestApp.tsx"],"names":[],"mappings":"AAUA,OAAO,EAAE,YAAY,EAAE,MAAM,aAAa,CAAC;AAE3C,MAAM,WAAW,gBAAgB;IAC/B,IAAI,EAAE,MAAM,CAAC;IACb,KAAK,EAAE,MAAM,CAAC;IACd,MAAM,EAAE,SAAS,GAAG,MAAM,GAAG,MAAM,CAAC;IACpC,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB;AAED,MAAM,WAAW,eAAe;IAC9B,KAAK,EAAE,MAAM,CAAC;IACd,MAAM,EAAE,MAAM,CAAC;IACf,MAAM,EAAE,MAAM,CAAC;IACf,UAAU,EAAE,MAAM,CAAC;CACpB;AAED,qBAAa,gBAAiB,SAAQ,YAAY;IAChD,SAAS,CAAC,KAAK,EAAE,MAAM;IACvB,OAAO,CAAC,GAAG,EAAE,gBAAgB;IAC7B,WAAW,CAAC,OAAO,EAAE,eAAe;CACrC;AAED,wBAAgB,WAAW,CAAC,EAAE,GAAG,EAAE,EAAE;IAAE,GAAG,EAAE,gBAAgB,CAAA;CAAE,2CA0E7D"}

package/dist/ui/ink/SelfTestApp.js

@@ -0,0 +1,47 @@
+import { jsx as _jsx, jsxs as _jsxs } from "react/jsx-runtime";
+/**
+ * SelfTestApp — Ink-rendered live view for `erosolar --self-test`.
+ *
+ * Replaces the hand-rolled \x1b[…m escape codes in src/bin/selfTest.ts.
+ * Subscribes to a TestEventBus the runner mutates as each test
+ * starts/finishes, so the row flips spinner → ✓/✗ live.
+ */
+import { useEffect, useState } from 'react';
+import { Box, Text } from 'ink';
+import Spinner from 'ink-spinner';
+import { EventEmitter } from 'node:events';
+export class SelfTestEventBus extends EventEmitter {
+    emitPhase(phase) { this.emit('phase', phase); }
+    emitRow(row) { this.emit('row', row); }
+    emitSummary(summary) { this.emit('summary', summary); }
+}
+export function SelfTestApp({ bus }) {
+    const [phases, setPhases] = useState([]);
+    const [rows, setRows] = useState({});
+    const [order, setOrder] = useState([]);
+    const [summary, setSummary] = useState(null);
+    useEffect(() => {
+        const onPhase = (phase) => setPhases((p) => [...p, phase]);
+        const onRow = (row) => {
+            setRows((r) => ({ ...r, [row.name]: row }));
+            setOrder((o) => o.includes(row.name) ? o : [...o, row.name]);
+        };
+        const onSummary = (s) => setSummary(s);
+        bus.on('phase', onPhase);
+        bus.on('row', onRow);
+        bus.on('summary', onSummary);
+        return () => {
+            bus.off('phase', onPhase);
+            bus.off('row', onRow);
+            bus.off('summary', onSummary);
+        };
+    }, [bus]);
+    return (_jsxs(Box, { flexDirection: "column", paddingX: 1, children: [_jsx(Box, { marginBottom: 1, children: _jsx(Text, { bold: true, color: "cyan", children: "\u25A3 Erosolar CLI \u2014 self-test suite" }) }), phases.map((phase, i) => (_jsx(Box, { marginTop: 1, children: _jsxs(Text, { color: "cyan", bold: true, children: ["\u25B6 ", phase] }) }, `phase-${i}`))), order.map((name) => {
+                const row = rows[name];
+                const dur = typeof row.durationMs === 'number' ? `(${row.durationMs}ms)` : '';
+                return (_jsxs(Box, { flexDirection: "column", children: [_jsxs(Box, { children: [_jsxs(Box, { width: 3, children: [row.status === 'pending' && _jsx(Text, { color: "cyan", children: _jsx(Spinner, { type: "dots" }) }), row.status === 'pass' && _jsx(Text, { color: "green", children: "\u2713" }), row.status === 'fail' && _jsx(Text, { color: "red", children: "\u2717" })] }), _jsxs(Text, { children: [row.name, " "] }), _jsx(Text, { color: "gray", children: dur })] }), row.status === 'fail' && row.error && (_jsx(Box, { paddingLeft: 3, children: _jsx(Text, { color: "red", children: row.error }) }))] }, name));
+            }), summary && (_jsxs(Box, { marginTop: 1, flexDirection: "column", children: [_jsx(Text, { bold: true, color: "white", children: "\u2550 Summary \u2550" }), _jsxs(Text, { children: ["  Total:    ", summary.total] }), _jsxs(Text, { color: "green", children: ["  Passed:   ", summary.passed] }), summary.failed > 0 && _jsxs(Text, { color: "red", children: ["  Failed:   ", summary.failed] }), _jsxs(Text, { children: ["  Duration: ", (summary.durationMs / 1000).toFixed(2), "s"] }), _jsx(Box, { marginTop: 1, children: summary.failed === 0
+                            ? _jsx(Text, { bold: true, color: "green", children: "\u2713 ALL TESTS PASSED" })
+                            : _jsx(Text, { bold: true, color: "red", children: "\u2717 SOME TESTS FAILED" }) })] }))] }));
+}
+//# sourceMappingURL=SelfTestApp.js.map

package/dist/ui/ink/SelfTestApp.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"SelfTestApp.js","sourceRoot":"","sources":["../../../src/ui/ink/SelfTestApp.tsx"],"names":[],"mappings":"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"}

package/dist/ui/ink/oneShot.d.ts

@@ -0,0 +1,33 @@
+export type CardTone = 'info' | 'success' | 'warn' | 'error';
+/**
+ * Renders a single Ink card and unmounts after the next paint. Resolves
+ * once the panel has been flushed to the terminal so callers can safely
+ * `process.exit()` immediately after awaiting.
+ */
+export declare function showCard(opts: {
+    tone?: CardTone;
+    title: string;
+    body?: string | string[];
+    hint?: string | null;
+}): Promise<void>;
+/**
+ * Renders a key/value table panel — used for --version banners,
+ * approval-denied summaries, install summaries, etc.
+ */
+export declare function showKv(opts: {
+    tone?: CardTone;
+    title: string;
+    rows: Array<[string, string]>;
+    hint?: string | null;
+}): Promise<void>;
+/**
+ * Renders preformatted help text inside an Ink frame. The text body
+ * keeps its own formatting (newlines, indentation); Ink owns the
+ * decorative chrome around it.
+ */
+export declare function showHelp(opts: {
+    title: string;
+    body: string;
+    foot?: string | null;
+}): Promise<void>;
+//# sourceMappingURL=oneShot.d.ts.map

package/dist/ui/ink/oneShot.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"oneShot.d.ts","sourceRoot":"","sources":["../../../src/ui/ink/oneShot.tsx"],"names":[],"mappings":"AAYA,MAAM,MAAM,QAAQ,GAAG,MAAM,GAAG,SAAS,GAAG,MAAM,GAAG,OAAO,CAAC;AAS7D;;;;GAIG;AACH,wBAAsB,QAAQ,CAAC,IAAI,EAAE;IACnC,IAAI,CAAC,EAAE,QAAQ,CAAC;IAChB,KAAK,EAAE,MAAM,CAAC;IACd,IAAI,CAAC,EAAE,MAAM,GAAG,MAAM,EAAE,CAAC;IACzB,IAAI,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;CACtB,GAAG,OAAO,CAAC,IAAI,CAAC,CAgChB;AAED;;;GAGG;AACH,wBAAsB,MAAM,CAAC,IAAI,EAAE;IACjC,IAAI,CAAC,EAAE,QAAQ,CAAC;IAChB,KAAK,EAAE,MAAM,CAAC;IACd,IAAI,EAAE,KAAK,CAAC,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC,CAAC;IAC9B,IAAI,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;CACtB,GAAG,OAAO,CAAC,IAAI,CAAC,CA8BhB;AAED;;;;GAIG;AACH,wBAAsB,QAAQ,CAAC,IAAI,EAAE;IAAE,KAAK,EAAE,MAAM,CAAC;IAAC,IAAI,EAAE,MAAM,CAAC;IAAC,IAAI,CAAC,EAAE,MAAM,GAAG,IAAI,CAAA;CAAE,GAAG,OAAO,CAAC,IAAI,CAAC,CAoBzG"}

package/dist/ui/ink/oneShot.js

@@ -0,0 +1,70 @@
+import { jsxs as _jsxs, jsx as _jsx } from "react/jsx-runtime";
+/**
+ * oneShot — minimal helpers for "render a small Ink panel and exit"
+ * surfaces (--help, --version, --key save, error cards, etc.).
+ *
+ * The interactive shell owns its own Ink tree via InkPromptController;
+ * these one-shot mounts are for surfaces that print and exit before
+ * the shell ever starts. Each helper resolves once Ink has flushed at
+ * least one frame so the panel paints before the process exits.
+ */
+import React from 'react';
+import { Box, Text } from 'ink';
+const TONE = {
+    info: { glyph: '▣', color: 'cyan' },
+    success: { glyph: '✓', color: 'green' },
+    warn: { glyph: '!', color: 'yellow' },
+    error: { glyph: '✗', color: 'red' },
+};
+/**
+ * Renders a single Ink card and unmounts after the next paint. Resolves
+ * once the panel has been flushed to the terminal so callers can safely
+ * `process.exit()` immediately after awaiting.
+ */
+export async function showCard(opts) {
+    const { render } = await import('ink');
+    const tone = opts.tone ?? 'info';
+    const palette = TONE[tone];
+    const lines = Array.isArray(opts.body) ? opts.body : (opts.body ? [opts.body] : []);
+    const Card = () => (_jsxs(Box, { flexDirection: "column", paddingX: 1, paddingY: 0, children: [_jsxs(Box, { children: [_jsxs(Text, { color: palette.color, children: [palette.glyph, " "] }), _jsx(Text, { color: palette.color, bold: true, children: opts.title })] }), lines.length > 0 && (_jsx(Box, { flexDirection: "column", marginTop: lines.length > 1 ? 1 : 0, children: lines.map((line, i) => (_jsx(Text, { color: tone === 'error' ? 'red' : 'gray', children: line }, i))) })), opts.hint && (_jsx(Box, { marginTop: 1, children: _jsx(Text, { color: "gray", dimColor: true, children: opts.hint }) }))] }));
+    const inst = render(React.createElement(Card));
+    // Two ticks: first paints the card, second lets Ink commit the static
+    // output before unmount tears the alternate-screen buffer.
+    await new Promise((r) => setTimeout(r, 30));
+    try {
+        inst.unmount();
+    }
+    catch (_) { /* already torn down */ }
+}
+/**
+ * Renders a key/value table panel — used for --version banners,
+ * approval-denied summaries, install summaries, etc.
+ */
+export async function showKv(opts) {
+    const { render } = await import('ink');
+    const tone = opts.tone ?? 'info';
+    const palette = TONE[tone];
+    const Panel = () => (_jsxs(Box, { flexDirection: "column", paddingX: 1, children: [_jsxs(Box, { children: [_jsxs(Text, { color: palette.color, children: [palette.glyph, " "] }), _jsx(Text, { color: palette.color, bold: true, children: opts.title })] }), _jsx(Box, { flexDirection: "column", marginTop: 1, children: opts.rows.map(([k, v], i) => (_jsxs(Box, { children: [_jsx(Box, { width: 14, children: _jsx(Text, { color: "gray", children: k }) }), _jsx(Text, { color: tone === 'error' ? 'red' : 'white', children: v })] }, i))) }), opts.hint && (_jsx(Box, { marginTop: 1, children: _jsx(Text, { color: "gray", dimColor: true, children: opts.hint }) }))] }));
+    const inst = render(React.createElement(Panel));
+    await new Promise((r) => setTimeout(r, 30));
+    try {
+        inst.unmount();
+    }
+    catch (_) { /* already torn down */ }
+}
+/**
+ * Renders preformatted help text inside an Ink frame. The text body
+ * keeps its own formatting (newlines, indentation); Ink owns the
+ * decorative chrome around it.
+ */
+export async function showHelp(opts) {
+    const { render } = await import('ink');
+    const View = () => (_jsxs(Box, { flexDirection: "column", paddingX: 1, paddingY: 0, children: [_jsx(Box, { marginBottom: 1, children: _jsx(Text, { color: "cyan", bold: true, children: opts.title }) }), _jsx(Box, { children: _jsx(Text, { children: opts.body }) }), opts.foot && (_jsx(Box, { marginTop: 1, children: _jsx(Text, { color: "gray", dimColor: true, children: opts.foot }) }))] }));
+    const inst = render(React.createElement(View));
+    await new Promise((r) => setTimeout(r, 30));
+    try {
+        inst.unmount();
+    }
+    catch (_) { /* already torn down */ }
+}
+//# sourceMappingURL=oneShot.js.map

package/dist/ui/ink/oneShot.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"oneShot.js","sourceRoot":"","sources":["../../../src/ui/ink/oneShot.tsx"],"names":[],"mappings":"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"}

package/dist/utils/statusReporter.d.ts

@@ -1,6 +1,19 @@
 type StatusSink = (message: string) => void;
 export declare function setStatusSink(sink: StatusSink | null): void;
 export declare function reportStatus(message: string): void;
+/**
+ * Render a fatal error as an Ink card and exit. Used by every catch
+ * block in src/bin/erosolar.ts so the user sees a consistent red panel
+ * instead of a one-line console.error. Falls back to stderr if Ink
+ * fails to mount (degraded TTY, ENOTTY, etc.) so the user always sees
+ * the message somewhere.
+ */
+export declare function reportFatal(error: unknown, prefix?: string): Promise<void>;
+/**
+ * Legacy non-Ink error reporter. Prefer reportFatal() for new call
+ * sites; this stays for low-level paths that can't await an import
+ * (e.g. signal handlers).
+ */
 export declare function reportStatusError(error: unknown, prefix?: string): void;
 export {};
 //# sourceMappingURL=statusReporter.d.ts.map

package/dist/utils/statusReporter.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"statusReporter.d.ts","sourceRoot":"","sources":["../../src/utils/statusReporter.ts"],"names":[],"mappings":"AAEA,KAAK,UAAU,GAAG,CAAC,OAAO,EAAE,MAAM,KAAK,IAAI,CAAC;AAO5C,wBAAgB,aAAa,CAAC,IAAI,EAAE,UAAU,GAAG,IAAI,GAAG,IAAI,CAE3D;AAED,wBAAgB,YAAY,CAAC,OAAO,EAAE,MAAM,GAAG,IAAI,CAUlD;AAED,wBAAgB,iBAAiB,CAAC,KAAK,EAAE,OAAO,EAAE,MAAM,GAAE,MAAgB,GAAG,IAAI,CAOhF"}
+{"version":3,"file":"statusReporter.d.ts","sourceRoot":"","sources":["../../src/utils/statusReporter.ts"],"names":[],"mappings":"AAEA,KAAK,UAAU,GAAG,CAAC,OAAO,EAAE,MAAM,KAAK,IAAI,CAAC;AAO5C,wBAAgB,aAAa,CAAC,IAAI,EAAE,UAAU,GAAG,IAAI,GAAG,IAAI,CAE3D;AAED,wBAAgB,YAAY,CAAC,OAAO,EAAE,MAAM,GAAG,IAAI,CAYlD;AAED;;;;;;GAMG;AACH,wBAAsB,WAAW,CAAC,KAAK,EAAE,OAAO,EAAE,MAAM,GAAE,MAAgB,GAAG,OAAO,CAAC,IAAI,CAAC,CAUzF;AAED;;;;GAIG;AACH,wBAAgB,iBAAiB,CAAC,KAAK,EAAE,OAAO,EAAE,MAAM,GAAE,MAAgB,GAAG,IAAI,CAOhF"}

package/dist/utils/statusReporter.js

@@ -13,8 +13,34 @@ export function reportStatus(message) {
         statusSink(normalized);
         return;
     }
+    // Plain stdout fallback — used early in boot (before Ink is ready)
+    // and as the fallback for non-fatal status pings.
     stdout.write(`${normalized}\n`);
 }
+/**
+ * Render a fatal error as an Ink card and exit. Used by every catch
+ * block in src/bin/erosolar.ts so the user sees a consistent red panel
+ * instead of a one-line console.error. Falls back to stderr if Ink
+ * fails to mount (degraded TTY, ENOTTY, etc.) so the user always sees
+ * the message somewhere.
+ */
+export async function reportFatal(error, prefix = 'Error') {
+    const message = error instanceof Error ? error.message : String(error);
+    const safePrefix = prefix.trim() || 'Error';
+    try {
+        const { showCard } = await import('../ui/ink/oneShot.js');
+        await showCard({ tone: 'error', title: safePrefix, body: message });
+    }
+    catch {
+        // Ink failed (no TTY, etc.). Still surface the message.
+        process.stderr.write(`${safePrefix}: ${message}\n`);
+    }
+}
+/**
+ * Legacy non-Ink error reporter. Prefer reportFatal() for new call
+ * sites; this stays for low-level paths that can't await an import
+ * (e.g. signal handlers).
+ */
 export function reportStatusError(error, prefix = 'Error') {
     const message = error instanceof Error ? error.message : String(error);
     const safePrefix = prefix.trim();

package/dist/utils/statusReporter.js.map

@@ -1 +1 @@
-{"version":3,"file":"statusReporter.js","sourceRoot":"","sources":["../../src/utils/statusReporter.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,EAAE,MAAM,cAAc,CAAC;AAItC,IAAI,UAAU,GAAsB,IAAI,CAAC;AAEzC,MAAM,sBAAsB,GAAG,CAAC,OAAe,EAAU,EAAE,CACzD,OAAO,CAAC,OAAO,CAAC,MAAM,EAAE,GAAG,CAAC,CAAC,IAAI,EAAE,CAAC;AAEtC,MAAM,UAAU,aAAa,CAAC,IAAuB;IACnD,UAAU,GAAG,IAAI,CAAC;AACpB,CAAC;AAED,MAAM,UAAU,YAAY,CAAC,OAAe;IAC1C,MAAM,UAAU,GAAG,sBAAsB,CAAC,OAAO,CAAC,CAAC;IACnD,IAAI,CAAC,UAAU,EAAE,CAAC;QAChB,OAAO;IACT,CAAC;IACD,IAAI,UAAU,EAAE,CAAC;QACf,UAAU,CAAC,UAAU,CAAC,CAAC;QACvB,OAAO;IACT,CAAC;IACD,MAAM,CAAC,KAAK,CAAC,GAAG,UAAU,IAAI,CAAC,CAAC;AAClC,CAAC;AAED,MAAM,UAAU,iBAAiB,CAAC,KAAc,EAAE,SAAiB,OAAO;IACxE,MAAM,OAAO,GAAG,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC;IACvE,MAAM,UAAU,GAAG,MAAM,CAAC,IAAI,EAAE,CAAC;IACjC,MAAM,IAAI,GAAG,UAAU;QACrB,CAAC,CAAC,GAAG,UAAU,GAAG,UAAU,CAAC,QAAQ,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,GAAG,IAAI,OAAO,EAAE;QAClE,CAAC,CAAC,OAAO,CAAC;IACZ,YAAY,CAAC,IAAI,CAAC,CAAC;AACrB,CAAC"}
+{"version":3,"file":"statusReporter.js","sourceRoot":"","sources":["../../src/utils/statusReporter.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,EAAE,MAAM,cAAc,CAAC;AAItC,IAAI,UAAU,GAAsB,IAAI,CAAC;AAEzC,MAAM,sBAAsB,GAAG,CAAC,OAAe,EAAU,EAAE,CACzD,OAAO,CAAC,OAAO,CAAC,MAAM,EAAE,GAAG,CAAC,CAAC,IAAI,EAAE,CAAC;AAEtC,MAAM,UAAU,aAAa,CAAC,IAAuB;IACnD,UAAU,GAAG,IAAI,CAAC;AACpB,CAAC;AAED,MAAM,UAAU,YAAY,CAAC,OAAe;IAC1C,MAAM,UAAU,GAAG,sBAAsB,CAAC,OAAO,CAAC,CAAC;IACnD,IAAI,CAAC,UAAU,EAAE,CAAC;QAChB,OAAO;IACT,CAAC;IACD,IAAI,UAAU,EAAE,CAAC;QACf,UAAU,CAAC,UAAU,CAAC,CAAC;QACvB,OAAO;IACT,CAAC;IACD,mEAAmE;IACnE,kDAAkD;IAClD,MAAM,CAAC,KAAK,CAAC,GAAG,UAAU,IAAI,CAAC,CAAC;AAClC,CAAC;AAED;;;;;;GAMG;AACH,MAAM,CAAC,KAAK,UAAU,WAAW,CAAC,KAAc,EAAE,SAAiB,OAAO;IACxE,MAAM,OAAO,GAAG,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC;IACvE,MAAM,UAAU,GAAG,MAAM,CAAC,IAAI,EAAE,IAAI,OAAO,CAAC;IAC5C,IAAI,CAAC;QACH,MAAM,EAAE,QAAQ,EAAE,GAAG,MAAM,MAAM,CAAC,sBAAsB,CAAC,CAAC;QAC1D,MAAM,QAAQ,CAAC,EAAE,IAAI,EAAE,OAAO,EAAE,KAAK,EAAE,UAAU,EAAE,IAAI,EAAE,OAAO,EAAE,CAAC,CAAC;IACtE,CAAC;IAAC,MAAM,CAAC;QACP,wDAAwD;QACxD,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,GAAG,UAAU,KAAK,OAAO,IAAI,CAAC,CAAC;IACtD,CAAC;AACH,CAAC;AAED;;;;GAIG;AACH,MAAM,UAAU,iBAAiB,CAAC,KAAc,EAAE,SAAiB,OAAO;IACxE,MAAM,OAAO,GAAG,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC;IACvE,MAAM,UAAU,GAAG,MAAM,CAAC,IAAI,EAAE,CAAC;IACjC,MAAM,IAAI,GAAG,UAAU;QACrB,CAAC,CAAC,GAAG,UAAU,GAAG,UAAU,CAAC,QAAQ,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,GAAG,IAAI,OAAO,EAAE;QAClE,CAAC,CAAC,OAAO,CAAC;IACZ,YAAY,CAAC,IAAI,CAAC,CAAC;AACrB,CAAC"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@trenchwork/erosolar",
-  "version": "1.1.35",
+  "version": "1.1.37",
   "description": "DeepSeek AI-powered CLI agent for code assistance and automation",
   "deepseek": {
     "rulebookSchema": "src/contracts/schemas/agent-rules.schema.json"