koneck 1.0.3 → 2.1.0

package/dist/code-graph.js

@@ -0,0 +1,167 @@
+import { readFile, writeFile, mkdir } from 'fs/promises';
+import { existsSync } from 'fs';
+import path from 'path';
+import { Project, SyntaxKind } from 'ts-morph';
+import ora from 'ora';
+import { execa } from 'execa';
+function graphPath(cwd) {
+    return path.join(cwd, '.koneck', 'code-graph.json');
+}
+async function loadGraph(cwd) {
+    const p = graphPath(cwd);
+    if (!existsSync(p))
+        return null;
+    try {
+        return JSON.parse(await readFile(p, 'utf-8'));
+    }
+    catch {
+        return null;
+    }
+}
+export async function buildCodeGraph(cwd) {
+    const spinner = ora('Building code graph…').start();
+    const project = new Project({
+        skipAddingFilesFromTsConfig: true,
+        compilerOptions: { skipLibCheck: true, noEmit: true },
+    });
+    project.addSourceFilesAtPaths([
+        `${cwd}/**/*.ts`,
+        `!${cwd}/node_modules/**`,
+        `!${cwd}/dist/**`,
+        `!${cwd}/.koneck/**`,
+    ]);
+    const sourceFiles = project.getSourceFiles();
+    const symbols = [];
+    const callMap = new Map();
+    for (const sf of sourceFiles) {
+        const file = path.relative(cwd, sf.getFilePath());
+        spinner.text = `Indexing ${file}`;
+        try {
+            // Functions
+            for (const fn of sf.getFunctions()) {
+                const name = fn.getName() ?? '<anonymous>';
+                const callees = new Set();
+                fn.getDescendantsOfKind(SyntaxKind.CallExpression).forEach(ce => {
+                    const leaf = ce.getExpression().getText().split('.').pop()?.trim();
+                    if (leaf)
+                        callees.add(leaf);
+                });
+                callMap.set(name, callees);
+                symbols.push({
+                    name, kind: 'function', file,
+                    line: fn.getStartLineNumber(),
+                    exported: fn.isExported(),
+                    calls: [...callees],
+                });
+            }
+            // Classes
+            for (const cls of sf.getClasses()) {
+                const name = cls.getName() ?? '<anonymous>';
+                symbols.push({ name, kind: 'class', file, line: cls.getStartLineNumber(), exported: cls.isExported() });
+            }
+            // Interfaces
+            for (const iface of sf.getInterfaces()) {
+                symbols.push({ name: iface.getName(), kind: 'interface', file, line: iface.getStartLineNumber(), exported: iface.isExported() });
+            }
+            // Type aliases
+            for (const ta of sf.getTypeAliases()) {
+                symbols.push({ name: ta.getName(), kind: 'type', file, line: ta.getStartLineNumber(), exported: ta.isExported() });
+            }
+            // Exported variable declarations
+            for (const vd of sf.getVariableDeclarations()) {
+                const stmt = vd.getVariableStatement();
+                if (stmt?.isExported()) {
+                    symbols.push({ name: vd.getName(), kind: 'variable', file, line: vd.getStartLineNumber(), exported: true });
+                }
+            }
+        }
+        catch {
+            // skip unparseable file
+        }
+    }
+    // Build calledBy reverse index
+    const calledByMap = new Map();
+    for (const [caller, callees] of callMap) {
+        for (const callee of callees) {
+            if (!calledByMap.has(callee))
+                calledByMap.set(callee, new Set());
+            calledByMap.get(callee).add(caller);
+        }
+    }
+    for (const sym of symbols) {
+        const cb = calledByMap.get(sym.name);
+        if (cb?.size)
+            sym.calledBy = [...cb];
+    }
+    const data = { builtAt: new Date().toISOString(), cwd, symbols };
+    await mkdir(path.join(cwd, '.koneck'), { recursive: true });
+    await writeFile(graphPath(cwd), JSON.stringify(data, null, 2));
+    spinner.succeed(`Code graph built — ${symbols.length} symbols indexed`);
+}
+export async function findUsages(symbolName, cwd) {
+    let graph = await loadGraph(cwd);
+    if (!graph) {
+        await buildCodeGraph(cwd);
+        graph = await loadGraph(cwd);
+    }
+    const results = [];
+    if (graph) {
+        for (const sym of graph.symbols) {
+            if (sym.name === symbolName) {
+                results.push(`${sym.file}:${sym.line} — definition (${sym.kind})`);
+            }
+            else if (sym.calls?.includes(symbolName)) {
+                results.push(`${sym.file}:${sym.line} — called by ${sym.name}`);
+            }
+        }
+    }
+    if (results.length === 0) {
+        try {
+            const { stdout } = await execa('grep', [
+                '-rn', symbolName, cwd,
+                '--include=*.ts',
+                '--exclude-dir=node_modules',
+                '--exclude-dir=dist',
+                '--exclude-dir=.koneck',
+            ]);
+            for (const line of stdout.split('\n').filter(Boolean)) {
+                const colonIdx = line.indexOf(':');
+                const rest = line.slice(colonIdx + 1);
+                const lineNoIdx = rest.indexOf(':');
+                const file = path.relative(cwd, line.slice(0, colonIdx));
+                const lineNo = rest.slice(0, lineNoIdx);
+                const context = rest.slice(lineNoIdx + 1).trim();
+                results.push(`${file}:${lineNo} — ${context}`);
+            }
+        }
+        catch {
+            // grep found nothing or is unavailable
+        }
+    }
+    return results;
+}
+export async function getCallGraph(cwd) {
+    let graph = await loadGraph(cwd);
+    if (!graph) {
+        await buildCodeGraph(cwd);
+        graph = await loadGraph(cwd);
+    }
+    if (!graph)
+        return '(no graph available)';
+    const top = graph.symbols
+        .filter(s => s.calls?.length || s.calledBy?.length)
+        .map(s => ({ s, score: (s.calls?.length ?? 0) + (s.calledBy?.length ?? 0) }))
+        .sort((a, b) => b.score - a.score)
+        .slice(0, 20);
+    return top
+        .map(({ s }) => `${s.name} → [${(s.calls ?? []).join(', ')}]`)
+        .join('\n');
+}
+export async function queryGraph(query, cwd) {
+    const graph = await loadGraph(cwd);
+    if (!graph)
+        return [];
+    const q = query.toLowerCase();
+    return graph.symbols.filter(s => s.name.toLowerCase().includes(q));
+}
+//# sourceMappingURL=code-graph.js.map

