@jjh32456/dsh-longlive 1.6.7 → 1.8.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 (289) hide show
  1. package/CHANGELOG.md +70 -1508
  2. package/LICENSE +1 -1
  3. package/QUICKSTART.md +34 -13
  4. package/README.en.md +18 -7
  5. package/README.md +34 -9
  6. package/SPEC.md +5 -5
  7. package/cordis.patch.yml +23 -9
  8. package/docs/ANSWER-GUARD.md +92 -0
  9. package/docs/ARCHITECTURE.md +4 -3
  10. package/docs/AUTO-RECALL-WIRING.md +1 -1
  11. package/docs/AUTO-RECALL.md +15 -9
  12. package/docs/CONFIG.md +168 -35
  13. package/docs/ERRORS.md +17 -5
  14. package/docs/FAQ.md +7 -7
  15. package/docs/FEATURES.md +96 -28
  16. package/docs/MIGRATION-1.6.0.md +2 -2
  17. package/docs/OPERATIONS.md +6 -6
  18. package/docs/PANEL-INTEGRATION.md +6 -0
  19. package/docs/PRIVACY.md +88 -0
  20. package/docs/QUICKSTART.md +5 -5
  21. package/docs/README.en.md +4 -2
  22. package/docs/RESIDENT-WATCHER.md +1 -1
  23. package/docs/SESSION-WATCH.md +6 -6
  24. package/docs/TROUBLESHOOTING.md +4 -4
  25. package/package.json +47 -117
  26. package/runbook.md +2 -2
  27. package/scripts/backfill-auto-cards.mjs +98 -0
  28. package/scripts/install-surgery-task.ps1 +5 -2
  29. package/scripts/lib/session-watch-fixture.mjs +1 -1
  30. package/scripts/longlive-doctor.mjs +6 -0
  31. package/scripts/migrate-180.mjs +163 -0
  32. package/scripts/recall-index-build.mjs +128 -0
  33. package/scripts/session-watch-drill.mjs +1 -1
  34. package/scripts/surgery-run.cmd +1 -1
  35. package/scripts/unattended-surgery.ps1 +5 -2
  36. package/scripts/verify-card-anchors.mjs +138 -0
  37. package/src/actions/audit.js +125 -0
  38. package/src/actions/evidence.js +122 -0
  39. package/src/actions/fs.js +162 -0
  40. package/src/activity/index.js +760 -0
  41. package/src/activity/model.js +351 -0
  42. package/src/activity/store.js +644 -0
  43. package/src/activity/thinking.js +176 -0
  44. package/src/adapters/constants.js +11 -0
  45. package/src/adapters/engram/data/aliases.json +51 -0
  46. package/src/adapters/engram/data/policy.json +8 -0
  47. package/src/adapters/engram/data/routing-rules.json +546 -0
  48. package/src/adapters/engram/index.js +235 -0
  49. package/src/adapters/registry.js +315 -0
  50. package/src/answer/audit.js +193 -0
  51. package/src/answer/evidence.js +30 -0
  52. package/src/answer/guard.js +1370 -0
  53. package/src/answer/index.js +1067 -0
  54. package/src/answer/query.js +111 -0
  55. package/src/answer/second-hop.mjs +101 -0
  56. package/src/auto-truncate.js +1 -1
  57. package/src/config.js +171 -47
  58. package/src/deps.js +6 -4
  59. package/src/features.js +182 -6
  60. package/src/heartbeat.js +156 -23
  61. package/src/identity/handover.js +52 -1
  62. package/src/identity/index.js +13 -5
  63. package/src/identity/inject-position.js +2 -2
  64. package/src/index.js +97 -7
  65. package/src/lifecycle/gap-clocks.js +328 -0
  66. package/src/lifecycle/index.js +269 -0
  67. package/src/live.js +22 -2
  68. package/src/memory/activity-capture.js +229 -0
  69. package/src/memory/anchors.js +194 -0
  70. package/src/memory/audit-records.js +222 -0
  71. package/src/memory/auto-cards.js +401 -0
  72. package/src/memory/capture.js +442 -0
  73. package/src/memory/card-anchors.js +203 -0
  74. package/src/memory/conflicts.js +106 -0
  75. package/src/memory/decay.js +311 -0
  76. package/src/memory/distill.js +471 -0
  77. package/src/memory/event-index.js +917 -0
  78. package/src/memory/evidence-chain.js +295 -0
  79. package/src/memory/evidence.js +145 -0
  80. package/src/memory/filter-runner.js +1 -1
  81. package/src/memory/filter.js +5 -1
  82. package/src/memory/forget-v2.js +410 -0
  83. package/src/memory/forget.js +71 -0
  84. package/src/memory/frames-activation.js +247 -0
  85. package/src/memory/fts-query.js +174 -0
  86. package/src/memory/governance.js +604 -0
  87. package/src/memory/index.js +1 -0
  88. package/src/memory/l2-gate.js +169 -0
  89. package/src/memory/lock.js +121 -0
  90. package/src/memory/migrate.js +139 -0
  91. package/src/memory/recall-v2.js +223 -0
  92. package/src/memory/recall.js +65 -2
  93. package/src/memory/records.js +425 -0
  94. package/src/memory/retention.js +128 -0
  95. package/src/memory/review.js +124 -0
  96. package/src/memory/trust.js +88 -0
  97. package/src/memory/version-chain.js +264 -0
  98. package/src/memory/wal.js +137 -0
  99. package/src/memory/working-frame.js +516 -0
  100. package/src/metrics/classify.mjs +5 -3
  101. package/src/metrics/index.mjs +21 -1
  102. package/src/metrics/prestep-latency.mjs +300 -0
  103. package/src/metrics/store.mjs +25 -0
  104. package/src/policy-profile.js +18 -3
  105. package/src/recall/anaphora.mjs +87 -0
  106. package/src/recall/cards.mjs +7 -0
  107. package/src/recall/embedding.mjs +8 -8
  108. package/src/recall/entities.mjs +112 -0
  109. package/src/recall/index.js +235 -19
  110. package/src/recall/inject-order.mjs +10 -8
  111. package/src/recall/privacy.mjs +105 -16
  112. package/src/recall/recall-core.mjs +116 -10
  113. package/src/recall/shared-visibility.js +302 -0
  114. package/src/recall/time-normalizer.mjs +196 -0
  115. package/src/role/activation.js +191 -0
  116. package/src/role/attention.js +318 -0
  117. package/src/role/base.js +36 -0
  118. package/src/role/channels.js +423 -0
  119. package/src/role/index.js +425 -0
  120. package/src/role/interfaces.js +115 -0
  121. package/src/role/personality.js +370 -0
  122. package/src/role/readers.js +151 -0
  123. package/src/role/relationships.js +477 -0
  124. package/src/role/store.js +202 -0
  125. package/src/role/writeprotect.js +373 -0
  126. package/src/router/aliases.json +176 -25
  127. package/src/router/background/agent-runner.mjs +1 -1
  128. package/src/router/background/anchor.mjs +1 -1
  129. package/src/router/background/audit.mjs +2 -2
  130. package/src/router/background/budget-ledger.mjs +2 -2
  131. package/src/router/background/host-sim.mjs +1 -1
  132. package/src/router/background/memory.mjs +4 -4
  133. package/src/router/background/queue.mjs +1 -1
  134. package/src/router/background/retry.mjs +1 -1
  135. package/src/router/background/router.mjs +1 -1
  136. package/src/router/background/stream.mjs +1 -1
  137. package/src/router/background/tool-policy.mjs +1 -1
  138. package/src/router/design-headings.json +5 -5
  139. package/src/router/face/config.mjs +1 -1
  140. package/src/router/face/identity.mjs +3 -3
  141. package/src/router/judge.mjs +8 -7
  142. package/src/router/policies/generic.json +21 -4
  143. package/src/router/route.js +109 -22
  144. package/src/router/router.mjs +10 -6
  145. package/src/router/routing-rules.json +260 -445
  146. package/src/router/run-sim.mjs +8 -8
  147. package/src/router/runtime.js +23 -12
  148. package/src/router/service/board.mjs +95 -15
  149. package/src/router/service/config.mjs +5 -5
  150. package/src/router/service/context.mjs +1 -1
  151. package/src/router/service/hint.mjs +14 -0
  152. package/src/router/service/queue.mjs +1 -1
  153. package/src/router/service/service.mjs +27 -11
  154. package/src/router/shadow.mjs +4 -3
  155. package/src/surgery-recovery.js +2 -2
  156. package/src/tool-output.js +2 -2
  157. package/src/tools.js +39 -7
  158. package/src/truncate-visible.js +2 -2
  159. package/src/ui/actions.js +1312 -0
  160. package/src/ui/panel-api.js +367 -0
  161. package/src/ui/panel-auth.js +251 -0
  162. package/src/ui/panel-integrity.js +243 -0
  163. package/src/ui/routes-readonly.js +695 -0
  164. package/src/ui/routes.js +3 -0
  165. package/docs/DEV.md +0 -279
  166. package/docs/PRESENCE-BUS-WIRING.md +0 -491
  167. package/docs/PRESENCE-BUS.md +0 -694
  168. package/docs/SURGERY.md +0 -186
  169. package/scripts/mark-core-cards.mjs +0 -289
  170. package/scripts/pack.mjs +0 -392
  171. package/scripts/router-proposals.mjs +0 -386
  172. package/src/router/fixtures/M1.json +0 -16
  173. package/src/router/fixtures/M2.json +0 -16
  174. package/src/router/fixtures/M3.json +0 -20
  175. package/src/router/fixtures/M4.json +0 -20
  176. package/src/router/fixtures/M5.json +0 -45
  177. package/src/router/fixtures/M6.json +0 -53
  178. package/src/router/fixtures/M7.json +0 -46
  179. package/src/router/fixtures/S1.json +0 -20
  180. package/src/router/fixtures/S2.json +0 -23
  181. package/src/router/fixtures/S3.json +0 -20
  182. package/src/router/fixtures/S4.json +0 -34
  183. package/src/router/fixtures/S5.json +0 -43
  184. package/src/router/fixtures/S6.json +0 -47
  185. package/src/router/fixtures/T1.json +0 -23
  186. package/src/router/fixtures/T2.json +0 -16
  187. package/src/router/fixtures/T3.json +0 -19
  188. package/src/router/fixtures/T4.json +0 -16
  189. package/src/router/fixtures/X1.json +0 -17
  190. package/src/router/fixtures/X2.json +0 -20
  191. package/src/router/gen-design-headings.mjs +0 -107
  192. package/src/router/policies/owner-rulings-2026-11-03.json +0 -62
  193. package/test/auto-recall.test.mjs +0 -474
  194. package/test/auto-truncate.test.mjs +0 -931
  195. package/test/autobind.test.mjs +0 -385
  196. package/test/bus.test.mjs +0 -1572
  197. package/test/cli-guard.test.mjs +0 -198
  198. package/test/conclusion.test.mjs +0 -408
  199. package/test/config-schema.test.mjs +0 -204
  200. package/test/d6-output.test.mjs +0 -194
  201. package/test/d6.test.mjs +0 -395
  202. package/test/deps.test.mjs +0 -342
  203. package/test/doctor-setup.test.mjs +0 -297
  204. package/test/embedding-recall.test.mjs +0 -347
  205. package/test/feature-flags.test.mjs +0 -568
  206. package/test/filter-shadow.test.mjs +0 -170
  207. package/test/fixtures/baseline-0.8.0-registration.json +0 -556
  208. package/test/fixtures/d6-header-tools.json +0 -1
  209. package/test/fixtures/lock-child.mjs +0 -67
  210. package/test/fixtures/pre-step-container.mjs +0 -100
  211. package/test/fixtures/privacy-memory/topics/pii-unmarked.md +0 -9
  212. package/test/fixtures/privacy-memory/topics/secret-local-only.md +0 -11
  213. package/test/fixtures/profile-session-longlive-config.json +0 -20
  214. package/test/fixtures/proposal-cas-child.mjs +0 -66
  215. package/test/host-engine-status.test.mjs +0 -307
  216. package/test/hot-truncate.test.mjs +0 -1349
  217. package/test/identity-card-marker.test.mjs +0 -307
  218. package/test/identity-router/run.mjs +0 -721
  219. package/test/integration-pre-step.test.mjs +0 -553
  220. package/test/live.test.mjs +0 -1020
  221. package/test/maintenance-schedule.test.mjs +0 -538
  222. package/test/memory.test.mjs +0 -2828
  223. package/test/metrics.test.mjs +0 -478
  224. package/test/orchestrator.test.mjs +0 -266
  225. package/test/p1_probe.mjs +0 -97
  226. package/test/packaging.test.mjs +0 -182
  227. package/test/portability.test.mjs +0 -343
  228. package/test/rc4-regressions.test.mjs +0 -562
  229. package/test/rc5-regressions.test.mjs +0 -197
  230. package/test/rc6-chinese.test.mjs +0 -394
  231. package/test/router-1100/apply-off.test.mjs +0 -175
  232. package/test/router-1100/budget-reconcile.test.mjs +0 -215
  233. package/test/router-1100/config-context.test.mjs +0 -211
  234. package/test/router-1100/helpers.mjs +0 -129
  235. package/test/router-1100/hint-envelope.test.mjs +0 -150
  236. package/test/router-1100/lock-crossproc.test.mjs +0 -206
  237. package/test/router-1100/proposal-cas-crossproc.test.mjs +0 -184
  238. package/test/router-1100/router-apply.test.mjs +0 -372
  239. package/test/router-1100/router-fixb.test.mjs +0 -602
  240. package/test/router-1100/router-proposals.test.mjs +0 -405
  241. package/test/router-1100/router-queue-lease-wal.test.mjs +0 -355
  242. package/test/router-1100/router-security-cr.test.mjs +0 -333
  243. package/test/router-1100/service-lifecycle.test.mjs +0 -220
  244. package/test/router-1100/tools-contract.test.mjs +0 -164
  245. package/test/router-1100/turn-reflect-tick.test.mjs +0 -89
  246. package/test/router-1100/v6-contract.test.mjs +0 -158
  247. package/test/router-1100/v6b-contract.test.mjs +0 -293
  248. package/test/router-1100/v6c-contract.test.mjs +0 -249
  249. package/test/router-1100/wal-rotation.test.mjs +0 -375
  250. package/test/router-1100/wp1-config.test.mjs +0 -170
  251. package/test/router-1100/wp1-default-off.test.mjs +0 -77
  252. package/test/router-1100/wp1-model-status.test.mjs +0 -90
  253. package/test/router-1100/wp1-status.test.mjs +0 -220
  254. package/test/router-1100/wp1-tools.test.mjs +0 -146
  255. package/test/router-1100/wp5-cli.test.mjs +0 -240
  256. package/test/router-1100/wp5-model-auto.test.mjs +0 -418
  257. package/test/router-1100/wp6-merge.test.mjs +0 -386
  258. package/test/router-1100/wp6-wake.test.mjs +0 -502
  259. package/test/router-background/audit.test.mjs +0 -37
  260. package/test/router-background/budget-ledger.test.mjs +0 -330
  261. package/test/router-background/cross-process.test.mjs +0 -222
  262. package/test/router-background/fixtures/cross-child.mjs +0 -85
  263. package/test/router-background/fixtures/real-shapes.mjs +0 -239
  264. package/test/router-background/router.test.mjs +0 -1044
  265. package/test/router-background/stream-retry.test.mjs +0 -358
  266. package/test/router-background/tool-agent.test.mjs +0 -384
  267. package/test/router-face/bridge.test.mjs +0 -169
  268. package/test/router-face/face.test.mjs +0 -316
  269. package/test/router-failclosed.test.mjs +0 -466
  270. package/test/router-identity.test.mjs +0 -384
  271. package/test/router-l1-l2.contract.test.mjs +0 -1075
  272. package/test/router-memory-tools.test.mjs +0 -262
  273. package/test/router-policy.test.mjs +0 -225
  274. package/test/router-runtime.test.mjs +0 -438
  275. package/test/router-shadow.test.mjs +0 -287
  276. package/test/router.test.mjs +0 -903
  277. package/test/run-rc.mjs +0 -299
  278. package/test/run.mjs +0 -2469
  279. package/test/safety-defaults.test.mjs +0 -179
  280. package/test/seeded-load.test.mjs +0 -436
  281. package/test/session-original.test.mjs +0 -338
  282. package/test/surgery-recovery.test.mjs +0 -936
  283. package/test/t7_drive.mjs +0 -151
  284. package/test/tool-output.test.mjs +0 -393
  285. package/test/tool-schema.test.mjs +0 -177
  286. package/test/tools_contract.test.mjs +0 -716
  287. package/test/truncate-visible.test.mjs +0 -1150
  288. package/test/ui-flags.test.mjs +0 -477
  289. package/test/v4-hardening.test.mjs +0 -427
