contrarian-setup-gate

1# Contrarian Setup Gate
2 
3## Overview
4 
5Synthesize the outputs of Jason Shapiro's 3-step contrarian process into one actionable state. cot-contrarian-detector (step 1) flags crowded positioning, news-reaction-failure-analyzer (step 2) tests whether the market failed to react to news favorable to the crowd, and technical-analyst's contrarian-confirmation mode (step 3) confirms weekly price-action evidence of a reversal. This gate reads those three report JSONs and applies an explicit, exhaustively-tested precedence rule set to produce one `setup_status`, with a fail-closed reason attached to every input that could not be confirmed.
6 
7The gate does no fetching, no API calls, and no computation beyond validating and combining the three inputs it is given. It is the pipeline's synthesis center, not a data source.
8 
9## When to Use
10 
11- After running cot-contrarian-detector (always required -- this is the pipeline's entry point)
12- Mid-pipeline, with only the detector report, to see the CROWDED state and what steps remain
13- After running news-reaction-failure-analyzer, to see whether the setup advances to WATCHING_PRICE or is REJECTED
14- After running technical-analyst's contrarian-confirmation mode, to see whether the setup reaches READY_FOR_PLAN
15- Before handing a symbol's direction and stop level to a position-sizing skill
16 
17## Prerequisites
18 
19- Python 3.9+
20- No API keys -- this skill is fully offline
21- A cot-contrarian-detector JSON report for the symbol under evaluation (required)
22…