@toyako/hive 1.0.0

package/dist/review/ReviewConsensus.js

@@ -0,0 +1,174 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.ReviewConsensus = void 0;
+const DEFAULT_CONFIG = {
+    minReviewers: 1,
+    consensusStrategy: "majority",
+    onDisagreement: "highest-score",
+};
+class ReviewConsensus {
+    config;
+    thirdPartyReviewer;
+    constructor(config, thirdPartyReviewer) {
+        this.config = { ...DEFAULT_CONFIG, ...config };
+        this.thirdPartyReviewer = thirdPartyReviewer;
+    }
+    /**
+     * Collect reviews from multiple reviewers concurrently.
+     * Returns votes once minReviewers have responded.
+     */
+    async collectReviews(task, reviewers) {
+        if (reviewers.length < this.config.minReviewers) {
+            throw new Error(`Need at least ${this.config.minReviewers} reviewers, got ${reviewers.length}`);
+        }
+        const reviewPromises = reviewers.map(async (reviewer) => {
+            if (!reviewer.review) {
+                throw new Error(`${reviewer.name} has no review capability`);
+            }
+            const result = await reviewer.review(task);
+            return {
+                reviewerId: reviewer.name,
+                result,
+                timestamp: Date.now(),
+            };
+        });
+        // Wait for all reviewers
+        const votes = await Promise.all(reviewPromises);
+        return votes;
+    }
+    /**
+     * Resolve consensus from collected votes.
+     * Returns ConsensusResult with final decision.
+     */
+    resolve(votes) {
+        if (votes.length === 0) {
+            return {
+                decision: "FAIL",
+                finalDecision: "FAIL",
+                votes: [],
+                strategy: this.config.consensusStrategy,
+                resolution: "no-votes",
+                score: 0,
+                issues: ["No reviews collected"],
+            };
+        }
+        const passVotes = votes.filter((v) => v.result.decision === "PASS");
+        const failVotes = votes.filter((v) => v.result.decision === "FAIL");
+        const passRatio = passVotes.length / votes.length;
+        // Apply consensus strategy
+        let rawDecision;
+        let resolution;
+        switch (this.config.consensusStrategy) {
+            case "unanimous":
+                rawDecision = passVotes.length === votes.length ? "PASS" : "FAIL";
+                break;
+            case "majority":
+                if (passRatio > 0.5) {
+                    rawDecision = "PASS";
+                }
+                else if (passRatio < 0.5) {
+                    rawDecision = "FAIL";
+                }
+                else {
+                    rawDecision = "DISAGREEMENT"; // exact tie
+                }
+                break;
+            case "best-score":
+                const bestVote = [...votes].sort((a, b) => b.result.score - a.result.score)[0];
+                rawDecision = bestVote.result.score >= 60 ? "PASS" : "FAIL";
+                resolution = `best-score: ${bestVote.result.score} from ${bestVote.reviewerId}`;
+                break;
+            default:
+                rawDecision = "FAIL";
+        }
+        // For majority/unanimous: if strategy already gave a clear answer, use it directly
+        // Only use disagreement resolution when strategy says DISAGREEMENT
+        let finalDecision;
+        if (rawDecision === "DISAGREEMENT") {
+            // Strategy couldn't decide — use disagreement resolution
+            const resolved = this.resolveDisagreement(votes, passVotes, failVotes);
+            finalDecision = resolved.decision;
+            resolution = resolved.resolution;
+        }
+        else {
+            // Strategy gave a clear answer (PASS or FAIL) — honor it
+            finalDecision = rawDecision === "PASS" ? "PASS" : "FAIL";
+        }
+        // Aggregate score and issues
+        const avgScore = votes.reduce((sum, v) => sum + v.result.score, 0) / votes.length;
+        const allIssues = [
+            ...new Set(votes.flatMap((v) => v.result.issues)),
+        ];
+        return {
+            decision: rawDecision,
+            finalDecision,
+            votes,
+            strategy: this.config.consensusStrategy,
+            resolution,
+            score: Math.round(avgScore),
+            issues: allIssues,
+        };
+    }
+    /**
+     * Resolve a disagreement based on onDisagreement config.
+     */
+    resolveDisagreement(votes, passVotes, failVotes) {
+        switch (this.config.onDisagreement) {
+            case "highest-score": {
+                const bestVote = [...votes].sort((a, b) => b.result.score - a.result.score)[0];
+                return {
+                    decision: bestVote.result.decision,
+                    resolution: `highest-score: ${bestVote.result.score} from ${bestVote.reviewerId}`,
+                };
+            }
+            case "third-reviewer": {
+                if (this.thirdPartyReviewer?.review) {
+                    // Note: third-party review is async, but resolve is sync.
+                    // For sync resolution, fall back to highest-score.
+                    // Real third-party review should be done via collectReviews with an extra reviewer.
+                    const bestVote = [...votes].sort((a, b) => b.result.score - a.result.score)[0];
+                    return {
+                        decision: bestVote.result.decision,
+                        resolution: `third-reviewer-fallback (highest-score): ${bestVote.result.score} from ${bestVote.reviewerId}`,
+                    };
+                }
+                // No third-party available, fall back to highest-score
+                const best = [...votes].sort((a, b) => b.result.score - a.result.score)[0];
+                return {
+                    decision: best.result.decision,
+                    resolution: `no-third-reviewer (highest-score): ${best.result.score} from ${best.reviewerId}`,
+                };
+            }
+            case "escalate": {
+                // Signal escalation - caller should handle
+                const bestVote = [...votes].sort((a, b) => b.result.score - a.result.score)[0];
+                return {
+                    decision: bestVote.result.decision,
+                    resolution: `escalated (highest-score used): ${bestVote.result.score} from ${bestVote.reviewerId}`,
+                };
+            }
+            default: {
+                // Default: fail on disagreement
+                return {
+                    decision: "FAIL",
+                    resolution: "disagreement-default: FAIL",
+                };
+            }
+        }
+    }
+    /**
+     * Convenience: collect reviews and resolve in one call.
+     */
+    async review(task, reviewers) {
+        const votes = await this.collectReviews(task, reviewers);
+        return this.resolve(votes);
+    }
+    /**
+     * Get current config.
+     */
+    getConfig() {
+        return { ...this.config };
+    }
+}
+exports.ReviewConsensus = ReviewConsensus;
+//# sourceMappingURL=ReviewConsensus.js.map

