@hugesb/dsh-stream-agent 0.0.0-stage → 0.3.1

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 (158) hide show
  1. package/CHANGELOG.md +497 -0
  2. package/CONTRIBUTING.md +72 -0
  3. package/LICENSE +202 -0
  4. package/README.en.md +349 -0
  5. package/README.md +300 -3
  6. package/cordis.patch.yml +77 -0
  7. package/dist/entry/action-gate.js +206 -0
  8. package/dist/entry/adapter-kit.js +192 -0
  9. package/dist/entry/context-render.js +119 -0
  10. package/dist/entry/control-bar-cli.js +289 -0
  11. package/dist/entry/control-bar.js +123 -0
  12. package/dist/entry/control-session.js +115 -0
  13. package/dist/entry/control-state.js +125 -0
  14. package/dist/entry/cordis-compat.js +95 -0
  15. package/dist/entry/eval-probe.js +112 -0
  16. package/dist/entry/intent-log.js +121 -0
  17. package/dist/entry/json-persistence.js +306 -0
  18. package/dist/entry/loop.js +3852 -0
  19. package/dist/entry/mock-provider.js +536 -0
  20. package/dist/entry/obs-broker.js +178 -0
  21. package/dist/entry/ptc-bridge.js +405 -0
  22. package/dist/entry/state-handle.js +217 -0
  23. package/dist/entry/takeover-registry.js +60 -0
  24. package/dist/kernel/control-bar.js +559 -0
  25. package/dist/kernel/final.js +62 -0
  26. package/dist/kernel/gate.js +464 -0
  27. package/dist/kernel/modes.js +253 -0
  28. package/dist/kernel/obs.js +517 -0
  29. package/dist/kernel/parser.js +632 -0
  30. package/dist/kernel/render.js +444 -0
  31. package/dist/kernel/state.js +416 -0
  32. package/dist/version.js +9 -0
  33. package/docs/TEST-PROPOSITIONS.md +139 -0
  34. package/docs/adr-001-segment-boundary.md +61 -0
  35. package/docs/architecture.md +104 -0
  36. package/docs/desktop-ui-feasibility.md +277 -0
  37. package/docs/disabled-lines-audit.md +53 -0
  38. package/docs/limitations.md +181 -0
  39. package/docs/protocol.md +99 -0
  40. package/docs/v0.4.0-plan.md +50 -0
  41. package/eval/METRICS.md +128 -0
  42. package/eval/RESULTS.md +246 -0
  43. package/eval/tasks/fixtures/big-report.md +298 -0
  44. package/eval/tasks/fixtures/build-manifest.txt +5 -0
  45. package/eval/tasks/fixtures/deploy.yaml +4 -0
  46. package/eval/tasks/fixtures/error.log +200 -0
  47. package/eval/tasks/fixtures/features.yaml +4 -0
  48. package/eval/tasks/fixtures/pipeline.yaml +4 -0
  49. package/eval/tasks/fixtures/sales-q1.csv +61 -0
  50. package/eval/tasks/fixtures/settings.yaml +4 -0
  51. package/eval/tasks/fixtures/users-roster.json +304 -0
  52. package/eval/tasks/fixtures/users-scores.json +20 -0
  53. package/eval/tasks/gen-fixtures.cjs +80 -0
  54. package/eval/tasks/tasks.json +150 -0
  55. package/eval/tools/f6-kill-drill.cjs +176 -0
  56. package/eval/tools/f6-kill-drill.worker.cjs +131 -0
  57. package/eval/tools/gen-results.cjs +191 -0
  58. package/eval/tools/machine-test.cjs +200 -0
  59. package/eval/tools/manual-code-scenarios.md +59 -0
  60. package/eval/tools/replay-check.cjs +311 -0
  61. package/eval/tools/runner.cjs +219 -0
  62. package/eval/tools/session-log.cjs +106 -0
  63. package/eval/tools/summarize.cjs +185 -0
  64. package/eval/tools/t3-cells.cjs +173 -0
  65. package/package.json +73 -6
  66. package/patches/adapters-smoke.yml +41 -0
  67. package/patches/eval-account.yml +36 -0
  68. package/patches/eval-baseline.yml +33 -0
  69. package/patches/eval-stream-code-off.yml +46 -0
  70. package/patches/eval-stream-code-on.yml +47 -0
  71. package/patches/eval-stream.yml +54 -0
  72. package/patches/takeover.yml +42 -0
  73. package/patches/test-preset.yml +23 -0
  74. package/preset/stream/cordis.patch.yml +39 -0
  75. package/preset/stream/package.json +13 -0
  76. package/preset.yml +56 -0
  77. package/profiles/stream/README.md +66 -0
  78. package/profiles/stream/cordis.patch.yml +12 -0
  79. package/profiles/stream/package.json +17 -0
  80. package/profiles/stream-headless/package.json +16 -0
  81. package/scripts/build.mjs +103 -0
  82. package/scripts/check-consistency.mjs +146 -0
  83. package/scripts/gate.mjs +138 -0
  84. package/scripts/install-check.mjs +116 -0
  85. package/scripts/install-cycle.mjs +88 -0
  86. package/scripts/release.mjs +415 -0
  87. package/scripts/repair-session-logs.mjs +403 -0
  88. package/src/entry/action-gate.ts +206 -0
  89. package/src/entry/adapter-kit.ts +192 -0
  90. package/src/entry/context-render.ts +119 -0
  91. package/src/entry/control-bar-cli.ts +289 -0
  92. package/src/entry/control-bar.ts +123 -0
  93. package/src/entry/control-session.ts +115 -0
  94. package/src/entry/control-state.ts +125 -0
  95. package/src/entry/cordis-compat.ts +95 -0
  96. package/src/entry/eval-probe.ts +112 -0
  97. package/src/entry/intent-log.ts +121 -0
  98. package/src/entry/json-persistence.ts +306 -0
  99. package/src/entry/loop.ts +3852 -0
  100. package/src/entry/mock-provider.ts +536 -0
  101. package/src/entry/obs-broker.ts +178 -0
  102. package/src/entry/ptc-bridge.ts +405 -0
  103. package/src/entry/state-handle.ts +217 -0
  104. package/src/entry/takeover-registry.ts +60 -0
  105. package/src/kernel/control-bar.ts +559 -0
  106. package/src/kernel/final.ts +62 -0
  107. package/src/kernel/gate.ts +464 -0
  108. package/src/kernel/modes.ts +253 -0
  109. package/src/kernel/obs.ts +517 -0
  110. package/src/kernel/parser.ts +632 -0
  111. package/src/kernel/render.ts +444 -0
  112. package/src/kernel/state.ts +416 -0
  113. package/src/version.ts +9 -0
  114. package/test/activation.test.ts +187 -0
  115. package/test/adapters.test.ts +676 -0
  116. package/test/control-bar.test.ts +486 -0
  117. package/test/desktop-ui.test.ts +359 -0
  118. package/test/eval-probe.test.ts +139 -0
  119. package/test/f5-plan.test.ts +221 -0
  120. package/test/f6-intent.test.ts +168 -0
  121. package/test/f7-segment.test.ts +190 -0
  122. package/test/fix-limits.test.ts +599 -0
  123. package/test/gate.test.ts +380 -0
  124. package/test/helpers/stub-loop.ts +240 -0
  125. package/test/kernel/obs.test.ts +329 -0
  126. package/test/kernel/parser.test.ts +450 -0
  127. package/test/loop.test.ts +1393 -0
  128. package/test/mock-provider.test.ts +386 -0
  129. package/test/ptc-bridge.test.ts +356 -0
  130. package/test/render.test.ts +418 -0
  131. package/test/s2-install-check.test.ts +46 -0
  132. package/test/scenarios/3-file-basic.json +13 -0
  133. package/test/scenarios/5-file-basic.json +22 -0
  134. package/test/scenarios/burn-more.json +9 -0
  135. package/test/scenarios/degraded-final.json +10 -0
  136. package/test/scenarios/fault-abort-xml.json +11 -0
  137. package/test/scenarios/fault-malformed-command.json +12 -0
  138. package/test/scenarios/fault-midstream-abort.json +11 -0
  139. package/test/scenarios/fault-saturating-output.json +9 -0
  140. package/test/scenarios/fault-timeout.json +9 -0
  141. package/test/scenarios/peek-first.json +11 -0
  142. package/test/scenarios/peek-second.json +11 -0
  143. package/test/scenarios/peek-third.json +10 -0
  144. package/test/scenarios/recover-final.json +10 -0
  145. package/test/scenarios/reroute-first.json +17 -0
  146. package/test/scenarios/reroute-second.json +16 -0
  147. package/test/scenarios/starvation-final.json +10 -0
  148. package/test/scenarios/starvation-promote.json +11 -0
  149. package/test/scenarios/wait-tools-continue.json +10 -0
  150. package/test/scenarios/wait-tools-xml.json +22 -0
  151. package/test/scenarios/wait-tools.json +15 -0
  152. package/test/session-format.test.ts +234 -0
  153. package/test/state.test.ts +335 -0
  154. package/test/stream-v02.test.ts +264 -0
  155. package/test/v031-display.test.ts +333 -0
  156. package/ui/client.js +576 -0
  157. package/ui/index.js +282 -0
  158. package/ui/package.json +26 -0
