fix(coverage): coverage 대상 패턴을 저장소 루트에 고정한다
frontend-quality-gates / merge / static checks (pull_request) Canceled after 0s
frontend-quality-gates / merge / tests (pull_request) Canceled after 0s
frontend-quality-gates / merge / browser tests (pull_request) Canceled after 0s
frontend-quality-gates / FE-GATE-014 / config-compatibility (pull_request) Canceled after 0s
frontend-quality-gates / FE-GATE-028 / manual-accessibility-review (pull_request) Canceled after 0s
frontend-quality-gates / FE-GATE-026 / lab-performance (pull_request) Canceled after 0s
frontend-quality-gates / FE-GATE-015 / immutable-release-candidate (pull_request) Canceled after 0s
frontend-quality-gates / external-vulnerability-provider (pull_request) Canceled after 0s
frontend-quality-gates / external-provenance-provider (pull_request) Canceled after 0s
frontend-quality-gates / promote-verified-immutable-candidate (pull_request) Canceled after 0s
frontend-quality-gates / deploy-promoted-release (pull_request) Canceled after 0s
frontend-quality-gates / FE-GATE-019 / hosting-header (pull_request) Canceled after 0s
frontend-quality-gates / FE-GATE-021 / runbook-boot-config (pull_request) Canceled after 0s
frontend-quality-gates / FE-GATE-022 / runbook-chunk-mismatch (pull_request) Canceled after 0s
frontend-quality-gates / FE-GATE-023 / runbook-api-degradation (pull_request) Canceled after 0s
frontend-quality-gates / FE-GATE-024 / runbook-telemetry (pull_request) Canceled after 0s
frontend-quality-gates / FE-GATE-025 / runbook-release-rollback (pull_request) Canceled after 0s
frontend-quality-gates / FE-GATE-018 / field-web-vitals (pull_request) Canceled after 0s
frontend-quality-gates / FE-GATE-017 / diagram-review (pull_request) Canceled after 0s
frontend-quality-gates / main / checker self-tests (pull_request) Canceled after 0s

문제: vitest는 coverage include·exclude를 모듈의 절대 경로에 picomatch
`contains: true`로 맞춘다. 그래서 `src/**/*.{ts,tsx}`가 경로 어디에서나
맞는다. checkout이 이름이 `src`로 끝나는 폴더(`~/work/app-src/`)에
있으면 `vite.config.ts`·`scripts/**` 같은 루트 파일이 coverage에 들어가
risk-coverage가 저장소 목록 밖의 행으로 실패한다(tech-log 동기화 때
desktop에서 본 일). CI 경로에는 `src`가 없어 runner에서는 안 보였다.

고른 방법: `scripts/lib/coverage-scope.ts`의 `rootAnchoredGlobs`가
패턴 앞에 루트를 붙인다. 루트는 vitest의 glob 라이브러리(tinyglobby
0.2)가 cwd를 escape하는 식 그대로 escape해, 괄호 같은 glob 문자가 든
루트도 자기 자신에만 맞고 안 불린 파일 glob도 `src/...`로 풀린다.
`vitest.config.ts`와 `check:v8-coverage-counter-semantics`의 자식
설정이 이 함수를 쓴다.
- 막는 시험: counter-semantics 검사가 fixture를
  `checkout (copy)-src/` 아래로 복사하고, fixture 시험이 `src/` 밖
  모듈(`outside-src.ts`)도 불러온다. 고정이 빠지면 그 모듈이 행으로
  들어와 행 집합 검사가 실패한다. 이 검사는 test:coverage 첫 단계에서
  이미 자식 vitest를 띄우므로 프로세스가 늘지 않는다. 단위 시험은
  repo 설정의 모든 패턴이 루트로 시작하는지와 escape를 본다.
- 버린 대안: picomatch로 vitest의 판정을 흉내 내는 단위 시험. 직접
  의존성이 아니고, vitest가 옵션을 바꾸면 거짓 통과한다.

위험·한계: Windows 루트는 `/`로 바꾼 뒤 같은 식으로 escape한다.
올바른 Windows 경로에서는 tinyglobby의 Windows escape와 결과가 같다고
보았지만 Windows에서 돌려 보지는 않았다.

