Skip to content

Add Sonatype Guide workflow for automated dependency updates - #1

Merged
sonatype-guide[bot] merged 1 commit into
mainfrom
agp/setup-workflow
Oct 7, 2026
Merged

sonatype-guide[bot] merged 1 commit into
mainfrom
agp/setup-workflow

Conversation

@sonatype-guide

@sonatype-guide sonatype-guide Bot commented Oct 7, 2026 •

Copy link
Copy Markdown

What does this PR do?

This PR adds the Sonatype Guide GitHub Actions workflow to enable automated dependency updates and security fixes.

Features

  • Manual trigger via GitHub Actions UI
  • Security mode for fixing specific vulnerabilities
  • Automated PR creation with recommended updates

Learn more: https://links.sonatype.com/products/guide/docs/agent-p


This PR was automatically created by the Sonatype Guide GitHub App.

Summary by Sourcery

Add the Sonatype Guide Agent P workflow to automate governed dependency updates and vulnerability fixes.

New Features:

  • Add a scheduled and manually triggered Sonatype Guide workflow for automated dependency updates and security remediation.
  • Support full, targeted security, healing, and failure-resolution run modes with automated pull request creation.

Enhancements:

  • Add a gated execution model that retrieves centrally governed configuration and skips AGP runs when execution is paused or unavailable.

CI:

  • Configure GitHub Actions permissions, concurrency, and OIDC authentication for Sonatype Guide runs.

@sonatype-guide
sonatype-guide Bot merged commit f299231 into main Oct 7, 2026
@sourcery-ai

sourcery-ai Bot commented Oct 7, 2026 •

Copy link
Copy Markdown

Reviewer's Guide

Introduces a Sonatype Guide Agent P GitHub Actions workflow that uses OIDC and centrally fetched configuration to gate and execute automated dependency updates, vulnerability fixes, and related remediation runs, creating or updating pull requests as needed.

Sequence diagram for the Sonatype Guide gated Agent P workflow

sequenceDiagram
    participant GitHub as GitHub Actions
    participant Gate as Sonatype Guide gate
    participant AGP as Sonatype Guide Agent P
    participant Repo as Repository

    GitHub->>Gate: gate@v1
    Gate->>Gate: OIDC authentication
    Gate->>Repo: Fetch governed agp.yml
    Gate-->>GitHub: directive
    alt directive == run
        GitHub->>Gate: gate@v1
        Gate->>Repo: Fetch governed agp.yml
        GitHub->>AGP: agp-action@v1 with mode, repo_id, vulnerabilities
        AGP->>Repo: Create or update dependency PR
    else directive != run
        GitHub-->>GitHub: Skip AGP job
    end
Loading

File-Level Changes

Change Details Files
Adds a centrally governed Sonatype Guide workflow with scheduled and manual execution paths.
  • Runs a lightweight OIDC-authenticated gate to fetch configuration and decide whether execution should proceed.
  • Runs the AGP action only when the gate returns a run directive, with a separate configuration fetch for the isolated job.
  • Supports manual, scheduled, and backend-dispatched modes including full, security, heal, and resolve-failure runs.
  • Forwards vulnerability targets, repository identifiers, verbosity, and an optional API URL to the action.
  • Grants contents, pull-request, and OIDC token permissions and serializes workflow runs via concurrency controls.
.github/workflows/agp-workflow.yml

Tips and commands

Interacting with Sourcery

  • Trigger a new review: Comment @sourcery-ai review on the pull request.
  • Continue discussions: Reply directly to Sourcery's review comments.
  • Generate a GitHub issue from a review comment: Ask Sourcery to create an
    issue from a review comment by replying to it. You can also reply to a
    review comment with @sourcery-ai issue to create an issue from it.
  • Generate a pull request title: Write @sourcery-ai anywhere in the pull
    request title to generate a title at any time. You can also comment
    @sourcery-ai title on the pull request to (re-)generate the title at any time.
  • Generate a pull request summary: Write @sourcery-ai summary anywhere in
    the pull request body to generate a PR summary at any time exactly where you
    want it. You can also comment @sourcery-ai summary on the pull request to
    (re-)generate the summary at any time.
  • Generate reviewer's guide: Comment @sourcery-ai guide on the pull
    request to (re-)generate the reviewer's guide at any time.
  • Resolve all Sourcery comments: Comment @sourcery-ai resolve on the
    pull request to resolve all Sourcery comments. Useful if you've already
    addressed all the comments and don't want to see them anymore.
  • Dismiss all Sourcery reviews: Comment @sourcery-ai dismiss on the pull
    request to dismiss all existing Sourcery reviews. Especially useful if you
    want to start fresh with a new review - don't forget to comment
    @sourcery-ai review to trigger a new review!

Customizing Your Experience

Access your dashboard to:

  • Enable or disable review features such as the Sourcery-generated pull request
    summary, the reviewer's guide, and others.
  • Change the review language.
  • Add, remove or edit custom review instructions.
  • Adjust other review settings.

Getting Help

@sourcery-ai sourcery-ai Bot left a comment

Copy link
Copy Markdown

Choose a reason for hiding this comment

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

Hey - I've reviewed your changes and they look great!

Sourcery assessment

Needs a human reviewer. The workflow grants a third-party action OIDC access plus write permissions to repository contents and pull requests, allowing an incorrect or compromised action to authenticate externally and commit or open/update dependency changes. Reverting the workflow stops future runs but does not remove commits, pull requests, or any downstream effects already created.


Sourcery is free for open source - if you like our reviews please consider sharing them ✨

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Projects

None yet

Development

Successfully merging this pull request may close these issues.

0 participants