Engineering Feature

Technology & Mathematical Method

Representation in STEP & JSON

🧊 Watertight Solid B-Rep Guarantee

Euler-Poincaré invariant ($\chi = 2 - 2g$), symmetric half-edge pairing, 64-bit quantized topological vertex pool.

STEP: MANIFOLD_SOLID_BREP with a single closed CLOSED_SHELL. Strictly 0 open edges, 0 non-manifold edges.

⚖️ Exact Gauss-Mirtich Mass & 3D Inertia

Analytical divergence theorem integration with exact / 120.0 divisor. Volume, surface area, center of mass, and full $3 \times 3$ inertia tensor.

JSON: volumeMm3, centerOfMass, inertiaTensor ($I_{xx}, I_{yy}, I_{zz}, I_{xy}, I_{yz}, I_{zx}$ with $I_{xy}=0$ on symmetric bodies).

🧹 Boundary Unification (No Extra Lines)

Coplanar half-edge cancellation, Jordan cycle extraction, RDP collinear vertex reduction ($10^{-5}$ mm).

STEP: Clean unified ADVANCED_FACE with single outer bound and inner loops. Zero internal wireframe lines.

🔄 2D Gauss Area Angle Sweep Triangulator

Monotonic cyclic angle sweep (loop-band-triangulator.ts) determining CW/CCW orientation via 2D Shoelace area in transverse normal plane.

Guarantees 100% topological band closure between top and bottom loops without butterfly self-intersections.

📐 Seamless C0 Profile Fitting

Algebraic least-squares circle fitting (Kåsa/Pratt), seamless tangent line-to-arc transitions without edge duplication, $2\pi$ circle closure.

STEP: Precise CIRCLE and LINE geometry with C0 profile boundary snapping (profile-loop-snapper.ts).

🔩 ISO Metric Threads (M2–M24)

Catalog matching, coaxial cylinder RANSAC, pitch $P$ and tap drill diameter extraction. Mode selectable (auto, physical, semantic).

STEP: Optional cosmetic helical geometry or analytical core.JSON: spec: "M6x1", pitchMm: 1.0, isInternal: true.

🛡️ Scale-Invariant & Datum Shielding

Dynamic scale normalization $D_{\text{bbox}}$, Tier E protection for micro-chamfers, strict datum plane locks (datumA && datumB).

Prevents decimation erosion on 45° entrance chamfers and critical reference datums.

🕳️ Internal Cavities & Channels

Signed volume divergence theorem integration per closed manifold shell ($V < 0$).

Internal cooling lines and cavities remain 100% hollow during slicing and CAD import.

⚡ DWRR Concurrency & Zero-GC Profiling

Deficit Weighted Round-Robin fair-share scheduling, dynamic CPU core/RAM scaling, Structure-of-Arrays (SoA) binary heaps.

Eliminates head-of-line blocking on 16-core systems. Heap delta: 0.00 MB during hot loops.

🔬 RSVS 5-Gate Reality Simulation

Strict verification: Hausdorff $H_{99} \le 0.05$ mm, $H_{\max}$ via $O(N)$ QuickSelect, RMSE, mass drift, native B-Rep topological validation.

Pre-manufacturing geometric sign-off before sending code to CNC mills or 3D printers.

Flag

Values

Description

-t, --threads

<N>

Number of parallel worker threads (0 = auto CPU core count minus 1).

-q, --quality

high | fast

Processing preset: high (full RANSAC + QEM) or fast (quick decimation).

-o, --out-dir

<path>

Custom destination directory for generated artifacts (default: ./output).

-i, --interactive

—

Launch interactive terminal wizard to select outputs and options.

-y, --yes, --default

—

Non-interactive mode: accept defaults without prompting (ideal for CI/CD).

--emit

formats

Comma-separated outputs: step, summary, topology, report, heatmap, all, minimal.

--representation

auto | brep | tessellated

STEP geometry mode: analytical brep, faceted tessellated, or adaptive auto.

--thread-mode

auto | physical | semantic

Metric thread mode: physical modeled threads, semantic annotation, or auto.

-m, --material

<preset>

Assign material density: steel, aluminum, pla, petg, abs, glass.

--heatmap

failed-only | always | none

Control 3D GLB deviation heatmap generation.

--align-viewer

—

Auto-align 6 canonical views (Top/Bottom/Front/Back) for CAD viewers (default).

--keep-orientation

—

Preserve original coordinates without CAD axis reorientation.

--verify / --no-verify

—

Enable or disable the RSVS 5-Gate reality simulation verification suite.

--mcp

—

Start as a Stdio MCP Server for AI coding assistants.

--test

—

Run embedded RSVS regression test suite and mutation tests.

-v, --verbose

—

Enable verbose debugging logs.

MCP Tool Name

Input Parameters

Output & Purpose

cad_analyze_stl

filePath, threshold?

Analyzes mesh quality, triangle count, watertightness, bounding box, volume, and surface area.

cad_detect_threads

filePath

Detects ISO metric threads (M2–M24), nominal diameters, pitches, and tap drill specifications.

cad_verify_rsvs

filePath, outDir?

Runs RSVS 5-Gate reality simulation, returning Hausdorff $H_{99}$, RMSE, and Euler characteristic.

cad_convert_to_step

filePath, outDir?, options?

Converts STL to solid STEP AP242 and emits CAD features JSON artifacts.