agmem 0.1.5__py3-none-any.whl → 0.2.0__py3-none-any.whl

{agmem-0.1.5.dist-info → agmem-0.2.0.dist-info}/METADATA

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: agmem
-Version: 0.1.5
+Version: 0.2.0
 Summary: Agentic Memory Version Control System - Git for AI agent memories
 Home-page: https://github.com/vivek-tiwari-vt/agmem
 Author: agmem Team
@@ -10,7 +10,7 @@ Project-URL: Homepage, https://github.com/vivek-tiwari-vt/agmem
 Project-URL: Documentation, https://github.com/vivek-tiwari-vt/agmem#readme
 Project-URL: Repository, https://github.com/vivek-tiwari-vt/agmem
 Project-URL: Bug Tracker, https://github.com/vivek-tiwari-vt/agmem/issues
-Keywords: ai,agent,memory,version-control,git,vcs,llm,merkle,audit,encryption,differential-privacy,trust,multi-agent
+Keywords: ai,agent,memory,version-control,git,vcs,llm,merkle,audit,encryption,differential-privacy,trust,multi-agent,health-monitoring,delta-encoding,ipfs,federated
 Classifier: Development Status :: 3 - Alpha
 Classifier: Intended Audience :: Developers
 Classifier: License :: OSI Approved :: MIT License
@@ -71,6 +71,10 @@ Provides-Extra: ipfs
 Requires-Dist: requests>=2.28.0; extra == "ipfs"
 Provides-Extra: ipfs-daemon
 Requires-Dist: ipfshttpclient>=0.8.0; extra == "ipfs-daemon"
+Provides-Extra: coordinator
+Requires-Dist: fastapi>=0.100.0; extra == "coordinator"
+Requires-Dist: uvicorn[standard]>=0.22.0; extra == "coordinator"
+Requires-Dist: pydantic>=2.0.0; extra == "coordinator"
 Provides-Extra: all
 Requires-Dist: mcp>=1.0.0; extra == "all"
 Requires-Dist: cryptography>=41.0.0; extra == "all"
@@ -88,6 +92,7 @@ Requires-Dist: networkx>=3.0; extra == "all"
 Requires-Dist: tiktoken>=0.5.0; extra == "all"
 Requires-Dist: presidio-analyzer>=2.2.0; extra == "all"
 Requires-Dist: requests>=2.28.0; extra == "all"
+Requires-Dist: pydantic>=2.0.0; extra == "all"
 Dynamic: author
 Dynamic: home-page
 Dynamic: license-file
@@ -137,11 +142,67 @@ agmem solves all of these problems with a familiar Git-like interface.
 - ✅ **Multi-provider LLM** — OpenAI and Anthropic via `memvcs.core.llm`; config/repo or env; used by gardener, distiller, consistency, merge
 - ✅ **Temporal querying** — Point-in-time and range queries in temporal index; frontmatter timestamps
 - ✅ **Federated collaboration** — `agmem federated push|pull`; real summaries (topic counts, fact hashes); optional DP on outbound; coordinator API in docs/FEDERATED.md
-- ✅ **Zero-knowledge proofs** — `agmem prove` (hash/signature-based): keyword containment (Merkle set membership), memory freshness (signed timestamp)
-- ✅ **Daemon health** — Periodic Merkle verification in daemon loop; safe auto-remediation hooks
+- ✅ **Zero-knowledge proofs** — `agmem prove` (hash/signature-based): keyword containment (Merkle set membership), memory freshness (signed timestamp). **Note:** Current implementation is proof-of-knowledge with known limitations; see docs for migration to true zk-SNARKs.
+- ✅ **Daemon health** — 4-point health monitoring (storage, redundancy, staleness, graph consistency) with periodic checks; visible warnings and JSON reports
+- ✅ **Delta encoding** — 5-10x compression for similar objects using Levenshtein distance and SequenceMatcher; optional feature in pack files
 - ✅ **GPU acceleration** — Vector store detects GPU for embedding model when available
 - ✅ **Optional** — `serve`, `daemon` (watch + auto-commit), `garden` (episode archival), MCP server; install extras as needed
 