package/dist/review/ReviewConsensus.js.map

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

package/dist/runtime/CapabilityDiscovery.d.ts

@@ -0,0 +1,39 @@
+import { AgentAdapter } from "../types";
+export interface CapabilityReport {
+    runtimeId: string;
+    capabilities: string[];
+    confidence: number;
+    source: "static" | "probe" | "merged";
+    timestamp: number;
+}
+export declare class CapabilityDiscovery {
+    private reports;
+    constructor();
+    /**
+     * Discover capabilities for a runtime adapter.
+     *
+     * Step 1: Read adapter's static capabilities
+     * Step 2: Send probe prompt to runtime
+     * Step 3: Merge and persist
+     */
+    discover(adapter: AgentAdapter): Promise<CapabilityReport>;
+    /**
+     * Get cached capability report for a runtime.
+     */
+    get(runtimeId: string): CapabilityReport | undefined;
+    /**
+     * Get all reports.
+     */
+    all(): CapabilityReport[];
+    /**
+     * Find runtimes that have a specific capability.
+     */
+    findByCapability(capability: string): CapabilityReport[];
+    /**
+     * Send probe prompt to runtime and parse response.
+     */
+    private probe;
+    private persist;
+    private loadPersisted;
+}
+//# sourceMappingURL=CapabilityDiscovery.d.ts.map

package/dist/runtime/CapabilityDiscovery.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"CapabilityDiscovery.d.ts","sourceRoot":"","sources":["../../src/runtime/CapabilityDiscovery.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,YAAY,EAAgB,MAAM,UAAU,CAAC;AAetD,MAAM,WAAW,gBAAgB;IAC/B,SAAS,EAAE,MAAM,CAAC;IAClB,YAAY,EAAE,MAAM,EAAE,CAAC;IACvB,UAAU,EAAE,MAAM,CAAC;IACnB,MAAM,EAAE,QAAQ,GAAG,OAAO,GAAG,QAAQ,CAAC;IACtC,SAAS,EAAE,MAAM,CAAC;CACnB;AAED,qBAAa,mBAAmB;IAC9B,OAAO,CAAC,OAAO,CAA4C;;IAM3D;;;;;;OAMG;IACG,QAAQ,CAAC,OAAO,EAAE,YAAY,GAAG,OAAO,CAAC,gBAAgB,CAAC;IAmChE;;OAEG;IACH,GAAG,CAAC,SAAS,EAAE,MAAM,GAAG,gBAAgB,GAAG,SAAS;IAIpD;;OAEG;IACH,GAAG,IAAI,gBAAgB,EAAE;IAIzB;;OAEG;IACH,gBAAgB,CAAC,UAAU,EAAE,MAAM,GAAG,gBAAgB,EAAE;IAIxD;;OAEG;YACW,KAAK;IA2BnB,OAAO,CAAC,OAAO;IAOf,OAAO,CAAC,aAAa;CAWtB"}

