@opensip-cli/cli-ui 0.1.0

package/dist/render-to-ink.js

@@ -0,0 +1,104 @@
+import { jsx as _jsx, jsxs as _jsxs } from "react/jsx-runtime";
+/**
+ * renderToInk — the interactive (TTY) interpreter.
+ *
+ * Walks the same `ViewNode` tree as `renderToText` and returns an Ink
+ * element, mapping each semantic `Tone` onto a `DEFAULT_THEME` token via
+ * `useTheme()` so the theme stays the single source of color truth. The
+ * visible text it produces is identical to `renderToText`'s output (the
+ * cross-renderer equivalence tests assert `stripAnsi(ink) === text`); the
+ * only thing Ink adds is color, weight, and dimming.
+ */
+import { Box, Text } from 'ink';
+import { useTheme } from './theme.js';
+import { padTableCell, tableColumnWidths } from './view-model.js';
+const SEPARATOR_WIDTH = 60;
+const REGEX_META = /[.*+?^${}()|[\]\\]/g;
+/** Map a semantic tone to a theme color token. `default` → no override. */
+function toneColor(theme, tone) {
+    switch (tone) {
+        case 'brand': {
+            return theme.brand;
+        }
+        case 'success': {
+            return theme.success;
+        }
+        case 'error': {
+            return theme.error;
+        }
+        case 'warning': {
+            return theme.warning;
+        }
+        case 'info': {
+            return theme.info;
+        }
+        case 'muted': {
+            return theme.muted;
+        }
+        case 'default':
+        case undefined: {
+            return undefined;
+        }
+    }
+}
+function SpanText({ span }) {
+    const theme = useTheme();
+    return (_jsx(Text, { color: toneColor(theme, span.tone), bold: span.bold, dimColor: span.dim, children: span.text }));
+}
+/** Render one hint, bolding any configured substrings (longest-first). */
+function HintText({ item }) {
+    const bolds = item.bold ?? [];
+    if (bolds.length === 0)
+        return _jsx(Text, { children: item.text });
+    const escaped = [...bolds]
+        .sort((a, b) => b.length - a.length)
+        .map((s) => s.replaceAll(REGEX_META, String.raw `\$&`));
+    const parts = item.text.split(new RegExp(`(${escaped.join('|')})`));
+    const boldSet = new Set(bolds);
+    return (_jsx(Text, { children: parts.map((p, i) => boldSet.has(p) ? (_jsx(Text, { bold: true, children: p }, i)) : (_jsx(Text, { children: p }, i))) }));
+}
+function NodeView({ node }) {
+    switch (node.kind) {
+        case 'line': {
+            return (_jsx(Text, { dimColor: node.dim, children: node.spans.map((s, i) => (_jsx(SpanText, { span: s }, i))) }));
+        }
+        case 'heading': {
+            return _jsx(HeadingView, { text: node.text, tone: node.tone });
+        }
+        case 'keyValues': {
+            return (_jsx(Box, { flexDirection: "column", children: node.pairs.map((p, i) => (_jsxs(Text, { children: [p.label, ": ", p.value] }, i))) }));
+        }
+        case 'table': {
+            const widths = tableColumnWidths(node.columns, node.rows);
+            const alignOf = (i) => node.align?.[i] ?? 'left';
+            const showHeader = node.showHeader !== false;
+            return (_jsxs(Box, { flexDirection: "column", children: [showHeader && (_jsx(Text, { dimColor: true, children: widths
+                            .map((w, i) => (i > 0 ? '  ' : '') + padTableCell(node.columns[i] ?? '', w, alignOf(i)))
+                            .join('') })), node.rows.map((cells, r) => (_jsx(Text, { children: widths.map((w, ci) => (_jsxs(Text, { children: [ci > 0 ? '  ' : '', _jsx(SpanText, { span: {
+                                        ...(cells[ci] ?? { text: '' }),
+                                        text: padTableCell(cells[ci]?.text ?? '', w, alignOf(ci)),
+                                    } })] }, ci))) }, r)))] }));
+        }
+        case 'hints': {
+            return (_jsx(Box, { paddingLeft: 2, children: _jsx(Text, { dimColor: true, children: node.items.map((h, i) => (_jsxs(Text, { children: [i > 0 ? ' | ' : '', _jsx(HintText, { item: h })] }, i))) }) }));
+        }
+        case 'separator': {
+            return _jsx(Text, { dimColor: true, children: '─'.repeat(SEPARATOR_WIDTH) });
+        }
+        case 'spacer': {
+            return _jsx(Text, { children: " " });
+        }
+        case 'group': {
+            return (_jsx(Box, { flexDirection: "column", paddingLeft: node.indent ?? 0, children: node.children.map((c, i) => (_jsx(NodeView, { node: c }, i))) }));
+        }
+    }
+}
+function HeadingView({ text, tone, }) {
+    const theme = useTheme();
+    return (_jsxs(Text, { bold: true, color: toneColor(theme, tone), children: ["== ", text, " =="] }));
+}
+/** Render a view-model node to an Ink element. */
+export function renderToInk(node) {
+    return _jsx(NodeView, { node: node });
+}
+//# sourceMappingURL=render-to-ink.js.map

package/dist/render-to-ink.js.map

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

package/dist/render-to-text.d.ts

