@copilot-swarm/core 0.0.0

package/dist/pipeline-config.js

@@ -0,0 +1,230 @@
+import * as fs from "node:fs";
+import * as path from "node:path";
+import { parse as parseYaml } from "yaml";
+const VALID_PHASES = new Set(["spec", "decompose", "design", "implement", "cross-model-review"]);
+const CONFIG_FILE_NAME = "swarm.config.yaml";
+function fail(msg) {
+    throw new Error(`Pipeline config error: ${msg}`);
+}
+function requireString(obj, key, context) {
+    const val = obj[key];
+    if (typeof val !== "string" || val === "") {
+        fail(`"${key}" must be a non-empty string in ${context}`);
+    }
+    return val;
+}
+function requirePositiveInt(obj, key, context) {
+    const val = obj[key];
+    if (typeof val !== "number" || !Number.isInteger(val) || val <= 0) {
+        fail(`"${key}" must be a positive integer in ${context}`);
+    }
+    return val;
+}
+function optionalString(obj, key) {
+    const val = obj[key];
+    if (val === undefined || val === null)
+        return undefined;
+    if (typeof val !== "string")
+        fail(`"${key}" must be a string if provided`);
+    return val;
+}
+function validateReviewStep(raw, context) {
+    if (typeof raw !== "object" || raw === null)
+        fail(`review step must be an object in ${context}`);
+    const obj = raw;
+    return {
+        agent: requireString(obj, "agent", context),
+        maxIterations: requirePositiveInt(obj, "maxIterations", context),
+        approvalKeyword: requireString(obj, "approvalKeyword", context),
+        clarificationKeyword: optionalString(obj, "clarificationKeyword"),
+        clarificationAgent: optionalString(obj, "clarificationAgent"),
+    };
+}
+function validateReviews(raw, context) {
+    if (!Array.isArray(raw))
+        fail(`"reviews" must be an array in ${context}`);
+    return raw.map((item, i) => validateReviewStep(item, `${context}.reviews[${i}]`));
+}
+function validateQa(raw, context) {
+    if (typeof raw !== "object" || raw === null)
+        fail(`"qa" must be an object in ${context}`);
+    const obj = raw;
+    return {
+        agent: requireString(obj, "agent", context),
+        maxIterations: requirePositiveInt(obj, "maxIterations", context),
+        approvalKeyword: requireString(obj, "approvalKeyword", context),
+    };
+}
+function validatePhase(raw, index) {
+    if (typeof raw !== "object" || raw === null)
+        fail(`pipeline[${index}] must be an object`);
+    const obj = raw;
+    const phase = requireString(obj, "phase", `pipeline[${index}]`);
+    if (!VALID_PHASES.has(phase)) {
+        fail(`Unknown phase type "${phase}" in pipeline[${index}]. Valid: ${[...VALID_PHASES].join(", ")}`);
+    }
+    const ctx = `pipeline[${index}] (phase: ${phase})`;
+    switch (phase) {
+        case "spec": {
+            return {
+                phase: "spec",
+                agent: requireString(obj, "agent", ctx),
+                reviews: validateReviews(obj.reviews, ctx),
+            };
+        }
+        case "decompose": {
+            return {
+                phase: "decompose",
+                agent: requireString(obj, "agent", ctx),
+                frontendMarker: requireString(obj, "frontendMarker", ctx),
+            };
+        }
+        case "design": {
+            return {
+                phase: "design",
+                condition: optionalString(obj, "condition"),
+                agent: requireString(obj, "agent", ctx),
+                clarificationAgent: optionalString(obj, "clarificationAgent"),
+                reviews: validateReviews(obj.reviews, ctx),
+            };
+        }
+        case "implement": {
+            const parallel = obj.parallel;
+            if (typeof parallel !== "boolean")
+                fail(`"parallel" must be a boolean in ${ctx}`);
+            return {
+                phase: "implement",
+                parallel,
+                agent: requireString(obj, "agent", ctx),
+                reviews: validateReviews(obj.reviews, ctx),
+                qa: obj.qa !== undefined ? validateQa(obj.qa, ctx) : undefined,
+            };
+        }
+        case "cross-model-review": {
+            return {
+                phase: "cross-model-review",
+                condition: optionalString(obj, "condition"),
+                agent: requireString(obj, "agent", ctx),
+                fixAgent: requireString(obj, "fixAgent", ctx),
+                maxIterations: requirePositiveInt(obj, "maxIterations", ctx),
+                approvalKeyword: requireString(obj, "approvalKeyword", ctx),
+            };
+        }
+        default:
+            fail(`Unhandled phase type "${phase}"`);
+    }
+}
+function validateAgents(raw) {
+    if (typeof raw !== "object" || raw === null || Array.isArray(raw)) {
+        fail('"agents" must be an object mapping agent names to instruction sources');
+    }
+    const result = {};
+    for (const [key, value] of Object.entries(raw)) {
+        if (typeof value !== "string" || value === "") {
+            fail(`Agent "${key}" must have a non-empty string source (e.g. "builtin:pm" or a file path)`);
+        }
+        result[key] = value;
+    }
+    return result;
+}
+function validatePipeline(raw) {
+    if (!Array.isArray(raw) || raw.length === 0) {
+        fail('"pipeline" must be a non-empty array of phase definitions');
+    }
+    return raw.map((item, i) => validatePhase(item, i));
+}
+/** Cross-validate that every agent referenced in the pipeline is defined in agents. */
+function validateAgentReferences(config) {
+    const defined = new Set(Object.keys(config.agents));
+    function check(agentName, context) {
+        if (!defined.has(agentName)) {
+            fail(`Agent "${agentName}" referenced in ${context} is not defined in "agents"`);
+        }
+    }
+    for (const phase of config.pipeline) {
+        const ctx = `phase "${phase.phase}"`;
+        switch (phase.phase) {
+            case "spec":
+                check(phase.agent, ctx);
+                for (const r of phase.reviews)
+                    check(r.agent, `${ctx} review`);
+                break;
+            case "decompose":
+                check(phase.agent, ctx);
+                break;
+            case "design":
+                check(phase.agent, ctx);
+                if (phase.clarificationAgent)
+                    check(phase.clarificationAgent, ctx);
+                for (const r of phase.reviews) {
+                    check(r.agent, `${ctx} review`);
+                    if (r.clarificationAgent)
+                        check(r.clarificationAgent, `${ctx} review clarification`);
+                }
+                break;
+            case "implement":
+                check(phase.agent, ctx);
+                for (const r of phase.reviews)
+                    check(r.agent, `${ctx} review`);
+                if (phase.qa)
+                    check(phase.qa.agent, `${ctx} qa`);
+                break;
+            case "cross-model-review":
+                check(phase.agent, ctx);
+                check(phase.fixAgent, `${ctx} fixAgent`);
+                break;
+        }
+    }
+}
+export function parsePipelineConfig(raw) {
+    if (typeof raw !== "object" || raw === null) {
+        fail("Config must be a YAML object");
+    }
+    const obj = raw;
+    const config = {
+        primaryModel: typeof obj.primaryModel === "string" ? obj.primaryModel : "claude-opus-4-6-fast",
+        reviewModel: typeof obj.reviewModel === "string" ? obj.reviewModel : "gpt-5.2-codex",
+        agents: validateAgents(obj.agents),
+        pipeline: validatePipeline(obj.pipeline),
+    };
+    validateAgentReferences(config);
+    return config;
+}
+/**
+ * Load pipeline config from the repo root, falling back to the built-in default.
+ * Env vars PRIMARY_MODEL and REVIEW_MODEL override the YAML values.
+ */
+export function loadPipelineConfig(repoRoot) {
+    const repoConfigPath = path.join(repoRoot, CONFIG_FILE_NAME);
+    const defaultConfigPath = path.join(import.meta.dirname, "..", "defaults", CONFIG_FILE_NAME);
+    let yamlContent;
+    let source;
+    if (fs.existsSync(repoConfigPath)) {
+        yamlContent = fs.readFileSync(repoConfigPath, "utf-8");
+        source = repoConfigPath;
+    }
+    else if (fs.existsSync(defaultConfigPath)) {
+        yamlContent = fs.readFileSync(defaultConfigPath, "utf-8");
+        source = defaultConfigPath;
+    }
+    else {
+        fail(`No ${CONFIG_FILE_NAME} found in repo root or package defaults`);
+    }
+    let parsed;
+    try {
+        parsed = parseYaml(yamlContent);
+    }
+    catch (err) {
+        fail(`Failed to parse ${source}: ${err instanceof Error ? err.message : String(err)}`);
+    }
+    const config = parsePipelineConfig(parsed);
+    // Env var overrides for models
+    const envPrimary = process.env.PRIMARY_MODEL;
+    const envReview = process.env.REVIEW_MODEL;
+    return {
+        ...config,
+        primaryModel: envPrimary && envPrimary !== "" ? envPrimary : config.primaryModel,
+        reviewModel: envReview && envReview !== "" ? envReview : config.reviewModel,
+    };
+}
+//# sourceMappingURL=pipeline-config.js.map

