Skip to content

Solution for long term memory for agent coding CLIs and to facilitate handoff between different agent vendors

Rust

Merge PR #675: --compact install-instructions variant (#675)

AkitaOnRailsbc910869e746
diff --cc CHANGELOG.md
index 48508ab3,aa6dd1dd..ffce67e8
--- a/CHANGELOG.md
+++ b/CHANGELOG.md
@@@ -7,43 -7,6 +7,49 @@@ and this project adheres to [Semantic V
## [Unreleased]
+### Added
+- `[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)
+
+### Fixed
+- Wiki auto-commits stage what the wiki wrote instead of walking the
+ whole tree, keep the repository open between commits, and no longer
+ drop the commit when another session is writing a file at the same
+ time. A session end now costs what it wrote, not the size of the wiki,
+ and the git history no longer silently misses snapshots under
+ concurrent sessions (#674).
+
## [2.1.1] - 2026-09-07
### Changed