@@ -0,0 +1,24 @@
+/**
+ * renderToText — the non-interactive interpreter.
+ *
+ * Walks a `ViewNode` and returns a plain string for pipes, CI logs, and
+ * `> file` redirection. It drops `Tone`, `bold`, and `dim` entirely: the
+ * output carries no styling channel at all, which is stronger than
+ * `NO_COLOR` (that only zeroes theme colors). The guarantee this module
+ * upholds — and that its tests assert for every node kind — is that the
+ * output never contains an ANSI escape sequence.
+ *
+ * Pure string work; no `ink`/`react` import, so the piped path stays
+ * React-free (mirrors the cold-start discipline in the CLI render seam).
+ *
+ * Returns no trailing newline — the caller (the render seam) owns the
+ * final line break, matching how the Ink path appends one.
+ */
+import type { ViewNode } from './view-model.js';
+/**
+ * Render a view-model node to a plain string (no ANSI, no styling). The
+ * non-interactive counterpart to {@link renderToInk}; both consume the
+ * same `ViewNode`, so the piped and TTY forms cannot drift.
+ */
+export declare function renderToText(node: ViewNode): string;
+//# sourceMappingURL=render-to-text.d.ts.map

package/dist/render-to-text.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"render-to-text.d.ts","sourceRoot":"","sources":["../src/render-to-text.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;GAeG;AAIH,OAAO,KAAK,EAAkB,QAAQ,EAAE,MAAM,iBAAiB,CAAC;AA8ChE;;;;GAIG;AACH,wBAAgB,YAAY,CAAC,IAAI,EAAE,QAAQ,GAAG,MAAM,CA2BnD"}

package/dist/render-to-text.js

@@ -0,0 +1,86 @@
+/**
+ * renderToText — the non-interactive interpreter.
+ *
+ * Walks a `ViewNode` and returns a plain string for pipes, CI logs, and
+ * `> file` redirection. It drops `Tone`, `bold`, and `dim` entirely: the
+ * output carries no styling channel at all, which is stronger than
+ * `NO_COLOR` (that only zeroes theme colors). The guarantee this module
+ * upholds — and that its tests assert for every node kind — is that the
+ * output never contains an ANSI escape sequence.
+ *
+ * Pure string work; no `ink`/`react` import, so the piped path stays
+ * React-free (mirrors the cold-start discipline in the CLI render seam).
+ *
+ * Returns no trailing newline — the caller (the render seam) owns the
+ * final line break, matching how the Ink path appends one.
+ */
+import { padTableCell, tableColumnWidths } from './view-model.js';
+const SEPARATOR_WIDTH = 60;
+function spansToText(spans) {
+    return spans.map((s) => s.text).join('');
+}
+function hintsToText(items) {
+    // Two-space indent + " | "-joined, matching the RunFooterHints strip.
+    // Bold substrings are a styling concern and carry no plain-text marker.
+    return `  ${items.map((h) => h.text).join(' | ')}`;
+}
+/**
+ * Column-aligned table rendering: every cell is padded to its column width
+ * (shared `tableColumnWidths`, so the pipe form lines up exactly as the TTY
+ * form). Trailing whitespace is trimmed to keep the ANSI-free output clean.
+ */
+function tableToText(columns, rows, align, showHeader) {
+    const widths = tableColumnWidths(columns, rows);
+    const alignOf = (i) => align?.[i] ?? 'left';
+    const renderRow = (cells) => widths
+        .map((w, i) => padTableCell(cells[i]?.text ?? '', w, alignOf(i)))
+        .join('  ')
+        .trimEnd();
+    const lines = showHeader ? [renderRow(columns.map((c) => ({ text: c })))] : [];
+    for (const cells of rows)
+        lines.push(renderRow(cells));
+    return lines.join('\n');
+}
+function indentLines(block, by) {
+    if (by <= 0)
+        return block;
+    const pad = ' '.repeat(by);
+    return block
+        .split('\n')
+        .map((l) => (l.length > 0 ? pad + l : l))
+        .join('\n');
+}
+/**
+ * Render a view-model node to a plain string (no ANSI, no styling). The
+ * non-interactive counterpart to {@link renderToInk}; both consume the
+ * same `ViewNode`, so the piped and TTY forms cannot drift.
+ */
+export function renderToText(node) {
+    switch (node.kind) {
+        case 'line': {
+            return spansToText(node.spans);
+        }
+        case 'heading': {
+            return `== ${node.text} ==`;
+        }
+        case 'keyValues': {
+            return node.pairs.map((p) => `${p.label}: ${p.value}`).join('\n');
+        }
+        case 'table': {
+            return tableToText(node.columns, node.rows, node.align, node.showHeader !== false);
+        }
+        case 'hints': {
+            return hintsToText(node.items);
+        }
+        case 'separator': {
+            return '─'.repeat(SEPARATOR_WIDTH);
+        }
+        case 'spacer': {
+            return '';
+        }
+        case 'group': {
+            return indentLines(node.children.map(renderToText).join('\n'), node.indent ?? 0);
+        }
+    }
+}
+//# sourceMappingURL=render-to-text.js.map

package/dist/render-to-text.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"render-to-text.js","sourceRoot":"","sources":["../src/render-to-text.ts"],"names":[],"mappings":"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"}

package/dist/run-footer-hints.d.ts

