ownkey 1.2.0 → 1.4.0

package/dist/ui/App.js.map

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

package/dist/ui/Keeper.d.ts

@@ -0,0 +1,18 @@
+import { type KeeperMood, type KeeperSize } from './keeper.js';
+/** Terminal width and height, kept current as the window is resized. */
+export declare function useTerminalSize(): {
+    columns: number;
+    rows: number;
+};
+/** A tick counter at Keeper's frame rate, or a still 0 where motion is off. */
+export declare function useKeeperTick(active?: boolean): number;
+export interface KeeperProps {
+    mood?: KeeperMood;
+    /** Force a size; by default it follows the terminal width */
+    size?: KeeperSize;
+    /** Stop animating (for example once a prompt is submitted), keeping the last frame */
+    still?: boolean;
+}
+/** Keeper as an Ink element: moves with its mood, resizes with the terminal. */
+export declare function Keeper({ mood, size, still }: KeeperProps): import("react").JSX.Element | null;
+//# sourceMappingURL=Keeper.d.ts.map

package/dist/ui/Keeper.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"Keeper.d.ts","sourceRoot":"","sources":["../../src/ui/Keeper.tsx"],"names":[],"mappings":"AAEA,OAAO,EAQH,KAAK,UAAU,EACf,KAAK,UAAU,EAClB,MAAM,aAAa,CAAC;AAErB,wEAAwE;AACxE,wBAAgB,eAAe,IAAI;IAAE,OAAO,EAAE,MAAM,CAAC;IAAC,IAAI,EAAE,MAAM,CAAA;CAAE,CAanE;AAED,+EAA+E;AAC/E,wBAAgB,aAAa,CAAC,MAAM,UAAO,GAAG,MAAM,CAUnD;AAED,MAAM,WAAW,WAAW;IACxB,IAAI,CAAC,EAAE,UAAU,CAAC;IAClB,6DAA6D;IAC7D,IAAI,CAAC,EAAE,UAAU,CAAC;IAClB,sFAAsF;IACtF,KAAK,CAAC,EAAE,OAAO,CAAC;CACnB;AAED,gFAAgF;AAChF,wBAAgB,MAAM,CAAC,EAAE,IAAa,EAAE,IAAI,EAAE,KAAa,EAAE,EAAE,WAAW,sCA+BzE"}

package/dist/ui/Keeper.js

@@ -0,0 +1,45 @@
+import { jsx as _jsx } from "react/jsx-runtime";
+import { useEffect, useState } from 'react';
+import { Box, Text, useStdout } from 'ink';
+import { KEEPER_FPS, KEEPER_ORANGE, keeperAnimates, keeperFrame, keeperSegments, keeperShown, keeperSize, } from './keeper.js';
+/** Terminal width and height, kept current as the window is resized. */
+export function useTerminalSize() {
+    const { stdout } = useStdout();
+    const read = () => ({ columns: stdout?.columns || 80, rows: stdout?.rows || 24 });
+    const [size, setSize] = useState(read);
+    useEffect(() => {
+        if (!stdout)
+            return;
+        const onResize = () => setSize(read());
+        stdout.on('resize', onResize);
+        return () => {
+            stdout.off('resize', onResize);
+        };
+    }, [stdout]);
+    return size;
+}
+/** A tick counter at Keeper's frame rate, or a still 0 where motion is off. */
+export function useKeeperTick(active = true) {
+    const { stdout } = useStdout();
+    const [tick, setTick] = useState(0);
+    const moving = active && keeperAnimates(stdout ?? process.stdout);
+    useEffect(() => {
+        if (!moving)
+            return;
+        const id = setInterval(() => setTick((t) => t + 1), 1000 / KEEPER_FPS);
+        return () => clearInterval(id);
+    }, [moving]);
+    return tick;
+}
+/** Keeper as an Ink element: moves with its mood, resizes with the terminal. */
+export function Keeper({ mood = 'idle', size, still = false }) {
+    const { columns, rows } = useTerminalSize();
+    const tick = useKeeperTick(!still);
+    if (!keeperShown())
+        return null;
+    const lines = keeperFrame(mood, size ?? keeperSize(columns, rows), tick);
+    if (!lines.length)
+        return null;
+    return (_jsx(Box, { flexDirection: "column", flexShrink: 0, children: lines.map((line, i) => (_jsx(Text, { children: keeperSegments(line).map((seg, j) => seg.part === 'body' ? (_jsx(Text, { color: KEEPER_ORANGE, children: seg.text }, j)) : seg.part === 'eye' ? (_jsx(Text, { bold: true, children: seg.text }, j)) : seg.part === 'mark' ? (_jsx(Text, { color: "red", bold: true, children: seg.text }, j)) : (_jsx(Text, { children: seg.text }, j))) }, i))) }));
+}
+//# sourceMappingURL=Keeper.js.map

