pi-harness-runtime 0.5.0 → 0.6.3-beta.13

package/packages/evaluation-engine/test/engine.test.ts

@@ -0,0 +1,277 @@
+/**
+ * Evaluation Engine Tests (RFC-0057)
+ */
+
+import { describe, it, expect, beforeEach } from "@jest/globals";
+import { type EvaluationEngine, createEvaluationEngine } from "../src/index.js";
+import type { EvaluationRequest } from "../src/types.js";
+
+describe("EvaluationEngine", () => {
+	let engine: EvaluationEngine;
+	let defaultTask: EvaluationRequest["task"];
+	let defaultOutputs: EvaluationRequest["outputs"];
+	let defaultTestResults: EvaluationRequest["testResults"];
+	let defaultPolicyFindings: EvaluationRequest["policyFindings"];
+
+	beforeEach(() => {
+		engine = createEvaluationEngine();
+		defaultTask = {
+			id: "task-1",
+			title: "Test Task",
+			description: "A test task",
+			acceptanceCriteria: ["Output file exists", "Tests pass"],
+			requiredArtifacts: ["output.txt"],
+			mandatoryStages: [],
+		};
+		defaultOutputs = [
+			{
+				id: "out-1",
+				type: "file",
+				path: "output.txt",
+				description: "Generated output file",
+			},
+		];
+		defaultTestResults = [
+			{
+				id: "test-1",
+				testFile: "test.spec.ts",
+				status: "passed",
+				durationMs: 100,
+			},
+		];
+		defaultPolicyFindings = [];
+	});
+
+	describe("evaluate", () => {
+		it("passes when all criteria are met", () => {
+			const request: EvaluationRequest = {
+				jobId: "job-1",
+				task: defaultTask,
+				worktreePath: "/tmp/worktree",
+				outputs: defaultOutputs,
+				testResults: defaultTestResults,
+				policyFindings: defaultPolicyFindings,
+			};
+
+			const result = engine.evaluate(request);
+
+			expect(result.status).toBe("passed");
+			expect(result.score).toBeGreaterThanOrEqual(70);
+			expect(result.recommendedAction).toBe("continue");
+			expect(result.evidence.length).toBeGreaterThan(0);
+		});
+
+		it("fails when required artifact is missing", () => {
+			const request: EvaluationRequest = {
+				jobId: "job-1",
+				task: defaultTask,
+				worktreePath: "/tmp/worktree",
+				outputs: [], // No outputs
+				testResults: defaultTestResults,
+				policyFindings: defaultPolicyFindings,
+			};
+
+			const result = engine.evaluate(request);
+
+			expect(result.status).toBe("failed");
+			expect(result.findings.some((f) => f.message.includes("missing"))).toBe(
+				true,
+			);
+		});
+
+		it("fails on critical policy violation", () => {
+			const request: EvaluationRequest = {
+				jobId: "job-1",
+				task: defaultTask,
+				worktreePath: "/tmp/worktree",
+				outputs: defaultOutputs,
+				testResults: defaultTestResults,
+				policyFindings: [
+					{
+						ruleId: "SEC-001",
+						severity: "critical",
+						message: "Hardcoded API key detected",
+						filePath: "src/config.ts",
+						line: 10,
+					},
+				],
+			};
+
+			const result = engine.evaluate(request);
+
+			expect(result.status).toBe("failed");
+			expect(result.findings.some((f) => f.severity === "critical")).toBe(true);
+			expect(result.recommendedAction).toBe("repair");
+		});
+
+		it("fails when tests fail", () => {
+			const request: EvaluationRequest = {
+				jobId: "job-1",
+				task: defaultTask,
+				worktreePath: "/tmp/worktree",
+				outputs: defaultOutputs,
+				testResults: [
+					{
+						id: "test-1",
+						testFile: "test.spec.ts",
+						status: "failed",
+						errorMessage: "Assertion failed: expected 2 to equal 3",
+					},
+				],
+				policyFindings: defaultPolicyFindings,
+			};
+
+			const result = engine.evaluate(request);
+
+			expect(result.status).toBe("failed");
+			expect(result.findings.some((f) => f.message.includes("failed"))).toBe(
+				true,
+			);
+		});
+
+		it("returns needs_review for ambiguous criteria", () => {
+			const request: EvaluationRequest = {
+				jobId: "job-1",
+				task: {
+					...defaultTask,
+					acceptanceCriteria: ["Do something good", "Make it work well"],
+				},
+				worktreePath: "/tmp/worktree",
+				outputs: [
+					{
+						id: "out-1",
+						type: "file",
+						path: "output.txt",
+						description: "Some output",
+					},
+				],
+				testResults: [
+					{
+						id: "test-1",
+						testFile: "test.spec.ts",
+						status: "passed",
+					},
+				],
+				policyFindings: defaultPolicyFindings,
+			};
+
+			const result = engine.evaluate(request);
+
+			// Should pass or needs_review depending on coverage
+			expect(["passed", "needs_review"]).toContain(result.status);
+		});
+
+		it("includes evidence in result", () => {
+			const request: EvaluationRequest = {
+				jobId: "job-1",
+				task: defaultTask,
+				worktreePath: "/tmp/worktree",
+				outputs: defaultOutputs,
+				testResults: defaultTestResults,
+				policyFindings: defaultPolicyFindings,
+			};
+
+			const result = engine.evaluate(request);
+
+			expect(result.evidence).toBeDefined();
+			expect(Array.isArray(result.evidence)).toBe(true);
+		});
+
+		it("maps acceptance criteria to evidence", () => {
+			const request: EvaluationRequest = {
+				jobId: "job-1",
+				task: {
+					...defaultTask,
+					acceptanceCriteria: ["Output file exists"],
+				},
+				worktreePath: "/tmp/worktree",
+				outputs: defaultOutputs,
+				testResults: defaultTestResults,
+				policyFindings: defaultPolicyFindings,
+			};
+
+			const result = engine.evaluate(request);
+
+			const acceptanceFinding = result.findings.find(
+				(f) => f.dimension === "acceptance_coverage",
+			);
+
+			// Should either pass or have unmet criteria finding
+			expect(result.status).toBe("passed");
+		});
+	});
+
+	describe("state management", () => {
+		it("starts in pending state", () => {
+			const freshEngine = createEvaluationEngine();
+			expect(freshEngine.getState()).toBe("pending");
+		});
+
+		it("transitions through states during evaluation", () => {
+			const request: EvaluationRequest = {
+				jobId: "job-1",
+				task: defaultTask,
+				worktreePath: "/tmp/worktree",
+				outputs: defaultOutputs,
+				testResults: defaultTestResults,
+				policyFindings: defaultPolicyFindings,
+			};
+
+			engine.evaluate(request);
+
+			expect(["passed", "failed", "needs_review"]).toContain(engine.getState());
+		});
+
+		it("resets state correctly", () => {
+			const request: EvaluationRequest = {
+				jobId: "job-1",
+				task: defaultTask,
+				worktreePath: "/tmp/worktree",
+				outputs: defaultOutputs,
+				testResults: defaultTestResults,
+				policyFindings: defaultPolicyFindings,
+			};
+
+			engine.evaluate(request);
+			engine.reset();
+
+			expect(engine.getState()).toBe("pending");
+		});
+	});
+
+	describe("scoring", () => {
+		it("returns score between 0 and 100", () => {
+			const request: EvaluationRequest = {
+				jobId: "job-1",
+				task: defaultTask,
+				worktreePath: "/tmp/worktree",
+				outputs: defaultOutputs,
+				testResults: defaultTestResults,
+				policyFindings: defaultPolicyFindings,
+			};
+
+			const result = engine.evaluate(request);
+
+			expect(result.score).toBeGreaterThanOrEqual(0);
+			expect(result.score).toBeLessThanOrEqual(100);
+		});
+
+		it("penalizes for missing tests", () => {
+			const request: EvaluationRequest = {
+				jobId: "job-1",
+				task: defaultTask,
+				worktreePath: "/tmp/worktree",
+				outputs: defaultOutputs,
+				testResults: [], // No tests
+				policyFindings: defaultPolicyFindings,
+			};
+
+			const result = engine.evaluate(request);
+
+			// Missing tests should lower score
+			expect(
+				result.findings.some((f) => f.message.includes("No test results")),
+			).toBe(true);
+		});
+	});
+});