@@ -0,0 +1,32 @@
+/**
+ * RunFooterHints — shared bottom-of-output hint strip used by every Ink
+ * live view's done state.
+ *
+ * The format is fixed: a dim, two-space-indented line listing the
+ * next-step flags a user is likely to reach for, separated by " | ". Each
+ * tool supplies its own hints so the strip can name tool-specific flags
+ * (e.g. `--verbose`, `--report-to <url>`) while the surrounding visual
+ * treatment stays consistent.
+ *
+ * The strip lives once, as the `viewFooterHints` view-model producer. The
+ * Ink component renders it via `renderToInk`; the non-interactive path
+ * renders the same view through `renderToText`, so the two cannot drift.
+ * (The bold-substring tokenization is owned by the Ink interpreter's hint
+ * renderer.)
+ */
+import React from 'react';
+import type { ViewNode } from './view-model.js';
+export interface RunFooterHint {
+    /** Plain-text line to render. Substrings matching `bold` are bolded. */
+    readonly text: string;
+    /** Substrings within `text` to render bold. May be empty. */
+    readonly bold?: readonly string[];
+}
+export interface RunFooterHintsProps {
+    readonly hints: readonly RunFooterHint[];
+}
+/** The hint strip as a renderer-agnostic view-model node. */
+export declare function viewFooterHints(hints: readonly RunFooterHint[]): ViewNode;
+/** Ink view of {@link viewFooterHints}; renders nothing when there are no hints. */
+export declare function RunFooterHints({ hints }: RunFooterHintsProps): React.ReactElement | null;
+//# sourceMappingURL=run-footer-hints.d.ts.map

package/dist/run-footer-hints.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"run-footer-hints.d.ts","sourceRoot":"","sources":["../src/run-footer-hints.tsx"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;GAeG;AAGH,OAAO,KAAK,MAAM,OAAO,CAAC;AAI1B,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,iBAAiB,CAAC;AAEhD,MAAM,WAAW,aAAa;IAC5B,wEAAwE;IACxE,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,6DAA6D;IAC7D,QAAQ,CAAC,IAAI,CAAC,EAAE,SAAS,MAAM,EAAE,CAAC;CACnC;AAED,MAAM,WAAW,mBAAmB;IAClC,QAAQ,CAAC,KAAK,EAAE,SAAS,aAAa,EAAE,CAAC;CAC1C;AAED,6DAA6D;AAC7D,wBAAgB,eAAe,CAAC,KAAK,EAAE,SAAS,aAAa,EAAE,GAAG,QAAQ,CAKzE;AAED,oFAAoF;AACpF,wBAAgB,cAAc,CAAC,EAAE,KAAK,EAAE,EAAE,mBAAmB,GAAG,KAAK,CAAC,YAAY,GAAG,IAAI,CAGxF"}

package/dist/run-footer-hints.js

@@ -0,0 +1,33 @@
+import { jsx as _jsx } from "react/jsx-runtime";
+/**
+ * RunFooterHints — shared bottom-of-output hint strip used by every Ink
+ * live view's done state.
+ *
+ * The format is fixed: a dim, two-space-indented line listing the
+ * next-step flags a user is likely to reach for, separated by " | ". Each
+ * tool supplies its own hints so the strip can name tool-specific flags
+ * (e.g. `--verbose`, `--report-to <url>`) while the surrounding visual
+ * treatment stays consistent.
+ *
+ * The strip lives once, as the `viewFooterHints` view-model producer. The
+ * Ink component renders it via `renderToInk`; the non-interactive path
+ * renders the same view through `renderToText`, so the two cannot drift.
+ * (The bold-substring tokenization is owned by the Ink interpreter's hint
+ * renderer.)
+ */
+import { Box } from 'ink';
+import { renderToInk } from './render-to-ink.js';
+/** The hint strip as a renderer-agnostic view-model node. */
+export function viewFooterHints(hints) {
+    return {
+        kind: 'hints',
+        items: hints.map((h) => (h.bold ? { text: h.text, bold: h.bold } : { text: h.text })),
+    };
+}
+/** Ink view of {@link viewFooterHints}; renders nothing when there are no hints. */
+export function RunFooterHints({ hints }) {
+    if (hints.length === 0)
+        return null;
+    return _jsx(Box, { paddingTop: 1, children: renderToInk(viewFooterHints(hints)) });
+}
+//# sourceMappingURL=run-footer-hints.js.map

package/dist/run-footer-hints.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"run-footer-hints.js","sourceRoot":"","sources":["../src/run-footer-hints.tsx"],"names":[],"mappings":";AAAA;;;;;;;;;;;;;;;GAeG;AAEH,OAAO,EAAE,GAAG,EAAE,MAAM,KAAK,CAAC;AAG1B,OAAO,EAAE,WAAW,EAAE,MAAM,oBAAoB,CAAC;AAejD,6DAA6D;AAC7D,MAAM,UAAU,eAAe,CAAC,KAA+B;IAC7D,OAAO;QACL,IAAI,EAAE,OAAO;QACb,KAAK,EAAE,KAAK,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,IAAI,EAAE,CAAC,CAAC,IAAI,EAAE,IAAI,EAAE,CAAC,CAAC,IAAI,EAAE,CAAC,CAAC,CAAC,EAAE,IAAI,EAAE,CAAC,CAAC,IAAI,EAAE,CAAC,CAAC;KACtF,CAAC;AACJ,CAAC;AAED,oFAAoF;AACpF,MAAM,UAAU,cAAc,CAAC,EAAE,KAAK,EAAuB;IAC3D,IAAI,KAAK,CAAC,MAAM,KAAK,CAAC;QAAE,OAAO,IAAI,CAAC;IACpC,OAAO,KAAC,GAAG,IAAC,UAAU,EAAE,CAAC,YAAG,WAAW,CAAC,eAAe,CAAC,KAAK,CAAC,CAAC,GAAO,CAAC;AACzE,CAAC"}

