kernelcad-assemblies

kernelCAD — assemblies

Use assembly() when the model needs named mechanical parts, connector frames, and joint metadata that a human or agent can inspect later. Call .model() after adding parts to return a Scene with per-part bodies; iterate .parts for per-part rendering / export, call .toCompound() for an OCCT group (lossless on color/name/identity, default for STEP), or .toUnion() for one fused solid (lossy on color/name — antipattern except when downstream truly needs a single Shape). Connector and joint records remain metadata for now; .model() does not solve motion (use .solvedModel(poses) for that). Use MCP inspect({ of: 'assemblies', file? code? }) to inspect the captured assembly intent without recomputing topology.

Assembly validity

kernelcad validate <file.kcad.ts> runs the assembly validator over the script's Scene. Three checks today:

• assembly.part.floating — a part has no joint connecting it to any other part. The fix: declare the connection via arm.mate(..., 'fastened') or arm.mate(..., 'revolute', ...).
• assembly.part.orphan — a part is in a sub-assembly disconnected from the main mechanism.
• assembly.interference.overlap — two parts share volume (promoted from kernelcad interference).
• assembly.structure.unstructured-bodies (info) — a multi-body model returns loose top-level bodies with no assembly().part(...) structure, so the parts carry no identity for inspect --focus, inspect({ of: 'part-stats' }), or per-part review. The fix: wrap each distinct body in a named assembly().part(name, shape).

Exit codes: 0 (solved) / 1 (warnings) / 2 (errors). Pipe-friendly:

kernelcad validate so100.kcad.ts && echo "fits"

Authoring rule: every arm.part(name, shape) should also appear in at least one arm.mate(name, 'a.connector', 'b.connector', kind, opts) call (kind ∈ fastened | revolute | prismatic | ball). Raw at: [x, y, z] placement without a mate produces a working geometric output but fails validation — the agent has authored a position but not a connection.