docs: prepare v0.0.123 documentation - #11447
Conversation
Signed-off-by: github-actions[bot] <41898282+github-actions[bot]@users.noreply.github.com>
|
Important Review skippedBot user detected. To trigger a single review, invoke the ⚙️ Run configurationConfiguration used: Path: .coderabbit.yaml Review profile: CHILL Plan: Advanced Run ID: You can disable this status message by setting the Use the checkbox below for a quick retry:
Comment |
Signed-off-by: github-actions[bot] <41898282+github-actions[bot]@users.noreply.github.com>
|
✨ This is the automated documentation catch-up PR for v0.0.123. It will remain a draft until maintainers approve the cumulative docs for release cutoff. |
Signed-off-by: github-actions[bot] <41898282+github-actions[bot]@users.noreply.github.com>
Signed-off-by: github-actions[bot] <41898282+github-actions[bot]@users.noreply.github.com>
Signed-off-by: github-actions[bot] <41898282+github-actions[bot]@users.noreply.github.com>
Signed-off-by: github-actions[bot] <41898282+github-actions[bot]@users.noreply.github.com>
Signed-off-by: github-actions[bot] <41898282+github-actions[bot]@users.noreply.github.com>
Signed-off-by: github-actions[bot] <41898282+github-actions[bot]@users.noreply.github.com>
## Outcome Operators can now follow one owning procedure for the supported version 1 external component lifecycle during fresh Linux onboarding. The guide covers registration, gateway rendering, activation, incomplete-state handling, and the credential boundary without changing onboarding when no component is registered. ## Reason PR #11366 shipped the lifecycle accepted in #11340, but the public documentation did not explain the complete operator contract required by #11375. The workflow-owned command-reference draft in #11447 provides a short command summary; this PR adds the owning procedure without modifying that draft. ### Related issues Closes #11375 Refs #11340 Refs #11366 Refs #11447 ## Changes - Add a shared deployment guide with the fixed declaration schema, filesystem checks, trust boundary, and interceptor settings. - Document the exact HTTP activation exchange, fixed deadlines, identity and policy checks, result classes, and preserved incomplete state. - Publish the guide in the OpenClaw, Hermes, and Deep Agents navigation. - Prevent the host-state reference from treating external component activation evidence as disposable failed-session state. ## Verification - `npm run docs` — passed after the final edit; generated all three agent variants, validated routes, and reported zero Fern errors. - `npm run validate:pr` — passed for commit `2cbddc1a0ad874e15452df7a32b90812ca41c1fb` against canonical `main` at `555ba281feb4924935bda74dc35baa42129218fe`. - Generated-page inspection — confirmed the OpenClaw, Hermes, and Deep Agents command variants and selected-gateway activation fields. - Independent documentation-writer review — approved the final three-file diff with no remaining findings. - GitHub commit verification — commit `2cbddc1a0ad874e15452df7a32b90812ca41c1fb` is `Verified`. - No runtime test applies because this PR changes only documentation and navigation; the merged source and regression tests for #11340 were the behavior authority. - The validation secret scan passed, and the diff contains no secrets, API keys, or credentials. --- Signed-off-by: Apurv Kumaria <akumaria@nvidia.com> <!-- This is an auto-generated comment: release notes by coderabbit.ai --> ## Summary by CodeRabbit * **Documentation** * Added guidance for registering external host components during fresh Linux sandbox onboarding. * Documented declaration formats, validation, security requirements, activation workflows, credential handling, and verification. * Added the new deployment guide to relevant documentation navigation. * Clarified gateway state-root usage and onboarding-session evidence, lifecycle binding, deletion guidance, and recovery limitations. <!-- end of auto-generated comment: release notes by coderabbit.ai --> Signed-off-by: Apurv Kumaria <akumaria@nvidia.com>
Signed-off-by: github-actions[bot] <41898282+github-actions[bot]@users.noreply.github.com>
Signed-off-by: github-actions[bot] <41898282+github-actions[bot]@users.noreply.github.com>
Signed-off-by: github-actions[bot] <41898282+github-actions[bot]@users.noreply.github.com>
Signed-off-by: github-actions[bot] <41898282+github-actions[bot]@users.noreply.github.com>
Signed-off-by: github-actions[bot] <41898282+github-actions[bot]@users.noreply.github.com>
Signed-off-by: github-actions[bot] <41898282+github-actions[bot]@users.noreply.github.com>
Signed-off-by: github-actions[bot] <41898282+github-actions[bot]@users.noreply.github.com>
Signed-off-by: github-actions[bot] <41898282+github-actions[bot]@users.noreply.github.com>
Signed-off-by: github-actions[bot] <41898282+github-actions[bot]@users.noreply.github.com>
Signed-off-by: github-actions[bot] <41898282+github-actions[bot]@users.noreply.github.com>
Signed-off-by: github-actions[bot] <41898282+github-actions[bot]@users.noreply.github.com>
|
🌿 Preview your docs: https://nvidia-preview-pr-11447.docs.buildwithfern.com/nemoclaw |
Signed-off-by: Carlos Villela <cvillela@nvidia.com>
Signed-off-by: Carlos Villela <cvillela@nvidia.com>
|
PR Review Advisor finished for commit |
cv
left a comment
There was a problem hiding this comment.
Reviewed commit 14f5c052852edf38ec90c0c784d4905b65ed6dba against e0273c244c0e96ab35bd1d3c962c3802633d67e7.
The final documentation diff has independent writer approval. npm run docs, npm run validate:pr, CI, docs preview, CLI-reference parity, and CodeQL passed. All 22 commits are GitHub Verified.
All nine Advisor specialist reports were collected and read; none requires a change. CodeRabbit skipped the bot-authored PR, and there are no unresolved review threads.
The duplicate providerless-onboarding findings from the prior revision are resolved by removing the stale rejection. The Hermes alias suggestion needs no change because the generated Hermes reference already names nemohermes config export. ACP operational documentation remains deferred to its recorded qualification gate.
No remaining correctness, security, or documentation blocker was found.
Outcome
Complete the v0.0.123 release entry and update the command reference for merged configuration-export, external-component onboarding, Portable Hermes lifecycle, and Teams removal behavior.
Reason
The release candidate lacked its required changelog entry. The command reference also needed the cumulative documentation changes after v0.0.122 through
74c628ef625177a0dc3a227accdc0379bfd1e252.Related issues
Refs #10947 for the deferred ACP documentation and qualification requirement.
Changes
docs/changelog/2026-09-10.mdx, shared by every release-history variant.Verification
npm run docs— passed; Fern reported zero errors and five warnings. Generated agent variants and published-route checks passed.git diff --check— passed.npm run validate:pr— passed against canonical base74c628ef625177a0dc3a227accdc0379bfd1e252.Review notes
The maintainer owns this ready-for-review branch; documentation automation must leave it unchanged. The final automated refresh covers
74c628ef625177a0dc3a227accdc0379bfd1e252.Independent documentation writer review approved commit
fcbfc39b9b12f600efea0d69d31619cd50c018cfagainst base74c628ef625177a0dc3a227accdc0379bfd1e252, with no remaining blockers.The initial independent review identified the premature ACP support claim. This revision removes it in accordance with the recorded qualification decision.
Signed-off-by: github-actions[bot] <41898282+github-actions[bot]@users.noreply.github.com>
Signed-off-by: Carlos Villela cvillela@nvidia.com