@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.
Files changed (222) hide show
  1. package/CHANGELOG.md +54 -0
  2. package/LICENSE +21 -0
  3. package/README.md +158 -2
  4. package/dist/src/agents/adapters.d.ts +82 -0
  5. package/dist/src/agents/adapters.js +209 -0
  6. package/dist/src/agents/adapters.js.map +1 -0
  7. package/dist/src/agents/config.d.ts +82 -0
  8. package/dist/src/agents/config.js +603 -0
  9. package/dist/src/agents/config.js.map +1 -0
  10. package/dist/src/agents/cordisPatch.d.ts +89 -0
  11. package/dist/src/agents/cordisPatch.js +201 -0
  12. package/dist/src/agents/cordisPatch.js.map +1 -0
  13. package/dist/src/agents/index.d.ts +2 -0
  14. package/dist/src/agents/index.js +3 -0
  15. package/dist/src/agents/index.js.map +1 -0
  16. package/dist/src/core/errors.d.ts +36 -0
  17. package/dist/src/core/errors.js +74 -0
  18. package/dist/src/core/errors.js.map +1 -0
  19. package/dist/src/core/hash.d.ts +14 -0
  20. package/dist/src/core/hash.js +48 -0
  21. package/dist/src/core/hash.js.map +1 -0
  22. package/dist/src/core/ids.d.ts +10 -0
  23. package/dist/src/core/ids.js +41 -0
  24. package/dist/src/core/ids.js.map +1 -0
  25. package/dist/src/core/index.d.ts +6 -0
  26. package/dist/src/core/index.js +7 -0
  27. package/dist/src/core/index.js.map +1 -0
  28. package/dist/src/core/scope.d.ts +78 -0
  29. package/dist/src/core/scope.js +181 -0
  30. package/dist/src/core/scope.js.map +1 -0
  31. package/dist/src/core/secrets.d.ts +13 -0
  32. package/dist/src/core/secrets.js +122 -0
  33. package/dist/src/core/secrets.js.map +1 -0
  34. package/dist/src/core/time.d.ts +7 -0
  35. package/dist/src/core/time.js +18 -0
  36. package/dist/src/core/time.js.map +1 -0
  37. package/dist/src/core/types.d.ts +133 -0
  38. package/dist/src/core/types.js +30 -0
  39. package/dist/src/core/types.js.map +1 -0
  40. package/dist/src/governance/apply.d.ts +64 -0
  41. package/dist/src/governance/apply.js +160 -0
  42. package/dist/src/governance/apply.js.map +1 -0
  43. package/dist/src/governance/dedup.d.ts +21 -0
  44. package/dist/src/governance/dedup.js +23 -0
  45. package/dist/src/governance/dedup.js.map +1 -0
  46. package/dist/src/governance/index.d.ts +16 -0
  47. package/dist/src/governance/index.js +17 -0
  48. package/dist/src/governance/index.js.map +1 -0
  49. package/dist/src/governance/propose.d.ts +78 -0
  50. package/dist/src/governance/propose.js +150 -0
  51. package/dist/src/governance/propose.js.map +1 -0
  52. package/dist/src/index.d.ts +15 -0
  53. package/dist/src/index.js +24 -0
  54. package/dist/src/index.js.map +1 -0
  55. package/dist/src/interfaces/app-service.d.ts +242 -0
  56. package/dist/src/interfaces/app-service.js +614 -0
  57. package/dist/src/interfaces/app-service.js.map +1 -0
  58. package/dist/src/interfaces/cli/main.d.ts +2 -0
  59. package/dist/src/interfaces/cli/main.js +790 -0
  60. package/dist/src/interfaces/cli/main.js.map +1 -0
  61. package/dist/src/interfaces/console/assets/page.d.ts +18 -0
  62. package/dist/src/interfaces/console/assets/page.js +39 -0
  63. package/dist/src/interfaces/console/assets/page.js.map +1 -0
  64. package/dist/src/interfaces/console/assets/ui-css.d.ts +11 -0
  65. package/dist/src/interfaces/console/assets/ui-css.js +119 -0
  66. package/dist/src/interfaces/console/assets/ui-css.js.map +1 -0
  67. package/dist/src/interfaces/console/assets/ui-js.d.ts +14 -0
  68. package/dist/src/interfaces/console/assets/ui-js.js +1098 -0
  69. package/dist/src/interfaces/console/assets/ui-js.js.map +1 -0
  70. package/dist/src/interfaces/console/assets/url-state.d.ts +9 -0
  71. package/dist/src/interfaces/console/assets/url-state.js +45 -0
  72. package/dist/src/interfaces/console/assets/url-state.js.map +1 -0
  73. package/dist/src/interfaces/console/export.d.ts +46 -0
  74. package/dist/src/interfaces/console/export.js +84 -0
  75. package/dist/src/interfaces/console/export.js.map +1 -0
  76. package/dist/src/interfaces/console/model.d.ts +372 -0
  77. package/dist/src/interfaces/console/model.js +731 -0
  78. package/dist/src/interfaces/console/model.js.map +1 -0
  79. package/dist/src/interfaces/console/review-store.d.ts +142 -0
  80. package/dist/src/interfaces/console/review-store.js +342 -0
  81. package/dist/src/interfaces/console/review-store.js.map +1 -0
  82. package/dist/src/interfaces/console/security.d.ts +76 -0
  83. package/dist/src/interfaces/console/security.js +105 -0
  84. package/dist/src/interfaces/console/security.js.map +1 -0
  85. package/dist/src/interfaces/console/server.d.ts +45 -0
  86. package/dist/src/interfaces/console/server.js +476 -0
  87. package/dist/src/interfaces/console/server.js.map +1 -0
  88. package/dist/src/interfaces/console/suggestions.d.ts +112 -0
  89. package/dist/src/interfaces/console/suggestions.js +511 -0
  90. package/dist/src/interfaces/console/suggestions.js.map +1 -0
  91. package/dist/src/interfaces/console/text.d.ts +4 -0
  92. package/dist/src/interfaces/console/text.js +18 -0
  93. package/dist/src/interfaces/console/text.js.map +1 -0
  94. package/dist/src/interfaces/mcp/server.d.ts +4 -0
  95. package/dist/src/interfaces/mcp/server.js +412 -0
  96. package/dist/src/interfaces/mcp/server.js.map +1 -0
  97. package/dist/src/jobs/index.d.ts +6 -0
  98. package/dist/src/jobs/index.js +7 -0
  99. package/dist/src/jobs/index.js.map +1 -0
  100. package/dist/src/jobs/remote.d.ts +42 -0
  101. package/dist/src/jobs/remote.js +34 -0
  102. package/dist/src/jobs/remote.js.map +1 -0
  103. package/dist/src/jobs/worker.d.ts +67 -0
  104. package/dist/src/jobs/worker.js +169 -0
  105. package/dist/src/jobs/worker.js.map +1 -0
  106. package/dist/src/onboarding/auto.d.ts +88 -0
  107. package/dist/src/onboarding/auto.js +399 -0
  108. package/dist/src/onboarding/auto.js.map +1 -0
  109. package/dist/src/onboarding/batches.d.ts +103 -0
  110. package/dist/src/onboarding/batches.js +219 -0
  111. package/dist/src/onboarding/batches.js.map +1 -0
  112. package/dist/src/onboarding/discover.d.ts +54 -0
  113. package/dist/src/onboarding/discover.js +369 -0
  114. package/dist/src/onboarding/discover.js.map +1 -0
  115. package/dist/src/onboarding/import.d.ts +69 -0
  116. package/dist/src/onboarding/import.js +279 -0
  117. package/dist/src/onboarding/import.js.map +1 -0
  118. package/dist/src/onboarding/index.d.ts +24 -0
  119. package/dist/src/onboarding/index.js +22 -0
  120. package/dist/src/onboarding/index.js.map +1 -0
  121. package/dist/src/onboarding/judgement.d.ts +50 -0
  122. package/dist/src/onboarding/judgement.js +121 -0
  123. package/dist/src/onboarding/judgement.js.map +1 -0
  124. package/dist/src/onboarding/policy.d.ts +86 -0
  125. package/dist/src/onboarding/policy.js +249 -0
  126. package/dist/src/onboarding/policy.js.map +1 -0
  127. package/dist/src/projection/brief.d.ts +77 -0
  128. package/dist/src/projection/brief.js +111 -0
  129. package/dist/src/projection/brief.js.map +1 -0
  130. package/dist/src/projection/index.d.ts +1 -0
  131. package/dist/src/projection/index.js +2 -0
  132. package/dist/src/projection/index.js.map +1 -0
  133. package/dist/src/projection/markdown.d.ts +82 -0
  134. package/dist/src/projection/markdown.js +313 -0
  135. package/dist/src/projection/markdown.js.map +1 -0
  136. package/dist/src/retrieval/export.d.ts +80 -0
  137. package/dist/src/retrieval/export.js +215 -0
  138. package/dist/src/retrieval/export.js.map +1 -0
  139. package/dist/src/retrieval/index.d.ts +5 -0
  140. package/dist/src/retrieval/index.js +6 -0
  141. package/dist/src/retrieval/index.js.map +1 -0
  142. package/dist/src/retrieval/search.d.ts +37 -0
  143. package/dist/src/retrieval/search.js +294 -0
  144. package/dist/src/retrieval/search.js.map +1 -0
  145. package/dist/src/store/archives.d.ts +94 -0
  146. package/dist/src/store/archives.js +135 -0
  147. package/dist/src/store/archives.js.map +1 -0
  148. package/dist/src/store/audit.d.ts +26 -0
  149. package/dist/src/store/audit.js +48 -0
  150. package/dist/src/store/audit.js.map +1 -0
  151. package/dist/src/store/backup.d.ts +36 -0
  152. package/dist/src/store/backup.js +90 -0
  153. package/dist/src/store/backup.js.map +1 -0
  154. package/dist/src/store/blocks.d.ts +64 -0
  155. package/dist/src/store/blocks.js +104 -0
  156. package/dist/src/store/blocks.js.map +1 -0
  157. package/dist/src/store/conflicts.d.ts +52 -0
  158. package/dist/src/store/conflicts.js +112 -0
  159. package/dist/src/store/conflicts.js.map +1 -0
  160. package/dist/src/store/db.d.ts +44 -0
  161. package/dist/src/store/db.js +162 -0
  162. package/dist/src/store/db.js.map +1 -0
  163. package/dist/src/store/device.d.ts +46 -0
  164. package/dist/src/store/device.js +111 -0
  165. package/dist/src/store/device.js.map +1 -0
  166. package/dist/src/store/index.d.ts +14 -0
  167. package/dist/src/store/index.js +15 -0
  168. package/dist/src/store/index.js.map +1 -0
  169. package/dist/src/store/memories.d.ts +101 -0
  170. package/dist/src/store/memories.js +378 -0
  171. package/dist/src/store/memories.js.map +1 -0
  172. package/dist/src/store/migrate.d.ts +32 -0
  173. package/dist/src/store/migrate.js +86 -0
  174. package/dist/src/store/migrate.js.map +1 -0
  175. package/dist/src/store/open.d.ts +53 -0
  176. package/dist/src/store/open.js +177 -0
  177. package/dist/src/store/open.js.map +1 -0
  178. package/dist/src/store/outbox.d.ts +65 -0
  179. package/dist/src/store/outbox.js +137 -0
  180. package/dist/src/store/outbox.js.map +1 -0
  181. package/dist/src/store/plans.d.ts +137 -0
  182. package/dist/src/store/plans.js +243 -0
  183. package/dist/src/store/plans.js.map +1 -0
  184. package/dist/src/store/schema.d.ts +34 -0
  185. package/dist/src/store/schema.js +527 -0
  186. package/dist/src/store/schema.js.map +1 -0
  187. package/dist/src/store/scopes.d.ts +44 -0
  188. package/dist/src/store/scopes.js +220 -0
  189. package/dist/src/store/scopes.js.map +1 -0
  190. package/dist/src/store/write-guard.d.ts +10 -0
  191. package/dist/src/store/write-guard.js +10 -0
  192. package/dist/src/store/write-guard.js.map +1 -0
  193. package/dist/src/sync/apply.d.ts +24 -0
  194. package/dist/src/sync/apply.js +130 -0
  195. package/dist/src/sync/apply.js.map +1 -0
  196. package/dist/src/sync/cryptoutil.d.ts +86 -0
  197. package/dist/src/sync/cryptoutil.js +339 -0
  198. package/dist/src/sync/cryptoutil.js.map +1 -0
  199. package/dist/src/sync/events.d.ts +69 -0
  200. package/dist/src/sync/events.js +78 -0
  201. package/dist/src/sync/events.js.map +1 -0
  202. package/dist/src/sync/obs-store.d.ts +41 -0
  203. package/dist/src/sync/obs-store.js +325 -0
  204. package/dist/src/sync/obs-store.js.map +1 -0
  205. package/dist/src/sync/orchestrate.d.ts +37 -0
  206. package/dist/src/sync/orchestrate.js +84 -0
  207. package/dist/src/sync/orchestrate.js.map +1 -0
  208. package/dist/src/sync/pull.d.ts +24 -0
  209. package/dist/src/sync/pull.js +150 -0
  210. package/dist/src/sync/pull.js.map +1 -0
  211. package/dist/src/sync/push.d.ts +19 -0
  212. package/dist/src/sync/push.js +227 -0
  213. package/dist/src/sync/push.js.map +1 -0
  214. package/dist/src/sync/syncd-store.d.ts +31 -0
  215. package/dist/src/sync/syncd-store.js +92 -0
  216. package/dist/src/sync/syncd-store.js.map +1 -0
  217. package/dist/src/sync/vault.d.ts +37 -0
  218. package/dist/src/sync/vault.js +53 -0
  219. package/dist/src/sync/vault.js.map +1 -0
  220. package/docs/cairn-security.md +254 -0
  221. package/docs/cairn-usage.md +821 -0
  222. package/package.json +71 -4
