docs/skill: scadpkg-format says a part definition holds one solid (no solid_cache.bodies, no profile 3)
DECISION: the package-format reference states the part definition as it is again: profile
simplecad-part-definition-2, one solid, at most one appearance row.
WHY - THE DISCUSSION (owner and assistant, 2026-11-10; full account in design-docs/part-holds-one-solid.md)
The multi-body Part existed so the editor could keep several solids side by side with no assembly constraint
(pattern a tool, then cut); the owner judged it a wrong decision that makes assembly hard, and the agreed
analysis was that those solids are notebook intermediates, not product items, so a Part is one solid. The commit
"artifacts: a part definition holds one solid (drop BodyRef, `solid_cache.bodies` and profile 3)" removed the
durable format that described several bodies. This page is what a reader of a package follows, so it must not
tell them to expect `solid_cache.bodies` or a "multi-body part names its bodies" rule.
- docs/skill/references/scadpkg-format.md ("Definitions"): names the profile, the one-row appearance block
(colour and opacity, name), and says explicitly that `solid_cache.bodies` and profile 3 do not exist (they
only appeared in the withdrawn 2.2.8 release), so a reader who met them there knows they are gone.
Co-Authored-By: Claude Sonnet 5.5 <noreply@anthropic.com>
This commit is contained in:
@@ -75,12 +75,14 @@ by its own sha256 through the map above works uniformly.
|
||||
Part definitions carry: `units` (`"mm"`), `generator`
|
||||
(`{ocp_version}`), `solid_cache` (body reference — the BREP payload for
|
||||
in-process rebuild), `topology_snapshot_ref` (the tag channel, below),
|
||||
`connectors`, `material_ref`, `metadata`, `profile`, `revision`, and,
|
||||
only when a body has a display appearance, `appearance`
|
||||
(`{"bodies": [{"body_id", "color", "opacity", "name"?}]}`: colour as
|
||||
linear RGB in [0, 1] overriding the material colour for display; `name`
|
||||
only on a one-body part, a multi-body part names its bodies in
|
||||
`solid_cache.bodies`).
|
||||
`connectors`, `material_ref`, `metadata`, `profile`
|
||||
(`simplecad-part-definition-2`), `revision`, and, only when the body has
|
||||
a display appearance, `appearance`
|
||||
(`{"bodies": [{"body_id", "color", "opacity", "name"?}]}`, one row at
|
||||
most: colour as linear RGB in [0, 1] overriding the material colour for
|
||||
display). A part definition holds exactly one solid: `solid_cache` has
|
||||
`evaluator_profile` and `body_ref` only (there is no `solid_cache.bodies`
|
||||
and no profile 3; that existed only in the withdrawn 2.2.8 release).
|
||||
Assembly definitions carry `definition_refs`, `instances`,
|
||||
`relations`, `public_connectors`, `solved_snapshot`,
|
||||
`grounded_instance_ids`, `feature_graph_ref`. Identity is
|
||||
|
||||
Reference in New Issue
Block a user