test(layout): R2가 메모리 안 가상 저장소 목록은 이유와 함께 건너뛴다

main이 받은 PR #15의 tests/unit/docs-system.test.ts는 문서 검사기 시험을
위해 메모리 안에 가상 저장소를 만든다. 그 knownPaths 배열(docs,
docs/architecture, docs/architecture/layers.md, src, src/platform)을 R2
검사가 루트 경로 목록으로 잡아, main을 이 브랜치에 합치면 test:unit이
실패한다. 이 목록은 실제 루트 항목을 옮겨도 바뀌지 않으니 등록부 집합으로
고를 것이 아니다.

R2 시험에 MADE_UP_REPOSITORY_LISTS를 두고 파일·목록·이유를 적는다.
- 그 파일의 그 목록만 건너뛰고, 같은 파일의 다른 목록은 그대로 본다.
- 적힌 목록이 그 파일에 더 없으면 실패한다. 그래서 낡은 예외가 뒤에 새
  목록을 덮지 못한다. 제거 drill 사본처럼 그 파일이 검사 대상에 없으면
  보지 않는다.
- 이 커밋에는 아직 그 파일이 없다. 다음 merge 커밋이 main을 합쳐도 모든
  커밋이 시험을 통과하도록 merge 앞에 둔다.
매뉴얼 03 E절 R2 칸과 CHANGELOG 먼저 할 일 15에 이 예외를 적는다.

버린 것:
- docs-system 시험의 배열을 둘로 나누기: 검사를 피하려고 코드 모양을
  바꾸는 것이다.
- 가상 경로를 다른 이름으로 바꾸기: 문서 검사기가 docs/ 경로를 규칙으로
  보므로 시험의 뜻이 바뀐다.
- 집합을 고르게 하기: 가상 저장소가 실제 저장소 배치에 묶인다.

위험: 다운스트림이 같은 꼴의 fixture를 두면 이 목록에 적어야 한다.

