@carloswon/cairn-memory 0.6.2 → 0.6.4

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 (35) hide show
  1. package/dist/src/interfaces/app-service.d.ts +16 -1
  2. package/dist/src/interfaces/app-service.js +67 -41
  3. package/dist/src/interfaces/app-service.js.map +1 -1
  4. package/dist/src/interfaces/cli/main.js +24 -0
  5. package/dist/src/interfaces/cli/main.js.map +1 -1
  6. package/dist/src/interfaces/console/assets/ui-js.js +36 -6
  7. package/dist/src/interfaces/console/assets/ui-js.js.map +1 -1
  8. package/dist/src/interfaces/console/model.d.ts +15 -0
  9. package/dist/src/interfaces/console/model.js +25 -1
  10. package/dist/src/interfaces/console/model.js.map +1 -1
  11. package/dist/src/interfaces/console/server.js +12 -2
  12. package/dist/src/interfaces/console/server.js.map +1 -1
  13. package/dist/src/store/memories.js +2 -0
  14. package/dist/src/store/memories.js.map +1 -1
  15. package/dist/src/sync/apply.d.ts +6 -1
  16. package/dist/src/sync/apply.js +50 -6
  17. package/dist/src/sync/apply.js.map +1 -1
  18. package/dist/src/sync/backfill.d.ts +19 -6
  19. package/dist/src/sync/backfill.js +38 -7
  20. package/dist/src/sync/backfill.js.map +1 -1
  21. package/dist/src/sync/events.d.ts +6 -0
  22. package/dist/src/sync/events.js.map +1 -1
  23. package/dist/src/sync/pull.d.ts +2 -1
  24. package/dist/src/sync/pull.js +35 -3
  25. package/dist/src/sync/pull.js.map +1 -1
  26. package/dist/src/sync/push.d.ts +2 -2
  27. package/dist/src/sync/push.js +37 -11
  28. package/dist/src/sync/push.js.map +1 -1
  29. package/dist/src/sync/route.d.ts +2 -1
  30. package/dist/src/sync/route.js +22 -1
  31. package/dist/src/sync/route.js.map +1 -1
  32. package/dist/src/sync/vault.d.ts +12 -2
  33. package/dist/src/sync/vault.js +25 -2
  34. package/dist/src/sync/vault.js.map +1 -1
  35. package/package.json +1 -1
