amos 913d3c367f Add the usable task catalog and admit batch 6 tasks
All 161 task packages, including the 21 batch 6 C++17 tasks that passed
gates 1/2, are now in Git. rollout.catalog builds docs/task-catalog.{json,md}
from the task packages, a fresh trace5 calibration (128/128 PASS), every
verified controller receipt on the current task digest, documented holds
and digest-bound difficulty reviews. 123 tasks are usable (6 HARD),
5 are on hold and 33 still need a subprocess-only grader.

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
2026-10-18 17:43:15 +08:00

3.6 KiB
Raw Blame History

原始 typed overlay 观察协议

overlay-observe 从 stdin 逐行读 ASCII 空白分隔 token;空行或首 token 以 # 开头的行忽略,不支持行末注释、引号或 shell。无符号十进制允许前导零,不接受正负号。字符串/数据用偶数位 hex,大小写均可,单个 - 表示空;只解码字节,不作ASCII/UTF8/路径/句柄修复。有效wire到EOF退出0,业务INVALID仍是有效wire;缺/多token、未知命令、索引或wire范围错误退出2并写stderr。

有两个输入bank,初选0。每bank保存base Tree、overlay Tree和最近R/Y返回的Tree;四个held槽独立于bank。Tree初始为空nodes,N不自动添加根。which=0表示base、1表示overlay;节点索引是该Tree中F追加的从0起列表下标,不是排序后位置。任何不存在索引是传输错误,不调用候选。

  • A BANK:选择0/1 bank,不输出。
  • N:清空当前bank两棵Tree及最近返回值,不清全局held槽,不输出。
  • F WHICH PATH_HEX:向该Tree追加Node{path,空properties},不输出。
  • P WHICH NODE_INDEX NAME_HEX VALUE_HEX:向已存在节点追加完整Property{name,value},不去重、不检查名称/编码/4字节域,不输出。
  • R:以该bank完整base/overlay调用唯一apply_overlay;输出一行并保存返回的Tree(失败值也保存)。
  • Y WHICH:以选中0/1的同一个Tree对象同时作为base和overlay调用apply_overlay;其dirty output、两完整bank输入保持比较、最近返回Tree保存与R相同,输出op标签为Y。不是复制两个相等对象后调用。
  • H SLOT:复制最近R/Y的Tree到0..3 held槽,须已R或Y,不输出。
  • J SLOT:打印该已保存槽,须已H,不调用候选。
  • M SLOT:复制已保存槽;若副本非空,把第一节点path改为/copy,且若该节点非空properties,把第一属性value改为两个字节00ff,再向该节点追加Property{COPY,0102};无论是否原来为空,再向副本nodes尾追加Node{/new,[Property{NEW,ff00}]}。打印原槽、副本、原槽当前值;不改原槽、不调用候选。

wire界限:每行不含LF的字节数至多8388608(可能的CR计入)。单个PATH_HEX/NAME_HEX解码至多131073字节,单VALUE_HEX解码至多65537。每bank每棵Tree至多513nodes、两Tree属性合计至多4097;其全部path/name合计至多262144字节、全部value合计至多2097152字节。追加动作按这些wire界限检查,N重置计数。节点index为0..512且须存在;which为0/1,SLOT/BANK均0..3/0..1。每进程至多256次R/Y业务调用,跨bank累计。这些界限覆盖全部合法API输入及每个业务容量的下一项,不代替API业务校验;API可直接接受wire之外输入并按业务合同拒绝。

Tree原始JSON为节点数组:每Node恰[path_hex,properties],每Property恰[name_hex,value_hex]。保持实际vector次序,不在观察器排序或丢弃项。输出hex均小写、空串为"",不重新编码字符串。R格式为["R",status,Tree,input_unchanged],Y格式为["Y",status,Tree,input_unchanged];每次先放dirty output为[["2f6f6c64",[["4f4c44","00ff"]]]](节点/old、属性OLD、值00ff),完整输入序列化在调用前后逐字比较,包含所有节点、属性、原始字节与次序。

J格式为["J",Tree];M为["M",原槽Tree,改后副本Tree,原槽当前Tree]。构造命令和H不输出。stdout每个R/Y/J/M恰一行JSON;允许stderr任意诊断字节,字段/整数/bool类型、顺序和行数均精确。观察器无格式oracle、正确输出表或业务断言,只设置输入、调用、打印实际值和由C++值类型直接复制的历史。