jumbotron 0.1.6 → 0.2.0

data/app/workflows/jumbotron/workflows/sandbox/reset_projection_workflow.rb

@@ -0,0 +1,158 @@
+# frozen_string_literal: true
+
+module Jumbotron
+  module Workflows
+    module Sandbox
+      class ResetProjectionWorkflow < CommandTower::Workflows::ApplicationWorkflow
+        include Jumbotron::Workflows::PublicRead
+
+        retry_strategy :none
+
+        def call(**kwargs)
+          deserialized = Jumbotron::Deserializers::Public::ResetSandboxProjection.call(kwargs)
+          return map_deserializer_failure(deserialized) unless deserialized.success?
+
+          request = deserialized.input
+          projection = Jumbotron::SandboxProjection.find_by(name: request.sandbox)
+          return missing_projection if projection.nil?
+          return unsafe_projection if unsafe_projection?(projection)
+
+          built = Jumbotron::Services::Sandbox::BuildSourceSnapshot.call(
+            projection: projection,
+            start_week: request.start_week,
+            anchor_day: request.anchor_day,
+            now: request.now
+          )
+          return map_service_failure(built) unless built.success?
+
+          reset_in_transaction(projection, built.data[:snapshot], request.now)
+        end
+
+        private
+
+        def reset_in_transaction(projection, snapshot, reset_at)
+          transaction do
+            projection = Jumbotron::SandboxProjection.lock.find(projection.id)
+            counts = exact_retry?(projection, snapshot) ? retry_counts : reconcile!(projection, snapshot, reset_at)
+            validation = Jumbotron::Services::Sandbox::ValidateProjectedSeason.call(
+              projection: projection,
+              snapshot: snapshot,
+              now: reset_at
+            )
+            fail_transaction!(map_service_failure(validation)) unless validation.success?
+
+            counts[:start_week] = validation.data[:start_week_game_count]
+            counts[:naturally_locked] = validation.data[:naturally_locked_game_count]
+            persist_success!(projection, snapshot, reset_at)
+            render_result!(projection, snapshot, counts, reset_at)
+          end
+        end
+
+        def reconcile!(projection, snapshot, reset_at)
+          change_set = Jumbotron::Canonical::ChangeSet.new
+          added = 0
+
+          snapshot.games.each do |projected_game|
+            projected = Jumbotron::Services::Sandbox::ProjectGame.call(
+              projection: projection,
+              projected_game: projected_game,
+              observed_at: reset_at,
+              change_set: change_set
+            )
+            fail_transaction!(map_service_failure(projected)) unless projected.success?
+            added += 1 if projected.data[:created]
+          end
+
+          removed = remove_stale!(projection, snapshot)
+          geometry = Jumbotron::Services::Sandbox::RemoveEmptyProjectionGeometry.call(projection: projection)
+          fail_transaction!(map_service_failure(geometry)) unless geometry.success?
+          seed_all!(projection, snapshot, reset_at, change_set)
+          {
+            added: added,
+            updated: snapshot.games.count - added,
+            removed: removed,
+            start_week: 0,
+            naturally_locked: 0
+          }
+        end
+
+        def remove_stale!(projection, snapshot)
+          current_source_ids = snapshot.games.map(&:source_game_id)
+          stale = projection.sandbox_game_mappings.where.not(source_game_id: current_source_ids).to_a
+          stale.each do |mapping|
+            result = Jumbotron::Services::Sandbox::RemoveMappedGame.call(mapping: mapping)
+            fail_transaction!(map_service_failure(result)) unless result.success?
+          end
+          stale.count
+        end
+
+        def seed_all!(projection, snapshot, reset_at, change_set)
+          mappings = projection.sandbox_game_mappings.index_by(&:source_game_id)
+          snapshot.games.each do |projected_game|
+            result = Jumbotron::Services::Sandbox::SeedProjectedGame.call(
+              game: mappings.fetch(projected_game.source_game_id).sandbox_game,
+              observed_at: reset_at,
+              change_set: change_set
+            )
+            fail_transaction!(map_service_failure(result)) unless result.success?
+          end
+        end
+
+        def render_result!(projection, snapshot, counts, reset_at)
+          assembled = Jumbotron::Services::Public::AssembleSandboxProjectionReset.call(
+            projection: projection,
+            snapshot: snapshot,
+            counts: counts,
+            reset_at: reset_at
+          )
+          fail_transaction!(map_service_failure(assembled)) unless assembled.success?
+
+          success(payload: { sandbox_reset: assembled.data[:public_reset] }, http_status: :ok)
+        end
+
+        def persist_success!(projection, snapshot, reset_at)
+          projection.update!(
+            last_reset_fingerprint: snapshot.fingerprint,
+            last_reset_at: reset_at,
+            last_date_shift_days: snapshot.date_shift_days
+          )
+        end
+
+        def exact_retry?(projection, snapshot)
+          projection.last_reset_fingerprint == snapshot.fingerprint
+        end
+
+        def retry_counts
+          { added: 0, updated: 0, removed: 0, start_week: 0, naturally_locked: 0 }
+        end
+
+        def unsafe_projection?(projection)
+          projection.adapter_id != "sandbox_nfl" ||
+            projection.sandbox_season.league.name != "nfl-sandbox" ||
+            projection.source_season_id == projection.sandbox_season_id
+        end
+
+        def missing_projection
+          failure(
+            errors: [Jumbotron::Errors::Sandbox::ProjectionNotFoundError.new],
+            http_status: :not_found
+          )
+        end
+
+        def unsafe_projection
+          failure(
+            errors: [
+              Jumbotron::Errors::Sandbox::ProjectionRejectedError.new(
+                details: {
+                  code: "sandbox_target_forbidden",
+                  message: "reset target is not a registered sandbox season"
+                }
+              )
+            ],
+            http_status: :unprocessable_entity
+          )
+        end
+      end
+    end
+  end
+end