@@ -76,17 +76,40 @@ export function preserveSpaceKey(deviceId) {
76
76
  export function isPreserveSpaceKey(spaceKey) {
77
77
  return spaceKey.startsWith(PRESERVE_CHAIN_PREFIX);
78
78
  }
79
+ /**
80
+ * 项目链前缀(add-cross-device-project-sync D1):一个项目一条链,`project/<projectId>`。
81
+ * projectId 是跨设备稳定 UUID;所有设备都列举并拉取(与保管链相反)。
82
+ */
83
+ export const PROJECT_CHAIN_PREFIX = 'project/';
84
+ export function projectSpaceKey(projectId) {
85
+ return `${PROJECT_CHAIN_PREFIX}${projectId}`;
86
+ }
87
+ export function isProjectSpaceKey(spaceKey) {
88
+ return spaceKey.startsWith(PROJECT_CHAIN_PREFIX);
89
+ }
90
+ /** 反解项目链的空间键;非项目链或空 id 返回 null(不猜、不抛)。 */
91
+ export function projectIdFromSpaceKey(spaceKey) {
92
+ if (!isProjectSpaceKey(spaceKey))
93
+ return null;
94
+ const id = spaceKey.slice(PROJECT_CHAIN_PREFIX.length);
95
+ return id.length > 0 ? id : null;
96
+ }
79
97
  /** 保管链承载的作用域预设(spec「保管链与物化过滤」:设备限定与项目内容)。 */
80
98
  export const PRESERVE_SCOPE_PRESETS = ['device-local', 'project-global', 'project-device'];
81
99
  export function isPreserveScopePreset(preset) {
82
100
  return PRESERVE_SCOPE_PRESETS.includes(preset);
83
101
  }
84
102
  /**
85
- * 本设备会消费的链(tasks 1.3):个人链恒在;保管模式开启时加本设备保管链。
103
+ * 本设备会消费的链(tasks 1.3):个人链恒在;项目链按调用方传入的列表展开
104
+ * (本函数不读 DB、不触网——发现与登记是调用方的事);保管模式开启时加本设备保管链。
86
105
  * pull 范围 = 这条列表——他人保管链对象完全不被下载(D2)。
87
106
  */
88
- export function syncableChains(vault, deviceId) {
107
+ export function syncableChains(vault, deviceId, projectIds = []) {
89
108
  const chains = [PERSONAL_SPACE_KEY];
109
+ for (const projectId of projectIds) {
110
+ if (projectId)
111
+ chains.push(projectSpaceKey(projectId));
112
+ }
90
113
  if (vault.preserveDeviceBound === true)
91
114
  chains.push(preserveSpaceKey(deviceId));
92
115
  return chains;
@@ -1 +1 @@
1
- {"version":3,"file":"vault.js","sourceRoot":"","sources":["../../../src/sync/vault.ts"],"names":[],"mappings":"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"}
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;AA0BzC,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,GAAG,CAAC,GAAG,CAAC,mBAAmB,CAAC,CAAC,CAAC,EAAE,mBAAmB,EAAE,IAAI,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;QACjE,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,mDAAmD;AACnD,MAAM,UAAU,iBAAiB,CAAC,OAAe,EAAE,KAAuC;IACxF,MAAM,GAAG,GAAG,eAAe,CAAC,OAAO,CAAC,CAAC;IACrC,IAAI,CAAC,GAAG;QAAE,MAAM,GAAG,CAAC,cAAc,EAAE,0CAA0C,CAAC,CAAC;IAChF,MAAM,IAAI,GAAgB,EAAE,GAAG,GAAG,EAAE,mBAAmB,EAAE,KAAK,CAAC,mBAAmB,EAAE,CAAC;IACrF,IAAI,CAAC,KAAK,CAAC,mBAAmB;QAAE,OAAO,IAAI,CAAC,mBAAmB,CAAC,CAAC,wBAAwB;IACzF,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,gCAAgC;AAChC,MAAM,UAAU,mBAAmB,CAAC,OAAe;IACjD,OAAO,eAAe,CAAC,OAAO,CAAC,EAAE,mBAAmB,KAAK,IAAI,CAAC;AAChE,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,iDAAiD;AACjD,MAAM,CAAC,MAAM,kBAAkB,GAAG,iBAAiB,CAAC;AAEpD,4DAA4D;AAC5D,MAAM,CAAC,MAAM,qBAAqB,GAAG,WAAW,CAAC;AAEjD,kBAAkB;AAClB,MAAM,UAAU,gBAAgB,CAAC,QAAgB;IAC/C,OAAO,GAAG,qBAAqB,GAAG,QAAQ,EAAE,CAAC;AAC/C,CAAC;AAED,MAAM,UAAU,kBAAkB,CAAC,QAAgB;IACjD,OAAO,QAAQ,CAAC,UAAU,CAAC,qBAAqB,CAAC,CAAC;AACpD,CAAC;AAED;;;GAGG;AACH,MAAM,CAAC,MAAM,oBAAoB,GAAG,UAAU,CAAC;AAE/C,MAAM,UAAU,eAAe,CAAC,SAAiB;IAC/C,OAAO,GAAG,oBAAoB,GAAG,SAAS,EAAE,CAAC;AAC/C,CAAC;AAED,MAAM,UAAU,iBAAiB,CAAC,QAAgB;IAChD,OAAO,QAAQ,CAAC,UAAU,CAAC,oBAAoB,CAAC,CAAC;AACnD,CAAC;AAED,0CAA0C;AAC1C,MAAM,UAAU,qBAAqB,CAAC,QAAgB;IACpD,IAAI,CAAC,iBAAiB,CAAC,QAAQ,CAAC;QAAE,OAAO,IAAI,CAAC;IAC9C,MAAM,EAAE,GAAG,QAAQ,CAAC,KAAK,CAAC,oBAAoB,CAAC,MAAM,CAAC,CAAC;IACvD,OAAO,EAAE,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC;AACnC,CAAC;AAED,6CAA6C;AAC7C,MAAM,CAAC,MAAM,sBAAsB,GAAG,CAAC,cAAc,EAAE,gBAAgB,EAAE,gBAAgB,CAAU,CAAC;AAEpG,MAAM,UAAU,qBAAqB,CAAC,MAAc;IAClD,OAAQ,sBAA4C,CAAC,QAAQ,CAAC,MAAM,CAAC,CAAC;AACxE,CAAC;AAED;;;;GAIG;AACH,MAAM,UAAU,cAAc,CAAC,KAAkB,EAAE,QAAgB,EAAE,aAAgC,EAAE;IACrG,MAAM,MAAM,GAAG,CAAC,kBAAkB,CAAC,CAAC;IACpC,KAAK,MAAM,SAAS,IAAI,UAAU,EAAE,CAAC;QACnC,IAAI,SAAS;YAAE,MAAM,CAAC,IAAI,CAAC,eAAe,CAAC,SAAS,CAAC,CAAC,CAAC;IACzD,CAAC;IACD,IAAI,KAAK,CAAC,mBAAmB,KAAK,IAAI;QAAE,MAAM,CAAC,IAAI,CAAC,gBAAgB,CAAC,QAAQ,CAAC,CAAC,CAAC;IAChF,OAAO,MAAM,CAAC;AAChB,CAAC"}
package/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "@carloswon/cairn-memory",
3
- "version": "0.6.2",
3
+ "version": "0.6.4",
4
4
  "description": "Cairn — 个人、多设备、多 Agent 的本地优先记忆主权层。本地 SQLite 为权威副本,云端仅作可选加密中继。",
5
5
  "license": "MIT",
6
6
  "type": "module",