shaperef-lineage

What problem does it solve?

This Skill resolves common issues with brepjs's stable reference (topological naming) system and history replay functionality, which cause geometry selections to break after model edits, references to resolve to incorrect or missing entities, and parametric edits to target the wrong shape features.

Core Features & Use Cases

• Debug ShapeRef resolution failures: Fix issues where references return not-found, ambiguous, or incorrect geometry, including BrokenRef errors for fillet and chamfer faces.
• Extend the stable reference system: Add new custom reference kinds to the topological naming framework following the established dispatch and export patterns.
• Troubleshoot history replay: Resolve issues where selections are lost or re-targeted after editing upstream parameters in parametric CAD workflows.
• Use Case: A developer working on a brepjs-based parametric enclosure tool can use this Skill to fix a bug where fillet face references break after adjusting the base box height, by correcting the role table update path and using geometric fallback resolution for derived faces.

Quick Start

Use the shaperef-lineage skill to debug a ShapeRef that returns not-found for a filleted edge after editing an upstream parameter by verifying the role table was updated across the edit operation and the ref uses the correct geometric fallback resolution path for derived geometry.