@carloswon/cairn-memory 0.0.0-stage → 0.3.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.
Files changed (225) hide show
  1. package/CHANGELOG.md +81 -0
  2. package/LICENSE +21 -0
  3. package/README.md +158 -2
  4. package/dist/src/agents/adapters.d.ts +82 -0
  5. package/dist/src/agents/adapters.js +209 -0
  6. package/dist/src/agents/adapters.js.map +1 -0
  7. package/dist/src/agents/config.d.ts +82 -0
  8. package/dist/src/agents/config.js +603 -0
  9. package/dist/src/agents/config.js.map +1 -0
  10. package/dist/src/agents/cordisPatch.d.ts +89 -0
  11. package/dist/src/agents/cordisPatch.js +201 -0
  12. package/dist/src/agents/cordisPatch.js.map +1 -0
  13. package/dist/src/agents/index.d.ts +2 -0
  14. package/dist/src/agents/index.js +3 -0
  15. package/dist/src/agents/index.js.map +1 -0
  16. package/dist/src/core/errors.d.ts +36 -0
  17. package/dist/src/core/errors.js +74 -0
  18. package/dist/src/core/errors.js.map +1 -0
  19. package/dist/src/core/hash.d.ts +14 -0
  20. package/dist/src/core/hash.js +48 -0
  21. package/dist/src/core/hash.js.map +1 -0
  22. package/dist/src/core/ids.d.ts +10 -0
  23. package/dist/src/core/ids.js +41 -0
  24. package/dist/src/core/ids.js.map +1 -0
  25. package/dist/src/core/index.d.ts +6 -0
  26. package/dist/src/core/index.js +7 -0
  27. package/dist/src/core/index.js.map +1 -0
  28. package/dist/src/core/scope.d.ts +78 -0
  29. package/dist/src/core/scope.js +181 -0
  30. package/dist/src/core/scope.js.map +1 -0
  31. package/dist/src/core/secrets.d.ts +13 -0
  32. package/dist/src/core/secrets.js +122 -0
  33. package/dist/src/core/secrets.js.map +1 -0
  34. package/dist/src/core/time.d.ts +7 -0
  35. package/dist/src/core/time.js +18 -0
  36. package/dist/src/core/time.js.map +1 -0
  37. package/dist/src/core/types.d.ts +139 -0
  38. package/dist/src/core/types.js +30 -0
  39. package/dist/src/core/types.js.map +1 -0
  40. package/dist/src/governance/apply.d.ts +64 -0
  41. package/dist/src/governance/apply.js +160 -0
  42. package/dist/src/governance/apply.js.map +1 -0
  43. package/dist/src/governance/archive.d.ts +29 -0
  44. package/dist/src/governance/archive.js +52 -0
  45. package/dist/src/governance/archive.js.map +1 -0
  46. package/dist/src/governance/dedup.d.ts +21 -0
  47. package/dist/src/governance/dedup.js +23 -0
  48. package/dist/src/governance/dedup.js.map +1 -0
  49. package/dist/src/governance/index.d.ts +16 -0
  50. package/dist/src/governance/index.js +17 -0
  51. package/dist/src/governance/index.js.map +1 -0
  52. package/dist/src/governance/propose.d.ts +78 -0
  53. package/dist/src/governance/propose.js +150 -0
  54. package/dist/src/governance/propose.js.map +1 -0
  55. package/dist/src/index.d.ts +15 -0
  56. package/dist/src/index.js +24 -0
  57. package/dist/src/index.js.map +1 -0
  58. package/dist/src/interfaces/app-service.d.ts +292 -0
  59. package/dist/src/interfaces/app-service.js +743 -0
  60. package/dist/src/interfaces/app-service.js.map +1 -0
  61. package/dist/src/interfaces/cli/main.d.ts +2 -0
  62. package/dist/src/interfaces/cli/main.js +854 -0
  63. package/dist/src/interfaces/cli/main.js.map +1 -0
  64. package/dist/src/interfaces/console/assets/page.d.ts +18 -0
  65. package/dist/src/interfaces/console/assets/page.js +39 -0
  66. package/dist/src/interfaces/console/assets/page.js.map +1 -0
  67. package/dist/src/interfaces/console/assets/ui-css.d.ts +11 -0
  68. package/dist/src/interfaces/console/assets/ui-css.js +119 -0
  69. package/dist/src/interfaces/console/assets/ui-css.js.map +1 -0
  70. package/dist/src/interfaces/console/assets/ui-js.d.ts +14 -0
  71. package/dist/src/interfaces/console/assets/ui-js.js +1098 -0
  72. package/dist/src/interfaces/console/assets/ui-js.js.map +1 -0
  73. package/dist/src/interfaces/console/assets/url-state.d.ts +9 -0
  74. package/dist/src/interfaces/console/assets/url-state.js +45 -0
  75. package/dist/src/interfaces/console/assets/url-state.js.map +1 -0
  76. package/dist/src/interfaces/console/export.d.ts +46 -0
  77. package/dist/src/interfaces/console/export.js +84 -0
  78. package/dist/src/interfaces/console/export.js.map +1 -0
  79. package/dist/src/interfaces/console/model.d.ts +372 -0
  80. package/dist/src/interfaces/console/model.js +731 -0
  81. package/dist/src/interfaces/console/model.js.map +1 -0
  82. package/dist/src/interfaces/console/review-store.d.ts +142 -0
  83. package/dist/src/interfaces/console/review-store.js +342 -0
  84. package/dist/src/interfaces/console/review-store.js.map +1 -0
  85. package/dist/src/interfaces/console/security.d.ts +76 -0
  86. package/dist/src/interfaces/console/security.js +105 -0
  87. package/dist/src/interfaces/console/security.js.map +1 -0
  88. package/dist/src/interfaces/console/server.d.ts +45 -0
  89. package/dist/src/interfaces/console/server.js +476 -0
  90. package/dist/src/interfaces/console/server.js.map +1 -0
  91. package/dist/src/interfaces/console/suggestions.d.ts +112 -0
  92. package/dist/src/interfaces/console/suggestions.js +511 -0
  93. package/dist/src/interfaces/console/suggestions.js.map +1 -0
  94. package/dist/src/interfaces/console/text.d.ts +4 -0
  95. package/dist/src/interfaces/console/text.js +18 -0
  96. package/dist/src/interfaces/console/text.js.map +1 -0
  97. package/dist/src/interfaces/mcp/server.d.ts +4 -0
  98. package/dist/src/interfaces/mcp/server.js +480 -0
  99. package/dist/src/interfaces/mcp/server.js.map +1 -0
  100. package/dist/src/jobs/index.d.ts +6 -0
  101. package/dist/src/jobs/index.js +7 -0
  102. package/dist/src/jobs/index.js.map +1 -0
  103. package/dist/src/jobs/remote.d.ts +42 -0
  104. package/dist/src/jobs/remote.js +34 -0
  105. package/dist/src/jobs/remote.js.map +1 -0
  106. package/dist/src/jobs/worker.d.ts +67 -0
  107. package/dist/src/jobs/worker.js +169 -0
  108. package/dist/src/jobs/worker.js.map +1 -0
  109. package/dist/src/onboarding/auto.d.ts +88 -0
  110. package/dist/src/onboarding/auto.js +399 -0
  111. package/dist/src/onboarding/auto.js.map +1 -0
  112. package/dist/src/onboarding/batches.d.ts +103 -0
  113. package/dist/src/onboarding/batches.js +219 -0
  114. package/dist/src/onboarding/batches.js.map +1 -0
  115. package/dist/src/onboarding/discover.d.ts +54 -0
  116. package/dist/src/onboarding/discover.js +369 -0
  117. package/dist/src/onboarding/discover.js.map +1 -0
  118. package/dist/src/onboarding/import.d.ts +69 -0
  119. package/dist/src/onboarding/import.js +279 -0
  120. package/dist/src/onboarding/import.js.map +1 -0
  121. package/dist/src/onboarding/index.d.ts +24 -0
  122. package/dist/src/onboarding/index.js +22 -0
  123. package/dist/src/onboarding/index.js.map +1 -0
  124. package/dist/src/onboarding/judgement.d.ts +50 -0
  125. package/dist/src/onboarding/judgement.js +121 -0
  126. package/dist/src/onboarding/judgement.js.map +1 -0
  127. package/dist/src/onboarding/policy.d.ts +86 -0
  128. package/dist/src/onboarding/policy.js +249 -0
  129. package/dist/src/onboarding/policy.js.map +1 -0
  130. package/dist/src/projection/brief.d.ts +112 -0
  131. package/dist/src/projection/brief.js +200 -0
  132. package/dist/src/projection/brief.js.map +1 -0
  133. package/dist/src/projection/index.d.ts +1 -0
  134. package/dist/src/projection/index.js +2 -0
  135. package/dist/src/projection/index.js.map +1 -0
  136. package/dist/src/projection/markdown.d.ts +82 -0
  137. package/dist/src/projection/markdown.js +313 -0
  138. package/dist/src/projection/markdown.js.map +1 -0
  139. package/dist/src/retrieval/export.d.ts +80 -0
  140. package/dist/src/retrieval/export.js +215 -0
  141. package/dist/src/retrieval/export.js.map +1 -0
  142. package/dist/src/retrieval/index.d.ts +5 -0
  143. package/dist/src/retrieval/index.js +6 -0
  144. package/dist/src/retrieval/index.js.map +1 -0
  145. package/dist/src/retrieval/search.d.ts +37 -0
  146. package/dist/src/retrieval/search.js +294 -0
  147. package/dist/src/retrieval/search.js.map +1 -0
  148. package/dist/src/store/archives.d.ts +94 -0
  149. package/dist/src/store/archives.js +135 -0
  150. package/dist/src/store/archives.js.map +1 -0
  151. package/dist/src/store/audit.d.ts +57 -0
  152. package/dist/src/store/audit.js +131 -0
  153. package/dist/src/store/audit.js.map +1 -0
  154. package/dist/src/store/backup.d.ts +36 -0
  155. package/dist/src/store/backup.js +90 -0
  156. package/dist/src/store/backup.js.map +1 -0
  157. package/dist/src/store/blocks.d.ts +64 -0
  158. package/dist/src/store/blocks.js +104 -0
  159. package/dist/src/store/blocks.js.map +1 -0
  160. package/dist/src/store/conflicts.d.ts +52 -0
  161. package/dist/src/store/conflicts.js +112 -0
  162. package/dist/src/store/conflicts.js.map +1 -0
  163. package/dist/src/store/db.d.ts +44 -0
  164. package/dist/src/store/db.js +162 -0
  165. package/dist/src/store/db.js.map +1 -0
  166. package/dist/src/store/device.d.ts +46 -0
  167. package/dist/src/store/device.js +111 -0
  168. package/dist/src/store/device.js.map +1 -0
  169. package/dist/src/store/index.d.ts +14 -0
  170. package/dist/src/store/index.js +15 -0
  171. package/dist/src/store/index.js.map +1 -0
  172. package/dist/src/store/memories.d.ts +133 -0
  173. package/dist/src/store/memories.js +442 -0
  174. package/dist/src/store/memories.js.map +1 -0
  175. package/dist/src/store/migrate.d.ts +32 -0
  176. package/dist/src/store/migrate.js +87 -0
  177. package/dist/src/store/migrate.js.map +1 -0
  178. package/dist/src/store/open.d.ts +53 -0
  179. package/dist/src/store/open.js +203 -0
  180. package/dist/src/store/open.js.map +1 -0
  181. package/dist/src/store/outbox.d.ts +65 -0
  182. package/dist/src/store/outbox.js +137 -0
  183. package/dist/src/store/outbox.js.map +1 -0
  184. package/dist/src/store/plans.d.ts +137 -0
  185. package/dist/src/store/plans.js +243 -0
  186. package/dist/src/store/plans.js.map +1 -0
  187. package/dist/src/store/schema.d.ts +46 -0
  188. package/dist/src/store/schema.js +544 -0
  189. package/dist/src/store/schema.js.map +1 -0
  190. package/dist/src/store/scopes.d.ts +44 -0
  191. package/dist/src/store/scopes.js +220 -0
  192. package/dist/src/store/scopes.js.map +1 -0
  193. package/dist/src/store/write-guard.d.ts +10 -0
  194. package/dist/src/store/write-guard.js +10 -0
  195. package/dist/src/store/write-guard.js.map +1 -0
  196. package/dist/src/sync/apply.d.ts +24 -0
  197. package/dist/src/sync/apply.js +130 -0
  198. package/dist/src/sync/apply.js.map +1 -0
  199. package/dist/src/sync/cryptoutil.d.ts +86 -0
  200. package/dist/src/sync/cryptoutil.js +339 -0
  201. package/dist/src/sync/cryptoutil.js.map +1 -0
  202. package/dist/src/sync/events.d.ts +69 -0
  203. package/dist/src/sync/events.js +78 -0
  204. package/dist/src/sync/events.js.map +1 -0
  205. package/dist/src/sync/obs-store.d.ts +41 -0
  206. package/dist/src/sync/obs-store.js +325 -0
  207. package/dist/src/sync/obs-store.js.map +1 -0
  208. package/dist/src/sync/orchestrate.d.ts +37 -0
  209. package/dist/src/sync/orchestrate.js +84 -0
  210. package/dist/src/sync/orchestrate.js.map +1 -0
  211. package/dist/src/sync/pull.d.ts +24 -0
  212. package/dist/src/sync/pull.js +150 -0
  213. package/dist/src/sync/pull.js.map +1 -0
  214. package/dist/src/sync/push.d.ts +19 -0
  215. package/dist/src/sync/push.js +227 -0
  216. package/dist/src/sync/push.js.map +1 -0
  217. package/dist/src/sync/syncd-store.d.ts +31 -0
  218. package/dist/src/sync/syncd-store.js +92 -0
  219. package/dist/src/sync/syncd-store.js.map +1 -0
  220. package/dist/src/sync/vault.d.ts +37 -0
  221. package/dist/src/sync/vault.js +53 -0
  222. package/dist/src/sync/vault.js.map +1 -0
  223. package/docs/cairn-security.md +267 -0
  224. package/docs/cairn-usage.md +919 -0
  225. package/package.json +71 -4
