amos 73a5240295 Batches 21 and 18: add 74 calibrated tasks (40 Bos redo, 34 HWE code-gen)
Batch 21 (20261027-A-bos-redo-21) rebuilt 40 of the 53 rejected Bos-qiao
environments: hidden assertions that ran inside the candidate's process
now run in a trusted parent that reads observations from a low-UID
worker; gold bytes are unchanged. 9 were excluded for scope (ROS2,
oversize, security core), 3 are blocked because the source requires an
exec bit the platform does not freeze, 1 lacks requests/bs4 in trace6.

Batch 18 (20261026-C-hwe-codegen-18) adds its last 34 of 134 tasks; the
first 100 landed in 2f32624d.

Claude reviewed 74/74 USABLE against current digests, canonical
families, no ID or source overlap with main, plain public docs. Only the
new task directories are taken; the stale pre-batch-20 copies of
concur-release-capsule and resource-temp-link on the batch 21 branch and
both branches' progress notes stay as main has them. Difficulty is
unmeasured.

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
2026-11-02 10:23:12 +08:00

6.5 KiB
Raw Permalink Blame History

调试命令与会话合同

R01. 本工程是确定性的 Linux 用户态软件模型。命令计划只是一串文本,不执行 debugger、程序、远端连接或文件操作。实现须满足本文全部条款;可改变内部数据结构,不改变 journal.hpp 中的公开类型、方法签名、字段及枚举数值。

R02. 公开入口为 Journal 的 create、erase、set_point、enable、start、finish、append、reset、status、point、log、script、list_ids,以及 run_cli。Int 是有符号64位整数。不同 Journal 对象互不影响,可同时使用相同id。新对象没有会话;所有查询不修改对象。

R03. Code 数值为 OK=0、RANGE=1、EXISTS=2、MISSING=3、BUSY=4、STATE=5。所有方法先检查自己的全部参数范围,再检查会话是否存在,再检查下文列出的运行状态与断点条件。返回非OK不改变任何会话、断点、日志或计数。

R04. id 范围0..15;mode范围0..2,分别表示本地、远端、core;retries范围0..4;capacity范围0..64;slot范围0..7;address范围0..65535;enabled范围0..1。每个会话最多具有8个断点;同一地址可以出现在不同slot。

R05. create(id,mode,retries,capacity) 创建会话,id已存在返回EXISTS。初态attempts=0、state=0、outcome=-1、debugger=-1、kind=-1、value=-1、collector=-1、total=0,日志与断点为空。配置在会话生存期间不变。

R06. state=0表示待运行,1表示运行中,2表示可重试,3表示已完成。erase(id) 在运行中返回BUSY,其余状态删除整个会话;再次创建同id使用新初态。对范围内不存在的id,各接收id的方法返回MISSING。

R07. set_point(id,slot,address) 在运行中返回BUSY,其余状态下若slot存在则返回EXISTS,否则新增enabled=1的断点。enable(id,slot,enabled) 在运行中返回BUSY,其余状态下若slot不存在则返回MISSING,否则设置enabled;重复设置同值成功。

R08. start(id) 在运行中返回BUSY,已完成返回STATE,其余状态将state设为1,attempts加1,并将outcome、debugger、kind、value、collector都设为-1。断点、配置、日志和total保留。

R09. finish(id,debugger,kind,value,collector) 中debugger和collector范围0..255;kind范围0..2。kind=0时value范围0..255,表示被调试程序退出码;kind=1或2时value范围1..31,分别表示停止信号或崩溃信号。运行中才可finish,其他状态返回STATE。

R10. finish保存传入的debugger、kind、value、collector。debugger非0时outcome=1;否则kind=0且value非0时outcome=2;否则kind=1时outcome=3;否则kind=2时outcome=4;否则collector非0时outcome=5;其余outcome=0。outcome为0时会话完成;outcome非0且attempts小于等于retries时state=2;其余state=3。

R11. append(id,bytes) 接收长度0..64的任意字节字符串;超出返回RANGE。运行中才可append,其他状态返回STATE。成功后total增加输入长度,日志保留迄今拼接内容的最后capacity字节;capacity=0时日志为空,total仍增长。长度0不改变内容与total。

R12. reset(id) 在运行中返回BUSY,其余状态恢复R05中的运行字段、日志和total,保留配置与全部断点。

R13. status(id) 返回Status的全部字段,含code、id、mode、retries、capacity、attempts、state、outcome、debugger、kind、value、collector、total、points、enabled;最后两个字段分别为断点数与已启用断点数。失败时code为相应错误,其余14个字段全为-1。

R14. point(id,slot) 返回PointResult:code及point中的slot、address、enabled。范围内slot不存在返回MISSING。失败时point全部字段为-1。log(id) 返回LogResult:code、total、bytes;失败时total=0、bytes为空。script(id) 返回ScriptResult:code、text;失败时text为空。list_ids() 返回现有id的递增序列。

R15. script依次拼接LF结尾的行:set pagination off、set logging overwrite on、set logging enabled on、file program。capacity=0时第三行改为set logging enabled off。mode=1在file行后加target remote board:1234,mode=2加core-file core。随后按slot递增为已启用断点添加break *ADDRESS,ADDRESS为十进制地址。随后mode=0添加run,mode=1添加continue,mode=2不添加运行行。末尾依次为thread apply all bt full、info registers、quit。没有空行、额外空格或其他行。

R16. run_cli(input,output,diagnostic) 每次调用使用新的空Journal,返回0且不向diagnostic写字节;同一进程可多次调用。调用者已有的output整数进制、宽度、填充字符等格式设置不改变输出字节。app.cpp入口只调用run_cli并返回其结果;程序不写stderr。

R17. 输入以LF分割物理行;末尾无LF的非空片段也是一行,空输入没有行。最多执行4096行,空行与出错行也占行数;若存在第4097行,输出一行LIMIT并停止分派。第4096行照常执行。未承诺停止后消费剩余输入的方式。

R18. 一行以ASCII空格或tab分词,允许首尾和连续空白。动词大小写敏感。整数词由可选的负号及一位以上十进制数字组成,值须可表示为Int;输入允许前导零和负零。不接受加号、CR、指数、小数或溢出。空行、未知动词、参数数量不符或整数词非法时输出SYNTAX,不调用API、不修改状态。

R19. 字节词为大小写均可的偶数位十六进制,或单独的-表示空串;其他词产生SYNTAX。解码成功后的长度由append的范围规则处理。所有输出十六进制均为小写,空串使用-。输出整数均为十进制,无加号、前导零或补齐空格。

R20. CLI动词和参数依次为new id mode retries capacity、drop id、point id slot address、enable id slot enabled、start id、finish id debugger kind value collector、append id HEX、reset id、status id、showpoint id slot、log id、script id、list。每个动词只接受这里列出的参数个数,list无参数。

R21. new/drop/point/enable/start/finish/append/reset输出R CODE COUNT,COUNT为操作后当前会话数,含失败操作后的会话数。status输出S CODE ID MODE RETRIES CAPACITY ATTEMPTS STATE OUTCOME DEBUGGER KIND VALUE COLLECTOR TOTAL POINTS ENABLED。showpoint输出P CODE SLOT ADDRESS ENABLED。log输出L CODE TOTAL HEX。script输出T CODE HEX。list输出I COUNT及依次排列的id,每个id前一个空格。每行以一个LF结束,字段间一个ASCII空格,无其他stdout。语法错误行是SYNTAX加LF,行数超限是LIMIT加LF。API错误仍输出该动词的正常字段结构。