Calculation Changelog

FIXEvery API endpoint now returns structured JSON on error, never HTML 500

• Income Planner (and any other endpoint) previously showed a bare "Worker responded 500" when Polygon rate-limited. Root cause: the central dispatcher's catch block returned only {error: msg}, so the front-end had nothing useful to display.
• Central dispatcher (worker/src/index.js lines 18-55) now classifies exceptions (polygon_rate_limit, polygon_upstream, worker_timeout, kv_binding, internal_error) and returns {error, message, hint, endpoint, asOf} so the UI can show an actionable message.
• Income Planner front-end (js/income-planner.js) now reads the response body even on non-2xx and surfaces the message and hint fields — no more generic "Worker responded 500."

FEATPreflight Gate 16 — live endpoint health check

• New preflight gate pings 10 critical /api/ endpoints against the deployed Worker and fails the deploy if any returns HTML 500 or a malformed body. Runs on every deploy-all.ps1 post-deploy step. Skippable via PREFLIGHT_SKIP_LIVE=1 for fast local iteration.
• Covers: quote, iv-rank, expected-move, skew, term-structure, gex, opportunities, plan/income (POST), ta/context, csp/leaderboard.

FEATAnswer-first blocks + AEO answer tables on all 7 top calculators/dashboards

• Covered-call & CSP calculators: added a metric / formula / limitation table above the calculator UI so every displayed number has an explicit formula and disclosed limitation (e.g., "midpoint may not be executable at fill").
• Wheel tracker, Black-Scholes, opportunities, screener, watchlist: added 40-80 word answer-first blocks below the H1.

FIXCSP worked-example equation dimensional consistency

• Old text: (3.40 / 75,000) × (365 / 21) = 7.9% — mixed per-share premium with per-contract collateral (dimensionally wrong; the correct answer was reached by coincidence via the 100-share multiplier canceling).
• New text explicitly shows both per-share (3.40/750 × 365/21) and per-contract (340/75000 × 365/21) forms with the same 7.9% result and calls out why they're equivalent.
• Affected files: learn/cash-secured-puts/index.html, user-manual.html.

IMPROVECovered-call yield denominator disambiguation

• Renamed the strike-denominator form to "screen yield" in the worked examples and separated it from yield-on-current-price and yield-on-cost-basis with explicit formula lines.
• Affected file: covered-call.html.

IMPROVERemoved unsupported superlatives from educational content

• 7 categorical claims ("most consistent income strategy," "highest-Sharpe," "safest income vehicle," "most reliable IV pattern") replaced with bounded, sourceable language.
• Affected files: 7 files under learn/, best/, and ai/.

FEATLEAPS Opportunity Finder module

• Full 8-phase build: 4-part composite scoring (technical / contract quality / fundamentals / risk), regime layer, 9×5 BSM scenario grid, paper trader with score-decile validation, watchlist + alerts, methodology page.
• Scoring version tag: leaps-scoring-v1.0.0. Every paper trade records this tag so future re-weightings can be walked forward honestly.

FEATPolygon rate-limit retry + concurrency cap

• Added pgWithRetry around every Polygon call: 3 attempts, exponential backoff (400ms → 1.2s → 3.6s + 25% jitter), module-level semaphore caps at 2 in-flight requests. Fixes Income Planner 502s and scanner rate-limit failures across all multi-ticker endpoints.

FIXKill "strike = spot" nuclear-fail fallback in handleQuote

• Under empty-response conditions, handleQuote was falling back to spot = strike, which silently corrupted every downstream yield calculation. Replaced with a 3-tier fallback (stocks-snapshot → options-underlying → prev-day aggs) and now throws if all three fail.

FIXCC calculator static-yield inflation bug

• Static yield formula was including pre-existing unrealized capital gains, inflating from realistic ~5% to ~48% on some inputs. Fixed inline copies of the formula on all HTML calculator pages, then added a math-parity hash-check (Preflight Gate 11) to prevent future drift between the shared engine and inlined copies.

FEATCSP Optimizer Phases 1-4

• Phase 1 analytics: Yang-Zhang RV + VRP, IV rank/percentile, extended Monte Carlo (EV, win rate, CVaR₉₅, EV/CVaR), assignment-probability upgrades, skew-aware strike selection, term-structure DTE badge, event awareness, executable ROC + liquidity gates, underlying quality gate, management analytics.
• Phase 2: correlation-aware selection, portfolio Greeks/exposures, stress tests + assignment cascade, constrained EV optimizer with fractional Kelly, expiration laddering, T-bill collateral yield comparison.
• Phase 3: universe list + nightly cron, opportunity-score composite at reference trade, personalized suggestion buckets, standalone /leaderboard/csp/.
• Phase 4: 3-year walk-forward decile backtest, 6-month rolling Spearman IC dashboard, calibration reliability diagram at /csp/validation/.

FEATTA Enhancement (E1-E12)

• Cross-sectional standardization, Markov 2.0 regime layer with stride sampling + FILTER mode, regime-conditional Edge weights, Hurst + OU statistical routing, volatility structure family, enriched flow (GEX/skew/IVR/term-structure/DIX), options-aware S/R + Anchored VWAP, event awareness, watchlist discipline, decile-backtest IC dashboard, R-multiple trade framing, income cross-link (Confluence Setups).

FEATCore calculators & screeners established

• Covered call, cash-secured put, wheel tracker, Black-Scholes calculator, strike screener, live opportunities, per-ticker dashboards, watchlist.

FEATCloudflare Worker architecture

• Polygon proxy + server-side screener + KV cache. Every Polygon call goes through the Worker for rate-limit protection, response normalization, and edge-cached delivery.

FEATProgrammatic ticker pages + supporting articles

• 70 ticker hubs × 3 strategy children + 30 supporting articles + 15 comparison / best-of pages. All indexed via sitemap; strategy children now noindexed pending quality-gate work.