Skip to content

docs: prepare v0.0.123 documentation - #11447

Merged
cv merged 22 commits into
mainfrom
automation/post-merge-docs-c5ae50c6cf5d
Sep 11, 2026
Merged

docs: prepare v0.0.123 documentation#11447
cv merged 22 commits into
mainfrom
automation/post-merge-docs-c5ae50c6cf5d

Conversation

@github-actions

@github-actions github-actions Bot commented Sep 10, 2026

Copy link
Copy Markdown
Contributor

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

  • Add the canonical v0.0.123 entry to docs/changelog/2026-09-10.mdx, shared by every release-history variant.
  • Document supported configuration-export profiles and their limits, including credential references without secret values.
  • Update external-component onboarding, Portable Hermes lifecycle, and Teams credential-binding removal guidance.
  • Remove the proposed ACP operational section because its recorded trusted lifecycle qualification remains outstanding. The adapter implementation is unchanged.

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 base 74c628ef625177a0dc3a227accdc0379bfd1e252.
  • Normal pre-commit and commit-message hooks — passed, including repository checks and secret scanning.
  • The diff contains no secrets, API keys, or credentials.
  • Runtime tests do not apply to this documentation-only change.

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 fcbfc39b9b12f600efea0d69d31619cd50c018cf against base 74c628ef625177a0dc3a227accdc0379bfd1e252, 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

Signed-off-by: github-actions[bot] <41898282+github-actions[bot]@users.noreply.github.com>
@copy-pr-bot

copy-pr-bot Bot commented Sep 10, 2026

Copy link
Copy Markdown

This pull request requires additional validation before any workflows can run on NVIDIA's runners.

Pull request vetters can view their responsibilities here.

Contributors can view more details about this message here.

@coderabbitai

coderabbitai Bot commented Sep 10, 2026

Copy link
Copy Markdown
Contributor

Important

Review skipped

Bot user detected.

To trigger a single review, invoke the @coderabbitai review command.

⚙️ Run configuration

Configuration used: Path: .coderabbit.yaml

Review profile: CHILL

Plan: Advanced

Run ID: c266d990-5cce-4fa0-8cb1-20d4465bbf8d

You can disable this status message by setting the reviews.review_status to false in the CodeRabbit configuration file.

Use the checkbox below for a quick retry:

  • 🔍 Trigger review

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

Signed-off-by: github-actions[bot] <41898282+github-actions[bot]@users.noreply.github.com>
@wscurran wscurran added area: docs Documentation, examples, guides, or docs build chore Build, CI, dependency, or tooling maintenance labels Sep 10, 2026
@wscurran

Copy link
Copy Markdown
Contributor

✨ 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>
cv pushed a commit that referenced this pull request Sep 10, 2026
## 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>
@cv
cv marked this pull request as ready for review September 11, 2026 01:18
@github-actions

Copy link
Copy Markdown
Contributor Author

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

Copy link
Copy Markdown
Contributor Author

PR Review Advisor finished for commit 14f5c05. Include the Advisor findings in the complete PR feedback collection. Verify and group valid findings before repair.

All previous runs

@cv cv 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.

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.

@cv
cv merged commit f75f722 into main Sep 11, 2026
31 checks passed
@cv
cv deleted the automation/post-merge-docs-c5ae50c6cf5d branch September 11, 2026 07:04
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 chore Build, CI, dependency, or tooling maintenance

Projects

None yet

Development

Successfully merging this pull request may close these issues.

2 participants