+### Feature Coverage
+
+```mermaid
+graph TB
+    subgraph Core ["🔧 Core Features"]
+        Core1["✅ Git-like commands<br/>init, add, commit, log, branch, merge"]
+        Core2["✅ Content-addressable storage<br/>SHA-256, zlib, dedup"]
+        Core3["✅ Memory-type merge<br/>Episodic, Semantic, Procedural"]
+    end
+    
+    subgraph Collab ["👥 Collaboration"]
+        Collab1["✅ Remote push/pull<br/>file:// URLs, conflict detection"]
+        Collab2["✅ Multi-agent trust<br/>Trust store, key verification"]
+        Collab3["✅ Federated sync<br/>Coordinator API"]
+    end
+    
+    subgraph Safety ["🔒 Safety & Integrity"]
+        Safety1["✅ Cryptographic<br/>Merkle, Ed25519"]
+        Safety2["✅ Tamper detection<br/>Audit trail, hash-chain"]
+        Safety3["✅ Encryption at rest<br/>AES-256-GCM"]
+    end
+    
+    subgraph Privacy ["🕵️ Privacy"]
+        Privacy1["✅ Differential privacy<br/>Epsilon/delta budget"]
+        Privacy2["✅ Zero-knowledge proofs<br/>Keyword, Freshness"]
+        Privacy3["✅ PII scanning<br/>Pre-commit hooks"]
+    end
+    
+    subgraph Intelligence ["🧠 Intelligence"]
+        Intel1["✅ Semantic search<br/>Vector + Text fallback"]
+        Intel2["✅ Knowledge graph<br/>Wikilinks, Co-occurrence"]
+        Intel3["✅ LLM integration<br/>OpenAI, Anthropic"]
+        Intel4["✅ Temporal queries<br/>Point-in-time, Range"]
+    end
+    
+    subgraph Ops ["⚙️ Operations"]
+        Ops1["✅ Pack/GC<br/>Object packing, cleanup"]
+        Ops2["✅ Daemon mode<br/>Watch + auto-commit"]
+        Ops3["✅ IPFS/S3/GCS<br/>Distributed storage"]
+    end
+    
+    Core --> Collab
+    Collab --> Safety
+    Safety --> Privacy
+    Privacy --> Intelligence
+    Intelligence --> Ops
+    
+    style Core fill:#e3f2fd,stroke:#1976d2,stroke-width:2px
+    style Collab fill:#f3e5f5,stroke:#7b1fa2,stroke-width:2px
+    style Safety fill:#ffebee,stroke:#c62828,stroke-width:2px
+    style Privacy fill:#e1f5fe,stroke:#01579b,stroke-width:2px
+    style Intelligence fill:#f1f8e9,stroke:#558b2f,stroke-width:2px
+    style Ops fill:#fff3e0,stroke:#e65100,stroke-width:2px
+```
+
 ## Quick Start
 
 ### Installation
@@ -342,8 +403,56 @@ Verifies objects, refs, and (if installed) the vector store. When commit metadat
 
 ---
 
+## Security Architecture
+
+agmem implements security in layers. Choose what you need:
+
+```mermaid
+graph TB
+    subgraph L1 ["🔒 Tier 1: Cryptographic Integrity"]
+        T1A["✅ Merkle tree<br/>over blobs"]
+        T1B["✅ Ed25519<br/>signatures"]
+        T1C["✅ Tamper<br/>detection"]
+    end
+    
+    subgraph L2 ["🔐 Tier 2: Multi-Agent Trust"]
+        T2A["✅ Trust store<br/>per public key"]
+        T2B["✅ Multi-agent<br/>collaboration"]
+        T2C["✅ Conflict<br/>resolution"]
+    end
+    
+    subgraph L3 ["🕵️ Tier 3: Privacy & Anonymity"]
+        T3A["✅ Differential<br/>Privacy budget"]
+        T3B["✅ Zero-Knowledge<br/>Proofs"]
+        T3C["✅ Encrypted<br/>at rest"]
+    end
+    
+    subgraph L4 ["🌐 Tier 4: Distribution"]
+        T4A["✅ S3/GCS<br/>remotes"]
+        T4B["✅ IPFS<br/>support"]
+        T4C["✅ Pack files<br/>& GC"]
+    end
+    
+    subgraph L5 ["📊 Tier 5: Audit & Compliance"]
+        T5A["✅ Append-only<br/>audit log"]
+        T5B["✅ Hash-chained<br/>verification"]
+        T5C["✅ Full history<br/>& blame"]
+    end
+    
+    L1 --> L2 --> L3 --> L4 --> L5
+    
+    style L1 fill:#ffebee,stroke:#c62828
+    style L2 fill:#ede7f6,stroke:#512da8
+    style L3 fill:#e1f5fe,stroke:#01579b
+    style L4 fill:#f3e5f5,stroke:#7b1fa2
+    style L5 fill:#e8f5e9,stroke:#1b5e20
+```
+
+---
+
 ## Security, trust & advanced features
 
+
 The following 18 capabilities are implemented (or stubbed) per the agmem features implementation plan. They are grouped by tier.
 
 ### Tier 1 — Security and trust
