Files
clean-architecture-frontend…/tests/unit/run-output-root-build.test.ts
T
DongHyeonka 3f64c68991 refactor(layout): 남은 루트 경로 목록도 등록부 집합에서 고른다
정리 4단계의 R2 검사는 등록부를 쓰는 7곳만 봤다. 그 밖에 루트 이름을
담은 목록이 코드 15파일에 19개 따로 있어, 루트 항목 하나를 옮기면
여전히 여러 곳을 같이 고쳐야 했다.

- 등록부에 집합 12개를 더했다. 사본 복사에서 건너뛰는 항목 셋
  (checkout·provider·공급망 fixture), fixture 코드 범위, pnpm 매니페스트,
  Playwright 설정, visual 증거, 문서 입력, 에이전트 하네스, tsconfig
  묶음 셋. 각 집합 설명에 읽는 파일을 적었다.
- 사본이 건너뛰는 node_modules·dist·.tmp 같은 추적 안 하는 항목은
  종류 untracked(optional)로 적는다. 추적 파일이 있으면 시험이 실패한다.
- 19개 목록이 모두 집합을 고른다. 집합의 원소는 전과 같아 동작은
  바뀌지 않는다.
- R2 시험이 추적되는 코드 파일 전체를 본다. 루트 항목(이나 그 안
  경로)만 담은 문자열 배열에 추적되는 루트 이름이 둘 이상이면 실패.
  인자 목록은 `--` 뒤만 본다. main의 옛 목록 18개를 이 검사가 잡는
  것을 확인했다.
- 집합마다 selectRepositoryPaths·selectRepositoryEntries로 고르는 코드가
  있는지 본다. 문서를 복사하지 않는 제거 drill(FE-GATE-020)은 문서
  시험(REMOVAL_FIXTURE_DOCUMENT_TESTS)을 지우는데, 집합 셋
  (agent-harness·documentation-inputs·feature-typecheck)은 그 시험만
  읽는다. 시험이 이 셋을 적어 두고, 문서 시험이 지워진 사본에서만 셋이
  비는 것을 허용한다. 셋이 바뀌면 전체 checkout에서 실패한다.
- 파서가 kinds·sets 설명과 코드의 목록이 같은지 본다.
- .gitignore 주석이 a11y 기록을 아직 artifacts/ 아래라고 적던 것을
  고쳤다(정리 3단계에서 docs/로 옮김).

검증(desktop): test:unit, check:types, check:ci, lint, verify:documentation.
repository-layout 시험을 문서 없는 제거 사본과 feature-scaffold 사본에서도
돌렸고, 집합 하나의 읽는 곳을 지우면 두 곳 모두 실패한다.
2026-11-12 01:17:55 +09:00

113 lines
4.9 KiB
TypeScript

