Architecture

Runtime

• TypeScript / Node.js CLI
• zvec canonical store under .ragit/store/
• Memory control plane under .ragit/memory/
• Searchable long-term memory corpus under docs/memory/
• Embedding provider facade with local-placeholder, openai, and ollama
• Git-tracked manifests under .ragit/manifest/

Retrieval

• Chunk embeddings + keyword scoring
• Weighted hybrid ranking (alpha)
• Point-in-time query with snapshot SHA

Binding model

• Every snapshot binds to commit SHA
• Incremental ingest supports --since <sha>
• Hooks (post-commit, post-merge) keep index fresh
• memory wrap updates working state without changing snapshot contracts
• memory promote writes tracked docs into docs/memory/** and can ingest them against the current HEAD

If you are reading this as a user rather than an implementer, the conceptual explanation lives in Memory Model Guide.