@@ -366,8 +475,8 @@ The following 18 capabilities are implemented (or stubbed) per the agmem feature
 
 | # | Feature | Description |
 |---|---------|-------------|
-| **7** | **Differential privacy** | Epsilon/delta budget per repo in `.mem/privacy_budget.json`. **Usage:** `agmem distill --private`, `agmem garden --private`; blocks when budget exceeded. Config: `differential_privacy.max_epsilon`, `delta`. |
-| **8** | **Zero-knowledge proofs** | zk-SNARK-style proofs for keyword containment and memory freshness. **Command:** `agmem prove --memory <path> --property keyword|freshness --value <v> [-o out]` (stub). |
+| **7** | **Differential privacy** | Epsilon/delta budget per repo in `.mem/privacy_budget.json`. **Usage:** `agmem distill --private`, `agmem garden --private`; blocks when budget exceeded. Config: `differential_privacy.max_epsilon`, `delta`. **Note:** Now correctly applied to actual facts during extraction, not metadata counts. |
+| **8** | **Cryptographic proofs (proof-of-knowledge)** | Hash/signature-based proofs for keyword containment (Merkle set membership) and memory freshness (signed timestamp). **Command:** `agmem prove --memory <path> --property keyword\|freshness --value <v> [-o out]`. **IMPORTANT:** These are proof-of-knowledge, not true zero-knowledge proofs. Keyword proof leaks word count and allows verifier to test other words. Freshness proof relies on forgeable filesystem mtime. See `memvcs/core/zk_proofs.py` for details and migration path to zk-SNARKs. |
 
 ### Tier 4 — Storage and distribution
 
@@ -459,41 +568,88 @@ current/procedural/
 
 ### Memory Flow
 
