{
  "version": "1.0",
  "strategy": "vwap_pull_in",
  "title": "VWAP Pull-In Forward-Test Schema",
  "generated": "2026-06-09",
  "purpose": "Forward-test whether VWAP Pull-In improves when James separates calm pull-ins from hot tape and cuts failed pull-ins within 3-5 minutes. Evidence layer BEFORE any Strategy Library / Scorecard / VCET production promotion.",

  "validation_status": {
    "strategy_library_promotion": "HOLD",
    "scorecard_production_integration": "HOLD",
    "vcet_production_alerting": "HOLD",
    "forward_test_capture": "START",
    "basis": "Walk-forward / OOS (VWAP_PULL_IN_WALKFORWARD_OOS_VALIDATION) showed the entry gate alone flips negative out of sample; the durable edge is post-entry management. Forward-test the frozen rules live before promoting anything."
  },

  "frozen_rules": [
    {"rule": "green_yellow_red_gate", "what_to_test": "does the gate separate expectancy live?", "oos_status": "entry-gate alone flipped negative OOS; test the full stack"},
    {"rule": "gap_red_condition", "what_to_test": "|gap|>1.5% keeps losing", "oos_status": "held directionally (by win rate)"},
    {"rule": "instrument_type_warning", "what_to_test": "megacap-tech vs crypto-proxy/small-cap/high-beta", "oos_status": "megacap is RELATIVE least-bad filter only, NOT an absolute edge (flipped OOS)"},
    {"rule": "three_min_fade_exit", "what_to_test": "fade at 3 min predicts a failed pull-in", "oos_status": "HELD OOS - strongest, most robust rule"},
    {"rule": "five_min_rotation_vs_expansion", "what_to_test": "classify rotation vs expansion at 5 min", "oos_status": "held OOS (expansion wins, fade loses at every RVOL)"},
    {"rule": "ten_fifteen_min_trend_confirmation", "what_to_test": "expansion at 10-15 min identifies Pull-In -> Trend", "oos_status": "held directionally; trend-hold only after confirmation"},
    {"rule": "chase_extended_reclassification", "what_to_test": "extended/FOMO entries reclassified, not logged as Pull-In", "oos_status": "chase-extended is a sentinel, not an edge (net flat ex-outlier)"},
    {"rule": "plain_pull_in_managed_as_rotation_unless_trend_confirms", "what_to_test": "don't hold a plain pull-in like a trend trade without confirmation", "oos_status": "post-entry management rescued the gate OOS - this is the core finding"}
  ],

  "rvol_note": "RVOL is captured for context/diagnostics ONLY. The RVOL x instrument-type cross-tab showed RVOL does not separate winners from losers once type is controlled. Do NOT use RVOL as a gate input; log it to keep validating.",

  "capture_fields": [
    {"name": "date", "type": "date", "required": true},
    {"name": "ticker", "type": "text", "required": true},
    {"name": "side", "type": "enum", "required": true},
    {"name": "entry_time", "type": "time", "required": false},
    {"name": "entry_price", "type": "number", "required": false},
    {"name": "planned_stop", "type": "number", "required": false},
    {"name": "planned_target", "type": "number", "required": false},
    {"name": "strategy_tag_used", "type": "text", "required": false},
    {"name": "setup_classification", "type": "enum", "required": true},
    {"name": "gate_color", "type": "enum", "required": true},
    {"name": "rvol_at_entry", "type": "number", "required": false, "note": "context only, not a gate input"},
    {"name": "gap_pct", "type": "number", "required": false},
    {"name": "instrument_type", "type": "enum", "required": true},
    {"name": "vwap_slope_state", "type": "enum", "required": false},
    {"name": "band_width_state", "type": "enum", "required": false},
    {"name": "price_location_vs_vwap", "type": "number", "required": false, "note": "signed SD offset at entry"},
    {"name": "first_3min_result", "type": "enum", "required": false},
    {"name": "first_5min_state", "type": "enum", "required": false},
    {"name": "first_10_15min_confirmation", "type": "enum", "required": false},
    {"name": "management_mode", "type": "enum", "required": false},
    {"name": "rule_followed", "type": "enum", "required": true},
    {"name": "mistake_type", "type": "enum", "required": true},
    {"name": "pnl", "type": "number", "required": false},
    {"name": "r_multiple", "type": "number", "required": false},
    {"name": "improvement_note_plain_english", "type": "text", "required": false}
  ],

  "allowed_values": {
    "side": ["long", "short"],
    "setup_classification": ["plain_vwap_pull_in", "pull_in_to_trend", "chase_extended", "pass_no_trade"],
    "gate_color": ["green", "yellow", "red"],
    "instrument_type": ["etf", "crypto_proxy", "megacap_tech", "small_cap", "high_beta", "other"],
    "vwap_slope_state": ["rising", "flat", "falling"],
    "band_width_state": ["expanding", "stable", "contracting"],
    "first_3min_result": ["confirmed", "faded", "unclear"],
    "first_5min_state": ["rotation", "expansion", "fade", "unclear"],
    "first_10_15min_confirmation": ["trend_confirmed", "no_trend_confirmation", "not_applicable"],
    "management_mode": ["rotation_scalp", "trend_hold", "failed_pull_in_exit", "no_trade"],
    "rule_followed": ["true", "false"],
    "mistake_type": ["chased_hot_tape", "oversized_yellow", "traded_red_gate", "held_rotation_like_trend", "ignored_3min_failure", "no_clear_invalidation", "good_execution"]
  },

  "grade_logic": {
    "principle": "Grade the PROCESS, not the P&L. A losing trade can grade well; a profitable trade can grade poorly.",
    "grades_well_even_if_loss_when_ALL": [
      "gate was valid",
      "setup_classification was correct",
      "size matched the gate",
      "invalidation was defined before entry",
      "the 3-5 minute checkpoint was respected"
    ],
    "grades_poorly_even_if_profit_when_ANY": [
      "it was a RED-gate trade",
      "it was actually Chase / Extended but tagged as Pull-In",
      "size was too large for a Yellow or Red condition",
      "no invalidation was defined",
      "the 3-5 minute failure was ignored",
      "a plain Pull-In was held like a trend trade without confirmation"
    ]
  },

  "sample_size_requirements": {
    "initial_review_only": 20,
    "enough_to_consider_rule_changes": 50,
    "min_green": 10,
    "min_yellow": 10,
    "min_red_or_pass": 10,
    "min_post_entry_fade_cases": 10,
    "min_expansion_confirmation_cases": 10,
    "must_separate_etf_crypto_from_single_stock": true,
    "do_not_promote_from_one_symbol_or_one_regime": true
  },

  "promotion_criteria": [
    "Green trades show better expectancy than the old generic Pull-In",
    "Red trades show avoided loss or poor expectancy",
    "Yellow reduced-size logic reduces drawdown",
    "3-minute fade continues to predict failed Pull-Ins",
    "10-15 minute expansion continues to identify Pull-In -> Trend",
    "scorecard mistake tags explain the P&L leak",
    "results hold across more than one symbol type AND market regime"
  ],

  "reason_codes": {
    "pre_entry": {
      "CALM_PULLIN": "GREEN gate - normal pull-in taken",
      "HOT_NEEDS_CONFIRM": "YELLOW - half size with stated thesis",
      "HOT_PASS": "RED - hot/extended tape, passed",
      "CHASE_EXTENDED": "RED - extended/FOMO, reclassified not taken as a pull-in",
      "DAMAGE_SYMBOL": "RED - robust damage symbol (IBIT, CVX); tiny-sample watch (AMD/ETHU/RGTI)",
      "FIRST_HOUR_HOT": "RED - 09:00-10:00 ET hot tape",
      "NO_TRADE": "Pass - no edge / no plan / cannot name it"
    },
    "post_entry": {
      "FADE_EXIT": "3-5 min fade against trade + no expansion -> cut (strongest OOS rule)",
      "ROTATION_SCALP": "flat band + flat slope -> target the band, take the rotation",
      "TREND_CONFIRMED": "expansion persists to 10-15 min -> trail the runner",
      "WRONG_SIDE": "state flips opposite -> exit, P&L is noise"
    }
  },

  "related_pages": [
    "VWAP_PULL_IN_FORWARD_TEST_TRACKER.html",
    "VWAP_PULL_IN_WALKFORWARD_OOS_VALIDATION.html",
    "VWAP_PULL_IN_RVOL_INSTRUMENT_TYPE_CROSSTAB.html",
    "VWAP_PULL_IN_GATE_VALIDATION_AUDIT.html",
    "VWAP_PULL_IN_ACTIONABLE_PLAYBOOK.html",
    "vwap_pull_in_actionable_gate.json",
    "vwap_pull_in_strategy_library_draft.json"
  ],

  "production_untouched": ["/strategies/", "/scorecards/", "VCET production", "gen_scorecard.py", "_scientific_overlay.js", "taxonomy", "DB"]
}