검증(desktop): coverage-scope·v8-coverage-counter-semantics 시험 통과,
check:v8-coverage-counter-semantics rc=0. 변이: 자식 설정을 예전
`["src/**/*.ts"]`로 되돌리면 같은 검사가 `additional: outside-src.ts`로
rc=1. check:types·eslint rc=0. 로그 /tmp/claude-gates/w2fe2-cov1/.
This commit is contained in:
DongHyeonka
2026-11-12 22:03:08 +09:00
parent 2f5eb2b4a5
commit 543518ad2a
7 changed files with 155 additions and 10 deletions
+41
View File
@@ -0,0 +1,41 @@
import path from "node:path";
/**
* Vitest matches `coverage.include` and `coverage.exclude` against each
* module's absolute path with picomatch `contains: true`, so a relative
* pattern may match anywhere in that path. `src/**` also matched
* `<checkout>/vite.config.ts` when the checkout sat in a folder whose name
* ends in `src` (`~/work/app-src/`), and risk coverage then failed on rows
* outside the repository inventory. A pattern that starts with the root
* matches only inside it.
*
* The root is escaped with the expression Vitest's glob library (tinyglobby
* 0.2) uses for a cwd, so a root with glob characters still matches itself
* literally and the untested-file glob resolves the pattern back to
* `src/...` under that cwd. A Windows root is turned into forward slashes
* first; for a valid Windows path that escape equals tinyglobby's Windows one.
*/
const UNESCAPED_GLOB_SYMBOLS =
/(?<!\\)([()[\]{}*?|]|^!|[!+@](?=\()|\\(?![()[\]{}!*+?@|]))/gu;
export function rootAnchoredGlobs(
root: string,
patterns: readonly string[],
): string[] {
const normalizedRoot = path.resolve(root).split(path.sep).join("/");
const escapedRoot = normalizedRoot.replace(UNESCAPED_GLOB_SYMBOLS, "\\$&");
return patterns.map((pattern) => {
if (
pattern.length === 0 ||
pattern.startsWith("/") ||
pattern.startsWith("!") ||
pattern.includes("\\") ||
pattern.split("/").includes("..")
) {
throw new TypeError(
`coverage pattern must be a forward-slash path inside the root: ${pattern}`,
);
}
return `${escapedRoot.replace(/\/$/u, "")}/${pattern}`;
});
}
+20 -7
View File
@@ -10,6 +10,8 @@ import { tmpdir } from "node:os";
import path from "node:path";
import { promisify } from "node:util";
import { rootAnchoredGlobs } from "./coverage-scope.ts";
const execFileAsync = promisify(execFile);
const coverageMetrics = [
"lines",
@@ -31,11 +33,21 @@ const expectedModules = Object.freeze(
[runtimeModule, ...counterlessModules].sort(),
);
const childOutputLimit = 1_800;
/**
* The fixture is copied into a folder whose name ends in `src` and has glob
* characters. Vitest matches coverage patterns anywhere in an absolute path,
* so an unanchored `src/**` also counts the fixture's root-level
* `outside-src.ts`, which the row-set check then reports as additional. The
* repository's own coverage patterns are anchored the same way
* (vitest.config.ts, scripts/lib/coverage-scope.ts).
*/
const fixtureCheckoutName = "checkout (copy)-src";
type ChildOutput = Readonly<{ stdout: string; stderr: string }>;
type ChildInput = Readonly<{
repositoryRoot: string;
ownedRoot: string;
fixtureRoot: string;
configPath: string;
}>;
type CheckerOptions = Readonly<{
@@ -195,7 +207,7 @@ async function defaultRunVitest(input: ChildInput): Promise<ChildOutput> {
"--no-color",
],
{
cwd: input.ownedRoot,
cwd: input.fixtureRoot,
encoding: "utf8",
timeout: 30_000,
maxBuffer: 256 * 1024,
@@ -232,15 +244,16 @@ export async function checkV8CoverageCounterSemantics(
repositoryRoot,
"tests/fixtures/v8-coverage-counter-semantics",
);
const configPath = path.join(ownedRoot, "vitest.config.mjs");
const fixtureRoot = path.join(ownedRoot, fixtureCheckoutName);
const configPath = path.join(fixtureRoot, "vitest.config.mjs");
const reportsDirectory = path.join(ownedRoot, "coverage");
try {
await cp(fixtureSource, ownedRoot, { recursive: true });
await cp(fixtureSource, fixtureRoot, { recursive: true });
await writeFile(
configPath,
`export default ${JSON.stringify(
{
root: ownedRoot,
root: fixtureRoot,
test: {
globals: true,
include: ["counter-semantics.fixture.ts"],
@@ -249,7 +262,7 @@ export async function checkV8CoverageCounterSemantics(
provider: "v8",
reportsDirectory,
reporter: ["json-summary"],
include: ["src/**/*.ts"],
include: rootAnchoredGlobs(fixtureRoot, ["src/**/*.ts"]),
},
},
},
@@ -259,7 +272,7 @@ export async function checkV8CoverageCounterSemantics(
"utf8",
);
try {
await runVitest({ repositoryRoot, ownedRoot, configPath });
await runVitest({ repositoryRoot, ownedRoot, fixtureRoot, configPath });
} catch (error) {
const record = isRecord(error) ? error : {};
throw new Error(
@@ -287,7 +300,7 @@ export async function checkV8CoverageCounterSemantics(
cause: error,
});
}
return assertV8CoverageCounterSemantics(summary, ownedRoot);
return assertV8CoverageCounterSemantics(summary, fixtureRoot);
} finally {
await rm(ownedRoot, { recursive: true, force: true });
}
@@ -8,6 +8,7 @@ import { runtimeValue as namedRuntimeValue } from "./src/reexport-named.ts";
import { runtimeValue } from "./src/runtime.ts";
import { runtimeValue as starRuntimeValue } from "./src/reexport-star.ts";
import type {} from "./src/type-only.ts";
import { outsideValue } from "./outside-src.ts";
test("loads every counter semantics module", () => {
expect([
@@ -15,5 +16,6 @@ test("loads every counter semantics module", () => {
importedRuntimeValue,
namedRuntimeValue,
starRuntimeValue,
]).toEqual([1, 1, 1, 1]);
outsideValue,
]).toEqual([1, 1, 1, 1, 1]);
});
@@ -0,0 +1,4 @@
// Outside the fixture's `src/`. The checker copies this fixture into a folder
// whose name ends in `src`; an unanchored `src/**` coverage pattern counts
// this module too and the row-set check reports it as additional.
export const outsideValue = 1;
+45
View File
@@ -0,0 +1,45 @@
import path from "node:path";
import { describe, expect, it } from "vitest";
import { rootAnchoredGlobs } from "../../scripts/lib/coverage-scope.ts";
import vitestConfig from "../../vitest.config.ts";
describe("root-anchored coverage patterns", () => {
it("prefixes each pattern with the root", () => {
expect(
rootAnchoredGlobs("/work/app-src", ["src/**/*.{ts,tsx}", "**/*.d.ts"]),
).toEqual(["/work/app-src/src/**/*.{ts,tsx}", "/work/app-src/**/*.d.ts"]);
});
it("escapes glob characters in the root as Vitest's glob library does", () => {
expect(
rootAnchoredGlobs("/work/app (copy) [2] {x} *?|/re+(a)/@(b)/!(c)", ["src/**"]),
).toEqual([
"/work/app \\(copy\\) \\[2\\] \\{x\\} \\*\\?\\|/re\\+\\(a\\)/\\@\\(b\\)/\\!\\(c\\)/src/**",
]);
});
it.each(["", "/src/**", "!src/**", "../src/**", "src/../**", "src\\**"])(
"refuses a pattern that is not a forward-slash path inside the root: %j",
(pattern) => {
expect(() => rootAnchoredGlobs("/work/app", [pattern])).toThrow(
/inside the root/u,
);
},
);
it("anchors every repository coverage pattern at the repository root", () => {
const coverage = vitestConfig.test?.coverage;
if (coverage === undefined || coverage.provider !== "v8") {
throw new TypeError("vitest.config.ts has no V8 coverage options");
}
const prefix = rootAnchoredGlobs(process.cwd(), ["x"])[0]?.slice(0, -1) ?? "";
const patterns = [...(coverage.include ?? []), ...(coverage.exclude ?? [])];
expect(patterns.length).toBeGreaterThan(0);
for (const pattern of patterns) expect(pattern.startsWith(prefix)).toBe(true);
expect(coverage.include).toEqual([`${prefix}src/**/*.{ts,tsx}`]);
expect(path.isAbsolute(prefix)).toBe(true);
});
});
@@ -15,6 +15,7 @@ import {
assertV8CoverageCounterSemantics,
checkV8CoverageCounterSemantics,
} from "../../scripts/lib/v8-coverage-counter-semantics.ts";
import { rootAnchoredGlobs } from "../../scripts/lib/coverage-scope.ts";
import { childProcessTimeout } from "../helpers/child-process-timeout.ts";
const roots: string[] = [];
@@ -184,6 +185,36 @@ describe("V8 coverage counter semantics", () => {
await expect(access(ownedRoot)).rejects.toMatchObject({ code: "ENOENT" });
});
it("copies the fixture under a src-suffixed folder with root-anchored patterns", async () => {
const ownedRoot = await mkdtemp(path.join(tmpdir(), "v8-counter-scope-"));
roots.push(ownedRoot);
let child: { fixtureRoot: string; config: string } | undefined;
await expect(
checkV8CoverageCounterSemantics({
repositoryRoot: process.cwd(),
createOwnedRoot: async () => ownedRoot,
runVitest: async (input) => {
child = {
fixtureRoot: input.fixtureRoot,
config: await readFile(input.configPath, "utf8"),
};
await access(path.join(input.fixtureRoot, "outside-src.ts"));
return { stdout: "", stderr: "" };
},
}),
).rejects.toThrow(/coverage summary is missing/u);
expect(child?.fixtureRoot.startsWith(`${ownedRoot}${path.sep}`)).toBe(true);
expect(path.basename(child?.fixtureRoot ?? "")).toMatch(/[()].*src$/u);
const config = JSON.parse(
(child?.config ?? "").replace(/^export default /u, "").replace(/;\s*$/u, ""),
) as { test: { coverage: { include: string[] } } };
expect(config.test.coverage.include).toEqual(
rootAnchoredGlobs(child?.fixtureRoot ?? "", ["src/**/*.ts"]),
);
});
it("keeps the child fixture outside main Vitest discovery", async () => {
const outputRoot = await mkdtemp(path.join(tmpdir(), "v8-counter-list-"));
roots.push(outputRoot);
+11 -2
View File
@@ -1,7 +1,13 @@
import path from "node:path";
import { fileURLToPath } from "node:url";
import { configDefaults, defineConfig } from "vitest/config";
import { rootAnchoredGlobs } from "./scripts/lib/coverage-scope.ts";
import { isNpmScopeEnvironmentName } from "./scripts/lib/package-script-graph.ts";
const repositoryRoot = path.dirname(fileURLToPath(import.meta.url));
// Tests must not inherit a caller's production React/runtime selection.
// Package scripts also launch Vitest through scripts/run-vitest.ts, which owns
// NODE_ENV before the Vitest process starts. Keeping the config deterministic
@@ -57,8 +63,11 @@ export default defineConfig({
provider: "v8",
reportsDirectory: "artifacts/tests/coverage",
reporter: ["text", "json-summary", "lcov"],
include: ["src/**/*.{ts,tsx}"],
exclude: ["**/*.d.ts", "**/*.stories.*"],
// Vitest matches these against absolute paths anywhere in the path;
// anchoring them at the root keeps a checkout under `…src/` from
// pulling root files into the coverage universe.
include: rootAnchoredGlobs(repositoryRoot, ["src/**/*.{ts,tsx}"]),
exclude: rootAnchoredGlobs(repositoryRoot, ["**/*.d.ts", "**/*.stories.*"]),
},
},
});