amos 8b7616bfd8 Batch 22 (20261027-C-hwe-hard-22): add 63 calibrated HWE hard-design tasks
From the 101 lk/man/pth code-gen sources: 63 tasks (C11 36, C++17 27,
11 canonical families), 38 skipped for scope or duplication. Each task
has at least one independent contract-edge defect, boundary types
rotate, and public docs state trap clauses as plain contract prose.
Claude reviewed 63/63 USABLE against current digests. Difficulty is
unmeasured.

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
2026-10-27 16:14:57 +08:00

8.2 KiB
Raw Permalink Blame History

共享 provider 行为合同 v1

入口与类型

  1. activation.hpp 的 activation 命名空间是公开 API:常量 provider_count=4、handle_count=8、share_limit=16;枚举 Result 与 Op;Command、Event、ProviderView、HandleView、Observation,以及 Engine 的构造、execute、observe。结构字段的含义、取值和顺序如下。私有方法与内部布局不限制。
  2. Engine() 创建独立的空实例:四个 provider 全字段为 0,没有句柄,下一次成功 open 的 token 为 1,最近 rc 和 token 为 0,事件为空。不同实例不共享状态。
  3. int execute(const Command&) 执行一次同步操作,返回结果并保存为最近 rc;每次执行开始清空上次事件并将最近 token 置 0。它不会清除累计统计、其他句柄、其他 provider 或尚未触发的故障点。
  4. Observation observe() const 返回副本,无副作用;可反复调用。其 rc/token 是最近调用结果,providers 是编号 0..3 的四项数组,handles 按 token 升序排列,events 是最近操作的底层动作顺序。返回副本的修改不能改变 Engine。
  5. Command 的 op 是下列公开枚举之一,a/b 是 C++ int;Op::invalid 总是返回 -1,无状态改变。对只有一个参数的操作 b 忽略。未执行前 observe 的值也遵守第 2 条。
  6. Result 数值:ok=0、invalid=-1(参数或命令格式错误)、missing=-2(句柄不存在)、full=-3(8 个槽已满)、ownership=-4(份额不足或超出句柄上限)、busy=-5(带份额关闭)、injected=-7(故障注入)。无其他业务返回码。

句柄与参数

  1. Op::open / open client provider:a=client,b=provider;client 合法范围 0..7,provider 0..3。先检查参数,非法返回 -1;再检查全局槽数,已存在 8 个 live 句柄返回 -3。成功创建 p=e=0 的句柄,provider 的 handles 加 1,返回 0 且 Observation.token 为新 token。
  2. token 从 1 开始只在成功 open 后加 1,关闭后不复用;同一 client 可以打开任意多个句柄,包括同一 provider。所有句柄各自拥有份额,client 和 provider 相同也不能互借。合法会话不超过 600 条命令,不会溢出 int token/计数。
  3. Op::close / close token:a=token;不存在返回 -2;其 p 或 e 非零返回 -5 且保留句柄;否则删除句柄并令 provider.handles 减 1,返回 0。close 不自动收回任何份额,也不产生底层事件。
  4. reserve/gate/ungate/release/activate/deactivate 的 a=token、b=count;先查 token,不存在总返回 -2;再查 count,合法闭区间 0..16,超界返回 -1;最后检查该操作需要的份额/容量。count=0 在合法句柄上成功且不产生底层调用,即使 provider 已有待触发的故障。
  5. 每句柄始终满足 0 <= e <= p <= 16。provider.prepared/enabled 是所有关联 live 句柄 p/e 的精确和,handles 是其数量。每个 provider 的物理 prepare/enable 状态分别等价于对应总数非零。

