Skip to content

feat(ci): require discovery tags on publishable workers#544

Merged
rohitg00 merged 1 commit into
mainfrom
feat/require-discovery-tags
Jul 20, 2026
Merged

feat(ci): require discovery tags on publishable workers#544
rohitg00 merged 1 commit into
mainfrom
feat/require-discovery-tags

Conversation

@rohitg00

Copy link
Copy Markdown
Contributor

Summary

pr-checks (.github/scripts/validate_worker.py) previously only validated the
shape of a worker's tags: list when present, so a publishable worker could
ship with no tags: at all and still pass CI — leaving it undiscoverable in the
registry (tags back registry search/collections, added in #512).

This makes a non-empty tags: list a hard requirement for publishable
workers, while keeping it optional for workers that opt out of publishing.

  • Validator: for a publishable worker, a missing or empty tags: list is now
    a hard() error with an actionable message pointing at the SOP. Shape checks
    (list of strings) still apply to every worker.
  • Publishable predicate: verified against the publish pipeline. release.yml
    gates the _publish-registry.yml call on interface_smoke != 'false', derived
    from m.raw.get("interface_smoke") is False. So a worker is publishable unless
    iii.worker.yaml sets interface_smoke: false (exact boolean). The gate uses
    the same predicate: m.raw.get("interface_smoke") is not False. The only two
    workers without tags today (acp, lsp) both set interface_smoke: false, so
    the current tree stays valid.
  • Tests: added cases for publishable-missing-tags (fail), empty-tags (fail),
    valid-tags (pass), and interface_smoke: false opt-out with no tags (pass);
    existing shape-failure cases still fail.
  • Docs: new "Discovery tags (required)" step in docs/sops/new-worker.md and
    a note in the README CI section.

Test plan

  • pytest .github/scripts/tests/ -> 121 passed
  • CI pr-checks green on the changed scripts

Note

The pr-linear-check workflow may fail because this PR title/branch has no Linear
ticket id (e.g. MOT-XXXX). I did not fabricate one — please add your own ticket
reference to the title/branch if required.

pr-checks now fails a publishable worker whose iii.worker.yaml has a
missing or empty tags: list, since the registry indexes workers by tags
for search and collections. Workers that opt out of publishing with
interface_smoke: false (acp, iii-lsp) keep tags optional. Existing shape
checks (list of strings) still apply to every worker.

Adds validator tests for the new gate and documents the requirement in
docs/sops/new-worker.md and the README CI section.
@vercel

vercel Bot commented Jul 20, 2026

Copy link
Copy Markdown

The latest updates on your projects. Learn more about Vercel for GitHub.

Project Deployment Actions Updated (UTC)
workers Ready Ready Preview, Comment Jul 20, 2026 3:51pm
workers-tech-spec Ready Ready Preview, Comment Jul 20, 2026 3:51pm

Request Review

@coderabbitai

coderabbitai Bot commented Jul 20, 2026

Copy link
Copy Markdown

Warning

Review limit reached

@rohitg00, you've reached your PR review limit, so we couldn't start this review.

Next review available in: 17 minutes

Enable usage-based reviews in Billing to review now. Otherwise, wait until the next included review is available.
You're only billed for reviews past your plan's rate limits ($0.25/file).

How can I continue?

After more reviews become available, a review can be triggered using the @coderabbitai review command as a PR comment. Alternatively, push new commits to this PR.

To avoid repeated limits, reduce automatic review volume by pausing incremental auto-reviews earlier, using label-based review opt-in, excluding WIP or generated PR titles, or requesting reviews manually when the PR is ready. If your team needs uninterrupted high-volume reviews, an organization admin can enable usage-based reviews.

How do review limits work?

CodeRabbit enforces per-developer PR review limits for each organization. Most developers receive the normal plan review availability.

For paid Pro and Pro+ PR reviews, CodeRabbit uses adaptive limits for sustained high-volume activity. When a developer's recent PR review activity reaches the 95th percentile or higher among CodeRabbit users, additional reviews become available more gradually as earlier reviews age out of the rolling window.

Please refer docs for additional details.

Review details
⚙️ Run configuration

Configuration used: Organization UI

Review profile: CHILL

Plan: Pro

Run ID: 48ef150a-09d8-42f6-907e-d6d9b321249a

📥 Commits

Reviewing files that changed from the base of the PR and between 371b163 and 7118a9b.

📒 Files selected for processing (4)
  • .github/scripts/tests/test_validate_worker.py
  • .github/scripts/validate_worker.py
  • README.md
  • docs/sops/new-worker.md
✨ Finishing Touches
🧪 Generate unit tests (beta)
  • Create PR with unit tests
  • Commit unit tests in branch feat/require-discovery-tags

Thanks for using CodeRabbit! It's free for OSS, and your support helps us grow. If you like it, consider giving us a shout-out.

❤️ Share

Comment @coderabbitai help to get the list of available commands.

@github-actions

Copy link
Copy Markdown
Contributor

skill-check — worker

0 verified, 46 skipped (no docs/).

Layer Result
structure
vale
ai
render

Four for four. Nicely done.

@rohitg00
rohitg00 merged commit 43a82e0 into main Jul 20, 2026
13 of 14 checks passed
@rohitg00
rohitg00 deleted the feat/require-discovery-tags branch July 20, 2026 15:56
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant