Skip to content

chore: clean up additional internal references - #5552

Merged
chet merged 1 commit into
NVIDIA:mainfrom
chet:gh-issue-5414
Aug 30, 2026
Merged

chore: clean up additional internal references#5552
chet merged 1 commit into
NVIDIA:mainfrom
chet:gh-issue-5414

Conversation

@chet

@chet chet commented Aug 29, 2026

Copy link
Copy Markdown
Contributor

We're a public repo, but a handful of comments still point at NVIDIA-internal bug trackers, an internal Jira, and a Slack thread. Anyone reading this from outside NVIDIA hits a link they can't open. One was worse than a comment: it sat inside an error message the InfiniBand code hands back to its caller, so the internal URL went out with the error.

Deleting those links would lose the trail, so where a tracked issue still had a story worth keeping, I read it, wrote the underlying problem up without the internal detail, and filed it here as a closed issue the comment can point at instead. That's #5555, #5556, #5557, and #5558 for the bug-tracker links, and #5559 for the Jira one. Two had nothing left to preserve -- one Jira issue no longer exists, and a Slack permalink was never more than a pointer -- so those comments just lose the link and keep the explanation they already had.

#5353 covers the gitlab-master references; this is a narrow follow-on.

A few notes:

  • The InfiniBand error now names UFM as the thing that won't take both qos_conf and guids_data in one request. The link moved to the comment, where a caller reading the message doesn't have to follow it.
  • forge-dhcp-server had an internal Slack channel as its clap author. Nothing renders that value on this binary -- clap 4 only emits author through a help template or clap_mangen, and it has neither -- so it's inert metadata rather than anything an operator sees. It now matches the public repo URL nico-admin-cli uses.
  • apt-clean ships through duppet, which compares content by hash, so every managed DPU rewrites /etc/cron.daily/apt-clean once and reports it updated. There's no with_exec_on_change() on that entry, so nothing runs and the cron behavior is identical.

This is deliberately narrow. Internal hosts that stand in for real endpoints in test fixtures and sample config stay as they are, as does the build comment on the dev/docker images, and .forge in-cluster names and the forge product name were never internal references to begin with.

Related issues

This supports #5414

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.)

  • Full lint gate plus the existing suites for the touched crates; comment changes needed no new tests.

  • Ran forge-dhcp-server --help to confirm clap does not render the author value on this binary.

Review Findings

Model Findings Overview

All four local reviewers completely covered the same stable pre-fix tree. The counts below cover the review of the wider original change; the owner then narrowed its scope, which resolved several findings by removing the code they described.

Reviewer Received Adopted Declined
Claude self-review 1 1 0
CodeRabbit CLI 2 1 1
Codex CLI 0 0 0
common-nits-reviewer 14 4 10
Total 17 6 11
Model Findings Details

Claude self-review

  1. A touched crate was missing from the targeted test run. Adopted: ran it before the scope narrowed, and the affected file is no longer part of this change.

CodeRabbit CLI

  1. Lowercase the UFM error message. Adopted; both IbError and UFMError already supply a lowercase prefix, so the rendered text was mixed.
  2. Switch an example artifact URI to HTTPS and anchor artifact verification to trusted configuration. Declined: the scheme was unrelated to internal references, and that file is no longer part of this change.

Codex CLI

No findings.

common-nits-reviewer

  1. The author value is never rendered on this binary, so describing it as a --help change was wrong. Adopted: verified against the real binary and corrected the wording.
  2. The error message no longer said who refuses the combination. Adopted: it now names UFM.
  3. Give the comment a version or date boundary. Declined: that boundary is not known, and inventing one would be worse than omitting it.
  4. Document the mutual exclusion on GetPartitionOptions, add a null check in machine_get_interface_mtu, drop the stale /etc/rc.local entry, and restore an investigation trail to the upgrade.rs and mtu.rs workarounds. Declined as four separate items: each is pre-existing and lives outside this change.
  5. Add a replacement comment to all ten Dockerfiles carrying the build argument, or none. Declined: those files are no longer part of this change.
  6. ## Design held no design content once its only sentence was removed, and rumdl reported two findings on that README. Both adopted at the time; declined in the end, since that file is no longer part of this change.
  7. Use the placeholder the firmware crate already uses for fixture hosts. Declined: those fixtures now keep their original values.
  8. Internal GitLab references remain elsewhere in the tree. Declined: those exact files are Remove internal GitLab references #5353.
  9. Lowercase both error strings to match the variants' own lowercase prefixes. Adopted, matching the same finding from CodeRabbit.
  10. Note the one-time managed-file rewrite. Adopted: it is called out above.

