docs(review): 1106 조치의 확인 결과와 diff·마지막 리뷰 처리를 적는다

문제: 리뷰 README 16절에 확인(16.5)이 비어 있다. 그 뒤 diff 리뷰(DR-01~06),
마지막 리뷰(FR-01~05)와 메인 세션 결정 D10 보완·보완 2도 적혀 있지 않다.

고른 방법:
- 16.2절에 D10 보완(`80e7f1d6`)과 보완 2(`b41990cd`) 행을 더한다. 둘 다 메인 세션
  결정이고 사용자가 뒤집을 수 있다고 적는다.
- 16.4절의 다섯 발견 행에 DR·FR 수정 해시를 더한다.
- 16.5절: `5cfc3a65`, `f1734913`, DR 수정, `59b2ccb5`, FR-01 수정에서 돌린 검사와
  돌리지 않은 것을 적는다.
- 16.6절: 해시 대조를 끝 `8b8b6c54` 기준으로 다시 돌린 결과로 바꾼다.
- 16.7절(diff 리뷰): DR-01~05는 고쳤고 DR-06은 이유와 함께 남긴다. DR-02에 메인
  기준보다 하나 더한 규칙(`-`가 든 이름만)과 그 이유, 뒤집는 법을 적는다.
- 16.8절(마지막 리뷰): FR-01은 메인 세션에 먼저 알린 뒤 고쳤다. 등급은 Medium·P2이고,
  리뷰어가 High로 본 이유도 같이 적는다. FR-02는 계약 문서 한 줄과 백엔드 pin grep
  결과를 적는다. FR-03~05는 남긴다.

위험·한계: 이 커밋 자체의 문서 검사 결과는 이 문서에 적을 수 없다. 메인 세션 보고에
적는다. 1~15절은 리뷰 때 그대로다.

검증: desktop batch에서 확인.
bash /tmp/claude-gates/r6/scripts/docs-check.sh
git merge-base --is-ancestor <해시> 8b8b6c54 (16.6절)

