amos 4f17b2afe5 Batch 20 (20261027-C-family-20): map batch 15's ad-hoc families to canonical ones
210 batch-15 tasks used 119 ad-hoc family names. Each now carries one of the
canonical root-cause families (11 of the 19 are used), with version + 1 and a
spec.md note, and was recalibrated through both gates. Claude checked that only
family, version and spec.md changed, that every family is canonical, and the
new trace6 Docker receipts against current digests (210/210 USABLE).
Squashed from the 36-local branch batch20-family.

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
2026-10-27 05:58:17 +08:00

84 lines
10 KiB
Markdown
Raw Blame History

This file contains ambiguous Unicode characters

This file contains Unicode characters that might be confused with other characters. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.

# dev-tx-frames v1
状态 CALIBRATED;难度 UNMEASURED。路线 C 原创,source `hwe/gi-dma-cache-flush-missing`;来源只提供发送前设备可见性方向,未复现真实事故。授权来自本批 BRIEF。独有 TX 服务工程,不复制原料参考解或其他新题业务骨架。
软件替身将 CPU cache 与设备 memory 分离,clean 显式按行发布,queue 仅留地址,complete 才读设备字节。保留 clean-before-submit 与完成回收知识;不验证实际 ARM cache 指令、DMA 总线、物理对齐、电气或真实时序。发送是单向;不凭空把接收 invalidate 当发送完成要求。
两处独立缺陷:初态 send 未发布 CPU 写入;初态完成回收最早挂起槽而非完成 id 的槽。后一缺陷只在公开并发与乱序完成场景暴露,默认 demo 不覆盖。only_fix_visibility 与 only_fix_release 分别只修一处。
公开行为以 template/docs/tx-contract.md 逐条合同与 tx.h 为依据;实现前冻结合同。精确行号矩阵与实际校准证据如下。
## 公开判据逐项依据
下表路径均相对任务目录;每项逐行 stdout 由 Python 独立状态与字节模型计算,C harness 仅执行公开调用并打印原始结果。表内行号都是确切行,不用笼统章节替代。所有场景一同运行,编译35秒、执行25秒、清理20秒,正式评分上限120秒。
| 判据行为 | 确切公开依据 | 输入覆盖与观察 |
| --- | --- | --- |
| C11工程、gcc构建、公开命令、正常EOF退出0 | template/docs/tx-contract.md:3;template/docs/tx-contract.md:15 | 重建tx_engine.c+port.c+main.c,进程退出码 |
| 全部tx API签名与结果结构 | template/docs/tx-contract.md:13;template/tx.h:70;template/tx.h:80 | 链接公开主程序,按声明传参 |
| 初始32、合法16/32/64复位、非法line不改状态 | template/docs/tx-contract.md:4;template/docs/tx-contract.md:15 | R16/32/64/0/17/-1,复位前后Q/P/D |
| 四槽、256容量、最低空闲槽分配 | template/docs/tx-contract.md:4;template/docs/tx-contract.md:6 | 四帧并存、第五帧BUSY、P回传slot |
| id范围1..65535、length范围1..256 | template/docs/tx-contract.md:6;template/docs/tx-contract.md:11 | 0/-1/65536、0/257、1/65535与最大长度 |
| 活跃id唯一、重复begin/full为BUSY | template/docs/tx-contract.md:6;template/docs/tx-contract.md:11 | 重复B及四槽压力后Q/P |
| 新draft覆盖清零、id及槽复用 | template/docs/tx-contract.md:6;template/docs/tx-contract.md:10 | 完成/取消后同id重建,部分写后S仍INCOMPLETE |
| W任意字节、F重复字节、合法范围 | template/docs/tx-contract.md:7;template/docs/tx-contract.md:14 | 运行时固定种子payload、大写hex、各种边界长度 |
| 多次部分写与重叠,最后写入为准 | template/docs/tx-contract.md:7;template/docs/tx-contract.md:16 | 分段W/F、最后单字节覆盖;D及C逐字节相等 |
| 写入范围非法不改变状态、INVALID优先 | template/docs/tx-contract.md:7;template/docs/tx-contract.md:11 | 负offset、256、跨frame尾、零长、跨容量,后续P/Q/D |
| F值0..255 | template/docs/tx-contract.md:14;template/docs/tx-contract.md:11 | -1、256及合法随机字节 |
| pending写/填/再次send/cancel均BUSY | template/docs/tx-contract.md:8;template/docs/tx-contract.md:11 | 已发帧上的W/F/S/X,后续字节与计数不变 |
| 有洞draft不可send,完整draft方可send | template/docs/tx-contract.md:8;template/docs/tx-contract.md:11 | 未写、半写、中间三字节覆盖后的S/P |
| send后的设备视图必须为最新payload | template/docs/tx-contract.md:5;template/docs/tx-contract.md:8;template/docs/tx-contract.md:17 | D直接观察device memory,拒绝只伪造completion |
| 设备视图和CPU视图分离、queue不复制payload | template/docs/tx-contract.md:5;template/tx.h:20 | 冻结port.c真实内存端口;harness直接读取描述符memory |
| 成功completion返回id、长度、完整最新字节 | template/docs/tx-contract.md:8;template/docs/tx-contract.md:9 | 所有边界帧C id 0逐字节检查 |
| 任意完成次序、释放对应id与槽 | template/docs/tx-contract.md:9;template/docs/tx-contract.md:16 | 四帧按3/1/0/2次序完成,每步观察所有P/D |
| 乱序完成不改变其他帧状态/覆盖/内容 | template/docs/tx-contract.md:9 | 每次完成后其他帧P/D、Q,随后其自身C |
| 失败completion返回id且无payload并释放 | template/docs/tx-contract.md:9;template/docs/tx-contract.md:12 | 固定随机0/1状态、失败后复用、长度0与'-' |
| 非法completion status为INVALID且不释放 | template/docs/tx-contract.md:9;template/docs/tx-contract.md:11 | -1/2之后D与最终正常C |
| draft completion为BUSY | template/docs/tx-contract.md:11 | 未发draft上C后P/Q |
| draft取消、pending拒绝取消 | template/docs/tx-contract.md:10;template/docs/tx-contract.md:11 | X后P,pending上X后D/C |
| 已完成/已取消或其他合法缺失id为ABSENT | template/docs/tx-contract.md:10;template/docs/tx-contract.md:11 | 重复C、缺失S/X/W/F/P/D |
| 所有错误无副作用 | template/docs/tx-contract.md:11 | 每个错误后Q/P/D,后续合法操作继续 |
| 成功begin/write/send/cancel逐次累计 | template/docs/tx-contract.md:7;template/docs/tx-contract.md:12 | 重叠写也计一次,错误不计,Q比较全部字段 |
| 成功/失败完成分别累计、bytes只计成功长度 | template/docs/tx-contract.md:12 | 混合完成状态、Q精确整数 |
| 活跃draft/pending计数、inspect覆盖个数 | template/docs/tx-contract.md:12 | Q/P在每个生命周期及错误分支后 |
| inspect错误输出零字段、completion错误id/length为0 | template/docs/tx-contract.md:12 | P错误五字段、C错误id0/length0,仅有效范围 |
| reset丢弃pending并清全部计数 | template/docs/tx-contract.md:10 | live pending上R,然后P/D/C/Q |
| 命令格式、参数个数、hex/decimal校验 | template/docs/tx-contract.md:14 | 奇数hex/zz/0x、参数少/多、越int、错误符号 |
| 空白、注释无输出,错误命令ERROR | template/docs/tx-contract.md:14 | 空行与两类注释;未知Z/BB;随后Q |
| 每种stdout记录布局、空payload '-' | template/docs/tx-contract.md:15;template/docs/tx-contract.md:17 | 所有6133行输出按协议逐行检查 |
| 诊断stderr允许,不是拒绝条件 | template/docs/tx-contract.md:15 | 仅存诊断,比较stdout与退出码 |
| D只读、draft/absent为ABSENT,invalid为INVALID | template/docs/tx-contract.md:17 | 每步D,后Q/P确认无副作用 |
| 不按源代码拼写/调用次数/unused尾部判分 | template/docs/tx-contract.md:12;template/docs/tx-contract.md:16 | 仅比较输出有效字段,valid位图+逐写发布实现通过 |
## 实现、样例与边界
工程只提交tx_engine.c;其余公开支撑逐字冻结进support.json。评分器不调用gold、不读候选输出文件、不把答案放进C进程,不在控制进程导入/执行候选。固定随机种子0xD4A15;6133条输出观测覆盖45组边界payload与54组并发压力,含连续复用与恢复。该数字是独立观测行数,不冒充独立根因数。数据总量与计数不溢出uint64_t。
| 样例 | 预期 | 机制 |
| --- | --- | --- |
| gold | PASS | 字节覆盖表,send整帧clean,完成按id回收 |
| template | FAIL | 未发布设备字节;乱序完成回收最早pending槽 |
| noop | FAIL | send直接成功而无queue/state转换 |
| cheat | FAIL | 发前把payload全覆为公开常见0xa5;运行时不同字节与重叠写拒绝 |
| cheat_read_grader | FAIL正式 | 仅能读grader才正常工作;正式UID65534不可读。可信本地预期意外PASS如实保留 |
| only_fix_visibility | FAIL | 仅修发布;乱序完成丢失其他帧、错误槽回收 |
| only_fix_release | FAIL | 仅修按id回收;设备仍读旧字节 |
| mask_symptom | FAIL | completion用CPU副本覆盖回报,但D直接设备观察仍旧 |
| valid_eager_bitmap | PASS | packed bitmap跟踪覆盖,每次成功写/填立即发布相交行,send不clean;与gold批量发布的时机及数据组织不同 |
每类仅含candidate_files并均成功构建。正常初始化0x5a用于确定性旧数据,不把填充尾部是否为零当条件。发送完成不要求接收方向invalidate;不测试没有公开规定的硬件性能或真实cache指令。
隔离由逐字复制的verify.py执行;首child前写完源码与所有输入,在仍属控制端的新建build子目录设权限,不chmod已交UID65534的scratch根。首次child启动后父check不再读写scratch;cleanup由候选身份rm执行并检查returncode,失败不能打印PASS。stderr不导致行为误拒。临时目录不复用,完整重建无额外依赖。
已完成只读自审:合同边界、独立模型、全部buildable fixture、只比较公开有效范围、首child后无父端树访问、cleanup返回码必查。独立root复审待做。全库unittest按本批BRIEF由root统一执行;本单题不重复执行。真实Agent采样/完整轨迹/硬件测试/Salty归档均未做。
## 实际双门证据
- 本地:`/home/ming01.wang/embedded-rollout/.tmp/wt-batch15/runs/20261023-C-hwe-scale-15/gi-dma-cache-flush-missing/local/calibration-4037e074dc854930a9a07284bf626202`,45次;原始整体FAIL、cleanup confirmed,仅cheat_read_grader五次PASS为合同允许例外;其他40次符合预期。
- Docker:`/home/ming01.wang/embedded-rollout/.tmp/wt-batch15/runs/20261023-C-hwe-scale-15/gi-dma-cache-flush-missing/docker/calibration-d01335aea9d445d399889d901257a962`,45次全部符合预期,整体PASS、cleanup confirmed。gold与valid各5次PASS,全部7类负例各5次FAIL。
- task digest:`a5c4f30a8192f0b927f92450a1de46ac8e12b0d6a78ddbc2fcfc362222052ede`;实际image ID:`sha256:1519f8daa403998e5401eeb70b973e8aac8346e25a937033bc502dc5de1641a1`。
- 工程严格去空行/注释/纯括号后520行,其中C及头文件510行,必要Makefile10行;样例副本、docs、输入数据、Python判据及support.json编码均不计。逐文件统计见本题subagent的engineering-lines.json。
- 当前仅CALIBRATED/UNMEASURED;root独立审阅与本批统一unittest尚待执行。未采样、不提交、不推送。
族名规范化:device-tx-lifecycle → device-io(2026-10-27)