Skip to content

changelog.md

Latest commit

 

History

History
441 lines (304 loc) · 21 KB

changelog.md

File metadata and controls

441 lines (304 loc) · 21 KB

Changelog

All notable changes to this project will be documented in this file.

The format is based on Keep a Changelog, and this project adheres to Semantic Versioning.

Unreleased

8.13.0 - 2026-05-28

Fixed

  • coldbox create handler --boxlang / --noboxlang now propagates language selection to auto-generated views so view extensions match the requested mode (.bxm for BoxLang, .cfm for CFML)
  • coldbox create model --tests now prefixes the right location of the models
  • coldbox watch-reinit now honors server.json webroot-based server discovery so running apps in subdirectory webroots are correctly found and reinitialized

8.12.0 - 2026-05-11

Fixed

  • coldbox ai doctor and coldbox ai uninstall checking wrong directory
    • Both commands were checking for a .ai directory instead of .agents, causing them to always report "not installed" even after a successful coldbox ai install
    • AIService.diagnose() now uses the static.AI_DIR constant (.agents) instead of the hardcoded /.ai path
    • coldbox ai uninstall now correctly checks, removes, and references the .agents directory
  • coldbox ai skills add slug --list was not working.
  • coldbox ai skills remove reinstalling removed skills during refresh
    • When a skill was removed via coldbox ai skills remove, the subsequent agent config regeneration step (refresh()) would detect the skill as "missing" (because its module dependency was still present in box.json) and immediately reinstall it
    • Removed skills are now tracked in a new manifest.excludes[] array so that refresh() will never auto-reinstall them
    • Explicitly re-installing a previously excluded skill via coldbox ai skills install lifts the exclusion and restores normal auto-management

Added

  • VSCode Copilot MCP Mirroring
    • When Copilot is a configured agent, MCP server configuration is now mirrored to .vscode/mcp.json using the VSCode-specific schema ("servers" + "inputs": [])
    • Ensures GitHub Copilot agents in VSCode can discover MCP servers registered via coldbox ai mcp commands
    • .vscode/mcp.json is written alongside the root .mcp.json whenever generateMCPJson() runs (install, refresh, MCP add/remove)
  • coldbox ai skills list --json flag to output the skills manifest in JSON format for easier parsing in scripts and CI pipelines
  • coldbox ai skills update command to re-download and overwrite all installed registry skills with per-skill feedback and progress updates
  • coldbox ai skills update <name> command to re-download and overwrite a single installed registry skill by local name

Improvements

  • New progress bar when doing coldbox ai skills list --outdated to check for updates in the registry, providing better feedback during potentially long-running integrity checks

8.11.0 - 2026-04-28

Changed

  • GitHub Copilot migrated to AGENTS.md

    • GitHub Copilot agent configuration now uses AGENTS.md (shared with Codex and OpenCode) instead of .github/copilot-instructions.md
    • Follows the Agents.md standard now supported by GitHub Copilot
    • Provides a single source of truth for Copilot, Codex, and OpenCode agents
    • Existing .github/copilot-instructions.md files are not removed automatically; run coldbox ai refresh to write the updated location

  • AI Directory Structure Standardized

    • Renamed /.ai/ directory to /.agents/ to follow BoxLang skill repository conventions
    • All generated agent configurations, guidelines, and skills now use /.agents/ instead of /.ai/
    • Updated all internal code paths, CLI commands, and documentation to reference /.agents/
    • Ensures consistency with the .agents/skills/ directory naming used in BoxLang ecosystem

Added

  • Auto-Install Module Skills on Refresh

    • When a module is added to box.json, coldbox ai refresh now automatically detects and installs its corresponding skill from the registry
    • Mirrors the existing MCP server auto-detection behavior — ensures skills and servers are always in sync with project dependencies

  • Auto-Recovery of Missing Skills

    • coldbox ai refresh now detects and reinstalls any missing core skills (boxlang, coldbox, testbox, commandbox) that may have been lost
    • Previously, if a skill failed to reinstall, it would be removed from the manifest permanently; now it will be recovered on the next refresh

  • Improved coldbox ai skills install --list Command

    • The --list flag now accepts an optional slug parameter to pre-filter the interactive skill list
    • Examples:
      • coldbox ai skills install --list → show all available skills
      • coldbox ai skills install --list coldbox/skills → show only ColdBox skills
      • coldbox ai skills install --list coldbox/skills/coldbox-testing → show only testing category skills

  • .mcp.json Support

    • New file in project root to track registered MCP documentation servers for AI integration
    • Updated coldbox ai mcp commands to read/write from this file for consistent MCP server management
    • MCP server entries include name, url, description, and source (core, module, custom)
    • MCP servers registered via coldbox ai mcp add are now saved to .mcp.json in addition to the manifest for AI agent access

  • MCP Server Auto-Detection

    • During coldbox ai refresh, the CLI now auto-detects MCP documentation servers from installed modules and updates both the manifest and .mcp.json with any new servers found

  • ColdBox MCP Server Support

    • New coldbox ai mcp install command to install the cbMCP module and register it as a custom MCP server in the manifest and .mcp.json. The cbMCP module exposes your running ColdBox application as a live MCP server at http://<host>:<port>/cbmcp, allowing AI agents to introspect your routes, handlers, and models in real time. Supports --host, --port, and --force flags.

  • Pretty print saving of manifest on installation

