Skip to content

docs: prepare v0.0.76 release notes#6425

Merged
apurvvkumaria merged 3 commits into
mainfrom
codex/docs-v0.0.76-release-prep
Jul 8, 2026
Merged

docs: prepare v0.0.76 release notes#6425
apurvvkumaria merged 3 commits into
mainfrom
codex/docs-v0.0.76-release-prep

Conversation

@apurvvkumaria

@apurvvkumaria apurvvkumaria commented Jul 8, 2026

Copy link
Copy Markdown
Collaborator

Summary

Prepares the user-facing documentation for NemoClaw v0.0.76 and closes the release-prep documentation gate. It adds the release highlights, documents the arm64 Local NIM warning and expanded image cleanup behavior, and fixes agent-specific command headings in generated guides.

Changes

  • Add the v0.0.76 release-notes section and move the shared-gateway route containment entry out of the v0.0.74 history where it was incorrectly placed.
  • Document the advisory Linux arm64 Local NIM manifest warning in the canonical platform matrix and local-inference guidance.
  • Document that gc scans both gateway-built and locally prebuilt sandbox image repositories.
  • Keep OpenClaw and Hermes session headings out of the generated Deep Agents command guide.
  • Add a focused variant regression test for the agent-specific session headings.

Source summary

This release-prep PR has no single linked acceptance issue; the table maps each user-facing source PR to its documentation coverage.

Merged sources Documentation coverage
#6414, #6418, #6416, #6344 v0.0.76 release notes and the Deep Agents quickstart/inference routes
#6340 v0.0.76 release notes and existing Deep Agents observability guidance
#6338, #6378, #6297 v0.0.76 release notes and existing inference/troubleshooting guidance
#6362 v0.0.76 release notes and existing lifecycle, command, and credential guidance
#6330, #6307, #6008 v0.0.76 release notes and existing security, troubleshooting, and command guidance
#6382 v0.0.76 release notes and existing MCP/command guidance
#6326, #5868, #5539 v0.0.76 release notes, platform matrix, inference options, and local-inference guidance
#6396, #6390, #6007 v0.0.76 release notes and existing messaging guidance
#5388, #6249, #6303, #6306 v0.0.76 release notes and command/lifecycle guidance

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:

Verification

  • PR description includes the DCO sign-off declaration 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 — docs generation/variants: npx vitest run --project integration test/generate-platform-docs.test.ts test/agent-variant-docs.test.ts test/sync-agent-variant-docs.test.ts (3 files, 29 tests passed); documented NIM/GC behavior: npx vitest run --project cli src/lib/onboard/nim-image-compat-warning.test.ts src/lib/domain/maintenance/images.test.ts (2 files, 7 tests passed); python3 scripts/generate-platform-docs.py --check (all files in sync)
  • Applicable broad gate passed — npm test for broad runtime/test-harness changes; npm run check for repo-wide validation/coverage changes — command/result:
  • 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) — completed with 0 errors and 2 pre-existing Fern warnings
  • Doc pages follow the style guide (doc changes only)
  • New doc pages include SPDX header and frontmatter (new pages only)

Signed-off-by: Apurv Kumaria akumaria@nvidia.com

Signed-off-by: Apurv Kumaria <akumaria@nvidia.com>
@apurvvkumaria apurvvkumaria added area: docs Documentation, examples, guides, or docs build v0.0.76 Release target labels Jul 8, 2026
@apurvvkumaria apurvvkumaria self-assigned this Jul 8, 2026
@coderabbitai

coderabbitai Bot commented Jul 8, 2026

Copy link
Copy Markdown
Contributor

Review Change Stack

📝 Walkthrough

Walkthrough

This PR updates Local NVIDIA NIM guidance in docs and CI notes, adds v0.0.76 release notes, and corrects command reference formatting, cleanup wording, and related variant-heading test coverage.

Changes

Documentation updates

Layer / File(s) Summary
NIM arm64 manifest advisory across docs
ci/platform-matrix.json, docs/inference/inference-options.mdx, docs/inference/use-local-inference.mdx, docs/reference/platform-support.mdx
Updated Local NVIDIA NIM notes to warn about missing linux/arm64 manifests on DGX Spark/Station hosts and to point users to supported fallback providers.
v0.0.76 release notes update
docs/about/release-notes.mdx
Added a new v0.0.76 release section and removed an older bullet about shared OpenShell gateway inference-route conflict handling.
Commands reference fixes
docs/reference/commands.mdx, test/sync-agent-variant-docs.test.ts
Adjusted AgentOnly wrapper placement for sessions headings, updated gc cleanup wording, and added a test for Deep Agents and Hermes variant heading rendering.

