Fusion - the Fusion 360 Bridge

@@ -0,0 +1,141 @@+---+name: fusion-eagle-commands+description: EAGLE command reference for Fusion 360 Electronics via fusion_electron_run. Use when driving the Fusion Electronics / PCB workspace through the Adom Desktop Fusion 360 bridge — the EAGLE-syntax commands (DRC, ROUTE, RATSNEST, DISPLAY, GRID, etc.) you pass to fusion_electron_run, and which ones BLOCK (ADD/SHOW/MOVE/WRITE/EDIT) vs are safe. Trigger words - eagle command, fusion_electron_run, electron run, DRC, ERC, RATSNEST, RIPUP, DISPLAY layers, WINDOW FIT, eagle layers, blocking command, WRITE blocks, export eagle source, eagle script.+---++# EAGLE Commands for `fusion_electron_run`++> **Owned by the `adom-desktop-fusion-bridge` skill package.** This reference is Fusion-Electronics+> specific, so it ships here (you get it via `adom-wiki pkg install adom/adom-desktop-fusion-bridge`),+> not the adom-desktop core package. Companion skill: `fusion-electronics` (driving the editor).++Fusion's Electronics workspace is built on EAGLE. `fusion_electron_run` sends a text command through the same interface EAGLE's command line uses.++## ⚠️ Fire-and-forget — no output returned++`fusion_electron_run` never returns EAGLE's stdout. It returns `activeWorkspace`, a diff of Fusion's internal operation log (`fusionOperations[]`), and an `_hint` field. **For data, use `fusion_board_info` / `fusion_schematic_info` instead.**++## 🚫 Never use these (blocking / modal)++These commands open modal prompts EAGLE waits on forever. Your call will hang until it times out.++| Command | Why it blocks | Use instead |+|---|---|---|+| `ADD` | Prompts for component placement | Edit source .sch/.brd via import commands |+| `SHOW` | Opens an info dialog | `fusion_board_info`, `fusion_schematic_info` |+| `MOVE` | Interactive picker | Edit source files offline |+| `CHANGE` (interactive form) | Picker for target object | Use with explicit object: `CHANGE WIDTH 0.3 (1 2)` is OK |+| `WRITE` | Cloud: opens "Version Description" dialog even with path arg (tested 2026-04-10). Local: opens Save As. | `fusion_save_to_cloud`, `fusion_export_source`, `fusion_export_eagle_source` |+| `EDIT` | Opens library/sheet editor | Open target directly |++## ✅ Popular commands (verified working)++### View control++| Command | Effect |+|---|---|+| `WINDOW FIT` | Zoom to fit entire board/schematic |+| `WINDOW SELECT` | Zoom to current selection |+| `DISPLAY ALL` | Turn on all layers |+| `DISPLAY NONE` | Turn off all layers (chain with specific layers) |+| `DISPLAY NONE; DISPLAY 1 17 18` | Top copper + pads + vias only |+| `GRID MM 1` | Set grid to 1 mm |+| `GRID INCH 0.05` | Set grid to 50 mil |+| `GRID ON` / `GRID OFF` | Toggle grid visibility |+| `LAYER 1` | Switch active layer to top copper |+| `LAYER 16` | Switch active layer to bottom copper |++### Layers reference (EAGLE standard)++| Layer | Name | Purpose |+|---|---|---|+| 1 | Top | Top copper |+| 16 | Bottom | Bottom copper |+| 17 | Pads | Through-hole pads |+| 18 | Vias | Vias |+| 19 | Unrouted | Airwires / ratsnest |+| 20 | Dimension | Board outline ⚠️ required for 3D view |+| 21 | tPlace | Top silkscreen |+| 22 | bPlace | Bottom silkscreen |+| 25 | tNames | Top reference designators |+| 27 | tValues | Top component values |+| 29 | tStop | Top soldermask |+| 31 | tCream | Top paste mask |+| 44 | Drills | Plated drills |+| 45 | Holes | Non-plated holes |+| 51 | tDocu | Top documentation |++### Routing++| Command | Effect |+|---|---|+| `RATSNEST` | Recalculate airwires (safe, always non-blocking) |+| `RIPUP ;` | Rip up **all** routed traces (destructive) |+| `RIPUP GND` | Rip up only nets named GND |+| `AUTO ;` | Run autorouter with current DRU settings |++### Design checks++| Command | Effect | Notes |+|---|---|---|+| `DRC` | Run design rule check | Non-blocking; read results via `fusion_board_info` |+| `ERC` | Run electrical rule check (schematic) | |+| `ERRORS` | Show current error list | Reads into fusionOperations log |++### Edit (non-interactive forms only)++| Command | Effect |+|---|---|+| `NAME U1 MCU` | Rename part U1 to MCU |+| `VALUE R1 10k` | Set R1's value to 10k |+| `ROTATE =R90 U1` | Rotate U1 by 90° absolute |+| `SMASH U1` | Detach name/value labels from U1 so they can be moved |+| `GROUP ALL` | Select everything |++### File / script / export++| Command | Effect | Notes |+|---|---|---|+| `SCRIPT /path/to/file.scr` | Run an EAGLE script file | Batches multiple commands; still fire-and-forget |+| `EXPORT IMAGE /path/to/out.png 300` | Export bitmap at 300 DPI | Prefer `fusion_export_*` commands |++**For source file export, do NOT use EAGLE's WRITE command.** Use the Adom commands instead:++| Adom command | Output format | Notes |+|---|---|---|+| `fusion_export_eagle_source {"outputPath":"C:/out/X.brd"}` | Plain EAGLE XML (.sch / .brd) | Extracts from Fusion's ZIP container. Parseable by standalone EAGLE, KiCad import, or any XML tool. |+| `fusion_export_source {"outputPath":"C:/out/X.fbrd"}` | Fusion-wrapped ZIP (.fsch / .fbrd / .flbr) | Contains the EAGLE XML inside a ZIP with metadata + preview PNGs. |++Workflow for both:+1. Open the .fprj: `fusion_open_cloud_file {projectName, fileName, fileExtension:"fprj", folderPath}`+2. Board export: `fusion_show_2d_board` → export with .brd/.fbrd extension+3. Schematic export: `fusion_electron_run {"command":"EDIT .s1"}` → export with .sch/.fsch extension++### Info (read-only, but prefer structured equivalents)++| Command | Prefer instead |+|---|---|+| `INFO U1` | `fusion_board_info` → components[] |+| `SHOW GND` | `fusion_board_info` → nets[] |++## Chaining++EAGLE supports semicolon-separated command chains in a single call:++```+fusion_electron_run {"command": "DISPLAY NONE; DISPLAY 1 17 18; WINDOW FIT"}+```++Each step runs in order. If any step would block, the whole chain hangs — keep chains to view/ratsnest/display commands only.++## Verified working (with dates)++- **2026-04-10**: `WINDOW FIT`, `DISPLAY ALL`, `RATSNEST`, `DRC` — confirmed non-blocking in Fusion 2026.+- **2026-04-10**: `WRITE <path>` — **BLOCKS** on cloud docs (opens "Version Description" dialog). Use `fusion_export_eagle_source` instead.+- **2026-04-10**: `fusion_export_eagle_source` — confirmed working: extracts plain EAGLE XML (.sch/.brd) from .fsch/.fbrd ZIP containers. Tested on THRU Mid-Signal VNA DUT: .brd=111KB, .sch=73KB.++When you verify a new command works, add it here with the date so future sessions know it's safe.++## Adding new commands to this doc++This file is the source of truth — edit it directly and commit. The CLI's `fusion_electron_run` help points here via its `note` field. No rebuild required.