package/dist/pipeline-config.js.map

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

package/dist/pipeline-config.test.d.ts

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

package/dist/pipeline-config.test.d.ts.map

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

package/dist/pipeline-config.test.js

@@ -0,0 +1,132 @@
+import { describe, expect, it } from "vitest";
+import { parsePipelineConfig } from "./pipeline-config.js";
+const validAgents = {
+    pm: "builtin:pm",
+    reviewer: "builtin:pm-reviewer",
+    engineer: "builtin:engineer",
+    "code-reviewer": "builtin:eng-code-reviewer",
+    tester: "builtin:tester",
+    cross: "builtin:cross-model-reviewer",
+};
+function makeConfig(overrides = {}) {
+    return {
+        primaryModel: "test-model",
+        reviewModel: "test-review",
+        agents: validAgents,
+        pipeline: [
+            {
+                phase: "spec",
+                agent: "pm",
+                reviews: [{ agent: "reviewer", maxIterations: 2, approvalKeyword: "APPROVED" }],
+            },
+            { phase: "decompose", agent: "pm", frontendMarker: "[FRONTEND]" },
+            {
+                phase: "implement",
+                parallel: true,
+                agent: "engineer",
+                reviews: [{ agent: "code-reviewer", maxIterations: 3, approvalKeyword: "APPROVED" }],
+                qa: { agent: "tester", maxIterations: 5, approvalKeyword: "ALL_PASSED" },
+            },
+        ],
+        ...overrides,
+    };
+}
+describe("parsePipelineConfig", () => {
+    it("parses a valid config", () => {
+        const config = parsePipelineConfig(makeConfig());
+        expect(config.primaryModel).toBe("test-model");
+        expect(config.reviewModel).toBe("test-review");
+        expect(config.pipeline).toHaveLength(3);
+        expect(config.pipeline[0].phase).toBe("spec");
+    });
+    it("defaults models when not provided", () => {
+        const raw = makeConfig();
+        delete raw.primaryModel;
+        delete raw.reviewModel;
+        const config = parsePipelineConfig(raw);
+        expect(config.primaryModel).toBe("claude-opus-4-6-fast");
+        expect(config.reviewModel).toBe("gpt-5.2-codex");
+    });
+    it("rejects missing agents map", () => {
+        expect(() => parsePipelineConfig(makeConfig({ agents: null }))).toThrow("agents");
+    });
+    it("rejects empty pipeline", () => {
+        expect(() => parsePipelineConfig(makeConfig({ pipeline: [] }))).toThrow("non-empty array");
+    });
+    it("rejects unknown phase type", () => {
+        expect(() => parsePipelineConfig(makeConfig({ pipeline: [{ phase: "unknown", agent: "pm" }] }))).toThrow("Unknown phase type");
+    });
+    it("rejects agent reference not defined in agents map", () => {
+        expect(() => parsePipelineConfig(makeConfig({
+            pipeline: [
+                {
+                    phase: "spec",
+                    agent: "nonexistent",
+                    reviews: [],
+                },
+            ],
+        }))).toThrow('Agent "nonexistent"');
+    });
+    it("rejects review step with missing maxIterations", () => {
+        expect(() => parsePipelineConfig(makeConfig({
+            pipeline: [
+                {
+                    phase: "spec",
+                    agent: "pm",
+                    reviews: [{ agent: "reviewer", approvalKeyword: "APPROVED" }],
+                },
+            ],
+        }))).toThrow("maxIterations");
+    });
+    it("rejects non-boolean parallel in implement phase", () => {
+        expect(() => parsePipelineConfig(makeConfig({
+            pipeline: [
+                {
+                    phase: "implement",
+                    parallel: "yes",
+                    agent: "engineer",
+                    reviews: [],
+                },
+            ],
+        }))).toThrow("parallel");
+    });
+    it("validates cross-model-review phase", () => {
+        const config = parsePipelineConfig(makeConfig({
+            pipeline: [
+                {
+                    phase: "cross-model-review",
+                    agent: "cross",
+                    fixAgent: "engineer",
+                    maxIterations: 3,
+                    approvalKeyword: "APPROVED",
+                },
+            ],
+        }));
+        expect(config.pipeline[0].phase).toBe("cross-model-review");
+    });
+    it("validates design phase with condition", () => {
+        const agents = { ...validAgents, designer: "builtin:designer", "design-reviewer": "builtin:design-reviewer" };
+        const config = parsePipelineConfig({
+            agents,
+            pipeline: [
+                {
+                    phase: "design",
+                    condition: "hasFrontendTasks",
+                    agent: "designer",
+                    clarificationAgent: "pm",
+                    reviews: [{ agent: "design-reviewer", maxIterations: 3, approvalKeyword: "APPROVED" }],
+                },
+            ],
+        });
+        const phase = config.pipeline[0];
+        expect(phase.phase).toBe("design");
+        if (phase.phase === "design") {
+            expect(phase.condition).toBe("hasFrontendTasks");
+        }
+    });
+    it("rejects non-object input", () => {
+        expect(() => parsePipelineConfig("not an object")).toThrow("YAML object");
+        expect(() => parsePipelineConfig(null)).toThrow("YAML object");
+    });
+});
+//# sourceMappingURL=pipeline-config.test.js.map

