fix(cli): legacy wheels g app defaults to 4.0 template + deprecation banner (#2227) (#2236)

Legacy CommandBox `wheels g app` defaulted to `wheels-base-template@^3.1.0`,
so at 4.0 GA `box install wheels-cli && wheels g app foo` produced a 3.x
scaffold. Docstring also falsely claimed "Default is Bleeding Edge".

Changes in cli/src/commands/wheels/generate/app.cfc:
- Default template `@^3.1.0` -> `@^4.0.0` (line 71)
- `WheelsBaseTemplate` shortcut mapping `@^3.1.0` -> `@^4.0.0` (line 46)
- Docstring fix: reflect actual (stable 4.0) default
- Block-comment entry updated to "4.0 Stable (default)"
- Deprecation banner printed at start of run(), pointing users at LuCLI
  `wheels new`, noting v5.0 removal

Also fixes the same bug in app-wizard.cfc (line 159): the pre-selected
menu entry was pinned to `@^3.1.0`. Because the wizard delegates to
`wheels g app`, leaving this untouched would bypass the fix above when
users accept the default selection.

CHANGELOG entries added under [Unreleased] `### Deprecated` (removal in
v5.0) and `### Fixed` (the 4.0 default).

Closes #2227

Author: bpamiri

CHANGELOG.md

@@ -131,6 +131,7 @@ All historical references to "CFWheels" in this changelog have been preserved fo
 - RocketUnit test style for new tests — BDD syntax (via WheelsTest) is required going forward. Existing RocketUnit specs continue to run. (#1925)
 - `wheels.Test` test base class — extend `wheels.WheelsTest` instead (#1889)
 - In-dev-server HTTP MCP endpoint at `/wheels/mcp` — superseded by the LuCLI stdio MCP server (`wheels mcp wheels`). Emits a deprecation warning to the `wheels_mcp` log on first request and advertises `deprecated: true` in the `serverInfo` handshake. Scheduled for removal in a future release. Migrate existing projects with `wheels mcp setup --force`.
+- Legacy CommandBox `wheels-cli` module (`wheels g app`, `wheels new` via the CommandBox wizard) — superseded by LuCLI's canonical `wheels new`. Emits a deprecation banner on every invocation. Scheduled for removal in v5.0. (#2227)
 
 ### Removed
 
@@ -142,6 +143,7 @@ All historical references to "CFWheels" in this changelog have been preserved fo
 
 ### Fixed
 
+- Legacy CommandBox `wheels g app` now scaffolds a 4.0 app by default — the `wheels-base-template` default was pinned at `@^3.1.0`, so `box install wheels-cli && wheels g app myapp` produced a 3.x scaffold at 4.0 GA. Updated default (and the `WheelsBaseTemplate` shortcut + wizard default selection) to `@^4.0.0`, fixed the stale "Default is Bleeding Edge" docstring, and added a deprecation banner pointing users at LuCLI's `wheels new`. (#2227)
 - `changeColumn` on SQLite now works by implementing the SQLite-standard recreate-table pattern in `SQLiteMigrator`. Previously, SQLite migrations inherited MySQL's `ALTER TABLE ... CHANGE` syntax from `Abstract.cfc` and failed with `near "CHANGE": syntax error`. The migrator's `$execute` now accepts an array of statements so adapters can return multi-step DDL. v1 limitations: foreign-key constraints declared inline on `CREATE TABLE` and triggers are not preserved across the recreate. (#2207)
 - Framework-internal browser-test fixture controllers, views, and the `/_browser/*` routes no longer leak into application-level files. Moved from `app/controllers/BrowserTest*.cfc`, `app/views/browsertest*/`, and `config/routes.cfm` into `vendor/wheels/public/browser-fixtures/`, auto-mounted by `$lockedLoadRoutes` when environment is `testing` or `development` and the new opt-in setting `loadBrowserTestFixtures=true` is set. Apps upgrading from a 4.0 snapshot that had custom `/_browser/*` routes must opt in explicitly or re-declare them in `config/routes.cfm`. (#2135, #2138)
 - Stray `app/mailers/UserNotificationsMailer.cfc` demo removed from the framework repo root (byte-identical copies remain in the example apps under `examples/tweet/` and `examples/starter-app/`). (#2138)

cli/src/commands/wheels/generate/app-wizard.cfc

@@ -156,7 +156,7 @@ component aliases="wheels g app-wizard, wheels new" extends="../base" {
 
     var template = multiselect( 'Which Wheels Template shall we use? ' )
       .options( [
-        {value: 'wheels-base-template@^3.1.0', display: '3.1 - Wheels Base Template - Stable', selected: true},
+        {value: 'wheels-base-template@^4.0.0', display: '4.0 - Wheels Base Template - Stable', selected: true},
         {value: 'wheels-base-template@BE', display: 'Bleeding Edge - Wheels Base Template'},
         {value: 'wheels-template-htmx-alpine-simple', display: 'Wheels Template - HTMX - Alpine.js - Simple.css'},
         {value: 'wheels-starter-app', display: 'Wheels Starter App'},

cli/src/commands/wheels/generate/app.cfc

@@ -14,7 +14,7 @@
  *  {code}
  *
  *  Here are the basic templates that are available for you that come from ForgeBox
- *  - Wheels Base Template - 3.0 Stable (default)
+ *  - Wheels Base Template - 4.0 Stable (default)
  *  - Wheels Base Template - Bleeding Edge
  *  - Wheels Template - HelloWorld
  *  - Wheels Template - HelloDynamic
@@ -43,7 +43,7 @@ component aliases="wheels g app" extends="../base" {
 
     // Map these shortcut names to the actual ForgeBox slugs
     variables.templateMap = {
-      'WheelsBaseTemplate'        : 'wheels-base-template@^3.1.0',
+      'WheelsBaseTemplate'        : 'wheels-base-template@^4.0.0',
       'BleedingEdge'              : 'wheels-base-template@BE',
       'WheelsTemplateHTMX'        : 'wheels-template-htmx-alpine-simple',
       'WheelsStarterApp'          : 'wheels-starter-app',
@@ -55,7 +55,7 @@ component aliases="wheels g app" extends="../base" {
 
   /**
    * @name           The name of the app you want to create
-   * @template       The name of the app template to generate (or an endpoint ID like a forgebox slug). Default is Bleeding Edge
+   * @template       The name of the app template to generate (or an endpoint ID like a forgebox slug). Default is the stable Wheels Base Template (4.0).
    * @directory      The directory to create the app in
    * @reloadPassword The reload passwrod to set for the app
    * @datasourceName The datasource name to set for the app
@@ -68,7 +68,7 @@ component aliases="wheels g app" extends="../base" {
    **/
   function run(
     name     = 'MyApp',
-    template = 'wheels-base-template@^3.1.0',
+    template = 'wheels-base-template@^4.0.0',
     directory,
     reloadPassword = '',
     datasourceName,
@@ -86,6 +86,14 @@ component aliases="wheels g app" extends="../base" {
     // Initialize detail service
     var details = application.wirebox.getInstance("DetailOutputService@wheels-cli");
 
+    // Deprecation notice — legacy CommandBox surface is scheduled for removal in Wheels v5.0.
+    // Canonical 4.0+ CLI is LuCLI's `wheels new` (https://github.com/bpamiri/LuCLI).
+    details.getPrint().yellowBoldLine( "[DEPRECATED] 'wheels g app' (CommandBox wheels-cli) is deprecated." );
+    details.getPrint().yellowLine( "             Use LuCLI 'wheels new' instead — the canonical Wheels 4.0+ CLI." );
+    details.getPrint().yellowLine( "             Install: brew install lucli  (or see https://github.com/bpamiri/LuCLI)" );
+    details.getPrint().yellowLine( "             This command will be removed in Wheels v5.0." );
+    details.line();
+
     // set defaults based on app name
     if ( !len( arguments.directory ) ) {
       arguments.directory = '#getCWD()##arguments.name#';