aura-code 0.3.0

package/dist/cli/index.js

@@ -0,0 +1,1734 @@
+#!/usr/bin/env node
+"use strict";
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {
+    Object.defineProperty(o, "default", { enumerable: true, value: v });
+}) : function(o, v) {
+    o["default"] = v;
+});
+var __importStar = (this && this.__importStar) || (function () {
+    var ownKeys = function(o) {
+        ownKeys = Object.getOwnPropertyNames || function (o) {
+            var ar = [];
+            for (var k in o) if (Object.prototype.hasOwnProperty.call(o, k)) ar[ar.length] = k;
+            return ar;
+        };
+        return ownKeys(o);
+    };
+    return function (mod) {
+        if (mod && mod.__esModule) return mod;
+        var result = {};
+        if (mod != null) for (var k = ownKeys(mod), i = 0; i < k.length; i++) if (k[i] !== "default") __createBinding(result, mod, k[i]);
+        __setModuleDefault(result, mod);
+        return result;
+    };
+})();
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+const path = __importStar(require("path"));
+const readline = __importStar(require("readline"));
+const fs = __importStar(require("fs"));
+const minimist_1 = __importDefault(require("minimist"));
+const chalk_1 = __importDefault(require("chalk"));
+const factory_js_1 = require("../providers/factory.js");
+const resilient_factory_js_1 = require("../providers/resilient-factory.js");
+const context_js_1 = require("../agent/context.js");
+const index_js_1 = require("../viz/index.js");
+const loop_js_1 = require("../agent/loop.js");
+const permissions_js_1 = require("../safety/permissions.js");
+const display_js_1 = require("./display.js");
+const index_js_2 = require("../server/index.js");
+const project_config_js_1 = require("../config/project-config.js");
+const defaults_js_1 = require("../config/defaults.js");
+const session_store_js_1 = require("../agent/session-store.js");
+const global_config_js_1 = require("../setup/global-config.js");
+const first_run_js_1 = require("../setup/first-run.js");
+const index_js_3 = require("../orchestration/index.js");
+const index_js_4 = require("../perception/index.js");
+const weakness_miner_js_1 = require("../harness/weakness-miner.js");
+const proposer_js_1 = require("../harness/proposer.js");
+const engine_js_1 = require("../workflows/engine.js");
+const engine_js_2 = require("../architect/engine.js");
+const diamond_js_1 = require("./diamond.js");
+const episode_capture_js_1 = require("../ruby/episode-capture.js");
+// ─────────────────────────────────────────────────────────────────────────────
+// Parse args
+// ─────────────────────────────────────────────────────────────────────────────
+const argv = (0, minimist_1.default)(process.argv.slice(2), {
+    string: ['model', 'm', 'api-key', 'base-url', 'mode', 'cwd', 'rate-limit-rpm', 'rate-limit-tpm', 'max-retries', 'max-verify-retries', 'max-turns', 'fallback', 'resume', 'chat-id', 'profile', 'test-command', 'workflow', 'resume-workflow', 'workflow-name', 'apply-harness', 'blueprint', 'build'],
+    boolean: ['help', 'h', 'version', 'v', 'auto', 'readonly', 'models', 'no-session', 'no-setup', 'reset-setup', 'orchestrate', 'plan', 'architect', 'list-sessions', 'new-session', 'verify', 'analyze', 'workflows', 'propose-harness', 'blueprints', 'once'],
+    alias: { m: 'model', h: 'help', v: 'version' },
+    default: {
+        model: process.env.AURA_MODEL,
+        mode: 'normal',
+    },
+});
+function num(s) {
+    if (s === undefined || s === null || s === '')
+        return undefined;
+    const n = Number(s);
+    return Number.isFinite(n) ? n : undefined;
+}
+const cliMaxRetries = num(argv['max-retries']) ?? num(process.env.AURA_MAX_RETRIES);
+const cliMaxVerifyRetries = num(argv['max-verify-retries']);
+const cliMaxTurns = num(argv['max-turns']);
+const cliVerify = argv.verify === true;
+const cliProfile = typeof argv.profile === 'string' ? argv.profile : undefined;
+const cliTestCommand = typeof argv['test-command'] === 'string' ? argv['test-command'] : undefined;
+const cliRpm = num(argv['rate-limit-rpm']) ?? num(process.env.AURA_API_RPM);
+const cliTpm = num(argv['rate-limit-tpm']) ?? num(process.env.AURA_API_TPM);
+const cliFallbacks = Array.isArray(argv.fallback)
+    ? argv.fallback.map(String)
+    : typeof argv.fallback === 'string'
+        ? [argv.fallback]
+        : process.env.AURA_FALLBACK_MODEL
+            ? [process.env.AURA_FALLBACK_MODEL]
+            : [...defaults_js_1.FALLBACK_CHAIN];
+// ─────────────────────────────────────────────────────────────────────────────
+// Help / version
+// ─────────────────────────────────────────────────────────────────────────────
+if (argv.version) {
+    const pkg = JSON.parse(fs.readFileSync(path.join(__dirname, '../../package.json'), 'utf8'));
+    console.log(`Aura v${pkg.version}`);
+    process.exit(0);
+}
+if (argv.models) {
+    console.log('\n' + chalk_1.default.hex('#cc785c').bold('  Supported models:\n'));
+    const allModels = (0, factory_js_1.getAllModels)();
+    const byProvider = allModels.reduce((acc, m) => {
+        (acc[m.provider] ??= []).push(m);
+        return acc;
+    }, {});
+    for (const [provider, models] of Object.entries(byProvider)) {
+        console.log(chalk_1.default.hex('#8a7768')(`  ${provider}`));
+        for (const m of models) {
+            console.log(`    ${chalk_1.default.hex('#cc785c')(m.id.padEnd(45))} ${chalk_1.default.hex('#4e3d30')(m.speed)}`);
+        }
+    }
+    console.log(chalk_1.default.hex('#4e3d30')('\n  Use --model <id> or set AURA_MODEL env var'));
+    console.log(chalk_1.default.hex('#4e3d30')('  For Ollama: --model ollama/llama3.2'));
+    console.log(chalk_1.default.hex('#4e3d30')('  For OpenRouter: --model openrouter/<provider>/<name>\n'));
+    process.exit(0);
+}
+if (argv['list-sessions']) {
+    const root = argv.cwd ? path.resolve(argv.cwd) : process.cwd();
+    const sessions = session_store_js_1.sessionStore.listSessions(root);
+    if (sessions.length === 0) {
+        console.log(chalk_1.default.hex('#8a7768')('\n  No saved sessions for this project.\n'));
+    }
+    else {
+        console.log(chalk_1.default.hex('#cc785c').bold('\n  Saved sessions:\n'));
+        for (const s of sessions) {
+            const updated = new Date(s.updatedAt).toLocaleString();
+            const turns = Math.floor(s.history.length / 2);
+            console.log(`  ${chalk_1.default.hex('#cc785c')(s.id.padEnd(20))} ` +
+                `${chalk_1.default.hex('#ede0cc')(s.title.slice(0, 45).padEnd(46))} ` +
+                `${chalk_1.default.hex('#4e3d30')(`${turns}t · ${updated}`)}`);
+        }
+        console.log();
+    }
+    process.exit(0);
+}
+if (argv.analyze) {
+    const report = (0, weakness_miner_js_1.mineWeaknesses)();
+    const outPath = (0, weakness_miner_js_1.saveReport)(report);
+    console.log(chalk_1.default.hex('#cc785c').bold('\n  Weakness Analysis Report\n'));
+    console.log(chalk_1.default.hex('#8a7768')(`  Sessions analyzed: ${report.sessionsAnalyzed}`));
+    console.log(chalk_1.default.hex('#8a7768')(`  Report saved to: ${outPath}\n`));
+    if (report.patterns.length === 0) {
+        console.log(chalk_1.default.hex('#5a9e6e')('  ✓ No recurring weakness patterns detected. Agent behavior looks healthy.\n'));
+    }
+    else {
+        for (const p of report.patterns) {
+            console.log(chalk_1.default.hex('#b15439').bold(`  ✗ ${p.pattern} (${p.frequency} occurrences)`));
+            console.log(chalk_1.default.hex('#8a7768')(`    ${p.description}`));
+            if (p.occurrences[0]) {
+                console.log(chalk_1.default.hex('#4e3d30')(`    Example task: "${p.occurrences[0].exampleTask.slice(0, 80)}"`));
+                console.log(chalk_1.default.hex('#4e3d30')(`    Example failure: ${p.occurrences[0].exampleFailure.slice(0, 100)}`));
+            }
+            console.log(chalk_1.default.hex('#cc785c')(`    Suggestion: ${p.promptPatch.slice(0, 120)}...`));
+            console.log();
+        }
+        console.log(chalk_1.default.hex('#8a7768')(`  ${report.summary}\n`));
+    }
+    process.exit(0);
+}
+if (argv['propose-harness']) {
+    // Ensure a weakness report exists — mine if needed
+    if (!fs.existsSync((0, weakness_miner_js_1.reportPath)())) {
+        console.log(chalk_1.default.hex('#8a7768')('\n  No weakness report found — mining sessions first...\n'));
+        const report = (0, weakness_miner_js_1.mineWeaknesses)();
+        (0, weakness_miner_js_1.saveReport)(report);
+    }
+    const proposals = (0, proposer_js_1.generateProposals)();
+    if (proposals.length === 0) {
+        console.log(chalk_1.default.hex('#5a9e6e')('\n  ✓ No proposals generated — no actionable weakness patterns found.\n'));
+    }
+    else {
+        console.log(chalk_1.default.hex('#cc785c').bold('\n  Harness Proposals\n'));
+        for (const p of proposals) {
+            console.log(chalk_1.default.hex('#cc785c')(`  ${p.id}`));
+            console.log(chalk_1.default.hex('#8a7768')(`    Pattern:  ${p.pattern} (${p.description.slice(0, 60)})`));
+            console.log(chalk_1.default.hex('#8a7768')(`    Section:  ${p.targetSection}`));
+            console.log(chalk_1.default.hex('#4e3d30')(`    Patch:    ${p.patchText.slice(0, 80)}...`));
+            console.log();
+        }
+        console.log(chalk_1.default.hex('#5a9e6e')(`  ${proposals.length} proposal(s) saved to ~/.aura/harness/proposals/`));
+        console.log(chalk_1.default.hex('#8a7768')('  Apply with: ruby --apply-harness <id>\n'));
+    }
+    process.exit(0);
+}
+if (typeof argv['apply-harness'] === 'string' && argv['apply-harness']) {
+    const proposalId = argv['apply-harness'];
+    console.log(chalk_1.default.hex('#cc785c').bold(`\n  Applying harness proposal: ${proposalId}\n`));
+    const result = (0, proposer_js_1.applyHarnessProposal)(proposalId);
+    if (result.success) {
+        console.log(chalk_1.default.hex('#5a9e6e')(`  ✓ ${result.message}\n`));
+    }
+    else {
+        console.log(chalk_1.default.hex('#b15439')(`  ✗ ${result.message}\n`));
+    }
+    process.exit(result.success ? 0 : 1);
+}
+// ── --workflows: list all persisted workflows ────────────────────────────────
+if (argv.workflows) {
+    (async () => {
+        const workflows = await (0, engine_js_1.listWorkflows)();
+        if (workflows.length === 0) {
+            console.log(chalk_1.default.hex('#8a7768')('\n  No saved workflows.\n'));
+        }
+        else {
+            console.log(chalk_1.default.hex('#cc785c').bold('\n  Saved workflows:\n'));
+            for (const ws of workflows) {
+                const created = new Date(ws.definition.createdAt).toLocaleString();
+                const doneSteps = ws.stepStates.filter(s => s.status === 'done').length;
+                const totalSteps = ws.definition.steps.length;
+                const statusColor = ws.status === 'done' ? '#5a9e6e' : ws.status === 'failed' ? '#b15439' : '#cc785c';
+                console.log(`  ${chalk_1.default.hex('#cc785c')(ws.definition.id.padEnd(24))} ` +
+                    `${chalk_1.default.hex('#ede0cc')(ws.definition.name.slice(0, 36).padEnd(37))} ` +
+                    `${chalk_1.default.hex(statusColor)(ws.status.padEnd(8))} ` +
+                    `${chalk_1.default.hex('#4e3d30')(`${doneSteps}/${totalSteps} steps · ${created}`)}`);
+            }
+            console.log();
+        }
+        process.exit(0);
+    })();
+}
+// ── --blueprints: list all saved blueprints ──────────────────────────────────
+if (argv.blueprints) {
+    (async () => {
+        const bps = await (0, engine_js_2.listBlueprints)();
+        if (bps.length === 0) {
+            console.log(chalk_1.default.hex('#8a7768')('\n  No saved blueprints.\n'));
+        }
+        else {
+            console.log(chalk_1.default.hex('#cc785c').bold('\n  Saved blueprints:\n'));
+            for (const bp of bps) {
+                const created = new Date(bp.createdAt).toLocaleString();
+                const builtCount = bp.files.filter(f => f.status === 'built').length;
+                const totalFiles = bp.files.length;
+                const statusColor = bp.status === 'complete' ? '#5a9e6e' : bp.status === 'building' ? '#cc9e5c' : '#cc785c';
+                console.log(`  ${chalk_1.default.hex(statusColor)(bp.status.padEnd(10))} ` +
+                    `${chalk_1.default.hex('#cc785c')(bp.id.slice(0, 16).padEnd(18))} ` +
+                    `${chalk_1.default.hex('#ede0cc')(bp.task.slice(0, 40).padEnd(41))} ` +
+                    `${chalk_1.default.hex('#4e3d30')(`${builtCount}/${totalFiles} files · ${created}`)}`);
+            }
+            console.log();
+        }
+        process.exit(0);
+    })();
+}
+// ── --blueprint <id>: show a saved blueprint ────────────────────────────────
+if (typeof argv.blueprint === 'string' && argv.blueprint) {
+    (async () => {
+        const bp = await (0, engine_js_2.loadBlueprint)(argv.blueprint);
+        if (!bp) {
+            console.error(chalk_1.default.hex('#b15439')(`\n  ✗ Blueprint not found: ${argv.blueprint}\n`));
+            process.exit(1);
+        }
+        const statusColor = bp.status === 'complete' ? '#5a9e6e' : bp.status === 'building' ? '#cc9e5c' : '#cc785c';
+        console.log(chalk_1.default.hex('#cc785c').bold('\n  Blueprint\n'));
+        console.log(`  ${chalk_1.default.hex('#8a7768')('ID:')}      ${chalk_1.default.hex('#cc785c')(bp.id)}`);
+        console.log(`  ${chalk_1.default.hex('#8a7768')('Task:')}    ${chalk_1.default.hex('#ede0cc')(bp.task)}`);
+        console.log(`  ${chalk_1.default.hex('#8a7768')('Status:')}  ${chalk_1.default.hex(statusColor)(bp.status)}`);
+        console.log(`  ${chalk_1.default.hex('#8a7768')('Steps:')}   ${bp.estimatedSteps}`);
+        console.log(`  ${chalk_1.default.hex('#8a7768')('Created:')} ${new Date(bp.createdAt).toLocaleString()}`);
+        if (bp.builtAt)
+            console.log(`  ${chalk_1.default.hex('#8a7768')('Built:')}   ${new Date(bp.builtAt).toLocaleString()}`);
+        if (bp.files.length > 0) {
+            console.log(chalk_1.default.hex('#cc785c').bold('\n  Files:\n'));
+            for (const f of bp.files) {
+                const fileStatusColor = f.status === 'built' ? '#5a9e6e' : f.status === 'skipped' ? '#8a7768' : '#cc785c';
+                console.log(`    ${chalk_1.default.hex(fileStatusColor)(f.status.padEnd(8))} ${chalk_1.default.hex('#cc785c')(f.path)}`);
+                console.log(`            ${chalk_1.default.hex('#8a7768')(f.purpose)}`);
+                if (f.exports.length > 0) {
+                    console.log(`            ${chalk_1.default.hex('#4e3d30')(`exports: ${f.exports.join(', ')}`)}`);
+                }
+                if (f.interfaces.length > 0) {
+                    console.log(`            ${chalk_1.default.hex('#4e3d30')(`interfaces: ${f.interfaces.join(', ')}`)}`);
+                }
+            }
+        }
+        if (bp.dataModels.length > 0) {
+            console.log(chalk_1.default.hex('#cc785c').bold('\n  Data Models:\n'));
+            for (const dm of bp.dataModels) {
+                console.log(`    ${chalk_1.default.hex('#cc785c')(dm.name)} — ${chalk_1.default.hex('#8a7768')(dm.description)}`);
+                for (const field of dm.fields) {
+                    console.log(`      ${chalk_1.default.hex('#4e3d30')(field)}`);
+                }
+            }
+        }
+        if (bp.dependencies.length > 0) {
+            console.log(chalk_1.default.hex('#cc785c').bold('\n  Dependencies:\n'));
+            for (const dep of bp.dependencies) {
+                console.log(`    ${chalk_1.default.hex('#4e3d30')(dep)}`);
+            }
+        }
+        if (bp.risks.length > 0) {
+            console.log(chalk_1.default.hex('#b15439').bold('\n  Risks:\n'));
+            for (const risk of bp.risks) {
+                console.log(`    ${chalk_1.default.hex('#b15439')('⚠')} ${chalk_1.default.hex('#8a7768')(risk)}`);
+            }
+        }
+        if (bp.deviations.length > 0) {
+            console.log(chalk_1.default.hex('#cc9e5c').bold('\n  Deviations:\n'));
+            for (const dev of bp.deviations) {
+                const time = new Date(dev.recordedAt).toLocaleString();
+                console.log(`    ${chalk_1.default.hex('#cc9e5c')('→')} ${chalk_1.default.hex('#8a7768')(dev.description)} ${chalk_1.default.hex('#4e3d30')(`(${time})`)}`);
+            }
+        }
+        console.log();
+        process.exit(0);
+    })();
+}
+if (argv.help) {
+    printHelp();
+    process.exit(0);
+}
+// When run with no args and nothing in stdin, show help then exit.
+// When run with no args + a TTY or piped input, fall through to the REPL/wizard.
+// Skip this gate when --reset-setup is set (the wizard should fire even if env
+// vars make needsWizard() return false).
+if (argv._.length === 0 && !argv.interactive && process.stdin.isTTY !== true && !argv['reset-setup']) {
+    if (!(0, first_run_js_1.needsWizard)({})) {
+        printHelp();
+        process.exit(0);
+    }
+}
+// ─────────────────────────────────────────────────────────────────────────────
+// Resolve config — CLI > .aura.json > global config > first-run wizard
+// ─────────────────────────────────────────────────────────────────────────────
+const cwd = argv.cwd ? path.resolve(argv.cwd) : process.cwd();
+const fileConfig = (0, project_config_js_1.loadProjectConfig)(cwd);
+// Pull global config (saved by the first-run wizard) so the user doesn't have
+// to re-set their provider on every run.
+const globalCfg = (0, global_config_js_1.loadGlobalConfig)();
+// Effective model = CLI > AURA_MODEL env > .aura.json > global config > undefined
+const cliModel = typeof argv.model === 'string' ? argv.model : undefined;
+const effectiveModel = cliModel ?? fileConfig.model ?? globalCfg?.defaultModel ?? process.env.AURA_MODEL;
+// Effective base URL = CLI > .aura.json > global config > undefined
+const cliBaseUrl = typeof argv['base-url'] === 'string' ? argv['base-url'] : undefined;
+const effectiveBaseUrl = cliBaseUrl ?? fileConfig.baseUrl ?? globalCfg?.baseUrl;
+const resolved = (0, project_config_js_1.resolveConfig)({ ...fileConfig, model: effectiveModel, baseUrl: effectiveBaseUrl }, {
+    model: cliModel,
+    baseUrl: cliBaseUrl,
+    auto: argv.auto === true,
+    readonly: argv.readonly === true,
+    maxTurns: cliMaxTurns,
+    rateLimitRpm: cliRpm,
+    rateLimitTpm: cliTpm,
+    maxRetries: cliMaxRetries,
+    fallbacks: cliFallbacks.length > 0 ? cliFallbacks : undefined,
+}, { model: undefined, mode: 'normal', ignore: [] });
+// Register custom providers from .aura.json
+(0, factory_js_1.registerCustomProviders)(resolved.providers);
+const permissionLevel = resolved.mode;
+// Mutable runtime state — :model command updates this
+const runtimeConfig = {
+    model: resolved.model,
+    baseUrl: resolved.baseUrl,
+    apiKey: typeof argv['api-key'] === 'string' ? argv['api-key'] : undefined,
+};
+// ── Profile: local → Ollama defaults ─────────────────────────────────────────
+if (cliProfile === 'local') {
+    resolved.baseUrl = 'http://localhost:11434/v1';
+    if (!runtimeConfig.apiKey) {
+        runtimeConfig.apiKey = 'ollama';
+    }
+}
+function buildProvider(display) {
+    // Use runtimeConfig.model (mutable via :model command) falling back to resolved.model.
+    const model = runtimeConfig.model ?? resolved.model;
+    // Keep resolved in sync so external reads (e.g. header display) reflect the switch.
+    resolved.model = model;
+    return (0, resilient_factory_js_1.createResilientProvider)({
+        model,
+        apiKey: runtimeConfig.apiKey,
+        baseUrl: runtimeConfig.baseUrl ?? undefined,
+    }, {
+        rpm: resolved.rateLimitRpm,
+        tpm: resolved.rateLimitTpm,
+        maxRetries: resolved.maxRetries,
+        fallbacks: resolved.fallbacks,
+    }, display);
+}
+// ─────────────────────────────────────────────────────────────────────────────
+// Main
+// ─────────────────────────────────────────────────────────────────────────────
+async function main() {
+    (0, diamond_js_1.renderDiamond)();
+    await new Promise(r => setTimeout(r, 1500));
+    process.stdout.write('\x1b[2J\x1b[H');
+    const display = (0, display_js_1.createTerminalDisplay)();
+    // ── First-run wizard ───────────────────────────────────────────────────────
+    // Skip if: --no-setup flag, --api-key on CLI, env var set, or global config exists.
+    // Non-interactive modes (one-shot, --models, --help) skip the wizard too.
+    // Wizard only fires when we're in an interactive terminal (TTY + no other args).
+    // Wizard is eligible when there are no other args (no one-shot task) AND
+    // we're not in a strict TTY-less script context. Accept both TTY and pipe:
+    //   - TTY = real interactive use
+    //   - pipe = test harnesses (and `aura | tee log`)
+    // The one-shot path (`aura "task"`) has argv._.length > 0 so the
+    // wizard can't fire there. --reset-setup alone is treated as interactive
+    // since the whole point is to launch the wizard.
+    const isInteractive = argv.interactive === true
+        || process.argv.slice(2).length === 0
+        || argv['reset-setup'] === true;
+    const cliApiKey = typeof argv['api-key'] === 'string' ? argv['api-key'] : undefined;
+    const cliModel = typeof argv.model === 'string' ? argv.model : undefined;
+    const skipSetup = argv['no-setup'] === true || argv.help === true || argv.h === true || argv.models === true || argv.version === true || argv.v === true;
+    const resetSetup = argv['reset-setup'] === true;
+    if (resetSetup) {
+        // Wipe global config so the wizard fires unconditionally.
+        try {
+            fs.unlinkSync((0, global_config_js_1.globalConfigPath)());
+        }
+        catch { /* not present */ }
+    }
+    // When --reset-setup is set, force the wizard to fire (overrides env-var
+    // detection — the user explicitly wants to reconfigure).
+    const shouldRunWizard = !skipSetup && isInteractive && (resetSetup || (0, first_run_js_1.needsWizard)({ cliApiKey, cliModel }));
+    if (shouldRunWizard) {
+        // If stdin is not a TTY and there's nothing piped in, the wizard will
+        // hang. Skip with a helpful message instead.
+        if (process.stdin.isTTY !== true && !process.stdin.readable) {
+            console.error(chalk_1.default.hex('#b15439')('\n  ✗ No interactive input available.'));
+            console.error(chalk_1.default.hex('#8a7768')('  Set an API key env var (e.g. export OPENAI_API_KEY=...)'));
+            console.error(chalk_1.default.hex('#8a7768')('  or pass --api-key <key> --model <id> on the command line,\n'));
+            process.exit(1);
+        }
+        const cfg = await (0, first_run_js_1.runFirstRunWizard)();
+        if (!cfg) {
+            console.error(chalk_1.default.hex('#b15439')('\n  ✗ Setup cancelled. Set an API key env var (e.g. export OPENAI_API_KEY=...) or run with --api-key.\n'));
+            process.exit(1);
+        }
+        // Re-resolve with the new global config
+        const fresh = (0, global_config_js_1.loadGlobalConfig)();
+        if (fresh) {
+            resolved.model = fresh.defaultModel;
+            resolved.baseUrl = fresh.baseUrl;
+            runtimeConfig.model = fresh.defaultModel;
+            runtimeConfig.baseUrl = fresh.baseUrl;
+        }
+    }
+    let ctx;
+    try {
+        ctx = await (0, context_js_1.loadProjectContext)(cwd);
+    }
+    catch (e) {
+        display.error(`Could not load project context: ${String(e)}`);
+        process.exit(1);
+    }
+    // ── Guard: we need a model before we can build a provider ─────────────────
+    if (!resolved.model) {
+        console.error(chalk_1.default.hex('#b15439')('\n  ✗ No model configured.'));
+        console.error(chalk_1.default.hex('#8a7768')('  Run `aura` with no args in a TTY to launch the setup wizard,'));
+        console.error(chalk_1.default.hex('#8a7768')('  or pass --model <id> --api-key <key> on the command line,'));
+        console.error(chalk_1.default.hex('#8a7768')('  or set the model in .aura.json (`"model": "..."`).'));
+        process.exit(1);
+    }
+    let provider;
+    try {
+        provider = buildProvider(display);
+    }
+    catch (e) {
+        display.error(`Could not initialize provider: ${String(e)}`);
+        process.exit(1);
+    }
+    const permissions = new permissions_js_1.PermissionSystem(permissionLevel);
+    // ── Session / chat-ID resolution ───────────────────────────────────────────
+    const noSession = argv['no-session'] === true;
+    const projectRoot = ctx.root || cwd;
+    // Active session state (mutable — commands can swap it)
+    let activeChatId;
+    let activeChatHistory = [];
+    let activeChatTitle;
+    if (!noSession) {
+        if (argv['new-session']) {
+            // Force a brand-new session
+            activeChatId = session_store_js_1.sessionStore.generateId();
+        }
+        else if (typeof argv['resume'] === 'string' && argv['resume']) {
+            // --resume <id>
+            const loaded = await session_store_js_1.sessionStore.loadSession(projectRoot, argv['resume']);
+            if (!loaded) {
+                console.error(chalk_1.default.hex('#b15439')(`\n  ✗ Session not found: ${argv['resume']}\n`));
+                process.exit(1);
+            }
+            activeChatId = loaded.id;
+            activeChatHistory = loaded.history;
+            activeChatTitle = loaded.title;
+            console.log(chalk_1.default.hex('#5a9e6e')(`\n  ↩ Resuming session ${loaded.id} — "${loaded.title}" (${Math.floor(loaded.history.length / 2)} turns)\n`));
+        }
+        else if (argv['resume'] === true || argv['resume'] === '') {
+            // --resume with no value → resume latest
+            const latest = session_store_js_1.sessionStore.findLatestSession(projectRoot);
+            if (latest) {
+                activeChatId = latest.id;
+                activeChatHistory = latest.history;
+                activeChatTitle = latest.title;
+                console.log(chalk_1.default.hex('#5a9e6e')(`\n  ↩ Resuming latest session ${latest.id} — "${latest.title}" (${Math.floor(latest.history.length / 2)} turns)\n`));
+            }
+            else {
+                activeChatId = session_store_js_1.sessionStore.generateId();
+            }
+        }
+        else if (typeof argv['chat-id'] === 'string' && argv['chat-id']) {
+            activeChatId = argv['chat-id'];
+            const existing = await session_store_js_1.sessionStore.loadSession(projectRoot, activeChatId);
+            if (existing) {
+                activeChatHistory = existing.history;
+                activeChatTitle = existing.title;
+            }
+        }
+        else {
+            activeChatId = session_store_js_1.sessionStore.generateId();
+        }
+    }
+    // Legacy sessionPath kept for single-task one-shot mode
+    const sessionPath = noSession ? undefined : path.join(session_store_js_1.sessionStore.defaultDir(), projectRoot.replace(/[^a-zA-Z0-9_-]/g, '_').slice(0, 80), 'latest.json');
+    // ── ASCII art banner ────────────────────────────────────────────────────────
+    const orange = chalk_1.default.hex('#E8771A');
+    const pink1 = chalk_1.default.hex('#F5715B'); // Smooth transition step
+    const pink2 = chalk_1.default.hex('#FF6B9D');
+    const red1 = chalk_1.default.hex('#E64A69'); // Smooth transition step
+    const red2 = chalk_1.default.hex('#CC2936');
+    if ((process.stdout.columns ?? 80) < 80) {
+        console.log(chalk_1.default.hex('#CC2936').bold('AURA CODE'));
+    }
+    else {
+        console.log('');
+        console.log(orange('  █████╗ ██╗   ██╗██████╗  █████╗      ██████╗ ██████╗ ██████╗ ███████╗'));
+        console.log(pink1(' ██╔══██╗██║   ██║██╔══██╗██╔══██╗    ██╔════╝██╔═══██╗██╔══██╗██╔════╝'));
+        console.log(pink2(' ███████║██║   ██║██████╔╝███████║    ██║     ██║   ██║██║  ██║█████╗  '));
+        console.log(red1(' ██╔══██║██║   ██║██╔══██╗██╔══██║    ██║     ██║   ██║██║  ██║██╔══╝  '));
+        console.log(red2(' ██║  ██║╚██████╔╝██║  ██║██║  ██║    ╚██████╗╚██████╔╝██████╔╝███████╗'));
+        console.log(red2(' ╚═╝  ╚═╝ ╚═════╝ ╚═╝  ╚═╝╚═╝  ╚═╝     ╚═════╝ ╚═════╝ ╚═════╝ ╚══════╝'));
+        console.log('');
+        console.log(chalk_1.default.hex('#4e3d30')('  "I don\'t try. I verify."'));
+        console.log('');
+    }
+    console.log('');
+    await new Promise(r => setTimeout(r, 50));
+    display.header(`Aura — ${ctx.name}`, `${provider.name} · ${runtimeConfig.model} · ${ctx.language} · ${permissionLevel} mode` +
+        (fileConfig.model ? ` · .aura.json loaded` : '') +
+        (activeChatId ? ` · chat ${activeChatId}` : ''));
+    const cumulative = { turns: 0, toolCalls: 0, inputTokens: 0, outputTokens: 0, costUsd: 0 };
+    // ── --build <id>: build from a saved blueprint in dependency order ───────────
+    if (typeof argv.build === 'string' && argv.build) {
+        const bp = await (0, engine_js_2.loadBlueprint)(argv.build);
+        if (!bp) {
+            console.error(chalk_1.default.hex('#b15439')(`\n  ✗ Blueprint not found: ${argv.build}\n`));
+            process.exit(1);
+        }
+        display.header('Architect Builder', `Building from blueprint: ${bp.id}`);
+        console.log(chalk_1.default.hex('#8a7768')(`  Task: ${bp.task}`));
+        console.log(chalk_1.default.hex('#8a7768')(`  Files: ${bp.files.filter(f => f.status === 'planned').length} to build\n`));
+        await (0, engine_js_2.updateBlueprintStatus)(bp.id, 'building');
+        // Build files in order — planned files only
+        const plannedFiles = bp.files.filter(f => f.status === 'planned');
+        for (const file of plannedFiles) {
+            console.log(chalk_1.default.hex('#cc785c')(`  ▸ Building: ${file.path} — ${file.purpose}`));
+            const buildTask = [
+                `Create the file ${file.path}.`,
+                `Purpose: ${file.purpose}`,
+                file.exports.length > 0 ? `Exports: ${file.exports.join(', ')}` : '',
+                file.interfaces.length > 0 ? `Interfaces: ${file.interfaces.join(', ')}` : '',
+                `This file is part of a larger blueprint for: ${bp.task}`,
+                bp.dependencies.length > 0 ? `Dependencies: ${bp.dependencies.join(', ')}` : '',
+                'Follow the existing code style. Do not modify other files.',
+            ].filter(Boolean).join('\n');
+            try {
+                const result = await (0, loop_js_1.runAgentLoop)({
+                    provider, task: buildTask, context: ctx, permissions, display,
+                    initialHistory: [],
+                    maxTurns: Math.min(resolved.maxTurns ?? 50, 50),
+                    spawnConfig: {
+                        apiKey: runtimeConfig.apiKey,
+                        baseUrl: runtimeConfig.baseUrl ?? undefined,
+                    },
+                });
+                if (result.success) {
+                    await (0, engine_js_2.markBuilt)(bp.id, file.path);
+                    console.log(chalk_1.default.hex('#5a9e6e')(`  ✓ ${file.path} built\n`));
+                }
+                else {
+                    console.log(chalk_1.default.hex('#b15439')(`  ✗ ${file.path} failed: ${result.summary}\n`));
+                    await (0, engine_js_2.addDeviation)(bp.id, `Failed to build ${file.path}: ${result.summary}`);
+                }
+            }
+            catch (e) {
+                console.log(chalk_1.default.hex('#b15439')(`  ✗ ${file.path} error: ${String(e)}\n`));
+                await (0, engine_js_2.addDeviation)(bp.id, `Error building ${file.path}: ${String(e)}`);
+            }
+        }
+        // Final status
+        const finalBp = await (0, engine_js_2.loadBlueprint)(bp.id);
+        if (finalBp) {
+            const allBuilt = finalBp.files.every(f => f.status !== 'planned');
+            if (allBuilt) {
+                await (0, engine_js_2.updateBlueprintStatus)(bp.id, 'complete');
+                console.log(chalk_1.default.hex('#5a9e6e').bold(`\n  ✓ Blueprint complete: ${finalBp.files.filter(f => f.status === 'built').length} files built\n`));
+            }
+            else {
+                console.log(chalk_1.default.hex('#cc9e5c').bold(`\n  ⚠ Blueprint partially complete: ${finalBp.files.filter(f => f.status === 'built').length}/${finalBp.files.length} files built\n`));
+            }
+        }
+        return;
+    }
+    // ── --workflow: create and run a new workflow ──────────────────────────────
+    if (typeof argv.workflow === 'string' && argv.workflow) {
+        const workflowName = argv.workflow;
+        const stepTasks = argv._.map(String);
+        if (stepTasks.length === 0) {
+            console.error(chalk_1.default.hex('#b15439')('\n  ✗ No step tasks provided.'));
+            console.error(chalk_1.default.hex('#8a7768')('  Usage: ruby --workflow <name> "step 1" "step 2" ...\n'));
+            process.exit(1);
+        }
+        const steps = stepTasks.map((task, i) => ({
+            name: `step-${i + 1}`,
+            task,
+        }));
+        display.header('Workflow', `Creating workflow "${workflowName}" with ${steps.length} steps`);
+        const state = await (0, engine_js_1.createWorkflow)({ name: workflowName, steps });
+        console.log(chalk_1.default.hex('#5a9e6e')(`\n  ✓ Workflow created: ${state.definition.id}\n`));
+        const makeRunStep = () => {
+            return async (task, stepIndex) => {
+                console.log(chalk_1.default.hex('#cc785c')(`\n  ▸ Step ${stepIndex + 1}/${steps.length}: ${task}\n`));
+                const currentProvider = buildProvider(display);
+                const result = await (0, loop_js_1.runAgentLoop)({
+                    provider: currentProvider, task, context: ctx, permissions, display,
+                    initialHistory: [],
+                    maxTurns: resolved.maxTurns,
+                    spawnConfig: {
+                        apiKey: runtimeConfig.apiKey,
+                        baseUrl: runtimeConfig.baseUrl ?? undefined,
+                    },
+                });
+                return {
+                    success: result.success,
+                    summary: result.summary,
+                    turns: result.turns,
+                    toolCallCount: result.toolCallCount,
+                    tokensUsed: result.usage.inputTokens + result.usage.outputTokens,
+                };
+            };
+        };
+        const finalState = await (0, engine_js_1.runWorkflow)(state, makeRunStep());
+        if (finalState.status === 'done') {
+            console.log(chalk_1.default.hex('#5a9e6e').bold(`\n  ✓ ${finalState.outcome}\n`));
+        }
+        else {
+            console.error(chalk_1.default.hex('#b15439').bold(`\n  ✗ ${finalState.outcome}\n`));
+        }
+        const totalTokens = finalState.totalTokens ?? 0;
+        console.log(chalk_1.default.hex('#4e3d30')(`  ↳ ${totalTokens.toLocaleString()} tokens · ${finalState.stepStates.length} steps · status: ${finalState.status}`));
+        if (finalState.status === 'failed') {
+            console.log(chalk_1.default.hex('#8a7768')(`\n  Resume with: ruby --resume-workflow ${finalState.definition.id}\n`));
+            process.exit(1);
+        }
+        return;
+    }
+    // ── --resume-workflow <id>: resume a persisted workflow ─────────────────────
+    if (typeof argv['resume-workflow'] === 'string' && argv['resume-workflow']) {
+        const workflowId = argv['resume-workflow'];
+        display.header('Workflow', `Resuming workflow ${workflowId}`);
+        const makeRunStep = () => {
+            return async (task, stepIndex) => {
+                console.log(chalk_1.default.hex('#cc785c')(`\n  ▸ Step ${stepIndex + 1}: ${task}\n`));
+                const currentProvider = buildProvider(display);
+                const result = await (0, loop_js_1.runAgentLoop)({
+                    provider: currentProvider, task, context: ctx, permissions, display,
+                    initialHistory: [],
+                    maxTurns: resolved.maxTurns,
+                    spawnConfig: {
+                        apiKey: runtimeConfig.apiKey,
+                        baseUrl: runtimeConfig.baseUrl ?? undefined,
+                    },
+                });
+                return {
+                    success: result.success,
+                    summary: result.summary,
+                    turns: result.turns,
+                    toolCallCount: result.toolCallCount,
+                    tokensUsed: result.usage.inputTokens + result.usage.outputTokens,
+                };
+            };
+        };
+        const finalState = await (0, engine_js_1.resumeWorkflow)(workflowId, makeRunStep());
+        if (!finalState) {
+            console.error(chalk_1.default.hex('#b15439')(`\n  ✗ Workflow not found: ${workflowId}\n`));
+            process.exit(1);
+        }
+        if (finalState.status === 'done') {
+            console.log(chalk_1.default.hex('#5a9e6e').bold(`\n  ✓ ${finalState.outcome}\n`));
+        }
+        else {
+            console.error(chalk_1.default.hex('#b15439').bold(`\n  ✗ ${finalState.outcome}\n`));
+        }
+        const totalTokens = finalState.totalTokens ?? 0;
+        console.log(chalk_1.default.hex('#4e3d30')(`  ↳ ${totalTokens.toLocaleString()} tokens · ${finalState.stepStates.length} steps · status: ${finalState.status}`));
+        if (finalState.status === 'failed') {
+            console.log(chalk_1.default.hex('#8a7768')(`\n  Resume with: ruby --resume-workflow ${finalState.definition.id}\n`));
+            process.exit(1);
+        }
+        return;
+    }
+    // ── Single task mode: aura "fix the bug" ──────────────────────────────────────
+    if (argv._.length > 0) {
+        const task = argv._.join(' ');
+        console.log(chalk_1.default.hex('#8a7768')(`\n  Task: ${chalk_1.default.hex('#ede0cc')(task)}\n`));
+        // --architect: plan-only — decompose and display
+        if (argv.architect === true) {
+            await runArchitectPlan(task, provider, ctx, display);
+            if (argv.once)
+                return;
+            return startRepl();
+        }
+        // --build: full orchestrated build — decompose + execute all specialists
+        // When --build <id> is a string, build from a saved blueprint instead
+        const doOrchestrate = argv.orchestrate === true || argv.build === true;
+        if (doOrchestrate) {
+            await runOrchestratedTask(task, provider, ctx, display, doOrchestrate);
+            if (argv.once)
+                return;
+            return startRepl();
+        }
+        try {
+            let perception = await (0, index_js_4.loadPerception)(ctx.root);
+            if (!perception || (0, index_js_4.isStale)(perception)) {
+                display.agentThinking();
+                perception = await (0, index_js_4.extractPerception)(ctx.root);
+            }
+            const decision = await (0, index_js_3.routeTask)({ provider, context: ctx, task, perception: perception ?? undefined });
+            if (decision.shouldDecompose && decision.confidence > 0.8) {
+                await runOrchestratedTask(task, provider, ctx, display, false, perception ?? undefined);
+                if (argv.once)
+                    return;
+                return startRepl();
+            }
+        }
+        catch {
+            // Router failed — fall through to single agent
+        }
+        const doVerify = cliVerify || !!fileConfig.verify;
+        const episodeStart = Date.now();
+        let result;
+        if (doVerify) {
+            const { runWithVerification } = await Promise.resolve().then(() => __importStar(require('../verify/index.js')));
+            const maxRetries = cliMaxVerifyRetries ?? fileConfig.maxVerifyRetries ?? defaults_js_1.DEFAULTS.maxVerifyRetries;
+            const testCommand = cliTestCommand ?? fileConfig.testCommand;
+            const wrapperResult = await runWithVerification({
+                loopOpts: {
+                    provider, task, context: ctx, permissions, display,
+                    initialHistory: activeChatHistory,
+                    maxTurns: resolved.maxTurns,
+                    spawnConfig: {
+                        apiKey: argv['api-key'] ?? undefined,
+                        baseUrl: resolved.baseUrl ?? undefined,
+                    },
+                    sessionPath,
+                },
+                config: { enabled: true, maxRetries, testCommand },
+                projectRoot: ctx.root,
+                display,
+            });
+            result = wrapperResult.loopResult;
+        }
+        else {
+            result = await (0, loop_js_1.runAgentLoop)({
+                provider, task, context: ctx, permissions, display,
+                initialHistory: activeChatHistory,
+                maxTurns: resolved.maxTurns,
+                spawnConfig: {
+                    apiKey: argv['api-key'] ?? undefined,
+                    baseUrl: resolved.baseUrl ?? undefined,
+                },
+                sessionPath,
+            });
+        }
+        // Persist episode for Ruby Principle training data
+        try {
+            const { randomBytes } = await Promise.resolve().then(() => __importStar(require('crypto')));
+            await (0, episode_capture_js_1.saveEpisode)(ctx.root, {
+                id: randomBytes(4).toString('hex') + '-' + Date.now().toString(36),
+                timestamp: Date.now(),
+                task,
+                projectRoot: ctx.root,
+                rubyAttempted: false,
+                rubySucceeded: false,
+                largeModelUsed: runtimeConfig.model,
+                largeModelOutput: result.summary,
+                reviewerApproved: result.success,
+                tokensUsed: { largeModel: result.usage.totalTokens },
+                durationMs: Date.now() - episodeStart,
+                taskCategory: 'other',
+            });
+        }
+        catch {
+            // Episode recording is best-effort; never block the user
+        }
+        // Update history so REPL continues the conversation
+        activeChatHistory = result.history;
+        if (activeChatId && !noSession) {
+            await session_store_js_1.sessionStore.upsertSession(projectRoot, activeChatId, result.history, activeChatTitle);
+        }
+        if (result.success) {
+            display.summary(result.summary, result.turns, result.toolCallCount);
+            printUsageFooter(display, result.usage, result.costUsd, {
+                model: runtimeConfig.model ?? undefined,
+                cumulativeTokens: result.usage.inputTokens + result.usage.outputTokens,
+                history: result.history,
+            });
+        }
+        else {
+            display.error(result.summary);
+        }
+        if (argv.once)
+            return;
+        return startRepl();
+    }
+    // ── Interactive REPL mode (no task args) ────────────────────────────────────
+    return startRepl();
+    // ─────────────────────────────────────────────────────────────────────────────
+    // startRepl — interactive readline loop, reused after single-task completion
+    // ─────────────────────────────────────────────────────────────────────────────
+    async function startRepl() {
+        if (activeChatHistory.length > 0) {
+            console.log(chalk_1.default.hex('#8a7768')(`  Continuing session with ${Math.floor(activeChatHistory.length / 2)} prior turns.`));
+        }
+        console.log(chalk_1.default.hex('#8a7768')('  Type a task, or :help for commands. Ctrl+C to exit.\n'));
+        const rl = readline.createInterface({ input: process.stdin, output: process.stdout });
+        const ask = () => {
+            const idTag = activeChatId ? chalk_1.default.hex('#4e3d30')(` [${activeChatId}]`) : '';
+            rl.question(chalk_1.default.hex('#cc785c')('  ▸ ') + idTag + (idTag ? ' ' : ''), async (line) => {
+                const input = line.trim();
+                if (!input) {
+                    ask();
+                    return;
+                }
+                // Slash / colon commands
+                const replCtx = {
+                    ctx, display,
+                    providerConfig: { model: resolved.model, apiKey: runtimeConfig.apiKey, baseUrl: runtimeConfig.baseUrl ?? undefined },
+                    permissions, cumulative,
+                    chatState: { projectRoot, activeChatId, activeChatHistory, activeChatTitle, noSession },
+                };
+                const cmdResult = await handleReplCommand(input, replCtx);
+                if (cmdResult.handled) {
+                    // Commands may update chat state
+                    if (cmdResult.newChatId !== undefined)
+                        activeChatId = cmdResult.newChatId;
+                    if (cmdResult.newHistory !== undefined)
+                        activeChatHistory = cmdResult.newHistory;
+                    if (cmdResult.newTitle !== undefined)
+                        activeChatTitle = cmdResult.newTitle;
+                    ask();
+                    return;
+                }
+                // Run task — pass current conversation history for stay-active mode
+                let result;
+                try {
+                    const currentProvider = buildProvider(display);
+                    const doVerify = argv.verify === true || !!fileConfig.verify;
+                    if (doVerify) {
+                        const { runWithVerification } = await Promise.resolve().then(() => __importStar(require('../verify/index.js')));
+                        const maxRetries = cliMaxVerifyRetries ?? fileConfig.maxVerifyRetries ?? defaults_js_1.DEFAULTS.maxVerifyRetries;
+                        const testCommand = cliTestCommand ?? fileConfig.testCommand;
+                        const wrapperResult = await runWithVerification({
+                            loopOpts: {
+                                provider: currentProvider, task: input,
+                                context: ctx, permissions, display,
+                                initialHistory: activeChatHistory,
+                                maxTurns: resolved.maxTurns,
+                                spawnConfig: {
+                                    apiKey: runtimeConfig.apiKey,
+                                    baseUrl: runtimeConfig.baseUrl ?? undefined,
+                                },
+                                sessionPath,
+                            },
+                            config: { enabled: true, maxRetries, testCommand },
+                            projectRoot: ctx.root,
+                            display,
+                        });
+                        result = wrapperResult.loopResult;
+                    }
+                    else {
+                        result = await (0, loop_js_1.runAgentLoop)({
+                            provider: currentProvider, task: input,
+                            context: ctx, permissions, display,
+                            initialHistory: activeChatHistory,
+                            maxTurns: resolved.maxTurns,
+                            spawnConfig: {
+                                apiKey: runtimeConfig.apiKey,
+                                baseUrl: runtimeConfig.baseUrl ?? undefined,
+                            },
+                            sessionPath,
+                        });
+                    }
+                }
+                catch (err) {
+                    const msg = err instanceof Error ? (err.stack || err.message) : String(err);
+                    console.error(chalk_1.default.hex('#b15439')(`\n  ✗ Unhandled error: ${msg}\n`));
+                    ask();
+                    return;
+                }
+                // Update stay-active history
+                activeChatHistory = result.history;
+                // Persist session
+                if (activeChatId && !noSession) {
+                    await session_store_js_1.sessionStore.upsertSession(projectRoot, activeChatId, activeChatHistory, activeChatTitle);
+                }
+                cumulative.turns += result.turns;
+                cumulative.toolCalls += result.toolCallCount;
+                cumulative.inputTokens += result.usage.inputTokens;
+                cumulative.outputTokens += result.usage.outputTokens;
+                cumulative.costUsd += result.costUsd;
+                if (result.success) {
+                    display.summary(result.summary, result.turns, result.toolCallCount);
+                    printUsageFooter(display, result.usage, result.costUsd, {
+                        model: runtimeConfig.model ?? undefined,
+                        cumulativeTokens: cumulative.inputTokens + cumulative.outputTokens,
+                        history: activeChatHistory,
+                    });
+                }
+                else {
+                    display.error(result.summary);
+                }
+                ask();
+            });
+        };
+        // Ctrl+C: if a task is running, prompt to force-quit; second Ctrl+C exits.
+        let ctrlC = 0;
+        rl.on('SIGINT', () => {
+            ctrlC++;
+            if (ctrlC === 1) {
+                console.log(chalk_1.default.hex('#cc785c')('\n  ⏳ Press Ctrl+C again to exit (current task will keep running).'));
+                setTimeout(() => { ctrlC = 0; }, 3000);
+            }
+            else {
+                console.log(chalk_1.default.hex('#4e3d30')('\n  Aura closed.\n'));
+                process.exit(0);
+            }
+        });
+        ask();
+        rl.on('close', () => {
+            console.log(chalk_1.default.hex('#4e3d30')('\n  Aura closed.\n'));
+            process.exit(0);
+        });
+    }
+}
+function trySetModel(c, newModel) {
+    const prevModel = runtimeConfig.model;
+    const prevBaseUrl = runtimeConfig.baseUrl;
+    runtimeConfig.model = newModel;
+    runtimeConfig.baseUrl = undefined;
+    try {
+        const test = buildProvider(c.display);
+        c.providerConfig.model = newModel;
+        console.log(chalk_1.default.hex('#5a9e6e')(`  ✓ Switched to ${test.name} · ${newModel}`));
+        return { ok: true };
+    }
+    catch (e) {
+        runtimeConfig.model = prevModel; // rollback on error
+        runtimeConfig.baseUrl = prevBaseUrl;
+        return { ok: false, err: String(e) };
+    }
+}
+/**
+ * Interactive model selector — shows all models grouped by provider,
+ * lets the user pick by number or type a custom model ID.
+ */
+function showModelSelector(c) {
+    const allModels = (0, factory_js_1.getAllModels)();
+    // Build flat numbered list grouped by provider
+    const entries = [];
+    let currentProvider = '';
+    for (const m of allModels) {
+        if (m.provider !== currentProvider) {
+            currentProvider = m.provider;
+            entries.push({ id: '', label: chalk_1.default.hex('#8a7768').bold(`  ── ${currentProvider} ──`), provider: currentProvider });
+        }
+        entries.push({
+            id: m.id,
+            label: `    ${chalk_1.default.hex('#cc785c')(String(entries.length + 1).padStart(2))}. ${chalk_1.default.hex('#ede0cc')(m.name.padEnd(30))} ${chalk_1.default.hex('#4e3d30')(m.speed)}`,
+            provider: m.provider,
+        });
+    }
+    console.log(chalk_1.default.hex('#cc785c').bold('\n  Model Selector\n'));
+    for (const e of entries) {
+        console.log(e.label);
+    }
+    console.log(chalk_1.default.hex('#4e3d30')(`\n  Current: ${runtimeConfig.model}`));
+    console.log(chalk_1.default.hex('#4e3d30')('  Type a number, model ID, or press Enter to cancel:\n'));
+    const rl = readline.createInterface({ input: process.stdin, output: process.stdout });
+    rl.question(chalk_1.default.hex('#cc785c')('  ▸ '), (answer) => {
+        const choice = answer.trim();
+        rl.close();
+        if (!choice) {
+            console.log(chalk_1.default.hex('#4e3d30')('  Cancelled.\n'));
+            return;
+        }
+        // Try as a number
+        const num = parseInt(choice, 10);
+        if (!isNaN(num) && num >= 1 && num <= entries.length) {
+            const selected = entries[num - 1];
+            if (selected.id) {
+                trySetModel(c, selected.id);
+            }
+            else {
+                console.log(chalk_1.default.hex('#b15439')('  ✗ That\'s a section header, pick a model number.'));
+            }
+            return;
+        }
+        // Treat as a raw model ID
+        trySetModel(c, choice);
+    });
+}
+async function handleReplCommand(input, c) {
+    const unhandled = { handled: false };
+    if (input === ':quit' || input === ':q' || input === '/exit') {
+        process.exit(0);
+    }
+    if (input === ':help' || input === '/help') {
+        console.log(chalk_1.default.hex('#8a7768')([
+            '',
+            '  ── Session ──────────────────────────────────────',
+            '  :id                     Show current chat ID',
+            '  :sessions               List all saved sessions',
+            '  :resume                 Resume the latest session',
+            '  :resume <id>            Resume a specific session by ID',
+            '  :new                    Start a new session (fresh history)',
+            '  :history                Show turn count in current session',
+            '  :clear-history          Wipe conversation history (keep session ID)',
+            '  :save [title]           Rename / save current session',
+            '  :delete <id>            Delete a saved session',
+            '',
+            '  ── Model / API ──────────────────────────────────',
+            '  :model                  Interactive model selector',
+            '  :model <id>             Switch to a specific model',
+            '  :models                 List all available models',
+            '  :apikey <key>           Set API key for current session',
+            '',
+            '  ── Workflows ─────────────────────────────────────',
+            '  :workflows              List all saved workflows',
+            '  :workflow               Create & run a multi-step workflow',
+            '    <name> "step1" "step2" ...',
+            '  :resume-workflow <id>   Resume a paused/failed workflow',
+            '',
+            '  ── Context / Stats ──────────────────────────────',
+            '  :context                Show loaded project context',
+            '  :graph                  Show codebase knowledge graph summary',
+            '  :graph refresh          Reload graph from graphify-out/graph.json',
+            '  :plans                  List saved execution plans',
+            '  :viz, :dashboard        Generate and open the memory dashboard',
+            '  /stats, /usage          Show token + cost usage this session',
+            '  /clear, /reset          Reset cumulative usage stats',
+            '',
+            '  ── General ──────────────────────────────────────',
+            '  :quit, :q, /exit        Exit',
+            '',
+        ].join('\n')));
+        return { handled: true };
+    }
+    // ── Session commands ─────────────────────────────────────────────────────
+    if (input === ':id') {
+        const cs = c.chatState;
+        if (cs.activeChatId) {
+            console.log(chalk_1.default.hex('#8a7768')(`\n  Chat ID: ${chalk_1.default.hex('#cc785c')(cs.activeChatId)}`));
+            if (cs.activeChatTitle)
+                console.log(chalk_1.default.hex('#8a7768')(`  Title:   ${cs.activeChatTitle}`));
+            console.log(chalk_1.default.hex('#4e3d30')(`  Turns:   ${Math.floor(cs.activeChatHistory.length / 2)}\n`));
+        }
+        else {
+            console.log(chalk_1.default.hex('#8a7768')('\n  No active session (--no-session mode).\n'));
+        }
+        return { handled: true };
+    }
+    if (input === ':sessions') {
+        const sessions = session_store_js_1.sessionStore.listSessions(c.chatState.projectRoot);
+        if (sessions.length === 0) {
+            console.log(chalk_1.default.hex('#8a7768')('\n  No saved sessions.\n'));
+        }
+        else {
+            console.log(chalk_1.default.hex('#cc785c').bold('\n  Saved sessions:\n'));
+            for (const s of sessions) {
+                const updated = new Date(s.updatedAt).toLocaleString();
+                const turns = Math.floor(s.history.length / 2);
+                const marker = s.id === c.chatState.activeChatId ? chalk_1.default.hex('#5a9e6e')(' ← current') : '';
+                console.log(`  ${chalk_1.default.hex('#cc785c')(s.id.padEnd(20))} ` +
+                    `${chalk_1.default.hex('#ede0cc')(s.title.slice(0, 40).padEnd(41))} ` +
+                    `${chalk_1.default.hex('#4e3d30')(`${turns}t · ${updated}`)}${marker}`);
+            }
+            console.log();
+        }
+        return { handled: true };
+    }
+    if (input === ':resume' || input === ':resume ') {
+        const latest = session_store_js_1.sessionStore.findLatestSession(c.chatState.projectRoot);
+        if (!latest) {
+            console.log(chalk_1.default.hex('#8a7768')('\n  No saved sessions to resume.\n'));
+            return { handled: true };
+        }
+        console.log(chalk_1.default.hex('#5a9e6e')(`\n  ↩ Resuming ${latest.id} — "${latest.title}" (${Math.floor(latest.history.length / 2)} turns)\n`));
+        return { handled: true, newChatId: latest.id, newHistory: latest.history, newTitle: latest.title };
+    }
+    if (input.startsWith(':resume ')) {
+        const id = input.slice(':resume '.length).trim();
+        const loaded = await session_store_js_1.sessionStore.loadSession(c.chatState.projectRoot, id);
+        if (!loaded) {
+            console.log(chalk_1.default.hex('#b15439')(`\n  ✗ Session not found: ${id}\n`));
+            return { handled: true };
+        }
+        console.log(chalk_1.default.hex('#5a9e6e')(`\n  ↩ Resumed ${loaded.id} — "${loaded.title}" (${Math.floor(loaded.history.length / 2)} turns)\n`));
+        return { handled: true, newChatId: loaded.id, newHistory: loaded.history, newTitle: loaded.title };
+    }
+    if (input === ':new') {
+        const newId = session_store_js_1.sessionStore.generateId();
+        console.log(chalk_1.default.hex('#5a9e6e')(`\n  ✓ New session started: ${newId}\n`));
+        return { handled: true, newChatId: newId, newHistory: [], newTitle: undefined };
+    }
+    if (input === ':history') {
+        const turns = Math.floor(c.chatState.activeChatHistory.length / 2);
+        console.log(chalk_1.default.hex('#8a7768')(`\n  Current session: ${turns} turn${turns !== 1 ? 's' : ''} in history.\n`));
+        return { handled: true };
+    }
+    if (input === ':clear-history') {
+        console.log(chalk_1.default.hex('#5a9e6e')('\n  ✓ Conversation history cleared.\n'));
+        return { handled: true, newHistory: [] };
+    }
+    if (input === ':save' || input.startsWith(':save ')) {
+        const title = input.startsWith(':save ') ? input.slice(':save '.length).trim() : undefined;
+        const cs = c.chatState;
+        if (!cs.activeChatId) {
+            console.log(chalk_1.default.hex('#8a7768')('\n  No active session to save (--no-session mode).\n'));
+            return { handled: true };
+        }
+        const session = await session_store_js_1.sessionStore.upsertSession(cs.projectRoot, cs.activeChatId, cs.activeChatHistory, title ?? cs.activeChatTitle);
+        console.log(chalk_1.default.hex('#5a9e6e')(`\n  ✓ Saved as "${session.title}" (${cs.activeChatId})\n`));
+        return { handled: true, newTitle: session.title };
+    }
+    if (input.startsWith(':delete ')) {
+        const id = input.slice(':delete '.length).trim();
+        const deleted = await session_store_js_1.sessionStore.deleteSession(c.chatState.projectRoot, id);
+        if (deleted) {
+            console.log(chalk_1.default.hex('#5a9e6e')(`\n  ✓ Deleted session ${id}\n`));
+            if (id === c.chatState.activeChatId) {
+                const newId = session_store_js_1.sessionStore.generateId();
+                console.log(chalk_1.default.hex('#8a7768')(`  Starting new session: ${newId}\n`));
+                return { handled: true, newChatId: newId, newHistory: [], newTitle: undefined };
+            }
+        }
+        else {
+            console.log(chalk_1.default.hex('#b15439')(`\n  ✗ Session not found: ${id}\n`));
+        }
+        return { handled: true };
+    }
+    // ── Model / API commands ─────────────────────────────────────────────────
+    if (input === ':context') {
+        console.log(chalk_1.default.hex('#8a7768')(`\n  Project: ${c.ctx.name} · ${c.ctx.language} · ${c.ctx.framework}`));
+        console.log(chalk_1.default.hex('#4e3d30')(`  Root: ${c.ctx.root}\n`));
+        return { handled: true };
+    }
+    if (input === ':graph') {
+        const summary = (0, context_js_1.loadGraphSummary)(c.ctx.root);
+        if (!summary) {
+            console.log(chalk_1.default.hex('#8a7768')('\n  No graph.json found. Run :graph refresh to extract.\n'));
+        }
+        else {
+            console.log(chalk_1.default.hex('#cc785c').bold('\n  Codebase Knowledge Graph\n'));
+            console.log(chalk_1.default.hex('#8a7768')(summary));
+            console.log();
+        }
+        return { handled: true };
+    }
+    if (input === ':viz' || input === ':dashboard') {
+        console.log(chalk_1.default.hex('#8a7768')('\n  Generating dashboard…\n'));
+        try {
+            const outPath = (0, index_js_1.generateDashboard)(c.ctx.root);
+            console.log(chalk_1.default.hex('#5a9e6e')(`  ✓ Dashboard written to ${outPath}`));
+            console.log(chalk_1.default.hex('#8a7768')('  Opening in browser…\n'));
+            (0, index_js_1.openDashboard)(outPath);
+        }
+        catch (e) {
+            console.log(chalk_1.default.hex('#b15439')(`  ✗ ${String(e)}\n`));
+        }
+        return { handled: true };
+    }
+    if (input === ':plans') {
+        const { planStore } = await Promise.resolve().then(() => __importStar(require('../orchestration/plan-store.js')));
+        const plans = await planStore.list();
+        if (!plans.length) {
+            console.log(chalk_1.default.hex('#8a7768')('\n  No execution plans found.\n'));
+        }
+        else {
+            console.log(chalk_1.default.hex('#cc785c').bold('\n  Execution plans:\n'));
+            for (const p of plans.slice(0, 15)) {
+                const created = new Date(p.created).toLocaleString();
+                const dur = p.completed ? `${Math.round((p.completed - p.created) / 1000)}s` : '—';
+                const statusColor = p.status === 'done' ? '#5a9e6e' : p.status === 'failed' ? '#b15439' : '#cc9e5c';
+                console.log(`  ${chalk_1.default.hex(statusColor)(p.status.padEnd(8))} ` +
+                    `${chalk_1.default.hex('#cc785c')(p.id.slice(0, 12).padEnd(14))} ` +
+                    `${chalk_1.default.hex('#ede0cc')(p.goal.slice(0, 50).padEnd(51))} ` +
+                    `${chalk_1.default.hex('#4e3d30')(`${p.steps.length}s · ${dur} · ${created}`)}`);
+            }
+            console.log();
+        }
+        return { handled: true };
+    }
+    if (input === ':graph refresh') {
+        console.log(chalk_1.default.hex('#8a7768')('\n  Refreshing codebase graph...\n'));
+        const { execFileSync } = await Promise.resolve().then(() => __importStar(require('child_process')));
+        try {
+            // Pass root as sys.argv[1] to avoid shell interpolation
+            execFileSync('python3', [
+                '-c',
+                'import sys,json,os,re,glob; root=sys.argv[1]+"/src"; print("Scanning", root)',
+                c.ctx.root,
+            ], { stdio: 'inherit' });
+        }
+        catch { /* ignore */ }
+        // Reload context graph
+        c.ctx.graphSummary = (0, context_js_1.loadGraphSummary)(c.ctx.root);
+        if (c.ctx.graphSummary) {
+            console.log(chalk_1.default.hex('#5a9e6e')('  ✓ Graph loaded and injected into context.\n'));
+        }
+        else {
+            console.log(chalk_1.default.hex('#8a7768')('  No graph.json found after refresh. Run graphify extract first.\n'));
+        }
+        return { handled: true };
+    }
+    if (input === ':models') {
+        const allModels = (0, factory_js_1.getAllModels)();
+        const byProvider = allModels.reduce((acc, m) => {
+            (acc[m.provider] ??= []).push(m);
+            return acc;
+        }, {});
+        for (const [provider, models] of Object.entries(byProvider)) {
+            console.log(chalk_1.default.hex('#8a7768')(`\n  ${provider}`));
+            for (const m of models) {
+                console.log(`    ${chalk_1.default.hex('#cc785c')(m.id.padEnd(45))} ${chalk_1.default.hex('#4e3d30')(m.speed)}`);
+            }
+        }
+        console.log();
+        return { handled: true };
+    }
+    if (input === ':model' || input === '/model') {
+        showModelSelector(c);
+        return { handled: true };
+    }
+    if (input.startsWith(':model ') || input.startsWith('/model ')) {
+        const sep = input.startsWith(':model ') ? ':model ' : '/model ';
+        const newModel = input.slice(sep.length).trim();
+        const r = trySetModel(c, newModel);
+        if (!r.ok)
+            console.log(chalk_1.default.hex('#b15439')(`  ✗ ${r.err}`));
+        return { handled: true };
+    }
+    if (input.startsWith(':apikey ') || input.startsWith('/apikey ')) {
+        const sep = input.startsWith(':apikey ') ? ':apikey ' : '/apikey ';
+        const newKey = input.slice(sep.length).trim();
+        runtimeConfig.apiKey = newKey;
+        c.providerConfig.apiKey = newKey;
+        console.log(chalk_1.default.hex('#5a9e6e')('  ✓ API key set for current session.'));
+        return { handled: true };
+    }
+    if (input === '/clear' || input === '/reset') {
+        c.cumulative.turns = 0;
+        c.cumulative.toolCalls = 0;
+        c.cumulative.inputTokens = 0;
+        c.cumulative.outputTokens = 0;
+        c.cumulative.costUsd = 0;
+        console.log(chalk_1.default.hex('#5a9e6e')('  ✓ Session stats reset'));
+        return { handled: true };
+    }
+    if (input === '/stats' || input === '/usage') {
+        const u = c.cumulative;
+        const total = u.inputTokens + u.outputTokens;
+        console.log(chalk_1.default.hex('#8a7768')([
+            '',
+            `  Session usage:`,
+            `    Turns:        ${u.turns}`,
+            `    Tool calls:   ${u.toolCalls}`,
+            `    Input tokens: ${u.inputTokens.toLocaleString()}`,
+            `    Output tokens:${u.outputTokens.toLocaleString()}`,
+            `    Total tokens: ${total.toLocaleString()}`,
+            `    Est. cost:    ${u.costUsd.toFixed(4)}`,
+            '',
+        ].join('\n')));
+        return { handled: true };
+    }
+    // ── Workflow commands ──────────────────────────────────────────────────────
+    if (input === ':workflows') {
+        const workflows = await (0, engine_js_1.listWorkflows)();
+        if (workflows.length === 0) {
+            console.log(chalk_1.default.hex('#8a7768')('\n  No saved workflows.\n'));
+        }
+        else {
+            console.log(chalk_1.default.hex('#cc785c').bold('\n  Saved workflows:\n'));
+            for (const ws of workflows) {
+                const created = new Date(ws.definition.createdAt).toLocaleString();
+                const doneSteps = ws.stepStates.filter(s => s.status === 'done').length;
+                const totalSteps = ws.definition.steps.length;
+                const statusColor = ws.status === 'done' ? '#5a9e6e' : ws.status === 'failed' ? '#b15439' : '#cc785c';
+                console.log(`  ${chalk_1.default.hex('#cc785c')(ws.definition.id.padEnd(24))} ` +
+                    `${chalk_1.default.hex('#ede0cc')(ws.definition.name.slice(0, 36).padEnd(37))} ` +
+                    `${chalk_1.default.hex(statusColor)(ws.status.padEnd(8))} ` +
+                    `${chalk_1.default.hex('#4e3d30')(`${doneSteps}/${totalSteps} steps · ${created}`)}`);
+            }
+            console.log();
+        }
+        return { handled: true };
+    }
+    if (input.startsWith(':workflow ')) {
+        const parts = input.slice(':workflow '.length).trim();
+        // Parse: <name> "step1" "step2" ...  or  <name> step1 step2 ...
+        const match = parts.match(/^(\S+)\s+(.+)$/);
+        if (!match) {
+            console.log(chalk_1.default.hex('#b15439')('  ✗ Usage: :workflow <name> "step 1" "step 2" ...'));
+            return { handled: true };
+        }
+        const workflowName = match[1];
+        // Split remaining by quoted strings or spaces
+        const restStr = match[2];
+        const stepTasks = [];
+        const quotedRe = /"([^"]+)"|'([^']+)'|(\S+)/g;
+        let m;
+        while ((m = quotedRe.exec(restStr)) !== null) {
+            stepTasks.push(m[1] ?? m[2] ?? m[3]);
+        }
+        if (stepTasks.length === 0) {
+            console.log(chalk_1.default.hex('#b15439')('  ✗ At least one step task is required.'));
+            return { handled: true };
+        }
+        const steps = stepTasks.map((task, i) => ({
+            name: `step-${i + 1}`,
+            task,
+        }));
+        console.log(chalk_1.default.hex('#cc785c').bold(`\n  Creating workflow "${workflowName}" with ${steps.length} steps...\n`));
+        const state = await (0, engine_js_1.createWorkflow)({ name: workflowName, steps });
+        console.log(chalk_1.default.hex('#5a9e6e')(`  ✓ Workflow created: ${state.definition.id}\n`));
+        // Build the runStep callback using the REPL context's provider
+        const runStep = async (task, stepIndex) => {
+            console.log(chalk_1.default.hex('#cc785c')(`  ▸ Step ${stepIndex + 1}/${steps.length}: ${task}\n`));
+            const { createResilientProvider } = await Promise.resolve().then(() => __importStar(require('../providers/resilient-factory.js')));
+            const currentProvider = createResilientProvider({ model: c.providerConfig.model, apiKey: c.providerConfig.apiKey, baseUrl: c.providerConfig.baseUrl }, {}, c.display);
+            const result = await (0, loop_js_1.runAgentLoop)({
+                provider: currentProvider, task, context: c.ctx, permissions: c.permissions,
+                display: c.display, initialHistory: [], maxTurns: undefined,
+                spawnConfig: { apiKey: c.providerConfig.apiKey, baseUrl: c.providerConfig.baseUrl },
+            });
+            return {
+                success: result.success,
+                summary: result.summary,
+                turns: result.turns,
+                toolCallCount: result.toolCallCount,
+                tokensUsed: result.usage.inputTokens + result.usage.outputTokens,
+            };
+        };
+        const finalState = await (0, engine_js_1.runWorkflow)(state, runStep);
+        if (finalState.status === 'done') {
+            console.log(chalk_1.default.hex('#5a9e6e').bold(`\n  ✓ ${finalState.outcome}\n`));
+        }
+        else {
+            console.log(chalk_1.default.hex('#b15439').bold(`\n  ✗ ${finalState.outcome}`));
+            console.log(chalk_1.default.hex('#8a7768')(`  Resume with: :resume-workflow ${finalState.definition.id}\n`));
+        }
+        return { handled: true };
+    }
+    if (input.startsWith(':resume-workflow ')) {
+        const workflowId = input.slice(':resume-workflow '.length).trim();
+        if (!workflowId) {
+            console.log(chalk_1.default.hex('#b15439')('  ✗ Usage: :resume-workflow <id>'));
+            return { handled: true };
+        }
+        console.log(chalk_1.default.hex('#cc785c').bold(`\n  Resuming workflow ${workflowId}...\n`));
+        const runStep = async (task, stepIndex) => {
+            console.log(chalk_1.default.hex('#cc785c')(`  ▸ Step ${stepIndex + 1}: ${task}\n`));
+            const { createResilientProvider } = await Promise.resolve().then(() => __importStar(require('../providers/resilient-factory.js')));
+            const currentProvider = createResilientProvider({ model: c.providerConfig.model, apiKey: c.providerConfig.apiKey, baseUrl: c.providerConfig.baseUrl }, {}, c.display);
+            const result = await (0, loop_js_1.runAgentLoop)({
+                provider: currentProvider, task, context: c.ctx, permissions: c.permissions,
+                display: c.display, initialHistory: [], maxTurns: undefined,
+                spawnConfig: { apiKey: c.providerConfig.apiKey, baseUrl: c.providerConfig.baseUrl },
+            });
+            return {
+                success: result.success,
+                summary: result.summary,
+                turns: result.turns,
+                toolCallCount: result.toolCallCount,
+                tokensUsed: result.usage.inputTokens + result.usage.outputTokens,
+            };
+        };
+        const finalState = await (0, engine_js_1.resumeWorkflow)(workflowId, runStep);
+        if (!finalState) {
+            console.log(chalk_1.default.hex('#b15439')(`  ✗ Workflow not found: ${workflowId}\n`));
+            return { handled: true };
+        }
+        if (finalState.status === 'done') {
+            console.log(chalk_1.default.hex('#5a9e6e').bold(`\n  ✓ ${finalState.outcome}\n`));
+        }
+        else {
+            console.log(chalk_1.default.hex('#b15439').bold(`\n  ✗ ${finalState.outcome}`));
+            console.log(chalk_1.default.hex('#8a7768')(`  Resume with: :resume-workflow ${finalState.definition.id}\n`));
+        }
+        return { handled: true };
+    }
+    return unhandled;
+}
+/**
+ * Architect mode: produce a blueprint without writing any code.
+ * The agent analyses the task, proposes files/interfaces/data models,
+ * and the blueprint is saved to ~/.aura/blueprints/<id>.json.
+ */
+async function runArchitectPlan(task, provider, ctx, display) {
+    display.header('Architect', 'Analysing task and producing blueprint...');
+    const architectPrompt = [
+        `You are in architect mode. You are planning the implementation for: "${task}"`,
+        '',
+        'Project context:',
+        `  Language: ${ctx.language}`,
+        `  Framework: ${ctx.framework}`,
+        `  Root: ${ctx.root}`,
+        '',
+        'Rules for architect mode:',
+        '1. Think about the FULL solution before proposing any file.',
+        '2. Propose the MINIMUM number of files needed.',
+        '3. Name files after what they DO, not what they ARE.',
+        '4. Define interfaces before implementations.',
+        '5. Flag any ambiguous parts of the task as risks.',
+        '6. Do NOT write any code. Only plan.',
+        '',
+        'Output format — respond with ONLY this JSON object (no markdown fences, no extra text):',
+        JSON.stringify({
+            files: [
+                {
+                    path: 'src/example.ts',
+                    purpose: 'What this file does (one sentence)',
+                    exports: ['exportedSymbol'],
+                    interfaces: ['InterfaceName'],
+                },
+            ],
+            dataModels: [
+                {
+                    name: 'ModelName',
+                    fields: ['field: type'],
+                    description: 'What this model represents',
+                },
+            ],
+            dependencies: ['external-package-or-module'],
+            risks: ['Ambiguous part or concern'],
+            estimatedSteps: 0,
+        }, null, 2),
+        '',
+        'Now produce the blueprint JSON for the task described above.',
+    ].join('\n');
+    const permissions = new permissions_js_1.PermissionSystem('read-only');
+    let result;
+    try {
+        result = await (0, loop_js_1.runAgentLoop)({
+            provider, task: architectPrompt, context: ctx, permissions, display,
+            initialHistory: [],
+            maxTurns: 5,
+            spawnConfig: {
+                apiKey: runtimeConfig.apiKey,
+                baseUrl: runtimeConfig.baseUrl ?? undefined,
+            },
+        });
+    }
+    catch (e) {
+        display.error(`Architect analysis failed: ${String(e)}`);
+        process.exit(1);
+    }
+    // Parse the agent's response for a JSON blueprint
+    const responseText = result.summary;
+    let parsed;
+    try {
+        // Try to extract JSON from the response (may have surrounding text)
+        const jsonMatch = responseText.match(/\{[\s\S]*\}/);
+        if (!jsonMatch)
+            throw new Error('No JSON object found in response');
+        parsed = JSON.parse(jsonMatch[0]);
+    }
+    catch (e) {
+        // If the agent didn't produce valid JSON, create a minimal blueprint with the raw response
+        parsed = {
+            files: [],
+            dataModels: [],
+            dependencies: [],
+            risks: [`Agent response was not valid JSON: ${responseText.slice(0, 200)}`],
+            estimatedSteps: 0,
+        };
+    }
+    const blueprint = await (0, engine_js_2.createBlueprint)(task, ctx.root, {
+        files: (parsed.files ?? []).map(f => ({
+            path: f.path,
+            purpose: f.purpose,
+            exports: f.exports ?? [],
+            interfaces: f.interfaces ?? [],
+            status: 'planned',
+        })),
+        dataModels: (parsed.dataModels ?? []).map(dm => ({
+            name: dm.name,
+            fields: dm.fields ?? [],
+            description: dm.description ?? '',
+        })),
+        dependencies: parsed.dependencies ?? [],
+        risks: parsed.risks ?? [],
+        estimatedSteps: parsed.estimatedSteps ?? parsed.files?.length ?? 0,
+    });
+    // Display result
+    console.log(chalk_1.default.hex('#cc785c').bold('\n  Blueprint\n'));
+    console.log(chalk_1.default.hex('#ede0cc')(`  Task: ${blueprint.task}`));
+    console.log(chalk_1.default.hex('#4e3d30')(`  ID: ${blueprint.id}\n`));
+    if (blueprint.files.length > 0) {
+        console.log(chalk_1.default.hex('#cc785c').bold('  Files:\n'));
+        for (const f of blueprint.files) {
+            console.log(`    ${chalk_1.default.hex('#cc785c')(f.path)}`);
+            console.log(`      ${chalk_1.default.hex('#8a7768')(f.purpose)}`);
+            if (f.exports.length > 0)
+                console.log(`      ${chalk_1.default.hex('#4e3d30')(`exports: ${f.exports.join(', ')}`)}`);
+            if (f.interfaces.length > 0)
+                console.log(`      ${chalk_1.default.hex('#4e3d30')(`interfaces: ${f.interfaces.join(', ')}`)}`);
+        }
+    }
+    if (blueprint.dataModels.length > 0) {
+        console.log(chalk_1.default.hex('#cc785c').bold('\n  Data Models:\n'));
+        for (const dm of blueprint.dataModels) {
+            console.log(`    ${chalk_1.default.hex('#cc785c')(dm.name)} — ${chalk_1.default.hex('#8a7768')(dm.description)}`);
+        }
+    }
+    if (blueprint.risks.length > 0) {
+        console.log(chalk_1.default.hex('#b15439').bold('\n  Risks:\n'));
+        for (const risk of blueprint.risks) {
+            console.log(`    ${chalk_1.default.hex('#b15439')('⚠')} ${chalk_1.default.hex('#8a7768')(risk)}`);
+        }
+    }
+    console.log(chalk_1.default.hex('#5a9e6e')('\n  Blueprint saved. No files were modified.'));
+    console.log(chalk_1.default.hex('#5a9e6e')(`  Review with: ruby --blueprint ${blueprint.id}`));
+    console.log(chalk_1.default.hex('#5a9e6e')(`  Build with: ruby --build ${blueprint.id}\n`));
+}
+async function runOrchestratedTask(task, provider, ctx, display, forceOrchestrate, perception) {
+    display.header('Orchestrator', 'Planning multi-agent execution...');
+    let plan;
+    try {
+        plan = await (0, index_js_3.createPlan)({ provider, context: ctx, task, perception });
+    }
+    catch (e) {
+        display.error(`Failed to create plan: ${String(e)}`);
+        process.exit(1);
+    }
+    // If --plan flag, show plan and ask for confirmation
+    if (argv.plan === true) {
+        display.showPlan?.(plan);
+        // Use a simple readline prompt for confirmation
+        const rl = readline.createInterface({ input: process.stdin, output: process.stdout });
+        const approved = await new Promise(resolve => {
+            rl.question(chalk_1.default.hex('#cc785c')('\n  Run this plan? [y/N] '), answer => {
+                rl.close();
+                resolve(answer.toLowerCase() === 'y' || answer.toLowerCase() === 'yes');
+            });
+        });
+        if (!approved) {
+            console.log(chalk_1.default.hex('#4e3d30')('  Plan cancelled.\n'));
+            process.exit(0);
+        }
+    }
+    // Execute the plan
+    let executedPlan;
+    try {
+        executedPlan = await (0, index_js_3.executePlan)({
+            provider,
+            context: ctx,
+            perception,
+            plan,
+            display,
+        });
+    }
+    catch (e) {
+        display.error(`Plan execution error: ${String(e)}`);
+        process.exit(1);
+    }
+    // Display outcome
+    if (executedPlan.outcome) {
+        display.summary(executedPlan.outcome, executedPlan.steps.length, 0);
+    }
+    const totalTokens = executedPlan.totalTokens ?? 0;
+    console.log(chalk_1.default.hex('#4e3d30')(`  ↳ ${totalTokens.toLocaleString()} tokens · ${executedPlan.steps.length} steps · status: ${executedPlan.status}`));
+}
+function printUsageFooter(display, usage, costUsd, opts) {
+    const total = usage.inputTokens + usage.outputTokens;
+    console.log(chalk_1.default.hex('#4e3d30')(`  ↳ ${total.toLocaleString()} tokens (${usage.inputTokens.toLocaleString()} in / ${usage.outputTokens.toLocaleString()} out) · est. ${costUsd.toFixed(4)}`));
+    // Context window bar
+    if (opts?.model) {
+        const ctxWin = (0, factory_js_1.getContextWindow)(opts.model);
+        if (ctxWin) {
+            const real = opts.cumulativeTokens ?? 0;
+            let used;
+            let estimated;
+            if (real > 0) {
+                used = real;
+                estimated = false;
+            }
+            else {
+                // Provider didn't report usage — estimate from history character count
+                const histChars = (opts.history ?? []).reduce((n, m) => {
+                    if ('content' in m && typeof m.content === 'string')
+                        return n + m.content.length;
+                    if ('results' in m)
+                        return n + JSON.stringify(m.results).length;
+                    return n;
+                }, 0);
+                used = Math.ceil(histChars / 4);
+                estimated = true;
+            }
+            if (used > 0) {
+                console.log((0, display_js_1.formatContextBar)(used, ctxWin, estimated));
+            }
+        }
+    }
+}
+function printHelp() {
+    console.log(`
+${chalk_1.default.hex('#cc785c').bold('  aura')} ${chalk_1.default.hex('#8a7768')("— Aura Code: model-agnostic AI coding agent")}
+
+  ${chalk_1.default.hex('#4e3d30')('Usage:')}
+    aura ${chalk_1.default.hex('#8a7768')('"<task>"')}                           Run a task, then drop into REPL
+    aura ${chalk_1.default.hex('#8a7768')('"<task>" --once')}                    Run a single task and exit
+    aura                                                               Start interactive REPL
+    aura ${chalk_1.default.hex('#8a7768')('--models')}                           List available models
+
+  ${chalk_1.default.hex('#4e3d30')('Options:')}
+    --model, -m <id>         Model to use (default: from ~/.config/aura-code/config.json)
+    --api-key <key>          API key (overrides env var)
+    --base-url <url>         Custom API endpoint (for Ollama, proxies, etc.)
+    --auto                   Auto-approve all tool calls (no confirmation)
+    --readonly               Read-only mode (no file writes or shell commands)
+    --cwd <path>             Working directory (default: current)
+    --models                 List all known model IDs
+    --no-session             Disable conversation history persistence
+    --once                   Run single task and exit (no REPL after)
+    --new-session            Force a fresh session (ignore any prior history)
+    --resume [id]            Resume latest session, or a specific session by ID
+    --chat-id <id>           Attach to a specific chat ID (creates if missing)
+    --list-sessions          List all saved sessions for this project
+    --no-setup               Skip the first-run setup wizard
+    --reset-setup            Wipe saved config and re-run the setup wizard
+    --orchestrate            Force multi-agent orchestration mode
+    --architect "task"       Blueprint mode: plan-only, no code written, produces blueprint
+    --blueprint <id>         Show a saved blueprint by ID
+    --blueprints             List all saved blueprints
+    --build [id]             Full orchestrated build; --build <id> builds from blueprint
+    --plan                   Preview execution plan before running
+    --verify                 Verify output after task; retry up to --max-verify-retries times
+    --max-verify-retries <n> Max verification retries (default: 3)
+    --test-command <cmd>     Shell command run as part of verification (e.g. "npm test")
+    --max-turns <n>          Max agent loop turns before stopping (default: 150)
+    --analyze                Mine session history for weakness patterns; save report
+    --propose-harness        Generate system-prompt patches from weakness report
+    --apply-harness <id>     Apply a proposal patch; reverts if tests fail
+    --workflow <name> ...    Create and run a sequential workflow with named steps
+    --resume-workflow <id>   Resume a paused/failed workflow from last completed step
+    --workflows              List all persisted workflows
+    --profile local          Use local Ollama model (no API key required)
+
+    --rate-limit-rpm <n>     Cap requests per minute (default: 0=unlimited, Google: 30)
+    --rate-limit-tpm <n>     Cap tokens per minute (Google only; default: 0=unlimited)
+    --max-retries <n>        Max retry attempts on 429/5xx (default: 5, Google: 6)
+    --fallback <model>       Fallback model if primary exhausts retries (repeatable)
+    --verify                 Enable post-task verification with automatic retries
+
+  ${chalk_1.default.hex('#4e3d30')('Resilience:')}
+    All API calls automatically:
+    1. Honour Retry-After / Google's retryDelay on 429s
+    2. Back off with exponential + jitter (capped at 60s)
+    3. Trip a circuit breaker after 5 consecutive failures
+    4. Fail over to the next --fallback model if retries exhaust
+    5. Pace requests when --rate-limit-rpm / --rate-limit-tpm is set
+
+  ${chalk_1.default.hex('#4e3d30')('Project config (.aura.json):')}
+    {
+      "model": "claude-sonnet-4-5-20251001",
+      "mode":  "auto",
+      "providers": [
+        {
+          "name": "DeepSeek",
+          "baseUrl": "https://api.deepseek.com/v1",
+          "apiKeyEnv": "DEEPSEEK_API_KEY",
+          "prefixes": ["deepseek/"],
+          "models": [
+            { "id": "deepseek/deepseek-v4-flash", "name": "DeepSeek V4 Flash", "speed": "Fast · 1M context" },
+            { "id": "deepseek/deepseek-v4-pro", "name": "DeepSeek V4 Pro", "speed": "Powerful · 1M context" }
+          ]
+        }
+      ],
+      "rateLimitRpm": 30,
+      "rateLimitTpm": 1000000,
+      "maxTurns": 150,
+      "maxRetries": 6,
+      "fallbacks": ["gpt-4o-mini", "gemini-2.5-flash"],
+      "ignore": ["dist/", "*.generated.ts"]
+    }
+    CLI flags always override .aura.json.
+    Custom providers are OpenAI-compatible endpoints.
+
+  ${chalk_1.default.hex('#4e3d30')('Model examples:')}
+    aura -m claude-opus-4-5-20251001  "refactor auth"
+    aura -m gpt-4o                    "add unit tests"
+    aura -m gemini-2.5-pro --rate-limit-rpm 20  "explain this codebase"
+    aura -m ollama/llama3.2           "local model, no API key needed"
+
+  ${chalk_1.default.hex('#4e3d30')('API keys (set as env vars):')}
+    ANTHROPIC_API_KEY    Claude models
+    OPENAI_API_KEY       GPT models
+    GOOGLE_API_KEY       Gemini models
+    XAI_API_KEY          Grok models
+    OPENROUTER_API_KEY   OpenRouter (access to all models)
+    XIAOMI_API_KEY       Xiaomi MiMo
+    AURA_MODEL           Default model (overridden by --model)
+    AURA_API_RPM         Default request rate limit
+    AURA_API_TPM         Default token rate limit (Gemini)
+    AURA_MAX_RETRIES     Default max retry attempts
+    AURA_FALLBACK_MODEL  Comma-separated fallback models
+`);
+}
+if (argv._[0] === 'serve') {
+    const port = Number(argv.port ?? argv.p ?? 7337);
+    (0, index_js_2.startServer)({ port, cwd, model: argv.model, apiKey: argv['api-key'] ?? undefined, baseUrl: argv['base-url'] ?? undefined, open: argv.open !== false }).catch(e => { console.error('Fatal:', String(e)); process.exit(1); });
+}
+else {
+    main().catch(e => { console.error(chalk_1.default.hex('#b15439')(`\nFatal: ${String(e)}`)); process.exit(1); });
+}
+//# sourceMappingURL=index.js.map