🏏 CricOS — Unified Cricket Operating System

A high-performance, modular operating system powering cricket tournaments, certified official & venue marketplaces, MCC Laws ball-by-ball scoring, real-time live match broadcasting, and double-entry financial settlements.

Interactive Console • 📚 Official GitHub Wiki • Architecture • Core Subsystems • API Modules • Android APK • Getting Started • Pipeline & Testing

📚 Official CricOS GitHub Wiki & Documentation Portal

Browse the complete multi-page CricOS Engineering & Product Wiki directly on GitHub (located in wiki/ and automatically synchronized via .github/workflows/publish-wiki.yml):

Wiki Guide	Target Audience	Scope & Contents
🏠 Wiki Home (`wiki/Home.md`)	All Users & Engineers	System Architecture Mermaid Diagram, Quick Start Pipeline Commands & Module Index
01 — Principal Architecture Guide	Staff / Principal Engineers	Core Architectural Insight, C4 Topology, 19-Migration ER Diagram, GiST Concurrency & Zero-Dependency 3D Engine
02 — Zero-to-Hero Onboarding	New Engineers & Contributors	Technology Foundations, Directory Map, `./pipeline.sh` Workflow & 40+ Term Domain Glossary
03 — Live Scoring, 3D Stadium & Wagon Wheel	Scoring & Graphics Engineers	Ball-by-Ball Engine, True `OFF-SIDE` vs `ON-SIDE` RHB/LHB Mirroring, 60fps 3D Stadium Pitch & Cricsheet Export
04 — 8-Persona RBAC & Clean Focus UX	Frontend & Security Engineers	Animated 60fps Hero $\rightarrow$ Login $\rightarrow$ `allowedPersonas` Strict Lock, Clean Focus Decluttering & WCAG AAA Themes
05 — Intelligent Weather & Pro Gear Store	Product & Commerce Engineers	5-Stadium Micro-Climate Weather, 5-Hr Match Forecast, and Pro Cricket Gear Store with 45-Min Turf Pavilion Delivery
06 — Mobile, Native Android APK & iOS	Mobile & Native Engineers	`StandaloneMobileApp`, `WebAppInterface.java` Bridge, Offline SQLite Outbox Queue, Gradle APK & iOS `WKWebView`
07 — API Reference, DB Schema & Testing	Backend & QA Engineers	Fastify REST Endpoints, OpenAPI 3.0, Double-Entry Escrow Ledger, 185 Node Domain Tests & 70 Playwright E2E Suites

🌟 Overview

CricOS unites every stakeholder in the cricket ecosystem—tournament directors, team captains, players, certified match officials, ground owners, and fans—into a single, resilient platform:

🏆 Tournament & Bracket Engine: Automated round-robin and knockout fixture bracket scheduling, points table calculations, net run rate (NRR) tracking, and match rescheduling.
🏪 Certified Provider Marketplace: On-demand booking for cricket grounds, certified umpires, scorers, commentators, and live streamers with PostgreSQL GiST temporal exclusion constraints preventing double-bookings.
🏏 MCC Laws of Cricket Scoring Engine: Ball-by-ball event-sourced scoring machine enforcing official MCC Laws (striker rotation on odd runs & 6-ball over boundaries, bowler figures, maidens, extras accounting, and fall of wickets).
⚡ Real-Time Live Match Broadcast (SSE): Channel-based Server-Sent Events pub/sub streaming match updates to scoreboards, web portals, and mobile apps with automatic keepalives.
💳 Double-Entry Financial Settlement Ledger: Integer minor-unit pricing with zero-sum balanced double-entry accounting ($\sum \text{Debits} \equiv \sum \text{Credits}$) for customer escrows, platform fees, GST taxes, dispute refunds, and provider payouts.
🛡️ Cryptographic Security & RBAC: HMAC-SHA256 zero-dependency JWT signing with timing-safe validation and strict role guards (ADMIN, ORGANISER, CAPTAIN, PLAYER, PROVIDER, SCORER).

🏗 Architecture & Monorepo Structure

CricOS is structured as a canonical, strictly-typed monorepo managed with pnpm workspaces:

