@rasensio/aidlc 1.77.0 → 1.79.0

package/dist/console/harness.js

@@ -0,0 +1,191 @@
+/**
+ * Driving the user's own harness one turn at a time (aidlc-console/AC-20,
+ * aidlc-console/AC-21, aidlc-console/AC-22, aidlc-console/AC-23,
+ * aidlc-console/AC-24, aidlc-console/AC-26, aidlc-console/AC-30).
+ *
+ * Pure. Each turn is one process: Claude Code's `-p` with stream-json output,
+ * or `codex exec --json`, resumed by the id the previous turn reported (design
+ * D3). The message always travels on stdin, so a message starting with `-` is
+ * never read as an option and long command output never meets argv limits.
+ *
+ * @module
+ */
+import { emptyCodexProgress, readCodexEvents } from '../autopilot/result.js';
+export const HARNESSES = ['claude-code', 'codex'];
+/** The program each harness runs, for the "not installed" message (aidlc-console/AC-28). */
+export const PROGRAM = { 'claude-code': 'claude', codex: 'codex' };
+/** Harness ids are UUIDs; anything else is refused before it reaches argv. */
+const SESSION_RE = /^[0-9A-Za-z][0-9A-Za-z-]{7,63}$/;
+/**
+ * The argv for one turn. `session` null starts a new session; `allowed` holds the
+ * tool rules the user approved (aidlc-console/AC-23). Codex runs in its
+ * workspace-write sandbox and takes no tool rules (aidlc-console/AC-24).
+ */
+export function turnArgv(harness, session, allowed = []) {
+    const resume = session !== null && SESSION_RE.test(session) ? session : null;
+    if (harness === 'codex') {
+        return ['codex', 'exec', '--sandbox', 'workspace-write', '--json', ...(resume ? ['resume', resume] : []), '-'];
+    }
+    return [
+        'claude', '-p', '--output-format', 'stream-json', '--verbose',
+        ...(resume ? ['--resume', resume] : []),
+        ...(allowed.length > 0 ? ['--allowedTools', ...allowed] : []),
+    ];
+}
+const isRecord = (v) => typeof v === 'object' && v !== null && !Array.isArray(v);
+/** One line for a tool call: the command for a shell, the path for a file tool, else the name. */
+export function toolLine(name, input) {
+    const i = isRecord(input) ? input : {};
+    const detail = typeof i.command === 'string' ? i.command
+        : typeof i.file_path === 'string' ? i.file_path
+            : typeof i.path === 'string' ? i.path
+                : typeof i.pattern === 'string' ? i.pattern
+                    : '';
+    const one = detail.replace(/\s+/g, ' ').trim();
+    return `⏺ ${name}${one ? ` ${one.length > 100 ? `${one.slice(0, 99)}…` : one}` : ''}`;
+}
+/**
+ * Folds a turn's stdout, line by line, into what to show and how it ended.
+ * Unknown events and non-JSON lines are ignored, so a new harness event changes
+ * nothing here (design: harness output drift).
+ */
+export class TurnParser {
+    harness;
+    session;
+    costUsd = null;
+    tokens = null;
+    denials = [];
+    error = null;
+    codex = emptyCodexProgress();
+    sawResult = false;
+    constructor(harness, session) {
+        this.harness = harness;
+        this.session = session;
+    }
+    /** The lines to show for one stdout line. */
+    push(line) {
+        const t = line.trim();
+        if (!t.startsWith('{'))
+            return [];
+        let v;
+        try {
+            v = JSON.parse(t);
+        }
+        catch {
+            return [];
+        }
+        if (!isRecord(v))
+            return [];
+        return this.harness === 'codex' ? this.codexEvent(t, v) : this.claudeEvent(v);
+    }
+    claudeEvent(v) {
+        if (typeof v.session_id === 'string' && SESSION_RE.test(v.session_id))
+            this.session = v.session_id;
+        if (v.type === 'assistant' && isRecord(v.message) && Array.isArray(v.message.content)) {
+            const out = [];
+            for (const block of v.message.content) {
+                if (!isRecord(block))
+                    continue;
+                if (block.type === 'text' && typeof block.text === 'string' && block.text.trim() !== '')
+                    out.push(block.text.trim());
+                if (block.type === 'tool_use' && typeof block.name === 'string')
+                    out.push(toolLine(block.name, block.input));
+            }
+            return out;
+        }
+        if (v.type === 'result') {
+            this.sawResult = true;
+            if (typeof v.total_cost_usd === 'number' && Number.isFinite(v.total_cost_usd))
+                this.costUsd = v.total_cost_usd;
+            if (v.is_error === true)
+                this.error = typeof v.result === 'string' && v.result ? v.result : String(v.subtype ?? 'error');
+            const denials = Array.isArray(v.permission_denials) ? v.permission_denials : [];
+            for (const d of denials) {
+                if (!isRecord(d) || typeof d.tool_name !== 'string')
+                    continue;
+                const input = isRecord(d.tool_input) ? d.tool_input : {};
+                // The same refusal can repeat inside one turn; ask about it once.
+                if (!this.denials.some((x) => allowSpec(x) === allowSpec({ tool: d.tool_name, input }))) {
+                    this.denials.push({ tool: d.tool_name, input });
+                }
+            }
+        }
+        return [];
+    }
+    codexEvent(raw, v) {
+        readCodexEvents(raw, this.codex);
+        if (this.codex.thread_id !== null)
+            this.session = this.codex.thread_id;
+        if (v.type !== 'item.completed' || !isRecord(v.item))
+            return [];
+        const item = v.item;
+        if (item.type === 'agent_message' && typeof item.text === 'string' && item.text.trim() !== '')
+            return [item.text.trim()];
+        if (item.type === 'command_execution' && typeof item.command === 'string')
+            return [toolLine('Shell', { command: item.command })];
+        if (item.type === 'file_change' && Array.isArray(item.changes)) {
+            return item.changes.filter(isRecord).map((c) => toolLine('Edit', { path: c.path }));
+        }
+        return [];
+    }
+    /** How the turn ended. `exitCode` is the process's, for a turn that wrote no result. */
+    end(exitCode) {
+        let error = this.error;
+        if (this.harness === 'codex') {
+            error = this.codex.error;
+            const u = this.codex.usage;
+            if (this.codex.turns > 0)
+                this.tokens = u.input + u.output;
+            if (!this.codex.ended && error === null && exitCode !== 0)
+                error = `codex exited with code ${exitCode ?? 'signal'}`;
+        }
+        else if (!this.sawResult && exitCode !== 0) {
+            error = `claude exited with code ${exitCode ?? 'signal'}`;
+        }
+        return { session: this.session, costUsd: this.costUsd, tokens: this.tokens, denials: this.denials, error };
+    }
+}
+/**
+ * The `--allowedTools` rule that allows exactly what was refused: the command for
+ * Bash, else the tool by name (design D4).
+ */
+export function allowSpec(d) {
+    if (d.tool === 'Bash' && typeof d.input.command === 'string' && d.input.command.trim() !== '') {
+        return `Bash(${d.input.command.trim()})`;
+    }
+    return d.tool;
+}
+/** The question asked about a refused tool (aidlc-console/AC-23). */
+export function denialQuestion(d) {
+    return `The agent asked to use ${toolLine(d.tool, d.input).slice(2)} — allow it for this session?`;
+}
+/** Output kept per command for the agent: the end matters most (exit status, errors). */
+export const OUTPUT_KEEP = 4000;
+/**
+ * The message for a turn, with the console's command output since the last turn
+ * in front of it (aidlc-console/AC-22). Each output is cut to its last
+ * `OUTPUT_KEEP` characters.
+ */
+export function withPendingOutput(text, pending) {
+    if (pending.length === 0)
+        return text;
+    const blocks = pending.map((p) => {
+        const out = p.output.length > OUTPUT_KEEP ? `…(cut)\n${p.output.slice(-OUTPUT_KEEP)}` : p.output;
+        return `$ ${p.line}\n${out.trimEnd()}`;
+    });
+    return `The user ran these in the aidlc console since your last turn:\n\n\`\`\`\n${blocks.join('\n\n')}\n\`\`\`\n\n${text}`;
+}
+/** The default harness from autopilot setup's saved agent command (aidlc-console/AC-26). */
+export function defaultHarness(agentCommand) {
+    const program = agentCommand?.[0]?.split('/').pop();
+    return program === 'codex' ? 'codex' : 'claude-code';
+}
+/** The running-cost line after a turn (aidlc-console/AC-30). */
+export function costLine(costUsd, tokens) {
+    if (costUsd > 0)
+        return `session cost $${costUsd.toFixed(2)}`;
+    if (tokens > 0)
+        return `session tokens ${tokens.toLocaleString('en-US')}`;
+    return null;
+}
+//# sourceMappingURL=harness.js.map