package/dist/runtime/CapabilityDiscovery.js

@@ -0,0 +1,157 @@
+"use strict";
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {
+    Object.defineProperty(o, "default", { enumerable: true, value: v });
+}) : function(o, v) {
+    o["default"] = v;
+});
+var __importStar = (this && this.__importStar) || (function () {
+    var ownKeys = function(o) {
+        ownKeys = Object.getOwnPropertyNames || function (o) {
+            var ar = [];
+            for (var k in o) if (Object.prototype.hasOwnProperty.call(o, k)) ar[ar.length] = k;
+            return ar;
+        };
+        return ownKeys(o);
+    };
+    return function (mod) {
+        if (mod && mod.__esModule) return mod;
+        var result = {};
+        if (mod != null) for (var k = ownKeys(mod), i = 0; i < k.length; i++) if (k[i] !== "default") __createBinding(result, mod, k[i]);
+        __setModuleDefault(result, mod);
+        return result;
+    };
+})();
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.CapabilityDiscovery = void 0;
+const OutputNormalizer_1 = require("../utils/OutputNormalizer");
+const fs = __importStar(require("fs"));
+const path = __importStar(require("path"));
+const CAPABILITIES_FILE = path.resolve(process.cwd(), ".agent-hive/runtime-capabilities.json");
+const PROBE_PROMPT = `List your capabilities as JSON. Return ONLY this JSON format:
+
+{
+  "capabilities": ["capability1", "capability2"]
+}
+
+Valid capabilities: coding, review, planning, research, refactor, architecture, security-scan, testing, documentation, debugging`;
+class CapabilityDiscovery {
+    reports = new Map();
+    constructor() {
+        this.loadPersisted();
+    }
+    /**
+     * Discover capabilities for a runtime adapter.
+     *
+     * Step 1: Read adapter's static capabilities
+     * Step 2: Send probe prompt to runtime
+     * Step 3: Merge and persist
+     */
+    async discover(adapter) {
+        const staticCaps = adapter.capabilities || [];
+        let probeCaps = [];
+        let confidence = 0.5;
+        // Step 2: Probe the runtime
+        try {
+            const response = await this.probe(adapter);
+            if (response.length > 0) {
+                probeCaps = response;
+                confidence = 0.9;
+            }
+        }
+        catch (e) {
+            // Probe failed, fall back to static only
+            console.debug("[CapabilityDiscovery] Probe failed, using static fallback:", e instanceof Error ? e.message : e);
+            confidence = 0.3;
+        }
+        // Step 3: Merge (union of static + probe)
+        const merged = [...new Set([...staticCaps, ...probeCaps])];
+        const report = {
+            runtimeId: adapter.name,
+            capabilities: merged,
+            confidence,
+            source: probeCaps.length > 0 ? "merged" : "static",
+            timestamp: Date.now(),
+        };
+        this.reports.set(adapter.name, report);
+        this.persist();
+        return report;
+    }
+    /**
+     * Get cached capability report for a runtime.
+     */
+    get(runtimeId) {
+        return this.reports.get(runtimeId);
+    }
+    /**
+     * Get all reports.
+     */
+    all() {
+        return Array.from(this.reports.values());
+    }
+    /**
+     * Find runtimes that have a specific capability.
+     */
+    findByCapability(capability) {
+        return this.all().filter(r => r.capabilities.includes(capability));
+    }
+    /**
+     * Send probe prompt to runtime and parse response.
+     */
+    async probe(adapter) {
+        if (!adapter.execute)
+            return [];
+        const result = await adapter.execute({
+            id: "probe",
+            instruction: PROBE_PROMPT,
+            executor: adapter.name,
+            reviewer: "",
+            status: "PENDING",
+            revisionCount: 0,
+            maxRevision: 1,
+            timeout: 30_000,
+            workingDirectory: process.cwd(),
+            createdAt: Date.now(),
+            updatedAt: Date.now(),
+        });
+        if (!result.success || !result.output)
+            return [];
+        const parsed = (0, OutputNormalizer_1.extractJson)(result.output);
+        if (parsed && Array.isArray(parsed.capabilities)) {
+            return parsed.capabilities.filter((c) => typeof c === "string");
+        }
+        return [];
+    }
+    persist() {
+        const data = {};
+        for (const [k, v] of this.reports)
+            data[k] = v;
+        fs.mkdirSync(path.dirname(CAPABILITIES_FILE), { recursive: true });
+        fs.writeFileSync(CAPABILITIES_FILE, JSON.stringify(data, null, 2));
+    }
+    loadPersisted() {
+        if (!fs.existsSync(CAPABILITIES_FILE))
+            return;
+        try {
+            const data = JSON.parse(fs.readFileSync(CAPABILITIES_FILE, "utf-8"));
+            for (const [k, v] of Object.entries(data)) {
+                this.reports.set(k, v);
+            }
+        }
+        catch (e) {
+            console.warn("[CapabilityDiscovery] Failed to load persisted capabilities:", e instanceof Error ? e.message : e);
+        }
+    }
+}
+exports.CapabilityDiscovery = CapabilityDiscovery;
+//# sourceMappingURL=CapabilityDiscovery.js.map

