ankui 0.1.0

package/dist/tui/components/SectionHeader.js

@@ -0,0 +1,14 @@
+import { jsx as _jsx, jsxs as _jsxs } from "react/jsx-runtime";
+import { Box, Text } from "ink";
+import { SECTION_UNDERLINE } from "../theme/icons.js";
+import { repeat } from "../theme/borders.js";
+/**
+ * Spaces every glyph in the uppercased label so `overview` → `O V E R V I E W`.
+ * Used as the section divider in every screen.
+ */
+export function SectionHeader({ label, underlineWidth = 60 }) {
+    const spaced = Array.from(label.toUpperCase()).join(" ");
+    const rule = repeat(SECTION_UNDERLINE, underlineWidth);
+    return (_jsxs(Box, { flexDirection: "column", children: [_jsx(Text, { bold: true, children: spaced }), _jsx(Text, { dimColor: true, children: rule })] }));
+}
+//# sourceMappingURL=SectionHeader.js.map

package/dist/tui/components/SectionHeader.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"SectionHeader.js","sourceRoot":"","sources":["../../../src/tui/components/SectionHeader.tsx"],"names":[],"mappings":";AACA,OAAO,EAAE,GAAG,EAAE,IAAI,EAAE,MAAM,KAAK,CAAC;AAEhC,OAAO,EAAE,iBAAiB,EAAE,MAAM,mBAAmB,CAAC;AACtD,OAAO,EAAE,MAAM,EAAE,MAAM,qBAAqB,CAAC;AAS7C;;;GAGG;AACH,MAAM,UAAU,aAAa,CAAC,EAC5B,KAAK,EACL,cAAc,GAAG,EAAE,EACA;IACnB,MAAM,MAAM,GAAG,KAAK,CAAC,IAAI,CAAC,KAAK,CAAC,WAAW,EAAE,CAAC,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;IACzD,MAAM,IAAI,GAAG,MAAM,CAAC,iBAAiB,EAAE,cAAc,CAAC,CAAC;IACvD,OAAO,CACL,MAAC,GAAG,IAAC,aAAa,EAAC,QAAQ,aACzB,KAAC,IAAI,IAAC,IAAI,kBAAE,MAAM,GAAQ,EAC1B,KAAC,IAAI,IAAC,QAAQ,kBAAE,IAAI,GAAQ,IACxB,CACP,CAAC;AACJ,CAAC"}

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

@@ -0,0 +1,8 @@
+import React from "react";
+import type { Skill } from "../../types.js";
+export interface SkillViewportProps {
+    skills: ReadonlyArray<Skill>;
+    cursor: number;
+    visibleCount?: number;
+}
+export declare function SkillViewport({ skills, cursor, visibleCount }: SkillViewportProps): React.ReactElement;

package/dist/tui/components/SkillViewport.js

@@ -0,0 +1,42 @@
+import { jsx as _jsx, jsxs as _jsxs } from "react/jsx-runtime";
+import { Box, Text } from "ink";
+import { ACCENT } from "../theme/colors.js";
+import { ACTIVE_PREFIX } from "../theme/icons.js";
+import { groupSkillsByKind } from "../util/skill-grouping.js";
+const DEFAULT_VISIBLE_COUNT = 12;
+const NAME_WIDTH = 44;
+export function SkillViewport({ skills, cursor, visibleCount = DEFAULT_VISIBLE_COUNT }) {
+    const rows = flattenSkills(skills);
+    const safeCursor = clamp(cursor, rows.length);
+    const count = Math.max(1, visibleCount);
+    const start = windowStart(safeCursor, rows.length, count);
+    const visible = rows.slice(start, start + count);
+    const end = start + visible.length;
+    return (_jsxs(Box, { flexDirection: "column", children: [visible.map((row, offset) => {
+                const index = start + offset;
+                return (_jsxs(Box, { children: [_jsx(Text, { color: index === safeCursor ? ACCENT : undefined, children: index === safeCursor ? ACTIVE_PREFIX : " " }), _jsx(Text, { children: ` ${fit(row.skill.name, NAME_WIDTH)} ` }), _jsx(Text, { dimColor: true, children: formatKind(row.kind) })] }, row.skill.id));
+            }), _jsx(Box, { marginTop: 1, children: _jsx(Text, { dimColor: true, children: `${safeCursor + 1}/${rows.length} · showing ${start + 1}-${end} · ↑/↓ scroll` }) })] }));
+}
+function flattenSkills(skills) {
+    return [...groupSkillsByKind(skills).entries()].flatMap(([kind, list]) => list.map((skill) => ({ skill, kind })));
+}
+function windowStart(cursor, total, visibleCount) {
+    if (total <= visibleCount)
+        return 0;
+    const preferred = cursor - Math.floor(visibleCount / 2);
+    return Math.max(0, Math.min(total - visibleCount, preferred));
+}
+function clamp(cursor, total) {
+    if (total <= 0)
+        return 0;
+    return Math.max(0, Math.min(total - 1, cursor));
+}
+function fit(value, width) {
+    if (value.length > width)
+        return `${value.slice(0, width - 3)}...`;
+    return value.padEnd(width, " ");
+}
+function formatKind(kind) {
+    return kind.replaceAll("_", " ");
+}
+//# sourceMappingURL=SkillViewport.js.map

package/dist/tui/components/SkillViewport.js.map

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

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

