AGENTS.md · git:20261110.df86baa · 2026-11-10 · sha256 537cac8c9e723dca
AGENTS.md git:20261110.df86baaA
Immutable. This exact content never changes and is served at /api/v1/blob/537cac8c9e723dca.
# Claude-Mem architecture rules Read [the observer lifecycle contract](docs/architecture/observer-lifecycle.md) before changing capture, queueing, retries, provider dispatch, or recovery. - The local observer is a stateful reducer, not a durable job consumer. - Live observation, file-edit, and summary inputs must not be persisted for automatic replay. Use the common live handoff and `SessionMessageBuffer`. - Quota exhaustion and authentication failures discard pending inference inputs. A quota reset, login, restart, timer, or a later successful store never authorizes backfill, and paused work is never resumed on such proof. - Keep active buffering bounded. Do not add another batching queue, retry store, startup sweep, or platform-specific recovery loop. - Preserve the paid-send budget and completed-observation deduplication. An ambiguous request must not acquire a fresh budget by changing its path. - Original transcripts, raw source evidence, saved memories, receipt IDs, and synchronization of already-saved records are distinct from inference work. Do not delete them to clear a queue or make them trigger paid replay. - Recovery must be a separately specified, explicit workflow with a matching source position and observer state. A last observation ID, delivery receipt, byte offset, or collection of pending fragments alone is not a checkpoint. - Integration and community fixes must obey the same rules. Tests proving that a queue drains are insufficient; test that an outage cannot create later, unrequested inference spend. Read [the state rules](docs/architecture/state-machines.md) before adding or changing a status, phase, stage or mode that a person or an agent can see. - Such a state has one definition. Types, request checks, label tables and tests import it; none of them types the values again. - Word each state for people in a `Record<State, …>`, so a new state fails the typecheck until every screen has words for it. - Delete a state that is written and never read. Do not add a state-machine library or a transition framework. Run relevant behavioral tests, the root TypeScript check, and the bundle build. Never call a source-only change shipped: installed clients execute the bundles.