{
  "version": "1.0",
  "strategy": "vwap_pull_in",
  "title": "VWAP Pull-In Actionable Gate",
  "generated": "2026-06-09",
  "status": "working_framework_pending_forward_validation",
  "one_sentence_thesis": "Plain VWAP Pull-In is only for calm, controlled tape. Hot tape is either Pull-In -> Trend with confirmation, or no trade.",
  "core_decision": "Do I have a calm VWAP pull-in, or am I chasing hot tape?",

  "_meta": {
    "purpose": "Simplified, live-use decision spec distilled from the VWAP Pull-In research pages. Pre-trade gate + classification + sizing + post-entry management + reason codes.",
    "honesty_note": "The DIRECTION is data-proven (calm tape wins, hot tape loses; post-entry fade vs expansion separates outcomes). The exact numeric cut-points are WORKING RULES derived from group averages and have not been validated as per-trade separators. Forward-test before locking. Do not invent precision the sample does not support.",
    "winner_sample_is_tiny": "The whole edge rests on 15 pull-in->trend trades (6 mechanically classifiable). Treat every number as a hypothesis to forward-test, not a locked edge (CMT Ch.35/38 data-mining caution).",
    "source_pages": [
      "VWAP_PULL_IN_QUALITY_GATE.html",
      "VWAP_PULL_IN_QUALITY_GATE_CHEATSHEET.html",
      "MGP_BLOCK_VWAP_PULL_IN_QUALITY_GATE.html",
      "VWAP_PULL_IN_SPLIT_DIAGNOSTIC.md",
      "CANONICAL_STRATEGY_PERFORMANCE_REPORT.html",
      "PULL_IN_TO_TREND_MECHANISM_AUDIT.html",
      "PI_TREND_ROTATION_WINNERS_REVIEW.html",
      "VWAP_PULL_IN_CLASSIFIER_REFINEMENT_PLAN.html"
    ],
    "deeper_research": "Z:/trading/dev/vwap-band-entry-surface (Liberator full-window backfill, n=320) corroborates the post-entry-behavior layer."
  },

  "evidence": {
    "data_basis": "main.trade_context on trsports_tradingjournal_dev, canonical_strategy_slug-resolved trades through 2026-06-03 (n=310 classified / ~323 total).",
    "plain_pull_in": { "n": 127, "net_pnl": -364.47, "avg": -2.87, "median": -2.25, "win_rate": 0.354, "worst": -216.15, "best": 150.76, "tier": "proven" },
    "pull_in_to_trend": { "n": 15, "net_pnl": 367.67, "avg": 24.51, "median": 12.25, "win_rate": 0.933, "worst": -11.76, "best": 136.29, "tier": "proven_but_n_tiny" },
    "family_vwap_pullback_continuation": { "n": 142, "net_pnl": 3.20, "note": "Essentially flat. The +$368 winner bucket and -$364 leak bucket nearly cancel. The management/selection decision is the entire edge." },
    "rvol_gap_split": {
      "tier": "proven_as_group_means_thresholds_are_working_rules",
      "plain_losers": { "n": 80, "rvol": 4.01, "gap_pct": 2.11, "atr_from_prior": 0.37 },
      "plain_winners": { "n": 45, "rvol": 1.38, "gap_pct": 0.35, "atr_from_prior": 0.08 },
      "pi_trend_winners": { "n": 14, "rvol": 1.14, "gap_pct": -0.88, "atr_from_prior": -0.38 }
    },
    "damage_symbols": {
      "tier": "IBIT_robust_others_small_sample",
      "IBIT": { "n": 10, "net_pnl": -185.51, "win_rate": 0.30, "note": "51% of total plain-PI loss. Robust." },
      "AMD": { "n": 3, "net_pnl": -69.65, "win_rate": 0.0, "note": "small sample" },
      "ETHU": { "n": 3, "net_pnl": -69.35, "win_rate": 0.0, "note": "small sample, levered crypto proxy" },
      "RGTI": { "n": 2, "net_pnl": -35.68, "note": "small sample" },
      "CVX_watch": { "n": 5, "net_pnl": -44.63, "win_rate": 0.20, "note": "Not on the original blacklist but worse sample than AMD/ETHU - add to watch." },
      "positive_counterexamples": { "MSFT": "+$133.54 / n=4 / 100%", "TSLA": "+$43.39 / n=6 / 66.7%", "GOOGL": "+$32.67 / n=5 / 60%" }
    },
    "time_of_day": {
      "tier": "proven_concentration",
      "window_09_10_ET": { "plain_pi_trades": 91, "of_total": 127, "net_pnl": -401, "win_rate": 0.30 },
      "hour_09": { "n": 62, "net_pnl": -209.92, "win_rate": 0.371 },
      "hour_10": { "n": 29, "net_pnl": -191.22, "win_rate": 0.241 },
      "pi_trend_09_10": { "n": 11, "net_pnl": 253, "win_rate": 1.0, "caveat": "Driven mostly by pre-kti-window trades whose mechanism cannot be verified; do not over-trust." }
    },
    "macro_filters_not_per_trade": {
      "tier": "proven_caveat",
      "note": "MTF and MA-stack separate the two SLUGS but do NOT separate winners from losers within plain PI (losers MTF grand 21.74 vs winners 14.64). Use MTF/MA as macro regime context only - NOT as the go/no-go discriminator."
    },
    "not_overtrading": { "tier": "proven", "note": "All 127 plain PI are 1-per-symbol-per-day. The leak is tape/symbol selection across many days, not stacking entries." },
    "mechanism_reality_of_pi_to_trend": {
      "tier": "proven_mixed_bucket_n_tiny",
      "classifiable": 6,
      "true_conversion": { "n": 1, "pnl": 12.45, "ref": "JOBY 5/28" },
      "rotation_scalp": { "n": 3, "pnl": 96.34, "share_of_classifiable_pnl": 0.755, "ref": "DAL 5/26, 5/27, 5/28" },
      "wrong_side_escape": { "n": 2, "pnl": 12.95 },
      "trend_continuation_entry": { "n": 3, "pnl": 10.69, "ref": "LUNR (only loser -11.76), BB, INTC" },
      "no_bar_unreviewable": { "n": 6, "pnl": 235.24, "share_of_bucket_pnl": 0.64, "ref": "incl AAOI +$136" },
      "conclusion": "'Pull-In -> Trend' is OUTCOME-based, not mechanism-confirmed. The name overstates trend conversion ~5x. Do NOT hold a plain pull-in like a trend trade just because it might earn the label."
    },
    "post_entry_state_winrate": {
      "tier": "proven_directional_corroborated_by_liberator_backfill_n320",
      "early_expansion": { "win_rate": 0.71, "avg_pnl": 485 },
      "fade": { "win_rate": 0.26, "avg_pnl": -700 },
      "follow_through_gt_plus1sd": { "win_rate": 0.79 },
      "follow_through_lt_minus1sd": { "win_rate": 0.19 },
      "plain_pi_fading_at_3min": { "win_rate": 0.07 },
      "band_location_mid_1p5_to_2sd": { "avg_pnl": 351 },
      "band_location_extreme_gt_2sd": { "avg_pnl": -207, "note": "exhaustion / chase" },
      "band_location_deep_lt_minus2sd": { "avg_pnl": 168, "win_rate": 0.85, "note": "backside reversion - different setup" }
    }
  },

  "gates": {
    "_note": "Thresholds are WORKING RULES from group means. RVOL is the primary pre-trade filter but is NULL on many historical rows - if RVOL is unavailable, fall back to gap% + visual tape read. The PROVEN edge lives in post-entry behavior; the gate only filters which trades you let in.",
    "green": {
      "label": "Normal VWAP Pull-In allowed",
      "color": "#34d399",
      "conditions_all_required": {
        "rvol": { "min": 1.0, "max": 1.5 },
        "gap_pct_abs": { "max": 0.5 },
        "vwap_band": "controlled rotation around VWAP, not extended",
        "emotional_extension": false,
        "mtf_context": "supportive (context only, not a discriminator)"
      },
      "action": "take_normal_planned_size",
      "default_classification": "plain_vwap_pull_in",
      "management_default": "manage as rotation/scalp unless first 5-15 min confirms expansion",
      "evidence_tier": "working_rule_from_group_means"
    },
    "yellow": {
      "label": "Reduced size / confirmation required",
      "color": "#fbbf24",
      "conditions_any": {
        "rvol": { "min": 1.5, "max": 2.5 },
        "gap_pct_abs": { "min": 0.5, "max": 1.5 }
      },
      "additional": "clean structure AND you can articulate the trend-conversion thesis OUT LOUD before entry",
      "action": "half_size_or_confirmation_only",
      "rule": "Only trade if VWAP slope, higher lows, and band expansion support it. If you cannot say the thesis out loud, pass.",
      "evidence_tier": "working_rule_from_group_means"
    },
    "red": {
      "label": "Pass or reclassify - NOT a plain Pull-In",
      "color": "#ef4444",
      "conditions_any": {
        "rvol": { "min": 2.5 },
        "gap_pct_abs": { "min": 1.5 },
        "first_hour_hot_tape": "entry before 10:00 ET in hot tape",
        "price_extended": "far from VWAP / beyond +2 SD with no setup support",
        "damage_symbol": ["IBIT", "AMD", "ETHU", "RGTI", "CVX"],
        "repeated_damage_history": true
      },
      "action": "do_not_take_as_plain_pull_in",
      "rule": "Reclassify (Pull-In -> Trend with confirmation / Chase-Extended / Range Break / Backside) or pass. This is where the leak lives.",
      "first_hour_override": "In 09:00-10:00 ET, demand RVOL < 2 AND gap < 1% or pass.",
      "damage_symbol_note": "IBIT (n=10) robust; AMD/ETHU/RGTI/CVX small-sample - treat as 'require stricter bar (RVOL<1.5, gap<0.5%)' rather than permanent blacklist. MSFT/TSLA/GOOGL were net positive - it is the levered/hyped names, not all names.",
      "evidence_tier": "working_rule_IBIT_proven_others_small"
    }
  },

  "classifications": {
    "plain_vwap_pull_in": {
      "when": "calm tape, controlled pullback into VWAP, GREEN gate",
      "assume": "scalp / rotation target - do NOT assume trend",
      "target": "opposite band / +2 SD",
      "stop": "VWAP / lower band / reaction point",
      "reason_code": "CALM_PULLIN"
    },
    "pull_in_to_trend": {
      "when": "starts as a pull-in in calm tape, EARNS trend-hold only if confirmed after entry",
      "confirmation_required": [
        "higher highs / higher lows",
        "VWAP slope rising in trade direction",
        "band width expanding (often doubling in first 5 min)",
        "price accepting above +2 SD / key band",
        "first 5-10 min behavior confirms expansion (and it persists to 10-15 min)"
      ],
      "caveat": "OUTCOME-based label, not mechanism-confirmed. Only ~1 in 6 classifiable cases was a true conversion; most were rotation scalps. Confirm with behavior, do not assume.",
      "reason_code": "PI_TO_TREND_CONFIRMED"
    },
    "chase_extended": {
      "when": "price already too extended, FOMO-driven, hot RVOL/gap/first-hour tape",
      "verdict": "NOT an edge. Net flat over 56 trades and entirely driven by ONE NVDA outlier (+$199); ex-outlier ~$0.",
      "action": "reclassify - do NOT log as VWAP Pull-In. Pass or treat as a behavioral warning.",
      "reason_code": "CHASE_EXTENDED"
    },
    "pass_no_trade": {
      "when": "no clear edge, no clear management plan, failed gate, cannot honestly name the setup",
      "test": "If the only honest label is 'I want to be in this stock right now', it is a chase. Pass.",
      "reason_code": "NO_TRADE"
    }
  },

  "risk_rules": {
    "_note": "Grade tiers and Daily-Stop unit mapping are a WORKING CONVENTION - confirm your own unit size. 1 unit = your pre-defined per-trade max risk (a fraction of your Daily Stop).",
    "green": { "size_fraction": 1.0, "grade": "A / A+", "units": "up to 1 full per-trade unit", "note": "full planned size; this is where the edge is" },
    "yellow": { "size_fraction": 0.5, "grade": "B", "units": "<= 1/2 unit", "note": "confirmation-only; half size even when you take it" },
    "red": { "size_fraction": 0.0, "grade": "C / no-grade", "units": "0 (or 1/4-unit review-only if explicitly studying tape)", "note": "no trade as plain pull-in" }
  },

  "checkpoints": {
    "_rule": "Cut fades early; trail expansions only after they persist.",
    "t_plus_3_min": {
      "question": "Is it fading against me with no band expansion?",
      "if_fade": "reduce or exit - a plain pull-in fading at 3 min wins only ~7%",
      "evidence": "fades win ~25-26% across all windows; data-proven primary risk control"
    },
    "t_plus_5_min": {
      "question": "Rotation, expansion, or wrong-side?",
      "rotation": "flat band + flat slope -> manage as scalp, target the opposite band, do not extend stops",
      "expansion": "band width expands + slope accelerates in direction -> possible Pull-In -> Trend",
      "wrong_side": "state/slope flips against me -> exit or reduce quickly"
    },
    "t_plus_10_15_min": {
      "question": "Does expansion PERSIST?",
      "if_persists": "trail the runner - do not blind-hold (only ~42% of early expansion persists to 30 min)",
      "if_decays": "treat as rotation/scalp; bank it",
      "if_fails_vwap_or_lower_band": "exit / reduce"
    }
  },

  "reason_codes": {
    "pre_entry": {
      "CALM_PULLIN": "GREEN gate - normal pull-in taken",
      "HOT_NEEDS_CONFIRM": "YELLOW - taken at half size with stated thesis",
      "HOT_PASS": "RED - hot tape, passed",
      "CHASE_EXTENDED": "RED - extended/FOMO, reclassified not taken as pull-in",
      "DAMAGE_SYMBOL": "RED - symbol on damage watch (IBIT/AMD/ETHU/RGTI/CVX)",
      "FIRST_HOUR_HOT": "RED - 09:00-10:00 ET hot tape",
      "NO_TRADE": "Pass - no edge / no plan / cannot name it"
    },
    "post_entry_mechanism": {
      "pull_in_to_trend_confirmed": "band doubled + slope accelerated >= +5 deg in direction + state -> TREND within 15 min; trail/hold core",
      "vwap_rotation_scalp": "stayed ROTATION, |slope| < 2 deg, bands flat, expansion < 50; target band, take rotation",
      "wrong_side_escape": "state flipped to TREND opposite direction within 15 min; exit immediately, P&L is noise not signal",
      "trend_continuation_entry": "entered already in TREND in trade direction; this is not a pull-in - it is a continuation entry",
      "insufficient_data": "no bars / cannot classify"
    }
  },

  "scorecard_integration": {
    "principle": "Grade the PROCESS, not the P&L. A losing trade can grade A; a profitable trade can grade F. This is how the scorecard turns the gate into accountability.",
    "fields": {
      "setup_classification": ["plain_vwap_pull_in", "pull_in_to_trend", "chase_extended", "pass_no_trade"],
      "gate_color": ["green", "yellow", "red"],
      "rvol_at_entry": "numeric",
      "gap_pct": "numeric",
      "vwap_slope_state": ["rising", "flat", "falling"],
      "band_width_state": ["contracting", "flat", "expanding", "blown_out"],
      "price_location_vs_vwap": "signed SD offset at entry",
      "first_3min_result": ["holding", "fading", "expanding"],
      "first_5min_state": ["rotation", "early_expansion", "wrong_side"],
      "first_10_15min_confirmation": ["expansion_persisted", "expansion_decayed", "never_expanded", "failed"],
      "management_mode": ["rotation_scalp", "trend_hold", "failed_pull_in_exit", "no_trade"],
      "rule_followed": "boolean",
      "mistake_type": ["chased_hot_tape", "oversized_yellow", "traded_red_gate", "held_rotation_like_trend", "ignored_3min_failure", "no_clear_invalidation", "good_execution"],
      "improvement_note_plain_english": "text"
    },
    "grade_logic": {
      "grades_well_even_if_loss_when_ALL": [
        "gate was valid (green or correctly-confirmed yellow)",
        "setup_classification was correct for the tape",
        "size matched the gate (full green / half yellow / none red)",
        "exit followed the checkpoint rules (cut the fade, trailed the persistent expansion, took the rotation)"
      ],
      "grades_poorly_even_if_profit_when_ANY": [
        "it was a RED-gate trade",
        "it was actually a chase but tagged as a pull-in",
        "size was too large for a yellow or red condition",
        "no invalidation was defined before entry",
        "the 3-5 minute failure was ignored (held a fade)"
      ],
      "note": "Profitable-but-poorly-graded trades are the priority review target — they reward bad process and hide the leak. Maps to mistake_type so the scorecard can tally which error costs the most."
    }
  },

  "system_integration": {
    "architecture": "Strategy Library (/strategies/) = source of truth for WHAT is traded; Execution Scorecards (/scorecards/) = grading layer for HOW it was executed; AMS hub (smb.a1prospect.com/ams/system/) = umbrella.",
    "this_spec_role": "the bridge — gate + classification + grade logic that should feed all three, not stay isolated in /system/.",
    "strategy_library_draft": "vwap_pull_in_strategy_library_draft.json",
    "classifier_hook": "_scientific_overlay.js#classifyEntry (do not edit without approval)",
    "promotion_gate": "Answer the backtest/validation questions before promoting any working_rule into official strategies.json / _scientific_overlay.js entries."
  },

  "say_out_loud_before_entry": [
    "Is this calm tape or hot tape?",
    "Am I taking a pull-in, a pull-in-to-trend, or am I chasing?",
    "What confirms the trade after entry?",
    "Where am I wrong?",
    "What size does this deserve?"
  ],

  "validation_needed": [
    "Do the RVOL bands (1.0-1.5 / 1.5-2.5 / >2.5) actually separate winners from losers at the per-trade level (not just group means)? Backtest with RVOL backfilled where NULL.",
    "Does gap% add separation beyond RVOL, or is it redundant?",
    "Does a 3-minute fade reliably predict a failed pull-in (the ~7% win-rate claim) on a larger forward sample?",
    "Does 10-15 minute persistent expansion confirm Pull-In -> Trend, and how often does early expansion decay?",
    "Which symbols should be blocked vs merely size-reduced? Is the IBIT/levered-proxy pattern stable, and does CVX belong on the list?",
    "Should thresholds differ by symbol liquidity tier, sector, or market regime (VCET state)?",
    "Re-run the diagnostic after 2 weeks of GREEN-only enforcement to measure the realized P&L delta vs the back-of-envelope +$500 family estimate."
  ]
}