@@ -0,0 +1,11 @@
+import React from "react";
+export interface SpinnerProps {
+    /**
+     * Current frame index (0..9). Out-of-range values are wrapped via modulo.
+     * Parent owns the interval timer (e.g., setInterval(100ms) → setFrame(f+1)).
+     */
+    frame: number;
+    /** Optional label rendered after the braille glyph, e.g., "Remembering...". */
+    label?: string;
+}
+export declare function Spinner({ frame, label }: SpinnerProps): React.ReactElement;

package/dist/tui/components/Spinner.js

@@ -0,0 +1,13 @@
+import { jsxs as _jsxs } from "react/jsx-runtime";
+import { Text } from "ink";
+import { SPINNER_FRAMES } from "../theme/icons.js";
+export function Spinner({ frame, label }) {
+    const idx = mod(frame, SPINNER_FRAMES.length);
+    const glyph = SPINNER_FRAMES[idx];
+    return (_jsxs(Text, { children: [glyph, label !== undefined ? `   ${label}` : ""] }));
+}
+/** JS `%` is sign-preserving; we want a true modulo for negative frames. */
+function mod(n, m) {
+    return ((n % m) + m) % m;
+}
+//# sourceMappingURL=Spinner.js.map

package/dist/tui/components/Spinner.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"Spinner.js","sourceRoot":"","sources":["../../../src/tui/components/Spinner.tsx"],"names":[],"mappings":";AACA,OAAO,EAAE,IAAI,EAAE,MAAM,KAAK,CAAC;AAE3B,OAAO,EAAE,cAAc,EAAE,MAAM,mBAAmB,CAAC;AAYnD,MAAM,UAAU,OAAO,CAAC,EAAE,KAAK,EAAE,KAAK,EAAgB;IACpD,MAAM,GAAG,GAAG,GAAG,CAAC,KAAK,EAAE,cAAc,CAAC,MAAM,CAAC,CAAC;IAC9C,MAAM,KAAK,GAAG,cAAc,CAAC,GAAG,CAAC,CAAC;IAClC,OAAO,CACL,MAAC,IAAI,eACF,KAAK,EACL,KAAK,KAAK,SAAS,CAAC,CAAC,CAAC,MAAM,KAAK,EAAE,CAAC,CAAC,CAAC,EAAE,IACpC,CACR,CAAC;AACJ,CAAC;AAED,4EAA4E;AAC5E,SAAS,GAAG,CAAC,CAAS,EAAE,CAAS;IAC/B,OAAO,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,GAAG,CAAC,CAAC,GAAG,CAAC,CAAC;AAC3B,CAAC"}

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

@@ -0,0 +1,13 @@
+import React from "react";
+import type { AccessLevel } from "../../types.js";
+export interface StatusPillProps {
+    /** Capability label, e.g., "database". */
+    label: string;
+    /** Access level — drives the color of the pill. */
+    accessLevel: AccessLevel;
+}
+/**
+ * Inline `● label · level` pill. Color comes from `colorForAccessLevel`.
+ * `unknown` renders dim italic per the spec's color palette.
+ */
+export declare function StatusPill({ label, accessLevel }: StatusPillProps): React.ReactElement;

package/dist/tui/components/StatusPill.js

@@ -0,0 +1,15 @@
+import { jsxs as _jsxs } from "react/jsx-runtime";
+import { Text } from "ink";
+import { colorForAccessLevel } from "../theme/colors.js";
+import { DOT_LEADER, STATUS_DOT } from "../theme/icons.js";
+/**
+ * Inline `● label · level` pill. Color comes from `colorForAccessLevel`.
+ * `unknown` renders dim italic per the spec's color palette.
+ */
+export function StatusPill({ label, accessLevel }) {
+    const color = colorForAccessLevel(accessLevel);
+    const dim = accessLevel === "unknown";
+    const italic = accessLevel === "unknown";
+    return (_jsxs(Text, { color: color, dimColor: dim, italic: italic, children: [STATUS_DOT, " ", label, " ", DOT_LEADER, " ", accessLevel] }));
+}
+//# sourceMappingURL=StatusPill.js.map

package/dist/tui/components/StatusPill.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"StatusPill.js","sourceRoot":"","sources":["../../../src/tui/components/StatusPill.tsx"],"names":[],"mappings":";AACA,OAAO,EAAE,IAAI,EAAE,MAAM,KAAK,CAAC;AAG3B,OAAO,EAAE,mBAAmB,EAAE,MAAM,oBAAoB,CAAC;AACzD,OAAO,EAAE,UAAU,EAAE,UAAU,EAAE,MAAM,mBAAmB,CAAC;AAS3D;;;GAGG;AACH,MAAM,UAAU,UAAU,CAAC,EACzB,KAAK,EACL,WAAW,EACK;IAChB,MAAM,KAAK,GAAG,mBAAmB,CAAC,WAAW,CAAC,CAAC;IAC/C,MAAM,GAAG,GAAG,WAAW,KAAK,SAAS,CAAC;IACtC,MAAM,MAAM,GAAG,WAAW,KAAK,SAAS,CAAC;IAEzC,OAAO,CACL,MAAC,IAAI,IAAC,KAAK,EAAE,KAAK,EAAE,QAAQ,EAAE,GAAG,EAAE,MAAM,EAAE,MAAM,aAC9C,UAAU,OAAG,KAAK,OAAG,UAAU,OAAG,WAAW,IACzC,CACR,CAAC;AACJ,CAAC"}

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

