@carloswon/cairn-memory 0.5.0 → 0.6.1

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 (32) hide show
  1. package/CHANGELOG.md +31 -0
  2. package/dist/src/core/types.d.ts +4 -0
  3. package/dist/src/interfaces/app-service.d.ts +14 -1
  4. package/dist/src/interfaces/app-service.js +55 -5
  5. package/dist/src/interfaces/app-service.js.map +1 -1
  6. package/dist/src/interfaces/cli/main.js +33 -1
  7. package/dist/src/interfaces/cli/main.js.map +1 -1
  8. package/dist/src/interfaces/console/assets/ui-css.js +6 -2
  9. package/dist/src/interfaces/console/assets/ui-css.js.map +1 -1
  10. package/dist/src/interfaces/console/assets/ui-js.js +248 -92
  11. package/dist/src/interfaces/console/assets/ui-js.js.map +1 -1
  12. package/dist/src/interfaces/console/assets/url-state.d.ts +1 -1
  13. package/dist/src/interfaces/console/assets/url-state.js +2 -2
  14. package/dist/src/interfaces/console/assets/url-state.js.map +1 -1
  15. package/dist/src/interfaces/mcp/server.d.ts +8 -0
  16. package/dist/src/interfaces/mcp/server.js +66 -23
  17. package/dist/src/interfaces/mcp/server.js.map +1 -1
  18. package/dist/src/retrieval/preview.d.ts +22 -0
  19. package/dist/src/retrieval/preview.js +61 -0
  20. package/dist/src/retrieval/preview.js.map +1 -0
  21. package/dist/src/retrieval/search.js +5 -1
  22. package/dist/src/retrieval/search.js.map +1 -1
  23. package/dist/src/store/projects.d.ts +6 -0
  24. package/dist/src/store/projects.js +9 -0
  25. package/dist/src/store/projects.js.map +1 -1
  26. package/dist/src/sync/backup-store.js +13 -2
  27. package/dist/src/sync/backup-store.js.map +1 -1
  28. package/dist/src/sync/syncd-store.d.ts +7 -0
  29. package/dist/src/sync/syncd-store.js +18 -0
  30. package/dist/src/sync/syncd-store.js.map +1 -1
  31. package/docs/cairn-usage.md +28 -0
  32. package/package.json +74 -74