package/dist/console/harness.js.map

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

package/dist/console/index.d.ts

@@ -0,0 +1,28 @@
+/**
+ * `openConsole` — what bare `aidlc` and `aidlc menu` open (aidlc-console/AC-1,
+ * aidlc-console/AC-2, aidlc-console/AC-3).
+ *
+ * Off a terminal it keeps the old menu's fallbacks exactly: help on stderr for
+ * bare `aidlc`, a one-line diagnostic for `aidlc menu`, exit 1 for both.
+ *
+ * @module
+ */
+import type { Command } from 'commander';
+import { type Prompter } from '../core/prompt.js';
+import { type MenuMode } from '../menu/index.js';
+/**
+ * The required positionals `argv` leaves out (aidlc-console/AC-14), or null when
+ * its first word is not a command (aidlc-console/AC-16). Words after the leaf that
+ * do not start with `-` count as given positionals; an option's value counts too,
+ * which can only under-ask, never ask for something already typed.
+ */
+export declare function missingArgs(program: Command, argv: readonly string[]): string[] | null;
+/**
+ * Run `aidlc <argv>` through a throwaway program (menu/dispatch.ts). False when
+ * commander refused it or the command set a non-zero exit code; the code is then
+ * cleared so leaving the console exits 0 (aidlc-console/AC-16).
+ */
+export declare function runCommand(makeProgram: () => Command, argv: readonly string[]): Promise<boolean>;
+/** Open the console, or print the non-interactive fallback (aidlc-console/AC-1..AC-3). */
+export declare function openConsole(makeProgram: () => Command, mode?: MenuMode, prompter?: Prompter): Promise<void>;
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/console/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAEH,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAOzC,OAAO,EAAmB,KAAK,QAAQ,EAAE,MAAM,mBAAmB,CAAC;AAEnE,OAAO,EAA+B,KAAK,QAAQ,EAAE,MAAM,kBAAkB,CAAC;AAQ9E;;;;;GAKG;AACH,wBAAgB,WAAW,CAAC,OAAO,EAAE,OAAO,EAAE,IAAI,EAAE,SAAS,MAAM,EAAE,GAAG,MAAM,EAAE,GAAG,IAAI,CAWtF;AAED;;;;GAIG;AACH,wBAAsB,UAAU,CAAC,WAAW,EAAE,MAAM,OAAO,EAAE,IAAI,EAAE,SAAS,MAAM,EAAE,GAAG,OAAO,CAAC,OAAO,CAAC,CAiBtG;AA6CD,0FAA0F;AAC1F,wBAAsB,WAAW,CAC/B,WAAW,EAAE,MAAM,OAAO,EAC1B,IAAI,GAAE,QAAiB,EACvB,QAAQ,GAAE,QAA0B,GACnC,OAAO,CAAC,IAAI,CAAC,CAuCf"}