@@ -0,0 +1,220 @@
1
+ import { validateScopeSpec, scopeAllowsRead, scopeAllowsUpstream, isPhysicallyLocal, } from '../core/scope.js';
2
+ import { err } from '../core/errors.js';
3
+ import { WriteGuardMixin } from './write-guard.js';
4
+ import { uuidv7 } from '../core/ids.js';
5
+ import { nowIso } from '../core/time.js';
6
+ export class ScopeRepository extends WriteGuardMixin {
7
+ db;
8
+ constructor(db) {
9
+ super();
10
+ this.db = db;
11
+ }
12
+ /** 首次初始化:确保内置个人空间存在。 */
13
+ ensureBaseSpace() {
14
+ const row = this.db.get("SELECT id FROM space WHERE space_kind = 'personal' LIMIT 1");
15
+ if (row)
16
+ return row.id;
17
+ const id = uuidv7();
18
+ this.db.run("INSERT INTO space (id, name, space_kind, created_at) VALUES (?, ?, 'personal', ?)", id, 'personal', nowIso());
19
+ return id;
20
+ }
21
+ ensureProject(projectId, name) {
22
+ const row = this.db.get('SELECT id FROM project WHERE id = ?', projectId);
23
+ if (row)
24
+ return;
25
+ this.db.run('INSERT INTO project (id, name, created_at) VALUES (?, ?, ?)', projectId, name, nowIso());
26
+ }
27
+ ensureProjectScope(projectId, projectName) {
28
+ this.ensureProject(projectId, projectName);
29
+ const row = this.db.get("SELECT id FROM space WHERE space_kind = 'project' AND project_id = ?", projectId);
30
+ if (!row) {
31
+ this.db.run("INSERT INTO space (id, name, space_kind, project_id, created_at) VALUES (?, ?, 'project', ?, ?)", uuidv7(), projectName, projectId, nowIso());
32
+ }
33
+ }
34
+ /**
35
+ * 按预设 find-or-create 作用域。device-local/project-device 需要显式 deviceId。
36
+ * 返回库中的 ScopeRow(校验后的规范形态)。
37
+ */
38
+ resolvePreset(name, opts = {}) {
39
+ this.checkWritable();
40
+ let spec;
41
+ switch (name) {
42
+ case 'personal-global':
43
+ spec = { ...personalSpec(), ...opts.overrides };
44
+ break;
45
+ case 'device-local': {
46
+ if (!opts.deviceId)
47
+ throw err('E_SCOPE_INVALID', 'device-local 需要 deviceId');
48
+ spec = { ...deviceSpec(opts.deviceId), ...opts.overrides };
49
+ break;
50
+ }
51
+ case 'project-global': {
52
+ if (!opts.projectId)
53
+ throw err('E_SCOPE_INVALID', 'project-global 需要 projectId');
54
+ spec = { ...projectSpec(opts.projectId, opts.projectName ?? opts.projectId, 'all'), ...opts.overrides };
55
+ break;
56
+ }
57
+ case 'project-device': {
58
+ if (!opts.projectId || !opts.deviceId)
59
+ throw err('E_SCOPE_INVALID', 'project-device 需要 projectId 与 deviceId');
60
+ spec = { ...projectSpec(opts.projectId, opts.projectName ?? opts.projectId, opts.deviceId), ...opts.overrides };
61
+ break;
62
+ }
63
+ case 'agent-private': {
64
+ if (!opts.agentId)
65
+ throw err('E_SCOPE_INVALID', 'agent-private 需要 agentId');
66
+ spec = { ...agentSpec(opts.agentId), ...opts.overrides };
67
+ break;
68
+ }
69
+ case 'session-ephemeral': {
70
+ spec = { ...sessionSpec(opts.ttlDays ?? 7), ...opts.overrides };
71
+ break;
72
+ }
73
+ default: {
74
+ const exhaustive = name;
75
+ throw err('E_SCOPE_INVALID', `未知预设 ${String(exhaustive)}`);
76
+ }
77
+ }
78
+ validateScopeSpec(spec);
79
+ return this.upsertByFingerprint(spec, true);
80
+ }
81
+ /** 受约束自定义空间(构想 §7.4):默认 local_only,显式扩大才放宽。 */
82
+ createCustom(spec) {
83
+ this.checkWritable();
84
+ validateScopeSpec(spec);
85
+ return this.upsertByFingerprint(spec, false);
86
+ }
87
+ /** 相同指纹复用已有作用域,避免同一策略产生多行。 */
88
+ upsertByFingerprint(spec, builtin) {
89
+ const existing = this.findByFingerprint(spec);
90
+ if (existing)
91
+ return existing;
92
+ const spaceId = this.ensureSpaceFor(spec);
93
+ const id = uuidv7();
94
+ this.db.run(`INSERT INTO scope (id, space_id, preset, scope_kind, project_id, device_id, agent_id, read_allowlist,
95
+ sync_policy, read_policy, retention_policy, projection_policy, sensitivity, ttl_days, builtin, created_at)
96
+ VALUES (?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?)`, id, spaceId, spec.preset, spec.scopeKind, spec.projectId, spec.deviceId, spec.agentId, JSON.stringify(spec.readAllowlist), spec.syncPolicy, spec.readPolicy, spec.retentionPolicy, spec.projectionPolicy, spec.sensitivity, spec.ttlDays, builtin ? 1 : 0, nowIso());
97
+ return this.requireById(id);
98
+ }
99
+ ensureSpaceFor(spec) {
100
+ if (spec.scopeKind === 'project' && spec.projectId) {
101
+ this.ensureProjectScope(spec.projectId, spec.spaceName);
102
+ const row = this.db.get("SELECT id FROM space WHERE space_kind = 'project' AND project_id = ?", spec.projectId);
103
+ return row.id;
104
+ }
105
+ const row = this.db.get('SELECT id FROM space WHERE name = ? AND space_kind = ?', spec.spaceName, spec.scopeKind === 'custom' ? 'custom' : 'personal');
106
+ if (row)
107
+ return row.id;
108
+ const id = uuidv7();
109
+ this.db.run('INSERT INTO space (id, name, space_kind, created_at) VALUES (?, ?, ?, ?)', id, spec.spaceName, spec.scopeKind === 'custom' ? 'custom' : 'personal', nowIso());
110
+ return id;
111
+ }
112
+ findByFingerprint(spec) {
113
+ const rows = this.db.all(`SELECT s.* FROM scope s WHERE s.preset = ? AND s.device_id = ? AND s.agent_id = ?
114
+ AND s.sync_policy = ? AND s.read_policy = ? AND s.retention_policy = ? AND s.projection_policy = ?
115
+ AND s.sensitivity = ? AND IFNULL(s.project_id,'') = IFNULL(?, '') AND IFNULL(s.ttl_days,-1) = IFNULL(?, -1)
116
+ AND s.read_allowlist = ?`, spec.preset, spec.deviceId, spec.agentId, spec.syncPolicy, spec.readPolicy, spec.retentionPolicy, spec.projectionPolicy, spec.sensitivity, spec.projectId, spec.ttlDays, JSON.stringify([...spec.readAllowlist].sort()));
117
+ if (rows.length === 0)
118
+ return null;
119
+ if (spec.preset === 'custom') {
120
+ const matchingName = rows.find((r) => {
121
+ const space = this.db.get('SELECT name FROM space WHERE id = ?', r.space_id);
122
+ return space?.name === spec.spaceName;
123
+ });
124
+ return matchingName ? mapScope(matchingName) : null;
125
+ }
126
+ return mapScope(rows[0]);
127
+ }
128
+ getById(id) {
129
+ const row = this.db.get('SELECT * FROM scope WHERE id = ?', id);
130
+ return row ? mapScope(row) : null;
131
+ }
132
+ requireById(id) {
133
+ const row = this.getById(id);
134
+ if (!row)
135
+ throw err('E_NOT_FOUND', `作用域不存在: ${id}`);
136
+ return row;
137
+ }
138
+ list() {
139
+ return this.db.all('SELECT * FROM scope ORDER BY created_at, id').map(mapScope);
140
+ }
141
+ /** 统一读取判定入口(检索/详情/导出/投影共用)。 */
142
+ allowsRead(scopeId, query) {
143
+ return scopeAllowsRead(this.requireById(scopeId), query);
144
+ }
145
+ allowsUpstream(scopeId) {
146
+ return scopeAllowsUpstream(this.requireById(scopeId));
147
+ }
148
+ isPhysicallyLocal(scopeId) {
149
+ return isPhysicallyLocal(this.requireById(scopeId));
150
+ }
151
+ }
152
+ // 预设基础形态(避免与 core/scope.ts 循环依赖的轻量副本语义一致)
153
+ function personalSpec() {
154
+ return {
155
+ preset: 'personal-global', scopeKind: 'personal', spaceName: 'personal', projectId: null,
156
+ deviceId: 'all', agentId: 'all', syncPolicy: 'encrypted', readPolicy: 'all_agents', readAllowlist: [],
157
+ retentionPolicy: 'permanent', projectionPolicy: 'none', sensitivity: 'normal', ttlDays: null,
158
+ };
159
+ }
160
+ function deviceSpec(deviceId) {
161
+ return {
162
+ preset: 'device-local', scopeKind: 'device', spaceName: 'device-local', projectId: null,
163
+ deviceId, agentId: 'all', syncPolicy: 'local_only', readPolicy: 'all_agents', readAllowlist: [],
164
+ retentionPolicy: 'permanent', projectionPolicy: 'none', sensitivity: 'normal', ttlDays: null,
165
+ };
166
+ }
167
+ function projectSpec(projectId, projectName, deviceId) {
168
+ return {
169
+ preset: deviceId === 'all' ? 'project-global' : 'project-device',
170
+ scopeKind: 'project', spaceName: projectName, projectId,
171
+ deviceId, agentId: 'all', syncPolicy: deviceId === 'all' ? 'encrypted' : 'local_only',
172
+ readPolicy: 'all_agents', readAllowlist: [], retentionPolicy: 'permanent',
173
+ projectionPolicy: 'none', sensitivity: 'normal', ttlDays: null,
174
+ };
175
+ }
176
+ function agentSpec(agentId) {
177
+ return {
178
+ preset: 'agent-private', scopeKind: 'agent', spaceName: `agent:${agentId}`, projectId: null,
179
+ deviceId: 'all', agentId, syncPolicy: 'local_only', readPolicy: 'allowlist', readAllowlist: [agentId],
180
+ retentionPolicy: 'permanent', projectionPolicy: 'none', sensitivity: 'normal', ttlDays: null,
181
+ };
182
+ }
183
+ function sessionSpec(ttlDays) {
184
+ return {
185
+ preset: 'session-ephemeral', scopeKind: 'personal', spaceName: 'session', projectId: null,
186
+ deviceId: 'all', agentId: 'all', syncPolicy: 'local_only', readPolicy: 'all_agents', readAllowlist: [],
187
+ retentionPolicy: 'ttl', projectionPolicy: 'none', sensitivity: 'normal', ttlDays,
188
+ };
189
+ }
190
+ export function mapScope(r) {
191
+ return {
192
+ id: r.id,
193
+ spaceId: r.space_id,
194
+ preset: r.preset,
195
+ scopeKind: r.scope_kind,
196
+ projectId: r.project_id ?? null,
197
+ deviceId: r.device_id,
198
+ agentId: r.agent_id,
199
+ readAllowlist: safeJsonArray(r.read_allowlist),
200
+ syncPolicy: r.sync_policy,
201
+ readPolicy: r.read_policy,
202
+ retentionPolicy: r.retention_policy,
203
+ projectionPolicy: r.projection_policy,
204
+ sensitivity: r.sensitivity,
205
+ ttlDays: r.ttl_days ?? null,
206
+ builtin: Number(r.builtin) === 1,
207
+ };
208
+ }
209
+ function safeJsonArray(s) {
210
+ if (!s)
211
+ return [];
212
+ try {
213
+ const v = JSON.parse(s);
214
+ return Array.isArray(v) ? v.map(String) : [];
215
+ }
216
+ catch {
217
+ return [];
218
+ }
219
+ }
220
+ //# sourceMappingURL=scopes.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"scopes.js","sourceRoot":"","sources":["../../../src/store/scopes.ts"],"names":[],"mappings":"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"}
@@ -0,0 +1,10 @@
1
+ /**
2
+ * 写路径守卫:设备克隆/暂停状态下所有仓储写操作必须先通过本守卫。
3
+ * openStore 在装配时注入;re-enroll 后由 store 更新守卫读取的状态。
4
+ */
5
+ export type WriteGuard = () => void;
6
+ export declare class WriteGuardMixin {
7
+ private guard;
8
+ setWriteGuard(g: WriteGuard | null): void;
9
+ protected checkWritable(): void;
10
+ }
@@ -0,0 +1,10 @@
1
+ export class WriteGuardMixin {
2
+ guard = null;
3
+ setWriteGuard(g) {
4
+ this.guard = g;
5
+ }
6
+ checkWritable() {
7
+ this.guard?.();
8
+ }
9
+ }
10
+ //# sourceMappingURL=write-guard.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"write-guard.js","sourceRoot":"","sources":["../../../src/store/write-guard.ts"],"names":[],"mappings":"AAMA,MAAM,OAAO,eAAe;IAClB,KAAK,GAAsB,IAAI,CAAC;IAExC,aAAa,CAAC,CAAoB;QAChC,IAAI,CAAC,KAAK,GAAG,CAAC,CAAC;IACjB,CAAC;IAES,aAAa;QACrB,IAAI,CAAC,KAAK,EAAE,EAAE,CAAC;IACjB,CAAC;CACF"}
@@ -0,0 +1,24 @@
1
+ import { CairnStore } from '../store/open.js';
2
+ import { SyncEvent } from './events.js';
3
+ import { AuditLog } from '../store/audit.js';
4
+ /**
5
+ * 拉取应用(design D4 / spec cloud-sync「拉取合并与冲突保留」):
6
+ * 事件以内容哈希链对账——已知修订按哈希幂等跳过;parentHash 对齐本地当前修订 → 快进;
7
+ * parentHash 在本地历史中但对不上当前 → 并发,双方保留并入冲突队列;
8
+ * parentHash 完全未知 → 等待依赖(不应用、游标不推进该事件所在链)。
9
+ * tombstone 传播:远端遗忘 → 本地 tombstoned;对已遗忘记忆的迟到 upsert 忽略并审计。
10
+ */
11
+ export interface ApplyOutcome {
12
+ applied: number;
13
+ skipped: number;
14
+ conflicted: number;
15
+ waited: number;
16
+ tombstoned: number;
17
+ shadowed: number;
18
+ }
19
+ export declare function applyEvent(store: CairnStore, ev: SyncEvent, spaceKey: string, audit: AuditLog): keyof ApplyOutcome;
20
+ /** 批量应用:parentHash 未知的事件保留在返回值中由调用方决定重试;单事件失败不拖垮整批。 */
21
+ export declare function applyEvents(store: CairnStore, events: SyncEvent[], spaceKey: string): {
22
+ outcome: ApplyOutcome;
23
+ waitEvents: SyncEvent[];
24
+ };
@@ -0,0 +1,130 @@
1
+ import { err } from '../core/errors.js';
2
+ import { nowIso } from '../core/time.js';
3
+ export function applyEvent(store, ev, spaceKey, audit) {
4
+ const memories = store.memories;
5
+ // 跨设备记忆身份对齐:id 命中 → 直接用;否则按修订内容哈希血统匹配
6
+ // (记忆 id 在各设备本地生成,不可跨设备引用——第一版实现的教训)
7
+ const mem = memories.get(ev.memoryId) ??
8
+ memories.get(matchByLineage(store, ev) ?? '');
9
+ if (ev.type === 'memory_tombstone') {
10
+ if (!mem) {
11
+ // 未知记忆的遗忘:无对象可标(首版边界,如实审计)
12
+ audit.record('sync', 'tombstone_unknown_memory', { type: 'memory', id: ev.memoryId }, { from: ev.deviceId, seq: ev.seq });
13
+ return 'shadowed';
14
+ }
15
+ if (mem.status === 'tombstoned')
16
+ return 'skipped';
17
+ memories.forget(mem.id, `sync from ${ev.deviceId}#${ev.seq}`, `sync:${ev.deviceId}`);
18
+ audit.record('sync', 'tombstone_propagated', { type: 'memory', id: mem.id }, { from: ev.deviceId, seq: ev.seq });
19
+ return 'tombstoned';
20
+ }
21
+ if (ev.type !== 'memory_upsert' || !ev.payload || !('content' in ev.payload)) {
22
+ throw err('E_VALIDATION', `upsert 事件缺 upsert payload: ${ev.memoryId}#${ev.seq}`);
23
+ }
24
+ const payload = ev.payload;
25
+ if (!mem) {
26
+ // 未知记忆:直接创建(内容哈希完整性在 validateUpsertEvent 已保证)
27
+ memories.add({
28
+ kind: payload.kind,
29
+ content: payload.content,
30
+ scopeId: scopeScopeId(store, spaceKey),
31
+ authority: payload.authority,
32
+ createdBy: payload.createdBy ?? `sync:${ev.deviceId}`,
33
+ sourceAgent: payload.sourceAgent,
34
+ sourceSessionId: null,
35
+ evidence: [],
36
+ expiresAt: payload.expiresAt,
37
+ sensitivity: payload.sensitivity,
38
+ observedAt: payload.observedAt,
39
+ }, store.identity.deviceId);
40
+ audit.record('sync', 'memory_created_from_remote', { type: 'memory', id: ev.memoryId }, { from: ev.deviceId, seq: ev.seq });
41
+ return 'applied';
42
+ }
43
+ if (mem.status === 'tombstoned') {
44
+ // 迟到的 upsert 不复活已遗忘记忆(保守;§10.2 遗忘与并发编辑进入恢复队列属后续)
45
+ audit.record('sync', 'upsert_shadowed_by_tombstone', { type: 'memory', id: mem.id }, { from: ev.deviceId, seq: ev.seq });
46
+ return 'shadowed';
47
+ }
48
+ if (mem.contentHash === payload.contentHash)
49
+ return 'skipped';
50
+ // 快进:远端事件的父哈希 == 本地当前内容哈希 → 远端是本地历史的孩子
51
+ if (payload.parentHash && payload.parentHash === mem.contentHash) {
52
+ memories.revise(mem.id, payload.content, { reason: `sync from ${ev.deviceId}#${ev.seq}`, author: `sync:${ev.deviceId}` }, store.identity.deviceId);
53
+ audit.record('sync', 'fast_forwarded', { type: 'memory', id: mem.id }, { from: ev.deviceId, seq: ev.seq });
54
+ return 'applied';
55
+ }
56
+ // 并发:parentHash 能对齐到本地历史(共同祖先)→ 保留双方并入冲突队列
57
+ const ancestor = payload.parentHash ? memories.findRevisionByContentHash(mem.id, payload.parentHash) : null;
58
+ if (payload.parentHash && ancestor) {
59
+ const incoming = memories.insertRemoteRevision(mem.id, {
60
+ content: payload.content,
61
+ contentHash: payload.contentHash,
62
+ author: `sync:${ev.deviceId}`,
63
+ reason: `remote revision ${payload.revisionId} (parent ${payload.parentHash.slice(0, 12)})`,
64
+ parentLocalRevisionId: mem.currentRevisionId,
65
+ baseRevisionId: ancestor.id,
66
+ }, store.identity.deviceId);
67
+ const current = memories.require(mem.id);
68
+ if (!current.currentRevisionId)
69
+ throw err('E_CONFLICT_STATE', '并发合并时缺少当前修订');
70
+ store.conflicts.record({
71
+ memoryId: mem.id,
72
+ baseRevisionId: ancestor.id,
73
+ revisionAId: current.currentRevisionId,
74
+ revisionBId: incoming.id,
75
+ });
76
+ audit.record('sync', 'conflict_recorded', { type: 'memory', id: mem.id }, { from: ev.deviceId, seq: ev.seq });
77
+ return 'conflicted';
78
+ }
79
+ // parentHash 未知(本地无该祖先)→ 等待依赖:不应用、调用方不推进游标
80
+ return 'waited';
81
+ }
82
+ /**
83
+ * 按内容哈希血统匹配本地记忆:upsert 用 [contentHash, parentHash],
84
+ * tombstone 用 knownHashes。任一修订哈希命中即同一记忆。
85
+ */
86
+ function matchByLineage(store, ev) {
87
+ if (ev.type === 'memory_upsert' && ev.payload) {
88
+ const p = ev.payload;
89
+ const hashes = [p.contentHash, p.parentHash].filter((h) => Boolean(h));
90
+ return store.memories.findMemoryIdByRevisionHashes(hashes);
91
+ }
92
+ if (ev.type === 'memory_tombstone' && ev.payload) {
93
+ const p = ev.payload;
94
+ return store.memories.findMemoryIdByRevisionHashes(p.knownHashes ?? []);
95
+ }
96
+ return null;
97
+ }
98
+ function scopeScopeId(store, spaceKey) {
99
+ if (spaceKey !== 'personal-global') {
100
+ throw err('E_VALIDATION', `本变更仅同步 personal-global 空间,收到 ${spaceKey}`);
101
+ }
102
+ return store.scopes.resolvePreset('personal-global').id;
103
+ }
104
+ /** 批量应用:parentHash 未知的事件保留在返回值中由调用方决定重试;单事件失败不拖垮整批。 */
105
+ export function applyEvents(store, events, spaceKey) {
106
+ const audit = store.audit;
107
+ const outcome = { applied: 0, skipped: 0, conflicted: 0, waited: 0, tombstoned: 0, shadowed: 0 };
108
+ const waitEvents = [];
109
+ for (const ev of events) {
110
+ try {
111
+ const r = applyEvent(store, ev, spaceKey, audit);
112
+ outcome[r]++;
113
+ if (r === 'waited')
114
+ waitEvents.push(ev);
115
+ }
116
+ catch (e) {
117
+ // 单事件失败:审计并跳过(不推进对它的处理),不中断整批
118
+ audit.record('sync', 'apply_error', { type: 'memory', id: ev.memoryId }, {
119
+ from: ev.deviceId,
120
+ seq: ev.seq,
121
+ error: e.message.slice(0, 200),
122
+ at: nowIso(),
123
+ });
124
+ outcome.waited++;
125
+ waitEvents.push(ev);
126
+ }
127
+ }
128
+ return { outcome, waitEvents };
129
+ }
130
+ //# sourceMappingURL=apply.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"apply.js","sourceRoot":"","sources":["../../../src/sync/apply.ts"],"names":[],"mappings":"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"}
@@ -0,0 +1,86 @@
1
+ /**
2
+ * Cairn 云同步 E2EE 工具(design D3 / spec「加密中继与密钥主权」)。
3
+ *
4
+ * 密文线格式(版本化;禁止自造算法,全部使用可审计纯 JS 库 @noble/ciphers、@noble/hashes):
5
+ *
6
+ * [version(1B)] [nonce(24B)] [XChaCha20-Poly1305 ciphertext || Poly1305 tag(16B)]
7
+ *
8
+ * - version 即 CIPHER_VERSION(当前 1);不匹配 → E_VALIDATION 'cipher_version_mismatch'。
9
+ * - nonce 每次加密用 CSPRNG 随机生成 24B(XChaCha 扩展 nonce,随机 nonce 安全)。
10
+ * - AAD = UTF8(`v1|${vaultId}|${spaceId}|${kind}|${objectId}`),把每段密文绑定到
11
+ * vault/space/kind/object:任一字段不匹配 → Poly1305 校验失败 →
12
+ * E_VALIDATION 'auth_tag_invalid'(密文不能被搬到别的 chunk/manifest 位置)。
13
+ * - space 数据密钥 = HKDF-SHA256(vaultKey, salt='cairn-space-key', info=`v1|${spaceId}`):
14
+ * vault 主密钥不直接加密任何数据,泄露面按 space 隔离(tests 有字面量锚定测试)。
15
+ *
16
+ * 信任边界(诚实声明,构想 §12.2):
17
+ * - keys.json 中的 vaultKey 是本地明文,与 SQLite 数据库文件处于同等信任边界;
18
+ * 文件权限只防误读,不防拿到磁盘的人;设备级保护依赖磁盘加密与账户隔离。
19
+ * - 恢复材料(CAIRN1.…)同样是密钥明文的编码形态,抄写保存,丢失即远端不可恢复。
20
+ * - 所有错误信息为稳定短语,绝不包含密钥字节(hex/base64)或记忆内容。
21
+ */
22
+ /** 密文格式版本号(线格式首字节)。未来算法更换/密钥轮换时递增并引入 keyId(design D3)。 */
23
+ export declare const CIPHER_VERSION = 1;
24
+ /** AAD 对象类型:chunk(一批同步事件)或 manifest(设备 manifest)。 */
25
+ export type EncryptedObjectKind = 'chunk' | 'manifest';
26
+ /**
27
+ * AAD 绑定字段:协议版本、vault、space、对象类型与对象 ID 全部入册
28
+ * (spec:认证加密 AAD 绑定协议版本、vault、space、对象标识)。
29
+ */
30
+ export interface CipherAad {
31
+ vaultId: string;
32
+ spaceId: string;
33
+ kind: EncryptedObjectKind;
34
+ objectId: string;
35
+ }
36
+ /** vault 密钥集:本地持有、不上传明文(MUST NOT 上传密钥明文)。 */
37
+ export interface VaultKeys {
38
+ vaultId: string;
39
+ /** 32 字节 vault 主密钥;本地明文保存(与 SQLite 同等信任边界,见文件头注释)。 */
40
+ vaultKey: Uint8Array;
41
+ createdAt: string;
42
+ }
43
+ /** 生成新 vault 密钥集:vaultId 为 UUIDv7(时间可排序),vaultKey 为 32B CSPRNG 随机。 */
44
+ export declare function generateVaultKeys(): VaultKeys;
45
+ /**
46
+ * 派生 space 数据密钥:HKDF-SHA256(vaultKey, salt='cairn-space-key', info=`v1|${spaceId}`)。
47
+ * 确定性:同 vaultKey + 同 spaceId 永远得到同一 spaceKey(跨设备无需协商)。
48
+ */
49
+ export declare function deriveSpaceKey(vaultKey: Uint8Array, spaceId: string): Uint8Array;
50
+ /**
51
+ * 加密一个同步对象。输出 = [versionByte(1)] + [nonce(24)] + [ciphertext+tag]。
52
+ * AAD = UTF8(`v1|${vaultId}|${spaceId}|${kind}|${objectId}`)。
53
+ */
54
+ export declare function encryptObject(plaintext: Uint8Array, spaceKey: Uint8Array, aad: CipherAad): Uint8Array;
55
+ /**
56
+ * 解密一个同步对象。
57
+ * - 版本字节不匹配 → E_VALIDATION 'cipher_version_mismatch';
58
+ * - blob 过短 → E_VALIDATION 'cipher_blob_too_short';
59
+ * - tag 校验失败或 AAD 不匹配 → E_VALIDATION 'auth_tag_invalid'。
60
+ */
61
+ export declare function decryptObject(blob: Uint8Array, spaceKey: Uint8Array, aad: CipherAad): Uint8Array;
62
+ /**
63
+ * 保存 vault 密钥到 `dataDir/keys.json`。
64
+ *
65
+ * - 已存在时拒绝覆盖(E_IO 'keys_already_exist'):防止误覆盖丢密钥;
66
+ * 写入用 flag 'wx'(已存在即失败的原子语义,覆盖并发窗口)。
67
+ * - POSIX:显式 chmod 0600('wx' 新建 + mode 0600 下 umask 只能再去位,结果仍为 0600,chmod 为兜底)。
68
+ * - Windows 局限(诚实边界,构想 §12.2):Node 的 fs.chmodSync 在 Windows 上只能切换
69
+ * 只读位,不对应 POSIX 0600;NTFS ACL 无法用 POSIX 模式表达,因此 Windows 下不做 chmod。
70
+ * keys.json 的 vaultKey 是本地明文,与 SQLite 库文件同等信任边界:文件权限不等于加密,
71
+ * 设备级保护依赖磁盘加密(BitLocker)与账户隔离,而非这里的文件模式。
72
+ */
73
+ export declare function saveKeys(dataDir: string, keys: VaultKeys): void;
74
+ /**
75
+ * 读取 vault 密钥。目录/文件不存在、JSON 损坏、字段缺失或密钥长度不符 → null
76
+ * (调用方按「缺少 vault 密钥」路径处理,如提示导出过的恢复材料)。
77
+ */
78
+ export declare function loadKeys(dataDir: string): VaultKeys | null;
79
+ /**
80
+ * 导出人类可抄写的恢复材料:`CAIRN1.<base64url(canonicalJson)>`,
81
+ * 规范化 JSON 内含 { createdAt, format, vaultId, vaultKey(base64), version }。
82
+ * 这是密钥明文的编码形态——抄写保存,丢失即远端不可恢复(spec:密钥丢失场景)。
83
+ */
84
+ export declare function exportRecoveryMaterial(keys: VaultKeys): string;
85
+ /** 恢复材料的逆操作;前缀/编码/字段完整性任一不合法 → E_VALIDATION 'recovery_material_invalid'。 */
86
+ export declare function importRecoveryMaterial(text: string): VaultKeys;