@jjh32456/dsh-longlive 1.6.8 → 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 (288) hide show
  1. package/CHANGELOG.md +69 -1539
  2. package/LICENSE +1 -1
  3. package/QUICKSTART.md +33 -12
  4. package/README.en.md +17 -7
  5. package/README.md +29 -10
  6. package/SPEC.md +5 -5
  7. package/cordis.patch.yml +17 -12
  8. package/docs/ANSWER-GUARD.md +92 -0
  9. package/docs/ARCHITECTURE.md +3 -3
  10. package/docs/AUTO-RECALL-WIRING.md +1 -1
  11. package/docs/AUTO-RECALL.md +15 -9
  12. package/docs/CONFIG.md +143 -37
  13. package/docs/ERRORS.md +17 -5
  14. package/docs/FAQ.md +7 -7
  15. package/docs/FEATURES.md +66 -29
  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 +3 -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 +42 -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 +129 -18
  41. package/src/activity/model.js +11 -1
  42. package/src/activity/store.js +22 -3
  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 +145 -48
  58. package/src/deps.js +6 -4
  59. package/src/features.js +158 -8
  60. package/src/identity/index.js +13 -5
  61. package/src/identity/inject-position.js +2 -2
  62. package/src/index.js +97 -7
  63. package/src/lifecycle/gap-clocks.js +328 -0
  64. package/src/lifecycle/index.js +269 -0
  65. package/src/memory/activity-capture.js +229 -0
  66. package/src/memory/anchors.js +194 -0
  67. package/src/memory/audit-records.js +222 -0
  68. package/src/memory/auto-cards.js +401 -0
  69. package/src/memory/capture.js +442 -0
  70. package/src/memory/card-anchors.js +203 -0
  71. package/src/memory/conflicts.js +106 -0
  72. package/src/memory/decay.js +311 -0
  73. package/src/memory/distill.js +471 -0
  74. package/src/memory/event-index.js +917 -0
  75. package/src/memory/evidence-chain.js +295 -0
  76. package/src/memory/evidence.js +145 -0
  77. package/src/memory/filter-runner.js +1 -1
  78. package/src/memory/filter.js +5 -1
  79. package/src/memory/forget-v2.js +410 -0
  80. package/src/memory/forget.js +71 -0
  81. package/src/memory/frames-activation.js +247 -0
  82. package/src/memory/fts-query.js +174 -0
  83. package/src/memory/governance.js +604 -0
  84. package/src/memory/index.js +1 -0
  85. package/src/memory/l2-gate.js +169 -0
  86. package/src/memory/lock.js +121 -0
  87. package/src/memory/migrate.js +139 -0
  88. package/src/memory/recall-v2.js +223 -0
  89. package/src/memory/recall.js +65 -2
  90. package/src/memory/records.js +425 -0
  91. package/src/memory/retention.js +128 -0
  92. package/src/memory/review.js +124 -0
  93. package/src/memory/trust.js +88 -0
  94. package/src/memory/version-chain.js +264 -0
  95. package/src/memory/wal.js +137 -0
  96. package/src/memory/working-frame.js +516 -0
  97. package/src/metrics/classify.mjs +5 -3
  98. package/src/metrics/index.mjs +21 -1
  99. package/src/metrics/prestep-latency.mjs +300 -0
  100. package/src/metrics/store.mjs +25 -0
  101. package/src/policy-profile.js +18 -3
  102. package/src/recall/anaphora.mjs +87 -0
  103. package/src/recall/cards.mjs +7 -0
  104. package/src/recall/embedding.mjs +8 -8
  105. package/src/recall/entities.mjs +112 -0
  106. package/src/recall/index.js +235 -19
  107. package/src/recall/inject-order.mjs +10 -8
  108. package/src/recall/privacy.mjs +1 -1
  109. package/src/recall/recall-core.mjs +116 -10
  110. package/src/recall/shared-visibility.js +302 -0
  111. package/src/recall/time-normalizer.mjs +196 -0
  112. package/src/role/activation.js +191 -0
  113. package/src/role/attention.js +318 -0
  114. package/src/role/base.js +36 -0
  115. package/src/role/channels.js +423 -0
  116. package/src/role/index.js +425 -0
  117. package/src/role/interfaces.js +115 -0
  118. package/src/role/personality.js +370 -0
  119. package/src/role/readers.js +151 -0
  120. package/src/role/relationships.js +477 -0
  121. package/src/role/store.js +202 -0
  122. package/src/role/writeprotect.js +373 -0
  123. package/src/router/aliases.json +176 -25
  124. package/src/router/background/agent-runner.mjs +1 -1
  125. package/src/router/background/anchor.mjs +1 -1
  126. package/src/router/background/audit.mjs +2 -2
  127. package/src/router/background/budget-ledger.mjs +2 -2
  128. package/src/router/background/host-sim.mjs +1 -1
  129. package/src/router/background/memory.mjs +4 -4
  130. package/src/router/background/queue.mjs +1 -1
  131. package/src/router/background/retry.mjs +1 -1
  132. package/src/router/background/router.mjs +1 -1
  133. package/src/router/background/stream.mjs +1 -1
  134. package/src/router/background/tool-policy.mjs +1 -1
  135. package/src/router/design-headings.json +5 -5
  136. package/src/router/face/config.mjs +1 -1
  137. package/src/router/face/identity.mjs +3 -3
  138. package/src/router/judge.mjs +8 -7
  139. package/src/router/policies/generic.json +21 -4
  140. package/src/router/route.js +109 -22
  141. package/src/router/router.mjs +10 -6
  142. package/src/router/routing-rules.json +260 -445
  143. package/src/router/run-sim.mjs +8 -8
  144. package/src/router/runtime.js +23 -12
  145. package/src/router/service/config.mjs +5 -5
  146. package/src/router/service/context.mjs +1 -1
  147. package/src/router/service/queue.mjs +1 -1
  148. package/src/router/shadow.mjs +4 -3
  149. package/src/surgery-recovery.js +2 -2
  150. package/src/tool-output.js +2 -2
  151. package/src/tools.js +39 -7
  152. package/src/truncate-visible.js +2 -2
  153. package/src/ui/actions.js +1312 -0
  154. package/src/ui/panel-api.js +367 -0
  155. package/src/ui/panel-auth.js +251 -0
  156. package/src/ui/panel-integrity.js +243 -0
  157. package/src/ui/routes-readonly.js +695 -0
  158. package/src/ui/routes.js +3 -0
  159. package/docs/DEV.md +0 -279
  160. package/docs/PRESENCE-BUS-WIRING.md +0 -491
  161. package/docs/PRESENCE-BUS.md +0 -694
  162. package/docs/SURGERY.md +0 -186
  163. package/scripts/mark-core-cards.mjs +0 -289
  164. package/scripts/pack.mjs +0 -392
  165. package/scripts/router-proposals.mjs +0 -386
  166. package/src/router/fixtures/M1.json +0 -16
  167. package/src/router/fixtures/M2.json +0 -16
  168. package/src/router/fixtures/M3.json +0 -20
  169. package/src/router/fixtures/M4.json +0 -20
  170. package/src/router/fixtures/M5.json +0 -45
  171. package/src/router/fixtures/M6.json +0 -53
  172. package/src/router/fixtures/M7.json +0 -46
  173. package/src/router/fixtures/S1.json +0 -20
  174. package/src/router/fixtures/S2.json +0 -23
  175. package/src/router/fixtures/S3.json +0 -20
  176. package/src/router/fixtures/S4.json +0 -34
  177. package/src/router/fixtures/S5.json +0 -43
  178. package/src/router/fixtures/S6.json +0 -47
  179. package/src/router/fixtures/T1.json +0 -23
  180. package/src/router/fixtures/T2.json +0 -16
  181. package/src/router/fixtures/T3.json +0 -19
  182. package/src/router/fixtures/T4.json +0 -16
  183. package/src/router/fixtures/X1.json +0 -17
  184. package/src/router/fixtures/X2.json +0 -20
  185. package/src/router/gen-design-headings.mjs +0 -107
  186. package/src/router/policies/owner-rulings-2026-11-03.json +0 -62
  187. package/test/activity-realtime.test.mjs +0 -959
  188. package/test/activity-stream.test.mjs +0 -512
  189. package/test/auto-recall.test.mjs +0 -474
  190. package/test/auto-truncate.test.mjs +0 -931
  191. package/test/autobind.test.mjs +0 -399
  192. package/test/bus.test.mjs +0 -1572
  193. package/test/cli-guard.test.mjs +0 -198
  194. package/test/conclusion.test.mjs +0 -408
  195. package/test/config-schema.test.mjs +0 -210
  196. package/test/d6-output.test.mjs +0 -194
  197. package/test/d6.test.mjs +0 -395
  198. package/test/deps.test.mjs +0 -342
  199. package/test/doctor-setup.test.mjs +0 -297
  200. package/test/embedding-recall.test.mjs +0 -347
  201. package/test/feature-flags.test.mjs +0 -585
  202. package/test/filter-shadow.test.mjs +0 -170
  203. package/test/fixtures/activity-append-child.mjs +0 -29
  204. package/test/fixtures/baseline-0.8.0-registration.json +0 -556
  205. package/test/fixtures/d6-header-tools.json +0 -1
  206. package/test/fixtures/lock-child.mjs +0 -67
  207. package/test/fixtures/pre-step-container.mjs +0 -100
  208. package/test/fixtures/privacy-memory/topics/pii-unmarked.md +0 -9
  209. package/test/fixtures/privacy-memory/topics/secret-local-only.md +0 -11
  210. package/test/fixtures/profile-session-longlive-config.json +0 -20
  211. package/test/fixtures/proposal-cas-child.mjs +0 -66
  212. package/test/host-engine-status.test.mjs +0 -307
  213. package/test/hot-truncate.test.mjs +0 -1349
  214. package/test/identity-card-marker.test.mjs +0 -307
  215. package/test/identity-router/run.mjs +0 -721
  216. package/test/integration-pre-step.test.mjs +0 -553
  217. package/test/live.test.mjs +0 -1023
  218. package/test/maintenance-schedule.test.mjs +0 -538
  219. package/test/memory.test.mjs +0 -2828
  220. package/test/metrics.test.mjs +0 -478
  221. package/test/orchestrator.test.mjs +0 -266
  222. package/test/p1_probe.mjs +0 -97
  223. package/test/packaging.test.mjs +0 -184
  224. package/test/portability.test.mjs +0 -343
  225. package/test/rc4-regressions.test.mjs +0 -562
  226. package/test/rc5-regressions.test.mjs +0 -197
  227. package/test/rc6-chinese.test.mjs +0 -394
  228. package/test/router-1100/apply-off.test.mjs +0 -175
  229. package/test/router-1100/budget-reconcile.test.mjs +0 -215
  230. package/test/router-1100/config-context.test.mjs +0 -211
  231. package/test/router-1100/helpers.mjs +0 -129
  232. package/test/router-1100/hint-envelope.test.mjs +0 -150
  233. package/test/router-1100/lock-crossproc.test.mjs +0 -206
  234. package/test/router-1100/proposal-cas-crossproc.test.mjs +0 -184
  235. package/test/router-1100/router-apply.test.mjs +0 -372
  236. package/test/router-1100/router-fixb.test.mjs +0 -602
  237. package/test/router-1100/router-proposals.test.mjs +0 -405
  238. package/test/router-1100/router-queue-lease-wal.test.mjs +0 -355
  239. package/test/router-1100/router-security-cr.test.mjs +0 -333
  240. package/test/router-1100/service-lifecycle.test.mjs +0 -220
  241. package/test/router-1100/tools-contract.test.mjs +0 -164
  242. package/test/router-1100/turn-reflect-tick.test.mjs +0 -89
  243. package/test/router-1100/v6-contract.test.mjs +0 -158
  244. package/test/router-1100/v6b-contract.test.mjs +0 -293
  245. package/test/router-1100/v6c-contract.test.mjs +0 -249
  246. package/test/router-1100/wal-rotation.test.mjs +0 -375
  247. package/test/router-1100/wp1-config.test.mjs +0 -170
  248. package/test/router-1100/wp1-default-off.test.mjs +0 -77
  249. package/test/router-1100/wp1-model-status.test.mjs +0 -90
  250. package/test/router-1100/wp1-status.test.mjs +0 -220
  251. package/test/router-1100/wp1-tools.test.mjs +0 -146
  252. package/test/router-1100/wp5-cli.test.mjs +0 -240
  253. package/test/router-1100/wp5-model-auto.test.mjs +0 -418
  254. package/test/router-1100/wp6-merge.test.mjs +0 -386
  255. package/test/router-1100/wp6-wake.test.mjs +0 -502
  256. package/test/router-background/audit.test.mjs +0 -37
  257. package/test/router-background/budget-ledger.test.mjs +0 -330
  258. package/test/router-background/cross-process.test.mjs +0 -222
  259. package/test/router-background/fixtures/cross-child.mjs +0 -85
  260. package/test/router-background/fixtures/real-shapes.mjs +0 -239
  261. package/test/router-background/router.test.mjs +0 -1076
  262. package/test/router-background/stream-retry.test.mjs +0 -358
  263. package/test/router-background/tool-agent.test.mjs +0 -384
  264. package/test/router-face/bridge.test.mjs +0 -169
  265. package/test/router-face/face.test.mjs +0 -316
  266. package/test/router-failclosed.test.mjs +0 -466
  267. package/test/router-identity.test.mjs +0 -384
  268. package/test/router-l1-l2.contract.test.mjs +0 -1075
  269. package/test/router-memory-tools.test.mjs +0 -262
  270. package/test/router-policy.test.mjs +0 -225
  271. package/test/router-runtime.test.mjs +0 -438
  272. package/test/router-shadow.test.mjs +0 -287
  273. package/test/router.test.mjs +0 -903
  274. package/test/run-rc.mjs +0 -315
  275. package/test/run.mjs +0 -2469
  276. package/test/safety-defaults.test.mjs +0 -181
  277. package/test/seeded-load.test.mjs +0 -436
  278. package/test/session-original.test.mjs +0 -338
  279. package/test/state-truth.test.mjs +0 -937
  280. package/test/surgery-recovery.test.mjs +0 -936
  281. package/test/t7_drive.mjs +0 -151
  282. package/test/tool-output.test.mjs +0 -393
  283. package/test/tool-schema.test.mjs +0 -177
  284. package/test/tools_contract.test.mjs +0 -716
  285. package/test/truncate-visible.test.mjs +0 -1150
  286. package/test/ui-flags.test.mjs +0 -477
  287. package/test/v4-hardening.test.mjs +0 -427
  288. package/test/version-consistency.test.mjs +0 -286
@@ -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',