@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,94 @@
1
+ import { CairnDb } from './db.js';
2
+ import { WriteGuardMixin } from './write-guard.js';
3
+ /**
4
+ * 导入档案仓储(任务 4.2):不可变快照的元数据与条目。
5
+ * 快照文件本身由 onboarding 快照层写入 dataDir/snapshots/;
6
+ * 本仓储只负责幂等登记与条目索引。
7
+ */
8
+ export type ImportSourceKind = 'markdown' | 'jsonl' | 'agent_memory_file' | 'manual_export';
9
+ export type ImportArchiveStatus = 'stored' | 'partially_indexed' | 'indexed' | 'rejected' | 'quarantined';
10
+ export type RedactionState = 'not_scanned' | 'scanned_clean' | 'scanned_blocked';
11
+ export interface ImportArchiveRow {
12
+ id: string;
13
+ batchId: string;
14
+ sourceKind: ImportSourceKind;
15
+ sourceLocatorHash: string;
16
+ sourceLabel: string | null;
17
+ byteSize: number;
18
+ contentHash: string;
19
+ snapshotPath: string;
20
+ parser: string;
21
+ status: ImportArchiveStatus;
22
+ redactionState: RedactionState;
23
+ discoveredAt: string;
24
+ importedAt: string | null;
25
+ }
26
+ export interface CreateArchiveInput {
27
+ batchId: string;
28
+ sourceKind: ImportSourceKind;
29
+ /** 来源定位串(路径 + 关键元数据);只存哈希,不存原始路径以外的敏感信息。 */
30
+ sourceLocator: string;
31
+ sourceLabel?: string;
32
+ byteSize: number;
33
+ contentHash: string;
34
+ snapshotPath: string;
35
+ parser: string;
36
+ }
37
+ export interface ImportItemRow {
38
+ id: string;
39
+ archiveId: string;
40
+ itemIndex: number;
41
+ content: string;
42
+ contentHash: string;
43
+ byteOffset: number | null;
44
+ sourceRef: string | null;
45
+ scanState: 'pending' | 'clean' | 'blocked';
46
+ scanFindings: string | null;
47
+ batchId: string | null;
48
+ createdAt: string;
49
+ }
50
+ export declare class ImportArchiveRepository extends WriteGuardMixin {
51
+ private readonly db;
52
+ constructor(db: CairnDb);
53
+ /**
54
+ * 幂等创建:同一 (来源定位哈希, 内容哈希) 重复导入零新增,
55
+ * 返回 created=false 复用已有档案(spec agent-onboarding:重复导入)。
56
+ */
57
+ createArchive(input: CreateArchiveInput): {
58
+ archive: ImportArchiveRow;
59
+ created: boolean;
60
+ };
61
+ requireById(id: string): ImportArchiveRow;
62
+ findById(id: string): ImportArchiveRow | null;
63
+ listByBatch(batchId: string): ImportArchiveRow[];
64
+ list(): ImportArchiveRow[];
65
+ setStatus(id: string, status: ImportArchiveStatus): void;
66
+ setRedactionState(id: string, state: RedactionState): void;
67
+ /** 条目登记:archive 内按 index 幂等。 */
68
+ addItem(input: {
69
+ archiveId: string;
70
+ itemIndex: number;
71
+ content: string;
72
+ byteOffset?: number;
73
+ sourceRef?: string;
74
+ scanState?: 'pending' | 'clean' | 'blocked';
75
+ scanFindings?: string;
76
+ batchId?: string;
77
+ }): {
78
+ item: ImportItemRow;
79
+ created: boolean;
80
+ };
81
+ requireItem(id: string): ImportItemRow;
82
+ listItems(archiveId: string, filter?: {
83
+ batchId?: string;
84
+ scanState?: ImportItemRow['scanState'];
85
+ }): ImportItemRow[];
86
+ /** 分批取件:按批次取待处理条目,供 onboarding 分批读取(任务 4.3)。 */
87
+ nextBatch(batchId: string, limit: number, states?: ImportItemRow['scanState'][]): ImportItemRow[];
88
+ updateItemState(id: string, scanState: ImportItemRow['scanState'], scanFindings?: string, batchId?: string): void;
89
+ counts(): {
90
+ archives: number;
91
+ items: number;
92
+ blockedItems: number;
93
+ };
94
+ }
@@ -0,0 +1,135 @@
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 ImportArchiveRepository extends WriteGuardMixin {
7
+ db;
8
+ constructor(db) {
9
+ super();
10
+ this.db = db;
11
+ }
12
+ /**
13
+ * 幂等创建:同一 (来源定位哈希, 内容哈希) 重复导入零新增,
14
+ * 返回 created=false 复用已有档案(spec agent-onboarding:重复导入)。
15
+ */
16
+ createArchive(input) {
17
+ this.checkWritable();
18
+ const locatorHash = sha256Hex(input.sourceLocator);
19
+ const existing = this.db.get('SELECT * FROM import_archive WHERE source_locator_hash = ? AND content_hash = ?', locatorHash, input.contentHash);
20
+ if (existing)
21
+ return { archive: mapArchive(existing), created: false };
22
+ const id = uuidv7();
23
+ this.db.run(`INSERT INTO import_archive (id, batch_id, source_kind, source_locator_hash, source_label, byte_size,
24
+ content_hash, snapshot_path, parser, status, redaction_state, discovered_at, imported_at)
25
+ VALUES (?, ?, ?, ?, ?, ?, ?, ?, ?, 'stored', 'not_scanned', ?, ?)`, id, input.batchId, input.sourceKind, locatorHash, input.sourceLabel ?? null, input.byteSize, input.contentHash, input.snapshotPath, input.parser, nowIso(), nowIso());
26
+ return { archive: this.requireById(id), created: true };
27
+ }
28
+ requireById(id) {
29
+ const row = this.db.get('SELECT * FROM import_archive WHERE id = ?', id);
30
+ if (!row)
31
+ throw err('E_NOT_FOUND', `导入档案不存在: ${id}`);
32
+ return mapArchive(row);
33
+ }
34
+ findById(id) {
35
+ const row = this.db.get('SELECT * FROM import_archive WHERE id = ?', id);
36
+ return row ? mapArchive(row) : null;
37
+ }
38
+ listByBatch(batchId) {
39
+ return this.db.all('SELECT * FROM import_archive WHERE batch_id = ? ORDER BY discovered_at, id', batchId).map(mapArchive);
40
+ }
41
+ list() {
42
+ return this.db.all('SELECT * FROM import_archive ORDER BY discovered_at DESC, id').map(mapArchive);
43
+ }
44
+ setStatus(id, status) {
45
+ this.db.run('UPDATE import_archive SET status = ? WHERE id = ?', status, id);
46
+ }
47
+ setRedactionState(id, state) {
48
+ this.db.run('UPDATE import_archive SET redaction_state = ? WHERE id = ?', state, id);
49
+ }
50
+ /** 条目登记:archive 内按 index 幂等。 */
51
+ addItem(input) {
52
+ this.checkWritable();
53
+ const existing = this.db.get('SELECT * FROM import_item WHERE archive_id = ? AND item_index = ?', input.archiveId, input.itemIndex);
54
+ if (existing)
55
+ return { item: mapItem(existing), created: false };
56
+ const id = uuidv7();
57
+ this.db.run(`INSERT INTO import_item (id, archive_id, item_index, content, content_hash, byte_offset, source_ref,
58
+ scan_state, scan_findings, batch_id, created_at)
59
+ VALUES (?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?)`, id, input.archiveId, input.itemIndex, input.content, sha256Hex(input.content), input.byteOffset ?? null, input.sourceRef ?? null, input.scanState ?? 'pending', input.scanFindings ?? null, input.batchId ?? null, nowIso());
60
+ this.db.run("UPDATE import_archive SET status = 'partially_indexed' WHERE id = ? AND status = 'stored'", input.archiveId);
61
+ return { item: this.requireItem(id), created: true };
62
+ }
63
+ requireItem(id) {
64
+ const row = this.db.get('SELECT * FROM import_item WHERE id = ?', id);
65
+ if (!row)
66
+ throw err('E_NOT_FOUND', `导入条目不存在: ${id}`);
67
+ return mapItem(row);
68
+ }
69
+ listItems(archiveId, filter = {}) {
70
+ const where = ['archive_id = ?'];
71
+ const params = [archiveId];
72
+ if (filter.batchId) {
73
+ where.push('batch_id = ?');
74
+ params.push(filter.batchId);
75
+ }
76
+ if (filter.scanState) {
77
+ where.push('scan_state = ?');
78
+ params.push(filter.scanState);
79
+ }
80
+ return this.db
81
+ .all(`SELECT * FROM import_item WHERE ${where.join(' AND ')} ORDER BY item_index`, ...params)
82
+ .map(mapItem);
83
+ }
84
+ /** 分批取件:按批次取待处理条目,供 onboarding 分批读取(任务 4.3)。 */
85
+ nextBatch(batchId, limit, states = ['clean']) {
86
+ const placeholders = states.map(() => '?').join(',');
87
+ return this.db
88
+ .all(`SELECT * FROM import_item WHERE batch_id = ? AND scan_state IN (${placeholders}) ORDER BY archive_id, item_index LIMIT ?`, batchId, ...states, limit)
89
+ .map(mapItem);
90
+ }
91
+ updateItemState(id, scanState, scanFindings, batchId) {
92
+ this.checkWritable();
93
+ this.db.run('UPDATE import_item SET scan_state = ?, scan_findings = IFNULL(?, scan_findings), batch_id = IFNULL(?, batch_id) WHERE id = ?', scanState, scanFindings ?? null, batchId ?? null, id);
94
+ }
95
+ counts() {
96
+ return {
97
+ archives: Number(this.db.scalar('SELECT COUNT(*) AS n FROM import_archive') ?? 0),
98
+ items: Number(this.db.scalar('SELECT COUNT(*) AS n FROM import_item') ?? 0),
99
+ blockedItems: Number(this.db.scalar("SELECT COUNT(*) AS n FROM import_item WHERE scan_state = 'blocked'") ?? 0),
100
+ };
101
+ }
102
+ }
103
+ function mapArchive(r) {
104
+ return {
105
+ id: r.id,
106
+ batchId: r.batch_id,
107
+ sourceKind: r.source_kind,
108
+ sourceLocatorHash: r.source_locator_hash,
109
+ sourceLabel: r.source_label ?? null,
110
+ byteSize: Number(r.byte_size),
111
+ contentHash: r.content_hash,
112
+ snapshotPath: r.snapshot_path,
113
+ parser: r.parser,
114
+ status: r.status,
115
+ redactionState: r.redaction_state,
116
+ discoveredAt: r.discovered_at,
117
+ importedAt: r.imported_at ?? null,
118
+ };
119
+ }
120
+ function mapItem(r) {
121
+ return {
122
+ id: r.id,
123
+ archiveId: r.archive_id,
124
+ itemIndex: Number(r.item_index),
125
+ content: r.content,
126
+ contentHash: r.content_hash,
127
+ byteOffset: r.byte_offset ?? null,
128
+ sourceRef: r.source_ref ?? null,
129
+ scanState: r.scan_state,
130
+ scanFindings: r.scan_findings ?? null,
131
+ batchId: r.batch_id ?? null,
132
+ createdAt: r.created_at,
133
+ };
134
+ }
135
+ //# sourceMappingURL=archives.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"archives.js","sourceRoot":"","sources":["../../../src/store/archives.ts"],"names":[],"mappings":"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"}
@@ -0,0 +1,57 @@
1
+ import { CairnDb } from './db.js';
2
+ export interface AuditDetail {
3
+ [k: string]: unknown;
4
+ }
5
+ /**
6
+ * 本地审计事件(design D10):记录计划、审批、配置备份、作用域排除、
7
+ * 恢复与错误类别。detail 绝不写入记忆正文和秘密——调用方负责。
8
+ */
9
+ export declare class AuditLog {
10
+ private readonly db;
11
+ constructor(db: CairnDb);
12
+ record(category: string, action: string, subject?: {
13
+ type?: string;
14
+ id?: string;
15
+ }, detail?: AuditDetail): string;
16
+ recent(limit?: number): {
17
+ id: string;
18
+ at: string;
19
+ category: string;
20
+ action: string;
21
+ subjectType: string | null;
22
+ subjectId: string | null;
23
+ detail: Record<string, unknown>;
24
+ }[];
25
+ countByCategory(): Record<string, number>;
26
+ /**
27
+ * 过滤查询(add-operation-audit):只读;limit 默认 50、上限 200;since 为 ISO 下界(含)。
28
+ */
29
+ list(filter?: {
30
+ category?: string;
31
+ action?: string;
32
+ since?: string;
33
+ limit?: number;
34
+ }): AuditRow[];
35
+ /**
36
+ * 保留期清理(add-operation-audit):只删可清理白名单类目的过期行。
37
+ * 白名单里只有 'operation'——治理类目从机制上不可能被删,未来新类目默认豁免。
38
+ */
39
+ pruneOperations(retentionDays: number): number;
40
+ }
41
+ export interface AuditRow {
42
+ id: string;
43
+ at: string;
44
+ category: string;
45
+ action: string;
46
+ subjectType: string | null;
47
+ subjectId: string | null;
48
+ detail: Record<string, unknown>;
49
+ }
50
+ /** 审计配置(add-operation-audit):env > <home>/config.json > 默认;非法值回落默认并告警。 */
51
+ export interface AuditConfig {
52
+ /** operation 类目是否留痕(治理类目不受影响)。 */
53
+ operations: boolean;
54
+ /** operation 类目保留天数。 */
55
+ retentionDays: number;
56
+ }
57
+ export declare function readAuditConfig(home: string): AuditConfig;
@@ -0,0 +1,131 @@
1
+ import { existsSync, readFileSync } from 'node:fs';
2
+ import { join } from 'node:path';
3
+ import { uuidv7 } from '../core/ids.js';
4
+ import { nowIso } from '../core/time.js';
5
+ /**
6
+ * 本地审计事件(design D10):记录计划、审批、配置备份、作用域排除、
7
+ * 恢复与错误类别。detail 绝不写入记忆正文和秘密——调用方负责。
8
+ */
9
+ export class AuditLog {
10
+ db;
11
+ constructor(db) {
12
+ this.db = db;
13
+ }
14
+ record(category, action, subject, detail = {}) {
15
+ const id = uuidv7();
16
+ 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));
17
+ return id;
18
+ }
19
+ recent(limit = 50) {
20
+ return this.db
21
+ .all('SELECT * FROM audit_event ORDER BY at DESC, id DESC LIMIT ?', limit)
22
+ .map((r) => ({
23
+ id: r.id,
24
+ at: r.at,
25
+ category: r.category,
26
+ action: r.action,
27
+ subjectType: r.subject_type ?? null,
28
+ subjectId: r.subject_id ?? null,
29
+ detail: safeParse(r.detail),
30
+ }));
31
+ }
32
+ countByCategory() {
33
+ const rows = this.db.all('SELECT category, COUNT(*) AS n FROM audit_event GROUP BY category');
34
+ const out = {};
35
+ for (const r of rows)
36
+ out[r.category] = Number(r.n);
37
+ return out;
38
+ }
39
+ /**
40
+ * 过滤查询(add-operation-audit):只读;limit 默认 50、上限 200;since 为 ISO 下界(含)。
41
+ */
42
+ list(filter = {}) {
43
+ const limit = Math.min(Math.max(Math.floor(Number(filter.limit) || 50), 1), 200);
44
+ const where = [];
45
+ const params = [];
46
+ if (filter.category) {
47
+ where.push('category = ?');
48
+ params.push(filter.category);
49
+ }
50
+ if (filter.action) {
51
+ where.push('action = ?');
52
+ params.push(filter.action);
53
+ }
54
+ if (filter.since) {
55
+ where.push('at >= ?');
56
+ params.push(filter.since);
57
+ }
58
+ const sql = `SELECT * FROM audit_event${where.length ? ' WHERE ' + where.join(' AND ') : ''} ORDER BY at DESC, id DESC LIMIT ?`;
59
+ return this.db
60
+ .all(sql, ...params, limit)
61
+ .map((r) => ({
62
+ id: r.id,
63
+ at: r.at,
64
+ category: r.category,
65
+ action: r.action,
66
+ subjectType: r.subject_type ?? null,
67
+ subjectId: r.subject_id ?? null,
68
+ detail: safeParse(r.detail),
69
+ }));
70
+ }
71
+ /**
72
+ * 保留期清理(add-operation-audit):只删可清理白名单类目的过期行。
73
+ * 白名单里只有 'operation'——治理类目从机制上不可能被删,未来新类目默认豁免。
74
+ */
75
+ pruneOperations(retentionDays) {
76
+ const days = Number.isFinite(retentionDays) && retentionDays > 0 ? retentionDays : 30;
77
+ const cutoff = new Date(Date.now() - days * 24 * 3600 * 1000).toISOString();
78
+ const whitelist = ['operation'];
79
+ const placeholders = whitelist.map(() => '?').join(',');
80
+ const res = this.db.run(`DELETE FROM audit_event WHERE category IN (${placeholders}) AND at < ?`, ...whitelist, cutoff);
81
+ return Number(res.changes);
82
+ }
83
+ }
84
+ export function readAuditConfig(home) {
85
+ const defaults = { operations: true, retentionDays: 30 };
86
+ const cfg = { ...defaults };
87
+ // 1) config.json(存在才读;坏文件静默回落——不阻塞打开库)
88
+ try {
89
+ const file = join(home, 'config.json');
90
+ if (existsSync(file)) {
91
+ const parsed = JSON.parse(readFileSync(file, 'utf8'));
92
+ const a = parsed?.audit;
93
+ if (a && typeof a === 'object') {
94
+ if (typeof a.operations === 'boolean')
95
+ cfg.operations = a.operations;
96
+ if (Number.isFinite(Number(a.retentionDays)) && Number(a.retentionDays) > 0) {
97
+ cfg.retentionDays = Number(a.retentionDays);
98
+ }
99
+ }
100
+ }
101
+ }
102
+ catch {
103
+ /* 坏文件回落默认 */
104
+ }
105
+ // 2) env 覆盖
106
+ const envOps = process.env['CAIRN_AUDIT_OPERATIONS'];
107
+ if (envOps !== undefined)
108
+ cfg.operations = envOps !== 'false' && envOps !== '0';
109
+ const envDaysRaw = process.env['CAIRN_AUDIT_RETENTION_DAYS'];
110
+ if (envDaysRaw !== undefined) {
111
+ const envDays = Number(envDaysRaw);
112
+ if (Number.isFinite(envDays) && envDays > 0)
113
+ cfg.retentionDays = envDays;
114
+ else {
115
+ cfg.retentionDays = defaults.retentionDays;
116
+ console.error(`[cairn] CAIRN_AUDIT_RETENTION_DAYS 非法(${envDaysRaw}),回落 ${defaults.retentionDays} 天`);
117
+ }
118
+ }
119
+ return cfg;
120
+ }
121
+ function safeParse(s) {
122
+ if (!s)
123
+ return {};
124
+ try {
125
+ return JSON.parse(s);
126
+ }
127
+ catch {
128
+ return { unparsable: true };
129
+ }
130
+ }
131
+ //# sourceMappingURL=audit.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"audit.js","sourceRoot":"","sources":["../../../src/store/audit.ts"],"names":[],"mappings":"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"}
@@ -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":"AAAA,OAAO,EAAE,SAAS,EAAE,YAAY,EAAE,QAAQ,EAAE,MAAM,EAAE,YAAY,EAAE,MAAM,SAAS,CAAC;AAClF,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AACpC,OAAO,EAAE,OAAO,EAAE,MAAM,SAAS,CAAC;AAClC,OAAO,EAAE,GAAG,EAAE,MAAM,mBAAmB,CAAC;AACxC,OAAO,EAAE,SAAS,EAAE,MAAM,iBAAiB,CAAC;AAU5C,MAAM,UAAU,WAAW,CAAC,EAAW;IACrC,MAAM,CAAC,GAAG,CAAC,CAAS,EAAU,EAAE,CAAC,MAAM,CAAC,EAAE,CAAC,MAAM,CAAC,6BAA6B,CAAC,EAAE,CAAC,IAAI,CAAC,CAAC,CAAC;IAC1F,OAAO;QACL,MAAM,EAAE,CAAC,CAAC,QAAQ,CAAC;QACnB,eAAe,EAAE,CAAC,CAAC,iBAAiB,CAAC;QACrC,cAAc,EAAE,CAAC,CAAC,gBAAgB,CAAC;QACnC,UAAU,EAAE,CAAC,CAAC,YAAY,CAAC;QAC3B,WAAW,EAAE,CAAC,CAAC,aAAa,CAAC;KAC9B,CAAC;AACJ,CAAC;AAED;;;GAGG;AACH,MAAM,UAAU,cAAc,CAAC,EAAW,EAAE,UAAkB;IAC5D,SAAS,CAAC,OAAO,CAAC,UAAU,CAAC,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC;IACpD,MAAM,CAAC,UAAU,EAAE,EAAE,KAAK,EAAE,IAAI,EAAE,CAAC,CAAC;IACpC,IAAI,CAAC;QACH,EAAE,CAAC,IAAI,CAAC,gBAAgB,UAAU,CAAC,OAAO,CAAC,KAAK,EAAE,GAAG,CAAC,CAAC,OAAO,CAAC,IAAI,EAAE,IAAI,CAAC,GAAG,CAAC,CAAC;IACjF,CAAC;IAAC,OAAO,CAAC,EAAE,CAAC;QACX,MAAM,GAAG,CAAC,MAAM,EAAE,SAAU,CAAW,CAAC,OAAO,EAAE,EAAE,EAAE,UAAU,EAAE,CAAC,CAAC;IACrE,CAAC;IACD,MAAM,IAAI,GAAG,kBAAkB,CAAC,UAAU,EAAE,EAAE,CAAC,CAAC;IAChD,OAAO,EAAE,IAAI,EAAE,IAAI,CAAC,IAAI,EAAE,KAAK,EAAE,IAAI,CAAC,KAAK,EAAE,MAAM,EAAE,IAAI,CAAC,MAAM,EAAE,MAAM,EAAE,IAAI,CAAC,MAAO,EAAE,CAAC;AAC3F,CAAC;AAED,MAAM,UAAU,kBAAkB,CAAC,UAAkB,EAAE,QAAkB;IACvE,MAAM,EAAE,GAAG,QAAQ,CAAC,UAAU,CAAC,CAAC;IAChC,IAAI,EAAE,CAAC,IAAI,GAAG,eAAe;QAAE,MAAM,GAAG,CAAC,MAAM,EAAE,cAAc,EAAE,EAAE,IAAI,EAAE,UAAU,EAAE,KAAK,EAAE,EAAE,CAAC,IAAI,EAAE,CAAC,CAAC;IACvG,OAAO;QACL,IAAI,EAAE,UAAU;QAChB,KAAK,EAAE,EAAE,CAAC,IAAI;QACd,MAAM,EAAE,SAAS,CAAC,YAAY,CAAC,UAAU,CAAC,CAAC;QAC3C,GAAG,CAAC,QAAQ,CAAC,CAAC,CAAC,EAAE,MAAM,EAAE,WAAW,CAAC,QAAQ,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;KACvD,CAAC;AACJ,CAAC;AAED,MAAM,eAAe,GAAG,GAAG,GAAG,IAAI,GAAG,IAAI,CAAC;AAE1C,+BAA+B;AAC/B,MAAM,UAAU,YAAY,CAAC,UAAkB,EAAE,QAAgC;IAC/E,MAAM,QAAQ,GAAa,EAAE,CAAC;IAC9B,IAAI,EAAE,GAAmB,IAAI,CAAC;IAC9B,IAAI,CAAC;QACH,IAAI,CAAC;YACH,EAAE,GAAG,OAAO,CAAC,IAAI,CAAC,UAAU,EAAE,EAAE,QAAQ,EAAE,IAAI,EAAE,CAAC,CAAC;QACpD,CAAC;QAAC,OAAO,CAAC,EAAE,CAAC;YACX,OAAO,EAAE,EAAE,EAAE,KAAK,EAAE,QAAQ,EAAE,CAAC,WAAY,CAAW,CAAC,OAAO,EAAE,CAAC,EAAE,CAAC;QACtE,CAAC;QACD,IAAI,WAAW,GAAG,KAAK,CAAC;QACxB,IAAI,CAAC;YACH,WAAW,GAAG,EAAE,CAAC,cAAc,EAAE,CAAC;QACpC,CAAC;QAAC,OAAO,CAAC,EAAE,CAAC;YACX,OAAO,EAAE,EAAE,EAAE,KAAK,EAAE,QAAQ,EAAE,CAAC,kBAAmB,CAAW,CAAC,OAAO,EAAE,CAAC,EAAE,CAAC;QAC7E,CAAC;QACD,IAAI,CAAC,WAAW;YAAE,QAAQ,CAAC,IAAI,CAAC,qBAAqB,CAAC,CAAC;QACvD,MAAM,MAAM,GAAG,WAAW,CAAC,EAAE,CAAC,CAAC;QAC/B,KAAK,MAAM,CAAC,CAAC,EAAE,CAAC,CAAC,IAAI,MAAM,CAAC,OAAO,CAAC,QAAQ,IAAI,EAAE,CAAC,EAAE,CAAC;YACpD,IAAI,CAAC,IAAI,IAAI,IAAI,MAAM,CAAC,CAAuB,CAAC,KAAK,CAAC,EAAE,CAAC;gBACvD,QAAQ,CAAC,IAAI,CAAC,GAAG,CAAC,cAAc,MAAM,CAAC,CAAuB,CAAC,UAAU,CAAC,EAAE,CAAC,CAAC;YAChF,CAAC;QACH,CAAC;QACD,OAAO,EAAE,EAAE,EAAE,QAAQ,CAAC,MAAM,KAAK,CAAC,EAAE,MAAM,EAAE,QAAQ,EAAE,CAAC;IACzD,CAAC;YAAS,CAAC;QACT,EAAE,EAAE,KAAK,EAAE,CAAC;IACd,CAAC;AACH,CAAC;AAED,mCAAmC;AACnC,MAAM,UAAU,iBAAiB,CAAC,UAAkB,EAAE,MAAc;IAClE,MAAM,GAAG,GAAG,YAAY,CAAC,UAAU,CAAC,CAAC;IACrC,IAAI,CAAC,GAAG,CAAC,EAAE,EAAE,CAAC;QACZ,MAAM,GAAG,CAAC,kBAAkB,EAAE,gBAAgB,GAAG,CAAC,QAAQ,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,EAAE,EAAE,UAAU,EAAE,CAAC,CAAC;IAC3F,CAAC;IACD,SAAS,CAAC,OAAO,CAAC,MAAM,CAAC,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC;IAChD,YAAY,CAAC,UAAU,EAAE,MAAM,CAAC,CAAC;IACjC,MAAM,IAAI,GAAG,YAAY,CAAC,MAAM,EAAE,GAAG,CAAC,MAAM,CAAC,CAAC;IAC9C,IAAI,CAAC,IAAI,CAAC,EAAE,EAAE,CAAC;QACb,MAAM,GAAG,CAAC,kBAAkB,EAAE,YAAY,IAAI,CAAC,QAAQ,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,EAAE,EAAE,MAAM,EAAE,CAAC,CAAC;IACpF,CAAC;IACD,OAAO,EAAE,QAAQ,EAAE,IAAI,EAAE,YAAY,EAAE,IAAI,EAAE,CAAC;AAChD,CAAC"}
@@ -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
+ }