@kya-os/cli 1.8.1 → 1.8.3

package/dist/tui/components.d.ts

@@ -0,0 +1,110 @@
+/**
+ * Presentation primitives, ported from the V2 analytics surface.
+ *
+ * The reference is checkpoint's
+ * `apps/web/components/features/analytics/DESIGN.md`, whose layout spec is
+ * itself written as ASCII, so this is closer to a transcription than an
+ * interpretation:
+ *
+ *     [ Bots ]  [ AI ]  [ Humans ]  [ Blocked ]        7D · 30D · 90D
+ *     ─────────────────────────────────────────────────────────────
+ *     259 sessions · 14 agents · 4 humans · 0 blocked   last seen just now
+ *     ─────────────────────────────────────────────────────────────
+ *     ╭ Sessions over time                              7D · daily ╮
+ *     Recent activity
+ *     Agent          Sessions  Humans behind  Tools called  Last seen
+ *
+ * @module cli/tui/components
+ */
+export interface Stat {
+    label: string;
+    value: string | number;
+}
+/**
+ * The stat strip: `259 sessions · 14 agents · 4 humans · 0 blocked`.
+ *
+ * Value first, label second, matching the dashboard. Reading "259 sessions"
+ * is one glance; "sessions: 259" is two.
+ */
+export declare function StatStrip({ stats, trailing, width, }: {
+    stats: Stat[];
+    trailing?: string;
+    width: number;
+}): JSX.Element;
+/**
+ * Lens chips. One is active; the rest are affordances.
+ *
+ * The dashboard renders these as pills. A terminal has no pills, so the active
+ * one is the accent and the rest are dim, which is the same information with
+ * the same glance cost.
+ */
+export declare function Chips({ items, activeIndex, }: {
+    items: readonly string[];
+    /**
+     * Which chip is active, BY INDEX rather than by label. Matching on the label
+     * broke the moment labels carried their counts ("Open 3"), and it silently
+     * highlighted nothing rather than failing, which is the worst way for a
+     * selection bug to present.
+     */
+    activeIndex: number;
+}): JSX.Element;
+/** A full-width horizontal rule, the dashboard's section divider. */
+export declare function Rule({ width }: {
+    width: number;
+}): JSX.Element;
+export interface Column<T> {
+    header: string;
+    width: number;
+    /** Cell text. Colour is separate so the value and its emphasis stay apart. */
+    render: (row: T) => string;
+    color?: (row: T) => string;
+}
+/**
+ * The column-matrix table from the design doc.
+ *
+ * Truncates rather than wraps. A wrapped row in a dense table destroys the
+ * column alignment that makes the table readable at a glance, and the
+ * alignment is the whole reason it is a table.
+ */
+/**
+ * Shrink columns until the row fits the pane.
+ *
+ * Declared widths are what the columns WANT; the pane decides what they get.
+ * Each pass takes a column from the widest column, so a narrow terminal eats
+ * into the roomiest field first and the tight ones (a status, a timestamp)
+ * keep their shape. Exported for its own test: the alternative is inferring
+ * the arithmetic from rendered frames, which is how an off-by-one hides.
+ */
+export declare function fitColumns<T>(columns: Column<T>[], width: number): number[];
+export declare function Table<T>({ columns, rows, selected, empty, width, }: {
+    columns: Column<T>[];
+    rows: T[];
+    selected?: number;
+    empty: string;
+    width: number;
+}): JSX.Element;
+/**
+ * The "Sessions over time" pane as a text sparkline.
+ *
+ * The dashboard draws a stacked area chart. A terminal gets eight block
+ * glyphs, which carries the shape (the only thing anyone reads off that chart
+ * at a glance) without pretending to be a chart.
+ */
+export declare function Sparkline({ values }: {
+    values: number[];
+}): JSX.Element;
+/**
+ * A title row with an optional right-aligned hint.
+ *
+ * Replaces a bordered Pane component that nothing ever rendered. Two reasons
+ * it went: a border needs every row inside it padded to width or the right
+ * edge frays, and this is the third place a title-plus-hint row was hand-rolled
+ * -- each one an independent chance to forget the width and let the hint drift
+ * past the rule under it, which is exactly what the journal header did.
+ */
+export declare function SectionHeader({ title, hint, width, }: {
+    title: string;
+    hint?: string;
+    width: number;
+}): JSX.Element;
+//# sourceMappingURL=components.d.ts.map

