@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,438 +0,0 @@
1
- // R1 runtime adapter tests (node:test). Run with:
2
- // node --test test/router-runtime.test.mjs
3
- //
4
- // This suite is deliberately separate from test/run.mjs: the existing 18 suites
5
- // are a hand-rolled harness, and nothing here needs to change their baseline.
6
- //
7
- // Every test writes only inside mkdtemp() directories: no real memory root, no
8
- // ~/.dsh, no personal store.
9
-
10
- import { test } from 'node:test';
11
- import assert from 'node:assert/strict';
12
- import { existsSync, mkdtempSync, readFileSync, rmSync, writeFileSync, mkdirSync } from 'node:fs';
13
- import { tmpdir } from 'node:os';
14
- import { join } from 'node:path';
15
-
16
- import {
17
- DEFAULT_RUNTIME_MODE,
18
- INTERCEPTED_TOOLS,
19
- MAX_RECORDS_DEFAULT,
20
- ROUTE_REFUSED_CODE,
21
- WRITE_TOOLS,
22
- buildJudgeText,
23
- classifyRisk,
24
- createRouterRuntime,
25
- normalizeMode,
26
- resolveStatePath,
27
- } from '../src/router/runtime.js';
28
- import { registerTools, TOOLS } from '../src/tools.js';
29
-
30
- const dirs = [];
31
- function tempDir() {
32
- const dir = mkdtempSync(join(tmpdir(), 'router-runtime-'));
33
- dirs.push(dir);
34
- return dir;
35
- }
36
- function statePathIn(dir) {
37
- return join(dir, 'router-runtime.jsonl');
38
- }
39
- function readRecords(path) {
40
- if (!existsSync(path)) return [];
41
- return readFileSync(path, 'utf8')
42
- .split('\n')
43
- .filter(Boolean)
44
- .map((line) => JSON.parse(line));
45
- }
46
- function cleanup() {
47
- for (const dir of dirs.splice(0)) {
48
- try {
49
- rmSync(dir, { recursive: true, force: true });
50
- } catch {
51
- /* best effort */
52
- }
53
- }
54
- }
55
- process.on('exit', cleanup);
56
-
57
- // ---------------------------------------------------------------- normalize
58
-
59
- test('modes: off is the default and unknown values never become on', () => {
60
- assert.equal(DEFAULT_RUNTIME_MODE, 'off');
61
- assert.equal(normalizeMode(undefined), 'off');
62
- assert.equal(normalizeMode(''), 'off');
63
- assert.equal(normalizeMode('SHADOW'), 'shadow');
64
- assert.equal(normalizeMode(' on '), 'on');
65
- assert.equal(normalizeMode('enabled'), 'off');
66
- assert.equal(normalizeMode('true'), 'off');
67
- assert.equal(MAX_RECORDS_DEFAULT, 1000);
68
- assert.deepEqual([...INTERCEPTED_TOOLS].sort(), ['memory_consolidate', 'memory_forget', 'memory_recall', 'memory_save']);
69
- assert.deepEqual([...WRITE_TOOLS].sort(), ['memory_consolidate', 'memory_forget', 'memory_save']);
70
- });
71
-
72
- test('state path: explicit wins, memory root is the fallback, neither means no sink', () => {
73
- assert.equal(resolveStatePath({ statePath: 'C:/tmp/x.jsonl' }).endsWith('x.jsonl'), true);
74
- assert.equal(resolveStatePath({ memoryRoot: 'C:/tmp/root' }).endsWith('router-runtime.jsonl'), true);
75
- assert.equal(resolveStatePath({}), null);
76
- });
77
-
78
- // ---------------------------------------------------------------------- off
79
-
80
- test('off: never judges, never writes, and stays synchronous', () => {
81
- const dir = tempDir();
82
- const path = statePathIn(dir);
83
- const runtime = createRouterRuntime({ mode: 'off', statePath: path });
84
- assert.equal(runtime.enabled, false);
85
-
86
- let calls = 0;
87
- const value = runtime.intercept('memory_forget', { confirm: 'FORGET' }, () => {
88
- calls += 1;
89
- return { ok: true };
90
- });
91
- assert.deepEqual(value, { ok: true });
92
- assert.equal(calls, 1, 'the tool still runs');
93
- assert.equal(typeof value.then, 'undefined', 'off must not turn a sync tool into a promise');
94
- assert.equal(existsSync(path), false, 'off writes nothing');
95
- });
96
-
97
- test('off: an unregistered tool is not judged either', () => {
98
- const dir = tempDir();
99
- const path = statePathIn(dir);
100
- const runtime = createRouterRuntime({ mode: 'shadow', statePath: path });
101
- let calls = 0;
102
- runtime.intercept('session_health', {}, () => {
103
- calls += 1;
104
- return 'x';
105
- });
106
- assert.equal(calls, 1);
107
- assert.equal(existsSync(path), false, 'session_* is out of scope');
108
- });
109
-
110
- // ------------------------------------------------------------------- shadow
111
-
112
- test('shadow: records the decision and returns the tool value unchanged', async () => {
113
- const dir = tempDir();
114
- const path = statePathIn(dir);
115
- const runtime = createRouterRuntime({ mode: 'shadow', statePath: path });
116
- const expected = { ok: true, cards: 3 };
117
- const result = await runtime.intercept('memory_forget', { confirm: 'FORGET', reason: '删除重复卡片' }, () => expected);
118
- assert.equal(result, expected, 'the exact same object comes back');
119
-
120
- const records = readRecords(path);
121
- assert.equal(records.length, 1);
122
- const record = records[0];
123
- assert.equal(record.mode, 'shadow');
124
- assert.equal(record.tool, 'memory_forget');
125
- assert.equal(record.decision.matchedRule, 'R-MEM-DISTILL');
126
- assert.equal(record.decision.ruleId, 'R-MEM-DISTILL');
127
- assert.equal(record.decision.action, 'memory.distillPropose', 'the deciding action, not decisions[0] (engram.search)');
128
- assert.equal(record.decision.level, 'X');
129
- assert.equal(record.decision.needsHuman, true);
130
- assert.equal(typeof record.latencyMs, 'number');
131
- assert.equal(record.outcome.status, 'ok');
132
- assert.equal(record.guard.verdict, 'allow');
133
- assert.equal(record.risk.level, 'delete');
134
- });
135
-
136
- test('shadow: a thrown tool error is rethrown as the same object and still recorded', async () => {
137
- const dir = tempDir();
138
- const path = statePathIn(dir);
139
- const runtime = createRouterRuntime({ mode: 'shadow', statePath: path });
140
- const boom = Object.assign(new Error('E_RECALL_NO_MATCH: nothing'), { code: 'E_RECALL_NO_MATCH' });
141
- const thrown = await runtime
142
- .intercept('memory_recall', { query: '听觉训练' }, () => {
143
- throw boom;
144
- })
145
- .then(
146
- () => null,
147
- (error) => error,
148
- );
149
- assert.equal(thrown, boom, 'identity of the error object is preserved');
150
- const [record] = readRecords(path);
151
- assert.equal(record.outcome.status, 'error');
152
- assert.equal(record.outcome.code, 'E_RECALL_NO_MATCH');
153
- assert.equal(record.guard.verdict, 'allow');
154
- });
155
-
156
- test('shadow: a read is judged and recorded but never refused', async () => {
157
- const dir = tempDir();
158
- const path = statePathIn(dir);
159
- const runtime = createRouterRuntime({ mode: 'shadow', statePath: path });
160
- const value = await runtime.intercept('memory_recall', { query: '改名 小蓝' }, () => 'cards');
161
- assert.equal(value, 'cards');
162
- const [record] = readRecords(path);
163
- assert.equal(record.decision.matchedRule, 'R-ID-CONSENT');
164
- assert.equal(record.guard.verdict, 'allow');
165
- assert.equal(runtime.stats().denied, 0);
166
- });
167
-
168
- // ----------------------------------------------------------------------- on
169
-
170
- test('on: a confirmed delete is refused and the underlying tool is not called', async () => {
171
- const dir = tempDir();
172
- const path = statePathIn(dir);
173
- const runtime = createRouterRuntime({ mode: 'on', statePath: path });
174
- let calls = 0;
175
- const error = await runtime
176
- .intercept('memory_forget', { confirm: 'FORGET' }, () => {
177
- calls += 1;
178
- return 'deleted';
179
- })
180
- .then(
181
- () => null,
182
- (failure) => failure,
183
- );
184
- assert.ok(error, 'the call must reject');
185
- assert.equal(error.code, ROUTE_REFUSED_CODE);
186
- assert.equal(error.details.risk, 'delete');
187
- assert.equal(calls, 0, 'invoke is never reached');
188
- const [record] = readRecords(path);
189
- assert.equal(record.outcome.status, 'denied');
190
- assert.equal(record.guard.verdict, 'deny');
191
- assert.equal(record.mode, 'on');
192
- });
193
-
194
- test('on: a dry-run forget and a read both pass through', async () => {
195
- const dir = tempDir();
196
- const path = statePathIn(dir);
197
- const runtime = createRouterRuntime({ mode: 'on', statePath: path });
198
- assert.equal(await runtime.intercept('memory_forget', {}, () => 'preview'), 'preview');
199
- assert.equal(await runtime.intercept('memory_recall', { query: '任意' }, () => 'cards'), 'cards');
200
- const records = readRecords(path);
201
- assert.equal(records.length, 2);
202
- assert.deepEqual(records.map((r) => r.outcome.status), ['ok', 'ok']);
203
- });
204
-
205
- test('on: identity risk is refused', async () => {
206
- const dir = tempDir();
207
- const runtime = createRouterRuntime({ mode: 'on', statePath: statePathIn(dir) });
208
- const failure = await runtime.guard('memory_save', { content: '以后叫我小蓝' });
209
- assert.equal(typeof failure, 'string');
210
- assert.match(failure, /E_ROUTE_REFUSED/);
211
- assert.match(failure, /R-ID-CONSENT/);
212
- assert.equal(classifyRisk({ tool: 'memory_save', args: {}, matchedRule: 'R-ID-CONSENT', action: 'identity.hold' }).level, 'identity');
213
- });
214
-
215
- // -------------------------------------------------------------- fail-closed
216
-
217
- test('fail-closed: a broken router refuses writes but not reads, and never throws', async () => {
218
- const dir = tempDir();
219
- const path = statePathIn(dir);
220
- const runtime = createRouterRuntime({
221
- mode: 'on',
222
- statePath: path,
223
- routeImpl: () => {
224
- throw new Error('router exploded');
225
- },
226
- });
227
- let called = 0;
228
- const write = await runtime
229
- .intercept('memory_consolidate', { since: '2026-11-01' }, () => {
230
- called += 1;
231
- return 'merged';
232
- })
233
- .then(
234
- () => null,
235
- (error) => error,
236
- );
237
- assert.ok(write);
238
- assert.equal(write.code, ROUTE_REFUSED_CODE);
239
- assert.equal(called, 0);
240
- assert.equal(await runtime.intercept('memory_recall', { query: 'x' }, () => 'cards'), 'cards');
241
-
242
- const records = readRecords(path);
243
- assert.equal(records.length, 2);
244
- assert.equal(records[0].decision.failClosed, true);
245
- assert.equal(records[0].decision.ruleId, 'R-ROUTER-FAILCLOSED');
246
- assert.equal(records[1].outcome.status, 'ok', 'the read still ran');
247
- });
248
-
249
- test('fail-closed in shadow: records the failure and runs the tool anyway', async () => {
250
- const dir = tempDir();
251
- const path = statePathIn(dir);
252
- const runtime = createRouterRuntime({
253
- mode: 'shadow',
254
- statePath: path,
255
- routeImpl: () => {
256
- throw new Error('router exploded');
257
- },
258
- });
259
- assert.equal(await runtime.intercept('memory_forget', { confirm: 'FORGET' }, () => 'deleted'), 'deleted');
260
- const [record] = readRecords(path);
261
- assert.equal(record.decision.failClosed, true);
262
- assert.equal(record.outcome.status, 'ok');
263
- assert.equal(record.guard.verdict, 'allow');
264
- });
265
-
266
- // ------------------------------------------------------------------ rolling
267
-
268
- test('rolling: the file never exceeds the cap and keeps the newest lines', async () => {
269
- const dir = tempDir();
270
- const path = statePathIn(dir);
271
- const runtime = createRouterRuntime({ mode: 'shadow', statePath: path, maxRecords: 3 });
272
- for (let i = 0; i < 7; i += 1) {
273
- await runtime.intercept('memory_recall', { query: `q-${i}` }, () => `r-${i}`);
274
- }
275
- const records = readRecords(path);
276
- assert.equal(records.length, 3, 'capped at maxRecords');
277
- assert.deepEqual(
278
- records.map((r) => r.call.args.query),
279
- ['q-4', 'q-5', 'q-6'],
280
- 'the newest three survive',
281
- );
282
- assert.equal(runtime.stats().recorded, 7);
283
- });
284
-
285
- test('rolling: rotation is atomic and leaves no stray tmp file', async () => {
286
- const dir = tempDir();
287
- const path = statePathIn(dir);
288
- const runtime = createRouterRuntime({ mode: 'shadow', statePath: path, maxRecords: 2 });
289
- for (let i = 0; i < 4; i += 1) await runtime.intercept('memory_recall', { query: `q-${i}` }, () => 'ok');
290
- assert.equal(existsSync(`${path}.tmp-${process.pid}`), false);
291
- assert.equal(readRecords(path).length, 2);
292
- });
293
-
294
- // -------------------------------------------------------------- sink broken
295
-
296
- test('a broken record sink never changes what the tool does', async () => {
297
- const dir = tempDir();
298
- const blocker = join(dir, 'not-a-dir');
299
- writeFileSync(blocker, 'x', 'utf8');
300
- const runtime = createRouterRuntime({ mode: 'shadow', statePath: join(blocker, 'router-runtime.jsonl') });
301
- assert.equal(await runtime.intercept('memory_recall', { query: 'q' }, () => 'cards'), 'cards');
302
- assert.equal(runtime.stats().recorded, 0, 'nothing could be recorded');
303
- assert.equal(runtime.stats().judged, 1, 'the judgement still happened');
304
- });
305
-
306
- // ----------------------------------------------------------------- coercion
307
-
308
- test('judge text carries the tool name and the flag values', () => {
309
- const text = buildJudgeText('memory_forget', { confirm: 'FORGET', reason: '删除重复', topK: 5, nested: { deep: '清掉' } });
310
- assert.match(text, /memory_forget/);
311
- assert.match(text, /confirm=forget/);
312
- assert.match(text, /删除重复/);
313
- assert.match(text, /清掉/, 'nested strings are flattened');
314
- assert.ok(text.length <= 2000);
315
- });
316
-
317
- // -------------------------------------------------------------- integration
318
-
319
- function fakeCtx() {
320
- const registered = [];
321
- const guards = [];
322
- return {
323
- registered,
324
- guards,
325
- tools: {
326
- register(definition) {
327
- registered.push(definition);
328
- return () => {};
329
- },
330
- guard(fn) {
331
- guards.push(fn);
332
- return () => {};
333
- },
334
- },
335
- };
336
- }
337
-
338
- test('registerTools: shadow wraps execute and records, without touching the result', async () => {
339
- const dir = tempDir();
340
- const path = statePathIn(dir);
341
- const runtime = createRouterRuntime({ mode: 'shadow', statePath: path });
342
- const ctx = fakeCtx();
343
- const count = await registerTools(ctx, {
344
- defineTool: (definition) => definition,
345
- memoryRoot: dir,
346
- memRoot: dir,
347
- routerRuntime: runtime,
348
- });
349
- assert.equal(count, TOOLS.length);
350
- assert.equal(ctx.registered.length, TOOLS.length);
351
- assert.equal(ctx.guards.length, 1, 'the guard is registered for memory_save');
352
-
353
- const forget = ctx.registered.find((tool) => tool.name === 'memory_forget');
354
- const preview = await forget.execute({}, {});
355
- assert.equal(preview.ok, true);
356
- assert.equal(preview.dryRun !== false, true, 'no confirm means a preview');
357
- const [record] = readRecords(path);
358
- assert.equal(record.tool, 'memory_forget');
359
- assert.equal(record.outcome.status, 'ok');
360
- });
361
-
362
- test('registerTools: on refuses through execute, and the guard only covers foreign tools', async () => {
363
- const dir = tempDir();
364
- const path = statePathIn(dir);
365
- const runtime = createRouterRuntime({ mode: 'on', statePath: path, ownTools: TOOLS.map((t) => t.name) });
366
- const ctx = fakeCtx();
367
- await registerTools(ctx, { defineTool: (definition) => definition, memoryRoot: dir, memRoot: dir, routerRuntime: runtime });
368
-
369
- const forget = ctx.registered.find((tool) => tool.name === 'memory_forget');
370
- const failure = await forget.execute({ confirm: 'FORGET' }, {}).then(
371
- () => null,
372
- (error) => error,
373
- );
374
- assert.equal(failure.code, ROUTE_REFUSED_CODE);
375
-
376
- const guard = ctx.guards[0];
377
- assert.equal(guard({ name: 'memory_recall', arguments: { query: 'x' } }), undefined, 'own tools are skipped by the guard');
378
- assert.equal(typeof guard({ name: 'memory_save', arguments: { content: '以后叫我小蓝' } }), 'string');
379
- assert.equal(guard({ name: 'memory_save', arguments: { content: '普通事实' } }), undefined);
380
- });
381
-
382
- test('registerTools: off registers no guard and does not touch the routing layer', async () => {
383
- const dir = tempDir();
384
- const ctx = fakeCtx();
385
- const runtime = createRouterRuntime({ mode: 'off', statePath: statePathIn(dir) });
386
- await registerTools(ctx, { defineTool: (definition) => definition, memoryRoot: dir, memRoot: dir, routerRuntime: runtime });
387
- assert.equal(ctx.guards.length, 0);
388
- assert.equal(existsSync(statePathIn(dir)), false);
389
- });
390
-
391
- test('registerTools without a runtime behaves exactly like the old build', async () => {
392
- const dir = tempDir();
393
- const ctx = fakeCtx();
394
- await registerTools(ctx, { defineTool: (definition) => definition, memoryRoot: dir, memRoot: dir });
395
- assert.equal(ctx.guards.length, 0);
396
- const forget = ctx.registered.find((tool) => tool.name === 'memory_forget');
397
- const preview = await forget.execute({}, {});
398
- assert.equal(preview.ok, true);
399
- assert.equal(existsSync(join(dir, 'router-runtime.jsonl')), false);
400
- });
401
-
402
- // --------------------------------------------------------------- guard edge
403
-
404
- test('guard: a router exception in shadow allows the call and never throws', () => {
405
- const dir = tempDir();
406
- const runtime = createRouterRuntime({
407
- mode: 'shadow',
408
- statePath: statePathIn(dir),
409
- routeImpl: () => {
410
- throw new Error('exploded');
411
- },
412
- });
413
- assert.equal(runtime.guard('memory_save', { content: 'x' }), undefined);
414
- });
415
-
416
- test('guard: refuses fail-closed writes in on mode without throwing', () => {
417
- const dir = tempDir();
418
- const runtime = createRouterRuntime({
419
- mode: 'on',
420
- statePath: statePathIn(dir),
421
- routeImpl: () => {
422
- throw new Error('exploded');
423
- },
424
- });
425
- const reason = runtime.guard('memory_save', { content: 'x' });
426
- assert.equal(typeof reason, 'string');
427
- assert.match(reason, /E_ROUTE_REFUSED/);
428
- });
429
-
430
- test('guard: an unwritable sink still returns a decision (recording is best effort)', () => {
431
- const dir = tempDir();
432
- mkdirSync(join(dir, 'ro'), { recursive: true });
433
- const blocker = join(dir, 'ro', 'file');
434
- writeFileSync(blocker, 'x', 'utf8');
435
- const runtime = createRouterRuntime({ mode: 'on', statePath: join(blocker, 'x.jsonl') });
436
- const reason = runtime.guard('memory_save', { content: '以后叫我小蓝' });
437
- assert.equal(typeof reason, 'string', 'the refusal does not depend on the record landing');
438
- });