@aionlabsai/aion 0.2.0

package/dist/cli/commands/audit.js

@@ -0,0 +1,189 @@
+import chalk from 'chalk';
+import { mkdirSync, writeFileSync } from 'fs';
+import { join } from 'path';
+import { Orchestrator } from '../../core/orchestrator.js';
+import { AuditPipeline } from '../../core/pipelines/audit-pipeline.js';
+import { createRuntimePolicy } from '../../core/runtime-policy.js';
+import { CostTracker } from '../../core/cost-tracker.js';
+import { Renderer } from '../ui/renderer.js';
+const SEVERITY_COLOR = {
+    critical: chalk.bgRed.white.bold,
+    high: chalk.red.bold,
+    medium: chalk.yellow,
+    low: chalk.gray,
+    info: chalk.dim,
+};
+const SEVERITY_ICON = {
+    critical: '🔴',
+    high: '🟠',
+    medium: '🟡',
+    low: '⚪',
+    info: '🔵',
+};
+function renderAuditReport(report, durationMs) {
+    console.log('\n' + chalk.bold('═'.repeat(60)));
+    console.log(chalk.bold.cyan('  AUDIT REPORT') + chalk.gray(` — ${report.totalFiles} files — ${(durationMs / 1000).toFixed(1)}s`));
+    console.log(chalk.bold('═'.repeat(60)));
+    // Summary
+    console.log('\n' + chalk.bold('Summary:'));
+    console.log('  ' + report.summary);
+    // Counts
+    const counts = [
+        report.criticalCount > 0 ? chalk.bgRed.white.bold(` ${report.criticalCount} critical `) : null,
+        report.highCount > 0 ? chalk.red.bold(`${report.highCount} high`) : null,
+        chalk.gray(`${report.findings.filter(f => f.severity === 'medium').length} medium`),
+        chalk.gray(`${report.findings.filter(f => f.severity === 'low').length} low`),
+    ].filter(Boolean);
+    console.log('\n' + chalk.bold('Severity:') + '  ' + counts.join('  '));
+    // Top priorities
+    if (report.topPriorities.length > 0) {
+        console.log('\n' + chalk.bold('Top Priorities:'));
+        report.topPriorities.forEach((p, i) => {
+            console.log(chalk.cyan(`  ${i + 1}.`) + ' ' + p);
+        });
+    }
+    // Findings: if sections exist, render by domain; otherwise by severity
+    const auditReport = report;
+    if (auditReport.sections && auditReport.sections.length > 0) {
+        for (const section of auditReport.sections) {
+            if (section.findings.length === 0)
+                continue;
+            console.log('\n' + chalk.bold.blue(`  ▸ ${section.domain.toUpperCase()} (${section.findings.length})`));
+            for (const f of section.findings) {
+                const loc = f.line ? `${f.file}:${f.line}` : f.file;
+                const color = SEVERITY_COLOR[f.severity] ?? chalk.white;
+                console.log(color(`  ${loc}`) + chalk.gray(` [${f.severity}]`));
+                console.log(`    ${f.finding}`);
+                console.log(chalk.dim(`    → ${f.recommendation}`));
+                console.log();
+            }
+        }
+    }
+    else {
+        const order = ['critical', 'high', 'medium', 'low', 'info'];
+        for (const sev of order) {
+            const group = report.findings.filter(f => f.severity === sev);
+            if (group.length === 0)
+                continue;
+            const color = SEVERITY_COLOR[sev] ?? chalk.white;
+            const icon = SEVERITY_ICON[sev] ?? '';
+            console.log('\n' + color(` ${icon} ${sev.toUpperCase()} (${group.length}) `));
+            for (const f of group) {
+                const loc = f.line ? `${f.file}:${f.line}` : f.file;
+                console.log(chalk.bold(`  ${loc}`) + chalk.gray(` [${f.category}]`));
+                console.log(`    ${f.finding}`);
+                console.log(chalk.dim(`    → ${f.recommendation}`));
+                console.log();
+            }
+        }
+    }
+    console.log(chalk.bold('═'.repeat(60)));
+}
+function saveAuditReport(report, durationMs) {
+    const dir = join(process.cwd(), '.ai-runtime', 'reports');
+    mkdirSync(dir, { recursive: true });
+    const stamp = new Date().toISOString().replace(/[:.]/g, '-');
+    const file = join(dir, `audit-${stamp}.json`);
+    writeFileSync(file, JSON.stringify({ ...report, durationMs, createdAt: new Date().toISOString() }, null, 2), 'utf8');
+    return file;
+}
+function renderDryRun(stats) {
+    console.log('\n' + chalk.bold.cyan('Audit dry run'));
+    console.log(chalk.gray('No agents were started and no API tokens were used.'));
+    console.log(`  total files seen: ${stats.totalFiles}`);
+    console.log(`  audit source files: ${stats.auditFiles.length}`);
+    console.log(`  ignored directories: ${stats.ignoredDirs}`);
+    console.log(`  ignored/non-source files: ${stats.ignoredFiles}`);
+    console.log(`  oversized source files: ${stats.oversizedFiles}`);
+    const exts = Object.entries(stats.byExtension).sort((a, b) => b[1] - a[1]);
+    if (exts.length > 0) {
+        console.log('\n' + chalk.bold('Extensions:'));
+        exts.forEach(([ext, count]) => console.log(`  ${ext}: ${count}`));
+    }
+    if (stats.auditFiles.length > 0) {
+        console.log('\n' + chalk.bold('Sample:'));
+        stats.auditFiles.slice(0, 10).forEach((file) => console.log(`  ${file}`));
+    }
+}
+export function registerAudit(program) {
+    program
+        .command('audit [target]')
+        .description('Deep parallel audit: N scanners cover all files, synthesizer unifies findings')
+        .option('-n, --scanners <n>', 'number of scanner agents (auto-selected if omitted)')
+        .option('--budget <budget>', 'low | normal | deep (default: low)', 'low')
+        .option('--provider <provider>', 'claude | openrouter (default: claude)')
+        .option('--model <model>', 'model override for openrouter (e.g. moonshotai/kimi-k2)')
+        .option('--preset <name>', 'persona preset: security, ai, backend, devops, quality, saas, fintech, full')
+        .option('--domains <list>', 'comma-separated scanner domains, e.g. security,compliance,data')
+        .option('--list-personas', 'show all available personas and presets then exit')
+        .option('--fix', 'auto-fix critical/high findings after audit')
+        .option('--fix-max <n>', 'max findings to auto-fix (default: 5)', '5')
+        .option('--fix-min-severity <s>', 'minimum severity to fix: critical|high|medium (default: high)', 'high')
+        .option('--dry-run', 'collect audit file stats without starting agents')
+        .action(async (target = '.', options) => {
+        if (options.listPersonas) {
+            const { listPresets, BUILT_IN_PRESETS } = await import('../../infra/persona-presets.js');
+            console.log(chalk.bold.cyan('\nPersonas (scanner domains):\n'));
+            const allDomains = [
+                'security', 'bugs', 'redundancy', 'error-handling', 'architecture', 'testing', 'performance',
+                'infrastructure', 'observability', 'resilience', 'data', 'dependencies', 'compliance', 'multitenancy', 'prompt-audit',
+            ];
+            allDomains.forEach((d) => console.log(`  ${chalk.cyan(d)}`));
+            listPresets();
+            return;
+        }
+        const explicitN = options.scanners ? Math.max(1, Math.min(15, parseInt(options.scanners, 10) || 5)) : undefined;
+        const budget = (['low', 'normal', 'deep'].includes(options.budget) ? options.budget : 'low');
+        const providerName = options.provider === 'openrouter' ? 'openrouter' : undefined;
+        const policyInput = {
+            budget,
+            ...(options.model ? { openrouterModel: options.model } : {}),
+            ...(providerName ? {
+                plannerProvider: providerName,
+                investigatorProvider: providerName,
+                developerProvider: providerName,
+                reviewerProvider: providerName,
+            } : {}),
+        };
+        const policy = createRuntimePolicy(policyInput);
+        const renderer = new Renderer();
+        const orch = new Orchestrator(process.cwd(), policyInput);
+        if (options.dryRun) {
+            const pipeline = new AuditPipeline(process.cwd(), policy, new CostTracker(), () => { }, () => { });
+            renderDryRun(pipeline.collectAuditStats(target));
+            return;
+        }
+        orch.on('agent:start', ({ agentName }) => renderer.agentStart(agentName));
+        orch.on('agent:output', ({ agentName, text }) => renderer.agentChunk(agentName, text));
+        orch.on('agent:done', ({ agentName, durationMs }) => renderer.agentDone(agentName, durationMs));
+        // Resolve persona domains
+        const { resolveDomainsFromConfig } = await import('../../infra/persona-presets.js');
+        const { domains: explicitDomains, source: domainSource } = resolveDomainsFromConfig(process.cwd(), options.preset, options.domains, explicitN);
+        const start = Date.now();
+        const nLabel = explicitDomains.length > 0
+            ? `personas: ${explicitDomains.join(', ')} [${domainSource}]`
+            : explicitN ? `${explicitN} scanners` : `auto scanners (${budget} budget)`;
+        console.log(chalk.bold.cyan(`\nStarting audit with ${nLabel}...\n`));
+        try {
+            const report = await orch.runAuditPipeline(target, explicitN, explicitDomains.length > 0 ? explicitDomains : undefined);
+            const durationMs = Date.now() - start;
+            renderAuditReport(report, durationMs);
+            console.log(chalk.gray(`report: ${saveAuditReport(report, durationMs)}`));
+            console.log(chalk.dim(orch.costs.summary()));
+            if (options.fix && (report.criticalCount > 0 || report.highCount > 0)) {
+                const maxFixes = Math.max(1, Math.min(20, parseInt(options.fixMax, 10) || 5));
+                const minSev = (['critical', 'high', 'medium'].includes(options.fixMinSeverity)
+                    ? options.fixMinSeverity : 'high');
+                console.log(chalk.bold.yellow(`\nAuto-fixing up to ${maxFixes} ${minSev}+ findings...\n`));
+                const fixReport = await orch.runAuditFixPipeline(report, { maxFixes, minSeverity: minSev });
+                console.log(chalk.bold(`Fix summary: ${fixReport.succeeded} fixed, ${fixReport.failed} failed, ${fixReport.skipped} skipped`));
+            }
+            process.exit(report.criticalCount > 0 ? 2 : report.highCount > 0 ? 1 : 0);
+        }
+        catch (err) {
+            renderer.showError(err);
+            process.exit(1);
+        }
+    });
+}
+//# sourceMappingURL=audit.js.map