package/dist/tui/components.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"components.d.ts","sourceRoot":"","sources":["../../src/tui/components.tsx"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;GAiBG;AAUH,MAAM,WAAW,IAAI;IACnB,KAAK,EAAE,MAAM,CAAC;IACd,KAAK,EAAE,MAAM,GAAG,MAAM,CAAC;CACxB;AAED;;;;;GAKG;AACH,wBAAgB,SAAS,CAAC,EACxB,KAAK,EACL,QAAQ,EACR,KAAK,GACN,EAAE;IACD,KAAK,EAAE,IAAI,EAAE,CAAC;IACd,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,KAAK,EAAE,MAAM,CAAC;CACf,GAAG,GAAG,CAAC,OAAO,CAoBd;AAED;;;;;;GAMG;AACH,wBAAgB,KAAK,CAAC,EACpB,KAAK,EACL,WAAW,GACZ,EAAE;IACD,KAAK,EAAE,SAAS,MAAM,EAAE,CAAC;IACzB;;;;;OAKG;IACH,WAAW,EAAE,MAAM,CAAC;CACrB,GAAG,GAAG,CAAC,OAAO,CAYd;AAED,qEAAqE;AACrE,wBAAgB,IAAI,CAAC,EAAE,KAAK,EAAE,EAAE;IAAE,KAAK,EAAE,MAAM,CAAA;CAAE,GAAG,GAAG,CAAC,OAAO,CAE9D;AAED,MAAM,WAAW,MAAM,CAAC,CAAC;IACvB,MAAM,EAAE,MAAM,CAAC;IACf,KAAK,EAAE,MAAM,CAAC;IACd,8EAA8E;IAC9E,MAAM,EAAE,CAAC,GAAG,EAAE,CAAC,KAAK,MAAM,CAAC;IAC3B,KAAK,CAAC,EAAE,CAAC,GAAG,EAAE,CAAC,KAAK,MAAM,CAAC;CAC5B;AAED;;;;;;GAMG;AACH;;;;;;;;GAQG;AACH,wBAAgB,UAAU,CAAC,CAAC,EAAE,OAAO,EAAE,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,KAAK,EAAE,MAAM,GAAG,MAAM,EAAE,CAgB3E;AAED,wBAAgB,KAAK,CAAC,CAAC,EAAE,EACvB,OAAO,EACP,IAAI,EACJ,QAAQ,EACR,KAAK,EACL,KAAK,GACN,EAAE;IACD,OAAO,EAAE,MAAM,CAAC,CAAC,CAAC,EAAE,CAAC;IACrB,IAAI,EAAE,CAAC,EAAE,CAAC;IACV,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,KAAK,EAAE,MAAM,CAAC;IACd,KAAK,EAAE,MAAM,CAAC;CACf,GAAG,GAAG,CAAC,OAAO,CAsDd;AAED;;;;;;GAMG;AACH,wBAAgB,SAAS,CAAC,EAAE,MAAM,EAAE,EAAE;IAAE,MAAM,EAAE,MAAM,EAAE,CAAA;CAAE,GAAG,GAAG,CAAC,OAAO,CAQvE;AAED;;;;;;;;GAQG;AACH,wBAAgB,aAAa,CAAC,EAC5B,KAAK,EACL,IAAI,EACJ,KAAK,GACN,EAAE;IACD,KAAK,EAAE,MAAM,CAAC;IACd,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,KAAK,EAAE,MAAM,CAAC;CACf,GAAG,GAAG,CAAC,OAAO,CAOd"}

package/dist/tui/components.js

@@ -0,0 +1,118 @@
+import { jsx as _jsx, jsxs as _jsxs } from "react/jsx-runtime";
+import { Box, Text } from "ink";
+import { theme } from "./theme.js";
+import { plain } from "./sanitize.js";
+/** The `a · b · c` separator the dashboard uses between inline facts. */
+const DOT = " · ";
+/**
+ * The stat strip: `259 sessions · 14 agents · 4 humans · 0 blocked`.
+ *
+ * Value first, label second, matching the dashboard. Reading "259 sessions"
+ * is one glance; "sessions: 259" is two.
+ */
+export function StatStrip({ stats, trailing, width, }) {
+    // The width is explicit, like Rule's, because space-between only distributes
+    // within a box that HAS a width. Left to size itself, Ink grows the box to
+    // fit its content, so the trailing text drifts past the rule above it by
+    // however long the stats happen to be -- wider on a busy ledger than a quiet
+    // one, which is the sort of misalignment that only shows up with real data.
+    return (_jsxs(Box, { width: width, justifyContent: "space-between", children: [_jsx(Box, { children: stats.map((s, i) => (_jsxs(Text, { children: [i > 0 ? _jsx(Text, { color: theme.dim, children: DOT }) : null, _jsx(Text, { bold: true, children: String(s.value) }), _jsxs(Text, { color: theme.dim, children: [" ", s.label] })] }, s.label))) }), trailing ? _jsx(Text, { color: theme.dim, children: trailing }) : null] }));
+}
+/**
+ * Lens chips. One is active; the rest are affordances.
+ *
+ * The dashboard renders these as pills. A terminal has no pills, so the active
+ * one is the accent and the rest are dim, which is the same information with
+ * the same glance cost.
+ */
+export function Chips({ items, activeIndex, }) {
+    return (_jsx(Box, { children: items.map((c, i) => (_jsx(Box, { marginRight: 2, children: _jsx(Text, { color: i === activeIndex ? theme.accent : theme.dim, bold: i === activeIndex, children: i === activeIndex ? `[ ${c} ]` : `  ${c}  ` }) }, c))) }));
+}
+/** A full-width horizontal rule, the dashboard's section divider. */
+export function Rule({ width }) {
+    return _jsx(Text, { color: theme.line, children: "─".repeat(Math.max(0, width)) });
+}
+/**
+ * The column-matrix table from the design doc.
+ *
+ * Truncates rather than wraps. A wrapped row in a dense table destroys the
+ * column alignment that makes the table readable at a glance, and the
+ * alignment is the whole reason it is a table.
+ */
+/**
+ * Shrink columns until the row fits the pane.
+ *
+ * Declared widths are what the columns WANT; the pane decides what they get.
+ * Each pass takes a column from the widest column, so a narrow terminal eats
+ * into the roomiest field first and the tight ones (a status, a timestamp)
+ * keep their shape. Exported for its own test: the alternative is inferring
+ * the arithmetic from rendered frames, which is how an off-by-one hides.
+ */
+export function fitColumns(columns, width) {
+    const MIN = 4;
+    // Each cell renders its padded text plus one space of gutter.
+    const widths = columns.map((c) => c.width);
+    const total = () => widths.reduce((a, b) => a + b + 1, 0);
+    // Bounded by construction: every pass either shrinks a column or finds
+    // nothing above the floor and stops, so this cannot spin.
+    while (total() > width) {
+        let widest = 0;
+        for (let i = 1; i < widths.length; i++) {
+            if (widths[i] > widths[widest])
+                widest = i;
+        }
+        if (widths[widest] <= MIN)
+            break;
+        widths[widest]--;
+    }
+    return widths;
+}
+export function Table({ columns, rows, selected, empty, width, }) {
+    // Sanitize BEFORE measuring: a stripped escape must not still count toward
+    // the column width, or a hostile title silently squeezes the real columns.
+    const pad = (raw, w) => {
+        const s = plain(raw);
+        return s.length > w ? (w > 1 ? s.slice(0, w - 1) + "\u2026" : s.slice(0, w)) : s.padEnd(w);
+    };
+    const fitted = fitColumns(columns, width);
+    // One header, used by both the empty and populated cases. It was duplicated,
+    // which is the shape where a column tweak lands in one branch and the empty
+    // table quietly keeps the old header.
+    const header = (_jsx(Box, { children: columns.map((c, i) => (_jsxs(Text, { color: theme.dim, children: [pad(c.header, fitted[i]), " "] }, c.header))) }));
+    if (rows.length === 0) {
+        // Never blank. The design doc is explicit that every lens gets honest,
+        // useful empty copy rather than an empty box.
+        return (_jsxs(Box, { flexDirection: "column", children: [header, _jsx(Box, { marginTop: 1, children: _jsx(Text, { color: theme.dim, children: empty }) })] }));
+    }
+    return (_jsxs(Box, { flexDirection: "column", children: [header, rows.map((row, i) => (_jsx(Box, { children: columns.map((c, ci) => (_jsxs(Text, { color: i === selected ? theme.accent : c.color?.(row), bold: i === selected, children: [pad(c.render(row), fitted[ci]), " "] }, c.header))) }, i)))] }));
+}
+/**
+ * The "Sessions over time" pane as a text sparkline.
+ *
+ * The dashboard draws a stacked area chart. A terminal gets eight block
+ * glyphs, which carries the shape (the only thing anyone reads off that chart
+ * at a glance) without pretending to be a chart.
+ */
+export function Sparkline({ values }) {
+    if (values.length === 0)
+        return _jsx(Text, { color: theme.dim, children: "no data yet" });
+    const blocks = "▁▂▃▄▅▆▇█";
+    const max = Math.max(...values, 1);
+    const line = values
+        .map((v) => blocks[Math.min(blocks.length - 1, Math.round((v / max) * (blocks.length - 1)))])
+        .join("");
+    return _jsx(Text, { color: theme.accent, children: line });
+}
+/**
+ * A title row with an optional right-aligned hint.
+ *
+ * Replaces a bordered Pane component that nothing ever rendered. Two reasons
+ * it went: a border needs every row inside it padded to width or the right
+ * edge frays, and this is the third place a title-plus-hint row was hand-rolled
+ * -- each one an independent chance to forget the width and let the hint drift
+ * past the rule under it, which is exactly what the journal header did.
+ */
+export function SectionHeader({ title, hint, width, }) {
+    return (_jsxs(Box, { width: width, justifyContent: "space-between", children: [_jsx(Text, { bold: true, children: title }), hint ? _jsx(Text, { color: theme.dim, children: hint }) : null] }));
+}
+//# sourceMappingURL=components.js.map

package/dist/tui/components.js.map

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

package/dist/tui/index.d.ts

@@ -0,0 +1,30 @@
+/**
+ * TUI entry point.
+ *
+ * Ink and React are OPTIONAL dependencies loaded here and nowhere else. A
+ * `kya-os init` run may now offer to open this (review-loop P18) -- but only
+ * on an explicit yes, and only from a TTY; a plain, non-interactive, or
+ * declined init never imports ink or React, so the lazy-import property this
+ * module has always documented still holds: nobody pays for a React
+ * renderer without asking for one. Same reasoning as better-sqlite3.
+ *
+ * @module cli/tui
+ */
+import { type Ledger } from "../orchestrator/db/index.js";
+import type { LedgerSnapshot } from "./views/index.js";
+export declare function readSnapshot(db: Ledger): LedgerSnapshot;
+/**
+ * One-shot text rendering for a non-TTY.
+ *
+ * A TUI that hangs or exits non-zero when piped breaks CI for everyone, so the
+ * non-interactive path prints a snapshot and exits 0 rather than trying to
+ * take over a terminal that isn't there.
+ */
+export declare function renderSnapshotText(snap: LedgerSnapshot): string;
+export interface RunTuiOptions {
+    ledgerPath?: string;
+    /** Nav id to land on instead of the default first item (e.g. "agents"). */
+    initialViewId?: string;
+}
+export declare function runTui(opts?: RunTuiOptions): Promise<void>;
+//# sourceMappingURL=index.d.ts.map

package/dist/tui/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/tui/index.tsx"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AAEH,OAAO,EAAc,KAAK,MAAM,EAAE,MAAM,6BAA6B,CAAC;AAKtE,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,kBAAkB,CAAC;AAEvD,wBAAgB,YAAY,CAAC,EAAE,EAAE,MAAM,GAAG,cAAc,CAMvD;AAED;;;;;;GAMG;AACH,wBAAgB,kBAAkB,CAAC,IAAI,EAAE,cAAc,GAAG,MAAM,CAwB/D;AAED,MAAM,WAAW,aAAa;IAC5B,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,2EAA2E;IAC3E,aAAa,CAAC,EAAE,MAAM,CAAC;CACxB;AAED,wBAAsB,MAAM,CAAC,IAAI,GAAE,aAAkB,GAAG,OAAO,CAAC,IAAI,CAAC,CA6CpE"}

