meshwire 0.5.0a1__tar.gz

meshwire-0.5.0a1/.editorconfig

@@ -0,0 +1,24 @@
+# EditorConfig helps maintain consistent coding styles
+# https://editorconfig.org
+
+root = true
+
+[*]
+indent_style = space
+indent_size = 4
+end_of_line = lf
+charset = utf-8
+trim_trailing_whitespace = true
+insert_final_newline = true
+
+[*.py]
+max_line_length = 100
+
+[*.md]
+trim_trailing_whitespace = false
+
+[*.{json,yaml,yml,toml}]
+indent_size = 2
+
+[Makefile]
+indent_style = tab

meshwire-0.5.0a1/.github/ISSUE_TEMPLATE/bug_report.yml

@@ -0,0 +1,77 @@
+name: Bug Report
+description: Report a bug or unexpected behavior
+title: "[Bug]: "
+labels: ["bug"]
+body:
+  - type: markdown
+    attributes:
+      value: |
+        Thanks for reporting! Please fill out the details below.
+  - type: input
+    id: blender-version
+    attributes:
+      label: Blender Version
+      description: "e.g., 4.2.19 LTS, 5.0"
+      placeholder: "4.2.19"
+    validations:
+      required: true
+  - type: input
+    id: mcp-version
+    attributes:
+      label: MCP Server Version
+      description: "e.g., 0.2.0"
+      placeholder: "0.2.0"
+    validations:
+      required: true
+  - type: input
+    id: tool-name
+    attributes:
+      label: Tool Name
+      description: "Which MCP tool is affected? e.g., blender_object_create"
+      placeholder: "blender_"
+  - type: textarea
+    id: description
+    attributes:
+      label: Description
+      description: What happened? What did you expect to happen?
+    validations:
+      required: true
+  - type: textarea
+    id: steps
+    attributes:
+      label: Steps to Reproduce
+      description: Minimal steps to reproduce the issue
+      value: |
+        1.
+        2.
+        3.
+    validations:
+      required: true
+  - type: textarea
+    id: error
+    attributes:
+      label: Error Output
+      description: Paste any error messages or logs
+      render: shell
+  - type: dropdown
+    id: os
+    attributes:
+      label: Operating System
+      options:
+        - Windows
+        - macOS
+        - Linux
+    validations:
+      required: true
+  - type: dropdown
+    id: mcp-client
+    attributes:
+      label: MCP Client
+      options:
+        - Claude Desktop
+        - Claude Code
+        - Cursor
+        - VS Code + Continue
+        - Other
+    validations:
+      required: true

meshwire-0.5.0a1/.github/ISSUE_TEMPLATE/feature_request.yml

@@ -0,0 +1,54 @@
+name: Feature Request
+description: Suggest a new tool or enhancement
+title: "[Feature]: "
+labels: ["enhancement"]
+body:
+  - type: markdown
+    attributes:
+      value: |
+        Thanks for suggesting an improvement! Please describe what you'd like.
+  - type: dropdown
+    id: category
+    attributes:
+      label: Tool Category
+      description: Which area does this feature relate to?
+      options:
+        - Scene / Object Management
+        - Modeling / Mesh Editing
+        - Materials / Shaders
+        - Sculpting
+        - Rigging / Armature
+        - Animation
+        - Rendering
+        - Baking
+        - Geometry Nodes
+        - Physics Simulation
+        - Export / Import
+        - AI Generation Pipeline
+        - MSFS Content Creation
+        - Livery System
+        - Measurement / Validation
+        - Collections / System
+        - Annotations
+        - Other
+    validations:
+      required: true
+  - type: textarea
+    id: description
+    attributes:
+      label: Description
+      description: Describe the feature or tool you'd like to see
+    validations:
+      required: true
+  - type: textarea
+    id: use-case
+    attributes:
+      label: Use Case
+      description: How would you use this? What workflow does it enable?
+    validations:
+      required: true
+  - type: textarea
+    id: alternatives
+    attributes:
+      label: Alternatives Considered
+      description: Any workarounds you've tried (e.g., using execute_script)

meshwire-0.5.0a1/.github/PULL_REQUEST_TEMPLATE.md

