fix(view): show <rootversion>-dev and detect non-repo CLI installs on homepage (#2272)

Resolves #2255. When $readFrameworkVersion() detects an unreplaced
@build.version@ placeholder, it now peeks at the enclosing repo's root
box.json. If that box.json identifies the wheels-dev/wheels monorepo
(slug "wheels" or name "Wheels.fw"), the helper returns
"<rootversion>-dev" so the homepage surfaces the upcoming version.
Vendored installs and any other hosting context still fall back to
"0.0.0-dev".

Resolves #2259. congratulations.cfm's CLI detection no longer relies
solely on the monorepo-only path /cli/lucli/Module.cfc. It additionally
probes ~/.CommandBox/cfml/modules/wheels-cli/ModuleConfig.cfc,
~/.lucli/lucli, and ~/.lucli/bin/lucli so CommandBox and LuCLI installs
are recognized too. FileExists-only; no cfexecute.

frameworkVersionSpec extended with four new cases covering the
monorepo-detection branch, the vendored-install fallback, the
both-placeholder fallback, and the missing-enclosing-box.json
fallback. Full core suite: 3306 pass, 0 fail, 0 error, 16 skip.

Author: bpamiri

vendor/wheels/Global.cfc

@@ -2753,7 +2753,7 @@ return local.$wheels;
 		return local.rv;
 	}
 
-	public string function $readFrameworkVersion(string boxJsonPath = "") {
+	public string function $readFrameworkVersion(string boxJsonPath = "", string rootBoxJsonPath = "") {
 		local.path = Len(arguments.boxJsonPath)
 			? arguments.boxJsonPath
 			: GetDirectoryFromPath(GetCurrentTemplatePath()) & "box.json";
@@ -2782,6 +2782,33 @@ return local.$wheels;
 			);
 		}
 		if (local.box.version == "@build.version@") {
+			// Dev checkout. Try to synthesize a more useful version by reading the
+			// enclosing repo's root box.json — when that box.json identifies itself as
+			// the wheels-dev/wheels monorepo, report "<rootversion>-dev" so the
+			// homepage shows the upcoming version rather than a blank placeholder.
+			local.rootPath = Len(arguments.rootBoxJsonPath)
+				? arguments.rootBoxJsonPath
+				: GetDirectoryFromPath(GetCurrentTemplatePath()) & "../box.json";
+			try {
+				if (FileExists(local.rootPath)) {
+					local.rootBox = DeserializeJSON(FileRead(local.rootPath));
+					local.isWheelsRepo = IsStruct(local.rootBox)
+						&& (
+							(StructKeyExists(local.rootBox, "slug") && local.rootBox.slug == "wheels")
+							|| (StructKeyExists(local.rootBox, "name") && local.rootBox.name == "Wheels.fw")
+						);
+					if (
+						local.isWheelsRepo
+						&& StructKeyExists(local.rootBox, "version")
+						&& Len(local.rootBox.version)
+						&& local.rootBox.version != "@build.version@"
+					) {
+						return local.rootBox.version & "-dev";
+					}
+				}
+			} catch (any e) {
+				// fall through to the plain dev sentinel
+			}
 			return "0.0.0-dev";
 		}
 		return local.box.version;

vendor/wheels/public/views/congratulations.cfm

@@ -11,8 +11,23 @@
 	local.dbName = application.wheels.dataSourceName;
 	local.environment = get("environment");
 
-	// CLI detection
+	// CLI detection — best-effort across install vectors:
+	//   1. Monorepo dev checkout (CLI source is in-tree)
+	//   2. CommandBox module install (`box install wheels-cli`)
+	//   3. LuCLI install (Homebrew, Chocolatey, or direct download)
 	local.hasCLI = FileExists(ExpandPath("/cli/lucli/Module.cfc"));
