@carloswon/cairn-memory 0.0.0-stage → 0.3.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (225) hide show
  1. package/CHANGELOG.md +81 -0
  2. package/LICENSE +21 -0
  3. package/README.md +158 -2
  4. package/dist/src/agents/adapters.d.ts +82 -0
  5. package/dist/src/agents/adapters.js +209 -0
  6. package/dist/src/agents/adapters.js.map +1 -0
  7. package/dist/src/agents/config.d.ts +82 -0
  8. package/dist/src/agents/config.js +603 -0
  9. package/dist/src/agents/config.js.map +1 -0
  10. package/dist/src/agents/cordisPatch.d.ts +89 -0
  11. package/dist/src/agents/cordisPatch.js +201 -0
  12. package/dist/src/agents/cordisPatch.js.map +1 -0
  13. package/dist/src/agents/index.d.ts +2 -0
  14. package/dist/src/agents/index.js +3 -0
  15. package/dist/src/agents/index.js.map +1 -0
  16. package/dist/src/core/errors.d.ts +36 -0
  17. package/dist/src/core/errors.js +74 -0
  18. package/dist/src/core/errors.js.map +1 -0
  19. package/dist/src/core/hash.d.ts +14 -0
  20. package/dist/src/core/hash.js +48 -0
  21. package/dist/src/core/hash.js.map +1 -0
  22. package/dist/src/core/ids.d.ts +10 -0
  23. package/dist/src/core/ids.js +41 -0
  24. package/dist/src/core/ids.js.map +1 -0
  25. package/dist/src/core/index.d.ts +6 -0
  26. package/dist/src/core/index.js +7 -0
  27. package/dist/src/core/index.js.map +1 -0
  28. package/dist/src/core/scope.d.ts +78 -0
  29. package/dist/src/core/scope.js +181 -0
  30. package/dist/src/core/scope.js.map +1 -0
  31. package/dist/src/core/secrets.d.ts +13 -0
  32. package/dist/src/core/secrets.js +122 -0
  33. package/dist/src/core/secrets.js.map +1 -0
  34. package/dist/src/core/time.d.ts +7 -0
  35. package/dist/src/core/time.js +18 -0
  36. package/dist/src/core/time.js.map +1 -0
  37. package/dist/src/core/types.d.ts +139 -0
  38. package/dist/src/core/types.js +30 -0
  39. package/dist/src/core/types.js.map +1 -0
  40. package/dist/src/governance/apply.d.ts +64 -0
  41. package/dist/src/governance/apply.js +160 -0
  42. package/dist/src/governance/apply.js.map +1 -0
  43. package/dist/src/governance/archive.d.ts +29 -0
  44. package/dist/src/governance/archive.js +52 -0
  45. package/dist/src/governance/archive.js.map +1 -0
  46. package/dist/src/governance/dedup.d.ts +21 -0
  47. package/dist/src/governance/dedup.js +23 -0
  48. package/dist/src/governance/dedup.js.map +1 -0
  49. package/dist/src/governance/index.d.ts +16 -0
  50. package/dist/src/governance/index.js +17 -0
  51. package/dist/src/governance/index.js.map +1 -0
  52. package/dist/src/governance/propose.d.ts +78 -0
  53. package/dist/src/governance/propose.js +150 -0
  54. package/dist/src/governance/propose.js.map +1 -0
  55. package/dist/src/index.d.ts +15 -0
  56. package/dist/src/index.js +24 -0
  57. package/dist/src/index.js.map +1 -0
  58. package/dist/src/interfaces/app-service.d.ts +292 -0
  59. package/dist/src/interfaces/app-service.js +743 -0
  60. package/dist/src/interfaces/app-service.js.map +1 -0
  61. package/dist/src/interfaces/cli/main.d.ts +2 -0
  62. package/dist/src/interfaces/cli/main.js +854 -0
  63. package/dist/src/interfaces/cli/main.js.map +1 -0
  64. package/dist/src/interfaces/console/assets/page.d.ts +18 -0
  65. package/dist/src/interfaces/console/assets/page.js +39 -0
  66. package/dist/src/interfaces/console/assets/page.js.map +1 -0
  67. package/dist/src/interfaces/console/assets/ui-css.d.ts +11 -0
  68. package/dist/src/interfaces/console/assets/ui-css.js +119 -0
  69. package/dist/src/interfaces/console/assets/ui-css.js.map +1 -0
  70. package/dist/src/interfaces/console/assets/ui-js.d.ts +14 -0
  71. package/dist/src/interfaces/console/assets/ui-js.js +1098 -0
  72. package/dist/src/interfaces/console/assets/ui-js.js.map +1 -0
  73. package/dist/src/interfaces/console/assets/url-state.d.ts +9 -0
  74. package/dist/src/interfaces/console/assets/url-state.js +45 -0
  75. package/dist/src/interfaces/console/assets/url-state.js.map +1 -0
  76. package/dist/src/interfaces/console/export.d.ts +46 -0
  77. package/dist/src/interfaces/console/export.js +84 -0
  78. package/dist/src/interfaces/console/export.js.map +1 -0
  79. package/dist/src/interfaces/console/model.d.ts +372 -0
  80. package/dist/src/interfaces/console/model.js +731 -0
  81. package/dist/src/interfaces/console/model.js.map +1 -0
  82. package/dist/src/interfaces/console/review-store.d.ts +142 -0
  83. package/dist/src/interfaces/console/review-store.js +342 -0
  84. package/dist/src/interfaces/console/review-store.js.map +1 -0
  85. package/dist/src/interfaces/console/security.d.ts +76 -0
  86. package/dist/src/interfaces/console/security.js +105 -0
  87. package/dist/src/interfaces/console/security.js.map +1 -0
  88. package/dist/src/interfaces/console/server.d.ts +45 -0
  89. package/dist/src/interfaces/console/server.js +476 -0
  90. package/dist/src/interfaces/console/server.js.map +1 -0
  91. package/dist/src/interfaces/console/suggestions.d.ts +112 -0
  92. package/dist/src/interfaces/console/suggestions.js +511 -0
  93. package/dist/src/interfaces/console/suggestions.js.map +1 -0
  94. package/dist/src/interfaces/console/text.d.ts +4 -0
  95. package/dist/src/interfaces/console/text.js +18 -0
  96. package/dist/src/interfaces/console/text.js.map +1 -0
  97. package/dist/src/interfaces/mcp/server.d.ts +4 -0
  98. package/dist/src/interfaces/mcp/server.js +480 -0
  99. package/dist/src/interfaces/mcp/server.js.map +1 -0
  100. package/dist/src/jobs/index.d.ts +6 -0
  101. package/dist/src/jobs/index.js +7 -0
  102. package/dist/src/jobs/index.js.map +1 -0
  103. package/dist/src/jobs/remote.d.ts +42 -0
  104. package/dist/src/jobs/remote.js +34 -0
  105. package/dist/src/jobs/remote.js.map +1 -0
  106. package/dist/src/jobs/worker.d.ts +67 -0
  107. package/dist/src/jobs/worker.js +169 -0
  108. package/dist/src/jobs/worker.js.map +1 -0
  109. package/dist/src/onboarding/auto.d.ts +88 -0
  110. package/dist/src/onboarding/auto.js +399 -0
  111. package/dist/src/onboarding/auto.js.map +1 -0
  112. package/dist/src/onboarding/batches.d.ts +103 -0
  113. package/dist/src/onboarding/batches.js +219 -0
  114. package/dist/src/onboarding/batches.js.map +1 -0
  115. package/dist/src/onboarding/discover.d.ts +54 -0
  116. package/dist/src/onboarding/discover.js +369 -0
  117. package/dist/src/onboarding/discover.js.map +1 -0
  118. package/dist/src/onboarding/import.d.ts +69 -0
  119. package/dist/src/onboarding/import.js +279 -0
  120. package/dist/src/onboarding/import.js.map +1 -0
  121. package/dist/src/onboarding/index.d.ts +24 -0
  122. package/dist/src/onboarding/index.js +22 -0
  123. package/dist/src/onboarding/index.js.map +1 -0
  124. package/dist/src/onboarding/judgement.d.ts +50 -0
  125. package/dist/src/onboarding/judgement.js +121 -0
  126. package/dist/src/onboarding/judgement.js.map +1 -0
  127. package/dist/src/onboarding/policy.d.ts +86 -0
  128. package/dist/src/onboarding/policy.js +249 -0
  129. package/dist/src/onboarding/policy.js.map +1 -0
  130. package/dist/src/projection/brief.d.ts +112 -0
  131. package/dist/src/projection/brief.js +200 -0
  132. package/dist/src/projection/brief.js.map +1 -0
  133. package/dist/src/projection/index.d.ts +1 -0
  134. package/dist/src/projection/index.js +2 -0
  135. package/dist/src/projection/index.js.map +1 -0
  136. package/dist/src/projection/markdown.d.ts +82 -0
  137. package/dist/src/projection/markdown.js +313 -0
  138. package/dist/src/projection/markdown.js.map +1 -0
  139. package/dist/src/retrieval/export.d.ts +80 -0
  140. package/dist/src/retrieval/export.js +215 -0
  141. package/dist/src/retrieval/export.js.map +1 -0
  142. package/dist/src/retrieval/index.d.ts +5 -0
  143. package/dist/src/retrieval/index.js +6 -0
  144. package/dist/src/retrieval/index.js.map +1 -0
  145. package/dist/src/retrieval/search.d.ts +37 -0
  146. package/dist/src/retrieval/search.js +294 -0
  147. package/dist/src/retrieval/search.js.map +1 -0
  148. package/dist/src/store/archives.d.ts +94 -0
  149. package/dist/src/store/archives.js +135 -0
  150. package/dist/src/store/archives.js.map +1 -0
  151. package/dist/src/store/audit.d.ts +57 -0
  152. package/dist/src/store/audit.js +131 -0
  153. package/dist/src/store/audit.js.map +1 -0
  154. package/dist/src/store/backup.d.ts +36 -0
  155. package/dist/src/store/backup.js +90 -0
  156. package/dist/src/store/backup.js.map +1 -0
  157. package/dist/src/store/blocks.d.ts +64 -0
  158. package/dist/src/store/blocks.js +104 -0
  159. package/dist/src/store/blocks.js.map +1 -0
  160. package/dist/src/store/conflicts.d.ts +52 -0
  161. package/dist/src/store/conflicts.js +112 -0
  162. package/dist/src/store/conflicts.js.map +1 -0
  163. package/dist/src/store/db.d.ts +44 -0
  164. package/dist/src/store/db.js +162 -0
  165. package/dist/src/store/db.js.map +1 -0
  166. package/dist/src/store/device.d.ts +46 -0
  167. package/dist/src/store/device.js +111 -0
  168. package/dist/src/store/device.js.map +1 -0
  169. package/dist/src/store/index.d.ts +14 -0
  170. package/dist/src/store/index.js +15 -0
  171. package/dist/src/store/index.js.map +1 -0
  172. package/dist/src/store/memories.d.ts +133 -0
  173. package/dist/src/store/memories.js +442 -0
  174. package/dist/src/store/memories.js.map +1 -0
  175. package/dist/src/store/migrate.d.ts +32 -0
  176. package/dist/src/store/migrate.js +87 -0
  177. package/dist/src/store/migrate.js.map +1 -0
  178. package/dist/src/store/open.d.ts +53 -0
  179. package/dist/src/store/open.js +203 -0
  180. package/dist/src/store/open.js.map +1 -0
  181. package/dist/src/store/outbox.d.ts +65 -0
  182. package/dist/src/store/outbox.js +137 -0
  183. package/dist/src/store/outbox.js.map +1 -0
  184. package/dist/src/store/plans.d.ts +137 -0
  185. package/dist/src/store/plans.js +243 -0
  186. package/dist/src/store/plans.js.map +1 -0
  187. package/dist/src/store/schema.d.ts +46 -0
  188. package/dist/src/store/schema.js +544 -0
  189. package/dist/src/store/schema.js.map +1 -0
  190. package/dist/src/store/scopes.d.ts +44 -0
  191. package/dist/src/store/scopes.js +220 -0
  192. package/dist/src/store/scopes.js.map +1 -0
  193. package/dist/src/store/write-guard.d.ts +10 -0
  194. package/dist/src/store/write-guard.js +10 -0
  195. package/dist/src/store/write-guard.js.map +1 -0
  196. package/dist/src/sync/apply.d.ts +24 -0
  197. package/dist/src/sync/apply.js +130 -0
  198. package/dist/src/sync/apply.js.map +1 -0
  199. package/dist/src/sync/cryptoutil.d.ts +86 -0
  200. package/dist/src/sync/cryptoutil.js +339 -0
  201. package/dist/src/sync/cryptoutil.js.map +1 -0
  202. package/dist/src/sync/events.d.ts +69 -0
  203. package/dist/src/sync/events.js +78 -0
  204. package/dist/src/sync/events.js.map +1 -0
  205. package/dist/src/sync/obs-store.d.ts +41 -0
  206. package/dist/src/sync/obs-store.js +325 -0
  207. package/dist/src/sync/obs-store.js.map +1 -0
  208. package/dist/src/sync/orchestrate.d.ts +37 -0
  209. package/dist/src/sync/orchestrate.js +84 -0
  210. package/dist/src/sync/orchestrate.js.map +1 -0
  211. package/dist/src/sync/pull.d.ts +24 -0
  212. package/dist/src/sync/pull.js +150 -0
  213. package/dist/src/sync/pull.js.map +1 -0
  214. package/dist/src/sync/push.d.ts +19 -0
  215. package/dist/src/sync/push.js +227 -0
  216. package/dist/src/sync/push.js.map +1 -0
  217. package/dist/src/sync/syncd-store.d.ts +31 -0
  218. package/dist/src/sync/syncd-store.js +92 -0
  219. package/dist/src/sync/syncd-store.js.map +1 -0
  220. package/dist/src/sync/vault.d.ts +37 -0
  221. package/dist/src/sync/vault.js +53 -0
  222. package/dist/src/sync/vault.js.map +1 -0
  223. package/docs/cairn-security.md +267 -0
  224. package/docs/cairn-usage.md +919 -0
  225. package/package.json +71 -4
