feat: unify CAD workflows on DesignIR 3.0

designir-pipeline/agents/reconstruction-agent.md

@@ -1,14 +1,16 @@
-# Agent A — DesignIR Reconstruction
+# Agent A — Distillation and Semantic Reconstruction
 
 ## Mission
 
-Turn deterministic private evidence and promoted generalized experience into a
-complete executable DesignIR 2.0 model. Produce design logic, not copied
-geometry.
+Turn deterministic private geometry evidence and promoted generalized
+experience into an executable DesignIR 3.0 model. SurfaceIR preserves the
+independent geometric truth; Semantic FeatureIR adds a canonical, editable
+design interpretation. Produce a plausible canonical construction, never claim
+to recover the unknowable original CAD history.
 
 ## Allowed inputs
 
-- One private evidence packet from `runs/evidence/`.
+- One private evidence packet and independently extracted SurfaceIR program.
 - The user modification request.
 - Promoted generalized experience.
 - The DesignIR schema and supported operation vocabulary.
@@ -16,20 +18,27 @@ geometry.
 ## Forbidden inputs and actions
 
 - Never open, copy, import, or reference the teacher STEP.
-- Never embed B-Rep bytes, STEP text, full meshes, triangle soups, face IDs, or
-  source topology references.
+- Never embed B-Rep bytes, STEP text, full meshes, or triangle soups.
 - Never call `import_step`, `read_step`, `STEPControl_Reader`, or equivalent.
 - Never represent the teacher as a base feature.
 - Never infer unsupported geometry silently.
 
 ## Required output
 
-Write one `runs/designir/*.designir.json` containing:
+Write one private DesignIR 3.0 instance program containing:
 
-- family and reconstruction status;
+- a backend-neutral SurfaceIR topology/surface layer capable of rebuilding with
+  the teacher removed, including top-level open shells that are not members of
+  any solid;
+- family and semantic reconstruction status;
 - coordinate system and datums;
 - editable parameters and expressions;
-- sketches and constraints where applicable;
+- canonical semantic parameter names such as `plate_thickness`,
+  `hole_diameter`, `hole_spacing`, `bolt_circle_diameter`, and `rib_count`
+  whenever the evidence supports them;
+- inference status, confidence, aliases, affected feature IDs, and an observable
+  edit contract for every parameter inferred from the final B-Rep;
+- canonical sketches and constraints where the evidence supports them;
 - ordered features, patterns, and attachments;
 - construction stages;
 - edit interface;
@@ -41,10 +50,26 @@ If the vocabulary is insufficient, emit
 `reconstruction_status: unsupported_feature_vocabulary` plus precise
 `missing_capabilities`. Do not approximate secretly.
 
+Generic evidence roles such as `overall_short_span` are not a finished edit
+interface. Every editable parameter in a ready DesignIR must drive at least one
+executable feature. `overall_scale` may be exposed as a validated universal
+fallback for geometry-bearing SurfaceIR, but it must be labelled as a
+dimensionless transform and must never be presented as recovered
+feature-specific design intent.
+
+If no more specific named edit is validated, the agent may expose
+`overall_size_x`, `overall_size_y`, and `overall_size_z` as canonical envelope
+dimensions. These names describe the DesignIR coordinate system and must not
+be presented as recovered sketch dimensions.
+
 ## Completion gate
 
 Request `isolated-rebuild`. Passing means the compiler generated a complete STEP
 from only DesignIR and compiler code while the teacher vault was inaccessible.
-The router may choose `build123d` or `simplecadapi`; the latter also produces a
-replayable SimpleCAD model JSON as a backend artifact. Put rebuild artifacts in
-`runs/rebuilt/`.
+The authoritative geometry compiler is OCCT-backed and supports analytic and
+B-spline surfaces. Build123d and SimpleCADAPI are optional semantic feature
+compilers, not mandatory fallbacks for geometry they cannot express.
+
+Geometry equality alone completes only the geometry gate. A model is not
+semantically promoted until its named parameter perturbations also pass
+independent acceptance.