@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.
Files changed (225) hide show
  1. package/CHANGELOG.md +81 -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 +139 -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/archive.d.ts +29 -0
  44. package/dist/src/governance/archive.js +52 -0
  45. package/dist/src/governance/archive.js.map +1 -0
  46. package/dist/src/governance/dedup.d.ts +21 -0
  47. package/dist/src/governance/dedup.js +23 -0
  48. package/dist/src/governance/dedup.js.map +1 -0
  49. package/dist/src/governance/index.d.ts +16 -0
  50. package/dist/src/governance/index.js +17 -0
  51. package/dist/src/governance/index.js.map +1 -0
  52. package/dist/src/governance/propose.d.ts +78 -0
  53. package/dist/src/governance/propose.js +150 -0
  54. package/dist/src/governance/propose.js.map +1 -0
  55. package/dist/src/index.d.ts +15 -0
  56. package/dist/src/index.js +24 -0
  57. package/dist/src/index.js.map +1 -0
  58. package/dist/src/interfaces/app-service.d.ts +292 -0
  59. package/dist/src/interfaces/app-service.js +743 -0
  60. package/dist/src/interfaces/app-service.js.map +1 -0
  61. package/dist/src/interfaces/cli/main.d.ts +2 -0
  62. package/dist/src/interfaces/cli/main.js +854 -0
  63. package/dist/src/interfaces/cli/main.js.map +1 -0
  64. package/dist/src/interfaces/console/assets/page.d.ts +18 -0
  65. package/dist/src/interfaces/console/assets/page.js +39 -0
  66. package/dist/src/interfaces/console/assets/page.js.map +1 -0
  67. package/dist/src/interfaces/console/assets/ui-css.d.ts +11 -0
  68. package/dist/src/interfaces/console/assets/ui-css.js +119 -0
  69. package/dist/src/interfaces/console/assets/ui-css.js.map +1 -0
  70. package/dist/src/interfaces/console/assets/ui-js.d.ts +14 -0
  71. package/dist/src/interfaces/console/assets/ui-js.js +1098 -0
  72. package/dist/src/interfaces/console/assets/ui-js.js.map +1 -0
  73. package/dist/src/interfaces/console/assets/url-state.d.ts +9 -0
  74. package/dist/src/interfaces/console/assets/url-state.js +45 -0
  75. package/dist/src/interfaces/console/assets/url-state.js.map +1 -0
  76. package/dist/src/interfaces/console/export.d.ts +46 -0
  77. package/dist/src/interfaces/console/export.js +84 -0
  78. package/dist/src/interfaces/console/export.js.map +1 -0
  79. package/dist/src/interfaces/console/model.d.ts +372 -0
  80. package/dist/src/interfaces/console/model.js +731 -0
  81. package/dist/src/interfaces/console/model.js.map +1 -0
  82. package/dist/src/interfaces/console/review-store.d.ts +142 -0
  83. package/dist/src/interfaces/console/review-store.js +342 -0
  84. package/dist/src/interfaces/console/review-store.js.map +1 -0
  85. package/dist/src/interfaces/console/security.d.ts +76 -0
  86. package/dist/src/interfaces/console/security.js +105 -0
  87. package/dist/src/interfaces/console/security.js.map +1 -0
  88. package/dist/src/interfaces/console/server.d.ts +45 -0
  89. package/dist/src/interfaces/console/server.js +476 -0
  90. package/dist/src/interfaces/console/server.js.map +1 -0
  91. package/dist/src/interfaces/console/suggestions.d.ts +112 -0
  92. package/dist/src/interfaces/console/suggestions.js +511 -0
  93. package/dist/src/interfaces/console/suggestions.js.map +1 -0
  94. package/dist/src/interfaces/console/text.d.ts +4 -0
  95. package/dist/src/interfaces/console/text.js +18 -0
  96. package/dist/src/interfaces/console/text.js.map +1 -0
  97. package/dist/src/interfaces/mcp/server.d.ts +4 -0
  98. package/dist/src/interfaces/mcp/server.js +480 -0
  99. package/dist/src/interfaces/mcp/server.js.map +1 -0
  100. package/dist/src/jobs/index.d.ts +6 -0
  101. package/dist/src/jobs/index.js +7 -0
  102. package/dist/src/jobs/index.js.map +1 -0
  103. package/dist/src/jobs/remote.d.ts +42 -0
  104. package/dist/src/jobs/remote.js +34 -0
  105. package/dist/src/jobs/remote.js.map +1 -0
  106. package/dist/src/jobs/worker.d.ts +67 -0
  107. package/dist/src/jobs/worker.js +169 -0
  108. package/dist/src/jobs/worker.js.map +1 -0
  109. package/dist/src/onboarding/auto.d.ts +88 -0
  110. package/dist/src/onboarding/auto.js +399 -0
  111. package/dist/src/onboarding/auto.js.map +1 -0
  112. package/dist/src/onboarding/batches.d.ts +103 -0
  113. package/dist/src/onboarding/batches.js +219 -0
  114. package/dist/src/onboarding/batches.js.map +1 -0
  115. package/dist/src/onboarding/discover.d.ts +54 -0
  116. package/dist/src/onboarding/discover.js +369 -0
  117. package/dist/src/onboarding/discover.js.map +1 -0
  118. package/dist/src/onboarding/import.d.ts +69 -0
  119. package/dist/src/onboarding/import.js +279 -0
  120. package/dist/src/onboarding/import.js.map +1 -0
  121. package/dist/src/onboarding/index.d.ts +24 -0
  122. package/dist/src/onboarding/index.js +22 -0
  123. package/dist/src/onboarding/index.js.map +1 -0
  124. package/dist/src/onboarding/judgement.d.ts +50 -0
  125. package/dist/src/onboarding/judgement.js +121 -0
  126. package/dist/src/onboarding/judgement.js.map +1 -0
  127. package/dist/src/onboarding/policy.d.ts +86 -0
  128. package/dist/src/onboarding/policy.js +249 -0
  129. package/dist/src/onboarding/policy.js.map +1 -0
  130. package/dist/src/projection/brief.d.ts +112 -0
  131. package/dist/src/projection/brief.js +200 -0
  132. package/dist/src/projection/brief.js.map +1 -0
  133. package/dist/src/projection/index.d.ts +1 -0
  134. package/dist/src/projection/index.js +2 -0
  135. package/dist/src/projection/index.js.map +1 -0
  136. package/dist/src/projection/markdown.d.ts +82 -0
  137. package/dist/src/projection/markdown.js +313 -0
  138. package/dist/src/projection/markdown.js.map +1 -0
  139. package/dist/src/retrieval/export.d.ts +80 -0
  140. package/dist/src/retrieval/export.js +215 -0
  141. package/dist/src/retrieval/export.js.map +1 -0
  142. package/dist/src/retrieval/index.d.ts +5 -0
  143. package/dist/src/retrieval/index.js +6 -0
  144. package/dist/src/retrieval/index.js.map +1 -0
  145. package/dist/src/retrieval/search.d.ts +37 -0
  146. package/dist/src/retrieval/search.js +294 -0
  147. package/dist/src/retrieval/search.js.map +1 -0
  148. package/dist/src/store/archives.d.ts +94 -0
  149. package/dist/src/store/archives.js +135 -0
  150. package/dist/src/store/archives.js.map +1 -0
  151. package/dist/src/store/audit.d.ts +57 -0
  152. package/dist/src/store/audit.js +131 -0
  153. package/dist/src/store/audit.js.map +1 -0
  154. package/dist/src/store/backup.d.ts +36 -0
  155. package/dist/src/store/backup.js +90 -0
  156. package/dist/src/store/backup.js.map +1 -0
  157. package/dist/src/store/blocks.d.ts +64 -0
  158. package/dist/src/store/blocks.js +104 -0
  159. package/dist/src/store/blocks.js.map +1 -0
  160. package/dist/src/store/conflicts.d.ts +52 -0
  161. package/dist/src/store/conflicts.js +112 -0
  162. package/dist/src/store/conflicts.js.map +1 -0
  163. package/dist/src/store/db.d.ts +44 -0
  164. package/dist/src/store/db.js +162 -0
  165. package/dist/src/store/db.js.map +1 -0
  166. package/dist/src/store/device.d.ts +46 -0
  167. package/dist/src/store/device.js +111 -0
  168. package/dist/src/store/device.js.map +1 -0
  169. package/dist/src/store/index.d.ts +14 -0
  170. package/dist/src/store/index.js +15 -0
  171. package/dist/src/store/index.js.map +1 -0
  172. package/dist/src/store/memories.d.ts +133 -0
  173. package/dist/src/store/memories.js +442 -0
  174. package/dist/src/store/memories.js.map +1 -0
  175. package/dist/src/store/migrate.d.ts +32 -0
  176. package/dist/src/store/migrate.js +87 -0
  177. package/dist/src/store/migrate.js.map +1 -0
  178. package/dist/src/store/open.d.ts +53 -0
  179. package/dist/src/store/open.js +203 -0
  180. package/dist/src/store/open.js.map +1 -0
  181. package/dist/src/store/outbox.d.ts +65 -0
  182. package/dist/src/store/outbox.js +137 -0
  183. package/dist/src/store/outbox.js.map +1 -0
  184. package/dist/src/store/plans.d.ts +137 -0
  185. package/dist/src/store/plans.js +243 -0
  186. package/dist/src/store/plans.js.map +1 -0
  187. package/dist/src/store/schema.d.ts +46 -0
  188. package/dist/src/store/schema.js +544 -0
  189. package/dist/src/store/schema.js.map +1 -0
  190. package/dist/src/store/scopes.d.ts +44 -0
  191. package/dist/src/store/scopes.js +220 -0
  192. package/dist/src/store/scopes.js.map +1 -0
  193. package/dist/src/store/write-guard.d.ts +10 -0
  194. package/dist/src/store/write-guard.js +10 -0
  195. package/dist/src/store/write-guard.js.map +1 -0
  196. package/dist/src/sync/apply.d.ts +24 -0
  197. package/dist/src/sync/apply.js +130 -0
  198. package/dist/src/sync/apply.js.map +1 -0
  199. package/dist/src/sync/cryptoutil.d.ts +86 -0
  200. package/dist/src/sync/cryptoutil.js +339 -0
  201. package/dist/src/sync/cryptoutil.js.map +1 -0
  202. package/dist/src/sync/events.d.ts +69 -0
  203. package/dist/src/sync/events.js +78 -0
  204. package/dist/src/sync/events.js.map +1 -0
  205. package/dist/src/sync/obs-store.d.ts +41 -0
  206. package/dist/src/sync/obs-store.js +325 -0
  207. package/dist/src/sync/obs-store.js.map +1 -0
  208. package/dist/src/sync/orchestrate.d.ts +37 -0
  209. package/dist/src/sync/orchestrate.js +84 -0
  210. package/dist/src/sync/orchestrate.js.map +1 -0
  211. package/dist/src/sync/pull.d.ts +24 -0
  212. package/dist/src/sync/pull.js +150 -0
  213. package/dist/src/sync/pull.js.map +1 -0
  214. package/dist/src/sync/push.d.ts +19 -0
  215. package/dist/src/sync/push.js +227 -0
  216. package/dist/src/sync/push.js.map +1 -0
  217. package/dist/src/sync/syncd-store.d.ts +31 -0
  218. package/dist/src/sync/syncd-store.js +92 -0
  219. package/dist/src/sync/syncd-store.js.map +1 -0
  220. package/dist/src/sync/vault.d.ts +37 -0
  221. package/dist/src/sync/vault.js +53 -0
  222. package/dist/src/sync/vault.js.map +1 -0
  223. package/docs/cairn-security.md +267 -0
  224. package/docs/cairn-usage.md +919 -0
  225. package/package.json +71 -4
