chore(release): cut 1.0.0-beta04

[darkryh]

Cuts 1.0.0-beta04. Version pins move together, as in the beta03 cut: gradle.properties (what release-library.yml publishes), the README and docs snippets, the initializr default, and the sample + consumer-smoke consumer builds.

What this release carries

Katalyst has a shutdown lifecycle. It had StartupHook and ReadyHook and nothing on the way down, so it closed the connection pool with application background work still running — the polling loops and consumers ReadyHook's own KDoc invites. Every such shutdown ended in:

SQLSTATE(08006) / java.net.SocketException: Socket closed
IllegalStateException: No transaction manager for db ExposedDatabase[...](null)

• ShutdownHook is the missing half, and it suspends — Katalyst awaits it, so a worker can cancelAndJoin() and be genuinely finished before anything is taken away. Ktor's ApplicationStopping subscribers are synchronous and can only ever signal a worker, never join it.
• Teardown moves to ApplicationStopped. Katalyst subscribes before start() while an application's KtorModules subscribe during it, so Katalyst was always first in the handler list and the documented, Ktor-native way to stop a worker was guaranteed to run too late. Applications using that idiom are fixed without changing a line.
• The pool gets a bounded moment to go quiet before it closes, covering work that was cancelled but not joined. If it expires, a WARN names how many connections are still checked out — the signal that some background work needs a ShutdownHook.
• KatalystFeature.onShutdown(context) — the same gap one level up.
• LifecycleHook now carries id/order for all three hook interfaces.

The defect was present since at least alpha10 and is not a beta03 regression — verified by reproducing it identically on beta02 and beta03.

Breaking (pre-1.0)

ReadyHook and StartupHook lose their own getId/getOrder (and their DefaultImpls) to LifecycleHook. Source-compatible; binary-breaking for already-compiled hook implementors, so consumers recompile.

Validated on this commit

• full check, apiCheck, koverVerify
• samples/validate-samples.sh — the plugin and all starters resolve for a real external consumer
• harness/consumer-smoke/run-all-engines.sh — netty, jetty, cio

🤖 Generated with Claude Code