-```
-  current/                    staging                    .mem/
-  ╭────────────────────┐    ╭─────────────┐    ╭──────────────────────┐
-  │ episodic/           │    │             │    │  objects/            │
-  │   session logs      │    │  index.json  │    │  blobs → trees →     │
-  │ semantic/           │───►│  (staged)   │───►│  commits             │
-  │   facts, prefs      │    │             │    │  (content-addressable)│
-  │ procedural/         │    │             │    │                      │
-  │   workflows         │    ╰─────────────╯    ╰──────────────────────╯
-  ╰────────────────────┘
-         │                         │
-    agmem add               agmem commit
-```
-
-### Merge Strategies
-
-```
-  Episodic      Branch A ──╮
-  (append)      Branch B ──╯──►  chronological append  ──►  ✓ no conflicts
-
-  Semantic      Branch A ──╮
-  (consolidate) Branch B ──╯──►  conflict markers      ──►  ⚠ manual review
-
-  Procedural    Branch A ──╮
-  (prefer new)  Branch B ──╯──►  newer wins            ──►  ⚠ flag for review
+```mermaid
+graph LR
+    A["📂 Working Directory<br/>current/<br/>episodic/<br/>semantic/<br/>procedural/"] 
+    B["📝 Staging Area<br/>index.json<br/>staged files"]
+    C["💾 Object Storage<br/>.mem/objects/<br/>blobs → trees → commits"]
+    D["📍 References<br/>.mem/refs/<br/>HEAD, branches, tags"]
+    
+    A -->|agmem add| B
+    B -->|agmem commit| C
+    C --> D
+    
+    style A fill:#e1f5ff,stroke:#01579b,stroke-width:2px
+    style B fill:#fff3e0,stroke:#e65100,stroke-width:2px
+    style C fill:#f3e5f5,stroke:#4a148c,stroke-width:2px
+    style D fill:#e8f5e9,stroke:#1b5e20,stroke-width:2px
+```
+
+### Merge Strategies by Memory Type
+
+```mermaid
+graph TB
+    A["🌿 Branch A"] --> E{Memory Type?}
+    B["🌿 Branch B"] --> E
+    
+    E -->|"<b>Episodic</b><br/>session logs"| F["⏰ Chronological<br/>Append"]
+    E -->|"<b>Semantic</b><br/>learned facts"| G["🤝 Conflict<br/>Markers"]
+    E -->|"<b>Procedural</b><br/>workflows"| H["✨ Prefer New<br/>with Flag"]
+    
+    F --> I["✅ No Conflicts<br/>Deterministic merge"]
+    G --> J["⚠️ Manual Review<br/>Conflict markers"]
+    H --> J
+    
+    style E fill:#ffebee,stroke:#b71c1c,stroke-width:2px
+    style F fill:#c8e6c9,stroke:#1b5e20,stroke-width:2px
+    style G fill:#ffe0b2,stroke:#e65100,stroke-width:2px
+    style H fill:#b3e5fc,stroke:#01579b,stroke-width:2px
+    style I fill:#81c784,stroke:#1b5e20,stroke-width:2px
+    style J fill:#ffb74d,stroke:#e65100,stroke-width:2px
 ```
 
 ### How Others Handle Memory vs agmem
 
-| Tool | Approach | Gap |
-|------|----------|-----|
-| **Cursor** | Ephemeral, session-based context; no persistent version control | No history, branching, or merge for agent memory |
-| **Claude Code** | File-based (CLAUDE.md, .claude/rules); loaded at launch | No built-in version control; Git is not memory-type-aware |
-| **Mem0** | Cloud/API; vector-based persistence | No branching, merging, or "git log" for what the agent learned |
-| **agmem** | Git-like version control for memory | Version history, branching, merging, local-first, memory-type-aware |
+```mermaid
+graph LR
+    subgraph Cursor ["Cursor<br/>Ephemeral"]
+        C1["❌ No history"]
+        C2["❌ No branching"]
+        C3["❌ Session-based"]
+    end
+    
+    subgraph Claude ["Claude Code<br/>File-based"]
+        Cl1["⚠️ Manual Git"]
+        Cl2["❌ Not memory-aware"]
+        Cl3["⚠️ At launch"]
+    end
+    
+    subgraph Mem0 ["Mem0<br/>Cloud/Vector"]
+        M1["⚠️ Proprietary"]
+        M2["❌ No branching"]
+        M3["❌ Black box"]
+    end
+    
+    subgraph agmem_box ["agmem<br/>Git for Memory"]
+        A1["✅ Full history"]
+        A2["✅ Branches & merge"]
+        A3["✅ Local-first"]
+        A4["✅ Type-aware"]
+        A5["✅ Open source"]
+    end
+    
+    style Cursor fill:#ffebee,stroke:#c62828,stroke-width:2px
+    style Claude fill:#fff3e0,stroke:#f57c00,stroke-width:2px
+    style Mem0 fill:#ede7f6,stroke:#512da8,stroke-width:2px
+    style agmem_box fill:#c8e6c9,stroke:#1b5e20,stroke-width:3px
+```
+
+| Tool | Approach | agmem Advantage |
+|------|----------|--------|
+| **Cursor** | Ephemeral, session-based context | ✅ Full history, persistent, branching |
+| **Claude Code** | File-based (CLAUDE.md); needs Git | ✅ Memory-type-aware merge strategies |
+| **Mem0** | Cloud/API with vector persistence | ✅ Local-first, transparent, version control |
+| **agmem** | 🎯 **Git for Agent Memory** | Version history, branching, merging, local-first, type-aware |
 
 ## Example: Multi-Agent Collaboration
 
@@ -594,23 +750,44 @@ Repo overrides user. **Never put secrets in config files.** Credentials are supp
 
 agmem follows Git's proven architecture:
 
-```
-  ╔═══════════════════════════════════════════════════════════════════════╗
-  ║  PORCELAIN  ·  What you type                                         ║
-  ╠═══════════════════════════════════════════════════════════════════════╣
-  ║    init  add  commit  status  log   ·   branch  checkout  merge       ║
-  ║    diff  show  tag  reset  tree     ·   stash  clean  blame  reflog   ║
-  ║    clone  push  pull  remote  fsck  ·   graph  search  serve  daemon   ║
-  ╠═══════════════════════════════════════════════════════════════════════╣
-  ║  PLUMBING  ·  What happens under the hood                             ║
-  ╠═══════════════════════════════════════════════════════════════════════╣
-  ║    objects (blob, tree, commit)  ·  refs (HEAD, branches, tags)      ║
-  ║    staging area                                                       ║
-  ╠═══════════════════════════════════════════════════════════════════════╣
-  ║  STORAGE  ·  On disk                                                 ║
-  ╠═══════════════════════════════════════════════════════════════════════╣
-  ║    SHA-256 hashing  ·  zlib compression  ·  deduplication            ║
-  ╚═══════════════════════════════════════════════════════════════════════╝
+```mermaid
+graph TB
+    subgraph Commands ["🎯 Commands - Porcelain (What you type)"]
+        A1["init, add, commit, status, log, diff, show, tag, reset, tree"]
+        A2["branch, checkout, merge, stash, clean, blame, reflog"]
+        A3["clone, push, pull, remote, fsck, verify, audit, resolve"]
+        A4["gc, prove, federated, search, graph, serve, daemon, garden"]
+    end
+    
+    subgraph Core ["⚙️ Core Operations - Plumbing (What happens)"]
+        B1["Staging Area<br/>index.json"]
+        B2["Objects<br/>Blob, Tree, Commit, Tag"]
+        B3["References<br/>HEAD, Branches, Tags"]
+        B4["Memory-type Merge<br/>Episodic, Semantic, Procedural"]
+    end
+    
+    subgraph Storage ["💾 Storage - Disk (Where data lives)"]
+        C1["SHA-256 Hashing"]
+        C2["zlib Compression"]
+        C3["Deduplication"]
+        C4["Validation<br/>Path, Ref, Hash"]
+    end
+    
+    subgraph Features ["🔐 Advanced Features"]
+        D1["Crypto Verification<br/>Merkle, Ed25519"]
+        D2["Encryption at Rest<br/>AES-256-GCM"]
+        D3["Privacy<br/>Differential Privacy"]
+        D4["Trust & Audit<br/>Multi-agent, Hash-chain"]
+    end
+    
+    Commands --> Core
+    Core --> Storage
+    Storage --> Features
+    
+    style Commands fill:#e3f2fd,stroke:#1976d2,stroke-width:2px
+    style Core fill:#f3e5f5,stroke:#7b1fa2,stroke-width:2px
+    style Storage fill:#fff3e0,stroke:#f57c00,stroke-width:2px
+    style Features fill:#e8f5e9,stroke:#388e3c,stroke-width:2px
 ```
 
 ## Development