Estimated code review effort: 1 (Trivial) | ~5 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 accurately summarizes the main release-prep documentation update for v0.0.76.
✨ 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/docs-v0.0.76-release-prep

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

@github-code-quality

github-code-quality Bot commented Jul 8, 2026

Copy link
Copy Markdown
Contributor

Code Coverage Overview

Languages: TypeScript

TypeScript / code-coverage/plugin

The overall coverage in the codex/docs-v0.0.76-r... branch is 96%. Coverage data for the main branch is not yet available.

Show a code coverage summary of the most covered files.
File main codex/docs-v0.0.76-r... ff95c78 +/-
nemoclaw/src/se...cret-scanner.ts 100%
nemoclaw/src/commands/slash.ts 100%
nemoclaw/src/li...bprocess-env.ts 100%
nemoclaw/src/bl...eprint/state.ts 98%
nemoclaw/src/onboard/config.ts 98%
nemoclaw/src/bl...int/snapshot.ts 97%
nemoclaw/src/bl...print/runner.ts 95%
nemoclaw/src/co...ration-state.ts 94%
nemoclaw/src/bl...ate-networks.ts 94%
nemoclaw/src/index.ts 94%

TypeScript / code-coverage/cli

The overall coverage in the codex/docs-v0.0.76-r... branch is 76%. Coverage data for the main branch is not yet available.

Show a code coverage summary of the most covered files.
File main codex/docs-v0.0.76-r... ff95c78 +/-
src/lib/onboard/preflight.ts 82%
src/lib/state/o...oard-session.ts 82%
src/lib/actions...all/run-plan.ts 81%
src/lib/actions...licy-channel.ts 79%
src/lib/actions...box/snapshot.ts 79%
src/lib/state/sandbox.ts 75%
src/lib/onboard...er-gpu-patch.ts 69%
src/lib/policy/index.ts 65%
src/lib/shields/index.ts 60%
src/lib/onboard.ts 28%

Updated July 08, 2026 01:40 UTC
Code Coverage is in Public Preview. Learn more and provide us with your feedback.

@apurvvkumaria
apurvvkumaria requested a review from jyaunches July 8, 2026 01:24
@github-actions

github-actions Bot commented Jul 8, 2026

Copy link
Copy Markdown
Contributor

@github-actions

github-actions Bot commented Jul 8, 2026

Copy link
Copy Markdown
Contributor

E2E Advisor Recommendation

Required E2E: None
Optional E2E: None

Workflow run

Full advisor summary

E2E Recommendation Advisor

Base: origin/main
Head: HEAD
Confidence: high

Required E2E

  • None. No E2E is recommended. The diff is documentation/platform-matrix text plus a documentation-sync unit test. Although the docs mention onboarding, local NIM, sessions, and gc behavior, there are no touched runtime source files, workflow E2E definitions, sandbox assets, credentials/security boundaries, network policies, inference routing code, or onboarding state-machine/resume paths. Existing non-E2E docs generation/sync and unit tests are the appropriate coverage.

Optional E2E

  • None.

New E2E recommendations

  • None.

@github-actions

github-actions Bot commented Jul 8, 2026

Copy link
Copy Markdown
Contributor

E2E Target Recommendation

Required E2E targets: None
Optional E2E targets: None

Workflow run

Full E2E target advisor summary

E2E Target Advisor

Base: origin/main
Head: HEAD
Confidence: high

Required E2E targets

  • None. Changes are limited to docs/platform-matrix content and a non-E2E docs sync test outside test/e2e; they do not affect the E2E target workflow, registry, runtime support, fixtures, manifests, or live target behavior.

Optional E2E targets

  • None.

Relevant changed files

  • None.

@github-actions

github-actions Bot commented Jul 8, 2026

Copy link
Copy Markdown
Contributor

PR Review Advisor (Nemotron Ultra) — No blocking findings

Merge posture: No blocking advisor findings
Primary next action: No advisor follow-up required beyond maintainer review.
Open items: 0 required · 0 warnings · 0 suggestions · 0 test follow-ups
Since last review: 0 prior items resolved · 0 still apply · 0 new items found

Workflow run details

This is an automated, non-binding review; it still expects maintainers and agents to respond to each required or warning item. Treat suggestions as current-PR improvements when they touch changed code; defer only with maintainer rationale or a linked follow-up. A human maintainer must make the final merge decision.