CricOS/
├── apps/
│   ├── api/                    # Unified Fastify 4.x REST API & SSE Broadcast Server (26 modules)
│   ├── worker/                 # Outbox event publisher & 15-min inventory hold expiration worker
│   ├── web/                    # Organizer, scorer, and administration client portal (Next.js)
│   └── mobile/                 # Cross-platform captain, player, and live match client (React Native)
├── packages/
│   ├── contracts/              # Canonical shared DTOs, interfaces, and lifecycle status enums
│   ├── commercial/             # Fee/tax basis-point calculator & double-entry settlement ledger
│   ├── scoring/                # MCC Laws of Cricket state machine & 5-scenario golden corpus
│   └── domain/                 # Domain entity state transitions (Events, Matches, Teams, Incidents)
├── migrations/                 # Reconciled SQL migrations (0001_core.sql - 0015_incidents_reputation.sql)
├── scripts/                    # Transactional migration runner (migrate.mjs) & pilot seeder (seed.mjs)
├── tests/                      # In-memory pg-mem schema migration & deterministic seed test suite
├── pipeline.sh                 # Autonomous project doctor, low-token verification runner, & release gate
├── run_tests.sh                # Test bridge executing all workspace package test suites
├── PROJECT_CONTEXT.md          # Living working memory on disk
├── PRODUCT.md                  # Comprehensive product specifications
└── DESIGN.md                   # Dark-mode glassmorphic design tokens & principles

Workspace Packages Summary

Package	Path	Responsibility
`@cricket-platform/contracts`	`packages/contracts`	Canonical types, status enums, MoneyMinor representations, and API contracts.
`@cricket-platform/commercial`	`packages/commercial`	Fee calculations (5% basis points), GST tax (18%), and double-entry settlement ledger.
`@cricket-platform/scoring`	`packages/scoring`	Official MCC Laws scoring engine, dynamic strike rotation, maidens, and bowler figures.
`@cricket-platform/domain`	`packages/domain`	Entity lifecycle validators (Events, Matches, Teams, Incidents, Reputation).
`@cricket-platform/api`	`apps/api`	Fastify REST API with 26 modules, JWT/RBAC middleware, and real-time SSE broadcast.
`@cricket-platform/worker`	`apps/worker`	Outbox polling and background TTL hold expiration worker.

🧭 Compiled Archify Interactive Diagrams & Architecture Specs

CricOS architecture, workflows, event sequences, and lifecycles are formally modeled and compiled via Archify:

📐 System Architecture: Interactive HTML View | Spec
🔄 Scoring Workflow: Interactive HTML View | Spec
⚡ Ball Ingestion Sequence: Interactive HTML View | Spec
🌊 Live Event Data Flow: Interactive HTML View | Spec
⏱️ Match & Tournament Lifecycle: Interactive HTML View | Spec

See PROJECT_CONTEXT.md and wiki/01-Principal-Architecture-Guide.md for full blueprints and domain invariants.

⚙️ Core Subsystems

1. MCC Laws of Cricket Scoring Engine (`@cricket-platform/scoring`)

Batter Scorecards: Tracks individual runs, balls faced, boundaries (4s & 6s), strike rate, and dismissal details.
Bowler Spell Figures: Tracks legal overs/balls, maiden overs (zero runs conceded), runs conceded, wickets taken, and economy rate.
Dynamic Strike Rotation:
- Automatically swaps striker and non-striker on odd runs (1, 3, 5).
- Automatically swaps strike at the completion of each 6-ball legal over (Law 18 & 21).
Extras Accounting:
- Wides & No-Balls add penalty runs and do not increment legal balls faced.
- Byes & Leg Byes add team runs without charging the bowler's runs conceded column.
Golden Test Corpus: 5 automated test scenarios in packages/scoring/test/golden_corpus.test.ts verifying official edge cases:
1. Maiden Over & End-of-Over Strike Rotation
2. Strike Rotation across Singles, Boundaries, and Over Boundaries
3. Extras Accounting & Invariants
4. Bowler Wicket & Fall of Wickets (FOW) Tracking
5. Non-Striker Run Out (bowler is not credited with wicket)

2. Real-Time Live Match Broadcast Hub (`apps/api`)

Pub/Sub Channel Multiplexer: MatchBroadcastHub manages isolated match subscription channels.
Server-Sent Events Stream: GET /api/v1/scoring/matches/:id/live opens persistent SSE connection pushing initial state and real-time event updates:
- BALL_BOWLED: Delivers ball details and updated innings state.
- OVER_COMPLETED: Signals end of over and strike rotation.
- WICKET_FALLEN: Broadcasts dismissal details and updated fall of wickets.
- INNINGS_CLOSED: Signals target achieved or all wickets fallen.
Keepalive Heartbeats: Sends automated :keepalive\n\n pings every 15 seconds to prevent reverse-proxy timeout disconnects.