package/dist/cli/commands/audit.js.map

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

package/dist/cli/commands/churn.d.ts

@@ -0,0 +1,3 @@
+import type { Command } from 'commander';
+export declare function registerChurn(program: Command): void;
+//# sourceMappingURL=churn.d.ts.map

package/dist/cli/commands/churn.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"churn.d.ts","sourceRoot":"","sources":["../../../src/cli/commands/churn.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAYzC,wBAAgB,aAAa,CAAC,OAAO,EAAE,OAAO,GAAG,IAAI,CA6EpD"}

package/dist/cli/commands/churn.js

@@ -0,0 +1,76 @@
+import chalk from 'chalk';
+import { buildChurnReport } from '../../infra/git-analysis.js';
+import { GraphAgent } from '../../agents/graph-agent.js';
+const RISK_COLOR = {
+    critical: chalk.bgRed.white.bold,
+    high: chalk.red.bold,
+    medium: chalk.yellow,
+    low: chalk.gray,
+};
+export function registerChurn(program) {
+    program
+        .command('churn [target]')
+        .description('Git churn analysis: files changed most often + bus factor (knowledge silos)')
+        .option('--days <n>', 'lookback period in days', '90')
+        .option('--top <n>', 'number of files to show', '20')
+        .option('--bus-factor-days <n>', 'bus factor lookback in days', '180')
+        .action(async (_target = '.', options) => {
+        const cwd = process.cwd();
+        const days = parseInt(options.days, 10) || 90;
+        const top = parseInt(options.top, 10) || 20;
+        const bfDays = parseInt(options.busFactorDays, 10) || 180;
+        console.log(chalk.bold.cyan(`\nGit Analysis — last ${days} days\n`));
+        // Get hotspot files from graph index for bus factor
+        let hotspotFiles = [];
+        try {
+            const graph = new GraphAgent(cwd);
+            const index = graph.getIndex();
+            if (index) {
+                // Import dep-graph lazily
+                const { detectLang } = await import('../../infra/lang-detect.js');
+                const { buildDepGraph } = await import('../../infra/dep-graph.js');
+                const { buildPythonDepGraph } = await import('../../infra/dep-graph-python.js');
+                const lang = detectLang(cwd);
+                const dep = lang.lang === 'python' ? buildPythonDepGraph(cwd) : buildDepGraph(cwd);
+                hotspotFiles = dep.hotspots.map((h) => h.file);
+            }
+        }
+        catch { /* best-effort */ }
+        const report = buildChurnReport(cwd, hotspotFiles, days);
+        if (report.churn.length === 0) {
+            console.log(chalk.yellow('No git history found. Is this a git repository?'));
+            return;
+        }
+        console.log(chalk.bold(`── Churn (${report.totalCommits} total commits) ─────────────────────`));
+        const topChurn = report.churn.slice(0, top);
+        topChurn.forEach((entry) => {
+            const riskFn = RISK_COLOR[entry.risk] ?? chalk.white;
+            const bar = '█'.repeat(Math.min(20, Math.ceil(entry.commits / 2)));
+            console.log(riskFn(`  ${entry.commits.toString().padStart(3)} commits`) +
+                chalk.gray(` ${entry.authors}👤 `) +
+                chalk.white(entry.file) +
+                chalk.dim(` ${bar}`));
+        });
+        if (report.busFactor.length > 0) {
+            console.log(chalk.bold(`\n── Bus Factor (last ${bfDays} days) ────────────────────────────`));
+            console.log(chalk.gray('  Files where most commits come from a single author\n'));
+            report.busFactor.slice(0, top).forEach((entry) => {
+                const riskFn = RISK_COLOR[entry.risk] ?? chalk.white;
+                console.log(riskFn(`  ${entry.primaryPercent.toString().padStart(3)}%`) +
+                    chalk.gray(` ${entry.totalAuthors} author${entry.totalAuthors === 1 ? '' : 's'}  `) +
+                    chalk.white(entry.file) +
+                    chalk.dim(`  (${entry.primaryAuthor})`));
+            });
+        }
+        // Risk intersection: high churn + high bus factor
+        const churnHighFiles = new Set(report.churn.filter((c) => c.risk === 'critical' || c.risk === 'high').map((c) => c.file));
+        const bfHighFiles = report.busFactor.filter((b) => b.risk === 'critical' || b.risk === 'high').map((b) => b.file);
+        const intersection = bfHighFiles.filter((f) => churnHighFiles.has(f));
+        if (intersection.length > 0) {
+            console.log(chalk.bold.red(`\n⚠ HIGH RISK: High churn + single author (${intersection.length} files)`));
+            intersection.forEach((f) => console.log(chalk.red(`  ${f}`)));
+        }
+        console.log(chalk.dim(`\nPeriod: ${days} days · ${report.totalCommits} commits · ${report.churn.length} files changed`));
+    });
+}
+//# sourceMappingURL=churn.js.map

