fix(readiness): qualify DGX GB300WS 7.5.0 factory image build 2026-05-13

[Dongni-Yang]

Summary

Station Express used two independent release classifiers for no-OTA factory images. A physical DGX Station GB300 running DGX OS 7.5.0 build 2026-05-13-18-42-38 matched neither allowlist and was classified as unsupported-dgx-os.

This change qualifies that verified factory profile as supported-ai-developer-tools in both classifiers while preserving the byte-exact, fail-closed boundary for every other 7.5.0 no-OTA build.

Related Issue

Refs #7979

Maintainer Decision

Qualify the physically verified May 2026 GB300WS factory profile through the existing exact-image allowlist. Do not broaden 7.5.0 matching by date or change the separately supported --force-station-install metadata override.

Changes

• Add NVIDIA DGX GB300WS|7.5.0|2026-05-13-18-42-38 to the TypeScript readiness classifier.
• Add the same tuple to scripts/prepare-dgx-station-host.sh so Express detection and host preparation agree.
• Cover the TypeScript classifier, production shell classifier, and installer Express-detection path.
• Document the qualified May and June 2026 AI Developer Tools profiles and their shared packaged-CDI compatibility boundary.

Physical DGX Station Evidence

• NemoClaw revision: 0042806c85a8f373de8d52d72185086c12fd2925
• Scenario: two physical DGX Station GB300 systems with the May 13 factory image
• Profile selected: ai-developer-tools / supported-ai-developer-tools
• Result: CANDIDATE_CHECK_RESULT=PASS on both systems
• Hardware: one inference GB300 per system, driver 615.54, volatile ECC 0/0
• Workload preservation: one stopped container per system; both state diffs were empty
• Pair readiness: both systems independently accepted the May profile; two active 400 Gb/s rails per system at MTU 9000 with reciprocal connectivity
• Mutation boundary: immutable-revision --check only; no Express install or host mutation
• Evidence: two-system hardware validation

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
• Docs updated for the user-visible supported-image boundary
• Sensitive paths changed: Station readiness, installer detection, and host preparation
• Sensitive-path review completed through focused tests and physical read-only Station validation
• Non-success, skipped, or missing CI check accepted by maintainer

Documentation Writer Review

• Documentation writer subagent reviewed the completed changes
• Result: approved
• Evidence: no blocking findings or non-blocking suggestions after the Station profile list, CDI repair ownership, shell comment, and byte-exact test labels were updated
• Agent: Codex documentation writer subagent

Verification

• npx vitest run test/install-station-dgx-os.test.ts test/install-express-prompt.test.ts src/lib/readiness/platform-qualification.test.ts — 222 passed, 1 skipped
• npm run build:cli
• npm run typecheck:cli
• npm --prefix nemoclaw run typecheck
• npm run docs:sync-agent-variants
• npm run docs — 0 errors, 2 existing warnings
• Normal pre-commit and pre-push hooks passed
• GitHub reports all branch commits as signed and verified
• No secrets, API keys, credentials, or host state were changed

---

Signed-off-by: Dongni Yang dongniy@nvidia.com
Signed-off-by: Senthil Ravichandran senthilr@nvidia.com

[copy-pr-bot]

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.

[github-code-quality]

Code Coverage Overview

Languages: TypeScript

TypeScript / code-coverage/plugin

The overall coverage in commit 1a6209e in the fix/7979-station-gb3... branch remains at 96%, unchanged from commit abae710 in the main branch.

TypeScript / code-coverage/cli

The overall coverage in commit 1a6209e in the fix/7979-station-gb3... branch remains at 81%, unchanged from commit 5f87afa in the main branch.

Show a code coverage summary of the most impacted files.

File	main 5f87afa	fix/7979-station-gb3... 1a6209e	+/-
src/lib/credentials/store.ts	56%	55%	-1%
src/lib/sandbox...rce-identity.ts	88%	88%	0%
src/lib/state/g...way-registry.ts	94%	94%	0%
src/lib/state/m...-acquisition.ts	75%	75%	0%
src/lib/tunnel/services.ts	76%	76%	0%
src/lib/readine...ualification.ts	92%	93%	+1%
src/lib/onboard...shboard-port.ts	90%	96%	+6%

---

_{Updated August 04, 2026 03:21 UTC}

[github-actions]

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 terminology decisions differ; normalized E2E selections match; severity counts match.

Second-opinion terminology and E2E selections are advisory. They do not change the primary assessment or E2E / PR Gate.

2 semantic terminology decisions

Terminology decisions are advisory. They affect the assessment only when a separate finding identifies concrete semantic impact.