3. Double-Entry Settlement Ledger (`@cricket-platform/commercial`)

All monetary calculations are performed in integer minor units (e.g. ₹3,500.00 = 350000) to eliminate floating-point rounding errors.

Chart of Accounts:
- ESCROW_HOLD: Funds held in trust upon customer checkout payment.
- PROVIDER_PAYABLE: Net earnings payable to grounds, umpires, and scorers.
- PLATFORM_FEE_INCOME: CricOS platform service revenue.
- TAX_GST_PAYABLE: GST collected on platform fees.
- REFUND_CLEARING: Transit account for cancellations and dispute refunds.
Zero-Sum Balance Invariant: Enforces $\sum \text{Debits} \equiv \sum \text{Credits}$ for every settlement or refund journal entry.

4. Marketplace Concurrency & GiST Exclusion (`migrations/0002_booking_conflict.sql`)

Prevents double-booking race conditions directly at the PostgreSQL storage engine level:

Uses btree_gist extension with PostgreSQL tsrange types.
Enforces GiST exclusion constraint on (slot_id WITH =, time_range WITH &&) for both confirmed bookings and temporary 15-minute inventory holds.

5. Interactive Operations Dashboard (`apps/api/src/ui/dashboard.ts`)

Accessible at http://localhost:3000/ featuring:

Live Match Center: Live SSE connection badge, current over ball strip ([ • ] [ 1 ] [ 4 ] [ W ] [ 1wd ] [ 6 ]), active batsmen scorecard, bowler spell figures, and interactive delivery buttons.
Marketplace & Booking: Browse certified venues, calculate commercial snapshots, and simulate checkout with webhook processing.
Tournament Fixtures: Generate round-robin or knockout schedules.
Incident & Reputation Management: Emergency replacement provider matching and provider reliability scores.
Live API Explorer: Execute live queries directly against all 26 Fastify routes.

🗄 Reconciled Database Migrations

All schema changes are versioned as strict, sequential migrations under migrations/:

Migration	Description
`0001_core.sql`	Baseline schema: users, teams, events, listings, service slots, orders, order items, bookings, and payments.
`0002_booking_conflict.sql`	GiST temporal exclusion constraints preventing overlapping bookings and inventory holds.
`0003_seed.sql`	Pilot seed records.
`0004_indexes_identity.sql`	Performance indexes for identity lookup and team memberships.
`0005_indexes_transactional.sql`	Outbox event queue and transactional indexes.
`0006_indexes_marketplace.sql`	Marketplace category, pricing model, and slot availability indexes.
`0007_indexes_checkout.sql`	Order items and payment intent lookup indexes.
`0008_settlement.sql`	Financial settlement ledger entries table.
`0009_trust_disputes.sql`	Dispute management, provider trust states, and payouts.
`0010_scoring_ratings.sql`	Score events idempotency and ratings with validation bounds.
`0011_tournaments.sql`	Tournaments and tournament fixture schedules.
`0012_fixture_templates.sql`	Reusable fixture templates.
`0013_operations.sql`	Operations dashboard, reschedule tracking, and notification events.
`0014_provider_intelligence.sql`	Provider rating, reliability scores, and replacement proposals.
`0015_incidents_reputation.sql`	Service incidents lifecycle and event-sourced reputation event stream.

🚀 Getting Started

Prerequisites

Node.js: v22.0.0 or v24.0.0+ (ESM native)
pnpm: v9.15.0+
PostgreSQL: v15+ (optional for live DB; offline in-memory fallback enabled by default)

Installation & Build

# Clone the repository
git clone https://github.com/manvenpratap/CricOS.git
cd CricOS

# Install dependencies across all workspace packages
pnpm install

# Build all packages with strict TypeScript
pnpm -r build

# Verify zero TypeScript type errors
pnpm -r typecheck

Running Tests

Execute the full 52-test automated regression suite:

# Token-efficient summary (Minimal Tokens Protocol)
./pipeline.sh test --summary

# Full multi-package test runner
pnpm test

Running the API Server

# Start the API server on port 3000
pnpm start

