pulseed 0.1.5 → 0.2.0

package/dist/execution/__tests__/parallel-executor.test.js

@@ -0,0 +1,313 @@
+import { describe, it, expect, beforeEach, vi } from "vitest";
+import { ParallelExecutor } from "../parallel-executor.js";
+// ─── Helpers ───
+function makeTask(id, overrides = {}) {
+    return {
+        id,
+        goal_id: "goal-1",
+        strategy_id: null,
+        target_dimensions: ["coverage"],
+        primary_dimension: "coverage",
+        work_description: `Do work for ${id}`,
+        rationale: "needed",
+        approach: "direct",
+        success_criteria: [],
+        scope_boundary: { in_scope: [], out_of_scope: [], blast_radius: "low" },
+        constraints: [],
+        plateau_until: null,
+        estimated_duration: null,
+        consecutive_failure_count: 0,
+        reversibility: "unknown",
+        task_category: "normal",
+        status: "pending",
+        started_at: null,
+        completed_at: null,
+        timeout_at: null,
+        heartbeat_at: null,
+        created_at: new Date().toISOString(),
+        ...overrides,
+    };
+}
+function makeGroup(overrides = {}) {
+    return {
+        subtasks: [makeTask("t1"), makeTask("t2")],
+        dependencies: [],
+        file_ownership: {},
+        ...overrides,
+    };
+}
+function makePipelineResult(verdict, output = "ok") {
+    return {
+        pipeline_id: "pipe-1",
+        final_verdict: verdict,
+        stage_results: [
+            {
+                stage_index: 0,
+                role: "implementor",
+                verdict,
+                output,
+                confidence: verdict === "pass" ? 0.9 : 0.2,
+                idempotency_key: "key-0",
+            },
+        ],
+        status: verdict === "fail" ? "failed" : "completed",
+    };
+}
+function makePipelineExecutor(defaultResult = makePipelineResult("pass")) {
+    return {
+        run: vi.fn(async () => defaultResult),
+    };
+}
+// ─── Tests ───
+describe("ParallelExecutor", () => {
+    let pipelineExecutor;
+    let deps;
+    beforeEach(() => {
+        pipelineExecutor = makePipelineExecutor();
+        deps = {
+            pipelineExecutor: pipelineExecutor,
+        };
+    });
+    // ─── 1. Independent subtasks run in parallel ───
+    it("executes independent subtasks in parallel and returns all results", async () => {
+        const group = makeGroup({
+            subtasks: [makeTask("t1"), makeTask("t2"), makeTask("t3")],
+        });
+        const executor = new ParallelExecutor(deps);
+        const result = await executor.execute(group, { goalId: "g1" });
+        expect(result.results).toHaveLength(3);
+        expect(result.overall_verdict).toBe("pass");
+        expect(result.conflicts_detected).toHaveLength(0);
+        // All three tasks ran via pipeline executor
+        expect(pipelineExecutor.run).toHaveBeenCalledTimes(3);
+    });
+    it("calls pipelineExecutor with each subtask's work_description as prompt", async () => {
+        const group = makeGroup({
+            subtasks: [makeTask("t1"), makeTask("t2")],
+        });
+        const executor = new ParallelExecutor(deps);
+        await executor.execute(group, { goalId: "g1" });
+        const calls = pipelineExecutor.run.mock.calls;
+        const prompts = calls.map((c) => c[1].prompt);
+        expect(prompts).toContain("Do work for t1");
+        expect(prompts).toContain("Do work for t2");
+    });
+    // ─── 2. File ownership conflict detection ───
+    it("detects file ownership conflicts and throws", async () => {
+        const group = makeGroup({
+            file_ownership: {
+                "src/foo.ts": ["t1", "t2"],
+            },
+        });
+        const executor = new ParallelExecutor(deps);
+        await expect(executor.execute(group, { goalId: "g1" })).rejects.toThrow(/File ownership conflicts detected/);
+    });
+    it("validateFileOwnership returns conflict descriptions for shared files", () => {
+        const group = makeGroup({
+            file_ownership: {
+                "src/foo.ts": ["t1", "t2"],
+                "src/bar.ts": ["t2", "t3"],
+                "src/ok.ts": ["t1"],
+            },
+        });
+        const executor = new ParallelExecutor(deps);
+        const conflicts = executor.validateFileOwnership(group);
+        expect(conflicts).toHaveLength(2);
+        expect(conflicts[0]).toMatch(/src\/foo\.ts/);
+        expect(conflicts[1]).toMatch(/src\/bar\.ts/);
+    });
+    it("validateFileOwnership returns empty array when no conflicts", () => {
+        const group = makeGroup({
+            file_ownership: {
+                "src/a.ts": ["t1"],
+                "src/b.ts": ["t2"],
+            },
+        });
+        const executor = new ParallelExecutor(deps);
+        const conflicts = executor.validateFileOwnership(group);
+        expect(conflicts).toHaveLength(0);
+    });
+    // ─── 3. Dependency ordering (waves) ───
+    it("respects dependency ordering — t2 runs after t1", async () => {
+        const callOrder = [];
+        pipelineExecutor.run.mockImplementation(async (taskId) => {
+            callOrder.push(taskId);
+            return makePipelineResult("pass");
+        });
+        const group = makeGroup({
+            subtasks: [makeTask("t1"), makeTask("t2")],
+            dependencies: [{ from: "t1", to: "t2" }], // t1 must complete before t2
+        });
+        const executor = new ParallelExecutor(deps);
+        await executor.execute(group, { goalId: "g1" });
+        expect(callOrder.indexOf("t1")).toBeLessThan(callOrder.indexOf("t2"));
+    });
+    it("buildExecutionOrder produces correct waves for chained deps", () => {
+        const group = makeGroup({
+            subtasks: [makeTask("t1"), makeTask("t2"), makeTask("t3")],
+            dependencies: [
+                { from: "t1", to: "t2" },
+                { from: "t2", to: "t3" },
+            ],
+        });
+        const executor = new ParallelExecutor(deps);
+        const waves = executor.buildExecutionOrder(group);
+        expect(waves).toHaveLength(3);
+        expect(waves[0]).toEqual(["t1"]);
+        expect(waves[1]).toEqual(["t2"]);
+        expect(waves[2]).toEqual(["t3"]);
+    });
+    it("buildExecutionOrder groups independent tasks into same wave", () => {
+        const group = makeGroup({
+            subtasks: [makeTask("t1"), makeTask("t2"), makeTask("t3")],
+            dependencies: [],
+        });
+        const executor = new ParallelExecutor(deps);
+        const waves = executor.buildExecutionOrder(group);
+        expect(waves).toHaveLength(1);
+        expect(waves[0].sort()).toEqual(["t1", "t2", "t3"].sort());
+    });
+    // ─── 4. Subtask failure handling ───
+    it("continues executing other tasks when one fails (no fail_fast at group level)", async () => {
+        let callCount = 0;
+        pipelineExecutor.run.mockImplementation(async (taskId) => {
+            callCount++;
+            if (taskId === "t1")
+                return makePipelineResult("fail", "t1 failed");
+            return makePipelineResult("pass", "t2 ok");
+        });
+        const group = makeGroup({
+            subtasks: [makeTask("t1"), makeTask("t2")],
+            dependencies: [],
+        });
+        const executor = new ParallelExecutor(deps);
+        const result = await executor.execute(group, { goalId: "g1" });
+        // Both tasks ran
+        expect(callCount).toBe(2);
+        expect(result.results).toHaveLength(2);
+        const t1Result = result.results.find((r) => r.task_id === "t1");
+        const t2Result = result.results.find((r) => r.task_id === "t2");
+        expect(t1Result?.verdict).toBe("fail");
+        expect(t2Result?.verdict).toBe("pass");
+    });
+    it("returns verdict=fail when subtask throws an error", async () => {
+        pipelineExecutor.run.mockRejectedValueOnce(new Error("adapter crashed"));
+        const group = makeGroup({
+            subtasks: [makeTask("t1")],
+        });
+        const executor = new ParallelExecutor(deps);
+        const result = await executor.execute(group, { goalId: "g1" });
+        expect(result.results[0].verdict).toBe("fail");
+        expect(result.results[0].error).toContain("adapter crashed");
+    });
+    // ─── 5. overall_verdict aggregation ───
+    it("returns overall_verdict=pass when all subtasks pass", async () => {
+        pipelineExecutor.run.mockResolvedValue(makePipelineResult("pass"));
+        const group = makeGroup({
+            subtasks: [makeTask("t1"), makeTask("t2"), makeTask("t3")],
+        });
+        const executor = new ParallelExecutor(deps);
+        const result = await executor.execute(group, { goalId: "g1" });
+        expect(result.overall_verdict).toBe("pass");
+    });
+    it("returns overall_verdict=fail when all subtasks fail", async () => {
+        pipelineExecutor.run.mockResolvedValue(makePipelineResult("fail"));
+        const group = makeGroup({
+            subtasks: [makeTask("t1"), makeTask("t2")],
+        });
+        const executor = new ParallelExecutor(deps);
+        const result = await executor.execute(group, { goalId: "g1" });
+        expect(result.overall_verdict).toBe("fail");
+    });
+    it("returns overall_verdict=partial when results are mixed (some pass, some fail)", async () => {
+        let call = 0;
+        pipelineExecutor.run.mockImplementation(async () => {
+            call++;
+            return call === 1 ? makePipelineResult("fail") : makePipelineResult("pass");
+        });
+        const group = makeGroup({
+            subtasks: [makeTask("t1"), makeTask("t2")],
+        });
+        const executor = new ParallelExecutor(deps);
+        const result = await executor.execute(group, { goalId: "g1" });
+        expect(result.overall_verdict).toBe("partial");
+    });
+    it("returns overall_verdict=partial when results include partial verdicts only", async () => {
+        pipelineExecutor.run.mockResolvedValue(makePipelineResult("partial"));
+        const group = makeGroup({
+            subtasks: [makeTask("t1"), makeTask("t2")],
+        });
+        const executor = new ParallelExecutor(deps);
+        const result = await executor.execute(group, { goalId: "g1" });
+        // No pass and no fail → all partial → treated as pass (no failures)
+        expect(result.overall_verdict).toBe("pass");
+    });
+    // ─── 6. Concurrency semaphore ───
+    it("respects concurrency limit — never exceeds limit tasks concurrently", async () => {
+        let concurrent = 0;
+        let maxConcurrent = 0;
+        pipelineExecutor.run.mockImplementation(async () => {
+            concurrent++;
+            if (concurrent > maxConcurrent)
+                maxConcurrent = concurrent;
+            // Simulate async work so overlap is possible
+            await new Promise((resolve) => setTimeout(resolve, 10));
+            concurrent--;
+            return makePipelineResult("pass");
+        });
+        const group = makeGroup({
+            subtasks: [makeTask("t1"), makeTask("t2"), makeTask("t3"), makeTask("t4"), makeTask("t5")],
+            dependencies: [],
+        });
+        const executor = new ParallelExecutor({ ...deps, concurrencyLimit: 2 });
+        await executor.execute(group, { goalId: "g1" });
+        expect(maxConcurrent).toBeLessThanOrEqual(2);
+    });
+    it("maintains correct result order when semaphore reorders execution", async () => {
+        const callOrder = [];
+        pipelineExecutor.run.mockImplementation(async (taskId) => {
+            callOrder.push(taskId);
+            await new Promise((resolve) => setTimeout(resolve, 5));
+            return makePipelineResult("pass", `output-${taskId}`);
+        });
+        const group = makeGroup({
+            subtasks: [makeTask("t1"), makeTask("t2"), makeTask("t3"), makeTask("t4")],
+            dependencies: [],
+        });
+        const executor = new ParallelExecutor({ ...deps, concurrencyLimit: 2 });
+        const result = await executor.execute(group, { goalId: "g1" });
+        // All tasks ran
+        expect(result.results).toHaveLength(4);
+        // Results contain all task IDs (order depends on wave, but all present)
+        const taskIds = result.results.map((r) => r.task_id);
+        expect(taskIds).toContain("t1");
+        expect(taskIds).toContain("t2");
+        expect(taskIds).toContain("t3");
+        expect(taskIds).toContain("t4");
+    });
+    it("uses default concurrency limit of 3 when not specified", async () => {
+        let concurrent = 0;
+        let maxConcurrent = 0;
+        pipelineExecutor.run.mockImplementation(async () => {
+            concurrent++;
+            if (concurrent > maxConcurrent)
+                maxConcurrent = concurrent;
+            await new Promise((resolve) => setTimeout(resolve, 10));
+            concurrent--;
+            return makePipelineResult("pass");
+        });
+        // 6 tasks, no deps — all in one wave; default limit=3 caps concurrency
+        const group = makeGroup({
+            subtasks: [
+                makeTask("t1"), makeTask("t2"), makeTask("t3"),
+                makeTask("t4"), makeTask("t5"), makeTask("t6"),
+            ],
+            dependencies: [],
+        });
+        // No concurrencyLimit provided — uses default of 3
+        const executor = new ParallelExecutor(deps);
+        await executor.execute(group, { goalId: "g1" });
+        expect(maxConcurrent).toBeLessThanOrEqual(3);
+    });
+});
+//# sourceMappingURL=parallel-executor.test.js.map