{agmem-0.1.5.dist-info → agmem-0.2.0.dist-info}/RECORD

@@ -1,5 +1,5 @@
-agmem-0.1.5.dist-info/licenses/LICENSE,sha256=X_S6RBErW-F0IDbM3FAEoDB-zxExFnl2m8640rTXphM,1067
-memvcs/__init__.py,sha256=mXwHTSlUPWo4ERqJLGJnxmxtGQQHPSbXb4IpO61l04M,193
+agmem-0.2.0.dist-info/licenses/LICENSE,sha256=X_S6RBErW-F0IDbM3FAEoDB-zxExFnl2m8640rTXphM,1067
+memvcs/__init__.py,sha256=pheWPxubHVcp2N6vk6M7hGXgkJQ06KajbWgCpOlUSJ8,193
 memvcs/cli.py,sha256=YF06oMNjKWUmiNahILmfjrIXgoXzU-5BJFmbunSb8Sc,6075
 memvcs/commands/__init__.py,sha256=A2D6xWaO6epU7iV4QSvqvF5TspnwRyDN7NojmGatPrE,510
 memvcs/commands/add.py,sha256=k9eM7qf2NFvneiJkFQNiAYFB2GgKmyPw_NXmkCxblQE,8736
@@ -11,10 +11,10 @@ memvcs/commands/checkout.py,sha256=xaYZSbCQ-MyLWPtwA2FdH6WqGMI3oF3R2JmCufGBVFg,3
 memvcs/commands/clean.py,sha256=e0OhSQdHfFnOPTRbyKbM8IcX4yJD5n_kaBKjIeoaRBo,1973
 memvcs/commands/clone.py,sha256=aB0LcugIWJE9IEez6y70KlpZu4eIF2EdXZxE24jXyac,3260
 memvcs/commands/commit.py,sha256=W4ulVZuEETJh1SHpscaQfNjyQMqeIE0AYZIbMbTrsq4,6801
-memvcs/commands/daemon.py,sha256=fV6aIz8bFP9VwB_MLudAb_lhhhBxSe2aV-Wjqe-nvPw,10708
+memvcs/commands/daemon.py,sha256=FlPBh41v-S__QhC68FzRYbsumARQgLbP2904k7jaZ6k,12522
 memvcs/commands/decay.py,sha256=QcgOTMJZxrfw_AOz94YHA3LGoNXRMDn69TxWlUrpSw4,2421
 memvcs/commands/diff.py,sha256=KcgD57_fae4uvQ8G9ZbXmLpAYYIDiWiBuVcjsDtyE1U,5480
-memvcs/commands/distill.py,sha256=reOldqg0lMgqIlpYEIKYfN_TxNwsjU9RnI8Uah1VqTQ,3088
+memvcs/commands/distill.py,sha256=eO9n2KxBaIhdvKBnqcrgYH5aoJ7dR5C2WNge_z6ITlw,3330
 memvcs/commands/federated.py,sha256=Zj4kxHnjdIs1xu4v7B8XosQXNYK8Alv4I0kJQpmJe6Y,1840
 memvcs/commands/fsck.py,sha256=AdJBMLA2myQ0cJJcjUgsYptsE3qvX4JQc9UAwVmSHlA,7772
 memvcs/commands/garden.py,sha256=8JiLe3JRkOhY-N-h-IDuvdJiECiSElnUzXVtxtU2QgY,4050
