@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,177 @@
1
+ import { mkdirSync, existsSync, openSync, closeSync } from 'node:fs';
2
+ import { join } from 'node:path';
3
+ import { homedir } from 'node:os';
4
+ import { CairnDb, isRetryableSqliteError } from './db.js';
5
+ import { runMigrations, schemaVersion, MIGRATIONS } from './migrate.js';
6
+ import { ScopeRepository } from './scopes.js';
7
+ import { MemoryRepository } from './memories.js';
8
+ import { ImportArchiveRepository } from './archives.js';
9
+ import { PlanRepository } from './plans.js';
10
+ import { OutboxRepository } from './outbox.js';
11
+ import { ManagedBlockRepository, DeviceInstallationRepository } from './blocks.js';
12
+ import { ConflictRepository } from './conflicts.js';
13
+ import { AuditLog } from './audit.js';
14
+ import { loadIdentity, loadOrCreateIdentity, registerDevice, checkCloneState, assertWritable, reEnrollDevice, } from './device.js';
15
+ import { err } from '../core/errors.js';
16
+ import { nowIso } from '../core/time.js';
17
+ export function defaultHome() {
18
+ return process.env['CAIRN_HOME'] ?? join(homedir(), '.cairn');
19
+ }
20
+ export function resolvePaths(home) {
21
+ const dataDir = join(home, 'data');
22
+ return {
23
+ home,
24
+ dbPath: join(dataDir, 'cairn.db'),
25
+ dataDir,
26
+ snapshotsDir: join(home, 'snapshots'),
27
+ backupsDir: join(home, 'backups'),
28
+ };
29
+ }
30
+ export function ensureDirs(paths) {
31
+ for (const d of [paths.home, paths.dataDir, paths.snapshotsDir, paths.backupsDir]) {
32
+ if (!existsSync(d))
33
+ mkdirSync(d, { recursive: true });
34
+ }
35
+ }
36
+ /**
37
+ * 打开本地权威库:目录准备 → 迁移 → 设备身份与克隆检测 → 仓储装配。
38
+ * 迁移失败绝不进入正常读写(design Migration Plan)。
39
+ */
40
+ export function openStore(opts = {}) {
41
+ const paths = resolvePaths(opts.home ?? defaultHome());
42
+ if (!opts.readOnly)
43
+ ensureDirs(paths);
44
+ if (opts.readOnly && !existsSync(paths.dbPath)) {
45
+ throw err('E_IO', `只读打开失败:数据库不存在 ${paths.dbPath}`);
46
+ }
47
+ const readOnly = opts.readOnly ?? false;
48
+ if (!readOnly) {
49
+ firstCreatorOrWait(paths.dbPath);
50
+ }
51
+ // 冷启动竞态有界重试(第二轮独立验证 P1):多进程同时首建同一库时,
52
+ // 迁移后紧跟的 meta/device 写入可能撞上 SQLITE_READONLY/_BUSY;
53
+ // busy_timeout 不吸收 READONLY,必须关闭连接重开重试。
54
+ const maxAttempts = 5;
55
+ let lastError = null;
56
+ for (let attempt = 1; attempt <= maxAttempts; attempt++) {
57
+ const db = CairnDb.open(paths.dbPath, { readOnly });
58
+ try {
59
+ if (!opts.skipMigrations) {
60
+ runMigrations(db);
61
+ // meta 记录库创建信息(幂等;只读连接跳过写入)
62
+ if (!readOnly) {
63
+ db.run("INSERT OR IGNORE INTO meta (key, value) VALUES ('schema_created_at', ?)", nowIso());
64
+ }
65
+ }
66
+ const identity = readOnly
67
+ ? loadIdentity(paths.dataDir) ?? { deviceId: 'readonly-unregistered', instanceNonce: '', createdAt: nowIso() }
68
+ : loadOrCreateIdentity(paths.dataDir);
69
+ let cloneCheck = checkCloneState(db, identity);
70
+ if (!readOnly) {
71
+ const device = registerDevice(db, identity);
72
+ if (device.enrollment === 'pending') {
73
+ db.run("UPDATE device SET enrollment = 'active' WHERE id = ?", device.id);
74
+ }
75
+ cloneCheck = checkCloneState(db, identity);
76
+ }
77
+ return assembleStore(db, paths, identity, cloneCheck, readOnly);
78
+ }
79
+ catch (e) {
80
+ lastError = e;
81
+ db.close();
82
+ if (attempt < maxAttempts && isRetryableSqliteError(e)) {
83
+ Atomics.wait(new Int32Array(new SharedArrayBuffer(4)), 0, 0, 50 * attempt);
84
+ continue;
85
+ }
86
+ throw e;
87
+ }
88
+ }
89
+ throw lastError ?? err('E_IO', `无法打开数据库 ${paths.dbPath}`, { attempts: maxAttempts });
90
+ }
91
+ /**
92
+ * 首建抢占(第二轮验证报告建议 3):库文件不存在时以 O_EXCL 抢占创建,
93
+ * 抢到的进程负责建库;未抢到的进程等待库就绪(迁移完成)后再打开。
94
+ * 消除"4 个进程同时迁移同一新库"的争用面。
95
+ */
96
+ function firstCreatorOrWait(dbPath) {
97
+ if (existsSync(dbPath))
98
+ return;
99
+ try {
100
+ closeSync(openSync(dbPath, 'wx'));
101
+ return; // 本进程是首建者
102
+ }
103
+ catch (e) {
104
+ if (e.code !== 'EEXIST') {
105
+ throw err('E_IO', `创建数据库文件失败 ${dbPath}: ${e.message}`);
106
+ }
107
+ }
108
+ // 未抢到:等待首建者完成迁移(schema 就绪)
109
+ const deadline = Date.now() + 15_000;
110
+ for (;;) {
111
+ if (Date.now() > deadline) {
112
+ throw err('E_DB_LOCKED', `等待数据库就绪超时 ${dbPath}(首建者可能已失败)`);
113
+ }
114
+ if (existsSync(dbPath)) {
115
+ let probe = null;
116
+ try {
117
+ probe = CairnDb.open(dbPath, { readOnly: true, busyTimeoutMs: 500 });
118
+ const v = schemaVersion(probe);
119
+ probe.close();
120
+ probe = null;
121
+ if (v >= MIGRATIONS.length)
122
+ return;
123
+ }
124
+ catch {
125
+ probe?.close();
126
+ }
127
+ }
128
+ Atomics.wait(new Int32Array(new SharedArrayBuffer(4)), 0, 0, 100);
129
+ }
130
+ }
131
+ function assembleStore(db, paths, identity, initialCheck, readOnly) {
132
+ const cloneState = { check: initialCheck };
133
+ const writeGuard = () => assertWritable(cloneState.check);
134
+ const audit = new AuditLog(db);
135
+ const scopes = new ScopeRepository(db);
136
+ const memories = new MemoryRepository(db);
137
+ const archives = new ImportArchiveRepository(db);
138
+ const plans = new PlanRepository(db);
139
+ const outbox = new OutboxRepository(db, audit);
140
+ const blocks = new ManagedBlockRepository(db);
141
+ const installations = new DeviceInstallationRepository(db);
142
+ const conflicts = new ConflictRepository(db);
143
+ for (const repo of [scopes, memories, archives, plans, outbox, blocks, installations, conflicts]) {
144
+ repo.setWriteGuard(readOnly ? () => { throw err('E_READONLY', '只读连接拒绝写入'); } : writeGuard);
145
+ }
146
+ const store = {
147
+ paths,
148
+ db,
149
+ identity,
150
+ get cloneCheck() {
151
+ return cloneState.check;
152
+ },
153
+ scopes,
154
+ memories,
155
+ archives,
156
+ plans,
157
+ outbox,
158
+ blocks,
159
+ installations,
160
+ conflicts,
161
+ audit,
162
+ assertWritable() {
163
+ writeGuard();
164
+ },
165
+ reEnroll() {
166
+ const r = reEnrollDevice(db, paths.dataDir);
167
+ cloneState.check = checkCloneState(db, r.identity);
168
+ return r;
169
+ },
170
+ close() {
171
+ db.close();
172
+ },
173
+ };
174
+ return store;
175
+ }
176
+ export { schemaVersion };
177
+ //# sourceMappingURL=open.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"open.js","sourceRoot":"","sources":["../../../src/store/open.ts"],"names":[],"mappings":"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"}
@@ -0,0 +1,65 @@
1
+ import { CairnDb } from './db.js';
2
+ import { AuditLog } from './audit.js';
3
+ import { WriteGuardMixin } from './write-guard.js';
4
+ /**
5
+ * 本地 outbox(任务 5.3):后台任务的本地可靠边界。
6
+ * job_type=sync_upstream 受作用域物理排除(触发器 + 应用层双重检查);
7
+ * 默认不安装同步 hook,任务由独立 worker 或显式 CLI 处理。
8
+ */
9
+ export type JobType = 'sync_upstream' | 'extract' | 'embed' | 'maintain' | 'projection_rebuild';
10
+ export type JobStatus = 'pending' | 'running' | 'done' | 'retry' | 'failed' | 'dead' | 'conflict';
11
+ export interface JobRow {
12
+ id: string;
13
+ jobType: JobType;
14
+ scopeId: string | null;
15
+ entityType: 'memory' | 'revision' | 'plan' | 'archive' | 'system';
16
+ entityId: string;
17
+ payload: Record<string, unknown>;
18
+ payloadHash: string;
19
+ idempotencyKey: string;
20
+ status: JobStatus;
21
+ attempts: number;
22
+ maxAttempts: number;
23
+ nextAttemptAt: string | null;
24
+ lastError: string | null;
25
+ createdAt: string;
26
+ updatedAt: string;
27
+ }
28
+ export interface EnqueueJobInput {
29
+ jobType: JobType;
30
+ scopeId: string | null;
31
+ entityType: JobRow['entityType'];
32
+ entityId: string;
33
+ payload?: Record<string, unknown>;
34
+ idempotencyKey: string;
35
+ maxAttempts?: number;
36
+ }
37
+ /** 上行退避基数(毫秒);本变更无真实云端,仅用于故障注入与可重试状态验证。 */
38
+ export declare const RETRY_BACKOFF_MS: readonly [1000, 5000, 30000, number, number];
39
+ export declare class OutboxRepository extends WriteGuardMixin {
40
+ private readonly db;
41
+ private readonly audit;
42
+ constructor(db: CairnDb, audit: AuditLog);
43
+ /**
44
+ * 入队。local_only/设备限定内容对 sync_upstream 物理排除:
45
+ * 返回 { enqueued: false, reason: 'scope_local_only' } 并记录审计。
46
+ */
47
+ enqueue(input: EnqueueJobInput): {
48
+ job: JobRow | null;
49
+ enqueued: boolean;
50
+ reason?: string;
51
+ };
52
+ requireById(id: string): JobRow;
53
+ /** 领取到期任务:pending/retry 且 next_attempt_at <= now;置 running。 */
54
+ claimReady(limit: number, now?: string): JobRow[];
55
+ markDone(id: string): void;
56
+ /** 失败重试:超上限转 dead 并保留原因;绝不无限循环;终态任务不再变化。 */
57
+ markFailedRetry(id: string, error: string, now?: string): JobRow;
58
+ resetRunningToPending(now?: string): number;
59
+ counts(): Record<JobStatus, number>;
60
+ list(filter?: {
61
+ status?: JobStatus;
62
+ jobType?: JobType;
63
+ limit?: number;
64
+ }): JobRow[];
65
+ }
@@ -0,0 +1,137 @@
1
+ import { err } from '../core/errors.js';
2
+ import { uuidv7 } from '../core/ids.js';
3
+ import { nowIso } from '../core/time.js';
4
+ import { sha256Canonical } from '../core/hash.js';
5
+ import { WriteGuardMixin } from './write-guard.js';
6
+ /** 上行退避基数(毫秒);本变更无真实云端,仅用于故障注入与可重试状态验证。 */
7
+ export const RETRY_BACKOFF_MS = [1_000, 5_000, 30_000, 5 * 60_000, 30 * 60_000];
8
+ export class OutboxRepository extends WriteGuardMixin {
9
+ db;
10
+ audit;
11
+ constructor(db, audit) {
12
+ super();
13
+ this.db = db;
14
+ this.audit = audit;
15
+ }
16
+ /**
17
+ * 入队。local_only/设备限定内容对 sync_upstream 物理排除:
18
+ * 返回 { enqueued: false, reason: 'scope_local_only' } 并记录审计。
19
+ */
20
+ enqueue(input) {
21
+ this.checkWritable();
22
+ if (input.jobType === 'sync_upstream' && input.scopeId) {
23
+ const scope = this.db.get('SELECT sync_policy, device_id FROM scope WHERE id = ?', input.scopeId);
24
+ if (!scope)
25
+ throw err('E_NOT_FOUND', `作用域不存在: ${input.scopeId}`);
26
+ const upstreamable = scope.sync_policy === 'encrypted' && scope.device_id === 'all';
27
+ if (!upstreamable) {
28
+ this.audit.record('scope_exclusion', 'outbox_upstream_excluded', { type: 'scope', id: input.scopeId }, {
29
+ jobId: input.idempotencyKey,
30
+ reason: scope.sync_policy !== 'encrypted' ? 'local_only' : 'device_bound',
31
+ });
32
+ return { job: null, enqueued: false, reason: scope.sync_policy !== 'encrypted' ? 'scope_local_only' : 'scope_device_bound' };
33
+ }
34
+ }
35
+ const payload = input.payload ?? {};
36
+ const payloadHash = sha256Canonical(payload);
37
+ const existing = this.db.get('SELECT * FROM outbox_job WHERE idempotency_key = ?', input.idempotencyKey);
38
+ if (existing)
39
+ return { job: mapJob(existing), enqueued: false, reason: 'duplicate' };
40
+ const id = uuidv7();
41
+ const at = nowIso();
42
+ this.db.run(`INSERT INTO outbox_job (id, job_type, scope_id, entity_type, entity_id, payload, payload_hash,
43
+ idempotency_key, status, attempts, max_attempts, next_attempt_at, created_at, updated_at)
44
+ VALUES (?, ?, ?, ?, ?, ?, ?, ?, 'pending', 0, ?, ?, ?, ?)`, id, input.jobType, input.scopeId, input.entityType, input.entityId, JSON.stringify(payload), payloadHash, input.idempotencyKey, input.maxAttempts ?? 5, at, at, at);
45
+ return { job: this.requireById(id), enqueued: true };
46
+ }
47
+ requireById(id) {
48
+ const row = this.db.get('SELECT * FROM outbox_job WHERE id = ?', id);
49
+ if (!row)
50
+ throw err('E_NOT_FOUND', `任务不存在: ${id}`);
51
+ return mapJob(row);
52
+ }
53
+ /** 领取到期任务:pending/retry 且 next_attempt_at <= now;置 running。 */
54
+ claimReady(limit, now = nowIso()) {
55
+ return this.db.transaction(() => {
56
+ const rows = this.db.all(`SELECT * FROM outbox_job WHERE status IN ('pending','retry') AND (next_attempt_at IS NULL OR next_attempt_at <= ?)
57
+ ORDER BY next_attempt_at, created_at LIMIT ?`, now, limit);
58
+ for (const r of rows) {
59
+ this.db.run("UPDATE outbox_job SET status = 'running', updated_at = ? WHERE id = ?", now, r.id);
60
+ }
61
+ return rows.map((r) => ({ ...mapJob(r), status: 'running' }));
62
+ });
63
+ }
64
+ markDone(id) {
65
+ this.db.run("UPDATE outbox_job SET status = 'done', updated_at = ? WHERE id = ?", nowIso(), id);
66
+ }
67
+ /** 失败重试:超上限转 dead 并保留原因;绝不无限循环;终态任务不再变化。 */
68
+ markFailedRetry(id, error, now = nowIso()) {
69
+ const job = this.requireById(id);
70
+ if (job.status === 'dead' || job.status === 'done')
71
+ return job;
72
+ const attempts = job.attempts + 1;
73
+ if (attempts >= job.maxAttempts) {
74
+ this.db.run("UPDATE outbox_job SET status = 'dead', attempts = ?, last_error = ?, updated_at = ? WHERE id = ?", attempts, error, now, id);
75
+ }
76
+ else {
77
+ const backoff = RETRY_BACKOFF_MS[Math.min(attempts - 1, RETRY_BACKOFF_MS.length - 1)] ?? 60_000;
78
+ this.db.run("UPDATE outbox_job SET status = 'retry', attempts = ?, last_error = ?, next_attempt_at = ?, updated_at = ? WHERE id = ?", attempts, error, new Date(new Date(now).getTime() + backoff).toISOString(), now, id);
79
+ }
80
+ return this.requireById(id);
81
+ }
82
+ resetRunningToPending(now = nowIso()) {
83
+ // worker 崩溃后遗留的 running 任务复位(幂等续跑)
84
+ const r = this.db.run("UPDATE outbox_job SET status = 'pending', updated_at = ? WHERE status = 'running'", now);
85
+ return Number(r.changes);
86
+ }
87
+ counts() {
88
+ const out = Object.fromEntries(['pending', 'running', 'done', 'retry', 'failed', 'dead', 'conflict'].map((s) => [s, 0]));
89
+ for (const r of this.db.all('SELECT status, COUNT(*) AS n FROM outbox_job GROUP BY status')) {
90
+ out[r.status] = Number(r.n);
91
+ }
92
+ return out;
93
+ }
94
+ list(filter = {}) {
95
+ const where = [];
96
+ const params = [];
97
+ if (filter.status) {
98
+ where.push('status = ?');
99
+ params.push(filter.status);
100
+ }
101
+ if (filter.jobType) {
102
+ where.push('job_type = ?');
103
+ params.push(filter.jobType);
104
+ }
105
+ params.push(filter.limit ?? 100);
106
+ return this.db
107
+ .all(`SELECT * FROM outbox_job ${where.length ? 'WHERE ' + where.join(' AND ') : ''} ORDER BY created_at DESC LIMIT ?`, ...params)
108
+ .map(mapJob);
109
+ }
110
+ }
111
+ function mapJob(r) {
112
+ let payload = {};
113
+ try {
114
+ payload = JSON.parse(r.payload ?? '{}');
115
+ }
116
+ catch {
117
+ payload = {};
118
+ }
119
+ return {
120
+ id: r.id,
121
+ jobType: r.job_type,
122
+ scopeId: r.scope_id ?? null,
123
+ entityType: r.entity_type,
124
+ entityId: r.entity_id,
125
+ payload,
126
+ payloadHash: r.payload_hash,
127
+ idempotencyKey: r.idempotency_key,
128
+ status: r.status,
129
+ attempts: Number(r.attempts),
130
+ maxAttempts: Number(r.max_attempts),
131
+ nextAttemptAt: r.next_attempt_at ?? null,
132
+ lastError: r.last_error ?? null,
133
+ createdAt: r.created_at,
134
+ updatedAt: r.updated_at,
135
+ };
136
+ }
137
+ //# sourceMappingURL=outbox.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"outbox.js","sourceRoot":"","sources":["../../../src/store/outbox.ts"],"names":[],"mappings":"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"}
@@ -0,0 +1,137 @@
1
+ import { CairnDb } from './db.js';
2
+ import { MemoryKind, Sensitivity } from '../core/types.js';
3
+ import { WriteGuardMixin } from './write-guard.js';
4
+ /**
5
+ * 计划与审批仓储(任务 3.1/3.2)。
6
+ * plan_hash 基于【规范化】计划内容(操作列表 + 目标修订 + 作用域 + 来源),
7
+ * 字段顺序、空白、来源数组顺序变化不得影响哈希;任何内容变化必然改变哈希。
8
+ * 审批一次性、有有效期;plan_hash 变化由触发器自动撤销在途审批。
9
+ */
10
+ export type PlanOpType = 'add' | 'merge' | 'keep_both' | 'skip';
11
+ export type PlanStatus = 'draft' | 'awaiting_approval' | 'approved' | 'applied' | 'expired' | 'invalidated' | 'rejected';
12
+ export interface PlanOpInput {
13
+ opType: PlanOpType;
14
+ /** merge/keep_both 的目标记忆。 */
15
+ targetMemoryId?: string | null;
16
+ /** 目标修订快照:应用时重检,目标推进后拒绝(E_TARGET_CHANGED)。 */
17
+ targetExpectedRevision?: string | null;
18
+ itemId?: string | null;
19
+ content?: string | null;
20
+ scopeId?: string | null;
21
+ kind?: MemoryKind | null;
22
+ sensitivity?: Sensitivity | null;
23
+ reason?: string | null;
24
+ mergedFrom?: string[];
25
+ }
26
+ export interface PlanOpRecord {
27
+ id: string;
28
+ planId: string;
29
+ opIndex: number;
30
+ opType: PlanOpType;
31
+ targetMemoryId: string | null;
32
+ targetExpectedRevision: string | null;
33
+ itemId: string | null;
34
+ content: string | null;
35
+ contentHash: string | null;
36
+ scopeId: string | null;
37
+ kind: MemoryKind | null;
38
+ reason: string | null;
39
+ mergedFrom: string[];
40
+ idempotencyKey: string;
41
+ status: 'pending' | 'applied' | 'skipped' | 'failed';
42
+ appliedAt: string | null;
43
+ error: string | null;
44
+ }
45
+ export interface PlanRecord {
46
+ id: string;
47
+ planHash: string;
48
+ scopeId: string;
49
+ status: PlanStatus;
50
+ sourceArchiveIds: string[];
51
+ itemCount: number;
52
+ proposedBy: string;
53
+ modelProvider: string | null;
54
+ createdAt: string;
55
+ expiresAt: string;
56
+ appliedAt: string | null;
57
+ }
58
+ export interface ApprovalRecord {
59
+ id: string;
60
+ planId: string;
61
+ planHash: string;
62
+ approvedBy: 'user' | 'local_cli' | 'mcp_ui';
63
+ channel: string;
64
+ approvedAt: string;
65
+ expiresAt: string;
66
+ revokedAt: string | null;
67
+ maxUses: number;
68
+ uses: number;
69
+ }
70
+ export interface CanonicalPlanOp {
71
+ op_index: number;
72
+ op_type: PlanOpType;
73
+ target_memory_id: string | null;
74
+ target_expected_revision: string | null;
75
+ item_id: string | null;
76
+ content_hash: string | null;
77
+ scope_id: string | null;
78
+ kind: MemoryKind | null;
79
+ merged_from: string[];
80
+ }
81
+ export interface CanonicalPlan {
82
+ v: 1;
83
+ scope_id: string;
84
+ source_archive_ids: string[];
85
+ ops: CanonicalPlanOp[];
86
+ }
87
+ /** 规范化计划:内容进哈希的一律是哈希/ID/索引,正文不直接参与(稳定性+防篡改)。 */
88
+ export declare function canonicalizePlan(input: {
89
+ scopeId: string;
90
+ sourceArchiveIds: string[];
91
+ ops: PlanOpInput[];
92
+ hashContent: (content: string) => string;
93
+ }): CanonicalPlan;
94
+ export declare class PlanRepository extends WriteGuardMixin {
95
+ private readonly db;
96
+ constructor(db: CairnDb);
97
+ /** 创建计划(awaiting_approval):ops 落库并计算 plan_hash。 */
98
+ createPlan(input: {
99
+ scopeId: string;
100
+ sourceArchiveIds?: string[];
101
+ ops: PlanOpInput[];
102
+ proposedBy: string;
103
+ modelProvider?: string | null;
104
+ ttlMs?: number;
105
+ keyPrefix?: string;
106
+ }): {
107
+ plan: PlanRecord;
108
+ planHash: string;
109
+ };
110
+ requireById(id: string): PlanRecord;
111
+ findById(id: string): PlanRecord | null;
112
+ ops(planId: string): PlanOpRecord[];
113
+ requireOp(planId: string, opIndex: number): PlanOpRecord;
114
+ markOpApplied(opId: string): void;
115
+ markOpSkipped(opId: string): void;
116
+ markOpFailed(opId: string, error: string): void;
117
+ setStatus(id: string, status: PlanStatus): void;
118
+ /** 过期清扫:返回被标记过期的计划 id。 */
119
+ expireStale(now?: string): string[];
120
+ issueApproval(input: {
121
+ planId: string;
122
+ channel: string;
123
+ approvedBy?: 'user' | 'local_cli' | 'mcp_ui';
124
+ ttlMs?: number;
125
+ maxUses?: number;
126
+ }): {
127
+ approval: ApprovalRecord;
128
+ };
129
+ liveApproval(planId: string): ApprovalRecord | null;
130
+ requireApproval(id: string): ApprovalRecord;
131
+ /**
132
+ * 消费一次性审批:校验存在、绑定计划、哈希一致、未撤销、未过期、未用尽。
133
+ * 任一失败抛对应 E_APPROVAL_*,并保持 uses 不变(失败不消耗)。
134
+ */
135
+ consumeApproval(approvalId: string, planId: string, planHash: string, now?: string): ApprovalRecord;
136
+ revokeApproval(approvalId: string): void;
137
+ }