package/dist/code-graph.js.map

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

package/dist/critique.d.ts

@@ -0,0 +1,4 @@
+import type { Message, AgentConfig, TokenStats } from './types.js';
+export declare function detectFileWrites(messages: Message[]): boolean;
+export declare function runSelfCritique(messages: Message[], config: AgentConfig, cwd: string, stats: TokenStats, hadFileWrites: boolean): Promise<void>;
+//# sourceMappingURL=critique.d.ts.map

package/dist/critique.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"critique.d.ts","sourceRoot":"","sources":["../src/critique.ts"],"names":[],"mappings":"AAKA,OAAO,KAAK,EAAE,OAAO,EAAE,WAAW,EAAE,UAAU,EAAE,MAAM,YAAY,CAAC;AAInE,wBAAgB,gBAAgB,CAAC,QAAQ,EAAE,OAAO,EAAE,GAAG,OAAO,CAO7D;AAUD,wBAAsB,eAAe,CACnC,QAAQ,EAAE,OAAO,EAAE,EACnB,MAAM,EAAE,WAAW,EACnB,GAAG,EAAE,MAAM,EACX,KAAK,EAAE,UAAU,EACjB,aAAa,EAAE,OAAO,GACrB,OAAO,CAAC,IAAI,CAAC,CAiBf"}

package/dist/critique.js

