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.1 KiB
4.1 KiB
站点账册接口合同
- 工程以C11构建,正式构建固定为
gcc -std=c11 -O2 -Wall -Wextra -Werror lexer.c model.c parser.c observer.c -o ledger。Makefile、parser.h和observer.c是固定公开支撑,提交三个.c候选源;全部源都参与正式构建。不得依赖新增文件或修改固定支撑。 rp_load("ledger", result)从端口打开一个流,解析临时模型,只有完全成功才更新result。所有失败须保持result对象全部字节不变;先前成功结果也受此保证。返回码:0成功,-1打开失败,-2格式错误,-3读取失败,-4超过传感器容量,-5关闭失败。- 端口最多同时存在4个流。每次成功打开都必须关闭恰好一次,无论解析结果;打开失败不关闭。rp_close总会归还槽位,配置close-fail时返回-1。格式/容量/读取失败的原返回码优先于关闭失败;否则关闭失败返回-5。
- rp_get返回0..255或-1;-1可能是正常EOF,也可能读故障,须以rp_error区分。error_at=-1禁用故障;非负时在读到该字节偏移前返回故障,即使偏移恰等于文件长度也先报故障。open-fail在打开前失败。允许非空/空文件,缺END不是完整文档。
- 每文档最多8192字节,超出返回-2;每逻辑行最多160字节,不计LF。末行可不含LF。字节0与非ASCII正文非法。行内分隔仅space、TAB、CR;LF分行。整行在跳过这些水平空白后以#开始则为注释,注释剩余字节可为任意非零字节。空行忽略。不支持行尾注释。
- 非注释行由如下精确字段构成:SITE name;RATE n;SENSOR id kind gain bias;LIMIT id low high;END。关键字区分大小写,字段间至少一个水平空白,首尾水平空白允许。数字为完整ASCII十进制,可前导+/-及任意前导0;不得接收下划线、指数、其他字节。
- SITE必须唯一且在所有其他有效记录前;name为1..24个小写字母、数字或-。RATE可省略,默认1;出现须在SITE之后且首个SENSOR之前,最多一次,取值1..1000。
- SENSOR需在SITE之后,id范围0..31且不重复,kind为T/V/I之一,gain为1..1000,bias为-100000..100000。最多8个;第9个合法且不重复的传感器返回-4,字段错误/重复先按-2处理。顺序按声明顺序保存。
- LIMIT只能引用已经声明的传感器且每个至多一次;low/high范围-100000..100000,low<=high,等值允许。has_limit只取0或1;不存在LIMIT时low/high未定义,不得要求特定值。
- END必须恰一个字段,且已有SITE及至少一个SENSOR;后续只能空行或注释。到正常EOF时须已END。格式/容量错误可在首次发现时停止读取;若已发现这类错误则无需继续探测后续读故障。测试的注入读取失败只放在语法/语义有效的完整文档或有效前缀,避免给错误先后添加额外约束。
- observer.c是确定性端口与原始观察器,不含答案或行为断言。stdin首先十进制case数,随后每case四字段:error_at open-fail close-fail hexbytes;空文件hex为-。各case在同进程连续加载,槽位和累计计数不重置。最多8192+512个输入字节,受控拒绝超长文档也在此范围。仅传递ledger名,不读取宿主文件。
- stdout为一个JSON值并完整消费(JSON前后空白允许),对象rows为逐次原始观察。每row的rc/live/opens/closes/unchanged为整数;成功再含site、rate、sensors;sensors每项为[id,ASCIIkind,gain,bias,has_limit],有LIMIT再追加low,high。仅有效模型范围参与观察,unused槽与未定义字段不检查。失败unchanged须为1;成功unchanged是原始记录,不要求特定值。不得省略必需观测;JSON键顺序/空白无约束,stderr允许任何诊断字节。
make demo为默认公开复现,连续加载格式错误记录再恢复正常账册,不注入读取故障。make read-fault为独立可选复现,在完整文档末尾注入读取失败及恢复;只运行默认demo不能覆盖此情境。demo本身只输出观测,程序正常退出0不代表业务正确。