검증(desktop): 이 커밋과 다음 merge 커밋에서 test:unit, check:types,
check:ci, lint, verify:documentation. merge 커밋에서 변이 셋을 넣었다. 예외를
지우면 R2 시험이 docs-system 목록을 대며 실패한다. 목록 내용을 바꾸면
바뀐 목록을 대며 실패한다. 목록이 파일에서 없어지면 낡은 예외로 실패한다.
This commit is contained in:
DongHyeonka
2026-11-12 07:00:43 +09:00
parent 414fc2aa4a
commit b96f3b4564
3 changed files with 27 additions and 3 deletions
+1 -1
View File
@@ -70,7 +70,7 @@
12. **CI 계약 기준선을 자기 값으로 다시 기록한 프로젝트는 다시 기록한다.** FE-GATE-003 명령이 25개에서 2개로, FE-GATE-009·028의 수동 a11y 기록 산출물 경로와 id가 바뀌었다. 4단계와 같은 명령이다 (`bf485f44`, `79dc945a`)
13. **CI 계약 기준선 파일이 없어졌다.** `config/ci/contract-baseline.json`, `scripts/update-ci-contract-baseline.ts`, `update:ci-contract-baseline` script를 지웠다(소유자 결정). 위 12단계와 이 절 4단계, 아래 절들의 "기준선을 다시 기록한다"는 이 절까지 받으면 할 일이 없다. 병합에서 자기 기준선 파일이 수정/삭제 충돌이 되면 삭제 쪽을 고른다. 자기 script나 문서가 `update:ci-contract-baseline`을 부르면 지운다 (`f6b2b96c`)
14. **merge 단계 job 이름이 바뀌었다.** 게이트마다 하나이던 행렬 job(`FE-GATE-NNN / <이름>`)이 `merge / static checks`(`merge_static`), `merge / tests`(`merge_test`), `merge / browser tests`(`merge_browser`) 셋이 됐다. 게이트는 job 안의 단계 이름(`FE-GATE-NNN / <이름>`)으로 남는다. Gitea 브랜치 보호의 필수 검사를 옛 job 이름으로 걸었으면 새 job 셋으로 바꾼다. 증거 업로드 이름도 `FE-GATE-NNN-<run>`에서 `merge-static-<run>`·`merge-test-<run>`·`merge-browser-<run>`으로 바뀌었다 (`0739f26b`)
15. **코드에 적은 루트 경로 목록을 등록부 집합으로 바꾼다.** R2 검사가 등록부를 쓰는 7곳이 아니라 추적되는 코드 파일 전체를 본다. 루트 항목(이나 그 안 경로)만 담은 문자열 배열에 추적되는 루트 이름이 둘 이상이면 `tests/unit/repository-layout.test.ts`가 `choose a set from config/repository-layout.json with selectRepositoryPaths`로 실패한다. 템플릿의 19개 목록은 집합 12개로 옮겼다. 자기 목록은 맞는 집합을 고르거나, 없으면 `scripts/lib/repository-layout.ts`의 `REPOSITORY_LAYOUT_SETS`와 등록부 `sets` 설명에 집합을 더해 고른다. 사본이 건너뛰는 `node_modules`·`dist` 같은 추적 안 하는 항목은 종류 `untracked`, `optional: true`로 적는다(매뉴얼 03 E절 R1·R2) (`3f64c689`)
15. **코드에 적은 루트 경로 목록을 등록부 집합으로 바꾼다.** R2 검사가 등록부를 쓰는 7곳이 아니라 추적되는 코드 파일 전체를 본다. 루트 항목(이나 그 안 경로)만 담은 문자열 배열에 추적되는 루트 이름이 둘 이상이면 `tests/unit/repository-layout.test.ts`가 `choose a set from config/repository-layout.json with selectRepositoryPaths`로 실패한다. 템플릿의 19개 목록은 집합 12개로 옮겼다. 자기 목록은 맞는 집합을 고르거나, 없으면 `scripts/lib/repository-layout.ts`의 `REPOSITORY_LAYOUT_SETS`와 등록부 `sets` 설명에 집합을 더해 고른다. 시험이 메모리 안에 만드는 가상 저장소의 경로 목록(실제 루트 항목을 옮겨도 바뀌지 않는 것)은 `tests/unit/repository-layout.test.ts`의 `MADE_UP_REPOSITORY_LISTS`에 파일·목록·이유를 적는다. 사본이 건너뛰는 `node_modules`·`dist` 같은 추적 안 하는 항목은 종류 `untracked`, `optional: true`로 적는다(매뉴얼 03 E절 R1·R2) (`3f64c689`)
16. **샘플을 목록에 둔 프로젝트는 게이트 대상이 샘플 소유가 아닌지 본다.** R5 검사가 문자열 검색 대신 대상의 소유자를 따라간다: goto 경로 → 라우트 표의 기능, workshop story id → stories 파일, spec의 import → 불러오는 파일, 게이트 명령 → package script와 경로 인자, `sourceFeature` → 기능. `config/ci/gates.json`의 수동 a11y 기록이 라우트 표에 없는 라우트를 가리켜도 실패한다(지운 기능의 기록을 남긴 경우) (`1f57c38e`)
#### 옮긴 뒤 확인
+1 -1
View File
@@ -228,7 +228,7 @@ src/features/product-capabilities.ts (SERVICE_WORKER = ACTIVE)
| ID | 규칙 | 검사 |
| --- | --- | --- |
| R1 | 루트 항목은 모두 `config/repository-layout.json`에 있다. 항목마다 종류(source·tool-convention·gate-input·document·history·output), 역할, 읽는 곳을 적는다. 추적하지 않는 항목(`node_modules`, `dist`, 다른 worktree)은 집합이 이름으로 고를 때만 종류 `untracked`, `optional`로 적는다 | `tests/unit/repository-layout.test.ts`(FE-GATE-005). 등록부에 없는 루트 항목이 추적되거나 `untracked` 항목에 추적 파일이 있으면 실패 |
| R2 | 루트 경로 목록은 등록부의 이름 붙은 집합(`sets`, 하위 경로는 `setPaths`)에서 `selectRepositoryPaths(<집합>)`으로만 고른다. 목록을 코드에 새로 적지 않는다. JSON 정책 파일(`config/security/secret-scan-policy.json`)은 그 집합의 사본을 갖고 시험이 같은지 본다 | 같은 시험. 추적되는 코드 파일 전체에서, 루트 항목이나 그 안 경로만 담은 문자열 배열에 추적되는 루트 이름이 둘 이상이면 실패. 인자 목록은 `--` 뒤의 경로만 본다. 집합마다 그것을 고르는 코드가 있어야 한다 |
| R2 | 루트 경로 목록은 등록부의 이름 붙은 집합(`sets`, 하위 경로는 `setPaths`)에서 `selectRepositoryPaths(<집합>)`으로만 고른다. 목록을 코드에 새로 적지 않는다. JSON 정책 파일(`config/security/secret-scan-policy.json`)은 그 집합의 사본을 갖고 시험이 같은지 본다 | 같은 시험. 추적되는 코드 파일 전체에서, 루트 항목이나 그 안 경로만 담은 문자열 배열에 추적되는 루트 이름이 둘 이상이면 실패. 인자 목록은 `--` 뒤의 경로만 본다. 시험이 메모리 안에 만드는 가상 저장소의 목록은 `tests/unit/repository-layout.test.ts`의 `MADE_UP_REPOSITORY_LISTS`에 파일·목록·이유로 적는다. 집합마다 그것을 고르는 코드가 있어야 한다 |
| R3 | 추적 파일은 읽는 곳이 있다. `artifacts/`는 출력 전용이라 `.gitkeep`만 추적한다. 사람이 쓴 기록은 `docs/` 아래에 둔다(수동 a11y 기록은 `docs/accessibility/route-reviews/`) | `tests/unit/tracked-artifacts.test.ts`(FE-GATE-005). `config/` 아래 고아 JSON은 리뷰가 본다 |
| R4 | 템플릿이나 제품이 넣은 샘플 기능은 `scripts/lib/removable-template-features.ts` 목록에 있고, 복사본에서 지우고 빌드·시험하는 drill로 증명한다. 문서 검사만으로는 안 된다 | `tests/unit/example-feature-rules.test.ts`(FE-GATE-005). FE-GATE-020이 `test:sample-removal`을 목록 전체로 도는지 |
| R5 | 게이트의 검사 대상(visual 골든, e2e 라우트, 게이트 증거 목록, 규모 측정)은 플랫폼 화면·시험 fixture·생성기 출력이다. 지울 샘플 기능이 아니다 | 같은 시험. 대상마다 소유자를 따라간다: visual·e2e의 `goto` 경로는 라우트 표로 라우트와 그 기능을, workshop story id는 그 story를 정의한 파일을, spec의 import는 불러오는 파일을(생성기 출력 `src/.generated/`에서 멈춘다), `config/ci/gates.json`의 라우트 기록은 그 라우트를, 게이트 명령은 package script 그래프로 script와 경로 인자를, `config/scale/feature-shape-growth.json`의 `sourceFeature`는 그 기능을. 소유자가 목록의 샘플이거나 라우트 기록의 라우트가 라우트 표에 없으면 실패 |
+25 -1
View File
@@ -109,6 +109,20 @@ const CODE_FILE = /\.(?:[cm]?ts|tsx|[cm]?js)$/u;
/** The sets that only tests in REMOVAL_FIXTURE_DOCUMENT_TESTS read, sorted. */
const DOCUMENT_TEST_SETS = ["agent-harness", "documentation-inputs", "feature-typecheck"];
/**
* Lists that look like root path lists but describe a made-up repository a
* test builds in memory: moving a root item never changes them. Only the exact
* list in that file is excused, and an entry that no longer matches fails, so
* it cannot hide a later list.
*/
const MADE_UP_REPOSITORY_LISTS: readonly Readonly<{ file: string; list: string; reason: string }>[] = [
{
file: "tests/unit/docs-system.test.ts",
list: "docs, docs/architecture, docs/architecture/layers.md, src, src/platform",
reason: "knownPaths of the in-memory repository the docs-system checker test builds",
},
];
const STRING = String.raw`(?:"[^"\n]*"|'[^'\n]*'|` + "`[^`\\n]*`)";
const STRING_ARRAY = new RegExp(String.raw`\[\s*${STRING}(?:\s*,\s*${STRING})+\s*,?\s*\]`, "gu");
@@ -136,10 +150,20 @@ describe("root path lists (R2)", () => {
it("are chosen from the registry everywhere in the code", () => {
const files = trackedFiles().filter((file) => CODE_FILE.test(file) && existsSync(file));
expect(files.length).toBeGreaterThan(100);
const found = files.flatMap((file) => literalRootLists(readFileSync(file, "utf8")).map((list) => ({ file, list })));
const excused = (file: string, list: string) =>
MADE_UP_REPOSITORY_LISTS.some((entry) => entry.file === file && entry.list === list);
expect(
files.flatMap((file) => literalRootLists(readFileSync(file, "utf8")).map((list) => `${file}: [${list}]`)),
found.filter(({ file, list }) => !excused(file, list)).map(({ file, list }) => `${file}: [${list}]`),
`choose a set from ${REPOSITORY_LAYOUT_FILE} with selectRepositoryPaths`,
).toEqual([]);
// A removal drill copy may lack the excused file; an excuse is stale only where the file is checked.
expect(
MADE_UP_REPOSITORY_LISTS.filter(
(entry) => files.includes(entry.file) && !found.some(({ file, list }) => entry.file === file && entry.list === list),
),
"MADE_UP_REPOSITORY_LISTS entries that match no list any more",
).toEqual([]);
});
it("finds a literal root list, also after -- in an argument vector, and nothing else", () => {