Fusion - the Fusion 360 Bridge

@@ -0,0 +1,126 @@+"""In-app 'Adom is driving Fusion' banner - a docked Fusion palette.++John, 2026-08-28: "is there some mechanism fusion provides for in-app general status bar+or indicator... so a user knows they might not want to touch fusion during that+operation? cuz opening a multipart library is like a 10 to 15 minute operation."++Until now the ONLY signal was the Windows-taskbar progress bar, which vanishes the moment+Fusion is maximised in front of the user - precisely when they reach for the mouse. Fusion+exposes no writable status bar, and its ProgressDialog is modal and holds the main thread+(the exact dialog class this bridge spent a week eliminating). A PALETTE is the right+surface: Fusion's own docked HTML panel, persistent, non-modal, ours to render.++Design rules, each load-bearing:+- CREATED ONCE, lazily, on first show; later calls only set HTML. Palette creation is main-+  thread work and this bridge's whole discipline is not holding that thread; text updates+  are cheap, creation is not.+- NEVER raises into the caller. A banner is advisory. If Fusion refuses to build the palette+  (older API, no UI context), the import must proceed exactly as if the banner did not exist.+- It is a "please do not touch" ADVISORY, not a lock. Fusion has no read-only mode; a+  determined click still lands. The banner tells the human; it cannot stop them.+- Same text the wiki sees. The server passes the run's own stageLabel / percent / ETA, so a+  user at Fusion and a user at the wiki read one story.+"""++import adsk.core++PALETTE_ID = "AdomActivityPalette"+_palette = None+++def _html(title, detail, percent, eta_sec, tone):+    pct = max(0, min(100, int(percent or 0)))+    eta = ""+    if eta_sec is not None:+        m, s = divmod(max(0, int(eta_sec)), 60)+        eta = ("about %dm %02ds left" % (m, s)) if m else ("about %ds left" % s)+    bar_color = {"working": "#00b8b1", "done": "#3fb950", "failed": "#f85149"}.get(tone, "#00b8b1")+    return """<!doctype html><html><head><meta charset="utf-8"><style>+      html,body{margin:0;background:#0d1117;color:#e6edf3;font:13px/1.45 'Segoe UI',system-ui,sans-serif}+      .wrap{padding:12px 14px}+      .brand{display:flex;align-items:center;gap:8px;font-weight:600;font-size:12px;letter-spacing:.02em;color:#00b8b1;text-transform:uppercase}+      .dot{width:8px;height:8px;border-radius:50%%;background:%(bar)s;box-shadow:0 0 0 3px rgba(0,184,177,.18)}+      h1{font-size:15px;font-weight:600;margin:8px 0 2px}+      .detail{color:#8b949e;font-size:12px;min-height:1.4em}+      .track{height:6px;background:#21262d;border-radius:3px;margin:10px 0 6px;overflow:hidden}+      .fill{height:100%%;width:%(pct)d%%;background:%(bar)s;transition:width .4s ease}+      .meta{display:flex;justify-content:space-between;font-size:11px;color:#8b949e;font-variant-numeric:tabular-nums}+      .warn{margin-top:10px;padding:8px 10px;border-left:3px solid %(bar)s;background:#161b22;border-radius:6px;font-size:12px}+    </style></head><body><div class="wrap">+      <div class="brand"><span class="dot"></span>Adom is driving Fusion</div>+      <h1>%(title)s</h1>+      <div class="detail">%(detail)s</div>+      <div class="track"><div class="fill"></div></div>+      <div class="meta"><span>%(pct)d%%</span><span>%(eta)s</span></div>+      %(warn)s+    </div></body></html>""" % {+        "bar": bar_color, "pct": pct, "title": _esc(title), "detail": _esc(detail), "eta": eta,+        "warn": ('<div class="warn">Please do not click, type or close documents in Fusion '+                 'until this finishes. Your other apps are unaffected.</div>'+                 if tone == "working" else ""),+    }+++def _esc(s):+    return (str(s or "").replace("&", "&amp;").replace("<", "&lt;").replace(">", "&gt;"))+++def handle_activity_banner(app: adsk.core.Application, args: dict) -> dict:+    """Show / update / hide the banner. args: {action: show|update|hide, title, detail,+    percent, etaSec, tone: working|done|failed}. Never raises."""+    global _palette+    action = str(args.get("action") or "update").lower()+    try:+        ui = app.userInterface+        if action == "hide":+            if _palette:+                try:+                    _palette.isVisible = False+                except Exception:+                    pass+            return {"success": True, "visible": False}++        html = _html(args.get("title") or "Working", args.get("detail") or "",+                     args.get("percent"), args.get("etaSec"), args.get("tone") or "working")+        if _palette is None:+            existing = ui.palettes.itemById(PALETTE_ID)+            if existing:+                _palette = existing+        if _palette is None:+            # Created ONCE. Data-URL HTML: no file on disk to go stale, no server to reach.+            import base64+            _palette = ui.palettes.add(+                PALETTE_ID, "Adom", "data:text/html;base64," + base64.b64encode(html.encode("utf-8")).decode("ascii"),+                True,    # isVisible+                False,   # showCloseButton - the CHAIN hides it; a user closing it mid-run+                         # would just lose the one warning meant for them+                True,    # isResizable+                360, 190)+            try:+                _palette.dockingState = adsk.core.PaletteDockingStates.PaletteDockStateRight+            except Exception:+                pass+        else:+            try:+                _palette.htmlContent = html+            except Exception:+                import base64+                _palette.htmlContent = "data:text/html;base64," + base64.b64encode(html.encode("utf-8")).decode("ascii")+            if not _palette.isVisible:+                _palette.isVisible = True+        return {"success": True, "visible": True}+    except Exception as e:+        # Advisory only: a banner that cannot be drawn must never fail the import.+        return {"success": False, "error": "activity banner unavailable: %s" % str(e)[:160],+                "advisory": True}+++def teardown():+    """Called from the add-in's stop(): remove the palette so a reload does not stack them."""+    global _palette+    try:+        if _palette:+            _palette.deleteMe()+    except Exception:+        pass+    _palette = None