package/dist/runtime/CapabilityDiscovery.js.map

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

package/dist/runtime/EventBus.d.ts

@@ -0,0 +1,26 @@
+export interface Event {
+    id: string;
+    traceId: string;
+    timestamp: number;
+    type: string;
+    payload: unknown;
+}
+export declare class EventBus {
+    private events;
+    private subscribers;
+    private logDir;
+    constructor(logDir?: string);
+    /** Publish an event (append-only, immutable) */
+    publish(event: Event): void;
+    /** Subscribe to events by type */
+    subscribe(eventType: string, handler: (event: Event) => void): void;
+    /** Replay all events for a trace */
+    replay(traceId: string): Event[];
+    /** Get all events */
+    all(): Event[];
+    /** Get events by type */
+    byType(type: string): Event[];
+    /** Generate a unique event ID */
+    static generateId(): string;
+}
+//# sourceMappingURL=EventBus.d.ts.map

package/dist/runtime/EventBus.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"EventBus.d.ts","sourceRoot":"","sources":["../../src/runtime/EventBus.ts"],"names":[],"mappings":"AAOA,MAAM,WAAW,KAAK;IACpB,EAAE,EAAE,MAAM,CAAC;IACX,OAAO,EAAE,MAAM,CAAC;IAChB,SAAS,EAAE,MAAM,CAAC;IAClB,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,EAAE,OAAO,CAAC;CAClB;AAED,qBAAa,QAAQ;IACnB,OAAO,CAAC,MAAM,CAAe;IAC7B,OAAO,CAAC,WAAW,CAAsD;IACzE,OAAO,CAAC,MAAM,CAAS;gBAEX,MAAM,CAAC,EAAE,MAAM;IAK3B,gDAAgD;IAChD,OAAO,CAAC,KAAK,EAAE,KAAK,GAAG,IAAI;IAoB3B,kCAAkC;IAClC,SAAS,CAAC,SAAS,EAAE,MAAM,EAAE,OAAO,EAAE,CAAC,KAAK,EAAE,KAAK,KAAK,IAAI,GAAG,IAAI;IAOnE,oCAAoC;IACpC,MAAM,CAAC,OAAO,EAAE,MAAM,GAAG,KAAK,EAAE;IAchC,qBAAqB;IACrB,GAAG,IAAI,KAAK,EAAE;IAId,yBAAyB;IACzB,MAAM,CAAC,IAAI,EAAE,MAAM,GAAG,KAAK,EAAE;IAI7B,iCAAiC;IACjC,MAAM,CAAC,UAAU,IAAI,MAAM;CAG5B"}

package/dist/runtime/EventBus.js

