{
  "meta": {
    "schema_version": "library-draft-0.1",
    "generated_at": "2026-06-09",
    "status": "DRAFT — not promoted. Read-only. Do NOT merge into strategies.json or _scientific_overlay.js without explicit approval.",
    "purpose": "Draft Strategy Library objects for the 4 VWAP Pull-In decision states, so the actionable playbook can later become official Strategy Library metadata used by the classifier, scorecards, and VCET alerts — instead of staying isolated in /system/.",
    "bridges": {
      "strategy_library_what": "trsportsacademy.com/strategies/  (data layer: /system/strategies.json ; display: /strategies/index.html CATALOG, mirrored from /scorecards/_scientific_overlay.js)",
      "execution_scorecards_how": "trsportsacademy.com/scorecards/  (classifier: _scientific_overlay.js#classifyEntry)",
      "system_architecture_hub": "smb.a1prospect.com/ams/system/  (AMS umbrella)"
    },
    "honesty": "No invented performance stats. observed_performance values are sourced from main.trade_context (CANONICAL_STRATEGY_PERFORMANCE_REPORT, 2026-06-03) and labeled. All thresholds default to validation_status='working_rule_needs_backtest' until the §K / backtest questions are answered.",
    "taxonomy_reconciliation_required": {
      "issue": "This draft uses underscore canonical_slug values (vwap_pull_in, vwap_pull_in_to_trend, chase_extended, pass_no_trade). The LIVE taxonomy uses hyphenated DB slugs (vwap-pull-in, 'vwap-pull-in -> trend', chase-extended) and strategies.json ids (vwap-pull-in-long, etc.). Each object carries db_canonical_strategy_slug + library_id_ref to map across. Pick ONE canonical form before promotion.",
      "chase_extended_is_not_a_strategy": "chase-extended is an off-book classifier SENTINEL / warning overlay, not a tradeable setup (net flat, one NVDA outlier). In the orthogonal model it belongs on the entry-location/extension-warning axis, NOT the setup axis. Represented here with is_edge=false, is_sentinel=true.",
      "pass_no_trade_is_a_decision_state": "Not a strategy and not off-book — a logged no-trade decision. tradeable=false."
    },
    "schema_alignment_to_strategies_json": {
      "required_conditions": "~ entry_rules[] (required=true) + gating",
      "disqualifiers": "~ gating exclusions (new concept; the gate's RED conditions)",
      "trigger_conditions": "~ entry_rules execution trigger",
      "confirmation_conditions": "~ NEW post-entry layer (first 3/5/10-15 min) — not in current schema; would need additive fields",
      "risk_rules": "~ stop_variants + size policy",
      "management_rules": "= management_rules[]",
      "invalidation_rules": "= invalidation_conditions[]",
      "scorecard_fields": "~ quality_indicators[] inputs + NEW execution-quality fields",
      "reason_codes": "NEW — not in current schema"
    },
    "scorecard_field_schema": {
      "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 (e.g. -0.4, +1.2)",
      "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"
    },
    "related_pages": [
      "VWAP_PULL_IN_ACTIONABLE_PLAYBOOK.html",
      "vwap_pull_in_actionable_gate.json",
      "VWAP_PULL_IN_QUALITY_GATE.html",
      "CANONICAL_STRATEGY_PERFORMANCE_REPORT.html",
      "PULL_IN_TO_TREND_MECHANISM_AUDIT.html",
      "VWAP_PULL_IN_CLASSIFIER_REFINEMENT_PLAN.html"
    ]
  },

  "strategies": [
    {
      "canonical_slug": "vwap_pull_in",
      "db_canonical_strategy_slug": "vwap-pull-in",
      "library_id_ref": ["vwap-pull-in-long", "vwap-pull-in-short"],
      "display_name": "VWAP Pull-In (Plain)",
      "family": "vwap_pullback_continuation",
      "direction": "long primary; short mirror",
      "setup_type": "plain_vwap_pull_in",
      "is_edge": true,
      "is_sentinel": false,
      "tradeable": true,
      "market_context": {
        "tape": "calm / controlled only",
        "rvol": {"min": 1.0, "max": 1.5, "validation_status": "working_rule_needs_backtest"},
        "gap_pct_abs": {"max": 0.5, "validation_status": "working_rule_needs_backtest"},
        "regime": "rotation",
        "time_of_day": "after 10:00 ET preferred; first hour is double-strict",
        "note": "Assume scalp/rotation. Do NOT assume trend."
      },
      "required_conditions": [
        "Entry between VWAP and -0.5 SD (LB1) zone, on volume",
        "VWAP holding as support (bounce, not break-through)",
        "Controlled pullback, price not extended past +1 SD when entry sets up"
      ],
      "disqualifiers": [
        "RVOL > 2.5",
        "gap_pct_abs > 1.5",
        "first-hour (09:00-10:00 ET) hot tape",
        "price extended far from VWAP / beyond +2 SD",
        "damage symbol: IBIT, AMD, ETHU, RGTI, CVX",
        "cannot honestly name the setup"
      ],
      "trigger_conditions": [
        "LB1 hold + 9 EMA reclaim / volume confirmation"
      ],
      "confirmation_conditions": [
        "POST-ENTRY (decides management, not entry): band width expands + VWAP slope accelerates in direction within 5 min -> may convert to pull_in_to_trend",
        "flat band + flat slope -> stays a rotation scalp"
      ],
      "risk_rules": {
        "gate_size_map": {"green": "full / A-A+", "yellow": "half / B", "red": "none / C"},
        "stop": "VWAP / reaction-point swing (Dale: 1st-dev, no fixed SD multiple; -2 SD is a James overlay)",
        "target": "opposite band / +2 SD"
      },
      "management_rules": [
        "Default: manage as rotation scalp; target the opposite band; do not extend stops",
        "~3 min: if fading with no band expansion, reduce/exit (a plain pull-in fading at 3 min wins ~7%)",
        "Only hold for trend if expansion confirms AND persists to 10-15 min"
      ],
      "invalidation_rules": [
        "Decisive close below VWAP on above-average volume",
        "3-min fade with no expansion",
        "configured stop breached"
      ],
      "scorecard_fields": ["setup_classification", "gate_color", "rvol_at_entry", "gap_pct", "vwap_slope_state", "band_width_state", "price_location_vs_vwap", "first_3min_result", "first_5min_state", "first_10_15min_confirmation", "management_mode", "rule_followed", "mistake_type", "improvement_note_plain_english"],
      "reason_codes": ["CALM_PULLIN", "HOT_NEEDS_CONFIRM", "HOT_PASS", "DAMAGE_SYMBOL", "FIRST_HOUR_HOT"],
      "observed_performance": {
        "source": "main.trade_context via CANONICAL_STRATEGY_PERFORMANCE_REPORT 2026-06-03",
        "n": 127, "net_pnl": -364.47, "avg": -2.87, "win_rate": 0.354,
        "note": "Net LEAK, but concentrated in hot-tape/damage-symbol/first-hour selection. Calm-tape winners (n=45) had RVOL 1.38 / gap +0.35%. The loss is a selection problem, not the technique.",
        "tier": "proven"
      },
      "validation_status": "working_rule_needs_backtest",
      "related_pages": ["VWAP_PULL_IN_ACTIONABLE_PLAYBOOK.html", "VWAP_PULL_IN_SPLIT_DIAGNOSTIC.md"]
    },

    {
      "canonical_slug": "vwap_pull_in_to_trend",
      "db_canonical_strategy_slug": "vwap-pull-in -> trend",
      "library_id_ref": ["trend-trade-long", "trend-trade-short"],
      "display_name": "VWAP Pull-In → Trend",
      "family": "vwap_pullback_continuation",
      "direction": "long primary; short mirror",
      "setup_type": "pull_in_to_trend",
      "is_edge": true,
      "is_sentinel": false,
      "tradeable": true,
      "is_mechanism_confirmed": false,
      "market_context": {
        "tape": "starts as a calm pull-in; EARNS the trend-hold only after post-entry confirmation",
        "rvol": {"approx": 1.1, "validation_status": "working_rule_needs_backtest"},
        "gap_pct": {"note": "winners often gap-down ~ -0.9%", "validation_status": "working_rule_needs_backtest"},
        "note": "OUTCOME label, not a guaranteed mechanism. Confirm with behavior, do not assume trend."
      },
      "required_conditions": [
        "Same entry zone as plain VWAP Pull-In (VWAP to -0.5 SD)"
      ],
      "disqualifiers": [
        "no post-entry confirmation -> it is a plain pull-in / rotation scalp, not a trend",
        "opposite-side break after entry -> wrong_side_escape, exit"
      ],
      "trigger_conditions": [
        "Plain pull-in trigger fires first; the -> trend status is granted later by confirmation"
      ],
      "confirmation_conditions": [
        "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",
        "expansion PERSISTS into the 10-15 min checkpoint (only ~42% of early expansion survives to 30 min)"
      ],
      "risk_rules": {
        "policy": "Do not pre-size as a trend. Add/hold only after confirmation. Trail; never blind-hold.",
        "stop": "trail back toward VWAP once +2 SD close occurs (Trend Trade rules)",
        "target": "+4 SD (UB5)"
      },
      "management_rules": [
        "Trail expansions only after they persist to 10-15 min",
        "If expansion decays, bank it as a scalp",
        "If price loses +1 SD support, exit/reduce"
      ],
      "invalidation_rules": [
        "close below +1 SD (pullback support broken)",
        "expansion decays / state reverts to ROTATION",
        "VWAP / stop breach"
      ],
      "scorecard_fields": ["setup_classification", "gate_color", "rvol_at_entry", "gap_pct", "vwap_slope_state", "band_width_state", "price_location_vs_vwap", "first_3min_result", "first_5min_state", "first_10_15min_confirmation", "management_mode", "rule_followed", "mistake_type", "improvement_note_plain_english"],
      "reason_codes": ["CALM_PULLIN", "PI_TO_TREND_CONFIRMED", "WRONG_SIDE"],
      "observed_performance": {
        "source": "main.trade_context via CANONICAL_STRATEGY_PERFORMANCE_REPORT 2026-06-03",
        "n": 15, "net_pnl": 367.67, "avg": 24.51, "win_rate": 0.933,
        "caveat": "Real and profitable AS A BUCKET, but OUTCOME-based: of 6 mechanically-classifiable trades only 1 was a true conversion (most were rotation scalps); 64% of the dollars are too old to verify. Tiny sample (n=15). Name overstates 'trend conversion' ~5x.",
        "tier": "proven_but_n_tiny_and_mixed"
      },
      "validation_status": "working_rule_needs_backtest",
      "related_pages": ["PULL_IN_TO_TREND_MECHANISM_AUDIT.html", "PI_TREND_ROTATION_WINNERS_REVIEW.html"]
    },

    {
      "canonical_slug": "chase_extended",
      "db_canonical_strategy_slug": "chase-extended",
      "library_id_ref": ["off-book"],
      "display_name": "Chase / Extended",
      "family": "off-book",
      "direction": "any",
      "setup_type": "chase_extended",
      "is_edge": false,
      "is_sentinel": true,
      "tradeable": false,
      "axis_note": "Belongs on the entry-location / extension-warning OVERLAY axis, NOT the setup axis. It is a behavioral warning, not a playbook.",
      "market_context": {
        "tape": "hot RVOL / large gap / first-hour emotion; price already extended; FOMO-driven"
      },
      "required_conditions": [],
      "disqualifiers": ["This IS the disqualifier for tagging something a plain pull-in"],
      "trigger_conditions": [],
      "confirmation_conditions": [],
      "risk_rules": {"policy": "No trade as a pull-in. Reclassify or pass."},
      "management_rules": ["If already in: it is not a pull-in; manage as a chase and reduce risk fast."],
      "invalidation_rules": [],
      "scorecard_fields": ["setup_classification", "gate_color", "rvol_at_entry", "gap_pct", "price_location_vs_vwap", "rule_followed", "mistake_type", "improvement_note_plain_english"],
      "reason_codes": ["CHASE_EXTENDED", "RVOL_HOT", "GAP_EXTENDED", "FIRST_HOUR_EMOTION"],
      "observed_performance": {
        "source": "main.trade_context via CANONICAL_STRATEGY_PERFORMANCE_REPORT 2026-06-03",
        "n": 56, "net_pnl": 200.12, "win_rate": 0.571,
        "caveat": "NET POSITIVE IS AN ILLUSION: entirely one NVDA +$199.07 outlier; ex-outlier ~flat (-$0.79 over the other 57 in the deeper audit). NOT an edge.",
        "tier": "proven_not_an_edge"
      },
      "validation_status": "sentinel_not_an_edge",
      "related_pages": ["CANONICAL_STRATEGY_PERFORMANCE_REPORT.html"]
    },

    {
      "canonical_slug": "pass_no_trade",
      "db_canonical_strategy_slug": null,
      "library_id_ref": [],
      "display_name": "Pass / No Trade",
      "family": "decision_state",
      "direction": "n/a",
      "setup_type": "pass_no_trade",
      "is_edge": false,
      "is_sentinel": true,
      "tradeable": false,
      "market_context": {
        "tape": "failed the gate / no clear edge / no management plan / cannot honestly name the setup"
      },
      "required_conditions": ["A correctly-passed trade is logged as a decision, not a missing row"],
      "disqualifiers": [],
      "trigger_conditions": [],
      "confirmation_conditions": [],
      "risk_rules": {"policy": "0 size. The best trade is often no trade."},
      "management_rules": [],
      "invalidation_rules": [],
      "scorecard_fields": ["setup_classification", "gate_color", "management_mode", "rule_followed", "mistake_type", "improvement_note_plain_english"],
      "reason_codes": ["NO_TRADE", "HOT_PASS"],
      "observed_performance": {"note": "Not measured — a pass produces no P&L. Track pass-discipline (did you correctly pass a RED?) as a scorecard positive (rule_followed=true, good_execution).", "tier": "n/a"},
      "validation_status": "decision_state_not_a_strategy",
      "related_pages": ["VWAP_PULL_IN_ACTIONABLE_PLAYBOOK.html"]
    }
  ]
}
