Fusion - the Fusion 360 Bridge

@@ -1749,6 +1749,11 @@ def _handle_fusion_readiness(fusion_info: dict, args: dict) -> dict:         "installing": installing,         "running": running,         "ready": ready,+        # CAPABILITY, knowable before staging a single file (#43 follow-up): shape B of+        # fusion_create_library needs adom-lbr, which is Linux-container-only by platform+        # rule - so on Windows/Mac this is False and the caller should convert at+        # authoring time and send shape A (.lbr + .step).+        "kicadIngest": bool(_find_adom_lbr()),         "bridgeVersion": BRIDGE_VERSION,         **stale_info,         "_hint": (hint + " NOTE: " + result_note) if result_note else hint,@@ -9493,6 +9498,26 @@ COMMAND_HANDLERS["prove_library"] = _handle_prove_library   +def _kicad_ingest_unavailable_error() -> dict:+    """The shape-B refusal, shared by import_kicad and the create_library fast-fail.++    Platform rule (John, 2026-08-21): a bridge runs on Windows or Mac; ALL Adom binaries+    are Linux-container-only. So KiCad conversion can never happen on this box, and the+    contract is authoring-time: convert in a container, publish the validated .lbr on the+    part page, hand the bridge shape A (.lbr + .step)."""+    return {"success": False, "errorCode": "adom_lbr_unavailable",+            "kicadIngest": False,+            "error": "adom-lbr (the canonical KiCad->EAGLE converter) does not run on this "+                     "platform - Adom binaries are Linux-container-only by design - and this "+                     "bridge deliberately does NOT convert KiCad formats itself.",+            "_hint": ("Convert at AUTHORING time, where adom-lbr genuinely runs: in a "+                      "container, `adom-lbr generate --sym <.kicad_sym> --fp <.kicad_mod> "+                      "-o <out.lbr>` (auto-linted), publish the .lbr on the part page, then "+                      "call fusion_create_library shape A {libraryPath, stepPath}. "+                      "fusion_readiness reports kicadIngest so this is knowable before "+                      "staging files or launching Fusion.")}++ def _find_adom_lbr() -> str:     """Locate adom-lbr on THIS box (the canonical KiCad->EAGLE converter, adom/adom-lbr)."""     import shutil as _sh@@ -9508,44 +9533,12 @@ def _find_adom_lbr() -> str:   -def _install_adom_lbr_windows() -> str:-    """SELF-INSTALL adom-lbr on this box (doctrine: never hand the user an install step).--    Probes the wiki for a windows release asset (requested in adom-lbr#6) and caches it-    under %LOCALAPPDATA%\\Programs\\adom-lbr. Returns the exe path, or "" while no-    windows asset exists yet - at which point the caller's error says conversion is-    container-side for now. The moment Ray ships the asset, this verb starts working on-    fresh boxes with no code change.-    """-    import urllib.request as _u-    la = os.environ.get("LOCALAPPDATA", "")-    if not la:-        return ""-    dest_dir = os.path.join(la, "Programs", "adom-lbr")-    dest = os.path.join(dest_dir, "adom-lbr.exe")-    if os.path.exists(dest):-        return dest-    try:-        req = _u.Request("https://wiki.adom.inc/api/v1/pages/adom-lbr/releases")-        rels = json.loads(_u.urlopen(req, timeout=15).read()).get("releases") or []-        ver = rels[0].get("version") if rels else None-        if not ver:-            return ""-        url = "https://wiki.adom.inc/download/adom/adom-lbr/%s/adom-lbr.exe" % ver-        os.makedirs(dest_dir, exist_ok=True)-        tmp = dest + ".tmp"-        with _u.urlopen(url, timeout=60) as r, open(tmp, "wb") as f:-            f.write(r.read())-        os.replace(tmp, dest)-        print("[Fusion Bridge] self-installed adom-lbr %s -> %s" % (ver, dest))-        return dest-    except Exception:-        try:-            os.remove(dest + ".tmp")-        except Exception:-            pass-        return ""-+# _install_adom_lbr_windows was DELETED (2026-08-21). The platform rule it violated:+# a bridge runs on Windows or Mac, and ALL Adom binaries are Linux-container-only by+# deliberate decision - there will never be a windows adom-lbr asset for it to fetch+# (adom-lbr#6 withdrawn, adom-lbr#8 retracted by its own filer). Conversion happens at+# AUTHORING time in a container; the published .lbr is the runtime contract (page+# issue #43, adom-bridge#92).   def _apply_pin_map(lbr_path: str, pin_map: dict) -> dict:@@ -9610,18 +9603,7 @@ def _handle_import_kicad(fusion_info: dict, args: dict) -> dict:                 "error": "Pass kicadSymbolPath and/or kicadFootprintPath."}     tool = _find_adom_lbr()     if not tool:-        tool = _install_adom_lbr_windows()-    if not tool:-        return {"success": False, "errorCode": "adom_lbr_unavailable",-                "error": "adom-lbr (the canonical KiCad->EAGLE converter) is not installed "-                         "on this box, and this bridge deliberately does NOT convert KiCad "-                         "formats itself.",-                "_hint": ("Conversion is owned by adom/adom-lbr - one converter for the whole "-                          "ecosystem. From a CONTAINER: `adom-lbr generate --sym <.kicad_sym> "-                          "--fp <.kicad_mod> -o <out.lbr>` (auto-linted), then stage the .lbr "-                          "to this box (send_files, dest under %TEMP%) and use the fusion_show_* "-                          "verbs. A windows release asset of adom-lbr has been requested so this "-                          "verb can run it on-box.")}+        return _kicad_ingest_unavailable_error()     if not lbr_p:         base = (sym_p or mod_p).rsplit("/", 1)         stem = base[-1].rsplit(".", 1)[0]@@ -9777,6 +9759,12 @@ def _handle_create_library(fusion_info: dict, args: dict) -> dict:                 "_hint": "Shape A: {libraryPath, stepPath}. Shape B: {kicadSymbolPath, "                          "kicadFootprintPath, stepPath, pinMap?}. stepPath is required for "                          "a PROVEN library - without it there is no real 3D body."}+    # SHAPE B FAILS AT THE FRONT DOOR, never three stages in (#43 follow-up, 2026-08-21):+    # the old flow staged files, launched Fusion (a minute of the user's time), and THEN+    # discovered adom-lbr is absent - which on Windows/Mac it always is, by platform rule.+    # Knowable up front, so refused up front; fusion_readiness carries the same flag.+    if (sym_p or mod_p) and not _find_adom_lbr():+        return _kicad_ingest_unavailable_error()      import uuid as _uuid     run_id = _uuid.uuid4().hex[:12]