refactor: 분리되어 관리하고 있던 문서 시스템을 하나로 통일

scripts/build-tech-log-tree.py

@@ -1,6 +1,10 @@
 #!/usr/bin/env python3
 """tech-log-tree.json 을 다시 만든다.
 
+노드 필드는 document-detail 의 root-tree 계약을 따른다 — readiness, source, code,
+evidence, classification, missing-verification, relations. 제목만 보고 기록을 만들지
+못하게 하려는 것이다.
+
 SSOT(final/document.md)에서 뽑은 글감과 이미 쓴 기록을 한 파일에 모은다. 기록 파일이
 정본이므로 이 스크립트는 그것을 읽어 채우고, 아직 글이 없는 글감은 사람이 적은 항목을
 그대로 둔다.
@@ -8,7 +12,7 @@ SSOT(final/document.md)에서 뽑은 글감과 이미 쓴 기록을 한 파일
     python3 scripts/build-tech-log-tree.py [프로젝트 ...]
 """
 from __future__ import annotations
-import json, re, sys, glob, os, datetime
+import json, re, sys, glob, os, datetime, hashlib
 
 KINDS = ["case", "concept", "reference", "question", "decision"]
 ROOT = os.path.dirname(os.path.dirname(os.path.abspath(__file__)))
@@ -45,15 +49,24 @@ def build(project: str) -> dict:
             for f in sorted(glob.glob(os.path.join(topic_dir, kind, "*.md"))):
                 fm = front_matter(f)
                 text = open(f, encoding="utf-8").read()
-                items.append({
+                node = {
                     "title": fm.get("title", os.path.basename(f)),
                     "slug": fm.get("slug", ""),
                     "file": os.path.relpath(f, studio),
+                    "readiness": "READY" if fm.get("id") else "NEEDS_EVIDENCE",
                     "status": fm.get("status", "미작성"),
                     "studioId": fm.get("id", ""),
-                    "assets": len(re.findall(r"^  - key: ", text, re.M)),
-                    "evidence": len(re.findall(r"^  - \.\./", text, re.M)),
-                })
+                    "assets": re.findall(r"^  - key: (\S+)", text, re.M),
+                    "evidence": re.findall(r"^  - (\.\./\S+)", text, re.M),
+                    "relations": re.findall(r"^- \*\*(.+?)\*\*$", text, re.M),
+                }
+                # 이미 쓴 글감은 지난 트리의 사람이 적은 칸을 잃지 않는다
+                for old in previous.get("topics", {}).get(topic, {}).get("kinds", {}).get(kind, []):
+                    if old.get("slug") == node["slug"]:
+                        for key in ("classification", "missing-verification", "source", "code"):
+                            if old.get(key):
+                                node[key] = old[key]
+                items.append(node)
             # 아직 글이 없는 글감은 지난 tree 에서 가져와 유지한다
             written = {i["slug"] for i in items if i["slug"]}
             for old in previous.get("topics", {}).get(topic, {}).get("kinds", {}).get(kind, []):
@@ -62,11 +75,20 @@ def build(project: str) -> dict:
             entry["kinds"][kind] = items
         topics[topic] = entry
 
+    ssot_path = os.path.join(base, ssot) if ssot else None
+    digest = None
+    if ssot_path and os.path.exists(ssot_path):
+        digest = hashlib.sha256(open(ssot_path, "rb").read()).hexdigest()
+
     return {
+        "schemaVersion": 2,
         "project": project,
         "ssot": ssot,
+        "ssotSha256": digest,
         "generatedAt": datetime.date.today().isoformat(),
-        "note": "글감 목록이다. file 이 있으면 이미 쓴 기록이고, 없으면 아직 쓰지 않은 글감이다.",
+        "note": "글감 목록이다. file 이 있으면 이미 쓴 기록이고, 없으면 아직 쓰지 않은 글감이다. "
+                "ssotSha256 이 지금 final/document.md 와 다르면 SSOT 가 바뀐 뒤 트리를 다시 보지 않은 것이다.",
+        "readinessValues": ["READY", "NEEDS_EVIDENCE", "BLOCKED", "REJECTED"],
         "topics": topics,
     }