Refs: 1106/03-01 (diff review DR-01, final review FR-01·FR-02), 1106/14-02
This commit is contained in:
DongHyeonka
2026-11-06 08:32:45 +09:00
parent 8b8b6c541c
commit 1141969f55
@@ -630,6 +630,8 @@ CLAUDE.md 게이트 목록은 `verify:documentation`을 빼고 모두 merge stag
| D8 | **결정 대기.** 사용자 답을 기다린다 | FE-GATE-013을 멈춤 기준에서 어떻게 셀지는 사용자가 정한다 | — | 사용자가 답할 때 |
| D9 | 초기 JS 예산 206,848 B를 그대로 둔다(1105 D7). 메인 세션 결정, 2026-11-06. 사용자가 뒤집을 수 있다 | 폭의 근거: `bbde570`에서 생성 기능 둘을 더한 드릴(FE-GATE-020)의 실측 205,465 B(CI env, 15 영역)에 기능 하나 상한 1 KiB를 더해 KiB 단위로 올리면 202 KiB = 206,848 B다. 근거와 되돌림 규칙은 `docs/operations/performance-evidence.md`에 적었다(`1eaa6447`) | 필요한 폭으로 다시 내리기. 리뷰 15 영역의 대안 (c) 예산 규칙을 테스트로 고정하기 | D7의 재검토 조건마다 드릴을 다시 잰다. 드릴 실측이 204,800 B 이하면 같은 규칙으로 예산을 내린다 |
| D10 | (a) 결과 불명 상태를 훅에서 지킨다(`25685871`). 메인 세션 결정, 2026-11-06. 사용자가 뒤집을 수 있다 | 같은 키 재전송이 쓰기 전 거절(`NOT_APPLIED`·`NOT_STARTED`)로 끝나도 훅이 결과 불명과 키를 버리지 않는다. 폼 쪽은 (i)를 골랐다. `resendUnknown`이 `unknownSubmissionRef`를 지우지 않고, 새 문구 하나(`form.resendLater`, ko·en)로 "나중에 다시 보내라"고 알린다. 다음 "다시 시도"도 같은 키다. 03-R1 X1~X3·X5의 키가 모두 `key-1`이다(16.5절) | rate-limit 503을 다시 `MAYBE_APPLIED`로 읽기(1105/03-02를 되돌림). 생성 페이지만 고치기(참조 폼과 직접 훅 호출이 그대로 남음) | KEYED를 템플릿 기본으로 바꾸거나 rate limit을 기본으로 켤 때(10절) |
| D10 보완 | 같은 키 재전송의 결과가 첫 요청의 결과를 증명할 때만 결과 불명을 푼다(`80e7f1d6`). 입력 검증 kind로 푸는 부분은 D10 보완 2가 지웠다. 메인 세션 결정, 2026-11-06(diff 리뷰 DR-01 뒤). 사용자가 뒤집을 수 있다 | 푸는 경우: 성공·APPLIED(저장된 답의 재생), 같은 요청이라 첫 요청도 받았을 거절(입력 검증 `VALIDATION_REJECTED`, 400 `VALIDATION_FAILED`, 400 `IDEMPOTENCY_KEY_INVALID`). 남기는 경우: 멱등성 판정보다 앞에서 오거나 시간에 따라 바뀌는 거절(429, 401, 403, 503 `RATE_LIMIT_*`, 보내기 전 `NOT_STARTED`), 422 `IDEMPOTENT_REQUEST_MISMATCH`(키가 이미 서버에 닿아야 나온다), 기능이 선언한 code. 어느 쪽인지 애매하면 남긴다. 남겨도 결과 불명 화면의 확인으로 빠져나갈 수 있고, 테스트가 그것을 고정한다. 판정은 `src/contracts/errors.ts` `isRefusedOnEveryAttempt` 하나를 훅과 폼이 함께 부른다 | 일시 거절(`NOT_STARTED`·retryable·rate limit)만 남기기(diff 리뷰 안. 401·403·422 mismatch·기능 code를 풀어 버린다) | 백엔드 거절 표(`backend-envelope.ts`)에 행이 생길 때. 단위 테스트가 새 행에서 실패해 분류를 정하게 한다 |
| D10 보완 2 | 재전송의 거절이 결과 불명을 푸는 것은 짝 백엔드 표의 code뿐이다(`b41990cd`). 지금은 400 `VALIDATION_FAILED`와 400 `IDEMPOTENCY_KEY_INVALID` 둘이다. 기능 `mapProblem`이 붙인 kind는 믿지 않는다. 메인 세션 결정, 2026-11-06(마지막 리뷰 FR-01 뒤). 사용자가 뒤집을 수 있다 | 기능 code는 상태 규칙일 수 있다. 생성 scaffold는 자기 선언 code를, 참조 기능은 모든 422를 `VALIDATION_REJECTED`로 바꾼다. 그래서 kind로 풀면 기능 선언 code와 422 `IDEMPOTENT_REQUEST_MISMATCH`도 풀렸다. 참조 기능의 422는 이제 남고, 확인 버튼으로 빠져나간다(테스트로 고정). 계약 문서 6.1절에 "`VALIDATION_FAILED`는 요청 내용만 보는 검증이어야 하고, 시간이나 DB를 읽는 규칙은 기능 선언 code로 내보낸다"를 더했다(`6142cc8e`, FR-02) | 기능이 "매번 같은 거절"을 descriptor에 따로 선언하게 하기(계약 타입을 바꾼다) | 짝 백엔드가 `VALIDATION_FAILED`를 내는 검증에 시간·DB를 읽는 규칙을 더할 때 |
| 14-02 | 올린 이력은 고쳐 쓰지 않는다. `287dc6f`는 amend·rebase하지 않는다. 맞는 해시는 1105 README 16.2절 D7 행에 적었다(`ddc6353d`) | 메인 세션 지시 | `287dc6f` 본문 고치기(이미 push한 이력) | — |
해시 대조 도구는 더하지 않았다. 문서 에이전트가 본 비용(`ddc6353d` 본문):
@@ -655,7 +657,7 @@ CLAUDE.md 게이트 목록은 `verify:documentation`을 빼고 모두 merge stag
| ID | 상태 | 커밋 | 남은 것 |
|---|---|---|---|
| 03-01 | 고침(D10) | `25685871` | 재전송이 rate limit에 막힌 동안 결과 불명 화면이 남는다. 폼 밖에서 `submit`을 부른 같은 입력 재저장이 `NOT_APPLIED`로 끝나면 훅은 키를 지키지만 폼은 retry-later를 보인다 |
| 03-01 | 고침(D10, 보완, 보완 2) | `25685871`, `80e7f1d6`(diff 리뷰 DR-01), `b41990cd`(마지막 리뷰 FR-01) | 재전송이 rate limit에 막힌 동안 결과 불명 화면이 남는다. 폼 밖에서 `submit`을 부른 같은 입력 재저장이 `NOT_APPLIED`로 끝나면 훅은 키를 지키지만 폼은 retry-later를 보인다 |
| 14-01 | 고침 | `2f0f2bba` | `as` 단언이 빠진 `responseEnvelope`를 잡지 않는다는 것과 tech-log 관리 쓰기의 지금 거절은 코드로 읽은 추론이다. 문서에도 그렇게 적었다 |
| 01-01 | 일부 · 백엔드로 넘김 | `7395c78c` | `FILE_REJECTED`에 응답 `meta.traceId`가 실린다. 거절 이유는 프론트로 고칠 수 없다. 요청: Fileserver가 REJECT를 422 실패 Envelope(`error.code` = 판정 code)로 답하거나, 202 `REJECTED` 응답에 판정 code 칸을 더한다. 앞의 것이면 `FILE_REJECTED` 분기는 지운다 |
| 02-01 | 고침 | `4cef2a27` | `activateRelease`의 선택 옵션 `replaceUnreadablePointer`다. 켜면 rollback 목록을 잃어 기본값은 꺼짐이다. 1105/02-02의 남은 부분(읽히지 않는 release marker를 stage가 다시 쓰지 않음)은 그대로다 |
@@ -667,19 +669,19 @@ CLAUDE.md 게이트 목록은 `verify:documentation`을 빼고 모두 merge stag
| 06-01 | 고침 | `2a78169c` | redirect하는 호스트로 실제 등록을 돌려 보지 않았다(8절 미검증 그대로) |
| 06-02 | 고침 | `1f4b929f` | 상한을 줄이는 변경은 잡지 않는다(수정 전 test도 잡지 않았다) |
| 07-01 | 고침 | `c6c86dc3` | bulk 지원 여부는 결정 대기(1103/03-02) 그대로다 |
| 07-02 | 고침 | `e7b1b018` | 두 칸 없는 HTTP 행을 가진 다운스트림은 동기화 뒤 `test:unit`이 실패한다 |
| 08-01 | 고침 | `fbaaaee4` | 참조 폼만 해당한다. 생성 작성 폼은 저장이 끝나면 목록으로 옮기므로 (B) 안내가 없다. 브라우저 3엔진 e2e는 더하지 않았다 |
| 07-02 | 고침 | `e7b1b018`, `efe11f15`(DR-04) | 두 칸 없는 HTTP 행을 가진 다운스트림은 동기화 뒤 `test:unit`이 실패한다 |
| 08-01 | 고침 | `fbaaaee4`, `145be2df`(DR-03) | 참조 폼만 해당한다. 생성 작성 폼은 저장이 끝나면 목록으로 옮기므로 (B) 안내가 없다. 브라우저 3엔진 e2e는 더하지 않았다 |
| 08-02 | 고침 | `116cbf3d` | 이미 생성한 기능에는 반영되지 않는다 |
| 08-03 | 고침 | `7625dc45` | 완료 기준(drawer를 연 compact 골든과 스크롤바를 보이게 띄운 Chromium에서 가림막이 390 px까지)을 채웠다. header 띠는 디자인으로 받아들여 `docs/styling/design-system-platform.md` 8.2절에 적었다. `:has()`를 모르는 브라우저는 전처럼 띠가 남는다. Firefox·WebKit은 보지 않았다 |
| 09-01 | 고침 | `06357e9c` | descriptor 없는 쓰기의 ID 오타는 여전히 아무 검사도 잡지 않는다(문서에 적음) |
| 10-01 | 고침 | `a135fa8a` | capability 테스트를 `tests/unit/playwright-capabilities-run-isolation.test.ts`로 옮겼다. 드릴이 그 파일을 이름으로 지운다. 측정 스크립트의 조건은 여전히 소유 기능의 파일 존재다 |
| 11-01 | 고침 | `9c4cddc2` | paramsSchema가 GET 입력과 다른 손 작성 상세 페이지는 규칙이 찾지 못해 기록으로만 정해진다(전과 같다) |
| 11-01 | 고침 | `9c4cddc2`, `95141f1d`(DR-05) | paramsSchema가 GET 입력과 다른 손 작성 상세 페이지는 규칙이 찾지 못해 기록으로만 정해진다(전과 같다) |
| 12-01 | 고침 | `b8535f8c` | 목록 검사는 파일 단위다. 파일 안의 모든 테스트가 문서를 읽는지는 기계로 보지 않는다 |
| 12-02 | 고침 | `68fde027` | FE-GATE-012는 변수 이름을 적고 실패한다(12-R2 `stale-bundle-rc=1`). 같은 모양일 수 있는 `check:app-build-input:bundle`, `check:optional-recipes --require-dist`, release candidate 조립은 보지 않았다 |
| 13-01 | 고침 | `c5ab7a39` | 리뷰 선택지 (b)다. 승인이 거절된 run에도 advisory 기록이 생긴다(13-R1 C). gate 모양 기준선 digest를 다시 적었다. FE-GATE-015가 실패한 run에는 여전히 기록이 없다. 실제 runner의 upload는 미확인이다 |
| 14-02 | 고침 | `ddc6353d` | 완료 기준 "다음 통합 기록에 그 대조 결과가 있다"는 16.6절이다. 새 clone에서 `git show 287dc6f` 본문의 두 해시는 여전히 열리지 않는다 |
| 15-01 | 고침(D9) | `1eaa6447` | 규칙은 문서에만 있다. 예산 값을 규칙 밖으로 바꿔도 실패하는 테스트는 없다 |
| 16-01 | 고침 | `af3344b3` | route ID나 URL만 적은 spec은 여전히 못 잡는다. 1105/16-04의 남은 부분(`product-feature` 거짓 양성 20파일, dist 잔여 검사)은 그대로다 |
| 16-01 | 고침 | `af3344b3`, `eb03dabd`(DR-02) | spec 본문은 `-`가 든 이름만 찾는다(16.7절). 한 단어 ID만 적은 spec과 route ID·URL만 적은 spec은 못 잡는다. 1105/16-04의 남은 부분(`product-feature` 거짓 양성 20파일, dist 잔여 검사)은 그대로다 |
| 1103/15-02 | 고침 | `43ed03d1` | 초기 파일 수 문장이 기록 `config/scale/feature-shape-ceilings.json`의 `initialJavascript.files`를 가리킨다. 상한 32는 예산 값이라 그대로 적었다 |
D10의 폼 쪽, 04-02의 표시, CHANGELOG 위치는 이렇게 정했다.
@@ -690,16 +692,74 @@ D10의 폼 쪽, 04-02의 표시, CHANGELOG 위치는 이렇게 정했다.
### 16.5 확인
(16.5절은 다음 커밋에 적는다.)
desktop 배치(`desktop:/tmp/claude-gates/r6/batch/`)에서 돌렸다. 항목마다 잠금을 잡고 그 커밋을 detached로 checkout했고, 모두 `restore=clean`이다. CI env는 `CI=true`와 빌드 식별 변수(`VITE_COMMIT_SHA` 등)를 준 것이다.
| 시점 | 실행 | 결과 |
|---|---|---|
| `5cfc3a65`(초기 JS 재기록) | FE-GATE-020(CI env) | PASS. 합치기 전 실패하던 `feature-shape-growth` 대조가 통과한다 |
| `f1734913`(CHANGELOG 절과 16절 첫 커밋) | FE-GATE-020(CI env, 1,245초) | PASS |
| | FE-GATE-012(CI env) | PASS |
| | 빠른 검사 10개(`check:types`, `lint`, `check:architecture`, `check:ci`, `check:registries`, `check:diagnostics`, `check:adapter-inventory`, `check:design-system`, `check:i18n`, `check:test-evidence`) | 모두 rc=0 |
| | `test:unit` 3,077 · `test:component` 284 · `test:integration` 214 · `test:contract` 24 · `test:runtime-schema` 60 · `test:visual` 7 | 모두 통과 |
| | `verify:documentation`(옆 백엔드 checkout 있음·없음), 문서 단위 테스트 4개 30건 | PASS_SCOPED 둘, 30 통과 |
| DR 수정(16.7절) | RED: DR-01 14건, DR-02 2건, DR-03 1건 실패. 기대한 테스트에서 기대한 이유로 실패했다. GREEN: 각 145·9·68건과 DR-04 6건, DR-05 10건 통과 | 기대대로 |
| | 변이: DR-04의 `UNREACHED` 건너뛰기 제거 → 새 테스트 1건 실패. 지난 07-02 변이(참조 응답 행의 두 칸 삭제) → 2건 실패. 16-01 spec 본문 변이(`invoice-feature`) → 잔여 `tests/e2e/checkout.spec.ts`를 그대로 잡음 | 모두 잡힘 |
| | 03-R1 실험(DR-01 커밋) | X1~X3 키 `["key-1","key-1","key-1"]`, X5 키 `["key-1","key-1"]`, 다시 저장 뒤 요청 2번 그대로 |
| | 검사 브랜치 끝: 타입·lint·아키텍처, `test:unit` 3,082, 문서 검사. 폼 브랜치 끝: 타입·lint·아키텍처·i18n과 관련 단위 테스트 17건 | 모두 통과 |
| `59b2ccb5`(DR 합친 끝) | 빠른 검사 10개 | 모두 rc=0 |
| | `test:unit` 3,090 · `test:component` 294 · `test:integration` 214 · `test:contract` 24 · `test:runtime-schema` 60 · `tests/features` 126 · `test:visual` 7 | 모두 통과. 초기 JS 기록 대조도 `test:unit` 안에서 통과(허용치 안) |
| | `test:coverage`(CI env) | 4,143 통과, risk coverage 418/418 |
| | FE-GATE-012(CI env), 문서 검사 | PASS, PASS_SCOPED |
| FR-01 수정(16.8절) | RED 4건 실패(scaffold 모양 failure, 422 mismatch, 참조 페이지 422, 다시 마운트한 폼의 422 mismatch). GREEN 149건 통과 | 기대대로 |
| | 03-R1 실험(FR-01 커밋) | DR-01 때와 같다 |
| `57ffcc96`(= `8b8b6c54` 트리) | 타입·lint·아키텍처, `test:unit` 3,090 · `test:component` 296 · `tests/features` 127, `test:coverage` 4,146(risk 418/418), 문서 검사 | 모두 통과 |
돌리지 않은 것:
- DR·FR 수정 뒤의 FE-GATE-020. 메인 세션 지시로 `f1734913`에서만 돌렸다. DR-02가 바꾼 제거 드릴의 잔여 판정은 단위 테스트와 16-01 변이로만 봤다.
- Playwright e2e(FE-GATE-008)와 세 엔진. 폼 동작을 바꿨지만 컴포넌트·기능 테스트로만 봤다.
- merge 게이트 14개. 최종 head에서 메인 세션이 돈다.
- 이 README 커밋 자체. 문서 검사만 돌린다. 결과는 이 문서에 적을 수 없어서 메인 세션 보고에 적는다.
### 16.6 해시 대조 (1106/14-02 완료 기준)
CHANGELOG 머리말의 단계대로 `git merge-base --is-ancestor <해시> 9b19f753`(CHANGELOG 절을 합친 커밋)을 하나씩 돌렸다. 2026-11-06, 노트북 worktree.
CHANGELOG 머리말의 단계대로 `git merge-base --is-ancestor <해시> 8b8b6c54`(코드 쪽 마지막 커밋, 이 README 커밋의 부모)를 하나씩 돌렸다. 2026-11-06, 노트북 worktree. 처음에는 CHANGELOG 절을 합친 `9b19f753`에서 돌렸고, DR·FR 수정을 합친 뒤 다시 돌렸다. 아래는 다시 돌린 결과다.
| 대상 | 해시 | 결과 |
|---|---|---|
| CHANGELOG 새 절 | 29개 | 모두 조상이다. 28개는 기준점 `bbde570` 뒤 범위 안이다(리뷰 기록 `302d3a5` 포함). 나머지 1개는 기준점 `bbde570`이다 |
| 범위 커밋 본문(`302d3a5..9b19f753`, merge 포함) | 7~12자리 16진 문자열 17개 | 이 repo 커밋 14개(`05330e3`, `06357e9`, `0fee3fe`, `287dc6f`, `2f0f2bb`, `302d3a5`, `409d72e`, `56272e8`, `5c0b37e`, `5cfc3a65`, `bbde570`, `c6c37f3`, `ce191be`, `f849d78`)는 모두 조상이다. 셋은 이 repo 커밋이 아니다: `45d2a478`(백엔드 pin), `d3810a0`(memento-frontend), `7bebafe6`(바꾸기 전 CI 기준선 digest 앞자리) |
| CHANGELOG 새 절 | 36개 | 모두 조상이다. 35개는 기준점 `bbde570` 뒤 범위 안이다(리뷰 기록 `302d3a5` 포함). 나머지 1개는 기준점 `bbde570`이다 |
| 범위 커밋 본문(`302d3a5..8b8b6c54`, merge 포함) | 7~12자리 16진 문자열 29개 | 이 repo 커밋 26개는 모두 조상이다(DR·FR 수정이 인용한 `80e7f1d`, `145be2d`, `eb03dab`, `efe11f1`, `95141f1`, `b41990c`, `6142cc8`, `9b19f753` 등 포함). 셋은 이 repo 커밋이 아니다: `45d2a478`(백엔드 pin), `d3810a0`(memento-frontend), `7bebafe6`(바꾸기 전 CI 기준선 digest 앞자리) |
| 1105 README 16.2절 D7 행 | `5c0b37e`, `f849d78` | 둘 다 조상이다 |
| 이 README 16절 | 59개 | 54개는 조상이다. 다섯은 닿지 않는 것이 맞다: 위 셋, 그리고 아래 `287dc6f` 본문의 두 해시 |
`287dc6f` 본문의 두 해시(`ab0d4a1`, `7ce9bf1`)는 여전히 닿지 않는다. 올린 이력이라 고치지 않는다(16.2절).
### 16.7 diff 리뷰 (`302d3a5..f1734913`)
메인 세션 지시대로 맥락 없는 서브에이전트 하나가 이 라운드의 diff만 읽고 리뷰했다. 코드는 실행하지 않았다(E1). 새 High·P1 후보는 없다. Medium 2건은 이 라운드 수정이 만든 회귀다. 오케스트레이터가 코드에서 다시 확인했다. 메인 세션이 그 둘은 고치고, Low는 작으면 고치라고 정했다.
| ID | 심각도·우선순위 | 내용 | 처리 |
|---|---|---|---|
| DR-01 | Medium·P2 | 03-01·03-03이 같은 키 재전송의 모든 `NOT_APPLIED`를 결과 불명으로 잡아 둔다. 결정적 거절(400 `VALIDATION_FAILED` 등)이면 저장이 꺼지고, 다시 보내도 같은 400이 온다. 출구는 사실이 아닌 "변경됨으로 확인"이나 새로고침뿐이다 | 고침 `80e7f1d6`. 16.2절 D10 보완. 400으로 끝나는 재전송은 필드 오류를 보이고, 고친 값은 새 키로 다시 받는다. 남기는 경우에도 확인 버튼이 화면에 있다(테스트로 고정). 기능이 선언한 결정적 거절(생성 기능의 400 `<FEATURE>_INVALID`)은 어느 쪽인지 알 수 없어 남기고, 출구는 확인이다(CHANGELOG 알려진 제한). 이 커밋에서는 그 code가 kind 때문에 풀렸다. 실제로 남게 된 것은 16.8절 FR-01 수정 뒤다 |
| DR-02 | Medium·P2 | 16-01의 spec 본문 검색이 대소문자를 무시하고 `_`를 경계로 본다. `messages`·`status` 같은 흔한 ID를 지우면 템플릿 자신의 spec이 잔여로 잡혀 드릴이 실패한다 | 고침 `eb03dabd`. 메인 세션 기준대로 적힌 그대로(대소문자 구분) 찾고, 경계는 `[A-Za-z0-9_-]`다. **기준에 하나를 더했다.** 그 둘만으로는 `status`·`reports`가 0건이 되지 않는다. 템플릿 spec이 `status: 200`, `getByRole("status")`, 테스트 제목의 "reports"를 쓴다. 그래서 spec 본문은 `-`가 든 이름만 찾는다. 이 기준은 오케스트레이터가 수정 에이전트에 `status`·`reports`도 0건이어야 한다고 지시해서 생겼다. 대가로 한 단어 ID만 본문에 적은 spec은 못 잡는다. 1106/16-01 전(`bbde570`, spec 본문을 보지 않음)보다 좁지는 않다. 메인 세션이 뒤집을 수 있다. 뒤집으면 `scripts/lib/feature-residue.ts`의 `-` 필터 한 줄을 지우고, 흔한 한 단어 ID의 거짓 양성을 알려진 제한으로 둔다 |
| DR-03 | Low·P3 | 08-01 뒤 다시 마운트한 폼에서 "변경됨으로 확인"을 누르면, 보낸 적 없는 지금 입력을 저장됨으로 두고 지운다 | 고침 `145be2df`. 제출한 값이 없으면 결과 표시와 포커스 이동만 한다. 08-01 완료 기준 테스트는 그대로 통과해야 한다 |
| DR-04 | Low·P3 | 07-02 뒤 탐침이 닿지 않는 스키마(`UNREACHED`, 객체가 아닌 페이로드)는 행을 어떻게 적어도 정책 검사를 통과할 수 없다(추론, 다운스트림 쪽) | 고침 `efe11f15`. `UNREACHED`면 정책 비교만 빼고 `direction`은 계속 요구한다. 07-02 전에는 이 경우를 통째로 건너뛰었으므로 약화가 아니다. 탐침은 이 스키마를 판정할 수 없다. 남은 것: `strictObject \| null` 같은 합집합도 `UNREACHED`가 되어 정책 비교에서 빠질 수 있다(커밋 본문, 추론) |
| DR-05 | Low·P3 | 11-01 규칙은 `paramsSchema`만 보고 기록을 기대한다. 같은 스키마를 쓰지만 그 GET을 부르지 않는 라우트는 FE-GATE-009가 거짓 실패하고, `errors.md`의 고칠 곳 안내가 틀린다(추론) | 고침 `95141f1d`(문서). `errors.md`·매뉴얼 01·report 실패 문장에 "그 GET을 부르지 않는 라우트는 자기 `paramsSchema`를 둔다"를 더했다. report 판정은 그대로다 |
| DR-06 | Low·P3 | 04-02 커밋(`6f06e770`)에 `!`·`BREAKING CHANGE:`가 없는데 CHANGELOG는 BREAKING으로 적는다 | **남김.** 커밋 메시지를 고치려면 이미 합친 merge들을 다시 쌓아야 한다. BREAKING은 CHANGELOG 새 절과 16.4절 끝 목록에 적혀 있다. PR 본문에도 같은 줄을 둔다(메인 세션 몫) |
수정은 `f1734913` 위의 두 브랜치(`fix/r1106-dr-forms`, `fix/r1106-dr-checks`)에서 했고 `591dd31a`·`3abe28e5`로 합쳤다. 두 브랜치가 CHANGELOG 같은 줄 근처를 고쳐 둘째 merge에서 충돌했다. 충돌한 9쌍은 모두 한쪽만 바뀐 줄이라, 바뀐 쪽을 골랐다. 합친 결과는 두 브랜치가 CHANGELOG에서 바꾼 줄(5줄, 6줄)을 모두 담는다(11줄). 검사 브랜치가 비워 둔 CHANGELOG 커밋 칸 셋은 `59b2ccb5`가 채웠다.
### 16.8 마지막 리뷰 (`f1734913..59b2ccb5`)
DR 수정 커밋만 맥락 없는 서브에이전트 하나가 다시 읽었다. 코드는 실행하지 않았다(E1). 메인 세션 지시는 둘이었다. High·P1이 나오면 고치기 전에 알린다. Medium·Low는 고치지 않고 여기 적는다.
| ID | 리뷰어 등급 → 최종 | 내용 | 처리 |
|---|---|---|---|
| FR-01 | High·P1 → **Medium·P2** | DR-01 수정(`80e7f1d6`)의 `isRefusedOnEveryAttempt`가 `kind === "VALIDATION_REJECTED"`면 code를 보지 않고 결과 불명을 푼다. 이 kind는 기능 `mapProblem`이 붙인다. 생성 scaffold는 선언 code `<FEATURE>_INVALID`를, 참조 기능은 모든 422를 이 kind로 바꾼다. 그래서 함수 주석·CHANGELOG·런북이 남긴다고 적은 기능 선언 code와 422 `IDEMPOTENT_REQUEST_MISMATCH`가 풀렸다. 테스트는 `mapProblem`을 거치지 않은 failure로만 검사했다 | **고침** `b41990cd`(16.2절 D10 보완 2). 오케스트레이터가 고치기 전에 메인 세션에 알렸고, 메인 세션이 `errors.ts:273`을 직접 확인했다. 등급: 같은 길인 03-01과 같이 Medium·P2다. 규칙 위반은 코드로 확인했다(E1). 중복 쓰기 피해가 나려면 다운스트림의 상태 규칙(이름 중복 등)이 멱등성 재생보다 먼저 돌아야 한다(추론). 리뷰어는 가이드 35.2의 "결과 불명 작업의 무방비 재실행"으로 High를 줬다. 테스트: scaffold 모양 failure와 422 mismatch는 남긴다. 참조 페이지의 422 재전송은 남기고 확인 버튼을 보인다. 다시 마운트한 폼에서 다른 값으로 보이는 재전송이 422 mismatch를 받아도 남긴다(FR-03과 이어지는 길) |
| FR-02 | Medium·P2 | 400 `VALIDATION_FAILED`를 "매 시도가 받는 거절"로 보는 전제가, 시간이나 DB를 읽는 검증에서 깨진다(추론) | 코드는 고치지 않았다. 계약 문서 6.1절에 규칙 한 문장을 더했다(`6142cc8e`). 짝 백엔드 pin `45d2a478`을 grep했다. `VALIDATION_FAILED`는 `GlobalExceptionHandler`의 Bean Validation 세 갈래, 읽을 수 없는 본문, 페이지 파라미터에서만 나온다. main 소스와 생성기 템플릿에 `@Future`·`@Past`나 직접 만든 `ConstraintValidator`가 없다. 백엔드로 넘길 것은 없다. 다운스트림이 그런 검증을 더하면 전제가 깨진다(계약 문서 규칙) |
| FR-03 | Medium·P2 | 다시 마운트한 폼에서 "같은 요청으로 다시 보내기"는 보내지 않은 화면 값을 제출한 값으로 쓴다(`use-app-form.ts:425`). 실제로 다시 보내는 것은 코디네이터가 보관한 원래 입력이다. 서버 데이터는 바뀌지 않지만, 입력이 지워지거나 이탈 확인이 꺼질 수 있다 | **남김.** 메인 세션 지시. 이 길에서 422가 결과 불명을 풀던 것은 FR-01 수정이 막았다 |
| FR-04 | Low·P3 | DR-02가 한 단어 ID를 spec 본문 검색에서 뺐지만, `src` 부분 문자열 검색(1105/16-04 남은 부분) 때문에 그런 ID의 드릴은 여전히 실패할 수 있다. 탐지만 줄었다 | **남김.** 1105/16-04의 남은 부분과 같은 원인이다 |
| FR-05 | Low·P3 | DR-04의 `UNREACHED` 제외가 루트 union(`strictObject \| null` 등)까지 덮는다. 문서는 "객체가 아닌 본문"만 적는다. 그런 행에 적은 정책 값은 아무도 검사하지 않는다 | **남김.** 템플릿 안에는 해당 스키마가 없다 |
FR-01 수정 뒤에는 diff 리뷰를 다시 하지 않았다(메인 세션 지시). 이 수정은 결과 불명을 푸는 경우를 줄이기만 한다. 빠져나가는 길(확인 버튼)은 테스트가 고정한다.