# CADFS 全量能力闭环目标

## 目标

将 CADFS FeatureScript 的完整建模历史通用地转换为 CDSL，再由 CDSL engine
重建 STEP。目标不是让少数代表模型通过，也不是为某个样本拟合最终 STEP；目标是
补齐当前 CADFS 全量语料实际出现的所有建模语义，使每个可比较模型都能以完整
feature history 生成工程相似的 STEP。

工程验收使用 `comparison.json.rp.passed == true`：双向 surface max/p99 与 bbox
不超过 `0.02 mm`、体积和面积相对误差不超过 `0.005`、实体数相等。`strict` 的
`0.01 mm` / `1e-5` 阈值保留为高精度诊断，不能因严格失败而隐藏已工程相似的模型，
也不能因生成 STEP 就把几何错误的模型标为成功。

本文件的范围是
`output-history/20260907-235209` 的 9,347 条历史快照。后续重新扫描全量数据时，
必须以新快照的真实样本数和能力矩阵更新本文件及本地能力台账。

## 不可妥协的实现原则

这是绘图引擎和通用 converter，不是样本修复脚本。每项能力必须由 FeatureScript
语义、CDSL contract 和内核拓扑共同定义，并对同类输入普遍成立。

- 禁止以 `sample_id`、文件路径、特定尺寸、特定坐标、特定 feature ID 或 gold STEP
  测量值驱动行为。不得为让单条样本通过而植入分支、偏移量、默认 profile 或 selector。
- 不得读取原 STEP 来补齐 FeatureScript 未提供的参数、反推 CDSL 尺寸或决定建模策略。
  原 STEP 只用于最终比较、诊断和已验证的 source exception 证据。
- 不得把未知语义降级成任意盲拉伸、默认 union、任意当前 body、任意相近 face/edge
  或静默跳过。无法唯一表达或绑定时必须保留可执行前缀、输出明确诊断，并记录能力
  缺口。
- 优先扩展显式 CDSL schema、typed runtime state、body graph 和 kernel-level topology
  delta；不得以 parsing/lowering 层的临时重写替代应由 runtime/adapter 承担的几何语义。
- 允许针对几何类别采用受限算法，但适用前提必须由通用的、可验证的几何条件表达，
  并有正向、反向和边界测试。条件不满足时必须拒绝并诊断，不得猜测。
- 若已有实现反复依赖样本化补丁、不能表达已出现的通用语义或受内核 API 结构性限制，
  必须评估替代方案，不得沿错误方向继续累积补丁。替换需要可复现根因、成熟实现或最小
  原型的对照、contract/迁移影响评估和回归计划；单个样本或偶发内核失败不足以触发重写。
- 每项能力必须同时具备：FeatureScript lowering、CDSL schema/semantic validation、
  runtime/adapter 实现、selector/body 语义、单元测试、多个语料回归和比较工件；缺少
  任一层只能标记为“部分完成”。

## 全量基线

历史快照的主要操作和当前能力缺口如下。数量是出现次数或受该缺口阻塞的模型数，
只用于排序，不代表一个操作只有一种语义。

| FeatureScript 操作 | 历史出现次数 | 当前主要缺口数 |
| --- | ---: | ---: |
| `newSketch` | 20,857 | 草图/工作平面诊断 7,043 |
| `extrude` | 18,168 | 3,600 |
| `fillet` | 5,210 | 1,904 |
| `revolve` | 2,087 | 662 |
| `chamfer` | 1,818 | 588 |
| `cPlane` | 1,620 | 168 |
| `hole` | 1,203 | 582 |
| `shell` | 729 | 696 |
| `mirror` | 483 | 241 |
| `transform` | 468 | 252 |
| `sweep` | 378 | 326 |
| `loft` | 377 | 107 |
| `circularPattern` | 252 | 139 |
| `booleanBodies` | 228 | 187 |

已发现的派生 profile / topology 语义必须单独覆盖，不能合并为笼统的 `extrude`
或 `loft` 支持：

| 语义 | 历史缺口数 |
| --- | ---: |
| `extrude_profile_topology:intersect` | 383 |
| `extrude_profile_topology:cap_face` | 201 |
| `extrude_profile_topology:cap_edge` | 134 |
| `extrude_profile_topology:swept_face` | 99 |
| `extrude_extent:up_to_surface` | 100 |
| `loft_profile_topology:cap_face` | 30 |
| `extrude_profile_topology:offset_face` | 18 |
| `extrude_profile_topology:swept_edge` | 16 |
| `loft_profile_topology:swept_face` | 9 |
| `extrude_extent:up_to_vertex` | 7 |
| `extrude_surface_or_mixed` | 4 |
| `extrude_extent:up_to_body` | 2 |
| `extrude_profile_topology:mid_cap_edge` | 2 |
| `loft_profile_topology:cap_edge` / `cap_vertex` | 1 / 1 |

历史报告还记录了 1,335 个未支持操作诊断。当前已知的 P2 操作包括 `draft`、
`thicken`、`split`、`moveFace`、`deleteFace`、`replaceFace`、完整 `transform`、
`derive`、`import` 和 `bend_add`。重新扫描时必须从诊断原文生成完整操作清单；
未列出的新操作不能被静默归入已有能力。

## 覆盖模型

每一项能力的回归选择必须覆盖下面五个维度，而不是只覆盖操作名称：

1. 操作和参数：operation mode、实体/曲面模式、extent、方向、offset、draft、
   角度、数量、终止条件和 result mode。
2. 几何输入：直线、圆弧、圆、椭圆、B-spline、开口/闭合 wire、多 region、孔洞、
   退化和自交拒绝路径。