package/packages/evaluation-engine/tsconfig.json

@@ -0,0 +1,8 @@
+{
+  "extends": "../../tsconfig.base.json",
+  "compilerOptions": {
+    "outDir": "./dist",
+    "rootDir": "./src"
+  },
+  "include": ["src/**/*"]
+}

package/packages/experience-replay/dist/index.d.ts

@@ -0,0 +1,8 @@
+/**
+ * Experience Replay (RFC-0059)
+ *
+ * Re-exports all public types and classes.
+ */
+export { ExperienceReplay, createExperienceReplay } from "./replay.js";
+export type { ReplayRequest, ReplayResult, ReplayEvent, ReplayDivergence, JobStateSnapshot, ReplaySources, DivergenceCheck, DivergenceReason, ReplayRuntimeEvent, ReplayMode, } from "./types.js";
+//# sourceMappingURL=index.d.ts.map

package/packages/experience-replay/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,EAAE,gBAAgB,EAAE,sBAAsB,EAAE,MAAM,aAAa,CAAC;AACvE,YAAY,EACX,aAAa,EACb,YAAY,EACZ,WAAW,EACX,gBAAgB,EAChB,gBAAgB,EAChB,aAAa,EACb,eAAe,EACf,gBAAgB,EAChB,kBAAkB,EAClB,UAAU,GACV,MAAM,YAAY,CAAC"}

