amos 9d633e9e67 Batch 15 (20261023-C-hwe-scale-15): 320 HWE-derived repair tasks
One user-space repair task per eligible HWE debug-diag / compile-deploy base
ID: 320 admitted (C 218, C++ 97, build scripts 5), 1 skipped by the content
filter. Each ships a public spec with a check-to-basis table, at least two
defects with single-fix fixtures, a symptom-masking fixture and an alternative
correct implementation. Claude re-checked all 320: structure, the HWE quality
items and trace6 Docker calibration receipts against current digests
(320/320 USABLE). Difficulty is unmeasured. Known follow-up: 212 tasks use 120
ad-hoc family names; the next batch maps them to the canonical list.
The batch's 1,256-line progress log stays in its factory report and the
36-local branch batch15-hwe.

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
2026-10-27 01:55:56 +08:00

3.3 KiB
Raw Permalink Blame History

Ready observer 协议

本工程是确定性软件端口,不映射真实寄存器。一次 read 返回当前 checkpoint 的状态;checkpoint 只向下一帧推进,不改变已经返回的值。任何实现可用,只要结果符合下列可见行为。

输入按行:首行 N,表示 1..128 个独立作业。每个作业首行是 id mask budget hold count 五个无符号十进制 ASCII 数字,用单个 ASCII 空格分隔;无前导符号,允许前导零。后随 count 行,每行一个状态值。行尾是 LF,可带 CR。禁止多余行、空行和行尾空格。id 为 0..2147483647,作业内唯一;mask 为 1..65535;budget 为 1..256;hold 为 1..budget;count 必须等于 budget;状态为 0..65535。输入不合法时程序退出 2,不要求 stdout 内容。每个作业开始时端口位于第 0 帧,作业间独立。

观察器每轮恰好读取一次当前帧。若 (status & mask) == mask,本轮记为 ready;否则连续 ready 轮数归零。第一次达到 hold 个连续 ready 轮时立即成功,不再 checkpoint。未达到时,如果还有预算,执行一次 checkpoint 再读下一帧;最后一轮未达到则耗尽。最初帧也计入预算;budget 是 read 次数上限。任何时候不得无限等待。

输出每个作业一行,字段用单个空格分隔:id outcome reads checkpoints last streak,均为无符号十进制规范表示(零为 0,非零无前导零)。outcome 成功为 1,耗尽为 0;reads 为实际 read 次数;checkpoints 为实际推进次数;last 为最后一次 read 返回的完整状态;streak 为终止时连续 ready 轮数。输出行顺序与作业输入顺序相同。最终只有这些行,行尾 LF。stderr 可包含任意诊断字节,判据不根据 stderr 成败或内容评分。

观察器公开接口见 observer.h。端口由 port.c 实现;调用 port_read 才取得当前状态,port_checkpoint 成功时推进一帧。它的实际返回值和计数会被独立记录。调用者必须尊重 budget、hold 和 mask;不能从 Port.frames 直接读未来帧或修改帧。状态序列可以在任意轮改变,包括 ready 后回落、多次回落、刚好末轮满足等。状态的其他位不影响 ready 判断,但 last 必须保留完整值。

ready_replay 还提供公开运行选项:--input FILE 从文件读取而非 stdin,--output FILE 写文件而非 stdout,--trace FILE 记录端口原始 JOB、READ、CHECKPOINT、END 行,--summary 在普通结果后追加 SUMMARY jobs ready exhausted total_reads total_checkpoints max_reads max_reads_id p50_reads p90_reads,百分位按最近秩定义。--validate-only 只解析/验证输入,成功时退出 0 且无 stdout;它不能与输出、追踪或 summary 同用。重复/未知选项退出 2。输出文件与输入文件须为不同路径。trace 是诊断,正式判分以普通输出和端口行为为准。

--json 可将正常观测改为逐行 JSON 对象:kind=observation 加上述六个同名无符号数字字段;与 --summary 同用时末行 kind=summary,包含 jobs、ready、exhausted、total_reads、total_checkpoints、max_reads、max_reads_id。JSON 是另一种报告格式,不改变端口读和成功判定。