import { describe, expect, it, vi } from "vitest"; import { cleanupOwnedProcessGroup, observeOwnedProcessLineage, type ProcessOwnershipHost, } from "../../../src/process/ProcessOwnership.js"; const ownership = { runId: "run-token", leaderPid: 100, processGroupId: 100, }; const host = ( environments: Readonly>>>, ): { readonly adapter: ProcessOwnershipHost; readonly signalGroup: ReturnType; } => { const signalGroup = vi.fn(); return { adapter: { listProcesses: () => Promise.resolve( Object.keys(environments).map((pid) => ({ pid: Number(pid), parentPid: Number(pid) === 100 ? 1 : 100, processGroupId: 100, state: "S", command: "fixture", })), ), environment: (pid) => Promise.resolve(environments[pid] ?? {}), signalGroup, }, signalGroup, }; }; describe("owned process-group cleanup validation", () => { it("fails closed when a descendant in another process group lacks the token", async () => { const adapter: ProcessOwnershipHost = { listProcesses: () => Promise.resolve([ { pid: 100, parentPid: 1, processGroupId: 100, state: "S", command: "fixture", }, { pid: 101, parentPid: 100, processGroupId: 101, state: "S", command: "child-session", }, ]), environment: (pid) => Promise.resolve({ REA_PROCESS_RUN_ID: pid === 100 ? "run-token" : "other-run", }), signalGroup: vi.fn(), }; await expect( observeOwnedProcessLineage(ownership, adapter), ).resolves.toEqual({ status: "unavailable", observedAt: expect.any(String), runId: "run-token", launcherPid: 100, processGroupId: 100, reason: "process lineage contains an unowned or PID-reused process", }); }); it("does not publish lineage when any member fails ownership checks", async () => { const { adapter } = host({ 100: { REA_PROCESS_RUN_ID: "run-token" }, 101: { REA_PROCESS_RUN_ID: "other-run" }, }); await expect( observeOwnedProcessLineage(ownership, adapter), ).resolves.toEqual({ status: "unavailable", observedAt: expect.any(String), runId: "run-token", launcherPid: 100, processGroupId: 100, reason: "process lineage contains an unowned or PID-reused process", }); }); it("fails closed for stale metadata or an unrelated concurrent process", async () => { const { adapter, signalGroup } = host({ 100: { REA_PROCESS_RUN_ID: "run-token" }, 101: { REA_PROCESS_RUN_ID: "different-run" }, }); expect(await cleanupOwnedProcessGroup(ownership, adapter)).toEqual({ cleaned: false, reason: "process tree contains an unowned or PID-reused process", failures: [{ pid: 101, reason: "run-token-mismatch" }], }); expect(signalGroup).not.toHaveBeenCalled(); }); it("checks every member and aggregates ownership read failures", async () => { const environment = vi.fn((pid: number) => { if (pid === 100) return Promise.reject(new Error("transient procfs read")); return Promise.resolve( pid === 101 ? { REA_PROCESS_RUN_ID: "different-run" } : { REA_PROCESS_RUN_ID: "run-token" }, ); }); const signalGroup = vi.fn(); const adapter: ProcessOwnershipHost = { listProcesses: () => Promise.resolve( [100, 101, 102].map((pid) => ({ pid, parentPid: pid === 100 ? 1 : 100, processGroupId: 100, state: "S", command: "fixture", })), ), environment, signalGroup, }; expect(await cleanupOwnedProcessGroup(ownership, adapter)).toEqual({ cleaned: false, reason: "process tree contains an unowned or PID-reused process", failures: [ { pid: 100, reason: "environment-unreadable" }, { pid: 101, reason: "run-token-mismatch" }, ], }); expect(environment.mock.calls.map(([pid]) => pid)).toEqual([100, 101, 102]); expect(signalGroup).not.toHaveBeenCalled(); }); it("accepts a member that exits during ownership revalidation", async () => { const liveLauncher = { pid: 100, parentPid: 1, processGroupId: 100, state: "S", command: "fixture", }; const listProcesses = vi .fn() .mockResolvedValueOnce([liveLauncher]) .mockResolvedValue([]); const signalGroup = vi.fn(); const adapter: ProcessOwnershipHost = { listProcesses, environment: () => Promise.reject(new Error("process exited before environment read")), signalGroup, }; await expect(cleanupOwnedProcessGroup(ownership, adapter)).resolves.toEqual( { cleaned: true, signaled: false, }, ); expect(signalGroup).not.toHaveBeenCalled(); }); });