package/dist/pipeline-config.test.js.map

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

package/dist/pipeline-engine.d.ts

@@ -0,0 +1,20 @@
+import type { SwarmConfig } from "./config.js";
+import type { Logger } from "./logger.js";
+import type { PipelineConfig } from "./pipeline-types.js";
+export declare class PipelineEngine {
+    private readonly config;
+    private readonly pipeline;
+    private readonly logger;
+    private readonly sessions;
+    constructor(config: SwarmConfig, pipeline: PipelineConfig, logger: Logger);
+    start(): Promise<void>;
+    stop(): Promise<void>;
+    execute(): Promise<void>;
+    private executeSpec;
+    private executeDecompose;
+    private executeDesign;
+    private executeImplement;
+    private executeCrossModelReview;
+    private runReviewLoop;
+}
+//# sourceMappingURL=pipeline-engine.d.ts.map

package/dist/pipeline-engine.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"pipeline-engine.d.ts","sourceRoot":"","sources":["../src/pipeline-engine.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,aAAa,CAAC;AAC/C,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,aAAa,CAAC;AAE1C,OAAO,KAAK,EAKV,cAAc,EAGf,MAAM,qBAAqB,CAAC;AAY7B,qBAAa,cAAc;IAIvB,OAAO,CAAC,QAAQ,CAAC,MAAM;IACvB,OAAO,CAAC,QAAQ,CAAC,QAAQ;IACzB,OAAO,CAAC,QAAQ,CAAC,MAAM;IALzB,OAAO,CAAC,QAAQ,CAAC,QAAQ,CAAiB;gBAGvB,MAAM,EAAE,WAAW,EACnB,QAAQ,EAAE,cAAc,EACxB,MAAM,EAAE,MAAM;IAK3B,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC;IAItB,IAAI,IAAI,OAAO,CAAC,IAAI,CAAC;IAIrB,OAAO,IAAI,OAAO,CAAC,IAAI,CAAC;YAsChB,WAAW;YAiBX,gBAAgB;YAoBhB,aAAa;YAmEb,gBAAgB;YAqEhB,uBAAuB;YAgDvB,aAAa;CAwB5B"}

