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

6.6 KiB
Raw Permalink Blame History

导出合同 v1

  1. export_job(job, ports, report) 每次独立处理一个批次,成功返回0,否则-1。输入合法配置serial为0..1000000,count为0..32,channels为1..8,-1000<=lower<=upper<=1000,flags为0或1(1启用索引)。配置不合法:error=1、role=-1、不调用端口,其他计数/数组清零,仅所有channel.last_tick=-1。合法调用者提供有效指针和ports回调。

  2. record有kind/channel/value/tick。合法tick为0..65535,value为-32768..32767;kind为0样本、1备注、2屏障。样本/备注channel须0..channels-1;屏障要求channel=0,value=0。违反任一者status=3;合法备注status=4,合法屏障status=5;合法样本value在闭区间[lower,upper]为status=1,否则status=2。不校验时序单调性。

  3. report在任何端口获取前汇总完整批次:accepted/filtered/invalid/notes/barriers分别为status 1..5的总数;sum只加accepted的value。各channel统计accepted/filtered/notes及accepted的sum/minimum/maximum/last_tick(最后输入顺序的accepted tick)。没有accepted时min/max/sum为0,last_tick=-1,未使用channel同样清零/-1。checksum为每个accepted累加 (((value+32768)*31+tick)*17+channel+ordinal) 后模1000003(ordinal从0开始)。error最初0,role=-1。

  4. 输出的每行都是ASCII、字段用单空格分隔、末尾LF、没有NUL。按输入顺序:status1输出data D serial ordinal channel tick value;status5输出data B serial ordinal tick。所有记录接着输出audit A serial ordinal status;flags=1且本记录有data时接着输出index I serial ordinal offset length,offset为本记录data前的累计data字节数,length含LF。每行一次write,不合并、不拆分,行无多余字段。

  5. 尾部依次为data T serial accepted filtered invalid notes barriers sum checksum、audit Z serial count,flags=1再输出index E serial data_bytes(包括T行)。report.planned[role]为该路所有应写字节数,端口失败也保留完整planned与汇总;report.delivered[role]只累计返回0的write长度。角色data=0,audit=1,index=2。

  6. 获取:依次open(context,role,serial),角色0、1、可选2。只获取本批资源;任何open返回NULL立即停止获取和业务输出,但仍释放已得资源。error=10,role=失败角色。多个FILE资源按实际成功获取的逆序close,每个恰一次,即使close失败也继续;close回调消耗FILE,禁止使用已消耗/未知FILE。第二open失败同样须释放第一个。

  7. 所有获取成功后按4、5写入;write非0即error=20并停止所有后续write和flush。全部write成功才按角色0、1、可选2依次flush,flush非0即error=30并停止后续flush。close非0为error=40。全程只记录第一个错误和角色,后续操作不能覆盖它;释放永远进行。任何错误返回-1。无错误返回0,error=0,role=-1。

  8. 公开observer输入:首行十个十进制int:serial count channels lower upper flags open_fail write_fail flush_fail close_fail;后面count行kind channel value tick。故障参数为对应操作的第几次调用返回失败,0表示不注入;回调失败时open不产生资源、write不写任何字节、flush不改变数据、close仍消耗资源。每次成功open用真实tmpfile生成独立FILE身份;记录未知/重复操作但不真的doubleclose坏FILE。observer的端口trace及report是原始观测,业务库须通过这些端口操作,不能自行打印结果/获取额外资源。observer输出JSON,每行一个批次;按stdin直到EOF,stderr可包含任意诊断字节。独立评分只验证stdout的JSON结构和值,不要求JSON唯一排版。

  9. observer输出的report数组依次为 export_job返回值,error,role,accepted,filtered,invalid,notes,barriers,sum,checksum,planned0..2,delivered0..2;channels为8行,每行accepted,filtered,notes,sum,minimum,maximum,last_tick;trace每项[操作,role,结果,十六进制payload],open/flush/close无payload,操作名O/W/F/C;live为返回时未释放句柄数。trace按实际调用先后,非法句柄role=-9,result=-9。observer在打印后仅做物理善后,不篡改live。全部公开合同均需满足,不以只达到live=0代替身份和顺序。

  10. read_job返回1表示读取完整批次,干净EOF返回0,词法错误/截断/负故障编号/count超0..32返回-1(observer退出2)。输入token仅ASCII十进制整数,可选+/-、任意前导0,必须在C int范围;分隔只允许space/TAB/CR/LF,允许多种分隔混合。其他字节、孤立符号、溢出为词法错误。失败不调用业务。stdout按第9条的JSON类型结构比较,数组中的数字必须是JSON整数(不能是bool/float)。

  11. channel额外趋势字段:first_tick为首accepted的tick、low_tick/high_tick为accepted tick最小/最大、previous为最后accepted的value;相邻accepted的值上升/下降/相同计数rising/falling/repeated,tick下降计数regressions,movement为相邻值绝对差之和,intervals为相邻tick带符号差之和。run为末尾连续相同值accepted数量,longest_run为最大连续相同值段长度。无accepted时这些字段均0。observer的channels各行在第9条七个字段后,依次追加first_tick,low_tick,high_tick,previous,rising,falling,repeated,regressions,movement,intervals,run,longest_run。此趋势仅相邻accepted,filtered/invalid/note/barrier不打断。

  12. 在全部记录行后、T/Z/E尾部前,按channel从0到channels-1向audit输出每channel一行 S serial channel accepted sum movement regressions longest_run。各行一次write,属于planned/delivered统计;第4条的逐条输出及第5条尾部顺序不变。plan容量110(最多32*3+8+3=107行),全部plan容量足够。

  13. read_job的公开原始观测入口为make后./app --framed的P帧。stdin依次给 P 字节长度+LF和该长度原始输入(0..60000字节);每帧对独立FILE调用一次read_job,打印JSON {"status":返回值,"fields":[]};成功时fields依次为十个头字段、每条记录的kind/channel/value/tick。失败/EOF时fields为空,仅观察返回值,不要求未定义的失败输出结构。read_job只读取一个批次,完整批次后的剩余数据不影响此次返回。

  14. observer的./app --framed入口可在同一进程顺序观测多个独立输入。每帧头为 E 字节长度+LF(第8条导出输入)或P 字节长度+LF(第13条parse输入),然后紧随0..60000字节原始输入。各帧用独立FILE;E输出第9条原始JSON,P输出第13条原始JSON。默认无参数入口保持第8条。此入口只转发输入和原始结果,不含业务期待或断言。