Initial commit: codemap skill (architecture map + per-module code-quality audit)

scripts/apply_audit.py

@@ -0,0 +1,75 @@
+#!/usr/bin/env python3
+"""apply_audit.py — merge one subagent's audit result into modules.json.
+
+A module audit is produced by an INDEPENDENT subagent (see reference/STANDARDS.md)
+and returned as a small JSON object:
+
+    {"score": 72, "grade": "C",
+     "tags": ["duplication","legacy"],
+     "findings": [{"sev":"HIGH","loc":"path/file.py:120","text":"..."}, ...]}
+
+This script writes that result onto the module and stamps `auditedHash` =
+current `contentHash` (so scan.py will treat the module as fresh until its code
+changes again), plus `auditedAt` / `auditedRev`. Run scan.py --write FIRST so the
+current contentHash is present.
+
+Accepts the result inline (--json '...') or from a file (--json-file path).
+Stdlib only.
+"""
+import argparse, datetime, json, sys
+
+VALID_GRADES = {"A", "B", "C", "D", "F"}
+
+
+def main():
+    ap = argparse.ArgumentParser()
+    ap.add_argument("--state", required=True)
+    ap.add_argument("--id", required=True, help="module id to update")
+    ap.add_argument("--json", help="audit result as an inline JSON string")
+    ap.add_argument("--json-file", help="audit result JSON file")
+    ap.add_argument("--rev", default="", help="git rev being audited (optional)")
+    args = ap.parse_args()
+
+    if args.json_file:
+        result = json.load(open(args.json_file, encoding="utf-8"))
+    elif args.json:
+        result = json.loads(args.json)
+    else:
+        result = json.load(sys.stdin)
+
+    state = json.load(open(args.state, encoding="utf-8"))
+    mod = next((m for m in state.get("modules", []) if m["id"] == args.id), None)
+    if mod is None:
+        sys.exit(f"module id not found: {args.id}")
+
+    score = int(result["score"])
+    grade = str(result["grade"]).strip().upper()[:1]
+    if grade not in VALID_GRADES:
+        sys.exit(f"invalid grade: {result['grade']}")
+    if not (0 <= score <= 100):
+        sys.exit(f"score out of range: {score}")
+
+    findings = []
+    for f in result.get("findings", []):
+        sev = str(f.get("sev", "LOW")).upper()
+        if sev not in {"HIGH", "MED", "LOW"}:
+            sev = "LOW"
+        findings.append({"sev": sev, "loc": str(f.get("loc", "")),
+                         "text": str(f.get("text", ""))})
+
+    mod["score"] = score
+    mod["grade"] = grade
+    mod["tags"] = list(result.get("tags", [])) or ["clean"]
+    mod["findings"] = findings
+    mod["auditedHash"] = mod.get("contentHash", "")
+    mod["auditedAt"] = datetime.datetime.now().strftime("%Y-%m-%d")
+    mod["auditedRev"] = args.rev
+
+    json.dump(state, open(args.state, "w", encoding="utf-8"),
+              ensure_ascii=False, indent=1)
+    print(f"applied: {args.id}  score={score} grade={grade} "
+          f"findings={len(findings)} tags={mod['tags']}")
+
+
+if __name__ == "__main__":
+    main()