thellmwhisperer/roca
Local semantic memory for AI agents.
Changelog
Unreleased
Bug Fixes
-
migrate: remove quadratic custody lookups and avoid repeating unchanged snapshots after interruption (#455); add stage/batch progress and read-only ledger status. See migration operations for output and resume behavior.
-
vector: reuse the embedding resident across
mcp servesessions (#315); see the MCP lifecycle for sharing scope and shutdown behavior.
Features
-
ingest: one hub can read HOME-shaped mirrors of another machine via
[[sources.remote]]. Sessions, exchanges, thinking blocks, and tool calls are stamped with that machine name; the local root uses this hostname. Removing the config entry stops reading that root and leaves already ingested rows. -
plugins:
roca mcp serveraises plugin-declared session companions. Aplugin.jsonmay name an executable inside the plugin directory plus fixed argv; serve starts that child for the session, reaps it on exit, retries crashes with bounded backoff, and leaves a dying companion down without blocking queries. Plugins without the field are unchanged. Telemetry is JSONL under the data directory logs area, never a database. -
vector: ship a local embedding engine inside the vector companion. The user downloads exactly one embeddings model. macOS and Linux no longer need a separate embedding runtime; Windows keeps the previous path until its native lane exists. Indexing walks newest material first. Engine timings land in rotated JSONL under the data directory logs area, never in a database.
-
vector: remove the
vocabdiscovery verb -
remove all model credential machinery; agent models authenticate through their own CLIs
Most users need to do nothing: an already signed-in Codex or Claude CLI is detected and used automatically. Existing remote-provider configuration is tolerated and receives a migration proposal when a supported local CLI is available, or a removal proposal when none is available. A provider table that declares its own command keeps that command: the proposal removes only the retired authentication keys. Recovery backups made while retiring those providers are credential-redacted rather than byte-exact. If an older installation left files under ~/.roca/credentials, La Roca no longer reads them; they never disable a working CLI transport and are offered for removal on their own. roca init retires nothing behind its model confirmation, and roca update no longer refreshes a remote model catalogue.
The bootstrap JSON field external_credential is now named command_transport; it reports that the selected model runs through a local agent CLI without implying that La Roca owns authentication.
1.93.1 (2026-10-24)
Bug Fixes
- vector: repair the test names the history scrub broke (7df6a6f)
- vector: repair the test names the history scrub broke (main) (1230c80)
1.93.0 (2026-10-07)
Features
Bug Fixes
- vector: limit corpus delta walks to changed sources (#514) (9d32470)
- vector: report completed status after delta ingestion (#512) (9115d36)
1.92.0 (2026-09-24)
Features
- release: align PR gates with the release train (#504) (dfb49f8)
- service: print an executable remedy for every failing health check (#489) (d66252c)
Bug Fixes
- distribution: retire the leftover MCP audit stream (#501) (0e8345d)
- harden data lifecycle and federation diagnostics (#493) (76dc83f)
- make health failures repairable and harden federation lifecycle (#498) (f51a90d)
1.91.0 (2026-09-21)
Features
- accent-insensitive search with automatic index rebuild (#61) (ba38752)
- add shared database resident for MCP and CLI clients (#456) (cb88d5f)
- ChatGPT data-export ingester (#51) (3e764bd)
- cli: add canonical session context loading (#279) (1bb2d42)
- cli: add pill deletion by slug (#325) (d96770d)
- cli: add privacy-safe doctor support reports (#185) (8265f4f)
- cli: add SSH remote query bridge (#228) (450bd05)
- cli: add tool-call-observer for live session tool calls (#254) (db7d928)
- cli: create default feature config during init (#230) (d7425df)
- cli: prove word search and ask the vector question inside init (#255) (d86ceb7)
- cli: split model check from model set and retire login (#100) (390f0cd)
- configure and parallelize hybrid query retrieval (#403) (3971d9e)
- corpuswriter: export shared conversation writer API (#209) (67de526)
- declare no-mistakes lint and test commands (#248) (36bf198)
- detected local binaries become the zero-login factory default (#33) (677eb68)
- distribution: add Claude Desktop MCP install target (#307) (e5d9f9e)
- distribution: add opt-in ZCode runtime support (#308) (19bb36e)
- distribution: add the roca cron plugin ride train (#102) (5ad3109)
- distribution: auto-install La Roca skills across agent runtimes (#193) (5755eb5)
- distribution: bundle the inert roca-corpus harvest plugin (#109) (c8b2c46)
- distribution: bundle vector with core releases (#174) (96535c7)
- distribution: install and update owner/repo plugins from published releases (#253) (6be7109)
- distribution: make bundled plugin databases self-describing and migration-resumable (#125) (53955a9)
- distribution: make custody migration explicit with roca migrate (#370) (561cb02)
- distribution: manage agent skill, prompt, and hook as versioned artifacts (#95) (0c07422)
- distribution: migrate the bundled ops plugin onto the federated manifest (#127) (b2e22ca)
- distribution: quarantine legacy execution history in shadow DATA SPLIT import (#130) (3bc3ed9)
- distribution: serve reads through the in-memory federation hub (#144) (84d841b)
- distribution: shadow memory custody in the ops plugin database (#135) (b7bacd9)
- distribution: shadow the corpus session archive in hidden version tables (#133) (3e9226b)
- distribution: store one current row per fact in corpus databases (#250) (63c3f26)
- distribution: teach exec-first hybrid search doctrine (#198) (7aaa499)
- distribution: teach federated hybrid retrieval (#224) (9722f7e)
- distribution: verify complete DATA-3 corpus custody (#166) (a48e755)
- extract agent operational writes into a bundled roca-ops plugin (#94) (eb3a974)
- extract human answering into the optional playground plugin (#359) (2a53937)
- full audit log for every call, surfaced by doctor (#69) (db85715)
- git-style plugin dispatch (#28) (3e84c0f)
- grounded exploration mode with plain and deep explore (#91) (f8b39bc)
- hooks: install the same session hook on every supported harness (48e77f9)
- incrementality: export reusable unchanged-pass primitives (#213) (f2679ee)
- ingest the Anthropic data export (#12) (54e51a7)
- ingest the sharded ChatGPT export format (#75) (d937801)
- ingest: add agent parser contribution kit (#118) (9a3086c)
- ingest: add Cursor conversation parser (#151) (77a2b3a)
- ingest: add Qwen Code and GLM parsers (#149) (3abac08)
- ingest: add ZCode desktop session ingestion (#272) (9118df7)
- ingest: capture vendor export project surfaces and claude-web memories (#157) (1183c4f)
- ingest: complete Hermes source ingestion (#180) (4248b6b)
- ingest: complete Pi private-store coverage (#141) (2b78651)
- ingest: export provenance mapping package (#208) (bafcae6)
- ingest: identify OpenCode Telegram sessions (#178) (ade17f8)
- ingest: import cloud Codex conversations from OpenAI exports (#287) (0122c9f)
- ingest: import legacy store into corpus and ops (#235) (a7592c6)
- ingest: ingest Cursor agent-home conversations (#195) (6c159bd)
- ingest: ingest Grok Build CLI sessions as a new agent family (#121) (7cd3469)
- ingest: ingest remote machine source roots (#425) (0cef9f0)
- ingest: persist canonical harness and source-model provenance (#136) (e8d1ba0)
- ingest: recover OpenCode message content (#148) (451ad87)
- launch local semantic memory for agent fleets (#1) (1a8a6dc)
- local-binary provider transport (#11) (9f0b8e0)
- one corrected retry with the gate error before degrading (#70) (a002cc9)
- ops: migrate memories to short numeric IDs (#435) (ff44a5b)
- ops: persist durable redacted call history in roca-ops (#132) (ecfeed5)
- parsers: export public parser package (#210) (07b87fa)
- per-exchange provenance across all ingesters (#39) (75c8386)
- plugin standard: per-plugin databases with semantic layers, attach-based querying, installer (#87) (8bc0284)
- plugin: register vector surface contracts (#218) (38854ff)
- plugins: add federated plugin manifest engine (#123) (bc14200)
- plugins: add opt-in vector search as an isolated executable plugin (#111) (a9db9da)
- plugins: raise plugin session companions from mcp serve (#251) (1b584a1)
- post-update capability reconciliation (#24) (d1117cd)
- query: add compound, join, and JSON SQL repairs (#202) (4451919)
- query: add hybrid FTS and vector search (#240) (fd4c32d)
- query: add per-question database scoping (#201) (9398185)
- query: support complete FTS schema generation and validation (#189) (acfc6c6)
- remove all credential machinery: models authenticate through their own CLIs (#59) (36862fc)
- repair known model SQL mistakes before the gate and validate questions first (#66) (34d2603)
- roca init lists detected agents and models and lets you choose (#41) (69cf358)
- security belt: execution timeout, prompt hardening, refuse, guarded interpretation (#85) (644adc3)
- service: auto-supersede active project handoffs (#436) (277205d)
- service: enforce and repair the live layer registry (#172) (588174e)
- skill: two-skill suite with grok and qwen seats and semantic catalog (#158) (a5c2aeb)
- store: enforce the exact duplicate law (#161) (344533b)
- support operator-defined scheduled rides (#405) (b345304)
- system-stamped authorship on memories (#64) (5d800af)
- vector: add contextual chunking and resumable re-embedding (#238) (d580f02)
- vector: add deterministic vocabulary discovery (#167) (215e7d1)
- vector: add occasion-aware writer acceleration (#269) (0bf5b27)
- vector: add optional local semantic search under roca vector (#103) (2de8acc)
- vector: compact paged embedding stores (#176) (c8177ef)
- vector: document setup and teach hybrid discovery (#183) (5b7639f)
- vector: federate queries across routed sidecars (#222) (662883c)
- vector: generate database-owned federated sidecars (#220) (493ef8a)
- vector: publish installable release archives (#171) (9b36b88)
- vector: publish verified embedding model releases (#256) (c06b83d)
- vector: remove vocab discovery command (#196) (e31c103)
- vector: ship embedded local inference engine (#237) (5a8306a)
Bug Fixes
- backfill collision groups enrich the numbered original and stay idempotent (#53) (0f614e6)
- claude-web parent-chain discards no longer cascade (#15) (f6fb987)
- cli: tell the two empty cascades apart in the model commands (#114) (d0981d8)
- concatenate remote cross results in Go and allow prompt-content searches (#377) (32628aa)
- correct cleanup verification and playground delegation (#364) (958c010)
- diagnose and prevent unsafe state ownership (#404) (bcfbcd8)
- distribution: accept MCP handoffs from runtime aliases (#414) (1cf310d)
- distribution: accept supported MCP handoff writers (#417) (d04628b)
- distribution: bind plugin installs to one verified descriptor and gate the release redirect bound (#106) (91d7d06)
- distribution: bound session-start handoffs and add cross-project view (#327) (2363e8a)
- distribution: harden frozen federation acceptance suite (#434) (5571820)
- distribution: honor max-chars in TOON output (#326) (ca7f73c)
- distribution: make search guidance vector-first (#410) (01ea4a5)
- distribution: migrate vector plugin to roca-vector (#186) (88267c6)
- distribution: remove historical ops audit storage (#383) (2a9fab4)
- distribution: remove the built-in tool-call observer (#356) (673b3f9)
- distribution: share resident vector query help (#419) (1899655)
- distribution: speed up custody migration and report progress (#462) (6f2c453)
- distribution: tolerate session collisions during corpus placement (#443) (9a33b12)
- distribution: use JSONL as the sole runtime audit destination (#379) (d74e183)
- hooks: read the artifact registry before writing a session script (0ba6692)
- hooks: say what Codex needs, and record what live sessions found (a3b4b7d)
- ingest: close memory coverage gaps and exclude manifests from corpus (#147) (4df3589)
- ingest: continue Codex history reconciliation after exact-payload collisions (#321) (786f115)
- ingest: continue legacy imports after exact-payload overlaps (#243) (4cd890d)
- ingest: index tool-only OpenCode assistant messages (#163) (7baeb96)
- ingest: make account exports one-shot imports instead of standing sources (#98) (9aea273)
- ingest: prevent write failures from aborting the corpus (#206) (9ae34a1)
- ingest: read Grok sessions from the durable update stream (#129) (a6ce158)
- ingest: recover all Hermes sessions and their conversational content (#140) (34cc532)
- ingest: recover legacy Codex prompts from fossil rollouts (#112) (9898d4e)
- ingest: reunite Codex sessions under exact source thread IDs (#394) (0a8b34f)
- isolate malformed ChatGPT conversation envelopes (#55) (76d858c)
- normalize timestamps in provenance anchor matching (#49) (d6e3aa7)
- parse 2025 codex rollout format (#62) (2971291)
- parsers: preserve Codex failures and orphan tool telemetry (#278) (45e2a70)
- plugins: an undeclared table is an orphan, not a broken plugin (#463) (24ada91)
- plugin: treat operator rides as ordinary configuration (#407) (23c5278)
- preserve exact memory IDs across JSON and MCP (#329) (f762dd9)
- preserve vector query replies received before disconnect (#376) (8f1705c)
- provenance backfill matches historical rows by content anchor (#47) (5c0e739)
- provider: isolate cursor connections and attachment lifetimes (#386) (1727f73)
- provider: reject unqualified exec tables with qualified candidates (#330) (8acd769)
- provider: route FTS queries to persistent plugin indexes (#375) (4294409)
- query: make hybrid search resilient across the federation (#245) (adbdc0c)
- query: remove SQL generation limits (#188) (563b490)
- recommend WSL for Windows installation (#275) (eab36d1)
- release tags can ship: the refusal scenario stamps its own dev build (#8) (e05ede1)
- repair and retry runtime FTS errors, keep subjects in previews, complete audit failures (#80) (85def05)
- replay provenance backfill for v2 corpora (#45) (0a6ef70)
- service: enforce exec timeouts across full SQLite scans (#441) (6953d85)
- service: speed up and harden hybrid search (#421) (9d77f41)
- store: reap lease-proven snapshot orphans (#302) (fd3a7a4)
- store: repair concurrent schema drift during adoption (#468) (#469) (39fee4e)
- store: replace read-only snapshots with live database reads (#342) (7bf58c7)
- unblock schema adoption and corpus updates (#438) (f8fd153)
- vector: avoid hashing unchanged sources and re-chunking for status (#371) (1f3f741)
- vector: avoid rehashing unchanged embedding models (#392) (2f0bcb3)
- vector: batch federation indexing and persist progress per batch (#368) (9cd7b3d)
- vector: clean session embeddings and add targeted reindexing (#164) (d7830a6)
- vector: fail fast when embedding work or status stalls (#423) (c7a09c8)
- vector: improve sidecar diagnostics and query startup (#338) (6dfda90)
- vector: make delta ingest exclusive and observable (#430) (58e24ef)
- vector: preserve ID indexes during source resolution (#399) (d074f66)
- vector: prevent delta ingest hangs under Metal contention (#257) (1986bc5)
- vector: prevent indexing and status hangs (#293) (34d44e7)
- vector: recover from trapped native indexing calls (#298) (c938bfc)
- vector: remove legacy paging and unify migration retries (#390) (509c571)
- vector: report honest per-database vector status (#303) (3b57055)
- vector: restore default queries across all ready sidecars (#388) (48a7548)
- vector: reuse legacy embeddings in federated sidecars (#226) (c91240c)
- vector: reuse one core reader per ingest or query (#381) (7116be4)
- vector: reuse the shared embedding resident for CLI queries (#340) (74e2392)
- vector: share embedding resident across MCP sessions (#331) (87654d0)
1.90.1 (2026-09-20)
Bug Fixes
- distribution: speed up custody migration and report progress (#462) (3911e07)
- plugins: an undeclared table is an orphan, not a broken plugin (#463) (213b4da)
- store: repair concurrent schema drift during adoption (#468) (#469) (2fee7ff)
1.90.0 (2026-09-19)
Features
1.89.0 (2026-09-19)
Features
1.88.2 (2026-09-19)
Bug Fixes
1.88.1 (2026-09-19)
Bug Fixes
1.88.0 (2026-09-19)
Features
Bug Fixes
1.87.2 (2026-09-19)
Bug Fixes
1.87.1 (2026-09-19)
Bug Fixes
1.87.0 (2026-09-19)
Features
1.86.6 (2026-09-18)
Bug Fixes
1.86.5 (2026-09-18)
Bug Fixes
1.86.4 (2026-09-16)
Bug Fixes
1.86.3 (2026-09-16)
Bug Fixes
1.86.2 (2026-09-16)
Bug Fixes
1.86.1 (2026-09-16)
Bug Fixes
1.86.0 (2026-09-16)
Features
- configure and parallelize hybrid query retrieval (#403) (676a650)
- support operator-defined scheduled rides (#405) (347a9ba)
Bug Fixes
- diagnose and prevent unsafe state ownership (#404) (e8ff10d)
- plugin: treat operator rides as ordinary configuration (#407) (05bda74)
1.85.1 (2026-09-15)
Bug Fixes
1.85.0 (2026-09-14)
Features
- hooks: install the same session hook on every supported harness (4f504f6)
Bug Fixes
- hooks: read the artifact registry before writing a session script (d461120)
- hooks: say what Codex needs, and record what live sessions found (164380e)
1.84.10 (2026-09-09)
Bug Fixes
1.84.9 (2026-09-09)
Bug Fixes
1.84.8 (2026-09-09)
Bug Fixes
1.84.7 (2026-09-09)
Bug Fixes
1.84.6 (2026-09-09)
Bug Fixes
1.84.5 (2026-09-09)
Bug Fixes
1.84.4 (2026-09-09)
Bug Fixes
1.84.3 (2026-09-09)
Bug Fixes
1.84.2 (2026-09-09)
Bug Fixes
1.84.1 (2026-09-09)
Bug Fixes
- preserve vector query replies received before disconnect (#376) (a43ba8d)
- provider: route FTS queries to persistent plugin indexes (#375) (27d1269)
- vector: avoid hashing unchanged sources and re-chunking for status (#371) (e38e384)
1.84.0 (2026-09-09)
Features
1.83.3 (2026-09-09)
Bug Fixes
1.83.2 (2026-09-08)
Bug Fixes
1.83.1 (2026-09-08)
Bug Fixes
1.83.0 (2026-09-08)
Features
1.82.6 (2026-09-08)
Bug Fixes
1.82.5 (2026-09-08)
Bug Fixes
1.82.4 (2026-09-08)
Bug Fixes
1.82.3 (2026-09-07)
Bug Fixes
- distribution: bound session-start handoffs and add cross-project view (#327) (f500eaa)
- preserve exact memory IDs across JSON and MCP (#329) (02cff56)
- provider: reject unqualified exec tables with qualified candidates (#330) (7c94b39)
1.82.2 (2026-09-07)
Bug Fixes
1.82.1 (2026-09-07)
Bug Fixes
1.82.0 (2026-09-07)
Features
1.81.2 (2026-09-07)
Bug Fixes
1.81.1 (2026-09-02)
Bug Fixes
1.81.0 (2026-09-02)
Features
1.80.1 (2026-09-02)
Bug Fixes
1.80.0 (2026-09-02)
Features
1.79.3 (2026-09-01)
Bug Fixes
1.79.2 (2026-09-01)
Bug Fixes
1.79.1 (2026-09-01)
Bug Fixes
1.79.0 (2026-09-01)
Features
1.78.0 (2026-09-01)
Features
1.77.1 (2026-09-01)
Bug Fixes
1.77.0 (2026-08-31)
Features
1.76.0 (2026-08-31)
Features
1.75.0 (2026-08-24)
Features
- cli: prove word search and ask the vector question inside init (#255) (6b050dc)
- declare no-mistakes lint and test commands (#248) (05552fd)
- distribution: install and update owner/repo plugins from published releases (#253) (7a5223d)
- distribution: store one current row per fact in corpus databases (#250) (c2b6313)
- plugins: raise plugin session companions from mcp serve (#251) (f441542)
- vector: publish verified embedding model releases (#256) (96ea64c)
Bug Fixes
1.74.2 (2026-08-23)
Bug Fixes
1.74.1 (2026-08-23)
Bug Fixes
1.74.0 (2026-08-23)
Features
1.73.0 (2026-08-23)
Features
1.72.0 (2026-08-23)
Features
1.71.0 (2026-08-23)
Features
1.70.0 (2026-08-22)
Features
1.69.0 (2026-08-21)
Features
1.68.1 (2026-08-21)
Bug Fixes
1.68.0 (2026-08-21)
Features
1.67.0 (2026-08-21)
Features
1.66.0 (2026-08-21)
Features
1.65.0 (2026-08-21)
Features
1.64.0 (2026-08-21)
Features
1.63.0 (2026-08-21)
Features
1.62.0 (2026-08-21)
Features
1.61.0 (2026-08-21)
Features
1.60.1 (2026-08-20)
Bug Fixes
1.60.0 (2026-08-19)
Features
1.59.0 (2026-08-19)
Features
1.58.0 (2026-08-18)
Features
1.57.0 (2026-08-18)
Features
1.56.0 (2026-08-18)
Features
1.55.0 (2026-08-18)
Features
1.54.0 (2026-08-18)
Features
1.53.1 (2026-08-18)
Bug Fixes
1.53.0 (2026-08-18)
Features
Bug Fixes
1.52.0 (2026-08-18)
Features
1.51.0 (2026-08-18)
Features
1.50.0 (2026-08-18)
Features
1.49.0 (2026-08-17)
Features
1.48.0 (2026-08-17)
Features
1.47.0 (2026-08-17)
Features
- service: enforce and repair the live layer registry (#172) (7066fac)
- vector: publish installable release archives (#171) (f388c08)
1.46.0 (2026-08-17)
Features
1.45.1 (2026-08-17)
Bug Fixes
1.45.0 (2026-08-17)
Features
Bug Fixes
1.44.0 (2026-08-17)
Features
1.43.0 (2026-08-16)
Features
1.42.0 (2026-08-16)
Features
1.41.0 (2026-08-16)
Features
1.40.1 (2026-08-16)
Bug Fixes
1.40.0 (2026-08-16)
Features
1.39.0 (2026-08-16)
Features
1.38.0 (2026-08-16)
Features
1.37.0 (2026-08-16)
Features
1.36.0 (2026-08-16)
Features
1.35.1 (2026-08-16)
Bug Fixes
1.35.0 (2026-08-15)
Features
1.34.0 (2026-08-15)
Features
1.33.0 (2026-08-15)
Features
1.32.0 (2026-08-15)
Features
1.31.1 (2026-08-15)
Bug Fixes
1.31.0 (2026-08-15)
Features
1.30.0 (2026-08-15)
Features
- distribution: make bundled plugin databases self-describing and migration-resumable (#125) (fe68927)
1.29.0 (2026-08-15)
Features
1.28.0 (2026-08-15)
Features
1.27.0 (2026-08-15)
Features
1.26.0 (2026-08-14)
Features
1.25.2 (2026-08-14)
Bug Fixes
1.25.1 (2026-08-14)
Bug Fixes
1.25.0 (2026-08-14)
Features
1.24.1 (2026-08-14)
Bug Fixes
- distribution: bind plugin installs to one verified descriptor and gate the release redirect bound (#106) (d4f0d6a)
1.24.0 (2026-08-14)
Features
1.23.0 (2026-08-14)
Features
1.22.0 (2026-08-13)
Features
1.21.1 (2026-08-13)
Bug Fixes
1.21.0 (2026-08-13)
Features
1.20.0 (2026-08-13)
Features
1.19.0 (2026-08-13)
Features
1.18.0 (2026-08-13)
Features
- plugin standard: per-plugin databases with semantic layers, attach-based querying, installer (#87) (f32a248)
1.17.0 (2026-08-13)
Features
1.16.1 (2026-08-12)
Bug Fixes
- repair and retry runtime FTS errors, keep subjects in previews, complete audit failures (#80) (138e256)