100 tasks from the HWE arm-linux code-gen pool (outside the lk/man/pth range given to batch 22), each with at least one independent contract-edge defect and plain public docs. Claude reviewed 100/100 USABLE against current digests; no ID or source overlap with main or batch 22. Difficulty is unmeasured. progress.md records the wrap-up: all Codex sessions and Qwen schedulers stopped for the user's rollout, Qwen results so far (57 HARD of 373), and what is left on each batch branch. Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
21 KiB
任务规格:dev-bounded-byte-channel
身份与来源
- task-id/version:dev-bounded-byte-channel / 1;family:linux-device-abi;语言 C++17。
- 来源路线 C:原创素材改写,software-only;task.json.source=hwe/ldd3-scull-blocking-write-full。
- 原料为本批只读本地 HWE public/hard 基础条目 ldd3-scull-blocking-write-full;metadata.yaml:1/3/25,prompt.md:5/17,reference/ldd3-scull-blocking-write-full.c:22/37/41/55。
- 原始 source_url=https://lwn.net/Kernel/LDD3/;内核参考标记 GPL。新业务源码为独立编写的标准库模型,未复制内核源码。不执行原脚本/判据。
- 原创合同包括请求票据、完整长度的阻塞聚合、tick 中断预算、稳定化顺序、结果保留和二进制 observer。原料只证明双向等待/非阻塞/中断方向,不能证明这些新增细节或现场历史。
- split 分组键/来源组:hwe/ldd3-scull-blocking-write-full;根因族:bounded-byte-pipe-wakeup-and-zero-transfer。作者为本 source 独立子 Agent;独立根审待完成。
- 原料 public 授权范围和本批 source 去重由根分派确认;无用户数据或凭据。
- 软件替身:移除板卡、insmod、真实信号和调度,用顺序 API 与显式 tick 保留容量、等待、前缀、中断路径。没有硬件、实时调度或内核 ABI 的通过声明。
- 审核状态:CALIBRATED(待根独审);难度 UNMEASURED;未采样 Qwen、真实 Agent 或硬件。
初态、环境和交付
- 公开完整工作区含六个业务 candidate_files、完整文档、Makefile、stdin raw observer、原始数据显示工具和唯一正长度 stall.bin。
- candidate_files:include/bounded_channel.hpp、src/channel_internal.hpp、src/channel.cpp、src/transfer.cpp、src/waiters.cpp、src/observe.cpp;新增文件不收集。每个非 template fixture 仅含六文件。
- 私有文件只有 check.py 与 raw_observer.cpp;verify.py 原样复制 rollout/bos_verify.py;无 isolation-blocked.txt。
- C/Python trace6 runtime,普通 Linux 用户态,c++ -std=c++17 -O2,标准库;不强制 -Werror,构建/运行均 argv,无 shell 或联网安装。
- 正式镜像固定 ccr-29eug8s3-pub.cnc.bj.baidubce.com/algo/bench-runtime@sha256:1519f8daa403998e5401eeb70b973e8aac8346e25a937033bc502dc5de1641a1;实际 image_id 以正式 calibration receipt 为证。
- grader timeout_seconds=120,内部 compiler 30 秒、每个 stdin 脚本 5 秒,wrapper 原有 check 100 秒总限;grade 512MiB/1CPU。来源 HWE 的 600 秒不是当前执行合同。
- 公开命令:make && ./channel-observe < examples/stall.bin | python3 tools/dump.py。仅显示现场 4/6 停滞;无零字节/预算到期 smoke。
- 构造、八个公开 API、全部参数/返回值/字段/优先级/原子性/调度和 binary bytes/空 stderr 规则都在 template/docs/channel-contract.md。
- 六业务文件有效非空非注释行共530;工程独有业务行530(不计fixture复制、observer、文档、Makefile、注释、空行);逐文件真实统计见单题factory/prebuild-structure.json。
缺陷和合法替代实现
F1:src/transfer.cpp 的 extract 在正数读取后向 Read 发布可用性,src/waiters.cpp 的 notify 按方向只更新对应等待队列,遗漏因空间释放变为可推进的 writer。写入唤醒 reader 的方向保留正确。症状由公开 tools/dump.py 显示,需跨模块追踪。
W1:capacity4,Blocking write ABCDEF先写ABCD后Pending4/6,Nonblocking read2取AB。正确状态在read返回前是writer Complete6/6、FIFO CDEF;初态仍Pending4/6、FIFO CD。全部正长度且无中断到期。
F2:src/channel.cpp 在 length==0 判断之前走 available==0 的非阻塞/预算/等待路径;empty read0/full write0会被错误地Again、Interrupted或Pending。精确边界类型为“零工作量的无副作用早返回”,根指定,smoke不展示。合法零长度必须Complete0、wait_ticks0、预算不变、字节游标不变且不唤醒既有请求。原子管理校验仍先于早返回。
W2a empty Blocking read0 budget0;W2b满capacity1后Blocking write0 budget1再tick,不含释放空间的read,独立于F1。fix_space_wakeup仅修F1仍失败W2;fix_zero_transfer仅修F2仍失败W1。四格必须真实编译/运行核对。
Gold 权威状态为固定物理环形数组、独立游标和used、显式请求槽、双等待队列与Data/Space通知集合。valid_scan 权威状态是逻辑deque FIFO和按提交序记录的map;每次变更全表重选最早可推进请求直至不动点,不保留gold通知/就绪候选/等待队列,不仅是容器替换。二者使用同一公开行为判据。
判据、隔离和输出
Python check使用bytearray FIFO及按插入顺序请求记录独立模型,固定seed0xBBC118,不执行/导入candidate/gold,不用参考输出生成期望。8个stdin脚本涵盖空命令、两独立见证、域与原子性、前缀/排序/生命周期、65535/65536实际等待计数、7726条固定随机组合命令,以及131072命令/16MiB载荷的合法输入最大值。
raw observer只解码stdin、调用API并编码原始结果;无测试生成、断言、期待值或判错逻辑。候选在subprocess中与observer共同编译,正式由原wrapper降UID/GID65534。所有方法均直接调用和观察,snapshot不替代其它API。
首次compiler前读取所有候选/观察器、生成全部stdin与Python期望,在tempfile.mkdtemp(dir=Path.cwd())建立wrapper独占scratch并写好全部源码。首次compiler后checker只有argv subprocess和内存比较,无scratch open/read/write/stat/glob/cleanup;wrapper退出回收整树。无全局/tmp scratch遗留。
每次运行分开检查真实exit0、stderr==b''、stdout==完整expected bytes,绝不text=True、decode/strip后比较或只检查可解析前缀。stderr-only与stdout尾LF负例单列;编译warning不是库运行stderr。输出诊断仅进受保护grade.stderr。
PASS须全部必需脚本通过;FAIL来自实际行为差异、非0退出或挂死。平台缺环境应由环境预检和wrapper记录UNVERIFIED/INFRA_ERROR,不以未执行项通过。host仅可信fixture;Docker判据拒读须真实验证。本题不调用模型、凭据、外部服务或硬件。
固定样例与预期
| fixture | 预期 | 行为证据 |
|---|---|---|
| gold | PASS | 完整环形/通知实现 |
| template | FAIL | W1与W2 |
| fix_space_wakeup | FAIL | W1通过、W2失败 |
| fix_zero_transfer | FAIL | W2通过、W1失败 |
| noop | FAIL | 全API定义、核心advance不传送字节 |
| cheat | FAIL | 仅ABCDEF公开载荷保持,其他写载荷归零,动态binary拒绝 |
| mask_symptom | FAIL | 读后伪报writer完成,实际FIFO和游标仍错 |
| valid_scan | PASS | 逻辑FIFO+全表归约 |
| cheat_stderr | FAIL | 正确字节/exit0,仅stderr单字节X |
| cheat_stdout_tail | FAIL | 正确行为/exit0,仅析构stdout多LF |
| cheat_read_grader | Docker FAIL | 探读/grader/check.py和父check cwd/grader/check.py;拒读主动exit23单列;host可读PASS保留例外 |
其它固定负例必须真实完整build0/run0,再按行为拒绝,不能靠缺符号、编译或意外退出。每类最终各5次,11类=55次/门。
公开检查项对应依据
每个公开 API 的直接观察
| 方法 | 直接行为观察,不得由 snapshot 代替 | 公开依据 |
|---|---|---|
| ByteChannel 构造 | 无 reset 的第一条 snapshot:capacity=1、全空和全计数 0;空命令脚本退出/输出契约 | template/docs/channel-contract.md:51、65、123、133 |
| ~ByteChannel 析构 | 有 Pending/终止请求和空实例自然离开作用域,进程 exit0;最终完整 stdout 无额外字节且 stderr 空 | template/docs/channel-contract.md:52、65、123、133 |
| reset | 直接记录 Ok/Invalid/Busy;再查询旧 ID、真实传送及快照,证明清空/失败原子性 | template/docs/channel-contract.md:53、116、117 |
| submit_write | 直接记录管理返回码;显式 result 查询该 ID 的 state/requested/transferred/预算;后续实际 read 验证字节 | template/docs/channel-contract.md:54、75、77、87、94 |
| submit_read | 直接记录管理返回码;显式 result 读取每个字段和二进制 bytes;再由写请求观察空间释放 | template/docs/channel-contract.md:56、75、77、86、94、98 |
| tick | 直接记录 Ok;每个预算边界前后显式 result;无 pending 时也检查 tick_count 增长 | template/docs/channel-contract.md:57、104、105、106、107 |
| interrupt | 直接记录 Ok/Invalid/NotFound/AlreadyDone;分别 result 观察零前缀/正前缀及保持预算 | template/docs/channel-contract.md:58、78、108、109 |
| result | 独立 opcode 6 查询每种状态和错误 ID,完整编码所有字段及 nullopt;重复查询验证无副作用 | template/docs/channel-contract.md:59、78、79、114、130 |
| forget | 直接记录 Ok/Invalid/NotFound/Busy;再次 result 和 ID 重用,观测释放/拒绝及数据不回滚 | template/docs/channel-contract.md:60、78、115 |
| snapshot | 独立 opcode 8 比较所有计数、字节 FIFO、游标;不拿它替代 result/submit 等 API 的直接调用 | template/docs/channel-contract.md:61、79、118、119、131 |
参数、传送、等待、协议和生命周期的检查项
| 检查 ID | 场景与域端点 | 必须直接观察的结果/性质 | 公开依据 |
|---|---|---|---|
| C01 | 构造后未 reset;空命令;销毁仍 Pending 的实例 | 默认 capacity=1 和空状态;构造/析构静默;合法脚本 exit0 | template/docs/channel-contract.md:65、123、133 |
| C02 | capacity=0,1,256,257,UINT32_MAX;有/无 Pending | reset 返回码;Invalid 优先于 Busy;合法端点可实际填满、读空 | template/docs/channel-contract.md:70、116、117 |
| C03 | ID=0,1,65535,65536,UINT32_MAX,逐个作用于 submit_read/write/result/interrupt/forget | 每个相关 API 的合法端点、Invalid、NotFound;不能只测 submit | template/docs/channel-contract.md:71、75、78 |
| C04 | read/write length=0,1,4096,4097;read count=UINT32_MAX | 0/1/4096 可成功管理;超域 Invalid 原子;4096 字节通过真实交替传送收回 | template/docs/channel-contract.md:72、75、76、89 |
| C05 | 两种有效 Mode;static_cast(2/UINT32_MAX);读/写、零/正长度 | 有效模式各自语义;无效模式 Invalid 且没有保留结果 | template/docs/channel-contract.md:73、74、75、76 |
| C06 | budget=0,1,65535,65536,UINT32_MAX-1,UINT32_MAX;阻塞/非阻塞、零长度、读/写 | 有效端点保留原预算并按条款推进;非法区间 Invalid,不能因模式/长度忽略校验 | template/docs/channel-contract.md:74、75、83、95、106 |
| C07 | retained=63/64,含全Pending和混合终态;第 65 个唯一 ID;满槽时重复 ID;重复 ID 同时非法 mode/budget/length | 64 接受、第 65 个 Limit;Duplicate 优先于 Limit;Invalid 优先于 Duplicate;无附带传送/预算变化 | template/docs/channel-contract.md:11、75、76、85 |
| C08 | 管理错误前后重复 result/snapshot,已有数据和正前缀 Pending | 所有字段、原 FIFO、游标、tick、预算和次序不变;错误 ID 不被创建 | template/docs/channel-contract.md:76、78、79 |
| C09 | submit 成功但空 NB read、满 NB write、零预算阻塞无法推进 | 管理码均 Ok;分别用 result 看到 Again/Interrupted,不能把管理成功当传送成功 | template/docs/channel-contract.md:77、86、87、95、109 |
| C10 | W2a:empty Blocking read(0,budget=0/1/no_interrupt);empty NB read(0) | Complete(0),空 bytes,wait_ticks=0,budget 原值;随后 tick 不改变此结果 | template/docs/channel-contract.md:83、84、106 |
| C11 | W2b:capacity=1/256 填满后 Blocking/NB write(empty,budget=0/1/no_interrupt) | Complete(0),无等待/预算消耗;原 FIFO 和两个字节游标保持 | template/docs/channel-contract.md:83、84、90 |
| C12 | 同方向已有 Pending 时提交零请求;另有请求 budget=1,零请求前后显式 result | 仅 retained+1;零请求不消费已有预算、不改变等待请求进度;首次真实 tick 才到期 | template/docs/channel-contract.md:83、84、106 |
| C13 | 零长度但无效 ID/mode/budget、重复 ID 或槽满 | 参数优先;Zero 不绕过任何管理错误 | template/docs/channel-contract.md:74、75、85 |
| C14 | NB read:empty、1 字节、请求=used-1/used/used+1;后有 Pending writer | Again 或 Complete 的实际前缀;不 Pending、不计预算;读取后真实 writer 继续 | template/docs/channel-contract.md:86、88、98 |
| C15 | NB write:full、空间=1、请求=space-1/space/space+1;后有 Pending reader | Again 或 Complete 实际前缀;只做当前一次传送,再推进对端;预算原值 | template/docs/channel-contract.md:87、88、98 |
| C16 | payload 包含 0..255 全部字节、重复 LF/CR/NUL/ff;长度 1/255/256/257/4096;capacity=1/3/255/256 | result.bytes 和后续读回逐字节相等;不按文本截断、不丢环绕字节 | template/docs/channel-contract.md:10、14、89、90 |
| C17 | 多轮读写后物理位置跨 capacity,多次短读/短写/前缀中断 | read/write cursor 各只加真实字节;差值=used;FIFO 全顺序一致 | template/docs/channel-contract.md:89、90、99、118 |
| C18 | 阻塞 read 超过当前数据,阻塞 write 超过当前空间;以多个相反操作补齐 | Pending 的正前缀字段;最终精确 requested Complete;read 所得前缀持续保存 | template/docs/channel-contract.md:12、94、110、114 |
| C19 | budget=0:empty read/full write;有数据/空间但不足长度的读和写;已有对端Pending也不能越过首次等待 | 不先等待;无前缀 Interrupted、有前缀 Complete(actual),wait_ticks=0、预算 0;先终止再让对端调度 | template/docs/channel-contract.md:95、109、110 |
| C20 | W1 正长度公开复现,容量=4、write ABCDEF、read2;扩展容量1/7/256和不同释放量 | read 返回前待写者实际补写,不用 tick;writer result Complete6、FIFO CDEF、真实后续 read 验字节 | template/docs/channel-contract.md:96、98、139、140 |
| C21 | 空通道 Pending reader,非阻塞及阻塞 writer 提供数据;容量1交替4096字节 | writer 返回前 reader 获得推进;所有前缀相加一致,稳定化终止 | template/docs/channel-contract.md:94、96、98、99 |
| C22 | reader IDs 65000、1 按该顺序等待,后提供 ABCD;writer 同类反向 ID/槽复用场景;读写混合就绪 | 结果字节分配服从提交序号,不能按数值 ID、方向或槽编号 | template/docs/channel-contract.md:96、97 |
| C23 | 已提交 Pending write 后覆写/销毁调用者 vector;result/snapshot 返回 vector 被 observer 覆写后再查询 | 后续 read 仍为原始 payload,原结果和快照仍正确;无别名污染 | template/docs/channel-contract.md:100、132 |
| C24 | 无 Pending 的 tick;有 Pending 的 tick 前/后查询 | 直接 Ok;每次 tick_count+1;观察和普通等待不自动花预算 | template/docs/channel-contract.md:13、79、104、107 |
| C25 | 等待预算1/2/65535:第 N-1 与第 N 次 tick 前后;同时有有限/无限请求 | 计数仅对仍 Pending;第 N 次恰好到期;max budget=65535 实际运行65535次,不降成小值代测 | template/docs/channel-contract.md:105、106、107 |
| C26 | kNoInterrupt 请求累计65536次 tick;已完成/零请求参与相同脚本 | no_interrupt 不减少、不到期;wait_ticks 精确65536;终止/零结果始终不变 | template/docs/channel-contract.md:106、107、114 |
| C27 | tick 伪唤醒及“先稳定化、再扣仍等待者预算”顺序;多个同 tick 到期请求 | 同一状态机规则;完成者不额外计等待,次序按提交顺序;到期后再稳定化 | template/docs/channel-contract.md:105、106、107 |
| C28 | 显式 interrupt 零/正前缀 read 和 write;每种终态再次 interrupt;合法未知/非法 ID | Ok/AlreadyDone/NotFound/Invalid 均直接观察;不花预算、不加wait_ticks;前缀与 FIFO 不回滚 | template/docs/channel-contract.md:78、108、109 |
| C29 | read 前缀 ABC 后中断;write 前缀 ABCD 后中断;无前缀等待中断 | Complete(actual) vs Interrupted(0);requested 原值;read.bytes=实际前缀、write.bytes为空 | template/docs/channel-contract.md:89、99、109、110 |
| C30 | 查询 Pending(0/正前缀)、Complete(0/短/全)、Again、Interrupted;查询前后插多次其他观察 | result 所有字段和枚举精确;Complete 之后预算/bytes不再变化;不隐式推进 | template/docs/channel-contract.md:21、24、25、26、29、79、110、114 |
| C31 | forget Pending、四类终止结果、非法/合法未知 ID、重复 forget;释放槽后复用同 ID | Busy/Ok/Invalid/NotFound 直接观察;真实释放64槽;复用是新次序;数据/游标不回滚 | template/docs/channel-contract.md:78、97、115 |
| C32 | reset invalid+Pending;合法+Pending;含数据/终止结果时成功reset;相同容量重复reset | Invalid 优先 Busy,失败所有状态不变;成功清除所有结果/数据/游标/tick并设置容量 | template/docs/channel-contract.md:116、117 |
| C33 | 空/满/部分 FIFO;多个等待reader或writer;正前缀Pending和多种终止结果 | snapshot每个字段直接观察;retained含所有状态,pending只计Pending;bytes.size=used | template/docs/channel-contract.md:44、45、46、47、118、119 |
| C34 | 空脚本、131072命令、16MiB载荷、各 opcode、管理错误输入、结果 bytes 中 LF/CR/NUL/ff;所有字段值非零组合 | 完整二进制字节比对 little-endian 和可变载荷;不得只解析前缀或忽略尾部 | template/docs/channel-contract.md:125、126、127、128、129、130、131、133 |
| C35 | gold+单字节 stderr 的 cheat_stderr | build0/run0,stdout完整等于期望;独立拒绝原因为 stderr_nonempty,记录字节数 | template/docs/channel-contract.md:123、133 |
| C36 | gold+析构 stdout LF 的 cheat_stdout_tail;动态载荷中的合法LF | build0/run0,stderr空;多余LF确切拒绝,合法载荷LF保持 | template/docs/channel-contract.md:123、125、133 |
| C37 | 正常调用与所有管理错误、构造/析构均检查进程 | exit0、stderr空、stdout精确;库不能用异常/诊断代替管理码 | template/docs/channel-contract.md:65、66、123、133 |
| C38 | 固定seed随机合法场景和错误参数交错,容量1/2/7/255/256;多ID、多前缀、重置/释放/中断 | Python独立模型逐条完整比较,检查正常路径和异常后恢复;不新增合同外规则 | template/docs/channel-contract.md:5、70、71、72、73、74、96、99、114、115、116、117 |
工程与证据条款的核对方式
| 事项 | 对应核对,核对方式 | 公开依据 |
|---|---|---|
| C++17、仅标准库、软件题 | 正式固定 runtime 的干净离线编译/运行;源码依赖只读审阅;不把缺硬件记成功 | template/docs/channel-contract.md:4、9、137 |
| 公共 observer 无期待/断言/造例 | 根只读审阅 raw_observer.cpp;stdin脚本由Python先生成,harness仅调用/编码 | template/docs/channel-contract.md:124、127、129、130、131 |
| 现场题面无定位提示 | 只描述停在4/6、命令、交付文件;根审 prompt-draft,不点名故障函数/类别 | template/docs/channel-contract.md:138、139、140;prompt.md:1 |
| 全部条款明确且合法替代解可过 | 把本矩阵重映射到最终公开行;valid_scan与gold同跑C01..C38;不检查私有内部数据结构 | template/docs/channel-contract.md:5、142 |
| 只收集声明文件 | task.json与prompt/README六路径对齐;所有fixture仅含六路径;core.load_task | template/docs/channel-contract.md:141 |
| 正式重新构建 | checker不复用工作区产物,argv显式四cpp和observer;源码和输入在compiler前准备 | template/docs/channel-contract.md:137 |
| smoke不展示精确边界 | stall.bin仅七个正长度命令;零长度、budget=0或预算到期只在文档和正式组合测试 | template/docs/channel-contract.md:138、139 |
行为矩阵共 38 项,API 直接观察共 10 项,工程核对共 7 项。执行结果和局限见本规格末尾与单题 factory report;不代表真实 Agent 或硬件证据。
执行证据与限制
预检及当前身份双门已完成;最终真实结果、输出路径、退出码、当前digest和逐类build/run原因见单题factory/report.json及report.md。无真实Agent/硬件证据。全仓unittest由根统一执行,本作者不运行。
只在Docker每类5次符合预期、整体PASS且cleanup confirmed并匹配当前task_digest后标为CALIBRATED;独立根审和真实采样未完成,不能标ADMITTED。已知wrapper的host模式不隔离,因此读grader样例可能PASS并使host整体FAIL,这是保留原事实的允许例外。
最终当前身份:68acf07a27294ddb87c23bd7f17a1f25ac1fdc748f2adf7e238d50b07e2b456d;Docker55/55符合预期、PASS/exit0/cleanup confirmed;host50符合预期+5读grader允许例外,FAIL/exit1原样保留。证据:runs/20261026-C-hwe-codegen-18/ldd3-scull-blocking-write-full/gates-20261027T001733Z-11958dde/docker/calibration-18959ab1af7c467f8847a81dacddedc2/receipt.json;本地:runs/20261026-C-hwe-codegen-18/ldd3-scull-blocking-write-full/gates-20261027T001733Z-11958dde/local/calibration-ab5a1b2018c94504923854463ce06592/receipt.json。逐次build0/run0与拒绝原因见factory单题final-fixture-evidence.json。未执行真实Agent/Qwen/硬件或全仓测试。