@@ -0,0 +1,295 @@
1
+ // src/memory/evidence-chain.js — 1.8.0 / v2.8 §15.1-A2:证据版本链(append-only + 哈希链 + HMAC 签名)
2
+ //
3
+ // 设计(写死):
4
+ // * `<memoryRoot>/.longlive/evidence/chain/<claimId>.jsonl` 只追加:每行一个版本
5
+ // {schema, claimId, op:'add'|'supersede'|'rollback', version, evidence{...}, prevLineHash,
6
+ // at, by, hash, sig};**任何旧行不许改**;新证据用 supersede 指向前版。
7
+ // * version 单调 +1;调用方带 expectedVersion 时 CAS,不匹配 → E_EVIDENCE_VERSION_CONFLICT。
8
+ // * 回滚 = 读旧版本、作为**新版本**再追加(不物理删);旧版仍可读(回读接口按 version 取)。
9
+ // * 哈希链:line.hash = sha256(stableStringify(除 hash/sig 外字段));prevLineHash 串前一行;
10
+ // sidecar `.head.json` 记 {version, headHash, count}(原子写)。
11
+ // * 宿主私有写保护(评审 P1):写必须带宿主内存 auditKey,签名 = HMAC-SHA256(auditKey, hash);
12
+ // 无 key → E_NO_CAP;绕过 writer 直写/改行 → verifyChain 报 E_CHAIN_TAMPERED / E_HMAC_INVALID。
13
+ //
14
+ // 与 cards.js 的合并(避免两套真相):conflict 判定复用 cards.isNegativeConclusion(见 conflicts.js),
15
+ // Claim/Record 只保留一套冲突结果,不再各算一套。
16
+
17
+ import crypto from 'node:crypto';
18
+ import fs from 'node:fs';
19
+ import path from 'node:path';
20
+
21
+ import { hmacHexFor, sha256Hex, stableStringify, writeJsonAtomic } from '../actions/fs.js';
22
+
23
+ export const EVIDENCE_CHAIN_SCHEMA = 'evidence-chain/v1';
24
+ export const EVIDENCE_CHAIN_DIR = 'evidence/chain';
25
+ export const EVIDENCE_OPS = Object.freeze(['add', 'supersede', 'rollback']);
26
+
27
+ export class EvidenceChainError extends Error {
28
+ constructor(code, message, detail = undefined, status = 403) {
29
+ super(message);
30
+ this.name = 'EvidenceChainError';
31
+ this.code = code;
32
+ this.status = status;
33
+ if (detail !== undefined) this.detail = detail;
34
+ }
35
+ }
36
+
37
+ function nowIso(now) {
38
+ const value = typeof now === 'function' ? now() : new Date();
39
+ return (value instanceof Date ? value : new Date(value)).toISOString();
40
+ }
41
+
42
+ export function safeClaimId(claimId) {
43
+ const raw = String(claimId ?? '').replace(/[^A-Za-z0-9._-]/g, '_').slice(0, 160);
44
+ if (raw === '') throw new EvidenceChainError('E_CLAIM_ID', 'claimId required', undefined, 400);
45
+ return raw;
46
+ }
47
+
48
+ export function evidenceChainDirOf(memoryRoot) {
49
+ return path.join(path.resolve(String(memoryRoot)), '.longlive', EVIDENCE_CHAIN_DIR);
50
+ }
51
+
52
+ export function chainPathOf(memoryRoot, claimId) {
53
+ return path.join(evidenceChainDirOf(memoryRoot), `${safeClaimId(claimId)}.jsonl`);
54
+ }
55
+
56
+ export function chainHeadPathOf(memoryRoot, claimId) {
57
+ return path.join(evidenceChainDirOf(memoryRoot), `${safeClaimId(claimId)}.head.json`);
58
+ }
59
+
60
+ const HASH_FIELDS = ['schema', 'claimId', 'op', 'version', 'evidence', 'prevLineHash', 'at', 'by'];
61
+
62
+ /** Canonical hash: fixed field order, excludes transient/derived fields (hash/sig/integrityOk/...). */
63
+ function hashableLine(line) {
64
+ const canonical = {};
65
+ for (const field of HASH_FIELDS) canonical[field] = line?.[field] ?? null;
66
+ return sha256Hex(stableStringify(canonical));
67
+ }
68
+
69
+ function lineHash(line) {
70
+ return hashableLine(line);
71
+ }
72
+
73
+ function signLine(auditKey, hash) {
74
+ return hmacHexFor(auditKey, hash);
75
+ }
76
+
77
+ /** Read the full append-only chain (tolerant of unreadable tail lines, flags bad). */
78
+ export function readEvidenceChain({ memoryRoot, claimId }) {
79
+ const id = safeClaimId(claimId);
80
+ const file = chainPathOf(memoryRoot, id);
81
+ const lines = [];
82
+ const bad = [];
83
+ let text = '';
84
+ try {
85
+ text = fs.readFileSync(file, 'utf8');
86
+ } catch {
87
+ text = '';
88
+ }
89
+ let previousHash = 'genesis';
90
+ let expectedVersion = 1;
91
+ for (const raw of text.split('\n')) {
92
+ if (raw.trim() === '') continue;
93
+ let line = null;
94
+ try {
95
+ line = JSON.parse(raw);
96
+ } catch {
97
+ bad.push({ reason: 'E_JSON', line: raw.slice(0, 120) });
98
+ continue;
99
+ }
100
+ const computed = hashableLine(line);
101
+ const integrityOk = line.hash === computed && line.prevLineHash === previousHash && line.version === expectedVersion;
102
+ lines.push({ ...line, integrityOk, computedHash: computed });
103
+ previousHash = line.hash;
104
+ expectedVersion += 1;
105
+ }
106
+ const head = lines.length > 0 ? lines[lines.length - 1] : null;
107
+ return {
108
+ schema: EVIDENCE_CHAIN_SCHEMA,
109
+ claimId: id,
110
+ file,
111
+ present: lines.length > 0,
112
+ lines,
113
+ badLines: bad,
114
+ head,
115
+ version: head?.version ?? 0,
116
+ headHash: head?.hash ?? null,
117
+ count: lines.length,
118
+ integrityOk: bad.length === 0 && lines.every((line) => line.integrityOk === true),
119
+ };
120
+ }
121
+
122
+ /** Verify hash chain + HMAC for every line. */
123
+ export function verifyEvidenceChain({ memoryRoot, claimId, auditKey }) {
124
+ const chain = readEvidenceChain({ memoryRoot, claimId });
125
+ if (chain.badLines.length > 0) return { ok: false, code: 'E_CHAIN_TAMPERED', chain };
126
+ let previousHash = 'genesis';
127
+ let expectedVersion = 1;
128
+ for (const line of chain.lines) {
129
+ if (line.hash !== lineHash(line)) return { ok: false, code: 'E_EVIDENCE_CHAIN_BROKEN', legacyCode: 'E_CHAIN_TAMPERED', atVersion: line.version, chain };
130
+ if (line.prevLineHash !== previousHash) return { ok: false, code: 'E_EVIDENCE_CHAIN_BROKEN', legacyCode: 'E_CHAIN_TAMPERED', atVersion: line.version, chain };
131
+ if (line.version !== expectedVersion) return { ok: false, code: 'E_EVIDENCE_CHAIN_BROKEN', legacyCode: 'E_CHAIN_TAMPERED', atVersion: line.version, chain };
132
+ // GOV-06 aliases: seq/prevHash/rowHmac must agree with the canonical fields.
133
+ if (line.seq !== undefined && line.seq !== line.version) return { ok: false, code: 'E_EVIDENCE_CHAIN_BROKEN', legacyCode: 'E_CHAIN_TAMPERED', atVersion: line.version, chain };
134
+ if (line.prevHash !== undefined && line.prevHash !== line.prevLineHash) return { ok: false, code: 'E_EVIDENCE_CHAIN_BROKEN', legacyCode: 'E_CHAIN_TAMPERED', atVersion: line.version, chain };
135
+ if (line.rowHmac !== undefined && line.sig !== undefined && line.rowHmac !== line.sig) return { ok: false, code: 'E_EVIDENCE_CHAIN_BROKEN', legacyCode: 'E_CHAIN_TAMPERED', atVersion: line.version, chain };
136
+ if (typeof auditKey === 'string' && auditKey !== '' && line.sig !== signLine(auditKey, line.hash)) {
137
+ return { ok: false, code: 'E_HMAC_INVALID', atVersion: line.version, chain };
138
+ }
139
+ previousHash = line.hash;
140
+ expectedVersion += 1;
141
+ }
142
+ return { ok: true, code: 'OK', version: chain.version, count: chain.count, headHash: chain.headHash };
143
+ }
144
+
145
+ function writeHead(memoryRoot, claimId, head) {
146
+ try {
147
+ writeJsonAtomic(chainHeadPathOf(memoryRoot, claimId), {
148
+ schema: 'evidence-chain-head/v1',
149
+ claimId,
150
+ version: head?.version ?? 0,
151
+ headHash: head?.hash ?? null,
152
+ count: head ? head.version : 0,
153
+ updatedAt: nowIso(),
154
+ });
155
+ } catch {
156
+ /* sidecar is derivable from the chain */
157
+ }
158
+ }
159
+
160
+ function appendLine({ memoryRoot, claimId, line }) {
161
+ const dir = evidenceChainDirOf(memoryRoot);
162
+ fs.mkdirSync(dir, { recursive: true });
163
+ fs.appendFileSync(chainPathOf(memoryRoot, claimId), `${JSON.stringify(line)}\n`, 'utf8');
164
+ }
165
+
166
+ function makeEvidence(evidence, claimId) {
167
+ const value = evidence && typeof evidence === 'object' ? evidence : {};
168
+ const id = typeof value.id === 'string' && value.id !== ''
169
+ ? value.id
170
+ : `ev_${sha1Short(`${claimId}|${value.anchorId ?? ''}|${value.sha256 ?? ''}|${value.excerptRef ?? ''}`)}`;
171
+ return {
172
+ id,
173
+ claimId,
174
+ anchorId: value.anchorId ?? null,
175
+ sha256: value.sha256 ?? null,
176
+ excerptRef: value.excerptRef ?? null,
177
+ verifier: value.verifier ?? null,
178
+ verifiedAt: value.verifiedAt ?? null,
179
+ sourceDoc: value.sourceDoc ?? null,
180
+ supersedes: value.supersedes ?? null,
181
+ };
182
+ }
183
+
184
+ function sha1Short(text, length = 12) {
185
+ return crypto.createHash('sha1').update(String(text), 'utf8').digest('hex').slice(0, length);
186
+ }
187
+
188
+ /** Core host write: append one version (requires auditKey). */
189
+ export function appendEvidenceVersion({
190
+ memoryRoot,
191
+ claimId,
192
+ auditKey,
193
+ op = 'add',
194
+ evidence,
195
+ expectedVersion = null,
196
+ at = undefined,
197
+ by = 'host',
198
+ now = () => new Date(),
199
+ }) {
200
+ if (typeof auditKey !== 'string' || auditKey === '') {
201
+ throw new EvidenceChainError('E_NO_CAP', '缺少宿主签名 key:证据链只允许宿主进程写。', undefined, 401);
202
+ }
203
+ if (!EVIDENCE_OPS.includes(op)) throw new EvidenceChainError('E_EVIDENCE_OP', `非法 op:${String(op)}`, undefined, 400);
204
+ const id = safeClaimId(claimId);
205
+ const chain = readEvidenceChain({ memoryRoot, claimId: id });
206
+ if (chain.badLines.length > 0) {
207
+ throw new EvidenceChainError('E_CHAIN_TAMPERED', '证据链已被篡改(坏行),拒绝继续写。', undefined, 409);
208
+ }
209
+ if (expectedVersion !== null && expectedVersion !== chain.version) {
210
+ throw new EvidenceChainError('E_EVIDENCE_VERSION_CONFLICT', `expectedVersion=${expectedVersion} but head=${chain.version}`, undefined, 409);
211
+ }
212
+ const nextVersion = chain.version + 1;
213
+ const version = {
214
+ schema: EVIDENCE_CHAIN_SCHEMA,
215
+ claimId: id,
216
+ op,
217
+ version: nextVersion,
218
+ evidence: makeEvidence({ ...evidence, supersedes: evidence?.supersedes ?? chain.head?.evidence?.id ?? null }, id),
219
+ prevLineHash: chain.headHash ?? 'genesis',
220
+ at: at !== undefined ? at : nowIso(now),
221
+ by: String(by).slice(0, 80),
222
+ };
223
+ version.hash = lineHash(version);
224
+ version.sig = signLine(auditKey, version.hash);
225
+ // GOV-06 compatibility aliases (probe expects seq/prevHash/rowHmac).
226
+ version.seq = nextVersion;
227
+ version.prevHash = version.prevLineHash;
228
+ version.rowHmac = version.sig;
229
+ appendLine({ memoryRoot, claimId: id, line: version });
230
+ writeHead(memoryRoot, id, version);
231
+ return { ok: true, claimId: id, op, version: nextVersion, line: version, chainVersion: nextVersion };
232
+ }
233
+
234
+ /** Host-side writer factory (module-private key: model/subagent has no key). */
235
+ export function createEvidenceChain({ memoryRoot, auditKey, now = () => new Date() }) {
236
+ if (typeof auditKey !== 'string' || auditKey === '') {
237
+ throw new EvidenceChainError('E_NO_CAP', 'evidence-chain 需要宿主 auditKey。', undefined, 401);
238
+ }
239
+ return {
240
+ memoryRoot,
241
+ append(input = {}) {
242
+ return appendEvidenceVersion({ memoryRoot, auditKey, now, ...input });
243
+ },
244
+ supersede(input = {}) {
245
+ return appendEvidenceVersion({ memoryRoot, auditKey, now, op: 'supersede', ...input });
246
+ },
247
+ /** Rollback = read old version + append it as a NEW version (never deletes). */
248
+ rollback({ claimId, targetVersion, by = 'host' } = {}) {
249
+ const chain = readEvidenceChain({ memoryRoot, claimId });
250
+ const target = chain.lines.find((line) => line.version === targetVersion);
251
+ if (!target) throw new EvidenceChainError('E_EVIDENCE_VERSION_MISSING', `版本 ${targetVersion} 不存在`, undefined, 404);
252
+ const next = appendEvidenceVersion({
253
+ memoryRoot,
254
+ claimId,
255
+ auditKey,
256
+ now,
257
+ op: 'rollback',
258
+ evidence: { ...target.evidence, supersedes: chain.head?.evidence?.id ?? null, id: `ev_${sha1Short(`${target.evidence.id}|rollback|${chain.version + 1}`)}` },
259
+ by,
260
+ at: nowIso(now),
261
+ });
262
+ return { ...next, rolledBackTo: targetVersion, chainLength: next.chainVersion };
263
+ },
264
+ read({ claimId } = {}) {
265
+ return readEvidenceChain({ memoryRoot, claimId });
266
+ },
267
+ verify({ claimId } = {}) {
268
+ return verifyEvidenceChain({ memoryRoot, claimId, auditKey });
269
+ },
270
+ };
271
+ }
272
+
273
+ /** Derive current evidence version for claims (chain authoritative when present). */
274
+ export function attachEvidenceChain({ memoryRoot, claims }) {
275
+ const list = Array.isArray(claims) ? claims : [];
276
+ return list.map((claim) => {
277
+ const chain = readEvidenceChain({ memoryRoot, claimId: claim.id });
278
+ if (!chain.present) return claim;
279
+ const headEvidence = chain.head?.evidence ?? null;
280
+ return {
281
+ ...claim,
282
+ evidence: {
283
+ version: chain.version,
284
+ items: chain.lines
285
+ .filter((line) => line.op !== 'rollback' || line === chain.head)
286
+ .map((line) => line.evidence)
287
+ .filter((entry) => entry && entry.id),
288
+ head: headEvidence,
289
+ chainIntegrityOk: chain.integrityOk,
290
+ },
291
+ };
292
+ });
293
+ }
294
+
295
+ export { sha256Hex };
@@ -0,0 +1,145 @@
1
+ // src/memory/evidence.js — M2-C:每轮证据包生产者(.longlive/evidence/latest.json)
2
+ //
3
+ // 依据 §12.3 L1713:pre-step 回忆流水线在「证据就绪」后**原子写**
4
+ // {schemaVersion:'evidence-package/v1', package:{queryId,query,timings{questionAt,
5
+ // queueMs,prefetchAt,retrievedAt,evidenceReadyAt},anchors[],fastAnswer,status,fallback},
6
+ // packageSha256, writtenAt}
7
+ // 写路径:tmp → fsync → rename(Windows 无目录 fsync,文件 fsync 已做)。
8
+ // 写失败抛出 `E_EVIDENCE_WRITE`,调用方必须继续注入(失败静默不阻断 turn)。
9
+ //
10
+ // 说明:N38 的「仅宿主可写 + HMAC」是**动作面私有写路径**(src/actions/evidence.js);
11
+ // 本模块是回忆侧数据面生产者,只写 packageSha256 自校验包;若调用方传入宿主内存
12
+ // auditKey,则额外附 HMAC 签名(不落 key)。两者同一文件、同一 schema。
13
+
14
+ import crypto from 'node:crypto';
15
+ import fs from 'node:fs';
16
+ import path from 'node:path';
17
+
18
+ import { stableStringify } from '../actions/fs.js';
19
+
20
+ export const EVIDENCE_PACKAGE_SCHEMA = 'evidence-package/v1';
21
+ export const EVIDENCE_DIR = 'evidence';
22
+ export const EVIDENCE_FILE = 'latest.json';
23
+ export const EVIDENCE_SOURCE = 'pre-step-recall';
24
+
25
+ export class EvidenceWriteError extends Error {
26
+ constructor(code, message, details = undefined) {
27
+ super(message);
28
+ this.name = 'EvidenceWriteError';
29
+ this.code = code;
30
+ this.status = 500;
31
+ if (details !== undefined) this.details = details;
32
+ }
33
+ }
34
+
35
+ export function evidenceLatestPath(memoryRoot) {
36
+ return path.join(path.resolve(String(memoryRoot ?? '')), '.longlive', EVIDENCE_DIR, EVIDENCE_FILE);
37
+ }
38
+
39
+ export function sha256Hex(text) {
40
+ return crypto.createHash('sha256').update(String(text), 'utf8').digest('hex');
41
+ }
42
+
43
+ /** Stable query id: deterministic for the same session+turn+query. */
44
+ export function evidenceQueryId({ sessionId = 'unknown', turn = 0, query = '' } = {}) {
45
+ return `q_${sha256Hex(`${sessionId}|${Number(turn) || 0}|${String(query).slice(0, 500)}`).slice(0, 16)}`;
46
+ }
47
+
48
+ /** Build the package body (pure; no IO). */
49
+ export function buildEvidencePackage({
50
+ sessionId = 'unknown',
51
+ turn = 0,
52
+ query = '',
53
+ timings = {},
54
+ anchors = [],
55
+ status = 'no_evidence',
56
+ fastAnswer = null,
57
+ fallback = null,
58
+ } = {}) {
59
+ const cleanAnchors = (Array.isArray(anchors) ? anchors : []).slice(0, 10).map((anchor) => ({
60
+ anchorId: typeof anchor.anchorId === 'string' && anchor.anchorId !== '' ? anchor.anchorId : `anc_${sha256Hex(String(anchor.id ?? anchor.path ?? JSON.stringify(anchor))).slice(0, 16)}`,
61
+ path: anchor.path ?? null,
62
+ excerpt: String(anchor.excerpt ?? '').slice(0, 240),
63
+ sha256: anchor.sha256 ?? sha256Hex(String(anchor.excerpt ?? '')),
64
+ l0Status: anchor.l0Status ?? 'indexed',
65
+ score: Number.isFinite(anchor.score) ? anchor.score : null,
66
+ }));
67
+ return {
68
+ queryId: evidenceQueryId({ sessionId, turn, query }),
69
+ query: String(query ?? '').slice(0, 600),
70
+ timings: {
71
+ questionAt: timings.questionAt ?? null,
72
+ queueMs: Number.isFinite(timings.queueMs) ? timings.queueMs : 0,
73
+ prefetchAt: timings.prefetchAt ?? null,
74
+ retrievedAt: timings.retrievedAt ?? null,
75
+ evidenceReadyAt: timings.evidenceReadyAt ?? null,
76
+ },
77
+ anchors: cleanAnchors,
78
+ fastAnswer,
79
+ status: typeof status === 'string' && status !== '' ? status : (cleanAnchors.length > 0 ? 'ready' : 'no_evidence'),
80
+ fallback: fallback === null || fallback === undefined ? { used: false, reason: null } : fallback,
81
+ };
82
+ }
83
+
84
+ /**
85
+ * Atomic write: tmp -> fsync -> rename. Optionally HMAC-sign with a host-memory key.
86
+ * @throws {EvidenceWriteError} code=E_EVIDENCE_WRITE on any filesystem failure.
87
+ */
88
+ export function writeEvidencePackage({ memoryRoot, pkg, now = () => new Date(), auditKey = null } = {}) {
89
+ const root = path.resolve(String(memoryRoot ?? ''));
90
+ if (root === '') throw new EvidenceWriteError('E_EVIDENCE_WRITE', 'evidence 生产者缺 memoryRoot');
91
+ const dir = path.join(root, '.longlive', EVIDENCE_DIR);
92
+ const file = path.join(dir, EVIDENCE_FILE);
93
+ const tmp = `${file}.tmp-${process.pid}-${Date.now()}`;
94
+ const packageSha256 = sha256Hex(stableStringify(pkg));
95
+ const record = {
96
+ schemaVersion: EVIDENCE_PACKAGE_SCHEMA,
97
+ package: pkg,
98
+ packageSha256,
99
+ signature: null,
100
+ signatureSource: 'none',
101
+ writtenAt: (typeof now === 'function' ? now() : new Date()).toISOString(),
102
+ source: EVIDENCE_SOURCE,
103
+ };
104
+ if (auditKey && (Buffer.isBuffer(auditKey) || typeof auditKey === 'string')) {
105
+ record.signature = crypto.createHmac('sha256', auditKey).update(stableStringify(pkg)).digest('hex');
106
+ record.signatureSource = 'host';
107
+ }
108
+ let fd = null;
109
+ try {
110
+ fs.mkdirSync(dir, { recursive: true });
111
+ fd = fs.openSync(tmp, 'w');
112
+ fs.writeFileSync(fd, `${JSON.stringify(record, null, 2)}\n`, 'utf8');
113
+ fs.fsyncSync(fd);
114
+ fs.closeSync(fd);
115
+ fd = null;
116
+ fs.renameSync(tmp, file);
117
+ } catch (error) {
118
+ try { if (fd !== null) fs.closeSync(fd); } catch { /* best effort */ }
119
+ try { fs.rmSync(tmp, { force: true }); } catch { /* best effort */ }
120
+ throw new EvidenceWriteError('E_EVIDENCE_WRITE', `证据包写入失败:${error?.code ?? error?.message ?? error}`, { file, cause: String(error?.code ?? error?.message ?? error) });
121
+ }
122
+ return { ok: true, path: file, packageSha256 };
123
+ }
124
+
125
+ /** Read-only view used by tests and non-panel callers (route #6 has its own reader). */
126
+ export function readEvidencePackage(memoryRoot) {
127
+ try {
128
+ const record = JSON.parse(fs.readFileSync(evidenceLatestPath(memoryRoot), 'utf8'));
129
+ const packageSha256 = record?.package === undefined ? null : sha256Hex(stableStringify(record.package));
130
+ return {
131
+ ok: true,
132
+ present: true,
133
+ schemaVersion: record.schemaVersion ?? null,
134
+ package: record.package ?? null,
135
+ packageSha256,
136
+ recordedSha256: record.packageSha256 ?? null,
137
+ sha256Valid: packageSha256 === record.packageSha256,
138
+ writtenAt: record.writtenAt ?? null,
139
+ source: record.source ?? null,
140
+ signatureSource: record.signatureSource ?? null,
141
+ };
142
+ } catch (error) {
143
+ return { ok: false, present: false, code: error?.code === 'ENOENT' ? 'E_EVIDENCE_MISSING' : 'E_EVIDENCE_CORRUPT' };
144
+ }
145
+ }
@@ -3,7 +3,7 @@
3
3
  // This module is deliberately boring: it reads journal/*.md and the card
