import { describe, expect, test } from "vitest"; import { mkdirSync, mkdtempSync, readFileSync, rmSync, writeFileSync } from "node:fs"; import { tmpdir } from "node:os"; import { join, resolve } from "node:path"; import { fileURLToPath } from "node:url"; import { __testUtils } from "../plugins/codemem.js"; describe("opencode adapter event mapping", () => { test("maps user_prompt to prompt adapter envelope", () => { const event = { type: "user_prompt", prompt_text: "Summarize the latest changes", prompt_number: 2, timestamp: "2026-03-02T20:00:00Z", }; const mapped = __testUtils.buildOpencodeAdapterEvent({ sessionID: "sess-1", event, }); expect(mapped).not.toBeNull(); expect(mapped?.source).toBe("opencode"); expect(mapped?.event_type).toBe("prompt"); expect(mapped?.payload).toEqual({ text: "Summarize the latest changes", prompt_number: 2, }); }); test("maps tool.execute.after to tool_result with error status", () => { const event = { type: "tool.execute.after", tool: "bash", args: { command: "uv run pytest" }, result: "failed", error: "1 test failed", timestamp: "2026-03-02T20:00:01Z", }; const mapped = __testUtils.buildOpencodeAdapterEvent({ sessionID: "sess-2", event, }); expect(mapped).not.toBeNull(); expect(mapped?.event_type).toBe("tool_result"); expect(mapped?.payload?.tool_name).toBe("bash"); expect(mapped?.payload?.status).toBe("error"); }); test("attachAdapterEvent keeps unknown event unchanged", () => { const unknown = { type: "assistant_usage", usage: { input_tokens: 12 } }; const attached = __testUtils.attachAdapterEvent({ sessionID: "sess-3", event: unknown, }); expect(attached).toEqual(unknown); expect(attached).not.toHaveProperty("_adapter"); }); test("attachAdapterEvent annotates mapped events", () => { const event = { type: "assistant_message", assistant_text: "Done.", timestamp: "2026-03-02T20:00:02Z", }; const attached = __testUtils.attachAdapterEvent({ sessionID: "sess-4", event, }); expect(attached).toHaveProperty("_adapter"); expect(attached._adapter.event_type).toBe("assistant"); expect(attached._adapter.payload.text).toBe("Done."); }); test("builds deterministic adapter event ids with explicit timestamp", () => { const event = { type: "assistant_message", assistant_text: "Deterministic", timestamp: "2026-03-02T20:00:05Z", }; const first = __testUtils.buildOpencodeAdapterEvent({ sessionID: "sess-det", event, }); const second = __testUtils.buildOpencodeAdapterEvent({ sessionID: "sess-det", event, }); expect(first).not.toBeNull(); expect(second).not.toBeNull(); expect(first?.event_id).toBe(second?.event_id); }); test("keeps adapter event ids within schema length", () => { const longSession = "sess-" + "x".repeat(500); const event = { type: "user_prompt", prompt_text: "Validate id length", timestamp: "2026-03-02T20:00:00Z", }; const mapped = __testUtils.buildOpencodeAdapterEvent({ sessionID: longSession, event, }); expect(mapped).not.toBeNull(); expect(mapped?.event_id.length).toBeLessThanOrEqual(128); }); test("selectRawEventId prefers existing payload id", () => { const selected = __testUtils.selectRawEventId({ payload: { _raw_event_id: "stable-id-1" }, nextEventId: () => "generated-id", }); expect(selected).toBe("stable-id-1"); }); test("buildRawEventEnvelope uses generated id when raw id is absent", () => { const envelope = __testUtils.buildRawEventEnvelope({ sessionID: "sess-5", type: "assistant_message", payload: { _adapter: { event_id: "adapter-stable-id" }, }, cwd: "/tmp/worktree", project: "codemem", startedAt: "2026-03-02T20:00:00Z", nowMs: 12345, nowMono: 678.9, nextEventId: () => "generated-id", }); expect(envelope.event_id).toBe("generated-id"); expect(envelope.session_stream_id).toBe("sess-5"); expect(envelope.session_id).toBe("sess-5"); expect(envelope.opencode_session_id).toBe("sess-5"); expect(envelope.event_type).toBe("assistant_message"); }); test("buildRawEventEnvelope reuses payload _raw_event_id when present", () => { const envelope = __testUtils.buildRawEventEnvelope({ sessionID: "sess-5", type: "assistant_message", payload: { _raw_event_id: "stable-raw-id" }, cwd: "/tmp/worktree", project: "codemem", startedAt: "2026-03-02T20:00:00Z", nowMs: 12345, nowMono: 678.9, nextEventId: () => "generated-id", }); expect(envelope.event_id).toBe("stable-raw-id"); }); test("resolveProjectName falls back to cwd basename when project metadata is missing", () => { const projectName = __testUtils.resolveProjectName(null, "/tmp/workspaces/codemem"); expect(projectName).toBe("codemem"); }); test("resolveProjectName prefers git root basename for nested cwd", () => { const tmp = mkdtempSync(join(tmpdir(), "codemem-plugin-project-")); try { const repoRoot = join(tmp, "codemem"); const nested = join(repoRoot, "packages", "core"); mkdirSync(join(repoRoot, ".git"), { recursive: true }); mkdirSync(nested, { recursive: true }); const projectName = __testUtils.resolveProjectName(null, nested); expect(projectName).toBe("codemem"); } finally { rmSync(tmp, { recursive: true, force: true }); } }); test("resolveProjectName handles git worktree cwd", () => { const tmp = mkdtempSync(join(tmpdir(), "codemem-plugin-project-")); try { const mainRepo = join(tmp, "main-repo"); const worktree = join(tmp, "feature-worktree"); mkdirSync(join(mainRepo, ".git", "worktrees", "feature-worktree"), { recursive: true }); mkdirSync(worktree, { recursive: true }); writeFileSync( join(worktree, ".git"), `gitdir: ${join(mainRepo, ".git", "worktrees", "feature-worktree")}`, ); const projectName = __testUtils.resolveProjectName(null, worktree); expect(projectName).toBe("main-repo"); } finally { rmSync(tmp, { recursive: true, force: true }); } }); test("resolveProjectName handles relative git worktree markers", () => { const tmp = mkdtempSync(join(tmpdir(), "codemem-plugin-project-")); try { const mainRepo = join(tmp, "main-repo"); const worktree = join(tmp, "feature-worktree"); mkdirSync(join(mainRepo, ".git", "worktrees", "feature-worktree"), { recursive: true }); mkdirSync(worktree, { recursive: true }); writeFileSync( join(worktree, ".git"), "gitdir: ../main-repo/.git/worktrees/feature-worktree", ); const projectName = __testUtils.resolveProjectName(null, worktree); expect(projectName).toBe("main-repo"); } finally { rmSync(tmp, { recursive: true, force: true }); } }); test("resolveProjectName normalizes path-like project metadata", () => { const projectName = __testUtils.resolveProjectName( { root: "C:\\Users\\adam\\workspace\\codemem" }, null, ); expect(projectName).toBe("codemem"); }); test("parsePositiveInt falls back for invalid values", () => { expect(__testUtils.parsePositiveInt("200", 10)).toBe(200); expect(__testUtils.parsePositiveInt("0", 10)).toBe(10); expect(__testUtils.parsePositiveInt("-5", 10)).toBe(10); expect(__testUtils.parsePositiveInt("NaN", 10)).toBe(10); }); test("trimEventQueue drops enqueued events first", () => { const events = [ { _raw_event_id: "a", _raw_enqueued: false }, { _raw_event_id: "b", _raw_enqueued: true }, ]; __testUtils.trimEventQueue({ events, maxEvents: 1, }); expect(events.length).toBe(1); expect(events[0]._raw_event_id).toBe("a"); }); test("trimEventQueue preserves unsent events under pressure", () => { const events = [ { _raw_event_id: "a", _raw_enqueued: false }, { _raw_event_id: "b", _raw_enqueued: false }, ]; let pressured = false; __testUtils.trimEventQueue({ events, maxEvents: 1, onUnsentPressure: () => { pressured = true; }, }); expect(events.length).toBe(2); expect(pressured).toBe(true); }); test("trimEventQueue trims durably spooled events before unspooled events", () => { const events = [ { _raw_event_id: "a", _raw_enqueued: false, _raw_spooled: true }, { _raw_event_id: "b", _raw_enqueued: false }, { _raw_event_id: "c", _raw_enqueued: false }, ]; let dropped = null; __testUtils.trimEventQueue({ events, maxEvents: 1, hardMaxEvents: 2, onForcedDrop: (event) => { dropped = event?._raw_event_id || null; }, }); expect(events.length).toBe(2); expect(dropped).toBe("a"); }); test("trimEventQueue stays at the hard cap by dropping the oldest unspooled event", () => { const events = [ { _raw_event_id: "a", _raw_enqueued: false }, { _raw_event_id: "b", _raw_enqueued: false }, { _raw_event_id: "c", _raw_enqueued: false }, ]; let dropped = null; __testUtils.trimEventQueue({ events, maxEvents: 1, hardMaxEvents: 2, onForcedDrop: (event) => { dropped = { eventId: event?._raw_event_id || null, durableSpoolCoverage: event?._raw_spooled === true, }; }, }); expect(events).toHaveLength(2); expect(events.map((event) => event._raw_event_id)).toEqual(["b", "c"]); expect(dropped).toEqual({ eventId: "a", durableSpoolCoverage: false }); }); test("buildRunnerArgs returns empty for direct codemem runner", () => { const args = __testUtils.buildRunnerArgs({ runner: "codemem", runnerFrom: "/some/path", runnerFromExplicit: false, }); expect(args).toEqual([]); }); test("buildRunnerArgs pins the npx CLI and embedding runtime together", () => { const args = __testUtils.buildRunnerArgs({ runner: "npx", runnerFrom: "/some/path", runnerFromExplicit: false, }); expect(args).toEqual([ "-y", "--package", `codemem@${__testUtils.PINNED_BACKEND_VERSION}`, "--package", `@codemem/embeddings@${__testUtils.PINNED_BACKEND_VERSION}`, "codemem", ]); }); test("buildRunnerArgs preserves a non-codemem explicit npx override", () => { expect( __testUtils.buildRunnerArgs({ runner: "npx", runnerFrom: "custom-codemem-package", runnerFromExplicit: true, }), ).toEqual(["-y", "custom-codemem-package"]); }); test("buildRunnerArgs preserves a codemem npm alias without deriving an embedding alias", () => { const alias = "codemem@npm:@myorg/codemem-fork@1.2.3"; expect( __testUtils.buildRunnerArgs({ runner: "npx", runnerFrom: alias, runnerFromExplicit: true, }), ).toEqual(["-y", alias]); }); test("buildRunnerArgs pairs an explicit codemem@version override with embeddings", () => { expect( __testUtils.buildRunnerArgs({ runner: "npx", runnerFrom: "codemem@1.2.3", runnerFromExplicit: true, }), ).toEqual([ "-y", "--package", "codemem@1.2.3", "--package", "@codemem/embeddings@1.2.3", "codemem", ]); }); test("buildRunnerArgs pairs a bare codemem explicit override with embeddings", () => { expect( __testUtils.buildRunnerArgs({ runner: "npx", runnerFrom: "codemem", runnerFromExplicit: true, }), ).toEqual([ "-y", "--package", "codemem", "--package", "@codemem/embeddings", "codemem", ]); }); test("CLI-bundled plugin pin stays in lockstep with the CLI package version", () => { // The CLI's bundled OpenCode plugin spawns `npx codemem@${PINNED}` when // no local backend is configured. Because that backend ships inside the // same package as this plugin, the pin must match the package version // exactly — including alpha/beta/rc prereleases. const packageJsonPath = resolve( fileURLToPath(new URL(".", import.meta.url)), "..", "..", "package.json", ); const packageJson = JSON.parse(readFileSync(packageJsonPath, "utf-8")); expect(packageJson.version).toBe(__testUtils.PINNED_BACKEND_VERSION); expect(__testUtils.PINNED_BACKEND_VERSION).toMatch( /^\d+\.\d+\.\d+(?:-(?:alpha|beta|rc)\.\d+)?$/, ); }); });