Reference Release History

Release History

Complete release history for ReadyStackGo. For current planning, see the GitHub Project Board.

Released

• v0.1 – Container View + Start/Stop
• v0.2 – Local Admin + Hardcoded Stack
• v0.3 – Wizard + TLS Bootstrap + Manifest Deploy (2025-01-19)
• v0.4 – Multi-Environment + Docker Compose Deployment (2025-01-28)
  • Polymorphic Environment Types (Docker Socket)
  • Docker Compose Stack Deployment (Portainer-style)
  • Automatic Environment Variable Detection
  • Stack Sources System with Recursive Discovery
  • 404 Page, 4-Step Wizard, Environment Management UI
  • Registry Authentication for Image Pulls
  • Deployment Warnings for Local Image Fallback
• v0.5 – Environment Setup Flow + PublicWeb (2025-11-30)
  • Environment Creation as Optional Wizard Step
  • EnvironmentGuard for Environment-Dependent Pages
  • SetupEnvironment Page When No Environment Exists
  • PublicWeb Landing Page (DE/EN) with Astro/Starlight
  • ams.project Showcase, Legal Notice, Privacy Policy
  • Install Script with Docker Hub Image
• v0.6 – DDD Architecture + Security Hardening (2025-12-01)
  • SQLite Database for Persistent Storage
  • Domain-Driven Design with Bounded Contexts
  • Clean Architecture Implementation
  • MediatR for Command/Query Separation
  • RBAC (Role-Based Access Control)
  • Wizard Timeout (5-Minute Time Window for Admin Creation After Server Start)
  • API Lockdown After Timeout Expiration (like Portainer)
• v0.7 – Automated Release Workflow (2025-12-03)
  • Fully Automated Release Workflow with GitHub Actions
  • PublicWeb Deployment on Every Release
• v0.8 – Simplified Release Management (2025-12-03)
  • Simplified Release Workflow
  • GitHub-based Release Notes Integration
• v0.9 – Dev Builds + Example Stacks (2025-12-03)
  • Draft-only Releases with Manual Publish
  • Docker Dev Builds on ghcr.io
  • Example Stacks Included in Docker Image
• v0.10 – RSGo Manifest Format (2025-12-07)
  • Native Stack Definition Format for ReadyStackGo
  • 17 Variable Types (String, Number, Boolean, Select, Password, Port, Url, Email, etc.)
  • Docker Compose Import with Automatic Conversion
  • Multi-Stack Products with Shared Variables and Fragments
  • Regex Validation for Input Fields
  • Complete Manifest Specification and Schema Reference
• v0.11 – Domain Refactoring & REST API (2025-12-11)
  • DeployStack REST Endpoint for Stack Deployment via API
  • SignalR DeploymentHub for Real-time Progress Updates
  • StackValidationInfo for Pre-deployment Validation
  • Maintenance Observer Integration
  • Bounded Contexts Documentation
  • Domain Events for Deployment context (DeploymentStarted, DeploymentCompleted, etc.)
  • RuntimeStackConfig Entity in Deployment Context
  • Structured ServiceTemplate, VolumeDefinition, NetworkDefinition
  • ProductId navigation from Stack detail to Catalog
  • Deployment API uses stackId instead of raw YAML
• v0.12 – Domain Refactoring (DDD) - Phase 2 (2025-12-13)
  • Removed MaintenanceObserver from StackDefinition (belongs to ProductDefinition)
  • Infrastructure services don't publish domain events (Application layer responsibility)
  • IStackSourceProvider.LoadStacksAsync returns StackDefinition directly
  • Infrastructure reorganization by technical concerns (DataAccess, Docker, Security assemblies)
  • Removed obsolete StackVariable class - use Variable instead
  • Removed unused StackDefinitionLoaded and StackSourceSynced events
  • Variable record with comprehensive UI metadata (Type, Pattern, Options, Min/Max, Group, Order)
  • Built-in Validate() method for type-specific validation
  • Clean build with 0 warnings (fixed CS0105, CS8602, CS8604)
