@carloswon/cairn-memory 0.0.0-stage → 0.2.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (222) hide show
  1. package/CHANGELOG.md +54 -0
  2. package/LICENSE +21 -0
  3. package/README.md +158 -2
  4. package/dist/src/agents/adapters.d.ts +82 -0
  5. package/dist/src/agents/adapters.js +209 -0
  6. package/dist/src/agents/adapters.js.map +1 -0
  7. package/dist/src/agents/config.d.ts +82 -0
  8. package/dist/src/agents/config.js +603 -0
  9. package/dist/src/agents/config.js.map +1 -0
  10. package/dist/src/agents/cordisPatch.d.ts +89 -0
  11. package/dist/src/agents/cordisPatch.js +201 -0
  12. package/dist/src/agents/cordisPatch.js.map +1 -0
  13. package/dist/src/agents/index.d.ts +2 -0
  14. package/dist/src/agents/index.js +3 -0
  15. package/dist/src/agents/index.js.map +1 -0
  16. package/dist/src/core/errors.d.ts +36 -0
  17. package/dist/src/core/errors.js +74 -0
  18. package/dist/src/core/errors.js.map +1 -0
  19. package/dist/src/core/hash.d.ts +14 -0
  20. package/dist/src/core/hash.js +48 -0
  21. package/dist/src/core/hash.js.map +1 -0
  22. package/dist/src/core/ids.d.ts +10 -0
  23. package/dist/src/core/ids.js +41 -0
  24. package/dist/src/core/ids.js.map +1 -0
  25. package/dist/src/core/index.d.ts +6 -0
  26. package/dist/src/core/index.js +7 -0
  27. package/dist/src/core/index.js.map +1 -0
  28. package/dist/src/core/scope.d.ts +78 -0
  29. package/dist/src/core/scope.js +181 -0
  30. package/dist/src/core/scope.js.map +1 -0
  31. package/dist/src/core/secrets.d.ts +13 -0
  32. package/dist/src/core/secrets.js +122 -0
  33. package/dist/src/core/secrets.js.map +1 -0
  34. package/dist/src/core/time.d.ts +7 -0
  35. package/dist/src/core/time.js +18 -0
  36. package/dist/src/core/time.js.map +1 -0
  37. package/dist/src/core/types.d.ts +133 -0
  38. package/dist/src/core/types.js +30 -0
  39. package/dist/src/core/types.js.map +1 -0
  40. package/dist/src/governance/apply.d.ts +64 -0
  41. package/dist/src/governance/apply.js +160 -0
  42. package/dist/src/governance/apply.js.map +1 -0
  43. package/dist/src/governance/dedup.d.ts +21 -0
  44. package/dist/src/governance/dedup.js +23 -0
  45. package/dist/src/governance/dedup.js.map +1 -0
  46. package/dist/src/governance/index.d.ts +16 -0
  47. package/dist/src/governance/index.js +17 -0
  48. package/dist/src/governance/index.js.map +1 -0
  49. package/dist/src/governance/propose.d.ts +78 -0
  50. package/dist/src/governance/propose.js +150 -0
  51. package/dist/src/governance/propose.js.map +1 -0
  52. package/dist/src/index.d.ts +15 -0
  53. package/dist/src/index.js +24 -0
  54. package/dist/src/index.js.map +1 -0
  55. package/dist/src/interfaces/app-service.d.ts +242 -0
  56. package/dist/src/interfaces/app-service.js +614 -0
  57. package/dist/src/interfaces/app-service.js.map +1 -0
  58. package/dist/src/interfaces/cli/main.d.ts +2 -0
  59. package/dist/src/interfaces/cli/main.js +790 -0
  60. package/dist/src/interfaces/cli/main.js.map +1 -0
  61. package/dist/src/interfaces/console/assets/page.d.ts +18 -0
  62. package/dist/src/interfaces/console/assets/page.js +39 -0
  63. package/dist/src/interfaces/console/assets/page.js.map +1 -0
  64. package/dist/src/interfaces/console/assets/ui-css.d.ts +11 -0
  65. package/dist/src/interfaces/console/assets/ui-css.js +119 -0
  66. package/dist/src/interfaces/console/assets/ui-css.js.map +1 -0
  67. package/dist/src/interfaces/console/assets/ui-js.d.ts +14 -0
  68. package/dist/src/interfaces/console/assets/ui-js.js +1098 -0
  69. package/dist/src/interfaces/console/assets/ui-js.js.map +1 -0
  70. package/dist/src/interfaces/console/assets/url-state.d.ts +9 -0
  71. package/dist/src/interfaces/console/assets/url-state.js +45 -0
  72. package/dist/src/interfaces/console/assets/url-state.js.map +1 -0
  73. package/dist/src/interfaces/console/export.d.ts +46 -0
  74. package/dist/src/interfaces/console/export.js +84 -0
  75. package/dist/src/interfaces/console/export.js.map +1 -0
  76. package/dist/src/interfaces/console/model.d.ts +372 -0
  77. package/dist/src/interfaces/console/model.js +731 -0
  78. package/dist/src/interfaces/console/model.js.map +1 -0
  79. package/dist/src/interfaces/console/review-store.d.ts +142 -0
  80. package/dist/src/interfaces/console/review-store.js +342 -0
  81. package/dist/src/interfaces/console/review-store.js.map +1 -0
  82. package/dist/src/interfaces/console/security.d.ts +76 -0
  83. package/dist/src/interfaces/console/security.js +105 -0
  84. package/dist/src/interfaces/console/security.js.map +1 -0
  85. package/dist/src/interfaces/console/server.d.ts +45 -0
  86. package/dist/src/interfaces/console/server.js +476 -0
  87. package/dist/src/interfaces/console/server.js.map +1 -0
  88. package/dist/src/interfaces/console/suggestions.d.ts +112 -0
  89. package/dist/src/interfaces/console/suggestions.js +511 -0
  90. package/dist/src/interfaces/console/suggestions.js.map +1 -0
  91. package/dist/src/interfaces/console/text.d.ts +4 -0
  92. package/dist/src/interfaces/console/text.js +18 -0
  93. package/dist/src/interfaces/console/text.js.map +1 -0
  94. package/dist/src/interfaces/mcp/server.d.ts +4 -0
  95. package/dist/src/interfaces/mcp/server.js +412 -0
  96. package/dist/src/interfaces/mcp/server.js.map +1 -0
  97. package/dist/src/jobs/index.d.ts +6 -0
  98. package/dist/src/jobs/index.js +7 -0
  99. package/dist/src/jobs/index.js.map +1 -0
  100. package/dist/src/jobs/remote.d.ts +42 -0
  101. package/dist/src/jobs/remote.js +34 -0
  102. package/dist/src/jobs/remote.js.map +1 -0
  103. package/dist/src/jobs/worker.d.ts +67 -0
  104. package/dist/src/jobs/worker.js +169 -0
  105. package/dist/src/jobs/worker.js.map +1 -0
  106. package/dist/src/onboarding/auto.d.ts +88 -0
  107. package/dist/src/onboarding/auto.js +399 -0
  108. package/dist/src/onboarding/auto.js.map +1 -0
  109. package/dist/src/onboarding/batches.d.ts +103 -0
  110. package/dist/src/onboarding/batches.js +219 -0
  111. package/dist/src/onboarding/batches.js.map +1 -0
  112. package/dist/src/onboarding/discover.d.ts +54 -0
  113. package/dist/src/onboarding/discover.js +369 -0
  114. package/dist/src/onboarding/discover.js.map +1 -0
  115. package/dist/src/onboarding/import.d.ts +69 -0
  116. package/dist/src/onboarding/import.js +279 -0
  117. package/dist/src/onboarding/import.js.map +1 -0
  118. package/dist/src/onboarding/index.d.ts +24 -0
  119. package/dist/src/onboarding/index.js +22 -0
  120. package/dist/src/onboarding/index.js.map +1 -0
  121. package/dist/src/onboarding/judgement.d.ts +50 -0
  122. package/dist/src/onboarding/judgement.js +121 -0
  123. package/dist/src/onboarding/judgement.js.map +1 -0
  124. package/dist/src/onboarding/policy.d.ts +86 -0
  125. package/dist/src/onboarding/policy.js +249 -0
  126. package/dist/src/onboarding/policy.js.map +1 -0
  127. package/dist/src/projection/brief.d.ts +77 -0
  128. package/dist/src/projection/brief.js +111 -0
  129. package/dist/src/projection/brief.js.map +1 -0
  130. package/dist/src/projection/index.d.ts +1 -0
  131. package/dist/src/projection/index.js +2 -0
  132. package/dist/src/projection/index.js.map +1 -0
  133. package/dist/src/projection/markdown.d.ts +82 -0
  134. package/dist/src/projection/markdown.js +313 -0
  135. package/dist/src/projection/markdown.js.map +1 -0
  136. package/dist/src/retrieval/export.d.ts +80 -0
  137. package/dist/src/retrieval/export.js +215 -0
  138. package/dist/src/retrieval/export.js.map +1 -0
  139. package/dist/src/retrieval/index.d.ts +5 -0
  140. package/dist/src/retrieval/index.js +6 -0
  141. package/dist/src/retrieval/index.js.map +1 -0
  142. package/dist/src/retrieval/search.d.ts +37 -0
  143. package/dist/src/retrieval/search.js +294 -0
  144. package/dist/src/retrieval/search.js.map +1 -0
  145. package/dist/src/store/archives.d.ts +94 -0
  146. package/dist/src/store/archives.js +135 -0
  147. package/dist/src/store/archives.js.map +1 -0
  148. package/dist/src/store/audit.d.ts +26 -0
  149. package/dist/src/store/audit.js +48 -0
  150. package/dist/src/store/audit.js.map +1 -0
  151. package/dist/src/store/backup.d.ts +36 -0
  152. package/dist/src/store/backup.js +90 -0
  153. package/dist/src/store/backup.js.map +1 -0
  154. package/dist/src/store/blocks.d.ts +64 -0
  155. package/dist/src/store/blocks.js +104 -0
  156. package/dist/src/store/blocks.js.map +1 -0
  157. package/dist/src/store/conflicts.d.ts +52 -0
  158. package/dist/src/store/conflicts.js +112 -0
  159. package/dist/src/store/conflicts.js.map +1 -0
  160. package/dist/src/store/db.d.ts +44 -0
  161. package/dist/src/store/db.js +162 -0
  162. package/dist/src/store/db.js.map +1 -0
  163. package/dist/src/store/device.d.ts +46 -0
  164. package/dist/src/store/device.js +111 -0
  165. package/dist/src/store/device.js.map +1 -0
  166. package/dist/src/store/index.d.ts +14 -0
  167. package/dist/src/store/index.js +15 -0
  168. package/dist/src/store/index.js.map +1 -0
  169. package/dist/src/store/memories.d.ts +101 -0
  170. package/dist/src/store/memories.js +378 -0
  171. package/dist/src/store/memories.js.map +1 -0
  172. package/dist/src/store/migrate.d.ts +32 -0
  173. package/dist/src/store/migrate.js +86 -0
  174. package/dist/src/store/migrate.js.map +1 -0
  175. package/dist/src/store/open.d.ts +53 -0
  176. package/dist/src/store/open.js +177 -0
  177. package/dist/src/store/open.js.map +1 -0
  178. package/dist/src/store/outbox.d.ts +65 -0
  179. package/dist/src/store/outbox.js +137 -0
  180. package/dist/src/store/outbox.js.map +1 -0
  181. package/dist/src/store/plans.d.ts +137 -0
  182. package/dist/src/store/plans.js +243 -0
  183. package/dist/src/store/plans.js.map +1 -0
  184. package/dist/src/store/schema.d.ts +34 -0
  185. package/dist/src/store/schema.js +527 -0
  186. package/dist/src/store/schema.js.map +1 -0
  187. package/dist/src/store/scopes.d.ts +44 -0
  188. package/dist/src/store/scopes.js +220 -0
  189. package/dist/src/store/scopes.js.map +1 -0
  190. package/dist/src/store/write-guard.d.ts +10 -0
  191. package/dist/src/store/write-guard.js +10 -0
  192. package/dist/src/store/write-guard.js.map +1 -0
  193. package/dist/src/sync/apply.d.ts +24 -0
  194. package/dist/src/sync/apply.js +130 -0
  195. package/dist/src/sync/apply.js.map +1 -0
  196. package/dist/src/sync/cryptoutil.d.ts +86 -0
  197. package/dist/src/sync/cryptoutil.js +339 -0
  198. package/dist/src/sync/cryptoutil.js.map +1 -0
  199. package/dist/src/sync/events.d.ts +69 -0
  200. package/dist/src/sync/events.js +78 -0
  201. package/dist/src/sync/events.js.map +1 -0
  202. package/dist/src/sync/obs-store.d.ts +41 -0
  203. package/dist/src/sync/obs-store.js +325 -0
  204. package/dist/src/sync/obs-store.js.map +1 -0
  205. package/dist/src/sync/orchestrate.d.ts +37 -0
  206. package/dist/src/sync/orchestrate.js +84 -0
  207. package/dist/src/sync/orchestrate.js.map +1 -0
  208. package/dist/src/sync/pull.d.ts +24 -0
  209. package/dist/src/sync/pull.js +150 -0
  210. package/dist/src/sync/pull.js.map +1 -0
  211. package/dist/src/sync/push.d.ts +19 -0
  212. package/dist/src/sync/push.js +227 -0
  213. package/dist/src/sync/push.js.map +1 -0
  214. package/dist/src/sync/syncd-store.d.ts +31 -0
  215. package/dist/src/sync/syncd-store.js +92 -0
  216. package/dist/src/sync/syncd-store.js.map +1 -0
  217. package/dist/src/sync/vault.d.ts +37 -0
  218. package/dist/src/sync/vault.js +53 -0
  219. package/dist/src/sync/vault.js.map +1 -0
  220. package/docs/cairn-security.md +254 -0
  221. package/docs/cairn-usage.md +821 -0
  222. package/package.json +71 -4