@@ -46,6 +46,8 @@ memvcs/commands/timeline.py,sha256=JkuhsQ-6wPWbsjlbJb_qM4mEkxkxcWWzniXXQB4Qtec,4
 memvcs/commands/tree.py,sha256=vdULq4vIXA_4gNfMnHn_Y78BwE0sJoeTBOnFJR3WsZ4,4927
 memvcs/commands/verify.py,sha256=04CVW5NYWkUlPJ5z1Kci6dfQFM6UmPTGZh9ZextFLMc,3887
 memvcs/commands/when.py,sha256=bxG_tEYnZNBTl2IPkoxpc2LUEbO_5ev1hRvEzxQQDmc,4773
+memvcs/coordinator/__init__.py,sha256=XJEXEXJFvvhtRInPeyAC9bFNXGbshSrtuK6wZo3wS6g,139
+memvcs/coordinator/server.py,sha256=-kCEyqUi7eLC45qqkH1KCk8zZk8T1NdJyffOY8133ec,7045
 memvcs/core/__init__.py,sha256=dkIC-4tS0GhwV2mZIbofEe8xR8uiFwrxslGf1aXwhYg,493
 memvcs/core/access_index.py,sha256=HhacnzSUASzRV2jhDHkwRFoPS3rtqh9n9yE1VV7JXpk,5596
 memvcs/core/audit.py,sha256=8APkm9Spl_-1rIdyRQz1elyxOeK3nlpwm0CLkpLlhTE,3732
@@ -55,8 +57,9 @@ memvcs/core/consistency.py,sha256=YOG8xhqZLKZCLbai2rdcP0KxYPNGFv5RRMwrQ6qCeyc,74
 memvcs/core/constants.py,sha256=WUjAb50BFcF0mbFi_GNteDLCxLihmViBm9Fb-JMPmbM,220
 memvcs/core/crypto_verify.py,sha256=DTuC7Kfx6z2b8UWOWziBTqP633LrjXbdtGmBBqrJTF0,10424
 memvcs/core/decay.py,sha256=ROGwnqngs7eJNkbKmwyOdij607m73vpmoJqzrIDLBzk,6581
+memvcs/core/delta.py,sha256=obXzojUSc2HaEUqH3L_1LF-GcJ63Wr_yYvIPM8iyeSg,7865
 memvcs/core/diff.py,sha256=koEHTLciIUxYKVJVuvmY0GDXMgDgGZP_qg5RayhF-iE,13226
-memvcs/core/distiller.py,sha256=ZOmrwYYhOla8rZncQP_0y0Ab9jCl3GjtdoH82HkXlsw,12621
+memvcs/core/distiller.py,sha256=QA4acLc005cLac09IvIaog1fJt5IGXWRiSdZq_Ya27g,14086
 memvcs/core/encryption.py,sha256=epny_nlW6ylllv1qxs1mAcFq-PrLIisgfot4llOoAqw,5289
 memvcs/core/federated.py,sha256=vUYMZ0xv80hqGDRKq645Od1i8N33l-pIAkklJbJUlVg,5445
 memvcs/core/gardener.py,sha256=lBWkyE72O-JMiHM-oqrnex9k_xSv7FvztjkOdLdB0Kk,18610
@@ -65,11 +68,11 @@ memvcs/core/ipfs_remote.py,sha256=xmEO14bn_7Ej-W5jhx2QJyBd-ljj9S2COOxMmcZBiTs,66
 memvcs/core/knowledge_graph.py,sha256=GY27e1rgraF2zMpz_jsumdUtpgTRk48yH5CAEQ3TDl4,16416
 memvcs/core/merge.py,sha256=x2eSaxr4f63Eq00FCJ6DDe2TZU8H5yHQpzKzMhYsaFw,19871
 memvcs/core/objects.py,sha256=Xgw1IpQnJLCG5o_7gDHVQ-TNGR9CSpDYWRXzLgLSuec,11006
-memvcs/core/pack.py,sha256=nTzpPNNk47e7_oN3z7bjaichpzI7q-ql2E8eI2UuGyM,9828
+memvcs/core/pack.py,sha256=Kq0hyMNroT0MwiS4pVJVuJO9nZ04P3wssep2tADvnpQ,15950
 memvcs/core/pii_scanner.py,sha256=T6gQ1APFrSDk980fjnv4ZMF-UztbJgmUFSwGrwWixEw,10802
 memvcs/core/privacy_budget.py,sha256=fOPlxoKEAmsKtda-OJCrSaKjTyw7ekcqdN7KfRBw1CY,2113
 memvcs/core/refs.py,sha256=4Nx2ZVRa_DzfUZ4O1AwzOHEjoGAEICJKqSd9GxaiD_g,16754
