docs(release): refresh 0.0.42 docs

[miyoungc]

Summary

Refreshes the NemoClaw documentation for the local main changes included in the 0.0.42 release. The update adds release notes, updates the affected user-facing setup and troubleshooting pages, bumps docs metadata to 0.0.42, and regenerates the matching user skills.

Changes

• fix(status): explain cloudflared-stopped reason and surface Connected/Inference fields #3537 -> docs/reference/commands.md, docs/reference/troubleshooting.md: Documented host-level status fields, cloudflared state-specific recovery hints, and Local Ollama auth proxy status diagnostics.
• fix(onboard): use Docker driver on macOS #3454 -> docs/get-started/prerequisites.md, docs/get-started/quickstart.md: Documented macOS Docker-driver onboarding and removed the expectation that standard macOS setup needs a VM driver helper.
• fix(onboard): retry compatible endpoint smoke after reasoning-only output #3514 -> docs/inference/use-local-inference.md: Documented compatible-endpoint retry behavior for reasoning-only smoke responses.
• feat(channels): canonicalise channel name and hint missing preset #3448 -> docs/reference/commands.md, docs/manage-sandboxes/messaging-channels.md: Documented canonical channel names and policy preset hints after channels add.
• fix(onboard,uninstall): replace misleading recovery messages (#3456) #3520 -> docs/about/release-notes.md: Captured clearer GPU recovery and uninstall wording in the 0.0.42 release notes.
• fix(onboard): strengthen dashboard port detection and roll back on forward-start failure #3313 -> docs/get-started/quickstart.md, docs/reference/troubleshooting.md: Documented stronger dashboard port detection and rollback when a forward cannot start.
• perf(policy): batch onboarding preset application #3502 -> docs/about/release-notes.md: Captured batched onboarding policy preset application in the 0.0.42 release notes.
• fix(platform): detect Colima docker.sock at top-level path (#3503) #3505 -> docs/reference/troubleshooting.md: Documented the top-level Colima socket path.
• fix(installer): dedupe user shim log #3421 -> docs/about/release-notes.md: Captured idempotent installer shim logging in the 0.0.42 release notes.
• Updated docs/project.json, docs/versions1.json, and regenerated .agents/skills/nemoclaw-user-* outputs.

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)

Verification

• npx prek run --all-files passes
• npm test passes
• Tests added or updated for new or changed behavior
• 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 (doc changes only)
• New doc pages include SPDX header and frontmatter (new pages only)

---

Signed-off-by: Miyoung Choi miyoungc@nvidia.com

Summary by CodeRabbit

Release Notes - v0.0.42

• Documentation

  • Enhanced macOS onboarding guidance for Docker gateway setup
  • Improved dashboard port conflict handling with automatic rollback
  • Better local Ollama inference diagnostics and authentication proxy checks
  • Clarified status command output and recovery procedures
  • Refined messaging channel setup documentation

• Chores

  • Version bump to 0.0.42

[coderabbitai]

📝 Walkthrough

Walkthrough

This PR documents the v0.0.42 release of NemoClaw with updates across onboarding, CLI reference, and troubleshooting documentation. Changes include clarifications on macOS Docker gateway paths, dashboard port conflict recovery, Ollama authenticated proxy health checks, channel name normalization with preset hints, and enhanced CLI diagnostics. Version metadata is bumped from 0.0.41 to 0.0.42.

Changes

NemoClaw v0.0.42 release documentation

Layer / File(s)	Summary
Version metadata bump docs/project.json, docs/versions1.json	Version updated from 0.0.41 to 0.0.42 in package metadata and version registry.
macOS installer gateway path and port conflict handling .agents/skills/nemoclaw-user-get-started/SKILL.md, docs/get-started/quickstart.md, .agents/skills/nemoclaw-user-get-started/references/prerequisites.md, docs/get-started/prerequisites.md, .agents/skills/nemoclaw-user-reference/references/troubleshooting.md, docs/reference/troubleshooting.md	macOS installer now documented to use Docker-driver OpenShell gateway with Docker Desktop or Colima. Dashboard port conflict handling rolls back sandbox and prompts retry if port becomes occupied after build start. Preflight checks include privileged lsof probe for root-owned listeners.
Ollama authenticated proxy status and verification .agents/skills/nemoclaw-user-configure-inference/SKILL.md, docs/inference/use-local-inference.md, .agents/skills/nemoclaw-user-reference/references/commands.md, docs/reference/commands.md, .agents/skills/nemoclaw-user-reference/references/troubleshooting.md, docs/reference/troubleshooting.md	Status verification now checks authenticated proxy separately when proxy token exists. Smoke request retried with larger budget for reasoning-only model responses. Documentation distinguishes healthy backend from broken proxy path. Recovery guidance instructs re-running onboarding when proxy is unauthorized or unreachable.
Channel add command normalization and preset hints .agents/skills/nemoclaw-user-manage-sandboxes/references/messaging-channels.md, docs/manage-sandboxes/messaging-channels.md, .agents/skills/nemoclaw-user-reference/references/commands.md, docs/reference/commands.md	Channel names normalized to lowercase before storage and display. Command prints policy-add <channel> hint when matching built-in network policy preset exists but is not yet applied.
CLI status output enhancements and tunnel diagnostics .agents/skills/nemoclaw-user-reference/references/commands.md, docs/reference/commands.md	nemoclaw status text output now includes configured inference provider/model per sandbox and indicates active SSH session connection status. Cloudflared tunnel diagnostics added: reports PID file state (missing/invalid/dead process) and suggests nemoclaw tunnel start recovery when installed but not running.
Troubleshooting guidance for socket detection .agents/skills/nemoclaw-user-reference/references/troubleshooting.md, docs/reference/troubleshooting.md	Expanded Colima socket detection to cover additional path at ~/.colima/docker.sock alongside XDG and legacy locations. Local Ollama inference timeout guidance extended with authenticated proxy troubleshooting and recovery procedure.
Release notes for v0.0.42 .agents/skills/nemoclaw-user-overview/references/release-notes.md, docs/about/release-notes.md	Release notes summarize onboarding improvements, enhanced status diagnostics, local inference/proxy checks, endpoint validation retry behavior, channel name normalization, policy preset application, and installer idempotency enhancements.

Estimated code review effort

🎯 2 (Simple) | ⏱️ ~12 minutes

Possibly related PRs

• NVIDIA/NemoClaw#3448: Implements channel name canonicalization and preset hint behavior documented in this PR's channels add reference updates.
• NVIDIA/NemoClaw#3427: Implements authenticated proxy and health-check behavior for Local Ollama documented in this PR's inference and status verification updates.
• NVIDIA/NemoClaw#3531: Implements proxy-probe validation for authenticated reverse proxy onboarding flow documented in this PR's Ollama status and recovery guidance.

Suggested reviewers

• cv
• ericksoa
• ahunnargikar-nvidia

---

🐰 A version bump and doc refresh, so neat,
macOS gateways and proxies all fleet,
Port conflicts? They rollback with care,
Channel names normalized, status laid bare,
v0.0.42 hops forward—docs complete! 🎉

🚥 Pre-merge checks | ✅ 5

✅ Passed checks (5 passed)

Check name	Status	Explanation
Description Check	✅ Passed	Check skipped - CodeRabbit’s high-level summary is enabled.
Title check	✅ Passed	The PR title 'docs(release): refresh 0.0.42 docs' directly and clearly describes the main change: updating documentation for the 0.0.42 release.
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.

_{✏️ Tip: You can configure your own custom pre-merge checks in the settings.}

✨ Finishing Touches

🧪 Generate unit tests (beta)

• Create PR with unit tests
• Commit unit tests in branch docs/refresh-0.0.42

---

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

[github-actions]

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 because this PR is documentation and agent-skill markdown/reference content only. Although the text discusses onboarding, macOS Docker-driver behavior, dashboard ports, local inference, status diagnostics, messaging channels, and policy hints, there are no changes to executable source, workflows, blueprint assets, policies, installer scripts, or tests that could alter runtime behavior or user-flow mechanics.

Optional E2E

• None.

New E2E recommendations

• None.