Skip to content

Pin GDPVal evaluator launcher to 0.2.6 - #2188

Merged
Edwardf0t1 merged 3 commits into
mainfrom
agent/fix-gdpval-launcher-version
Aug 14, 2026
Merged

Pin GDPVal evaluator launcher to 0.2.6#2188
Edwardf0t1 merged 3 commits into
mainfrom
agent/fix-gdpval-launcher-version

Conversation

@Edwardf0t1

@Edwardf0t1 Edwardf0t1 commented Aug 13, 2026

Copy link
Copy Markdown
Contributor

What does this PR do?

Type of change: Bug fix

Pins GDPVal evaluation commands to the currently validated
nemo-evaluator-launcher==0.2.6 through a dedicated uvx wrapper and updates the
GDPVal skill, recipe, example, and reference documentation to use it. The reference
also documents how to validate and adopt a future launcher release without mixing
harness versions in baseline-versus-candidate comparisons.

Older launchers generate a runtime re-export for NEL_INVOCATION_ID without first
assigning the launcher-created invocation ID. The resulting Slurm script exits under
set -u with NEL_INVOCATION_ID: unbound variable before the evaluation client
starts. Launcher 0.2.6 writes the stable invocation ID into the script before the
re-export, including for walltime-resume chains.

Usage

"$SKILL_DIR/scripts/nel-gdpval.sh" --version
"$SKILL_DIR/scripts/nel-gdpval.sh" run --config gdpval.yaml --dry-run
"$SKILL_DIR/scripts/nel-gdpval.sh" run --config gdpval.yaml

Testing

  • bash -n plugins/modelopt/skills/evaluation/scripts/nel-gdpval.sh
  • Verified the wrapper reports nemo_evaluator_launcher: 0.2.6.
  • Ran a real GDPVal dry-run and verified the generated script assigns
    NEL_INVOCATION_ID="<invocation-id>" before the runtime re-export.
  • Added a hermetic shell-wrapper test with a stub uvx; a conflicting ambient
    conflicting ambient version/spec values still invoke the validated 0.2.6 package.
  • python -m pytest plugins/modelopt/skills/evaluation/ -o addopts="" -p no:cacheprovider -v
  • Ran pre-commit on all six changed files.

Before your PR is "Ready for review"

Make sure you read and follow Contributor guidelines
and your commits are signed (git commit -s -S).

Make sure you read and follow the Security Best Practices.

  • Is this change backward compatible?: ✅
  • If you copied code from any other sources or added a new PIP dependency, did you
    follow guidance in CONTRIBUTING.md: N/A
  • Did you write any new necessary tests?: ✅ — added a hermetic wrapper test that
    stubs uvx and verifies the exact package spec despite a conflicting environment value.
  • Did you update Changelog?: N/A
  • Did you get Claude approval on this PR?: N/A

Additional Information

The fix preserves a stable GDPVal cache namespace across Slurm walltime resumes;
using SLURM_JOB_ID would not.

The failing run reused an existing base-environment nel 0.2.4 because the
pre-existing prerequisite checked only whether nel was installed. The skill
already identified 0.2.6 as the default launcher for Steps 1–9 and GDPVal. Version
0.2.6 is also the latest public nemo-evaluator-launcher release, so there is no
newer public launcher version to validate.

A dedicated uvx wrapper keeps the fix narrow and deterministic:

  • nel-next.sh manages the separate nemo-evaluator 0.4.x package, CLI, and
    schema; generalizing it would couple incompatible workflows.
  • A skill-level lock/project adds state for a single exact package invocation,
    while uvx --from ...==0.2.6 already provides an isolated cached environment.
  • A version preflight would only reject the stale shared environment or require
    mutating it; the wrapper guarantees the known-good launcher on every GDPVal
    invocation without changing the existing nel.

Summary by CodeRabbit

  • New Features

    • Added a GDPVal launcher wrapper that consistently uses the validated launcher version and forwards commands.
    • Added help output and checks for required runtime tooling.
  • Documentation

    • Clarified GDPVal launch, dry-run, reproducibility, resumed-run, and invocation ID guidance.
    • Documented version requirements and known sample limitations.
    • Updated evaluation examples and task instructions with the new launch procedure.
  • Tests

    • Added coverage verifying the pinned launcher version and argument forwarding.

Signed-off-by: Zhiyu Cheng <zhiyuc@nvidia.com>
@copy-pr-bot

copy-pr-bot Bot commented Aug 13, 2026

Copy link
Copy Markdown

Auto-sync is disabled for draft pull requests in this repository. Workflows must be run manually.

Contributors can view more details about this message here.

@coderabbitai

coderabbitai Bot commented Aug 13, 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: af1e727a-8540-4c0d-98fd-f0b95843ab7e

📥 Commits

Reviewing files that changed from the base of the PR and between 938abd2 and 6948c98.

