OPEN-SOURCE SCRIPT
Mis à jour Market Structure Recovery Planner [AGPro Series]
Market Structure Recovery Planner [AGPro Series]
🧠 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.
🧠 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.
Notes de version
🔧 UPDATE NOTES - V1.1This update focuses on zone-label readability, chart clarity, and premium visual presentation.
The core purpose of the script remains unchanged.
This release improves how the existing recovery pocket and repair-room zones are presented and interpreted on the chart.
This script continues to function as an analytical and visualization tool.
It does not attempt to predict price direction or provide guaranteed outcomes.
------------------------
What Changed
------------------------
• Recovery Pocket label rebuilt as a dedicated centered badge
The Recovery Pocket text is no longer rendered as native box text. It now uses a separate centered label badge positioned inside the zone for cleaner visibility.
• Repair Room label rebuilt as a dedicated centered badge
The Repair Room text is now handled by a separate label object centered vertically and horizontally inside the repair-room zone.
• Zone text alignment refined
Both zone labels now follow the AGPro zone-label standard: readable badge, centered placement, and stronger first-glance recognition.
• Core recovery logic preserved
Damage detection, rail recovery, acceptance scoring, repair-room scoring, alerts, and panel behavior remain unchanged.
------------------------
Visual Improvements
------------------------
• Improved chart readability by removing native box-text rendering from the active zones
• Refined zone-label hierarchy so the Recovery Pocket and Repair Room labels stand out more clearly
• Adjusted zone labeling to keep important text inside the zone without blending into transparent fills
• Reduced visual ambiguity while preserving the original chart layout and signal structure
------------------------
Interface & Usability
------------------------
• Zone labels remain controlled by the existing label font-size input
• Panel layout and panel controls remain unchanged
• Existing visual toggles for Recovery Pocket and Repair Room continue to work as before
• The update improves readability without adding new decision layers or changing interpretation rules
------------------------
Behavior Notes
------------------------
This update does not change the core analytical logic of the script.
The goal is to improve clarity and usability, not to introduce new predictive behavior.
Users should interpret outputs the same way as before, but with improved visual structure.
------------------------
Limitations Reminder
------------------------
The script remains a rule-based analytical tool.
Market conditions such as volatility, liquidity, and timeframe differences may affect how recovery states appear.
Outputs should always be interpreted within broader market context.
------------------------
Risk Reminder
------------------------
This script is for educational and analytical purposes only.
It does not provide financial advice or guaranteed trading outcomes.
Users remain responsible for their own decisions.
Script open-source
Dans l'esprit TradingView, le créateur de ce script l'a rendu open source afin que les traders puissent examiner et vérifier ses fonctionnalités. Bravo à l'auteur! Bien que vous puissiez l'utiliser gratuitement, n'oubliez pas que la republication du code est soumise à nos Règles.
Public-free and invite-only TradingView Pine Script tools for market analysis, risk planning, liquidity and execution review.
Script library & access: aligurtuna.com/agprolabs-pine-scriptleri/
Telegram: t.me/agprolabs
Script library & access: aligurtuna.com/agprolabs-pine-scriptleri/
Telegram: t.me/agprolabs
Clause de non-responsabilité
Les informations et publications ne sont pas destinées à être, et ne constituent pas, des conseils ou recommandations financiers, d'investissement, de trading ou autres fournis ou approuvés par TradingView. Pour en savoir plus, consultez les Conditions d'utilisation.
Script open-source
Dans l'esprit TradingView, le créateur de ce script l'a rendu open source afin que les traders puissent examiner et vérifier ses fonctionnalités. Bravo à l'auteur! Bien que vous puissiez l'utiliser gratuitement, n'oubliez pas que la republication du code est soumise à nos Règles.
Public-free and invite-only TradingView Pine Script tools for market analysis, risk planning, liquidity and execution review.
Script library & access: aligurtuna.com/agprolabs-pine-scriptleri/
Telegram: t.me/agprolabs
Script library & access: aligurtuna.com/agprolabs-pine-scriptleri/
Telegram: t.me/agprolabs
Clause de non-responsabilité
Les informations et publications ne sont pas destinées à être, et ne constituent pas, des conseils ou recommandations financiers, d'investissement, de trading ou autres fournis ou approuvés par TradingView. Pour en savoir plus, consultez les Conditions d'utilisation.