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

18 lines
2.5 KiB
Markdown
Raw Blame History

This file contains ambiguous Unicode characters

This file contains Unicode characters that might be confused with other characters. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.

# 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的输出先放旧内容,以观察错误时是否完整清空。