package/dist/tui/index.js

@@ -0,0 +1,95 @@
+/**
+ * TUI entry point.
+ *
+ * Ink and React are OPTIONAL dependencies loaded here and nowhere else. A
+ * `kya-os init` run may now offer to open this (review-loop P18) -- but only
+ * on an explicit yes, and only from a TTY; a plain, non-interactive, or
+ * declined init never imports ink or React, so the lazy-import property this
+ * module has always documented still holds: nobody pays for a React
+ * renderer without asking for one. Same reasoning as better-sqlite3.
+ *
+ * @module cli/tui
+ */
+import { openLedger } from "../orchestrator/db/index.js";
+import { plain } from "./sanitize.js";
+import { listTickets } from "../orchestrator/db/tickets.js";
+import { listJournal } from "../orchestrator/db/journal.js";
+import { listDispatches } from "../orchestrator/db/dispatches.js";
+export function readSnapshot(db) {
+    return {
+        tickets: listTickets(db),
+        journal: listJournal(db, 200),
+        dispatches: listDispatches(db),
+    };
+}
+/**
+ * One-shot text rendering for a non-TTY.
+ *
+ * A TUI that hangs or exits non-zero when piped breaks CI for everyone, so the
+ * non-interactive path prints a snapshot and exits 0 rather than trying to
+ * take over a terminal that isn't there.
+ */
+export function renderSnapshotText(snap) {
+    const open = snap.tickets.filter((t) => t.status === "open").length;
+    const blocked = snap.tickets.filter((t) => t.status === "blocked").length;
+    // "1 dispatches" reads like a bug in the ledger rather than in the label,
+    // which is a bad first impression for a line whose whole job is to tell you
+    // the numbers are trustworthy.
+    const count = (n, one, many = `${one}s`) => `${n} ${n === 1 ? one : many}`;
+    const lines = [
+        "KYA-OS orchestrator",
+        "",
+        `${count(snap.tickets.length, "ticket")} · ${open} open · ${blocked} blocked · ` +
+            `${count(snap.dispatches.length, "dispatch", "dispatches")} · ` +
+            `${count(snap.journal.length, "observation")}`,
+    ];
+    if (snap.tickets.length) {
+        lines.push("", "Tickets");
+        for (const t of snap.tickets.slice(0, 10)) {
+            // Same hazard as the rendered frame: piping does not mean the far end
+            // is not a terminal. `... | cat` and `... | less` both still paint one.
+            lines.push(`  ${t.status.padEnd(12)} ${plain(t.title)}`);
+        }
+    }
+    return lines.join("\n");
+}
+export async function runTui(opts = {}) {
+    const db = openLedger(opts.ledgerPath);
+    // Every exit from here on, including a throw from ink/react loading, the
+    // dynamic view imports, render, or waitUntilExit, must still close the
+    // handle. Sibling orchestrator commands hold the same invariant via
+    // withLedger; this path is async so it earns its own try/finally.
+    try {
+        const snap = readSnapshot(db);
+        if (!process.stdout.isTTY) {
+            process.stdout.write(renderSnapshotText(snap) + "\n");
+            return;
+        }
+        let render;
+        let React;
+        try {
+            ({ render } = await import("ink"));
+            React = await import("react");
+        }
+        catch (err) {
+            throw new Error("The TUI needs the optional 'ink' and 'react' dependencies, which are not " +
+                "installed. Install them with `npm install ink react`, or use " +
+                "`kya-os orchestrator status` for a text view. " +
+                `Underlying error: ${err instanceof Error ? err.message : String(err)}`);
+        }
+        const { App } = await import("./app.js");
+        const { buildViews } = await import("./views/registry.js");
+        const { waitUntilExit } = render(React.createElement(App, {
+            views: await buildViews(snap),
+            width: process.stdout.columns ?? 100,
+            height: process.stdout.rows ?? 30,
+            authenticated: false,
+            initialViewId: opts.initialViewId,
+        }));
+        await waitUntilExit();
+    }
+    finally {
+        db.close();
+    }
+}
+//# sourceMappingURL=index.js.map

