@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.
- package/CHANGELOG.md +54 -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 +133 -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/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 +242 -0
- package/dist/src/interfaces/app-service.js +614 -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 +790 -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 +412 -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 +77 -0
- package/dist/src/projection/brief.js +111 -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 +26 -0
- package/dist/src/store/audit.js +48 -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 +101 -0
- package/dist/src/store/memories.js +378 -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 +86 -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 +177 -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 +34 -0
- package/dist/src/store/schema.js +527 -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 +254 -0
- package/docs/cairn-usage.md +821 -0
- 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;
|