refactor(cli): expose explicit main entrypoint

[cv]

Summary

Introduce an explicit main(argv) entrypoint for the CLI module. The existing mainPromise export remains as a thin compatibility shim for in-process test harnesses that still require and await the CLI module.

Stack Navigation

• Position: 11 of 60
• Previous PR: #2899 — refactor(cli): remove legacy dispatch fallbacks
• Next PR: #2902 — refactor(cli): add oclif examples for utility commands

Changes

• Moved top-level argv parsing into main(argv = process.argv.slice(2)).
• Exported main for new in-process harnesses and future launcher cleanup.
• Kept mainPromise = main() compatibility with a comment directing new callers to main(argv).

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

• Refactor
  • Reorganized internal CLI initialization structure while preserving existing functionality.

[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: 6c480da8-a2b8-4741-9e09-c921944206a1

📥 Commits

Reviewing files that changed from the base of the PR and between ce184db and ff5458a.

📒 Files selected for processing (1)

• src/nemoclaw.ts

---

📝 Walkthrough

Walkthrough

The CLI entry point is refactored by extracting the top-level async IIFE into a named, exported main function that accepts an optional argv parameter. The dispatch logic and exit behavior remain unchanged; backward compatibility is maintained by immediately invoking main() and assigning the result to mainPromise.

Changes

CLI Entry Point Restructuring

Layer / File(s)	Summary
Function Extraction src/nemoclaw.ts (lines 258–260)	async function main(argv: string[] = process.argv.slice(2)) is defined, replacing the top-level IIFE and accepting optional command-line arguments.
Logic Migration src/nemoclaw.ts (lines 261–366)	Existing dispatch control flow (help handling, global vs. sandbox dispatch, registry recovery, and unknown-command suggestions) moves into main function body; behavior and exit conditions are preserved.
Export Updates src/nemoclaw.ts (lines 369–372)	exports.main now references the extracted function; exports.mainPromise is set to main() to maintain backward compatibility for test harnesses.

Estimated code review effort

🎯 2 (Simple) | ⏱️ ~10 minutes

Poem

🐰 A hop through the code, so clean and so bright,
The main takes the stage—no more IIFE in sight!
Argv flows in, dispatch flows through,
Same trusty behavior, but refactored anew!
Scripts and tests still dance to the tune, 🎭

🚥 Pre-merge checks | ✅ 4 | ❌ 1

❌ Failed checks (1 warning)

Check name	Status	Explanation	Resolution
Docstring Coverage	⚠️ Warning	Docstring coverage is 18.75% which is insufficient. The required threshold is 80.00%.	Write docstrings for the functions missing them to satisfy the coverage threshold.

✅ Passed checks (4 passed)

Check name	Status	Explanation
Description Check	✅ Passed	Check skipped - CodeRabbit’s high-level summary is enabled.
Title check	✅ Passed	The title clearly and specifically describes the main change: exposing an explicit main entrypoint for the CLI module, which aligns with the PR's primary objective of refactoring the CLI structure.
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.

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

✨ 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-explicit-main-entrypoint

---

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

[prekshivyas]

LGTM after rebase. Tiny clean refactor — 1 file / +8 / -5.

• Top-level argv destructure moves into the new main(argv = process.argv.slice(2)).
• Anonymous IIFE replaced with the named async function main.
• exports.mainPromise = main() preserves the load-time side-effect invocation byte-equivalent to the old (async () => {...})().
• New exports.main enables in-process harnesses to call with explicit argv. Comment correctly directs new callers to main(argv) over the legacy mainPromise.

No argv parsing, exit, or rejection-handling deltas. bin/nemoclaw.js untouched, package.json bin mapping untouched — public CLI surface identical.

CI: pr.yaml fully green; pr-self-hosted build-sandbox-images/arm64 still in flight at review time but no failures. Cumulative ~16-orphan debt in src/nemoclaw.ts unchanged here, still pending the dedicated cleanup PR.