القائمة
Use when historical Codex JSONL sessions from `<codex-history-root>` need to be discovered, dry-run checked, and sequentially imported into `.aoa` archives.
التثبيت باستخدام Codex أو Claude انسخ هذا Prompt والصقه في Codex أو Claude أو مساعد آخر ليراجع صفحة Skill ويثبّتها لك.
استنادا إلى تصنيف SOC المهني
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.
| name | aoa-session-history-import |
| description | Use when historical Codex JSONL sessions from `<codex-history-root>` need to be discovered, dry-run checked, and sequentially imported into `.aoa` archives. |
| license | Apache-2.0 |
| metadata | {"aoa_scope":"session-memory","aoa_invocation_mode":"manual"} |
Use this when older Codex sessions need to be laid out into the .aoa
archive without manually calling sync for each transcript.
raw_unavailable archives may be repairable from existing JSONL transcripts.Stop hook receipt, leaving
a missing, stale, deferred, or hook-only .aoa archive.Start with a dry run:
python3 scripts/aoa_session_memory.py import-codex-sessions \
--workspace-root <workspace-root> \
--aoa-root <aoa-root> \
--since-days 21 \
--dry-run \
--write-report
If the dry-run count is coherent, run the import:
python3 scripts/aoa_session_memory.py import-codex-sessions \
--workspace-root <workspace-root> \
--aoa-root <aoa-root> \
--since-days 21 \
--write-report
Use --force only when an already indexed archive must be rebuilt.
For recent missed close/no-hook recovery, prefer the narrower sweeper before a broad import:
python3 scripts/aoa_session_memory.py sweep-codex-sessions \
--workspace-root <workspace-root> \
--aoa-root <aoa-root> \
--since-days 7 \
--min-age-sec 60 \
--dry-run \
--write-report
The sweeper is dry-run by default and uses indexed_archive_freshness to plan
only missing, stale, deferred, hook-only, or raw-unavailable transcripts. Add
--apply after the plan is coherent.
.aoa/diagnostics/counts.error is absent or zero--force was used--applydoctor and audit remain green after the runDo not open every raw transcript in context. Use the import report, registry, manifests, and segment indexes as the navigation layer.