-memvcs/core/remote.py,sha256=1PINc6qYBIHRkNLMS8MLWM5DJIrX81uIfRrV6fXwwro,19495
+memvcs/core/remote.py,sha256=sZbAO9JEaDJM96PylB0CjpmR5UxWYdoXlq86sj3R2gU,22228
 memvcs/core/repository.py,sha256=NzC2UFPv6ePxi5lfiSKyZFLclH4bJpWJz88pY7tDiv4,20605
 memvcs/core/schema.py,sha256=_CrEWCdArc0yDJ04GT7fyvjHqkal7gegdFSsFOjVpBc,15287
 memvcs/core/staging.py,sha256=dptdGi_74lhDkcGqGVU39ZyTkb25j-Rnkz0GWi83W1k,7221
@@ -77,7 +80,7 @@ memvcs/core/temporal_index.py,sha256=81hZHlVElp2UpXjseFVCdDUwxGM45zIU-y1dDlOhFHI
 memvcs/core/test_runner.py,sha256=7-0jCvji63JRbVfy3LNQWIQ7VL5weulOoG7SY1-YJbw,11496
 memvcs/core/trust.py,sha256=msx80Cl3bxyQTY8mFUKWY9P6l3zb1s8FafympgHwtpo,3494
 memvcs/core/vector_store.py,sha256=yUAp5BlaAtjkrtsdY1I-vmAp_YIFgJykBoNlp5hcg0I,11063
-memvcs/core/zk_proofs.py,sha256=j9AyHucYe9tOSrlxDeUMGgpRHMvNFOl8s4Q0AQHLKP0,5514
+memvcs/core/zk_proofs.py,sha256=tvJnj5oLTNQ_wFIGcMuuVF5faigIX_32U_HojNMoNp0,7623
 memvcs/core/llm/__init__.py,sha256=vnjtE9Xlv9a2pZV88DMT9JaINkZ30hC9VLPL5lJRlps,236
 memvcs/core/llm/anthropic_provider.py,sha256=O1eaCb9r464ajLJz-Gy8lGxBie5ojRUZ_5HdgRXO5KY,1540
 memvcs/core/llm/base.py,sha256=qPzg3KPAMeoyWGc_2JoVR4-plpdft5Rc2g9uO-Z4fJQ,623
@@ -88,6 +91,8 @@ memvcs/core/storage/base.py,sha256=IK4To8Cb-LHv5ltlaQLdB6LE-69euFK3hNqBtMCe7-g,9
 memvcs/core/storage/gcs.py,sha256=-cWuGw1jkFh-Xig-Abmwr9HGwjW5lWQJuF2xcAR1l78,10632
 memvcs/core/storage/local.py,sha256=JAik9nta6RMe4mD7aMtgdFi8M4iZCeTqiP8pPisaO6U,6028
 memvcs/core/storage/s3.py,sha256=tY5rfz8FfkRRNaHOPX7Wk6yXdBBBhKV0Ju2qnBtHxeU,13814
+memvcs/health/__init__.py,sha256=YuxF8hVHJHNilAvVa0maptFLBWm4hcBymMjpA2dFJVU,546
+memvcs/health/monitor.py,sha256=2JQqkR6n0e5L-gsU97FEB3rxjrCNAaGRNFpa7LKZtOg,15545
 memvcs/integrations/__init__.py,sha256=hVtJoFaXt6ErAZwctcSBDZLXRHFs1CNgtltIBQiroQ0,103
 memvcs/integrations/mcp_server.py,sha256=PxBYJnbzPs6bcFH6EmH5jQqbu_9Vy5eSAA8ruWTn2Q4,9061
 memvcs/integrations/web_ui/__init__.py,sha256=MQIfgDKDgPctlcTUjwkwueS_MDsDssVRmIUnpECGS0k,51
@@ -99,8 +104,8 @@ memvcs/retrieval/recaller.py,sha256=8KY-XjMUz5_vcKf46zI64uk1DEM__u7wM92ShukOtsY,
 memvcs/retrieval/strategies.py,sha256=26yxQQubQfjxWQXknfVMxuzPHf2EcZxJg_B99BEdl5c,11458
 memvcs/utils/__init__.py,sha256=8psUzz4Ntv2GzbRebkeVsoyC6Ck-FIwi0_lfYdj5oho,185
 memvcs/utils/helpers.py,sha256=37zg_DcQ2y99b9NSLqxFkglHe13rJXKhFDpEbQ7iLhM,4121
