import { mkdir, mkdtemp, readFile, rm, writeFile } from "node:fs/promises"; import { tmpdir } from "node:os"; import path from "node:path"; import { afterEach, describe, expect, it } from "vitest"; import { loadCiGateContract } from "../../scripts/contracts/ci-gates.ts"; import { assertNoRuntimeImports, pruneRemovalFixtureCiContract, removeRuntimeDependentTests, renderRemovalJunit, runtimeImportGraph, } from "../../scripts/lib/removal-fixture.ts"; const temporaryRoots: string[] = []; afterEach(async () => { await Promise.all( temporaryRoots.splice(0).map((root) => rm(root, { recursive: true, force: true })), ); }); it("rejects an empty scanned module universe", async () => { const root = await mkdtemp(path.join(tmpdir(), "removal-fixture-empty-modules-")); temporaryRoots.push(root); await expect(runtimeImportGraph(root, ["src/runtime"])).rejects.toThrow( /scanned module universe is empty/i, ); }); it("rejects a runtime removal scan that discovers no dependent tests", async () => { const root = await mkdtemp(path.join(tmpdir(), "removal-fixture-zero-dependent-tests-")); temporaryRoots.push(root); await mkdir(path.join(root, "src/runtime"), { recursive: true }); await mkdir(path.join(root, "tests"), { recursive: true }); await writeFile(path.join(root, "src/runtime/index.ts"), "export const runtime = true;\n"); await writeFile(path.join(root, "tests/unrelated.test.ts"), "export const unrelated = true;\n"); await expect(removeRuntimeDependentTests(root, ["src/runtime"])).rejects.toThrow( /no runtime-dependent tests discovered/i, ); }); it("allows zero runtime imports after the runtime has been removed", async () => { const root = await mkdtemp(path.join(tmpdir(), "removal-fixture-post-removal-")); temporaryRoots.push(root); await mkdir(path.join(root, "tests"), { recursive: true }); await writeFile(path.join(root, "tests/unrelated.test.ts"), "export const unrelated = true;\n"); await expect( assertNoRuntimeImports(root, ["src/runtime"], "fixture runtime"), ).resolves.toBeUndefined(); }); async function copyCiContract(prefix: string): Promise { const root = await mkdtemp(path.join(tmpdir(), prefix)); temporaryRoots.push(root); await mkdir(path.join(root, "config/ci"), { recursive: true }); for (const file of ["config/ci/gates.json", "config/ci/contract-baseline.json", "package.json"]) { await writeFile(path.join(root, file), await readFile(file)); } return root; } // D-13: a removal takes the same step a downstream project takes — it records // the reduced contract as the new baseline — and then loads canonically. it("prunes removed command and evidence references and re-baselines the contract", async () => { const root = await copyCiContract("removal-fixture-contract-"); await pruneRemovalFixtureCiContract({ root, removedScripts: new Set(["test:reference-feature"]), removedEvidencePathFragments: ["reference-feature.xml"], }); const contract = await loadCiGateContract(root); expect(contract.commands.some(({ script }) => script === "test:reference-feature")).toBe(false); expect(contract.artifacts.some(({ path }) => path.includes("reference-feature.xml"))).toBe(false); expect(contract.gates.some(({ commandIds }) => commandIds.includes("test-reference-feature"))).toBe(false); expect(contract.gates.some(({ evidenceArtifactIds }) => evidenceArtifactIds.includes("artifact-artifacts-tests-reference-feature-xml") )).toBe(false); const baseline = JSON.parse( await readFile(path.join(root, "config/ci/contract-baseline.json"), "utf8"), ) as Record; expect(baseline).toMatchObject({ commands: contract.commands.length, owner: "removal-fixture" }); const packageDocument = JSON.parse(await readFile(path.join(root, "package.json"), "utf8")) as { scripts: Record; }; expect(packageDocument.scripts["check:ci"]).not.toMatch(/reduced/u); }); it("rejects a contract that no longer matches its committed baseline", async () => { const root = await copyCiContract("removal-fixture-baseline-drift-"); const baselinePath = path.join(root, "config/ci/contract-baseline.json"); const baseline = JSON.parse(await readFile(baselinePath, "utf8")) as Record; await writeFile(baselinePath, JSON.stringify({ ...baseline, commands: baseline.commands! + 1 })); await expect(loadCiGateContract(root)).rejects.toThrow( /contract-baseline\.json[\s\S]*commands[\s\S]*update:ci-contract-baseline/u, ); }); it("rejects pruning that leaves a reduced gate without commands", async () => { const root = await copyCiContract("removal-fixture-empty-gate-"); await expect(pruneRemovalFixtureCiContract({ root, removedScripts: new Set(["test:runtime-schema"]), removedEvidencePathFragments: ["runtime-schema.xml"], })).rejects.toThrow(/commandIds|too small|at least 1/i); }); describe("release evidence fixture copy", () => { it("keeps the release evidence and leaves the regenerated trees behind", async () => { const { copyReleaseEvidenceTree, RELEASE_EVIDENCE_REGENERATED_TREES } = await import("../../scripts/lib/removal-fixture.ts"); const { RELEASE_CANDIDATE_EVIDENCE_PATHS } = await import( "../../scripts/lib/release-candidate.ts" ); const { access, readdir } = await import("node:fs/promises"); // The source is a fake checkout, not process.cwd(): release evidence is // git-ignored, so a fresh clone has none of it and the copy would be // checked against nothing. const source = await mkdtemp(path.join(tmpdir(), "release-evidence-source-")); const target = await mkdtemp(path.join(tmpdir(), "release-evidence-target-")); temporaryRoots.push(source, target); const evidencePaths = RELEASE_CANDIDATE_EVIDENCE_PATHS.filter((evidence) => evidence.startsWith("artifacts/") ); expect(evidencePaths.length).toBeGreaterThan(0); for (const relative of [ ...evidencePaths, ...RELEASE_EVIDENCE_REGENERATED_TREES.map((tree) => `${tree}/trace.zip`), ]) { await mkdir(path.dirname(path.join(source, relative)), { recursive: true }); await writeFile(path.join(source, relative), "{}\n"); } await copyReleaseEvidenceTree(source, target); // Every release artifact has to survive the copy; a fixture missing one // cannot build a candidate at all, and every provider suite then fails // while constructing its own fixture. for (const evidence of evidencePaths) { await expect(access(path.join(target, evidence)), evidence).resolves.toBeUndefined(); } // The regenerated trees are why this is a filter and not a plain copy: they // are tens of megabytes of traces and coverage HTML. They still exist, // because the repository inventory expects the directories. for (const tree of RELEASE_EVIDENCE_REGENERATED_TREES) { await expect(readdir(path.join(target, tree)), tree).resolves.toEqual([]); } }); }); describe("removal JUnit report (14-08)", () => { it("counts every failure and gives each check its own cause", () => { const xml = renderRemovalJunit("reference-feature-removal", [ { name: "typecheck", passed: false, failure: "corepack pnpm check:types exited 2" }, { name: "architecture", passed: true }, { name: "build", passed: false, failure: "corepack pnpm build exited 1" }, { name: "fixture-id-residue", passed: false, failure: "residue: tests/a.test.ts, tests/&c.ts", }, ]); expect(xml).toContain('tests="4" failures="3"'); expect(xml).toContain( '', ); expect(xml).toContain(''); expect(xml).toContain( '', ); expect(xml).toContain( 'message="residue: tests/a.test.ts, tests/<b>&c.ts"', ); expect(xml.match(/residue:/gu)).toHaveLength(1); }); });