Files
document-haness/scripts/tests/test_run_target.py
T
DongHyeonkaandClaude Opus 5 14afe94d76 검사: 관문이 어느 대상에 돌았는지 보고, 필수 내용 검사를 전체 훑기에 넣는다
R5 — 원장은 관문의 명령과 종료 코드를 적는데 **그 명령이 어느 대상에 돌았는지는 아무도
안 봤다.** 다른 프로젝트에 돌려 받은 exit 0 을 적어도 통과로 셌다. `_wrong_target()` 이
`docs/<이름>/` 경로와 명령 인자의 프로젝트 이름 둘 다 본다.

  정상 원장 넷            새 error 0 (B 의 document-haness 원장 PASS · warn 3)
  프로젝트 인자를 바꾼 원장  FAIL 「관문이 다른 대상에 돌았다」
  기록 경로를 바꾼 원장     FAIL

**유효 범위를 docstring 에 적었다** — 「다른 프로젝트」만 본다. 같은 프로젝트의 다른 기록에
돌린 관문은 안 잡는다. 기록 단위까지 보려면 관문마다 대상 단위를 계약이 먼저 정해야 한다.

R12 — `check-required-content.py` 를 `OUTPUT_CHECKS` 에 더한다. B-003 이 병합돼 이제 된다.
세 상태 표를 지키는 것을 확인했다 — `ca-tmpl` exit 2 · `keycloak-session-store` exit 0 ·
없는 프로젝트 exit 2.

`OUTPUT CHECKS` 의 error 가 5 → 7 이 된다. **부채가 늘어난 것이 아니라 세는 자리가 늘었다** —
`ca-tmpl` 에 계약이 없다는 한 사실이 `check_evidence` · `check-required-content` ·
`TECH LOG TREES` 세 곳에서 셈된다. 같은 사실을 세 번 세지 않는다.

회귀 `scripts/tests/test_run_target.py` 2건 (123 → 125). **「정상 원장은 그대로 통과한다」
대조를 함께 넣는다** — 무조건 거절로 성공률을 올리는 것이 R-003 이 든 실패다.

Co-Authored-By: Claude Opus 5 (1M context) <noreply@anthropic.com>
Claude-Session: https://claude.ai/code/session_01Wp9jNbePAmWc5jQwCYhK9v
2026-09-10 11:36:45 +09:00

80 lines
2.9 KiB
Python

"""원장에 적힌 관문이 **그 원장의 대상**에 돌았는지 (R5).
원장은 명령 문자열과 종료 코드를 적는다. 그런데 그 명령이 어느 대상에 돌았는지는 아무도
안 봤다 — 다른 프로젝트에 돌려 받은 exit 0 을 적어도 통과로 셌다.
**정상 원장이 그대로 통과하는 대조를 함께 둔다.** 무조건 거절로 성공률을 올리는 것이
R-003 이 든 실패다.
"""
from __future__ import annotations
import copy
import glob
import importlib.util
import json
import os
import tempfile
import unittest
ROOT = os.path.dirname(os.path.dirname(os.path.dirname(os.path.abspath(__file__))))
def _module():
path = os.path.join(ROOT, "scripts", "verify-pipeline-run.py")
spec = importlib.util.spec_from_file_location("verify_pipeline_run", path)
mod = importlib.util.module_from_spec(spec)
spec.loader.exec_module(mod)
return mod
def _a_ledger() -> dict | None:
for p in sorted(glob.glob(os.path.join(ROOT, "runs", "*", "*", "run.json"))):
d = json.load(open(p, encoding="utf-8"))
gates = [g for st in d.get("stages", []) for g in (st.get("gates") or [])]
if any("docs/" in str(g.get("cmd", "")) for g in gates):
return d
return None
def _verify(doc: dict) -> object:
with tempfile.NamedTemporaryFile("w", suffix=".json", delete=False,
dir=os.path.join(ROOT, "runs"), encoding="utf-8") as f:
json.dump(doc, f, ensure_ascii=False)
path = f.name
try:
return _module().verify(path)
finally:
os.unlink(path)
class GateRanAgainstTheLedgersTarget(unittest.TestCase):
def setUp(self) -> None:
self.doc = _a_ledger()
if self.doc is None:
self.skipTest("대상 경로가 있는 원장이 이 저장소에 없다")
def test_untouched_ledger_still_passes(self) -> None:
"""대조군 — 손대지 않은 원장은 이 규칙으로 새 error 를 얻지 않는다."""
rep = _verify(self.doc)
self.assertNotIn("관문이 다른 대상에 돌았다", rep.errors)
def test_gate_on_another_project_is_an_error(self) -> None:
other = "n+1liner" if self.doc["project"] != "n+1liner" else "keycloak"
if not os.path.isdir(os.path.join(ROOT, "docs", other)):
self.skipTest("대조에 쓸 다른 프로젝트가 없다")
bad = copy.deepcopy(self.doc)
swapped = False
for st in bad["stages"]:
for g in st.get("gates") or []:
cmd = str(g.get("cmd") or "")
if not swapped and f"docs/{bad['project']}/" in cmd:
g["cmd"] = cmd.replace(f"docs/{bad['project']}/", f"docs/{other}/")
swapped = True
self.assertTrue(swapped, "바꿀 관문을 못 찾았다")
rep = _verify(bad)
self.assertIn("관문이 다른 대상에 돌았다", rep.errors)
if __name__ == "__main__":
unittest.main()