@@ -0,0 +1,103 @@
+"use strict";
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {
+    Object.defineProperty(o, "default", { enumerable: true, value: v });
+}) : function(o, v) {
+    o["default"] = v;
+});
+var __importStar = (this && this.__importStar) || (function () {
+    var ownKeys = function(o) {
+        ownKeys = Object.getOwnPropertyNames || function (o) {
+            var ar = [];
+            for (var k in o) if (Object.prototype.hasOwnProperty.call(o, k)) ar[ar.length] = k;
+            return ar;
+        };
+        return ownKeys(o);
+    };
+    return function (mod) {
+        if (mod && mod.__esModule) return mod;
+        var result = {};
+        if (mod != null) for (var k = ownKeys(mod), i = 0; i < k.length; i++) if (k[i] !== "default") __createBinding(result, mod, k[i]);
+        __setModuleDefault(result, mod);
+        return result;
+    };
+})();
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.EventBus = void 0;
+/**
+ * EventBus — append-only, immutable event store.
+ * Event sourcing compatible. Supports publish/subscribe/replay.
+ */
+const fs = __importStar(require("fs"));
+const path = __importStar(require("path"));
+class EventBus {
+    events = [];
+    subscribers = new Map();
+    logDir;
+    constructor(logDir) {
+        this.logDir = logDir || path.resolve(process.cwd(), ".agent-hive/events");
+        fs.mkdirSync(this.logDir, { recursive: true });
+    }
+    /** Publish an event (append-only, immutable) */
+    publish(event) {
+        this.events.push(event);
+        // Persist to file
+        const logFile = path.join(this.logDir, `${event.traceId}.jsonl`);
+        fs.appendFileSync(logFile, JSON.stringify(event) + "\n");
+        // Notify subscribers
+        const handlers = this.subscribers.get(event.type) || [];
+        for (const handler of handlers) {
+            handler(event);
+        }
+        // Also notify wildcard subscribers
+        const wildcardHandlers = this.subscribers.get("*") || [];
+        for (const handler of wildcardHandlers) {
+            handler(event);
+        }
+    }
+    /** Subscribe to events by type */
+    subscribe(eventType, handler) {
+        if (!this.subscribers.has(eventType)) {
+            this.subscribers.set(eventType, []);
+        }
+        this.subscribers.get(eventType).push(handler);
+    }
+    /** Replay all events for a trace */
+    replay(traceId) {
+        // Try memory first, then file
+        const memEvents = this.events.filter(e => e.traceId === traceId);
+        if (memEvents.length > 0)
+            return memEvents;
+        const logFile = path.join(this.logDir, `${traceId}.jsonl`);
+        if (!fs.existsSync(logFile))
+            return [];
+        return fs.readFileSync(logFile, "utf-8")
+            .split("\n")
+            .filter(l => l.trim())
+            .map(l => JSON.parse(l));
+    }
+    /** Get all events */
+    all() {
+        return [...this.events];
+    }
+    /** Get events by type */
+    byType(type) {
+        return this.events.filter(e => e.type === type);
+    }
+    /** Generate a unique event ID */
+    static generateId() {
+        return `evt-${Date.now().toString(36)}-${Math.random().toString(36).slice(2, 6)}`;
+    }
+}
+exports.EventBus = EventBus;
+//# sourceMappingURL=EventBus.js.map

package/dist/runtime/EventBus.js.map

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

package/dist/runtime/FailureAnalyzer.d.ts

@@ -0,0 +1,24 @@
+/**
+ * FailureAnalyzer — automatic failure root cause analysis.
+ */
+import { EventBus, Event } from "./EventBus";
+export interface FailureReport {
+    traceId: string;
+    failedStep: number;
+    rootCause: string;
+    command: string;
+    exitCode: number;
+    durationMs: number;
+    error: string;
+    events: Event[];
+}
+export declare class FailureAnalyzer {
+    private eventBus;
+    constructor(eventBus: EventBus);
+    /** Analyze a failed trace */
+    analyze(traceId: string): FailureReport | null;
+    /** Format a failure report */
+    format(traceId: string): string;
+    private determineRootCause;
+}
+//# sourceMappingURL=FailureAnalyzer.d.ts.map