3. 拓扑来源：原草图、`CAP_FACE`、`CAP_EDGE`、`SWEPT_FACE`、`SWEPT_EDGE`、
   `OFFSET_FACE`、`INTERSECT`、`MID_CAP_EDGE`、`COPY` 和 boolean 后继。
4. body 生命周期：`NEW`、`ADD`、`REMOVE`、`INTERSECT`、keep tools、copy、
   transform、delete、mirror、linear/circular/nested pattern、多实体输出。
5. 比较状态：strict、RP、实际几何拒绝、conversion defer、runtime ineligible、
   rebuild failure、comparison timeout 与 source exception。

维护三个固定层级的回归集：

| 层级 | 用途 | 通过条件 |
| --- | --- | --- |
| 原子语义矩阵 | 每个 operation/参数/拓扑/body tuple 的最小合成模型 | CDSL contract、可执行性和精确几何断言。 |
| 核心 17 | 跨能力的稳定烟雾回归 | 完整 history、工程相似或有归因明确的 source/comparison 证据。 |
| 扩展 100+ | 每个已出现 tuple 至少多个真实语料样本 | RP 工程相似率、失败诊断和能力覆盖均可追溯。 |
| 全量 9,347 | 完整发布前的能力验证 | 每条都有完整分类；支持的完整 history 均工程相似，剩余项仅能是有证据的 source exception 或未实现 capability。 |

扩展集必须从能力矩阵自动选择并保留历史失败样本。修复能力后应扩大相应 tuple 的
样本数；不得因当前失败而从 manifest 中移除样本，也不得以新的贪心选择替换已有
反例。

## 实施路线

### 开源实现策略

每个新的内核级能力在自研前，先检查官方 OCCT/OCP API、项目现有依赖和成熟开源实现。
本地首选参考是 `/Users/lk/Downloads/SimpleCADAPI-master 4`：其
`topology/tracking.py` 保留 OCC builder 的 `Modified`、`Generated`、`IsDeleted` 和
section-edge 历史，`ocp_booleans.py` 展示了保留 history 的 boolean 与 same-domain
cleanup，其他 kernel/operators/tests 覆盖 transform、shell、sweep、loft、fillet 和
chamfer。这些实现对 P0 topology delta、body provenance 和 P2 feature adapter 具有
直接参考价值。

采用外部方案时必须确认许可证、OCP/OCCT 版本和异常语义，并将算法适配到本项目的
CDSL contract、body graph 和 selector resolver。SimpleCADAPI 强制单一 `Solid` 的
boolean helper 不能直接使用，因为 CADFS 需要独立 body、copy、keep-tools 和 pattern
instance 生命周期。每项采用或拒绝外部方案的决定、理由和回归证据都记录在本地能力
台账；不得不经评估地复制代码，或为复用外部 API 破坏现有 contract。

### P0：通用几何状态和拓扑基础

