chrore: major overhaul of docs, commands, and workflows (#23)

* ci: add status badges to README

* chore: major overhaul - docs, commands & workflows

* fix: general fixes and improvements

* chore: various updates and fixes

* chore: minor fixes

tests/integration/conftest.py

@@ -120,7 +120,7 @@ def pytest_collection_modifyitems(
         return
 
     # Check bridge connection once
-    is_available, error, instance_id = _check_bridge_connection()
+    is_available, error, _instance_id = _check_bridge_connection()
 
     if not is_available:
         # Apply skip marker to all integration tests

tests/integration/test_cut_object_for_magnets.py

@@ -13,7 +13,7 @@ Test Organization:
 - TestEdgeCases: Edge case tests (single hole, many holes)
 
 Note: These tests require a running FreeCAD MCP bridge.
-      Start it with: just run-gui or just run-headless
+      Start it with: just freecad::run-gui or just freecad::run-headless
 
 Note: PartDesign::Hole has a CADKernelError bug in some FreeCAD headless
       environments (especially AppImage on Linux CI) where it fails with

tests/integration/test_gui_mode.py

@@ -5,7 +5,7 @@ in GUI mode (with full graphical interface). They test GUI-specific features
 like visibility, display modes, colors, and camera operations.
 
 Note: These tests require a running FreeCAD GUI server.
-      Start it with: just run-gui
+      Start it with: just freecad::run-gui
 
 To run these tests:
     pytest tests/integration/test_gui_mode.py -v

tests/integration/test_headless_mode.py

@@ -5,7 +5,7 @@ in headless mode (without GUI). They test object creation, manipulation, and
 export functionality.
 
 Note: These tests require a running FreeCAD headless server.
-      Start it with: just run-headless
+      Start it with: just freecad::run-headless
 
 To run these tests:
     pytest tests/integration/test_headless_mode.py -v

tests/integration/test_multi_export.py

@@ -7,7 +7,7 @@ These tests verify the MultiExporter class functionality including:
 - Handling mesh tolerance settings
 
 Note: These tests require a running FreeCAD MCP bridge.
-      Start it with: just run-gui or just run-headless
+      Start it with: just freecad::run-gui or just freecad::run-headless
 
 To run these tests:
     pytest tests/integration/test_multi_export.py -v