Fusion - the Fusion 360 Bridge

@@ -95,8 +95,14 @@ def handle_close_all_documents(app: adsk.core.Application, args: dict) -> dict:      Args (all optional):         save: If True, save each document before closing. Default False.+        closeUntitled: If True, ALSO close scratch "Untitled" documents that have no+            data file. Default False (the historical behaviour).+        force: With closeUntitled, also close Untitled docs that are MODIFIED. Default+            False, because a modified Untitled may hold real unsaved user work.     """     save_changes = args.get("save", False)+    close_untitled = bool(args.get("closeUntitled", False))+    force_untitled = bool(args.get("force", False))      closed = []     errors = []@@ -123,15 +129,33 @@ def handle_close_all_documents(app: adsk.core.Application, args: dict) -> dict:         except Exception:             doc_name = "<unknown>"         try:-            # Skip Untitled blank docs — Fusion recreates them, closing is pointless+            # UNTITLED SCRATCH DOCS (page issue #59, 2026-08-26).+            # This used to skip EVERY Untitled with the reasoning "Fusion recreates them,+            # closing is pointless". That is true of the ONE blank doc Fusion keeps, and+            # false of the sixteen the library/bind flow left behind after three imports -+            # roughly five per import, unbounded across a run, and unclosable by any+            # caller, which is what starved Fusion until a 3D step blew its 60s budget.+            # Now opt-in: closeUntitled closes the UNMODIFIED ones (scratch by definition,+            # so nothing can be lost), and force is required to close a MODIFIED Untitled+            # because that one may hold real unsaved work. Fusion re-creates a single+            # blank doc if the last one closes, which satisfies "keep exactly one".             has_data_file = False             try:                 has_data_file = doc.dataFile is not None             except Exception:                 has_data_file = False             if not has_data_file and doc_name.lower().startswith("untitled"):-                skipped.append(doc_name)-                continue+                if not close_untitled:+                    skipped.append(doc_name)+                    continue+                is_modified = False+                try:+                    is_modified = bool(doc.isModified)+                except Exception:+                    is_modified = False+                if is_modified and not force_untitled:+                    skipped.append(doc_name + " (modified - pass force:true to discard)")+                    continue             doc.close(save_changes)             closed.append(doc_name)         except Exception as e:

@@ -186,7 +186,8 @@ _T = [     ("fusion_open_cloud_file", "Open a CLOUD file by name (the front door to every design flow). PCB/ELECTRONICS NAV RULE: open the electronics DESIGN document (EcadDesignProductType), never a child .brd/.sch/3D directly - then switch views with fusion_show_schematic / fusion_show_2d_board / fusion_show_3d_board. LONG-RUNNING: fire it, then poll fusion_get_app_state until activeDocument matches (cloud opens on electronics designs take 1-3 min). A crash-recovery modal can block the open - fusion_dismiss_blocking_dialogs.", {"fileName": "required str", "projectName": "optional str (defaults to active project)", "folderPath": "optional str"}, {"success": "bool", "documentName": "str"}, 240, "fusion_get_app_state", True, {"fileName": "BQ25792", "projectName": "Main"}),     ("fusion_open_design", "Open a LOCAL design file (routes through the add-in import). Prefer cloud flows (fusion_open_cloud_file) for team designs; this is for local .f3d/.step style files.", {"filePath": "required str (WINDOWS path)"}, {"success": "bool"}, 240, None, True, {"filePath": "C:/Temp/part.f3d"}),     ("fusion_close_document", "Close ONE document WITHOUT the modal save dialog (save:false discards silently - the automation-safe close). Omit name to close the active document.", {"name": "optional str (default: active document)", "save": "optional bool default false"}, {"success": "bool", "closed": "str"}, 60, None, False, {"save": False}),-    ("fusion_close_all_documents", "Close ALL open documents without save dialogs. DESTRUCTIVE to unsaved user work - confirm with the human before calling on a box you do not own.", {"save": "optional bool default false"}, {"success": "bool", "closedCount": "int"}, 60, None, False, {}),+    ("fusion_close_all_documents", "Close ALL open documents without save dialogs. DESTRUCTIVE to unsaved user work - confirm with the human before calling on a box you do not own. By default it SKIPS scratch 'Untitled' docs; pass closeUntitled:true to close the UNMODIFIED ones too (page issue #59: the library/bind flow left ~5 per import, 16 after three, and no caller could clear them), and force:true to also discard MODIFIED Untitled docs, which may hold real unsaved work.", {"save": "optional bool default false", "closeUntitled": "optional bool default false - also close UNMODIFIED Untitled scratch docs", "force": "optional bool default false - with closeUntitled, also discard MODIFIED Untitled docs"}, 60, None, False, {"closeUntitled": True}),+    ("fusion_reset_workspace", "Bring Fusion back to a clean slate between runs: closes named documents AND the Untitled scratch the library/bind flow leaves behind (page issue #59). Fusion always keeps ONE blank document alive, so a single remaining Untitled is correct rather than a failure. MODIFIED Untitled docs are left untouched unless force:true, because those can hold real unsaved work.", {"force": "optional bool default false - also discard MODIFIED Untitled docs"}, {"success": "bool", "closedByAddin": "list", "untitledScratchClosed": "int", "remaining": "list"}, 90, None, False, {}),     ("fusion_document_info", "Metadata for the ACTIVE document: name, product type, save state, version, parent project.", {}, {"success": "bool", "name": "str", "productType": "str", "isSaved": "bool"}, 30, None, False, {}),     ("fusion_execute_text_command", "Run a raw Fusion TEXT COMMAND (app.executeTextCommand) - the escape hatch to Fusion internals (Electron.* electronics commands included). Electron.* commands need an ELECTRONICS document context (schematic/board view active). Guard risky calls with expectDocument.", {"command": "required str", "expectDocument": "optional str (refuses wrong_document if the active doc does not match)"}, {"success": "bool", "output": "str"}, 60, None, False, {"command": "Electron.ImmediateRepaint /full"}),     ("fusion_get_design_info", "Design-level summary of the active design: components, bodies, sketches, units, root name.", {}, {"success": "bool", "components": "int", "bodies": "int"}, 60, None, False, {}),

@@ -11,10 +11,6 @@     "uninstall": "./uninstall.sh"   },   "tags": [-    "ab",-    "bridge",-    "fusion",-    "desktop-app",     "fusion360",     "autodesk",     "cad",@@ -79,10 +75,7 @@     "build a basic parts library",     "add a 3d model to a component",     "make a fusion 360 library with 3d",-    "set up the fusion bridge",-    "fusion dashboard",-    "fusion status page",-    "open the fusion launch page"+    "set up the fusion bridge"   ],   "discovery_pitch": "Use the Adom Bridge Fusion 360 bridge when the user wants to DRIVE Autodesk Fusion 360 from the cloud: open/search their team's Fusion cloud designs, lay out a PCB or do electronics, export STEP/IGES/STL/Gerbers/BOM, or build a component library with real rendering 3D. It runs Fusion on the user's own machine via Adom Bridge. NOT for web/browser/login/form-filling (that's the native-browser extension) and NOT for KiCad (that's the kicad bridge).",   "brief": "Drive Autodesk Fusion 360 from the cloud via Adom Bridge: component libraries, IPC package generation, board layout, exports (STEP/Gerbers/BOM/CPL), fast APS cloud search, and parametric modeling.",@@ -111,5 +104,9 @@       "label": "Part volume",       "prompt": "How much material does each printed part in this assembly use?"     }-  ]-}+  ],+  "author": {+    "name": "John Lauer",+    "email": "[email protected]"+  }+}\ No newline at end of file

@@ -0,0 +1,78 @@+warmup: waking the bridge (unscored)...+  fusion_readiness                           PASS +  fusion_describe                            FAIL - verbs described but UNTRIAGED in test plan: ['fusion_create_library', 'fusion_preflight_lbr', 'fusion_set_driving_badge', 'fusion_set_window_sizing']+  fusion_get_app_state                       FAIL - expected success, got error=Fusion 360 is installed but not running. code=fusion_not_running+  fusion_search_cloud_files                  PASS +  fusion_walk_cloud_tree                     PASS +  fusion_aps_status                          PASS +  fusion_aps_get_browser                     PASS +  fusion_aps_search                          FAIL - expected >0 results+  fusion_aps_recent                          PASS +  fusion_aps_browse                          PASS +  fusion_aps_file_info                       FAIL - expected success, got error=No cloud file matching 'BQ25792'. code=None; missing field 'versionCount'+  fusion_aps_get                             PASS +  fusion_uninstall                           PASS +  fusion_set_seat_takeover                   PASS +  fusion_start                               PASS +  fusion_get_preferences                     PASS +  fusion_set_preference                      PASS +  fusion_mcp_status                          PASS +  fusion_set_auto_update                     PASS +  fusion_assembly_bom                        PASS +  fusion_dismiss_blocking_dialogs            PASS +  fusion_open_cloud_file                     FAIL - expected success, got error=Project 'Main' not found code=None+  fusion_show_schematic                      FAIL - expected success, got error=Switch to schematic failed: 3 : Please open or create an electronics design to c code=None+  fusion_show_2d_board                       FAIL - expected success, got error=Switch to 2D board failed: 3 : Please open or create an electronics design to co code=None+  fusion_board_info                          FAIL - expected success, got error=No board open (current workspace: Design). Open a .brd file first with fusion_op code=None; missing field 'rawXml'+  fusion_execute_text_command                FAIL - expected success, got error=Active document is 'Untitled', expected 'BQ25792'. code=wrong_document+  fusion_show_3d_board                       FAIL - expected success, got error=Not in Electronics editor (current workspace: Design). Open a .brd board file fi code=None+  fusion_inspect_bodies                      PASS +  fusion_physical_properties                 PASS +  fusion_get_design_info                     PASS +  fusion_get_parameters                      PASS +  fusion_document_info                       PASS +  fusion_run_modeling_script#guard           PASS +  fusion_assembly_bom#guard                  PASS +  fusion_run_modeling_script                 FAIL - expected success, got error=Active document is 'Untitled', expected 'BQ25792'. code=wrong_document+  fusion_close_window#noargs                 PASS +  fusion_cleanup_cloud_files#guard           PASS +  fusion_screenshot_fusion                   PASS +  fusion_state                               PASS +  fusion_demo_progress#unknown               PASS +  focus_invariance                           PASS+cleanup: this run started Fusion - closing it (fusion_stop)...+  fusion_stop: ok++Section coverage (John's product map, 2026-08-14):+  gui-driving                            7 pass / 6 fail (13 manual, 0 skip)  RED+  cad-3d-bom                             7 pass / 0 fail (0 manual, 0 skip)  green+  mcp-server                             1 pass / 0 fail (1 manual, 0 skip)  green+  python-addin                           1 pass / 2 fail (1 manual, 0 skip)  RED+  aps                                    6 pass / 2 fail (5 manual, 0 skip)  RED+  auth-tokens                            2 pass / 0 fail (2 manual, 0 skip)  green+  exports                                0 pass / 0 fail (2 manual, 0 skip)  untested-this-tier+  bridge-lifecycle                       6 pass / 5 fail (12 manual, 0 skip)  RED++30 PASS, 15 FAIL (36 manual-tier, 0 skipped) -> /home/adom/project/adom-desktop-fusion-bridge/tests/reports/verb-test-2026-08-26_1152.json+  FAIL: fusion_create_library - described but untriaged in tests/run_verb_tests.py+  FAIL: fusion_preflight_lbr - described but untriaged in tests/run_verb_tests.py+  FAIL: fusion_set_driving_badge - described but untriaged in tests/run_verb_tests.py+  FAIL: fusion_set_window_sizing - described but untriaged in tests/run_verb_tests.py+  FAIL: fusion_describe - verbs described but UNTRIAGED in test plan: ['fusion_create_library', 'fusion_preflight_lbr', 'fusion_set_driving_badge', 'fusion_set_window_sizing']+  FAIL: fusion_get_app_state - expected success, got error=Fusion 360 is installed but not running. code=fusion_not_running+  FAIL: fusion_aps_search - expected >0 results+  FAIL: fusion_aps_file_info - expected success, got error=No cloud file matching 'BQ25792'. code=None; missing field 'versionCount'+  FAIL: fusion_open_cloud_file - expected success, got error=Project 'Main' not found code=None+  FAIL: fusion_show_schematic - expected success, got error=Switch to schematic failed: 3 : Please open or create an electronics design to c code=None+  FAIL: fusion_show_2d_board - expected success, got error=Switch to 2D board failed: 3 : Please open or create an electronics design to co code=None+  FAIL: fusion_board_info - expected success, got error=No board open (current workspace: Design). Open a .brd file first with fusion_op code=None; missing field 'rawXml'+  FAIL: fusion_execute_text_command - expected success, got error=Active document is 'Untitled', expected 'BQ25792'. code=wrong_document+  FAIL: fusion_show_3d_board - expected success, got error=Not in Electronics editor (current workspace: Design). Open a .brd board file fi code=None+  FAIL: fusion_run_modeling_script - expected success, got error=Active document is 'Untitled', expected 'BQ25792'. code=wrong_document+error: unrecognized subcommand 'issue'++  tip: a similar subcommand exists: 'asset'++Usage: adom-wiki <COMMAND>++For more information, try '--help'.

@@ -5,3 +5,4 @@ RED 2026-08-21 (exit 1) RED 2026-08-22 (exit 1) RED 2026-08-23 (exit 1) RED 2026-08-24 (exit 1)+RED 2026-08-26 (exit 1)