@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":"discover.js","sourceRoot":"","sources":["../../../src/onboarding/discover.ts"],"names":[],"mappings":"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"}
@@ -0,0 +1,69 @@
1
+ import { CairnStore } from '../store/open.js';
2
+ import { ImportSourceKind } from '../store/archives.js';
3
+ /**
4
+ * 快照导入(任务 4.2 / spec agent-onboarding「不可变快照与默认本地档案」):
5
+ *
6
+ * 1. 读取来源字节并计算 sha256;【源文件绝不修改】(导入后重读比对做诚实
7
+ * 的 TOCTOU 检测)。
8
+ * 2. 原始字节写入 dataDir 旁的 snapshotsDir/<sha256前16位>-<basename>,
9
+ * 已存在则不覆盖(不可变快照)。
10
+ * 3. 档案幂等:(sourceLocator = 路径+大小+mtime 稳定序列化, contentHash = 文件
11
+ * sha256) 命中即复用,零新增档案与条目(spec「重复导入同一来源」)。
12
+ * 4. markdown-generic 解析:空行分隔的块;每条记 byteOffset 与
13
+ * sourceRef `basename#item-N`(N 与 item_index 一致,0 起)。
14
+ * 5. 每条 scanText:命中秘密/注入 → scan_state='blocked',content 以占位符
15
+ * 入库(原文只存在于不可变快照文件,DB 绝不落秘密原文),scan_findings
16
+ * 只存 kind+masked 摘要;全部 clean → 'scanned_clean',有 blocked →
17
+ * 'scanned_blocked'(spec memory-governance「秘密与提示注入阻断」)。
18
+ * 6. 审计 record('import', ...) 记录 snapshot_created / snapshot_reused。
19
+ *
20
+ * 两层导入模型中的档案层:导入完成内容即本地可检索(imported_unverified、
21
+ * local_only),晋升为正式记忆是 batches.ts 的另一层,需治理计划+真实审批,
22
+ * 全程不依赖模型可用。
23
+ */
24
+ export declare const DEFAULT_MAX_ITEM_BYTES: number;
25
+ export interface ImportSourceInput {
26
+ /** 来源 Agent 类型:'claude-code' | 'cursor' | 'copilot' | 'openclaw' | 'workbuddy' | 'manual'。 */
27
+ agentKind: string;
28
+ /** 用户勾选的来源文件路径。 */
29
+ sourcePath: string;
30
+ /** 默认 'markdown-generic'。 */
31
+ parser?: string;
32
+ /** 默认新建(uuidv7)。 */
33
+ batchId?: string;
34
+ /** 默认 'markdown'。 */
35
+ sourceKind?: ImportSourceKind;
36
+ /** 默认 64KB;超长条目按行(单行再按 UTF-8 安全字节边界)再切。 */
37
+ maxItemBytes?: number;
38
+ }
39
+ export interface ImportOutcome {
40
+ /** 新建档案 id;幂等复用时为 null。 */
41
+ archiveId: string | null;
42
+ /** 幂等复用的既有档案 id;新建时为 null。 */
43
+ reusedArchiveId: string | null;
44
+ batchId: string;
45
+ /** archive 是否新建。 */
46
+ created: boolean;
47
+ /** 本次新登记条目数(重复导入为 0)。 */
48
+ itemCount: number;
49
+ /** 秘密/注入命中被阻断的条目数。 */
50
+ skippedItems: number;
51
+ /** 导入前源文件 sha256。 */
52
+ sourceHashBefore: string;
53
+ /** 导入后源文件 sha256(成功返回时必与 before 相等,不等已抛 E_IO)。 */
54
+ sourceHashAfter: string;
55
+ }
56
+ interface ParsedItem {
57
+ content: string;
58
+ byteOffset: number;
59
+ }
60
+ export declare function importSnapshot(store: CairnStore, input: ImportSourceInput): Promise<ImportOutcome>;
61
+ /**
62
+ * markdown-generic 解析:按空行(trim 后为空)分隔成块,连续非空行为一条;
63
+ * 去掉每行 Markdown 引用前缀('> ')后作为 content;byteOffset 是该条内容
64
+ * 首字节在源文件中的真实字节偏移(按 UTF-8 字节计,多字节字符安全)。
65
+ * 超过 maxItemBytes 的块再切分:优先按行边界;单行超长按 UTF-8 安全字节
66
+ * 边界硬切(绝不切断多字节字符),拼接可无损还原。
67
+ */
68
+ export declare function parseMarkdownItems(buf: Buffer, maxItemBytes: number): ParsedItem[];
69
+ export {};
@@ -0,0 +1,279 @@
1
+ import { readFile, stat, writeFile } from 'node:fs/promises';
2
+ import { basename, join, resolve } from 'node:path';
3
+ import { scanText } from '../core/secrets.js';
4
+ import { sha256Hex } from '../core/hash.js';
5
+ import { uuidv7 } from '../core/ids.js';
6
+ import { err } from '../core/errors.js';
7
+ /**
8
+ * 快照导入(任务 4.2 / spec agent-onboarding「不可变快照与默认本地档案」):
9
+ *
10
+ * 1. 读取来源字节并计算 sha256;【源文件绝不修改】(导入后重读比对做诚实
11
+ * 的 TOCTOU 检测)。
12
+ * 2. 原始字节写入 dataDir 旁的 snapshotsDir/<sha256前16位>-<basename>,
13
+ * 已存在则不覆盖(不可变快照)。
14
+ * 3. 档案幂等:(sourceLocator = 路径+大小+mtime 稳定序列化, contentHash = 文件
15
+ * sha256) 命中即复用,零新增档案与条目(spec「重复导入同一来源」)。
16
+ * 4. markdown-generic 解析:空行分隔的块;每条记 byteOffset 与
17
+ * sourceRef `basename#item-N`(N 与 item_index 一致,0 起)。
18
+ * 5. 每条 scanText:命中秘密/注入 → scan_state='blocked',content 以占位符
19
+ * 入库(原文只存在于不可变快照文件,DB 绝不落秘密原文),scan_findings
20
+ * 只存 kind+masked 摘要;全部 clean → 'scanned_clean',有 blocked →
21
+ * 'scanned_blocked'(spec memory-governance「秘密与提示注入阻断」)。
22
+ * 6. 审计 record('import', ...) 记录 snapshot_created / snapshot_reused。
23
+ *
24
+ * 两层导入模型中的档案层:导入完成内容即本地可检索(imported_unverified、
25
+ * local_only),晋升为正式记忆是 batches.ts 的另一层,需治理计划+真实审批,
26
+ * 全程不依赖模型可用。
27
+ */
28
+ export const DEFAULT_MAX_ITEM_BYTES = 64 * 1024;
29
+ /** 当前唯一实现的解析器;其他 parser 名一律 E_VALIDATION(诚实拒绝,不静默降级)。 */
30
+ const SUPPORTED_PARSERS = new Set(['markdown-generic']);
31
+ const SOURCE_KINDS = ['markdown', 'jsonl', 'agent_memory_file', 'manual_export'];
32
+ export async function importSnapshot(store, input) {
33
+ if (typeof input.agentKind !== 'string' || input.agentKind.trim().length === 0) {
34
+ throw err('E_VALIDATION', 'agentKind 不能为空');
35
+ }
36
+ const parser = input.parser ?? 'markdown-generic';
37
+ if (!SUPPORTED_PARSERS.has(parser)) {
38
+ throw err('E_VALIDATION', `暂不支持的解析器: ${parser}(当前仅 markdown-generic)`);
39
+ }
40
+ const sourceKind = input.sourceKind ?? 'markdown';
41
+ if (!SOURCE_KINDS.includes(sourceKind)) {
42
+ throw err('E_VALIDATION', `非法 sourceKind: ${String(sourceKind)}`);
43
+ }
44
+ const maxItemBytes = input.maxItemBytes ?? DEFAULT_MAX_ITEM_BYTES;
45
+ if (!Number.isInteger(maxItemBytes) || maxItemBytes < 16) {
46
+ throw err('E_VALIDATION', 'maxItemBytes 必须是不小于 16 的整数');
47
+ }
48
+ // 1. 读取源字节(不存在 → E_NOT_FOUND);只读,绝不写回源文件。
49
+ let bytes;
50
+ try {
51
+ bytes = await readFile(input.sourcePath);
52
+ }
53
+ catch (e) {
54
+ if (e.code === 'ENOENT') {
55
+ throw err('E_NOT_FOUND', `来源文件不存在: ${input.sourcePath}`);
56
+ }
57
+ throw err('E_IO', `无法读取来源文件 ${input.sourcePath}: ${e.message}`);
58
+ }
59
+ const sourceHashBefore = sha256Hex(bytes);
60
+ let st;
61
+ try {
62
+ st = await stat(input.sourcePath);
63
+ }
64
+ catch (e) {
65
+ throw err('E_IO', `无法获取来源文件元数据 ${input.sourcePath}: ${e.message}`);
66
+ }
67
+ // sourceLocator:路径 + 大小 + mtime 的稳定序列化(resolve 消除相对路径差异)。
68
+ const sourceLocator = JSON.stringify({
69
+ v: 1,
70
+ path: resolve(input.sourcePath),
71
+ size: bytes.byteLength,
72
+ mtimeMs: st.mtimeMs,
73
+ });
74
+ // 2. 解析先行:空文件/无条目在任何写入发生前即 E_VALIDATION(零副作用)。
75
+ const items = parseMarkdownItems(bytes, maxItemBytes);
76
+ if (items.length === 0) {
77
+ throw err('E_VALIDATION', '来源文件没有可导入的条目(空文件或仅空白行)');
78
+ }
79
+ // 3. 不可变快照:wx 标志写入,已存在则不覆盖。
80
+ const base = basename(input.sourcePath);
81
+ const snapshotPath = await ensureSnapshot(store.paths.snapshotsDir, sourceHashBefore, base, bytes);
82
+ const batchId = input.batchId ?? uuidv7();
83
+ // 4-6. 档案登记 + 条目扫描 + 审计,全部包在单事务里保证原子性。
84
+ const result = store.db.transaction(() => {
85
+ const { archive, created } = store.archives.createArchive({
86
+ batchId,
87
+ sourceKind,
88
+ sourceLocator,
89
+ sourceLabel: `${input.agentKind}:${base}`,
90
+ byteSize: bytes.byteLength,
91
+ contentHash: sourceHashBefore,
92
+ snapshotPath,
93
+ parser,
94
+ });
95
+ if (!created) {
96
+ // 幂等复用:零新增档案与条目;已入库条目不重扫、不换批。
97
+ store.audit.record('import', 'snapshot_reused', { type: 'archive', id: archive.id }, {
98
+ sourceHash: sourceHashBefore,
99
+ itemCount: 0,
100
+ blockedCount: 0,
101
+ agentKind: input.agentKind,
102
+ });
103
+ return { archive, created, itemCount: 0, skippedItems: 0 };
104
+ }
105
+ let blockedCount = 0;
106
+ for (let index = 0; index < items.length; index++) {
107
+ const it = items[index];
108
+ const scan = scanText(it.content);
109
+ let content = it.content;
110
+ let scanFindings;
111
+ if (!scan.clean) {
112
+ blockedCount++;
113
+ // 阻断条目的 content 用占位符入库:原文只存在于不可变快照文件,
114
+ // DB(含审计与任何 dump)绝不落秘密/注入原文;仅 kind+masked 摘要。
115
+ content = blockedPlaceholder(scan);
116
+ scanFindings = JSON.stringify({
117
+ secrets: scan.findings.map((f) => ({ kind: f.kind, masked: f.masked })),
118
+ injections: scan.injectionFindings.map((f) => ({ kind: f.kind, rule: f.rule })),
119
+ });
120
+ }
121
+ store.archives.addItem({
122
+ archiveId: archive.id,
123
+ itemIndex: index,
124
+ content,
125
+ byteOffset: it.byteOffset,
126
+ sourceRef: `${base}#item-${index}`,
127
+ scanState: scan.clean ? 'clean' : 'blocked',
128
+ scanFindings,
129
+ batchId,
130
+ });
131
+ }
132
+ store.archives.setRedactionState(archive.id, blockedCount > 0 ? 'scanned_blocked' : 'scanned_clean');
133
+ store.archives.setStatus(archive.id, 'indexed');
134
+ store.audit.record('import', 'snapshot_created', { type: 'archive', id: archive.id }, {
135
+ sourceHash: sourceHashBefore,
136
+ itemCount: items.length,
137
+ blockedCount,
138
+ agentKind: input.agentKind,
139
+ });
140
+ return { archive, created, itemCount: items.length, skippedItems: blockedCount };
141
+ });
142
+ // 7. TOCTOU 诚实检测:导入后重读源文件,字节变化即 E_IO(导入本身仍基于
143
+ // 读取时点的快照成立,但必须把不一致大声暴露,绝不静默吞掉)。
144
+ const sourceHashAfter = await rehashSource(input.sourcePath, sourceHashBefore);
145
+ return {
146
+ archiveId: result.created ? result.archive.id : null,
147
+ reusedArchiveId: result.created ? null : result.archive.id,
148
+ batchId: result.created ? batchId : (input.batchId ?? result.archive.batchId),
149
+ created: result.created,
150
+ itemCount: result.itemCount,
151
+ skippedItems: result.skippedItems,
152
+ sourceHashBefore,
153
+ sourceHashAfter,
154
+ };
155
+ }
156
+ /** 不可变快照:写入 snapshotsDir/<hash前16位>-<basename>;EEXIST 视为快照已存在,不覆盖。 */
157
+ async function ensureSnapshot(snapshotsDir, contentHash, base, bytes) {
158
+ const snapshotPath = join(snapshotsDir, `${contentHash.slice(0, 16)}-${base}`);
159
+ try {
160
+ await writeFile(snapshotPath, bytes, { flag: 'wx' });
161
+ }
162
+ catch (e) {
163
+ if (e.code !== 'EEXIST') {
164
+ throw err('E_IO', `无法写入不可变快照 ${snapshotPath}: ${e.message}`);
165
+ }
166
+ // 已存在:不可变快照语义,保持原字节不动。
167
+ }
168
+ return snapshotPath;
169
+ }
170
+ async function rehashSource(sourcePath, before) {
171
+ let after;
172
+ try {
173
+ after = await readFile(sourcePath);
174
+ }
175
+ catch (e) {
176
+ throw err('E_IO', '导入完成后无法重新读取源文件(TOCTOU 检测失败,来源可能已被移动或删除)', {
177
+ reason: e.message,
178
+ });
179
+ }
180
+ const afterHash = sha256Hex(after);
181
+ if (afterHash !== before) {
182
+ throw err('E_IO', '导入期间源文件字节发生变化:本次导入基于读取时点完成,请核对来源后重试', {
183
+ sourceHashBefore: before,
184
+ sourceHashAfter: afterHash,
185
+ });
186
+ }
187
+ return afterHash;
188
+ }
189
+ /** blocked 条目入库占位符:只含 kind/rule 名,不含任何原文片段。 */
190
+ function blockedPlaceholder(scan) {
191
+ const kinds = [...scan.findings.map((f) => f.kind), ...scan.injectionFindings.map((f) => f.rule)];
192
+ return `[blocked:${kinds.join(',')}]`;
193
+ }
194
+ /**
195
+ * markdown-generic 解析:按空行(trim 后为空)分隔成块,连续非空行为一条;
196
+ * 去掉每行 Markdown 引用前缀('> ')后作为 content;byteOffset 是该条内容
197
+ * 首字节在源文件中的真实字节偏移(按 UTF-8 字节计,多字节字符安全)。
198
+ * 超过 maxItemBytes 的块再切分:优先按行边界;单行超长按 UTF-8 安全字节
199
+ * 边界硬切(绝不切断多字节字符),拼接可无损还原。
200
+ */
201
+ export function parseMarkdownItems(buf, maxItemBytes) {
202
+ const text = buf.toString('utf8');
203
+ const lines = [];
204
+ let byteStart = 0;
205
+ for (const raw of text.split('\n')) {
206
+ const line = raw.endsWith('\r') ? raw.slice(0, -1) : raw;
207
+ lines.push({ text: line, byteStart });
208
+ byteStart += Buffer.byteLength(raw, 'utf8') + 1; // +1 为换行符本身
209
+ }
210
+ const out = [];
211
+ let block = [];
212
+ const flushBlock = () => {
213
+ if (block.length > 0) {
214
+ out.push(...emitChunked(block, maxItemBytes));
215
+ block = [];
216
+ }
217
+ };
218
+ for (const line of lines) {
219
+ if (line.text.trim().length === 0)
220
+ flushBlock();
221
+ else
222
+ block.push(line);
223
+ }
224
+ flushBlock();
225
+ // 纯引用符号等剥完前缀为空白的块不构成条目。
226
+ return out.filter((it) => it.content.trim().length > 0);
227
+ }
228
+ function emitChunked(block, maxItemBytes) {
229
+ const stripped = block.map((l) => {
230
+ const m = /^> ?/.exec(l.text);
231
+ const prefixBytes = m ? Buffer.byteLength(m[0], 'utf8') : 0;
232
+ return { text: m ? l.text.slice(m[0].length) : l.text, byteStart: l.byteStart + prefixBytes };
233
+ });
234
+ const full = stripped.map((l) => l.text).join('\n');
235
+ if (Buffer.byteLength(full, 'utf8') <= maxItemBytes) {
236
+ return [{ content: full, byteOffset: stripped[0].byteStart }];
237
+ }
238
+ const out = [];
239
+ let cur = null;
240
+ const flush = () => {
241
+ if (cur == null)
242
+ return;
243
+ out.push({ content: cur.parts.join('\n'), byteOffset: cur.start });
244
+ cur = null;
245
+ };
246
+ for (const line of stripped) {
247
+ const lineBytes = Buffer.byteLength(line.text, 'utf8');
248
+ if (lineBytes > maxItemBytes) {
249
+ // 单行超长:按 UTF-8 安全字节边界硬切(回退到字符起始字节)。
250
+ flush();
251
+ const lineBuf = Buffer.from(line.text, 'utf8');
252
+ let off = 0;
253
+ while (off < lineBuf.length) {
254
+ let end = Math.min(off + maxItemBytes, lineBuf.length);
255
+ if (end < lineBuf.length) {
256
+ while (end > off) {
257
+ const b = lineBuf[end];
258
+ if (b !== undefined && (b & 0xc0) === 0x80)
259
+ end--;
260
+ else
261
+ break;
262
+ }
263
+ }
264
+ out.push({ content: lineBuf.subarray(off, end).toString('utf8'), byteOffset: line.byteStart + off });
265
+ off = end;
266
+ }
267
+ continue;
268
+ }
269
+ if (cur != null && cur.size + 1 + lineBytes > maxItemBytes)
270
+ flush();
271
+ if (cur == null)
272
+ cur = { parts: [], start: line.byteStart, size: 0 };
273
+ cur.parts.push(line.text);
274
+ cur.size += (cur.parts.length > 1 ? 1 : 0) + lineBytes; // 行间 '\n' 占 1 字节
275
+ }
276
+ flush();
277
+ return out;
278
+ }
279
+ //# sourceMappingURL=import.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"import.js","sourceRoot":"","sources":["../../../src/onboarding/import.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,IAAI,EAAE,SAAS,EAAE,MAAM,kBAAkB,CAAC;AAC7D,OAAO,EAAE,QAAQ,EAAE,IAAI,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAGpD,OAAO,EAAE,QAAQ,EAAE,MAAM,oBAAoB,CAAC;AAE9C,OAAO,EAAE,SAAS,EAAE,MAAM,iBAAiB,CAAC;AAC5C,OAAO,EAAE,MAAM,EAAE,MAAM,gBAAgB,CAAC;AACxC,OAAO,EAAE,GAAG,EAAE,MAAM,mBAAmB,CAAC;AAExC;;;;;;;;;;;;;;;;;;;;GAoBG;AAEH,MAAM,CAAC,MAAM,sBAAsB,GAAG,EAAE,GAAG,IAAI,CAAC;AAEhD,yDAAyD;AACzD,MAAM,iBAAiB,GAAwB,IAAI,GAAG,CAAC,CAAC,kBAAkB,CAAC,CAAC,CAAC;AAE7E,MAAM,YAAY,GAAgC,CAAC,UAAU,EAAE,OAAO,EAAE,mBAAmB,EAAE,eAAe,CAAC,CAAC;AA8C9G,MAAM,CAAC,KAAK,UAAU,cAAc,CAAC,KAAiB,EAAE,KAAwB;IAC9E,IAAI,OAAO,KAAK,CAAC,SAAS,KAAK,QAAQ,IAAI,KAAK,CAAC,SAAS,CAAC,IAAI,EAAE,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;QAC/E,MAAM,GAAG,CAAC,cAAc,EAAE,gBAAgB,CAAC,CAAC;IAC9C,CAAC;IACD,MAAM,MAAM,GAAG,KAAK,CAAC,MAAM,IAAI,kBAAkB,CAAC;IAClD,IAAI,CAAC,iBAAiB,CAAC,GAAG,CAAC,MAAM,CAAC,EAAE,CAAC;QACnC,MAAM,GAAG,CAAC,cAAc,EAAE,aAAa,MAAM,wBAAwB,CAAC,CAAC;IACzE,CAAC;IACD,MAAM,UAAU,GAAqB,KAAK,CAAC,UAAU,IAAI,UAAU,CAAC;IACpE,IAAI,CAAC,YAAY,CAAC,QAAQ,CAAC,UAAU,CAAC,EAAE,CAAC;QACvC,MAAM,GAAG,CAAC,cAAc,EAAE,kBAAkB,MAAM,CAAC,UAAU,CAAC,EAAE,CAAC,CAAC;IACpE,CAAC;IACD,MAAM,YAAY,GAAG,KAAK,CAAC,YAAY,IAAI,sBAAsB,CAAC;IAClE,IAAI,CAAC,MAAM,CAAC,SAAS,CAAC,YAAY,CAAC,IAAI,YAAY,GAAG,EAAE,EAAE,CAAC;QACzD,MAAM,GAAG,CAAC,cAAc,EAAE,4BAA4B,CAAC,CAAC;IAC1D,CAAC;IAED,0CAA0C;IAC1C,IAAI,KAAa,CAAC;IAClB,IAAI,CAAC;QACH,KAAK,GAAG,MAAM,QAAQ,CAAC,KAAK,CAAC,UAAU,CAAC,CAAC;IAC3C,CAAC;IAAC,OAAO,CAAC,EAAE,CAAC;QACX,IAAK,CAA2B,CAAC,IAAI,KAAK,QAAQ,EAAE,CAAC;YACnD,MAAM,GAAG,CAAC,aAAa,EAAE,YAAY,KAAK,CAAC,UAAU,EAAE,CAAC,CAAC;QAC3D,CAAC;QACD,MAAM,GAAG,CAAC,MAAM,EAAE,YAAY,KAAK,CAAC,UAAU,KAAM,CAAW,CAAC,OAAO,EAAE,CAAC,CAAC;IAC7E,CAAC;IACD,MAAM,gBAAgB,GAAG,SAAS,CAAC,KAAK,CAAC,CAAC;IAE1C,IAAI,EAAoC,CAAC;IACzC,IAAI,CAAC;QACH,EAAE,GAAG,MAAM,IAAI,CAAC,KAAK,CAAC,UAAU,CAAC,CAAC;IACpC,CAAC;IAAC,OAAO,CAAC,EAAE,CAAC;QACX,MAAM,GAAG,CAAC,MAAM,EAAE,eAAe,KAAK,CAAC,UAAU,KAAM,CAAW,CAAC,OAAO,EAAE,CAAC,CAAC;IAChF,CAAC;IACD,0DAA0D;IAC1D,MAAM,aAAa,GAAG,IAAI,CAAC,SAAS,CAAC;QACnC,CAAC,EAAE,CAAC;QACJ,IAAI,EAAE,OAAO,CAAC,KAAK,CAAC,UAAU,CAAC;QAC/B,IAAI,EAAE,KAAK,CAAC,UAAU;QACtB,OAAO,EAAE,EAAE,CAAC,OAAO;KACpB,CAAC,CAAC;IAEH,+CAA+C;IAC/C,MAAM,KAAK,GAAG,kBAAkB,CAAC,KAAK,EAAE,YAAY,CAAC,CAAC;IACtD,IAAI,KAAK,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;QACvB,MAAM,GAAG,CAAC,cAAc,EAAE,wBAAwB,CAAC,CAAC;IACtD,CAAC;IAED,4BAA4B;IAC5B,MAAM,IAAI,GAAG,QAAQ,CAAC,KAAK,CAAC,UAAU,CAAC,CAAC;IACxC,MAAM,YAAY,GAAG,MAAM,cAAc,CAAC,KAAK,CAAC,KAAK,CAAC,YAAY,EAAE,gBAAgB,EAAE,IAAI,EAAE,KAAK,CAAC,CAAC;IAEnG,MAAM,OAAO,GAAG,KAAK,CAAC,OAAO,IAAI,MAAM,EAAE,CAAC;IAE1C,uCAAuC;IACvC,MAAM,MAAM,GAAG,KAAK,CAAC,EAAE,CAAC,WAAW,CAAC,GAAG,EAAE;QACvC,MAAM,EAAE,OAAO,EAAE,OAAO,EAAE,GAAG,KAAK,CAAC,QAAQ,CAAC,aAAa,CAAC;YACxD,OAAO;YACP,UAAU;YACV,aAAa;YACb,WAAW,EAAE,GAAG,KAAK,CAAC,SAAS,IAAI,IAAI,EAAE;YACzC,QAAQ,EAAE,KAAK,CAAC,UAAU;YAC1B,WAAW,EAAE,gBAAgB;YAC7B,YAAY;YACZ,MAAM;SACP,CAAC,CAAC;QAEH,IAAI,CAAC,OAAO,EAAE,CAAC;YACb,8BAA8B;YAC9B,KAAK,CAAC,KAAK,CAAC,MAAM,CAAC,QAAQ,EAAE,iBAAiB,EAAE,EAAE,IAAI,EAAE,SAAS,EAAE,EAAE,EAAE,OAAO,CAAC,EAAE,EAAE,EAAE;gBACnF,UAAU,EAAE,gBAAgB;gBAC5B,SAAS,EAAE,CAAC;gBACZ,YAAY,EAAE,CAAC;gBACf,SAAS,EAAE,KAAK,CAAC,SAAS;aAC3B,CAAC,CAAC;YACH,OAAO,EAAE,OAAO,EAAE,OAAO,EAAE,SAAS,EAAE,CAAC,EAAE,YAAY,EAAE,CAAC,EAAE,CAAC;QAC7D,CAAC;QAED,IAAI,YAAY,GAAG,CAAC,CAAC;QACrB,KAAK,IAAI,KAAK,GAAG,CAAC,EAAE,KAAK,GAAG,KAAK,CAAC,MAAM,EAAE,KAAK,EAAE,EAAE,CAAC;YAClD,MAAM,EAAE,GAAG,KAAK,CAAC,KAAK,CAAe,CAAC;YACtC,MAAM,IAAI,GAAG,QAAQ,CAAC,EAAE,CAAC,OAAO,CAAC,CAAC;YAClC,IAAI,OAAO,GAAG,EAAE,CAAC,OAAO,CAAC;YACzB,IAAI,YAAgC,CAAC;YACrC,IAAI,CAAC,IAAI,CAAC,KAAK,EAAE,CAAC;gBAChB,YAAY,EAAE,CAAC;gBACf,sCAAsC;gBACtC,8CAA8C;gBAC9C,OAAO,GAAG,kBAAkB,CAAC,IAAI,CAAC,CAAC;gBACnC,YAAY,GAAG,IAAI,CAAC,SAAS,CAAC;oBAC5B,OAAO,EAAE,IAAI,CAAC,QAAQ,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,EAAE,IAAI,EAAE,CAAC,CAAC,IAAI,EAAE,MAAM,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,CAAC;oBACvE,UAAU,EAAE,IAAI,CAAC,iBAAiB,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,EAAE,IAAI,EAAE,CAAC,CAAC,IAAI,EAAE,IAAI,EAAE,CAAC,CAAC,IAAI,EAAE,CAAC,CAAC;iBAChF,CAAC,CAAC;YACL,CAAC;YACD,KAAK,CAAC,QAAQ,CAAC,OAAO,CAAC;gBACrB,SAAS,EAAE,OAAO,CAAC,EAAE;gBACrB,SAAS,EAAE,KAAK;gBAChB,OAAO;gBACP,UAAU,EAAE,EAAE,CAAC,UAAU;gBACzB,SAAS,EAAE,GAAG,IAAI,SAAS,KAAK,EAAE;gBAClC,SAAS,EAAE,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,SAAS;gBAC3C,YAAY;gBACZ,OAAO;aACR,CAAC,CAAC;QACL,CAAC;QACD,KAAK,CAAC,QAAQ,CAAC,iBAAiB,CAAC,OAAO,CAAC,EAAE,EAAE,YAAY,GAAG,CAAC,CAAC,CAAC,CAAC,iBAAiB,CAAC,CAAC,CAAC,eAAe,CAAC,CAAC;QACrG,KAAK,CAAC,QAAQ,CAAC,SAAS,CAAC,OAAO,CAAC,EAAE,EAAE,SAAS,CAAC,CAAC;QAChD,KAAK,CAAC,KAAK,CAAC,MAAM,CAAC,QAAQ,EAAE,kBAAkB,EAAE,EAAE,IAAI,EAAE,SAAS,EAAE,EAAE,EAAE,OAAO,CAAC,EAAE,EAAE,EAAE;YACpF,UAAU,EAAE,gBAAgB;YAC5B,SAAS,EAAE,KAAK,CAAC,MAAM;YACvB,YAAY;YACZ,SAAS,EAAE,KAAK,CAAC,SAAS;SAC3B,CAAC,CAAC;QACH,OAAO,EAAE,OAAO,EAAE,OAAO,EAAE,SAAS,EAAE,KAAK,CAAC,MAAM,EAAE,YAAY,EAAE,YAAY,EAAE,CAAC;IACnF,CAAC,CAAC,CAAC;IAEH,6CAA6C;IAC7C,oCAAoC;IACpC,MAAM,eAAe,GAAG,MAAM,YAAY,CAAC,KAAK,CAAC,UAAU,EAAE,gBAAgB,CAAC,CAAC;IAE/E,OAAO;QACL,SAAS,EAAE,MAAM,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,OAAO,CAAC,EAAE,CAAC,CAAC,CAAC,IAAI;QACpD,eAAe,EAAE,MAAM,CAAC,OAAO,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,MAAM,CAAC,OAAO,CAAC,EAAE;QAC1D,OAAO,EAAE,MAAM,CAAC,OAAO,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,IAAI,MAAM,CAAC,OAAO,CAAC,OAAO,CAAC;QAC7E,OAAO,EAAE,MAAM,CAAC,OAAO;QACvB,SAAS,EAAE,MAAM,CAAC,SAAS;QAC3B,YAAY,EAAE,MAAM,CAAC,YAAY;QACjC,gBAAgB;QAChB,eAAe;KAChB,CAAC;AACJ,CAAC;AAED,sEAAsE;AACtE,KAAK,UAAU,cAAc,CAAC,YAAoB,EAAE,WAAmB,EAAE,IAAY,EAAE,KAAa;IAClG,MAAM,YAAY,GAAG,IAAI,CAAC,YAAY,EAAE,GAAG,WAAW,CAAC,KAAK,CAAC,CAAC,EAAE,EAAE,CAAC,IAAI,IAAI,EAAE,CAAC,CAAC;IAC/E,IAAI,CAAC;QACH,MAAM,SAAS,CAAC,YAAY,EAAE,KAAK,EAAE,EAAE,IAAI,EAAE,IAAI,EAAE,CAAC,CAAC;IACvD,CAAC;IAAC,OAAO,CAAC,EAAE,CAAC;QACX,IAAK,CAA2B,CAAC,IAAI,KAAK,QAAQ,EAAE,CAAC;YACnD,MAAM,GAAG,CAAC,MAAM,EAAE,aAAa,YAAY,KAAM,CAAW,CAAC,OAAO,EAAE,CAAC,CAAC;QAC1E,CAAC;QACD,uBAAuB;IACzB,CAAC;IACD,OAAO,YAAY,CAAC;AACtB,CAAC;AAED,KAAK,UAAU,YAAY,CAAC,UAAkB,EAAE,MAAc;IAC5D,IAAI,KAAa,CAAC;IAClB,IAAI,CAAC;QACH,KAAK,GAAG,MAAM,QAAQ,CAAC,UAAU,CAAC,CAAC;IACrC,CAAC;IAAC,OAAO,CAAC,EAAE,CAAC;QACX,MAAM,GAAG,CAAC,MAAM,EAAE,yCAAyC,EAAE;YAC3D,MAAM,EAAG,CAAW,CAAC,OAAO;SAC7B,CAAC,CAAC;IACL,CAAC;IACD,MAAM,SAAS,GAAG,SAAS,CAAC,KAAK,CAAC,CAAC;IACnC,IAAI,SAAS,KAAK,MAAM,EAAE,CAAC;QACzB,MAAM,GAAG,CAAC,MAAM,EAAE,qCAAqC,EAAE;YACvD,gBAAgB,EAAE,MAAM;YACxB,eAAe,EAAE,SAAS;SAC3B,CAAC,CAAC;IACL,CAAC;IACD,OAAO,SAAS,CAAC;AACnB,CAAC;AAED,+CAA+C;AAC/C,SAAS,kBAAkB,CAAC,IAAsB;IAChD,MAAM,KAAK,GAAG,CAAC,GAAG,IAAI,CAAC,QAAQ,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC,EAAE,GAAG,IAAI,CAAC,iBAAiB,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC;IAClG,OAAO,YAAY,KAAK,CAAC,IAAI,CAAC,GAAG,CAAC,GAAG,CAAC;AACxC,CAAC;AAED;;;;;;GAMG;AACH,MAAM,UAAU,kBAAkB,CAAC,GAAW,EAAE,YAAoB;IAClE,MAAM,IAAI,GAAG,GAAG,CAAC,QAAQ,CAAC,MAAM,CAAC,CAAC;IAClC,MAAM,KAAK,GAAc,EAAE,CAAC;IAC5B,IAAI,SAAS,GAAG,CAAC,CAAC;IAClB,KAAK,MAAM,GAAG,IAAI,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,EAAE,CAAC;QACnC,MAAM,IAAI,GAAG,GAAG,CAAC,QAAQ,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,KAAK,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC;QACzD,KAAK,CAAC,IAAI,CAAC,EAAE,IAAI,EAAE,IAAI,EAAE,SAAS,EAAE,CAAC,CAAC;QACtC,SAAS,IAAI,MAAM,CAAC,UAAU,CAAC,GAAG,EAAE,MAAM,CAAC,GAAG,CAAC,CAAC,CAAC,YAAY;IAC/D,CAAC;IAED,MAAM,GAAG,GAAiB,EAAE,CAAC;IAC7B,IAAI,KAAK,GAAc,EAAE,CAAC;IAC1B,MAAM,UAAU,GAAG,GAAS,EAAE;QAC5B,IAAI,KAAK,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;YACrB,GAAG,CAAC,IAAI,CAAC,GAAG,WAAW,CAAC,KAAK,EAAE,YAAY,CAAC,CAAC,CAAC;YAC9C,KAAK,GAAG,EAAE,CAAC;QACb,CAAC;IACH,CAAC,CAAC;IACF,KAAK,MAAM,IAAI,IAAI,KAAK,EAAE,CAAC;QACzB,IAAI,IAAI,CAAC,IAAI,CAAC,IAAI,EAAE,CAAC,MAAM,KAAK,CAAC;YAAE,UAAU,EAAE,CAAC;;YAC3C,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;IACxB,CAAC;IACD,UAAU,EAAE,CAAC;IACb,wBAAwB;IACxB,OAAO,GAAG,CAAC,MAAM,CAAC,CAAC,EAAE,EAAE,EAAE,CAAC,EAAE,CAAC,OAAO,CAAC,IAAI,EAAE,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC;AAC1D,CAAC;AAED,SAAS,WAAW,CAAC,KAAgB,EAAE,YAAoB;IACzD,MAAM,QAAQ,GAAc,KAAK,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE;QAC1C,MAAM,CAAC,GAAG,MAAM,CAAC,IAAI,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC;QAC9B,MAAM,WAAW,GAAG,CAAC,CAAC,CAAC,CAAC,MAAM,CAAC,UAAU,CAAC,CAAC,CAAC,CAAC,CAAC,EAAE,MAAM,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC;QAC5D,OAAO,EAAE,IAAI,EAAE,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,IAAI,EAAE,SAAS,EAAE,CAAC,CAAC,SAAS,GAAG,WAAW,EAAE,CAAC;IAChG,CAAC,CAAC,CAAC;IAEH,MAAM,IAAI,GAAG,QAAQ,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;IACpD,IAAI,MAAM,CAAC,UAAU,CAAC,IAAI,EAAE,MAAM,CAAC,IAAI,YAAY,EAAE,CAAC;QACpD,OAAO,CAAC,EAAE,OAAO,EAAE,IAAI,EAAE,UAAU,EAAE,QAAQ,CAAC,CAAC,CAAE,CAAC,SAAS,EAAE,CAAC,CAAC;IACjE,CAAC;IAED,MAAM,GAAG,GAAiB,EAAE,CAAC;IAC7B,IAAI,GAAG,GAA4D,IAAI,CAAC;IACxE,MAAM,KAAK,GAAG,GAAS,EAAE;QACvB,IAAI,GAAG,IAAI,IAAI;YAAE,OAAO;QACxB,GAAG,CAAC,IAAI,CAAC,EAAE,OAAO,EAAE,GAAG,CAAC,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,UAAU,EAAE,GAAG,CAAC,KAAK,EAAE,CAAC,CAAC;QACnE,GAAG,GAAG,IAAI,CAAC;IACb,CAAC,CAAC;IACF,KAAK,MAAM,IAAI,IAAI,QAAQ,EAAE,CAAC;QAC5B,MAAM,SAAS,GAAG,MAAM,CAAC,UAAU,CAAC,IAAI,CAAC,IAAI,EAAE,MAAM,CAAC,CAAC;QACvD,IAAI,SAAS,GAAG,YAAY,EAAE,CAAC;YAC7B,oCAAoC;YACpC,KAAK,EAAE,CAAC;YACR,MAAM,OAAO,GAAG,MAAM,CAAC,IAAI,CAAC,IAAI,CAAC,IAAI,EAAE,MAAM,CAAC,CAAC;YAC/C,IAAI,GAAG,GAAG,CAAC,CAAC;YACZ,OAAO,GAAG,GAAG,OAAO,CAAC,MAAM,EAAE,CAAC;gBAC5B,IAAI,GAAG,GAAG,IAAI,CAAC,GAAG,CAAC,GAAG,GAAG,YAAY,EAAE,OAAO,CAAC,MAAM,CAAC,CAAC;gBACvD,IAAI,GAAG,GAAG,OAAO,CAAC,MAAM,EAAE,CAAC;oBACzB,OAAO,GAAG,GAAG,GAAG,EAAE,CAAC;wBACjB,MAAM,CAAC,GAAG,OAAO,CAAC,GAAG,CAAC,CAAC;wBACvB,IAAI,CAAC,KAAK,SAAS,IAAI,CAAC,CAAC,GAAG,IAAI,CAAC,KAAK,IAAI;4BAAE,GAAG,EAAE,CAAC;;4BAC7C,MAAM;oBACb,CAAC;gBACH,CAAC;gBACD,GAAG,CAAC,IAAI,CAAC,EAAE,OAAO,EAAE,OAAO,CAAC,QAAQ,CAAC,GAAG,EAAE,GAAG,CAAC,CAAC,QAAQ,CAAC,MAAM,CAAC,EAAE,UAAU,EAAE,IAAI,CAAC,SAAS,GAAG,GAAG,EAAE,CAAC,CAAC;gBACrG,GAAG,GAAG,GAAG,CAAC;YACZ,CAAC;YACD,SAAS;QACX,CAAC;QACD,IAAI,GAAG,IAAI,IAAI,IAAI,GAAG,CAAC,IAAI,GAAG,CAAC,GAAG,SAAS,GAAG,YAAY;YAAE,KAAK,EAAE,CAAC;QACpE,IAAI,GAAG,IAAI,IAAI;YAAE,GAAG,GAAG,EAAE,KAAK,EAAE,EAAE,EAAE,KAAK,EAAE,IAAI,CAAC,SAAS,EAAE,IAAI,EAAE,CAAC,EAAE,CAAC;QACrE,GAAG,CAAC,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;QAC1B,GAAG,CAAC,IAAI,IAAI,CAAC,GAAG,CAAC,KAAK,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,GAAG,SAAS,CAAC,CAAC,iBAAiB;IAC3E,CAAC;IACD,KAAK,EAAE,CAAC;IACR,OAAO,GAAG,CAAC;AACb,CAAC"}
@@ -0,0 +1,24 @@
1
+ /**
2
+ * Cairn 首次初始化(onboarding)公共入口。
3
+ *
4
+ * 两层导入模型(spec agent-onboarding):
5
+ *
6
+ * 1. 档案层 —— importSnapshot():授权后创建带来源哈希的不可变快照并登记
7
+ * 条目,导入完成内容即本地可检索(imported_unverified + local_only)。
8
+ * 全程确定性代码,不依赖任何模型;模型不可用或整理任务中断时,用户仍可
9
+ * 检索、导出原始档案,未验证状态保持清晰。
10
+ *
11
+ * 2. 晋升层 —— batches.ts:当前 Agent 按批次分块(nextBatchChunk 的持久化
12
+ * 游标)读取 clean 且未晋升的条目生成治理建议,经治理计划 + 真实审批后
13
+ * 才晋升为正式记忆(markItemPromoted)。会话中断后可在新会话继续未完成
14
+ * 批次,不重复已应用操作,也不扩大原授权范围。晋升状态由审计事件承载
15
+ * (审计即状态,schema 冻结不加列)。
16
+ *
17
+ * 秘密与注入阻断(spec memory-governance):命中扫描的条目 scan_state='blocked',
18
+ * 以占位符入库、原文仅存于不可变快照文件,永不进入批次、日志或上行内容。
19
+ */
20
+ export { importSnapshot, parseMarkdownItems, DEFAULT_MAX_ITEM_BYTES } from './import.js';
21
+ export type { ImportSourceInput, ImportOutcome } from './import.js';
22
+ export { assignBatch, batchProgress, nextBatchChunk, markItemPromoted, markItemSkipped, listSkippedItems, } from './batches.js';
23
+ export type { SkipBasis, SkippedItem } from './batches.js';
24
+ export type { BatchProgress, BatchChunkItem } from './batches.js';
@@ -0,0 +1,22 @@
1
+ /**
2
+ * Cairn 首次初始化(onboarding)公共入口。
3
+ *
4
+ * 两层导入模型(spec agent-onboarding):
5
+ *
6
+ * 1. 档案层 —— importSnapshot():授权后创建带来源哈希的不可变快照并登记
7
+ * 条目,导入完成内容即本地可检索(imported_unverified + local_only)。
8
+ * 全程确定性代码,不依赖任何模型;模型不可用或整理任务中断时,用户仍可
9
+ * 检索、导出原始档案,未验证状态保持清晰。
10
+ *
11
+ * 2. 晋升层 —— batches.ts:当前 Agent 按批次分块(nextBatchChunk 的持久化
12
+ * 游标)读取 clean 且未晋升的条目生成治理建议,经治理计划 + 真实审批后
13
+ * 才晋升为正式记忆(markItemPromoted)。会话中断后可在新会话继续未完成
14
+ * 批次,不重复已应用操作,也不扩大原授权范围。晋升状态由审计事件承载
15
+ * (审计即状态,schema 冻结不加列)。
16
+ *
17
+ * 秘密与注入阻断(spec memory-governance):命中扫描的条目 scan_state='blocked',
18
+ * 以占位符入库、原文仅存于不可变快照文件,永不进入批次、日志或上行内容。
19
+ */
20
+ export { importSnapshot, parseMarkdownItems, DEFAULT_MAX_ITEM_BYTES } from './import.js';
21
+ export { assignBatch, batchProgress, nextBatchChunk, markItemPromoted, markItemSkipped, listSkippedItems, } from './batches.js';
22
+ //# sourceMappingURL=index.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/onboarding/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;GAkBG;AAEH,OAAO,EAAE,cAAc,EAAE,kBAAkB,EAAE,sBAAsB,EAAE,MAAM,aAAa,CAAC;AAEzF,OAAO,EACL,WAAW,EACX,aAAa,EACb,cAAc,EACd,gBAAgB,EAChB,eAAe,EACf,gBAAgB,GACjB,MAAM,cAAc,CAAC"}
@@ -0,0 +1,50 @@
1
+ import type { DuplicateHit } from '../governance/dedup.js';
2
+ /**
3
+ * 写入时判断(design D6 / D10):判断是**建议**,不是授权。
4
+ *
5
+ * 它只回答"这条值不值得记",不回答"允许不允许记"。后者一律由写入参数、作用域解析与
6
+ * 策略白名单决定。因此这里**没有**任何能改敏感度、改作用域、或构成审批凭证的字段——
7
+ * 不是没实现,是不允许存在。
8
+ */
9
+ export declare const JUDGEMENT_CONFIDENCES: readonly ["high", "medium", "low"];
10
+ export type JudgementConfidence = (typeof JUDGEMENT_CONFIDENCES)[number];
11
+ export declare const DEDUPE_INTENTS: readonly ["merge", "keep_both"];
12
+ export type DedupeIntent = (typeof DEDUPE_INTENTS)[number];
13
+ export type VerdictKind = 'keep' | 'skip' | 'merge_into';
14
+ export declare const RATIONALE_MAX = 500;
15
+ export interface Judgement {
16
+ verdict: VerdictKind;
17
+ /** 仅 verdict === 'merge_into' 时非空。 */
18
+ mergeIntoId: string | null;
19
+ confidence: JudgementConfidence;
20
+ rationale: string;
21
+ dedupe: DedupeIntent;
22
+ }
23
+ /**
24
+ * 解析并校验判断。非法值一律拒绝,MUST NOT 用默认值补齐——
25
+ * 补齐会把"调用方说错了"变成"系统替它选了一个",而这两件事在审计里必须能分开。
26
+ */
27
+ export declare function parseJudgement(raw: unknown): Judgement;
28
+ /** CLI 用扁平参数拼装,复杂到需要对象时由调用方直接传 JSON。 */
29
+ export declare function judgementFromFlags(flags: Record<string, string | boolean | undefined>): Judgement | null;
30
+ export type WriteAction = 'insert' | 'merge' | 'promote_candidate' | 'skip' | 'candidate';
31
+ export interface WriteDecision {
32
+ action: WriteAction;
33
+ /** merge 时指向被并入的记忆;其余为 null。 */
34
+ targetMemoryId: string | null;
35
+ /** 落审计的判定依据,形如 judgement_skip_medium / duplicate_active。 */
36
+ basis: string;
37
+ }
38
+ export interface DecideWriteInput {
39
+ judgement: Judgement | null;
40
+ duplicate: DuplicateHit | null;
41
+ }
42
+ /**
43
+ * 判断 + 查重 → 落库动作。纯函数,不读库不写库。
44
+ *
45
+ * 关键取舍:**没有判断时也要查重**。写入路径的重复不是判断出来的,是比对出来的;
46
+ * 先把这件事做掉,才谈得上"只有一条"。
47
+ */
48
+ export declare function decideWrite(input: DecideWriteInput): WriteDecision;
49
+ /** 审计用的紧凑描述:不落原文,只落结论与理由。 */
50
+ export declare function describeJudgement(j: Judgement): string;
@@ -0,0 +1,121 @@
1
+ import { err } from '../core/errors.js';
2
+ /**
3
+ * 写入时判断(design D6 / D10):判断是**建议**,不是授权。
4
+ *
5
+ * 它只回答"这条值不值得记",不回答"允许不允许记"。后者一律由写入参数、作用域解析与
6
+ * 策略白名单决定。因此这里**没有**任何能改敏感度、改作用域、或构成审批凭证的字段——
7
+ * 不是没实现,是不允许存在。
8
+ */
9
+ export const JUDGEMENT_CONFIDENCES = ['high', 'medium', 'low'];
10
+ export const DEDUPE_INTENTS = ['merge', 'keep_both'];
11
+ export const RATIONALE_MAX = 500;
12
+ const MERGE_INTO_PREFIX = 'merge_into:';
13
+ /**
14
+ * 解析并校验判断。非法值一律拒绝,MUST NOT 用默认值补齐——
15
+ * 补齐会把"调用方说错了"变成"系统替它选了一个",而这两件事在审计里必须能分开。
16
+ */
17
+ export function parseJudgement(raw) {
18
+ if (raw == null)
19
+ throw err('E_VALIDATION', '判断不能为空');
20
+ if (typeof raw !== 'object' || Array.isArray(raw)) {
21
+ throw err('E_VALIDATION', '判断必须是对象');
22
+ }
23
+ const obj = raw;
24
+ const verdictRaw = obj['verdict'];
25
+ if (typeof verdictRaw !== 'string' || verdictRaw.trim().length === 0) {
26
+ throw err('E_VALIDATION', '判断缺少 verdict(keep / skip / merge_into:<记忆id>)');
27
+ }
28
+ const verdictText = verdictRaw.trim();
29
+ let verdict;
30
+ let mergeIntoId = null;
31
+ if (verdictText === 'keep' || verdictText === 'skip') {
32
+ verdict = verdictText;
33
+ }
34
+ else if (verdictText.startsWith(MERGE_INTO_PREFIX)) {
35
+ const target = verdictText.slice(MERGE_INTO_PREFIX.length).trim();
36
+ if (target.length === 0) {
37
+ throw err('E_VALIDATION', 'merge_into 必须指定目标记忆 id');
38
+ }
39
+ verdict = 'merge_into';
40
+ mergeIntoId = target;
41
+ }
42
+ else {
43
+ throw err('E_VALIDATION', `verdict 非法: ${verdictText}(只允许 keep / skip / merge_into:<记忆id>)`);
44
+ }
45
+ const confidenceRaw = obj['confidence'];
46
+ if (typeof confidenceRaw !== 'string' || !JUDGEMENT_CONFIDENCES.includes(confidenceRaw)) {
47
+ throw err('E_VALIDATION', `confidence 缺失或非法(只允许 ${JUDGEMENT_CONFIDENCES.join(' / ')}),不能省略`);
48
+ }
49
+ const confidence = confidenceRaw;
50
+ const rationaleRaw = obj['rationale'];
51
+ if (typeof rationaleRaw !== 'string' || rationaleRaw.trim().length === 0) {
52
+ throw err('E_VALIDATION', '判断必须给出一句话理由(rationale),不能为空');
53
+ }
54
+ const rationale = rationaleRaw.trim();
55
+ if (rationale.length > RATIONALE_MAX) {
56
+ throw err('E_VALIDATION', `rationale 超过 ${RATIONALE_MAX} 字符上限`);
57
+ }
58
+ const dedupeRaw = obj['dedupe'];
59
+ let dedupe = 'merge';
60
+ if (dedupeRaw != null) {
61
+ if (typeof dedupeRaw !== 'string' || !DEDUPE_INTENTS.includes(dedupeRaw)) {
62
+ throw err('E_VALIDATION', `dedupe 非法: ${String(dedupeRaw)}(只允许 ${DEDUPE_INTENTS.join(' / ')})`);
63
+ }
64
+ dedupe = dedupeRaw;
65
+ }
66
+ if (dedupe === 'keep_both' && verdict === 'merge_into') {
67
+ throw err('E_VALIDATION', 'keep_both 与 merge_into 互斥:一个要求并存,一个要求并入指定记忆');
68
+ }
69
+ return { verdict, mergeIntoId, confidence, rationale, dedupe };
70
+ }
71
+ /** CLI 用扁平参数拼装,复杂到需要对象时由调用方直接传 JSON。 */
72
+ export function judgementFromFlags(flags) {
73
+ const verdict = flags['judgement'];
74
+ if (verdict == null || typeof verdict !== 'string')
75
+ return null;
76
+ const merged = { verdict };
77
+ for (const key of ['confidence', 'rationale', 'dedupe']) {
78
+ const v = flags[key];
79
+ if (typeof v === 'string')
80
+ merged[key] = v;
81
+ }
82
+ return parseJudgement(merged);
83
+ }
84
+ /**
85
+ * 判断 + 查重 → 落库动作。纯函数,不读库不写库。
86
+ *
87
+ * 关键取舍:**没有判断时也要查重**。写入路径的重复不是判断出来的,是比对出来的;
88
+ * 先把这件事做掉,才谈得上"只有一条"。
89
+ */
90
+ export function decideWrite(input) {
91
+ const { judgement, duplicate } = input;
92
+ if (judgement?.verdict === 'skip') {
93
+ if (judgement.confidence === 'high') {
94
+ return { action: 'skip', targetMemoryId: null, basis: 'judgement_skip_high' };
95
+ }
96
+ // 低置信的"不值得记"不足以丢弃,也不足以新建:既有 active 就并进去,没有就降为候选。
97
+ if (duplicate?.status === 'active') {
98
+ return { action: 'merge', targetMemoryId: duplicate.memoryId, basis: `judgement_skip_${judgement.confidence}_existing_active` };
99
+ }
100
+ return { action: 'candidate', targetMemoryId: null, basis: `judgement_skip_${judgement.confidence}` };
101
+ }
102
+ if (judgement?.verdict === 'merge_into') {
103
+ return { action: 'merge', targetMemoryId: judgement.mergeIntoId, basis: 'judgement_merge_into' };
104
+ }
105
+ // verdict = keep,或没有判断:都走同一条查重路径。
106
+ if (judgement?.dedupe === 'keep_both') {
107
+ return { action: 'insert', targetMemoryId: null, basis: 'judgement_keep_both' };
108
+ }
109
+ if (duplicate) {
110
+ return duplicate.status === 'active'
111
+ ? { action: 'merge', targetMemoryId: duplicate.memoryId, basis: 'duplicate_active' }
112
+ : { action: 'promote_candidate', targetMemoryId: duplicate.memoryId, basis: 'duplicate_candidate' };
113
+ }
114
+ return { action: 'insert', targetMemoryId: null, basis: judgement ? 'judgement_keep' : 'no_duplicate' };
115
+ }
116
+ /** 审计用的紧凑描述:不落原文,只落结论与理由。 */
117
+ export function describeJudgement(j) {
118
+ const target = j.mergeIntoId ? `→${j.mergeIntoId}` : '';
119
+ return `${j.verdict}${target}/${j.confidence}/${j.dedupe}`;
120
+ }
121
+ //# sourceMappingURL=judgement.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"judgement.js","sourceRoot":"","sources":["../../../src/onboarding/judgement.ts"],"names":[],"mappings":"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"}