fix(scripts): 기능 제거 드릴의 잔여 검사가 이름 단위로 찾고 기능 URL을 여는 브라우저 시험을 센다 #38

Closed
donghyeon.kang wants to merge 0 commits from donghyeon.kang/fix/feature-residue-word-boundary AGit into main
Owner

무엇을, 왜

제품 기능 제거 드릴(test:sample-removal -- --feature=<id>)의 잔여물 검사가 두 방향으로 틀렸다(round9 이월).

  • 1105/16-04: src 경로·본문과 빌드 결과 dist를 기능 ID의 대소문자 무시 부분 문자열로 찾았다. 합법 ID product-feature를 만들고 지우면 템플릿 파일 열 개(product-features.ts 등)와 템플릿 자기 청크(data-product-feature 속성)가 잔여물로 잡혀 드릴이 실패했다.
  • 0925 FOLLOW-UP 09-07: 드릴은 Playwright spec을 돌리지 않는다. 지운 기능을 URL로만 여는 spec(page.goto("/invoices"))은 드릴을 통과하고 그 제품의 FE-GATE-008에서야 깨졌다.

고른 방법과 버린 대안

  • 이름 단위 규칙(featureNamePattern): 대소문자를 가리고 앞뒤에 [A-Za-z0-9_-]가 없을 때만 센다. src 본문과 dist에 같이 쓴다. 경로는 세그먼트가 이름과 같거나 첫 . 앞이 같을 때만 센다. src/.generated/는 기능 목록에서 다시 만드는 파생물이라 뺀다.
  • 드릴이 지우기 전에 지울 route 경로, 남는 route 경로(플랫폼 포함), 지울 route ID(넘겨받은 플랫폼 ID 제외)를 받아 둔다. spec과 Playwright testDir 안의 page object가 지운 route를 여는 문자열을 가지면 잔여물이다. 문자열은 맞는 고정 접두어(첫 매개변수·와일드카드·선택 세그먼트 앞) 중 가장 긴 것이 지운 route일 때만 센다. 같은 context의 형제 기능 경로(/invoice/line)는 세지 않는다. route ID는 src 본문에서 이름 단위로 찾는다.
  • 버린 대안: 「파일 이름이 ID로 시작」(템플릿의 product-feature-* 시험 이름이 걸린다), 드릴 안에서 FE-GATE-008 돌리기(사본 빌드와 세 엔진 실행으로 드릴이 몇 분 늘어나고, 지운 기능을 가리키는 spec은 이름·경로로 먼저 찾을 수 있다), react-router matchRoutes로 모든 문자열 맞추기(드릴 lib가 앱 라우터에 묶이고, 고정 접두어 비교로 같은 판정을 낸다).
  • 넷째 커밋은 PR 전 새 눈 리뷰(정적 읽기)가 찾은 넷을 고친 것이다: 형제 기능 URL 오탐(Medium), 선택 세그먼트·${·page object 누락, 대소문자 구분으로 놓친 route ID(Low).

위험과 영향

  • 여전히 못 찾는 것: 한 단어 ID(search 등)는 템플릿 본문에 보통 낱말로 있어 src에서 잡힐 수 있고, spec에서는 아예 보지 않는다. URL을 조각으로 만드는 spec, 지운 route와 남는 route의 고정 접두어가 같은 URL(/invoice/:id를 지우고 /invoice가 남을 때 /invoice/7)도 세지 않는다(scripts/lib/feature-residue.ts 머리 주석).
  • 다운스트림: 시험 does not count the template's own browser tests for the route paths of a generated feature는 그 repo의 브라우저 시험 전부를 /product 경로로 찾는다. /product를 여는 spec이 있는 제품에서는 이 시험이 실패하니, 그 제품은 시험의 탐침 경로를 자기에게 없는 경로로 바꾼다(기존 common feature IDs 시험과 같은 성격).

검증

  • RED: 16-04 새 시험 2개가 main 구현에서 실패, 09-07 경로 시험 1개가 그 전 커밋에서 실패. 리뷰 반영분은 변이 다섯(남는 route 비교, 선택 세그먼트, ${, testDir 파일, route ID 검색을 하나씩 끔)마다 해당 시험 하나가 실패. GREEN: feature-residue·feature-removal-argument 19개 통과. check:types·eslint rc=0.
  • desktop 드릴(create:feature product-feature 뒤 test:sample-removal -- --feature=product-feature, CI 없이):
    • 고치기 전(첫 커밋만): built-fixture-id-residue: dist/assets/platform-overview-page-*.js로 실패(로그 /tmp/claude-gates/w2fe2-resx3/).
    • 최종 트리, /product를 여는 spec을 둔 사본: fixture-id-residue: residue: tests/e2e/product-smoke.spec.ts로 실패(기대대로).
    • 최종 트리, 그 spec 없이: product-feature removal: PASS (17 checks, no fixture IDs). 363초(두 실행 합). 로그 /tmp/claude-gates/w2fe2-d907c/.

리뷰어가 볼 곳

  • scripts/lib/feature-residue.ts의 featureNamePattern, staticRoutePrefix, opensRemovedRoute(가장 긴 접두어), browserFile.
  • scripts/test-sample-removal.ts의 featureRoutes(지우기 전에 받음)와 builtResiduePattern.

관련

  • round9 리뷰(PR #23) 이월 1105/16-04, 0925 FOLLOW-UP 09-07.
## 무엇을, 왜 제품 기능 제거 드릴(`test:sample-removal -- --feature=<id>`)의 잔여물 검사가 두 방향으로 틀렸다(round9 이월). - 1105/16-04: `src` 경로·본문과 빌드 결과 `dist`를 기능 ID의 대소문자 무시 부분 문자열로 찾았다. 합법 ID `product-feature`를 만들고 지우면 템플릿 파일 열 개(`product-features.ts` 등)와 템플릿 자기 청크(`data-product-feature` 속성)가 잔여물로 잡혀 드릴이 실패했다. - 0925 FOLLOW-UP 09-07: 드릴은 Playwright spec을 돌리지 않는다. 지운 기능을 URL로만 여는 spec(`page.goto("/invoices")`)은 드릴을 통과하고 그 제품의 FE-GATE-008에서야 깨졌다. ## 고른 방법과 버린 대안 - 이름 단위 규칙(`featureNamePattern`): 대소문자를 가리고 앞뒤에 `[A-Za-z0-9_-]`가 없을 때만 센다. `src` 본문과 `dist`에 같이 쓴다. 경로는 세그먼트가 이름과 같거나 첫 `.` 앞이 같을 때만 센다. `src/.generated/`는 기능 목록에서 다시 만드는 파생물이라 뺀다. - 드릴이 지우기 전에 지울 route 경로, 남는 route 경로(플랫폼 포함), 지울 route ID(넘겨받은 플랫폼 ID 제외)를 받아 둔다. spec과 Playwright `testDir` 안의 page object가 지운 route를 여는 문자열을 가지면 잔여물이다. 문자열은 맞는 고정 접두어(첫 매개변수·와일드카드·선택 세그먼트 앞) 중 가장 긴 것이 지운 route일 때만 센다. 같은 context의 형제 기능 경로(`/invoice/line`)는 세지 않는다. route ID는 `src` 본문에서 이름 단위로 찾는다. - 버린 대안: 「파일 이름이 ID로 시작」(템플릿의 `product-feature-*` 시험 이름이 걸린다), 드릴 안에서 FE-GATE-008 돌리기(사본 빌드와 세 엔진 실행으로 드릴이 몇 분 늘어나고, 지운 기능을 가리키는 spec은 이름·경로로 먼저 찾을 수 있다), react-router `matchRoutes`로 모든 문자열 맞추기(드릴 lib가 앱 라우터에 묶이고, 고정 접두어 비교로 같은 판정을 낸다). - 넷째 커밋은 PR 전 새 눈 리뷰(정적 읽기)가 찾은 넷을 고친 것이다: 형제 기능 URL 오탐(Medium), 선택 세그먼트·`${`·page object 누락, 대소문자 구분으로 놓친 route ID(Low). ## 위험과 영향 - 여전히 못 찾는 것: 한 단어 ID(`search` 등)는 템플릿 본문에 보통 낱말로 있어 `src`에서 잡힐 수 있고, spec에서는 아예 보지 않는다. URL을 조각으로 만드는 spec, 지운 route와 남는 route의 고정 접두어가 같은 URL(`/invoice/:id`를 지우고 `/invoice`가 남을 때 `/invoice/7`)도 세지 않는다(`scripts/lib/feature-residue.ts` 머리 주석). - 다운스트림: 시험 `does not count the template's own browser tests for the route paths of a generated feature`는 그 repo의 브라우저 시험 전부를 `/product` 경로로 찾는다. `/product`를 여는 spec이 있는 제품에서는 이 시험이 실패하니, 그 제품은 시험의 탐침 경로를 자기에게 없는 경로로 바꾼다(기존 `common feature IDs` 시험과 같은 성격). ## 검증 - RED: 16-04 새 시험 2개가 main 구현에서 실패, 09-07 경로 시험 1개가 그 전 커밋에서 실패. 리뷰 반영분은 변이 다섯(남는 route 비교, 선택 세그먼트, `${`, testDir 파일, route ID 검색을 하나씩 끔)마다 해당 시험 하나가 실패. GREEN: feature-residue·feature-removal-argument 19개 통과. check:types·eslint rc=0. - desktop 드릴(`create:feature product-feature` 뒤 `test:sample-removal -- --feature=product-feature`, `CI` 없이): - 고치기 전(첫 커밋만): `built-fixture-id-residue: dist/assets/platform-overview-page-*.js`로 실패(로그 `/tmp/claude-gates/w2fe2-resx3/`). - 최종 트리, `/product`를 여는 spec을 둔 사본: `fixture-id-residue: residue: tests/e2e/product-smoke.spec.ts`로 실패(기대대로). - 최종 트리, 그 spec 없이: `product-feature removal: PASS (17 checks, no fixture IDs)`. 363초(두 실행 합). 로그 `/tmp/claude-gates/w2fe2-d907c/`. ## 리뷰어가 볼 곳 - `scripts/lib/feature-residue.ts`의 `featureNamePattern`, `staticRoutePrefix`, `opensRemovedRoute`(가장 긴 접두어), `browserFile`. - `scripts/test-sample-removal.ts`의 `featureRoutes`(지우기 전에 받음)와 `builtResiduePattern`. ## 관련 - round9 리뷰(PR #23) 이월 1105/16-04, 0925 FOLLOW-UP 09-07.
donghyeon.kang added 4 commits 2026-11-12 21:13:25 +00:00
문제: 제거 드릴(`test:sample-removal -- --feature=<id>`)의 잔여물 검사는
`src`의 경로와 본문을 대소문자 무시 부분 문자열로 찾는다. 그래서 합법
ID `product-feature`를 지우면 템플릿 파일 열 개(`product-features.ts`,
`product-features-port.ts`와 그것을 가져오는 파일들)와 템플릿 시험 이름
여섯(`product-feature-switch.test.tsx` 등)이 잔여물로 잡혀 드릴이
실패한다. 매뉴얼 예시 ID `invoice-feature`는 걸리지 않아 남아 있었다.

고른 방법: spec 본문에 이미 쓰는 규칙에 맞춘다. 본문은 이름 단위
(대소문자 구분, 앞뒤에 `[A-Za-z0-9_-]` 없음), 경로는 세그먼트가 이름과
같거나 그 첫 `.` 앞부분이 같을 때만 센다. `src/.generated/`는 기능 목록에서
다시 만드는 파생물이라 뺀다.
- 버린 대안: 「파일 이름이 ID로 시작」. 템플릿의 `product-feature-*` 시험
  이름이 그대로 걸린다.

위험·한계: 한 단어 ID(`search` 등)는 템플릿 본문에 보통 낱말로 있어 여전히
잡힐 수 있다. 본문 규칙으로는 자료와 참조를 가릴 수 없다(spec은 한 단어
이름을 아예 보지 않는다).

검증(desktop): 구현을 main으로 되돌린 상태에서 새 시험 2개 실패(RED),
고친 뒤 feature-residue·feature-removal-argument 11개 통과, eslint·
check:types rc=0. 로그 /tmp/claude-gates/w2fe2-res1/.

Refs: 1105/16-04
문제: 제품 기능 제거 드릴(`test:sample-removal -- --feature=<id>`)은
Playwright spec을 돌리지 않는다. 잔여 검사는 spec 본문에서 하이픈 든
기능 이름만 찾아서, 기능을 URL로만 여는 spec(`page.goto("/invoices")`)은
드릴을 통과하고 그 제품의 FE-GATE-008에서야 깨졌다.

고친 것: 드릴이 지우기 전에 그 기능의 route 경로를 받아 둔다(기능이
넘겨받은 플랫폼 경로는 뺀다). `productFeatureResidue`가 그 경로를 받아,
첫 매개변수 앞까지의 경로로 시작하고 문자열 끝이나 `/`·`?`·`#`가
이어지는 문자열이 있는 spec을 잔여물로 센다. `/`뿐인 경로는 찾지 않는다.

버린 대안: 드릴 안에서 FE-GATE-008을 돌리기. 사본 빌드와 세 엔진 실행이
드릴 시간을 몇 분 늘리고, 지운 기능을 가리키는 spec은 이름·경로로 먼저
찾을 수 있다.

위험·한계: 한 단어 ID만 쓰는 spec, URL을 조각으로 만드는 spec은 여전히
못 찾는다(머리 주석에 적음). vitest 시험 본문은 찾지 않는다(test:all이
돈다). 템플릿 자기 spec은 생성 기능 경로 `/product`로 찾아도 0건이다.

검증(desktop): 새 시험 셋 중 경로 시험이 고치기 전 lib에서 실패(RED 1),
고친 뒤 12개 통과. check:types·eslint rc=0. 로그
/tmp/claude-gates/w2fe2-res907/.

Refs: 0925 FOLLOW-UP 09-07
문제: 앞 커밋으로 `src` 검사는 이름 단위가 됐지만, 빌드한 `dist`는 여전히
기능 ID를 대소문자 무시 부분 문자열로 찾았다. desktop에서
`create:feature product-feature` 뒤 그 기능을 지우는 드릴을 돌리면 `src`
검사는 통과하고 `built-fixture-id-residue`가 템플릿 자기 청크
`platform-overview-page-*.js`(`data-product-feature` 속성)로 실패했다.

고친 것: 이름 단위 규칙을 `featureNamePattern`으로 꺼내 `src` 본문과
빌드 결과에 같이 쓴다.

위험·한계: 빌드 결과에서도 대소문자를 가린다. 기능 ID와 폴더는 소문자
kebab이라 놓치는 경우는 없다고 본다.

검증(desktop): feature-residue·feature-removal-argument 15개 통과,
check:types·eslint rc=0(로그 /tmp/claude-gates/w2fe2-res3/). 고치기 전
드릴 실패는 /tmp/claude-gates/w2fe2-resx3/.

Refs: 1105/16-04
fix(scripts): 제거 드릴의 URL 잔여 검사가 남는 route와 page object를 가린다
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-026 / lab-performance (pull_request) Canceled after 0s
frontend-quality-gates / FE-GATE-028 / manual-accessibility-review (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 / 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 / self-tests and removal drills (pull_request) Canceled after 0s
frontend-quality-gates / external-provenance-provider (pull_request) Canceled after 0s
03744e19cf
문제: 새 눈 리뷰(정적 읽기)가 앞 두 커밋에서 넷을 찾았다.
- 같은 context의 첫 기능은 context 경로(`/invoice`)를, 뒤 기능은 그 아래
  경로(`/invoice/line`)를 받는다. 첫 기능을 지우면 context가 남는데도
  형제 기능 spec의 `"/invoice/line"`이 잔여물로 잡혔다.
- 선택 정적 세그먼트(`/invoice/edit?`)는 접두어가 `/invoice/edit?`가 되어
  아무 URL도 맞지 않았다.
- `` `/invoice${query}` ``와 Playwright `testDir` 안의 page object
  (`tests/e2e/support/*.ts`)는 찾지 않았다.
- `src` 검색이 대소문자를 가리게 되면서, 한 단어 ID(`invoices`)의 옛
  부분 문자열 검색이 잡던 route ID 잔여(`route.INVOICES_LIST.title`)를
  놓쳤다.

고친 것: 드릴이 지우기 전에 지울 route 경로, 남는 route 경로(플랫폼 포함),
지울 route ID(넘겨받은 플랫폼 ID 제외)를 함께 넘긴다. URL 문자열은 맞는
접두어 중 가장 긴 것이 지운 route일 때만 센다(남는 route와 접두어가 같으면
세지 않는다). 접두어는 선택 세그먼트 앞에서 끊고, `${`도 이어짐으로 본다.
`playwright*.config.ts`의 `testDir` 안 파일 중 vitest 시험이 아닌 것도
본다. route ID는 `src` 본문에서 이름 단위로 찾는다.

버린 대안: react-router `matchRoutes`로 모든 문자열을 route 표에 맞추기.
드릴 lib가 앱 라우터에 묶이고, 고정 접두어 비교로 같은 판정을 낸다.

위험·한계: 지운 route와 남는 route의 고정 접두어가 같으면(`/invoice/:id`를
지우고 `/invoice`가 남음) `/invoice/7`을 세지 않는다. 조각으로 만든 URL은
여전히 못 찾는다.

검증(desktop): feature-residue·feature-removal-argument 19개 통과,
check:types·eslint rc=0(로그 /tmp/claude-gates/w2fe2-res4/). 변이 다섯
(남는 route 비교, 선택 세그먼트, `${`, testDir 파일, route ID 검색을 하나씩
끔)마다 해당 시험 하나가 실패했다(로그 /tmp/claude-gates/w2fe2-resmut/).

Refs: 0925 FOLLOW-UP 09-07, 1105/16-04
Author
Owner

#40으로 병합됐다(main ee47480c). 이 PR의 head 03744e19가 #40 브랜치에 merge 커밋으로 들어 있고, #40의 runner merge job 셋이 그 합친 트리로 초록이었다. runner 대기를 줄이려고 이번만 쓴 방식이다(소유자 승인, 2026-11-13).

#40으로 병합됐다(main `ee47480c`). 이 PR의 head `03744e19`가 #40 브랜치에 merge 커밋으로 들어 있고, #40의 runner merge job 셋이 그 합친 트리로 초록이었다. runner 대기를 줄이려고 이번만 쓴 방식이다(소유자 승인, 2026-11-13).
donghyeon.kang closed this pull request 2026-11-12 23:43:47 +00:00

Pull request closed

Please reopen this pull request to perform a merge.
Sign in to join this conversation.
No Reviewers
No labels
1 Participants
Notifications
Due Date
No due date set.
Dependencies

No dependencies set.

Reference: donghyeon.kang/clean-architecture-frontend-template#38