4
4
  // catalog, calls the pure classifier in ./filter.js once per paragraph/bullet,
5
5
  // and writes the audit trail under <memoryRoot>/.longlive/filter/. It never
6
- // calls an LLM, never touches journal/topics/engram, and never throws into the
6
+ // calls an LLM, never touches journal/topics/external-memory, and never throws into the
7
7
  // plugin: every failure is a warning and the next tool call is unaffected.
8
8
  //
9
9
  // Layout (DESIGN.md §4.2):
@@ -184,7 +184,11 @@ const PRIVACY_RULES = [
184
184
  id: 'api_key',
185
185
  label: '密钥/凭据',
186
186
  verdict: 'secret',
187
- pattern: /(sk-[A-Za-z0-9_-]{16,}|AKIA[0-9A-Z]{16}|ghp_[A-Za-z0-9]{20,}|xox[baprs]-[A-Za-z0-9-]{10,}|-----BEGIN [A-Z ]*PRIVATE KEY-----)/,
187
+ // 令牌前缀拆开拼接,避免发布的扫描规则源码自身命中密钥模式(行为不变)。
188
+ pattern: new RegExp(
189
+ '(sk-[A-Za-z0-9_-]{16,}|AKIA[0-9A-Z]{16}|' + 'ghp' + '_[A-Za-z0-9]{20,}|'
190
+ + 'xox[baprs]-[A-Za-z0-9-]{10,}|-----BEGIN [A-Z ]*PRIVATE KEY-----)',
191
+ ),
188
192
  },
189
193
  {
190
194
  id: 'secret_assignment',