Skip to content

chore(validation): clarify local validation command names - #7836

Merged
jyaunches merged 5 commits into
mainfrom
codex/pr-7633-replacement
Jul 29, 2026
Merged

chore(validation): clarify local validation command names#7836
jyaunches merged 5 commits into
mainfrom
codex/pr-7633-replacement

Conversation

@jyaunches

@jyaunches jyaunches commented Jul 29, 2026

Copy link
Copy Markdown
Contributor

Summary

Routine pull-request validation now uses the explicit validate:pr command, custom repository checks use checks:repository, and the broad baseline remains check.
This PR replaces #7633 with signed, GitHub-verified commits because repository rules forbid repairing its unsigned published history.

Related Issue

Fixes #7550

Changes

  • Added canonical validation commands and non-breaking compatibility aliases.
  • Updated current hook, lint, contributor, skill, and pull-request-template terminology.
  • Extended the package-script contract to protect command scopes, file routing, and compatibility aliases.
  • Lowered the stale src/lib/core/shell-quote.ts fan-in budget from 27 to the measured value of 26.
    Merged PR ci(e2e): retire legacy Brev source-install validation #7632 reduced the fan-in, and the existing source-architecture check protects this limit.

Type of Change

  • Code change (feature, bug fix, or refactor)
  • Code change with doc updates
  • Doc only (prose changes, no code sample modifications)
  • Doc only (includes code sample changes)

Quality Gates

  • Tests added or updated for changed behavior
  • Existing tests cover changed behavior — justification:
  • Tests not applicable — justification:
  • Docs updated for user-facing behavior changes
  • Docs not applicable — justification:
  • Sensitive paths changed (security, policy, credentials, preflight, onboarding, inference, runner, sandbox, or messaging)
  • Sensitive-path review completed or maintainer-approved waiver recorded — reviewer/approval link/justification:
  • Non-success, skipped, or missing CI check accepted by maintainer — check name, approval link, and follow-up issue:

Documentation Writer Review

  • Documentation writer subagent reviewed the completed changes
  • Result: docs-updated
  • Evidence: Contributor validation commands and fallback guidance are documented consistently, including the legacy npm run checks scope notice and refreshing origin/main before npm run validate:pr; focused contract tests, the actual legacy alias, repository checks, normal hooks, and the docs build passed.
  • Agent: Codex Desktop

DGX Station Hardware Evidence

  • Tested on DGX Station
  • Tested commit: Not applicable
  • Station profile/scenario: Not applicable
  • Result: Not applicable
  • Supporting evidence: Not applicable

Verification

  • PR description includes a Signed-off-by: line and every commit appears as Verified in GitHub
  • Normal pre-commit, commit-msg, and pre-push hooks passed, or npm run check:diff passed when hooks were skipped or unavailable
  • Targeted behavior tests pass for the current change set, or tests are marked not applicable above — npm exec -- vitest run test/pr-workflow-contract.test.ts passed 21 tests; npm run checks printed the migration/scope notice and passed; repository checks, source-shape, and test-title validation passed.
  • Applicable broad gate passed — npm test for broad runtime/test-harness changes; npm run check for repo-wide validation/coverage changes — local structural checks and plugin coverage passed; CLI coverage encountered unrelated host-environment and timeout failures, so CI remains authoritative.
  • Quality Gates section completed with required justifications or waivers
  • No secrets, API keys, or credentials committed
  • npm run docs builds without warnings (doc changes only)
  • Doc pages follow the style guide (doc changes only)
  • New doc pages include SPDX header and frontmatter (new pages only)

Signed-off-by: Remy the Refactoror jmyaunch@gmail.com
Signed-off-by: Julie Yaunches jyaunches@nvidia.com

Summary by CodeRabbit

  • New Features

    • Added a dedicated pull request validation command.
    • Added a separate repository checks command and clarified command routing for linting and legacy aliases.
  • Documentation

    • Updated contributor, maintainer, and verification guidance to use the standardized validation workflow.
    • Clarified the distinction between pull request validation, repository checks, and broader project checks.
  • Tests

    • Expanded validation coverage for command routing, compatibility aliases, and repository-check behavior.

