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.8 KiB
通道比例映射台账协议 v1
C01. 这是离线整数计数映射服务。正常读取stdin直到EOF,逐个物理LF行处理;最后一行可无LF。每行最多256字节;命令分隔只允许ASCII space、TAB、CR;空行忽略。不依赖网络、板卡或时钟。每次进程从16个未配置通道开始。
C02. 数字输入是完整ASCII十进制token,可有前导+/-和任意前导0;数值在各命令公开范围内。没有指数、小数点、下划线、VT、FF或NUL。命令名大写。非法词法、命令、参数数目或行长度输出E 1且状态不变,继续处理后续行。
C03. CONFIG slot raw_low raw_high out_low out_high:slot为0..15,raw边界为-1000000..1000000且raw_low<raw_high;out边界为-1000000000..1000000000,可递减或相等。非法范围输出C slot -2 0;非法slot输出C slot -1 0。slot值若不适合int32由输入层判E 1。其他参数解析为int64,超出int64判E 1。
C04. CONFIG成功输出C slot 0 generation。每个slot的generation从0开始,每次成功CONFIG或对已配置slot的DROP增加1;CONFIG到已有配置时必须原子替换配置,并清空该通道所有统计(包括极值和clipped)。generation保留,不能回到1。失败不改变配置、代际或统计。
C05. FEED slot raw weight:raw为-1000000..1000000、weight为1..1000。先验证slot,再验证是否已配置,再验证raw/weight;依次错误码-1/-3/-2。失败输出F slot rc 0 0且状态不变。成功输出F slot 0 mapped weight。每个通道自最近一次CONFIG或CLEAR以来最多256个成功FEED,达到后返回-4且状态不变。
C06. 成功FEED把raw夹到配置的闭区间,clipped仅在原raw超出区间时增加1。mapped为out_low+(clamped-raw_low)*(out_high-out_low)/(raw_high-raw_low)的数学有理值,取最近整数,恰在半数时远离0。必须先合成完整有理表达式再取整;不指定浮点表示或实现方式。
C07. FEED以原始raw(不是夹后raw)累计raw_total +=rawweight;mapped_total +=mappedweight;samples增加1,weight累计。min/max是本代成功FEED所得mapped的极值,不考虑weight。配置前和配置后空状态的所有统计为0。
C08. SNAP slot输出S slot rc generation samples weight raw_total mapped_total raw_mean mapped_mean minimum maximum clipped。非法slot为rc=-1且后续所有字段0,未配置为rc=-3且generation保留、其余统计0。成功rc=0。非空raw_mean、mapped_mean分别为对应total/weight按C06同样半远离0取整,空均值和极值为0。SNAP不改变状态。
C09. DROP slot:非法slot输出D slot -1 0,未配置输出D slot -3 generation且不变。成功输出D slot 0 generation,释放配置、清空所有统计并增加代际。
C10. TOTAL输出T configured samples weight raw_total mapped_total clipped;逐个已配置通道累加,configured为其数量。已DROP通道不贡献统计,TOTAL不改状态。
C11. 公开接口在ratio.hpp。全部状态及返回对象只比较定义的字段,内部实现自由。输出每个命令恰一行,字段按上述顺序。符号标签固定,数值token为完整ASCII十进制整数,可带+/-或任意前导0;数值间一个或多个space/TAB/CR,允许行首尾这些水平空白。正常进程退出0;stderr允许任意诊断字节且没有大小上限。
C12. make以g++ C++17构建ratio-map;./ratio-map < examples/default.txt和./ratio-map < examples/reconfigure.txt是公开复现。也可./ratio-map --input FILE,文件打开失败退出2;非法argv退出2;正常空输入退出0。修复不得破坏本协议任何条款,只提交mapping.cpp和ledger.cpp。
C13. CLEAR slot仅清空该通道所有统计,保留配置与generation。输出Z slot rc generation;非法slot为-1/0,未配置为-3/原generation;成功rc=0。失败状态不变。