rock
c1d2aa1c92
- Comprehensive API documentation with full request/response JSON - 24+ endpoints (query, synthesis, versioning, ranking, rebuild, foundation) - Error handling patterns (400, 401, 403, 404, 409, 429, 503) - Rate limits and authentication requirements - Frontend integration examples (JavaScript) - Replaces separate endpoint docs with unified reference Saved as: - /poimen-docs/memory-api.md (source) - /memory/docs/api/API.md (deployed)
Memory System Documentation
Phase 7 Complete ✅ | 84/84 tasks done
API Documentation
Phase 7 APIs
-
T7_VERSIONING_API.md — Version history, diffs, point-in-time queries
- GET /memory/entities/{id}/versions
- GET /memory/entities/{id}/diff?from=v1&to=v2
- GET /memory/entities/{id}/at?as_of=timestamp
-
T7_RANKING_API.md — Multi-signal ranking (7 signals, 3 profiles)
- GET /memory/ranking/profiles
- POST /memory/query with ranking_profile
-
T7_REBUILD_API.md — Deterministic rebuild with checksums
- POST /memory/rebuild
- GET /memory/rebuild/status
Operations & SLOs
RUNBOOK_PHASE7.md
- Incident response procedures
- Daily health check script
- Escalation paths
SLO Definitions
- availability.yaml — 99.9% uptime target
- latency.yaml — p99 <500ms latency targets
- consistency.yaml — 100% rebuild parity + audit integrity
Implementation Details
- PHASE_7_TEMPORAL_RAGA_INGEST_DESIGN.md — Temporal ingest patterns
- TEMPORAL_WORKFLOW_INTEGRATION.md — Workflow integration
- LLM_INFERENCE_ACTIVITY_INTEGRATION.md — LLM integration patterns
Quick Links
- Task Board: poimen-docs/tasks/INDEX.md
- Phase 7 Tasks: poimen-docs/tasks/T7.1-T7.6.md
- API Overview: poimen-docs/API_MEMORY_SYSTEM.md
- Scaling Strategy: poimen-docs/EXPERT_SCALE_ARCHITECTURE_REALISTIC.md
File Structure
docs/
├── README.md (this file)
├── api/
│ ├── T7_VERSIONING_API.md
│ ├── T7_RANKING_API.md
│ └── T7_REBUILD_API.md
├── operations/
│ └── RUNBOOK_PHASE7.md
├── slo/
│ ├── availability.yaml
│ ├── latency.yaml
│ └── consistency.yaml
└── Implementation details
├── PHASE_7_TEMPORAL_RAGA_INGEST_DESIGN.md
├── TEMPORAL_WORKFLOW_INTEGRATION.md
└── LLM_INFERENCE_ACTIVITY_INTEGRATION.md
Note: Task board is in poimen-docs/tasks/
Status: All Phase 7 documentation complete and deployment-ready