> 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/intro/release-history/whats-new-with-4.12.0.md).

# What's New With 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 dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter, and the optional `goal` query parameter:

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

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal.

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.