+	if (!local.hasCLI) {
+		try {
+			local.userHome = CreateObject("java", "java.lang.System").getProperty("user.home");
+			local.hasCLI = Len(local.userHome) && (
+				FileExists(local.userHome & "/.CommandBox/cfml/modules/wheels-cli/ModuleConfig.cfc")
+				|| FileExists(local.userHome & "/.lucli/lucli")
+				|| FileExists(local.userHome & "/.lucli/bin/lucli")
+			);
+		} catch (any e) {
+			// best-effort — if home dir is unavailable, fall back to "not detected"
+		}
+	}
 
 	// OS detection for install tab pre-selection
 	local.osName = server.os.name;

vendor/wheels/tests/specs/events/frameworkVersionSpec.cfc

@@ -35,6 +35,56 @@ component extends="wheels.WheelsTest" {
 				}
 			});
 
+			it("$readFrameworkVersion synthesizes <rootversion>-dev when placeholder is detected inside the wheels monorepo", () => {
+				var fwTmp = getTempDirectory() & "wheels-version-fw-#CreateUUID()#.json";
+				var rootTmp = getTempDirectory() & "wheels-version-root-#CreateUUID()#.json";
+				fileWrite(fwTmp, '{"version":"@build.version@"}');
+				fileWrite(rootTmp, '{"name":"Wheels.fw","slug":"wheels","version":"4.0.0"}');
+				try {
+					expect(g.$readFrameworkVersion(fwTmp, rootTmp)).toBe("4.0.0-dev");
+				} finally {
+					fileDelete(fwTmp);
+					fileDelete(rootTmp);
+				}
+			});
+
+			it("$readFrameworkVersion falls back to 0.0.0-dev when the enclosing box.json is not the wheels monorepo (vendored install)", () => {
+				var fwTmp = getTempDirectory() & "wheels-version-fw-#CreateUUID()#.json";
+				var rootTmp = getTempDirectory() & "wheels-version-root-#CreateUUID()#.json";
+				fileWrite(fwTmp, '{"version":"@build.version@"}');
+				fileWrite(rootTmp, '{"name":"SomeUserApp","slug":"user-app","version":"2.1.0"}');
+				try {
+					expect(g.$readFrameworkVersion(fwTmp, rootTmp)).toBe("0.0.0-dev");
+				} finally {
+					fileDelete(fwTmp);
+					fileDelete(rootTmp);
+				}
+			});
+
+			it("$readFrameworkVersion falls back to 0.0.0-dev when the enclosing box.json is also unreplaced", () => {
+				var fwTmp = getTempDirectory() & "wheels-version-fw-#CreateUUID()#.json";
+				var rootTmp = getTempDirectory() & "wheels-version-root-#CreateUUID()#.json";
+				fileWrite(fwTmp, '{"version":"@build.version@"}');
+				fileWrite(rootTmp, '{"name":"Wheels.fw","slug":"wheels","version":"@build.version@"}');
+				try {
+					expect(g.$readFrameworkVersion(fwTmp, rootTmp)).toBe("0.0.0-dev");
+				} finally {
+					fileDelete(fwTmp);
+					fileDelete(rootTmp);
+				}
+			});
+
+			it("$readFrameworkVersion falls back to 0.0.0-dev when the enclosing box.json is missing", () => {
+				var fwTmp = getTempDirectory() & "wheels-version-fw-#CreateUUID()#.json";
+				var missingRoot = getTempDirectory() & "wheels-version-missing-#CreateUUID()#.json";
+				fileWrite(fwTmp, '{"version":"@build.version@"}');
+				try {
+					expect(g.$readFrameworkVersion(fwTmp, missingRoot)).toBe("0.0.0-dev");
+				} finally {
+					fileDelete(fwTmp);
+				}
+			});
+
 			it("$readFrameworkVersion throws Wheels.VersionReadFailed when the file is missing", () => {
 				var missing = getTempDirectory() & "wheels-version-missing-#CreateUUID()#.json";
 				var threw = false;