fun_ci 1.0.0 → 1.2.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: bacc0733c3648d5b5422304a7c319be52f1531e98f1c802e4a3d2a5280928ba9
-  data.tar.gz: '097d7eaea4e663259c0b745724e6a4d281af1aa60b0ebb3bd78a14c8add5bb57'
+  metadata.gz: 8de275f366537fcf143b9dccdd10002a9cbff42632ab7e2549b695b4a3ba6240
+  data.tar.gz: 8723aee6ea508e2f9bf44c59cb717a83a08dc60381f389550f714b0b0f0de722
 SHA512:
-  metadata.gz: feb14f7ff5ba1b67c66b3aa9cddeb9a160320aab302abf9aa60f3cb58b88395e0493abd50dd44db2ddd4030680d0a3c77e99f50cd7408309fe7e3cec9f692163
-  data.tar.gz: 8c3cf91d027932fbb998bb3f341cfced2752de43d926a10310f1900ce672de041f75b830379c665b3286daf93bb0c0b0364af47ba1dd116af8c1cc393481ea85
+  metadata.gz: f4122b18c73b6434eedbe7124fa19b79c64b03fce502a34fdc978aa0d97006091477495d6d9ccfe1cb3ca8eba8be0fa9d53341d328a3bd20ecff43e00c482ddc
+  data.tar.gz: fde4e5346d6bb6038ad35137456a6b1188a61c16f75973e9a55e44b73bc751afed551e1ea063a6a58a38adfbde4eefc1919297d870810ec8ddadfabd6106ce38

data/CHANGELOG.md

@@ -5,6 +5,40 @@ All notable changes to this project will be documented in this file.
 The format is based on [Keep a Changelog](https://keepachangelog.com/en/1.0.0/),
 and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0.html).
 
+## [1.2.0] - 2026-02-23
+
+### Bug Fixes
+- Replaced unreliable `Timeout.timeout` with process groups (`pgroup: true`) and `Thread#join` for reliable time budget enforcement on lint/build/fast/slow stages
+- Fixed off-by-one in TUI row truncation that caused the top pipeline row to be hidden behind the header in short terminals
+- Added `Screen#height=` to clear screen on terminal height changes, preventing the header from scrolling off-screen when tmux panes resize
+- Fixed header flicker by skipping `println` when animation is active
+- Allowed null SHA on root commits so pipeline still runs
+- Detected multi-module Gradle projects from `settings.gradle`
+
+### Refactoring
+- Extracted `TerminalInput`, `KeyHandler`, `BoardRenderer` from `AdminTui` (was 257 lines/12 ivars, now 4 focused classes all under 150 lines/4 ivars)
+- Organized flat `lib/fun_ci/` into cohesive module subdirectories: `persistence/`, `pipeline/`, `setup/`, `tui/`
+
+### Internal
+- Extracted shared `ProcessRunner` module for consistent process spawning across stages
+- Updated `BackgroundWrapper` to use `[output, status, timed_out]` triples instead of exception-based timeout signaling
+- Truncated TUI board rows to fit terminal height
+
+## [1.1.0] - 2026-02-22
+
+### Added
+- Multi-line ASCII art header animations for pipeline events (explosion on failure, celebrations on success)
+- Looping idle starfield animation in the TUI header
+- Rocket animation while pipelines are running, with flickering exhaust and parallax starfield
+- HeaderAnimationManager with idle/running/event state transitions
+- AnimationLibrary with 8 animation data files (explosion, success, celebrate, flash, leprechauns, yay, idle, running)
+
+### Fixed
+- Footer animations now display 8x slower so text is actually readable
+- Animation refresh no longer blocks for 5 seconds between frames when no pipelines are running
+- Removed stale single-line header banner that conflicted with multi-line animations
+- Animation frames padded to global max width across all frames, preventing horizontal jitter
+
 ## [1.0.0] - 2026-02-21
 
 ### Added

data/README.md