data/app/workflows/jumbotron/workflows/synchronize_adapter_workflow.rb

@@ -94,63 +94,15 @@ module Jumbotron
       end
 
       def sync_one_game!(game_input, league, observed_at, change_set)
-        season_result = Services::Canonical::EnsureSeason.call(
-          league: league,
-          year: game_input.season_year
-        )
-        fail_on_service_failure!(season_result)
-
-        phase_result = Services::Canonical::EnsureSeasonPhase.call(
-          season: season_result.data[:season],
-          phase_key: game_input.season_phase_key
-        )
-        fail_on_service_failure!(phase_result)
-
-        group_result = Services::Canonical::EnsureScheduleGroup.call(
-          season: season_result.data[:season],
-          season_phase: phase_result.data[:season_phase],
-          schedule_group_input: game_input.schedule_group
-        )
-        fail_on_service_failure!(group_result)
-
-        venue_result = Services::Canonical::UpsertVenue.call(
-          venue_input: game_input.venue,
-          observed_at: observed_at,
-          change_set: change_set
-        )
-        fail_on_service_failure!(venue_result)
-
-        game_result = Services::Canonical::UpsertGame.call(
+        result = Services::Canonical::UpsertGameGraph.call(
           game_input: game_input,
           league: league,
-          season: season_result.data[:season],
-          season_phase: phase_result.data[:season_phase],
-          schedule_group: group_result.data[:schedule_group],
-          venue: venue_result.data[:venue],
           observed_at: observed_at,
           change_set: change_set
         )
-        fail_on_service_failure!(game_result)
-
-        game = game_result.data[:game]
-
-        attach = Services::Canonical::AttachProviderIdentities.call(
-          target: game,
-          refs: game_input.provider_identities
-        )
-        fail_on_service_failure!(attach)
-
-        game_input.participants.each do |participant_input|
-          gp_result = Services::Canonical::UpsertGameParticipant.call(
-            game: game,
-            participant_input: participant_input,
-            observed_at: observed_at,
-            change_set: change_set
-          )
-          fail_on_service_failure!(gp_result)
-        end
+        fail_on_service_failure!(result)
 
-        game
+        result.data[:game]
       end
 
       def fail_on_service_failure!(service_result)

data/db/migrate/20260828220001_add_game_presentation_contract_fields.rb

@@ -0,0 +1,19 @@
+# frozen_string_literal: true
+
+class AddGamePresentationContractFields < ActiveRecord::Migration[8.0]
+  def change
+    change_table :jumbotron_game_participants, bulk: true do |t|
+      t.string :record_summary_entering
+      t.string :record_summary_current
+      t.string :record_summary_post_game
+      t.datetime :record_observed_at
+    end
+
+    change_table :jumbotron_venues, bulk: true do |t|
+      t.string :city
+      t.string :region
+    end
+
+    add_column :jumbotron_teams, :abbreviation, :string
+  end
+end

data/db/migrate/20260908000001_create_jumbotron_sandbox_game_plans.rb

@@ -0,0 +1,16 @@
+# frozen_string_literal: true
+
+class CreateJumbotronSandboxGamePlans < ActiveRecord::Migration[8.1]
+  def change
+    create_table :jumbotron_sandbox_game_plans do |t|
+      t.references :game,
+                   null: false,
+                   foreign_key: { to_table: :jumbotron_games },
+                   index: { unique: true }
+      t.integer :home_score, null: false
+      t.integer :away_score, null: false
+      t.datetime :selected_at, null: false
+      t.timestamps
+    end
+  end
+end

data/db/migrate/20260908000002_create_jumbotron_sandbox_projections.rb

@@ -0,0 +1,39 @@
+# frozen_string_literal: true
+
+class CreateJumbotronSandboxProjections < ActiveRecord::Migration[8.1]
+  def change
+    create_table :jumbotron_sandbox_projections do |t|
+      t.string :name, null: false
+      t.references :source_season, null: false, foreign_key: { to_table: :jumbotron_seasons }
+      t.references :source_anchor_phase, null: false, foreign_key: { to_table: :jumbotron_season_phases }
+      t.references :sandbox_season,
+                   null: false,
+                   foreign_key: { to_table: :jumbotron_seasons },
+                   index: { unique: true }
+      t.string :adapter_id, null: false
+      t.string :calendar_time_zone, null: false
+      t.string :last_reset_fingerprint
+      t.datetime :last_reset_at
+      t.integer :last_date_shift_days
+      t.timestamps
+    end
+    add_index :jumbotron_sandbox_projections, :name, unique: true
+
+    create_table :jumbotron_sandbox_game_mappings do |t|
+      t.references :sandbox_projection, null: false, foreign_key: { to_table: :jumbotron_sandbox_projections }
+      t.references :source_game, null: false, foreign_key: { to_table: :jumbotron_games }
+      t.references :sandbox_game,
+                   null: false,
+                   foreign_key: { to_table: :jumbotron_games },
+                   index: { unique: true }
+      t.decimal :home_spread, precision: 6, scale: 2, null: false
+      t.decimal :total, precision: 6, scale: 2, null: false
+      t.string :line_fingerprint, null: false
+      t.timestamps
+    end
+    add_index :jumbotron_sandbox_game_mappings,
+              %i[sandbox_projection_id source_game_id],
+              unique: true,
+              name: "idx_jumbotron_sandbox_mapping_source"
+  end
+end

data/docs/upgrades/0.2.0.md

@@ -0,0 +1,74 @@
+# Upgrade: Jumbotron 0.2.0
+
+**From:** `0.1.7`  
+**To:** `0.2.0`
+
+Minor release: named NFL sandbox projection and Reset/reprojection behind the public client. ESPN `espn_nfl` read and update contracts are unchanged.
+
+## Host-facing change
+
+| Change | Host impact |
+|--------|-------------|
+| `sandbox_nfl` adapter | In-process NFL sandbox adapter (`league: nfl-sandbox`) with the same Game/Line policy set as ESPN. Not ESPN I/O. |
+| `Jumbotron.client.register_sandbox_projection` | Idempotent named bind of a sandbox to immutable source selectors. Rejects conflicting redefinition. |
+| `Jumbotron.client.reset_sandbox_projection` | Whole-season Reset: Eastern calendar-day shift, stable source→sandbox game mappings, complete projection or no commit. |
+| Sandbox public errors | Structured `code` + safe `details` on public exceptions (`SandboxResetRejectedError` and mapped sandbox failures). |
+| Recurring schedules | Desired schedules now include `jumbotron:sandbox_nfl:*` policy keys (still no `full_season` discovery cron). |
+| Temporary `json < 3` gemspec constraint | Bundler will refuse json 3.x for any host that depends on this gem. Not a Jumbotron API change. See below. |
+
+## Upgrade checklist
+
+1. Bump gem to `0.2.0` (or `>= 0.2.0`).
+2. Copy engine migrations and migrate:
+
+   ```bash
+   bin/rails jumbotron:install:migrations
+   bin/rails db:migrate
+   ```
+
+   New engine files:
+
+   - `20260908000001_create_jumbotron_sandbox_game_plans.rb`
+   - `20260908000002_create_jumbotron_sandbox_projections.rb` (also creates `jumbotron_sandbox_game_mappings`)
+
+3. Rematerialize Solid Queue recurring YAML so `jumbotron:sandbox_nfl:*` keys appear if the host should run sandbox polls:
+
+   ```bash
+   bin/rails jumbotron:schedules:materialize
+   ```
+
+   Host-owned keys (`pickem:*`, `clear_solid_queue_finished_jobs`) are preserved. ESPN `jumbotron:espn_nfl:*` keys are unchanged.
+
+4. Optional: register then Reset a named projection from a host (no HTTP in Jumbotron):
+
+   ```ruby
+   Jumbotron.client.register_sandbox_projection(name: "nfl-sandbox", source: "nfl")
+   Jumbotron.client.reset_sandbox_projection(
+     sandbox: "nfl-sandbox",
+     start_week: 1,
+     anchor_day: 1,
+     now: Time.current.iso8601
+   )
+   ```
+
+## Temporary `json < 3` constraint
+
+**Why.** json 3.0 made `JSON.parse` keyword-only. Released Rails 8.1.3.1 still does `JSON.parse(json, options)` with a positional Hash (default `{}` even when callers pass no options). That raises `ArgumentError: wrong number of arguments (given 2, expected 1)` on every `ActiveSupport::JSON.decode`, including ActiveRecord `:json` attributes (`ObservationBatch`, `LineObservation`, `HistoricalChange`) and ActionDispatch JSON request bodies.
+
+A Gemfile pin in this engine repo only protects dummy-app CI. Hosts (Pick'em, others) resolve `json` from their own lockfiles. Putting `json < 3` in the **gemspec** makes Bundler enforce the ceiling wherever Jumbotron is a dependency.
+
+This is a workaround for a Rails/json incompatibility, not a Jumbotron product dependency. Rails main / `8-1-stable` already splat (`JSON.parse(json, **options)`); no Rails gem that includes that fix was published at 0.2.0 (`8.1.3.1` is still latest).
+
+**Undo when all of the following are true:**
+
+1. A Rails gem is released whose `ActiveSupport::JSON.decode` calls `JSON.parse(json, **options)` (or equivalent: no positional options Hash). Confirm in that gem's `activesupport/lib/active_support/json/decoding.rb`.
+2. Every Jumbotron host is on that Rails version (or newer). Pick'em today is `~> 8.1.3`, `>= 8.1.3.1`.
+3. Then remove `spec.add_dependency "json", "< 3"` from `jumbotron.gemspec`, `bundle install` in Docker, drop this section, and drop the packaging example that asserts the ceiling.
+
+Do not undo just because a host Gemfile pins json, or because Jumbotron CI happens to lock 2.x.
+
+## What is not in this release
+
+- No ESPN public Game/Schedule/Consensus/CurrentLines contract change.
+- No Pick'em competitive domain. Hosts own whether they materialize sandbox seasons and whether production runs `sandbox_nfl` polls.
+- No new `full_season` discovery job for sandbox (sandbox catalog is projected, not ESPN-discovered).

data/lib/jumbotron/client.rb

@@ -2,6 +2,20 @@
 
 module Jumbotron
   class Client
+    def register_sandbox_projection(**)
+      Public::TranslateOutcome.call(
+        Workflows::Sandbox::RegisterProjectionWorkflow.call(**),
+        payload_key: :sandbox_projection
+      )
+    end
+
+    def reset_sandbox_projection(**)
+      Public::TranslateOutcome.call(
+        Workflows::Sandbox::ResetProjectionWorkflow.call(**),
+        payload_key: :sandbox_reset
+      )
+    end
+
     def schedule(**)
       Public::TranslateOutcome.call(
         Workflows::ReadScheduleWorkflow.call(**),

data/lib/jumbotron/version.rb

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

data/spec/factories/jumbotron/sandbox_game_mapping.rb

@@ -0,0 +1,24 @@
+# frozen_string_literal: true
+
+FactoryBot.define do
+  factory :jumbotron_sandbox_game_mapping, class: "Jumbotron::SandboxGameMapping" do
+    association :sandbox_projection, factory: :jumbotron_sandbox_projection
+    source_game do
+      association(
+        :jumbotron_game,
+        season: sandbox_projection.source_season,
+        league: sandbox_projection.source_season.league
+      )
+    end
+    sandbox_game do
+      association(
+        :jumbotron_game,
+        season: sandbox_projection.sandbox_season,
+        league: sandbox_projection.sandbox_season.league
+      )
+    end
+    home_spread { BigDecimal("-3.5") }
+    total { BigDecimal("44.5") }
+    line_fingerprint { "line-v1" }
+  end
+end

data/spec/factories/jumbotron/sandbox_game_plan.rb

@@ -0,0 +1,10 @@
+# frozen_string_literal: true
+
+FactoryBot.define do
+  factory :jumbotron_sandbox_game_plan, class: "Jumbotron::SandboxGamePlan" do
+    association :game, factory: :jumbotron_game
+    home_score { 24 }
+    away_score { 20 }
+    selected_at { Time.current }
+  end
+end

data/spec/factories/jumbotron/sandbox_projection.rb

@@ -0,0 +1,18 @@
+# frozen_string_literal: true
+
+FactoryBot.define do
+  factory :jumbotron_sandbox_projection, class: "Jumbotron::SandboxProjection" do
+    sequence(:name) { |number| "sandbox-#{number}" }
+    association :source_season, factory: :jumbotron_season
+    source_anchor_phase do
+      association :jumbotron_season_phase, season: source_season, name: "regular_season"
+    end
+    sandbox_season do
+      sport = association(:jumbotron_sport, name: "football")
+      league = association(:jumbotron_league, sport: sport, name: "nfl-sandbox")
+      association(:jumbotron_season, league: league, name: name)
+    end
+    adapter_id { "sandbox_nfl" }
+    calendar_time_zone { "America/New_York" }
+  end
+end

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: jumbotron
 version: !ruby/object:Gem::Version
-  version: 0.1.6
+  version: 0.2.0
 platform: ruby
 authors:
 - matt-taylor
 autorequire: 
 bindir: bin
 cert_chain: []
-date: 2026-08-28 00:00:00.000000000 Z
+date: 2026-09-09 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: command_tower
@@ -44,6 +44,20 @@ dependencies:
     - - "<"
       - !ruby/object:Gem::Version
         version: '9.0'
+- !ruby/object:Gem::Dependency
+  name: json
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "<"
+      - !ruby/object:Gem::Version
+        version: '3'
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "<"
+      - !ruby/object:Gem::Version
+        version: '3'
 description: Jumbotron owns canonical sports truth independently of ESPN and Pick'em.
 email:
 - ''
@@ -71,6 +85,18 @@ files:
 - app/adapters/jumbotron/adapters/operation.rb
 - app/adapters/jumbotron/adapters/policy_definition.rb
 - app/adapters/jumbotron/adapters/registry.rb
+- app/adapters/jumbotron/adapters/sandbox/nfl.rb
+- app/adapters/jumbotron/adapters/sandbox/nfl_helpers/acquisition_scope.rb
+- app/adapters/jumbotron/adapters/sandbox/nfl_helpers/competition_odds.rb
+- app/adapters/jumbotron/adapters/sandbox/nfl_helpers/current_observation_state.rb
+- app/adapters/jumbotron/adapters/sandbox/nfl_helpers/line_acquisition_scope.rb
+- app/adapters/jumbotron/adapters/sandbox/nfl_helpers/monotonic_observation.rb
+- app/adapters/jumbotron/adapters/sandbox/nfl_helpers/observation_values.rb
+- app/adapters/jumbotron/adapters/sandbox/nfl_helpers/outcome_candidates.rb
+- app/adapters/jumbotron/adapters/sandbox/nfl_helpers/projection.rb
+- app/adapters/jumbotron/adapters/sandbox/nfl_helpers/scoreboard.rb
+- app/adapters/jumbotron/adapters/sandbox/nfl_helpers/synthetic_observation.rb
+- app/adapters/jumbotron/adapters/sandbox/nfl_helpers/timeline_observation.rb
 - app/boot/jumbotron/boot/enqueue_discoveries.rb
 - app/clients/jumbotron/clients.rb
 - app/clients/jumbotron/clients/espn.rb
@@ -91,6 +117,7 @@ files:
 - app/deserializers/jumbotron/deserializers/clients/espn/competition_odds/side_quote.rb
 - app/deserializers/jumbotron/deserializers/clients/espn/competition_odds/team_odds.rb
 - app/deserializers/jumbotron/deserializers/clients/espn/competitor.rb
+- app/deserializers/jumbotron/deserializers/clients/espn/competitor_record.rb
 - app/deserializers/jumbotron/deserializers/clients/espn/event.rb
 - app/deserializers/jumbotron/deserializers/clients/espn/scoreboard/get.rb
 - app/deserializers/jumbotron/deserializers/clients/espn/season.rb
@@ -99,18 +126,23 @@ files:
 - app/deserializers/jumbotron/deserializers/clients/espn/team.rb
 - app/deserializers/jumbotron/deserializers/clients/espn/teams/get.rb
 - app/deserializers/jumbotron/deserializers/clients/espn/venue.rb
+- app/deserializers/jumbotron/deserializers/clients/espn/venue_address.rb
 - app/deserializers/jumbotron/deserializers/clients/espn/week.rb
 - app/deserializers/jumbotron/deserializers/public/game.rb
 - app/deserializers/jumbotron/deserializers/public/game_ids.rb
 - app/deserializers/jumbotron/deserializers/public/includes.rb
+- app/deserializers/jumbotron/deserializers/public/register_sandbox_projection.rb
+- app/deserializers/jumbotron/deserializers/public/reset_sandbox_projection.rb
 - app/deserializers/jumbotron/deserializers/public/schedule.rb
 - app/deserializers/jumbotron/deserializers/public/schedule_groups.rb
 - app/errors/jumbotron/error.rb
 - app/errors/jumbotron/errors/adapters.rb
 - app/errors/jumbotron/errors/canonical.rb
 - app/errors/jumbotron/errors/public.rb
+- app/errors/jumbotron/errors/sandbox.rb
 - app/errors/jumbotron/invalid_request_error.rb
 - app/errors/jumbotron/not_found_error.rb
+- app/errors/jumbotron/sandbox_reset_rejected_error.rb
 - app/errors/jumbotron/unsupported_capability_error.rb
 - app/jobs/jumbotron/application_job.rb
 - app/jobs/jumbotron/discovery_job.rb
@@ -128,6 +160,10 @@ files:
 - app/models/jumbotron/provider_identity.rb
 - app/models/jumbotron/public.rb
 - app/models/jumbotron/public/translate_outcome.rb
+- app/models/jumbotron/sandbox_game_mapping.rb
+- app/models/jumbotron/sandbox_game_plan.rb
+- app/models/jumbotron/sandbox_projection.rb
+- app/models/jumbotron/sandbox_projection_data.rb
 - app/models/jumbotron/schedule_group.rb
 - app/models/jumbotron/season.rb
 - app/models/jumbotron/season_phase.rb
@@ -140,6 +176,9 @@ files:
 - app/providers/jumbotron/providers/espn/resources/competition_odds.rb
 - app/providers/jumbotron/providers/espn/resources/scoreboard.rb
 - app/providers/jumbotron/providers/espn/resources/teams.rb
+- app/providers/jumbotron/providers/sandbox/resources/competition_odds.rb
+- app/providers/jumbotron/providers/sandbox/resources/projection.rb
+- app/providers/jumbotron/providers/sandbox/resources/scoreboard.rb
 - app/scheduling/jumbotron/scheduling/backends/sidekiq_cron.rb
 - app/scheduling/jumbotron/scheduling/backends/solid_queue.rb
 - app/scheduling/jumbotron/scheduling/clock.rb
@@ -174,11 +213,14 @@ files:
 - app/services/jumbotron/services/canonical/resolve_current_lines.rb
 - app/services/jumbotron/services/canonical/resolve_current_lines_for_games.rb
 - app/services/jumbotron/services/canonical/upsert_game.rb
+- app/services/jumbotron/services/canonical/upsert_game_graph.rb
 - app/services/jumbotron/services/canonical/upsert_game_participant.rb
 - app/services/jumbotron/services/canonical/upsert_team.rb
 - app/services/jumbotron/services/canonical/upsert_venue.rb
 - app/services/jumbotron/services/public/assemble_public_game.rb
 - app/services/jumbotron/services/public/assemble_public_schedule.rb
+- app/services/jumbotron/services/public/assemble_sandbox_projection.rb
+- app/services/jumbotron/services/public/assemble_sandbox_projection_reset.rb
 - app/services/jumbotron/services/public/derive_consensus_for_games.rb
 - app/services/jumbotron/services/public/load_games_by_ids.rb
 - app/services/jumbotron/services/public/load_included_lines.rb
@@ -188,6 +230,15 @@ files:
 - app/services/jumbotron/services/public/read_schedule.rb
 - app/services/jumbotron/services/public/read_schedule_groups.rb
 - app/services/jumbotron/services/public/resolve_current_lines_for_games.rb
+- app/services/jumbotron/services/sandbox/build_source_snapshot.rb
+- app/services/jumbotron/services/sandbox/project_game.rb
+- app/services/jumbotron/services/sandbox/register_projection.rb
+- app/services/jumbotron/services/sandbox/remove_empty_projection_geometry.rb
+- app/services/jumbotron/services/sandbox/remove_mapped_game.rb
+- app/services/jumbotron/services/sandbox/resolve_game_observation.rb
+- app/services/jumbotron/services/sandbox/seed_projected_game.rb
+- app/services/jumbotron/services/sandbox/select_line_basis.rb
+- app/services/jumbotron/services/sandbox/validate_projected_season.rb
 - app/synchronization/jumbotron/synchronization/lease.rb
 - app/workflows/jumbotron/workflows/execute_discovery_workflow.rb
 - app/workflows/jumbotron/workflows/execute_game_update_policy_workflow.rb
@@ -198,6 +249,8 @@ files:
 - app/workflows/jumbotron/workflows/read_game_workflow.rb
 - app/workflows/jumbotron/workflows/read_schedule_groups_workflow.rb
 - app/workflows/jumbotron/workflows/read_schedule_workflow.rb
+- app/workflows/jumbotron/workflows/sandbox/register_projection_workflow.rb
+- app/workflows/jumbotron/workflows/sandbox/reset_projection_workflow.rb
 - app/workflows/jumbotron/workflows/synchronize_adapter_workflow.rb
 - db/migrate/20260812000001_create_jumbotron_foundational_catalog.rb
 - db/migrate/20260812000002_create_jumbotron_game_graph.rb
@@ -208,10 +261,14 @@ files:
 - db/migrate/20260820000001_add_progress_to_jumbotron_games.rb
 - db/migrate/20260827150001_add_key_to_jumbotron_teams.rb
 - db/migrate/20260828180001_add_nickname_to_jumbotron_teams.rb
+- db/migrate/20260828220001_add_game_presentation_contract_fields.rb
+- db/migrate/20260908000001_create_jumbotron_sandbox_game_plans.rb
+- db/migrate/20260908000002_create_jumbotron_sandbox_projections.rb
 - docs/testing.md
 - docs/upgrades/0.1.2.md
 - docs/upgrades/0.1.3.md
 - docs/upgrades/0.1.4.md
+- docs/upgrades/0.2.0.md
 - lib/jumbotron.rb
 - lib/jumbotron/client.rb
 - lib/jumbotron/engine.rb
@@ -226,6 +283,9 @@ files:
 - spec/factories/jumbotron/line_observation.rb
 - spec/factories/jumbotron/observation_batch.rb
 - spec/factories/jumbotron/provider_identity.rb
+- spec/factories/jumbotron/sandbox_game_mapping.rb
+- spec/factories/jumbotron/sandbox_game_plan.rb
+- spec/factories/jumbotron/sandbox_projection.rb
 - spec/factories/jumbotron/schedule_group.rb
 - spec/factories/jumbotron/season.rb
 - spec/factories/jumbotron/season_phase.rb