Skip to content

docs: prepare v0.0.102 release notes - #8251

Merged
apurvvkumaria merged 2 commits into
mainfrom
codex/docs-v0.0.102-release-prep
Aug 4, 2026
Merged

docs: prepare v0.0.102 release notes#8251
apurvvkumaria merged 2 commits into
mainfrom
codex/docs-v0.0.102-release-prep

Conversation

@apurvvkumaria

@apurvvkumaria apurvvkumaria commented Aug 4, 2026

Copy link
Copy Markdown
Collaborator

Summary

Prepares the canonical v0.0.102 release documentation from the current release-labeled scope.
The change adds a dated changelog for all 38 user-facing shipping PRs and corrects the OpenClaw agent command reference for the behavior delivered by #8191.

Changes

  • Add docs/changelog/2026-08-04.mdx with the v0.0.102 release summary, detailed behavior changes, support boundaries, security evidence links, and links to durable documentation.
  • Update docs/reference/commands.mdx to describe non-JSON OpenClaw output capture, its combined limit, marker handling, stream suppression, recovery guidance, and exit behavior.
  • #8167 -> docs/changelog/2026-08-04.mdx: Records authenticated attachment of operator-managed llama.cpp servers.
  • #8129 -> docs/changelog/2026-08-04.mdx: Records the Experimental managed vLLM profile for two DGX Spark systems.
  • #7983 -> docs/changelog/2026-08-04.mdx: Records qualification of the May 2026 GB300WS factory image.
  • #8207 -> docs/changelog/2026-08-04.mdx: Records the qualified DGX Station driver transaction.
  • #8208 -> docs/changelog/2026-08-04.mdx: Records mode-bound Express resume state.
  • #8158 -> docs/changelog/2026-08-04.mdx: Records recovery of host-global dual-Station runtime ownership.
  • #8145 -> docs/changelog/2026-08-04.mdx: Records Windows-host Ollama validation from Docker Desktop's network context.
  • #8190 -> docs/changelog/2026-08-04.mdx: Records HTTP model pulls when WSL has no local Ollama executable.
  • #8195 -> docs/changelog/2026-08-04.mdx: Records reuse of a healthy installer-managed CLI.
  • #8053 -> docs/changelog/2026-08-04.mdx: Records early rejection of incompatible OpenShell gateway versions.
  • #8098 -> docs/changelog/2026-08-04.mdx: Records the bounded package-service-to-standalone gateway recovery transition.
  • #8216 -> docs/changelog/2026-08-04.mdx: Records the final dashboard port selected during multi-sandbox onboarding.
  • #8146 -> docs/changelog/2026-08-04.mdx: Records managed startup-state restoration for stopped sandboxes.
  • #8092 -> docs/changelog/2026-08-04.mdx: Records gateway watchdog recovery for classified not-serving states.
  • #8182 -> docs/changelog/2026-08-04.mdx: Records consistent managed-recovery wait configuration.
  • #8040 -> docs/changelog/2026-08-04.mdx: Records Docker sandbox rollback authority through late validation.
  • #8130 -> docs/changelog/2026-08-04.mdx: Records bounded Shields deadline recovery and durable containment.
  • #8086 -> docs/changelog/2026-08-04.mdx: Records repair of narrowly validated permission-only configuration drift.
  • #8122 -> docs/changelog/2026-08-04.mdx: Records prompt failure and guidance for corrupt transition locks.
  • #8124 -> docs/changelog/2026-08-04.mdx: Records policy restoration flags, previews, and target revalidation.
  • #7886 -> docs/changelog/2026-08-04.mdx: Records explicit destruction after pre-delete Shields hardening failures while preserving recovery authority.
  • #7901 -> docs/changelog/2026-08-04.mdx: Records multi-port uninstall behavior and shared-resource preservation.
  • #7984 -> docs/changelog/2026-08-04.mdx: Records one classified transient remote MCP startup retry.
  • #7954 -> docs/changelog/2026-08-04.mdx: Records bounded hosted-inference probe replies.
  • #7574 -> docs/changelog/2026-08-04.mdx: Records preservation of validated reasoning capabilities through onboarding.
  • #8089 -> docs/changelog/2026-08-04.mdx: Records proxy routing for Hermes WhatsApp pairing and media traffic.
  • #7682 -> docs/changelog/2026-08-04.mdx: Records native Hermes session deletion and identifier validation.
  • #8150 -> docs/changelog/2026-08-04.mdx: Records corporate CA trust for LangChain Deep Agents Code image builds.
  • #8156 -> docs/changelog/2026-08-04.mdx: Records reviewed managed runtime dependency remediation.
  • #8180 -> docs/changelog/2026-08-04.mdx: Records reviewed MCP discovery runtime dependency updates.
  • #8196 -> docs/changelog/2026-08-04.mdx: Records private npm dependency remediation across managed images.
  • #8203 -> docs/changelog/2026-08-04.mdx: Records reviewed Hermes and LangChain Deep Agents Code Python dependency updates.
  • #8125 -> docs/changelog/2026-08-04.mdx: Records bounded diagnostics for invalid enumerated CLI values.
  • #8193 -> docs/changelog/2026-08-04.mdx: Records bounded diagnostics for unresolved sandbox base images.
  • #8118 -> docs/changelog/2026-08-04.mdx: Records bounded diagnostics for changed gateway authority.
  • #8191 -> docs/changelog/2026-08-04.mdx, docs/reference/commands.mdx: Records output capture, marker handling, recovery guidance, and exit behavior for non-JSON OpenClaw agent commands.
  • #8187 -> docs/changelog/2026-08-04.mdx: Records the aligned interactive-installation start across supported agents.
  • #8153 -> docs/changelog/2026-08-04.mdx: Records current product capabilities and support boundaries.

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: This documentation-only release preparation does not change executable behavior. Existing changelog and published-route tests pass.
  • 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:

Documentation Writer Review

  • Documentation writer subagent reviewed the completed changes
  • Result: docs-updated
  • Evidence: Independently reviewed docs/changelog/2026-08-04.mdx and docs/reference/commands.mdx at commit b89913780. All 38 user-facing v0.0.102 PRs are represented, fix(agent): replace openclaw embedded-fallback raw output with clean recovery message (#8100) #8191 behavior matches the implementation, and the writing rules, documentation style, controlled terminology, route structure, and skip policy pass review. Targeted tests pass 36/36 and the documentation build completes with 0 errors.
  • Agent: Codex Desktop independent documentation writer

DGX Station Hardware Evidence

  • Tested on DGX Station
  • Tested commit: Not applicable
  • Station profile/scenario: Not applicable
  • Result: Not applicable
  • Supporting evidence: Not applicable

Verification

  • PR description includes a Signed-off-by: line and every commit appears as Verified in GitHub
  • Normal pre-commit, commit-msg, and pre-push hooks passed, or npm run validate:pr passed after refreshing origin/main when hooks were skipped or unavailable
  • Targeted behavior tests pass for the current change set, or tests are marked not applicable above — npx vitest run --project integration test/changelog-docs.test.ts test/check-docs-published-routes.test.ts passed 36/36.
  • Applicable broad gate passed — not applicable to documentation-only changes; npm run docs completed successfully with 0 errors.
  • 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 existing Fern warnings.
  • Doc pages follow the style guide (doc changes only)
  • New doc pages include SPDX header and frontmatter (new pages only) — the native dated changelog uses the required parser-safe MDX SPDX comment and intentionally has no frontmatter.

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

Summary by CodeRabbit

  • Documentation

    • Added release notes for v0.0.102, covering authentication, hardware setup, WSL, installer recovery, sandbox resilience, policy management, inference reliability, CLI improvements, and unified quickstarts.
    • Updated command documentation to explain how non-JSON agent output is collected, replayed, and reported.
  • Bug Fixes

    • Improved command-output recovery guidance when output exceeds limits or contains unsupported fallback markers.
    • Preserved accurate command exit-status reporting after output processing.

Signed-off-by: Apurv Kumaria <akumaria@nvidia.com>
@apurvvkumaria apurvvkumaria added area: docs Documentation, examples, guides, or docs build v0.0.102 labels Aug 4, 2026
@apurvvkumaria apurvvkumaria self-assigned this Aug 4, 2026
@coderabbitai

coderabbitai Bot commented Aug 4, 2026

Copy link
Copy Markdown
Contributor

Review Change Stack

📝 Walkthrough

Walkthrough

The PR adds the v0.0.102 changelog and updates command documentation for buffered non-JSON output, size limits, fallback detection, recovery guidance, and exit-status handling.

Changes

Documentation updates

Layer / File(s) Summary
v0.0.102 release changelog
docs/changelog/2026-08-04.mdx
Adds release notes for provider, platform, installer, gateway, sandbox, policy, MCP, inference, CLI, dependency, and documentation changes.
Non-JSON command output handling
docs/reference/commands.mdx
Documents combined stdout and stderr buffering, the 64 MiB limit, embedded-fallback errors, recovery guidance, stream replay, and OpenShell exit-status preservation.

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

Possibly related PRs

Suggested reviewers: cv, jyaunches, senthilr-nv

🚥 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 title clearly and concisely describes the primary documentation change: preparing the v0.0.102 release notes.
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.
✨ Finishing Touches
🧪 Generate unit tests (beta)
  • Create PR with unit tests
  • Commit unit tests in branch codex/docs-v0.0.102-release-prep

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

@github-actions

github-actions Bot commented Aug 4, 2026

Copy link
Copy Markdown
Contributor

@senthilr-nv senthilr-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.

I approve reviewing PR #8251 at commit b899137.

@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/reference/commands.mdx`:
- Around line 1031-1032: Update the non-JSON OpenClaw turns documentation text
so the stream names stdout and stderr, the capture limit 64 MiB, and exit status
1 are each enclosed in backticks, preserving the surrounding wording.
🪄 Autofix

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: 7de4b0b4-4c89-4212-9033-00c75badb811

📥 Commits

Reviewing files that changed from the base of the PR and between 3f7097b and b899137.

📒 Files selected for processing (2)
  • docs/changelog/2026-08-04.mdx
  • docs/reference/commands.mdx

Comment thread docs/reference/commands.mdx
@github-actions

github-actions Bot commented Aug 4, 2026

Copy link
Copy Markdown
Contributor

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): Skipped

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

3 semantic terminology decisions

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

  • define — embedded-fallback marker at docs/reference/commands.mdx:1033: Define the recognized output condition or link to the authoritative diagnostic contract.
  • established — operator-managed at docs/changelog/2026-08-04.mdx:11: Retain the established ownership modifier.
  • established — managed vLLM profile at docs/changelog/2026-08-04.mdx:14: Retain the established term and its Experimental qualifier.

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.

@apurvvkumaria
apurvvkumaria enabled auto-merge (squash) August 4, 2026 19:02
@apurvvkumaria
apurvvkumaria merged commit 2e01cf2 into main Aug 4, 2026
38 of 39 checks passed
@apurvvkumaria
apurvvkumaria deleted the codex/docs-v0.0.102-release-prep branch August 4, 2026 19:31
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

Projects

None yet

Development

Successfully merging this pull request may close these issues.

3 participants