import { spawnSync, type SpawnSyncReturns } from "node:child_process";
import { access, cp, mkdir, mkdtemp, readFile, rm, writeFile } from "node:fs/promises";
import { tmpdir } from "node:os";
import path from "node:path";
import { afterAll, beforeAll, describe, expect, it } from "vitest";
import { localBuildEnvironment } from "../../scripts/lib/build-environment.ts";
import { verifyBuildManifestOutputs } from "../../scripts/lib/build-manifest-outputs.ts";
import { linkFixtureNodeModules } from "../../scripts/lib/fixture-node-modules.ts";
import { selectRepositoryPaths } from "../../scripts/lib/repository-layout.ts";
import { buildManifestArtifactSchema } from "../../src/contracts/release-artifacts.ts";
import { turnOnServiceWorker } from "../e2e/support/service-worker-builds.ts";
/**
* 1105/12-04. Every build wrote `dist`, `.generated/frontend-runtime` and its
* `artifacts/` evidence at fixed paths, so a second build in one checkout
* emptied `dist` while the first run's preview still served it. A build given
* RUN_OUTPUT_ROOT (what a Playwright config sets under TEST_RUN_ID) writes all
* of them under that folder and leaves the checkout's own alone.
*
* One real build of a temp copy with the worker on, so every step that reads
* or writes those paths runs: the app build, the profile config, the worker
* asset list, the worker build and the manifests.
*/
const ROOT = ".tmp/runs/build-probe";
const repoRoot = process.cwd();
const skipped = new Set(selectRepositoryPaths("checkout-copy-skip"));
let copy: string | undefined;
let failed: SpawnSyncReturns<string> | undefined;
beforeAll(async () => {
copy = await mkdtemp(path.join(tmpdir(), "run-output-root-"));
await cp(repoRoot, copy, {
recursive: true,
filter: (source) => !skipped.has(path.relative(repoRoot, source).split(path.sep)[0]!),
});
await linkFixtureNodeModules(copy, repoRoot);
await turnOnServiceWorker(copy);
// What another run in the same checkout is serving and reading.
await mkdir(path.join(copy, "dist"), { recursive: true });
await writeFile(path.join(copy, "dist/served-by-another-run.txt"), "keep\n");
await mkdir(path.join(copy, ".generated/frontend-runtime"), { recursive: true });
await writeFile(path.join(copy, ".generated/frontend-runtime/keep.txt"), "keep\n");
const env = {
...localBuildEnvironment(),
RUN_OUTPUT_ROOT: ROOT,
VITE_BUILD_ID: "run-output-probe",
RELEASE_ID: "run-output-probe",
};
for (const script of ["scripts/generate-product-feature-index.ts", "scripts/build-frontend.ts"]) {
const run = spawnSync(process.execPath, [script], { cwd: copy, encoding: "utf8", env });
if (run.status !== 0) {
failed = run;
break;
}
}
}, 180_000);
afterAll(async () => {
if (copy) await rm(copy, { recursive: true, force: true });
});
describe("a build with RUN_OUTPUT_ROOT (1105/12-04)", () => {
it("builds", () => {
expect(failed, `${failed?.stdout ?? ""}\n${failed?.stderr ?? ""}`).toBeUndefined();
});
it("leaves the checkout's dist, generated runtime and evidence alone", async () => {
expect(await readFile(path.join(copy!, "dist/served-by-another-run.txt"), "utf8")).toBe("keep\n");
expect(
await readFile(path.join(copy!, ".generated/frontend-runtime/keep.txt"), "utf8"),
).toBe("keep\n");
await expect(access(path.join(copy!, "dist/index.html"))).rejects.toThrow();
await expect(access(path.join(copy!, "artifacts/release/build-manifest.json"))).rejects.toThrow();
});
it("writes dist, the generated runtime and the evidence under the root", async () => {
const root = path.join(copy!, ROOT);
for (const file of [
"dist/index.html",
"dist/config.json",
"dist/release-manifest.json",
"dist/runtime-config.schema.json",
"dist/service-worker.js",
"dist/.vite/manifest.json",
".generated/frontend-runtime/contract-set.ts",
".generated/frontend-runtime/service-worker-assets.ts",
"artifacts/release/build-manifest.json",
"artifacts/quality/vite-module-inventory.json",
]) {
await access(path.join(root, file));
}
// Its paths are relative to the folder the build wrote.
const manifest = buildManifestArtifactSchema.parse(
JSON.parse(await readFile(path.join(root, "artifacts/release/build-manifest.json"), "utf8")),
);
expect(await verifyBuildManifestOutputs(manifest, { repositoryRoot: root })).toEqual([]);
});
it("points the generated modules' imports at the checkout's src", async () => {
for (const file of ["contract-set.ts", "service-worker-assets.ts"]) {
const generated = path.join(copy!, ROOT, ".generated/frontend-runtime", file);
const specifier = /^import type .+ from "([^"]+)";$/mu.exec(
await readFile(generated, "utf8"),
)?.[1];
expect(specifier, file).toMatch(/^(?:\.\.\/)+src\/contracts\//u);
await access(path.resolve(path.dirname(generated), specifier!));
}
});
});