@carloswon/cairn-memory 0.0.0-stage → 0.3.0
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- package/CHANGELOG.md +81 -0
- package/LICENSE +21 -0
- package/README.md +158 -2
- package/dist/src/agents/adapters.d.ts +82 -0
- package/dist/src/agents/adapters.js +209 -0
- package/dist/src/agents/adapters.js.map +1 -0
- package/dist/src/agents/config.d.ts +82 -0
- package/dist/src/agents/config.js +603 -0
- package/dist/src/agents/config.js.map +1 -0
- package/dist/src/agents/cordisPatch.d.ts +89 -0
- package/dist/src/agents/cordisPatch.js +201 -0
- package/dist/src/agents/cordisPatch.js.map +1 -0
- package/dist/src/agents/index.d.ts +2 -0
- package/dist/src/agents/index.js +3 -0
- package/dist/src/agents/index.js.map +1 -0
- package/dist/src/core/errors.d.ts +36 -0
- package/dist/src/core/errors.js +74 -0
- package/dist/src/core/errors.js.map +1 -0
- package/dist/src/core/hash.d.ts +14 -0
- package/dist/src/core/hash.js +48 -0
- package/dist/src/core/hash.js.map +1 -0
- package/dist/src/core/ids.d.ts +10 -0
- package/dist/src/core/ids.js +41 -0
- package/dist/src/core/ids.js.map +1 -0
- package/dist/src/core/index.d.ts +6 -0
- package/dist/src/core/index.js +7 -0
- package/dist/src/core/index.js.map +1 -0
- package/dist/src/core/scope.d.ts +78 -0
- package/dist/src/core/scope.js +181 -0
- package/dist/src/core/scope.js.map +1 -0
- package/dist/src/core/secrets.d.ts +13 -0
- package/dist/src/core/secrets.js +122 -0
- package/dist/src/core/secrets.js.map +1 -0
- package/dist/src/core/time.d.ts +7 -0
- package/dist/src/core/time.js +18 -0
- package/dist/src/core/time.js.map +1 -0
- package/dist/src/core/types.d.ts +139 -0
- package/dist/src/core/types.js +30 -0
- package/dist/src/core/types.js.map +1 -0
- package/dist/src/governance/apply.d.ts +64 -0
- package/dist/src/governance/apply.js +160 -0
- package/dist/src/governance/apply.js.map +1 -0
- package/dist/src/governance/archive.d.ts +29 -0
- package/dist/src/governance/archive.js +52 -0
- package/dist/src/governance/archive.js.map +1 -0
- package/dist/src/governance/dedup.d.ts +21 -0
- package/dist/src/governance/dedup.js +23 -0
- package/dist/src/governance/dedup.js.map +1 -0
- package/dist/src/governance/index.d.ts +16 -0
- package/dist/src/governance/index.js +17 -0
- package/dist/src/governance/index.js.map +1 -0
- package/dist/src/governance/propose.d.ts +78 -0
- package/dist/src/governance/propose.js +150 -0
- package/dist/src/governance/propose.js.map +1 -0
- package/dist/src/index.d.ts +15 -0
- package/dist/src/index.js +24 -0
- package/dist/src/index.js.map +1 -0
- package/dist/src/interfaces/app-service.d.ts +292 -0
- package/dist/src/interfaces/app-service.js +743 -0
- package/dist/src/interfaces/app-service.js.map +1 -0
- package/dist/src/interfaces/cli/main.d.ts +2 -0
- package/dist/src/interfaces/cli/main.js +854 -0
- package/dist/src/interfaces/cli/main.js.map +1 -0
- package/dist/src/interfaces/console/assets/page.d.ts +18 -0
- package/dist/src/interfaces/console/assets/page.js +39 -0
- package/dist/src/interfaces/console/assets/page.js.map +1 -0
- package/dist/src/interfaces/console/assets/ui-css.d.ts +11 -0
- package/dist/src/interfaces/console/assets/ui-css.js +119 -0
- package/dist/src/interfaces/console/assets/ui-css.js.map +1 -0
- package/dist/src/interfaces/console/assets/ui-js.d.ts +14 -0
- package/dist/src/interfaces/console/assets/ui-js.js +1098 -0
- package/dist/src/interfaces/console/assets/ui-js.js.map +1 -0
- package/dist/src/interfaces/console/assets/url-state.d.ts +9 -0
- package/dist/src/interfaces/console/assets/url-state.js +45 -0
- package/dist/src/interfaces/console/assets/url-state.js.map +1 -0
- package/dist/src/interfaces/console/export.d.ts +46 -0
- package/dist/src/interfaces/console/export.js +84 -0
- package/dist/src/interfaces/console/export.js.map +1 -0
- package/dist/src/interfaces/console/model.d.ts +372 -0
- package/dist/src/interfaces/console/model.js +731 -0
- package/dist/src/interfaces/console/model.js.map +1 -0
- package/dist/src/interfaces/console/review-store.d.ts +142 -0
- package/dist/src/interfaces/console/review-store.js +342 -0
- package/dist/src/interfaces/console/review-store.js.map +1 -0
- package/dist/src/interfaces/console/security.d.ts +76 -0
- package/dist/src/interfaces/console/security.js +105 -0
- package/dist/src/interfaces/console/security.js.map +1 -0
- package/dist/src/interfaces/console/server.d.ts +45 -0
- package/dist/src/interfaces/console/server.js +476 -0
- package/dist/src/interfaces/console/server.js.map +1 -0
- package/dist/src/interfaces/console/suggestions.d.ts +112 -0
- package/dist/src/interfaces/console/suggestions.js +511 -0
- package/dist/src/interfaces/console/suggestions.js.map +1 -0
- package/dist/src/interfaces/console/text.d.ts +4 -0
- package/dist/src/interfaces/console/text.js +18 -0
- package/dist/src/interfaces/console/text.js.map +1 -0
- package/dist/src/interfaces/mcp/server.d.ts +4 -0
- package/dist/src/interfaces/mcp/server.js +480 -0
- package/dist/src/interfaces/mcp/server.js.map +1 -0
- package/dist/src/jobs/index.d.ts +6 -0
- package/dist/src/jobs/index.js +7 -0
- package/dist/src/jobs/index.js.map +1 -0
- package/dist/src/jobs/remote.d.ts +42 -0
- package/dist/src/jobs/remote.js +34 -0
- package/dist/src/jobs/remote.js.map +1 -0
- package/dist/src/jobs/worker.d.ts +67 -0
- package/dist/src/jobs/worker.js +169 -0
- package/dist/src/jobs/worker.js.map +1 -0
- package/dist/src/onboarding/auto.d.ts +88 -0
- package/dist/src/onboarding/auto.js +399 -0
- package/dist/src/onboarding/auto.js.map +1 -0
- package/dist/src/onboarding/batches.d.ts +103 -0
- package/dist/src/onboarding/batches.js +219 -0
- package/dist/src/onboarding/batches.js.map +1 -0
- package/dist/src/onboarding/discover.d.ts +54 -0
- package/dist/src/onboarding/discover.js +369 -0
- package/dist/src/onboarding/discover.js.map +1 -0
- package/dist/src/onboarding/import.d.ts +69 -0
- package/dist/src/onboarding/import.js +279 -0
- package/dist/src/onboarding/import.js.map +1 -0
- package/dist/src/onboarding/index.d.ts +24 -0
- package/dist/src/onboarding/index.js +22 -0
- package/dist/src/onboarding/index.js.map +1 -0
- package/dist/src/onboarding/judgement.d.ts +50 -0
- package/dist/src/onboarding/judgement.js +121 -0
- package/dist/src/onboarding/judgement.js.map +1 -0
- package/dist/src/onboarding/policy.d.ts +86 -0
- package/dist/src/onboarding/policy.js +249 -0
- package/dist/src/onboarding/policy.js.map +1 -0
- package/dist/src/projection/brief.d.ts +112 -0
- package/dist/src/projection/brief.js +200 -0
- package/dist/src/projection/brief.js.map +1 -0
- package/dist/src/projection/index.d.ts +1 -0
- package/dist/src/projection/index.js +2 -0
- package/dist/src/projection/index.js.map +1 -0
- package/dist/src/projection/markdown.d.ts +82 -0
- package/dist/src/projection/markdown.js +313 -0
- package/dist/src/projection/markdown.js.map +1 -0
- package/dist/src/retrieval/export.d.ts +80 -0
- package/dist/src/retrieval/export.js +215 -0
- package/dist/src/retrieval/export.js.map +1 -0
- package/dist/src/retrieval/index.d.ts +5 -0
- package/dist/src/retrieval/index.js +6 -0
- package/dist/src/retrieval/index.js.map +1 -0
- package/dist/src/retrieval/search.d.ts +37 -0
- package/dist/src/retrieval/search.js +294 -0
- package/dist/src/retrieval/search.js.map +1 -0
- package/dist/src/store/archives.d.ts +94 -0
- package/dist/src/store/archives.js +135 -0
- package/dist/src/store/archives.js.map +1 -0
- package/dist/src/store/audit.d.ts +57 -0
- package/dist/src/store/audit.js +131 -0
- package/dist/src/store/audit.js.map +1 -0
- package/dist/src/store/backup.d.ts +36 -0
- package/dist/src/store/backup.js +90 -0
- package/dist/src/store/backup.js.map +1 -0
- package/dist/src/store/blocks.d.ts +64 -0
- package/dist/src/store/blocks.js +104 -0
- package/dist/src/store/blocks.js.map +1 -0
- package/dist/src/store/conflicts.d.ts +52 -0
- package/dist/src/store/conflicts.js +112 -0
- package/dist/src/store/conflicts.js.map +1 -0
- package/dist/src/store/db.d.ts +44 -0
- package/dist/src/store/db.js +162 -0
- package/dist/src/store/db.js.map +1 -0
- package/dist/src/store/device.d.ts +46 -0
- package/dist/src/store/device.js +111 -0
- package/dist/src/store/device.js.map +1 -0
- package/dist/src/store/index.d.ts +14 -0
- package/dist/src/store/index.js +15 -0
- package/dist/src/store/index.js.map +1 -0
- package/dist/src/store/memories.d.ts +133 -0
- package/dist/src/store/memories.js +442 -0
- package/dist/src/store/memories.js.map +1 -0
- package/dist/src/store/migrate.d.ts +32 -0
- package/dist/src/store/migrate.js +87 -0
- package/dist/src/store/migrate.js.map +1 -0
- package/dist/src/store/open.d.ts +53 -0
- package/dist/src/store/open.js +203 -0
- package/dist/src/store/open.js.map +1 -0
- package/dist/src/store/outbox.d.ts +65 -0
- package/dist/src/store/outbox.js +137 -0
- package/dist/src/store/outbox.js.map +1 -0
- package/dist/src/store/plans.d.ts +137 -0
- package/dist/src/store/plans.js +243 -0
- package/dist/src/store/plans.js.map +1 -0
- package/dist/src/store/schema.d.ts +46 -0
- package/dist/src/store/schema.js +544 -0
- package/dist/src/store/schema.js.map +1 -0
- package/dist/src/store/scopes.d.ts +44 -0
- package/dist/src/store/scopes.js +220 -0
- package/dist/src/store/scopes.js.map +1 -0
- package/dist/src/store/write-guard.d.ts +10 -0
- package/dist/src/store/write-guard.js +10 -0
- package/dist/src/store/write-guard.js.map +1 -0
- package/dist/src/sync/apply.d.ts +24 -0
- package/dist/src/sync/apply.js +130 -0
- package/dist/src/sync/apply.js.map +1 -0
- package/dist/src/sync/cryptoutil.d.ts +86 -0
- package/dist/src/sync/cryptoutil.js +339 -0
- package/dist/src/sync/cryptoutil.js.map +1 -0
- package/dist/src/sync/events.d.ts +69 -0
- package/dist/src/sync/events.js +78 -0
- package/dist/src/sync/events.js.map +1 -0
- package/dist/src/sync/obs-store.d.ts +41 -0
- package/dist/src/sync/obs-store.js +325 -0
- package/dist/src/sync/obs-store.js.map +1 -0
- package/dist/src/sync/orchestrate.d.ts +37 -0
- package/dist/src/sync/orchestrate.js +84 -0
- package/dist/src/sync/orchestrate.js.map +1 -0
- package/dist/src/sync/pull.d.ts +24 -0
- package/dist/src/sync/pull.js +150 -0
- package/dist/src/sync/pull.js.map +1 -0
- package/dist/src/sync/push.d.ts +19 -0
- package/dist/src/sync/push.js +227 -0
- package/dist/src/sync/push.js.map +1 -0
- package/dist/src/sync/syncd-store.d.ts +31 -0
- package/dist/src/sync/syncd-store.js +92 -0
- package/dist/src/sync/syncd-store.js.map +1 -0
- package/dist/src/sync/vault.d.ts +37 -0
- package/dist/src/sync/vault.js +53 -0
- package/dist/src/sync/vault.js.map +1 -0
- package/docs/cairn-security.md +267 -0
- package/docs/cairn-usage.md +919 -0
- package/package.json +71 -4
|
@@ -0,0 +1,220 @@
|
|
|
1
|
+
import { validateScopeSpec, scopeAllowsRead, scopeAllowsUpstream, isPhysicallyLocal, } from '../core/scope.js';
|
|
2
|
+
import { err } from '../core/errors.js';
|
|
3
|
+
import { WriteGuardMixin } from './write-guard.js';
|
|
4
|
+
import { uuidv7 } from '../core/ids.js';
|
|
5
|
+
import { nowIso } from '../core/time.js';
|
|
6
|
+
export class ScopeRepository extends WriteGuardMixin {
|
|
7
|
+
db;
|
|
8
|
+
constructor(db) {
|
|
9
|
+
super();
|
|
10
|
+
this.db = db;
|
|
11
|
+
}
|
|
12
|
+
/** 首次初始化:确保内置个人空间存在。 */
|
|
13
|
+
ensureBaseSpace() {
|
|
14
|
+
const row = this.db.get("SELECT id FROM space WHERE space_kind = 'personal' LIMIT 1");
|
|
15
|
+
if (row)
|
|
16
|
+
return row.id;
|
|
17
|
+
const id = uuidv7();
|
|
18
|
+
this.db.run("INSERT INTO space (id, name, space_kind, created_at) VALUES (?, ?, 'personal', ?)", id, 'personal', nowIso());
|
|
19
|
+
return id;
|
|
20
|
+
}
|
|
21
|
+
ensureProject(projectId, name) {
|
|
22
|
+
const row = this.db.get('SELECT id FROM project WHERE id = ?', projectId);
|
|
23
|
+
if (row)
|
|
24
|
+
return;
|
|
25
|
+
this.db.run('INSERT INTO project (id, name, created_at) VALUES (?, ?, ?)', projectId, name, nowIso());
|
|
26
|
+
}
|
|
27
|
+
ensureProjectScope(projectId, projectName) {
|
|
28
|
+
this.ensureProject(projectId, projectName);
|
|
29
|
+
const row = this.db.get("SELECT id FROM space WHERE space_kind = 'project' AND project_id = ?", projectId);
|
|
30
|
+
if (!row) {
|
|
31
|
+
this.db.run("INSERT INTO space (id, name, space_kind, project_id, created_at) VALUES (?, ?, 'project', ?, ?)", uuidv7(), projectName, projectId, nowIso());
|
|
32
|
+
}
|
|
33
|
+
}
|
|
34
|
+
/**
|
|
35
|
+
* 按预设 find-or-create 作用域。device-local/project-device 需要显式 deviceId。
|
|
36
|
+
* 返回库中的 ScopeRow(校验后的规范形态)。
|
|
37
|
+
*/
|
|
38
|
+
resolvePreset(name, opts = {}) {
|
|
39
|
+
this.checkWritable();
|
|
40
|
+
let spec;
|
|
41
|
+
switch (name) {
|
|
42
|
+
case 'personal-global':
|
|
43
|
+
spec = { ...personalSpec(), ...opts.overrides };
|
|
44
|
+
break;
|
|
45
|
+
case 'device-local': {
|
|
46
|
+
if (!opts.deviceId)
|
|
47
|
+
throw err('E_SCOPE_INVALID', 'device-local 需要 deviceId');
|
|
48
|
+
spec = { ...deviceSpec(opts.deviceId), ...opts.overrides };
|
|
49
|
+
break;
|
|
50
|
+
}
|
|
51
|
+
case 'project-global': {
|
|
52
|
+
if (!opts.projectId)
|
|
53
|
+
throw err('E_SCOPE_INVALID', 'project-global 需要 projectId');
|
|
54
|
+
spec = { ...projectSpec(opts.projectId, opts.projectName ?? opts.projectId, 'all'), ...opts.overrides };
|
|
55
|
+
break;
|
|
56
|
+
}
|
|
57
|
+
case 'project-device': {
|
|
58
|
+
if (!opts.projectId || !opts.deviceId)
|
|
59
|
+
throw err('E_SCOPE_INVALID', 'project-device 需要 projectId 与 deviceId');
|
|
60
|
+
spec = { ...projectSpec(opts.projectId, opts.projectName ?? opts.projectId, opts.deviceId), ...opts.overrides };
|
|
61
|
+
break;
|
|
62
|
+
}
|
|
63
|
+
case 'agent-private': {
|
|
64
|
+
if (!opts.agentId)
|
|
65
|
+
throw err('E_SCOPE_INVALID', 'agent-private 需要 agentId');
|
|
66
|
+
spec = { ...agentSpec(opts.agentId), ...opts.overrides };
|
|
67
|
+
break;
|
|
68
|
+
}
|
|
69
|
+
case 'session-ephemeral': {
|
|
70
|
+
spec = { ...sessionSpec(opts.ttlDays ?? 7), ...opts.overrides };
|
|
71
|
+
break;
|
|
72
|
+
}
|
|
73
|
+
default: {
|
|
74
|
+
const exhaustive = name;
|
|
75
|
+
throw err('E_SCOPE_INVALID', `未知预设 ${String(exhaustive)}`);
|
|
76
|
+
}
|
|
77
|
+
}
|
|
78
|
+
validateScopeSpec(spec);
|
|
79
|
+
return this.upsertByFingerprint(spec, true);
|
|
80
|
+
}
|
|
81
|
+
/** 受约束自定义空间(构想 §7.4):默认 local_only,显式扩大才放宽。 */
|
|
82
|
+
createCustom(spec) {
|
|
83
|
+
this.checkWritable();
|
|
84
|
+
validateScopeSpec(spec);
|
|
85
|
+
return this.upsertByFingerprint(spec, false);
|
|
86
|
+
}
|
|
87
|
+
/** 相同指纹复用已有作用域,避免同一策略产生多行。 */
|
|
88
|
+
upsertByFingerprint(spec, builtin) {
|
|
89
|
+
const existing = this.findByFingerprint(spec);
|
|
90
|
+
if (existing)
|
|
91
|
+
return existing;
|
|
92
|
+
const spaceId = this.ensureSpaceFor(spec);
|
|
93
|
+
const id = uuidv7();
|
|
94
|
+
this.db.run(`INSERT INTO scope (id, space_id, preset, scope_kind, project_id, device_id, agent_id, read_allowlist,
|
|
95
|
+
sync_policy, read_policy, retention_policy, projection_policy, sensitivity, ttl_days, builtin, created_at)
|
|
96
|
+
VALUES (?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?)`, id, spaceId, spec.preset, spec.scopeKind, spec.projectId, spec.deviceId, spec.agentId, JSON.stringify(spec.readAllowlist), spec.syncPolicy, spec.readPolicy, spec.retentionPolicy, spec.projectionPolicy, spec.sensitivity, spec.ttlDays, builtin ? 1 : 0, nowIso());
|
|
97
|
+
return this.requireById(id);
|
|
98
|
+
}
|
|
99
|
+
ensureSpaceFor(spec) {
|
|
100
|
+
if (spec.scopeKind === 'project' && spec.projectId) {
|
|
101
|
+
this.ensureProjectScope(spec.projectId, spec.spaceName);
|
|
102
|
+
const row = this.db.get("SELECT id FROM space WHERE space_kind = 'project' AND project_id = ?", spec.projectId);
|
|
103
|
+
return row.id;
|
|
104
|
+
}
|
|
105
|
+
const row = this.db.get('SELECT id FROM space WHERE name = ? AND space_kind = ?', spec.spaceName, spec.scopeKind === 'custom' ? 'custom' : 'personal');
|
|
106
|
+
if (row)
|
|
107
|
+
return row.id;
|
|
108
|
+
const id = uuidv7();
|
|
109
|
+
this.db.run('INSERT INTO space (id, name, space_kind, created_at) VALUES (?, ?, ?, ?)', id, spec.spaceName, spec.scopeKind === 'custom' ? 'custom' : 'personal', nowIso());
|
|
110
|
+
return id;
|
|
111
|
+
}
|
|
112
|
+
findByFingerprint(spec) {
|
|
113
|
+
const rows = this.db.all(`SELECT s.* FROM scope s WHERE s.preset = ? AND s.device_id = ? AND s.agent_id = ?
|
|
114
|
+
AND s.sync_policy = ? AND s.read_policy = ? AND s.retention_policy = ? AND s.projection_policy = ?
|
|
115
|
+
AND s.sensitivity = ? AND IFNULL(s.project_id,'') = IFNULL(?, '') AND IFNULL(s.ttl_days,-1) = IFNULL(?, -1)
|
|
116
|
+
AND s.read_allowlist = ?`, spec.preset, spec.deviceId, spec.agentId, spec.syncPolicy, spec.readPolicy, spec.retentionPolicy, spec.projectionPolicy, spec.sensitivity, spec.projectId, spec.ttlDays, JSON.stringify([...spec.readAllowlist].sort()));
|
|
117
|
+
if (rows.length === 0)
|
|
118
|
+
return null;
|
|
119
|
+
if (spec.preset === 'custom') {
|
|
120
|
+
const matchingName = rows.find((r) => {
|
|
121
|
+
const space = this.db.get('SELECT name FROM space WHERE id = ?', r.space_id);
|
|
122
|
+
return space?.name === spec.spaceName;
|
|
123
|
+
});
|
|
124
|
+
return matchingName ? mapScope(matchingName) : null;
|
|
125
|
+
}
|
|
126
|
+
return mapScope(rows[0]);
|
|
127
|
+
}
|
|
128
|
+
getById(id) {
|
|
129
|
+
const row = this.db.get('SELECT * FROM scope WHERE id = ?', id);
|
|
130
|
+
return row ? mapScope(row) : null;
|
|
131
|
+
}
|
|
132
|
+
requireById(id) {
|
|
133
|
+
const row = this.getById(id);
|
|
134
|
+
if (!row)
|
|
135
|
+
throw err('E_NOT_FOUND', `作用域不存在: ${id}`);
|
|
136
|
+
return row;
|
|
137
|
+
}
|
|
138
|
+
list() {
|
|
139
|
+
return this.db.all('SELECT * FROM scope ORDER BY created_at, id').map(mapScope);
|
|
140
|
+
}
|
|
141
|
+
/** 统一读取判定入口(检索/详情/导出/投影共用)。 */
|
|
142
|
+
allowsRead(scopeId, query) {
|
|
143
|
+
return scopeAllowsRead(this.requireById(scopeId), query);
|
|
144
|
+
}
|
|
145
|
+
allowsUpstream(scopeId) {
|
|
146
|
+
return scopeAllowsUpstream(this.requireById(scopeId));
|
|
147
|
+
}
|
|
148
|
+
isPhysicallyLocal(scopeId) {
|
|
149
|
+
return isPhysicallyLocal(this.requireById(scopeId));
|
|
150
|
+
}
|
|
151
|
+
}
|
|
152
|
+
// 预设基础形态(避免与 core/scope.ts 循环依赖的轻量副本语义一致)
|
|
153
|
+
function personalSpec() {
|
|
154
|
+
return {
|
|
155
|
+
preset: 'personal-global', scopeKind: 'personal', spaceName: 'personal', projectId: null,
|
|
156
|
+
deviceId: 'all', agentId: 'all', syncPolicy: 'encrypted', readPolicy: 'all_agents', readAllowlist: [],
|
|
157
|
+
retentionPolicy: 'permanent', projectionPolicy: 'none', sensitivity: 'normal', ttlDays: null,
|
|
158
|
+
};
|
|
159
|
+
}
|
|
160
|
+
function deviceSpec(deviceId) {
|
|
161
|
+
return {
|
|
162
|
+
preset: 'device-local', scopeKind: 'device', spaceName: 'device-local', projectId: null,
|
|
163
|
+
deviceId, agentId: 'all', syncPolicy: 'local_only', readPolicy: 'all_agents', readAllowlist: [],
|
|
164
|
+
retentionPolicy: 'permanent', projectionPolicy: 'none', sensitivity: 'normal', ttlDays: null,
|
|
165
|
+
};
|
|
166
|
+
}
|
|
167
|
+
function projectSpec(projectId, projectName, deviceId) {
|
|
168
|
+
return {
|
|
169
|
+
preset: deviceId === 'all' ? 'project-global' : 'project-device',
|
|
170
|
+
scopeKind: 'project', spaceName: projectName, projectId,
|
|
171
|
+
deviceId, agentId: 'all', syncPolicy: deviceId === 'all' ? 'encrypted' : 'local_only',
|
|
172
|
+
readPolicy: 'all_agents', readAllowlist: [], retentionPolicy: 'permanent',
|
|
173
|
+
projectionPolicy: 'none', sensitivity: 'normal', ttlDays: null,
|
|
174
|
+
};
|
|
175
|
+
}
|
|
176
|
+
function agentSpec(agentId) {
|
|
177
|
+
return {
|
|
178
|
+
preset: 'agent-private', scopeKind: 'agent', spaceName: `agent:${agentId}`, projectId: null,
|
|
179
|
+
deviceId: 'all', agentId, syncPolicy: 'local_only', readPolicy: 'allowlist', readAllowlist: [agentId],
|
|
180
|
+
retentionPolicy: 'permanent', projectionPolicy: 'none', sensitivity: 'normal', ttlDays: null,
|
|
181
|
+
};
|
|
182
|
+
}
|
|
183
|
+
function sessionSpec(ttlDays) {
|
|
184
|
+
return {
|
|
185
|
+
preset: 'session-ephemeral', scopeKind: 'personal', spaceName: 'session', projectId: null,
|
|
186
|
+
deviceId: 'all', agentId: 'all', syncPolicy: 'local_only', readPolicy: 'all_agents', readAllowlist: [],
|
|
187
|
+
retentionPolicy: 'ttl', projectionPolicy: 'none', sensitivity: 'normal', ttlDays,
|
|
188
|
+
};
|
|
189
|
+
}
|
|
190
|
+
export function mapScope(r) {
|
|
191
|
+
return {
|
|
192
|
+
id: r.id,
|
|
193
|
+
spaceId: r.space_id,
|
|
194
|
+
preset: r.preset,
|
|
195
|
+
scopeKind: r.scope_kind,
|
|
196
|
+
projectId: r.project_id ?? null,
|
|
197
|
+
deviceId: r.device_id,
|
|
198
|
+
agentId: r.agent_id,
|
|
199
|
+
readAllowlist: safeJsonArray(r.read_allowlist),
|
|
200
|
+
syncPolicy: r.sync_policy,
|
|
201
|
+
readPolicy: r.read_policy,
|
|
202
|
+
retentionPolicy: r.retention_policy,
|
|
203
|
+
projectionPolicy: r.projection_policy,
|
|
204
|
+
sensitivity: r.sensitivity,
|
|
205
|
+
ttlDays: r.ttl_days ?? null,
|
|
206
|
+
builtin: Number(r.builtin) === 1,
|
|
207
|
+
};
|
|
208
|
+
}
|
|
209
|
+
function safeJsonArray(s) {
|
|
210
|
+
if (!s)
|
|
211
|
+
return [];
|
|
212
|
+
try {
|
|
213
|
+
const v = JSON.parse(s);
|
|
214
|
+
return Array.isArray(v) ? v.map(String) : [];
|
|
215
|
+
}
|
|
216
|
+
catch {
|
|
217
|
+
return [];
|
|
218
|
+
}
|
|
219
|
+
}
|
|
220
|
+
//# sourceMappingURL=scopes.js.map
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"scopes.js","sourceRoot":"","sources":["../../../src/store/scopes.ts"],"names":[],"mappings":"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"}
|
|
@@ -0,0 +1,10 @@
|
|
|
1
|
+
/**
|
|
2
|
+
* 写路径守卫:设备克隆/暂停状态下所有仓储写操作必须先通过本守卫。
|
|
3
|
+
* openStore 在装配时注入;re-enroll 后由 store 更新守卫读取的状态。
|
|
4
|
+
*/
|
|
5
|
+
export type WriteGuard = () => void;
|
|
6
|
+
export declare class WriteGuardMixin {
|
|
7
|
+
private guard;
|
|
8
|
+
setWriteGuard(g: WriteGuard | null): void;
|
|
9
|
+
protected checkWritable(): void;
|
|
10
|
+
}
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"write-guard.js","sourceRoot":"","sources":["../../../src/store/write-guard.ts"],"names":[],"mappings":"AAMA,MAAM,OAAO,eAAe;IAClB,KAAK,GAAsB,IAAI,CAAC;IAExC,aAAa,CAAC,CAAoB;QAChC,IAAI,CAAC,KAAK,GAAG,CAAC,CAAC;IACjB,CAAC;IAES,aAAa;QACrB,IAAI,CAAC,KAAK,EAAE,EAAE,CAAC;IACjB,CAAC;CACF"}
|
|
@@ -0,0 +1,24 @@
|
|
|
1
|
+
import { CairnStore } from '../store/open.js';
|
|
2
|
+
import { SyncEvent } from './events.js';
|
|
3
|
+
import { AuditLog } from '../store/audit.js';
|
|
4
|
+
/**
|
|
5
|
+
* 拉取应用(design D4 / spec cloud-sync「拉取合并与冲突保留」):
|
|
6
|
+
* 事件以内容哈希链对账——已知修订按哈希幂等跳过;parentHash 对齐本地当前修订 → 快进;
|
|
7
|
+
* parentHash 在本地历史中但对不上当前 → 并发,双方保留并入冲突队列;
|
|
8
|
+
* parentHash 完全未知 → 等待依赖(不应用、游标不推进该事件所在链)。
|
|
9
|
+
* tombstone 传播:远端遗忘 → 本地 tombstoned;对已遗忘记忆的迟到 upsert 忽略并审计。
|
|
10
|
+
*/
|
|
11
|
+
export interface ApplyOutcome {
|
|
12
|
+
applied: number;
|
|
13
|
+
skipped: number;
|
|
14
|
+
conflicted: number;
|
|
15
|
+
waited: number;
|
|
16
|
+
tombstoned: number;
|
|
17
|
+
shadowed: number;
|
|
18
|
+
}
|
|
19
|
+
export declare function applyEvent(store: CairnStore, ev: SyncEvent, spaceKey: string, audit: AuditLog): keyof ApplyOutcome;
|
|
20
|
+
/** 批量应用:parentHash 未知的事件保留在返回值中由调用方决定重试;单事件失败不拖垮整批。 */
|
|
21
|
+
export declare function applyEvents(store: CairnStore, events: SyncEvent[], spaceKey: string): {
|
|
22
|
+
outcome: ApplyOutcome;
|
|
23
|
+
waitEvents: SyncEvent[];
|
|
24
|
+
};
|
|
@@ -0,0 +1,130 @@
|
|
|
1
|
+
import { err } from '../core/errors.js';
|
|
2
|
+
import { nowIso } from '../core/time.js';
|
|
3
|
+
export function applyEvent(store, ev, spaceKey, audit) {
|
|
4
|
+
const memories = store.memories;
|
|
5
|
+
// 跨设备记忆身份对齐:id 命中 → 直接用;否则按修订内容哈希血统匹配
|
|
6
|
+
// (记忆 id 在各设备本地生成,不可跨设备引用——第一版实现的教训)
|
|
7
|
+
const mem = memories.get(ev.memoryId) ??
|
|
8
|
+
memories.get(matchByLineage(store, ev) ?? '');
|
|
9
|
+
if (ev.type === 'memory_tombstone') {
|
|
10
|
+
if (!mem) {
|
|
11
|
+
// 未知记忆的遗忘:无对象可标(首版边界,如实审计)
|
|
12
|
+
audit.record('sync', 'tombstone_unknown_memory', { type: 'memory', id: ev.memoryId }, { from: ev.deviceId, seq: ev.seq });
|
|
13
|
+
return 'shadowed';
|
|
14
|
+
}
|
|
15
|
+
if (mem.status === 'tombstoned')
|
|
16
|
+
return 'skipped';
|
|
17
|
+
memories.forget(mem.id, `sync from ${ev.deviceId}#${ev.seq}`, `sync:${ev.deviceId}`);
|
|
18
|
+
audit.record('sync', 'tombstone_propagated', { type: 'memory', id: mem.id }, { from: ev.deviceId, seq: ev.seq });
|
|
19
|
+
return 'tombstoned';
|
|
20
|
+
}
|
|
21
|
+
if (ev.type !== 'memory_upsert' || !ev.payload || !('content' in ev.payload)) {
|
|
22
|
+
throw err('E_VALIDATION', `upsert 事件缺 upsert payload: ${ev.memoryId}#${ev.seq}`);
|
|
23
|
+
}
|
|
24
|
+
const payload = ev.payload;
|
|
25
|
+
if (!mem) {
|
|
26
|
+
// 未知记忆:直接创建(内容哈希完整性在 validateUpsertEvent 已保证)
|
|
27
|
+
memories.add({
|
|
28
|
+
kind: payload.kind,
|
|
29
|
+
content: payload.content,
|
|
30
|
+
scopeId: scopeScopeId(store, spaceKey),
|
|
31
|
+
authority: payload.authority,
|
|
32
|
+
createdBy: payload.createdBy ?? `sync:${ev.deviceId}`,
|
|
33
|
+
sourceAgent: payload.sourceAgent,
|
|
34
|
+
sourceSessionId: null,
|
|
35
|
+
evidence: [],
|
|
36
|
+
expiresAt: payload.expiresAt,
|
|
37
|
+
sensitivity: payload.sensitivity,
|
|
38
|
+
observedAt: payload.observedAt,
|
|
39
|
+
}, store.identity.deviceId);
|
|
40
|
+
audit.record('sync', 'memory_created_from_remote', { type: 'memory', id: ev.memoryId }, { from: ev.deviceId, seq: ev.seq });
|
|
41
|
+
return 'applied';
|
|
42
|
+
}
|
|
43
|
+
if (mem.status === 'tombstoned') {
|
|
44
|
+
// 迟到的 upsert 不复活已遗忘记忆(保守;§10.2 遗忘与并发编辑进入恢复队列属后续)
|
|
45
|
+
audit.record('sync', 'upsert_shadowed_by_tombstone', { type: 'memory', id: mem.id }, { from: ev.deviceId, seq: ev.seq });
|
|
46
|
+
return 'shadowed';
|
|
47
|
+
}
|
|
48
|
+
if (mem.contentHash === payload.contentHash)
|
|
49
|
+
return 'skipped';
|
|
50
|
+
// 快进:远端事件的父哈希 == 本地当前内容哈希 → 远端是本地历史的孩子
|
|
51
|
+
if (payload.parentHash && payload.parentHash === mem.contentHash) {
|
|
52
|
+
memories.revise(mem.id, payload.content, { reason: `sync from ${ev.deviceId}#${ev.seq}`, author: `sync:${ev.deviceId}` }, store.identity.deviceId);
|
|
53
|
+
audit.record('sync', 'fast_forwarded', { type: 'memory', id: mem.id }, { from: ev.deviceId, seq: ev.seq });
|
|
54
|
+
return 'applied';
|
|
55
|
+
}
|
|
56
|
+
// 并发:parentHash 能对齐到本地历史(共同祖先)→ 保留双方并入冲突队列
|
|
57
|
+
const ancestor = payload.parentHash ? memories.findRevisionByContentHash(mem.id, payload.parentHash) : null;
|
|
58
|
+
if (payload.parentHash && ancestor) {
|
|
59
|
+
const incoming = memories.insertRemoteRevision(mem.id, {
|
|
60
|
+
content: payload.content,
|
|
61
|
+
contentHash: payload.contentHash,
|
|
62
|
+
author: `sync:${ev.deviceId}`,
|
|
63
|
+
reason: `remote revision ${payload.revisionId} (parent ${payload.parentHash.slice(0, 12)})`,
|
|
64
|
+
parentLocalRevisionId: mem.currentRevisionId,
|
|
65
|
+
baseRevisionId: ancestor.id,
|
|
66
|
+
}, store.identity.deviceId);
|
|
67
|
+
const current = memories.require(mem.id);
|
|
68
|
+
if (!current.currentRevisionId)
|
|
69
|
+
throw err('E_CONFLICT_STATE', '并发合并时缺少当前修订');
|
|
70
|
+
store.conflicts.record({
|
|
71
|
+
memoryId: mem.id,
|
|
72
|
+
baseRevisionId: ancestor.id,
|
|
73
|
+
revisionAId: current.currentRevisionId,
|
|
74
|
+
revisionBId: incoming.id,
|
|
75
|
+
});
|
|
76
|
+
audit.record('sync', 'conflict_recorded', { type: 'memory', id: mem.id }, { from: ev.deviceId, seq: ev.seq });
|
|
77
|
+
return 'conflicted';
|
|
78
|
+
}
|
|
79
|
+
// parentHash 未知(本地无该祖先)→ 等待依赖:不应用、调用方不推进游标
|
|
80
|
+
return 'waited';
|
|
81
|
+
}
|
|
82
|
+
/**
|
|
83
|
+
* 按内容哈希血统匹配本地记忆:upsert 用 [contentHash, parentHash],
|
|
84
|
+
* tombstone 用 knownHashes。任一修订哈希命中即同一记忆。
|
|
85
|
+
*/
|
|
86
|
+
function matchByLineage(store, ev) {
|
|
87
|
+
if (ev.type === 'memory_upsert' && ev.payload) {
|
|
88
|
+
const p = ev.payload;
|
|
89
|
+
const hashes = [p.contentHash, p.parentHash].filter((h) => Boolean(h));
|
|
90
|
+
return store.memories.findMemoryIdByRevisionHashes(hashes);
|
|
91
|
+
}
|
|
92
|
+
if (ev.type === 'memory_tombstone' && ev.payload) {
|
|
93
|
+
const p = ev.payload;
|
|
94
|
+
return store.memories.findMemoryIdByRevisionHashes(p.knownHashes ?? []);
|
|
95
|
+
}
|
|
96
|
+
return null;
|
|
97
|
+
}
|
|
98
|
+
function scopeScopeId(store, spaceKey) {
|
|
99
|
+
if (spaceKey !== 'personal-global') {
|
|
100
|
+
throw err('E_VALIDATION', `本变更仅同步 personal-global 空间,收到 ${spaceKey}`);
|
|
101
|
+
}
|
|
102
|
+
return store.scopes.resolvePreset('personal-global').id;
|
|
103
|
+
}
|
|
104
|
+
/** 批量应用:parentHash 未知的事件保留在返回值中由调用方决定重试;单事件失败不拖垮整批。 */
|
|
105
|
+
export function applyEvents(store, events, spaceKey) {
|
|
106
|
+
const audit = store.audit;
|
|
107
|
+
const outcome = { applied: 0, skipped: 0, conflicted: 0, waited: 0, tombstoned: 0, shadowed: 0 };
|
|
108
|
+
const waitEvents = [];
|
|
109
|
+
for (const ev of events) {
|
|
110
|
+
try {
|
|
111
|
+
const r = applyEvent(store, ev, spaceKey, audit);
|
|
112
|
+
outcome[r]++;
|
|
113
|
+
if (r === 'waited')
|
|
114
|
+
waitEvents.push(ev);
|
|
115
|
+
}
|
|
116
|
+
catch (e) {
|
|
117
|
+
// 单事件失败:审计并跳过(不推进对它的处理),不中断整批
|
|
118
|
+
audit.record('sync', 'apply_error', { type: 'memory', id: ev.memoryId }, {
|
|
119
|
+
from: ev.deviceId,
|
|
120
|
+
seq: ev.seq,
|
|
121
|
+
error: e.message.slice(0, 200),
|
|
122
|
+
at: nowIso(),
|
|
123
|
+
});
|
|
124
|
+
outcome.waited++;
|
|
125
|
+
waitEvents.push(ev);
|
|
126
|
+
}
|
|
127
|
+
}
|
|
128
|
+
return { outcome, waitEvents };
|
|
129
|
+
}
|
|
130
|
+
//# sourceMappingURL=apply.js.map
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"apply.js","sourceRoot":"","sources":["../../../src/sync/apply.ts"],"names":[],"mappings":"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"}
|
|
@@ -0,0 +1,86 @@
|
|
|
1
|
+
/**
|
|
2
|
+
* Cairn 云同步 E2EE 工具(design D3 / spec「加密中继与密钥主权」)。
|
|
3
|
+
*
|
|
4
|
+
* 密文线格式(版本化;禁止自造算法,全部使用可审计纯 JS 库 @noble/ciphers、@noble/hashes):
|
|
5
|
+
*
|
|
6
|
+
* [version(1B)] [nonce(24B)] [XChaCha20-Poly1305 ciphertext || Poly1305 tag(16B)]
|
|
7
|
+
*
|
|
8
|
+
* - version 即 CIPHER_VERSION(当前 1);不匹配 → E_VALIDATION 'cipher_version_mismatch'。
|
|
9
|
+
* - nonce 每次加密用 CSPRNG 随机生成 24B(XChaCha 扩展 nonce,随机 nonce 安全)。
|
|
10
|
+
* - AAD = UTF8(`v1|${vaultId}|${spaceId}|${kind}|${objectId}`),把每段密文绑定到
|
|
11
|
+
* vault/space/kind/object:任一字段不匹配 → Poly1305 校验失败 →
|
|
12
|
+
* E_VALIDATION 'auth_tag_invalid'(密文不能被搬到别的 chunk/manifest 位置)。
|
|
13
|
+
* - space 数据密钥 = HKDF-SHA256(vaultKey, salt='cairn-space-key', info=`v1|${spaceId}`):
|
|
14
|
+
* vault 主密钥不直接加密任何数据,泄露面按 space 隔离(tests 有字面量锚定测试)。
|
|
15
|
+
*
|
|
16
|
+
* 信任边界(诚实声明,构想 §12.2):
|
|
17
|
+
* - keys.json 中的 vaultKey 是本地明文,与 SQLite 数据库文件处于同等信任边界;
|
|
18
|
+
* 文件权限只防误读,不防拿到磁盘的人;设备级保护依赖磁盘加密与账户隔离。
|
|
19
|
+
* - 恢复材料(CAIRN1.…)同样是密钥明文的编码形态,抄写保存,丢失即远端不可恢复。
|
|
20
|
+
* - 所有错误信息为稳定短语,绝不包含密钥字节(hex/base64)或记忆内容。
|
|
21
|
+
*/
|
|
22
|
+
/** 密文格式版本号(线格式首字节)。未来算法更换/密钥轮换时递增并引入 keyId(design D3)。 */
|
|
23
|
+
export declare const CIPHER_VERSION = 1;
|
|
24
|
+
/** AAD 对象类型:chunk(一批同步事件)或 manifest(设备 manifest)。 */
|
|
25
|
+
export type EncryptedObjectKind = 'chunk' | 'manifest';
|
|
26
|
+
/**
|
|
27
|
+
* AAD 绑定字段:协议版本、vault、space、对象类型与对象 ID 全部入册
|
|
28
|
+
* (spec:认证加密 AAD 绑定协议版本、vault、space、对象标识)。
|
|
29
|
+
*/
|
|
30
|
+
export interface CipherAad {
|
|
31
|
+
vaultId: string;
|
|
32
|
+
spaceId: string;
|
|
33
|
+
kind: EncryptedObjectKind;
|
|
34
|
+
objectId: string;
|
|
35
|
+
}
|
|
36
|
+
/** vault 密钥集:本地持有、不上传明文(MUST NOT 上传密钥明文)。 */
|
|
37
|
+
export interface VaultKeys {
|
|
38
|
+
vaultId: string;
|
|
39
|
+
/** 32 字节 vault 主密钥;本地明文保存(与 SQLite 同等信任边界,见文件头注释)。 */
|
|
40
|
+
vaultKey: Uint8Array;
|
|
41
|
+
createdAt: string;
|
|
42
|
+
}
|
|
43
|
+
/** 生成新 vault 密钥集:vaultId 为 UUIDv7(时间可排序),vaultKey 为 32B CSPRNG 随机。 */
|
|
44
|
+
export declare function generateVaultKeys(): VaultKeys;
|
|
45
|
+
/**
|
|
46
|
+
* 派生 space 数据密钥:HKDF-SHA256(vaultKey, salt='cairn-space-key', info=`v1|${spaceId}`)。
|
|
47
|
+
* 确定性:同 vaultKey + 同 spaceId 永远得到同一 spaceKey(跨设备无需协商)。
|
|
48
|
+
*/
|
|
49
|
+
export declare function deriveSpaceKey(vaultKey: Uint8Array, spaceId: string): Uint8Array;
|
|
50
|
+
/**
|
|
51
|
+
* 加密一个同步对象。输出 = [versionByte(1)] + [nonce(24)] + [ciphertext+tag]。
|
|
52
|
+
* AAD = UTF8(`v1|${vaultId}|${spaceId}|${kind}|${objectId}`)。
|
|
53
|
+
*/
|
|
54
|
+
export declare function encryptObject(plaintext: Uint8Array, spaceKey: Uint8Array, aad: CipherAad): Uint8Array;
|
|
55
|
+
/**
|
|
56
|
+
* 解密一个同步对象。
|
|
57
|
+
* - 版本字节不匹配 → E_VALIDATION 'cipher_version_mismatch';
|
|
58
|
+
* - blob 过短 → E_VALIDATION 'cipher_blob_too_short';
|
|
59
|
+
* - tag 校验失败或 AAD 不匹配 → E_VALIDATION 'auth_tag_invalid'。
|
|
60
|
+
*/
|
|
61
|
+
export declare function decryptObject(blob: Uint8Array, spaceKey: Uint8Array, aad: CipherAad): Uint8Array;
|
|
62
|
+
/**
|
|
63
|
+
* 保存 vault 密钥到 `dataDir/keys.json`。
|
|
64
|
+
*
|
|
65
|
+
* - 已存在时拒绝覆盖(E_IO 'keys_already_exist'):防止误覆盖丢密钥;
|
|
66
|
+
* 写入用 flag 'wx'(已存在即失败的原子语义,覆盖并发窗口)。
|
|
67
|
+
* - POSIX:显式 chmod 0600('wx' 新建 + mode 0600 下 umask 只能再去位,结果仍为 0600,chmod 为兜底)。
|
|
68
|
+
* - Windows 局限(诚实边界,构想 §12.2):Node 的 fs.chmodSync 在 Windows 上只能切换
|
|
69
|
+
* 只读位,不对应 POSIX 0600;NTFS ACL 无法用 POSIX 模式表达,因此 Windows 下不做 chmod。
|
|
70
|
+
* keys.json 的 vaultKey 是本地明文,与 SQLite 库文件同等信任边界:文件权限不等于加密,
|
|
71
|
+
* 设备级保护依赖磁盘加密(BitLocker)与账户隔离,而非这里的文件模式。
|
|
72
|
+
*/
|
|
73
|
+
export declare function saveKeys(dataDir: string, keys: VaultKeys): void;
|
|
74
|
+
/**
|
|
75
|
+
* 读取 vault 密钥。目录/文件不存在、JSON 损坏、字段缺失或密钥长度不符 → null
|
|
76
|
+
* (调用方按「缺少 vault 密钥」路径处理,如提示导出过的恢复材料)。
|
|
77
|
+
*/
|
|
78
|
+
export declare function loadKeys(dataDir: string): VaultKeys | null;
|
|
79
|
+
/**
|
|
80
|
+
* 导出人类可抄写的恢复材料:`CAIRN1.<base64url(canonicalJson)>`,
|
|
81
|
+
* 规范化 JSON 内含 { createdAt, format, vaultId, vaultKey(base64), version }。
|
|
82
|
+
* 这是密钥明文的编码形态——抄写保存,丢失即远端不可恢复(spec:密钥丢失场景)。
|
|
83
|
+
*/
|
|
84
|
+
export declare function exportRecoveryMaterial(keys: VaultKeys): string;
|
|
85
|
+
/** 恢复材料的逆操作;前缀/编码/字段完整性任一不合法 → E_VALIDATION 'recovery_material_invalid'。 */
|
|
86
|
+
export declare function importRecoveryMaterial(text: string): VaultKeys;
|