@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
@@ -1,287 +0,0 @@
1
- #!/usr/bin/env node
2
- /**
3
- * 影子模式单测:证明 shadow.mjs「只记录、不执行、不越界写」。
4
- *
5
- * 既可以被 test/run.mjs 当作套件调用(runShadowSuite),也可以单独跑:
6
- * node test/router-shadow.test.mjs
7
- */
8
-
9
- import { mkdtempSync, readFileSync, readdirSync, rmSync, writeFileSync } from 'node:fs';
10
- import { tmpdir } from 'node:os';
11
- import path from 'node:path';
12
- import { fileURLToPath, pathToFileURL } from 'node:url';
13
- import { spawnSync } from 'node:child_process';
14
-
15
- import { RULES, route } from '../src/router/route.js';
16
- import { loadFixtures, fixtureInput, validateWriteScope } from '../src/router/judge.mjs';
17
- import {
18
- SHADOW_CODES, SHADOW_MODE, MAX_DECISIONS,
19
- analyze, appendRecords, checkTable, computeMetrics, guard, pickReviewSample,
20
- sampleHit, scoreReview, validWriteScope,
21
- } from '../src/router/shadow.mjs';
22
-
23
- const HERE = path.dirname(fileURLToPath(import.meta.url));
24
- const REPO = path.resolve(HERE, '..');
25
- const SHADOW = path.join(REPO, 'src', 'router', 'shadow.mjs');
26
-
27
- const { fixtures } = loadFixtures(path.join(REPO, 'src', 'router', 'fixtures'));
28
-
29
- function fakeRule(over = {}) {
30
- return {
31
- id: over.id || 'R-TEST',
32
- priority: over.priority ?? 10,
33
- kind: over.kind || '*',
34
- keywordKeys: over.keywordKeys || ['测试'],
35
- matchToolKey: null,
36
- matchCtx: over.matchCtx || null,
37
- ctxOnly: false,
38
- decision: {
39
- kind: over.decisionKind || 'memory',
40
- action: over.action || 'engram.save',
41
- target: 'engram',
42
- writeScope: over.writeScope || ['memory/journal/'],
43
- needsHuman: false,
44
- },
45
- reason: '单测规则',
46
- };
47
- }
48
-
49
- function fakeResult(over = {}) {
50
- return {
51
- decisions: over.decisions || [],
52
- needsHuman: over.needsHuman ?? false,
53
- errors: over.errors || [],
54
- overrides: over.overrides || [],
55
- overrideAudit: over.overrideAudit || { applied: (over.overrides || []).length, rejected: 0, records: over.overrides || [] },
56
- };
57
- }
58
-
59
- export function runShadowSuite({ runCase, assert }) {
60
- runCase('R1-SH1', '影子模式只有 dry 一种模式,且没有执行分支(--execute 必须被拒)', () => {
61
- assert(SHADOW_MODE === 'dry', `SHADOW_MODE=${SHADOW_MODE}`);
62
- const tmp = mkdtempSync(path.join(tmpdir(), 'r1-shadow-arg-'));
63
- const run = spawnSync(process.execPath, [SHADOW, '--from-fixtures', '--out', tmp, '--execute'], { encoding: 'utf8' });
64
- rmSync(tmp, { recursive: true, force: true });
65
- assert(run.status === 1, `--execute 应被拒,实际 exit=${run.status}`);
66
- assert(/未知参数/.test(run.stderr), `stderr 未说明拒绝原因:${run.stderr}`);
67
- });
68
-
69
- runCase('R1-SH2', '19 条 fixtures:影子判定与 route() 一致,且全部标记为 record-only/refuse(不会执行)', () => {
70
- for (const fixture of fixtures) {
71
- const input = fixtureInput(fixture);
72
- const analysis = analyze(input);
73
- const base = route(input);
74
- assert(analysis.decision.matchedRule === base.matchedRule, `${fixture.id} 规则不一致`);
75
- assert(
76
- JSON.stringify(analysis.decision.decisions.map((d) => `${d.kind}:${d.action}@${d.ruleId}`))
77
- === JSON.stringify(base.decisions.map((d) => `${d.kind}:${d.action}@${d.ruleId}`)),
78
- `${fixture.id} 决策不一致`,
79
- );
80
- assert(['record-only', 'refuse'].includes(analysis.guard.action), `${fixture.id} guard.action=${analysis.guard.action}`);
81
- }
82
- });
83
-
84
- runCase('R1-SH3', '采样:同 seed 稳定复现,rate 0/1 与边界正确', () => {
85
- const key = 'T1:1:abc';
86
- const a = Array.from({ length: 200 }, (_, i) => sampleHit(`${key}:${i}`, { rate: 0.3, seed: 's1' }));
87
- const b = Array.from({ length: 200 }, (_, i) => sampleHit(`${key}:${i}`, { rate: 0.3, seed: 's1' }));
88
- assert(JSON.stringify(a) === JSON.stringify(b), '同 seed 采样不稳定');
89
- const hits = a.filter(Boolean).length;
90
- assert(hits > 20 && hits < 120, `0.3 采样命中 ${hits}/200 明显偏离`);
91
- assert(sampleHit(key, { rate: 0 }) === false, 'rate 0 应为 false');
92
- assert(sampleHit(key, { rate: 1 }) === true, 'rate 1 应为 true');
93
- });
94
-
95
- runCase('R1-SH4', '规则表体检:空表/缺 id/priority 倒序 → E_SHADOW_TABLE', () => {
96
- assert(checkTable(RULES).ok === true, `真实规则表未通过体检:${JSON.stringify(checkTable(RULES).errors)}`);
97
- const empty = checkTable([]);
98
- assert(empty.ok === false && empty.errors.some((e) => e.code === SHADOW_CODES.TABLE), '空表未被拦');
99
- const broken = checkTable([
100
- { ...fakeRule(), id: '' },
101
- { ...fakeRule({ id: 'R-A' }), priority: 5 },
102
- { ...fakeRule({ id: 'R-B' }), priority: 9 },
103
- ]);
104
- assert(broken.ok === false, '坏表未被拦');
105
- assert(broken.errors.some((e) => e.message.includes('优先级')), '未报优先级倒序');
106
- assert(broken.errors.some((e) => e.message.includes('无 id')), '缺 id 的规则未报');
107
- });
108
-
109
- runCase('R1-SH5', '空判定 → E_SHADOW_UNMATCHED + needsHuman + refuse', () => {
110
- const analysis = analyze({ caseId: 'X', turn: 1, utterance: '完全无法归类的一句话 zzz', ctx: {} });
111
- assert(analysis.decision.matchedRule === null, '不该有规则命中');
112
- assert(analysis.guard.ok === false, '空判定必须被拦');
113
- assert(analysis.guard.errors.some((e) => e.code === SHADOW_CODES.UNMATCHED), '缺 UNMATCHED');
114
- assert(analysis.guard.needsHuman === true, 'needsHuman 应为 true');
115
- assert(analysis.guard.action === 'refuse', 'action 应为 refuse');
116
- });
117
-
118
- runCase('R1-SH6', 'writeScope 越界 → E_SHADOW_SCOPE(盘符/穿越/绝对路径/未知前缀)', () => {
119
- const bad = ['Z:\\dsh-memory\\x', '../../etc/passwd', '/etc/passwd', '~/x', 'unknown/dir', 'C:/x'];
120
- for (const scope of bad) {
121
- const rules = [fakeRule({ writeScope: [scope] })];
122
- const result = fakeResult({
123
- decisions: [{ kind: 'memory', action: 'engram.save', ruleId: 'R-TEST', writeScope: [scope] }],
124
- });
125
- const verdict = guard({ utterance: '测试' }, result, { rules });
126
- assert(verdict.ok === false, `scope=${scope} 未被拦`);
127
- assert(verdict.errors.some((e) => e.code === SHADOW_CODES.SCOPE), `scope=${scope} 缺 SCOPE`);
128
- }
129
- for (const scope of ['memory/journal/2026-11.md', 'taskboard:R1', 'sandbox:r1', 'evidence:x.jsonl', '']) {
130
- assert(validWriteScope(scope) === true, `合法 scope 被误判:${scope}`);
131
- }
132
- });
133
-
134
- runCase('R1-SH7', '决策数爆炸 → E_SHADOW_EXPLOSION', () => {
135
- const rules = [fakeRule()];
136
- const decisions = Array.from({ length: MAX_DECISIONS + 1 }, () => ({ kind: 'memory', action: 'engram.save', ruleId: 'R-TEST', writeScope: ['memory/journal/'] }));
137
- const verdict = guard({ utterance: '测试' }, fakeResult({ decisions }), { rules });
138
- assert(verdict.ok === false, '爆炸未被拦');
139
- assert(verdict.errors.some((e) => e.code === SHADOW_CODES.EXPLOSION), '缺 EXPLOSION');
140
- });
141
-
142
- runCase('R1-SH8', '同优先级双命中 → E_SHADOW_AMBIGUOUS', () => {
143
- const rules = [fakeRule({ id: 'R-A', priority: 50 }), fakeRule({ id: 'R-B', priority: 50, action: 'journal.append', writeScope: ['memory/journal/'] })];
144
- const verdict = guard(
145
- { utterance: '测试' },
146
- fakeResult({ decisions: [{ kind: 'memory', action: 'engram.save', ruleId: 'R-A', writeScope: ['memory/journal/'] }] }),
147
- { rules },
148
- );
149
- assert(verdict.ok === false, '歧义未被拦');
150
- assert(verdict.errors.some((e) => e.code === SHADOW_CODES.AMBIGUOUS), '缺 AMBIGUOUS');
151
- });
152
-
153
- runCase('R1-SH9', 'override 指向不存在的规则 → E_SHADOW_OVERRIDE;route 自身报错 → 升级为拒绝', () => {
154
- const rules = [fakeRule()];
155
- const verdict = guard(
156
- { utterance: '测试' },
157
- fakeResult({
158
- decisions: [{ kind: 'memory', action: 'engram.save', ruleId: 'R-TEST', writeScope: ['memory/journal/'], overridden: { ruleId: 'R-NOPE' } }],
159
- overrides: [{ ruleId: 'R-NOPE', reason: 'x' }],
160
- }),
161
- { rules },
162
- );
163
- assert(verdict.ok === false && verdict.errors.some((e) => e.code === SHADOW_CODES.OVERRIDE), '错 ruleId override 未被拦');
164
-
165
- const withRouteError = guard(
166
- { utterance: '测试' },
167
- fakeResult({
168
- decisions: [{ kind: 'reply', action: 'guard.refuse', ruleId: 'R-TEST', writeScope: [] }],
169
- errors: [{ code: 'E_ROUTE_OVERRIDE_UNJUSTIFIED', message: 'x' }],
170
- needsHuman: true,
171
- }),
172
- { rules },
173
- );
174
- assert(withRouteError.ok === false, 'route 的错必须升级为拒绝');
175
- assert(withRouteError.errors.some((e) => e.code === 'E_ROUTE_OVERRIDE_UNJUSTIFIED'), '未透传 route 错误码');
176
- });
177
-
178
- runCase('R1-SH10', 'writeScope 口径与 judge.validateWriteScope 一致(空串除外);字符串入参不被放行', () => {
179
- const scopes = ['memory/journal/a.md', 'memory/', 'taskboard:R1', 'sandbox:x', 'Z:\\dsh-memory', 'C:/tmp', '../../x', '/etc/passwd', '~/x', 'unknown/', 'evidence:r1.jsonl'];
180
- for (const scope of scopes) {
181
- const mine = validWriteScope(scope);
182
- // judge 的 validateWriteScope 契约为「数组入参」(内部 asArray 只认数组)。
183
- const theirs = validateWriteScope([scope]).length === 0;
184
- assert(mine === theirs, `scope=${JSON.stringify(scope)} shadow=${mine} judge=${theirs}`);
185
- }
186
- // 空串:judge 视为「空条目」报错,影子视为「不声明写入」。两者都不会把空串当合法落点,
187
- // 这里把差异显式钉住,防止哪天被误读成「两边都放行」。
188
- assert(validWriteScope('') === true && validateWriteScope(['']).length === 1, '空串语义与预期不符');
189
- assert(validateWriteScope([]).length === 0, '空数组应合法(不写)');
190
- // 影子层对「裸字符串」也严格判:避免把 string 误当数组而静默放行(judge 的 asArray 有此类型脆弱点)。
191
- assert(validWriteScope('Z:\\dsh-memory') === false, 'shadow 对裸字符串放行了越界 scope');
192
- });
193
-
194
- runCase('R1-SH11', 'CLI 只写 outDir:fixtures 全跑 + 抽 5 条人工判读,产物只有两个 jsonl', () => {
195
- const out = mkdtempSync(path.join(tmpdir(), 'r1-shadow-out-'));
196
- const run = spawnSync(process.execPath, [SHADOW, '--from-fixtures', '--out', out, '--date', '2026-11-03', '--review-sample', '5', '--json'], { encoding: 'utf8' });
197
- assert(run.status === 0, `shadow CLI 失败:${run.stderr}`);
198
- const files = readdirSync(out).sort();
199
- assert(JSON.stringify(files) === JSON.stringify(['decisions-2026-11-03.jsonl', 'review-2026-11-03.jsonl']), `产物不符:${files}`);
200
- const lines = readFileSync(path.join(out, 'decisions-2026-11-03.jsonl'), 'utf8').split('\n').filter(Boolean);
201
- assert(lines.length === 19, `应有 19 条记录,实际 ${lines.length}`);
202
- for (const line of lines) {
203
- const record = JSON.parse(line);
204
- assert(record.mode === 'dry', '记录 mode 必须是 dry');
205
- assert(record.human && record.human.verdict === null, 'human.verdict 应为 null');
206
- assert(!('toolResult' in record) && !('executed' in record), '记录里不该有执行结果');
207
- assert(['record-only', 'refuse'].includes(record.guard.action), `guard.action=${record.guard.action}`);
208
- }
209
- const review = readFileSync(path.join(out, 'review-2026-11-03.jsonl'), 'utf8').split('\n').filter(Boolean);
210
- assert(review.length === 5, `人工判读抽样应为 5,实际 ${review.length}`);
211
- rmSync(out, { recursive: true, force: true });
212
- });
213
-
214
- runCase('R1-SH12', 'appendRecords 只写 outDir 内的 decisions-<date>.jsonl(含 .. 的 outDir 先归一化)', () => {
215
- const out = mkdtempSync(path.join(tmpdir(), 'r1-shadow-guard-'));
216
- let threw = '';
217
- try {
218
- appendRecords([{ a: 1 }], { outDir: out, date: '2026-11-03' });
219
- } catch (error) {
220
- threw = error.message;
221
- }
222
- assert(threw === '', `正常写入不该抛错:${threw}`);
223
- const file = path.join(out, 'decisions-2026-11-03.jsonl');
224
- assert(readFileSync(file, 'utf8').trim() === JSON.stringify({ a: 1 }), '写入内容不符');
225
-
226
- // outDir 里带 `..` 时必须先归一化:落点只能是归一化目录,不能出现「夹带穿越段」的第三处路径。
227
- const nested = path.join(out, 'sub', '..', 'escape');
228
- const written = appendRecords([{ b: 2 }], { outDir: nested, date: '2026-11-03' });
229
- assert(path.dirname(written.file) === path.resolve(nested), `落点未归一化:${written.file}`);
230
- assert(readdirSync(path.resolve(nested)).join(',') === 'decisions-2026-11-03.jsonl', '归一化目录里出现了额外文件');
231
- rmSync(out, { recursive: true, force: true });
232
- });
233
-
234
- runCase('R1-SH13', '指标:needsHuman/歧义/ctx/不一致率计算正确', () => {
235
- const records = [
236
- { guard: { needsHuman: true, action: 'refuse', errors: [{ code: SHADOW_CODES.AMBIGUOUS }] }, decision: { matchedRule: 'R-A', decisions: [{ kind: 'memory', action: 'engram.save' }], confidence: 0.9 } },
237
- { guard: { needsHuman: false, action: 'record-only', errors: [] }, decision: { matchedRule: 'R-A', decisions: [{ kind: 'reply', action: 'reply.only' }], confidence: 0.75 } },
238
- { guard: { needsHuman: false, action: 'record-only', errors: [] }, decision: { matchedRule: 'R-B', decisions: [], confidence: 0.5 } },
239
- { guard: { needsHuman: true, action: 'refuse', errors: [{ code: SHADOW_CODES.CTX }] }, decision: { matchedRule: null, decisions: [{ kind: 'tool', action: 'read' }], confidence: 0 } },
240
- ];
241
- const metrics = computeMetrics(records);
242
- assert(metrics.total === 4, 'total');
243
- assert(metrics.rates.needsHuman === 50, `needsHuman=${metrics.rates.needsHuman}`);
244
- assert(metrics.rates.guardReject === 50, `guardReject=${metrics.rates.guardReject}`);
245
- assert(metrics.rates.ambiguous === 25, `ambiguous=${metrics.rates.ambiguous}`);
246
- assert(metrics.rates.ctxMissing === 25, `ctx=${metrics.rates.ctxMissing}`);
247
- assert(metrics.byRule['R-A'] === 2 && metrics.byRule['(none)'] === 1, `byRule=${JSON.stringify(metrics.byRule)}`);
248
- assert(metrics.decisionsPerTurn.max === 1, 'max decisions');
249
-
250
- const sample = pickReviewSample(records.map((record, index) => ({ ...record, caseId: `c${index}`, turn: 1, input: { utterance: 'x' } })), 2);
251
- assert(sample.length === 2 && sample[0].caseId === 'c0', '高风险优先排序不对');
252
-
253
- const score = scoreReview([
254
- { caseId: 'a', human: { verdict: 'agree', note: '' } },
255
- { caseId: 'b', human: { verdict: 'disagree', note: '应派活' } },
256
- { caseId: 'c', human: { verdict: null, note: '' } },
257
- ]);
258
- assert(score.reviewed === 2 && score.disagree === 1 && score.disagreeRate === 50, `score=${JSON.stringify(score)}`);
259
- });
260
- }
261
-
262
- // ---------------------------------------------------------------------------
263
- // 单独运行时的极简 runner
264
- // ---------------------------------------------------------------------------
265
-
266
- const isDirect = Boolean(process.argv[1]) && pathToFileURL(path.resolve(process.argv[1])).href === import.meta.url;
267
-
268
- if (isDirect) {
269
- let pass = 0;
270
- let fail = 0;
271
- const assert = (cond, message) => {
272
- if (!cond) throw new Error(message || 'assert failed');
273
- };
274
- const runCase = (id, name, fn) => {
275
- try {
276
- fn();
277
- pass += 1;
278
- process.stdout.write(`PASS ${id} ${name}\n`);
279
- } catch (error) {
280
- fail += 1;
281
- process.stdout.write(`FAIL ${id} ${name}\n ${error.message}\n`);
282
- }
283
- };
284
- runShadowSuite({ runCase, assert });
285
- process.stdout.write(`\n${pass} passed, ${fail} failed\n`);
286
- process.exitCode = fail === 0 ? 0 : 1;
287
- }