1. 建立显式 body graph：feature 输出 body ID、result mode、copy、transform、delete、
   keep tools、pattern instance 和多 body 聚合语义。当前可用的受限增量是以 source
   feature body 为输入的 rigid translation/rotation 与受限 non-rigid uniform-scale
   `transform_bodies` / `delete_bodies` contract；它不能
   代替 fused body 或 pattern instance 的完整 provenance，后两者在唯一性未证明时
   必须诊断而不能退化为 current body。capability preflight 已镜像 runtime 的显式
   body-member 生命周期：fused/dress-up 输出、boolean 消耗、delete 和 pattern replay
   会撤销旧 member 的可选资格；只有 `new_body`、`keep_tools`、明确 transform 输出，或
   经 sole-body lineage 已证明的 current successor，才能被后续 body query 选中。受限的
   `pattern_circular` 现在可对所有 source 都是明确可选 member 的 `NEW` additive body，或
   一个 direct `SWEPT_BODY` 经该 sole-body successor 保留的 current member，以
   `pattern_feature_id` / `source_feature_id` / `instance_index` 记录 direct COPY
   member；后续 `transform_bodies` 可精确引用该 COPY 而无需写入 runtime ID。CADFS 的
   direct `SWEPT_BODY` transform 现可将 `TRANSLATION_3D`、rotation，以及单一线性
   sketch/`CAP_EDGE` 或有 physical cap frame 的 direct `CAP_FACE` direction 的非负
   `TRANSLATION_DISTANCE` lower 为同一刚体 contract。系统 datum plane、已显式 lower 的
   reference plane，以及能由 direct planar source 唯一构成 frame 的 `SWEPT_FACE` 也可提供该
   direction；圆柱/曲面 `SWEPT_FACE`、`SWEPT_EDGE`、OFFSET/COPY face 和没有可证明 frame 的
   plane query 继续诊断而不猜测。`SCALE_UNIFORMLY` 在 factor 有限且为
   正数、scale point 是 Origin、direct sketch vertex（含 circle center）或 direct
   `CAP_VERTEX` 时 lower 为显式 `uniform_scale` body transform，不烘焙回草图。`TRANSLATION_ENTITY` 在 direct source
   仍是可选独立 body 时接受一个线性
   sketch/`CAP_EDGE` 的端点差或两个 sketch/`CAP_VERTEX` 的有序点差；move 的 bake path
   另要求 source 是紧邻的 `NEW` body。对于 exact single-source `makeCopy` transform，
   后续 `COPY(instanceName=1)` body/line/vertex 可递归验证其 `derivedFrom` 链并引用已生成
   body member；对于前序 direct multi-source `makeCopy`，CDSL 以
   `transform_copy_refs(transform_feature_id, source_feature_id)` 表示被查询的唯一直接 source，
   runtime 分别物化各 source 的 transformed member，aggregate 只用于 STEP 导出且不伪造
   topology owner/delta。schema、semantic validation、capability preflight 和 runtime 都要求
   owner 是 preceding multi-source `make_copy:true` transform，且 source 是该 transform 的
   直接选择项；single-source、source 外、fused、pattern 和无源限定的 aggregate reference
   一律拒绝。无位移的 direct `TransformType.COPY` 以显式 zero translation 与
   `make_copy:true` 产生一个独立 identity body member，绝不将其写成 non-copy successor
   alias。CAP edge/vertex 的 source-local in-plane coordinates 保持 profile frame，
   仅映射到 selected physical cap origin。face、
   generic face、swept/offset、pattern 或未证明 COPY/curve direction、多个 direction、已吸收 body 与其它非刚体
   transform 仍必须明确诊断。对于已证明只有一个 CADFS body 的受限 lineage，direct
   `SWEPT_BODY` 可从初始 `new_body` 经 ordinary fusing add、单 body fillet/chamfer/shell
   与 exact non-copy transform 续接到当前 CDSL member；cut 保留所选 member，因而不虚构
   一个 cut successor。直接 circular ADD 且 source 唯一等于该 current member 时保留这份
   证明，并以该成员的实际 B-rep 物化每个 COPY instance；第二个 `new_body`、`make_copy`
   transform、boolean、其它 pattern、delete 或任何未列出的 body atomic 都清空它。它绝不以
   aggregate/current body 兜底，
   也不为 linear/nested pattern、被排除 instance 或无明确 source member 建立 ownership。
   唯一新增的
   mirror 例外是：直接 `pattern_mirror` 的每个 source 都仍为可选的
   `result_mode: new_body` member 时，runtime 以实际 B-rep mirror 物化其唯一的
   `instance_index: 1` COPY member；CDSL semantic validation、capability preflight 与
   runtime 都要求这一完整条件。普通 additive/cut/dress-up 后继、已吸收 source、linear
   或 nested mirror 仍走 feature replay，不能借该例外暴露 aggregate member。
   本轮 327 条 transform shard 中 `00120430`、`00496729`、`00749755` 因该 provenance
   rule 完整 lower；只有 source 在 mirror 前未被后续 mutation 吸收的 `00749755` 可执行到
   RP `rebuilt_approximate`，另两条保留 `runtime_ineligible` 和已有前缀/诊断，绝不以
   converter 完整状态冒充 runtime 或相似通过。新增的 multi-source COPY path 令 `00699847`
   的 F3 两源 copy 和 F4 的 source-qualified F3/F1、F3/F2 queries 完整 lower，强制
   pipeline 为 `rebuilt_strict`；`00950564` 证明 F1 的 direct `SWEPT_BODY` 在 F3/F5/F7/F9
   ordinary add 和 F10/F11 chamfer 后精确 lower 为 F12 的 `source_feature_ids:["f_F11"]`，
   不引用 current aggregate。`output/single-body-successor-20260909` 的完整 history 为
   `converted_complete`、runtime eligible、8/8 feature executed、`rebuilt_approximate`；
   RP 通过（bbox delta `0`，体积/面积相对误差 `0.00011913` / `0.00016132`，实体数 `1`）。
   strict 仍因 max/p99 surface `0.01 mm` 与体积/面积阈值失败而保留为诊断。单元测试还覆盖
   copy、boolean、pattern 与 delete 均清空 lineage；没有能唯一表示的 nested source-member
   chain 仍属未完成 contract，继续保留明确诊断。
2. 在 adapter 层记录每次建模操作的 `preserved`、`modified`、`generated`、`deleted`
   topology delta 及 CAP/SWEPT/boolean 等输出角色；runtime 以该记录完成后继 selector
   绑定，不以“当前形状中最相近元素”猜测。当前增量已覆盖 OCC 刚体
   `transform_bodies`（含 OCP `gp_Trsf.SetScale` 的 uniform scale）、单实体
   `boolean_bodies` 的 union/subtract/intersect 以及 direct
   single-body fillet/chamfer，以及单一 selected solid 的 `shell`：adapter 返回 opaque
   kernel relation，registry 只在 source/result snapshot 的 exact relation 唯一时传递
   owner 和 successor，并在 rebuild 输出 `topology_deltas`。shell 沿既有
   `BRepOffsetAPI_MakeThickSolidByJoin` builder 的 `Modified`、`Generated`、`IsDeleted`
   历史记录 delta；未返回 `IsDeleted` 的内核输入不会被虚构为 deleted。该受限 shell path
   还记录可由 source subshape 和 kernel event 证明的 `shell.body_face`、
   `shell.offset_face`、`shell.closing_descendant` 和 `shell.wall` evidence role。当前
   `shell.offset_face` 只有一个受限 lowering consumer：紧邻 shell 后续的 shell face query，
   且 FeatureScript 以 `TDD`/`trueDependencyDisambiguation` 明确指向前序 direct `new_body`
   blind-prism 的 `extrude.start` 或 `extrude.end`。CDSL 以
   `output_role_source(owner_feature_id, output_role)` 保留此关系；registry 只接受 exact
   kernel-history relation 的唯一 active snapshot，不能以相同 geometry、bare offset role 或
   任意嵌套 CAP query 替代。它仍不是可 lower 的通用 CAP/SWEPT/OFFSET query。多个 Compound 成员时只有被选中实体的同一
   builder 可以产生 delta，其他未改成员继续依赖 body graph 的精确等价。多实体 boolean、
   非 direct-builder dress-up fallback、复杂 sweep/loft history 及 CAP/SWEPT/section
   query roles 仍属未完成范围。受限的单闭合无内环 profile、无 guide/transition 的 direct
   solid sweep 在 initial 或 `new_body` final member 上，会记录
   `BRepOffsetAPI_MakePipeShell.FirstShape/LastShape` 的 `sweep.start`/`sweep.end`
   evidence；受限的 initial closed-wire solid loft 会记录
   `BRepOffsetAPI_ThruSections.FirstShape/LastShape` 的 `loft.start`/`loft.end` evidence。
   后续 fuse 会重建 topology，因此不复用已经失效的 sweep/loft builder history。当前
   CDSL `selectorRef.output_role` 现公开 direct-prism `extrude.start`/`extrude.end` 与四个
   sweep/loft direct-builder cap role；registry 只会在
   relation 的唯一 result snapshot 上写入 `TopologyRecord.output_roles`，resolver 要求
   owner、active body snapshot 与唯一 role 命中，并拒绝 stable ID、geometry、snapshot ID
   混用。CADFS lowering 现对独立 `new_body` blind prism 的 CAP_FACE，以及满足全部条件的
   `LocOpe_DPrism` drafted extrusion 生成该 contract：单一闭合外环、无内环、单向 blind
   extent，且拉伸方向与实际端盖法向同向。`extrude_from_face` 直接拉伸该 B-rep 面，不能把
   CAP_FACE 还原为原始草图。registry 只会让唯一 OCC `modified`/`preserved` relation 跨
   boolean 删除成员后的 Compound member-index 改变继续传递 owner/output role；几何回退仍按
   member index 隔离，绝不以相似性跨成员继承。该路径不覆盖 drafted 内环、fused/multi-region/
   multi-extent/loft/sweep/pattern 或一般 CAP_FACE，故 `CAP_FACE`/`SWEPT_FACE` lowering 仍为
   部分完成。`00016195` 的 F1 -> fillet -> F3 和 `00835610` 的 drafted F3 -> F4 subtract ->
   F5 都是正例；后者为 `converted_complete` / `rebuilt_approximate`，9 个 feature、3 个实体，
   RP 通过（bbox delta `0.0008 mm`、体积相对误差 `0.00020848`、面积相对误差
   `0.00021742`）。`00268467` 的 drafted 内环则明确保留 capability diagnostic 和可执行
   前缀，不伪造可绑定 selector。
