Contrarian Setup Gate

Overview

Synthesize 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.

The 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.

When to Use

• After running cot-contrarian-detector (always required -- this is the pipeline's entry point)
• Mid-pipeline, with only the detector report, to see the CROWDED state and what steps remain
• After running news-reaction-failure-analyzer, to see whether the setup advances to WATCHING_PRICE or is REJECTED
• After running technical-analyst's contrarian-confirmation mode, to see whether the setup reaches READY_FOR_PLAN
• Before handing a symbol's direction and stop level to a position-sizing skill

Prerequisites

• Python 3.9+
• No API keys -- this skill is fully offline
• A cot-contrarian-detector JSON report for the symbol under evaluation (required)
• Optionally, a news-reaction-failure-analyzer JSON report for the same symbol (step 2)
• Optionally, a technical-analyst contrarian-confirmation JSON report for the same symbol (step 3)

Workflow

Step 1: Run the Gate