deploy-docs.yml path filter is docs-only — marketplace/scaffold changes don't auto-trigger gateway rebuild

[asachs01]

Problem

deploy-docs.yml push trigger is docs-only:

on:
  push:
    branches: [main]
    paths:
      - 'msp-claude-plugins/docs/**'
      - '.github/workflows/deploy-docs.yml'

This is correct for the docs deploy itself, but the same workflow also carries the notify-gateway job that fires the docs-updated repository_dispatch to wyre-technology/mcp-gateway. The gateway's ci.yml consumes that dispatch to rebuild the gateway image with current marketplace.json baked in.

Consequence: marketplace.json + plugin scaffold changes do NOT auto-trigger a gateway rebuild. Only changes under msp-claude-plugins/docs/** (or the deploy-docs workflow file itself) trigger it.

Observed

PR #120 (Stripe + Slack scaffolds + marketplace.json +2 entries) merged at 6584f89 — deploy-docs.yml did NOT fire. Latest Deploy Documentation run was 1ed5236 (page-fix PR #119, which DID touch docs/).

Workaround for #120 tonight: manual gh workflow run deploy-docs.yml — but this is a discipline gap, not a fix.

Fix shape

Extend the path filter on deploy-docs.yml's push trigger to include the marketplace.json and any plugin directory paths the gateway image depends on:

on:
  push:
    branches: [main]
    paths:
      - 'msp-claude-plugins/docs/**'
      - '.claude-plugin/marketplace.json'
      - 'msp-claude-plugins/**/.claude-plugin/plugin.json'
      - 'msp-claude-plugins/**/README.md'
      - '.github/workflows/deploy-docs.yml'

Better: split the notify-gateway job into its OWN workflow with a broader path filter (since the docs deploy and the gateway-rebuild trigger are logically separate concerns).

Context

• Discovered during 2026-06-13 ~03:00 UTC Aaron-pivot Stripe + Slack vendor wiring (mcp-gateway PRs #236 + #237 + #245 + msp-claude-plugins PR feat(marketplace): minimal scaffolds for Stripe + Slack hosted MCP vendors #120).
• Banked by forge + boss as a deploy-docs-path-filter gotcha.

Priority

Medium — workaround exists (manual workflow_dispatch + cleaner: dev's push-to-gateway-main auto-triggers ci.yml which clones msp at build time). But the gap is a footgun for future vendor adds; should be closed before the next vendor-scaffold cycle.