summaryrefslogtreecommitdiff
path: root/.github/workflows/validate-plugins.yml
blob: cf4071c198b0cd6e3789c47d0e68203b526b71c6 (plain)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
name: Validate Plugins

on:
  pull_request:
    paths:
      - '.claude-plugin/**'
      - '*/.claude-plugin/**'
      - '*/agents/**'
      - '*/skills/**'
      - '*/commands/**'
      # Vendored plugins live TWO levels deep (plugins/<name>/, external_plugins/<name>/),
      # and `*` doesn't cross a `/` — so the one-level patterns above never match them.
      # Without these, a PR touching only e.g. plugins/<name>/.claude-plugin/plugin.json
      # (a manifest version bump) fires nothing and the required `validate` check sits
      # "Expected — Waiting for status to be reported" forever (PR #5416 hit this; same
      # per-level spell-out as the README/assets entries below).
      - 'plugins/*/.claude-plugin/**'
      - 'plugins/*/agents/**'
      - 'plugins/*/skills/**'
      - 'plugins/*/commands/**'
      - 'external_plugins/*/.claude-plugin/**'
      - 'external_plugins/*/agents/**'
      - 'external_plugins/*/skills/**'
      - 'external_plugins/*/commands/**'
      # `validate` is a required status check, so a PR that touches ONLY workflow
      # files (e.g. an action-SHA re-pin) would otherwise never trigger validate
      # and sit "Expected — Waiting for status to be reported" forever (workflow_dispatch
      # check runs aren't associated with the PR, so they don't satisfy it). Run
      # validate on workflow changes too so those PRs can clear the gate in-context.
      - '.github/workflows/**'
      # Same rationale for the scan policy prompt: a policy-only PR (.github/policy/**)
      # touches none of the plugin paths above, so validate would never trigger via
      # pull_request and the required check would sit "Expected" forever (a dispatch
      # check run isn't associated with the PR, so it can't satisfy the gate either).
      - '.github/policy/**'
      # Same again for the bump-tracking ledger: a PR that only edits
      # .github/bump-tracking.json (e.g. enrolling slugs in releases-only
      # tracking) matches nothing above, so the required check sits
      # "Expected" forever and even a dispatched validate run on the PR
      # head can't satisfy the gate (it only counts pull_request suites).
      - '.github/bump-tracking.json'
      # And once more for a plugin's own docs: a PR that only edits a README or
      # adds a screenshot matches nothing above, so the required check never
      # reports and the PR can't be merged. Spelled out per level because `*`
      # doesn't cross a `/` — plugins live at plugins/<name>/, so `*/README.md`
      # would not match one.
      - 'plugins/*/README.md'
      - 'plugins/*/assets/**'
      - 'external_plugins/*/README.md'
      - 'external_plugins/*/assets/**'
      # And for a vendored plugin's MCP server config / hooks: a PR that only edits
      # plugins/<name>/.mcp.json (e.g. repointing a partner's remote MCP URL, as
      # #4985 and its follow-up did for context7) or a hooks file matches nothing
      # above, so `validate` never reports and the PR sits "Expected" forever.
      - 'plugins/*/.mcp.json'
      - 'plugins/*/hooks/**'
      - 'external_plugins/*/.mcp.json'
      - 'external_plugins/*/hooks/**'
  push:
    branches: [main]
    paths:
      - '.claude-plugin/**'
  # `validate` is a required status check on main. Bump PRs are opened with
  # GITHUB_TOKEN, which doesn't fire on:pull_request (recursion guard), so the
  # path-filtered trigger above never reports on them and the PR would be
  # blocked forever. The bump workflow dispatches this against each per-entry
  # bump branch instead; the check run lands on the branch HEAD (= PR head)
  # and satisfies the required check. The validate job runs unconditionally,
  # so a dispatch always reports.
  workflow_dispatch:

permissions:
  contents: read

jobs:
  validate:
    runs-on: ubuntu-latest
    steps:
      - uses: actions/checkout@v4
        with:
          fetch-depth: 0

      - uses: anthropics/claude-plugins-community/.github/actions/validate-plugins@163301d1904c0a994539f5226ce0fcd65b8652bf
        with:
          marketplace-path: .claude-plugin/marketplace.json
          # Official curated marketplace: SHA-pin (I5) is a HARD error.
          # I8/I11 are warnings until the 15 known vendored-path/name issues
          # are cleaned up (see PR body); tighten to "I1 I3" after.
          warn-invariants: "I1 I3 I8 I11"
          # Plugins resolved by a local command instead of a git repo (no sha to
          # pin). Each name here is a listing decision: add one only with
          # marketplace-ops sign-off.
          command-exempt: "xcode"
          claude-cli-version: latest