package/dist/ui/Keeper.js.map

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

package/dist/ui/complete.d.ts

@@ -0,0 +1,22 @@
+export interface CommandInfo {
+    name: string;
+    description: string;
+    options: Array<{
+        flags: string;
+        description: string;
+    }>;
+}
+export interface Suggestion {
+    /** What Tab inserts for the current word */
+    value: string;
+    label: string;
+    description: string;
+}
+export declare const BUILTINS: CommandInfo[];
+/** Long flag of a commander flags string, e.g. "-y, --yes" -> "--yes", "--case <ids>" -> "--case". */
+export declare function longFlag(flags: string): string;
+/** Suggestions for the word being typed at the end of `line`. */
+export declare function suggest(line: string, commands: CommandInfo[]): Suggestion[];
+/** Replace the word being typed with `value`, followed by a space. */
+export declare function applySuggestion(line: string, value: string): string;
+//# sourceMappingURL=complete.d.ts.map

package/dist/ui/complete.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"complete.d.ts","sourceRoot":"","sources":["../../src/ui/complete.ts"],"names":[],"mappings":"AAAA,MAAM,WAAW,WAAW;IACxB,IAAI,EAAE,MAAM,CAAC;IACb,WAAW,EAAE,MAAM,CAAC;IACpB,OAAO,EAAE,KAAK,CAAC;QAAE,KAAK,EAAE,MAAM,CAAC;QAAC,WAAW,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC;CAC1D;AAED,MAAM,WAAW,UAAU;IACvB,4CAA4C;IAC5C,KAAK,EAAE,MAAM,CAAC;IACd,KAAK,EAAE,MAAM,CAAC;IACd,WAAW,EAAE,MAAM,CAAC;CACvB;AAED,eAAO,MAAM,QAAQ,EAAE,WAAW,EAIjC,CAAC;AAIF,sGAAsG;AACtG,wBAAgB,QAAQ,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,CAG9C;AAED,iEAAiE;AACjE,wBAAgB,OAAO,CAAC,IAAI,EAAE,MAAM,EAAE,QAAQ,EAAE,WAAW,EAAE,GAAG,UAAU,EAAE,CAoB3E;AAED,sEAAsE;AACtE,wBAAgB,eAAe,CAAC,IAAI,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,GAAG,MAAM,CAGnE"}

package/dist/ui/complete.js

@@ -0,0 +1,41 @@
+export const BUILTINS = [
+    { name: 'help', description: 'Show commands and keys', options: [] },
+    { name: 'clear', description: 'Clear the screen', options: [] },
+    { name: 'exit', description: 'Leave OwnKey (Ctrl+D)', options: [] },
+];
+const MAX = 6;
+/** Long flag of a commander flags string, e.g. "-y, --yes" -> "--yes", "--case <ids>" -> "--case". */
+export function longFlag(flags) {
+    const parts = flags.split(/[ ,|]+/).filter((p) => p.startsWith('-'));
+    return parts.find((p) => p.startsWith('--')) ?? parts[0] ?? flags;
+}
+/** Suggestions for the word being typed at the end of `line`. */
+export function suggest(line, commands) {
+    const all = [...commands, ...BUILTINS];
+    const trimmedStart = line.replace(/^\s+/, '').replace(/^ownkey\s+/, '');
+    const words = trimmedStart.split(/\s+/);
+    if (words.length <= 1) {
+        const w = words[0] ?? '';
+        return all
+            .filter((c) => c.name.startsWith(w) && c.name !== w)
+            .slice(0, MAX)
+            .map((c) => ({ value: c.name, label: c.name, description: c.description }));
+    }
+    const cmd = all.find((c) => c.name === words[0]);
+    if (!cmd)
+        return [];
+    const current = words[words.length - 1];
+    if (current !== '' && !current.startsWith('-'))
+        return [];
+    const used = new Set(words.slice(1, -1));
+    return cmd.options
+        .map((o) => ({ value: longFlag(o.flags), label: o.flags, description: o.description }))
+        .filter((s) => s.value.startsWith(current) && s.value !== current && !used.has(s.value))
+        .slice(0, MAX);
+}
+/** Replace the word being typed with `value`, followed by a space. */
+export function applySuggestion(line, value) {
+    const i = Math.max(line.lastIndexOf(' '), line.lastIndexOf('\t'));
+    return line.slice(0, i + 1) + value + ' ';
+}
+//# sourceMappingURL=complete.js.map

