nx_evict_journal.nx

nx_evict_journal.nx -- append-only eviction visibility log. Per cardinal: cooperative-resource-arbitration. Every eviction, demote, throttle, and migration is logged so the user can audit after the fact. This is the structural EXCEED-axis vs Docker's silent kernel OOM-killer: there, a container disappears and you dig through dmesg hoping to find the reason. Here, every event is in ~/.nishi/evict.jsonl with the displacing cell named. Composes: nx_budget -- denied-allocation events log here nx_yield -- DEMOTED / THROTTLED outcomes log here nx_homeostasis -- migration decisions log here nx_attention_class -- the class of both displaced + displacing cells is preserved for forensics V1 ships in-memory ring buffer. The on-disk JSONL append is queued once nx_jsonl_writer lands; for now the journal is queryable via nx_evict_dump pointer access. Gap list (V1 honest perf verdict): - no disk persistence (in-memory only this phase) - no time-windowed query (caller walks full buffer) - ring-buffer wraps silently at capacity (older entries lost) - no peer-mesh propagation for distributed evictions genealogy_id: nishi_cardinal_2026-05-17_cooperative_resource_arbitration lineage_id: substrate_evict_journal_v1 nx_safety_envelope: intended_use: "Append-only eviction/demote/throttle log for forensic audit; never silent eviction" sil_target: SIL2 evidence: [append_only_invariant, every_event_logged, displacing_cell_named] verdict: NOT_YET_EVALUATED