Flag	Description	Default
csv_files	One or more fortress export CSVs. Required unless --live is used.
--contracts	Contracts per ticker. Single number (e.g. --contracts 5) or
--risk	Max loss budget per ticker in dollars.
--fight-otm	FIGHT mode CC OTM%%%% from stressed stock (default: 0.01 = 1%%%%).
--run-label	Custom label for output folder. Routes outputs to runs/{label}/
--dd-level	Max drawdown level for survival curve (default: 40, max: 90).	40
--drawdown-pct	Drawdown %% for stress testing (default: IV-scaled)
--min-income-dte	Minimum DTE for income calls (default: 7)	7
--delta	SC delta cap for income calls (e.g. --delta 0.20).
--sigma	Show CC sigma analysis in dashboard (e.g. --sigma 1.0).
--tickers	Filter to specific tickers (e.g. --tickers TSLA NVDA)
--no-dashboard	Skip HTML dashboard generation
--no-json	Skip JSON results file
--all	When --contracts has per-ticker overrides, include ALL tickers
--landscape	Run landscape correlation analysis per ticker (verifies
--short-term	Short-term income mode: uses all LEAPS chains (not just far),
--live	Live mode: connect to IBKR TWS, fetch chains in real-time,
--host	IBKR TWS host (default: {LIVE_HOST})	LIVE_HOST
--port	IBKR port (default: auto-detect. Tries 4001 Gateway Live,	LIVE_PORT
--client-id	IBKR client ID (default: {LIVE_CLIENT_ID})	LIVE_CLIENT_ID
--parallel	Number of parallel IBKR connections for live mode	4
--income-dte	DTE range for income calls in live mode (default: 5 46).
--leaps-dte	DTE range for LEAPS in live mode (default: 180 9999,
--publish	Publish dashboard to Cloudflare Pages via wrangler.
--notify	Send push notification via ntfy.sh when dashboard is ready.
--telemetry	v20.10: Always on (kept for backward compat).	True
--no-audit	Skip auto-generating audit HTML after scan.	False

runs/fortress/{TICKER}/latest.html runs/fortress/{TICKER}/{TIMESTAMP}.html runs/fortress/{TICKER}/audit_{TIMESTAMP}.html runs/CSVs/{TICKER}_{TIMESTAMP}.csv ← live mode only

--tickers TICKER:BUDGET[:MODE] MODE options: itm → Bucket A only (deep ITM, income-focused) otm → Bucket B only (OTM leverage play) both → Split between A and B (default)

Flag	Description	Default
--tickers	One or more positions. SIZE = 30k/100k/1m (budget) or 20c (contracts).
--csv	Use a saved chain CSV (offline mode, skip IBKR).
--cc-overlay	Scan CC overlay (short-dated calls above safe strike)
--parallel	Parallel workers (live mode only, hard cap {PARALLEL_MAX_WORKERS};	PARALLEL_MAX_WORKERS
--min-dte	Minimum DTE for LEAPS chain discovery (default: {MIN_DTE_DEFAULT})	MIN_DTE_DEFAULT
--max-chains	Number of furthest-out chains to scan (default: {MAX_CHAINS})	MAX_CHAINS
--html	Override HTML output path (default: routed via OutputManager)
--audit	Override audit JSON output path (default: routed via OutputManager)
--host	IBKR host (default: {DEFAULT_HOST})	DEFAULT_HOST
--port	IBKR port (default: 0 = auto-detect	DEFAULT_PORT
--client-id	IBKR client ID (default: {DEFAULT_CLIENT_ID})	DEFAULT_CLIENT_ID
--breakout	Breakout mode: score by weighted P&L across sigma-multiples of the
--breakout-target	Override sigma-scaled scoring with a SINGLE fixed-pct target
--stop-loss-pct	Score by reward / MTM-loss-at-stop instead of reward / structural-ML.
--yolo	YOLO mode: widened OTM ranges (LC 95-300%% of stock, SP 30-130%%) and
--yolo-cap	Override LC max strike multiplier in YOLO mode (default:	YOLO_LC_MAX_STRIKE_PCT_DEFAU
--anchor	Anchor all comparisons to a specific chain. Without LABEL: use
--all	Run NORMAL + BREAKOUT + YOLO in one go and generate a single combined

runs/leaps/{TICKER}/latest.html runs/leaps/{TICKER}/{TIMESTAMP}.html runs/leaps/{TICKER}/audit_{TIMESTAMP}.json

Flag	Description	Default
ticker	Stock ticker symbol (single-ticker mode)
safe_strike	Safe Strike of the fortress (single-ticker mode)
--csv	Path to CSV position file for batch/portfolio scan (requires IBKR)
--from-scan	Path to previously exported scan CSV (no IBKR needed, dashboards only)
--output-dir	Output directory for all files (default: ./outputs)	./outputs
--contracts	Number of contracts (single-ticker mode, default: 10)	10
--max-delta	Maximum delta filter (default: {MAX_DELTA})	MAX_DELTA
--max-dte	Maximum DTE to scan (default: from CSV per-ticker, or {MAX_DTE} in single-ticker mode)
--min-dte	Minimum DTE to scan (default: from CSV per-ticker, or {MIN_DTE} in single-ticker mode)
--host	IBKR TWS host (default: {DEFAULT_HOST})	DEFAULT_HOST
--port	IBKR port (default: auto-detect. Tries 4001, 4002, 7496, 7497)	DEFAULT_PORT
--client-id	IBKR client ID (default: {DEFAULT_CLIENT_ID})	DEFAULT_CLIENT_ID
--drawdown-mode	Enable drawdown mode (tighter DTE preference)
--no-browser	Do not auto-open dashboards in browser
--output	Output HTML filepath (single-ticker mode only)
--parallel	Number of parallel IBKR connections for batch mode (default: 4).	4
--tickers	Filter --csv to only these tickers (e.g. --tickers MSFT NVDA TSLA)
--skip-cc-timing	Skip the automatic cc_timing.py refresh at start of run.

runs/cc_scanner/{TICKER}/latest.html ← per ticker runs/cc_scanner/cc_scan_PORTFOLIO.html ← master view runs/CSVs/cc_scan_data.csv ← reusable scan data

Flag	Description	Default
--host	TWS host (default: {DEFAULT_HOST})	DEFAULT_HOST
--port	TWS port (default: {DEFAULT_PORT})	DEFAULT_PORT
--client-id	Client ID (default: {DEFAULT_CLIENT_ID})	DEFAULT_CLIENT_ID
--max-dte	Max DTE for current positions to scan (default: {MAX_CURRENT_DTE})	MAX_CURRENT_DTE
--sigma-roll	Sigma threshold for ROLL (default: {SIGMA_ROLL})	SIGMA_ROLL
--sigma-threatened	Sigma threshold for THREATENED (default: {SIGMA_THREATENED})	SIGMA_THREATENED
--sigma-watch	Sigma threshold for WATCH (default: {SIGMA_WATCH})	SIGMA_WATCH
--delta-fallback	Delta fallback when IV unavailable (default: {DELTA_FALLBACK})	DELTA_FALLBACK
--max-roll-dte	Max DTE for roll candidates (default: {MAX_ROLL_DTE})	MAX_ROLL_DTE
--target-delta	Target max delta for rolls (default: {TARGET_DELTA})	TARGET_DELTA
--top-n	Top N candidates per position (default: {TOP_N})	TOP_N
--account	IBKR account ID (e.g., U1234567). If omitted, uses default account.
--tickers	Ticker filter with optional contract count and safe strike.
--roll-up	Scan for roll-up candidates (defensive, move strike higher).
--roll-down	Scan SAFE positions (sigma >= sigma_watch, delta <= 0.15)
--force	Force roll analysis for --tickers positions
--show-debits	Show best debit rolls when credits are scarce (cheapest path to safety)
--proactive	Fetch proactive roll candidates for WATCH/THREATENED positions
--min-sigma	Minimum sigma floor for roll-down targets (default: {ROLLDOWN_MIN_SIGMA})	ROLLDOWN_MIN_SIGMA
--json	Export all roll data to JSON at this path (e.g., --json rolls.json).
--html	Write HTML dashboard to this path (e.g., --html rolls.html).
--csv	CSV with safe strikes per ticker (cols: TICKER, SS).
--parallel	Number of parallel IBKR connections for roll analysis	4
--debug	Print detailed chain diagnostics for roll expiration discovery

runs/rolls/{TICKER}/latest.html runs/rolls/PORTFOLIO/latest.html ← full scan

runs/cc_check/PORTFOLIO/latest.html deploy/cc_check/PORTFOLIO.html ← CF staged

Flag	Description	Default
--host	TWS host	DEFAULT_HOST
--port	TWS port (default 7496)	DEFAULT_PORT
--client-id	IBKR clientId	DEFAULT_CLIENT_ID
--account	Single account to scan (default: all managed)
--tickers	Ticker filter. Space-separated or comma-separated
--expiry	Horizon cutoff date. (1) Hedge-put (HP): only show fortresses
--csv	Use active_fortresses.csv as structural authority (ticker →
--cached	Reuse cached scan data (skip IBKR)
--no-rolls	Skip roll-chain fetches (faster)
--get-cc-timing	Run cc_timing.py first to refresh the weekly-gate
--cc-suggest	Append a section at the bottom of the dashboard
--cc-suggest-max-dte	Max DTE for CC suggestions	CC_SUGGEST_MAX_DTE_DEFAULT
--cc-suggest-scope	Which fortresses to include: BOTH (default),	CC_SUGGEST_SCOPE_BOTH
--cc-suggest-max-rows	Optional explicit cap on candidate rows per expiry.
--json	Also write raw JSON to this path
--html	Also write HTML to this explicit path (OutputManager always runs)

runs/rebuild/{TICKER_LIST}/latest.html deploy/rebuild/{TICKER_LIST}.html ← CF staged

Flag	Description	Default
csv_file	Chain data CSV (skips live chain fetch, still reads IBKR portfolio)
--tickers	Ticker symbols. Space-separated or comma-separated
--csv	Path to active_fortresses.csv (ticker → contracts,
--legs	Optional leg detail (e.g. GLD:HP:410:20260630:7.214). Repeatable.
--from-results	Read positions from fortress_results.json
--host	IBKR TWS host (default: 127.0.0.1)	127.0.0.1
--port	IBKR port (default: auto-detect. Tries 4001, 4002, 7496, 7497)	0
--client-id	IBKR API client ID (default: 99).	99
--account	IBKR account ID (e.g. U1234567).
--parallel	Parallel IBKR connections (default: 4)	4
--fight-otm	OTM%% for FIGHT CCs (default: {FIGHT_OTM_DEFAULT} = 1%%)	FIGHT_OTM_DEFAULT
--fight-dte	Target DTE for FIGHT CCs (default: {FIGHT_DTE_DEFAULT})	FIGHT_DTE_DEFAULT
--expiry	HP (hedge put) expiry date. Accepts: 20260630, 30-Jun-2026,
--targets	Income recovery targets as fractions (default: 0.35 0.70)	TARGETS_DEFAULT
--gap-pct	Gap-up scenario for risk calc (default: {GAP_PCT_DEFAULT} = 10%%)	GAP_PCT_DEFAULT
--html	HTML output path (default: fight_TICKER_TIMESTAMP.html)
--no-html	Suppress HTML output entirely
--json	JSON output path
--publish	Stage and deploy HTML to Cloudflare Pages directory
--notify	Push notification via ntfy.sh when done
--force	Show roll decisions for ALL current CCs regardless of sigma
--roi	Override annual ROI on ML for normal income ref
--nd	Original entry ND per share (immutable, from trade creation).

runs/fight/{TICKER}/latest.html runs/fight/{TICKER}/{TIMESTAMP}.html

Flag	Description	Default
tickers	Ticker(s) to analyze (e.g. IREN IWM TSLA)
--all	Analyze all fortress positions in portfolio
--expiry	Filter to positions with HP expiring by this date (YYYY-MM or YYYYMMDD).
--hp-min-dte	Min DTE for HP candidates (default: {HP_MIN_DTE}).	HP_MIN_DTE
--hp-max-dte	Max DTE for HP candidates (default: {HP_MAX_DTE})	HP_MAX_DTE
--gap-mult	Max ratio of new_gap vs current gap (default: 2.0).	2.0
--price-multiplier	Add pick_score ROI component at Nx current stock price.	0
--max-payback	Max payback period in years for repair candidates (default: 1.0).	1.0
--cc-income	Monthly CC income per share override (e.g., 4.00).	0
--maint-roll-dte	DTE threshold for healthy-fortress HP maintenance roll	MAINT_ROLL_DTE
--maint-cost-cap	Max ratio of new HP annual cost vs CC annual income for	MAINT_COST_CAP
--no-maint	Skip the maintenance-roll pass on healthy fortresses.
--account	Limit scan to this account ID. Default scans ALL
--positions	CSV with actual position data (overrides IBKR avg_cost).
--json	Export to JSON file
--html	Export HTML dashboard
--csv	CSV with safe strikes / ND / contracts / leg strikes	DEFAULT
--nd	Net Debit per share override (e.g., 16.0).	0

runs/repair/{TICKER}/latest.html runs/repair/{TICKER}_{TICKER2}/latest.html ← multi-ticker

Flag	Description	Default
ticker	Ticker to analyze (e.g. MARA)
--expiry	Current position expiry to match (YYYYMMDD or 18-sep-2026).
--contracts	Override contract count (e.g. 200 for 200 contracts = 20000 shares)	0
--lc	Select fortress structure by LC strike (e.g. --lc 60).	0
--html	HTML output path (default: repair_<TICKER>_<timestamp>.html)
--audit	Audit log JSON path (default: audit_<TICKER>_<timestamp>.json)
--gap-mult	Max gap multiplier vs current gap (default: {SA_GAP_MULT}x)	SA_GAP_MULT
--margin	Run IBKR whatIf margin checks on top candidates (requires write access)
--min-target-dte	Minimum DTE for target LEAPS expiries (default: 365)	365
--max-target-dte	Maximum DTE for target LEAPS expiries (default: 1100)	1100
--price-multiplier	Add P&L projection at Nx current price (e.g., 10 for 10x).	0
--cc	Add CC income overlay to lens picks (scans DTE 5-50 call chains)
--fight	Add FIGHT income panel: near-ATM short-dated CCs for income
--nd	Override net debit per share (all-in cost basis).	0
--no-roll	Skip roll candidates entirely. Only restructure within current expiry.
--max-candidates	Cap total candidates after merge (default 250000).	250000
--pnl	P&L curve only. Connects to IBKR, reads position,
--pnl-max	Max stock price for P&L curve (default: 5x current price)	0

runs/repair_trades/{TICKER}/latest.html runs/repair_trades/{TICKER}/audit_{TIMESTAMP}.json

Pillar	Weight	Key Metrics
Fundamentals	40%	Revenue growth, margins, FCF, debt
Fortress Fit	30%	IV, liquidity, options chain depth, trend alignment
Valuation	15%	P/E, P/S, EV/EBITDA vs peers
Technicals	15%	Momentum, moving averages, RSI

Flag	Description	Default
tickers	Stock tickers
--horizon	Investment horizon (default: '1-2 years	1-2 years
--output	Output HTML path
--api-key	Anthropic API key (or ANTHROPIC_API_KEY env)
--no-ibkr	Skip IBKR, yfinance IV only
--json	Also dump raw data as JSON alongside HTML

runs/research/{TICKER}/latest.html runs/research/{TICKER1}_{TICKER2}/latest.html ← multi

Flag	Description	Default
tickers	Ticker(s) to include (e.g. IREN IWM TSLA)
--all	Include all fortress positions in portfolio
--expiry	Filter to positions with LEAPS expiring by this date (YYYY-MM or YYYYMMDD)
--account	Account ID(s) to scan. Comma-separated or space-separated.
--positions	CSV with actual position data (overrides IBKR avg_cost).
--html	Output HTML file path
--json	Export to JSON file

runs/fortress/PORTFOLIO/latest.html runs/fortress/PORTFOLIO/{TIMESTAMP}.html

Flag	Description	Default
tickers	One or more ticker symbols
--host	TWS host	DEFAULT_HOST
--port	TWS port	DEFAULT_PORT
--client-id	Client ID	DEFAULT_CLIENT_ID
--output	Custom output CSV path
--width	Strikes per chain, 0=ALL (default: {STRIKE_WIDTH})	STRIKE_WIDTH
--short-term	Short-term mode: LEAPS 180-450d (default: 180+)	False
--leaps-dte	Override LEAPS DTE range (e.g. --leaps-dte 180 365)
--hedge-dte	Override hedge DTE range (default: {HEDGE_DTE_MIN} {HEDGE_DTE_MAX})
--income-dte	Override income DTE range (default: {INCOME_DTE_MIN} {INCOME_DTE_MAX})
--parallel	Number of parallel IBKR connections (default: 1). Each worker	4

runs/CSVs/{TICKER}_{TIMESTAMP}.csv Columns: ticker, type (LEAPS/HEDGE/INCOME), strike, expiry, bid, ask, iv, delta, gamma, theta, vega, volume, open_interest

Flag	Description	Default
--tickers	Space-separated ticker symbols
--scan	Discovery mode: screen SPX, QQQ, IWM constituents	False
--top	Top N stocks per index in discovery mode (default: 10)	10
--expiry	Target expiration (YYYYMMDD). Auto-selects nearest monthly 20-45 DTE if omitted
--capital	Total portfolio capital for position sizing
--collateral-pct	Collateral %% per put (100=fully collateralized, default: 100)	100
--port	TWS port (default: 0 = auto-detect TWS/Gateway)	DEFAULT_PORT
--no-ibkr	Use yfinance instead of IBKR for options data	False
--min-oi	Minimum open interest filter (default: 100)	100
--max-spread-pct	Maximum bid-ask spread as %% of bid (default: 15.0)	15.0
--output	Output directory for HTML report	str(Path.home(
--rescan	Force fresh discovery scan, ignore cache	False

deploy/gs_putseller/{TICKER1}_{TICKER2}.html (also staged to deploy/ for CF Pages)