After a top-up, batch 28 commit b7fd210 gave Mynewt FCB2 reverse alignment (2 of 3 valid attempts passed) and SPIFFS append error progress (3 of 4) as MEDIUM. Each task comes from the commit Qwen measured, its digest matches, and it is still present at the batch branch head. Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
9.3 KiB
fs-spiffs-append-error-progress 制题规格
状态:CALIBRATED;真实模型难度 UNMEASURED。仅软件行为,未做板卡测试。
来源路线为真实开源修复;上游 https://github.com/pellepl/spiffs ,来源 ID oss/pellepl/spiffs@24aac903c05c,split_group pellepl/spiffs,family resource-lifecycle,C99/POSIX。冻结为 1d9f6707407ea2c9486d1cf12bbc2ba8a877839c,两独立修复为 24aac903c05c30f4588af962168108953ad758ec 与 7bf5d772f050460a369f42a3cc7bb7ff618551c5。许可证 MIT,完整 LICENSE 和源文件原始版权头保留,无额外 NOTICE。没有复制旧平台或上游新增的测试。
两组改动在同一冻结均仍有原缺陷,分别应用也仍被另一个行为族拒绝。第一修复涉及真实 SPIFFS_write 和 SPIFFS_eof:追加写入的位置报告与未写空文件 EOF。第二修复涉及真实 SPIFFS_write 的五个错误出口、SPIFFS_lseek 的无效句柄出口和 SPIFFS_vis 调用 SPIFFS_info 的顺序。后者从五月提交的 diff 中按每个原上下文逐 hunk 应用到三月冻结,只应用该提交改动,未复制五月整文件。原始 patch、原始冻结摘录、逐 hunk 生成脚本与摘要存于本题 subagent 目录。
候选仅 src/spiffs_hydrogen.c。gold 只包含该文件,并且等于两上游候选 diff 的组合。公开工作区没有 .git、修复提交号、历史测试、issue 链接、私有判据或修复提示。正常路径 smoke 不使用追加、EOF 或故障注入。
冻结文件逐项如下:
| 文件 | 性质 | 用途 |
|---|---|---|
| LICENSE | 上游冻结 | MIT 授权文本 |
| src/spiffs.h | 上游冻结 | 公开 API、配置与标志 |
| src/spiffs_nucleus.h | 上游冻结 | 内部存储结构与层间接口 |
| src/spiffs_hydrogen.c | 上游冻结 | 完整公开 API 与候选 |
| src/spiffs_nucleus.c | 上游冻结 | 完整页查找、分配、对象修改、追加及 flash 调用 |
| src/spiffs_cache.c | 上游冻结 | 真正的读缓存与写缓存管理 |
| src/spiffs_gc.c | 上游冻结 | 真正的回收与空间分配 |
| src/spiffs_check.c | 上游冻结 | 完整一致性检查,链接公开 API 所需 |
| src/default/spiffs_config.h | 上游冻结 | 原始可配置开关与移植约定 |
| port/params_test.h | 补全 | 固定宽度整数、通用 OS 互斥宏 |
| port/flash.h | 补全 | 内存 flash 移植入口声明 |
| port/flash.c | 补全 | NOR 原语、初始化和一次性普通 I/O 错误注入 |
| Makefile | 补全 | GCC/POSIX 离线构建 |
| smoke.c | 补全 | 普通直接读写健康检查 |
| README.md | 补全 | 工作区入口 |
| docs/api-contract.md | 补全 | 根据上游 API 与移植合同整理的公开行为 |
16 个 template 文件,单文件均小于 1 MiB。真实源码保留 mount/open/read/write/cache/alloc/flash 完整调用链;五个上游 C 文件共 5036 行,去除注释和空行后 3910 行,未用大块无关示例凑数。补全只实现 flash 物理读、按位编程、擦除、互斥进入退出和配置,没有替候选计算追加位置、EOF 或维护错误清理。
判据由 check.py 加 support.dat/observe.c 组成;verify.py 与 rollout/bos_verify.py 原样一致。support.dat 冻结 template 中非候选文件,候选文件仅从本次候选快照读取。check 先准备全部 scratch 源、目录与输入,再分别构建有缓存和完全关闭缓存的可执行程序。编译器及运行程序均是包装器降至 UID 65534 的子进程。observe.c 只执行输入中的公开 API 并打印原始结果,所有期望数据和比较位于父 check。首个 compiler 子进程后父 check 不访问或清理 scratch,正常及异常路径均无 TemporaryDirectory 上下文;仅信任子进程管道输出。scratch 随无网只读容器的 tmpfs 退出销毁。
第二修复原测试新增 test_lock/test_unlock 并在测试收尾检查锁计数;本题将其改写为错误返回后实际调用其他公开 API 的进展观察,不复制计数断言。
通用 OS 原语使用 POSIX PTHREAD_MUTEX_ERRORCHECK。无法再次进入时仅打印 OS 返回值并退出,形成确定的“后续 API 无法完成”观察;不通过真实时序判断,不比较锁调用次数,不读 fdoffset 等私有布局,不代替 SPIFFS 归还锁。缺少后续 API 结果即拒绝候选。NOR 故障只在普通 HAL 物理写边界返回负数,不构造 RAM 故障或修改候选内存。故障后要求其他文件的读写和容量查询继续,未要求失败文件的回滚或数据原子性。
判据检查项与公开依据:
| 检查项 | 工作区依据 | 上游来源依据 |
|---|---|---|
| 初始化、格式化、挂载成功 | docs/api-contract.md:5 | src/spiffs.h 配置、mount/format 注释 |
| 创建、读写打开、关闭 | docs/api-contract.md:6 | src/spiffs.h:146 附近打开标志与 close 注释 |
| 写返回字节数,读出已写内容,I/O 错误负值 | docs/api-contract.md:7 | src/spiffs.h:415 的 read/write 注释与 HAL 类型 |
| 定位后仍追加在原内容后,全部内容保留 | docs/api-contract.md:8 | src/spiffs.h:146 的 SPIFFS_APPEND 注释 |
| 每次追加后 tell,flush 前后位置一致 | docs/api-contract.md:9 | src/spiffs.h 的 tell 与 write 公开注释 |
| 空文件 EOF 与非空文件首、中、尾状态 | docs/api-contract.md:10 | src/spiffs.h 的 eof/tell 注释与空文件语义 |
| SET/CUR/END 的返回位置与后续读取 | docs/api-contract.md:11 | src/spiffs.h:436 的 lseek 注释及 seek 常量 |
| fflush/close/reopen 后内容和位置保持 | docs/api-contract.md:12 | src/spiffs.h 的 fflush/close 注释 |
| 非追加中段覆盖保留后缀 | docs/api-contract.md:13 | src/spiffs.h 的 read/write/lseek 组合语义 |
| 页大小 128/256/512、DIRECT、缓存启闭相同语义 | docs/api-contract.md:14 | src/spiffs.h:158 和 src/default/spiffs_config.h 缓存开关 |
| 只读写入、关闭句柄写入及定位报错 | docs/api-contract.md:15 | src/spiffs.h 的 SPIFFS_RDONLY、FILE_CLOSED/BAD_DESCRIPTOR、lseek 错误合同 |
| 句柄和普通物理写错误后,其他 API、其他文件可继续 | docs/api-contract.md:16 | src/default/spiffs_config.h:133 的 API 层互斥合同;负错误返回合同 |
| info 返回估计容量与已用范围 | docs/api-contract.md:17 | src/spiffs.h 的 SPIFFS_info 注释 |
| OS 错误仅通过未完成公开 API 的观察判失败 | docs/api-contract.md:18 | src/default/spiffs_config.h:133 进入和退出 mutex |
| 一次性 flash 写故障与取消语义 | docs/api-contract.md:20 | 补全 port/flash.h 与 port/flash.c 已公开合同 |
254 个确定场景:缓存关闭/开启、128/256/512 字节逻辑页、普通/直接追加、1 字节与跨页写入、缓存边界、flush、关闭重开、中段覆盖、SEEK_SET/CUR/END、未写空文件、关闭句柄错误、只读写错误、直接写/大写/缓存边界 flush/缓存大写/写缓存资源不足回退中的物理写失败。每个 I/O 场景逐一改变前 12 次物理写中的故障位置,父 check 允许返回负错误或成功完成请求,不绑定内部物理写次数;两种情况下均要求后续公开操作完成。gold 预检实际出现 84 个负 I/O 返回场景。第二组修复每个被评分的 write/lseek 分支均属于上述公开行为;不检查内部变量。
样例共 9 类:gold PASS;valid_write_position PASS;template/noop/cheat/cheat_read_grader/only_append/only_error_progress/mask_empty_eof 均 FAIL。only_append 仅第一组上游修复;only_error_progress 仅第二组;mask_empty_eof 仅令新建空文件看似正常;noop 忽略写操作;cheat 恒定 EOF;cheat_read_grader 在低 UID 子进程探测 /grader 与父进程路径,读不到时退出,不能靠参考实现通过。valid_write_position 使用真正选定的写目的地址更新位置,并为写失败设置统一退出位置,与上游“写前重置当前位置加解锁宏”的写法不同。
限制:固定 Docker 原始观察确认,上游 gold 在两次未刷新缓存的连续追加写 7/13 字节后,内容可读 20 字节,但 tell 为 13、EOF 为假。这是上游修复残留,未人工扩大 gold 补丁;公开 R04 以平常条款界定应用在相邻追加之间调用 tell/eof/fflush 提交缓存的范围,判据只接受该已公开范围内的行为。原始记录见 runs/20261103-D-oss-fix-28/spiffs-append-error-progress/raw-ef0c3a13078e489181c180190827953e/raw.stdout。
未对 SPIFFS_vis 评分。冻结公开配置只说 enter/exit a mutex,并无明确要求应用锁必须可非递归;因此不把该组合要求加入交付或判据。gold 保留该真实修复 hunk,样例通过不代表该分支经过行为测量。未验证持久硬件、掉电原子性、并发吞吐、全部 SPIFFS API 或真实 Agent 难度。模型服务与凭据均未使用。校准只证明此行为判据和样例区分成立。
最终固定 trace6 Docker 校准:runs/20261103-D-oss-fix-28/spiffs-append-error-progress/calibration-0be302c988484d31a15fd851f9e605dd/receipt.json,9 类各 5 次共 45 次全部符合预期,整体 PASS,cleanup confirmed。任务摘要 9d970419a9e0ac72612ec7f39e8c8ab71f21426e828bdf63bbb0f9cf0968cd07。此前预检和旧公开合同摘要的校准原件均保留,不作为最终版本的校准身份。每容器启动前的双盘容量、完整实际 argv 和唯一精确名都已另行持久落盘;具体目录见 subagent/report.json。