Changed

  • Reduced agent file size

    • Core ColdBox/BoxLang guidelines are no longer inlined in generated agent files. Guidelines are stored locally in .ai/guidelines/core/ and referenced via read_file instructions — reducing generated agent files from ~1,000 lines to ~250 lines

  • Skills inventory grouped by category

    • Skills in agent files are now organized by prefix (ColdBox, BoxLang, TestBox, CommandBox, etc.) with 80-character truncated descriptions for faster agent scanning

  • Cleaner project documentation section

    • The user-editable section in generated agent files now shows 3 focused TODO comment lines instead of 8 empty placeholder headings

  • Core guideline files slimmed

    • Full implementation examples removed from coldbox.md, boxlang.md, and cfml.md — each now ends with a skills-reference note directing agents to implementation-detail skills

  • Post-install project context reminder

    • coldbox ai install now prominently reminds users to add their project context (business domain, key services, auth, API endpoints, etc.) to the generated agent file

8.10.1 - 2026-04-15

Fixed

  • Corruption of box.json on build process overlapping

8.10.0 - 2026-04-10

Added

  • Automatic app layout detection for code generation commands. The CLI now detects whether the project uses a modern layout (with app/ and public/ directories) or a flat layout, and automatically places generated files in the correct location (e.g., app/models vs models, app/handlers vs handlers, etc.).

8.9.0 - 2026-04-07

Updates

  • CLAUDE.md now contains @AGENTS.md to point Claude to the shared AGENTS.md file, avoiding duplicate content

Fixed

  • Fix fwreinit not recognizing webroot setting in server.json
  • Fixes for invalid commands in readmes and ai guideline.
  • Updated html helper guideline to reflect the new helper syntax and added more examples.

8.8.0 - 2026-03-12

  • Fix invalid aliases

8.7.0 - 2026-03-12

  • Command Aliases

8.6.0 - 2026-03-10

  • readPackageDescriptorRaw() fix

8.5.0 - 2026-03-09

Added

  • New ColdBox ASCII art banner when creating apps and using the app-wizard
  • Improved readme and help commands
  • Name question in app-wizard if not provided
  • Install bx-compat-cfml when doing --rest due to needing some CFML compatibility
  • New help and consistency on all help commands

AI Integration - Complete System

Complete AI-powered development assistant for ColdBox with 41 guidelines, 62 skills, 30+ MCP documentation servers, and support for 6 AI agents (Claude, Copilot, Cursor, Codex, Gemini, OpenCode).

Core Commands
  • coldbox ai install - Set up AI integration with agent selection and language detection
  • coldbox ai refresh - Sync guidelines, skills, and MCP servers with installed modules
  • coldbox ai info - Display current AI configuration
  • coldbox ai doctor - Diagnose AI integration health with detailed reporting
Guidelines System (41 Total)
  • Core Guidelines (10): boxlang, cfml, coldbox, coldbox-cli, cachebox, wirebox, logbox, testbox, testbox-cli, docbox
  • Security & Auth (6): cbsecurity, cbauth, cbsecurity-passkeys, cbsso, cbcsrf, cbantisamy
  • Validation & Data (6): cbvalidation, cbi18n, cbmailservices, cbmessagebox, cbpaginator, cbfeeds
  • ORM & Database (4): cborm, qb, quick, cfmigrations
  • API & Integration (5): hyper, cbproxies, cbswagger, cbelasticsearch, s3sdk
  • Utility & Development (8): cbdebugger, cbfs, cbstorages, stachebox, cbjavaloader, cbmarkdown, cbmockdata, docbox
  • Modern Development (6): cbwire, cbq, socketbox, mementifier, unleashsdk, cbplaywright
  • Additional (7): bcrypt, cors, rulebox, commandbox-migrations, commandbox-boxlang, route-visualizer, relax
  • Guidelines commands: list, add, remove, create, override, refresh, help
