memorix 1.0.0 → 1.0.1

package/CHANGELOG.md

@@ -2,6 +2,83 @@
 
 All notable changes to this project will be documented in this file.
 
+## [1.0.1] — 2026-03-14
+
+### Fixed
+- **OpenCode stdout pollution** — Removed all `console.log` / `console.error` from the generated OpenCode plugin template. Hooks now run fully silent. (fixes #15)
+- **OpenCode session_id missing** — `normalizeOpenCode()` now reads `session_id` from the payload instead of hardcoding empty string. Plugin template generates and injects a stable session ID per plugin lifetime. (fixes #14)
+- **Auto-install hooks scope** — Hooks are now only auto-installed for IDEs whose project-level config directory already exists (e.g., `.cursor/`, `.windsurf/`), preventing unwanted IDE directories from appearing in projects opened with a different IDE.
+
+### Added
+- **`MEMORIX_DATA_DIR` environment variable** — Override the default data directory (`~/.memorix/data/`) by setting `MEMORIX_DATA_DIR`. Applied consistently across persistence, alias registry, and embedding cache.
+
+---
+
+## [1.0.0] — 2026-03-09
+
+### 🎉 First Stable Release
+
+Memorix reaches v1.0.0 — all major features complete. Future versions will iterate based on AI/agent ecosystem evolution.
+
+### Added
+- **Multi-Agent Team Collaboration** — 4 team tools (`team_manage`, `team_file_lock`, `team_task`, `team_message`) for cross-IDE agent coordination. File-based persistence via `team-state.json`. Verified: Windsurf ↔ Antigravity bidirectional communication.
+- **Auto-Cleanup on Startup** — Background retention archiving and intelligent deduplication run automatically in `deferredInit`. With LLM configured: semantic dedup via any OpenAI-compatible model. Without LLM: Jaccard similarity consolidation. Zero manual maintenance required.
+- **`memorix_transfer` tool** — Merged `memorix_export` + `memorix_import` into a single tool with `action: "export" | "import"`.
+- **TEAM.md** — Multi-agent coordination protocol documentation.
+
+### Changed
+- **Tool consolidation: 41 → 22 default tools (-46%)**
+  - Team tools: 13 individual → 4 merged (action parameter pattern)
+  - Knowledge Graph tools: 9 → conditional via `~/.memorix/settings.json` (`{ "knowledgeGraph": true }`)
+  - Export+Import: 2 → 1 (`memorix_transfer`)
+- **Dashboard Team Panel** — Redesigned with Iconify icons, Material Design 3 style. Agent cards, task lists, message panel, file lock panel.
+- **README updated** for v1.0.0 stable (EN + 中文).
+
+### Fixed
+- **Windows EPERM file lock race condition** — Treat EPERM same as EEXIST in file-lock.ts.
+- **PowerShell BOM in config.json** — `Set-Content -Encoding UTF8` adds BOM in PS 5.x, breaking `JSON.parse`. Always use Node.js for config file writes.
+
+### Production Hardening
+- Cross-session shared team state
+- Inbox capped at 200 messages with auto-eviction
+- Session timeout GC (30min idle → auto-close)
+- Send to inactive agent rejected
+- Agent leave releases file locks + clears inbox
+- Orphaned task rescue when assignee inactive
+- Input validation: agent name max 100, message max 10KB
+
+### Stats
+- **Default MCP Tools:** 22 (+9 optional KG)
+- **Tests:** 753/753 passing across 56 files
+- **IDE Support:** 10 agents (Cursor, Windsurf, Claude Code, Codex, Copilot, Kiro, Antigravity, OpenCode, Trae, Gemini CLI)
+
+## [0.12.0] — 2026-03-08
+
+### Added
+- **Intent-Aware Recall** — Search understands query intent ("why X?" prioritizes decisions/trade-offs, "how to X?" prioritizes how-it-works).
+- **MCP Deadlock Fix** — Resolved stdio transport deadlock under high concurrency.
+- **Dashboard Dark Theme Fix** — Proper dark mode support across all panels.
+- **Build Race Condition Fix** — Fixed tsup parallel build race condition.
+
+## [0.11.0] — 2026-03-07
+
+### Added
+- **Mini-Skills** (`memorix_promote`) — Promote observations to permanent skills that auto-inject at session start. Never decay, project-scoped.
+- **LLM Quality Engine** — Compact-on-write (duplicate detection at write time), narrative compression (~27% token reduction), search reranking (60% queries improved).
+- **`memorix_deduplicate` tool** — LLM-powered semantic deduplication with dry-run support.
+- **`memorix_resolve` tool** — Mark completed tasks and fixed bugs as resolved to prevent context pollution.
+
+### Fixed
+- **Retention decay fix** — Reclassified `what-changed`/`discovery` to low retention (30d instead of 90d).
+
+### Stats
+- **Tests:** 641 → 674 passing
+
+## [0.10.6] — 2026-03-06
+
+### Fixed
+- Minor stability improvements.
+
 ## [0.10.5] — 2026-03-05
 
 ### Fixed

package/CLAUDE.md

@@ -42,6 +42,15 @@ You have access to Memorix, a cross-agent memory system. Use it to persist and r
 | `memorix_store` | Save new knowledge | `type: "decision", title: "Use JWT for auth"` |
 | `memorix_detail` | Get full observation | `ids: [42, 43]` |
 | `memorix_timeline` | See what happened around an event | `anchorId: 42` |
-| `memorix_retention` | Check memory health | `action: "summary"` |
+| `memorix_resolve` | Mark task done / bug fixed | `ids: [42]` |
+| `memorix_session_start` | Load context at session start | (no params needed) |
+| `memorix_session_end` | Save session summary | `summary: "## Goal\n..."` |
+| `memorix_promote` | Make observation permanent | `action: "promote", observationIds: [42]` |
+| `memorix_retention` | Check memory health | `action: "report"` |
+| `memorix_transfer` | Export/import memories | `action: "export"` |
 | `memorix_rules_sync` | Sync agent rules | `action: "status"` |
 | `memorix_workspace_sync` | Migrate workspace configs | `action: "scan"` |
+| `team_manage` | Register agent | `action: "join", name: "claude-backend"` |
+| `team_file_lock` | Lock file before editing | `action: "lock", file: "src/auth.ts"` |
+| `team_task` | Create/claim tasks | `action: "create", description: "Fix auth bug"` |
+| `team_message` | Send message to other agent | `action: "send", to: "agent-id"` |

package/README.md

@@ -15,6 +15,7 @@
   <a href="LICENSE"><img src="https://img.shields.io/badge/license-Apache%202.0-green.svg?style=flat-square" alt="license"></a>
   <a href="https://github.com/AVIDS2/memorix"><img src="https://img.shields.io/github/stars/AVIDS2/memorix?style=flat-square&color=yellow" alt="stars"></a>
   <img src="https://img.shields.io/badge/tests-753%20passed-brightgreen?style=flat-square" alt="tests">
+  <a href="https://github.com/AVIDS2/memorix/actions/workflows/ci.yml"><img src="https://img.shields.io/github/actions/workflow/status/AVIDS2/memorix/ci.yml?style=flat-square&label=CI" alt="CI"></a>
 </p>
 
 <p align="center">
@@ -300,34 +301,19 @@ memorix hooks install # Install auto-capture for IDEs
 
 ## Architecture
 
-```
-┌─────────┐  ┌───────────┐  ┌────────────┐  ┌───────┐  ┌──────────┐
-│ Cursor  │  │ Claude    │  │ Windsurf   │  │ Codex │  │ +6 more  │
-│         │  │ Code      │  │            │  │       │  │          │
-└────┬────┘  └─────┬─────┘  └─────┬──────┘  └───┬───┘  └────┬─────┘
-     │             │              │              │           │
-     └─────────────┴──────┬───────┴──────────────┴───────────┘
-                          │ MCP (stdio)
-                   ┌──────┴──────┐
-                   │   Memorix   │
-                   │  MCP Server │
-                   └──────┬──────┘
-                          │
-     ┌──────────┬─────────┼─────────┬──────────┐
-     │          │         │         │          │
-┌────┴─────┐ ┌─┴───────┐ │  ┌──────┴──────┐ ┌─┴────────┐
-│  Search  │ │  Team   │ │  │  Rules &    │ │  Auto-   │
-│ Pipeline │ │  Collab │ │  │  Workspace  │ │  Cleanup │
-│          │ │         │ │  │  Sync       │ │          │
-│ BM25     │ │ Agents  │ │  └─────────────┘ │ Retention│
-│ +Vector  │ │ Tasks   │ │                  │ +LLM     │
-│ +Rerank  │ │ Locks   │ │                  │  Dedup   │
-└──────────┘ │ Msgs    │ │                  └──────────┘
-      │      └─────────┘ │
-      │           │      │
-~/.memorix/data/  │  Knowledge
-(local, per-project)  │  Graph
-             team-state.json
+```mermaid
+graph TB
+    A["Cursor · Claude Code · Windsurf · Codex · +6 more"]
+    A -->|MCP stdio| Core
+    Core["Memorix MCP Server\n22 Default Tools · Auto-Hooks · Auto-Cleanup"]
+    Core --> Search["Search Pipeline\nBM25 + Vector + Rerank"]
+    Core --> Team["Team Collab\nAgents · Tasks · Locks · Msgs"]
+    Core --> Sync["Rules & Workspace Sync\n10 Adapters"]
+    Core --> Cleanup["Auto-Cleanup\nRetention + LLM Dedup"]
+    Core --> KG["Knowledge Graph\nEntities · Relations"]
+    Search --> Disk["~/.memorix/data/\nobservations · sessions · mini-skills · team-state · entities · relations"]
+    Team --> Disk
+    KG --> Disk
 ```
 
 ### Search Pipeline

package/README.zh-CN.md

@@ -14,11 +14,12 @@
   <a href="https://www.npmjs.com/package/memorix"><img src="https://img.shields.io/npm/dm/memorix.svg?style=flat-square&color=blue" alt="downloads"></a>
   <a href="LICENSE"><img src="https://img.shields.io/badge/license-Apache%202.0-green.svg?style=flat-square" alt="license"></a>
   <a href="https://github.com/AVIDS2/memorix"><img src="https://img.shields.io/github/stars/AVIDS2/memorix?style=flat-square&color=yellow" alt="stars"></a>
-  <img src="https://img.shields.io/badge/tests-674%20passed-brightgreen?style=flat-square" alt="tests">
+  <img src="https://img.shields.io/badge/tests-753%20passed-brightgreen?style=flat-square" alt="tests">
+  <a href="https://github.com/AVIDS2/memorix/actions/workflows/ci.yml"><img src="https://img.shields.io/github/actions/workflow/status/AVIDS2/memorix/ci.yml?style=flat-square&label=CI" alt="CI"></a>
 </p>
 
 <p align="center">
-  <strong>LLM 压缩降低 27% token 消耗 | 重排序提升 60% 检索精度 | 支持 10 个 Agent</strong>
+  <strong>v1.0 正式版 | 22 个 MCP 工具 | 自动清理 | 多 Agent 协作 | 10 IDE 支持</strong>
 </p>
 
 <p align="center">
@@ -58,6 +59,8 @@ AI 编码 Agent 在会话之间会丢失全部上下文。切换 IDE 后，之
 ### 核心能力
 
 - **跨 Agent 记忆共享**：所有 Agent 共用同一记忆存储。在 Cursor 中存储，在 Claude Code 中检索。
+- **多 Agent 协作**：Team 工具支持 Agent 间协调——注册/注销、文件锁、任务板、跨 IDE 消息传递，通过共享的 `team-state.json` 实现。
+- **启动自动清理**：后台自动归档过期记忆 + 智能去重（配有 LLM 时用语义分析，否则用启发式），零人工维护。
 - **双模式质量引擎**：免费启发式引擎处理基础去重；可选 LLM 模式提供智能压缩、重排序和冲突检测。
 - **3 层渐进式展示**：搜索返回紧凑索引（每条约 50 tokens），时间线展示前后文，详情提供完整内容。相比全文检索节省约 10 倍 token。
 - **Mini-Skills**：将高价值观察提升为永久技能，每次会话启动自动注入。关键知识永不衰减。
@@ -168,18 +171,26 @@ args = ["serve"]
 
 ## 功能
 
-### 28 个 MCP 工具
+### 22 个 MCP 工具（默认）
 
 | 分类 | 工具 |
 |------|------|
 | **记忆** | `memorix_store` · `memorix_search` · `memorix_detail` · `memorix_timeline` · `memorix_resolve` · `memorix_deduplicate` · `memorix_suggest_topic_key` |
 | **会话** | `memorix_session_start` · `memorix_session_end` · `memorix_session_context` |
-| **知识图谱** | `create_entities` · `create_relations` · `add_observations` · `delete_entities` · `delete_observations` · `delete_relations` · `search_nodes` · `open_nodes` · `read_graph` |
 | **技能** | `memorix_skills` · `memorix_promote` |
 | **工作区** | `memorix_workspace_sync` · `memorix_rules_sync` |
-| **维护** | `memorix_retention` · `memorix_consolidate` · `memorix_export` · `memorix_import` |
+| **维护** | `memorix_retention` · `memorix_consolidate` · `memorix_transfer` |
+| **团队** | `team_manage` · `team_file_lock` · `team_task` · `team_message` |
 | **仪表盘** | `memorix_dashboard` |
 
+<details>
+<summary><strong>+9 可选：知识图谱工具</strong>（在 <code>~/.memorix/settings.json</code> 中启用）</summary>
+
+`create_entities` · `create_relations` · `add_observations` · `delete_entities` · `delete_observations` · `delete_relations` · `search_nodes` · `open_nodes` · `read_graph`
+
+启用方式：`{ "knowledgeGraph": true }` 写入 `~/.memorix/settings.json`
+</details>
+
 ### 观察类型
 
 九种结构化类型用于分类存储的知识：
@@ -257,6 +268,19 @@ Memorix 自动检测已有环境变量：
 
 适用于必须永久保留的关键知识：部署流程、架构约束、反复出现的坑。
 
+### 团队协作
+
+多个 Agent 在同一工作区可通过 4 个团队工具协调：
+
+| 工具 | 操作 | 用途 |
+|------|------|------|
+| `team_manage` | join, leave, status | Agent 注册——查看谁在线 |
+| `team_file_lock` | lock, unlock, status | 协商式文件锁防止冲突 |
+| `team_task` | create, claim, complete, list | 共享任务板+依赖管理 |
+| `team_message` | send, broadcast, inbox | 直接消息和广播 |
+
+状态持久化到 `team-state.json`，所有 IDE 进程共享。详见 [TEAM.md](TEAM.md)。
+
 ### 自动记忆 Hook
 
 ```bash
@@ -279,32 +303,19 @@ memorix hooks install # 为 IDE 安装自动记忆
 
 ## 架构
 
-```
-┌─────────┐  ┌───────────┐  ┌────────────┐  ┌───────┐  ┌──────────┐
-│ Cursor  │  │ Claude    │  │ Windsurf   │  │ Codex │  │ +6 more  │
-│         │  │ Code      │  │            │  │       │  │          │
-└────┬────┘  └─────┬─────┘  └─────┬──────┘  └───┬───┘  └────┬─────┘
-     │             │              │              │           │
-     └─────────────┴──────┬───────┴──────────────┴───────────┘
-                          │ MCP (stdio)
-                   ┌──────┴──────┐
-                   │   Memorix   │
-                   │  MCP Server │
-                   └──────┬──────┘
-                          │
-     ┌────────────────────┼────────────────────┐
-     │                    │                    │
-┌────┴─────┐       ┌──────┴──────┐      ┌──────┴──────┐
-│  Search  │       │  Knowledge  │      │  Rules &    │
-│ Pipeline │       │  Graph      │      │  Workspace  │
-│          │       │  (Entities) │      │  Sync       │
-│ BM25     │       └─────────────┘      └─────────────┘
-│ +Vector  │
-│ +Rerank  │
-└──────────┘
-      │
-~/.memorix/data/
-(100% 本地，按项目隔离)
+```mermaid
+graph TB
+    A["Cursor · Claude Code · Windsurf · Codex · +6 更多"]
+    A -->|MCP stdio| Core
+    Core["Memorix MCP Server\n22 个默认工具 · 自动Hook · 自动清理"]
+    Core --> Search["检索管线\nBM25 + 向量 + 重排序"]
+    Core --> Team["团队协作\n注册 · 任务 · 锁 · 消息"]
+    Core --> Sync["规则 & 工作区同步\n10 个适配器"]
+    Core --> Cleanup["自动清理\n保留衰减 + LLM 去重"]
+    Core --> KG["知识图谱\n实体 · 关系"]
+    Search --> Disk["~/.memorix/data/\nobservations · sessions · mini-skills · team-state · entities · relations"]
+    Team --> Disk
+    KG --> Disk
 ```
 
 ### 检索管线
@@ -339,7 +350,7 @@ git clone https://github.com/AVIDS2/memorix.git
 cd memorix && npm install
 
 npm run dev       # 监听模式
-npm test          # 674 个测试
+npm test          # 753 个测试
 npm run build     # 生产构建
 ```
 

package/dist/cli/index.js

@@ -3377,10 +3377,12 @@ function generateOpenCodePlugin() {
  * Docs: https://github.com/AVIDS2/memorix
  */
 export const MemorixPlugin = async ({ project, client, $, directory, worktree }) => {
-  console.log('[memorix] plugin loaded, directory:', directory);
+  // Generate a stable session ID for this plugin lifetime
+  const sessionId = \`opencode-\${Date.now().toString(36)}-\${Math.random().toString(36).slice(2, 8)}\`;
 
   /** Pipe event JSON to memorix hook via temp file (Windows .cmd stdin workaround) */
   async function runHook(payload) {
+    payload.session_id = sessionId;
     const tmpDir = Bun.env.TEMP || Bun.env.TMP || '/tmp';
     const tmpPath = \`\${tmpDir}/memorix-hook-\${Date.now()}.json\`;
     try {
@@ -3388,9 +3390,8 @@ export const MemorixPlugin = async ({ project, client, $, directory, worktree })
       await Bun.write(tmpPath, data);
       // cat | pipe works through .cmd wrappers; < redirect does NOT
       await $\`cat \${tmpPath} | memorix hook\`.quiet().nothrow();
-      console.log('[memorix] hook fired:', payload.hook_event_name);
-    } catch (err) {
-      console.log('[memorix] hook error:', err?.message ?? err);
+    } catch {
+      // Silent \u2014 hooks must never break the agent
     } finally {
       try { const { unlinkSync } = await import('node:fs'); unlinkSync(tmpPath); } catch {}
     }
@@ -9982,7 +9983,7 @@ var init_fastembed_provider = __esm({
   "src/embedding/fastembed-provider.ts"() {
     "use strict";
     init_esm_shims();
-    CACHE_DIR = join3(homedir3(), ".memorix", "data");
+    CACHE_DIR = process.env.MEMORIX_DATA_DIR || join3(homedir3(), ".memorix", "data");
     CACHE_FILE = join3(CACHE_DIR, ".embedding-cache.json");
     cache = /* @__PURE__ */ new Map();
     MAX_CACHE_SIZE = 5e3;
@@ -10239,7 +10240,7 @@ var init_api_provider = __esm({
   "src/embedding/api-provider.ts"() {
     "use strict";
     init_esm_shims();
-    CACHE_DIR2 = join4(homedir4(), ".memorix", "data");
+    CACHE_DIR2 = process.env.MEMORIX_DATA_DIR || join4(homedir4(), ".memorix", "data");
     CACHE_FILE2 = join4(CACHE_DIR2, ".embedding-api-cache.json");
     cache3 = /* @__PURE__ */ new Map();
     MAX_CACHE_SIZE3 = 1e4;
@@ -11027,7 +11028,7 @@ var init_aliases = __esm({
   "src/project/aliases.ts"() {
     "use strict";
     init_esm_shims();
-    DEFAULT_DATA_DIR = path3.join(os2.homedir(), ".memorix", "data");
+    DEFAULT_DATA_DIR = process.env.MEMORIX_DATA_DIR || path3.join(os2.homedir(), ".memorix", "data");
     ALIAS_FILE = ".project-aliases.json";
     registryCache = null;
     registryDir = null;
@@ -11715,7 +11716,7 @@ var init_persistence = __esm({
     "use strict";
     init_esm_shims();
     init_file_lock();
-    DEFAULT_DATA_DIR2 = path5.join(os3.homedir(), ".memorix", "data");
+    DEFAULT_DATA_DIR2 = process.env.MEMORIX_DATA_DIR || path5.join(os3.homedir(), ".memorix", "data");
   }
 });
 
@@ -47306,12 +47307,32 @@ ${lines.join("\n")}` }] };
       }
       if (autoInstall) {
         const { getHookStatus: getHookStatus2, installHooks: installHooks2, detectInstalledAgents: detectInstalledAgents2 } = await Promise.resolve().then(() => (init_installers(), installers_exports));
+        const { join: join18 } = await import("path");
+        const { access: access2 } = await import("fs/promises");
         const workDir = cwd ?? process.cwd();
         const statuses = await getHookStatus2(workDir);
         const installedAgents = new Set(statuses.filter((s2) => s2.installed).map((s2) => s2.agent));
         const detectedAgents = await detectInstalledAgents2();
+        const AGENT_MARKER_DIR = {
+          claude: ".claude",
+          windsurf: ".windsurf",
+          cursor: ".cursor",
+          copilot: ".vscode",
+          opencode: ".opencode",
+          kiro: ".kiro",
+          antigravity: ".gemini",
+          trae: ".trae"
+        };
         for (const agent of detectedAgents) {
           if (installedAgents.has(agent)) continue;
+          const markerDir = AGENT_MARKER_DIR[agent];
+          if (markerDir) {
+            try {
+              await access2(join18(workDir, markerDir));
+            } catch {
+              continue;
+            }
+          }
           try {
             const config2 = await installHooks2(agent, workDir);
             console.error(`[memorix] Auto-installed hooks for ${agent} \u2192 ${config2.configPath}`);
@@ -47391,7 +47412,7 @@ ${lines.join("\n")}` }] };
               try {
                 const older = group[i2], newer = group[i2 + 1];
                 const decision = await deduplicateMemory2(
-                  { id: newer.id, title: newer.title, narrative: newer.narrative, facts: newer.facts.join("\n") },
+                  { title: newer.title, narrative: newer.narrative, facts: newer.facts },
                   [{ id: older.id, title: older.title, narrative: older.narrative, facts: older.facts.join("\n") }]
                 );
                 if (decision && (decision.action === "UPDATE" || decision.action === "NONE")) {
@@ -49577,7 +49598,7 @@ function normalizeGemini(payload, event) {
 }
 function normalizeOpenCode(payload, event) {
   const result = {
-    sessionId: "",
+    sessionId: payload.session_id ?? payload.sessionId ?? "",
     cwd: payload.cwd ?? ""
   };
   const toolName = payload.tool_name ?? "";