package/dist/ui/complete.js.map

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

package/dist/ui/context.d.ts

@@ -0,0 +1,11 @@
+export interface SessionInfo {
+    version: string;
+    folder: string;
+    branch?: string;
+    changed?: number;
+    provider?: string;
+    model?: string;
+}
+/** What the header shows: where you are, what changed, and which model reviews it. */
+export declare function loadSessionInfo(cwd: string, version: string): Promise<SessionInfo>;
+//# sourceMappingURL=context.d.ts.map

package/dist/ui/context.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"context.d.ts","sourceRoot":"","sources":["../../src/ui/context.ts"],"names":[],"mappings":"AAKA,MAAM,WAAW,WAAW;IACxB,OAAO,EAAE,MAAM,CAAC;IAChB,MAAM,EAAE,MAAM,CAAC;IACf,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,KAAK,CAAC,EAAE,MAAM,CAAC;CAClB;AAUD,sFAAsF;AACtF,wBAAsB,eAAe,CAAC,GAAG,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,WAAW,CAAC,CAqBxF"}

package/dist/ui/context.js

@@ -0,0 +1,37 @@
+import { execFileSync } from 'child_process';
+import { basename } from 'path';
+import { configManager } from '../config/manager.js';
+import { AIProviderFactory } from '../ai/factory.js';
+function git(cwd, args) {
+    try {
+        return execFileSync('git', args, { cwd, encoding: 'utf-8', stdio: ['ignore', 'pipe', 'ignore'] }).trim();
+    }
+    catch {
+        return undefined;
+    }
+}
+/** What the header shows: where you are, what changed, and which model reviews it. */
+export async function loadSessionInfo(cwd, version) {
+    const root = git(cwd, ['rev-parse', '--show-toplevel']);
+    const info = { version, folder: basename(root ?? cwd) };
+    if (root) {
+        info.branch = git(root, ['rev-parse', '--abbrev-ref', 'HEAD']) || undefined;
+        const status = git(root, ['status', '--porcelain']);
+        info.changed = status === undefined ? undefined : status.split('\n').filter(Boolean).length;
+    }
+    try {
+        if (await configManager.exists()) {
+            const config = await configManager.load();
+            if (config.activeProvider) {
+                info.provider = config.activeProvider;
+                const p = config.providers[config.activeProvider];
+                info.model = p?.model || AIProviderFactory.getRecommendedModel(config.activeProvider);
+            }
+        }
+    }
+    catch {
+        // Unreadable config: the header just shows the setup hint
+    }
+    return info;
+}
+//# sourceMappingURL=context.js.map

package/dist/ui/context.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"context.js","sourceRoot":"","sources":["../../src/ui/context.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,YAAY,EAAE,MAAM,eAAe,CAAC;AAC7C,OAAO,EAAE,QAAQ,EAAE,MAAM,MAAM,CAAC;AAChC,OAAO,EAAE,aAAa,EAAE,MAAM,sBAAsB,CAAC;AACrD,OAAO,EAAE,iBAAiB,EAAE,MAAM,kBAAkB,CAAC;AAWrD,SAAS,GAAG,CAAC,GAAW,EAAE,IAAc;IACpC,IAAI,CAAC;QACD,OAAO,YAAY,CAAC,KAAK,EAAE,IAAI,EAAE,EAAE,GAAG,EAAE,QAAQ,EAAE,OAAO,EAAE,KAAK,EAAE,CAAC,QAAQ,EAAE,MAAM,EAAE,QAAQ,CAAC,EAAE,CAAC,CAAC,IAAI,EAAE,CAAC;IAC7G,CAAC;IAAC,MAAM,CAAC;QACL,OAAO,SAAS,CAAC;IACrB,CAAC;AACL,CAAC;AAED,sFAAsF;AACtF,MAAM,CAAC,KAAK,UAAU,eAAe,CAAC,GAAW,EAAE,OAAe;IAC9D,MAAM,IAAI,GAAG,GAAG,CAAC,GAAG,EAAE,CAAC,WAAW,EAAE,iBAAiB,CAAC,CAAC,CAAC;IACxD,MAAM,IAAI,GAAgB,EAAE,OAAO,EAAE,MAAM,EAAE,QAAQ,CAAC,IAAI,IAAI,GAAG,CAAC,EAAE,CAAC;IACrE,IAAI,IAAI,EAAE,CAAC;QACP,IAAI,CAAC,MAAM,GAAG,GAAG,CAAC,IAAI,EAAE,CAAC,WAAW,EAAE,cAAc,EAAE,MAAM,CAAC,CAAC,IAAI,SAAS,CAAC;QAC5E,MAAM,MAAM,GAAG,GAAG,CAAC,IAAI,EAAE,CAAC,QAAQ,EAAE,aAAa,CAAC,CAAC,CAAC;QACpD,IAAI,CAAC,OAAO,GAAG,MAAM,KAAK,SAAS,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC,MAAM,CAAC;IAChG,CAAC;IACD,IAAI,CAAC;QACD,IAAI,MAAM,aAAa,CAAC,MAAM,EAAE,EAAE,CAAC;YAC/B,MAAM,MAAM,GAAG,MAAM,aAAa,CAAC,IAAI,EAAE,CAAC;YAC1C,IAAI,MAAM,CAAC,cAAc,EAAE,CAAC;gBACxB,IAAI,CAAC,QAAQ,GAAG,MAAM,CAAC,cAAc,CAAC;gBACtC,MAAM,CAAC,GAAG,MAAM,CAAC,SAAS,CAAC,MAAM,CAAC,cAAc,CAAmC,CAAC;gBACpF,IAAI,CAAC,KAAK,GAAG,CAAC,EAAE,KAAK,IAAI,iBAAiB,CAAC,mBAAmB,CAAC,MAAM,CAAC,cAAc,CAAC,CAAC;YAC1F,CAAC;QACL,CAAC;IACL,CAAC;IAAC,MAAM,CAAC;QACL,0DAA0D;IAC9D,CAAC;IACD,OAAO,IAAI,CAAC;AAChB,CAAC"}