Skills System (62 Total)
  • BoxLang Development (21): syntax, classes, functions, lambdas, modules, streams, types, interop, scheduled-tasks, futures, http-client, soap-client, executors, jdbc, templating, caching, file-handling, properties, zip, interceptors, sse, components, application
  • ColdBox Development (12): handler-development, rest-api-development, module-development, interceptor-development, layout-development, routing-development, event-model, view-rendering, cache-integration, coldbox-configuration, coldbox-request-context, coldbox-flash-messaging
  • Testing (8): testing-bdd, testing-unit, testing-integration, testing-handler, testing-mocking, testing-fixtures, testing-coverage, testing-ci
  • Internal Libraries (3): cachebox-caching-patterns, logbox-logging-patterns, wirebox-di-patterns
  • Security (9): security-implementation, authentication, authorization, sso-integration, jwt-development, passkeys-integration, csrf-protection, api-authentication, rbac-patterns
  • ORM & Database (5): cborm, qb (query-builder), orm-quick, boxlang-queries, database-migrations
  • Modern Development (1): cbwire-development
  • Skills commands: list, create, override, refresh, remove, help
MCP Server Integration (30+ Servers)
  • Core Servers (7): boxlang, coldbox, commandbox, testbox, wirebox, cachebox, logbox - always included
  • Module Servers (23): bxorm, cborm, qb, quick, cfmigrations, cbsecurity, cbauth, cbsso, cbvalidation, cbi18n, cbmailservices, cbdebugger, cbelasticsearch, cbfs, cfconfig, cbwire, cbq, megaphone, contentbox, docbox, relax (cbswagger), modern-cfml, boxlang-ide
  • Auto-detection from box.json dependencies with zero configuration
  • Custom MCP server support for company/internal documentation
  • MCP commands: list, add, remove, help
Multi-Agent Support (6 Agents)
  • Supported Agents: Claude (CLAUDE.md), GitHub Copilot (AGENTS.md, shared), Cursor (.cursorrules), Codex (AGENTS.md), Gemini (GEMINI.md), OpenCode (AGENTS.md)
  • Layout-specific templates (modern, flat)
  • Project context detection (Vite, Docker, ORM, Migrations)
  • Agents commands: list, add, remove, active, open
Override System
  • Guidelines Override: coldbox ai guidelines override <name> - Customize any guideline with project-specific conventions
  • Skills Override: coldbox ai skills override <name> - Override core/module skills with project-specific patterns
  • Override files stored in .ai/guidelines/overrides/ and .ai/skills/overrides/
  • List commands show overrides separately with 🎯 icon
  • Remove commands support --override flag for targeted removal
  • Template-based override creation (copies original + adds override header)
  • Priority system: override > core/module
Module Integration
  • Zero-config auto-discovery from box.json dependencies
  • Module creation with --ai flag creates .ai/guidelines and .ai/skills directories
  • Three-tier guideline fallback: module-shipped → bundled templates → auto-generated
  • Auto-registers MCP servers for installed modules
  • Path consistency: always uses .ai/ convention (not resources/)
Language Support
  • BoxLang and CFML project detection
  • Hybrid project support
  • Language-specific skill variants
  • Code generation respects project language choice

8.4.0 - 2025-12-15

Added

  • Make sure commandbox-boxlang is a dependency to detect BoxLang projects

Fixed

  • Creation of bx classes when --boxlang is used was missing from handler creation
  • App generation install tweaks to avoid path issues by @gpickin
  • Fix on copying files starting with a dot, like .babelrc for vite support, which is ignored by default by git ignores.

8.3.0 - 2025-12-08

Added

  • More Modern CFML template support

8.2.0 - 2025-11-11

Added

  • Missing rest resources for the boxlang template

Fixed

  • Cleanup for vite resources only if vite is not selected

8.1.0 - 2025-10-22

Changed

  • docker argument to create app was supposed to be false by default, not true

Fixed

  • Docker ignore issues
  • App env sample ignore issues

8.0.0 - 2025-10-13

Added

  • Forgot to bump it to match ColdBox version.

7.10.0 - 2025-10-10

