refactor(cli): use oclif flag relationships

[cv]

Summary

Move simple cross-flag validation into oclif metadata so NemoClaw does not maintain duplicate parser logic for relationships oclif already supports.

Stack Navigation

• Position: 34 of 60
• Previous PR: #2926 — refactor(cli): add shared oclif command base
• Next PR: #2928 — refactor(cli): pass lifecycle typed options

Changes

• Made onboard --resume and --fresh mutually exclusive through oclif flag metadata.
• Made policy --from-file and --from-dir mutually exclusive through oclif flag metadata.
• Added command-level tests showing invalid flag combinations fail before action dispatch.
• Updated policy CLI expectations for oclif's relationship validation wording.

Type of Change

• Code change (feature, bug fix, or refactor)
• Code change with doc updates
• Doc only (prose changes, no code sample modifications)
• Doc only (includes code sample changes)

Verification

• npx prek run --all-files passes
• npm test passes
• Tests added or updated for new or changed behavior
• No secrets, API keys, or credentials committed
• Docs updated for user-facing behavior changes
• make docs builds without warnings (doc changes only)
• Doc pages follow the style guide (doc changes only)
• New doc pages include SPDX header and frontmatter (new pages only)

---

Signed-off-by: Carlos Villela cvillela@nvidia.com

Summary by CodeRabbit

• Improvements

  • CLI flags updated so conflicting options are now mutually exclusive (prevents combining resume/fresh and from-file/from-dir).
  • Improved validation to surface errors earlier when incompatible flags are provided.

• Documentation

  • Added example usages to policy-related CLI help output.

• Tests

  • Added and updated tests covering the new validation and error messaging.

[copy-pr-bot]

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]

Caution

Review failed

The pull request is closed.

ℹ️ Recent review info

⚙️ Run configuration

Configuration used: Path: .coderabbit.yaml

Review profile: CHILL

Plan: Enterprise

Run ID: ad9fd6fe-7225-4b96-9812-d19c0947bc94

📥 Commits

Reviewing files that changed from the base of the PR and between d0d2a70 and a5ea73b.

📒 Files selected for processing (2)

• src/lib/onboard-cli-commands.ts
• test/policies.test.ts

---

📝 Walkthrough

Walkthrough

Flags for onboard and policy CLI commands were made mutually exclusive where appropriate; policy command examples were added; tests were added/updated to verify flag validation and error messages, and a new test ensures onboard's resume/fresh combination rejects before action dispatch.

Changes

CLI Flag Exclusivity, Metadata, and Tests

Layer / File(s)	Summary
Flag Definition & Validation src/lib/onboard-cli-commands.ts, src/lib/policy-mutate-cli-commands.ts	resume and fresh flags now declare mutual exclusive constraints; from-file and from-dir flags in PolicyAddCommand now declare exclusive constraints.
Command Metadata src/lib/policy-mutate-cli-commands.ts	PolicyAddCommand and PolicyRemoveCommand gained static examples arrays documenting usage.
New / Updated Unit Tests src/lib/onboard-cli-commands.test.ts, src/lib/policy-mutate-cli-commands.test.ts	Added tests asserting: OnboardCliCommand.run(["--resume","--fresh"], ...) rejects before dispatching action; PolicyAddCommand rejects when --from-file value missing and when --from-file and --from-dir are provided together, also ensuring no runtime dispatch.
Integration Test Adjustment test/policies.test.ts	Updated expectation for policy-add --from-file / --from-dir error text to match "cannot also be provided" wording.

Estimated code review effort

🎯 2 (Simple) | ⏱️ ~12 minutes

"I hop with joy at flags aligned,
Exclusive paths now well-defined,
Tests guard the hops and stops,
Examples show the proper props,
A little rabbit clap — refined!" 🐇✨

✨ Finishing Touches

📝 Generate docstrings

• Create stacked PR
• Commit on current branch

🧪 Generate unit tests (beta)

• Create PR with unit tests
• Commit unit tests in branch refactor/oclif-first-flag-relationships

---

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

[cjagwani]

Approved as part of stack from #2886 (auto-approve: CI green, no scope/behavior flags).