package/packages/experience-replay/dist/index.js

@@ -0,0 +1,7 @@
+/**
+ * Experience Replay (RFC-0059)
+ *
+ * Re-exports all public types and classes.
+ */
+export { ExperienceReplay, createExperienceReplay } from "./replay.js";
+//# sourceMappingURL=index.js.map

package/packages/experience-replay/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,EAAE,gBAAgB,EAAE,sBAAsB,EAAE,MAAM,aAAa,CAAC"}

package/packages/experience-replay/dist/replay.d.ts

@@ -0,0 +1,20 @@
+/**
+ * Experience Replay (RFC-0059)
+ *
+ * Reconstructs prior runtime execution from persisted events and checkpoints.
+ */
+import type { ReplayRequest, ReplayResult, ReplaySources, ReplayRuntimeEvent } from "./types.js";
+export declare class ExperienceReplay {
+    private eventListeners;
+    /**
+     * Replay a prior job execution
+     */
+    replay(request: ReplayRequest, sources: ReplaySources): Promise<ReplayResult>;
+    /**
+     * Subscribe to replay events
+     */
+    onEvent(listener: (event: ReplayRuntimeEvent) => void): () => void;
+    private emit;
+}
+export declare function createExperienceReplay(): ExperienceReplay;
+//# sourceMappingURL=replay.d.ts.map

package/packages/experience-replay/dist/replay.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"replay.d.ts","sourceRoot":"","sources":["../src/replay.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,KAAK,EACX,aAAa,EACb,YAAY,EAIZ,aAAa,EAEb,kBAAkB,EAIlB,MAAM,YAAY,CAAC;AAgLpB,qBAAa,gBAAgB;IAC5B,OAAO,CAAC,cAAc,CAAkD;IAExE;;OAEG;IACG,MAAM,CACX,OAAO,EAAE,aAAa,EACtB,OAAO,EAAE,aAAa,GACpB,OAAO,CAAC,YAAY,CAAC;IAuHxB;;OAEG;IACH,OAAO,CAAC,QAAQ,EAAE,CAAC,KAAK,EAAE,kBAAkB,KAAK,IAAI,GAAG,MAAM,IAAI;IAOlE,OAAO,CAAC,IAAI;CASZ;AAID,wBAAgB,sBAAsB,IAAI,gBAAgB,CAEzD"}

package/packages/experience-replay/dist/replay.js

