MillionaireSensei is a fully-automated options trading system combining TradingView technical signals, a Google Apps Script processing brain, Firebase for state management, Alpaca for trade execution, and a custom Cloud Run brain-bridge service.

Architecture

Key URLs and IDs

The Google Apps Script brain is the central processing unit. It receives TradingView webhooks, scores signals, manages the signal queue, places Alpaca orders, and writes all trade lifecycle events to Firestore via the brain-bridge.

Signal Flow

1. TradingView fires alert → webhook to GAS doPost()
2. GAS enqueues signal → processSignalQueue() picks up within 1 minute
3. GAS scores signal (confluence + backtest memory + HMM regime overlay)
4. If score passes gate: select option contract via Alpaca options chain
5. Place order on Alpaca paper account
6. Push trade_open event to brain-bridge → written to Firestore
7. Dashboard Engine Room shows live position with trailing stop active
8. Trailing stop trigger fires every minute → closes position if triggered
9. trade_close pushed to brain-bridge → Ledger updated, P&L recorded

Key Script Properties

GAS Deploys (Code.js changes)

Always use REDEPLOY_GAS_AND_INSTALL.bat — never CLASP_PUSH.bat alone.

CLASP_PUSH only updates the source files. The live /exec endpoint is pinned to a versioned deployment ID. It keeps serving old code until clasp deploy runs.

The bat runs all 4 required steps: (1) clasp push, (2) clasp deploy -i DEPLOY_ID, (3) install_ts_trigger, (4) purge_old_versions.

index.html Changes

Before every index.html deploy, run the duplicate-const grep:

grep -n "^  const [A-Z_]" firebase/public/index.html | awk -F: '{print $2}' | sort | uniq -d

Any output = duplicate const declarations = parse-time SyntaxError = login spinner freezes with no visible error.

Post-Deploy Verification

After every deploy, run the ms-system-test skill. Quick verify for GAS: call get_option_prices — valid JSON with a prices key = live. Raw string "ok" = stale deployment, run the bat again.

Market Hours Gate (v4.4 — Build @261+)

Off-hours signals ARE logged to the Radar panel. Telegram notification IS sent. Alpaca order execution IS suppressed. Response does NOT indicate a hard block. The old blocked: true behavior was removed in v4.4.

Cloud Run service relaying between GAS and Firestore. Current good revision: 00025-tud (verified 2026-05-26). Bad revision: 00015-mn2 — never route traffic back.

Cloud Run service (hmm-oracle-v3) running GaussianHMM on SPY daily data. Non-blocking advisory overlay — modifies risk sizing, does NOT gate trades.

Cloud Scheduler job: hmm-daily-regime-sync — fires 1:15 PM PT (4:15 PM ET) weekdays.
Force a run: Cloud Console → Cloud Scheduler → hmm-daily-regime-sync → Force Run.

OCC Option Symbol Format

Ticker + YYMMDD + C/P + 8-digit strike (strike × 1000, zero-padded).
Example: SPY260620C00500000 = SPY CALL, Jun 20 2026, strike $500.00

Screener — MS_Screener_V8.1 (Active)

40-ticker scanner — 40 request.security() calls, at the Pine Script limit. Each ticker is evaluated for CALL/PUT confluence using the same 12-strategy logic as the execution chart.

40-Ticker Watchlist (Build @271): AAPL, ADBE, AFRM, AMD, AMZN, APP, ARM, AVGO, COIN, CRM, CRWD, DKNG, GOOGL, GS, IWM, JPM, LLY, META, MRVL, MSFT, MU, NFLX, NVDA, ORCL, PANW, PLTR, PYPL, QQQ, ROKU, SHOP, SMCI, SMH, SNOW, SOFI, SPCX, SPY, TSLA, UBER, V, XYZ

VIX Architecture (V8.1+)

MS_Screener_V8.1 removed VIX from request.security() to free the 40th slot for SPCX. VIX is now sourced independently by GAS:

getGasVix_()
  1. Yahoo Finance %5EVIX — ~15-second refresh (primary)
  2. FRED VIXCLS — official EOD (fallback)
  CacheService: 60-second cache under key 'GAS_VIX_LIVE_'

MS_Execution_V8.1 retains its own CBOE:VIX call (separate 40-call budget; only 3 calls used on single-symbol chart — fine).

Screener V8.2 (Built, Not Yet Deployed)

MS_Screener_V8.2.pine — 70-ticker v6 dynamic loop using Pine Script v6 array iteration. Reserved for future activation when the 40-ticker limit becomes a constraint.

Execution Chart — MS_Execution_V8.1

Pine Script v6 indicator detecting 12 named strategy types on the live single-symbol chart.

Autonomous AI trading agent powered by claude-sonnet-4-6. Shadows Johnpaul's strategy using paper trades on Alpaca.

Go-Live Criteria (ALL must pass)

Required Fixes Before Live Money

The 7 Rules You Cannot Break

Emergency Procedures