@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,162 @@
|
|
|
1
|
+
import { DatabaseSync } from 'node:sqlite';
|
|
2
|
+
import { err, isCairnError, CairnError } from '../core/errors.js';
|
|
3
|
+
export class CairnDb {
|
|
4
|
+
raw;
|
|
5
|
+
path;
|
|
6
|
+
txDepth = 0;
|
|
7
|
+
closed = false;
|
|
8
|
+
constructor(raw, path) {
|
|
9
|
+
this.raw = raw;
|
|
10
|
+
this.path = path;
|
|
11
|
+
}
|
|
12
|
+
static open(path, opts = {}) {
|
|
13
|
+
// 并发冷启动竞态(第二轮独立验证 P1):多进程同时首建同一库时,
|
|
14
|
+
// journal_mode/pragma 可能落入 SQLITE_READONLY/_busy 状态且 busy_timeout
|
|
15
|
+
// 不吸收,必须重开连接有界重试。
|
|
16
|
+
const maxAttempts = 5;
|
|
17
|
+
let lastError = null;
|
|
18
|
+
for (let attempt = 1; attempt <= maxAttempts; attempt++) {
|
|
19
|
+
try {
|
|
20
|
+
let raw;
|
|
21
|
+
try {
|
|
22
|
+
raw = new DatabaseSync(path, { readOnly: opts.readOnly ?? false });
|
|
23
|
+
}
|
|
24
|
+
catch (e) {
|
|
25
|
+
throw err('E_IO', `无法打开数据库 ${path}: ${e.message}`);
|
|
26
|
+
}
|
|
27
|
+
raw.exec(`PRAGMA busy_timeout = ${opts.busyTimeoutMs ?? 5000}`);
|
|
28
|
+
if (!opts.readOnly) {
|
|
29
|
+
// journal_mode 校验仅对文件库有意义;:memory: 本来就是 'memory'
|
|
30
|
+
if (path !== ':memory:') {
|
|
31
|
+
const modeRow = raw.prepare('PRAGMA journal_mode = WAL').get();
|
|
32
|
+
const mode = modeRow ? String(Object.values(modeRow)[0]).toLowerCase() : '';
|
|
33
|
+
if (mode !== 'wal') {
|
|
34
|
+
raw.close();
|
|
35
|
+
throw new Error(`journal_mode 竞态得到 '${mode}'(期望 wal)`);
|
|
36
|
+
}
|
|
37
|
+
}
|
|
38
|
+
raw.exec('PRAGMA foreign_keys = ON');
|
|
39
|
+
raw.exec('PRAGMA synchronous = NORMAL');
|
|
40
|
+
}
|
|
41
|
+
else {
|
|
42
|
+
raw.exec('PRAGMA foreign_keys = ON');
|
|
43
|
+
}
|
|
44
|
+
return new CairnDb(raw, path);
|
|
45
|
+
}
|
|
46
|
+
catch (e) {
|
|
47
|
+
lastError = e;
|
|
48
|
+
if (attempt < maxAttempts && isRetryableSqliteError(e)) {
|
|
49
|
+
Atomics.wait(new Int32Array(new SharedArrayBuffer(4)), 0, 0, 50 * attempt);
|
|
50
|
+
continue;
|
|
51
|
+
}
|
|
52
|
+
if (e instanceof CairnError)
|
|
53
|
+
throw e;
|
|
54
|
+
throw err('E_IO', `无法打开数据库 ${path}: ${e.message}`, {
|
|
55
|
+
attempts: attempt,
|
|
56
|
+
});
|
|
57
|
+
}
|
|
58
|
+
}
|
|
59
|
+
throw err('E_IO', `无法打开数据库 ${path}: ${lastError.message}`, { attempts: maxAttempts });
|
|
60
|
+
}
|
|
61
|
+
exec(sql) {
|
|
62
|
+
this.raw.exec(sql);
|
|
63
|
+
}
|
|
64
|
+
prepare(sql) {
|
|
65
|
+
return this.raw.prepare(sql);
|
|
66
|
+
}
|
|
67
|
+
get(sql, ...params) {
|
|
68
|
+
return this.raw.prepare(sql).all(...params.map(toParam))[0];
|
|
69
|
+
}
|
|
70
|
+
all(sql, ...params) {
|
|
71
|
+
return this.raw.prepare(sql).all(...params.map(toParam));
|
|
72
|
+
}
|
|
73
|
+
run(sql, ...params) {
|
|
74
|
+
return this.raw.prepare(sql).run(...params.map(toParam));
|
|
75
|
+
}
|
|
76
|
+
/** 读值便捷方法:单行单列。 */
|
|
77
|
+
scalar(sql, ...params) {
|
|
78
|
+
const row = this.get(sql, ...params);
|
|
79
|
+
if (row == null)
|
|
80
|
+
return undefined;
|
|
81
|
+
const keys = Object.keys(row);
|
|
82
|
+
return keys.length > 0 ? row[keys[0]] : undefined;
|
|
83
|
+
}
|
|
84
|
+
/**
|
|
85
|
+
* 事务:BEGIN IMMEDIATE 立即取写锁,配合 busy_timeout 产生可重试等待而非死锁。
|
|
86
|
+
* 嵌套调用转 SAVEPOINT;异常时回滚并重抛(业务错误保持原类型)。
|
|
87
|
+
*/
|
|
88
|
+
transaction(fn) {
|
|
89
|
+
if (this.txDepth > 0) {
|
|
90
|
+
const sp = `sp_${this.txDepth}`;
|
|
91
|
+
this.exec(`SAVEPOINT ${sp}`);
|
|
92
|
+
this.txDepth++;
|
|
93
|
+
try {
|
|
94
|
+
const out = fn();
|
|
95
|
+
this.txDepth--;
|
|
96
|
+
this.exec(`RELEASE ${sp}`);
|
|
97
|
+
return out;
|
|
98
|
+
}
|
|
99
|
+
catch (e) {
|
|
100
|
+
this.txDepth--;
|
|
101
|
+
this.exec(`ROLLBACK TO ${sp}`);
|
|
102
|
+
this.exec(`RELEASE ${sp}`);
|
|
103
|
+
throw e;
|
|
104
|
+
}
|
|
105
|
+
}
|
|
106
|
+
this.exec('BEGIN IMMEDIATE');
|
|
107
|
+
this.txDepth = 1;
|
|
108
|
+
try {
|
|
109
|
+
const out = fn();
|
|
110
|
+
this.txDepth = 0;
|
|
111
|
+
this.exec('COMMIT');
|
|
112
|
+
return out;
|
|
113
|
+
}
|
|
114
|
+
catch (e) {
|
|
115
|
+
this.txDepth = 0;
|
|
116
|
+
this.exec('ROLLBACK');
|
|
117
|
+
if (isSqliteBusy(e)) {
|
|
118
|
+
throw err('E_DB_LOCKED', '数据库写入忙超时,请稍后重试', { sqlite: e.message });
|
|
119
|
+
}
|
|
120
|
+
throw e;
|
|
121
|
+
}
|
|
122
|
+
}
|
|
123
|
+
get inTransaction() {
|
|
124
|
+
return this.txDepth > 0;
|
|
125
|
+
}
|
|
126
|
+
integrityCheck() {
|
|
127
|
+
const row = this.get('PRAGMA integrity_check');
|
|
128
|
+
return row != null && String(Object.values(row)[0]) === 'ok';
|
|
129
|
+
}
|
|
130
|
+
foreignKeyCheck() {
|
|
131
|
+
return this.all('PRAGMA foreign_key_check');
|
|
132
|
+
}
|
|
133
|
+
close() {
|
|
134
|
+
if (this.closed)
|
|
135
|
+
return;
|
|
136
|
+
this.closed = true;
|
|
137
|
+
this.raw.close();
|
|
138
|
+
}
|
|
139
|
+
}
|
|
140
|
+
function toParam(p) {
|
|
141
|
+
if (p === undefined || p === null)
|
|
142
|
+
return null;
|
|
143
|
+
if (typeof p === 'boolean')
|
|
144
|
+
return p ? 1 : 0;
|
|
145
|
+
if (typeof p === 'string' || typeof p === 'number' || typeof p === 'bigint')
|
|
146
|
+
return p;
|
|
147
|
+
if (p instanceof Uint8Array)
|
|
148
|
+
return p;
|
|
149
|
+
throw err('E_INTERNAL', `不支持的 SQL 参数类型: ${typeof p}`);
|
|
150
|
+
}
|
|
151
|
+
function isSqliteBusy(e) {
|
|
152
|
+
const msg = e.message ?? '';
|
|
153
|
+
return /SQLITE_BUSY|database is locked/i.test(msg) || (isCairnError(e) && e.code === 'E_DB_LOCKED');
|
|
154
|
+
}
|
|
155
|
+
/** 冷启动竞态涉及的三类可重试 SQLite 错误(READONLY/BUSY/LOCKED)。 */
|
|
156
|
+
export function isRetryableSqliteError(e) {
|
|
157
|
+
if (isCairnError(e) && (e.code === 'E_DB_LOCKED' || e.code === 'E_READONLY'))
|
|
158
|
+
return true;
|
|
159
|
+
const msg = `${e.message ?? ''} ${e.errcode ?? ''}`;
|
|
160
|
+
return /SQLITE_READONLY|SQLITE_BUSY|SQLITE_LOCKED|SQLITE_IOERR|attempt to write a readonly|database is locked/i.test(msg);
|
|
161
|
+
}
|
|
162
|
+
//# sourceMappingURL=db.js.map
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"db.js","sourceRoot":"","sources":["../../../src/store/db.ts"],"names":[],"mappings":"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"}
|
|
@@ -0,0 +1,46 @@
|
|
|
1
|
+
import { CairnDb } from './db.js';
|
|
2
|
+
import { CairnError } from '../core/errors.js';
|
|
3
|
+
/**
|
|
4
|
+
* 设备身份(spec memory-store:防克隆)。
|
|
5
|
+
* device.json 保存在数据目录,与数据库分离;整目录克隆会复制同一身份。
|
|
6
|
+
* 打开时比对 DB 内 instance_nonce:不一致 → 判定克隆,暂停旧身份写入。
|
|
7
|
+
*/
|
|
8
|
+
export interface DeviceIdentityFile {
|
|
9
|
+
deviceId: string;
|
|
10
|
+
instanceNonce: string;
|
|
11
|
+
createdAt: string;
|
|
12
|
+
}
|
|
13
|
+
export interface DeviceRow {
|
|
14
|
+
id: string;
|
|
15
|
+
label: string | null;
|
|
16
|
+
instanceNonce: string;
|
|
17
|
+
enrollment: 'pending' | 'active' | 'suspended' | 'revoked';
|
|
18
|
+
enrolledAt: string;
|
|
19
|
+
suspendedReason: string | null;
|
|
20
|
+
}
|
|
21
|
+
export declare function identityPath(dataDir: string): string;
|
|
22
|
+
export declare function loadIdentity(dataDir: string): DeviceIdentityFile | null;
|
|
23
|
+
export declare function createIdentity(dataDir: string): DeviceIdentityFile;
|
|
24
|
+
export declare function loadOrCreateIdentity(dataDir: string): DeviceIdentityFile;
|
|
25
|
+
export declare function getDeviceRow(db: CairnDb, deviceId: string): DeviceRow | null;
|
|
26
|
+
export declare function registerDevice(db: CairnDb, identity: DeviceIdentityFile, label?: string): DeviceRow;
|
|
27
|
+
export interface CloneCheckResult {
|
|
28
|
+
/** true:身份与库一致,可正常写入。 */
|
|
29
|
+
ok: boolean;
|
|
30
|
+
/** 克隆证据:库中 nonce 与身份文件不一致(整目录复制)。 */
|
|
31
|
+
cloned: boolean;
|
|
32
|
+
device: DeviceRow | null;
|
|
33
|
+
}
|
|
34
|
+
export declare function checkCloneState(db: CairnDb, identity: DeviceIdentityFile): CloneCheckResult;
|
|
35
|
+
/**
|
|
36
|
+
* 克隆恢复:为当前副本生成全新设备身份并注册(旧身份保留为 suspended 证据)。
|
|
37
|
+
* 作用域收窄语义:旧设备产生的历史上行不会被撤回,由文档明确提示。
|
|
38
|
+
*/
|
|
39
|
+
export declare function reEnrollDevice(db: CairnDb, dataDir: string): {
|
|
40
|
+
old: DeviceIdentityFile;
|
|
41
|
+
identity: DeviceIdentityFile;
|
|
42
|
+
device: DeviceRow;
|
|
43
|
+
};
|
|
44
|
+
/** 写路径守卫:克隆或暂停状态下拒绝新写入(读不受影响)。 */
|
|
45
|
+
export declare function assertWritable(check: CloneCheckResult): void;
|
|
46
|
+
export declare function isDeviceClonedError(e: unknown): e is CairnError;
|
|
@@ -0,0 +1,111 @@
|
|
|
1
|
+
import { existsSync, readFileSync, writeFileSync, mkdirSync, renameSync } from 'node:fs';
|
|
2
|
+
import { join } from 'node:path';
|
|
3
|
+
import { randomBytes } from 'node:crypto';
|
|
4
|
+
import { err, CairnError } from '../core/errors.js';
|
|
5
|
+
import { nowIso } from '../core/time.js';
|
|
6
|
+
import { uuidv7 } from '../core/ids.js';
|
|
7
|
+
const IDENTITY_FILE = 'device.json';
|
|
8
|
+
export function identityPath(dataDir) {
|
|
9
|
+
return join(dataDir, IDENTITY_FILE);
|
|
10
|
+
}
|
|
11
|
+
export function loadIdentity(dataDir) {
|
|
12
|
+
const p = identityPath(dataDir);
|
|
13
|
+
if (!existsSync(p))
|
|
14
|
+
return null;
|
|
15
|
+
try {
|
|
16
|
+
const parsed = JSON.parse(readFileSync(p, 'utf8'));
|
|
17
|
+
if (typeof parsed.deviceId !== 'string' || typeof parsed.instanceNonce !== 'string')
|
|
18
|
+
return null;
|
|
19
|
+
return parsed;
|
|
20
|
+
}
|
|
21
|
+
catch {
|
|
22
|
+
return null;
|
|
23
|
+
}
|
|
24
|
+
}
|
|
25
|
+
export function createIdentity(dataDir) {
|
|
26
|
+
mkdirSync(dataDir, { recursive: true });
|
|
27
|
+
const identity = {
|
|
28
|
+
deviceId: `dev_${uuidv7()}`,
|
|
29
|
+
instanceNonce: randomBytes(16).toString('hex'),
|
|
30
|
+
createdAt: nowIso(),
|
|
31
|
+
};
|
|
32
|
+
writeFileSync(identityPath(dataDir), JSON.stringify(identity, null, 2), 'utf8');
|
|
33
|
+
return identity;
|
|
34
|
+
}
|
|
35
|
+
export function loadOrCreateIdentity(dataDir) {
|
|
36
|
+
return loadIdentity(dataDir) ?? createIdentity(dataDir);
|
|
37
|
+
}
|
|
38
|
+
export function getDeviceRow(db, deviceId) {
|
|
39
|
+
const row = db.get('SELECT * FROM device WHERE id = ?', deviceId);
|
|
40
|
+
return row ? mapDevice(row) : null;
|
|
41
|
+
}
|
|
42
|
+
function mapDevice(r) {
|
|
43
|
+
return {
|
|
44
|
+
id: r.id,
|
|
45
|
+
label: r.label ?? null,
|
|
46
|
+
instanceNonce: r.instance_nonce,
|
|
47
|
+
enrollment: r.enrollment,
|
|
48
|
+
enrolledAt: r.enrolled_at,
|
|
49
|
+
suspendedReason: r.suspended_reason ?? null,
|
|
50
|
+
};
|
|
51
|
+
}
|
|
52
|
+
export function registerDevice(db, identity, label) {
|
|
53
|
+
const existing = getDeviceRow(db, identity.deviceId);
|
|
54
|
+
if (existing)
|
|
55
|
+
return existing;
|
|
56
|
+
db.run('INSERT INTO device (id, label, instance_nonce, enrollment, enrolled_at) VALUES (?, ?, ?, ?, ?)', identity.deviceId, label ?? null, identity.instanceNonce, 'active', nowIso());
|
|
57
|
+
return getDeviceRow(db, identity.deviceId);
|
|
58
|
+
}
|
|
59
|
+
export function checkCloneState(db, identity) {
|
|
60
|
+
const device = getDeviceRow(db, identity.deviceId);
|
|
61
|
+
if (!device)
|
|
62
|
+
return { ok: true, cloned: false, device: null };
|
|
63
|
+
const cloned = device.instanceNonce !== identity.instanceNonce;
|
|
64
|
+
return { ok: !cloned && device.enrollment === 'active', cloned, device };
|
|
65
|
+
}
|
|
66
|
+
/**
|
|
67
|
+
* 克隆恢复:为当前副本生成全新设备身份并注册(旧身份保留为 suspended 证据)。
|
|
68
|
+
* 作用域收窄语义:旧设备产生的历史上行不会被撤回,由文档明确提示。
|
|
69
|
+
*/
|
|
70
|
+
export function reEnrollDevice(db, dataDir) {
|
|
71
|
+
const old = loadIdentity(dataDir);
|
|
72
|
+
if (!old)
|
|
73
|
+
throw err('E_DEVICE_SUSPENDED', '没有可重新登记的旧身份');
|
|
74
|
+
// 旧身份若还在库中且 nonce 一致,标记 suspended(克隆源暂停写入)
|
|
75
|
+
const oldRow = getDeviceRow(db, old.deviceId);
|
|
76
|
+
db.transaction(() => {
|
|
77
|
+
if (oldRow && oldRow.instanceNonce === old.instanceNonce && oldRow.enrollment === 'active') {
|
|
78
|
+
db.run("UPDATE device SET enrollment = 'suspended', suspended_reason = 're-enrolled: identity cloned or re-registered' WHERE id = ?", old.deviceId);
|
|
79
|
+
}
|
|
80
|
+
});
|
|
81
|
+
const backup = join(dataDir, `device.json.backup-${Date.now()}`);
|
|
82
|
+
if (existsSync(identityPath(dataDir))) {
|
|
83
|
+
try {
|
|
84
|
+
renameSync(identityPath(dataDir), backup);
|
|
85
|
+
}
|
|
86
|
+
catch {
|
|
87
|
+
/* 备份失败不阻塞重新登记 */
|
|
88
|
+
}
|
|
89
|
+
}
|
|
90
|
+
const identity = createIdentity(dataDir);
|
|
91
|
+
const device = registerDevice(db, identity);
|
|
92
|
+
return { old, identity, device };
|
|
93
|
+
}
|
|
94
|
+
/** 写路径守卫:克隆或暂停状态下拒绝新写入(读不受影响)。 */
|
|
95
|
+
export function assertWritable(check) {
|
|
96
|
+
if (check.cloned) {
|
|
97
|
+
throw err('E_DEVICE_CLONED', '检测到设备目录被克隆:旧身份写入已暂停;请运行 device re-enroll 生成独立身份', {
|
|
98
|
+
deviceId: check.device?.id,
|
|
99
|
+
});
|
|
100
|
+
}
|
|
101
|
+
if (check.device && check.device.enrollment === 'suspended') {
|
|
102
|
+
throw err('E_DEVICE_SUSPENDED', '设备处于暂停状态;请运行 device re-enroll 或恢复 enrollment');
|
|
103
|
+
}
|
|
104
|
+
if (check.device && check.device.enrollment === 'revoked') {
|
|
105
|
+
throw err('E_DEVICE_SUSPENDED', '设备登记已被吊销');
|
|
106
|
+
}
|
|
107
|
+
}
|
|
108
|
+
export function isDeviceClonedError(e) {
|
|
109
|
+
return e instanceof CairnError && (e.code === 'E_DEVICE_CLONED' || e.code === 'E_DEVICE_SUSPENDED');
|
|
110
|
+
}
|
|
111
|
+
//# sourceMappingURL=device.js.map
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"device.js","sourceRoot":"","sources":["../../../src/store/device.ts"],"names":[],"mappings":"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"}
|
|
@@ -0,0 +1,14 @@
|
|
|
1
|
+
export * from './db.js';
|
|
2
|
+
export * from './migrate.js';
|
|
3
|
+
export * from './schema.js';
|
|
4
|
+
export * from './backup.js';
|
|
5
|
+
export * from './device.js';
|
|
6
|
+
export * from './audit.js';
|
|
7
|
+
export * from './scopes.js';
|
|
8
|
+
export * from './memories.js';
|
|
9
|
+
export * from './archives.js';
|
|
10
|
+
export * from './plans.js';
|
|
11
|
+
export * from './outbox.js';
|
|
12
|
+
export * from './blocks.js';
|
|
13
|
+
export * from './conflicts.js';
|
|
14
|
+
export * from './open.js';
|
|
@@ -0,0 +1,15 @@
|
|
|
1
|
+
export * from './db.js';
|
|
2
|
+
export * from './migrate.js';
|
|
3
|
+
export * from './schema.js';
|
|
4
|
+
export * from './backup.js';
|
|
5
|
+
export * from './device.js';
|
|
6
|
+
export * from './audit.js';
|
|
7
|
+
export * from './scopes.js';
|
|
8
|
+
export * from './memories.js';
|
|
9
|
+
export * from './archives.js';
|
|
10
|
+
export * from './plans.js';
|
|
11
|
+
export * from './outbox.js';
|
|
12
|
+
export * from './blocks.js';
|
|
13
|
+
export * from './conflicts.js';
|
|
14
|
+
export * from './open.js';
|
|
15
|
+
//# sourceMappingURL=index.js.map
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/store/index.ts"],"names":[],"mappings":"AAAA,cAAc,SAAS,CAAC;AACxB,cAAc,cAAc,CAAC;AAC7B,cAAc,aAAa,CAAC;AAC5B,cAAc,aAAa,CAAC;AAC5B,cAAc,aAAa,CAAC;AAC5B,cAAc,YAAY,CAAC;AAC3B,cAAc,aAAa,CAAC;AAC5B,cAAc,eAAe,CAAC;AAC9B,cAAc,eAAe,CAAC;AAC9B,cAAc,YAAY,CAAC;AAC3B,cAAc,aAAa,CAAC;AAC5B,cAAc,aAAa,CAAC;AAC5B,cAAc,gBAAgB,CAAC;AAC/B,cAAc,WAAW,CAAC"}
|
|
@@ -0,0 +1,101 @@
|
|
|
1
|
+
import { CairnDb } from './db.js';
|
|
2
|
+
import { AddMemoryInput, MemoryRecord, MemoryKind, MemoryStatus, Authority, EvidenceInput, EvidenceRecord, RevisionRecord, Sensitivity } from '../core/types.js';
|
|
3
|
+
import { WriteGuardMixin } from './write-guard.js';
|
|
4
|
+
/**
|
|
5
|
+
* 记忆仓储(任务 2.1):显式新增、详情、更正、归档、遗忘与当前修订解析。
|
|
6
|
+
* 更正形成新修订并保留 supersedes 链;历史修订不可无痕修改。
|
|
7
|
+
* 内容哈希基于规范化正文(core/hash),原始正文始终保留。
|
|
8
|
+
*/
|
|
9
|
+
export interface ReviseOptions {
|
|
10
|
+
reason?: string;
|
|
11
|
+
author: string;
|
|
12
|
+
/** 乐观锁:期望的当前修订 id;不匹配抛 E_TARGET_CHANGED。 */
|
|
13
|
+
expectedCurrentRevisionId?: string;
|
|
14
|
+
expiresAt?: string | null;
|
|
15
|
+
sensitivity?: Sensitivity;
|
|
16
|
+
}
|
|
17
|
+
export interface MemoryFilter {
|
|
18
|
+
scopeId?: string;
|
|
19
|
+
status?: MemoryStatus;
|
|
20
|
+
statuses?: MemoryStatus[];
|
|
21
|
+
kind?: MemoryKind;
|
|
22
|
+
authority?: Authority;
|
|
23
|
+
sourceImportBatchId?: string;
|
|
24
|
+
limit?: number;
|
|
25
|
+
offset?: number;
|
|
26
|
+
}
|
|
27
|
+
export declare class MemoryRepository extends WriteGuardMixin {
|
|
28
|
+
private readonly db;
|
|
29
|
+
constructor(db: CairnDb);
|
|
30
|
+
add(input: AddMemoryInput, deviceId: string): MemoryRecord;
|
|
31
|
+
get(id: string): MemoryRecord | null;
|
|
32
|
+
require(id: string): MemoryRecord;
|
|
33
|
+
/**
|
|
34
|
+
* 用户更正(任务 2.1):新修订 + supersedes 历史;expected 不匹配时
|
|
35
|
+
* 抛 E_TARGET_CHANGED(目标在批准后变化则拒绝过期计划,spec memory-governance)。
|
|
36
|
+
*/
|
|
37
|
+
revise(id: string, newContent: string, opts: ReviseOptions, deviceId: string): {
|
|
38
|
+
memory: MemoryRecord;
|
|
39
|
+
revision: RevisionRecord;
|
|
40
|
+
};
|
|
41
|
+
/** 候选晋升(真实审批后由治理层调用;agent_inferred/imported 不能静默变 active)。 */
|
|
42
|
+
promoteToActive(id: string, authority: Authority, by: string): MemoryRecord;
|
|
43
|
+
archive(id: string): MemoryRecord;
|
|
44
|
+
/** 遗忘(任务 2.1/2.5):tombstone 可审计,被遗忘内容退出活动结果与投影。 */
|
|
45
|
+
forget(id: string, reason: string | null, by: string): MemoryRecord;
|
|
46
|
+
getTombstone(memoryId: string): {
|
|
47
|
+
id: string;
|
|
48
|
+
reason: string | null;
|
|
49
|
+
forgottenBy: string;
|
|
50
|
+
forgottenAt: string;
|
|
51
|
+
contentHash: string;
|
|
52
|
+
} | null;
|
|
53
|
+
resolveCurrent(id: string): {
|
|
54
|
+
memory: MemoryRecord;
|
|
55
|
+
revision: RevisionRecord;
|
|
56
|
+
} | null;
|
|
57
|
+
revisions(id: string): RevisionRecord[];
|
|
58
|
+
requireRevision(revId: string): RevisionRecord;
|
|
59
|
+
evidence(memoryId: string): EvidenceRecord[];
|
|
60
|
+
/** 记忆间关系:supersedes / contradicts / related_to(首版仅三种)。 */
|
|
61
|
+
addRelation(fromMemoryId: string, toMemoryId: string, type: 'supersedes' | 'contradicts' | 'related_to'): string;
|
|
62
|
+
relationsOf(memoryId: string): {
|
|
63
|
+
id: string;
|
|
64
|
+
fromMemoryId: string;
|
|
65
|
+
toMemoryId: string;
|
|
66
|
+
relationType: string;
|
|
67
|
+
}[];
|
|
68
|
+
addEvidence(memoryId: string, revisionId: string | null, input: EvidenceInput): EvidenceRecord;
|
|
69
|
+
list(filter?: MemoryFilter): MemoryRecord[];
|
|
70
|
+
/** 内容去重查找(同 scope 同规范化哈希)。 */
|
|
71
|
+
findByContentHash(scopeId: string, hash: string): MemoryRecord | null;
|
|
72
|
+
/** 跨设备记忆身份对齐:任一修订内容哈希命中即视为同一记忆(本地 id 不可跨设备引用)。 */
|
|
73
|
+
findMemoryIdByRevisionHashes(hashes: string[]): string | null;
|
|
74
|
+
/** 修订级内容哈希查找(同步对账用:远端事件的 parent_hash 对齐到本地修订)。 */
|
|
75
|
+
findRevisionByContentHash(memoryId: string, hash: string): RevisionRecord | null;
|
|
76
|
+
/**
|
|
77
|
+
* 应用远端修订(同步拉取专用):插入为该记忆的下一条本地修订,
|
|
78
|
+
* 不推进 current_revision_id——推进与否由冲突/快进判定决定
|
|
79
|
+
* (sync 层随后显式 revise 或记录冲突)。
|
|
80
|
+
*/
|
|
81
|
+
insertRemoteRevision(memoryId: string, input: {
|
|
82
|
+
content: string;
|
|
83
|
+
contentHash: string;
|
|
84
|
+
author: string;
|
|
85
|
+
reason: string | null;
|
|
86
|
+
parentLocalRevisionId: string | null;
|
|
87
|
+
baseRevisionId: string | null;
|
|
88
|
+
}, deviceId: string): RevisionRecord;
|
|
89
|
+
countsByStatus(): Record<MemoryStatus, number>;
|
|
90
|
+
markUsed(id: string, at?: string): void;
|
|
91
|
+
touchVerified(id: string, at?: string): void;
|
|
92
|
+
private insertEvidence;
|
|
93
|
+
}
|
|
94
|
+
/** authority → 初始状态:显式/确认即 active;推断/导入保持候选(spec memory-governance)。 */
|
|
95
|
+
export declare function initialStatus(authority: Authority): MemoryStatus;
|
|
96
|
+
export declare function validateMemoryInput(input: AddMemoryInput): void;
|
|
97
|
+
export declare function mapMemory(r: Record<string, unknown>): MemoryRecord;
|
|
98
|
+
export declare function mapRevision(r: Record<string, unknown>): RevisionRecord;
|
|
99
|
+
export declare function mapEvidence(r: Record<string, unknown>): EvidenceRecord;
|
|
100
|
+
/** 证据摘录只存哈希,不存原文(构想 §8.3)。 */
|
|
101
|
+
export declare function evidenceExcerptHash(excerpt: string): string;
|