Merge branch 'development'

Author: lmajano

.github/copilot-instructions.md

@@ -0,0 +1,54 @@
+# ColdBox CLI - AI Coding Instructions
+
+This is a CommandBox module providing CLI commands for ColdBox framework development. It generates scaffolded code for handlers, models, views, tests, and complete applications with support for both CFML and BoxLang.
+
+## Architecture & Key Components
+
+**Command Structure**: Commands follow CommandBox's hierarchical structure in `/commands/coldbox/` with subcommands in nested folders (e.g., `create/handler.cfc`, `create/model.cfc`). Each command extends `BaseCommand.cfc` which provides common functionality like BoxLang detection and standardized print methods.
+
+**Template System**: Code generation uses text templates in `/templates/` with token replacement (e.g., `|handlerName|`, `|Description|`). Templates are organized by type and language:
+- `/templates/modules/cfml/` - CFML templates
+- `/templates/modules/bx/` - BoxLang templates
+- `/templates/crud/cfml/` vs `/templates/crud/bx/` - Language-specific variants
+
+**BoxLang Detection**: The `isBoxLangProject()` method in `BaseCommand.cfc` detects BoxLang projects via:
+1. Server engine detection (`serverInfo.cfengine` contains "boxlang")
+2. Package.json `testbox.runner` setting
+3. Package.json `language` property
+
+## Development Workflows
+
+**Command Development**:
+- New commands extend `BaseCommand.cfc` and use dependency injection (`property name="utility" inject="utility@coldbox-cli"`)
+- Use standardized print methods: `printInfo()`, `printError()`, `printWarn()`, `printSuccess()`
+- Commands support `--force` for overwriting and `--open` for opening generated files
+
+**Template Management**:
+- Templates use token replacement with `replaceNoCase(content, "|token|", value, "all")`
+- BoxLang conversion uses `toBoxLangClass()` to transform `component` to `class`
+- Resource generation supports both REST and standard handlers via template selection
+
+**Module Dependencies**: The module lazy-loads `testbox-cli` and `commandbox-migrations` via utility methods `ensureTestBoxModule()` and `ensureMigrationsModule()` only when needed.
+
+## Key Patterns & Conventions
+
+**File Generation Logic**: Commands typically:
+1. Resolve and validate paths using `resolvePath()`
+2. Read appropriate templates based on `--rest`, `--boxlang` flags
+3. Perform token replacements for customization
+4. Create directories if they don't exist
+5. Generate additional files (views, tests) based on flags
+
+**Cross-Component Integration**:
+- Models can generate handlers via `--handler` flag
+- Handlers can generate views via `--views` flag
+- Resource commands generate full CRUD scaffolding
+- Migration and seeder generation integrated with model creation
+
+**Error Handling**: Use `BaseCommand` print methods for consistent user feedback and check file existence before operations when `--force` is not specified.
+
+## Testing & Build
+
+**Build Process**: Uses `/build/Build.cfc` task runner with `box scripts` integration. Run `box build:module` for full build or `box format` for code formatting.
+
+**Template Testing**: The `/tests/` directory contains sample module structure for testing generated code patterns.

.github/dependabot.yml

@@ -0,0 +1,7 @@
+version: 2
+updates:
+  # GitHub Actions - updates uses: statements in workflows
+  - package-ecosystem: "github-actions"
+    directory: "/"                  # Where your .github/workflows/ folder is
+    schedule:
+      interval: "weekly"

.github/workflows/release.yml

@@ -50,7 +50,7 @@ jobs:
           fi
 
       - name: Update changelog [unreleased] with latest version
-        uses: thomaseizinger/keep-a-changelog-new-release@1.3.0
+        uses: thomaseizinger/keep-a-changelog-new-release@3.1.0
         if: env.SNAPSHOT == 'false'
         with:
           changelogPath: ./changelog.md
@@ -118,7 +118,7 @@ jobs:
           box forgebox publish --force
 
       - name: Create Github Release
-        uses: taiki-e/create-gh-release-action@v1.8.0
+        uses: taiki-e/create-gh-release-action@v1.9.1
         continue-on-error: true
         if: env.SNAPSHOT == 'false'
         with:
@@ -138,7 +138,7 @@ jobs:
     steps:
       # Checkout development
       - name: Checkout Repository
-        uses: actions/checkout@v3
+        uses: actions/checkout@v4
         with:
           ref: development
 
@@ -148,7 +148,7 @@ jobs:
           forgeboxAPIKey: ${{ secrets.FORGEBOX_TOKEN }}
 
       - name: Download build artifacts
-        uses: actions/download-artifact@v4
+        uses: actions/download-artifact@v5
         with:
           name: ${{ env.MODULE_ID }}
           path: .tmp

.github/workflows/snapshot.yml

@@ -28,7 +28,7 @@ jobs:
           cmd: run-script format
 
       - name: Commit Format Changes
-        uses: stefanzweifel/git-auto-commit-action@v5
+        uses: stefanzweifel/git-auto-commit-action@v6
         with:
           commit_message: Apply cfformat changes
 

LICENSE

@@ -0,0 +1,22 @@
+********************************************************************************
+Copyright Since 2005 ColdBox Framework by Luis Majano and Ortus Solutions, Corp
+www.coldbox.org | www.ortussolutions.com
+********************************************************************************
+ColdBox is open source. However, if you use this product please know that it is bound to the following License.
+If you use ColdBox, please make mention of it in your code or web site or add a Powered By Coldbox icon.
+
+Apache License, Version 2.0
+
+Copyright Since [2005] [Luis Majano and Ortus Solutions,Corp]
+
+Licensed under the Apache License, Version 2.0 (the "License");
+ you may not use this file except in compliance with the License.
+ You may obtain a copy of the License at
+
+ http://www.apache.org/licenses/LICENSE-2.0
+
+ Unless required by applicable law or agreed to in writing, software
+ distributed under the License is distributed on an "AS IS" BASIS,
+ WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+ See the License for the specific language governing permissions and
+ limitations under the License.