package/dist/tui/index.js.map

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

package/dist/tui/keymap.d.ts

@@ -0,0 +1,33 @@
+/**
+ * Keyboard handling as a pure function.
+ *
+ * Extracted from the component deliberately. Driving keystrokes through a
+ * renderer to assert on a rendered frame tests the harness as much as the
+ * logic, and when it fails you cannot tell which one broke. A reducer over
+ * (state, key) -> state is directly testable, and the component becomes a
+ * thin adapter that owns no behaviour worth testing.
+ *
+ * @module cli/tui/keymap
+ */
+export interface KeyState {
+    index: number;
+    /** Index into the active view's own filter list. */
+    filter: number;
+    showHelp: boolean;
+    exit: boolean;
+}
+export interface KeyEvent {
+    input: string;
+    upArrow?: boolean;
+    downArrow?: boolean;
+}
+/**
+ * Apply one key press.
+ *
+ * `count` is how many selectable nav entries exist; `filters` how many filter
+ * chips the CURRENT view offers. Moving to another view resets the filter,
+ * because the index means something different there -- leaving it at 3 while
+ * landing on a view with two chips would select a chip that is not on screen.
+ */
+export declare function reduceKey(state: KeyState, ev: KeyEvent, count: number, filters?: number): KeyState;
+//# sourceMappingURL=keymap.d.ts.map