@@ -0,0 +1,36 @@
+import chalk from 'chalk';
+// NOTE: runReActLoop must be exported from engine.ts
+import { buildClient, runReActLoop } from './engine.js';
+import { TOOL_DEFINITIONS } from './tools.js';
+const WRITE_TOOLS = new Set(['write_file', 'apply_diff', 'delete_file', 'move_file']);
+export function detectFileWrites(messages) {
+    for (const m of messages) {
+        if (m.role !== 'assistant')
+            continue;
+        const msg = m;
+        if (msg.tool_calls?.some(tc => WRITE_TOOLS.has(tc.function?.name ?? '')))
+            return true;
+    }
+    return false;
+}
+const CRITIQUE_PROMPT = 'Self-critique: review your work so far.\n' +
+    'Check: (1) Did you update tests for changed code? (2) Could this introduce bugs or regressions? ' +
+    '(3) Did you update docs/comments? (4) Could this break the API or existing callers? ' +
+    '(5) Any TODOs left incomplete? (6) Any obvious lint/type errors?\n' +
+    'If you find issues, fix them now using the available tools. ' +
+    'If everything looks good, respond with exactly: "Self-critique: all clear."';
+export async function runSelfCritique(messages, config, cwd, stats, hadFileWrites) {
+    if (!hadFileWrites)
+        return;
+    console.log(chalk.cyan('\n── Self-critique phase ──'));
+    messages.push({ role: 'user', content: CRITIQUE_PROMPT });
+    const client = buildClient(config);
+    const critiqueConfig = { ...config, maxTurns: 6 };
+    const openaiTools = TOOL_DEFINITIONS.map(def => ({
+        type: 'function',
+        function: { name: def.name, description: def.description, parameters: def.parameters },
+    }));
+    await runReActLoop(messages, client, critiqueConfig, cwd, stats, [], [], openaiTools);
+    console.log(chalk.cyan('Self-critique complete.'));
+}
+//# sourceMappingURL=critique.js.map

package/dist/critique.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"critique.js","sourceRoot":"","sources":["../src/critique.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,MAAM,OAAO,CAAC;AAE1B,qDAAqD;AACrD,OAAO,EAAE,WAAW,EAAE,YAAY,EAAE,MAAM,aAAa,CAAC;AACxD,OAAO,EAAE,gBAAgB,EAAE,MAAM,YAAY,CAAC;AAG9C,MAAM,WAAW,GAAG,IAAI,GAAG,CAAC,CAAC,YAAY,EAAE,YAAY,EAAE,aAAa,EAAE,WAAW,CAAC,CAAC,CAAC;AAEtF,MAAM,UAAU,gBAAgB,CAAC,QAAmB;IAClD,KAAK,MAAM,CAAC,IAAI,QAAQ,EAAE,CAAC;QACzB,IAAI,CAAC,CAAC,IAAI,KAAK,WAAW;YAAE,SAAS;QACrC,MAAM,GAAG,GAAG,CAA6D,CAAC;QAC1E,IAAI,GAAG,CAAC,UAAU,EAAE,IAAI,CAAC,EAAE,CAAC,EAAE,CAAC,WAAW,CAAC,GAAG,CAAC,EAAE,CAAC,QAAQ,EAAE,IAAI,IAAI,EAAE,CAAC,CAAC;YAAE,OAAO,IAAI,CAAC;IACxF,CAAC;IACD,OAAO,KAAK,CAAC;AACf,CAAC;AAED,MAAM,eAAe,GACnB,2CAA2C;IAC3C,kGAAkG;IAClG,sFAAsF;IACtF,oEAAoE;IACpE,8DAA8D;IAC9D,6EAA6E,CAAC;AAEhF,MAAM,CAAC,KAAK,UAAU,eAAe,CACnC,QAAmB,EACnB,MAAmB,EACnB,GAAW,EACX,KAAiB,EACjB,aAAsB;IAEtB,IAAI,CAAC,aAAa;QAAE,OAAO;IAE3B,OAAO,CAAC,GAAG,CAAC,KAAK,CAAC,IAAI,CAAC,6BAA6B,CAAC,CAAC,CAAC;IAEvD,QAAQ,CAAC,IAAI,CAAC,EAAE,IAAI,EAAE,MAAM,EAAE,OAAO,EAAE,eAAe,EAAE,CAAC,CAAC;IAE1D,MAAM,MAAM,GAAG,WAAW,CAAC,MAAM,CAAC,CAAC;IACnC,MAAM,cAAc,GAAgB,EAAE,GAAG,MAAM,EAAE,QAAQ,EAAE,CAAC,EAAE,CAAC;IAC/D,MAAM,WAAW,GAAqC,gBAAgB,CAAC,GAAG,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC;QACjF,IAAI,EAAE,UAAmB;QACzB,QAAQ,EAAE,EAAE,IAAI,EAAE,GAAG,CAAC,IAAI,EAAE,WAAW,EAAE,GAAG,CAAC,WAAW,EAAE,UAAU,EAAE,GAAG,CAAC,UAAU,EAAE;KACvF,CAAC,CAAC,CAAC;IAEJ,MAAM,YAAY,CAAC,QAAQ,EAAE,MAAM,EAAE,cAAc,EAAE,GAAG,EAAE,KAAK,EAAE,EAAE,EAAE,EAAE,EAAE,WAAW,CAAC,CAAC;IAEtF,OAAO,CAAC,GAAG,CAAC,KAAK,CAAC,IAAI,CAAC,yBAAyB,CAAC,CAAC,CAAC;AACrD,CAAC"}

