memorix 1.0.6 → 1.0.7
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- package/CHANGELOG.md +335 -245
- package/README.md +31 -32
- package/README.zh-CN.md +20 -14
- package/dist/cli/index.js +21258 -13789
- package/dist/cli/index.js.map +1 -1
- package/dist/dashboard/static/app.js +969 -197
- package/dist/dashboard/static/index.html +10 -3
- package/dist/dashboard/static/style.css +46 -0
- package/dist/index.js +5853 -2260
- package/dist/index.js.map +1 -1
- package/dist/types.d.ts +396 -0
- package/dist/types.js +32 -0
- package/dist/types.js.map +1 -0
- package/package.json +25 -4
package/README.md
CHANGED
|
@@ -1,12 +1,12 @@
|
|
|
1
1
|
<p align="center">
|
|
2
|
-
<img src="assets/logo.png" alt="Memorix" width="
|
|
2
|
+
<img src="https://raw.githubusercontent.com/AVIDS2/memorix/main/assets/readme-logo-bridge.png" alt="Memorix Bridge" width="720">
|
|
3
3
|
</p>
|
|
4
4
|
|
|
5
5
|
<h1 align="center">Memorix</h1>
|
|
6
6
|
|
|
7
7
|
<p align="center">
|
|
8
8
|
<strong>Open-source cross-agent memory layer for coding agents.</strong><br>
|
|
9
|
-
|
|
9
|
+
Tiered MCP support across Cursor, Claude Code, Codex, Windsurf, Gemini CLI, GitHub Copilot, Kiro, OpenCode, Antigravity, and Trae.
|
|
10
10
|
</p>
|
|
11
11
|
|
|
12
12
|
<p align="center">
|
|
@@ -22,7 +22,7 @@
|
|
|
22
22
|
</p>
|
|
23
23
|
|
|
24
24
|
<p align="center">
|
|
25
|
-
<a href="README.zh-CN.md"
|
|
25
|
+
<a href="README.zh-CN.md">Chinese</a> |
|
|
26
26
|
<a href="#quick-start">Quick Start</a> |
|
|
27
27
|
<a href="#supported-clients">Supported Clients</a> |
|
|
28
28
|
<a href="#core-workflows">Core Workflows</a> |
|
|
@@ -58,20 +58,25 @@ What makes Memorix different:
|
|
|
58
58
|
|
|
59
59
|
Memorix is built for one job: let multiple coding agents share the same durable project memory through MCP without giving up Git truth, reasoning history, or local control.
|
|
60
60
|
|
|
61
|
+
## What's New in 1.0.7
|
|
62
|
+
|
|
63
|
+
Version `1.0.7` adds multi-agent coordination, SQLite canonical storage, and team identity.
|
|
64
|
+
|
|
65
|
+
- **Multi-Agent Coordinator**: `memorix orchestrate` runs a structured coordination loop — plan → parallel execution → verify gates → fix loops → review → merge. Supports Claude, Codex, Gemini CLI, and OpenCode with capability routing, worktree isolation, and agent fallback.
|
|
66
|
+
- **SQLite Canonical Store**: Observations, mini-skills, sessions, and archives now use SQLite as the single source of truth with shared DB handle and freshness-safe retrieval.
|
|
67
|
+
- **Team Identity**: Agent registration, heartbeat, task board, handoff artifacts, and stale detection for multi-agent collaboration.
|
|
68
|
+
- **Configurable Timeouts**: `MEMORIX_LLM_TIMEOUT_MS` (default 30s) and `MEMORIX_RERANK_TIMEOUT_MS` (default 5s) for slow API providers.
|
|
69
|
+
- **Cursor stdio fix**: No longer exits when workspace root is unavailable — starts in deferred-binding mode instead.
|
|
70
|
+
|
|
61
71
|
## Supported Clients
|
|
62
72
|
|
|
63
|
-
|
|
73
|
+
| Tier | Clients |
|
|
74
|
+
|------|---------|
|
|
75
|
+
| ★ Core | Claude Code, Cursor, Windsurf |
|
|
76
|
+
| ◆ Extended | GitHub Copilot, Kiro, Codex |
|
|
77
|
+
| ○ Community | Gemini CLI, OpenCode, Antigravity, Trae |
|
|
64
78
|
|
|
65
|
-
-
|
|
66
|
-
- Claude Code
|
|
67
|
-
- Codex
|
|
68
|
-
- Windsurf
|
|
69
|
-
- Gemini CLI
|
|
70
|
-
- GitHub Copilot
|
|
71
|
-
- Kiro
|
|
72
|
-
- OpenCode
|
|
73
|
-
- Antigravity
|
|
74
|
-
- Trae
|
|
79
|
+
**Core** = full hook integration + tested MCP + rules sync. **Extended** = hook integration with platform caveats. **Community** = best-effort hooks, community-reported compatibility.
|
|
75
80
|
|
|
76
81
|
If a client can speak MCP and launch a local command or HTTP endpoint, it can usually connect to Memorix even if it is not in the list above yet.
|
|
77
82
|
|
|
@@ -355,31 +360,25 @@ Memorix is not a single linear pipeline. It accepts memory from multiple ingress
|
|
|
355
360
|
|
|
356
361
|
## Documentation
|
|
357
362
|
|
|
358
|
-
|
|
363
|
+
Start with the [Docs Map](docs/README.md) if you want the fastest route to the right document.
|
|
359
364
|
|
|
360
|
-
|
|
361
|
-
|
|
365
|
+
| If you want to... | Read this |
|
|
366
|
+
| --- | --- |
|
|
367
|
+
| Install Memorix and choose the right runtime mode | [Setup Guide](docs/SETUP.md) |
|
|
368
|
+
| Configure `memorix.yml`, `.env`, and project overrides | [Configuration Guide](docs/CONFIGURATION.md) |
|
|
369
|
+
| Operate Memorix correctly as an AI coding agent | [Agent Operator Playbook](docs/AGENT_OPERATOR_PLAYBOOK.md) |
|
|
370
|
+
| Understand the system shape and runtime surfaces | [Architecture](docs/ARCHITECTURE.md) |
|
|
371
|
+
| Learn the MCP / HTTP / CLI command surface | [API Reference](docs/API_REFERENCE.md) |
|
|
372
|
+
| Understand Git memory and retrieval semantics | [Git Memory Guide](docs/GIT_MEMORY.md) |
|
|
373
|
+
| Contribute to Memorix itself | [Development Guide](docs/DEVELOPMENT.md) |
|
|
374
|
+
| Browse the full document map | [docs/README.md](docs/README.md) |
|
|
362
375
|
|
|
363
|
-
|
|
376
|
+
Additional deep references:
|
|
364
377
|
|
|
365
|
-
- [Architecture](docs/ARCHITECTURE.md)
|
|
366
378
|
- [Memory Formation Pipeline](docs/MEMORY_FORMATION_PIPELINE.md)
|
|
367
379
|
- [Design Decisions](docs/DESIGN_DECISIONS.md)
|
|
368
|
-
|
|
369
|
-
### Reference
|
|
370
|
-
|
|
371
|
-
- [API Reference](docs/API_REFERENCE.md)
|
|
372
|
-
- [Git Memory Guide](docs/GIT_MEMORY.md)
|
|
373
380
|
- [Modules](docs/MODULES.md)
|
|
374
|
-
|
|
375
|
-
### Development
|
|
376
|
-
|
|
377
|
-
- [Development Guide](docs/DEVELOPMENT.md)
|
|
378
381
|
- [Known Issues and Roadmap](docs/KNOWN_ISSUES_AND_ROADMAP.md)
|
|
379
|
-
|
|
380
|
-
### AI-Facing Project Docs
|
|
381
|
-
|
|
382
|
-
- [Agent Operator Playbook](docs/AGENT_OPERATOR_PLAYBOOK.md)
|
|
383
382
|
- [AI Context Note](docs/AI_CONTEXT.md)
|
|
384
383
|
- [`llms.txt`](llms.txt)
|
|
385
384
|
- [`llms-full.txt`](llms-full.txt)
|
package/README.zh-CN.md
CHANGED
|
@@ -1,12 +1,12 @@
|
|
|
1
1
|
<p align="center">
|
|
2
|
-
<img src="assets/logo.png" alt="Memorix" width="
|
|
2
|
+
<img src="https://raw.githubusercontent.com/AVIDS2/memorix/main/assets/readme-logo-bridge.png" alt="Memorix Bridge" width="720">
|
|
3
3
|
</p>
|
|
4
4
|
|
|
5
5
|
<h1 align="center">Memorix</h1>
|
|
6
6
|
|
|
7
7
|
<p align="center">
|
|
8
8
|
<strong>面向 Coding Agent 的开源跨 Agent Memory Layer。</strong><br>
|
|
9
|
-
通过 MCP
|
|
9
|
+
通过 MCP 为 Cursor、Claude Code、Codex、Windsurf、Gemini CLI、GitHub Copilot、Kiro、OpenCode、Antigravity 和 Trae 提供分级支持。
|
|
10
10
|
</p>
|
|
11
11
|
|
|
12
12
|
<p align="center">
|
|
@@ -58,20 +58,26 @@ Memorix 的几个关键差异点:
|
|
|
58
58
|
|
|
59
59
|
一句话说,Memorix 解决的是:让多个 Coding Agent 通过 MCP 共享同一套耐久项目记忆,同时保留 Git 真相、推理上下文和本地控制权。
|
|
60
60
|
|
|
61
|
+
## 1.0.7 更新亮点
|
|
62
|
+
|
|
63
|
+
`1.0.7` 这次发布,真正把 Memorix 的记忆语义、检索层次和运维闭环补完整了。
|
|
64
|
+
|
|
65
|
+
- **以 provenance 为先的检索模型**:记忆现在会明确区分 `explicit`、`hook`、`git-ingest` 等来源细节,以及 `core`、`contextual`、`ephemeral` 等价值类别。
|
|
66
|
+
- **分层披露(Layered Disclosure)**:session start、search、detail、timeline 更清楚地区分了 routing hints、working context 和 deeper evidence。
|
|
67
|
+
- **证据语义与 citation-lite**:紧凑输出现在能说明 repository-backed evidence、synthesized analysis,以及“为什么会浮出来 / 它由什么支持”的轻量提示。
|
|
68
|
+
- **任务线收束与 secret safety**:检索更不容易在同一个 repo 内串到错误的 workstream,明显的密码、token、credential 也会在写入和读取路径上被拦截或脱敏。
|
|
69
|
+
- **归属校验与 cleanup 闭环**:wrong-bucket 审计、retention explainability、stale review 和 remediation hint 现在已经形成一个可操作的清理闭环。
|
|
70
|
+
- **OpenCode compaction 改进**:OpenCode 的 compaction 不再暗示会自动调用 MCP 工具,而是使用结构化 continuation prompt,并暴露真实的 `post_compact` 事件。
|
|
71
|
+
|
|
61
72
|
## 支持的客户端
|
|
62
73
|
|
|
63
|
-
|
|
64
|
-
|
|
65
|
-
|
|
66
|
-
|
|
67
|
-
|
|
68
|
-
|
|
69
|
-
|
|
70
|
-
- GitHub Copilot
|
|
71
|
-
- Kiro
|
|
72
|
-
- OpenCode
|
|
73
|
-
- Antigravity
|
|
74
|
-
- Trae
|
|
74
|
+
| 层级 | 客户端 |
|
|
75
|
+
|------|--------|
|
|
76
|
+
| ★ 核心 | Claude Code, Cursor, Windsurf |
|
|
77
|
+
| ◆ 扩展 | GitHub Copilot, Kiro, Codex |
|
|
78
|
+
| ○ 社区 | Gemini CLI, OpenCode, Antigravity, Trae |
|
|
79
|
+
|
|
80
|
+
**核心** = 完整 hook 集成 + 测试过的 MCP + 规则同步。**扩展** = hook 集成但有平台限制。**社区** = 尽力适配,兼容性由社区反馈。
|
|
75
81
|
|
|
76
82
|
如果某个客户端能通过 MCP 连接本地命令或 HTTP 端点,通常也可以接入 Memorix,只是暂时没有单独的适配器或引导页。
|
|
77
83
|
|