Skip to content

Expose publish outcomes and explicit worker attempt boundaries - #39

Merged
elpete merged 13 commits into
mainfrom
feat/observability-hooks
Oct 4, 2026
Merged

elpete merged 13 commits into
mainfrom
feat/observability-hooks

Conversation

@elpete

@elpete elpete commented Oct 4, 2026 •

Copy link
Copy Markdown
Contributor

Observability integrations can observe publish results and each immutable execution attempt, establish context on the actual worker, and restore it when that worker exits. Completion callbacks carry the same execution ID even when a timeout finishes before the worker exits.

Observer failures and the existing recovery diagnostics now use a shared LogBox warning path with a short stderr fallback if logging also fails. All seven empty catches in the models are removed. Diagnostic failures preserve enqueue results, job outcomes, terminal-failure attempts, and completion-hook cleanup.

CFFormat 0.22.1 was reproduced adding a space before unquoted struct-key colons on each pass. CI pins the stable 0.21.0 version and checks formatting without creating automatic commits, preventing the repeated workflow approval cycle. The four affected files have been normalized.

The asynchronous observation test converts the concurrent Java queue snapshot to a CFML array before using member functions. SQL compilation tests use an isolated provider so PostgreSQL/SQL Server builders never leak into database teardown.

Validation: both push and pull-request workflows pass at 89fb36a. Each of Lucee 5, Lucee 6, Adobe 2021, Adobe 2023, and Adobe 2025 reports 103 passed, zero failures/errors, and one existing skip. Both formatting jobs pass. Locally, the two affected suites pass 13/13 on Lucee 6.2.8.20 and Adobe 2023.0.25+330977; the six queue observation specs also pass on BoxLang 1.18.0. All 57 project files pass formatting, two successive formatter passes are stable, and an unformatted directory fixture is rejected.

The preview supports the Sentry observability integration. BoxLang full-suite compatibility and the comprehensive Sentry acceptance scenarios remain separate verification boundaries.

Documentation: ortus-docs/cbq-docs#1 covers the six new hooks, statuses, context propagation and restoration, timeout ordering, idempotent completion, diagnostics, and CFML/native BoxLang examples. The docs are marked unreleased.

A separate follow-up, #40, covers publish-result observations for the final partial bulk chunk. That correction is not part of this merged PR or release 7.0.1; the documentation states the coverage boundary.

@elpete
elpete changed the base branch from next to main October 4, 2026 09:15
@elpete
elpete merged commit ff37570 into main Oct 4, 2026
13 checks passed
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant