@yuaone/core 0.9.7 → 0.9.9

package/dist/autonomous/explicit-planner.js

@@ -0,0 +1,99 @@
+/**
+ * @module autonomous/explicit-planner
+ * @description ExplicitPlanningEngine — generates an explicit numbered plan before coding
+ * and persists it to .yuan/tasks/<taskId>/plan.json.
+ *
+ * Wraps HierarchicalPlanner: uses its TacticalTask list as plan steps,
+ * adds task-level persistence and event emission.
+ */
+import { mkdirSync, writeFileSync } from "node:fs";
+import { join } from "node:path";
+import { homedir } from "node:os";
+import { EventEmitter } from "node:events";
+import { randomUUID } from "node:crypto";
+import { HierarchicalPlanner, } from "../hierarchical-planner.js";
+// ─── ExplicitPlanningEngine ──────────────────────────────────────────────────
+export class ExplicitPlanningEngine extends EventEmitter {
+    tasksDir;
+    projectPath;
+    constructor(config = {}) {
+        super();
+        this.projectPath = config.projectPath ?? process.cwd();
+        this.tasksDir = config.tasksDir ?? join(homedir(), ".yuan", "tasks");
+        mkdirSync(this.tasksDir, { recursive: true });
+    }
+    /**
+     * Generate an explicit plan for a goal using HierarchicalPlanner.
+     * Persists to .yuan/tasks/<taskId>/plan.json and emits agent:plan_generated.
+     */
+    async plan(goal, llmClient, taskId, context) {
+        const resolvedTaskId = taskId ?? randomUUID();
+        // Build planner config with required projectPath
+        const planner = new HierarchicalPlanner({
+            projectPath: this.projectPath,
+            maxSubGoals: 10,
+            maxTasksPerGoal: 20,
+        });
+        // Get tactical plan from HierarchicalPlanner
+        let tacticalTasks = [];
+        try {
+            const strategic = await planner.planStrategic(goal, llmClient, context);
+            tacticalTasks = await planner.planTactical(strategic, llmClient);
+        }
+        catch {
+            // Fallback: single-step plan if LLM fails
+            tacticalTasks = [{
+                    id: "task-0",
+                    goalId: "goal-0",
+                    description: goal,
+                    targetFiles: [],
+                    readFiles: [],
+                    toolStrategy: ["file_read", "file_edit"],
+                    order: 0,
+                    dependsOn: [],
+                    estimatedIterations: 3,
+                }];
+        }
+        // Convert TacticalTask[] to AutonomousPlanStep[] (ordered by .order)
+        const sorted = [...tacticalTasks].sort((a, b) => a.order - b.order);
+        const steps = sorted.map((t, i) => ({
+            index: i,
+            description: t.description,
+            dependsOn: t.dependsOn
+                .map(depId => sorted.findIndex(s => s.id === depId))
+                .filter((idx) => idx !== -1),
+            targetFiles: t.targetFiles,
+        }));
+        // Persist to .yuan/tasks/<taskId>/plan.json
+        const taskDir = join(this.tasksDir, resolvedTaskId);
+        mkdirSync(taskDir, { recursive: true });
+        const storedAt = join(taskDir, "plan.json");
+        const plan = {
+            taskId: resolvedTaskId,
+            goal,
+            steps,
+            createdAt: new Date().toISOString(),
+            storedAt,
+        };
+        writeFileSync(storedAt, JSON.stringify(plan, null, 2), "utf-8");
+        // Emit event
+        this.emitPlanGenerated(plan);
+        return plan;
+    }
+    // ─── private ───────────────────────────────────────────────────────────────
+    emitPlanGenerated(plan) {
+        const event = {
+            kind: "agent:plan_generated",
+            taskId: plan.taskId,
+            steps: plan.steps.map(s => ({
+                index: s.index,
+                description: s.description,
+                dependsOn: s.dependsOn,
+            })),
+            storedAt: plan.storedAt,
+            timestamp: Date.now(),
+        };
+        this.emit("event", event);
+    }
+}
+//# sourceMappingURL=explicit-planner.js.map

package/dist/autonomous/explicit-planner.js.map

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

package/dist/autonomous/incident-debugger.d.ts