@@ -0,0 +1,20 @@
+import React from "react";
+export interface TabItem {
+    id: string;
+    label: string;
+}
+export interface TabBarProps {
+    /**
+     * Up to two rows of tabs. Row 0 = tools row (Overview + each detected
+     * tool). Row 1 = cross-tool views (MCPs, Access, Doctor, Settings).
+     */
+    rows: ReadonlyArray<ReadonlyArray<TabItem>>;
+    /** Which tab id is currently active. */
+    activeId: string;
+}
+/**
+ * Two-row tab bar. Active tab is uppercased and cyan; inactive tabs are
+ * dim + regular case. A second visual line per row renders `━` underneath
+ * the active label so the cursor of focus is unambiguous.
+ */
+export declare function TabBar({ rows, activeId }: TabBarProps): React.ReactElement;

package/dist/tui/components/TabBar.js

@@ -0,0 +1,26 @@
+import { jsx as _jsx, jsxs as _jsxs } from "react/jsx-runtime";
+import { Fragment } from "react";
+import { Box, Text } from "ink";
+import { HEAVY } from "../theme/borders.js";
+import { ACCENT } from "../theme/colors.js";
+const TAB_GAP = "   "; // 3 spaces between tabs
+/**
+ * Two-row tab bar. Active tab is uppercased and cyan; inactive tabs are
+ * dim + regular case. A second visual line per row renders `━` underneath
+ * the active label so the cursor of focus is unambiguous.
+ */
+export function TabBar({ rows, activeId }) {
+    return (_jsx(Box, { flexDirection: "column", children: rows.map((row, rowIndex) => (_jsxs(Fragment, { children: [_jsx(Box, { children: row.map((tab, tabIndex) => {
+                        const isActive = tab.id === activeId;
+                        const displayLabel = isActive ? tab.label.toUpperCase() : tab.label;
+                        return (_jsxs(Fragment, { children: [tabIndex > 0 && _jsx(Text, { children: TAB_GAP }), _jsx(Text, { color: isActive ? ACCENT : undefined, dimColor: !isActive, children: displayLabel })] }, tab.id));
+                    }) }), _jsx(Box, { children: row.map((tab, tabIndex) => {
+                        const isActive = tab.id === activeId;
+                        const displayLabel = isActive ? tab.label.toUpperCase() : tab.label;
+                        const underline = isActive
+                            ? HEAVY.horizontal.repeat(displayLabel.length)
+                            : " ".repeat(displayLabel.length);
+                        return (_jsxs(Fragment, { children: [tabIndex > 0 && _jsx(Text, { children: TAB_GAP }), _jsx(Text, { color: ACCENT, children: underline })] }, `u-${tab.id}`));
+                    }) })] }, `row-${rowIndex}`))) }));
+}
+//# sourceMappingURL=TabBar.js.map

package/dist/tui/components/TabBar.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"TabBar.js","sourceRoot":"","sources":["../../../src/tui/components/TabBar.tsx"],"names":[],"mappings":";AAAA,OAAc,EAAE,QAAQ,EAAE,MAAM,OAAO,CAAC;AACxC,OAAO,EAAE,GAAG,EAAE,IAAI,EAAE,MAAM,KAAK,CAAC;AAEhC,OAAO,EAAE,KAAK,EAAE,MAAM,qBAAqB,CAAC;AAC5C,OAAO,EAAE,MAAM,EAAE,MAAM,oBAAoB,CAAC;AAiB5C,MAAM,OAAO,GAAG,KAAK,CAAC,CAAC,wBAAwB;AAE/C;;;;GAIG;AACH,MAAM,UAAU,MAAM,CAAC,EAAE,IAAI,EAAE,QAAQ,EAAe;IACpD,OAAO,CACL,KAAC,GAAG,IAAC,aAAa,EAAC,QAAQ,YACxB,IAAI,CAAC,GAAG,CAAC,CAAC,GAAG,EAAE,QAAQ,EAAE,EAAE,CAAC,CAC3B,MAAC,QAAQ,eACP,KAAC,GAAG,cACD,GAAG,CAAC,GAAG,CAAC,CAAC,GAAG,EAAE,QAAQ,EAAE,EAAE;wBACzB,MAAM,QAAQ,GAAG,GAAG,CAAC,EAAE,KAAK,QAAQ,CAAC;wBACrC,MAAM,YAAY,GAAG,QAAQ,CAAC,CAAC,CAAC,GAAG,CAAC,KAAK,CAAC,WAAW,EAAE,CAAC,CAAC,CAAC,GAAG,CAAC,KAAK,CAAC;wBACpE,OAAO,CACL,MAAC,QAAQ,eACN,QAAQ,GAAG,CAAC,IAAI,KAAC,IAAI,cAAE,OAAO,GAAQ,EACvC,KAAC,IAAI,IAAC,KAAK,EAAE,QAAQ,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,SAAS,EAAE,QAAQ,EAAE,CAAC,QAAQ,YAC5D,YAAY,GACR,KAJM,GAAG,CAAC,EAAE,CAKV,CACZ,CAAC;oBACJ,CAAC,CAAC,GACE,EACN,KAAC,GAAG,cACD,GAAG,CAAC,GAAG,CAAC,CAAC,GAAG,EAAE,QAAQ,EAAE,EAAE;wBACzB,MAAM,QAAQ,GAAG,GAAG,CAAC,EAAE,KAAK,QAAQ,CAAC;wBACrC,MAAM,YAAY,GAAG,QAAQ,CAAC,CAAC,CAAC,GAAG,CAAC,KAAK,CAAC,WAAW,EAAE,CAAC,CAAC,CAAC,GAAG,CAAC,KAAK,CAAC;wBACpE,MAAM,SAAS,GAAG,QAAQ;4BACxB,CAAC,CAAC,KAAK,CAAC,UAAU,CAAC,MAAM,CAAC,YAAY,CAAC,MAAM,CAAC;4BAC9C,CAAC,CAAC,GAAG,CAAC,MAAM,CAAC,YAAY,CAAC,MAAM,CAAC,CAAC;wBACpC,OAAO,CACL,MAAC,QAAQ,eACN,QAAQ,GAAG,CAAC,IAAI,KAAC,IAAI,cAAE,OAAO,GAAQ,EACvC,KAAC,IAAI,IAAC,KAAK,EAAE,MAAM,YAAG,SAAS,GAAQ,KAF1B,KAAK,GAAG,CAAC,EAAE,EAAE,CAGjB,CACZ,CAAC;oBACJ,CAAC,CAAC,GACE,KA7BO,OAAO,QAAQ,EAAE,CA8BrB,CACZ,CAAC,GACE,CACP,CAAC;AACJ,CAAC"}

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