-agmem-0.1.5.dist-info/METADATA,sha256=q_9dsCFXbo9DGn6Hx4-7A9T3aHq9Sc5nS7ldEoazAdc,37487
-agmem-0.1.5.dist-info/WHEEL,sha256=wUyA8OaulRlbfwMtmQsvNngGrxQHAvkKcvRmdizlJi0,92
-agmem-0.1.5.dist-info/entry_points.txt,sha256=at7eWycgjqOo1wbUMECnXUsNo3gpCkJTU71OzrGLHu0,42
-agmem-0.1.5.dist-info/top_level.txt,sha256=HtMMsKuwLKLOdgF1GxqQztqFM54tTJctVdJuOec6B-4,7
-agmem-0.1.5.dist-info/RECORD,,
+agmem-0.2.0.dist-info/METADATA,sha256=Oh9LOeoQR_A9ZXrdrkt-sTFoiYA-peWVHvpVaUYncns,42100
+agmem-0.2.0.dist-info/WHEEL,sha256=wUyA8OaulRlbfwMtmQsvNngGrxQHAvkKcvRmdizlJi0,92
+agmem-0.2.0.dist-info/entry_points.txt,sha256=at7eWycgjqOo1wbUMECnXUsNo3gpCkJTU71OzrGLHu0,42
+agmem-0.2.0.dist-info/top_level.txt,sha256=HtMMsKuwLKLOdgF1GxqQztqFM54tTJctVdJuOec6B-4,7
+agmem-0.2.0.dist-info/RECORD,,

memvcs/__init__.py

@@ -4,6 +4,6 @@ agmem - Agentic Memory Version Control System
 A Git-inspired version control system for AI agent memory artifacts.
 """
 
-__version__ = "0.1.3"
+__version__ = "0.1.6"
 __author__ = "agmem Team"
 __license__ = "MIT"

memvcs/commands/daemon.py

@@ -227,11 +227,12 @@ class DaemonCommand:
             while running:
                 time.sleep(1)
 
-                # Periodic health check (Merkle/signature, optional). Alert only; no destructive action.
+                # Periodic health check (Merkle/signature + operational metrics). Alert only; no destructive action.
                 if (
                     health_check_interval
                     and (time.time() - last_health_check) >= health_check_interval
                 ):
+                    # Cryptographic integrity check
                     try:
                         from ..core.crypto_verify import verify_commit, load_public_key
 
@@ -251,6 +252,41 @@ class DaemonCommand:
                                     sys.stderr.write("Run 'agmem fsck' for safe integrity check.\n")
                     except Exception:
                         pass
+
+                    # Operational health checks (storage, redundancy, stale memory, graph consistency)
+                    try:
+                        from ..health.monitor import HealthMonitor
+
+                        health_monitor = HealthMonitor(repo.root)
+                        report = health_monitor.perform_all_checks()
+
+                        if report.get("warnings"):
+                            for warning in report["warnings"]:
+                                sys.stderr.write(f"Health warning: {warning}\n")
+
+                        # Log summary metrics
+                        if report.get("storage"):
+                            storage = report["storage"]
+                            if "total_size_mb" in storage:
+                                sys.stderr.write(
+                                    f"Storage: {storage['total_size_mb']:.1f}MB "
+                                    f"({storage['packed_objects']} packed objects)\n"
+                                )
+                        if report.get("redundancy"):
+                            red = report["redundancy"]
+                            if "redundancy_percentage" in red:
+                                sys.stderr.write(
+                                    f"Redundancy: {red['redundancy_percentage']:.1f}%\n"
+                                )
+                        if report.get("stale_memory"):
+                            stale = report["stale_memory"]
+                            if "stale_percentage" in stale:
+                                sys.stderr.write(
+                                    f"Stale memory: {stale['stale_percentage']:.1f}%\n"
+                                )
+                    except Exception:
+                        pass
+
                     last_health_check = time.time()
 
                 if handler.pending:

memvcs/commands/distill.py

@@ -46,6 +46,11 @@ class DistillCommand:
             action="store_true",
             help="Use differential privacy (spend epsilon from budget)",
         )
+        parser.add_argument(
+            "--no-compress",
+            action="store_true",
+            help="Disable compression pipeline preprocessing",
+        )
 
     @staticmethod
     def execute(args) -> int:
@@ -73,6 +78,7 @@ class DistillCommand:
             source_dir=args.source,
             target_dir=args.target,
             create_safety_branch=not args.no_branch,
+            use_compression_pipeline=not getattr(args, "no_compress", False),
             use_dp=use_dp,
             dp_epsilon=dp_epsilon,
             dp_delta=dp_delta,

memvcs/coordinator/__init__.py

@@ -0,0 +1,5 @@
+"""Coordinator package for federated collaboration."""
+
+from .server import app, FASTAPI_AVAILABLE
+
+__all__ = ["app", "FASTAPI_AVAILABLE"]