Release Changelog

This section contains release changelogs automatically generated from Conventional Commits by the CI/CD Finalize-Sprint pipeline.

Release History

Changelogs are organized by release version under changelog/{version}/. A new version folder is published each time a release branch is finalized.

Each release contains:

File Description

qa.adoc

Jira ticket references only (refs: commits). Use this for QA tracking and verification.

external.adoc

Customer-facing changes: Jira refs, features, bug fixes, documentation, and maintenance.

all.adoc

Complete changelog including every conventional commit type.

External Components in a Release

Beyond the generated files, every release page (changelog/{version}/index.adoc) carries a hand-maintained External components in this release section: the versions of the third-party products this release was built and verified against — the base image, the application framework and the XMPP transport library.

That section is written by hand because the generated files cannot produce it: they are derived from commit messages, and a dependency that did not change in a sprint leaves no commit behind while still being part of what the release was verified against.

The current values live in Third-Party Components and are copied into the release page when the release is cut.

Once a release is published, those same third-party versions — and the versions of every other FT service shipped alongside — also appear on FT Version Control, together with the upgrade steps between releases. That page is the platform-wide record across services; the section here describes only what this branch is built against right now.

Add the section to changelog/{version}/index.adoc only. qa.adoc, external.adoc and all.adoc are regenerated in full by the Finalize-Sprint pipeline, and anything hand-written in them is lost on the next run.

Current values

What this branch is built and verified against right now, and the set that gets copied into the first release page when a release is cut. It describes the current state of the branch — not a released version.

Component Version Notes

Java

25

Language level and runtime (pom.xml)

Spring Boot

3.5.6

Web UI, REST API and Swagger UI (pom.xml)

Smack

4.1.9

XMPP transport for Connection Requests (pom.xml, smack.version)

Base image

eclipse-temurin:25-jre-alpine

Runtime image the emulator is built from (Dockerfile)

Docker Engine / Compose

20.10+ / 2.0+

Recommended deployment method

ACS

external, tracked with the platform release

The emulator connects outbound to it and accepts Connection Requests from it

The emulator needs no database, no cache and no message broker of its own, so nothing else belongs in this table.

Changelog Format

Entries are derived from the commit message prefix:

Prefix Section

feat

Features

fix

Bug Fixes

perf

Performance

docs

Documentation

refactor

Refactoring

chore

Maintenance

refs: DEV-XXXX

Jira References (rendered as clickable links)

Example commit messages:

feat(single): add a live log viewer to Single Emulator Mode
fix(cr): report the configured CONNECTION_REQUEST_HOST instead of the container address
docs(installation): document the compose deployment
refs: DEV-2460

Releases