Add hf_bucket_bridge.py: sync VAP to persistent bucket

hf_bucket_bridge.py

@@ -0,0 +1,27 @@
+"""HF Bucket persistence bridge for NEXUS OS.
+
+Usage inside Space:
+    from hf_bucket_bridge import save_vap, load_vap
+    save_vap({"event": "purple_scan", "score": 0.97})
+
+CLI equivalent:
+    hf buckets cp ./vap.json hf://buckets/specimba/nexus-vap-bucket/vap/run-001.json
+"""
+import os, json, subprocess, tempfile
+
+BUCKET = "hf://buckets/specimba/nexus-vap-bucket"
+
+def save_vap(data: dict, filename: str = None):
+    ts = data.get("timestamp", "")
+    fn = filename or f"vap/{ts.replace(':', '-')}.json"
+    with tempfile.NamedTemporaryFile(mode="w", suffix=".json", delete=False) as f:
+        json.dump(data, f)
+        tmp = f.name
+    subprocess.run(["hf", "buckets", "cp", tmp, f"{BUCKET}/{fn}"], check=False)
+    os.unlink(tmp)
+    return f"{BUCKET}/{fn}"
+
+def load_vap(pattern: str = "vap/", limit: int = 10):
+    """List recent VAP files from bucket."""
+    r = subprocess.run(["hf", "buckets", "list", "specimba/nexus-vap-bucket", pattern, "-R", "-q"], capture_output=True, text=True)
+    return r.stdout.strip().split("\n")[:limit]