@@ -0,0 +1,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,87 @@
1
+ import { MIGRATION_001_CORE, MIGRATION_002_SEARCH, MIGRATION_003_DEDUP, MIGRATION_004_KIND_LESSON, MIGRATION_005_MEMORY_IMPORTANCE_USAGE, } 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
+ { version: 5, name: 'importance_usage', sql: MIGRATION_005_MEMORY_IMPORTANCE_USAGE },
18
+ ];
19
+ function currentVersion(db) {
20
+ const row = db.get('PRAGMA user_version');
21
+ return row ? Number(Object.values(row)[0]) : 0;
22
+ }
23
+ function setVersion(db, v) {
24
+ db.exec(`PRAGMA user_version = ${v}`);
25
+ }
26
+ /**
27
+ * 版本化迁移(任务 1.2):每个迁移独立事务,失败回滚,
28
+ * 数据库停留在旧版本且可再次执行;绝不留下半迁移库。
29
+ * 并发安全:BEGIN IMMEDIATE 取到写锁【之后】重读版本号,
30
+ * 多进程同时打开同一新库时只有一方真正建表,另一方幂等跳过。
31
+ * schema 版本高于已知实现时拒绝打开(防旧代码写新库)。
32
+ */
33
+ export function runMigrations(db, migrations = MIGRATIONS) {
34
+ const applied = [];
35
+ let v = currentVersion(db);
36
+ const latest = migrations.length > 0 ? migrations[migrations.length - 1].version : 0;
37
+ if (v > latest) {
38
+ throw err('E_MIGRATION_FAILED', `数据库 schema 版本 ${v} 高于当前实现支持的 ${latest};请升级 Cairn 后再打开该数据目录`, { dbVersion: v, supportedVersion: latest });
39
+ }
40
+ for (const m of migrations) {
41
+ if (m.version <= v)
42
+ continue;
43
+ try {
44
+ let appliedThis = false;
45
+ // 事务外的前置 pragma:foreign_keys 必须在 BEGIN 之前设置才生效。
46
+ for (const pragma of m.preTransactionPragma ?? [])
47
+ db.exec(pragma);
48
+ db.transaction(() => {
49
+ // 持写锁后重读:并发进程可能已在本事务排队期间完成该迁移
50
+ const current = currentVersion(db);
51
+ if (m.version <= current)
52
+ return;
53
+ db.exec(m.sql);
54
+ setVersion(db, m.version);
55
+ appliedThis = true;
56
+ });
57
+ // 事务外的后置 pragma:把 pre 阶段改掉的设置恢复。**成功失败都要跑**,
58
+ // 否则一次迁移失败会让连接停在外键关闭状态,后续写入失去约束。
59
+ for (const pragma of m.postTransactionPragma ?? [])
60
+ db.exec(pragma);
61
+ if (appliedThis) {
62
+ applied.push(m.version);
63
+ v = m.version;
64
+ }
65
+ else {
66
+ v = Math.max(v, m.version);
67
+ }
68
+ }
69
+ catch (e) {
70
+ // 失败路径同样恢复 pragma,再做错误包装。
71
+ try {
72
+ for (const pragma of m.postTransactionPragma ?? [])
73
+ db.exec(pragma);
74
+ }
75
+ catch {
76
+ // 恢复失败不掩盖原始错误:原始错误更能说明问题。
77
+ }
78
+ throw err('E_MIGRATION_FAILED', `迁移 ${m.version} (${m.name}) 失败: ${e.message}`, {
79
+ version: m.version,
80
+ name: m.name,
81
+ });
82
+ }
83
+ }
84
+ return { applied, currentVersion: v };
85
+ }
86
+ export { currentVersion as schemaVersion };
87
+ //# 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 };
@@ -0,0 +1,203 @@
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, readAuditConfig } 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
+ const store = assembleStore(db, paths, identity, cloneCheck, readOnly);
78
+ if (!readOnly) {
79
+ // 操作审计(add-operation-audit):幂等复合索引 + 保留期清理。
80
+ // 索引不进迁移框架(CREATE INDEX IF NOT EXISTS 幂等,零迁移风险);
81
+ // 清理进程内每小时至多一次,失败只进 stderr。
82
+ db.run('CREATE INDEX IF NOT EXISTS audit_category_at ON audit_event(category, at)');
83
+ maybePruneOperations(store);
84
+ }
85
+ return store;
86
+ }
87
+ catch (e) {
88
+ lastError = e;
89
+ db.close();
90
+ if (attempt < maxAttempts && isRetryableSqliteError(e)) {
91
+ Atomics.wait(new Int32Array(new SharedArrayBuffer(4)), 0, 0, 50 * attempt);
92
+ continue;
93
+ }
94
+ throw e;
95
+ }
96
+ }
97
+ throw lastError ?? err('E_IO', `无法打开数据库 ${paths.dbPath}`, { attempts: maxAttempts });
98
+ }
99
+ /**
100
+ * 首建抢占(第二轮验证报告建议 3):库文件不存在时以 O_EXCL 抢占创建,
101
+ * 抢到的进程负责建库;未抢到的进程等待库就绪(迁移完成)后再打开。
102
+ * 消除"4 个进程同时迁移同一新库"的争用面。
103
+ */
104
+ function firstCreatorOrWait(dbPath) {
105
+ if (existsSync(dbPath))
106
+ return;
107
+ try {
108
+ closeSync(openSync(dbPath, 'wx'));
109
+ return; // 本进程是首建者
110
+ }
111
+ catch (e) {
112
+ if (e.code !== 'EEXIST') {
113
+ throw err('E_IO', `创建数据库文件失败 ${dbPath}: ${e.message}`);
114
+ }
115
+ }
116
+ // 未抢到:等待首建者完成迁移(schema 就绪)
117
+ const deadline = Date.now() + 15_000;
118
+ for (;;) {
119
+ if (Date.now() > deadline) {
120
+ throw err('E_DB_LOCKED', `等待数据库就绪超时 ${dbPath}(首建者可能已失败)`);
121
+ }
122
+ if (existsSync(dbPath)) {
123
+ let probe = null;
124
+ try {
125
+ probe = CairnDb.open(dbPath, { readOnly: true, busyTimeoutMs: 500 });
126
+ const v = schemaVersion(probe);
127
+ probe.close();
128
+ probe = null;
129
+ if (v >= MIGRATIONS.length)
130
+ return;
131
+ }
132
+ catch {
133
+ probe?.close();
134
+ }
135
+ }
136
+ Atomics.wait(new Int32Array(new SharedArrayBuffer(4)), 0, 0, 100);
137
+ }
138
+ }
139
+ function assembleStore(db, paths, identity, initialCheck, readOnly) {
140
+ const cloneState = { check: initialCheck };
141
+ const writeGuard = () => assertWritable(cloneState.check);
142
+ const audit = new AuditLog(db);
143
+ const scopes = new ScopeRepository(db);
144
+ const memories = new MemoryRepository(db);
145
+ const archives = new ImportArchiveRepository(db);
146
+ const plans = new PlanRepository(db);
147
+ const outbox = new OutboxRepository(db, audit);
148
+ const blocks = new ManagedBlockRepository(db);
149
+ const installations = new DeviceInstallationRepository(db);
150
+ const conflicts = new ConflictRepository(db);
151
+ for (const repo of [scopes, memories, archives, plans, outbox, blocks, installations, conflicts]) {
152
+ repo.setWriteGuard(readOnly ? () => { throw err('E_READONLY', '只读连接拒绝写入'); } : writeGuard);
153
+ }
154
+ const store = {
155
+ paths,
156
+ db,
157
+ identity,
158
+ get cloneCheck() {
159
+ return cloneState.check;
160
+ },
161
+ scopes,
162
+ memories,
163
+ archives,
164
+ plans,
165
+ outbox,
166
+ blocks,
167
+ installations,
168
+ conflicts,
169
+ audit,
170
+ assertWritable() {
171
+ writeGuard();
172
+ },
173
+ reEnroll() {
174
+ const r = reEnrollDevice(db, paths.dataDir);
175
+ cloneState.check = checkCloneState(db, r.identity);
176
+ return r;
177
+ },
178
+ close() {
179
+ db.close();
180
+ },
181
+ };
182
+ return store;
183
+ }
184
+ export { schemaVersion };
185
+ /** 进程内节流:每小时至多跑一次保留期清理(design D4)。 */
186
+ let lastOperationPruneAt = 0;
187
+ function maybePruneOperations(store) {
188
+ const now = Date.now();
189
+ if (now - lastOperationPruneAt < 3_600_000)
190
+ return;
191
+ lastOperationPruneAt = now;
192
+ try {
193
+ const cfg = readAuditConfig(store.paths.home);
194
+ const deleted = store.audit.pruneOperations(cfg.retentionDays);
195
+ if (deleted > 0) {
196
+ console.error(`[cairn] 操作审计保留期清理:按 ${cfg.retentionDays} 天删除 ${deleted} 条`);
197
+ }
198
+ }
199
+ catch (e) {
200
+ console.error(`[cairn] 操作审计清理失败(不影响使用): ${e.message}`);
201
+ }
202
+ }
203
+ //# sourceMappingURL=open.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"open.js","sourceRoot":"","sources":["../../../src/store/open.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAE,UAAU,EAAE,QAAQ,EAAE,SAAS,EAAE,MAAM,SAAS,CAAC;AACrE,OAAO,EAAE,IAAI,EAAE,MAAM,WAAW,CAAC;AACjC,OAAO,EAAE,OAAO,EAAE,MAAM,SAAS,CAAC;AAClC,OAAO,EAAE,OAAO,EAAE,sBAAsB,EAAE,MAAM,SAAS,CAAC;AAC1D,OAAO,EAAE,aAAa,EAAE,aAAa,EAAE,UAAU,EAAE,MAAM,cAAc,CAAC;AACxE,OAAO,EAAE,eAAe,EAAE,MAAM,aAAa,CAAC;AAC9C,OAAO,EAAE,gBAAgB,EAAE,MAAM,eAAe,CAAC;AACjD,OAAO,EAAE,uBAAuB,EAAE,MAAM,eAAe,CAAC;AACxD,OAAO,EAAE,cAAc,EAAE,MAAM,YAAY,CAAC;AAC5C,OAAO,EAAE,gBAAgB,EAAE,MAAM,aAAa,CAAC;AAC/C,OAAO,EAAE,sBAAsB,EAAE,4BAA4B,EAAE,MAAM,aAAa,CAAC;AACnF,OAAO,EAAE,kBAAkB,EAAE,MAAM,gBAAgB,CAAC;AACpD,OAAO,EAAE,QAAQ,EAAE,eAAe,EAAE,MAAM,YAAY,CAAC;AACvD,OAAO,EACL,YAAY,EACZ,oBAAoB,EACpB,cAAc,EACd,eAAe,EACf,cAAc,EAGd,cAAc,GACf,MAAM,aAAa,CAAC;AACrB,OAAO,EAAE,GAAG,EAAE,MAAM,mBAAmB,CAAC;AACxC,OAAO,EAAE,MAAM,EAAE,MAAM,iBAAiB,CAAC;AAWzC,MAAM,UAAU,WAAW;IACzB,OAAO,OAAO,CAAC,GAAG,CAAC,YAAY,CAAC,IAAI,IAAI,CAAC,OAAO,EAAE,EAAE,QAAQ,CAAC,CAAC;AAChE,CAAC;AAED,MAAM,UAAU,YAAY,CAAC,IAAY;IACvC,MAAM,OAAO,GAAG,IAAI,CAAC,IAAI,EAAE,MAAM,CAAC,CAAC;IACnC,OAAO;QACL,IAAI;QACJ,MAAM,EAAE,IAAI,CAAC,OAAO,EAAE,UAAU,CAAC;QACjC,OAAO;QACP,YAAY,EAAE,IAAI,CAAC,IAAI,EAAE,WAAW,CAAC;QACrC,UAAU,EAAE,IAAI,CAAC,IAAI,EAAE,SAAS,CAAC;KAClC,CAAC;AACJ,CAAC;AAED,MAAM,UAAU,UAAU,CAAC,KAAiB;IAC1C,KAAK,MAAM,CAAC,IAAI,CAAC,KAAK,CAAC,IAAI,EAAE,KAAK,CAAC,OAAO,EAAE,KAAK,CAAC,YAAY,EAAE,KAAK,CAAC,UAAU,CAAC,EAAE,CAAC;QAClF,IAAI,CAAC,UAAU,CAAC,CAAC,CAAC;YAAE,SAAS,CAAC,CAAC,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC;IACxD,CAAC;AACH,CAAC;AA6BD;;;GAGG;AACH,MAAM,UAAU,SAAS,CAAC,OAAyB,EAAE;IACnD,MAAM,KAAK,GAAG,YAAY,CAAC,IAAI,CAAC,IAAI,IAAI,WAAW,EAAE,CAAC,CAAC;IACvD,IAAI,CAAC,IAAI,CAAC,QAAQ;QAAE,UAAU,CAAC,KAAK,CAAC,CAAC;IACtC,IAAI,IAAI,CAAC,QAAQ,IAAI,CAAC,UAAU,CAAC,KAAK,CAAC,MAAM,CAAC,EAAE,CAAC;QAC/C,MAAM,GAAG,CAAC,MAAM,EAAE,iBAAiB,KAAK,CAAC,MAAM,EAAE,CAAC,CAAC;IACrD,CAAC;IACD,MAAM,QAAQ,GAAG,IAAI,CAAC,QAAQ,IAAI,KAAK,CAAC;IACxC,IAAI,CAAC,QAAQ,EAAE,CAAC;QACd,kBAAkB,CAAC,KAAK,CAAC,MAAM,CAAC,CAAC;IACnC,CAAC;IACD,qCAAqC;IACrC,mDAAmD;IACnD,wCAAwC;IACxC,MAAM,WAAW,GAAG,CAAC,CAAC;IACtB,IAAI,SAAS,GAAiB,IAAI,CAAC;IACnC,KAAK,IAAI,OAAO,GAAG,CAAC,EAAE,OAAO,IAAI,WAAW,EAAE,OAAO,EAAE,EAAE,CAAC;QACxD,MAAM,EAAE,GAAG,OAAO,CAAC,IAAI,CAAC,KAAK,CAAC,MAAM,EAAE,EAAE,QAAQ,EAAE,CAAC,CAAC;QACpD,IAAI,CAAC;YACH,IAAI,CAAC,IAAI,CAAC,cAAc,EAAE,CAAC;gBACzB,aAAa,CAAC,EAAE,CAAC,CAAC;gBAClB,4BAA4B;gBAC5B,IAAI,CAAC,QAAQ,EAAE,CAAC;oBACd,EAAE,CAAC,GAAG,CAAC,yEAAyE,EAAE,MAAM,EAAE,CAAC,CAAC;gBAC9F,CAAC;YACH,CAAC;YACD,MAAM,QAAQ,GAAG,QAAQ;gBACvB,CAAC,CAAC,YAAY,CAAC,KAAK,CAAC,OAAO,CAAC,IAAI,EAAE,QAAQ,EAAE,uBAAuB,EAAE,aAAa,EAAE,EAAE,EAAE,SAAS,EAAE,MAAM,EAAE,EAAE;gBAC9G,CAAC,CAAC,oBAAoB,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC;YACxC,IAAI,UAAU,GAAG,eAAe,CAAC,EAAE,EAAE,QAAQ,CAAC,CAAC;YAC/C,IAAI,CAAC,QAAQ,EAAE,CAAC;gBACd,MAAM,MAAM,GAAG,cAAc,CAAC,EAAE,EAAE,QAAQ,CAAC,CAAC;gBAC5C,IAAI,MAAM,CAAC,UAAU,KAAK,SAAS,EAAE,CAAC;oBACpC,EAAE,CAAC,GAAG,CAAC,sDAAsD,EAAE,MAAM,CAAC,EAAE,CAAC,CAAC;gBAC5E,CAAC;gBACD,UAAU,GAAG,eAAe,CAAC,EAAE,EAAE,QAAQ,CAAC,CAAC;YAC7C,CAAC;YACD,MAAM,KAAK,GAAG,aAAa,CAAC,EAAE,EAAE,KAAK,EAAE,QAAQ,EAAE,UAAU,EAAE,QAAQ,CAAC,CAAC;YACvE,IAAI,CAAC,QAAQ,EAAE,CAAC;gBACd,4CAA4C;gBAC5C,iDAAiD;gBACjD,4BAA4B;gBAC5B,EAAE,CAAC,GAAG,CAAC,2EAA2E,CAAC,CAAC;gBACpF,oBAAoB,CAAC,KAAK,CAAC,CAAC;YAC9B,CAAC;YACD,OAAO,KAAK,CAAC;QACf,CAAC;QAAC,OAAO,CAAC,EAAE,CAAC;YACX,SAAS,GAAG,CAAU,CAAC;YACvB,EAAE,CAAC,KAAK,EAAE,CAAC;YACX,IAAI,OAAO,GAAG,WAAW,IAAI,sBAAsB,CAAC,CAAC,CAAC,EAAE,CAAC;gBACvD,OAAO,CAAC,IAAI,CAAC,IAAI,UAAU,CAAC,IAAI,iBAAiB,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,CAAC,EAAE,EAAE,GAAG,OAAO,CAAC,CAAC;gBAC3E,SAAS;YACX,CAAC;YACD,MAAM,CAAC,CAAC;QACV,CAAC;IACH,CAAC;IACD,MAAM,SAAS,IAAI,GAAG,CAAC,MAAM,EAAE,WAAW,KAAK,CAAC,MAAM,EAAE,EAAE,EAAE,QAAQ,EAAE,WAAW,EAAE,CAAC,CAAC;AACvF,CAAC;AAED;;;;GAIG;AACH,SAAS,kBAAkB,CAAC,MAAc;IACxC,IAAI,UAAU,CAAC,MAAM,CAAC;QAAE,OAAO;IAC/B,IAAI,CAAC;QACH,SAAS,CAAC,QAAQ,CAAC,MAAM,EAAE,IAAI,CAAC,CAAC,CAAC;QAClC,OAAO,CAAC,UAAU;IACpB,CAAC;IAAC,OAAO,CAAC,EAAE,CAAC;QACX,IAAK,CAA2B,CAAC,IAAI,KAAK,QAAQ,EAAE,CAAC;YACnD,MAAM,GAAG,CAAC,MAAM,EAAE,aAAa,MAAM,KAAM,CAAW,CAAC,OAAO,EAAE,CAAC,CAAC;QACpE,CAAC;IACH,CAAC;IACD,2BAA2B;IAC3B,MAAM,QAAQ,GAAG,IAAI,CAAC,GAAG,EAAE,GAAG,MAAM,CAAC;IACrC,SAAS,CAAC;QACR,IAAI,IAAI,CAAC,GAAG,EAAE,GAAG,QAAQ,EAAE,CAAC;YAC1B,MAAM,GAAG,CAAC,aAAa,EAAE,aAAa,MAAM,YAAY,CAAC,CAAC;QAC5D,CAAC;QACD,IAAI,UAAU,CAAC,MAAM,CAAC,EAAE,CAAC;YACvB,IAAI,KAAK,GAAmB,IAAI,CAAC;YACjC,IAAI,CAAC;gBACH,KAAK,GAAG,OAAO,CAAC,IAAI,CAAC,MAAM,EAAE,EAAE,QAAQ,EAAE,IAAI,EAAE,aAAa,EAAE,GAAG,EAAE,CAAC,CAAC;gBACrE,MAAM,CAAC,GAAG,aAAa,CAAC,KAAK,CAAC,CAAC;gBAC/B,KAAK,CAAC,KAAK,EAAE,CAAC;gBACd,KAAK,GAAG,IAAI,CAAC;gBACb,IAAI,CAAC,IAAI,UAAU,CAAC,MAAM;oBAAE,OAAO;YACrC,CAAC;YAAC,MAAM,CAAC;gBACP,KAAK,EAAE,KAAK,EAAE,CAAC;YACjB,CAAC;QACH,CAAC;QACD,OAAO,CAAC,IAAI,CAAC,IAAI,UAAU,CAAC,IAAI,iBAAiB,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,CAAC,EAAE,GAAG,CAAC,CAAC;IACpE,CAAC;AACH,CAAC;AAED,SAAS,aAAa,CACpB,EAAW,EACX,KAAiB,EACjB,QAA4B,EAC5B,YAA8B,EAC9B,QAAiB;IAEjB,MAAM,UAAU,GAAgC,EAAE,KAAK,EAAE,YAAY,EAAE,CAAC;IACxE,MAAM,UAAU,GAAG,GAAS,EAAE,CAAC,cAAc,CAAC,UAAU,CAAC,KAAK,CAAC,CAAC;IAChE,MAAM,KAAK,GAAG,IAAI,QAAQ,CAAC,EAAE,CAAC,CAAC;IAC/B,MAAM,MAAM,GAAG,IAAI,eAAe,CAAC,EAAE,CAAC,CAAC;IACvC,MAAM,QAAQ,GAAG,IAAI,gBAAgB,CAAC,EAAE,CAAC,CAAC;IAC1C,MAAM,QAAQ,GAAG,IAAI,uBAAuB,CAAC,EAAE,CAAC,CAAC;IACjD,MAAM,KAAK,GAAG,IAAI,cAAc,CAAC,EAAE,CAAC,CAAC;IACrC,MAAM,MAAM,GAAG,IAAI,gBAAgB,CAAC,EAAE,EAAE,KAAK,CAAC,CAAC;IAC/C,MAAM,MAAM,GAAG,IAAI,sBAAsB,CAAC,EAAE,CAAC,CAAC;IAC9C,MAAM,aAAa,GAAG,IAAI,4BAA4B,CAAC,EAAE,CAAC,CAAC;IAC3D,MAAM,SAAS,GAAG,IAAI,kBAAkB,CAAC,EAAE,CAAC,CAAC;IAC7C,KAAK,MAAM,IAAI,IAAI,CAAC,MAAM,EAAE,QAAQ,EAAE,QAAQ,EAAE,KAAK,EAAE,MAAM,EAAE,MAAM,EAAE,aAAa,EAAE,SAAS,CAAC,EAAE,CAAC;QACjG,IAAI,CAAC,aAAa,CAAC,QAAQ,CAAC,CAAC,CAAC,GAAG,EAAE,GAAG,MAAM,GAAG,CAAC,YAAY,EAAE,UAAU,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,UAAU,CAAC,CAAC;IAC7F,CAAC;IACD,MAAM,KAAK,GAAe;QACxB,KAAK;QACL,EAAE;QACF,QAAQ;QACR,IAAI,UAAU;YACZ,OAAO,UAAU,CAAC,KAAK,CAAC;QAC1B,CAAC;QACD,MAAM;QACN,QAAQ;QACR,QAAQ;QACR,KAAK;QACL,MAAM;QACN,MAAM;QACN,aAAa;QACb,SAAS;QACT,KAAK;QACL,cAAc;YACZ,UAAU,EAAE,CAAC;QACf,CAAC;QACD,QAAQ;YACN,MAAM,CAAC,GAAG,cAAc,CAAC,EAAE,EAAE,KAAK,CAAC,OAAO,CAAC,CAAC;YAC5C,UAAU,CAAC,KAAK,GAAG,eAAe,CAAC,EAAE,EAAE,CAAC,CAAC,QAAQ,CAAC,CAAC;YACnD,OAAO,CAAC,CAAC;QACX,CAAC;QACD,KAAK;YACH,EAAE,CAAC,KAAK,EAAE,CAAC;QACb,CAAC;KACF,CAAC;IACF,OAAO,KAAK,CAAC;AACf,CAAC;AAED,OAAO,EAAE,aAAa,EAAE,CAAC;AAEzB,sCAAsC;AACtC,IAAI,oBAAoB,GAAG,CAAC,CAAC;AAE7B,SAAS,oBAAoB,CAAC,KAAiB;IAC7C,MAAM,GAAG,GAAG,IAAI,CAAC,GAAG,EAAE,CAAC;IACvB,IAAI,GAAG,GAAG,oBAAoB,GAAG,SAAS;QAAE,OAAO;IACnD,oBAAoB,GAAG,GAAG,CAAC;IAC3B,IAAI,CAAC;QACH,MAAM,GAAG,GAAG,eAAe,CAAC,KAAK,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC;QAC9C,MAAM,OAAO,GAAG,KAAK,CAAC,KAAK,CAAC,eAAe,CAAC,GAAG,CAAC,aAAa,CAAC,CAAC;QAC/D,IAAI,OAAO,GAAG,CAAC,EAAE,CAAC;YAChB,OAAO,CAAC,KAAK,CAAC,uBAAuB,GAAG,CAAC,aAAa,QAAQ,OAAO,IAAI,CAAC,CAAC;QAC7E,CAAC;IACH,CAAC;IAAC,OAAO,CAAC,EAAE,CAAC;QACX,OAAO,CAAC,KAAK,CAAC,4BAA6B,CAAW,CAAC,OAAO,EAAE,CAAC,CAAC;IACpE,CAAC;AACH,CAAC"}
@@ -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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"}