package/dist/tui/keymap.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"keymap.d.ts","sourceRoot":"","sources":["../../src/tui/keymap.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAEH,MAAM,WAAW,QAAQ;IACvB,KAAK,EAAE,MAAM,CAAC;IACd,oDAAoD;IACpD,MAAM,EAAE,MAAM,CAAC;IACf,QAAQ,EAAE,OAAO,CAAC;IAClB,IAAI,EAAE,OAAO,CAAC;CACf;AAED,MAAM,WAAW,QAAQ;IACvB,KAAK,EAAE,MAAM,CAAC;IACd,OAAO,CAAC,EAAE,OAAO,CAAC;IAClB,SAAS,CAAC,EAAE,OAAO,CAAC;CACrB;AAED;;;;;;;GAOG;AACH,wBAAgB,SAAS,CACvB,KAAK,EAAE,QAAQ,EACf,EAAE,EAAE,QAAQ,EACZ,KAAK,EAAE,MAAM,EACb,OAAO,SAAI,GACV,QAAQ,CA+BV"}

package/dist/tui/keymap.js

@@ -0,0 +1,49 @@
+/**
+ * Keyboard handling as a pure function.
+ *
+ * Extracted from the component deliberately. Driving keystrokes through a
+ * renderer to assert on a rendered frame tests the harness as much as the
+ * logic, and when it fails you cannot tell which one broke. A reducer over
+ * (state, key) -> state is directly testable, and the component becomes a
+ * thin adapter that owns no behaviour worth testing.
+ *
+ * @module cli/tui/keymap
+ */
+/**
+ * Apply one key press.
+ *
+ * `count` is how many selectable nav entries exist; `filters` how many filter
+ * chips the CURRENT view offers. Moving to another view resets the filter,
+ * because the index means something different there -- leaving it at 3 while
+ * landing on a view with two chips would select a chip that is not on screen.
+ */
+export function reduceKey(state, ev, count, filters = 1) {
+    const { input } = ev;
+    if (input === "q")
+        return { ...state, exit: true };
+    if (input === "?")
+        return { ...state, showHelp: !state.showHelp };
+    // Cycle the active view's filter. Wrapping in both directions keeps one key
+    // sufficient on a short list while still allowing a step back on a long one.
+    if (input === "f") {
+        return { ...state, filter: filters > 0 ? (state.filter + 1) % filters : 0 };
+    }
+    if (input === "F") {
+        return { ...state, filter: filters > 0 ? (state.filter - 1 + filters) % filters : 0 };
+    }
+    if (ev.downArrow || input === "j") {
+        return { ...state, index: Math.min(count - 1, state.index + 1), filter: 0 };
+    }
+    if (ev.upArrow || input === "k") {
+        return { ...state, index: Math.max(0, state.index - 1), filter: 0 };
+    }
+    // Number keys jump straight to a view. Bounded by BOTH 9 and the actual
+    // entry count: a nav list shorter than nine must not accept a key that
+    // selects nothing, and one longer than nine must not be reachable past 9.
+    const n = Number.parseInt(input, 10);
+    if (Number.isInteger(n) && n >= 1 && n <= Math.min(9, count)) {
+        return { ...state, index: n - 1, filter: 0 };
+    }
+    return state;
+}
+//# sourceMappingURL=keymap.js.map

