codebase-onboarder 0.6.0 → 1.0.0

package/cli/chat/commands.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"commands.js","sourceRoot":"","sources":["../../src/cli/chat/commands.ts"],"names":[],"mappings":"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","sourcesContent":["import { AGENT_MODES } from '../agent/contracts.js';\n\nexport const CHAT_COMMANDS = [\n  ['help', '[command]', 'Show commands and examples'],\n  ['ask', '<question>', 'Ask about this repository'],\n  ['review', '[PR number] [task]', 'Review local changes or a GitHub PR'],\n  ['triage', '[issue number] [task]', 'Investigate issues and suggest fixes'],\n  ['implement', '<task>', 'Make changes in an isolated Git workspace'],\n  ['pr', '<task>', 'Prepare a draft PR; publish when GitHub writes are enabled'],\n  ['github', '<task>', 'Work with GitHub issues, reviews, labels, and CI'],\n  ['mode', '[ask|review|triage|implement|pr|github]', 'Choose the workflow for following messages'],\n  ['permissions', '[checks|github] [on|off]', 'Control test execution and GitHub writes'],\n  ['model', '[name] [provider]', 'Open the provider/model picker; configure opens full Hermes setup'],\n  ['limits', '[seconds] [turns]', 'Set the run timeout and tool-turn budget'],\n  ['repo', '[folder|GitHub URL]', 'Show or switch the repository; clone GitHub URLs'],\n  ['clone', '<GitHub URL>', 'Clone a repository into a saved local checkout'],\n  ['pull', '', 'Update the saved checkout without overwriting local changes'],\n  ['new', '', 'Start a fresh conversation'],\n  ['history', '', 'List saved conversations for this repository'],\n  ['resume', '<conversation ID>', 'Continue a saved conversation'],\n  ['status', '', 'Show model, permissions, workspace, and last run'],\n  ['paste', '', 'Enter a multiline message; finish with /send or /discard'],\n  ['cancel', '', 'Stop the active task (Ctrl-C also works)'],\n  ['map', '', 'Repository overview, available offline'],\n  ['tree', '[folder] [depth]', 'Browse repository files'],\n  ['find', '<query>', 'Search files, symbols, and contents'],\n  ['show', '<file> [from] [count]', 'Read a file'],\n  ['diff', '[base] [head] [file]', 'Inspect changes in the current workspace'],\n  ['health', '', 'Inspect repository health'],\n  ['rescan', '', 'Refresh the cached repository analysis'],\n  ['tour', '', 'Find the best reading order for this codebase'],\n  ['explain', '[file|folder]', 'Explain a module using local analysis'],\n  ['deps', '<file>', 'Trace imports and reverse dependencies'],\n  ['inspect', '<file>', 'Inspect role, complexity, exports, and findings'],\n  ['graph', '<file> [depth]', 'Explore the dependency graph'],\n  ['blast', '<file>', 'Show the impact of changing a file'],\n  ['symbols', '<file>', 'List functions, classes, and exports'],\n  ['hubs', '', 'Find the most depended-on modules'],\n  ['layers', '', 'Inspect architecture layers'],\n  ['patterns', '', 'Discover architecture patterns'],\n  ['stats', '', 'Inspect language and complexity statistics'],\n  ['security', '', 'Show local security findings'],\n  ['stack', '', 'Inspect frameworks and dependencies'],\n  ['entry', '', 'Locate application entry points'],\n  ['externals', '', 'Inspect external dependencies and drift'],\n  ['coupling', '', 'Explore traffic between folders'],\n  ['clusters', '', 'Find groups of related modules'],\n  ['risks', '', 'Inspect code and architecture risks'],\n  ['log', '[count]', 'Read recent Git commits'],\n  ['hotspots', '[count]', 'Find frequently changed complex files'],\n  ['blame', '<file>', 'Read line authorship'],\n  ['diagram', '[file|folder]', 'Generate Mermaid diagram source'],\n  ['layers-diagram', '', 'Generate an architecture layer diagram'],\n  ['atlas', '', 'Browse available diagrams'],\n  ['docs', '[file|folder] [--write]', 'Read or explicitly generate repository documentation'],\n  ['workflows', '', 'Inspect GitHub Actions workflows'],\n  ['sbom', '[package]', 'Inspect dependencies and licenses'],\n  ['engines', '', 'Show available optional analyzers'],\n  ['deep', '<engine|all>', 'Run an optional analyzer when checks are enabled'],\n  ['web', '', 'Open the repository in the web interface'],\n  ['about', '', 'Show repository and application information'],\n  ['tools', '', 'List the actual tools available to Hermes'],\n  ['skills', '', 'Discover the six built-in agent workflows'],\n  ['runs', '', 'List saved agent runs'],\n  ['run', '<run ID>', 'Read a saved result from this repository'],\n  ['export', '', 'Save this conversation as Markdown'],\n  ['send', '', 'Submit the message composed with /paste'],\n  ['discard', '', 'Discard the message composed with /paste'],\n  ['doctor', '', 'Check the Hermes runtime and profile'],\n  ['setup', '', 'Prepare the dedicated Hermes profile'],\n  ['clear', '', 'Clear the screen; keep the conversation'],\n  ['exit', '', 'Save and exit (Ctrl-D also works)'],\n] as const;\nexport type ChatCommand = typeof CHAT_COMMANDS[number][0];\nexport const BROWSE_COMMANDS = ['map', 'tree', 'find', 'show', 'diff', 'health', 'rescan', 'tour', 'explain', 'deps', 'inspect', 'graph', 'blast', 'symbols', 'hubs', 'layers', 'patterns', 'stats', 'security', 'stack', 'entry', 'externals', 'coupling', 'clusters', 'risks', 'log', 'hotspots', 'blame', 'diagram', 'layers-diagram', 'atlas', 'docs', 'workflows', 'sbom', 'engines', 'deep', 'web', 'about'] as const;\n\nexport function suggestCommands(line: string): typeof CHAT_COMMANDS[number][] {\n  if (!/^\\/[\\w-]*$/.test(line)) return [];\n  const query = line.slice(1).toLowerCase();\n  return CHAT_COMMANDS.filter(([name, , summary]) => name.startsWith(query) || query.length > 1 && summary.toLowerCase().includes(query))\n    .sort((a, b) => Number(b[0].startsWith(query)) - Number(a[0].startsWith(query)));\n}\n\nexport function slashInput(line: string): { name: string; args: string[]; body: string } | null {\n  const match = /^\\/([\\w-]*)(?:\\s+([\\s\\S]*))?$/.exec(line.trim());\n  if (!match) return null;\n  const body = match[2] || '';\n  // Quotes are useful for file paths. Workflow tasks retain the original body.\n  const args = [...body.matchAll(/\"([^\"]*)\"|'([^']*)'|(\\S+)/g)].map(m => m[1] ?? m[2] ?? m[3]!);\n  return { name: match[1]!, args, body };\n}\nexport function chatHelp(topic = ''): string {\n  const commands = topic ? CHAT_COMMANDS.filter(c => c[0] === topic.replace(/^\\//, '')) : CHAT_COMMANDS;\n  if (!commands.length) return `Unknown command /${topic}. Use /help.`;\n  return ['Slash commands', '', ...commands.map(([name, args, detail]) => `  /${name}${args ? ' ' + args : ''}\\n    ${detail}`), '',\n    'Type / for live suggestions. ↑/↓ select; Tab or Enter fills the command. Esc dismisses.',\n    'Alt-Enter adds a line. Bracketed paste preserves multiline text. Ctrl-C cancels a task.',\n    '/review 42   /triage 12   /implement Fix the failing test',\n    '/permissions checks on   /permissions github on',\n    'Paste a GitHub URL to clone and open it, then type your question.',\n    'Follow-ups reuse the Hermes session. Mode, target, model, or permission changes start a new session.',\n    'Use /paste for multiline text. /new resets context; /clear only clears the screen.'].join('\\n');\n}\nexport function completeChat(line: string, files: string[] = []): [string[], string] {\n  if (!line.startsWith('/')) return [[], line];\n  if (!line.includes(' ')) return [CHAT_COMMANDS.map(c => '/' + c[0]).filter(c => c.startsWith(line)), line];\n  const [command, ...args] = line.split(/\\s+/), fragment = args.at(-1) || '';\n  let candidates: readonly string[] = [];\n  if (command === '/mode') candidates = AGENT_MODES;\n  if (command === '/permissions') candidates = args.length === 1 ? ['checks', 'github'] : ['on', 'off'];\n  if (command === '/model' && args.length === 1) candidates = ['configure', 'default'];\n  if (['/show', '/tree', '/repo', '/deps', '/inspect', '/graph', '/blast', '/symbols', '/explain', '/blame', '/docs', '/diagram'].includes(command!)) candidates = files;\n  return [candidates.filter(c => c.startsWith(fragment)).slice(0, 100), fragment];\n}\n"]}

