Adom Library

@@ -1,6 +1,6 @@ [package] name = "adom-lbr"-version = "1.2.1"+version = "1.2.2" edition = "2021" description = "EAGLE .lbr generator, linter, and validator for Fusion 360 Electronics. Converts KiCad symbols + footprints to complete EAGLE libraries." 

@@ -1 +1 @@-1.2.1\ No newline at end of file+1.2.2\ No newline at end of file

@@ -1,6 +1,6 @@ {   "slug": "adom-lbr",-  "version": "1.2.1",+  "version": "1.2.2",   "type": "app",   "description": "KiCad \u2192 EAGLE .lbr generator for the whole EAGLE family (Fusion 360 / Altium / OrCAD), real-footprint accurate, with 3D-model handoff. Bidirectional KiCad converter + 7-check linter. Includes a focused fusion-export sub-skill.",   "dependencies": {},

@@ -1,6 +1,6 @@ {   "slug": "adom-lbr",-  "version": "1.2.1",+  "version": "1.2.2",   "type": "app",   "description": "KiCad → EAGLE .lbr generator for the whole EAGLE family (Fusion 360 / Altium / OrCAD), real-footprint accurate, with 3D-model handoff. Bidirectional KiCad converter + 7-check linter. Includes a focused fusion-export sub-skill.",   "dependencies": {},

@@ -0,0 +1,70 @@+# Fusion 360 library export — a field guide++*A sub-skill of [adom-lbr](https://wiki.adom.inc/adom/adom-lbr). This is the+human-readable walkthrough; the agent-facing rules live in+**[SKILL.md](SKILL.md)** right next to it.*++Turning a KiCad part into a Fusion 360 library *looks* like one command — but+there are four places it quietly goes wrong. This guide is how to get a library+that places with the **real footprint** and a **rendered 3D body**, every time.+The same `.lbr` also imports into Altium and OrCAD.++## What "right" looks like++A correct export gives you all three faces of the part — schematic **symbol**, the+real **footprint**, and the **3D** body — tied together by a complete pin→pad map:++![Symbol, footprint, and 3D side by side with the pin→pad mapping table](viewer3col.png)++## Trap #1 — the footprint must come from the real `.kicad_mod`++Pass `--fp`. Without it, every pad is dumped into two columns and a 4-sided LQFP+comes out as a domino — wrong pads, wrong sizes, wrong rotations. With it, pads+land in their true positions (a real ADS8588SIPM LQFP-64: 16 per side):++![ADS8588SIPM LQFP-64 built from the real .kicad_mod — a true 4-sided ring](footprint-4sided.png)++## The tool warns you in-band++You don't have to remember these traps — adom-lbr surfaces them as **hints at the+moment of use** (it knows agents barely read skills). Forget `--fp` and it says so,+loudly; use it and it confirms the real geometry and points at the next step:++![Progressive hints: a loud placeholder warning without --fp; a real-footprint summary and next-steps with it](hints.png)++## The other three traps (short version)++2. **3D is a Fusion-side *attach*, not a flat-file write.** The body only renders+   once Fusion brings the model into a session. The bridge does+   `Create3DPackage → import → orient → FINISH → Save` (binds **and** renders);+   `--model` just emits the sidecar that points it at the model.+3. **Self-hosted models link by `wip_urn`** (`urn:adsk.wipprod:fs.file:vf.<id>?version=N`,+   with `urn=""`), **not** `urn:adsk.eagle:package` (that's managed/library.io only).+4. **Never put a `dm.lineage` URN in the `.lbr`** — Fusion pins the versioned+   `fs.file` URN; keep `dm.lineage` as sidecar provenance only. `bind-3d` refuses it.++## The flow — who does what++| Step | Who | Command / action |+|---|---|---|+| Generate 2D `.lbr` + sidecar | adom-lbr | `generate --sym … --fp … --model part.step` |+| Attach 3D (binds **and** renders) | Fusion bridge | Create3DPackage → import → orient → FINISH → Save |+| Report the minted URN | Fusion bridge | `fusion_aps_file_info {query:"<package>"}` → `fs.file:vf…?version=N` |+| Record URN back (provenance) | adom-lbr | `bind-3d --record-only --sidecar … --wip-urn <that>` |+| (Optional) bake binding into `.lbr` | adom-lbr | `bind-3d --lbr part.lbr --wip-urn <that>` |++The **in-Fusion library is the runtime source of truth**; the sidecar is+adom-lbr-owned bookkeeping.++## Quick triage++| Symptom | Fix |+|---|---|+| Footprint is two columns / a domino | regenerate **with `--fp part.kicad_mod`** |+| Fusion: "No Components" | `adom-lbr lint part.lbr` → fix the reported code |+| 3D body is a gray placeholder | let the bridge attach it (Create3DPackage → FINISH) |+| `bind-3d` rejected the URN | self-uploaded → `--wip-urn`; managed → `--urn` |+| 3D offset / wrong pin 1 | run chipfit; set `placement` in the sidecar before FINISH |++→ **Agent-facing rules: [SKILL.md](SKILL.md).** The app, full CLI, and live+3-column viewer: **[adom/adom-lbr](https://wiki.adom.inc/adom/adom-lbr)**.

@@ -90,6 +90,7 @@ adom-lbr-owned bookkeeping (idempotency + provenance). | `bind-3d` rejected the URN | self-uploaded → `--wip-urn` (`fs.file:vf…?version=N`); managed → `--urn` | | 3D offset / wrong pin 1 | run chipfit; set `placement` in the sidecar before FINISH | -Full walkthrough + screenshots: **[docs/fusion-export.md](../../docs/fusion-export.md)** in this-repo. This is a sub-skill of the **[adom-lbr](https://wiki.adom.inc/adom/adom-lbr)** app — it+Human walkthrough + screenshots: **[README.md](README.md)** next to this skill+(and the deeper dive in [docs/fusion-export.md](../../docs/fusion-export.md)). This+is a sub-skill of the **[adom-lbr](https://wiki.adom.inc/adom/adom-lbr)** app — it installs and surfaces with it.

⋯ 1 unchanged line ⋯

⋯ 1 unchanged line ⋯

⋯ 1 unchanged line ⋯