Files
DongHyeonka f0ab268e9e
pr / done (pull_request) Canceled after 0s
fix(scripts)!: check-work-docs의 상대 링크 검사가 check-docs link 규칙을 쓴다
상대 링크 검사가 둘이고 규칙이 갈라졌다. check-docs.py의 link는 git이
아는 경로만 받고 저장소 밖(..)은 실패로 본다. check-work-docs.py는
디스크를 exists()로 봐서 git이 모르는 파일, git mv가 남긴 빈 폴더, 저장소
밖 형제 clone(../design-docs/…)도 통과시킨다. 기본 실행은 같은 PR 단계에서
check-docs.py link가 다시 보지만, lychee 없는 기계에서 손으로 쓰는
--links는 약한 쪽의 답만 준다.

check-docs.py의 check_link 몸통을 broken_relative_links(known, path, text)로
뽑고(규칙은 그대로) check-work-docs.py가 그 모듈을 불러 기본 실행과 --links
모두 같은 함수를 쓴다. 그래서 링크 규칙을 한 곳에서 고친다. --links에
저장소 밖 파일이나 이 저장소 git이 모르는 파일(무시된 다른 checkout
.claude/worktrees/…, 빌드 출력)을 주면 그 git으로는 대조할 수 없으므로
rc=2로 거절한다. 버린 안: check-work-docs.py에 git 대조를 따로 구현 —
규칙이 다시 둘이 된다.

위험: check-work-docs.py 기본 실행도 이제 코드 블록·인라인 코드·「이력」
인용 블록 안의 링크를 보지 않는다(check-docs.py link와 같다). 지금 트리에서
깨진 링크 0은 그대로다. 옛 --links가 깨짐으로 본 인라인 코드 속 링크 표기
(docs/upgrade/2026-11-round9-followups.md:31)는 이제 링크로 보지 않는다.
시험 fixture가 git 저장소가 됐다(known_paths가 git ls-files를 쓴다).

검증: python3 -m unittest discover -s scripts/tests -p 'test_check_*docs.py'
OK(129), python3 scripts/check-work-docs.py rc=0,
python3 scripts/check-work-docs.py --links docs README.md rc=0(536 링크,
깨짐 0), python3 scripts/check-docs.py rc=0.

Refs: REV-BE-0017
BREAKING CHANGE: check-work-docs.py --links가 저장소 루트를 넘는 링크와
  git이 모르는 곳을 가리키는 링크를 깨짐(rc=1)으로 보고, 저장소 밖이나
  git이 모르는 파일을 받으면 rc=2로 거절한다. 그 명령을 스크립트로 쓰는
  파생 서비스는 docs/upgrade/2026-11-docs-check-references.md 5번을 본다.
2026-11-22 02:35:19 +09:00
..