@@ -0,0 +1,78 @@
+/**
+ * @module autonomous/incident-debugger
+ * @description Incident Debug Mode — analyzes failures using logs, trace history,
+ * and recent commits to produce a structured debug report.
+ *
+ * Input sources:
+ * 1. Trace JSONL files from ~/.yuan/traces/
+ * 2. Git log + git blame for suspected files
+ * 3. Process logs passed in (from caller)
+ *
+ * Output:
+ * { rootCause, suspectedFiles, fixStrategy, confidence }
+ *
+ * Design:
+ * - Pure analysis — does NOT call LLM (deterministic)
+ * - All output via agent:debug_report event
+ * - Reads trace files via TraceEntry format
+ * - Goes through OverheadGovernor (caller checks shouldRunDebugMode())
+ */
+import { EventEmitter } from "node:events";
+import type { ToolExecutor } from "../types.js";
+export interface DebugReport {
+    taskId: string;
+    /** Most likely root cause description */
+    rootCause: string;
+    /** Files most likely involved in the failure */
+    suspectedFiles: string[];
+    /** Recommended fix strategy */
+    fixStrategy: string;
+    /** 0.0–1.0 confidence in this diagnosis */
+    confidence: number;
+    /** Evidence used to form this report */
+    evidence: DebugEvidence[];
+    timestamp: number;
+}
+export interface DebugEvidence {
+    kind: "trace" | "git_log" | "git_blame" | "log_line";
+    content: string;
+    weight: number;
+}
+export interface IncidentDebuggerConfig {
+    tracesDir?: string;
+    projectPath?: string;
+    /** Max trace entries to analyze */
+    maxTraceEntries?: number;
+    /** Max git log lines */
+    maxGitLogLines?: number;
+}
+export declare class IncidentDebugger extends EventEmitter {
+    private readonly toolExecutor;
+    private readonly projectPath;
+    private readonly tracesDir;
+    private readonly maxTraceEntries;
+    private readonly maxGitLogLines;
+    constructor(toolExecutor: ToolExecutor, projectPath: string, config?: IncidentDebuggerConfig);
+    /**
+     * Analyze a failure and produce a debug report.
+     *
+     * @param errorMessage   The error message or stack trace
+     * @param sessionId      Optional: limit trace analysis to this session
+     * @param logs           Optional: additional log lines to analyze
+     * @param taskId         Optional: task ID for correlation
+     */
+    analyze(errorMessage: string, sessionId?: string, logs?: string[], taskId?: string): Promise<DebugReport>;
+    private analyzeTraces;
+    private listTraceFiles;
+    private readTraceFile;
+    private analyzeGitLog;
+    private analyzeGitBlame;
+    private analyzeLogs;
+    private extractSuspectedFiles;
+    private inferRootCause;
+    private inferFixStrategy;
+    private computeConfidence;
+    private extractKeywords;
+    private emitReport;
+}
+//# sourceMappingURL=incident-debugger.d.ts.map

