Market Structure Recovery Planner [AGPro Series]Market Structure Recovery Planner
🧠 Core Idea
Did damaged market structure recover with enough acceptance, risk clarity, and target room to deserve attention?
📌 Overview / What it does
Market Structure Recovery Planner is a chart-first planning tool for evaluating what happens after clean swing structure gets damaged and price attempts to repair the damaged rail.
The default design is strongest on 4H swing-structure charts, where the damage / recovery / repair-room sequence has enough space to be readable without becoming too sparse or too noisy.
The script maps a damaged structure rail, recovery pocket, risk edge, repair-room corridor, 0-100 recovery score, acceptance state, and a clear next-action panel. It does not try to predict price or automate decisions.
It is designed to make structure recovery easier to review: what broke, what was recovered, whether acceptance is building, where the plan becomes invalid, and whether enough structural room remains.
🎯 Purpose & Design Philosophy
This script was built to fill the gap between generic structure labels and full break-retest systems.
Many tools show a BOS, CHOCH, or support/resistance touch. Market Structure Recovery Planner focuses on the recovery phase after damage: the moment where structure may be repairing but still needs proof.
It supports traders who want a decision-engine workflow instead of another raw signal marker.
⚡ Why This Script Is Different
Most tools focus on detecting a structure break or plotting broad support and resistance zones.
This script does NOT clone BOS / CHOCH scanners, Structure Retest Planner, Reclaim Breakout Planner, or generic S/R maps.
Instead, it studies damaged swing structure and asks whether the damaged rail has been recovered with acceptance, participation, risk clarity, and enough room to matter.
⚙️ Methodology
1. Context Detection
The script confirms swing structure using higher-high / higher-low or lower-high / lower-low behavior.
2. Damage Mapping
When clean structure loses its prior swing rail, the script records the damaged rail and the damage extreme.
3. Recovery Evaluation
Price must reclaim the damaged rail. The 0-100 score weighs damage depth, recovery close, acceptance hold, volume response, and room to target.
4. Visual Output
The chart shows the recovery pocket, risk edge, repair-room corridor, event labels, and a compact AG Pro panel.
🗺️ How to Read the Chart
Recovery Pocket = the area around the damaged structure rail where repair quality is evaluated.
Risk Edge = the level where the active recovery plan should be reviewed as failed or invalidated.
Repair Room = the available structural space between the recovered rail and the next room reference.
Labels = compact state markers for damage, recovery, ready state, thin room, or failed recovery.
Panel = structure state, recovery score, acceptance, risk edge, and next action.
🚦 Signals & States
• Structure Damage Detected → a clean swing structure rail has been broken.
• Structure Recovery Detected → price recovered the damaged rail.
• Recovery Planner Ready → score, acceptance, and repair room meet the configured threshold.
• Repair Room Thin → recovery exists but available room is limited.
• Recovery Failed → price crossed the active risk edge.
🔔 Alerts Logic
Alerts trigger when structure damage appears, recovery is detected, planner-ready state begins, repair room becomes thin, or the active recovery fails.
Alerts are attention markers only. They are not trade instructions and do not imply guaranteed outcomes.
🧩 Confluence Logic
The recovery context becomes stronger when structure damage is repairable, price closes back through the damaged rail, acceptance holds for several bars, volume participation improves, and room to the next structural reference remains open.
📊 When to Use
• 4H swing-structure review
• After a clean swing structure loses a key rail
• During trend repair attempts
• Around failed breakdown or failed breakout behavior
• When a trader needs risk / target / invalidation context after structural damage
⚠️ When NOT to Use
• Very low timeframes where structure damage appears too often
• Very high timeframes where recovery states can stay expired for long periods
• Extremely low-liquidity markets
• Very noisy chop where swing structure changes constantly
• Major news candles with abnormal displacement
• Markets where volume data is unreliable and structure is too compressed
🎛️ Key Inputs
• Structure Swing Length → controls how selective the swing structure model is.
• Sensitivity → adjusts damage and recovery rail strictness.
• Timely Recovery Window → controls how long a damaged rail remains relevant.
• Planner Ready Score → sets the required quality threshold.
• Panel / Label Settings → control location, theme, size, and visual density.
🖥️ Interface & Visual Design
The interface is designed around a compact premium panel and clean chart-first visuals.
The first panel row uses the AG Pro title format. Zones are restrained and centered, labels are offset away from candles, and the chart remains readable while still showing enough state markers to avoid an empty look.
🧪 Practical Usage Workflow
1. Read the panel structure state.
2. Check whether the damaged rail has a recovery pocket.
3. Review recovery score and acceptance.
4. Compare risk edge with repair room.
5. Treat the action row as a review state, not as an instruction.
🔍 Interpretation Guidelines
Think in stages: damage, recovery, acceptance, room, and failure.
A high score means the recovery context is cleaner according to the script rules. A low score means the repair is weak, late, thin, or poorly supported.
🚫 What This Script Is NOT
• Not a prediction engine
• Not financial advice
• Not auto trading
• Not guaranteed signals
• Not a generic BOS / CHOCH scanner
• Not a generic support / resistance zone map
⚠️ Limitations & Transparency
Swing confirmation depends on the selected timeframe and pivot length.
Volatility can widen recovery pockets and change the quality score.
Market conditions can shift quickly, especially during news, low liquidity, or abnormal volume.
🧠 Market Context Notes
Structure recovery is most useful when the trader already understands the broader trend, liquidity environment, and volatility regime.
The script gives a structured review of damaged structure, not certainty about future price movement.
🧾 Use Case Examples
When bullish structure loses a higher-low rail and later closes back above that rail with acceptance, the script can mark a bullish recovery review.
When bearish structure loses a lower-high rail and later closes back below that rail, the script can mark a bearish recovery review.
🧱 System Philosophy
Market Structure Recovery Planner follows the AGPro Series approach: clear structure, rule-based scoring, readable visuals, and decision support without outcome promises.
🔐 Non-Promise Statement
No script can guarantee market direction, trade success, or certainty.
This tool provides structured context only.
📉 Risk Disclosure
Trading involves risk.
Users are responsible for their own analysis, risk management, and decisions.
This script does not provide financial advice.
📚 Educational Note
Use the script to study how structure damage and recovery behave across different symbols, sessions, and timeframes.
For public chart examples, 4H is the recommended default because it shows the structure-repair workflow most clearly.
Indicator
