refactor(removal): 지울 수 있는 템플릿 기능 목록을 한 모듈에 둔다

문제
템플릿은 지울 수 있는 기능을 둘 둔다. 참조 기능(README)과 예제 화면
기능 platform-examples-feature(starter-experience.md, CHANGELOG 6단계)다.
그 기능이 가진 경로는 제거 드릴의 SAMPLE_EXTRAS에만 있다. 그래서 문서
검사가 "이 경로는 지운 템플릿 기능의 것"을 알 길이 없다(1105/14-01,
14-03). 문서 검사가 따로 목록을 가지면 드릴과 갈라진다.

고른 방법
- scripts/lib/removable-template-features.ts에 두 기능을 적는다. 기능
  ID(= src/features·tests/features 폴더 이름), 혼자 속한 context, 폴더 밖
  전용 파일, 전용 package script.
- 드릴은 참조 기능의 전용 파일·script를 이 모듈에서 읽는다. 목록 내용과
  주석은 그대로 옮겼다. 동작은 바뀌지 않는다.
- 예제 기능 항목은 다음 커밋(1105/14-01)의 문서 검사가 읽는다. 드릴은
  예제 기능을 지금처럼 locateFeature로 찾는다.
- 버린 대안: 문서 검사 안에 목록을 따로 두기. 드릴의 SAMPLE_EXTRAS와 두
  벌이 된다.

위험·한계
- 동작 변경은 없다. 드릴 출력과 지우는 경로가 같다.

검증
- desktop batch에서 확인: corepack pnpm check:types, corepack pnpm lint,
  node scripts/run-vitest.ts run tests/unit/feature-removal-argument.test.ts

Refs: 1105/14-01, 1105/14-03
This commit is contained in:
DongHyeonka
2026-11-06 02:59:02 +09:00
parent c3c595f7a3
commit 50b631e4cd
2 changed files with 74 additions and 17 deletions
+12 -17
View File
@@ -29,6 +29,7 @@ import {
sealRemovalFixtureRepository,
type RemovalCheck,
} from "./lib/removal-fixture.ts";
import { REMOVABLE_TEMPLATE_FEATURES } from "./lib/removable-template-features.ts";
/**
* 09-07 (D-10). Removes one installed feature, `--feature=<id>` (default: the
@@ -49,25 +50,19 @@ type FeatureExtras = Readonly<{
residue: RegExp;
}>;
// The sample's own files and scripts outside its folders are declared with
// the other removable template features, which verify:documentation reads too.
const REFERENCE_SAMPLE = REMOVABLE_TEMPLATE_FEATURES.find(
(feature) => feature.featureId === "reference-feature",
);
if (REFERENCE_SAMPLE === undefined) {
throw new Error("scripts/lib/removable-template-features.ts does not declare reference-feature");
}
const SAMPLE_EXTRAS: Readonly<Record<string, FeatureExtras>> = Object.freeze({
"reference-feature": Object.freeze({
// 0929/10-02. The HTTP scenario catalog (tests/mocks) and the negative
// type fixtures of the feature APIs run on the test contracts, so they are
// platform checks and stay (commonTestPaths below).
paths: [
"tests/component/product-feature-switch.test.tsx",
"tests/e2e/reference-form.spec.ts",
"tests/e2e/reference-route.spec.ts",
"tests/e2e/reference-save.spec.ts",
// 11-04: the growth measurement copies this sample feature.
"tests/unit/feature-shape-growth.test.ts",
"scripts/scale/measure-feature-shape-growth.ts",
"config/scale/feature-shape-growth.json",
"config/scale/feature-shape-ceilings.json",
],
ciScripts: [
"test:reference-feature",
],
paths: REFERENCE_SAMPLE.extraPaths,
ciScripts: REFERENCE_SAMPLE.scripts,
evidencePathFragments: [
"reference-feature.xml",
],