aoa-session-memory

Use when a `.aoa` session-memory root must be created, installed, checked, repaired, or prepared for Codex hook-based session archiving.

Use when an indexed `.aoa` session needs provisional first-pass distillation into lessons, decisions, failures, and automation candidates without promoting them to reviewed truth.

Use when an agent needs evidence from prior `.aoa` sessions about how a skill, MCP, hook, tool, API, goal, eval, test, validator, script, decision, error, receipt, or other recurring operational entity was used, what happened nearby, and which raw or segment refs prove it.

Use in any Codex session when the user mentions `.aoa`, session memory, Codex transcripts, compaction, prior session rehydration, hook failures, or AoA session-memory validation.

Use when an agent needs to build or query the portable `.aoa` SQLite search index for archived Codex sessions, with evidence refs and freshness checks.

Use when the live Codex PreCompact and PostCompact hook path must be proven through `.aoa` using the Codex app-server compact probe.

Use when AoA Codex hooks must be inspected, trusted, or compared against expected `.aoa` commands in the native Codex hook registry.

Use when many indexed `.aoa` sessions need a first-wave distillation conveyor that separates safe automatic first-pass artifacts from manual review and mechanics-improvement queues.

Use when historical Codex JSONL sessions from `<codex-history-root>` need to be discovered, dry-run checked, and sequentially imported into `.aoa` archives.

Use when `.aoa` first-wave manual review lanes need bounded review packets, owner-aware evidence samples, or an unpromoted promotion-candidate queue.

Use when the `.aoa` session-memory bundle needs a completion-readiness audit across raw preservation, compaction topology, hooks, tests, and standalone GitHub readiness.

Use when the `.aoa` session-memory filesystem contract, registry, generated indexes, naming policy, live hooks, or Codex grounding need health checks.

Use for `.aoa` large-session checks, logical compaction boundary validation, bounded archive inspection, and `stress-pass` diagnostics.

Use before broad session renaming or semantic naming work to classify `.aoa` session archives by naming readiness, lower-layer blockers, and phase-discovery needs.

Use when many `.aoa` session archives need fast, reviewable semantic naming across readiness, sync/reindex preflight, review plans, guarded apply, and quality audit.

Use for long `.aoa` Codex session archives that need phase/topic candidate extraction before applying semantic session names.

Use when existing `.aoa` session archives need generated segment Markdown and indexes rebuilt from preserved raw JSONL after taxonomy, classifier, relationship, or index-schema changes.

Use when a Codex raw transcript must be archived into `.aoa` compaction-interval segments with raw preservation, segment indexes, manifests, and registry updates.

Use when a `.aoa` hook or manual archive pass cannot read the raw Codex transcript and must write an incident plus diagnostic record instead of fake memory.

Use when an agent needs to resume, inspect, or continue from an archived `.aoa` session without loading the full raw transcript.