Breakout Base Defense Planner [AGPro Series]Breakout Base Defense Planner
🧠 Core Idea
After a breakout, is the original base being defended or is price losing control back into the base?
📌 Overview / What it does
Breakout Base Defense Planner maps the structure price broke from and tracks whether the broken base edge is being defended.
The script displays the breakout base, a projected base defense zone, defense rail, failure shelf, room reference, defense labels, pressure labels, invalidation labels, right-side tags, and a compact AG Pro dashboard.
It does not predict that a breakout will continue. It helps organize the post-breakout base context: defense score, pressure, room, failure risk, and action state.
🎯 Purpose & Design Philosophy
Many breakout tools focus on the breakout candle or the first follow-through move.
This script was built for a different question: does the original base still matter after the breakout?
It helps traders separate clean base defense from weak breaks that fall back into the structure they came from.
⚡ Why This Script Is Different
Most breakout indicators highlight breakouts or target projections.
This script does NOT build a full R ladder, position planner, or generic breakout continuation system.
Instead, it focuses on the broken base itself: the base box, defense zone, pressure behavior, failure shelf, target room reference, and clear action state.
⚙️ Methodology
1. Base Detection
The script defines a recent base using completed bars and filters it by ATR-based width.
2. Breakout Lock
When price closes beyond the base edge with enough displacement and participation, the base is locked as the active reference.
3. Defense Evaluation
The broken base edge becomes a defense zone. The script checks whether price holds, pressures, or loses that zone.
4. Visual Output
The chart receives a breakout base box, defense zone, defense rail, failure shelf, room rail, labels, right-side tags, optional bar coloring, and a dashboard panel.
🗺️ How to Read the Chart
The breakout base shows the structure price broke from.
The defense zone marks the broken edge that should act as support in bullish breaks or resistance in bearish breaks.
The failure shelf marks where the base defense context fails.
The room rail marks the nearest swing-room reference beyond the breakout direction.
Labels highlight base lock, base defended, defense pressure, room tests, and base lost events.
Colors represent context:
• Teal → bullish base defense
• Pink → bearish base defense or invalidation
• Gold → room reference or waiting context
• Indigo → pressure or monitoring context
The panel summarizes:
• Base
• Defense Score
• Pressure
• Room
• Action
🚦 Signals & States
• Bull Base Breakout → price closed above the base with acceptable quality
• Bear Base Breakout → price closed below the base with acceptable quality
• Base Defended → price tested the broken edge and closed back in the breakout direction
• Defense Pressure → price is testing the defense zone without a clean hold
• Room Test → price reached the active room reference
• Base Lost → price closed beyond the failure shelf
• READY → base defense quality is strong enough to monitor
• MONITOR → price is actively testing the base defense zone
• WAIT → no strong active context exists
• INVALIDATED → the base defense context failed
• EXPIRED → the locked base is too old to remain active
🔔 Alerts Logic
Alerts can trigger when a breakout base is locked, when the base is defended, when READY state appears, when defense pressure appears, when the room rail is reached, or when the base is lost.
Alerts are attention markers only. They are not trade instructions.
🧩 Confluence Logic
The base defense context becomes stronger when the breakout base is well-sized, the breakout close has quality, the defense zone holds, participation is acceptable, and target room remains available.
When base defense and room align, the structure is cleaner. When price presses through the defense zone toward the failure shelf, the context weakens.
📊 When to Use
• After clear breakout moves
• During breakout retests
• When price returns to a broken range edge
• In trending markets where base defense matters
• On liquid symbols with readable structure and volume
• On 4h and 1D charts where base boxes remain visually clear
⚠️ When NOT to Use
• Very low-liquidity markets
• Extremely noisy sideways ranges
• Breakouts without a meaningful base
• News candles with unstable spreads
• Late moves where the base is already too far away to matter
🎛️ Key Inputs
• Base Lookback Bars → controls how the breakout base is detected
• Minimum / Maximum Base Range ATR → filters bases that are too small or too large
• Break Buffer ATR → controls how far beyond the base price must close
• Minimum Break Body Ratio → filters weak wick-only breaks
• Minimum Relative Volume → filters low-participation breaks
• Defense Zone ATR → controls the defended zone around the broken edge
• Failure Buffer ATR → controls where base defense fails
• Target Room Lookback → controls the nearest swing-room reference
• Visual settings → control boxes, rails, labels, tags, panel, and bar colors
🖥️ Interface & Visual Design
The visual design is built around the original base.
The base box provides context, the defense zone shows the key retest area, the failure shelf defines where the idea weakens, and the panel compresses the state into a quick decision-support read.
The goal is a premium, structured chart that feels like a breakout defense map, not a crowded signal board.
🧪 Practical Usage Workflow
1. Check whether a breakout base is active
2. Read the defense score and action state
3. Inspect the defense zone
4. Compare pressure with room
5. Watch the failure shelf for invalidation
6. Confirm the context with broader market structure
🔍 Interpretation Guidelines
A READY state means the base defense context has enough structure to monitor.
Defense pressure means price is testing the broken base edge and the context needs attention.
Base defended means price reacted at the edge, but it does not guarantee continuation.
Room measures available structure beyond the current price, not a promised target.
🚫 What This Script Is NOT
This script is not a prediction engine.
It is not a guaranteed breakout system.
It is not an R-ladder tool.
It is not a position sizing tool.
It is not an automated trading tool.
It does not provide financial advice.
It does not guarantee continuation, reversal, profit, or a specific target.
⚠️ Limitations & Transparency
Breakout base behavior depends on market structure, volatility, liquidity, timeframe, and participation.
Some defended bases may later fail.
Some failed bases may reclaim again later.
The score is a rule-based context score, not a certainty model.
🧠 Market Context Notes
Breakout bases often become important memory zones.
When price breaks out and later defends the original edge, the structure can remain organized.
When price falls back through the edge and failure shelf, the breakout context becomes weaker.
🧾 Use Case Examples
When price breaks above a recent base, the script locks the base and projects a defense zone around the broken edge.
If price returns to the defense zone and closes back above the edge, the script can mark base defense.
If price closes through the failure shelf, the script marks the base as lost.
🧱 System Philosophy
This script follows the AGPro Series approach: turn one important market structure question into a focused decision-support map.
The focus is not prediction. The focus is base context, defense quality, pressure awareness, failure logic, and visual clarity.
🔐 Non-Promise Statement
No script can remove uncertainty from markets.
This tool does not promise accuracy, profitability, or future price movement.
Its purpose is to organize breakout base defense context so the user can interpret the chart more clearly.
📉 Risk Disclosure
Trading involves risk.
Market conditions can change quickly, and any analytical output can fail.
Users are responsible for their own decisions, risk management, and trade execution.
This script is for educational and analytical purposes only and does not provide financial advice.
📚 Educational Note
A breakout is not complete just because price leaves a base.
The quality of the first base defense can often provide more useful context than the breakout candle alone.
Indicator
Post-Breakout Risk Ladder [AGPro Series]Post-Breakout Risk Ladder
🧠 Core Idea
After a breakout happens, is the move still offering clean target room or is pullback risk taking control?
📌 Overview / What it does
Post-Breakout Risk Ladder maps a breakout base, locks the breakout edge, and converts the post-breakout move into a structured R-based risk ladder.
The script displays a breakout base, pullback risk shelf, entry rail, invalidation rail, 1R / 2R / 3R target rails, target defense labels, pullback test labels, and a compact AG Pro dashboard.
It does not predict that a breakout will continue. It helps organize what happens after a breakout: current R, pullback risk, target room, invalidation, and action state.
🎯 Purpose & Design Philosophy
Many breakout tools focus only on the breakout candle.
This script was built for the part that comes next: the risk management phase after the breakout is already visible.
It helps traders read whether the breakout is still structured, whether the pullback is healthy, whether the next target has room, and whether the breakout context has failed.
⚡ Why This Script Is Different
Most breakout indicators highlight the break itself.
This script does NOT treat the breakout as the end of the analysis.
Instead, it builds a post-breakout planning map with a base, entry reference, invalidation shelf, R ladder, pullback risk score, target room, and target defense context.
⚙️ Methodology
1. Breakout Base Detection
The script defines a recent base using completed bars and checks whether price closes beyond the base edge with enough displacement quality.
2. Breakout Lock
When the breakout qualifies, the script locks the base high/low, breakout edge, entry reference, and invalidation edge.
3. Risk Ladder Mapping
Risk is standardized into R units from the breakout entry to invalidation. Target rails are projected as 1R, 2R, and 3R references.
4. Pullback and Defense Evaluation
The script tracks pullback tests into the breakout shelf, current R, target room, and target defense behavior.
🗺️ How to Read the Chart
The breakout base shows the structure that price broke from.
The pullback shelf marks the zone where a retest may remain constructive or become risky.
The entry rail and invalidation rail define the R unit.
The 1R, 2R, and 3R rails show post-breakout target references.
Labels highlight breakout locks, pullback tests, target defense, and invalidation.
The panel summarizes:
• Breakout state
• Current R
• Pullback risk
• Target room
• Action state
🚦 Signals & States
• Bull Breakout → price closed above the breakout base with acceptable quality
• Bear Breakout → price closed below the breakout base with acceptable quality
• Pullback Test → price is testing the post-breakout shelf
• Target Defense → price has reached or interacted with an R target rail
• Invalidated → price lost the active breakout structure
• Expired → the breakout ladder is too old to remain active
🔔 Alerts Logic
Alerts can trigger when a breakout ladder is locked, when the breakout context is READY, when price tests the pullback shelf, when the ladder invalidates, or when target defense appears.
Alerts are attention markers only. They are not trade instructions.
🧩 Confluence Logic
The breakout context becomes stronger when base quality, breakout body strength, relative volume, pullback shelf behavior, and target room align.
The R ladder helps separate structured continuation from late or overextended movement.
📊 When to Use
• After clear range breaks
• During breakout retests
• In trending markets with continuation attempts
• When evaluating post-breakout risk-to-room structure
• On liquid symbols with readable candles and volume
⚠️ When NOT to Use
• Very low-liquidity markets
• Extremely noisy sideways ranges
• Random spike candles without structure
• News candles with unstable spreads
• When no meaningful base exists before the breakout
🎛️ Key Inputs
• Base Lookback Bars → controls how the breakout base is detected
• Break Buffer ATR → controls how far beyond the base price must close
• Minimum Break Body Ratio → filters weak wick-only breaks
• Minimum Relative Volume → filters low-participation breaks
• Retest Shelf ATR → controls the pullback shelf around the broken edge
• Invalidation Buffer ATR → controls where the ladder fails
• Target R Settings → control the 1R / 2R / 3R ladder rails
🖥️ Interface & Visual Design
The visual hierarchy is designed around post-breakout planning.
The base defines context, the shelf defines pullback risk, the rails define R structure, and the panel provides a quick state read.
The goal is to keep the chart useful, structured, and premium without turning it into a cluttered signal board.
🧪 Practical Usage Workflow
1. Check whether a breakout ladder is active
2. Read current R in the panel
3. Inspect the pullback shelf
4. Compare target room with pullback risk
5. Watch invalidation and target defense labels
🔍 Interpretation Guidelines
A READY state means the breakout ladder has enough structure to monitor.
Current R helps measure how far price has moved from the breakout reference.
Pullback risk helps evaluate whether price is still respecting the breakout shelf.
Target room helps avoid treating late moves the same as early moves.
🚫 What This Script Is NOT
This script is not a prediction engine.
It is not a guaranteed breakout system.
It is not an automated trading tool.
It does not provide financial advice.
It does not guarantee continuation, reversal, targets, or profit.
⚠️ Limitations & Transparency
Breakout quality depends on market structure, volatility, liquidity, and timeframe.
Some breakouts may fail quickly.
Some slow breakouts may not trigger if candle quality or volume is too weak.
R levels are planning references, not guaranteed destinations.
🧠 Market Context Notes
Breakouts are often strongest when structure, participation, and follow-through align.
A breakout with clean target room and controlled pullback risk is different from a late breakout already pressing into extension.
Use the ladder as context, not certainty.
🧾 Use Case Examples
When price breaks above a recent base, the script locks the breakout edge and projects 1R / 2R / 3R references.
If price later pulls back into the shelf, the script marks pullback risk so the user can evaluate whether the structure remains intact.
If price reaches a target rail, target defense labels help identify where the move may need confirmation.
🧱 System Philosophy
AGPro Series tools are built as decision-support engines.
The purpose is to organize market behavior into structure, score, state, and risk context rather than providing blind buy or sell calls.
🔐 Non-Promise Statement
No breakout is certain.
No target rail is guaranteed.
No script can remove risk.
📉 Risk Disclosure
Trading involves risk.
Users are responsible for their own analysis, decisions, risk management, and execution.
This script is for educational and analytical purposes only and does not provide financial advice.
📚 Educational Note
Use this tool to study how breakout bases, retests, invalidation, current R, and target room interact across different markets and timeframes.
Indicator
Supply Demand Flip Planner [AGPro Series]Supply Demand Flip Planner
🧠 Core Idea
Has an old supply or demand zone changed role and started acting as the opposite side of the market?
📌 Overview / What it does
Supply Demand Flip Planner is a role-change price action tool designed to identify when a prior supply zone turns into demand, or when a prior demand zone turns into supply.
The script detects pivot-based supply and demand zones, monitors breaks through those zones, maps the active flip zone, evaluates retest acceptance, and displays a structured 0-100 score. It also shows invalidation shelves, target rails, centered zone text, labels, and a compact AG Pro dashboard.
It does not predict future price movement, automate trades, or provide guaranteed buy/sell signals. It is a visual decision-support framework for reading supply-demand flip behavior.
🎯 Purpose & Design Philosophy
This script was built for traders who watch support/resistance role reversal but want a cleaner way to separate meaningful flips from ordinary breaks.
Many zones break and never matter again. Some zones break, retest, and start acting as the opposite side of the market. This planner focuses on that role-change moment.
The design supports a structured workflow: map supply and demand, wait for break, monitor retest, evaluate acceptance, then track invalidation.
⚡ Why This Script Is Different
Most supply and demand tools draw zones and leave interpretation fully manual.
This script does NOT simply flood the chart with historical zones.
Instead, it focuses on the active role-change zone, measures retest quality, scores acceptance, and presents the result through a clear READY / MONITOR / WAIT / INVALIDATED framework.
⚙️ Methodology
1. Context Detection
The script detects pivot-based supply and demand zones using configurable left/right pivot confirmation.
2. Reference Mapping
It maps source supply and demand shelves, then converts a broken zone into an active flip zone.
3. Reaction Evaluation
When price retests the flip zone, the script evaluates break strength, retest depth, wick response, body quality, source-zone quality, freshness, and relative volume.
4. Visual Output
The active flip zone is shown with centered text, invalidation shelf, target rails, right-side tags, labels, and an AG Pro panel.
🗺️ How to Read the Chart
Supply zones represent pivot-based resistance shelves.
Demand zones represent pivot-based support shelves.
Demand Flip means old supply has been broken and is being evaluated as new demand.
Supply Flip means old demand has been broken and is being evaluated as new supply.
READY FLIP labels mark retests that pass the selected acceptance score.
Invalidation shelf marks where the flip context weakens or fails.
The AG Pro panel summarizes Flip State, Acceptance, Retest, Failure Risk, and Action.
🚦 Signals & States
• DEMAND → pivot-based demand zone mapped.
• SUPPLY → pivot-based supply zone mapped.
• DEMAND FLIP → old supply was broken and is being watched as new demand.
• SUPPLY FLIP → old demand was broken and is being watched as new supply.
• FLIP RETEST → price is interacting with the active flip zone.
• READY FLIP → retest acceptance reached the required score threshold.
• INVALIDATED → the active flip lost its invalidation edge.
• READY → qualified flip acceptance is active.
• MONITOR → the flip zone is active or retesting.
• WAIT → no qualified flip acceptance is active.
🔔 Alerts Logic
Demand Flip Locked triggers when price breaks above a prior supply zone.
Supply Flip Locked triggers when price breaks below a prior demand zone.
Demand Flip Acceptance Ready triggers when a bullish flip retest reaches the score threshold.
Supply Flip Acceptance Ready triggers when a bearish flip retest reaches the score threshold.
Supply Demand Flip Retest triggers when price interacts with the active flip zone.
Supply Demand Flip Invalidated triggers when the flip loses its invalidation shelf.
Alerts are attention markers, not trade instructions.
🧩 Confluence Logic
The strongest flip contexts appear when break strength, retest depth, wick response, close quality, source-zone quality, freshness, and relative volume align.
When a broken zone is retested cleanly and accepted from the opposite side, the score improves and the panel shifts toward a stronger action state.
📊 When to Use
• Support/resistance role reversal
• Breakout retests
• Trend continuation after zone breaks
• Failed range boundaries that become new reaction zones
• Markets with clear swing structure
⚠️ When NOT to Use
• Extremely noisy markets with weak pivot structure
• Very low liquidity symbols
• Markets with large spread or unreliable candles
• News spikes where zones break and fail too quickly
• Timeframes where pivot zones are too dense or too sparse
🎛️ Key Inputs
• Pivot Left / Right Bars → control how strict the source zone detection is.
• Zone Depth ATR → controls the thickness of supply and demand shelves.
• Break Buffer ATR → requires price to break beyond the source zone by a volatility-adjusted amount.
• Retest Window Bars → controls how long the flip remains relevant.
• Acceptance Buffer ATR → defines how much confirmation is required after retest.
• Invalidation Buffer ATR → controls the failure shelf beyond the flip zone.
• Minimum Ready Score → sets how strict READY labels should be.
• Visual Settings → control zones, labels, centered zone text, target rails, and right-side tags.
• Panel Settings → control panel visibility, location, theme, and font size.
🖥️ Interface & Visual Design
The interface is designed to make role-change structure readable without overwhelming the chart.
The active flip zone uses centered text so the purpose of the zone is immediately visible. Source zones are subtle, while READY labels and target rails stand out only when a valid acceptance context appears.
The panel gives a quick summary of the current flip state and risk context.
🧪 Practical Usage Workflow
1. Identify the latest supply and demand zones.
2. Wait for a zone to break and become a flip candidate.
3. Watch for retest interaction inside the flip zone.
4. Check the READY FLIP label and acceptance score.
5. Compare price with invalidation shelf and target rails.
6. Confirm broader trend, volatility, and liquidity before making decisions.
🔍 Interpretation Guidelines
A high acceptance score means the role-change reaction is cleaner according to the script's rules.
A pending retest means price has returned to the zone but has not yet shown enough acceptance.
A failed flip means price lost the invalidation edge and the role-change context should be treated as weakened.
🚫 What This Script Is NOT
This script is not a prediction engine.
It is not financial advice.
It is not an automated trading system.
It does not guarantee entries, exits, profits, or outcomes.
⚠️ Limitations & Transparency
Pivot-based zones are confirmed after the selected right-side bars, so source zones appear after confirmation.
Different timeframes can create very different supply and demand structures.
High volatility can cause quick break-and-fail behavior around zones.
No rule-based script can fully account for news, liquidity shocks, or sudden market structure changes.
🧠 Market Context Notes
Supply-demand flips are a form of role reversal.
Old resistance can become new support after acceptance. Old support can become new resistance after acceptance.
The script is strongest when used with broader market structure, trend context, liquidity, and volatility analysis.
🧾 Use Case Examples
When price breaks above a supply zone, returns to the zone, and holds above it with clean reaction quality, the script may mark a Demand Flip acceptance.
When price breaks below a demand zone, retests it from below, and rejects cleanly, the script may mark a Supply Flip acceptance.
🧱 System Philosophy
Supply Demand Flip Planner follows the AG Pro Series approach: transform a common market concept into a structured decision map with context, score, risk reference, and clean visuals.
The goal is not to replace judgment. The goal is to make role-change analysis easier to read.
🔐 Non-Promise Statement
No script can provide certainty.
No signal should be treated as guaranteed.
Outputs should always be interpreted with independent analysis and responsible risk control.
📉 Risk Disclosure
Trading involves risk.
Market conditions can change quickly.
Users are responsible for their own decisions, risk management, and trade execution.
This script is for educational and analytical purposes only and does not provide financial advice.
📚 Educational Note
This script is designed to help traders study how supply zones, demand zones, breakout retests, and role-change acceptance behave across different market conditions.
Indicator
Donchian Retest Readiness [AGPro Series]# Donchian Retest Readiness
🧠 Core Idea
After price breaks a Donchian Channel boundary, is the broken edge ready to act as a clean retest and continuation reference?
📌 Overview / What it does
Donchian Retest Readiness is a breakout-boundary decision-support script built around Donchian Channels.
The script maps the rolling Donchian high, low, and midpoint, detects channel breaks, builds a retest pocket around the broken edge, scores retest quality from 0 to 100, and projects continuation lanes with target rails.
It does not predict price direction, automate trades, or provide guaranteed signals. It organizes Donchian break context, retest quality, channel edge, risk, and action state into a clean visual workflow.
🎯 Purpose & Design Philosophy
Many breakout tools mark the moment price leaves a range, but the difficult part often comes after the break: deciding whether the broken edge is being respected.
This script was built for traders who want to evaluate Donchian breakout retests without treating every new high or new low as a complete trading idea.
The design supports structured observation: break first, retest pocket second, hold quality third.
⚡ Why This Script Is Different
Most Donchian tools focus on channel highs and lows.
This script does NOT stop at drawing the Donchian Channel.
Instead, it converts the broken channel edge into a decision zone, evaluates whether price returns to that area, measures hold quality, and summarizes readiness with a clear 0-100 score.
⚙️ Methodology
1. Donchian Channel Mapping
2. Breakout Boundary Detection
3. Retest Pocket Construction
4. Hold / Failure Evaluation
5. 0-100 Retest Readiness Score
6. Panel And Alert Output
🗺️ How to Read the Chart
The Donchian Channel shows the rolling high, low, and midpoint.
The retest pocket appears around the broken channel edge after a breakout.
READY RETEST labels appear when price interacts with the broken edge and holds with enough quality.
Continuation lanes and target rails show the projected area beyond the accepted retest context.
The panel summarizes Break State, Retest Score, Channel Edge, Risk, and Action.
🚦 Signals & States
• READY → A qualified Donchian retest has formed.
• MONITOR → A Donchian break is active and retest behavior is being evaluated.
• WAIT → The channel is valid, but no active break / retest context is present.
• INVALIDATED → Price failed back through the broken channel edge.
• BLOCKED → The Donchian channel is not suitable for evaluation under current settings.
🔔 Alerts Logic
Bullish Donchian Retest Ready triggers when price breaks above the Donchian high, returns to the broken edge, and holds with enough score quality.
Bearish Donchian Retest Ready triggers when price breaks below the Donchian low, returns to the broken edge, and holds with enough score quality.
Donchian Break Watch alerts mark the first boundary break when enabled.
Donchian Retest Invalidated triggers when price fails back through the broken edge.
Alerts are attention markers, not trade instructions.
🧩 Confluence Logic
The retest score combines wick response, close pressure beyond the broken edge, proximity to the retest pocket, breakout impulse, relative volume, and channel width quality.
When several of these conditions align, the retest context becomes stronger.
📊 When to Use
• Breakout markets
• Trend continuation setups
• Pullbacks after new highs or new lows
• Donchian Channel structure analysis
• Intraday or swing contexts where retest behavior matters
⚠️ When NOT to Use
• Very low-liquidity symbols
• Extremely noisy chop
• Abnormal spread conditions
• News spikes where retest behavior is unstable
• Markets where every boundary break immediately reverses
🎛️ Key Inputs
• Donchian Length → controls the rolling channel high and low.
• ATR Length → controls retest pocket depth, buffers, targets, and label spacing.
• Minimum Channel Width → blocks weak channels that are too narrow.
• Retest Pocket ATR → controls how wide the broken-edge retest pocket is.
• Minimum Ready Score → controls how selective READY states are.
• Projection Bars → controls how far pockets and targets extend.
• Visual settings → control channel, fill, pocket, lane, labels, tags, and panel.
🖥️ Interface & Visual Design
The script uses a clean AG Pro panel to summarize the current Donchian context.
The visual hierarchy is designed to keep the channel visible while making the active retest pocket and READY label easy to see.
Default settings keep failed and early watch labels off so publication screenshots remain clean.
🧪 Practical Usage Workflow
1. Read the panel state.
2. Check the Donchian channel boundary.
3. Wait for a break and retest pocket.
4. Evaluate whether price holds the broken edge.
5. Review target rails and failure risk.
🔍 Interpretation Guidelines
A READY retest means the broken Donchian edge is being respected according to the script rules.
It does not mean price must continue.
An invalidated retest means price failed back through the broken edge and the breakout context lost quality.
🚫 What This Script Is NOT
This script is not a prediction engine.
It is not a buy or sell signal generator.
It is not an automated trading system.
It does not guarantee breakouts, continuation, or reversals.
⚠️ Limitations & Transparency
Donchian behavior can vary by symbol, timeframe, volatility, and liquidity.
Shorter timeframes may produce more noise.
Longer Donchian lengths may react more slowly.
The script should be interpreted within broader structure, market regime, and risk context.
🧠 Market Context Notes
Donchian edges often become meaningful when market participants react to new highs, new lows, and breakout continuation attempts.
The strongest contexts usually combine a clean boundary break, controlled retest, and enough continuation room.
🧾 Use Case Examples
When price breaks above the Donchian high and later retests the broken edge without closing back through it, the script may mark a bullish READY RETEST.
When price breaks below the Donchian low and retests the edge from below with enough quality, the script may mark a bearish READY RETEST.
When price breaks out and then closes back through the broken edge, the retest can become invalidated.
🧱 System Philosophy
This script follows the AGPro Series approach: structured context, practical scoring, clean visuals, and decision-support states instead of noisy prediction claims.
🔐 Non-Promise Statement
No script can provide certainty.
No output should be treated as guaranteed.
All states are rule-based analytical markers.
📉 Risk Disclosure
Trading involves risk.
Users are responsible for their own decisions, risk management, and position sizing.
This script is for educational and analytical purposes only and does not provide financial advice.
📚 Educational Note
The purpose of this script is to help users study Donchian Channel breakout and retest behavior through a structured visual framework.
Indicator
Weekly Range Break Planner [AGPro Series]# Weekly Range Break Planner
🧠 Core Idea
Is the weekly range break strong enough to monitor, or is price likely to fail back inside the range?
📌 Overview / What it does
Weekly Range Break Planner is a weekly range decision-support script built to evaluate whether price is breaking beyond the previous week's high or low with enough structural quality.
The script maps the previous weekly high, low, and midpoint, detects bullish or bearish breaks, builds a retest shelf around the broken boundary, scores the break from 0 to 100, and summarizes the current state inside a compact AG Pro panel.
It does not predict price direction, automate trades, or provide guaranteed signals. It is designed to organize weekly range context, break quality, retest behavior, target room, and invalidation risk into a clean visual workflow.
🎯 Purpose & Design Philosophy
Weekly highs and weekly lows are widely watched reference points, but not every break beyond them is meaningful.
This script was built for traders who want to separate a clean weekly range break from a weak expansion, failed breakout, or noisy return back into the prior range.
The design supports structured observation: range first, break quality second, retest behavior third, and action state last.
⚡ Why This Script Is Different
Most tools mark weekly highs and lows or show simple breakout signals.
This script does NOT stop at drawing weekly levels.
Instead, it evaluates what happens after price breaks the range: whether the break has enough close quality, whether the retest shelf is respected, whether target room remains, and whether the context is still valid.
⚙️ Methodology
1. Previous Weekly Range Mapping
2. Break Boundary Detection
3. Retest Shelf Construction
4. Break Quality Scoring
5. Target Room Evaluation
6. Invalidation And Expiration Handling
7. Panel And Alert Output
🗺️ How to Read the Chart
The weekly range box marks the previous week's high-low structure.
The high and low rails show the main break boundaries.
The midpoint line helps users understand where price is relative to the prior weekly balance.
The retest shelf appears around the broken boundary after a weekly range break.
READY BREAK labels appear when the break context meets the required score threshold.
Target rails show projected continuation references after a qualified break.
The panel summarizes Range State, Break Score, Retest, Room, and Action.
🚦 Signals & States
• READY → A qualified weekly range break has formed.
• MONITOR → Price has broken a weekly boundary and the script is evaluating quality.
• WAIT → The previous weekly range is valid, but no active break context is present.
• INVALIDATED → Price failed back inside the weekly range after a break.
• EXPIRED → The break window closed without a qualified context.
• BLOCKED → The previous weekly range is not suitable for evaluation.
🔔 Alerts Logic
Bullish Weekly Range Break Ready triggers when price breaks above the previous weekly high with enough quality.
Bearish Weekly Range Break Ready triggers when price breaks below the previous weekly low with enough quality.
Weekly Range Break Invalidated triggers when price fails back inside the prior weekly range after a break.
Weekly Range Break Expired triggers when the evaluation window closes without a qualified break state.
Alerts are attention markers, not trade instructions.
🧩 Confluence Logic
The break score combines weekly range fit, close distance beyond the boundary, retest shelf behavior, time quality, relative volume, and available target room.
When these elements align, the context becomes stronger.
When they do not align, the script remains in WAIT, MONITOR, INVALIDATED, EXPIRED, or BLOCKED state.
📊 When to Use
• Weekly high and weekly low break analysis
• Breakout-retest workflows
• Intraday monitoring around prior weekly extremes
• Swing context planning
• Trend continuation after a range expansion
⚠️ When NOT to Use
Avoid relying on this script in extremely low-liquidity markets, very noisy symbols, holiday sessions, or conditions where the previous weekly range is not meaningful.
It should not be used as a standalone decision tool without broader market context, risk planning, and independent confirmation.
🎛️ Key Inputs
• Minimum Weekly Range filters weak or compressed prior weekly ranges.
• Break Buffer ATR controls how far price must close beyond the weekly boundary.
• Retest Shelf ATR controls the depth of the shelf around the broken boundary.
• Invalidation Buffer ATR controls how far price must close back inside the range before invalidation.
• Minimum Ready Score controls how strong the score must be before READY appears.
• Target inputs define continuation reference rails from the broken boundary.
• Visual settings control boxes, rails, labels, right-side tags, panel location, and font size.
🖥️ Interface & Visual Design
The interface is designed to make the weekly range context readable at a glance.
The chart shows the prior weekly range, the active break boundary, the retest shelf, and target-room references without turning the screen into a generic breakout overlay.
The AG Pro panel gives compact decision context while preserving chart visibility.
🧪 Practical Usage Workflow
1. Check whether the previous weekly range is valid.
2. Watch for a close beyond the weekly high or low.
3. Observe the retest shelf around the broken boundary.
4. Read the break score, retest state, and room value.
5. Treat READY as an attention state and confirm with broader market context.
🔍 Interpretation Guidelines
A higher break score means the weekly range break is cleaner according to the script logic.
A clean retest shelf response can strengthen the context.
Low remaining room means the move may already be extended relative to the projected target.
READY means the context deserves attention, not that price must continue.
🚫 What This Script Is NOT
This script is not a prediction engine.
It is not financial advice.
It is not an auto-trading system.
It does not provide guaranteed signals.
It does not replace risk management or independent analysis.
⚠️ Limitations & Transparency
Weekly range behavior changes across markets, timeframes, volatility regimes, and liquidity conditions.
The score is rule-based and depends on current chart timeframe, ATR normalization, volume behavior, and the previous weekly range.
Different symbols may require different sensitivity settings.
🧠 Market Context Notes
Weekly range breaks can be more meaningful when aligned with trend, liquidity response, volume participation, and clean retest behavior.
Breaks that quickly return inside the prior weekly range often need extra caution.
🔐 Non-Promise Statement
No script can guarantee future price behavior.
This tool provides structured visual context only.
📉 Risk Disclosure
Trading involves risk.
Users remain responsible for their own decisions.
This script is for educational and analytical purposes only and does not provide financial advice or guaranteed trading outcomes.
Indicator
Opening Range Retest Planner [AGPro Series]# Opening Range Retest Planner
## Core Idea
Did the opening range breakout return to its boundary and hold with enough quality to deserve attention?
## Overview / What It Does
Opening Range Retest Planner is an intraday opening range decision-support script built for traders who want to evaluate the quality of the first meaningful retest after an opening range breakout.
The script builds the opening range, tracks the first bullish or bearish breakout, maps a focused retest pocket around the broken boundary, grades the retest from 0 to 100, and displays a clear action state in a compact AG Pro panel.
It does not predict price direction, automate execution, or provide guaranteed outcomes. Its purpose is to organize structure, acceptance, invalidation, and retest quality in a clean visual workflow.
## Purpose & Design Philosophy
Many opening range tools focus only on the initial break. In practice, the first retest after the break is often where the structure becomes more meaningful.
This script was built for traders who want to separate a clean retest hold from a weak pullback, failed breakout, or expired setup. The design supports structured observation instead of impulsive reaction.
## Why This Script Is Different
Most opening range tools stop at the range or breakout itself.
This script does not stop there.
Instead, it focuses on what happens after the break: whether price returns to the broken boundary, respects it, fails back inside the range, or runs out of time before a qualified retest appears.
## Methodology
1. Opening Range Mapping
2. Breakout Detection
3. Retest Pocket Construction
4. Retest Quality Scoring
5. Acceptance, Invalidation, or Expiration State
6. Panel and Alert Output
## How To Read The Chart
The opening range remains the main session reference.
The retest pocket marks the area where the script evaluates whether the broken boundary is being respected or rejected.
Labels highlight qualified retests, invalidations, and key state changes.
Target rails project possible continuation space after a qualified retest.
The panel summarizes OR state, retest score, acceptance side, failure risk, and current action.
## Signals & States
READY -> A retest touched the pocket, held the broken boundary, and met the minimum quality threshold.
MONITOR -> A breakout occurred and the script is tracking whether a qualified retest develops.
WAIT -> The opening range is still building, has just locked, or is waiting for a valid post-break condition.
INVALIDATED -> Price failed back inside the opening range after the breakout.
EXPIRED -> The retest window closed without a qualified retest.
BLOCKED -> The opening range is not valid enough to evaluate.
## Alerts Logic
Bullish Opening Range Retest Ready triggers when a bullish breakout retest holds the broken range high with enough score.
Bearish Opening Range Retest Ready triggers when a bearish breakout retest holds the broken range low with enough score.
Opening Range Retest Invalidated triggers when price fails back inside the opening range after a breakout.
Opening Range Retest Expired triggers when the retest window expires without a qualified hold.
Alerts are attention markers, not trade instructions.
## Confluence Logic
The retest score combines pocket touch quality, close response, retest timing, relative volume, opening range volatility fit, and available target room.
When these conditions align, the context becomes stronger. When they do not align, the panel remains in MONITOR, WAIT, INVALIDATED, or EXPIRED state.
## When To Use
This script is most useful in liquid intraday markets where the opening range matters and session structure is clear.
It fits breakout-retest workflows, opening drive continuation, failed breakout monitoring, and structured intraday planning.
## When NOT To Use
Avoid relying on this script in very low-liquidity symbols, extremely noisy sessions, holiday trading, or chart conditions where the opening range session cannot be represented cleanly.
## Key Inputs
Opening Range Mode controls whether the script uses an exact session window or the first chart bars of each day.
Auto mode uses session-window logic on lower intraday charts and switches to first-bars-of-day logic on higher timeframes.
Retest Pocket ATR controls the depth of the retest zone around the broken boundary.
Minimum Ready Score controls how strong the 0-100 retest score must be before READY appears.
Panel and label controls let users adjust position, theme, and visual density.
## Interface & Visual Design
The visual design is chart-first.
The opening range stays readable, the active retest pocket becomes the focus area, and the panel provides compact decision context without covering the whole chart.
The first panel row uses the AG Pro blue header style and shows only the script name.
## Practical Usage Workflow
1. Wait for the opening range to lock.
2. Watch for a breakout beyond the range boundary.
3. Observe whether price returns to the retest pocket.
4. Check the retest score and action state.
5. Treat alerts as attention markers and confirm context with your broader process.
## What This Script Is NOT
This script is not a prediction engine.
It is not financial advice.
It is not an auto-trading system.
It does not guarantee outcomes.
It does not replace independent risk management or market context.
## Limitations & Transparency
Opening range behavior changes across markets, sessions, liquidity conditions, and timeframes.
The score is rule-based and depends on the configured session, ATR normalization, volume behavior, and retest window.
Different chart timeframes may display session structure differently.
## Risk Disclosure
Trading involves risk.
Users remain responsible for their own decisions.
This script is for educational and analytical purposes only and does not provide financial advice or guaranteed trading outcomes.
Indicator
Trendline Retest Planner [AGPro Series]Trendline Retest Planner
🧠 Core Idea
Is the active trendline retest constructive enough to keep the setup under review, or is it starting to fail?
📌 Overview / What it does
Trendline Retest Planner is a chart-first decision tool for traders who review price behavior around active support and resistance trendline retests.
Instead of drawing many trendlines or flagging every break, the script focuses on one active trendline retest context at a time. It measures line age, touch count, retest depth, close response, and volume support, then converts that evidence into a 0-100 Retest Score and a clear next-action state.
The script produces an active trendline, retest pocket, hold/fail labels, invalidation edge, target path, alerts, and a compact AGPro planning panel. It does not predict price movement, automate execution, or provide guaranteed outcomes.
🎯 Purpose & Design Philosophy
This script was built to fill the gap between auto-trendline drawing and practical retest planning.
Many tools can draw diagonals or detect a break. The harder question is what to do after price returns to the line: is the retest holding, weakening, failing, or still waiting for confirmation?
Trendline Retest Planner supports a decision workflow: identify the active retest, read the score, locate the invalidation edge, compare the target path, and decide what deserves review next.
⚡ Why This Script Is Different
Most trendline tools focus on drawing many lines, ranking confluence, or detecting trendline breaks.
This script does NOT clone Auto Trendline Break Quality, Auto Trendlines MTF - Break/Retest, Trendline Confluence Map, Break-Retest Quality, Structure Retest Planner, Swing Retest Quality, or a generic support/resistance zone map.
Instead, it narrows the workflow to one active support or resistance trendline retest and evaluates whether that retest is constructive or failing. The main output is not a buy or sell signal. It is a decision state: READY, MONITOR, FAILING, INVALIDATED, WATCH, WAIT, or SCAN.
⚙️ Methodology
1. Context Detection
The script builds the latest support and resistance trendline candidates from confirmed swing pivots, then selects the nearest valid retest context.
2. Reference Mapping
It maps the active trendline, a retest pocket around the line, an invalidation edge, and a forward target path.
3. Reaction Evaluation
The 0-100 model scores line age, touch count, retest depth, close response, and volume support.
4. Visual Output
The chart shows the active planning objects, compact state labels, and a clean AGPro decision panel.
🗺️ How to Read the Chart
Trendline = the active support or resistance line being evaluated.
Retest Pocket = the ATR-based area around the trendline where a retest is considered active.
Invalidation Edge = the planning reference where the active retest context is considered broken.
Target Path = a forward guide based on the trendline-to-risk distance.
Labels = compact TEST, READY, MONITOR, WEAK, INVALID, PATH, and sparse context labels.
Colors = teal marks support-side retest context, pink marks resistance-side retest context, amber marks caution, indigo marks monitoring/follow-through, and red marks invalidation.
Panel = the AGPro panel summarizes Trendline Side, Retest Score, Hold State, Risk Edge, and Action.
🚦 Signals & States
• READY → the retest is active, holding on the correct side, and the score is strong enough for structured review.
• MONITOR → the retest is developing, but confirmation or score quality is still incomplete.
• FAILING → price touched the pocket, but the response is weak or on the wrong side.
• INVALIDATED → price crossed the invalidation edge and the active context should be rebuilt.
• WATCH → price is approaching the trendline pocket.
• WAIT → a valid trendline exists, but price is not close enough for useful retest review.
• SCAN → no valid trendline context is active yet.
🔔 Alerts Logic
Alerts trigger when price touches the active retest pocket, when READY state appears, when MONITOR state appears, when a failing retest is detected, when the invalidation edge is crossed, and when follow-through appears after an active retest.
Alerts are attention markers only. They are not trade instructions, automated strategy commands, or outcome promises.
🧩 Confluence Logic
The strongest context appears when the active line is fresh enough, has enough touches, retests with controlled depth, closes back on the correct side, and receives supportive relative volume.
When these components conflict, the panel moves toward MONITOR, FAILING, WATCH, WAIT, or INVALIDATED.
📊 When to Use
• Trendline support retests during constructive pullbacks
• Trendline resistance retests during bearish continuation attempts
• Price-action review after a diagonal support or resistance line is already visible
• Retest planning where invalidation and target path matter
• Liquid markets where pivots, candles, and volume behavior are readable
⚠️ When NOT to Use
• Very low-liquidity symbols with irregular candles
• Extremely noisy micro-timeframes
• News-driven spikes where trendline geometry becomes distorted
• Markets where swing pivots are too compressed to form useful lines
• Situations where the user expects a signal-only or auto-trading tool
🎛️ Key Inputs
• Trendline Side → selects Auto, Support Retest, or Resistance Retest.
• Trendline Pivot Length → controls how confirmed swing anchors are detected.
• Max Trendline Age → controls how old a trendline can be before it is ignored.
• Touch Count Lookback → controls how extra line touches are counted.
• Sensitivity → adjusts retest pocket width and activation distance.
• READY Score → sets the score threshold for stronger review states.
• Label and Panel Font Size → controls chart-label and panel readability.
• Panel Location and Theme → adjusts the AGPro panel layout.
🖥️ Interface & Visual Design
The interface is designed to stay chart-first and decision-led.
The active trendline is the main reference. The retest pocket is drawn around that line with centered text so the chart stays readable. The invalidation edge and target path explain where the planning context weakens and what forward room is being mapped.
The AGPro panel uses a merged blue title row and five compact rows so the user can read side, score, hold state, risk edge, and action quickly.
🧪 Practical Usage Workflow
1. Read the panel state and Retest Score.
2. Check whether price is approaching or touching the retest pocket.
3. Compare current price with the invalidation edge.
4. Review whether the label says TEST, READY, MONITOR, WEAK, INVALID, or PATH.
5. Confirm the broader market context before making any decision.
🔍 Interpretation Guidelines
Think in terms of retest quality, not prediction.
A higher score means multiple retest components align inside the script's rule set. A weaker score means the line may be too old, the retest may be too shallow, too deep, missing a constructive close, or lacking participation.
The script helps organize the review process. It does not replace judgment.
🚫 What This Script Is NOT
• Not a prediction engine
• Not financial advice
• Not an auto-trading system
• Not a guaranteed signal tool
• Not a broad auto-trendline map
• Not a trendline confluence scanner
• Not a break-and-retest scanner
• Not a generic support/resistance zone map
• Not an order block, FVG, or supply/demand tool
⚠️ Limitations & Transparency
• Pivot-based trendlines appear only after pivots are confirmed.
• Scores can vary across symbols, sessions, and timeframes.
• Volume scoring depends on exchange-provided volume data.
• Fast volatility can cross a trendline before a clean retest can be measured.
• In Live Updating mode, active-bar values can change before the bar closes.
🧠 Market Context Notes
Trendline retests are easiest to interpret when liquidity, volatility, and swing structure are readable.
A trendline touch is not enough by itself. Line quality, response, invalidation distance, and target path all matter.
🧾 Use Case Examples
When price returns to an upward support trendline and closes back above the pocket with a high score, the panel may move toward READY.
When price touches a downward resistance trendline but cannot close back below it, the planner may move toward FAILING or INVALIDATED.
When price is near the line but has not touched the pocket yet, the panel can stay in WATCH or WAIT.
🧱 System Philosophy
Trendline Retest Planner follows the AGPro decision-engine approach: identify context, score quality, map risk, show the next action, and keep the chart readable.
It is designed to help traders evaluate a specific planning question instead of adding another generic signal layer.
🔐 Non-Promise Statement
No score, label, alert, or chart object guarantees any market outcome.
The script organizes retest context and highlights conditions for review. It does not provide certainty.
📉 Risk Disclosure
Trading involves risk.
Users remain responsible for their own decisions, position sizing, execution, and risk management.
This script is for educational and analytical purposes only and does not provide financial advice.
📚 Educational Note
Use the planner as a structured reading layer: trendline context first, retest quality second, invalidation and target path third, broader market context always.
Indicator
Breakout Follow-Through Planner [AGPro Series]Breakout Follow-Through Planner
🧠 Core Idea
Did the breakout receive enough follow-through to stay valid?
📌 Overview / What it does
Breakout Follow-Through Planner is a chart-first breakout planning tool designed to evaluate what happens after price clears a recent structure edge.
Instead of treating the breakout candle as the full story, the script maps the broken level, creates a follow-through corridor, tracks post-break travel, measures close progress, monitors retest-depth risk, and converts the full sequence into a 0-100 Follow-Through Score.
The script produces a breakout line, follow-through corridor, weak-continuation labels, failure rail, target-room guide, alerts, and a clean AGPro decision panel. It does not predict price, automate trades, or issue entry/exit commands.
🎯 Purpose & Design Philosophy
This script was built for traders who already understand that a breakout is only the first event.
The practical question comes after the break: does price travel away from the level, hold enough distance, and preserve clean room, or does it stall and begin to retest too deeply? This planner turns that post-break phase into a readable decision process.
The design supports a planning mindset: identify the breakout, review follow-through quality, respect the failure rail, measure target room, and decide whether the active context still deserves attention.
⚡ Why This Script Is Different
Most breakout tools focus on the moment price crosses a level.
This script does NOT clone Breakout Volume Quality, Breakout Retest Readiness, Acceptance Breakout Planner, Volume Expansion Breakout Planner, or a generic support/resistance breakout scanner.
Instead, it focuses on post-break travel quality. The key question is not simply "did price break?" or "was volume high?" or "did the retest hold?" The key question is whether the breakout received enough follow-through after the break to remain structurally valid.
⚙️ Methodology
1. Context Detection
The script builds recent upper and lower breakout references from a configurable prior structure window.
2. Reference Mapping
When price closes beyond a reference edge by an ATR-normalized buffer, the planner starts an active breakout follow-through plan.
3. Reaction Evaluation
The model evaluates break candle quality, volume support, follow-through travel, number of closes beyond the breakout close, retest-depth risk, target room, and failure rail behavior.
4. Visual Output
The chart shows the breakout line, active follow-through corridor, failure rail, target-room guide, compact labels, and an AGPro panel summarizing the current decision state.
🗺️ How to Read the Chart
Follow-Through Corridor = the active path from the breakout close toward the target-room guide. Its text is centered inside the corridor.
Breakout Line = the structure edge that was cleared and now anchors the active plan.
Failure Rail = the invalidation reference behind the breakout line. It is an analytical guide, not a stop order.
Target Room = the projected planning guide based on the prior structure height.
Labels = compact markers such as BFT UP, BFT DN, FT READY, WEAK FT, RETEST RISK, FAIL RAIL, ROOM HIT, and TRACK.
Colors = teal supports constructive bullish follow-through, pink supports bearish follow-through, amber marks caution, indigo marks target-room review, and red marks failure rail pressure.
Panel = the main decision interface showing Breakout Side, Follow-Through, Retest Risk, Target Room, and Action.
🚦 Signals & States
• BFT UP → a bullish breakout started a follow-through review.
• BFT DN → a bearish breakout started a follow-through review.
• FT WATCH → follow-through evidence is developing but not complete.
• FT READY → travel, closes, score quality, and retest-depth conditions are constructive.
• WEAK FT → the follow-through window aged without enough progress.
• RETEST RISK → price moved too deeply back toward or through the breakout line.
• FAIL RAIL → price closed through the failure rail after the breakout plan.
• ROOM HIT → price reached the target-room guide and context should be reviewed.
🔔 Alerts Logic
Alerts can trigger when a bullish or bearish breakout plan starts, follow-through reaches the ready state, weak follow-through or retest risk appears, the failure rail is hit, or target-room review is reached.
These alerts are attention markers for chart review. They are not trade instructions, automated strategy rules, or guaranteed outcomes.
🧩 Confluence Logic
The strongest follow-through context usually appears when the breakout candle is clean, price travels away from the breakout close, multiple closes hold beyond the breakout close, retest depth remains controlled, volume support is present, and target room is still readable.
When these conditions weaken, the planner can shift toward FT WATCH, WEAK FT, RETEST RISK, FAILED, or TARGET REVIEW.
📊 When to Use
• Breakout continuation review
• Range exits where post-break travel matters
• Trend continuation attempts after structure breaks
• Breakouts that need a clear failure rail and target-room reference
• Chart review workflows where the trader wants a decision state instead of another raw breakout marker
⚠️ When NOT to Use
• Low-liquidity markets with unreliable candles or volume
• Extremely noisy ranges where every breakout immediately snaps back inside
• Abnormal news spikes where ATR and structure references may distort quickly
• Situations where the user needs full trade management, position sizing, or automation
🎛️ Key Inputs
• Structure Lookback → controls the recent high/low reference used for breakout detection.
• Break Buffer ATR → defines how far price must close beyond the reference edge.
• Minimum Break Quality → filters weaker breakout candles before the planner starts.
• Follow-Through Window → controls the early review period after the breakout.
• Required Travel ATR → defines the preferred post-break travel distance.
• Maximum Clean Retest Depth ATR → controls when retest depth becomes risk.
• Failure Rail ATR → sets the analytical invalidation rail behind the breakout line.
• Target Room Range Multiple → projects the target-room guide from prior structure height.
• Visual and Panel Settings → control corridor visibility, labels, panel location, theme, and font sizes.
🖥️ Interface & Visual Design
The interface is intentionally chart-first.
The follow-through corridor carries the main story, while the breakout line, failure rail, and target guide create a clean level-risk-room hierarchy. Labels are compact and controlled by cooldown and maximum-visible settings so the chart remains active without becoming crowded.
The AGPro panel uses a merged blue title row and a compact decision layout for fast review.
🧪 Practical Usage Workflow
1. Read the panel to identify the current breakout side and follow-through state.
2. Check the breakout line and follow-through corridor.
3. Review whether price is traveling away, stalling, retesting too deeply, or reaching target room.
4. Use the failure rail as a structural review reference.
5. Treat the Action row as a planning prompt, not as an instruction.
🔍 Interpretation Guidelines
The Follow-Through Score should be read as context quality, not certainty.
A higher score means the breakout has cleaner post-break travel under the script's rules. A lower score means the breakout may be stalling, losing distance, retesting too deeply, or lacking enough supporting evidence.
The target-room guide does not forecast price. It gives a structured reference for whether the current path still has room to review.
🚫 What This Script Is NOT
This script is not a prediction engine.
This script is not financial advice.
This script is not an auto-trading system.
This script does not provide guaranteed signals.
This script is not a generic support/resistance map.
This script is not a Breakout Volume Quality clone.
This script is not a Breakout Retest Readiness clone.
⚠️ Limitations & Transparency
The script is rule-based and depends on the selected lookback, ATR length, timeframe, and symbol behavior.
Different markets can produce different breakout behavior. Lower timeframes may show more noise. Higher timeframes may produce fewer but cleaner events.
Volatility changes can affect corridor size, failure rail distance, target-room projection, and event frequency. Outputs should be interpreted within broader market context.
🧠 Market Context Notes
Breakout follow-through is usually most useful when structure is readable, liquidity is sufficient, and the market has enough room to travel after the break.
Volume can support the score, but the script is not built around volume alone. The central decision layer is post-break price travel and structural validity.
🧾 Use Case Examples
When price breaks above recent structure and immediately travels away with multiple closes beyond the breakout close, the planner can move from FT WATCH toward FT READY.
When price breaks but returns deeply through the breakout line before enough travel appears, the planner can mark RETEST RISK or FAIL RAIL.
When price reaches the projected target-room guide, the planner shifts to ROOM HIT so the context can be reviewed instead of blindly extended.
🧱 System Philosophy
The script is built around the AGPro decision-engine approach: structure first, quality score second, risk and target context always visible, and no promise-based signals.
🔐 Non-Promise Statement
No script can provide certainty.
No output should be treated as a guarantee.
The tool organizes breakout follow-through context so users can review price action with more structure.
📉 Risk Disclosure
Trading involves risk.
Users are responsible for their own decisions.
This script does not provide financial advice.
📚 Educational Note
Use the planner to study how breakouts behave after the first break. The value is in comparing clean follow-through, weak continuation, deep retests, and failure-rail behavior across many examples.
Indicator
Moving Average Retest Planner [AGPro Series]Moving Average Retest Planner
🧠 Core Idea
Is a moving average retest clean enough to act as trend support or resistance, or is the reaction too weak to plan around?
📌 Overview / What it does
Moving Average Retest Planner is a chart-first planning tool built around one practical workflow: price moves away from an active moving average, returns into a controlled retest pocket, and the script evaluates whether that reaction has enough quality to deserve attention.
The script produces a moving average reference, a retest distance band, concept-native retest pockets, hold / watch / fail labels, invalidation rails, target rails, continuation markers, and a compact AGPro decision panel. It converts moving average slope, retest depth, wick response, close quality, relative volume, and target room into a normalized 0-100 Reaction Score.
It does not predict future price movement, automate trading, or claim that a moving average touch is automatically meaningful. Its role is to organize the current retest context into a clearer decision-support workflow.
🎯 Purpose & Design Philosophy
This script was built because many moving average tools stop at the most basic question: is price above or below the average?
That is rarely enough for real chart planning. A retest can be too early, too deep, too weak, or too close to nearby obstruction. The purpose of this script is to help traders evaluate whether the retest itself is clean, controlled, and supported by the surrounding structure.
The design supports traders who use moving averages as contextual references but want a more structured way to assess reaction quality, risk edge, and next action.
⚡ Why This Script Is Different
Most moving average tools focus on crossovers, ribbon direction, fixed EMA reclaim events, or simple above / below filters.
This script does NOT clone a 200 EMA reclaim map, a moving average ribbon stress model, a Hull MA zone tool, or a KAMA efficiency framework.
Instead, it focuses on one narrower decision layer: after price has moved away from an active configurable moving average, is the return into that average being defended or rejected with enough quality to become a valid planning area?
⚙️ Methodology
1. Context Detection
The script calculates the active moving average and checks whether the average has a meaningful slope. It separates bullish, bearish, and neutral contexts.
2. Reference Mapping
An ATR-normalized retest band is built around the active moving average. This band is used as the planning pocket rather than as a generic support / resistance zone.
3. Reaction Evaluation
When price returns into the band after moving away from it, the script evaluates slope quality, retest depth, wick response, close location, relative volume, and target room.
4. Visual Output
Qualified reactions can create retest pockets, hold / watch / fail labels, invalidation rails, target rails, continuation markers, alerts, and panel updates.
🗺️ How to Read the Chart
Zones = the active moving average retest pocket where price is being evaluated.
Labels = compact event markers for watch, hold, failure, and follow-through states.
Colors = bullish states use teal, bearish states use pink, neutral / waiting states use amber, and projected target context uses indigo.
Panel = summarizes MA Retest, Trend Side, Reaction Score, Risk Edge, and Action.
🚦 Signals & States
• WATCH → price is reacting near the moving average, but quality is below the READY threshold.
• READY → the retest score meets the required quality threshold.
• WAIT RETEST → trend context exists, but no clean retest is active yet.
• INVALIDATED → the active retest lost its invalidation edge.
• FOLLOW-THROUGH → price moved far enough from the trigger close to mark continuation after the retest.
• NO PLAN → the current chart does not contain a usable MA retest context.
🔔 Alerts Logic
Alerts can trigger when a READY retest appears, when an active retest invalidates, when follow-through is detected, or when the planner state changes.
These alerts are attention markers. They are not trade instructions, entry signals, or automated recommendations.
🧩 Confluence Logic
The strongest context appears when MA slope, controlled retest depth, clean wick response, strong close quality, relative volume support, and target room align at the same time.
When those components improve together, the Reaction Score rises. When the retest becomes too deep, too weak, or too close to obstruction, the score remains lower.
📊 When to Use
• Trending markets where price repeatedly returns to an active moving average
• Pullback continuation contexts
• Trend support or trend resistance evaluation
• Markets with enough liquidity for moving average reactions to be readable
• Multi-timeframe review where one average acts as a workflow reference
⚠️ When NOT to Use
• Very low-liquidity symbols
• Flat, noisy, low-range conditions
• Extreme news-driven volatility
• Charts where the selected moving average has no meaningful slope
• Situations where price is chopping through the average without clean reaction behavior
🎛️ Key Inputs
• MA Type and MA Length → define the active retest reference.
• Sensitivity → controls retest pocket width and required prior distance.
• Confirmation Mode → controls how strict the close-side hold must be.
• Minimum READY Score → sets the threshold for a high-quality retest state.
• Target R → defines the projected target rail from the invalidation edge.
• Label Cooldown and Max Visible Event Sets → manage label density and chart cleanliness.
• Panel Location, Panel Theme, Panel Font Size, and Label Font Size → control publication-ready presentation.
🖥️ Interface & Visual Design
The interface is built around a clean chart-first hierarchy.
The moving average and distance band show the active reference. Retest pockets highlight only qualified reaction areas. Labels sit above or below candles using ATR offsets so they remain readable. The panel gives the current planning answer without turning the script into a crowded dashboard.
🧪 Practical Usage Workflow
1. Read the panel to identify the current Action.
2. Check whether the moving average has a clear bullish or bearish trend side.
3. Look for a retest pocket and review the Reaction Score.
4. Compare the invalidation rail and target rail to judge the risk edge.
5. Treat alerts as prompts for review, not standalone decisions.
🔍 Interpretation Guidelines
The script should be read as a structured context model.
A high score means the detected retest has stronger alignment across the script's rules. A low score means the reaction is weaker, late, noisy, or poorly positioned. A failed retest means the active planning edge was lost according to the selected inputs.
The output is most useful when combined with broader structure, timeframe context, liquidity, and the trader's own risk process.
🚫 What This Script Is NOT
• Not a prediction engine
• Not financial advice
• Not an auto trading system
• Not a guaranteed signal tool
• Not a replacement for risk management
• Not a generic moving average crossover indicator
⚠️ Limitations & Transparency
Moving averages are lagging references. The selected length, asset, timeframe, volatility profile, and liquidity conditions can all affect how clean or noisy the retest behavior appears.
In strong trends, price may continue without giving a clean retest. In choppy markets, price may touch the average many times without creating meaningful structure. The score should be interpreted as a rule-based quality read, not certainty.
🧠 Market Context Notes
Moving average retests are most useful when the average represents an active path of value or trend behavior. The cleaner the slope and the more controlled the return into the average, the more useful the retest context usually becomes.
Liquidity, volatility, and nearby structural levels still matter. A strong-looking retest with poor target room may be less useful than a moderate retest with cleaner space.
🧾 Use Case Examples
When price trends above the selected average, pulls back into the retest band, rejects lower prices with a clear wick, closes back above the average, and has enough target room, the panel may move into READY.
When price returns to the average but closes weakly through the band or later crosses the invalidation rail, the retest can move into INVALIDATED.
🧱 System Philosophy
Moving Average Retest Planner follows the AGPro decision-engine approach: show the setup context, score its quality, define the risk edge, map the target area, and state the next action.
The goal is not to add another signal to the chart. The goal is to help traders read whether the current retest is organized enough to deserve attention.
🔐 Non-Promise Statement
No certainty.
No guaranteed continuation.
No guaranteed reversal.
No automated decision.
📉 Risk Disclosure
Trading involves risk. Market conditions can change quickly, and any indicator can produce false or incomplete readings.
This script is for educational and analytical purposes only. It does not provide financial advice, investment advice, or guaranteed trading outcomes.
Users are responsible for their own decisions, testing, position sizing, and risk management.
📚 Educational Note
Use this tool to study how price behaves when it returns to an active moving average. The most important output is not a label by itself, but the relationship between retest quality, invalidation, target room, and broader market context.
Indicator
Retest Defense Planner [AGPro Series]Retest Defense Planner
🧠 Core Idea
Is a retested level still being defended strongly enough to keep the planning context alive?
📌 Overview / What it does
Retest Defense Planner is a chart-first decision tool built for traders who review how price behaves after returning to an active defense shelf.
Instead of treating every level touch as meaningful, the script evaluates whether the shelf is actually being protected. It measures retest depth, wick defense, close response, time at level, volume support, target room, and risk-edge distance, then converts that evidence into a 0-100 Retest Score and a clear next-action state.
The default view is tuned for clear 4H-style retest review, where shelf defense, reaction quality, and short-term follow-through are usually easier to read than on very compressed timeframes. The script still works across timeframes, but users should adjust shelf age, projection bars, and sensitivity when changing market rhythm.
The script produces a defense zone, active defense rail, risk edge, target-room guide, follow-through guide, compact chart labels, alerts, and a clean AGPro planning panel. It does not predict price movement, automate execution, or provide guaranteed outcomes.
🎯 Purpose & Design Philosophy
This script was built to fill the gap between simple level plotting and full structure scanners.
Many traders can identify that price has returned to a level, but the harder question is whether the level is still being defended cleanly enough to deserve attention. Retest Defense Planner focuses on that decision layer.
The design supports a planning mindset: read the defense state, check the score, locate the risk edge, compare target room, and decide what deserves review next.
⚡ Why This Script Is Different
Most retest tools focus on structure breaks, swing-leg pullbacks, support/resistance maps, or broad breakout retest signals.
This script does NOT clone Structure Retest Planner, Swing Retest Quality, Breakout Retest Readiness, Break-Retest Quality, Breaker Block Engine, or a generic S/R zone map.
Instead, it evaluates one active defense shelf and asks whether the shelf is surviving the retest. The main output is not a signal. It is a decision state: DEFENDED, WATCH, WEAK RETEST, APPROACH, DEFENSE LOST, WAIT, or SCAN.
⚙️ Methodology
1. Context Detection
The script identifies fresh support-side or resistance-side defense shelves using confirmed pivot behavior and optional automatic side selection.
2. Reference Mapping
It maps one active defense zone, a shelf rail, a risk edge, and a target-room guide. These are planning references, not trade instructions.
3. Reaction Evaluation
The 0-100 model scores retest depth, wick defense, close response, time at level, and volume support.
4. Visual Output
The chart shows the active defense zone with centered text, event labels, guide lines, and the AGPro decision panel.
🗺️ How to Read the Chart
Defense Zone = the active shelf area being evaluated after price returns to it.
Defense Rail = the exact reference shelf the model is monitoring.
Risk Edge = the planning line where the active defense context is considered lost.
Target-Room Guide = a forward context guide based on the current shelf-to-risk distance.
Labels = compact TEST, DEFENDED, WATCH, WEAK, LOST, and context labels.
Colors = teal marks bullish support-defense context, pink marks bearish resistance-defense context, amber marks caution/review, indigo marks watch/transition, and red marks lost defense.
Panel = the AGPro panel summarizes Defense State, Retest Score, Reaction Quality, Risk Edge, and Action.
🚦 Signals & States
• DEFENDED → the shelf has been retested and the defense score is strong enough for structured review.
• WATCH → the response is developing, but confirmation or room is still incomplete.
• WEAK RETEST → price touched the shelf, but response quality is not strong enough.
• APPROACH → price is near the active defense shelf and a retest review may be forming.
• DEFENSE LOST → price crossed the risk edge and the active shelf context should be rebuilt.
• WAIT → an active shelf exists, but price is not close enough for a useful review.
• SCAN → no fresh defense shelf is active yet.
🔔 Alerts Logic
Alerts trigger when price touches the active defense zone, when a defended retest appears, when watch context appears, when a weak retest is detected, and when the risk edge is crossed.
Alerts are attention markers only. They are not trade instructions, automated strategy commands, or outcome promises.
🧩 Confluence Logic
The strongest context appears when a controlled retest probe, visible wick defense, constructive close response, enough hold time, supportive relative volume, and usable target room align.
When those components conflict, the panel moves toward WATCH, WEAK RETEST, RISK REVIEW, or DEFENSE LOST.
📊 When to Use
• Pullbacks into a defended support shelf
• Retests of a resistance shelf after bearish pressure
• 4H retest reviews where shelf defense and reaction candles are visually readable
• Continuation planning where the level has already been identified by price action
• Risk planning where invalidation and target room matter
• Liquid markets where candles, pivots, and volume behavior are readable
⚠️ When NOT to Use
• Very low-liquidity symbols with irregular candles
• Extremely noisy micro-timeframes
• News-driven spikes where shelf behavior becomes distorted
• Markets where pivot structure is too compressed to form useful shelves
• Situations where the user expects a signal-only tool
🎛️ Key Inputs
• Defense Side → selects Auto, Bullish Defense, or Bearish Defense.
• Defense Pivot Length → controls how confirmed shelves are detected.
• Max Shelf Age → controls how long a shelf remains eligible.
• Sensitivity → adjusts activation distance and zone tolerance.
• Response Window Bars → controls how long the retest response remains active.
• Risk Edge ATR → controls the planning risk edge behind the shelf.
• DEFENDED Score → sets the score threshold for stronger review states.
• Label and Panel Font Size → controls chart-label and panel readability.
• Panel Location and Theme → adjusts the AGPro panel layout.
🖥️ Interface & Visual Design
The interface is designed to stay chart-first and decision-led.
The defense zone is the main visual object. The centered label keeps the zone readable without adding extra floating text. The risk edge and target guide explain where the planning context weakens and how much room remains.
The AGPro panel uses a merged blue title row and five compact rows so the user can read state, score, reaction quality, risk, and next action quickly.
🧪 Practical Usage Workflow
1. Read the panel state and Retest Score.
2. Check whether price is approaching or touching the defense zone.
3. Compare the shelf rail with the risk edge.
4. Review whether the label says TEST, DEFENDED, WATCH, WEAK, or LOST.
5. Confirm the broader market context before making any decision.
🔍 Interpretation Guidelines
Think in terms of defense quality, not prediction.
A higher score means multiple defense components align inside the script's rule set. A weaker score means the retest may be too shallow, too deep, too fast, too noisy, or missing a constructive close response.
The script helps organize the review process. It does not replace judgment.
🚫 What This Script Is NOT
• Not a prediction engine
• Not financial advice
• Not an auto-trading system
• Not a guaranteed signal tool
• Not a BOS / CHOCH scanner
• Not a breakout retest scanner
• Not a swing-leg retest tool
• Not an order block, FVG, or supply/demand map
• Not a generic support/resistance zone map
⚠️ Limitations & Transparency
• Pivot-based shelf references appear only after pivots are confirmed.
• Scores can vary across symbols, sessions, and timeframes.
• Volume scoring depends on exchange-provided volume data.
• Fast volatility can cross a shelf before a clean defense can be measured.
• In Live Updating mode, active-bar values can change before the bar closes.
🧠 Market Context Notes
Retest defense is easiest to interpret when liquidity, volatility, and trend context are readable.
A defended shelf is not enough by itself. The reaction, close location, hold time, risk edge, and target room all matter.
🧾 Use Case Examples
When price returns to a support shelf, probes the defense zone, forms a visible lower wick, and closes back above the shelf with enough target room, the planner may mark DEFENDED.
When price touches the shelf but closes weakly with poor reaction quality, the planner may show WEAK RETEST or WATCH.
When price crosses the risk edge, DEFENSE LOST indicates that the active context should be rebuilt.
🧱 System Philosophy
Retest Defense Planner follows the AGPro decision-engine approach: map the context, score the quality, show the risk reference, show the target room, and summarize the next action without issuing trade commands.
🔐 Non-Promise Statement
No indicator can provide certainty.
The script does not guarantee that a retest will hold, continue, reverse, or produce any specific outcome.
📉 Risk Disclosure
Trading involves risk.
Users are responsible for their own analysis, risk management, and trading decisions.
This script is provided for educational and analytical purposes only and does not constitute financial advice.
📚 Educational Note
Use the script as a structured retest-defense review framework. The best results come from combining the panel, zones, labels, and alerts with broader chart context and disciplined risk evaluation.
Indicator
Structure Retest Planner [AGPro Series]Structure Retest Planner
🧠 Core Idea
Is the active structure retest being accepted, rejected, or invalidated?
📌 Overview / What it does
Structure Retest Planner is a structure-based trade planning overlay designed to help traders evaluate how price behaves when it returns to an important swing-derived structure rail.
The script maps the active support-side or resistance-side rail, draws a focused retest box around that rail, scores the retest from 0-100, and projects practical invalidation and target guides. The goal is to organize the retest decision process: structure state, score, acceptance, invalidation, and next action.
It does not predict the next move, does not automate trading, and does not turn every swing point into a generic support/resistance signal. It is a decision-support planner for reading acceptance and rejection around a live structure retest.
🎯 Purpose & Design Philosophy
This script was built for traders who use price structure but need a cleaner way to judge whether a retest deserves attention.
Most structure tools identify levels, breaks, or swing labels. Structure Retest Planner focuses on the next decision after a rail is present: is price responding cleanly enough, is invalidation nearby, and what should be reviewed next?
The design supports a planning mindset rather than a signal-chasing mindset. It is meant to make the chart easier to interpret while keeping the trader responsible for context and risk.
⚡ Why This Script Is Different
Most tools focus on plotting structure breaks, BOS / CHoCH labels, or broad support and resistance zones.
This script does NOT clone a BOS / CHoCH detector and does NOT duplicate a first-break retest grader.
Instead, it treats the active structure rail as a planning reference and evaluates acceptance, rejection, volatility fit, trend agreement, invalidation distance, and next-action state in one workflow.
⚙️ Methodology
1. Context Detection
The script confirms swing-derived structure rails using pivot logic and identifies whether the active planning side is support retest, resistance retest, or automatic nearest-rail context.
2. Reference Mapping
It draws a retest box around the active rail, plus an invalidation shelf and target guide. These are planning references, not guaranteed outcomes.
3. Reaction Evaluation
The 0-100 score combines level origin quality, retest response, close location, volatility fit, and trend agreement.
4. Visual Output
The script shows a centered retest-box label, compact event labels, rail/invalidation/target guides, alerts, and a premium AG Pro panel.
🗺️ How to Read the Chart
Zones = the active retest box around the selected structure rail.
Labels = watch, accepted, rejected, invalidated, or risk-review states with optional score and grade.
Colors = teal for support-side acceptance, pink for resistance-side or rejection pressure, yellow for review states, and indigo for planning context.
Panel = structure state, retest score, acceptance state, invalidation shelf, and next action.
🚦 Signals & States
• Retest Watch → price is close enough to the active rail and the score is improving.
• Accepted → price tested the rail and closed constructively on the expected side.
• Ready → acceptance is active and the score reached the ready threshold.
• Rejected → price tested the rail but did not show clean acceptance.
• Invalidated → price closed beyond the invalidation shelf.
• Risk Review → retest behavior exists, but volatility is too hot for clean reading.
🔔 Alerts Logic
Alerts trigger when the script detects a new watch state, accepted retest, high-quality retest review, rejected retest, or invalidation shelf break.
Alerts are attention markers. They are not trade instructions and should always be interpreted with broader market context.
🧩 Confluence Logic
The score improves when the active rail has a cleaner structural origin, price reacts near the rail, the close lands on the expected side, volatility is not overheated, and trend context agrees with the retest side.
When these factors align, the retest context becomes easier to review. When they conflict, the panel shifts toward waiting, context confirmation, risk review, or reset.
📊 When to Use
• Pullbacks toward confirmed swing structure
• Trend continuation retests
• Resistance retests after bearish structure pressure
• Support retests after bullish structure pressure
• Markets where structure rails are visible and not excessively noisy
⚠️ When NOT to Use
• Very low-liquidity symbols
• Extremely noisy sideways markets
• News-driven volatility spikes
• Markets where pivot structure is too compressed to provide useful rails
• Any situation where the user expects automated entry or exit instructions
🎛️ Key Inputs
• Retest Side → selects Auto, Support Retest, or Resistance Retest.
• Structure Pivot Length → controls how structure rails are confirmed.
• Sensitivity → changes retest-box width and activation behavior.
• Retest Ready Score → sets the minimum score for stronger review states.
• Invalidation Shelf ATR → adjusts the planning invalidation reference.
• Target Guide R Multiple → projects the forward target guide from planning risk.
• Label and Panel Font Size → controls visual readability.
• Panel Location and Theme → adjusts interface placement and style.
🖥️ Interface & Visual Design
The panel is built as a compact planning dashboard with one merged blue AG Pro header row and five decision rows.
The chart visuals are intentionally restrained: one active retest box, centered box text, structure rail, invalidation shelf, target guide, and controlled labels.
The design goal is to make the active retest decision readable without turning the chart into a dense support/resistance map.
🧪 Practical Usage Workflow
1. Read the panel to identify the active structure state.
2. Check whether price is approaching or testing the retest box.
3. Review the retest score and acceptance state.
4. Compare the invalidation shelf and target guide.
5. Use your own broader context before making any decision.
🔍 Interpretation Guidelines
A higher score means the retest is cleaner within the script's rule set. It does not mean price must continue.
Acceptance means the bar closed constructively relative to the rail. Rejection means the rail is not holding cleanly. Invalidation means the planning reference has been crossed and the setup should be reviewed again.
Use the script to organize thinking, not to outsource judgment.
🚫 What This Script Is NOT
• Not a prediction engine
• Not financial advice
• Not auto trading
• Not guaranteed signals
• Not a BOS / CHoCH auto detector
• Not a generic support/resistance zone map
⚠️ Limitations & Transparency
The script uses pivot-based structure, so rails appear only after pivots are confirmed.
Timeframe choice, volatility, liquidity, and symbol behavior can materially change how retests appear.
Fast markets may pass through a rail before the retest can be evaluated cleanly. Sideways markets may create repeated low-quality tests.
🧠 Market Context Notes
Structure retests are easier to interpret when liquidity, trend context, and volatility are aligned.
A clean rail is not enough on its own. The reaction, close location, invalidation distance, and broader environment all matter.
🧾 Use Case Examples
When price returns to a prior support rail and closes back above it with a strong lower wick, the planner may shift from watch to accepted if the score is high enough.
When price tests resistance but closes back below the rail with volatility under control, the planner may mark a cleaner resistance-side review state.
When price closes beyond the invalidation shelf, the planner marks the context as invalidated and the plan should be reset.
🧱 System Philosophy
Structure Retest Planner is part of the AGPro Series decision-engine direction: tools should help traders answer what is valid, how strong it is, where risk is, and what should be reviewed next.
🔐 Non-Promise Statement
No signal from this script guarantees continuation, reversal, or profit.
The output is a structured analytical read, not certainty.
📉 Risk Disclosure
Trading involves risk.
Users are responsible for their own analysis, risk management, and decisions.
This script does not provide financial advice and does not guarantee trading outcomes.
📚 Educational Note
Use the planner to study how structure retests behave across symbols and timeframes, especially how acceptance, rejection, volatility, and invalidation interact.
Indicator
Swing Retest Quality [AGPro Series]Swing Retest Quality
🧠 Core Idea
Is the active swing retest clean enough to treat as valid context, or is the pullback too weak, too deep, or too hard to plan?
📌 Overview / What it does
Swing Retest Quality is a chart-first swing retest planner built to evaluate pullbacks into an active swing leg.
The script maps a focused swing retest pocket, defense line, target-room zone, compact labels, deterministic alerts, and a clean AGPro panel. It converts swing clarity, retest depth, wick rejection, close response, and volume support into a 0-100 Retest Quality score.
It does not predict future price movement, automate entries, print buy/sell commands, or replace broader market context. Its purpose is to help traders judge whether a swing retest has enough structure to deserve attention.
🎯 Purpose & Design Philosophy
This script was built for traders who evaluate pullbacks, retests, and continuation structure but want a more disciplined way to judge retest quality.
Many tools show structure levels or retest markers without answering the practical planning question: is this retest clean, defended, and readable enough to review?
The design philosophy is simple: a retest is not useful just because price touches a level. It becomes useful when the swing reference is clear, the pullback depth is controlled, the response is readable, and risk/target context can be mapped.
⚡ Why This Script Is Different
Most tools focus on support/resistance touches, break-and-retest markers, BOS/CHOCH events, or broad supply/demand zones.
This script does NOT clone Break-Retest Quality, does not require a structure break first, does not map order blocks, does not create a generic S/R zone map, and does not become a broad swing scanner.
Instead, it evaluates one active swing leg and asks whether the pullback into that swing has enough quality to be treated as valid context. The main output is not a trade command. It is a planner state: VALID RETEST, WATCH, DEFENSE REVIEW, LOST, or WAIT.
⚙️ Methodology
1. Context Detection
The script detects confirmed swing highs and lows, then identifies the active bull or bear swing leg.
2. Reference Mapping
It builds a concept-native retest pocket inside the active swing, adds a defense line behind the swing origin, and projects a target-room zone toward the swing terminal.
3. Reaction Evaluation
The model scores swing clarity, retest depth, wick rejection, close response, and optional volume support.
4. Visual Output
The result is displayed through a centered retest pocket, centered target-room zone, defense guide, swing leg, compact labels, alerts, and a premium AGPro panel.
🗺️ How to Read the Chart
Zones = the retest pocket shows where a pullback into the active swing leg is being evaluated. The target-room zone shows the available room back toward the swing terminal or extension guide.
Labels = compact event labels mark pocket tests, hold retests, watch states, room reviews, and defense-loss events.
Colors = teal marks cleaner bull-side retest context, pink marks bear-side or lost-defense context, amber marks caution/review, and indigo marks watch/transition context.
Panel = the panel summarizes Retest Quality, Swing Side, Defense State, Risk Room, and Action.
🚦 Signals & States
• VALID RETEST → the active swing retest is holding with enough quality and room for review.
• WATCH → the retest context is improving, but confirmation is incomplete.
• DEFENSE REVIEW → price has tested the pocket, but quality, response, or room is not strong enough.
• LOST → price has crossed the defense line and the swing context should be rebuilt.
• WAIT → no active swing retest context is strong enough yet.
🔔 Alerts Logic
Alerts trigger when price touches the swing retest pocket, when a valid swing retest appears, when a watch state appears, when target room becomes limited, and when the defense line is lost.
These alerts are attention markers only. They are not trade instructions, entry signals, or automated strategy commands.
🧩 Confluence Logic
The strongest context appears when a clear swing leg is followed by a controlled retest depth, visible wick rejection, a constructive close response, supportive relative volume, and enough target room relative to the defense line.
When these components align, the Retest Quality score improves and the state can move from WATCH to VALID RETEST.
📊 When to Use
• During pullbacks inside a clear directional swing
• When price is retesting a prior swing leg rather than breaking a new structure level
• When planning continuation context around a readable defense line
• When comparing whether a pullback is clean enough to monitor or too weak to trust
• On liquid symbols where pivots, candles, and volume behavior are readable
⚠️ When NOT to Use
• Very low-liquidity symbols with irregular candles
• Extremely noisy micro-timeframes
• News-driven spikes where swing structure becomes distorted
• Markets where volume is unreliable and should not affect scoring
• Situations where the user expects a signal-only entry tool
🎛️ Key Inputs
• Swing Pivot Length → controls how confirmed swing highs and lows are detected.
• Max Swing Age → controls how long a swing leg remains active.
• Shallow / Deep Pocket Depth → controls the retest pocket inside the swing leg.
• Ideal Retest Depth → defines the preferred pullback depth for stronger scoring.
• Defense Buffer ATR → controls the defense line behind the swing origin.
• Minimum Target Room ATR → defines how much room is preferred before VALID state.
• Label and Panel Font Size → controls chart labels, centered zone text, and panel readability.
🖥️ Interface & Visual Design
The interface is designed to stay chart-first.
The retest pocket gives the main visual story. The defense line defines where the swing context becomes weak. The target-room zone shows whether the pullback still has practical room to evaluate.
The AGPro panel uses a merged blue title row and a compact decision hierarchy so the user can read state, quality, risk, and next action quickly.
🧪 Practical Usage Workflow
1. Read the panel state and Retest Quality score.
2. Check whether price has touched the swing retest pocket.
3. Review the defense line and target-room zone.
4. Evaluate whether the label says HOLD, WATCH, ROOM REVIEW, or DEFENSE LOST.
5. Compare the retest with broader trend, liquidity, volatility, and timeframe context.
🔍 Interpretation Guidelines
Think in terms of retest quality, not prediction.
A stronger score means multiple structural conditions are aligned. A weaker score means the swing may be unclear, the pullback may be too shallow or too deep, the response may be weak, or target room may be limited.
The script helps organize the review process. It does not decide for the user.
🚫 What This Script Is NOT
• Not a prediction engine
• Not financial advice
• Not an auto-trading system
• Not a guaranteed signal tool
• Not a Break-Retest Quality clone
• Not a BOS/CHOCH scanner
• Not a generic support/resistance zone map
• Not a supply/demand, order block, or FVG map
⚠️ Limitations & Transparency
• Pivot-based swing references depend on the selected Swing Pivot Length.
• Scores can vary across symbols, sessions, and timeframes.
• Volume support depends on exchange-provided volume data.
• Fast, news-driven movement can distort retest depth and defense readings.
• In Live Updating mode, active-bar values can change before the bar closes.
🧠 Market Context Notes
Swing retests are most useful when the broader chart has readable structure.
Liquidity, volatility, trend maturity, and higher-timeframe context can all affect whether a retest should be treated as meaningful. The script provides a structured review layer, not a complete trading system.
🧾 Use Case Examples
When a bull swing is clear and price pulls back into the retest pocket, a HOLD RETEST label with a strong score indicates that the pullback response is clean enough to review.
When price touches the pocket but target room is too limited, ROOM REVIEW highlights that the structure may be readable but planning space is constrained.
When price crosses the defense line, DEFENSE LOST indicates that the active swing context should be rebuilt.
🧱 System Philosophy
Swing Retest Quality follows the AGPro decision-engine approach: map the context, score the quality, show the risk reference, show the target room, and summarize the next action without issuing trade commands.
🔐 Non-Promise Statement
No indicator can provide certainty.
The script does not guarantee that a retest will hold, continue, reverse, or produce any specific outcome.
📉 Risk Disclosure
Trading involves risk.
Users are responsible for their own analysis, risk management, and trading decisions.
This script is provided for educational and analytical purposes only and does not constitute financial advice.
📚 Educational Note
Use the script as a structured retest-review framework. The best results come from combining the panel, zones, labels, and alerts with broader chart context and disciplined risk evaluation.
Indicator
Acceptance Breakout Planner [AGPro Series]Acceptance Breakout Planner
🧠 Core Idea
Did price truly accept beyond the breakout level, or did it only tag the level and fail to hold?
📌 Overview / What it does
Acceptance Breakout Planner is a chart-first breakout decision tool designed to evaluate what happens after price moves beyond a key rolling reference edge.
Instead of treating every breakout as meaningful, the script measures close persistence, time beyond the level, retest-hold behavior, range distance, candle quality, volume support, and failure shelf risk. It converts that evidence into a 0-100 Acceptance Score and a clear next-action state.
The script produces an acceptance band, a failure shelf, a target-room guide, controlled chart labels, alerts, and a clean AGPro planning panel. It does not predict price movement, automate execution, or claim that acceptance will continue.
🎯 Purpose & Design Philosophy
This script was built to fill the gap between a simple breakout marker and a full trade-management system.
Many traders can see when price crosses a level. The harder question is whether price is spending enough time beyond that level to deserve attention, or whether the break is only a low-commitment tag.
The design supports a planner mindset: observe the break, measure acceptance, watch the failure shelf, and review the next state with structure instead of reacting to a single candle.
⚡ Why This Script Is Different
Most breakout tools focus on the moment price crosses a level.
This script does NOT function as a generic breakout signal, volume-spike detector, consolidation breakout box, Donchian channel tool, or broad break-retest scanner.
Instead, it focuses on post-break acceptance quality. The key question is not simply "did price break?" The key question is "did price remain accepted beyond the broken reference long enough to reduce tag-only risk?"
This keeps the script separate from Breakout Volume Quality, Consolidation Breakout Quality, Break-Retest Quality, Price Acceptance Profile, and reference-specific breakout tools in the AGPro catalog.
⚙️ Methodology
1. Context Detection
The script maps rolling upper and lower reference edges from prior bars. These references are used only as breakout acceptance anchors.
2. Reference Mapping
When price closes beyond a reference edge by an ATR-adjusted buffer, the planner starts an active acceptance sequence.
3. Reaction Evaluation
The active sequence is scored through close persistence, time beyond the level, acceptance-band retests, candle quality, relative volume support, and distance from the failure shelf.
4. Visual Output
The chart shows an acceptance band, a failure shelf, a target-room guide, compact state labels, and a panel that summarizes acceptance score, time beyond, break side, failure risk, and action.
🗺️ How to Read the Chart
Acceptance Band = the zone around the broken level where price should hold if acceptance is developing.
Failure Shelf = the invalidation context behind the broken level. A close through this shelf means the breakout acceptance sequence needs review.
Target Room = a projected planning guide based on the prior reference range. It is not a forecast or promised target.
Labels = compact event markers such as BULL BRK, BEAR BRK, WATCH, HOLD, ACCEPT, TAG, RISK, and REJECT.
Colors = teal supports constructive acceptance, pink marks rejection or failure pressure, yellow marks caution, and indigo marks active watch states.
Panel = a compact decision view showing Acceptance Score, Time Beyond, Break Side, Failure Risk, and Action.
🚦 Signals & States
• BULL BRK → price closed beyond the upper reference and started an acceptance review.
• BEAR BRK → price closed beyond the lower reference and started an acceptance review.
• WATCH → acceptance evidence is improving but is not mature yet.
• HOLD → price revisited the acceptance band and held beyond the broken reference.
• ACCEPT → close persistence, score quality, and time beyond the level reached the accepted state.
• TAG → the sequence is active, but close persistence is still weak after the review window.
• RISK → acceptance is not mature and the failure shelf is becoming more relevant.
• REJECT → price closed through the failure shelf after the breakout sequence.
🔔 Alerts Logic
Alerts trigger when a new acceptance break starts, when accepted state appears, when a retest hold is detected, when failure risk rises, or when price rejects through the failure shelf.
Alerts are attention markers. They are not trade instructions, automation commands, or certainty statements.
🧩 Confluence Logic
The strongest acceptance context appears when several conditions align:
• price closes beyond the broken reference more than once
• the acceptance band holds during a retest
• candle structure remains directional
• failure shelf distance remains healthy
• volume support is present without being the only reason for the score
When these elements align, the Acceptance Score rises and the state becomes easier to interpret.
📊 When to Use
• Breakout review after price crosses a visible range edge
• Markets where one-bar breakout tags are common
• Trend continuation attempts that need acceptance confirmation
• Range expansion moves where the trader wants to separate holding behavior from weak level pokes
• Chart review workflows that need a clear post-break next-action state
⚠️ When NOT to Use
• Extremely low-liquidity markets with unreliable candles
• Very noisy symbols where reference edges are constantly pierced
• News-driven volatility where ATR buffers may become unstable
• Situations where the user expects automatic trade entries
• Markets where volume data is missing and volume support is treated as less useful
🎛️ Key Inputs
• Break Side → controls whether the planner evaluates bullish breaks, bearish breaks, or both.
• Reference Lookback → defines the prior-bar range used to map breakout reference edges.
• Close Beyond Level ATR → controls how far beyond the level price must close before a sequence starts.
• Acceptance Band ATR → controls the retest-hold zone around the broken level.
• Failure Shelf ATR → controls the invalidation context behind the broken level.
• Minimum Beyond Closes → controls how much close persistence is required before acceptance can mature.
• ACCEPTED Threshold → sets the minimum 0-100 score for accepted state.
• Label / Panel Controls → adjust visual density, placement, theme, and font size.
🖥️ Interface & Visual Design
The interface is designed to stay chart-first. The acceptance band and failure shelf show the current structure, while labels mark only meaningful state changes.
The panel uses the AGPro standard: a single blue merged header row, compact rows, clear state colors, adjustable location, adjustable theme, and normal font size by default.
The visual hierarchy is intentionally restrained so the chart looks active without becoming crowded.
🧪 Practical Usage Workflow
1. Read the panel to see the current Acceptance Score and action state.
2. Check whether price is holding beyond the broken reference or drifting back into the band.
3. Watch the failure shelf to understand whether the breakout is losing acceptance.
4. Review labels only as context markers, not as standalone decisions.
5. Confirm the broader market context before acting on any chart interpretation.
🔍 Interpretation Guidelines
Think of the script as a post-break acceptance reviewer.
A higher Acceptance Score means the breakout has stronger evidence of persistence according to the script model. A lower score means the move may still be early, weak, or vulnerable to failure.
The most useful reading is the relationship between time beyond the level, retest behavior, and failure shelf distance.
🚫 What This Script Is NOT
• Not a prediction engine
• Not financial advice
• Not an auto-trading system
• Not guaranteed signals
• Not a generic support/resistance map
• Not a consolidation breakout box tool
• Not a pure volume breakout detector
• Not a full break-retest scanner
⚠️ Limitations & Transparency
Breakout acceptance is sensitive to timeframe, volatility, liquidity, and symbol behavior.
The reference edges are rolling and can change as older bars leave the lookback window.
ATR-based buffers can expand or contract during volatile market conditions.
Relative volume may be less useful on symbols with limited or inconsistent volume data.
🧠 Market Context Notes
Acceptance after a breakout is often more useful than the initial break itself.
A level tag shows that price reached a reference. Acceptance shows whether price can keep spending time beyond that reference.
This distinction is the core purpose of the planner.
🧾 Use Case Examples
When price closes above a reference edge and then holds the acceptance band on a later retest, the script may shift from watch context toward stronger acceptance.
When price breaks a reference but quickly returns through the failure shelf, the script marks rejection context instead of treating the break as mature.
When price remains beyond the level but does not build enough persistence, the script can show TAG ONLY or FAILURE RISK.
🧱 System Philosophy
Acceptance Breakout Planner follows the AGPro decision-engine approach:
It does not ask users to react to a raw signal.
It organizes the chart into quality, state, risk, target-room context, and next-action review.
🔐 Non-Promise Statement
No script can remove uncertainty from markets.
No state, score, label, band, shelf, or alert guarantees future price behavior.
📉 Risk Disclosure
Trading involves risk.
This script is for educational and analytical use only.
It does not provide financial advice, investment advice, trade instructions, or guaranteed outcomes.
Users remain responsible for their own decisions, risk management, and market evaluation.
📚 Educational Note
Use the script to study the difference between a breakout tag and breakout acceptance.
The strongest value comes from comparing the planner state with broader structure, volatility, liquidity, and personal execution rules.
Indicator
Reclaim Breakout Planner [AGPro Series]Reclaim Breakout Planner
🧠 Core Idea
Is a recently broken structural level being lost and reclaimed in a way that creates a valid breakout planning area?
📌 Overview / What it does
Reclaim Breakout Planner is a chart-first breakout planning tool built around structural pivot reclaim behavior. It detects when price breaks beyond a confirmed pivot level, temporarily moves back through that broken level, and then closes back on the breakout side with measurable acceptance quality.
The script produces a 0-100 Acceptance Score, an active Reclaim State, an Acceptance Pocket, a Risk Edge, a Target Corridor, controlled chart labels, and a compact AG Pro panel. The goal is to help traders organize reclaim context after a structural breakout attempt.
This script does not predict price direction, automate trades, or mark every pivot as important. It filters for a specific sequence: structural level break -> temporary level loss -> reclaim close -> planning state.
🎯 Purpose & Design Philosophy
Many breakout tools stop after price crosses a level. Many retest tools treat any return to the level as meaningful. This script was built for the narrower question that often matters after a breakout: did price briefly lose the broken level and then reclaim it with enough quality to deserve attention?
It is designed for traders who want a cleaner decision-support layer around breakout acceptance, not another crowded support/resistance map. The mindset is planning first: evaluate validity, score quality, locate risk, estimate target room, and decide whether the context deserves monitoring.
⚡ Why This Script Is Different
Most tools focus on the breakout candle or the retest touch.
This script does NOT clone VWAP Reclaim Quality, Previous Day Sweep & Reclaim, EMA reclaim maps, session VWAP reaction tools, or a simple breakout retest readiness model.
Instead, it focuses on structural pivot reclaim after a level is briefly lost. The reclaim must come from a confirmed pivot break, a temporary move back through the broken level, and a close back on the breakout side. That creates a distinct reclaim-planning workflow rather than a generic level scanner.
⚙️ Methodology
1. Context Detection
The script identifies confirmed pivot highs and pivot lows as structural levels. These levels are not VWAP, previous-day highs/lows, session anchors, order blocks, or fixed support/resistance zones.
2. Breakout Arming
When price closes beyond a pivot level by an ATR-normalized amount, the planner arms a reclaim watch. A bullish watch begins after a close above resistance. A bearish watch begins after a close below support.
3. Reclaim Evaluation
The script waits for price to temporarily lose the broken level and then close back through it. It scores the event using reclaim close distance, retest depth, volume support, trend alignment, and wick rejection.
4. Visual Output
Accepted reclaims create an Acceptance Pocket, Risk Edge, Target Corridor, event labels, sparse context labels, and panel state. The visuals are designed to stay readable without leaving the chart empty.
🗺️ How to Read the Chart
Acceptance Pocket = the reclaimed structural level area where the breakout side is being tested.
Risk Edge = the failed-side reference beyond the pocket. It is a planning boundary, not a trading instruction.
Target Corridor = a projected review area based on the reclaim risk distance and the selected R multiple.
Labels = compact event and context markers such as Bull Reclaim, Bear Reclaim, Retest Watch, and Failed Reclaim. Target Review labels are optional because the target corridor already marks the review area.
Colors = bullish reclaim context uses teal, bearish reclaim context uses pink, caution/watch states use gold or indigo, and risk/failure context uses red.
Panel = shows Reclaim State, Acceptance Score, Risk Edge, Target Room, and Action.
🚦 Signals & States
• Scan Structure → no active reclaim plan exists yet.
• Bull Retest Watch → price broke above a structural pivot and is waiting for a valid reclaim sequence.
• Bear Retest Watch → price broke below a structural pivot and is waiting for a valid reclaim sequence.
• Acceptance Watch → reclaim exists, but the score is not strong enough for the highest planning state.
• Plan Review → reclaim quality is strong enough to monitor as structured planning context.
• Risk Edge Test → price is testing the failed-side boundary.
• Failed Reclaim → the active reclaim plan closed beyond the risk edge.
• Target Review → price reached the projected target corridor area.
🔔 Alerts Logic
Bullish Reclaim Breakout Plan triggers when a bullish structural reclaim is accepted and the score is above the alert threshold.
Bearish Reclaim Breakout Plan triggers when a bearish structural reclaim is accepted and the score is above the alert threshold.
Reclaim Risk Edge Failed triggers when an active reclaim plan closes beyond the risk edge.
Reclaim Target Corridor Reached triggers when price reaches the projected target corridor.
Alerts are attention markers. They are not trade instructions.
🧩 Confluence Logic
The context becomes stronger when a confirmed pivot breakout, temporary level loss, reclaim close, supportive volume, trend alignment, and wick rejection appear together. The score compresses those components into one readable 0-100 Acceptance Score.
📊 When to Use
• After structural breakouts where price returns to the broken level
• During trending or transitioning markets where reclaim behavior matters
• When evaluating whether a breakout level is being accepted after a brief failure
• When a trader needs risk edge and target-room context around a reclaim sequence
⚠️ When NOT to Use
• Very low-liquidity symbols with unreliable volume and erratic candles
• Extremely noisy ranges where pivots form too frequently
• News-driven candles where ATR-normalized structure can be distorted
• Markets where price is far from any meaningful structural pivot
🎛️ Key Inputs
• Reclaim Side → selects Auto, Bullish Only, or Bearish Only.
• Pivot Strength → controls how selective structural levels are.
• Minimum Break Close ATR → defines how far beyond the pivot price must close before a reclaim watch is armed.
• Minimum Level Loss ATR → requires price to temporarily move back through the broken level before reclaim evaluation.
• Acceptance Pocket ATR → controls the visual and logical reclaim pocket size.
• Retest Window Bars → controls how long the reclaim watch remains valid.
• Risk Edge Buffer ATR → adjusts the failed-side planning boundary.
• Target Corridor R Multiple → controls the projected target review area.
• Label and Panel Settings → control chart label density, optional target review labels, font size, panel location, and panel theme.
🖥️ Interface & Visual Design
The interface is intentionally compact. The chart carries the main decision layer through acceptance pockets, risk edges, target corridors, and event labels. The panel acts as a quick readout for state, score, risk, target room, and next action.
The first panel row follows the AGPro style with a merged blue title row. Label density is controlled by cooldown and maximum visible label settings so the chart remains premium and readable.
🧪 Practical Usage Workflow
1. Read the panel state.
2. Check whether the planner is scanning, watching a retest, or showing an accepted reclaim.
3. Inspect the Acceptance Pocket and Risk Edge.
4. Compare the Acceptance Score with the active state.
5. Use the Target Corridor as a review area, not as a guaranteed objective.
🔍 Interpretation Guidelines
A high score means the reclaim sequence is cleaner under the script's rules. It does not mean the market must continue.
A weak score means the reclaim lacks enough acceptance quality, volume support, trend alignment, or wick rejection.
A failed reclaim means the planning structure has weakened and should be re-evaluated in broader market context.
🚫 What This Script Is NOT
• Not a prediction engine
• Not financial advice
• Not auto trading
• Not guaranteed signals
• Not a VWAP reclaim tool
• Not a previous-day sweep reclaim script
• Not a generic support/resistance map
• Not an order block or FVG scanner
⚠️ Limitations & Transparency
Timeframe selection affects pivot behavior. Lower timeframes may create more reclaim sequences, while higher timeframes may produce fewer but more important structural levels.
Volatility can widen pockets and risk edges. During extreme volatility, reclaim signals can appear later or fail faster.
Volume quality may be less reliable on markets where reported volume is synthetic, incomplete, or inconsistent.
🧠 Market Context Notes
Reclaim behavior often matters when a market tests whether a broken level is becoming accepted. A clean reclaim can show that a breakout area is still being defended. A failed reclaim can show that the attempted breakout lost structure.
The script treats that behavior as planning context, not certainty.
🧾 Use Case Examples
When price closes above a pivot high, dips back below the broken level, then closes back above it with rejection wick and supportive volume, the planner may create a bullish reclaim plan.
When price closes below a pivot low, trades back above the broken level, then closes back below it with rejection behavior, the planner may create a bearish reclaim plan.
🧱 System Philosophy
AGPro tools are designed to help traders organize context, not chase isolated signals. This script follows that principle by turning reclaim behavior into a structured planning workflow with score, state, risk edge, target room, and action text.
🔐 Non-Promise Statement
No script can guarantee continuation, reversal, or future price behavior. Reclaim structure can fail, especially in fast, illiquid, or news-driven markets.
📉 Risk Disclosure
Trading involves risk. This script is for educational and analytical use only. It does not provide financial advice, investment advice, or guaranteed trading outcomes. Users remain responsible for their own decisions.
📚 Educational Note
Use the script to study how reclaimed structural levels behave across symbols, timeframes, and volatility environments. The best use is disciplined observation, comparison, and context building.
Indicator
Range Escape Planner [AGPro Series]Range Escape Planner
🧠 Core Idea
Is price escaping a mature range with enough quality to monitor, or is the move still vulnerable to failure?
📌 Overview / What it does
Range Escape Planner is a chart-first breakout quality and trade planning tool built around mature range escape behavior.
Instead of printing a generic breakout signal, the script maps the active range boundary, projected escape corridor, invalidation edge, target guide, obstruction room, follow-through quality, and retest behavior. These components are converted into a 0-100 Escape Score and a clear next-action state.
The script produces a range boundary box, escape corridor, risk/target guide lines, compact labels, alerts, and a clean AGPro planning panel. It does not predict future price movement, automate decisions, or guarantee that a range escape will continue.
🎯 Purpose & Design Philosophy
This script was built for traders who want to evaluate breakout quality after price leaves a mature range.
Many breakout tools identify the break itself but stop before answering the practical planning questions: is the range mature, is the close beyond the boundary strong enough, is volatility expanding constructively, is there clean room, and where is the failure reference?
The design philosophy is simple: a range escape is only useful when it has maturity, confirmation, room, and a readable invalidation edge.
⚡ Why This Script Is Different
Most tools focus on basic range breaks, box breakouts, session opening ranges, or simple breakout markers.
This script does NOT clone Darvas Box Breakout Quality, does NOT rebuild an ORB model, and does NOT act as a generic consolidation breakout signal.
Instead, it treats the move as a planning problem. The main output is not a buy or sell command. It is a structured state that helps users separate VALID ESCAPE, ESCAPE WATCH, RANGE READY, OBSTRUCTION, FAILED, and WAIT RANGE conditions.
⚙️ Methodology
1. Context Detection
The script maps the prior range from previous bars and checks whether price is still inside, near an edge, or closing beyond the boundary.
2. Reference Mapping
It draws the mature range, escape edge, invalidation edge, projected target guide, and older swing obstruction room.
3. Reaction Evaluation
The model scores range maturity, close beyond range, volatility expansion, follow-through, retest quality, and obstruction room.
4. Visual Output
The result is displayed through centered zone labels, compact event labels, guide lines, deterministic alerts, and a premium AGPro panel.
🗺️ How to Read the Chart
Zones = the range box shows the active mature range. The escape corridor shows the projected planning path from the broken boundary toward a target guide. Zone text is centered inside the boxes.
Labels = compact markers identify RANGE READY, ESCAPE WATCH, VALID ESCAPE, RETEST HOLD, OBSTRUCTION, and FAILED context.
Colors = green highlights cleaner long-side escape quality, pink highlights short-side or failure risk, amber highlights review conditions, and indigo highlights watch or mature-range context.
Panel = the panel summarizes Escape Score, Range Age, Confirmation, Obstruction, and Action.
🚦 Signals & States
• RANGE READY → the range is mature and price is near an escape edge.
• ESCAPE WATCH → price has escaped the range, but follow-through or retest confirmation is still incomplete.
• VALID ESCAPE → the escape has stronger score alignment, follow-through or retest support, and acceptable obstruction context.
• RETEST HOLD → price retested the escape edge and held outside the prior range.
• OBSTRUCTION → the escape is active, but older structure may limit clean room.
• FAILED → price returned through the escape edge and the escape context is no longer clean.
• WAIT RANGE → no mature range escape context is active.
🔔 Alerts Logic
Alerts trigger when the planner detects RANGE READY, New Range Escape, ESCAPE WATCH, VALID ESCAPE, RETEST HOLD, OBSTRUCTION REVIEW, or FAILED ESCAPE conditions.
These alerts are attention markers only. They are not trade instructions, entry signals, or automated strategy commands.
🧩 Confluence Logic
The strongest context appears when a range is mature, price closes beyond the range boundary, volatility expands constructively, candle follow-through improves, the broken edge holds on retest, and obstruction room remains acceptable.
When these components align, the Escape Score improves and the state can progress from RANGE READY to ESCAPE WATCH or VALID ESCAPE.
📊 When to Use
• During range breakout and range expansion review
• 4H and multi-hour swing charts where the range structure has enough space to breathe
• After price has spent time inside a defined range
• When evaluating whether a breakout has clean follow-through
• When a trader needs a visible invalidation edge and target-room reference
• On liquid markets where ATR, range, and swing structure are readable
⚠️ When NOT to Use
• Very low-liquidity symbols with unstable candles
• Extremely noisy micro-timeframes
• Very compressed intraday charts where labels and range boxes can crowd the price action
• News-driven spikes where price gaps far beyond the range
• Markets where older swing structure is too messy to define clean obstruction room
• Situations where the user expects a signal-only entry tool
🎛️ Key Inputs
• Planning Side → controls Auto, Long Escape, or Short Escape mode.
• Range Lookback → controls how the prior range boundary is mapped.
• Minimum Range Age → defines how mature the range should be before stronger scoring.
• Minimum Close Beyond Edge ATR → controls how far price must close beyond the boundary before an escape registers.
• Follow-Through ATR → defines stronger post-escape movement beyond the edge.
• Retest Tolerance ATR → controls how close price can revisit the broken boundary and still count as a hold.
• Obstruction Lookback → controls how older swing structure is checked for clean room.
• Label and Panel Font Size → controls chart labels, centered box text, and panel readability.
🖥️ Interface & Visual Design
The interface is designed to stay chart-first.
The range box defines the active decision area. The escape corridor shows the forward planning path. The invalidation, target, and obstruction lines add context without turning the chart into a crowded signal board.
The AGPro panel provides a compact decision summary with a merged blue title row and clear state hierarchy.
🧪 Practical Usage Workflow
1. Read the panel state and Escape Score.
2. Check whether the range is mature enough.
3. Review the escape corridor and edge line.
4. Check confirmation, retest behavior, and obstruction room.
5. Treat alerts as attention markers, then evaluate broader market context.
🔍 Interpretation Guidelines
Think in terms of escape quality, not prediction.
A stronger score means multiple structural conditions are aligned. A weaker score means the escape may be premature, poorly confirmed, obstructed, too noisy, or already failed.
OBSTRUCTION is especially important because a range can break cleanly while nearby older structure still limits practical room.
🚫 What This Script Is NOT
• Not a prediction engine
• Not financial advice
• Not an auto-trading system
• Not a guaranteed signal tool
• Not a Darvas Box clone
• Not an ORB model
• Not a generic support/resistance zone map
⚠️ Limitations & Transparency
The script is rule-based and depends on recent price, volatility, range, and older swing structure.
Timeframe differences can change how range maturity and escape quality appear. Volatility spikes can distort the score. Thin markets can create false escape or failure behavior.
Outputs should always be interpreted with broader market structure, liquidity, and risk context.
🧠 Market Context Notes
Range escape behavior is most useful when a readable balance area exists before expansion.
An escape with no follow-through may still be early. An escape with immediate obstruction may require extra caution. An escape that returns through the broken edge is treated as failed context, not as a new opposite prediction.
🧾 Use Case Examples
When price closes beyond a mature range, volatility expands from normal conditions, the candle holds beyond the edge, and older obstruction room is clean, the planner may classify the move as VALID ESCAPE.
When price breaks the boundary but quickly returns through the edge, the planner may classify the context as FAILED.
When price escapes but older swing structure is immediately ahead, the planner may show OBSTRUCTION even if the score is otherwise improving.
🧱 System Philosophy
AGPro planning tools are designed to help traders evaluate context before reacting.
This script follows that philosophy by turning a range breakout into a structured planning question: is the escape mature, confirmed, readable, and supported by clean room?
🔐 Non-Promise Statement
No indicator can guarantee continuation, reversal, or follow-through.
This tool provides structured visual context and rule-based attention markers. It does not provide certainty.
📉 Risk Disclosure
Trading involves risk. Market conditions can change quickly, and no script can remove uncertainty.
Users are responsible for their own analysis, risk management, and decisions.
This script is for educational and analytical use only and does not provide financial advice.
📚 Educational Note
Use the planner to study how mature ranges resolve, how escape quality changes after the first break, and how obstruction room affects the readability of breakout continuation.
Indicator
Breakout Failure Recovery [AGPro Series]Breakout Failure Recovery
🧠 Core Idea
After a failed breakout, is price recovering through the reclaim level or confirming the failure?
📌 Overview / What it does
Breakout Failure Recovery is a chart-first failed-breakout lifecycle planner built to evaluate what happens after price probes outside a recent range and closes back inside.
The script maps a failure box, reclaim trigger, risk shelf, recovery/rejection labels, and a compact AGPro panel. It converts close-back-inside behavior, reclaim speed, retest response, volume behavior, and time decay into a 0-100 Recovery Score with a clear next-action state.
It does not predict the next move, automate execution, or act as a generic failed-break signal. Its purpose is to organize the post-failure decision context.
🎯 Purpose & Design Philosophy
This script was built for traders who do not want to treat every failed breakout the same way.
Some failed breaks recover quickly through the original breakout level. Others reject the boundary, lose time, and confirm that the attempt has failed. This tool focuses on that decision window.
The design supports a planner mindset: identify the failure, measure the reclaim attempt, locate the risk shelf, and decide whether the context deserves review or should be downgraded.
⚡ Why This Script Is Different
Most tools mark a failed break as a single event.
This script does NOT stop at the failed-break label, does not clone a Swing Failure Pattern engine, and does not become a generic breakout-failure signal board.
Instead, it evaluates the recovery path after the failure. The main output is a recovery state: Recovery Active, Recovery Watch, Failure Confirmed, Reclaim Pending, Window Decaying, or No Active Failure.
⚙️ Methodology
1. Context Detection
The script builds a recent range from prior bars and checks whether price probes beyond the upper or lower boundary before closing back inside.
2. Reference Mapping
When a failed break appears, it maps the failure box, reclaim trigger, and risk shelf around the failed boundary.
3. Reaction Evaluation
The model scores close-back-inside quality, reclaim speed, retest response, volume behavior, and time decay.
4. Visual Output
The result is shown through centered failure-box text, a centered risk-shelf label, reclaim/reject labels, alert conditions, and a clean AGPro planning panel.
🗺️ How to Read the Chart
Failure Box = the failed-break excursion outside the recent range.
Reclaim Trigger = the level that shows the original breakout attempt is trying to recover.
Risk Shelf = the boundary zone where retest response should be reviewed.
Labels = compact markers for failed break, reclaim, reject, decay, and watch context.
Colors = teal highlights constructive recovery context, pink highlights failure or rejection pressure, amber highlights shelf review, and indigo highlights watch states.
Panel = summarizes Failure State, Recovery Score, Reclaim Level, Risk Zone, and Action.
🚦 Signals & States
• Failed Breakout Detected → price probed outside the recent range and closed back inside.
• Recovery Watch → recovery conditions are developing, but reclaim confirmation is incomplete.
• Recovery Active → reclaim behavior and the Recovery Score have reached stronger review context.
• Failure Confirmed → price rejects the failed boundary or moves deeper back into the range.
• Reclaim Pending → an active failure exists, but recovery conditions are not strong enough yet.
• Window Decaying → the failed-break context is getting old and should carry less weight.
🔔 Alerts Logic
Alerts trigger when a failed breakout is detected, when Recovery Watch appears, when Recovery Active appears, or when Failure Confirmed appears.
Alerts are attention markers only. They are not trade instructions, entry commands, exit commands, or automated strategy rules.
🧩 Confluence Logic
The strongest recovery context appears when price closes back inside the range, reclaims the failed boundary quickly, shows a constructive retest response, receives supportive volume, and does not lose too much time after the failed break.
When these components weaken, the script can shift toward Reclaim Pending, Window Decaying, or Failure Confirmed.
📊 When to Use
• After a breakout attempt closes back inside a recent range
• During range-bound markets with frequent boundary tests
• Around failed expansion attempts where reclaim quality matters
• When deciding whether a failed breakout deserves continued monitoring
• On liquid symbols where range, volume, and candle behavior are readable
⚠️ When NOT to Use
• Very low-liquidity symbols with unstable candles
• Extremely noisy micro-timeframes
• News-driven spikes where levels lose structure quickly
• Markets with unreliable volume data
• Situations where the user expects a direct signal-only tool
🎛️ Key Inputs
• Failure Range Lookback → controls the recent range used to detect failed breaks.
• Failure Probe ATR → defines how far price must probe beyond the range boundary.
• Recovery Window Bars → controls how long the failed-break recovery window stays relevant.
• Retest / Shelf ATR → controls risk shelf thickness and boundary response tolerance.
• Recovery Active Threshold → sets the minimum score for the strongest recovery state.
• Label and Panel Font Size → controls chart labels, centered zone text, and panel readability.
🖥️ Interface & Visual Design
The interface is designed to stay chart-first.
The failure box gives the visual story. The reclaim trigger and risk shelf define the practical review frame. Labels remain compact and controlled so the chart stays active without becoming crowded.
The AGPro panel uses a merged blue title row and a compact decision layout for fast reading.
🧪 Practical Usage Workflow
1. Read the panel state and Recovery Score.
2. Check the failure box and failed boundary.
3. Compare price behavior against the reclaim trigger.
4. Review the risk shelf and rejection response.
5. Treat alerts as attention markers, then evaluate broader market context.
🔍 Interpretation Guidelines
Think in terms of failed-break lifecycle, not prediction.
A stronger Recovery Score means the failed breakout is attempting to reclaim quickly with better response and participation. A weaker score means the failure may be aging, rejecting, or losing structural quality.
Failure Confirmed does not mean the market must continue in one direction. It means the failed-break attempt is not recovering cleanly within the current rule set.
🚫 What This Script Is NOT
• Not a prediction engine
• Not financial advice
• Not auto trading
• Not guaranteed signals
• Not a generic failed-break signal
• Not a Swing Failure Pattern clone
⚠️ Limitations & Transparency
The script is rule-based and depends on recent price, volatility, range, volume, and candle behavior.
Different timeframes can change how failure and recovery appear. Volatility spikes can temporarily distort boundary behavior. Symbols with unreliable volume may produce weaker participation readings.
Outputs should always be interpreted with broader market structure, liquidity, and risk context.
🧠 Market Context Notes
Failed breakouts are most useful when the boundary is readable and the follow-up reaction is clear.
A quick reclaim can show that the failed attempt is recovering. A weak retest, slow response, or deep move back into the range can show that the failed break is confirming instead.
🧾 Use Case Examples
When price probes above a range, closes back inside, then quickly reclaims the upper boundary with supportive volume, the planner may classify the context as Recovery Active.
When price probes above a range, closes back inside, retests the boundary from below, and rejects again, the planner may classify the context as Failure Confirmed.
🧱 System Philosophy
AGPro planning tools are designed to help traders evaluate context before reacting.
This script follows that philosophy by turning failed breakouts into a structured decision question: is the attempt recovering, aging, or confirming failure?
🔐 Non-Promise Statement
No indicator can provide certainty.
This tool provides structured visual context and rule-based attention markers. It does not guarantee continuation, reversal, recovery, or rejection.
📉 Risk Disclosure
Trading involves risk. Market conditions can change quickly, and no script can remove uncertainty.
Users are responsible for their own analysis, risk management, and decisions.
This script is for educational and analytical use only and does not provide financial advice.
📚 Educational Note
Use the planner to study how failed breakouts behave after the first rejection, how reclaim speed affects context, and how risk shelves help organize post-failure review.
Indicator
Range Expansion Risk Planner [AGPro Series]Range Expansion Risk Planner
🧠 Core Idea
Does a range expansion offer clean room, or is price moving into immediate failure risk?
📌 Overview / What it does
Range Expansion Risk Planner is a chart-first breakout quality and risk-planning tool built for one specific moment: price has left a defined range, and the trader needs to understand whether the expansion has enough structure to deserve attention.
Instead of printing generic breakout signals, the script maps the source range, freezes the broken edge, builds an expansion runway, tracks a failure rail, estimates target room, evaluates retest behavior, and converts those conditions into a 0-100 planner score.
The script produces a source range box, expansion runway, failed-expansion review band, risk/target rails, full-state labels, deterministic alerts, and a clean AGPro panel. It does not predict future price movement, automate execution, or guarantee that a breakout will continue.
🎯 Purpose & Design Philosophy
This script was built for traders who want to evaluate range expansion quality after price leaves a structure, not simply react to the first candle outside the range.
Many tools mark breakouts, draw range boxes, or highlight volatility expansion. The gap is the planning layer after the break: Is the source range mature? Was the expansion candle strong enough? Did price close clearly beyond the edge? Is the retest accepted or weak? Is there enough room before the next target-side reference?
The design supports a decision-first workflow. It helps users separate a clean range expansion from a weak release, blocked room, failed expansion, or early unconfirmed movement.
⚡ Why This Script Is Different
Most tools focus on breakout arrows, range highs/lows, volatility spikes, or support/resistance zones.
This script does NOT become a generic range breakout signal, a generic S/R zone map, a squeeze indicator, or a target predictor.
Instead, it evaluates the quality of the expansion plan after the range edge is broken. The main output is not a trade command. It is a planning state that helps the user decide whether the current expansion is CLEAN, on REVIEW, waiting for retest, blocked by room risk, or failing back into the source range.
⚙️ Methodology
1. Context Detection
The script maps the active source range using a user-defined lookback and detects whether price has closed beyond the upper or lower edge with enough ATR-normalized distance.
2. Reference Mapping
When a qualified expansion appears, the script freezes the source range, the broken edge, the failure rail, and the target-room marker so the plan can be reviewed consistently.
3. Reaction Evaluation
The model scores range maturity, expansion candle quality, close beyond edge, retest quality, target-room distance, and failure-rail distance.
4. Visual Output
The result is displayed through a source range box, expansion runway, failed-expansion band, risk/target rails, full-state event labels, alerts, and a premium AGPro panel.
🗺️ How to Read the Chart
Zones = the source range shows where the expansion came from. The expansion runway shows the path between the broken edge and the target-room marker. The failed-expansion band shows the area where the release may be losing structure.
Labels = full-state markers show Range Expansion, Clean Expansion, Expansion Review, Retest Accepted, Failed Expansion, Target Room Reached, Failure Risk, or Range Watch context.
Colors = teal highlights cleaner bullish expansion, pink highlights bearish or failed contexts, amber highlights review/risk states, and indigo highlights watch or target-edge states.
Panel = the panel summarizes Range Maturity, Expansion Risk, Room Risk, Confirmation, and Action.
🚦 Signals & States
• CLEAN EXPANSION → range expansion quality is strong enough to deserve active review.
• REVIEW → expansion context is developing, but confirmation or target room is incomplete.
• WAIT RETEST → price has expanded, but the broken edge has not yet been accepted clearly.
• ROOM BLOCKED → target-side room is limited relative to the current risk structure.
• FAILURE RISK → price is back inside the range or close to the failed-expansion area.
• FAILED → price crossed the failure rail and the prior expansion plan should be reviewed.
• TARGET EDGE → price reached the active target-room marker.
• RANGE WATCH → the range is mature enough to monitor, but no qualified expansion is active yet.
🔔 Alerts Logic
Alerts trigger when the planner enters clean expansion, review state, retest accepted state, failed-expansion warning, or target-room reached state.
These alerts are attention markers only. They are not trade instructions, entry signals, automated strategy commands, or guaranteed outcomes.
🧩 Confluence Logic
The strongest context appears when a mature source range releases with a strong expansion candle, price closes clearly beyond the edge, target-side room remains open, the failure rail is not too far away, and the broken edge receives constructive retest behavior.
When those components align, the planner score improves and the action state becomes cleaner.
📊 When to Use
• After price leaves a clear range
• During breakout-review workflows
• When comparing whether a release has enough room to justify attention
• When price retests the broken range edge
• On liquid symbols where ATR, range, and volume behavior are readable
• Especially on 4H swing charts, where range release, retest behavior, failure risk, and target-room context remain visually readable
⚠️ When NOT to Use
• Extremely low-liquidity symbols
• Very noisy micro-timeframes
• News-driven candles that distort the range edge
• Markets with frequent gaps or unreliable volume
• Situations where the user expects a simple buy/sell signal
🎛️ Key Inputs
• Expansion Side → controls Auto, Long Expansion, or Short Expansion planning.
• Sensitivity → changes how selective the range maturity and edge-close requirements are.
• Source Range Lookback → defines the range used before expansion.
• ATR Length → normalizes failure rail, label spacing, expansion distance, and room risk.
• Retest Review Bars → controls how long an edge retest can improve confirmation quality.
• Target-Side Obstacle Lookback → searches for older target-side references before using the measured target.
• CLEAN / REVIEW Scores → adjust how strict the state model is.
• Visual settings → control boxes, runway, rails, labels, panel location, theme, and font sizes.
🖥️ Interface & Visual Design
The interface is built around one primary decision path: source range → expansion runway → failure rail → target room.
The panel uses the AGPro public-release standard with one merged blue header row containing only the script name. It keeps the decision fields readable without turning the chart into a crowded dashboard.
Labels keep full professional state names, are offset away from candles, and are limited by cooldown and max-visible controls.
🧪 Practical Usage Workflow
1. Read the panel action state.
2. Check whether the source range was mature enough before expansion.
3. Review the expansion runway and target-room marker.
4. Check whether price accepted the broken edge or moved back into failure risk.
5. Use alerts as attention markers, then evaluate the broader market context.
🔍 Interpretation Guidelines
A higher score means the model sees better alignment between source range quality, expansion candle quality, edge close, retest behavior, and target room.
CLEAN EXPANSION does not mean a trade must be taken. It means the expansion structure is clean enough to deserve active review.
REVIEW means the release may be developing, but the user should check confirmation and room quality before treating it as clean.
FAILED and FAILURE RISK are caution states. They help identify when an expansion is losing structure after leaving the range.
🚫 What This Script Is NOT
This script is not a prediction engine.
It is not financial advice.
It is not an auto-trading system.
It does not provide guaranteed signals.
It does not replace user judgment, risk management, or broader market analysis.
⚠️ Limitations & Transparency
Timeframe differences can change how range maturity, retests, and target-room references appear.
Volatility changes can widen failure rails or reduce clean target room.
Fast market conditions can move from CLEAN to FAILED quickly if price returns into the source range.
The script is rule-based and should be interpreted as an analytical planning layer, not as certainty.
🧠 Market Context Notes
Range expansion quality is not only about breaking the edge. A cleaner expansion usually needs a readable source range, a decisive close beyond the edge, enough room before obstruction, and a failure reference that is not too wide.
The planner is most useful when it prevents users from treating every breakout as equal.
🧾 Use Case Examples
When price closes beyond a mature range and the target-room marker remains far enough away, the planner may move into REVIEW or CLEAN EXPANSION.
When price retests the broken edge and holds outside the range, confirmation can improve.
When price closes back through the failure rail, the planner marks FAILED so the old expansion idea is not treated as clean anymore.
🧱 System Philosophy
Range Expansion Risk Planner follows the AGPro Series decision-engine approach:
Context first.
Risk before reaction.
Structure before signal.
Attention markers instead of promises.
🔐 Non-Promise Statement
No indicator can remove uncertainty.
No score, state, label, alert, range box, runway, or rail should be interpreted as guaranteed market direction.
📉 Risk Disclosure
Trading involves risk.
All decisions remain the responsibility of the user.
This script is for educational and analytical chart review only and does not provide financial advice.
📚 Educational Note
Use this script to study how range expansions develop, how broken edges behave after release, and how failure risk can be organized visually before making discretionary decisions.
Indicator
Breakout Retest Readiness [AGPro Series]Breakout Retest Readiness
🧠 Core Idea
Is the post-breakout retest being accepted with structure, or is the breakout losing quality at the risk edge?
📌 Overview / What it does
Breakout Retest Readiness is a chart-first planning tool built to evaluate what happens after a confirmed breakout and after price starts interacting with the retest pocket.
The script maps the broken structure level, builds a retest pocket around it, places a risk-edge shelf beyond the pocket, and projects a target-room guide for context. It then scores the active retest environment with a 0-100 Acceptance Score and displays a clear next-action state in the AG Pro panel.
This script does not predict continuation. It does not automate entries. It is designed to organize post-breakout retest context so traders can review acceptance, rejection, risk edge, and plan quality in a cleaner way.
🎯 Purpose & Design Philosophy
Most breakout tools focus on the moment price crosses a level. In practice, many useful decisions happen after the break, when price returns toward the broken level and either accepts it or fails around it.
This script was built for traders who want a structured retest planning layer rather than another basic breakout marker. It supports a patient workflow: wait for structure, observe the pocket, evaluate acceptance, and review risk before reacting.
The design philosophy is simple: the chart should answer what state the retest is in, how strong the acceptance context is, where risk is being tested, and what the next review step should be.
⚡ Why This Script Is Different
Most tools focus on detecting a breakout or grading the first retest as a standalone signal.
This script does NOT try to clone a classic break-retest quality grader, and it does not print simple buy or sell commands.
Instead, it works as a post-breakout readiness planner. It arms a retest pocket after a confirmed breakout, waits for price to interact with that pocket, evaluates acceptance versus rejection, tracks the risk edge, and keeps the next-action state visible in the panel.
The difference is the decision layer. The script is less about saying "a retest happened" and more about answering whether the active retest environment is constructive enough to keep reviewing.
⚙️ Methodology
1. Context Detection
The script identifies a confirmed break beyond recent structure using a prior high or prior low reference. The breakout must clear the structure by an ATR-normalized buffer so minor pokes are filtered.
2. Reference Mapping
After a valid break, the script stores the breakout line, builds a retest pocket around it, places an invalidation shelf beyond the broken level, and projects a target-room guide from the prior structure range.
3. Reaction Evaluation
When price interacts with the retest pocket, the script evaluates breakout quality, retest depth, wick rejection, volume change, and trend agreement. These components combine into a 0-100 Acceptance Score.
4. Visual Output
The chart shows the active retest pocket, breakout line, risk edge, target guide, compact event labels, and the AG Pro panel. The panel summarizes retest state, acceptance score, breakout quality, risk edge, and action.
🗺️ How to Read the Chart
Retest Pocket = the zone around the broken structure level where price is being evaluated after the breakout.
Breakout Line = the structure level that was crossed and now anchors the retest plan.
Risk Edge = the invalidation shelf beyond the retest pocket. It is a planning reference, not a stop recommendation.
Target Guide = a target-room marker projected from the prior range. It is context only, not a forecast.
Labels = compact state markers such as ARMED, TEST, ACCEPT, REJECT, RISK EDGE, or EXPIRE.
Colors = bullish retest plans use the AGPro teal tone, bearish plans use the AGPro pink tone, watch states use indigo or amber, and risk conditions use red.
Panel = the main decision interface showing retest state, acceptance score, breakout quality, risk edge, and next action.
🚦 Signals & States
• Breakout Armed → a breakout retest plan has been created after price cleared structure.
• Testing Pocket → price is interacting with the active retest pocket and acceptance is being evaluated.
• Accepted Retest → the retest has held the pocket with enough acceptance quality to deserve review.
• Rejected Retest → the retest has failed around the pocket and quality has weakened.
• Risk Edge Hit → price has moved beyond the mapped risk shelf.
• Expired → the retest window aged out before a constructive interaction.
🔔 Alerts Logic
Alerts are available for breakout plan arming, retest pocket interaction, accepted retest readiness, rejected retest or risk-edge pressure, and expired retest plans.
Each alert is an attention marker. Alerts do not represent trade instructions, guaranteed outcomes, or automated strategy decisions.
🧩 Confluence Logic
The strongest acceptance context appears when the breakout quality, retest depth, wick rejection, volume behavior, and trend agreement support the same side.
When these components align, the retest score improves. When the pocket is too deep, volume behavior is poor, trend context disagrees, or the risk edge is pressured, the readiness state weakens.
📊 When to Use
• After clean breakouts from recent structure
• During trend continuation review
• When price returns toward a broken level
• When the trader wants to separate constructive retests from weak post-break reactions
• On liquid symbols where structure, volume, and candle behavior are readable
⚠️ When NOT to Use
• Extremely low-liquidity instruments
• Highly noisy lower timeframes
• News-driven volatility spikes
• Markets with no clear structure reference
• Situations where the breakout level is too close to major external obstruction
🎛️ Key Inputs
• Breakout Structure Lookback → controls the prior structure reference used for breakout detection.
• Maximum Bars To Retest → controls how long the script waits for the retest pocket to matter.
• Sensitivity → adjusts how strict the breakout and acceptance model should be.
• Minimum Acceptance Score → defines the score needed before accepted readiness can appear.
• Retest Pocket Width ATR → controls the width of the post-breakout pocket.
• Invalidation Shelf ATR → controls the mapped risk-edge distance beyond the broken level.
• Target Guide Range Multiple → controls the forward target-room guide.
• Visual Settings → control pockets, lines, labels, label density, label size, and forward rendering.
• Panel Settings → control panel visibility, location, theme, and font size.
🖥️ Interface & Visual Design
The interface is built around a clean AG Pro panel and one main chart object family: the retest pocket.
The pocket label is centered inside the zone so the active state is visible without needing extra clutter. The breakout line, invalidation shelf, and target guide create a simple visual hierarchy: level, risk, and room.
Labels are intentionally compact and controlled by cooldown and maximum-visible settings so the chart remains active without becoming crowded.
🧪 Practical Usage Workflow
1. Read the panel state.
2. Locate the active retest pocket.
3. Check whether price is testing, accepting, rejecting, or pressing the risk edge.
4. Compare the Acceptance Score with the breakout quality.
5. Use the action row as a review prompt, not as an instruction.
🔍 Interpretation Guidelines
The Acceptance Score should be read as context quality, not certainty.
A higher score means the current retest has cleaner structural behavior under the script's rules. A lower score means the retest is less constructive, too deep, poorly supported, or not aligned with trend context.
The Risk Edge matters because a retest can look acceptable for a few bars and still lose structure if price pushes beyond the invalidation shelf. The panel keeps that condition visible.
🚫 What This Script Is NOT
This script is not a prediction engine.
This script is not financial advice.
This script is not an auto-trading system.
This script does not provide guaranteed signals.
This script is not a generic support and resistance map.
This script is not a clone of a first-retest grading tool.
⚠️ Limitations & Transparency
The script is rule-based and depends on the selected lookback, timeframe, and market structure.
Different symbols can produce different retest behavior. Lower timeframes may show more noise. Higher timeframes may produce fewer but stronger events.
Volatility changes can affect pocket size, risk-edge distance, and event frequency. Users should interpret every output within broader market context.
🧠 Market Context Notes
Breakout retests are most useful when structure is clear, liquidity is sufficient, and price has enough room to continue without immediate obstruction.
Volume behavior can add context, but volume data quality varies across markets. When volume is unreliable, the script treats that component more neutrally.
The retest pocket is not a guaranteed support or resistance zone. It is a structured review area around the broken level.
🧾 Use Case Examples
When price breaks above recent structure and later returns to the pocket with a controlled pullback, the script can mark the retest as Testing Pocket or Accepted Retest depending on score quality.
When price breaks below structure but quickly pushes back above the pocket and pressures the mapped risk edge, the script can mark rejection or risk-edge pressure.
When a breakout never returns to the pocket within the selected time window, the script can expire the plan instead of keeping old context alive.
🧱 System Philosophy
AGPro tools are designed to support structured chart reading. The goal is not to add more random signals, but to turn market behavior into clearer states, cleaner context, and better review discipline.
Breakout Retest Readiness follows that philosophy by turning a common post-breakout question into a visible planning workflow.
🔐 Non-Promise Statement
No script can confirm future price direction with certainty.
This tool organizes retest context. It does not promise continuation, reversal, profit, or accuracy.
📉 Risk Disclosure
Trading involves risk.
All outputs from this script are educational and analytical in nature.
Users are responsible for their own decisions, risk management, position sizing, and market interpretation.
This script does not provide financial advice.
📚 Educational Note
Use the script to study how breakouts behave after price returns to the broken level. The most useful insight is often not the breakout itself, but how the market reacts when the level is tested again.
Indicator
1-2-3 Reversal Map [AGPro Series]1-2-3 Reversal Map
🔹 OVERVIEW
1-2-3 Reversal Map is a focused PulseWire overlay built for traders who want a clean, structured way to follow one of the most recognizable reversal formations in price action: the confirmed 1-2-3 reversal.
This tool maps the full life cycle of a 1-2-3 structure. It identifies the confirmed swing sequence, marks Point 1, Point 2, and Point 3, projects the neckline from Point 2, evaluates the neckline break, and highlights the retest pocket after confirmation. The goal is not to fill the chart with generic reversal signals. The goal is to make the actual 1-2-3 process easier to see, compare, and track.
The script is designed around visual clarity. The latest active structure stays readable through numbered swing labels, restrained guide lines, a clearly identified neckline, and a concept-specific retest pocket. The panel then summarizes the current stage, neckline status, retest status, and reversal score in a compact AG Pro layout.
🔹 WHAT MAKES IT DIFFERENT
Most reversal tools try to do too many things at once. They mix candle patterns, double tops, double bottoms, head and shoulders structures, failed breakouts, generic support and resistance zones, trend filters, and broad reversal markers into one crowded chart.
1-2-3 Reversal Map takes a more disciplined approach. It stays inside one lane: the confirmed 1-2-3 reversal sequence.
The script does not mark every possible turning point. It waits for a defined swing chain:
1. Point 1 establishes the original swing extreme.
2. Point 2 forms the neckline reference.
3. Point 3 confirms that price has created a structurally relevant retracement.
4. The neckline break turns the structure from a setup into a confirmed map.
5. The retest pocket shows where the broken neckline can be evaluated again.
This creates a cleaner workflow than broad reversal scanners. Instead of asking the chart to show everything, the script asks one focused question: has a valid 1-2-3 structure progressed from swing formation to neckline break and retest behavior?
🧭 WHY THIS DOES NOT OVERLAP WITH OTHER AGPRO TOOLS
This script was intentionally built to avoid overlapping with other AGPro public tools.
It is not a broad reversal pattern scanner. It does not combine double top, double bottom, head and shoulders, inverse head and shoulders, wedge, or candle-pattern logic. It focuses only on the 1-2-3 reversal sequence.
It is not a Turtle Soup or failed-breakout tool. It does not begin with a failed range break or liquidity sweep. Its starting point is a confirmed three-point swing structure.
It is not a wedge reversal tool. It does not evaluate converging trendlines, compression geometry, or wedge breakout behavior.
It is not a generic support and resistance map. The rectangle is not a general zone engine. It is a neckline retest pocket that appears only after a valid 1-2-3 neckline break.
It is not a breakout dashboard. Breakout logic exists only as one stage inside the 1-2-3 reversal process.
This makes the script narrow enough for a differentiated AGPro release while still being visually useful and searchable for traders who specifically look for 1-2-3 reversal structure, neckline break, and retest confirmation workflows.
⚙️ METHODOLOGY
The script uses confirmed pivot structure to define each 1-2-3 sequence.
For a bullish 1-2-3 structure:
- Point 1 is a confirmed swing low.
- Point 2 is the recovery swing high and neckline reference.
- Point 3 is a higher low that holds above Point 1.
- The neckline break requires price to close beyond Point 2 with a configurable ATR buffer.
- The retest pocket is projected around the broken neckline after confirmation.
For a bearish 1-2-3 structure:
- Point 1 is a confirmed swing high.
- Point 2 is the reaction swing low and neckline reference.
- Point 3 is a lower high that holds below Point 1.
- The neckline break requires price to close beyond Point 2 with a configurable ATR buffer.
- The retest pocket is projected around the broken neckline after confirmation.
The reversal score is structure-native. It evaluates:
- P1-P2 leg size relative to ATR
- Point 3 hold quality
- P3 retracement balance
- Timing symmetry between structure legs
- Break distance beyond the neckline
- Break candle body quality
- Close location inside the break candle
- Optional volume participation
The score is not designed as a prediction model. It is a ranking layer for comparing the quality of structures that meet the script's own rules.
📊 PANEL
The AG Pro panel is built to keep the structure status readable without forcing the user to interpret every chart object manually.
Panel rows:
- Stage: shows whether the structure is waiting, armed, broken, retested, expired, or invalidated.
- Neckline Break: shows whether the neckline has been confirmed.
- Retest: shows whether the retest pocket is inactive, being watched, or held.
- Reversal Score: shows the current 0-100 score and quality grade.
The panel uses the AGPro standard format:
- One merged blue header row
- Only the script name in the first row
- Adjustable panel location
- Adjustable panel theme
- Adjustable panel font size
🎛️ KEY INPUTS
Pivot Left Bars / Pivot Right Bars:
Controls how mature the swing points must be before the 1-2-3 structure can form. Higher values create fewer and cleaner structures. Lower values make the script more responsive.
Minimum P1-P2 Leg ATR:
Filters out small structures by requiring a minimum distance between Point 1 and Point 2.
Minimum Point 3 Hold ATR:
Defines how much Point 3 must hold relative to Point 1. This helps separate valid structural retracements from weak retests of the original extreme.
Minimum / Maximum P3 Retracement:
Controls the acceptable retracement range for Point 3. This prevents both shallow noise and near-failed structures from being accepted too easily.
Neckline Break Buffer ATR:
Adds a configurable buffer beyond the neckline before the break is accepted.
Retest Pocket Width ATR:
Controls the height of the retest pocket around the broken neckline.
Retest Pocket Projection Bars:
Controls how far the pocket is projected forward.
Show Context Tags:
Adds compact labels such as Neckline and Retest Pocket so the visual elements are easier to identify.
Show Recent Structure Traces:
Keeps a small rolling set of recent structure lines and pockets while keeping numbered swing labels focused on the latest active setup.
Label Font Size:
Controls all chart labels, including swing numbers, context tags, and optional event labels.
Panel Font Size:
Controls the AG Pro panel text size separately from chart labels.
🔍 HOW TO READ IT
Start with the numbered swing labels.
Point 1 marks the original structural extreme. Point 2 marks the neckline reference. Point 3 marks the retracement that must hold for the 1-2-3 structure to remain valid.
Next, watch the neckline.
The neckline is the main confirmation level. Before it breaks, the panel shows the structure as armed or waiting. After it breaks, the structure becomes a confirmed 1-2-3 map.
Then watch the retest pocket.
The retest pocket appears around the broken neckline after confirmation. This is the script's key context zone. It helps the user observe whether price can return to the neckline area and hold the structure instead of treating every move after the break as equally important.
Finally, use the panel score as a quality filter.
A high score means the structure has stronger internal balance according to the script's rules. A lower score means the 1-2-3 sequence may still exist, but its structure quality is weaker.
🧩 BEST USE CASES
This script is best suited for:
- Traders who use classic 1-2-3 reversal logic
- Swing traders who want confirmed pivot structure
- Price-action traders who track neckline breaks
- Traders who prefer breakout-retest workflows
- Users who want fewer, clearer chart objects instead of broad reversal scanners
- Multi-timeframe chart review where structure clarity matters
- Public chart sharing where visual cleanliness is important
It can be useful on crypto, forex, indices, equities, and commodities, especially on charts where swing structure and neckline behavior are visually meaningful.
🧠 VISUAL DESIGN PHILOSOPHY
The design goal is clarity through restraint.
The script avoids a crowded signal-board style. It uses numbered labels only for the current active swing structure. It separates the neckline from the retest pocket with distinct visual language. Recent traces are kept limited and softened so they provide context without dominating the chart.
The active neckline is drawn with a stronger accent color. The retest pocket is shown as a clean rectangle around the broken neckline. Structure legs are dotted and restrained, helping the user understand the geometry without overpowering price.
The chart should feel premium, readable, and publication-ready. The indicator is built to support a clean PulseWire screenshot rather than create visual noise.
🔔 ALERTS
The script includes alerts for the main 1-2-3 lifecycle events:
- 1-2-3 structure armed
- Bullish 1-2-3 neckline break
- Bearish 1-2-3 neckline break
- 1-2-3 retest pocket held
- 1-2-3 structure invalidated
These alerts are designed around structure progression, not generic reversal marking.
🔹 LIMITATIONS AND TRANSPARENCY
The script uses confirmed pivots, which means swing points appear only after the required right-side confirmation bars. This is intentional. It prioritizes confirmed structure over instant but unstable markings.
The script does not attempt to identify every possible reversal pattern. It does not evaluate macro trend, fundamentals, order flow, news, or external liquidity conditions.
The reversal score is a structured quality model, not a certainty model. It helps compare 1-2-3 structures inside this script's framework, but it does not forecast outcomes.
Retest pockets are contextual areas around the broken neckline. They are not universal support or resistance zones, and they are not designed to replace broader market analysis.
✅ IDEAL USER
This script is ideal for traders who:
- Understand classic 1-2-3 reversal structure
- Prefer confirmed market structure over early noise
- Want a clean neckline and retest workflow
- Value visual clarity and chart discipline
- Use PulseWire for structured price-action review
- Want a focused public-free AGPro tool that does one concept well
1-2-3 Reversal Map is built for users who want a focused reversal map, not a crowded reversal scanner.
🔹 RELEASE NOTES
- Initial public release of 1-2-3 Reversal Map .
- Added confirmed Point 1, Point 2, and Point 3 swing mapping.
- Added neckline projection with close-based break confirmation.
- Added breakout retest pocket around the broken neckline.
- Added context tags for Neckline and Retest Pocket.
- Added AG Pro panel with Stage, Neckline Break, Retest, and Reversal Score.
- Added adjustable panel location, panel theme, label size, and panel font size.
- Added recent structure traces with softened historical visuals.
- Added alerts for armed structures, neckline breaks, retest holds, and invalidations. Indicator
Triangle Breakout Quality [AGPro Series]Triangle Breakout Quality
🔺 OVERVIEW
Triangle Breakout Quality is built for one of the most searched and visually recognizable chart structures in technical analysis: the triangle breakout.
The script automatically detects triangle candidates from confirmed pivot highs and pivot lows, projects the upper and lower converging boundaries, measures how much the structure has compressed, locates the projected apex, and grades the quality of the eventual breakout. After the release, it monitors the first return toward the broken triangle boundary so the user can see whether price accepted the breakout or quickly lost structural quality.
The goal is not to mark every small consolidation or every trendline touch. The goal is to isolate the full triangle sequence:
Formation -> compression -> apex pressure -> boundary release -> first retest state.
That full lifecycle is what gives the tool its own identity. A triangle is not just a range, not just a single diagonal line, and not just a breakout candle. It is a narrowing structure where both sides of price are being compressed into a decision point. This script is designed around that idea from the ground up.
🔹 WHAT MAKES IT DIFFERENT
Most triangle tools stop at drawing two lines. Most breakout tools stop at the first candle outside a boundary. Triangle Breakout Quality does more by turning the structure into a scored, state-aware workflow.
Core differentiators:
• Dual-boundary validation
The script requires both an upper pivot boundary and a lower pivot boundary. The two lines must converge. This prevents the logic from acting like a generic trendline-break detector.
• Compression measurement
The engine compares the opening width of the triangle with the current width. A pattern must show meaningful narrowing before it can qualify.
• Apex pressure logic
The script projects where the upper and lower boundaries intersect and evaluates whether the current structure is close enough to that decision zone to matter.
• Breakout quality score
Every displayed breakout receives a 0-100 score based on compression, apex pressure, breakout distance, candle body participation, close quality, and optional volume expansion.
• Retest state
After a breakout, the script watches the first return toward the broken triangle boundary. A held retest and a failed retest are visually different states, not the same event.
• Premium visual restraint
The chart shows active triangle lines, controlled breakout labels, optional retest labels, subtle candle tint, and a compact AGPro panel. Label density is capped so the layout stays clean for live use and publication screenshots.
🧭 WHY THIS DOES NOT OVERLAP WITH OTHER AGPRO TOOLS
This script is intentionally separated from the existing AGPro breakout and structure family.
It is not Break-Retest Quality, because it does not begin with a horizontal pivot break and then grade the first retest of that static level. Triangle Breakout Quality first requires a valid converging triangle structure.
It is not Failed Break Quality, because it is not centered on false breaks and reclaim behavior. It tracks the primary breakout from a valid triangle and then monitors the first boundary retest.
It is not Consolidation Breakout Quality, because the reference structure is not a horizontal range. A triangle must have two projected pivot boundaries that move toward each other.
It is not Donchian Breakout Quality, because it is not based on period highs and lows or channel escape logic.
It is not ATR Envelope Breakout Quality, because it does not use a volatility envelope as the breakout shell.
It is not Auto Trendline Break Quality, because it does not score isolated trendline breaks. The event only matters when the upper and lower lines together form a valid triangle compression structure.
That distinction matters visually and analytically. On the chart, this script tells a triangle story: converging boundaries, apex pressure, breakout quality, and retest state. It belongs in the chart-pattern lane, not the generic breakout lane.
⚙️ METHODOLOGY
1. Pivot anchors
The script uses confirmed pivot highs and pivot lows to define the latest upper and lower triangle boundaries. This keeps the structure rules transparent and reproducible.
2. Convergence filter
The upper boundary and lower boundary must move toward each other. The current width of the pattern must be smaller than the starting width, and the compression percentage must meet the selected threshold.
3. Width and maturity filters
The pattern must be old enough to represent a real structure, but not so old that it becomes stale. The starting width and current width are also normalized by ATR so the same logic can adapt across symbols and timeframes.
4. Apex projection
The script calculates where the two projected boundaries intersect. This creates the apex pressure layer, which helps separate mature triangle compression from loose diagonal movement.
5. Breakout confirmation
A bullish breakout requires price to close beyond the projected upper boundary by an ATR-normalized buffer. A bearish breakout requires price to close beyond the projected lower boundary by the same type of buffer.
6. Quality score
The breakout score combines:
• Compression quality
• Apex pressure
• Breakout distance beyond the boundary
• Candle body participation
• Close position inside the breakout candle
• Optional volume participation
The result is displayed as a compact grade and score so the chart remains readable.
7. Retest state
After a breakout, the script projects the broken triangle boundary forward internally and evaluates an ATR-scaled retest tolerance around it. If price revisits that boundary area and holds the correct side, the retest is marked as held. If price loses the boundary, the retest state is marked as failed.
📊 PANEL
The AGPro panel summarizes the current structure and latest event:
• Pattern Age
• Compression
• Apex Pressure
• Breakout Side
• Retest Quality
• Current State
Panel location, theme, and font size are adjustable. The first row follows the AGPro publication standard: one merged blue header row containing only the panel title.
🎛️ KEY INPUTS
Triangle Structure
• Pivot Length
• Minimum Pattern Age
• Maximum Pattern Age
• Minimum Compression %
• Minimum Starting Width ATR
• Maximum Current Width ATR
• Maximum Forward Apex Bars
Breakout Quality
• ATR Length
• Volume Average Length
• Use Volume Participation
• Volume Full-Score Ratio
• Minimum Break Distance ATR
• High Quality Threshold
• Minimum Label Score
• Visual Cooldown Bars
Retest State
• Retest Minimum Bars
• Retest Window Bars
• Retest Tolerance ATR
Visual Controls
• Show Triangle Lines
• Show Breakout Labels
• Show Retest Labels
• Tint Breakout Candles
• Label Offset ATR
• Label Font Size
• Maximum Visible Events
Panel
• Show Panel
• Panel Position
• Panel Theme
• Panel Font Size
🔍 HOW TO READ IT
When a valid triangle is forming, the chart displays the converging upper and lower boundaries. The panel reports apex pressure and compression so the projected decision area is visible without adding extra rectangles to the chart. Compression shows how much the pattern has tightened relative to its opening width.
When price closes beyond a valid boundary, the script prints a compact breakout label with a quality grade and score. A higher score means the breakout candle carried stronger structural qualities according to the script's rules.
After the breakout, retest labels and the panel show whether the first return toward the broken triangle boundary held or failed. A held retest suggests cleaner acceptance of the breakout boundary. A failed retest suggests the release lost quality.
Use the tool as a structured chart-reading layer. It is designed to help users compare triangle breakouts by quality, not to replace broader context such as trend, liquidity, session behavior, or personal execution rules.
🧩 BEST USE CASES
• Symmetrical triangle compression
• Ascending triangle pressure
• Descending triangle pressure
• Breakout candle quality review
• First retest monitoring after triangle release
• Screenshot-friendly pattern study
• Multi-symbol scanning for cleaner chart-pattern candidates
🔹 LIMITATIONS AND TRANSPARENCY
Triangle detection is based on confirmed pivots, so the final anchor points appear only after the selected pivot length has elapsed. This is standard pivot behavior and keeps the structure rules visible.
The live triangle can change while new pivots form. Breakout and retest labels are event-based and are designed to remain stable after confirmation.
Volume participation is optional because volume quality varies across markets and feeds. On instruments where volume is less informative, the volume component can be disabled.
The score is a structured description of the triangle release according to the script's internal model. It should be read as context, not as an execution command.
Indicator
Indicator
Auto Trendline Break Quality [AGPro Series]Auto Trendline Break Quality
🔹 OVERVIEW
Auto Trendline Break Quality is a structural break-quality engine. It automatically detects bullish and bearish trendlines from swing pivots, monitors every break event in real time, and assigns each break a 0–100 quality score derived from four independent quantitative factors. The tool separates Major (structural) and Minor (tactical) trendlines, so the same break can be evaluated against multiple layers of market structure at once.
The script is purpose-built to answer the single most practical question a price-action trader faces at a trendline break: "Is this break real, or is it a fake-out?"
🧭 UNIQUE EDGE
Most trendline scripts either draw trendlines or flag a break. They stop there. This indicator continues where they stop — and measures the break.
Key differentiators:
• Four-factor composite quality score (Volume · Slope · Impulse · Retest) calibrated to ATR, so the scoring is consistent across assets and timeframes.
• Major/Minor trendline hierarchy. A Major structural break automatically earns a score bonus and is visually flagged with a "MAJ" tag, so structural breaks are never confused with noise breaks.
• State-based visual language. Active trendlines render in a neutral tone. On break, the trendline transitions to the break-direction color (bullish break = bull color, bearish break = bear color), so the chart communicates state without ambiguity.
• Retest logic built directly into the score. A break that is retested and holds within the defined window receives an upgrade; a failed retest downgrades the score. The chart label reflects the final, updated quality.
• Optional zone-band rendering around Major trendlines, letting the user see each structural line as a reaction zone rather than a bare line.
• Label confluence grouping to prevent chart clutter when multiple breaks occur near the same price level.
⚙️ METHODOLOGY
1) Trendline detection
Pivots are identified using standard pivot-high and pivot-low logic with two configurable lookbacks — one for Major trendlines and one for Minor. A new trendline is validated between the two most recent same-side pivots when the slope (ATR-normalized) exceeds the minimum threshold. Nearly-flat trendlines are rejected by design.
2) Break detection
A trendline is considered broken when the current candle closes on the opposite side of the projected line while the previous candle closed on the valid side. This one-bar confirmation rule avoids intra-bar flicker.
3) Quality scoring (0–100)
• Volume expansion vs 20-bar average — up to 25 points
• ATR-normalized slope steepness — up to 20 points
• Break-bar impulse measured in ATR from the line — up to 25 points
• Retest base score — 18 points, upgraded by +15 on a held retest, or reduced by 10 on a failed retest
• Major trendline bonus — +10 points
4) Retest tracking
After a break, the script watches a configurable window (default 3–8 bars) for price to return to the broken trendline within an ATR tolerance. Held retests and failed retests are tracked independently and reflected in the panel's Retest Held Rate. Retest markers are offset from the trendline in ATR units to prevent overlap with candles.
📊 SIGNALS & STATES
• Break label: "BREAK Q: · " and an optional "MAJ" tag for Major trendlines. Label color tier: High quality renders in full state color, Medium quality in neutral amber, Low quality in a muted tone.
• Retest marker: Small circular marker with "retest held" or "retest failed" text, offset from the trendline for clarity.
• Break bar border: Optional candle-border color that reflects break direction.
• Panel: Active trendlines per side, last break score and direction, overall break-direction breakdown, retest held rate, quality distribution (High/Medium/Low), total breaks tracked, and the current detection mode.
• Alerts: "High Quality Trendline Break" and "Major Trendline Break" — both standard alertcondition entries.
🎛️ KEY INPUTS
• Major / Minor Pivot Length — controls how many bars each side of a pivot must be a local extreme.
• Show Minor Trendlines — toggle tactical layer on top of structural layer.
• Max Active Trendlines per Side — caps the chart clutter.
• Volume Spike Threshold (x Avg) — ratio at which a volume expansion is considered full.
• Retest Min/Max Bars — bar range for a valid retest.
• Retest Tolerance (ATR) — how close price must come to the broken line to count as a retest.
• High / Medium Quality Thresholds — cutoffs for the three quality tiers (defaults: 70 / 50).
• Show Trendline Zone Band — renders a subtle ATR-based band around Major trendlines.
• Zone Band Width (ATR) — controls the thickness of the zone band.
• Label Confluence Grouping (ATR) — merges break labels that land within this ATR distance on nearby bars.
• Label Offset (ATR) — vertical padding so labels never embed in candles.
• Label / Panel / Help font sizes — all default to Normal.
• Panel Position and Theme — six positions, Dark/Light theme.
🧩 HOW TO USE
The indicator is a decision-support layer, not a standalone trading system.
• Treat a break with Q ≥ 70 and a "MAJ" tag as a structural event worth reviewing the higher-timeframe bias for.
• Use the retest window as a patience filter. A break with Q 55–69 that retests and holds often upgrades to a higher-quality setup after the retest.
• Failed retests are not "bad" — they are information. A failed retest on a low-quality break is a strong hint that the break was noise.
• The neutral-color active trendlines are intentional — they tell you where structure exists without biasing your read. Color appears only when structure breaks.
• Combine with your own confluence (volume profile, horizontal support/resistance, higher-timeframe trend). The script does not enter trades; it tells you how reliable a break looks at the moment it happens.
⚠️ LIMITATIONS & TRANSPARENCY
• Quality scores describe historical pattern behavior. They are not predictive probabilities.
• Trendlines are generated from pivots; the final pivot is always confirmed after the pivot-length bars have elapsed. This is standard pivot behavior and is not a repaint of historical marks — past labels remain fixed once a break bar closes.
• The script draws up to the platform's line/label limits. Older trendlines are removed when the active cap is reached.
• Parameter defaults target 4H–1D charts; lower timeframes benefit from smaller pivot lengths and tighter retest windows.
📜 RISK DISCLOSURE
This script is an analytical tool. It does not provide financial advice, investment recommendations, or a trading strategy. Past performance of any pattern, including trendline breaks, does not guarantee future results. Always perform your own analysis and apply proper risk management before making any trading decision. Indicator
Kinetic Hull Matrix [JOAT]Kinetic Hull Matrix
Overview
Kinetic Hull Matrix is an adaptive trend-following indicator centred on a Hull Moving Average cloud with ATR-proportional envelopes, a custom ADX engine, a 0–100 composite signal scoring system, and a multi-timeframe trend table — all rendered in a layered fill system that visually communicates trend strength and cloud penetration depth simultaneously. Retest signals fire when price touches the cloud boundary from within the trending direction, scored by four independent quality factors.
The Hull Moving Average — Why It Matters
The Hull Moving Average (HMA) was designed to reduce lag while maintaining smoothness. The calculation uses weighted moving averages at half-length and full-length, doubles the half-length result, subtracts the full-length result (creating a de-lagged series), then applies a final WMA at the square root of the length:
WMA(2 * WMA(src, n/2) - WMA(src, n), sqrt(n))
This produces a moving average that reacts significantly faster to price changes than a standard EMA or SMA of the same length, while filtering micro-noise through the final WMA pass. The result is a responsive midline that rarely produces whipsaws in trending markets.
ATR-Adaptive Cloud Architecture
The HMA midline is expanded into a four-layer cloud using the current ATR:
- Inner cloud (upper and lower bands): HullMid ± ATR × CloudMultiplier (default 1.0). This is the primary retest detection zone.
- Outer bands: HullMid ± ATR × CloudMultiplier × OuterMultiplier (default 1.618, the golden ratio). These define the statistical extreme of the cloud envelope.
The cloud dynamically widens during volatile markets and contracts during compression — naturally adapting to market conditions without manual parameter changes.
Four fill layers are rendered between the bands using trend-coloured gradients: bright teal in uptrends, muted red in downtrends, creating an intuitive visual heat map of trend energy.
Custom ADX Engine
Rather than relying on the built-in ta.dmi(), Kinetic Hull Matrix implements its own ADX from first principles:
1. Positive directional movement (plusDM) = max(high - high , 0) when high-to-high exceeds low-to-low
2. Negative directional movement (minusDM) = max(low - low, 0) when low-to-low exceeds high-to-high
3. Both are smoothed via ta.rma() over the ADX length, then divided by the RMA of true range to produce +DI and -DI
4. The directional index DX = abs(+DI - -DI) / (+DI + -DI) * 100, finally smoothed via ta.rma() to produce ADX
This gives a transparent, auditable ADX implementation. Values above 25 indicate a trending regime; below 25 indicates ranging conditions. The dashboard and scoring system both use this value.
Composite Signal Score (0–100)
A retest signal qualifies only when close price enters the inner cloud (touches upper cloud from above in a downtrend or lower cloud from below in an uptrend) while the candle closes back in the trend direction. The resulting signal is then scored:
- Proximity score (up to 50): How deeply price penetrated into the cloud. Deeper retests score higher.
- Volume score (up to 25): Current volume relative to its 20-bar SMA. Higher participation scores higher.
- RSI score (up to 15): RSI directional headroom — long signals score better when RSI has room below 55, short signals when RSI has room above 45.
- ADX score (up to 10): Raw ADX value × 0.4, capped at 10. Strong trends produce higher-quality retests.
Only signals meeting the configurable minimum score threshold (default 40) are displayed.
S/R Line Stamping
Each confirmed retest signal stamps a horizontal dotted line at the close price, extending 60 bars forward. These lines serve as dynamic support (for bull retests) and resistance (for bear retests). Lines are automatically invalidated and deleted if price closes through them by more than 0.5 ATR — the indicator only keeps lines that have not been structurally broken.
Multi-Timeframe Trend Table (Top Right)
Five user-configurable timeframes are assessed using the same dual-EMA logic (fast = HullLen/2, slow = HullLen). Each cell displays BULL or BEAR in the trend's colour. A "X/5 Bull" counter at the bottom summarises alignment. The table also shows current ADX value, RSI, and number of active S/R lines.
Inputs Reference
Hull Cloud
- Hull MA Length (21) — primary HMA period
- ATR Length (14) — period for ATR cloud width
- Cloud Width (1.0 ATR) — inner cloud half-width multiplier
- Outer Band Mult (1.618) — outer band golden-ratio expansion
- ADX Length (14) — custom ADX smoothing period
- Volume SMA Length (20) — reference for volume scoring
- RSI Length (14)
Retest Detection
- Min Signal Score (40) — minimum composite score to display signal
- Max S/R Lines (8) — maximum simultaneous S/R lines on chart
- S/R Break Buffer (0.5 ATR) — tolerance before a line is considered broken
- Show Score Label / Show S/R Lines
MTF Dashboard
- Show MTF Trend Table
- TF 1–5 — five independently configurable timeframes
Visual
- Theme: Dark, Light, Auto
How to Use
1. Apply to a liquid trending instrument. Allow warmup (roughly 3× Hull Length bars).
2. Identify the trend from cloud colour: teal fills = uptrend, red fills = downtrend.
3. Wait for price to dip into the inner cloud during an uptrend (or spike into it during a downtrend) and close back in the trend direction.
4. Check the score label — prefer grade 55+ (B or higher). Crosscheck with the MTF table: 4+ of 5 timeframes aligned significantly improves reliability.
5. The stamped S/R line from the retest level serves as a reference for re-entry if price pulls back again.
Non-Repainting Design
All retest signals are gated by barstate.isconfirmed. MTF data uses lookahead_off. S/R line management runs only on confirmed bars. No visual element shifts position after the bar closes.
Limitations
- In ranging, choppy markets, the cloud direction changes frequently and retest signals may have low predictive value. The ADX score component partially mitigates this, but consider increasing the minimum score threshold in low-trend environments.
- S/R lines accumulate during active trend periods. The max line count setting prevents chart clutter.
- MTF trend data requires request.security() calls per timeframe. On lower timeframes with very high bar counts, this may slightly affect indicator load time.
Disclaimer
This indicator is for educational and informational purposes only. No signal scoring system guarantees future performance. Always use proper risk management and conduct independent analysis before trading.
Made with passion by officialjackofalltrades
Indicator