@@ -1 +1 @@
1
- {"version":3,"file":"syncd-store.js","sourceRoot":"","sources":["../../../src/sync/syncd-store.ts"],"names":[],"mappings":"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"}
1
+ {"version":3,"file":"syncd-store.js","sourceRoot":"","sources":["../../../src/sync/syncd-store.ts"],"names":[],"mappings":"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"}
@@ -1016,3 +1016,31 @@ MCP 侧等价只读工具:`memory_audit`(支持 `category`/`action`/`since`/
1016
1016
  | 保留天数 | `CAIRN_AUDIT_RETENTION_DAYS` | `{"audit":{"retentionDays":90}}` | 30 |
1017
1017
 
1018
1018
  治理类目(计划/审批/写入审计)**永不**被保留期自动清理;非法配置值回落默认并在 stderr 告警。
1019
+
1020
+ ## 两段式检索:列表给预览,全文按需取(add-two-stage-memory-recall)
1021
+
1022
+ 面向 Agent 的检索工具(`memory_search` / `memory_context`)返回的条目是**有界预览**(默认 300 字符,frontmatter 感知、确定性生成),不是全文:
1023
+
1024
+ - `preview`:单行摘要;超上限时以 `…` 结尾;
1025
+ - `truncated`:预览未覆盖全部正文时为 true;
1026
+ - `content_length`:原始正文总长(字符)。
1027
+
1028
+ 全文只经 `memory_get` 获取:
1029
+
1030
+ - `id` 接受完整标识或**唯一前缀**(≥8 字符;歧义时报候选完整标识,绝不猜测);
1031
+ - 传 `ids` 数组可批量(上限 10,逐条作用域检查,不可读条目只返回 `readable:false` 与错误码,不带正文)。
1032
+
1033
+ DSH 插件的注入行格式为 `[<id 前 16 字符>|<kind>] <预览>`——模型看到「有这条记忆」后可直接用短标识调 `memory_get` 下钻。为什么是 16 字符:uuidv7 的前 12 hex 是毫秒时间戳,同一毫秒写入的记忆共享前 ≥13 字符,8 字符前缀在新建库上几乎必然歧义。
1034
+
1035
+ 诚实口径:这一改造省的是「单次检索结果的 token 与长尾全文」,不是端到端节省倍数——多数查询看预览即止时才真正省钱;若每条都跟着取全文,反而多一轮调用。
1036
+
1037
+ ## 检索携带项目身份(add-project-scope-recall)
1038
+
1039
+ `memory_search` / `memory_context` 支持可选项目参数,使 project-global / project-device 作用域的记忆可被召回:
1040
+
1041
+ - `project`(memory_search)/ `project_id`(memory_context):接受项目 **UUID** 或**已登记的路径 / git URL 别名**;
1042
+ - 携带后,同项目记忆 + 无项目绑定记忆(personal-global 等)照常返回;其他项目的记忆不可见;
1043
+ - **只查不建**:未登记的别名报错并指引先走 `project_resolve`(检索路径绝不创建项目行);
1044
+ - 携带项目身份**不放宽**其他维度:设备 / Agent / 读允许名单检查照旧,device-local 与 agent-private 的隔离不变。
1045
+
1046
+ DSH 插件配置(cordis.patch.yml 插件条目 config):`projectPath: '<路径或 git URL>'`——配置后插件启动时经 `project_resolve` 解析并缓存(登记语义在此),此后自动召回携带项目身份;解析失败**降级**为不带项目召回并在面板状态卡如实提示(「降级:<原因>」),personal-global 记忆不受影响。未配置时行为与从前完全一致。
package/package.json CHANGED
@@ -1,74 +1,74 @@
1
- {
2
- "name": "@carloswon/cairn-memory",
3
- "version": "0.5.0",
4
- "description": "Cairn — 个人、多设备、多 Agent 的本地优先记忆主权层。本地 SQLite 为权威副本,云端仅作可选加密中继。",
5
- "license": "MIT",
6
- "type": "module",
7
- "engines": {
8
- "node": ">=22.5.0"
9
- },
10
- "bin": {
11
- "cairn": "dist/src/interfaces/cli/main.js",
12
- "cairn-mcp": "dist/src/interfaces/mcp/server.js"
13
- },
14
- "files": [
15
- "dist/src",
16
- "!dist/tests",
17
- "README.md",
18
- "LICENSE",
19
- "CHANGELOG.md",
20
- "docs/cairn-usage.md",
21
- "docs/cairn-security.md"
22
- ],
23
- "exports": {
24
- ".": "./dist/src/index.js",
25
- "./core": "./dist/src/core/index.js"
26
- },
27
- "scripts": {
28
- "build": "tsc -p tsconfig.build.json",
29
- "cli": "tsx src/interfaces/cli/main.ts",
30
- "mcp": "tsx src/interfaces/mcp/server.ts",
31
- "typecheck": "tsc -p tsconfig.json --noEmit",
32
- "test": "npm run build && tsx --test --test-concurrency=2 \"tests/**/*.test.ts\"",
33
- "test:module": "node --import tsx --test",
34
- "test:real": "node scripts/test-real-obs.mjs",
35
- "mcp:smoke": "npm run build && node scripts/mcp-smoke.mjs",
36
- "smoke:pack": "npm run build && npm pack --dry-run",
37
- "test:e2e": "npm run build && node scripts/e2e-onboarding.mjs",
38
- "test:ui": "npm run build && node scripts/e2e-console-ui.mjs"
39
- },
40
- "dependencies": {
41
- "@modelcontextprotocol/sdk": "^1.20.0",
42
- "@noble/ciphers": "^2.4.0",
43
- "@noble/hashes": "^2.4.0"
44
- },
45
- "devDependencies": {
46
- "@types/node": "^24.0.0",
47
- "tsx": "^4.19.0",
48
- "typescript": "^5.6.0"
49
- },
50
- "keywords": [
51
- "memory",
52
- "agent-memory",
53
- "mcp",
54
- "model-context-protocol",
55
- "local-first",
56
- "sqlite",
57
- "ai-agents",
58
- "memory-sovereignty",
59
- "fts5",
60
- "cli"
61
- ],
62
- "repository": {
63
- "type": "git",
64
- "url": "git+https://github.com/CarlosWonMore/cairn.git"
65
- },
66
- "homepage": "https://github.com/CarlosWonMore/cairn#readme",
67
- "bugs": {
68
- "url": "https://github.com/CarlosWonMore/cairn/issues"
69
- },
70
- "author": "Carlos",
71
- "publishConfig": {
72
- "access": "public"
73
- }
74
- }
1
+ {
2
+ "name": "@carloswon/cairn-memory",
3
+ "version": "0.6.1",
4
+ "description": "Cairn — 个人、多设备、多 Agent 的本地优先记忆主权层。本地 SQLite 为权威副本,云端仅作可选加密中继。",
5
+ "license": "MIT",
6
+ "type": "module",
7
+ "engines": {
8
+ "node": ">=22.5.0"
9
+ },
10
+ "bin": {
11
+ "cairn": "dist/src/interfaces/cli/main.js",
12
+ "cairn-mcp": "dist/src/interfaces/mcp/server.js"
13
+ },
14
+ "files": [
15
+ "dist/src",
16
+ "!dist/tests",
17
+ "README.md",
18
+ "LICENSE",
19
+ "CHANGELOG.md",
20
+ "docs/cairn-usage.md",
21
+ "docs/cairn-security.md"
22
+ ],
23
+ "exports": {
24
+ ".": "./dist/src/index.js",
25
+ "./core": "./dist/src/core/index.js"
26
+ },
27
+ "scripts": {
28
+ "build": "tsc -p tsconfig.build.json",
29
+ "cli": "tsx src/interfaces/cli/main.ts",
30
+ "mcp": "tsx src/interfaces/mcp/server.ts",
31
+ "typecheck": "tsc -p tsconfig.json --noEmit",
32
+ "test": "npm run build && tsx --test --test-concurrency=2 \"tests/**/*.test.ts\"",
33
+ "test:module": "node --import tsx --test",
34
+ "test:real": "node scripts/test-real-obs.mjs",
35
+ "mcp:smoke": "npm run build && node scripts/mcp-smoke.mjs",
36
+ "smoke:pack": "npm run build && npm pack --dry-run",
37
+ "test:e2e": "npm run build && node scripts/e2e-onboarding.mjs",
38
+ "test:ui": "npm run build && node scripts/e2e-console-ui.mjs"
39
+ },
40
+ "dependencies": {
41
+ "@modelcontextprotocol/sdk": "^1.20.0",
42
+ "@noble/ciphers": "^2.4.0",
43
+ "@noble/hashes": "^2.4.0"
44
+ },
45
+ "devDependencies": {
46
+ "@types/node": "^24.0.0",
47
+ "tsx": "^4.19.0",
48
+ "typescript": "^5.6.0"
49
+ },
50
+ "keywords": [
51
+ "memory",
52
+ "agent-memory",
53
+ "mcp",
54
+ "model-context-protocol",
55
+ "local-first",
56
+ "sqlite",
57
+ "ai-agents",
58
+ "memory-sovereignty",
59
+ "fts5",
60
+ "cli"
61
+ ],
62
+ "repository": {
63
+ "type": "git",
64
+ "url": "git+https://github.com/CarlosWonMore/cairn.git"
65
+ },
66
+ "homepage": "https://github.com/CarlosWonMore/cairn#readme",
67
+ "bugs": {
68
+ "url": "https://github.com/CarlosWonMore/cairn/issues"
69
+ },
70
+ "author": "Carlos",
71
+ "publishConfig": {
72
+ "access": "public"
73
+ }
74
+ }