@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,129 +0,0 @@
1
- // Shared fixtures for the 1.1.0 RouterService tests. Everything is local temp
2
- // storage; no host, no network, no real model.
3
-
4
- import fs from 'node:fs';
5
- import os from 'node:os';
6
- import path from 'node:path';
7
-
8
- import { MockLlm } from '../../src/router/background/mock-llm.mjs';
9
- import { createRouterService } from '../../src/router/service/service.mjs';
10
-
11
- export function tempRoot(prefix = 'longlive-router-1100-') {
12
- return fs.mkdtempSync(path.join(os.tmpdir(), prefix));
13
- }
14
-
15
- export function writeMemory(memoryRoot, options = {}) {
16
- fs.mkdirSync(path.join(memoryRoot, 'handover'), { recursive: true });
17
- fs.mkdirSync(path.join(memoryRoot, 'topics'), { recursive: true });
18
- if (options.state !== false) {
19
- fs.writeFileSync(path.join(memoryRoot, 'STATE.md'), [
20
- '# STATE',
21
- '',
22
- '## 我在哪',
23
- options.where ?? '在写 RouterService 测试。',
24
- '',
25
- '## 在等什么',
26
- options.waiting ?? '等一次 tick。',
27
- '',
28
- '## 最近三件',
29
- options.recent ?? '- 写完了上下文组装\n- 在跑状态机测试\n- 还没写报告',
30
- '',
31
- ].join('\n'), 'utf8');
32
- }
33
- for (const [name, body] of Object.entries(options.handovers ?? {
34
- '2026-11-04-router.md': '# 交接卡\n\nRouterService 第 1 阶段。\n',
35
- })) {
36
- fs.writeFileSync(path.join(memoryRoot, 'handover', name), body, 'utf8');
37
- }
38
- if (options.index !== false) {
39
- fs.writeFileSync(path.join(memoryRoot, 'INDEX.md'), [
40
- '# INDEX',
41
- '',
42
- '| 主题 | 文件 |',
43
- '|---|---|',
44
- '| 测试 | topics/test.md |',
45
- '',
46
- ].join('\n'), 'utf8');
47
- }
48
- for (const [name, body] of Object.entries(options.cards ?? {
49
- 'test.md': '# 测试卡\n\nRouterService 的本地测试。\n',
50
- })) {
51
- fs.writeFileSync(path.join(memoryRoot, 'topics', name), body, 'utf8');
52
- }
53
- return memoryRoot;
54
- }
55
-
56
- export function makeService(options = {}) {
57
- const temp = options.temp ?? tempRoot();
58
- const memoryRoot = options.memoryRoot ?? path.join(temp, 'memory');
59
- fs.mkdirSync(memoryRoot, { recursive: true });
60
- if (options.memory !== false) writeMemory(memoryRoot, options.memoryOptions ?? {});
61
- const vaultDir = options.vaultDir ?? path.join(temp, 'vault');
62
- const llm = options.llm === undefined ? new MockLlm(options.llmOptions ?? {}) : options.llm;
63
- const config = {
64
- enabled: true,
65
- provider: 'mock',
66
- model: 'mock-1',
67
- memoryRoot,
68
- vaultDir,
69
- tickMs: 60000,
70
- maxTokensPerRun: 50000,
71
- maxTokensPerDay: 150000,
72
- callMaxTokens: 256,
73
- maxAttempts: 1,
74
- maxConsecutiveErrors: 3,
75
- disposeTimeoutMs: 500,
76
- ...options.config,
77
- };
78
- const service = createRouterService(
79
- { logger: options.logger ?? (() => ({ warn: () => {}, info: () => {} })) },
80
- config,
81
- {
82
- llm,
83
- memoryRoot,
84
- installTimers: false,
85
- installListener: false,
86
- now: options.now,
87
- stability: { enabled: false, waitMs: 0, retries: 0 },
88
- ...options.deps,
89
- },
90
- );
91
- return {
92
- service,
93
- temp,
94
- memoryRoot,
95
- vaultDir,
96
- llm,
97
- config,
98
- cleanup: () => fs.rmSync(temp, { recursive: true, force: true }),
99
- };
100
- }
101
-
102
- export async function startedService(options = {}) {
103
- const env = makeService(options);
104
- const result = await env.service.start();
105
- return { ...env, result };
106
- }
107
-
108
- export function taskInput(id = 't1', overrides = {}) {
109
- return {
110
- id,
111
- type: 'question',
112
- payload: { question: '现在该做什么?' },
113
- origin: 'tool',
114
- depth: 0,
115
- ...overrides,
116
- };
117
- }
118
-
119
- export function appendTask(service, task = taskInput()) {
120
- return service.queue.writer.append(task);
121
- }
122
-
123
- export function readJson(file) {
124
- return JSON.parse(fs.readFileSync(file, 'utf8'));
125
- }
126
-
127
- export function auditKinds(file) {
128
- return fs.readFileSync(file, 'utf8').trim().split('\n').filter(Boolean).map((line) => JSON.parse(line).kind);
129
- }
@@ -1,150 +0,0 @@
1
- // R-03 / R-04 regressions: the hint envelope cannot be forged or closed early
2
- // by board data, `origin` comparison is case/space insensitive, and a disabled
3
- // injector never registers a pre-step listener.
4
-
5
- import assert from 'node:assert/strict';
6
- import path from 'node:path';
7
- import test from 'node:test';
8
-
9
- import {
10
- HINT_END,
11
- HINT_MARK,
12
- HINT_TAIL,
13
- createHintInjector,
14
- renderHint,
15
- } from '../../src/router/service/hint.mjs';
16
- import { isHumanMessage } from '../../src/identity/inject-position.js';
17
- import { tempRoot } from './helpers.mjs';
18
-
19
- const ISO = '2026-11-05T02:00:00.000Z';
20
-
21
- function countOf(text, needle) {
22
- return text.split(needle).length - 1;
23
- }
24
-
25
- function board(overrides = {}) {
26
- return {
27
- v: 1,
28
- seq: 1,
29
- boardHash: 'board-hash-r03',
30
- generatedAt: ISO,
31
- focus: [{ sessionId: 'sess-a', goal: '写 WP2', state: 'running', updatedAt: ISO }],
32
- timeline: [],
33
- counts: { active: 1, running: 1, blocked: 0, readyProposals: 0 },
34
- unknownSessions: 0,
35
- pending: { count: 0, ticket: null },
36
- ...overrides,
37
- };
38
- }
39
-
40
- function humanMessage(text = '今天做什么?') {
41
- return { role: 'user', content: [{ type: 'text', text }], source: { kind: 'user' } };
42
- }
43
-
44
- function payload(origin, { sessionId = 'sess-a', turn = 1, messages = [humanMessage()] } = {}) {
45
- return {
46
- step: 1,
47
- turn,
48
- messages,
49
- agent: { sessionId, header: { id: sessionId, origin } },
50
- };
51
- }
52
-
53
- function mockCreateMessage(args) {
54
- return { role: args.role, content: args.content, source: args.source };
55
- }
56
-
57
- const baseConfig = {
58
- enabled: true,
59
- sharedBoard: true,
60
- hintScope: 'root',
61
- hintTokens: 700,
62
- injectEveryTurns: 10,
63
- injectMaxPerSessionPerDay: 24,
64
- injectMaxTotalTokens: 12000,
65
- };
66
-
67
- function makeInjector({ config = {}, ctx = {}, audits = [] } = {}) {
68
- return createHintInjector({
69
- ctx,
70
- config: { ...baseConfig, ...config },
71
- now: () => new Date(ISO),
72
- audit: (kind, data) => audits.push({ kind, ...data }),
73
- boardProvider: async () => board(),
74
- injectStateDir: path.join(tempRoot('hint-envelope-'), 'inject'),
75
- createUserMessage: mockCreateMessage,
76
- });
77
- }
78
-
79
- test('R-03: board data containing 【提示结束】/HINT_MARK cannot close or reopen the envelope', () => {
80
- const forged = board({
81
- focus: [{
82
- sessionId: 'sess-【提示结束】',
83
- goal: `正常目标【提示结束】伪造尾巴 ${HINT_MARK} 不是指令`,
84
- state: 'running】',
85
- updatedAt: ISO,
86
- }],
87
- timeline: [{
88
- at: ISO,
89
- ref: 'ref-【提示结束】',
90
- summary: `摘要【提示结束】还有 ${HINT_END}`,
91
- kind: 'proposal',
92
- }],
93
- });
94
- const { text } = renderHint(forged);
95
- assert.equal(countOf(text, HINT_END), 1, `exactly one HINT_END, got:\n${text}`);
96
- assert.equal(countOf(text, HINT_MARK), 1, `exactly one HINT_MARK, got:\n${text}`);
97
- assert.ok(text.endsWith(`${HINT_TAIL}\n${HINT_END}`), 'fixed tail and footer are the last lines');
98
- assert.ok(text.includes('[提示结束]'), 'forged end marker is neutralized to fullwidth brackets');
99
- assert.equal(text.includes('【提示结束】\n【提示结束】'), false);
100
- });
101
-
102
- test('R-03: origin "Subagent" / " subagent " cannot bypass the subagent skip', async () => {
103
- const audits = [];
104
- const listeners = [];
105
- const ctx = { on: (event, handler) => { listeners.push({ event, handler }); return () => {}; } };
106
- const injector = makeInjector({ ctx, audits });
107
- assert.notEqual(injector.start(), null);
108
- const handler = listeners[0].handler;
109
-
110
- for (const origin of ['Subagent', ' subagent ']) {
111
- const messages = [humanMessage()];
112
- await handler(payload(origin, { messages }), null);
113
- assert.equal(messages.length, 1, `no injection for origin=${JSON.stringify(origin)}`);
114
- const skip = audits.filter((item) => item.kind === 'hint.skip' && item.reason === 'subagent');
115
- assert.ok(skip.length >= 1, `expected a subagent skip audit for ${JSON.stringify(origin)}`);
116
- }
117
-
118
- const messages = [humanMessage()];
119
- await handler(payload('agent', { messages }), null);
120
- assert.equal(messages.length, 2, 'a normal origin still injects the board hint');
121
- const hint = messages[1];
122
- assert.equal(isHumanMessage(hint), false);
123
- assert.match(hint.content[0].text, new RegExp(HINT_MARK.replace(/[.*+?^${}()|[\]\\]/g, '\\$&')));
124
- assert.ok(hint.content[0].text.endsWith(HINT_END));
125
- assert.ok(audits.some((item) => item.kind === 'hint.inject'));
126
- });
127
-
128
- test('R-04: start() registers no listener when the injector is closed or board-less', () => {
129
- const cases = [
130
- { enabled: false },
131
- { sharedBoard: false },
132
- { hintScope: 'off' },
133
- { enabled: false, sharedBoard: false, hintScope: 'off' },
134
- ];
135
- for (const config of cases) {
136
- const calls = [];
137
- const ctx = { on: (event) => { calls.push(event); return () => {}; } };
138
- const injector = makeInjector({ config, ctx });
139
- assert.equal(injector.start(), null, `start() must be inert for ${JSON.stringify(config)}`);
140
- assert.equal(calls.length, 0, `ctx.on must not be called for ${JSON.stringify(config)}`);
141
- }
142
-
143
- const calls = [];
144
- const ctx = { on: (event, handler) => { calls.push({ event, handler }); return () => {}; } };
145
- const injector = makeInjector({ ctx });
146
- assert.notEqual(injector.start(), null);
147
- assert.equal(calls.length, 1);
148
- assert.equal(calls[0].event, 'agent/pre-step');
149
- assert.equal(typeof calls[0].handler, 'function');
150
- });
@@ -1,206 +0,0 @@
1
- // R-01 regression: InstanceLock must be an atomic cross-process mutex.
2
- //
3
- // These are REAL child processes (`process.execPath` + test/fixtures/lock-child.mjs),
4
- // never in-process mocks: six siblings race open(wx) on the same lock file and
5
- // only one may report state:'acquired'; the other five must see 'standby' with a
6
- // live holder, and no child may crash with an uncaught fs error.
7
-
8
- import assert from 'node:assert/strict';
9
- import { spawn } from 'node:child_process';
10
- import fs from 'node:fs';
11
- import os from 'node:os';
12
- import path from 'node:path';
13
- import test from 'node:test';
14
-
15
- import { InstanceLock } from '../../src/router/service/lock.mjs';
16
- import { tempRoot } from './helpers.mjs';
17
-
18
- const CHILD = path.resolve('test/fixtures/lock-child.mjs');
19
- const CHILD_TIMEOUT_MS = 15_000;
20
-
21
- function runChild(args, timeoutMs = CHILD_TIMEOUT_MS) {
22
- return new Promise((resolve) => {
23
- const child = spawn(process.execPath, [CHILD, ...args], {
24
- stdio: ['ignore', 'pipe', 'pipe'],
25
- windowsHide: true,
26
- });
27
- let stdout = '';
28
- let stderr = '';
29
- let settled = false;
30
- const finish = (value) => {
31
- if (settled) return;
32
- settled = true;
33
- resolve(value);
34
- };
35
- const timer = setTimeout(() => {
36
- try { child.kill('SIGKILL'); } catch { /* already gone */ }
37
- finish({ timedOut: true, code: null, signal: null, stdout, stderr });
38
- }, timeoutMs);
39
- child.stdout.on('data', (chunk) => { stdout += chunk; });
40
- child.stderr.on('data', (chunk) => { stderr += chunk; });
41
- child.on('error', (error) => {
42
- clearTimeout(timer);
43
- finish({ error: String(error?.message ?? error), code: null, signal: null, stdout, stderr });
44
- });
45
- child.on('close', (code, signal) => {
46
- clearTimeout(timer);
47
- finish({ code, signal, stdout, stderr });
48
- });
49
- });
50
- }
51
-
52
- async function waitFor(predicate, timeoutMs = 5_000) {
53
- const deadline = Date.now() + timeoutMs;
54
- while (Date.now() < deadline) {
55
- if (predicate()) return true;
56
- await new Promise((resolve) => setTimeout(resolve, 10));
57
- }
58
- return false;
59
- }
60
-
61
- function readLock(file) {
62
- try { return JSON.parse(fs.readFileSync(file, 'utf8')); } catch { return null; }
63
- }
64
-
65
- test('R-01: six real processes race one lock — exactly one acquires, five standby', async () => {
66
- const temp = tempRoot('lock-crossproc-');
67
- try {
68
- const file = path.join(temp, 'router.lock');
69
- const startAt = Date.now() + 900;
70
- const outs = [];
71
- const jobs = [];
72
- for (let i = 0; i < 6; i += 1) {
73
- const out = path.join(temp, `child-${i}.json`);
74
- outs.push(out);
75
- jobs.push(runChild([
76
- '--file', file,
77
- '--out', out,
78
- '--runId', `run-${i}`,
79
- '--startAt', String(startAt),
80
- '--holdMs', '1500',
81
- ]));
82
- }
83
- const runs = await Promise.all(jobs);
84
- for (const run of runs) {
85
- assert.equal(run.timedOut, undefined, `child timed out: ${JSON.stringify(run)}`);
86
- assert.equal(run.error, undefined, `child spawn error: ${JSON.stringify(run)}`);
87
- assert.equal(run.code, 0, `child exit ${run.code}: ${run.stderr}`);
88
- assert.equal(run.stderr.includes('EPERM'), false, `uncaught EPERM surfaced: ${run.stderr}`);
89
- }
90
-
91
- const results = outs.map((out) => JSON.parse(fs.readFileSync(out, 'utf8')));
92
- assert.equal(results.some((row) => row.crash), false, JSON.stringify(results.filter((row) => row.crash)));
93
- const acquired = results.filter((row) => row.state === 'acquired');
94
- const standby = results.filter((row) => row.state === 'standby');
95
- assert.equal(acquired.length, 1, `expected exactly one acquired: ${JSON.stringify(results)}`);
96
- assert.equal(standby.length, 5, `expected five standby: ${JSON.stringify(results)}`);
97
- assert.equal(new Set(results.map((row) => row.pid)).size, 6, 'all six results come from distinct pids');
98
-
99
- const winner = acquired[0];
100
- assert.equal(typeof winner.runId, 'string');
101
- for (const row of standby) {
102
- assert.equal(row.ok, false);
103
- if (row.holderRunId !== null) assert.equal(row.holderRunId, winner.runId, 'loser saw the winner as holder');
104
- }
105
- assert.ok(standby.some((row) => row.holderRunId === winner.runId), 'at least one loser read the live holder');
106
-
107
- // Every child (including the holder after its 1.5 s hold) has exited now.
108
- assert.equal(fs.existsSync(file), false, 'holder released its own lock');
109
- assert.equal(fs.readdirSync(temp).some((name) => name.includes('reclaimed')), false, 'no takeover was needed');
110
- } finally {
111
- fs.rmSync(temp, { recursive: true, force: true });
112
- }
113
- });
114
-
115
- test('R-01: a second process gets standby while the holder lives, then acquires after release', async () => {
116
- const temp = tempRoot('lock-second-');
117
- try {
118
- const file = path.join(temp, 'router.lock');
119
- const out = path.join(temp, 'holder.json');
120
- const holderRun = runChild([
121
- '--file', file,
122
- '--out', out,
123
- '--runId', 'holder-run',
124
- '--startAt', '0',
125
- '--holdMs', '1500',
126
- ]);
127
- assert.equal(await waitFor(() => fs.existsSync(out)), true, 'holder never reported its acquire');
128
- const holder = JSON.parse(fs.readFileSync(out, 'utf8'));
129
- assert.equal(holder.state, 'acquired');
130
- assert.equal(readLock(file)?.runId, 'holder-run');
131
-
132
- const second = new InstanceLock({ file, runId: 'second-run' });
133
- const standby = second.acquire();
134
- assert.equal(standby.ok, false);
135
- assert.equal(standby.state, 'standby');
136
- assert.equal(standby.holder?.runId, 'holder-run');
137
-
138
- const held = await holderRun;
139
- assert.equal(held.code, 0, held.stderr);
140
- assert.equal(fs.existsSync(file), false, 'holder released before exit');
141
-
142
- const acquired = second.acquire();
143
- assert.equal(acquired.ok, true, JSON.stringify(acquired));
144
- assert.equal(acquired.state, 'acquired');
145
- assert.equal(acquired.takeover, false, 'an empty path is not a takeover');
146
- assert.equal(second.release(), true);
147
- assert.equal(fs.existsSync(file), false);
148
- } finally {
149
- fs.rmSync(temp, { recursive: true, force: true });
150
- }
151
- });
152
-
153
- test('R-01: a dead-pid stale lock is taken over with a kept evidence file', () => {
154
- const temp = tempRoot('lock-stale-');
155
- try {
156
- const file = path.join(temp, 'router.lock');
157
- const old = new Date(Date.now() - 60_000).toISOString();
158
- fs.writeFileSync(file, `${JSON.stringify({
159
- v: 1,
160
- pid: 999999,
161
- host: os.hostname(),
162
- runId: 'dead-run',
163
- nonce: 'dead-nonce',
164
- startedAt: old,
165
- heartbeatAt: old,
166
- })}\n`, 'utf8');
167
-
168
- const lock = new InstanceLock({ file, runId: 'live-run' });
169
- const result = lock.acquire();
170
- assert.equal(result.ok, true, JSON.stringify(result));
171
- assert.equal(result.state, 'acquired');
172
- assert.equal(result.takeover, true);
173
- assert.equal(result.previous?.runId, 'dead-run');
174
- const evidence = path.join(temp, result.evidence);
175
- assert.equal(fs.existsSync(evidence), true, 'old lock kept as evidence');
176
- assert.equal(JSON.parse(fs.readFileSync(evidence, 'utf8')).runId, 'dead-run');
177
- assert.equal(readLock(file)?.runId, 'live-run', 'new lock is on the canonical path');
178
- assert.equal(lock.release(), true);
179
- } finally {
180
- fs.rmSync(temp, { recursive: true, force: true });
181
- }
182
- });
183
-
184
- test('R-01: release refuses a lock whose nonce is no longer ours', () => {
185
- const temp = tempRoot('lock-release-');
186
- try {
187
- const file = path.join(temp, 'router.lock');
188
- const lock = new InstanceLock({ file, runId: 'mine' });
189
- assert.equal(lock.acquire().ok, true);
190
- const foreign = {
191
- v: 1,
192
- pid: process.pid,
193
- host: os.hostname(),
194
- runId: 'other-run',
195
- nonce: 'other-nonce',
196
- startedAt: new Date().toISOString(),
197
- heartbeatAt: new Date().toISOString(),
198
- };
199
- fs.writeFileSync(file, `${JSON.stringify(foreign)}\n`, 'utf8');
200
- assert.equal(lock.release(), false);
201
- assert.deepEqual(readLock(file), foreign, 'not-ours file left untouched');
202
- fs.unlinkSync(file);
203
- } finally {
204
- fs.rmSync(temp, { recursive: true, force: true });
205
- }
206
- });
@@ -1,184 +0,0 @@
1
- // R-02 regression: updateProposalStrict must be a cross-process CAS.
2
- //
3
- // Eight REAL child processes (`process.execPath` + test/fixtures/proposal-cas-child.mjs)
4
- // call updateProposalStrict(dir, id, expectedRev=2) at the same instant. The
5
- // inter-process `<id>.lock` must let exactly one of them write rev=3; the other
6
- // seven must fail with E_STATE_RACE (never a silent lost update, never E_STORAGE
7
- // from a 2 s contention timeout).
8
-
9
- import assert from 'node:assert/strict';
10
- import { spawn } from 'node:child_process';
11
- import fs from 'node:fs';
12
- import os from 'node:os';
13
- import path from 'node:path';
14
- import test from 'node:test';
15
-
16
- import {
17
- proposalLockPath,
18
- readProposal,
19
- scanProposalDir,
20
- updateProposalStrict,
21
- writeProposalFile,
22
- } from '../../src/router/service/store.mjs';
23
- import { tempRoot } from './helpers.mjs';
24
-
25
- const CHILD = path.resolve('test/fixtures/proposal-cas-child.mjs');
26
- const CHILD_TIMEOUT_MS = 15_000;
27
- const PROPOSAL_ID = 'p-20261105T000000-abc123';
28
-
29
- function runChild(args, timeoutMs = CHILD_TIMEOUT_MS) {
30
- return new Promise((resolve) => {
31
- const child = spawn(process.execPath, [CHILD, ...args], {
32
- stdio: ['ignore', 'pipe', 'pipe'],
33
- windowsHide: true,
34
- });
35
- let stdout = '';
36
- let stderr = '';
37
- let settled = false;
38
- const finish = (value) => {
39
- if (settled) return;
40
- settled = true;
41
- resolve(value);
42
- };
43
- const timer = setTimeout(() => {
44
- try { child.kill('SIGKILL'); } catch { /* already gone */ }
45
- finish({ timedOut: true, code: null, stderr });
46
- }, timeoutMs);
47
- child.stdout.on('data', (chunk) => { stdout += chunk; });
48
- child.stderr.on('data', (chunk) => { stderr += chunk; });
49
- child.on('error', (error) => {
50
- clearTimeout(timer);
51
- finish({ error: String(error?.message ?? error), code: null, stderr });
52
- });
53
- child.on('close', (code) => {
54
- clearTimeout(timer);
55
- finish({ code, stderr });
56
- });
57
- });
58
- }
59
-
60
- function readJsonFile(file) {
61
- return JSON.parse(fs.readFileSync(file, 'utf8'));
62
- }
63
-
64
- function setupProposal() {
65
- const temp = tempRoot('proposal-cas-');
66
- const dir = path.join(temp, 'proposals');
67
- fs.mkdirSync(dir, { recursive: true });
68
- const now = new Date().toISOString();
69
- writeProposalFile(path.join(dir, `${PROPOSAL_ID}.json`), {
70
- v: 1,
71
- id: PROPOSAL_ID,
72
- rev: 2,
73
- status: 'queued',
74
- title: 'base',
75
- createdAt: now,
76
- updatedAt: now,
77
- queue: { ticket: 'S-000001' },
78
- });
79
- return { temp, dir, file: path.join(dir, `${PROPOSAL_ID}.json`) };
80
- }
81
-
82
- test('R-02: eight real processes CAS rev=2 — exactly one writes rev=3, seven E_STATE_RACE', async () => {
83
- const env = setupProposal();
84
- try {
85
- const startAt = Date.now() + 900;
86
- const outs = [];
87
- const jobs = [];
88
- for (let i = 0; i < 8; i += 1) {
89
- const out = path.join(env.temp, `cas-${i}.json`);
90
- outs.push(out);
91
- jobs.push(runChild([
92
- '--dir', env.dir,
93
- '--id', PROPOSAL_ID,
94
- '--rev', '2',
95
- '--out', out,
96
- '--startAt', String(startAt),
97
- '--attempts', '6',
98
- '--writer', `writer-${i}`,
99
- ]));
100
- }
101
- const runs = await Promise.all(jobs);
102
- for (const run of runs) {
103
- assert.equal(run.timedOut, undefined, `child timed out: ${JSON.stringify(run)}`);
104
- assert.equal(run.error, undefined, `child spawn error: ${JSON.stringify(run)}`);
105
- assert.equal(run.code, 0, `child exit ${run.code}: ${run.stderr}`);
106
- }
107
-
108
- const results = outs.map((out) => readJsonFile(out));
109
- const winners = results.filter((row) => row.ok === true);
110
- const losers = results.filter((row) => row.ok !== true);
111
- assert.equal(winners.length, 1, `expected exactly one winner: ${JSON.stringify(results)}`);
112
- assert.equal(winners[0].rev, 3);
113
- assert.equal(losers.length, 7, JSON.stringify(results));
114
- for (const row of losers) {
115
- assert.equal(row.code, 'E_STATE_RACE', `loser must lose on rev, not storage: ${JSON.stringify(row)}`);
116
- assert.equal(row.retryable, false);
117
- }
118
- assert.equal(new Set(results.map((row) => row.pid)).size, 8, 'all eight results come from distinct pids');
119
-
120
- const finalProposal = readJsonFile(env.file);
121
- assert.equal(finalProposal.rev, 3, 'exactly one revision was written');
122
- assert.equal(finalProposal.title, winners[0].writer, 'the winner bytes are on disk');
123
- assert.equal(fs.existsSync(proposalLockPath(env.dir, PROPOSAL_ID)), false, 'no lock left behind');
124
- assert.equal(scanProposalDir(env.dir).proposals.length, 1, 'lock/evidence files are not proposals');
125
- assert.equal(scanProposalDir(env.dir).invalid.length, 0);
126
- } finally {
127
- fs.rmSync(env.temp, { recursive: true, force: true });
128
- }
129
- });
130
-
131
- test('R-02: an aged dead-pid proposal lock is reclaimed with evidence before the CAS', () => {
132
- const env = setupProposal();
133
- try {
134
- const lockFile = proposalLockPath(env.dir, PROPOSAL_ID);
135
- const old = new Date(Date.now() - 60_000);
136
- fs.writeFileSync(lockFile, `${JSON.stringify({
137
- pid: 999999,
138
- host: os.hostname(),
139
- nonce: 'dead-nonce',
140
- startedAt: old.toISOString(),
141
- })}\n`, 'utf8');
142
- fs.utimesSync(lockFile, old, old);
143
-
144
- const next = updateProposalStrict(env.dir, PROPOSAL_ID, 2, (current) => ({ title: `after-stale-${current.rev}` }));
145
- assert.equal(next.rev, 3);
146
- assert.equal(next.title, 'after-stale-2');
147
- assert.equal(readJsonFile(env.file).rev, 3);
148
- assert.equal(fs.existsSync(lockFile), false);
149
- const evidence = fs.readdirSync(env.dir).filter((name) => name.startsWith(`${PROPOSAL_ID}.lock.reclaimed-`));
150
- assert.equal(evidence.length, 1, `expected one evidence file: ${JSON.stringify(fs.readdirSync(env.dir))}`);
151
- } finally {
152
- fs.rmSync(env.temp, { recursive: true, force: true });
153
- }
154
- });
155
-
156
- test('R-02: a fresh lock held by a live pid yields retryable E_STORAGE and changes nothing', () => {
157
- const env = setupProposal();
158
- try {
159
- const lockFile = proposalLockPath(env.dir, PROPOSAL_ID);
160
- const payload = {
161
- pid: process.pid,
162
- host: os.hostname(),
163
- nonce: 'live-nonce',
164
- startedAt: new Date().toISOString(),
165
- };
166
- fs.writeFileSync(lockFile, `${JSON.stringify(payload)}\n`, 'utf8');
167
- const before = readJsonFile(env.file);
168
-
169
- assert.throws(
170
- () => updateProposalStrict(env.dir, PROPOSAL_ID, 2, { title: 'must-not-write' }, {
171
- lockWaitMs: 150,
172
- lockBackoffMs: 10,
173
- }),
174
- (error) => error?.code === 'E_STORAGE' && error.retryable === true,
175
- );
176
- assert.deepEqual(readJsonFile(env.file), before, 'proposal untouched while the lock is foreign');
177
- assert.deepEqual(readJsonFile(lockFile), payload, 'foreign lock untouched');
178
- const scanned = scanProposalDir(env.dir);
179
- assert.equal(scanned.proposals.length, 1);
180
- assert.equal(scanned.invalid.length, 0);
181
- } finally {
182
- fs.rmSync(env.temp, { recursive: true, force: true });
183
- }
184
- });