@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,48 @@
1
+ import { uuidv7 } from '../core/ids.js';
2
+ import { nowIso } from '../core/time.js';
3
+ /**
4
+ * 本地审计事件(design D10):记录计划、审批、配置备份、作用域排除、
5
+ * 恢复与错误类别。detail 绝不写入记忆正文和秘密——调用方负责。
6
+ */
7
+ export class AuditLog {
8
+ db;
9
+ constructor(db) {
10
+ this.db = db;
11
+ }
12
+ record(category, action, subject, detail = {}) {
13
+ const id = uuidv7();
14
+ this.db.run('INSERT INTO audit_event (id, at, category, action, subject_type, subject_id, detail) VALUES (?, ?, ?, ?, ?, ?, ?)', id, nowIso(), category, action, subject?.type ?? null, subject?.id ?? null, JSON.stringify(detail));
15
+ return id;
16
+ }
17
+ recent(limit = 50) {
18
+ return this.db
19
+ .all('SELECT * FROM audit_event ORDER BY at DESC, id DESC LIMIT ?', limit)
20
+ .map((r) => ({
21
+ id: r.id,
22
+ at: r.at,
23
+ category: r.category,
24
+ action: r.action,
25
+ subjectType: r.subject_type ?? null,
26
+ subjectId: r.subject_id ?? null,
27
+ detail: safeParse(r.detail),
28
+ }));
29
+ }
30
+ countByCategory() {
31
+ const rows = this.db.all('SELECT category, COUNT(*) AS n FROM audit_event GROUP BY category');
32
+ const out = {};
33
+ for (const r of rows)
34
+ out[r.category] = Number(r.n);
35
+ return out;
36
+ }
37
+ }
38
+ function safeParse(s) {
39
+ if (!s)
40
+ return {};
41
+ try {
42
+ return JSON.parse(s);
43
+ }
44
+ catch {
45
+ return { unparsable: true };
46
+ }
47
+ }
48
+ //# sourceMappingURL=audit.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"audit.js","sourceRoot":"","sources":["../../../src/store/audit.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,MAAM,EAAE,MAAM,gBAAgB,CAAC;AACxC,OAAO,EAAE,MAAM,EAAE,MAAM,iBAAiB,CAAC;AAMzC;;;GAGG;AACH,MAAM,OAAO,QAAQ;IACU;IAA7B,YAA6B,EAAW;QAAX,OAAE,GAAF,EAAE,CAAS;IAAG,CAAC;IAE5C,MAAM,CAAC,QAAgB,EAAE,MAAc,EAAE,OAAwC,EAAE,SAAsB,EAAE;QACzG,MAAM,EAAE,GAAG,MAAM,EAAE,CAAC;QACpB,IAAI,CAAC,EAAE,CAAC,GAAG,CACT,mHAAmH,EACnH,EAAE,EACF,MAAM,EAAE,EACR,QAAQ,EACR,MAAM,EACN,OAAO,EAAE,IAAI,IAAI,IAAI,EACrB,OAAO,EAAE,EAAE,IAAI,IAAI,EACnB,IAAI,CAAC,SAAS,CAAC,MAAM,CAAC,CACvB,CAAC;QACF,OAAO,EAAE,CAAC;IACZ,CAAC;IAED,MAAM,CAAC,KAAK,GAAG,EAAE;QACf,OAAO,IAAI,CAAC,EAAE;aACX,GAAG,CAAC,6DAA6D,EAAE,KAAK,CAAC;aACzE,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC;YACX,EAAE,EAAE,CAAC,CAAC,EAAY;YAClB,EAAE,EAAE,CAAC,CAAC,EAAY;YAClB,QAAQ,EAAE,CAAC,CAAC,QAAkB;YAC9B,MAAM,EAAE,CAAC,CAAC,MAAgB;YAC1B,WAAW,EAAG,CAAC,CAAC,YAA8B,IAAI,IAAI;YACtD,SAAS,EAAG,CAAC,CAAC,UAA4B,IAAI,IAAI;YAClD,MAAM,EAAE,SAAS,CAAC,CAAC,CAAC,MAAgB,CAAC;SACtC,CAAC,CAAC,CAAC;IACR,CAAC;IAED,eAAe;QACb,MAAM,IAAI,GAAG,IAAI,CAAC,EAAE,CAAC,GAAG,CAAC,mEAAmE,CAAC,CAAC;QAC9F,MAAM,GAAG,GAA2B,EAAE,CAAC;QACvC,KAAK,MAAM,CAAC,IAAI,IAAI;YAAE,GAAG,CAAC,CAAC,CAAC,QAAkB,CAAC,GAAG,MAAM,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC;QAC9D,OAAO,GAAG,CAAC;IACb,CAAC;CACF;AAED,SAAS,SAAS,CAAC,CAA4B;IAC7C,IAAI,CAAC,CAAC;QAAE,OAAO,EAAE,CAAC;IAClB,IAAI,CAAC;QACH,OAAO,IAAI,CAAC,KAAK,CAAC,CAAC,CAA4B,CAAC;IAClD,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,EAAE,UAAU,EAAE,IAAI,EAAE,CAAC;IAC9B,CAAC;AACH,CAAC"}
@@ -0,0 +1,36 @@
1
+ import { CairnDb } from './db.js';
2
+ export interface BackupCounts {
3
+ memory: number;
4
+ memory_revision: number;
5
+ import_archive: number;
6
+ outbox_job: number;
7
+ audit_event: number;
8
+ }
9
+ export declare function tableCounts(db: CairnDb): BackupCounts;
10
+ /**
11
+ * 一致性备份(任务 1.5):VACUUM INTO 产出事务一致快照,
12
+ * 不中断并发读写;返回文件字节数与 sha256 供恢复校验。
13
+ */
14
+ export declare function backupDatabase(db: CairnDb, targetPath: string): {
15
+ path: string;
16
+ bytes: number;
17
+ sha256: string;
18
+ counts: BackupCounts;
19
+ };
20
+ export declare function describeBackupFile(targetPath: string, sourceDb?: CairnDb): {
21
+ path: string;
22
+ bytes: number;
23
+ sha256: string;
24
+ counts?: BackupCounts;
25
+ };
26
+ /** 恢复校验:打开备份副本只读检查完整性并核对行数。 */
27
+ export declare function verifyBackup(backupPath: string, expected?: Partial<BackupCounts>): {
28
+ ok: boolean;
29
+ counts?: BackupCounts;
30
+ problems: string[];
31
+ };
32
+ /** 从备份恢复:调用方必须已关闭目标数据库;恢复后再次校验。 */
33
+ export declare function restoreFromBackup(backupPath: string, dbPath: string): {
34
+ restored: true;
35
+ verification: ReturnType<typeof verifyBackup>;
36
+ };
@@ -0,0 +1,90 @@
1
+ import { mkdirSync, copyFileSync, statSync, rmSync, readFileSync } from 'node:fs';
2
+ import { dirname } from 'node:path';
3
+ import { CairnDb } from './db.js';
4
+ import { err } from '../core/errors.js';
5
+ import { sha256Hex } from '../core/hash.js';
6
+ export function tableCounts(db) {
7
+ const c = (t) => Number(db.scalar(`SELECT COUNT(*) AS n FROM ${t}`) ?? 0);
8
+ return {
9
+ memory: c('memory'),
10
+ memory_revision: c('memory_revision'),
11
+ import_archive: c('import_archive'),
12
+ outbox_job: c('outbox_job'),
13
+ audit_event: c('audit_event'),
14
+ };
15
+ }
16
+ /**
17
+ * 一致性备份(任务 1.5):VACUUM INTO 产出事务一致快照,
18
+ * 不中断并发读写;返回文件字节数与 sha256 供恢复校验。
19
+ */
20
+ export function backupDatabase(db, targetPath) {
21
+ mkdirSync(dirname(targetPath), { recursive: true });
22
+ rmSync(targetPath, { force: true });
23
+ try {
24
+ db.exec(`VACUUM INTO '${targetPath.replace(/\\/g, '/').replace(/'/g, "''")}'`);
25
+ }
26
+ catch (e) {
27
+ throw err('E_IO', `备份失败: ${e.message}`, { targetPath });
28
+ }
29
+ const desc = describeBackupFile(targetPath, db);
30
+ return { path: desc.path, bytes: desc.bytes, sha256: desc.sha256, counts: desc.counts };
31
+ }
32
+ export function describeBackupFile(targetPath, sourceDb) {
33
+ const st = statSync(targetPath);
34
+ if (st.size > HASH_READ_LIMIT)
35
+ throw err('E_IO', '备份文件超过哈希计算上限', { path: targetPath, bytes: st.size });
36
+ return {
37
+ path: targetPath,
38
+ bytes: st.size,
39
+ sha256: sha256Hex(readFileSync(targetPath)),
40
+ ...(sourceDb ? { counts: tableCounts(sourceDb) } : {}),
41
+ };
42
+ }
43
+ const HASH_READ_LIMIT = 512 * 1024 * 1024;
44
+ /** 恢复校验:打开备份副本只读检查完整性并核对行数。 */
45
+ export function verifyBackup(backupPath, expected) {
46
+ const problems = [];
47
+ let db = null;
48
+ try {
49
+ try {
50
+ db = CairnDb.open(backupPath, { readOnly: true });
51
+ }
52
+ catch (e) {
53
+ return { ok: false, problems: [`无法打开备份: ${e.message}`] };
54
+ }
55
+ let integrityOk = false;
56
+ try {
57
+ integrityOk = db.integrityCheck();
58
+ }
59
+ catch (e) {
60
+ return { ok: false, problems: [`文件不是有效数据库或已损坏: ${e.message}`] };
61
+ }
62
+ if (!integrityOk)
63
+ problems.push('integrity_check 未通过');
64
+ const counts = tableCounts(db);
65
+ for (const [k, v] of Object.entries(expected ?? {})) {
66
+ if (v != null && counts[k] !== v) {
67
+ problems.push(`${k} 行数不一致: 备份 ${counts[k]} vs 预期 ${v}`);
68
+ }
69
+ }
70
+ return { ok: problems.length === 0, counts, problems };
71
+ }
72
+ finally {
73
+ db?.close();
74
+ }
75
+ }
76
+ /** 从备份恢复:调用方必须已关闭目标数据库;恢复后再次校验。 */
77
+ export function restoreFromBackup(backupPath, dbPath) {
78
+ const pre = verifyBackup(backupPath);
79
+ if (!pre.ok) {
80
+ throw err('E_BACKUP_CORRUPT', `备份校验失败,拒绝恢复: ${pre.problems.join('; ')}`, { backupPath });
81
+ }
82
+ mkdirSync(dirname(dbPath), { recursive: true });
83
+ copyFileSync(backupPath, dbPath);
84
+ const post = verifyBackup(dbPath, pre.counts);
85
+ if (!post.ok) {
86
+ throw err('E_BACKUP_CORRUPT', `恢复后校验失败: ${post.problems.join('; ')}`, { dbPath });
87
+ }
88
+ return { restored: true, verification: post };
89
+ }
90
+ //# sourceMappingURL=backup.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"backup.js","sourceRoot":"","sources":["../../../src/store/backup.ts"],"names":[],"mappings":"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"}
@@ -0,0 +1,64 @@
1
+ import { CairnDb } from './db.js';
2
+ import { WriteGuardMixin } from './write-guard.js';
3
+ /**
4
+ * 受管区块与宿主配置安装记录(任务 6.1/6.4)。
5
+ * managed_block:Markdown 投影区块所有权;device_installation:配置文件
6
+ * plan→apply 的目标哈希与备份路径,uninstall 依据记录精确移除。
7
+ */
8
+ export interface ManagedBlockRow {
9
+ id: string;
10
+ targetPath: string;
11
+ blockId: string;
12
+ agentId: string;
13
+ contentHash: string;
14
+ content: string;
15
+ startMarker: string;
16
+ endMarker: string;
17
+ backupPath: string | null;
18
+ installedAt: string;
19
+ updatedAt: string;
20
+ removedAt: string | null;
21
+ }
22
+ export interface DeviceInstallationRow {
23
+ id: string;
24
+ agentKind: string;
25
+ homeRoot: string;
26
+ configPath: string;
27
+ targetHash: string;
28
+ backupPath: string | null;
29
+ planId: string | null;
30
+ installedAt: string;
31
+ removedAt: string | null;
32
+ }
33
+ export declare class ManagedBlockRepository extends WriteGuardMixin {
34
+ private readonly db;
35
+ constructor(db: CairnDb);
36
+ upsert(input: {
37
+ targetPath: string;
38
+ blockId: string;
39
+ agentId: string;
40
+ content: string;
41
+ startMarker: string;
42
+ endMarker: string;
43
+ backupPath?: string;
44
+ }): ManagedBlockRow;
45
+ require(id: string): ManagedBlockRow;
46
+ get(targetPath: string, blockId: string): ManagedBlockRow | null;
47
+ listActive(targetPath?: string): ManagedBlockRow[];
48
+ markRemoved(id: string): void;
49
+ }
50
+ export declare class DeviceInstallationRepository extends WriteGuardMixin {
51
+ private readonly db;
52
+ constructor(db: CairnDb);
53
+ record(input: {
54
+ agentKind: string;
55
+ homeRoot: string;
56
+ configPath: string;
57
+ targetHash: string;
58
+ backupPath?: string;
59
+ planId?: string;
60
+ }): DeviceInstallationRow;
61
+ activeFor(agentKind: string, homeRoot: string): DeviceInstallationRow[];
62
+ markRemoved(id: string): void;
63
+ private map;
64
+ }
@@ -0,0 +1,104 @@
1
+ import { err } from '../core/errors.js';
2
+ import { uuidv7 } from '../core/ids.js';
3
+ import { nowIso } from '../core/time.js';
4
+ import { sha256Hex } from '../core/hash.js';
5
+ import { WriteGuardMixin } from './write-guard.js';
6
+ export class ManagedBlockRepository extends WriteGuardMixin {
7
+ db;
8
+ constructor(db) {
9
+ super();
10
+ this.db = db;
11
+ }
12
+ upsert(input) {
13
+ this.checkWritable();
14
+ const existing = this.db.get('SELECT * FROM managed_block WHERE target_path = ? AND block_id = ?', input.targetPath, input.blockId);
15
+ const hash = sha256Hex(input.content);
16
+ const at = nowIso();
17
+ if (existing) {
18
+ this.db.run(`UPDATE managed_block SET content = ?, content_hash = ?, start_marker = ?, end_marker = ?,
19
+ backup_path = IFNULL(?, backup_path), updated_at = ?, removed_at = NULL WHERE id = ?`, input.content, hash, input.startMarker, input.endMarker, input.backupPath ?? null, at, existing.id);
20
+ return this.require(existing.id);
21
+ }
22
+ const id = uuidv7();
23
+ this.db.run(`INSERT INTO managed_block (id, target_path, block_id, agent_id, content_hash, content, start_marker, end_marker, backup_path, installed_at, updated_at)
24
+ VALUES (?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?)`, id, input.targetPath, input.blockId, input.agentId, hash, input.content, input.startMarker, input.endMarker, input.backupPath ?? null, at, at);
25
+ return this.require(id);
26
+ }
27
+ require(id) {
28
+ const row = this.db.get('SELECT * FROM managed_block WHERE id = ?', id);
29
+ if (!row)
30
+ throw err('E_NOT_FOUND', `受管区块不存在: ${id}`);
31
+ return mapBlock(row);
32
+ }
33
+ get(targetPath, blockId) {
34
+ const row = this.db.get('SELECT * FROM managed_block WHERE target_path = ? AND block_id = ?', targetPath, blockId);
35
+ return row ? mapBlock(row) : null;
36
+ }
37
+ listActive(targetPath) {
38
+ if (targetPath) {
39
+ return this.db.all('SELECT * FROM managed_block WHERE removed_at IS NULL AND target_path = ?', targetPath).map(mapBlock);
40
+ }
41
+ return this.db.all('SELECT * FROM managed_block WHERE removed_at IS NULL').map(mapBlock);
42
+ }
43
+ markRemoved(id) {
44
+ this.db.run('UPDATE managed_block SET removed_at = ? WHERE id = ?', nowIso(), id);
45
+ }
46
+ }
47
+ export class DeviceInstallationRepository extends WriteGuardMixin {
48
+ db;
49
+ constructor(db) {
50
+ super();
51
+ this.db = db;
52
+ }
53
+ record(input) {
54
+ this.checkWritable();
55
+ const existing = this.db.get('SELECT * FROM device_installation WHERE agent_kind = ? AND home_root = ? AND config_path = ? AND removed_at IS NULL', input.agentKind, input.homeRoot, input.configPath);
56
+ const at = nowIso();
57
+ if (existing) {
58
+ this.db.run('UPDATE device_installation SET target_hash = ?, backup_path = IFNULL(?, backup_path), plan_id = IFNULL(?, plan_id), installed_at = ? WHERE id = ?', input.targetHash, input.backupPath ?? null, input.planId ?? null, at, existing.id);
59
+ return this.map(this.db.get('SELECT * FROM device_installation WHERE id = ?', existing.id));
60
+ }
61
+ const id = uuidv7();
62
+ this.db.run(`INSERT INTO device_installation (id, agent_kind, home_root, config_path, target_hash, backup_path, plan_id, installed_at)
63
+ VALUES (?, ?, ?, ?, ?, ?, ?, ?)`, id, input.agentKind, input.homeRoot, input.configPath, input.targetHash, input.backupPath ?? null, input.planId ?? null, at);
64
+ return this.map(this.db.get('SELECT * FROM device_installation WHERE id = ?', id));
65
+ }
66
+ activeFor(agentKind, homeRoot) {
67
+ return this.db
68
+ .all('SELECT * FROM device_installation WHERE agent_kind = ? AND home_root = ? AND removed_at IS NULL', agentKind, homeRoot)
69
+ .map((r) => this.map(r));
70
+ }
71
+ markRemoved(id) {
72
+ this.db.run('UPDATE device_installation SET removed_at = ? WHERE id = ?', nowIso(), id);
73
+ }
74
+ map(r) {
75
+ return {
76
+ id: r.id,
77
+ agentKind: r.agent_kind,
78
+ homeRoot: r.home_root,
79
+ configPath: r.config_path,
80
+ targetHash: r.target_hash,
81
+ backupPath: r.backup_path ?? null,
82
+ planId: r.plan_id ?? null,
83
+ installedAt: r.installed_at,
84
+ removedAt: r.removed_at ?? null,
85
+ };
86
+ }
87
+ }
88
+ function mapBlock(r) {
89
+ return {
90
+ id: r.id,
91
+ targetPath: r.target_path,
92
+ blockId: r.block_id,
93
+ agentId: r.agent_id,
94
+ contentHash: r.content_hash,
95
+ content: r.content,
96
+ startMarker: r.start_marker,
97
+ endMarker: r.end_marker,
98
+ backupPath: r.backup_path ?? null,
99
+ installedAt: r.installed_at,
100
+ updatedAt: r.updated_at,
101
+ removedAt: r.removed_at ?? null,
102
+ };
103
+ }
104
+ //# sourceMappingURL=blocks.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"blocks.js","sourceRoot":"","sources":["../../../src/store/blocks.ts"],"names":[],"mappings":"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"}
@@ -0,0 +1,52 @@
1
+ import { CairnDb } from './db.js';
2
+ import { RevisionRecord } from '../core/types.js';
3
+ import { WriteGuardMixin } from './write-guard.js';
4
+ /**
5
+ * 冲突队列(任务 3.4):并发修订不做字段级 LWW,
6
+ * 保留双方与共同祖先证据;检索明确标记未解决状态。
7
+ */
8
+ export type ConflictStatus = 'open' | 'resolved_keep_a' | 'resolved_keep_b' | 'resolved_keep_both' | 'resolved_manual';
9
+ export interface ConflictRow {
10
+ id: string;
11
+ memoryId: string;
12
+ baseRevisionId: string | null;
13
+ revisionAId: string;
14
+ revisionBId: string;
15
+ detectedAt: string;
16
+ status: ConflictStatus;
17
+ resolvedAt: string | null;
18
+ resolutionNote: string | null;
19
+ }
20
+ export declare class ConflictRepository extends WriteGuardMixin {
21
+ private readonly db;
22
+ constructor(db: CairnDb);
23
+ /**
24
+ * 记录并发冲突:双方修订必须存在且同属一个 memory。
25
+ * 同一对修订重复记录幂等(UNIQUE 约束)。
26
+ */
27
+ record(input: {
28
+ memoryId: string;
29
+ baseRevisionId?: string | null;
30
+ revisionAId: string;
31
+ revisionBId: string;
32
+ }): {
33
+ conflict: ConflictRow;
34
+ created: boolean;
35
+ };
36
+ requireById(id: string): ConflictRow;
37
+ /** 检测祖先关系:shared base 且互不为祖先 → 并发冲突。 */
38
+ isConcurrent(revA: RevisionRecord, revB: RevisionRecord, baseId: string | null): boolean;
39
+ ancestryOf(revisionId: string, seen?: Set<string>): Set<string>;
40
+ listOpen(memoryId?: string): ConflictRow[];
41
+ countOpen(): number;
42
+ /**
43
+ * 解决冲突。keep_both:以指定内容新建当前修订(双方证据保留在 conflict 行);
44
+ * keep_a/keep_b:指定修订成为当前;manual:仅标记,不动当前修订。
45
+ */
46
+ resolve(input: {
47
+ conflictId: string;
48
+ resolution: Exclude<ConflictStatus, 'open'>;
49
+ note?: string;
50
+ currentRevisionId?: string;
51
+ }): ConflictRow;
52
+ }
@@ -0,0 +1,112 @@
1
+ import { err } from '../core/errors.js';
2
+ import { uuidv7 } from '../core/ids.js';
3
+ import { nowIso } from '../core/time.js';
4
+ import { WriteGuardMixin } from './write-guard.js';
5
+ export class ConflictRepository extends WriteGuardMixin {
6
+ db;
7
+ constructor(db) {
8
+ super();
9
+ this.db = db;
10
+ }
11
+ /**
12
+ * 记录并发冲突:双方修订必须存在且同属一个 memory。
13
+ * 同一对修订重复记录幂等(UNIQUE 约束)。
14
+ */
15
+ record(input) {
16
+ this.checkWritable();
17
+ if (input.revisionAId === input.revisionBId)
18
+ throw err('E_VALIDATION', '冲突双方不能是同一修订');
19
+ for (const rid of [input.revisionAId, input.revisionBId]) {
20
+ const rev = this.db.get('SELECT memory_id FROM memory_revision WHERE id = ?', rid);
21
+ if (!rev)
22
+ throw err('E_NOT_FOUND', `修订不存在: ${rid}`);
23
+ if (rev.memory_id !== input.memoryId)
24
+ throw err('E_VALIDATION', '冲突修订必须属于同一记忆');
25
+ }
26
+ const existing = this.db.get('SELECT * FROM conflict WHERE memory_id = ? AND ((revision_a_id = ? AND revision_b_id = ?) OR (revision_a_id = ? AND revision_b_id = ?))', input.memoryId, input.revisionAId, input.revisionBId, input.revisionBId, input.revisionAId);
27
+ if (existing)
28
+ return { conflict: mapConflict(existing), created: false };
29
+ const id = uuidv7();
30
+ this.db.run(`INSERT INTO conflict (id, memory_id, base_revision_id, revision_a_id, revision_b_id, detected_at, status)
31
+ VALUES (?, ?, ?, ?, ?, ?, 'open')`, id, input.memoryId, input.baseRevisionId ?? null, input.revisionAId, input.revisionBId, nowIso());
32
+ // 记忆进入 conflicted 状态(检索层负责明确标记)
33
+ this.db.run("UPDATE memory SET status = 'conflicted', updated_at = ? WHERE id = ? AND status = 'active'", nowIso(), input.memoryId);
34
+ return { conflict: this.requireById(id), created: true };
35
+ }
36
+ requireById(id) {
37
+ const row = this.db.get('SELECT * FROM conflict WHERE id = ?', id);
38
+ if (!row)
39
+ throw err('E_NOT_FOUND', `冲突不存在: ${id}`);
40
+ return mapConflict(row);
41
+ }
42
+ /** 检测祖先关系:shared base 且互不为祖先 → 并发冲突。 */
43
+ isConcurrent(revA, revB, baseId) {
44
+ if (revA.memoryId !== revB.memoryId)
45
+ return false;
46
+ const inA = baseId != null && revA.parentRevisionIds.includes(baseId);
47
+ const inB = baseId != null && revB.parentRevisionIds.includes(baseId);
48
+ if (inA && inB)
49
+ return true;
50
+ // 双方各自基于同一祖先的新修订,但互相不在对方历史中
51
+ const aAncestry = this.ancestryOf(revA.id);
52
+ const bAncestry = this.ancestryOf(revB.id);
53
+ return !aAncestry.has(revB.id) && !bAncestry.has(revA.id);
54
+ }
55
+ ancestryOf(revisionId, seen = new Set()) {
56
+ if (seen.has(revisionId))
57
+ return seen;
58
+ seen.add(revisionId);
59
+ const row = this.db.get('SELECT parent_revision_ids FROM memory_revision WHERE id = ?', revisionId);
60
+ if (!row)
61
+ return seen;
62
+ try {
63
+ const parents = JSON.parse(row.parent_revision_ids ?? '[]');
64
+ for (const p of parents)
65
+ this.ancestryOf(p, seen);
66
+ }
67
+ catch {
68
+ /* 空历史 */
69
+ }
70
+ return seen;
71
+ }
72
+ listOpen(memoryId) {
73
+ if (memoryId) {
74
+ return this.db.all("SELECT * FROM conflict WHERE status = 'open' AND memory_id = ? ORDER BY detected_at", memoryId).map(mapConflict);
75
+ }
76
+ return this.db.all("SELECT * FROM conflict WHERE status = 'open' ORDER BY detected_at").map(mapConflict);
77
+ }
78
+ countOpen() {
79
+ return Number(this.db.scalar("SELECT COUNT(*) AS n FROM conflict WHERE status = 'open'") ?? 0);
80
+ }
81
+ /**
82
+ * 解决冲突。keep_both:以指定内容新建当前修订(双方证据保留在 conflict 行);
83
+ * keep_a/keep_b:指定修订成为当前;manual:仅标记,不动当前修订。
84
+ */
85
+ resolve(input) {
86
+ this.checkWritable();
87
+ const conflict = this.requireById(input.conflictId);
88
+ if (conflict.status !== 'open')
89
+ throw err('E_CONFLICT_STATE', `冲突已解决: ${conflict.status}`);
90
+ this.db.transaction(() => {
91
+ this.db.run('UPDATE conflict SET status = ?, resolved_at = ?, resolution_note = ? WHERE id = ?', input.resolution, nowIso(), input.note ?? null, conflict.id);
92
+ if (input.resolution !== 'resolved_manual' && input.currentRevisionId) {
93
+ this.db.run("UPDATE memory SET status = 'active', current_revision_id = ?, updated_at = ? WHERE id = ?", input.currentRevisionId, nowIso(), conflict.memoryId);
94
+ }
95
+ });
96
+ return this.requireById(conflict.id);
97
+ }
98
+ }
99
+ function mapConflict(r) {
100
+ return {
101
+ id: r.id,
102
+ memoryId: r.memory_id,
103
+ baseRevisionId: r.base_revision_id ?? null,
104
+ revisionAId: r.revision_a_id,
105
+ revisionBId: r.revision_b_id,
106
+ detectedAt: r.detected_at,
107
+ status: r.status,
108
+ resolvedAt: r.resolved_at ?? null,
109
+ resolutionNote: r.resolution_note ?? null,
110
+ };
111
+ }
112
+ //# sourceMappingURL=conflicts.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"conflicts.js","sourceRoot":"","sources":["../../../src/store/conflicts.ts"],"names":[],"mappings":"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"}
@@ -0,0 +1,44 @@
1
+ import { DatabaseSync } from 'node:sqlite';
2
+ /**
3
+ * node:sqlite 适配层(design D2):所有数据库访问经过本类,
4
+ * 集中处理 WAL、外键、忙超时与事务,保留未来替换驱动的边界。
5
+ * 统一约定:SQL 全部使用位置参数 ?;undefined 一律映射为 null。
6
+ */
7
+ export interface OpenDbOptions {
8
+ readOnly?: boolean;
9
+ busyTimeoutMs?: number;
10
+ }
11
+ export declare class CairnDb {
12
+ readonly raw: DatabaseSync;
13
+ readonly path: string;
14
+ private txDepth;
15
+ private closed;
16
+ private constructor();
17
+ static open(path: string, opts?: OpenDbOptions): CairnDb;
18
+ exec(sql: string): void;
19
+ prepare(sql: string): import("node:sqlite").StatementSync;
20
+ get(sql: string, ...params: unknown[]): Record<string, unknown> | undefined;
21
+ all(sql: string, ...params: unknown[]): Record<string, unknown>[];
22
+ run(sql: string, ...params: unknown[]): {
23
+ changes: number | bigint;
24
+ lastInsertRowid: number | bigint;
25
+ };
26
+ /** 读值便捷方法:单行单列。 */
27
+ scalar(sql: string, ...params: unknown[]): unknown;
28
+ /**
29
+ * 事务:BEGIN IMMEDIATE 立即取写锁,配合 busy_timeout 产生可重试等待而非死锁。
30
+ * 嵌套调用转 SAVEPOINT;异常时回滚并重抛(业务错误保持原类型)。
31
+ */
32
+ transaction<T>(fn: () => T): T;
33
+ get inTransaction(): boolean;
34
+ integrityCheck(): boolean;
35
+ foreignKeyCheck(): {
36
+ table: string;
37
+ rowid: unknown;
38
+ parent: string;
39
+ fkid: unknown;
40
+ }[];
41
+ close(): void;
42
+ }
43
+ /** 冷启动竞态涉及的三类可重试 SQLite 错误(READONLY/BUSY/LOCKED)。 */
44
+ export declare function isRetryableSqliteError(e: unknown): boolean;