aura-code 0.3.7 → 0.6.3

package/dist/cli/index.js

@@ -66,6 +66,8 @@ const diamond_js_1 = require("./diamond.js");
 const episode_capture_js_1 = require("../ruby/episode-capture.js");
 const model_selector_js_1 = require("../ruby/model-selector.js");
 const stats_js_1 = require("../ruby/stats.js");
+const alternator_js_1 = require("../ruby/alternator.js");
+const types_js_1 = require("../ruby/types.js");
 const load_env_js_1 = require("../util/load-env.js");
 const factory_js_2 = require("../providers/factory.js");
 // Load API keys from ~/.hermes/.env, ~/.config/aura-code/.env, and project .env
@@ -783,6 +785,9 @@ async function main() {
             if (!perception || (0, index_js_4.isStale)(perception)) {
                 display.agentThinking();
                 perception = await (0, index_js_4.extractPerception)(ctx.root);
+                // Persist so the viz dashboard and context summary stay populated
+                (0, index_js_4.savePerception)(perception).catch(() => { });
+                (0, index_js_4.saveGraphForViz)(perception).catch(() => { });
             }
             const decision = await (0, index_js_3.routeTask)({ provider, context: ctx, task, perception: perception ?? undefined });
             if (decision.shouldDecompose && decision.confidence > 0.8) {
@@ -795,7 +800,11 @@ async function main() {
         catch {
             // Router failed — fall through to single agent
         }
-        // ── RubyAlternator: suggest model from competence history ─────────────────
+        // ── Competence-based model selection ───────────────────────────────────────
+        // Picks the best-performing model among already-configured, same-family
+        // options based on task similarity to past episodes. Distinct from
+        // RubyAlternator below — this only chooses among models you've already
+        // set up; it never tries a free local model first.
         // Only when the user has NOT explicitly specified --model or :model
         if (!userSetModel && !globalCfg?.defaultModel) {
             try {
@@ -818,9 +827,13 @@ async function main() {
             }
         }
         const doVerify = cliVerify || !!fileConfig.verify;
+        const rubyConfig = { ...types_js_1.DEFAULT_RUBY_CONFIG, ...fileConfig.ruby };
         const episodeStart = Date.now();
         let result;
+        let alternatorHandledEpisode = false;
         if (doVerify) {
+            // Ruby-alternation doesn't support the verification wrapper yet —
+            // a verified task always runs directly against the selected model.
             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;
@@ -841,6 +854,20 @@ async function main() {
             });
             result = wrapperResult.loopResult;
         }
+        else if (rubyConfig.enabled) {
+            const alternator = new alternator_js_1.RubyAlternator({
+                rubyConfig,
+                largeModelProvider: provider,
+                projectRoot: ctx.root,
+                context: ctx,
+                display,
+                permissions,
+                initialHistory: activeChatHistory,
+            });
+            const altResult = await alternator.run(task);
+            result = altResult.loopResult;
+            alternatorHandledEpisode = true; // alternator.run() already saved its own episode
+        }
         else {
             result = await (0, loop_js_1.runAgentLoop)({
                 provider, task, context: ctx, permissions, display,
@@ -853,26 +880,30 @@ async function main() {
                 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
+        // Persist episode for Ruby Principle training data — skip when
+        // RubyAlternator already saved its own (richer) episode above, to
+        // avoid double-counting every task in the stats/dashboard.
+        if (!alternatorHandledEpisode) {
+            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;
@@ -920,6 +951,7 @@ async function main() {
                     permissions, cumulative,
                     chatState: { projectRoot, activeChatId, activeChatHistory, activeChatTitle, noSession },
                     rl,
+                    rubyEnabled: { ...types_js_1.DEFAULT_RUBY_CONFIG, ...fileConfig.ruby }.enabled,
                 };
                 const cmdResult = await handleReplCommand(input, replCtx);
                 if (cmdResult.handled) {
@@ -930,11 +962,19 @@ async function main() {
                         activeChatHistory = cmdResult.newHistory;
                     if (cmdResult.newTitle !== undefined)
                         activeChatTitle = cmdResult.newTitle;
+                    // :ruby on/off persists by mutating the loaded config the gate reads.
+                    if (cmdResult.rubyEnabled !== undefined) {
+                        fileConfig.ruby = { ...fileConfig.ruby, enabled: cmdResult.rubyEnabled };
+                    }
                     ask();
                     return;
                 }
                 // Run task — pass current conversation history for stay-active mode
-                // ── RubyAlternator: suggest model from competence history ──────────────
+                // ── Competence-based model selection ───────────────────────────────
+                // Picks the best-performing model among already-configured, same-family
+                // options based on task similarity to past episodes. Distinct from
+                // RubyAlternator below — this only chooses among models you've already
+                // set up; it never tries a free local model first.
                 // Only when the user has NOT set a model explicitly via --model or :model
                 if (!userSetModel && !globalCfg?.defaultModel) {
                     try {
@@ -957,8 +997,16 @@ async function main() {
                 let result;
                 try {
                     const currentProvider = buildProvider(display);
+                    const replConfirmFn = async (msg) => new Promise(res => {
+                        rl.question(`\n⚠️  ${msg} [y/N] `, a => {
+                            res(a.trim().toLowerCase() === 'y' || a.trim().toLowerCase() === 'yes');
+                        });
+                    });
                     const doVerify = argv.verify === true || !!fileConfig.verify;
+                    const rubyConfig = { ...types_js_1.DEFAULT_RUBY_CONFIG, ...fileConfig.ruby };
                     if (doVerify) {
+                        // Ruby-alternation doesn't support the verification wrapper yet —
+                        // a verified task always runs directly against the selected model.
                         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;
@@ -968,11 +1016,7 @@ async function main() {
                                 context: ctx, permissions, display,
                                 initialHistory: activeChatHistory,
                                 maxTurns: resolved.maxTurns,
-                                confirmFn: async (msg) => new Promise(res => {
-                                    rl.question(`\\n⚠️  ${msg} [y/N] `, a => {
-                                        res(a.trim().toLowerCase() === 'y' || a.trim().toLowerCase() === 'yes');
-                                    });
-                                }),
+                                confirmFn: replConfirmFn,
                                 spawnConfig: {
                                     apiKey: runtimeConfig.apiKey,
                                     baseUrl: runtimeConfig.baseUrl ?? undefined,
@@ -985,17 +1029,27 @@ async function main() {
                         });
                         result = wrapperResult.loopResult;
                     }
+                    else if (rubyConfig.enabled) {
+                        const alternator = new alternator_js_1.RubyAlternator({
+                            rubyConfig,
+                            largeModelProvider: currentProvider,
+                            projectRoot: ctx.root,
+                            context: ctx,
+                            display,
+                            permissions,
+                            confirmFn: replConfirmFn,
+                            initialHistory: activeChatHistory,
+                        });
+                        const altResult = await alternator.run(input);
+                        result = altResult.loopResult;
+                    }
                     else {
                         result = await (0, loop_js_1.runAgentLoop)({
                             provider: currentProvider, task: input,
                             context: ctx, permissions, display,
                             initialHistory: activeChatHistory,
                             maxTurns: resolved.maxTurns,
-                            confirmFn: async (msg) => new Promise(res => {
-                                rl.question(`\\n⚠️  ${msg} [y/N] `, a => {
-                                    res(a.trim().toLowerCase() === 'y' || a.trim().toLowerCase() === 'yes');
-                                });
-                            }),
+                            confirmFn: replConfirmFn,
                             spawnConfig: {
                                 apiKey: runtimeConfig.apiKey,
                                 baseUrl: runtimeConfig.baseUrl ?? undefined,
@@ -1165,15 +1219,30 @@ async function handleReplCommand(input, c) {
             '  ── Context / Stats ──────────────────────────────',
             '  :context                Show loaded project context',
             '  :graph                  Show codebase knowledge graph summary',
-            '  :graph refresh          Reload graph from graphify-out/graph.json',
+            '  :graph refresh          Extract + persist codebase graph',
+            '  :stats                  Show episode-level stats (completion rate, models, tokens)',
             '  :plans                  List saved execution plans',
             '  :viz, :dashboard        Generate and open the memory dashboard',
-            '  /stats, /usage          Show token + cost usage this session',
+            '  :dream                  [experimental] Consolidate today\'s episodes into a dated dream (dreams/*.md)',
+            '  :dream full             [experimental] Consolidate ALL episodes, ignoring the last-dream cutoff',
+            '  :rem                    [experimental] List dream files and open the most recent one',
+            '  :research <topic>       Multi-step research pass, saved to research/*.md (inspired by DeerFlow)',
+            '  :council <topic>        Ecclesia — 5 independent agents research the topic, synthesized into one verdict (council/*.md)',
+            '  :ruby [on|off]          Toggle the Ruby Principle (default: off)',
+            '  ⚠ :machina               The Abstract Agent Machine — formal model, verified against this source tree',
+            '  ⚠ :machina --html        Also write the full writeup + diagram to docs/machina.html',
+            '  :design [slug|list|off] Set/list the design system auto-applied to UI builds',
+            '  /stats, /usage, :usage  Show token + cost usage this session',
             '  /clear, /reset          Reset cumulative usage stats',
             '',
             '  ── General ──────────────────────────────────────',
+            '  :approve all            Auto-approve all tool calls (no confirmations)',
+            '  :approve normal         Require confirmation for destructive ops',
+            '  :approve read-only      Block all write operations',
             '  :quit, :q, /exit        Exit',
             '',
+            '  ⚠ = extremely high token usage — reads multiple source files and writes a careful long-form result',
+            '',
         ].join('\n')));
         return { handled: true };
     }
@@ -1301,6 +1370,180 @@ async function handleReplCommand(input, c) {
         }
         return { handled: true };
     }
+    if (input === ':dream' || input === ':dream full') {
+        const full = input === ':dream full';
+        console.log(chalk_1.default.hex('#8a7768')('\n  Dreaming — consolidating episodes…\n'));
+        try {
+            const { runDream } = await Promise.resolve().then(() => __importStar(require('../dream/dream.js')));
+            const { createResilientProvider } = await Promise.resolve().then(() => __importStar(require('../providers/resilient-factory.js')));
+            const provider = createResilientProvider({ model: c.providerConfig.model, apiKey: c.providerConfig.apiKey, baseUrl: c.providerConfig.baseUrl }, {}, c.display);
+            const res = await runDream({ projectRoot: c.ctx.root, provider, full });
+            if (res.skipped) {
+                console.log(chalk_1.default.hex('#cc9e5c')(`  ⤳ Nothing to dream about — ${res.reason}.\n`));
+            }
+            else {
+                console.log(chalk_1.default.hex('#5a9e6e')(`  ✓ Dream written: ${res.path}`));
+                console.log(chalk_1.default.hex('#8a7768')(`  Consolidated ${res.episodeCount} episode(s).\n`));
+            }
+        }
+        catch (e) {
+            console.log(chalk_1.default.hex('#b15439')(`  ✗ ${String(e)}\n`));
+        }
+        return { handled: true };
+    }
+    if (input.startsWith(':research ')) {
+        const topic = input.slice(':research '.length).trim();
+        if (!topic) {
+            console.log(chalk_1.default.hex('#b15439')('\n  Usage: :research <topic>\n'));
+            return { handled: true };
+        }
+        console.log(chalk_1.default.hex('#8a7768')(`\n  Researching "${topic}"…\n`));
+        try {
+            const { runResearch } = await Promise.resolve().then(() => __importStar(require('../research/research.js')));
+            const { createResilientProvider } = await Promise.resolve().then(() => __importStar(require('../providers/resilient-factory.js')));
+            const provider = createResilientProvider({ model: c.providerConfig.model, apiKey: c.providerConfig.apiKey, baseUrl: c.providerConfig.baseUrl }, {}, c.display);
+            const res = await runResearch({
+                projectRoot: c.ctx.root,
+                topic,
+                provider,
+                context: c.ctx,
+                permissions: c.permissions,
+                display: c.display,
+            });
+            console.log(chalk_1.default.hex('#5a9e6e')(`  ✓ Research written: ${res.path}`));
+            console.log(chalk_1.default.hex('#8a7768')(`  ${res.turns} turn(s) · ${res.toolCalls} tool call(s).\n`));
+        }
+        catch (e) {
+            console.log(chalk_1.default.hex('#b15439')(`  ✗ ${String(e)}\n`));
+        }
+        return { handled: true };
+    }
+    if (input.startsWith(':council ')) {
+        let rest = input.slice(':council '.length).trim();
+        const wantsReader = /(^|\s)--reader(\s|$)/.test(rest);
+        rest = rest.replace(/(^|\s)--reader(\s|$)/g, ' ').trim();
+        const stray = rest.match(/(^|\s)(--\S+)/);
+        if (stray) {
+            console.log(chalk_1.default.hex('#b15439')(`\n  ✗ Unknown flag: ${stray[2]}. Did you mean --reader?\n`));
+            return { handled: true };
+        }
+        const topic = rest;
+        if (!topic) {
+            console.log(chalk_1.default.hex('#b15439')('\n  Usage: :council <topic> [--reader]\n'));
+            return { handled: true };
+        }
+        console.log(chalk_1.default.hex('#8a7768')(`\n  Convening Ecclesia on "${topic}" — 5 independent agents…\n`));
+        try {
+            const { runCouncil } = await Promise.resolve().then(() => __importStar(require('../research/council.js')));
+            const { createResilientProvider } = await Promise.resolve().then(() => __importStar(require('../providers/resilient-factory.js')));
+            const synthesisProvider = createResilientProvider({ model: c.providerConfig.model, apiKey: c.providerConfig.apiKey, baseUrl: c.providerConfig.baseUrl }, {}, c.display);
+            const res = await runCouncil({
+                projectRoot: c.ctx.root,
+                topic,
+                synthesisProvider,
+                context: c.ctx,
+                permissions: c.permissions,
+                display: c.display,
+            });
+            console.log(chalk_1.default.hex('#5a9e6e')(`  ✓ Ecclesia verdict: ${res.path}`));
+            console.log(chalk_1.default.hex('#8a7768')(`  ${res.panelSize} agents` + (res.agentFailures > 0 ? `, ${res.agentFailures} failed` : '') + `.\n`));
+            if (wantsReader) {
+                const { renderReaderFromMarkdown } = await Promise.resolve().then(() => __importStar(require('../viz/reader.js')));
+                const readerPath = renderReaderFromMarkdown(res.path);
+                console.log(chalk_1.default.hex('#5a9e6e')(`  ✓ Reader: ${readerPath}`));
+                console.log(chalk_1.default.hex('#8a7768')('  Opening in browser…\n'));
+                (0, index_js_1.openDashboard)(readerPath);
+            }
+        }
+        catch (e) {
+            console.log(chalk_1.default.hex('#b15439')(`  ✗ ${String(e)}\n`));
+        }
+        return { handled: true };
+    }
+    if (input === ':rem') {
+        const dir = path.join(c.ctx.root, 'dreams');
+        let files = [];
+        try {
+            files = fs.readdirSync(dir).filter(f => f.endsWith('.md') && !f.startsWith('.')).sort().reverse();
+        }
+        catch { /* no dreams dir */ }
+        if (files.length === 0) {
+            console.log(chalk_1.default.hex('#8a7768')('\n  No dreams yet. Run :dream after some work.\n'));
+        }
+        else {
+            console.log(chalk_1.default.hex('#cc785c').bold('\n  Dreams\n'));
+            for (const f of files.slice(0, 20))
+                console.log(chalk_1.default.hex('#ede0cc')(`  ${f}`));
+            // Prefer reconciled view if it exists
+            const reconciledPath = path.join(dir, '.reconciled.md');
+            const hasReconciled = fs.existsSync(reconciledPath);
+            if (hasReconciled) {
+                console.log(chalk_1.default.hex('#5a9e6e')(`\n  ✓ Reconciled memory (${files.length} dreams → projection):\n`));
+                console.log(chalk_1.default.hex('#ede0cc')(fs.readFileSync(reconciledPath, 'utf8')));
+            }
+            else {
+                const latest = path.join(dir, files[0]);
+                console.log(chalk_1.default.hex('#8a7768')(`\n  Most recent: ${latest}\n`));
+                console.log(chalk_1.default.hex('#4e3d30')(fs.readFileSync(latest, 'utf8')));
+                if (files.length >= 3) {
+                    console.log(chalk_1.default.hex('#8a7768')('  💡 Run :dream to trigger memory reconciliation (≥3 dreams).\n'));
+                }
+            }
+        }
+        return { handled: true };
+    }
+    if (input === ':ruby' || input === ':ruby on' || input === ':ruby off') {
+        if (input === ':ruby') {
+            const state = c.rubyEnabled ? chalk_1.default.hex('#5a9e6e')('ON') : chalk_1.default.hex('#b15439')('OFF');
+            console.log(chalk_1.default.hex('#8a7768')(`\n  Ruby Principle is ${state}. Use :ruby on / :ruby off to change.\n`));
+            return { handled: true };
+        }
+        const on = input === ':ruby on';
+        c.rubyEnabled = on;
+        const state = on ? chalk_1.default.hex('#5a9e6e')('ON') : chalk_1.default.hex('#b15439')('OFF');
+        console.log(chalk_1.default.hex('#8a7768')(`\n  Ruby Principle is now ${state} for this session.\n`));
+        return { handled: true, rubyEnabled: on };
+    }
+    if (input === ':machina' || input === ':machina --html' || input === ':machina -html') {
+        const wantsHtml = input !== ':machina';
+        console.log(chalk_1.default.hex('#b15439')('\n  ⚠ :machina reads several source files and writes a careful long-form result — extremely high token usage.\n'));
+        const { runMachina } = await Promise.resolve().then(() => __importStar(require('../machina/index.js')));
+        const res = runMachina({ outputRoot: c.ctx.root, writeHtml: wantsHtml });
+        console.log(res.terminalOutput);
+        if (res.htmlPath) {
+            console.log(chalk_1.default.hex('#5a9e6e')(`  ✓ Written: ${res.htmlPath}\n`));
+        }
+        return { handled: true };
+    }
+    if (input === ':design' || input.startsWith(':design ')) {
+        const { listDesignSlugs } = await Promise.resolve().then(() => __importStar(require('../agent/design.js')));
+        const slugs = listDesignSlugs(c.ctx.root);
+        const arg = input.slice(':design'.length).trim();
+        if (slugs.length === 0) {
+            console.log(chalk_1.default.hex('#b15439')('\n  No design-systems/ folder found in this project.\n'));
+            return { handled: true };
+        }
+        if (arg === '' || arg === 'list') {
+            const current = process.env.AURA_DESIGN || 'terracotta';
+            console.log(chalk_1.default.hex('#cc785c').bold(`\n  Design systems (${slugs.length}) — default: ${current}\n`));
+            console.log(chalk_1.default.hex('#ede0cc')('  ' + slugs.join('  ')));
+            console.log(chalk_1.default.hex('#8a7768')('\n  :design <slug> sets the default · auto-applies on website/UI tasks.\n'));
+            return { handled: true };
+        }
+        if (arg === 'off') {
+            process.env.AURA_DESIGN = '__none__';
+            console.log(chalk_1.default.hex('#8a7768')('\n  Design auto-injection disabled for this session.\n'));
+            return { handled: true };
+        }
+        if (slugs.includes(arg)) {
+            process.env.AURA_DESIGN = arg;
+            console.log(chalk_1.default.hex('#5a9e6e')(`\n  Default design set to "${arg}" for this session.\n`));
+        }
+        else {
+            console.log(chalk_1.default.hex('#b15439')(`\n  Unknown design "${arg}". Run :design to list available slugs.\n`));
+        }
+        return { handled: true };
+    }
     if (input === ':plans') {
         const { planStore } = await Promise.resolve().then(() => __importStar(require('../orchestration/plan-store.js')));
         const plans = await planStore.list();
@@ -1323,24 +1566,25 @@ async function handleReplCommand(input, c) {
         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')));
+        console.log(chalk_1.default.hex('#8a7768')('\n  Extracting codebase graph...\n'));
         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 */ }
+            const perception = await (0, index_js_4.extractPerception)(c.ctx.root);
+            await (0, index_js_4.savePerception)(perception);
+            await (0, index_js_4.saveGraphForViz)(perception);
+            const nodeCount = perception.nodes.length;
+            const edgeCount = perception.edges.length;
+            console.log(chalk_1.default.hex('#5a9e6e')(`  ✓ Extracted ${nodeCount} nodes, ${edgeCount} edges.\n`));
+        }
+        catch (err) {
+            console.log(chalk_1.default.hex('#f85149')(`  ✗ Extraction failed: ${err instanceof Error ? err.message : String(err)}\n`));
+        }
         // 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'));
+            console.log(chalk_1.default.hex('#8a7768')('  No graph.json found after refresh.\n'));
         }
         return { handled: true };
     }
@@ -1406,7 +1650,39 @@ async function handleReplCommand(input, c) {
         console.log(chalk_1.default.hex('#5a9e6e')('  ✓ Session stats reset'));
         return { handled: true };
     }
-    if (input === '/stats' || input === '/usage') {
+    // ── Permission commands ──────────────────────────────────────────────────
+    if (input.startsWith(':approve ')) {
+        const raw = input.slice(':approve '.length).trim();
+        const mapped = raw === 'all' ? 'auto' : raw;
+        if (mapped !== 'auto' && mapped !== 'normal' && mapped !== 'read-only') {
+            console.log(chalk_1.default.hex('#b15439')('  ✗ Usage: :approve all | :approve normal | :approve read-only'));
+            return { handled: true };
+        }
+        c.permissions.setLevel(mapped);
+        console.log(chalk_1.default.hex('#5a9e6e')(`  ✓ Permission level set to ${mapped}`));
+        return { handled: true };
+    }
+    if (input === ':stats') {
+        // Episode-level stats (same as --stats CLI flag)
+        const episodes = await (0, episode_capture_js_1.loadEpisodes)(c.chatState.projectRoot);
+        const output = (0, stats_js_1.formatStats)(episodes);
+        for (const line of output.split('\n')) {
+            if (line.trim() === 'Aura Stats') {
+                console.log(chalk_1.default.hex('#cc785c').bold(line));
+            }
+            else if (line.includes(':')) {
+                const colonIdx = line.indexOf(':');
+                const label = line.slice(0, colonIdx + 1);
+                const value = line.slice(colonIdx + 1);
+                console.log(chalk_1.default.hex('#8a7768')(label) + chalk_1.default.hex('#ede0cc')(value));
+            }
+            else {
+                console.log(line);
+            }
+        }
+        return { handled: true };
+    }
+    if (input === '/stats' || input === '/usage' || input === ':usage') {
         const u = c.cumulative;
         const total = u.inputTokens + u.outputTokens;
         console.log(chalk_1.default.hex('#8a7768')([
@@ -1790,6 +2066,7 @@ ${chalk_1.default.hex('#cc785c').bold('  aura')} ${chalk_1.default.hex('#8a7768'
     --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
+    --stats                  Show episode stats — completion rate, avg duration, top model, tokens
     --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