package/dist/daemon.d.ts

@@ -0,0 +1,3 @@
+import type { AgentConfig } from './types.js';
+export declare function runDaemon(action: 'start' | 'stop' | 'status', config: AgentConfig): Promise<void>;
+//# sourceMappingURL=daemon.d.ts.map

package/dist/daemon.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"daemon.d.ts","sourceRoot":"","sources":["../src/daemon.ts"],"names":[],"mappings":"AAKA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,YAAY,CAAC;AAmD9C,wBAAsB,SAAS,CAAC,MAAM,EAAE,OAAO,GAAG,MAAM,GAAG,QAAQ,EAAE,MAAM,EAAE,WAAW,GAAG,OAAO,CAAC,IAAI,CAAC,CA8CvG"}

package/dist/daemon.js

@@ -0,0 +1,111 @@
+import fs from 'fs';
+import path from 'path';
+import { execa } from 'execa';
+import chalk from 'chalk';
+import { runAgent } from './engine.js';
+const PID_FILE = '.koneck/daemon.pid';
+function readPid() {
+    try {
+        return JSON.parse(fs.readFileSync(PID_FILE, 'utf8'));
+    }
+    catch {
+        return null;
+    }
+}
+function writePid(pid) {
+    fs.mkdirSync('.koneck', { recursive: true });
+    fs.writeFileSync(PID_FILE, JSON.stringify({ pid, startTime: Date.now() }));
+}
+function deletePid() {
+    try {
+        fs.unlinkSync(PID_FILE);
+    }
+    catch { /* already gone */ }
+}
+function isAlive(pid) {
+    try {
+        process.kill(pid, 0);
+        return true;
+    }
+    catch {
+        return false;
+    }
+}
+async function reviewCommit(config) {
+    const { stdout: commitInfo } = await execa('git', ['log', '-1', '--format=%H %s']);
+    const { stdout: diffStat } = await execa('git', ['diff', 'HEAD~1', '--stat']);
+    const task = `Review this commit and suggest improvements. Commit: ${commitInfo}\nChanged files:\n${diffStat}\n\nCheck for: bugs, security issues, missing tests, documentation needs. Be concise.`;
+    console.log(chalk.cyan('\n── Commit Review ──────────────────────────────'));
+    await runAgent(task, { ...config, silent: false });
+    console.log(chalk.cyan('────────────────────────────────────────────────\n'));
+}
+async function runCICheck(config) {
+    try {
+        await execa('npm', ['test'], { cwd: config.cwd });
+    }
+    catch (err) {
+        const output = err.stderr ?? err.stdout ?? '';
+        const task = `npm test is failing. Fix the failing tests.\n\nTest output:\n${output}`;
+        console.log(chalk.red('\n── CI Failure — Auto-fixing ───────────────────'));
+        await runAgent(task, { ...config, silent: false });
+        console.log(chalk.red('────────────────────────────────────────────────\n'));
+    }
+}
+export async function runDaemon(action, config) {
+    if (action === 'stop') {
+        const entry = readPid();
+        if (!entry) {
+            console.log('No daemon running.');
+            return;
+        }
+        try {
+            process.kill(entry.pid, 'SIGTERM');
+        }
+        catch { /* already dead */ }
+        deletePid();
+        console.log('Daemon stopped.');
+        return;
+    }
+    if (action === 'status') {
+        const entry = readPid();
+        if (!entry) {
+            console.log('Daemon is not running.');
+            return;
+        }
+        if (!isAlive(entry.pid)) {
+            console.log('Daemon PID file exists but process is dead.');
+            deletePid();
+            return;
+        }
+        const uptime = Math.floor((Date.now() - entry.startTime) / 1000);
+        console.log(chalk.green(`Daemon running (PID: ${entry.pid}, uptime: ${uptime}s)`));
+        return;
+    }
+    // start
+    writePid(process.pid);
+    console.log(chalk.green(`Daemon started (PID: ${process.pid}). Watching for commits...`));
+    let debounceTimer = null;
+    const commitMsgPath = path.join(config.cwd, '.git', 'COMMIT_EDITMSG');
+    try {
+        fs.watch(path.join(config.cwd, '.git'), (_, filename) => {
+            if (filename !== 'COMMIT_EDITMSG')
+                return;
+            if (debounceTimer)
+                clearTimeout(debounceTimer);
+            debounceTimer = setTimeout(() => {
+                reviewCommit(config).catch((e) => console.error('Review error:', e));
+            }, 2000);
+        });
+    }
+    catch {
+        console.error(chalk.red('Could not watch .git directory — is this a git repo?'));
+    }
+    // CI check every 30 minutes
+    setInterval(() => {
+        runCICheck(config).catch((e) => console.error('CI check error:', e));
+    }, 30 * 60 * 1000);
+    process.on('SIGTERM', () => { deletePid(); process.exit(0); });
+    process.stdin.resume();
+    void commitMsgPath; // referenced to satisfy linters
+}
+//# sourceMappingURL=daemon.js.map