package/dist/cli/commands/churn.js.map

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

package/dist/cli/commands/explain.d.ts

@@ -0,0 +1,3 @@
+import type { Command } from 'commander';
+export declare function registerExplain(program: Command): void;
+//# sourceMappingURL=explain.d.ts.map

package/dist/cli/commands/explain.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"explain.d.ts","sourceRoot":"","sources":["../../../src/cli/commands/explain.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAoFzC,wBAAgB,eAAe,CAAC,OAAO,EAAE,OAAO,GAAG,IAAI,CA2CtD"}

package/dist/cli/commands/explain.js

@@ -0,0 +1,115 @@
+import chalk from 'chalk';
+import { ExplainAgent } from '../../agents/explain-agent.js';
+import { GraphAgent } from '../../agents/graph-agent.js';
+import { createRuntimePolicy } from '../../core/runtime-policy.js';
+import { addRuntimeOptions, toRuntimePolicyInput } from '../runtime-options.js';
+async function buildFileContext(cwd, filePath) {
+    const graph = new GraphAgent(cwd);
+    const index = graph.getIndex() ?? await graph.buildIndex();
+    const fileEntry = index.files.find((f) => f.path === filePath || f.path.endsWith(filePath));
+    if (!fileEntry)
+        return `File: ${filePath}\n(not found in repo index)`;
+    const symbols = index.symbols.filter((s) => s.file === fileEntry.path).slice(0, 15);
+    const imports = index.imports.filter((i) => i.from === fileEntry.path).slice(0, 10);
+    const importedBy = index.imports.filter((i) => i.resolved === fileEntry.path).slice(0, 15);
+    const tests = index.tests.find((t) => t.source === fileEntry.path);
+    const lines = [
+        `File: ${fileEntry.path}`,
+        `LOC: ${fileEntry.loc} | Test: ${fileEntry.isTest}`,
+        symbols.length > 0 ? `\nExported symbols:\n${symbols.map((s) => `  ${s.kind} ${s.name} (line ${s.line})`).join('\n')}` : '',
+        imports.length > 0 ? `\nImports:\n${imports.map((i) => `  ${i.specifier}`).join('\n')}` : '',
+        importedBy.length > 0 ? `\nImported by (${importedBy.length} modules):\n${importedBy.slice(0, 8).map((i) => `  ${i.from}`).join('\n')}` : '',
+        tests ? `\nTest files: ${tests.tests.join(', ')}` : '',
+    ];
+    return lines.filter(Boolean).join('\n');
+}
+async function buildOnboardContext(cwd) {
+    const graph = new GraphAgent(cwd);
+    const index = graph.getIndex() ?? await graph.buildIndex();
+    let depInfo = '';
+    try {
+        const { detectLang } = await import('../../infra/lang-detect.js');
+        const { buildDepGraph } = await import('../../infra/dep-graph.js');
+        const { buildPythonDepGraph } = await import('../../infra/dep-graph-python.js');
+        const { detectPatterns } = await import('../../infra/pattern-detect.js');
+        const lang = detectLang(cwd);
+        const dep = lang.lang === 'python' ? buildPythonDepGraph(cwd) : buildDepGraph(cwd);
+        const patterns = detectPatterns(cwd, dep.hotspots);
+        const hotspots = dep.hotspots.slice(0, 8);
+        const cycles = dep.cycles.length;
+        depInfo = [
+            `\nHotspot files (highest coupling):\n${hotspots.map((h) => `  ${h.file} (fanIn:${h.fanIn} fanOut:${h.fanOut})`).join('\n')}`,
+            cycles > 0 ? `\nCircular dependencies: ${cycles}` : '',
+            `\nDetected patterns: ${patterns.detected.map((p) => p.pattern).join(', ')}`,
+            patterns.antiPatterns.length > 0 ? `\nAnti-patterns: ${patterns.antiPatterns.map((a) => a.name).join(', ')}` : '',
+        ].filter(Boolean).join('\n');
+    }
+    catch { /* best-effort */ }
+    const topDirs = [...new Set(index.files.slice(0, 100).map((f) => f.path.split('/')[0]))].slice(0, 10);
+    const testRatio = Math.round((index.files.filter((f) => f.isTest).length / Math.max(index.files.length, 1)) * 100);
+    return [
+        `Project: ${cwd.split('/').pop()}`,
+        `Files: ${index.stats.files} | Symbols: ${index.stats.symbols} | Test ratio: ${testRatio}%`,
+        `Top-level directories: ${topDirs.join(', ')}`,
+        depInfo,
+    ].join('\n');
+}
+async function buildImpactContext(cwd, filePath) {
+    const fileCtx = await buildFileContext(cwd, filePath);
+    const graph = new GraphAgent(cwd);
+    const index = graph.getIndex() ?? await graph.buildIndex();
+    // Transitive dependents (2 levels)
+    const direct = index.imports.filter((i) => i.resolved?.endsWith(filePath) || i.resolved === filePath).map((i) => i.from);
+    const transitive = new Set();
+    for (const dep of direct) {
+        index.imports.filter((i) => i.resolved === dep || i.resolved?.endsWith(dep)).forEach((i) => transitive.add(i.from));
+    }
+    return [
+        fileCtx,
+        direct.length > 0 ? `\nDirect dependents (${direct.length}):\n${direct.slice(0, 10).map((f) => `  ${f}`).join('\n')}` : '\nNo direct dependents found.',
+        transitive.size > 0 ? `\nTransitive dependents (${transitive.size}):\n${[...transitive].slice(0, 8).map((f) => `  ${f}`).join('\n')}` : '',
+    ].join('\n');
+}
+export function registerExplain(program) {
+    // explain <file>
+    addRuntimeOptions(program
+        .command('explain <file>')
+        .description('AI explanation of a file: what it does, why it matters, how to refactor'))
+        .action(async (file, options) => {
+        const cwd = process.cwd();
+        const policy = createRuntimePolicy(toRuntimePolicyInput(options));
+        console.log(chalk.bold.cyan(`\nExplaining ${file}…\n`));
+        const context = await buildFileContext(cwd, file);
+        const agent = new ExplainAgent('explain');
+        const run = await agent.run({ worktreePath: cwd, mode: 'explain', target: file, context }, policy);
+        console.log(run.output);
+    });
+    // impact <file>
+    addRuntimeOptions(program
+        .command('impact <file>')
+        .description('Impact analysis: what breaks if you change this file'))
+        .action(async (file, options) => {
+        const cwd = process.cwd();
+        const policy = createRuntimePolicy(toRuntimePolicyInput(options));
+        console.log(chalk.bold.cyan(`\nImpact analysis: ${file}…\n`));
+        const context = await buildImpactContext(cwd, file);
+        const agent = new ExplainAgent('impact');
+        const run = await agent.run({ worktreePath: cwd, mode: 'impact', target: file, context }, policy);
+        console.log(run.output);
+    });
+    // onboard
+    addRuntimeOptions(program
+        .command('onboard')
+        .description('Generate developer onboarding guide for this project'))
+        .action(async (options) => {
+        const cwd = process.cwd();
+        const policy = createRuntimePolicy(toRuntimePolicyInput(options));
+        const projectName = cwd.split('/').pop() ?? 'project';
+        console.log(chalk.bold.cyan(`\nGenerating onboarding guide for ${projectName}…\n`));
+        const context = await buildOnboardContext(cwd);
+        const agent = new ExplainAgent('onboard');
+        const run = await agent.run({ worktreePath: cwd, mode: 'onboard', target: projectName, context }, policy);
+        console.log(run.output);
+    });
+}
+//# sourceMappingURL=explain.js.map