jyaunches and others added 2 commits July 29, 2026 11:57
Signed-off-by: Julie Yaunches <jyaunches@nvidia.com>
Signed-off-by: Remy the Refactoror <jmyaunch@gmail.com>
@github-code-quality

github-code-quality Bot commented Jul 29, 2026

Copy link
Copy Markdown
Contributor

Code Coverage Overview

Languages: TypeScript

TypeScript / code-coverage/plugin

The overall coverage in commit 9303fd6 in the codex/pr-7633-replac... branch remains at 96%, unchanged from commit 6f3afab in the main branch.

TypeScript / code-coverage/cli

The overall coverage in commit 9303fd6 in the codex/pr-7633-replac... branch remains at 81%, unchanged from commit ae71359 in the main branch.

Show a code coverage summary of the most impacted files.
File main ae71359 codex/pr-7633-replac... 9303fd6 +/-
src/lib/agent/dashboard-ui.ts 96% 96% 0%
src/lib/onboard...ure-contract.ts 87% 87% 0%
src/lib/sandbox...rce-identity.ts 88% 88% 0%
src/lib/domain/.../connect-env.ts 89% 97% +8%

Updated July 29, 2026 17:55 UTC

@coderabbitai

coderabbitai Bot commented Jul 29, 2026

Copy link
Copy Markdown
Contributor

Review Change Stack

No actionable comments were generated in the recent review. 🎉

ℹ️ Recent review info
⚙️ Run configuration

Configuration used: Path: .coderabbit.yaml

Review profile: CHILL

Plan: Enterprise

Run ID: 7936fbdf-d6bc-4863-a8a7-420b3787575f

📥 Commits

Reviewing files that changed from the base of the PR and between ed4f74b and 9303fd6.

📒 Files selected for processing (3)
  • CONTRIBUTING.md
  • package.json
  • test/pr-workflow-contract.test.ts
🚧 Files skipped from review as they are similar to previous changes (3)
  • package.json
  • CONTRIBUTING.md
  • test/pr-workflow-contract.test.ts

📝 Walkthrough

Walkthrough

The PR makes npm run validate:pr the canonical routine PR-validation command, introduces checks:repository for scoped repository checks, updates hooks and contributor guidance, and expands contract tests for command routing and compatibility aliases.

Changes

Validation command routing