@@ -0,0 +1,13 @@
+import React from "react";
+export interface TextInputProps {
+    value: string;
+    onChange: (next: string) => void;
+    onSubmit: (value: string) => void;
+    placeholder?: string;
+}
+/**
+ * Minimal one-line text input. Captures printable characters, backspace,
+ * and return. Arrow keys are ignored so the parent can keep them for
+ * selection. The cursor is a trailing `▌` when the buffer has focus.
+ */
+export declare function TextInput({ value, onChange, onSubmit, placeholder }: TextInputProps): React.ReactElement;

package/dist/tui/components/TextInput.js

@@ -0,0 +1,34 @@
+import { jsx as _jsx, jsxs as _jsxs } from "react/jsx-runtime";
+import { Text, useInput } from "ink";
+/**
+ * Minimal one-line text input. Captures printable characters, backspace,
+ * and return. Arrow keys are ignored so the parent can keep them for
+ * selection. The cursor is a trailing `▌` when the buffer has focus.
+ */
+export function TextInput({ value, onChange, onSubmit, placeholder }) {
+    useInput((input, key) => {
+        if (key.return) {
+            onSubmit(value);
+            return;
+        }
+        if (key.backspace || key.delete) {
+            if (value.length > 0)
+                onChange(value.slice(0, -1));
+            return;
+        }
+        if (key.upArrow || key.downArrow || key.leftArrow || key.rightArrow) {
+            return; // reserved for parent
+        }
+        if (key.tab || key.escape || key.ctrl || key.meta) {
+            return; // reserved for parent
+        }
+        // Treat any other input as printable. Ink delivers paste/multichar in one
+        // call, so concatenate the whole `input` string.
+        if (input && input.length > 0) {
+            onChange(value + input);
+        }
+    });
+    const displayValue = value.length === 0 ? placeholder ?? "" : value;
+    return (_jsxs(Text, { children: [value.length === 0 ? _jsx(Text, { dimColor: true, children: displayValue }) : _jsx(Text, { children: displayValue }), _jsx(Text, { color: "cyan", children: "\u258C" })] }));
+}
+//# sourceMappingURL=TextInput.js.map

package/dist/tui/components/TextInput.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"TextInput.js","sourceRoot":"","sources":["../../../src/tui/components/TextInput.tsx"],"names":[],"mappings":";AACA,OAAO,EAAE,IAAI,EAAE,QAAQ,EAAE,MAAM,KAAK,CAAC;AASrC;;;;GAIG;AACH,MAAM,UAAU,SAAS,CAAC,EACxB,KAAK,EACL,QAAQ,EACR,QAAQ,EACR,WAAW,EACI;IACf,QAAQ,CAAC,CAAC,KAAK,EAAE,GAAG,EAAE,EAAE;QACtB,IAAI,GAAG,CAAC,MAAM,EAAE,CAAC;YACf,QAAQ,CAAC,KAAK,CAAC,CAAC;YAChB,OAAO;QACT,CAAC;QACD,IAAI,GAAG,CAAC,SAAS,IAAI,GAAG,CAAC,MAAM,EAAE,CAAC;YAChC,IAAI,KAAK,CAAC,MAAM,GAAG,CAAC;gBAAE,QAAQ,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC,CAAC;YACnD,OAAO;QACT,CAAC;QACD,IAAI,GAAG,CAAC,OAAO,IAAI,GAAG,CAAC,SAAS,IAAI,GAAG,CAAC,SAAS,IAAI,GAAG,CAAC,UAAU,EAAE,CAAC;YACpE,OAAO,CAAC,sBAAsB;QAChC,CAAC;QACD,IAAI,GAAG,CAAC,GAAG,IAAI,GAAG,CAAC,MAAM,IAAI,GAAG,CAAC,IAAI,IAAI,GAAG,CAAC,IAAI,EAAE,CAAC;YAClD,OAAO,CAAC,sBAAsB;QAChC,CAAC;QACD,0EAA0E;QAC1E,iDAAiD;QACjD,IAAI,KAAK,IAAI,KAAK,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;YAC9B,QAAQ,CAAC,KAAK,GAAG,KAAK,CAAC,CAAC;QAC1B,CAAC;IACH,CAAC,CAAC,CAAC;IAEH,MAAM,YAAY,GAAG,KAAK,CAAC,MAAM,KAAK,CAAC,CAAC,CAAC,CAAC,WAAW,IAAI,EAAE,CAAC,CAAC,CAAC,KAAK,CAAC;IACpE,OAAO,CACL,MAAC,IAAI,eACF,KAAK,CAAC,MAAM,KAAK,CAAC,CAAC,CAAC,CAAC,KAAC,IAAI,IAAC,QAAQ,kBAAE,YAAY,GAAQ,CAAC,CAAC,CAAC,KAAC,IAAI,cAAE,YAAY,GAAQ,EACxF,KAAC,IAAI,IAAC,KAAK,EAAC,MAAM,uBAAS,IACtB,CACR,CAAC;AACJ,CAAC"}

