nx9-auth/RELEASE_NOTES.md

NX9-Auth v0.3.0 Release Notes

NX9-Auth v0.3.0 brings full architectural stabilization, unified runtime lifecycle management, and production-grade operational robustness to self-hosted Identity and Access Management.

Key Features & Highlights

⚡ Unified Modular Runtime Subsystem

• Application Container & Builder: Pure dependency assembly separating configuration, database provider initializations, repository traits, and router construction.
• Lock-Free State Machine: AtomicRuntimeState tracks granular lifecycle states without mutex contention.
• Signal Handling & Cancellation: Multi-signal Unix signal manager handling SIGINT (Ctrl+C) and SIGTERM with parent-child cancellation tokens.

🛡️ Operational Stability & Graceful Shutdown

• Orderly Shutdown Flow: Running -> Draining -> StoppingWorkers -> ExecutingHooks -> ClosingResources -> Stopped.
• Prioritized Hook Execution: Supports custom shutdown hooks executed in priority order with error isolation.
• Background Worker Management: WorkerManager manages background task groups with configurable timeout cancellation.

🗄️ Dual-Database Engine Support

• Native support for SQLite (WAL mode, foreign keys, busy timeout) and PostgreSQL with automatic migrations and robust connection retry policies.

🚀 Developer & Operator Experience

• Built-in single binary execution (nx9-auth serve).
• Diagnostic nx9-auth doctor command for environment verification.
• Full Admin SPA UI shell embedded directly in the single binary.