cdsl-cad/cadfs_to_cdsl/CADFS_FULL_CAPABILITY_TARGET.md

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、工件和原因。任何仍可执行的模型都必须 保留输出，不能因未满足最终几何目标而丢弃。