import { describe, expect, test } from "bun:test"; import { END, type RoleStep, START, type ThreadContext, validateWorkflowDescriptor, } from "@uncaged/workflow"; import type { PlannerMeta } from "@uncaged/workflow-role-planner"; import { buildSolveIssueDescriptor } from "../src/descriptor.js"; import { createSolveIssueRun, plannerRole, solveIssueModerator } from "../src/index.js"; import type { SolveIssueMeta } from "../src/roles.js"; const DEFAULT_PHASES: PlannerMeta["phases"] = [ { name: "phase-a", description: "Do the work", acceptance: "Done" }, ]; function makeStart(maxRounds: number): ThreadContext["start"] { return { role: START, content: "Fix the flaky login test", meta: { maxRounds }, timestamp: 0, }; } function makeCtx( maxRounds: number, steps: ThreadContext["steps"], ): ThreadContext { return { threadId: "01TEST000000000000000000TR", currentRole: { name: START, systemPrompt: "" }, start: makeStart(maxRounds), steps, }; } function plannerStep(phases: PlannerMeta["phases"] = DEFAULT_PHASES): RoleStep { return { role: "planner", content: "plan", meta: { phases }, timestamp: 1, }; } function coderStep(completedPhase = "phase-a"): RoleStep { return { role: "coder", content: "code", meta: { completedPhase, filesChanged: ["a.ts"], summary: "fixed" }, timestamp: 2, }; } function reviewerStep(approved: boolean): RoleStep { return { role: "reviewer", content: "rev", meta: approved ? { status: "approved" as const } : { status: "rejected" as const, issues: ["needs fix"] }, timestamp: 3, }; } function committerStep(): RoleStep { return { role: "committer", content: "commit", meta: { status: "committed", branch: "feat/issue-1", commitSha: "abc1234" }, timestamp: 4, }; } const stubExtract = { provider: { baseUrl: "http://127.0.0.1:9", apiKey: "", model: "test" }, dryRun: true, } as const; describe("solveIssueModerator", () => { test("routes planner → coder → reviewer → committer → END", () => { expect(solveIssueModerator(makeCtx(20, []))).toBe("planner"); expect(solveIssueModerator(makeCtx(20, [plannerStep()]))).toBe("coder"); expect(solveIssueModerator(makeCtx(20, [plannerStep(), coderStep()]))).toBe("reviewer"); expect(solveIssueModerator(makeCtx(20, [plannerStep(), coderStep(), reviewerStep(true)]))).toBe( "committer", ); expect( solveIssueModerator( makeCtx(20, [plannerStep(), coderStep(), reviewerStep(true), committerStep()]), ), ).toBe(END); }); test("reviewer rejects → coder retry when budget allows", () => { const steps: ThreadContext["steps"] = [ plannerStep(), coderStep(), reviewerStep(false), ]; expect(solveIssueModerator(makeCtx(20, steps))).toBe("coder"); }); test("reviewer rejects → END when max rounds exhausted", () => { const steps: ThreadContext["steps"] = [ plannerStep(), coderStep(), reviewerStep(false), ]; expect(solveIssueModerator(makeCtx(4, steps))).toBe(END); }); test("multiple planner phases → coder until all complete, then reviewer", () => { const phases: PlannerMeta["phases"] = [ { name: "p1", description: "first", acceptance: "a1" }, { name: "p2", description: "second", acceptance: "a2" }, ]; expect(solveIssueModerator(makeCtx(20, [plannerStep(phases)]))).toBe("coder"); expect(solveIssueModerator(makeCtx(20, [plannerStep(phases), coderStep("p1")]))).toBe("coder"); expect( solveIssueModerator(makeCtx(20, [plannerStep(phases), coderStep("p1"), coderStep("p2")])), ).toBe("reviewer"); }); test("incomplete phases → END when max rounds exhausted", () => { const phases: PlannerMeta["phases"] = [ { name: "p1", description: "first", acceptance: "a1" }, { name: "p2", description: "second", acceptance: "a2" }, ]; const steps: ThreadContext["steps"] = [plannerStep(phases), coderStep("p1")]; expect(solveIssueModerator(makeCtx(3, steps))).toBe(END); }); }); describe("createSolveIssueRun", () => { test("dry-run extraction yields role dryRunMeta for planner", async () => { const run = createSolveIssueRun({ agent: async () => "" }, stubExtract); const gen = run( { prompt: "task", steps: [] }, { threadId: "01TEST000000000000000000TR", isDryRun: true, maxRounds: 20 }, ); const first = await gen.next(); expect(first.done).toBe(false); if (first.done) { throw new Error("expected yield"); } expect(first.value.role).toBe("planner"); expect(first.value.meta).toEqual(plannerRole.dryRunMeta); }); test("per-role agent overrides default", async () => { const calls: string[] = []; const run = createSolveIssueRun( { agent: async () => { calls.push("default"); return ""; }, overrides: { planner: async () => { calls.push("planner"); return ""; }, coder: async () => { calls.push("coder"); return ""; }, }, }, stubExtract, ); const gen = run( { prompt: "task", steps: [] }, { threadId: "01TEST000000000000000000TR", isDryRun: true, maxRounds: 20 }, ); await gen.next(); expect(calls).toEqual(["planner"]); calls.length = 0; await gen.next(); expect(calls).toEqual(["coder"]); }); }); describe("buildSolveIssueDescriptor", () => { test("lists all roles with schemas that validate", () => { const descriptor = buildSolveIssueDescriptor(); const validated = validateWorkflowDescriptor(descriptor); expect(validated.ok).toBe(true); if (!validated.ok) { throw new Error(validated.error); } expect(Object.keys(validated.value.roles).sort()).toEqual([ "coder", "committer", "planner", "reviewer", ]); for (const key of ["planner", "coder", "reviewer", "committer"] as const) { const role = validated.value.roles[key]; expect(role).toBeDefined(); expect(typeof role.schema).toBe("object"); expect(role.schema).not.toBeNull(); expect(Array.isArray(role.schema)).toBe(false); } }); });