Skip to content

fix: NCX to NICo rename QA follow-up - #4825

Open
kfelternv wants to merge 9 commits into
NVIDIA:mainfrom
kfelternv:codex/issue-2358-qa-followup
Open

fix: NCX to NICo rename QA follow-up#4825
kfelternv wants to merge 9 commits into
NVIDIA:mainfrom
kfelternv:codex/issue-2358-qa-followup

Conversation

@kfelternv

@kfelternv kfelternv commented Aug 11, 2026

Copy link
Copy Markdown
Contributor

Addresses every actionable item from the #2358 QA review by documenting the supported observability setup option, replacing the remaining stale Core values filename and anchor, correcting the authentication link in the OpenAPI source and generated outputs, clearing the required Markdown lint findings, and updating the remaining repository references used by Helm metadata, API-web source links, and admin CLI metadata.

Related issues

Refs #2358

Type of Change

  • Add - New feature or capability
  • Change - Changes in existing functionality
  • Fix - Bug fixes
  • Remove - Removed features or deprecated functionality
  • Internal - Internal changes (refactoring, tests, docs, etc.)

Breaking Changes

  • This PR contains breaking changes

Testing

  • Unit tests added/updated
  • Integration tests added/updated
  • Manual testing performed
  • No testing required (docs, internal refactor, etc.)

Additional Notes

OpenAPI SDK and rendered documentation were regenerated from rest-api/openapi/spec.yaml. The five affected Markdown files pass rumdl, all 136 Fern MDX files validate, the Helm chart lints, all 17 migrated changelog URLs and the corrected auth URL return HTTP 200, and the generated Go SDK tests pass. Focused Rust package tests are blocked on Apple Silicon macOS because tss-esapi-sys does not support the target without generated bindings.

@copy-pr-bot

copy-pr-bot Bot commented Aug 11, 2026

Copy link
Copy Markdown

Auto-sync is disabled for draft pull requests in this repository. Workflows must be run manually.

Contributors can view more details about this message here.

@coderabbitai

coderabbitai Bot commented Aug 11, 2026

Copy link
Copy Markdown
Contributor

Review Change Stack

Note

Reviews paused

It looks like this branch is under active development. To avoid overwhelming you with review comments due to an influx of new commits, CodeRabbit has automatically paused this review. You can configure this behavior by changing the reviews.auto_review.auto_pause_after_reviewed_commits setting.

Use the following commands to manage reviews:

  • @coderabbitai resume to resume automatic reviews.
  • @coderabbitai review to trigger a single review.

Use the checkboxes below for quick actions:

  • ▶️ Resume reviews
  • 🔍 Trigger review

No actionable comments were generated in the recent review. 🎉

ℹ️ Recent review info
⚙️ Run configuration

Configuration used: Path: .coderabbit.yaml

Review profile: CHILL

Plan: Enterprise

Run ID: 43d2f606-a394-496a-9c23-910cc65ecbbe

📥 Commits

Reviewing files that changed from the base of the PR and between 78dd3a6 and 96b017f.

📒 Files selected for processing (1)
  • docs/getting-started/quick-start.md
🚧 Files skipped from review as they are similar to previous changes (1)
  • docs/getting-started/quick-start.md

Summary by CodeRabbit

  • Documentation

    • Improved deployment, installation, networking, and Helm documentation formatting and readability.
    • Corrected configuration references from ncx-core.yaml to nico-core.yaml.
    • Added guidance for the --with-observability setup option.
    • Updated repository, authentication, and external connectivity links.
    • Clarified compatibility guidance and improved code block formatting.
  • Bug Fixes

    • Corrected repository metadata and controller state source links to point to the current repository.
    • Updated project naming references to infra-controller.

Walkthrough

The PR updates repository URLs, configuration filenames, project metadata, documentation links, Markdown heading structure, code-fence annotations, and Quick Start documentation for observability setup.

Changes

Repository and documentation alignment

