memorix 1.8.9 → 1.9.0
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 +18 -0
- package/README.md +7 -0
- package/README.zh-CN.md +6 -0
- package/dist/cli/index.js +3261 -1348
- package/dist/index.js +324 -187
- package/dist/maintenance-runner.js +285 -103
- package/dist/media-audio-runner.js +285 -103
- package/dist/media-video-runner.js +285 -103
- package/dist/memcode-runtime/CHANGELOG.md +18 -0
- package/dist/sdk.js +323 -186
- package/dist/vector-backfill-runner.d.ts +4 -1
- package/dist/vector-backfill-runner.js +288 -104
- package/docs/API_REFERENCE.md +14 -0
- package/docs/CONFIGURATION.md +46 -0
- package/docs/DEVELOPMENT.md +2 -2
- package/docs/MULTI-DEVICE-SYNC-RESEARCH.md +344 -0
- package/docs/PERFORMANCE.md +32 -0
- package/docs/README.md +4 -2
- package/llms-full.txt +1 -0
- package/llms.txt +1 -0
- package/package.json +1 -1
- package/plugins/antigravity/memorix/plugin.json +1 -1
- package/plugins/claude/memorix/.claude-plugin/plugin.json +1 -1
- package/plugins/codebuddy/memorix/.codebuddy-plugin/plugin.json +1 -1
- package/plugins/codex/memorix/.codex-plugin/plugin.json +1 -1
- package/plugins/copilot/memorix/plugin.json +1 -1
- package/plugins/gemini/memorix/gemini-extension.json +1 -1
- package/plugins/hermes/memorix/plugin.yaml +1 -1
- package/plugins/omp/memorix/package.json +1 -1
- package/plugins/openclaw/memorix/.codex-plugin/plugin.json +1 -1
- package/plugins/pi/memorix/package.json +1 -1
- package/server.json +2 -2
- package/src/cli/command-guide.ts +9 -1
- package/src/cli/commands/serve-http.ts +11 -0
- package/src/cli/commands/sync-store.ts +191 -0
- package/src/cli/commands/sync.ts +8 -0
- package/src/memory/observations.ts +15 -2
- package/src/runtime/maintenance-targets.ts +6 -0
- package/src/runtime/vector-backfill-runner.ts +185 -7
- package/src/store/orama-store.ts +85 -102
- package/src/sync/adapters/fs.ts +179 -0
- package/src/sync/adapters/github.ts +258 -0
- package/src/sync/adapters/object-store.ts +267 -0
- package/src/sync/adapters/postgres.ts +269 -0
- package/src/sync/engine.ts +353 -0
- package/src/sync/journal.ts +162 -0
- package/src/sync/merge.ts +116 -0
- package/src/sync/namespace.ts +15 -0
- package/src/sync/paging.ts +45 -0
- package/src/sync/policy.ts +37 -0
- package/src/sync/remote-factory.ts +49 -0
- package/src/sync/store-port.ts +288 -0
- package/src/sync/types.ts +183 -0
package/CHANGELOG.md
CHANGED
|
@@ -4,6 +4,24 @@ All notable changes to this project will be documented in this file.
|
|
|
4
4
|
|
|
5
5
|
## [Unreleased]
|
|
6
6
|
|
|
7
|
+
## [1.9.0] - 2026-09-07
|
|
8
|
+
|
|
9
|
+
### Added
|
|
10
|
+
- **Opt-in multi-device sync** -- adds a project-scoped observation
|
|
11
|
+
event contract with privacy filtering, local outbox retry, conflict evidence,
|
|
12
|
+
device-clone protection, bounded relay pulls, and filesystem/GitHub/S3/
|
|
13
|
+
Postgres transport boundaries. It is disabled by default and keeps local
|
|
14
|
+
SQLite as the canonical store.
|
|
15
|
+
- **Sync hardening** -- retracts records that become private or agent-targeted,
|
|
16
|
+
keeps imported observations and sync state atomic, rejects immutable-key
|
|
17
|
+
collisions, verifies every pulled content hash, and uses stable continuation
|
|
18
|
+
cursors so large pulls do not skip events.
|
|
19
|
+
- **Resource hardening** -- coalesces deferred vector workers across hook
|
|
20
|
+
processes, respects retry cooldowns, drains due vector jobs through one
|
|
21
|
+
recoverable worker, removes the redundant full-document detail cache, and
|
|
22
|
+
batches startup vector hydration to reduce CPU/RAM peaks without imposing a
|
|
23
|
+
small corpus limit.
|
|
24
|
+
|
|
7
25
|
## [1.8.9] - 2026-09-06
|
|
8
26
|
|
|
9
27
|
### Added
|
package/README.md
CHANGED
|
@@ -85,6 +85,7 @@ Memorix is more than a memory store. It also installs agent integrations, keeps
|
|
|
85
85
|
| Orchestration and team work | Task planning, worker handoffs, file locks, messages, verification gates, and review loops | `memorix orchestrate`, `memorix team`, `memorix lock` |
|
|
86
86
|
| memcode | A bundled terminal coding agent that already reads and writes the same project memory | `memorix`, `memcode` |
|
|
87
87
|
| CLI and SDK | Scriptable access for automation, imports/exports, diagnostics, and custom integrations | `memorix ...`, `createMemoryClient()` |
|
|
88
|
+
| Optional multi-device sync | Project-scoped, privacy-filtered observation events with local SQLite kept canonical; GitHub JSONL, filesystem, S3, or Postgres relay | `memorix sync store status\|push\|pull` |
|
|
88
89
|
|
|
89
90
|
<h2 id="works-with-your-agent"><picture><source media="(prefers-color-scheme: dark)" srcset="assets/tags/light/section-agents.svg"><img src="assets/tags/section-agents.svg" alt="Works with every agent" height="32" /></picture></h2>
|
|
90
91
|
|
|
@@ -218,6 +219,12 @@ CLI, MCP, and HTTP are different entry points:
|
|
|
218
219
|
- `memorix serve` is the stdio MCP bridge used by IDEs and coding agents. Its default tool profile is `micro`, so agents see only the compact core tool set.
|
|
219
220
|
- `memorix background start` / `memorix serve-http` run the HTTP service for a shared endpoint, dashboard, VPS Docker deployment, or multiple clients.
|
|
220
221
|
|
|
222
|
+
Multi-device store sync is opt-in and separate from HTTP sharing. It never
|
|
223
|
+
uploads the live SQLite database or WAL files. By default it only relays
|
|
224
|
+
qualified project-visible observations; personal, agent-targeted, candidate,
|
|
225
|
+
ephemeral, and other-project records stay local. Set `MEMORIX_SYNC_PROVIDER` and
|
|
226
|
+
inspect `memorix sync store status --json` before the first push.
|
|
227
|
+
|
|
221
228
|
<h2 id="install"><picture><source media="(prefers-color-scheme: dark)" srcset="assets/tags/light/section-install.svg"><img src="assets/tags/section-install.svg" alt="Install" height="32" /></picture></h2>
|
|
222
229
|
|
|
223
230
|
Requirements:
|
package/README.zh-CN.md
CHANGED
|
@@ -84,6 +84,7 @@ Memorix 不只是一个记忆库。它还负责安装 Agent 接入、保留有
|
|
|
84
84
|
| Orchestration 和团队协作 | 任务规划、worker 交接、文件锁、消息、验证门和 review loop | `memorix orchestrate`、`memorix team`、`memorix lock` |
|
|
85
85
|
| memcode | 内置终端 Coding Agent,默认读写同一套项目记忆 | `memorix`、`memcode` |
|
|
86
86
|
| CLI 和 SDK | 给自动化、导入导出、诊断和自定义集成使用的本地接口 | `memorix ...`、`createMemoryClient()` |
|
|
87
|
+
| 可选多设备同步 | 按项目隔离、经过隐私过滤的记忆事件同步;本地 SQLite 仍是主库 | `memorix sync store status\|push\|pull` |
|
|
87
88
|
|
|
88
89
|
<h2 id="支持你的-agent"><picture><source media="(prefers-color-scheme: dark)" srcset="assets/tags/light/section-agents.svg"><img src="assets/tags/section-agents.svg" alt="Works with every agent" height="32" /></picture></h2>
|
|
89
90
|
|
|
@@ -217,6 +218,11 @@ CLI、MCP 和 HTTP 是不同入口:
|
|
|
217
218
|
- `memorix serve` 是给 IDE / Coding Agent 使用的 stdio MCP 桥。
|
|
218
219
|
- `memorix background start` / `memorix serve-http` 是 HTTP 服务,用于共享端点、Dashboard、VPS Docker 部署或多客户端。
|
|
219
220
|
|
|
221
|
+
多设备记忆同步是可选功能,和 HTTP 共享服务不是一回事。它不会上传
|
|
222
|
+
`memorix.db`、WAL 或 SHM 文件。默认只同步当前项目中已确认且项目可见的
|
|
223
|
+
观察记录;个人、指定 Agent、候选、短期和其它项目的记录会留在本地。设置
|
|
224
|
+
`MEMORIX_SYNC_PROVIDER` 后,先运行 `memorix sync store status --json` 再 push。
|
|
225
|
+
|
|
220
226
|
<h2 id="安装"><picture><source media="(prefers-color-scheme: dark)" srcset="assets/tags/light/section-install.svg"><img src="assets/tags/section-install.svg" alt="安装" height="32" /></picture></h2>
|
|
221
227
|
|
|
222
228
|
要求:
|