Core Concepts

Agent writes →  MemoryEntry created
                  ├── entity_path: "checkout-service"
                  ├── key: "retry-pattern"
                  ├── value: { ... }
                  ├── memory_type: fact   ← fact / belief / experience
                  ├── version: 3          ← CoW versioning
                  ├── confidence: 0.85    ← evolves with outcomes
                  ├── branch: "main"      ← git-like branch
                  └── provenance:
                      ├── agent_id: "review-agent"
                      ├── session_id: "abc-123"
                      └── written_at: 2025-06-15T10:30:00Z

              →  Event logged on agent timeline
                  ├── event_type: "write"
                  ├── branch: "main"
                  ├── summary: "Wrote checkout-service/retry-pattern v3"
                  └── details: { entity_path, key, version, confidence }