package/dist/ui/keeper-term.d.ts

@@ -0,0 +1,33 @@
+import { keeperCaption, type KeeperMood } from './keeper.js';
+type Stream = NodeJS.WriteStream;
+/** Colour one frame line for a plain (non-Ink) terminal. */
+export declare function paintKeeperLine(line: string): string;
+/**
+ * Keeper's pose with words beside it, sized to the terminal. Returns plain lines
+ * (already coloured) so callers decide where they go.
+ */
+export declare function keeperPose(mood: KeeperMood, title: string, detail?: string[], columns?: number): string[];
+/**
+ * A live status line with Keeper working at its head. Steps print above it and stay
+ * in scrollback; the live line redraws in place. Off a TTY (CI, pipes) it degrades to
+ * the plain lines it would otherwise print, with no escape codes.
+ */
+export declare class KeeperStatus {
+    private readonly stream;
+    private tick;
+    private label;
+    private steps;
+    private timer;
+    private readonly live;
+    constructor(stream?: Stream);
+    start(label: string): void;
+    /** Print a finished step above the live line. */
+    step(text: string): void;
+    /** Stop animating and clear the live line. */
+    stop(): void;
+    private restore;
+    private clear;
+    private draw;
+}
+export { keeperCaption };
+//# sourceMappingURL=keeper-term.d.ts.map

package/dist/ui/keeper-term.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"keeper-term.d.ts","sourceRoot":"","sources":["../../src/ui/keeper-term.ts"],"names":[],"mappings":"AACA,OAAO,EAIH,aAAa,EAKb,KAAK,UAAU,EAClB,MAAM,aAAa,CAAC;AAErB,KAAK,MAAM,GAAG,MAAM,CAAC,WAAW,CAAC;AAEjC,4DAA4D;AAC5D,wBAAgB,eAAe,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAMpD;AAED;;;GAGG;AACH,wBAAgB,UAAU,CAAC,IAAI,EAAE,UAAU,EAAE,KAAK,EAAE,MAAM,EAAE,MAAM,GAAE,MAAM,EAAO,EAAE,OAAO,SAAyB,GAAG,MAAM,EAAE,CAgB7H;AAED;;;;GAIG;AACH,qBAAa,YAAY;IAOT,OAAO,CAAC,QAAQ,CAAC,MAAM;IANnC,OAAO,CAAC,IAAI,CAAK;IACjB,OAAO,CAAC,KAAK,CAAM;IACnB,OAAO,CAAC,KAAK,CAAK;IAClB,OAAO,CAAC,KAAK,CAA6B;IAC1C,OAAO,CAAC,QAAQ,CAAC,IAAI,CAAU;gBAEF,MAAM,GAAE,MAAuB;IAI5D,KAAK,CAAC,KAAK,EAAE,MAAM,GAAG,IAAI;IAiB1B,iDAAiD;IACjD,IAAI,CAAC,IAAI,EAAE,MAAM,GAAG,IAAI;IAWxB,8CAA8C;IAC9C,IAAI,IAAI,IAAI;IASZ,OAAO,CAAC,OAAO;IAIf,OAAO,CAAC,KAAK;IAIb,OAAO,CAAC,IAAI;CAUf;AAED,OAAO,EAAE,aAAa,EAAE,CAAC"}