@@ -0,0 +1,31 @@
+## Summary
+
+Brief description of what this PR does.
+
+## Changes
+
+-
+
+## Tool Changes
+
+- [ ] New tools added (update tool count in test_server.py)
+- [ ] Existing tools modified
+- [ ] Handler registrations added in `addon/blender_mcp_addon/handlers/`
+- [ ] Handler implementations added
+
+## Testing
+
+- [ ] `pytest tests/ --ignore=tests/blender_integration_test.py` passes
+- [ ] Truth harness baselines updated if any tool result class changed (see CONTRIBUTING.md)
+- [ ] `ruff check .` passes
+- [ ] Tested with Blender (version: )
+- [ ] Tested via MCP client (client: )
+
+## Checklist
+
+- [ ] Tool definitions use `"type": "number"` (not `"integer"`) for numeric params
+- [ ] Handler returns `{"success": True, ...}` or `{"error": "..."}`
+- [ ] README updated if new tools added
+- [ ] CHANGELOG updated
+
+- [ ] I have read and agree to [CLA.md](../CLA.md) for this contribution.

meshwire-0.5.0a1/.github/dependabot.yml

@@ -0,0 +1,19 @@
+version: 2
+updates:
+  - package-ecosystem: uv
+    directory: /
+    schedule:
+      interval: weekly
+    open-pull-requests-limit: 2
+    groups:
+      python-minor-patch:
+        update-types: [minor, patch]
+
+  - package-ecosystem: github-actions
+    directory: /
+    schedule:
+      interval: weekly
+    open-pull-requests-limit: 2
+    groups:
+      actions-minor-patch:
+        update-types: [minor, patch]

meshwire-0.5.0a1/.github/workflows/blender.yml

