From 4b202d049a36d5445f9b2a6a69cd17705deaeb23 Mon Sep 17 00:00:00 2001
From: caballeto <elminsteraumar4@gmail.com>
Date: Fri, 1 May 2026 15:33:26 +0200
Subject: [PATCH] ci(spec-check): sparse-checkout @devhelm/openapi-tools from
 mono

The shared Springdoc preprocessor used by typegen.sh is an internal-only
package that is intentionally not published to npm. The previous fallback
to `npx --package=@devhelm/openapi-tools` 404'd on every spec-check run
once the repository_dispatch fan-out started actually firing.

Sparse-checkout packages/openapi-tools from mono with the existing
MONOREPO_DISPATCH_TOKEN, build it in-place, and export OPENAPI_TOOLS so
typegen.sh picks the explicit-override path instead of the npm fallback.

No new secrets, no public npm publish.
---
 .github/workflows/spec-check.yml | 26 ++++++++++++++++++++++++++
 1 file changed, 26 insertions(+)

diff --git a/.github/workflows/spec-check.yml b/.github/workflows/spec-check.yml
index f48cae7..bf4ff69 100644
--- a/.github/workflows/spec-check.yml
+++ b/.github/workflows/spec-check.yml
@@ -20,6 +20,9 @@ jobs:
       - uses: actions/setup-python@v5
         with:
           python-version: '3.13'
+      - uses: actions/setup-node@v4
+        with:
+          node-version: '20'
 
       - name: Download latest OpenAPI spec from monorepo
         run: |
@@ -29,10 +32,33 @@ jobs:
         env:
           GH_TOKEN: ${{ secrets.MONOREPO_DISPATCH_TOKEN }}
 
+      # Sparse-checkout the shared OpenAPI preprocessor from mono.
+      # typegen.sh prefers $OPENAPI_TOOLS → local sibling → npx; without this
+      # step, CI falls through to `npx @devhelm/openapi-tools` which is
+      # intentionally unpublished (internal-only package).
+      - name: Checkout @devhelm/openapi-tools from mono
+        uses: actions/checkout@v4
+        with:
+          repository: devhelmhq/mono
+          token: ${{ secrets.MONOREPO_DISPATCH_TOKEN }}
+          path: .mono
+          sparse-checkout: packages/openapi-tools
+          sparse-checkout-cone-mode: false
+
+      - name: Build @devhelm/openapi-tools
+        working-directory: .mono/packages/openapi-tools
+        # mono uses pnpm workspaces; we only need this one package's deps here,
+        # so install standalone with npm (no lockfile in this subdir).
+        run: |
+          npm install --no-package-lock --no-audit --no-fund
+          npm run build
+
       - run: uv sync
       - run: uv run pytest -v
 
       - name: Regenerate types from spec
+        env:
+          OPENAPI_TOOLS: node ${{ github.workspace }}/.mono/packages/openapi-tools/dist/cli.js
         run: ./scripts/typegen.sh
 
       - name: Check for type changes