Skip to content

v1.6.4 — Project-Scoped RAG, Complete Memory Context & Reliable Sync

Choose a tag to compare

View all tags
@Lotargo Lotargo released this 13 Aug 12:13
· 174 commits to main since this release
v1.6.4
787b4cc

Highlights

This release strengthens project isolation across the Memory Notebook, RAG knowledge base, knowledge graph, snapshots, and cloud synchronization.

RAG now follows the same hygiene model as Notebook memory:

  • scope: "all" returns global knowledge plus only the current Git project.
  • Outside a Git repository, only global knowledge is available.
  • Sources shared by multiple projects are stored once with separate scope associations.
  • Global and project memories remain equal context sources; conflicts are resolved by the agent.

Project-scoped RAG

  • Added explicit global/project scope associations for RAG documents.
  • Project scope is now the default for document ingestion.
  • Added all, project, and global scopes to RAG querying and management.
  • Prevented documents and linked fact metadata from leaking across projects.
  • Made document deletion safer:
    • By default, it unlinks only the current project.
    • Outside Git, it targets global scope.
    • Broader global or all removal must be explicitly requested.
  • Reusing the same URL or path across projects no longer duplicates the underlying document.

Stable document updates

Re-ingesting an existing source now preserves:

  • Document ID
  • Project/global associations
  • Notebook fact links
  • Knowledge graph relationships

Changed content rebuilds its chunks, vectors, retrieval policies, FTS index, and structural graph edges without breaking existing references.

OpenCode improvements

  • Removed the previous ten-fact auto-injection limit.
  • OpenCode now receives complete fact bodies from global and current-project memory.
  • Superseded facts remain excluded from active context.
  • Added native batch_query_knowledge_base support.
  • OpenCode now exposes all 15 shared tools plus two native helpers.

Current tool counts:

  • 15 MCP server tools
  • 17 native OpenCode tools
  • 17 unique tool names across both integrations

Memory lifecycle fixes

  • recall now hides superseded facts by default.
  • Added includeSuperseded: true for explicit history inspection.
  • Filtered recall results retain stable storage indices for safe update and deletion.
  • Superseding legacy facts without IDs now assigns distinct IDs to both versions.
  • Updating or forgetting linked facts keeps knowledge links and graph projections consistent.

Cloud sync and snapshots

Snapshot export/import and hybrid cloud synchronization now preserve:

  • Dense vector data
  • Retrieval policies and policy provenance
  • Document scopes
  • Notebook knowledge links
  • Structural and line-range graph edges
  • Graph metadata and timestamps

The hybrid-sync worker now drains writes queued during an active flush. Partial project-scope unlinking is also synchronized correctly.

Project identity and setup

  • memory_info reports whether the current Git identity is linked or unlinked.
  • Relinking a project moves its RAG associations and Notebook-to-document links.
  • Environment-specific setup flags modify only the requested integration.
  • Codex setup installs the bundled skill into:
    • ~/.codex/skills
    • ~/.agents/skills
  • Repeated Codex setup now reports the configured environment count correctly.

Agent guidance

The bundled using-memory skill now clearly defines:

  • Full-body memory initialization
  • Automatic registration of unlinked Git repositories
  • Global/current-project isolation
  • Agent-resolved conflicts without store precedence
  • Selective RAG curation
  • Proper use of project and global RAG scopes
  • Linking durable Notebook facts to supporting documentation
  • Safe scoped document removal

Testing

Added regression coverage for:

  • RAG isolation between projects
  • Shared sources and partial unlinking
  • Stable document re-ingestion
  • Complete snapshot restoration
  • Complete hybrid cloud synchronization
  • Knowledge-link metadata isolation
  • OpenCode full-body memory injection
  • Superseded fact handling
  • Legacy fact IDs
  • Knowledge graph projection updates

All 18 unit, integration, MCP, and cloud test suites pass.

Upgrade

npm install -g @lotargo/memory_plugin@1.6.4
memory_plugin setup --codex
memory_plugin doctor --codex

Restart Codex Desktop or OpenCode after upgrading so the refreshed tool schemas and plugin code are loaded.

Assets 2
Loading