Layer / File(s) Summary
Command wiring and contract coverage
package.json, .pre-commit-config.yaml, test/pr-workflow-contract.test.ts, ci/*
Adds validate:pr and checks:repository, updates script and hook routing, and verifies command scopes and compatibility aliases.
Contributor workflow guidance
.agents/..., AGENTS.md, CONTRIBUTING.md, docs/*, fern/*, .github/PULL_REQUEST_TEMPLATE.md
Replaces skipped-hook fallback instructions with npm run validate:pr and clarifies the scopes of check, checks:repository, and compatibility aliases.

Estimated code review effort: 2 (Simple) | ~10 minutes

Possibly related PRs

Suggested labels: chore, area: ci, area: cli, area: docs

🚥 Pre-merge checks | ✅ 4 | ❌ 1

❌ Failed checks (1 warning)

Check name Status Explanation Resolution
Out of Scope Changes check ⚠️ Warning The PR includes an unrelated fan-in budget change for shell-quote.ts that is not part of the validation-command rename. Move the shell-quote.ts budget tweak to a separate PR unless it is required by the validation-script refactor.
✅ Passed checks (4 passed)
Check name Status Explanation
Description Check ✅ Passed Check skipped - CodeRabbit’s high-level summary is enabled.
Title check ✅ Passed The title is concise and accurately describes the main change: clarifying validation command names.
Linked Issues check ✅ Passed The changes implement the requested validate:pr flow, rename checks to checks:repository, update docs, and add wiring tests.
Docstring Coverage ✅ Passed No functions found in the changed files to evaluate docstring coverage. Skipping docstring coverage check.
✨ Finishing Touches
📝 Generate docstrings
  • Create stacked PR
  • Commit on current branch
🧪 Generate unit tests (beta)
  • Create PR with unit tests
  • Commit unit tests in branch codex/pr-7633-replacement

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

@github-actions

Copy link
Copy Markdown
Contributor

@github-actions

github-actions Bot commented Jul 29, 2026

Copy link
Copy Markdown
Contributor

PR Review Advisor — No blocking findings reported

Advisor assessment: No blocking advisor findings reported
Next action: No advisor follow-up needed.
Findings: 0 blockers · 0 warnings · 0 suggestions

Model lanes

  • GPT-5.6 Terra (primary): Completed · high confidence · 0 blockers · 0 warnings · 0 suggestions
  • Nemotron 3 Ultra (second opinion): Completed · high confidence · 0 blockers · 0 warnings · 0 suggestions
  • Model comparison: normalized findings match; normalized E2E selections match; severity counts match.

Nemotron output stays in workflow artifacts and does not change the assessment above.

E2E guidance

Advisory only. E2E / PR Gate selects and runs jobs independently.

Recommended E2E: cloud-inference, cloud-onboard, security-posture

Workflow run details

This automated review informs maintainers. Warnings and suggestions do not require a response. A maintainer decides whether to merge.

@coderabbitai coderabbitai Bot 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.

Actionable comments posted: 2

🤖 Prompt for all review comments with AI agents
Verify each finding against current code. Fix only still-valid issues, skip the
rest with a brief reason, keep changes minimal, and validate.

Inline comments:
In @.pre-commit-config.yaml:
- Around line 170-174: Add the repository root package.json to the files matcher
for the repository-checks hook in .pre-commit-config.yaml, preserving the
existing checks:repository command and other match patterns.

In `@CONTRIBUTING.md`:
- Around line 357-358: Update CONTRIBUTING.md lines 357-358 to place git fetch
origin main before npm run validate:pr and require rerunning validation after
the refresh; make the same ordering change in
.agents/skills/nemoclaw-contributor-onboard-messaging-channel/SKILL.md lines
108-109, and update .github/PULL_REQUEST_TEMPLATE.md line 49 to state that
origin/main must be refreshed before checking the fallback command.
🪄 Autofix (Beta)

Fix all unresolved CodeRabbit comments on this PR:

  • Push a commit to this branch (recommended)
  • Create a new PR with the fixes

ℹ️ Review info
⚙️ Run configuration

Configuration used: Path: .coderabbit.yaml

Review profile: CHILL

Plan: Enterprise

Run ID: e054f89c-c8a6-4a0c-b408-579de1110a72

📥 Commits

Reviewing files that changed from the base of the PR and between 3aea38c and 16436e5.

📒 Files selected for processing (15)
  • .agents/skills/nemoclaw-contributor-create-pr/SKILL.md
  • .agents/skills/nemoclaw-contributor-onboard-messaging-channel/SKILL.md
  • .agents/skills/nemoclaw-maintainer-day/SALVAGE-PR.md
  • .agents/skills/nemoclaw-maintainer-day/TEST-GAPS.md
  • .github/PULL_REQUEST_TEMPLATE.md
  • .pre-commit-config.yaml
  • AGENTS.md
  • CONTRIBUTING.md
  • ci/source-architecture-budget.json
  • ci/source-shape-test-budget.json
  • docs/AGENTS.md
  • docs/CONTRIBUTING.md
  • fern/AGENTS.md
  • package.json
  • test/pr-workflow-contract.test.ts

Comment thread .pre-commit-config.yaml Outdated
Comment thread CONTRIBUTING.md Outdated
Signed-off-by: Julie Yaunches <jyaunches@nvidia.com>
Signed-off-by: Julie Yaunches <jyaunches@nvidia.com>
Signed-off-by: Julie Yaunches <jyaunches@nvidia.com>
@jyaunches
jyaunches merged commit 9b1fbd8 into main Jul 29, 2026
75 of 79 checks passed
@jyaunches
jyaunches deleted the codex/pr-7633-replacement branch July 29, 2026 18:56
@wscurran wscurran added area: ci CI workflows, checks, release automation, or GitHub Actions area: docs Documentation, examples, guides, or docs build chore Build, CI, dependency, or tooling maintenance labels Aug 3, 2026
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

area: ci CI workflows, checks, release automation, or GitHub Actions area: docs Documentation, examples, guides, or docs build chore Build, CI, dependency, or tooling maintenance

Projects

None yet

Development

Successfully merging this pull request may close these issues.

Clarify local validation command names for agentic contributors

3 participants