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

4.0 KiB
Raw Blame History

属性服务合同

  1. 接口位于 attribute.hpp 的 attr 名字空间。Service 新建时八个槽位均为空,没有订阅;每个槽位的 generation 为0,下一个订阅 token 为1。实例彼此独立。单线程顺序调用,无网络、并发或真实时间要求。一个进程最多执行1000条控制台命令,回调不抛异常。整数参数采用声明的类型;传入指针须可写并具有至少 capacity 字节,除非显式传入 nullptr。
  2. 状态包含 value、epoch、generation、minimum、maximum、writable。槽位范围0..7;非法槽位返回 invalid(-22),空槽位返回 missing(-2)。snapshot 成功返回0并写入全部字段,失败不改 output。active_count 和 watcher_count 返回当前有效属性数和有效订阅数,不改变状态。
  3. valid_name 当且仅当名字为1..24字节且每字节属于 ASCII a..z、0..9、_ 时为真。lookup 对非法名字返回 invalid,对不存在的合法名字返回 missing,否则返回槽位。
  4. create(slot,name,minimum,maximum,initial,writable) 按以下顺序检查:槽位、通知中状态、名字、数值范围、槽位或名字占用。通知中返回 busy(-16);非法名字返回 invalid;minimum>maximum 或 initial 不在闭区间内返回 range(-34);槽位已存在或名字已被其他属性占用返回 duplicate(-17)。成功返回0,设置给定字段,epoch=0,该槽位 generation 加1;失败不改任何状态。所有 int32_t 边界均允许。
  5. drop 按槽位、存在性、通知中状态检查,通知中返回 busy。成功返回0,删除属性并撤销该属性的所有订阅,不发通知。槽位 generation 保留到再次创建时递增,订阅 token 不复用;旧 token 再撤销返回 missing。
  6. parse_value(bytes,output) 接受1..4096字节,内容为可选 ASCII + 或 -、至少一个 ASCII 十进制数字、可选一个末尾 LF。允许任意数量前导零;除此之外的字节均不属于语法。先检验全部语法,非法返回 invalid;语法合法但超出 int32_t 范围返回 range。成功返回0并写 output;失败保持 output。零的符号不影响数值。
  7. format_value(value,output,capacity) 写最短十进制有符号数、LF和NUL,成功返回不含NUL的字节数。nullptr 返回 invalid;capacity 小于所需总字节数返回 full(-28);失败不写缓冲区。show 按槽位和存在性检查后,以相同格式和规则输出该属性当前 value,不改变状态。合法 capacity 为0..32,零也是不足容量。
  8. store(slot,bytes) 按槽位、存在性、通知中状态、writable、parse_value、属性范围检查。通知中返回 busy;只读返回 denied(-13);解析错误原样传播;数值不在该属性闭区间返回 range。失败不改值、epoch、generation或订阅,也不通知。成功返回输入的原始字节数;值相等时不增加 epoch 且不通知。值改变时 value 更新、epoch 加1,generation 不变;在调用第一个观测者前完成这些更新,所有观测者读取到该次已提交的状态。
  9. watch(slot,callback) 按槽位、存在性、通知中状态、callback是否为空、总订阅容量检查。通知中返回 busy,空 callback 返回 invalid;最多同时16个有效订阅,已满返回 full。成功返回从1开始单调递增的正 token,订阅绑定此时槽位的 generation;失败不消耗 token。cancel(token) 成功撤销并返回0,无效或已撤销的 token 返回 missing。cancel 可从回调调用。
  10. 通知在 store 返回前同步完成,按全实例订阅的注册顺序,仅发送给该属性此 generation 的有效订阅。Notice 的 slot、token、epoch、generation 对应该次变化。每个订阅至多调用一次;轮到某订阅前已被回调撤销则跳过。回调撤销自身不影响正在进行的回调或其他订阅。通知中 snapshot、show、lookup、统计和 cancel 可用,create/drop/store/watch 按各自检查顺序返回 busy。错误和相等值写入均不消耗 token 或通知。