package/dist/console/index.js

@@ -0,0 +1,154 @@
+/**
+ * `openConsole` — what bare `aidlc` and `aidlc menu` open (aidlc-console/AC-1,
+ * aidlc-console/AC-2, aidlc-console/AC-3).
+ *
+ * Off a terminal it keeps the old menu's fallbacks exactly: help on stderr for
+ * bare `aidlc`, a one-line diagnostic for `aidlc menu`, exit 1 for both.
+ *
+ * @module
+ */
+import { liveRun } from '../autopilot/run.js';
+import { loadConfig, loadState } from '../autopilot/state.js';
+import { fileReader } from '../autopilot/watch.js';
+import { approveCommand, forgetCommand, locate } from '../commands/autopilot.js';
+import { resolveProjectRoot } from '../core/project-root.js';
+import { defaultPrompter } from '../core/prompt.js';
+import { runEntry } from '../menu/dispatch.js';
+import { writeNonInteractiveFallback } from '../menu/index.js';
+import { requiredArgs } from '../menu/resolve.js';
+import { itemView } from './autopilot-view.js';
+import { defaultHarness } from './harness.js';
+import { runSession } from './session.js';
+import { latestVersion, realReaders, standingLines } from './standing.js';
+import { openShell, runShell, spawnTurn, terminalIO } from './terminal.js';
+/**
+ * The required positionals `argv` leaves out (aidlc-console/AC-14), or null when
+ * its first word is not a command (aidlc-console/AC-16). Words after the leaf that
+ * do not start with `-` count as given positionals; an option's value counts too,
+ * which can only under-ask, never ask for something already typed.
+ */
+export function missingArgs(program, argv) {
+    let cmd = program;
+    let i = 0;
+    for (; i < argv.length; i++) {
+        const child = cmd.commands.find((c) => c.name() === argv[i] || c.aliases().includes(argv[i]));
+        if (child === undefined)
+            break;
+        cmd = child;
+    }
+    if (cmd === program)
+        return null;
+    const given = argv.slice(i).filter((w) => !w.startsWith('-')).length;
+    return requiredArgs(cmd).slice(given).map((a) => a.name());
+}
+/**
+ * Run `aidlc <argv>` through a throwaway program (menu/dispatch.ts). False when
+ * commander refused it or the command set a non-zero exit code; the code is then
+ * cleared so leaving the console exits 0 (aidlc-console/AC-16).
+ */
+export async function runCommand(makeProgram, argv) {
+    process.exitCode = undefined;
+    // The command runs in this process, so Ctrl-C reaches only this process's handlers.
+    // A command cannot be cut short safely from outside; a second Ctrl-C leaves aidlc.
+    let presses = 0;
+    const onSigint = () => {
+        if (++presses === 1)
+            process.stderr.write('\n(Ctrl-C again leaves aidlc)\n');
+        else
+            process.exit(130);
+    };
+    process.on('SIGINT', onSigint);
+    try {
+        const r = await runEntry(makeProgram, ['node', 'aidlc', ...argv]);
+        return (r.ran || r.displayedHelp === true) && (process.exitCode ?? 0) === 0;
+    }
+    finally {
+        process.off('SIGINT', onSigint);
+        process.exitCode = undefined;
+    }
+}
+function autopilotAccess(projectRoot) {
+    let where = null;
+    try {
+        where = locate(projectRoot);
+    }
+    catch {
+        where = null;
+    }
+    if (where === null)
+        return { access: null, paths: null };
+    const p = where.paths;
+    let agentCommand;
+    try {
+        agentCommand = loadConfig(p)?.agent_command;
+    }
+    catch {
+        agentCommand = undefined;
+    }
+    return {
+        agentCommand,
+        paths: p,
+        access: {
+            items: () => loadState(p).items.map((i) => ({ view: itemView(fileReader.read, i), worktree: i.worktree, review: i.review })),
+            running: () => {
+                try {
+                    return liveRun(p) !== null;
+                }
+                catch {
+                    return false;
+                }
+            },
+            read: fileReader.read,
+            logs: p.logs,
+            approve: (name) => {
+                process.exitCode = undefined;
+                approveCommand(name);
+                process.exitCode = undefined;
+            },
+            forget: (name) => {
+                process.exitCode = undefined;
+                forgetCommand(name);
+                process.exitCode = undefined;
+            },
+        },
+    };
+}
+/** Open the console, or print the non-interactive fallback (aidlc-console/AC-1..AC-3). */
+export async function openConsole(makeProgram, mode = 'bare', prompter = defaultPrompter) {
+    const program = makeProgram();
+    if (!prompter.interactive()) {
+        writeNonInteractiveFallback(program, mode);
+        return;
+    }
+    const projectRoot = resolveProjectRoot();
+    const { access, paths, agentCommand } = autopilotAccess(projectRoot);
+    const readers = realReaders();
+    const deps = {
+        io: terminalIO(),
+        prompter,
+        version: program.version() ?? '',
+        harness: defaultHarness(agentCommand),
+        standing: (agent) => standingLines({ projectRoot, autopilot: paths, agent, now: Date.now() }, readers),
+        latestVersion: () => latestVersion(),
+        commandNames: () => program.commands.map((c) => c.name()),
+        missingArgs: (argv) => missingArgs(program, argv),
+        runCommand: (argv) => runCommand(makeProgram, argv),
+        spawnTurn: (argv, stdin, onLine) => spawnTurn(projectRoot, argv, stdin, onLine),
+        runShell: (cmd) => runShell(projectRoot, cmd),
+        openShell,
+        autopilot: access,
+    };
+    // Ctrl-C outside a prompt must not end the console: a turn handles its own, and
+    // a command or shell line gets the signal from the terminal directly.
+    const keepAlive = () => { };
+    process.on('SIGINT', keepAlive);
+    try {
+        await runSession(deps);
+    }
+    finally {
+        process.off('SIGINT', keepAlive);
+    }
+    // The version check may still be in flight; it must not hold the process open.
+    process.exit(process.exitCode ?? 0);
+}
+//# sourceMappingURL=index.js.map

