@carloswon/cairn-memory 0.2.0 → 0.4.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 (44) hide show
  1. package/CHANGELOG.md +50 -1
  2. package/dist/src/agents/config.d.ts +14 -1
  3. package/dist/src/agents/config.js +17 -3
  4. package/dist/src/agents/config.js.map +1 -1
  5. package/dist/src/core/types.d.ts +6 -0
  6. package/dist/src/core/types.js.map +1 -1
  7. package/dist/src/governance/apply.d.ts +4 -2
  8. package/dist/src/governance/apply.js +20 -0
  9. package/dist/src/governance/apply.js.map +1 -1
  10. package/dist/src/governance/archive.d.ts +29 -0
  11. package/dist/src/governance/archive.js +52 -0
  12. package/dist/src/governance/archive.js.map +1 -0
  13. package/dist/src/interfaces/app-service.d.ts +62 -1
  14. package/dist/src/interfaces/app-service.js +172 -6
  15. package/dist/src/interfaces/app-service.js.map +1 -1
  16. package/dist/src/interfaces/cli/main.js +88 -4
  17. package/dist/src/interfaces/cli/main.js.map +1 -1
  18. package/dist/src/interfaces/mcp/server.js +70 -2
  19. package/dist/src/interfaces/mcp/server.js.map +1 -1
  20. package/dist/src/projection/brief.d.ts +35 -0
  21. package/dist/src/projection/brief.js +96 -7
  22. package/dist/src/projection/brief.js.map +1 -1
  23. package/dist/src/store/audit.d.ts +31 -0
  24. package/dist/src/store/audit.js +83 -0
  25. package/dist/src/store/audit.js.map +1 -1
  26. package/dist/src/store/memories.d.ts +35 -3
  27. package/dist/src/store/memories.js +84 -20
  28. package/dist/src/store/memories.js.map +1 -1
  29. package/dist/src/store/migrate.js +2 -1
  30. package/dist/src/store/migrate.js.map +1 -1
  31. package/dist/src/store/open.js +28 -2
  32. package/dist/src/store/open.js.map +1 -1
  33. package/dist/src/store/schema.d.ts +12 -0
  34. package/dist/src/store/schema.js +17 -0
  35. package/dist/src/store/schema.js.map +1 -1
  36. package/dist/src/sync/backfill.d.ts +36 -0
  37. package/dist/src/sync/backfill.js +48 -0
  38. package/dist/src/sync/backfill.js.map +1 -0
  39. package/dist/src/sync/vault.d.ts +2 -1
  40. package/dist/src/sync/vault.js +2 -1
  41. package/dist/src/sync/vault.js.map +1 -1
  42. package/docs/cairn-security.md +267 -254
  43. package/docs/cairn-usage.md +919 -821
  44. package/package.json +4 -3
