amos 4f17b2afe5 Batch 20 (20261027-C-family-20): map batch 15's ad-hoc families to canonical ones
210 batch-15 tasks used 119 ad-hoc family names. Each now carries one of the
canonical root-cause families (11 of the 19 are used), with version + 1 and a
spec.md note, and was recalibrated through both gates. Claude checked that only
family, version and spec.md changed, that every family is canonical, and the
new trace6 Docker receipts against current digests (210/210 USABLE).
Squashed from the 36-local branch batch20-family.

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
2026-10-27 05:58:17 +08:00

87 lines
9.3 KiB
Markdown
Raw Permalink Blame History

This file contains ambiguous Unicode characters

This file contains Unicode characters that might be confused with other characters. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.

# dev-stream-map 作者规格
## 身份、来源与范围
- task_id: dev-stream-map;version: 1;family: device-memory;language: C++17。
- 路线 C 原创,source: hwe/gi-cache-dma-streaming-map;来源组、split 分组键均为 gi-cache-dma-streaming-map。素材仅给流式映射每次交接的可靠性方向;本工程、初态、判据、样例均新写,不称真实事故。
- root 已完成来源预筛、基础/变体 heldout 与未用来源核验、本地/冷盘逐文件 SHA 核验。作者只读本题六个来源文件,未执行来源脚本,不从其他新题取代码。
- 状态 CALIBRATED;难度 UNMEASURED。双门后至多标 CALIBRATED,不含真实 Agent 试采或硬件验证。
## 软件替身准入与工程
确定性 Port 具有分离的 CPU/设备字节视图。固定方向决定两个交接的数据传播,设备操作只作用于设备视图,CPU 操作只作用于 CPU 视图。复用映射不会自动复制数据。端口所有权与原始视图共同观察每个 handoff、每次复用及最终释放,因此保留流式 DMA 的方向与每次生命周期知识点,不靠 printf 固定字符串、函数命名或源码模式判分。无真板、真实缓存指令、电气状态、真实时序、线程竞争、网络或性能依赖。
唯一提交文件 src/session.cpp。公开支撑包括稳定接口 include/stream.hpp、软件端口 src/port.cpp、只输出观测的 src/main.cpp、Makefile、合同和演示输入;它们逐字节冻结于私有 support.json。正式评分仅接收 candidate_files,在干净目录重新编译,绝不拿工作区构建产物作证据。替代实现可自由选择内部算法和数据结构。
模板独有有效代码按“非空且非注释行”的通常逻辑行计数,包含正常语法、声明和构建规则,不含样例复制倍数、纯数据、公开文档、判据或作者生成器:src/session.cpp 198、src/port.cpp 189、src/main.cpp 130、include/stream.hpp 118、Makefile 14,共 649 行。各模块分别提供服务生命周期、独立双视图/设备运算、请求解析/原始观测和公共接口;没有为行数加入填充逻辑。
## 缺陷与独立性
1. D1 复用交接遗漏:初态仅 completed==0 时将映射交给设备。第一轮 TX 可成功,第二轮 patch 后 B 返回 PORT,port.errors 增加且设备视图仍旧。默认 --demo 暴露此问题。only_fix_reuse 修复此条件但保留 D2,在首个 RX 完成时失败。
2. D2 RX 完成回收遗漏:初态在 FromDevice 方向跳过 CPU 回收,随后读取端口失败,设备视图已更新但 CPU 仍旧且所有权不归 CPU。默认 --demo 只有 TX,不触发 D2;公开 --receive-demo 和 examples/mixed.txt 暴露。only_fix_receive 修复回收但保留 D1,在默认第二次提交即失败。
两缺陷分别改变 begin 与 finish,分别有独立触发和只修一处的可构建反例。不是同一检查的参数变体。
## 判据检查项与公开依据
以下路径均相对 template/。证据表 20 行,逐条支持必需观察;隐藏的只是输入组合。所有 successful values、metadata 与 byte view 均只比较公开有效范围,未定义尾部不检查,stderr 不作为失败条件。
| # | 判据行为 | 精确公开依据 |
| --- | --- | --- |
| 1 | C++17 重建、单一候选、固定支撑、允许 stderr | docs/stream-contract.md:7;Makefile:1 |
| 2 | 四槽、96字节、整数域、新进程隔离与多槽并行 pending | docs/stream-contract.md:11;include/stream.hpp:11 |
| 3 | TX/RX/Both 方向、map 两视图初值、CPU idle 初态 | docs/stream-contract.md:13 |
| 4 | 每槽 generation/maps 与跨 remap 累计计数、全局 ticket | docs/stream-contract.md:13 |
| 5 | 字节生成公式及 32 位 FNV-1a | docs/stream-contract.md:15 |
| 6 | 每轮 begin/finish 所有权对、复用不重映射 | docs/stream-contract.md:17 |
| 7 | 两次 handoff 均使用原方向、按方向整区传播、计数/传播量 | docs/stream-contract.md:19 |
| 8 | TX只读、RX覆盖、Both先读再异或及范围外不被设备改写 | docs/stream-contract.md:21 |
| 9 | 六字段收据、前后摘要、禁用摘要为零、ticket仅成功消耗 | docs/stream-contract.md:21 |
| 10 | 状态码、错误无副作用、invalid-before-port 与 errors==0 | docs/stream-contract.md:25 |
| 11 | M 校验优先级、成功 generation values | docs/stream-contract.md:27 |
| 12 | W 绝对偏移、零长/终点、所有方向可写及优先级 | docs/stream-contract.md:29 |
| 13 | R 字节序列、边界、无副作用和优先级 | docs/stream-contract.md:31 |
| 14 | B 正长度、BUSY 优先、pending 限制及返回收据 | docs/stream-contract.md:33 |
| 15 | F 精确 ticket、跨代/重复/错误拒绝、保留 pending、返回CPU摘要与完成数 | docs/stream-contract.md:35 |
| 16 | U 仅 idle、计数保留、服务元数据归 absent | docs/stream-contract.md:37 |
| 17 | X 先完成再释放、返回数量、幂等空reset、ticket不重置 | docs/stream-contract.md:39 |
| 18 | manager/port字段布局、owner、absent清空与累计计数 | docs/stream-contract.md:43 |
| 19 | 只观察有效 length 字节、十六进制编码、unused尾部自由 | docs/stream-contract.md:43 |
| 20 | 原始端口与服务分别观测,不能用正确回复掩盖错误生命周期 | docs/stream-contract.md:45 |
判据 Python Model 独立从公开公式与状态机计算 917 条请求的期望,不调用 gold。包含默认演示、三方向×三长度×四轮复用、错票/旧代票/重复完成、零长度边界、部分范围、四槽交错、各状态错误优先级、反复映射释放、固定随机种子 0x5DA2026 的 420 个混合请求和最终 drain。公开 C++ driver 只解析输入、调用服务、打印返回与原始 Port 观测,没有隐藏断言或期望。
## 样例机制
| fixture | 预期 | 行为机制 |
| --- | --- | --- |
| gold | PASS | 固定槽数组保存完整映射状态及收据,完整遵循每轮方向交接 |
| template | FAIL | 两处独立缺陷原样初态 |
| noop | FAIL | B 直接成功但不执行工作;原始视图/收据立即揭示遗漏 |
| cheat | FAIL | 将 CPU patch seed 硬编码为默认演示的55;非演示数据捕获 |
| cheat_read_grader | FAIL | 仅能读父进程命令行中的私有check或/grader/check.py时执行gold,否则B不工作;本地无隔离可意外PASS |
| only_fix_reuse | FAIL | 只修 D1,RX方向完成仍失败 |
| only_fix_receive | FAIL | 只修 D2,第二轮映射复用仍失败 |
| mask_symptom | FAIL | 初态PORT错误改报OK;原始端口字节、计数、owner与收据照旧不符 |
| valid_table | PASS | 两张std::map分别管理映射ledger与活动收据,缺席即absent/pending,统一reap消费收据;reset逐表排空,区别于gold四槽数组+布尔状态;允许stderr诊断 |
所有fixture只有 src/session.cpp。正式校准检查每个样例均完成真实编译,负例不能以编译/链接失败充数。
## 执行边界与自审
verify.py 与 rollout/bos_verify.py 逐字节相同。grader_files 仅 check.py 与 support.json,无 isolation-blocked.txt。候选及编译器只能通过 subprocess argv 启动。所有输入、公开支撑与候选源码在第一个子进程前写完;之后父check只在内存中读取子进程输出,不触及候选可控目录。scratch根由包装器赋UID65534,不chmod该根;仅预先chmod自己新建子目录。最后用候选身份的/bin/rm清理,检查真实返回码,任何失败不输出PASS。没有 root 身份执行候选、导入候选、对共享目录执行隐式TemporaryDirectory清理或隐藏断言进入候选进程。
只读自审确认题面为现象报告,未点明根因;全部项目约定公开,判据与题面同口径;同源固定字符串/源码名检测未沿用。固定镜像内 gcc/g++/make 实际存在,未安装依赖。公开 make 与模板默认演示已实跑,模板在第二轮 B 暴露实际PORT错误。gold 正式包装器单次预检 PASS。本批全库unittest由root统一安排,本作者未执行。
## 校准事实与限制
正式本地回执:runs/20261023-C-hwe-scale-15/gi-cache-dma-streaming-map/local/calibration-16eb7296016b48f9b29d20f139d32c93/receipt.json。45次中仅cheat_read_grader无隔离而5次PASS为合同允许例外,整体真实FAIL原样保留;gold/valid各5PASS,其余各5FAIL;cleanup confirmed。
正式Docker回执:runs/20261023-C-hwe-scale-15/gi-cache-dma-streaming-map/docker/calibration-0a01010c415b4140b495c5ce14bd6c82/receipt.json。9类各5次,gold/valid各5PASS,全部7类负例各5FAIL,整体PASS;每次进程exit、cleanup confirmed。全部负例均因行为差异拒绝,无编译/链接失败。读取判据样例在Docker第1条B即被拒绝。core._calibration已按当前task/verifier/image与全部候选摘要核验通过。
当前task_digest:37d6becec76cfcc6c44f79527aa581a9f083c4fc92cbac321ae68592cb3cb6d6;image_id:sha256:1519f8daa403998e5401eeb70b973e8aac8346e25a937033bc502dc5de1641a1。逐个inspect本题45个container_requested名称均已不存在;未建网络。当前/home约87GiB可用,本题runs约2.3MiB,无disk_low/attempt_size事件。
无硬件验证、无Qwen/Pi、无真实Agent轨迹,难度仍UNMEASURED;root独立评审与集中全库unittest尚未进行。作者完成自审后停止供root审阅。
族名规范化:device-memory → device-io(2026-10-27)