@@ -0,0 +1,162 @@
+name: Blender harness
+
+on:
+  pull_request:
+    branches: [main]
+  push:
+    branches: [main]
+  schedule:
+    - cron: "17 4 * * *"
+  workflow_dispatch:
+
+permissions:
+  contents: read
+
+concurrency:
+  group: blender-${{ github.event_name }}-${{ github.event_name == 'pull_request' && github.ref || github.run_id }}
+  cancel-in-progress: ${{ github.event_name == 'pull_request' }}
+
+env:
+  BLENDER_DEPS: >-
+    xvfb xauth libgl1 libegl1 libglx-mesa0 libgl1-mesa-dri libxi6 libxxf86vm1
+    libxfixes3 libxrender1 libxkbcommon0 libsm6 libice6 libxkbcommon-x11-0 libdbus-1-3
+
+jobs:
+  # Gated: an unrecorded behavior change on a supported Blender fails the run.
+  gated:
+    name: Blender ${{ matrix.version }}
+    runs-on: ubuntu-24.04
+    timeout-minutes: 45
+    strategy:
+      fail-fast: false
+      matrix:
+        include:
+          - version: "4.5.15"
+            series: "4.5"
+          - version: "5.2.3"
+            series: "5.2"
+    steps:
+      - uses: actions/checkout@3d3c42e5aac5ba805825da76410c181273ba90b1 # v7.0.1
+        with:
+          persist-credentials: false
+
+      - uses: astral-sh/setup-uv@68559e99cc807c1eb7e9238fd43a15bba460eec2 # v10.3.3
+
+      - name: Install system libraries
+        run: |
+          sudo apt-get update
+          # shellcheck disable=SC2086
+          sudo apt-get install -y --no-install-recommends $BLENDER_DEPS
+
+      # Only the tarball is cached. fetch_blender.py re-checks its sha256 on
+      # every use, so a poisoned cache entry is rejected.
+      - name: Cache Blender tarball
+        uses: actions/cache@55cc8345863c7cc4c66a329aec7e433d2d1c52a9 # v6.1.0
+        with:
+          path: ~/.cache/meshwire/*.tar.xz
+          key: blender-${{ matrix.version }}-${{ hashFiles('scripts/fetch_blender.py') }}
+
+      - name: Install test dependencies
+        run: uv sync --locked --extra dev --python 3.12
+
+      - name: Fetch Blender
+        id: fetch
+        run: |
+          set -e
+          bin="$(uv run --locked --python 3.12 python scripts/fetch_blender.py ${{ matrix.version }} --dest "$RUNNER_TEMP/blender")"
+          test -x "$bin"
+          echo "bin=$bin" >> "$GITHUB_OUTPUT"
+
+      - name: Run harness driver
+        env:
+          BLENDER_BIN: ${{ steps.fetch.outputs.bin }}
+        run: >-
+          xvfb-run -a uv run --locked --python 3.12 python -m tests.harness.driver
+          --blender "$BLENDER_BIN"
+          --out "$RUNNER_TEMP/runs/driver-${{ matrix.series }}"
+          --check-baseline tests/harness/baselines/blender-${{ matrix.series }}.json
+
+      # Runs even when the driver step failed so one failure does not hide the
+      # other. The failed driver step still fails the job.
+      - name: Run socket lane
+        if: ${{ !cancelled() && steps.fetch.outcome == 'success' }}
+        env:
+          BLENDER_BIN: ${{ steps.fetch.outputs.bin }}
+        run: >-
+          xvfb-run -a uv run --locked --python 3.12 python -m tests.harness.socket_lane
+          --blender "$BLENDER_BIN"
+          --out "$RUNNER_TEMP/runs/socket-${{ matrix.series }}"
+          --check-baseline tests/harness/baselines/socket-lane.json
+
+      - name: Upload results
+        if: always()
+        uses: actions/upload-artifact@cf430e030ddbb5b0abf93d22962f4752f3646cd9 # v7.0.2
+        with:
+          name: harness-${{ matrix.version }}
+          path: |
+            ${{ runner.temp }}/runs
+            !${{ runner.temp }}/runs/**/*.blend
+            !${{ runner.temp }}/runs/**/*.blend1
+            !${{ runner.temp }}/runs/**/tmp/**
+          if-no-files-found: ignore
+          retention-days: 14
+
+  # Best effort: 4.2 segfaults at random inside Blender in two cases. Its
+  # result never gates anything and nothing may depend on this job.
+  nightly-4-2:
+    name: Blender 4.2.23 (best effort)
+    if: ${{ github.event_name == 'schedule' || github.event_name == 'workflow_dispatch' }}
+    runs-on: ubuntu-24.04
+    timeout-minutes: 60
+    continue-on-error: true
+    steps:
+      - uses: actions/checkout@3d3c42e5aac5ba805825da76410c181273ba90b1 # v7.0.1
+        with:
+          persist-credentials: false
+
+      - uses: astral-sh/setup-uv@68559e99cc807c1eb7e9238fd43a15bba460eec2 # v10.3.3
+
+      - name: Install system libraries
+        run: |
+          sudo apt-get update
+          # shellcheck disable=SC2086
+          sudo apt-get install -y --no-install-recommends $BLENDER_DEPS
+
+      - name: Cache Blender tarball
+        uses: actions/cache@55cc8345863c7cc4c66a329aec7e433d2d1c52a9 # v6.1.0
+        with:
+          path: ~/.cache/meshwire/*.tar.xz
+          key: blender-4.2.23-${{ hashFiles('scripts/fetch_blender.py') }}
+
+      - name: Install test dependencies
+        run: uv sync --locked --extra dev --python 3.12
+
+      - name: Fetch Blender
+        id: fetch
+        run: |
+          set -e
+          bin="$(uv run --locked --python 3.12 python scripts/fetch_blender.py 4.2.23 --dest "$RUNNER_TEMP/blender")"
+          test -x "$bin"
+          echo "bin=$bin" >> "$GITHUB_OUTPUT"
+
+      - name: Run harness driver
+        env:
+          BLENDER_BIN: ${{ steps.fetch.outputs.bin }}
+        run: >-
+          xvfb-run -a uv run --locked --python 3.12 python -m tests.harness.driver
+          --blender "$BLENDER_BIN"
+          --out "$RUNNER_TEMP/runs/driver-4.2"
+          --check-baseline tests/harness/baselines/blender-4.2.json
+
+      - name: Upload results
+        if: always()
+        uses: actions/upload-artifact@cf430e030ddbb5b0abf93d22962f4752f3646cd9 # v7.0.2
+        with:
+          name: harness-4.2.23
+          path: |
+            ${{ runner.temp }}/runs
+            !${{ runner.temp }}/runs/**/*.blend
+            !${{ runner.temp }}/runs/**/*.blend1
+            !${{ runner.temp }}/runs/**/tmp/**
+          if-no-files-found: ignore
+          retention-days: 14

meshwire-0.5.0a1/.github/workflows/ci.yml

@@ -0,0 +1,71 @@
+name: CI
+
+on:
+  push:
+    branches: [main]
+  pull_request:
+    branches: [main]
+
+permissions:
+  contents: read
+
+concurrency:
+  group: ci-${{ github.event_name }}-${{ github.event_name == 'pull_request' && github.ref || github.run_id }}
+  cancel-in-progress: ${{ github.event_name == 'pull_request' }}
+
+jobs:
+  lint:
+    runs-on: ubuntu-latest
+    steps:
+      - uses: actions/checkout@3d3c42e5aac5ba805825da76410c181273ba90b1 # v7.0.1
+        with:
+          persist-credentials: false
+
+      - uses: astral-sh/setup-uv@68559e99cc807c1eb7e9238fd43a15bba460eec2 # v10.3.3
+
+      - name: Run Ruff
+        run: uv run --locked --extra dev --python 3.11 ruff check .
+
+  test:
+    runs-on: ubuntu-latest
+    strategy:
+      matrix:
+        python-version: ["3.10", "3.11", "3.12"]
+
+    steps:
+      - uses: actions/checkout@3d3c42e5aac5ba805825da76410c181273ba90b1 # v7.0.1
+        with:
+          persist-credentials: false
+
+      - uses: astral-sh/setup-uv@68559e99cc807c1eb7e9238fd43a15bba460eec2 # v10.3.3
+
+      - name: Install dependencies
+        run: uv sync --locked --extra dev --python ${{ matrix.python-version }}
+
+      - name: Run unit tests
+        run: uv run --locked --extra dev --python ${{ matrix.python-version }} pytest tests/ --ignore=tests/blender_integration_test.py -v
+
+  build:
+    runs-on: ubuntu-latest
+    needs: [lint, test]
+    steps:
+      - uses: actions/checkout@3d3c42e5aac5ba805825da76410c181273ba90b1 # v7.0.1
+        with:
+          persist-credentials: false
+
+      - uses: astral-sh/setup-uv@68559e99cc807c1eb7e9238fd43a15bba460eec2 # v10.3.3
+
+      - name: Build package
+        run: uv build --build-constraint build-constraints.txt --require-hashes
+
+      - name: Build addon ZIP
+        run: uv run --locked --python 3.11 python scripts/package_addon.py
+
+      - name: Upload artifacts
+        uses: actions/upload-artifact@cf430e030ddbb5b0abf93d22962f4752f3646cd9 # v7.0.2
+        with:
+          name: dist
+          path: |
+            dist/*.whl
+            dist/*.tar.gz
+            dist/*.zip

meshwire-0.5.0a1/.github/workflows/codeql.yml

@@ -0,0 +1,33 @@
+name: CodeQL
+
+on:
+  push:
+    branches: [main]
+  pull_request:
+    branches: [main]
+  schedule:
+    - cron: "31 5 * * 1"
+
+permissions:
+  contents: read
+
+jobs:
+  analyze:
+    runs-on: ubuntu-latest
+    timeout-minutes: 30
+    permissions:
+      contents: read
+      security-events: write
+    steps:
+      - uses: actions/checkout@3d3c42e5aac5ba805825da76410c181273ba90b1 # v7.0.1
+        with:
+          persist-credentials: false
+
+      - uses: github/codeql-action/init@9b3254085494b55a0f7c4c2b3d2d52cc712ce370 # v4.39.1
+        with:
+          languages: python
+          build-mode: none
+
+      - uses: github/codeql-action/analyze@9b3254085494b55a0f7c4c2b3d2d52cc712ce370 # v4.39.1
+        with:
+          category: "/language:python"

meshwire-0.5.0a1/.github/workflows/release.yml

@@ -0,0 +1,119 @@
+name: Release
+
+on:
+  push:
+    tags:
+      - "v*"
+
+permissions:
+  contents: read
+
+jobs:
+  build:
+    runs-on: ubuntu-24.04
+    timeout-minutes: 15
+    steps:
+      - uses: actions/checkout@3d3c42e5aac5ba805825da76410c181273ba90b1 # v7.0.1
+        with:
+          fetch-depth: 0
+          persist-credentials: false
+
+      - uses: astral-sh/setup-uv@68559e99cc807c1eb7e9238fd43a15bba460eec2 # v10.3.3
+        with:
+          version: "0.13.6"
+
+      # PyPI never lets a version be reused, so catch mistakes here. This check and the version
+      # check below are not a security boundary, because a tagged commit can edit this file. The
+      # repository's tag ruleset and the pypi environment's tag policy restrict publishing.
+      - name: Refuse a tag that is not on main
+        run: git merge-base --is-ancestor "$GITHUB_SHA" origin/main
+
+      # No unlocked code runs from here to the upload: uv.lock pins dependencies with hashes,
+      # build-constraints.txt does the same for the build backend, and --no-build rules out any
+      # dependency's own build step. Keep it that way, because this job produces what gets published.
+      - name: Install locked dependencies
+        run: uv sync --locked --no-install-project --no-build --extra dev --python 3.12
+
+      - name: Run tests
+        env:
+          PYTHONPATH: src
+        run: .venv/bin/python -m pytest tests/ --ignore=tests/blender_integration_test.py -q
+
+      - name: Build package
+        run: uv build --build-constraint build-constraints.txt --require-hashes
+
+      - name: Refuse a tag that does not match the package version
+        run: test -f "dist/meshwire-${GITHUB_REF_NAME#v}-py3-none-any.whl"
+
+      - name: Run the built wheel
+        run: |
+          uv pip install --no-deps "dist/meshwire-${GITHUB_REF_NAME#v}-py3-none-any.whl"
+          actual="$(.venv/bin/meshwire --version)"
+          test "$actual" = "meshwire ${GITHUB_REF_NAME#v}"
+
+      # Built outside dist/: the PyPI action uploads everything in that folder.
+      - name: Build addon ZIP
+        run: |
+          mkdir addon-zip
+          .venv/bin/python scripts/package_addon.py
+          mv dist/*.zip addon-zip/
+
+      - name: Upload package
+        uses: actions/upload-artifact@cf430e030ddbb5b0abf93d22962f4752f3646cd9 # v7.0.2
+        with:
+          name: dist
+          path: dist/
+          if-no-files-found: error
+
+      - name: Upload addon ZIP
+        uses: actions/upload-artifact@cf430e030ddbb5b0abf93d22962f4752f3646cd9 # v7.0.2
+        with:
+          name: addon-zip
+          path: addon-zip/
+          if-no-files-found: error
+
+  publish:
+    needs: build
+    runs-on: ubuntu-24.04
+    timeout-minutes: 15
+    environment:
+      name: pypi
+      url: https://pypi.org/p/meshwire
+    permissions:
+      id-token: write
+    steps:
+      - uses: actions/download-artifact@9000827ccba6bdab643e8b6fd33ac0654aef8333 # v8.0.2
+        with:
+          name: dist
+          path: dist
+
+      - name: Publish to PyPI
+        uses: pypa/gh-action-pypi-publish@7245906fb61fa33a13554f9d5fb856fe61758086 # v1.14.3
+
+  github-release:
+    needs: publish
+    runs-on: ubuntu-24.04
+    timeout-minutes: 15
+    permissions:
+      contents: write
+    steps:
+      - uses: actions/download-artifact@9000827ccba6bdab643e8b6fd33ac0654aef8333 # v8.0.2
+        with:
+          name: dist
+          path: dist
+
+      - uses: actions/download-artifact@9000827ccba6bdab643e8b6fd33ac0654aef8333 # v8.0.2
+        with:
+          name: addon-zip
+          path: addon-zip
+
+      - name: Create the GitHub release
+        env:
+          GH_TOKEN: ${{ github.token }}
+          GH_REPO: ${{ github.repository }}
+        run: |
+          flags=""
+          case "$GITHUB_REF_NAME" in
+            *a*|*b*|*rc*) flags="--prerelease" ;;
+          esac
+          gh release create "$GITHUB_REF_NAME" --verify-tag --generate-notes $flags dist/* addon-zip/*

meshwire-0.5.0a1/.gitignore

@@ -0,0 +1,99 @@
+# Python
+__pycache__/
+*.py[cod]
+*$py.class
+*.so
+.Python
+build/
+develop-eggs/
+dist/
+downloads/
+eggs/
+.eggs/
+lib/
+lib64/
+parts/
+sdist/
+var/
+wheels/
+*.egg-info/
+.installed.cfg
+*.egg
+*.whl
+
+# Virtual environments
+.venv/
+venv/
+ENV/
+env/
+
+# IDE
+.idea/
+.vscode/
+*.swp
+*.swo
+*~
+
+# Testing
+.pytest_cache/
+.coverage
+htmlcov/
+.tox/
+.nox/
+
+# OS
+.DS_Store
+Thumbs.db
+Desktop.ini
+._*
+
+# Blender
+*.blend1
+*.blend2
+
+# Assets: keep only banner.svg for README, ignore everything else
+# (renders, screenshots, reference images, 3D models, blend files)
+assets/*.png
+assets/*.jpg
+assets/*.jpeg
+assets/*.glb
+assets/*.gltf
+assets/*.fbx
+assets/*.obj
+assets/*.stl
+assets/*.usd
+assets/*.blend
+assets/*.py
+assets/generated/
+
+# Exports
+exports/
+
+# Build artifacts
+*.zip
+*.tar.gz
+
+# Generated tool files (used during development)
+new_tools/
+
+# Environment and secrets
+.env
+.env.*
+*.key
+*.pem
+credentials.*
+
+# Logs
+*.log
+
+# Claude/MCP local config
+.claude/
+tasks/
+runs/
+
+# CAD/design files
+*.kicad_pcb
+*.brd
+*.step
+*.stp
+.ip-denylist