package/dist/autonomous/incident-debugger.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"incident-debugger.d.ts","sourceRoot":"","sources":["../../src/autonomous/incident-debugger.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;GAkBG;AAKH,OAAO,EAAE,YAAY,EAAE,MAAM,aAAa,CAAC;AAE3C,OAAO,KAAK,EAAE,YAAY,EAAc,MAAM,aAAa,CAAC;AAM5D,MAAM,WAAW,WAAW;IAC1B,MAAM,EAAE,MAAM,CAAC;IACf,yCAAyC;IACzC,SAAS,EAAE,MAAM,CAAC;IAClB,gDAAgD;IAChD,cAAc,EAAE,MAAM,EAAE,CAAC;IACzB,+BAA+B;IAC/B,WAAW,EAAE,MAAM,CAAC;IACpB,2CAA2C;IAC3C,UAAU,EAAE,MAAM,CAAC;IACnB,wCAAwC;IACxC,QAAQ,EAAE,aAAa,EAAE,CAAC;IAC1B,SAAS,EAAE,MAAM,CAAC;CACnB;AAED,MAAM,WAAW,aAAa;IAC5B,IAAI,EAAE,OAAO,GAAG,SAAS,GAAG,WAAW,GAAG,UAAU,CAAC;IACrD,OAAO,EAAE,MAAM,CAAC;IAChB,MAAM,EAAE,MAAM,CAAC;CAChB;AAED,MAAM,WAAW,sBAAsB;IACrC,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,mCAAmC;IACnC,eAAe,CAAC,EAAE,MAAM,CAAC;IACzB,wBAAwB;IACxB,cAAc,CAAC,EAAE,MAAM,CAAC;CACzB;AAID,qBAAa,gBAAiB,SAAQ,YAAY;IAM9C,OAAO,CAAC,QAAQ,CAAC,YAAY;IAC7B,OAAO,CAAC,QAAQ,CAAC,WAAW;IAN9B,OAAO,CAAC,QAAQ,CAAC,SAAS,CAAS;IACnC,OAAO,CAAC,QAAQ,CAAC,eAAe,CAAS;IACzC,OAAO,CAAC,QAAQ,CAAC,cAAc,CAAS;gBAGrB,YAAY,EAAE,YAAY,EAC1B,WAAW,EAAE,MAAM,EACpC,MAAM,GAAE,sBAA2B;IAQrC;;;;;;;OAOG;IACG,OAAO,CACX,YAAY,EAAE,MAAM,EACpB,SAAS,CAAC,EAAE,MAAM,EAClB,IAAI,CAAC,EAAE,MAAM,EAAE,EACf,MAAM,CAAC,EAAE,MAAM,GACd,OAAO,CAAC,WAAW,CAAC;IA8CvB,OAAO,CAAC,aAAa;IAuCrB,OAAO,CAAC,cAAc;IAWtB,OAAO,CAAC,aAAa;YAeP,aAAa;YAiCb,eAAe;IA2B7B,OAAO,CAAC,WAAW;IAenB,OAAO,CAAC,qBAAqB;IAuB7B,OAAO,CAAC,cAAc;IAkCtB,OAAO,CAAC,gBAAgB;IAsBxB,OAAO,CAAC,iBAAiB;IAOzB,OAAO,CAAC,eAAe;IAMvB,OAAO,CAAC,UAAU;CAYnB"}

package/dist/autonomous/incident-debugger.js

