# adom-pin1-truth

CLI shim over the pin-1 location truth dataset for the KiCad standard footprint library.

## Usage

```
adom-pin1-truth <Library>/<Footprint>
```

Single positional arg, same shape consumers already pass to `step2glb from-library`.

**Output (stdout, single JSON line):**

```json
{"x_mm":-0.51,"y_mm":0.0,"z_mm":0.0}
```

Pin-1 location in the footprint's local frame (chip body at origin, +Z up). The consumer parents a sphere to the part mesh at these coords; rotation/mirroring happens for free.

**Unknown footprint:** exits non-zero with a one-line stderr message and no stdout. The consumer can fall back to its own pad-1 derivation.

## Backed by

- 14,884 KiCad-standard footprints parsed at build time from `pin1-truth.json`
- Source: github.com/adom-inc/adom-pin1-truth

## Exit codes

| Code | Meaning |
|------|---------|
| 0 | Real answer printed to stdout |
| 1 | Footprint not in the dataset |
| 2 | Bad CLI input |