Skip to content

Example examples/gallery/ratchet-stool.kcad.ts fails the physics-grounded loop #351

Description

@w1ne

Symptom

node dist/cli/index.js validate --include-interference examples/gallery/ratchet-stool.kcad.ts reports mechanism: broken with 86 mechanism.interpenetration failures.

34 parts, no mate edges. Every pair of decorative geometry pieces that touch (the four legs nesting into the seat, the rung struts crossing each other, etc.) is flagged as unexplained overlap.

Root cause

Like meta-glasses, this is a decorative static-stool model authored as 34 separate parts with no mate edges. The new physics loop expects parts to either be mated (with their contact volumes excluded by the joint-pair tolerance) or genuinely separated; bare decorative co-located geometry doesn't fit that model.

Fix scope

Either (a) fuse the 34 decorative parts into one canonical part per stool component (seat-disc, four legs, eight rungs etc.) so each part is internally connected, or (b) add fastened mates between every touching pair using topology-bound connectors. (a) is the natural choice for a static stool — probably ~2-3 hours of consolidation. Either way the SSIM scorer that drives the gallery should agree the final image matches.

Spec

  • docs/specs/2026-06-01-physics-grounded-loop-design.md §criterion 2
  • docs/plans/2026-06-01-physics-loop-P3-sweep-and-demote.md

Metadata

Metadata

Assignees

No one assigned

    Labels

    physics-loopExamples failing the physics-grounded loop (P3 sweep follow-ups)

    Projects

    No projects

    Milestone

    No milestone

    Relationships

    None yet

    Development

    No branches or pull requests

    Issue actions