package/dist/tui/hooks/use-idle-whisper.d.ts

@@ -0,0 +1,17 @@
+export interface UseIdleWhisperOptions {
+    enabled: boolean;
+    /** ms of inactivity before a roll is attempted. Default 30_000. */
+    idleMs?: number;
+    /** ms the whisper stays on screen once shown. Default 5_000. */
+    lingerMs?: number;
+    /** probability [0..1] that an idle tick produces a whisper. Default 0.05. */
+    chance?: number;
+    /** injectable for tests. Default Math.random. */
+    random?: () => number;
+}
+export interface UseIdleWhisperResult {
+    whisper: string | null;
+    /** Call from a parent key handler to reset idle timer. */
+    bump: () => void;
+}
+export declare function useIdleWhisper(opts: UseIdleWhisperOptions): UseIdleWhisperResult;

package/dist/tui/hooks/use-idle-whisper.js

@@ -0,0 +1,66 @@
+import { useCallback, useEffect, useRef, useState } from "react";
+import { pickRandomWhisper } from "../messages.js";
+export function useIdleWhisper(opts) {
+    const idleMs = opts.idleMs ?? 30_000;
+    const lingerMs = opts.lingerMs ?? 5_000;
+    const chance = opts.chance ?? 0.05;
+    const random = opts.random ?? Math.random;
+    const [whisper, setWhisper] = useState(null);
+    const whisperRef = useRef(null);
+    const lastBumpRef = useRef(Date.now());
+    const clearTimeoutIdRef = useRef(null);
+    const bump = useCallback(() => {
+        lastBumpRef.current = Date.now();
+        if (clearTimeoutIdRef.current !== null) {
+            clearTimeout(clearTimeoutIdRef.current);
+            clearTimeoutIdRef.current = null;
+        }
+        whisperRef.current = null;
+        setWhisper(null);
+    }, []);
+    useEffect(() => {
+        if (!opts.enabled) {
+            whisperRef.current = null;
+            setWhisper(null);
+            return;
+        }
+        // Use a short tick that respects idleMs; in tests idleMs is small so this
+        // converges quickly. In production idleMs=30s; we tick every idleMs.
+        const tickMs = Math.max(5, Math.min(idleMs, 1_000));
+        const id = setInterval(() => {
+            const now = Date.now();
+            const elapsed = now - lastBumpRef.current;
+            if (elapsed < idleMs)
+                return;
+            // Idle threshold passed. Roll the dice — but only if no whisper is
+            // currently displayed (avoid stacking).
+            if (whisperRef.current !== null)
+                return;
+            if (random() >= chance) {
+                // Missed roll — push the next attempt one full idle window out so we
+                // don't spam every tick.
+                lastBumpRef.current = now;
+                return;
+            }
+            const pick = pickRandomWhisper(random);
+            whisperRef.current = pick;
+            setWhisper(pick);
+            clearTimeoutIdRef.current = setTimeout(() => {
+                whisperRef.current = null;
+                setWhisper(null);
+                // Reset idle clock so the next whisper waits a full idle window.
+                lastBumpRef.current = Date.now();
+                clearTimeoutIdRef.current = null;
+            }, lingerMs);
+        }, tickMs);
+        return () => {
+            clearInterval(id);
+            if (clearTimeoutIdRef.current !== null) {
+                clearTimeout(clearTimeoutIdRef.current);
+                clearTimeoutIdRef.current = null;
+            }
+        };
+    }, [opts.enabled, idleMs, lingerMs, chance, random]);
+    return { whisper, bump };
+}
+//# sourceMappingURL=use-idle-whisper.js.map

package/dist/tui/hooks/use-idle-whisper.js.map

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

package/dist/tui/hooks/use-rotating-message.d.ts

@@ -0,0 +1,20 @@
+export interface UseRotatingMessageOptions {
+    /** When false, hook holds at index 0 ("Remembering..."). */
+    active: boolean;
+    /** Rotation interval in ms. Default 2500. */
+    intervalMs?: number;
+    /** Injectable randomness for tests. Default Math.random. */
+    random?: () => number;
+}
+export interface UseRotatingMessageResult {
+    message: string;
+    index: number;
+}
+/**
+ * Rotates through REMEMBER_MESSAGES:
+ *   - index 0 ("Remembering...") always shown first
+ *   - index 1 ("Anghkooey.") always shown second
+ *   - indices 2..N shuffled deterministically once per active-cycle
+ * Caller toggles `active` to start/stop rotation.
+ */
+export declare function useRotatingMessage(opts: UseRotatingMessageOptions): UseRotatingMessageResult;

package/dist/tui/hooks/use-rotating-message.js

