@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,527 @@
1
+ /**
2
+ * Cairn v1 Schema(design D3)。
3
+ * 边界划分基于 M0 存储批证据(artifacts/m0/delegated/work/storage-schema),
4
+ * 按本变更规格补充 project/agent、conflict、tombstone、import_item、
5
+ * plan_operation、device_installation、audit_event 与通用 outbox_job。
6
+ * 约定:时间一律 ISO-8601 UTC 字符串;hash 一律小写 hex sha256;布尔用 0/1。
7
+ */
8
+ export const MIGRATION_001_CORE = /* sql */ `
9
+ CREATE TABLE meta (
10
+ key TEXT PRIMARY KEY,
11
+ value TEXT NOT NULL
12
+ );
13
+
14
+ CREATE TABLE project (
15
+ id TEXT PRIMARY KEY,
16
+ name TEXT NOT NULL,
17
+ aliases TEXT NOT NULL DEFAULT '[]',
18
+ created_at TEXT NOT NULL
19
+ );
20
+
21
+ CREATE TABLE agent (
22
+ id TEXT PRIMARY KEY,
23
+ label TEXT,
24
+ kind TEXT NOT NULL DEFAULT 'generic',
25
+ created_at TEXT NOT NULL
26
+ );
27
+
28
+ CREATE TABLE device (
29
+ id TEXT PRIMARY KEY,
30
+ label TEXT,
31
+ instance_nonce TEXT NOT NULL,
32
+ enrollment TEXT NOT NULL CHECK (enrollment IN ('pending','active','suspended','revoked')),
33
+ enrolled_at TEXT NOT NULL,
34
+ suspended_reason TEXT
35
+ );
36
+
37
+ CREATE TABLE space (
38
+ id TEXT PRIMARY KEY,
39
+ name TEXT NOT NULL,
40
+ space_kind TEXT NOT NULL CHECK (space_kind IN ('personal','project','custom')),
41
+ project_id TEXT REFERENCES project(id),
42
+ created_at TEXT NOT NULL,
43
+ CHECK (space_kind <> 'project' OR project_id IS NOT NULL)
44
+ );
45
+
46
+ -- 作用域是物理边界,不是 UI 过滤(构想 §7.5)
47
+ CREATE TABLE scope (
48
+ id TEXT PRIMARY KEY,
49
+ space_id TEXT NOT NULL REFERENCES space(id) ON DELETE RESTRICT,
50
+ preset TEXT NOT NULL CHECK (preset IN (
51
+ 'personal-global','device-local','project-global','project-device',
52
+ 'agent-private','session-ephemeral','custom')),
53
+ scope_kind TEXT NOT NULL CHECK (scope_kind IN ('personal','project','agent','device','custom')),
54
+ project_id TEXT REFERENCES project(id),
55
+ device_id TEXT NOT NULL DEFAULT 'all',
56
+ agent_id TEXT NOT NULL DEFAULT 'all',
57
+ read_allowlist TEXT NOT NULL DEFAULT '[]',
58
+ sync_policy TEXT NOT NULL CHECK (sync_policy IN ('local_only','encrypted')),
59
+ read_policy TEXT NOT NULL CHECK (read_policy IN ('all_agents','allowlist')),
60
+ retention_policy TEXT NOT NULL CHECK (retention_policy IN ('permanent','ttl','lru','session')),
61
+ projection_policy TEXT NOT NULL CHECK (projection_policy IN ('none','allowlist')),
62
+ sensitivity TEXT NOT NULL DEFAULT 'normal' CHECK (sensitivity IN ('normal','sensitive')),
63
+ ttl_days INTEGER,
64
+ builtin INTEGER NOT NULL DEFAULT 0 CHECK (builtin IN (0,1)),
65
+ created_at TEXT NOT NULL,
66
+ CHECK (scope_kind <> 'project' OR project_id IS NOT NULL),
67
+ CHECK (scope_kind <> 'device' OR sync_policy = 'local_only'),
68
+ CHECK (sync_policy <> 'encrypted' OR device_id = 'all'),
69
+ CHECK (retention_policy <> 'ttl' OR ttl_days IS NOT NULL),
70
+ CHECK (sensitivity <> 'sensitive' OR sync_policy = 'local_only')
71
+ );
72
+
73
+ CREATE TABLE memory (
74
+ id TEXT PRIMARY KEY,
75
+ owner_id TEXT NOT NULL,
76
+ kind TEXT NOT NULL CHECK (kind IN
77
+ ('instruction','preference','fact','decision','episode','procedure','environment')),
78
+ content TEXT NOT NULL,
79
+ normalized_content TEXT NOT NULL,
80
+ scope_id TEXT NOT NULL REFERENCES scope(id) ON DELETE RESTRICT,
81
+ status TEXT NOT NULL CHECK (status IN
82
+ ('candidate','active','conflicted','superseded','archived','tombstoned')),
83
+ authority TEXT NOT NULL CHECK (authority IN
84
+ ('user_explicit','user_confirmed','agent_inferred','imported_unverified')),
85
+ confidence REAL NOT NULL DEFAULT 0 CHECK (confidence >= 0 AND confidence <= 1),
86
+ source_agent TEXT,
87
+ source_session_id TEXT,
88
+ source_import_batch_id TEXT,
89
+ source_message_range TEXT,
90
+ observed_at TEXT NOT NULL,
91
+ valid_from TEXT,
92
+ valid_to TEXT,
93
+ last_verified_at TEXT,
94
+ last_used_at TEXT,
95
+ expires_at TEXT,
96
+ sensitivity TEXT NOT NULL DEFAULT 'normal' CHECK (sensitivity IN ('normal','sensitive','blocked')),
97
+ current_revision_id TEXT REFERENCES memory_revision(id) DEFERRABLE INITIALLY DEFERRED,
98
+ content_hash TEXT NOT NULL,
99
+ created_by TEXT NOT NULL,
100
+ created_at TEXT NOT NULL,
101
+ updated_at TEXT NOT NULL,
102
+ CHECK (valid_to IS NULL OR valid_from IS NULL OR valid_to >= valid_from),
103
+ -- instruction 只能来自用户明确输入或用户确认(构想 §8.1)
104
+ CHECK (kind <> 'instruction' OR authority IN ('user_explicit','user_confirmed'))
105
+ );
106
+
107
+ CREATE TABLE memory_revision (
108
+ id TEXT PRIMARY KEY,
109
+ memory_id TEXT NOT NULL REFERENCES memory(id) ON DELETE CASCADE,
110
+ seq INTEGER NOT NULL CHECK (seq >= 1),
111
+ parent_revision_ids TEXT NOT NULL DEFAULT '[]',
112
+ content TEXT NOT NULL,
113
+ content_hash TEXT NOT NULL,
114
+ scope_id TEXT NOT NULL REFERENCES scope(id) ON DELETE RESTRICT,
115
+ status TEXT NOT NULL,
116
+ authority TEXT NOT NULL,
117
+ author TEXT NOT NULL,
118
+ device_id TEXT NOT NULL,
119
+ reason TEXT,
120
+ created_at TEXT NOT NULL,
121
+ UNIQUE (memory_id, seq)
122
+ );
123
+
124
+ CREATE TABLE evidence (
125
+ id TEXT PRIMARY KEY,
126
+ memory_id TEXT NOT NULL REFERENCES memory(id) ON DELETE CASCADE,
127
+ revision_id TEXT REFERENCES memory_revision(id) ON DELETE SET NULL,
128
+ evidence_kind TEXT NOT NULL CHECK (evidence_kind IN
129
+ ('message_range','file_ref','import_ref','url','tool_output','user_statement')),
130
+ source_agent TEXT,
131
+ session_id TEXT,
132
+ import_archive_id TEXT,
133
+ locator TEXT,
134
+ excerpt_hash TEXT,
135
+ trust_level TEXT NOT NULL CHECK (trust_level IN
136
+ ('authoritative','user_supplied','third_party','untrusted')),
137
+ created_at TEXT NOT NULL,
138
+ CHECK (evidence_kind <> 'import_ref' OR import_archive_id IS NOT NULL)
139
+ );
140
+
141
+ CREATE TABLE relation (
142
+ id TEXT PRIMARY KEY,
143
+ from_memory_id TEXT NOT NULL REFERENCES memory(id) ON DELETE CASCADE,
144
+ to_memory_id TEXT NOT NULL REFERENCES memory(id) ON DELETE CASCADE,
145
+ relation_type TEXT NOT NULL CHECK (relation_type IN ('supersedes','contradicts','related_to')),
146
+ created_at TEXT NOT NULL,
147
+ CHECK (from_memory_id <> to_memory_id),
148
+ UNIQUE (from_memory_id, to_memory_id, relation_type)
149
+ );
150
+
151
+ -- 并发双方证据队列(memory-governance spec:不做字段级 LWW)
152
+ CREATE TABLE conflict (
153
+ id TEXT PRIMARY KEY,
154
+ memory_id TEXT NOT NULL REFERENCES memory(id) ON DELETE CASCADE,
155
+ base_revision_id TEXT REFERENCES memory_revision(id),
156
+ revision_a_id TEXT NOT NULL REFERENCES memory_revision(id),
157
+ revision_b_id TEXT NOT NULL REFERENCES memory_revision(id),
158
+ detected_at TEXT NOT NULL,
159
+ status TEXT NOT NULL CHECK (status IN
160
+ ('open','resolved_keep_a','resolved_keep_b','resolved_keep_both','resolved_manual')),
161
+ resolved_at TEXT,
162
+ resolution_note TEXT,
163
+ UNIQUE (memory_id, revision_a_id, revision_b_id)
164
+ );
165
+
166
+ -- 可审计遗忘:内容停止使用但不物理消失;物理 purge 是独立维护操作
167
+ CREATE TABLE tombstone (
168
+ id TEXT PRIMARY KEY,
169
+ memory_id TEXT NOT NULL REFERENCES memory(id) ON DELETE RESTRICT,
170
+ reason TEXT,
171
+ forgotten_by TEXT NOT NULL,
172
+ forgotten_at TEXT NOT NULL,
173
+ content_hash TEXT NOT NULL
174
+ );
175
+
176
+ CREATE TABLE import_archive (
177
+ id TEXT PRIMARY KEY,
178
+ batch_id TEXT NOT NULL,
179
+ source_kind TEXT NOT NULL CHECK (source_kind IN
180
+ ('markdown','jsonl','agent_memory_file','manual_export')),
181
+ source_locator_hash TEXT NOT NULL,
182
+ source_label TEXT,
183
+ byte_size INTEGER NOT NULL CHECK (byte_size >= 0),
184
+ content_hash TEXT NOT NULL,
185
+ snapshot_path TEXT NOT NULL,
186
+ parser TEXT NOT NULL,
187
+ status TEXT NOT NULL CHECK (status IN
188
+ ('stored','partially_indexed','indexed','rejected','quarantined')),
189
+ redaction_state TEXT NOT NULL CHECK (redaction_state IN
190
+ ('not_scanned','scanned_clean','scanned_blocked')),
191
+ discovered_at TEXT NOT NULL,
192
+ imported_at TEXT,
193
+ UNIQUE (source_locator_hash, content_hash)
194
+ );
195
+
196
+ CREATE TABLE import_item (
197
+ id TEXT PRIMARY KEY,
198
+ archive_id TEXT NOT NULL REFERENCES import_archive(id) ON DELETE CASCADE,
199
+ item_index INTEGER NOT NULL CHECK (item_index >= 0),
200
+ content TEXT NOT NULL,
201
+ content_hash TEXT NOT NULL,
202
+ byte_offset INTEGER,
203
+ source_ref TEXT,
204
+ scan_state TEXT NOT NULL CHECK (scan_state IN ('pending','clean','blocked')),
205
+ scan_findings TEXT,
206
+ batch_id TEXT,
207
+ created_at TEXT NOT NULL,
208
+ UNIQUE (archive_id, item_index)
209
+ );
210
+
211
+ CREATE TABLE onboarding_plan (
212
+ id TEXT PRIMARY KEY,
213
+ plan_hash TEXT NOT NULL,
214
+ scope_id TEXT NOT NULL REFERENCES scope(id) ON DELETE RESTRICT,
215
+ status TEXT NOT NULL CHECK (status IN
216
+ ('draft','awaiting_approval','approved','applied','expired','invalidated','rejected')),
217
+ source_archive_ids TEXT NOT NULL DEFAULT '[]',
218
+ item_count INTEGER NOT NULL DEFAULT 0 CHECK (item_count >= 0),
219
+ proposed_by TEXT NOT NULL,
220
+ model_provider TEXT,
221
+ created_at TEXT NOT NULL,
222
+ expires_at TEXT NOT NULL,
223
+ applied_at TEXT
224
+ );
225
+
226
+ -- 计划操作:每个操作绑定目标修订快照,应用时重检(任务 3.1/3.3)
227
+ CREATE TABLE plan_operation (
228
+ id TEXT PRIMARY KEY,
229
+ plan_id TEXT NOT NULL REFERENCES onboarding_plan(id) ON DELETE CASCADE,
230
+ op_index INTEGER NOT NULL CHECK (op_index >= 0),
231
+ op_type TEXT NOT NULL CHECK (op_type IN ('add','merge','keep_both','skip')),
232
+ target_memory_id TEXT REFERENCES memory(id),
233
+ target_expected_revision TEXT,
234
+ item_id TEXT REFERENCES import_item(id),
235
+ content TEXT,
236
+ content_hash TEXT,
237
+ scope_id TEXT REFERENCES scope(id),
238
+ kind TEXT CHECK (kind IS NULL OR kind IN
239
+ ('instruction','preference','fact','decision','episode','procedure','environment')),
240
+ reason TEXT,
241
+ merged_from TEXT,
242
+ idempotency_key TEXT NOT NULL UNIQUE,
243
+ status TEXT NOT NULL DEFAULT 'pending' CHECK (status IN
244
+ ('pending','applied','skipped','failed')),
245
+ applied_at TEXT,
246
+ error TEXT,
247
+ UNIQUE (plan_id, op_index)
248
+ );
249
+
250
+ CREATE TABLE approval (
251
+ id TEXT PRIMARY KEY,
252
+ plan_id TEXT NOT NULL REFERENCES onboarding_plan(id) ON DELETE CASCADE,
253
+ plan_hash TEXT NOT NULL,
254
+ approved_by TEXT NOT NULL CHECK (approved_by IN ('user','local_cli','mcp_ui')),
255
+ channel TEXT NOT NULL,
256
+ approved_at TEXT NOT NULL,
257
+ expires_at TEXT NOT NULL,
258
+ revoked_at TEXT,
259
+ max_uses INTEGER NOT NULL DEFAULT 1 CHECK (max_uses >= 1),
260
+ uses INTEGER NOT NULL DEFAULT 0 CHECK (uses >= 0 AND uses <= max_uses)
261
+ );
262
+
263
+ CREATE UNIQUE INDEX approval_live_unique ON approval(plan_id) WHERE revoked_at IS NULL;
264
+
265
+ -- 后台任务本地可靠边界(design D9);上行任务受作用域触发器物理排除
266
+ CREATE TABLE outbox_job (
267
+ id TEXT PRIMARY KEY,
268
+ job_type TEXT NOT NULL CHECK (job_type IN
269
+ ('sync_upstream','extract','embed','maintain','projection_rebuild')),
270
+ scope_id TEXT REFERENCES scope(id) ON DELETE RESTRICT,
271
+ entity_type TEXT NOT NULL CHECK (entity_type IN ('memory','revision','plan','archive','system')),
272
+ entity_id TEXT NOT NULL,
273
+ payload TEXT NOT NULL DEFAULT '{}',
274
+ payload_hash TEXT NOT NULL,
275
+ idempotency_key TEXT NOT NULL UNIQUE,
276
+ status TEXT NOT NULL CHECK (status IN
277
+ ('pending','running','done','retry','failed','dead','conflict')),
278
+ attempts INTEGER NOT NULL DEFAULT 0 CHECK (attempts >= 0),
279
+ max_attempts INTEGER NOT NULL DEFAULT 5 CHECK (max_attempts >= 1),
280
+ next_attempt_at TEXT,
281
+ last_error TEXT,
282
+ created_at TEXT NOT NULL,
283
+ updated_at TEXT NOT NULL,
284
+ CHECK (status <> 'dead' OR attempts >= 1)
285
+ );
286
+
287
+ CREATE TABLE managed_block (
288
+ id TEXT PRIMARY KEY,
289
+ target_path TEXT NOT NULL,
290
+ block_id TEXT NOT NULL,
291
+ agent_id TEXT NOT NULL,
292
+ content_hash TEXT NOT NULL,
293
+ content TEXT NOT NULL,
294
+ start_marker TEXT NOT NULL,
295
+ end_marker TEXT NOT NULL,
296
+ backup_path TEXT,
297
+ installed_at TEXT NOT NULL,
298
+ updated_at TEXT NOT NULL,
299
+ removed_at TEXT,
300
+ UNIQUE (target_path, block_id),
301
+ CHECK (start_marker <> end_marker)
302
+ );
303
+
304
+ -- 宿主配置安装所有权记录(plan → apply → doctor → uninstall)
305
+ CREATE TABLE device_installation (
306
+ id TEXT PRIMARY KEY,
307
+ agent_kind TEXT NOT NULL,
308
+ home_root TEXT NOT NULL,
309
+ config_path TEXT NOT NULL,
310
+ target_hash TEXT NOT NULL,
311
+ backup_path TEXT,
312
+ plan_id TEXT,
313
+ installed_at TEXT NOT NULL,
314
+ removed_at TEXT,
315
+ UNIQUE (agent_kind, home_root, config_path)
316
+ );
317
+
318
+ -- 本地审计事件(design D10):不记录记忆正文与秘密
319
+ CREATE TABLE audit_event (
320
+ id TEXT PRIMARY KEY,
321
+ at TEXT NOT NULL,
322
+ category TEXT NOT NULL,
323
+ action TEXT NOT NULL,
324
+ subject_type TEXT,
325
+ subject_id TEXT,
326
+ detail TEXT NOT NULL DEFAULT '{}'
327
+ );
328
+
329
+ -- ---------------------------------------------------------------------------
330
+ -- 触发器:数据库层兜底的安全边界
331
+ -- ---------------------------------------------------------------------------
332
+
333
+ -- local_only 或设备限定内容绝不产生上行任务(spec scoped-retrieval)
334
+ CREATE TRIGGER outbox_reject_local_upstream
335
+ BEFORE INSERT ON outbox_job
336
+ WHEN NEW.job_type = 'sync_upstream' AND NEW.scope_id IS NOT NULL
337
+ BEGIN
338
+ SELECT RAISE(ABORT, 'scope_not_upstreamable')
339
+ WHERE (SELECT sync_policy FROM scope WHERE id = NEW.scope_id) <> 'encrypted'
340
+ OR (SELECT device_id FROM scope WHERE id = NEW.scope_id) <> 'all';
341
+ END;
342
+
343
+ -- 命中秘密扫描的正文在写入时拒绝,而不是打码后继续(构想 §12.3)
344
+ CREATE TRIGGER memory_reject_blocked_insert
345
+ BEFORE INSERT ON memory
346
+ WHEN NEW.sensitivity = 'blocked'
347
+ BEGIN
348
+ SELECT RAISE(ABORT, 'sensitivity_blocked_refused');
349
+ END;
350
+
351
+ CREATE TRIGGER memory_reject_blocked_update
352
+ BEFORE UPDATE OF sensitivity ON memory
353
+ WHEN NEW.sensitivity = 'blocked'
354
+ BEGIN
355
+ SELECT RAISE(ABORT, 'sensitivity_blocked_refused');
356
+ END;
357
+
358
+ -- 计划哈希变化使在途审批失效(memory-governance spec:批准后计划被修改)
359
+ CREATE TRIGGER plan_hash_change_revokes_approval
360
+ AFTER UPDATE OF plan_hash ON onboarding_plan
361
+ WHEN OLD.plan_hash <> NEW.plan_hash
362
+ BEGIN
363
+ UPDATE approval
364
+ SET revoked_at = strftime('%Y-%m-%dT%H:%M:%fZ','now')
365
+ WHERE plan_id = NEW.id AND revoked_at IS NULL;
366
+ UPDATE onboarding_plan
367
+ SET status = 'invalidated'
368
+ WHERE id = NEW.id AND status IN ('approved','awaiting_approval');
369
+ END;
370
+
371
+ -- 已应用计划不允许再次变更哈希(应用后不可篡改历史)
372
+ CREATE TRIGGER plan_applied_immutable
373
+ BEFORE UPDATE OF plan_hash ON onboarding_plan
374
+ WHEN OLD.status = 'applied' AND NEW.plan_hash <> OLD.plan_hash
375
+ BEGIN
376
+ SELECT RAISE(ABORT, 'applied_plan_immutable');
377
+ END;
378
+
379
+ -- ---------------------------------------------------------------------------
380
+ -- 索引
381
+ -- ---------------------------------------------------------------------------
382
+ CREATE INDEX memory_scope_status ON memory(scope_id, status);
383
+ CREATE INDEX memory_kind_status ON memory(kind, status);
384
+ CREATE INDEX memory_expiry ON memory(expires_at) WHERE expires_at IS NOT NULL;
385
+ CREATE INDEX memory_updated ON memory(updated_at);
386
+ CREATE INDEX memory_hash ON memory(content_hash);
387
+ CREATE INDEX memory_source_batch ON memory(source_import_batch_id);
388
+ CREATE INDEX revision_memory_seq ON memory_revision(memory_id, seq);
389
+ CREATE INDEX evidence_memory ON evidence(memory_id);
390
+ CREATE INDEX evidence_archive ON evidence(import_archive_id);
391
+ CREATE INDEX relation_from ON relation(from_memory_id);
392
+ CREATE INDEX relation_to ON relation(to_memory_id);
393
+ CREATE INDEX conflict_memory ON conflict(memory_id, status);
394
+ CREATE INDEX tombstone_memory ON tombstone(memory_id);
395
+ CREATE INDEX archive_batch ON import_archive(batch_id);
396
+ CREATE INDEX import_item_batch ON import_item(batch_id);
397
+ CREATE INDEX import_item_archive ON import_item(archive_id, scan_state);
398
+ CREATE INDEX plan_status_expiry ON onboarding_plan(status, expires_at);
399
+ CREATE INDEX plan_op_plan ON plan_operation(plan_id, op_index);
400
+ CREATE INDEX plan_op_status ON plan_operation(plan_id, status);
401
+ CREATE INDEX approval_plan ON approval(plan_id, revoked_at);
402
+ CREATE INDEX outbox_ready ON outbox_job(status, next_attempt_at) WHERE status IN ('pending','retry');
403
+ CREATE INDEX outbox_entity ON outbox_job(entity_type, entity_id);
404
+ CREATE INDEX managed_block_target ON managed_block(target_path, block_id);
405
+ CREATE INDEX device_install_target ON device_installation(agent_kind, home_root, config_path);
406
+ CREATE INDEX audit_at ON audit_event(at);
407
+ `;
408
+ export const MIGRATION_002_SEARCH = /* sql */ `
409
+ -- 检索索引(design D5):FTS5 trigram 服务三字及以上子串与拉丁文本;
410
+ -- 两字中文短查询由检索层走带界 LIKE 回退。memory.content 始终是原文事实源。
411
+ CREATE VIRTUAL TABLE memory_fts USING fts5(
412
+ content,
413
+ content='memory',
414
+ content_rowid='rowid',
415
+ tokenize='trigram'
416
+ );
417
+
418
+ CREATE TRIGGER memory_fts_ai AFTER INSERT ON memory BEGIN
419
+ INSERT INTO memory_fts(rowid, content) VALUES (new.rowid, new.content);
420
+ END;
421
+
422
+ CREATE TRIGGER memory_fts_ad AFTER DELETE ON memory BEGIN
423
+ INSERT INTO memory_fts(memory_fts, rowid, content) VALUES ('delete', old.rowid, old.content);
424
+ END;
425
+
426
+ CREATE TRIGGER memory_fts_au AFTER UPDATE OF content ON memory BEGIN
427
+ INSERT INTO memory_fts(memory_fts, rowid, content) VALUES ('delete', old.rowid, old.content);
428
+ INSERT INTO memory_fts(rowid, content) VALUES (new.rowid, new.content);
429
+ END;
430
+ `;
431
+ /**
432
+ * 003:内容去重加速(design D4)。
433
+ *
434
+ * 只加非唯一索引,不加 UNIQUE 约束:`UNIQUE(scope_id, content_hash) WHERE status='active'`
435
+ * 会与 keep_both 直接冲突——用户显式要求两条矛盾并存时,两条都可能是 active 且同内容;
436
+ * 历史修订也会让同一 content_hash 在 active 与 superseded 之间交错。
437
+ * 判定留在 governance/dedup.ts,索引只保证这条查询不随库增长退化。
438
+ */
439
+ export const MIGRATION_003_DEDUP = /* sql */ `
440
+ CREATE INDEX IF NOT EXISTS memory_scope_content ON memory(scope_id, content_hash);
441
+ `;
442
+ /**
443
+ * 004:新增 lesson 记忆类型。
444
+ *
445
+ * `memory.kind` 是硬编码 CHECK,加值只能重建表。这张表被 8 个表通过外键引用、
446
+ * 有 FTS 触发器与 6 个索引,重建必须逐字保留全部结构。
447
+ *
448
+ * 两个已实测的坑(改这条迁移前必读):
449
+ * 1. `PRAGMA foreign_keys` 在**事务内是 no-op** —— 必须在 BEGIN 之前关,故走
450
+ * Migration 的 preTransactionPragma。
451
+ * 2. 不关外键时 `DROP TABLE memory_old` 会**级联删光子表数据**,而
452
+ * `PRAGMA foreign_key_check` 仍报干净:静默丢数据,最难排查的一类失败。
453
+ *
454
+ * `legacy_alter_table=ON` 同样是必须的:默认模式下 RENAME 会把子表的外键定义
455
+ * 改写成 `memory_old`,重建后子表就指向了一张不存在的表。
456
+ */
457
+ export const MIGRATION_004_KIND_LESSON = /* sql */ `
458
+ PRAGMA legacy_alter_table = ON;
459
+
460
+ ALTER TABLE memory RENAME TO memory_old;
461
+
462
+ CREATE TABLE memory (
463
+ id TEXT PRIMARY KEY,
464
+ owner_id TEXT NOT NULL,
465
+ kind TEXT NOT NULL CHECK (kind IN
466
+ ('instruction','preference','fact','decision','episode','procedure','environment','lesson')),
467
+ content TEXT NOT NULL,
468
+ normalized_content TEXT NOT NULL,
469
+ scope_id TEXT NOT NULL REFERENCES scope(id) ON DELETE RESTRICT,
470
+ status TEXT NOT NULL CHECK (status IN
471
+ ('candidate','active','conflicted','superseded','archived','tombstoned')),
472
+ authority TEXT NOT NULL CHECK (authority IN
473
+ ('user_explicit','user_confirmed','agent_inferred','imported_unverified')),
474
+ confidence REAL NOT NULL DEFAULT 0 CHECK (confidence >= 0 AND confidence <= 1),
475
+ source_agent TEXT,
476
+ source_session_id TEXT,
477
+ source_import_batch_id TEXT,
478
+ source_message_range TEXT,
479
+ observed_at TEXT NOT NULL,
480
+ valid_from TEXT,
481
+ valid_to TEXT,
482
+ last_verified_at TEXT,
483
+ last_used_at TEXT,
484
+ expires_at TEXT,
485
+ sensitivity TEXT NOT NULL DEFAULT 'normal' CHECK (sensitivity IN ('normal','sensitive','blocked')),
486
+ current_revision_id TEXT REFERENCES memory_revision(id) DEFERRABLE INITIALLY DEFERRED,
487
+ content_hash TEXT NOT NULL,
488
+ created_by TEXT NOT NULL,
489
+ created_at TEXT NOT NULL,
490
+ updated_at TEXT NOT NULL,
491
+ CHECK (valid_to IS NULL OR valid_from IS NULL OR valid_to >= valid_from),
492
+ CHECK (kind <> 'instruction' OR authority IN ('user_explicit','user_confirmed'))
493
+ );
494
+
495
+ INSERT INTO memory SELECT * FROM memory_old;
496
+
497
+ DROP TABLE memory_old;
498
+
499
+ PRAGMA legacy_alter_table = OFF;
500
+
501
+ -- 索引与触发器随旧表一起被 DROP,必须原样重建。
502
+ CREATE INDEX IF NOT EXISTS memory_scope_status ON memory(scope_id, status);
503
+ CREATE INDEX IF NOT EXISTS memory_kind_status ON memory(kind, status);
504
+ CREATE INDEX IF NOT EXISTS memory_expiry ON memory(expires_at) WHERE expires_at IS NOT NULL;
505
+ CREATE INDEX IF NOT EXISTS memory_updated ON memory(updated_at);
506
+ CREATE INDEX IF NOT EXISTS memory_hash ON memory(content_hash);
507
+ CREATE INDEX IF NOT EXISTS memory_source_batch ON memory(source_import_batch_id);
508
+ -- 003_dedup_v1 建的索引:重建表会一并丢掉,必须补回,否则去重查询退化为全表扫。
509
+ CREATE INDEX IF NOT EXISTS memory_scope_content ON memory(scope_id, content_hash);
510
+
511
+ CREATE TRIGGER memory_fts_ai AFTER INSERT ON memory BEGIN
512
+ INSERT INTO memory_fts(rowid, content) VALUES (new.rowid, new.content);
513
+ END;
514
+
515
+ CREATE TRIGGER memory_fts_ad AFTER DELETE ON memory BEGIN
516
+ INSERT INTO memory_fts(memory_fts, rowid, content) VALUES ('delete', old.rowid, old.content);
517
+ END;
518
+
519
+ CREATE TRIGGER memory_fts_au AFTER UPDATE OF content ON memory BEGIN
520
+ INSERT INTO memory_fts(memory_fts, rowid, content) VALUES ('delete', old.rowid, old.content);
521
+ INSERT INTO memory_fts(rowid, content) VALUES (new.rowid, new.content);
522
+ END;
523
+
524
+ -- 重建后旧表的 FTS 内容已随 DROP 清空,必须从新表重建索引。
525
+ INSERT INTO memory_fts(memory_fts) VALUES('rebuild');
526
+ `;
527
+ //# sourceMappingURL=schema.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"schema.js","sourceRoot":"","sources":["../../../src/store/schema.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,MAAM,CAAC,MAAM,kBAAkB,GAAG,SAAS,CAAC;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CA+Y3C,CAAC;AAEF,MAAM,CAAC,MAAM,oBAAoB,GAAG,SAAS,CAAC;;;;;;;;;;;;;;;;;;;;;;CAsB7C,CAAC;AAEF;;;;;;;GAOG;AACH,MAAM,CAAC,MAAM,mBAAmB,GAAG,SAAS,CAAC;;CAE5C,CAAC;AAEF;;;;;;;;;;;;;;GAcG;AACH,MAAM,CAAC,MAAM,yBAAyB,GAAG,SAAS,CAAC;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CAqElD,CAAC"}
@@ -0,0 +1,44 @@
1
+ import { CairnDb } from './db.js';
2
+ import { ScopeRow, ScopeSpec, ScopePresetName, ScopeQuery } from '../core/scope.js';
3
+ import { WriteGuardMixin } from './write-guard.js';
4
+ /**
5
+ * 作用域仓储:预设 find-or-create、自定义空间创建与读取。
6
+ * 所有写入/检索/导出/投影入口必须经由 scopeAllowsRead/Upstream 判定。
7
+ */
8
+ export interface ResolvePresetOptions {
9
+ projectId?: string;
10
+ projectName?: string;
11
+ agentId?: string;
12
+ ttlDays?: number;
13
+ customSpaceName?: string;
14
+ overrides?: Partial<Pick<ScopeSpec, 'syncPolicy' | 'readPolicy' | 'readAllowlist' | 'projectionPolicy' | 'sensitivity' | 'ttlDays'>>;
15
+ }
16
+ export declare class ScopeRepository extends WriteGuardMixin {
17
+ private readonly db;
18
+ constructor(db: CairnDb);
19
+ /** 首次初始化:确保内置个人空间存在。 */
20
+ ensureBaseSpace(): string;
21
+ ensureProject(projectId: string, name: string): void;
22
+ ensureProjectScope(projectId: string, projectName: string): void;
23
+ /**
24
+ * 按预设 find-or-create 作用域。device-local/project-device 需要显式 deviceId。
25
+ * 返回库中的 ScopeRow(校验后的规范形态)。
26
+ */
27
+ resolvePreset(name: Exclude<ScopePresetName, 'custom'>, opts?: ResolvePresetOptions & {
28
+ deviceId?: string;
29
+ }): ScopeRow;
30
+ /** 受约束自定义空间(构想 §7.4):默认 local_only,显式扩大才放宽。 */
31
+ createCustom(spec: ScopeSpec): ScopeRow;
32
+ /** 相同指纹复用已有作用域,避免同一策略产生多行。 */
33
+ private upsertByFingerprint;
34
+ private ensureSpaceFor;
35
+ private findByFingerprint;
36
+ getById(id: string): ScopeRow | null;
37
+ requireById(id: string): ScopeRow;
38
+ list(): ScopeRow[];
39
+ /** 统一读取判定入口(检索/详情/导出/投影共用)。 */
40
+ allowsRead(scopeId: string, query: ScopeQuery): boolean;
41
+ allowsUpstream(scopeId: string): boolean;
42
+ isPhysicallyLocal(scopeId: string): boolean;
43
+ }
44
+ export declare function mapScope(r: Record<string, unknown>): ScopeRow;