yoi/crates/session-store/README.md

session-store

Role

session-store owns replayable append-only session logs.

Boundaries

Owns:

• session identifiers and segment lineage
• JSONL log entries for replayable conversation/runtime history
• restoring Worker/session state from committed records
• schema surfaces that should make drift compile-visible

Does not own:

• current Pod-name metadata (pod-store)
• live process/socket discovery (pod-registry, client)
• UI state (tui)
• generated memory summaries (memory)

Design notes

A session log records what happened. It is not the current Pod registry and should not be queried as the only source of "what does Pod X mean now?"

Prefer explicit current log variants over broad legacy compatibility when schema changes; hidden compatibility can make future replay bugs silent.

See also

• ../../docs/design/pod-session-state.md
• ../../docs/design/context-history.md