双层份额操作

  1. Op::reserve / reserve token count:若 p+count>16,返回 -4,无底层调用;否则连续取得 count 个 prepare 份额,不取得 enable。第 k 次 prepare 失败时,归还本次已经取得的 k-1 个 prepare,返回 -7;调用前 p/e 以及其他句柄的全部资源必须保留。
  2. Op::gate / gate token count:要求该句柄 p-e>=count,否则返回 -4 且不调用 provider,不消耗故障点;其他句柄的空闲 prepare 不能为本句柄提供额度。符合条件时连续取得 count 个 enable;失败时只 disable 本次已取得的 enable,返回 -7,已有 enable 与全部 prepare 都保留。
  3. Op::ungate / ungate token count:要求 e>=count,否则返回 -4,无副作用;符合条件时 disable count 次,p 不变,返回 0。
  4. Op::release / release token count:要求 p-e>=count,否则返回 -4,无副作用;符合条件时 unprepare count 次,e 不变,返回 0。
  5. Op::activate / activate token count:要求 p+count<=16,否则返回 -4,无副作用。先 prepare count 次,再 enable count 次;成功 p/e 各增加 count。任一步失败必须按反向层次先 disable 本调用已取得的 enable,再 unprepare 本调用已取得的 prepare,返回 -7。错误后精确保留未归本调用所有的资源,包括本句柄调用前空闲 prepare、已有 enable,以及所有其他 client/句柄的资源;不能清空旧资源来恢复总数。
  6. Op::deactivate / deactivate token count:要求 e>=count,否则返回 -4,无副作用;符合条件时先全部 disable count 次,再全部 unprepare count 次,p/e 各减 count,返回 0。可重复开关,可在保留其他 prepare/enable 的情况下执行。
  7. 所有不满足参数/容量/所有权前置条件的命令,除最近 rc、token 和事件清空外,不改变状态、累计计数、待触发故障。prepare/enable 注入失败不改变对应份额,但会改变尝试计数与故障倒计数;补偿操作的物理转换与事件须如实记录,不能回滚统计。

注入、底层顺序与观察

  1. Op::arm_p / arm-p provider nth 与 Op::arm_e / arm-e provider nth:a=provider,b=nth;provider 0..3、nth 1..16 合法,其他返回 -1 且保留全部状态;合法时用 nth 替换该 provider 对应层的倒计数,另一层不变,返回 0,不产生事件或尝试计数。
  2. 倒计数只在对应层实际 prepare/enable 尝试时递减;减至 0 的那次失败一次,返回 -7,其后该层不再失败直至重设。每份额一次尝试,即使 provider 物理层已开启也消耗倒计数;不同 client/句柄共用同一 provider 故障点,其他 provider 不消耗它。
  3. Op::clear / clear provider:a=provider;非法返回 -1;合法将该 provider 两个倒计数清 0,其他字段不变,无事件,返回 0。close 和最后一次关闭物理层不会清除故障点或累计统计。
  4. prepare/enable 每次尝试令该层 calls 加 1,失败也计入;成功后句柄与 provider 对应份额各加 1。prepare 成功前总 p 为 0 才令 prepare_on 加 1,enable 成功前总 e 为 0 才令 enable_on 加 1。
  5. disable/unprepare 不失败,分别令句柄与 provider 对应份额减 1;减后总 e/p 为 0 才令 enable_off/prepare_off 加 1。先完成所有新增 prepare 再新增 enable;补偿与 deactivate 先完成所有 disable 再 unprepare,不交错层次。
  6. Event 是三整数 [kind,provider,token];kind:1=prepare 成功,2=prepare 注入失败,3=enable 成功,4=enable 注入失败,5=disable,6=unprepare。每个实际底层动作产生一个事件,失败亦产生;事件严格按执行先后,前置条件拒绝没有事件。只有这些动作产生事件。
  7. ProviderView 的 JSON 数组顺序是 [handles,prepared,enabled,prepare_on,prepare_off,enable_on,enable_off,prepare_calls,enable_calls,pending_prepare,pending_enable];所有值为非负整数,最后两项就是第 19/20 条倒计数。
  8. HandleView 的 JSON 数组顺序是 [token,client,provider,prepared,enabled]。Observation 的 JSON 对象恰含 rc、token、providers、handles、events 五个键;rc/token 为整数,其他值为前述数组。没有新 open 时 token 为 0。整数不是布尔值;对象键顺序与 JSON 空白不影响含义。

固定观察前端与交付

  1. main.cpp 逐行读 ASCII 命令,参数以空白分隔,空行忽略;命令名区分大小写。每个非空输入行打印一个 UTF-8 JSON Observation 并换行;直到 EOF 正常退出 0。不要求 stderr 的内容或编码,诊断不参与业务判断。
  2. 命令名/参数个数见第 7、9、12..17、19、21 条;整数可带一个前导 + 或 -,其余必须十进制数字,可有前导零,数值必须适配 32 位有符号 int。未知命令、参数个数错误或整数词法/范围错误都执行 Op::invalid;输出 rc=-1 的无状态改变观察,继续处理后续行。
  3. 只交付 README 中四个文件;保持 C++17、公开 API 可由固定 main.cpp 直接编译运行。验收从干净目录重新构建,不使用已有二进制。允许不同数据结构、算法、内部函数或补偿组织方式;所有可观察行为须满足以上全部条款。