DongHyeonka
fc95672ad5
fix(docs): 문서 검사가 짝 백엔드 참조를 pin 커밋의 트리에서 찾는다
...
문제
verify:documentation(FE-GATE-017)은 짝 백엔드 경로·링크를 옆 checkout의
작업 트리에서 찾았다. 그래서 같은 커밋이 놓인 곳마다 결과가 달랐다. desktop은
옆 checkout이 ef947e5(9월)에 미커밋 변경까지 있어 문서와 무관하게 rc=1,
짝이 없는 worktree는 PASS(17개 미확인)였다. 옆 checkout이 pin보다 새로우면
pin에 없는 파일을 적어도 통과하고, 저장소 이름을 틀린 `../` 링크는
"확인 못 함"으로 통과했다. config/contracts/backend-contract-pin.json은 읽지
않았다.
고른 방법
- 짝 저장소 목록과 기준 커밋을 pin 파일에서 읽는다. pin은 문서와 같이
작업 디렉터리에서 읽는다(문서가 어느 커밋을 설명하는지 적은 파일이라서).
- 옆 checkout에 pin 커밋이 있으면 `git ls-tree -r -t <pin>`으로 그 커밋의
트리(파일과 폴더)를 한 번 읽어 찾는다. 작업 트리와 HEAD는 보지 않는다.
hook이 넘긴 GIT_DIR 같은 GIT_* 변수는 지우고 git을 부른다.
- checkout이 없거나, pin 커밋이 없거나, git이 읽지 못하면 실패 대신
unverifiedLinks로 남기고, 출력에 이유(짝 HEAD, pin 앞 12자)를 적는다.
- `../`로 나가는 링크의 첫 폴더가 pin에 없는 저장소면 missingPaths로 실패한다.
실패하면 "pin 커밋에서 찾았다"는 줄을 stderr에 하나 더 적는다.
- 버린 대안: 짝 HEAD가 pin과 다르면 전부 unverified(리뷰 (c)). 더 단순하지만
pin 뒤로 앞서 있는 흔한 checkout에서 아무것도 확인하지 못한다. 경로마다
`git cat-file -e`: 같은 결과지만 참조 수만큼 프로세스를 띄운다.
위험·한계
- pin 커밋을 fetch하지 않은 checkout(desktop 지금 상태)에서는 짝 참조가 전부
"not verified"다. 실패하지 않는 대신 확인도 하지 않는다.
- 짝 저장소는 여전히 하나(pin 파일의 backend)다. 둘째 짝이 생기면 pin 모양부터
바꿔야 한다.
- pin 파일이 없으면 짝 저장소가 없는 것으로 보고 `../` 링크를 전부 실패로 센다.
- 보고서 schema는 그대로다(unverifiedLinks 주석만 고침).
검증
- desktop batch에서 확인: node scripts/run-vitest.ts run
tests/unit/documentation-readiness.test.ts, 그리고 corepack pnpm
verify:documentation(옆 짝이 ef947e5인 desktop에서 PASS_SCOPED +
not verified 기대).
- RED 기대: "looks a reference up in the pinned commit, not in a later HEAD or
the working tree", "reports the references as not verified when the
checkout does not have the pinned commit", "fails a link out of the
repository into a repository that is not paired".
Refs: 1105/12-02
2026-11-05 22:29:19 +09:00
..
2026-11-05 22:12:30 +09:00
2026-11-03 00:55:33 +09:00
2026-11-04 21:28:13 +09:00
2026-11-04 22:59:03 +09:00
2026-09-24 15:33:13 +09:00
2026-11-04 22:56:52 +09:00
2026-11-01 23:44:29 +09:00
2026-11-04 21:10:19 +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-04 21:03:40 +09:00
2026-11-04 20:38:12 +09:00
2026-11-03 21:12:34 +09:00
2026-09-24 00:42:21 +09:00
2026-11-04 20:59:25 +09:00
2026-11-04 20:59:25 +09:00
2026-09-26 00:29:34 +09:00
2026-11-04 21:18:51 +09:00
2026-11-01 23:14:47 +09:00
2026-11-01 22:25:41 +09:00
2026-09-24 00:42:21 +09:00
2026-11-04 20:25:48 +09:00
2026-09-24 00:42:21 +09:00
2026-11-04 20:22:27 +09:00
2026-09-25 22:54:40 +09:00
2026-11-01 22:49:13 +09:00
2026-11-04 20:22:27 +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-11-05 22:12:30 +09:00
2026-09-24 00:42:21 +09:00
2026-11-04 22:59:48 +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-11-03 00:55:33 +09:00
2026-11-03 21:37:48 +09:00
2026-09-24 13:45:37 +09:00
2026-11-03 00:55:33 +09:00
2026-11-04 20:22:13 +09:00
2026-11-04 23:42:00 +09:00
2026-11-01 23:14:47 +09:00
2026-09-24 13:41:45 +09:00
2026-11-03 07:17:49 +09:00
2026-11-04 22:50:22 +09:00
2026-11-03 06:52:43 +09:00
2026-09-24 00:42:21 +09:00
2026-11-03 01:24:31 +09:00
2026-11-03 01:24:31 +09:00
2026-11-05 03:30:56 +09:00
2026-09-24 00:42:21 +09:00
2026-09-25 22:52:33 +09:00
2026-11-05 22:29:19 +09:00
2026-11-04 20:28:49 +09:00
2026-09-26 00:16:55 +09:00
2026-11-04 22:56:52 +09:00
2026-11-04 20:30:47 +09:00
2026-09-25 23:10:19 +09:00
2026-11-04 21:31:16 +09:00
2026-11-04 20:34:39 +09:00
2026-09-24 00:42:21 +09:00
2026-09-27 13:20:12 +09:00
2026-11-05 01:26:27 +09:00
2026-09-24 12:25:01 +09:00
2026-11-04 20:57:17 +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-11-01 23:14:47 +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-11-04 20:38:17 +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-11-03 02:00:45 +09:00
2026-11-05 04:26:44 +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-11-04 22:34:58 +09:00
2026-11-01 23:18:45 +09:00
2026-11-04 20:54:24 +09:00
2026-11-01 22:16:26 +09:00
2026-11-04 20:29:34 +09:00
2026-11-04 20:56:03 +09:00
2026-09-24 00:42:21 +09:00
2026-11-01 22:56:29 +09:00
2026-11-04 20:22:27 +09:00
2026-11-04 22:28:30 +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-04 20:48:50 +09:00
2026-11-03 20:23:14 +09:00
2026-11-05 22:05:52 +09:00
2026-11-05 03:30:56 +09:00
2026-11-03 01:52:18 +09:00
2026-11-01 22:16:26 +09:00
2026-11-04 20:35:11 +09:00
2026-11-04 20:46:40 +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-11-04 21:00:22 +09:00
2026-09-24 00:42:21 +09:00
2026-11-04 21:01:49 +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-03 01:50:12 +09:00
2026-11-04 20:38:14 +09:00
2026-09-25 23:19:41 +09:00
2026-11-04 20:30:47 +09:00
2026-11-04 21:31:16 +09:00
2026-09-27 13:16:31 +09:00
2026-11-04 20:19:33 +09:00
2026-09-26 00:36:49 +09:00
2026-11-04 20:20:51 +09:00
2026-11-01 23:14:47 +09:00
2026-11-01 23:14:48 +09:00
2026-09-25 22:25:44 +09:00
2026-11-04 20:59:31 +09:00
2026-09-24 11:55:57 +09:00
2026-09-27 13:32:33 +09:00
2026-09-24 00:42:21 +09:00
2026-11-03 21:12:34 +09:00
2026-11-01 23:44:29 +09:00
2026-09-24 00:42:21 +09:00
2026-11-04 21:23:52 +09:00
2026-11-04 20:30:47 +09:00
2026-11-04 20:30:47 +09:00
2026-11-04 21:50:30 +09:00
2026-11-04 23:04:17 +09:00
2026-09-24 00:42:21 +09:00
2026-11-04 23:35:33 +09:00
2026-11-04 23:35:33 +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-04 20:35:11 +09:00
2026-11-04 20:40:11 +09:00
2026-11-01 22:49:38 +09:00
2026-09-24 00:42:21 +09:00
2026-11-04 20:57:19 +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-05 22:06:59 +09:00
2026-11-01 22:42:44 +09:00
2026-11-04 20:32:17 +09:00
2026-11-03 07:17:49 +09:00
2026-09-26 01:01:49 +09:00
2026-09-26 00:22:16 +09:00
2026-11-03 21:37:48 +09:00
2026-09-24 00:42:21 +09:00
2026-11-03 01:24:31 +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-11-01 23:18:45 +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-11-04 20:24:14 +09:00
2026-11-03 01:58:38 +09:00