jumbotron 0.1.3 → 0.1.4

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 70b7fd9c8a5076c1337d2a6cf9e02016fd6cfa28ec64c9cc0a57c82ff3892698
-  data.tar.gz: 5051beb14f8770e109f382abd0729952446ecd40a50fbd143ac4e5b5746800b0
+  metadata.gz: 57d3fe24f637b7b9bcbc402ebe85a11fb860d2b2593bfe1f53f47a1d55d3b62a
+  data.tar.gz: 0d5e96cfe46ff8dad640a4ee9677e9deedaf32df7183868f13adf4a37a236c30
 SHA512:
-  metadata.gz: c684624b00cded82fb1e274b793a5e0c7cca6d0720589192def2ea53357ce933d631e59373728bfb3052343706df6684ddfd082482100aef79160a65fb8b9dbf
-  data.tar.gz: 72f5a0934b87a9008e6fc782b377ac166f762119504f646bcf4d964892475c2df66871a3222bdf81c20a8eaba264f3e5c519bbbfc5bf4acd1396ac95a94d308c
+  metadata.gz: aa98921803b8d0223cc523ce9f344857a28d71ace7140df51e026df0db2163252dd5747e9dbd0f1a849e1f0f8d3b415b00527cfccf1dc50e6c1f01d0b198c20d
+  data.tar.gz: b70bbde319e59a5b16b6f6b1484037034fdbe68dd3a87e163b96862c93f763dc5cdd0041305ddd164236b255b786858bd73e398bfe5133d4e7abd6d3789f580b

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.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.3"
+  VERSION = "0.1.4"
 end

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: jumbotron
 version: !ruby/object:Gem::Version
-  version: 0.1.3
+  version: 0.1.4
 platform: ruby
 authors:
 - matt-taylor
 autorequire: 
 bindir: bin
 cert_chain: []
-date: 2026-08-24 00:00:00.000000000 Z
+date: 2026-08-26 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: command_tower
@@ -208,6 +208,7 @@ files:
 - 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