@@ -0,0 +1,229 @@
+/**
+ * Experience Replay (RFC-0059)
+ *
+ * Reconstructs prior runtime execution from persisted events and checkpoints.
+ */
+// ─── Event Timeline Reconstruction ───────────────────────────────────────────
+function reconstructTimeline(events, startSequence = 0) {
+    return events.map((event, index) => ({
+        sequence: startSequence + index,
+        timestamp: event.ts,
+        type: event.type,
+        data: event.data || {},
+    }));
+}
+// ─── State Reconstruction ─────────────────────────────────────────────────────
+function reconstructState(jobId, checkpoint, events, taskGraph) {
+    // Apply events to checkpoint to get final state
+    let currentTaskId = checkpoint?.currentTaskId;
+    let status = checkpoint?.status || "unknown";
+    // Process events to find latest state
+    for (const event of events) {
+        if (event.type === "task.started" && event.data?.taskId) {
+            currentTaskId = event.data.taskId;
+        }
+        if (event.type === "job.status") {
+            status = event.data?.status || status;
+        }
+    }
+    return {
+        jobId,
+        status,
+        currentTaskId,
+        checkpoint: checkpoint || {
+            version: 0,
+            jobId,
+            status: "unknown",
+            requirement: "",
+            createdAt: new Date().toISOString(),
+            updatedAt: new Date().toISOString(),
+        },
+        taskGraph: taskGraph || { nodes: [], edges: [] },
+        events,
+        timestamp: new Date().toISOString(),
+    };
+}
+// ─── Divergence Detection ────────────────────────────────────────────────────
+// ─── Source Validation ────────────────────────────────────────────────────────
+function validateSources(sources) {
+    const missing = [];
+    if (!sources.checkpoint && !sources.events) {
+        missing.push("checkpoint or events");
+    }
+    return { valid: missing.length === 0, missing };
+}
+// ─── Mode Handlers ────────────────────────────────────────────────────────────
+async function handleInspect(sources, jobId, fromSequence, toSequence) {
+    const events = sources.events || [];
+    const filteredEvents = fromSequence !== undefined || toSequence !== undefined
+        ? events.slice(fromSequence, toSequence)
+        : events;
+    const timeline = reconstructTimeline(filteredEvents, fromSequence ?? 0);
+    const state = reconstructState(jobId, sources.checkpoint, filteredEvents, sources.taskGraph);
+    return { state, timeline };
+}
+async function handleSimulate(sources, jobId, fromSequence, toSequence) {
+    const events = sources.events || [];
+    const filteredEvents = fromSequence !== undefined || toSequence !== undefined
+        ? events.slice(fromSequence, toSequence)
+        : events;
+    const timeline = reconstructTimeline(filteredEvents, fromSequence ?? 0);
+    const state = reconstructState(jobId, sources.checkpoint, filteredEvents, sources.taskGraph);
+    // Check for divergent events
+    const divergences = [];
+    for (let i = 0; i < timeline.length; i++) {
+        const event = timeline[i];
+        if (event.type.includes("error") || event.type.includes("failure")) {
+            divergences.push({
+                sequence: event.sequence,
+                reason: "Provider output differs",
+                severity: "warning",
+            });
+        }
+    }
+    return { state, timeline, divergences };
+}
+async function handleReexecute(sources, jobId, allowExternalCalls) {
+    // Reexecute requires explicit approval and valid sources
+    const validation = validateSources(sources);
+    if (!validation.valid) {
+        throw new Error(`Missing required sources: ${validation.missing.join(", ")}`);
+    }
+    if (!allowExternalCalls) {
+        throw new Error("Reexecution with external calls requires explicit approval");
+    }
+    // For reexecution, we simulate first then mark for actual reexecution
+    const result = await handleSimulate(sources, jobId);
+    // Add informational divergence for reexecution mode
+    result.divergences.push({
+        sequence: 0,
+        reason: "Runtime version differs",
+        severity: "info",
+    });
+    return result;
+}
+// ─── Main Engine ───────────────────────────────────────────────────────────────
+export class ExperienceReplay {
+    eventListeners = [];
+    /**
+     * Replay a prior job execution
+     */
+    async replay(request, sources) {
+        const { jobId, mode } = request;
+        // Emit start event
+        this.emit({ type: "replay.started", jobId, mode });
+        // Validate sources
+        const validation = validateSources(sources);
+        if (!validation.valid) {
+            return {
+                jobId,
+                reconstructedState: {
+                    jobId,
+                    status: "error",
+                    checkpoint: sources.checkpoint || {},
+                    taskGraph: sources.taskGraph || { nodes: [], edges: [] },
+                    events: [],
+                    timestamp: new Date().toISOString(),
+                },
+                timeline: [],
+                divergences: [
+                    {
+                        sequence: 0,
+                        reason: `Missing sources: ${validation.missing.join(", ")}`,
+                        severity: "error",
+                    },
+                ],
+                artifacts: [],
+                replayedAt: new Date().toISOString(),
+            };
+        }
+        try {
+            let result;
+            switch (mode) {
+                case "inspect":
+                    result = await handleInspect(sources, jobId, request.fromSequence, request.toSequence);
+                    break;
+                case "simulate":
+                    result = await handleSimulate(sources, jobId, request.fromSequence, request.toSequence);
+                    break;
+                case "reexecute":
+                    result = await handleReexecute(sources, jobId, request.allowExternalCalls);
+                    break;
+            }
+            // Emit divergence events
+            if (result.divergences) {
+                for (const div of result.divergences) {
+                    this.emit({
+                        type: "replay.divergence.detected",
+                        jobId,
+                        reason: div.reason,
+                    });
+                }
+            }
+            // Collect artifacts
+            const artifacts = [];
+            if (sources.prompts)
+                artifacts.push(...Object.keys(sources.prompts));
+            if (sources.outputs)
+                artifacts.push(...Object.keys(sources.outputs));
+            // Emit completion event
+            this.emit({ type: "replay.completed", jobId });
+            return {
+                jobId,
+                reconstructedState: result.state,
+                timeline: result.timeline,
+                divergences: result.divergences || [],
+                artifacts,
+                replayedAt: new Date().toISOString(),
+            };
+        }
+        catch (error) {
+            const errorMessage = error instanceof Error ? error.message : String(error);
+            return {
+                jobId,
+                reconstructedState: {
+                    jobId,
+                    status: "error",
+                    checkpoint: sources.checkpoint || {},
+                    taskGraph: sources.taskGraph || { nodes: [], edges: [] },
+                    events: [],
+                    timestamp: new Date().toISOString(),
+                },
+                timeline: [],
+                divergences: [
+                    {
+                        sequence: 0,
+                        reason: errorMessage,
+                        severity: "error",
+                    },
+                ],
+                artifacts: [],
+                replayedAt: new Date().toISOString(),
+            };
+        }
+    }
+    /**
+     * Subscribe to replay events
+     */
+    onEvent(listener) {
+        this.eventListeners.push(listener);
+        return () => {
+            this.eventListeners = this.eventListeners.filter((l) => l !== listener);
+        };
+    }
+    emit(event) {
+        for (const listener of this.eventListeners) {
+            try {
+                listener(event);
+            }
+            catch {
+                // Best effort
+            }
+        }
+    }
+}
+// ─── Factory ─────────────────────────────────────────────────────────────────
+export function createExperienceReplay() {
+    return new ExperienceReplay();
+}
+//# sourceMappingURL=replay.js.map

