Skip to content
Merged
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
40 changes: 40 additions & 0 deletions .agents/docs/2026-11-16-ecosystem-gap-supplement-part2-design.md
Original file line number Diff line number Diff line change
Expand Up @@ -813,3 +813,43 @@ mcpp-index)因前置条件就绪的时间不同,必须分批,批次在表
两个 NetBSD 行都能构建,x86_64 在 NetBSD 10.2 中运行并返回程序的状态。
- **本机验证(P10)**:六个行都能构建(含 `import std` 与异常);x86_64 的 FreeBSD、NetBSD、OpenBSD 经 dirun 0.6.0
运行,参数 `one "two three"` 原样到达,状态 7 返回。
- **选择器与平台定义的行**:`[target.'cfg(any(os = "netbsd", os = "openbsd"))'] platform` 被拒为未知目标:
早期选择只读以三元组为键的表。行被定义之前,选择器按三元组的字面成分(`<arch>-<os>[-<env>]`)求值(SPEC-013
§3.1,e2e 1040)。六张逐行的表因此是一张。
- **运行器的归属(经用户决定)**:运行器是什么由数据陈述(提供者、平台、构建程序,或替换它的工程与本机);是否使用
是运行者的许可(工程、本机、环境、`--runner`)。许可不写进平台引用 `platform = {...}`:平台可以来自索引的平台列,
内置行可以没有平台,本机可以只给许可。覆盖层增加 `runner = true | false`(即 `{ enabled = ... }`);拒绝消息
同时给出 `[target.'cfg(platform = "<名>")'] runner = true`(SPEC-013 §10,e2e 1092)。
- **#945 的原因与修正(经用户决定)**:第一次的修正(程序随 dev 依赖规划)被 CI 否定:dev 依赖的对象进入程序的
链接(`gtest_main`,graph/78),程序的规划不再与 `mcpp build` 相同(1069 的快速路径)。撤回。实际原因有两层:
一个包的两种配置(程序的默认、测试经 dev 依赖要求的 feature)共用一个构建目录,模块接口与对象按模块名与包名
命名,两次规划互相覆盖;构建程序的运行记录每包一份、输出目录每配置一份,配置交替时程序重跑并以新的时间重写
内容不变的生成源。修正:测试的配置不同于构建时(`[test] features`,或向本清单同时依赖的包要求 feature 的 dev
依赖条目),测试规划使用自己的构建目录(指纹的 `#test=` 轴);构建程序重写而内容不变的输出保留原时间。e2e
1107:每种配置编译一次,不变的运行、成员的测试与 `mcpp build` 不再编译。
- **UEFI 与 openkal DOS 上的整段脚本**:UEFI 的文件盘可写之后(dirun 0.6.0,ovmf 9.2.4-4),外部验证工程的整段测试
脚本在 UEFI 上运行到改名一步:openkal-uefi 以 `SetInfo` 的新绝对名改名,OVMF 的 FAT 驱动以 `EFI_ACCESS_DENIED`
拒绝;目录列举给出的名字不带扩展名(`f1.`)。openkal DOS 的栈改为 1 MiB 之后脚本运行到底,但子目录的列举为空。
三处属于 openkal-uefi 与 openkal-dos 的实现,不在本轮的条目中;外部验证工程在这两行上运行脚本中不写文件的部分,
并写明原因,作为下一轮的条目。
- **BSD 行的宿主(P10 的 CI)**:六个行在 Linux 宿主上构建并运行;在 macOS 与 Windows 宿主上全部失败,原因是宿主的
约定进入了行:macOS 上 Apple SDK 的头文件进入 std 模块的编译(FreeBSD)、libc++ 按宿主的 ctype 定义编译(NetBSD,
`_CTYPE_BL`)、Mach-O 链接器收到 ELF 选项(OpenBSD,`--disable-new-dtags`);Windows 上 sysroot 的头文件打不开
(NetBSD)、crt 对象找不到且程序名带 `.exe`(FreeBSD)。引擎的目标矩阵此前没有原生 FreeBSD 行,所以没有测到。
`mcpp.platforms` 0.1.0 的 CI 只在 Linux 宿主(x86_64、aarch64)上构建,文档写明宿主的范围;这些属于引擎,列入
下一轮(交叉构建由行而不是宿主决定)。
- **#945 在真实工程上(2026.11.17.1 发布之后)**:`mcpp build --workspace` 通过;随后两次 `mcpp test --workspace`
(148 个成员,llvm@23.1.3)各有一次构建失败,落在同一组(导入 GPU 模块、带构建程序的包):第一次 clang 在读取
模块时崩溃(`ASTReader::loadDeclUpdateRecords`,两处),第二次 ninja 以非零状态结束而不指名失败的步骤。其余失败
是本机无 GPU 时的测试本身。第二次运行仍有 136 个包有编译行,内容不变的重复运行本应没有。已排除:同一目录的并发
写(组依次构建,目录锁是每个打开文件描述的 `flock`)、另一工程经共享 BMI 缓存改写(缓存以改名发布,只向工程复制)。
与症状一致的原因是 ninja 的 ninja-build/ninja#2662:`Plan::EdgeFinished` 加载 dyndep 文件时使 `NodeFinished`
与 `EdgeFinished` 正在遍历的迭代器失效(1.12.1 与 1.13.2 均有,间歇出现于重建;修正 ninja-build/ninja#2840
未合入)。引擎已为缓存放置单独一遍;按目标构建(`mcpp test`)与 `-k` 的扫描在主遍中进行,构建程序重跑后各包的
动作节点不再是最新,扫描的 dyndep 文件因而在主遍的完成回调中加载,即该缺陷的条件。未经修正的 ninja 对照验证
(第二个构建目录约 9.5 GB,本机空间不足)。#945 保持打开;待定:带 #2840 的 ninja 包,或在主遍之前加载全部
dyndep;无论哪种,ninja 未指名步骤而失败时报告其退出状态或信号。
- **早期平台选择看到的谓词**:`[target.'cfg(c-abi = "musl")'] platform` 不匹配 `x86_64-macos-musl`,而
`cfg(env = "musl")` 匹配:平台选定之前,一行的 C 库是其平台将要陈述的。SPEC-013 §3.1 应写明早期选择可用的
谓词(三元组的字面成分)。外部验证工程以 `cfg(any(env = "musl", os = "openkal", os = "uefi"))` 选择
openkal-platform 0.29.1:引擎内置的默认(0.28.0)以 mcpp.plugins 0.20.0 构建,与 0.29.1 所用的 0.22.1 不能同处一次构建。
Loading