package/dist/daemon.js.map

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

package/dist/debugger.d.ts

@@ -0,0 +1,4 @@
+import type { AgentConfig } from './types.js';
+export declare function runDebugger(config: AgentConfig, startCommand?: string): Promise<void>;
+export declare function analyzeError(errorOutput: string, config: AgentConfig): Promise<void>;
+//# sourceMappingURL=debugger.d.ts.map

package/dist/debugger.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"debugger.d.ts","sourceRoot":"","sources":["../src/debugger.ts"],"names":[],"mappings":"AAKA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,YAAY,CAAC;AAwE9C,wBAAsB,WAAW,CAAC,MAAM,EAAE,WAAW,EAAE,YAAY,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CA2B3F;AAED,wBAAsB,YAAY,CAAC,WAAW,EAAE,MAAM,EAAE,MAAM,EAAE,WAAW,GAAG,OAAO,CAAC,IAAI,CAAC,CAa1F"}

package/dist/debugger.js

@@ -0,0 +1,104 @@
+import fs from 'fs/promises';
+import path from 'path';
+import readline from 'readline';
+import chalk from 'chalk';
+import { execa } from 'execa';
+import { runAgent } from './engine.js';
+import { detectProject } from './project.js';
+// ─── Helpers ─────────────────────────────────────────────────────────────────
+async function findStartCommand(cwd) {
+    try {
+        const raw = await fs.readFile(path.join(cwd, 'package.json'), 'utf8');
+        const pkg = JSON.parse(raw);
+        const scripts = pkg.scripts ?? {};
+        for (const key of ['start', 'dev', 'serve']) {
+            if (scripts[key])
+                return `npm run ${key}`;
+        }
+    }
+    catch {
+        // no package.json or parse error — fall through to prompt
+    }
+    // Also check project info for a run command
+    const info = await detectProject(cwd);
+    if (info.runCommand)
+        return info.runCommand;
+    return new Promise((resolve) => {
+        const rl = readline.createInterface({ input: process.stdin, output: process.stdout });
+        rl.question('What command runs your app? ', (answer) => {
+            rl.close();
+            resolve(answer.trim());
+        });
+    });
+}
+function extractStackTrace(output) {
+    const lines = output.split('\n');
+    const matched = [];
+    lines.forEach((line, i) => {
+        if (/^\s+at /.test(line) ||
+            /\b(Error|TypeError|ReferenceError|SyntaxError|Exception):/i.test(line) ||
+            /File ".+?"/.test(line) ||
+            /\.(ts|js):\d+/.test(line)) {
+            matched.push(i);
+        }
+    });
+    if (matched.length === 0)
+        return output.slice(0, 2000);
+    const first = Math.max(0, matched[0] - 5);
+    const last = Math.min(lines.length - 1, matched[matched.length - 1] + 5);
+    return lines.slice(first, Math.min(last + 1, first + 50)).join('\n');
+}
+function buildDebugTask(command, crashOutput, stackTrace) {
+    return `The application crashed. Analyze the error and fix it.
+
+Command run: ${command}
+
+Crash output:
+${crashOutput.slice(0, 3000)}
+
+Stack trace (extracted):
+${stackTrace}
+
+Steps:
+1. Read the source files mentioned in the stack trace
+2. Identify the root cause
+3. Apply a fix
+4. Run the app again to verify it works`;
+}
+// ─── Exports ─────────────────────────────────────────────────────────────────
+export async function runDebugger(config, startCommand) {
+    const command = startCommand ?? (await findStartCommand(config.cwd));
+    console.log(chalk.bold.cyan('\n━━━ AI Debugger ━━━━━━━━━━━━━━━━━━━━━━━'));
+    console.log(chalk.white(`Command: ${command}`));
+    const [bin, ...args] = command.split(' ');
+    const result = await execa(bin, args, {
+        all: true,
+        reject: false,
+        timeout: 30_000,
+        cwd: config.cwd,
+    });
+    if (result.exitCode === 0) {
+        console.log(chalk.green('App ran successfully — no crash detected.'));
+        return;
+    }
+    const output = result.all ?? '';
+    console.log(chalk.red(`Exit code: ${result.exitCode}`));
+    console.log(chalk.yellow('Analyzing crash...\n'));
+    const stackTrace = extractStackTrace(output);
+    const debugTask = buildDebugTask(command, output, stackTrace);
+    await runAgent(debugTask, { ...config, maxTurns: 20 });
+}
+export async function analyzeError(errorOutput, config) {
+    const task = `The user has pasted an error message. Diagnose the root cause and apply a fix.
+
+Error output:
+${errorOutput}
+
+Steps:
+1. Read any source files referenced in the error
+2. Identify the root cause
+3. Apply a fix
+4. If possible, run the app to verify it works`;
+    await runAgent(task, { ...config, maxTurns: 20 });
+}
+//# sourceMappingURL=debugger.js.map