• justified — AI Developer Tools factory image at scripts/prepare-dgx-station-host.sh:2419: Keep the date-qualified modifier when referring to the two exact profiles.
• justified — factory-image boundary at docs/get-started/dgx-station-preparation.mdx:157: Keep the exact-profile qualifier to state the limited CDI-repair scope.

E2E guidance

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

Recommended E2E: None

Workflow run details

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

[coderabbitai]

📝 Walkthrough

Walkthrough

The change adds the May 13, 2026 DGX GB300WS AI Developer Tools image to release qualification, installation classification, host preparation, tests, and DGX Station documentation.

Changes

DGX Station image support

Layer / File(s)	Summary
Release qualification and classification src/lib/readiness/platform-qualification.ts, src/lib/readiness/platform-qualification.test.ts, test/install-express-prompt.test.ts, test/install-station-dgx-os.test.ts	The May 13, 2026 GB300WS release is classified as supported-ai-developer-tools and DGX Station. Tests cover GPU detection and factory-profile classification.
Host preparation and documentation scripts/prepare-dgx-station-host.sh, docs/get-started/dgx-station-preparation.mdx	The host release allowlist accepts the May image alongside the June image. CDI repair guidance applies to both qualified images.

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

🚥 Pre-merge checks | ✅ 5

✅ Passed checks (5 passed)

Check name	Status	Explanation
Docstring Coverage	✅ Passed	No functions found in the changed files to evaluate docstring coverage. Skipping docstring coverage check.
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.
Description Check	✅ Passed	Check skipped - CodeRabbit’s high-level summary is enabled.
Title check	✅ Passed	The title clearly identifies the readiness fix and the specific DGX GB300WS 7.5.0 factory image build that the pull request qualifies.

✨ 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 fix/7979-station-gb300ws-2026-05-13

---

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

[github-actions]

🌿 Preview your docs: https://nvidia-preview-pr-7983.docs.buildwithfern.com/nemoclaw

[senthilr-nv]

Physical DGX Station validation is complete for commit 0042806c85a8f373de8d52d72185086c12fd2925.

Two physical DGX Station GB300 systems independently reported:

DGX_PRETTY_NAME="NVIDIA DGX GB300WS"
DGX_SWBUILD_VERSION="7.5.0"
DGX_SWBUILD_DATE="2026-05-13-18-42-38"

The immutable-revision read-only check passed on both systems:

• profile=ai-developer-tools
• release=supported-ai-developer-tools
• CHECK_RESULT=READY_FOR_FACTORY_RUNTIME_PREPARATION
• CANDIDATE_CHECK_RESULT=PASS
• GB300 driver 615.54, volatile ECC 0/0
• existing stopped container preserved; both state diffs empty
• no host mutation

The same systems form a prepared dual-Station pair. A fresh read-only pair check confirmed:

• two active 400 Gb/s RDMA rails per system at MTU 9000
• reciprocal connectivity over both rails with zero packet loss
• one healthy GB300 per system and no active inference workload
• the May factory profile is accepted independently on both the head and peer

This confirms that the release classifier does not block dual-Station peer qualification. The validation did not repeat model download, managed inference, or agent onboarding.

The initial PR changed only the TypeScript readiness classifier. This revision also updates the production shell classifier and installer Express-detection coverage, so normal Express no longer reaches unsupported-dgx-os during host preparation.

[coderabbitai]

Actionable comments posted: 1

🤖 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 `@docs/get-started/dgx-station-preparation.mdx`:
- Line 157: Rewrite the compatibility-repair sentence in active voice, making
the qualified May and June 2026 AI Developer Tools factory-image boundary the
actor that causes or defines the repair. Preserve the exact scope, the packaged
CDI units being disabled, and the removal condition requiring repeat clean-host
qualification showing nvidia.com/gpu=all at boot.

🪄 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: 9f21ce6f-78a4-46dc-8c3c-eb34074fedce

📥 Commits

Reviewing files that changed from the base of the PR and between 6a838ff and 0042806.

📒 Files selected for processing (6)

• docs/get-started/dgx-station-preparation.mdx
• scripts/prepare-dgx-station-host.sh
• src/lib/readiness/platform-qualification.test.ts
• src/lib/readiness/platform-qualification.ts
• test/install-express-prompt.test.ts
• test/install-station-dgx-os.test.ts

[senthilr-nv]

Approved. The May 2026 factory profile is accepted by both production classifiers; focused tests and docs validation pass; read-only physical checks passed on both members of a dual-Station pair; the CodeRabbit feedback is resolved.