📒 Files selected for processing (6)
  • plugins/modelopt/skills/evaluation/SKILL.md
  • plugins/modelopt/skills/evaluation/recipes/examples/gym_gdpval/example_gym_gdpval.yaml
  • plugins/modelopt/skills/evaluation/recipes/tasks/aa_gym/gdpval.md
  • plugins/modelopt/skills/evaluation/references/gym-gdpval.md
  • plugins/modelopt/skills/evaluation/scripts/nel-gdpval.sh
  • plugins/modelopt/skills/evaluation/tests/test_nel_gdpval.py
🚧 Files skipped from review as they are similar to previous changes (5)
  • plugins/modelopt/skills/evaluation/tests/test_nel_gdpval.py
  • plugins/modelopt/skills/evaluation/recipes/tasks/aa_gym/gdpval.md
  • plugins/modelopt/skills/evaluation/scripts/nel-gdpval.sh
  • plugins/modelopt/skills/evaluation/recipes/examples/gym_gdpval/example_gym_gdpval.yaml
  • plugins/modelopt/skills/evaluation/references/gym-gdpval.md

📝 Walkthrough

Walkthrough

GDPVal evaluation now uses nel-gdpval.sh, which pins launcher version 0.2.6. The wrapper forwards commands through Python 3.10. Documentation describes stable NEL_INVOCATION_ID handling and the continued limit_samples limitation.

Changes

GDPVal launcher integration

Layer / File(s) Summary
GDPVal launcher wrapper and regression test
plugins/modelopt/skills/evaluation/scripts/nel-gdpval.sh, plugins/modelopt/skills/evaluation/tests/test_nel_gdpval.py
Adds a strict wrapper that checks uvx, pins nemo-evaluator-launcher[all] to version 0.2.6, supports help output, and forwards arguments to nel with Python 3.10. The test verifies the pin and forwarded arguments.
GDPVal workflow documentation
plugins/modelopt/skills/evaluation/SKILL.md, plugins/modelopt/skills/evaluation/recipes/tasks/aa_gym/gdpval.md, plugins/modelopt/skills/evaluation/recipes/examples/gym_gdpval/example_gym_gdpval.yaml, plugins/modelopt/skills/evaluation/references/gym-gdpval.md
Updates GDPVal commands and examples to use the wrapper. Documents launcher requirements and stable NEL_INVOCATION_ID assignment across resumed runs.

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

Mergeability Score: ⚪ Minimal · up to 6948c

The PR makes GDPVal launches use the exact 0.2.6 evaluator launcher and updates the related documentation and tests; no actionable merge-blocking risk remains after normal checks and review.

Suggested reviewers: kevalmorabia97, danielkorzekwa

🚥 Pre-merge checks | ✅ 5 | ❌ 1

❌ Failed checks (1 warning)

Check name Status Explanation Resolution
Docstring Coverage ⚠️ Warning Docstring coverage is 0.00% which is insufficient. The required threshold is 80.00%. Write docstrings for the functions missing them to satisfy the coverage threshold.
✅ Passed checks (5 passed)
Check name Status Explanation
Linked Issues check ✅ Passed Check skipped because no linked issues were found for this pull request.
Out of Scope Changes check ✅ Passed Check skipped because no linked issues were found for this pull request.
Security Anti-Patterns ✅ Passed The only changed Python file is a hermetic test; its diff adds no prohibited loaders, remote-code flags, eval/exec, or # nosec. No pyproject.toml or requirements.txt changed.
Description Check ✅ Passed Check skipped - CodeRabbit’s high-level summary is enabled.
Title check ✅ Passed The title clearly and concisely describes the main change: pinning the GDPVal evaluator launcher to version 0.2.6.
✨ Finishing Touches 💡 1
📝 Generate docstrings 💡
  • Create stacked PR
  • Commit on current branch
🧪 Generate unit tests (beta)
  • Create PR with unit tests
  • Commit unit tests in branch agent/fix-gdpval-launcher-version

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

@codecov

codecov Bot commented Aug 13, 2026

Copy link
Copy Markdown

Codecov Report

✅ All modified and coverable lines are covered by tests.
✅ Project coverage is 67.09%. Comparing base (71b3d88) to head (6948c98).
⚠️ Report is 2 commits behind head on main.

Additional details and impacted files
@@           Coverage Diff           @@
##             main    #2188   +/-   ##
=======================================
  Coverage   67.09%   67.09%           
=======================================
  Files         522      522           
  Lines       60461    60461           
=======================================
  Hits        40567    40567           
  Misses      19894    19894           
Flag Coverage Δ
unit 55.30% <ø> (ø)

Flags with carried forward coverage won't be shown. Click here to find out more.

☔ View full report in Codecov by Harness.
📢 Have feedback on the report? Share it here.

🚀 New features to boost your workflow:
  • ❄️ Test Analytics: Detect flaky tests, report on failures, and find test suite problems.