package/dist/run-header.d.ts

@@ -0,0 +1,25 @@
+/**
+ * RunHeader — tool header shown after the banner + project line for each
+ * tool run. Displays the tool name, optional metadata key-value pairs,
+ * and an optional description, followed by a separator line.
+ *
+ * The project-location line is NOT rendered here — {@link ProjectHeader}
+ * is the single canonical renderer of `ℹ Project: <root>`, mounted by the
+ * App shell and each live view directly under the banner. RunHeader is
+ * purely the per-tool title/metadata band.
+ */
+import React from 'react';
+export interface RunHeaderMeta {
+    readonly label: string;
+    readonly value: string;
+}
+export interface RunHeaderProps {
+    /** Title rendered in brand color, e.g. `Fitness Checks`, `Code Graph`. */
+    readonly tool: string;
+    /** Optional description shown below the metadata row. */
+    readonly description?: string;
+    /** Metadata pairs rendered in the dim band below the title. */
+    readonly metadata?: readonly RunHeaderMeta[];
+}
+export declare function RunHeader({ tool, description, metadata, }: RunHeaderProps): React.ReactElement;
+//# sourceMappingURL=run-header.d.ts.map

package/dist/run-header.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"run-header.d.ts","sourceRoot":"","sources":["../src/run-header.tsx"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAGH,OAAO,KAAK,MAAM,OAAO,CAAC;AAI1B,MAAM,WAAW,aAAa;IAC5B,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;IACvB,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;CACxB;AAED,MAAM,WAAW,cAAc;IAC7B,0EAA0E;IAC1E,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,yDAAyD;IACzD,QAAQ,CAAC,WAAW,CAAC,EAAE,MAAM,CAAC;IAC9B,+DAA+D;IAC/D,QAAQ,CAAC,QAAQ,CAAC,EAAE,SAAS,aAAa,EAAE,CAAC;CAC9C;AAED,wBAAgB,SAAS,CAAC,EACxB,IAAI,EACJ,WAAW,EACX,QAAa,GACd,EAAE,cAAc,GAAG,KAAK,CAAC,YAAY,CAsBrC"}

package/dist/run-header.js

@@ -0,0 +1,19 @@
+import { jsx as _jsx, Fragment as _Fragment, jsxs as _jsxs } from "react/jsx-runtime";
+/**
+ * RunHeader — tool header shown after the banner + project line for each
+ * tool run. Displays the tool name, optional metadata key-value pairs,
+ * and an optional description, followed by a separator line.
+ *
+ * The project-location line is NOT rendered here — {@link ProjectHeader}
+ * is the single canonical renderer of `ℹ Project: <root>`, mounted by the
+ * App shell and each live view directly under the banner. RunHeader is
+ * purely the per-tool title/metadata band.
+ */
+import { Text, Box } from 'ink';
+import { useTheme } from './theme.js';
+export function RunHeader({ tool, description, metadata = [], }) {
+    const theme = useTheme();
+    const separator = '─'.repeat(60);
+    return (_jsxs(Box, { flexDirection: "column", paddingLeft: 2, paddingTop: 1, children: [_jsx(Text, { bold: true, color: theme.brand, children: tool }), metadata.length > 0 && (_jsx(Text, { dimColor: true, children: metadata.map((m) => `${m.label}: ${m.value}`).join('   ') })), description !== undefined && (_jsxs(_Fragment, { children: [_jsx(Text, { children: " " }), _jsx(Text, { dimColor: true, children: description })] })), _jsx(Text, { children: " " }), _jsx(Text, { dimColor: true, children: separator })] }));
+}
+//# sourceMappingURL=run-header.js.map

package/dist/run-header.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"run-header.js","sourceRoot":"","sources":["../src/run-header.tsx"],"names":[],"mappings":";AAAA;;;;;;;;;GASG;AAEH,OAAO,EAAE,IAAI,EAAE,GAAG,EAAE,MAAM,KAAK,CAAC;AAGhC,OAAO,EAAE,QAAQ,EAAE,MAAM,YAAY,CAAC;AAgBtC,MAAM,UAAU,SAAS,CAAC,EACxB,IAAI,EACJ,WAAW,EACX,QAAQ,GAAG,EAAE,GACE;IACf,MAAM,KAAK,GAAG,QAAQ,EAAE,CAAC;IACzB,MAAM,SAAS,GAAG,GAAG,CAAC,MAAM,CAAC,EAAE,CAAC,CAAC;IAEjC,OAAO,CACL,MAAC,GAAG,IAAC,aAAa,EAAC,QAAQ,EAAC,WAAW,EAAE,CAAC,EAAE,UAAU,EAAE,CAAC,aACvD,KAAC,IAAI,IAAC,IAAI,QAAC,KAAK,EAAE,KAAK,CAAC,KAAK,YAC1B,IAAI,GACA,EACN,QAAQ,CAAC,MAAM,GAAG,CAAC,IAAI,CACtB,KAAC,IAAI,IAAC,QAAQ,kBAAE,QAAQ,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,GAAG,CAAC,CAAC,KAAK,KAAK,CAAC,CAAC,KAAK,EAAE,CAAC,CAAC,IAAI,CAAC,KAAK,CAAC,GAAQ,CAClF,EACA,WAAW,KAAK,SAAS,IAAI,CAC5B,8BACE,KAAC,IAAI,oBAAS,EACd,KAAC,IAAI,IAAC,QAAQ,kBAAE,WAAW,GAAQ,IAClC,CACJ,EACD,KAAC,IAAI,oBAAS,EACd,KAAC,IAAI,IAAC,QAAQ,kBAAE,SAAS,GAAQ,IAC7B,CACP,CAAC;AACJ,CAAC"}