@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: 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/about/release-notes.mdx`:
- Line 51: Update the release-notes sentence so the `gc` description covers both
orphaned locally prebuilt sandbox images and orphaned images in the
gateway-managed `openshell/sandbox-from` repository. Locate the wording in the
release-notes entry containing `gc` and revise that single line to mention both
image sources clearly without changing the rest of the sentence.
🪄 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: 8b5ce5d8-7dda-4b59-9e5a-5cebaf95c2b4

📥 Commits

Reviewing files that changed from the base of the PR and between c1c2138 and 59dcf0a.

📒 Files selected for processing (6)
  • ci/platform-matrix.json
  • docs/about/release-notes.mdx
  • docs/inference/inference-options.mdx
  • docs/inference/use-local-inference.mdx
  • docs/reference/commands.mdx
  • docs/reference/platform-support.mdx

Comment thread docs/about/release-notes.mdx Outdated
@github-actions

github-actions Bot commented Jul 8, 2026

Copy link
Copy Markdown
Contributor

PR Review Advisor — No blocking findings

Merge posture: No blocking advisor findings
Primary next action: Add or justify PRA-T1 and any related test follow-ups.
Open items: 0 required · 0 warnings · 0 suggestions · 4 test follow-ups
Since last review: 1 prior item resolved · 0 still apply · 0 new items found

Action checklist

  • PRA-T1 Add or justify test follow-up: Runtime validation
  • PRA-T2 Add or justify test follow-up: Runtime validation
  • PRA-T3 Add or justify test follow-up: Runtime validation
  • PRA-T4 Add or justify test follow-up: Acceptance clause
Test follow-ups to resolve or justify

If these cover changed behavior, prefer adding them in this PR; otherwise state why existing coverage is enough or link the follow-up.

  • PRA-T1 Runtime validation — Identify existing platform-doc generation check evidence that ci/platform-matrix.json and the rendered provider tables stay synchronized after the Local NVIDIA NIM note change.. The direct code change is docs/test-only and the added static regression covers the prior session-heading gap. Because several docs describe runtime/sandbox/inference behavior, confidence depends on existing runtime tests for those underlying already-merged behaviors rather than new runtime execution in this PR.
  • PRA-T2 Runtime validation — Identify existing src/lib/onboard/nim-image-compat-warning.test.ts or test/onboard-nim-image-compat-warning.test.ts coverage showing Linux arm64 DGX Spark/Station NIM warnings are advisory and still allow attempting the selected image.. The direct code change is docs/test-only and the added static regression covers the prior session-heading gap. Because several docs describe runtime/sandbox/inference behavior, confidence depends on existing runtime tests for those underlying already-merged behaviors rather than new runtime execution in this PR.
  • PRA-T3 Runtime validation — Identify existing src/lib/domain/maintenance/images.test.ts coverage showing gc treats nemoclaw-sandbox-local:* as a garbage-collectable sandbox image repository while preserving registered tags.. The direct code change is docs/test-only and the added static regression covers the prior session-heading gap. Because several docs describe runtime/sandbox/inference behavior, confidence depends on existing runtime tests for those underlying already-merged behaviors rather than new runtime execution in this PR.
  • PRA-T4 Acceptance clause — No linked issue acceptance clauses were provided. — add test evidence or identify existing coverage. The deterministic validation context reports linkedIssues: [].

Workflow run details

This is an automated, non-binding review; it still expects maintainers and agents to respond to each required or warning item. Treat suggestions as current-PR improvements when they touch changed code; defer only with maintainer rationale or a linked follow-up. A human maintainer must make the final merge decision.

Signed-off-by: Apurv Kumaria <akumaria@nvidia.com>
Signed-off-by: Apurv Kumaria <akumaria@nvidia.com>
@apurvvkumaria
apurvvkumaria enabled auto-merge (squash) July 8, 2026 01:32
@apurvvkumaria
apurvvkumaria merged commit 0662be4 into main Jul 8, 2026
53 of 55 checks passed
@apurvvkumaria
apurvvkumaria deleted the codex/docs-v0.0.76-release-prep branch July 8, 2026 01:40
Hadar301 pushed a commit to Hadar301/NemoClaw-OpenShift that referenced this pull request Jul 12, 2026
<!-- markdownlint-disable MD041 -->
## Summary

Prepares the user-facing documentation for NemoClaw v0.0.76 and closes
the release-prep documentation gate. It adds the release highlights,
documents the arm64 Local NIM warning and expanded image cleanup
behavior, and fixes agent-specific command headings in generated guides.

## Changes

- Add the v0.0.76 release-notes section and move the shared-gateway
route containment entry out of the v0.0.74 history where it was
incorrectly placed.
- Document the advisory Linux arm64 Local NIM manifest warning in the
canonical platform matrix and local-inference guidance.
- Document that `gc` scans both gateway-built and locally prebuilt
sandbox image repositories.
- Keep OpenClaw and Hermes session headings out of the generated Deep
Agents command guide.
- Add a focused variant regression test for the agent-specific session
headings.

### Source summary

| Merged sources | Documentation coverage |
| --- | --- |
| [NVIDIA#6414](NVIDIA#6414),
[NVIDIA#6418](NVIDIA#6418),
[NVIDIA#6416](NVIDIA#6416),
[NVIDIA#6344](NVIDIA#6344) | v0.0.76 release
notes and the Deep Agents quickstart/inference routes |
| [NVIDIA#6340](NVIDIA#6340) | v0.0.76
release notes and existing Deep Agents observability guidance |
| [NVIDIA#6338](NVIDIA#6338),
[NVIDIA#6378](NVIDIA#6378),
[NVIDIA#6297](NVIDIA#6297) | v0.0.76 release
notes and existing inference/troubleshooting guidance |
| [NVIDIA#6362](NVIDIA#6362) | v0.0.76
release notes and existing lifecycle, command, and credential guidance |
| [NVIDIA#6330](NVIDIA#6330),
[NVIDIA#6307](NVIDIA#6307),
[NVIDIA#6008](NVIDIA#6008) | v0.0.76 release
notes and existing security, troubleshooting, and command guidance |
| [NVIDIA#6382](NVIDIA#6382) | v0.0.76
release notes and existing MCP/command guidance |
| [NVIDIA#6326](NVIDIA#6326),
[NVIDIA#5868](NVIDIA#5868),
[NVIDIA#5539](NVIDIA#5539) | v0.0.76 release
notes, platform matrix, inference options, and local-inference guidance
|
| [NVIDIA#6396](NVIDIA#6396),
[NVIDIA#6390](NVIDIA#6390),
[NVIDIA#6007](NVIDIA#6007) | v0.0.76 release
notes and existing messaging guidance |
| [NVIDIA#5388](NVIDIA#5388),
[NVIDIA#6249](NVIDIA#6249),
[NVIDIA#6303](NVIDIA#6303),
[NVIDIA#6306](NVIDIA#6306) | v0.0.76 release
notes and command/lifecycle guidance |

## Type of Change

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

## Quality Gates

- [x] Tests added or updated for changed behavior
- [ ] Existing tests cover changed behavior — justification:
- [ ] Tests not applicable — justification:
- [x] 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:

## Verification

- [x] PR description includes the DCO sign-off declaration and every
commit appears as `Verified` in GitHub
- [x] Normal `pre-commit`, `commit-msg`, and `pre-push` hooks passed, or
`npm run check:diff` passed when hooks were skipped or unavailable
- [x] Targeted behavior tests pass for the current change set, or tests
are marked not applicable above — `npx vitest run --project integration
test/generate-platform-docs.test.ts test/agent-variant-docs.test.ts
test/sync-agent-variant-docs.test.ts` (3 files, 29 tests passed)
- [ ] Applicable broad gate passed — `npm test` for broad
runtime/test-harness changes; `npm run check` for repo-wide
validation/coverage changes — command/result:
- [x] Quality Gates section completed with required justifications or
waivers
- [x] No secrets, API keys, or credentials committed
- [ ] `npm run docs` builds without warnings (doc changes only) —
completed with 0 errors and 2 pre-existing Fern warnings
- [x] 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)

---
Signed-off-by: Apurv Kumaria <akumaria@nvidia.com>


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

## Summary by CodeRabbit

* **Documentation**
* Added v0.0.76 release notes content, and removed an older conflicting
bullet from the surrounding release history.
* Expanded Local NVIDIA NIM guidance across inference/provider docs,
including an advisory for Linux arm64 DGX Spark/DGX Station hosts when a
matching `linux/arm64` image manifest is unavailable.
* Updated the command reference for correct session-section rendering
and clarified `gc` image cleanup sources.
* **Tests**
* Added coverage ensuring Deep Agents omits sessions headings while
Hermes includes them.
* **CI**
* Refreshed Local NVIDIA NIM provider notes used in the platform matrix.

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

---------

Signed-off-by: Apurv Kumaria <akumaria@nvidia.com>
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

area: docs Documentation, examples, guides, or docs build v0.0.76 Release target

Projects

None yet

Development

Successfully merging this pull request may close these issues.

3 participants