@@ -0,0 +1,34 @@
+import { useEffect, useMemo, useState } from "react";
+import { REMEMBER_MESSAGES, shuffleRemainder } from "../messages.js";
+/**
+ * Rotates through REMEMBER_MESSAGES:
+ *   - index 0 ("Remembering...") always shown first
+ *   - index 1 ("Anghkooey.") always shown second
+ *   - indices 2..N shuffled deterministically once per active-cycle
+ * Caller toggles `active` to start/stop rotation.
+ */
+export function useRotatingMessage(opts) {
+    const intervalMs = opts.intervalMs ?? 2500;
+    const random = opts.random ?? Math.random;
+    // Build the rotation order once per `active` flip, so a single scan
+    // session sees a stable sequence (no re-shuffles per render).
+    const sequence = useMemo(() => shuffleRemainder(REMEMBER_MESSAGES, 2, random), 
+    // eslint-disable-next-line react-hooks/exhaustive-deps
+    [opts.active]);
+    const [index, setIndex] = useState(0);
+    useEffect(() => {
+        if (!opts.active) {
+            setIndex(0);
+            return;
+        }
+        const id = setInterval(() => {
+            setIndex((prev) => (prev + 1) % sequence.length);
+        }, intervalMs);
+        return () => {
+            clearInterval(id);
+        };
+    }, [opts.active, intervalMs, sequence.length]);
+    const message = sequence[index] ?? REMEMBER_MESSAGES[0];
+    return { message, index };
+}
+//# sourceMappingURL=use-rotating-message.js.map

package/dist/tui/hooks/use-rotating-message.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"use-rotating-message.js","sourceRoot":"","sources":["../../../src/tui/hooks/use-rotating-message.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAE,OAAO,EAAE,QAAQ,EAAE,MAAM,OAAO,CAAC;AAErD,OAAO,EAAE,iBAAiB,EAAE,gBAAgB,EAAE,MAAM,gBAAgB,CAAC;AAgBrE;;;;;;GAMG;AACH,MAAM,UAAU,kBAAkB,CAChC,IAA+B;IAE/B,MAAM,UAAU,GAAG,IAAI,CAAC,UAAU,IAAI,IAAI,CAAC;IAC3C,MAAM,MAAM,GAAG,IAAI,CAAC,MAAM,IAAI,IAAI,CAAC,MAAM,CAAC;IAE1C,oEAAoE;IACpE,8DAA8D;IAC9D,MAAM,QAAQ,GAAG,OAAO,CACtB,GAAG,EAAE,CAAC,gBAAgB,CAAC,iBAAiB,EAAE,CAAC,EAAE,MAAM,CAAC;IACpD,uDAAuD;IACvD,CAAC,IAAI,CAAC,MAAM,CAAC,CACd,CAAC;IAEF,MAAM,CAAC,KAAK,EAAE,QAAQ,CAAC,GAAG,QAAQ,CAAC,CAAC,CAAC,CAAC;IAEtC,SAAS,CAAC,GAAG,EAAE;QACb,IAAI,CAAC,IAAI,CAAC,MAAM,EAAE,CAAC;YACjB,QAAQ,CAAC,CAAC,CAAC,CAAC;YACZ,OAAO;QACT,CAAC;QACD,MAAM,EAAE,GAAG,WAAW,CAAC,GAAG,EAAE;YAC1B,QAAQ,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,CAAC,IAAI,GAAG,CAAC,CAAC,GAAG,QAAQ,CAAC,MAAM,CAAC,CAAC;QACnD,CAAC,EAAE,UAAU,CAAC,CAAC;QACf,OAAO,GAAG,EAAE;YACV,aAAa,CAAC,EAAE,CAAC,CAAC;QACpB,CAAC,CAAC;IACJ,CAAC,EAAE,CAAC,IAAI,CAAC,MAAM,EAAE,UAAU,EAAE,QAAQ,CAAC,MAAM,CAAC,CAAC,CAAC;IAE/C,MAAM,OAAO,GAAG,QAAQ,CAAC,KAAK,CAAC,IAAI,iBAAiB,CAAC,CAAC,CAAC,CAAC;IACxD,OAAO,EAAE,OAAO,EAAE,KAAK,EAAE,CAAC;AAC5B,CAAC"}

package/dist/tui/input/use-keys.d.ts

@@ -0,0 +1,16 @@
+export interface KeyHandlers {
+    onArrowUp?: () => void;
+    onArrowDown?: () => void;
+    onArrowLeft?: () => void;
+    onArrowRight?: () => void;
+    onEnter?: () => void;
+    onEscape?: () => void;
+    onQuit?: () => void;
+    onRefresh?: () => void;
+    onSlash?: () => void;
+    /** Receives any printable character not otherwise handled. */
+    onTextInput?: (ch: string) => void;
+    /** Receives a backspace event. */
+    onBackspace?: () => void;
+}
+export declare function useKeys(handlers: KeyHandlers): void;

package/dist/tui/input/use-keys.js

@@ -0,0 +1,32 @@
+import { useInput } from "ink";
+export function useKeys(handlers) {
+    useInput((input, key) => {
+        // Reserved for future focus navigation; tab does not cycle app tabs.
+        if (key.tab)
+            return;
+        if (key.upArrow)
+            return handlers.onArrowUp?.();
+        if (key.downArrow)
+            return handlers.onArrowDown?.();
+        if (key.leftArrow)
+            return handlers.onArrowLeft?.();
+        if (key.rightArrow)
+            return handlers.onArrowRight?.();
+        if (key.return)
+            return handlers.onEnter?.();
+        if (key.escape)
+            return handlers.onEscape?.();
+        if (key.backspace || key.delete)
+            return handlers.onBackspace?.();
+        if (input === "/")
+            return handlers.onSlash?.();
+        if (input === "q")
+            return handlers.onQuit?.();
+        if (input === "r")
+            return handlers.onRefresh?.();
+        if (input && input.length === 1 && input >= " " && input !== "/") {
+            handlers.onTextInput?.(input);
+        }
+    });
+}
+//# sourceMappingURL=use-keys.js.map

