fix(cli): resolve cli.lucli.* component paths via the modules.wheels mapping

Replaces every `cli.lucli.services.*` absolute dotted path in cli/lucli/
with the equivalent `modules.wheels.services.*` path. The new prefix
matches the same `modules.<name>.<...>` convention LuCLI uses to load
each module's own `Module.cfc`, so the paths resolve identically in
every context the CLI runs in:

  Dev symlink (~/.lucli/modules/wheels -> <repo>/cli/lucli)
    modules.wheels.services.X -> <repo>/cli/lucli/services/X.cfc

  Brew install (~/.wheels/modules/wheels)
    modules.wheels.services.X -> ~/.wheels/modules/wheels/services/X.cfc

  Isolated harness ($LUCLI_HOME/modules/wheels)
    modules.wheels.services.X -> $LUCLI_HOME/modules/wheels/services/X.cfc

The previous `cli.lucli.*` prefix only resolved when the module was
loaded from a path with `cli/lucli/` in its filesystem ancestry —
true for the user's daily dev symlink (because the symlink target
lives in the repo's `cli/lucli/` directory and Lucee follows the
symlink to its real path), but NOT true for any installation that
copies the module's contents (Homebrew bottle, Chocolatey package,
or any LUCLI_HOME-isolated test setup).

User-visible effect on fresh installs:

  Before:
    $ wheels deploy version
    Error: could not find component or class with name
      [cli.lucli.services.deploy.cli.DeployMainCli]

    $ wheels packages list
    Error: could not find component or class with name
      [cli.lucli.services.packages.PackagesMainCli]

  After:
    $ wheels deploy version
    wheels-deploy mirrors kamal 2.4.0 / kamal-proxy v0.8.6

    $ wheels packages list
    [reaches the next level — see follow-up note below]

Reported as F7 in the second VM-onboarding journal. Validated locally
via the onboarding harness (PR #2308): with this fix applied, the
`wheels deploy` family resolves cleanly in the LUCLI_HOME-isolated
test that simulates a fresh brew install.

Scope: 88 files in cli/lucli/, 482 -> 486 prefix substitutions (small
discrepancy because a handful of files had >1 ref per line via comments
or chained calls). Includes test specs so they continue to mirror
production paths.

Out of scope (separate follow-up):

  `wheels packages list` now reaches PackagesMainCli but fails at
  cli/lucli/services/packages/VersionResolver.cfc:17 which does
  `new wheels.SemVer()` — a reference to the framework's
  `vendor/wheels/SemVer.cfc`. The framework isn't on the CLI's
  resolution path when running outside an app, so SemVer can't be
  found. That's a different architectural issue (CLI command depends
  on framework being loaded) and warrants its own PR. The harness
  Phase 7 will continue to surface it as a SKIP until that's fixed.

Author: bpamiri

cli/lucli/Module.cfc

