@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.
- package/CHANGELOG.md +497 -0
- package/CONTRIBUTING.md +72 -0
- package/LICENSE +202 -0
- package/README.en.md +349 -0
- package/README.md +300 -3
- package/cordis.patch.yml +77 -0
- package/dist/entry/action-gate.js +206 -0
- package/dist/entry/adapter-kit.js +192 -0
- package/dist/entry/context-render.js +119 -0
- package/dist/entry/control-bar-cli.js +289 -0
- package/dist/entry/control-bar.js +123 -0
- package/dist/entry/control-session.js +115 -0
- package/dist/entry/control-state.js +125 -0
- package/dist/entry/cordis-compat.js +95 -0
- package/dist/entry/eval-probe.js +112 -0
- package/dist/entry/intent-log.js +121 -0
- package/dist/entry/json-persistence.js +306 -0
- package/dist/entry/loop.js +3852 -0
- package/dist/entry/mock-provider.js +536 -0
- package/dist/entry/obs-broker.js +178 -0
- package/dist/entry/ptc-bridge.js +405 -0
- package/dist/entry/state-handle.js +217 -0
- package/dist/entry/takeover-registry.js +60 -0
- package/dist/kernel/control-bar.js +559 -0
- package/dist/kernel/final.js +62 -0
- package/dist/kernel/gate.js +464 -0
- package/dist/kernel/modes.js +253 -0
- package/dist/kernel/obs.js +517 -0
- package/dist/kernel/parser.js +632 -0
- package/dist/kernel/render.js +444 -0
- package/dist/kernel/state.js +416 -0
- package/dist/version.js +9 -0
- package/docs/TEST-PROPOSITIONS.md +139 -0
- package/docs/adr-001-segment-boundary.md +61 -0
- package/docs/architecture.md +104 -0
- package/docs/desktop-ui-feasibility.md +277 -0
- package/docs/disabled-lines-audit.md +53 -0
- package/docs/limitations.md +181 -0
- package/docs/protocol.md +99 -0
- package/docs/v0.4.0-plan.md +50 -0
- package/eval/METRICS.md +128 -0
- package/eval/RESULTS.md +246 -0
- package/eval/tasks/fixtures/big-report.md +298 -0
- package/eval/tasks/fixtures/build-manifest.txt +5 -0
- package/eval/tasks/fixtures/deploy.yaml +4 -0
- package/eval/tasks/fixtures/error.log +200 -0
- package/eval/tasks/fixtures/features.yaml +4 -0
- package/eval/tasks/fixtures/pipeline.yaml +4 -0
- package/eval/tasks/fixtures/sales-q1.csv +61 -0
- package/eval/tasks/fixtures/settings.yaml +4 -0
- package/eval/tasks/fixtures/users-roster.json +304 -0
- package/eval/tasks/fixtures/users-scores.json +20 -0
- package/eval/tasks/gen-fixtures.cjs +80 -0
- package/eval/tasks/tasks.json +150 -0
- package/eval/tools/f6-kill-drill.cjs +176 -0
- package/eval/tools/f6-kill-drill.worker.cjs +131 -0
- package/eval/tools/gen-results.cjs +191 -0
- package/eval/tools/machine-test.cjs +200 -0
- package/eval/tools/manual-code-scenarios.md +59 -0
- package/eval/tools/replay-check.cjs +311 -0
- package/eval/tools/runner.cjs +219 -0
- package/eval/tools/session-log.cjs +106 -0
- package/eval/tools/summarize.cjs +185 -0
- package/eval/tools/t3-cells.cjs +173 -0
- package/package.json +73 -6
- package/patches/adapters-smoke.yml +41 -0
- package/patches/eval-account.yml +36 -0
- package/patches/eval-baseline.yml +33 -0
- package/patches/eval-stream-code-off.yml +46 -0
- package/patches/eval-stream-code-on.yml +47 -0
- package/patches/eval-stream.yml +54 -0
- package/patches/takeover.yml +42 -0
- package/patches/test-preset.yml +23 -0
- package/preset/stream/cordis.patch.yml +39 -0
- package/preset/stream/package.json +13 -0
- package/preset.yml +56 -0
- package/profiles/stream/README.md +66 -0
- package/profiles/stream/cordis.patch.yml +12 -0
- package/profiles/stream/package.json +17 -0
- package/profiles/stream-headless/package.json +16 -0
- package/scripts/build.mjs +103 -0
- package/scripts/check-consistency.mjs +146 -0
- package/scripts/gate.mjs +138 -0
- package/scripts/install-check.mjs +116 -0
- package/scripts/install-cycle.mjs +88 -0
- package/scripts/release.mjs +415 -0
- package/scripts/repair-session-logs.mjs +403 -0
- package/src/entry/action-gate.ts +206 -0
- package/src/entry/adapter-kit.ts +192 -0
- package/src/entry/context-render.ts +119 -0
- package/src/entry/control-bar-cli.ts +289 -0
- package/src/entry/control-bar.ts +123 -0
- package/src/entry/control-session.ts +115 -0
- package/src/entry/control-state.ts +125 -0
- package/src/entry/cordis-compat.ts +95 -0
- package/src/entry/eval-probe.ts +112 -0
- package/src/entry/intent-log.ts +121 -0
- package/src/entry/json-persistence.ts +306 -0
- package/src/entry/loop.ts +3852 -0
- package/src/entry/mock-provider.ts +536 -0
- package/src/entry/obs-broker.ts +178 -0
- package/src/entry/ptc-bridge.ts +405 -0
- package/src/entry/state-handle.ts +217 -0
- package/src/entry/takeover-registry.ts +60 -0
- package/src/kernel/control-bar.ts +559 -0
- package/src/kernel/final.ts +62 -0
- package/src/kernel/gate.ts +464 -0
- package/src/kernel/modes.ts +253 -0
- package/src/kernel/obs.ts +517 -0
- package/src/kernel/parser.ts +632 -0
- package/src/kernel/render.ts +444 -0
- package/src/kernel/state.ts +416 -0
- package/src/version.ts +9 -0
- package/test/activation.test.ts +187 -0
- package/test/adapters.test.ts +676 -0
- package/test/control-bar.test.ts +486 -0
- package/test/desktop-ui.test.ts +359 -0
- package/test/eval-probe.test.ts +139 -0
- package/test/f5-plan.test.ts +221 -0
- package/test/f6-intent.test.ts +168 -0
- package/test/f7-segment.test.ts +190 -0
- package/test/fix-limits.test.ts +599 -0
- package/test/gate.test.ts +380 -0
- package/test/helpers/stub-loop.ts +240 -0
- package/test/kernel/obs.test.ts +329 -0
- package/test/kernel/parser.test.ts +450 -0
- package/test/loop.test.ts +1393 -0
- package/test/mock-provider.test.ts +386 -0
- package/test/ptc-bridge.test.ts +356 -0
- package/test/render.test.ts +418 -0
- package/test/s2-install-check.test.ts +46 -0
- package/test/scenarios/3-file-basic.json +13 -0
- package/test/scenarios/5-file-basic.json +22 -0
- package/test/scenarios/burn-more.json +9 -0
- package/test/scenarios/degraded-final.json +10 -0
- package/test/scenarios/fault-abort-xml.json +11 -0
- package/test/scenarios/fault-malformed-command.json +12 -0
- package/test/scenarios/fault-midstream-abort.json +11 -0
- package/test/scenarios/fault-saturating-output.json +9 -0
- package/test/scenarios/fault-timeout.json +9 -0
- package/test/scenarios/peek-first.json +11 -0
- package/test/scenarios/peek-second.json +11 -0
- package/test/scenarios/peek-third.json +10 -0
- package/test/scenarios/recover-final.json +10 -0
- package/test/scenarios/reroute-first.json +17 -0
- package/test/scenarios/reroute-second.json +16 -0
- package/test/scenarios/starvation-final.json +10 -0
- package/test/scenarios/starvation-promote.json +11 -0
- package/test/scenarios/wait-tools-continue.json +10 -0
- package/test/scenarios/wait-tools-xml.json +22 -0
- package/test/scenarios/wait-tools.json +15 -0
- package/test/session-format.test.ts +234 -0
- package/test/state.test.ts +335 -0
- package/test/stream-v02.test.ts +264 -0
- package/test/v031-display.test.ts +333 -0
- package/ui/client.js +576 -0
- package/ui/index.js +282 -0
- package/ui/package.json +26 -0
|
@@ -0,0 +1,416 @@
|
|
|
1
|
+
// kernel/state.ts —— 内容寻址状态树与句柄(M1,分派 02)
|
|
2
|
+
//
|
|
3
|
+
// 内核层纪律:零框架依赖(不 import 任何 @deepseek-ai/*);
|
|
4
|
+
// 除 node:crypto 哈希计算外无任何副作用(无 fs、无网络、无 console)——
|
|
5
|
+
// BlobSink 是唯一 IO 出口,依赖注入全走构造参数。
|
|
6
|
+
//
|
|
7
|
+
// 不变量 I2(强制溯源,违反即抛错,绝不静默修正):
|
|
8
|
+
// confidence="derived" 必须带非空 derivedFrom;
|
|
9
|
+
// confidence="stated" 必须不带 derivedFrom。
|
|
10
|
+
|
|
11
|
+
import { createHash } from 'node:crypto';
|
|
12
|
+
|
|
13
|
+
// ---------------------------------------------------------------------------
|
|
14
|
+
// 类型
|
|
15
|
+
// ---------------------------------------------------------------------------
|
|
16
|
+
|
|
17
|
+
|
|
18
|
+
|
|
19
|
+
/** 句柄:内容寻址 + 版本。形如 file:src/app.ts@v3 / obs:tool:callId@v3 / blob:1a2b3c4d@v1 */
|
|
20
|
+
|
|
21
|
+
|
|
22
|
+
|
|
23
|
+
|
|
24
|
+
|
|
25
|
+
|
|
26
|
+
|
|
27
|
+
/** 状态节点:强制溯源(不变量 I2) */
|
|
28
|
+
|
|
29
|
+
|
|
30
|
+
|
|
31
|
+
|
|
32
|
+
|
|
33
|
+
|
|
34
|
+
|
|
35
|
+
|
|
36
|
+
/**
|
|
37
|
+
* BlobSink:内核唯一的 IO 出口。默认内存实现;
|
|
38
|
+
* localStorage / 文件实现在适配层(07 号分派)接到 DSH storage 服务。
|
|
39
|
+
*/
|
|
40
|
+
|
|
41
|
+
|
|
42
|
+
|
|
43
|
+
|
|
44
|
+
|
|
45
|
+
|
|
46
|
+
|
|
47
|
+
|
|
48
|
+
|
|
49
|
+
|
|
50
|
+
|
|
51
|
+
|
|
52
|
+
|
|
53
|
+
|
|
54
|
+
|
|
55
|
+
|
|
56
|
+
|
|
57
|
+
// ---------------------------------------------------------------------------
|
|
58
|
+
// 错误类型
|
|
59
|
+
// ---------------------------------------------------------------------------
|
|
60
|
+
|
|
61
|
+
export class InvalidStateWriteError extends Error {
|
|
62
|
+
constructor(message ) {
|
|
63
|
+
super(message);
|
|
64
|
+
this.name = 'InvalidStateWriteError';
|
|
65
|
+
}
|
|
66
|
+
}
|
|
67
|
+
|
|
68
|
+
export class UnknownHandleError extends Error {
|
|
69
|
+
constructor(message ) {
|
|
70
|
+
super(message);
|
|
71
|
+
this.name = 'UnknownHandleError';
|
|
72
|
+
}
|
|
73
|
+
}
|
|
74
|
+
|
|
75
|
+
export class CycleError extends Error {
|
|
76
|
+
constructor(message ) {
|
|
77
|
+
super(message);
|
|
78
|
+
this.name = 'CycleError';
|
|
79
|
+
}
|
|
80
|
+
}
|
|
81
|
+
|
|
82
|
+
// ---------------------------------------------------------------------------
|
|
83
|
+
// 默认内存 BlobSink
|
|
84
|
+
// ---------------------------------------------------------------------------
|
|
85
|
+
|
|
86
|
+
export class MemoryBlobSink {
|
|
87
|
+
blobs = new Map ();
|
|
88
|
+
|
|
89
|
+
write(key , data ) {
|
|
90
|
+
this.blobs.set(key, data);
|
|
91
|
+
}
|
|
92
|
+
|
|
93
|
+
read(key ) {
|
|
94
|
+
return this.blobs.get(key);
|
|
95
|
+
}
|
|
96
|
+
}
|
|
97
|
+
|
|
98
|
+
// ---------------------------------------------------------------------------
|
|
99
|
+
// 句柄格式化 / 解析
|
|
100
|
+
// ---------------------------------------------------------------------------
|
|
101
|
+
|
|
102
|
+
export function formatHandle(handle ) {
|
|
103
|
+
return `${handle.kind}:${handle.path}@v${handle.version}`;
|
|
104
|
+
}
|
|
105
|
+
|
|
106
|
+
/** 解析句柄字符串;格式非法抛 UnknownHandleError。 */
|
|
107
|
+
export function parseHandle(text ) {
|
|
108
|
+
const at = text.lastIndexOf('@v');
|
|
109
|
+
if (at <= 0) throw new UnknownHandleError(`malformed handle: "${text}"`);
|
|
110
|
+
const prefix = text.slice(0, at);
|
|
111
|
+
const version = Number(text.slice(at + 2));
|
|
112
|
+
if (!Number.isInteger(version) || version < 1) {
|
|
113
|
+
throw new UnknownHandleError(`malformed handle version: "${text}"`);
|
|
114
|
+
}
|
|
115
|
+
const colon = prefix.indexOf(':');
|
|
116
|
+
if (colon < 0) throw new UnknownHandleError(`malformed handle: "${text}"`);
|
|
117
|
+
const kind = prefix.slice(0, colon) ;
|
|
118
|
+
const path = prefix.slice(colon + 1);
|
|
119
|
+
if (!path) throw new UnknownHandleError(`malformed handle: "${text}"`);
|
|
120
|
+
if (kind !== 'file' && kind !== 'blob' && kind !== 'obs') {
|
|
121
|
+
throw new UnknownHandleError(`unknown handle kind: "${text}"`);
|
|
122
|
+
}
|
|
123
|
+
// blob 句柄 path 必须是 8 位 hash 前缀(写入时由 put 保证)
|
|
124
|
+
if (kind === 'blob' && !/^[0-9a-f]{8}$/.test(path)) {
|
|
125
|
+
throw new UnknownHandleError(`malformed blob handle: "${text}"`);
|
|
126
|
+
}
|
|
127
|
+
return { kind, path, version, hash: '' };
|
|
128
|
+
}
|
|
129
|
+
|
|
130
|
+
// ---------------------------------------------------------------------------
|
|
131
|
+
// StateStore
|
|
132
|
+
// ---------------------------------------------------------------------------
|
|
133
|
+
|
|
134
|
+
export class StateStore {
|
|
135
|
+
sink ;
|
|
136
|
+
textEncoder = new TextEncoder();
|
|
137
|
+
textDecoder = new TextDecoder();
|
|
138
|
+
|
|
139
|
+
/** 每个 `${kind}:${path}` 键下:hash → 版本号(同一内容复用同一版本) */
|
|
140
|
+
versionByHash = new Map ();
|
|
141
|
+
/** 每个 `${kind}:${path}` 键下的下一个版本号 */
|
|
142
|
+
nextVersion = new Map ();
|
|
143
|
+
/** 哪些 hash 是以字符串写入的(get 时还原为 string) */
|
|
144
|
+
textHashes = new Set ();
|
|
145
|
+
nodes = new Map ();
|
|
146
|
+
/** 句柄目录:按创建顺序去重 */
|
|
147
|
+
catalog = new Map ();
|
|
148
|
+
|
|
149
|
+
constructor(sink ) {
|
|
150
|
+
this.sink = sink ?? new MemoryBlobSink();
|
|
151
|
+
}
|
|
152
|
+
|
|
153
|
+
/**
|
|
154
|
+
* 内容寻址写。同一内容重复写入得到同一版本(sha256 相同 → 版本号复用)。
|
|
155
|
+
* ref 缺省写 blob(path = hash 前 8 位);file / obs 见 PutRef。
|
|
156
|
+
*/
|
|
157
|
+
put(content , ref ) {
|
|
158
|
+
const bytes = typeof content === 'string' ? this.textEncoder.encode(content) : content;
|
|
159
|
+
const hash = sha256Hex(bytes);
|
|
160
|
+
const kind = ref?.kind ?? 'blob';
|
|
161
|
+
|
|
162
|
+
let path ;
|
|
163
|
+
if (kind === 'file') {
|
|
164
|
+
if (!ref?.path) {
|
|
165
|
+
throw new InvalidStateWriteError('put() with kind="file" requires ref.path');
|
|
166
|
+
}
|
|
167
|
+
path = ref.path;
|
|
168
|
+
} else if (kind === 'obs') {
|
|
169
|
+
if (!ref?.tool || !ref?.callId) {
|
|
170
|
+
throw new InvalidStateWriteError('put() with kind="obs" requires ref.tool and ref.callId');
|
|
171
|
+
}
|
|
172
|
+
path = `${ref.tool}:${ref.callId}`;
|
|
173
|
+
} else {
|
|
174
|
+
path = hash.slice(0, 8);
|
|
175
|
+
}
|
|
176
|
+
|
|
177
|
+
const key = `${kind}:${path}`;
|
|
178
|
+
let byHash = this.versionByHash.get(key);
|
|
179
|
+
if (!byHash) {
|
|
180
|
+
byHash = new Map();
|
|
181
|
+
this.versionByHash.set(key, byHash);
|
|
182
|
+
}
|
|
183
|
+
|
|
184
|
+
let version = byHash.get(hash);
|
|
185
|
+
if (version === undefined) {
|
|
186
|
+
version = this.nextVersion.get(key) ?? 1;
|
|
187
|
+
this.nextVersion.set(key, version + 1);
|
|
188
|
+
byHash.set(hash, version);
|
|
189
|
+
}
|
|
190
|
+
|
|
191
|
+
// 内容寻址存储:同一 hash 只存一份,天然去重
|
|
192
|
+
this.sink.write(hash, bytes);
|
|
193
|
+
if (typeof content === 'string') this.textHashes.add(hash);
|
|
194
|
+
|
|
195
|
+
const handle = { kind, path, version, hash };
|
|
196
|
+
this.catalog.set(formatHandle(handle), handle);
|
|
197
|
+
return handle;
|
|
198
|
+
}
|
|
199
|
+
|
|
200
|
+
/** 取回句柄对应的全文。句柄不存在 / 版本不符 / blob 丢失 → UnknownHandleError。 */
|
|
201
|
+
get(handle ) {
|
|
202
|
+
this.assertKnownHandle(handle);
|
|
203
|
+
const data = this.sink.read(handle.hash);
|
|
204
|
+
if (!data) {
|
|
205
|
+
throw new UnknownHandleError(`blob missing for handle: ${formatHandle(handle)}`);
|
|
206
|
+
}
|
|
207
|
+
return this.textHashes.has(handle.hash) ? this.textDecoder.decode(data) : data;
|
|
208
|
+
}
|
|
209
|
+
|
|
210
|
+
/**
|
|
211
|
+
* 写状态节点(不变量 I2)。节点不可变:同一 id 重复写入抛错。
|
|
212
|
+
* derivedFrom 允许前向引用(引用尚未写入的节点)——环不在写入期阻止,
|
|
213
|
+
* 而是在 trace() 展开时检测(否则环根本无法构造出来测试)。
|
|
214
|
+
*/
|
|
215
|
+
set(id , value , opts = {}) {
|
|
216
|
+
if (this.nodes.has(id)) {
|
|
217
|
+
throw new InvalidStateWriteError(`state node already exists: "${id}"`);
|
|
218
|
+
}
|
|
219
|
+
const confidence = opts.confidence ?? 'stated';
|
|
220
|
+
const { derivedFrom } = opts;
|
|
221
|
+
|
|
222
|
+
if (confidence === 'derived') {
|
|
223
|
+
if (!derivedFrom || derivedFrom.length === 0) {
|
|
224
|
+
throw new InvalidStateWriteError(
|
|
225
|
+
`I2 violation: node "${id}" is derived but has no derivedFrom`,
|
|
226
|
+
);
|
|
227
|
+
}
|
|
228
|
+
} else if (derivedFrom !== undefined) {
|
|
229
|
+
throw new InvalidStateWriteError(
|
|
230
|
+
`I2 violation: node "${id}" is stated but carries derivedFrom`,
|
|
231
|
+
);
|
|
232
|
+
}
|
|
233
|
+
if (derivedFrom) {
|
|
234
|
+
for (const src of derivedFrom) {
|
|
235
|
+
if (typeof src !== 'string' || src.length === 0) {
|
|
236
|
+
throw new InvalidStateWriteError(`I2 violation: node "${id}" has empty derivedFrom entry`);
|
|
237
|
+
}
|
|
238
|
+
}
|
|
239
|
+
}
|
|
240
|
+
|
|
241
|
+
const node = Object.freeze({
|
|
242
|
+
id,
|
|
243
|
+
value,
|
|
244
|
+
...(derivedFrom ? { derivedFrom: [...derivedFrom] } : {}),
|
|
245
|
+
confidence,
|
|
246
|
+
createdAt: Date.now(),
|
|
247
|
+
});
|
|
248
|
+
this.nodes.set(id, node);
|
|
249
|
+
return node;
|
|
250
|
+
}
|
|
251
|
+
|
|
252
|
+
/**
|
|
253
|
+
* 完整来源链:从节点出发递归展开 derivedFrom(含节点自身,先序 DFS),
|
|
254
|
+
* 去重;展开路径上出现环抛 CycleError,来源缺失抛 UnknownHandleError。
|
|
255
|
+
*/
|
|
256
|
+
trace(id ) {
|
|
257
|
+
const start = this.nodes.get(id);
|
|
258
|
+
if (!start) throw new UnknownHandleError(`unknown state node: "${id}"`);
|
|
259
|
+
|
|
260
|
+
const chain = [];
|
|
261
|
+
const seen = new Set ();
|
|
262
|
+
const inStack = new Set ();
|
|
263
|
+
|
|
264
|
+
const visit = (node ) => {
|
|
265
|
+
if (inStack.has(node.id)) {
|
|
266
|
+
throw new CycleError(`provenance cycle detected at node "${node.id}"`);
|
|
267
|
+
}
|
|
268
|
+
if (seen.has(node.id)) return; // 菱形依赖去重
|
|
269
|
+
seen.add(node.id);
|
|
270
|
+
inStack.add(node.id);
|
|
271
|
+
chain.push(node);
|
|
272
|
+
for (const src of node.derivedFrom ?? []) {
|
|
273
|
+
const parent = this.nodes.get(src);
|
|
274
|
+
if (!parent) {
|
|
275
|
+
throw new UnknownHandleError(
|
|
276
|
+
`provenance node "${src}" (referenced by "${node.id}") does not exist`,
|
|
277
|
+
);
|
|
278
|
+
}
|
|
279
|
+
visit(parent);
|
|
280
|
+
}
|
|
281
|
+
inStack.delete(node.id);
|
|
282
|
+
};
|
|
283
|
+
|
|
284
|
+
visit(start);
|
|
285
|
+
return chain;
|
|
286
|
+
}
|
|
287
|
+
|
|
288
|
+
/** 两个句柄内容的逐行差异(unified 风格,无上下文行)。内容一致返回空串。 */
|
|
289
|
+
diff(fromHandle , toHandle ) {
|
|
290
|
+
const from = this.get(fromHandle);
|
|
291
|
+
const to = this.get(toHandle);
|
|
292
|
+
const a = splitLines(asText(from));
|
|
293
|
+
const b = splitLines(asText(to));
|
|
294
|
+
if (arraysEqual(a, b)) return '';
|
|
295
|
+
|
|
296
|
+
const ops = diffOps(a, b);
|
|
297
|
+
const out = [`--- ${formatHandle(fromHandle)}`, `+++ ${formatHandle(toHandle)}`];
|
|
298
|
+
|
|
299
|
+
let i = 0;
|
|
300
|
+
while (i < ops.length) {
|
|
301
|
+
if (ops[i].type === 'equal') {
|
|
302
|
+
i += 1; // 无上下文行格式:equal 直接跳过
|
|
303
|
+
continue;
|
|
304
|
+
}
|
|
305
|
+
// 收集一个连续变更块(-/+ 混合,直到遇到 equal)
|
|
306
|
+
const aStart = ops[i].aLine;
|
|
307
|
+
const bStart = ops[i].bLine;
|
|
308
|
+
let aLen = 0;
|
|
309
|
+
let bLen = 0;
|
|
310
|
+
const body = [];
|
|
311
|
+
while (i < ops.length && ops[i].type !== 'equal') {
|
|
312
|
+
const op = ops[i];
|
|
313
|
+
if (op.type === 'delete') {
|
|
314
|
+
body.push(`-${op.text}`);
|
|
315
|
+
aLen += 1;
|
|
316
|
+
} else {
|
|
317
|
+
body.push(`+${op.text}`);
|
|
318
|
+
bLen += 1;
|
|
319
|
+
}
|
|
320
|
+
i += 1;
|
|
321
|
+
}
|
|
322
|
+
// count=0 时起始行取变更点前一行(GNU unified diff 约定)
|
|
323
|
+
const aHead = aLen > 0 ? `${aStart},${aLen}` : `${aStart - 1},0`;
|
|
324
|
+
const bHead = bLen > 0 ? `${bStart},${bLen}` : `${bStart - 1},0`;
|
|
325
|
+
out.push(`@@ -${aHead} +${bHead} @@`);
|
|
326
|
+
out.push(...body);
|
|
327
|
+
}
|
|
328
|
+
return out.join('\n');
|
|
329
|
+
}
|
|
330
|
+
|
|
331
|
+
/** 当前句柄目录(按首次创建顺序,已去重)。 */
|
|
332
|
+
handles() {
|
|
333
|
+
return [...this.catalog.values()];
|
|
334
|
+
}
|
|
335
|
+
|
|
336
|
+
assertKnownHandle(handle ) {
|
|
337
|
+
if (!handle || typeof handle !== 'object') {
|
|
338
|
+
throw new UnknownHandleError('not a handle');
|
|
339
|
+
}
|
|
340
|
+
if (handle.kind !== 'file' && handle.kind !== 'blob' && handle.kind !== 'obs') {
|
|
341
|
+
throw new UnknownHandleError(`unknown handle kind: ${String(handle.kind)}`);
|
|
342
|
+
}
|
|
343
|
+
const byHash = this.versionByHash.get(`${handle.kind}:${handle.path}`);
|
|
344
|
+
const version = byHash?.get(handle.hash);
|
|
345
|
+
if (version !== handle.version) {
|
|
346
|
+
throw new UnknownHandleError(
|
|
347
|
+
`unknown handle: ${formatHandle(handle)}` +
|
|
348
|
+
(version !== undefined ? ` (actual version v${version})` : ''),
|
|
349
|
+
);
|
|
350
|
+
}
|
|
351
|
+
}
|
|
352
|
+
}
|
|
353
|
+
|
|
354
|
+
// ---------------------------------------------------------------------------
|
|
355
|
+
// 内部工具(纯函数)
|
|
356
|
+
// ---------------------------------------------------------------------------
|
|
357
|
+
|
|
358
|
+
function sha256Hex(data ) {
|
|
359
|
+
return createHash('sha256').update(data).digest('hex');
|
|
360
|
+
}
|
|
361
|
+
|
|
362
|
+
function asText(content ) {
|
|
363
|
+
return typeof content === 'string' ? content : new TextDecoder().decode(content);
|
|
364
|
+
}
|
|
365
|
+
|
|
366
|
+
function splitLines(text ) {
|
|
367
|
+
return text.split(/\r\n|\r|\n/);
|
|
368
|
+
}
|
|
369
|
+
|
|
370
|
+
function arraysEqual(a , b ) {
|
|
371
|
+
return a.length === b.length && a.every((line, i) => line === b[i]);
|
|
372
|
+
}
|
|
373
|
+
|
|
374
|
+
|
|
375
|
+
|
|
376
|
+
|
|
377
|
+
|
|
378
|
+
|
|
379
|
+
/** 经典 LCS 逐行 diff(O(n·m),内核数据量下足够),输出带行号的 op 序列。 */
|
|
380
|
+
function diffOps(a , b ) {
|
|
381
|
+
const n = a.length;
|
|
382
|
+
const m = b.length;
|
|
383
|
+
// lcs[i][j] = a[i..] 与 b[j..] 的 LCS 长度
|
|
384
|
+
const lcs = Array.from({ length: n + 1 }, () => new Array (m + 1).fill(0));
|
|
385
|
+
for (let i = n - 1; i >= 0; i -= 1) {
|
|
386
|
+
for (let j = m - 1; j >= 0; j -= 1) {
|
|
387
|
+
lcs[i][j] = a[i] === b[j] ? lcs[i + 1][j + 1] + 1 : Math.max(lcs[i + 1][j], lcs[i][j + 1]);
|
|
388
|
+
}
|
|
389
|
+
}
|
|
390
|
+
|
|
391
|
+
const ops = [];
|
|
392
|
+
let i = 0;
|
|
393
|
+
let j = 0;
|
|
394
|
+
while (i < n && j < m) {
|
|
395
|
+
if (a[i] === b[j]) {
|
|
396
|
+
ops.push({ type: 'equal', aLine: i + 1, bLine: j + 1, text: a[i] });
|
|
397
|
+
i += 1;
|
|
398
|
+
j += 1;
|
|
399
|
+
} else if (lcs[i + 1][j] >= lcs[i][j + 1]) {
|
|
400
|
+
ops.push({ type: 'delete', aLine: i + 1, bLine: j + 1, text: a[i] });
|
|
401
|
+
i += 1;
|
|
402
|
+
} else {
|
|
403
|
+
ops.push({ type: 'insert', aLine: i + 1, bLine: j + 1, text: b[j] });
|
|
404
|
+
j += 1;
|
|
405
|
+
}
|
|
406
|
+
}
|
|
407
|
+
while (i < n) {
|
|
408
|
+
ops.push({ type: 'delete', aLine: i + 1, bLine: m + 1, text: a[i] });
|
|
409
|
+
i += 1;
|
|
410
|
+
}
|
|
411
|
+
while (j < m) {
|
|
412
|
+
ops.push({ type: 'insert', aLine: n + 1, bLine: j + 1, text: b[j] });
|
|
413
|
+
j += 1;
|
|
414
|
+
}
|
|
415
|
+
return ops;
|
|
416
|
+
}
|
package/dist/version.js
ADDED
|
@@ -0,0 +1,9 @@
|
|
|
1
|
+
// version.ts —— 单一版本常量(package.json 必须与它一致,test/control-bar.test.ts 会断言)
|
|
2
|
+
//
|
|
3
|
+
// 为什么单独一个文件:控制栏在 stderr 与 --json 里都要报版本,而 kernel 不读 package.json
|
|
4
|
+
// (内核零 IO 纪律),entry 也不该各自硬编码字符串。
|
|
5
|
+
|
|
6
|
+
export const VERSION = '0.3.1';
|
|
7
|
+
|
|
8
|
+
/** 版本来源:npm 源未上线时引导用户用本地路径安装的提示会用到。 */
|
|
9
|
+
export const PACKAGE_NAME = '@hugesb/dsh-stream-agent';
|
|
@@ -0,0 +1,139 @@
|
|
|
1
|
+
# 0.3.0 人工测试命题与提示词(复测用)
|
|
2
|
+
|
|
3
|
+
> 用途:发布前人工复测(API/真机验证只由人执行——本仓库的开发过程零 API 调用)。
|
|
4
|
+
> 执行方式二选一:
|
|
5
|
+
> headless:`dsh --profile stream-headless --patch 无 headless "<提示词>"`(或既有 profile + 插件已装)
|
|
6
|
+
> 桌面端:装好插件后新建会话,把提示词整段粘贴发送。
|
|
7
|
+
> 每个命题独立新会话(避免跨命题上下文污染);跑完保留 `~/.dsh/sessions` 对应会话存档与工作区产物。
|
|
8
|
+
>
|
|
9
|
+
> **预算口径(每个命题 ≈2 元)**:按 deepseek-account/deepseek-flash 计费模型
|
|
10
|
+
> (输入未命中 ¥2/M、缓存命中 ¥0.2/M 级、输出 ¥8/M 级——以账单实际为准),单命题
|
|
11
|
+
> 单臂总 token 约 1.5 万–5 万(0.2.0 实测:对照臂 12.9 万/10 任务 ≈ 1.3 万/任务),
|
|
12
|
+
> 单臂约 0.2–0.8 元;基线对照(跑两臂)合计 ≤2 元/命题。若某命题实际花费显著超过
|
|
13
|
+
> 2 元,本身就是发现(记录任务 id 与会话存档,作为 token 账证据)。
|
|
14
|
+
>
|
|
15
|
+
> 判定纪律:失败与超时计入,不重跑挑数据;产物核对用下方 checks 列,不要靠肉眼"看起来对"。
|
|
16
|
+
|
|
17
|
+
## A 组:回归命题(0.2.0 已有能力,防 0.3.0 改坏)
|
|
18
|
+
|
|
19
|
+
### A1 写批基础(对应 eval W1)
|
|
20
|
+
|
|
21
|
+
提示词:
|
|
22
|
+
```
|
|
23
|
+
请在当前目录写三个文件:intro.md(3 行,主题:本项目的目标)、plan.md(3 行,主题:实施计划)、notes.md(2 行,主题:注意事项)。每个文件第一行以 '# ' 开头标题。
|
|
24
|
+
```
|
|
25
|
+
- checks:三个文件存在;intro.md 含 `#`;回合以 tf-final 收束。
|
|
26
|
+
- 关注点:无 `[tf-stream:error]` 重入;请求数 ≤5。
|
|
27
|
+
|
|
28
|
+
### A2 批量写 + 汇总(对应 eval W3)
|
|
29
|
+
|
|
30
|
+
提示词:
|
|
31
|
+
```
|
|
32
|
+
请写 8 个文件 modules/m1.txt 到 modules/m8.txt,第 N 个文件内容为 'module N: ok'。然后写 modules/summary.txt,按顺序列出全部 8 个文件名,一行一个。
|
|
33
|
+
```
|
|
34
|
+
- checks:m1–m8 存在且内容正确;summary.txt 列全 8 行。
|
|
35
|
+
- 关注点:写序保证(summary 不缺文件);总 token 不高于 0.2.0 同任务。
|
|
36
|
+
|
|
37
|
+
### A3 读大文件答行(对应 eval R1)
|
|
38
|
+
|
|
39
|
+
seed:`eval/tasks/fixtures/big-report.md` → 工作区 `data/big-report.md`。
|
|
40
|
+
提示词:
|
|
41
|
+
```
|
|
42
|
+
请读取 data/big-report.md,回答两个问题并直接给出答案:1) 第 137 行的完整原文;2) 该文件总行数。不要省略第 137 行的内容。
|
|
43
|
+
```
|
|
44
|
+
- checks:最终答案含 `424242` 与 `L137-quirk-quokka`。
|
|
45
|
+
- 关注点:offset/limit 或 peek 的用法;不整文件重复读。
|
|
46
|
+
|
|
47
|
+
## B 组:0.3.0 新能力命题
|
|
48
|
+
|
|
49
|
+
### B1 编辑替代重写(F1 tf-edit;对照"整文件重写")
|
|
50
|
+
|
|
51
|
+
seed:`eval/tasks/fixtures/big-report.md` → `data/big-report.md`(约 1.6 万字符)。
|
|
52
|
+
提示词:
|
|
53
|
+
```
|
|
54
|
+
data/big-report.md 里第 137 行是 'L137-quirk-quokka 424242'。请把其中的 424242 改成 999999,其余内容一个字都不能变。改完后回答:第 137 行现在的完整原文。
|
|
55
|
+
```
|
|
56
|
+
- checks:第 137 行变为 `L137-quirk-quokka 999999`;文件其余行数不变(wc -l 对比 seed)。
|
|
57
|
+
- 关注点:模型应走 `tf-edit`(精确替换)而不是 tf-write 整文件重写——**本命题编辑 token
|
|
58
|
+
≤ 整文件重写 60%** 是 F1 验收口径:用 `summarize.cjs` 对比本命题与 A3 的 token(同 seed)。
|
|
59
|
+
- 判定脚本:`node eval/tools/summarize.cjs --stamp <你的stamp> --md`(逐任务四分量)。
|
|
60
|
+
|
|
61
|
+
### B2 追加语义(F1 tf-append)
|
|
62
|
+
|
|
63
|
+
seed:任意 md。
|
|
64
|
+
提示词:
|
|
65
|
+
```
|
|
66
|
+
notes.md 已存在(内容 2 行)。请在文件末尾追加一行 'append-ok-<今天日期>',其余内容一字不改。
|
|
67
|
+
```
|
|
68
|
+
- checks:原 2 行逐字节保留;末尾恰好多一行。
|
|
69
|
+
- 关注点:tf-append 不重写全文;失败时结构化报错不静默。
|
|
70
|
+
|
|
71
|
+
### B3 搜索替代 shell(F2 tf-grep / tf-glob)
|
|
72
|
+
|
|
73
|
+
seed:`eval/tasks/fixtures/` 下多文件铺开(big-report.md、settings.yaml、deploy.yaml)。
|
|
74
|
+
提示词:
|
|
75
|
+
```
|
|
76
|
+
请在当前目录下搜索所有包含 'revision' 的文件与行(含行号),并统计一共出现多少次;再列出所有 *.yaml 文件的路径清单。把两个答案直接写进最终回复。
|
|
77
|
+
```
|
|
78
|
+
- checks:最终答案行数/路径清单正确。
|
|
79
|
+
- 关注点:走 tf-grep/tf-glob,**0 次**用 tf-bash 调 Select-String/findstr 兜底(台账可见命令序列)。
|
|
80
|
+
|
|
81
|
+
### B4 计划与验收(F5 tf-plan + accepts;复合任务)
|
|
82
|
+
|
|
83
|
+
提示词:
|
|
84
|
+
```
|
|
85
|
+
请完成一个小任务包:1) 写 plan/step1.txt 内容为 'step1 done';2) 写 plan/step2.txt 内容为 'step2 done';3) 写 plan/report.md 汇总两步的文件名与内容。开始前先声明计划与验收项,每完成一步用验收回执标记,全部验收通过后收尾。
|
|
86
|
+
```
|
|
87
|
+
- checks:三文件存在且内容正确。
|
|
88
|
+
- 关注点:会话台账出现 `tf-plan` 与 `plan-accept` 记录;"声称完成但无回执"的项会被
|
|
89
|
+
过早 final 拦截(若模型直接自述完成,驱动器注入 `tf-final 过早:…验收未验证`——记录这次拦截)。
|
|
90
|
+
|
|
91
|
+
### B5 tf-code 默认关闭(K1 幻觉检查)
|
|
92
|
+
|
|
93
|
+
提示词(默认装配,未开 tf-code):
|
|
94
|
+
```
|
|
95
|
+
请统计 data/big-report.md 里 'quirk' 出现的次数,把结果写进 out/count.txt。
|
|
96
|
+
```
|
|
97
|
+
- checks:out/count.txt 数字正确。
|
|
98
|
+
- 关注点:**协议不声明 tf-code 时模型 0 次尝试 `<tf-code>`**(若有尝试,驱动器注入
|
|
99
|
+
`no-code-channel` 并改道——记录该行为);本命题用 tf-bash(node/pwsh)或 tf-read 完成。
|
|
100
|
+
|
|
101
|
+
### B6 tf-code 显式开启五场景(K2–K6)
|
|
102
|
+
|
|
103
|
+
power 模式(或 `enableCode: true`)下跑 `eval/tools/manual-code-scenarios.md` 的
|
|
104
|
+
S1–S5(成功/失败/取消/拒绝/partial)。每场景记录 kind、账本 sandbox 事实、最终状态。
|
|
105
|
+
|
|
106
|
+
### B7 恢复意图(F6 强杀)
|
|
107
|
+
|
|
108
|
+
提示词(任意写批任务,如 A2):
|
|
109
|
+
```
|
|
110
|
+
请写 8 个文件 modules/m1.txt 到 modules/m8.txt,第 N 个文件内容为 'module N: ok'。
|
|
111
|
+
```
|
|
112
|
+
- 操作:任务进行中 kill -9 杀掉 dsh 进程(写入前后各试一次);重启后向**同一会话**继续。
|
|
113
|
+
- checks:重启后第一回合**立即 blocked(停机核对)**,不发请求;`dsh-stream-agent intents`
|
|
114
|
+
能列出 pending 意图;人工核对文件后 `--ack` 闭合,重发任务能正常完成且**无重复写**。
|
|
115
|
+
|
|
116
|
+
### B8 长会话段边界(F7)
|
|
117
|
+
|
|
118
|
+
操作:同一会话连续发 10+ 个独立小任务(如"写 seg-<N>.txt 内容为 N")。
|
|
119
|
+
- checks:中途某回合起台账出现 `segment-drop`;被丢弃段可用 `tf-peek` 句柄回取;
|
|
120
|
+
会话末尾若干任务的首请求体积不再随历史增长(≤1.5× 首任务口径)。
|
|
121
|
+
|
|
122
|
+
### B9 双 loop 具名诊断(S3)
|
|
123
|
+
|
|
124
|
+
操作:把插件装进**已有内建 loop 的 profile**(web/desktop)。
|
|
125
|
+
- checks:启动/接管**具名失败**,错误含 `E_DOUBLE_LOOP`、`profile=`、处置建议;
|
|
126
|
+
不是宿主裸错,也不静默共存。装回专用 profile 恢复正常。
|
|
127
|
+
|
|
128
|
+
### B10 安装前置校验(S2)
|
|
129
|
+
|
|
130
|
+
操作:`node scripts/install-check.mjs --profile web --dry-run` 与 `--profile stream --dry-run`。
|
|
131
|
+
- checks:web/desktop 被拒(含原因与允许列表);stream 允许并打印装配面;
|
|
132
|
+
校验不写任何东西。
|
|
133
|
+
|
|
134
|
+
## C 组:成本对照(R3 的手工版)
|
|
135
|
+
|
|
136
|
+
- 每个命题跑两臂(原生 loop 臂:卸载插件或用 eval-baseline patch;插件臂),
|
|
137
|
+
`node eval/tools/summarize.cjs --stamp <你的stamp> --md` 出逐任务四分量表。
|
|
138
|
+
- 判定:插件臂全量 token ≤ 基线 22.3% 口径下的同批复算值;checks ≥9/10;
|
|
139
|
+
请求数护栏 ≤59/10 任务。**新命令面(B1/B3)单独建基线,不与旧任务混算比例。**
|
|
@@ -0,0 +1,61 @@
|
|
|
1
|
+
# ADR-001:长会话段边界 —— 整块丢弃(Whole-Block Discard)
|
|
2
|
+
|
|
3
|
+
- 状态:已采纳(0.3.0 实施,随 v0.4.0 规划 F7 交付)
|
|
4
|
+
- 决策日期:2026-11-16
|
|
5
|
+
- 影响范围:`src/kernel/render.ts`、`src/entry/loop.ts`、`docs/limitations.md`
|
|
6
|
+
|
|
7
|
+
## 背景
|
|
8
|
+
|
|
9
|
+
单流驱动器的稳定段(首条 system + 追加区)随任务增长单调追加——这是前缀缓存命中
|
|
10
|
+
的前提(C7:首条 system 逐字节冻结;追加区只增不改)。长会话(多任务连续 followup)
|
|
11
|
+
下追加区无界增长:输入 token 线性膨胀,最终任务的首请求会拖上全部历史。
|
|
12
|
+
|
|
13
|
+
v0.4.0 规划 F7 要求给出段边界方案,两条候选路线:
|
|
14
|
+
|
|
15
|
+
1. **整块丢弃**:旧段整体移出上下文,被丢弃原文句柄化(可按句柄回取),下一请求
|
|
16
|
+
前缀重置——显式记录的缓存重置点。
|
|
17
|
+
2. **宿主压缩**:接受宿主 compaction 改写历史,压缩点作为新前缀起点,显式记录
|
|
18
|
+
"缓存重置"。
|
|
19
|
+
|
|
20
|
+
## 决策
|
|
21
|
+
|
|
22
|
+
**采纳路线 1(整块丢弃),拒绝路线 2(宿主压缩)。**
|
|
23
|
+
|
|
24
|
+
理由:
|
|
25
|
+
|
|
26
|
+
1. **摘要式改写是红线**:压缩必然摘要/改写中间历史——这正是全项目禁止的
|
|
27
|
+
("禁止智能压缩/摘要";模型事实一旦被改写,台账与上下文不再一致,排障与
|
|
28
|
+
验收都失去依据)。宿主压缩的改写发生在插件视野之外,无法保证"改了什么"可审计。
|
|
29
|
+
2. **整块丢弃保持事实完整**:被丢弃的块原样保留在 obs 账本(句柄 `obs:read:seg-*`),
|
|
30
|
+
`tf-peek` 按行段取回原文——"原文可按 request:N 回取"的落地形态。不摘要、不改写。
|
|
31
|
+
3. **边界可审计**:丢弃只发生在**完整回合边界**(新任务开始处),policyLog 显式记录
|
|
32
|
+
(kind: segment-drop),台账同步(plugin:tf-agent/fault)。未记录的前缀不一致
|
|
33
|
+
仍会被 render() 的 preflight fail-closed 拦截——这是唯一合法的前缀重置入口。
|
|
34
|
+
|
|
35
|
+
## 实现要点
|
|
36
|
+
|
|
37
|
+
| 要点 | 落地 |
|
|
38
|
+
|---|---|
|
|
39
|
+
| 触发条件 | 新回合开始(runTurn)且追加区字符数 > `segmentMaxChars`(缺省 160k ≈ 40k tokens;0/负数关闭) |
|
|
40
|
+
| 丢弃范围 | 追加区**头部**整块:从 0 到 `#segmentKeepFrom`(当前任务块起始下标)——即上一个已收束回合的全部块 |
|
|
41
|
+
| 块完整性 | 只丢整块,不拆块;工具调用与结果(同一回合内的 assistant 块与句柄增量)同进同出 |
|
|
42
|
+
| 原文回取 | 每个被丢弃块登记 obs(`obs:read:seg-t<turn>-<i>@v1`),`tf-peek`/`peekHandle()` 按行段取回 |
|
|
43
|
+
| 前缀语义 | `dropAppendHead()` 重置前缀基线(#lastStable = null)+ policyLog 记录;其余任何前缀不一致仍 fail-closed |
|
|
44
|
+
| 验收 | 100+ 请求 0 前缀违规;边界后首请求体积 ≤ 阈值 + 当前任务(末/首 ≤1.5× 断言见 test/f7-segment.test.ts) |
|
|
45
|
+
|
|
46
|
+
## 明确不做什么
|
|
47
|
+
|
|
48
|
+
- 不做摘要式压缩,不改写任何历史消息内容。
|
|
49
|
+
- 不在回合中间丢弃(当前回合的块永不丢弃——工具调用与结果不被拆开)。
|
|
50
|
+
- 不把"装配面缩小"或"丢弃"写成 token 收益:丢弃的收益是**长会话有界**,代价是
|
|
51
|
+
一次显式缓存重置(下一条请求缓存未命中);两者都在文档中如实呈现。
|
|
52
|
+
|
|
53
|
+
## 后果与已知限制
|
|
54
|
+
|
|
55
|
+
- 丢弃后的第一条请求是缓存冷请求(cacheWrite 重新计费)——这是"整块丢弃"路线的
|
|
56
|
+
固有代价,发生频率受 `segmentMaxChars` 控制(阈值越高重置越少)。
|
|
57
|
+
- 多任务排队时(连续 pushUserTask 未 runTurn),段边界取**最后一个**任务块的起始
|
|
58
|
+
下标;更早的排队任务块会被视为"旧段"丢弃(原文可回取)。需要跨任务连续上下文
|
|
59
|
+
的用法应把多个目标放进同一条任务文本,而不是排队多条。
|
|
60
|
+
- `resumeIntentPolicy` / `segmentMaxChars: 0` 均为独立回退点;关闭段边界后长会话
|
|
61
|
+
回到"追加区无界增长"的已知限制(docs/limitations.md)。
|