# Or in development mode with experimental strip-types
pnpm dev

Open http://localhost:3000/ in your browser to launch the Interactive Operations & Testing Console.

📡 API Modules Reference

All API routes are served under the /api/v1 namespace:

Module	Route Prefix	Key Endpoints	Description
Identity	`/api/v1/auth`	`POST /otp/request`, `POST /otp/verify`, `GET /me`	OTP auth, cryptographic JWT issuance, and user profile.
Teams	`/api/v1/teams`	`POST /`, `GET /:id`, `POST /:id/members`	Team squads, captain roles, and player roster management.
Events	`/api/v1/events`	`POST /`, `GET /:id`, `POST /:id/requirements`	Event creation, requirements specification, and lifecycle.
Marketplace	`/api/v1/marketplace`	`GET /listings`, `GET /listings/:id`	Certified grounds, umpires, and scorers catalog.
Availability	`/api/v1/availability`	`GET /slots`, `POST /holds`	Slot discovery and 15-minute authoritative inventory holds.
Basket	`/api/v1/basket`	`GET /`, `POST /items`, `DELETE /items/:id`	Pre-checkout item staging and hold validation.
Checkout	`/api/v1/checkout`	`POST /`, `GET /orders/:id`	Phase 1D order generation and fee/tax calculation.
Payments	`/api/v1/payments`	`POST /intent`, `POST /webhook`	Payment intents and HMAC-SHA256 webhook signature validation.
Scoring	`/api/v1/scoring`	`POST /matches/:id/events`, `GET /matches/:id/live`	Ball delivery scoring and Server-Sent Events live stream.
Settlement	`/api/v1/settlements`	`GET /`, `POST /process`	Double-entry financial settlement journal entries.
Tournaments	`/api/v1/tournaments`	`POST /`, `POST /:id/fixtures/generate`	Tournament brackets, fixtures, and standings tables.
Incidents	`/api/v1/incidents`	`POST /`, `GET /:id`	Operational incident tracking (no-shows, ground unplayable).
Replacements	`/api/v1/replacements`	`POST /propose`, `POST /:id/accept`	Automated emergency certified provider replacement.
Reputation	`/api/v1/reputation`	`GET /providers/:id`, `POST /events`	Event-sourced reliability score updates.
Operations	`/api/v1/operations`	`GET /dashboard`, `GET /metrics`	Platform-wide operational health and SLA metrics.

📱 Native Android Mobile App & APK Generation

CricOS includes a standalone, production-ready native Android project located at apps/mobile/android/, packaging the complete consumer and match official mobile experience into an edge-to-edge hardware-accelerated Android APK (2.9 MB).

Architecture Highlights