package/dist/tui/keymap.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"keymap.js","sourceRoot":"","sources":["../../src/tui/keymap.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAgBH;;;;;;;GAOG;AACH,MAAM,UAAU,SAAS,CACvB,KAAe,EACf,EAAY,EACZ,KAAa,EACb,OAAO,GAAG,CAAC;IAEX,MAAM,EAAE,KAAK,EAAE,GAAG,EAAE,CAAC;IAErB,IAAI,KAAK,KAAK,GAAG;QAAE,OAAO,EAAE,GAAG,KAAK,EAAE,IAAI,EAAE,IAAI,EAAE,CAAC;IACnD,IAAI,KAAK,KAAK,GAAG;QAAE,OAAO,EAAE,GAAG,KAAK,EAAE,QAAQ,EAAE,CAAC,KAAK,CAAC,QAAQ,EAAE,CAAC;IAElE,4EAA4E;IAC5E,6EAA6E;IAC7E,IAAI,KAAK,KAAK,GAAG,EAAE,CAAC;QAClB,OAAO,EAAE,GAAG,KAAK,EAAE,MAAM,EAAE,OAAO,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC,MAAM,GAAG,CAAC,CAAC,GAAG,OAAO,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC;IAC9E,CAAC;IACD,IAAI,KAAK,KAAK,GAAG,EAAE,CAAC;QAClB,OAAO,EAAE,GAAG,KAAK,EAAE,MAAM,EAAE,OAAO,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC,MAAM,GAAG,CAAC,GAAG,OAAO,CAAC,GAAG,OAAO,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC;IACxF,CAAC;IAED,IAAI,EAAE,CAAC,SAAS,IAAI,KAAK,KAAK,GAAG,EAAE,CAAC;QAClC,OAAO,EAAE,GAAG,KAAK,EAAE,KAAK,EAAE,IAAI,CAAC,GAAG,CAAC,KAAK,GAAG,CAAC,EAAE,KAAK,CAAC,KAAK,GAAG,CAAC,CAAC,EAAE,MAAM,EAAE,CAAC,EAAE,CAAC;IAC9E,CAAC;IACD,IAAI,EAAE,CAAC,OAAO,IAAI,KAAK,KAAK,GAAG,EAAE,CAAC;QAChC,OAAO,EAAE,GAAG,KAAK,EAAE,KAAK,EAAE,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,KAAK,CAAC,KAAK,GAAG,CAAC,CAAC,EAAE,MAAM,EAAE,CAAC,EAAE,CAAC;IACtE,CAAC;IAED,wEAAwE;IACxE,uEAAuE;IACvE,0EAA0E;IAC1E,MAAM,CAAC,GAAG,MAAM,CAAC,QAAQ,CAAC,KAAK,EAAE,EAAE,CAAC,CAAC;IACrC,IAAI,MAAM,CAAC,SAAS,CAAC,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC,IAAI,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,KAAK,CAAC,EAAE,CAAC;QAC7D,OAAO,EAAE,GAAG,KAAK,EAAE,KAAK,EAAE,CAAC,GAAG,CAAC,EAAE,MAAM,EAAE,CAAC,EAAE,CAAC;IAC/C,CAAC;IAED,OAAO,KAAK,CAAC;AACf,CAAC"}

package/dist/tui/nav.d.ts

@@ -0,0 +1,29 @@
+/**
+ * Sidebar navigation.
+ *
+ * Mirrors the V2 dashboard's own tree (components/features/layout/hooks/
+ * use-sidebar-data.tsx in checkpoint): Monitor, Analyze, Agents, Projects,
+ * Settings. Same names in the same order, so someone who knows the dashboard
+ * already knows this.
+ *
+ * `source` is the honest part. Views backed by the local ledger have real data
+ * now; views backed by Checkpoint need the /api/v1/cli/monitor read plane,
+ * which does not exist yet, and say so rather than rendering a convincing
+ * empty table.
+ *
+ * @module cli/tui/nav
+ */
+export type ViewSource = "ledger" | "checkpoint";
+export interface NavItem {
+    id: string;
+    title: string;
+    source: ViewSource;
+    /** Indent level: 0 = section, 1 = child. */
+    depth: 0 | 1;
+    /** Section headers are labels, not destinations. */
+    selectable: boolean;
+}
+export declare const NAV: NavItem[];
+export declare const SELECTABLE: NavItem[];
+export declare function navIndexOf(id: string): number;
+//# sourceMappingURL=nav.d.ts.map

package/dist/tui/nav.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"nav.d.ts","sourceRoot":"","sources":["../../src/tui/nav.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;GAcG;AAEH,MAAM,MAAM,UAAU,GAAG,QAAQ,GAAG,YAAY,CAAC;AAEjD,MAAM,WAAW,OAAO;IACtB,EAAE,EAAE,MAAM,CAAC;IACX,KAAK,EAAE,MAAM,CAAC;IACd,MAAM,EAAE,UAAU,CAAC;IACnB,4CAA4C;IAC5C,KAAK,EAAE,CAAC,GAAG,CAAC,CAAC;IACb,oDAAoD;IACpD,UAAU,EAAE,OAAO,CAAC;CACrB;AAED,eAAO,MAAM,GAAG,EAAE,OAAO,EAqBxB,CAAC;AAEF,eAAO,MAAM,UAAU,WAAkC,CAAC;AAE1D,wBAAgB,UAAU,CAAC,EAAE,EAAE,MAAM,GAAG,MAAM,CAE7C"}

package/dist/tui/nav.js

