AGENTS.md · git:20261106.a9f5acd · 2026-11-06 · sha256 cb786c64aa6cb574
AGENTS.md git:20261106.a9f5acdA
Immutable. This exact content never changes and is served at /api/v1/blob/cb786c64aa6cb574.
# 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. Run relevant behavioral tests, the root TypeScript check, and the bundle build. Never call a source-only change shipped: installed clients execute the bundles.