226 lines
8.4 KiB
Python
Executable File
226 lines
8.4 KiB
Python
Executable File
#!/usr/bin/env python3
|
|
from __future__ import annotations
|
|
|
|
import argparse
|
|
from pathlib import Path
|
|
|
|
REQUIRED_PATHS = (
|
|
# 스킬 — 분석에서 게시까지
|
|
".agents/skills/analyzing-codebase-for-tech-log/SKILL.md",
|
|
".agents/skills/deriving-tech-log-root-tree/SKILL.md",
|
|
".agents/skills/deriving-tech-log-root-tree/references/decomposition-checklist.md",
|
|
".agents/skills/writing-tech-log-records/SKILL.md",
|
|
".agents/skills/writing-tech-log-records/references/root-tree-contract.md",
|
|
".agents/skills/writing-tech-log-records/references/record-kinds.md",
|
|
".agents/skills/writing-tech-log-records/references/body-syntax.md",
|
|
".agents/skills/writing-tech-log-records/references/code-tables-diagrams.md",
|
|
".agents/skills/writing-tech-log-records/references/review-checklist.md",
|
|
".agents/skills/writing-tech-log-records/references/from-ssot-to-records.md",
|
|
".agents/skills/writing-tech-log-records/references/writing-each-kind.md",
|
|
".agents/skills/rewriting-technical-prose-naturally/SKILL.md",
|
|
".agents/skills/rewriting-technical-prose-naturally/references/protected-content.md",
|
|
".agents/skills/rewriting-technical-prose-naturally/references/editorial-rules.md",
|
|
".agents/skills/writing-tech-log-records/references/explaining.md",
|
|
".agents/skills/writing-tech-log-records/references/ai-tells.md",
|
|
".agents/skills/rewriting-technical-prose-naturally/references/research-method.md",
|
|
".agents/skills/rewriting-technical-prose-naturally/scripts/check_prose.mjs",
|
|
".agents/skills/rewriting-technical-prose-naturally/scripts/style_profile.mjs",
|
|
".agents/skills/technical-visualizer/SKILL.md",
|
|
".agents/skills/refactoring-from-analysis/SKILL.md",
|
|
# 틀
|
|
"docs/_templates/state.json",
|
|
"docs/_templates/source-index.md",
|
|
"docs/_templates/root-tree.md",
|
|
"docs/_templates/analysis/00-project-overview.md",
|
|
"docs/_templates/analysis/module.md",
|
|
"docs/_templates/final/document.md",
|
|
".agents/skills/writing-tech-log-records/templates/case.md",
|
|
".agents/skills/writing-tech-log-records/templates/concept.md",
|
|
# 도구
|
|
"scripts/techviz",
|
|
"scripts/build-tech-log-tree.py",
|
|
"scripts/terminal-evidence/render_terminal.py",
|
|
"scripts/terminal-evidence/README.md",
|
|
".agents/skills/writing-tech-log-records/scripts/check_body.mjs",
|
|
)
|
|
|
|
ROOT_TREE_TOKENS = (
|
|
"PROJECT",
|
|
"TOPIC",
|
|
"├── CASE",
|
|
"├── REFERENCE",
|
|
"├── OPEN QUESTION",
|
|
"└── DECISION",
|
|
"# Node Specifications",
|
|
"readiness:",
|
|
"source:",
|
|
"classification:",
|
|
)
|
|
|
|
QUEUE_TOKENS = ("version:", "activeProject:", "projects:")
|
|
REFACTOR_QUEUE_TOKENS = ("version:", "activeItem:", "items:")
|
|
|
|
STATE_REANALYSIS_TOKENS = (
|
|
'"reanalysis"',
|
|
'"baselineRevision"',
|
|
'"targetRevision"',
|
|
'"mode"',
|
|
'"changedPaths"',
|
|
'"impactedScopes"',
|
|
)
|
|
ALLOWED_QUEUE_STATUSES = {"PENDING", "IN_PROGRESS", "COMPLETE", "REANALYZE", "BLOCKED", "SKIPPED"}
|
|
|
|
|
|
def _parse_analysis_queue(text: str):
|
|
active = None
|
|
projects = []
|
|
current = None
|
|
for raw in text.splitlines():
|
|
stripped = raw.strip()
|
|
if not stripped or stripped.startswith("#"):
|
|
continue
|
|
if raw.startswith("activeProject:"):
|
|
value = raw.split(":", 1)[1].strip().strip("\"'")
|
|
active = None if value in {"", "null", "~"} else value
|
|
continue
|
|
if stripped.startswith("- name:"):
|
|
name = stripped.split(":", 1)[1].strip().strip("\"'")
|
|
current = {"name": name, "status": None}
|
|
projects.append(current)
|
|
continue
|
|
if current is not None and stripped.startswith("status:"):
|
|
current["status"] = stripped.split(":", 1)[1].strip().strip("\"'")
|
|
return active, projects
|
|
|
|
|
|
def _verify_refactor_queue(path: Path) -> list[str]:
|
|
errors: list[str] = []
|
|
text = path.read_text(encoding="utf-8", errors="replace")
|
|
for token in REFACTOR_QUEUE_TOKENS:
|
|
if token not in text:
|
|
errors.append(f"refactor queue missing token: {token}")
|
|
return errors
|
|
|
|
|
|
def _verify_analysis_queue(path: Path) -> list[str]:
|
|
errors = []
|
|
text = path.read_text(encoding="utf-8", errors="replace")
|
|
for token in QUEUE_TOKENS:
|
|
if token not in text:
|
|
errors.append(f"analysis queue missing token: {token}")
|
|
if errors:
|
|
return errors
|
|
|
|
active, projects = _parse_analysis_queue(text)
|
|
names = [p["name"] for p in projects]
|
|
if len(names) != len(set(names)):
|
|
errors.append("analysis queue contains duplicate project names")
|
|
|
|
for project in projects:
|
|
status = project.get("status")
|
|
if status not in ALLOWED_QUEUE_STATUSES:
|
|
errors.append(f"analysis queue invalid status for {project['name']}: {status}")
|
|
|
|
in_progress = [p["name"] for p in projects if p.get("status") == "IN_PROGRESS"]
|
|
if len(in_progress) > 1:
|
|
errors.append("analysis queue has multiple IN_PROGRESS projects")
|
|
|
|
owned = [p["name"] for p in projects if p.get("status") in {"IN_PROGRESS", "BLOCKED"}]
|
|
if len(owned) > 1:
|
|
errors.append("analysis queue has multiple active-owned projects")
|
|
if active is None:
|
|
if owned:
|
|
errors.append("activeProject does not match active-owned project")
|
|
elif owned != [active]:
|
|
errors.append("activeProject does not match active-owned project")
|
|
return errors
|
|
|
|
|
|
FORBIDDEN_LITERAL = "document-" + "haness"
|
|
TEXT_SUFFIXES = {".md", ".json", ".py", ".sh", ".txt", ".yaml", ".yml", ".toml"}
|
|
|
|
|
|
def _iter_pipeline_text_files(shared_root: Path):
|
|
for rel_root in (".agents", "docs/_templates", "scripts"):
|
|
root = shared_root / rel_root
|
|
if not root.exists():
|
|
continue
|
|
for path in root.rglob("*"):
|
|
if not path.is_file() or path.suffix.lower() not in TEXT_SUFFIXES:
|
|
continue
|
|
if "__pycache__" in path.parts:
|
|
continue
|
|
yield path
|
|
|
|
|
|
def verify_pipeline(shared_root: Path) -> list[str]:
|
|
shared_root = Path(shared_root)
|
|
errors: list[str] = []
|
|
|
|
for rel in REQUIRED_PATHS:
|
|
if not (shared_root / rel).exists():
|
|
errors.append(f"missing required path: {rel}")
|
|
|
|
queue = shared_root / "docs/analysis-queue.yaml"
|
|
if queue.exists():
|
|
errors.extend(_verify_analysis_queue(queue))
|
|
|
|
refactor_queue = shared_root / "docs/refactor-queue.yaml"
|
|
if refactor_queue.exists():
|
|
errors.extend(_verify_refactor_queue(refactor_queue))
|
|
|
|
state_template = shared_root / "docs/_templates/state.json"
|
|
if state_template.exists():
|
|
state_text = state_template.read_text(encoding="utf-8", errors="replace")
|
|
for token in STATE_REANALYSIS_TOKENS:
|
|
if token not in state_text:
|
|
errors.append(f"state template missing reanalysis token: {token}")
|
|
|
|
root_tree = shared_root / "docs/_templates/root-tree.md"
|
|
if root_tree.exists():
|
|
text = root_tree.read_text(encoding="utf-8", errors="replace")
|
|
for token in ROOT_TREE_TOKENS:
|
|
if token not in text:
|
|
errors.append(f"root-tree template missing token: {token}")
|
|
|
|
for path in _iter_pipeline_text_files(shared_root):
|
|
text = path.read_text(encoding="utf-8", errors="replace")
|
|
if FORBIDDEN_LITERAL in text:
|
|
rel = path.relative_to(shared_root)
|
|
errors.append(f"forbidden legacy dependency in {rel}: {FORBIDDEN_LITERAL}")
|
|
if path.is_symlink():
|
|
try:
|
|
target = str(path.resolve())
|
|
except OSError:
|
|
target = ""
|
|
if FORBIDDEN_LITERAL in target:
|
|
rel = path.relative_to(shared_root)
|
|
errors.append(f"forbidden legacy symlink target in {rel}: {target}")
|
|
|
|
return errors
|
|
|
|
|
|
def main() -> int:
|
|
parser = argparse.ArgumentParser(description="Verify the Tech Log documentation pipeline workspace.")
|
|
parser.add_argument("shared_root", nargs="?", type=Path,
|
|
default=Path(__file__).resolve().parent.parent)
|
|
args = parser.parse_args()
|
|
|
|
errors = verify_pipeline(args.shared_root)
|
|
if errors:
|
|
print("PIPELINE VERIFICATION: FAIL")
|
|
for error in errors:
|
|
print(f"- {error}")
|
|
return 1
|
|
|
|
print("PIPELINE VERIFICATION: PASS")
|
|
print(f"- required paths: {len(REQUIRED_PATHS)}")
|
|
print("- analysis queue contract: valid")
|
|
print("- root-tree contract: present")
|
|
print("- forbidden legacy dependency: absent")
|
|
return 0
|
|
|
|
|
|
if __name__ == "__main__":
|
|
raise SystemExit(main())
|