package/dist/runtime/FailureAnalyzer.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"FailureAnalyzer.d.ts","sourceRoot":"","sources":["../../src/runtime/FailureAnalyzer.ts"],"names":[],"mappings":"AAAA;;GAEG;AACH,OAAO,EAAE,QAAQ,EAAE,KAAK,EAAE,MAAM,YAAY,CAAC;AAE7C,MAAM,WAAW,aAAa;IAC5B,OAAO,EAAE,MAAM,CAAC;IAChB,UAAU,EAAE,MAAM,CAAC;IACnB,SAAS,EAAE,MAAM,CAAC;IAClB,OAAO,EAAE,MAAM,CAAC;IAChB,QAAQ,EAAE,MAAM,CAAC;IACjB,UAAU,EAAE,MAAM,CAAC;IACnB,KAAK,EAAE,MAAM,CAAC;IACd,MAAM,EAAE,KAAK,EAAE,CAAC;CACjB;AAED,qBAAa,eAAe;IAC1B,OAAO,CAAC,QAAQ,CAAW;gBAEf,QAAQ,EAAE,QAAQ;IAI9B,6BAA6B;IAC7B,OAAO,CAAC,OAAO,EAAE,MAAM,GAAG,aAAa,GAAG,IAAI;IA+B9C,8BAA8B;IAC9B,MAAM,CAAC,OAAO,EAAE,MAAM,GAAG,MAAM;IAgB/B,OAAO,CAAC,kBAAkB;CAc3B"}

package/dist/runtime/FailureAnalyzer.js

@@ -0,0 +1,71 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.FailureAnalyzer = void 0;
+class FailureAnalyzer {
+    eventBus;
+    constructor(eventBus) {
+        this.eventBus = eventBus;
+    }
+    /** Analyze a failed trace */
+    analyze(traceId) {
+        const events = this.eventBus.replay(traceId);
+        if (events.length === 0)
+            return null;
+        // Find the first failure event
+        const failEvent = events.find(e => e.type === "ExecutionFailed" || e.type === "AgentFailed");
+        if (!failEvent)
+            return null;
+        const failIndex = events.indexOf(failEvent);
+        const p = failEvent.payload;
+        // Find the preceding execution started event
+        const startEvent = events.slice(0, failIndex).reverse().find(e => e.type === "ExecutionStarted" || e.type === "AgentReceivedTask");
+        return {
+            traceId,
+            failedStep: failIndex + 1,
+            rootCause: this.determineRootCause(failEvent, events),
+            command: p.command || p.taskId || "unknown",
+            exitCode: p.exitCode || 1,
+            durationMs: p.durationMs || 0,
+            error: p.error || "unknown error",
+            events,
+        };
+    }
+    /** Format a failure report */
+    format(traceId) {
+        const report = this.analyze(traceId);
+        if (!report)
+            return `No failure found for trace: ${traceId}`;
+        return [
+            `Failure Report: ${traceId}`,
+            `  Failed Step: ${report.failedStep}`,
+            `  Root Cause: ${report.rootCause}`,
+            `  Command: ${report.command}`,
+            `  Exit Code: ${report.exitCode}`,
+            `  Duration: ${report.durationMs}ms`,
+            `  Error: ${report.error}`,
+            `  Total Events: ${report.events.length}`,
+        ].join("\n");
+    }
+    determineRootCause(failEvent, allEvents) {
+        const p = failEvent.payload;
+        if (p.error?.includes("TIMEOUT"))
+            return "Execution timeout";
+        if (p.exitCode === 127)
+            return "Command not found";
+        if (p.exitCode === 126)
+            return "Permission denied";
+        if (p.exitCode === 137)
+            return "Process killed (OOM or SIGKILL)";
+        if (p.exitCode === 139)
+            return "Segmentation fault";
+        if (p.error?.includes("ENOTFOUND"))
+            return "Network error";
+        if (p.error?.includes("ECONNREFUSED"))
+            return "Connection refused";
+        if (p.error?.includes("validation"))
+            return "AST validation failed";
+        return `Exit code ${p.exitCode}: ${p.error || "unknown"}`;
+    }
+}
+exports.FailureAnalyzer = FailureAnalyzer;
+//# sourceMappingURL=FailureAnalyzer.js.map

package/dist/runtime/FailureAnalyzer.js.map

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

package/dist/runtime/ReplayEngine.d.ts

@@ -0,0 +1,19 @@
+/**
+ * ReplayEngine — replay execution traces step by step.
+ */
+import { EventBus, Event } from "./EventBus";
+export interface ReplayStep {
+    step: number;
+    event: Event;
+    description: string;
+}
+export declare class ReplayEngine {
+    private eventBus;
+    constructor(eventBus: EventBus);
+    /** Replay a trace and output step-by-step */
+    replay(traceId: string): ReplayStep[];
+    /** Format a replay as human-readable text */
+    format(traceId: string): string;
+    private describe;
+}
+//# sourceMappingURL=ReplayEngine.d.ts.map