@@ -0,0 +1,444 @@
1
+ /**
2
+ * kernel/render.ts —— 三段式上下文装配 + 前缀校验器(04 号任务书目标 B)。
3
+ *
4
+ * 装配模型:
5
+ * [ 稳定前缀 ] system 提示 + tf-* 协议说明 + 工具 schema + 任务不变量
6
+ * —— 构造期冻结,逐请求字节不变(结构性保证:只读,无任何写入路径)
7
+ * [ 追加区 ] 历史 assistant 消息 + 句柄目录增量(O3 差分注入)+ 回合冻结动态段(O4)
8
+ * —— 只追加,永不改写(唯一的例外是显式记录的整块尾部丢弃)
9
+ * [ 易变尾 ] 高增益观测注入 + tf-peek 结果 + 动态上下文 + 失败结构化错误
10
+ * —— 每请求整块重建,允许整块丢弃
11
+ *
12
+ * 前缀校验器(README 优化点 O6,fail-closed):
13
+ * - assertPrefixStable(prev, next):逐消息逐字节比较,违反抛 PrefixBrokenError,不做静默修复;
14
+ * - 只允许整块丢弃尾部(显式调用 truncateAppendTail,内部逐字节验证"只有尾部被丢弃");
15
+ * - "压缩历史"请求 → 拒绝 + 降级为尾部截断 + 记录(红线 4:禁止智能压缩/摘要);
16
+ * - render() 内置 preflight:发送前对上一请求的稳定段做逐字节断言,违反直接抛错拒绝发送。
17
+ *
18
+ * 内核层纪律:零框架依赖、无 IO(时钟注入)。
19
+ */
20
+
21
+ import { createHash } from 'node:crypto';
22
+
23
+ // ---------------------------------------------------------------------------
24
+ // 基础类型
25
+ // ---------------------------------------------------------------------------
26
+
27
+
28
+
29
+
30
+
31
+
32
+
33
+
34
+ /** 与 03 号分派 obs.ts 的 directoryDelta(sinceSeq) 返回结构兼容(结构化类型,不 import)。 */
35
+
36
+
37
+
38
+
39
+
40
+
41
+
42
+          
43
+
44
+
45
+
46
+
47
+
48
+
49
+ /** 策略事件记录(红线:不许静默)。compress-history-request = 违规拒绝(accepted:false);
50
+ * segment-drop = F7 显式段边界(accepted:true——整块丢弃、前缀基线重置并记录)。 */
51
+
52
+
53
+
54
+
55
+
56
+
57
+
58
+
59
+
60
+
61
+
62
+
63
+
64
+
65
+ // ---------------------------------------------------------------------------
66
+ // 错误类型
67
+ // ---------------------------------------------------------------------------
68
+
69
+ export class PrefixBrokenError extends Error {
70
+ index ;
71
+ expected ;
72
+ actual ;
73
+ constructor(index , expected , actual , why ) {
74
+ super(
75
+ `前缀校验失败(fail-closed,拒绝发送不做静默修复):第 ${index} 条消息${why}。` +
76
+ ` 期望: ${truncate(expected)} 实际: ${truncate(actual)}`,
77
+ );
78
+ this.name = 'PrefixBrokenError';
79
+ this.index = index;
80
+ this.expected = expected;
81
+ this.actual = actual;
82
+ }
83
+ }
84
+
85
+ export class DynamicInPrefixError extends Error {
86
+ constructor(key ) {
87
+ super(
88
+ `动态字段 "${key}" 不允许进入稳定前缀(O4):请用 freezeDynamics 归入易变尾或回合冻结`,
89
+ );
90
+ this.name = 'DynamicInPrefixError';
91
+ }
92
+ }
93
+
94
+ function truncate(text , max = 120) {
95
+ const flat = text.replace(/\s+/g, ' ').trim();
96
+ return flat.length <= max ? flat : `${flat.slice(0, max)}…`;
97
+ }
98
+
99
+ function bytesEqual(a , b ) {
100
+ return Buffer.compare(Buffer.from(a, 'utf8'), Buffer.from(b, 'utf8')) === 0;
101
+ }
102
+
103
+ // ---------------------------------------------------------------------------
104
+ // assertPrefixStable / renderHash(可独立使用,08 号实测用它算 prefix_hash 序列)
105
+ // ---------------------------------------------------------------------------
106
+
107
+ /**
108
+ * 逐消息逐字节比较:next 的前 prev.length 条消息必须与 prev 完全一致。
109
+ * - 中间任何一条不一致 → PrefixBrokenError(不做静默修复);
110
+ * - next 比 prev 长:允许(追加区只追加);
111
+ * - next 比 prev 短:默认抛错(稳定段收缩=历史被销毁);仅在显式 allowTailDrop 下允许,
112
+ * 且此时必须逐字节证明 next 是 prev 的严格前缀(即只发生了整块尾部丢弃)。
113
+ */
114
+ export function assertPrefixStable(
115
+ prev ,
116
+ next ,
117
+ opts = {},
118
+ ) {
119
+ const n = Math.min(prev.length, next.length);
120
+ for (let i = 0; i < n; i++) {
121
+ const p = prev[i];
122
+ const q = next[i];
123
+ if (p.role !== q.role || !bytesEqual(p.content, q.content)) {
124
+ throw new PrefixBrokenError(
125
+ i,
126
+ `${p.role}: ${p.content}`,
127
+ `${q.role}: ${q.content}`,
128
+ p.role !== q.role ? 'role 不一致' : '内容逐字节不一致',
129
+ );
130
+ }
131
+ }
132
+ if (next.length < prev.length) {
133
+ if (!opts.allowTailDrop) {
134
+ throw new PrefixBrokenError(
135
+ next.length,
136
+ `共 ${prev.length} 条`,
137
+ `只剩 ${next.length} 条`,
138
+ ':稳定段收缩(尾部被丢弃但未声明 allowTailDrop)',
139
+ );
140
+ }
141
+ // allowTailDrop:走到这里说明前 n 条逐字节相等,即只发生了整块尾部丢弃
142
+ }
143
+ return { prefixLength: next.length };
144
+ }
145
+
146
+ /** 确定性哈希:同一组消息永远得到同一 hash(供实测对账 / prefix_hash 序列)。 */
147
+ export function renderHash(messages ) {
148
+ const canonical = JSON.stringify(
149
+ messages.map((m) => ({ role: m.role, content: m.content })),
150
+ );
151
+ return createHash('sha256').update(canonical, 'utf8').digest('hex');
152
+ }
153
+
154
+ // ---------------------------------------------------------------------------
155
+ // ContextRenderer
156
+ // ---------------------------------------------------------------------------
157
+
158
+
159
+
160
+
161
+
162
+
163
+
164
+
165
+
166
+
167
+
168
+
169
+
170
+
171
+
172
+      
173
+
174
+                     
175
+
176
+     
177
+
178
+       
179
+
180
+
181
+                           
182
+
183
+
184
+
185
+ function renderHandleDelta(delta ) {
186
+ const lines = [];
187
+ for (const e of delta.added) {
188
+ lines.push(`+ ${e.handle}${e.note ? ` — ${e.note}` : ''}`);
189
+ }
190
+ for (const e of delta.changed) {
191
+ lines.push(`~ ${e.handle}${e.note ? ` — ${e.note}` : ''}`);
192
+ }
193
+ for (const e of delta.stale) {
194
+ lines.push(`- ${e.handle}(已失效,tf-peek 将拒绝)${e.note ? ` — ${e.note}` : ''}`);
195
+ }
196
+ if (lines.length === 0) return null; // 空增量不产生块(前缀逐字节不变)
197
+ return ['[句柄目录增量 O3:只追加,历史目录见上文]', ...lines].join('\n');
198
+ }
199
+
200
+ export class ContextRenderer {
201
+ // 稳定前缀:构造期冻结。语言层面只读(readonly + Object.freeze),不存在任何写入路径。
202
+ #prefix ;
203
+ #appendBlocks = [];
204
+ #tailBlocks = [];
205
+ /** O4:逐请求变化的动态字段(时间戳等),归易变尾,每请求重建。 */
206
+ #volatileDynamics = new Map ();
207
+ #lastStable = null;
208
+ #clock ;
209
+ #policySink ;
210
+ #policyLog = [];
211
+
212
+ constructor(opts ) {
213
+ // 稳定前缀内容:四段确定性拼接,构造后字节冻结
214
+ const content = [
215
+ opts.system,
216
+ opts.protocol,
217
+ opts.toolSchemas,
218
+ opts.invariants,
219
+ ].join('\n\n');
220
+ this.#prefix = Object.freeze([
221
+ Object.freeze({ role: 'system' , content }),
222
+ ]);
223
+ this.#clock = opts.clock ?? { now: () => Date.now() };
224
+ this.#policySink = opts.policySink;
225
+ }
226
+
227
+ /** 稳定前缀(只读)。动态内容有任何路径想进来都过不去——这是 O4 的结构性保证。 */
228
+ get prefixMessages() {
229
+ return this.#prefix;
230
+ }
231
+
232
+ /** 策略违规内部台账。 */
233
+ get policyLog() {
234
+ return this.#policyLog;
235
+ }
236
+
237
+ // ------------------------------------------------------------------ 追加区
238
+
239
+ /** 追加历史消息(assistant / user / tool)。system 归稳定前缀所有,此处禁止。 */
240
+ appendHistory(msg ) {
241
+ if (msg.role === 'system') {
242
+ throw new Error('appendHistory 不接受 system 消息:system 属于稳定前缀');
243
+ }
244
+ this.#appendBlocks.push({ kind: 'history', role: msg.role, content: msg.content });
245
+ }
246
+
247
+ /**
248
+ * O3 句柄目录差分注入:obs.ts 的 directoryDelta(sinceSeq) 结果只追加进追加区。
249
+ * 空增量(三列皆空)不产生任何块。返回是否追加了块。
250
+ */
251
+ appendHandleDelta(delta ) {
252
+ const content = renderHandleDelta(delta);
253
+ if (content === null) return false;
254
+ this.#appendBlocks.push({
255
+ kind: 'handle-delta',
256
+ role: 'user',
257
+ content,
258
+ });
259
+ return true;
260
+ }
261
+
262
+ /**
263
+ * freezeDynamics —— O4 动态上下文冻结的统一入口。
264
+ * - 'volatile-tail':动态字段归易变尾,每请求重建(推荐给时间戳、目录快照等);
265
+ * - 'turn-freeze':按回合冻结为追加区块,本回合取值此后字节不变。
266
+ * 不提供把动态内容写进稳定前缀的选项(结构性禁止)。
267
+ */
268
+ freezeDynamics(
269
+ dynamics ,
270
+ placement ,
271
+ ) {
272
+ for (const [key, value] of Object.entries(dynamics)) {
273
+ if (this.#prefix[0].content.includes(value)) {
274
+ throw new DynamicInPrefixError(key);
275
+ }
276
+ }
277
+ if (placement === 'volatile-tail') {
278
+ for (const [key, value] of Object.entries(dynamics)) {
279
+ this.#volatileDynamics.set(key, value);
280
+ }
281
+ } else {
282
+ const keys = Object.keys(dynamics).sort();
283
+ const content = [
284
+ '[回合冻结动态段 O4:取值于本回合,此后字节不变]',
285
+ ...keys.map((k) => `${k}: ${dynamics[k]}`),
286
+ ].join('\n');
287
+ this.#appendBlocks.push({ kind: 'turn-frozen', role: 'user', content });
288
+ }
289
+ }
290
+
291
+ // ------------------------------------------------------------------ 易变尾
292
+
293
+ /** 易变尾整块替换(每请求重建,允许整块丢弃)。 */
294
+ setTail(blocks ) {
295
+ this.#tailBlocks = blocks.map((b) => ({
296
+ role: b.role ?? 'user',
297
+ content: b.content,
298
+ }));
299
+ }
300
+
301
+ /** 丢弃整个易变尾。 */
302
+ clearTail() {
303
+ this.#tailBlocks = [];
304
+ }
305
+
306
+ // ------------------------------------------------------------------- 装配
307
+
308
+ /** 追加区块数(F7 段边界判定用)。 */
309
+ get appendBlockCount() {
310
+ return this.#appendBlocks.length;
311
+ }
312
+
313
+ /** 追加区总字符数(段边界只看增长部分;system 前缀恒定不计入)。 */
314
+ get appendChars() {
315
+ return this.#appendBlocks.reduce((n, b) => n + b.content.length, 0);
316
+ }
317
+
318
+ // ------------------------------------------------------------------- 装配
319
+
320
+ /** 稳定段 = 稳定前缀 ++ 追加区(不含易变尾)。 */
321
+ stableMessages() {
322
+ return [
323
+ ...this.#prefix,
324
+ ...this.#appendBlocks.map((b) => ({ role: b.role, content: b.content })),
325
+ ];
326
+ }
327
+
328
+ /** 稳定段哈希(O4/O6 单调性证明与 08 号 prefix_hash 序列都用它)。 */
329
+ stableHash() {
330
+ return renderHash(this.stableMessages());
331
+ }
332
+
333
+ /**
334
+ * 装配一次请求的完整 messages(稳定段 ++ 易变尾)。
335
+ * 内置 O6 preflight(fail-closed):与上一请求的稳定段做逐字节断言,
336
+ * 违反直接抛 PrefixBrokenError 拒绝发送——宁可任务失败不烧缓存。
337
+ */
338
+ render() {
339
+ const stable = this.stableMessages();
340
+ if (this.#lastStable !== null) {
341
+ assertPrefixStable(this.#lastStable, stable);
342
+ }
343
+ this.#lastStable = stable;
344
+ const tail = this.renderTail();
345
+ return [...stable, ...tail];
346
+ }
347
+
348
+ renderTail() {
349
+ const out = [];
350
+ if (this.#volatileDynamics.size > 0) {
351
+ const keys = [...this.#volatileDynamics.keys()].sort();
352
+ out.push({
353
+ role: 'user',
354
+ content: [
355
+ '[动态上下文(易变尾,每请求重建)]',
356
+ ...keys.map((k) => `${k}: ${this.#volatileDynamics.get(k)}`),
357
+ ].join('\n'),
358
+ });
359
+ }
360
+ for (const b of this.#tailBlocks) out.push({ role: b.role, content: b.content });
361
+ return out;
362
+ }
363
+
364
+ // --------------------------------------------------------------- 降级通道
365
+
366
+ /**
367
+ * 整块尾部丢弃(唯一被允许的历史收缩方式)。
368
+ * 只从追加区末尾丢弃整块;内部逐字节验证"被保留部分与丢弃前完全一致",
369
+ * 基线显式推进(有 policyLog 记录,绝非静默修复)。
370
+ */
371
+ truncateAppendTail(dropCount ) {
372
+ const before = this.stableMessages();
373
+ const actual = Math.max(0, Math.min(dropCount, this.#appendBlocks.length));
374
+ if (actual === 0) return 0;
375
+ this.#appendBlocks = this.#appendBlocks.slice(
376
+ 0,
377
+ this.#appendBlocks.length - actual,
378
+ );
379
+ const after = this.stableMessages();
380
+ // fail-closed:必须逐字节证明 after 是 before 的严格前缀(只有整块尾部被丢弃)
381
+ assertPrefixStable(after, before, { allowTailDrop: true });
382
+ this.#lastStable = after;
383
+ return actual;
384
+ }
385
+
386
+ /**
387
+ * F7 段边界:从追加区**头部**整块丢弃 n 个块(只落在完整回合边界上——调用方保证;
388
+ * 块不拆开,工具调用与结果同块进出)。被丢弃内容整块返回,调用方负责句柄化登记
389
+ * (原文可按句柄 tf-peek 回取,绝不做摘要改写)。
390
+ *
391
+ * 这是"整块丢弃"路线的显式缓存重置点:下一请求的稳定段与上一请求不再共享前缀,
392
+ * 因此本方法重置前缀基线(#lastStable = null)并写入 policyLog——未记录的前缀
393
+ * 不一致仍会被 render() preflight fail-closed 拦下,这条通道是唯一合法入口。
394
+ */
395
+ dropAppendHead(dropCount , opts ) {
396
+ const n = Math.max(0, Math.min(dropCount, this.#appendBlocks.length));
397
+ const dropped = this.#appendBlocks.slice(0, n).map((b) => b.content);
398
+ this.#appendBlocks = this.#appendBlocks.slice(n);
399
+ this.#lastStable = null;
400
+ const record = {
401
+ at: this.#clock.now(),
402
+ kind: 'segment-drop',
403
+ request: opts.reason,
404
+ accepted: true,
405
+ degradedTo: 'none',
406
+ droppedBlocks: n,
407
+ detail: `F7 段边界:整块丢弃 ${n} 块(${dropped.reduce((s, t) => s + t.length, 0)} 字符),前缀基线重置(显式缓存重置点;被丢弃原文已句柄化,不做摘要改写)`,
408
+ };
409
+ this.#policyLog.push(record);
410
+ if (this.#policySink) this.#policySink(record);
411
+ return { dropped, record };
412
+ }
413
+
414
+ /**
415
+ * 模型请求"压缩历史":一律拒绝(红线 4 禁止智能压缩/摘要/改写中间内容),
416
+ * 降级为整块尾部截断并记录。绝不静默。
417
+ */
418
+ requestHistoryCompression(req
419
+
420
+                                      
421
+
422
+ ) {
423
+ const dropped =
424
+ req.fallbackTailDrop !== undefined
425
+ ? this.truncateAppendTail(req.fallbackTailDrop)
426
+ : 0;
427
+ const record = {
428
+ at: this.#clock.now(),
429
+ kind: 'compress-history-request',
430
+ request: req.request,
431
+ accepted: false,
432
+ degradedTo: dropped > 0 ? 'tail-truncation' : 'none',
433
+ droppedBlocks: dropped,
434
+ detail:
435
+ '压缩历史请求被拒绝(禁止摘要/改写中间历史,会摧毁前缀缓存)' +
436
+ (dropped > 0
437
+ ? `;降级为整块尾部截断 ${dropped} 块`
438
+ : ';未做任何丢弃'),
439
+ };
440
+ this.#policyLog.push(record);
441
+ if (this.#policySink) this.#policySink(record);
442
+ return record;
443
+ }
444
+ }