memorix 1.9.5 → 1.9.6

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.
Files changed (62) hide show
  1. package/CHANGELOG.md +42 -0
  2. package/README.md +6 -1
  3. package/README.zh-CN.md +6 -1
  4. package/dist/cli/index.js +1647 -264
  5. package/dist/index.d.ts +12 -7
  6. package/dist/index.js +952 -182
  7. package/dist/maintenance-runner.js +243 -103
  8. package/dist/media-audio-runner.js +243 -103
  9. package/dist/media-video-runner.js +243 -103
  10. package/dist/memcode-runtime/CHANGELOG.md +42 -0
  11. package/dist/sdk.js +871 -157
  12. package/dist/vector-backfill-runner.js +243 -103
  13. package/docs/API_REFERENCE.md +36 -0
  14. package/docs/CONFIGURATION.md +43 -0
  15. package/docs/DEVELOPMENT.md +1 -1
  16. package/docs/KNOWN_ISSUES_AND_ROADMAP.md +49 -14
  17. package/docs/PERFORMANCE.md +46 -2
  18. package/docs/README.md +2 -1
  19. package/docs/SETUP.md +1 -1
  20. package/package.json +2 -1
  21. package/plugins/antigravity/memorix/plugin.json +1 -1
  22. package/plugins/claude/memorix/.claude-plugin/plugin.json +1 -1
  23. package/plugins/codebuddy/memorix/.codebuddy-plugin/plugin.json +1 -1
  24. package/plugins/codex/memorix/.codex-plugin/plugin.json +1 -1
  25. package/plugins/copilot/memorix/plugin.json +1 -1
  26. package/plugins/gemini/memorix/gemini-extension.json +1 -1
  27. package/plugins/hermes/memorix/plugin.yaml +1 -1
  28. package/plugins/omp/memorix/package.json +1 -1
  29. package/plugins/openclaw/memorix/.codex-plugin/plugin.json +1 -1
  30. package/plugins/pi/memorix/package.json +1 -1
  31. package/server.json +2 -2
  32. package/src/cli/capability-map.ts +1 -0
  33. package/src/cli/command-guide.ts +13 -1
  34. package/src/cli/commands/context.ts +2 -0
  35. package/src/cli/commands/continuity.ts +155 -0
  36. package/src/cli/commands/init.ts +5 -2
  37. package/src/cli/commands/serve-http.ts +242 -42
  38. package/src/cli/index.ts +3 -1
  39. package/src/cli/tui/ConfigureView.tsx +2 -0
  40. package/src/codegraph/auto-context.ts +17 -0
  41. package/src/config/legacy-loader.ts +2 -2
  42. package/src/config/resolved-config.ts +8 -5
  43. package/src/config/yaml-loader.ts +20 -10
  44. package/src/embedding/api-provider.ts +4 -2
  45. package/src/embedding/fastembed-provider.ts +47 -14
  46. package/src/embedding/transformers-provider.ts +29 -7
  47. package/src/evaluation/memory-quality-gate.ts +90 -0
  48. package/src/hooks/official-skills.ts +2 -0
  49. package/src/knowledge/context-assembly.ts +1 -0
  50. package/src/knowledge/context-receipt.ts +15 -0
  51. package/src/knowledge/task-continuity.ts +413 -0
  52. package/src/knowledge/workset.ts +77 -0
  53. package/src/llm/provider.ts +2 -1
  54. package/src/orchestrate/coordinator.ts +60 -0
  55. package/src/orchestrate/effect-ledger.ts +160 -0
  56. package/src/orchestrate/pipeline-trace.ts +40 -6
  57. package/src/runtime/maintenance-jobs.ts +12 -6
  58. package/src/server/modern-mcp-bridge.ts +153 -27
  59. package/src/server/tool-profile.ts +3 -2
  60. package/src/server.ts +129 -5
  61. package/src/store/sqlite-db.ts +144 -4
  62. package/src/team/team-store.ts +62 -27
package/CHANGELOG.md CHANGED
@@ -2,6 +2,48 @@
2
2
 
3
3
  All notable changes to this project will be documented in this file.