package/dist/run-summary.d.ts

@@ -0,0 +1,48 @@
+/**
+ * RunSummary — shared one-line PASS/FAIL summary used by every Ink live
+ * view in the suite (fitness, graph, sim).
+ *
+ * The format is fixed: `{PASS|FAIL}  ({E} Errors, {W} Warnings) | Duration {dur}`
+ * (ADR-0035). The leading token is the run's single verdict
+ * (`envelope.verdict.passed`) — the same value that drives the exit code — so
+ * the headline answers "did this run pass?" directly; the error/warning counts
+ * are the detail. A clean run reads `PASS  (0 Errors, 0 Warnings)` (no more
+ * misleading `0 Passed, 0 Failed`). Per-unit pass/fail lives in the table below.
+ * Colors are theme-driven (success/error for the verdict; error/warning for
+ * nonzero counts, muted when zero).
+ *
+ * The format lives once, as the `viewRunSummary` view-model producer. The
+ * Ink component is a thin wrapper that renders that view; the
+ * non-interactive (piped/CI) path renders the same view through
+ * `renderToText`, so the two cannot drift. (Previously the plain-text form
+ * was hand-retyped in graph's `writeRunSummaryPlain`.)
+ */
+import React from 'react';
+import { type ViewNode } from './view-model.js';
+export interface RunSummaryProps {
+    /** The run's single verdict (ADR-0035) — the headline PASS/FAIL token. */
+    readonly passed: boolean;
+    readonly errors: number;
+    readonly warnings: number;
+    /**
+     * Explicit duration. When omitted, the component reads from the nearest
+     * `RunTimingProvider` (host-owned run timer). This is the preferred path
+     * after the host-owned-run-timing migration.
+     *
+     * Kept optional for compat during Phases 3-5 (tools still passing the old
+     * per-tool numbers); once tools omit it the provider supplies the value
+     * that matches the persisted StoredSession.
+     */
+    readonly durationMs?: number;
+}
+/**
+ * The canonical summary line as a renderer-agnostic view-model node. Span
+ * text concatenates to exactly:
+ *   `{PASS|FAIL}  ({E} Errors, {W} Warnings) | Duration {dur}`
+ */
+export declare function viewRunSummary({ passed, errors, warnings, durationMs, }: RunSummaryProps): ViewNode;
+/** Ink view of {@link viewRunSummary}. Indented to `paddingLeft={2}` so the
+ *  live summary line aligns with the run header + footer hints (both also at 2)
+ *  instead of sitting flush-left against the indented rest of the output. */
+export declare function RunSummary(props: RunSummaryProps): React.ReactElement;
+//# sourceMappingURL=run-summary.d.ts.map