@@ -74,7 +74,9 @@ After `fun-ci install-hooks`, two hooks are active:
 fun-ci console
 ```
 
-Opens a terminal UI showing pipeline status across all branches. Navigation:
+Opens a terminal UI showing pipeline status across all branches. The header area displays animated ASCII art: a gentle starfield when idle, a rocket while pipelines run, and celebration/explosion animations on success or failure.
+
+Navigation:
 
 - `j` / `k` -- scroll up/down
 - `c` -- cancel a running pipeline

data/exe/fun-ci-trigger

@@ -2,8 +2,8 @@
 # frozen_string_literal: true
 
 require_relative "../lib/fun_ci"
-require_relative "../lib/fun_ci/trigger"
-require_relative "../lib/fun_ci/pipeline_recorder"
+require_relative "../lib/fun_ci/pipeline/trigger"
+require_relative "../lib/fun_ci/persistence/pipeline_recorder"
 
 require "tmpdir"
 
@@ -11,9 +11,9 @@ db_dir = File.join(Dir.tmpdir, "fun-ci")
 Dir.mkdir(db_dir) unless Dir.exist?(db_dir)
 db_path = File.join(db_dir, "db.sqlite3")
 
-db = FunCi::Database.connection(db_path)
-FunCi::Database.migrate!(db)
+db = FunCi::Persistence::Database.connection(db_path)
+FunCi::Persistence::Database.migrate!(db)
 
-recorder = FunCi::DbRecorder.new(db)
+recorder = FunCi::Persistence::DbRecorder.new(db)
 
-exit FunCi::Trigger.run_from_args(ARGV, recorder: recorder)
+exit FunCi::Pipeline::Trigger.run_from_args(ARGV, recorder: recorder)

data/exe/fun-ci-tui

@@ -2,7 +2,8 @@
 # frozen_string_literal: true
 
 require_relative "../lib/fun_ci"
-require_relative "../lib/fun_ci/admin_tui"
+require_relative "../lib/fun_ci/tui/admin_tui"
+require_relative "../lib/fun_ci/tui/animation_renderer"
 
 require "tmpdir"
 require "io/console"
@@ -11,8 +12,12 @@ db_dir = File.join(Dir.tmpdir, "fun-ci")
 Dir.mkdir(db_dir) unless Dir.exist?(db_dir)
 db_path = File.join(db_dir, "db.sqlite3")
 
-db = FunCi::Database.connection(db_path)
-FunCi::Database.migrate!(db)
+db = FunCi::Persistence::Database.connection(db_path)
+FunCi::Persistence::Database.migrate!(db)
 
-tui = FunCi::AdminTui.new(db: db, width_provider: -> { IO.console&.winsize&.dig(1) || 80 })
+tui = FunCi::Tui::AdminTui.new(
+  db: db,
+  width_provider: -> { IO.console&.winsize&.dig(1) || 80 },
+  animation_renderer: FunCi::Tui::AnimationRenderer.new
+)
 tui.run

data/lib/fun_ci/animations/celebrate.rb

@@ -0,0 +1,210 @@
+# frozen_string_literal: true
+
+module FunCi
+  module Animations
+    module Celebrate
+      # Horizontal colour expansion — success celebration
+      # Run: ruby exe/animation-player animations/celebrate.rb
+
+      w = "\e[1;37m"     # bold white
+      y = "\e[1;33m"     # bold yellow
+      Y = "\e[33m"       # yellow
+      g = "\e[1;32m"     # bold green
+      G = "\e[32m"       # green
+      d = "\e[2;32m"     # dim green
+      c = "\e[1;36m"     # bold cyan
+      C = "\e[36m"       # cyan
+      m = "\e[1;35m"     # bold magenta
+      M = "\e[35m"       # magenta
+      b = "\e[1;34m"     # bold blue
+      B = "\e[34m"       # blue
+      r = "\e[1;31m"     # bold red
+      o = "\e[38;5;208m" # orange
+      x = "\e[0m"        # reset
+
+      raw_frames = [
+          # Frame 1 — dark field, bright seed in the centre
+          [
+            "  #{d}. . . . . . . . . . . . . . . . . . . . . . . .#{x}",
+            "  #{d}. . . . . . . . . . . . . . . . . . . . . . . .#{x}",
+            "  #{d}. . . . . . . . . . . . . . . . . . . . . . . .#{x}",
+            "  #{d}. . . . . . . . . . . . . . . . . . . . . . . .#{x}",
+            "  #{d}. . . . . . . . . . . . . . . . . . . . . . . .#{x}",
+            "  #{d}. . . . . . . . . . . .#{w}*#{d}. . . . . . . . . . .#{x}",
+            "  #{d}. . . . . . . . . . . . . . . . . . . . . . . .#{x}",
+            "  #{d}. . . . . . . . . . . . . . . . . . . . . . . .#{x}",
+            "  #{d}. . . . . . . . . . . . . . . . . . . . . . . .#{x}",
+            "  #{d}. . . . . . . . . . . . . . . . . . . . . . . .#{x}",
+            "  #{d}. . . . . . . . . . . . . . . . . . . . . . . .#{x}",
+          ],
+          # Frame 2 — first horizontal burst, gold/white core
+          [
+            "  #{d}. . . . . . . . . . . . . . . . . . . . . . . .#{x}",
+            "  #{d}. . . . . . . . . . . . . . . . . . . . . . . .#{x}",
+            "  #{d}. . . . . . . . . . . . . . . . . . . . . . . .#{x}",
+            "  #{d}. . . . . . . . . . #{Y}* #{y}* #{Y}*#{d} . . . . . . . . .#{x}",
+            "  #{d}. . . . . . . . . #{y}* #{w}*#{y} @#{w} @#{y} *#{Y} *#{d} . . . . . . . .#{x}",
+            "  #{d}. . . . . . . . #{y}*#{w} @#{y} @#{w} # #{w}@#{y} @ #{w}*#{y} *#{d} . . . . . . .#{x}",
+            "  #{d}. . . . . . . . . #{y}* #{w}*#{y} @#{w} @#{y} *#{Y} *#{d} . . . . . . . .#{x}",
+            "  #{d}. . . . . . . . . . #{Y}* #{y}* #{Y}*#{d} . . . . . . . . .#{x}",
+            "  #{d}. . . . . . . . . . . . . . . . . . . . . . . .#{x}",
+            "  #{d}. . . . . . . . . . . . . . . . . . . . . . . .#{x}",
+            "  #{d}. . . . . . . . . . . . . . . . . . . . . . . .#{x}",
+          ],
+          # Frame 3 — wider, green/cyan ring appears
+          [
+            "  #{d}. . . . . . . . . . . . . . . . . . . . . . . .#{x}",
+            "  #{d}. . . . . . . . . . . . . . . . . . . . . . . .#{x}",
+            "  #{d}. . . . . . . #{G}*#{g} *#{G} *#{g} *#{G} *#{g} *#{G} *#{g} *#{G} *#{d} . . . . . . .#{x}",
+            "  #{d}. . . . . . #{g}*#{c} *#{C} *#{y} *#{Y} * #{y}*#{Y} * #{c}*#{C} *#{g} *#{d} . . . . . .#{x}",
+            "  #{d}. . . . . #{g}*#{c} *#{y} *#{w} @#{y} @#{w} ##{w} @#{y} @#{w} *#{y} *#{c} *#{g} *#{d} . . . . .#{x}",
+            "  #{d}. . . . #{g}*#{c} *#{y} *#{w} @#{w} ##{w} @#{w} ##{w} @#{w} ##{w} @#{w} *#{y} *#{c} *#{g} *#{d} . . . .#{x}",
+            "  #{d}. . . . . #{g}*#{c} *#{y} *#{w} @#{y} @#{w} ##{w} @#{y} @#{w} *#{y} *#{c} *#{g} *#{d} . . . . .#{x}",
+            "  #{d}. . . . . . #{g}*#{c} *#{C} *#{y} *#{Y} * #{y}*#{Y} * #{c}*#{C} *#{g} *#{d} . . . . . .#{x}",
+            "  #{d}. . . . . . . #{G}*#{g} *#{G} *#{g} *#{G} *#{g} *#{G} *#{g} *#{G} *#{d} . . . . . . .#{x}",
+            "  #{d}. . . . . . . . . . . . . . . . . . . . . . . .#{x}",
+            "  #{d}. . . . . . . . . . . . . . . . . . . . . . . .#{x}",
+          ],
+          # Frame 4 — colours spread wider, magenta/blue outer ring
+          [
+            "  #{d}. . . . . . . . . . . . . . . . . . . . . . . .#{x}",
+            "  #{d}. . . . . #{B}*#{b} *#{B} *#{b} *#{B} *#{b} *#{B} *#{b} *#{B} *#{b} *#{B} *#{d} . . . . .#{x}",
+            "  #{d}. . . . #{b}*#{M} *#{m} *#{g} *#{c} *#{g} *#{c} *#{g} *#{c} *#{m} *#{M} *#{b} *#{d} . . . .#{x}",
+            "  #{d}. . . #{b}*#{m} *#{g} *#{c} *#{C} *#{y} *#{Y} * #{y}*#{C} * #{c}*#{g} *#{m} *#{b} *#{d} . . .#{x}",
+            "  #{d}. . #{b}*#{m} *#{g} *#{c} *#{y} *#{w} @#{y} @#{w} ##{w} @#{y} @#{y} *#{c} *#{g} *#{m} *#{b} *#{d} . .#{x}",
+            "  #{d}. #{b}*#{m} *#{g} *#{c} *#{y} *#{w} @#{w} ##{w} @#{w} ##{w} @#{w} ##{w} @#{y} *#{c} *#{g} *#{m} *#{b} *#{d} .#{x}",
+            "  #{d}. . #{b}*#{m} *#{g} *#{c} *#{y} *#{w} @#{y} @#{w} ##{w} @#{y} @#{y} *#{c} *#{g} *#{m} *#{b} *#{d} . .#{x}",
+            "  #{d}. . . #{b}*#{m} *#{g} *#{c} *#{C} *#{y} *#{Y} * #{y}*#{C} * #{c}*#{g} *#{m} *#{b} *#{d} . . .#{x}",
+            "  #{d}. . . . #{b}*#{M} *#{m} *#{g} *#{c} *#{g} *#{c} *#{g} *#{c} *#{m} *#{M} *#{b} *#{d} . . . .#{x}",
+            "  #{d}. . . . . #{B}*#{b} *#{B} *#{b} *#{B} *#{b} *#{B} *#{b} *#{B} *#{b} *#{B} *#{d} . . . . .#{x}",
+            "  #{d}. . . . . . . . . . . . . . . . . . . . . . . .#{x}",
+          ],
+          # Frame 5 — nearly full width, rainbow bands
+          [
+            "  #{d}. . . #{B}*#{b} *#{B} *#{b} *#{B} *#{b} *#{B} *#{b} *#{B} *#{b} *#{B} *#{b} *#{B} *#{b} *#{d} . . .#{x}",
+            "  #{d}. . #{b}*#{M} *#{m} *#{M} *#{m} *#{M} *#{m} *#{M} *#{m} *#{M} *#{m} *#{M} *#{m} *#{M} *#{b} *#{d} . .#{x}",
+            "  #{d}. #{m}*#{r} *#{o} *#{g} *#{c} *#{g} *#{c} *#{g} *#{c} *#{g} *#{c} *#{g} *#{o} *#{r} *#{m} *#{d} .#{x}",
+            "  #{m}*#{g} *#{c} *#{C} *#{c} *#{C} *#{y} *#{Y} *#{y} *#{Y} *#{c} *#{C} *#{c} *#{C} *#{c} *#{g} *#{m} *#{x}",
+            "  #{g}*#{c} *#{y} *#{Y} *#{w} @#{y} @#{w} ##{w} @#{w} ##{w} @#{y} @#{w} *#{Y} *#{y} *#{c} *#{g} *#{m} *#{x}",
+            "  #{g}*#{c} *#{y} *#{w} @#{w} ##{w} @#{w} ##{w} @#{w} ##{w} @#{w} ##{w} @#{w} *#{y} *#{c} *#{g} *#{m} *#{x}",
+            "  #{g}*#{c} *#{y} *#{Y} *#{w} @#{y} @#{w} ##{w} @#{w} ##{w} @#{y} @#{w} *#{Y} *#{y} *#{c} *#{g} *#{m} *#{x}",
+            "  #{m}*#{g} *#{c} *#{C} *#{c} *#{C} *#{y} *#{Y} *#{y} *#{Y} *#{c} *#{C} *#{c} *#{C} *#{c} *#{g} *#{m} *#{x}",
+            "  #{d}. #{m}*#{r} *#{o} *#{g} *#{c} *#{g} *#{c} *#{g} *#{c} *#{g} *#{c} *#{g} *#{o} *#{r} *#{m} *#{d} .#{x}",
+            "  #{d}. . #{b}*#{M} *#{m} *#{M} *#{m} *#{M} *#{m} *#{M} *#{m} *#{M} *#{m} *#{M} *#{m} *#{M} *#{b} *#{d} . .#{x}",
+            "  #{d}. . . #{B}*#{b} *#{B} *#{b} *#{B} *#{b} *#{B} *#{b} *#{B} *#{b} *#{B} *#{b} *#{B} *#{b} *#{d} . . .#{x}",
+          ],
+          # Frame 6 — FULL WIDTH, every pixel lit, rainbow explosion
+          [
+            "  #{B}*#{b} *#{M} *#{m} *#{M} *#{m} *#{M} *#{m} *#{M} *#{m} *#{M} *#{m} *#{M} *#{m} *#{M} *#{b} *#{B} *#{x}",
+            "  #{m}*#{r} *#{o} *#{r} *#{g} *#{c} *#{g} *#{c} *#{g} *#{c} *#{g} *#{c} *#{r} *#{o} *#{r} *#{m} *#{b} *#{x}",
+            "  #{r}*#{o} *#{g} *#{c} *#{C} *#{c} *#{C} *#{c} *#{C} *#{c} *#{C} *#{c} *#{C} *#{g} *#{o} *#{r} *#{m} *#{x}",
+            "  #{g}*#{c} *#{C} *#{y} *#{Y} *#{y} *#{Y} *#{w} @#{Y} *#{y} *#{Y} *#{y} *#{C} *#{c} *#{g} *#{o} *#{r} *#{x}",
+            "  #{c}*#{y} *#{w} @#{w} ##{w} @#{w} ##{w} @#{w} ##{w} @#{w} ##{w} @#{w} ##{w} @#{w} *#{y} *#{c} *#{g} *#{o} *#{x}",
+            "  #{y}*#{w} @#{w} ##{w} @#{w} ##{w} @#{w} ##{w} @#{w} ##{w} @#{w} ##{w} @#{w} ##{w} @#{w} ##{w} @#{y} *#{c} *#{x}",
+            "  #{c}*#{y} *#{w} @#{w} ##{w} @#{w} ##{w} @#{w} ##{w} @#{w} ##{w} @#{w} ##{w} @#{w} *#{y} *#{c} *#{g} *#{o} *#{x}",
+            "  #{g}*#{c} *#{C} *#{y} *#{Y} *#{y} *#{Y} *#{w} @#{Y} *#{y} *#{Y} *#{y} *#{C} *#{c} *#{g} *#{o} *#{r} *#{x}",
+            "  #{r}*#{o} *#{g} *#{c} *#{C} *#{c} *#{C} *#{c} *#{C} *#{c} *#{C} *#{c} *#{C} *#{g} *#{o} *#{r} *#{m} *#{x}",
+            "  #{m}*#{r} *#{o} *#{r} *#{g} *#{c} *#{g} *#{c} *#{g} *#{c} *#{g} *#{c} *#{r} *#{o} *#{r} *#{m} *#{b} *#{x}",
+            "  #{B}*#{b} *#{M} *#{m} *#{M} *#{m} *#{M} *#{m} *#{M} *#{m} *#{M} *#{m} *#{M} *#{m} *#{M} *#{b} *#{B} *#{x}",
+          ],
+          # (hold)
+          [
+            "  #{b}*#{M} *#{m} *#{M} *#{m} *#{r} *#{o} *#{r} *#{o} *#{r} *#{m} *#{M} *#{m} *#{M} *#{m} *#{M} *#{b} *#{x}",
+            "  #{m}*#{r} *#{o} *#{g} *#{c} *#{g} *#{c} *#{g} *#{c} *#{g} *#{c} *#{g} *#{c} *#{g} *#{o} *#{r} *#{m} *#{x}",
+            "  #{o}*#{g} *#{c} *#{C} *#{c} *#{C} *#{y} *#{Y} *#{y} *#{Y} *#{c} *#{C} *#{c} *#{C} *#{g} *#{o} *#{r} *#{x}",
+            "  #{c}*#{C} *#{y} *#{Y} *#{y} *#{w} @#{w} ##{w} @#{w} ##{w} @#{y} *#{Y} *#{y} *#{C} *#{c} *#{g} *#{o} *#{x}",
+            "  #{y}*#{w} @#{w} ##{w} @#{w} ##{w} @#{w} ##{w} @#{w} ##{w} @#{w} ##{w} @#{w} ##{w} @#{w} *#{y} *#{c} *#{g} *#{x}",
+            "  #{w}@#{w} ##{w} @#{w} ##{w} @#{w} ##{w} @#{w} ##{w} @#{w} ##{w} @#{w} ##{w} @#{w} ##{w} @#{w} ##{w} @#{y} *#{x}",
+            "  #{y}*#{w} @#{w} ##{w} @#{w} ##{w} @#{w} ##{w} @#{w} ##{w} @#{w} ##{w} @#{w} ##{w} @#{w} *#{y} *#{c} *#{g} *#{x}",
+            "  #{c}*#{C} *#{y} *#{Y} *#{y} *#{w} @#{w} ##{w} @#{w} ##{w} @#{y} *#{Y} *#{y} *#{C} *#{c} *#{g} *#{o} *#{x}",
+            "  #{o}*#{g} *#{c} *#{C} *#{c} *#{C} *#{y} *#{Y} *#{y} *#{Y} *#{c} *#{C} *#{c} *#{C} *#{g} *#{o} *#{r} *#{x}",
+            "  #{m}*#{r} *#{o} *#{g} *#{c} *#{g} *#{c} *#{g} *#{c} *#{g} *#{c} *#{g} *#{c} *#{g} *#{o} *#{r} *#{m} *#{x}",
+            "  #{b}*#{M} *#{m} *#{M} *#{m} *#{r} *#{o} *#{r} *#{o} *#{r} *#{m} *#{M} *#{m} *#{M} *#{m} *#{M} *#{b} *#{x}",
+          ],
+          # Frame 7 — contracting, colours retreating
+          [
+            "  #{d}. #{B}*#{b} *#{M} *#{m} *#{M} *#{m} *#{M} *#{m} *#{M} *#{m} *#{M} *#{m} *#{M} *#{b} *#{B} *#{d} .#{x}",
+            "  #{d}. . #{m}*#{r} *#{o} *#{g} *#{c} *#{g} *#{c} *#{g} *#{c} *#{g} *#{c} *#{o} *#{r} *#{m} *#{d} . .#{x}",
+            "  #{d}. . . #{g}*#{c} *#{C} *#{c} *#{C} *#{y} *#{Y} *#{y} *#{C} *#{c} *#{C} *#{c} *#{g} *#{d} . . .#{x}",
+            "  #{d}. . . . #{c}*#{C} *#{y} *#{Y} *#{w} @#{w} ##{w} @#{Y} *#{y} *#{C} *#{c} *#{g} *#{d} . . . .#{x}",
+            "  #{d}. . . #{g}*#{c} *#{y} *#{w} @#{w} ##{w} @#{w} ##{w} @#{w} ##{w} @#{w} *#{y} *#{c} *#{g} *#{d} . . .#{x}",
+            "  #{d}. . #{g}*#{c} *#{y} *#{w} @#{w} ##{w} @#{w} ##{w} @#{w} ##{w} @#{w} ##{w} @#{y} *#{c} *#{g} *#{d} . .#{x}",
+            "  #{d}. . . #{g}*#{c} *#{y} *#{w} @#{w} ##{w} @#{w} ##{w} @#{w} ##{w} @#{w} *#{y} *#{c} *#{g} *#{d} . . .#{x}",
+            "  #{d}. . . . #{c}*#{C} *#{y} *#{Y} *#{w} @#{w} ##{w} @#{Y} *#{y} *#{C} *#{c} *#{g} *#{d} . . . .#{x}",
+            "  #{d}. . . #{g}*#{c} *#{C} *#{c} *#{C} *#{y} *#{Y} *#{y} *#{C} *#{c} *#{C} *#{c} *#{g} *#{d} . . .#{x}",
+            "  #{d}. . #{m}*#{r} *#{o} *#{g} *#{c} *#{g} *#{c} *#{g} *#{c} *#{g} *#{c} *#{o} *#{r} *#{m} *#{d} . .#{x}",
+            "  #{d}. #{B}*#{b} *#{M} *#{m} *#{M} *#{m} *#{M} *#{m} *#{M} *#{m} *#{M} *#{m} *#{M} *#{b} *#{B} *#{d} .#{x}",
+          ],
+          # Frame 8 — second pulse outward, fresh colours
+          [
+            "  #{d}. . #{b}*#{m} *#{r} *#{o} *#{g} *#{c} *#{g} *#{c} *#{g} *#{o} *#{r} *#{m} *#{b} *#{d} . . .#{x}",
+            "  #{d}. #{m}*#{g} *#{c} *#{C} *#{c} *#{C} *#{c} *#{C} *#{c} *#{C} *#{c} *#{C} *#{c} *#{g} *#{m} *#{d} .#{x}",
+            "  #{m}*#{g} *#{c} *#{C} *#{y} *#{Y} *#{y} *#{Y} *#{y} *#{Y} *#{y} *#{Y} *#{C} *#{c} *#{g} *#{m} *#{b} *#{x}",
+            "  #{g}*#{c} *#{y} *#{w} @#{w} ##{w} @#{w} ##{w} @#{w} ##{w} @#{w} ##{w} @#{w} *#{y} *#{c} *#{g} *#{m} *#{x}",
+            "  #{c}*#{y} *#{w} @#{w} ##{w} @#{w} ##{w} @#{w} ##{w} @#{w} ##{w} @#{w} ##{w} @#{w} *#{y} *#{c} *#{g} *#{x}",
+            "  #{y}*#{w} @#{w} ##{w} @#{w} ##{w} @#{w} ##{w} @#{w} ##{w} @#{w} ##{w} @#{w} ##{w} @#{w} ##{w} @#{y} *#{c} *#{x}",
+            "  #{c}*#{y} *#{w} @#{w} ##{w} @#{w} ##{w} @#{w} ##{w} @#{w} ##{w} @#{w} ##{w} @#{w} *#{y} *#{c} *#{g} *#{x}",
+            "  #{g}*#{c} *#{y} *#{w} @#{w} ##{w} @#{w} ##{w} @#{w} ##{w} @#{w} ##{w} @#{w} *#{y} *#{c} *#{g} *#{m} *#{x}",
+            "  #{m}*#{g} *#{c} *#{C} *#{y} *#{Y} *#{y} *#{Y} *#{y} *#{Y} *#{y} *#{Y} *#{C} *#{c} *#{g} *#{m} *#{b} *#{x}",
+            "  #{d}. #{m}*#{g} *#{c} *#{C} *#{c} *#{C} *#{c} *#{C} *#{c} *#{C} *#{c} *#{C} *#{c} *#{g} *#{m} *#{d} .#{x}",
+            "  #{d}. . #{b}*#{m} *#{r} *#{o} *#{g} *#{c} *#{g} *#{c} *#{g} *#{o} *#{r} *#{m} *#{b} *#{d} . . .#{x}",
+          ],
+          # Frame 9 — settling, warm glow
+          [
+            "  #{d}. . . . #{b}*#{m} *#{g} *#{c} *#{g} *#{c} *#{g} *#{c} *#{g} *#{m} *#{b} *#{d} . . . . .#{x}",
+            "  #{d}. . . #{m}*#{g} *#{c} *#{C} *#{c} *#{C} *#{c} *#{C} *#{c} *#{C} *#{c} *#{g} *#{m} *#{d} . . .#{x}",
+            "  #{d}. . #{g}*#{c} *#{C} *#{y} *#{Y} *#{y} *#{Y} *#{y} *#{Y} *#{y} *#{C} *#{c} *#{g} *#{d} . . .#{x}",
+            "  #{d}. #{g}*#{c} *#{y} *#{Y} *#{y} *#{w} @#{y} *#{w} @#{y} *#{Y} *#{y} *#{c} *#{g} *#{m} *#{d} . .#{x}",
+            "  #{d}. #{c}*#{y} *#{w} @#{y} @#{w} ##{w} @#{w} ##{w} @#{w} ##{y} @#{w} *#{y} *#{c} *#{g} *#{d} . . .#{x}",
+            "  #{g}*#{c} *#{y} *#{w} @#{w} ##{w} @#{w} ##{w} @#{w} ##{w} @#{w} ##{w} @#{y} *#{y} *#{c} *#{g} *#{d} .#{x}",
+            "  #{d}. #{c}*#{y} *#{w} @#{y} @#{w} ##{w} @#{w} ##{w} @#{w} ##{y} @#{w} *#{y} *#{c} *#{g} *#{d} . . .#{x}",
+            "  #{d}. #{g}*#{c} *#{y} *#{Y} *#{y} *#{w} @#{y} *#{w} @#{y} *#{Y} *#{y} *#{c} *#{g} *#{m} *#{d} . .#{x}",
+            "  #{d}. . #{g}*#{c} *#{C} *#{y} *#{Y} *#{y} *#{Y} *#{y} *#{Y} *#{y} *#{C} *#{c} *#{g} *#{d} . . .#{x}",
+            "  #{d}. . . #{m}*#{g} *#{c} *#{C} *#{c} *#{C} *#{c} *#{C} *#{c} *#{C} *#{c} *#{g} *#{m} *#{d} . . .#{x}",
+            "  #{d}. . . . #{b}*#{m} *#{g} *#{c} *#{g} *#{c} *#{g} *#{c} *#{g} *#{m} *#{b} *#{d} . . . . .#{x}",
+          ],
+          # Frame 10 — fading to green glow
+          [
+            "  #{d}. . . . . . . . . . . . . . . . . . . . . . . .#{x}",
+            "  #{d}. . . . . . #{G}*#{g} *#{G} *#{g} *#{G} *#{g} *#{G} *#{g} *#{G} *#{d} . . . . . .#{x}",
+            "  #{d}. . . . . #{g}*#{G} *#{g} *#{G} *#{g} *#{G} *#{g} *#{G} *#{g} *#{G} *#{g} *#{d} . . . . .#{x}",
+            "  #{d}. . . . #{g}*#{c} *#{g} *#{c} *#{g} *#{Y} *#{g} *#{c} *#{g} *#{c} *#{g} *#{d} . . . . . .#{x}",
+            "  #{d}. . . #{g}*#{c} *#{C} *#{y} *#{Y} *#{y} *#{Y} *#{y} *#{C} *#{c} *#{g} *#{d} . . . . . . .#{x}",
+            "  #{d}. . . #{g}*#{c} *#{y} *#{Y} *#{y} *#{w} @#{y} *#{Y} *#{y} *#{c} *#{g} *#{d} . . . . . . .#{x}",
+            "  #{d}. . . #{g}*#{c} *#{C} *#{y} *#{Y} *#{y} *#{Y} *#{y} *#{C} *#{c} *#{g} *#{d} . . . . . . .#{x}",
+            "  #{d}. . . . #{g}*#{c} *#{g} *#{c} *#{g} *#{Y} *#{g} *#{c} *#{g} *#{c} *#{g} *#{d} . . . . . .#{x}",
+            "  #{d}. . . . . #{g}*#{G} *#{g} *#{G} *#{g} *#{G} *#{g} *#{G} *#{g} *#{G} *#{g} *#{d} . . . . .#{x}",
+            "  #{d}. . . . . . #{G}*#{g} *#{G} *#{g} *#{G} *#{g} *#{G} *#{g} *#{G} *#{d} . . . . . .#{x}",
+            "  #{d}. . . . . . . . . . . . . . . . . . . . . . . .#{x}",
+          ],
+          # Frame 11 — almost gone, warm ember
+          [
+            "  #{d}. . . . . . . . . . . . . . . . . . . . . . . .#{x}",
+            "  #{d}. . . . . . . . . . . . . . . . . . . . . . . .#{x}",
+            "  #{d}. . . . . . . . #{G}*#{g} *#{G} *#{g} *#{G} *#{g} *#{d} . . . . . . . .#{x}",
+            "  #{d}. . . . . . . #{g}*#{G} *#{g} *#{G} *#{g} *#{G} *#{g} *#{d} . . . . . . .#{x}",
+            "  #{d}. . . . . . . #{g}*#{c} *#{g} *#{Y} *#{g} *#{c} *#{g} *#{d} . . . . . . .#{x}",
+            "  #{d}. . . . . . . . #{g}*#{G} *#{g} *#{G} *#{g} *#{d} . . . . . . . . .#{x}",
+            "  #{d}. . . . . . . . . #{G}*#{g} *#{G} *#{d} . . . . . . . . . . .#{x}",
+            "  #{d}. . . . . . . . . . . . . . . . . . . . . . . .#{x}",
+            "  #{d}. . . . . . . . . . . . . . . . . . . . . . . .#{x}",
+            "  #{d}. . . . . . . . . . . . . . . . . . . . . . . .#{x}",
+            "  #{d}. . . . . . . . . . . . . . . . . . . . . . . .#{x}",
+          ],
+      ]
+
+      # Pad lines so all rows in each frame have equal stripped length —
+      # prevents the player's per-line centering from misaligning the art.
+      max = raw_frames.flatten.map { |l| l.gsub(/\e\[[0-9;]*m/, "").length }.max
+      raw_frames.each do |frame|
+        frame.map! { |l| l + " " * (max - l.gsub(/\e\[[0-9;]*m/, "").length) }
+      end
+
+      DATA = {
+        name: "Celebrate",
+        fps: 8,
+        frames: raw_frames
+      }.freeze
+    end
+  end
+end

data/lib/fun_ci/animations/explosion.rb

@@ -0,0 +1,138 @@
+# frozen_string_literal: true
+
+module FunCi
+  module Animations
+    module Explosion
+      # Failure explosion animation — expanding fireball with debris
+      # Run: ruby exe/animation-player animations/explosion.rb
+
+      r = "\e[1;31m"  # bold red
+      o = "\e[38;5;208m" # orange
+      y = "\e[1;33m"  # bold yellow
+      w = "\e[1;37m"  # bold white
+      d = "\e[2;31m"  # dim red
+      k = "\e[38;5;52m" # dark red
+      x = "\e[0m"     # reset
+
+      raw_frames = [
+          # Frame 1 — spark
+          [
+            "",
+            "",
+            "",
+            "",
+            "             #{w}*#{x}",
+            "",
+            "",
+            "",
+            "",
+            "",
+          ],
+          # Frame 2 — ignition
+          [
+            "",
+            "",
+            "",
+            "            #{y}\\|/#{x}",
+            "            #{w}-#{r}*#{w}-#{x}",
+            "            #{y}/|\\#{x}",
+            "",
+            "",
+            "",
+            "",
+          ],
+          # Frame 3 — small burst
+          [
+            "",
+            "",
+            "           #{o}. * .#{x}",
+            "          #{y}*#{r}(#)#{y}*#{x}",
+            "         #{r}(#{y}*#{w}@@@#{y}*#{r})#{x}",
+            "          #{y}*#{r}(#)#{y}*#{x}",
+            "           #{o}' * '#{x}",
+            "",
+            "",
+            "",
+          ],
+          # Frame 4 — expanding fireball
+          [
+            "",
+            "          #{o}*  .  *#{x}",
+            "        #{y}.#{r}* #{o}( ) #{r}*#{y}.#{x}",
+            "       #{r}(#{y}*#{w} @@@@@ #{y}*#{r})#{x}",
+            "      #{r}(#{o}*#{w}@@@#{y}X#{w}@@@#{o}*#{r})#{x}",
+            "       #{r}(#{y}*#{w} @@@@@ #{y}*#{r})#{x}",
+            "        #{y}'#{r}* #{o}( ) #{r}*#{y}'#{x}",
+            "          #{o}*  '  *#{x}",
+            "",
+            "",
+          ],
+          # Frame 5 — full explosion
+          [
+            "        #{d}. #{o}*   *  .#{d} .#{x}",
+            "      #{o}*  #{y}.#{r}*     *#{y}.  #{o}*#{x}",
+            "    #{y}. #{r}*#{o}(#{w} @@@@@@@@ #{o})#{r}*#{y} .#{x}",
+            "   #{r}( #{y}*#{w}@@@@#{y}BOOM#{w}@@@@#{y}* #{r})#{x}",
+            "  #{r}(#{o}*#{w}@@@@@@@#{y}X#{w}@@@@@@@#{o}*#{r})#{x}",
+            "   #{r}( #{y}*#{w}@@@@@@@@@@@#{y}* #{r})#{x}",
+            "    #{y}' #{r}*#{o}(#{w} @@@@@@@@ #{o})#{r}*#{y} '#{x}",
+            "      #{o}*  #{y}'#{r}*     *#{y}'  #{o}*#{x}",
+            "        #{d}' #{o}*   *  '#{d} '#{x}",
+            "",
+          ],
+          # Frame 6 — debris flying out
+          [
+            "    #{d}.#{x}    #{o}*#{x}         #{o}*#{x}   #{d}.#{x}",
+            "       #{o}. #{y}*#{x}  #{d}.  .#{x}  #{y}* #{o}.#{x}",
+            "     #{y}*#{x}  #{r}*#{o}( #{d}::::: #{o})#{r}*#{x}  #{y}*#{x}",
+            "    #{r}(#{x} #{y}*#{x} #{d}::#w}@@#{y}X#{w}@@#{d}::#{x} #{y}*#{x} #{r})#{x}",
+            "   #{o}*#{x}  #{d}:::#{w}@@@@@@@#{d}:::#{x}  #{o}*#{x}",
+            "    #{r}(#{x} #{y}*#{x} #{d}::#{w}@@@@@#{d}::#{x} #{y}*#{x} #{r})#{x}",
+            "     #{y}*#{x}  #{r}*#{o}( #{d}::::: #{o})#{r}*#{x}  #{y}*#{x}",
+            "       #{o}' #{y}*#{x}  #{d}'  '#{x}  #{y}* #{o}'#{x}",
+            "    #{d}'#{x}    #{o}*#{x}         #{o}*#{x}   #{d}'#{x}",
+            "  #{d}.#{x}         #{d}. .#{x}         #{d}.#{x}",
+          ],
+          # Frame 7 — dissipating smoke
+          [
+            "  #{d}.#{x}       #{d}.#{x}       #{d}.#{x}       #{d}.#{x}",
+            "      #{d}*#{x}            #{d}*#{x}",
+            "         #{d}. #{k}::: #{d}.#{x}",
+            "    #{d}*#{x}   #{k}::#{d}.....#{k}::#{x}   #{d}*#{x}",
+            "        #{k}:#{d}..   ..#{k}:#{x}",
+            "    #{d}*#{x}   #{k}::#{d}.....#{k}::#{x}   #{d}*#{x}",
+            "         #{d}' #{k}::: #{d}'#{x}",
+            "      #{d}*#{x}            #{d}*#{x}",
+            "  #{d}'#{x}       #{d}'#{x}       #{d}'#{x}       #{d}'#{x}",
+            "",
+          ],
+          # Frame 8 — fading embers
+          [
+            "",
+            "     #{d}.#{x}         #{d}.#{x}",
+            "",
+            "          #{k}. . .#{x}",
+            "   #{d}.#{x}    #{k}.     .#{x}    #{d}.#{x}",
+            "          #{k}' ' '#{x}",
+            "",
+            "     #{d}'#{x}         #{d}'#{x}",
+            "",
+            "",
+          ],
+      ]
+
+      # Pad lines so all rows in each frame have equal stripped length —
+      # prevents the player's per-line centering from misaligning the art.
+      max = raw_frames.flatten.map { |l| l.gsub(/\e\[[0-9;]*m/, "").length }.max
+      raw_frames.each do |frame|
+        frame.map! { |l| l + " " * (max - l.gsub(/\e\[[0-9;]*m/, "").length) }
+      end
+
+      DATA = {
+        name: "Explosion",
+        fps: 8,
+        frames: raw_frames
+      }.freeze
+    end
+  end
+end