package/dist/ui/keeper-term.js

@@ -0,0 +1,104 @@
+import chalk from 'chalk';
+import { KEEPER_FPS, KEEPER_ORANGE, keeperAnimates, keeperCaption, keeperFrame, keeperSegments, keeperShown, keeperSize, } from './keeper.js';
+/** Colour one frame line for a plain (non-Ink) terminal. */
+export function paintKeeperLine(line) {
+    return keeperSegments(line)
+        .map(({ text, part }) => part === 'body' ? chalk.hex(KEEPER_ORANGE)(text) : part === 'eye' ? chalk.bold(text) : part === 'mark' ? chalk.red.bold(text) : text)
+        .join('');
+}
+/**
+ * Keeper's pose with words beside it, sized to the terminal. Returns plain lines
+ * (already coloured) so callers decide where they go.
+ */
+export function keeperPose(mood, title, detail = [], columns = process.stdout.columns) {
+    const size = keeperSize(columns);
+    if (!keeperShown() || size === 'none')
+        return [title, ...detail];
+    const frame = keeperFrame(mood, size);
+    if (size === 'inline')
+        return [`${paintKeeperLine(frame[0])}  ${title}`, ...detail.map((d) => `          ${d}`)];
+    const text = [title, ...detail];
+    // Words sit level with the eye
+    const eyeRow = Math.max(0, frame.findIndex((l) => /[◉◎◠×]/.test(l)));
+    const width = frame[0].length;
+    const rows = Math.max(frame.length, eyeRow + text.length);
+    const out = [];
+    for (let i = 0; i < rows; i++) {
+        const art = i < frame.length ? paintKeeperLine(frame[i]) : ' '.repeat(width);
+        out.push(`${art}  ${text[i - eyeRow] ?? ''}`.trimEnd());
+    }
+    return out;
+}
+/**
+ * A live status line with Keeper working at its head. Steps print above it and stay
+ * in scrollback; the live line redraws in place. Off a TTY (CI, pipes) it degrades to
+ * the plain lines it would otherwise print, with no escape codes.
+ */
+export class KeeperStatus {
+    stream;
+    tick = 0;
+    label = '';
+    steps = 0;
+    timer;
+    live;
+    constructor(stream = process.stdout) {
+        this.stream = stream;
+        this.live = keeperAnimates(stream) && keeperSize(stream.columns) !== 'none';
+    }
+    start(label) {
+        this.label = label;
+        if (!this.live) {
+            this.stream.write(chalk.gray(`  ${label}\n`));
+            return;
+        }
+        this.stream.write('\x1b[?25l');
+        this.draw();
+        this.timer = setInterval(() => {
+            this.tick++;
+            this.draw();
+        }, 1000 / KEEPER_FPS);
+        this.timer.unref?.();
+        // Leave the terminal tidy if the process is interrupted mid-review
+        process.once('exit', () => this.restore());
+    }
+    /** Print a finished step above the live line. */
+    step(text) {
+        if (!this.live) {
+            this.stream.write(chalk.gray(`  ↳ ${text}\n`));
+            return;
+        }
+        this.clear();
+        this.stream.write(chalk.gray(`  ↳ ${text}\n`));
+        this.steps++;
+        this.draw();
+    }
+    /** Stop animating and clear the live line. */
+    stop() {
+        if (this.timer)
+            clearInterval(this.timer);
+        this.timer = undefined;
+        if (this.live) {
+            this.clear();
+            this.restore();
+        }
+    }
+    restore() {
+        if (this.live)
+            this.stream.write('\x1b[?25h');
+    }
+    clear() {
+        this.stream.write('\r\x1b[2K');
+    }
+    draw() {
+        const cols = this.stream.columns || 80;
+        const head = paintKeeperLine(keeperFrame('thinking', 'inline', this.tick)[0]);
+        const room = Math.max(8, cols - 14);
+        const full = this.steps ? `${this.label} · ${this.steps} lookup${this.steps === 1 ? '' : 's'}` : this.label;
+        const label = full.length > room ? full.slice(0, room - 1) + '…' : full;
+        const dots = '.'.repeat(1 + (Math.floor(this.tick / 3) % 3));
+        this.clear();
+        this.stream.write(`  ${head} ${chalk.gray(label + dots)}`);
+    }
+}
+export { keeperCaption };
+//# sourceMappingURL=keeper-term.js.map

package/dist/ui/keeper-term.js.map

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

package/dist/ui/keeper.d.ts

