@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,378 @@
|
|
|
1
|
+
import { MEMORY_KINDS, MEMORY_STATUSES, AUTHORITIES, } from '../core/types.js';
|
|
2
|
+
import { err } from '../core/errors.js';
|
|
3
|
+
import { uuidv7 } from '../core/ids.js';
|
|
4
|
+
import { nowIso } from '../core/time.js';
|
|
5
|
+
import { normalizeContent, contentHash as contentHashOf, sha256Hex } from '../core/hash.js';
|
|
6
|
+
import { WriteGuardMixin } from './write-guard.js';
|
|
7
|
+
export class MemoryRepository extends WriteGuardMixin {
|
|
8
|
+
db;
|
|
9
|
+
constructor(db) {
|
|
10
|
+
super();
|
|
11
|
+
this.db = db;
|
|
12
|
+
}
|
|
13
|
+
add(input, deviceId) {
|
|
14
|
+
this.checkWritable();
|
|
15
|
+
validateMemoryInput(input);
|
|
16
|
+
const id = uuidv7();
|
|
17
|
+
const at = nowIso();
|
|
18
|
+
const normalized = normalizeContent(input.content);
|
|
19
|
+
const hash = contentHashOf(input.content);
|
|
20
|
+
const confidence = input.confidence ?? defaultConfidence(input.authority);
|
|
21
|
+
const sensitivity = input.sensitivity ?? 'normal';
|
|
22
|
+
this.db.transaction(() => {
|
|
23
|
+
this.db.run(`INSERT INTO memory (id, owner_id, kind, content, normalized_content, scope_id, status, authority,
|
|
24
|
+
confidence, source_agent, source_session_id, source_import_batch_id, source_message_range,
|
|
25
|
+
observed_at, valid_from, valid_to, expires_at, sensitivity, content_hash, created_by, created_at, updated_at)
|
|
26
|
+
VALUES (?, 'local-user', ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?)`, id, input.kind, input.content, normalized, input.scopeId, initialStatus(input.authority), input.authority, confidence, input.sourceAgent ?? null, input.sourceSessionId ?? null, input.sourceImportBatchId ?? null, input.sourceMessageRange ?? null, input.observedAt ?? at, input.validFrom ?? null, input.validTo ?? null, input.expiresAt ?? null, sensitivity, hash, input.createdBy, at, at);
|
|
27
|
+
const revId = uuidv7();
|
|
28
|
+
this.db.run(`INSERT INTO memory_revision (id, memory_id, seq, parent_revision_ids, content, content_hash, scope_id,
|
|
29
|
+
status, authority, author, device_id, reason, created_at)
|
|
30
|
+
VALUES (?, ?, 1, '[]', ?, ?, ?, ?, ?, ?, ?, ?, ?)`, revId, id, input.content, hash, input.scopeId, initialStatus(input.authority), input.authority, input.createdBy, deviceId, null, at);
|
|
31
|
+
this.db.run('UPDATE memory SET current_revision_id = ? WHERE id = ?', revId, id);
|
|
32
|
+
this.insertEvidence(id, revId, input.evidence ?? []);
|
|
33
|
+
});
|
|
34
|
+
return this.require(id);
|
|
35
|
+
}
|
|
36
|
+
get(id) {
|
|
37
|
+
const row = this.db.get('SELECT * FROM memory WHERE id = ?', id);
|
|
38
|
+
return row ? mapMemory(row) : null;
|
|
39
|
+
}
|
|
40
|
+
require(id) {
|
|
41
|
+
const m = this.get(id);
|
|
42
|
+
if (!m)
|
|
43
|
+
throw err('E_NOT_FOUND', `记忆不存在: ${id}`);
|
|
44
|
+
return m;
|
|
45
|
+
}
|
|
46
|
+
/**
|
|
47
|
+
* 用户更正(任务 2.1):新修订 + supersedes 历史;expected 不匹配时
|
|
48
|
+
* 抛 E_TARGET_CHANGED(目标在批准后变化则拒绝过期计划,spec memory-governance)。
|
|
49
|
+
*/
|
|
50
|
+
revise(id, newContent, opts, deviceId) {
|
|
51
|
+
this.checkWritable();
|
|
52
|
+
const mem = this.require(id);
|
|
53
|
+
if (mem.status === 'tombstoned')
|
|
54
|
+
throw err('E_CONFLICT_STATE', '已遗忘的记忆不能修改');
|
|
55
|
+
const at = nowIso();
|
|
56
|
+
const hash = contentHashOf(newContent);
|
|
57
|
+
return this.db.transaction(() => {
|
|
58
|
+
const cur = this.db.get('SELECT current_revision_id FROM memory WHERE id = ?', id);
|
|
59
|
+
const currentRevId = cur.current_revision_id;
|
|
60
|
+
if (opts.expectedCurrentRevisionId && currentRevId !== opts.expectedCurrentRevisionId) {
|
|
61
|
+
throw err('E_TARGET_CHANGED', '记忆在计划批准后产生了新修订,拒绝基于过期目标应用', {
|
|
62
|
+
memoryId: id,
|
|
63
|
+
expected: opts.expectedCurrentRevisionId,
|
|
64
|
+
actual: currentRevId,
|
|
65
|
+
});
|
|
66
|
+
}
|
|
67
|
+
const seqRow = this.db.get('SELECT MAX(seq) AS s FROM memory_revision WHERE memory_id = ?', id);
|
|
68
|
+
const seq = Number(seqRow?.s ?? 0) + 1;
|
|
69
|
+
const revId = uuidv7();
|
|
70
|
+
const newStatus = mem.status === 'conflicted' ? 'conflicted' : 'active';
|
|
71
|
+
this.db.run(`INSERT INTO memory_revision (id, memory_id, seq, parent_revision_ids, content, content_hash, scope_id,
|
|
72
|
+
status, authority, author, device_id, reason, created_at)
|
|
73
|
+
VALUES (?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?)`, revId, id, seq, JSON.stringify(currentRevId ? [currentRevId] : []), newContent, hash, mem.scopeId, newStatus, mem.authority, opts.author, deviceId, opts.reason ?? null, at);
|
|
74
|
+
this.db.run(`UPDATE memory SET current_revision_id = ?, content = ?, normalized_content = ?, content_hash = ?,
|
|
75
|
+
status = ?, expires_at = IFNULL(?, expires_at), sensitivity = IFNULL(?, sensitivity), updated_at = ? WHERE id = ?`, revId, newContent, normalizeContent(newContent), hash, newStatus, opts.expiresAt ?? null, opts.sensitivity ?? null, at, id);
|
|
76
|
+
return { memory: this.require(id), revision: this.requireRevision(revId) };
|
|
77
|
+
});
|
|
78
|
+
}
|
|
79
|
+
/** 候选晋升(真实审批后由治理层调用;agent_inferred/imported 不能静默变 active)。 */
|
|
80
|
+
promoteToActive(id, authority, by) {
|
|
81
|
+
this.checkWritable();
|
|
82
|
+
const mem = this.require(id);
|
|
83
|
+
if (mem.status !== 'candidate')
|
|
84
|
+
throw err('E_CONFLICT_STATE', `只有候选可晋升,当前 ${mem.status}`);
|
|
85
|
+
if (authority === 'agent_inferred' || authority === 'imported_unverified') {
|
|
86
|
+
throw err('E_FORBIDDEN', '不允许把候选晋升回推断/未验证权威');
|
|
87
|
+
}
|
|
88
|
+
this.db.run("UPDATE memory SET status = 'active', authority = ?, updated_at = ? WHERE id = ?", authority, nowIso(), id);
|
|
89
|
+
this.db.run('UPDATE memory_revision SET status = ?, authority = ? WHERE id = ?', 'active', authority, mem.currentRevisionId ?? '');
|
|
90
|
+
return this.require(id);
|
|
91
|
+
}
|
|
92
|
+
archive(id) {
|
|
93
|
+
this.require(id);
|
|
94
|
+
this.db.run("UPDATE memory SET status = 'archived', updated_at = ? WHERE id = ?", nowIso(), id);
|
|
95
|
+
return this.require(id);
|
|
96
|
+
}
|
|
97
|
+
/** 遗忘(任务 2.1/2.5):tombstone 可审计,被遗忘内容退出活动结果与投影。 */
|
|
98
|
+
forget(id, reason, by) {
|
|
99
|
+
this.checkWritable();
|
|
100
|
+
const mem = this.require(id);
|
|
101
|
+
if (mem.status === 'tombstoned')
|
|
102
|
+
return mem;
|
|
103
|
+
const at = nowIso();
|
|
104
|
+
this.db.transaction(() => {
|
|
105
|
+
this.db.run(`INSERT INTO tombstone (id, memory_id, reason, forgotten_by, forgotten_at, content_hash) VALUES (?, ?, ?, ?, ?, ?)`, uuidv7(), id, reason, by, at, mem.contentHash);
|
|
106
|
+
this.db.run("UPDATE memory SET status = 'tombstoned', updated_at = ? WHERE id = ?", at, id);
|
|
107
|
+
});
|
|
108
|
+
return this.require(id);
|
|
109
|
+
}
|
|
110
|
+
getTombstone(memoryId) {
|
|
111
|
+
const row = this.db.get('SELECT * FROM tombstone WHERE memory_id = ? ORDER BY forgotten_at DESC LIMIT 1', memoryId);
|
|
112
|
+
if (!row)
|
|
113
|
+
return null;
|
|
114
|
+
return {
|
|
115
|
+
id: row.id,
|
|
116
|
+
reason: row.reason ?? null,
|
|
117
|
+
forgottenBy: row.forgotten_by,
|
|
118
|
+
forgottenAt: row.forgotten_at,
|
|
119
|
+
contentHash: row.content_hash,
|
|
120
|
+
};
|
|
121
|
+
}
|
|
122
|
+
resolveCurrent(id) {
|
|
123
|
+
const mem = this.get(id);
|
|
124
|
+
if (!mem || !mem.currentRevisionId)
|
|
125
|
+
return null;
|
|
126
|
+
return { memory: mem, revision: this.requireRevision(mem.currentRevisionId) };
|
|
127
|
+
}
|
|
128
|
+
revisions(id) {
|
|
129
|
+
return this.db
|
|
130
|
+
.all('SELECT * FROM memory_revision WHERE memory_id = ? ORDER BY seq', id)
|
|
131
|
+
.map(mapRevision);
|
|
132
|
+
}
|
|
133
|
+
requireRevision(revId) {
|
|
134
|
+
const row = this.db.get('SELECT * FROM memory_revision WHERE id = ?', revId);
|
|
135
|
+
if (!row)
|
|
136
|
+
throw err('E_NOT_FOUND', `修订不存在: ${revId}`);
|
|
137
|
+
return mapRevision(row);
|
|
138
|
+
}
|
|
139
|
+
evidence(memoryId) {
|
|
140
|
+
return this.db.all('SELECT * FROM evidence WHERE memory_id = ? ORDER BY created_at, id', memoryId).map(mapEvidence);
|
|
141
|
+
}
|
|
142
|
+
/** 记忆间关系:supersedes / contradicts / related_to(首版仅三种)。 */
|
|
143
|
+
addRelation(fromMemoryId, toMemoryId, type) {
|
|
144
|
+
if (fromMemoryId === toMemoryId)
|
|
145
|
+
throw err('E_VALIDATION', '关系两端不能是同一记忆');
|
|
146
|
+
this.require(fromMemoryId);
|
|
147
|
+
this.require(toMemoryId);
|
|
148
|
+
const existing = this.db.get('SELECT id FROM relation WHERE from_memory_id = ? AND to_memory_id = ? AND relation_type = ?', fromMemoryId, toMemoryId, type);
|
|
149
|
+
if (existing)
|
|
150
|
+
return existing.id;
|
|
151
|
+
const id = uuidv7();
|
|
152
|
+
this.db.run('INSERT INTO relation (id, from_memory_id, to_memory_id, relation_type, created_at) VALUES (?, ?, ?, ?, ?)', id, fromMemoryId, toMemoryId, type, nowIso());
|
|
153
|
+
return id;
|
|
154
|
+
}
|
|
155
|
+
relationsOf(memoryId) {
|
|
156
|
+
return this.db
|
|
157
|
+
.all('SELECT * FROM relation WHERE from_memory_id = ? OR to_memory_id = ?', memoryId, memoryId)
|
|
158
|
+
.map((r) => ({
|
|
159
|
+
id: r.id,
|
|
160
|
+
fromMemoryId: r.from_memory_id,
|
|
161
|
+
toMemoryId: r.to_memory_id,
|
|
162
|
+
relationType: r.relation_type,
|
|
163
|
+
}));
|
|
164
|
+
}
|
|
165
|
+
addEvidence(memoryId, revisionId, input) {
|
|
166
|
+
const id = uuidv7();
|
|
167
|
+
this.db.run(`INSERT INTO evidence (id, memory_id, revision_id, evidence_kind, source_agent, session_id, import_archive_id,
|
|
168
|
+
locator, excerpt_hash, trust_level, created_at)
|
|
169
|
+
VALUES (?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?)`, id, memoryId, revisionId, input.evidenceKind, input.sourceAgent ?? null, input.sessionId ?? null, input.importArchiveId ?? null, input.locator ?? null, input.excerptHash ?? null, input.trustLevel, nowIso());
|
|
170
|
+
const row = this.db.get('SELECT * FROM evidence WHERE id = ?', id);
|
|
171
|
+
return mapEvidence(row);
|
|
172
|
+
}
|
|
173
|
+
list(filter = {}) {
|
|
174
|
+
const where = [];
|
|
175
|
+
const params = [];
|
|
176
|
+
if (filter.scopeId) {
|
|
177
|
+
where.push('scope_id = ?');
|
|
178
|
+
params.push(filter.scopeId);
|
|
179
|
+
}
|
|
180
|
+
if (filter.status) {
|
|
181
|
+
where.push('status = ?');
|
|
182
|
+
params.push(filter.status);
|
|
183
|
+
}
|
|
184
|
+
else if (filter.statuses) {
|
|
185
|
+
where.push(`status IN (${filter.statuses.map(() => '?').join(',')})`);
|
|
186
|
+
params.push(...filter.statuses);
|
|
187
|
+
}
|
|
188
|
+
if (filter.kind) {
|
|
189
|
+
where.push('kind = ?');
|
|
190
|
+
params.push(filter.kind);
|
|
191
|
+
}
|
|
192
|
+
if (filter.authority) {
|
|
193
|
+
where.push('authority = ?');
|
|
194
|
+
params.push(filter.authority);
|
|
195
|
+
}
|
|
196
|
+
if (filter.sourceImportBatchId) {
|
|
197
|
+
where.push('source_import_batch_id = ?');
|
|
198
|
+
params.push(filter.sourceImportBatchId);
|
|
199
|
+
}
|
|
200
|
+
const sql = `SELECT * FROM memory ${where.length ? 'WHERE ' + where.join(' AND ') : ''} ORDER BY updated_at DESC, id LIMIT ? OFFSET ?`;
|
|
201
|
+
params.push(filter.limit ?? 200, filter.offset ?? 0);
|
|
202
|
+
return this.db.all(sql, ...params).map(mapMemory);
|
|
203
|
+
}
|
|
204
|
+
/** 内容去重查找(同 scope 同规范化哈希)。 */
|
|
205
|
+
findByContentHash(scopeId, hash) {
|
|
206
|
+
const row = this.db.get("SELECT * FROM memory WHERE scope_id = ? AND content_hash = ? AND status NOT IN ('tombstoned','superseded') ORDER BY updated_at DESC LIMIT 1", scopeId, hash);
|
|
207
|
+
return row ? mapMemory(row) : null;
|
|
208
|
+
}
|
|
209
|
+
/** 跨设备记忆身份对齐:任一修订内容哈希命中即视为同一记忆(本地 id 不可跨设备引用)。 */
|
|
210
|
+
findMemoryIdByRevisionHashes(hashes) {
|
|
211
|
+
if (hashes.length === 0)
|
|
212
|
+
return null;
|
|
213
|
+
const placeholders = hashes.map(() => '?').join(',');
|
|
214
|
+
const row = this.db.get(`SELECT memory_id FROM memory_revision WHERE content_hash IN (${placeholders}) LIMIT 1`, ...hashes);
|
|
215
|
+
return row ? row.memory_id : null;
|
|
216
|
+
}
|
|
217
|
+
/** 修订级内容哈希查找(同步对账用:远端事件的 parent_hash 对齐到本地修订)。 */
|
|
218
|
+
findRevisionByContentHash(memoryId, hash) {
|
|
219
|
+
const row = this.db.get('SELECT * FROM memory_revision WHERE memory_id = ? AND content_hash = ? ORDER BY seq DESC LIMIT 1', memoryId, hash);
|
|
220
|
+
return row ? mapRevision(row) : null;
|
|
221
|
+
}
|
|
222
|
+
/**
|
|
223
|
+
* 应用远端修订(同步拉取专用):插入为该记忆的下一条本地修订,
|
|
224
|
+
* 不推进 current_revision_id——推进与否由冲突/快进判定决定
|
|
225
|
+
* (sync 层随后显式 revise 或记录冲突)。
|
|
226
|
+
*/
|
|
227
|
+
insertRemoteRevision(memoryId, input, deviceId) {
|
|
228
|
+
this.checkWritable();
|
|
229
|
+
const mem = this.require(memoryId);
|
|
230
|
+
const at = nowIso();
|
|
231
|
+
const seqRow = this.db.get('SELECT MAX(seq) AS s FROM memory_revision WHERE memory_id = ?', memoryId);
|
|
232
|
+
const seq = Number(seqRow?.s ?? 0) + 1;
|
|
233
|
+
const revId = uuidv7();
|
|
234
|
+
this.db.run(`INSERT INTO memory_revision (id, memory_id, seq, parent_revision_ids, content, content_hash, scope_id,
|
|
235
|
+
status, authority, author, device_id, reason, created_at)
|
|
236
|
+
VALUES (?, ?, ?, ?, ?, ?, ?, 'active', ?, ?, ?, ?, ?)`, revId, memoryId, seq, JSON.stringify(input.parentLocalRevisionId ? [input.parentLocalRevisionId] : []), input.content, input.contentHash, mem.scopeId, mem.authority, input.author, deviceId, input.reason, at);
|
|
237
|
+
void input.baseRevisionId;
|
|
238
|
+
return this.requireRevision(revId);
|
|
239
|
+
}
|
|
240
|
+
countsByStatus() {
|
|
241
|
+
const out = Object.fromEntries(MEMORY_STATUSES.map((s) => [s, 0]));
|
|
242
|
+
for (const r of this.db.all('SELECT status, COUNT(*) AS n FROM memory GROUP BY status')) {
|
|
243
|
+
out[r.status] = Number(r.n);
|
|
244
|
+
}
|
|
245
|
+
return out;
|
|
246
|
+
}
|
|
247
|
+
markUsed(id, at = nowIso()) {
|
|
248
|
+
this.db.run('UPDATE memory SET last_used_at = ? WHERE id = ?', at, id);
|
|
249
|
+
}
|
|
250
|
+
touchVerified(id, at = nowIso()) {
|
|
251
|
+
this.db.run('UPDATE memory SET last_verified_at = ?, updated_at = ? WHERE id = ?', at, at, id);
|
|
252
|
+
}
|
|
253
|
+
insertEvidence(memoryId, revisionId, list) {
|
|
254
|
+
for (const ev of list) {
|
|
255
|
+
this.addEvidence(memoryId, revisionId, ev);
|
|
256
|
+
}
|
|
257
|
+
}
|
|
258
|
+
}
|
|
259
|
+
/** authority → 初始状态:显式/确认即 active;推断/导入保持候选(spec memory-governance)。 */
|
|
260
|
+
export function initialStatus(authority) {
|
|
261
|
+
switch (authority) {
|
|
262
|
+
case 'user_explicit':
|
|
263
|
+
case 'user_confirmed':
|
|
264
|
+
return 'active';
|
|
265
|
+
case 'agent_inferred':
|
|
266
|
+
case 'imported_unverified':
|
|
267
|
+
return 'candidate';
|
|
268
|
+
default: {
|
|
269
|
+
const exhaustive = authority;
|
|
270
|
+
throw err('E_VALIDATION', `未知权威级别 ${String(exhaustive)}`);
|
|
271
|
+
}
|
|
272
|
+
}
|
|
273
|
+
}
|
|
274
|
+
function defaultConfidence(authority) {
|
|
275
|
+
switch (authority) {
|
|
276
|
+
case 'user_explicit':
|
|
277
|
+
return 1;
|
|
278
|
+
case 'user_confirmed':
|
|
279
|
+
return 0.9;
|
|
280
|
+
case 'agent_inferred':
|
|
281
|
+
return 0.5;
|
|
282
|
+
case 'imported_unverified':
|
|
283
|
+
return 0.3;
|
|
284
|
+
}
|
|
285
|
+
}
|
|
286
|
+
export function validateMemoryInput(input) {
|
|
287
|
+
const problems = [];
|
|
288
|
+
if (!MEMORY_KINDS.includes(input.kind))
|
|
289
|
+
problems.push(`kind 非法: ${input.kind}`);
|
|
290
|
+
if (!AUTHORITIES.includes(input.authority))
|
|
291
|
+
problems.push(`authority 非法: ${input.authority}`);
|
|
292
|
+
if (typeof input.content !== 'string' || input.content.trim().length === 0)
|
|
293
|
+
problems.push('content 不能为空');
|
|
294
|
+
if (input.content.length > 1_000_000)
|
|
295
|
+
problems.push('content 超过 1MB 上限');
|
|
296
|
+
if (input.kind === 'instruction' && input.authority !== 'user_explicit' && input.authority !== 'user_confirmed') {
|
|
297
|
+
problems.push('instruction 只能来自 user_explicit / user_confirmed');
|
|
298
|
+
}
|
|
299
|
+
if (input.confidence != null && (input.confidence < 0 || input.confidence > 1))
|
|
300
|
+
problems.push('confidence 必须在 [0,1]');
|
|
301
|
+
if (problems.length > 0)
|
|
302
|
+
throw err('E_VALIDATION', `记忆写入校验失败: ${problems.join('; ')}`, { problems });
|
|
303
|
+
}
|
|
304
|
+
export function mapMemory(r) {
|
|
305
|
+
return {
|
|
306
|
+
id: r.id,
|
|
307
|
+
ownerId: r.owner_id,
|
|
308
|
+
kind: r.kind,
|
|
309
|
+
content: r.content,
|
|
310
|
+
normalizedContent: r.normalized_content,
|
|
311
|
+
scopeId: r.scope_id,
|
|
312
|
+
status: r.status,
|
|
313
|
+
authority: r.authority,
|
|
314
|
+
confidence: Number(r.confidence),
|
|
315
|
+
sourceAgent: r.source_agent ?? null,
|
|
316
|
+
sourceSessionId: r.source_session_id ?? null,
|
|
317
|
+
sourceImportBatchId: r.source_import_batch_id ?? null,
|
|
318
|
+
sourceMessageRange: r.source_message_range ?? null,
|
|
319
|
+
observedAt: r.observed_at,
|
|
320
|
+
validFrom: r.valid_from ?? null,
|
|
321
|
+
validTo: r.valid_to ?? null,
|
|
322
|
+
lastVerifiedAt: r.last_verified_at ?? null,
|
|
323
|
+
lastUsedAt: r.last_used_at ?? null,
|
|
324
|
+
expiresAt: r.expires_at ?? null,
|
|
325
|
+
sensitivity: r.sensitivity,
|
|
326
|
+
currentRevisionId: r.current_revision_id ?? null,
|
|
327
|
+
contentHash: r.content_hash,
|
|
328
|
+
createdBy: r.created_by,
|
|
329
|
+
createdAt: r.created_at,
|
|
330
|
+
updatedAt: r.updated_at,
|
|
331
|
+
};
|
|
332
|
+
}
|
|
333
|
+
export function mapRevision(r) {
|
|
334
|
+
let parents = [];
|
|
335
|
+
try {
|
|
336
|
+
const v = JSON.parse(r.parent_revision_ids ?? '[]');
|
|
337
|
+
if (Array.isArray(v))
|
|
338
|
+
parents = v.map(String);
|
|
339
|
+
}
|
|
340
|
+
catch {
|
|
341
|
+
parents = [];
|
|
342
|
+
}
|
|
343
|
+
return {
|
|
344
|
+
id: r.id,
|
|
345
|
+
memoryId: r.memory_id,
|
|
346
|
+
seq: Number(r.seq),
|
|
347
|
+
parentRevisionIds: parents,
|
|
348
|
+
content: r.content,
|
|
349
|
+
contentHash: r.content_hash,
|
|
350
|
+
scopeId: r.scope_id,
|
|
351
|
+
status: r.status,
|
|
352
|
+
authority: r.authority,
|
|
353
|
+
author: r.author,
|
|
354
|
+
deviceId: r.device_id,
|
|
355
|
+
reason: r.reason ?? null,
|
|
356
|
+
createdAt: r.created_at,
|
|
357
|
+
};
|
|
358
|
+
}
|
|
359
|
+
export function mapEvidence(r) {
|
|
360
|
+
return {
|
|
361
|
+
id: r.id,
|
|
362
|
+
memoryId: r.memory_id,
|
|
363
|
+
revisionId: r.revision_id ?? null,
|
|
364
|
+
evidenceKind: r.evidence_kind,
|
|
365
|
+
sourceAgent: r.source_agent ?? null,
|
|
366
|
+
sessionId: r.session_id ?? null,
|
|
367
|
+
importArchiveId: r.import_archive_id ?? null,
|
|
368
|
+
locator: r.locator ?? null,
|
|
369
|
+
excerptHash: r.excerpt_hash ?? null,
|
|
370
|
+
trustLevel: r.trust_level,
|
|
371
|
+
createdAt: r.created_at,
|
|
372
|
+
};
|
|
373
|
+
}
|
|
374
|
+
/** 证据摘录只存哈希,不存原文(构想 §8.3)。 */
|
|
375
|
+
export function evidenceExcerptHash(excerpt) {
|
|
376
|
+
return sha256Hex(excerpt);
|
|
377
|
+
}
|
|
378
|
+
//# sourceMappingURL=memories.js.map
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"memories.js","sourceRoot":"","sources":["../../../src/store/memories.ts"],"names":[],"mappings":"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"}
|
|
@@ -0,0 +1,32 @@
|
|
|
1
|
+
import { CairnDb } from './db.js';
|
|
2
|
+
export interface Migration {
|
|
3
|
+
version: number;
|
|
4
|
+
name: string;
|
|
5
|
+
sql: string;
|
|
6
|
+
/**
|
|
7
|
+
* 在 `BEGIN` **之前**执行的 pragma 语句。
|
|
8
|
+
*
|
|
9
|
+
* 存在的唯一原因:SQLite 的 `PRAGMA foreign_keys` 在事务内是 **no-op**。
|
|
10
|
+
* 重建被外键引用的表时必须先关掉外键,否则 `DROP TABLE` 会级联删光子表数据
|
|
11
|
+
* (实测:子表 1 行变 0 行,而 `PRAGMA foreign_key_check` 仍报干净——静默丢数据)。
|
|
12
|
+
*/
|
|
13
|
+
preTransactionPragma?: string[];
|
|
14
|
+
/** 在 `COMMIT` **之后**执行的 pragma 语句(用于把 pre 的改动恢复回去)。 */
|
|
15
|
+
postTransactionPragma?: string[];
|
|
16
|
+
}
|
|
17
|
+
/** 按版本排列;version 写入 PRAGMA user_version。 */
|
|
18
|
+
export declare const MIGRATIONS: readonly Migration[];
|
|
19
|
+
export interface MigrationResult {
|
|
20
|
+
applied: number[];
|
|
21
|
+
currentVersion: number;
|
|
22
|
+
}
|
|
23
|
+
declare function currentVersion(db: CairnDb): number;
|
|
24
|
+
/**
|
|
25
|
+
* 版本化迁移(任务 1.2):每个迁移独立事务,失败回滚,
|
|
26
|
+
* 数据库停留在旧版本且可再次执行;绝不留下半迁移库。
|
|
27
|
+
* 并发安全:BEGIN IMMEDIATE 取到写锁【之后】重读版本号,
|
|
28
|
+
* 多进程同时打开同一新库时只有一方真正建表,另一方幂等跳过。
|
|
29
|
+
* schema 版本高于已知实现时拒绝打开(防旧代码写新库)。
|
|
30
|
+
*/
|
|
31
|
+
export declare function runMigrations(db: CairnDb, migrations?: readonly Migration[]): MigrationResult;
|
|
32
|
+
export { currentVersion as schemaVersion };
|
|
@@ -0,0 +1,86 @@
|
|
|
1
|
+
import { MIGRATION_001_CORE, MIGRATION_002_SEARCH, MIGRATION_003_DEDUP, MIGRATION_004_KIND_LESSON } from './schema.js';
|
|
2
|
+
import { err } from '../core/errors.js';
|
|
3
|
+
/** 按版本排列;version 写入 PRAGMA user_version。 */
|
|
4
|
+
export const MIGRATIONS = [
|
|
5
|
+
{ version: 1, name: 'core_v1', sql: MIGRATION_001_CORE },
|
|
6
|
+
{ version: 2, name: 'search_v1', sql: MIGRATION_002_SEARCH },
|
|
7
|
+
{ version: 3, name: 'dedup_v1', sql: MIGRATION_003_DEDUP },
|
|
8
|
+
{
|
|
9
|
+
version: 4,
|
|
10
|
+
name: 'kind_lesson',
|
|
11
|
+
sql: MIGRATION_004_KIND_LESSON,
|
|
12
|
+
// 重建被 8 个表外键引用的 memory 表:外键必须在 BEGIN 之前关掉
|
|
13
|
+
// (事务内设置 foreign_keys 是 no-op),否则 DROP 会级联删光子表数据。
|
|
14
|
+
preTransactionPragma: ['PRAGMA foreign_keys = OFF'],
|
|
15
|
+
postTransactionPragma: ['PRAGMA foreign_keys = ON'],
|
|
16
|
+
},
|
|
17
|
+
];
|
|
18
|
+
function currentVersion(db) {
|
|
19
|
+
const row = db.get('PRAGMA user_version');
|
|
20
|
+
return row ? Number(Object.values(row)[0]) : 0;
|
|
21
|
+
}
|
|
22
|
+
function setVersion(db, v) {
|
|
23
|
+
db.exec(`PRAGMA user_version = ${v}`);
|
|
24
|
+
}
|
|
25
|
+
/**
|
|
26
|
+
* 版本化迁移(任务 1.2):每个迁移独立事务,失败回滚,
|
|
27
|
+
* 数据库停留在旧版本且可再次执行;绝不留下半迁移库。
|
|
28
|
+
* 并发安全:BEGIN IMMEDIATE 取到写锁【之后】重读版本号,
|
|
29
|
+
* 多进程同时打开同一新库时只有一方真正建表,另一方幂等跳过。
|
|
30
|
+
* schema 版本高于已知实现时拒绝打开(防旧代码写新库)。
|
|
31
|
+
*/
|
|
32
|
+
export function runMigrations(db, migrations = MIGRATIONS) {
|
|
33
|
+
const applied = [];
|
|
34
|
+
let v = currentVersion(db);
|
|
35
|
+
const latest = migrations.length > 0 ? migrations[migrations.length - 1].version : 0;
|
|
36
|
+
if (v > latest) {
|
|
37
|
+
throw err('E_MIGRATION_FAILED', `数据库 schema 版本 ${v} 高于当前实现支持的 ${latest};请升级 Cairn 后再打开该数据目录`, { dbVersion: v, supportedVersion: latest });
|
|
38
|
+
}
|
|
39
|
+
for (const m of migrations) {
|
|
40
|
+
if (m.version <= v)
|
|
41
|
+
continue;
|
|
42
|
+
try {
|
|
43
|
+
let appliedThis = false;
|
|
44
|
+
// 事务外的前置 pragma:foreign_keys 必须在 BEGIN 之前设置才生效。
|
|
45
|
+
for (const pragma of m.preTransactionPragma ?? [])
|
|
46
|
+
db.exec(pragma);
|
|
47
|
+
db.transaction(() => {
|
|
48
|
+
// 持写锁后重读:并发进程可能已在本事务排队期间完成该迁移
|
|
49
|
+
const current = currentVersion(db);
|
|
50
|
+
if (m.version <= current)
|
|
51
|
+
return;
|
|
52
|
+
db.exec(m.sql);
|
|
53
|
+
setVersion(db, m.version);
|
|
54
|
+
appliedThis = true;
|
|
55
|
+
});
|
|
56
|
+
// 事务外的后置 pragma:把 pre 阶段改掉的设置恢复。**成功失败都要跑**,
|
|
57
|
+
// 否则一次迁移失败会让连接停在外键关闭状态,后续写入失去约束。
|
|
58
|
+
for (const pragma of m.postTransactionPragma ?? [])
|
|
59
|
+
db.exec(pragma);
|
|
60
|
+
if (appliedThis) {
|
|
61
|
+
applied.push(m.version);
|
|
62
|
+
v = m.version;
|
|
63
|
+
}
|
|
64
|
+
else {
|
|
65
|
+
v = Math.max(v, m.version);
|
|
66
|
+
}
|
|
67
|
+
}
|
|
68
|
+
catch (e) {
|
|
69
|
+
// 失败路径同样恢复 pragma,再做错误包装。
|
|
70
|
+
try {
|
|
71
|
+
for (const pragma of m.postTransactionPragma ?? [])
|
|
72
|
+
db.exec(pragma);
|
|
73
|
+
}
|
|
74
|
+
catch {
|
|
75
|
+
// 恢复失败不掩盖原始错误:原始错误更能说明问题。
|
|
76
|
+
}
|
|
77
|
+
throw err('E_MIGRATION_FAILED', `迁移 ${m.version} (${m.name}) 失败: ${e.message}`, {
|
|
78
|
+
version: m.version,
|
|
79
|
+
name: m.name,
|
|
80
|
+
});
|
|
81
|
+
}
|
|
82
|
+
}
|
|
83
|
+
return { applied, currentVersion: v };
|
|
84
|
+
}
|
|
85
|
+
export { currentVersion as schemaVersion };
|
|
86
|
+
//# sourceMappingURL=migrate.js.map
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"migrate.js","sourceRoot":"","sources":["../../../src/store/migrate.ts"],"names":[],"mappings":"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"}
|
|
@@ -0,0 +1,53 @@
|
|
|
1
|
+
import { CairnDb } from './db.js';
|
|
2
|
+
import { schemaVersion } from './migrate.js';
|
|
3
|
+
import { ScopeRepository } from './scopes.js';
|
|
4
|
+
import { MemoryRepository } from './memories.js';
|
|
5
|
+
import { ImportArchiveRepository } from './archives.js';
|
|
6
|
+
import { PlanRepository } from './plans.js';
|
|
7
|
+
import { OutboxRepository } from './outbox.js';
|
|
8
|
+
import { ManagedBlockRepository, DeviceInstallationRepository } from './blocks.js';
|
|
9
|
+
import { ConflictRepository } from './conflicts.js';
|
|
10
|
+
import { AuditLog } from './audit.js';
|
|
11
|
+
import { CloneCheckResult, DeviceIdentityFile, reEnrollDevice } from './device.js';
|
|
12
|
+
/** Cairn 数据目录布局:~/.cairn(CAIRN_HOME 可重定向;测试一律用合成目录)。 */
|
|
13
|
+
export interface CairnPaths {
|
|
14
|
+
home: string;
|
|
15
|
+
dbPath: string;
|
|
16
|
+
dataDir: string;
|
|
17
|
+
snapshotsDir: string;
|
|
18
|
+
backupsDir: string;
|
|
19
|
+
}
|
|
20
|
+
export declare function defaultHome(): string;
|
|
21
|
+
export declare function resolvePaths(home: string): CairnPaths;
|
|
22
|
+
export declare function ensureDirs(paths: CairnPaths): void;
|
|
23
|
+
export interface CairnStore {
|
|
24
|
+
paths: CairnPaths;
|
|
25
|
+
db: CairnDb;
|
|
26
|
+
identity: DeviceIdentityFile;
|
|
27
|
+
cloneCheck: CloneCheckResult;
|
|
28
|
+
scopes: ScopeRepository;
|
|
29
|
+
memories: MemoryRepository;
|
|
30
|
+
archives: ImportArchiveRepository;
|
|
31
|
+
plans: PlanRepository;
|
|
32
|
+
outbox: OutboxRepository;
|
|
33
|
+
blocks: ManagedBlockRepository;
|
|
34
|
+
installations: DeviceInstallationRepository;
|
|
35
|
+
conflicts: ConflictRepository;
|
|
36
|
+
audit: AuditLog;
|
|
37
|
+
/** 写操作前置守卫:克隆/暂停状态抛 E_DEVICE_CLONED / E_DEVICE_SUSPENDED。 */
|
|
38
|
+
assertWritable(): void;
|
|
39
|
+
reEnroll(): ReturnType<typeof reEnrollDevice>;
|
|
40
|
+
close(): void;
|
|
41
|
+
}
|
|
42
|
+
export interface OpenStoreOptions {
|
|
43
|
+
home?: string;
|
|
44
|
+
readOnly?: boolean;
|
|
45
|
+
/** 跳过迁移(仅特殊诊断用途)。 */
|
|
46
|
+
skipMigrations?: boolean;
|
|
47
|
+
}
|
|
48
|
+
/**
|
|
49
|
+
* 打开本地权威库:目录准备 → 迁移 → 设备身份与克隆检测 → 仓储装配。
|
|
50
|
+
* 迁移失败绝不进入正常读写(design Migration Plan)。
|
|
51
|
+
*/
|
|
52
|
+
export declare function openStore(opts?: OpenStoreOptions): CairnStore;
|
|
53
|
+
export { schemaVersion };
|