diff options
Diffstat (limited to 'docs/architecture.md')
| -rw-r--r-- | docs/architecture.md | 13 |
1 files changed, 9 insertions, 4 deletions
diff --git a/docs/architecture.md b/docs/architecture.md index 64d4b06..04e2489 100644 --- a/docs/architecture.md +++ b/docs/architecture.md @@ -25,8 +25,8 @@ MCP transport and tools -> domain contracts <- storage adapters ## Implemented prototype contract (v1) -The six public tools are `write_message`, `read_messages`, `search_messages`, -`delete_message`, `rebuild_index`, and `get_system_health`. The detailed +The seven public tools are `write_message`, `update_message`, `read_messages`, +`search_messages`, `delete_message`, `rebuild_index`, and `get_system_health`. The detailed "ProtoType Architecture v0.0.1" below is retained as the original proposal; where it conflicts with this section, the implemented contract is authoritative. @@ -34,8 +34,13 @@ where it conflicts with this section, the implemented contract is authoritative. succeeds only after the platform durability flush succeeds. - Deletion is immediately invisible but remains a tombstone until synchronous compaction. `metadata.deleted` is not part of immutable Message data. -- Metadata is limited to optional `tool_call_id`, `tags`, and `memory_tier`. - Tiers are labels only; no automatic lifecycle operation is performed. +- Metadata supports optional `tool_call_id`, `tags`, `memory_tier`, memory kind, + importance, summary, typed relations, and summary source IDs. + Tiers remain labels; no automatic lifecycle operation is performed. +- `read_messages` defaults to the compatible chronological history view and also + exposes sessions, context, and versioned JSONL export views. +- UPDATE records use optimistic revisions and delta fields. A no-op update does + not write or flush storage. - Search uses ASCII-case-folded Unicode codepoint 2/3-grams, verifies hash matches against the original codepoints, and ranks exact substrings first. - A log record contains magic, format version, type, payload length, sequence, |