memorix 0.12.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

@@ -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>27% fewer tokens via LLM compression | 60% search precision improvement via reranking | 10 agents supported</strong>
+  <strong>v1.0 Stable | 22 MCP tools | Auto-cleanup | Multi-agent collaboration | 10 IDEs supported</strong>
 </p>
 
 <p align="center">
@@ -58,6 +59,8 @@ No re-explaining. No copy-pasting. No vendor lock-in.
 ### Core Capabilities
 
 - **Cross-Agent Memory**: All agents share the same memory store. Store in Cursor, retrieve in Claude Code.
+- **Multi-Agent Collaboration**: Team tools for agent coordination — join/leave, file locks, task boards, and cross-IDE messaging via shared `team-state.json`.
+- **Auto-Cleanup on Startup**: Background retention archiving and intelligent deduplication (LLM or heuristic) run automatically — zero manual maintenance.
 - **Dual-Mode Quality**: Free heuristic engine for basic dedup; optional LLM mode for intelligent compression, reranking, and conflict resolution.
 - **3-Layer Progressive Disclosure**: Search returns compact indices (~50 tokens/result), timeline shows chronological context, detail provides full content. ~10x token savings over full-text retrieval.
 - **Mini-Skills**: Promote high-value observations to permanent skills that auto-inject at every session start. Critical knowledge never decays.
@@ -168,18 +171,26 @@ Restart your agent. No API keys required. No cloud. No external dependencies.
 
 ## Features
 
-### 28 MCP Tools
+### 22 MCP Tools (Default)
 
 | Category | Tools |
 |----------|-------|
 | **Memory** | `memorix_store` · `memorix_search` · `memorix_detail` · `memorix_timeline` · `memorix_resolve` · `memorix_deduplicate` · `memorix_suggest_topic_key` |
 | **Sessions** | `memorix_session_start` · `memorix_session_end` · `memorix_session_context` |
-| **Knowledge Graph** | `create_entities` · `create_relations` · `add_observations` · `delete_entities` · `delete_observations` · `delete_relations` · `search_nodes` · `open_nodes` · `read_graph` |
 | **Skills** | `memorix_skills` · `memorix_promote` |
 | **Workspace** | `memorix_workspace_sync` · `memorix_rules_sync` |
-| **Maintenance** | `memorix_retention` · `memorix_consolidate` · `memorix_export` · `memorix_import` |
+| **Maintenance** | `memorix_retention` · `memorix_consolidate` · `memorix_transfer` |
+| **Team** | `team_manage` · `team_file_lock` · `team_task` · `team_message` |
 | **Dashboard** | `memorix_dashboard` |
 
+<details>
+<summary><strong>+9 Optional: Knowledge Graph tools</strong> (enable in <code>~/.memorix/settings.json</code>)</summary>
+
+`create_entities` · `create_relations` · `add_observations` · `delete_entities` · `delete_observations` · `delete_relations` · `search_nodes` · `open_nodes` · `read_graph`
+
+Enable with: `{ "knowledgeGraph": true }` in `~/.memorix/settings.json`
+</details>
+
 ### Observation Types
 
 Nine structured types for classifying stored knowledge:
@@ -255,6 +266,19 @@ Promote high-value observations to permanent skills using `memorix_promote`. Min
 
 Use this for critical knowledge that must survive indefinitely: deployment procedures, architectural constraints, recurring gotchas.
 
+### Team Collaboration
+
+Multiple agents working in the same workspace can coordinate via 4 team tools:
+
+| Tool | Actions | Purpose |
+|------|---------|---------|
+| `team_manage` | join, leave, status | Agent registry — see who's active |
+| `team_file_lock` | lock, unlock, status | Advisory file locks to prevent conflicts |
+| `team_task` | create, claim, complete, list | Shared task board with dependencies |
+| `team_message` | send, broadcast, inbox | Direct and broadcast messaging |
+
+State is persisted to `team-state.json` and shared across all IDE processes. See [TEAM.md](TEAM.md) for the full protocol.
+
 ### Auto-Memory Hooks
 
 ```bash
@@ -277,32 +301,19 @@ memorix hooks install # Install auto-capture for IDEs
 
 ## Architecture
 
-```
-┌─────────┐  ┌───────────┐  ┌────────────┐  ┌───────┐  ┌──────────┐
-│ 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% local, per-project isolation)
+```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
@@ -337,7 +348,7 @@ git clone https://github.com/AVIDS2/memorix.git
 cd memorix && npm install
 
 npm run dev       # watch mode
-npm test          # 674 tests
+npm test          # 753 tests
 npm run build     # production build
 ```
 

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     # 生产构建
 ```