package/dist/debugger.js.map

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

package/dist/engine.d.ts

@@ -1,4 +1,9 @@
+import OpenAI from 'openai';
+import { type PluginEntry } from './plugins.js';
+import { type MCPClientEntry } from './mcp.js';
 import type { Message, AgentConfig, TokenStats } from './types.js';
+export declare function buildClient(config: AgentConfig): OpenAI;
+export declare function runReActLoop(messages: Message[], client: OpenAI, config: AgentConfig, effectiveCwd: string, stats: TokenStats, mcpClients: MCPClientEntry[], plugins: PluginEntry[], openaiTools: OpenAI.Chat.ChatCompletionTool[], turnOffset?: number, abortSignal?: AbortSignal): Promise<boolean>;
 export interface AgentSession {
     readonly id: string;
     readonly messages: Message[];

package/dist/engine.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"engine.d.ts","sourceRoot":"","sources":["../src/engine.ts"],"names":[],"mappings":"AAmBA,OAAO,KAAK,EACV,OAAO,EACP,WAAW,EAEX,UAAU,EAIX,MAAM,YAAY,CAAC;AAubpB,MAAM,WAAW,YAAY;IAC3B,QAAQ,CAAC,EAAE,EAAE,MAAM,CAAC;IACpB,QAAQ,CAAC,QAAQ,EAAE,OAAO,EAAE,CAAC;IAC7B,QAAQ,CAAC,KAAK,EAAE,UAAU,CAAC;IAC3B,QAAQ,CAAC,SAAS,EAAE,OAAO,CAAC;IAC5B,IAAI,CAAC,QAAQ,EAAE,MAAM,EAAE,MAAM,CAAC,EAAE,WAAW,GAAG,OAAO,CAAC,OAAO,CAAC,CAAC;CAChE;AAED,wBAAsB,kBAAkB,CACtC,MAAM,EAAE,WAAW,EACnB,eAAe,CAAC,EAAE,OAAO,EAAE,GAC1B,OAAO,CAAC,YAAY,CAAC,CA2CvB;AAID,wBAAsB,QAAQ,CAC5B,IAAI,EAAE,MAAM,EACZ,MAAM,EAAE,WAAW,EACnB,eAAe,CAAC,EAAE,OAAO,EAAE,GAC1B,OAAO,CAAC,YAAY,CAAC,CAwDvB"}
+{"version":3,"file":"engine.d.ts","sourceRoot":"","sources":["../src/engine.ts"],"names":[],"mappings":"AAAA,OAAO,MAAM,MAAM,QAAQ,CAAC;AAY5B,OAAO,EAA2B,KAAK,WAAW,EAAE,MAAM,cAAc,CAAC;AACzE,OAAO,EAIL,KAAK,cAAc,EACpB,MAAM,UAAU,CAAC;AAIlB,OAAO,KAAK,EACV,OAAO,EACP,WAAW,EAEX,UAAU,EAIX,MAAM,YAAY,CAAC;AAIpB,wBAAgB,WAAW,CAAC,MAAM,EAAE,WAAW,GAAG,MAAM,CAQvD;AAsMD,wBAAsB,YAAY,CAChC,QAAQ,EAAE,OAAO,EAAE,EACnB,MAAM,EAAE,MAAM,EACd,MAAM,EAAE,WAAW,EACnB,YAAY,EAAE,MAAM,EACpB,KAAK,EAAE,UAAU,EACjB,UAAU,EAAE,cAAc,EAAE,EAC5B,OAAO,EAAE,WAAW,EAAE,EACtB,WAAW,EAAE,MAAM,CAAC,IAAI,CAAC,kBAAkB,EAAE,EAC7C,UAAU,SAAI,EACd,WAAW,CAAC,EAAE,WAAW,GACxB,OAAO,CAAC,OAAO,CAAC,CAsNlB;AAID,MAAM,WAAW,YAAY;IAC3B,QAAQ,CAAC,EAAE,EAAE,MAAM,CAAC;IACpB,QAAQ,CAAC,QAAQ,EAAE,OAAO,EAAE,CAAC;IAC7B,QAAQ,CAAC,KAAK,EAAE,UAAU,CAAC;IAC3B,QAAQ,CAAC,SAAS,EAAE,OAAO,CAAC;IAC5B,IAAI,CAAC,QAAQ,EAAE,MAAM,EAAE,MAAM,CAAC,EAAE,WAAW,GAAG,OAAO,CAAC,OAAO,CAAC,CAAC;CAChE;AAED,wBAAsB,kBAAkB,CACtC,MAAM,EAAE,WAAW,EACnB,eAAe,CAAC,EAAE,OAAO,EAAE,GAC1B,OAAO,CAAC,YAAY,CAAC,CA6CvB;AAID,wBAAsB,QAAQ,CAC5B,IAAI,EAAE,MAAM,EACZ,MAAM,EAAE,WAAW,EACnB,eAAe,CAAC,EAAE,OAAO,EAAE,GAC1B,OAAO,CAAC,YAAY,CAAC,CAuEvB"}

