cae-analysis

name	cae-analysis
description	Prepare one typed, executable CAE job package from a validated CAD handoff in the CAD/CAE LangGraph loop. Use for material, load, constraint, mesh, thermal, CFD, result-target, solver-capability, and CAD-feedback decisions. Do not launch a solver or fabricate results.

CAE Analysis

Prepare exactly one CaeJobPackage for the Planner-declared analysis case. Treat the solver_capabilities object in the task input as the authoritative executor contract.

Boundaries

• Do not add, remove, or replace Planner analysis cases.
• Do not edit CAD geometry or launch Mechanical, Fluent, or Workbench.
• Treat resolved solver paths and their requested-version checks as runtime configuration; never infer or hard-code an ANSYS installation path.
• Do not invent a named reference, material property, solver input, or result.
• Write task artifacts only below the supplied output_directory.
• Return paths relative to the run directory supplied by the Runner.

Handoff gate

Require a current exchange geometry artifact, successful CAD validation, body count, and every reference needed by the selected material, boundary, mesh, or result scope. Preserve reconstruction metadata such as selection_method, member_names, member_name_prefixes, expected_count, audited face areas, centroid targets, and complement exclusions.

Use NEEDS_USER_INPUT only for execution-critical information that cannot be responsibly inferred. Use BLOCKED_PLAN_NOT_EXECUTABLE when the Planner case exceeds the supplied capability registry. Request a CAD revision when required receiver-side scopes cannot be reconstructed from the handoff.

Package construction

• Preserve parameter provenance and engineering role from the Planner.
• Select only the case-specific analysis geometry.
• Bind every material, load, constraint, mesh control, and expected output to stable named references when its contract requires a target.
• Set Workbench fallback only when every requested feature appears in the Workbench capability entry; otherwise set fallback_adapter=null and allow_fallback=false.
• For solid thermal analysis, provide a complete thermal_setup and keep heat flow (W), heat flux (W/m^2), convection, radiation, temperature, and contact resistance as distinct typed conditions.
• For CFD, provide a closed fluid-domain input, complete terminal/wall roles, fluid properties, turbulence inputs, mesh controls when needed, solver controls, and supported expected outputs.

Read CAE handoff contract when validating CAD input or constructing a CAD feedback request.

Feedback

When execution is blocked, report the missing reference or input, why it is needed, the affected case, the responsible owner (CAD, PLANNER, or user), and whether any explicitly marked temporary assumption is safe. Never report a numerical CAE result; deterministic solver and validator nodes own execution and acceptance.