Added

  • Modules Inherit Entry Point defaults to true now
  • Brand new app-wizard for creating apps interactively
  • fix colors for ps screens
  • BoxLang is now the default engine for new apps
  • Updated all new templates from repos
  • New create app argument for modern or boxlang skeletons: vite to create a Vite enabled app: coldbox create app name="myApp" --vite
  • New create app argument for modern or boxlang skeletons: rest to create a REST enabled app: coldbox create app name="myApp" --rest
    • New create app argument for modern or boxlang skeletons: docker to create a Docker enabled app: coldbox create app name="myApp" --docker
  • New create app argument for modern or boxlang skeletons: migrations to create a Migrations enabled app: coldbox create app name="myApp" --migrations
  • New --cfml argument to create a CFML app: coldbox create app name="myApp" --cfml instead of BoxLang (app is default)
  • BoxLang template skeleton rename
  • Updated docs for BoxLang detection

7.8.0 - 2025-09-29

Added

  • Copilot instructions for AI coding assistance
  • If the skeleton is default and this is a BoxLang project, it will switch the skeleton to BoxLang.
  • added dependabot
  • Moved testbox-cli and commandbox-migrations to dependencies so we can use them in the CLI commands

7.7.0 - 2025-04-29

Fixed

  • More fixes for boxlang arguments

7.6.0 - 2025-04-28

Added

  • New modern template for creating modern apps with the latest features
  • New boxlang template for creating apps with the latest boxlang features
  • Modernization of all templates to use the latest features of ColdBox
  • New --boxlang argument to create content for BoxLang
  • New language argument detection for BoxLang

Changed

  • Updated to the latest Ubuntu images for the GitHub actions

Fixed

  • Fixed resource handler creation.

7.5.0 - 2024-10-16

Fixed

  • watch reinit issues with coldbox watch command
  • key [TEMPLATEPATH] doesn't exist when doing orm operations. This was a typo, it should have been templatesPath

7.4.0 - 2024-03-20

Fixed

  • Create resources missing open param

Added

  • More documentation

7.3.0 - 2024-02-12

Added

  • New github actions
  • Lazy load testbox-cli, commandbox-migrations only when used.

7.2.1 - 2023-05-19

Fixed

  • Fixed coldbox create layout failing due to unescpaed #view()# command

7.2.0 - 2023-05-18

Added

  • New version of CommandBox Migrations
  • Added testbox-cli as a dependency

7.1.0 - 2023-05-18

Added

  • BaseCommand hierarchy for all commands to inherit from
  • New print functions for uniformity of info, warning, success and error messages
  • New coldbox create service command to create services easily
  • Create model with migration now actually generates the property migrations
  • Create coldbox create model --service to create a model with a service
  • Create coldbox create model --all to create a model with a service and all the things

Fixed

  • Version should match major ColdBox version, moved to 7
  • Fixed coldbox create app command to finalize the create app job
  • Set default location to forgeboxStorage for new apps, this was missing
  • coldbox create handler was not creating the views
  • Models isLoaded() was actually wrong
  • Handler test specs carriage returns
  • When creating models with rest or resources, the handler was not being created

1.0.0 - 2023-05-03

Added

  • Migration from CommandBox core to a separate module
  • Updated all templates to ColdBox 7
  • Updated all resources to ColdBox 7 standard code
  • Add --force command to several commands for overwriting files
  • Create app new argument: migrations to init the migrations on the project: coldbox create app name="myApp" --migrations
  • create view command now has an open attribute to open the created views in the editor
  • You can create layouts with content now: create layout name="myLayout" content="my content"
  • You can create views with content now: create view name="myView" content="my content"
  • You can create resourceful handlers: create handler name="myHandler" --resource
  • You can create resourceful rest handlers: create handler name="myHandler" --resource --rest
  • You can create models with migrations now: create model name="myModel" --migration
  • You can create models with seeders now: create model name="myModel" --seeder
  • You can create models with handlers (normal or rest) now: create model name="myModel" --handler or create model name="myModel" --handler --rest
  • You can create models with a resource handler now: create model name="myModel" --resource
  • You can create models will all the things now: create model name="myModel" --all
  • New coldbox docs command to open the ColdBox docs in your browser and search as well: coldbox docs search="event handlers"
  • New coldbox apidocs command to open the ColdBox API Docs in your browser.

Fixed

  • Was resetting the scripts in the templates, which is not needed

Removed

  • Eclipse support