memorix 1.8.4 → 1.8.6

package/docs/MODULES.md

@@ -1,18 +1,35 @@
 # Memorix 模块详解
 
-> 最后更新: 2026-08-14 (v1.4.3)
-> 本文档详细记录每个模块的实现细节、关键算法和注意事项
+> 最后更新: 2026-09-01（当前发布线 v1.8.6）
+> 本文档记录当前模块边界、关键算法和兼容层，不把历史实现误写成运行时主路径。
 
-> 本文档中的早期 JSON/Orama 章节保留为历史模块说明。当前运行时的
-> SQLite 数据层和长期记忆生命周期以 `docs/ARCHITECTURE.md`、
-> `docs/1.3-MEMORY-ARCHITECTURE.md` 及对应源码为准。
+> 当前真实主路径先看下面的模块总览，再看各模块的细节。早期 JSON/Orama
+> 说明仍保留用于迁移和实现背景，但不代表 JSON 是运行时主存储。
+
+## 当前模块总览
+
+| 模块 | 当前作用 | 是否主路径 |
+| --- | --- | --- |
+| `store/sqlite-db.ts`、`store/sqlite-store.ts` | 持久化观察、会话、图谱、知识、长期记忆、媒体和协作状态 | 是 |
+| `store/orama-store.ts` | 从 SQLite 数据重建的全文/向量检索索引 | 是，索引层 |
+| `memory/graph.ts` | MCP 兼容的实体/关系操作外观，底层写入 SQLite | 是 |
+| `wiki/knowledge-graph.ts` | Dashboard 的证据化 Memory Map 投影，不是真实数据源 | 是，展示层 |
+| `dashboard/static/` | 只保留 ECharts Memory Map 这一套图谱界面 | 是 |
+| `dashboard/server.ts`、`cli/commands/serve-http.ts` | 独立 Dashboard 与 HTTP 控制面两个宿主；按各自绑定范围读取同一套业务模块 | 是，宿主层 |
+| `store/persistence-json.ts`、`config/legacy-loader.ts` | 老版本数据和配置的迁移/兼容读取 | 兼容层 |
+
+本轮清扫移除了 Dashboard 旧的 Cytoscape/Dagre 图谱渲染器及其前端依赖。
+后端 `/api/graph` 和 MCP 图谱工具仍保留，因为外部脚本和客户端可能直接调用它们。
+两个 Dashboard 宿主也保留：standalone 用于本地只读浏览，HTTP 控制面负责带会话和
+项目绑定的服务。它们可以共享维护逻辑，但不能因为代码位置相似就把绑定边界合并。
 
 ---
 
-## 1. Orama 搜索引擎 (`store/orama-store.ts`)
+## 1. Orama 搜索索引 (`store/orama-store.ts`)
 
 ### 概述