Closes #5414

@chet
chet requested a review from a team as a code owner August 29, 2026 04:42
@chatgpt-codex-connector

chatgpt-codex-connector Bot commented Aug 29, 2026

Copy link
Copy Markdown

Codex Review Summary

This comment shows the latest Codex review activity on this pull request.

Review Status Commit Review trigger
📝 Code Review Completed 2026-08-29T04:44:54.714366Z 57aefca PR opened
ℹ️ 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" or "@codex security review".

Codex reacts with 👀 while any review is running, comments if it has suggestions, and reacts with 👍 once all reviews finish with no findings.

@chet

chet commented Aug 29, 2026

Copy link
Copy Markdown
Contributor Author

@coderabbitai full_review, thanks!

@coderabbitai

coderabbitai Bot commented Aug 29, 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: 2802375a-0660-49eb-930c-79796f6cfff2

📥 Commits

Reviewing files that changed from the base of the PR and between 62f4405 and 4388248.

📒 Files selected for processing (9)
  • crates/agent/src/managed_files.rs
  • crates/agent/src/mtu.rs
  • crates/agent/src/upgrade.rs
  • crates/agent/templates/apt-clean
  • crates/dhcp-server/src/command_line.rs
  • crates/dhcp/src/discovery.rs
  • crates/dhcp/src/machine.rs
  • crates/ib-fabric/src/ib/mock.rs
  • crates/ib-fabric/src/ib/ufmclient/mod.rs
💤 Files with no reviewable changes (2)
  • crates/agent/src/managed_files.rs
  • crates/agent/templates/apt-clean

Included review availability: Your plan provides up to 12 included reviews per hour; 10 remain after this review.


Summary by CodeRabbit

  • Bug Fixes

    • Clarified error messages when incompatible QoS and GUID data are requested together.
    • Standardized the related invalid-argument response with clearer, multiline wording.
  • Documentation

    • Removed obsolete issue-tracking and internal communication references from system comments and scripts.
    • Updated command-line author metadata to point to the project repository.
    • Refreshed issue references to use current project tracking links.

Walkthrough

The change removes obsolete issue and Slack references, updates DHCP server author metadata, and reformats UFM errors for unsupported combined requests. Runtime request handling remains unchanged.

Changes

Reference and error-text cleanup