• v0.13 – Health Monitoring (2025-12-15)
  • Load Health Check Configuration from RSGO Manifest
  • ServiceHealthCheck extended with HTTP/TCP fields (type, path, port, expectedStatusCodes, https)
  • HealthCheckConfigs collection in Deployment aggregate
  • Health configs extracted during deployment and persisted to database
  • HealthCollectorService uses health configs for HTTP/TCP checks
  • 41 unit tests + 15 integration tests with TestContainers
• v0.14 – Health Dashboard, Upgrade & Rollback (2025-12-19)
  • Stack Health Dashboard (UI for health status visualization)
  • Health History with 24h retention and configurable intervals
  • Stack Upgrade (Update deployed stacks to newer catalog versions)
  • SemVer-based version comparison
  • Environment-level operation locking (one operation per environment)
  • Pre-upgrade snapshot for recovery
  • Deployment Rollback (Manual recovery after failed upgrades)
  • Only available after failed upgrade (not for downgrades)
  • Single snapshot per deployment (previous version only)
  • Product authors can disable via metadata.rollback.enabled: false
• v0.15 – Multi-Version Catalog, Registry Management & Git Stack Sources (2025-01-12)
  • Settings Page with Registry Management UI
  • CRUD for Docker Registries (Name, URL, Username, Password)
  • Image Patterns for automatic credential matching (glob-style: library/*, ghcr.io/**)
  • Default registry support
  • Database-first credential resolution during deployment
  • 64 integration tests (Endpoints + Repository)
  • Multi-Version Catalog Support
  • Multiple versions per product in catalog
  • New metadata.productId field for grouping versions across sources
  • ProductDefinition.GroupId for version grouping (uses productId or falls back to sourceId:name)
  • IProductCache extended with version-aware methods (GetProductVersions, GetAvailableUpgrades, etc.)
  • Cross-source upgrade support (e.g., local → git repository)
  • Version dropdown in deployment UI for selecting specific version
  • Upgrade detection shows all available higher versions
  • Git Repository Stack Source Provider (Load Stacks from Git Repos)
  • Stack Sources Management UI (Add/Edit/Delete sources, credentials for private repos)
• v0.16 – Remove Deployment + Progress Notifications (2026-01-20)
  • Remove Deployment page with SignalR progress notifications
  • DDD Redesign and Rollback Progress Notifications
• v0.17 – TLS & Certificate Management + Release Info (2026-01-22)
  • Settings UI refactoring with tab navigation (General, TLS, Registries, Stack Sources)
  • TLS Certificate Management
    • Self-signed certificate (auto-generated on first start)
    • Custom certificate upload (PFX and PEM formats)
    • Certificate info display (subject, issuer, expiry, thumbprint)
  • Let's Encrypt Integration
    • HTTP-01 Challenge (port 80 validation)
    • DNS-01 Challenge with Manual and Cloudflare provider
    • Automatic certificate renewal (30 days before expiry)
    • Staging mode for testing
  • Reverse Proxy Support
    • SSL Termination mode (proxy handles HTTPS, backend receives HTTP)
    • SSL Passthrough mode (proxy forwards encrypted traffic)
    • Re-Encryption mode (proxy terminates and re-encrypts)
    • ForwardedHeaders middleware configuration
    • X-Forwarded-For/Proto/Host header processing
  • Release Info in Sidebar
    • Version display (current server version)
    • Update notification banner (when new version available)
    • Link to GitHub release notes
    • Dismissable notification with localStorage persistence
  • Public Website TLS Documentation (DE/EN)
  • Stack Sources Git Credentials Support
  • Registry Management improvements
• v0.18 – Init Container UI/UX Improvements (2026-02-10)
  • Separate Init Container Counting in Deployment Progress
  • Real-time Init Container Log Streaming via SignalR
  • Init Containers Excluded from Health Monitoring
  • Automatic Init Container Cleanup After Successful Init Phase
• v0.19 – CI/CD Integration (2026-02-11)
  • API Key Domain Model with SHA-256 Hashed Key Storage
  • API Key Authentication Handler with Multi-Scheme Auth (PolicyScheme)
  • API Key Management CRUD Endpoints and Settings UI
  • Redeploy Webhook (POST /api/hooks/redeploy) for Fresh Image Deployments
  • Upgrade Webhook (POST /api/hooks/upgrade) with Catalog Version Resolution
  • Catalog Sync Webhook (POST /api/hooks/sync-sources)
  • Fine-grained Permission System per API Key (Redeploy, Upgrade, SyncSources)
  • Optional Environment-Scope for API Keys
  • Pipeline Examples for curl, GitHub Actions, and Azure DevOps
• v0.20 – Deploy Hook Improvements & Bugfixes (2026-02-12)
  • Idempotent Deploy Hook with Variable Default Value Fixes
  • Deploy Permission Option in API Key Creation UI
  • WebUI Headless Refactoring Specification
• v0.21 – UX Improvements (2026-02-12)
  • Copy-to-Clipboard Stack ID Button on Catalog StackCard
• v0.22 – Self-Update (2026-02-13)
  • UI-Triggered Self-Update via Helper Container Pattern
  • Version Detection via GitHub Releases API
  • Assembly Version Baking in Dockerfile (GIT_SEMVER Build Arg)
  • Helper Container (rsgo-updater) for Zero-Downtime Container Swap
  • Maintenance Page Served by Helper During Container Restart
  • Self-Update Documentation (DE/EN) and Landing Page Highlight
• v0.23 – Self-Update UX (2026-02-13)
  • Dedicated Full-Page Update Status Screen with Progress Display
  • Version Transition Badge (Current → Target Version)
  • Error State with Retry and Back-to-Dashboard Options
  • Helper Container Maintenance Page Restyled with RSGO Branding
• v0.24 – Preconfigured Sources, Registry Wizard & Setup Flow Redesign (2026-02-15)
  • Curated Source Registry (Embedded JSON Catalog of Known Git/Local Sources)
  • Wizard Stack Source Selection (Opt-in Instead of Auto-Creation)
  • Add From Catalog in Stack Source Settings (One-Click Add from Registry)
  • Image Reference Extraction from Synced Stack Manifests (Auto-Detect Host + Namespace)
  • Container Registry Detection Endpoint (Grouped by Host + Pattern)
  • Wizard Step for Container Registries (Two-Column Verified/Action-Required Layout)
  • Credential Verification via Docker Registry v2 API Token Flow
  • Two-Phase Setup: Secure Admin Creation (Phase 1) + Guided Onboarding (Phase 2)
  • Auto-Login After Admin Creation (JWT in CreateAdmin Response)
  • Wizard Simplified to Single Step (Admin Only, 5-Min Timeout)
  • Mandatory Onboarding Flow: Organization → Environment → Sources → Registries
  • Onboarding Status API (Authenticated, No Timeout Dependency)
• v0.25 – Docker Volumes Management (2026-02-16)
  • Docker Volumes View (List All Volumes per Environment)
  • Volume Details (Size, Mount Points, Labels, Container References)
  • Create/Delete Volumes with Driver Selection
  • Orphaned Volume Detection and Bulk Cleanup
• v0.26 – Container Management, Notifications & System Info (2026-02-17)
  • Container Remove Action with Force Flag and Safety Checks
  • Container Context Endpoint (Stack/Product/Deployment Resolution)
  • Three Container Views (List, Stack-Grouped, Product-Grouped)
  • Orphaned Container Detection (RSGO-Labeled Without Active Deployment)
  • Unmanaged Container Group (External Containers Without RSGO Labels)
  • Dedicated Delete Confirmation Pages (Stack Sources, Environments)
  • ams.project Stack Source in Curated Registry
  • External Network Auto-Creation for Multi-Stack Products
  • In-Memory Notification Store (Max 50, FIFO Eviction, Singleton — Transient Pre-v1.0)
  • Notification API Endpoints (List, Unread-Count, Mark-Read, Mark-All-Read, Dismiss)
  • NotificationDropdown (Bell Icon with Animated Badge, 60s Polling)
  • Update Available Notification (Deduplicated Per Version)
  • Source Sync Result Notification (Success/Warning/Error with Detail Rollup)
  • Deployment Result Notification (Deploy, Upgrade, Rollback, Remove — Stack & Product)
  • Settings > System Tab (Version Info, Build Info, "Check for Updates" Button)
  • User-Dropdown Version Badge (Version Display + Update Indicator)
  • Shared useVersionInfo Hook (SidebarWidget, UserDropdown, SystemInfo)
  • forceCheck Query Parameter on Version Endpoint (Bypass 24h Cache)
• v0.27 – Product Deployment & Orphaned Container Recovery (2026-02-21)
  • ProductDeployment Aggregate Root with ProductStackDeployment Child Entities
  • Product-Level State Machine (Deploying → Running / PartiallyRunning / Failed → Removing → Removed)
  • Deploy Product Flow (Orchestrated N-Stack Deployment with Shared Variable Wizard)
  • Upgrade Product Flow (Cross-Stack Version Upgrade with Variable Merging)
  • Check Upgrade Availability (Catalog Version Comparison with New/Removed Stack Detection)
  • Remove Product Flow (Reverse-Order Multi-Stack Removal)
  • Product Deployment Status in Catalog (Per-Stack Deploy State on ProductDetail)
  • SignalR Multi-Stack Progress (Per-Stack + Overall Progress Events)
  • Health-Sync Background Service (Eventual Consistency Between Product and Stack Status)
  • ContinueOnError Flag for Partial Failure Tolerance
  • Three-Tier Variable System (Stack Defaults → Shared Variables → Per-Stack Overrides)
  • Split-View Deployment Progress (Per-Stack Progress Bar, Service Counters, Init Container Logs)
  • Shared DeploymentProgressPanel Component (Extracted from Single-Stack Deployment)
  • Product Deployment E2E Tests with Multi-Stack Test Product
  • Step-by-Step Documentation with Screenshots (DE/EN)
  • Repair Orphaned Stacks (Reconcile Running Containers with Fresh Database via Catalog Matching)
  • Bulk Remove Orphaned Stacks (Delete All Containers of an Orphaned Stack Group)
  • Repair All Orphaned Stacks (Batch Repair with Per-Stack Error Handling)
  • Orphaned Stack UI Actions (Repair/Remove Buttons with Confirmation Dialogs in All Container Views)
• v0.28 – Deployments Overview with Product Info (2026-02-25)
  • Product Deployments Section in Deployments Overview (Above Stack Deployments)
  • Product Deployment Cards (Name, Version, Status, Stack Progress, Actions)
  • Frontend listProductDeployments() API Function (Missing in v0.27)
  • Product-Level DeploymentName Refactoring (Single Name Instead of Per-Stack)
• v0.29 – Health Check Details (2026-02-26)
  • Full ASP.NET Core HealthReport Parsing (entries with status, description, duration, data, tags, exception)
  • Health Check Entry Domain Model (HealthCheckEntry Value Object)
  • Data Pipeline: HttpChecker → Domain → DTO → SignalR/API
  • Inline Health Check Detail in Dashboard (expandable service rows)
  • Dedicated Service Health Detail Page (/health/:deploymentId/:serviceName)
  • Dedicated Service Health Detail API Endpoint
  • Service Response Time Tracking
  • EF Core Persistence for Health Check Entries (JSON serialization)
• v0.30 – Container Logs, Retry & Hook Improvements (2026-02-26)
  • Container Log Viewer with Live Streaming via SignalR
  • REST Endpoint for Historical Logs (GET /api/containers/{id}/logs)
  • SignalR ContainerHub for Real-Time Log Tailing (/hubs/container)
  • Terminal-Style Fullscreen Log Page with Auto-Scroll and Tail Selector
  • Retry Failed Product Deployment (Resume From Last Failed Stack)
  • Deploy Hook Resolution by ProductId (Stable CI/CD Without Instance-Specific SourceId)
  • Optional productId, version, stackDefinitionName Fields on /api/hooks/deploy
  • Backward-Compatible: Existing stackId-Based Requests Still Supported
• v0.31 – Product Container Control (2026-03-03)
  • Stop All Containers of a Product Deployment (Graceful Shutdown)
  • Restart All Containers of a Product Deployment (Stop + Start Sequentially)
  • Per-Stack Stop/Restart Within a Product Deployment (Selective Control)
  • Stop/Restart UI with Dedicated Pages and Confirmation Dialogs
  • Stopped Status in Product and Stack Deployment State Machines
  • Hook Support for Stop/Restart (/api/hooks/stop-containers, /api/hooks/restart-containers)
  • API Key Permissions for StopContainers and RestartContainers
• v0.32 – Notifications Phase 2 (2026-03-03)
  • Container Health Change Notification (Unhealthy/Degraded/Recovery with Configurable Throttling)
  • Health Notification Cooldown Setting on System Settings Page (1–60 Minutes)
  • API Key First-Use Notification (Info-Level on First API Key Usage)
  • TLS Certificate Expiry Notification (Staged Warnings at 30d, 14d, 7d, 3d, 1d, 0d)
  • CertificateExpiryCheckService Background Service (12h Interval)
  • HealthChangeTracker Singleton (Per-Service Status Tracking with ConcurrentDictionary Cooldown)
  • 3 New NotificationType Enum Values: HealthChange, ApiKeyFirstUse, CertificateExpiry
• v0.33 – Redeploy Product Deployment (2026-03-03)
  • Redeploy All Stacks of a Running Product Deployment (Same Version, Fresh Pull)
  • Redeploy Single Stack Within a Product Deployment (Selective Stack Redeploy)
  • New Redeploying Status in Product Deployment State Machine
  • Variable Override Support During Redeploy (Stored Base + Webhook Overrides)
  • Redeploy Product UI (Stack Selection, Confirmation, Progress Panel)
  • Hook Support for Product Redeploy (/api/hooks/redeploy with productId)
• v0.34 – Distribution Architecture (2026-03-04)
  • pnpm Workspaces Monorepo (packages/core, packages/ui-generic, apps/rsgo-generic)
  • @rsgo/core Package (TypeScript types, API clients, ViewModel hooks, SignalR services)
  • @rsgo/ui-generic Package (React components, pages, layouts, thin contexts)
  • ViewModel Hooks for All Pages (Settings, Deployments, Catalog, Health, Wizard)
  • SignalR Service Classes with Thin React Hook Wrappers
  • Auth/Environment Services Extracted from React Contexts
  • Build Pipeline Adjustment (pnpm in Dockerfile)
  • ISetupWizardDefinitionProvider + GenericSetupWizardDefinitionProvider (Data-Driven Wizard Steps)
  • IBootstrapper + GenericBootstrapper (Distribution-Specific Initialization on First Start)
  • NuGet Meta-Package ReadyStackGo.Core (Domain + Application + Infrastructure)
  • Multi-Assembly FastEndpoints Endpoint Discovery
  • Distribution Architecture Documentation
• v0.39 – Documentation & PublicWeb Updates (2026-03-12)
  • Cancel image pull after 3 minutes without progress
  • Product Redeploy documentation with E2E tests and landing page highlight
  • Container Management documentation with E2E tests and landing page highlight
  • Remove Product documentation with E2E tests
  • Container Control documentation with E2E tests and landing page highlight
  • Custom Distributions documentation and landing page highlight
  • DevStatus banner updated to "v1.0 Release in Vorbereitung / Coming Soon"
  • AMS distribution planning: skills, plan files, independent versioning concept
• v0.40 – Maintenance & Cleanup (2026-03-12)
  • Delete obsolete spec files superseded by completed PLAN files
  • Add spec cleanup step to plan-feature skill
• v0.41 – PublicWeb Polish (2026-03-12)
  • DevStatus banner updated from early-dev warning to v1.0 coming soon (brand blue, checkmarks)
  • Remove AMS Distribution example from distributions documentation
• v0.42 – Bugfix: Redeploy Premature Completion (2026-03-12)
  • Fix redeploy showing success after first stack due to SuppressNotification: false sending DeploymentCompleted per stack
• v0.43 – Bugfix: Container List Stale Health (2026-03-13)
  • Fix container list showing stale unhealthy status from removed deployments by filtering to active deployments only
• v0.44 – Bugfix: Self-Update Progress Jumping (2026-03-13)
  • Fix progress bar jumping back and forth during self-update by enforcing monotonic progress percentage
• v0.45 – Third-Party Licenses UI, Documentation Link & CI Fix (2026-03-13)
  • Settings > Licenses page listing all bundled npm and .NET packages with license types and links
  • License JSON files (npm-webui, npm-publicweb, dotnet) bundled into Docker image via Dockerfile
  • Search and filter by license type, category badges with package counts
  • Sidebar "Documentation" link opening online docs in new tab
  • Fix CI license generation workflow (migrate from deprecated dotnet-project-licenses to nuget-license)
• v0.46 – Health History Transition Chart (2026-03-13)
  • Replace snapshot-based health history with status transition step chart
  • GetHealthTransitions endpoint using LAG() window function to detect status changes
  • Recharts stepAfter line chart showing health transitions over time
• v0.47 – Health Chart v2: Per-Service Visibility & Visual Redesign (2026-03-13)
  • Replace percentage-based step line chart with categorical status band visualization
  • Per-service swim lane timeline showing individual service health over time
  • Uptime donut chart with percentage distribution by status
  • Maintenance mode shown in blue, excluded from uptime calculation
  • Enriched HealthTransitionDto with per-service data and operation mode
  • Bilingual health monitoring documentation (DE/EN) with E2E-generated screenshots
  • AMS UI impact check step added to implement-feature skill
• v0.48 – Maintenance Mode Redesign (2026-03-14)
  • MaintenanceTrigger value object with ownership rules (Manual/Observer sources)
  • Trigger-based exit blocking: observer can't exit manual maintenance and vice versa
  • Product-level maintenance: OperationMode, MaintenanceTrigger on ProductDeployment aggregate
  • Observer service refactored to iterate ProductDeployments (one check per product, not N per stack)
  • Product operation mode API endpoint with 409 Conflict for ownership-blocked transitions
  • Product detail page: enter/exit maintenance buttons, operation mode badge, trigger info panel
  • 23 new handler unit tests, 22 domain unit tests, 11 value object unit tests
  • Fix: Maintenance mode propagation to child stacks (OperationMode + status badge override)
  • Dedicated Enter/Exit Maintenance pages with confirmation flow
  • Remove stack-level maintenance API (product-level only)
  • Reduce sidebar logo spacing
• v0.49 – SSH Tunnel Environment (2026-03-15)
  • Polymorphic ConnectionConfig (JSON Column, DockerSocketConfig + SshTunnelConfig subtypes)
  • SSH Credential Storage (AES-encrypted private keys/passwords)
  • SshTunnelManager (SSH.NET, local port forwarding, tunnel pool, auto-reconnect)
  • DockerService SSH-Routing (transparent tunnel for all Docker operations)
  • SSH Environment API + UI (type selector, dynamic form, test connection)
  • Bilingual documentation (DE/EN) with E2E test screenshots
  • Landing page highlight feature tile
  • Environment Type Selector: split Add Environment into type selection + type-specific sub-pages