-基于 [Orama](https://github.com/orama/orama) 的全文/混合搜索引擎，344行。
+基于 [Orama](https://github.com/orama/orama) 的全文/混合搜索索引。它不是持久化主库；
+启动或数据变化后可从 SQLite 观察记录重建。
 
 ### Schema 设计
 ```typescript
@@ -51,14 +68,22 @@ const schema = {
 
 ### ⚠️ 注意事项
 - Orama 的 where 子句在 `term: '' + number filter` 时可能不可靠，因此 `compactDetail` 使用内存查找而非 Orama 查询
-- 数据库是内存中的，重启后需要通过 `reindexObservations()` 重建
+- 索引是内存中的，重启后需要通过 `reindexObservations()` 从 SQLite 重建
 - `resetDb()` 用于热重载场景 — 先清空再重建
 
 ---
 
-## 2. 持久化层 (`store/persistence.ts`)
+## 2. 持久化层 (`store/sqlite-db.ts`, `store/sqlite-store.ts`, `store/persistence.ts`)
+
+### 当前主路径
+
+运行时使用 `~/.memorix/data/memorix.db` 这一 SQLite 数据库。观察记录、图谱、知识
+工作区、长期记忆、媒体、会话和协作状态共享同一数据库连接与迁移机制；`projectId`
+用于数据隔离，不再通过多个 JSON 子目录拼接运行时状态。
+
+### 历史 JSON/JSONL 兼容格式
 
-### 存储目录
+以下文件只用于旧版本迁移、显式导入导出或诊断，不是新写入的主路径。
 ```
 ~/.memorix/data/
 ├── observations.json      # 所有 observation 的 JSON 数组
@@ -76,16 +101,16 @@ const schema = {
 {"name":"port-config","entityType":"config","observations":["默认端口 3001"]}
 ```
 
-### 设计决策
-- **全局共享目录** (`~/.memorix/data/`): 让不同 Agent 看到同一份数据
-- **JSONL 而非单 JSON**: 与 MCP Official Memory Server 的格式兼容
-- **observations.json 用 JSON 而非 JSONL**: observation 结构更复杂，JSON 更方便整体读写
-- **ID 计数器单独文件**: 避免扫描所有 observation 来确定下一个 ID
+### 兼容设计
+- **全局共享目录** (`~/.memorix/data/`): 让不同 Agent 看到同一份 SQLite 数据
+- **JSONL**: 保留 MCP Official Memory Server 兼容和旧数据迁移能力
+- **observations.json**: 保留旧 observation 导入和显式导出能力
+- **SQLite 事务与文件锁**: 新写入由 SQLite 事务负责一致性，必要时仍使用文件锁保护跨进程操作
 
 ### ⚠️ 注意事项
-- v0.9.6 后所有数据存储在单一平坦目录 `~/.memorix/data/`，projectId 仅作为元数据
-- 有文件锁机制 (`store/file-lock.ts`) — 使用 `.memorix.lock` 目录锁 + 10s 超时检测
-- 热重载使用 `fs.watchFile` (polling) 监听 `observations.json` 变化
+- `store/persistence-json.ts` 是兼容模块，不要把它当成新的写入 API
+- `migrateSubdirsToFlat()` 只处理早期按项目分目录的数据
+- `store/obs-store.ts` 在 SQLite 不可用时会进入只读降级模式，不应偷偷回写 `observations.json`
 
 ---
 
@@ -105,12 +130,13 @@ const schema = {
 | `readGraph` | 返回完整图谱 |
 
 ### 持久化时机
-- 每次 CRUD 操作后立即写入磁盘
-- `init()` 时从磁盘加载
+- 每次 CRUD 操作后立即写入共享 SQLite 数据库
+- `init()` 时从 SQLite 加载
 
 ### ⚠️ 注意事项
 - `createEntities` 对同名实体是幂等的 — 不会覆盖已有观察
 - 关系的 `from` 和 `to` 必须引用已存在的实体名
+- JSONL 只属于兼容输入/输出；当前实体和关系由 SQLite `graph_entities`、`graph_relations` 表提供
 
 ---
 

package/docs/PERFORMANCE.md

@@ -57,7 +57,7 @@ On the release development machine used for this check, the healthy HTTP service
 
 ## What Can Be Heavier
 
-- `npm run build`, `npx vitest run`, and Docker image builds can use substantial CPU and disk while they run.
+- `npm run build` and `npx vitest run` can use substantial CPU and disk while they run. Local verification uses the sequential Node/npm build and does not require Docker; Docker image builds are reserved for the VPS/hosted deployment path.
 - Docker image size mostly comes from Node, npm dependencies, build artifacts, and image layers. The container runtime should be judged separately from image size.
 - Dashboard browsing can add browser-side memory and CPU outside the Memorix Node process.
 - Large imports, Git log ingestion, workspace sync, and skill generation can temporarily increase CPU and disk I/O.

package/docs/README.md

@@ -79,6 +79,7 @@ The public docs are organized by user intent:
 | System shape, data flows, memory layers | [ARCHITECTURE.md](ARCHITECTURE.md) |
 | Design decisions and rationale | [DESIGN_DECISIONS.md](DESIGN_DECISIONS.md) |
 | Module-by-module notes | [MODULES.md](MODULES.md) |
+| Current implementation status and ecosystem watch | [ACTIVE_WORK.md](../ACTIVE_WORK.md) |
 | CodeGraph Memory / Context Fabric design | [2026-06-29-codegraph-memory-context-fabric-design.md](superpowers/specs/2026-06-29-codegraph-memory-context-fabric-design.md) |
 | Auto Context Layer design | [2026-06-29-auto-context-layer-design.md](superpowers/specs/2026-06-29-auto-context-layer-design.md) |
 | 1.2 product direction and user journey | [1.2 Product Story](1.2.0-PRODUCT-STORY.md) |
@@ -94,7 +95,7 @@ The public docs are organized by user intent:
 | 1.2 honest Lite and optional semantic CodeGraph provider contract | [1.2 Provider Quality](1.2.0-PROVIDER-QUALITY.md) |
 | 1.3 long-term memory model, source boundary, and lifecycle | [1.3 Memory Architecture](1.3-MEMORY-ARCHITECTURE.md) |
 | Active context-control work | [1.2.2 Memory Control Plane](1.2.2-MEMORY-CONTROL-PLANE.md) |
-| 1.8.4 MCP compatibility acceptance contract | [1.8.0 Release Specification](1.8.0-RELEASE-CANDIDATE-SPEC.md) |
+| 1.8.6 MCP compatibility acceptance contract | [1.8.0 Release Specification](1.8.0-RELEASE-CANDIDATE-SPEC.md) |
 | Historical cloud sync and multi-agent research | [CLOUD_SYNC_AND_MULTI_AGENT_RESEARCH.md](CLOUD_SYNC_AND_MULTI_AGENT_RESEARCH.md) |
 | Known issues and old roadmap notes | [KNOWN_ISSUES_AND_ROADMAP.md](KNOWN_ISSUES_AND_ROADMAP.md) |
 
@@ -122,7 +123,7 @@ Historical/deep-reference documents may describe older designs. If they conflict
 
 ## Current Product Line
 
-The current product line is **1.8.4**. The authoritative acceptance contract is
+The current product line is **1.8.6**. The authoritative acceptance contract is
 [1.8.0 Release Specification](1.8.0-RELEASE-CANDIDATE-SPEC.md).
 The current baseline has:
 
@@ -141,13 +142,13 @@ The current baseline has:
 - `~/.memorix/config.toml` and project `memorix.toml` are the user-facing configuration model
 - legacy `memorix.yml`, `.env`, and `config.json` files are still read for compatibility, but new setups should use TOML
 
-For MCP compatibility, 1.8.4 preserves legacy 2025-era initialize and
+For MCP compatibility, 1.8.6 preserves legacy 2025-era initialize and
 stateful Streamable HTTP behavior. `memorix serve` starts a bounded stdio
 startup gate: pre-initialize 2026-07-28 `server/discover` is answered with a
 complete discovery result, and other early JSON-RPC messages replay in order
 through the pinned SDK transport. Versionless `tools/list` and `tools/call`
 continue through the SDK's legacy result envelopes. Modern result metadata is
-limited to the discovery response (`ttlMs: 0`, private cache scope); Tasks,
-subscriptions, and list-response caching are unsupported. Stateless HTTP
-project handles are a compatibility adapter, not a claim of complete 2026
-conformance.
+returned for discovery, list, and call responses. The official subscriptions
+listen surface is available. Durable Tasks remain explicitly unsupported, and
+list responses carry a private zero-TTL hint instead of a reusable server-side
+cache. Stateless HTTP project handles are supported on the modern path.

package/docs/SETUP.md

@@ -24,7 +24,7 @@ Common runtime entry points:
 | `memorix serve-http --port 3211` | foreground HTTP MCP for debugging or supervised launches |
 | `memorix` / `memcode` | bundled terminal agent that uses the same Memorix memory pool |
 
-Most users should start with `memorix setup --agent <agent> --global`. Use raw `memorix serve` only when you are wiring an MCP client manually. Use HTTP when you intentionally want one shared background process, browser dashboard, Docker deployment, or multiple clients using the same MCP endpoint. Use the CLI for manual operation and automation. Use memcode when you want the bundled terminal agent.
+Most users should start with `memorix setup --agent <agent> --global`. Use raw `memorix serve` only when you are wiring an MCP client manually. Use HTTP when you intentionally want one shared background process, browser dashboard, VPS Docker deployment, or multiple clients using the same MCP endpoint. Local development and verification run the Node service directly and do not require Docker. Use the CLI for manual operation and automation. Use memcode when you want the bundled terminal agent.
 
 For agent-specific plugin, rules, hooks, and skills support, see [INTEGRATIONS.md](INTEGRATIONS.md).
 
@@ -151,7 +151,7 @@ memorix serve
 
 Use this when your agent only needs a raw local stdio MCP process or you are debugging a manual config. The agent starts `memorix serve` and communicates with it over stdio.
 
-A bare `memorix serve` defaults to `--mode micro`, which exposes 9 high-signal tools so agent context is not crowded by rarely used schemas. Use `memorix serve --mode lite` for the extended solo memory surface, `--mode team` for coordination tools, or `--mode full` for advanced and MCP Memory compatibility tools.
+A bare `memorix serve` defaults to `--mode micro`, which exposes 9 high-signal tools so agent context is not crowded by rarely used schemas. Use `memorix serve --mode lite` for the 20-tool solo memory surface, `--mode team` for the 28-tool coordination surface, or `--mode full` for all 47 advanced and MCP Memory compatibility tools.
 
 `memorix setup` writes `--mode lite` into the installed MCP config: the generated guidance teaches the extended surface (sessions, timeline, reasoning, retention), so the installed server must actually expose it. Override with `MEMORIX_MODE` if you prefer a different profile.
 
@@ -216,7 +216,7 @@ This starts a local background service:
 - MCP endpoint: `http://localhost:3211/mcp`
 - health: `http://localhost:3211/health`
 
-HTTP mode is for a shared process. It is useful when multiple clients should connect to one Memorix endpoint, when you want the browser dashboard, or when running Memorix through Docker. It is not needed for the normal one-agent stdio MCP setup.
+HTTP mode is for a shared process. It is useful when multiple clients should connect to one Memorix endpoint, when you want the browser dashboard, or when running Memorix through Docker on a VPS/hosted machine. It is not needed for the normal one-agent stdio MCP setup.
 
 Companion commands:
 
@@ -683,6 +683,7 @@ Common MCP config locations:
 | Oh-my-Pi | `.omp/mcp.json` or `~/.omp/agent/mcp.json` |
 | Trae | `%APPDATA%/Trae/User/mcp.json` on Windows |
 | DeepSeek Harness | `$DSH_HOME/cordis.patch.yml` (default `~/.dsh/cordis.patch.yml`) |
+| WorkBuddy | `~/.workbuddy/mcp.json` (user) or `<project>/.workbuddy/mcp.json` (project) |
 
 ---
 

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "memorix",
   "mcpName": "io.github.AVIDS2/memorix",
-  "version": "1.8.4",
+  "version": "1.8.6",
   "description": "Local-first shared memory layer for AI coding agents across MCP clients, Git history, reasoning context, and project sessions.",
   "type": "module",
   "sideEffects": false,
@@ -57,12 +57,19 @@
   ],
   "scripts": {
     "build:workspaces": "npm --workspaces --if-present run build",
-    "build": "npm run build:workspaces && node -e \"require('fs').rmSync('dist',{recursive:true,force:true})\" && tsup",
+    "build:runtime": "tsup --config tsup.runtime.config.ts",
+    "build:cli": "tsup --config tsup.cli.config.ts",
+    "build:memcode": "tsup --config tsup.memcode.config.ts",
+    "build": "npm run build:workspaces && node -e \"require('fs').rmSync('dist',{recursive:true,force:true})\" && npm run build:runtime && npm run build:cli && npm run build:memcode",
     "dev": "tsup --watch",
     "update-models": "npm --workspace @memorix/ai run update-models",
     "start": "node dist/index.js",
     "test": "vitest run --no-file-parallelism --maxWorkers=1 --minWorkers=1",
     "test:mcp-stdio-smoke": "node scripts/mcp-stdio-smoke.mjs",
+    "test:mcp-modern-stdio-smoke": "node scripts/mcp-modern-stdio-smoke.mjs",
+    "test:mcp-conformance-smoke": "node scripts/mcp-conformance-smoke.mjs",
+    "test:mcp-modern-smoke": "node scripts/mcp-modern-smoke.mjs",
+    "test:background-start-smoke": "node scripts/background-start-smoke.mjs",
     "test:watch": "vitest",
     "test:llm-live": "MEMORIX_RUN_LIVE_LLM_TESTS=1 vitest run tests/integration/formation-llm-quality.test.ts",
     "test:e2e": "vitest run tests/e2e/",
@@ -127,14 +134,11 @@
   },
   "dependencies": {
     "@clack/prompts": "^0.9.1",
+    "@modelcontextprotocol/node": "^2.0.0",
+    "@modelcontextprotocol/server": "^2.0.0",
     "@modelcontextprotocol/sdk": "^1.30.0",
     "@orama/orama": "^3.1.0",
-    "@orama/plugin-data-persistence": "^3.1.0",
     "citty": "^0.1.6",
-    "cytoscape": "^3.33.1",
-    "cytoscape-dagre": "^2.5.0",
-    "dagre": "^0.8.5",
-    "diff": "^9.0.0",
     "dotenv": "^17.3.1",
     "gpt-tokenizer": "^2.8.0",
     "ink": "^6.8.0",
@@ -143,9 +147,6 @@
     "ink-scroll-view": "^0.3.6",
     "ink-spinner": "^5.0.0",
     "react": "19.2.7",
-    "remark": "^15.0.1",
-    "remark-stringify": "^11.0.0",
-    "undici": "8.10.0",
     "unpdf": "^1.8.0",
     "yaml": "2.9.0",
     "zod": "^3.24.0"
@@ -174,7 +175,6 @@
   },
   "devDependencies": {
     "@types/better-sqlite3": "^7.6.0",
-    "@types/diff": "^7.0.0",
     "@types/node": "^22.0.0",
     "@types/react": "19.2.7",
     "ink-testing-library": "^4.0.0",

package/plugins/antigravity/memorix/plugin.json

@@ -1,4 +1,4 @@
 {
   "name": "memorix",
-  "version": "1.8.4"
+  "version": "1.8.6"
 }

package/plugins/antigravity/memorix/rules/memorix.md

@@ -9,9 +9,14 @@ Use Memorix when prior workspace context, decisions, fixes, or handoff state wou
 - Use `memorix_search` for focused lookup.
 - Use `memorix_detail` before relying on a specific memory.
 - Use `memorix_store` for durable workspace knowledge.
+- Use `memorix_evidence` when you need to check a memory's source, freshness, or verification state.
+- Use `memorix_feedback` when a memory helped, conflicted with current evidence, or was corrected.
+- Use `memorix_media` for controlled local media import, inspection, and derivation; provider-backed generation remains explicitly gated.
 - Use `longTerm` on `memorix_store` only for a stable fact, reusable procedure, or completed episode that merits explicit review. It creates a candidate, not live context; keep the default project scope and do not use it for routine updates.
 - A `user` + `portable` durable memory in a task brief is intentionally reusable across projects. When it matches the task, use it as background even if it originated elsewhere; it is not a current-project fact. Expand it only when needed with `memorix_detail` and `typedRefs: ["durable:<id>"]`, stating the missing fact as `purpose`.
 - Use `memorix_store_reasoning` for the reason behind a technical decision.
 - Use `memorix_resolve` when completed or outdated memories should stop surfacing.
 
+The standard plugin uses the `lite` MCP profile (20 tools). Coordination and advanced tools are opt-in through `--mode team` or `--mode full`; use the CLI fallback instead of repeatedly probing unavailable tools.
+
 Do not store secrets, credentials, raw private transcripts, or trivial one-off actions.

package/plugins/claude/memorix/.claude-plugin/plugin.json

@@ -1,7 +1,7 @@
 {
   "$schema": "https://anthropic.com/claude-code/plugin.schema.json",
   "name": "memorix",
-  "version": "1.8.4",
+  "version": "1.8.6",
   "description": "Shared workspace memory for Claude Code and other AI coding agents.",
   "author": {
     "name": "AVIDS2",

package/plugins/claude/memorix/skills/memorix-memory/SKILL.md

@@ -16,6 +16,9 @@ Use Memorix as the shared memory layer for the active workspace when Memorix too
 | Specific past decision, bug, file, or change | `memorix_search` | `memorix memory search --query "<topic>"` |
 | Need the full source for a search hit | `memorix_detail` | `memorix memory detail --id <id>` |
 | Need the sequence around one memory | `memorix_timeline` | `memorix memory timeline --id <id>` |
+| Check source and freshness for a memory | `memorix_evidence` | `memorix evidence list|get|events` |
+| Record whether a memory helped, conflicted, or was corrected | `memorix_feedback` | `memorix feedback record|show|audit` |
+| Inspect or import controlled media | `memorix_media` | `memorix media import|attach|list|show|status` |
 | Learned reusable project knowledge | `memorix_store` | `memorix memory store --type <type> --entity <name> --title "<title>" "<text>"` |
 | Stable source-backed fact or procedure needing long-term review | `memorix_store` with `longTerm` | `memorix memory long-term qualify|approve --id <id> --reason "..."` |
 | Task or bug is complete/outdated | `memorix_resolve` | `memorix memory resolve --ids <ids>` |

package/plugins/claude/memorix/skills/memorix-mini-skills/SKILL.md

@@ -7,6 +7,8 @@ description: Use when durable project knowledge, gotchas, workflows, or repeated
 
 Promote memories into mini-skills only when they are reusable instructions, not just historical notes.
 
+The standard setup uses the `lite` MCP profile. `memorix_skills` and `memorix_promote` are full-profile tools, so use the CLI fallback unless the current server was explicitly started with `MEMORIX_MODE=full` or `--mode full`. Do not probe hidden MCP tools repeatedly.
+
 ## Tool Router
 
 | Situation | Prefer | CLI fallback |

package/plugins/claude/memorix/skills/memorix-orchestrate/SKILL.md

@@ -7,6 +7,8 @@ description: Use when a main agent needs Memorix to coordinate explicit subagent
 
 Use Memorix coordination for explicit subagent workflows with joined identities, tasks, handoffs, messages, file locks, and orchestrated workers.
 
+The standard setup uses the `lite` MCP profile. Coordination MCP tools are exposed only by `team` or `full`; use the CLI fallback for ordinary installations, or explicitly start the server with `--mode team`. Do not probe unavailable team tools in a loop.
+
 ## Tool Router
 
 | Situation | Prefer | CLI fallback |

package/plugins/codebuddy/memorix/.codebuddy-plugin/plugin.json

@@ -1,6 +1,6 @@
 {
   "name": "memorix",
-  "version": "1.8.4",
+  "version": "1.8.6",
   "description": "Local-first project memory for CodeBuddy Code and other coding agents.",
   "author": {
     "name": "AVIDS2",

package/plugins/codebuddy/memorix/skills/memorix-memory/SKILL.md

@@ -16,6 +16,9 @@ Use Memorix as the shared memory layer for the active workspace when Memorix too
 | Specific past decision, bug, file, or change | `memorix_search` | `memorix memory search --query "<topic>"` |
 | Need the full source for a search hit | `memorix_detail` | `memorix memory detail --id <id>` |
 | Need the sequence around one memory | `memorix_timeline` | `memorix memory timeline --id <id>` |
+| Check source and freshness for a memory | `memorix_evidence` | `memorix evidence list|get|events` |
+| Record whether a memory helped, conflicted, or was corrected | `memorix_feedback` | `memorix feedback record|show|audit` |
+| Inspect or import controlled media | `memorix_media` | `memorix media import|attach|list|show|status` |
 | Learned reusable project knowledge | `memorix_store` | `memorix memory store --type <type> --entity <name> --title "<title>" "<text>"` |
 | Stable source-backed fact or procedure needing long-term review | `memorix_store` with `longTerm` | `memorix memory long-term qualify|approve --id <id> --reason "..."` |
 | Task or bug is complete/outdated | `memorix_resolve` | `memorix memory resolve --ids <ids>` |

package/plugins/codebuddy/memorix/skills/memorix-mini-skills/SKILL.md

@@ -7,6 +7,8 @@ description: Use when durable project knowledge, gotchas, workflows, or repeated
 
 Promote memories into mini-skills only when they are reusable instructions, not just historical notes.
 
+The standard setup uses the `lite` MCP profile. `memorix_skills` and `memorix_promote` are full-profile tools, so use the CLI fallback unless the current server was explicitly started with `MEMORIX_MODE=full` or `--mode full`. Do not probe hidden MCP tools repeatedly.
+
 ## Tool Router
 
 | Situation | Prefer | CLI fallback |

package/plugins/codebuddy/memorix/skills/memorix-orchestrate/SKILL.md

@@ -7,6 +7,8 @@ description: Use when a main agent needs Memorix to coordinate explicit subagent
 
 Use Memorix coordination for explicit subagent workflows with joined identities, tasks, handoffs, messages, file locks, and orchestrated workers.
 
+The standard setup uses the `lite` MCP profile. Coordination MCP tools are exposed only by `team` or `full`; use the CLI fallback for ordinary installations, or explicitly start the server with `--mode team`. Do not probe unavailable team tools in a loop.
+
 ## Tool Router
 
 | Situation | Prefer | CLI fallback |

package/plugins/codex/memorix/.codex-plugin/plugin.json

@@ -1,6 +1,6 @@
 {
   "name": "memorix",
-  "version": "1.8.4",
+  "version": "1.8.6",
   "description": "Shared workspace memory for Codex and other AI coding agents.",
   "author": {
     "name": "AVIDS2",

package/plugins/codex/memorix/skills/memorix-memory/SKILL.md

@@ -17,6 +17,9 @@ Use Memorix as the shared memory layer for the active workspace when Memorix too
 | Specific past decision, bug, file, or change | `memorix_search` | `memorix memory search --query "<topic>"` |
 | Need the full source for a search hit | `memorix_detail` | `memorix memory detail --id <id>` |
 | Need the sequence around one memory | `memorix_timeline` | `memorix memory timeline --id <id>` |
+| Check source and freshness for a memory | `memorix_evidence` | `memorix evidence list|get|events` |
+| Record whether a memory helped, conflicted, or was corrected | `memorix_feedback` | `memorix feedback record|show|audit` |
+| Inspect or import controlled media | `memorix_media` | `memorix media import|attach|list|show|status` |
 | Learned reusable project knowledge | `memorix_store` | `memorix memory store --type <type> --entity <name> --title "<title>" "<text>"` |
 | Stable source-backed fact or procedure needing long-term review | `memorix_store` with `longTerm` | `memorix memory long-term qualify|approve --id <id> --reason "..."` |
 | Task or bug is complete/outdated | `memorix_resolve` | `memorix memory resolve --ids <ids>` |

package/plugins/codex/memorix/skills/memorix-mini-skills/SKILL.md

@@ -7,6 +7,8 @@ description: Use when durable project knowledge, gotchas, workflows, or repeated
 
 Promote memories into mini-skills only when they are reusable instructions, not just historical notes.
 
+The standard setup uses the `lite` MCP profile. `memorix_skills` and `memorix_promote` are full-profile tools, so use the CLI fallback unless the current server was explicitly started with `MEMORIX_MODE=full` or `--mode full`. Do not probe hidden MCP tools repeatedly.
+
 ## Tool Router
 
 | Situation | Prefer | CLI fallback |

package/plugins/codex/memorix/skills/memorix-orchestrate/SKILL.md

@@ -7,6 +7,8 @@ description: Use when a main agent needs Memorix to coordinate explicit subagent
 
 Use Memorix coordination for explicit subagent workflows with joined identities, tasks, handoffs, messages, file locks, and orchestrated workers.
 
+The standard setup uses the `lite` MCP profile. Coordination MCP tools are exposed only by `team` or `full`; use the CLI fallback for ordinary installations, or explicitly start the server with `--mode team`. Do not probe unavailable team tools in a loop.
+
 ## Tool Router
 
 | Situation | Prefer | CLI fallback |

package/plugins/copilot/memorix/plugin.json

@@ -1,6 +1,6 @@
 {
   "name": "memorix",
-  "version": "1.8.4",
+  "version": "1.8.6",
   "description": "Shared local workspace memory for GitHub Copilot CLI and other AI coding agents.",
   "author": {
     "name": "AVIDS2",

package/plugins/copilot/memorix/skills/memorix-memory/SKILL.md

@@ -17,6 +17,9 @@ Use Memorix as the shared memory layer for the active workspace when Memorix too
 | Specific past decision, bug, file, or change | `memorix_search` | `memorix memory search --query "<topic>"` |
 | Need the full source for a search hit | `memorix_detail` | `memorix memory detail --id <id>` |
 | Need the sequence around one memory | `memorix_timeline` | `memorix memory timeline --id <id>` |
+| Check source and freshness for a memory | `memorix_evidence` | `memorix evidence list|get|events` |
+| Record whether a memory helped, conflicted, or was corrected | `memorix_feedback` | `memorix feedback record|show|audit` |
+| Inspect or import controlled media | `memorix_media` | `memorix media import|attach|list|show|status` |
 | Learned reusable project knowledge | `memorix_store` | `memorix memory store --type <type> --entity <name> --title "<title>" "<text>"` |
 | Stable source-backed fact or procedure needing long-term review | `memorix_store` with `longTerm` | `memorix memory long-term qualify|approve --id <id> --reason "..."` |
 | Task or bug is complete/outdated | `memorix_resolve` | `memorix memory resolve --ids <ids>` |

package/plugins/copilot/memorix/skills/memorix-mini-skills/SKILL.md

@@ -7,6 +7,8 @@ description: Use when durable project knowledge, gotchas, workflows, or repeated
 
 Promote memories into mini-skills only when they are reusable instructions, not just historical notes.
 
+The standard setup uses the `lite` MCP profile. `memorix_skills` and `memorix_promote` are full-profile tools, so use the CLI fallback unless the current server was explicitly started with `MEMORIX_MODE=full` or `--mode full`. Do not probe hidden MCP tools repeatedly.
+
 ## Tool Router
 
 | Situation | Prefer | CLI fallback |

package/plugins/copilot/memorix/skills/memorix-orchestrate/SKILL.md

@@ -7,6 +7,8 @@ description: Use when a main agent needs Memorix to coordinate explicit subagent
 
 Use Memorix coordination for explicit subagent workflows with joined identities, tasks, handoffs, messages, file locks, and orchestrated workers.
 
+The standard setup uses the `lite` MCP profile. Coordination MCP tools are exposed only by `team` or `full`; use the CLI fallback for ordinary installations, or explicitly start the server with `--mode team`. Do not probe unavailable team tools in a loop.
+
 ## Tool Router
 
 | Situation | Prefer | CLI fallback |

package/plugins/cursor/memorix/skills/memorix-memory/SKILL.md

@@ -17,6 +17,9 @@ Use Memorix as the shared memory layer for the active workspace when Memorix too
 | Specific past decision, bug, file, or change | `memorix_search` | `memorix memory search --query "<topic>"` |
 | Need the full source for a search hit | `memorix_detail` | `memorix memory detail --id <id>` |
 | Need the sequence around one memory | `memorix_timeline` | `memorix memory timeline --id <id>` |
+| Check source and freshness for a memory | `memorix_evidence` | `memorix evidence list|get|events` |
+| Record whether a memory helped, conflicted, or was corrected | `memorix_feedback` | `memorix feedback record|show|audit` |
+| Inspect or import controlled media | `memorix_media` | `memorix media import|attach|list|show|status` |
 | Learned reusable project knowledge | `memorix_store` | `memorix memory store --type <type> --entity <name> --title "<title>" "<text>"` |
 | Stable source-backed fact or procedure needing long-term review | `memorix_store` with `longTerm` | `memorix memory long-term qualify|approve --id <id> --reason "..."` |
 | Task or bug is complete/outdated | `memorix_resolve` | `memorix memory resolve --ids <ids>` |

package/plugins/cursor/memorix/skills/memorix-mini-skills/SKILL.md

@@ -7,6 +7,8 @@ description: Use when durable project knowledge, gotchas, workflows, or repeated
 
 Promote memories into mini-skills only when they are reusable instructions, not just historical notes.
 
+The standard setup uses the `lite` MCP profile. `memorix_skills` and `memorix_promote` are full-profile tools, so use the CLI fallback unless the current server was explicitly started with `MEMORIX_MODE=full` or `--mode full`. Do not probe hidden MCP tools repeatedly.
+
 ## Tool Router
 
 | Situation | Prefer | CLI fallback |

package/plugins/cursor/memorix/skills/memorix-orchestrate/SKILL.md

@@ -7,6 +7,8 @@ description: Use when a main agent needs Memorix to coordinate explicit subagent
 
 Use Memorix coordination for explicit subagent workflows with joined identities, tasks, handoffs, messages, file locks, and orchestrated workers.
 
+The standard setup uses the `lite` MCP profile. Coordination MCP tools are exposed only by `team` or `full`; use the CLI fallback for ordinary installations, or explicitly start the server with `--mode team`. Do not probe unavailable team tools in a loop.
+
 ## Tool Router
 
 | Situation | Prefer | CLI fallback |

package/plugins/gemini/memorix/GEMINI.md

@@ -11,9 +11,14 @@ Use Memorix when prior workspace context, decisions, fixes, or handoff state wou
 - Use `memorix_search` for focused lookup.
 - Use `memorix_detail` before relying on a specific memory.
 - Use `memorix_store` for durable workspace knowledge.
+- Use `memorix_evidence` when you need to check a memory's source, freshness, or verification state.
+- Use `memorix_feedback` when a memory helped, conflicted with current evidence, or was corrected.
+- Use `memorix_media` for controlled local media import, inspection, and derivation; provider-backed generation remains explicitly gated.
 - Use `longTerm` on `memorix_store` only for a stable fact, reusable procedure, or completed episode that merits explicit review. It creates a candidate, not live context; keep the default project scope and do not use it for routine updates.
 - A `user` + `portable` durable memory in a task brief is intentionally reusable across projects. When it matches the task, use it as background even if it originated elsewhere; it is not a current-project fact. Expand it only when needed with `memorix_detail` and `typedRefs: ["durable:<id>"]`, stating the missing fact as `purpose`.
 - Use `memorix_store_reasoning` for the reason behind a technical decision.
 - Use `memorix_resolve` when completed or outdated memories should stop surfacing.
 
+The standard extension uses the `lite` MCP profile (20 tools). Coordination and advanced tools are opt-in through `--mode team` or `--mode full`; use the CLI fallback instead of repeatedly probing unavailable tools.
+
 Do not store secrets, credentials, raw private transcripts, or trivial one-off actions.

package/plugins/gemini/memorix/gemini-extension.json

@@ -1,6 +1,6 @@
 {
   "name": "memorix",
-  "version": "1.8.4",
+  "version": "1.8.6",
   "mcpServers": {
     "memorix": {
       "command": "memorix",

package/plugins/hermes/memorix/plugin.yaml

@@ -1,5 +1,5 @@
 name: memorix
-version: "1.8.4"
+version: "1.8.6"
 description: Shared workspace memory bridge for Hermes Agent.
 author: AVIDS2
 license: Apache-2.0
@@ -15,3 +15,9 @@ provides_cli_commands:
   - memorix
 provides_skills:
   - memorix-memory
+  - memorix-reasoning
+  - memorix-sessions
+  - memorix-git-memory
+  - memorix-mini-skills
+  - memorix-orchestrate
+  - memorix-troubleshooting

package/plugins/omp/memorix/package.json

@@ -1,6 +1,6 @@
 {
   "name": "memorix-omp-package",
-  "version": "1.8.4",
+  "version": "1.8.6",
   "description": "Memorix shared workspace memory package for Oh-my-Pi.",
   "license": "Apache-2.0",
   "keywords": [

package/plugins/openclaw/memorix/.codex-plugin/plugin.json

@@ -1,6 +1,6 @@
 {
   "name": "memorix",
-  "version": "1.8.4",
+  "version": "1.8.6",
   "description": "Shared workspace memory for OpenClaw and other AI coding agents.",
   "author": {
     "name": "AVIDS2",

package/plugins/pi/memorix/package.json

@@ -1,6 +1,6 @@
 {
   "name": "memorix-pi-package",
-  "version": "1.8.4",
+  "version": "1.8.6",
   "description": "Memorix shared workspace memory package for Pi coding agent.",
   "license": "Apache-2.0",
   "keywords": [

package/plugins/pi/memorix/skills/memorix-memory/SKILL.md

@@ -17,6 +17,9 @@ Use Memorix as the shared memory layer for the active workspace when Memorix too
 | Specific past decision, bug, file, or change | `memorix_search` | `memorix memory search --query "<topic>"` |
 | Need the full source for a search hit | `memorix_detail` | `memorix memory detail --id <id>` |
 | Need the sequence around one memory | `memorix_timeline` | `memorix memory timeline --id <id>` |
+| Check source and freshness for a memory | `memorix_evidence` | `memorix evidence list|get|events` |
+| Record whether a memory helped, conflicted, or was corrected | `memorix_feedback` | `memorix feedback record|show|audit` |
+| Inspect or import controlled media | `memorix_media` | `memorix media import|attach|list|show|status` |
 | Learned reusable project knowledge | `memorix_store` | `memorix memory store --type <type> --entity <name> --title "<title>" "<text>"` |
 | Stable source-backed fact or procedure needing long-term review | `memorix_store` with `longTerm` | `memorix memory long-term qualify|approve --id <id> --reason "..."` |
 | Task or bug is complete/outdated | `memorix_resolve` | `memorix memory resolve --ids <ids>` |

package/plugins/pi/memorix/skills/memorix-mini-skills/SKILL.md

@@ -7,6 +7,8 @@ description: Use when durable project knowledge, gotchas, workflows, or repeated
 
 Promote memories into mini-skills only when they are reusable instructions, not just historical notes.
 
+The standard setup uses the `lite` MCP profile. `memorix_skills` and `memorix_promote` are full-profile tools, so use the CLI fallback unless the current server was explicitly started with `MEMORIX_MODE=full` or `--mode full`. Do not probe hidden MCP tools repeatedly.
+
 ## Tool Router
 
 | Situation | Prefer | CLI fallback |

package/plugins/pi/memorix/skills/memorix-orchestrate/SKILL.md

@@ -7,6 +7,8 @@ description: Use when a main agent needs Memorix to coordinate explicit subagent
 
 Use Memorix coordination for explicit subagent workflows with joined identities, tasks, handoffs, messages, file locks, and orchestrated workers.
 
+The standard setup uses the `lite` MCP profile. Coordination MCP tools are exposed only by `team` or `full`; use the CLI fallback for ordinary installations, or explicitly start the server with `--mode team`. Do not probe unavailable team tools in a loop.
+
 ## Tool Router
 
 | Situation | Prefer | CLI fallback |

package/server.json

@@ -7,7 +7,7 @@
     "url": "https://github.com/AVIDS2/memorix",
     "source": "github"
   },
-  "version": "1.8.4",
+  "version": "1.8.6",
   "websiteUrl": "https://github.com/AVIDS2/memorix#readme",
   "icons": [
     {
@@ -22,7 +22,7 @@
     {
       "registryType": "npm",
       "identifier": "memorix",
-      "version": "1.8.4",
+      "version": "1.8.6",
       "runtimeHint": "npx",
       "packageArguments": [
         {