3. 建立统一 selector resolver：owner body、source feature、output role、几何签名、
   snapshot 和唯一性证明。找不到或多解必须稳定诊断。
4. 完成草图 region/wire 模型：多轮廓、内环、开口 reference geometry、B-spline/ellipse、
   profile query、显式 construction 和退化检测。
   非周期 `skFitSpline` 的两点受限变体现已贯通：仅当端点不同、同时给出两端导数，且
   CDSL 显式携带严格递增的参数域时，lowering 才以真实的 two-point B-spline 输出；它
   绝不退化为直线。schema、semantic validation、sketch solver 与 adapter 共同拒绝缺失
   导数/参数、周期两点和重合端点。solver 以参数域上的 cubic Hermite 采样检查闭环面积，
   adapter 仍把端点切线与参数交给 OCP 插值，而非近似多段直线。历史快照中 453 个此类
   entity 都带两端导数；当前 10 条历史反例矩阵的 9 个可生成候选保留了 18 条该曲线。
   该增量只完成此一 profile contract，不覆盖由 `INTERSECT`、`CAP/SWEPT` 等拓扑查询
   派生的 profile，也不把后续 dress-up 或内核失败误记为 spline 成功。

### P1：派生 profile 与拉伸终止

1. 用 P0 topology registry 通用重放 `CAP_FACE`、`CAP_EDGE`、`SWEPT_FACE`、
   `SWEPT_EDGE`、`OFFSET_FACE`、`INTERSECT`、`MID_CAP_EDGE`，将其物化为可追溯的
   profile/wire，而不是复用原草图或写入样本特例。现有 direct-prism，以及单闭合无内环、
   法向同向的 `LocOpe_DPrism` draft CAP_FACE，是受限例外：它们以 builder-proven output
   role 直接消费物理 B-rep 面，未试图物化或重建 profile。
   `OFFSET_FACE` 现有一个独立的受限 profile 物化路径：只有 inward shell 直接消费一个
   `new_body` blind additive prism，shell 恰移除该 prism 的一个 CAP，且 OFFSET query 恰指向
   其未修改、单闭合凸线性 profile 中的一条非 construction line，lowering 才根据 source
   profile 的相邻边 offset 交点、shell thickness、实际 start/end cap frame 构造四边内壁。
   它不复用整张 source sketch，也不从 STEP 反推 trim；draft、cut/fused/multi-body source、
   多 removal cap、曲线/凹/多 contour profile、多个 source edge 和非正交 span 都保留
   `extrude_profile_topology:offset_face` 诊断。`00789939` 的 F15 是严格通过的完整 history
   正例；`00588094` 的非直接 provenance 则保持 partial conversion 和五 feature executable
   prefix，后续 F15 的 output-role binding failure 仍单独报告。`output/offset-face-linear-wall-20260909-r3`
   记录前者 strict/RP 通过；当前 26 条含 `OFFSET_FACE` history 的受控 shard
   `output/offset-face-profile-shard-20260909-r1` 为 1 strict、17 rejected、7 rebuild failure、
   1 deferred-no-executable-feature，仍有 17 条明确的 `extrude_profile_topology:offset_face`
   gap。`output/core-17-offset-face-linear-wall-20260909-r2` 为 4 strict、3 RP、9 rejected、1
   comparison timeout，故这仍是派生 profile 的部分完成项而非 general OFFSET replay。
   对 CAP_EDGE，现有的受限 outer-profile 规则还会递归展开仅由 `qUnion` 构成的关联嵌套，
   再要求恰有一个原始闭合 IMPRINT 外 region 和一个唯一 CAP_EDGE-derived IMPRINT region，
   并由两个明确 face-side 判断完整外 region 或外环加孔。该展开只消除 FeatureScript 局部
   alias 引入的集合包装，不改变 query provenance，也不放宽 owner、曲线或 side 的唯一性。
   `00950564` 的 F3/F5 是这一语义的真实证据：两个 CAP_EDGE profile 都完整 lower，F1--F12
   history 也因上述单 body successor rule 完整执行并 RP 通过。它不覆盖一般 CAP_EDGE、CAP
   edge 物理重放、COPY/boolean/pattern 后继或未证明的 region 选择。双向 blind extrusion
   同样沿用单向 CAP 顺序：`isStart:true` 是主方向的反侧端盖，`isStart:false` 是主方向端盖；
   因而 second depth 趋近于零时保持同一 contract，不按 primary/reverse 字段名称猜测。
   `00247322` 的 F4 以 `z=40.3 mm` 的反侧 cap 附着 F6，F5 后该 F4 owner 仍有唯一
   continuation，F7 的 CAP_EDGE hole profile 可执行。后续 F9 选择已被 F5 消耗的 F4 member，
   故保持 `body_source_unavailable`，不烘焙 transform 回 F4 草图或替换为 aggregate body。
   刷新的 `output/cap-edge-two-sided-frame-matrix-20260909` 三样本矩阵为 1 个
   `rebuilt_approximate`（`00950564`）、1 个 `rebuilt_rejected`（`00803284`）和 1 个
   `runtime_ineligible`（`00247322`，但 F1--F7 prefix 可执行）。共享 lowering 的固定核心
   17 工件 `output/core-17-two-sided-cap-frame-final-20260909` 分类为 3 strict、3 RP、9 rejected、
   1 rebuild failure、1 comparison timeout，与此前共享基线一致。受控全量 24 条 shard
   `output/full-shard-two-sided-cap-frame-20260909` 记录 1 strict、2 RP、10 rejected、6 rebuild
   failure、3 runtime-ineligible、1 timeout 和 1 无可执行 feature；其 conversion diagnostics
   仍归因为已有的 `cPlane`、CAP_EDGE、fillet/chamfer、hole、revolve 与 shell selector 缺口，
   没有将它们重分类为双向 CAP frame 成功或失败。
   `INTERSECT` 的第一条通用受限路径现以 CDSL `planar_imprint` 保存同一草图的原始
   analytic entities、IMPRINT 面侧、可选 INTERSECT vertex order 与 fragment side；solver
   仅转换这些精确曲线，adapter 用 OCP `BOPAlgo_Splitter` 切分有界 support face 后选取实际
   B-rep region。没有唯一 fragment、选中无界 support-boundary region、construction/source
   alias、split failure 或不完整 query 都稳定拒绝，不把 B-spline/arc 采样成多边形，也不复用
   整张草图。该路径覆盖 bounded line/arc/circle/ellipse/B-spline arrangement 的 shared
   contract，但尚未覆盖不同 sketch、surface/topology producer、trim/copy/pattern 后继或完整
   FeatureScript IMPRINT query grammar，因此仍是 P1 部分完成项。工件
   `output/planar-imprint-intersect-20260909-runtime` 是 CAP_FACE 扩展前的历史工件：
   `00082324` 与当时的 `00835610` 都保留可执行 STEP 但 `rp.passed == false`，`00071859` 和
   `00093912` 分别保留既有 `TopoDS::Solid` 和 revolution-segmentation runtime failure。
   当前 `output/drafted-cap-face-20260909` 已证明 `00835610` 在 drafted CAP_FACE continuation
   与该 IMPRINT 后续均执行时 RP 通过；这不改变 `planar_imprint` 的其它失败分类，也不构成
   该能力的完整覆盖。共享核心 17 回归
   `output/core-17-planar-imprint-20260909` 分类保持 3 strict、2 RP、10 rejected、1
   rebuild failure、1 comparison timeout。
   对同一逻辑 circle source，solver 现在保留一条带 workplane frame 的 OCC circle edge，而不将
   它预拆为四条 contour arc；fragment 的 directed successor/predecessor 由 splitter image 在
   精确交点处的端点和原 curve 同向切向解析，避免周期参数接缝的数值排序歧义。无 fragment
   的 source 代表全体 splitter descendants：只有其给定 face side 的每一个 B-rep face 都有界时，
   adapter 才保留完整 face 集；任一 support-boundary face、非唯一 side 或 fragment 都拒绝，
   不按 image 顺序/长度选择或静默省略。`output/intersect-circle-imprint-matrix-20260909-r2`
   记录 `00001313` F1/F3 完整执行但 RP 拒绝（bbox delta `0.023571 mm`）、`00004246`
   的 F1/F3 executable prefix 和三个仍有归因的失败。`00040869` 的 line/ellipse
   `OD(0)` pairs 以 OCP exact distance 均为 `0.004240908 mm`，没有 splitter image 或
   section edge，故 `output/intersect-circle-imprint-source-gap-20260909-r1` 保留 F1 prefix
   并报告 source/anchor 无实际交点，绝不以容差补点；核心 17
   `output/core-17-intersect-circle-imprint-20260909-r2` 为 4 strict、3 RP、9 rejected、1
   comparison timeout。故这仍只是同草图有界 exact-curve arrangement 的 P1 扩展，不能宣称
   general INTERSECT replay 已完成。
