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>
3.7 KiB
sysctl-observe 公开行协议
输入按 ASCII 空白分词,文本均用连续十六进制字节串表示;- 表示空串。hex 大小写均可,不对解码字节 trim 或转码。计数读为 0..4096,用于传递超过库容量的业务输入。布尔 wire 参数仅 0/1。每个顶层命令输出恰一条 JSON;后续数据行不独立输出。观察器不含正确性断言。
wire 的有限传输范围:每个顶层命令的全部 hex 字段解码字节合计至多 1048576,一次 C 的全部 F 数据行合计至多 4096。超过属于 wire 错误;这些外层界限容纳所有业务合法输入,也容纳库容量边界的非法输入,不代替 API 自身的校验。
K key_hex:valid_kernel_key,输出["K",bool,input_unchanged]。N allow_pattern raw_hex:canonical_key,输出["N",error,text,input_unchanged]。输出先置旧字符串。M pattern_hex key_hex:match_pattern,输出["M",error,bool,input_unchanged]。输出先置 true;比较两个完整输入是否不变。L text_hex:parse_text,输出["L",error,rules,input_unchanged]。输出先置旧 Rule。C layer_count:随后每层一行Y file_count,再跟相应数量F basename_hex present text_hex。present=0 代表 text=null,要求 text_hex=-;present=1 传解码后的完整字符串(包括空串)。保存这次原始 layers,调用 compile_configuration 到非空旧 Configuration;输出["C",error,configuration,input_unchanged],并记录本次是否成功。S:对最近 C 的原始 layers 调用 select_files 到非空旧 vector,输出["S",error,selected,input_unchanged]。C 失败也不阻止 S,后者依自己的结构合同判断。P key_count key_hex...:保存 keys,对最近 C 的原始 layers 调用 make_plan 到非空旧 Plan;保存 last_plan,输出["P",error,entries,input_unchanged]。C 是否成功不影响这次独立 make_plan。input_unchanged 比较完整 layers 和 keys。R key_count key_hex...:仅在最近 C 成功时,以 last_configuration 调用 plan_configuration;输出["R",error,entries,input_unchanged]并保存 last_plan。比较完整 Configuration 和 keys。H:仅在最近 C 成功时,独立复制 last_configuration 和 last_plan 为 held_configuration/held_plan,输出["H",held_configuration,held_entries]。不调用候选 API。J key_count key_hex...:仅在已有 H 时,以 held_configuration 调用 plan_configuration 到非空旧 Plan,保存 last_plan;输出["J",error,entries,input_unchanged],比较完整 held_configuration 和 keys。不改 held_plan。Q:仅在已有 H 时,只读输出["Q",held_configuration,held_entries],不调用候选 API。
初始原始 layers、last_configuration、last_plan 都为空,最近 C 成功标记为 false,尚无 H。S/P 可在初始状态调用;无成功 C 的 R/H、无 H 的 J/Q 属 wire 使用错误 exit2,不是库业务 invalid。C 不清已有 H。
序列化:selected 项为 [layer,basename,text或null];Rule 为 [row,kind,key,value,ignore_error,pattern](kind assignment=0/exclusion=1);LocatedRule 为 [layer,basename,rule];Configuration 为 [selected,rules,excluded];Entry 为 [key,value,ignore_error,layer,basename,row]。Plan 只输出 entries 数组,空为 []。Error none=0/invalid=1。
每个 input_unchanged 都来自调用前完整独立副本与调用后逐值序列化比较,不以 const 签名代替观察。C/S 比较原始文件顺序、层顺序、basename、text/null;N/K/L 比较完整字符串;R/J 比较完整编译值和 keys。所有旧输出故意非空,观察器只打印调用后实际值。JSON 空白、字符串转义大小写不受额外限制;诊断允许写 stderr(含 UTF-8),stdout 只有协议。