amos 9d633e9e67 Batch 15 (20261023-C-hwe-scale-15): 320 HWE-derived repair tasks
One user-space repair task per eligible HWE debug-diag / compile-deploy base
ID: 320 admitted (C 218, C++ 97, build scripts 5), 1 skipped by the content
filter. Each ships a public spec with a check-to-basis table, at least two
defects with single-fix fixtures, a symptom-masking fixture and an alternative
correct implementation. Claude re-checked all 320: structure, the HWE quality
items and trace6 Docker calibration receipts against current digests
(320/320 USABLE). Difficulty is unmeasured. Known follow-up: 212 tasks use 120
ad-hoc family names; the next batch maps them to the canonical list.
The batch's 1,256-line progress log stays in its factory report and the
36-local branch batch15-hwe.

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
2026-10-27 01:55:56 +08:00

4.6 KiB
Raw Permalink Blame History

软件事件端口合同 v1

W01. C++17,namespace watch;watch.hpp 公开全部类型及签名。输入按行执行,空行忽略。所有API结果为有符号整数。无真实文件监控、网络或时钟。不同Port对象状态独立。 W02. Port从空状态开始。最多8实例,fd为3..10内最小空闲值;open成功返回fd并增加opened,满时-24且状态不变。close无效fd返回-9;成功返回0并自动移除该实例所有watch和排队事件,增加closed。 W03. key范围1..1000000,mask范围1..7。add先验证fd(-9),再验证key/mask(-22)。同实例同key重复add替换mask,保留wd;新watch使用该实例递增wd(从1开始,删除后不复用),全Port最多32个watch,满时-28且状态不变。更新已有watch不受配额限制。remove先验证fd(-9),无此wd返回-2;成功0,已排队事件保留。 W04. emit验证key/mask,非法-22。按fd升序、wd升序向所有同key且mask交集非零的watch投递一个Event,字段为wd,key,交集mask,cookie。每实例最多64事件;若任何匹配队列已满则整体-28,任何队列都不变。否则返回投递数。cookie为完整uint64,不解释其值。 W05. read先验证fd(-9),capacity>64返回-22,失败保持output与端口状态。成功从队首取min(capacity,队列长度)事件,替换output,返回事件数并累计delivered;capacity=0合法,成功清空output而不消费事件。inspect先验证fd(-9),失败保持output;成功按wd升序替换output并返回watch数。 W06. counts按字段顺序为当前instances,watches,queued及累计opened,closed,delivered。reset强制清空全部实例并将所有累计数归零。关闭和删除不增加delivered。 W07. Service从无当前实例(-1)开始,独占当前实例;外部低层操作不得close或remove当前实例,但可inspect/read当前实例,可打开操作其他实例。reload最多16项(超过-22且无其他操作),空列表和重复key合法;按列表顺序对一个新实例执行open/add,任一失败返回该错误,释放准备实例及资源,原当前实例、配置和未读事件保持。已发生成功open/close计入累计数。 W08. reload全部准备成功后关闭旧当前实例并接管新实例,返回0;旧实例全部watch和未读事件消失。配置按key第一次出现顺序输出,重复key以最后mask为准。stop关闭当前实例并清空配置,幂等返回0;active返回当前fd或-1。read代理当前fd的Port.read。析构等价stop。forget仅供reset后清除服务缓存,不操作Port。 W09. parse_configuration接收最多4096字节文本,每行先截断#及之后注释,去除两端space/TAB/CR;空行忽略。其余行必须恰有一个冒号,冒号两边分别去同样水平空白后,为非空ASCII十进制无符号数(可任意前导0),值符合W03;最多16项,重复key按原顺序保留。不允许符号、其他空白、NUL、额外冒号、数值溢出。任何失败-22且output保持,成功0且替换output。format_configuration为每项输出key:mask及LF,不去重。 W10. console输入命令:L n 后跟n对key mask,n允许0..17(17用于公开超限错误);S停服务;A当前fd;C当前规范化配置;O打开;X fd关闭;+ fd key mask添加;- fd wd删除;E key mask cookie发送;R capacity读服务;D fd capacity读端口;I fd查询watch;K统计;P hex解析配置(-为空文本,其他为十六进制字节);Z先stop再reset再forget。所有命令参数以space/TAB分隔,行尾允许CR,数值在其C++类型范围内;测试只使用文法有效的命令。单会话命令数没有固定上限。低层fd/wd可无效,key/mask可在int/unsigned范围内越界,capacity允许0..65。 W11. console每命令恰一行原始数字观测,无额外stdout。普通API只打印返回码;K打印W06六字段;C/P打印rc,count及每项key,mask;I打印rc,count及每项wd,key,mask;R/D打印rc,count及每项wd,key,mask,cookie。read/inspect初始output为单个(-77,-77,77,77)/(-77,-77,77),P初始output为(77,7),用于观察失败保持。所有有效数组元素都公开可观察,unused容量不受约束。stdout数字token允许可选+/-、任意前导0;token间space/TAB/CR,行以LF分隔,末行LF可省略;不允许其他字符或空行。stderr可有任意字节诊断,不限制内容或大小。 W12. 最终只提交watch.hpp、port.cpp、service.cpp、config.cpp。固定console.cpp和其他公开文件会从初态重新提供;不得依赖候选之外的新文件或既有构建产物。实现需符合全部条款,不要求特定容器、资源清理方式或算法。