@@ -0,0 +1,39 @@
+/**
+ * Sidebar navigation.
+ *
+ * Mirrors the V2 dashboard's own tree (components/features/layout/hooks/
+ * use-sidebar-data.tsx in checkpoint): Monitor, Analyze, Agents, Projects,
+ * Settings. Same names in the same order, so someone who knows the dashboard
+ * already knows this.
+ *
+ * `source` is the honest part. Views backed by the local ledger have real data
+ * now; views backed by Checkpoint need the /api/v1/cli/monitor read plane,
+ * which does not exist yet, and say so rather than rendering a convincing
+ * empty table.
+ *
+ * @module cli/tui/nav
+ */
+export const NAV = [
+    { id: "monitor", title: "Monitor", source: "checkpoint", depth: 0, selectable: true },
+    { id: "monitor.access", title: "Control access", source: "checkpoint", depth: 1, selectable: true },
+    { id: "analyze", title: "Analyze", source: "checkpoint", depth: 0, selectable: true },
+    { id: "sect.orchestrator", title: "Orchestrator", source: "ledger", depth: 0, selectable: false },
+    { id: "orc.tickets", title: "Tickets", source: "ledger", depth: 1, selectable: true },
+    { id: "orc.dispatches", title: "Dispatches", source: "ledger", depth: 1, selectable: true },
+    { id: "orc.review", title: "Review", source: "ledger", depth: 1, selectable: true },
+    { id: "orc.journal", title: "Journal", source: "ledger", depth: 1, selectable: true },
+    // Real local data now (~/.mcpi/profiles/, review-loop P18), not the
+    // Checkpoint read plane the rest of this file's "checkpoint" entries wait
+    // on -- see tui/views/agents.tsx.
+    { id: "agents", title: "Agents", source: "ledger", depth: 0, selectable: true },
+    { id: "agents.marketplace", title: "Marketplace", source: "checkpoint", depth: 1, selectable: true },
+    { id: "projects", title: "Projects", source: "checkpoint", depth: 0, selectable: true },
+    { id: "settings", title: "Settings", source: "checkpoint", depth: 0, selectable: true },
+    { id: "settings.keys", title: "API keys", source: "checkpoint", depth: 1, selectable: true },
+    { id: "settings.docs", title: "Documentation", source: "checkpoint", depth: 1, selectable: true },
+];
+export const SELECTABLE = NAV.filter((n) => n.selectable);
+export function navIndexOf(id) {
+    return SELECTABLE.findIndex((n) => n.id === id);
+}
+//# sourceMappingURL=nav.js.map

package/dist/tui/nav.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"nav.js","sourceRoot":"","sources":["../../src/tui/nav.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;GAcG;AAcH,MAAM,CAAC,MAAM,GAAG,GAAc;IAC5B,EAAE,EAAE,EAAE,SAAS,EAAE,KAAK,EAAE,SAAS,EAAE,MAAM,EAAE,YAAY,EAAE,KAAK,EAAE,CAAC,EAAE,UAAU,EAAE,IAAI,EAAE;IACrF,EAAE,EAAE,EAAE,gBAAgB,EAAE,KAAK,EAAE,gBAAgB,EAAE,MAAM,EAAE,YAAY,EAAE,KAAK,EAAE,CAAC,EAAE,UAAU,EAAE,IAAI,EAAE;IACnG,EAAE,EAAE,EAAE,SAAS,EAAE,KAAK,EAAE,SAAS,EAAE,MAAM,EAAE,YAAY,EAAE,KAAK,EAAE,CAAC,EAAE,UAAU,EAAE,IAAI,EAAE;IAErF,EAAE,EAAE,EAAE,mBAAmB,EAAE,KAAK,EAAE,cAAc,EAAE,MAAM,EAAE,QAAQ,EAAE,KAAK,EAAE,CAAC,EAAE,UAAU,EAAE,KAAK,EAAE;IACjG,EAAE,EAAE,EAAE,aAAa,EAAE,KAAK,EAAE,SAAS,EAAE,MAAM,EAAE,QAAQ,EAAE,KAAK,EAAE,CAAC,EAAE,UAAU,EAAE,IAAI,EAAE;IACrF,EAAE,EAAE,EAAE,gBAAgB,EAAE,KAAK,EAAE,YAAY,EAAE,MAAM,EAAE,QAAQ,EAAE,KAAK,EAAE,CAAC,EAAE,UAAU,EAAE,IAAI,EAAE;IAC3F,EAAE,EAAE,EAAE,YAAY,EAAE,KAAK,EAAE,QAAQ,EAAE,MAAM,EAAE,QAAQ,EAAE,KAAK,EAAE,CAAC,EAAE,UAAU,EAAE,IAAI,EAAE;IACnF,EAAE,EAAE,EAAE,aAAa,EAAE,KAAK,EAAE,SAAS,EAAE,MAAM,EAAE,QAAQ,EAAE,KAAK,EAAE,CAAC,EAAE,UAAU,EAAE,IAAI,EAAE;IAErF,oEAAoE;IACpE,0EAA0E;IAC1E,kCAAkC;IAClC,EAAE,EAAE,EAAE,QAAQ,EAAE,KAAK,EAAE,QAAQ,EAAE,MAAM,EAAE,QAAQ,EAAE,KAAK,EAAE,CAAC,EAAE,UAAU,EAAE,IAAI,EAAE;IAC/E,EAAE,EAAE,EAAE,oBAAoB,EAAE,KAAK,EAAE,aAAa,EAAE,MAAM,EAAE,YAAY,EAAE,KAAK,EAAE,CAAC,EAAE,UAAU,EAAE,IAAI,EAAE;IACpG,EAAE,EAAE,EAAE,UAAU,EAAE,KAAK,EAAE,UAAU,EAAE,MAAM,EAAE,YAAY,EAAE,KAAK,EAAE,CAAC,EAAE,UAAU,EAAE,IAAI,EAAE;IAEvF,EAAE,EAAE,EAAE,UAAU,EAAE,KAAK,EAAE,UAAU,EAAE,MAAM,EAAE,YAAY,EAAE,KAAK,EAAE,CAAC,EAAE,UAAU,EAAE,IAAI,EAAE;IACvF,EAAE,EAAE,EAAE,eAAe,EAAE,KAAK,EAAE,UAAU,EAAE,MAAM,EAAE,YAAY,EAAE,KAAK,EAAE,CAAC,EAAE,UAAU,EAAE,IAAI,EAAE;IAC5F,EAAE,EAAE,EAAE,eAAe,EAAE,KAAK,EAAE,eAAe,EAAE,MAAM,EAAE,YAAY,EAAE,KAAK,EAAE,CAAC,EAAE,UAAU,EAAE,IAAI,EAAE;CAClG,CAAC;AAEF,MAAM,CAAC,MAAM,UAAU,GAAG,GAAG,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,UAAU,CAAC,CAAC;AAE1D,MAAM,UAAU,UAAU,CAAC,EAAU;IACnC,OAAO,UAAU,CAAC,SAAS,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,EAAE,KAAK,EAAE,CAAC,CAAC;AAClD,CAAC"}

