Skip to content

docs(first-agent): explain proposal refresh and rule approve-all - #3908

Closed
fede-kamel wants to merge 2 commits into
NVIDIA:mainfrom
fede-kamel:docs/3884-approve-refresh
Closed

fede-kamel wants to merge 2 commits into
NVIDIA:mainfrom
fede-kamel:docs/3884-approve-refresh

Conversation

@fede-kamel

@fede-kamel fede-kamel commented Sep 29, 2026 •

Copy link
Copy Markdown
Contributor

Summary

Approving one proposal refreshes the evaluation of the others, so a second rule approve fails with "proposal inputs changed; evaluation refreshed". Explain this in the first-agent guide and show rule approve-all.

Related Issue

Refs #3884 (docs mitigation; the CLI error UX itself is not changed here)

Changes

  • docs/about/run-your-first-agent.mdx: explain proposal refresh in step 4 and document rule approve-all, including that it skips security-flagged proposals (unless --include-security-flagged) and proposals whose evaluation changed.

Testing

  • Docs-only change; no code paths affected.
  • mise run docs (nav check + fern check) passes with 0 errors on this branch merged with main.
  • Checked the documented behavior against the source at current main (see Changes).
  • mise run pre-commit passes
  • Unit tests added/updated (N/A, docs only)
  • E2E tests added/updated (N/A, docs only)

Checklist

Approving one proposal refreshes the evaluation of the others, so a
second rule approve fails with "proposal inputs changed; evaluation
refreshed" until the proposal is fetched and reviewed again. Explain
this in step 4 and show rule approve-all.

Refs NVIDIA#3884

Signed-off-by: fede-kamel <fkamelhar@gmail.com>
@copy-pr-bot

copy-pr-bot Bot commented Sep 29, 2026

Copy link
Copy Markdown

This pull request requires additional validation before any workflows can run on NVIDIA's runners.

Pull request vetters can view their responsibilities here.

Contributors can view more details about this message here.

rule approve-all skips security-flagged proposals unless
--include-security-flagged is passed, and skips proposals whose
evaluation changed since they were listed. Say so instead of implying
it approves every pending proposal.

Refs NVIDIA#3884

Signed-off-by: fede-kamel <fkamelhar@gmail.com>
@fede-kamel
fede-kamel marked this pull request as draft September 29, 2026 21:51
@fede-kamel

Copy link
Copy Markdown
Contributor Author

Superseded by #3923, which fixes the gateway so sequential approvals work instead of documenting the failure.

@fede-kamel fede-kamel closed this Sep 30, 2026
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