@@ -2609,6 +2609,7 @@ def _handle_aps_open(fusion_info: dict, args: dict) -> dict: # Commands that are proxied to the Fusion add-in (port 8774). # Keys are the CLI-facing names (after stripping "fusion_" prefix). ADDIN_COMMANDS = {+    "activity_banner",     # Mechanical BOM + physical properties (PR #22, Oliver / BOM Forge). These live in the     # ADD-IN, so they must be listed here or the bridge never proxies them and the verb     # 404s no matter how well the handler works.@@ -4308,6 +4309,22 @@ def _build_library_3d_core(args: dict) -> dict:     }  +def _banner(action, title="", detail="", percent=None, eta_sec=None, tone="working"):+    """Drive the in-Fusion 'Adom is driving Fusion' palette. Fire-and-forget.++    Advisory only (John, 2026-08-28): the banner exists so a user looking AT Fusion during a+    10-15 minute import knows not to touch it - the taskbar bar vanishes the moment Fusion is+    maximised in front of them. It must never slow or fail the work it describes, so it is+    short-timeout and swallows every error. Same text the wiki sees.+    """+    try:+        _proxy_to_addin("activity_banner",+                        {"action": action, "title": title, "detail": detail,+                         "percent": percent, "etaSec": eta_sec, "tone": tone}, timeout=8)+    except Exception:+        pass++ def _taskbar_progress(pct=None):     """Show REAL progress on Fusion's Windows-taskbar button instead of orange flashes     (John, 2026-08-23: he keeps seeing attention-flash highlights and no progress bar).@@ -11870,7 +11887,13 @@ def _handle_create_library(fusion_info: dict, args: dict) -> dict:             state["stageStartedAt"] = _tc.time()             _save()             # honest taskbar progress instead of orange attention-flashes (2026-08-23)-            _taskbar_progress(100.0 * _est_done[0] / _est_total)+            _pct = 100.0 * _est_done[0] / _est_total+            _taskbar_progress(_pct)+            # ...and the SAME story inside Fusion's own window (2026-08-28)+            _banner("update", title=stage_name.split(" (")[0].capitalize(),+                    detail=("%d part%s" % (state.get("partsTotal") or 1,+                            "" if (state.get("partsTotal") or 1) == 1 else "s")),+                    percent=_pct, eta_sec=max(0, _est_total - _est_done[0]))         def _leave(stage_key):             took = _tc.time() - float(state.get("stageStartedAt") or _tc.time())             _tmc.log_run("stage:" + stage_key, took, ok=True)@@ -11958,6 +11981,12 @@ def _handle_create_library(fusion_info: dict, args: dict) -> dict:                 # under the progress bar, reading nonsense from part two onward.                 _tot = 4 * max(1, int(state.get("partsToProve") or state.get("partsTotal") or 1))                 state["stageLabel"] = "captured %s (%d of %d)" % (entry.get("step"), len(ev), _tot)+                _banner("update", title="Proving %s" % (entry.get("part") or "library"),+                        detail=state["stageLabel"],+                        percent=100.0 * (_est_done[0] + _est_by_stage.get("prove", 0.0)+                                         * len(ev) / _tot) / _est_total,+                        eta_sec=max(0, _est_total - _est_done[0]+                                    - _est_by_stage.get("prove", 0.0) * len(ev) / _tot))                 _save()              # ⛔ PROVE EVERY PART, NOT JUST THE FIRST (John, 2026-08-28).@@ -12046,6 +12075,23 @@ def _handle_create_library(fusion_info: dict, args: dict) -> dict:                 state.update(stage="done", success=bool(prove.get("proven")),                              verdict=("proven" if prove.get("proven") else "not_proven"),                              evidenceCount=_frames, prove=prove)+            # Resolve the in-Fusion banner to match the verdict, then let it linger briefly+            # so the human sees the outcome, and hide it - a stale "working" banner over an+            # idle Fusion would be the same lie as a stuck progress bar.+            try:+                _ok = state.get("stage") == "done" and state.get("success")+                _banner("update",+                        title=("Library imported" if _ok else "Import did not complete"),+                        detail=(("%d of %d parts proven" % (+                                    (state.get("prove") or {}).get("partsProven", 0),+                                    (state.get("prove") or {}).get("partsTotal", 0)))+                                if _ok else str(state.get("error") or state.get("errorCode") or "")[:120]),+                        percent=100 if _ok else None,+                        eta_sec=0, tone=("done" if _ok else "failed"))+                import threading as _bt+                _bt.Timer(20.0, lambda: _banner("hide")).start()+            except Exception:+                pass             # The part-number gap rides the RUN STATE, so web control sees it on the same             # poll it already makes rather than needing a second call (John, 2026-08-28).             # Attached on the failure path too: a chain that could not prove the geometry@@ -12060,6 +12106,13 @@ def _handle_create_library(fusion_info: dict, args: dict) -> dict:         except Exception as e:             state.update(stage="failed", success=False, verdict="not_proven",                          error=str(e)[:400]); _save()+            _banner("update", title="Import did not complete", detail=str(e)[:120],+                    tone="failed")+            try:+                import threading as _bt+                _bt.Timer(20.0, lambda: _banner("hide")).start()+            except Exception:+                pass         finally:             if _LONG_OP.get("name") == "create_library:" + run_id:                 _LONG_OP["name"] = None