## Summary
Splits helper-oriented coverage out of the oversized
`test/onboard.test.ts` file into focused unit test files. The PR keeps
source-shape coverage at zero, preserves equivalent behavior coverage,
and makes the remaining onboard orchestration tests easier to navigate.

## Related Issue
<!-- Fixes #NNN or Closes #NNN. Remove this section if none. -->
Stacked on #3632 / #3636.

## Changes
<!-- Bullet list of key changes. -->
- Moved GPU helper coverage into focused module tests:
  - `src/lib/onboard/gateway-gpu-passthrough.test.ts`
  - `src/lib/onboard/sandbox-gpu-create.test.ts`
  - `src/lib/onboard/sandbox-gpu-mode.test.ts`
  - `src/lib/onboard/initial-policy.test.ts`
- Moved policy suggestion helper coverage into
`test/onboard-policy-suggestions.test.ts`.
- Moved dashboard helper coverage into `test/onboard-dashboard.test.ts`
and dashboard port helper coverage into
`src/lib/onboard/dashboard-port.test.ts`.
- Moved sandbox naming helper coverage into
`test/onboard-sandbox-name.test.ts`.
- Moved OpenShell version/pinning helper coverage into
`test/onboard-openshell-version.test.ts`.
- Moved Dockerfile patch helper coverage into
`src/lib/onboard/dockerfile-patch.test.ts`.
- Moved gateway runtime / Docker-driver / CDI helper coverage into
`test/onboard-gateway-runtime.test.ts`.
- Moved Model Router orchestration coverage into
`test/onboard-model-router.test.ts`.
- Moved messaging setup/provider coverage into
`test/onboard-messaging.test.ts`.
- Moved custom Dockerfile orchestration coverage into
`test/onboard-custom-dockerfile.test.ts`.
- Moved provider routing/probe/provider-CRUD helper coverage into owning
module tests:
  - `src/lib/inference/config.test.ts`
  - `src/lib/inference/onboard-probes.test.ts`
  - `src/lib/onboard/providers.test.ts`
  - `src/lib/validation.test.ts`
  - `src/lib/core/url-utils.test.ts`
  - `src/lib/adapters/http/probe.test.ts`
- Moved web-search support coverage into
`src/lib/onboard/web-search-support.test.ts` /
`test/onboard-brave-validation.test.ts`.
- Moved build-context and sandbox-create recovery hint coverage into
`src/lib/build-context.test.ts`.
- Extracted focused production helpers with direct module coverage:
  - `src/lib/onboard/credential-env.ts`
  - `src/lib/onboard/summary.ts`
- additional exports in `src/lib/onboard/sandbox-gpu-mode.ts` and
`src/lib/onboard/dashboard-port.ts`
- Removed the corresponding helper-only cases from
`test/onboard.test.ts`; it is now much smaller while keeping the
remaining orchestration/integration-style coverage.

## Type of Change
- [x] 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)

## Verification
<!-- Check each item you ran and confirmed. Leave unchecked items you
skipped. Doc-only changes do not require npm test unless you ran it. -->
- [x] `npm run source-shape:check` passes
- [x] `npm run build:cli` passes
- [x] `npx tsc -p tsconfig.cli.json --noUnusedLocals
--noUnusedParameters --pretty false` passes
- [x] `npx prek run --all-files` passes
- [x] `npm test` passes
- [x] Tests added or updated for new or changed behavior
- [x] No secrets, API keys, or credentials committed
- [ ] Docs updated for user-facing behavior changes
- [ ] `make docs` builds without warnings (doc changes only)
- [ ] Doc pages follow the [style
guide](https://github.com/NVIDIA/NemoClaw/blob/main/docs/CONTRIBUTING.md)
(doc changes only)
- [ ] New doc pages include SPDX header and frontmatter (new pages only)

---
<!-- DCO sign-off required by CI. Run: git config user.name && git
config user.email -->
Signed-off-by: Carlos Villela <cvillela@nvidia.com>


<!-- This is an auto-generated comment: release notes by coderabbit.ai
-->

## Summary by CodeRabbit

## Release Notes

* **Tests**
* Added comprehensive test coverage for GPU configuration, sandbox
naming, credential management, dashboard port handling, custom
Dockerfile support, messaging channels, Model Router setup, and
OpenShell version management.
* Added tests for probe error handling, policy validation, and sandbox
state detection.

* **Refactor**
* Reorganized onboarding helpers into dedicated modules for improved
maintainability.

<!-- review_stack_entry_start -->

[![Review Change
Stack](https://storage.googleapis.com/coderabbit_public_assets/review-stack-in-coderabbit-ui.svg)](https://app.coderabbit.ai/change-stack/NVIDIA/NemoClaw/pull/3640?utm_source=github_walkthrough&utm_medium=github&utm_campaign=change_stack)

<!-- review_stack_entry_end -->

<!-- end of auto-generated comment: release notes by coderabbit.ai -->

---------

Signed-off-by: Carlos Villela <cvillela@nvidia.com>