docs(blog): explain Maka's append-only runtime - #4565
Conversation
Generated-by: OpenAI Codex
MicroGery
left a comment
There was a problem hiding this comment.
This is a strong explanation of the source-of-truth / projection boundary. Before publishing it as architecture documentation, could we tighten four claims that currently blur the implemented contract or overstate the analogy?
-
Current archive storage vs. the target design (lines 234–236). Tool Result archives are currently persisted through the ArtifactStore-backed archive authority. A dedicated SQLite ContextOffloadStore is the proposed direction in #4071, not the current implementation. Please either describe the current authority neutrally or explicitly label the dedicated store as planned.
-
Paging is model-response pagination, not physical range I/O (lines 238–240). ArchiveRead currently hydrates and verifies the complete capped object, then applies offset/limit to the response. The swap/demand-paging analogy is useful, but it should state that this is not storage-level paging or bounded range reads.
-
The placeholder is not, by itself, a bearer capability (line 246). The archive reference is an integrity-bound, Session-scoped locator. Possession of the ref does not authorize a read: the archive authority must verify that the invoking Session owns the artifact. Calling it a capability can suggest the wrong security model.
-
A checkpoint cannot necessarily be regenerated identically from the log (lines 208 and 218). The source log can produce a new valid checkpoint, but an LLM-generated summary may not be byte-identical to the one a later model call already observed. Exact provider-history recovery requires retaining the durable projection, or falling back to raw history; “regenerate from log” should be qualified accordingly.
These changes would preserve the article's main argument while separating authoritative history, provider-visible projections, and the future #4071 storage topology more precisely.
Summary
docs/blogs/for long-form design explanations and link it from the documentation authority mapVerification
git diff --checknpm run check:asf-headersAI use
Select exactly one:
Tool(s) and scope: OpenAI Codex reviewed the current Maka architecture and implementation, drafted the article, and prepared the documentation index and PR.
Checklist
Does this PR entail a change in behavior?