Skip to content

docs: add downstream GitHub Actions audit recipes#797

Merged
EffortlessSteven merged 1 commit into
mainfrom
docs/downstream-ci-github-actions
May 18, 2026
Merged

docs: add downstream GitHub Actions audit recipes#797
EffortlessSteven merged 1 commit into
mainfrom
docs/downstream-ci-github-actions

Conversation

@EffortlessSteven

Copy link
Copy Markdown
Member

Summary

  • Adds a GitHub Actions how-to for installed CLI bundle audit workflows.
  • Shows webhook, TLS, and OIDC generate/verify/audit jobs using audit-bundle --ci.
  • Updates the generic downstream CI guide and docs index, and advances the downstream CI polish goal to the next slice.

Files added/changed

  • docs/how-to/use-uselesskey-in-github-actions.md
  • docs/how-to/use-uselesskey-in-downstream-ci.md
  • docs/README.md
  • .uselesskey/goals/active.toml

Validation

  • cargo xtask docs-sync --check
  • cargo xtask typos
  • git diff --check

Non-goals

  • No version bump, tag, publish, release prep, new badge, new contract pack, provider compatibility claim, production security claim, or repo-local proof requirement for installed users.

What this enables next

  • external-adoption-smoke --ci-recipes can make these documented CI snippets executable evidence instead of doc-only guidance.

@chatgpt-codex-connector

Copy link
Copy Markdown

You have reached your Codex usage limits for code reviews. You can see your limits in the Codex usage dashboard.
To continue using code reviews, add credits to your account and enable them for code reviews in your settings.

@coderabbitai

coderabbitai Bot commented May 18, 2026

Copy link
Copy Markdown

Warning

Rate limit exceeded

@EffortlessSteven has exceeded the limit for the number of commits that can be reviewed per hour. Please wait 20 minutes and 54 seconds before requesting another review.

You’ve run out of usage credits. Purchase more in the billing tab.

⌛ How to resolve this issue?

After the wait time has elapsed, a review can be triggered using the @coderabbitai review command as a PR comment. Alternatively, push new commits to this PR.

We recommend that you space out your commits to avoid hitting the rate limit.

🚦 How do rate limits work?

CodeRabbit enforces hourly rate limits for each developer per organization.

Our paid plans have higher rate limits than the trial, open-source and free plans. In all cases, we re-allow further reviews after a brief timeout.

Please see our FAQ for further information.

ℹ️ Review info
⚙️ Run configuration

Configuration used: Organization UI

Review profile: ASSERTIVE

Plan: Pro

Run ID: a8dab315-f5ac-48de-9ed6-5298ea84fa25

📥 Commits

Reviewing files that changed from the base of the PR and between 78db013 and b0ebd20.

📒 Files selected for processing (4)
  • .uselesskey/goals/active.toml
  • docs/README.md
  • docs/how-to/use-uselesskey-in-downstream-ci.md
  • docs/how-to/use-uselesskey-in-github-actions.md
✨ Finishing Touches
🧪 Generate unit tests (beta)
  • Create PR with unit tests
  • Commit unit tests in branch docs/downstream-ci-github-actions

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 and usage tips.

@gemini-code-assist gemini-code-assist 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.

Code Review

This pull request updates the project's active goals and expands the documentation with new guides for integrating uselesskey into downstream CI and GitHub Actions. The feedback highlights several critical issues in the provided GitHub Actions recipes, including the use of non-existent versions for actions/checkout, dtolnay/rust-toolchain, and actions/upload-artifact. Furthermore, a logical error was identified in the artifact upload configuration, which incorrectly attempts to access files produced in separate jobs.

Comment on lines +26 to +28
- uses: actions/checkout@v6

- uses: dtolnay/rust-toolchain@stable

Copy link
Copy Markdown

Choose a reason for hiding this comment

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

medium

The GitHub Action versions for actions/checkout and dtolnay/rust-toolchain appear to be incorrect. actions/checkout is currently at v4, and dtolnay/rust-toolchain typically uses @master or @v1. Using non-existent versions like v6 or @stable will cause the workflow to fail.

Suggested change
- uses: actions/checkout@v6
- uses: dtolnay/rust-toolchain@stable
- uses: actions/checkout@v4
- uses: dtolnay/rust-toolchain@master

Comment on lines +66 to +68
- uses: actions/checkout@v6

- uses: dtolnay/rust-toolchain@stable

Copy link
Copy Markdown

Choose a reason for hiding this comment

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

medium

The GitHub Action versions for actions/checkout and dtolnay/rust-toolchain appear to be incorrect. actions/checkout is currently at v4, and dtolnay/rust-toolchain typically uses @master. Using non-existent versions will cause the workflow to fail.

Suggested change
- uses: actions/checkout@v6
- uses: dtolnay/rust-toolchain@stable
- uses: actions/checkout@v4
- uses: dtolnay/rust-toolchain@master


```yaml
- name: Upload uselesskey audit receipts
uses: actions/upload-artifact@v7

Copy link
Copy Markdown

Choose a reason for hiding this comment

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

medium

actions/upload-artifact is currently at v4. Version v7 does not exist and will cause the workflow to fail.

Suggested change
uses: actions/upload-artifact@v7
uses: actions/upload-artifact@v4

Comment on lines +112 to +118
path: |
target/uselesskey-webhook-audit/bundle-audit.json
target/uselesskey-webhook-audit/bundle-audit.md
target/uselesskey-tls-audit/bundle-audit.json
target/uselesskey-tls-audit/bundle-audit.md
target/uselesskey-oidc-audit/bundle-audit.json
target/uselesskey-oidc-audit/bundle-audit.md

Copy link
Copy Markdown

Choose a reason for hiding this comment

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

medium

The artifact upload paths combine files from two different jobs (webhook-fixtures and verifier-fixtures). In GitHub Actions, jobs run on separate runners by default, so an upload step in one job cannot access files generated in another runner's workspace.

To fix this, you should either:

  1. Merge the generation steps into a single job.
  2. Provide separate upload steps within each job, referencing only the files produced by that specific job.

@EffortlessSteven EffortlessSteven merged commit 6736860 into main May 18, 2026
5 checks passed
@EffortlessSteven EffortlessSteven deleted the docs/downstream-ci-github-actions branch May 18, 2026 07:12
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