DongHyeonka
f13ed7bea7
fix(docs): verify:documentation이 실패한 검사와 고칠 파일을 적는다 (1101/14-06)
...
문제
verify-documentation-readiness.ts는 실패 원인과 상관없이 마지막에
"FAIL_UNVERIFIED (canonical scoped-review evidence is incomplete)"를
적는다. stderr에 따로 적는 것은 README 빌드 변수 누락뿐이다. 기능을
더해 route가 늘었는데 README나 접근성 체크리스트에 route ID를 안 적으면,
개발자는 diagram 리뷰 기록을 먼저 의심하고 산출물 JSON을 열어야 원인을
안다.
고른 방법
- 검사 네 개(route scope, runtime variables, review report digest,
diagram reviews)의 실패를 failedChecks로 모으고 passed는 그것이 비었는지로
정한다. 판정 조건은 그대로다.
- 실패하면 검사마다 고칠 곳을 stderr에 적는다. route scope는 문서별로
빠진 route ID, diagram review는 어느 diagram이 증거 문서에 PASS로 없는지.
- 마지막 줄은 "FAIL_UNVERIFIED (failed: <검사 이름들>)"이다. 판정 토큰은
그대로 둬서 이 줄을 읽는 쪽이 바뀌지 않는다.
버린 대안
- route ID 누락만 따로 적기(리뷰의 최소 방향): 다음에 다른 검사가 실패해도
같은 엉뚱한 문구가 나온다. 검사 네 개 모두 같은 방식으로 적어도 몇 줄이다.
위험·한계
- diagram review 실패는 어느 하위 조건(경로·digest·점수)인지까지는 적지
않는다. 산출물 JSON의 results에 그대로 있다.
검증
- RED: node scripts/run-vitest.ts run tests/unit/documentation-readiness.test.ts
2 failed. README에서 `EXAMPLES_PLATFORM`을 지운 사본에서 stderr가
"Documentation readiness: FAIL_UNVERIF…"뿐이라 "README.md does not name
route IDs: EXAMPLES_PLATFORM"이 없다. 두 검사 실패 때도 실패 이름이 없다
- GREEN: 같은 파일 3 passed(원본 사본 PASS, route 하나 누락,
route+변수 누락)
- 실제 repo에서 verify-documentation-readiness PASS_SCOPED
- eslint, tsc(node, test), check-ci-contract PASS
Refs: docs/reviews/2026-11-01-maturity-review/14-template-product-docs.md 14-06
2026-11-01 22:49:13 +09:00
..
2026-11-01 21:57:53 +09:00
2026-09-27 13:32:33 +09:00
2026-11-01 19:11:24 +09:00
2026-09-24 15:33:13 +09:00
2026-11-01 22:35:54 +09:00
2026-09-24 00:42:21 +09:00
2026-09-25 22:37:21 +09:00
2026-09-25 22:49:32 +09:00
2026-09-25 22:58:37 +09:00
2026-09-24 16:25:22 +09:00
2026-11-01 22:35:54 +09:00
2026-09-24 00:42:21 +09:00
2026-09-24 00:42:21 +09:00
2026-09-26 00:29:34 +09:00
2026-09-26 00:29:34 +09:00
2026-09-26 00:29:34 +09:00
2026-09-24 00:42:21 +09:00
2026-09-26 00:08:33 +09:00
2026-11-01 22:25:41 +09:00
2026-09-24 00:42:21 +09:00
2026-09-25 22:35:54 +09:00
2026-09-24 00:42:21 +09:00
2026-09-24 00:42:21 +09:00
2026-09-25 22:54:40 +09:00
2026-11-01 22:49:13 +09:00
2026-09-24 00:42:21 +09:00
2026-09-24 13:58:35 +09:00
2026-09-24 00:42:21 +09:00
2026-09-27 14:25:53 +09:00
2026-09-24 00:42:21 +09:00
2026-09-26 00:04:25 +09:00
2026-09-24 13:41:45 +09:00
2026-09-24 13:45:37 +09:00
2026-09-24 00:42:21 +09:00
2026-09-24 13:45:37 +09:00
2026-09-24 13:45:37 +09:00
2026-11-01 22:35:54 +09:00
2026-09-26 00:29:34 +09:00
2026-09-24 13:41:45 +09:00
2026-09-27 14:03:03 +09:00
2026-11-01 22:49:13 +09:00
2026-09-24 00:42:21 +09:00
2026-11-01 22:16:26 +09:00
2026-09-24 00:42:21 +09:00
2026-09-25 22:52:33 +09:00
2026-11-01 22:49:13 +09:00
2026-09-26 00:16:55 +09:00
2026-11-01 22:35:54 +09:00
2026-09-25 23:25:24 +09:00
2026-09-25 23:10:19 +09:00
2026-11-01 21:57:53 +09:00
2026-09-24 00:42:21 +09:00
2026-09-27 13:20:12 +09:00
2026-11-01 22:49:13 +09:00
2026-09-24 12:25:01 +09:00
2026-09-25 22:56:22 +09:00
2026-11-01 22:35:54 +09:00
2026-09-24 00:42:21 +09:00
2026-09-24 00:42:21 +09:00
2026-09-25 23:58:52 +09:00
2026-09-24 13:32:37 +09:00
2026-09-24 00:42:21 +09:00
2026-09-25 22:44:32 +09:00
2026-09-24 00:42:21 +09:00
2026-09-25 22:57:51 +09:00
2026-09-25 22:33:44 +09:00
2026-09-25 22:37:40 +09:00
2026-09-25 22:52:29 +09:00
2026-09-24 13:30:26 +09:00
2026-09-25 21:18:39 +09:00
2026-09-24 00:42:21 +09:00
2026-09-27 13:14:03 +09:00
2026-09-24 12:19:48 +09:00
2026-09-25 23:00:43 +09:00
2026-09-24 00:42:21 +09:00
2026-09-25 22:07:53 +09:00
2026-09-25 22:18:00 +09:00
2026-09-24 00:42:21 +09:00
2026-09-25 21:18:39 +09:00
2026-11-01 22:16:26 +09:00
2026-09-27 13:32:33 +09:00
2026-11-01 22:25:41 +09:00
2026-09-24 00:42:21 +09:00
2026-09-26 00:26:54 +09:00
2026-09-24 13:58:35 +09:00
2026-09-27 13:32:33 +09:00
2026-09-27 13:47:35 +09:00
2026-09-25 22:25:44 +09:00
2026-09-27 13:47:35 +09:00
2026-09-27 13:32:33 +09:00
2026-11-01 21:57:53 +09:00
2026-09-24 00:42:21 +09:00
2026-11-01 22:16:26 +09:00
2026-11-01 21:57:53 +09:00
2026-09-24 00:42:21 +09:00
2026-11-01 20:50:00 +09:00
2026-09-24 13:39:59 +09:00
2026-09-24 00:42:21 +09:00
2026-09-24 00:42:21 +09:00
2026-09-26 00:26:17 +09:00
2026-09-24 00:42:21 +09:00
2026-09-24 00:42:21 +09:00
2026-09-24 00:42:21 +09:00
2026-09-24 00:42:21 +09:00
2026-11-01 22:35:54 +09:00
2026-11-01 22:35:54 +09:00
2026-09-25 23:19:41 +09:00
2026-09-25 22:15:59 +09:00
2026-09-25 23:19:09 +09:00
2026-09-27 13:16:31 +09:00
2026-09-24 12:25:01 +09:00
2026-09-24 13:45:37 +09:00
2026-09-26 00:36:49 +09:00
2026-09-25 22:36:00 +09:00
2026-09-24 00:42:21 +09:00
2026-09-25 22:22:27 +09:00
2026-09-25 22:25:44 +09:00
2026-09-25 22:40:12 +09:00
2026-09-24 11:55:57 +09:00
2026-09-27 13:32:33 +09:00
2026-09-24 15:16:56 +09:00
2026-09-24 00:42:21 +09:00
2026-09-24 00:42:21 +09:00
2026-11-01 21:57:53 +09:00
2026-09-24 00:42:21 +09:00
2026-09-25 22:58:37 +09:00
2026-11-01 22:42:44 +09:00
2026-11-01 21:57:53 +09:00
2026-09-24 00:42:21 +09:00
2026-11-01 21:57:53 +09:00
2026-09-24 00:42:21 +09:00
2026-09-24 00:42:21 +09:00
2026-09-27 13:32:33 +09:00
2026-09-24 00:42:21 +09:00
2026-09-24 16:25:22 +09:00
2026-09-27 12:57:41 +09:00
2026-11-01 19:02:57 +09:00
2026-09-26 01:01:47 +09:00
2026-09-27 13:32:33 +09:00
2026-09-24 00:42:21 +09:00
2026-11-01 22:25:41 +09:00
2026-09-25 22:38:34 +09:00
2026-09-25 21:34:12 +09:00
2026-09-24 00:42:21 +09:00
2026-11-01 22:42:44 +09:00
2026-09-25 21:34:12 +09:00
2026-09-25 22:46:31 +09:00
2026-09-26 01:01:49 +09:00
2026-09-26 00:22:16 +09:00
2026-11-01 21:57:53 +09:00
2026-09-24 00:42:21 +09:00
2026-11-01 22:16:26 +09:00
2026-09-25 22:23:01 +09:00
2026-09-24 00:42:21 +09:00
2026-09-24 00:42:21 +09:00
2026-09-24 00:42:21 +09:00
2026-09-25 23:19:41 +09:00
2026-09-24 13:54:42 +09:00
2026-09-24 00:42:21 +09:00
2026-09-24 00:42:21 +09:00
2026-09-24 00:42:21 +09:00
2026-09-26 00:32:19 +09:00
2026-09-26 01:06:48 +09:00