@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,399 @@
1
+ import { err } from '../core/errors.js';
2
+ import { nowIso } from '../core/time.js';
3
+ import { scanText } from '../core/secrets.js';
4
+ import { proposePlan } from '../governance/propose.js';
5
+ import { applyPlan } from '../governance/apply.js';
6
+ import { findDuplicate } from '../governance/dedup.js';
7
+ import { markItemPromoted, markItemSkipped, promotedPredicate } from './batches.js';
8
+ import { readReviewsIndex } from '../interfaces/console/review-store.js';
9
+ import { computeSuggestions } from '../interfaces/console/suggestions.js';
10
+ import { CONFIDENCE_SCORE, evaluatePolicy, requireUsablePolicy, } from './policy.js';
11
+ /** 找不到批次时与 AppService 用同一判定:最近一个还有未晋升 clean 条目的批次。 */
12
+ function pickBatchId(store, batchId) {
13
+ if (batchId) {
14
+ const exists = store.db.get('SELECT 1 AS x FROM import_item WHERE batch_id = ? LIMIT 1', batchId);
15
+ if (exists == null)
16
+ throw err('E_NOT_FOUND', `批次不存在: ${batchId}`);
17
+ return batchId;
18
+ }
19
+ const rows = store.db.all(`SELECT i.batch_id AS bid FROM import_item i
20
+ WHERE i.scan_state = 'clean' AND i.batch_id IS NOT NULL
21
+ AND ${promotedPredicate('i').notExists}
22
+ GROUP BY i.batch_id ORDER BY i.batch_id DESC LIMIT 1`);
23
+ if (rows.length === 0)
24
+ throw err('E_VALIDATION', '没有待整理的批次;请先 cairn import');
25
+ return String(rows[0].bid);
26
+ }
27
+ function resolveTargetScope(store, sel = {}) {
28
+ if (sel.scopeId)
29
+ return store.scopes.requireById(sel.scopeId);
30
+ const preset = sel.preset ?? 'personal-global';
31
+ if (preset === 'device-local')
32
+ return store.scopes.resolvePreset('device-local', { deviceId: store.identity.deviceId });
33
+ if (preset === 'project-global')
34
+ return store.scopes.resolvePreset('project-global', { projectId: sel.projectId });
35
+ return store.scopes.resolvePreset(preset, {});
36
+ }
37
+ /** 审计强制带策略标识:缺任一即拒绝写入(tasks 2.4)。 */
38
+ function recordPolicyAudit(store, action, policy, detail) {
39
+ const policyHashPrefix = policy.policyHash.slice(0, 8);
40
+ if (!policy.spec.id || !policyHashPrefix) {
41
+ throw err('E_FORBIDDEN', '自动整理审计缺少策略标识,拒绝写入');
42
+ }
43
+ store.audit.record('policy', action, { type: 'policy', id: policy.spec.id }, {
44
+ policyId: policy.spec.id,
45
+ policyHashPrefix,
46
+ ...detail,
47
+ });
48
+ }
49
+ function evidenceForItem(itemId, archiveId) {
50
+ return {
51
+ evidenceKind: 'import_ref',
52
+ importArchiveId: archiveId,
53
+ locator: `item:${itemId}`,
54
+ trustLevel: 'third_party',
55
+ };
56
+ }
57
+ export function runAutoOnboarding(store, input) {
58
+ store.assertWritable();
59
+ const policy = requireUsablePolicy(store.paths.home, input.policyId);
60
+ const batchId = pickBatchId(store, input.batchId);
61
+ const target = resolveTargetScope(store, input.scope);
62
+ // 策略白名单:preset 名与 scope id 都接受,但必须命中其一。
63
+ if (!policy.spec.allowedScopes.includes(target.preset) && !policy.spec.allowedScopes.includes(target.id)) {
64
+ throw err('E_FORBIDDEN', `目标作用域 ${target.preset}(${target.id}) 不在策略 ${policy.spec.id} 的允许集内`, {
65
+ allowedScopes: policy.spec.allowedScopes,
66
+ });
67
+ }
68
+ const rows = store.db.all('SELECT id, archive_id, content, scan_state FROM import_item WHERE batch_id = ? ORDER BY id', batchId);
69
+ const wanted = input.itemIds ? new Set(input.itemIds) : null;
70
+ // 已晋升过的条目默认不再处理:否则第二次运行会把它们重新走一遍 merge,
71
+ // 既不幂等,也会让"再跑一次看看"变成对记忆的额外扰动。
72
+ // 撤销(policy revoke)不会让它们自动回到这里——撤销必须是粘的,见 batches.ts。
73
+ const promoted = new Set(store.db
74
+ .all(`SELECT i.id AS id FROM import_item i WHERE i.batch_id = ? AND ${promotedPredicate('i').exists}`, batchId)
75
+ .map((r) => String(r.id)));
76
+ // 点名指定条目也是一次显式重做:调用方已经说清要哪几条了,不该再被
77
+ // "已晋升"静默过滤掉(那只会变成一条名为"不属于批次"的误导性报错)。
78
+ const redo = input.redo === true || wanted != null;
79
+ const selected = rows.filter((r) => (wanted == null || wanted.has(String(r.id))) && (redo || !promoted.has(String(r.id))));
80
+ if (wanted && selected.length !== wanted.size) {
81
+ const found = new Set(selected.map((r) => String(r.id)));
82
+ const missing = [...wanted].filter((id) => !found.has(id));
83
+ throw err('E_NOT_FOUND', `以下条目不属于批次 ${batchId}: ${missing.slice(0, 5).join(', ')}`, { missing });
84
+ }
85
+ // 规则层与 AI 层:各建一个按 itemId 的索引。
86
+ // redo 时必须让规则层连已晋升条目一起判:只放宽选择、不放宽规则层的话,
87
+ // 条目会被选中但拿不到建议,一路 needs_human → skip,重做等于空转。
88
+ const ruleItems = new Map();
89
+ for (const s of computeSuggestions(store, { batchId, includePromoted: redo }).items) {
90
+ ruleItems.set(s.itemId, s);
91
+ }
92
+ const aiIndex = readReviewsIndex(store);
93
+ const tiers = [];
94
+ const byCondition = {};
95
+ const byAction = {};
96
+ for (const row of selected) {
97
+ const itemId = String(row.id);
98
+ const content = String(row.content);
99
+ const scanState = String(row.scan_state) === 'blocked' ? 'blocked' : 'clean';
100
+ const rule = ruleItems.get(itemId);
101
+ const ai = aiIndex.get(itemId);
102
+ const dup = scanState === 'clean' ? findDuplicate(store.db, target.id, content) : null;
103
+ const ruleAction = rule?.action ?? 'needs_human';
104
+ // 重复内容的正确动作是并入,不是新建。
105
+ const effectiveRuleAction = dup ? 'merge' : ruleAction;
106
+ const hasConflict = rule?.targetMemoryId != null &&
107
+ store.db.get("SELECT 1 AS x FROM conflict WHERE memory_id = ? AND status = 'open' LIMIT 1", rule.targetMemoryId) != null;
108
+ const candidate = {
109
+ itemId,
110
+ scanState,
111
+ scope: target.preset,
112
+ // import_item 没有敏感度列:被判敏感的条目在导入阶段已进 blocked,这里恒为 normal。
113
+ sensitivity: 'normal',
114
+ hasConflict,
115
+ ruleAction: effectiveRuleAction,
116
+ aiAction: ai?.action ?? null,
117
+ aiConfidence: ai ? CONFIDENCE_SCORE[ai.confidence] : null,
118
+ isDuplicate: dup != null,
119
+ wouldCreate: effectiveRuleAction === 'promote' && dup == null,
120
+ };
121
+ const verdict = evaluatePolicy(candidate, policy);
122
+ const tier = verdict.ok ? 'auto' : 'manual';
123
+ if (!verdict.ok && verdict.failedCondition) {
124
+ byCondition[verdict.failedCondition] = (byCondition[verdict.failedCondition] ?? 0) + 1;
125
+ }
126
+ byAction[effectiveRuleAction] = (byAction[effectiveRuleAction] ?? 0) + 1;
127
+ tiers.push({
128
+ itemId,
129
+ tier,
130
+ action: effectiveRuleAction,
131
+ reason: rule?.reason ?? '规则层未给出建议',
132
+ failedCondition: verdict.failedCondition,
133
+ detail: verdict.detail,
134
+ });
135
+ }
136
+ const autoEntries = tiers.filter((t) => t.tier === 'auto');
137
+ const manual = tiers.length - autoEntries.length;
138
+ // 按作用域分组生成计划(tasks 2.2)。当前只有一个目标作用域,
139
+ // 分组结构与"不同 scope 不混进同一计划"的约束都在这里,将来多目标时直接生效。
140
+ const groups = new Map();
141
+ const rowById = new Map(selected.map((r) => [String(r.id), r]));
142
+ /** 判为跳过、需要在真实运行时落事实的条目。 */
143
+ const skippedToMark = [];
144
+ for (const entry of autoEntries) {
145
+ const row = rowById.get(entry.itemId);
146
+ const archiveId = String(row.archive_id);
147
+ const content = String(row.content);
148
+ if (entry.action === 'skip' || entry.action === 'needs_human') {
149
+ const g = groups.get(target.id) ?? { scopeId: target.id, items: [], skipped: 0 };
150
+ g.skipped += 1;
151
+ groups.set(target.id, g);
152
+ // 真实运行才落跳过事实(dry-run 零写入)。needs_human 不算跳过:
153
+ // 它表示"还没判完",把待人决定的条目当已处理会让队列静默漏项。
154
+ if (entry.action === 'skip')
155
+ skippedToMark.push({ itemId: entry.itemId, reasonCode: entry.reason });
156
+ continue;
157
+ }
158
+ // 内容已在目标作用域里存在(active 或 candidate):没有任何东西要新建。
159
+ // 治理层会把它记成 duplicate 并拒掉,结果就是"计划为空 → 抛错"——那不是异常,
160
+ // 是"没活干"。所以在这里先认出来,记成 skipped 而不是让它变成一次失败。
161
+ // 之所以连 merge 一起短路:opHint=merge 且正文与目标完全相同,也等于已并入。
162
+ const existing = findDuplicate(store.db, target.id, content);
163
+ if (existing != null) {
164
+ const g = groups.get(target.id) ?? { scopeId: target.id, items: [], skipped: 0 };
165
+ g.skipped += 1;
166
+ groups.set(target.id, g);
167
+ continue;
168
+ }
169
+ const opHint = entry.action === 'promote' ? 'add' : entry.action;
170
+ // merge 的目标要取**规则层指的那条**,不是按正文再查一次:
171
+ // 规则层的合并建议针对"语义近似但正文不同"的条目,按正文查重根本查不到它,
172
+ // 拿查重结果当目标就会把 merge 静默降级成 add,多出一条重复记忆。
173
+ const mergeTarget = entry.action === 'merge' ? ruleItems.get(entry.itemId)?.targetMemoryId ?? undefined : undefined;
174
+ const item = {
175
+ itemId: entry.itemId,
176
+ content,
177
+ kind: 'fact',
178
+ opHint: opHint === 'merge' || opHint === 'keep_both' || opHint === 'add' ? opHint : 'add',
179
+ targetMemoryId: mergeTarget,
180
+ reason: `policy:${policy.spec.id} ${entry.reason}`.slice(0, 400),
181
+ evidence: [evidenceForItem(entry.itemId, archiveId)],
182
+ };
183
+ const g = groups.get(target.id) ?? { scopeId: target.id, items: [], skipped: 0 };
184
+ g.items.push(item);
185
+ groups.set(target.id, g);
186
+ }
187
+ const summary = {
188
+ policyId: policy.spec.id,
189
+ policyHashPrefix: policy.policyHash.slice(0, 8),
190
+ batchId,
191
+ scopeId: target.id,
192
+ scopeName: target.preset,
193
+ dryRun: input.dryRun === true,
194
+ totalItems: selected.length,
195
+ auto: autoEntries.length,
196
+ manual,
197
+ applied: 0,
198
+ skipped: 0,
199
+ failed: 0,
200
+ byCondition,
201
+ byAction,
202
+ failures: [],
203
+ plans: [],
204
+ balanced: false,
205
+ tiers,
206
+ };
207
+ if (input.dryRun === true) {
208
+ summary.skipped = autoEntries.filter((e) => e.action === 'skip' || e.action === 'needs_human').length;
209
+ summary.balanced = summary.auto + summary.manual === summary.totalItems;
210
+ return summary;
211
+ }
212
+ const archiveIds = [...new Set(selected.map((r) => String(r.archive_id)))];
213
+ const channel = `policy:${policy.spec.id}:${policy.policyHash.slice(0, 8)}`;
214
+ for (const g of groups.values()) {
215
+ summary.skipped += g.skipped;
216
+ if (g.items.length === 0)
217
+ continue;
218
+ const proposed = proposePlan(store, {
219
+ scopeId: g.scopeId,
220
+ items: g.items,
221
+ sourceArchiveIds: archiveIds,
222
+ proposedBy: `policy:${policy.spec.id}`,
223
+ scan: scanText,
224
+ });
225
+ for (const r of proposed.rejected) {
226
+ // 同批重复(repeatOf:<itemId>)不是失败:那一条的正文已经并进保留项,
227
+ // 记成 E_PLAN_INVALID 会让汇总冒出几十个"失败",读起来像程序出错了。
228
+ // 真正的拒绝(秘密/注入/itemId 不存在)才算失败。
229
+ if (/^repeatOf:/.test(r.reason)) {
230
+ summary.skipped += 1;
231
+ summary.failures.push({
232
+ itemId: r.itemId ?? '(未绑定)',
233
+ code: 'E_DUPLICATE',
234
+ message: '同批重复:正文已并入保留项,证据已合并',
235
+ });
236
+ continue;
237
+ }
238
+ summary.failed += 1;
239
+ summary.failures.push({ itemId: r.itemId ?? '(未绑定)', code: 'E_PLAN_INVALID', message: r.reason });
240
+ }
241
+ for (const d of proposed.duplicates) {
242
+ // 库内已有同内容:并入既有记忆即可,不计失败。
243
+ summary.skipped += 1;
244
+ summary.failures.push({
245
+ itemId: d.itemId ?? '(未绑定)',
246
+ code: 'E_DUPLICATE',
247
+ message: `已并入既有记忆 ${d.duplicateOfMemoryId}`,
248
+ });
249
+ }
250
+ // 证据合并:把批内被合并条目的证据并到保留项(spec memory-governance)。
251
+ const evidenceByItem = {};
252
+ for (const it of g.items)
253
+ if (it.itemId)
254
+ evidenceByItem[it.itemId] = [...(it.evidence ?? [])];
255
+ for (const r of proposed.rejected) {
256
+ const m = /^repeatOf:([^\s]+)/.exec(r.reason);
257
+ if (!m || m[1] === '?' || !r.itemId)
258
+ continue;
259
+ const keep = m[1];
260
+ const src = rowById.get(r.itemId);
261
+ if (!src)
262
+ continue;
263
+ (evidenceByItem[keep] ??= []).push(evidenceForItem(r.itemId, String(src.archive_id)));
264
+ }
265
+ if (proposed.accepted === 0) {
266
+ summary.plans.push({
267
+ planId: proposed.plan.id,
268
+ scopeId: g.scopeId,
269
+ ops: 0,
270
+ applied: 0,
271
+ skipped: 0,
272
+ failed: 0,
273
+ approvalId: '',
274
+ });
275
+ continue;
276
+ }
277
+ const { approval } = store.plans.issueApproval({
278
+ planId: proposed.plan.id,
279
+ channel,
280
+ approvedBy: 'local_cli',
281
+ ttlMs: input.ttlMs,
282
+ });
283
+ const report = applyPlan(store, {
284
+ planId: proposed.plan.id,
285
+ approvalId: approval.id,
286
+ deviceId: store.identity.deviceId,
287
+ scan: scanText,
288
+ evidenceByItem,
289
+ });
290
+ // 必须把条目标记为已晋升,否则下一次运行会把它当成未处理、再走一遍 merge。
291
+ // AppService.applyPlan 里做了这件事,这里直接调治理层,得自己补。
292
+ // 不吞错:markItemPromoted 现在只在"原目标记忆仍在、却要改挂到另一条"时抛
293
+ // E_CONFLICT_STATE,那是真实的状态冲突,吞掉会让后续幂等判断全部错位。
294
+ const ops = store.plans.ops(proposed.plan.id);
295
+ for (const res of report.results) {
296
+ const op = ops.find((o) => o.opIndex === res.opIndex);
297
+ if (op?.itemId && res.memoryId) {
298
+ markItemPromoted(store, op.itemId, res.memoryId);
299
+ }
300
+ }
301
+ summary.applied += report.applied;
302
+ summary.skipped += report.skipped;
303
+ summary.failed += report.failed;
304
+ // results 只含成功落库的操作;失败数由 report.failed 给出,具体原因在 apply 的审计里。
305
+ if (report.failed > 0) {
306
+ summary.failures.push({
307
+ itemId: `(plan:${proposed.plan.id})`,
308
+ code: 'E_APPLY_PARTIAL',
309
+ message: `${report.failed} 条在应用阶段失败`,
310
+ });
311
+ }
312
+ summary.plans.push({
313
+ planId: proposed.plan.id,
314
+ scopeId: g.scopeId,
315
+ ops: proposed.accepted,
316
+ applied: report.applied,
317
+ skipped: report.skipped,
318
+ failed: report.failed,
319
+ approvalId: approval.id,
320
+ });
321
+ const memoryIds = report.results
322
+ .map((r) => r.memoryId)
323
+ .filter((id) => typeof id === 'string')
324
+ .slice(0, 1000);
325
+ recordPolicyAudit(store, 'auto_applied', policy, {
326
+ batchId,
327
+ planId: proposed.plan.id,
328
+ approvalId: approval.id,
329
+ channel,
330
+ applied: report.applied,
331
+ skipped: report.skipped,
332
+ failed: report.failed,
333
+ memoryIds,
334
+ note: policy.spec.note,
335
+ at: nowIso(),
336
+ });
337
+ }
338
+ // 判为跳过的条目落"跳过"事实:它们因此退出待处理队列,但仍可查询
339
+ // (listSkippedItems)。放在这里而不是 skip 分支,是因为只有走到这一步才是
340
+ // 真实运行——dry-run 在上面已经 return,零写入。
341
+ for (const s2 of skippedToMark) {
342
+ markItemSkipped(store, s2.itemId, {
343
+ basis: 'rule',
344
+ ...(s2.reasonCode ? { reasonCode: s2.reasonCode } : {}),
345
+ });
346
+ }
347
+ summary.balanced = summary.applied + summary.skipped + summary.failed + summary.manual === summary.totalItems;
348
+ return summary;
349
+ }
350
+ /**
351
+ * 按策略撤销(design D7):转 tombstone 而不物理删除,并且让同一批次可以被重新整理
352
+ * ——判定不认 tombstoned,所以重新整理不会撞上自己留下的墓碑。
353
+ */
354
+ export function revokeByPolicy(store, policyId, opts = {}) {
355
+ store.assertWritable();
356
+ const rows = store.db.all("SELECT detail FROM audit_event WHERE category = 'policy' AND action = 'auto_applied' ORDER BY at");
357
+ const ids = new Set();
358
+ // 整策略撤销(不带 batchId)也必须说清"撤了哪几批":审计里只写 batchId:null
359
+ // 的话,界面与后续排查都无法把撤销挂回某个批次,会表现为"撤了但看不出撤过"。
360
+ const touchedBatches = new Set();
361
+ for (const row of rows) {
362
+ let detail;
363
+ try {
364
+ detail = JSON.parse(String(row.detail));
365
+ }
366
+ catch {
367
+ continue;
368
+ }
369
+ if (detail['policyId'] !== policyId)
370
+ continue;
371
+ if (opts.batchId != null && detail['batchId'] !== opts.batchId)
372
+ continue;
373
+ if (typeof detail['batchId'] === 'string')
374
+ touchedBatches.add(detail['batchId']);
375
+ const list = detail['memoryIds'];
376
+ if (!Array.isArray(list))
377
+ continue;
378
+ for (const id of list)
379
+ if (typeof id === 'string')
380
+ ids.add(id);
381
+ }
382
+ let tombstoned = 0;
383
+ for (const id of ids) {
384
+ const mem = store.memories.get(id);
385
+ if (!mem || mem.status === 'tombstoned')
386
+ continue;
387
+ store.memories.forget(id, `按策略 ${policyId} 撤销自动整理结果`, `policy:${policyId}`);
388
+ tombstoned += 1;
389
+ }
390
+ store.audit.record('policy', 'revoked', { type: 'policy', id: policyId }, {
391
+ policyId,
392
+ batchId: opts.batchId ?? null,
393
+ /** 实际被这次撤销覆盖的批次;整策略撤销时 batchId 为 null,靠这个字段挂得回去。 */
394
+ batchIds: [...touchedBatches],
395
+ tombstoned,
396
+ });
397
+ return { tombstoned, memoryIds: [...ids] };
398
+ }
399
+ //# sourceMappingURL=auto.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"auto.js","sourceRoot":"","sources":["../../../src/onboarding/auto.ts"],"names":[],"mappings":"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"}
@@ -0,0 +1,103 @@
1
+ import { CairnStore } from '../store/open.js';
2
+ /**
3
+ * 「这条导入条目已经晋升过了吗」的唯一出处。
4
+ *
5
+ * 语义刻意只认审计事实:**晋升过就是晋升过**,与目标记忆后来变成 active、
6
+ * archived 还是 tombstoned 无关。
7
+ *
8
+ * 为什么不能跟着记忆状态走:撤销(policy revoke)会把记忆转 tombstone。如果
9
+ * 谓词随之失效,条目就自动回到"待整理",下一次普通运行会**把用户刚撤销的
10
+ * 记忆重新写回来**——撤销于是变成一次性的,定时任务或续跑都能把它翻掉。
11
+ * 真正的"重做"必须显式:`onboarding auto --redo`(选条目 + 规则层都重新判)。
12
+ *
13
+ * 调用方一律用它,不要自己手写 EXISTS 子句:这个谓词曾经在 6 个文件里各写一遍,
14
+ * 改语义时漏掉任何一处,各处行为就会互相矛盾。
15
+ */
16
+ export interface LedgerPredicate {
17
+ /** 已晋升(确实生成了记忆)。语义与历史保持一致,不因本次扩展而改变。 */
18
+ exists: string;
19
+ notExists: string;
20
+ /** 已跳过(判定为不采用)。 */
21
+ skippedExists: string;
22
+ skippedNotExists: string;
23
+ /** 已处理完毕 = 已晋升 OR 已跳过。用于「这条还需要处理吗」。 */
24
+ handledExists: string;
25
+ handledNotExists: string;
26
+ }
27
+ export declare function promotedPredicate(alias?: string): LedgerPredicate;
28
+ export interface BatchProgress {
29
+ batchId: string;
30
+ total: number;
31
+ clean: number;
32
+ blocked: number;
33
+ promoted: number;
34
+ /** 已判定不采用(item_skipped)。与 promoted 互不重叠,但仍可查询。 */
35
+ skipped: number;
36
+ /** clean 且既未晋升也未跳过:当前 Agent 还要处理的剩余量(中断续跑的游标语义)。 */
37
+ remaining: number;
38
+ }
39
+ export interface BatchChunkItem {
40
+ itemId: string;
41
+ archiveId: string;
42
+ content: string;
43
+ sourceRef: string | null;
44
+ contentHash: string;
45
+ }
46
+ /**
47
+ * 给 archive 未分批(batch_id IS NULL)条目补 batchId;幂等:
48
+ * 档案内已有任何批次号时收敛到既有批次(按 item_index 最早一条),
49
+ * 没有则生成新批次。返回该 archive 条目所属的 batchId。
50
+ */
51
+ export declare function assignBatch(store: CairnStore, archiveId: string): string;
52
+ /** 批次进度:按 import_item.scan_state 与晋升审计标记(审计即状态)统计。 */
53
+ export declare function batchProgress(store: CairnStore, batchId: string): BatchProgress;
54
+ /**
55
+ * 下一批待处理切片:scan_state='clean' 且尚未晋升的条目,有界 limit,
56
+ * 供当前 Agent 生成建议。已晋升的条目永不再返回——这就是会话中断续跑的
57
+ * 持久化游标。blocked 条目(秘密/注入命中)在任何情况下都不会进入批次。
58
+ */
59
+ export declare function nextBatchChunk(store: CairnStore, batchId: string, limit: number): BatchChunkItem[];
60
+ /**
61
+ * 晋升标记:真实批准并晋升为正式记忆后调用。写 audit_event
62
+ * (category='onboarding', action='item_promoted',detail 含 itemId+memoryId)。
63
+ * 幂等:同一 (itemId, memoryId) 重复标记不产生第二条审计;同一 itemId 晋升到
64
+ * 不同 memoryId 视为状态改写,抛 E_CONFLICT_STATE。
65
+ *
66
+ * 例外:原目标记忆已被遗忘(tombstone)时允许改挂到新记忆。撤销(policy revoke)
67
+ * 之后再整理必然会走到这里——旧记忆已经不存在,再死守旧映射只会让条目永远卡在
68
+ * "已晋升"。此时追加一条审计,旧的保留在历史里(审计只增不改),判定以新的一条为准。
69
+ *
70
+ * 调用方契约:只允许对 scan_state='clean' 的条目调用(blocked 条目已被
71
+ * nextBatchChunk 排除在批次之外,活动记忆侧另有 DB 触发器兜底)。
72
+ */
73
+ export declare function markItemPromoted(store: CairnStore, itemId: string, memoryId: string): void;
74
+ /** 跳过依据的类别:规则层、AI 复核判断、或显式 decision。 */
75
+ export type SkipBasis = 'rule' | 'judgement' | 'decision';
76
+ /**
77
+ * 跳过标记:判定某条导入条目不采用时调用。
78
+ *
79
+ * 写 audit_event(category='onboarding', action='item_skipped',
80
+ * detail 含 itemId/basis/reasonCode)。**detail 不含正文**——审计不是内容存储,
81
+ * 正文可能含敏感内容,理由原文留在复核记录里按 itemId 关联。
82
+ *
83
+ * 幂等:同一 (itemId, basis) 重复标记不产生第二条审计。
84
+ * blocked 条目拒绝标记(它们根本没有进入待处理队列的资格)。
85
+ */
86
+ export declare function markItemSkipped(store: CairnStore, itemId: string, input: {
87
+ basis: SkipBasis;
88
+ reasonCode?: string;
89
+ }): void;
90
+ /** 已跳过条目(供「已跳过」视图查询)。 */
91
+ export interface SkippedItem {
92
+ itemId: string;
93
+ basis: string;
94
+ reasonCode: string | null;
95
+ at: string;
96
+ }
97
+ /**
98
+ * 某批次的已跳过条目。
99
+ *
100
+ * 跳过的条目要从待处理队列出队,但不能从视野里消失——这正是本次变更的取舍:
101
+ * remaining 只数真正待处理的,已跳过的另给一个可查入口。
102
+ */
103
+ export declare function listSkippedItems(store: CairnStore, batchId: string, limit?: number): SkippedItem[];