adom-chipsmith — STEP-native chip validator

adom-chipsmith loads a chip's STEP file alongside its footprint, datasheet PDF, and a chipsmith-spec manifest, then runs detection on the STEP B-rep (not on triangulated GLB meshes), validates measurements, layers a 1.6 mm faux PCB, auto-generates heatsink-via grids under any exposed pad, lays out solder-jet domes per the solder-jetting rules, and on user sign-off bakes a canonical <mpn>.chipsmith.step plus a sidecar JSON for downstream Adom tools.

It's the higher-level validator that sits on top of adom-step — chipsmith inherits the canonical Babylon viewer + smart-pick measure tool + Outline pane via the Tier-3 importer pattern from 3d-viewer-design §2.

What it does (in one screen)

Every overlay layer is a first-class Outline citizen with eye-toggle, click-to-isolate, and a right-click menu.

STEP-native, not GLB

Both adom-chipfit and adom-chiplinter operate on triangulated GLBs and both lose surface-type information (a BGA ball becomes a triangle list, indistinguishable from a QFN pad). chipsmith reads the STEP file's B-rep + assembly hierarchy directly via service-step2glb's /step-meta endpoint, so:

• CYLINDER + small radius + dome top → BGA ball.
• PLANE + horizontal + at z≈seat-plane → SMD pad.
• PLANE + vertical + tall (≥1.6 mm) + thin → through-hole pin.
• CONICAL or CYLINDER on top, small radius, elevated → pin-1 indicator candidate.

Detection runs in three modes — Mode 0 named-scene-graph walk, Mode 1 surface-type cluster, Mode 2 face-merge fallback — stopping when ≥(declared pin count) features have been classified.

Multi-source footprint cross-validation

chipsmith renders four parallel footprint sources from chip-fetcher's library (datasheet-derived, KiCad, Fusion 360 .lbr, Altium .PcbLib) into the scene as separately-branched overlays in different tints (orange / green / blue / purple), then runs a per-pad cross-validation matrix. All four sources agreeing pad-by-pad is the strongest possible "chipsmith nailed this chip" signal — disagreements pop visually and gate sign-off.

The ds2sf authoritative SVG (when present in the chip-fetcher library — emitted by ds2sf v0.5.1+) renders as a fifth branch of pixel-trustworthy ground truth: real vector polygons parsed from the SVG and triangulated via earcut, not a texture-mapped raster.

Quick start

# Install (paste into Claude Code):
curl -fsSL https://wiki-ufypy5dpx93o.adom.cloud/static/apps/adom-chipsmith/adom-chipsmith \
  -o /usr/local/bin/adom-chipsmith && chmod +x /usr/local/bin/adom-chipsmith && \
  adom-chipsmith install

# Open a chip from a chip-fetcher library
adom-chipsmith view-library /home/adom/project/chip-fetcher/library/VL53L8CX

# Open an arbitrary STEP + footprint + datasheet
adom-chipsmith view path/to/chip.step \
  --footprint path/to/chip.kicad_mod \
  --spec      path/to/info.json

# Headless detection — JSON report
adom-chipsmith detect --json /path/to/chip-fetcher/library/<MPN>

CLI surface

JS API surface (window.adomChipsmith)

The full UI is JS-shadowed for AI demo scripts + tests. From the CLI: adom-chipsmith eval "window.adomChipsmith.<verb>(...)".

state()                         // full state snapshot
setActiveTab(id)                // 'source' | 'measurements' | … | 'solderjet'
runDetection()                  // re-fetch + re-run Mode 0 → Mode 1 fallback
runMeasurements()               // re-run rescale negotiation
recomputeStatuses()             // refresh every status pill from current state

placePin1(opts)                 // {mode:'corner'|'fpMarker'|'click', corner, xyMm, shape}
removePin1User()

setFootprintOverlay(src, on)    // 'kicad' | 'fusion' | 'altium' | 'datasheet' | 'stock'
setDs2sfVisible(on)
setFauxPcbVisible(on)
setHeatsinkVisible(on)
setSolderJetVisible(on)

replayReveal()                  // re-runs the strobe + numbered badges
hoverAt({x, y})                 // returns same payload as the visible HUD

signoff.gates()
signoff.canSignOff()
signoff.signOff()               // POST /api/signoff → writes JSON + bakes STEP

Sign-off artifacts

Source

adom-inc/adom-chipsmith (private). The wiki carries the binary + SKILL.md + this page; the public install path is fully self-service.

Adjacent skills

• adom-step — base viewer chipsmith inherits from
• 3d-viewer-design — esp. §14 (overlays first-class) and §2 (Tier-3 inheritance)
• solder-jetting — 300 µm dome rules
• electrical-engineering — package families, pin-1 conventions, mm + mils
• pin1-indicator — per-package pin-1 marker conventions
• chip-fetcher — produces the chipsmith input bundle

Contributing & forking — open source under the Adom org

adom-chipsmith — STEP-native chip validator is open source under the adom org on the Adom Wiki. The full source lives in this page's repo — open the Files tab, or adompkg install adom/adom-chipsmith and edit the package. Third-party developers are welcome to modify it and contribute back.

Modify it

• Get the source from the Files tab (or adompkg install adom/adom-chipsmith), make your changes, and rebuild.

Contribute back to Adom — two paths

1. Pull request (preferred). The wiki runs a PR-per-page flow: propose your change on this page and the maintainer reviews + merges it — no fork needed.

2. Fork + breadcrumb. Prefer your own fork or add-on? Publish it as your own wiki page, then drop a breadcrumb on this page pointing at your fork so it's discoverable:

   • Read existing trails: GET https://wiki.adom.inc/api/v1/pages/adom-chipsmith/breadcrumbs
   • Attach a breadcrumb from your fork's page targeting this anchor (a short label + your slug).

   The breadcrumb leaves a linked path back here, so Adom's AI can auto-discover your fork and surface it to users — the trail is followable both ways. Your fork stays yours; the original stays discoverable.

License

MIT — © 2026 Adom Industries Inc. Open source; see LICENSE. Modify, fork, and redistribute freely.