Skip to content

SolidCraft: an open-source parametric 3D CAD application built in pure Rust. Desktop, web, and automation through MCP.

Roadmap: a short user-facing ROADMAP.md, with the developer detail moved to docs/roadmap-detail.md (#6797)

bherbrucke53390ea1b2e
diff --git a/AGENTS.md b/AGENTS.md
index cd896d862f..4106903463 100644
--- a/AGENTS.md
+++ b/AGENTS.md
@@ -212,7 +212,7 @@ before the draft is verified.
- Build with `CARGO_TARGET_DIR=<repo>/target`. Windows: `cargo xwin build --release --target x86_64-pc-windows-msvc -p solidcraft`.
## Roadmap
-`ROADMAP.md` (committed) tracks status, milestones and estimates. Update it whenever a
+`docs/roadmap-detail.md` (committed) tracks status, milestones and estimates; `ROADMAP.md` is the short user-facing roadmap. Update it whenever a
milestone task lands. `docs/features.md` (SolidCraft's commands by area, from the registry) and
`THIRD-PARTY-LICENSES.txt` are regenerated on `main` after each merge by the Generated files
workflow; never regenerate them in a PR.
diff --git a/CONTRIBUTING.md b/CONTRIBUTING.md
index 4c9dfde85b..dc4e385a0f 100644
--- a/CONTRIBUTING.md
+++ b/CONTRIBUTING.md
@@ -11,7 +11,7 @@ build it, how the code is laid out, the few rules that aren't negotiable, and wh
needed most.
Before choosing a task, check the [command inventory](docs/features.md) and
-[roadmap](ROADMAP.md) for implemented capabilities and current priorities.
+[roadmap](docs/roadmap-detail.md) for implemented capabilities and current priorities.
Questions, ideas or want to say what you're working on? Join the [Discord](https://discord.gg/FtU4NQNVDH).
@@ -394,7 +394,7 @@ In order of how much they'd help users:
2. **Boolean robustness.** A random-design fuzzer currently gets about half of its designs
through without a kernel error. Each failing seed is a reproducible bug.
3. **Drawings, CAM and mesh tools.** These are out of scope for now (see
- [ROADMAP.md](ROADMAP.md)), but anyone who wants to own one is welcome.
+ [ROADMAP.md](docs/roadmap-detail.md)), but anyone who wants to own one is welcome.
## Updating the generated feature list
diff --git a/ROADMAP.md b/ROADMAP.md
index bc2232a7e6..4d6cf15424 100644
--- a/ROADMAP.md
+++ b/ROADMAP.md
@@ -1,696 +1,82 @@
# SolidCraft roadmap
-Status as of **2026-10-14**. SolidCraft supports parametric modelling (sketch →
-features → parametric timeline) as an open, pure-Rust, agent-drivable application.
-
-## At a glance
-
-| Question | Answer |
-|---|---|
-| Where are we? | **M0 and M13 done; M1, M2, M5–M7, M9, M10, M14 in progress.** Sketch with solver and the full SKETCH create/modify set; extrude, revolve (two sides, symmetric, to object), fillet/chamfer (variable radius, chord length, a radius per edge, corner patches), holes, threads (cosmetic and modelled), patterns, mirror, shell (inside/outside/both), draft, loft, sweep, coil, split body and split face, delete face, construction planes, axes and points; persistent naming of faces and edges; parameters and configurations; components, joints, motion studies, exploded views; sheet metal and a plastic enclosure subset; STEP/IGES/3MF/STL/OBJ/DXF; FreeCAD/Rhino import; autosave and crash recovery; desktop and browser (wasm) app, CLI, MCP server. |
-| Features | Every registered command by area — [docs/features.md](docs/features.md) (`cargo xtask features`); registry breadth does not establish workflow or geometric depth |
-| Reference tests | [Current case count and results](docs/oracle.md): public cases in `tests/oracle/` with analytic or FreeCAD-computed expected values, checked by the reference-test job in [CI](.github/workflows/ci.yml). |
-| Tests | Solver, profiles, kernel booleans/blends/measures, expressions, timeline, persistent naming, file formats and migrations, assemblies, sheet metal, engine end-to-end, hostile-input fuzz over every command and headless UI scenarios. `cargo xtask ci` reports the current passing counts. |
-| Gates | `cargo xtask ci`: fmt, clippy -D warnings, tests, asset attribution, layering, wasm32 build — green |
-| Time to a useful alpha (M0–M6) | ≈ **82 agent hours** remain (sum of the M1–M6 estimates below) |
-
-Optional GPU viewport ambient occlusion is available in View settings and Graphics preferences,
-with persistent settings, Performance/Quality graphics presets (Quality combines AO, Fine tessellation and adaptive 2× supersampling; manual combinations show Custom), and the
-`view.ambient_occlusion` and `view.graphics_preset` commands. See [display settings](docs/ambient-occlusion.md).
-
-## Scope (owner decision, 2026-10-07)
-
-The issue batch adds preservation of blind pockets in through cuts, associative projected
-offsets and plastic face placements, XZ (+Y normal) with a v6 migration preserving older
-designs, interactive angle placement, file-picker sketch imports, Home/recent controls,
-toolbar overflow, and the remaining component-frame and assembly WIP work. The enclosure
-acceptance scenarios now include board resizes; STEP reopening is automated. See [WIP reconciliation](docs/wip-reconciliation.md).
-Face-based Extrude Join (including outward Press Pull) now defaults to the picked body,
-so edge-touching assembly neighbours stay separate regardless of body order (#226).
-
-In scope, in priority order:
-1. SOLID and SKETCH (now).
-2. Parameters / functional constraints (done: see `parameters.*`, `expr.evaluate`; unit-aware,
- cycles reported with their path, rename follows references, deletes list their users):
- user parameters with units and expressions (+-*/, ^,
- parentheses, sin/cos/sqrt/min/max/floor/ceil/round, unit conversion), model parameters
- d1, d2… for every dimension and feature input, references between parameters with a
- dependency graph and cycle detection, re-evaluation on change, comments, favourites,
- CSV/JSON import and export.
-3. Components and assemblies with joints (M9).
-4. SHEET METAL: flange, contour flange, bend, unfold/refold, flat pattern with DXF export, sheet
- metal rules (thickness, K-factor, bend radius) (M10).
-5. A small PLASTIC subset for enclosures, after sheet metal: Boss, Rib, Web, Lip/Groove, Snap Fit.
-
-Deferred until further notice: MESH, FORM (T-splines), SURFACE beyond what solids need (scope proposed in #772), PCB / 3D
-PCB / Package, Render, Animation, Simulation, Manufacture/CAM, Drawings.
-
-## Milestones
-
-| # | Milestone | Status | Hours left |
-|---|---|---|---|
-| M0 | Vertical slice | done | — |
-| M1 | Sketch depth: command coverage implemented — projection/intersect/include as linked geometry (auto-project on faces, lost-reference warnings, break link), full SKETCH create/modify set (slots, polygons, tangent arcs/circles, ellipse, fit/control splines, conic, text, trim/extend/break, fillet/chamfer, offset, mirror, patterns, move/scale, blend curve, centerline), constraints incl. curvature and polygon with over-constraint refusal, Shift-picked line midpoints in Horizontal/Vertical using persisted points and ordinary constraints (#2087), driven/arc-length/linear-diameter dimensions, AutoConstrain, DXF/SVG insert, 3D sketch curves (Project To Surface, Intersection Curve, Isoparametric Curve, Spun Profile), exact free-form profiles (B-spline/NURBS edges, any spline degree, curves cut by crossings), sweeps and pipes along 3D sketch curves, canvases and decals, curvature combs. Exact free-form Extend and certified associative offsets now preserve geometry and IDs through edits, deletion and reopen. Occurrence-frame 3D wires now store explicit coordinate spaces and retain points and analytic fits through moves, refresh, undo and reopen. Constructive sketch solving (Owen 1991, Fudos & Hoffmann 1997) ahead of the numerical solver: points and rigid clusters are placed on the branch the sketch had, so dimension edits and drags keep their solution; edits that would turn a sketch over are refused; drags re-solve only the sketch per frame. Remaining workflow repairs: mixed offset junctions, legacy natural-spline seams, and damaged legacy wire links lacking frame provenance | in progress | 4 |
-| M2 | Robust modelling: coplanar booleans in the kernel, holes (placed on faces, at distances from reference edges, and on sketch points), threads (cosmetic, then modelled), patterns, mirror, shell, draft, split, construction geometry | in progress | 16 |
-| M1 | Sketch depth: command coverage implemented — projection/intersect/include as linked geometry (auto-project on faces, lost-reference warnings, break link), full SKETCH create/modify set (slots, polygons, tangent arcs/circles, ellipse, fit/control splines, conic, text, trim/extend/break, fillet/chamfer, offset, mirror, patterns, move/scale, blend curve, centerline), constraints incl. curvature and polygon with over-constraint refusal, Shift-picked line midpoints in Horizontal/Vertical using persisted points and ordinary constraints (#2087), drawing snaps to where two lines, circles or arcs cross (#4967), driven/arc-length/linear-diameter dimensions, AutoConstrain, DXF/SVG insert, 3D sketch curves (Project To Surface, Intersection Curve, Isoparametric Curve, Spun Profile), exact free-form profiles (B-spline/NURBS edges, any spline degree, curves cut by crossings), sweeps and pipes along 3D sketch curves, canvases and decals, curvature combs. Exact free-form Extend and certified associative offsets now preserve geometry and IDs through edits, deletion and reopen. Occurrence-frame 3D wires now store explicit coordinate spaces and retain points and analytic fits through moves, refresh, undo and reopen. Constructive sketch solving (Owen 1991, Fudos & Hoffmann 1997) ahead of the numerical solver: points and rigid clusters are placed on the branch the sketch had, so dimension edits and drags keep their solution; edits that would turn a sketch over are refused; drags re-solve only the sketch per frame. Remaining workflow repairs: mixed offset junctions, legacy natural-spline seams, and damaged legacy wire links lacking frame provenance | in progress | 4 |
-| M2 | Robust modelling: coplanar booleans in the kernel, holes (placed on faces and on sketch points), threads (cosmetic, then modelled), patterns, mirror, shell, draft, split, construction geometry | in progress | 16 |
-| M3 | General fillets and chamfers (curved edges, chains, vertex blends); saddle rolling-ball surfaces now use continuous seam sections and arc-length fitting with shared contact boundaries and bounded accuracy checks; tiny rim edges remain selected instead of nearby wall seams when filleting (#2498) | in progress | 30 |
-| M4 | Files: STEP import (done — [docs/step-import.md](docs/step-import.md)), FreeCAD/Rhino solids through cadmpeg (done, desktop, browser and CLI), 3MF export and 3MF/STL import as mesh bodies (done), 3MF with B-rep face tags ([docs/formats/3mf-face-tags.md](docs/formats/3mf-face-tags.md), done), constant-section parametric mesh reconstruction, DXF sketches, OBJ import | in progress | 6 |
-| M5 | Persistent naming of faces and edges (docs/book/src/dev/naming.md): faces named from their exact kernel-reported history (sketch curve sides, caps, revolve sections, primitive sides, blends, shell inner walls, pattern/mirror copies; split pieces told apart by the faces around them, lumps of a cut body named after their faces), edges by their faces; fillets/chamfers, sketches on faces, shell/draft/offset/replace faces, hole placements, joint origins and face appearances resolve by name first and warn when the entity split or vanished: done. sheet metal edges by base sketch line and flange side, shell inner faces, sweep and loft roles: done. kernel-reported face history: done (merged faces answer to every name; operations without history yet fall back to geometric names, flagged unverified; format 14 keeps older designs' geometric names). Left: history through sheet metal, plastic, surface and emboss features; FaceSource certificates through history | in progress | 20 |
-| M6 | UI depth: selection feedback and origin (done), timeline editing (done: hover and selection highlight modifier faces, including fillets and chamfers; edit feature, history marker drag, dependency-checked single and multi-item reorder, suppress, rename, delete with dependents, re-resolved references; redefining selections refreshes persistent edge/face references while retaining feature identity and dimension names; responsive feature history with width-driven icons/names/title, snapping width resize, bottom/left/browser-stack docking, shared-column collapse, rollback bar, multi-selection and persistent folders), right-docked dialogs (done), live previews for every feature dialog (done), keyboard-first commands with on-canvas value boxes and sketch inline dimensions (done), drag manipulators with automatic join/cut (done: extrude incl. two sides, fillet, shell, hole depth, move, pattern spacing, revolve rotator, extrude taper), dark theme (done), right-click menu with Repeat (done), measure tool (done), section analysis (done), selection filter (done), drag-solve of sketch points (done); appearance controls now preserve body/face/component targeting, named transparent looks, reuse/search and override removal; Browser Expand All / Collapse All (`browser.expand_all`, `browser.collapse_all`) on the design and component menus; preferences | in progress | 6 |
-| M7 | Thin extrude (walls along open or closed curves: centre, inside, outside or two sides; mitred corners, crossing walls joined; #721), sweep, loft (incl. to a point), rib and web (to next / depth), emboss (planar faces and exact radial emboss/deboss of bounded orthogonal profiles on complete exterior cylinders/sleeves), thread (cosmetic, and modelled M3–M20 outside and inside: the ISO profile screwed in as a faceted cut), coil (smooth B-spline helical walls), pipe, pattern on path, patterns of bodies and components, replace face (parallel), align, remove, feature copy/paste: done. Unique eligible cylindrical targets are inferred for new Emboss features. Left: general curved-face emboss and exact (unfaceted) modelled threads | in progress | 12 |
-| M8 | Surface workspace (#772). Done: Patch (sketch regions; edge loops filled G0, plus `crown`), Stitch, Thicken (planes and cylinders), Extend (straight edges of planar surfaces), Trim (by a plane, a face or sketch curves swept onto the surface, keeping a side or the picked regions; mutual trim of two surfaces, extended to meet and stitched, #767), Delete Face (healing), Boundary Fill, zebra/draft/curvature-map analysis, Surface Extrude/Revolve/Sweep/Loft from open and closed curves, Offset, Unstitch and Reverse Normal; the continuity-driven core (`kernel/src/bridge.rs`, G0–G3 Hermite rows) with **Blend** (`surface.blend`, #764: edge chains along one or several faces, closed rims paired seam to seam or from picked seams, a dialog), **Match** (`surface.match`), **Boundary** (`surface.boundary`, #763 — two sketch curves exact with G0–G3, three or four as the flat patch of their loop, and curve networks: Coons and Gordon surfaces through sketch, 3D-sketch or edge curves, a point for a three-sided side, G1/G2 against the faces along one direction's edges, joined into their body on request; G1/G2 on two sides that meet at a corner waits for the Gregory-type corner), **Fair** (`surface.fair`, CV fairing), **continuity analysis** (`inspect.continuity`, #770; a toolbar tool with edge markers and a legend, and curvature combs along face isocurves) and a multi-section **loft** with per-end continuity and crown, and guide rails on solid and surface lofts (one or two, scaling or stretching the sections between; #201). Also in the Class-A pass: G1…G4 blend curves in the sketch, chord and variable-radius fillets on curved edges (with honest refusals where the fit cannot hold), and a G2 corner patch where filleted edges meet (kernel; the command refuses until the patch's sections can be sewn to the blends' contacts). Left: bias/form-factor fillet sections (design recorded), a Gregory-type corner, surface Fillet between separate surface bodies (#769), Ruled (#762), Untrim (#761), curved-face Extend (#760), and every remaining #757–#772 item | deferred | — |
-| M9 | Components and assemblies: New Component / Create Components from Bodies, active component, per-component origin/bodies/sketches/timeline entries, occurrences with transforms, Copy/Paste vs Paste New, nested Browser tree with visibility and isolate; Ground, Move/Copy of occurrences, joints (rigid, revolute, slider, cylindrical, pin-slot, planar, ball) by joint origins with limits and Drive Joints, closed kinematic loops (four-bar, slider-crank: the loop's other joints follow the driven one on its branch, and driving stops where a loop can no longer close), cams (`joint.cam`: a revolute cam drives a slider or revolute follower along a closed sketch profile or the cam's edges, knife, roller or flat followers, worked out again when the profile changes; drives, studies, closed loops, contact sets), As-built Joint, Rigid Group, Contact Sets (driving and motion studies stop where bodies in a set would pass through each other), Motion Study (joint values keyed along a timeline, playback, export of occurrence positions as JSON/CSV), motion analysis (joint values and a point's path charted over a study as value, velocity and acceleration; the parts that collide along a study, with the steps where they do), Exploded views (automatic or by hand, shown without changing placements, and exported as an animation coming apart and back together); interference, per-component physical properties; STEP with assembly structure; URDF export for robot simulators (links with meshes, mass and inertia; joint chains whose values match Drive Joints; docs/urdf.md). Physical properties now measure material-aware component/occurrence placements, descendants and repeated instances, including pending moves and body reassignment offsets; contact geometry and automatic exploded centres respect those offsets. Groundwork done: component tree, occurrences with transforms (instances, Paste New), world placement, active component as authoring frame, ground, Capture/Revert Position, moving bodies and sketches. UI: ASSEMBLE panel dialogs for New Component, Joint (snaps on faces, edges, circles and vertices; animated motion preview; offsets, flip, limits), As-built Joint, Joint Origin, Rigid Group, Drive Joints (live slider), Motion Link, Cam and Interference (overlaps shown red); joints in the timeline and the Browser | in progress | 32 |
-| M10 | Sheet metal: flange (base, edge, contour), hem, unfold/refold, convert, flat pattern + DXF, rules: done. PLASTIC enclosure subset: Boss, Rib, Web, Lip/Groove, Snap Fit, Rest, Plastic Rules (library, edit, assign; rule draft and clearance as feature defaults): done, tested against hand-computed geometry. UI: SHEET METAL and PLASTIC tabs with dialogs (live preview, Edit Feature, pre-selection) for Flange, Hem, Unfold/Refold, Convert, Sheet Metal Rules, Create Flat Pattern (flat view with bend lines, bend table CSV/JSON and DXF export with exact circle/arc/line cutouts), Boss, Lip/Groove, Snap Fit, Rest, Manage and Assign Plastic Rules; Fold (bend along a sketch line); flanges meeting at a corner closed at any angle with the rule's gap; edge flanges with their own angle and height per edge in one feature; corner reliefs (notch, round, rectangular, tear) chosen by the rule; Convert to Sheet Metal from a solid or shelled body by its bend edges (flat faces, sharp bends) | in progress | 36 |
-| M11 | 2D drawings | deferred | — |
-| M12 | Release: cross-platform packages, verification and deliberate publication implemented; original current-UI demo refreshed. macOS Developer ID signing and notarization are in the release workflow (#5749; they switch on when the Apple secrets exist). Windows installer signing and broader performance work remain | in progress | 16 |
-| M14 | Configurations: a table of rows (parameter expressions and feature suppressions per row) switched with config.activate (undoable, all or nothing), kept through parameter renames and feature deletes (config.configure, config.table, config.column/row/activate). Per-row body materials and appearances (library looks, custom colour/opacity and clearing overrides), undoable activation and save/reopen: done. Ordered typed configuration rules, atomic validation and structured rule editing: done. Component appearance and certified semantic face style columns, atomic preview/apply and independent-copy remapping: done. Exact constructed sketch-side and immutable imported-face lineage now preserve legacy names and reject retargeting. Left: ambiguous shifted/two-sided caps | in progress | 4 |
-| M13 | Never lose work: atomic saves (temporary file, flush, rename; a crash at any moment leaves the old file or the new one) with the replaced version kept as `<file>.bak`; autosave of unsaved changes to the recovery folder every 5 minutes (preference) and after big operations, only when something changed; "Recover unsaved design?" on the next launch (`doc.recovery_list`, `doc.recover`, `doc.recovery_discard`); a kill-mid-save test (process killed while saving a 0.5 MB design 25 times). File format: `"format": "solidcraft/12"`, older formats upgraded step by step (`doc::format`), newer ones refused with a message, out-of-range numbers and broken placements refused; a corpus of designs saved by M0, components-era, joints-era and current builds (apps/solidcraft-cli/tests/corpus) that must open and evaluate as saved; damaged and hostile variants (truncation, bit flips, hostile values, removed keys, repeated features, deep nesting) never panic | done | 6 |
-| M15 | Frames and weldments (#4003): structural members along 2D and 3D sketch lines, butt and mitre corners, trim to faces and bodies, end caps, gussets, cosmetic welds and a cut list. Done: the profile library (`frame.profile.list`, `frame.profile.properties`, `frame.profile.insert`): bar, round bar, rectangular and round tube, angle, channel and I-beam, each SolidCraft's own parametric definition with exact fillet arcs and exact section properties (area, centroid, second moments), tested against hand-computed values; members (`frame.member`): one body per straight line of a 2D or 3D frame sketch, following parameter edits, with a built-in profile (its dimensions parameter expressions) or a profile sketch (its drawn material by alternating nested loops), anchor, angle and mirror; each member's name kept with its line. Left: corners, trims, end caps, gussets, welds, cut list, FRAME tab and dialogs | in progress | 60 |
-
-M6 navigation preferences include **Touchpad**: Shift + pointer movement pans, Alt/Option +
-pointer movement orbits without a mouse button, and vertical scrolling zooms. Other presets
-retain their saved two-finger scroll preference; camera motion is available through
-`view.navigate` and modifier-aware `ui.move` automation.
-With the **Fusion** preset and two-finger pan enabled, two fingers pan and Shift + two fingers
-orbit freely, with pinch zoom and mouse bindings unchanged. The shared navigation handler
-applies the same gestures to model and Render views and blocks orbit on flat pages.
-
-UI redesign (#2016): the File/start view (#2027) uses shared light/dark navigation,
-action tiles, recent rows and sample cards, with recovery review and Save As/Export
-entry points. Document loading, sample caches and recovery safety retain their
-existing command paths.
-
-M11 precursor: File → Export Current View as DXF exports shown placed bodies and sketches from the current
-camera as a 2D millimetre drawing, with hidden edges omitted or dashed. Vector occlusion splits
-partly hidden edges and includes curved silhouettes. Repeated part meshes and triangle
-hierarchies are shared; bounded desktop preparation and occlusion use up to eight workers.
-Curves are approximated; drawing sheets,
-annotations and exact projected curves remain deferred. See [view DXF](docs/view-dxf.md).
-
-Drawing foundations: [RFC #860](https://github.com/tangency-labs/solidcraft/issues/860)
-and the [foundation ledger](docs/drawing-foundations.md) track the bounded implementation
-packages. The first geometry increment defines validated section records in a plane-local
-frame; the ledger separates that contract from section producers and the Drawing workspace.
-
-Desktop view DXF export runs in the file-operation worker with five-stage progress and
-cooperative cancellation. Curve tolerance (0.0001–1 mm, default 0.01 mm) is remembered alongside
-the hidden-edge setting. Cancelled exports preserve the model and the previous destination;
-completed drawings publish atomically. The browser still exports synchronously.
-
-## Interactive modelling
-
-- Modelled threads preview their cut before OK using the background worker on desktop.
- Browser users apply the cut with OK to avoid blocking on every edit.
-
-- Thread resolves a suggested metric size when a cylindrical face is picked. Diameter and
- pitch selectors expose the existing metric designation parameter; custom designations stay
- editable, and Automatic size returns to the face's suggestion. Cosmetic/modelled and
- full/partial-length options remain available. This does not add tolerance classes or
- left-hand threads.
-- New Body extrusion and face-offset previews show completed intermediate geometry while a
- drag continues, then catch up to the exact final value. Changes to the selected geometry,
- operation or feature still discard obsolete results. Distance arrows and their value boxes
- follow the current frame's input.
-- Large fine modelled threads use pitch-based helix resolution and tighter faceted
- reconstruction fallbacks, preserving thin crests and closed shells on large shafts.
-
-## Physical material data
-
-- Physical material card validation (#923/#922) provides typed SI mechanical and
- thermal data, per-property sources/conditions and isotropic/orthotropic stability
- checks through read-only `material.properties.validate`. It does not assign or
- persist properties, provide a solver or enable rendering; see
- [the contract and staged follow-ups](docs/physical-material-cards.md).
-
-- Directional elasticity (#994) queries the validated card in material-local axes
- through read-only `material.properties.directional`, with source/condition review.
- It does not assign body frames, predict structural behavior or enable a solver.
-
-## Library foundations (#785, #786, #787)
-
-- Local scalar libraries (#846) inspect/export bounded portable catalogs and copy exact
- selected appearance/material revisions into existing design definitions in one undo step.
- Appearance offers local loading/search/export; physical materials use existing commands.
- This slice is independent of the render stack and does not change the document format.
- See [the contract and limits](docs/book/src/dev/local-libraries.md).
-
-- Proposed phases cover offline bundled/project/user packs, physical materials and
- appearances, editable wood mapping, and parameterized component/assembly families.
- Stable identity/revision, copied design definitions, provenance and resource limits
- apply from the first implementation. Existing material, appearance and standard-part
- commands remain the application paths. See [the proposal](docs/book/src/dev/libraries.md)
- for source/license review and acceptance gates. This is planning only: pack loading,
- texture rendering and expanded component families are not implemented by this entry.
-
-## Render foundation
-
-- Original starter appearances (#1722): 34 opaque recipes through existing commands, with six explicitly unavailable glass recipes and preserved legacy looks; see [the contract](docs/render-starter-appearances.md).
-
-- Bounded linear film accumulation (#1696) supplies caller-admitted mean/variance storage and complete-pass views; actual progressive consumers remain separate. See [the film contract](docs/render-film.md).
-
-- Definition-local visual mapping (#1214) supplies a bounded numerical frame, physical repeat coordinates and a deterministic one-time grain-axis suggestion. It adds no saved record or texture consumer; see [the mapping contract](docs/render-visual-mapping.md).
-
-- Explicit texture normalization (#1218) produces completed float RGBA with
- role-aware linear color/data semantics, bounded matrix/TRC ICC conversion and
- opt-in EXIF orientation. It retains high-precision raw samples and records lossy
- gamut clipping only when explicitly requested. It is not a renderer/resource
- consumer; see [the supported policy and limits](docs/render-texture-normalization.md).
-
-- Opt-in opaque PBR (#1046) connects persisted surface parameters to the integrated
- product viewport and CPU PNG, using a fixed direct-light studio. Geometry and mass
- stay unchanged. HDRI, transmission and textures remain separate gates.
- See [the consumer and limitations](docs/render-opaque-pbr.md).
-
-- Combined integration is tracked in #842, with independent scalar libraries in
- #863 and richer PBR/material-card transport in #1086. See [phase boundaries and validation gates](docs/render-integration.md).
- Render/library consumers use the merged asynchronous picker (#1127). Material-card
- UI (#1094), texture mapping and HDRI lighting remain explicit follow-ups.
-
-- R4a adds bounded CPU product-image jobs, cancellation and atomic PNG export through
- engine commands, the Render panel, CLI and persistent MCP. Immutable captures and
- results stay outside persistence/undo; native workers and cooperative browser tasks
- share the same work protocol. See [jobs, limits and export](docs/render-jobs.md).
-
-- R3 adds an overlay-free product scene and the integrated Render workspace, with
- runtime GPU host capabilities, per-document drafts and named camera/background
- controls. Design keeps its camera and drawing policy. Raster transparency remains
- approximate; PBR and environments are later slices. See
- [workspace and scene contracts](docs/render-workspace.md).
-
-- R2 adds bounded named render setups in document format 21 and the read/save
- `render.settings.get/set` commands. Proven render-only changes preserve geometry
- and prepared world data through undo/redo and checkpoint restore. This slice does
- not add a Render workspace, PBR, environments or image jobs; see
- [settings and refresh policy](docs/render-settings.md).
-- Bounded PNG/JPEG texture admission (#900) validates in-memory sources and returns
- completed RGBA8 pixels with explicit color/data roles. It is an input utility only:
- ICC/16-bit normalization, local wood mapping, resource persistence and the renderer
- consumer remain separate work. See [limits and licensed-file probes](docs/render-texture-input.md).
-
-- The initial opaque surface numerical contract for #1004 provides bounded linear
- color/metallic/roughness/IOR admission and an original tested direct-light BRDF.
- The numerical module alone advertises no capabilities; the installed consumer above
- provides rendering. See
- [the model, evidence and remaining consumer gates](docs/render-surface.md).
-
-- A bounded cooperative Radiance RGBE input utility is available in L1 render;
- it does not yet enable HDRI/PBR rendering or a document import command. See
- [the input contract](docs/render-hdr-input.md) and #813 for integration work.
-- R1 adds renderer-independent backend/profile metadata, strict request resolution and
- bounded image/scratch admission checks, exposed by the read-only `render.backends`
- command. It describes the current CPU raster snapshot path without evaluating the model.
- The legacy Design snapshot route remains unchanged. Later slices above provide the
- workspace/jobs and opaque PBR; HDRI and optional engines remain future work. See [the contract](docs/render-backends.md)
- and [the phased proposal (#620)](https://github.com/bherbruck/solidcraft/issues/620).
-
-## Dimensioning and error reporting
-
-- Operation length fields share design-unit defaults and input evaluation, including secondary
- distances, thin walls, blend controls, sheet/plastic rules, joints and motion keys. Canvas
- handles and sketch previews use the same lengths as committed geometry. Existing stored
- millimetre values retain their size when edited in a design using another unit (#3271).
-
-- MCP `execute` accepts `verbose: false`, sharing the compact reply helper used by
- `batch`: body changes and created sketch IDs stay, while repeated lists are omitted.
- Both tools retain full replies by default.
-
-- Sketch Create groups drawing variants under Line, Rectangle, Circle, Arc, Slot,
- Polygon and Spline. Each open part remembers its last interactive choice per family
- across sketch sessions and document-tab switches; closing the part resets these UI choices.
-- Inscribed, circumscribed and edge polygon tools preview their actual outline before
- placement, including orientation and the selected side count.
-- Construction (X) preserves the active sketch drawing tool, picked anchors and inline
- dimension values, so line type can change while a shape is in progress.
-- Planar sketch construction previews and hover feedback keep the same dashed pattern as
- committed geometry; centerlines retain their dash-dot pattern.
-
-- Point has a default Sketch CREATE toolbar button alongside the existing drawing tools.
- Saved custom layouts are preserved; Reset Toolbar restores the default Point button.
-- Construction planes cannot take an origin-plane name (XY, XZ, YZ, Top, Front, Right). Plane
- arguments reject such a name when an older design's construction plane already has it. Use
- the other alias, the construction feature's numeric ID or an explicit plane; existing
- stored references keep their saved meaning. Section Analysis uses the same check.
-- Sketch text can be edited from a letter interior or outline's context menu or the Edit Text command.
- Interior selection requires every profile boundary to belong to the same text source;
- the editor highlights the whole source without replacing profile selections.
- Content, baseline X/Y, height and rotation update the original text source in one undo step;
- cancelling or rejecting an invalid value preserves the sketch. Position and height fields
- use the document units captured when editing starts; generated outlines remain associated
- with their text source, and untouched inputs preserve their saved internal values.
- Dragging a text outline moves the entire source in one undo step; Escape restores the
- gesture. Move/Copy on a selected text outline provides unit-aware X/Y distances and rotation
- about its baseline; copies keep an independent editable text source.
-- Repeating the initial point of a planar multi-point sketch drawing tool is neutral: the tool
- waits for a distinct point without a degenerate-shape error or history entry. Typed input
- and programmatic commands retain their validation.
-- Circular-pattern and angled-plane axes reject explicitly supplied malformed or expression
- origins instead of silently rotating about zero. Numeric origins remain in millimetres;
- associative axis expressions and construction-axis references remain unsupported.
-- Single-line and rectangle-side dimensioning supports selecting a line or its two endpoints.
- Type a value and press Enter to commit one undo step; rejected values remain editable and
- cancellation leaves the sketch unchanged. Fit keeps geometry clear of the Sketch Palette
- and navigation controls, including enlarged displays and nested pending placements.
-- Sketch Dimension takes a line and a circle or arc (#1803): it measures from the line to the
- circle's edge (the gap, 0 when tangent, or how far the edge reaches past a line that cuts
- it), drives it like any other dimension and keeps the circle on its side of the line.
-- Sketch Dimension takes a point and a circle or arc, or two circles or arcs (#4064): it
- measures to the circle's edge (from the point, or between the two edges: the gap, 0 when
- they touch, how far they overlap, or the narrowest gap between nested circles).
-- Sketch annotations, live drawing lengths and Measure use document units. Inches show
- three decimals and retain a meaningful fourth digit. Bare length dimension entry captures
- the current design unit; changing units leaves existing geometry and expressions intact.
- Component/canvas distance controls, sketch cursor coordinates, flat-pattern dimensions
- and pocket depths, interference volumes and parts-library lengths also use design units.
-- Curvature and Polygon constraints accept complete preselected operands. Fix/Unfix
- consumes complete point/curve selections consistently; mixed or ambiguous selections
- retain the picking workflow. Rejected constraints preserve selection and undo history.
-- Contextual error reporting: a **Create Issue** action beside feature errors opens a
- reviewable GitHub issue draft with the error, operation settings, build diagnostics and
- useful reproduction context. The draft is editable, with optional capture of the actual
- viewport and copy/save controls. Opening GitHub does not submit the issue. Help also exposes
- reporting for unexpected results that did not produce an error.
-- The header exposes **Report a bug**, including an accessible compact control on
- narrow windows. It opens the same editable report and screenshot review without
- changing the active model or a pending dimension.
-- Crash reports: every panic (in a command, in the kernel, anywhere else) and every unclean
- exit (abort, stack overflow, kill: found at the next start through a locked per-run command
- journal) leaves a local report with the backtrace, version and commit, the command and the
- design that reproduce it (`solidcraft-cli crashes replay <id>`). Repeats are counted, not
- rewritten; at most 20 reports, 50 MB and 90 days. The app shows them after a crash (Help >
- Crash Reports…) with a reviewed issue draft; agents read them through
- `diagnostics.crash_reports`, the MCP `crash_reports` tool or the CLI. Nothing is sent
- anywhere. See [crash reports](docs/crash-reports.md).
-- Agent chat (off by default, desktop): a side panel that drives a coding agent the user
- already has (Claude Code through its ACP adapter, Codex, Gemini CLI, OpenCode, Grok Build, …) over the
- Agent Client Protocol, under the user's own login; SolidCraft stores no keys. The agent works
- through SolidCraft's MCP tools on a gated endpoint of its own: file actions wait for Allow or
- Deny, crash reports are off limits, 24 changes per message, one undo step per message, and
- the agent's whole process group ends with the panel or the app. Docks left or right,
- minimises to a strip. Grok Build discovery includes `~/.grok/bin` and reuses the user's
- Grok login. See [agent chat](docs/agent-chat.md).
-- Command scripts from designs (#886): `timeline.export_script` (CLI `solidcraft-cli script`)
- writes a design's history as a script that `eval` and `run` replay into the same design —
- user parameters, units, sheet metal and plastic rules and materials as their own commands,
- then each feature through `timeline.add` with its ids, names and dimension parameters kept,
- so every feature kind replays exactly and a failing feature fails the same way. Trimming the
- script after a step gives the design at that step. Appearances, folders, views and
- configurations are listed as left out; components and joints are not supported yet.
-
-## 0.2.0 release batch
-
-- Includes the new axis navigation, adaptive sketch drawing/picking, origin-corner repairs,
- durable supported profile/face references, endpoint dimensioning and contextual reporting.
-- Smooth ruled-wall display joins are hidden only within the supported geometric certificate;
- authored splits and actual creases remain protected. Wireframe retains physical edges.
-- Paste New uses a bounded current-geometry comparison for supported convex line/circle
- prisms with separated circular holes; unsupported shapes retain the existing strict check.
-- Common-bore Union retries check additional boundary curves before recutting the bore,
- preventing the reproduced thin-web loss. Unknown additional trims refuse; inherited
- common-cylinder trims retain their existing policy, so this is not a general Boolean proof.
-- Exact full-path assembly joint editing remains separate work and is not part of this batch.
-- Stable 0.2.0 is published: all release payload checksums, native cold reopening, deployed
- web app and both Flatpak architectures were verified. The replacement README demo uses
- the original electronics enclosure story and animated pointer in the actual English
- 0.2.0 UI, at 4× playback. Publication follows [the release workflow](docs/releasing.md).
-
-## 0.2.1 critical fixes
-
-- Separated multi-profile Join/Cut extrusions into one solid target batch their tools using
- conservative construction bounds, avoiding a Boolean rebuild for every profile. Live
- extrusion previews build only their tools; confirmation validates the final Boolean.
-- Coplanar selected body faces share one linked sketch and one extrusion. Automatic Join/Cut
- keeps the evaluator's participant scope, including parts of an empty imported component. Desktop OK/Enter
- computes on a scratch session in the background, with atomic acceptance and cancellation.
- Planar section stitching projects lines/arcs analytically and removes duplicate endpoints.
-- Imported rotated face groups can check all full start-face seams in one guarded
- construction. Separated tools may batch a Join when each meets the same single body;
- nearby uninvolved bodies retain the original contact decisions. Regression comparisons
- cover all four extrusion operations.
-- Inward multi-face cuts retain every eligible target and subtract separated tools together.
- Safe interior classification handles roundoff at shared imported line/arc endpoints.
- Straight extrusion feedback caches existing face/profile triangles and updates the display
- directly, including a newly opened STEP's single identity component placement; other
- extents, moved or repeated components and curved sketch profiles keep the Engine preview.
-- The extrusion fixes retain tracked Boolean history and the current `solidcraft` packages.
- Confirmation and tool previews use main's shared background calculation. Main's collapsed
- blend-wall refusal and its tests are retained, including smaller valid radii and mirrored parts.
-- Axis view and navigation controls stay anchored to the viewport when feature dialogs or
- the command palette open, at normal and enlarged display scales. Fit still accounts for
- dialog coverage; covered controls do not receive clicks through dialogs.
-- Eligible planar faces survive fillet, chamfer and shell operations with exact source
- certificates. Sketches placed directly on the enclosure wall and inner floor follow
- width and wall changes, including after the USB cut and cold reopening.
-- Remove artificial straight-wall and rounded-corner subdivisions left by shell and
- extrusion cuts. Identical generated wall segments span adjacent slabs as one physical
- face, with exact full-height supports and boundary stitching. Preserve authored face
- splits and face appearances. Permanent regressions cover material, STEP, reopening and
- unaffected bodies across the extrusion end plane.
-- Feature dialogs use the available screen height for their fields, with OK and Cancel
- outside the scrolling region, including enlarged display scales.
-- Design format 13 records shell-face attachments. Older designs remain readable;
- newly saved designs require 0.2.1 or later. Ambiguous or unsupported faces still refuse
- attachment rather than guessing a plane.
-- Saved projections from a removed strip retain their geometry and report the lost
- reference. Explicitly reselect the wall to repair that projection.
-
-## Workspace layouts (#2029)
-
-- General preferences save Floating or Compact using the universal UI containers.
- Compact joins the workspace selector and ribbon, docks the content-hugging Browser
- flush beneath them with a square join, and opens tool sheets below the compass.
- Sheets remain draggable, rounding all corners away from their right dock; footer
- backgrounds follow the same corners. A separate preference hides ribbon icon labels
- for a shorter ribbon in either layout.
- Assistant keeps the outermost edge and History keeps its chosen dock. Switching
- retains the active tool, camera, selection and design; system windows and menus
- keep their existing behavior.
-
-## View navigation
-
-- Navigation has an opt-in Free orbit preference for mouse and 3D-mouse rotation through
- both poles with roll. It defaults off, preserving existing preset snapping and pole limits.
- The SolidWorks face menu offers Normal to Selection (`view.normal_to`), shared with Look At
- and Ctrl+8, including repeat-to-flip, preserving scale and projection.
-
-- Desktop Ctrl/Cmd +/- and 0 change or reset the saved UI scale. The scale slider keeps
- its layout stable during a drag and applies the selected scale on release.
-
-- OpenSCAD navigation preset: left drag orbits, right/middle drag pans, Shift+right/middle
- drag zooms, and the wheel zooms. Available in the shared desktop/web Navigation preferences.
-- Compact clickable signed X/Y/Z axis tips, smooth drag-to-orbit, and Shift-orbit snapping
- to 26 standard and diagonal views. Pointer motion accumulates independently of a lightly
- damped spring, with a boundary margin to prevent flicker. Z-up/Y-up and the nearest square
- top/bottom heading are preserved. Diagonals include 45-degree edge and isometric corner views.
-
-## Known limitations
-
-- Scheduled and manual CI scan locked dependency advisories, bans and sources with
- cargo-deny. Vulnerabilities fail the scan; unmaintained crates warn. Local vendored
- patches require separate upstream review because advisory databases cannot version-match
- their path dependencies. Pull requests retain the existing licence checks.
-
-- Associative shell-face sketches require a unique certified planar source. Nested shell
- attachments and ambiguous coincident sources remain unsupported.
-- G2 fillets: exact quintic blends of straight edges between planar faces, with one planar
- end face at each end, including sloped ends (#2708). The UI and `solid.fillet` expose
- `curvature` (alias `g2`); the size is an equivalent circular setback. Curved faces/edges,
- multi-face ends and corner junctions remain unsupported.
-- Fillets and chamfers: constant, variable-radius and chord-length fillets; a radius per edge,
- rounds next to earlier rounds of another radius, and smooth corner patches where three rounds
- meet (a sphere for equal radii); perpendicular corner fillets after a closed ring of earlier
- rounds preserve the ring's radii and the enclosed planar face (#1557);
- mitres between separate rounds of the same radius keep their endpoint tangent, so a later
- fillet can select an upright and its adjoining bottom mitre as one chain (#2422);
- straight edges (convex or concave) between planar faces with perpendicular
- planar end faces (equal-distance chamfers also meet sloped planar end faces, including inner
- basin rims within the rim width); convex fillets also meet sloped planar ends and reflex
- corners around pocket rims, with unequal wall slopes and extensions confined to the face;
- connected equal-distance chamfers also trim each other across unequal sloped rim walls;
- curved chamfer chains with straight planar ends can terminate across two existing planar
- bevel faces, splitting their shared seam; picks on the same tangent chain are applied once (#1303);
- whole smooth loops of a planar face, picked whole or by one edge (tangent
- chain), including circles and walls at any angle (boss bases and tops, bores, pocket floors,
- plate outlines), loops with sharp corners between straight or mixed arc/line edges (straight
- blends meet in mitres; perpendicular curved walls use offset intersections, with D-rim removal
- checked within 0.1% of analytic offset slices), runs of
- neighbouring edges along a planar face's loop (two top edges of a box: mitred, ending square;
- with the edge between them too, the corner becomes a sphere octant),
- rounded corners rounded again (sphere octants, tori at concave corners); every edge of a
- convex planar body or of an extruded part; fillets inside patterns; closed chains of curved
- edges between any two smooth sides (a branch pipe on a main pipe), by a rolling ball (the
- blend a rational B-spline through exact arcs), closed or ending at planar faces square to the
- edges, where straight or curved cap edges are trimmed to the contacts (the straight edge
- between two overlapping extruded arcs); knife edges, where the two faces have opposite
- normals (a wall that runs out tangent into a face: the ball that fits there); an edge that
- runs out along an end face tangent to one side (the arc top edge of that wall), cut where the
- blend meets it; rounds that end in an earlier round on curved faces, in any order (the rounds
- of two edges at a vertex meet in a crease, as on a box), picked together or one after the
- other, except a round after a round of the edge between the wall and a flat face that it
- would run over; the three edges at a vertex of any smooth faces, of one radius, end in a
- piece of sphere. A limiting blend that collapses a side wall into coincident boundary
- curves is refused as too large rather than returning an unmeshable face (#1113).
-- Booleans: prisms along one direction (plates with holes, slots, patterns of them, equal
- sections stacked end to end) are combined exactly in 2D. Qualified axial cuts preserve
- annular holes with overrun cutters, including inward Press Pull after a joined extrusion;
- curved wall qualification rejects false transverse axes instead of filling holes.
- Bodies touching along one whole face
- (a part and its mirror image) are stitched; coincident planar faces are pushed apart when
- their neighbours are planes or cylinders. Other coincident curved configurations can still
- fail. Bounded containment classification preserves fully internal cavities and nested
- material islands independently of shell order, with STEP round-trip and material-membership
- regressions. Near-contact curved shells use the general boolean path rather than a
- containment shortcut. Spheres are built from six pole-free patches.
-- Mass properties come from fine tessellation (curved faces within ~1e-4 relative); triangles
- that cut through curved faces (trimmed faces after booleans) are split onto the surface first.
-- STEP import (our own reader, crates/kernel/src/step_in) reads solids (B-rep with analytic and B-spline geometry), units,
- product names, colours and assemblies; analytic offsets on planes, cylinders, cones, spheres
- and regular tori are read exactly (signed/nested distances, units and face sense). Freeform
- offset surfaces and pcurve-only edges are not read yet,
- and assembly components are flattened into bodies. Closed periodic faces (torus, B-spline
- bands) are split in two for meshing; measure() uses a finer tolerance for small radii.
-- Persistent naming follows the kernel's exact face history (docs/book/src/dev/naming.md):
- references resolve by name first, follow splits and merges, and warn when the entity split,
- merged or vanished, or was found by geometry only (operations that report no history yet).
- New planar sketch attachments use exact box, extrusion cap/side and immutable imported-face
- source certificates with checked target and author occurrence paths. A missing or changed
- source fails explicitly; Redefine Sketch Plane previews reattachment or a fixed plane while
- retaining current geometry and dimension identities. Unsupported modified faces need an
- explicit fixed plane. Legacy attachments retain their original resolver behavior.
-- Modelled threads are cut as a faceted body (curved faces within 1/200 of the pitch); Extrude
- and Revolve To Object on a curved face cut the tool back to the target's surface.
-- Explicit sketch breaks preserve exact ellipses, fit/control splines (including high degrees)
- and conics; analytic trim/break also sees free-form cutters. Free-form curves cut at a tangent
- touch (no clean crossing) enter that profile as polylines.
- Sweeps along 3D sketch curves follow their polyline (smooth walls when the path is smooth).
- A sweep with a twist, an end scale or a parallel or direction orientation (#771) follows its
- path that way too, even along sketch lines and arcs: B-spline walls through stations, ruled
- walls through denser stations where the path has corners or the profile has holes.
- Guide rails (one or two, #771) do the same: each station meets every rail once, and the rail
- turns the profile and scales it (or stretches it across to the rail) against the start; two
- rails carry it between them. Rails along a path with sharp corners are refused for now.
-- Extend intersects exact ellipses and rational/high-degree splines without moving the line or
- circular support. Associative free-form offsets have a whole-span 0.002 mm normal-distance
- certificate and refine within bounded node limits while retaining existing IDs.
- At the node limit, geometric certificate subdivisions accommodate unequal spline parameter
- speeds without changing stored nodes or relaxing the distance tolerance (#971).
- Associated offset fit nodes stay hidden from display, picking and snapping; dragging the
- editable source updates the derived boundary live. Break Association restores point editing.
- Singular, self-intersecting and ambiguous curves refuse atomically; mixed junctions and nonsmooth
- closed natural-spline seams remain limitations. New explicitly closed fit splines and closed
- offset outputs use periodic C2 interpolation, supporting repeated certified offsets; older
- natural splines are preserved. Clicking the starting fit point deliberately closes a new loop.
- Newly captured adaptive profile references with complete source coverage retain their outer
- and hole identities through span-count changes, including parameter edits after extrusion.
- Partial, intersected or ambiguous boundaries do not qualify for these whole-source references.
- Legacy curve-span multisets remain exact and unchanged; already-lost selections may need
- reselection. Format 12 stores the new bounded whole-boundary references.
- Projected analytic boundaries follow nested loop identities through resizing, including
- stationary holes and rounded corners. Supported convex, tangent line-and-arc boundaries
- can lose or regain corner arcs during an inset while preserving reserved curve identities
- and linked profile selections. Format 12 saves those associations; compatible older closed
- offsets upgrade structurally without changing their curve IDs. Breaking an association
- freezes its current boundary and materializes downstream profile references. Child offsets
- of a boundary with retired arcs still require breaking its association first; mixed or
- nonconvex junctions and retained references to disappearing individual arcs remain limited.
-- Extrude and Revolve editors retain original direction, extent expressions, explicit targets,
- axes, From/To inputs and All-profile intent. No-op edits preserve downstream dimension names
- and selected occurrence frames; cancel and successful edits preserve one-step undo history.
- Placed feature edits preview through the edited timeline entry, and cylindrical Emboss guides
- use the sketch's actual target, author or uniquely placed third-component frame.
- Revolve rotators follow the actual signed axis and support symmetric and two-sided extents;
- dragging a To Object extent converts its derived value to an explicit angle. Legacy reversed-axis
- symmetric geometry is preserved through format 11's explicit legacy convention. New revolves
- use the sketch-normal direction for each selected profile, including To Object and curved
- target trimming, independently of the selected axis sign.
-- Cylindrical emboss/deboss wraps bounded orthogonal line profiles, including holes, concave
- outlines and nested islands, onto complete exterior cylinders or coaxial sleeves with exact
- radial walls. New features infer a unique eligible cylinder when the face field is empty;
- ambiguous targets require an explicit face. Saved target
- and author occurrence paths retain the chosen placements; missing/split faces refuse rather
- than retarget. General free-form profiles, seams, stepped cylinders and other curved surfaces
- remain unsupported. STEP round-trip and independent radial/volume checks cover this subset.
-- Shell and offset faces work on bodies of planes, cylinders, cones, spheres and tori (convex or not:
- filleted boxes, bosses, domes, countersinks; corners where four or more planes meet, such as a
- floor falling to a drain, as long as the corner's edges are all convex or all concave); draft on convex planar bodies and on walls (planes, cylinders → cones) between caps; lofts through three or more sections are smooth (B-spline sides through every section), two
- sections ruled. Circular-meridian barrels retain curved inner walls through either axial
- opening (#2421). Solid lofts preserve holes through sections with matching hole counts
- (#2435), including inner walls and caps with openings; a hole cannot appear or disappear
- between sections, and sections with holes cannot collapse to a point.
-
-- Sketch corner tools: fillet and all three chamfer modes pick a connected corner even when
- its endpoint overlaps the fixed origin or a loose point. Ordinary drawing still snaps to
- the origin; clicked UI regressions verify geometry, closed profiles and undo.
-- Sketch display: drawing, picking, highlighting, tool previews and profile shading share
- adaptive projected curve boundaries. Fit, zoom, display scale and placed sketch frames
- invalidate the display cache without changing CAD geometry or timeline history. Work
- budgets and clipped paths prevent unbounded sampling or invented edges across the eye plane.
- The Sketch Palette scrolls its options on short windows and enlarged displays while
- keeping constraint status and Finish Sketch visible.
-- Face projection: closed boundaries have a deterministic outer-first order. Refresh matches
- existing geometry before assigning positions, retaining saved curve IDs and constraints
- across enumeration changes and resize, including concentric circles. Ambiguous identities
- retain the last geometry and report a lost reference; permutation matching is bounded.
-- Project accepts complete supported preselection in one undo step. Visible external sketch
- curves and points retain their source sketch identity; model geometry, axes and planes use
- the existing linked projection commands. Rejection preserves the document and selection;
- mixed selections retain ordinary tool-first picking.
-- Inline sketch dimensions: Tab and Shift+Tab cycle within the active shape's value boxes,
- selecting visited values for replacement. Expression completion retains forward-Tab
- priority; real keyboard regressions cover rectangles, lines and single-value circles.
- Typed lengths, radii, line angles, signed arc sweeps and slot lengths persist as constraints
- and expressions through save/reopen. Shape creation and its dimensions form one undo step;
- rejected values keep the editable field focused.
-- Repeated components: Browser selection, visibility, properties, copy and Move/Copy use
- checked occurrence paths. Active nested occurrences author planar sketches and solids in
- their selected frame. Pending moves compose through parents; dialog cancellation restores
- its selected move. Source materials and body/face appearances follow transformed instances.
- Shared nested definitions remain shared. Deep Paste New copies reachable definition graphs,
- independent feature/input histories, styles and internal motion records, with bounded geometry
- checks and explicit external-link notices. Paste New selects the copy while preserving the active
- authoring context. Imported periodic STEP seams survive placement and reexport with shared
- topology and appearances intact. Recorded body transfers preserve historical Join/Cut membership,
- material, placements and machining data through edits, copying, undo and reopen. New 3D wires
- record their coordinate frame; legacy wires migrate from known provenance without changing
- coordinates. Broken legacy links with missing provenance can require explicit refresh or relink.
- See [occurrence workflows](docs/occurrence-workflows.md).
-- Toolbar drops on panel labels, gaps and margins append commands with insertion feedback;
- button drops keep insert-before ordering.
-- Parameters and Configurations have distinct actions in the SOLID toolbar's CONFIGURE panel.
- Parameters opens the user/model variable editor; Configurations opens the configuration table.
- Configure remains available in the panel dropdown.
-- Parameter creation supports Enter with validation and continued keyboard entry. Shared
- expression autocomplete supports Up/Down selection, Enter/Tab acceptance and Escape dismissal;
- accepting a suggestion does not submit a parameter or trigger viewport shortcuts.
-- Movable window title bars follow the app's dark/light header palette. Radial right-click
- menus are opt-in in Preferences > Navigation; ordinary context menus remain the default.
-- Desktop distribution: running Windows windows and executable resources use the app icon;
- packaging validates icon resources. Nix installs launchers, MIME data and generated icons,
- with explicit launch apps and Vulkan-loader/driver discovery. Flatpak feed instructions
- register the required runtime source; release checks exercise desktop modelling on X11/Wayland.
-- OpenGL rendering clamps effective anti-aliasing to 1x across UI pipelines, textures and CAD
- callbacks to prevent black frames. Other backends retain the requested sample count, and
- stored preferences remain unchanged.
-- Configuration rules: ordered typed conditions can drive parameters and suppressions or
- restrict values. Preview explains effective values without modifying the document; applying
- rules validates rows atomically. Length expressions retain their authoring units across
- document-unit changes. The UI supports structured All/Any/Not conditions and rule ordering.
- Component styles and certified semantic face styles are available; unsupported lineage refuses
- atomically, and stale certified face paint cannot jump to another surface. See [configurations](docs/configurations.md).
-- Sheet-metal material: inherited holes, crossing edge notches, overlapping cuts and retained
- islands share the same boundaries in flat preview, DXF and unfolded solids. Detached material
- pieces survive unfold/refold as one logical sheet group, including split flanged sheets.
- Cut-outs made in the flat pattern cross bends at any angle or curved: their edges fold to
- helices and curves on the bend, their walls square to the sheet. Free-form bases use bounded
- sampling.
- Parallel prismatic partial-depth cuts retain pocket side and depth through transfer and
- unfold/refold, with separate pocket contours in preview and DXF. Planar Intersect preserves
- exact holes and retained islands, including the union of multiple selected profiles, and
- records complementary depth layers as pockets while retaining the stock gauge. Unsupported
- tapered or bend-crossing machining refuses atomically instead of restoring material later.
- Sketches attach to a sheet's flat faces (base and flanges, either side) by panel, in the
- flat pattern's coordinates, and follow it through rebuilds and unfold/refold.
- A flange on another flange's far edge (a return) follows that flange's closed end and keeps
- clear of the flange beside it, and the returns of one feature are mitred toward each other
- with the rule's gap where their flanges meet at a corner; returns of separate features, and
- flanges on returns, are not closed toward each other.
-- Rolling-ball fillet accuracy: independent offset-cylinder tee references check surface
- distance, actual trimmed tessellation, supporting-cylinder contacts and tangency at two
- scales. The measured trimmed-part error is below 0.0001 mm; this is an analytic geometry
- check. Under-resolved fits return an error.
-- Contact driving checks the trajectory between clear endpoints, including linked joints,
- playback and sparse motion exports. Checks use bounded tessellation samples, not exact
- continuous collision detection; local thin walls and small details remain limitations.
- See [contact-set limits and recovery](docs/contact-sets.md).
-
-## Assembly dragging
-
-The design's first part is grounded when it is made, and a left-button drag repositions a free part (`occurrence.drag`: one undo step, exact occurrence paths including repeated jointed definitions, any floating-chain member carries the chain, grounded parts and joints hold where present, Escape cancels).
-
-## 3D sketch bridges
-
-3D sketch drawing snaps to points on other visible sketch planes without flattening them onto
-the active plane. Bridge endpoints capture their source positions; associative endpoint links,
-construction-plane selection of 3D wires and loft guide rails remain separate work.
-Feature dialog header chevrons collapse and restore the form without discarding selections
-or edited values, including the Appearance panel.
-## Construction on 3D paths
-
-Plane Along Path has a viewport path selector, fractional position, live preview and timeline
-editing. Construction planes and points resolve drawn 3D wires without applying their sketch
-plane a second time. Curved paths use sampled segments; multi-curve chains, absolute distance
-and reference-object placement remain separate work, as do loft rails and centerlines.
-
-## Design properties (#1015)
-
-- Designs carry project, part number, revision, author, organization, description and licence
- in an optional `metadata` object (File → Design Properties…, `document.metadata.*`,
- `inspect_design`). STEP and IGES headers and 3MF model metadata take the fields their format
- has a place for. Other tools keep their own data under a reverse-DNS key, kept as it is
- through open, edit and save and never exported. See [design properties](docs/book/src/guide/files.md#design-properties).
- Per-component properties (a part number per component) can follow with the same type.
-
-## Document-opening performance
-
-- Desktop STEP import prepares consecutive independent solids in bounded batches with up
- to eight workers, retaining serial traversal, result order and persistent source identities.
- The web path remains serial. Original multi-solid fixtures show 64–81% lower complete
- import times; single-solid assembly parts are not scheduled across nodes. See
- [measurements and limits](docs/perf.md#parallel-step-body-preparation-2026-10-12).
-- Design containers (#303, phase one) separate and deduplicate STEP, raw images and
- lossless binary mesh arrays while keeping plain JSON as a supported Save As/export
- format. Generated-mesh storage measurements reduce serialization and decoding work;
- a seekable reader defers original blobs until after provisional display.
- See [container format](docs/design-container.md) and [performance measurements](docs/perf.md).
-- Warm saves with explicit `cache: true` can include a versioned native B-rep cache through SolidCraft-owned topology
- and geometry records, with a separate truck adapter and bounded binary reader. Exact
- face-source certificates and operation history survive codec round trips. A provisional
- picture can be generated before original blobs are read; editing and measurement wait
- for authoritative reconstruction. Cached metadata binds preview and reconstruction to
- the same document despite concurrent file writes. Default saves omit this cache and never force cold
- evaluation or meshing; explicit `preview: true` remains a separate warm-mesh option.
- Keys, resource budgets and document/revision guards reject incompatible, hostile or
- stale results. A second modelling kernel still requires its own tested adapter.
-- Warm saves with explicit `cache: true` can also carry a bounded PNG thumbnail from already cached meshes.
- Home reads it without rebuilding the design when its local picture is missing;
- mismatched or malformed thumbnails fall back to normal generation. The image is
- kernel-independent and saving never forces cold meshing to produce it.
-
-- Cold rebuild profiling separates parsing, geometry, placement, display meshing and
- thumbnails. Straight-line closest-point projection and exact curved-surface evaluation
- reuse reduce repeated work without relaxing geometry checks. Three alternating optimized
- benchmark runs reduce median rebuild time by 26% on the public sensor enclosure and 22%
- on a local case assembly; shape measurements and topology match the original build.
- See [performance measurements](docs/perf.md). Further cold Boolean and import costs remain.
-- Prepared assembly geometry survives selection and view changes while real geometry and
- placement changes invalidate it. A Pi assembly edge-selection probe drops from 9.24 s to
- 0.57 s; initial opening is unchanged. Actual Windows desktop profiling measures 15.87 s
- median opening, with 82% spent rebuilding geometry; halving full opening remains open.
-
-## Kernel
-
-- Successful Boolean retries report their strategy and numerical adjustments as
- feature warnings and structured inspection data. Diagnostics survive cached
- evaluation, undo/redo and cold reopening; the robustness runner counts retry
- events by strategy and reports any bounded-log truncation. Existing geometry
- acceptance checks remain in force.
-
-- Cylinders of one radius whose axes cross (a second bore across a bore of the same size, a pipe
- tee of equal pipes) touch at two points, where the mesh intersection cannot trace the curves
- and a boolean cannot tell the four arms of the crossing apart. When the ordinary boolean fails
- on such a pair, both faces are split along the line of their cylinder through the touching
- points (the solids are unchanged), the boolean is taken of those, and its history is composed
- back over the operands as given (#788). The result keeps the split lines as edges of the bore
- walls. A crossing the ordinary route fails on and the split faces do not help (a radius of 17.5
- in a 45 mm block with a tool of 80 mm) is still refused.
-- Boolean intersection-curve construction refuses point-only, collapsed and non-finite
- polylines without panicking. Direct constructor regressions retain valid open endpoints
- and closed spherical intersections; the original interactive trigger remains unidentified.
-- Shell of a stepped, joined planar body no longer creates horizontal subdivisions across
- continuous walls. Fresh axis-aligned Cut walls are stitched using their exact construction
- support and shared topology, preserving real steps and intentional boundaries. The local
- reported case returns from 86 to 49 faces with unchanged material and bounds; regressions
- cover stepped stock, STEP round trips and saved projections from removed pieces.
-
-truck (Apache-2.0) behind our own `kernel` crate, with our own blend operation and boolean
-retry/validation; see `plan/adr/0001-geometry-kernel.md` (local) — summary in README.
+The short version, for people who use SolidCraft. The detailed developer status (milestone
+tables, limitations, measurements) is in [docs/roadmap-detail.md](docs/roadmap-detail.md).
+
+## What SolidCraft is
+
+SolidCraft is open-source parametric 3D CAD written in Rust. You sketch, constrain, extrude, and
+change a parameter to watch the timeline rebuild. It runs as a desktop app and in the browser
+([try it](https://solidcraft.io/app)), and it has a command-line tool and an MCP server so that
+scripts and AI agents can drive the same commands you use.
+
+## Works today
+
+- Sketching with a constraint solver, and the usual create and modify tools.
+- Extrude, revolve, loft, sweep, coil, fillet, chamfer, shell, draft, holes, threads,
+ patterns, mirror and split.
+- Parameters with units and expressions, and configurations.
+- Faces and edges keep their names through edits, so references survive changes.
+- Components, assemblies, joints, motion studies and exploded views.
+- Sheet metal with flat patterns and DXF export, and a plastic-enclosure subset.
+- A Render workspace with GPU rendering, studio lighting, materials and image export
+ (first release in 0.22.0).
+- Import and export of STEP, IGES, 3MF, STL, OBJ and DXF, and FreeCAD and Rhino files.
+- Autosave and crash recovery, and the browser build of the same app.
+
+The full list of commands is in [docs/features.md](docs/features.md). Release notes for each
+version are on the [releases page](https://github.com/tangency-labs/solidcraft/releases).
+
+## In progress now
+
+Each feature below is a [milestone](https://github.com/tangency-labs/solidcraft/milestones) holding
+the issues for it, so the count shows how far along it is. Counts are as of 2026-10-25, one per
+feature or request. Work merged on a feature branch (`drawings`, `render`) counts as built but
+reaches the app only when that branch merges. They are rough, not a promise.
+
+- **[Rendering & materials](https://github.com/tangency-labs/solidcraft/milestone/17)**: in progress, 9 of 34 pieces done, 3 of them built only on the `render` branch and in the app when it merges. The basic Render workspace is already in releases (0.22.0); the interface rework (#6281) and the material and light libraries are what is left.
+- **[Drawings](https://github.com/tangency-labs/solidcraft/milestone/8)**: in progress, 3 of 21 pieces built (2 in releases, 1 on the `drawings` branch), and 3 more partly built there (sheets and borders, bill-of-materials types, the paper scene). Not in the app yet: it lands when the `drawings` branch merges. Today you can export the current view as a DXF.
+- **[Sheet metal](https://github.com/tangency-labs/solidcraft/milestone/15)**: in progress, 1 of 30 requests done. Flanges, hems, unfold and flat patterns already work; the 30 are extensions, mostly the per-edge flange options (segments, miters, partial flanges, reliefs) and bend allowance.
+- **[Sketching](https://github.com/tangency-labs/solidcraft/milestone/14)**: in progress, 12 of 50 pieces done. Dimension types, selection and snapping options.
+- **[Solid modeling](https://github.com/tangency-labs/solidcraft/milestone/2)**: in progress, 9 of 50 pieces done. Blends, holes, threads and patterns.
+- **[Assemblies & joints](https://github.com/tangency-labs/solidcraft/milestone/3)**: in progress, 4 of 19 pieces done. Joints, motion studies and exploded views already work; placement rules, linked sub-assemblies, fastener stacks and weldment corners are the pieces left.
+- **[Import & export](https://github.com/tangency-labs/solidcraft/milestone/5)**: in progress, 7 of 39 pieces done. FreeCAD, SolidWorks and point-cloud import, and mesh export options.
+- **[AI agents & MCP](https://github.com/tangency-labs/solidcraft/milestone/18)**: in progress, 2 of 8 pieces done. Agent chat and the MCP server.
+- **[Interface, web app & plugins](https://github.com/tangency-labs/solidcraft/milestone/4)**: in progress, 31 of 96 pieces done. Ribbon redesign, navigation, themes, the web app and plugins.
+- **[SMLib kernel migration](https://github.com/tangency-labs/solidcraft/milestone/1)**: in progress, 1 tracking issue open. The kernel is moving from truck to NVIDIA's SMLib (usd-brep, Apache-2.0) on the `kernel-smlib` branch; it is not in releases yet. Tracked in [#4012](https://github.com/tangency-labs/solidcraft/issues/4012).
+
+## Next
+
+- **[Surfacing](https://github.com/tangency-labs/solidcraft/milestone/16)**: next, 6 of 14 pieces done. Patch, trim, blend and match exist; the rest of the surface toolset is planned.
+- **[Manufacturing / CAM](https://github.com/tangency-labs/solidcraft/milestone/9)**: next, 1 pieces tracked, none done. There is no CAM in SolidCraft yet. Send to Slicer and a first toolpath slice are in review; proposals are [#1153](https://github.com/tangency-labs/solidcraft/issues/1153) and [#1621](https://github.com/tangency-labs/solidcraft/issues/1621).
+
+Features are not tied to a release or a date. Work lands in the daily releases as it is finished.
+Anything without a milestone, such as bug fixes, is not a feature and is not listed here.
+
+## How releases work
+
+- Releases ship daily, as numbered versions (v0.22.0, v0.22.1) with nightly pre-releases in
+ between. They are delivered through the in-app updater.
+- SolidCraft tells you when a newer stable release exists and never updates without asking.
+ Where it can replace itself safely (AppImage, Windows installer and portable builds) there is
+ an **Update now** button; downloads are checked against the release's SHA-256 list. See
+ [updates and privacy](docs/book/src/guide/updates.md).
+- Design files carry a format number. A new version opens designs from older versions, but an
+ older version refuses a design saved by a newer one (0.22.0 writes format 35, and 0.21.0 and
+ earlier will not open it). Each release's notes say when the format changed. Keep a copy of
+ an important design before you move to a new version.
+
+## Licence
+
+SolidCraft is licensed MIT OR Apache-2.0, at your option; see [LICENSE-MIT](LICENSE-MIT) and
+[LICENSE-APACHE](LICENSE-APACHE). Versions already released stay available under those licences
+permanently.
+
+## How to follow along
+
+- Feature milestones: <https://github.com/tangency-labs/solidcraft/milestones>
+- Issues: <https://github.com/tangency-labs/solidcraft/issues> (area labels such as
+ `area:kernel`, `area:sketch` and `area:ui` group them)
+- Discord: <https://discord.gg/FtU4NQNVDH>
+- Releases: <https://github.com/tangency-labs/solidcraft/releases>
+- Contributing: [CONTRIBUTING.md](CONTRIBUTING.md)
diff --git a/docs/capabilities.md b/docs/capabilities.md
index a1d909e32f..5512c0b05a 100644
--- a/docs/capabilities.md
+++ b/docs/capabilities.md
@@ -1,12 +1,12 @@
# What works
-The full feature summary, moved out of the README. The commands by area are in [features.md](features.md); status and plans are in [ROADMAP](../ROADMAP.md).
+The full feature summary, moved out of the README. The commands by area are in [features.md](features.md); status and plans are in [ROADMAP](roadmap-detail.md).
**Status: early but usable for simple parts.** 75 of 76 public reference parts
match their analytic or FreeCAD-computed volume, area, centre of mass and bounding box
([oracle.md](oracle.md)); the other is a tracked bug.
These checks do not establish complete geometric or workflow equivalence. The commands SolidCraft has
-are listed by area in [features.md](features.md); status and plans are in [ROADMAP.md](../ROADMAP.md).
+are listed by area in [features.md](features.md); status and plans are in [ROADMAP.md](roadmap-detail.md).
Open work and known bugs are in [GitHub issues](https://github.com/tangency-labs/solidcraft/issues),
and help is welcome: see [CONTRIBUTING.md](../CONTRIBUTING.md).
@@ -42,7 +42,7 @@ and help is welcome: see [CONTRIBUTING.md](../CONTRIBUTING.md).
- **Features** on a parametric timeline: extrude, revolve, sweep, loft, fillet/chamfer,
shell, draft, holes, threads, patterns, mirror, split, combine, move and construction geometry.
The timeline rebuilds incrementally; features can be edited, suppressed, renamed, reordered
- and deleted. Supported geometry and current limitations are described in [ROADMAP.md](../ROADMAP.md).
+ and deleted. Supported geometry and current limitations are described in [ROADMAP.md](roadmap-detail.md).
New revolves preserve symmetric and two-sided angular placement across reversed axes;
older designs retain their saved convention when reopened or edited.
- **Parameters and configurations** with unit-aware expressions (`2 * width + 5 mm`,
diff --git a/docs/roadmap-detail.md b/docs/roadmap-detail.md
new file mode 100644
index 0000000000..bab5e7ec01
--- /dev/null
+++ b/docs/roadmap-detail.md
@@ -0,0 +1,699 @@
+# SolidCraft roadmap: developer detail
+
+The short, user-facing roadmap is [ROADMAP.md](../../ROADMAP.md). This page is the detailed
+developer status, kept as it was.
+
+Status as of **2026-10-14**. SolidCraft supports parametric modelling (sketch →
+features → parametric timeline) as an open, pure-Rust, agent-drivable application.
+
+## At a glance
+
+| Question | Answer |
+|---|---|
+| Where are we? | **M0 and M13 done; M1, M2, M5–M7, M9, M10, M14 in progress.** Sketch with solver and the full SKETCH create/modify set; extrude, revolve (two sides, symmetric, to object), fillet/chamfer (variable radius, chord length, a radius per edge, corner patches), holes, threads (cosmetic and modelled), patterns, mirror, shell (inside/outside/both), draft, loft, sweep, coil, split body and split face, delete face, construction planes, axes and points; persistent naming of faces and edges; parameters and configurations; components, joints, motion studies, exploded views; sheet metal and a plastic enclosure subset; STEP/IGES/3MF/STL/OBJ/DXF; FreeCAD/Rhino import; autosave and crash recovery; desktop and browser (wasm) app, CLI, MCP server. |
+| Features | Every registered command by area — [docs/features.md](features.md) (`cargo xtask features`); registry breadth does not establish workflow or geometric depth |
+| Reference tests | [Current case count and results](oracle.md): public cases in `tests/oracle/` with analytic or FreeCAD-computed expected values, checked by the reference-test job in [CI](../.github/workflows/ci.yml). |
+| Tests | Solver, profiles, kernel booleans/blends/measures, expressions, timeline, persistent naming, file formats and migrations, assemblies, sheet metal, engine end-to-end, hostile-input fuzz over every command and headless UI scenarios. `cargo xtask ci` reports the current passing counts. |
+| Gates | `cargo xtask ci`: fmt, clippy -D warnings, tests, asset attribution, layering, wasm32 build — green |
+| Time to a useful alpha (M0–M6) | ≈ **82 agent hours** remain (sum of the M1–M6 estimates below) |
+
+Optional GPU viewport ambient occlusion is available in View settings and Graphics preferences,
+with persistent settings, Performance/Quality graphics presets (Quality combines AO, Fine tessellation and adaptive 2× supersampling; manual combinations show Custom), and the
+`view.ambient_occlusion` and `view.graphics_preset` commands. See [display settings](ambient-occlusion.md).
+
+## Scope (owner decision, 2026-10-07)
+
+The issue batch adds preservation of blind pockets in through cuts, associative projected
+offsets and plastic face placements, XZ (+Y normal) with a v6 migration preserving older
+designs, interactive angle placement, file-picker sketch imports, Home/recent controls,
+toolbar overflow, and the remaining component-frame and assembly WIP work. The enclosure
+acceptance scenarios now include board resizes; STEP reopening is automated. See [WIP reconciliation](wip-reconciliation.md).
+Face-based Extrude Join (including outward Press Pull) now defaults to the picked body,
+so edge-touching assembly neighbours stay separate regardless of body order (#226).
+
+In scope, in priority order:
+1. SOLID and SKETCH (now).
+2. Parameters / functional constraints (done: see `parameters.*`, `expr.evaluate`; unit-aware,
+ cycles reported with their path, rename follows references, deletes list their users):
+ user parameters with units and expressions (+-*/, ^,
+ parentheses, sin/cos/sqrt/min/max/floor/ceil/round, unit conversion), model parameters
+ d1, d2… for every dimension and feature input, references between parameters with a
+ dependency graph and cycle detection, re-evaluation on change, comments, favourites,
+ CSV/JSON import and export.
+3. Components and assemblies with joints (M9).
+4. SHEET METAL: flange, contour flange, bend, unfold/refold, flat pattern with DXF export, sheet
+ metal rules (thickness, K-factor, bend radius) (M10).
+5. A small PLASTIC subset for enclosures, after sheet metal: Boss, Rib, Web, Lip/Groove, Snap Fit.
+
+Deferred until further notice: MESH, FORM (T-splines), SURFACE beyond what solids need (scope proposed in #772), PCB / 3D
+PCB / Package, Render, Animation, Simulation, Manufacture/CAM, Drawings.
+
+## Milestones
+
+| # | Milestone | Status | Hours left |
+|---|---|---|---|
+| M0 | Vertical slice | done | — |
+| M1 | Sketch depth: command coverage implemented — projection/intersect/include as linked geometry (auto-project on faces, lost-reference warnings, break link), full SKETCH create/modify set (slots, polygons, tangent arcs/circles, ellipse, fit/control splines, conic, text, trim/extend/break, fillet/chamfer, offset, mirror, patterns, move/scale, blend curve, centerline), constraints incl. curvature and polygon with over-constraint refusal, Shift-picked line midpoints in Horizontal/Vertical using persisted points and ordinary constraints (#2087), driven/arc-length/linear-diameter dimensions, AutoConstrain, DXF/SVG insert, 3D sketch curves (Project To Surface, Intersection Curve, Isoparametric Curve, Spun Profile), exact free-form profiles (B-spline/NURBS edges, any spline degree, curves cut by crossings), sweeps and pipes along 3D sketch curves, canvases and decals, curvature combs. Exact free-form Extend and certified associative offsets now preserve geometry and IDs through edits, deletion and reopen. Occurrence-frame 3D wires now store explicit coordinate spaces and retain points and analytic fits through moves, refresh, undo and reopen. Constructive sketch solving (Owen 1991, Fudos & Hoffmann 1997) ahead of the numerical solver: points and rigid clusters are placed on the branch the sketch had, so dimension edits and drags keep their solution; edits that would turn a sketch over are refused; drags re-solve only the sketch per frame. Remaining workflow repairs: mixed offset junctions, legacy natural-spline seams, and damaged legacy wire links lacking frame provenance | in progress | 4 |
+| M2 | Robust modelling: coplanar booleans in the kernel, holes (placed on faces, at distances from reference edges, and on sketch points), threads (cosmetic, then modelled), patterns, mirror, shell, draft, split, construction geometry | in progress | 16 |
+| M1 | Sketch depth: command coverage implemented — projection/intersect/include as linked geometry (auto-project on faces, lost-reference warnings, break link), full SKETCH create/modify set (slots, polygons, tangent arcs/circles, ellipse, fit/control splines, conic, text, trim/extend/break, fillet/chamfer, offset, mirror, patterns, move/scale, blend curve, centerline), constraints incl. curvature and polygon with over-constraint refusal, Shift-picked line midpoints in Horizontal/Vertical using persisted points and ordinary constraints (#2087), drawing snaps to where two lines, circles or arcs cross (#4967), driven/arc-length/linear-diameter dimensions, AutoConstrain, DXF/SVG insert, 3D sketch curves (Project To Surface, Intersection Curve, Isoparametric Curve, Spun Profile), exact free-form profiles (B-spline/NURBS edges, any spline degree, curves cut by crossings), sweeps and pipes along 3D sketch curves, canvases and decals, curvature combs. Exact free-form Extend and certified associative offsets now preserve geometry and IDs through edits, deletion and reopen. Occurrence-frame 3D wires now store explicit coordinate spaces and retain points and analytic fits through moves, refresh, undo and reopen. Constructive sketch solving (Owen 1991, Fudos & Hoffmann 1997) ahead of the numerical solver: points and rigid clusters are placed on the branch the sketch had, so dimension edits and drags keep their solution; edits that would turn a sketch over are refused; drags re-solve only the sketch per frame. Remaining workflow repairs: mixed offset junctions, legacy natural-spline seams, and damaged legacy wire links lacking frame provenance | in progress | 4 |
+| M2 | Robust modelling: coplanar booleans in the kernel, holes (placed on faces and on sketch points), threads (cosmetic, then modelled), patterns, mirror, shell, draft, split, construction geometry | in progress | 16 |
+| M3 | General fillets and chamfers (curved edges, chains, vertex blends); saddle rolling-ball surfaces now use continuous seam sections and arc-length fitting with shared contact boundaries and bounded accuracy checks; tiny rim edges remain selected instead of nearby wall seams when filleting (#2498) | in progress | 30 |
+| M4 | Files: STEP import (done — [docs/step-import.md](step-import.md)), FreeCAD/Rhino solids through cadmpeg (done, desktop, browser and CLI), 3MF export and 3MF/STL import as mesh bodies (done), 3MF with B-rep face tags ([docs/formats/3mf-face-tags.md](formats/3mf-face-tags.md), done), constant-section parametric mesh reconstruction, DXF sketches, OBJ import | in progress | 6 |
+| M5 | Persistent naming of faces and edges (docs/book/src/dev/naming.md): faces named from their exact kernel-reported history (sketch curve sides, caps, revolve sections, primitive sides, blends, shell inner walls, pattern/mirror copies; split pieces told apart by the faces around them, lumps of a cut body named after their faces), edges by their faces; fillets/chamfers, sketches on faces, shell/draft/offset/replace faces, hole placements, joint origins and face appearances resolve by name first and warn when the entity split or vanished: done. sheet metal edges by base sketch line and flange side, shell inner faces, sweep and loft roles: done. kernel-reported face history: done (merged faces answer to every name; operations without history yet fall back to geometric names, flagged unverified; format 14 keeps older designs' geometric names). Left: history through sheet metal, plastic, surface and emboss features; FaceSource certificates through history | in progress | 20 |
+| M6 | UI depth: selection feedback and origin (done), timeline editing (done: hover and selection highlight modifier faces, including fillets and chamfers; edit feature, history marker drag, dependency-checked single and multi-item reorder, suppress, rename, delete with dependents, re-resolved references; redefining selections refreshes persistent edge/face references while retaining feature identity and dimension names; responsive feature history with width-driven icons/names/title, snapping width resize, bottom/left/browser-stack docking, shared-column collapse, rollback bar, multi-selection and persistent folders), right-docked dialogs (done), live previews for every feature dialog (done), keyboard-first commands with on-canvas value boxes and sketch inline dimensions (done), drag manipulators with automatic join/cut (done: extrude incl. two sides, fillet, shell, hole depth, move, pattern spacing, revolve rotator, extrude taper), dark theme (done), right-click menu with Repeat (done), measure tool (done), section analysis (done), selection filter (done), drag-solve of sketch points (done); appearance controls now preserve body/face/component targeting, named transparent looks, reuse/search and override removal; Browser Expand All / Collapse All (`browser.expand_all`, `browser.collapse_all`) on the design and component menus; preferences | in progress | 6 |
+| M7 | Thin extrude (walls along open or closed curves: centre, inside, outside or two sides; mitred corners, crossing walls joined; #721), sweep, loft (incl. to a point), rib and web (to next / depth), emboss (planar faces and exact radial emboss/deboss of bounded orthogonal profiles on complete exterior cylinders/sleeves), thread (cosmetic, and modelled M3–M20 outside and inside: the ISO profile screwed in as a faceted cut), coil (smooth B-spline helical walls), pipe, pattern on path, patterns of bodies and components, replace face (parallel), align, remove, feature copy/paste: done. Unique eligible cylindrical targets are inferred for new Emboss features. Left: general curved-face emboss and exact (unfaceted) modelled threads | in progress | 12 |
+| M8 | Surface workspace (#772). Done: Patch (sketch regions; edge loops filled G0, plus `crown`), Stitch, Thicken (planes and cylinders), Extend (straight edges of planar surfaces), Trim (by a plane, a face or sketch curves swept onto the surface, keeping a side or the picked regions; mutual trim of two surfaces, extended to meet and stitched, #767), Delete Face (healing), Boundary Fill, zebra/draft/curvature-map analysis, Surface Extrude/Revolve/Sweep/Loft from open and closed curves, Offset, Unstitch and Reverse Normal; the continuity-driven core (`kernel/src/bridge.rs`, G0–G3 Hermite rows) with **Blend** (`surface.blend`, #764: edge chains along one or several faces, closed rims paired seam to seam or from picked seams, a dialog), **Match** (`surface.match`), **Boundary** (`surface.boundary`, #763 — two sketch curves exact with G0–G3, three or four as the flat patch of their loop, and curve networks: Coons and Gordon surfaces through sketch, 3D-sketch or edge curves, a point for a three-sided side, G1/G2 against the faces along one direction's edges, joined into their body on request; G1/G2 on two sides that meet at a corner waits for the Gregory-type corner), **Fair** (`surface.fair`, CV fairing), **continuity analysis** (`inspect.continuity`, #770; a toolbar tool with edge markers and a legend, and curvature combs along face isocurves) and a multi-section **loft** with per-end continuity and crown, and guide rails on solid and surface lofts (one or two, scaling or stretching the sections between; #201). Also in the Class-A pass: G1…G4 blend curves in the sketch, chord and variable-radius fillets on curved edges (with honest refusals where the fit cannot hold), and a G2 corner patch where filleted edges meet (kernel; the command refuses until the patch's sections can be sewn to the blends' contacts). Left: bias/form-factor fillet sections (design recorded), a Gregory-type corner, surface Fillet between separate surface bodies (#769), Ruled (#762), Untrim (#761), curved-face Extend (#760), and every remaining #757–#772 item | deferred | — |
+| M9 | Components and assemblies: New Component / Create Components from Bodies, active component, per-component origin/bodies/sketches/timeline entries, occurrences with transforms, Copy/Paste vs Paste New, nested Browser tree with visibility and isolate; Ground, Move/Copy of occurrences, joints (rigid, revolute, slider, cylindrical, pin-slot, planar, ball) by joint origins with limits and Drive Joints, closed kinematic loops (four-bar, slider-crank: the loop's other joints follow the driven one on its branch, and driving stops where a loop can no longer close), cams (`joint.cam`: a revolute cam drives a slider or revolute follower along a closed sketch profile or the cam's edges, knife, roller or flat followers, worked out again when the profile changes; drives, studies, closed loops, contact sets), As-built Joint, Rigid Group, Contact Sets (driving and motion studies stop where bodies in a set would pass through each other), Motion Study (joint values keyed along a timeline, playback, export of occurrence positions as JSON/CSV), motion analysis (joint values and a point's path charted over a study as value, velocity and acceleration; the parts that collide along a study, with the steps where they do), Exploded views (automatic or by hand, shown without changing placements, and exported as an animation coming apart and back together); interference, per-component physical properties; STEP with assembly structure; URDF export for robot simulators (links with meshes, mass and inertia; joint chains whose values match Drive Joints; docs/urdf.md). Physical properties now measure material-aware component/occurrence placements, descendants and repeated instances, including pending moves and body reassignment offsets; contact geometry and automatic exploded centres respect those offsets. Groundwork done: component tree, occurrences with transforms (instances, Paste New), world placement, active component as authoring frame, ground, Capture/Revert Position, moving bodies and sketches. UI: ASSEMBLE panel dialogs for New Component, Joint (snaps on faces, edges, circles and vertices; animated motion preview; offsets, flip, limits), As-built Joint, Joint Origin, Rigid Group, Drive Joints (live slider), Motion Link, Cam and Interference (overlaps shown red); joints in the timeline and the Browser | in progress | 32 |
+| M10 | Sheet metal: flange (base, edge, contour), hem, unfold/refold, convert, flat pattern + DXF, rules: done. PLASTIC enclosure subset: Boss, Rib, Web, Lip/Groove, Snap Fit, Rest, Plastic Rules (library, edit, assign; rule draft and clearance as feature defaults): done, tested against hand-computed geometry. UI: SHEET METAL and PLASTIC tabs with dialogs (live preview, Edit Feature, pre-selection) for Flange, Hem, Unfold/Refold, Convert, Sheet Metal Rules, Create Flat Pattern (flat view with bend lines, bend table CSV/JSON and DXF export with exact circle/arc/line cutouts), Boss, Lip/Groove, Snap Fit, Rest, Manage and Assign Plastic Rules; Fold (bend along a sketch line); flanges meeting at a corner closed at any angle with the rule's gap; edge flanges with their own angle and height per edge in one feature; corner reliefs (notch, round, rectangular, tear) chosen by the rule; Convert to Sheet Metal from a solid or shelled body by its bend edges (flat faces, sharp bends) | in progress | 36 |
+| M11 | 2D drawings | deferred | — |
+| M12 | Release: cross-platform packages, verification and deliberate publication implemented; original current-UI demo refreshed. macOS Developer ID signing and notarization are in the release workflow (#5749; they switch on when the Apple secrets exist). Windows installer signing and broader performance work remain | in progress | 16 |
+| M14 | Configurations: a table of rows (parameter expressions and feature suppressions per row) switched with config.activate (undoable, all or nothing), kept through parameter renames and feature deletes (config.configure, config.table, config.column/row/activate). Per-row body materials and appearances (library looks, custom colour/opacity and clearing overrides), undoable activation and save/reopen: done. Ordered typed configuration rules, atomic validation and structured rule editing: done. Component appearance and certified semantic face style columns, atomic preview/apply and independent-copy remapping: done. Exact constructed sketch-side and immutable imported-face lineage now preserve legacy names and reject retargeting. Left: ambiguous shifted/two-sided caps | in progress | 4 |
+| M13 | Never lose work: atomic saves (temporary file, flush, rename; a crash at any moment leaves the old file or the new one) with the replaced version kept as `<file>.bak`; autosave of unsaved changes to the recovery folder every 5 minutes (preference) and after big operations, only when something changed; "Recover unsaved design?" on the next launch (`doc.recovery_list`, `doc.recover`, `doc.recovery_discard`); a kill-mid-save test (process killed while saving a 0.5 MB design 25 times). File format: `"format": "solidcraft/12"`, older formats upgraded step by step (`doc::format`), newer ones refused with a message, out-of-range numbers and broken placements refused; a corpus of designs saved by M0, components-era, joints-era and current builds (apps/solidcraft-cli/tests/corpus) that must open and evaluate as saved; damaged and hostile variants (truncation, bit flips, hostile values, removed keys, repeated features, deep nesting) never panic | done | 6 |
+| M15 | Frames and weldments (#4003): structural members along 2D and 3D sketch lines, butt and mitre corners, trim to faces and bodies, end caps, gussets, cosmetic welds and a cut list. Done: the profile library (`frame.profile.list`, `frame.profile.properties`, `frame.profile.insert`): bar, round bar, rectangular and round tube, angle, channel and I-beam, each SolidCraft's own parametric definition with exact fillet arcs and exact section properties (area, centroid, second moments), tested against hand-computed values; members (`frame.member`): one body per straight line of a 2D or 3D frame sketch, following parameter edits, with a built-in profile (its dimensions parameter expressions) or a profile sketch (its drawn material by alternating nested loops), anchor, angle and mirror; each member's name kept with its line. Left: corners, trims, end caps, gussets, welds, cut list, FRAME tab and dialogs | in progress | 60 |
+
+M6 navigation preferences include **Touchpad**: Shift + pointer movement pans, Alt/Option +
+pointer movement orbits without a mouse button, and vertical scrolling zooms. Other presets
+retain their saved two-finger scroll preference; camera motion is available through
+`view.navigate` and modifier-aware `ui.move` automation.
+With the **Fusion** preset and two-finger pan enabled, two fingers pan and Shift + two fingers
+orbit freely, with pinch zoom and mouse bindings unchanged. The shared navigation handler
+applies the same gestures to model and Render views and blocks orbit on flat pages.
+
+UI redesign (#2016): the File/start view (#2027) uses shared light/dark navigation,
+action tiles, recent rows and sample cards, with recovery review and Save As/Export
+entry points. Document loading, sample caches and recovery safety retain their
+existing command paths.
+
+M11 precursor: File → Export Current View as DXF exports shown placed bodies and sketches from the current
+camera as a 2D millimetre drawing, with hidden edges omitted or dashed. Vector occlusion splits
+partly hidden edges and includes curved silhouettes. Repeated part meshes and triangle
+hierarchies are shared; bounded desktop preparation and occlusion use up to eight workers.
+Curves are approximated; drawing sheets,
+annotations and exact projected curves remain deferred. See [view DXF](view-dxf.md).
+
+Drawing foundations: [RFC #860](https://github.com/tangency-labs/solidcraft/issues/860)
+and the [foundation ledger](drawing-foundations.md) track the bounded implementation
+packages. The first geometry increment defines validated section records in a plane-local
+frame; the ledger separates that contract from section producers and the Drawing workspace.
+
+Desktop view DXF export runs in the file-operation worker with five-stage progress and
+cooperative cancellation. Curve tolerance (0.0001–1 mm, default 0.01 mm) is remembered alongside
+the hidden-edge setting. Cancelled exports preserve the model and the previous destination;
+completed drawings publish atomically. The browser still exports synchronously.
+
+## Interactive modelling
+
+- Modelled threads preview their cut before OK using the background worker on desktop.
+ Browser users apply the cut with OK to avoid blocking on every edit.
+
+- Thread resolves a suggested metric size when a cylindrical face is picked. Diameter and
+ pitch selectors expose the existing metric designation parameter; custom designations stay
+ editable, and Automatic size returns to the face's suggestion. Cosmetic/modelled and
+ full/partial-length options remain available. This does not add tolerance classes or
+ left-hand threads.
+- New Body extrusion and face-offset previews show completed intermediate geometry while a
+ drag continues, then catch up to the exact final value. Changes to the selected geometry,
+ operation or feature still discard obsolete results. Distance arrows and their value boxes
+ follow the current frame's input.
+- Large fine modelled threads use pitch-based helix resolution and tighter faceted
+ reconstruction fallbacks, preserving thin crests and closed shells on large shafts.
+
+## Physical material data
+
+- Physical material card validation (#923/#922) provides typed SI mechanical and
+ thermal data, per-property sources/conditions and isotropic/orthotropic stability
+ checks through read-only `material.properties.validate`. It does not assign or
+ persist properties, provide a solver or enable rendering; see
+ [the contract and staged follow-ups](physical-material-cards.md).
+
+- Directional elasticity (#994) queries the validated card in material-local axes
+ through read-only `material.properties.directional`, with source/condition review.
+ It does not assign body frames, predict structural behavior or enable a solver.
+
+## Library foundations (#785, #786, #787)
+
+- Local scalar libraries (#846) inspect/export bounded portable catalogs and copy exact
+ selected appearance/material revisions into existing design definitions in one undo step.
+ Appearance offers local loading/search/export; physical materials use existing commands.
+ This slice is independent of the render stack and does not change the document format.
+ See [the contract and limits](book/src/dev/local-libraries.md).
+
+- Proposed phases cover offline bundled/project/user packs, physical materials and
+ appearances, editable wood mapping, and parameterized component/assembly families.
+ Stable identity/revision, copied design definitions, provenance and resource limits
+ apply from the first implementation. Existing material, appearance and standard-part
+ commands remain the application paths. See [the proposal](book/src/dev/libraries.md)
+ for source/license review and acceptance gates. This is planning only: pack loading,
+ texture rendering and expanded component families are not implemented by this entry.
+
+## Render foundation
+
+- Original starter appearances (#1722): 34 opaque recipes through existing commands, with six explicitly unavailable glass recipes and preserved legacy looks; see [the contract](render-starter-appearances.md).
+
+- Bounded linear film accumulation (#1696) supplies caller-admitted mean/variance storage and complete-pass views; actual progressive consumers remain separate. See [the film contract](render-film.md).
+
+- Definition-local visual mapping (#1214) supplies a bounded numerical frame, physical repeat coordinates and a deterministic one-time grain-axis suggestion. It adds no saved record or texture consumer; see [the mapping contract](render-visual-mapping.md).
+
+- Explicit texture normalization (#1218) produces completed float RGBA with
+ role-aware linear color/data semantics, bounded matrix/TRC ICC conversion and
+ opt-in EXIF orientation. It retains high-precision raw samples and records lossy
+ gamut clipping only when explicitly requested. It is not a renderer/resource
+ consumer; see [the supported policy and limits](render-texture-normalization.md).
+
+- Opt-in opaque PBR (#1046) connects persisted surface parameters to the integrated
+ product viewport and CPU PNG, using a fixed direct-light studio. Geometry and mass
+ stay unchanged. HDRI, transmission and textures remain separate gates.
+ See [the consumer and limitations](render-opaque-pbr.md).
+
+- Combined integration is tracked in #842, with independent scalar libraries in
+ #863 and richer PBR/material-card transport in #1086. See [phase boundaries and validation gates](render-integration.md).
+ Render/library consumers use the merged asynchronous picker (#1127). Material-card
+ UI (#1094), texture mapping and HDRI lighting remain explicit follow-ups.
+
+- R4a adds bounded CPU product-image jobs, cancellation and atomic PNG export through
+ engine commands, the Render panel, CLI and persistent MCP. Immutable captures and
+ results stay outside persistence/undo; native workers and cooperative browser tasks
+ share the same work protocol. See [jobs, limits and export](render-jobs.md).
+
+- R3 adds an overlay-free product scene and the integrated Render workspace, with
+ runtime GPU host capabilities, per-document drafts and named camera/background
+ controls. Design keeps its camera and drawing policy. Raster transparency remains
+ approximate; PBR and environments are later slices. See
+ [workspace and scene contracts](render-workspace.md).
+
+- R2 adds bounded named render setups in document format 21 and the read/save
+ `render.settings.get/set` commands. Proven render-only changes preserve geometry
+ and prepared world data through undo/redo and checkpoint restore. This slice does
+ not add a Render workspace, PBR, environments or image jobs; see
+ [settings and refresh policy](render-settings.md).
+- Bounded PNG/JPEG texture admission (#900) validates in-memory sources and returns
+ completed RGBA8 pixels with explicit color/data roles. It is an input utility only:
+ ICC/16-bit normalization, local wood mapping, resource persistence and the renderer
+ consumer remain separate work. See [limits and licensed-file probes](render-texture-input.md).
+
+- The initial opaque surface numerical contract for #1004 provides bounded linear
+ color/metallic/roughness/IOR admission and an original tested direct-light BRDF.
+ The numerical module alone advertises no capabilities; the installed consumer above
+ provides rendering. See
+ [the model, evidence and remaining consumer gates](render-surface.md).
+
+- A bounded cooperative Radiance RGBE input utility is available in L1 render;
+ it does not yet enable HDRI/PBR rendering or a document import command. See
+ [the input contract](render-hdr-input.md) and #813 for integration work.
+- R1 adds renderer-independent backend/profile metadata, strict request resolution and
+ bounded image/scratch admission checks, exposed by the read-only `render.backends`
+ command. It describes the current CPU raster snapshot path without evaluating the model.
+ The legacy Design snapshot route remains unchanged. Later slices above provide the
+ workspace/jobs and opaque PBR; HDRI and optional engines remain future work. See [the contract](render-backends.md)
+ and [the phased proposal (#620)](https://github.com/bherbruck/solidcraft/issues/620).
+
+## Dimensioning and error reporting
+
+- Operation length fields share design-unit defaults and input evaluation, including secondary
+ distances, thin walls, blend controls, sheet/plastic rules, joints and motion keys. Canvas
+ handles and sketch previews use the same lengths as committed geometry. Existing stored
+ millimetre values retain their size when edited in a design using another unit (#3271).
+
+- MCP `execute` accepts `verbose: false`, sharing the compact reply helper used by
+ `batch`: body changes and created sketch IDs stay, while repeated lists are omitted.
+ Both tools retain full replies by default.
+
+- Sketch Create groups drawing variants under Line, Rectangle, Circle, Arc, Slot,
+ Polygon and Spline. Each open part remembers its last interactive choice per family
+ across sketch sessions and document-tab switches; closing the part resets these UI choices.
+- Inscribed, circumscribed and edge polygon tools preview their actual outline before
+ placement, including orientation and the selected side count.
+- Construction (X) preserves the active sketch drawing tool, picked anchors and inline
+ dimension values, so line type can change while a shape is in progress.
+- Planar sketch construction previews and hover feedback keep the same dashed pattern as
+ committed geometry; centerlines retain their dash-dot pattern.
+
+- Point has a default Sketch CREATE toolbar button alongside the existing drawing tools.
+ Saved custom layouts are preserved; Reset Toolbar restores the default Point button.
+- Construction planes cannot take an origin-plane name (XY, XZ, YZ, Top, Front, Right). Plane
+ arguments reject such a name when an older design's construction plane already has it. Use
+ the other alias, the construction feature's numeric ID or an explicit plane; existing
+ stored references keep their saved meaning. Section Analysis uses the same check.
+- Sketch text can be edited from a letter interior or outline's context menu or the Edit Text command.
+ Interior selection requires every profile boundary to belong to the same text source;
+ the editor highlights the whole source without replacing profile selections.
+ Content, baseline X/Y, height and rotation update the original text source in one undo step;
+ cancelling or rejecting an invalid value preserves the sketch. Position and height fields
+ use the document units captured when editing starts; generated outlines remain associated
+ with their text source, and untouched inputs preserve their saved internal values.
+ Dragging a text outline moves the entire source in one undo step; Escape restores the
+ gesture. Move/Copy on a selected text outline provides unit-aware X/Y distances and rotation
+ about its baseline; copies keep an independent editable text source.
+- Repeating the initial point of a planar multi-point sketch drawing tool is neutral: the tool
+ waits for a distinct point without a degenerate-shape error or history entry. Typed input
+ and programmatic commands retain their validation.
+- Circular-pattern and angled-plane axes reject explicitly supplied malformed or expression
+ origins instead of silently rotating about zero. Numeric origins remain in millimetres;
+ associative axis expressions and construction-axis references remain unsupported.
+- Single-line and rectangle-side dimensioning supports selecting a line or its two endpoints.
+ Type a value and press Enter to commit one undo step; rejected values remain editable and
+ cancellation leaves the sketch unchanged. Fit keeps geometry clear of the Sketch Palette
+ and navigation controls, including enlarged displays and nested pending placements.
+- Sketch Dimension takes a line and a circle or arc (#1803): it measures from the line to the
+ circle's edge (the gap, 0 when tangent, or how far the edge reaches past a line that cuts
+ it), drives it like any other dimension and keeps the circle on its side of the line.
+- Sketch Dimension takes a point and a circle or arc, or two circles or arcs (#4064): it
+ measures to the circle's edge (from the point, or between the two edges: the gap, 0 when
+ they touch, how far they overlap, or the narrowest gap between nested circles).
+- Sketch annotations, live drawing lengths and Measure use document units. Inches show
+ three decimals and retain a meaningful fourth digit. Bare length dimension entry captures
+ the current design unit; changing units leaves existing geometry and expressions intact.
+ Component/canvas distance controls, sketch cursor coordinates, flat-pattern dimensions
+ and pocket depths, interference volumes and parts-library lengths also use design units.
+- Curvature and Polygon constraints accept complete preselected operands. Fix/Unfix
+ consumes complete point/curve selections consistently; mixed or ambiguous selections
+ retain the picking workflow. Rejected constraints preserve selection and undo history.
+- Contextual error reporting: a **Create Issue** action beside feature errors opens a
+ reviewable GitHub issue draft with the error, operation settings, build diagnostics and
+ useful reproduction context. The draft is editable, with optional capture of the actual
+ viewport and copy/save controls. Opening GitHub does not submit the issue. Help also exposes
+ reporting for unexpected results that did not produce an error.
+- The header exposes **Report a bug**, including an accessible compact control on
+ narrow windows. It opens the same editable report and screenshot review without
+ changing the active model or a pending dimension.
+- Crash reports: every panic (in a command, in the kernel, anywhere else) and every unclean
+ exit (abort, stack overflow, kill: found at the next start through a locked per-run command
+ journal) leaves a local report with the backtrace, version and commit, the command and the
+ design that reproduce it (`solidcraft-cli crashes replay <id>`). Repeats are counted, not
+ rewritten; at most 20 reports, 50 MB and 90 days. The app shows them after a crash (Help >
+ Crash Reports…) with a reviewed issue draft; agents read them through
+ `diagnostics.crash_reports`, the MCP `crash_reports` tool or the CLI. Nothing is sent
+ anywhere. See [crash reports](crash-reports.md).
+- Agent chat (off by default, desktop): a side panel that drives a coding agent the user
+ already has (Claude Code through its ACP adapter, Codex, Gemini CLI, OpenCode, Grok Build, …) over the
+ Agent Client Protocol, under the user's own login; SolidCraft stores no keys. The agent works
+ through SolidCraft's MCP tools on a gated endpoint of its own: file actions wait for Allow or
+ Deny, crash reports are off limits, 24 changes per message, one undo step per message, and
+ the agent's whole process group ends with the panel or the app. Docks left or right,
+ minimises to a strip. Grok Build discovery includes `~/.grok/bin` and reuses the user's
+ Grok login. See [agent chat](agent-chat.md).
+- Command scripts from designs (#886): `timeline.export_script` (CLI `solidcraft-cli script`)
+ writes a design's history as a script that `eval` and `run` replay into the same design —
+ user parameters, units, sheet metal and plastic rules and materials as their own commands,
+ then each feature through `timeline.add` with its ids, names and dimension parameters kept,
+ so every feature kind replays exactly and a failing feature fails the same way. Trimming the
+ script after a step gives the design at that step. Appearances, folders, views and
+ configurations are listed as left out; components and joints are not supported yet.
+
+## 0.2.0 release batch
+
+- Includes the new axis navigation, adaptive sketch drawing/picking, origin-corner repairs,
+ durable supported profile/face references, endpoint dimensioning and contextual reporting.
+- Smooth ruled-wall display joins are hidden only within the supported geometric certificate;
+ authored splits and actual creases remain protected. Wireframe retains physical edges.
+- Paste New uses a bounded current-geometry comparison for supported convex line/circle
+ prisms with separated circular holes; unsupported shapes retain the existing strict check.
+- Common-bore Union retries check additional boundary curves before recutting the bore,
+ preventing the reproduced thin-web loss. Unknown additional trims refuse; inherited
+ common-cylinder trims retain their existing policy, so this is not a general Boolean proof.
+- Exact full-path assembly joint editing remains separate work and is not part of this batch.
+- Stable 0.2.0 is published: all release payload checksums, native cold reopening, deployed
+ web app and both Flatpak architectures were verified. The replacement README demo uses
+ the original electronics enclosure story and animated pointer in the actual English
+ 0.2.0 UI, at 4× playback. Publication follows [the release workflow](releasing.md).
+
+## 0.2.1 critical fixes
+
+- Separated multi-profile Join/Cut extrusions into one solid target batch their tools using
+ conservative construction bounds, avoiding a Boolean rebuild for every profile. Live
+ extrusion previews build only their tools; confirmation validates the final Boolean.
+- Coplanar selected body faces share one linked sketch and one extrusion. Automatic Join/Cut
+ keeps the evaluator's participant scope, including parts of an empty imported component. Desktop OK/Enter
+ computes on a scratch session in the background, with atomic acceptance and cancellation.
+ Planar section stitching projects lines/arcs analytically and removes duplicate endpoints.
+- Imported rotated face groups can check all full start-face seams in one guarded
+ construction. Separated tools may batch a Join when each meets the same single body;
+ nearby uninvolved bodies retain the original contact decisions. Regression comparisons
+ cover all four extrusion operations.
+- Inward multi-face cuts retain every eligible target and subtract separated tools together.
+ Safe interior classification handles roundoff at shared imported line/arc endpoints.
+ Straight extrusion feedback caches existing face/profile triangles and updates the display
+ directly, including a newly opened STEP's single identity component placement; other
+ extents, moved or repeated components and curved sketch profiles keep the Engine preview.
+- The extrusion fixes retain tracked Boolean history and the current `solidcraft` packages.
+ Confirmation and tool previews use main's shared background calculation. Main's collapsed
+ blend-wall refusal and its tests are retained, including smaller valid radii and mirrored parts.
+- Axis view and navigation controls stay anchored to the viewport when feature dialogs or
+ the command palette open, at normal and enlarged display scales. Fit still accounts for
+ dialog coverage; covered controls do not receive clicks through dialogs.
+- Eligible planar faces survive fillet, chamfer and shell operations with exact source
+ certificates. Sketches placed directly on the enclosure wall and inner floor follow
+ width and wall changes, including after the USB cut and cold reopening.
+- Remove artificial straight-wall and rounded-corner subdivisions left by shell and
+ extrusion cuts. Identical generated wall segments span adjacent slabs as one physical
+ face, with exact full-height supports and boundary stitching. Preserve authored face
+ splits and face appearances. Permanent regressions cover material, STEP, reopening and
+ unaffected bodies across the extrusion end plane.
+- Feature dialogs use the available screen height for their fields, with OK and Cancel
+ outside the scrolling region, including enlarged display scales.
+- Design format 13 records shell-face attachments. Older designs remain readable;
+ newly saved designs require 0.2.1 or later. Ambiguous or unsupported faces still refuse
+ attachment rather than guessing a plane.
+- Saved projections from a removed strip retain their geometry and report the lost
+ reference. Explicitly reselect the wall to repair that projection.
+
+## Workspace layouts (#2029)
+
+- General preferences save Floating or Compact using the universal UI containers.
+ Compact joins the workspace selector and ribbon, docks the content-hugging Browser
+ flush beneath them with a square join, and opens tool sheets below the compass.
+ Sheets remain draggable, rounding all corners away from their right dock; footer
+ backgrounds follow the same corners. A separate preference hides ribbon icon labels
+ for a shorter ribbon in either layout.
+ Assistant keeps the outermost edge and History keeps its chosen dock. Switching
+ retains the active tool, camera, selection and design; system windows and menus
+ keep their existing behavior.
+
+## View navigation
+
+- Navigation has an opt-in Free orbit preference for mouse and 3D-mouse rotation through
+ both poles with roll. It defaults off, preserving existing preset snapping and pole limits.
+ The SolidWorks face menu offers Normal to Selection (`view.normal_to`), shared with Look At
+ and Ctrl+8, including repeat-to-flip, preserving scale and projection.
+
+- Desktop Ctrl/Cmd +/- and 0 change or reset the saved UI scale. The scale slider keeps
+ its layout stable during a drag and applies the selected scale on release.
+
+- OpenSCAD navigation preset: left drag orbits, right/middle drag pans, Shift+right/middle
+ drag zooms, and the wheel zooms. Available in the shared desktop/web Navigation preferences.
+- Compact clickable signed X/Y/Z axis tips, smooth drag-to-orbit, and Shift-orbit snapping
+ to 26 standard and diagonal views. Pointer motion accumulates independently of a lightly
+ damped spring, with a boundary margin to prevent flicker. Z-up/Y-up and the nearest square
+ top/bottom heading are preserved. Diagonals include 45-degree edge and isometric corner views.
+
+## Known limitations
+
+- Scheduled and manual CI scan locked dependency advisories, bans and sources with
+ cargo-deny. Vulnerabilities fail the scan; unmaintained crates warn. Local vendored
+ patches require separate upstream review because advisory databases cannot version-match
+ their path dependencies. Pull requests retain the existing licence checks.
+
+- Associative shell-face sketches require a unique certified planar source. Nested shell
+ attachments and ambiguous coincident sources remain unsupported.
+- G2 fillets: exact quintic blends of straight edges between planar faces, with one planar
+ end face at each end, including sloped ends (#2708). The UI and `solid.fillet` expose
+ `curvature` (alias `g2`); the size is an equivalent circular setback. Curved faces/edges,
+ multi-face ends and corner junctions remain unsupported.
+- Fillets and chamfers: constant, variable-radius and chord-length fillets; a radius per edge,
+ rounds next to earlier rounds of another radius, and smooth corner patches where three rounds
+ meet (a sphere for equal radii); perpendicular corner fillets after a closed ring of earlier
+ rounds preserve the ring's radii and the enclosed planar face (#1557);
+ mitres between separate rounds of the same radius keep their endpoint tangent, so a later
+ fillet can select an upright and its adjoining bottom mitre as one chain (#2422);
+ straight edges (convex or concave) between planar faces with perpendicular
+ planar end faces (equal-distance chamfers also meet sloped planar end faces, including inner
+ basin rims within the rim width); convex fillets also meet sloped planar ends and reflex
+ corners around pocket rims, with unequal wall slopes and extensions confined to the face;
+ connected equal-distance chamfers also trim each other across unequal sloped rim walls;
+ curved chamfer chains with straight planar ends can terminate across two existing planar
+ bevel faces, splitting their shared seam; picks on the same tangent chain are applied once (#1303);
+ whole smooth loops of a planar face, picked whole or by one edge (tangent
+ chain), including circles and walls at any angle (boss bases and tops, bores, pocket floors,
+ plate outlines), loops with sharp corners between straight or mixed arc/line edges (straight
+ blends meet in mitres; perpendicular curved walls use offset intersections, with D-rim removal
+ checked within 0.1% of analytic offset slices), runs of
+ neighbouring edges along a planar face's loop (two top edges of a box: mitred, ending square;
+ with the edge between them too, the corner becomes a sphere octant),
+ rounded corners rounded again (sphere octants, tori at concave corners); every edge of a
+ convex planar body or of an extruded part; fillets inside patterns; closed chains of curved
+ edges between any two smooth sides (a branch pipe on a main pipe), by a rolling ball (the
+ blend a rational B-spline through exact arcs), closed or ending at planar faces square to the
+ edges, where straight or curved cap edges are trimmed to the contacts (the straight edge
+ between two overlapping extruded arcs); knife edges, where the two faces have opposite
+ normals (a wall that runs out tangent into a face: the ball that fits there); an edge that
+ runs out along an end face tangent to one side (the arc top edge of that wall), cut where the
+ blend meets it; rounds that end in an earlier round on curved faces, in any order (the rounds
+ of two edges at a vertex meet in a crease, as on a box), picked together or one after the
+ other, except a round after a round of the edge between the wall and a flat face that it
+ would run over; the three edges at a vertex of any smooth faces, of one radius, end in a
+ piece of sphere. A limiting blend that collapses a side wall into coincident boundary
+ curves is refused as too large rather than returning an unmeshable face (#1113).
+- Booleans: prisms along one direction (plates with holes, slots, patterns of them, equal
+ sections stacked end to end) are combined exactly in 2D. Qualified axial cuts preserve
+ annular holes with overrun cutters, including inward Press Pull after a joined extrusion;
+ curved wall qualification rejects false transverse axes instead of filling holes.
+ Bodies touching along one whole face
+ (a part and its mirror image) are stitched; coincident planar faces are pushed apart when
+ their neighbours are planes or cylinders. Other coincident curved configurations can still
+ fail. Bounded containment classification preserves fully internal cavities and nested
+ material islands independently of shell order, with STEP round-trip and material-membership
+ regressions. Near-contact curved shells use the general boolean path rather than a
+ containment shortcut. Spheres are built from six pole-free patches.
+- Mass properties come from fine tessellation (curved faces within ~1e-4 relative); triangles
+ that cut through curved faces (trimmed faces after booleans) are split onto the surface first.
+- STEP import (our own reader, crates/kernel/src/step_in) reads solids (B-rep with analytic and B-spline geometry), units,
+ product names, colours and assemblies; analytic offsets on planes, cylinders, cones, spheres
+ and regular tori are read exactly (signed/nested distances, units and face sense). Freeform
+ offset surfaces and pcurve-only edges are not read yet,
+ and assembly components are flattened into bodies. Closed periodic faces (torus, B-spline
+ bands) are split in two for meshing; measure() uses a finer tolerance for small radii.
+- Persistent naming follows the kernel's exact face history (docs/book/src/dev/naming.md):
+ references resolve by name first, follow splits and merges, and warn when the entity split,
+ merged or vanished, or was found by geometry only (operations that report no history yet).
+ New planar sketch attachments use exact box, extrusion cap/side and immutable imported-face
+ source certificates with checked target and author occurrence paths. A missing or changed
+ source fails explicitly; Redefine Sketch Plane previews reattachment or a fixed plane while
+ retaining current geometry and dimension identities. Unsupported modified faces need an
+ explicit fixed plane. Legacy attachments retain their original resolver behavior.
+- Modelled threads are cut as a faceted body (curved faces within 1/200 of the pitch); Extrude
+ and Revolve To Object on a curved face cut the tool back to the target's surface.
+- Explicit sketch breaks preserve exact ellipses, fit/control splines (including high degrees)
+ and conics; analytic trim/break also sees free-form cutters. Free-form curves cut at a tangent
+ touch (no clean crossing) enter that profile as polylines.
+ Sweeps along 3D sketch curves follow their polyline (smooth walls when the path is smooth).
+ A sweep with a twist, an end scale or a parallel or direction orientation (#771) follows its
+ path that way too, even along sketch lines and arcs: B-spline walls through stations, ruled
+ walls through denser stations where the path has corners or the profile has holes.
+ Guide rails (one or two, #771) do the same: each station meets every rail once, and the rail
+ turns the profile and scales it (or stretches it across to the rail) against the start; two
+ rails carry it between them. Rails along a path with sharp corners are refused for now.
+- Extend intersects exact ellipses and rational/high-degree splines without moving the line or
+ circular support. Associative free-form offsets have a whole-span 0.002 mm normal-distance
+ certificate and refine within bounded node limits while retaining existing IDs.
+ At the node limit, geometric certificate subdivisions accommodate unequal spline parameter
+ speeds without changing stored nodes or relaxing the distance tolerance (#971).
+ Associated offset fit nodes stay hidden from display, picking and snapping; dragging the
+ editable source updates the derived boundary live. Break Association restores point editing.
+ Singular, self-intersecting and ambiguous curves refuse atomically; mixed junctions and nonsmooth
+ closed natural-spline seams remain limitations. New explicitly closed fit splines and closed
+ offset outputs use periodic C2 interpolation, supporting repeated certified offsets; older
+ natural splines are preserved. Clicking the starting fit point deliberately closes a new loop.
+ Newly captured adaptive profile references with complete source coverage retain their outer
+ and hole identities through span-count changes, including parameter edits after extrusion.
+ Partial, intersected or ambiguous boundaries do not qualify for these whole-source references.
+ Legacy curve-span multisets remain exact and unchanged; already-lost selections may need
+ reselection. Format 12 stores the new bounded whole-boundary references.
+ Projected analytic boundaries follow nested loop identities through resizing, including
+ stationary holes and rounded corners. Supported convex, tangent line-and-arc boundaries
+ can lose or regain corner arcs during an inset while preserving reserved curve identities
+ and linked profile selections. Format 12 saves those associations; compatible older closed
+ offsets upgrade structurally without changing their curve IDs. Breaking an association
+ freezes its current boundary and materializes downstream profile references. Child offsets
+ of a boundary with retired arcs still require breaking its association first; mixed or
+ nonconvex junctions and retained references to disappearing individual arcs remain limited.
+- Extrude and Revolve editors retain original direction, extent expressions, explicit targets,
+ axes, From/To inputs and All-profile intent. No-op edits preserve downstream dimension names
+ and selected occurrence frames; cancel and successful edits preserve one-step undo history.
+ Placed feature edits preview through the edited timeline entry, and cylindrical Emboss guides
+ use the sketch's actual target, author or uniquely placed third-component frame.
+ Revolve rotators follow the actual signed axis and support symmetric and two-sided extents;
+ dragging a To Object extent converts its derived value to an explicit angle. Legacy reversed-axis
+ symmetric geometry is preserved through format 11's explicit legacy convention. New revolves
+ use the sketch-normal direction for each selected profile, including To Object and curved
+ target trimming, independently of the selected axis sign.
+- Cylindrical emboss/deboss wraps bounded orthogonal line profiles, including holes, concave
+ outlines and nested islands, onto complete exterior cylinders or coaxial sleeves with exact
+ radial walls. New features infer a unique eligible cylinder when the face field is empty;
+ ambiguous targets require an explicit face. Saved target
+ and author occurrence paths retain the chosen placements; missing/split faces refuse rather
+ than retarget. General free-form profiles, seams, stepped cylinders and other curved surfaces
+ remain unsupported. STEP round-trip and independent radial/volume checks cover this subset.
+- Shell and offset faces work on bodies of planes, cylinders, cones, spheres and tori (convex or not:
+ filleted boxes, bosses, domes, countersinks; corners where four or more planes meet, such as a
+ floor falling to a drain, as long as the corner's edges are all convex or all concave); draft on convex planar bodies and on walls (planes, cylinders → cones) between caps; lofts through three or more sections are smooth (B-spline sides through every section), two
+ sections ruled. Circular-meridian barrels retain curved inner walls through either axial
+ opening (#2421). Solid lofts preserve holes through sections with matching hole counts
+ (#2435), including inner walls and caps with openings; a hole cannot appear or disappear
+ between sections, and sections with holes cannot collapse to a point.
+
+- Sketch corner tools: fillet and all three chamfer modes pick a connected corner even when
+ its endpoint overlaps the fixed origin or a loose point. Ordinary drawing still snaps to
+ the origin; clicked UI regressions verify geometry, closed profiles and undo.
+- Sketch display: drawing, picking, highlighting, tool previews and profile shading share
+ adaptive projected curve boundaries. Fit, zoom, display scale and placed sketch frames
+ invalidate the display cache without changing CAD geometry or timeline history. Work
+ budgets and clipped paths prevent unbounded sampling or invented edges across the eye plane.
+ The Sketch Palette scrolls its options on short windows and enlarged displays while
+ keeping constraint status and Finish Sketch visible.
+- Face projection: closed boundaries have a deterministic outer-first order. Refresh matches
+ existing geometry before assigning positions, retaining saved curve IDs and constraints
+ across enumeration changes and resize, including concentric circles. Ambiguous identities
+ retain the last geometry and report a lost reference; permutation matching is bounded.
+- Project accepts complete supported preselection in one undo step. Visible external sketch
+ curves and points retain their source sketch identity; model geometry, axes and planes use
+ the existing linked projection commands. Rejection preserves the document and selection;
+ mixed selections retain ordinary tool-first picking.
+- Inline sketch dimensions: Tab and Shift+Tab cycle within the active shape's value boxes,
+ selecting visited values for replacement. Expression completion retains forward-Tab
+ priority; real keyboard regressions cover rectangles, lines and single-value circles.
+ Typed lengths, radii, line angles, signed arc sweeps and slot lengths persist as constraints
+ and expressions through save/reopen. Shape creation and its dimensions form one undo step;
+ rejected values keep the editable field focused.
+- Repeated components: Browser selection, visibility, properties, copy and Move/Copy use
+ checked occurrence paths. Active nested occurrences author planar sketches and solids in
+ their selected frame. Pending moves compose through parents; dialog cancellation restores
+ its selected move. Source materials and body/face appearances follow transformed instances.
+ Shared nested definitions remain shared. Deep Paste New copies reachable definition graphs,
+ independent feature/input histories, styles and internal motion records, with bounded geometry
+ checks and explicit external-link notices. Paste New selects the copy while preserving the active
+ authoring context. Imported periodic STEP seams survive placement and reexport with shared
+ topology and appearances intact. Recorded body transfers preserve historical Join/Cut membership,
+ material, placements and machining data through edits, copying, undo and reopen. New 3D wires
+ record their coordinate frame; legacy wires migrate from known provenance without changing
+ coordinates. Broken legacy links with missing provenance can require explicit refresh or relink.
+ See [occurrence workflows](occurrence-workflows.md).
+- Toolbar drops on panel labels, gaps and margins append commands with insertion feedback;
+ button drops keep insert-before ordering.
+- Parameters and Configurations have distinct actions in the SOLID toolbar's CONFIGURE panel.
+ Parameters opens the user/model variable editor; Configurations opens the configuration table.
+ Configure remains available in the panel dropdown.
+- Parameter creation supports Enter with validation and continued keyboard entry. Shared
+ expression autocomplete supports Up/Down selection, Enter/Tab acceptance and Escape dismissal;
+ accepting a suggestion does not submit a parameter or trigger viewport shortcuts.
+- Movable window title bars follow the app's dark/light header palette. Radial right-click
+ menus are opt-in in Preferences > Navigation; ordinary context menus remain the default.
+- Desktop distribution: running Windows windows and executable resources use the app icon;
+ packaging validates icon resources. Nix installs launchers, MIME data and generated icons,
+ with explicit launch apps and Vulkan-loader/driver discovery. Flatpak feed instructions
+ register the required runtime source; release checks exercise desktop modelling on X11/Wayland.
+- OpenGL rendering clamps effective anti-aliasing to 1x across UI pipelines, textures and CAD
+ callbacks to prevent black frames. Other backends retain the requested sample count, and
+ stored preferences remain unchanged.
+- Configuration rules: ordered typed conditions can drive parameters and suppressions or
+ restrict values. Preview explains effective values without modifying the document; applying
+ rules validates rows atomically. Length expressions retain their authoring units across
+ document-unit changes. The UI supports structured All/Any/Not conditions and rule ordering.
+ Component styles and certified semantic face styles are available; unsupported lineage refuses
+ atomically, and stale certified face paint cannot jump to another surface. See [configurations](configurations.md).
+- Sheet-metal material: inherited holes, crossing edge notches, overlapping cuts and retained
+ islands share the same boundaries in flat preview, DXF and unfolded solids. Detached material
+ pieces survive unfold/refold as one logical sheet group, including split flanged sheets.
+ Cut-outs made in the flat pattern cross bends at any angle or curved: their edges fold to
+ helices and curves on the bend, their walls square to the sheet. Free-form bases use bounded
+ sampling.
+ Parallel prismatic partial-depth cuts retain pocket side and depth through transfer and
+ unfold/refold, with separate pocket contours in preview and DXF. Planar Intersect preserves
+ exact holes and retained islands, including the union of multiple selected profiles, and
+ records complementary depth layers as pockets while retaining the stock gauge. Unsupported
+ tapered or bend-crossing machining refuses atomically instead of restoring material later.
+ Sketches attach to a sheet's flat faces (base and flanges, either side) by panel, in the
+ flat pattern's coordinates, and follow it through rebuilds and unfold/refold.
+ A flange on another flange's far edge (a return) follows that flange's closed end and keeps
+ clear of the flange beside it, and the returns of one feature are mitred toward each other
+ with the rule's gap where their flanges meet at a corner; returns of separate features, and
+ flanges on returns, are not closed toward each other.
+- Rolling-ball fillet accuracy: independent offset-cylinder tee references check surface
+ distance, actual trimmed tessellation, supporting-cylinder contacts and tangency at two
+ scales. The measured trimmed-part error is below 0.0001 mm; this is an analytic geometry
+ check. Under-resolved fits return an error.
+- Contact driving checks the trajectory between clear endpoints, including linked joints,
+ playback and sparse motion exports. Checks use bounded tessellation samples, not exact
+ continuous collision detection; local thin walls and small details remain limitations.
+ See [contact-set limits and recovery](contact-sets.md).
+
+## Assembly dragging
+
+The design's first part is grounded when it is made, and a left-button drag repositions a free part (`occurrence.drag`: one undo step, exact occurrence paths including repeated jointed definitions, any floating-chain member carries the chain, grounded parts and joints hold where present, Escape cancels).
+
+## 3D sketch bridges
+
+3D sketch drawing snaps to points on other visible sketch planes without flattening them onto
+the active plane. Bridge endpoints capture their source positions; associative endpoint links,
+construction-plane selection of 3D wires and loft guide rails remain separate work.
+Feature dialog header chevrons collapse and restore the form without discarding selections
+or edited values, including the Appearance panel.
+## Construction on 3D paths
+
+Plane Along Path has a viewport path selector, fractional position, live preview and timeline
+editing. Construction planes and points resolve drawn 3D wires without applying their sketch
+plane a second time. Curved paths use sampled segments; multi-curve chains, absolute distance
+and reference-object placement remain separate work, as do loft rails and centerlines.
+
+## Design properties (#1015)
+
+- Designs carry project, part number, revision, author, organization, description and licence
+ in an optional `metadata` object (File → Design Properties…, `document.metadata.*`,
+ `inspect_design`). STEP and IGES headers and 3MF model metadata take the fields their format
+ has a place for. Other tools keep their own data under a reverse-DNS key, kept as it is
+ through open, edit and save and never exported. See [design properties](book/src/guide/files.md#design-properties).
+ Per-component properties (a part number per component) can follow with the same type.
+
+## Document-opening performance
+
+- Desktop STEP import prepares consecutive independent solids in bounded batches with up
+ to eight workers, retaining serial traversal, result order and persistent source identities.
+ The web path remains serial. Original multi-solid fixtures show 64–81% lower complete
+ import times; single-solid assembly parts are not scheduled across nodes. See
+ [measurements and limits](perf.md#parallel-step-body-preparation-2026-10-12).
+- Design containers (#303, phase one) separate and deduplicate STEP, raw images and
+ lossless binary mesh arrays while keeping plain JSON as a supported Save As/export
+ format. Generated-mesh storage measurements reduce serialization and decoding work;
+ a seekable reader defers original blobs until after provisional display.
+ See [container format](design-container.md) and [performance measurements](perf.md).
+- Warm saves with explicit `cache: true` can include a versioned native B-rep cache through SolidCraft-owned topology
+ and geometry records, with a separate truck adapter and bounded binary reader. Exact
+ face-source certificates and operation history survive codec round trips. A provisional
+ picture can be generated before original blobs are read; editing and measurement wait
+ for authoritative reconstruction. Cached metadata binds preview and reconstruction to
+ the same document despite concurrent file writes. Default saves omit this cache and never force cold
+ evaluation or meshing; explicit `preview: true` remains a separate warm-mesh option.
+ Keys, resource budgets and document/revision guards reject incompatible, hostile or
+ stale results. A second modelling kernel still requires its own tested adapter.
+- Warm saves with explicit `cache: true` can also carry a bounded PNG thumbnail from already cached meshes.
+ Home reads it without rebuilding the design when its local picture is missing;
+ mismatched or malformed thumbnails fall back to normal generation. The image is
+ kernel-independent and saving never forces cold meshing to produce it.
+
+- Cold rebuild profiling separates parsing, geometry, placement, display meshing and
+ thumbnails. Straight-line closest-point projection and exact curved-surface evaluation
+ reuse reduce repeated work without relaxing geometry checks. Three alternating optimized
+ benchmark runs reduce median rebuild time by 26% on the public sensor enclosure and 22%
+ on a local case assembly; shape measurements and topology match the original build.
+ See [performance measurements](perf.md). Further cold Boolean and import costs remain.
+- Prepared assembly geometry survives selection and view changes while real geometry and
+ placement changes invalidate it. A Pi assembly edge-selection probe drops from 9.24 s to
+ 0.57 s; initial opening is unchanged. Actual Windows desktop profiling measures 15.87 s
+ median opening, with 82% spent rebuilding geometry; halving full opening remains open.
+
+## Kernel
+
+- Successful Boolean retries report their strategy and numerical adjustments as
+ feature warnings and structured inspection data. Diagnostics survive cached
+ evaluation, undo/redo and cold reopening; the robustness runner counts retry
+ events by strategy and reports any bounded-log truncation. Existing geometry
+ acceptance checks remain in force.
+
+- Cylinders of one radius whose axes cross (a second bore across a bore of the same size, a pipe
+ tee of equal pipes) touch at two points, where the mesh intersection cannot trace the curves
+ and a boolean cannot tell the four arms of the crossing apart. When the ordinary boolean fails
+ on such a pair, both faces are split along the line of their cylinder through the touching
+ points (the solids are unchanged), the boolean is taken of those, and its history is composed
+ back over the operands as given (#788). The result keeps the split lines as edges of the bore
+ walls. A crossing the ordinary route fails on and the split faces do not help (a radius of 17.5
+ in a 45 mm block with a tool of 80 mm) is still refused.
+- Boolean intersection-curve construction refuses point-only, collapsed and non-finite
+ polylines without panicking. Direct constructor regressions retain valid open endpoints
+ and closed spherical intersections; the original interactive trigger remains unidentified.
+- Shell of a stepped, joined planar body no longer creates horizontal subdivisions across
+ continuous walls. Fresh axis-aligned Cut walls are stitched using their exact construction
+ support and shared topology, preserving real steps and intentional boundaries. The local
+ reported case returns from 86 to 49 faces with unchanged material and bounds; regressions
+ cover stepped stock, STEP round trips and saved projections from removed pieces.
+
+truck (Apache-2.0) behind our own `kernel` crate, with our own blend operation and boolean
+retry/validation; see `plan/adr/0001-geometry-kernel.md` (local) — summary in README.
diff --git a/docs/web-runtime.md b/docs/web-runtime.md
index 5e70e7dcaf..8f65c46596 100644
--- a/docs/web-runtime.md
+++ b/docs/web-runtime.md
@@ -76,7 +76,7 @@ call the same `run(command, args)` JSON.
| Recovery autosave | Warm tier, same semantics as [`compatibility.md`](compatibility.md) |
| [Design containers](design-container.md) content-addressed blobs | Tier keys by hash; cold tier holds large blobs without copying into OPFS |
| [Control protocol](control-protocol.md) over TCP | Same methods over `MessagePort` to broker headless session (WebMCP-shaped, not a second registry) |
-| Parallel mesh work ([ROADMAP](../ROADMAP.md): web path serial) | Offload eval / IO jobs via `JobSubmit`; viewport stays on main thread |
+| Parallel mesh work ([roadmap detail](roadmap-detail.md): web path serial) | Offload eval / IO jobs via `JobSubmit`; viewport stays on main thread |
## craft-libs crates (reference)