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>
11 KiB
11 KiB
sysctl 分层规则与全局排除合同 v1
本模型将调用方提供的配置文本和已知键清单编译为写入计划,不读取或修改真实 sysctl。ASCII 字节语言、容量、Rule/Configuration/来源字段是本题新增明确合同,不继承 Python 的 Unicode splitlines/strip 行为。所有索引从 0 开始。
值与边界
- valid_kernel_key 检查已知键的规范斜线路径:长度 1..256 字节,非绝对路径,各斜线分隔组件非空且不能恰为 . 或 ..。组件每字节只允许 ASCII 字母、数字、下划线、点、连字符。点是组件内容;本接口不进行任何点/斜线转换。大小写敏感。
- canonical_key 的 raw 长 1..256,先查原串第一处点或斜线:若为点,将原串每个点变斜线、每个斜线变点,同时完成;若为斜线或没有二者则原样。随后按 01 的组件规则验证,allow_pattern=true 时组件额外允许 * 和 ?,否则二者非法。不 trim、不解释转义、[]、Unicode 或路径 . / .. 消除。
- 例如 raw=net.ipv4.conf.eth0/100.forwarding 变为 net/ipv4/conf/eth0.100/forwarding;raw=net/ipv4/conf/eth0.100/forwarding 因首分隔符是斜线保持。不能两次先后 replace 把两类分隔符合并。成功 output 为完整规范串,失败清空。
- 输入均只读,输出拥有独立值;之后的任何调用不改变先前输出。不同调用没有可变全局业务状态。每次调用的输入与输出对象互异;不要求处理分配失败或被移动后的对象。
- Error 仅 none=0、invalid=1。任何失败都完整覆盖旧输出:字符串/vector 清空,bool 变 false,Configuration/Plan 变为默认空值;成功也完整覆盖旧输出。valid_kernel_key 仅返回 bool。有效调用正常返回,不发布半成品。
- layers 是优先级从高到低的 0..8 层,每层 0..64 个 File,全部层合计至多 128 个 File。每个 basename 长 1..128,仅 ASCII 字母、数字、下划线、点、连字符,且精确以 .conf 结尾;同一层 basename 不可重复。不同层同名合法,层内 File 排列不影响语义。
- File.text 为 null 表示屏蔽,或为至多 65536 字节的文本。所有非 null File 的文本总长至多 262144 字节,包含随后被遮蔽的文本。文本的每个字节仅允许 TAB/LF/CR/VT/FF 或 ASCII 32..126;NUL、DEL、高位字节及其他控制字节在任何位置都非法,注释和被遮蔽文本也不能例外。
- keys 是 0..256 个 01 合法键,全部字节数至多 32768,不可重复,顺序任意。不执行 02 转换。完整验证所有键,即使没有规则、没有匹配或后续会被排除。不存在于 keys 的具体键称 missing;它与非法键语法不同。
文本与模式
- parse_text 执行 07 的单文本限制,以 LF 唯一分割物理行,包括末尾 LF 后的最后空行;Rule.row 为原物理行的 0 基索引。CR 不单独分行。每行先从第一个 # 起全部删除,再 trim 两端 ASCII SP/TAB/CR/VT/FF;空行忽略。引号和反斜杠没有保护 #、转义或续行效果。
- 非空行若首字节为 -,只取掉这一个字节并记 leading_minus=true;否则为 false。其余按第一个 = 分割。存在 = 时为赋值,两侧分别 trim 09 的五种空白;右侧 VALUE 必须长 1..4096,且每字节仅 TAB 或 ASCII 32..126。后续 = 原样保留。没有 = 时必须 leading_minus=true,表示排除;整段余串 trim 后为 KEY。空 VALUE、裸 KEY 或空 KEY 均 invalid。
- KEY 使用 canonical_key(raw,true);规范结果含 * 或 ? 时 Rule.pattern=true,否则 false。赋值 Rule.kind=assignment,value 为 trim 后 VALUE,ignore_error 等于 leading_minus。排除 Rule.kind=exclusion,必须为具体键(pattern=false),value 为空、ignore_error=false。-KEY=VALUE 是可忽略 missing 的赋值,不是排除指令;-KEY 只排除通配写入。
- parse_text 输出按物理行顺序排列的 0..512 条 Rule,空行/注释不占 Rule 数但仍影响 row;超过 512 条 invalid。每个 Rule 的 key/value/kind/pattern/ignore_error/row 均按 09–11 确定。任何后行错误使整个输出清空,即使前行全部合法。
- 例 a/x = left=right #note 的 value 为 left=right;a/x= #note 非法;# 后的合法 ASCII 内容忽略。- a/x= v 合法且 ignore_error=true。已知键 -a/x 语法合法,配置 --a/x=v 给它作 ignore_error=true 的具体赋值;前缀只删除一个 -。
- match_pattern 的 pattern 已处于规范斜线域,按 01 的组件规则加 * / ? 验证,长 1..256;key 按 01。它不再执行 02。* 匹配任意数量字节(包括 0 和斜线),? 恰匹配一个字节(也可为斜线),其余字符逐字节大小写敏感;必须匹配完整 key。不支持 [] 或任何转义。无通配符的 pattern 也合法。
- match_pattern 对合法不匹配返回 none/false,合法匹配 none/true;任一输入非法返回 invalid/false。不存在“文件路径 glob 不跨斜线”的额外例外,例如 pattern=a/* 可匹配 key=a/x/y。
文件选择与规则编译
- select_files 先完整检查 06–07 的全部层及 File,包括被遮蔽者;随后对每个 basename 仅选择最先出现层中的完整 File。null 同样占据最高优先级并阻止低层恢复。输出 SelectedFile 按 basename ASCII 字典序排列,layer 是实际选中层索引,file 保留 basename 和完整 text/null 的独立副本。
- select_files 只作结构校验/选择,不解析文本语法。compile_configuration 使用相同选择,随后按 basename 顺序解析全部选中且非 null 的文本;null 不产生 Rule。被遮蔽文本不解析语法,但仍须满足 07 的结构限制。keys 为空也不能跳过任何选中文本的语法校验。
- compile_configuration.rules 按选中 basename 顺序、各文本物理行顺序保存 LocatedRule;其中 layer/basename 来自选中文件,rule.row 来自物理行。所有选中文本合计至多 512 条 Rule,超过 invalid。selected 保留包含 null 的完整 16 投影。失败时 selected/rules/excluded 都为空。
- 在执行任何赋值之前,从全部已解析规则收集 excluded:每个具体赋值(包括普通 KEY=VALUE 及 -KEY=VALUE)和每个排除 -KEY 都贡献其规范 key;去重并按 ASCII 字典序排列。通配赋值不贡献排除。missing 的具体键也照样收集。这个集合不依赖规则位置先后。
- Configuration 是可供界面审阅及后续复用的编译结果。plan_configuration 只接受成功 compile_configuration 的输出或其独立值副本;默认空 Configuration 等价空层的成功结果。手造破坏其一致性的 Configuration 不在有效调用范围。其内部算法/缓存布局没有要求,公开 selected/rules/excluded 只是上述业务投影。
计划生成
- plan_configuration 在任何赋值前按 08 验证全部 keys,再计算静态匹配预算 W:对每条 pattern=true 的赋值和每一个 supplied key(包括 excluded 键),累加 (pattern字节数+1)*(key字节数+1)。W 必须 <=16777216,恰等允许;超过返回 invalid/空 Plan。空 rules 或空 keys 的 W 为 0。预算不依赖实际匹配、短路或内部算法,也不按去重后的 pattern 计数。
- 按 Configuration.rules 顺序解释赋值。exclusion 本身不写值、不删除已有具体赋值。具体赋值恰以其规范 key 查 keys:存在则更新,missing 且 ignore_error=true 则跳过,missing 且 false 则整份计划 invalid/清空。未知排除键为合法无操作;这不放宽排除键语法。
- 通配赋值只针对 keys 中完整匹配且不在 excluded 的键。所有具体赋值与 -KEY 对所有通配规则全局有效,即使贡献排除的规则在更后文件/更后行。无匹配通配合法无操作;不得先发布前缀通配写入再试图用后置排除补救。
- 例如 keys=[a/x,a/y],规则 a/x=exact 后接 a/=glob,最终 x 为 exact、y 为 glob;把具体赋值换成 -a/x=exact 仍如此且 x.ignore_error=true。规则 a/=glob 后接 -a/x 只得到 a/y 的 glob;-a/x 后接 a/x=exact 不阻止该具体赋值。
- 每个更新整体替换该 key 的 Entry:value、ignore_error、layer、basename、row 都取最后实际命中的赋值。通配是否使用 leading_minus 同样决定写出 Entry.ignore_error。不得只替换 value 而保留旧 ignore_error 或来源。
- Plan.entries 只包含至少被一次实际赋值的已知键,每 key 恰一项并按规范 key 的 ASCII 字典序排列。未被赋值键不出现;每项 key 保持 keys 中原样,value 与赋值 Rule.value 相同,ignore_error 和来源按 25。计划不按文件顺序或 keys 输入顺序排列。
- 任意 missing 错误、容量或格式错误都不能泄漏前面已算出的 Entry;之后相同/不同输入的合法调用仍正常。空 keys 仍会因 missing 的强制具体赋值失败;只有通配/排除/可忽略 missing 时可成功空计划。空配置对合法 keys 返回空计划。
- make_plan 对 layers 完整执行 06–19、对 keys 执行 08,再按 21–27 规划,效果等同成功 compile_configuration 后 plan_configuration;compile 失败时 Plan 也默认空。每次调用都完整验证,不依赖先前编译或规划缓存。
- 文件名选择顺序与规则执行顺序是两回事:高层仅决定同 basename 的来源,不让全部高层规则最后执行。不同 basename 跨层统一按文件名排序,最后命中者依规则顺序覆盖;每行 Entry 的 layer 是其原层索引,不是排序后文件下标。
- 规范化、解析、选择、编译、匹配、计划均为纯值接口。保存 Configuration/Rule/Plan 后再进行失败或成功调用、改变另一个输入对象,不改变保存值。不得把解析游标、排除集合、glob 结果或最后 Entry 借给其他调用。
有限工作与观察
- 上述范围均为有效域。匹配存在按 pattern/key 前缀计算的有限 DP:一次至多 (p+1)*(k+1) 个单元,整份计划至多 W<=16777216 个此类单元;星号不会生成新规则或递归事件。不要求使用 DP,可使用任何在有效域内正确、可完成的等价算法。多星号失败匹配也须正确完成,不能依靠无界枚举或紧时限取得判别。
- 词法处理至多 262144 总文本字节、全图至多 512 Rule、256 keys;W 上界在过滤 excluded 前计算,不能通过先过滤改变准入。没有真实系统调用、线程、硬件时序或隐含重试;结构校验与匹配预算均只依赖公开值。
- make 使用已有 g++ -std=c++17 -O2 -Wall -Wextra -pedantic 与标准库,构建限 30 秒、单次观察程序限 15 秒、整体评分 120 秒。四候选可任意重组,不增加正式构建必需的额外源码/依赖。正式判据在干净目录重建四候选和原样公开 header/observer。
- 行协议见 docs/console.md。raw observer 只读输入、调用 API、输出原始值与 input_unchanged,失败输出预置旧值以观察 05;不包含答案或断言。每条有效 wire 命令(包括业务 invalid)输出一条 JSON,正常 EOF exit0,wire 错误 exit2;stdout 仅协议,stderr 允许 UTF-8 诊断。
- 所有检查均依据本合同。只评分 sysctl_key.cpp、sysctl_lex.cpp、sysctl_compile.cpp、sysctl_plan.cpp;允许新增自测,但不带入正式候选。公开来源字段和编译投影有实际审阅用途,不要求产生库私有表示或逐行内部发布轨迹。