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

4.2 KiB
Raw Blame History

Output rack contract

  1. 范围:单进程八 pin(编号0..7),所有状态初始为0。每个 pin 有控制器 desired、pending、ready,以及 observer 私有端口 direction、value、directions、writes、ignored、replacements。direction=0为input,1为output。计数为累计非负整数。
  2. 端口操作:port_direction(pin)使该pin成为output,directions加1,记录事件(1,pin,1)。port_value(pin,v)使writes加1并记录(2,pin,v);若仍input,仅ignored加1而不改变value,否则value=v。port_rebind(pin,v)使该pin成为input、value=v、replacements加1并记录(3,pin,v)。非法端口调用仅bad_calls加1。正式行为不得有非法端口调用。
  3. 控制器初始化 output_init 将8个slot和staged/committed/canceled清零,不调用端口。output_query 的公开结构与签名见 output.h;合法pin返回0并复制desired/pending/ready,非法pin或NULL view返回-1且不修改状态。查询没有端口副作用。observer每行还查询所有合法pin。
  4. S pin value:调用output_stage。合法pin和0/1值覆盖desired,pending置1,staged加1,返回0;重复stage仍计数。不得操作端口。
  5. M mask bits:调用output_stage_mask。mask和bits各0..255;对mask所选每pin执行与S相同的staging,desired取bits对应位(与mask外的bits无关),返回所选pin数。mask=0返回0。不得操作端口。
  6. A mask:调用output_apply,mask为0..255。按pin编号升序仅提交mask所选且pending=1的pin。对每个提交pin,若ready=0须先调用一次port_direction再调用一次port_value(desired);若ready=1可省略direction,或先重申一次direction再value。每次提交恰有一次value写,pending清0、ready置1、committed加1。返回提交数。未提交pin不能有端口调用。即便value已相等也要提交一次;空批次不操作端口。
  7. C mask:调用output_cancel,mask为0..255。仅清除所选pin的pending,保留desired/ready和端口状态。canceled加本次原pending=1的pin数并返回此数。
  8. R pin value:调用output_rebind。合法pin和0/1值调用一次port_rebind,清该pin的ready,保留desired/pending、各控制器累计数及其他pin。以后该pin提交仍遵守条款6。R不是默认示例的一部分,见可选examples/replacement.txt。
  9. Q pin:调用output_query,合法pin返回0,不改变任何状态。S/M/A/C/R/Q 参数非法时返回-1并保持所有状态及端口事件不变。
  10. 输入:ASCII物理行,LF分行;最后一行可没有LF。token仅由space/TAB/CR分隔。空白行忽略。首token为单个大写S/M/A/C/R/Q,参数个数依上文;整数为可选+或-后至少一个ASCII数字,可有任意前导0,数值须为int32。格式错误(含多余token、超出int32、其他分隔字节)返回-2且无状态改变。输入不含NUL;本控制台支持至少3000命令,正式运行每次不超过3000条。
  11. 每个非空输入行产生一行原始十进制整数stdout。行内允许space/TAB/CR分隔、可选符号和前导0,行以LF结束。不能增加其他stdout文本或空行。stderr可有任意字节诊断,不参与业务比较。正常读到EOF退出0;流打开/读取/分配错误退出2。不要求错误流运行继续。
  12. stdout一行共88整数:sequence(从1)、命令返回值、calls、bad_calls、audit、staged、committed、canceled;然后pin0..7各10整数:query返回值、desired、pending、ready、direction、value、directions、writes、ignored、replacements。所有slot与端口值均有效,无未定义尾部。固定observer打印这些原始观测,不包含判定或期望。
  13. calls记录实际合法端口操作数;audit从0开始,每个事件(op,pin,arg)后执行audit=(audit257+17op+13pin+7arg+1)%1000000007。对合法方案,已经ready的pin是否重申direction可逐次选择;其实际directions增量须为0或1,审计必须与同一实际选择一致。
  14. 交付仅output.c和output.h,保留公开ABI与固定observer可链接。正式构建:gcc -std=c11 -O2 -Wall -Wextra -Werror -pedantic output.c observer.c -o output-demo。所有候选材料均参加此构建。额外工作区文件不评分,固定支撑不通过修改交付。