Layer / File(s) Summary
Repository reference updates
crates/admin-cli/src/cfg/cli_options.rs, crates/api-web/src/filters.rs, helm-prereqs/Chart.yaml, devspace.yaml
Repository metadata, controller source links, Helm chart metadata, and the DevSpace project name now use infra-controller.
Deployment guide alignment
docs/getting-started/*, docs/provisioning/*, deploy/README.md
Deployment documentation now uses nico-core, documents --with-observability, and applies consistent Markdown structure and spacing.
Helm prerequisite documentation
helm-prereqs/README.md
The directory example uses a text fence. Compatibility references now use public wording.
REST API documentation formatting
rest-api/deploy/INSTALLATION.md, rest-api/openapi/spec.yaml
Installation examples use explicit code-fence languages and spacing. OpenAPI authentication links now include the repository path.

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

Mergeability Score: ⚪ Minimal · up to 96b01

This PR updates documentation, generated API outputs, and repository metadata without any supplied evidence of an actionable merge-blocking risk; it is merge-ready after normal checks and review.

🚥 Pre-merge checks | ✅ 5
✅ Passed checks (5 passed)
Check name Status Explanation
Title check ✅ Passed The title clearly identifies the rename follow-up and accurately represents the repository, metadata, and documentation updates.
Description check ✅ Passed The description directly explains the QA fixes, documentation updates, link corrections, validation, and testing limitations.
Docstring Coverage ✅ Passed Docstring coverage is 100.00% which is sufficient. The required threshold is 80.00%.
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

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

@thossain-nv thossain-nv added the rest-api Add this label when an issue or PR concerns NICo REST API label Aug 11, 2026 — with ChatGPT Codex Connector
@kfelternv kfelternv changed the title docs: Fix rename follow-up QA gaps fix: Complete rename QA follow-up Aug 11, 2026
@kfelternv
kfelternv force-pushed the codex/issue-2358-qa-followup branch from cdcfac1 to 6b5135e Compare August 11, 2026 18:20

Copy link
Copy Markdown
Contributor Author

What changed

This PR corrects stale repository, configuration, anchor, and documentation references. It also updates the compiled admin CLI metadata and the admin UI source links.

Scenario and setup

I tested head 6b5135ee2384078817cea9553708939564b14750. I built the exact revision, deployed the Core profile in an isolated local Kind cluster, and used Machine-a-Tron to produce a live Machine state with a source reference.

Verification

Step 1: Validate the changed Markdown and Helm chart

Why this step exists: This checks the corrected headings, fences, links, and chart metadata.

Runnable command:

uvx rumdl check --config docs/.rumdl.toml \
  deploy/README.md \
  docs/getting-started/installation-options/day0-machine-identity.md \
  docs/getting-started/quick-start.md \
  docs/provisioning/ip-and-network-configuration.md \
  helm-prereqs/README.md \
  rest-api/CHANGELOG.md \
  rest-api/deploy/INSTALLATION.md
helm lint helm-prereqs

Observed result:

Success: No issues found in 7 files
1 chart(s) linted, 0 chart(s) failed

Why this proves the behavior: The changed reader-facing files and Helm metadata pass their configured validators.

Step 2: Validate the generated Go SDK and corrected public links

Why this step exists: This checks the generated SDK and both corrected repository links used by the OpenAPI and Quick Start documentation.

Runnable command:

(
  cd rest-api/sdk/standard
  go test ./...
)
for url in \
  https://github.com/NVIDIA/infra-controller/tree/main/rest-api/auth \
  https://github.com/NVIDIA/infra-controller/blob/main/helm-prereqs/observability/README.md
do
  curl -L -sS -o /dev/null -w '%{http_code} %{url_effective}\n' "$url"
done

Observed result:

ok github.com/NVIDIA/infra-controller/rest-api/sdk/standard
?  github.com/NVIDIA/infra-controller/rest-api/sdk/standard/compat [no test files]
ok github.com/NVIDIA/infra-controller/rest-api/sdk/standard/helpers
200 https://github.com/NVIDIA/infra-controller/tree/main/rest-api/auth
200 https://github.com/NVIDIA/infra-controller/blob/main/helm-prereqs/observability/README.md

Why this proves the behavior: The generated client compiles and tests successfully, and both corrected public targets resolve.

Step 3: Exercise the compiled admin CLI metadata

Why this step exists: This checks the repository metadata embedded in the deployed admin CLI and confirms the CLI starts normally.

Runnable command:

kubectl -n nico-system exec deploy/nico-api -- sh -lc \
  "grep -ao 'https://github.com/NVIDIA/[A-Za-z0-9_-]*' /opt/carbide/nico-admin-cli | sort -u"
kubectl -n nico-system exec deploy/nico-api -- \
  /opt/carbide/nico-admin-cli --help | sed -n '1,3p'

Observed result:

https://github.com/NVIDIA/infra-controller
Usage: nico-admin-cli [OPTIONS] [COMMAND]

Commands:

Why this proves the behavior: The built CLI contains the corrected repository metadata and its real help interface runs successfully.

Step 4: Exercise the rendered admin UI source link

Why this step exists: This checks the changed API-web formatter through a live rendered Machine page.

Runnable command:

MACHINE_ID="$(
  kubectl -n nico-system exec deploy/nico-api -- \
    curl -ksS https://localhost:1079/admin/machine.json |
    jq -r '.machines[] | select(.state_reason.source_ref != null) | .id' |
    sed -n '1p'
)"
kubectl -n nico-system exec deploy/nico-api -- \
  curl -ksS "https://localhost:1079/admin/machine/${MACHINE_ID}" |
  tr '"' '\n' |
  awk '/^https:\/\/github.com\/NVIDIA\// {print}' |
  sort -u

Observed result:

https://github.com/NVIDIA/infra-controller/blob/trunk/crates/machine-controller/src/handler.rs#L4352

Why this proves the behavior: The deployed admin UI rendered a live state-handler source reference against the consolidated repository.

@kfelternv
kfelternv marked this pull request as ready for review August 11, 2026 20:34
@kfelternv
kfelternv requested review from a team and polarweasel as code owners August 11, 2026 20:34
@kfelternv
kfelternv requested a review from thossain-nv August 11, 2026 20:35
@github-actions

Copy link
Copy Markdown

@github-actions

Copy link
Copy Markdown

🔐 TruffleHog Secret Scan

No secrets or credentials found!

Your code has been scanned for 700+ types of secrets and credentials. All clear! 🎉

🔗 View scan details

🕐 Last updated: 2026-08-11 20:38:14 UTC | Commit: 6b5135e

@chatgpt-codex-connector chatgpt-codex-connector Bot left a comment

Copy link
Copy Markdown

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

💡 Codex Review

Here are some automated review suggestions for this pull request.

Reviewed commit: 6b5135ee23

ℹ️ About Codex in GitHub

Your team has set up Codex to review pull requests in this repo. Reviews are triggered when you

  • Open a pull request for review
  • Mark a draft as ready
  • Comment "@codex review".

If Codex has suggestions, it will comment; otherwise it will react with 👍.

Codex can also answer questions or update the PR. Try commenting "@codex address that feedback".

Comment thread docs/getting-started/quick-start.md
Comment thread helm-prereqs/README.md Outdated
Comment thread rest-api/CHANGELOG.md Outdated

@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: 2

🤖 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 `@helm-prereqs/README.md`:
- Line 438: Update the dual-deployment references in helm-prereqs/README.md at
the sections corresponding to lines 438 and 490, linking them to the canonical
helm/README.md “Migrating from Kustomize” and “Upgrading” anchors respectively.
Replace only the unlinked references and preserve the surrounding guidance.

In `@rest-api/CHANGELOG.md`:
- Line 156: Remove the added blank line from the legacy changelog so
rest-api/CHANGELOG.md remains unchanged; current unified release entries belong
in docs/release-notes.md instead.
🪄 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: 1b2785cb-94d9-43b4-b7a1-4a6c7dd71e18

📥 Commits

Reviewing files that changed from the base of the PR and between a69c085 and 6b5135e.

⛔ Files ignored due to path filters (1)
  • rest-api/sdk/standard/model_service_account.go is excluded by !rest-api/sdk/standard/model_*.go
📒 Files selected for processing (12)
  • crates/admin-cli/src/cfg/cli_options.rs
  • crates/api-web/src/filters.rs
  • deploy/README.md
  • docs/getting-started/installation-options/day0-machine-identity.md
  • docs/getting-started/quick-start.md
  • docs/provisioning/ip-and-network-configuration.md
  • helm-prereqs/Chart.yaml
  • helm-prereqs/README.md
  • rest-api/CHANGELOG.md
  • rest-api/deploy/INSTALLATION.md
  • rest-api/docs/index.html
  • rest-api/openapi/spec.yaml

Comment thread helm-prereqs/README.md Outdated
Comment thread rest-api/CHANGELOG.md Outdated
@kfelternv
kfelternv force-pushed the codex/issue-2358-qa-followup branch from 8ef9628 to 78dd3a6 Compare August 12, 2026 03:08
@thossain-nv thossain-nv changed the title fix: Complete rename QA follow-up fix: NCX to NICo rename QA follow-up Aug 12, 2026

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

Looks good, thanks @kfelternv

Comment thread deploy/README.md Outdated
@kfelternv
kfelternv requested a review from shayan1995 August 12, 2026 18:49

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

Super-minor changes, and a request to reflow a file or two...

Comment thread deploy/README.md
Comment thread docs/getting-started/quick-start.md Outdated
Comment thread helm-prereqs/README.md Outdated
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

rest-api Add this label when an issue or PR concerns NICo REST API

Projects

None yet

Development

Successfully merging this pull request may close these issues.

4 participants