@@ -0,0 +1,324 @@
+/**
+ * @module autonomous/incident-debugger
+ * @description Incident Debug Mode — analyzes failures using logs, trace history,
+ * and recent commits to produce a structured debug report.
+ *
+ * Input sources:
+ * 1. Trace JSONL files from ~/.yuan/traces/
+ * 2. Git log + git blame for suspected files
+ * 3. Process logs passed in (from caller)
+ *
+ * Output:
+ * { rootCause, suspectedFiles, fixStrategy, confidence }
+ *
+ * Design:
+ * - Pure analysis — does NOT call LLM (deterministic)
+ * - All output via agent:debug_report event
+ * - Reads trace files via TraceEntry format
+ * - Goes through OverheadGovernor (caller checks shouldRunDebugMode())
+ */
+import { readFileSync, readdirSync, statSync } from "node:fs";
+import { join, basename } from "node:path";
+import { homedir } from "node:os";
+import { EventEmitter } from "node:events";
+import { randomUUID } from "node:crypto";
+import { BOUNDS, truncate } from "../safe-bounds.js";
+// ─── IncidentDebugger ─────────────────────────────────────────────────────────
+export class IncidentDebugger extends EventEmitter {
+    toolExecutor;
+    projectPath;
+    tracesDir;
+    maxTraceEntries;
+    maxGitLogLines;
+    constructor(toolExecutor, projectPath, config = {}) {
+        super();
+        this.toolExecutor = toolExecutor;
+        this.projectPath = projectPath;
+        this.tracesDir = config.tracesDir ?? join(homedir(), ".yuan", "traces");
+        this.maxTraceEntries = config.maxTraceEntries ?? 200;
+        this.maxGitLogLines = config.maxGitLogLines ?? 30;
+    }
+    /**
+     * Analyze a failure and produce a debug report.
+     *
+     * @param errorMessage   The error message or stack trace
+     * @param sessionId      Optional: limit trace analysis to this session
+     * @param logs           Optional: additional log lines to analyze
+     * @param taskId         Optional: task ID for correlation
+     */
+    async analyze(errorMessage, sessionId, logs, taskId) {
+        const resolvedTaskId = taskId ?? randomUUID();
+        const evidence = [];
+        // 1. Analyze trace history
+        const traceEvidence = this.analyzeTraces(errorMessage, sessionId);
+        evidence.push(...traceEvidence);
+        // 2. Analyze git log
+        const gitEvidence = await this.analyzeGitLog(errorMessage);
+        evidence.push(...gitEvidence);
+        // 3. Analyze provided log lines
+        if (logs && logs.length > 0) {
+            const logEvidence = this.analyzeLogs(logs, errorMessage);
+            evidence.push(...logEvidence);
+        }
+        // 4. Synthesize: extract suspected files + root cause
+        const suspectedFiles = this.extractSuspectedFiles(evidence, errorMessage);
+        const rootCause = this.inferRootCause(evidence, errorMessage);
+        const fixStrategy = this.inferFixStrategy(rootCause, suspectedFiles);
+        const confidence = this.computeConfidence(evidence);
+        // 5. Git blame on suspected files (best-effort)
+        if (suspectedFiles.length > 0) {
+            const blameEvidence = await this.analyzeGitBlame(suspectedFiles.slice(0, 3));
+            evidence.push(...blameEvidence);
+        }
+        const report = {
+            taskId: resolvedTaskId,
+            rootCause,
+            suspectedFiles,
+            fixStrategy,
+            confidence,
+            evidence: evidence.slice(0, 50), // cap for storage
+            timestamp: Date.now(),
+        };
+        this.emitReport(report);
+        return report;
+    }
+    // ─── private — Trace Analysis ──────────────────────────────────────────────
+    analyzeTraces(errorMessage, sessionId) {
+        const evidence = [];
+        try {
+            // Find most recent trace files (last 3)
+            const files = this.listTraceFiles()
+                .filter(f => !sessionId || basename(f).includes(sessionId))
+                .slice(0, 3);
+            for (const file of files) {
+                const entries = this.readTraceFile(file);
+                // Find error events and the tool calls that preceded them
+                const errorEntries = entries.filter(e => e.event.kind === "agent:error" ||
+                    (e.event.kind === "agent:tool_result" && !e.event.output?.includes("success"))).slice(-10);
+                for (const entry of errorEntries) {
+                    evidence.push({
+                        kind: "trace",
+                        content: truncate(JSON.stringify(entry.event), 300),
+                        weight: 0.7,
+                    });
+                }
+                // Find the last phase_transition before error
+                const phaseEntries = entries.filter(e => e.event.kind === "agent:phase_transition").slice(-3);
+                for (const entry of phaseEntries) {
+                    evidence.push({
+                        kind: "trace",
+                        content: truncate(JSON.stringify(entry.event), 200),
+                        weight: 0.4,
+                    });
+                }
+            }
+        }
+        catch { /* non-fatal */ }
+        return evidence;
+    }
+    listTraceFiles() {
+        try {
+            return readdirSync(this.tracesDir)
+                .filter(f => f.endsWith(".jsonl"))
+                .map(f => join(this.tracesDir, f))
+                .sort((a, b) => {
+                try {
+                    return statSync(b).mtimeMs - statSync(a).mtimeMs;
+                }
+                catch {
+                    return 0;
+                }
+            });
+        }
+        catch {
+            return [];
+        }
+    }
+    readTraceFile(filePath) {
+        try {
+            const raw = readFileSync(filePath, "utf-8");
+            return raw.split("\n")
+                .filter(Boolean)
+                .slice(-this.maxTraceEntries)
+                .map(line => {
+                try {
+                    return JSON.parse(line);
+                }
+                catch {
+                    return null;
+                }
+            })
+                .filter((e) => e !== null);
+        }
+        catch {
+            return [];
+        }
+    }
+    // ─── private — Git Analysis ────────────────────────────────────────────────
+    async analyzeGitLog(errorMessage) {
+        const evidence = [];
+        try {
+            const result = await this.toolExecutor.execute({
+                id: `debug-gitlog-${Date.now()}`,
+                name: "shell_exec",
+                arguments: JSON.stringify({
+                    command: `git log --oneline -${this.maxGitLogLines} 2>/dev/null`,
+                    cwd: this.projectPath,
+                    timeout: 5000,
+                }),
+            });
+            if (result.success && result.output) {
+                // Find commits that mention files or keywords from error message
+                const keywords = this.extractKeywords(errorMessage);
+                const relevantLines = result.output.split("\n")
+                    .filter(line => keywords.some(kw => line.toLowerCase().includes(kw.toLowerCase())))
+                    .slice(0, 5);
+                for (const line of relevantLines) {
+                    evidence.push({ kind: "git_log", content: line, weight: 0.6 });
+                }
+                // Always include the last 3 commits (recent changes = likely culprits)
+                const recentLines = result.output.split("\n").filter(Boolean).slice(0, 3);
+                for (const line of recentLines) {
+                    if (!relevantLines.includes(line)) {
+                        evidence.push({ kind: "git_log", content: line, weight: 0.3 });
+                    }
+                }
+            }
+        }
+        catch { /* non-fatal */ }
+        return evidence;
+    }
+    async analyzeGitBlame(files) {
+        const evidence = [];
+        for (const file of files) {
+            try {
+                const result = await this.toolExecutor.execute({
+                    id: `debug-blame-${Date.now()}`,
+                    name: "shell_exec",
+                    arguments: JSON.stringify({
+                        command: `git log --oneline -5 -- "${file}" 2>/dev/null`,
+                        cwd: this.projectPath,
+                        timeout: 5000,
+                    }),
+                });
+                if (result.success && result.output.trim()) {
+                    evidence.push({
+                        kind: "git_blame",
+                        content: `${file}:\n${truncate(result.output, 300)}`,
+                        weight: 0.5,
+                    });
+                }
+            }
+            catch { /* non-fatal */ }
+        }
+        return evidence;
+    }
+    // ─── private — Log Analysis ────────────────────────────────────────────────
+    analyzeLogs(logs, errorMessage) {
+        const keywords = this.extractKeywords(errorMessage);
+        return logs
+            .filter(line => keywords.some(kw => line.toLowerCase().includes(kw.toLowerCase()))
+            || /error|exception|fail|crash|TypeError|SyntaxError/i.test(line))
+            .slice(0, 20)
+            .map(line => ({
+            kind: "log_line",
+            content: truncate(line, 200),
+            weight: /error|exception|fail/i.test(line) ? 0.8 : 0.4,
+        }));
+    }
+    // ─── private — Synthesis ─────────────────────────────────────────────────
+    extractSuspectedFiles(evidence, errorMessage) {
+        const filePattern = /([a-zA-Z0-9_/.-]+\.[a-zA-Z]{2,5})(?::\d+)?/g;
+        const files = new Map();
+        const allText = [
+            errorMessage,
+            ...evidence.map(e => e.content),
+        ].join("\n");
+        let match;
+        while ((match = filePattern.exec(allText)) !== null) {
+            const f = match[1];
+            if (f && !f.includes("node_modules") && f.includes("/")) {
+                files.set(f, (files.get(f) ?? 0) + 1);
+            }
+        }
+        return [...files.entries()]
+            .sort((a, b) => b[1] - a[1])
+            .slice(0, 5)
+            .map(([f]) => f);
+    }
+    inferRootCause(evidence, errorMessage) {
+        const errLines = errorMessage.split("\n").filter(Boolean);
+        const firstError = errLines[0] ?? "Unknown error";
+        // Check for common patterns
+        if (/TypeError|is not a function|Cannot read prop/i.test(errorMessage)) {
+            return `Type error: ${truncate(firstError, 150)}`;
+        }
+        if (/SyntaxError|Unexpected token|Cannot parse/i.test(errorMessage)) {
+            return `Syntax error: ${truncate(firstError, 150)}`;
+        }
+        if (/Cannot find module|Module not found/i.test(errorMessage)) {
+            return `Missing module: ${truncate(firstError, 150)}`;
+        }
+        if (/ENOENT|No such file/i.test(errorMessage)) {
+            return `Missing file: ${truncate(firstError, 150)}`;
+        }
+        if (/ECONNREFUSED|connection refused|timeout/i.test(errorMessage)) {
+            return `Network/connection failure: ${truncate(firstError, 150)}`;
+        }
+        // High-weight trace evidence
+        const highWeightEvidence = evidence
+            .filter(e => e.weight >= 0.7)
+            .map(e => e.content.slice(0, 100))
+            .slice(0, 2);
+        if (highWeightEvidence.length > 0) {
+            return `${truncate(firstError, 100)} (from trace: ${highWeightEvidence[0]})`;
+        }
+        return truncate(firstError, 200);
+    }
+    inferFixStrategy(rootCause, suspectedFiles) {
+        if (/type error/i.test(rootCause)) {
+            return `Check type definitions in ${suspectedFiles[0] ?? "the failing file"}. Verify function signatures and null checks.`;
+        }
+        if (/syntax error/i.test(rootCause)) {
+            return `Fix syntax in ${suspectedFiles[0] ?? "the failing file"}. Run: npx tsc --noEmit`;
+        }
+        if (/missing module/i.test(rootCause)) {
+            return `Run: pnpm install. Check that all imports reference existing modules.`;
+        }
+        if (/missing file/i.test(rootCause)) {
+            return `Verify ${suspectedFiles[0] ?? "referenced files"} exist. Check build output directory.`;
+        }
+        if (/network|connection/i.test(rootCause)) {
+            return `Check service availability. Verify environment variables for API keys/URLs.`;
+        }
+        if (suspectedFiles.length > 0) {
+            return `Investigate recent changes to: ${suspectedFiles.slice(0, 3).join(", ")}`;
+        }
+        return "Review recent commits with: git log --oneline -10. Check error stack trace.";
+    }
+    computeConfidence(evidence) {
+        if (evidence.length === 0)
+            return 0.1;
+        const avgWeight = evidence.reduce((s, e) => s + e.weight, 0) / evidence.length;
+        const coverageFactor = Math.min(evidence.length / 10, 1.0);
+        return Math.round(avgWeight * coverageFactor * 100) / 100;
+    }
+    extractKeywords(text) {
+        return text.split(/[\s:.()\n]/)
+            .filter(t => t.length > 4 && !/^(error|Error|at|in|the|and|for|with)$/.test(t))
+            .slice(0, 8);
+    }
+    emitReport(report) {
+        const event = {
+            kind: "agent:debug_report",
+            taskId: report.taskId,
+            rootCause: truncate(report.rootCause, BOUNDS.toolResultPersistence),
+            suspectedFiles: report.suspectedFiles,
+            fixStrategy: truncate(report.fixStrategy, 500),
+            confidence: report.confidence,
+            timestamp: report.timestamp,
+        };
+        this.emit("event", event);
+    }
+}
+//# sourceMappingURL=incident-debugger.js.map