package/dist/tui/input/use-keys.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"use-keys.js","sourceRoot":"","sources":["../../../src/tui/input/use-keys.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,MAAM,KAAK,CAAC;AAkB/B,MAAM,UAAU,OAAO,CAAC,QAAqB;IAC3C,QAAQ,CAAC,CAAC,KAAK,EAAE,GAAG,EAAE,EAAE;QACtB,qEAAqE;QACrE,IAAI,GAAG,CAAC,GAAG;YAAE,OAAO;QACpB,IAAI,GAAG,CAAC,OAAO;YAAE,OAAO,QAAQ,CAAC,SAAS,EAAE,EAAE,CAAC;QAC/C,IAAI,GAAG,CAAC,SAAS;YAAE,OAAO,QAAQ,CAAC,WAAW,EAAE,EAAE,CAAC;QACnD,IAAI,GAAG,CAAC,SAAS;YAAE,OAAO,QAAQ,CAAC,WAAW,EAAE,EAAE,CAAC;QACnD,IAAI,GAAG,CAAC,UAAU;YAAE,OAAO,QAAQ,CAAC,YAAY,EAAE,EAAE,CAAC;QACrD,IAAI,GAAG,CAAC,MAAM;YAAE,OAAO,QAAQ,CAAC,OAAO,EAAE,EAAE,CAAC;QAC5C,IAAI,GAAG,CAAC,MAAM;YAAE,OAAO,QAAQ,CAAC,QAAQ,EAAE,EAAE,CAAC;QAC7C,IAAI,GAAG,CAAC,SAAS,IAAI,GAAG,CAAC,MAAM;YAAE,OAAO,QAAQ,CAAC,WAAW,EAAE,EAAE,CAAC;QACjE,IAAI,KAAK,KAAK,GAAG;YAAE,OAAO,QAAQ,CAAC,OAAO,EAAE,EAAE,CAAC;QAC/C,IAAI,KAAK,KAAK,GAAG;YAAE,OAAO,QAAQ,CAAC,MAAM,EAAE,EAAE,CAAC;QAC9C,IAAI,KAAK,KAAK,GAAG;YAAE,OAAO,QAAQ,CAAC,SAAS,EAAE,EAAE,CAAC;QACjD,IAAI,KAAK,IAAI,KAAK,CAAC,MAAM,KAAK,CAAC,IAAI,KAAK,IAAI,GAAG,IAAI,KAAK,KAAK,GAAG,EAAE,CAAC;YACjE,QAAQ,CAAC,WAAW,EAAE,CAAC,KAAK,CAAC,CAAC;QAChC,CAAC;IACH,CAAC,CAAC,CAAC;AACL,CAAC"}

package/dist/tui/messages.d.ts

@@ -0,0 +1,18 @@
+export declare const REMEMBER_MESSAGES: ReadonlyArray<string>;
+export declare const SCAN_COMPLETE = "Remembered.";
+export declare const EMPTY_STATE_WHISPERS: {
+    readonly noFindings: "the talismans are holding.";
+    readonly noMcps: "no servers configured. you haven't asked for help yet.";
+    readonly noWarnings: "quiet tonight.";
+    readonly noProjectSkills: "nothing left here to remember.";
+};
+export type EmptyStateWhisperKey = keyof typeof EMPTY_STATE_WHISPERS;
+export declare const IDLE_WHISPERS: ReadonlyArray<string>;
+/**
+ * Returns a new array: first `keepLeading` items in their original positions,
+ * remaining items shuffled (Fisher-Yates). `random` defaults to Math.random and
+ * can be injected for deterministic tests.
+ */
+export declare function shuffleRemainder<T>(items: ReadonlyArray<T>, keepLeading: number, random?: () => number): T[];
+/** Picks a uniformly random idle whisper. `random` injectable for tests. */
+export declare function pickRandomWhisper(random?: () => number): string;

package/dist/tui/messages.js

