feat: sync mismatch progress evidence closure

2026-07-20 00:03:56 +08:00
parent 198c0763a6
commit 6d4d22630c
30 changed files with 3766 additions and 326 deletions
@@ -0,0 +1,118 @@
+#!/usr/bin/env python3
+"""Inventory local OSS Jyotish candidates as observation-only sources."""
+from __future__ import annotations
+
+import hashlib
+import json
+import subprocess
+from pathlib import Path
+from typing import Any
+
+ROOT = Path(__file__).resolve().parents[1]
+BASE = ROOT / "references" / "open_source_sources"
+CANDIDATES = ["VedicAstro", "jyotishganit", "panchanga_api", "rishi-ai-mcp", "jaimini-tropical", "vedic-astro-skills"]
+
+
+def sha256_file(path: Path) -> str:
+    h = hashlib.sha256()
+    with path.open("rb") as f:
+        for chunk in iter(lambda: f.read(1024 * 1024), b""):
+            h.update(chunk)
+    return h.hexdigest()
+
+
+def git_commit(path: Path) -> str | None:
+    try:
+        return subprocess.check_output(["git", "-C", str(path), "rev-parse", "HEAD"], text=True, stderr=subprocess.DEVNULL).strip()
+    except Exception:
+        return None
+
+
+def first_existing(path: Path, names: list[str]) -> Path | None:
+    for name in names:
+        p = path / name
+        if p.exists():
+            return p
+    return None
+
+
+def license_hint(path: Path) -> dict[str, Any]:
+    p = first_existing(path, ["LICENSE", "LICENSE.md", "LICENSE.txt", "COPYING"])
+    if not p:
+        return {"status": "missing", "file": None, "sha256": None, "hint": "unknown"}
+    text = p.read_text(encoding="utf-8", errors="ignore")[:3000].lower()
+    if "mit license" in text or "permission is hereby granted" in text:
+        hint = "MIT"
+    elif "apache license" in text:
+        hint = "Apache-2.0"
+    elif "bsd" in text:
+        hint = "BSD-like"
+    elif "gnu affero" in text:
+        hint = "AGPL"
+    elif "gnu general public license" in text:
+        hint = "GPL"
+    else:
+        hint = "unknown"
+    return {"status": "present", "file": str(p.relative_to(ROOT)), "sha256": sha256_file(p), "hint": hint}
+
+
+def file_manifest(path: Path) -> list[dict[str, Any]]:
+    wanted = ["README.md", "README.rst", "pyproject.toml", "package.json", "pubspec.yaml", "requirements.txt"]
+    rows = []
+    for name in wanted:
+        p = path / name
+        if p.exists():
+            rows.append({"path": str(p.relative_to(ROOT)), "sha256": sha256_file(p)})
+    return rows
+
+
+def api_hints(path: Path) -> list[str]:
+    hints = []
+    for pattern in ("*.py", "*.ts", "*.js", "*.dart"):
+        for p in list(path.rglob(pattern))[:200]:
+            if any(part in {".git", "node_modules", "__pycache__"} for part in p.parts):
+                continue
+            rel = str(p.relative_to(path))
+            name = p.stem.lower()
+            if any(k in name or k in rel.lower() for k in ["panch", "muhur", "dasha", "kp", "chart", "asht", "shadbala", "jaimini"]):
+                hints.append(rel)
+            if len(hints) >= 30:
+                return hints
+    return hints
+
+
+def main() -> int:
+    rows = []
+    for name in CANDIDATES:
+        path = BASE / name
+        if not path.exists():
+            rows.append({"project_id": name, "status": "missing"})
+            continue
+        rows.append({
+            "project_id": name,
+            "status": "present",
+            "local_path": str(path.relative_to(ROOT)),
+            "git_commit": git_commit(path),
+            "license": license_hint(path),
+            "manifest_files": file_manifest(path),
+            "api_surface_hints": api_hints(path),
+            "claim_status": "observation_only",
+            "runtime_dependency_allowed": False,
+            "truth_upgrade_allowed": False,
+        })
+    out = {
+        "scope": "local_oss_observation_inventory",
+        "created_at": "2026-07-19",
+        "status": "complete",
+        "claim_status": "observation_only",
+        "production_tuning_allowed": False,
+        "truth_matrix_allowed": False,
+        "boundary": "Local OSS candidates are pinned for reuse/probe triage only. License and hash metadata do not validate astrological truth.",
+        "projects": rows,
+    }
+    print(json.dumps(out, ensure_ascii=False, indent=2, sort_keys=True))
+    return 0
+
+
+if __name__ == "__main__":
+    raise SystemExit(main())