package/cli/chat/composer.d.ts

@@ -0,0 +1,75 @@
+import readline from 'node:readline';
+import { type ChatTheme } from './render.js';
+export interface ComposerOptions {
+    input: NodeJS.ReadStream;
+    output: NodeJS.WriteStream;
+    theme?: ChatTheme;
+    state: () => {
+        mode: string;
+        status: string;
+        busy: boolean;
+        pasting: boolean;
+        files: string[];
+    };
+    submit: (message: string) => void;
+    cancel: () => void;
+    exit: () => void;
+    fullscreen?: boolean;
+    welcome?: (columns: number, rows: number) => string;
+    header?: () => string;
+}
+export interface PickerChoice {
+    value: string;
+    label: string;
+    detail?: string;
+}
+export interface PickerOptions {
+    title: string;
+    hint?: string;
+    choices: PickerChoice[];
+    selected?: string;
+    signal?: AbortSignal;
+}
+/** Raw-input composer with a full-screen viewport or an inline terminal footer. */
+export declare class TerminalComposer {
+    private options;
+    value: string;
+    private cursor;
+    private selected;
+    private dismissed;
+    private history;
+    private historyIndex;
+    private draft;
+    private paste;
+    private pasteCR;
+    private suspended;
+    private attached;
+    private drawnRows;
+    private cursorRow;
+    private timer;
+    private rawBefore;
+    private theme;
+    private screen;
+    private viewHeight;
+    private picker;
+    private onKey;
+    private onResize;
+    constructor(options: ComposerOptions);
+    get choosing(): boolean;
+    start(): void;
+    suspend(): void;
+    close(): void;
+    refresh(): void;
+    print(text: string): void;
+    clear(): void;
+    choose(options: PickerOptions): Promise<string | null>;
+    private pickerChoices;
+    private pickerKey;
+    private erase;
+    private replace;
+    private insert;
+    private suggestions;
+    key(text: string, key?: readline.Key): void;
+    private deleteNext;
+    private render;
+}