@@ -0,0 +1 @@
1
+ {"version":3,"file":"ui-js.js","sourceRoot":"","sources":["../../../../../src/interfaces/console/assets/ui-js.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;GAYG;AAEH,OAAO,EAAE,aAAa,EAAE,MAAM,gBAAgB,CAAC;AAE/C,MAAM,CAAC,MAAM,KAAK,GAAG,MAAM,CAAC,GAAG,CAAA;;;CAG9B,GAAG,aAAa,GAAG,MAAM,CAAC,GAAG,CAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CAujC7B,CAAC"}
@@ -0,0 +1,9 @@
1
+ /**
2
+ * URL ↔ 视图状态编解码(design D4/D7,任务 4.4/4.5/4.7)。
3
+ *
4
+ * 以**源码字符串**形式存在,被 ui-js 原样嵌进页面;测试用同一个字符串
5
+ * 在沙箱里实例化后断言往返一致。这样"页面里跑的"和"测过的"是同一段代码,
6
+ * 不会出现"测试绿了、页面另写一份"的双实现漂移。
7
+ */
8
+ export declare const URL_STATE_KEYS: readonly ["view", "q", "scope", "status", "kind", "batch", "plan", "drawer", "item"];
9
+ export declare const URL_STATE_SRC: string;
@@ -0,0 +1,45 @@
1
+ /**
2
+ * URL ↔ 视图状态编解码(design D4/D7,任务 4.4/4.5/4.7)。
3
+ *
4
+ * 以**源码字符串**形式存在,被 ui-js 原样嵌进页面;测试用同一个字符串
5
+ * 在沙箱里实例化后断言往返一致。这样"页面里跑的"和"测过的"是同一段代码,
6
+ * 不会出现"测试绿了、页面另写一份"的双实现漂移。
7
+ */
8
+ export const URL_STATE_KEYS = ['view', 'q', 'scope', 'status', 'kind', 'batch', 'plan', 'drawer', 'item'];
9
+ export const URL_STATE_SRC = String.raw `
10
+ var DEFAULT_VIEW = 'overview';
11
+ /** 唯一键表:encode / decode 都从这里读,加键只改这一处。 */
12
+ var KEYS = ['view', 'q', 'scope', 'status', 'kind', 'batch', 'plan', 'drawer', 'item'];
13
+
14
+ /** 只认白名单键;未给出的键不写,避免把 undefined 写成字符串 "undefined"。 */
15
+ function encodeState(st) {
16
+ var p = new URLSearchParams();
17
+ for (var i = 0; i < KEYS.length; i++) {
18
+ var k = KEYS[i];
19
+ // view 的默认值不进地址:没参数就是概览,地址干净且分享出去不会多一个噪声参数。
20
+ if (k === 'view' && (!st.view || st.view === DEFAULT_VIEW)) continue;
21
+ if (st[k]) p.set(k, st[k]);
22
+ }
23
+ p.set('mode', st.mode === 'full' ? 'full' : 'brief');
24
+ return p.toString();
25
+ }
26
+
27
+ /**
28
+ * URL 优先于 localStorage:刷新 / 粘贴链接必须复现同一屏;
29
+ * 只有 URL 未带 mode 时才回落到上次选择。
30
+ */
31
+ function decodeState(search, savedMode) {
32
+ var p = new URLSearchParams(search || '');
33
+ var out = {};
34
+ for (var i = 0; i < KEYS.length; i++) {
35
+ var k = KEYS[i];
36
+ var v = p.get(k);
37
+ if (v !== null && v !== '') out[k] = v;
38
+ }
39
+ if (out.view == null) out.view = DEFAULT_VIEW;
40
+ var urlMode = p.get('mode');
41
+ out.mode = urlMode === 'full' || urlMode === 'brief' ? urlMode : (savedMode === 'full' ? 'full' : 'brief');
42
+ return out;
43
+ }
44
+ `;
45
+ //# sourceMappingURL=url-state.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"url-state.js","sourceRoot":"","sources":["../../../../../src/interfaces/console/assets/url-state.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,MAAM,CAAC,MAAM,cAAc,GAAG,CAAC,MAAM,EAAE,GAAG,EAAE,OAAO,EAAE,QAAQ,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,CAAU,CAAC;AAEnH,MAAM,CAAC,MAAM,aAAa,GAAG,MAAM,CAAC,GAAG,CAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CAmCtC,CAAC"}
@@ -0,0 +1,46 @@
1
+ import { CairnStore } from '../../store/open.js';
2
+ import { ConsoleModel, ViewMode } from './model.js';
3
+ /**
4
+ * 静态导出(design D8)。
5
+ *
6
+ * 默认输出**完整正文**(含 sensitivity='sensitive' 的记忆),这是用户的明确取舍:
7
+ * 完整的可审计性优先于默认保守。代价用三层告知承担,而不是用技术阻断假装安全:
8
+ * 1. 文件名追加 `-personal`;
9
+ * 2. 文件头与页面顶部显式警示;
10
+ * 3. 导出完成时 stdout 打印条目数与字符量。
11
+ *
12
+ * 需要外发时用 `--redact` 回到全掩码。只有一个反向开关,不做 `--include-blocked`
13
+ * 之类的组合开关——两个开关同时存在会产生"我打开了 A 却以为也打开了 B"的歧义。
14
+ *
15
+ * 关于 blocked 条目:它们**在导入阶段就被替换成 `[blocked:kind]` 占位符**,原文从未
16
+ * 入库(import.ts:blockedPlaceholder)。所以无论开关怎么设都导不出那些原文;
17
+ * 导出会如实标注这一点,而不是让读者以为"这里被工具藏起来了"。
18
+ */
19
+ export interface ExportUiOptions {
20
+ outFile?: string;
21
+ redact?: boolean;
22
+ mode?: ViewMode;
23
+ /** 体积超限时的降级阈值,默认 8 MB;测试可调小。 */
24
+ maxBytes?: number;
25
+ /** 降级时保留正文的条目数,默认 500。 */
26
+ degradeKeepItems?: number;
27
+ }
28
+ export interface ExportUiResult {
29
+ outFile: string;
30
+ bytes: number;
31
+ counts: {
32
+ memories: number;
33
+ archives: number;
34
+ items: number;
35
+ batches: number;
36
+ plans: number;
37
+ };
38
+ redacted: boolean;
39
+ /** 因体积降级而被裁掉正文的条目数(0 表示未降级)。 */
40
+ degradedItems: number;
41
+ warnings: string[];
42
+ }
43
+ export declare function exportConsoleHtml(store: CairnStore, opts?: ExportUiOptions): ExportUiResult;
44
+ /** 保证导出文件名带 -personal:用户显式给了路径就尊重,只在其 stem 上补后缀。 */
45
+ export declare function normalizePersonalName(outFile: string): string;
46
+ export declare function renderExportPage(model: ConsoleModel): string;
@@ -0,0 +1,84 @@
1
+ import { mkdirSync, writeFileSync } from 'node:fs';
2
+ import { basename, dirname, extname, join } from 'node:path';
3
+ import { nowIso } from '../../core/time.js';
4
+ import { buildModel } from './model.js';
5
+ import { renderShell } from './assets/page.js';
6
+ import { safeJsonForScript } from './text.js';
7
+ const DEFAULT_MAX_BYTES = 8 * 1024 * 1024;
8
+ const DEFAULT_DEGRADE_KEEP = 500;
9
+ export function exportConsoleHtml(store, opts = {}) {
10
+ const redact = opts.redact ?? false;
11
+ const mode = opts.mode ?? 'full';
12
+ const warnings = [];
13
+ let model = buildModel(store, { mode, redact, includeItems: true });
14
+ let degradedItems = 0;
15
+ const maxBytes = opts.maxBytes ?? DEFAULT_MAX_BYTES;
16
+ let html = renderExportPage(model);
17
+ if (Buffer.byteLength(html, 'utf8') > maxBytes) {
18
+ const keep = opts.degradeKeepItems ?? DEFAULT_DEGRADE_KEEP;
19
+ model = degrade(model, keep);
20
+ degradedItems = Math.max(0, (model.items?.length ?? 0) - keep);
21
+ html = renderExportPage(model);
22
+ warnings.push(`产物超过 ${(maxBytes / 1024 / 1024).toFixed(1)} MB,已降级为"元数据 + 前 ${keep} 条正文",${degradedItems} 条正文被裁掉(文件头已标注)`);
23
+ }
24
+ // 文件名层也在这里收口:CLI 与 API 两条路径都不该漏掉 -personal 后缀。
25
+ const outFile = normalizePersonalName(opts.outFile ?? defaultOutFile(store));
26
+ mkdirSync(dirname(outFile), { recursive: true });
27
+ writeFileSync(outFile, html, 'utf8');
28
+ const blocked = Number(store.db.scalar("SELECT COUNT(*) AS n FROM import_item WHERE scan_state = 'blocked'") ?? 0);
29
+ if (blocked > 0 && !redact) {
30
+ warnings.push(`${blocked} 条 blocked 条目只能给出占位符与扫描类别:它们的原文在导入阶段已按安全策略丢弃,不在库中`);
31
+ }
32
+ return {
33
+ outFile,
34
+ bytes: Buffer.byteLength(html, 'utf8'),
35
+ counts: {
36
+ memories: model.memories.length,
37
+ archives: model.archives.length,
38
+ items: model.items?.length ?? 0,
39
+ batches: model.batches.length,
40
+ plans: model.plans.length,
41
+ },
42
+ redacted: redact,
43
+ degradedItems,
44
+ warnings,
45
+ };
46
+ }
47
+ function degrade(model, keep) {
48
+ const items = model.items ?? [];
49
+ return {
50
+ ...model,
51
+ items: items.map((it, i) => i < keep
52
+ ? it
53
+ : {
54
+ ...it,
55
+ content: { masked: false, text: null, length: it.content.length, hashPrefix: it.content.hashPrefix, truncated: true },
56
+ }),
57
+ };
58
+ }
59
+ /** 默认文件名:`cairn-preview-personal.html`;已有同名则追加时间戳避免覆盖。 */
60
+ function defaultOutFile(store) {
61
+ const stamp = nowIso().replace(/[:.]/g, '-').replace('T', '_').slice(0, 19);
62
+ return join(store.paths.home, 'console', `cairn-preview-personal-${stamp}.html`);
63
+ }
64
+ /** 保证导出文件名带 -personal:用户显式给了路径就尊重,只在其 stem 上补后缀。 */
65
+ export function normalizePersonalName(outFile) {
66
+ const ext = extname(outFile) || '.html';
67
+ const stem = basename(outFile, ext);
68
+ if (stem.includes('-personal'))
69
+ return outFile;
70
+ return join(dirname(outFile), `${stem}-personal${ext}`);
71
+ }
72
+ export function renderExportPage(model) {
73
+ const banner = model.redacted
74
+ ? '此文件为脱敏导出:sensitive 记忆正文已替换为掩码。'
75
+ : '此文件含明文本地记忆,请勿外传。默认导出包含完整正文(含 sensitive 标记的记忆)。';
76
+ const blockedNote = 'blocked 条目只显示占位符与扫描类别:这些条目的原文在导入阶段已按安全策略物理丢弃,不在库中,任何开关都取不回来。';
77
+ return renderShell({
78
+ title: 'cairn 记忆预览(静态)',
79
+ subtitle: `静态预览 · 生成于 ${model.generatedAt} · 模式 ${model.mode} · 只读`,
80
+ banners: [banner, blockedNote],
81
+ modelJson: safeJsonForScript(model),
82
+ });
83
+ }
84
+ //# sourceMappingURL=export.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"export.js","sourceRoot":"","sources":["../../../../src/interfaces/console/export.ts"],"names":[],"mappings":"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"}
@@ -0,0 +1,372 @@
1
+ import { CairnStore } from '../../store/open.js';
2
+ import { ContentView } from './security.js';
3
+ /**
4
+ * 只读装配层(design D1/D9)。
5
+ *
6
+ * 设计约束:这里只发 SELECT。传进来的是只读 store 时,仓储的写守卫会把任何
7
+ * 误写直接拒为 E_READONLY;这比"代码里小心一点"更可靠。
8
+ *
9
+ * 两个模式:
10
+ * - `brief`:正文按 briefChars 裁切,用于列表与工作台首屏;
11
+ * - `full`:正文完整,用于详情与静态导出。
12
+ *
13
+ * 掩码由调用方决定(`redact`):工作台默认 true,静态导出默认 false。
14
+ * 该默认值属于"传输面"策略,不属于装配层策略,所以放在参数里而不是写死。
15
+ */
16
+ export type ViewMode = 'brief' | 'full';
17
+ export interface ModelOptions {
18
+ mode?: ViewMode;
19
+ /** true 时敏感记忆与 blocked 条目的正文一律不出装配层。 */
20
+ redact?: boolean;
21
+ /** brief 模式裁切字符数,默认 240。 */
22
+ briefChars?: number;
23
+ /** 只取这些作用域(空/未给表示全部)。 */
24
+ scopeIds?: string[];
25
+ /** 记忆状态过滤。 */
26
+ statuses?: string[];
27
+ /** 记忆 kind 过滤。 */
28
+ kinds?: string[];
29
+ /** 关键词过滤(记忆正文 + 快照条目正文,走有界 LIKE,不走 FTS 以免污染只读快照语义)。 */
30
+ q?: string;
31
+ /** 是否把 import_item 明细一并装配(导出需要;工作台首屏不需要)。 */
32
+ includeItems?: boolean;
33
+ /** 明细条数上限(undefined = 不限,仅供导出使用)。 */
34
+ itemsLimit?: number;
35
+ }
36
+ export interface ScopeLayerView {
37
+ id: string;
38
+ preset: string;
39
+ scopeKind: string;
40
+ spaceId: string;
41
+ spaceName: string | null;
42
+ spaceKind: string | null;
43
+ projectId: string | null;
44
+ deviceId: string;
45
+ agentId: string;
46
+ syncPolicy: string;
47
+ readPolicy: string;
48
+ sensitivity: string;
49
+ ttlDays: number | null;
50
+ builtin: boolean;
51
+ counts: {
52
+ total: number;
53
+ byStatus: Record<string, number>;
54
+ };
55
+ }
56
+ export interface MemoryView {
57
+ id: string;
58
+ kind: string;
59
+ status: string;
60
+ authority: string;
61
+ confidence: number;
62
+ sensitivity: string;
63
+ scopeId: string;
64
+ content: ContentView;
65
+ contentHash: string;
66
+ sourceAgent: string | null;
67
+ createdBy: string;
68
+ createdAt: string;
69
+ updatedAt: string;
70
+ expiresAt: string | null;
71
+ revisionCount: number;
72
+ evidenceCount: number;
73
+ openConflicts: number;
74
+ tombstoned: boolean;
75
+ }
76
+ export interface ArchiveView {
77
+ id: string;
78
+ batchId: string;
79
+ sourceKind: string;
80
+ /** 已折叠 ~ 的来源标识(不泄漏用户名)。 */
81
+ sourceLabel: string | null;
82
+ byteSize: number;
83
+ parser: string;
84
+ status: string;
85
+ redactionState: string;
86
+ discoveredAt: string;
87
+ importedAt: string | null;
88
+ items: {
89
+ total: number;
90
+ clean: number;
91
+ blocked: number;
92
+ promoted: number;
93
+ skipped: number;
94
+ remaining: number;
95
+ };
96
+ }
97
+ export interface BatchView {
98
+ batchId: string;
99
+ label: string | null;
100
+ archiveCount: number;
101
+ total: number;
102
+ clean: number;
103
+ blocked: number;
104
+ promoted: number;
105
+ remaining: number;
106
+ lastImportedAt: string | null;
107
+ }
108
+ export interface ItemView {
109
+ id: string;
110
+ archiveId: string;
111
+ batchId: string | null;
112
+ itemIndex: number;
113
+ scanState: string;
114
+ scanFindings: string | null;
115
+ sourceRef: string | null;
116
+ content: ContentView;
117
+ /** false 表示原文在导入阶段已被物理丢弃(blocked 条目),库里只有占位符。 */
118
+ contentAvailable: boolean;
119
+ contentHash: string;
120
+ /** 已处理状态:已晋升 / 已跳过 / 仍待处理。跳过的条目可查但不计 remaining。 */
121
+ handled: 'promoted' | 'skipped' | 'pending';
122
+ }
123
+ /** 一次自动整理的摘要(来自 `policy/auto_applied` 审计,任务 4.6)。 */
124
+ export interface AutoRunView {
125
+ policyId: string;
126
+ policyHashPrefix: string | null;
127
+ at: string;
128
+ applied: number;
129
+ skipped: number;
130
+ failed: number;
131
+ planId: string | null;
132
+ approvalId: string | null;
133
+ /** 本次写入的记忆里还有几条没被遗忘。0 = 已被撤销(或全被遗忘)。 */
134
+ liveMemories: number;
135
+ /** 撤销事件的时间;null 表示没撤过。 */
136
+ revokedAt: string | null;
137
+ revokedCount: number | null;
138
+ }
139
+ /**
140
+ * 导入工作台的一行:**一条来源的一次导入**(任务 4.1)。
141
+ *
142
+ * 刻意以 archive 为行单位而不是 batch 或来源:同一份笔记重复导入会产生多个
143
+ * archive,它们各自有独立的条目计数——合成一行会把"这次又导进来 40 条"抹掉。
144
+ * 折叠展示交给 groups(任务 4.4),那只是呈现层,不能反过来改数据结构。
145
+ */
146
+ export interface ImportRowView {
147
+ id: string;
148
+ archiveId: string;
149
+ batchId: string | null;
150
+ sourceLabel: string | null;
151
+ sourceKind: string;
152
+ parser: string;
153
+ status: string;
154
+ redactionState: string;
155
+ byteSize: number;
156
+ discoveredAt: string;
157
+ importedAt: string | null;
158
+ /** 同一来源一共导入过几次(含本行)。 */
159
+ importCount: number;
160
+ /** 同一来源最近一次导入时间。 */
161
+ lastImportedAt: string | null;
162
+ /** 本行是不是该来源最近一次导入——UI 默认只展开它,其余收进 details。 */
163
+ isLatestOfSource: boolean;
164
+ items: {
165
+ total: number;
166
+ clean: number;
167
+ blocked: number;
168
+ promoted: number;
169
+ skipped: number;
170
+ remaining: number;
171
+ };
172
+ /** 该 archive 所属批次的最近一次自动整理摘要;没跑过为 null。 */
173
+ autoRun: AutoRunView | null;
174
+ }
175
+ /** 同一个来源的多次导入(任务 4.4 折叠用)。 */
176
+ export interface ImportGroupView {
177
+ key: string;
178
+ sourceLabel: string | null;
179
+ importCount: number;
180
+ lastImportedAt: string | null;
181
+ /** 行 id,按导入时间倒序,[0] 是最新一次。 */
182
+ rowIds: string[];
183
+ items: {
184
+ total: number;
185
+ clean: number;
186
+ blocked: number;
187
+ promoted: number;
188
+ skipped: number;
189
+ remaining: number;
190
+ };
191
+ }
192
+ export interface ImportRowsView {
193
+ rows: ImportRowView[];
194
+ groups: ImportGroupView[];
195
+ }
196
+ export interface ApprovalView {
197
+ id: string;
198
+ planId: string;
199
+ channel: string;
200
+ approvedBy: string;
201
+ approvedAt: string;
202
+ expiresAt: string;
203
+ revokedAt: string | null;
204
+ maxUses: number;
205
+ uses: number;
206
+ live: boolean;
207
+ }
208
+ export interface PlanView {
209
+ id: string;
210
+ status: string;
211
+ planHash: string;
212
+ planHashPrefix: string;
213
+ scopeId: string;
214
+ sourceArchiveIds: string[];
215
+ itemCount: number;
216
+ proposedBy: string;
217
+ createdAt: string;
218
+ expiresAt: string;
219
+ appliedAt: string | null;
220
+ ops: {
221
+ total: number;
222
+ add: number;
223
+ merge: number;
224
+ keepBoth: number;
225
+ skip: number;
226
+ pending: number;
227
+ applied: number;
228
+ };
229
+ approvals: ApprovalView[];
230
+ }
231
+ export interface OutboxView {
232
+ byStatus: Record<string, number>;
233
+ pending: {
234
+ id: string;
235
+ jobType: string;
236
+ entityType: string;
237
+ entityId: string;
238
+ status: string;
239
+ attempts: number;
240
+ nextAttemptAt: string | null;
241
+ }[];
242
+ }
243
+ export interface SyncView {
244
+ configured: boolean;
245
+ provider: string | null;
246
+ vaultId: string | null;
247
+ keysPresent: boolean;
248
+ lastOkAt: string | null;
249
+ /** 缺什么导致不能同步(供 UI 直接展示原因,而不是只把按钮变灰)。 */
250
+ blockers: string[];
251
+ }
252
+ export interface ConsoleCounts {
253
+ memoriesByStatus: Record<string, number>;
254
+ memoriesTotal: number;
255
+ archives: number;
256
+ items: {
257
+ total: number;
258
+ clean: number;
259
+ blocked: number;
260
+ promoted: number;
261
+ skipped: number;
262
+ remaining: number;
263
+ };
264
+ batches: number;
265
+ plansByStatus: Record<string, number>;
266
+ approvalsLive: number;
267
+ outboxByStatus: Record<string, number>;
268
+ openConflicts: number;
269
+ scopeLayers: number;
270
+ }
271
+ export interface ConsoleModel {
272
+ generatedAt: string;
273
+ home: string;
274
+ schemaVersion: number;
275
+ mode: ViewMode;
276
+ redacted: boolean;
277
+ filter: {
278
+ q: string | null;
279
+ scopeIds: string[];
280
+ statuses: string[];
281
+ kinds: string[];
282
+ };
283
+ counts: ConsoleCounts;
284
+ scopes: ScopeLayerView[];
285
+ memories: MemoryView[];
286
+ archives: ArchiveView[];
287
+ batches: BatchView[];
288
+ plans: PlanView[];
289
+ approvals: ApprovalView[];
290
+ outbox: OutboxView;
291
+ sync: SyncView;
292
+ /** 导入工作台的单表数据(任务 4.1):一条来源一次导入一行。 */
293
+ imports: ImportRowsView;
294
+ /** 仅在 includeItems 时存在。 */
295
+ items?: ItemView[];
296
+ /** 装配期发现的可读性告警(不影响数据)。 */
297
+ notes: string[];
298
+ }
299
+ export declare function buildModel(store: CairnStore, opts?: ModelOptions): ConsoleModel;
300
+ /**
301
+ * 把 archive(一次导入一条记录)、batch(一批条目)与自动整理审计合成一张表。
302
+ *
303
+ * 为什么要服务端算:`importCount` / `lastImportedAt` / `isLatestOfSource` 都是
304
+ * 跨行聚合,前端自己算就得把全部行都拉一遍再排序,且"哪次是最新"的判定会跟
305
+ * 后端各写一份。这里算完,前端只负责画。
306
+ */
307
+ export declare function buildImportRows(store: CairnStore): ImportRowsView;
308
+ /** 对外暴露:单档案条目(工作台按需展开,不一次性把 533 条正文推给浏览器)。 */
309
+ export declare function listArchiveItems(store: CairnStore, archiveId: string, opts?: {
310
+ mode?: ViewMode;
311
+ redact?: boolean;
312
+ briefChars?: number;
313
+ scanState?: 'clean' | 'blocked' | 'pending';
314
+ offset?: number;
315
+ limit?: number;
316
+ }): {
317
+ total: number;
318
+ offset: number;
319
+ limit: number;
320
+ items: ItemView[];
321
+ };
322
+ export interface MemoryDetailView {
323
+ memory: MemoryView;
324
+ scope: {
325
+ id: string;
326
+ preset: string;
327
+ syncPolicy: string;
328
+ deviceId: string;
329
+ agentId: string;
330
+ } | null;
331
+ revisions: {
332
+ id: string;
333
+ seq: number;
334
+ content: ContentView;
335
+ author: string;
336
+ reason: string | null;
337
+ createdAt: string;
338
+ deviceId: string;
339
+ }[];
340
+ evidence: {
341
+ id: string;
342
+ evidenceKind: string;
343
+ trustLevel: string;
344
+ sourceAgent: string | null;
345
+ locator: string | null;
346
+ createdAt: string;
347
+ }[];
348
+ relations: {
349
+ id: string;
350
+ fromMemoryId: string;
351
+ toMemoryId: string;
352
+ relationType: string;
353
+ }[];
354
+ conflicts: {
355
+ id: string;
356
+ revisionAId: string;
357
+ revisionBId: string;
358
+ status: string;
359
+ detectedAt: string;
360
+ }[];
361
+ tombstone: {
362
+ reason: string | null;
363
+ forgottenBy: string;
364
+ forgottenAt: string;
365
+ } | null;
366
+ }
367
+ /** 单条记忆详情(含修订史与证据)。只读;掩码策略与列表一致。 */
368
+ export declare function memoryDetail(store: CairnStore, id: string, opts?: {
369
+ mode?: ViewMode;
370
+ redact?: boolean;
371
+ briefChars?: number;
372
+ }): MemoryDetailView;