fix(scripts): 검사 스크립트와 smoke wrapper의 빈틈을 닫고 자기 시험을 더한다
문제: - README 「새 서비스로 시작하기」의 이름 바꾸기 명령(`git grep -l ... -- src scripts`)이 루트 build.gradle·build-logic의 group, config/spotbugs 목록, registry· API surface 스냅숏을 놓쳐, 따라 하면 qualityCheck와 surface 검사가 실패했다. - check-repo-layout.py의 HISTORY_PREFIXES가 없는 폴더 셋(superpowers, evidence, study)을 담고 docs/history·docs/design을 빠뜨렸다. 검사 스크립트 머리말에 누가 부르는지 없었고, check-repo-layout·check-review-index·verify-httpclient-docs에 자기 시험이 없었다. check-docs.py docstring은 「검사 여섯」(여덟), check-work-docs.py는 lychee를 PR workflow라 했다(main). - run-compose-runtime-smoke.sh가 lane마다 정적 계약 전체를 다시 돌려 nightly마다 compose config를 수백 번 렌더링했다. handoff lane의 --force-recreate가 1단계 재시작 수를 지웠고, ps가 빈 결과면 restarts.txt가 비어 재시작 검사가 통과했다. 고친 것: - 이름 바꾸기 명령을 그 범위로 넓히고 build-logic 자기 패키지는 그대로 둬도 된다고 적었다. - HISTORY_PREFIXES를 지금 기록 폴더 넷으로, 머리말에 부르는 곳, docstring 숫자· workflow를 고쳤다. 자기 시험 셋을 더했다(scripts/tests 통과, 옛 목록이면 HISTORY_PREFIXES 시험이 실패한다). - smoke는 정적 계약을 실행마다 한 번(두 모드 공통) 돌린다. 재시작 수는 record_restarts가 단계(phase1, final)를 붙여 쌓고, 살핀 컨테이너가 없거나 inspect·기록이 실패하면 실패한다(호출이 `|| return 1`이라 함수 안 set -e가 꺼진다). - verify-httpclient-docs 자기 시험은 실제 트리 대조(release workflow의 검사)를 하지 않고 누락 탐지만 본다. scripts/tests는 PR 단계에서 돈다. Refs: RR9-04-04, RR9-04-17, RR9-04-18, RR9-04-26, RR9-04-27
This commit is contained in:
@@ -1,5 +1,7 @@
|
||||
#!/usr/bin/env python3
|
||||
"""문서 검사 여섯: 언어, 기록의 머리 블록, 참조, 복사한 숫자, 문서 지도, 루트 README 절. 하나라도 걸리면 rc=1이다.
|
||||
"""문서 검사 여덟: 언어, 기록의 머리 블록, 참조, 복사한 숫자, 문서 지도, 모듈 README 절, 상대 링크, 문체. 하나라도 걸리면 rc=1이다.
|
||||
|
||||
부르는 곳: PR 단계 `prCheck`의 `documentCheck`(루트 `build.gradle`), `scripts/verify.sh docs`.
|
||||
|
||||
규칙의 정본은 design-docs `conventions/docs-system.md`이고, 이 repo의 적용은 `docs/README.md`
|
||||
「문서 수명과 언어」다. 이 스크립트는 그 규칙 중 기계로 볼 수 있는 것만 본다.
|
||||
@@ -39,8 +41,8 @@
|
||||
python3 -c 'import hashlib,sys; print(hashlib.sha256(sys.argv[1].encode()).hexdigest()[:16])' "<줄>"
|
||||
- 2026-11-07 번역 단계에서 목록의 줄을 모두 지워 목록과 FROZEN이 비었다.
|
||||
|
||||
python3 scripts/check-docs.py # 여섯 모두
|
||||
python3 scripts/check-docs.py --only head # 하나만 (language, head, reference, number, map, readme)
|
||||
python3 scripts/check-docs.py # 여덟 모두
|
||||
python3 scripts/check-docs.py --only head # 하나만 (CHECKS의 이름 하나)
|
||||
python3 -m unittest discover -s scripts/tests # 이 검사의 시험
|
||||
|
||||
Gradle 밖에 둔다. 빌드는 문서를 파싱하지 않는다(build-logic/AGENTS.md 「저장소 파일을 읽는 테스트」).
|
||||
|
||||
Reference in New Issue
Block a user