Edge-to-Edge True Native Presentation: Eliminates desktop browser mockup shells, simulated notches, and fake status bars. Uses dynamic 100vw × 100dvh viewport scaling with native dark system bars (#04070D) matching the stadium glassmorphic UI.
Hardware-Accelerated WebView: Single-activity (MainActivity.java) with WebSettings.LOAD_DEFAULT, DOM storage, hardware canvas acceleration, and native back navigation.
Embedded Web Audio Synthesizer: CricOSAudioEngine generating real-time acoustic cricket sound effects (willow bat cracks, boundary cheers, wicket oscillations, tactile clicks) with topbar toggle (#btnMobileSoundToggle).
Multi-Persona Bottom Sheet Switcher: Rapid role switching covering all 8 personas (CAPTAIN, PLAYER, SCORER, FAN, UMPIRE, ORGANISER, TURF_PROVIDER, ADMIN) with Escape key and backdrop dismissals.
21st.dev Athletic KPI Cards: Inline career stats, Olympic laurel wreath badges, and 20-match momentum form sparklines embedded in Profile and Squad screens.

Prerequisites

Ensure your local development environment has the following tools installed and configured:

Java Development Kit (JDK 17):

# Verify Java 17 installation
java -version
# Expected: openjdk version "17.0.x"
export JAVA_HOME="/Library/Java/JavaVirtualMachines/temurin-17.jdk/Contents/Home"

Android SDK & Platform Tools:

# Android SDK API Level 33 (Tiramisu) and Build Tools 33.0.2
export ANDROID_HOME="$HOME/Library/Android/sdk"
export PATH="$ANDROID_HOME/platform-tools:$ANDROID_HOME/cmdline-tools/latest/bin:$PATH"

Node.js & pnpm:

node -v  # v22.0.0+ or v24.0.0+
pnpm -v  # v9.15.0+

One-Command APK Generation

To compile the latest distribution bundle, synchronize assets, and assemble the debug APK:

# Via pnpm script (from repository root)
pnpm run build:android

# Or directly via the build script
bash apps/mobile/android/build-apk.sh

What the build script executes automatically:

Compiles TypeScript & Packages Distribution: Runs package-distribution.mjs to generate verified distribution bundles (dist/mobile.html, dist/index.html, dist/openapi.json) with cryptographic SHA-256 hashes.
Synchronizes Android Assets: Injects .is-native-app viewport scaling classes and copies dist/mobile.html into apps/mobile/android/app/src/main/assets/index.html.
Compiles Native APK with Gradle: Invokes Gradle assembleDebug targeting Android SDK 33 using AGP 8.1.4 and Java 17.
Deploys Distribution Artifact: Copies the compiled binary to dist/cricos-debug.apk.

Primary Build Artifacts:

Root Release Artifact: dist/cricos-debug.apk (2.9 MB)
Gradle Build Output: apps/mobile/android/app/build/outputs/apk/debug/app-debug.apk

Manual Clean Build (Gradle CLI)

If you prefer building directly with Gradle:

# 1. Compile API and distribution assets
node scripts/sync-dashboard.mjs
./node_modules/.bin/tsc -p apps/api/tsconfig.json
node scripts/package-distribution.mjs

# 2. Sync to Android assets
mkdir -p apps/mobile/android/app/src/main/assets
sed -e 's/<html lang="en">/<html lang="en" class="is-native-app">/' \
    -e 's/<body>/<body class="is-native-app">/' \
    -e 's/<script type="module">/<script>/' \
    dist/mobile.html > apps/mobile/android/app/src/main/assets/index.html

# 3. Clean and assemble with Gradle
cd apps/mobile/android
./gradlew clean assembleDebug --no-daemon --console=plain

# 4. Copy to distribution folder
cp app/build/outputs/apk/debug/app-debug.apk ../../../dist/cricos-debug.apk

Installation & Device Usage via ADB

1. Install onto a Connected Android Device or Emulator

Connect your Android phone via USB with USB Debugging enabled, or start an Android Virtual Device (AVD):

# Verify connected devices
adb devices

# Install APK (or re-install replacing existing version)
adb install -r dist/cricos-debug.apk

2. Launch the Application

# Start the CricOS main activity
adb shell am start -S -n com.cricos.app.debug/com.cricos.app.MainActivity

3. Force-Stop the Application

adb shell am force-stop com.cricos.app.debug

4. Live Inspection & Remote Chrome DevTools

Because WebView.setWebContentsDebuggingEnabled(true) is activated in MainActivity.java:

Connect device and open CricOS.
In Google Chrome on your computer, navigate to: chrome://inspect/#devices.
Locate CricOS under remote targets and click inspect for live DOM debugging, console logging, network tracking, and storage inspection.

5. Real-Time Logcat Filtering

Filter application and WebView logs in your terminal:

adb logcat -s CricOSWebView:* Chromium:*

6. Capturing On-Device Screenshots

adb shell screencap -p /sdcard/cricos_screen.png
adb pull /sdcard/cricos_screen.png ./tests/screenshots/

Automated Emulator Launch Script

For rapid local testing on an Android Virtual Device, run the bundled automation script:

bash apps/mobile/android/run-emulator.sh

This script:

Detects whether an emulator is running; if not, launches the Medium_Phone_API_36 AVD.
Polls adb shell getprop sys.boot_completed until the Android OS completes boot.
Automatically installs dist/cricos-debug.apk.
Starts com.cricos.app.MainActivity.
Captures an on-screen verification screenshot and pulls it to the local workspace.

In-App QR Code & Browser Download

When running the CricOS Desktop Operations Console (index.html or http://localhost:3000/):

Click the 📱 Mobile App launcher button in the top navigation bar (#btnMobileQuickLauncher).
An interactive modal displays a scannable SVG QR code pointing to the fullscreen mobile view (/mobile).
Includes a direct 🤖 APK (3.0MB) button linking directly to dist/cricos-debug.apk.

🛡 Pipeline & Self-Healing Workflow

CricOS embeds an autonomous self-healing and release pipeline via ./pipeline.sh:

# 1. Deep Invariant Audit (Stack, distribution, tooltips, git hygiene, docs)
./pipeline.sh doctor

# 2. Autonomous Self-Healing (Remediates discrepancies and generates missing assets)
./pipeline.sh heal

# 3. Minimal Tokens Test Verification
./pipeline.sh test --summary

# 4. Guarded Shipping Gate (Runs tests, builds, updates living docs, commits, and pushes)
./pipeline.sh ship "feat(scope): your descriptive conventional commit message"

📄 License

This project is licensed under the MIT License.

Name		Name	Last commit message	Last commit date
.agents/skills		.agents/skills
.codex		.codex
.github		.github
.impeccable		.impeccable
apps		apps
dist		dist
docs		docs
infra/k8s		infra/k8s
migrations		migrations
packages		packages
scripts		scripts
stitch_application_screen_architecture		stitch_application_screen_architecture
tests		tests
wiki		wiki
.dockerignore		.dockerignore
.env.example		.env.example
.env.production.example		.env.production.example
.env.staging.example		.env.staging.example
.gitignore		.gitignore
AGENTS.md		AGENTS.md
DESIGN.md		DESIGN.md
Dockerfile.api		Dockerfile.api
Dockerfile.worker		Dockerfile.worker
PRODUCT.md		PRODUCT.md
PROJECT_CONTEXT.md		PROJECT_CONTEXT.md
README.md		README.md
STITCH_APPLICATION_SCREEN_ARCHITECTURE.md		STITCH_APPLICATION_SCREEN_ARCHITECTURE.md
STITCH_DESIGN_REQUIREMENTS.md		STITCH_DESIGN_REQUIREMENTS.md
docker-compose.prod.yml		docker-compose.prod.yml
docker-compose.yml		docker-compose.yml
index.html		index.html
mobile.html		mobile.html
package.json		package.json
pipeline.sh		pipeline.sh
pnpm-lock.yaml		pnpm-lock.yaml
pnpm-workspace.yaml		pnpm-workspace.yaml
run_tests.sh		run_tests.sh
skills-lock.json		skills-lock.json
tooltip.css		tooltip.css
tooltip.js		tooltip.js
tsconfig.base.json		tsconfig.base.json

Latest commit

History

Folders and files

Repository files navigation

🏏 CricOS — Unified Cricket Operating System

📚 Official CricOS GitHub Wiki & Documentation Portal

🌟 Overview

🏗 Architecture & Monorepo Structure

Workspace Packages Summary

🧭 Compiled Archify Interactive Diagrams & Architecture Specs

⚙️ Core Subsystems

1. MCC Laws of Cricket Scoring Engine (@cricket-platform/scoring)

2. Real-Time Live Match Broadcast Hub (apps/api)

3. Double-Entry Settlement Ledger (@cricket-platform/commercial)

4. Marketplace Concurrency & GiST Exclusion (migrations/0002_booking_conflict.sql)

5. Interactive Operations Dashboard (apps/api/src/ui/dashboard.ts)

🗄 Reconciled Database Migrations

🚀 Getting Started

Prerequisites

Installation & Build

Running Tests

Running the API Server

📡 API Modules Reference

📱 Native Android Mobile App & APK Generation

Architecture Highlights

Prerequisites

One-Command APK Generation

What the build script executes automatically:

Primary Build Artifacts:

Manual Clean Build (Gradle CLI)

Installation & Device Usage via ADB

1. Install onto a Connected Android Device or Emulator

2. Launch the Application

3. Force-Stop the Application

4. Live Inspection & Remote Chrome DevTools

5. Real-Time Logcat Filtering

6. Capturing On-Device Screenshots

Automated Emulator Launch Script

In-App QR Code & Browser Download

🛡 Pipeline & Self-Healing Workflow

📄 License

About

Topics

Resources

Stars

Watchers

Forks

Releases

Packages

Contributors

Languages

1. MCC Laws of Cricket Scoring Engine (`@cricket-platform/scoring`)

2. Real-Time Live Match Broadcast Hub (`apps/api`)

3. Double-Entry Settlement Ledger (`@cricket-platform/commercial`)

4. Marketplace Concurrency & GiST Exclusion (`migrations/0002_booking_conflict.sql`)

5. Interactive Operations Dashboard (`apps/api/src/ui/dashboard.ts`)