@@ -0,0 +1,59 @@
+export const REMEMBER_MESSAGES = [
+    "Remembering...",
+    "Anghkooey.",
+    "The village remembers every agent you've configured.",
+    "Searching for what you left behind...",
+    "Some skills haven't slept in a long time.",
+    "Counting the things in your filesystem that don't want to be forgotten.",
+    "Whispering 'anghkooey' to your home directory...",
+    "Reading the symbols carved into .claude/...",
+    "We never really leave a project. The configs stay.",
+    "Marking every door you've opened to an AI.",
+    "Listening for what your filesystem won't say out loud.",
+    "Some MCPs come out only at night. We're awake.",
+    "What you saved, what you forgot, what's still watching.",
+    "Following the children's chant.",
+    "Your past sessions are humming a tune somewhere.",
+    "The lighthouse is on. We're still here.",
+    "Some doors should stay closed. We're just counting them.",
+    "Boyd would want a perimeter check.",
+    "Tabitha drew this once. We're tracing it again.",
+    "anghkooey · anghkooey · anghkooey"
+];
+export const SCAN_COMPLETE = "Remembered.";
+export const EMPTY_STATE_WHISPERS = {
+    noFindings: "the talismans are holding.",
+    noMcps: "no servers configured. you haven't asked for help yet.",
+    noWarnings: "quiet tonight.",
+    noProjectSkills: "nothing left here to remember."
+};
+export const IDLE_WHISPERS = [
+    "every scan is another lap.",
+    "anghkooey.",
+    "the village remembers.",
+    "remember, remember.",
+    "what you saved is still watching.",
+    "the lighthouse is on.",
+    "we never really leave a project."
+];
+/**
+ * Returns a new array: first `keepLeading` items in their original positions,
+ * remaining items shuffled (Fisher-Yates). `random` defaults to Math.random and
+ * can be injected for deterministic tests.
+ */
+export function shuffleRemainder(items, keepLeading, random = Math.random) {
+    const out = [...items];
+    for (let i = out.length - 1; i > keepLeading; i--) {
+        const j = keepLeading + Math.floor(random() * (i - keepLeading + 1));
+        const tmp = out[i];
+        out[i] = out[j];
+        out[j] = tmp;
+    }
+    return out;
+}
+/** Picks a uniformly random idle whisper. `random` injectable for tests. */
+export function pickRandomWhisper(random = Math.random) {
+    const idx = Math.floor(random() * IDLE_WHISPERS.length);
+    return IDLE_WHISPERS[Math.min(idx, IDLE_WHISPERS.length - 1)];
+}
+//# sourceMappingURL=messages.js.map

package/dist/tui/messages.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"messages.js","sourceRoot":"","sources":["../../src/tui/messages.ts"],"names":[],"mappings":"AAAA,MAAM,CAAC,MAAM,iBAAiB,GAA0B;IACtD,gBAAgB;IAChB,YAAY;IACZ,sDAAsD;IACtD,uCAAuC;IACvC,2CAA2C;IAC3C,yEAAyE;IACzE,kDAAkD;IAClD,6CAA6C;IAC7C,oDAAoD;IACpD,4CAA4C;IAC5C,wDAAwD;IACxD,gDAAgD;IAChD,yDAAyD;IACzD,iCAAiC;IACjC,kDAAkD;IAClD,yCAAyC;IACzC,0DAA0D;IAC1D,oCAAoC;IACpC,iDAAiD;IACjD,mCAAmC;CACpC,CAAC;AAEF,MAAM,CAAC,MAAM,aAAa,GAAG,aAAa,CAAC;AAE3C,MAAM,CAAC,MAAM,oBAAoB,GAAG;IAClC,UAAU,EAAE,4BAA4B;IACxC,MAAM,EAAE,wDAAwD;IAChE,UAAU,EAAE,gBAAgB;IAC5B,eAAe,EAAE,gCAAgC;CACzC,CAAC;AAIX,MAAM,CAAC,MAAM,aAAa,GAA0B;IAClD,4BAA4B;IAC5B,YAAY;IACZ,wBAAwB;IACxB,qBAAqB;IACrB,mCAAmC;IACnC,uBAAuB;IACvB,kCAAkC;CACnC,CAAC;AAEF;;;;GAIG;AACH,MAAM,UAAU,gBAAgB,CAC9B,KAAuB,EACvB,WAAmB,EACnB,SAAuB,IAAI,CAAC,MAAM;IAElC,MAAM,GAAG,GAAG,CAAC,GAAG,KAAK,CAAC,CAAC;IACvB,KAAK,IAAI,CAAC,GAAG,GAAG,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC,GAAG,WAAW,EAAE,CAAC,EAAE,EAAE,CAAC;QAClD,MAAM,CAAC,GAAG,WAAW,GAAG,IAAI,CAAC,KAAK,CAAC,MAAM,EAAE,GAAG,CAAC,CAAC,GAAG,WAAW,GAAG,CAAC,CAAC,CAAC,CAAC;QACrE,MAAM,GAAG,GAAG,GAAG,CAAC,CAAC,CAAC,CAAC;QACnB,GAAG,CAAC,CAAC,CAAC,GAAG,GAAG,CAAC,CAAC,CAAC,CAAC;QAChB,GAAG,CAAC,CAAC,CAAC,GAAG,GAAG,CAAC;IACf,CAAC;IACD,OAAO,GAAG,CAAC;AACb,CAAC;AAED,4EAA4E;AAC5E,MAAM,UAAU,iBAAiB,CAAC,SAAuB,IAAI,CAAC,MAAM;IAClE,MAAM,GAAG,GAAG,IAAI,CAAC,KAAK,CAAC,MAAM,EAAE,GAAG,aAAa,CAAC,MAAM,CAAC,CAAC;IACxD,OAAO,aAAa,CAAC,IAAI,CAAC,GAAG,CAAC,GAAG,EAAE,aAAa,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC,CAAC;AAChE,CAAC"}

package/dist/tui/render.d.ts

@@ -0,0 +1,12 @@
+import type { MultiProjectScanResult } from "../types.js";
+import { type DataSource } from "./App.js";
+export interface RenderTuiLoadScanOptions {
+    /** Function that resolves with the scan result. Called once on mount. */
+    loadScan: () => Promise<MultiProjectScanResult>;
+}
+export interface RenderTuiFirstRunOptions {
+    mode: "firstRun";
+    homeDir: string;
+    onConfigChange: (devRoots: string[]) => Promise<void>;
+}
+export declare function renderTui(input: RenderTuiLoadScanOptions | RenderTuiFirstRunOptions | MultiProjectScanResult | DataSource): Promise<void>;