2. `UP_TO_NEXT` 已 lower 为 CDSL `through_next`，并有一个受限的 current-body
   contract：所有 profile sample ray 都在当前 body 命中时，保留 profile 到首个正向
   命中面之前的外部材料；只有部分 ray 命中时，以实际命中 face 做有限体层裁剪；没有
   命中时明确拒绝，不退化为盲拉伸。`00192744` 的 F5/F10/F14 已由该 contract 完整
   执行，但其独立 body 与 source STEP 的融合差异、后续 multi-body transform 和 source
   history/STEP 不一致仍单独分类。这是部分完成，不代表复杂 profile、多 body target、
   source body lifecycle 或第二方向终止已支持。
3. 在上述受限路径之外，完成 `up_to_surface`、`up_to_next`、`up_to_body`、
   `up_to_vertex`、two-sided、through-all、surface/mixed 的有限交集语义和多 body
   target 选择。
4. 仅在所有 profile rays、target body 和 offset 均能由通用几何验证时执行；否则保留
   前缀并说明哪一个终止条件无法证明。

### P2：实体特征的完整语义

1. `extrude`、`revolve`、`loft`、`sweep`：补齐实体/曲面模式、复杂 profile、导轨、
   section correspondence、twist/transition、path/axis selector 和结果 body。现有 direct
   initial/new-body simple sweep 与 initial simple loft 现可将 builder-proven cap evidence
   作为受限 CDSL output-role selector 供 downstream feature 消费；同一 contract 还支持
   independent blind prism CAP_FACE 的 `extrude_from_face`。这些路径仍不能代替完整的
   derived-topology selector 语义，CADFS lowering 也尚未以此表示一般 CAP/SWEPT query。
