@carloswon/cairn-memory 0.0.0-stage → 0.2.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 (222) hide show
  1. package/CHANGELOG.md +54 -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 +133 -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/dedup.d.ts +21 -0
  44. package/dist/src/governance/dedup.js +23 -0
  45. package/dist/src/governance/dedup.js.map +1 -0
  46. package/dist/src/governance/index.d.ts +16 -0
  47. package/dist/src/governance/index.js +17 -0
  48. package/dist/src/governance/index.js.map +1 -0
  49. package/dist/src/governance/propose.d.ts +78 -0
  50. package/dist/src/governance/propose.js +150 -0
  51. package/dist/src/governance/propose.js.map +1 -0
  52. package/dist/src/index.d.ts +15 -0
  53. package/dist/src/index.js +24 -0
  54. package/dist/src/index.js.map +1 -0
  55. package/dist/src/interfaces/app-service.d.ts +242 -0
  56. package/dist/src/interfaces/app-service.js +614 -0
  57. package/dist/src/interfaces/app-service.js.map +1 -0
  58. package/dist/src/interfaces/cli/main.d.ts +2 -0
  59. package/dist/src/interfaces/cli/main.js +790 -0
  60. package/dist/src/interfaces/cli/main.js.map +1 -0
  61. package/dist/src/interfaces/console/assets/page.d.ts +18 -0
  62. package/dist/src/interfaces/console/assets/page.js +39 -0
  63. package/dist/src/interfaces/console/assets/page.js.map +1 -0
  64. package/dist/src/interfaces/console/assets/ui-css.d.ts +11 -0
  65. package/dist/src/interfaces/console/assets/ui-css.js +119 -0
  66. package/dist/src/interfaces/console/assets/ui-css.js.map +1 -0
  67. package/dist/src/interfaces/console/assets/ui-js.d.ts +14 -0
  68. package/dist/src/interfaces/console/assets/ui-js.js +1098 -0
  69. package/dist/src/interfaces/console/assets/ui-js.js.map +1 -0
  70. package/dist/src/interfaces/console/assets/url-state.d.ts +9 -0
  71. package/dist/src/interfaces/console/assets/url-state.js +45 -0
  72. package/dist/src/interfaces/console/assets/url-state.js.map +1 -0
  73. package/dist/src/interfaces/console/export.d.ts +46 -0
  74. package/dist/src/interfaces/console/export.js +84 -0
  75. package/dist/src/interfaces/console/export.js.map +1 -0
  76. package/dist/src/interfaces/console/model.d.ts +372 -0
  77. package/dist/src/interfaces/console/model.js +731 -0
  78. package/dist/src/interfaces/console/model.js.map +1 -0
  79. package/dist/src/interfaces/console/review-store.d.ts +142 -0
  80. package/dist/src/interfaces/console/review-store.js +342 -0
  81. package/dist/src/interfaces/console/review-store.js.map +1 -0
  82. package/dist/src/interfaces/console/security.d.ts +76 -0
  83. package/dist/src/interfaces/console/security.js +105 -0
  84. package/dist/src/interfaces/console/security.js.map +1 -0
  85. package/dist/src/interfaces/console/server.d.ts +45 -0
  86. package/dist/src/interfaces/console/server.js +476 -0
  87. package/dist/src/interfaces/console/server.js.map +1 -0
  88. package/dist/src/interfaces/console/suggestions.d.ts +112 -0
  89. package/dist/src/interfaces/console/suggestions.js +511 -0
  90. package/dist/src/interfaces/console/suggestions.js.map +1 -0
  91. package/dist/src/interfaces/console/text.d.ts +4 -0
  92. package/dist/src/interfaces/console/text.js +18 -0
  93. package/dist/src/interfaces/console/text.js.map +1 -0
  94. package/dist/src/interfaces/mcp/server.d.ts +4 -0
  95. package/dist/src/interfaces/mcp/server.js +412 -0
  96. package/dist/src/interfaces/mcp/server.js.map +1 -0
  97. package/dist/src/jobs/index.d.ts +6 -0
  98. package/dist/src/jobs/index.js +7 -0
  99. package/dist/src/jobs/index.js.map +1 -0
  100. package/dist/src/jobs/remote.d.ts +42 -0
  101. package/dist/src/jobs/remote.js +34 -0
  102. package/dist/src/jobs/remote.js.map +1 -0
  103. package/dist/src/jobs/worker.d.ts +67 -0
  104. package/dist/src/jobs/worker.js +169 -0
  105. package/dist/src/jobs/worker.js.map +1 -0
  106. package/dist/src/onboarding/auto.d.ts +88 -0
  107. package/dist/src/onboarding/auto.js +399 -0
  108. package/dist/src/onboarding/auto.js.map +1 -0
  109. package/dist/src/onboarding/batches.d.ts +103 -0
  110. package/dist/src/onboarding/batches.js +219 -0
  111. package/dist/src/onboarding/batches.js.map +1 -0
  112. package/dist/src/onboarding/discover.d.ts +54 -0
  113. package/dist/src/onboarding/discover.js +369 -0
  114. package/dist/src/onboarding/discover.js.map +1 -0
  115. package/dist/src/onboarding/import.d.ts +69 -0
  116. package/dist/src/onboarding/import.js +279 -0
  117. package/dist/src/onboarding/import.js.map +1 -0
  118. package/dist/src/onboarding/index.d.ts +24 -0
  119. package/dist/src/onboarding/index.js +22 -0
  120. package/dist/src/onboarding/index.js.map +1 -0
  121. package/dist/src/onboarding/judgement.d.ts +50 -0
  122. package/dist/src/onboarding/judgement.js +121 -0
  123. package/dist/src/onboarding/judgement.js.map +1 -0
  124. package/dist/src/onboarding/policy.d.ts +86 -0
  125. package/dist/src/onboarding/policy.js +249 -0
  126. package/dist/src/onboarding/policy.js.map +1 -0
  127. package/dist/src/projection/brief.d.ts +77 -0
  128. package/dist/src/projection/brief.js +111 -0
  129. package/dist/src/projection/brief.js.map +1 -0
  130. package/dist/src/projection/index.d.ts +1 -0
  131. package/dist/src/projection/index.js +2 -0
  132. package/dist/src/projection/index.js.map +1 -0
  133. package/dist/src/projection/markdown.d.ts +82 -0
  134. package/dist/src/projection/markdown.js +313 -0
  135. package/dist/src/projection/markdown.js.map +1 -0
  136. package/dist/src/retrieval/export.d.ts +80 -0
  137. package/dist/src/retrieval/export.js +215 -0
  138. package/dist/src/retrieval/export.js.map +1 -0
  139. package/dist/src/retrieval/index.d.ts +5 -0
  140. package/dist/src/retrieval/index.js +6 -0
  141. package/dist/src/retrieval/index.js.map +1 -0
  142. package/dist/src/retrieval/search.d.ts +37 -0
  143. package/dist/src/retrieval/search.js +294 -0
  144. package/dist/src/retrieval/search.js.map +1 -0
  145. package/dist/src/store/archives.d.ts +94 -0
  146. package/dist/src/store/archives.js +135 -0
  147. package/dist/src/store/archives.js.map +1 -0
  148. package/dist/src/store/audit.d.ts +26 -0
  149. package/dist/src/store/audit.js +48 -0
  150. package/dist/src/store/audit.js.map +1 -0
  151. package/dist/src/store/backup.d.ts +36 -0
  152. package/dist/src/store/backup.js +90 -0
  153. package/dist/src/store/backup.js.map +1 -0
  154. package/dist/src/store/blocks.d.ts +64 -0
  155. package/dist/src/store/blocks.js +104 -0
  156. package/dist/src/store/blocks.js.map +1 -0
  157. package/dist/src/store/conflicts.d.ts +52 -0
  158. package/dist/src/store/conflicts.js +112 -0
  159. package/dist/src/store/conflicts.js.map +1 -0
  160. package/dist/src/store/db.d.ts +44 -0
  161. package/dist/src/store/db.js +162 -0
  162. package/dist/src/store/db.js.map +1 -0
  163. package/dist/src/store/device.d.ts +46 -0
  164. package/dist/src/store/device.js +111 -0
  165. package/dist/src/store/device.js.map +1 -0
  166. package/dist/src/store/index.d.ts +14 -0
  167. package/dist/src/store/index.js +15 -0
  168. package/dist/src/store/index.js.map +1 -0
  169. package/dist/src/store/memories.d.ts +101 -0
  170. package/dist/src/store/memories.js +378 -0
  171. package/dist/src/store/memories.js.map +1 -0
  172. package/dist/src/store/migrate.d.ts +32 -0
  173. package/dist/src/store/migrate.js +86 -0
  174. package/dist/src/store/migrate.js.map +1 -0
  175. package/dist/src/store/open.d.ts +53 -0
  176. package/dist/src/store/open.js +177 -0
  177. package/dist/src/store/open.js.map +1 -0
  178. package/dist/src/store/outbox.d.ts +65 -0
  179. package/dist/src/store/outbox.js +137 -0
  180. package/dist/src/store/outbox.js.map +1 -0
  181. package/dist/src/store/plans.d.ts +137 -0
  182. package/dist/src/store/plans.js +243 -0
  183. package/dist/src/store/plans.js.map +1 -0
  184. package/dist/src/store/schema.d.ts +34 -0
  185. package/dist/src/store/schema.js +527 -0
  186. package/dist/src/store/schema.js.map +1 -0
  187. package/dist/src/store/scopes.d.ts +44 -0
  188. package/dist/src/store/scopes.js +220 -0
  189. package/dist/src/store/scopes.js.map +1 -0
  190. package/dist/src/store/write-guard.d.ts +10 -0
  191. package/dist/src/store/write-guard.js +10 -0
  192. package/dist/src/store/write-guard.js.map +1 -0
  193. package/dist/src/sync/apply.d.ts +24 -0
  194. package/dist/src/sync/apply.js +130 -0
  195. package/dist/src/sync/apply.js.map +1 -0
  196. package/dist/src/sync/cryptoutil.d.ts +86 -0
  197. package/dist/src/sync/cryptoutil.js +339 -0
  198. package/dist/src/sync/cryptoutil.js.map +1 -0
  199. package/dist/src/sync/events.d.ts +69 -0
  200. package/dist/src/sync/events.js +78 -0
  201. package/dist/src/sync/events.js.map +1 -0
  202. package/dist/src/sync/obs-store.d.ts +41 -0
  203. package/dist/src/sync/obs-store.js +325 -0
  204. package/dist/src/sync/obs-store.js.map +1 -0
  205. package/dist/src/sync/orchestrate.d.ts +37 -0
  206. package/dist/src/sync/orchestrate.js +84 -0
  207. package/dist/src/sync/orchestrate.js.map +1 -0
  208. package/dist/src/sync/pull.d.ts +24 -0
  209. package/dist/src/sync/pull.js +150 -0
  210. package/dist/src/sync/pull.js.map +1 -0
  211. package/dist/src/sync/push.d.ts +19 -0
  212. package/dist/src/sync/push.js +227 -0
  213. package/dist/src/sync/push.js.map +1 -0
  214. package/dist/src/sync/syncd-store.d.ts +31 -0
  215. package/dist/src/sync/syncd-store.js +92 -0
  216. package/dist/src/sync/syncd-store.js.map +1 -0
  217. package/dist/src/sync/vault.d.ts +37 -0
  218. package/dist/src/sync/vault.js +53 -0
  219. package/dist/src/sync/vault.js.map +1 -0
  220. package/docs/cairn-security.md +254 -0
  221. package/docs/cairn-usage.md +821 -0
  222. package/package.json +71 -4
