style(model): condense review-flagged inline comments (#2852)

Address Reviewer A's comment-length nits: collapse the 8-line block in Model.cfc and the multi-line blocks in propertyCasePreservationSpec to single lines (CLAUDE.md one-line-comment guidance). Base.$lowerCaseColumnNames() keeps its docstring — it matches the existing $supportsAdvisoryLocks() convention, which both reviewers endorsed. The spec's adapter-name list is kept (deriving it from $lowerCaseColumnNames() needs a public model->adapter accessor that doesn't exist — getClass() isn't a model method and there is no $getAdapter()); reviewers flagged this as a non-blocking maintenance note.

Co-Authored-By: Claude Opus 4.8 <noreply@anthropic.com>
Signed-off-by: Peter Amiri <peter@alurium.com>

Author: bpamiri

vendor/wheels/Model.cfc

@@ -125,14 +125,7 @@ component output="false" displayName="Model" extends="wheels.Global"{
 			local.iEnd = local.columns.recordCount;
 			for (local.i = 1; local.i <= local.iEnd; local.i++) {
 				// set up properties and column mapping
-				//
-				// Preserve the database's reported column casing for the derived
-				// property name (so SQL Server / MySQL / SQLite keep `isHidden`),
-				// except on adapters whose database folds unquoted identifiers to
-				// a non-meaningful UPPERCASE default (Oracle, H2), where we
-				// lowercase to keep property names sane. Prior to 4.0 this was an
-				// unconditional lCase() that silently lowercased every
-				// auto-derived property on every engine.
+				// preserve the DB's reported column case; an unconditional lCase() here regressed non-Oracle engines in 3.0 (see $lowerCaseColumnNames)
 				local.columnName = local.columns["column_name"][local.i];
 				if (variables.wheels.class.adapter.$lowerCaseColumnNames()) {
 					local.columnName = lCase(local.columnName);

vendor/wheels/tests/specs/model/propertyCasePreservationSpec.cfc

@@ -3,38 +3,17 @@ component extends="wheels.WheelsTest" {
 	function run() {
 		g = application.wo
 
+		// Regression for the 3.0-era force-lowercasing of auto-derived property names (#2852).
 		describe("Auto-derived property name casing", () => {
-			/*
-				Regression coverage for the 2.x -> 3.x property-casing change.
-
-				When a model declares no property() mappings, Wheels derives its
-				properties from the database column metadata. Up through the 2.x
-				line this preserved the column's original casing, so a column
-				named `isHidden` produced the property `isHidden`. A change in the
-				3.0 line (aimed at Oracle, whose driver reports columns in a fixed
-				case) began force-lowercasing ALL auto-derived property names, so
-				`isHidden` became `ishidden` on every engine — breaking
-				case-sensitive consumers of serialized model output.
-
-				Wheels now preserves the database's reported column casing, and
-				only lowercases on adapters whose database folds unquoted
-				identifiers to a non-meaningful uppercase default (Oracle, H2),
-				where lowercasing keeps property names sane.
-
-				`c_o_r_e_casepreservation` has an undeclared, mixed-case `isHidden`
-				column (see tests/populate.cfm).
-			*/
 			it("preserves the database column case for undeclared properties", () => {
+				// c_o_r_e_casepreservation has an undeclared, mixed-case `isHidden` column (see populate.cfm)
 				var names = g.model("CasePreservation").propertyNames();
 
-				// Databases that preserve the declared identifier case report
-				// `isHidden`; lower-folding (Postgres/CockroachDB) and
-				// upper-folding-then-lowercased (Oracle/H2) report `ishidden`.
+				// preserve-case engines report `isHidden`; lower/upper-folding engines report `ishidden`
 				var preservesCase = ListFindNoCase("SQLiteModel,MySQLModel,MicrosoftSQLServerModel", get("adapterName")) GT 0;
 				var expected = preservesCase ? "isHidden" : "ishidden";
 
-				// Case-sensitive membership check — the bug is invisible to a
-				// case-insensitive lookup, so ListFind (not ListFindNoCase).
+				// case-sensitive: the regression is invisible to ListFindNoCase
 				expect(ListFind(names, expected)).toBeGT(0);
 			});
 		});