blenderwright 2.2.1__tar.gz → 2.3.0__tar.gz

{blenderwright-2.2.1 → blenderwright-2.3.0}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.5
 Name: blenderwright
-Version: 2.2.1
+Version: 2.3.0
 Summary: The most intuitive and efficient MCP Server for Blender
 License-Expression: MIT
 License-File: LICENSE.md
@@ -45,7 +45,7 @@ The most intuitive and efficient MCP Server for Blender. Control Blender entirel
 ## Key Features
 
 - **[191 tools](https://blenderwright.holdmybeer.gg/)** across 28 modules covering every major Blender domain: modeling, mesh editing, materials, shader nodes, lighting, camera, animation, rendering, sculpting, UV mapping, physics, geometry nodes, rigging, curves, sweeps along a path, 3D-print checking, annotations, collections, file I/O, Bool Tool, viewport control, mesh quality analysis, and extension suggestions
-- **12 expert prompts**: topology best practices, real-world scale references, lighting principles, studio setup, character basemesh workflow, PBR material guide, auto-critique feedback loop, and more
+- **13 expert prompts**: topology best practices, real-world scale references, lighting principles, studio setup, character basemesh workflow, PBR material guide, auto-critique feedback loop, and more
 - **Visual feedback loop**: fast viewport screenshots via OpenGL render (~ms, not seconds) with auto-critique prompts that guide the LLM to check its own work
 - **Mesh quality analysis**: structured reports covering non-manifold edges, loose vertices, zero-area faces, duplicate vertices, and wire edges
 - **Extension suggestions**: proactively recommends Bool Tool, LoopTools, and Node Wrangler when a task would benefit from them (skips already-installed extensions)
@@ -236,7 +236,7 @@ you have; it reports symlinks distinctly.
 
 ## Expert Guidance
 
-blenderwright includes 12 MCP prompts that guide the LLM toward professional-quality results:
+blenderwright includes 13 MCP prompts that guide the LLM toward professional-quality results:
 
 | Prompt | What It Teaches |
 |--------|----------------|
@@ -252,6 +252,7 @@ blenderwright includes 12 MCP prompts that guide the LLM toward professional-qua
 | `character_base_mesh` | Character modeling guide |
 | `scene_cleanup` | Scene organization workflow |
 | `animation_turntable` | Turntable animation setup |
+| `imported_mesh_cleanup` | Import, analyze, repair, decimate, normals, scale, UVs for meshes from scans, downloads, or generators |
 
 ## Tool Domains
 
@@ -404,7 +405,7 @@ blenderwright/
 │   ├── validators.py       # Input validation
 │   ├── tools/              # 28 tool modules (191 tools)
 │   ├── resources/          # MCP resources (scene, objects, materials)
-│   └── prompts/            # 12 expert prompt templates
+│   └── prompts/            # 13 expert prompt templates
 ├── addon/                  # Blender addon (zero external deps)
 │   ├── blender_manifest.toml  # Blender 4.2+ Extension manifest
 │   ├── __init__.py         # bl_info (legacy fallback) + register/unregister

{blenderwright-2.2.1 → blenderwright-2.3.0}/README.md

@@ -27,7 +27,7 @@ The most intuitive and efficient MCP Server for Blender. Control Blender entirel
 ## Key Features
 
 - **[191 tools](https://blenderwright.holdmybeer.gg/)** across 28 modules covering every major Blender domain: modeling, mesh editing, materials, shader nodes, lighting, camera, animation, rendering, sculpting, UV mapping, physics, geometry nodes, rigging, curves, sweeps along a path, 3D-print checking, annotations, collections, file I/O, Bool Tool, viewport control, mesh quality analysis, and extension suggestions
-- **12 expert prompts**: topology best practices, real-world scale references, lighting principles, studio setup, character basemesh workflow, PBR material guide, auto-critique feedback loop, and more
+- **13 expert prompts**: topology best practices, real-world scale references, lighting principles, studio setup, character basemesh workflow, PBR material guide, auto-critique feedback loop, and more
 - **Visual feedback loop**: fast viewport screenshots via OpenGL render (~ms, not seconds) with auto-critique prompts that guide the LLM to check its own work
 - **Mesh quality analysis**: structured reports covering non-manifold edges, loose vertices, zero-area faces, duplicate vertices, and wire edges
 - **Extension suggestions**: proactively recommends Bool Tool, LoopTools, and Node Wrangler when a task would benefit from them (skips already-installed extensions)
@@ -218,7 +218,7 @@ you have; it reports symlinks distinctly.
 
 ## Expert Guidance
 
-blenderwright includes 12 MCP prompts that guide the LLM toward professional-quality results:
+blenderwright includes 13 MCP prompts that guide the LLM toward professional-quality results:
 
 | Prompt | What It Teaches |
 |--------|----------------|
@@ -234,6 +234,7 @@ blenderwright includes 12 MCP prompts that guide the LLM toward professional-qua
 | `character_base_mesh` | Character modeling guide |
 | `scene_cleanup` | Scene organization workflow |
 | `animation_turntable` | Turntable animation setup |
+| `imported_mesh_cleanup` | Import, analyze, repair, decimate, normals, scale, UVs for meshes from scans, downloads, or generators |
 
 ## Tool Domains
 
@@ -386,7 +387,7 @@ blenderwright/
 │   ├── validators.py       # Input validation
 │   ├── tools/              # 28 tool modules (191 tools)
 │   ├── resources/          # MCP resources (scene, objects, materials)
-│   └── prompts/            # 12 expert prompt templates
+│   └── prompts/            # 13 expert prompt templates
 ├── addon/                  # Blender addon (zero external deps)
 │   ├── blender_manifest.toml  # Blender 4.2+ Extension manifest
 │   ├── __init__.py         # bl_info (legacy fallback) + register/unregister

{blenderwright-2.2.1 → blenderwright-2.3.0}/addon/__init__.py

@@ -8,7 +8,7 @@ Blender's Python API.
 bl_info = {
     "name": "blenderwright",
     "author": "blenderwright",
-    "version": (2, 2, 1),
+    "version": (2, 3, 0),
     "blender": (4, 2, 0),
     "location": "View3D > Sidebar > blenderwright",
     "description": "MCP Server integration for AI-assisted 3D workflows",

{blenderwright-2.2.1 → blenderwright-2.3.0}/addon/blender_manifest.toml

@@ -1,7 +1,7 @@
 schema_version = "1.0.0"
 
 id = "blenderwright"
-version = "2.2.1"
+version = "2.3.0"
 name = "blenderwright"
 tagline = "MCP server integration for AI-assisted 3D workflows"
 maintainer = "jabberwock <88205+jabberwock@users.noreply.github.com>"

{blenderwright-2.2.1 → blenderwright-2.3.0}/addon/handlers/mesh_quality.py

@@ -97,10 +97,8 @@ def handle_repair_mesh(params: dict) -> dict:
 
     bpy.ops.object.mode_set(mode="EDIT")
     try:
-        bpy.ops.mesh.select_all(action="SELECT")
-        if params.get("remove_loose", True):
-            bpy.ops.mesh.delete_loose()
-            applied.append("remove_loose")
+        # Dissolving degenerate faces and filling holes can both leave
+        # vertices with no faces behind, so loose removal runs last.
         if params.get("dissolve_degenerate", True):
             bpy.ops.mesh.select_all(action="SELECT")
             bpy.ops.mesh.dissolve_degenerate()
@@ -109,6 +107,10 @@ def handle_repair_mesh(params: dict) -> dict:
             bpy.ops.mesh.select_all(action="SELECT")
             bpy.ops.mesh.fill_holes(sides=0)
             applied.append("fill_holes")
+        if params.get("remove_loose", True):
+            bpy.ops.mesh.select_all(action="SELECT")
+            bpy.ops.mesh.delete_loose()
+            applied.append("remove_loose")
     finally:
         bpy.ops.object.mode_set(mode="OBJECT")
 

{blenderwright-2.2.1 → blenderwright-2.3.0}/pyproject.toml

@@ -4,7 +4,7 @@ build-backend = "hatchling.build"
 
 [project]
 name = "blenderwright"
-version = "2.2.1"
+version = "2.3.0"
 description = "The most intuitive and efficient MCP Server for Blender"
 readme = "README.md"
 requires-python = ">=3.10"

{blenderwright-2.2.1 → blenderwright-2.3.0}/src/blenderwright/prompts/workflows.py

@@ -328,3 +328,54 @@ def auto_critique_workflow() -> str:
         "end of the sequence, not after every individual step.\n"
         "- If the user asks you to skip screenshots, respect that preference.\n"
     )
+
+
+@mcp.prompt()
+def imported_mesh_cleanup() -> str:
+    """Take a mesh that did not originate in Blender from import to clean, usable geometry."""
+    return (
+        "## Imported Mesh Cleanup Workflow\n\n"
+        "Meshes that come from outside Blender (photogrammetry scans, marketplace "
+        "downloads, sculpt exports, CAD conversions, AI-generated models) usually "
+        "carry defects: split vertices along every seam, loose vertices, zero-area "
+        "faces, open boundaries, inverted normals, far too many triangles, and no "
+        "usable UVs. Measure before you fix, and fix only what the report calls for.\n\n"
+        "1. Import with `import_file(filepath)`. Use the names in `imported_objects` "
+        "for every step below.\n"
+        "2. Run `analyze_mesh_quality(object_name)` and read the report before touching "
+        "anything. `issues_found` says whether steps 3 to 5 are needed at all.\n"
+        "3. If `duplicate_vertex_count` is non-zero, run `merge_vertices(object_name)` "
+        "with the default threshold FIRST. GLB, FBX and OBJ exporters split vertices "
+        "wherever UVs or normals change, so a clean mesh can arrive with thousands of "
+        "duplicates and a `non_manifold_edge_count` that is mostly false. Merging "
+        "collapses them and makes the non-manifold count truthful.\n"
+        "4. Run `repair_mesh(object_name)` with the defaults (remove_loose and "
+        "dissolve_degenerate). These cannot damage a well-formed mesh. Leave "
+        "`fill_holes` off unless `non_manifold_edge_count` is still high after merging "
+        "AND the model is meant to be watertight (3D print, boolean operand, fluid "
+        "domain). Filling holes invents geometry, so check the result visually.\n"
+        "5. Run `analyze_mesh_quality` again and compare the counts. If "
+        "`non_manifold_edge_count` is still non-zero on a model that only needs to "
+        "render, stop here; open boundaries are fine for rendering.\n"
+        "6. Check density from `face_count`. Scans and generated meshes are often "
+        "500k+ triangles. If the face count is far beyond what the use needs, run "
+        "`decimate_mesh(object_name, ratio)` (0.1 to 0.3 for a scan, 0.5 for a mild "
+        "reduction). For a clean quad surface instead of collapsed triangles, use "
+        "`remesh` with a voxel size appropriate to the model's scale.\n"
+        "7. Run `recalculate_normals(object_name)`. Imported meshes frequently have "
+        "inconsistent winding, which shows as black patches in the viewport.\n"
+        "8. Check scale and transforms with `get_object_info`. Many exporters land a "
+        "mesh with a 100x or 0.01x object scale; compare `dimensions` against "
+        "`scale_reference_guide`, fix with `set_scale`, then `apply_transforms` so the "
+        "mesh data carries the real size. Use `set_origin` if the pivot is off.\n"
+        "9. Run `shade_auto_smooth(object_name)` so hard edges stay crisp and curved "
+        "surfaces look smooth.\n"
+        "10. If the model has no UVs or they are unusable, run "
+        "`smart_uv_project(object_name)` before building materials.\n"
+        "11. Run `focus_on_object(object_name)` so the viewport actually frames it "
+        "(the view may be left far away after a scale fix), then capture "
+        "`get_viewport_screenshot(mode='fast')` and critique the result (see "
+        "auto_critique_workflow). Look for holes, shading artifacts, and proportions.\n\n"
+        "Only after this pass should you retopologize, add modifiers, or build "
+        "materials on the mesh. Working on dirty geometry compounds every later problem."
+    )

{blenderwright-2.2.1 → blenderwright-2.3.0}/tests/test_addon/test_handlers/test_mesh_quality_handler.py

@@ -437,3 +437,49 @@ class TestAnalyzeMeshQualityErrors:
 
         with pytest.raises(ValueError, match="not a mesh"):
             mod.handle_analyze_mesh_quality({"object_name": "Camera"})
+
+
+class TestRepairMeshOrder:
+    """Dissolving degenerate faces can orphan vertices, so loose removal must run after it."""
+
+    def _run_repair(self, mod, params):
+        import bpy
+        mock_obj = MagicMock()
+        mock_obj.name = "Cube"
+        mock_obj.type = "MESH"
+        mock_obj.mode = "OBJECT"
+        mock_obj.data.vertices = []
+        mock_obj.data.edges = []
+        mock_obj.data.polygons = []
+        bpy.data.objects.get.return_value = mock_obj
+        bpy.ops.mesh.reset_mock()
+        return mod.handle_repair_mesh(params)
+
+    def test_dissolve_degenerate_runs_before_delete_loose(self, handler_and_bmesh):
+        mod, _ = handler_and_bmesh
+        import bpy
+
+        self._run_repair(mod, {"object_name": "Cube"})
+
+        names = [c[0] for c in bpy.ops.mesh.mock_calls]
+        assert "dissolve_degenerate" in names
+        assert "delete_loose" in names
+        assert names.index("dissolve_degenerate") < names.index("delete_loose")
+
+    def test_fill_holes_runs_before_delete_loose(self, handler_and_bmesh):
+        mod, _ = handler_and_bmesh
+        import bpy
+
+        self._run_repair(mod, {"object_name": "Cube", "fill_holes": True})
+
+        names = [c[0] for c in bpy.ops.mesh.mock_calls]
+        assert names.index("fill_holes") < names.index("delete_loose")
+
+    def test_repairs_applied_reports_every_enabled_step(self, handler_and_bmesh):
+        mod, _ = handler_and_bmesh
+
+        result = self._run_repair(mod, {"object_name": "Cube", "fill_holes": True})
+
+        assert set(result["repairs_applied"]) == {
+            "remove_loose", "dissolve_degenerate", "fill_holes"
+        }

blenderwright-2.3.0/tests/test_tools/test_imported_mesh_cleanup_prompt.py

@@ -0,0 +1,71 @@
+"""Unit tests for the imported mesh cleanup workflow prompt."""
+
+from blenderwright.prompts.workflows import imported_mesh_cleanup
+
+
+class TestImportedMeshCleanupPrompt:
+    def test_returns_non_empty_string(self):
+        result = imported_mesh_cleanup()
+        assert isinstance(result, str)
+        assert len(result) > 0
+
+    def test_is_vendor_neutral(self):
+        result = imported_mesh_cleanup().lower()
+        for vendor in ("tripo", "meshy", "sketchfab", "luma", "rodin"):
+            assert vendor not in result
+
+    def test_chains_import_analyze_repair(self):
+        result = imported_mesh_cleanup()
+        assert "import_file" in result
+        assert "analyze_mesh_quality" in result
+        assert "repair_mesh" in result
+        assert result.index("import_file") < result.index("analyze_mesh_quality")
+        assert result.index("analyze_mesh_quality") < result.index("repair_mesh")
+
+    def test_merges_duplicates_before_repair(self):
+        result = imported_mesh_cleanup()
+        assert "merge_vertices" in result
+        assert "duplicate_vertex_count" in result
+        assert result.index("merge_vertices") < result.index("repair_mesh")
+
+    def test_fill_holes_is_called_out_as_opt_in(self):
+        result = imported_mesh_cleanup()
+        assert "fill_holes" in result
+        assert "non_manifold_edge_count" in result
+
+    def test_covers_density_and_normals(self):
+        result = imported_mesh_cleanup()
+        assert "decimate_mesh" in result
+        assert "recalculate_normals" in result
+
+    def test_covers_transforms_and_scale(self):
+        result = imported_mesh_cleanup()
+        assert "apply_transforms" in result
+        assert "scale_reference_guide" in result
+
+    def test_covers_shading_and_uvs(self):
+        result = imported_mesh_cleanup()
+        assert "shade_auto_smooth" in result
+        assert "smart_uv_project" in result
+
+    def test_names_common_sources(self):
+        result = imported_mesh_cleanup().lower()
+        assert "scan" in result
+        assert "generated" in result
+
+    def test_reanalyzes_after_repair(self):
+        result = imported_mesh_cleanup()
+        assert result.count("analyze_mesh_quality") >= 2
+
+    def test_ends_with_visual_check(self):
+        result = imported_mesh_cleanup()
+        assert "get_viewport_screenshot" in result
+
+    def test_frames_object_before_screenshot(self):
+        result = imported_mesh_cleanup()
+        assert "focus_on_object" in result
+        assert result.index("focus_on_object") < result.index("get_viewport_screenshot")
+
+    def test_uses_import_result_names(self):
+        result = imported_mesh_cleanup()
+        assert "imported_objects" in result

{blenderwright-2.2.1 → blenderwright-2.3.0}/uv.lock

@@ -51,7 +51,7 @@ wheels = [
 
 [[package]]
 name = "blenderwright"
-version = "2.2.1"
+version = "2.3.0"
 source = { editable = "." }
 dependencies = [
     { name = "mcp" },
@@ -99,11 +99,11 @@ dev = [
 
 [[package]]
 name = "certifi"
-version = "2026.7.22"
+version = "2026.10.19"
 source = { registry = "https://pypi.org/simple" }
-sdist = { url = "https://files.pythonhosted.org/packages/a3/c2/24167ea9858356b47a87a50d39908bfdb72ceeefe0041586e704e5376b3a/certifi-2026.7.22.tar.gz", hash = "sha256:741e2c3b351ddf169a738da9f2c048608ff7f2c5cc02f1ebc6b118bb090d5d55", size = 138112, upload-time = "2026-07-22T03:35:12.644Z" }
+sdist = { url = "https://files.pythonhosted.org/packages/a6/bd/1436c50cc46699de0230fbaacc1d1de7bfec413176099949e9d5112e88f2/certifi-2026.10.19.tar.gz", hash = "sha256:035c1e85572b141bf1c3a3eff0e33a8eb74917522f2559075ff8d2fea780a1ae", size = 137598, upload-time = "2026-10-20T02:24:16.604Z" }
 wheels = [
-    { url = "https://files.pythonhosted.org/packages/0b/a7/71ac2cff56fec219ed242bb11b8efb69fcc4bec75db06fb7bfe35de520e6/certifi-2026.7.22-py3-none-any.whl", hash = "sha256:62f22742b58a1a33014a2b6b706588a8d7e2a88ae7bd1a6ebe8c992928483775", size = 136983, upload-time = "2026-07-22T03:35:11.276Z" },
+    { url = "https://files.pythonhosted.org/packages/c4/51/29046e48f693c54e5b7412216d447a1d8362c9653148d98c02cdf65fa733/certifi-2026.10.19-py3-none-any.whl", hash = "sha256:42d35340cc5b9ba78e818ddbff0c5b1c2b779de448a340fd1b989f5fa8670e1b", size = 136464, upload-time = "2026-10-20T02:24:15.072Z" },
 ]
 
 [[package]]