import { mkdirSync, writeFileSync } from "node:fs"; import { join } from "node:path"; import { tmpdir } from "node:os"; import { START } from "@uncaged/workflow-runtime"; import { describe, expect, mock, test } from "bun:test"; import { err, ok } from "@uncaged/workflow-util"; import type { SpawnCliConfig } from "@uncaged/workflow-util-agent"; import { differMetaSchema } from "@local/template-document-editor"; import { createDifferAdapter } from "../adapters/differ-adapter.js"; import type { ThreadContext } from "@uncaged/workflow-runtime"; type MockSpawnResult = Awaited>; function makeSpawn(result: MockSpawnResult) { return mock(async (_cmd: string, _args: string[], _opts: SpawnCliConfig) => result); } let tempDirCounter = 0; function tempDir(): string { const dir = join(tmpdir(), `differ-test-${Date.now()}-${tempDirCounter++}`); mkdirSync(dir, { recursive: true }); return dir; } function makeCtx(officeMode: "generate" | "edit" | null): ThreadContext { const steps = officeMode === null ? [] : [ { role: "office", meta: officeMode === "edit" ? { mode: "edit", outputDocx: "/tmp/modified.docx", sourceDocx: "/tmp/original.docx" } : { mode: "generate", outputDocx: "/tmp/output.docx", sourceDocx: null }, contentHash: "", refs: [], timestamp: 0, }, ]; return { threadId: "t1", depth: 0, bundleHash: "", start: { role: START, content: "", meta: {}, timestamp: 0, parentState: null }, steps, } as unknown as ThreadContext; } async function runAdapter( spawnFn: ReturnType, ctx: ThreadContext, reportExists = true, ) { const dir = tempDir(); const outputDocx = join(dir, "modified.docx"); const sourceDocx = join(dir, "original.docx"); writeFileSync(outputDocx, ""); writeFileSync(sourceDocx, ""); const editCtx: ThreadContext = { ...ctx, steps: [ { role: "office", meta: { mode: "edit", outputDocx, sourceDocx }, contentHash: "", refs: [], timestamp: 0, }, ], } as unknown as ThreadContext; if (reportExists) { writeFileSync(join(dir, "diff_report.html"), ""); } const adapter = createDifferAdapter({ command: "docx-diff", timeout: null }, spawnFn); const roleFn = adapter("", differMetaSchema); return roleFn(editCtx, {} as never); } describe("createDifferAdapter", () => { test("returns DifferMeta on exit 0 (no changes)", async () => { const spawn = makeSpawn(ok("") as MockSpawnResult); const result = await runAdapter(spawn, makeCtx("edit")); expect(result.meta.diffReport).toMatch(/diff_report\.html$/); expect(result.childThread).toBeNull(); }); test("returns DifferMeta on exit 1 (has changes)", async () => { const spawn = makeSpawn( err({ kind: "non_zero_exit", exitCode: 1, stdout: "", stderr: "" }) as MockSpawnResult, ); const result = await runAdapter(spawn, makeCtx("edit")); expect(result.meta.diffReport).toMatch(/diff_report\.html$/); }); test("throws on exit 2 (docx-diff error)", async () => { const spawn = makeSpawn( err({ kind: "non_zero_exit", exitCode: 2, stdout: "", stderr: "parse error" }) as MockSpawnResult, ); await expect(runAdapter(spawn, makeCtx("edit"))).rejects.toThrow("docx-diff failed (exit 2)"); }); test("throws on timeout", async () => { const spawn = makeSpawn(err({ kind: "timeout" }) as MockSpawnResult); await expect(runAdapter(spawn, makeCtx("edit"))).rejects.toThrow("timed out"); }); test("throws on spawn_failed", async () => { const spawn = makeSpawn( err({ kind: "spawn_failed", message: "binary not found" }) as MockSpawnResult, ); await expect(runAdapter(spawn, makeCtx("edit"))).rejects.toThrow("spawn failed"); }); test("throws when office step is missing from ctx.steps", async () => { const spawn = makeSpawn(ok("") as MockSpawnResult); const adapter = createDifferAdapter({ command: "docx-diff", timeout: null }, spawn); const roleFn = adapter("", differMetaSchema); const emptyCtx = makeCtx(null); await expect(roleFn(emptyCtx, {} as never)).rejects.toThrow("office step not found"); }); test("throws when report file is not created by docx-diff", async () => { const spawn = makeSpawn(ok("") as MockSpawnResult); await expect(runAdapter(spawn, makeCtx("edit"), false)).rejects.toThrow("report file not found"); }); test("uses 'docx-diff' when command is null", async () => { const spawn = makeSpawn(ok("") as MockSpawnResult); const dir = tmpdir(); const outputDocx = join(dir, `mod-${Date.now()}.docx`); const sourceDocx = join(dir, `src-${Date.now()}.docx`); writeFileSync(outputDocx, ""); writeFileSync(sourceDocx, ""); writeFileSync(join(dir, "diff_report.html"), ""); const ctx: ThreadContext = { threadId: "t2", depth: 0, bundleHash: "", start: { role: START, content: "", meta: {}, timestamp: 0, parentState: null }, steps: [{ role: "office", meta: { mode: "edit", outputDocx, sourceDocx }, contentHash: "", refs: [], timestamp: 0 }], } as unknown as ThreadContext; const adapter = createDifferAdapter({ command: null, timeout: null }, spawn); const roleFn = adapter("", differMetaSchema); await roleFn(ctx, {} as never); expect(spawn.mock.calls[0][0]).toBe("docx-diff"); }); });