feat(stackrox/stackrox/roxctl): add roxctl package

[sebdanielsson]

feat(stackrox/stackrox/roxctl): add roxctl package

Check List

• Read CONTRIBUTING.md
  • Read OSS Contribution Guide
• All commits are signed
  • This repository enables Require signed commits, so all commits must be signed
• Avoid force push
• Install and execute the package and confirm if the package works well
• Execute cmdx s to scaffold code

Add stackrox's roxctl CLI tool.

Summary by CodeRabbit

• New Features
  • Added support for the roxctl CLI with multi-version availability (including v4.4.0 through v4.10.0).
  • Enabled installation across Linux, macOS, and Windows with x86_64 and ARM64 support.
  • Added multiple download sources/mirror handling for version-specific distribution.
  • Implemented checksum verification for secure downloads.

[coderabbitai]

Warning

Rate limit exceeded

@suzuki-shunsuke has exceeded the limit for the number of commits that can be reviewed per hour. Please wait 22 minutes and 9 seconds before requesting another review.

⌛ How to resolve this issue?

After the wait time has elapsed, a review can be triggered using the @coderabbitai review command as a PR comment. Alternatively, push new commits to this PR.

We recommend that you space out your commits to avoid hitting the rate limit.

🚦 How do rate limits work?

CodeRabbit enforces hourly rate limits for each developer per organization.

Our paid plans have higher rate limits than the trial, open-source and free plans. In all cases, we re-allow further reviews after a brief timeout.

Please see our FAQ for further information.

ℹ️ Review info

⚙️ Run configuration

Configuration used: defaults

Review profile: CHILL

Plan: Pro

Run ID: 2a3a466d-06c4-4482-abbc-9097c1d8f139

📥 Commits

Reviewing files that changed from the base of the PR and between 15b67f7 and af56487.

📒 Files selected for processing (2)

• pkgs/stackrox/stackrox/roxctl/registry.yaml
• registry.yaml

📝 Walkthrough

Walkthrough

Adds three YAML registry/manifest files that declare the roxctl package and its HTTP distribution with two version-specific overrides, multi-OS/multi-arch targets, URL templates, and SHA256 checksum extraction.

Changes

Cohort / File(s)	Summary
Package Manifest pkgs/stackrox/stackrox/roxctl/pkg.yaml	New manifest listing roxctl package entries (including versions 4.10.0 and 4.4.0).
Package-specific registry pkgs/stackrox/stackrox/roxctl/registry.yaml	New registry entry defining an HTTP distribution for stackrox/stackrox/roxctl with two version_override blocks, per-OS/arch file templates, URL templates pointing to RHACS mirrors and primary sources, and SHA256 checksum extraction via regex.
Global registry registry.yaml	Adds corresponding HTTP source entry for stackrox/stackrox/roxctl with the same two version-specific overrides and platform/arch mappings.

Sequence Diagram(s)

(omitted)

Estimated code review effort

🎯 2 (Simple) | ⏱️ ~10 minutes

Poem

🐰 I dug a yaml hole today and found a key,
Two versions tucked beneath a registry tree.
Binaries for many lands, checksums snug and tight,
I hopped them into lists and kept the routes polite.
Hooray for roxctl — a rabbit's tidy spree!

🚥 Pre-merge checks | ✅ 3

✅ Passed checks (3 passed)

Check name	Status	Explanation
Title check	✅ Passed	The title clearly describes the main change: adding the roxctl package from StackRox to the registry.
Description check	✅ Passed	The description follows the template structure with a completed checklist covering all required items and a brief explanation of the change.
Docstring Coverage	✅ Passed	No functions found in the changed files to evaluate docstring coverage. Skipping docstring coverage check.

_{✏️ Tip: You can configure your own custom pre-merge checks in the settings.}

✨ Finishing Touches

🧪 Generate unit tests (beta)

• Create PR with unit tests
• Post copyable unit tests in a comment

---

Thanks for using CodeRabbit! It's free for OSS, and your support helps us grow. If you like it, consider giving us a shout-out.

❤️ Share

• X
• Mastodon
• Reddit
• LinkedIn

_{Comment @coderabbitai help to get the list of available commands and usage tips.}

[coderabbitai]

🧹 Nitpick comments (1)

pkgs/stackrox/stackrox/roxctl/pkg.yaml (1)

4-4: Remove unnecessary quotes from version value.

The quotes around "4.4.0" are unnecessary since it's a valid YAML scalar without them.

Suggested fix

 packages:
   - name: stackrox/stackrox/roxctl@4.10.0
   - name: stackrox/stackrox/roxctl
-    version: "4.4.0"
+    version: 4.4.0

As per coding guidelines: "Remove unnecessary quotes from string values."

🤖 Prompt for AI Agents

Verify each finding against the current code and only fix it if needed.

In `@pkgs/stackrox/stackrox/roxctl/pkg.yaml` at line 4, The YAML "version" scalar
currently includes unnecessary quotes ("4.4.0"); update the
pkgs/stackrox/stackrox/roxctl/pkg.yaml version key by replacing the quoted value
with an unquoted scalar (i.e., change version: "4.4.0" to version: 4.4.0) so the
YAML uses an unquoted string per the coding guidelines.

🤖 Prompt for all review comments with AI agents

Verify each finding against the current code and only fix it if needed.

Nitpick comments:
In `@pkgs/stackrox/stackrox/roxctl/pkg.yaml`:
- Line 4: The YAML "version" scalar currently includes unnecessary quotes
("4.4.0"); update the pkgs/stackrox/stackrox/roxctl/pkg.yaml version key by
replacing the quoted value with an unquoted scalar (i.e., change version:
"4.4.0" to version: 4.4.0) so the YAML uses an unquoted string per the coding
guidelines.

---

ℹ️ Review info

⚙️ Run configuration

Configuration used: defaults

Review profile: CHILL

Plan: Pro

Run ID: e375dbad-404a-497c-ab88-fb24060aa4c5

📥 Commits

Reviewing files that changed from the base of the PR and between 4582344 and 6393e98.

📒 Files selected for processing (3)

• pkgs/stackrox/stackrox/roxctl/pkg.yaml
• pkgs/stackrox/stackrox/roxctl/registry.yaml
• registry.yaml

[suzuki-shunsuke]

Thank you for your contribution!

📝

https://docs.redhat.com/en/documentation/red_hat_advanced_cluster_security_for_kubernetes/4.6/html/roxctl_cli/installing-the-roxctl-cli-1

[suzuki-shunsuke]

Suggested change

	files:
	- name: roxctl

It's unnecessary as the package name ends with /roxctl.

[suzuki-shunsuke]

Suggested change

	supported_envs:
	- linux/amd64
	- darwin/amd64
	- windows/amd64
	rosetta2: true
	windows_arm_emulation: true
	supported_envs:
	- amd64

[suzuki-shunsuke]

Suggested change

	overrides:
	- goos: windows
	url: https://mirror.openshift.com/pub/rhacs/assets/{{.Version}}/bin/windows/roxctl.exe

It's unnecessary. aqua appends .exe on Windows by default.

[suzuki-shunsuke]

Suggested change

	files:
	- name: roxctl

[suzuki-shunsuke]

Suggested change

	supported_envs:
	- darwin
	- linux/amd64
	- linux/arm64
	- windows/amd64
	windows_arm_emulation: true