Blacksite/.cursor/plans/collider_diagnostics_2026-07-12.plan.md

Collider Authoring Diagnostics - 2026-07-12

Historical plan — not current implementation guidance. Use the documentation index for current behavior and architecture.

Issue: Gitea #26 (BS-JD-305)

Outcome

Collider authoring exposes one consistent health result to the inspector, Collider viewport, Diagnostics panel, and physics placement preflight. Shape changes preserve useful dimensions and remain one typed undo operation.

Contract

• Authored box, sphere, and capsule overlays include actor world scale.
• Static mesh colliders show cooked runtime bounds when available.
• Green is ready, cyan is a trigger, gray is disabled, amber is warning/stale, and red is invalid or missing.
• Invalid dimensions and mesh references block dependent workflows. Missing hydration and colliders over 1,000 meters in world extent are warnings.
• Physics placement consumes the same collider-health checks instead of maintaining a separate prerequisite definition.

Work

• Add shared authored/runtime collider diagnostics and focused fixtures.
• Add shape/status-aware viewport overlays and selected-collider HUD state.
• Add inspector health/repair feedback and dimension-preserving undoable shape switching.
• Add scene-wide selectable collider findings to Diagnostics.
• Reuse diagnostics in physics placement prerequisites.
• Add a committed non-blocking showcase scene and update documentation.
• Run source gates and live Wayland acceptance; packaged tests remain skipped by request.
• Commit, push, attach native Gitea evidence, close #26, and close M3 when empty.