Commit Graph
4 Commits
Author SHA1 Message Date
DongHyeonka b4e4f98c03 fix(docs): 문서 검사가 명령 안 경로와 짝 저장소 참조를 본다
문제
verify:documentation(FE-GATE-017)은 공백 없는 backtick 경로만 본다. 그래서
`corepack pnpm exec vitest run tests/…` 같은 명령 안의 경로, 셸 코드 블록의
명령, 저장소 밖(`../`) 링크는 확인하지 않았다. 실제로 원장
docs/operations/adapter-remediation-ledger.md의 N-06~N-08 행이 V2와 함께
지운 테스트 세 개를 실행하라고 적고 있었다. 짝 백엔드 정본 링크가 깨져도
알 수 없었다. config/ci/ungated-scripts.json의 check:remediation-ledger
사유는 "It passes at this commit"이라는 시점 문장을 담았다.

고른 방법
- 인라인 코드와 셸 코드 블록(```bash/sh/shell/console/zsh, 언어 없음)에서
  명령(corepack, pnpm, npx, node, vitest, playwright, tsc, eslint, bash,
  sh)의 인자를 같은 경로 규칙으로 본다. 앞의 NAME=value는 건너뛰고,
  --flag=value는 값만 본다. 자리표시자(<id>, glob, $VAR)는 기존 규칙대로
  경로로 보지 않는다.
- 짝 백엔드 템플릿(clean-architecture-backend-template)을 가리키는 backtick
  경로와 저장소 밖 링크는 문서를 읽는 checkout 옆에서 찾는다. 그 checkout이
  있으면 없는 경로는 실패다. 없으면(CI, 중첩 worktree) 실패 대신 "not
  verified"로 출력하고 보고서 documentReferences[].unverifiedLinks에 남긴다.
  보고서 schema에 그 칸을 더했다.
- 원장 N-06~N-08 행의 명령을 LEG-01 행처럼 "V2와 함께 지움"으로 바꾸고,
  ungated 사유에서 시점 문장을 지웠다. docs/README.md 1절의 검사 범위 설명을
  고쳤다.
- 버린 대안: 지운 심볼 이름 검사. 지운 이름 목록을 따로 관리해야 하고
  오탐이 많다(리뷰 5.2절). 1절 밖 문서로 대상 넓히기. 기록 문서가 일부러 옛
  경로를 적어 예외가 늘어난다.

위험·한계
- 명령 머리 목록에 없는 명령(git, curl 등)의 인자는 여전히 보지 않는다.
- 짝 저장소 참조는 CI에서 늘 "not verified"다. 실제 확인은 옆에 checkout이
  있는 개발 환경에서만 된다.
- 1절 밖 문서(testing strategy :765, VD-23)는 그대로 검사 밖이다.

검증
- RED: 새 테스트 4건(인라인 명령, 셸 블록, 짝 저장소 있음·깨짐, 짝 저장소
  없음 보고) 실패.
- 수정 뒤 documentation-readiness 19건 통과. 저장소에서 수정 전 원장 행 3개가
  "names paths that do not exist"로 잡혔고, 행을 고친 뒤 verify:documentation
  PASS_SCOPED(worktree라 짝 저장소 참조 3건은 not verified).
  check:remediation-ledger PASS, check:ci PASS, check:types 통과, eslint 통과.

Refs: docs/reviews/2026-11-03-maturity-review/12-guardrails-ci.md 12-05
2026-11-04 21:15:03 +09:00
DongHyeonka 2eb010ae88 chore(ci): 정비 원장 검사를 게이트 밖에 두는 이유를 지금 사실로 고친다 (1101/14.3)
문제: config/ci/ungated-scripts.json은 check:remediation-ledger를 게이트
밖에 두는 이유로 "표시가 지워져 지금 커밋에서 낡은 주장을 보고한다"를
적는다. 1335087 뒤로 이 검사는 통과하고, 실패 원인도 표시 삭제가 아니라
테스트 분할로 파일이 옮겨 간 것이었다.

고른 방법: 게이트 밖에 두고 이유만 사실대로 고친다. 지금 통과한다는 것,
게이트에 넣지 않는 실제 이유(제품이 선택 레시피 file-transfer를 빼거나
테스트 분할로 표시한 테스트가 옮겨 가면 실패한다), 언제 손으로 돌리는지를
적는다.
버린 대안: FE-GATE-010에 넣기. 1초 안에 끝나고 이번 같은 분할을 바로
잡았겠지만, 이 검사는 file-transfer 레시피 예산을 읽어 그 레시피를 뺀
제품의 merge를 막는다. 선택 레시피를 빼는 것은 템플릿이 허용한 경로다.

위험·한계: 다음 테스트 분할 때 원장이 다시 낡아도 게이트는 모른다.
이 검사는 작업 이력 원장이라 그 비용을 받아들인다.

검증: node scripts/check-remediation-ledger.ts 통과(25 dispositions,
0 open), tests/unit/ungated-scripts.test.ts 10건 통과
2026-11-03 20:10:50 +09:00
DongHyeonka 6ceb84740c chore(ci): check:feature-index 예외 이유에 실제 사용처를 적는다 (1101/12-05)
문제
config/ci/ungated-scripts.json의 check:feature-index 이유는 "--check는
로컬 사본이 오래됐다는 것만 알려 줄 수 있다"이다. 쓸모없다는 말로 읽혀
리뷰가 지울 후보로 올렸다. 실제로는 scripts/verify-extreme-scale.ts가
EXTREME_SCALE_GATES 첫 단계로 이 script를 부른다.

고른 방법
- 지우지 않는다. 이유 문구를 "로컬에서 생성 인덱스가 오래됐는지 확인,
  verify:extreme-scale(scripts/verify-extreme-scale.ts)의 첫 단계. 게이트는
  인덱스를 먼저 다시 만들어서 얻는 것이 없다"로 고친다.
- ungated-scripts 테스트가 EXTREME_SCALE_GATES에 이 script가 있고 이유가
  verify:extreme-scale을 적는지 확인한다. verify:extreme-scale이 이
  script를 그만 부르면 실패해서 다시 지울 후보가 된다.
- 12-05의 나머지(script 4개 삭제, scan: 접두어 검사)는 98b9682가 했다.
버린 대안
- check:feature-index 삭제: verify-extreme-scale.ts의 단계 목록과
  tests/scripts/verify-extreme-scale.test.ts를 같이 고쳐야 하고, 로컬에서
  생성 인덱스가 오래됐는지 볼 방법이 없어진다.

위험·한계
- 게이트 명령은 바뀌지 않는다. CI 계약 기준선은 그대로다.

검증
- RED: 새 테스트 "names verify:extreme-scale as the user of
  check:feature-index"가 실패(expected 'The generated indexes
  (src/.generated…' to contain 'verify:extreme-scale').
- GREEN: ungated-scripts·ungated-tests·verify-extreme-scale 31/31 통과.
- check:ci 세 단계를 pnpm 없이 직접 실행: generate-artifact-schemas --check
  PASS, check-ci-contract.ts PASS(27 gates), generate-ci-workflow --check
  PASS. 바꾼 테스트 eslint 통과.

Refs: docs/reviews/2026-11-01-maturity-review/12-guardrails-ci.md 12-05
2026-11-03 01:24:31 +09:00
donghyeon-kaandClaude Opus 5.5 15a946fc46 ci(gates): require every verification package script to run in a gate or name why not (12-04)
check-ci-contract only caught test files outside the gates; check:* scripts
such as check:request-fanout and check:remediation-ledger ran nowhere. The
new check reads config/ci/ungated-scripts.json; three checks are now wired
into FE-GATE-010 and FE-GATE-012 and the rest carry a reason.

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
2026-09-27 14:14:42 +09:00