jumbotron 0.1.2 → 0.1.4

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 919c3aee919ada06d4cee0f0870663c42441797ba0727babc0a00ead86c8630c
-  data.tar.gz: e929ed6604624bab66044aaf40c0cb8a6420aa6e838a044c881480d3b8290af5
+  metadata.gz: 57d3fe24f637b7b9bcbc402ebe85a11fb860d2b2593bfe1f53f47a1d55d3b62a
+  data.tar.gz: 0d5e96cfe46ff8dad640a4ee9677e9deedaf32df7183868f13adf4a37a236c30
 SHA512:
-  metadata.gz: 77c1b4deb6fde54b227b0cc3f41212b363dd8745dcc110ef8dffe6fdd9c1ca82f804d1d18545d59742c5a33df233ff6ba07d3ed8af4cf3d8d0f215e1678c17d9
-  data.tar.gz: 17d5b91913fd0ff210c299732ce465f77e40de6a3511b0679f3ef3e81a03fed9e3c1f1bf1fd86bd282ac93e82912dbf96e723775719f0ce5de93d1b5d4fb1887
+  metadata.gz: aa98921803b8d0223cc523ce9f344857a28d71ace7140df51e026df0db2163252dd5747e9dbd0f1a849e1f0f8d3b415b00527cfccf1dc50e6c1f01d0b198c20d
+  data.tar.gz: b70bbde319e59a5b16b6f6b1484037034fdbe68dd3a87e163b96862c93f763dc5cdd0041305ddd164236b255b786858bd73e398bfe5133d4e7abd6d3789f580b

data/app/adapters/jumbotron/adapters/espn/nfl.rb

@@ -51,7 +51,7 @@ module Jumbotron
 
         policy :live,
                type: :live_game_update,
-               cadence: Cadence.new(every: 2, unit: :minute),
+               cadence: Cadence.new(every: 1, unit: :minute),
                eligible: lambda { |game, now:|
                  return false if TERMINAL_LIFECYCLES.include?(game.lifecycle)
                  return false if INTERRUPTED_LIFECYCLES.include?(game.lifecycle)

data/app/models/jumbotron/historical_change.rb

@@ -4,6 +4,12 @@ module Jumbotron
   class HistoricalChange < ApplicationRecord
     belongs_to :observation_batch, inverse_of: :historical_changes
 
+    # Force JSON attribute types so writes are JSON.generate'd on every adapter.
+    # MariaDB stores t.json as LONGTEXT + json_valid CHECK; without :json, AR
+    # persists Ruby #inspect and discovery/evidence writes fail CheckViolation.
+    attribute :previous_value, :json
+    attribute :new_value, :json
+
     validates :subject_type, :subject_id, :attribute_name, :observed_at, :provider, presence: true
   end
 end

data/app/models/jumbotron/observation_batch.rb

@@ -9,6 +9,8 @@ module Jumbotron
              inverse_of: :observation_batch,
              dependent: :restrict_with_exception
 
+    attribute :metadata, :json, default: -> { {} }
+
     validates :provider, :adapter_scope, :observed_at, presence: true
   end
 end

data/docs/upgrades/0.1.3.md

@@ -0,0 +1,19 @@
+# Upgrade: Jumbotron 0.1.3
+
+**From:** `0.1.2`  
+**To:** `0.1.3`
+
+No public consumer contract break. Hosts must already run CommandTower `>= 0.12`.
+
+## Host-facing change
+
+| Change | Host impact |
+|--------|-------------|
+| `command_tower` gemspec floor | `>= 0.12` (was `>= 0.11`). Lockfile consumes RubyGems `0.12.0`. |
+| ESPN NFL `live` game cadence | Scoreboard refresh every **1 minute** (was 2). Still one week-scoped scoreboard call per tick, not one call per live game. |
+
+## Upgrade checklist
+
+1. Bump gem to `0.1.3` (or `>= 0.1.3`).
+2. Ensure the host Gemfile satisfies `command_tower >= 0.12`.
+3. Rematerialize Jumbotron recurring schedules so the live job uses `every minute`.

data/docs/upgrades/0.1.4.md

@@ -0,0 +1,34 @@
+# Upgrade: Jumbotron 0.1.4
+
+**From:** `0.1.3`  
+**To:** `0.1.4`
+
+Patch release for MariaDB-safe observation evidence JSON persistence. No public consumer contract break. Hosts must already run CommandTower `>= 0.12`.
+
+## Host-facing change
+
+| Change | Host impact |
+|--------|-------------|
+| `HistoricalChange` JSON coding | `previous_value` and `new_value` declare `attribute :…, :json`. Fixes `ActiveRecord::CheckViolation` on MariaDB 10.11 where `t.json` is LONGTEXT + `json_valid` CHECK (discovery / sync evidence writes). |
+| `ObservationBatch` JSON coding | `metadata` declares `attribute :metadata, :json`. Defense in depth for non-empty metadata. |
+
+## Upgrade checklist
+
+1. Bump gem to `0.1.4` (or `>= 0.1.4`).
+2. **No new migration** — runtime model coder only; existing `jumbotron_*` tables unchanged.
+3. **No** recurring schedule rematerialize required for this patch.
+4. After deploy, run a **one-shot** full-season discovery if the catalog is still empty (boot discovery remains off on Pick'em):
+
+   ```ruby
+   Jumbotron::DiscoveryJob.perform_later(
+     adapter_id: "espn_nfl",
+     discovery_id: "full_season",
+     continuation_attempt: 1
+   )
+   ```
+
+5. Smoke: `Jumbotron::Game.count` > 0 after discovery completes; live `GameUpdateJob` ticks without `CheckViolation` on evidence writes.
+
+## Dummy host (engine repo)
+
+Jumbotron dummy Compose now uses **MariaDB 10.11.14** (production parity). Recreate the Compose `mysql` volume after pulling this release.

data/lib/jumbotron/version.rb

@@ -1,5 +1,5 @@
 # frozen_string_literal: true
 
 module Jumbotron
-  VERSION = "0.1.2"
+  VERSION = "0.1.4"
 end

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: jumbotron
 version: !ruby/object:Gem::Version
-  version: 0.1.2
+  version: 0.1.4
 platform: ruby
 authors:
 - matt-taylor
 autorequire: 
 bindir: bin
 cert_chain: []
-date: 2026-08-22 00:00:00.000000000 Z
+date: 2026-08-26 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: command_tower
@@ -16,14 +16,14 @@ dependencies:
     requirements:
     - - ">="
       - !ruby/object:Gem::Version
-        version: '0.11'
+        version: '0.12'
   type: :runtime
   prerelease: false
   version_requirements: !ruby/object:Gem::Requirement
     requirements:
     - - ">="
       - !ruby/object:Gem::Version
-        version: '0.11'
+        version: '0.12'
 - !ruby/object:Gem::Dependency
   name: rails
   requirement: !ruby/object:Gem::Requirement
@@ -207,6 +207,8 @@ files:
 - db/migrate/20260820000001_add_progress_to_jumbotron_games.rb
 - docs/testing.md
 - docs/upgrades/0.1.2.md
+- docs/upgrades/0.1.3.md
+- docs/upgrades/0.1.4.md
 - lib/jumbotron.rb
 - lib/jumbotron/client.rb
 - lib/jumbotron/engine.rb