package/dist/execution/__tests__/parallel-executor.test.js.map

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

package/dist/execution/__tests__/pipeline-executor.test.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=pipeline-executor.test.d.ts.map

package/dist/execution/__tests__/pipeline-executor.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"pipeline-executor.test.d.ts","sourceRoot":"","sources":["../../../src/execution/__tests__/pipeline-executor.test.ts"],"names":[],"mappings":""}

package/dist/execution/__tests__/pipeline-executor.test.js

@@ -0,0 +1,322 @@
+import { describe, it, expect, beforeEach, vi } from "vitest";
+import { PipelineExecutor } from "../pipeline-executor.js";
+import { AdapterRegistry } from "../adapter-layer.js";
+// ─── Helpers ───
+function makeAgentTask(overrides = {}) {
+    return {
+        prompt: "Implement the feature",
+        timeout_ms: 30000,
+        adapter_type: "mock",
+        ...overrides,
+    };
+}
+function makeAdapter(type, resultOverrides = {}) {
+    return {
+        adapterType: type,
+        execute: vi.fn(async (_task) => ({
+            success: true,
+            output: `output from ${type}`,
+            error: null,
+            exit_code: 0,
+            elapsed_ms: 100,
+            stopped_reason: "completed",
+            ...resultOverrides,
+        })),
+    };
+}
+function makeStateManager() {
+    return {
+        readRaw: vi.fn(async (_path) => null),
+        writeRaw: vi.fn(async (_path, _data) => undefined),
+    };
+}
+function makePipeline(overrides = {}) {
+    return {
+        stages: [
+            { role: "implementor" },
+            { role: "verifier" },
+            { role: "reviewer" },
+        ],
+        fail_fast: true,
+        ...overrides,
+    };
+}
+// ─── Tests ───
+describe("PipelineExecutor", () => {
+    let registry;
+    let stateManager;
+    let adapter;
+    let deps;
+    beforeEach(() => {
+        registry = new AdapterRegistry();
+        stateManager = makeStateManager();
+        adapter = makeAdapter("mock");
+        registry.register(adapter);
+        deps = {
+            stateManager: stateManager,
+            adapterRegistry: registry,
+        };
+    });
+    // ─── 1. Normal sequential execution ───
+    it("executes 3-stage pipeline and returns status=completed", async () => {
+        const executor = new PipelineExecutor(deps);
+        const result = await executor.run("task-1", makeAgentTask(), makePipeline());
+        expect(result.status).toBe("completed");
+        expect(result.stage_results).toHaveLength(3);
+        expect(result.final_verdict).toBe("pass");
+        expect(result.stage_results[0].role).toBe("implementor");
+        expect(result.stage_results[1].role).toBe("verifier");
+        expect(result.stage_results[2].role).toBe("reviewer");
+    });
+    it("sets all stage verdicts to pass when adapter succeeds", async () => {
+        const executor = new PipelineExecutor(deps);
+        const result = await executor.run("task-1", makeAgentTask(), makePipeline());
+        for (const stage of result.stage_results) {
+            expect(stage.verdict).toBe("pass");
+        }
+    });
+    // ─── 2. Idempotency skip ───
+    it("skips stage 0 when its idempotency_key is already in completed_stages", async () => {
+        const preCompleted = {
+            pipeline_id: "existing-pipeline",
+            task_id: "task-2",
+            current_stage_index: 1,
+            completed_stages: [
+                {
+                    stage_index: 0,
+                    role: "implementor",
+                    verdict: "pass",
+                    output: "pre-existing output",
+                    confidence: 0.9,
+                    idempotency_key: "task-2:0:0",
+                },
+            ],
+            status: "interrupted",
+            started_at: new Date().toISOString(),
+            updated_at: new Date().toISOString(),
+        };
+        stateManager.readRaw.mockResolvedValueOnce(preCompleted);
+        const pipeline = {
+            stages: [{ role: "implementor" }, { role: "verifier" }],
+            fail_fast: true,
+        };
+        const executor = new PipelineExecutor(deps);
+        const result = await executor.run("task-2", makeAgentTask(), pipeline);
+        // Stage 0 was skipped, only stage 1 ran via adapter
+        expect(adapter.execute).toHaveBeenCalledTimes(1);
+        // Both stages appear in results (pre-existing + new)
+        expect(result.stage_results).toHaveLength(2);
+        expect(result.stage_results[0].idempotency_key).toBe("task-2:0:0");
+        expect(result.status).toBe("completed");
+    });
+    // ─── 3. Fail-fast interruption ───
+    it("stops pipeline after first failure when fail_fast=true", async () => {
+        const failAdapter = makeAdapter("fail-adapter", {
+            success: false,
+            stopped_reason: "completed", // completed but not successful → partial/fail
+        });
+        // Make adapter return error on second stage
+        const executeMock = vi.fn()
+            .mockResolvedValueOnce({
+            success: true,
+            output: "stage 0 ok",
+            error: null,
+            exit_code: 0,
+            elapsed_ms: 50,
+            stopped_reason: "completed",
+        })
+            .mockResolvedValueOnce({
+            success: false,
+            output: "stage 1 failed",
+            error: "test failure",
+            exit_code: 1,
+            elapsed_ms: 50,
+            stopped_reason: "error",
+        });
+        const mockAdapter = {
+            adapterType: "mock",
+            execute: executeMock,
+        };
+        const reg = new AdapterRegistry();
+        reg.register(mockAdapter);
+        const localDeps = {
+            stateManager: stateManager,
+            adapterRegistry: reg,
+        };
+        const pipeline = {
+            stages: [{ role: "implementor" }, { role: "verifier" }, { role: "reviewer" }],
+            fail_fast: true,
+        };
+        const executor = new PipelineExecutor(localDeps);
+        const result = await executor.run("task-3", makeAgentTask(), pipeline);
+        expect(result.status).toBe("failed");
+        // Only 2 stages ran (0 passed, 1 failed and triggered fail_fast)
+        expect(result.stage_results).toHaveLength(2);
+        expect(result.final_verdict).toBe("fail");
+        expect(executeMock).toHaveBeenCalledTimes(2);
+    });
+    // ─── 4. State persistence ───
+    it("calls writeRaw after each stage completion", async () => {
+        const executor = new PipelineExecutor(deps);
+        await executor.run("task-4", makeAgentTask(), makePipeline());
+        // writeRaw called at: init + after stage 0 + after stage 1 + after stage 2 + final = 5
+        expect(stateManager.writeRaw).toHaveBeenCalledWith("pipelines/task-4.json", expect.objectContaining({ task_id: "task-4" }));
+        // At minimum 4 calls: init + 3 stages
+        expect(stateManager.writeRaw.mock.calls.length).toBeGreaterThanOrEqual(4);
+    });
+    it("persists pipeline_id consistently across writes", async () => {
+        const executor = new PipelineExecutor(deps);
+        await executor.run("task-4b", makeAgentTask(), makePipeline());
+        const calls = stateManager.writeRaw.mock.calls;
+        const pipelineIds = calls.map((c) => c[1].pipeline_id);
+        const unique = new Set(pipelineIds);
+        expect(unique.size).toBe(1); // same pipeline_id throughout
+    });
+    // ─── 5. State restoration ───
+    it("resumes from interrupted state at correct stage", async () => {
+        const interruptedState = {
+            pipeline_id: "resume-pipeline",
+            task_id: "task-5",
+            current_stage_index: 2,
+            completed_stages: [
+                {
+                    stage_index: 0,
+                    role: "implementor",
+                    verdict: "pass",
+                    output: "done",
+                    confidence: 0.8,
+                    idempotency_key: "task-5:0:0",
+                },
+                {
+                    stage_index: 1,
+                    role: "verifier",
+                    verdict: "pass",
+                    output: "verified",
+                    confidence: 0.8,
+                    idempotency_key: "task-5:1:0",
+                },
+            ],
+            status: "interrupted",
+            started_at: new Date().toISOString(),
+            updated_at: new Date().toISOString(),
+        };
+        stateManager.readRaw.mockResolvedValueOnce(interruptedState);
+        const pipeline = {
+            stages: [
+                { role: "implementor" },
+                { role: "verifier" },
+                { role: "reviewer" },
+            ],
+            fail_fast: true,
+        };
+        const executor = new PipelineExecutor(deps);
+        const result = await executor.run("task-5", makeAgentTask(), pipeline);
+        // Only stage 2 (reviewer) should have executed via adapter
+        expect(adapter.execute).toHaveBeenCalledTimes(1);
+        expect(result.stage_results).toHaveLength(3);
+        expect(result.status).toBe("completed");
+    });
+    // ─── 6. Role-based context ───
+    it("includes observation context for implementor but not for reviewer", async () => {
+        const capturedPrompts = [];
+        const capturingAdapter = {
+            adapterType: "mock",
+            execute: vi.fn(async (t) => {
+                capturedPrompts.push(t.prompt);
+                return {
+                    success: true,
+                    output: "ok",
+                    error: null,
+                    exit_code: 0,
+                    elapsed_ms: 10,
+                    stopped_reason: "completed",
+                };
+            }),
+        };
+        const reg = new AdapterRegistry();
+        reg.register(capturingAdapter);
+        const localDeps = {
+            stateManager: stateManager,
+            adapterRegistry: reg,
+        };
+        const pipeline = {
+            stages: [{ role: "implementor" }, { role: "reviewer" }],
+            fail_fast: true,
+        };
+        const executor = new PipelineExecutor(localDeps);
+        await executor.run("task-6", makeAgentTask({ prompt: "Base task" }), pipeline, "Observation: 42 tests passing");
+        // implementor prompt should include observation context
+        expect(capturedPrompts[0]).toContain("Observation: 42 tests passing");
+        // reviewer prompt should NOT include observation context
+        expect(capturedPrompts[1]).not.toContain("Observation: 42 tests passing");
+    });
+    it("includes observation context for researcher but not for verifier", async () => {
+        const capturedPrompts = [];
+        const capturingAdapter = {
+            adapterType: "mock",
+            execute: vi.fn(async (t) => {
+                capturedPrompts.push(t.prompt);
+                return {
+                    success: true,
+                    output: "ok",
+                    error: null,
+                    exit_code: 0,
+                    elapsed_ms: 10,
+                    stopped_reason: "completed",
+                };
+            }),
+        };
+        const reg = new AdapterRegistry();
+        reg.register(capturingAdapter);
+        const localDeps = {
+            stateManager: stateManager,
+            adapterRegistry: reg,
+        };
+        const pipeline = {
+            stages: [{ role: "researcher" }, { role: "verifier" }],
+            fail_fast: true,
+        };
+        const executor = new PipelineExecutor(localDeps);
+        await executor.run("task-6b", makeAgentTask({ prompt: "Research this" }), pipeline, "Current state: branch main");
+        expect(capturedPrompts[0]).toContain("Current state: branch main");
+        expect(capturedPrompts[1]).not.toContain("Current state: branch main");
+    });
+    // ─── 7. Prompt override ───
+    it("prepends prompt_override to stage instructions", async () => {
+        const capturedPrompts = [];
+        const capturingAdapter = {
+            adapterType: "mock",
+            execute: vi.fn(async (t) => {
+                capturedPrompts.push(t.prompt);
+                return {
+                    success: true,
+                    output: "ok",
+                    error: null,
+                    exit_code: 0,
+                    elapsed_ms: 10,
+                    stopped_reason: "completed",
+                };
+            }),
+        };
+        const reg = new AdapterRegistry();
+        reg.register(capturingAdapter);
+        const localDeps = {
+            stateManager: stateManager,
+            adapterRegistry: reg,
+        };
+        const pipeline = {
+            stages: [
+                {
+                    role: "implementor",
+                    prompt_override: "IMPORTANT: Follow TDD approach.",
+                },
+            ],
+            fail_fast: true,
+        };
+        const executor = new PipelineExecutor(localDeps);
+        await executor.run("task-7", makeAgentTask({ prompt: "Write the module" }), pipeline);
+        expect(capturedPrompts[0]).toMatch(/^IMPORTANT: Follow TDD approach\./);
+        expect(capturedPrompts[0]).toContain("Write the module");
+    });
+});
+//# sourceMappingURL=pipeline-executor.test.js.map