@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":"brief.js","sourceRoot":"","sources":["../../../src/projection/brief.ts"],"names":[],"mappings":"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"}
@@ -0,0 +1 @@
1
+ export * from './markdown.js';
@@ -0,0 +1,2 @@
1
+ export * from './markdown.js';
2
+ //# sourceMappingURL=index.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/projection/index.ts"],"names":[],"mappings":"AAAA,cAAc,eAAe,CAAC"}
@@ -0,0 +1,82 @@
1
+ import type { CairnStore } from '../store/open.js';
2
+ /**
3
+ * 受管 Markdown 投影(tasks 7.x)。
4
+ *
5
+ * 标记约定:
6
+ * 起始 `<!-- cairn:begin block="<blockId>" revision="<n>" -->`
7
+ * 结束 `<!-- cairn:end block="<blockId>" -->`
8
+ *
9
+ * 不变量:
10
+ * - 只改动受管区块内部字节;区块外内容逐字节保留(含未知换行风格)。
11
+ * - upsert 幂等:内容未变 → changed=false 且文件字节不动。
12
+ * - remove 同时清理安装时加入的分隔空行,其余部分逐字节保留。
13
+ * - 首次写入前把原始字节备份到 targetPath + '.cairn-backup'(已存在则不覆盖)。
14
+ * - 写入先落同目录临时文件再 rename(原子替换)。
15
+ */
16
+ /** 默认受管区块 ID(router 入口统一使用,保证 plan/apply/disable 一致)。 */
17
+ export declare const DEFAULT_BLOCK_ID = "cairn-memory";
18
+ export declare const BACKUP_SUFFIX = ".cairn-backup";
19
+ export declare function beginMarker(blockId: string, revision: number): string;
20
+ export declare function endMarker(blockId: string): string;
21
+ /** 渲染一个受管区块(含起止标记与内部正文)。 */
22
+ export declare function renderBlock(content: string, revision: number, blockId: string): string;
23
+ /** 防回环探测:导入/发现层据此跳过受管文件,不做任何解析。 */
24
+ export declare function hasCairnMarker(text: string): boolean;
25
+ /**
26
+ * 把区块写入文本:无块 → 追加(保证前面恰好一个空行分隔);
27
+ * 有块 → 整体替换并 revision+1;内容未变 → changed=false 且 revision 不变。
28
+ *
29
+ * options.revisionSeed:文件中无块但库里有历史记录时的 revision 续号
30
+ * (新 revision = seed + 1;不传则从 1 开始)。
31
+ */
32
+ export declare function upsertBlockInText(text: string, blockId: string, newContent: string, options?: {
33
+ revisionSeed?: number;
34
+ }): {
35
+ output: string;
36
+ changed: boolean;
37
+ hadBlock: boolean;
38
+ revision: number;
39
+ };
40
+ /**
41
+ * 从文本移除区块:删除区块本体,并回收安装时加入的前置分隔空行
42
+ * (只回收紧邻区块的那一个空行,用户自己加的空行/内容全部保留)。
43
+ * 区块外其余字节逐字节保留。
44
+ */
45
+ export declare function removeBlockFromText(text: string, blockId: string): {
46
+ output: string;
47
+ changed: boolean;
48
+ hadBlock: boolean;
49
+ };
50
+ export interface GenerateProjectionResult {
51
+ changed: boolean;
52
+ revision: number;
53
+ /** 本次实际使用的备份文件路径(未新建备份时为既有记录或 null)。 */
54
+ backupPath: string | null;
55
+ }
56
+ /**
57
+ * 生成受管投影:读文件(不存在 → '')→ upsert → 有变化才写。
58
+ * 首次写入前把原始字节备份到 targetPath + '.cairn-backup'(仅首次,不覆盖)。
59
+ * 库记录 revision 取现有块标记 / 库记录 + 1。
60
+ */
61
+ export declare function generateProjection(store: CairnStore, input: {
62
+ targetPath: string;
63
+ content: string;
64
+ blockId?: string;
65
+ agentId: string;
66
+ }): Promise<GenerateProjectionResult>;
67
+ export interface DisableProjectionResult {
68
+ removed: boolean;
69
+ restoredOriginal: boolean;
70
+ }
71
+ /**
72
+ * 停用受管投影:
73
+ * - 当前文件移除区块后与备份原始文件一致 → 直接整文件恢复备份字节(restoredOriginal=true);
74
+ * - 否则(用户有其他修改)只移除受管区块,其余修改保留;
75
+ * - 任何情况下都 markRemoved + 审计(不写正文)。
76
+ */
77
+ export declare function disableProjection(store: CairnStore, input: {
78
+ targetPath: string;
79
+ blockId?: string;
80
+ }): Promise<DisableProjectionResult>;
81
+ /** 供 config 模块复用的整文件哈希。 */
82
+ export declare function fileHash(buf: Buffer): string;
@@ -0,0 +1,313 @@
1
+ import { mkdir, readFile, rename, rm, stat, writeFile } from 'node:fs/promises';
2
+ import { dirname } from 'node:path';
3
+ import { err } from '../core/errors.js';
4
+ import { sha256Hex } from '../core/hash.js';
5
+ /**
6
+ * 受管 Markdown 投影(tasks 7.x)。
7
+ *
8
+ * 标记约定:
9
+ * 起始 `<!-- cairn:begin block="<blockId>" revision="<n>" -->`
10
+ * 结束 `<!-- cairn:end block="<blockId>" -->`
11
+ *
12
+ * 不变量:
13
+ * - 只改动受管区块内部字节;区块外内容逐字节保留(含未知换行风格)。
14
+ * - upsert 幂等:内容未变 → changed=false 且文件字节不动。
15
+ * - remove 同时清理安装时加入的分隔空行,其余部分逐字节保留。
16
+ * - 首次写入前把原始字节备份到 targetPath + '.cairn-backup'(已存在则不覆盖)。
17
+ * - 写入先落同目录临时文件再 rename(原子替换)。
18
+ */
19
+ /** 默认受管区块 ID(router 入口统一使用,保证 plan/apply/disable 一致)。 */
20
+ export const DEFAULT_BLOCK_ID = 'cairn-memory';
21
+ export const BACKUP_SUFFIX = '.cairn-backup';
22
+ const BEGIN_PREFIX = '<!-- cairn:begin block="';
23
+ const END_MARKER_PREFIX = '<!-- cairn:end block="';
24
+ /** blockId 进入标记文本与正则,只允许安全字符。 */
25
+ const BLOCK_ID_RE = /^[A-Za-z0-9][A-Za-z0-9._-]{0,63}$/;
26
+ function assertBlockId(blockId) {
27
+ if (typeof blockId !== 'string' || !BLOCK_ID_RE.test(blockId)) {
28
+ throw err('E_VALIDATION', `非法 blockId: ${JSON.stringify(blockId)}(仅允许字母数字与 . _ -,长度 1-64)`);
29
+ }
30
+ }
31
+ function assertBlockContent(content) {
32
+ if (typeof content !== 'string') {
33
+ throw err('E_VALIDATION', '区块内容必须是字符串');
34
+ }
35
+ if (/cairn:(begin|end)/i.test(content)) {
36
+ throw err('E_VALIDATION', '区块内容不得包含 cairn:begin / cairn:end 标记(防嵌套与解析歧义)');
37
+ }
38
+ }
39
+ export function beginMarker(blockId, revision) {
40
+ return `${BEGIN_PREFIX}${blockId}" revision="${revision}" -->`;
41
+ }
42
+ export function endMarker(blockId) {
43
+ return `${END_MARKER_PREFIX}${blockId}" -->`;
44
+ }
45
+ /** 渲染一个受管区块(含起止标记与内部正文)。 */
46
+ export function renderBlock(content, revision, blockId) {
47
+ assertBlockId(blockId);
48
+ assertBlockContent(content);
49
+ if (!Number.isInteger(revision) || revision < 0) {
50
+ throw err('E_VALIDATION', `非法 revision: ${revision}`);
51
+ }
52
+ return `${beginMarker(blockId, revision)}\n${content}\n${endMarker(blockId)}`;
53
+ }
54
+ function escapeRe(s) {
55
+ return s.replace(/[.*+?^${}()|[\]\\]/g, '\\$&');
56
+ }
57
+ function findBeginMatches(text, blockId) {
58
+ // revision 允许缺省(外来/手写标记按 0 处理,下一次写入从 1 开始)
59
+ const re = new RegExp(`^<!-- cairn:begin block="${escapeRe(blockId)}"(?: revision="(\\d+)")? -->[ \\t]*\\r?$`, 'gm');
60
+ const out = [];
61
+ for (let m = re.exec(text); m !== null; m = re.exec(text)) {
62
+ const markerStart = m.index;
63
+ const lineStart = text.lastIndexOf('\n', markerStart) + 1;
64
+ out.push({
65
+ lineStart,
66
+ markerEnd: markerStart + m[0].length,
67
+ revision: m[1] ? Number.parseInt(m[1], 10) : 0,
68
+ });
69
+ }
70
+ return out;
71
+ }
72
+ function findEndMatch(text, blockId, from) {
73
+ const re = new RegExp(`^<!-- cairn:end block="${escapeRe(blockId)}" -->[ \\t]*\\r?$`, 'gm');
74
+ re.lastIndex = from;
75
+ const m = re.exec(text);
76
+ if (m === null)
77
+ return null;
78
+ return { start: m.index, end: m.index + m[0].length };
79
+ }
80
+ function countEndMarkers(text, blockId) {
81
+ const re = new RegExp(`^<!-- cairn:end block="${escapeRe(blockId)}" -->[ \\t]*\\r?$`, 'gm');
82
+ let n = 0;
83
+ while (re.exec(text) !== null)
84
+ n += 1;
85
+ return n;
86
+ }
87
+ /**
88
+ * 定位区块跨度;重复或不平衡标记按 M0 矩阵约定拒绝(E_VALIDATION)。
89
+ * 未找到时返回 null。
90
+ */
91
+ function findBlockSpan(text, blockId) {
92
+ const begins = findBeginMatches(text, blockId);
93
+ const endCount = countEndMarkers(text, blockId);
94
+ if (begins.length > 1) {
95
+ throw err('E_VALIDATION', `目标文件中存在 ${begins.length} 个重复的受管区块标记(block=${blockId}),拒绝处理`);
96
+ }
97
+ if (begins.length === 0) {
98
+ if (endCount > 0) {
99
+ throw err('E_VALIDATION', `目标文件存在孤立的 cairn:end 标记(block=${blockId}),标记不平衡,拒绝处理`);
100
+ }
101
+ return null;
102
+ }
103
+ const begin = begins[0];
104
+ if (endCount !== 1) {
105
+ throw err('E_VALIDATION', `受管区块标记不平衡(block=${blockId}):起始 1 个、结束 ${endCount} 个,拒绝处理`);
106
+ }
107
+ const end = findEndMatch(text, blockId, begin.markerEnd);
108
+ if (end === null) {
109
+ throw err('E_VALIDATION', `受管区块缺少结束标记(block=${blockId}),拒绝处理`);
110
+ }
111
+ return { start: begin.lineStart, end: end.end, revision: begin.revision };
112
+ }
113
+ /** 防回环探测:导入/发现层据此跳过受管文件,不做任何解析。 */
114
+ export function hasCairnMarker(text) {
115
+ return /<!--\s*cairn:(begin|end)\b/.test(text);
116
+ }
117
+ /**
118
+ * 把区块写入文本:无块 → 追加(保证前面恰好一个空行分隔);
119
+ * 有块 → 整体替换并 revision+1;内容未变 → changed=false 且 revision 不变。
120
+ *
121
+ * options.revisionSeed:文件中无块但库里有历史记录时的 revision 续号
122
+ * (新 revision = seed + 1;不传则从 1 开始)。
123
+ */
124
+ export function upsertBlockInText(text, blockId, newContent, options = {}) {
125
+ assertBlockId(blockId);
126
+ assertBlockContent(newContent);
127
+ const span = findBlockSpan(text, blockId);
128
+ if (span === null) {
129
+ const revision = (options.revisionSeed ?? 0) + 1;
130
+ const block = renderBlock(newContent, revision, blockId);
131
+ const base = text.replace(/(?:\r?\n)+$/, '');
132
+ const output = base === '' ? `${block}\n` : `${base}\n\n${block}\n`;
133
+ return { output, changed: true, hadBlock: false, revision };
134
+ }
135
+ const spanText = text.slice(span.start, span.end);
136
+ const current = renderBlock(newContent, span.revision, blockId);
137
+ if (spanText === current) {
138
+ return { output: text, changed: false, hadBlock: true, revision: span.revision };
139
+ }
140
+ const nextRevision = span.revision + 1;
141
+ const output = text.slice(0, span.start) + renderBlock(newContent, nextRevision, blockId) + text.slice(span.end);
142
+ return { output, changed: true, hadBlock: true, revision: nextRevision };
143
+ }
144
+ /**
145
+ * 从文本移除区块:删除区块本体,并回收安装时加入的前置分隔空行
146
+ * (只回收紧邻区块的那一个空行,用户自己加的空行/内容全部保留)。
147
+ * 区块外其余字节逐字节保留。
148
+ */
149
+ export function removeBlockFromText(text, blockId) {
150
+ assertBlockId(blockId);
151
+ const span = findBlockSpan(text, blockId);
152
+ if (span === null) {
153
+ return { output: text, changed: false, hadBlock: false };
154
+ }
155
+ // 回收安装时加入的分隔空行:起始标记的上一行若为空行则一并移除
156
+ let start = span.start;
157
+ const before = text.slice(0, span.start);
158
+ const sepMatch = /(?:^|\r?\n)([ \t]*\r?\n)$/.exec(before);
159
+ if (sepMatch !== null && sepMatch[1] !== undefined) {
160
+ start -= sepMatch[1].length;
161
+ }
162
+ const end = span.end;
163
+ // 结束标记行自身的换行随区块一起移除
164
+ const suffixStart = skipNewline(text, end);
165
+ const head = text.slice(0, start);
166
+ let tail = text.slice(suffixStart);
167
+ if (head === '') {
168
+ // 区块原本位于文件最前:清理残留的前导空行
169
+ tail = tail.replace(/^(?:\r?\n)+/, '');
170
+ }
171
+ const output = head + tail;
172
+ return { output, changed: true, hadBlock: true };
173
+ }
174
+ function skipNewline(text, at) {
175
+ if (text[at] === '\r' && text[at + 1] === '\n')
176
+ return at + 2;
177
+ if (text[at] === '\n')
178
+ return at + 1;
179
+ return at;
180
+ }
181
+ /** 从已存的 startMarker 里解析 revision(库记录续号用)。 */
182
+ function parseRevisionFromMarker(marker) {
183
+ if (!marker)
184
+ return 0;
185
+ const m = /revision="(\d+)"/.exec(marker);
186
+ return m && m[1] ? Number.parseInt(m[1], 10) : 0;
187
+ }
188
+ async function readFileOrNull(path) {
189
+ try {
190
+ return await readFile(path);
191
+ }
192
+ catch (e) {
193
+ const code = e.code;
194
+ if (code === 'ENOENT')
195
+ return null;
196
+ throw err('E_CONFIG_IO', `读取文件失败: ${path}(${code ?? '未知错误'})`);
197
+ }
198
+ }
199
+ async function writeFileAtomic(path, data) {
200
+ await mkdir(dirname(path), { recursive: true });
201
+ const tmp = `${path}.cairn-tmp-${process.pid}-${Math.random().toString(36).slice(2, 10)}`;
202
+ try {
203
+ await writeFile(tmp, data);
204
+ await rename(tmp, path);
205
+ }
206
+ catch (e) {
207
+ await rm(tmp, { force: true }).catch(() => undefined);
208
+ throw err('E_CONFIG_IO', `原子写入失败: ${path}(${e.message})`);
209
+ }
210
+ }
211
+ /**
212
+ * 生成受管投影:读文件(不存在 → '')→ upsert → 有变化才写。
213
+ * 首次写入前把原始字节备份到 targetPath + '.cairn-backup'(仅首次,不覆盖)。
214
+ * 库记录 revision 取现有块标记 / 库记录 + 1。
215
+ */
216
+ export async function generateProjection(store, input) {
217
+ const blockId = input.blockId ?? DEFAULT_BLOCK_ID;
218
+ assertBlockId(blockId);
219
+ assertBlockContent(input.content);
220
+ if (typeof input.targetPath !== 'string' || input.targetPath.length === 0) {
221
+ throw err('E_VALIDATION', 'targetPath 不能为空');
222
+ }
223
+ if (typeof input.agentId !== 'string' || input.agentId.length === 0) {
224
+ throw err('E_VALIDATION', 'agentId 不能为空');
225
+ }
226
+ const original = await readFileOrNull(input.targetPath);
227
+ const text = original !== null ? original.toString('utf8') : '';
228
+ const existingRow = store.blocks.get(input.targetPath, blockId);
229
+ const seedRevision = existingRow ? parseRevisionFromMarker(existingRow.startMarker) : 0;
230
+ const result = upsertBlockInText(text, blockId, input.content, { revisionSeed: seedRevision });
231
+ // 幂等:内容未变且库里有记录 → 不写文件、不动库
232
+ if (!result.changed && existingRow) {
233
+ return { changed: false, revision: result.revision, backupPath: existingRow.backupPath };
234
+ }
235
+ const backupPath = input.targetPath + BACKUP_SUFFIX;
236
+ let backupToRecord = existingRow?.backupPath ?? null;
237
+ if (result.changed) {
238
+ if (original !== null) {
239
+ // 仅首次写入前备份原始字节;备份已存在则不覆盖
240
+ if (!(await backupExists(backupPath))) {
241
+ await writeFileAtomic(backupPath, original);
242
+ }
243
+ backupToRecord = backupPath;
244
+ }
245
+ await writeFileAtomic(input.targetPath, Buffer.from(result.output, 'utf8'));
246
+ }
247
+ const row = store.blocks.upsert({
248
+ targetPath: input.targetPath,
249
+ blockId,
250
+ agentId: input.agentId,
251
+ content: input.content,
252
+ startMarker: beginMarker(blockId, result.revision),
253
+ endMarker: endMarker(blockId),
254
+ ...(backupToRecord ? { backupPath: backupToRecord } : {}),
255
+ });
256
+ return { changed: result.changed, revision: result.revision, backupPath: row.backupPath };
257
+ }
258
+ /** 备份是否已存在(仅区分 ENOENT,其他 IO 错误如实抛出)。 */
259
+ async function backupExists(path) {
260
+ try {
261
+ await stat(path);
262
+ return true;
263
+ }
264
+ catch (e) {
265
+ if (e.code === 'ENOENT')
266
+ return false;
267
+ throw err('E_CONFIG_IO', `检查备份文件失败: ${path}(${e.code ?? '未知错误'})`);
268
+ }
269
+ }
270
+ /**
271
+ * 停用受管投影:
272
+ * - 当前文件移除区块后与备份原始文件一致 → 直接整文件恢复备份字节(restoredOriginal=true);
273
+ * - 否则(用户有其他修改)只移除受管区块,其余修改保留;
274
+ * - 任何情况下都 markRemoved + 审计(不写正文)。
275
+ */
276
+ export async function disableProjection(store, input) {
277
+ const blockId = input.blockId ?? DEFAULT_BLOCK_ID;
278
+ assertBlockId(blockId);
279
+ if (typeof input.targetPath !== 'string' || input.targetPath.length === 0) {
280
+ throw err('E_VALIDATION', 'targetPath 不能为空');
281
+ }
282
+ const row = store.blocks.get(input.targetPath, blockId);
283
+ const current = await readFileOrNull(input.targetPath);
284
+ let removed = false;
285
+ let restoredOriginal = false;
286
+ if (current !== null) {
287
+ const currentText = current.toString('utf8');
288
+ const removal = removeBlockFromText(currentText, blockId);
289
+ removed = removal.changed;
290
+ const backupPath = row?.backupPath ?? input.targetPath + BACKUP_SUFFIX;
291
+ const backup = await readFileOrNull(backupPath);
292
+ if (backup !== null && removal.output === backup.toString('utf8')) {
293
+ // 用户未做其他修改:整文件恢复原始字节
294
+ await writeFileAtomic(input.targetPath, backup);
295
+ restoredOriginal = true;
296
+ // 备份字节已完整还原,备份文件完成使命(删除失败不影响结论)
297
+ await rm(backupPath, { force: true }).catch(() => undefined);
298
+ }
299
+ else if (removal.changed && removal.output !== currentText) {
300
+ await writeFileAtomic(input.targetPath, Buffer.from(removal.output, 'utf8'));
301
+ }
302
+ }
303
+ if (row) {
304
+ store.blocks.markRemoved(row.id);
305
+ }
306
+ store.audit.record('config', 'projection_removed', { type: 'managed_block', id: blockId }, { targetPath: input.targetPath, removed, restoredOriginal, hadRecord: row !== null });
307
+ return { removed, restoredOriginal };
308
+ }
309
+ /** 供 config 模块复用的整文件哈希。 */
310
+ export function fileHash(buf) {
311
+ return sha256Hex(buf);
312
+ }
313
+ //# sourceMappingURL=markdown.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"markdown.js","sourceRoot":"","sources":["../../../src/projection/markdown.ts"],"names":[],"mappings":"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"}
@@ -0,0 +1,80 @@
1
+ import { CairnStore } from '../store/open.js';
2
+ import { ScopeQuery } from '../core/scope.js';
3
+ import { EvidenceRecord, MemoryRecord, MemoryStatus, RevisionRecord } from '../core/types.js';
4
+ /**
5
+ * 导出(spec scoped-retrieval:与检索同一边界)。
6
+ *
7
+ * - 所有行逐行过 scopeAllowsRead;scopeIds 白名单同样生效且必须存在。
8
+ * - 【硬性】tombstoned 正文绝不进入 memories[],只以 hash+审计字段进入 tombstones[];
9
+ * superseded 记忆同理完全不进导出。
10
+ * - 每条 memory 携带库字段 contentHash(基于规范化正文),重复导入可幂等。
11
+ * - 只读:本函数不写库。
12
+ */
13
+ export interface ExportInput {
14
+ query: ScopeQuery;
15
+ /** 可选作用域白名单;为空数组时不过滤 scope。 */
16
+ scopeIds?: string[];
17
+ /** 默认 ['active'];tombstoned/superseded 仍然禁止。 */
18
+ statuses?: MemoryStatus[];
19
+ format: 'json' | 'markdown';
20
+ /** true 时附带 import_item(仅 scan_state='clean')。 */
21
+ includeArchives?: boolean;
22
+ }
23
+ export interface ExportCounts {
24
+ memories: number;
25
+ revisions: number;
26
+ evidence: number;
27
+ archives?: number;
28
+ }
29
+ export interface ExportOutput {
30
+ payload: string;
31
+ counts: ExportCounts;
32
+ }
33
+ export interface ExportScopeInfo {
34
+ id: string;
35
+ preset: string;
36
+ syncPolicy: string;
37
+ projectId: string | null;
38
+ deviceId: string;
39
+ agentId: string;
40
+ }
41
+ export interface ExportRelationInfo {
42
+ id: string;
43
+ fromMemoryId: string;
44
+ toMemoryId: string;
45
+ relationType: string;
46
+ }
47
+ export interface ExportMemoryEntry extends MemoryRecord {
48
+ revisions: RevisionRecord[];
49
+ evidence: EvidenceRecord[];
50
+ relations: ExportRelationInfo[];
51
+ }
52
+ export interface ExportTombstone {
53
+ memoryId: string;
54
+ contentHash: string;
55
+ forgottenAt: string;
56
+ reason: string | null;
57
+ forgottenBy: string;
58
+ }
59
+ export interface ExportArchiveItem {
60
+ itemIndex: number;
61
+ content: string;
62
+ contentHash: string;
63
+ sourceRef: string | null;
64
+ }
65
+ export interface ExportArchive {
66
+ id: string;
67
+ batchId: string;
68
+ parser: string;
69
+ items: ExportArchiveItem[];
70
+ }
71
+ export interface ExportDoc {
72
+ format: 'cairn-export';
73
+ version: 1;
74
+ exportedAt: string;
75
+ scopes: ExportScopeInfo[];
76
+ memories: ExportMemoryEntry[];
77
+ tombstones: ExportTombstone[];
78
+ archives?: ExportArchive[];
79
+ }
80
+ export declare function exportData(store: CairnStore, input: ExportInput): ExportOutput;