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>
5.7 KiB
Worker partial fold 合同
-
工程是 C++17 Linux 用户态的确定性管道与 worker 调度模型。调用者显式安排每个操作,不要求创建线程、读取真实时钟或访问硬件。所有 Pool 对象相互独立;同一个 worker 编号可以同时用于不同对象。
-
pool.hpp中的fold::Pool默认有 1 个 worker、256 字节容量、空队列和空 worker、未关闭的写端。configure(workers, capacity)接受 workers 为 1 到 8、capacity 为 4 到 256,成功时替换整个对象为该配置的初始状态,包括清除关闭状态、累计接收字节和已提交总量。所有 API 数字参数类型均为std::int64_t。 -
状态码 OK=0、RANGE=1、STATE=2、FULL=3、BUSY=4、TAIL=5、LIMIT=6、SYNTAX=7。每个返回非零码的 Pool 操作保持对象的所有字段不变。
worker(index, output)返回非零时也保持 output 的原值。 -
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 也按这个顺序检查,成功时不改变状态。消费队列不会减少累计接收字节。 -
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,仍按上述顺序检查。 -
close()关闭写端,重复调用成功且状态不再变化;关闭后仍可消费队列。finish(worker)先检查编号;目标已结束时成功且不改变状态;否则写端未关闭或队列非空返回 STATE;否则该 worker 的 carry 非空返回 TAIL;否则先将该 worker 的全部本地 sum/count 加入总量,再将它标记为结束并增加 done。每个 worker 的本地 sum/count 在结束后保留可读值。一个 worker 的 carry 不妨碍其他 worker 在队列为空时结束。全部 worker 结束后的总量包含每个 worker 的贡献一次。 -
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 表示。 -
protocol.hpp中run_session(input, output, error)每次调用都创建新的默认 Pool 和新的行计数;main 将标准流交给这个入口并返回它的返回码。会话只从 input 读取,只向 output 输出,每次调用返回 0,error 保持为空。空输入不输出内容。每个由 LF 结束的行以及最后一个没有 LF 的非空片段各算一行。每次调用前 4096 行参与解析,后续每行输出R 6且不执行命令。每行 LF 之前最多 512 字节,超出时该行输出R 7并继续下一行。行数限制先于行内容解析。 -
命令词区分大小写,token 用一个或多个 ASCII 空格或 tab 分隔,允许行首行尾空格或 tab。整数 token 仅由可选的单个负号和至少一个十进制数字组成,允许前导零,值须可由 int64 表示;加号、小数、CR、NUL、其他非打印字符和非 ASCII 字节均不合语法。空白行、未知命令、参数数量不符或整数语法不符输出
R 7且保持 Pool 不变。语法正确而数值超出 API 范围时返回 API 的码。 -
动词及参数为
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 字节。 -
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 按字节比较。 -
只交付 README 列出的五个 candidate 文件;新建文件不会参与评分。构建必须在离线标准 C++17 环境完成,不能读取评分器、参考解或外部控制数据来决定行为。