Skip to content

Add community bundle submission automation#3553

Merged
BenBtg merged 5 commits into
mainfrom
benbtg-feat-3161-community-bundle-automation
Jul 21, 2026
Merged

Add community bundle submission automation#3553
BenBtg merged 5 commits into
mainfrom
benbtg-feat-3161-community-bundle-automation

Conversation

@BenBtg

@BenBtg BenBtg commented Jul 15, 2026

Copy link
Copy Markdown
Contributor

Description

Bundles have a submission template and publishing guidance, but accepted submissions still lack a maintained catalog and automated review path. This adds the maintainer-owned automation needed to validate bundle submissions and prepare draft catalog PRs.

The new agentic workflow validates metadata, manifests, release assets, component resolution evidence, and trust boundaries before updating the catalog and documentation. Its safe-output policy restricts PR changes to those two files. The CLI fetches the repository community catalog online and uses a wheel-packaged snapshot offline; the source remains discovery-only, so companion catalogs are never registered automatically.

Fixes: #3161

Testing

  • Tested locally with uv run specify --help
  • Ran existing tests with uv sync && uv run pytest
  • Tested with a sample project (if applicable)

Validated with the complete bundler contract, unit, integration, and workflow test selection. Compiled the agentic workflow with schema validation and actionlint, and verified the wheel contains the packaged community catalog snapshot.

AI Disclosure

  • I did not use AI assistance for this contribution
  • I did use AI assistance (describe below)

Implemented autonomously by GitHub Copilot (GPT-5.6 Sol) on behalf of @BenBtg, including implementation, tests, workflow compilation, review, and commit creation.

Add the discovery-only community bundle catalog, online and offline catalog loading, and a restricted agentic workflow for validating bundle submissions and opening draft catalog PRs.

Assisted-by: GitHub Copilot (model: GPT-5.6 Sol, autonomous)

Co-authored-by: Copilot App <223556219+Copilot@users.noreply.github.com>

Copilot-Session: fbe794bc-667a-4c9e-b48b-825067debc6d
Copilot AI review requested due to automatic review settings July 15, 2026 19:04

Copilot AI left a comment

Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Pull request overview

Adds automated community bundle submission review, catalog maintenance, and online/offline CLI discovery.

Changes:

  • Adds the community bundle catalog and packaged offline snapshot.
  • Adds and compiles submission-validation automation.
  • Documents discovery policy and adds contract, integration, and workflow tests.
Show a summary per file
File Description
bundles/catalog.community.json Initializes the community catalog.
docs/community/bundles.md Documents catalog discovery.
pyproject.toml Packages the offline snapshot.
src/specify_cli/bundler/services/adapters.py Fetches online or packaged catalogs.
.github/workflows/add-community-bundle.md Defines submission automation.
.github/workflows/add-community-bundle.lock.yml Compiles the agentic workflow.
.github/workflows/catalog-assign.yml Routes bundle submissions.
.github/aw/actions-lock.json Pins workflow dependencies.
tests/contract/test_catalog_schema.py Tests catalog and packaging contracts.
tests/integration/test_bundler_offline.py Tests offline discovery.
tests/unit/test_bundler_adapters.py Tests catalog fetch selection.
tests/test_github_workflows.py Verifies workflow wiring.

Review details

Tip

Add Copilot custom instructions for smarter, more guided reviews. Learn how to get started.

  • Files reviewed: 11/12 changed files
  • Comments generated: 4
  • Review effort level: Medium

Comment thread src/specify_cli/bundler/services/adapters.py
Comment thread .github/workflows/add-community-bundle.md Outdated
Comment thread docs/community/bundles.md Outdated
Comment thread .github/workflows/add-community-bundle.md Outdated
Ensure explicit install-allowed catalogs take precedence over built-in discovery, tighten component installability validation, and use issue-linked community branches.

Assisted-by: GitHub Copilot (model: GPT-5.6 Sol, autonomous)

Co-authored-by: Copilot App <223556219+Copilot@users.noreply.github.com>

Copilot-Session: fbe794bc-667a-4c9e-b48b-825067debc6d
Copilot AI review requested due to automatic review settings July 20, 2026 17:23

Copilot AI left a comment

Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Review details

  • Files reviewed: 13/14 changed files
  • Comments generated: 2
  • Review effort level: Medium

Comment thread tests/integration/test_bundler_offline.py Outdated
Comment thread .github/workflows/add-community-bundle.md
Make offline catalog coverage content-agnostic and require autonomous catalog commits to include the assisted-by trailer.

Assisted-by: GitHub Copilot (model: GPT-5.6 Sol, autonomous)

Co-authored-by: Copilot App <223556219+Copilot@users.noreply.github.com>

Copilot-Session: fbe794bc-667a-4c9e-b48b-825067debc6d
Copilot AI review requested due to automatic review settings July 20, 2026 17:29

Copilot AI left a comment

Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Review details

  • Files reviewed: 13/14 changed files
  • Comments generated: 2
  • Review effort level: Medium

Comment thread .github/workflows/add-community-bundle.md
Comment thread .github/workflows/add-community-bundle.md
Require single-line escaped Markdown table values for untrusted submission metadata. The needs-info label used by validation is now present in the repository.

Assisted-by: GitHub Copilot (model: GPT-5.6 Sol, autonomous)

Co-authored-by: Copilot App <223556219+Copilot@users.noreply.github.com>

Copilot-Session: fbe794bc-667a-4c9e-b48b-825067debc6d
Copilot AI review requested due to automatic review settings July 20, 2026 17:35

Copilot AI left a comment

Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Review details

  • Files reviewed: 13/14 changed files
  • Comments generated: 0 new
  • Review effort level: Medium

@BenBtg
BenBtg marked this pull request as ready for review July 20, 2026 22:59
@BenBtg
BenBtg requested a review from mnriem as a code owner July 20, 2026 22:59
@BenBtg
BenBtg requested a review from Copilot July 20, 2026 22:59

Copilot AI left a comment

Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Review details

  • Files reviewed: 13/14 changed files
  • Comments generated: 1
  • Review effort level: Medium

Comment thread .github/workflows/add-community-bundle.md Outdated
Allow the submission workflow to remove prior outcome labels before applying the current validation state.

Assisted-by: GitHub Copilot (model: GPT-5.6 Sol, autonomous)

Co-authored-by: Copilot App <223556219+Copilot@users.noreply.github.com>

Copilot-Session: fbe794bc-667a-4c9e-b48b-825067debc6d
Copilot AI review requested due to automatic review settings July 20, 2026 23:06

Copilot AI left a comment

Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Review details

  • Files reviewed: 13/14 changed files
  • Comments generated: 0 new
  • Review effort level: Medium

@BenBtg
BenBtg merged commit 5760061 into main Jul 21, 2026
14 checks passed
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.

[Feature]: Add community bundle submissions

3 participants