package/dist/console/index.js.map

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

package/dist/console/route.d.ts

@@ -0,0 +1,45 @@
+/**
+ * What a console line means (aidlc-console/AC-10, aidlc-console/AC-12,
+ * aidlc-console/AC-13, aidlc-console/AC-17, aidlc-console/AC-18).
+ *
+ * Pure. A `/` prefix is a command, a `!` prefix a shell line, anything else goes
+ * to the agent — so "update the readme" can never run `update`.
+ *
+ * @module
+ */
+/** Commands the console answers itself; everything else after `/` is an `aidlc` command. */
+export declare const CONSOLE_COMMANDS: Readonly<Record<string, string>>;
+/** Console spellings that run a longer `aidlc` command path (aidlc-console/AC-12). */
+export declare const ALIASES: Readonly<Record<string, readonly string[]>>;
+export type Route = {
+    kind: 'blank';
+} | {
+    kind: 'shell';
+    cmd: string;
+} | {
+    kind: 'agent';
+    text: string;
+} | {
+    kind: 'console';
+    name: string;
+    args: string[];
+} | {
+    kind: 'command';
+    argv: string[];
+};
+/**
+ * Split a command line into words. Single and double quotes group; a backslash
+ * escapes the next character outside single quotes. No expansion of any kind —
+ * the words become argv elements, never shell input.
+ */
+export declare function splitWords(line: string): string[];
+/** Route one typed line (aidlc-console/AC-10). */
+export declare function routeLine(line: string): Route;
+/**
+ * Tab completion for a `/` command name (aidlc-console/AC-18). Only the first
+ * word completes; returns readline's `[matches, substring]` shape.
+ */
+export declare function completeSlash(line: string, names: readonly string[]): [string[], string];
+/** The `/help` listing: console commands, then the old menu's commands (aidlc-console/AC-13, AC-17). */
+export declare function helpLines(): string[];
+//# sourceMappingURL=route.d.ts.map

