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>
4.8 KiB
配置档案合同
C01
工程为离线 C11,构建命令 make clean && make,工具 gcc、make。PROFILE_LAYOUT/Make 的 LAYOUT 可为0、1、2、3,默认为0。四种 include/layout.h 声明仅改变字段位置,全部命名字段含义相同。修复不限制初始化语法。公开 observer.c 与头文件 API 均为交付接口。
C02
档案有8槽(ID 0..7),每槽包含存在性、revision,以及有名字的五字段 x、y、gain、bias、limit。x/y/bias 在[-1000,1000],gain在[-16,16],limit在[0,100000]。每个范围含端点。Bank 初始化全部不存在、epoch=0、两个快照无效。
C03
PUT id x y gain bias limit 按参数名称完整替换/创建该槽,所有参数及ID有效才成功。成功令epoch加1,槽revision等于新epoch。配置字段不随构建布局改变。
C04
PATCH id mask x y gain bias limit 的mask为0..31;位1/2/4/8/16分别选择x/y/gain/bias/limit。选中的参数是替换值,0与任何其他合法值一样有效;未选中的参数不参与范围校验,也不改变原字段。按修改后的整体配置校验并原子提交。成功包括mask0/相同值,也令epoch加1并更新revision。
C05
DELETE id 成功删除已有槽并令epoch加1。删除后槽不存在;不要求内部无效存储内容。CLONE source destination 从存在的源复制五字段,目标可已存在,可与源相同;成功epoch加1,仅目标revision为新epoch。
C06
SWAP left right 要求两槽均存在,可为同一槽;交换五字段,epoch只加1,两槽revision均等于新epoch。
C07
SAVE snap 只接受快照ID0..1,保存当前所有槽的独立副本,快照有效;不变更epoch或活动槽。RESTORE snap 对有效快照整体恢复存在性与字段,epoch加1,所有恢复后存在槽的revision为新epoch;不变更两个快照。快照可重复恢复、被SAVE替换,RESET令两者无效。
C08
GET id 对已有槽返回其五字段及revision,无状态变化。SUMMARY 无状态变化。RESET 清空所有状态,epoch回到0。
C09
每条操作返回0成功;ID、mask或参数超范围返回-1;需要存在的活动槽缺失返回-2;快照ID合法但无效的RESTORE返回-3;词法或命令结构错误返回-4。多重错误顺序:先命令词法/参数个数,再ID/mask/MEASURE样本范围,再存在性,再PUT整体或PATCH所选后的字段范围。PUT无存在性前提。任何失败全部状态与快照不变。
C10
MEASURE id sx sy 的sx/sy都在[-10000,10000],只对存在槽计算dx=sx-x,dy=sy-y,raw=dx*gain+dy+bias,value=max(-limit,min(limit,raw)),distance=abs(dx)+abs(dy),clipped=(raw!=value)。不变更状态;失败的Measurement四项均0。除MEASURE外所有命令的Measurement四项也为0。
C11
Summary 对活动存在槽统计 count、x_total、y_total、limit_total、negative_gains(gain<0)、zero_limits(limit=0)。digest由17起,按槽ID0..7依次吸收id、存在位0/1;存在时继续吸收revision、x、y、gain、bias、limit。吸收整数v的公式为 h=(h*257+(v mod 1000003)) mod 1000003,其中mod取非负余数。快照不参与Summary。
C12
stdin是ASCII命令,每行一条,可有前后或连续space/TAB/CR;LF分行,末行可无LF。命令大小写敏感。参数是完整十进制token,可有一个前导+或-、任意前导0,数学值须在有符号64位范围内。行长度不含LF最多16384字节。空行、未知命令、参数缺多、非十进制或64位溢出返回-4;VT/FF不是分隔符。
C13
命令参数个数:RESET/SUMMARY为0;PUT为6;PATCH为7;DELETE/SAVE/RESTORE/GET为1;CLONE/SWAP为2;MEASURE为3。程序持续处理失败后的下一行,正常读到EOF退出0;输入/输出I/O故障可退出2。不依赖argv或环境选择业务结果。
C14
observer.c每条输入行输出一条原始观测行,顺序为:命令rc、epoch、Summary的count/x_total/y_total/limit_total/negative_gains/zero_limits/digest、Measurement的raw/value/distance/clipped;随后ID0..7各输出GET的rc、revision、x、y、gain、bias、limit。对缺失槽observer预置revision与五字段为0;GET失败无需写其输出参数。
C15
stdout只含C14观测行,整数可用前导+、前导0和-0,水平分隔可用space/TAB/CR,行以LF分隔,最后一个LF可省略。不能有额外非空行/字段。stderr允许任意诊断字节,不作为业务判断依据。正式验收会重编译候选与公开observer并按全部布局测试,不以Makefile展示字符串代替行为。
C16
默认示例examples/demo.in仅使用布局0,零值补丁后槽0.x应为0,第二次MEASURE应有raw22/value22/distance13/clipped0。独立可选examples/reordered.in不含补丁,布局1、2、3与0应有相同命名字段及测量结果;此情境不属于默认make demo。