package/dist/engine.js

@@ -12,8 +12,11 @@ import { detectProject, loadAgentInstructions, projectSummary } from './project.
 import { estimateCost, formatCost } from './pricing.js';
 import { loadPlugins, callPlugin } from './plugins.js';
 import { loadMCPConfig, connectMCPServers, callMCPTool, } from './mcp.js';
+import { gatherRecon } from './recon.js';
+import { runSelfCritique, detectFileWrites } from './critique.js';
+import { getPackSystemPrompt } from './plugin-packs.js';
 // ─── Client ──────────────────────────────────────────────────────────────────
-function buildClient(config) {
+export function buildClient(config) {
     const provider = resolveProvider(config.provider, config.baseURL);
     const apiKey = getApiKey(provider, config.apiKey);
     return new OpenAI({
@@ -182,7 +185,7 @@ async function handleSpawnAgents(args, config, cwd) {
         .join('\n\n');
 }
 // ─── ReAct loop ───────────────────────────────────────────────────────────────
-async function runReActLoop(messages, client, config, effectiveCwd, stats, mcpClients, plugins, openaiTools, turnOffset = 0, abortSignal) {
+export async function runReActLoop(messages, client, config, effectiveCwd, stats, mcpClients, plugins, openaiTools, turnOffset = 0, abortSignal) {
     const silent = Boolean(config.silent);
     const seenSignatures = new Set();
     let budgetWarned = false;
@@ -408,13 +411,15 @@ export async function createAgentSession(config, initialMessages) {
     const stats = { promptTokens: 0, completionTokens: 0, totalTokens: 0, turns: 0 };
     const messages = initialMessages ? [...initialMessages] : [];
     if (!initialMessages) {
-        const [ctx, memory, project, agentInstructions] = await Promise.all([
+        const [ctx, memory, project, agentInstructions, packPrompt] = await Promise.all([
             discoverEnvironment(config.cwd),
             loadMemory(config.cwd),
             detectProject(config.cwd),
             loadAgentInstructions(config.cwd),
+            getPackSystemPrompt(config.cwd).catch(() => ''),
         ]);
-        messages.push({ role: 'system', content: buildSystemPrompt(ctx, memory, project, agentInstructions) });
+        const basePrompt = buildSystemPrompt(ctx, memory, project, agentInstructions);
+        messages.push({ role: 'system', content: packPrompt ? basePrompt + '\n\n' + packPrompt : basePrompt });
     }
     // Load MCP and plugins only at top level (spawnDepth === 0)
     const isTopLevel = (config.spawnDepth ?? 0) === 0;
@@ -469,7 +474,19 @@ export async function runAgent(task, config, initialMessages) {
         tui.printThinking('');
     }
     const agentStart = Date.now();
-    await session.send(task);
+    // Evidence-first recon: gather context before the first LLM call
+    let enrichedTask = task;
+    if (!config.silent && !config.ci && (config.spawnDepth ?? 0) === 0) {
+        const reconContext = await gatherRecon(task, effectiveCwd);
+        if (reconContext)
+            enrichedTask = reconContext + '\n\nTask: ' + task;
+    }
+    await session.send(enrichedTask);
+    // Self-critique: one review pass if files were changed
+    if (!config.silent && !config.ci && (config.spawnDepth ?? 0) === 0) {
+        const hadWrites = detectFileWrites(session.messages);
+        await runSelfCritique(session.messages, effectiveConfig, effectiveCwd, session.stats, hadWrites);
+    }
     const agentElapsed = Date.now() - agentStart;
     if (!config.silent) {
         if (session.completed) {