@@ -0,0 +1 @@
1
+ {"version":3,"file":"pull.js","sourceRoot":"","sources":["../../../src/sync/pull.ts"],"names":[],"mappings":"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"}
@@ -0,0 +1,19 @@
1
+ import { CairnStore } from '../store/open.js';
2
+ import { RemoteStore } from '../jobs/remote.js';
3
+ import { ChunkMeta } from './events.js';
4
+ import { VaultConfig } from './vault.js';
5
+ export interface PushResult {
6
+ publishedChunks: ChunkMeta[];
7
+ headSeq: number;
8
+ eventCount: number;
9
+ jobs: number;
10
+ }
11
+ interface PendingJob {
12
+ id: string;
13
+ entityId: string;
14
+ }
15
+ export declare function syncPush(store: CairnStore, remote: RemoteStore, vault: VaultConfig, opts?: {
16
+ maxJobs?: number;
17
+ preclaimedJobs?: PendingJob[];
18
+ }): Promise<PushResult | null>;
19
+ export {};
@@ -0,0 +1,227 @@
1
+ import { err } from '../core/errors.js';
2
+ import { sha256Hex } from '../core/hash.js';
3
+ import { nowIso } from '../core/time.js';
4
+ import { emptyManifest, nextManifest, packChunk, validateUpsertEvent, } from './events.js';
5
+ import { deriveSpaceKey, loadKeys, encryptObject, decryptObject } from './cryptoutil.js';
6
+ import { PERSONAL_SPACE_KEY } from './vault.js';
7
+ /**
8
+ * 同步推送(design D2):outbox 的 sync_upstream 任务 → 事件 → chunk(加密)
9
+ * → manifest(单写者,headSeq 防回退)。事件按内容哈希链组织;
10
+ * local_only/设备限定内容由 outbox 层物理排除(触发器兜底),
11
+ * 打包层再按 scope 过滤一次(spec:打包前物理排除)。
12
+ * 失败只留下可重试状态:推送异常时已领取任务复位为 pending(spec agent-interfaces)。
13
+ */
14
+ const MAX_EVENTS_PER_CHUNK = 200;
15
+ const MAX_CHUNK_BYTES = 512 * 1024;
16
+ function spaceSeqKey(spaceKey) {
17
+ return `sync_seq:${spaceKey}`;
18
+ }
19
+ function pushedRevisionKey(spaceKey, memoryId) {
20
+ return `sync_pushed:${spaceKey}:${memoryId}`;
21
+ }
22
+ /** chunk 对象的远端相对 key:`<spaceKey>/devices/<dev>/chunks/<seq>-<hash>.bin`。 */
23
+ function chunkObjectKey(spaceKey, meta) {
24
+ return `${spaceKey}/${meta.key}`;
25
+ }
26
+ /** 构建事件:只收 encrypted 作用域(personal-global);payload 为当前修订快照。 */
27
+ function buildEvents(store, device, jobs) {
28
+ const events = [];
29
+ const doneJobIds = [];
30
+ const scope = store.scopes.resolvePreset('personal-global');
31
+ if (scope.syncPolicy !== 'encrypted') {
32
+ throw err('E_FORBIDDEN', 'personal-global 作用域不是 encrypted;拒绝上行(物理排除语义)');
33
+ }
34
+ for (const job of jobs) {
35
+ const mem = store.memories.get(job.entityId);
36
+ if (!mem) {
37
+ // 记忆已不存在:作为 tombstone 传播;对端按内容哈希血统对齐
38
+ const hashRow = store.db.get('SELECT content_hash FROM tombstone WHERE memory_id = ? ORDER BY forgotten_at DESC LIMIT 1', job.entityId);
39
+ events.push({
40
+ deviceId: device,
41
+ seq: 0,
42
+ type: 'memory_tombstone',
43
+ memoryId: job.entityId,
44
+ occurredAt: nowIso(),
45
+ payload: { lastContentHash: hashRow?.content_hash ?? '', knownHashes: hashRow ? [hashRow.content_hash] : [] },
46
+ });
47
+ doneJobIds.push(job.id);
48
+ continue;
49
+ }
50
+ if (mem.scopeId !== scope.id) {
51
+ // 作用域迁移属后续边界:不入本空间链,任务照常完成
52
+ doneJobIds.push(job.id);
53
+ continue;
54
+ }
55
+ if (mem.status === 'tombstoned') {
56
+ const knownHashes = store.memories.revisions(mem.id).map((r) => r.contentHash);
57
+ const t = store.memories.getTombstone(mem.id);
58
+ events.push({
59
+ deviceId: device,
60
+ seq: 0,
61
+ type: 'memory_tombstone',
62
+ memoryId: mem.id,
63
+ occurredAt: nowIso(),
64
+ payload: { lastContentHash: t?.contentHash ?? mem.contentHash, knownHashes },
65
+ });
66
+ doneJobIds.push(job.id);
67
+ continue;
68
+ }
69
+ const currentRevId = mem.currentRevisionId;
70
+ const pushedRow = store.db.get('SELECT value FROM meta WHERE key = ?', pushedRevisionKey(PERSONAL_SPACE_KEY, mem.id));
71
+ const pushedRevId = pushedRow ? pushedRow.value : null;
72
+ if (!currentRevId || pushedRevId === currentRevId) {
73
+ // 无当前修订或该修订已推送:幂等完成
74
+ doneJobIds.push(job.id);
75
+ continue;
76
+ }
77
+ const rev = store.memories.requireRevision(currentRevId);
78
+ const parentRow = pushedRevId ? store.db.get('SELECT content_hash FROM memory_revision WHERE id = ?', pushedRevId) : null;
79
+ const payload = {
80
+ revisionId: rev.id,
81
+ content: mem.content,
82
+ contentHash: mem.contentHash,
83
+ parentHash: parentRow ? parentRow.content_hash : null,
84
+ kind: mem.kind,
85
+ authority: mem.authority,
86
+ scopeId: PERSONAL_SPACE_KEY,
87
+ sensitivity: mem.sensitivity,
88
+ confidence: mem.confidence,
89
+ observedAt: mem.observedAt,
90
+ createdAt: mem.createdAt,
91
+ expiresAt: mem.expiresAt,
92
+ sourceAgent: mem.sourceAgent,
93
+ createdBy: mem.createdBy,
94
+ reason: rev.reason,
95
+ };
96
+ events.push({ deviceId: device, seq: 0, type: 'memory_upsert', memoryId: mem.id, occurredAt: nowIso(), payload });
97
+ doneJobIds.push(job.id);
98
+ }
99
+ return { events, doneJobIds };
100
+ }
101
+ function assignSeqs(store, spaceKey, events) {
102
+ const key = spaceSeqKey(spaceKey);
103
+ store.db.transaction(() => {
104
+ for (const ev of events) {
105
+ const row = store.db.get('SELECT value FROM meta WHERE key = ?', key);
106
+ const seq = Number(row?.value ?? 0) + 1;
107
+ if (row) {
108
+ store.db.run('UPDATE meta SET value = ? WHERE key = ?', String(seq), key);
109
+ }
110
+ else {
111
+ store.db.run('INSERT INTO meta (key, value) VALUES (?, ?)', key, String(seq));
112
+ }
113
+ ev.seq = seq;
114
+ }
115
+ });
116
+ }
117
+ export async function syncPush(store, remote, vault, opts = {}) {
118
+ store.assertWritable();
119
+ const spaceKey = PERSONAL_SPACE_KEY;
120
+ const jobs = opts.preclaimedJobs ?? store.outbox.claimReady(opts.maxJobs ?? 200).filter((j) => j.jobType === 'sync_upstream');
121
+ if (jobs.length === 0)
122
+ return null;
123
+ try {
124
+ return await pushClaimed(store, remote, vault, spaceKey, jobs);
125
+ }
126
+ catch (e) {
127
+ // 失败复位:已领取任务回到 pending(可重试状态),错误照常抛出
128
+ if (!opts.preclaimedJobs) {
129
+ for (const j of jobs) {
130
+ store.db.run("UPDATE outbox_job SET status = 'pending', updated_at = ? WHERE id = ? AND status = 'running'", nowIso(), j.id);
131
+ }
132
+ }
133
+ throw e;
134
+ }
135
+ }
136
+ async function pushClaimed(store, remote, vault, spaceKey, jobs) {
137
+ const device = store.identity.deviceId;
138
+ const { events, doneJobIds } = buildEvents(store, device, jobs);
139
+ if (events.length > 0) {
140
+ assignSeqs(store, spaceKey, events);
141
+ for (const ev of events) {
142
+ if (ev.type === 'memory_upsert')
143
+ validateUpsertEvent(ev);
144
+ }
145
+ }
146
+ const keys = loadKeys(store.paths.dataDir);
147
+ if (!keys)
148
+ throw err('E_VALIDATION', '未找到 vault 密钥(keys.json);请先 cairn vault init-remote');
149
+ const spaceKeyBytes = deriveSpaceKey(keys.vaultKey, spaceKey);
150
+ // 读自身 manifest(密文,AAD 绑定逻辑标识)
151
+ let current = emptyManifest(vault.vaultId, spaceKey, device);
152
+ const sealedManifest = await remote.getManifest(spaceKey, device);
153
+ if (sealedManifest) {
154
+ if (!(sealedManifest instanceof Uint8Array))
155
+ throw err('E_VALIDATION', '远端 manifest 不是字节对象');
156
+ current = decryptManifestDoc(sealedManifest, keys.vaultKey, vault.vaultId, spaceKey, device);
157
+ }
158
+ const publishedChunks = [];
159
+ for (let i = 0; i < events.length; i += MAX_EVENTS_PER_CHUNK) {
160
+ const batch = events.slice(i, i + MAX_EVENTS_PER_CHUNK);
161
+ let packed = packChunk(device, batch);
162
+ while (packed.plaintext.byteLength > MAX_CHUNK_BYTES && batch.length > 1) {
163
+ batch.splice(Math.ceil(batch.length / 2));
164
+ packed = packChunk(device, batch);
165
+ }
166
+ const { plaintext, meta } = packed;
167
+ if (meta.seqTo <= current.headSeq)
168
+ continue; // 该序列段已发布(幂等重推)
169
+ const sealed = encryptObject(plaintext, spaceKeyBytes, {
170
+ vaultId: vault.vaultId,
171
+ spaceId: spaceKey,
172
+ kind: 'chunk',
173
+ objectId: meta.key,
174
+ });
175
+ // hash 参数 = 传输字节(密文)的哈希;内容寻址的明文哈希在 key 中
176
+ await remote.putImmutable(chunkObjectKey(spaceKey, meta), sealed, sha256Hex(Buffer.from(sealed)));
177
+ publishedChunks.push(meta);
178
+ }
179
+ if (publishedChunks.length > 0) {
180
+ const next = nextManifest(current, publishedChunks);
181
+ const sealedNext = encryptObject(Buffer.from(JSON.stringify(next), 'utf8'), spaceKeyBytes, {
182
+ vaultId: vault.vaultId,
183
+ spaceId: spaceKey,
184
+ kind: 'manifest',
185
+ objectId: `manifest.json|${device}`,
186
+ });
187
+ await remote.putManifest(spaceKey, device, new Uint8Array(sealedNext), next.generation);
188
+ store.db.transaction(() => {
189
+ for (const ev of events) {
190
+ if (ev.type !== 'memory_upsert' || !ev.payload || !('revisionId' in ev.payload))
191
+ continue;
192
+ const k = pushedRevisionKey(spaceKey, ev.memoryId);
193
+ const existing = store.db.get('SELECT value FROM meta WHERE key = ?', k);
194
+ if (existing) {
195
+ store.db.run('UPDATE meta SET value = ? WHERE key = ?', ev.payload.revisionId, k);
196
+ }
197
+ else {
198
+ store.db.run('INSERT INTO meta (key, value) VALUES (?, ?)', k, ev.payload.revisionId);
199
+ }
200
+ }
201
+ });
202
+ }
203
+ for (const j of jobs) {
204
+ if (doneJobIds.includes(j.id))
205
+ store.outbox.markDone(j.id);
206
+ }
207
+ return {
208
+ publishedChunks,
209
+ headSeq: publishedChunks.length > 0 ? Math.max(...publishedChunks.map((c) => c.seqTo)) : current.headSeq,
210
+ eventCount: events.length,
211
+ jobs: jobs.length,
212
+ };
213
+ }
214
+ function decryptManifestDoc(sealed, vaultKey, vaultId, spaceKey, device) {
215
+ const plain = decryptObject(sealed, deriveSpaceKey(vaultKey, spaceKey), {
216
+ vaultId,
217
+ spaceId: spaceKey,
218
+ kind: 'manifest',
219
+ objectId: `manifest.json|${device}`,
220
+ });
221
+ const doc = JSON.parse(Buffer.from(plain).toString('utf8'));
222
+ if (doc.vaultId !== vaultId || doc.spaceKey !== spaceKey || doc.deviceId !== device) {
223
+ throw err('E_VALIDATION', 'manifest 身份字段与寻址不一致');
224
+ }
225
+ return doc;
226
+ }
227
+ //# sourceMappingURL=push.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"push.js","sourceRoot":"","sources":["../../../src/sync/push.ts"],"names":[],"mappings":"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"}
@@ -0,0 +1,31 @@
1
+ import { RemoteStore } from '../jobs/remote.js';
2
+ /**
3
+ * ECS syncd 的客户端实现:同一 RemoteStore 合同。
4
+ * manifest 代次经 X-Cairn-Generation 头做服务器端 CAS(回退 409)。
5
+ * prefix 把 vault 段并入键空间(`vaults/<vaultId>/`,与 OBS 布局对齐)——
6
+ * 同一 syncd 上的不同 vault 互不可见(第三轮验证 P1:否则外来 vault 的
7
+ * 密文会让 pull 整链 auth_tag_invalid)。
8
+ */
9
+ export interface SyncdRemoteConfig {
10
+ baseUrl: string;
11
+ token: string;
12
+ /** 键前缀(如 vaults/<vaultId>/);缺省为空(仅单 vault 遗留布局)。 */
13
+ prefix?: string;
14
+ }
15
+ export declare class SyncdRemoteStore implements RemoteStore {
16
+ private readonly cfg;
17
+ private readonly fetchImpl;
18
+ readonly configured = true;
19
+ constructor(cfg: SyncdRemoteConfig, fetchImpl?: typeof fetch);
20
+ /** 全键 = prefix + 调用方键。 */
21
+ private k;
22
+ private req;
23
+ getObject(key: string): Promise<Uint8Array | null>;
24
+ putImmutable(key: string, bytes: Uint8Array, hash: string): Promise<void>;
25
+ list(prefix: string, _cursor?: string): Promise<{
26
+ keys: string[];
27
+ nextCursor?: string;
28
+ }>;
29
+ getManifest(space: string, device: string): Promise<Uint8Array | null>;
30
+ putManifest(space: string, device: string, manifest: Uint8Array, expectedGeneration: number): Promise<void>;
31
+ }
@@ -0,0 +1,92 @@
1
+ import { err } from '../core/errors.js';
2
+ import { sha256Hex } from '../core/hash.js';
3
+ export class SyncdRemoteStore {
4
+ cfg;
5
+ fetchImpl;
6
+ configured = true;
7
+ constructor(cfg, fetchImpl = globalThis.fetch) {
8
+ this.cfg = cfg;
9
+ this.fetchImpl = fetchImpl;
10
+ }
11
+ /** 全键 = prefix + 调用方键。 */
12
+ k(key) {
13
+ return this.cfg.prefix ? `${this.cfg.prefix}${key}` : key;
14
+ }
15
+ async req(method, path, body, headers = {}) {
16
+ let res;
17
+ try {
18
+ res = await this.fetchImpl(`${this.cfg.baseUrl}${path}`, {
19
+ method,
20
+ headers: {
21
+ authorization: `Bearer ${this.cfg.token}`,
22
+ ...(body ? { 'content-type': 'application/octet-stream' } : {}),
23
+ ...headers,
24
+ },
25
+ body: body ? Buffer.from(body) : undefined,
26
+ });
27
+ }
28
+ catch (e) {
29
+ // 网络层失败不透传原始堆栈(错误卫生);不含 baseUrl/token
30
+ throw err('E_IO', 'syncd_network_error', { code: e.code ?? 'unknown' });
31
+ }
32
+ const buf = new Uint8Array(await res.arrayBuffer());
33
+ return { status: res.status, body: buf, text: Buffer.from(buf).toString('utf8') };
34
+ }
35
+ async getObject(key) {
36
+ const r = await this.req('GET', `/chunks/${encodeURIComponent(this.k(key))}`);
37
+ if (r.status === 404)
38
+ return null;
39
+ if (r.status === 401)
40
+ throw err('E_FORBIDDEN', 'syncd_auth_failed');
41
+ if (r.status !== 200)
42
+ throw err('E_IO', 'syncd_remote_error', { status: r.status });
43
+ return r.body;
44
+ }
45
+ async putImmutable(key, bytes, hash) {
46
+ const actual = sha256Hex(Buffer.from(bytes));
47
+ if (actual !== hash)
48
+ throw err('E_IO', 'syncd_local_hash_mismatch');
49
+ const r = await this.req('PUT', `/chunks/${encodeURIComponent(this.k(key))}`, bytes);
50
+ if (r.status === 401)
51
+ throw err('E_FORBIDDEN', 'syncd_auth_failed');
52
+ if (r.status !== 200)
53
+ throw err('E_IO', 'syncd_remote_error', { status: r.status });
54
+ }
55
+ async list(prefix, _cursor) {
56
+ const r = await this.req('GET', `/list?prefix=${encodeURIComponent(this.k(prefix))}`);
57
+ if (r.status === 401)
58
+ throw err('E_FORBIDDEN', 'syncd_auth_failed');
59
+ if (r.status !== 200)
60
+ throw err('E_IO', 'syncd_remote_error', { status: r.status });
61
+ const parsed = JSON.parse(r.text);
62
+ // 与 OBS 语义一致:返回【相对键】(剥掉本 store 的 vault 前缀),
63
+ // 调用方(pull)以 <spaceKey>/devices/ 起始切片
64
+ const p = this.cfg.prefix ?? '';
65
+ return { keys: parsed.keys.filter((k) => k.startsWith(p)).map((k) => k.slice(p.length)) };
66
+ }
67
+ async getManifest(space, device) {
68
+ const key = this.k(`${space}/devices/${device}/manifest.json`);
69
+ const r = await this.req('GET', `/manifests/${encodeURIComponent(key)}`);
70
+ if (r.status === 404)
71
+ return null;
72
+ if (r.status === 401)
73
+ throw err('E_FORBIDDEN', 'syncd_auth_failed');
74
+ if (r.status !== 200)
75
+ throw err('E_IO', 'syncd_remote_error', { status: r.status });
76
+ return r.body;
77
+ }
78
+ async putManifest(space, device, manifest, expectedGeneration) {
79
+ const key = this.k(`${space}/devices/${device}/manifest.json`);
80
+ const bytes = Buffer.from(manifest);
81
+ const r = await this.req('PUT', `/manifests/${encodeURIComponent(key)}`, new Uint8Array(bytes), {
82
+ 'x-cairn-generation': String(expectedGeneration),
83
+ });
84
+ if (r.status === 409)
85
+ throw err('E_CONFLICT_STATE', 'syncd_manifest_generation_regression', { detail: r.text.slice(0, 200) });
86
+ if (r.status === 401)
87
+ throw err('E_FORBIDDEN', 'syncd_auth_failed');
88
+ if (r.status !== 200)
89
+ throw err('E_IO', 'syncd_remote_error', { status: r.status });
90
+ }
91
+ }
92
+ //# sourceMappingURL=syncd-store.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"syncd-store.js","sourceRoot":"","sources":["../../../src/sync/syncd-store.ts"],"names":[],"mappings":"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"}
@@ -0,0 +1,37 @@
1
+ /**
2
+ * Vault 远端配置(design D1/D3):dataDir/vault.json。
3
+ * 凭据【绝不】写入本文件——OBS 走环境变量,syncd token 走环境变量。
4
+ * 删除该文件即回到纯本地行为。
5
+ */
6
+ export type SyncProvider = 'obs' | 'syncd';
7
+ export interface VaultConfig {
8
+ vaultId: string;
9
+ provider: SyncProvider;
10
+ /** OBS: endpoint/bucket/prefix;syncd: baseUrl。凭据均走环境变量。 */
11
+ obs?: {
12
+ endpoint: string;
13
+ bucket: string;
14
+ prefix: string;
15
+ };
16
+ syncd?: {
17
+ baseUrl: string;
18
+ };
19
+ createdAt: string;
20
+ }
21
+ export declare function vaultConfigPath(dataDir: string): string;
22
+ export declare function loadVaultConfig(dataDir: string): VaultConfig | null;
23
+ export declare function saveVaultConfig(dataDir: string, cfg: Omit<VaultConfig, 'createdAt' | 'vaultId'> & {
24
+ vaultId?: string;
25
+ }): VaultConfig;
26
+ /**
27
+ * 环境变量名约定(与 GITHUB_TOKEN 同模式,用户级注入):
28
+ * OBS: OBS_ACCESS_KEY_ID / OBS_SECRET_ACCESS_KEY(+ vault.json 的 endpoint/bucket/prefix)
29
+ * syncd: CAIRN_SYNCD_TOKEN
30
+ */
31
+ export declare const ENV: {
32
+ readonly obsAk: "OBS_ACCESS_KEY_ID";
33
+ readonly obsSk: "OBS_SECRET_ACCESS_KEY";
34
+ readonly syncdToken: "CAIRN_SYNCD_TOKEN";
35
+ };
36
+ /** 本变更首版同步的个人空间键(跨设备稳定标识;项目/自定义空间同步属后续边界)。 */
37
+ export declare const PERSONAL_SPACE_KEY = "personal-global";
@@ -0,0 +1,53 @@
1
+ import { existsSync, readFileSync, writeFileSync } from 'node:fs';
2
+ import { join } from 'node:path';
3
+ import { err } from '../core/errors.js';
4
+ import { uuidv7 } from '../core/ids.js';
5
+ import { nowIso } from '../core/time.js';
6
+ export function vaultConfigPath(dataDir) {
7
+ return join(dataDir, 'vault.json');
8
+ }
9
+ export function loadVaultConfig(dataDir) {
10
+ const p = vaultConfigPath(dataDir);
11
+ if (!existsSync(p))
12
+ return null;
13
+ try {
14
+ const cfg = JSON.parse(readFileSync(p, 'utf8'));
15
+ if (cfg.provider !== 'obs' && cfg.provider !== 'syncd')
16
+ return null;
17
+ return cfg;
18
+ }
19
+ catch {
20
+ return null;
21
+ }
22
+ }
23
+ export function saveVaultConfig(dataDir, cfg) {
24
+ if (cfg.provider === 'obs' && !cfg.obs)
25
+ throw err('E_VALIDATION', 'obs provider 需要 obs 配置');
26
+ if (cfg.provider === 'syncd' && !cfg.syncd)
27
+ throw err('E_VALIDATION', 'syncd provider 需要 syncd 配置');
28
+ const existing = loadVaultConfig(dataDir);
29
+ if (existing)
30
+ throw err('E_IO', 'vault.json 已存在;如需重新配置请先删除该文件(远端对象可保留)');
31
+ const full = {
32
+ vaultId: cfg.vaultId ?? `vlt_${uuidv7()}`,
33
+ provider: cfg.provider,
34
+ obs: cfg.obs,
35
+ syncd: cfg.syncd,
36
+ createdAt: nowIso(),
37
+ };
38
+ writeFileSync(vaultConfigPath(dataDir), JSON.stringify(full, null, 2), 'utf8');
39
+ return full;
40
+ }
41
+ /**
42
+ * 环境变量名约定(与 GITHUB_TOKEN 同模式,用户级注入):
43
+ * OBS: OBS_ACCESS_KEY_ID / OBS_SECRET_ACCESS_KEY(+ vault.json 的 endpoint/bucket/prefix)
44
+ * syncd: CAIRN_SYNCD_TOKEN
45
+ */
46
+ export const ENV = {
47
+ obsAk: 'OBS_ACCESS_KEY_ID',
48
+ obsSk: 'OBS_SECRET_ACCESS_KEY',
49
+ syncdToken: 'CAIRN_SYNCD_TOKEN',
50
+ };
51
+ /** 本变更首版同步的个人空间键(跨设备稳定标识;项目/自定义空间同步属后续边界)。 */
52
+ export const PERSONAL_SPACE_KEY = 'personal-global';
53
+ //# sourceMappingURL=vault.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"vault.js","sourceRoot":"","sources":["../../../src/sync/vault.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAE,YAAY,EAAE,aAAa,EAAE,MAAM,SAAS,CAAC;AAClE,OAAO,EAAE,IAAI,EAAE,MAAM,WAAW,CAAC;AACjC,OAAO,EAAE,GAAG,EAAE,MAAM,mBAAmB,CAAC;AACxC,OAAO,EAAE,MAAM,EAAE,MAAM,gBAAgB,CAAC;AACxC,OAAO,EAAE,MAAM,EAAE,MAAM,iBAAiB,CAAC;AAmBzC,MAAM,UAAU,eAAe,CAAC,OAAe;IAC7C,OAAO,IAAI,CAAC,OAAO,EAAE,YAAY,CAAC,CAAC;AACrC,CAAC;AAED,MAAM,UAAU,eAAe,CAAC,OAAe;IAC7C,MAAM,CAAC,GAAG,eAAe,CAAC,OAAO,CAAC,CAAC;IACnC,IAAI,CAAC,UAAU,CAAC,CAAC,CAAC;QAAE,OAAO,IAAI,CAAC;IAChC,IAAI,CAAC;QACH,MAAM,GAAG,GAAG,IAAI,CAAC,KAAK,CAAC,YAAY,CAAC,CAAC,EAAE,MAAM,CAAC,CAAgB,CAAC;QAC/D,IAAI,GAAG,CAAC,QAAQ,KAAK,KAAK,IAAI,GAAG,CAAC,QAAQ,KAAK,OAAO;YAAE,OAAO,IAAI,CAAC;QACpE,OAAO,GAAG,CAAC;IACb,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,IAAI,CAAC;IACd,CAAC;AACH,CAAC;AAED,MAAM,UAAU,eAAe,CAAC,OAAe,EAAE,GAAsE;IACrH,IAAI,GAAG,CAAC,QAAQ,KAAK,KAAK,IAAI,CAAC,GAAG,CAAC,GAAG;QAAE,MAAM,GAAG,CAAC,cAAc,EAAE,wBAAwB,CAAC,CAAC;IAC5F,IAAI,GAAG,CAAC,QAAQ,KAAK,OAAO,IAAI,CAAC,GAAG,CAAC,KAAK;QAAE,MAAM,GAAG,CAAC,cAAc,EAAE,4BAA4B,CAAC,CAAC;IACpG,MAAM,QAAQ,GAAG,eAAe,CAAC,OAAO,CAAC,CAAC;IAC1C,IAAI,QAAQ;QAAE,MAAM,GAAG,CAAC,MAAM,EAAE,uCAAuC,CAAC,CAAC;IACzE,MAAM,IAAI,GAAgB;QACxB,OAAO,EAAE,GAAG,CAAC,OAAO,IAAI,OAAO,MAAM,EAAE,EAAE;QACzC,QAAQ,EAAE,GAAG,CAAC,QAAQ;QACtB,GAAG,EAAE,GAAG,CAAC,GAAG;QACZ,KAAK,EAAE,GAAG,CAAC,KAAK;QAChB,SAAS,EAAE,MAAM,EAAE;KACpB,CAAC;IACF,aAAa,CAAC,eAAe,CAAC,OAAO,CAAC,EAAE,IAAI,CAAC,SAAS,CAAC,IAAI,EAAE,IAAI,EAAE,CAAC,CAAC,EAAE,MAAM,CAAC,CAAC;IAC/E,OAAO,IAAI,CAAC;AACd,CAAC;AAED;;;;GAIG;AACH,MAAM,CAAC,MAAM,GAAG,GAAG;IACjB,KAAK,EAAE,mBAAmB;IAC1B,KAAK,EAAE,uBAAuB;IAC9B,UAAU,EAAE,mBAAmB;CACvB,CAAC;AAEX,8CAA8C;AAC9C,MAAM,CAAC,MAAM,kBAAkB,GAAG,iBAAiB,CAAC"}