2. `shell`：单一 selected solid 的 direct-builder topology delta 与有限 output-role
   evidence 已覆盖。CADFS lowering 现额外接受一个受限的 removal selector：直接 blind 或
   two-sided linear extrusion 的立即后继 shell，可从同一未修改 source profile 中唯一的、非
   construction `line` 原始实体生成平面 `SWEPT_FACE` placeholder，再由 prefix snapshot
   唯一绑定。该规则要求 owner、profile、start/end frame、blind extent 和单 body
   lifecycle 都可证明；revolve/sweep/loft、圆或其它非线性 source、changed profile、copy/
   pattern/boolean/dress-up continuation 和多 target body 均继续诊断，不能回退到当前 body
   或相近面。CADFS `oppositeDirection` 已显式 lower 为 `inward:false`，由既有 OCC
   `MakeThickSolidByJoin` 的有符号 offset 执行；这只复用已验证的 removal selector 和单一
   selected solid contract，不会将 OCC feasibility failure 伪装成 inward shell 成功。仍需任意
   稳定 removal face、多 body target、其它 join/offset 参数语义和更广的 kernel failure
   诊断回归。作为进一步的窄例外，紧邻 shell 的 `OFFSET_FACE` removal query 可在其
   `disambiguationData` 中只有一个 direct `TDD` CAP source，且 source 是前序 direct
   `new_body` blind-prism cap 时 lower 为 `shell.offset_face` 加 source-qualified output role。
   没有 `TDD`、多个 source、draft/fused/COPY/pattern/boolean source、非邻接 owner 或无
   active unique snapshot 都稳定诊断。`shell.parts` 现有一个独立且同样受限的 body-source
   lifecycle contract：只有 parts query 可唯一解析为仍存活的 direct `SWEPT_BODY` independent
   member 时，lowering 才写入 CDSL `target_feature_id`；capability preflight 和 runtime 都要求
   该 ID 的 exact B-rep solid 仍在 active member graph 中，不能以 `session.body`、current
   aggregate 或几何近似替代。`00107631` F3 中 F1 可证明地继续为 `f_F2`，因而是正例；
   `00542223` F7 在 fuse/pattern 后不再有独立 member；runtime 仅在 pattern 前后都是一个
   可执行实体且 source 唯一时保留 direct source 的 sole-body alias，因此 parts-scoped shell
   可以验证为当前实体，而不把 aggregate 伪装成一个独立 member。此路径尚未覆盖 multi-part /
   multi-body parts query、COPY、boolean 或 pattern instance 的通用 successor；这些情形必须
   保留可执行前缀或既有运行路径，不能宣称 explicit target-body semantics。实现参考
   SimpleCADAPI（Apache-2.0）`IsSame` member identity 语义，未复用代码；其单 Solid boolean
   假设未被采用，因为它与 CADFS 的独立 body 生命周期不兼容。当前验证为：受影响
   lowering/integration/selector/runtime suite `218 passed`（3 条既有 workplane warning）；
   `output/core-17-shell-parts-20260909` 为 3 strict、3 RP、9 rejected、1 rebuild failure、1
   comparison timeout。`output/shell-parts-matrix-20260909` 的 21 实样本中，10 个 shell 写入
   explicit `target_feature_id`，结果为 13 rebuilt-rejected、7 rebuild-failed、1 runtime-ineligible。
   `00107631` 的 F3 在这项 target contract 下通过 converter/preflight。其普通、非 instance-locked
   `CAP_FACE` selector 只有在 active owner candidates 均不满足完整 geometry signature 时，才可在
   当前 active member 中选择唯一的 threshold-qualified face；这不能替代 `output_role` relation，
   也不适用于 `owner_match_required` COPY provenance。因而 F3 的两张 removal faces 分别严格绑定
   为 `f_F2:face:1` 和由 `(f_F1, extrude.start)` 证明的 `f_F2:face:5`。该 feature 随后由 OCC
   报告 invalid thick-solid，而不是 selector-not-found；系统保留 F2 executable STEP prefix，不会
   修改厚度、重选面或伪造 shell 成功。`00542223` 的完整 history 现可 rebuild，但仍因几何比较
   rejected；这不是 RP 通过声明。`output/core-17-fused-sole-body-pattern-provenance-20260909-r2`
   的新代码工件为 3 strict、3 RP、10 rejected、1 comparison timeout；五样本
   `output/fused-sole-body-pattern-provenance-20260909-r2` 中 `00542223` 与 `00423838` 均为
   rebuilt/rejected，`00293508` 保持 RP，`00253824` 仍在无关 `planar_imprint` 路径失败并保留
   F3 prefix。这些结果不能作为 complete shell 或 RP 相似通过的证据。
   无 geometry 的普通 context selector 同时保留既有的唯一 active same-kind record 回退；它只在
   source owner 没有 active record、context 内候选唯一时成立。`owner_match_required` 的
   COPY/instance selector 没有此路径，零 owner candidates 仍是 `selector_not_found`。该边界的
   原子正反测试与完整 CADFS 测试均通过（11 个 selector test、118 个 CADFS test）。刷新后的
   `output/core-17-selector-context-full-20260909` 仍为 3 strict、3 RP、9 rejected、1 rebuild
   failure、1 comparison timeout；`output/shell-parts-selector-context-fallback-matrix-20260909` 的
   21 条分类仍为 13 rebuilt-rejected、7 rebuild-failed、1 runtime-ineligible。这是 selector
   绑定范围修正，不增加 shell 的已完成语义，也不改变 OCC invalid-shape 的保留前缀诊断。