Layer / File(s) Summary
Runtime reference cleanup
crates/agent/src/*, crates/agent/templates/apt-clean, crates/dhcp/src/*
Obsolete issue and Slack references were removed from comments. Executable behavior remains unchanged.
Error and metadata updates
crates/ib-fabric/src/ib/*, crates/dhcp-server/src/command_line.rs
UFM errors for combined guids_data and qos_conf requests were shortened and reformatted. DHCP server author metadata now uses the repository URL.

Estimated code review effort: 1 (Trivial) | ~5 minutes

Merge Risk: ⚪ Minimal · up to 43882

This PR removes inaccessible internal references and adjusts related comments and error wording without changing runtime behavior; the managed cron file may be rewritten once but does not execute. No actionable merge-blocking risk remains after normal checks and review.

🚥 Pre-merge checks | ✅ 5
✅ Passed checks (5 passed)
Check name Status Explanation
Title check ✅ Passed The title clearly and concisely summarizes the main change: removing additional internal references from the public repository.
Description check ✅ Passed The description directly explains the removal and replacement of internal bug tracker, Jira, and Slack references, along with testing and scope details.
Docstring Coverage ✅ Passed Docstring coverage is 80.00% which is sufficient. The required threshold is 80.00%. Docstring coverage is scoped to functions touched by this diff. Analyzed 10 functions across 10 files.
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 💡 1
🛠️ Fix failing CI checks 💡
  • Create stacked PR
  • Commit on current branch
🧪 Generate unit tests (beta)
  • Create PR with unit tests

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

@coderabbitai

coderabbitai Bot commented Aug 29, 2026

Copy link
Copy Markdown
Contributor

@chet: I will perform a full review of PR #5552.

🐇

✅ Action performed

Full review finished.

@chet chet changed the title chore: clean up remaining internal references chore: clean up additional internal references Aug 29, 2026
@chet

chet commented Aug 29, 2026

Copy link
Copy Markdown
Contributor Author

@coderabbitai full_review, thanks!

@coderabbitai

coderabbitai Bot commented Aug 29, 2026

Copy link
Copy Markdown
Contributor

@chet: I will perform a full review of PR #5552.

🐇🔍

✅ Action performed

Full review finished.

@chet

chet commented Aug 29, 2026

Copy link
Copy Markdown
Contributor Author

@coderabbitai full_review, thanks!

@coderabbitai

coderabbitai Bot commented Aug 29, 2026

Copy link
Copy Markdown
Contributor

@chet: I will perform a full review of PR #5552.

🐇🔍

✅ Action performed

Full review finished.

@chet

chet commented Aug 29, 2026

Copy link
Copy Markdown
Contributor Author

@coderabbitai full_review, thanks!

@coderabbitai

coderabbitai Bot commented Aug 29, 2026

Copy link
Copy Markdown
Contributor

@chet: I will perform a full review of PR #5552.

🐇🔍

✅ Action performed

Full review finished.

We're a public repo, but a handful of comments still point at NVIDIA-internal bug trackers, an internal Jira, and a Slack thread. Anyone reading this from outside NVIDIA hits a link they can't open. One was worse than a comment: it sat inside an error message the InfiniBand code hands back to its caller, so the internal URL went out with the error.

Deleting those links would lose the trail, so where a tracked issue still had a story worth keeping, I read it, wrote the underlying problem up without the internal detail, and filed it here as a closed issue the comment can point at instead. That's NVIDIA#5555, NVIDIA#5556, NVIDIA#5557, and NVIDIA#5558 for the bug-tracker links, and NVIDIA#5559 for the Jira one. Two had nothing left to preserve -- one Jira issue no longer exists, and a Slack permalink was never more than a pointer -- so those comments just lose the link and keep the explanation they already had.

A few notes:

- The InfiniBand error now names UFM as the thing that won't take both `qos_conf` and `guids_data` in one request. The link moved to the comment, where a caller reading the message doesn't have to follow it.
- `forge-dhcp-server` had an internal Slack channel as its clap `author`. Nothing actually renders that value -- clap 4 only emits `author` through a help template or `clap_mangen`, and this binary has neither -- so it's inert metadata rather than anything an operator sees. It now matches the public repo URL `nico-admin-cli` uses.
- `apt-clean` ships through duppet, which compares content by hash, so **every managed DPU rewrites `/etc/cron.daily/apt-clean` once** and reports it updated. There's no `with_exec_on_change()` on that entry, so nothing runs and the cron behavior is identical.

This is deliberately narrow. Internal hosts that stand in for real endpoints in test fixtures and sample config stay as they are, as does the build comment on the `dev/docker` images, and `.forge` in-cluster names and the `forge` product name were never internal references to begin with.

Existing tests across the touched crates still pass; comment changes didn't need new ones.

This supports NVIDIA#5414

Signed-off-by: Chet Nichols III <chetn@nvidia.com>
@chet

chet commented Aug 29, 2026

Copy link
Copy Markdown
Contributor Author

@coderabbitai full_review, thanks!

@coderabbitai

coderabbitai Bot commented Aug 29, 2026

Copy link
Copy Markdown
Contributor

Note

GitHub couldn't provide a complete incremental comparison for this pull request, so CodeRabbit is performing a full review instead. This review may take a little longer.

@github-actions

Copy link
Copy Markdown

@coderabbitai

coderabbitai Bot commented Aug 29, 2026

Copy link
Copy Markdown
Contributor

@chet: I will perform a full review of PR #5552.

🐇🔍

✅ Action performed

Full review finished.

@chet
chet merged commit 279c588 into NVIDIA:main Aug 30, 2026
117 of 119 checks passed
@chet
chet deleted the gh-issue-5414 branch August 30, 2026 14:28
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

Clean up general remaining internal references

2 participants