package/dist/console/route.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"route.d.ts","sourceRoot":"","sources":["../../src/console/route.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAIH,4FAA4F;AAC5F,eAAO,MAAM,gBAAgB,EAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAO7D,CAAC;AAEF,sFAAsF;AACtF,eAAO,MAAM,OAAO,EAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,SAAS,MAAM,EAAE,CAAC,CAE/D,CAAC;AAEF,MAAM,MAAM,KAAK,GACb;IAAE,IAAI,EAAE,OAAO,CAAA;CAAE,GACjB;IAAE,IAAI,EAAE,OAAO,CAAC;IAAC,GAAG,EAAE,MAAM,CAAA;CAAE,GAC9B;IAAE,IAAI,EAAE,OAAO,CAAC;IAAC,IAAI,EAAE,MAAM,CAAA;CAAE,GAC/B;IAAE,IAAI,EAAE,SAAS,CAAC;IAAC,IAAI,EAAE,MAAM,CAAC;IAAC,IAAI,EAAE,MAAM,EAAE,CAAA;CAAE,GACjD;IAAE,IAAI,EAAE,SAAS,CAAC;IAAC,IAAI,EAAE,MAAM,EAAE,CAAA;CAAE,CAAC;AAExC;;;;GAIG;AACH,wBAAgB,UAAU,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,EAAE,CA4BjD;AAED,kDAAkD;AAClD,wBAAgB,SAAS,CAAC,IAAI,EAAE,MAAM,GAAG,KAAK,CAiB7C;AAED;;;GAGG;AACH,wBAAgB,aAAa,CAAC,IAAI,EAAE,MAAM,EAAE,KAAK,EAAE,SAAS,MAAM,EAAE,GAAG,CAAC,MAAM,EAAE,EAAE,MAAM,CAAC,CAKxF;AAED,wGAAwG;AACxG,wBAAgB,SAAS,IAAI,MAAM,EAAE,CAcpC"}

package/dist/console/route.js

