> For the complete documentation index, see [llms.txt](https://coldbox-orm.ortusbooks.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://coldbox-orm.ortusbooks.com/v5.x/intro/release-history/whats-new-with-4.12.0.md).

# What's New With 4.12.0

What's new in CBOrm 4.12.0

CBOrm 4.12.0 is a minor release focused on BoxLang Prime compatibility, code quality improvements, and bug fixes.

## Added

### CI/CD Enhancements

* **Manual Workflow Dispatch**: Added `workflow_dispatch` trigger to cron.yml, allowing manual execution of scheduled workflows for testing and debugging

### BoxLang Runtime Compatibility

* **BoxLang-Only Runtime Support**: Added duplicate ORM settings specifically for BoxLang-only runtime environments where compatibility module aliases aren't available

### Code Quality

* **Full Var Scoping**: Implemented comprehensive var scoping throughout the codebase to eliminate IDE warnings and improve code clarity

## Fixed

### Critical Bug Fixes

* [**BOX-163**](https://ortussolutions.atlassian.net/browse/BOX-163): Fixed critical dead code bug in `entityGivenName` method of `ORMUtilSupport.cfc` where the Hibernate result wasn't being returned, causing `null` errors

```javascript
// Before (broken):
try {
    var entityName = getSession(...).getEntityName(entity);
} catch (org.hibernate.TransientObjectException e) {
    // Falls through without returning entityName
}

// After (fixed):
try {
    return getSession(...).getEntityName(entity);
} catch (org.hibernate.TransientObjectException e) {
    // Falls through to metadata discovery
}
```

### BoxLang Prime Compatibility

* **Defensive Coding for BoxLang Prime**: Added extensive null checks and defensive programming patterns to ensure smooth operation with BoxLang Prime
* **ACF Isolation**: Moved CFIDE EventHandler interface reference to `ACFEventHandler` for better separation of Adobe-specific code
* **Interface Annotation Removal**: Dropped ACF-only interface annotations that caused compatibility issues with BoxLang Prime
* **Server.ColdFusion Blocks**: Added defensive coding around `server.coldfusion` checks for cross-engine compatibility

### Testing Infrastructure

* **BoxLang CFML Compatibility**: Updated to use `@be` tag for `bx-compat-cfml` in BoxLang server tests for better compatibility layer testing

{% hint style="warning" %}
If you were experiencing `null` errors when calling entity name operations, especially with transient entities, this release fixes that critical issue.
{% endhint %}

## Release Date

November 7, 2025


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation by asking a question.

Perform an HTTP GET request on the following URL with the `ask` and `goal` query parameters:

```
GET https://coldbox-orm.ortusbooks.com/v5.x/intro/release-history/whats-new-with-4.12.0.md?ask=<question>&goal=<user_goal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is what the user is ultimately trying to achieve, the reason they need the answer. Sharing it helps GitBook give you a better, more relevant answer. A goal is most helpful when it describes the outcome the user wants rather than restating the question. For example, with `ask=how do I create an API token`, a goal like `automate deployments from our CI pipeline` lets GitBook tailor the answer to that use case.

The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.