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>
18 lines
2.5 KiB
Markdown
18 lines
2.5 KiB
Markdown
# observe 行协议
|
||
|
||
stdin命令使用ASCII空白分词,字符串以连续十六进制字节表示,空字符串写`-`。每个顶层命令输出一个JSON数组并换行;后续行是命令参数,不另输出。合法API参数即使业务invalid/cycle也正常退出0;格式错误退出2。以下是完整观察协议,不包含隐藏断言或期望。
|
||
|
||
- `N hex`:调用canonical_module,输出`["N",bool,output,input_unchanged]`,output初始非空以观察错误时清空。
|
||
- `L hex`:调用statements,输出`["L",error,token_rows,input_unchanged]`,输出初始有一个旧token行以观察清空。
|
||
- `C directory_count available_count`:随后每目录`D file_count`,再跟file_count行`F basename_hex text_hex`;最后available_count行`A module_hex`。调用compile_configuration并输出`["C",error,configuration,input_unchanged]`。configuration为`[available,selected_files,blacklist,[[module,options]...],[[module,pre,post]...]]`;成功时在当前bank建立新Planner,失败不改变旧Planner。每次C保留这次原始参数供P使用。
|
||
- `P request_count`:随后request_count行`Q module_hex alias_flag`,flag为0/1。对最近C的原始参数调用plan,输出`["P",error,load,skipped,missing,selected_files,input_unchanged]`。
|
||
- `B module_hex alias_flag`:调用当前Planner.begin,输出`["B",error,snapshot,input_unchanged]`。
|
||
- `T`:调用tick,输出`["T",error,kind,module,snapshot]`。
|
||
- `S`:只观察,输出`["S",snapshot]`。`X`调用cancel,`R`调用reset,各输出`[command,snapshot]`。
|
||
- `H`保存当前快照并输出`["H",snapshot]`;`J`输出保存的旧快照`["J",held_snapshot]`,不推进状态。
|
||
- `G bank_index`切换三个互相独立bank之一(0/1/2),输出`["G",snapshot]`。每个bank初始使用空Configuration,有自己的C输入、Planner和held_snapshot。
|
||
|
||
load/staged/committed统一表示为`[[module,[options...]]...]`。snapshot为`[busy,committed,staged,skipped,missing,pending_missing,accepted,suppressed,failed,cancelled]`。error整数为none=0/invalid=1/cycle=2/busy=3/idle=4;kind整数为idle=0/open=1/emit=2/close=3/missing=4/reused=5/skipped=6/cycle=7。所有列表及计数精确表示API观察,JSON键/空白不作额外要求。
|
||
|
||
input_unchanged为布尔观察:观察器在调用前独立保存所有输入,调用后比较名称/text/目录/available/requests是否逐字段不变,仅打印比较结果,不做断言。C的输出先放旧内容,以观察错误时是否完整清空。
|