devhelm-mcp-server 0.1.0__tar.gz → 0.2.0__tar.gz

devhelm_mcp_server-0.2.0/.github/workflows/spec-check.yml

@@ -0,0 +1,108 @@
+name: Spec Check
+
+# Triggered by ``spec_updated`` repository_dispatch from devhelmhq/mono whenever
+# the canonical OpenAPI spec changes.
+#
+# Unlike sibling surfaces (cli, sdk-js, sdk-python, terraform-provider) the MCP
+# server does NOT consume the spec directly — every API call is delegated to the
+# vendored ``devhelm`` Python SDK. The server only ships a copy of the spec for
+# documentation/reference purposes.
+#
+# What this workflow checks:
+#   1. The freshest spec from the monorepo is committed (so the documentation
+#      copy doesn't go stale relative to other surfaces).
+#   2. The latest published ``devhelm`` SDK still satisfies our resolver
+#      (we pull it via ``uv lock --upgrade-package devhelm``).
+#   3. Tests pass against the upgraded SDK — this is the real contract check
+#      because the SDK regenerates its own typed surface against the spec.
+#   4. If the resolved SDK version or the bundled spec changed, open a PR so a
+#      human can ship the bump. If anything broke, file an issue.
+
+on:
+  repository_dispatch:
+    types: [spec_updated]
+
+permissions:
+  contents: write
+  issues: write
+  pull-requests: write
+
+jobs:
+  check-compatibility:
+    runs-on: ubuntu-latest
+    steps:
+      - uses: actions/checkout@v4
+      - uses: astral-sh/setup-uv@v4
+        with:
+          enable-cache: true
+      - uses: actions/setup-python@v5
+        with:
+          python-version: '3.13'
+
+      - name: Download latest OpenAPI spec from monorepo
+        run: |
+          mkdir -p docs/openapi
+          gh api repos/devhelmhq/mono/contents/docs/openapi/monitoring-api.json \
+            -H "Accept: application/vnd.github.raw+json" \
+            -o docs/openapi/monitoring-api.json
+        env:
+          GH_TOKEN: ${{ secrets.MONOREPO_DISPATCH_TOKEN }}
+
+      - name: Refresh devhelm SDK to latest
+        run: |
+          uv lock --upgrade-package devhelm
+          uv sync --locked
+
+      - name: Run tests against refreshed SDK
+        run: uv run pytest -v
+
+      - name: Lint and type-check
+        run: |
+          uv run ruff check src tests
+          uv run mypy src
+
+      - name: Check for changes
+        id: diff
+        run: |
+          if git diff --quiet docs/openapi/monitoring-api.json uv.lock; then
+            echo "changed=false" >> "$GITHUB_OUTPUT"
+          else
+            echo "changed=true" >> "$GITHUB_OUTPUT"
+          fi
+
+      - name: Open PR with refreshed spec + SDK
+        if: steps.diff.outputs.changed == 'true'
+        run: |
+          git config user.name "github-actions[bot]"
+          git config user.email "github-actions[bot]@users.noreply.github.com"
+          branch="chore/spec-sync-$(date +%Y%m%d%H%M%S)"
+          git checkout -b "$branch"
+          git add docs/openapi/monitoring-api.json uv.lock
+          git commit -m "chore: sync OpenAPI spec and refresh devhelm SDK"
+          git push -u origin "$branch"
+          gh pr create \
+            --title "chore: sync OpenAPI spec and refresh devhelm SDK" \
+            --body "Auto-generated after a spec_updated event from the monorepo.
+
+          - Re-downloaded \`docs/openapi/monitoring-api.json\` (reference copy)
+          - Bumped vendored \`devhelm\` SDK to latest published version
+          - Tests + lint + mypy passed against the new SDK" \
+            --base main
+        env:
+          GH_TOKEN: ${{ secrets.GITHUB_TOKEN }}
+
+      - name: Report failure
+        if: failure()
+        run: |
+          gh issue create \
+            --title "API spec change broke MCP server build" \
+            --body "The monorepo pushed a spec update that caused CI failures in the MCP server compatibility job.
+
+          Workflow run: ${{ github.server_url }}/${{ github.repository }}/actions/runs/${{ github.run_id }}
+
+          Likely causes:
+          - The latest \`devhelm\` SDK release is incompatible with how MCP tools call it
+          - Tool definitions reference an SDK method that was removed/renamed
+          - Test fixtures depend on a payload shape that changed in the spec"
+        env:
+          GH_TOKEN: ${{ secrets.GITHUB_TOKEN }}

{devhelm_mcp_server-0.1.0 → devhelm_mcp_server-0.2.0}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: devhelm-mcp-server
-Version: 0.1.0
+Version: 0.2.0
 Summary: DevHelm MCP server — AI agent access to monitors, incidents, alerting, and more
 Project-URL: Homepage, https://devhelm.io
 Project-URL: Repository, https://github.com/devhelmhq/mcp-server
@@ -18,7 +18,7 @@ Classifier: Programming Language :: Python :: 3.12
 Classifier: Programming Language :: Python :: 3.13
 Classifier: Topic :: Software Development :: Libraries
 Requires-Python: >=3.11
-Requires-Dist: devhelm>=0.1.0
+Requires-Dist: devhelm>=0.2.0
 Requires-Dist: fastmcp>=2.0.0
 Description-Content-Type: text/markdown