@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,177 @@
|
|
|
1
|
+
import { mkdirSync, existsSync, openSync, closeSync } from 'node:fs';
|
|
2
|
+
import { join } from 'node:path';
|
|
3
|
+
import { homedir } from 'node:os';
|
|
4
|
+
import { CairnDb, isRetryableSqliteError } from './db.js';
|
|
5
|
+
import { runMigrations, schemaVersion, MIGRATIONS } from './migrate.js';
|
|
6
|
+
import { ScopeRepository } from './scopes.js';
|
|
7
|
+
import { MemoryRepository } from './memories.js';
|
|
8
|
+
import { ImportArchiveRepository } from './archives.js';
|
|
9
|
+
import { PlanRepository } from './plans.js';
|
|
10
|
+
import { OutboxRepository } from './outbox.js';
|
|
11
|
+
import { ManagedBlockRepository, DeviceInstallationRepository } from './blocks.js';
|
|
12
|
+
import { ConflictRepository } from './conflicts.js';
|
|
13
|
+
import { AuditLog } from './audit.js';
|
|
14
|
+
import { loadIdentity, loadOrCreateIdentity, registerDevice, checkCloneState, assertWritable, reEnrollDevice, } from './device.js';
|
|
15
|
+
import { err } from '../core/errors.js';
|
|
16
|
+
import { nowIso } from '../core/time.js';
|
|
17
|
+
export function defaultHome() {
|
|
18
|
+
return process.env['CAIRN_HOME'] ?? join(homedir(), '.cairn');
|
|
19
|
+
}
|
|
20
|
+
export function resolvePaths(home) {
|
|
21
|
+
const dataDir = join(home, 'data');
|
|
22
|
+
return {
|
|
23
|
+
home,
|
|
24
|
+
dbPath: join(dataDir, 'cairn.db'),
|
|
25
|
+
dataDir,
|
|
26
|
+
snapshotsDir: join(home, 'snapshots'),
|
|
27
|
+
backupsDir: join(home, 'backups'),
|
|
28
|
+
};
|
|
29
|
+
}
|
|
30
|
+
export function ensureDirs(paths) {
|
|
31
|
+
for (const d of [paths.home, paths.dataDir, paths.snapshotsDir, paths.backupsDir]) {
|
|
32
|
+
if (!existsSync(d))
|
|
33
|
+
mkdirSync(d, { recursive: true });
|
|
34
|
+
}
|
|
35
|
+
}
|
|
36
|
+
/**
|
|
37
|
+
* 打开本地权威库:目录准备 → 迁移 → 设备身份与克隆检测 → 仓储装配。
|
|
38
|
+
* 迁移失败绝不进入正常读写(design Migration Plan)。
|
|
39
|
+
*/
|
|
40
|
+
export function openStore(opts = {}) {
|
|
41
|
+
const paths = resolvePaths(opts.home ?? defaultHome());
|
|
42
|
+
if (!opts.readOnly)
|
|
43
|
+
ensureDirs(paths);
|
|
44
|
+
if (opts.readOnly && !existsSync(paths.dbPath)) {
|
|
45
|
+
throw err('E_IO', `只读打开失败:数据库不存在 ${paths.dbPath}`);
|
|
46
|
+
}
|
|
47
|
+
const readOnly = opts.readOnly ?? false;
|
|
48
|
+
if (!readOnly) {
|
|
49
|
+
firstCreatorOrWait(paths.dbPath);
|
|
50
|
+
}
|
|
51
|
+
// 冷启动竞态有界重试(第二轮独立验证 P1):多进程同时首建同一库时,
|
|
52
|
+
// 迁移后紧跟的 meta/device 写入可能撞上 SQLITE_READONLY/_BUSY;
|
|
53
|
+
// busy_timeout 不吸收 READONLY,必须关闭连接重开重试。
|
|
54
|
+
const maxAttempts = 5;
|
|
55
|
+
let lastError = null;
|
|
56
|
+
for (let attempt = 1; attempt <= maxAttempts; attempt++) {
|
|
57
|
+
const db = CairnDb.open(paths.dbPath, { readOnly });
|
|
58
|
+
try {
|
|
59
|
+
if (!opts.skipMigrations) {
|
|
60
|
+
runMigrations(db);
|
|
61
|
+
// meta 记录库创建信息(幂等;只读连接跳过写入)
|
|
62
|
+
if (!readOnly) {
|
|
63
|
+
db.run("INSERT OR IGNORE INTO meta (key, value) VALUES ('schema_created_at', ?)", nowIso());
|
|
64
|
+
}
|
|
65
|
+
}
|
|
66
|
+
const identity = readOnly
|
|
67
|
+
? loadIdentity(paths.dataDir) ?? { deviceId: 'readonly-unregistered', instanceNonce: '', createdAt: nowIso() }
|
|
68
|
+
: loadOrCreateIdentity(paths.dataDir);
|
|
69
|
+
let cloneCheck = checkCloneState(db, identity);
|
|
70
|
+
if (!readOnly) {
|
|
71
|
+
const device = registerDevice(db, identity);
|
|
72
|
+
if (device.enrollment === 'pending') {
|
|
73
|
+
db.run("UPDATE device SET enrollment = 'active' WHERE id = ?", device.id);
|
|
74
|
+
}
|
|
75
|
+
cloneCheck = checkCloneState(db, identity);
|
|
76
|
+
}
|
|
77
|
+
return assembleStore(db, paths, identity, cloneCheck, readOnly);
|
|
78
|
+
}
|
|
79
|
+
catch (e) {
|
|
80
|
+
lastError = e;
|
|
81
|
+
db.close();
|
|
82
|
+
if (attempt < maxAttempts && isRetryableSqliteError(e)) {
|
|
83
|
+
Atomics.wait(new Int32Array(new SharedArrayBuffer(4)), 0, 0, 50 * attempt);
|
|
84
|
+
continue;
|
|
85
|
+
}
|
|
86
|
+
throw e;
|
|
87
|
+
}
|
|
88
|
+
}
|
|
89
|
+
throw lastError ?? err('E_IO', `无法打开数据库 ${paths.dbPath}`, { attempts: maxAttempts });
|
|
90
|
+
}
|
|
91
|
+
/**
|
|
92
|
+
* 首建抢占(第二轮验证报告建议 3):库文件不存在时以 O_EXCL 抢占创建,
|
|
93
|
+
* 抢到的进程负责建库;未抢到的进程等待库就绪(迁移完成)后再打开。
|
|
94
|
+
* 消除"4 个进程同时迁移同一新库"的争用面。
|
|
95
|
+
*/
|
|
96
|
+
function firstCreatorOrWait(dbPath) {
|
|
97
|
+
if (existsSync(dbPath))
|
|
98
|
+
return;
|
|
99
|
+
try {
|
|
100
|
+
closeSync(openSync(dbPath, 'wx'));
|
|
101
|
+
return; // 本进程是首建者
|
|
102
|
+
}
|
|
103
|
+
catch (e) {
|
|
104
|
+
if (e.code !== 'EEXIST') {
|
|
105
|
+
throw err('E_IO', `创建数据库文件失败 ${dbPath}: ${e.message}`);
|
|
106
|
+
}
|
|
107
|
+
}
|
|
108
|
+
// 未抢到:等待首建者完成迁移(schema 就绪)
|
|
109
|
+
const deadline = Date.now() + 15_000;
|
|
110
|
+
for (;;) {
|
|
111
|
+
if (Date.now() > deadline) {
|
|
112
|
+
throw err('E_DB_LOCKED', `等待数据库就绪超时 ${dbPath}(首建者可能已失败)`);
|
|
113
|
+
}
|
|
114
|
+
if (existsSync(dbPath)) {
|
|
115
|
+
let probe = null;
|
|
116
|
+
try {
|
|
117
|
+
probe = CairnDb.open(dbPath, { readOnly: true, busyTimeoutMs: 500 });
|
|
118
|
+
const v = schemaVersion(probe);
|
|
119
|
+
probe.close();
|
|
120
|
+
probe = null;
|
|
121
|
+
if (v >= MIGRATIONS.length)
|
|
122
|
+
return;
|
|
123
|
+
}
|
|
124
|
+
catch {
|
|
125
|
+
probe?.close();
|
|
126
|
+
}
|
|
127
|
+
}
|
|
128
|
+
Atomics.wait(new Int32Array(new SharedArrayBuffer(4)), 0, 0, 100);
|
|
129
|
+
}
|
|
130
|
+
}
|
|
131
|
+
function assembleStore(db, paths, identity, initialCheck, readOnly) {
|
|
132
|
+
const cloneState = { check: initialCheck };
|
|
133
|
+
const writeGuard = () => assertWritable(cloneState.check);
|
|
134
|
+
const audit = new AuditLog(db);
|
|
135
|
+
const scopes = new ScopeRepository(db);
|
|
136
|
+
const memories = new MemoryRepository(db);
|
|
137
|
+
const archives = new ImportArchiveRepository(db);
|
|
138
|
+
const plans = new PlanRepository(db);
|
|
139
|
+
const outbox = new OutboxRepository(db, audit);
|
|
140
|
+
const blocks = new ManagedBlockRepository(db);
|
|
141
|
+
const installations = new DeviceInstallationRepository(db);
|
|
142
|
+
const conflicts = new ConflictRepository(db);
|
|
143
|
+
for (const repo of [scopes, memories, archives, plans, outbox, blocks, installations, conflicts]) {
|
|
144
|
+
repo.setWriteGuard(readOnly ? () => { throw err('E_READONLY', '只读连接拒绝写入'); } : writeGuard);
|
|
145
|
+
}
|
|
146
|
+
const store = {
|
|
147
|
+
paths,
|
|
148
|
+
db,
|
|
149
|
+
identity,
|
|
150
|
+
get cloneCheck() {
|
|
151
|
+
return cloneState.check;
|
|
152
|
+
},
|
|
153
|
+
scopes,
|
|
154
|
+
memories,
|
|
155
|
+
archives,
|
|
156
|
+
plans,
|
|
157
|
+
outbox,
|
|
158
|
+
blocks,
|
|
159
|
+
installations,
|
|
160
|
+
conflicts,
|
|
161
|
+
audit,
|
|
162
|
+
assertWritable() {
|
|
163
|
+
writeGuard();
|
|
164
|
+
},
|
|
165
|
+
reEnroll() {
|
|
166
|
+
const r = reEnrollDevice(db, paths.dataDir);
|
|
167
|
+
cloneState.check = checkCloneState(db, r.identity);
|
|
168
|
+
return r;
|
|
169
|
+
},
|
|
170
|
+
close() {
|
|
171
|
+
db.close();
|
|
172
|
+
},
|
|
173
|
+
};
|
|
174
|
+
return store;
|
|
175
|
+
}
|
|
176
|
+
export { schemaVersion };
|
|
177
|
+
//# sourceMappingURL=open.js.map
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"open.js","sourceRoot":"","sources":["../../../src/store/open.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAE,UAAU,EAAE,QAAQ,EAAE,SAAS,EAAE,MAAM,SAAS,CAAC;AACrE,OAAO,EAAE,IAAI,EAAE,MAAM,WAAW,CAAC;AACjC,OAAO,EAAE,OAAO,EAAE,MAAM,SAAS,CAAC;AAClC,OAAO,EAAE,OAAO,EAAE,sBAAsB,EAAE,MAAM,SAAS,CAAC;AAC1D,OAAO,EAAE,aAAa,EAAE,aAAa,EAAE,UAAU,EAAE,MAAM,cAAc,CAAC;AACxE,OAAO,EAAE,eAAe,EAAE,MAAM,aAAa,CAAC;AAC9C,OAAO,EAAE,gBAAgB,EAAE,MAAM,eAAe,CAAC;AACjD,OAAO,EAAE,uBAAuB,EAAE,MAAM,eAAe,CAAC;AACxD,OAAO,EAAE,cAAc,EAAE,MAAM,YAAY,CAAC;AAC5C,OAAO,EAAE,gBAAgB,EAAE,MAAM,aAAa,CAAC;AAC/C,OAAO,EAAE,sBAAsB,EAAE,4BAA4B,EAAE,MAAM,aAAa,CAAC;AACnF,OAAO,EAAE,kBAAkB,EAAE,MAAM,gBAAgB,CAAC;AACpD,OAAO,EAAE,QAAQ,EAAE,MAAM,YAAY,CAAC;AACtC,OAAO,EACL,YAAY,EACZ,oBAAoB,EACpB,cAAc,EACd,eAAe,EACf,cAAc,EAGd,cAAc,GACf,MAAM,aAAa,CAAC;AACrB,OAAO,EAAE,GAAG,EAAE,MAAM,mBAAmB,CAAC;AACxC,OAAO,EAAE,MAAM,EAAE,MAAM,iBAAiB,CAAC;AAWzC,MAAM,UAAU,WAAW;IACzB,OAAO,OAAO,CAAC,GAAG,CAAC,YAAY,CAAC,IAAI,IAAI,CAAC,OAAO,EAAE,EAAE,QAAQ,CAAC,CAAC;AAChE,CAAC;AAED,MAAM,UAAU,YAAY,CAAC,IAAY;IACvC,MAAM,OAAO,GAAG,IAAI,CAAC,IAAI,EAAE,MAAM,CAAC,CAAC;IACnC,OAAO;QACL,IAAI;QACJ,MAAM,EAAE,IAAI,CAAC,OAAO,EAAE,UAAU,CAAC;QACjC,OAAO;QACP,YAAY,EAAE,IAAI,CAAC,IAAI,EAAE,WAAW,CAAC;QACrC,UAAU,EAAE,IAAI,CAAC,IAAI,EAAE,SAAS,CAAC;KAClC,CAAC;AACJ,CAAC;AAED,MAAM,UAAU,UAAU,CAAC,KAAiB;IAC1C,KAAK,MAAM,CAAC,IAAI,CAAC,KAAK,CAAC,IAAI,EAAE,KAAK,CAAC,OAAO,EAAE,KAAK,CAAC,YAAY,EAAE,KAAK,CAAC,UAAU,CAAC,EAAE,CAAC;QAClF,IAAI,CAAC,UAAU,CAAC,CAAC,CAAC;YAAE,SAAS,CAAC,CAAC,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC;IACxD,CAAC;AACH,CAAC;AA6BD;;;GAGG;AACH,MAAM,UAAU,SAAS,CAAC,OAAyB,EAAE;IACnD,MAAM,KAAK,GAAG,YAAY,CAAC,IAAI,CAAC,IAAI,IAAI,WAAW,EAAE,CAAC,CAAC;IACvD,IAAI,CAAC,IAAI,CAAC,QAAQ;QAAE,UAAU,CAAC,KAAK,CAAC,CAAC;IACtC,IAAI,IAAI,CAAC,QAAQ,IAAI,CAAC,UAAU,CAAC,KAAK,CAAC,MAAM,CAAC,EAAE,CAAC;QAC/C,MAAM,GAAG,CAAC,MAAM,EAAE,iBAAiB,KAAK,CAAC,MAAM,EAAE,CAAC,CAAC;IACrD,CAAC;IACD,MAAM,QAAQ,GAAG,IAAI,CAAC,QAAQ,IAAI,KAAK,CAAC;IACxC,IAAI,CAAC,QAAQ,EAAE,CAAC;QACd,kBAAkB,CAAC,KAAK,CAAC,MAAM,CAAC,CAAC;IACnC,CAAC;IACD,qCAAqC;IACrC,mDAAmD;IACnD,wCAAwC;IACxC,MAAM,WAAW,GAAG,CAAC,CAAC;IACtB,IAAI,SAAS,GAAiB,IAAI,CAAC;IACnC,KAAK,IAAI,OAAO,GAAG,CAAC,EAAE,OAAO,IAAI,WAAW,EAAE,OAAO,EAAE,EAAE,CAAC;QACxD,MAAM,EAAE,GAAG,OAAO,CAAC,IAAI,CAAC,KAAK,CAAC,MAAM,EAAE,EAAE,QAAQ,EAAE,CAAC,CAAC;QACpD,IAAI,CAAC;YACH,IAAI,CAAC,IAAI,CAAC,cAAc,EAAE,CAAC;gBACzB,aAAa,CAAC,EAAE,CAAC,CAAC;gBAClB,4BAA4B;gBAC5B,IAAI,CAAC,QAAQ,EAAE,CAAC;oBACd,EAAE,CAAC,GAAG,CAAC,yEAAyE,EAAE,MAAM,EAAE,CAAC,CAAC;gBAC9F,CAAC;YACH,CAAC;YACD,MAAM,QAAQ,GAAG,QAAQ;gBACvB,CAAC,CAAC,YAAY,CAAC,KAAK,CAAC,OAAO,CAAC,IAAI,EAAE,QAAQ,EAAE,uBAAuB,EAAE,aAAa,EAAE,EAAE,EAAE,SAAS,EAAE,MAAM,EAAE,EAAE;gBAC9G,CAAC,CAAC,oBAAoB,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC;YACxC,IAAI,UAAU,GAAG,eAAe,CAAC,EAAE,EAAE,QAAQ,CAAC,CAAC;YAC/C,IAAI,CAAC,QAAQ,EAAE,CAAC;gBACd,MAAM,MAAM,GAAG,cAAc,CAAC,EAAE,EAAE,QAAQ,CAAC,CAAC;gBAC5C,IAAI,MAAM,CAAC,UAAU,KAAK,SAAS,EAAE,CAAC;oBACpC,EAAE,CAAC,GAAG,CAAC,sDAAsD,EAAE,MAAM,CAAC,EAAE,CAAC,CAAC;gBAC5E,CAAC;gBACD,UAAU,GAAG,eAAe,CAAC,EAAE,EAAE,QAAQ,CAAC,CAAC;YAC7C,CAAC;YACD,OAAO,aAAa,CAAC,EAAE,EAAE,KAAK,EAAE,QAAQ,EAAE,UAAU,EAAE,QAAQ,CAAC,CAAC;QAClE,CAAC;QAAC,OAAO,CAAC,EAAE,CAAC;YACX,SAAS,GAAG,CAAU,CAAC;YACvB,EAAE,CAAC,KAAK,EAAE,CAAC;YACX,IAAI,OAAO,GAAG,WAAW,IAAI,sBAAsB,CAAC,CAAC,CAAC,EAAE,CAAC;gBACvD,OAAO,CAAC,IAAI,CAAC,IAAI,UAAU,CAAC,IAAI,iBAAiB,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,CAAC,EAAE,EAAE,GAAG,OAAO,CAAC,CAAC;gBAC3E,SAAS;YACX,CAAC;YACD,MAAM,CAAC,CAAC;QACV,CAAC;IACH,CAAC;IACD,MAAM,SAAS,IAAI,GAAG,CAAC,MAAM,EAAE,WAAW,KAAK,CAAC,MAAM,EAAE,EAAE,EAAE,QAAQ,EAAE,WAAW,EAAE,CAAC,CAAC;AACvF,CAAC;AAED;;;;GAIG;AACH,SAAS,kBAAkB,CAAC,MAAc;IACxC,IAAI,UAAU,CAAC,MAAM,CAAC;QAAE,OAAO;IAC/B,IAAI,CAAC;QACH,SAAS,CAAC,QAAQ,CAAC,MAAM,EAAE,IAAI,CAAC,CAAC,CAAC;QAClC,OAAO,CAAC,UAAU;IACpB,CAAC;IAAC,OAAO,CAAC,EAAE,CAAC;QACX,IAAK,CAA2B,CAAC,IAAI,KAAK,QAAQ,EAAE,CAAC;YACnD,MAAM,GAAG,CAAC,MAAM,EAAE,aAAa,MAAM,KAAM,CAAW,CAAC,OAAO,EAAE,CAAC,CAAC;QACpE,CAAC;IACH,CAAC;IACD,2BAA2B;IAC3B,MAAM,QAAQ,GAAG,IAAI,CAAC,GAAG,EAAE,GAAG,MAAM,CAAC;IACrC,SAAS,CAAC;QACR,IAAI,IAAI,CAAC,GAAG,EAAE,GAAG,QAAQ,EAAE,CAAC;YAC1B,MAAM,GAAG,CAAC,aAAa,EAAE,aAAa,MAAM,YAAY,CAAC,CAAC;QAC5D,CAAC;QACD,IAAI,UAAU,CAAC,MAAM,CAAC,EAAE,CAAC;YACvB,IAAI,KAAK,GAAmB,IAAI,CAAC;YACjC,IAAI,CAAC;gBACH,KAAK,GAAG,OAAO,CAAC,IAAI,CAAC,MAAM,EAAE,EAAE,QAAQ,EAAE,IAAI,EAAE,aAAa,EAAE,GAAG,EAAE,CAAC,CAAC;gBACrE,MAAM,CAAC,GAAG,aAAa,CAAC,KAAK,CAAC,CAAC;gBAC/B,KAAK,CAAC,KAAK,EAAE,CAAC;gBACd,KAAK,GAAG,IAAI,CAAC;gBACb,IAAI,CAAC,IAAI,UAAU,CAAC,MAAM;oBAAE,OAAO;YACrC,CAAC;YAAC,MAAM,CAAC;gBACP,KAAK,EAAE,KAAK,EAAE,CAAC;YACjB,CAAC;QACH,CAAC;QACD,OAAO,CAAC,IAAI,CAAC,IAAI,UAAU,CAAC,IAAI,iBAAiB,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,CAAC,EAAE,GAAG,CAAC,CAAC;IACpE,CAAC;AACH,CAAC;AAED,SAAS,aAAa,CACpB,EAAW,EACX,KAAiB,EACjB,QAA4B,EAC5B,YAA8B,EAC9B,QAAiB;IAEjB,MAAM,UAAU,GAAgC,EAAE,KAAK,EAAE,YAAY,EAAE,CAAC;IACxE,MAAM,UAAU,GAAG,GAAS,EAAE,CAAC,cAAc,CAAC,UAAU,CAAC,KAAK,CAAC,CAAC;IAChE,MAAM,KAAK,GAAG,IAAI,QAAQ,CAAC,EAAE,CAAC,CAAC;IAC/B,MAAM,MAAM,GAAG,IAAI,eAAe,CAAC,EAAE,CAAC,CAAC;IACvC,MAAM,QAAQ,GAAG,IAAI,gBAAgB,CAAC,EAAE,CAAC,CAAC;IAC1C,MAAM,QAAQ,GAAG,IAAI,uBAAuB,CAAC,EAAE,CAAC,CAAC;IACjD,MAAM,KAAK,GAAG,IAAI,cAAc,CAAC,EAAE,CAAC,CAAC;IACrC,MAAM,MAAM,GAAG,IAAI,gBAAgB,CAAC,EAAE,EAAE,KAAK,CAAC,CAAC;IAC/C,MAAM,MAAM,GAAG,IAAI,sBAAsB,CAAC,EAAE,CAAC,CAAC;IAC9C,MAAM,aAAa,GAAG,IAAI,4BAA4B,CAAC,EAAE,CAAC,CAAC;IAC3D,MAAM,SAAS,GAAG,IAAI,kBAAkB,CAAC,EAAE,CAAC,CAAC;IAC7C,KAAK,MAAM,IAAI,IAAI,CAAC,MAAM,EAAE,QAAQ,EAAE,QAAQ,EAAE,KAAK,EAAE,MAAM,EAAE,MAAM,EAAE,aAAa,EAAE,SAAS,CAAC,EAAE,CAAC;QACjG,IAAI,CAAC,aAAa,CAAC,QAAQ,CAAC,CAAC,CAAC,GAAG,EAAE,GAAG,MAAM,GAAG,CAAC,YAAY,EAAE,UAAU,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,UAAU,CAAC,CAAC;IAC7F,CAAC;IACD,MAAM,KAAK,GAAe;QACxB,KAAK;QACL,EAAE;QACF,QAAQ;QACR,IAAI,UAAU;YACZ,OAAO,UAAU,CAAC,KAAK,CAAC;QAC1B,CAAC;QACD,MAAM;QACN,QAAQ;QACR,QAAQ;QACR,KAAK;QACL,MAAM;QACN,MAAM;QACN,aAAa;QACb,SAAS;QACT,KAAK;QACL,cAAc;YACZ,UAAU,EAAE,CAAC;QACf,CAAC;QACD,QAAQ;YACN,MAAM,CAAC,GAAG,cAAc,CAAC,EAAE,EAAE,KAAK,CAAC,OAAO,CAAC,CAAC;YAC5C,UAAU,CAAC,KAAK,GAAG,eAAe,CAAC,EAAE,EAAE,CAAC,CAAC,QAAQ,CAAC,CAAC;YACnD,OAAO,CAAC,CAAC;QACX,CAAC;QACD,KAAK;YACH,EAAE,CAAC,KAAK,EAAE,CAAC;QACb,CAAC;KACF,CAAC;IACF,OAAO,KAAK,CAAC;AACf,CAAC;AAED,OAAO,EAAE,aAAa,EAAE,CAAC"}
|
|
@@ -0,0 +1,65 @@
|
|
|
1
|
+
import { CairnDb } from './db.js';
|
|
2
|
+
import { AuditLog } from './audit.js';
|
|
3
|
+
import { WriteGuardMixin } from './write-guard.js';
|
|
4
|
+
/**
|
|
5
|
+
* 本地 outbox(任务 5.3):后台任务的本地可靠边界。
|
|
6
|
+
* job_type=sync_upstream 受作用域物理排除(触发器 + 应用层双重检查);
|
|
7
|
+
* 默认不安装同步 hook,任务由独立 worker 或显式 CLI 处理。
|
|
8
|
+
*/
|
|
9
|
+
export type JobType = 'sync_upstream' | 'extract' | 'embed' | 'maintain' | 'projection_rebuild';
|
|
10
|
+
export type JobStatus = 'pending' | 'running' | 'done' | 'retry' | 'failed' | 'dead' | 'conflict';
|
|
11
|
+
export interface JobRow {
|
|
12
|
+
id: string;
|
|
13
|
+
jobType: JobType;
|
|
14
|
+
scopeId: string | null;
|
|
15
|
+
entityType: 'memory' | 'revision' | 'plan' | 'archive' | 'system';
|
|
16
|
+
entityId: string;
|
|
17
|
+
payload: Record<string, unknown>;
|
|
18
|
+
payloadHash: string;
|
|
19
|
+
idempotencyKey: string;
|
|
20
|
+
status: JobStatus;
|
|
21
|
+
attempts: number;
|
|
22
|
+
maxAttempts: number;
|
|
23
|
+
nextAttemptAt: string | null;
|
|
24
|
+
lastError: string | null;
|
|
25
|
+
createdAt: string;
|
|
26
|
+
updatedAt: string;
|
|
27
|
+
}
|
|
28
|
+
export interface EnqueueJobInput {
|
|
29
|
+
jobType: JobType;
|
|
30
|
+
scopeId: string | null;
|
|
31
|
+
entityType: JobRow['entityType'];
|
|
32
|
+
entityId: string;
|
|
33
|
+
payload?: Record<string, unknown>;
|
|
34
|
+
idempotencyKey: string;
|
|
35
|
+
maxAttempts?: number;
|
|
36
|
+
}
|
|
37
|
+
/** 上行退避基数(毫秒);本变更无真实云端,仅用于故障注入与可重试状态验证。 */
|
|
38
|
+
export declare const RETRY_BACKOFF_MS: readonly [1000, 5000, 30000, number, number];
|
|
39
|
+
export declare class OutboxRepository extends WriteGuardMixin {
|
|
40
|
+
private readonly db;
|
|
41
|
+
private readonly audit;
|
|
42
|
+
constructor(db: CairnDb, audit: AuditLog);
|
|
43
|
+
/**
|
|
44
|
+
* 入队。local_only/设备限定内容对 sync_upstream 物理排除:
|
|
45
|
+
* 返回 { enqueued: false, reason: 'scope_local_only' } 并记录审计。
|
|
46
|
+
*/
|
|
47
|
+
enqueue(input: EnqueueJobInput): {
|
|
48
|
+
job: JobRow | null;
|
|
49
|
+
enqueued: boolean;
|
|
50
|
+
reason?: string;
|
|
51
|
+
};
|
|
52
|
+
requireById(id: string): JobRow;
|
|
53
|
+
/** 领取到期任务:pending/retry 且 next_attempt_at <= now;置 running。 */
|
|
54
|
+
claimReady(limit: number, now?: string): JobRow[];
|
|
55
|
+
markDone(id: string): void;
|
|
56
|
+
/** 失败重试:超上限转 dead 并保留原因;绝不无限循环;终态任务不再变化。 */
|
|
57
|
+
markFailedRetry(id: string, error: string, now?: string): JobRow;
|
|
58
|
+
resetRunningToPending(now?: string): number;
|
|
59
|
+
counts(): Record<JobStatus, number>;
|
|
60
|
+
list(filter?: {
|
|
61
|
+
status?: JobStatus;
|
|
62
|
+
jobType?: JobType;
|
|
63
|
+
limit?: number;
|
|
64
|
+
}): JobRow[];
|
|
65
|
+
}
|
|
@@ -0,0 +1,137 @@
|
|
|
1
|
+
import { err } from '../core/errors.js';
|
|
2
|
+
import { uuidv7 } from '../core/ids.js';
|
|
3
|
+
import { nowIso } from '../core/time.js';
|
|
4
|
+
import { sha256Canonical } from '../core/hash.js';
|
|
5
|
+
import { WriteGuardMixin } from './write-guard.js';
|
|
6
|
+
/** 上行退避基数(毫秒);本变更无真实云端,仅用于故障注入与可重试状态验证。 */
|
|
7
|
+
export const RETRY_BACKOFF_MS = [1_000, 5_000, 30_000, 5 * 60_000, 30 * 60_000];
|
|
8
|
+
export class OutboxRepository extends WriteGuardMixin {
|
|
9
|
+
db;
|
|
10
|
+
audit;
|
|
11
|
+
constructor(db, audit) {
|
|
12
|
+
super();
|
|
13
|
+
this.db = db;
|
|
14
|
+
this.audit = audit;
|
|
15
|
+
}
|
|
16
|
+
/**
|
|
17
|
+
* 入队。local_only/设备限定内容对 sync_upstream 物理排除:
|
|
18
|
+
* 返回 { enqueued: false, reason: 'scope_local_only' } 并记录审计。
|
|
19
|
+
*/
|
|
20
|
+
enqueue(input) {
|
|
21
|
+
this.checkWritable();
|
|
22
|
+
if (input.jobType === 'sync_upstream' && input.scopeId) {
|
|
23
|
+
const scope = this.db.get('SELECT sync_policy, device_id FROM scope WHERE id = ?', input.scopeId);
|
|
24
|
+
if (!scope)
|
|
25
|
+
throw err('E_NOT_FOUND', `作用域不存在: ${input.scopeId}`);
|
|
26
|
+
const upstreamable = scope.sync_policy === 'encrypted' && scope.device_id === 'all';
|
|
27
|
+
if (!upstreamable) {
|
|
28
|
+
this.audit.record('scope_exclusion', 'outbox_upstream_excluded', { type: 'scope', id: input.scopeId }, {
|
|
29
|
+
jobId: input.idempotencyKey,
|
|
30
|
+
reason: scope.sync_policy !== 'encrypted' ? 'local_only' : 'device_bound',
|
|
31
|
+
});
|
|
32
|
+
return { job: null, enqueued: false, reason: scope.sync_policy !== 'encrypted' ? 'scope_local_only' : 'scope_device_bound' };
|
|
33
|
+
}
|
|
34
|
+
}
|
|
35
|
+
const payload = input.payload ?? {};
|
|
36
|
+
const payloadHash = sha256Canonical(payload);
|
|
37
|
+
const existing = this.db.get('SELECT * FROM outbox_job WHERE idempotency_key = ?', input.idempotencyKey);
|
|
38
|
+
if (existing)
|
|
39
|
+
return { job: mapJob(existing), enqueued: false, reason: 'duplicate' };
|
|
40
|
+
const id = uuidv7();
|
|
41
|
+
const at = nowIso();
|
|
42
|
+
this.db.run(`INSERT INTO outbox_job (id, job_type, scope_id, entity_type, entity_id, payload, payload_hash,
|
|
43
|
+
idempotency_key, status, attempts, max_attempts, next_attempt_at, created_at, updated_at)
|
|
44
|
+
VALUES (?, ?, ?, ?, ?, ?, ?, ?, 'pending', 0, ?, ?, ?, ?)`, id, input.jobType, input.scopeId, input.entityType, input.entityId, JSON.stringify(payload), payloadHash, input.idempotencyKey, input.maxAttempts ?? 5, at, at, at);
|
|
45
|
+
return { job: this.requireById(id), enqueued: true };
|
|
46
|
+
}
|
|
47
|
+
requireById(id) {
|
|
48
|
+
const row = this.db.get('SELECT * FROM outbox_job WHERE id = ?', id);
|
|
49
|
+
if (!row)
|
|
50
|
+
throw err('E_NOT_FOUND', `任务不存在: ${id}`);
|
|
51
|
+
return mapJob(row);
|
|
52
|
+
}
|
|
53
|
+
/** 领取到期任务:pending/retry 且 next_attempt_at <= now;置 running。 */
|
|
54
|
+
claimReady(limit, now = nowIso()) {
|
|
55
|
+
return this.db.transaction(() => {
|
|
56
|
+
const rows = this.db.all(`SELECT * FROM outbox_job WHERE status IN ('pending','retry') AND (next_attempt_at IS NULL OR next_attempt_at <= ?)
|
|
57
|
+
ORDER BY next_attempt_at, created_at LIMIT ?`, now, limit);
|
|
58
|
+
for (const r of rows) {
|
|
59
|
+
this.db.run("UPDATE outbox_job SET status = 'running', updated_at = ? WHERE id = ?", now, r.id);
|
|
60
|
+
}
|
|
61
|
+
return rows.map((r) => ({ ...mapJob(r), status: 'running' }));
|
|
62
|
+
});
|
|
63
|
+
}
|
|
64
|
+
markDone(id) {
|
|
65
|
+
this.db.run("UPDATE outbox_job SET status = 'done', updated_at = ? WHERE id = ?", nowIso(), id);
|
|
66
|
+
}
|
|
67
|
+
/** 失败重试:超上限转 dead 并保留原因;绝不无限循环;终态任务不再变化。 */
|
|
68
|
+
markFailedRetry(id, error, now = nowIso()) {
|
|
69
|
+
const job = this.requireById(id);
|
|
70
|
+
if (job.status === 'dead' || job.status === 'done')
|
|
71
|
+
return job;
|
|
72
|
+
const attempts = job.attempts + 1;
|
|
73
|
+
if (attempts >= job.maxAttempts) {
|
|
74
|
+
this.db.run("UPDATE outbox_job SET status = 'dead', attempts = ?, last_error = ?, updated_at = ? WHERE id = ?", attempts, error, now, id);
|
|
75
|
+
}
|
|
76
|
+
else {
|
|
77
|
+
const backoff = RETRY_BACKOFF_MS[Math.min(attempts - 1, RETRY_BACKOFF_MS.length - 1)] ?? 60_000;
|
|
78
|
+
this.db.run("UPDATE outbox_job SET status = 'retry', attempts = ?, last_error = ?, next_attempt_at = ?, updated_at = ? WHERE id = ?", attempts, error, new Date(new Date(now).getTime() + backoff).toISOString(), now, id);
|
|
79
|
+
}
|
|
80
|
+
return this.requireById(id);
|
|
81
|
+
}
|
|
82
|
+
resetRunningToPending(now = nowIso()) {
|
|
83
|
+
// worker 崩溃后遗留的 running 任务复位(幂等续跑)
|
|
84
|
+
const r = this.db.run("UPDATE outbox_job SET status = 'pending', updated_at = ? WHERE status = 'running'", now);
|
|
85
|
+
return Number(r.changes);
|
|
86
|
+
}
|
|
87
|
+
counts() {
|
|
88
|
+
const out = Object.fromEntries(['pending', 'running', 'done', 'retry', 'failed', 'dead', 'conflict'].map((s) => [s, 0]));
|
|
89
|
+
for (const r of this.db.all('SELECT status, COUNT(*) AS n FROM outbox_job GROUP BY status')) {
|
|
90
|
+
out[r.status] = Number(r.n);
|
|
91
|
+
}
|
|
92
|
+
return out;
|
|
93
|
+
}
|
|
94
|
+
list(filter = {}) {
|
|
95
|
+
const where = [];
|
|
96
|
+
const params = [];
|
|
97
|
+
if (filter.status) {
|
|
98
|
+
where.push('status = ?');
|
|
99
|
+
params.push(filter.status);
|
|
100
|
+
}
|
|
101
|
+
if (filter.jobType) {
|
|
102
|
+
where.push('job_type = ?');
|
|
103
|
+
params.push(filter.jobType);
|
|
104
|
+
}
|
|
105
|
+
params.push(filter.limit ?? 100);
|
|
106
|
+
return this.db
|
|
107
|
+
.all(`SELECT * FROM outbox_job ${where.length ? 'WHERE ' + where.join(' AND ') : ''} ORDER BY created_at DESC LIMIT ?`, ...params)
|
|
108
|
+
.map(mapJob);
|
|
109
|
+
}
|
|
110
|
+
}
|
|
111
|
+
function mapJob(r) {
|
|
112
|
+
let payload = {};
|
|
113
|
+
try {
|
|
114
|
+
payload = JSON.parse(r.payload ?? '{}');
|
|
115
|
+
}
|
|
116
|
+
catch {
|
|
117
|
+
payload = {};
|
|
118
|
+
}
|
|
119
|
+
return {
|
|
120
|
+
id: r.id,
|
|
121
|
+
jobType: r.job_type,
|
|
122
|
+
scopeId: r.scope_id ?? null,
|
|
123
|
+
entityType: r.entity_type,
|
|
124
|
+
entityId: r.entity_id,
|
|
125
|
+
payload,
|
|
126
|
+
payloadHash: r.payload_hash,
|
|
127
|
+
idempotencyKey: r.idempotency_key,
|
|
128
|
+
status: r.status,
|
|
129
|
+
attempts: Number(r.attempts),
|
|
130
|
+
maxAttempts: Number(r.max_attempts),
|
|
131
|
+
nextAttemptAt: r.next_attempt_at ?? null,
|
|
132
|
+
lastError: r.last_error ?? null,
|
|
133
|
+
createdAt: r.created_at,
|
|
134
|
+
updatedAt: r.updated_at,
|
|
135
|
+
};
|
|
136
|
+
}
|
|
137
|
+
//# sourceMappingURL=outbox.js.map
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"outbox.js","sourceRoot":"","sources":["../../../src/store/outbox.ts"],"names":[],"mappings":"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"}
|
|
@@ -0,0 +1,137 @@
|
|
|
1
|
+
import { CairnDb } from './db.js';
|
|
2
|
+
import { MemoryKind, Sensitivity } from '../core/types.js';
|
|
3
|
+
import { WriteGuardMixin } from './write-guard.js';
|
|
4
|
+
/**
|
|
5
|
+
* 计划与审批仓储(任务 3.1/3.2)。
|
|
6
|
+
* plan_hash 基于【规范化】计划内容(操作列表 + 目标修订 + 作用域 + 来源),
|
|
7
|
+
* 字段顺序、空白、来源数组顺序变化不得影响哈希;任何内容变化必然改变哈希。
|
|
8
|
+
* 审批一次性、有有效期;plan_hash 变化由触发器自动撤销在途审批。
|
|
9
|
+
*/
|
|
10
|
+
export type PlanOpType = 'add' | 'merge' | 'keep_both' | 'skip';
|
|
11
|
+
export type PlanStatus = 'draft' | 'awaiting_approval' | 'approved' | 'applied' | 'expired' | 'invalidated' | 'rejected';
|
|
12
|
+
export interface PlanOpInput {
|
|
13
|
+
opType: PlanOpType;
|
|
14
|
+
/** merge/keep_both 的目标记忆。 */
|
|
15
|
+
targetMemoryId?: string | null;
|
|
16
|
+
/** 目标修订快照:应用时重检,目标推进后拒绝(E_TARGET_CHANGED)。 */
|
|
17
|
+
targetExpectedRevision?: string | null;
|
|
18
|
+
itemId?: string | null;
|
|
19
|
+
content?: string | null;
|
|
20
|
+
scopeId?: string | null;
|
|
21
|
+
kind?: MemoryKind | null;
|
|
22
|
+
sensitivity?: Sensitivity | null;
|
|
23
|
+
reason?: string | null;
|
|
24
|
+
mergedFrom?: string[];
|
|
25
|
+
}
|
|
26
|
+
export interface PlanOpRecord {
|
|
27
|
+
id: string;
|
|
28
|
+
planId: string;
|
|
29
|
+
opIndex: number;
|
|
30
|
+
opType: PlanOpType;
|
|
31
|
+
targetMemoryId: string | null;
|
|
32
|
+
targetExpectedRevision: string | null;
|
|
33
|
+
itemId: string | null;
|
|
34
|
+
content: string | null;
|
|
35
|
+
contentHash: string | null;
|
|
36
|
+
scopeId: string | null;
|
|
37
|
+
kind: MemoryKind | null;
|
|
38
|
+
reason: string | null;
|
|
39
|
+
mergedFrom: string[];
|
|
40
|
+
idempotencyKey: string;
|
|
41
|
+
status: 'pending' | 'applied' | 'skipped' | 'failed';
|
|
42
|
+
appliedAt: string | null;
|
|
43
|
+
error: string | null;
|
|
44
|
+
}
|
|
45
|
+
export interface PlanRecord {
|
|
46
|
+
id: string;
|
|
47
|
+
planHash: string;
|
|
48
|
+
scopeId: string;
|
|
49
|
+
status: PlanStatus;
|
|
50
|
+
sourceArchiveIds: string[];
|
|
51
|
+
itemCount: number;
|
|
52
|
+
proposedBy: string;
|
|
53
|
+
modelProvider: string | null;
|
|
54
|
+
createdAt: string;
|
|
55
|
+
expiresAt: string;
|
|
56
|
+
appliedAt: string | null;
|
|
57
|
+
}
|
|
58
|
+
export interface ApprovalRecord {
|
|
59
|
+
id: string;
|
|
60
|
+
planId: string;
|
|
61
|
+
planHash: string;
|
|
62
|
+
approvedBy: 'user' | 'local_cli' | 'mcp_ui';
|
|
63
|
+
channel: string;
|
|
64
|
+
approvedAt: string;
|
|
65
|
+
expiresAt: string;
|
|
66
|
+
revokedAt: string | null;
|
|
67
|
+
maxUses: number;
|
|
68
|
+
uses: number;
|
|
69
|
+
}
|
|
70
|
+
export interface CanonicalPlanOp {
|
|
71
|
+
op_index: number;
|
|
72
|
+
op_type: PlanOpType;
|
|
73
|
+
target_memory_id: string | null;
|
|
74
|
+
target_expected_revision: string | null;
|
|
75
|
+
item_id: string | null;
|
|
76
|
+
content_hash: string | null;
|
|
77
|
+
scope_id: string | null;
|
|
78
|
+
kind: MemoryKind | null;
|
|
79
|
+
merged_from: string[];
|
|
80
|
+
}
|
|
81
|
+
export interface CanonicalPlan {
|
|
82
|
+
v: 1;
|
|
83
|
+
scope_id: string;
|
|
84
|
+
source_archive_ids: string[];
|
|
85
|
+
ops: CanonicalPlanOp[];
|
|
86
|
+
}
|
|
87
|
+
/** 规范化计划:内容进哈希的一律是哈希/ID/索引,正文不直接参与(稳定性+防篡改)。 */
|
|
88
|
+
export declare function canonicalizePlan(input: {
|
|
89
|
+
scopeId: string;
|
|
90
|
+
sourceArchiveIds: string[];
|
|
91
|
+
ops: PlanOpInput[];
|
|
92
|
+
hashContent: (content: string) => string;
|
|
93
|
+
}): CanonicalPlan;
|
|
94
|
+
export declare class PlanRepository extends WriteGuardMixin {
|
|
95
|
+
private readonly db;
|
|
96
|
+
constructor(db: CairnDb);
|
|
97
|
+
/** 创建计划(awaiting_approval):ops 落库并计算 plan_hash。 */
|
|
98
|
+
createPlan(input: {
|
|
99
|
+
scopeId: string;
|
|
100
|
+
sourceArchiveIds?: string[];
|
|
101
|
+
ops: PlanOpInput[];
|
|
102
|
+
proposedBy: string;
|
|
103
|
+
modelProvider?: string | null;
|
|
104
|
+
ttlMs?: number;
|
|
105
|
+
keyPrefix?: string;
|
|
106
|
+
}): {
|
|
107
|
+
plan: PlanRecord;
|
|
108
|
+
planHash: string;
|
|
109
|
+
};
|
|
110
|
+
requireById(id: string): PlanRecord;
|
|
111
|
+
findById(id: string): PlanRecord | null;
|
|
112
|
+
ops(planId: string): PlanOpRecord[];
|
|
113
|
+
requireOp(planId: string, opIndex: number): PlanOpRecord;
|
|
114
|
+
markOpApplied(opId: string): void;
|
|
115
|
+
markOpSkipped(opId: string): void;
|
|
116
|
+
markOpFailed(opId: string, error: string): void;
|
|
117
|
+
setStatus(id: string, status: PlanStatus): void;
|
|
118
|
+
/** 过期清扫:返回被标记过期的计划 id。 */
|
|
119
|
+
expireStale(now?: string): string[];
|
|
120
|
+
issueApproval(input: {
|
|
121
|
+
planId: string;
|
|
122
|
+
channel: string;
|
|
123
|
+
approvedBy?: 'user' | 'local_cli' | 'mcp_ui';
|
|
124
|
+
ttlMs?: number;
|
|
125
|
+
maxUses?: number;
|
|
126
|
+
}): {
|
|
127
|
+
approval: ApprovalRecord;
|
|
128
|
+
};
|
|
129
|
+
liveApproval(planId: string): ApprovalRecord | null;
|
|
130
|
+
requireApproval(id: string): ApprovalRecord;
|
|
131
|
+
/**
|
|
132
|
+
* 消费一次性审批:校验存在、绑定计划、哈希一致、未撤销、未过期、未用尽。
|
|
133
|
+
* 任一失败抛对应 E_APPROVAL_*,并保持 uses 不变(失败不消耗)。
|
|
134
|
+
*/
|
|
135
|
+
consumeApproval(approvalId: string, planId: string, planHash: string, now?: string): ApprovalRecord;
|
|
136
|
+
revokeApproval(approvalId: string): void;
|
|
137
|
+
}
|