package/cli/chat/composer.js

@@ -0,0 +1,467 @@
+import readline from 'node:readline';
+import { terminalText } from '../agent/process.js';
+import { completeChat, suggestCommands } from './commands.js';
+import { cells, clusterCells, clip, graphemes } from './text.js';
+import { plainTheme } from './render.js';
+import { TerminalScreen, wrapScreenLine } from './screen.js';
+/** Raw-input composer with a full-screen viewport or an inline terminal footer. */
+export class TerminalComposer {
+    options;
+    value = '';
+    cursor = 0;
+    selected = 0;
+    dismissed = false;
+    history = [];
+    historyIndex = -1;
+    draft = '';
+    paste = false;
+    pasteCR = false;
+    suspended = true;
+    attached = false;
+    drawnRows = 0;
+    cursorRow = 0;
+    timer = null;
+    rawBefore = false;
+    theme;
+    screen;
+    viewHeight = 1;
+    picker = null;
+    onKey = (text, key = {}) => this.key(text, key);
+    onResize = () => this.refresh();
+    constructor(options) {
+        this.options = options;
+        this.theme = options.theme || plainTheme;
+        this.screen = options.fullscreen ? new TerminalScreen(options.output) : null;
+    }
+    get choosing() { return this.picker !== null; }
+    start() {
+        if (this.attached)
+            return;
+        this.attached = true;
+        this.suspended = false;
+        this.rawBefore = !!this.options.input.isRaw;
+        readline.emitKeypressEvents(this.options.input);
+        this.options.input.setRawMode?.(true);
+        this.options.input.resume();
+        this.options.input.on('keypress', this.onKey);
+        this.options.input.on('end', this.options.exit);
+        this.options.output.on('resize', this.onResize);
+        this.screen?.enter();
+        this.options.output.write('\x1b[?2004h');
+        this.render();
+    }
+    suspend() {
+        this.picker?.finish(null);
+        this.erase();
+        this.suspended = true;
+        if (this.timer) {
+            clearTimeout(this.timer);
+            this.timer = null;
+        }
+        if (!this.attached)
+            return;
+        this.options.input.off('keypress', this.onKey);
+        this.options.input.off('end', this.options.exit);
+        this.options.output.off('resize', this.onResize);
+        this.options.output.write('\x1b[?2004l');
+        this.screen?.leave();
+        this.options.input.setRawMode?.(this.rawBefore);
+        // The keypress decoder remains attached to this stream. Pause the parent's
+        // reads so the inherited wizard TTY receives every keystroke exclusively.
+        this.options.input.pause();
+        this.attached = false;
+    }
+    close() { if (this.screen && !this.suspended)
+        this.render(); this.suspend(); this.options.input.pause(); }
+    refresh() {
+        if (this.suspended || this.timer)
+            return;
+        this.timer = setTimeout(() => { this.timer = null; this.render(); }, 24);
+        this.timer.unref();
+    }
+    print(text) {
+        if (this.screen) {
+            this.screen.append(text);
+            this.refresh();
+            return;
+        }
+        if (this.suspended) {
+            this.options.output.write(text + '\n');
+            return;
+        }
+        this.erase();
+        this.options.output.write(text + '\n');
+        this.refresh();
+    }
+    clear() { if (this.screen) {
+        this.screen.clear();
+        this.refresh();
+    }
+    else {
+        this.erase();
+        this.options.output.write('\x1b[2J\x1b[H');
+    } }
+    choose(options) {
+        this.picker?.finish(null);
+        if (this.suspended || options.signal?.aborted)
+            return Promise.resolve(null);
+        return new Promise(resolve => {
+            const abort = () => finish(null);
+            const finish = (value) => {
+                options.signal?.removeEventListener('abort', abort);
+                if (this.picker?.finish !== finish)
+                    return;
+                this.picker = null;
+                this.paste = false;
+                this.refresh();
+                resolve(value);
+            };
+            this.picker = { ...options, query: '', index: Math.max(0, options.choices.findIndex(c => c.value === options.selected)), finish };
+            options.signal?.addEventListener('abort', abort, { once: true });
+            if (options.signal?.aborted)
+                finish(null);
+            else
+                this.refresh();
+        });
+    }
+    pickerChoices() {
+        const query = this.picker?.query.toLowerCase() || '';
+        return this.picker?.choices.filter(c => !query || (c.label + ' ' + (c.detail || '')).toLowerCase().includes(query)) || [];
+    }
+    pickerKey(text, key) {
+        const picker = this.picker;
+        if (key.name === 'paste-start') {
+            this.paste = true;
+            return;
+        }
+        if (key.name === 'paste-end') {
+            this.paste = false;
+            this.refresh();
+            return;
+        }
+        if (this.paste) {
+            if (text && !key.ctrl && !key.meta)
+                picker.query = (picker.query + terminalText(text).replace(/[\r\n\t]/g, ' ')).slice(0, 512);
+            picker.index = 0;
+            this.refresh();
+            return;
+        }
+        if (key.name === 'escape' || (key.ctrl && key.name === 'c')) {
+            picker.finish(null);
+            return;
+        }
+        if (key.ctrl && key.name === 'd') {
+            picker.finish(null);
+            this.options.exit();
+            return;
+        }
+        const choices = this.pickerChoices();
+        if (key.name === 'return' || key.name === 'enter') {
+            if (choices.length)
+                picker.finish(choices[picker.index % choices.length].value);
+        }
+        else if (['up', 'down', 'tab', 'pageup', 'pagedown'].includes(key.name || '')) {
+            const step = key.name === 'pageup' ? -6 : key.name === 'pagedown' ? 6 : key.name === 'up' || key.shift ? -1 : 1;
+            picker.index = choices.length ? (picker.index + step + choices.length * 6) % choices.length : 0;
+        }
+        else if (key.ctrl && key.name === 'u') {
+            picker.query = '';
+            picker.index = 0;
+        }
+        else if (key.name === 'backspace') {
+            picker.query = graphemes(picker.query).slice(0, -1).join('');
+            picker.index = 0;
+        }
+        else if (text && !key.ctrl && !key.meta && !/^[\x00-\x1f\x7f]/.test(text)) {
+            picker.query = (picker.query + terminalText(text)).slice(0, 512);
+            picker.index = 0;
+        }
+        this.refresh();
+    }
+    erase() {
+        if (this.screen)
+            return;
+        if (!this.drawnRows)
+            return;
+        if (this.cursorRow)
+            readline.moveCursor(this.options.output, 0, -this.cursorRow);
+        readline.cursorTo(this.options.output, 0);
+        readline.clearScreenDown(this.options.output);
+        this.drawnRows = 0;
+        this.cursorRow = 0;
+    }
+    replace(text) { this.value = text; this.cursor = text.length; this.selected = 0; this.dismissed = false; }
+    insert(text) {
+        const clean = terminalText(text).replace(/\r\n?/g, '\n').replace(/\t/g, '  ');
+        if (this.value.length + clean.length > 16000)
+            return;
+        this.value = this.value.slice(0, this.cursor) + clean + this.value.slice(this.cursor);
+        this.cursor += clean.length;
+        this.selected = 0;
+        this.dismissed = false;
+        this.historyIndex = -1;
+    }
+    suggestions() { return this.options.state().pasting || this.dismissed || this.cursor !== this.value.length ? [] : suggestCommands(this.value); }
+    key(text, key = {}) {
+        if (this.suspended)
+            return;
+        if (this.picker) {
+            this.pickerKey(text, key);
+            return;
+        }
+        if (this.screen && (key.name === 'pageup' || key.name === 'pagedown')) {
+            this.screen.scroll(key.name === 'pageup' ? 1 : -1, Math.max(1, (this.options.output.columns || 80) - 1), this.viewHeight);
+            this.refresh();
+            return;
+        }
+        if (key.name === 'paste-start') {
+            this.paste = true;
+            this.pasteCR = false;
+            this.dismissed = true;
+            return;
+        }
+        if (key.name === 'paste-end') {
+            this.paste = false;
+            this.refresh();
+            return;
+        }
+        if (this.paste) {
+            if (key.name === 'return') {
+                this.insert('\n');
+                this.pasteCR = true;
+            }
+            else if (key.name === 'enter') {
+                if (!this.pasteCR)
+                    this.insert('\n');
+                this.pasteCR = false;
+            }
+            else {
+                this.pasteCR = false;
+                if (text && !key.ctrl && !key.meta)
+                    this.insert(text);
+            }
+            this.refresh();
+            return;
+        }
+        const suggestions = this.suggestions();
+        if (key.ctrl) {
+            if (key.name === 'c') {
+                this.replace('');
+                this.options.cancel();
+            }
+            else if (key.name === 'd') {
+                if (!this.value)
+                    this.options.exit();
+                else
+                    this.deleteNext();
+            }
+            else if (key.name === 'a')
+                this.cursor = 0;
+            else if (key.name === 'e')
+                this.cursor = this.value.length;
+            else if (key.name === 'u') {
+                this.value = this.value.slice(this.cursor);
+                this.cursor = 0;
+            }
+            else if (key.name === 'k')
+                this.value = this.value.slice(0, this.cursor);
+            else if (key.name === 'w') {
+                const left = this.value.slice(0, this.cursor).replace(/\s*\S+\s*$/, '');
+                this.value = left + this.value.slice(this.cursor);
+                this.cursor = left.length;
+            }
+            this.refresh();
+            return;
+        }
+        if (key.name === 'escape') {
+            this.dismissed = true;
+            this.refresh();
+            return;
+        }
+        if ((key.name === 'up' || key.name === 'down') && suggestions.length) {
+            this.selected = (this.selected + (key.name === 'up' ? -1 : 1) + suggestions.length) % suggestions.length;
+        }
+        else if (key.name === 'tab' || ((key.name === 'return' || key.name === 'enter') && suggestions.length &&
+            this.value !== '/' + suggestions[this.selected % suggestions.length][0] && !key.meta && !key.shift)) {
+            if (suggestions.length) {
+                const name = suggestions[this.selected % suggestions.length][0];
+                this.replace('/' + name + (name === 'model' ? '' : ' '));
+                this.dismissed = true;
+            }
+            else {
+                const [hits, fragment] = completeChat(this.value, this.options.state().files);
+                if (hits.length)
+                    this.replace(this.value.slice(0, this.value.length - fragment.length) + hits[0]);
+            }
+        }
+        else if (key.name === 'return' || key.name === 'enter') {
+            if (key.meta || key.shift)
+                this.insert('\n');
+            else {
+                const message = this.value;
+                if (message.trim()) {
+                    this.history = [message, ...this.history.filter(h => h !== message)].slice(0, 200);
+                }
+                this.replace('');
+                this.historyIndex = -1;
+                if (this.screen)
+                    this.screen.append(this.theme.muted('you') + ' › ' + terminalText(message));
+                else {
+                    this.erase();
+                    this.options.output.write(this.theme.muted('you') + ' › ' + terminalText(message) + '\n');
+                }
+                this.options.submit(message);
+            }
+        }
+        else if (key.name === 'up' || key.name === 'down') {
+            if (this.historyIndex === -1)
+                this.draft = this.value;
+            this.historyIndex = Math.max(-1, Math.min(this.history.length - 1, this.historyIndex + (key.name === 'up' ? 1 : -1)));
+            const index = this.historyIndex;
+            this.replace(index < 0 ? this.draft : this.history[index]);
+            this.historyIndex = index;
+            this.dismissed = true;
+        }
+        else if (key.name === 'left')
+            this.cursor -= graphemes(this.value.slice(0, this.cursor)).at(-1)?.length || 0;
+        else if (key.name === 'right')
+            this.cursor += graphemes(this.value.slice(this.cursor))[0]?.length || 0;
+        else if (key.name === 'home')
+            this.cursor = 0;
+        else if (key.name === 'end')
+            this.cursor = this.value.length;
+        else if (key.name === 'backspace') {
+            const count = graphemes(this.value.slice(0, this.cursor)).at(-1)?.length || 0;
+            this.value = this.value.slice(0, this.cursor - count) + this.value.slice(this.cursor);
+            this.cursor -= count;
+            this.selected = 0;
+            this.dismissed = false;
+        }
+        else if (key.name === 'delete')
+            this.deleteNext();
+        else if (text && !key.meta && !/^[\x00-\x1f\x7f]/.test(text))
+            this.insert(text);
+        this.refresh();
+    }
+    deleteNext() { const count = graphemes(this.value.slice(this.cursor))[0]?.length || 0; this.value = this.value.slice(0, this.cursor) + this.value.slice(this.cursor + count); }
+    render() {
+        if (this.suspended)
+            return;
+        this.erase();
+        const columns = Math.max(2, this.options.output.columns || Number(process.env.COLUMNS) || 80), room = columns - 1;
+        const state = this.options.state(), prefix = this.picker ? 'filter › ' : state.pasting ? 'paste › ' : state.mode + ' › ';
+        const value = this.picker ? this.picker.query : this.value, cursor = this.picker ? value.length : this.cursor;
+        const lead = clip(prefix, Math.max(1, room - 1), false);
+        const lines = [''];
+        let row = 0, col = 0, cursorRow = 0, cursorCol = 0, offset = -lead.length;
+        for (const g of graphemes(lead + value)) {
+            if (offset === cursor) {
+                cursorRow = row;
+                cursorCol = col;
+            }
+            if (g === '\n') {
+                lines.push('');
+                row++;
+                col = 0;
+            }
+            else {
+                const actualSize = clusterCells(g), size = Math.min(room, actualSize);
+                if (col + size > room) {
+                    lines.push('');
+                    row++;
+                    col = 0;
+                    if (offset === cursor) {
+                        cursorRow = row;
+                        cursorCol = 0;
+                    }
+                }
+                lines[row] += actualSize > room ? '?' : g;
+                col += size;
+            }
+            offset += g.length;
+        }
+        if (cursor === value.length) {
+            cursorRow = row;
+            cursorCol = col;
+        }
+        const maxInput = Math.max(1, Math.min(8, (this.options.output.rows || 24) - (this.screen ? 12 : 7)));
+        const start = Math.max(0, cursorRow - maxInput + 1);
+        const inputLines = lines.slice(start, start + maxInput);
+        cursorRow -= start;
+        if (start === 0)
+            inputLines[0] = this.theme.accent(lead) + inputLines[0].slice(lead.length);
+        if (!value)
+            inputLines[0] += this.theme.muted(clip(this.picker ? 'Type to search · arrows to choose' : 'Ask about the repo, or type / for commands…', Math.max(0, room - cells(lead))));
+        const rows = [(this.theme.status || this.theme.muted)(clip(state.status, room)), this.theme.accent('─'.repeat(room)), ...inputLines,
+            this.theme.accent('─'.repeat(room))];
+        cursorRow += 2;
+        const suggestions = this.picker ? [] : this.suggestions();
+        if (this.picker) {
+            const picker = this.picker, choices = this.pickerChoices();
+            const count = Math.max(1, Math.min(8, (this.options.output.rows || 24) - rows.length - (this.screen ? 6 : 4)));
+            const begin = Math.max(0, picker.index - count + 1);
+            const inner = Math.max(0, room - 4);
+            const box = (text) => { const shown = clip(text, inner); return room >= 6 ? '│ ' + shown + ' '.repeat(inner - cells(shown)) + ' │' : clip(text, room); };
+            const heading = clip(' ' + picker.title + ' ', Math.max(0, room - 4));
+            rows.push(this.theme.accent(room >= 6 ? '╭─' + heading + '─'.repeat(room - 3 - cells(heading)) + '╮' : clip(picker.title, room)));
+            if (picker.hint)
+                rows.push(this.theme.muted(box(picker.hint)));
+            if (!choices.length)
+                rows.push(this.theme.muted(box('No matches · clear the filter with Ctrl-U')));
+            choices.slice(begin, begin + count).forEach((choice, i) => {
+                const chosen = begin + i === picker.index;
+                const text = `${chosen ? '❯' : ' '} ${choice.label}${choice.detail ? '  ·  ' + choice.detail : ''}`;
+                rows.push((chosen ? this.theme.accent : this.theme.muted)(box(text)));
+            });
+            const hint = clip(` ↑/↓ select · Enter choose · Esc cancel · ${choices.length ? picker.index + 1 : 0}/${choices.length} `, Math.max(0, room - 4));
+            rows.push(this.theme.accent(room >= 6 ? '╰─' + hint + '─'.repeat(room - 3 - cells(hint)) + '╯' : clip(hint, room)));
+        }
+        else if (suggestions.length) {
+            const count = Math.max(1, Math.min(6, (this.options.output.rows || 24) - rows.length - (this.screen ? 4 : 2)));
+            const begin = Math.max(0, this.selected - count + 1), visible = suggestions.slice(begin, begin + count);
+            visible.forEach(([name, usage, summary], index) => {
+                const chosen = begin + index === this.selected;
+                const label = `${chosen ? '›' : ' '} /${name}${usage ? ' ' + usage : ''}`;
+                const shown = clip(label, Math.min(36, Math.floor(room * 0.5)));
+                const detail = room > 45 ? '  ' + clip(summary, room - cells(shown) - 2) : '';
+                rows.push((chosen ? this.theme.accent : this.theme.muted)(shown + detail));
+            });
+            rows.push(this.theme.muted(clip(`↑/↓ select · Tab/Enter insert · Esc close · ${this.selected + 1}/${suggestions.length}`, room)));
+        }
+        else
+            rows.push(this.theme.muted(clip(state.busy ? 'Working · /cancel or Ctrl-C to stop' : state.pasting ? '/send submit · /discard cancel' : this.screen ? 'Type / for commands · PgUp/PgDn scroll · Alt-Enter newline · Ctrl-D exit' : 'Type / for commands · Alt-Enter newline · Ctrl-D exit', room)));
+        if (this.screen) {
+            const height = Math.max(1, this.options.output.rows || 24);
+            if (height < 3) {
+                const tiny = [inputLines[Math.max(0, cursorRow - 2)] || inputLines[0], this.theme.muted(clip(state.status, room))].slice(0, height);
+                this.viewHeight = 1;
+                this.screen.draw(tiny, columns, 0, cursorCol);
+                return;
+            }
+            let footer = rows, footerCursorRow = cursorRow;
+            // Tiny windows keep the active input visible; menus simplify to one choice.
+            if (footer.length > height - 2) {
+                const choices = this.picker ? this.pickerChoices() : [];
+                const hint = this.picker ? choices[this.picker.index]?.label || 'No matches' : suggestions[this.selected]?.[0] ? '/' + suggestions[this.selected][0] : 'Enter send · Esc cancel';
+                footer = [inputLines[Math.max(0, cursorRow - 2)] || inputLines[0], this.theme.muted(clip(hint, room))].slice(0, Math.max(1, height - 2));
+                footerCursorRow = 0;
+            }
+            this.viewHeight = height - footer.length - 1;
+            const welcome = this.options.welcome?.(columns, this.viewHeight) || '';
+            const content = this.screen.view(room, this.viewHeight, welcome);
+            const header = (this.options.header?.() || 'ONBOARDER') + (this.screen.scrolled ? ' · history · PgDn to return' : '');
+            const frame = [wrapScreenLine(header, room)[0], ...content,
+                ...Array(Math.max(0, this.viewHeight - content.length)).fill(''), ...footer];
+            this.screen.draw(frame, columns, height - footer.length + footerCursorRow, cursorCol);
+            return;
+        }
+        this.options.output.write(rows.join('\n'));
+        const up = rows.length - 1 - cursorRow;
+        if (up)
+            readline.moveCursor(this.options.output, 0, -up);
+        readline.cursorTo(this.options.output, cursorCol);
+        this.drawnRows = rows.length;
+        this.cursorRow = cursorRow;
+    }
+}
+//# sourceMappingURL=composer.js.map