@@ -1310,8 +1310,8 @@ component extends="modules.BaseModule" {
 		var positional = $deployStripFlags(args);
 		var sub = arrayLen(positional) >= 1 ? positional[1] : "deploy";
 
-		var dmc = new cli.lucli.services.deploy.cli.DeployMainCli(
-			new cli.lucli.services.deploy.lib.SshPool()
+		var dmc = new modules.wheels.services.deploy.cli.DeployMainCli(
+			new modules.wheels.services.deploy.lib.SshPool()
 		);
 
 		switch (sub) {
@@ -1348,8 +1348,8 @@ component extends="modules.BaseModule" {
 					throw(message="wheels deploy app requires a verb");
 				}
 				var appVerb = positional[2];
-				var appCli = new cli.lucli.services.deploy.cli.DeployAppCli(
-					new cli.lucli.services.deploy.lib.SshPool()
+				var appCli = new modules.wheels.services.deploy.cli.DeployAppCli(
+					new modules.wheels.services.deploy.lib.SshPool()
 				);
 				switch (appVerb) {
 					case "boot":
@@ -1371,8 +1371,8 @@ component extends="modules.BaseModule" {
 					throw(message="wheels deploy proxy requires a verb");
 				}
 				var proxyVerb = positional[2];
-				var proxyCli = new cli.lucli.services.deploy.cli.DeployProxyCli(
-					new cli.lucli.services.deploy.lib.SshPool()
+				var proxyCli = new modules.wheels.services.deploy.cli.DeployProxyCli(
+					new modules.wheels.services.deploy.lib.SshPool()
 				);
 				switch (proxyVerb) {
 					case "boot":
@@ -1392,8 +1392,8 @@ component extends="modules.BaseModule" {
 					throw(message="wheels deploy registry requires a verb");
 				}
 				var registryVerb = positional[2];
-				var registryCli = new cli.lucli.services.deploy.cli.DeployRegistryCli(
-					new cli.lucli.services.deploy.lib.SshPool()
+				var registryCli = new modules.wheels.services.deploy.cli.DeployRegistryCli(
+					new modules.wheels.services.deploy.lib.SshPool()
 				);
 				switch (registryVerb) {
 					case "setup":
@@ -1409,8 +1409,8 @@ component extends="modules.BaseModule" {
 					throw(message="wheels deploy build requires a verb");
 				}
 				var buildVerb = positional[2];
-				var buildCli = new cli.lucli.services.deploy.cli.DeployBuildCli(
-					new cli.lucli.services.deploy.lib.SshPool()
+				var buildCli = new modules.wheels.services.deploy.cli.DeployBuildCli(
+					new modules.wheels.services.deploy.lib.SshPool()
 				);
 				switch (buildVerb) {
 					case "deliver":
@@ -1430,8 +1430,8 @@ component extends="modules.BaseModule" {
 				}
 				var accVerb = positional[2];
 				opts.name = arrayLen(positional) >= 3 ? positional[3] : "";
-				var accCli = new cli.lucli.services.deploy.cli.DeployAccessoryCli(
-					new cli.lucli.services.deploy.lib.SshPool()
+				var accCli = new modules.wheels.services.deploy.cli.DeployAccessoryCli(
+					new modules.wheels.services.deploy.lib.SshPool()
 				);
 				switch (accVerb) {
 					case "boot":
@@ -1454,8 +1454,8 @@ component extends="modules.BaseModule" {
 				if (!listFindNoCase("all,images,containers", pruneVerb)) {
 					throw(message="Unknown wheels deploy prune verb: " & pruneVerb);
 				}
-				var pruneCli = new cli.lucli.services.deploy.cli.DeployPruneCli(
-					new cli.lucli.services.deploy.lib.SshPool()
+				var pruneCli = new modules.wheels.services.deploy.cli.DeployPruneCli(
+					new modules.wheels.services.deploy.lib.SshPool()
 				);
 				return invoke(pruneCli, pruneVerb, [opts]);
 			case "server":
@@ -1474,8 +1474,8 @@ component extends="modules.BaseModule" {
 					}
 					opts.cmd = arrayToList(cmdParts, " ");
 				}
-				var serverCli = new cli.lucli.services.deploy.cli.DeployServerCli(
-					new cli.lucli.services.deploy.lib.SshPool()
+				var serverCli = new modules.wheels.services.deploy.cli.DeployServerCli(
+					new modules.wheels.services.deploy.lib.SshPool()
 				);
 				switch (serverVerb) {
 					case "exec":
@@ -1491,8 +1491,8 @@ component extends="modules.BaseModule" {
 				if (!listFindNoCase("acquire,release,status", lockVerb)) {
 					throw(message="Unknown wheels deploy lock verb: " & lockVerb);
 				}
-				var lockCli = new cli.lucli.services.deploy.cli.DeployLockCli(
-					new cli.lucli.services.deploy.lib.SshPool()
+				var lockCli = new modules.wheels.services.deploy.cli.DeployLockCli(
+					new modules.wheels.services.deploy.lib.SshPool()
 				);
 				return invoke(lockCli, lockVerb, [opts]);
 			case "secrets":
@@ -1510,7 +1510,7 @@ component extends="modules.BaseModule" {
 				if (secVerb == "extract") {
 					opts.key = arrayLen(positional) >= 3 ? positional[3] : "";
 				}
-				var secCli = new cli.lucli.services.deploy.cli.DeploySecretsCli();
+				var secCli = new modules.wheels.services.deploy.cli.DeploySecretsCli();
 				return invoke(secCli, secVerb, [opts]);
 			default:
 				throw(message="Unknown deploy subcommand: #sub#");
@@ -1626,39 +1626,39 @@ component extends="modules.BaseModule" {
 
 		switch (sub) {
 			case "list":
-				var mainCli = new cli.lucli.services.packages.PackagesMainCli();
+				var mainCli = new modules.wheels.services.packages.PackagesMainCli();
 				return mainCli.list(opts);
 			case "search":
 				if (arrayLen(positional) < 2) {
 					throw(message="search requires a query: wheels packages search <query>");
 				}
 				opts.query = positional[2];
-				var mainCli = new cli.lucli.services.packages.PackagesMainCli();
+				var mainCli = new modules.wheels.services.packages.PackagesMainCli();
 				return mainCli.search(opts);
 			case "show":
 				if (arrayLen(positional) < 2) {
 					throw(message="show requires a name: wheels packages show <name>");
 				}
 				opts.name = positional[2];
-				var mainCli = new cli.lucli.services.packages.PackagesMainCli();
+				var mainCli = new modules.wheels.services.packages.PackagesMainCli();
 				return mainCli.show(opts);
 			case "install":
 				if (arrayLen(positional) < 2) {
 					throw(message="install requires a name: wheels packages install <name>[@<version>]");
 				}
 				opts.target = positional[2];
-				var mainCli = new cli.lucli.services.packages.PackagesMainCli();
+				var mainCli = new modules.wheels.services.packages.PackagesMainCli();
 				return mainCli.install(opts);
 			case "update":
 				opts.target = arrayLen(positional) >= 2 ? positional[2] : "";
-				var mainCli = new cli.lucli.services.packages.PackagesMainCli();
+				var mainCli = new modules.wheels.services.packages.PackagesMainCli();
 				return mainCli.update(opts);
 			case "remove":
 				if (arrayLen(positional) < 2) {
 					throw(message="remove requires a name: wheels packages remove <name>");
 				}
 				opts.target = positional[2];
-				var mainCli = new cli.lucli.services.packages.PackagesMainCli();
+				var mainCli = new modules.wheels.services.packages.PackagesMainCli();
 				return mainCli.remove(opts);
 			case "registry":
 				if (arrayLen(positional) < 2) {
@@ -1668,7 +1668,7 @@ component extends="modules.BaseModule" {
 				if (!listFindNoCase("refresh,info", regVerb)) {
 					throw(message="Unknown wheels packages registry verb: #regVerb#");
 				}
-				var regCli = new cli.lucli.services.packages.PackagesRegistryCli();
+				var regCli = new modules.wheels.services.packages.PackagesRegistryCli();
 				return invoke(regCli, regVerb, [opts]);
 			default:
 				throw(message="Unknown packages subcommand: #sub#");

cli/lucli/services/MigrationRunner.cfc

@@ -5,7 +5,7 @@
  * in-process command execution. Falls back to HTTP when a server is running.
  *
  * Usage from LuceeScriptEngine:
- *   var runner = new cli.lucli.services.MigrationRunner(projectRoot);
+ *   var runner = new modules.wheels.services.MigrationRunner(projectRoot);
  *   var result = runner.latest();
  */
 component {

cli/lucli/services/TestRunner.cfc

@@ -6,11 +6,11 @@
  * for test execution.
  *
  * Usage from LuceeScriptEngine:
- *   var runner = new cli.lucli.services.TestRunner(projectRoot);
+ *   var runner = new modules.wheels.services.TestRunner(projectRoot);
  *   var result = runner.run(options);
  *
  * Usage from HTTP fallback (Module.cfc delegates here when server is available):
- *   var runner = new cli.lucli.services.TestRunner(projectRoot);
+ *   var runner = new modules.wheels.services.TestRunner(projectRoot);
  *   var result = runner.runViaHttp(serverPort, options);
  */
 component {

cli/lucli/services/deploy/cli/DeployAccessoryCli.cfc

@@ -16,7 +16,7 @@ component {
 
     public DeployAccessoryCli function init(any sshPool = "") {
         variables.sshPool = arguments.sshPool;
-        variables.loader = new cli.lucli.services.deploy.config.ConfigLoader();
+        variables.loader = new modules.wheels.services.deploy.config.ConfigLoader();
         variables.dryRunBuffer = [];
         return this;
     }
@@ -53,7 +53,7 @@ component {
             arguments.opts.configPath,
             {destination: arguments.opts.destination ?: ""}
         );
-        var accCmds = new cli.lucli.services.deploy.commands.AccessoryCommands(cfg);
+        var accCmds = new modules.wheels.services.deploy.commands.AccessoryCommands(cfg);
         var dryRun = arguments.opts.dryRun ?: false;
         var targets = (arguments.opts.name == "all")
             ? cfg.accessories()

cli/lucli/services/deploy/cli/DeployAppCli.cfc

@@ -15,7 +15,7 @@ component {
 
     public DeployAppCli function init(any sshPool = "") {
         variables.sshPool = arguments.sshPool;
-        variables.loader = new cli.lucli.services.deploy.config.ConfigLoader();
+        variables.loader = new modules.wheels.services.deploy.config.ConfigLoader();
         variables.dryRunBuffer = [];
         return this;
     }
@@ -112,7 +112,7 @@ component {
                   message="This verb requires --version");
         }
         var dryRun = arguments.opts.dryRun ?: false;
-        var appCmds = new cli.lucli.services.deploy.commands.AppCommands(cfg);
+        var appCmds = new modules.wheels.services.deploy.commands.AppCommands(cfg);
         var roleFilter = arguments.opts.role ?: "";
         var hostCount = 0;
 

cli/lucli/services/deploy/cli/DeployBuildCli.cfc

@@ -14,7 +14,7 @@ component {
 
     public DeployBuildCli function init(any sshPool = "") {
         variables.sshPool = arguments.sshPool;
-        variables.loader = new cli.lucli.services.deploy.config.ConfigLoader();
+        variables.loader = new modules.wheels.services.deploy.config.ConfigLoader();
         variables.dryRunBuffer = [];
         return this;
     }
@@ -40,7 +40,7 @@ component {
         var version = arguments.opts.version ?: $gitShortSha();
         var dryRun = arguments.opts.dryRun ?: false;
         if (!len(arguments.opts.preserveBuffer ?: "")) arrayClear(variables.dryRunBuffer);
-        var builder = new cli.lucli.services.deploy.commands.BuilderCommands(cfg);
+        var builder = new modules.wheels.services.deploy.commands.BuilderCommands(cfg);
         $runLocal(builder.push(version), dryRun);
         return $renderResult(arguments.opts, "Pushed " & cfg.image() & ":" & version);
     }
@@ -50,7 +50,7 @@ component {
         var version = arguments.opts.version ?: $gitShortSha();
         var dryRun = arguments.opts.dryRun ?: false;
         if (!len(arguments.opts.preserveBuffer ?: "")) arrayClear(variables.dryRunBuffer);
-        var builder = new cli.lucli.services.deploy.commands.BuilderCommands(cfg);
+        var builder = new modules.wheels.services.deploy.commands.BuilderCommands(cfg);
         var hosts = $allHosts(cfg);
         $dispatchSsh(hosts, builder.pull(version), dryRun);
         return $renderResult(
@@ -63,31 +63,31 @@ component {
         var cfg = $loadCfg(arguments.opts);
         var dryRun = arguments.opts.dryRun ?: false;
         arrayClear(variables.dryRunBuffer);
-        $runLocal(new cli.lucli.services.deploy.commands.BuilderCommands(cfg).create(), dryRun);
+        $runLocal(new modules.wheels.services.deploy.commands.BuilderCommands(cfg).create(), dryRun);
         return $renderResult(arguments.opts, "Created builder for " & cfg.image());
     }
 
     public string function remove(required struct opts) {
         var cfg = $loadCfg(arguments.opts);
         var dryRun = arguments.opts.dryRun ?: false;
         arrayClear(variables.dryRunBuffer);
-        $runLocal(new cli.lucli.services.deploy.commands.BuilderCommands(cfg).remove(), dryRun);
+        $runLocal(new modules.wheels.services.deploy.commands.BuilderCommands(cfg).remove(), dryRun);
         return $renderResult(arguments.opts, "Removed builder for " & cfg.image());
     }
 
     public string function details(required struct opts) {
         var cfg = $loadCfg(arguments.opts);
         var dryRun = arguments.opts.dryRun ?: false;
         arrayClear(variables.dryRunBuffer);
-        $runLocal(new cli.lucli.services.deploy.commands.BuilderCommands(cfg).details(), dryRun);
+        $runLocal(new modules.wheels.services.deploy.commands.BuilderCommands(cfg).details(), dryRun);
         return $renderResult(arguments.opts, "Collected builder details for " & cfg.image());
     }
 
     public string function dev(required struct opts) {
         var cfg = $loadCfg(arguments.opts);
         var dryRun = arguments.opts.dryRun ?: false;
         arrayClear(variables.dryRunBuffer);
-        $runLocal(new cli.lucli.services.deploy.commands.BuilderCommands(cfg).dev(), dryRun);
+        $runLocal(new modules.wheels.services.deploy.commands.BuilderCommands(cfg).dev(), dryRun);
         return $renderResult(arguments.opts, "Ran dev build for " & cfg.image());
     }
 

cli/lucli/services/deploy/cli/DeployLockCli.cfc

@@ -10,7 +10,7 @@ component {
 
     public DeployLockCli function init(any sshPool = "") {
         variables.sshPool = arguments.sshPool;
-        variables.loader = new cli.lucli.services.deploy.config.ConfigLoader();
+        variables.loader = new modules.wheels.services.deploy.config.ConfigLoader();
         variables.dryRunBuffer = [];
         return this;
     }
@@ -21,7 +21,7 @@ component {
         var cfg = $loadCfg(arguments.opts);
         var dryRun = arguments.opts.dryRun ?: false;
         arrayClear(variables.dryRunBuffer);
-        var lock = new cli.lucli.services.deploy.commands.LockCommands(cfg);
+        var lock = new modules.wheels.services.deploy.commands.LockCommands(cfg);
         var cmd = lock.acquire({
             user: $currentUser(),
             message: arguments.opts.message ?: "manual acquire"
@@ -34,7 +34,7 @@ component {
         var cfg = $loadCfg(arguments.opts);
         var dryRun = arguments.opts.dryRun ?: false;
         arrayClear(variables.dryRunBuffer);
-        var lock = new cli.lucli.services.deploy.commands.LockCommands(cfg);
+        var lock = new modules.wheels.services.deploy.commands.LockCommands(cfg);
         $dispatchAny($allHosts(cfg), lock.release(), dryRun);
         return $renderResult(arguments.opts, "Released deploy lock for " & cfg.service());
     }
@@ -43,7 +43,7 @@ component {
         var cfg = $loadCfg(arguments.opts);
         var dryRun = arguments.opts.dryRun ?: false;
         arrayClear(variables.dryRunBuffer);
-        var lock = new cli.lucli.services.deploy.commands.LockCommands(cfg);
+        var lock = new modules.wheels.services.deploy.commands.LockCommands(cfg);
         $dispatchAny($allHosts(cfg), lock.status(), dryRun);
         return $renderResult(arguments.opts, "Checked deploy lock status for " & cfg.service());
     }