package/dist/autonomous/incident-debugger.js.map

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

package/dist/autonomous/index.d.ts

@@ -0,0 +1,15 @@
+/**
+ * @module autonomous
+ * @description Phase 3 Autonomous Engineering Loop — exports all 5 components.
+ */
+export { TaskMemory } from "./task-memory.js";
+export type { TaskState, TaskStatus as AutonomousTaskStatus, TaskPhase as TaskMemoryPhase, EvidenceEntry, } from "./task-memory.js";
+export { ResearchAgent } from "./research-agent.js";
+export type { ResearchResult, ResearchSource, ResearchAgentConfig } from "./research-agent.js";
+export { ExplicitPlanningEngine } from "./explicit-planner.js";
+export type { ExplicitPlan, AutonomousPlanStep, ExplicitPlannerConfig, } from "./explicit-planner.js";
+export { PatchTournamentExecutor } from "./patch-tournament.js";
+export type { TournamentResult, CandidatePatch, RunAgentCallback, PatchTournamentConfig, } from "./patch-tournament.js";
+export { IncidentDebugger } from "./incident-debugger.js";
+export type { DebugReport, DebugEvidence, IncidentDebuggerConfig } from "./incident-debugger.js";
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/autonomous/index.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,EAAE,UAAU,EAAE,MAAM,kBAAkB,CAAC;AAC9C,YAAY,EACV,SAAS,EACT,UAAU,IAAI,oBAAoB,EAClC,SAAS,IAAI,eAAe,EAC5B,aAAa,GACd,MAAM,kBAAkB,CAAC;AAE1B,OAAO,EAAE,aAAa,EAAE,MAAM,qBAAqB,CAAC;AACpD,YAAY,EAAE,cAAc,EAAE,cAAc,EAAE,mBAAmB,EAAE,MAAM,qBAAqB,CAAC;AAE/F,OAAO,EAAE,sBAAsB,EAAE,MAAM,uBAAuB,CAAC;AAC/D,YAAY,EACV,YAAY,EACZ,kBAAkB,EAClB,qBAAqB,GACtB,MAAM,uBAAuB,CAAC;AAE/B,OAAO,EAAE,uBAAuB,EAAE,MAAM,uBAAuB,CAAC;AAChE,YAAY,EACV,gBAAgB,EAChB,cAAc,EACd,gBAAgB,EAChB,qBAAqB,GACtB,MAAM,uBAAuB,CAAC;AAE/B,OAAO,EAAE,gBAAgB,EAAE,MAAM,wBAAwB,CAAC;AAC1D,YAAY,EAAE,WAAW,EAAE,aAAa,EAAE,sBAAsB,EAAE,MAAM,wBAAwB,CAAC"}

