@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,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;
@@ -0,0 +1,215 @@
1
+ import { scopeAllowsRead } from '../core/scope.js';
2
+ import { MEMORY_STATUSES, } from '../core/types.js';
3
+ import { err } from '../core/errors.js';
4
+ import { nowIso } from '../core/time.js';
5
+ import { mapMemory } from '../store/memories.js';
6
+ // ---------------------------------------------------------------------------
7
+ // 校验(与检索同规则)
8
+ // ---------------------------------------------------------------------------
9
+ function validateQueryIdentity(query) {
10
+ if (query == null ||
11
+ typeof query.deviceId !== 'string' ||
12
+ typeof query.agentId !== 'string' ||
13
+ query.deviceId === '' ||
14
+ query.agentId === '') {
15
+ throw err('E_VALIDATION', '检索/导出必须提供调用方身份(deviceId 与 agentId 均非空)');
16
+ }
17
+ }
18
+ function validateStatuses(statuses) {
19
+ for (const s of statuses) {
20
+ if (!MEMORY_STATUSES.includes(s)) {
21
+ throw err('E_VALIDATION', `未知记忆状态: ${String(s)}`);
22
+ }
23
+ if (s === 'tombstoned' || s === 'superseded') {
24
+ throw err('E_VALIDATION', `状态 ${s} 永远不可检索或导出`);
25
+ }
26
+ }
27
+ return [...new Set(statuses)];
28
+ }
29
+ function validateScopeIds(store, scopeIds) {
30
+ if (scopeIds == null)
31
+ return;
32
+ if (!Array.isArray(scopeIds))
33
+ throw err('E_VALIDATION', 'scopeIds 必须是字符串数组');
34
+ for (const id of scopeIds) {
35
+ if (typeof id !== 'string' || id === '')
36
+ throw err('E_VALIDATION', 'scopeIds 必须是非空字符串数组');
37
+ }
38
+ for (const id of scopeIds)
39
+ store.scopes.requireById(id);
40
+ }
41
+ // ---------------------------------------------------------------------------
42
+ // 共用读取判定(与检索/详情/投影同一边界)
43
+ // ---------------------------------------------------------------------------
44
+ function makeScopeChecker(store, query) {
45
+ const cache = new Map();
46
+ return (scopeId) => {
47
+ if (!cache.has(scopeId))
48
+ cache.set(scopeId, store.scopes.getById(scopeId));
49
+ const row = cache.get(scopeId);
50
+ return row != null && scopeAllowsRead(row, query);
51
+ };
52
+ }
53
+ // ---------------------------------------------------------------------------
54
+ // 主入口
55
+ // ---------------------------------------------------------------------------
56
+ export function exportData(store, input) {
57
+ if (input.format !== 'json' && input.format !== 'markdown') {
58
+ throw err('E_VALIDATION', `format 必须是 'json' 或 'markdown',收到 ${String(input.format)}`);
59
+ }
60
+ validateQueryIdentity(input.query);
61
+ const statuses = validateStatuses(input.statuses ?? ['active']);
62
+ validateScopeIds(store, input.scopeIds);
63
+ const now = nowIso();
64
+ const isReadable = makeScopeChecker(store, input.query);
65
+ const scopeFilter = input.scopeIds != null && input.scopeIds.length > 0 ? input.scopeIds : null;
66
+ // 1. 记忆集合:statuses + scopeIds 前置过滤,再逐行 scopeAllowsRead
67
+ const statusPh = statuses.map(() => '?').join(',');
68
+ const scopeConds = [`status IN (${statusPh})`];
69
+ const baseParams = [...statuses];
70
+ if (scopeFilter != null) {
71
+ scopeConds.push(`scope_id IN (${scopeFilter.map(() => '?').join(',')})`);
72
+ baseParams.push(...scopeFilter);
73
+ }
74
+ const where = scopeConds.join(' AND ');
75
+ const scopeIdsUsed = new Set();
76
+ const memoryEntries = [];
77
+ let revisionsTotal = 0;
78
+ let evidenceTotal = 0;
79
+ for (const row of store.db.all(`SELECT * FROM memory WHERE ${where} ORDER BY created_at, id`, ...baseParams)) {
80
+ const memory = mapMemory(row);
81
+ // 硬性边界兜底:这两类状态即使被写入也不得进入导出正文
82
+ if (memory.status === 'tombstoned' || memory.status === 'superseded')
83
+ continue;
84
+ if (!isReadable(memory.scopeId))
85
+ continue;
86
+ scopeIdsUsed.add(memory.scopeId);
87
+ const revisions = store.memories.revisions(memory.id);
88
+ const evidence = store.memories.evidence(memory.id);
89
+ const relations = store.memories.relationsOf(memory.id);
90
+ revisionsTotal += revisions.length;
91
+ evidenceTotal += evidence.length;
92
+ memoryEntries.push({ ...memory, revisions, evidence, relations });
93
+ }
94
+ // 2. 遗忘清单:只有 hash + 审计字段,绝无正文
95
+ const tombstones = [];
96
+ for (const row of store.db.all(`SELECT * FROM memory WHERE status = 'tombstoned' ${scopeFilter != null ? `AND scope_id IN (${scopeFilter.map(() => '?').join(',')})` : ''} ORDER BY created_at, id`, ...(scopeFilter != null ? scopeFilter : []))) {
97
+ const memory = mapMemory(row);
98
+ if (!isReadable(memory.scopeId))
99
+ continue;
100
+ scopeIdsUsed.add(memory.scopeId);
101
+ const t = store.memories.getTombstone(memory.id);
102
+ if (t == null)
103
+ continue;
104
+ tombstones.push({
105
+ memoryId: memory.id,
106
+ contentHash: t.contentHash,
107
+ forgottenAt: t.forgottenAt,
108
+ reason: t.reason,
109
+ forgottenBy: t.forgottenBy,
110
+ });
111
+ }
112
+ // 3. 作用域清单:仅导出实际贡献内容的 scopes(不枚举无关作用域)
113
+ const scopes = [...scopeIdsUsed].map((id) => {
114
+ const s = store.scopes.requireById(id);
115
+ return { id: s.id, preset: s.preset, syncPolicy: s.syncPolicy, projectId: s.projectId, deviceId: s.deviceId, agentId: s.agentId };
116
+ });
117
+ // 4. 导入档案:仅 scan_state='clean' 条目
118
+ let archives;
119
+ if (input.includeArchives === true) {
120
+ archives = store.archives.list().map((a) => ({
121
+ id: a.id,
122
+ batchId: a.batchId,
123
+ parser: a.parser,
124
+ items: store.archives.listItems(a.id, { scanState: 'clean' }).map((it) => ({
125
+ itemIndex: it.itemIndex,
126
+ content: it.content,
127
+ contentHash: it.contentHash,
128
+ sourceRef: it.sourceRef,
129
+ })),
130
+ }));
131
+ }
132
+ const counts = {
133
+ memories: memoryEntries.length,
134
+ revisions: revisionsTotal,
135
+ evidence: evidenceTotal,
136
+ ...(archives != null ? { archives: archives.length } : {}),
137
+ };
138
+ const payload = input.format === 'json'
139
+ ? renderJson({ format: 'cairn-export', version: 1, exportedAt: now, scopes, memories: memoryEntries, tombstones, ...(archives != null ? { archives } : {}) })
140
+ : renderMarkdown(now, scopes, memoryEntries, tombstones, archives, counts);
141
+ return { payload, counts };
142
+ }
143
+ function renderJson(doc) {
144
+ return JSON.stringify(doc, null, 2);
145
+ }
146
+ // ---------------------------------------------------------------------------
147
+ // Markdown 投影:按作用域分组的人类可读导出,正文保留
148
+ // ---------------------------------------------------------------------------
149
+ function renderMarkdown(exportedAt, scopes, memories, tombstones, archives, counts) {
150
+ const lines = [];
151
+ lines.push('# cairn managed export', '');
152
+ lines.push(`- exportedAt: ${exportedAt}`);
153
+ lines.push('- format: cairn-export v1');
154
+ lines.push(`- memories: ${counts.memories}, revisions: ${counts.revisions}, evidence: ${counts.evidence}${counts.archives != null ? `, archives: ${counts.archives}` : ''}`);
155
+ lines.push('');
156
+ for (const s of scopes) {
157
+ lines.push(`## Scope ${s.preset} (${s.id})`, '');
158
+ lines.push(`- project: ${s.projectId ?? '-'} / device: ${s.deviceId} / agent: ${s.agentId} / syncPolicy: ${s.syncPolicy}`, '');
159
+ for (const m of memories.filter((x) => x.scopeId === s.id)) {
160
+ lines.push(`### [${m.status}] ${m.kind} ${m.id}`);
161
+ lines.push(`- authority: ${m.authority} / confidence: ${m.confidence} / sensitivity: ${m.sensitivity}`);
162
+ lines.push(`- observedAt: ${m.observedAt} / contentHash: ${m.contentHash}`);
163
+ lines.push('- content:');
164
+ for (const line of m.content.split(/\r?\n/))
165
+ lines.push(line);
166
+ lines.push('');
167
+ if (m.revisions.length > 0) {
168
+ lines.push('#### revisions');
169
+ for (const r of m.revisions) {
170
+ lines.push(`- seq ${r.seq} by ${r.author} at ${r.createdAt}${r.reason != null ? ` reason: ${r.reason}` : ''}`);
171
+ for (const line of r.content.split(/\r?\n/))
172
+ lines.push(` ${line}`);
173
+ }
174
+ lines.push('');
175
+ }
176
+ if (m.evidence.length > 0) {
177
+ lines.push('#### evidence');
178
+ for (const e of m.evidence) {
179
+ lines.push(`- ${e.evidenceKind} trust=${e.trustLevel}${e.locator != null ? ` locator=${e.locator}` : ''}${e.importArchiveId != null ? ` archive=${e.importArchiveId}` : ''}`);
180
+ }
181
+ lines.push('');
182
+ }
183
+ if (m.relations.length > 0) {
184
+ lines.push('#### relations');
185
+ for (const rel of m.relations) {
186
+ lines.push(`- ${rel.relationType} ${rel.fromMemoryId} <-> ${rel.toMemoryId}`);
187
+ }
188
+ lines.push('');
189
+ }
190
+ }
191
+ }
192
+ lines.push('## Forgotten memories (tombstones)', '');
193
+ if (tombstones.length === 0)
194
+ lines.push('(none)', '');
195
+ for (const t of tombstones) {
196
+ lines.push(`- ${t.memoryId} contentHash=${t.contentHash} forgottenAt=${t.forgottenAt} forgottenBy=${t.forgottenBy} reason=${t.reason ?? '-'}`);
197
+ }
198
+ lines.push('');
199
+ if (archives != null) {
200
+ lines.push('## Import archives (clean items only)', '');
201
+ if (archives.length === 0)
202
+ lines.push('(none)', '');
203
+ for (const a of archives) {
204
+ lines.push(`### archive ${a.id} batch=${a.batchId} parser=${a.parser}`);
205
+ for (const it of a.items) {
206
+ lines.push(`- item ${it.itemIndex} contentHash=${it.contentHash} sourceRef=${it.sourceRef ?? '-'}`);
207
+ for (const line of it.content.split(/\r?\n/))
208
+ lines.push(` ${line}`);
209
+ }
210
+ lines.push('');
211
+ }
212
+ }
213
+ return lines.join('\n');
214
+ }
215
+ //# sourceMappingURL=export.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"export.js","sourceRoot":"","sources":["../../../src/retrieval/export.ts"],"names":[],"mappings":"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"}
@@ -0,0 +1,5 @@
1
+ /**
2
+ * 检索与导出公共入口(design D5 / spec scoped-retrieval)。
3
+ */
4
+ export * from './search.js';
5
+ export * from './export.js';