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>
3.7 KiB
3.7 KiB
有限文件图盘点合同
- 输入是零个或多个
LINKGRAPH 1文档,每个随后一行LIMITS initial maximum repetitions,然后 LINK、FILE、QUERY 条目,以独立END行结束。空白行允许;字段只以 ASCII SPACE/TAB/CR/LF 分隔。LIMITS 是完整 ASCII 十进制,可有前导+和任意前导0;1<=initial<=maximum<=512,1<=repetitions<=4。每条物理行少于1400字节。正式测试只用合法文档。 - 文档含0..64个唯一节点、0..128个QUERY。LINK和FILE条目为
LINK /path hex、FILE /path hex,hex大小写均可,偶数位,-表示0字节,解码长度0..512;目标可含任意字节(包括0),是有限图中的不透明数据,不递归跟随。QUERY为QUERY /path。每份文档的节点与请求互不继承。 - 路径绝对,以/开头,非分隔字符限可打印ASCII,不含空白;归一化折叠重复/、.、..,..在根处保持根,移除末尾/(根除外)。归一化路径含末尾NUL最多128字节。QUERY可引用不存在路径或FILE。节点按归一化路径唯一。图可任意节点顺序加载,查询必须按输入顺序、外层repetitions次序产生结果。节点排序是公开实现细节,lb_find必须返回对应节点。
lb_load返回1表示一份图,0表示正常EOF,-1表示格式错误;lb_collect返回0表示完成盘点。结构与全部接口在include/linkbuf.h中。结果每次重新开始,不遗留上一文档内容。最多512行结果,每行path为归一化QUERY。LB_OK=0、LB_TRUNCATED=1、LB_MISSING=2、LB_NOTLINK=3、LB_NOMEM=4。- 固定端口lb_port_readlink复制min(target_length,capacity)个原始字节,返回复制长度,不补NUL;不存在返回-1/ENOENT,FILE返回-1/EINVAL。短于capacity的返回值给出完整目标。返回值等于capacity时不能证明完整,须在maximum允许时使用更大容量重新读取;在maximum仍填满则返回TRUNCATED及maximum字节前缀,即使真实长度恰等maximum。可从任意initial..maximum容量开始,可复用缓冲,可直接使用maximum,不要求特定调用次数或分配策略。OK长度是真实目标长度;错误MISSING/NOTLINK长度0且无有效目标字节。NOMEM仅分配失败时使用,正式环境正常分配成功。
- 工作缓冲只通过lb_port_allocate/lb_port_release取得和归还,非零大小不大于512;归还NULL无效果;每个有效分配必须恰好归还一次。lb_collect返回时live_blocks、live_bytes、bad_releases须为0,allocations==releases。不要求分配次数、峰值或read_calls的特定值。端口用0xa5初始化工作区,观察在清理兜底前进行;lb_port_end只是让下一文档独立,不免除本轮责任。结果有效范围仅target[0..length),不要求unused尾部内容。
- totals是[length总和,OK数,TRUNCATED数,MISSING数,NOTLINK数,NOMEM数,checksum]。每个目标以state=0起始,对每字节计算state=(state*33+byte)%65521;checksum是每行state之和模65521。错误行贡献0。路径与目标打印为小写hex;rows每行为[pathhex,status,length,targethex];rc记录lb_collect返回值;resources为[allocations,releases,live_blocks,live_bytes,peak_bytes,read_calls,bad_releases]。
- 固定observer只记录原始结构,不判断正确性。stdout须含每文档一个JSON对象,允许JSON whitespace及连续对象,以完整JSON解码依次消费;字段类型和结构如第7条。额外非JSON内容不属于协议。stderr可含任意诊断字节,不影响正确结果。正式运行以干净工程编译三个候选src加公开固定port/observer,无其他候选文件参与构建。所有本合同合法配置都须工作,包括可选容量例子、空图、重复路径请求及多文档。