LuCLI: update Homebrew formula for LuCLI Issue #1945

[bpamiri]

Repo: wheels-dev/homebrew-wheels

Current formula creates a bash wrapper that calls box wheels "$@". Change to use LuCLI:

```ruby
depends_on "lucli" # was: depends_on "commandbox"

post_install: install wheels module

system bin/"lucli", "modules", "install", "wheels",
"--url", "https://github.com/wheels-dev/wheels/archive/refs/heads/develop.tar.gz"
```

The `wheels` command stays identical for users. CommandBox continues to work for existing users.

Part of #1942

[bpamiri]

Analysis

Synopsis

Update the Homebrew formula in wheels-dev/homebrew-wheels to depend on LuCLI instead of CommandBox, so brew install wheels installs a wheels wrapper that calls lucli wheels rather than box wheels.

Merit Assessment

Recommendation: Proceed, but defer until #1947 is resolved

• This is the right direction: LuCLI is lighter than CommandBox (~40MB Java runtime vs. ~200MB+), installs faster, and has native MCP support.
• The current formula (Formula/wheels.rb) is a bash wrapper around box wheels with arg conversion (--param=value to param=value). It also handles server subcommand routing and auto-installs wheels-cli on first use. The LuCLI equivalent is simpler because LuCLI natively handles standard CLI arg conventions.
• Critical blocker: The formula needs to install the Wheels module via lucli modules install wheels, but LuCLI: module distribution (lucli modules install wheels) Issue #1947 #1947 (module distribution) hasn't determined whether LuCLI can install from a monorepo subdirectory or needs a separate distribution archive.

Implementation Plan

Once #1947 is resolved:

1. Update depends_on: Change depends_on "commandbox" to depends_on "lucli" in Formula/wheels.rb

   • Prerequisite: LuCLI itself needs a Homebrew formula or cask. Verify with Mark Drew whether cybersonic/lucli publishes one.

2. Simplify the wrapper script: The current 65-line bash wrapper handles arg conversion (--param=value to CommandBox format), server command routing, and wheels-cli auto-install. The LuCLI version is much simpler:

   #!/bin/bash
   exec lucli wheels "$@"

   LuCLI handles arg parsing natively. No conversion needed.

3. Add post_install hook: Install the Wheels module after LuCLI is installed:

   def post_install
     system bin/"lucli", "modules", "install", "wheels", "--url", "<distribution-url>"
   end

   The exact --url depends on LuCLI: module distribution (lucli modules install wheels) Issue #1947 #1947's resolution (GitHub archive URL vs. dedicated package).

4. Update version: Bump to 2.0.0 to signal the backend change.

5. Update tests: Change test block to verify lucli wheels --version works.

6. Keep backward compatibility note: Users who have CommandBox installed can still use box wheels. The formula change only affects new installs via brew install wheels.

Dependencies & Risks

• Blocked by: LuCLI: module distribution (lucli modules install wheels) Issue #1947 #1947 (module distribution) — must know the install URL/mechanism first
• Blocked by: LuCLI having its own Homebrew formula or installation method — if lucli isn't in Homebrew, depends_on "lucli" won't work. May need to use a resource block to download LuCLI directly.
• Risk: Users with existing brew install wheels will get the new LuCLI-based version on brew upgrade. Need to ensure lucli is installed as a dependency first, or the wrapper will fail.
• Risk: If LuCLI module install requires network access during brew install, it may fail in sandboxed CI environments. Consider bundling the module files directly in the formula.
• Related: LuCLI: update Chocolatey package for LuCLI Issue #1946 #1946 (Chocolatey equivalent), LuCLI: tracking issue for Phases 2-4 Issue #1942 #1942 (tracking)

---

Automated analysis by @claude — review and adjust as needed.