package/dist/cli/commands/explain.js.map

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

package/dist/cli/commands/fix.d.ts

@@ -0,0 +1,3 @@
+import type { Command } from 'commander';
+export declare function registerFix(program: Command): void;
+//# sourceMappingURL=fix.d.ts.map

package/dist/cli/commands/fix.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"fix.d.ts","sourceRoot":"","sources":["../../../src/cli/commands/fix.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAKzC,wBAAgB,WAAW,CAAC,OAAO,EAAE,OAAO,GAAG,IAAI,CAoBlD"}

package/dist/cli/commands/fix.js

@@ -0,0 +1,22 @@
+import { Orchestrator } from '../../core/orchestrator.js';
+import { Renderer } from '../ui/renderer.js';
+import { addRuntimeOptions, toRuntimePolicyInput } from '../runtime-options.js';
+export function registerFix(program) {
+    addRuntimeOptions(program
+        .command('fix <target>')
+        .description('Full fix pipeline: Planner -> Investigator -> Developer -> Reviewer -> local QA'))
+        .action(async (target, options) => {
+        const renderer = new Renderer();
+        const orch = new Orchestrator(process.cwd(), toRuntimePolicyInput(options));
+        orch.on('state:change', ({ state }) => renderer.showState(state));
+        orch.on('agent:start', ({ agentName }) => renderer.agentStart(agentName));
+        orch.on('agent:output', ({ agentName, text }) => renderer.agentChunk(agentName, text));
+        orch.on('agent:done', ({ agentName, durationMs }) => renderer.agentDone(agentName, durationMs));
+        orch.on('error', ({ message }) => renderer.showError(message));
+        const result = await orch.runFixPipeline(target);
+        renderer.showResult(result);
+        renderer.showCost(orch.costs.summary());
+        process.exit(result.state === 'DONE' ? 0 : 1);
+    });
+}
+//# sourceMappingURL=fix.js.map