package/dist/run-summary.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"run-summary.d.ts","sourceRoot":"","sources":["../src/run-summary.tsx"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;GAkBG;AAGH,OAAO,KAAK,MAAM,OAAO,CAAC;AAK1B,OAAO,EAAmB,KAAK,QAAQ,EAAE,MAAM,iBAAiB,CAAC;AAEjE,MAAM,WAAW,eAAe;IAC9B,0EAA0E;IAC1E,QAAQ,CAAC,MAAM,EAAE,OAAO,CAAC;IACzB,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;IACxB,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC;IAC1B;;;;;;;;OAQG;IACH,QAAQ,CAAC,UAAU,CAAC,EAAE,MAAM,CAAC;CAC9B;AAED;;;;GAIG;AACH,wBAAgB,cAAc,CAAC,EAC7B,MAAM,EACN,MAAM,EACN,QAAQ,EACR,UAAc,GACf,EAAE,eAAe,GAAG,QAAQ,CAa5B;AAED;;6EAE6E;AAC7E,wBAAgB,UAAU,CAAC,KAAK,EAAE,eAAe,GAAG,KAAK,CAAC,YAAY,CAWrE"}

package/dist/run-summary.js

@@ -0,0 +1,56 @@
+import { jsx as _jsx } from "react/jsx-runtime";
+/**
+ * RunSummary — shared one-line PASS/FAIL summary used by every Ink live
+ * view in the suite (fitness, graph, sim).
+ *
+ * The format is fixed: `{PASS|FAIL}  ({E} Errors, {W} Warnings) | Duration {dur}`
+ * (ADR-0035). The leading token is the run's single verdict
+ * (`envelope.verdict.passed`) — the same value that drives the exit code — so
+ * the headline answers "did this run pass?" directly; the error/warning counts
+ * are the detail. A clean run reads `PASS  (0 Errors, 0 Warnings)` (no more
+ * misleading `0 Passed, 0 Failed`). Per-unit pass/fail lives in the table below.
+ * Colors are theme-driven (success/error for the verdict; error/warning for
+ * nonzero counts, muted when zero).
+ *
+ * The format lives once, as the `viewRunSummary` view-model producer. The
+ * Ink component is a thin wrapper that renders that view; the
+ * non-interactive (piped/CI) path renders the same view through
+ * `renderToText`, so the two cannot drift. (Previously the plain-text form
+ * was hand-retyped in graph's `writeRunSummaryPlain`.)
+ */
+import { Box } from 'ink';
+import { formatDuration } from './format-duration.js';
+import { renderToInk } from './render-to-ink.js';
+import { useRunDuration } from './run-timing-provider.js';
+import { line } from './view-model.js';
+/**
+ * The canonical summary line as a renderer-agnostic view-model node. Span
+ * text concatenates to exactly:
+ *   `{PASS|FAIL}  ({E} Errors, {W} Warnings) | Duration {dur}`
+ */
+export function viewRunSummary({ passed, errors, warnings, durationMs = 0, }) {
+    const spans = [
+        { text: passed ? 'PASS' : 'FAIL', tone: passed ? 'success' : 'error' },
+        { text: '  (' },
+        { text: `${errors} Errors`, tone: errors > 0 ? 'error' : 'muted' },
+        { text: ', ' },
+        { text: `${warnings} Warnings`, tone: warnings > 0 ? 'warning' : 'muted' },
+        { text: ') ' },
+        { text: '|', dim: true },
+        { text: ' Duration ' },
+        { text: formatDuration(durationMs), tone: 'info' },
+    ];
+    return line(spans);
+}
+/** Ink view of {@link viewRunSummary}. Indented to `paddingLeft={2}` so the
+ *  live summary line aligns with the run header + footer hints (both also at 2)
+ *  instead of sitting flush-left against the indented rest of the output. */
+export function RunSummary(props) {
+    // When durationMs omitted, read from the RunTimingProvider (host timer).
+    // This makes the displayed duration match the value that will be (or was)
+    // recorded to StoredSession via the host `runSession.record` seam.
+    const resolvedDuration = props.durationMs ?? useRunDuration();
+    const viewProps = { ...props, durationMs: resolvedDuration };
+    return (_jsx(Box, { paddingTop: 1, paddingLeft: 2, children: renderToInk(viewRunSummary(viewProps)) }));
+}
+//# sourceMappingURL=run-summary.js.map

package/dist/run-summary.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"run-summary.js","sourceRoot":"","sources":["../src/run-summary.tsx"],"names":[],"mappings":";AAAA;;;;;;;;;;;;;;;;;;GAkBG;AAEH,OAAO,EAAE,GAAG,EAAE,MAAM,KAAK,CAAC;AAG1B,OAAO,EAAE,cAAc,EAAE,MAAM,sBAAsB,CAAC;AACtD,OAAO,EAAE,WAAW,EAAE,MAAM,oBAAoB,CAAC;AACjD,OAAO,EAAE,cAAc,EAAE,MAAM,0BAA0B,CAAC;AAC1D,OAAO,EAAE,IAAI,EAA4B,MAAM,iBAAiB,CAAC;AAmBjE;;;;GAIG;AACH,MAAM,UAAU,cAAc,CAAC,EAC7B,MAAM,EACN,MAAM,EACN,QAAQ,EACR,UAAU,GAAG,CAAC,GACE;IAChB,MAAM,KAAK,GAAW;QACpB,EAAE,IAAI,EAAE,MAAM,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,MAAM,EAAE,IAAI,EAAE,MAAM,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC,OAAO,EAAE;QACtE,EAAE,IAAI,EAAE,KAAK,EAAE;QACf,EAAE,IAAI,EAAE,GAAG,MAAM,SAAS,EAAE,IAAI,EAAE,MAAM,GAAG,CAAC,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,OAAO,EAAE;QAClE,EAAE,IAAI,EAAE,IAAI,EAAE;QACd,EAAE,IAAI,EAAE,GAAG,QAAQ,WAAW,EAAE,IAAI,EAAE,QAAQ,GAAG,CAAC,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC,OAAO,EAAE;QAC1E,EAAE,IAAI,EAAE,IAAI,EAAE;QACd,EAAE,IAAI,EAAE,GAAG,EAAE,GAAG,EAAE,IAAI,EAAE;QACxB,EAAE,IAAI,EAAE,YAAY,EAAE;QACtB,EAAE,IAAI,EAAE,cAAc,CAAC,UAAU,CAAC,EAAE,IAAI,EAAE,MAAM,EAAE;KACnD,CAAC;IACF,OAAO,IAAI,CAAC,KAAK,CAAC,CAAC;AACrB,CAAC;AAED;;6EAE6E;AAC7E,MAAM,UAAU,UAAU,CAAC,KAAsB;IAC/C,yEAAyE;IACzE,0EAA0E;IAC1E,mEAAmE;IACnE,MAAM,gBAAgB,GAAG,KAAK,CAAC,UAAU,IAAI,cAAc,EAAE,CAAC;IAC9D,MAAM,SAAS,GAAoB,EAAE,GAAG,KAAK,EAAE,UAAU,EAAE,gBAAgB,EAAE,CAAC;IAC9E,OAAO,CACL,KAAC,GAAG,IAAC,UAAU,EAAE,CAAC,EAAE,WAAW,EAAE,CAAC,YAC/B,WAAW,CAAC,cAAc,CAAC,SAAS,CAAC,CAAC,GACnC,CACP,CAAC;AACJ,CAAC"}