4
4
 
5
+ ## Unreleased (1.9.x)
6
+
7
+ No unreleased changes.
8
+
9
+ ## [1.9.6] - 2026-09-22
10
+
11
+ ### Added
12
+ - **Task continuity ledger** -- adds a project-scoped append-only
13
+ ledger for requirements, decisions, verification, risks, and outcomes. The
14
+ bounded Project Context can include a ledger by `taskId`; no automatic
15
+ promotion or LLM summarization is performed.
16
+ - **Continuity outcome projection** -- adds deterministic validated, at-risk,
17
+ in-progress, and unverified states plus replay coverage. Diagnostic scores are
18
+ exposed in receipts only and do not silently reorder memories.
19
+ - **Infrastructure lifecycle closeout** -- bounds HTTP sessions and SQLite
20
+ handles, reuses project business runtimes behind fresh modern MCP protocol
21
+ shells, records event-loop/resource health, and adds a deterministic memory
22
+ quality gate.
23
+ - **Atlas Cloud memory preset** -- `memorix init` and the configuration TUI can
24
+ select Atlas Cloud for optional background memory LLM work through its
25
+ OpenAI-compatible endpoint, with provider-specific key isolation.
26
+
27
+ ### Fixed
28
+ - **Configuration scope isolation** -- explicit home/project resolution now
29
+ applies consistently to TOML, YAML, legacy JSON, and `.env` loading, so
30
+ long-lived processes and tests cannot reuse another configuration scope.
31
+ - **OrcaRouter documentation** -- documents the existing OpenAI-compatible
32
+ gateway path with fixed-model and fallback guidance; no vendor-specific
33
+ provider branch is required.
34
+ - **Capacity closeout** -- TeamStore queries, maintenance history, embedding
35
+ caches, HTTP project caches, and large-store behavior are bounded and
36
+ regression-covered.
37
+ - **Stable coordination queue order** -- available tasks now dispatch FIFO with
38
+ a SQLite rowid tie-breaker, preventing cross-platform adapter-routing flakes
39
+ when task timestamps collide.
40
+ - **Continuity correctness** -- verification obligations can move between
41
+ statuses by stable ID, retries are idempotent, open risks are visible in the
42
+ outcome state, and the 200-event cap is enforced transactionally.
43
+ - **Replay-safe orchestration evidence** -- tool effects are recorded with
44
+ redacted fingerprints, risk tiers, replay policy, and unknown-after-crash
45
+ status without persisting raw tool arguments or output.
46
+
5
47
  ## [1.9.5] - 2026-09-20
6
48
 
7
49
  ### Added
package/README.md CHANGED
@@ -483,7 +483,7 @@ Long-term memory is deliberately not an automatic dump of every note. A source o
483
483
  | Use the bundled terminal agent | `memorix` or `memcode` |
484
484
  | Run orchestrated subagent work | `memorix orchestrate --goal "..."` |
485
485
 
486
- `memorix serve` defaults to `--mode micro` (9 tools) to keep MCP tool schemas small for agents. `memorix setup` writes `--mode lite` (20 tools) into the installed MCP config so the normal memory and session surface is reachable. Use `--mode team` (28 tools) for coordination tools, or `--mode full` (47 tools) for advanced and compatibility tools such as checkpoint inspection.
486
+ `memorix serve` defaults to `--mode micro` (9 tools) to keep MCP tool schemas small for agents. `memorix setup` writes `--mode lite` (21 tools) into the installed MCP config so the normal memory, continuity, and session surface is reachable. Use `--mode team` (29 tools) for coordination tools, or `--mode full` (48 tools) for advanced and compatibility tools such as checkpoint inspection.
487
487
 
488
488
  Shortcuts and aliases: `memorix search` / `remember` / `recent` are direct query shortcuts, `bg`/`bs` start the background service, `hook` runs the hook launcher, and `memorix config get|path|migrate` inspects or migrates config files.
489
489
 
@@ -526,6 +526,11 @@ formation = "active"
526
526
 
527
527
  Use `[memory.llm]` and `[embedding]` for Memorix memory quality and retrieval. Use `[agent]` for the model memcode talks to while coding. Keep credentials in global config or environment variables, and do not commit secrets.