@@ -0,0 +1,48 @@
1
+ export const BACKFILL_DEFAULT_LIMIT = 500;
2
+ export function findUpstreamGap(store) {
3
+ return store.db
4
+ .all(`SELECT m.id AS memoryId, m.scope_id AS scopeId
5
+ FROM memory m JOIN scope s ON s.id = m.scope_id
6
+ WHERE m.status = 'active' AND s.sync_policy = 'encrypted' AND s.device_id = 'all'
7
+ AND NOT EXISTS (SELECT 1 FROM outbox_job j
8
+ WHERE j.job_type = 'sync_upstream' AND j.entity_id = m.id)
9
+ ORDER BY m.created_at, m.id`)
10
+ .map((r) => ({ memoryId: String(r.memoryId), scopeId: String(r.scopeId) }));
11
+ }
12
+ /**
13
+ * `apply=false` 只统计不写(默认只读)。写入全部经 `store.outbox.enqueue`:
14
+ * 作用域物理排除与 `scope_exclusion` 审计仍由它执行,这里不新增第二处判定。
15
+ */
16
+ export function backfillUpstream(store, opts) {
17
+ const gap = findUpstreamGap(store);
18
+ const batch = gap.slice(0, opts.limit ?? BACKFILL_DEFAULT_LIMIT);
19
+ const report = { candidates: gap.length, enqueued: 0, existing: 0, excluded: 0, memoryIds: [] };
20
+ if (!opts.apply) {
21
+ report.memoryIds = batch.map((g) => g.memoryId);
22
+ return report;
23
+ }
24
+ store.db.transaction(() => {
25
+ for (const g of batch) {
26
+ const r = store.outbox.enqueue({
27
+ jobType: 'sync_upstream',
28
+ scopeId: g.scopeId,
29
+ entityType: 'memory',
30
+ entityId: g.memoryId,
31
+ payload: { op: 'memory_upsert', memoryId: g.memoryId },
32
+ idempotencyKey: `memory:${g.memoryId}`,
33
+ });
34
+ if (r.enqueued) {
35
+ report.enqueued++;
36
+ report.memoryIds.push(g.memoryId);
37
+ }
38
+ else if (r.reason === 'duplicate') {
39
+ report.existing++;
40
+ }
41
+ else {
42
+ report.excluded++;
43
+ }
44
+ }
45
+ });
46
+ return report;
47
+ }
48
+ //# sourceMappingURL=backfill.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"backfill.js","sourceRoot":"","sources":["../../../src/sync/backfill.ts"],"names":[],"mappings":"AA8BA,MAAM,CAAC,MAAM,sBAAsB,GAAG,GAAG,CAAC;AAE1C,MAAM,UAAU,eAAe,CAAC,KAAiB;IAC/C,OAAO,KAAK,CAAC,EAAE;SACZ,GAAG,CACF;;;;;mCAK6B,CAC9B;SACA,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,EAAE,QAAQ,EAAE,MAAM,CAAC,CAAC,CAAC,QAAQ,CAAC,EAAE,OAAO,EAAE,MAAM,CAAC,CAAC,CAAC,OAAO,CAAC,EAAE,CAAC,CAAC,CAAC;AAChF,CAAC;AAED;;;GAGG;AACH,MAAM,UAAU,gBAAgB,CAAC,KAAiB,EAAE,IAAwC;IAC1F,MAAM,GAAG,GAAG,eAAe,CAAC,KAAK,CAAC,CAAC;IACnC,MAAM,KAAK,GAAG,GAAG,CAAC,KAAK,CAAC,CAAC,EAAE,IAAI,CAAC,KAAK,IAAI,sBAAsB,CAAC,CAAC;IACjE,MAAM,MAAM,GAAmB,EAAE,UAAU,EAAE,GAAG,CAAC,MAAM,EAAE,QAAQ,EAAE,CAAC,EAAE,QAAQ,EAAE,CAAC,EAAE,QAAQ,EAAE,CAAC,EAAE,SAAS,EAAE,EAAE,EAAE,CAAC;IAChH,IAAI,CAAC,IAAI,CAAC,KAAK,EAAE,CAAC;QAChB,MAAM,CAAC,SAAS,GAAG,KAAK,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,QAAQ,CAAC,CAAC;QAChD,OAAO,MAAM,CAAC;IAChB,CAAC;IACD,KAAK,CAAC,EAAE,CAAC,WAAW,CAAC,GAAG,EAAE;QACxB,KAAK,MAAM,CAAC,IAAI,KAAK,EAAE,CAAC;YACtB,MAAM,CAAC,GAAG,KAAK,CAAC,MAAM,CAAC,OAAO,CAAC;gBAC7B,OAAO,EAAE,eAAe;gBACxB,OAAO,EAAE,CAAC,CAAC,OAAO;gBAClB,UAAU,EAAE,QAAQ;gBACpB,QAAQ,EAAE,CAAC,CAAC,QAAQ;gBACpB,OAAO,EAAE,EAAE,EAAE,EAAE,eAAe,EAAE,QAAQ,EAAE,CAAC,CAAC,QAAQ,EAAE;gBACtD,cAAc,EAAE,UAAU,CAAC,CAAC,QAAQ,EAAE;aACvC,CAAC,CAAC;YACH,IAAI,CAAC,CAAC,QAAQ,EAAE,CAAC;gBACf,MAAM,CAAC,QAAQ,EAAE,CAAC;gBAClB,MAAM,CAAC,SAAS,CAAC,IAAI,CAAC,CAAC,CAAC,QAAQ,CAAC,CAAC;YACpC,CAAC;iBAAM,IAAI,CAAC,CAAC,MAAM,KAAK,WAAW,EAAE,CAAC;gBACpC,MAAM,CAAC,QAAQ,EAAE,CAAC;YACpB,CAAC;iBAAM,CAAC;gBACN,MAAM,CAAC,QAAQ,EAAE,CAAC;YACpB,CAAC;QACH,CAAC;IACH,CAAC,CAAC,CAAC;IACH,OAAO,MAAM,CAAC;AAChB,CAAC"}
@@ -26,12 +26,13 @@ export declare function saveVaultConfig(dataDir: string, cfg: Omit<VaultConfig,
26
26
  /**
27
27
  * 环境变量名约定(与 GITHUB_TOKEN 同模式,用户级注入):
28
28
  * OBS: OBS_ACCESS_KEY_ID / OBS_SECRET_ACCESS_KEY(+ vault.json 的 endpoint/bucket/prefix)
29
- * syncd: CAIRN_SYNCD_TOKEN
29
+ * syncd: CAIRN_SYNCD_TOKEN(凭据);CAIRN_SYNCD_URL(baseUrl 缺省值,命令行 --base-url 优先)
30
30
  */
31
31
  export declare const ENV: {
32
32
  readonly obsAk: "OBS_ACCESS_KEY_ID";
33
33
  readonly obsSk: "OBS_SECRET_ACCESS_KEY";
34
34
  readonly syncdToken: "CAIRN_SYNCD_TOKEN";
35
+ readonly syncdUrl: "CAIRN_SYNCD_URL";
35
36
  };
36
37
  /** 本变更首版同步的个人空间键(跨设备稳定标识;项目/自定义空间同步属后续边界)。 */
37
38
  export declare const PERSONAL_SPACE_KEY = "personal-global";
@@ -41,12 +41,13 @@ export function saveVaultConfig(dataDir, cfg) {
41
41
  /**
42
42
  * 环境变量名约定(与 GITHUB_TOKEN 同模式,用户级注入):
43
43
  * OBS: OBS_ACCESS_KEY_ID / OBS_SECRET_ACCESS_KEY(+ vault.json 的 endpoint/bucket/prefix)
44
- * syncd: CAIRN_SYNCD_TOKEN
44
+ * syncd: CAIRN_SYNCD_TOKEN(凭据);CAIRN_SYNCD_URL(baseUrl 缺省值,命令行 --base-url 优先)
45
45
  */
46
46
  export const ENV = {
47
47
  obsAk: 'OBS_ACCESS_KEY_ID',
48
48
  obsSk: 'OBS_SECRET_ACCESS_KEY',
49
49
  syncdToken: 'CAIRN_SYNCD_TOKEN',
50
+ syncdUrl: 'CAIRN_SYNCD_URL',
50
51
  };
51
52
  /** 本变更首版同步的个人空间键(跨设备稳定标识;项目/自定义空间同步属后续边界)。 */
52
53
  export const PERSONAL_SPACE_KEY = 'personal-global';
@@ -1 +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"}
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;IAC/B,QAAQ,EAAE,iBAAiB;CACnB,CAAC;AAEX,8CAA8C;AAC9C,MAAM,CAAC,MAAM,kBAAkB,GAAG,iBAAiB,CAAC"}