@@ -0,0 +1,60 @@
+/**
+ * Keeper, the OwnKey mascot: a living key whose bow is one inspecting eye.
+ *
+ * Pure frame data, no terminal I/O, so the Ink session, the plain review output,
+ * and the tests all draw the same character. Keeper reacts to what OwnKey is doing
+ * (its mood) and redraws to fit the terminal it is in (its size).
+ */
+export type KeeperMood = 'idle' | 'thinking' | 'found' | 'clean' | 'error';
+export type KeeperSize = 'full' | 'compact' | 'inline' | 'none';
+export declare const KEEPER_ORANGE = "#ff5a1f";
+/** Smallest terminal width that fits each size beside its text. */
+export declare const KEEPER_BREAKPOINTS: {
+    readonly full: 72;
+    readonly compact: 44;
+    readonly inline: 24;
+};
+/** Pick the largest Keeper that still leaves room for text at this terminal width. */
+export declare function keeperSize(columns: number | undefined, rows?: number): KeeperSize;
+/**
+ * The eye for a mood at an animation tick. Thinking glances left, centre, right;
+ * idle blinks now and then; the rest hold an expression.
+ */
+type Eye = {
+    pos: -1 | 0 | 1;
+    glyph: string;
+    pair?: boolean;
+};
+export declare function keeperEye(mood: KeeperMood, tick?: number): Eye;
+/** A short spoken line for a mood, shown beside larger Keepers. */
+export declare function keeperCaption(mood: KeeperMood): string;
+/**
+ * The frame for a mood, size, and tick, as plain lines of equal width.
+ * Callers colour it; the shapes carry the character without colour.
+ */
+export declare function keeperFrame(mood: KeeperMood, size: KeeperSize, tick?: number): string[];
+/** Ticks per second the animations are written for. */
+export declare const KEEPER_FPS = 8;
+/** Whether this terminal should see Keeper move: a TTY, not CI, and motion not turned off. */
+export declare function keeperAnimates(stream?: {
+    isTTY?: boolean;
+}, env?: NodeJS.ProcessEnv): boolean;
+/** Whether to draw Keeper at all. */
+export declare function keeperShown(env?: NodeJS.ProcessEnv): boolean;
+export type KeeperPart = 'body' | 'eye' | 'mark' | 'space';
+/**
+ * Split a frame line into runs a renderer can colour: the key in orange, the eye in
+ * the terminal's own foreground so it reads on light and dark themes, the alarm in red.
+ */
+export declare function keeperSegments(line: string): {
+    text: string;
+    part: KeeperPart;
+}[];
+/**
+ * A command run inside the interactive session can tell Keeper how it went (a review
+ * with findings exits 0 but should not get a smile). The session passes a file path in
+ * OWNKEY_SESSION_STATE; commands write their mood there.
+ */
+export declare function reportKeeperMood(mood: KeeperMood, env?: NodeJS.ProcessEnv): void;
+export {};
+//# sourceMappingURL=keeper.d.ts.map

package/dist/ui/keeper.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"keeper.d.ts","sourceRoot":"","sources":["../../src/ui/keeper.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAIH,MAAM,MAAM,UAAU,GAAG,MAAM,GAAG,UAAU,GAAG,OAAO,GAAG,OAAO,GAAG,OAAO,CAAC;AAC3E,MAAM,MAAM,UAAU,GAAG,MAAM,GAAG,SAAS,GAAG,QAAQ,GAAG,MAAM,CAAC;AAEhE,eAAO,MAAM,aAAa,YAAY,CAAC;AAEvC,mEAAmE;AACnE,eAAO,MAAM,kBAAkB;;;;CAAiD,CAAC;AAEjF,sFAAsF;AACtF,wBAAgB,UAAU,CAAC,OAAO,EAAE,MAAM,GAAG,SAAS,EAAE,IAAI,CAAC,EAAE,MAAM,GAAG,UAAU,CAMjF;AAED;;;GAGG;AACH,KAAK,GAAG,GAAG;IAAE,GAAG,EAAE,CAAC,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC;IAAC,KAAK,EAAE,MAAM,CAAC;IAAC,IAAI,CAAC,EAAE,OAAO,CAAA;CAAE,CAAC;AAI9D,wBAAgB,SAAS,CAAC,IAAI,EAAE,UAAU,EAAE,IAAI,SAAI,GAAG,GAAG,CAiBzD;AAED,mEAAmE;AACnE,wBAAgB,aAAa,CAAC,IAAI,EAAE,UAAU,GAAG,MAAM,CAatD;AAWD;;;GAGG;AACH,wBAAgB,WAAW,CAAC,IAAI,EAAE,UAAU,EAAE,IAAI,EAAE,UAAU,EAAE,IAAI,SAAI,GAAG,MAAM,EAAE,CAqClF;AAQD,uDAAuD;AACvD,eAAO,MAAM,UAAU,IAAI,CAAC;AAE5B,8FAA8F;AAC9F,wBAAgB,cAAc,CAAC,MAAM,GAAE;IAAE,KAAK,CAAC,EAAE,OAAO,CAAA;CAAmB,EAAE,GAAG,GAAE,MAAM,CAAC,UAAwB,GAAG,OAAO,CAK1H;AAED,qCAAqC;AACrC,wBAAgB,WAAW,CAAC,GAAG,GAAE,MAAM,CAAC,UAAwB,GAAG,OAAO,CAEzE;AAED,MAAM,MAAM,UAAU,GAAG,MAAM,GAAG,KAAK,GAAG,MAAM,GAAG,OAAO,CAAC;AAI3D;;;GAGG;AACH,wBAAgB,cAAc,CAAC,IAAI,EAAE,MAAM,GAAG;IAAE,IAAI,EAAE,MAAM,CAAC;IAAC,IAAI,EAAE,UAAU,CAAA;CAAE,EAAE,CAYjF;AAED;;;;GAIG;AACH,wBAAgB,gBAAgB,CAAC,IAAI,EAAE,UAAU,EAAE,GAAG,GAAE,MAAM,CAAC,UAAwB,GAAG,IAAI,CAS7F"}

