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

3.1 KiB
Raw Blame History

段表接口合同

  1. segment.h 为C11接口。所有表持有传入分配器;所有动态资源只经该分配器申请并通过其release归还。release仅接收尚存活且由同一分配器申请的指针,不对NULL调用。不规定申请次数、大小或内部布局,不允许绕开该分配器。分配器可在任意一次申请返回NULL;ST_NOMEM必须释放本次临时资源,保持原表、输出表指针及revision不变。销毁、清空、替换、删除及构建失败都必须归还不再属于活表的全部资源。
  2. 每表0..32行,每行0..64个整数,值域[-1000000,1000000];空行合法且保留label。label为unsigned。传入数组借用,只在调用期间有效;成功操作必须复制数据,各表之间修改独立。
  3. st_create要求合法allocator、非NULL output且*output==NULL;新表空且revision=0。st_destroy对NULL参数或NULL表无操作;否则释放全部所有权并将指针置NULL。clear清空所有行,保留表可继续使用。NULL表在rows/cells/revision查询返回0,其余返回ST_INVALID(destroy例外)。
  4. append在末尾添加一行,已32行返回ST_RANGE。replace替换指定行的label及全部数据。erase删除连续行并保持其余行相对次序。first/count合法当且仅当first<=rows且count<=rows-first;允许末尾空范围。每次成功append/replace/erase/clear/set将revision增加1,即使是空操作;其他操作不改变revision。
  5. get/set行列从0开始;shape返回行label及width。无效行列或范围返回ST_RANGE,非法值/宽度/必须的NULL参数返回ST_INVALID,先检查参数合法性,再检查索引范围。width=0时values允许NULL;width>0必须非NULL。失败不得改动任何输出,flatten的needed例外见第8条。
  6. stats汇总指定范围的全部有效单元,sum为int64_t;cells为单元数;空范围或仅空行时sum/minimum/maximum/cells全为0。
  7. select在指定范围内选行:每行分数为该行全部整数的和,空行得分0。仅考虑分数>=threshold的行,取最高分,分数并列取绝对行号最小者。找不到返回ST_EMPTY且不改output。
  8. rebuild创建指定范围的深拷贝;reverse为0保持行序,1反转行序,保留行内顺序与label;新表revision=0。必须非NULL output且*output==NULL,reverse只能为0/1。flatten按行序及行内顺序写连续值;总是先将needed设为cells,容量不足返回ST_RANGE且values数组不改。capacity>0时values必须非NULL;capacity=0/cells=0允许NULL。只定义实际cells长度的成功输出,尾部未使用空间无约定。
  9. cursor_begin将游标置于表首并记录revision。cursor_next依次返回每个有效单元的row/column/value,跳过空行;耗尽ST_EMPTY且不改三个输出。表revision与游标不一致返回ST_INVALID;游标状态只使用本API产生且未被调用者篡改的值。
  10. equal忽略revision和分配布局,比较行数、每行label/width/数据。check对合法表返回ST_OK,NULL返回ST_INVALID;不要求检测调用者伪造内部对象。全部必须的输出参数非NULL;合法stderr可含任意字节诊断,不属于结果协议。