@Edwardf0t1
Edwardf0t1 marked this pull request as ready for review August 13, 2026 19:53
@Edwardf0t1
Edwardf0t1 requested a review from a team as a code owner August 13, 2026 19:53

@cjluo-nv cjluo-nv left a comment

Copy link
Copy Markdown
Collaborator

Choose a reason for hiding this comment

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

Bot review (gpt-5.6-sol) — DM the bot to share feedback.

The GDPVal failure is clear: launcher versions older than 0.2.6 can generate a Slurm script that re-exports NEL_INVOCATION_ID before assigning it. The proposed solution is a dedicated uvx launcher wrapper. Existing alternatives include extending/generalizing the repository's existing scripts/nel-next.sh isolation wrapper, using a project/skill-level uv lock and uv run, or retaining the normal launcher with an exact-version preflight. The PR body explains why 0.2.6 is required, but does not compare the dedicated second wrapper with those alternatives, so the required design gate is not yet satisfied.

There is also a correctness hole in the pin itself: an ambient or sourced NEL_GDPVAL_SPEC silently bypasses 0.2.6, including selecting the older launcher this change is meant to prevent. Please make the required version non-overridable (or strictly validate the override) and add an automated wrapper test that stubs uvx and verifies the exact install spec even with a conflicting environment. The new file's NVIDIA Apache-2.0 header matches LICENSE_HEADER, so it does not require separate licensing escalation.

# launchers can instead fail under `set -u` before the evaluation client starts.
set -euo pipefail

NEL_GDPVAL_SPEC="${NEL_GDPVAL_SPEC:-nemo-evaluator-launcher[all]==0.2.6}"

Copy link
Copy Markdown
Collaborator

Choose a reason for hiding this comment

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

Bot comment.

The wrapper and docs promise that GDPVal is pinned to 0.2.6 for correctness, but this ambient-env override silently defeats that guarantee. In particular, set -a; source .env is part of the documented run flow, so a stale NEL_GDPVAL_SPEC can select exactly the older launcher that produces the unbound-variable failure. Unlike the documented escape hatch in nel-next.sh, there does not seem to be a valid compatibility path here because the generated-script behavior specifically requires 0.2.6. Please hard-code the spec (ideally readonly), or reject anything that is not the exact required release. Please also cover this with a shell test using a stub uvx, including a conflicting ambient value, since the exact pin is the core behavior of this fix.

Copy link
Copy Markdown
Contributor Author

Choose a reason for hiding this comment

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

Addressed in 938abd2. NEL_GDPVAL_SPEC is now a hard-coded readonly nemo-evaluator-launcher[all]==0.2.6, so values sourced from .env cannot bypass the correctness pin. I also added a hermetic wrapper test that puts a stub uvx on PATH, injects a conflicting NEL_GDPVAL_SPEC=...0.2.4, and asserts that the wrapper still forwards the exact 0.2.6 spec. The focused skill pytest and pre-commit checks pass.

config has a `pre_cmd`). Thinking mode is mandatory (non-thinking loses ~86%).
4. Dry-run → launch. **`limit_samples` is inert on the gym path** (the gym runs all
4. Run both dry-run and launch through `"$SKILL_DIR/scripts/nel-gdpval.sh"`; it pins
the required 0.2.6 launcher and avoids older launchers' unset

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.

Why did agent install an outdated version of nel in the first place? Does newer than 0.2.6 work?

Copy link
Copy Markdown
Collaborator

Choose a reason for hiding this comment

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

same question

Copy link
Copy Markdown
Contributor Author

Choose a reason for hiding this comment

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

Good question. The failing GDPVal attempt did not deliberately install 0.2.4; it reused an existing base-environment nel 0.2.4 because the pre-existing Step 1 only checked whether nel was present. I verified on the PR base commit that SKILL.md already identifies nemo-evaluator-launcher 0.2.6 as the default for Steps 1–9 and explicitly places GDPVal on that launcher. As of this review, 0.2.6 is the latest public nemo-evaluator-launcher release, so there is no newer public launcher version to test. The nemo-evaluator 0.3.x/0.4.x nel-next workflow is a separate package, CLI, and schema rather than a newer compatible launcher. I updated the docs to name the observed failing version precisely and added the design comparison to the PR description.

Signed-off-by: Zhiyu Cheng <zhiyuc@nvidia.com>
Signed-off-by: Zhiyu Cheng <zhiyuc@nvidia.com>
@Edwardf0t1
Edwardf0t1 merged commit 53ccec6 into main Aug 14, 2026
41 checks passed
@Edwardf0t1
Edwardf0t1 deleted the agent/fix-gdpval-launcher-version branch August 14, 2026 21:15
@github-actions

Copy link
Copy Markdown
Contributor
PR Preview Action v1.8.1
Preview removed because the pull request was closed.
2026-08-14 21:15 UTC

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.

4 participants