@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.
- package/CHANGELOG.md +81 -0
- package/LICENSE +21 -0
- package/README.md +158 -2
- package/dist/src/agents/adapters.d.ts +82 -0
- package/dist/src/agents/adapters.js +209 -0
- package/dist/src/agents/adapters.js.map +1 -0
- package/dist/src/agents/config.d.ts +82 -0
- package/dist/src/agents/config.js +603 -0
- package/dist/src/agents/config.js.map +1 -0
- package/dist/src/agents/cordisPatch.d.ts +89 -0
- package/dist/src/agents/cordisPatch.js +201 -0
- package/dist/src/agents/cordisPatch.js.map +1 -0
- package/dist/src/agents/index.d.ts +2 -0
- package/dist/src/agents/index.js +3 -0
- package/dist/src/agents/index.js.map +1 -0
- package/dist/src/core/errors.d.ts +36 -0
- package/dist/src/core/errors.js +74 -0
- package/dist/src/core/errors.js.map +1 -0
- package/dist/src/core/hash.d.ts +14 -0
- package/dist/src/core/hash.js +48 -0
- package/dist/src/core/hash.js.map +1 -0
- package/dist/src/core/ids.d.ts +10 -0
- package/dist/src/core/ids.js +41 -0
- package/dist/src/core/ids.js.map +1 -0
- package/dist/src/core/index.d.ts +6 -0
- package/dist/src/core/index.js +7 -0
- package/dist/src/core/index.js.map +1 -0
- package/dist/src/core/scope.d.ts +78 -0
- package/dist/src/core/scope.js +181 -0
- package/dist/src/core/scope.js.map +1 -0
- package/dist/src/core/secrets.d.ts +13 -0
- package/dist/src/core/secrets.js +122 -0
- package/dist/src/core/secrets.js.map +1 -0
- package/dist/src/core/time.d.ts +7 -0
- package/dist/src/core/time.js +18 -0
- package/dist/src/core/time.js.map +1 -0
- package/dist/src/core/types.d.ts +139 -0
- package/dist/src/core/types.js +30 -0
- package/dist/src/core/types.js.map +1 -0
- package/dist/src/governance/apply.d.ts +64 -0
- package/dist/src/governance/apply.js +160 -0
- package/dist/src/governance/apply.js.map +1 -0
- package/dist/src/governance/archive.d.ts +29 -0
- package/dist/src/governance/archive.js +52 -0
- package/dist/src/governance/archive.js.map +1 -0
- package/dist/src/governance/dedup.d.ts +21 -0
- package/dist/src/governance/dedup.js +23 -0
- package/dist/src/governance/dedup.js.map +1 -0
- package/dist/src/governance/index.d.ts +16 -0
- package/dist/src/governance/index.js +17 -0
- package/dist/src/governance/index.js.map +1 -0
- package/dist/src/governance/propose.d.ts +78 -0
- package/dist/src/governance/propose.js +150 -0
- package/dist/src/governance/propose.js.map +1 -0
- package/dist/src/index.d.ts +15 -0
- package/dist/src/index.js +24 -0
- package/dist/src/index.js.map +1 -0
- package/dist/src/interfaces/app-service.d.ts +292 -0
- package/dist/src/interfaces/app-service.js +743 -0
- package/dist/src/interfaces/app-service.js.map +1 -0
- package/dist/src/interfaces/cli/main.d.ts +2 -0
- package/dist/src/interfaces/cli/main.js +854 -0
- package/dist/src/interfaces/cli/main.js.map +1 -0
- package/dist/src/interfaces/console/assets/page.d.ts +18 -0
- package/dist/src/interfaces/console/assets/page.js +39 -0
- package/dist/src/interfaces/console/assets/page.js.map +1 -0
- package/dist/src/interfaces/console/assets/ui-css.d.ts +11 -0
- package/dist/src/interfaces/console/assets/ui-css.js +119 -0
- package/dist/src/interfaces/console/assets/ui-css.js.map +1 -0
- package/dist/src/interfaces/console/assets/ui-js.d.ts +14 -0
- package/dist/src/interfaces/console/assets/ui-js.js +1098 -0
- package/dist/src/interfaces/console/assets/ui-js.js.map +1 -0
- package/dist/src/interfaces/console/assets/url-state.d.ts +9 -0
- package/dist/src/interfaces/console/assets/url-state.js +45 -0
- package/dist/src/interfaces/console/assets/url-state.js.map +1 -0
- package/dist/src/interfaces/console/export.d.ts +46 -0
- package/dist/src/interfaces/console/export.js +84 -0
- package/dist/src/interfaces/console/export.js.map +1 -0
- package/dist/src/interfaces/console/model.d.ts +372 -0
- package/dist/src/interfaces/console/model.js +731 -0
- package/dist/src/interfaces/console/model.js.map +1 -0
- package/dist/src/interfaces/console/review-store.d.ts +142 -0
- package/dist/src/interfaces/console/review-store.js +342 -0
- package/dist/src/interfaces/console/review-store.js.map +1 -0
- package/dist/src/interfaces/console/security.d.ts +76 -0
- package/dist/src/interfaces/console/security.js +105 -0
- package/dist/src/interfaces/console/security.js.map +1 -0
- package/dist/src/interfaces/console/server.d.ts +45 -0
- package/dist/src/interfaces/console/server.js +476 -0
- package/dist/src/interfaces/console/server.js.map +1 -0
- package/dist/src/interfaces/console/suggestions.d.ts +112 -0
- package/dist/src/interfaces/console/suggestions.js +511 -0
- package/dist/src/interfaces/console/suggestions.js.map +1 -0
- package/dist/src/interfaces/console/text.d.ts +4 -0
- package/dist/src/interfaces/console/text.js +18 -0
- package/dist/src/interfaces/console/text.js.map +1 -0
- package/dist/src/interfaces/mcp/server.d.ts +4 -0
- package/dist/src/interfaces/mcp/server.js +480 -0
- package/dist/src/interfaces/mcp/server.js.map +1 -0
- package/dist/src/jobs/index.d.ts +6 -0
- package/dist/src/jobs/index.js +7 -0
- package/dist/src/jobs/index.js.map +1 -0
- package/dist/src/jobs/remote.d.ts +42 -0
- package/dist/src/jobs/remote.js +34 -0
- package/dist/src/jobs/remote.js.map +1 -0
- package/dist/src/jobs/worker.d.ts +67 -0
- package/dist/src/jobs/worker.js +169 -0
- package/dist/src/jobs/worker.js.map +1 -0
- package/dist/src/onboarding/auto.d.ts +88 -0
- package/dist/src/onboarding/auto.js +399 -0
- package/dist/src/onboarding/auto.js.map +1 -0
- package/dist/src/onboarding/batches.d.ts +103 -0
- package/dist/src/onboarding/batches.js +219 -0
- package/dist/src/onboarding/batches.js.map +1 -0
- package/dist/src/onboarding/discover.d.ts +54 -0
- package/dist/src/onboarding/discover.js +369 -0
- package/dist/src/onboarding/discover.js.map +1 -0
- package/dist/src/onboarding/import.d.ts +69 -0
- package/dist/src/onboarding/import.js +279 -0
- package/dist/src/onboarding/import.js.map +1 -0
- package/dist/src/onboarding/index.d.ts +24 -0
- package/dist/src/onboarding/index.js +22 -0
- package/dist/src/onboarding/index.js.map +1 -0
- package/dist/src/onboarding/judgement.d.ts +50 -0
- package/dist/src/onboarding/judgement.js +121 -0
- package/dist/src/onboarding/judgement.js.map +1 -0
- package/dist/src/onboarding/policy.d.ts +86 -0
- package/dist/src/onboarding/policy.js +249 -0
- package/dist/src/onboarding/policy.js.map +1 -0
- package/dist/src/projection/brief.d.ts +112 -0
- package/dist/src/projection/brief.js +200 -0
- package/dist/src/projection/brief.js.map +1 -0
- package/dist/src/projection/index.d.ts +1 -0
- package/dist/src/projection/index.js +2 -0
- package/dist/src/projection/index.js.map +1 -0
- package/dist/src/projection/markdown.d.ts +82 -0
- package/dist/src/projection/markdown.js +313 -0
- package/dist/src/projection/markdown.js.map +1 -0
- package/dist/src/retrieval/export.d.ts +80 -0
- package/dist/src/retrieval/export.js +215 -0
- package/dist/src/retrieval/export.js.map +1 -0
- package/dist/src/retrieval/index.d.ts +5 -0
- package/dist/src/retrieval/index.js +6 -0
- package/dist/src/retrieval/index.js.map +1 -0
- package/dist/src/retrieval/search.d.ts +37 -0
- package/dist/src/retrieval/search.js +294 -0
- package/dist/src/retrieval/search.js.map +1 -0
- package/dist/src/store/archives.d.ts +94 -0
- package/dist/src/store/archives.js +135 -0
- package/dist/src/store/archives.js.map +1 -0
- package/dist/src/store/audit.d.ts +57 -0
- package/dist/src/store/audit.js +131 -0
- package/dist/src/store/audit.js.map +1 -0
- package/dist/src/store/backup.d.ts +36 -0
- package/dist/src/store/backup.js +90 -0
- package/dist/src/store/backup.js.map +1 -0
- package/dist/src/store/blocks.d.ts +64 -0
- package/dist/src/store/blocks.js +104 -0
- package/dist/src/store/blocks.js.map +1 -0
- package/dist/src/store/conflicts.d.ts +52 -0
- package/dist/src/store/conflicts.js +112 -0
- package/dist/src/store/conflicts.js.map +1 -0
- package/dist/src/store/db.d.ts +44 -0
- package/dist/src/store/db.js +162 -0
- package/dist/src/store/db.js.map +1 -0
- package/dist/src/store/device.d.ts +46 -0
- package/dist/src/store/device.js +111 -0
- package/dist/src/store/device.js.map +1 -0
- package/dist/src/store/index.d.ts +14 -0
- package/dist/src/store/index.js +15 -0
- package/dist/src/store/index.js.map +1 -0
- package/dist/src/store/memories.d.ts +133 -0
- package/dist/src/store/memories.js +442 -0
- package/dist/src/store/memories.js.map +1 -0
- package/dist/src/store/migrate.d.ts +32 -0
- package/dist/src/store/migrate.js +87 -0
- package/dist/src/store/migrate.js.map +1 -0
- package/dist/src/store/open.d.ts +53 -0
- package/dist/src/store/open.js +203 -0
- package/dist/src/store/open.js.map +1 -0
- package/dist/src/store/outbox.d.ts +65 -0
- package/dist/src/store/outbox.js +137 -0
- package/dist/src/store/outbox.js.map +1 -0
- package/dist/src/store/plans.d.ts +137 -0
- package/dist/src/store/plans.js +243 -0
- package/dist/src/store/plans.js.map +1 -0
- package/dist/src/store/schema.d.ts +46 -0
- package/dist/src/store/schema.js +544 -0
- package/dist/src/store/schema.js.map +1 -0
- package/dist/src/store/scopes.d.ts +44 -0
- package/dist/src/store/scopes.js +220 -0
- package/dist/src/store/scopes.js.map +1 -0
- package/dist/src/store/write-guard.d.ts +10 -0
- package/dist/src/store/write-guard.js +10 -0
- package/dist/src/store/write-guard.js.map +1 -0
- package/dist/src/sync/apply.d.ts +24 -0
- package/dist/src/sync/apply.js +130 -0
- package/dist/src/sync/apply.js.map +1 -0
- package/dist/src/sync/cryptoutil.d.ts +86 -0
- package/dist/src/sync/cryptoutil.js +339 -0
- package/dist/src/sync/cryptoutil.js.map +1 -0
- package/dist/src/sync/events.d.ts +69 -0
- package/dist/src/sync/events.js +78 -0
- package/dist/src/sync/events.js.map +1 -0
- package/dist/src/sync/obs-store.d.ts +41 -0
- package/dist/src/sync/obs-store.js +325 -0
- package/dist/src/sync/obs-store.js.map +1 -0
- package/dist/src/sync/orchestrate.d.ts +37 -0
- package/dist/src/sync/orchestrate.js +84 -0
- package/dist/src/sync/orchestrate.js.map +1 -0
- package/dist/src/sync/pull.d.ts +24 -0
- package/dist/src/sync/pull.js +150 -0
- package/dist/src/sync/pull.js.map +1 -0
- package/dist/src/sync/push.d.ts +19 -0
- package/dist/src/sync/push.js +227 -0
- package/dist/src/sync/push.js.map +1 -0
- package/dist/src/sync/syncd-store.d.ts +31 -0
- package/dist/src/sync/syncd-store.js +92 -0
- package/dist/src/sync/syncd-store.js.map +1 -0
- package/dist/src/sync/vault.d.ts +37 -0
- package/dist/src/sync/vault.js +53 -0
- package/dist/src/sync/vault.js.map +1 -0
- package/docs/cairn-security.md +267 -0
- package/docs/cairn-usage.md +919 -0
- 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":"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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
|
+
}
|