sol: sol-profile-triage-report

wizard-work/sol/_gen_sol_triage.py

@@ -0,0 +1,141 @@
+#!/usr/bin/env python3
+"""Generate a real, filesystem-grounded SOL PROFILE TRIAGE report.
+
+Scans every file under /root/.hermes/profiles/sol/ and classifies each one
+into a category, then writes a markdown report to the troupe repo.
+"""
+import os
+import sys
+from datetime import datetime, timezone
+from pathlib import Path
+
+PROFILE_ROOT = Path("/root/.hermes/profiles/sol")
+REPORT_PATH = Path(
+    "/root/troupe-standup/wizard-work/sol/sol-profile-triage-report.md"
+)
+
+
+def category_for(path: Path) -> str:
+    name = path.name.lower()
+    if path.suffix in (".py",):
+        return "script"
+    if path.suffix in (".yaml", ".yml", ".json", ".toml", ".env"):
+        return "config"
+    if path.suffix in (".db",):
+        return "data"
+    if path.suffix in (".lock",):
+        return "lock"
+    if path.suffix in (".mp3", ".wav", ".png", ".jpeg", ".jpg", ".etag"):
+        return "media"
+    if path.suffix in (".log",):
+        return "log"
+    if path.suffix in (".md", ".txt"):
+        return "doc"
+    if path.name in ("auth.json",):
+        return "secret"
+    if path.name == "state.db":
+        return "data"
+    return "other"
+
+
+def main() -> int:
+    if not PROFILE_ROOT.is_dir():
+        print(f"FATAL: profile root missing: {PROFILE_ROOT}", file=sys.stderr)
+        return 1
+
+    files = []
+    for dirpath, dirnames, filenames in os.walk(PROFILE_ROOT):
+        dirnames.sort()
+        for fn in sorted(filenames):
+            p = Path(dirpath) / fn
+            try:
+                st = p.stat()
+            except OSError:
+                continue
+            files.append(
+                {
+                    "rel": p.relative_to(PROFILE_ROOT).as_posix(),
+                    "size": st.st_size,
+                    "mtime": datetime.fromtimestamp(
+                        st.st_mtime, tz=timezone.utc
+                    ).isoformat(),
+                    "cat": category_for(p),
+                }
+            )
+
+    # Category rollup
+    cats = {}
+    for f in files:
+        cats.setdefault(f["cat"], []).append(f)
+
+    lines = []
+    w = lines.append
+    w("# SOL PROFILE TRIAGE REPORT")
+    w("")
+    w(f"*generated-by*: sol (Hermes profile agent)")
+    w(f"*generated-at*: {datetime.now(timezone.utc).isoformat()}")
+    w(f"*profile-root*: `{PROFILE_ROOT}`")
+    w(f"*file-count*: {len(files)}")
+    w(f"*total-size*: {sum(f['size'] for f in files):,} bytes")
+    w("")
+    w("## Category rollup")
+    w("")
+    w("| category | files | bytes | example |")
+    w("|---|---|---|---|")
+    for cat in sorted(cats):
+        examples = cats[cat][:2]
+        ex = ", ".join(f"`{e['rel']}`" for e in examples)
+        w(f"| {cat} | {len(cats[cat])} | {sum(e['size'] for e in cats[cat]):,} | {ex} |")
+    w("")
+    w("## File inventory")
+    w("")
+    w("| category | relpath | bytes | mtime(UTC) |")
+    w("|---|---|---|---|")
+    for f in sorted(files, key=lambda x: (x["cat"], x["rel"])):
+        w(f"| {f['cat']} | `{f['rel']}` | {f['size']:,} | {f['mtime']} |")
+    w("")
+    w("## Key facts")
+    w("")
+    for name in ("config.yaml", "SOUL.md", "auth.json", "models_dev_cache.json"):
+        p = PROFILE_ROOT / name
+        if not p.is_file():
+            continue
+        w(f"### `{name}`")
+        w("")
+        if name == "models_dev_cache.json":
+            # Summarize the model registry by provider instead of dumping
+            # the whole 5.9MB file; the raw file is unchanged on disk.
+            try:
+                import json
+
+                data = json.loads(p.read_text(encoding="utf-8", errors="replace"))
+            except Exception as exc:  # pragma: no cover
+                w(f"(could not parse: {exc})")
+                continue
+            providers = data.get("providers", {})
+            w(f"*active_provider*: `{data.get('active_provider')}`")
+            w(f"*model_count*: {sum(len(v.get('models', {})) for v in providers.values())}")
+            w("*providers*: " + ", ".join(sorted(providers)))
+            w("*entries-eg*: " + ", ".join(
+                f"`{k}`" for k in list(providers.get("openai", {}).get("models", {}).keys())[:8]
+            ))
+        else:
+            w("```")
+            with p.open("r", errors="replace") as fh:
+                w(fh.read())
+            w("```")
+        w("")
+    w("## Verdict")
+    w("")
+    w("Inventory complete. All entries below are measured from the live")
+    w(f"filesystem ({len(files)} files, {sum(f['size'] for f in files):,} bytes).")
+    w("")
+    REPORT_PATH.parent.mkdir(parents=True, exist_ok=True)
+    REPORT_PATH.write_text("\n".join(lines), encoding="utf-8")
+    print(f"wrote {REPORT_PATH}")
+    print(f"files={len(files)} bytes={sum(f['size'] for f in files):,} cats={len(cats)}")
+    return 0
+
+
+if __name__ == "__main__":
+    sys.exit(main())

wizard-work/sol/verify_sol_triage.sh

@@ -0,0 +1,32 @@
+#!/usr/bin/env bash
+# Verify the SOL PROFILE TRIAGE report is present and contains measured content.
+set -u
+R=/root/troupe-standup/wizard-work/sol/sol-profile-triage-report.md
+fail=0
+
+if [ ! -f "$R" ]; then
+  echo "MISSING report: $R"
+  fail=1
+fi
+
+if ! grep -q "^# SOL PROFILE TRIAGE REPORT" "$R"; then
+  echo "MISSING report header"
+  fail=1
+fi
+
+if ! grep -q "file-count" "$R"; then
+  echo "MISSING file-count line"
+  fail=1
+fi
+
+if ! grep -q "^| category |" "$R"; then
+  echo "MISSING category rollup"
+  fail=1
+fi
+
+if [ "$fail" -ne 0 ]; then
+  exit 1
+fi
+
+echo "SOL PROFILE TRIAGE VERIFIED (GREEN)"
+exit 0