amos 2f32624d3b Batch 18 (20261026-C-hwe-codegen-18): add 100 calibrated HWE code-gen tasks; pause production for rollout
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>
2026-10-27 17:52:13 +08:00

5.7 KiB
Raw Blame History

Worker partial fold 合同

  1. 工程是 C++17 Linux 用户态的确定性管道与 worker 调度模型。调用者显式安排每个操作,不要求创建线程、读取真实时钟或访问硬件。所有 Pool 对象相互独立;同一个 worker 编号可以同时用于不同对象。

  2. pool.hpp 中的 fold::Pool 默认有 1 个 worker、256 字节容量、空队列和空 worker、未关闭的写端。configure(workers, capacity) 接受 workers 为 1 到 8、capacity 为 4 到 256,成功时替换整个对象为该配置的初始状态,包括清除关闭状态、累计接收字节和已提交总量。所有 API 数字参数类型均为 std::int64_t。

  3. 状态码 OK=0、RANGE=1、STATE=2、FULL=3、BUSY=4、TAIL=5、LIMIT=6、SYNTAX=7。每个返回非零码的 Pool 操作保持对象的所有字段不变。worker(index, output) 返回非零时也保持 output 的原值。

  4. write(value, count) 接受 value 为 -2147483648 到 2147483647、count 为 0 到 64,依次向队列追加 count 份 value 的四字节小端二进制补码。byte(value) 接受 0 到 255,向队列追加一个字节。write 先检查 value 和 count,byte 先检查 value;参数合法后,写端已关闭返回 STATE,再检查队列空余容量,不足返回 FULL,再检查本配置期间累计接收字节是否会超过 262144,超过返回 LIMIT,最后追加全部字节。write 的 count 为 0 也按这个顺序检查,成功时不改变状态。消费队列不会减少累计接收字节。

  5. take(worker, budget) 接受当前对象的 worker 编号 0 到 workers-1、budget 为 0 到 256。先检查全部参数,然后已结束的目标返回 STATE,然后其他 worker 持有未完成记录时返回 BUSY。成功时最多消费 budget 个队首字节,队列不足则消费全部现存字节;Step 返回 code、本次消费 bytes 和本次完成 records。一次操作可以完成多条记录。worker 将不足四字节的记录前缀留在 carry 中供后续操作继续读取,持有该前缀的 worker 独占下一次记录续读;凑满四字节后把有符号 int32 值加入自己的 sum 并增加 count,清空 carry 并释放所有权。未消费字节、预算为 0 和空队列均返回成功及对应的零计数。其他 worker 即使预算为 0,仍按上述顺序检查。

  6. close() 关闭写端,重复调用成功且状态不再变化;关闭后仍可消费队列。finish(worker) 先检查编号;目标已结束时成功且不改变状态;否则写端未关闭或队列非空返回 STATE;否则该 worker 的 carry 非空返回 TAIL;否则先将该 worker 的全部本地 sum/count 加入总量,再将它标记为结束并增加 done。每个 worker 的本地 sum/count 在结束后保留可读值。一个 worker 的 carry 不妨碍其他 worker 在队列为空时结束。全部 worker 结束后的总量包含每个 worker 的贡献一次。

  7. totals() 返回已结束 worker 的 sum/count、已结束 worker 数 done、关闭标志 closed、队列剩余字节数 queued、carry 持有者 owner;无持有者时 owner=-1。worker(index, output) 对合法编号返回 OK 并输出本地 sum/count、结束标志 done 和按接收顺序排列的 carry 字节;域外编号返回 RANGE。snapshot() 返回 workers、capacity、累计接收字节 accepted、totals 的全部字段、按消费顺序排列的剩余 queue 以及按编号排列的全部 WorkerView。所有读方法不改变状态,bool 标志用 0 或 1 表示。

  8. protocol.hpp 中 run_session(input, output, error) 每次调用都创建新的默认 Pool 和新的行计数;main 将标准流交给这个入口并返回它的返回码。会话只从 input 读取,只向 output 输出,每次调用返回 0,error 保持为空。空输入不输出内容。每个由 LF 结束的行以及最后一个没有 LF 的非空片段各算一行。每次调用前 4096 行参与解析,后续每行输出 R 6 且不执行命令。每行 LF 之前最多 512 字节,超出时该行输出 R 7 并继续下一行。行数限制先于行内容解析。

  9. 命令词区分大小写,token 用一个或多个 ASCII 空格或 tab 分隔,允许行首行尾空格或 tab。整数 token 仅由可选的单个负号和至少一个十进制数字组成,允许前导零,值须可由 int64 表示;加号、小数、CR、NUL、其他非打印字符和非 ASCII 字节均不合语法。空白行、未知命令、参数数量不符或整数语法不符输出 R 7 且保持 Pool 不变。语法正确而数值超出 API 范围时返回 API 的码。

  10. 动词及参数为 RESET workers capacity、WRITE value count、BYTE value、TAKE worker budget、CLOSE、FINISH worker、TOTAL、WORKER worker、SNAP。RESET 对应 configure,其余按同名 API 执行。RESET、WRITE、BYTE、CLOSE、FINISH 输出 R code;TAKE 输出 T code bytes records;TOTAL 输出 G sum count done closed queued owner;WORKER 失败输出 W code,成功输出 W 0 sum count done carry_size 后按次序追加每个 carry 字节。

  11. SNAP 输出 S workers capacity accepted | sum count done closed queued owner | queue_size 后按次序追加每个 queue 字节,然后按 worker 编号对每个 worker 追加 | sum count done carry_size 和各 carry 字节。每个相邻数字之间有一个 ASCII 空格,分组之间为一个空格、竖线和一个空格。每个响应末尾有一个 LF,没有其他字节。所有标准运行均要求 stderr 为空和退出码为 0,stdout 按字节比较。

  12. 只交付 README 列出的五个 candidate 文件;新建文件不会参与评分。构建必须在离线标准 C++17 环境完成,不能读取评分器、参考解或外部控制数据来决定行为。