adom-chipsmith view-library /home/adom/project/chip-fetcher/library/VL53L8CX
adom-chipsmith view path/to/chip.step --footprint path/to/chip.kicad_mod --spec path/to/spec.json
adom-chipsmith reveal path/to/chip.chipsmith.step    # opens VS Code Explorer at the file

---
name: adom-chipsmith
description: >
  STEP-native chip detection + footprint validation + sign-off — the higher-level
  validator on top of adom-step. Loads a .step + footprint + datasheet PDF +
  chipsmith-spec manifest, reads B-rep + assembly hierarchy directly (NOT GLB
  triangle meshes), detects every electrical-contact feature (legs / pads / balls
  / tabs / EP / through-hole pins / reinforcement tabs), validates measurements
  against declared body_dims_mm with mm-vs-m-vs-inch auto-rescale, recovers Y-up
  vs Z-up, detects pin-1 chip-side AND footprint-side, layers a 1.6mm faux PCB
  with plated PTH / NPTH / plated slot / unplated slot rendering, auto-generates
  0.3mm heatsink-via grid under any EP, optionally laser-etches the MPN onto the
  chip's top, optionally lets the user place a synthetic pin-1 indicator. On
  sign-off bakes a `<mpn>.chipsmith.step` (canonical) + shadow `.chipsmith.glb` +
  sidecar JSON. Trigger words — chipsmith, chip detection, validate chip step,
  sign off chip, footprint validation, pin-1 indicator, place pin1, heatsink
  vias, faux pcb, laser etch mpn, manual orient step, mm vs inch step,
  detect pins step, chip pad detection, chip step bake, role tag chip.
---

# adom-chipsmith — STEP-native chip validator

The higher-level validator on top of [`adom-step`](../adom-step/SKILL.md). Loads a chip's STEP file alongside its footprint + datasheet + manifest, runs detection on the STEP B-rep (not the GLB triangle mesh), validates measurements, detects pin-1, layers a 1.6mm faux PCB + heatsink vias + solder-jet domes, and on user sign-off bakes a `<mpn>.chipsmith.step` + shadow GLB + sidecar JSON.

See [PLAN.md](PLAN.md) for the full spec.

## Quick start

```bash
adom-chipsmith view-library /home/adom/project/chip-fetcher/library/VL53L8CX
adom-chipsmith view path/to/chip.step --footprint path/to/chip.kicad_mod --spec path/to/spec.json
adom-chipsmith reveal path/to/chip.chipsmith.step    # opens VS Code Explorer at the file
```

## CLI subcommands (initial set)

| Command | Purpose |
|---|---|
| `view <step> [--footprint <kicad_mod>] [--spec <json>] [--datasheet <pdf>]` | Open one chip in the validator |
| `view-library <chip-fetcher-dir>` | Open a chip from a chip-fetcher library directory |
| `list-components` | Print the discovered scene-graph component tree |
| `isolate <name>` / `show <name>` / `hide <name>` / `show-all` / `frame <name>` | Visibility + camera helpers |
| `screenshot --out <png>` | Save a PNG of the current canvas |
| `eval <js>` / `console -f` | JS bridge for AI sessions |
| `reveal <path>` | Reveal a file in the VS Code Explorer sidebar |
| `start` / `stop` / `status` / `health` / `open` | Server lifecycle |
| `install` | Drop SKILL.md + completions |

## v1 scope

The initial scaffold ships viewer + canonical Adom header + the CLI surface above. Detection (Modes 0/1/2), pin numbering, hover-inspect HUD, sign-off HUD, faux PCB rendering, heatsink vias, laser etch, user-placed pin-1, advanced manual orient/translate, and the `service-step2glb /step-meta` + `/bake` endpoints land in subsequent passes per [PLAN.md](PLAN.md).