3. `fillet`、`chamfer`、`hole`：完整 selector、tangent propagation、参数变体、
   feasibility 检查和 dress-up 后继。当前 fillet/chamfer lowering 对 direct blind/
   mid-plane extrusion 的唯一源端点，以及 direct two-section loft 的每 section 一对唯一
   源端点，可生成可绑定的 endpoint-bbox `SWEPT_EDGE` selector；前者额外证明为直线，
   后者不声称曲线类型，因为内核可将其物化为 B-spline。独立 `NEW` 的 full solid
   revolve 也可在 profile 与 axis 都是同一原始草图的直接来源、original-set 唯一指向一
   个非轴端点时，按 axis projection 生成 `circle_center_mm` / `radius_mm` 圆边签名；
   adapter 只从实际 OCC circle edge 记录该签名。一个 `IMPRINT` profile 仅在 materialized
   workplane 和完整 profile 与原草图完全相等时可使用同一来源证明；任何实际 region 选择
   都不继承该 contract。该受限路径不覆盖 sweep、surface/partial/fused revolve、
   multi-section loft、generated/trimmed/transformed profile 或 boolean/pattern 后继；任一
   端点、axis 或 owner 不唯一时必须保留前缀并诊断。内核不能完成时不能伪造较小半径或不同
   孔型。
4. `booleanBodies`、`mirror`、`circularPattern`：显式 source/target bodies、实例输出、
   nested pattern、remove/intersect/keep-tools 和 transform 后继。当前 direct circular
   `NEW` COPY -> rigid transform，以及 direct mirror 的 `NEW` source -> `instance 1`
   COPY -> transform 是受限增量；不代表 linear/nested pattern、镜像 aggregate source 或
   fused instance 已有完整 output body lifecycle。mirror 的 `mirrorPlane` 另有一个受限
   `SWEPT_FACE` contract：唯一 direct full solid `revolve_add` 的原始 source line 与 revolve
   axis 可由既有 `_query_plane` 证明为同一物理平面时，lowering 物化显式
   `reference_plane` 后交给现有 `pattern_mirror` 执行。它不从 STEP 或 current body 推断
   plane；partial revolve、非 revolve、curve/derived face 或任一未解析 frame 都保留原有
   mirror-plane diagnostic。`00000385` 的 F5 是正例（XY plane，F5 executed）；
   `00023074` 保留拒绝边界。五样本
   `output/mirror-revolve-plane-matrix-20260909` 为 2 RP、3 rejected，且只移除了
   `00000385` F5 的 plane defer，F2 chamfer 与 F7 fillet 仍如实诊断。`booleanBodies`
   现在也有一个独立、受限的 COPY body contract：direct `SWEPT_BODY` 和已存活的
   mirror/circular `COPY(SWEPT_BODY)` 分别 lower 为 feature ID 和
   `{pattern_feature_id, source_feature_id, instance_index}`，runtime/body graph 仅从该
   tuple 解析对应独立 body member，绝不以 producer aggregate 或 current body 代替。
   direct `SWEPT_BODY` 若唯一解析到上述 fused sole-body successor，也会以 successor 而非
   creator 作为 circular source；`00253824` 的 F1 -> F3 cut -> F4 add -> F5 circular 的
   source 因而是 `f_F4`，其 F6 targetless UNION 保留 `f_F4` 与 F5/F4/instance-1,2 的
   明确 ownership。该完整样本目前在无关的 F4 `planar_imprint` runtime selection 失败时
   保留 F3 executable STEP，不能作为 pattern/boolean RP 通过证据。合成 fused-body
   circular COPY -> boolean runtime 回归完整执行。多 body、boolean 后继、nested/linear
   pattern、被排除 instance 和 CAP/face topology ownership 仍未覆盖。
   targetless FeatureScript `UNION` 只在 `keepTools:false` 且至少有两个 explicit members
   时按 query 顺序确定一个 target；`00293508` 的 direct F1/F3 UNION 以 F1 target、F3 tool
   完整执行并 RP 通过。targetless subtract/intersect、keep-tools、无效或已经吸收的 instance、
   以及 multi-source transform COPY 仍保持拒绝。`00000385` 的 F6 因而以 `f_F1` 为 target、
   F5/F1/instance-1 为 tool 完整 lower 并执行，F2/F7 保持其原有 diagnostics。四样本
   `output/boolean-pattern-copy-provenance-matrix-20260909` 为 3 rejected、
   1 runtime-ineligible；其中其它 sweep、keep-tools/subtract、shell/hole 和 selector 缺口均
   未被重分类。新的 `output/core-17-boolean-pattern-copy-provenance-20260909` 仍为 3 strict、
   3 RP、9 rejected、1 rebuild failure、1 comparison timeout。direct circular ADD 现将每个
   transformed COPY 的面、边、顶点沿 exact OCC transform/fuse history 传入 final active snapshot；
   只有一个 source 和一个 final result 的 relation 才传递 `f_pattern.cN.f_source` owner，
   split/merge/no-history 仍不声明 owner。`00542223` 的 F7 removal faces 和 `00423838` 的
   `COPY(CAP_FACE)` 因而都在 active snapshot 中绑定为真实 instance owner；后二者的最终 STEP
   仍分别 rejected，不能将 selector 可执行性描述为几何相似通过。direct-new wedge 的原子回归同时
   验证三个 copy owner 都出现在最终 fused body。nested/linear pattern、boolean 后继、被排除
   instance 和没有 exact history 的 CAP/face ownership 仍未覆盖。
   CADFS 的静态数值表达式还允许无歧义的 `round(N)`，但仅当 `N` 已是有限整数，因而该
   表达式可被证明为恒等；`00003011` 的 `round(8)` pattern 由此完整 lower。非整数
   `round`、变量和其它函数不会在 converter 中猜测 FeatureScript 的数值语义。这只是
   lowering 前置条件，不能作为 COPY owner、pattern instance lifecycle 或 RP 相似通过的
   证据。