package/dist/autonomous/index.js

@@ -0,0 +1,10 @@
+/**
+ * @module autonomous
+ * @description Phase 3 Autonomous Engineering Loop — exports all 5 components.
+ */
+export { TaskMemory } from "./task-memory.js";
+export { ResearchAgent } from "./research-agent.js";
+export { ExplicitPlanningEngine } from "./explicit-planner.js";
+export { PatchTournamentExecutor } from "./patch-tournament.js";
+export { IncidentDebugger } from "./incident-debugger.js";
+//# sourceMappingURL=index.js.map

package/dist/autonomous/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/autonomous/index.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,EAAE,UAAU,EAAE,MAAM,kBAAkB,CAAC;AAQ9C,OAAO,EAAE,aAAa,EAAE,MAAM,qBAAqB,CAAC;AAGpD,OAAO,EAAE,sBAAsB,EAAE,MAAM,uBAAuB,CAAC;AAO/D,OAAO,EAAE,uBAAuB,EAAE,MAAM,uBAAuB,CAAC;AAQhE,OAAO,EAAE,gBAAgB,EAAE,MAAM,wBAAwB,CAAC"}

package/dist/autonomous/patch-tournament.d.ts

@@ -0,0 +1,82 @@
+/**
+ * @module autonomous/patch-tournament
+ * @description Patch Tournament Executor — generates N candidate patches for a goal,
+ * scores each with the QA pipeline, and selects the best.
+ *
+ * Design:
+ * - Takes a "run agent" callback (injected from CLI — keeps this module pure)
+ * - Runs candidates sequentially (not parallel) to avoid file conflicts
+ * - Scores via QAPipeline + diff stats from evidence history
+ * - Emits agent:tournament_result with winner index
+ *
+ * Constraints:
+ * - Does NOT touch the main agent loop (deterministic)
+ * - All scoring goes through QAPipeline (no bypass)
+ * - Goes through OverheadGovernor (caller must check shouldRunTournament())
+ * - Emits events at every candidate + final result
+ */
+import { EventEmitter } from "node:events";
+import { type QAPipelineResult, type QAPipelineConfig } from "../qa-pipeline.js";
+export interface CandidatePatch {
+    /** 0-based index */
+    index: number;
+    /** Strategy hint passed to the agent run */
+    strategy: string;
+    /** Files changed by this candidate */
+    filesChanged: string[];
+    /** QA result */
+    qaResult: QAPipelineResult | null;
+    /** Composite score 0.0–1.0 (higher = better) */
+    score: number;
+    /** Human-readable explanation */
+    reason: string;
+}
+export interface TournamentResult {
+    taskId: string;
+    goal: string;
+    /** 0-based index of the winner */
+    winner: number;
+    candidates: CandidatePatch[];
+    /** Quality score of winner */
+    qualityScore: number;
+    timestamp: number;
+}
+/**
+ * Callback the CLI provides to run a single agent attempt.
+ * Returns the list of files changed by this run.
+ */
+export type RunAgentCallback = (goal: string, strategy: string, candidateIndex: number) => Promise<string[]>;
+export interface PatchTournamentConfig {
+    /** Number of candidate patches to generate (default: 3) */
+    candidates?: number;
+    /** Strategies to use for each candidate (must match candidates count) */
+    strategies?: string[];
+    /** QA config for scoring */
+    qaConfig?: Partial<QAPipelineConfig>;
+    /** Project path for QA pipeline */
+    projectPath?: string;
+}
+export declare class PatchTournamentExecutor extends EventEmitter {
+    private readonly config;
+    constructor(config?: PatchTournamentConfig);
+    /**
+     * Run the tournament. For each candidate:
+     * 1. Call runAgent() to generate a patch
+     * 2. Score with QAPipeline
+     * 3. Track best
+     *
+     * Returns TournamentResult with winner index.
+     * Emits agent:tournament_result at completion.
+     *
+     * NOTE: The CLI is responsible for:
+     * - Stashing current git state before the first candidate
+     * - Restoring baseline between candidates (git stash pop + git stash)
+     * - Applying the winner's patch after selection
+     */
+    run(goal: string, runAgent: RunAgentCallback, taskId?: string): Promise<TournamentResult>;
+    private defaultStrategies;
+    private describeScore;
+    private emitProgress;
+    private emitResult;
+}
+//# sourceMappingURL=patch-tournament.d.ts.map