package/dist/ui/keeper.js

@@ -0,0 +1,167 @@
+/**
+ * Keeper, the OwnKey mascot: a living key whose bow is one inspecting eye.
+ *
+ * Pure frame data, no terminal I/O, so the Ink session, the plain review output,
+ * and the tests all draw the same character. Keeper reacts to what OwnKey is doing
+ * (its mood) and redraws to fit the terminal it is in (its size).
+ */
+import { writeFileSync } from 'fs';
+export const KEEPER_ORANGE = '#ff5a1f';
+/** Smallest terminal width that fits each size beside its text. */
+export const KEEPER_BREAKPOINTS = { full: 72, compact: 44, inline: 24 };
+/** Pick the largest Keeper that still leaves room for text at this terminal width. */
+export function keeperSize(columns, rows) {
+    const cols = columns && columns > 0 ? columns : 80;
+    if (cols >= KEEPER_BREAKPOINTS.full && (rows === undefined || rows >= 16))
+        return 'full';
+    if (cols >= KEEPER_BREAKPOINTS.compact)
+        return 'compact';
+    if (cols >= KEEPER_BREAKPOINTS.inline)
+        return 'inline';
+    return 'none';
+}
+const THINKING_PATH = [0, -1, -1, 0, 1, 1, 0, 0];
+export function keeperEye(mood, tick = 0) {
+    switch (mood) {
+        case 'thinking':
+            return { pos: THINKING_PATH[tick % THINKING_PATH.length], glyph: '◉' };
+        case 'found':
+            return { pos: 0, glyph: tick % 6 === 5 ? '◉' : '◎' };
+        case 'clean':
+            return { pos: 0, glyph: '◠', pair: true };
+        case 'error':
+            return { pos: 0, glyph: '×' };
+        default:
+            // A blink every 16 ticks, and an occasional glance to the side
+            if (tick % 16 === 15)
+                return { pos: 0, glyph: '─' };
+            if (tick % 32 === 8)
+                return { pos: -1, glyph: '◉' };
+            if (tick % 32 === 24)
+                return { pos: 1, glyph: '◉' };
+            return { pos: 0, glyph: '◉' };
+    }
+}
+/** A short spoken line for a mood, shown beside larger Keepers. */
+export function keeperCaption(mood) {
+    switch (mood) {
+        case 'thinking':
+            return 'looking into it';
+        case 'found':
+            return 'found something';
+        case 'clean':
+            return 'all clear';
+        case 'error':
+            return 'that went wrong';
+        default:
+            return 'ready when you are';
+    }
+}
+/** Five cells inside the bow, with the eye placed by position. */
+function eyeRow(eye, width) {
+    const face = eye.pair ? `${eye.glyph} ${eye.glyph}` : eye.glyph;
+    const room = width - face.length;
+    const centre = Math.floor(room / 2);
+    const left = Math.max(0, Math.min(room, centre + eye.pos * Math.max(1, centre - 1)));
+    return ' '.repeat(left) + face + ' '.repeat(room - left);
+}
+/**
+ * The frame for a mood, size, and tick, as plain lines of equal width.
+ * Callers colour it; the shapes carry the character without colour.
+ */
+export function keeperFrame(mood, size, tick = 0) {
+    const eye = keeperEye(mood, tick);
+    // A blinking alarm mark beside the bow when it finds something
+    const mark = mood === 'found' && tick % 2 === 0 ? '!' : ' ';
+    // A gentle bob while it works: the whole key rises a row every other beat
+    const bob = mood === 'thinking' && tick % 4 >= 2;
+    if (size === 'none')
+        return [];
+    if (size === 'inline') {
+        const glyph = eye.pair ? '◠' : eye.glyph;
+        const inner = eye.pos < 0 ? `${glyph}  ` : eye.pos > 0 ? `  ${glyph}` : ` ${glyph} `;
+        return [`(${inner})━┳┳╸`];
+    }
+    if (size === 'compact') {
+        const lines = [
+            ` ╭─────╮ ${mark}`,
+            ` │${eyeRow(eye, 5)}│  `,
+            ` ╰──┬──╯  `,
+            `    ├┐    `,
+            `    ╵     `,
+        ];
+        return bob ? bobbed(lines) : lines;
+    }
+    const lines = [
+        `   ▄▄▀▀▀▀▀▄▄   ${mark}`,
+        `  █▀       ▀█   `,
+        `  █${eyeRow(eye, 9)}█   `,
+        `  ▀█▄     ▄█▀   `,
+        `    ▀▀███▀▀     `,
+        `       █▙▄      `,
+        `       █        `,
+        `       █▛▀      `,
+    ];
+    return bob ? bobbed(lines) : lines;
+}
+/** Shift the key up one row (padding below) so it bobs without changing height. */
+function bobbed(lines) {
+    const blank = ' '.repeat(lines[0].length);
+    return [...lines.slice(1), blank];
+}
+/** Ticks per second the animations are written for. */
+export const KEEPER_FPS = 8;
+/** Whether this terminal should see Keeper move: a TTY, not CI, and motion not turned off. */
+export function keeperAnimates(stream = process.stdout, env = process.env) {
+    if (!stream.isTTY)
+        return false;
+    if (env.CI || env.OWNKEY_REDUCED_MOTION || env.OWNKEY_NO_MASCOT)
+        return false;
+    if (env.TERM === 'dumb')
+        return false;
+    return true;
+}
+/** Whether to draw Keeper at all. */
+export function keeperShown(env = process.env) {
+    return !env.OWNKEY_NO_MASCOT;
+}
+const EYE_GLYPHS = new Set(['◉', '◎', '◠', '×', '─']);
+/**
+ * Split a frame line into runs a renderer can colour: the key in orange, the eye in
+ * the terminal's own foreground so it reads on light and dark themes, the alarm in red.
+ */
+export function keeperSegments(line) {
+    const out = [];
+    for (const ch of line) {
+        // The compact bow's frame uses ─ too; only a lone ─ between spaces is a blink
+        const part = ch === ' ' ? 'space' : ch === '!' ? 'mark' : EYE_GLYPHS.has(ch) ? 'eye' : 'body';
+        const last = out[out.length - 1];
+        if (last && last.part === part)
+            last.text += ch;
+        else
+            out.push({ text: ch, part });
+    }
+    // The frame's own ─ runs (the compact bow) are several cells long; a blink is one
+    for (const seg of out)
+        if (seg.part === 'eye' && /^─{2,}$/.test(seg.text))
+            seg.part = 'body';
+    return out;
+}
+/**
+ * A command run inside the interactive session can tell Keeper how it went (a review
+ * with findings exits 0 but should not get a smile). The session passes a file path in
+ * OWNKEY_SESSION_STATE; commands write their mood there.
+ */
+export function reportKeeperMood(mood, env = process.env) {
+    const file = env.OWNKEY_SESSION_STATE;
+    if (!file)
+        return;
+    try {
+        // Synchronous: the process may exit right after
+        writeFileSync(file, JSON.stringify({ mood }), 'utf-8');
+    }
+    catch {
+        // Cosmetic only
+    }
+}
+//# sourceMappingURL=keeper.js.map

package/dist/ui/keeper.js.map

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

package/dist/ui/session.d.ts

@@ -0,0 +1,6 @@
+import type { KeeperMood } from './keeper.js';
+import { type CommandInfo } from './complete.js';
+/** Exit codes: review uses 1 for findings at --fail-on, and 2 for an error. */
+export declare function moodFor(command: string, code: number): KeeperMood;
+export declare function startSession(commands: CommandInfo[], version: string): Promise<void>;
+//# sourceMappingURL=session.d.ts.map