fix(test-run): RUN_OUTPUT_ROOT가 있으면 빌드 뒤 검사가 멈춘다

문제: 1105/12-04 뒤 빌드는 `RUN_OUTPUT_ROOT` 아래에 쓰는데,
check:bundle의 두 단계(`generate-supply-chain.ts`, `check-bundle.ts`)는 이
변수를 읽지 않고 checkout의 `dist`와 `artifacts/`를 읽는다. 셸에 이 변수를
둔 채 빌드와 check:bundle을 돌리면 예산을 3,504 B 넘는 새 빌드 대신 이전
빌드를 재서 PASS한다(리뷰 12-R2). ci:gate의 신선도 검사도 bundle.json을
check:bundle이 다시 쓰므로 막지 못한다.

고른 방법: `scripts/lib/run-isolation.ts`에 `checkoutBuildReadFailure`를
두고, 두 스크립트가 무엇을 읽기 전에 부른다. 출력 루트가 `.`이 아니면 변수
값과 이유를 적고 exit 1로 멈춘다. `.`(Playwright 설정이 run ID 없이 web
server에 넘기는 값)과 빈 값은 그대로 돈다. 그래서
`RUN_OUTPUT_ROOT=.tmp/x corepack pnpm ci:gate -- FE-GATE-012`도 check-bundle
단계에서 변수 이름을 적고 실패한다.
버린 대안: ci:gate가 시작 전에 거절하기(리뷰 문서 (b)). 12-R2처럼
check:bundle을 직접 돌리는 경우를 막지 못한다. 두 스크립트가 같은 루트를
읽게 하기(c)는 supply-chain 산출물 전부와 CI upload 경로를 함께 옮겨야 한다.

위험·한계:
- FE-GATE-012는 빌드 단계를 끝까지 돈 뒤 check-bundle에서 실패한다. 빌드
  시간만큼 늦게 알린다.
- 같은 모양일 수 있는 `check:app-build-input:bundle`,
  `check:optional-recipes --require-dist`, release candidate 조립은 보지
  않았다. FE-GATE-012에서는 check-bundle이 먼저 실패해 거기까지 가지 않는다.
- 디버깅으로 변수를 둔 사람은 check:bundle 전에 지워야 한다(문서에 적음).
- 이 노트북에서는 실행하지 못했다.

검증: desktop batch에서 확인.
node scripts/run-vitest.ts run tests/unit/check-bundle-output.test.ts tests/unit/run-isolation.test.ts
리뷰 12-R2 명령(stale-bundle-rc=1, stderr에 RUN_OUTPUT_ROOT), check:types,
lint, verify:documentation, ci:gate FE-GATE-012

Refs: 1106/12-02
This commit is contained in:
DongHyeonka
2026-11-06 05:35:48 +09:00
parent b8535f8ce7
commit 68fde02777
6 changed files with 143 additions and 13 deletions
+11
View File
@@ -9,6 +9,7 @@ import {
bundlePerformanceArtifactSchema,
} from "./contracts/release-artifacts.ts";
import { classifyViteJavascript } from "./lib/classify-vite-bundle.ts";
import { checkoutBuildReadFailure } from "./lib/run-isolation.ts";
import { writeValidatedJsonArtifact } from "./lib/validated-json-artifact.ts";
type ViteManifest = Record<
@@ -21,6 +22,16 @@ type BundleBudgets = {
lazyChunkGzipBytes: number;
};
// 1106/12-02. This reads dist/.vite/manifest.json and the inventory
// scripts/generate-supply-chain.ts made of dist. Under RUN_OUTPUT_ROOT the
// build wrote elsewhere, and this passed a build over budget on the earlier
// one the checkout still held.
const outputRootFailure = checkoutBuildReadFailure("scripts/check-bundle.ts");
if (outputRootFailure !== undefined) {
process.stderr.write(`${outputRootFailure}\n`);
process.exit(1);
}
const report = bundleOutputInventoryArtifactSchema.parse(
JSON.parse(await readFile("artifacts/performance/bundle.json", "utf8")) as unknown,
);
+10
View File
@@ -39,8 +39,18 @@ import {
parseRepositoryFileInventoryPolicy,
} from "./lib/repository-file-inventory.ts";
import { collectDistOutputs, distSha256 } from "./lib/release-candidate.ts";
import { checkoutBuildReadFailure } from "./lib/run-isolation.ts";
import { deterministicSupplyChainGeneratedAt } from "./lib/supply-chain-time.ts";
// 1106/12-02. This reads artifacts/release/build-manifest.json and dist where
// the checkout keeps them. Under RUN_OUTPUT_ROOT the build wrote elsewhere,
// and this recorded the earlier build the checkout still held.
const outputRootFailure = checkoutBuildReadFailure("scripts/generate-supply-chain.ts");
if (outputRootFailure !== undefined) {
process.stderr.write(`${outputRootFailure}\n`);
process.exit(1);
}
type Document = Record<string, unknown>;
function isRecord(value: unknown): value is Document {
+28
View File
@@ -82,6 +82,34 @@ export function runOutputPath(
return path.posix.join(runOutputRoot(environment), relativePath);
}
/**
* 1106/12-02. Why `step`, which reads the build where the checkout keeps it
* (`dist/`, the build manifest and the evidence under `artifacts/`), must not
* run in this environment; `undefined` when it may. With RUN_OUTPUT_ROOT set
* the build writes under that folder, so such a step would judge whatever
* build the checkout still holds: check:bundle passed an over-budget build
* that way, on the earlier one. `.` is the checkout itself, which is what a
* Playwright config hands its web server without a run ID.
*/
export function checkoutBuildReadFailure(
step: string,
environment: Environment = process.env,
): string | undefined {
let root: string;
try {
root = runOutputRoot(environment);
} catch (error) {
return `${step}: ${error instanceof Error ? error.message : String(error)}`;
}
if (root === ".") return undefined;
return (
`${step} reads the build at this checkout's paths (dist/, artifacts/), but ` +
`${RUN_OUTPUT_ROOT_VARIABLE}=${root} makes the build write under ${root}/, so it ` +
`would judge an earlier build. Unset ${RUN_OUTPUT_ROOT_VARIABLE}, build again and ` +
`run ${step} again.`
);
}
/**
* The port variable of each Playwright config's web server. Unset, the config
* picks a free port; set, it uses that one (to pin a port while debugging).