5. `cPlane`：所有历史出现的 plane constructor、曲线/曲面 attachment、方向手性和
   退化输入。`CPlaneType.OFFSET` 必须将 CADFS `oppositeDirection` 编译为 source plane
   normal 上的负 signed offset，而不是忽略该 flag 或翻转 plane frame；后者会镜像同一草图的
   local coordinates。该 shared lowering contract 已覆盖 272 条实际带该 flag 的 history。
   `00777619` 将 Right plane 的 `76.2 mm` offset 修正为 `x=-76.2 mm`；因其 profile 只有部分
   射线到达 selected `SWEPT_BODY`，`up_to_body` 仍以非均匀 target 诊断保留 F2 prefix，不能
   被这一 plane 修复伪装成成功。Right/Front/Top 的三个真实 matrix 例与 24 条分层 shard
   `output/cplane-offset-opposite-shard-20260909` 分别验证 frame 和独立分类：3 strict、1 RP、
   13 rejected、7 rebuild failure。共享 core-17
   `output/core-17-cplane-offset-opposite-20260909` 分类保持 3 strict、3 RP、9 rejected、1
   rebuild failure、1 comparison timeout。它仍只是 cPlane 的一项通用 frame contract，不覆盖
   曲面/曲线 attachment、退化输入或完整 derived-topology plane semantics。

### P3：尚未支持的 FeatureScript 操作

按全量诊断计数建立 operation registry，逐项为 `draft`、`thicken`、`split`、
`moveFace`、`deleteFace`、`replaceFace`、完整 `transform`、`derive`、`import`、
`bend_add` 建立 schema、lowering、runtime、adapter 和回归。外部资产或生成器缺失时，
必须将 capability 标为不可执行并提供部署诊断，不能在 import 时影响无关模型。

### P4：比较、来源和性能

1. 保留 strict 与 RP 两层几何比较，并为被精确量快速拒绝的边缘模型提供可控的
   离线 surface 诊断预算；comparison timeout 是基础设施问题，不能混入几何失败。
2. 输出 source/rebuild 多视图、局部差异、body 体积/面积和最近 feature 的关联证据。
   截图只用于人工复核，不能替代多视角 B-rep 比较。
3. 识别 source STEP 非闭合、FeatureScript literal 与 export 精度不一致、缺失资产等
   source exception。它们必须保留原始导入/检查证据，不能修饰 CDSL 以伪造通过。
4. 使用 capability shard、缓存中间工件和可恢复 worker 隔离完成全量回归；任何 failure
   都必须保留最后一个重新绑定 selector 并以 strict 模式实际执行成功的前缀 STEP、GLB
   和诊断。不得把未绑定候选或当前 body fallback 伪装成可执行工件。

## 每项能力的完成定义

一项能力仅在满足以下条件时可标记完成：

1. 有版本化的 CDSL 表达，且 schema/semantic validation 拒绝不完整或歧义输入。
2. lowering 仅根据 FeatureScript source 产生该表达，并保留 source feature、selector
   和 body provenance。仅有 runtime CDSL contract 而未由 lowering 产生的能力必须标为
   部分完成。
3. runtime/adapter 按通用算法执行，记录结果 body 和 topology delta，不依赖样本信息。
4. 原子语义矩阵包含正向、边界和拒绝测试；至少多个真实语料样本覆盖不同几何和
   生命周期组合。
5. 受影响核心集、扩展集和全量 shard 有可复现结果，工程相似通过率、失败数和剩余
   exception 均更新到本地台账。
6. 代码审查确认没有 sample-specific 分支、gold STEP 参数回填、隐式默认尺寸或为
   通过比较而降低 RP 阈值的行为。

## 执行节奏

每次改动依次执行：受影响原子测试 -> 受影响真实样本 -> 核心 17 -> 扩展能力矩阵 ->
对应全量 shard。完成一个 capability family 后，更新
`ENGINE_CAPABILITY_GAPS_PROGRESS.local.md`，记录新增的通用 contract、剩余边界、
样本列表、比较证据和下一优先级；该本地台账不提交 Git。

全量目标完成时，报告必须按“工程相似”“严格一致”“source exception”“未实现能力”
和“基础设施失败”分别给出分母、样本 ID、工件和原因。任何仍可执行的模型都必须
保留输出，不能因未满足最终几何目标而丢弃。