package/dist/tui/sanitize.d.ts

@@ -0,0 +1,25 @@
+/**
+ * Terminal-safety for text that came from somewhere else.
+ *
+ * This lives in its own module, apart from the components that use it, because
+ * `components.tsx` imports ink at module scope and the non-TTY snapshot path
+ * must not. Pulling the sanitizer out of there would load ink eagerly and
+ * defeat the optional-dependency design -- an install that never opens the TUI
+ * would start paying for it, and a missing install would fail on a plain
+ * `kya-os orchestrator tui | cat` instead of printing text.
+ *
+ * @module cli/tui/sanitize
+ */
+/**
+ * Strip terminal control sequences from a remote-authored string.
+ *
+ * Ledger rows carry text this process did not write: ticket titles mirrored
+ * from Linear, agent names, branch and repo names. Both render paths hand
+ * strings to a terminal as-is, so a title containing a screen-clear and a
+ * cursor-home sequence blanks the operator's display, and whatever follows
+ * paints wherever it likes -- enough to forge a credential prompt inside a
+ * console the operator has every reason to trust. Confirmed reachable before
+ * this existed.
+ */
+export declare function plain(value: string): string;
+//# sourceMappingURL=sanitize.d.ts.map

package/dist/tui/sanitize.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"sanitize.d.ts","sourceRoot":"","sources":["../../src/tui/sanitize.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AAEH;;;;;;;;;;GAUG;AACH,wBAAgB,KAAK,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,CAa3C"}

package/dist/tui/sanitize.js

@@ -0,0 +1,36 @@
+/**
+ * Terminal-safety for text that came from somewhere else.
+ *
+ * This lives in its own module, apart from the components that use it, because
+ * `components.tsx` imports ink at module scope and the non-TTY snapshot path
+ * must not. Pulling the sanitizer out of there would load ink eagerly and
+ * defeat the optional-dependency design -- an install that never opens the TUI
+ * would start paying for it, and a missing install would fail on a plain
+ * `kya-os orchestrator tui | cat` instead of printing text.
+ *
+ * @module cli/tui/sanitize
+ */
+/**
+ * Strip terminal control sequences from a remote-authored string.
+ *
+ * Ledger rows carry text this process did not write: ticket titles mirrored
+ * from Linear, agent names, branch and repo names. Both render paths hand
+ * strings to a terminal as-is, so a title containing a screen-clear and a
+ * cursor-home sequence blanks the operator's display, and whatever follows
+ * paints wherever it likes -- enough to forge a credential prompt inside a
+ * console the operator has every reason to trust. Confirmed reachable before
+ * this existed.
+ */
+export function plain(value) {
+    return (value
+        // CSI sequences (colour, cursor movement, screen clear).
+        .replace(/\u001b\[[0-9;?]*[ -\/]*[@-~]/g, "")
+        // OSC sequences (window title, hyperlinks), terminated by BEL or ST.
+        .replace(/\u001b\][^\u0007\u001b]*(?:\u0007|\u001b\\)/g, "")
+        // Any other escape-introduced sequence.
+        .replace(/\u001b./g, "")
+        // Bare control characters: carriage return overwrites the line already
+        // printed, backspace erases it, BEL rings, newline splits one row in two.
+        .replace(/[\u0000-\u001f\u007f-\u009f]/g, ""));
+}
+//# sourceMappingURL=sanitize.js.map

package/dist/tui/sanitize.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"sanitize.js","sourceRoot":"","sources":["../../src/tui/sanitize.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AAEH;;;;;;;;;;GAUG;AACH,MAAM,UAAU,KAAK,CAAC,KAAa;IACjC,OAAO,CACL,KAAK;QACH,yDAAyD;SACxD,OAAO,CAAC,+BAA+B,EAAE,EAAE,CAAC;QAC7C,qEAAqE;SACpE,OAAO,CAAC,8CAA8C,EAAE,EAAE,CAAC;QAC5D,wCAAwC;SACvC,OAAO,CAAC,UAAU,EAAE,EAAE,CAAC;QACxB,uEAAuE;QACvE,0EAA0E;SACzE,OAAO,CAAC,+BAA+B,EAAE,EAAE,CAAC,CAChD,CAAC;AACJ,CAAC"}