3.15.0

Upgrade Notes

Two changes can make code that compiled with 3.14.x fail to compile with 3.15.0.

The alias of the expansion directive is now validated at compile time (#1715)

The alias in /*%expand alias*/ is an expression, so a table alias must be a quoted string literal:

select /*%expand "e"*/* from EMPLOYEE e

An unquoted alias such as /*%expand e*/ is read as a variable. It used to compile and then fail when the query ran; it now fails to compile with DOMA4092. Quote the alias to fix it.

Auto-generated modifications report DOMA4501 instead of DOMA4002 (#1714)

@Insert, @Update and @Delete without an SQL file, and their batch variants, report DOMA4501 when the method has more than one parameter. The new message explains how to write the SQL statement yourself. Only the error code and message change; if your build or scripts match on DOMA4002 for these methods, update them.

What's Changed

New Features

• Support primitive arrays in IN lists and for directives (#1716) @nakamura-to, @claude

Bug Fixes

• Validate the alias expression of the expansion directive (#1715) @nakamura-to, @claude
• Explain how to fix a parameter count error on auto-generated modifications (#1714) @nakamura-to, @claude
• Switch MySQL JDBC driver to com.mysql:mysql-connector-j (#1705) @nakamura-to, @claude

Maintenance

• Let Renovate update the documentation's dependencies (#1721) @nakamura-to, @claude
• Manage the documentation's Python environment with uv (#1719) @nakamura-to, @claude
• Submit Gradle dependency graph for Dependabot alerts (#1704) @nakamura-to, @claude
• Remove CLAUDE.md files that only import AGENTS.md (#1691) @nakamura-to, @claude
• Pin the Gradle daemon JVM to Java 17 with Daemon JVM criteria (#1690) @nakamura-to, @claude

Documentation

• Update tested database versions and add an AI coding agents section to README (#1724) @nakamura-to, @claude
• Fix cross-references that break in the Japanese docs and build them with -W (#1720) @nakamura-to, @claude
• Warn that the ESCAPE clause must match the LIKE functions' escape character (#1718) @nakamura-to, @claude
• Point to doma-agent-bench from AGENTS.md and the release checklist (#1717) @nakamura-to, @claude
• Add essentials for writing Doma code to llms.txt (#1713) @nakamura-to, @claude
• docs: update README badges (#1702) @operagxsasha, @nakamura-to
• Add PR labeling guidance to AGENTS.md (#1689) @nakamura-to, @claude
• Update RELEASE_OPERATIONS.md to match the current release process (#1688) @nakamura-to, @claude

Dependency Upgrades

• Update documentation dependencies (major) (#1723) @renovate[bot], @nakamura-to
• Update documentation dependencies (#1722) @renovate[bot], @nakamura-to
• Update plugin doma-compile to v4.0.4 (#1711) @nakamura-to, @claude
• Update dependency com.oracle.database.jdbc:ojdbc11 to v23.26.4.0.0 (#1710) @renovate[bot]
• Update plugin jmh to v0.7.4 (#1709) @renovate[bot]
• Update dependency org.xerial:sqlite-jdbc to v3.54.1.0 (#1708) @renovate[bot], @nakamura-to
• Update gradle/actions action to v6.4.1 (#1707) @renovate[bot], @nakamura-to
• Update dependency ch.qos.logback:logback-classic to v1.6.6 (#1706) @renovate[bot]
• Update github/codeql-action digest to 9b32540 (#1703) @renovate[bot], @nakamura-to
• Update Gradle to v9.8.2 (#1701) @renovate[bot]
• Update github/codeql-action digest to 6f2ac81 (#1697) @renovate[bot], @nakamura-to
• Update release-drafter/release-drafter digest to 978bb0b (#1693) @renovate[bot], @nakamura-to
• Update actions/setup-java digest to b843ebf (#1700) @renovate[bot], @nakamura-to
• Update dependency com.microsoft.sqlserver:mssql-jdbc to v13.6.1.jre11 (#1699) @renovate[bot]
• Update org.jetbrains.kotlin to v2.4.21 (#1696) @renovate[bot]
• Update plugin spotless to v8.10.4 (#1698) @renovate[bot]
• Update dependency org.postgresql:postgresql to v42.7.14 (#1695) @renovate[bot]
• Update Gradle to v9.8.1 (#1694) @renovate[bot]
• Update actions/upload-artifact digest to cf430e0 (#1692) @renovate[bot], @nakamura-to

Full Changelog: 3.14.1...3.15.0