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.2 KiB
原始观察协议
pc-observe逐行读取ASCII命令,忽略空白行和首个非空白token以#开头的顶层行。数字为无符号十进制。字符串参数为逐字节十六进制(大小写均可),-代表空串;输出字符串总是JSON字符串包住的小写十六进制,空串输出""。这只是传输编码,API仍收到任意字节字符串,可用来传无效NUL/CR/高位字节。
有两个独立bank,初始选择0;每个bank初始sources、Repository、Request及四个last结果都是默认值。设置命令不调用被测库,也不输出stdout:
U bank选择0或1。S count后紧接count行s nameHex textHex,替换当前sources,不改变Repository;count可0..65。R count后逐包读取一行p nameHex variableCount、随后variableCount行v nameHex valueHex及一行f VersionHex RequiresHex Requires.privateHex LibsHex Libs.privateHex CflagsHex,替换当前Repository;count可0..65,每包variableCount可0..257。这条命令允许任意输入排列及直接构造的无效库。Q mode rootCount sysrootHex后紧接rootCount行r nameHex relation segmentCount segment0 ...,替换Request;mode和relation可为任意uint32,rootCount可0..33,segmentCount可0..17,每段uint32。
观察命令无额外参数,每次恰输出一行JSON:
P调用parse_sources,输出["P",status,Repository,input_unchanged],然后把这次Repository结果(成功或清空错误值)复制为当前Repository,供后续E/C/F使用。input_unchanged只比较sources调用前后,观察器自己的这次赋值发生在比较之后。E调用expand_repository,输出["E",status,Expansion,input_unchanged]。C调用resolve_closure,输出["C",status,Closure,input_unchanged]。F调用plan_flags,输出["F",status,Plan,input_unchanged]。
E/C/F比较Repository和Request调用前后的完整字段。E并不向库传Request,比较它只是观察同bank已有请求是否保持。每次调用输出参数都先放入非空dirty值,用来直接观察错误是否彻底清空;观察器不根据状态码替候选清空。未被调用的其它last结果原样保存。
K slot把当前bank的四个last结果按C++值复制到全局保存槽slot(0..3),输出["K",slot,[Repository,Expansion,Closure,Plan]];O slot不调用库,只输出该槽当前值,形式相同但首项为"O"。所有保存槽最初均为默认值;后续库调用不会经过观察器重写旧槽。两命令均恰输出一行,可观察保存值独立性。
值投影如下,所有字节string使用前述hex表示,所有vector保持实际返回顺序:
- Repository是Package数组,Package为
[name,[[variableName,expression],...],[六字段表达式]]。 - Expansion为
[work,bytes,[[packageName,[六字段展开值]],...]]。 - Closure为包名数组。
- Plan为
[包名数组,cflags数组,libs数组]。
设置命令及其payload没有输出;输出行只对应P/E/C/F/K/O,严格保持命令出现顺序。协议自身错误使观察器退出2并在stderr写诊断;正式行为输入使用结构合法的协议,可包含API合同所要求拒绝的数据。观察器只搬运、复制及打印原始值,不验证模块的正确性,不复算展开/闭包/路径答案。