@@ -0,0 +1,89 @@
1
+ /**
2
+ * Cordis 插件树 patch 文件的**行级**编辑器(tasks 2.1–2.4,design D2/D3)。
3
+ *
4
+ * 为什么不用 YAML 库:
5
+ * - 项目运行时依赖只有三项,不为一个宿主再加依赖;
6
+ * - 更要紧的是,任何 YAML 反序列化再序列化都会丢失注释与键序,而 cordis.patch.yml
7
+ * 是 DSH 与用户共写的共享文件(本机实测 43 KB / 1277 行,含用户注释)。
8
+ *
9
+ * 因此这里只做一件事:定位**本产品那一个** `- insert:` 块,整体替换或删除它。
10
+ * 认不出的结构一律硬失败(E_CONFIG_CONFLICT),绝不猜测性重写。
11
+ *
12
+ * 目标文件形态(实测样本):
13
+ *
14
+ * # 注释行
15
+ * - { id: some-entry, disabled: false }
16
+ * - id: some-plugin
17
+ * name: "@deepseek-ai/some-plugin"
18
+ * config:
19
+ * key: value
20
+ * - insert:
21
+ * - id: mcp-cairn
22
+ * name: "@deepseek-ai/dsh-mcp-client"
23
+ * config:
24
+ * serverName: cairn
25
+ * - id: another-plugin
26
+ */
27
+ /** 本产品在 DSH 侧的条目 id 与插件名(与手工接入时一致,便于识别既有安装)。 */
28
+ export declare const CAIRN_DSH_ENTRY_ID = "mcp-cairn";
29
+ export declare const CAIRN_DSH_PLUGIN_NAME = "@deepseek-ai/dsh-mcp-client";
30
+ export interface PatchBlock {
31
+ /** `- insert:` 行的行下标(0 基)。 */
32
+ startLine: number;
33
+ /** 块最后一行的下一个下标(不含)。 */
34
+ endLine: number;
35
+ /** `- insert:` 自身缩进(字符数)。 */
36
+ indent: number;
37
+ /** 块内是否含本产品条目。 */
38
+ containsCairn: boolean;
39
+ }
40
+ /**
41
+ * 找出顶层(缩进为 0)的 `- insert:` 块。
42
+ *
43
+ * 块范围:从 `- insert:` 行开始,向下直到遇到「缩进 <= insert 缩进 且以 `- ` 开头」的下一行,
44
+ * 或文件结束。空行与注释行若出现在块*内部*会被吸收(它们属于该块),
45
+ * 但**末尾**的连续空行不计入块(避免删块时把段落分隔也删掉)。
46
+ */
47
+ export declare function scanPatchBlocks(text: string): PatchBlock[];
48
+ /** 本产品块的唯一性校验:0 个 → null;1 个 → 该块;≥2 → 结构不符。 */
49
+ export declare function findCairnInsert(text: string): PatchBlock | null;
50
+ export interface CordisEntrySpec {
51
+ /** MCP 命令(如 node 的绝对路径)。 */
52
+ command: string;
53
+ /** 命令参数(如 server.js 的绝对路径)。 */
54
+ args: string[];
55
+ }
56
+ /**
57
+ * 渲染本产品的 insert 块(含 `- insert:` 行)。
58
+ *
59
+ * 采用与手工接入时一致的缩进(insert 的列表项缩进 4 空格,其字段缩进 6 空格),
60
+ * 因为该形态已在真实 DSH 上验证过能被正确加载。
61
+ */
62
+ export declare function renderCairnInsert(spec: CordisEntrySpec): string[];
63
+ export interface UpsertResult {
64
+ output: string;
65
+ changed: boolean;
66
+ /** 本次是新增、替换还是未变。 */
67
+ action: 'inserted' | 'replaced' | 'unchanged';
68
+ }
69
+ /**
70
+ * 新增或替换本产品的 insert 块(task 2.2)。
71
+ *
72
+ * - 不存在 → 追加到文件末尾(保留原结尾换行风格);
73
+ * - 存在且内容不同 → 整体替换该块;
74
+ * - 存在且内容相同 → changed=false,输出逐字节等于输入(幂等)。
75
+ */
76
+ export declare function upsertCairnInsert(text: string, spec: CordisEntrySpec): UpsertResult;
77
+ export interface RemoveResult {
78
+ output: string;
79
+ changed: boolean;
80
+ }
81
+ /**
82
+ * 移除本产品的 insert 块(task 2.3)。
83
+ *
84
+ * 删除的是**整个** `- insert:` 块(含其首行),而不是只删内部行——
85
+ * 否则会留下空的 `insert:`,DSH 侧表现为 dangling patch row。
86
+ */
87
+ export declare function removeCairnInsert(text: string): RemoveResult;
88
+ /** 是否已含本产品条目(doctor 用;结构不符时同样抛出)。 */
89
+ export declare function hasCairnInsert(text: string): boolean;
@@ -0,0 +1,201 @@
1
+ import { err } from '../core/errors.js';
2
+ /**
3
+ * Cordis 插件树 patch 文件的**行级**编辑器(tasks 2.1–2.4,design D2/D3)。
4
+ *
5
+ * 为什么不用 YAML 库:
6
+ * - 项目运行时依赖只有三项,不为一个宿主再加依赖;
7
+ * - 更要紧的是,任何 YAML 反序列化再序列化都会丢失注释与键序,而 cordis.patch.yml
8
+ * 是 DSH 与用户共写的共享文件(本机实测 43 KB / 1277 行,含用户注释)。
9
+ *
10
+ * 因此这里只做一件事:定位**本产品那一个** `- insert:` 块,整体替换或删除它。
11
+ * 认不出的结构一律硬失败(E_CONFIG_CONFLICT),绝不猜测性重写。
12
+ *
13
+ * 目标文件形态(实测样本):
14
+ *
15
+ * # 注释行
16
+ * - { id: some-entry, disabled: false }
17
+ * - id: some-plugin
18
+ * name: "@deepseek-ai/some-plugin"
19
+ * config:
20
+ * key: value
21
+ * - insert:
22
+ * - id: mcp-cairn
23
+ * name: "@deepseek-ai/dsh-mcp-client"
24
+ * config:
25
+ * serverName: cairn
26
+ * - id: another-plugin
27
+ */
28
+ /** 本产品在 DSH 侧的条目 id 与插件名(与手工接入时一致,便于识别既有安装)。 */
29
+ export const CAIRN_DSH_ENTRY_ID = 'mcp-cairn';
30
+ export const CAIRN_DSH_PLUGIN_NAME = '@deepseek-ai/dsh-mcp-client';
31
+ const INSERT_LINE = /^(\s*)- insert:\s*$/;
32
+ const ROW_LINE = /^(\s*)- /;
33
+ const CAIRN_ID_LINE = new RegExp(`^(\\s*)- id:\\s*${CAIRN_DSH_ENTRY_ID}\\s*$`);
34
+ function splitLines(text) {
35
+ return text.split('\n');
36
+ }
37
+ function indentOf(line) {
38
+ const m = /^(\s*)/.exec(line);
39
+ return m === null ? 0 : m[1].length;
40
+ }
41
+ function isBlank(line) {
42
+ return line.trim().length === 0;
43
+ }
44
+ function isComment(line) {
45
+ return line.trimStart().startsWith('#');
46
+ }
47
+ /**
48
+ * 找出顶层(缩进为 0)的 `- insert:` 块。
49
+ *
50
+ * 块范围:从 `- insert:` 行开始,向下直到遇到「缩进 <= insert 缩进 且以 `- ` 开头」的下一行,
51
+ * 或文件结束。空行与注释行若出现在块*内部*会被吸收(它们属于该块),
52
+ * 但**末尾**的连续空行不计入块(避免删块时把段落分隔也删掉)。
53
+ */
54
+ export function scanPatchBlocks(text) {
55
+ const lines = splitLines(text);
56
+ const blocks = [];
57
+ for (let i = 0; i < lines.length; i++) {
58
+ const line = lines[i];
59
+ const m = INSERT_LINE.exec(line);
60
+ if (m === null)
61
+ continue;
62
+ // 只认顶层 insert(缩进 0);嵌套 insert 语义未验证,遇到即视为结构不符。
63
+ if (m[1].length !== 0) {
64
+ throw err('E_CONFIG_CONFLICT', `cordis.patch.yml 第 ${i + 1} 行出现非顶层的 insert 块:本适配器只处理顶层 insert,拒绝猜测嵌套语义`);
65
+ }
66
+ let end = lines.length;
67
+ for (let j = i + 1; j < lines.length; j++) {
68
+ const cur = lines[j];
69
+ if (isBlank(cur) || isComment(cur))
70
+ continue;
71
+ const row = ROW_LINE.exec(cur);
72
+ if (row !== null && row[1].length <= 0) {
73
+ end = j;
74
+ break;
75
+ }
76
+ }
77
+ // 修剪块尾的空行/注释行,使其留在块外
78
+ let trimmed = end;
79
+ while (trimmed > i + 1) {
80
+ const prev = lines[trimmed - 1];
81
+ if (isBlank(prev) || isComment(prev))
82
+ trimmed--;
83
+ else
84
+ break;
85
+ }
86
+ const body = lines.slice(i, trimmed);
87
+ const containsCairn = body.some((l) => CAIRN_ID_LINE.test(l));
88
+ blocks.push({ startLine: i, endLine: trimmed, indent: 0, containsCairn });
89
+ i = trimmed - 1;
90
+ }
91
+ return blocks;
92
+ }
93
+ /** 本产品块的唯一性校验:0 个 → null;1 个 → 该块;≥2 → 结构不符。 */
94
+ export function findCairnInsert(text) {
95
+ // 先确认这是顶层数组形态:否则"没找到本产品块"与"根本不是 patch 文件"会被混为一谈。
96
+ assertTopLevelArray(splitLines(text));
97
+ const blocks = scanPatchBlocks(text);
98
+ const ours = blocks.filter((b) => b.containsCairn);
99
+ if (ours.length > 1) {
100
+ throw err('E_CONFIG_CONFLICT', `cordis.patch.yml 中出现 ${ours.length} 个含 ${CAIRN_DSH_ENTRY_ID} 的 insert 块:结构不确定,拒绝改动(请先手工合并为一块)`);
101
+ }
102
+ return ours[0] ?? null;
103
+ }
104
+ function yamlQuote(v) {
105
+ // 只用双引号并转义反斜杠与双引号:对 Windows 路径足够,且不引入 YAML 库的转义规则。
106
+ return `"${v.replace(/\\/g, '\\\\').replace(/"/g, '\\"')}"`;
107
+ }
108
+ /**
109
+ * 渲染本产品的 insert 块(含 `- insert:` 行)。
110
+ *
111
+ * 采用与手工接入时一致的缩进(insert 的列表项缩进 4 空格,其字段缩进 6 空格),
112
+ * 因为该形态已在真实 DSH 上验证过能被正确加载。
113
+ */
114
+ export function renderCairnInsert(spec) {
115
+ if (typeof spec.command !== 'string' || spec.command.length === 0) {
116
+ throw err('E_VALIDATION', 'cordis insert: command 不能为空');
117
+ }
118
+ if (!Array.isArray(spec.args))
119
+ throw err('E_VALIDATION', 'cordis insert: args 必须是数组');
120
+ const out = [
121
+ '- insert:',
122
+ ` - id: ${CAIRN_DSH_ENTRY_ID}`,
123
+ ` name: ${yamlQuote(CAIRN_DSH_PLUGIN_NAME)}`,
124
+ ' config:',
125
+ ' serverName: cairn',
126
+ ' transport: stdio',
127
+ ` command: ${yamlQuote(spec.command)}`,
128
+ ];
129
+ if (spec.args.length === 0) {
130
+ out.push(' args: []');
131
+ }
132
+ else {
133
+ out.push(' args:');
134
+ for (const a of spec.args)
135
+ out.push(` - ${yamlQuote(a)}`);
136
+ }
137
+ out.push(' failOnStartupError: false');
138
+ return out;
139
+ }
140
+ function assertTopLevelArray(lines) {
141
+ const meaningful = lines.findIndex((l) => !isBlank(l) && !isComment(l));
142
+ if (meaningful < 0) {
143
+ throw err('E_CONFIG_CONFLICT', 'cordis.patch.yml 没有任何条目行:拒绝在空文件上猜测结构');
144
+ }
145
+ const first = lines[meaningful];
146
+ const row = ROW_LINE.exec(first);
147
+ if (row === null || row[1].length !== 0) {
148
+ throw err('E_CONFIG_CONFLICT', `cordis.patch.yml 顶层不是 YAML 数组(首个有效行: ${JSON.stringify(first.slice(0, 60))}):拒绝改动`);
149
+ }
150
+ }
151
+ /**
152
+ * 新增或替换本产品的 insert 块(task 2.2)。
153
+ *
154
+ * - 不存在 → 追加到文件末尾(保留原结尾换行风格);
155
+ * - 存在且内容不同 → 整体替换该块;
156
+ * - 存在且内容相同 → changed=false,输出逐字节等于输入(幂等)。
157
+ */
158
+ export function upsertCairnInsert(text, spec) {
159
+ const lines = splitLines(text);
160
+ assertTopLevelArray(lines);
161
+ const rendered = renderCairnInsert(spec);
162
+ const existing = findCairnInsert(text);
163
+ if (existing === null) {
164
+ const endsWithNewline = text.endsWith('\n');
165
+ const base = endsWithNewline ? text.slice(0, -1) : text;
166
+ const separated = base.length === 0 ? '' : base + '\n';
167
+ return { output: separated + rendered.join('\n') + '\n', changed: true, action: 'inserted' };
168
+ }
169
+ const current = lines.slice(existing.startLine, existing.endLine);
170
+ if (current.join('\n') === rendered.join('\n')) {
171
+ return { output: text, changed: false, action: 'unchanged' };
172
+ }
173
+ const next = [...lines.slice(0, existing.startLine), ...rendered, ...lines.slice(existing.endLine)];
174
+ return { output: next.join('\n'), changed: true, action: 'replaced' };
175
+ }
176
+ /**
177
+ * 移除本产品的 insert 块(task 2.3)。
178
+ *
179
+ * 删除的是**整个** `- insert:` 块(含其首行),而不是只删内部行——
180
+ * 否则会留下空的 `insert:`,DSH 侧表现为 dangling patch row。
181
+ */
182
+ export function removeCairnInsert(text) {
183
+ const existing = findCairnInsert(text);
184
+ if (existing === null)
185
+ return { output: text, changed: false };
186
+ const lines = splitLines(text);
187
+ let start = existing.startLine;
188
+ // 连带吃掉紧邻的前导空行,避免卸载后留下多余空行
189
+ while (start > 0 && isBlank(lines[start - 1]) && existing.endLine === lines.length)
190
+ start--;
191
+ const next = [...lines.slice(0, start), ...lines.slice(existing.endLine)];
192
+ let out = next.join('\n');
193
+ if (out.length > 0 && !out.endsWith('\n'))
194
+ out += '\n';
195
+ return { output: out, changed: true };
196
+ }
197
+ /** 是否已含本产品条目(doctor 用;结构不符时同样抛出)。 */
198
+ export function hasCairnInsert(text) {
199
+ return findCairnInsert(text) !== null;
200
+ }
201
+ //# sourceMappingURL=cordisPatch.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"cordisPatch.js","sourceRoot":"","sources":["../../../src/agents/cordisPatch.ts"],"names":[],"mappings":"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"}
@@ -0,0 +1,2 @@
1
+ export * from './adapters.js';
2
+ export * from './config.js';
@@ -0,0 +1,3 @@
1
+ export * from './adapters.js';
2
+ export * from './config.js';
3
+ //# sourceMappingURL=index.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/agents/index.ts"],"names":[],"mappings":"AAAA,cAAc,eAAe,CAAC;AAC9B,cAAc,aAAa,CAAC"}
@@ -0,0 +1,36 @@
1
+ /**
2
+ * Cairn 统一错误分类。所有模块抛出的业务错误都必须使用 CairnError,
3
+ * CLI/MCP 依据 code 决定退出码与响应,不允许把内部细节直接抛给调用方。
4
+ */
5
+ export type CairnErrorCode = 'E_SCOPE_INVALID' | 'E_SCOPE_MISMATCH' | 'E_SECRET_DETECTED' | 'E_INJECTION_SUSPECTED' | 'E_PLAN_INVALID' | 'E_PLAN_TAMPERED' | 'E_PLAN_EXPIRED' | 'E_APPROVAL_INVALID' | 'E_APPROVAL_EXPIRED' | 'E_APPROVAL_REPLAY' | 'E_TARGET_CHANGED' | 'E_NOT_FOUND' | 'E_DB_LOCKED' | 'E_MIGRATION_FAILED' | 'E_BACKUP_CORRUPT' | 'E_DEVICE_CLONED' | 'E_DEVICE_SUSPENDED' | 'E_READONLY' | 'E_CONFIG_CONFLICT' | 'E_CONFIG_IO' | 'E_PROJECTION_LOOP' | 'E_VALIDATION' | 'E_FORBIDDEN' | 'E_CONFLICT_STATE' | 'E_IO' | 'E_INTERNAL';
6
+ /** CLI 稳定退出码(任务 5.1:区分成功、拒绝和故障)。 */
7
+ export declare const ExitCode: {
8
+ /** 成功 */
9
+ readonly success: 0;
10
+ /** 一般故障(内部错误、IO 失败) */
11
+ readonly failure: 1;
12
+ /** 用法或参数校验错误 */
13
+ readonly usage: 2;
14
+ /** 被治理规则拒绝(秘密、伪造审批、越权作用域、计划篡改等) */
15
+ readonly refused: 3;
16
+ /** 状态冲突(同名外来条目、并发冲突未解决等) */
17
+ readonly conflict: 4;
18
+ /** 环境不可用(数据库被锁、设备被暂停、迁移失败) */
19
+ readonly unavailable: 5;
20
+ };
21
+ export type ExitCodeValue = (typeof ExitCode)[keyof typeof ExitCode];
22
+ export declare function exitCodeFor(code: CairnErrorCode): ExitCodeValue;
23
+ export declare class CairnError extends Error {
24
+ readonly code: CairnErrorCode;
25
+ /** 面向报告的结构化细节;绝不能包含记忆正文或秘密。 */
26
+ readonly details?: Record<string, unknown>;
27
+ constructor(code: CairnErrorCode, message: string, details?: Record<string, unknown>);
28
+ get exitCode(): ExitCodeValue;
29
+ toJSON(): {
30
+ code: CairnErrorCode;
31
+ message: string;
32
+ details?: Record<string, unknown>;
33
+ };
34
+ }
35
+ export declare function err(code: CairnErrorCode, message: string, details?: Record<string, unknown>): CairnError;
36
+ export declare function isCairnError(e: unknown): e is CairnError;
@@ -0,0 +1,74 @@
1
+ /**
2
+ * Cairn 统一错误分类。所有模块抛出的业务错误都必须使用 CairnError,
3
+ * CLI/MCP 依据 code 决定退出码与响应,不允许把内部细节直接抛给调用方。
4
+ */
5
+ /** CLI 稳定退出码(任务 5.1:区分成功、拒绝和故障)。 */
6
+ export const ExitCode = {
7
+ /** 成功 */
8
+ success: 0,
9
+ /** 一般故障(内部错误、IO 失败) */
10
+ failure: 1,
11
+ /** 用法或参数校验错误 */
12
+ usage: 2,
13
+ /** 被治理规则拒绝(秘密、伪造审批、越权作用域、计划篡改等) */
14
+ refused: 3,
15
+ /** 状态冲突(同名外来条目、并发冲突未解决等) */
16
+ conflict: 4,
17
+ /** 环境不可用(数据库被锁、设备被暂停、迁移失败) */
18
+ unavailable: 5,
19
+ };
20
+ const EXIT_BY_CODE = {
21
+ E_SCOPE_INVALID: ExitCode.usage,
22
+ E_SCOPE_MISMATCH: ExitCode.refused,
23
+ E_SECRET_DETECTED: ExitCode.refused,
24
+ E_INJECTION_SUSPECTED: ExitCode.refused,
25
+ E_PLAN_INVALID: ExitCode.usage,
26
+ E_PLAN_TAMPERED: ExitCode.refused,
27
+ E_PLAN_EXPIRED: ExitCode.refused,
28
+ E_APPROVAL_INVALID: ExitCode.refused,
29
+ E_APPROVAL_EXPIRED: ExitCode.refused,
30
+ E_APPROVAL_REPLAY: ExitCode.refused,
31
+ E_TARGET_CHANGED: ExitCode.conflict,
32
+ E_NOT_FOUND: ExitCode.failure,
33
+ E_DB_LOCKED: ExitCode.unavailable,
34
+ E_MIGRATION_FAILED: ExitCode.unavailable,
35
+ E_BACKUP_CORRUPT: ExitCode.unavailable,
36
+ E_DEVICE_CLONED: ExitCode.unavailable,
37
+ E_DEVICE_SUSPENDED: ExitCode.unavailable,
38
+ E_READONLY: ExitCode.refused,
39
+ E_CONFIG_CONFLICT: ExitCode.conflict,
40
+ E_CONFIG_IO: ExitCode.failure,
41
+ E_PROJECTION_LOOP: ExitCode.conflict,
42
+ E_VALIDATION: ExitCode.usage,
43
+ E_FORBIDDEN: ExitCode.refused,
44
+ E_CONFLICT_STATE: ExitCode.conflict,
45
+ E_IO: ExitCode.failure,
46
+ E_INTERNAL: ExitCode.failure,
47
+ };
48
+ export function exitCodeFor(code) {
49
+ return EXIT_BY_CODE[code];
50
+ }
51
+ export class CairnError extends Error {
52
+ code;
53
+ /** 面向报告的结构化细节;绝不能包含记忆正文或秘密。 */
54
+ details;
55
+ constructor(code, message, details) {
56
+ super(message);
57
+ this.name = 'CairnError';
58
+ this.code = code;
59
+ this.details = details;
60
+ }
61
+ get exitCode() {
62
+ return exitCodeFor(this.code);
63
+ }
64
+ toJSON() {
65
+ return { code: this.code, message: this.message, ...(this.details ? { details: this.details } : {}) };
66
+ }
67
+ }
68
+ export function err(code, message, details) {
69
+ return new CairnError(code, message, details);
70
+ }
71
+ export function isCairnError(e) {
72
+ return e instanceof CairnError;
73
+ }
74
+ //# sourceMappingURL=errors.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"errors.js","sourceRoot":"","sources":["../../../src/core/errors.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAmCH,oCAAoC;AACpC,MAAM,CAAC,MAAM,QAAQ,GAAG;IACtB,SAAS;IACT,OAAO,EAAE,CAAC;IACV,uBAAuB;IACvB,OAAO,EAAE,CAAC;IACV,gBAAgB;IAChB,KAAK,EAAE,CAAC;IACR,mCAAmC;IACnC,OAAO,EAAE,CAAC;IACV,4BAA4B;IAC5B,QAAQ,EAAE,CAAC;IACX,8BAA8B;IAC9B,WAAW,EAAE,CAAC;CACN,CAAC;AAIX,MAAM,YAAY,GAA0C;IAC1D,eAAe,EAAE,QAAQ,CAAC,KAAK;IAC/B,gBAAgB,EAAE,QAAQ,CAAC,OAAO;IAClC,iBAAiB,EAAE,QAAQ,CAAC,OAAO;IACnC,qBAAqB,EAAE,QAAQ,CAAC,OAAO;IACvC,cAAc,EAAE,QAAQ,CAAC,KAAK;IAC9B,eAAe,EAAE,QAAQ,CAAC,OAAO;IACjC,cAAc,EAAE,QAAQ,CAAC,OAAO;IAChC,kBAAkB,EAAE,QAAQ,CAAC,OAAO;IACpC,kBAAkB,EAAE,QAAQ,CAAC,OAAO;IACpC,iBAAiB,EAAE,QAAQ,CAAC,OAAO;IACnC,gBAAgB,EAAE,QAAQ,CAAC,QAAQ;IACnC,WAAW,EAAE,QAAQ,CAAC,OAAO;IAC7B,WAAW,EAAE,QAAQ,CAAC,WAAW;IACjC,kBAAkB,EAAE,QAAQ,CAAC,WAAW;IACxC,gBAAgB,EAAE,QAAQ,CAAC,WAAW;IACtC,eAAe,EAAE,QAAQ,CAAC,WAAW;IACrC,kBAAkB,EAAE,QAAQ,CAAC,WAAW;IACxC,UAAU,EAAE,QAAQ,CAAC,OAAO;IAC5B,iBAAiB,EAAE,QAAQ,CAAC,QAAQ;IACpC,WAAW,EAAE,QAAQ,CAAC,OAAO;IAC7B,iBAAiB,EAAE,QAAQ,CAAC,QAAQ;IACpC,YAAY,EAAE,QAAQ,CAAC,KAAK;IAC5B,WAAW,EAAE,QAAQ,CAAC,OAAO;IAC7B,gBAAgB,EAAE,QAAQ,CAAC,QAAQ;IACnC,IAAI,EAAE,QAAQ,CAAC,OAAO;IACtB,UAAU,EAAE,QAAQ,CAAC,OAAO;CAC7B,CAAC;AAEF,MAAM,UAAU,WAAW,CAAC,IAAoB;IAC9C,OAAO,YAAY,CAAC,IAAI,CAAC,CAAC;AAC5B,CAAC;AAED,MAAM,OAAO,UAAW,SAAQ,KAAK;IAC1B,IAAI,CAAiB;IAC9B,+BAA+B;IACtB,OAAO,CAA2B;IAE3C,YAAY,IAAoB,EAAE,OAAe,EAAE,OAAiC;QAClF,KAAK,CAAC,OAAO,CAAC,CAAC;QACf,IAAI,CAAC,IAAI,GAAG,YAAY,CAAC;QACzB,IAAI,CAAC,IAAI,GAAG,IAAI,CAAC;QACjB,IAAI,CAAC,OAAO,GAAG,OAAO,CAAC;IACzB,CAAC;IAED,IAAI,QAAQ;QACV,OAAO,WAAW,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;IAChC,CAAC;IAED,MAAM;QACJ,OAAO,EAAE,IAAI,EAAE,IAAI,CAAC,IAAI,EAAE,OAAO,EAAE,IAAI,CAAC,OAAO,EAAE,GAAG,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC,CAAC,EAAE,OAAO,EAAE,IAAI,CAAC,OAAO,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,CAAC;IACxG,CAAC;CACF;AAED,MAAM,UAAU,GAAG,CAAC,IAAoB,EAAE,OAAe,EAAE,OAAiC;IAC1F,OAAO,IAAI,UAAU,CAAC,IAAI,EAAE,OAAO,EAAE,OAAO,CAAC,CAAC;AAChD,CAAC;AAED,MAAM,UAAU,YAAY,CAAC,CAAU;IACrC,OAAO,CAAC,YAAY,UAAU,CAAC;AACjC,CAAC"}
@@ -0,0 +1,14 @@
1
+ /** 小写十六进制 sha256;所有 hash 字段统一使用该形态。 */
2
+ export declare function sha256Hex(data: string | Buffer): string;
3
+ /**
4
+ * 规范化 JSON:键递归排序、无空白。计划哈希(plan_hash)与内容哈希
5
+ * 必须基于规范化形态,字段顺序或空白变化不得影响结果(任务 3.1)。
6
+ */
7
+ export declare function canonicalJson(value: unknown): string;
8
+ export declare function sha256Canonical(value: unknown): string;
9
+ /**
10
+ * 正文规范化:NFC、去首尾空白、压缩连续空白。用于内容去重哈希;
11
+ * 原始正文始终单独保留(design D5:保留原始正文)。
12
+ */
13
+ export declare function normalizeContent(text: string): string;
14
+ export declare function contentHash(text: string): string;
@@ -0,0 +1,48 @@
1
+ import { createHash } from 'node:crypto';
2
+ /** 小写十六进制 sha256;所有 hash 字段统一使用该形态。 */
3
+ export function sha256Hex(data) {
4
+ return createHash('sha256').update(data).digest('hex');
5
+ }
6
+ /**
7
+ * 规范化 JSON:键递归排序、无空白。计划哈希(plan_hash)与内容哈希
8
+ * 必须基于规范化形态,字段顺序或空白变化不得影响结果(任务 3.1)。
9
+ */
10
+ export function canonicalJson(value) {
11
+ return canonicalize(value);
12
+ }
13
+ function canonicalize(value) {
14
+ if (value === null || typeof value === 'number' || typeof value === 'boolean') {
15
+ return JSON.stringify(value);
16
+ }
17
+ if (typeof value === 'string') {
18
+ return JSON.stringify(value);
19
+ }
20
+ if (Array.isArray(value)) {
21
+ return '[' + value.map((v) => canonicalize(v ?? null)).join(',') + ']';
22
+ }
23
+ if (value instanceof Date) {
24
+ return JSON.stringify(value.toISOString());
25
+ }
26
+ if (typeof value === 'object') {
27
+ const obj = value;
28
+ const keys = Object.keys(obj)
29
+ .filter((k) => obj[k] !== undefined)
30
+ .sort();
31
+ return '{' + keys.map((k) => JSON.stringify(k) + ':' + canonicalize(obj[k])).join(',') + '}';
32
+ }
33
+ throw new TypeError(`canonicalJson: unsupported type ${typeof value}`);
34
+ }
35
+ export function sha256Canonical(value) {
36
+ return sha256Hex(canonicalJson(value));
37
+ }
38
+ /**
39
+ * 正文规范化:NFC、去首尾空白、压缩连续空白。用于内容去重哈希;
40
+ * 原始正文始终单独保留(design D5:保留原始正文)。
41
+ */
42
+ export function normalizeContent(text) {
43
+ return text.normalize('NFC').trim().replace(/\s+/g, ' ');
44
+ }
45
+ export function contentHash(text) {
46
+ return sha256Hex(normalizeContent(text));
47
+ }
48
+ //# sourceMappingURL=hash.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"hash.js","sourceRoot":"","sources":["../../../src/core/hash.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAE,MAAM,aAAa,CAAC;AAEzC,uCAAuC;AACvC,MAAM,UAAU,SAAS,CAAC,IAAqB;IAC7C,OAAO,UAAU,CAAC,QAAQ,CAAC,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC;AACzD,CAAC;AAED;;;GAGG;AACH,MAAM,UAAU,aAAa,CAAC,KAAc;IAC1C,OAAO,YAAY,CAAC,KAAK,CAAC,CAAC;AAC7B,CAAC;AAED,SAAS,YAAY,CAAC,KAAc;IAClC,IAAI,KAAK,KAAK,IAAI,IAAI,OAAO,KAAK,KAAK,QAAQ,IAAI,OAAO,KAAK,KAAK,SAAS,EAAE,CAAC;QAC9E,OAAO,IAAI,CAAC,SAAS,CAAC,KAAK,CAAC,CAAC;IAC/B,CAAC;IACD,IAAI,OAAO,KAAK,KAAK,QAAQ,EAAE,CAAC;QAC9B,OAAO,IAAI,CAAC,SAAS,CAAC,KAAK,CAAC,CAAC;IAC/B,CAAC;IACD,IAAI,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC,EAAE,CAAC;QACzB,OAAO,GAAG,GAAG,KAAK,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,YAAY,CAAC,CAAC,IAAI,IAAI,CAAC,CAAC,CAAC,IAAI,CAAC,GAAG,CAAC,GAAG,GAAG,CAAC;IACzE,CAAC;IACD,IAAI,KAAK,YAAY,IAAI,EAAE,CAAC;QAC1B,OAAO,IAAI,CAAC,SAAS,CAAC,KAAK,CAAC,WAAW,EAAE,CAAC,CAAC;IAC7C,CAAC;IACD,IAAI,OAAO,KAAK,KAAK,QAAQ,EAAE,CAAC;QAC9B,MAAM,GAAG,GAAG,KAAgC,CAAC;QAC7C,MAAM,IAAI,GAAG,MAAM,CAAC,IAAI,CAAC,GAAG,CAAC;aAC1B,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC,KAAK,SAAS,CAAC;aACnC,IAAI,EAAE,CAAC;QACV,OAAO,GAAG,GAAG,IAAI,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,IAAI,CAAC,SAAS,CAAC,CAAC,CAAC,GAAG,GAAG,GAAG,YAAY,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,GAAG,CAAC,GAAG,GAAG,CAAC;IAC/F,CAAC;IACD,MAAM,IAAI,SAAS,CAAC,mCAAmC,OAAO,KAAK,EAAE,CAAC,CAAC;AACzE,CAAC;AAED,MAAM,UAAU,eAAe,CAAC,KAAc;IAC5C,OAAO,SAAS,CAAC,aAAa,CAAC,KAAK,CAAC,CAAC,CAAC;AACzC,CAAC;AAED;;;GAGG;AACH,MAAM,UAAU,gBAAgB,CAAC,IAAY;IAC3C,OAAO,IAAI,CAAC,SAAS,CAAC,KAAK,CAAC,CAAC,IAAI,EAAE,CAAC,OAAO,CAAC,MAAM,EAAE,GAAG,CAAC,CAAC;AAC3D,CAAC;AAED,MAAM,UAAU,WAAW,CAAC,IAAY;IACtC,OAAO,SAAS,CAAC,gBAAgB,CAAC,IAAI,CAAC,CAAC,CAAC;AAC3C,CAAC"}
@@ -0,0 +1,10 @@
1
+ /**
2
+ * RFC 9562 UUIDv7:48bit 毫秒时间戳 + 12bit rand_a + 62bit rand_b。
3
+ * 记忆、修订、计划等主键使用时间可排序 ID(design D3 / 构想 §7.1)。
4
+ */
5
+ export declare function uuidv7(now?: Date): string;
6
+ export declare function formatUuid(b: Buffer): string;
7
+ /** 校验 UUID 形态(v7 校验仅检查版本位,供导入数据使用)。 */
8
+ export declare function isUuid(s: string): boolean;
9
+ /** 幂等键:用确定性输入派生,重复应用不会产生第二条记录。 */
10
+ export declare function deriveIdempotencyKey(...parts: readonly string[]): string;
@@ -0,0 +1,41 @@
1
+ import { randomBytes } from 'node:crypto';
2
+ /**
3
+ * RFC 9562 UUIDv7:48bit 毫秒时间戳 + 12bit rand_a + 62bit rand_b。
4
+ * 记忆、修订、计划等主键使用时间可排序 ID(design D3 / 构想 §7.1)。
5
+ */
6
+ export function uuidv7(now = new Date()) {
7
+ const ts = BigInt(now.getTime()) & 0xffffffffffffn; // 48 bits
8
+ const rand = randomBytes(10); // 80 bits = rand_a(12) + rand_b(62) + 6 spare
9
+ const bytes = Buffer.alloc(16);
10
+ // time_low / time_mid / time_hi_and_version
11
+ bytes[0] = Number((ts >> 40n) & 0xffn);
12
+ bytes[1] = Number((ts >> 32n) & 0xffn);
13
+ bytes[2] = Number((ts >> 24n) & 0xffn);
14
+ bytes[3] = Number((ts >> 16n) & 0xffn);
15
+ bytes[4] = Number((ts >> 8n) & 0xffn);
16
+ bytes[5] = Number(ts & 0xffn);
17
+ bytes[6] = ((rand[0] ?? 0) & 0x0f) | 0x70; // version 7
18
+ bytes[7] = rand[1] ?? 0;
19
+ bytes[8] = ((rand[2] ?? 0) & 0x3f) | 0x80; // variant 10
20
+ bytes[9] = rand[3] ?? 0;
21
+ bytes[10] = rand[4] ?? 0;
22
+ bytes[11] = rand[5] ?? 0;
23
+ bytes[12] = rand[6] ?? 0;
24
+ bytes[13] = rand[7] ?? 0;
25
+ bytes[14] = rand[8] ?? 0;
26
+ bytes[15] = rand[9] ?? 0;
27
+ return formatUuid(bytes);
28
+ }
29
+ export function formatUuid(b) {
30
+ const hex = b.toString('hex');
31
+ return `${hex.slice(0, 8)}-${hex.slice(8, 12)}-${hex.slice(12, 16)}-${hex.slice(16, 20)}-${hex.slice(20)}`;
32
+ }
33
+ /** 校验 UUID 形态(v7 校验仅检查版本位,供导入数据使用)。 */
34
+ export function isUuid(s) {
35
+ return /^[0-9a-f]{8}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{12}$/.test(s);
36
+ }
37
+ /** 幂等键:用确定性输入派生,重复应用不会产生第二条记录。 */
38
+ export function deriveIdempotencyKey(...parts) {
39
+ return parts.map((p) => p.length.toString(16) + ':' + p).join('|');
40
+ }
41
+ //# sourceMappingURL=ids.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"ids.js","sourceRoot":"","sources":["../../../src/core/ids.ts"],"names":[],"mappings":"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"}
@@ -0,0 +1,6 @@
1
+ export * from './errors.js';
2
+ export * from './hash.js';
3
+ export * from './ids.js';
4
+ export * from './scope.js';
5
+ export * from './time.js';
6
+ export * from './types.js';
@@ -0,0 +1,7 @@
1
+ export * from './errors.js';
2
+ export * from './hash.js';
3
+ export * from './ids.js';
4
+ export * from './scope.js';
5
+ export * from './time.js';
6
+ export * from './types.js';
7
+ //# sourceMappingURL=index.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/core/index.ts"],"names":[],"mappings":"AAAA,cAAc,aAAa,CAAC;AAC5B,cAAc,WAAW,CAAC;AAC1B,cAAc,UAAU,CAAC;AACzB,cAAc,YAAY,CAAC;AAC3B,cAAc,WAAW,CAAC;AAC1B,cAAc,YAAY,CAAC"}