package/dist/run-timing-provider.d.ts

@@ -0,0 +1,59 @@
+/**
+ * RunTimingProvider + hooks — React context bridge for the host-owned
+ * `RunTimer` (host-owned-run-timing plan).
+ *
+ * Live views (and any nested RunSummary) receive the *exact same* timer
+ * instance that the host stamped into `ToolCliContext.runSession.timing` (and
+ * forwarded via the optional `LiveViewContext` second arg to the renderer).
+ *
+ * This lets the UI read wall duration without tools threading numbers, and
+ * ensures the persisted StoredSession.durationMs (from the host snapshot at
+ * record time) and the final "Duration X" line agree.
+ *
+ * Usage in a live renderer:
+ *   <RunTimingProvider timer={context.runSession.timing}>
+ *     <RunSummary passed=... errors=... warnings=... />
+ *   </RunTimingProvider>
+ *
+ * Components can omit durationMs and read from the provider.
+ */
+import React, { type ReactNode } from 'react';
+/**
+ * Structural shape of the host `RunTimer` (from `@opensip-cli/core`) that this
+ * presentational kit consumes. Defined locally so `@opensip-cli/cli-ui` keeps
+ * ZERO workspace dependencies — it is a pure Ink/React primitives package and
+ * must not depend on the kernel (enforced by dependency-cruiser). Core's
+ * `RunTimer` is structurally assignable, so callers pass `cli.runSession.timing`
+ * (or `LiveViewContext.runSession.timing`) unchanged.
+ */
+export interface RunTimerLike {
+    /** Monotonic elapsed time since the run started, in milliseconds. */
+    elapsedMs(): number;
+}
+/** Props for the provider that wraps a live view subtree. */
+export interface RunTimingProviderProps {
+    /** The host timer from `cli.runSession.timing` (or LiveViewContext). */
+    readonly timer: RunTimerLike;
+    readonly children: ReactNode;
+}
+/**
+ * Provides a `RunTimer` to descendants. Safe to nest; inner wins.
+ * The timer is a stable object for the whole run — its `elapsedMs()` and
+ * `snapshot()` are what produce live ticking + final recorded duration.
+ */
+export declare function RunTimingProvider({ timer, children }: RunTimingProviderProps): React.JSX.Element;
+/**
+ * Read the current host `RunTimer` (or null if no provider in tree).
+ * Components should handle null (falls back to explicit prop or 0).
+ */
+export declare function useRunTiming(): RunTimerLike | null;
+/**
+ * Convenience: current elapsed duration in ms.
+ * - During a live run: reflects `timer.elapsedMs()` at render time (ticking UX).
+ * - After done: a consumer can snapshot once and pass an explicit durationMs
+ *   if they want a frozen completed value (see RunSummary).
+ *
+ * Returns 0 when no provider (safe default).
+ */
+export declare function useRunDuration(): number;
+//# sourceMappingURL=run-timing-provider.d.ts.map