package/dist/cli/commands/fix.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"fix.js","sourceRoot":"","sources":["../../../src/cli/commands/fix.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,YAAY,EAAE,MAAM,4BAA4B,CAAC;AAC1D,OAAO,EAAE,QAAQ,EAAE,MAAM,mBAAmB,CAAC;AAC7C,OAAO,EAAE,iBAAiB,EAAE,oBAAoB,EAA0B,MAAM,uBAAuB,CAAC;AAExG,MAAM,UAAU,WAAW,CAAC,OAAgB;IAC1C,iBAAiB,CAAC,OAAO;SACtB,OAAO,CAAC,cAAc,CAAC;SACvB,WAAW,CAAC,iFAAiF,CAAC,CAAC;SAC/F,MAAM,CAAC,KAAK,EAAE,MAAc,EAAE,OAA0B,EAAE,EAAE;QAC3D,MAAM,QAAQ,GAAG,IAAI,QAAQ,EAAE,CAAC;QAChC,MAAM,IAAI,GAAG,IAAI,YAAY,CAAC,OAAO,CAAC,GAAG,EAAE,EAAE,oBAAoB,CAAC,OAAO,CAAC,CAAC,CAAC;QAE5E,IAAI,CAAC,EAAE,CAAC,cAAc,EAAE,CAAC,EAAE,KAAK,EAAE,EAAE,EAAE,CAAC,QAAQ,CAAC,SAAS,CAAC,KAAK,CAAC,CAAC,CAAC;QAClE,IAAI,CAAC,EAAE,CAAC,aAAa,EAAE,CAAC,EAAE,SAAS,EAAE,EAAE,EAAE,CAAC,QAAQ,CAAC,UAAU,CAAC,SAAS,CAAC,CAAC,CAAC;QAC1E,IAAI,CAAC,EAAE,CAAC,cAAc,EAAE,CAAC,EAAE,SAAS,EAAE,IAAI,EAAE,EAAE,EAAE,CAAC,QAAQ,CAAC,UAAU,CAAC,SAAS,EAAE,IAAI,CAAC,CAAC,CAAC;QACvF,IAAI,CAAC,EAAE,CAAC,YAAY,EAAE,CAAC,EAAE,SAAS,EAAE,UAAU,EAAE,EAAE,EAAE,CAAC,QAAQ,CAAC,SAAS,CAAC,SAAS,EAAE,UAAU,CAAC,CAAC,CAAC;QAChG,IAAI,CAAC,EAAE,CAAC,OAAO,EAAE,CAAC,EAAE,OAAO,EAAE,EAAE,EAAE,CAAC,QAAQ,CAAC,SAAS,CAAC,OAAO,CAAC,CAAC,CAAC;QAE/D,MAAM,MAAM,GAAG,MAAM,IAAI,CAAC,cAAc,CAAC,MAAM,CAAC,CAAC;QACjD,QAAQ,CAAC,UAAU,CAAC,MAAM,CAAC,CAAC;QAC5B,QAAQ,CAAC,QAAQ,CAAC,IAAI,CAAC,KAAK,CAAC,OAAO,EAAE,CAAC,CAAC;QAExC,OAAO,CAAC,IAAI,CAAC,MAAM,CAAC,KAAK,KAAK,MAAM,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC;IAChD,CAAC,CAAC,CAAC;AACP,CAAC"}

package/dist/cli/commands/graph.d.ts

@@ -0,0 +1,3 @@
+import type { Command } from 'commander';
+export declare function registerGraph(program: Command): void;
+//# sourceMappingURL=graph.d.ts.map

package/dist/cli/commands/graph.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"graph.d.ts","sourceRoot":"","sources":["../../../src/cli/commands/graph.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAiTzC,wBAAgB,aAAa,CAAC,OAAO,EAAE,OAAO,GAAG,IAAI,CA+CpD"}