package/dist/autonomous/patch-tournament.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"patch-tournament.d.ts","sourceRoot":"","sources":["../../src/autonomous/patch-tournament.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;GAgBG;AAEH,OAAO,EAAE,YAAY,EAAE,MAAM,aAAa,CAAC;AAE3C,OAAO,EAAc,KAAK,gBAAgB,EAAE,KAAK,gBAAgB,EAAE,MAAM,mBAAmB,CAAC;AAK7F,MAAM,WAAW,cAAc;IAC7B,oBAAoB;IACpB,KAAK,EAAE,MAAM,CAAC;IACd,4CAA4C;IAC5C,QAAQ,EAAE,MAAM,CAAC;IACjB,sCAAsC;IACtC,YAAY,EAAE,MAAM,EAAE,CAAC;IACvB,gBAAgB;IAChB,QAAQ,EAAE,gBAAgB,GAAG,IAAI,CAAC;IAClC,gDAAgD;IAChD,KAAK,EAAE,MAAM,CAAC;IACd,iCAAiC;IACjC,MAAM,EAAE,MAAM,CAAC;CAChB;AAED,MAAM,WAAW,gBAAgB;IAC/B,MAAM,EAAE,MAAM,CAAC;IACf,IAAI,EAAE,MAAM,CAAC;IACb,kCAAkC;IAClC,MAAM,EAAE,MAAM,CAAC;IACf,UAAU,EAAE,cAAc,EAAE,CAAC;IAC7B,8BAA8B;IAC9B,YAAY,EAAE,MAAM,CAAC;IACrB,SAAS,EAAE,MAAM,CAAC;CACnB;AAED;;;GAGG;AACH,MAAM,MAAM,gBAAgB,GAAG,CAC7B,IAAI,EAAE,MAAM,EACZ,QAAQ,EAAE,MAAM,EAChB,cAAc,EAAE,MAAM,KACnB,OAAO,CAAC,MAAM,EAAE,CAAC,CAAC;AAEvB,MAAM,WAAW,qBAAqB;IACpC,2DAA2D;IAC3D,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,yEAAyE;IACzE,UAAU,CAAC,EAAE,MAAM,EAAE,CAAC;IACtB,4BAA4B;IAC5B,QAAQ,CAAC,EAAE,OAAO,CAAC,gBAAgB,CAAC,CAAC;IACrC,mCAAmC;IACnC,WAAW,CAAC,EAAE,MAAM,CAAC;CACtB;AAcD,qBAAa,uBAAwB,SAAQ,YAAY;IACvD,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAkC;gBAE7C,MAAM,GAAE,qBAA0B;IAW9C;;;;;;;;;;;;;OAaG;IACG,GAAG,CACP,IAAI,EAAE,MAAM,EACZ,QAAQ,EAAE,gBAAgB,EAC1B,MAAM,CAAC,EAAE,MAAM,GACd,OAAO,CAAC,gBAAgB,CAAC;IAkE5B,OAAO,CAAC,iBAAiB;IAWzB,OAAO,CAAC,aAAa;IAKrB,OAAO,CAAC,YAAY;IAYpB,OAAO,CAAC,UAAU;CAWnB"}