528
528
 
529
+ For the optional Atlas Cloud memory preset, run `memorix init` and choose Atlas
530
+ Cloud, or set `provider = "atlascloud"` in `[memory.llm]`. It uses the
531
+ OpenAI-compatible `https://api.atlascloud.ai/v1` endpoint and reads
532
+ `ATLASCLOUD_API_KEY` or the explicit `MEMORIX_LLM_API_KEY`.
533
+
529
534
  For OpenRouter embeddings, use `provider = "api"`, `base_url = "https://openrouter.ai/api/v1"`, and `model = "qwen/qwen3-embedding-8b"`. Memorix accepts `OPENROUTER_API_KEY` for that embedding endpoint; `MEMORIX_EMBEDDING_API_KEY` remains the explicit override.
530
535
 
531
536
  For controlled MiniMax media generation, set `MINIMAX_API_KEY` (global) or
package/README.zh-CN.md CHANGED
@@ -458,7 +458,7 @@ memcode
458
458
  | 使用内置终端 Agent | `memorix` 或 `memcode` |
459
459
  | 运行编排式 subagent 工作 | `memorix orchestrate --goal "..."` |
460
460
 
461
- `memorix serve` 默认使用 `--mode micro`(9 个工具),保持 MCP 工具 schema 紧凑。`memorix setup` 写入 `--mode lite`(20 个工具),覆盖常用记忆、会话、证据和反馈入口。需要协作工具时使用 `--mode team`(28 个工具),需要高级和兼容工具时使用 `--mode full`(47 个工具)。
461
+ `memorix serve` 默认使用 `--mode micro`(9 个工具),保持 MCP 工具 schema 紧凑。`memorix setup` 写入 `--mode lite`(21 个工具),覆盖常用记忆、连续性、会话、证据和反馈入口。需要协作工具时使用 `--mode team`(29 个工具),需要高级和兼容工具时使用 `--mode full`(48 个工具)。
462
462
 
463
463
  `memorix orchestrate` 单 worker 默认使用当前 checkout;多 worker 时会在 `.worktrees/` 下为任务创建隔离 worktree,并把成功的任务分支 merge 回来。用 `--isolated` 可强制单 worker 也隔离,用 `--no-worktree` 禁用 worktree,用 `--allow-dirty` 允许带未提交改动运行,用 `--no-auto-merge` 保留任务 worktree 方便人工 review。
464
464
 
@@ -499,6 +499,11 @@ formation = "active"
499
499
 
500
500
  `[memory.llm]` 和 `[embedding]` 负责记忆质量和检索;`[agent]` 是 memcode 编码时使用的模型。凭据放全局配置或环境变量,不要提交 secrets。
501
501
 
502
+ 如需使用可选的 Atlas Cloud 记忆模型预设,可以运行 `memorix init` 选择
503
+ Atlas Cloud,或在 `[memory.llm]` 中设置 `provider = "atlascloud"`。它使用
504
+ OpenAI-compatible 的 `https://api.atlascloud.ai/v1` endpoint,并读取
505
+ `ATLASCLOUD_API_KEY` 或显式的 `MEMORIX_LLM_API_KEY`。
506
+
502
507
  如果使用 OpenRouter embedding,可以设置 `provider = "api"`、`base_url = "https://openrouter.ai/api/v1"`、`model = "qwen/qwen3-embedding-8b"`。这个 endpoint 下 Memorix 会读取官方 `OPENROUTER_API_KEY`;需要单独覆盖 embedding key 时仍可用 `MEMORIX_EMBEDDING_API_KEY`。
503
508
 
504
509
  受控 MiniMax 媒体生成可在环境变量或 `.env` 中设置全局 `MINIMAX_API_KEY`,或中国区 `MINIMAX_CN_API_KEY`。媒体库不会保存该 key、临时签名 URL 或 base64 负载。CLI 生成本身就是显式操作;若要让 MCP 中的 Agent 发起生成,还必须明确设置 `MEMORIX_MCP_MEDIA_GENERATION=1`。