@@ -0,0 +1,118 @@
+/**
+ * What a console line means (aidlc-console/AC-10, aidlc-console/AC-12,
+ * aidlc-console/AC-13, aidlc-console/AC-17, aidlc-console/AC-18).
+ *
+ * Pure. A `/` prefix is a command, a `!` prefix a shell line, anything else goes
+ * to the agent — so "update the readme" can never run `update`.
+ *
+ * @module
+ */
+import { ROSTER } from '../menu/roster.js';
+/** Commands the console answers itself; everything else after `/` is an `aidlc` command. */
+export const CONSOLE_COMMANDS = {
+    help: 'List what you can type here',
+    watch: 'Show or hide the autopilot section (also Ctrl-T)',
+    agent: 'Show the agent, or switch: /agent claude-code | /agent codex',
+    new: 'Start a new agent session',
+    exit: 'Leave the console (also /quit, Ctrl-D)',
+    quit: 'Leave the console',
+};
+/** Console spellings that run a longer `aidlc` command path (aidlc-console/AC-12). */
+export const ALIASES = {
+    setup: ['autopilot', 'setup'],
+};
+/**
+ * Split a command line into words. Single and double quotes group; a backslash
+ * escapes the next character outside single quotes. No expansion of any kind —
+ * the words become argv elements, never shell input.
+ */
+export function splitWords(line) {
+    const words = [];
+    let word = '';
+    let inWord = false;
+    let quote = null;
+    for (let i = 0; i < line.length; i++) {
+        const c = line[i];
+        if (quote !== null) {
+            if (c === quote)
+                quote = null;
+            else if (c === '\\' && quote === '"' && i + 1 < line.length)
+                word += line[++i];
+            else
+                word += c;
+        }
+        else if (c === '"' || c === "'") {
+            quote = c;
+            inWord = true;
+        }
+        else if (c === '\\' && i + 1 < line.length) {
+            word += line[++i];
+            inWord = true;
+        }
+        else if (/\s/.test(c)) {
+            if (inWord)
+                words.push(word);
+            word = '';
+            inWord = false;
+        }
+        else {
+            word += c;
+            inWord = true;
+        }
+    }
+    if (inWord)
+        words.push(word);
+    return words;
+}
+/** Route one typed line (aidlc-console/AC-10). */
+export function routeLine(line) {
+    const text = line.trim();
+    if (text === '')
+        return { kind: 'blank' };
+    if (text.startsWith('!')) {
+        const cmd = text.slice(1).trim();
+        return cmd === '' ? { kind: 'blank' } : { kind: 'shell', cmd };
+    }
+    if (!text.startsWith('/'))
+        return { kind: 'agent', text };
+    const words = splitWords(text.slice(1));
+    const [name, ...args] = words;
+    // `/` alone is the discoverable way in (aidlc-console/AC-17).
+    if (name === undefined)
+        return { kind: 'console', name: 'help', args: [] };
+    if (name in CONSOLE_COMMANDS)
+        return { kind: 'console', name, args };
+    // `aidlc menu` opens this console; run from inside it, it would open a second one.
+    if (name === 'menu')
+        return { kind: 'console', name, args };
+    const alias = ALIASES[name];
+    return { kind: 'command', argv: alias ? [...alias, ...args] : [name, ...args] };
+}
+/**
+ * Tab completion for a `/` command name (aidlc-console/AC-18). Only the first
+ * word completes; returns readline's `[matches, substring]` shape.
+ */
+export function completeSlash(line, names) {
+    if (!line.startsWith('/') || /\s/.test(line))
+        return [[], line];
+    const all = [...new Set([...Object.keys(CONSOLE_COMMANDS), ...Object.keys(ALIASES), ...names])].sort();
+    const hits = all.filter((n) => `/${n}`.startsWith(line)).map((n) => `/${n}`);
+    return [hits, line];
+}
+/** The `/help` listing: console commands, then the old menu's commands (aidlc-console/AC-13, AC-17). */
+export function helpLines() {
+    const rows = [
+        ...Object.entries(CONSOLE_COMMANDS).filter(([n]) => n !== 'quit').map(([n, d]) => [`/${n}`, d]),
+        ['/setup', 'Set up autopilot (aidlc autopilot setup)'],
+        ...ROSTER.map((e) => [`/${e.path.join(' ')}`, e.label]),
+    ];
+    const width = Math.max(...rows.map(([c]) => c.length));
+    return [
+        'Type words to talk to the agent, /command to run aidlc, !command to run a shell command.',
+        '',
+        ...rows.map(([c, d]) => `  ${c.padEnd(width)}  ${d}`),
+        '',
+        'Any other aidlc command works too: /autopilot run, /roadmap next, /status --json …',
+    ];
+}
+//# sourceMappingURL=route.js.map

package/dist/console/route.js.map

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