package/dist/pipeline-engine.js

@@ -0,0 +1,230 @@
+import * as fs from "node:fs/promises";
+import * as path from "node:path";
+import { msg } from "./messages.js";
+import { SessionManager } from "./session.js";
+import { hasFrontendWork, isFrontendTask, parseJsonArray, responseContains, writeRoleSummary } from "./utils.js";
+export class PipelineEngine {
+    config;
+    pipeline;
+    logger;
+    sessions;
+    constructor(config, pipeline, logger) {
+        this.config = config;
+        this.pipeline = pipeline;
+        this.logger = logger;
+        this.sessions = new SessionManager(config, pipeline, logger);
+    }
+    async start() {
+        await this.sessions.start();
+    }
+    async stop() {
+        await this.sessions.stop();
+    }
+    async execute() {
+        this.logger.info(msg.configLoaded(this.pipeline.primaryModel, this.pipeline.reviewModel, this.config.verbose));
+        const ctx = { spec: "", tasks: [], designSpec: "", streamResults: [] };
+        for (const phase of this.pipeline.pipeline) {
+            switch (phase.phase) {
+                case "spec":
+                    ctx.spec = await this.executeSpec(phase);
+                    break;
+                case "decompose":
+                    ctx.tasks = await this.executeDecompose(phase, ctx);
+                    break;
+                case "design":
+                    ctx.designSpec = await this.executeDesign(phase, ctx);
+                    break;
+                case "implement":
+                    ctx.streamResults = await this.executeImplement(phase, ctx);
+                    break;
+                case "cross-model-review":
+                    ctx.streamResults = await this.executeCrossModelReview(phase, ctx);
+                    break;
+            }
+        }
+        // Final summary
+        this.logger.info(msg.swarmComplete);
+        const timestamp = new Date().toISOString();
+        const summary = `# Swarm Run Summary\n\n**Timestamp:** ${timestamp}\n**Tasks:** ${ctx.tasks.length}\n\n` +
+            `${ctx.streamResults.map((r, i) => `## Stream ${i + 1}\n\n${r}`).join("\n\n---\n\n")}\n`;
+        const docPath = path.join(this.config.repoRoot, this.config.docDir);
+        await fs.mkdir(docPath, { recursive: true });
+        await fs.writeFile(path.join(docPath, this.config.summaryFileName), summary);
+    }
+    // --- SPEC PHASE ---
+    async executeSpec(phase) {
+        this.logger.info(msg.pmPhaseStart);
+        this.logger.info(msg.pmDrafting);
+        let spec = await this.sessions.callIsolated(phase.agent, this.config.issueBody);
+        for (const review of phase.reviews) {
+            this.logger.info(msg.reviewPhase(review.agent));
+            spec = await this.runReviewLoop(review, spec, phase.agent, (content) => `Review this specification:\n${content}`);
+        }
+        await writeRoleSummary(this.config, phase.agent, `## Final Specification\n\n${spec}`);
+        return spec;
+    }
+    // --- DECOMPOSE PHASE ---
+    async executeDecompose(phase, ctx) {
+        this.logger.info(msg.taskDecomposition);
+        const marker = phase.frontendMarker;
+        const prompt = `Break this spec into 2-3 independent JSON tasks. Mark frontend tasks with ${marker}. ` +
+            `Respond with ONLY a JSON array, no other text. Format: ["${marker} Task 1", "Task 2"]\nSpec:\n${ctx.spec}`;
+        const raw = await this.sessions.callIsolated(phase.agent, prompt);
+        const tasks = parseJsonArray(raw);
+        this.logger.info(msg.tasksResult(tasks));
+        await writeRoleSummary(this.config, `${phase.agent}-tasks`, `## Decomposed Tasks\n\n${tasks.map((t, i) => `${i + 1}. ${t}`).join("\n")}`);
+        return tasks;
+    }
+    // --- DESIGN PHASE ---
+    async executeDesign(phase, ctx) {
+        if (phase.condition === "hasFrontendTasks" && !hasFrontendWork(ctx.tasks)) {
+            return ctx.designSpec;
+        }
+        this.logger.info(msg.designPhaseStart);
+        const session = await this.sessions.createAgentSession(phase.agent);
+        try {
+            this.logger.info(msg.designPhase);
+            let design = await this.sessions.send(session, `Create a detailed UI/UX design specification based on this spec:\n${ctx.spec}\n\n` +
+                `Include: component hierarchy, layout, interactions, states, and accessibility considerations.`);
+            if (phase.clarificationAgent && responseContains(design, "CLARIFICATION_NEEDED")) {
+                this.logger.info(msg.designerClarification);
+                const clarification = await this.sessions.callIsolated(phase.clarificationAgent, `The designer needs clarification:\n${design}`);
+                design = await this.sessions.send(session, `PM Clarification:\n${clarification}\n\nRevise the design.`);
+            }
+            for (const review of phase.reviews) {
+                this.logger.info(msg.reviewPhase(review.agent));
+                const maxIter = review.maxIterations;
+                for (let i = 1; i <= maxIter; i++) {
+                    this.logger.info(msg.reviewIteration(i, maxIter));
+                    const feedback = await this.sessions.callIsolated(review.agent, `Review this design specification:\n${design}`);
+                    if (responseContains(feedback, review.approvalKeyword)) {
+                        this.logger.info(msg.approved(review.agent));
+                        break;
+                    }
+                    if (review.clarificationKeyword && responseContains(feedback, review.clarificationKeyword)) {
+                        const clarAgent = review.clarificationAgent ?? phase.clarificationAgent;
+                        if (clarAgent) {
+                            this.logger.info(msg.reviewerClarification);
+                            const clar = await this.sessions.callIsolated(clarAgent, `The design reviewer needs clarification:\n${feedback}`);
+                            design = await this.sessions.send(session, `Review feedback:\n${feedback}\n\nPM Clarification:\n${clar}\n\nRevise the design.`);
+                        }
+                    }
+                    else {
+                        this.logger.info(msg.codeFeedback(feedback.substring(0, 80)));
+                        design = await this.sessions.send(session, `Review feedback:\n${feedback}\n\nRevise the design.`);
+                    }
+                }
+            }
+            await writeRoleSummary(this.config, phase.agent, design);
+            return design;
+        }
+        finally {
+            await session.destroy();
+        }
+    }
+    // --- IMPLEMENT PHASE ---
+    async executeImplement(phase, ctx) {
+        this.logger.info(msg.launchingStreams(ctx.tasks.length));
+        const runStream = async (task, idx) => {
+            const label = msg.streamLabel(idx);
+            this.logger.info(msg.streamStart(label, task));
+            const session = await this.sessions.createAgentSession(phase.agent);
+            try {
+                this.logger.info(msg.streamEngineering(label));
+                const engineeringPrompt = isFrontendTask(task)
+                    ? `Spec:\n${ctx.spec}\n\nDesign:\n${ctx.designSpec}\n\nTask:\n${task}\n\nImplement this task.`
+                    : `Spec:\n${ctx.spec}\n\nTask:\n${task}\n\nImplement this task.`;
+                let code = await this.sessions.send(session, engineeringPrompt);
+                // Reviews
+                for (const review of phase.reviews) {
+                    this.logger.info(msg.streamCodeReview(label, review.agent));
+                    const maxIter = review.maxIterations;
+                    for (let i = 1; i <= maxIter; i++) {
+                        this.logger.info(msg.reviewIteration(i, maxIter));
+                        const feedback = await this.sessions.callIsolated(review.agent, `Review this implementation:\n${code}`);
+                        if (responseContains(feedback, review.approvalKeyword)) {
+                            this.logger.info(msg.codeApproved);
+                            break;
+                        }
+                        this.logger.info(msg.codeFeedback(feedback.substring(0, 80)));
+                        code = await this.sessions.send(session, `Code review feedback:\n${feedback}\n\nFix all issues.`);
+                    }
+                }
+                // QA
+                if (phase.qa) {
+                    this.logger.info(msg.streamQa(label));
+                    const maxQa = phase.qa.maxIterations;
+                    for (let i = 1; i <= maxQa; i++) {
+                        this.logger.info(msg.qaIteration(i, maxQa));
+                        const testReport = await this.sessions.callIsolated(phase.qa.agent, `Spec:\n${ctx.spec}\n\nImplementation:\n${code}\n\nValidate the implementation against the spec.`);
+                        if (responseContains(testReport, phase.qa.approvalKeyword)) {
+                            this.logger.info(msg.allTestsPassed);
+                            break;
+                        }
+                        this.logger.info(msg.defectsFound);
+                        code = await this.sessions.send(session, `QA Report:\n${testReport}\n\nFix all reported issues.`);
+                    }
+                }
+                await writeRoleSummary(this.config, `engineer-stream-${idx + 1}`, code);
+                return code;
+            }
+            finally {
+                await session.destroy();
+            }
+        };
+        if (phase.parallel) {
+            return Promise.all(ctx.tasks.map((task, idx) => runStream(task, idx)));
+        }
+        const results = [];
+        for (let i = 0; i < ctx.tasks.length; i++) {
+            results.push(await runStream(ctx.tasks[i], i));
+        }
+        return results;
+    }
+    // --- CROSS-MODEL REVIEW ---
+    async executeCrossModelReview(phase, ctx) {
+        if (phase.condition === "differentReviewModel" && this.pipeline.reviewModel === this.pipeline.primaryModel) {
+            this.logger.info(msg.crossModelSkipped);
+            return ctx.streamResults;
+        }
+        this.logger.info(msg.crossModelStart(this.pipeline.reviewModel));
+        const maxIter = phase.maxIterations;
+        const reviewed = await Promise.all(ctx.streamResults.map(async (code, idx) => {
+            const label = msg.streamLabel(idx);
+            this.logger.info(msg.crossModelStreamReview(label));
+            let current = code;
+            for (let i = 1; i <= maxIter; i++) {
+                this.logger.info(msg.crossModelIteration(i, maxIter, this.pipeline.reviewModel));
+                const feedback = await this.sessions.callIsolated(phase.agent, `Spec:\n${ctx.spec}\n\nReview this implementation from scratch. ` +
+                    `You are using a different model than the one that wrote this code — look for blind spots.\n\n` +
+                    `Implementation:\n${current}`, this.pipeline.reviewModel);
+                if (responseContains(feedback, phase.approvalKeyword)) {
+                    this.logger.info(msg.crossModelApproved);
+                    break;
+                }
+                this.logger.info(msg.crossModelIssues);
+                current = await this.sessions.callIsolated(phase.fixAgent, `Cross-model review feedback:\n${feedback}\n\nOriginal implementation:\n${current}\n\nFix all reported issues.`);
+            }
+            return current;
+        }));
+        await writeRoleSummary(this.config, "cross-model-review", reviewed.map((r, i) => `## Stream ${i + 1}\n\n${r}`).join("\n\n---\n\n"));
+        return reviewed;
+    }
+    // --- GENERIC REVIEW LOOP ---
+    async runReviewLoop(review, content, authorAgent, buildPrompt) {
+        const maxIter = review.maxIterations;
+        let current = content;
+        for (let i = 1; i <= maxIter; i++) {
+            this.logger.info(msg.reviewIteration(i, maxIter));
+            const feedback = await this.sessions.callIsolated(review.agent, buildPrompt(current));
+            if (responseContains(feedback, review.approvalKeyword)) {
+                this.logger.info(msg.approved(review.agent));
+                break;
+            }
+            this.logger.info(msg.feedbackReceived(feedback.substring(0, 80)));
+            current = await this.sessions.callIsolated(authorAgent, `Previous content:\n${current}\n\nReview feedback:\n${feedback}\n\nRevise accordingly.`);
+        }
+        return current;
+    }
+}
+//# sourceMappingURL=pipeline-engine.js.map