@@ -0,0 +1,378 @@
1
+ import { MEMORY_KINDS, MEMORY_STATUSES, AUTHORITIES, } from '../core/types.js';
2
+ import { err } from '../core/errors.js';
3
+ import { uuidv7 } from '../core/ids.js';
4
+ import { nowIso } from '../core/time.js';
5
+ import { normalizeContent, contentHash as contentHashOf, sha256Hex } from '../core/hash.js';
6
+ import { WriteGuardMixin } from './write-guard.js';
7
+ export class MemoryRepository extends WriteGuardMixin {
8
+ db;
9
+ constructor(db) {
10
+ super();
11
+ this.db = db;
12
+ }
13
+ add(input, deviceId) {
14
+ this.checkWritable();
15
+ validateMemoryInput(input);
16
+ const id = uuidv7();
17
+ const at = nowIso();
18
+ const normalized = normalizeContent(input.content);
19
+ const hash = contentHashOf(input.content);
20
+ const confidence = input.confidence ?? defaultConfidence(input.authority);
21
+ const sensitivity = input.sensitivity ?? 'normal';
22
+ this.db.transaction(() => {
23
+ this.db.run(`INSERT INTO memory (id, owner_id, kind, content, normalized_content, scope_id, status, authority,
24
+ confidence, source_agent, source_session_id, source_import_batch_id, source_message_range,
25
+ observed_at, valid_from, valid_to, expires_at, sensitivity, content_hash, created_by, created_at, updated_at)
26
+ VALUES (?, 'local-user', ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?)`, id, input.kind, input.content, normalized, input.scopeId, initialStatus(input.authority), input.authority, confidence, input.sourceAgent ?? null, input.sourceSessionId ?? null, input.sourceImportBatchId ?? null, input.sourceMessageRange ?? null, input.observedAt ?? at, input.validFrom ?? null, input.validTo ?? null, input.expiresAt ?? null, sensitivity, hash, input.createdBy, at, at);
27
+ const revId = uuidv7();
28
+ this.db.run(`INSERT INTO memory_revision (id, memory_id, seq, parent_revision_ids, content, content_hash, scope_id,
29
+ status, authority, author, device_id, reason, created_at)
30
+ VALUES (?, ?, 1, '[]', ?, ?, ?, ?, ?, ?, ?, ?, ?)`, revId, id, input.content, hash, input.scopeId, initialStatus(input.authority), input.authority, input.createdBy, deviceId, null, at);
31
+ this.db.run('UPDATE memory SET current_revision_id = ? WHERE id = ?', revId, id);
32
+ this.insertEvidence(id, revId, input.evidence ?? []);
33
+ });
34
+ return this.require(id);
35
+ }
36
+ get(id) {
37
+ const row = this.db.get('SELECT * FROM memory WHERE id = ?', id);
38
+ return row ? mapMemory(row) : null;
39
+ }
40
+ require(id) {
41
+ const m = this.get(id);
42
+ if (!m)
43
+ throw err('E_NOT_FOUND', `记忆不存在: ${id}`);
44
+ return m;
45
+ }
46
+ /**
47
+ * 用户更正(任务 2.1):新修订 + supersedes 历史;expected 不匹配时
48
+ * 抛 E_TARGET_CHANGED(目标在批准后变化则拒绝过期计划,spec memory-governance)。
49
+ */
50
+ revise(id, newContent, opts, deviceId) {
51
+ this.checkWritable();
52
+ const mem = this.require(id);
53
+ if (mem.status === 'tombstoned')
54
+ throw err('E_CONFLICT_STATE', '已遗忘的记忆不能修改');
55
+ const at = nowIso();
56
+ const hash = contentHashOf(newContent);
57
+ return this.db.transaction(() => {
58
+ const cur = this.db.get('SELECT current_revision_id FROM memory WHERE id = ?', id);
59
+ const currentRevId = cur.current_revision_id;
60
+ if (opts.expectedCurrentRevisionId && currentRevId !== opts.expectedCurrentRevisionId) {
61
+ throw err('E_TARGET_CHANGED', '记忆在计划批准后产生了新修订,拒绝基于过期目标应用', {
62
+ memoryId: id,
63
+ expected: opts.expectedCurrentRevisionId,
64
+ actual: currentRevId,
65
+ });
66
+ }
67
+ const seqRow = this.db.get('SELECT MAX(seq) AS s FROM memory_revision WHERE memory_id = ?', id);
68
+ const seq = Number(seqRow?.s ?? 0) + 1;
69
+ const revId = uuidv7();
70
+ const newStatus = mem.status === 'conflicted' ? 'conflicted' : 'active';
71
+ this.db.run(`INSERT INTO memory_revision (id, memory_id, seq, parent_revision_ids, content, content_hash, scope_id,
72
+ status, authority, author, device_id, reason, created_at)
73
+ VALUES (?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?)`, revId, id, seq, JSON.stringify(currentRevId ? [currentRevId] : []), newContent, hash, mem.scopeId, newStatus, mem.authority, opts.author, deviceId, opts.reason ?? null, at);
74
+ this.db.run(`UPDATE memory SET current_revision_id = ?, content = ?, normalized_content = ?, content_hash = ?,
75
+ status = ?, expires_at = IFNULL(?, expires_at), sensitivity = IFNULL(?, sensitivity), updated_at = ? WHERE id = ?`, revId, newContent, normalizeContent(newContent), hash, newStatus, opts.expiresAt ?? null, opts.sensitivity ?? null, at, id);
76
+ return { memory: this.require(id), revision: this.requireRevision(revId) };
77
+ });
78
+ }
79
+ /** 候选晋升(真实审批后由治理层调用;agent_inferred/imported 不能静默变 active)。 */
80
+ promoteToActive(id, authority, by) {
81
+ this.checkWritable();
82
+ const mem = this.require(id);
83
+ if (mem.status !== 'candidate')
84
+ throw err('E_CONFLICT_STATE', `只有候选可晋升,当前 ${mem.status}`);
85
+ if (authority === 'agent_inferred' || authority === 'imported_unverified') {
86
+ throw err('E_FORBIDDEN', '不允许把候选晋升回推断/未验证权威');
87
+ }
88
+ this.db.run("UPDATE memory SET status = 'active', authority = ?, updated_at = ? WHERE id = ?", authority, nowIso(), id);
89
+ this.db.run('UPDATE memory_revision SET status = ?, authority = ? WHERE id = ?', 'active', authority, mem.currentRevisionId ?? '');
90
+ return this.require(id);
91
+ }
92
+ archive(id) {
93
+ this.require(id);
94
+ this.db.run("UPDATE memory SET status = 'archived', updated_at = ? WHERE id = ?", nowIso(), id);
95
+ return this.require(id);
96
+ }
97
+ /** 遗忘(任务 2.1/2.5):tombstone 可审计,被遗忘内容退出活动结果与投影。 */
98
+ forget(id, reason, by) {
99
+ this.checkWritable();
100
+ const mem = this.require(id);
101
+ if (mem.status === 'tombstoned')
102
+ return mem;
103
+ const at = nowIso();
104
+ this.db.transaction(() => {
105
+ this.db.run(`INSERT INTO tombstone (id, memory_id, reason, forgotten_by, forgotten_at, content_hash) VALUES (?, ?, ?, ?, ?, ?)`, uuidv7(), id, reason, by, at, mem.contentHash);
106
+ this.db.run("UPDATE memory SET status = 'tombstoned', updated_at = ? WHERE id = ?", at, id);
107
+ });
108
+ return this.require(id);
109
+ }
110
+ getTombstone(memoryId) {
111
+ const row = this.db.get('SELECT * FROM tombstone WHERE memory_id = ? ORDER BY forgotten_at DESC LIMIT 1', memoryId);
112
+ if (!row)
113
+ return null;
114
+ return {
115
+ id: row.id,
116
+ reason: row.reason ?? null,
117
+ forgottenBy: row.forgotten_by,
118
+ forgottenAt: row.forgotten_at,
119
+ contentHash: row.content_hash,
120
+ };
121
+ }
122
+ resolveCurrent(id) {
123
+ const mem = this.get(id);
124
+ if (!mem || !mem.currentRevisionId)
125
+ return null;
126
+ return { memory: mem, revision: this.requireRevision(mem.currentRevisionId) };
127
+ }
128
+ revisions(id) {
129
+ return this.db
130
+ .all('SELECT * FROM memory_revision WHERE memory_id = ? ORDER BY seq', id)
131
+ .map(mapRevision);
132
+ }
133
+ requireRevision(revId) {
134
+ const row = this.db.get('SELECT * FROM memory_revision WHERE id = ?', revId);
135
+ if (!row)
136
+ throw err('E_NOT_FOUND', `修订不存在: ${revId}`);
137
+ return mapRevision(row);
138
+ }
139
+ evidence(memoryId) {
140
+ return this.db.all('SELECT * FROM evidence WHERE memory_id = ? ORDER BY created_at, id', memoryId).map(mapEvidence);
141
+ }
142
+ /** 记忆间关系:supersedes / contradicts / related_to(首版仅三种)。 */
143
+ addRelation(fromMemoryId, toMemoryId, type) {
144
+ if (fromMemoryId === toMemoryId)
145
+ throw err('E_VALIDATION', '关系两端不能是同一记忆');
146
+ this.require(fromMemoryId);
147
+ this.require(toMemoryId);
148
+ const existing = this.db.get('SELECT id FROM relation WHERE from_memory_id = ? AND to_memory_id = ? AND relation_type = ?', fromMemoryId, toMemoryId, type);
149
+ if (existing)
150
+ return existing.id;
151
+ const id = uuidv7();
152
+ this.db.run('INSERT INTO relation (id, from_memory_id, to_memory_id, relation_type, created_at) VALUES (?, ?, ?, ?, ?)', id, fromMemoryId, toMemoryId, type, nowIso());
153
+ return id;
154
+ }
155
+ relationsOf(memoryId) {
156
+ return this.db
157
+ .all('SELECT * FROM relation WHERE from_memory_id = ? OR to_memory_id = ?', memoryId, memoryId)
158
+ .map((r) => ({
159
+ id: r.id,
160
+ fromMemoryId: r.from_memory_id,
161
+ toMemoryId: r.to_memory_id,
162
+ relationType: r.relation_type,
163
+ }));
164
+ }
165
+ addEvidence(memoryId, revisionId, input) {
166
+ const id = uuidv7();
167
+ this.db.run(`INSERT INTO evidence (id, memory_id, revision_id, evidence_kind, source_agent, session_id, import_archive_id,
168
+ locator, excerpt_hash, trust_level, created_at)
169
+ VALUES (?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?)`, id, memoryId, revisionId, input.evidenceKind, input.sourceAgent ?? null, input.sessionId ?? null, input.importArchiveId ?? null, input.locator ?? null, input.excerptHash ?? null, input.trustLevel, nowIso());
170
+ const row = this.db.get('SELECT * FROM evidence WHERE id = ?', id);
171
+ return mapEvidence(row);
172
+ }
173
+ list(filter = {}) {
174
+ const where = [];
175
+ const params = [];
176
+ if (filter.scopeId) {
177
+ where.push('scope_id = ?');
178
+ params.push(filter.scopeId);
179
+ }
180
+ if (filter.status) {
181
+ where.push('status = ?');
182
+ params.push(filter.status);
183
+ }
184
+ else if (filter.statuses) {
185
+ where.push(`status IN (${filter.statuses.map(() => '?').join(',')})`);
186
+ params.push(...filter.statuses);
187
+ }
188
+ if (filter.kind) {
189
+ where.push('kind = ?');
190
+ params.push(filter.kind);
191
+ }
192
+ if (filter.authority) {
193
+ where.push('authority = ?');
194
+ params.push(filter.authority);
195
+ }
196
+ if (filter.sourceImportBatchId) {
197
+ where.push('source_import_batch_id = ?');
198
+ params.push(filter.sourceImportBatchId);
199
+ }
200
+ const sql = `SELECT * FROM memory ${where.length ? 'WHERE ' + where.join(' AND ') : ''} ORDER BY updated_at DESC, id LIMIT ? OFFSET ?`;
201
+ params.push(filter.limit ?? 200, filter.offset ?? 0);
202
+ return this.db.all(sql, ...params).map(mapMemory);
203
+ }
204
+ /** 内容去重查找(同 scope 同规范化哈希)。 */
205
+ findByContentHash(scopeId, hash) {
206
+ const row = this.db.get("SELECT * FROM memory WHERE scope_id = ? AND content_hash = ? AND status NOT IN ('tombstoned','superseded') ORDER BY updated_at DESC LIMIT 1", scopeId, hash);
207
+ return row ? mapMemory(row) : null;
208
+ }
209
+ /** 跨设备记忆身份对齐:任一修订内容哈希命中即视为同一记忆(本地 id 不可跨设备引用)。 */
210
+ findMemoryIdByRevisionHashes(hashes) {
211
+ if (hashes.length === 0)
212
+ return null;
213
+ const placeholders = hashes.map(() => '?').join(',');
214
+ const row = this.db.get(`SELECT memory_id FROM memory_revision WHERE content_hash IN (${placeholders}) LIMIT 1`, ...hashes);
215
+ return row ? row.memory_id : null;
216
+ }
217
+ /** 修订级内容哈希查找(同步对账用:远端事件的 parent_hash 对齐到本地修订)。 */
218
+ findRevisionByContentHash(memoryId, hash) {
219
+ const row = this.db.get('SELECT * FROM memory_revision WHERE memory_id = ? AND content_hash = ? ORDER BY seq DESC LIMIT 1', memoryId, hash);
220
+ return row ? mapRevision(row) : null;
221
+ }
222
+ /**
223
+ * 应用远端修订(同步拉取专用):插入为该记忆的下一条本地修订,
224
+ * 不推进 current_revision_id——推进与否由冲突/快进判定决定
225
+ * (sync 层随后显式 revise 或记录冲突)。
226
+ */
227
+ insertRemoteRevision(memoryId, input, deviceId) {
228
+ this.checkWritable();
229
+ const mem = this.require(memoryId);
230
+ const at = nowIso();
231
+ const seqRow = this.db.get('SELECT MAX(seq) AS s FROM memory_revision WHERE memory_id = ?', memoryId);
232
+ const seq = Number(seqRow?.s ?? 0) + 1;
233
+ const revId = uuidv7();
234
+ this.db.run(`INSERT INTO memory_revision (id, memory_id, seq, parent_revision_ids, content, content_hash, scope_id,
235
+ status, authority, author, device_id, reason, created_at)
236
+ VALUES (?, ?, ?, ?, ?, ?, ?, 'active', ?, ?, ?, ?, ?)`, revId, memoryId, seq, JSON.stringify(input.parentLocalRevisionId ? [input.parentLocalRevisionId] : []), input.content, input.contentHash, mem.scopeId, mem.authority, input.author, deviceId, input.reason, at);
237
+ void input.baseRevisionId;
238
+ return this.requireRevision(revId);
239
+ }
240
+ countsByStatus() {
241
+ const out = Object.fromEntries(MEMORY_STATUSES.map((s) => [s, 0]));
242
+ for (const r of this.db.all('SELECT status, COUNT(*) AS n FROM memory GROUP BY status')) {
243
+ out[r.status] = Number(r.n);
244
+ }
245
+ return out;
246
+ }
247
+ markUsed(id, at = nowIso()) {
248
+ this.db.run('UPDATE memory SET last_used_at = ? WHERE id = ?', at, id);
249
+ }
250
+ touchVerified(id, at = nowIso()) {
251
+ this.db.run('UPDATE memory SET last_verified_at = ?, updated_at = ? WHERE id = ?', at, at, id);
252
+ }
253
+ insertEvidence(memoryId, revisionId, list) {
254
+ for (const ev of list) {
255
+ this.addEvidence(memoryId, revisionId, ev);
256
+ }
257
+ }
258
+ }
259
+ /** authority → 初始状态:显式/确认即 active;推断/导入保持候选(spec memory-governance)。 */
260
+ export function initialStatus(authority) {
261
+ switch (authority) {
262
+ case 'user_explicit':
263
+ case 'user_confirmed':
264
+ return 'active';
265
+ case 'agent_inferred':
266
+ case 'imported_unverified':
267
+ return 'candidate';
268
+ default: {
269
+ const exhaustive = authority;
270
+ throw err('E_VALIDATION', `未知权威级别 ${String(exhaustive)}`);
271
+ }
272
+ }
273
+ }
274
+ function defaultConfidence(authority) {
275
+ switch (authority) {
276
+ case 'user_explicit':
277
+ return 1;
278
+ case 'user_confirmed':
279
+ return 0.9;
280
+ case 'agent_inferred':
281
+ return 0.5;
282
+ case 'imported_unverified':
283
+ return 0.3;
284
+ }
285
+ }
286
+ export function validateMemoryInput(input) {
287
+ const problems = [];
288
+ if (!MEMORY_KINDS.includes(input.kind))
289
+ problems.push(`kind 非法: ${input.kind}`);
290
+ if (!AUTHORITIES.includes(input.authority))
291
+ problems.push(`authority 非法: ${input.authority}`);
292
+ if (typeof input.content !== 'string' || input.content.trim().length === 0)
293
+ problems.push('content 不能为空');
294
+ if (input.content.length > 1_000_000)
295
+ problems.push('content 超过 1MB 上限');
296
+ if (input.kind === 'instruction' && input.authority !== 'user_explicit' && input.authority !== 'user_confirmed') {
297
+ problems.push('instruction 只能来自 user_explicit / user_confirmed');
298
+ }
299
+ if (input.confidence != null && (input.confidence < 0 || input.confidence > 1))
300
+ problems.push('confidence 必须在 [0,1]');
301
+ if (problems.length > 0)
302
+ throw err('E_VALIDATION', `记忆写入校验失败: ${problems.join('; ')}`, { problems });
303
+ }
304
+ export function mapMemory(r) {
305
+ return {
306
+ id: r.id,
307
+ ownerId: r.owner_id,
308
+ kind: r.kind,
309
+ content: r.content,
310
+ normalizedContent: r.normalized_content,
311
+ scopeId: r.scope_id,
312
+ status: r.status,
313
+ authority: r.authority,
314
+ confidence: Number(r.confidence),
315
+ sourceAgent: r.source_agent ?? null,
316
+ sourceSessionId: r.source_session_id ?? null,
317
+ sourceImportBatchId: r.source_import_batch_id ?? null,
318
+ sourceMessageRange: r.source_message_range ?? null,
319
+ observedAt: r.observed_at,
320
+ validFrom: r.valid_from ?? null,
321
+ validTo: r.valid_to ?? null,
322
+ lastVerifiedAt: r.last_verified_at ?? null,
323
+ lastUsedAt: r.last_used_at ?? null,
324
+ expiresAt: r.expires_at ?? null,
325
+ sensitivity: r.sensitivity,
326
+ currentRevisionId: r.current_revision_id ?? null,
327
+ contentHash: r.content_hash,
328
+ createdBy: r.created_by,
329
+ createdAt: r.created_at,
330
+ updatedAt: r.updated_at,
331
+ };
332
+ }
333
+ export function mapRevision(r) {
334
+ let parents = [];
335
+ try {
336
+ const v = JSON.parse(r.parent_revision_ids ?? '[]');
337
+ if (Array.isArray(v))
338
+ parents = v.map(String);
339
+ }
340
+ catch {
341
+ parents = [];
342
+ }
343
+ return {
344
+ id: r.id,
345
+ memoryId: r.memory_id,
346
+ seq: Number(r.seq),
347
+ parentRevisionIds: parents,
348
+ content: r.content,
349
+ contentHash: r.content_hash,
350
+ scopeId: r.scope_id,
351
+ status: r.status,
352
+ authority: r.authority,
353
+ author: r.author,
354
+ deviceId: r.device_id,
355
+ reason: r.reason ?? null,
356
+ createdAt: r.created_at,
357
+ };
358
+ }
359
+ export function mapEvidence(r) {
360
+ return {
361
+ id: r.id,
362
+ memoryId: r.memory_id,
363
+ revisionId: r.revision_id ?? null,
364
+ evidenceKind: r.evidence_kind,
365
+ sourceAgent: r.source_agent ?? null,
366
+ sessionId: r.session_id ?? null,
367
+ importArchiveId: r.import_archive_id ?? null,
368
+ locator: r.locator ?? null,
369
+ excerptHash: r.excerpt_hash ?? null,
370
+ trustLevel: r.trust_level,
371
+ createdAt: r.created_at,
372
+ };
373
+ }
374
+ /** 证据摘录只存哈希,不存原文(构想 §8.3)。 */
375
+ export function evidenceExcerptHash(excerpt) {
376
+ return sha256Hex(excerpt);
377
+ }
378
+ //# sourceMappingURL=memories.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"memories.js","sourceRoot":"","sources":["../../../src/store/memories.ts"],"names":[],"mappings":"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"}
@@ -0,0 +1,32 @@
1
+ import { CairnDb } from './db.js';
2
+ export interface Migration {
3
+ version: number;
4
+ name: string;
5
+ sql: string;
6
+ /**
7
+ * 在 `BEGIN` **之前**执行的 pragma 语句。
8
+ *
9
+ * 存在的唯一原因:SQLite 的 `PRAGMA foreign_keys` 在事务内是 **no-op**。
10
+ * 重建被外键引用的表时必须先关掉外键,否则 `DROP TABLE` 会级联删光子表数据
11
+ * (实测:子表 1 行变 0 行,而 `PRAGMA foreign_key_check` 仍报干净——静默丢数据)。
12
+ */
13
+ preTransactionPragma?: string[];
14
+ /** 在 `COMMIT` **之后**执行的 pragma 语句(用于把 pre 的改动恢复回去)。 */
15
+ postTransactionPragma?: string[];
16
+ }
17
+ /** 按版本排列;version 写入 PRAGMA user_version。 */
18
+ export declare const MIGRATIONS: readonly Migration[];
19
+ export interface MigrationResult {
20
+ applied: number[];
21
+ currentVersion: number;
22
+ }
23
+ declare function currentVersion(db: CairnDb): number;
24
+ /**
25
+ * 版本化迁移(任务 1.2):每个迁移独立事务,失败回滚,
26
+ * 数据库停留在旧版本且可再次执行;绝不留下半迁移库。
27
+ * 并发安全:BEGIN IMMEDIATE 取到写锁【之后】重读版本号,
28
+ * 多进程同时打开同一新库时只有一方真正建表,另一方幂等跳过。
29
+ * schema 版本高于已知实现时拒绝打开(防旧代码写新库)。
30
+ */
31
+ export declare function runMigrations(db: CairnDb, migrations?: readonly Migration[]): MigrationResult;
32
+ export { currentVersion as schemaVersion };
@@ -0,0 +1,86 @@
1
+ import { MIGRATION_001_CORE, MIGRATION_002_SEARCH, MIGRATION_003_DEDUP, MIGRATION_004_KIND_LESSON } from './schema.js';
2
+ import { err } from '../core/errors.js';
3
+ /** 按版本排列;version 写入 PRAGMA user_version。 */
4
+ export const MIGRATIONS = [
5
+ { version: 1, name: 'core_v1', sql: MIGRATION_001_CORE },
6
+ { version: 2, name: 'search_v1', sql: MIGRATION_002_SEARCH },
7
+ { version: 3, name: 'dedup_v1', sql: MIGRATION_003_DEDUP },
8
+ {
9
+ version: 4,
10
+ name: 'kind_lesson',
11
+ sql: MIGRATION_004_KIND_LESSON,
12
+ // 重建被 8 个表外键引用的 memory 表:外键必须在 BEGIN 之前关掉
13
+ // (事务内设置 foreign_keys 是 no-op),否则 DROP 会级联删光子表数据。
14
+ preTransactionPragma: ['PRAGMA foreign_keys = OFF'],
15
+ postTransactionPragma: ['PRAGMA foreign_keys = ON'],
16
+ },
17
+ ];
18
+ function currentVersion(db) {
19
+ const row = db.get('PRAGMA user_version');
20
+ return row ? Number(Object.values(row)[0]) : 0;
21
+ }
22
+ function setVersion(db, v) {
23
+ db.exec(`PRAGMA user_version = ${v}`);
24
+ }
25
+ /**
26
+ * 版本化迁移(任务 1.2):每个迁移独立事务,失败回滚,
27
+ * 数据库停留在旧版本且可再次执行;绝不留下半迁移库。
28
+ * 并发安全:BEGIN IMMEDIATE 取到写锁【之后】重读版本号,
29
+ * 多进程同时打开同一新库时只有一方真正建表,另一方幂等跳过。
30
+ * schema 版本高于已知实现时拒绝打开(防旧代码写新库)。
31
+ */
32
+ export function runMigrations(db, migrations = MIGRATIONS) {
33
+ const applied = [];
34
+ let v = currentVersion(db);
35
+ const latest = migrations.length > 0 ? migrations[migrations.length - 1].version : 0;
36
+ if (v > latest) {
37
+ throw err('E_MIGRATION_FAILED', `数据库 schema 版本 ${v} 高于当前实现支持的 ${latest};请升级 Cairn 后再打开该数据目录`, { dbVersion: v, supportedVersion: latest });
38
+ }
39
+ for (const m of migrations) {
40
+ if (m.version <= v)
41
+ continue;
42
+ try {
43
+ let appliedThis = false;
44
+ // 事务外的前置 pragma:foreign_keys 必须在 BEGIN 之前设置才生效。
45
+ for (const pragma of m.preTransactionPragma ?? [])
46
+ db.exec(pragma);
47
+ db.transaction(() => {
48
+ // 持写锁后重读:并发进程可能已在本事务排队期间完成该迁移
49
+ const current = currentVersion(db);
50
+ if (m.version <= current)
51
+ return;
52
+ db.exec(m.sql);
53
+ setVersion(db, m.version);
54
+ appliedThis = true;
55
+ });
56
+ // 事务外的后置 pragma:把 pre 阶段改掉的设置恢复。**成功失败都要跑**,
57
+ // 否则一次迁移失败会让连接停在外键关闭状态,后续写入失去约束。
58
+ for (const pragma of m.postTransactionPragma ?? [])
59
+ db.exec(pragma);
60
+ if (appliedThis) {
61
+ applied.push(m.version);
62
+ v = m.version;
63
+ }
64
+ else {
65
+ v = Math.max(v, m.version);
66
+ }
67
+ }
68
+ catch (e) {
69
+ // 失败路径同样恢复 pragma,再做错误包装。
70
+ try {
71
+ for (const pragma of m.postTransactionPragma ?? [])
72
+ db.exec(pragma);
73
+ }
74
+ catch {
75
+ // 恢复失败不掩盖原始错误:原始错误更能说明问题。
76
+ }
77
+ throw err('E_MIGRATION_FAILED', `迁移 ${m.version} (${m.name}) 失败: ${e.message}`, {
78
+ version: m.version,
79
+ name: m.name,
80
+ });
81
+ }
82
+ }
83
+ return { applied, currentVersion: v };
84
+ }
85
+ export { currentVersion as schemaVersion };
86
+ //# sourceMappingURL=migrate.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"migrate.js","sourceRoot":"","sources":["../../../src/store/migrate.ts"],"names":[],"mappings":"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"}
@@ -0,0 +1,53 @@
1
+ import { CairnDb } from './db.js';
2
+ import { schemaVersion } from './migrate.js';
3
+ import { ScopeRepository } from './scopes.js';
4
+ import { MemoryRepository } from './memories.js';
5
+ import { ImportArchiveRepository } from './archives.js';
6
+ import { PlanRepository } from './plans.js';
7
+ import { OutboxRepository } from './outbox.js';
8
+ import { ManagedBlockRepository, DeviceInstallationRepository } from './blocks.js';
9
+ import { ConflictRepository } from './conflicts.js';
10
+ import { AuditLog } from './audit.js';
11
+ import { CloneCheckResult, DeviceIdentityFile, reEnrollDevice } from './device.js';
12
+ /** Cairn 数据目录布局:~/.cairn(CAIRN_HOME 可重定向;测试一律用合成目录)。 */
13
+ export interface CairnPaths {
14
+ home: string;
15
+ dbPath: string;
16
+ dataDir: string;
17
+ snapshotsDir: string;
18
+ backupsDir: string;
19
+ }
20
+ export declare function defaultHome(): string;
21
+ export declare function resolvePaths(home: string): CairnPaths;
22
+ export declare function ensureDirs(paths: CairnPaths): void;
23
+ export interface CairnStore {
24
+ paths: CairnPaths;
25
+ db: CairnDb;
26
+ identity: DeviceIdentityFile;
27
+ cloneCheck: CloneCheckResult;
28
+ scopes: ScopeRepository;
29
+ memories: MemoryRepository;
30
+ archives: ImportArchiveRepository;
31
+ plans: PlanRepository;
32
+ outbox: OutboxRepository;
33
+ blocks: ManagedBlockRepository;
34
+ installations: DeviceInstallationRepository;
35
+ conflicts: ConflictRepository;
36
+ audit: AuditLog;
37
+ /** 写操作前置守卫:克隆/暂停状态抛 E_DEVICE_CLONED / E_DEVICE_SUSPENDED。 */
38
+ assertWritable(): void;
39
+ reEnroll(): ReturnType<typeof reEnrollDevice>;
40
+ close(): void;
41
+ }
42
+ export interface OpenStoreOptions {
43
+ home?: string;
44
+ readOnly?: boolean;
45
+ /** 跳过迁移(仅特殊诊断用途)。 */
46
+ skipMigrations?: boolean;
47
+ }
48
+ /**
49
+ * 打开本地权威库:目录准备 → 迁移 → 设备身份与克隆检测 → 仓储装配。
50
+ * 迁移失败绝不进入正常读写(design Migration Plan)。
51
+ */
52
+ export declare function openStore(opts?: OpenStoreOptions): CairnStore;
53
+ export { schemaVersion };