Repository navigation
Firefly v1.2.1
This release publishes the complete 1.2.x tenant-governance and capacity-planning line. The previously unreleased v1.2.0 foundation and the v1.2.1 planning workflow ship together in this tag.
Tenant governance foundation
- authoritative tenant policy, usage, and idempotent reservations across concurrency, CPU, memory, backlog, and trigger rate
- weighted fair dispatch with durable fairness state
- stable rejection reasons, Admin management, audit integration, and Prometheus visibility
- additive v20 migrations for H2, PostgreSQL, and MySQL
Quota preview and capacity planning
- side-effect-free quota dry runs with current-usage impact, historical baselines, stable risks, and reason codes
- deterministic recommendations based on observed peak plus explicit headroom
- quality labels for insufficient coverage, quota-censored samples, mixed policy versions, and mixed runtime versions
- Admin preview/adopt/apply workflow protected by
expectedVersionCAS - fleet-wide risk reports plus bounded JSON/CSV export
- HA-safe, bounded asynchronous collection with flush deduplication and retention cleanup
- additive v21 migrations for capacity samples and flush identifiers
Compatibility
- Java 21
- Executor protocol v1/v2 unchanged
- Plugin API level 1 unchanged
- core JDBC schema compatibility remains version 12
- rolling upgrade supported; v20 and v21 are additive feature migrations
- quota recommendations are never auto-applied, and lowering a quota never preempts running work
Release gates
- complete Gradle check and plugin compatibility matrix
- production-readiness suite
- Admin UI static checks and Playwright E2E
- Spring Boot 3.3.5, 3.4.12, 3.5.8, and 4.0.0 compatibility
- Maven publication verification, including BOM, POM, sources, and javadoc artifacts
Real PostgreSQL/MySQL tests require explicitly configured external data sources. Environments without those data sources report the gate as not executed rather than passed.
Coordinates and images
- BOM:
io.github.fishered:firefly-bom:1.2.1 - Starter:
io.github.fishered:firefly-spring-boot-starter:1.2.1 - Server image:
ghcr.io/fishered/firefly:1.2.1 - Admin image:
ghcr.io/fishered/firefly-admin:1.2.1
See docs/upgrade-v1.2.1.md and docs/capacity-planning.md for upgrade and operating guidance.