package/packages/experience-replay/dist/replay.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"replay.js","sourceRoot":"","sources":["../src/replay.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAgBH,gFAAgF;AAEhF,SAAS,mBAAmB,CAC3B,MAAsB,EACtB,aAAa,GAAG,CAAC;IAEjB,OAAO,MAAM,CAAC,GAAG,CAAC,CAAC,KAAK,EAAE,KAAK,EAAE,EAAE,CAAC,CAAC;QACpC,QAAQ,EAAE,aAAa,GAAG,KAAK;QAC/B,SAAS,EAAE,KAAK,CAAC,EAAE;QACnB,IAAI,EAAE,KAAK,CAAC,IAAI;QAChB,IAAI,EAAE,KAAK,CAAC,IAAI,IAAI,EAAE;KACtB,CAAC,CAAC,CAAC;AACL,CAAC;AAED,iFAAiF;AAEjF,SAAS,gBAAgB,CACxB,KAAa,EACb,UAAyC,EACzC,MAAsB,EACtB,SAAgC;IAEhC,gDAAgD;IAChD,IAAI,aAAa,GAAG,UAAU,EAAE,aAAa,CAAC;IAC9C,IAAI,MAAM,GAAG,UAAU,EAAE,MAAM,IAAI,SAAS,CAAC;IAE7C,sCAAsC;IACtC,KAAK,MAAM,KAAK,IAAI,MAAM,EAAE,CAAC;QAC5B,IAAI,KAAK,CAAC,IAAI,KAAK,cAAc,IAAI,KAAK,CAAC,IAAI,EAAE,MAAM,EAAE,CAAC;YACzD,aAAa,GAAG,KAAK,CAAC,IAAI,CAAC,MAAgB,CAAC;QAC7C,CAAC;QACD,IAAI,KAAK,CAAC,IAAI,KAAK,YAAY,EAAE,CAAC;YACjC,MAAM,GAAI,KAAK,CAAC,IAAI,EAAE,MAAiB,IAAI,MAAM,CAAC;QACnD,CAAC;IACF,CAAC;IAED,OAAO;QACN,KAAK;QACL,MAAM;QACN,aAAa;QACb,UAAU,EAAE,UAAU,IAAI;YACzB,OAAO,EAAE,CAAC;YACV,KAAK;YACL,MAAM,EAAE,SAAS;YACjB,WAAW,EAAE,EAAE;YACf,SAAS,EAAE,IAAI,IAAI,EAAE,CAAC,WAAW,EAAE;YACnC,SAAS,EAAE,IAAI,IAAI,EAAE,CAAC,WAAW,EAAE;SACnC;QACD,SAAS,EAAE,SAAS,IAAI,EAAE,KAAK,EAAE,EAAE,EAAE,KAAK,EAAE,EAAE,EAAE;QAChD,MAAM;QACN,SAAS,EAAE,IAAI,IAAI,EAAE,CAAC,WAAW,EAAE;KACnC,CAAC;AACH,CAAC;AAED,gFAAgF;AAEhF,iFAAiF;AAEjF,SAAS,eAAe,CAAC,OAAsB;IAI9C,MAAM,OAAO,GAAa,EAAE,CAAC;IAE7B,IAAI,CAAC,OAAO,CAAC,UAAU,IAAI,CAAC,OAAO,CAAC,MAAM,EAAE,CAAC;QAC5C,OAAO,CAAC,IAAI,CAAC,sBAAsB,CAAC,CAAC;IACtC,CAAC;IAED,OAAO,EAAE,KAAK,EAAE,OAAO,CAAC,MAAM,KAAK,CAAC,EAAE,OAAO,EAAE,CAAC;AACjD,CAAC;AAED,iFAAiF;AAEjF,KAAK,UAAU,aAAa,CAC3B,OAAsB,EACtB,KAAa,EACb,YAAqB,EACrB,UAAmB;IAEnB,MAAM,MAAM,GAAG,OAAO,CAAC,MAAM,IAAI,EAAE,CAAC;IACpC,MAAM,cAAc,GACnB,YAAY,KAAK,SAAS,IAAI,UAAU,KAAK,SAAS;QACrD,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,YAAY,EAAE,UAAU,CAAC;QACxC,CAAC,CAAC,MAAM,CAAC;IAEX,MAAM,QAAQ,GAAG,mBAAmB,CAAC,cAAc,EAAE,YAAY,IAAI,CAAC,CAAC,CAAC;IACxE,MAAM,KAAK,GAAG,gBAAgB,CAC7B,KAAK,EACL,OAAO,CAAC,UAAU,EAClB,cAAc,EACd,OAAO,CAAC,SAAS,CACjB,CAAC;IAEF,OAAO,EAAE,KAAK,EAAE,QAAQ,EAAE,CAAC;AAC5B,CAAC;AAED,KAAK,UAAU,cAAc,CAC5B,OAAsB,EACtB,KAAa,EACb,YAAqB,EACrB,UAAmB;IAMnB,MAAM,MAAM,GAAG,OAAO,CAAC,MAAM,IAAI,EAAE,CAAC;IACpC,MAAM,cAAc,GACnB,YAAY,KAAK,SAAS,IAAI,UAAU,KAAK,SAAS;QACrD,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,YAAY,EAAE,UAAU,CAAC;QACxC,CAAC,CAAC,MAAM,CAAC;IAEX,MAAM,QAAQ,GAAG,mBAAmB,CAAC,cAAc,EAAE,YAAY,IAAI,CAAC,CAAC,CAAC;IACxE,MAAM,KAAK,GAAG,gBAAgB,CAC7B,KAAK,EACL,OAAO,CAAC,UAAU,EAClB,cAAc,EACd,OAAO,CAAC,SAAS,CACjB,CAAC;IAEF,6BAA6B;IAC7B,MAAM,WAAW,GAAuB,EAAE,CAAC;IAC3C,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,QAAQ,CAAC,MAAM,EAAE,CAAC,EAAE,EAAE,CAAC;QAC1C,MAAM,KAAK,GAAG,QAAQ,CAAC,CAAC,CAAC,CAAC;QAC1B,IAAI,KAAK,CAAC,IAAI,CAAC,QAAQ,CAAC,OAAO,CAAC,IAAI,KAAK,CAAC,IAAI,CAAC,QAAQ,CAAC,SAAS,CAAC,EAAE,CAAC;YACpE,WAAW,CAAC,IAAI,CAAC;gBAChB,QAAQ,EAAE,KAAK,CAAC,QAAQ;gBACxB,MAAM,EAAE,yBAA6C;gBACrD,QAAQ,EAAE,SAAS;aACnB,CAAC,CAAC;QACJ,CAAC;IACF,CAAC;IAED,OAAO,EAAE,KAAK,EAAE,QAAQ,EAAE,WAAW,EAAE,CAAC;AACzC,CAAC;AAED,KAAK,UAAU,eAAe,CAC7B,OAAsB,EACtB,KAAa,EACb,kBAA2B;IAM3B,yDAAyD;IACzD,MAAM,UAAU,GAAG,eAAe,CAAC,OAAO,CAAC,CAAC;IAC5C,IAAI,CAAC,UAAU,CAAC,KAAK,EAAE,CAAC;QACvB,MAAM,IAAI,KAAK,CACd,6BAA6B,UAAU,CAAC,OAAO,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,CAC5D,CAAC;IACH,CAAC;IAED,IAAI,CAAC,kBAAkB,EAAE,CAAC;QACzB,MAAM,IAAI,KAAK,CACd,4DAA4D,CAC5D,CAAC;IACH,CAAC;IAED,sEAAsE;IACtE,MAAM,MAAM,GAAG,MAAM,cAAc,CAAC,OAAO,EAAE,KAAK,CAAC,CAAC;IAEpD,oDAAoD;IACpD,MAAM,CAAC,WAAW,CAAC,IAAI,CAAC;QACvB,QAAQ,EAAE,CAAC;QACX,MAAM,EAAE,yBAA6C;QACrD,QAAQ,EAAE,MAAM;KAChB,CAAC,CAAC;IAEH,OAAO,MAAM,CAAC;AACf,CAAC;AAED,kFAAkF;AAElF,MAAM,OAAO,gBAAgB;IACpB,cAAc,GAA+C,EAAE,CAAC;IAExE;;OAEG;IACH,KAAK,CAAC,MAAM,CACX,OAAsB,EACtB,OAAsB;QAEtB,MAAM,EAAE,KAAK,EAAE,IAAI,EAAE,GAAG,OAAO,CAAC;QAEhC,mBAAmB;QACnB,IAAI,CAAC,IAAI,CAAC,EAAE,IAAI,EAAE,gBAAgB,EAAE,KAAK,EAAE,IAAI,EAAE,CAAC,CAAC;QAEnD,mBAAmB;QACnB,MAAM,UAAU,GAAG,eAAe,CAAC,OAAO,CAAC,CAAC;QAC5C,IAAI,CAAC,UAAU,CAAC,KAAK,EAAE,CAAC;YACvB,OAAO;gBACN,KAAK;gBACL,kBAAkB,EAAE;oBACnB,KAAK;oBACL,MAAM,EAAE,OAAO;oBACf,UAAU,EAAE,OAAO,CAAC,UAAU,IAAK,EAAwB;oBAC3D,SAAS,EAAE,OAAO,CAAC,SAAS,IAAI,EAAE,KAAK,EAAE,EAAE,EAAE,KAAK,EAAE,EAAE,EAAE;oBACxD,MAAM,EAAE,EAAE;oBACV,SAAS,EAAE,IAAI,IAAI,EAAE,CAAC,WAAW,EAAE;iBACnC;gBACD,QAAQ,EAAE,EAAE;gBACZ,WAAW,EAAE;oBACZ;wBACC,QAAQ,EAAE,CAAC;wBACX,MAAM,EAAE,oBAAoB,UAAU,CAAC,OAAO,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE;wBAC3D,QAAQ,EAAE,OAAO;qBACjB;iBACD;gBACD,SAAS,EAAE,EAAE;gBACb,UAAU,EAAE,IAAI,IAAI,EAAE,CAAC,WAAW,EAAE;aACpC,CAAC;QACH,CAAC;QAED,IAAI,CAAC;YACJ,IAAI,MAIH,CAAC;YAEF,QAAQ,IAAI,EAAE,CAAC;gBACd,KAAK,SAAS;oBACb,MAAM,GAAG,MAAM,aAAa,CAC3B,OAAO,EACP,KAAK,EACL,OAAO,CAAC,YAAY,EACpB,OAAO,CAAC,UAAU,CAClB,CAAC;oBACF,MAAM;gBACP,KAAK,UAAU;oBACd,MAAM,GAAG,MAAM,cAAc,CAC5B,OAAO,EACP,KAAK,EACL,OAAO,CAAC,YAAY,EACpB,OAAO,CAAC,UAAU,CAClB,CAAC;oBACF,MAAM;gBACP,KAAK,WAAW;oBACf,MAAM,GAAG,MAAM,eAAe,CAC7B,OAAO,EACP,KAAK,EACL,OAAO,CAAC,kBAAkB,CAC1B,CAAC;oBACF,MAAM;YACR,CAAC;YAED,yBAAyB;YACzB,IAAI,MAAM,CAAC,WAAW,EAAE,CAAC;gBACxB,KAAK,MAAM,GAAG,IAAI,MAAM,CAAC,WAAW,EAAE,CAAC;oBACtC,IAAI,CAAC,IAAI,CAAC;wBACT,IAAI,EAAE,4BAA4B;wBAClC,KAAK;wBACL,MAAM,EAAE,GAAG,CAAC,MAAM;qBAClB,CAAC,CAAC;gBACJ,CAAC;YACF,CAAC;YAED,oBAAoB;YACpB,MAAM,SAAS,GAAa,EAAE,CAAC;YAC/B,IAAI,OAAO,CAAC,OAAO;gBAAE,SAAS,CAAC,IAAI,CAAC,GAAG,MAAM,CAAC,IAAI,CAAC,OAAO,CAAC,OAAO,CAAC,CAAC,CAAC;YACrE,IAAI,OAAO,CAAC,OAAO;gBAAE,SAAS,CAAC,IAAI,CAAC,GAAG,MAAM,CAAC,IAAI,CAAC,OAAO,CAAC,OAAO,CAAC,CAAC,CAAC;YAErE,wBAAwB;YACxB,IAAI,CAAC,IAAI,CAAC,EAAE,IAAI,EAAE,kBAAkB,EAAE,KAAK,EAAE,CAAC,CAAC;YAE/C,OAAO;gBACN,KAAK;gBACL,kBAAkB,EAAE,MAAM,CAAC,KAAK;gBAChC,QAAQ,EAAE,MAAM,CAAC,QAAQ;gBACzB,WAAW,EAAE,MAAM,CAAC,WAAW,IAAI,EAAE;gBACrC,SAAS;gBACT,UAAU,EAAE,IAAI,IAAI,EAAE,CAAC,WAAW,EAAE;aACpC,CAAC;QACH,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YAChB,MAAM,YAAY,GACjB,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC;YACxD,OAAO;gBACN,KAAK;gBACL,kBAAkB,EAAE;oBACnB,KAAK;oBACL,MAAM,EAAE,OAAO;oBACf,UAAU,EAAE,OAAO,CAAC,UAAU,IAAK,EAAwB;oBAC3D,SAAS,EAAE,OAAO,CAAC,SAAS,IAAI,EAAE,KAAK,EAAE,EAAE,EAAE,KAAK,EAAE,EAAE,EAAE;oBACxD,MAAM,EAAE,EAAE;oBACV,SAAS,EAAE,IAAI,IAAI,EAAE,CAAC,WAAW,EAAE;iBACnC;gBACD,QAAQ,EAAE,EAAE;gBACZ,WAAW,EAAE;oBACZ;wBACC,QAAQ,EAAE,CAAC;wBACX,MAAM,EAAE,YAAY;wBACpB,QAAQ,EAAE,OAAO;qBACjB;iBACD;gBACD,SAAS,EAAE,EAAE;gBACb,UAAU,EAAE,IAAI,IAAI,EAAE,CAAC,WAAW,EAAE;aACpC,CAAC;QACH,CAAC;IACF,CAAC;IAED;;OAEG;IACH,OAAO,CAAC,QAA6C;QACpD,IAAI,CAAC,cAAc,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAC;QACnC,OAAO,GAAG,EAAE;YACX,IAAI,CAAC,cAAc,GAAG,IAAI,CAAC,cAAc,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,KAAK,QAAQ,CAAC,CAAC;QACzE,CAAC,CAAC;IACH,CAAC;IAEO,IAAI,CAAC,KAAyB;QACrC,KAAK,MAAM,QAAQ,IAAI,IAAI,CAAC,cAAc,EAAE,CAAC;YAC5C,IAAI,CAAC;gBACJ,QAAQ,CAAC,KAAK,CAAC,CAAC;YACjB,CAAC;YAAC,MAAM,CAAC;gBACR,cAAc;YACf,CAAC;QACF,CAAC;IACF,CAAC;CACD;AAED,gFAAgF;AAEhF,MAAM,UAAU,sBAAsB;IACrC,OAAO,IAAI,gBAAgB,EAAE,CAAC;AAC/B,CAAC"}

