@carloswon/cairn-memory 0.6.1 → 0.6.3
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/README.md +2 -2
- package/dist/src/core/types.d.ts +6 -0
- package/dist/src/core/types.js.map +1 -1
- package/dist/src/governance/apply.js +3 -12
- package/dist/src/governance/apply.js.map +1 -1
- package/dist/src/interfaces/app-service.d.ts +19 -0
- package/dist/src/interfaces/app-service.js +107 -67
- package/dist/src/interfaces/app-service.js.map +1 -1
- package/dist/src/interfaces/cli/main.js +25 -6
- package/dist/src/interfaces/cli/main.js.map +1 -1
- package/dist/src/interfaces/console/assets/ui-js.js +53 -5
- package/dist/src/interfaces/console/assets/ui-js.js.map +1 -1
- package/dist/src/interfaces/console/assets/url-state.d.ts +1 -1
- package/dist/src/interfaces/console/assets/url-state.js +2 -2
- package/dist/src/interfaces/console/assets/url-state.js.map +1 -1
- package/dist/src/interfaces/console/model.d.ts +23 -0
- package/dist/src/interfaces/console/model.js +41 -1
- package/dist/src/interfaces/console/model.js.map +1 -1
- package/dist/src/interfaces/console/server.js +14 -2
- package/dist/src/interfaces/console/server.js.map +1 -1
- package/dist/src/interfaces/mcp/server.js +3 -0
- package/dist/src/interfaces/mcp/server.js.map +1 -1
- package/dist/src/store/memories.d.ts +6 -1
- package/dist/src/store/memories.js +9 -3
- package/dist/src/store/memories.js.map +1 -1
- package/dist/src/store/migrate.js +10 -1
- package/dist/src/store/migrate.js.map +1 -1
- package/dist/src/store/open.js +1 -1
- package/dist/src/store/open.js.map +1 -1
- package/dist/src/store/outbox.d.ts +8 -7
- package/dist/src/store/outbox.js +34 -1
- package/dist/src/store/outbox.js.map +1 -1
- package/dist/src/store/schema.d.ts +17 -0
- package/dist/src/store/schema.js +65 -0
- package/dist/src/store/schema.js.map +1 -1
- package/dist/src/sync/apply.d.ts +12 -2
- package/dist/src/sync/apply.js +109 -19
- package/dist/src/sync/apply.js.map +1 -1
- package/dist/src/sync/backfill.d.ts +48 -5
- package/dist/src/sync/backfill.js +70 -10
- package/dist/src/sync/backfill.js.map +1 -1
- package/dist/src/sync/events.d.ts +18 -0
- package/dist/src/sync/events.js.map +1 -1
- package/dist/src/sync/orchestrate.d.ts +4 -0
- package/dist/src/sync/orchestrate.js +24 -10
- package/dist/src/sync/orchestrate.js.map +1 -1
- package/dist/src/sync/pull.d.ts +8 -3
- package/dist/src/sync/pull.js +95 -79
- package/dist/src/sync/pull.js.map +1 -1
- package/dist/src/sync/push.d.ts +16 -0
- package/dist/src/sync/push.js +146 -38
- package/dist/src/sync/push.js.map +1 -1
- package/dist/src/sync/route.d.ts +44 -0
- package/dist/src/sync/route.js +88 -0
- package/dist/src/sync/route.js.map +1 -0
- package/dist/src/sync/vault.d.ts +27 -1
- package/dist/src/sync/vault.js +41 -1
- package/dist/src/sync/vault.js.map +1 -1
- package/docs/cairn-security.md +25 -18
- package/package.json +74 -74
package/docs/cairn-security.md
CHANGED
|
@@ -37,15 +37,22 @@
|
|
|
37
37
|
|
|
38
38
|
## 2. 作用域物理边界
|
|
39
39
|
|
|
40
|
-
### 2.1
|
|
40
|
+
### 2.1 上行排除与保管模式(双模,add-cloud-preserve-mode 起)
|
|
41
41
|
|
|
42
|
-
`local_only` 与设备限定内容(`device-local` / `project-device` / `agent-private` / `session-ephemeral` / 自定义 local_only
|
|
42
|
+
`local_only` 与设备限定内容(`device-local` / `project-device` / `agent-private` / `session-ephemeral` / 自定义 local_only 空间)的上行语义由 **vault 级保管模式开关**(`cairn vault config --preserve-device-bound on|off`,默认关闭)决定:
|
|
43
43
|
|
|
44
|
-
|
|
45
|
-
|
|
44
|
+
- **关闭(默认)**:延续既有物理排除语义——设备限定内容不产生任何上行任务;`agent-private` 与 `session-ephemeral` 永不上云。project-global 等非个人全局内容即使有历史入队任务,也只会被「完成 + 审计 `sync_job_unroutable`」,不产生任何远端事件。
|
|
45
|
+
- **开启(用户显式决定)**:设备限定与项目内容以密文上行到**本设备的保管链**(`preserve/<deviceId>`),事件携带归属设备标签与作用域描述符;**其他设备的保管链不会被拉取**,云端对象仍无明文。`agent-private` 与 `session-ephemeral` 在任何模式下都**不上云**。
|
|
46
|
+
|
|
47
|
+
无论哪种模式,个人链内容的排除都是两层执行:
|
|
48
|
+
|
|
49
|
+
1. **应用层入口**:写入、更正、遗忘、计划应用统一经 `sync/route.ts` 的单一路由判定(个人链 / 保管链 / 不入队)。检索、详情、导出、投影走同一个 `scopeAllowsRead` / 同一组判定入口,禁止各入口自行解释作用域(spec scoped-retrieval「全通道作用域隔离」)。
|
|
50
|
+
2. **数据库触发器兜底**:`outbox_reject_local_upstream` 在 `outbox_job` 插入前检查——`sync_upstream` 任务的作用域若非 `encrypted` + `device_id='all'` 直接 `RAISE(ABORT, 'scope_not_upstreamable')`。保管链任务(`sync_preserve`)在应用层只收保管链承载的作用域,且必须保管模式开启。
|
|
46
51
|
|
|
47
52
|
作用域校验(`validateScopeSpec`)另有硬规则:设备绑定作用域必须是 `local_only`;`sensitive` 内容必须 `local_only`;`encrypted` 同步要求设备为 all。这些规则无法通过 CLI/MCP 参数绕过。
|
|
48
53
|
|
|
54
|
+
**密钥泄露爆炸半径(用户已确认的取舍)**:保管模式开启的 vault 上,vault 密钥泄露的影响范围从「个人全局内容」扩大到「全部记忆」——对端与本机共享 vault 密钥,被入侵的对端可解其他设备保管链的密文。这是换取「全量密文异地保管 + 设备找回」能力的代价;不接受该取舍的用户保持开关关闭即可,关闭时语义与 0.6.x 完全一致。`candidate` / `sensitive` 内容在保管模式下同样会密文上云——某条内容若绝不能离开本机,请使用 `agent-private` 作用域(任何模式都不上云)。
|
|
55
|
+
|
|
49
56
|
### 2.2 导出与投影
|
|
50
57
|
|
|
51
58
|
导出(`cairn export`)与受管投影(`agent plan/apply` 写入的区块内容)走同一判定入口:`local_only` 作用域的内容可以出现在本地导出文件中(本地导出是权威库的本地行为,不是上行),但对应的投影与上行生成仍然只使用其作用域允许的内容;受管投影文件带唯一标记(`<!-- cairn:begin block="cairn-memory" -->`),导入含该标记的文件会被拒绝(`E_PROJECTION_LOOP`),防止导出—回读—再导出回环。
|
|
@@ -265,17 +272,17 @@ cairn uninstall # 遍历五个宿主,移除所有本产品配置
|
|
|
265
272
|
## 10. 操作审计只存摘要(add-operation-audit)
|
|
266
273
|
|
|
267
274
|
读取类操作审计(`operation` 类目)由**构造方式**保证零内容泄露:审计写入点只从操作返回值提取白名单计数字段(候选数、命中通道、耗时、对象 id),代码路径上接触不到查询原文与记忆正文。回归测试断言敏感正文与查询原文在审计全表中零出现。保留期清理按类目白名单执行(只清 `operation`),治理审计(计划/审批/写入)永不自动删除;审计入口全部只读,不存在修改/删除审计的命令或工具。
|
|
268
|
-
|
|
269
|
-
---
|
|
270
|
-
|
|
271
|
-
## 11. Agent 不持有记忆写入权(add-agent-managed-revision)
|
|
272
|
-
|
|
273
|
-
「模型只生成候选」在修订环节的落点:Agent 对**已存在的记忆**没有直接修改权。MCP 工具面提供 `revision_propose`(写方案卡)与 `revision_list`(读卡),**刻意不提供任何 apply 工具**——应用提案只能由本地入口(CLI `cairn revision apply`、本地控制台点击)发起,走与人工 `memory_update` 完全相同的修订链、秘密复检与审计。
|
|
274
|
-
|
|
275
|
-
三条机制保证这条边界不是靠约定:
|
|
276
|
-
|
|
277
|
-
1. **工具面即权限面**:MCP 进程根本没有应用提案的代码路径可调(`tests/interfaces/revision-mcp.test.ts` 断言工具面不含 apply)。
|
|
278
|
-
2. **版本一致性不可绕过**:方案卡记录提出时的修订 id,应用时两层校验(提案层 + `reviseMemory` 的 `expectedCurrentRevisionId`);记忆已被改过则拒绝并标陈旧。
|
|
279
|
-
3. **权威语义**:采纳后的新修订记 `user_confirmed`(人批准了 Agent 起草的内容),既不是 `agent_inferred` 也不是 `user_explicit`。
|
|
280
|
-
|
|
281
|
-
方案卡文件与批注同信任域(本机明文 JSON,含拟改正文);生成时秘密扫描命中即拒绝落盘,采纳时再扫一次。
|
|
275
|
+
|
|
276
|
+
---
|
|
277
|
+
|
|
278
|
+
## 11. Agent 不持有记忆写入权(add-agent-managed-revision)
|
|
279
|
+
|
|
280
|
+
「模型只生成候选」在修订环节的落点:Agent 对**已存在的记忆**没有直接修改权。MCP 工具面提供 `revision_propose`(写方案卡)与 `revision_list`(读卡),**刻意不提供任何 apply 工具**——应用提案只能由本地入口(CLI `cairn revision apply`、本地控制台点击)发起,走与人工 `memory_update` 完全相同的修订链、秘密复检与审计。
|
|
281
|
+
|
|
282
|
+
三条机制保证这条边界不是靠约定:
|
|
283
|
+
|
|
284
|
+
1. **工具面即权限面**:MCP 进程根本没有应用提案的代码路径可调(`tests/interfaces/revision-mcp.test.ts` 断言工具面不含 apply)。
|
|
285
|
+
2. **版本一致性不可绕过**:方案卡记录提出时的修订 id,应用时两层校验(提案层 + `reviseMemory` 的 `expectedCurrentRevisionId`);记忆已被改过则拒绝并标陈旧。
|
|
286
|
+
3. **权威语义**:采纳后的新修订记 `user_confirmed`(人批准了 Agent 起草的内容),既不是 `agent_inferred` 也不是 `user_explicit`。
|
|
287
|
+
|
|
288
|
+
方案卡文件与批注同信任域(本机明文 JSON,含拟改正文);生成时秘密扫描命中即拒绝落盘,采纳时再扫一次。
|
package/package.json
CHANGED
|
@@ -1,74 +1,74 @@
|
|
|
1
|
-
{
|
|
2
|
-
"name": "@carloswon/cairn-memory",
|
|
3
|
-
"version": "0.6.
|
|
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.3",
|
|
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
|
+
}
|