package/dist/run-timing-provider.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"run-timing-provider.d.ts","sourceRoot":"","sources":["../src/run-timing-provider.tsx"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;GAkBG;AAEH,OAAO,KAAK,EAAE,EAA6B,KAAK,SAAS,EAAE,MAAM,OAAO,CAAC;AAEzE;;;;;;;GAOG;AACH,MAAM,WAAW,YAAY;IAC3B,qEAAqE;IACrE,SAAS,IAAI,MAAM,CAAC;CACrB;AAID,6DAA6D;AAC7D,MAAM,WAAW,sBAAsB;IACrC,wEAAwE;IACxE,QAAQ,CAAC,KAAK,EAAE,YAAY,CAAC;IAC7B,QAAQ,CAAC,QAAQ,EAAE,SAAS,CAAC;CAC9B;AAED;;;;GAIG;AACH,wBAAgB,iBAAiB,CAAC,EAAE,KAAK,EAAE,QAAQ,EAAE,EAAE,sBAAsB,qBAE5E;AAED;;;GAGG;AACH,wBAAgB,YAAY,IAAI,YAAY,GAAG,IAAI,CAElD;AAED;;;;;;;GAOG;AACH,wBAAgB,cAAc,IAAI,MAAM,CAIvC"}

package/dist/run-timing-provider.js

@@ -0,0 +1,52 @@
+import { jsx as _jsx } from "react/jsx-runtime";
+/**
+ * RunTimingProvider + hooks — React context bridge for the host-owned
+ * `RunTimer` (host-owned-run-timing plan).
+ *
+ * Live views (and any nested RunSummary) receive the *exact same* timer
+ * instance that the host stamped into `ToolCliContext.runSession.timing` (and
+ * forwarded via the optional `LiveViewContext` second arg to the renderer).
+ *
+ * This lets the UI read wall duration without tools threading numbers, and
+ * ensures the persisted StoredSession.durationMs (from the host snapshot at
+ * record time) and the final "Duration X" line agree.
+ *
+ * Usage in a live renderer:
+ *   <RunTimingProvider timer={context.runSession.timing}>
+ *     <RunSummary passed=... errors=... warnings=... />
+ *   </RunTimingProvider>
+ *
+ * Components can omit durationMs and read from the provider.
+ */
+import { createContext, useContext } from 'react';
+const RunTimingContext = createContext(null);
+/**
+ * Provides a `RunTimer` to descendants. Safe to nest; inner wins.
+ * The timer is a stable object for the whole run — its `elapsedMs()` and
+ * `snapshot()` are what produce live ticking + final recorded duration.
+ */
+export function RunTimingProvider({ timer, children }) {
+    return _jsx(RunTimingContext.Provider, { value: timer, children: children });
+}
+/**
+ * Read the current host `RunTimer` (or null if no provider in tree).
+ * Components should handle null (falls back to explicit prop or 0).
+ */
+export function useRunTiming() {
+    return useContext(RunTimingContext);
+}
+/**
+ * Convenience: current elapsed duration in ms.
+ * - During a live run: reflects `timer.elapsedMs()` at render time (ticking UX).
+ * - After done: a consumer can snapshot once and pass an explicit durationMs
+ *   if they want a frozen completed value (see RunSummary).
+ *
+ * Returns 0 when no provider (safe default).
+ */
+export function useRunDuration() {
+    const timer = useRunTiming();
+    if (!timer)
+        return 0;
+    return timer.elapsedMs();
+}
+//# sourceMappingURL=run-timing-provider.js.map

package/dist/run-timing-provider.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"run-timing-provider.js","sourceRoot":"","sources":["../src/run-timing-provider.tsx"],"names":[],"mappings":";AAAA;;;;;;;;;;;;;;;;;;GAkBG;AAEH,OAAc,EAAE,aAAa,EAAE,UAAU,EAAkB,MAAM,OAAO,CAAC;AAezE,MAAM,gBAAgB,GAAG,aAAa,CAAsB,IAAI,CAAC,CAAC;AASlE;;;;GAIG;AACH,MAAM,UAAU,iBAAiB,CAAC,EAAE,KAAK,EAAE,QAAQ,EAA0B;IAC3E,OAAO,KAAC,gBAAgB,CAAC,QAAQ,IAAC,KAAK,EAAE,KAAK,YAAG,QAAQ,GAA6B,CAAC;AACzF,CAAC;AAED;;;GAGG;AACH,MAAM,UAAU,YAAY;IAC1B,OAAO,UAAU,CAAC,gBAAgB,CAAC,CAAC;AACtC,CAAC;AAED;;;;;;;GAOG;AACH,MAAM,UAAU,cAAc;IAC5B,MAAM,KAAK,GAAG,YAAY,EAAE,CAAC;IAC7B,IAAI,CAAC,KAAK;QAAE,OAAO,CAAC,CAAC;IACrB,OAAO,KAAK,CAAC,SAAS,EAAE,CAAC;AAC3B,CAAC"}

package/dist/spinner.d.ts

@@ -0,0 +1,29 @@
+/**
+ * Spinner — animated progress indicator. Renders one braille frame per tick
+ * plus an optional `completed/total (pct%)` suffix.
+ *
+ * Two modes:
+ *  - Inside a `<ClockProvider>`: consumes the provider's tick via
+ *    `useClock()`. Multiple spinners share the same timer.
+ *  - Outside a provider (default): owns its own interval via `useTick()`.
+ *    Convenient for single-spinner screens where setting up a provider
+ *    is unnecessary.
+ */
+import React from 'react';
+/** Spinner frame keyed off the surrounding `<ClockProvider>`. */
+export declare function useSpinner(): string;
+/** Spinner frame from a self-owned interval — provider-free. */
+export declare function useStandaloneSpinner(intervalMs?: number): string;
+export interface SpinnerProps {
+    readonly total: number;
+    readonly completed: number;
+    readonly label?: string;
+    /**
+     * When true, the spinner uses its own internal tick instead of consuming
+     * a `<ClockProvider>`. Useful for tool runners that don't want to wrap
+     * their tree in a provider for a single spinner.
+     */
+    readonly standalone?: boolean;
+}
+export declare function Spinner({ total, completed, label, standalone, }: SpinnerProps): React.ReactElement;
+//# sourceMappingURL=spinner.d.ts.map

package/dist/spinner.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"spinner.d.ts","sourceRoot":"","sources":["../src/spinner.tsx"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAGH,OAAO,KAAK,MAAM,OAAO,CAAC;AAO1B,iEAAiE;AACjE,wBAAgB,UAAU,IAAI,MAAM,CAGnC;AAED,gEAAgE;AAChE,wBAAgB,oBAAoB,CAAC,UAAU,CAAC,EAAE,MAAM,GAAG,MAAM,CAGhE;AAED,MAAM,WAAW,YAAY;IAC3B,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;IACvB,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC;IAC3B,QAAQ,CAAC,KAAK,CAAC,EAAE,MAAM,CAAC;IACxB;;;;OAIG;IACH,QAAQ,CAAC,UAAU,CAAC,EAAE,OAAO,CAAC;CAC/B;AAED,wBAAgB,OAAO,CAAC,EACtB,KAAK,EACL,SAAS,EACT,KAAoB,EACpB,UAAkB,GACnB,EAAE,YAAY,GAAG,KAAK,CAAC,YAAY,CAMnC"}