package/packages/experience-replay/dist/types.d.ts

@@ -0,0 +1,113 @@
+/**
+ * Experience Replay Types (RFC-0059)
+ *
+ * Interfaces for replaying prior runtime execution.
+ */
+export interface RuntimeEvent {
+    ts: string;
+    jobId: string;
+    type: string;
+    message: string;
+    data?: Record<string, unknown>;
+}
+export interface RuntimeCheckpoint {
+    version: number;
+    jobId: string;
+    status: string;
+    requirement: string;
+    currentTaskId?: string;
+    provider?: string;
+    resumeAt?: string;
+    lastError?: string;
+    createdAt: string;
+    updatedAt: string;
+}
+export interface TaskGraphNode {
+    id: string;
+    title: string;
+    description: string;
+    status: string;
+    dependencies: string[];
+}
+export interface TaskGraph {
+    nodes: TaskGraphNode[];
+    edges: Array<{
+        from: string;
+        to: string;
+    }>;
+}
+export type ReplayMode = "inspect" | "simulate" | "reexecute";
+export interface ReplayRequest {
+    jobId: string;
+    mode: ReplayMode;
+    fromSequence?: number;
+    toSequence?: number;
+    allowExternalCalls: boolean;
+}
+export interface JobStateSnapshot {
+    jobId: string;
+    status: string;
+    currentTaskId?: string;
+    checkpoint: RuntimeCheckpoint;
+    taskGraph: TaskGraph;
+    events: RuntimeEvent[];
+    timestamp: string;
+}
+export interface ReplayEvent {
+    sequence: number;
+    timestamp: string;
+    type: string;
+    data: Record<string, unknown>;
+}
+export interface ReplayDivergence {
+    sequence: number;
+    reason: string;
+    expected?: unknown;
+    actual?: unknown;
+    severity: "info" | "warning" | "error";
+}
+export interface ReplayResult {
+    jobId: string;
+    reconstructedState: JobStateSnapshot;
+    timeline: ReplayEvent[];
+    divergences: ReplayDivergence[];
+    artifacts: string[];
+    replayedAt: string;
+}
+export interface ReplaySources {
+    checkpoint?: RuntimeCheckpoint;
+    events?: RuntimeEvent[];
+    taskGraph?: TaskGraph;
+    prompts?: Record<string, string>;
+    outputs?: Record<string, string>;
+    testResults?: Record<string, unknown>;
+    evaluation?: Record<string, unknown>;
+    repairs?: Record<string, unknown>;
+    knowledgeRefs?: string[];
+    /** Filter events by sequence range */
+    fromSequence?: number;
+    toSequence?: number;
+}
+export type DivergenceReason = "source_file_changed" | "project_rules_changed" | "provider_output_differs" | "test_environment_changed" | "required_artifact_missing" | "runtime_version_differs";
+export interface DivergenceCheck {
+    type: DivergenceReason;
+    check: () => Promise<boolean>;
+    severity: "info" | "warning" | "error";
+}
+export type ReplayRuntimeEvent = {
+    type: "replay.started";
+    jobId: string;
+    mode: ReplayMode;
+} | {
+    type: "replay.state.reconstructed";
+    jobId: string;
+    sequence: number;
+} | {
+    type: "replay.divergence.detected";
+    jobId: string;
+    reason: string;
+} | {
+    type: "replay.completed";
+    jobId: string;
+};
+//# sourceMappingURL=types.d.ts.map