Solution for long term memory for agent coding CLIs and to facilitate handoff between different agent vendors
Rust
Merge branch 'main' into release/2.2
AkitaOnRailsd0902a6cfdb3
diff --cc CHANGELOG.mdindex 0cd83598,f4f37e00..fe1b8792--- a/CHANGELOG.md+++ b/CHANGELOG.md@@@ -7,62 -7,29 +7,84 @@@ and this project adheres to [Semantic V## [Unreleased]+### Added+- Page-grain ingestion windows (`pages.valid_from` / `valid_to`, V62) and+ a second `as_of` stream: `memory_query(as_of=T)` now fuses the entity+ timeline with version-filtered full-text search over the page versions+ alive at T, using the default path's RRF (k=60) plus the same bounded+ authority adjustment — current-index relevance over knowledge valid at T. This+ answers entity-less pages and paraphrased audit questions ("which+ database were we on during the outage?") that the entity-only lookup+ missed. `explain=true` reports both streams (`streams_active:+ ["entity", "fts"]`) with per-stream ranks and RRF contributions.+ Vector, graph, and the raw-observation fallback stay out of audit mode;+ the default (no `as_of`) path is unchanged. Every retire path+ (supersede, decay, reorg graveyard, move-regenerate) closes both grains+ in the same transaction, and the V62 backfill closes successor-less+ retirements at the decay marker, existing entity-link close, or+ `updated_at` fallback, preserving recorded reorg/move history.+ Phase B world-time stays deferred. (#656)+- `[retrieval]` section with two opt-in ranking signals, both off by default+ so unconfigured stores rank exactly as before. `query_intent` routes+ lexically session-recall queries ("上次 / 之前那次…的会话 / last time /+ yesterday …") past the default session-page authority penalty+ (×0.77 combined kind/tier), with `session_recall_bonus` (default 0.25)+ sizing the lift; `abstract_vectors` adds a fifth RRF stream over the new+ `page_abstract_embeddings` table (V61) — the L0 layer: a page's+ frontmatter `abstract:` line is embedded on its own, at write time when an+ embedder is attached and by the same backfill as the body otherwise+ (a one-line summary embeds far more sharply than a+ multi-thousand-character body). Measured on a 138-query golden set over a+ production two-year wiki (FTS5 + entity + vector + graph, mis-tei+ Qwen3-Embedding-8B): hit@1 0.609 → 0.746 (+22%), NDCG@10 0.782 → 0.879+ (+12%) with both enabled; every unrouted category keeps its exact+ baseline ordering. Cross-checked on an independently built 99-query+ golden set against the same store: hit@1 0.556 → 0.626, NDCG@10+ 0.712 → 0.779 (+9.4%). Both signals are visible per hit in+ `memory_query(explain=true)` (`intent`, `intent_boost`,+ `abstract_rank`, `rrf.abstract`). (#672)+- `memory_handoff_list` lets no-stdout and MCP-only clients inspect open+ project handoffs without claiming or expiring them, then+ `memory_handoff_accept` can claim that exact `handoff_id` once. Grok,+ Zero, and other clients that discard SessionStart stdout no longer have+ to recover a baton by blindly accepting the latest row. Listing is+ owner-filtered like accept (own plus shared; root-only `any_owner`);+ it is not a second claim path, and Grok SessionStart still does not+ fetch `/handoff`. (#664)+- `install-instructions --compact` writes a slimmer managed routing block for+ projects that already have the detailed ai-memory Agent Skills installed. The+ compact block keeps the same start/end markers (so refresh/uninstall still+ find it), the untrusted-history security scaffold, and the cross-harness+ memory-of-record guidance; `full_block` and the default remain unchanged.+ (#675)++ ### Changed+ - The managed routing snippet now states that Claude Code loads `CLAUDE.md` and+ does not read `AGENTS.md`: a project whose canonical instruction file is+ `AGENTS.md` needs a bare `@AGENTS.md` import line in `CLAUDE.md`, or the rules+ written there are absent from context at session start and reach the agent only+ if it opens the file. `docs/install.md` and `docs/usage.md` carry the same note+ beside the `--target AGENTS.md` guidance, and this repository's own `CLAUDE.md`+ now uses the import instead of a prose pointer (#680).+### Fixed+- Preserved recorded entity-link retirement timestamps when backfilling+ page ingestion windows for historical reorg/move-regenerate pages,+ preventing empty page windows when `updated_at` still held creation+ time. Clarified current-index ranking and snapshot-based rollback. (#682)+ - The from-source AUR `PKGBUILD` now builds and tests on constrained AUR+ builders. Release LTO was disabled (`options=('!debug' '!lto')`) so the+ final link no longer gets OOM-killed on low-memory build hosts, and the+ `check()` step pins `CARGO_HOME` to the registry `build()` already+ populated before it repoints `HOME` at an empty test home, so the+ `--frozen` test run can resolve the packages it fetched instead of+ failing offline (#677).+ - CLI server errors now name the request. A non-2xx response from the+ configured server printed only `server returned 404 Not Found: <body>`,+ so a failure gave no clue which endpoint answered. The message now leads+ with the request method and path: `GET /admin/open-sessions: server+ returned 404 Not Found: <body>`. The error keeps the path only, so a+ token in the URL userinfo or query string never reaches a log line.- Wiki auto-commits stage what the wiki wrote instead of walking thewhole tree, keep the repository open between commits, and no longerdrop the commit when another session is writing a file at the same