Volatility Cooldown Planner [AGPro Series]Volatility Cooldown Planner
🧠 Core Idea
Has volatility cooled down enough to read the chart again?
📌 Overview / What it does
Volatility Cooldown Planner is a chart-first volatility risk and readiness tool built for the period after a sharp ATR spike, wide-range candle, or large wick event.
Instead of printing another directional signal, the script asks whether the market is still unstable, cooling, ready for review, or readable again. It produces a spike box, a forward cooldown band, spike rails, unsafe volatility warnings, readiness labels, alerts, and a clean AGPro planning panel.
The script does not predict news events, identify hidden catalysts, automate decisions, or tell users what to buy or sell. Its role is to organize post-spike volatility context into a readable decision workflow.
🎯 Purpose & Design Philosophy
This script was built for traders who often face the same problem after sudden volatility: the chart is active, but not always readable.
Many tools focus on volatility expansion, squeeze release, regime classification, or breakout confirmation. Those can be useful, but they do not always answer the practical question that appears after a spike: should the trader keep reading this structure now, or wait until volatility load normalizes?
The design philosophy is simple: after unstable volatility, the first decision is not direction. The first decision is whether the chart is clean enough to evaluate.
⚡ Why This Script Is Different
Most volatility tools focus on detecting expansion, squeeze release, high ATR regimes, or dramatic candles.
This script does NOT try to detect news events, does not clone a volatility expansion planner, does not act as a stop-run model, and does not classify broad volatility cycles.
Instead, it studies the cooling process after the spike. The main output is a 0-100 Cooldown Score and a next-action state that separates UNSAFE, TOO EARLY, COOLING, READINESS REVIEW, and CHART READABLE conditions.
⚙️ Methodology
1. Spike Detection
The engine identifies spike context using ATR Load, single-bar range expansion, and dominant wick size.
2. Cooldown Mapping
When a spike appears, the script draws a spike box and a forward cooldown band. The band becomes the active review area for post-spike readability.
3. Readiness Evaluation
The model scores ATR load normalization, range contraction, time decay, close-to-close stability, and wick pressure.
4. Visual Output
The planner displays the active state through labels, rails, band color, alert conditions, and a compact AGPro panel.
🗺️ How to Read the Chart
Spike Box = the original volatility shock area.
Cooldown Band = the forward review window where the script evaluates whether volatility is becoming readable again.
Spike Rails = the upper and lower reference boundaries from the spike event. They are volatility context rails, not entry or stop instructions.
Readability Trail = an optional lightweight dot layer for users who want extra chart presence between major labels. It is disabled by default for a cleaner publication preset.
Unsafe Label = volatility has reloaded before cooldown completed.
Ready / Readable Labels = the cooldown score has reached a stronger review state.
Panel = a compact decision view showing Spike State, Cooldown Score, Volatility Load, Readiness, Action, and Best View.
🚦 Signals & States
• SPIKE → a new volatility shock has been registered.
• UNSAFE → volatility reloaded before the cooldown process became stable.
• TOO EARLY → not enough bars have passed after the spike.
• COOLING → volatility is improving, but readiness is not strong enough yet.
• READINESS REVIEW → conditions are strong enough to review the chart again.
• CHART READABLE → ATR load has normalized and the cooldown score is strong.
🔔 Alerts Logic
Volatility Spike Registered triggers when ATR load, range expansion, or wick pressure qualifies as a spike event.
Unsafe Volatility Reload triggers when volatility expands again during the active cooldown window.
Cooldown Readiness Review triggers when the cooldown score reaches the readiness threshold.
Chart Readable After Cooldown triggers when volatility load and cooldown quality both reach the strongest readable state.
Alerts are attention markers, not trade instructions.
🧩 Confluence Logic
The strongest cooldown state appears when multiple conditions align:
ATR load falls toward the target area, recent ranges contract, close-to-close movement stabilizes, wick pressure fades, and enough time has passed after the spike.
When these conditions align, the chart becomes more readable under the script's rules. This does not create certainty or directional prediction.
📊 When to Use
• After sharp ATR spikes
• After wide-range candles
• After large wick events
• After fast liquidation-style movement
• During post-event stabilization
• When the chart feels too unstable to interpret cleanly
• Best visual fit: 4H charts and intraday-swing volatility review
• Daily charts can work for broader context, but they may look more sparse because fewer cooldown events appear
⚠️ When NOT to Use
• Very low-liquidity markets
• Illiquid sessions with unreliable candle structure
• Extreme news volatility where conditions keep changing quickly
• Symbols with irregular gaps or poor feed quality
• As a standalone directional entry system
🎛️ Key Inputs
• Sensitivity → controls how demanding spike detection is.
• ATR Length → normalizes spike size and label offsets.
• ATR Baseline Length → defines the local volatility baseline.
• Cooldown Review Window → controls how long the spike remains under review.
• Cooldown Target ATR Load → defines the internal volatility load target for readability.
• Readiness Score Threshold → defines when the panel can mark readiness review.
• Visual settings → control spike boxes, cooldown bands, rails, markers, and background warnings.
• Readability Trail → optional subtle chart presence during active cooldown or elevated volatility.
• Label and Panel Font Size → control chart labels and panel readability.
🖥️ Interface & Visual Design
The interface is designed to stay chart-first.
The spike box explains where the instability started. The cooldown band shows the active review window. The centered band label gives the current state without forcing the user into a lower-pane dashboard.
The default visual preset keeps the chart calmer by hiding standalone spike event labels, sparse context labels, label scores, readable-upgrade follow-up labels, and the optional readability trail. Users can enable those layers when they want a denser visual review.
The AGPro panel follows the public-release standard with one merged blue header row containing only the panel title. The remaining rows focus on decision context rather than raw data overload, including a Best View row that points users toward the 4H chart when needed.
🧪 Practical Usage Workflow
1. Read the panel Readiness and Action fields.
2. Start with a 4H chart when preparing a visual review or publication screenshot.
3. Check whether the chart is still inside an active cooldown band.
4. Watch Volatility Load and Cooldown Score.
5. Treat UNSAFE as a warning that the chart may still be unstable.
6. Treat READINESS REVIEW or CHART READABLE as a prompt to evaluate broader structure, not as an automatic trade command.
🔍 Interpretation Guidelines
A high cooldown score means volatility has normalized under the script's rule set.
It does not mean price must continue, reverse, or respect the spike rails.
The best use is as a readability filter after unstable movement. It helps the trader decide whether the market is still too hot, cooling, or clean enough to study again.
🚫 What This Script Is NOT
• Not a prediction engine
• Not financial advice
• Not auto trading
• Not guaranteed signals
• Not a news-event detector
• Not a volatility expansion breakout tool
• Not a stop-run or liquidity-sweep model
⚠️ Limitations & Transparency
This script uses standard PulseWire OHLCV data and ATR-based measurements.
It cannot identify the real-world cause of volatility. It cannot know whether a spike came from news, liquidation, session flow, thin liquidity, or normal order flow.
Timeframe selection, symbol liquidity, session structure, and volatility regime can affect how quickly cooldown states appear. The default preset is visually best suited to 4H charts; lower timeframes may require stricter inputs, while Daily charts may naturally show fewer events.
🧠 Market Context Notes
Volatility often becomes hardest to interpret immediately after a sharp event.
Some spikes create clean follow-through. Others create unstable noise, whipsaw, or delayed normalization.
This planner focuses on the cooling process, not the directional outcome.
🧾 Use Case Examples
When a wide candle appears and the panel shows UNSAFE, the trader can wait for volatility load to normalize before interpreting follow-through.
When a spike box remains active but the score rises into READINESS REVIEW, the trader can compare the cooldown band with broader structure, trend, liquidity, and personal execution rules.
When the panel reaches CHART READABLE, the market is no longer classified as overheated by the script, but the user still needs independent context.
🧱 System Philosophy
AGPro tools are designed to convert market structure into decision context.
This script follows that philosophy by turning post-spike volatility into a readable workflow: identify the shock, monitor the cooldown, evaluate the readiness state, and avoid treating every fast move as immediately actionable.
🔐 Non-Promise Statement
No script can remove uncertainty.
No cooldown state guarantees that the next move will be clean.
The output is a structured analytical context, not certainty.
📉 Risk Disclosure
Trading involves risk.
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 volatility behaves after spikes, how long different symbols take to normalize, and how readability changes across timeframes.
Indicator
Continuation Acceptance Planner [AGPro Series]Continuation Acceptance Planner
🧠 Core Idea
Is this continuation setup being accepted, delayed, or invalidated before the next decision point?
📌 Overview / What it does
Continuation Acceptance Planner is a chart-first continuation planning tool built to evaluate whether a pullback inside an active trend is producing real acceptance or only temporary hesitation.
The script builds a live continuation acceptance band around a trend base, scores the context from 0 to 100, maps the invalidation rail, checks target room against the nearest obstruction, and prints compact state labels such as ACCEPTED, DELAYED, PAUSED, WATCH, and INVALID.
It does not predict future price movement, automate entries, or produce guaranteed trade signals. Its role is to organize continuation context into a cleaner decision framework.
🎯 Purpose & Design Philosophy
This script was built for traders who want to judge continuation quality without turning every trend pullback into a signal.
Most continuation tools focus on bounce detection or trend strength only. This planner focuses on the decision layer: acceptance quality, pullback risk, target room, invalidation context, and the next action state.
The design supports a patient execution mindset. It helps the user ask whether the continuation is actually being accepted, still delayed, temporarily paused, too extended, or losing validity.
⚡ Why This Script Is Different
Most tools focus on generic trend continuation signals after a moving average touch or pullback bounce.
This script does NOT act as a simple buy/sell continuation indicator, and it does not clone a broad trend-continuation quality scanner.
Instead, it treats continuation as a planning problem: price must interact with an acceptance band, show a quality close, maintain enough room before obstruction, and stay above or below a clear invalidation rail.
⚙️ Methodology
1. Context Detection
The script identifies bullish or bearish continuation context using fast, base, and slow EMA alignment plus trend slope.
2. Reference Mapping
It creates a continuation acceptance band around the base EMA and maps the invalidation rail using the band edge, slow EMA, and ATR buffer.
3. Reaction Evaluation
It evaluates pullback depth, close acceptance, volume support, and whether price is delaying, accepting, extending, or moving toward invalidation.
4. Visual Output
The script displays a centered acceptance-band label, invalidation and target guides, compact state labels, and a premium AG Pro planning panel.
🗺️ How to Read the Chart
Zones = the live continuation acceptance band around the trend base.
Labels = accepted, delayed, invalidation, or watch-state markers with optional 0-100 score.
Colors = bullish continuation context uses teal, bearish continuation context uses pink, delayed context uses amber, and risk or invalidation context uses red.
Panel = a compact decision dashboard showing Continuation Score, Acceptance, Pullback Risk, Target Room, and Action.
🚦 Signals & States
• ACCEPTED → continuation context has a qualified acceptance close and enough score to review.
• DELAYED → price is interacting with the acceptance band but has not produced enough clean acceptance.
• PAUSED → the prior continuation side still matters, but the trend stack needs to rebuild before the setup becomes clean again.
• WATCH → continuation context exists, but the setup still needs clearer reaction.
• EXTENDED → price is away from the acceptance band and may be late for clean continuation planning.
• INVALID RISK → price is moving beyond the planner's invalidation rail.
🔔 Alerts Logic
Alerts trigger when continuation acceptance, delayed acceptance, invalidation risk, or blocked target room conditions appear.
Alerts are attention markers only. They are not trade instructions and should be interpreted with the broader chart context.
🧩 Confluence Logic
The strongest continuation context appears when trend alignment, controlled pullback depth, close acceptance, volume support, and clean target room align.
When these components align, the continuation score improves and the panel moves toward a clearer planning state.
📊 When to Use
• Primary timeframe: 1H
• Secondary timeframe: 4H
• Trending markets with structured pullbacks
• Continuation setups after a controlled pause
• Pullbacks into a moving trend base
• Situations where target room and invalidation clarity matter
⚠️ When NOT to Use
• When expecting dense signals on 1D or 1W charts
• Very low liquidity environments
• Extremely noisy sideways conditions
• High-volatility shock moves where trend anchors distort quickly
• Markets with no clean trend alignment
🎛️ Key Inputs
• Sensitivity → changes how strict the acceptance engine is.
• Target Obstruction Lookback → defines the prior obstruction used for target-room evaluation.
• Acceptance Band Width ATR → controls the width of the continuation band.
• Confirmation Mode → defines whether acceptance requires close behavior only, close plus volume, or stricter alignment.
• Label and Panel Settings → control visual density, font size, panel location, and theme.
🖥️ Interface & Visual Design
The panel is designed as a compact planning dashboard, not a data-heavy scanner.
The first row follows the AG Pro blue merged-header standard. The remaining rows focus only on the information needed for continuation planning: score, acceptance, pullback risk, target room, and action.
Chart visuals are intentionally controlled so the acceptance band, invalidation rail, target guide, and labels remain readable.
🧪 Practical Usage Workflow
1. Read the panel state.
2. Check whether price is interacting with the acceptance band.
3. Review the continuation score and pullback risk.
4. Compare target room with the invalidation rail.
5. Use labels and alerts as attention markers, not as automatic decisions.
🔍 Interpretation Guidelines
Think in terms of setup quality, not prediction.
A higher score means the current continuation context has stronger alignment across trend, pullback depth, close behavior, volume, and target room.
A delayed state means the idea is not necessarily invalid, but the chart has not yet produced clean acceptance.
A paused state means the prior continuation context is still nearby, but alignment weakened enough that patience matters more than chasing.
An invalidation-risk state means the continuation structure should be reassessed.
🚫 What This Script Is NOT
• Not a prediction engine
• Not financial advice
• Not an auto-trading system
• Not a guaranteed signal generator
• Not a generic support/resistance or order-block map
• Not a gap continuation planner or breakout acceptance planner
⚠️ Limitations & Transparency
Timeframe differences can change how continuation bands and target-room references appear.
Volatility expansion can move the acceptance band and invalidation rail quickly.
Low-volume or synthetic symbols may reduce the usefulness of the volume component.
All outputs are rule-based and should be interpreted within broader market context.
🧠 Market Context Notes
Continuation planning depends on trend structure, liquidity, volatility, and obstruction distance.
The cleanest cases usually appear when pullbacks are controlled, the acceptance close is clear, and the next obstruction is not too close.
In the current public-release tuning, the script reads cleanest on 1H charts and remains usable on 4H. Daily and weekly charts can still provide context, but they are less expressive for the intended acceptance-versus-delay workflow.
🧾 Use Case Examples
When price pulls back into the acceptance band during a bullish trend and closes back above the base EMA with sufficient target room, the planner may shift toward ACCEPTED.
When price stays inside the band without a clean close, the planner may remain DELAYED.
When price closes beyond the invalidation rail, the planner flags INVALID RISK.
🧱 System Philosophy
The script follows the AGProLabs decision-engine approach: a useful public tool should help traders evaluate validity, strength, risk, target room, and the next action state.
It is built to guide interpretation, not to replace trader judgment.
🔐 Non-Promise Statement
No script can provide certainty.
No output from this script guarantees continuation, reversal, profit, or loss avoidance.
📉 Risk Disclosure
Trading involves risk.
Users are responsible for their own decisions.
This script does not provide financial advice and should be used only as an educational and analytical tool.
📚 Educational Note
Use the planner to study how continuation acceptance develops across different symbols, sessions, volatility regimes, and timeframes.
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
Reaction Follow-Through Planner [AGPro Series]Reaction Follow-Through Planner
🧠 Core Idea
Did the first reaction actually create follow-through, or did price only bounce and fade?
📌 Overview / What it does
Reaction Follow-Through Planner is a decision-oriented overlay that evaluates what happens after price produces an initial reaction around a confirmed swing reference.
Instead of only marking the reaction itself, the script opens a structured follow-through window, measures progress, tracks defense of the reaction zone, defines invalidation, estimates target room, and converts the context into a 0-100 planner score.
It produces reaction zones, follow-through tracks, continuation markers, failed-reaction labels, risk/target guide lines, and a compact AGPro panel. It does not predict future price, place trades, automate execution, or claim that any reaction must continue.
🎯 Purpose & Design Philosophy
This script was built for traders who already understand that a reaction candle is not enough.
Many charts show a wick, bounce, rejection, hold, or local response, but the real question comes after that first response: did the market follow through with clean progress, participation, and defended invalidation?
The design philosophy is simple: treat reaction analysis as a planning workflow. The script helps organize the reaction into strength, follow-through, invalidation, room, and next action.
⚡ Why This Script Is Different
Most reaction tools focus on finding the reaction candle, drawing the level, or scoring the first response.
This script does NOT clone a rejection-block detector, a support/resistance reaction map, or a generic pivot reaction score.
Instead, it starts after the first reaction appears. It tracks whether that reaction can defend its zone, produce directional progress, maintain follow-through, and offer enough room before the context becomes stale or failed.
⚙️ Methodology
1. Context Detection
The engine tracks confirmed swing reaction references and waits for price to interact with them.
2. Reference Mapping
When the first response is accepted, the script builds a reaction zone from the first response candle and defines an invalidation edge beyond the defended area.
3. Reaction Evaluation
The script grades the initial reaction candle using close defense, wick defense, body participation, and direction agreement.
4. Follow-Through Tracking
During the tracking window, the model measures best directional progress, next-bar response, volume support, adverse excursion, time decay, and whether the invalidation edge remains defended.
5. Visual Output
The chart displays reaction zones, follow-through tracks, target room, invalidation guides, continuation markers, failed-reaction labels, and a clean AGPro planner panel.
🗺️ How to Read the Chart
Zones = the defended first-reaction area that should remain intact for the follow-through case to stay valid.
Follow-through track = the movement path from the reaction close toward the current follow-through position.
Invalidation guide = the price edge where the reaction context is considered failed by the script logic.
Target room guide = the nearby structure or ATR-based room estimate used to judge whether the reaction still has space.
Labels = optional reaction start markers, follow-through continuation, or failed-reaction context. Start labels and failed-reaction X markers are disabled by default, while failed-reaction labels use a separate low cap for a cleaner publication view.
Colors = teal for bullish reaction continuation, pink for bearish reaction continuation, gold for weak or stalled contexts, and indigo for higher-quality follow-through.
Panel = the current reaction strength, follow-through state, invalidation level, room estimate, and next action.
🚦 Signals & States
• Bull Reaction Watch → a bullish reaction window is active, but follow-through still needs progress.
• Bear Reaction Watch → a bearish reaction window is active, but follow-through still needs progress.
• Bull Follow-Through → bullish follow-through reached the planner threshold.
• Bear Follow-Through → bearish follow-through reached the planner threshold.
• No Follow-Through → the reaction stayed defended but did not generate enough progress inside the tracking window.
• Failed Reaction → price closed beyond the reaction invalidation edge.
🔔 Alerts Logic
Alerts are attention markers, not trade instructions.
New Bull Reaction Window triggers when a bullish first-response window opens.
New Bear Reaction Window triggers when a bearish first-response window opens.
Bull Follow-Through Ready triggers when bullish follow-through reaches the score and progress thresholds.
Bear Follow-Through Ready triggers when bearish follow-through reaches the score and progress thresholds.
Reaction Failed triggers when price closes beyond the active invalidation edge.
🧩 Confluence Logic
The strongest context appears when reaction strength, next-bar progress, volume response, wick defense, and room all align.
When the reaction candle is strong but follow-through is weak, the panel will usually remain in watch or no-follow-through mode.
When follow-through progresses but invalidation is too close or room is limited, interpretation should stay cautious.
📊 When to Use
• After a visible reaction from a swing high or swing low reference.
• During retest, hold, rejection, or continuation planning.
• When you want to separate first-response reactions from reactions that actually continue.
• On symbols and timeframes with enough liquidity for clean candle structure.
⚠️ When NOT to Use
• Extremely low-liquidity markets where reaction candles are unreliable.
• Very noisy micro timeframes with erratic wicks.
• News-driven volatility where invalidation and room can shift quickly.
• Situations where the user expects automatic entries or guaranteed outcomes.
🎛️ Key Inputs
• Swing Reaction Lookback → controls how selective the reaction references are.
• First Response Mode → controls how strict the first reaction filter is.
• Follow-Through Track Bars → controls how long the script evaluates continuation after the reaction.
• Minimum Planner Score → sets the threshold for continuation-ready context.
• Invalidation Buffer → controls how far beyond the reaction zone the invalidation edge sits.
• Fallback Target Room → estimates room when no clean opposite structure is nearby.
• Visual settings → control zones, optional start labels, outcome labels, failed-reaction label cap, optional failed markers, guides, density, and panel layout.
🖥️ Interface & Visual Design
The interface is built around a clean AGPro panel and chart-first visuals.
The panel gives the decision summary. The chart shows the defended reaction zone, follow-through track, invalidation edge, target room, and state labels.
The visual hierarchy is intentionally restrained: enough labels to make the chart alive, but not so many that the reaction workflow becomes noisy.
🧪 Practical Usage Workflow
1. Read the panel to see whether a reaction window is active.
2. Check the reaction zone and invalidation edge.
3. Watch whether the follow-through track expands away from the zone.
4. Compare the score with available target room.
5. Treat alerts as review prompts, not execution commands.
🔍 Interpretation Guidelines
A strong reaction is not automatically a strong follow-through.
A clean follow-through usually needs directional progress, defended invalidation, supportive participation, and enough remaining room.
If the panel says No Follow-Through, the reaction may still be interesting visually, but the script did not detect enough post-reaction continuation quality.
If the panel says Failed Reaction, the original reaction context is no longer valid according to the script rules.
🚫 What This Script Is NOT
• Not a prediction engine.
• Not financial advice.
• Not auto trading.
• Not guaranteed signals.
• Not a replacement for risk management.
• Not a generic support/resistance map.
• Not a rejection-block scanner.
⚠️ Limitations & Transparency
The script is rule-based and depends on confirmed swing references, ATR normalization, volume baselines, and selected sensitivity settings.
Different timeframes can produce different reaction windows.
High volatility can expand invalidation distance and reduce room quality.
Low-liquidity markets can create misleading wick behavior.
🧠 Market Context Notes
Reaction follow-through is strongest when the first response is supported by participation and clean progress away from the defended zone.
It is weaker when price reacts but stalls near the zone, repeatedly revisits invalidation, or lacks target room.
The script is designed to help traders think in terms of reaction quality, not certainty.
🧾 Use Case Examples
When price reacts from a swing low and the next bars defend the reaction zone with rising progress, the planner may shift from Bull Reaction Watch to Bull Follow-Through.
When price rejects a swing high but immediately reclaims the invalidation edge, the planner may mark Failed Reaction.
When price bounces but fails to expand before the tracking window expires, the panel may show No Follow-Through.
🧱 System Philosophy
The AGPro approach favors decision engines over simple signal indicators.
This script follows that philosophy by turning a reaction into a structured review process: strength, follow-through, invalidation, room, and action.
🔐 Non-Promise Statement
No score guarantees continuation.
No alert confirms a profitable outcome.
No visual state should be treated as certainty.
📉 Risk Disclosure
Trading involves risk.
Users are responsible for their own decisions, risk management, position sizing, and market interpretation.
This script is for educational and analytical purposes only and does not provide financial advice.
📚 Educational Note
Use this script to study how reactions behave after the first response.
The goal is to improve interpretation discipline, not to replace a complete trading plan.
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
Gap Continuation Planner [AGPro Series]TITLE
Gap Continuation Planner
🧠 Core Idea
Is the active gap being accepted for continuation, or is it losing the structure needed for a clean plan?
📌 Overview / What it does
Gap Continuation Planner is a chart-first gap planning tool built to evaluate what happens after a gap appears. Instead of treating every gap as an automatic fill candidate, it asks whether price is accepting the gap edge, following through away from the gap, and preserving a measurable defense line.
The script produces a gap defense zone, a continuation corridor, an acceptance edge, a defense line, a target guide, compact labels, alerts, and a clean AGPro decision panel. The panel converts the live context into a 0-100 continuation score, fill-risk reading, and next-action state.
It does not predict future price, automate trades, or tell the user to buy or sell. It organizes observable gap behavior into a more disciplined continuation-planning framework.
🎯 Purpose & Design Philosophy
This script was built for traders who do not want to reduce every gap to a simple fill-or-fade idea.
Many gaps initially look strong, but the important question is whether the market continues to accept the gap after the first reaction. Gap Continuation Planner focuses on that middle layer: gap acceptance, follow-through, volatility load, defense quality, fill pressure, and forward room.
The design supports a planner mindset. The goal is to slow the decision process down and review whether the structure is valid enough to deserve attention.
⚡ Why This Script Is Different
Most gap tools focus on gap detection, gap fill percentage, or historical gap zones.
This script does NOT work as a generic gap-fill reaction tool, support/resistance map, imbalance catalog, or automatic signal generator.
Instead, it treats the latest gap as a continuation planning object. The model studies whether price is accepting the continuation side of the gap, whether follow-through is developing, whether the defense line remains intact, whether fill risk is rising, and whether there is enough forward room for the plan to remain clean.
⚙️ Methodology
1. Context Detection
The script detects classic opening gaps, wick gaps, body-separation gaps, and controlled continuation launch windows when adaptive mode is enabled.
2. Reference Mapping
Each accepted gap creates a gap defense zone, an acceptance edge, a defense line, and a target guide.
3. Reaction Evaluation
The engine scores gap size, open acceptance, follow-through, volatility load, fill risk, and forward room.
4. Visual Output
The chart displays a centered gap-zone label, a centered continuation-corridor label, event labels, planner lines, and a compact AGPro panel.
🗺️ How to Read the Chart
Zones = the detected gap defense area.
Continuation corridor = the forward planning area between the accepted gap edge and target guide.
Acceptance edge = the side of the gap that price should hold for continuation structure to remain stronger.
Defense line = an ATR-buffered invalidation reference beyond the far side of the gap.
Labels = state changes such as new gap, acceptance watch, continuation ready, defense review, or failed acceptance.
Colors = bullish continuation context uses teal, bearish continuation context uses pink, watch states use indigo, and caution states use amber.
Panel = summarizes gap state, continuation score, defense line, fill risk, and next action.
🚦 Signals & States
• New Gap → a fresh gap continuation window has been detected.
• Acceptance Watch → price is holding the continuation side of the gap, but follow-through still needs confirmation.
• Continuation Ready → the gap has stronger acceptance, follow-through, room, and risk structure.
• Defense Test → price is retesting the gap edge or defense area.
• Fill Risk → the gap is being penetrated enough to reduce continuation quality.
• Gap Failed → the active gap has lost continuation acceptance.
🔔 Alerts Logic
Alerts trigger when a new gap continuation window appears, when the gap reaches READY state, when acceptance watch begins, when defense review becomes relevant, or when gap acceptance is lost.
Alerts are attention markers. They are not trade instructions and do not guarantee that continuation will occur.
🧩 Confluence Logic
The strongest continuation context appears when gap size, gap-edge acceptance, follow-through distance, stable volatility, low fill pressure, and enough forward room align.
When these elements align, the continuation score improves. When fill pressure rises or volatility becomes too hot, the score weakens.
📊 When to Use
• After opening gaps in stocks, indices, futures, or session-based markets
• During continuation attempts after a strong gap
• When reviewing whether a gap is holding acceptance or losing structure
• Around breakout continuation sessions where risk and target references need to be visible
⚠️ When NOT to Use
• Extremely low-liquidity markets
• Very noisy or overlapping session opens
• News-driven gaps with unstable spreads
• Markets where volume and session structure behave unusually
• Environments where price is already far beyond a reasonable risk reference
🎛️ Key Inputs
• Sensitivity → adjusts how strict the gap and score requirements are.
• Gap Mode → controls whether the script reads classic gaps only or adaptive continuation windows.
• Acceptance Bars → changes how many bars must hold the continuation side of the gap.
• Follow-Through ATR → controls the preferred travel away from the gap edge.
• Defense Buffer → sets the ATR spacing for the defense line.
• Forward Room Lookback → helps estimate whether nearby structure limits continuation room.
• Minimum Continuation Score → sets the READY threshold.
• Visual settings → control zones, corridors, lines, labels, object limits, and panel appearance.
• Show Failed / Stale Objects → controls whether old failed corridors remain visible. It is disabled by default for a cleaner publication view.
🖥️ Interface & Visual Design
The interface is built for quick planner-style review. The chart carries the structural map, while the panel provides the decision summary.
The first panel row follows the AGPro merged blue header standard. The remaining rows focus only on the practical planning fields: state, score, defense, fill risk, and action.
The visual hierarchy is intentionally restrained so the gap, corridor, and labels are readable without turning the chart into a crowded signal map.
By default, failed or stale gap objects are hidden after they lose live planning value. Event labels remain available so the chart keeps context without carrying too many old failed boxes.
🧪 Practical Usage Workflow
1. Read the panel state and continuation score.
2. Check whether price is holding the gap acceptance edge.
3. Review the continuation corridor and target guide.
4. Compare fill risk against the defense line.
5. Use alerts as review markers, not execution commands.
6. Confirm the context with broader market structure, liquidity, and personal risk rules.
🔍 Interpretation Guidelines
A high continuation score means the active gap has stronger structure inside this model. It does not mean the move must continue.
Low fill risk supports continuation structure. Rising fill risk means price is starting to challenge the gap.
The defense line is a planning reference. It is not a guaranteed stop level and should not replace the user's own risk process.
Continuation corridors are visual planning areas, not promised target zones.
🚫 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 does not replace independent confirmation, risk management, or execution discipline.
⚠️ Limitations & Transparency
Gap behavior varies heavily across asset classes, sessions, and timeframes.
Adaptive launch windows can help continuous markets, but they should still be interpreted as structured gap-like planning areas rather than classic exchange-session gaps.
High volatility can make defense and target references wider.
Low liquidity can distort gap quality, label timing, and fill-risk readings.
No rule-based script can fully account for news, slippage, spread changes, or sudden liquidity shifts.
🧠 Market Context Notes
Gap continuation is often more meaningful when it aligns with trend pressure, session participation, volatility structure, and clean forward room.
A gap is not important simply because it exists. It becomes more useful when price accepts one side of it and maintains a measurable defense structure.
🧾 Use Case Examples
When price gaps up, holds above the gap edge, and the continuation score improves, the script can help review whether the gap is being defended.
When price gaps down and repeatedly rejects back below the gap edge, the panel can help evaluate bearish continuation structure.
When fill risk rises quickly, the script highlights that the gap may be losing acceptance rather than continuing cleanly.
🧱 System Philosophy
AGProLabs tools are built around structured interpretation. The goal is not to add more signals to the chart. The goal is to turn market behavior into a cleaner review process.
Gap Continuation Planner follows that approach by converting a raw gap into a measurable planning object.
🔐 Non-Promise Statement
No indicator can remove uncertainty.
No score can guarantee continuation.
No planner can replace the trader's responsibility to manage risk.
📉 Risk Disclosure
Trading involves risk.
This script is provided for educational and analytical use only.
It does not provide financial advice, investment advice, trading advice, or guaranteed outcomes.
Users remain responsible for their own decisions, risk management, position sizing, and execution.
📚 Educational Note
The strongest use of this tool is to study whether a gap is being accepted or rejected as structure develops. It is designed to support review, patience, and disciplined interpretation.
Indicator
Session Range Expansion Planner [AGPro Series]Session Range Expansion Planner
🧠 Core Idea
Is the session expanding from balance into a valid range extension, or is the break still too weak to trust as context?
📌 Overview / What it does
Session Range Expansion Planner is a 1H-focused intraday execution-readiness tool built around one clear workflow: define the early-session balance, track expansion beyond that range, and score whether the move has enough acceptance, volume support, volatility fit, and target room to deserve attention.
The script produces a session range box, accepted target-room bands, acceptance/rejection context, alerts, and a premium AGPro panel with a 0-100 planner score. The default visual preset is optimized for 1H and lower charts. Higher intraday charts such as 4H are intentionally kept clean by default.
It does not predict the next candle, automate entries, or issue buy/sell commands. It organizes session behavior into a structured decision layer so the user can evaluate the setup within their own plan.
🎯 Purpose & Design Philosophy
This script was built to fill the gap between simple session boxes and generic breakout indicators.
Most tools show where the session range is. Fewer tools explain whether the break from that range is actually being accepted, whether participation supports it, and whether there is usable room beyond the range.
Session Range Expansion Planner supports a planning mindset: define balance first, wait for expansion, check acceptance, evaluate room, then decide whether the context is worth further review.
⚡ Why This Script Is Different
Most session tools focus on marking opens, coloring sessions, or printing a breakout label as soon as price crosses a high or low.
This script does NOT act as a generic session high/low map, generic support/resistance tool, or broad session reaction scanner.
Instead, it treats the first part of the session as a balance structure and asks whether the later expansion has enough quality to become actionable context. The decision layer is built around acceptance bars, volume support, ATR regime, obstacle distance, and target-room quality.
⚙️ Methodology
1. Context Detection
The script reads the selected intraday session and builds an initial balance range from the first user-defined number of bars.
2. Reference Mapping
The session balance high and low become the only active expansion boundaries. The tool does not use PDH, PDL, weekly open, order blocks, FVGs, or generic swing zones.
3. Reaction Evaluation
When price breaks beyond the balance range, the engine measures acceptance closes, volume support, ATR regime quality, break distance, and nearby obstacle room.
4. Visual Output
The script displays a centered session range label, directional expansion labels, target-room band, acceptance/rejection labels, alerts, and a premium panel with score and next-action state.
🗺️ How to Read the Chart
Session Range Box = the early-session balance area.
Expansion Labels = the side where price first expands beyond the balance high or low.
Target-Room Band = the projected room beyond the broken boundary after expansion has been accepted, scaled by session range or ATR.
Acceptance Labels = confirmation that price has sustained closes beyond the range for the configured number of bars.
Rejection Labels = warning that price has failed back through the broken boundary.
Colors:
• Teal = upside expansion context
• Pink = downside expansion context
• Amber = neutral, warning, or rejection context
• Indigo = AGPro visual accent and target-room support
Panel = the decision cockpit showing planner score, session range, expansion side, acceptance, room score, and next action.
🚦 Signals & States
• Range Set → the initial balance window has completed.
• Expansion Up → price expanded above the session balance high.
• Expansion Down → price expanded below the session balance low.
• Accepted → the expansion held beyond the range for the required acceptance bars.
• Rejection Risk → price failed back through the broken boundary.
• Room Check Reached → price reached the projected target-room area.
🔔 Alerts Logic
Alerts trigger when:
• Upside range expansion is detected
• Downside range expansion is detected
• Expansion becomes accepted
• Rejection risk appears after expansion
Alerts are attention markers. They are not trade instructions and should be interpreted together with broader market context.
🧩 Confluence Logic
The strongest context appears when expansion direction, sustained acceptance, volume support, balanced ATR regime, and clean target room align at the same time.
When those conditions stack together, the planner score rises and the panel moves toward a review-ready state.
📊 When to Use
• 1H intraday charts with clear session behavior
• Opening balance or early-session range workflows
• Breakout quality review
• Volatility expansion planning
• Session continuation evaluation
The script is most useful when a trader wants to know whether a session range break is actually being accepted, not just whether a line was crossed.
⚠️ When NOT to Use
• Very low-liquidity symbols
• Extremely noisy micro timeframes
• Markets with unreliable volume
• Sessions with irregular trading hours
• News-driven candles where range expansion is disorderly
In weak conditions, reduce sensitivity or require stricter acceptance.
🎛️ Key Inputs
• Session Timezone → defines how the selected session is interpreted.
• Expansion Session → sets the active intraday window. The default full-day session is designed to work cleanly on crypto and other 24-hour symbols.
• Visual Timeframe Preset → controls which intraday timeframes show chart objects. The default is 1H and lower because 4H session expansion charts can become too compressed.
• Balance Window Bars → controls how many early-session bars define the range.
• Acceptance Bars → defines how much sustained closing behavior is required.
• Sensitivity → adjusts how fast the script recognizes expansion.
• Confirmation Mode → controls wick, close, or strict acceptance confirmation.
• Minimum Planner Score → sets the score threshold for review-ready context.
• ATR Length → controls volatility normalization and label spacing.
• Obstacle Lookback → estimates nearby structure that may reduce room quality.
• Target Room Multiplier → controls the projected target-room distance.
• Visual Settings → control range boxes, centered range label limit, rails, accepted target-room band, minimum visual score, optional expansion labels, optional room-check labels, optional range-set labels, label size, and object limits.
• Panel Settings → control panel visibility, location, theme, and font size.
🖥️ Interface & Visual Design
The interface is chart-first. The range box and target-room band carry the main visual story, while labels explain state transitions only when meaningful events occur.
The panel is intentionally compact. It gives a fast read of expansion quality without forcing the user to decode many separate plots.
The first panel row follows the AGPro standard: a single merged blue header row with only the script name.
🧪 Practical Usage Workflow
1. Apply the script to an intraday chart.
2. Confirm the correct session and timezone.
3. Let the initial balance window complete.
4. Watch for expansion beyond the balance high or low.
5. Check whether acceptance bars confirm sustained behavior.
6. Read the planner score and room score.
7. Use the next-action state as context for your own execution plan.
🔍 Interpretation Guidelines
A clean expansion is not just a break beyond the range. It should show acceptance, participation, reasonable volatility, and enough room before nearby obstruction.
Low scores usually mean the break is early, unsupported, too noisy, too extended, or too close to an obstacle.
The best use is comparative: review which sessions and symbols repeatedly produce clean accepted expansions versus weak false breaks.
🚫 What This Script Is NOT
• Not a prediction engine
• Not financial advice
• Not auto trading
• Not guaranteed signals
• Not a buy/sell command system
• Not a generic support/resistance map
• Not an order block, FVG, or liquidity sweep scanner
⚠️ Limitations & Transparency
Session behavior can vary across assets, timeframes, exchanges, and trading hours.
ATR regime and volume support are rule-based approximations, not certainty models.
On very low timeframes, labels may appear more frequently. On higher intraday timeframes, fewer but more meaningful events are expected.
Markets can expand cleanly and still reverse later. The tool measures context quality, not future certainty.
🧠 Market Context Notes
Session range expansion often becomes more meaningful when it is read together with broader trend, liquidity, volatility, and higher-timeframe structure.
The script deliberately stays focused on session balance and expansion quality. Users can combine it with their own broader framework without duplicating other AGPro tools.
🧾 Use Case Examples
When price breaks above the session range, holds above the balance high for the required acceptance bars, and room score remains strong, the panel may shift into review-ready continuation context.
When price breaks the range but quickly closes back inside the balance, the script marks rejection risk and the panel moves away from continuation review.
🧱 System Philosophy
AGPro tools are built to help traders organize context into clear decision layers.
Session Range Expansion Planner follows that philosophy by turning a common intraday event into a structured planning process: balance, expansion, acceptance, room, action.
🔐 Non-Promise Statement
No script can guarantee future price movement.
The score is a structured context model, not a certainty model.
📉 Risk Disclosure
Trading involves risk. Market conditions can change quickly, and historical session behavior does not guarantee future outcomes.
Users are responsible for their own decisions, risk management, and position sizing.
This script is provided for educational and analytical use only and does not provide financial advice.
📚 Educational Note
Use the script to study how different markets expand from early-session balance. The most valuable insight is not a single label, but the repeated relationship between range quality, acceptance, room, and market context.
Indicator
Volume Expansion Breakout Planner [AGPro Series]Volume Expansion Breakout Planner
🧠 Core Idea
After a breakout, is volume expanding in a constructive path, or is the move losing participation and acceptance?
📌 Overview / What it does
Volume Expansion Breakout Planner is a chart-first breakout planning tool built around post-breakout participation quality.
Instead of judging only the breakout candle, the script maps the broken reference level, draws an acceptance band, monitors relative volume after the break, tracks whether price holds the path, and converts the full sequence into a 0-100 quality score.
The output includes compact breakout path labels, volume expansion labels, hold labels, failed-volume labels, an invalidation rail, a room or review guide, and a clean AGPro decision panel. It does not predict price, automate entries, or issue trade commands.
🎯 Purpose & Design Philosophy
This script was built to fill the gap between simple breakout markers and full trade-management tools.
Many breakouts look strong on the first candle but quickly lose participation. Others start quietly and become stronger as post-break volume expands. This tool is designed for traders who want to evaluate that path with structure, not emotion.
The mindset is planning-first: identify the breakout reference, evaluate volume expansion, check acceptance, respect invalidation, and decide whether the path deserves continued attention.
⚡ Why This Script Is Different
Most breakout tools focus on the first break beyond a level.
This script does NOT try to clone a standard breakout volume confirmation tool, a Darvas breakout system, a triangle breakout scanner, or a generic support/resistance map.
Instead, it focuses on the post-break volume expansion path: what happens after the level breaks, whether volume remains constructive, whether price accepts the broken area, and whether the path becomes suspicious or failed.
⚙️ Methodology
1. Context Detection
The script builds a prior price structure from a configurable lookback and identifies the upper and lower breakout references.
2. Reference Mapping
When price closes beyond the reference by an ATR-normalized buffer, the script starts a breakout path and draws the broken level, acceptance band, invalidation rail, and a room or review guide.
3. Reaction Evaluation
The model evaluates relative volume, candle efficiency, close location, breakout distance, trend alignment, range quality, post-break participation, progress, acceptance, and failure behavior.
4. Visual Output
The chart displays compact path labels, volume expansion labels, accepted-path labels, failed-volume labels, and a premium AGPro panel summarizing the current decision state.
🗺️ How to Read the Chart
Zones = the acceptance band around the broken level. Its text changes by state, such as BULL PATH REVIEW, ACCEPTED BULL PATH, or FAILED BEAR PATH.
Labels = compact path state markers such as UP, DN, VOL+, HOLD, FAIL, WATCH UP, and WATCH DN. Label scores can be enabled from settings if the user wants more detail.
Colors = teal for constructive bullish paths, pink for constructive bearish paths, yellow for watch or caution states, indigo for room or review guide emphasis, and muted gray for expired paths.
Panel = the current breakout side, volume expansion state, acceptance state, quality score, and next action.
🚦 Signals & States
• UP → a bullish breakout path has started.
• DN → a bearish breakout path has started.
• VOL+ → post-break volume is expanding with directional follow-through.
• HOLD → the path held beyond the acceptance band with constructive volume.
• FAIL → the path returned into weak-volume or invalidation conditions.
• WATCH UP / WATCH DN → optional approach labels when price is near a breakout reference while relative volume is building.
🔔 Alerts Logic
Alerts trigger when a high-quality bullish or bearish volume expansion path starts, when post-break volume expands, when the path becomes accepted, or when failed-volume conditions appear.
These alerts are attention markers for chart review. They are not trade instructions.
🧩 Confluence Logic
The strongest readings usually occur when the breakout closes cleanly beyond the reference, relative volume expands above baseline, candle structure is efficient, trend alignment supports the side, and price later accepts the broken area.
When these conditions align, the quality score improves and the next-action state becomes more constructive.
📊 When to Use
• Breakout continuation review
• Range exits where volume quality matters
• Post-break acceptance monitoring
• Breakouts that need a clear invalidation reference
• Multi-symbol review where traders need fast path-quality comparison
⚠️ When NOT to Use
• Low-liquidity symbols with unreliable volume
• Markets with irregular session volume or distorted feeds
• Extremely choppy periods where every break returns inside the prior structure
• Events driven by abnormal news volatility where technical volume baselines become less stable
🎛️ Key Inputs
• Breakout Lookback → controls the prior structure used for breakout references.
• Break Buffer ATR → defines how far price must close beyond the level.
• Volume Baseline Length → controls the relative volume baseline.
• Expansion RVOL Threshold → defines the required volume expansion for strong pulses.
• Minimum Planner Score → controls how selective the main path states are.
• Acceptance Band ATR → controls the decision zone around the broken level.
• Invalidation Rail ATR → controls the structural failure reference.
• Panel / Label Settings → control location, theme, font size, label scores, optional watch labels, and label density.
🖥️ Interface & Visual Design
The interface is built for fast chart reading.
The acceptance band is the main visual anchor. The breakout line, invalidation rail, and room or review guide create a compact planning map without filling the chart with generic zones. Labels are short, shifted slightly away from the candle, and capped by user settings.
The AGPro panel follows the publication standard with a single merged blue header row containing only the script name.
🧪 Practical Usage Workflow
1. Read the panel to see whether a breakout path is active.
2. Check the acceptance band and broken level.
3. Evaluate whether volume is expanding or fading.
4. Watch for ACCEPTED or FAILED VOL states.
5. Use the invalidation rail and room or review guide as planning references within broader market context.
🔍 Interpretation Guidelines
Read the score as a structured quality model, not as certainty.
A higher score means the path has cleaner participation, stronger candle structure, better close quality, better trend alignment, and stronger acceptance behavior according to the script's rules.
A lower score means the path is weaker, less accepted, or more vulnerable to failed-volume behavior.
🚫 What This Script Is NOT
• Not a prediction engine
• Not financial advice
• Not auto trading
• Not guaranteed signals
• Not a complete trading system
• Not a generic buy/sell indicator
⚠️ Limitations & Transparency
Volume quality depends on the reliability of the PulseWire volume feed for the selected symbol.
Different timeframes can produce different breakout references and acceptance behavior.
High-volatility news periods, low-liquidity markets, and irregular session activity can reduce the usefulness of relative volume baselines.
The script is rule-based and should be interpreted alongside broader context.
🧠 Market Context Notes
Volume expansion is most useful when it is connected to structure.
The broken level matters because it gives the move a reference. The acceptance band matters because it shows whether the market is holding that reference. The invalidation rail matters because it defines when the path has lost structural quality.
🧾 Use Case Examples
When price breaks above a prior range with strong RVOL and later holds the acceptance band, the path may remain constructive.
When price breaks below a range but volume fades and price returns above the broken reference, the path may become suspicious or failed.
When price approaches a reference with building volume but no confirmed break, VOL WATCH keeps the trader aware without turning the tool into a signal board.
🧱 System Philosophy
The script is part of the AGPro planner-style workflow: show the reference, score the context, define invalidation, monitor acceptance, and guide the next review step.
🔐 Non-Promise Statement
No script can guarantee continuation, reversal, or outcome certainty.
This tool organizes breakout-volume context so users can evaluate the chart more clearly.
📉 Risk Disclosure
Trading involves risk.
Users are responsible for their own decisions, risk management, and market interpretation.
This script is provided for educational and analytical use only and does not provide financial advice.
📚 Educational Note
Use the script to study how post-breakout volume behaves after price leaves a prior structure. The most useful insights often come from comparing accepted paths against failed-volume paths over many examples.
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
Expansion Target Planner [AGPro Series]Expansion Target Planner
🧠 Core Idea
After expansion is confirmed, where is the reasonable target band, how clean is the path, and what should be reviewed next?
📌 Overview / What it does
Expansion Target Planner is a chart-first risk-target planning tool designed to evaluate the target area after a confirmed range expansion.
Instead of drawing a generic target line or copying a measured-move pattern, the script studies the prior range edge, current ATR, continuation pressure, recent structure obstacles, volatility state, and an invalidation shelf behind the move. It then converts that context into a 0-100 Target Quality score and a clear next-action state.
The output is a practical planning workflow: an expansion target band, invalidation shelf, target midpoint guide, path obstruction marker, compact chart labels, alert conditions, and a clean AGPro decision panel. It does not predict the future, automate decisions, or guarantee that any target band will be reached.
🎯 Purpose & Design Philosophy
This script was built for traders who need a cleaner way to evaluate expansion targets after price has already shown confirmation.
Many tools focus on finding a breakout, drawing an equal measured move, or plotting fixed take-profit levels. This tool fills a different gap: it asks whether the next target area is reasonable, whether the path is blocked, and whether the invalidation reference still supports the plan.
The design supports a disciplined target-review mindset. It helps users separate a clean expansion path from a stretched, obstructed, expired, or invalidated plan.
⚡ Why This Script Is Different
Most tools focus on measured moves, ABCD projections, fixed target ladders, or generic breakout confirmation.
This script does NOT become a measured-move projection tool, ABCD pattern detector, take-profit ladder, auto trading system, or generic support/resistance map.
Instead, it builds one active expansion target plan after confirmation and evaluates the quality of that plan. The core output is not a trade command. It is a planning state that helps users review whether the target band, invalidation shelf, volatility, and structure path still make sense.
⚙️ Methodology
1. Context Detection
The script identifies whether price has confirmed expansion beyond a prior range edge. Users can keep the side on Auto or force Long Expansion / Short Expansion.
2. Reference Mapping
Once confirmation appears, the script locks an active target plan. It maps the expansion anchor, ATR-adjusted target distance, target band, invalidation shelf, and recent pivot-based path obstacle.
3. Reaction Evaluation
The script scores the plan using expansion strength, ATR projection fit, nearby structure, continuation pressure, volume support, trend support, and volatility state.
4. Visual Output
The chart displays the active target band, invalidation shelf, guide lines, obstruction marker, event labels, alerts, and AGPro panel state.
🗺️ How to Read the Chart
Zones = the forward target band and the invalidation shelf behind the expansion.
Labels = the current target planning state, such as TARGET READY, WATCH, OBSTRUCTED, TARGET HIT, or INVALID REVIEW.
Colors = green/teal supports cleaner bullish expansion quality, pink marks bearish or risk states, yellow marks caution or obstruction, and indigo is used as a neutral planning accent.
Panel = the compact decision view showing Expansion Side, Target Band, Invalidation, Target Quality, and Action.
🚦 Signals & States
• TARGET READY → the target band has acceptable quality and the path is clean enough for review.
• WATCH → target context is improving, but not enough conditions are aligned yet.
• OBSTRUCTED → a recent structure obstacle sits between current price and the target band.
• TARGET HIT → price has interacted with the active target band.
• INVALID REVIEW → price has crossed the invalidation shelf and the plan should be reviewed.
• EXPIRED → the active plan has spent too many bars without completing.
🔔 Alerts Logic
Alerts trigger when the active target state changes into an important review condition.
• Target Ready alert → target quality moves into a stronger review state.
• Target Watch alert → target context improves but remains incomplete.
• Path Obstructed alert → a structure obstacle blocks the target path.
• Target Band Touched alert → price reaches the active target band.
• Invalidation Review alert → price crosses the invalidation shelf.
Alerts are attention markers, not trade instructions.
🧩 Confluence Logic
The Target Quality score improves when expansion confirmation, ATR projection fit, continuation pressure, volume support, volatility state, and open structure path align.
When the target distance is reasonable, the close is efficient, volume supports the move, and no nearby obstacle blocks the path, the context becomes stronger.
📊 When to Use
• After confirmed range expansion
• During breakout continuation review
• When evaluating whether a target area is too close, too far, or structurally blocked
• When a trader wants target context without a fixed take-profit ladder
• During volatility expansion phases where target planning matters more than another signal
⚠️ When NOT to Use
• Very low-liquidity markets
• Extremely noisy sideways chop
• News-driven spikes where ATR and structure become unstable
• Markets with unreliable volume if volume support is central to your process
• Any situation where the user expects automatic trade instructions
🎛️ Key Inputs
• Expansion Side → Auto, Long Expansion, or Short Expansion planning.
• Prior Range Lookback → defines the range edge used for confirmation.
• Confirmation Break ATR → controls how far beyond the range edge price must close.
• Range Projection Multiple → adjusts how much prior range width contributes to the target distance.
• ATR Projection Multiple → adjusts how much current volatility contributes to the target distance.
• Target Band Width ATR → controls the visual width of the target band.
• Invalidation Shelf Lookback → defines the reference shelf behind the expansion.
• TARGET READY / WATCH thresholds → control how selective the state engine is.
• Visual settings → control target band, shelf, guide lines, obstruction marker, labels, panel location, theme, and font sizes.
🖥️ Interface & Visual Design
The interface is built around one active target plan.
The target band is displayed forward on the chart with centered text. The invalidation shelf is shown behind the move so the risk reference is visible without turning the script into a generic support/resistance tool.
The panel follows the AGPro public-release standard with one merged blue header row containing only the script name. The layout is compact and designed for quick reading during live chart review.
🧪 Practical Usage Workflow
1. Read the panel to identify the active Expansion Side and Target Quality.
2. Check whether the target band is clean or obstructed.
3. Review the invalidation shelf behind the expansion.
4. Use labels and alerts as attention markers.
5. Confirm the broader market context with your own process.
🔍 Interpretation Guidelines
Treat the target band as a planning area, not a guaranteed destination.
A higher Target Quality score means the target plan is cleaner according to the script rules. It does not mean the move must continue.
An OBSTRUCTED state does not mean price cannot move through the obstacle. It means the path contains structure that deserves review.
An INVALID REVIEW state means the active shelf has been crossed and the plan context has changed.
🚫 What This Script Is NOT
• Not a prediction engine
• Not financial advice
• Not auto trading
• Not guaranteed signals
• Not a measured-move projection system
• Not an ABCD pattern scanner
• Not a take-profit ladder
⚠️ Limitations & Transparency
• Timeframe differences can change expansion quality and target distance.
• Volatility shifts can make a previously clean target band less useful.
• Recent structure may not capture every important higher-timeframe obstacle.
• Volume-based scoring can be less useful on symbols with unreliable volume.
• No rule-based tool can fully account for news, liquidity shocks, or sudden regime changes.
🧠 Market Context Notes
Expansion targets are more useful when the market has already shown range release and the target path is not immediately blocked by nearby structure.
Liquidity, volatility, and structure should be read together. A target band can look reasonable by distance but still become lower quality if the path is obstructed or volatility becomes overheated.
🧾 Use Case Examples
When price closes beyond a prior range edge with strong close location and the target path is open, the script may show TARGET READY.
When price expands but a recent pivot sits directly between current price and the target band, the script may show OBSTRUCTED.
When price crosses the invalidation shelf behind the plan, the script may show INVALID REVIEW.
🧱 System Philosophy
AGPro Series tools are designed to support structured decision review, not emotional signal chasing.
This script follows that philosophy by focusing on target quality, invalidation context, and next-action state rather than a simple directional signal.
🔐 Non-Promise Statement
No target band is certain.
No score guarantees continuation.
No alert should be treated as a trade instruction.
📉 Risk Disclosure
Trading involves risk.
Users are responsible for their own decisions, position sizing, risk controls, and market interpretation.
This script is for educational and analytical use only and does not provide financial advice.
📚 Educational Note
Use this tool to study how target quality changes after expansion confirmation.
The strongest value comes from comparing the target band, obstruction marker, invalidation shelf, and broader market context together.
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
False Break Trap Planner [AGPro Series]False Break Trap Planner
🧠 Core Idea
Is a breakout still holding, or is it turning into a false-break trap that deserves caution?
📌 Overview / What it does
False Break Trap Planner is a chart-first breakout failure planner built to evaluate range-edge break attempts after price moves beyond a recent high or low boundary.
Instead of only marking that a breakout happened, the script studies whether the move is holding beyond the edge, being reclaimed back into the range, or becoming a confirmed trap-risk context. It produces a 0-100 Trap Risk score, a reclaim state, a break-quality reading, a failure-room estimate, false-break zones, reclaim rails, and target-back guides.
This script does not predict price direction, automate execution, or claim that a failed break must reverse. It organizes the anatomy of a potential false break so traders can review the setup with cleaner context.
🎯 Purpose & Design Philosophy
This script was built for traders who need a practical decision layer around breakout failure, not another generic signal marker.
The gap it fills is the space between a clean breakout tool and a liquidity sweep tool. Many chart tools mark a level break, a wick, or a reclaim. This planner asks what the trader should review next: is the break holding, is reclaim pressure developing, is the failure fast enough to matter, and is there room back inside the range?
The design mindset is structured caution. The script helps users slow down around breakout traps, separate active risk from confirmed failure, and keep risk / target / invalidation context visible.
⚡ Why This Script Is Different
Most tools focus on breakout confirmation, sweep labels, or generic failed-break signals.
This script does NOT try to become a stop-hunt map, liquidity sweep engine, support/resistance zone scanner, or broad breakout system.
Instead, it focuses on one specific workflow: a prior range edge is broken, the break either holds or gets reclaimed, and the planner scores whether that behavior deserves trap-risk review.
⚙️ Methodology
1. Context Detection
The script maps a recent range high and range low from previous bars, then watches for an ATR-normalized break beyond either edge.
2. Reference Mapping
When a break attempt appears, the planner freezes the range edge, opposite edge, midpoint, and false-break extreme so the event can be evaluated consistently.
3. Reaction Evaluation
The model scores breakout failure speed, reclaim strength, wick size, volume spike, and whether price closes back inside the range.
4. Visual Output
The script displays a false-break box, reclaim or fail rail, target-back line, trap confirmation labels, reclaim-watch labels, and a premium AG Pro panel.
🗺️ How to Read the Chart
Zones = the active false-break box between the broken range edge and the failed extension.
Labels = compact state markers such as Upper Break Watch, Lower Break Watch, Reclaim Watch, Upper Trap, Lower Trap, or Break Accepted.
Colors = teal for lower-break trap recovery context, pink for upper-break trap risk, yellow for watch states, indigo for accepted/holding context, and red for confirmed trap-risk pressure.
Panel = a compact decision panel showing Trap Risk, Reclaim State, Break Quality, Failure Room, and Action.
🚦 Signals & States
• Upper Break Watch → price has moved beyond the upper range edge and the break is under review.
• Lower Break Watch → price has moved beyond the lower range edge and the break is under review.
• Reclaim Watch → price is testing back toward or inside the broken edge, but confirmation is not complete.
• Trap Confirmed → the break has closed back inside the range with enough trap-risk score.
• Break Holding → the break is still outside the range and has not reclaimed.
• Break Accepted → the break has held beyond the acceptance window and should not be treated as an active trap by default.
🔔 Alerts Logic
Alerts trigger when the planner detects confirmed upper or lower trap context, upper or lower reclaim-watch context, or break acceptance.
Each alert is an attention marker. It highlights a state transition that may deserve review. It is not a trade instruction and should not be treated as an automated entry or exit signal.
🧩 Confluence Logic
The strongest trap-risk context appears when several factors align:
• Fast failure after the break
• Close back inside the prior range
• Strong wick rejection
• Volume spike during the failed extension
• Clean room back toward the range midpoint
When these align, the panel score rises and the state becomes easier to interpret.
📊 When to Use
• Breakout and breakdown attempts around a recent range
• Markets where false breaks and failed continuations are common
• Intraday or swing charts where range edges are visually relevant
• Review workflows that need caution before chasing a break
• Breakout traders who want a structured invalidation and failure-room layer
⚠️ When NOT to Use
• Extremely low-liquidity instruments
• Very noisy micro timeframes with unreliable candles
• Markets with poor or synthetic volume data
• News-driven volatility where single-bar extremes distort ATR and volume
• Charts where the selected lookback does not represent a meaningful range
🎛️ Key Inputs
• Range Edge Lookback → controls the prior range used for break attempts.
• Minimum Break ATR → defines how far price must move beyond the edge before the planner starts tracking.
• Fast Reclaim Window → controls how many bars can pass before a reclaim becomes less meaningful.
• Trap Confirmed Score → minimum 0-100 score required for a confirmed trap label.
• Break Acceptance Bars → defines when a break should be treated as holding rather than still failing.
• Visual settings → control boxes, rails, target-back lines, label density, panel location, theme, and font sizes.
🖥️ Interface & Visual Design
The panel is designed as a clean AG Pro planning cockpit. The first row uses the standard merged blue AGPro header row, followed by five decision rows.
The chart visuals are intentionally focused: one active false-break box, a reclaim rail, a soft fail rail, a target-back line, and controlled labels. The goal is premium readability without turning the chart into a generic level map.
🧪 Practical Usage Workflow
1. Read the panel and check the current Reclaim State.
2. Review the false-break box and identify which edge was broken.
3. Check whether price is holding beyond the edge or closing back inside.
4. Compare Trap Risk with Break Quality.
5. Use the target-back line and failure-room reading as context, not as a forecast.
🔍 Interpretation Guidelines
Think in states, not predictions.
A high Trap Risk score means the attempted break has characteristics often associated with failed continuation. It does not mean the next move is guaranteed.
A strong Break Quality score means the break is still showing participation and close-through behavior. In that context, early fading can be premature.
The cleanest reading appears when Trap Risk is high, Break Quality is weak, and price has closed back inside the range.
🚫 What This Script Is NOT
• Not a prediction engine
• Not financial advice
• Not auto trading
• Not guaranteed signals
• Not a stop-hunt map
• Not a liquidity sweep scanner
• Not a support/resistance zone system
• Not a replacement for risk planning
⚠️ Limitations & Transparency
The active range depends on the selected lookback. A different lookback can produce different edges.
ATR and volume conditions can change quickly during high-volatility periods, which may affect scoring.
Breakout behavior differs across symbols, sessions, and timeframes. A trap-like structure on one market may not behave the same way on another.
The script is rule-based and does not know external news, order flow, or hidden liquidity.
🧠 Market Context Notes
False breaks often become more relevant near visible range edges, crowded breakout levels, and late-stage expansion attempts.
The planner is most useful when combined with broader market context, liquidity conditions, volatility regime, and the trader's own risk rules.
🧾 Use Case Examples
When price breaks above a recent range but closes back inside with a long upper wick and strong volume, the planner may mark Upper Trap context.
When price breaks below a range but quickly reclaims the lower edge, the planner may shift into Lower Trap context.
When price breaks and keeps closing beyond the edge after the acceptance window, the planner may mark Break Accepted instead of forcing a trap interpretation.
🧱 System Philosophy
False Break Trap Planner follows the AGPro Series decision-engine direction: score the setup, identify the state, show the risk reference, show the target-back context, and make the next review step clear.
The script is built to help traders make a structured chart-reading decision, not to add another isolated signal.
🔐 Non-Promise Statement
No script can confirm certainty.
No trap score guarantees reversal, continuation, or profitability.
📉 Risk Disclosure
Trading involves risk.
Users are responsible for their own decisions, risk controls, and market interpretation.
This script is for educational and analytical use only and does not provide financial advice or guaranteed trading outcomes.
📚 Educational Note
Use the planner as a structured review layer around breakout failure behavior. The best value comes from comparing state, score, failure room, and broader market context together.
Indicator
Decision Point Planner [AGPro Series]Decision Point Planner
🧠 Core Idea
Is price sitting at a decision point that deserves review, patience, or rejection?
📌 Overview / What it does
Decision Point Planner is a chart-first risk planning tool built to evaluate whether the current price area is meaningful enough to deserve attention.
The script maps one active decision point from structure shelf, balance edge, or trend backbone context, then scores the area using location quality, reaction candle behavior, volume support, trend context, available room, and invalidation distance. The output is a 0-100 Decision Score, a clear next-action state, a decision zone, an invalidation shelf, a target-room corridor, compact labels, alerts, and a premium AGPro panel.
It does not predict price direction, automate execution, or print direct buy/sell signals.
🎯 Purpose & Design Philosophy
This script was built for traders who want to know whether the chart is actually at a meaningful decision area or simply moving through noise.
Many tools show levels, zones, or signals in isolation. Decision Point Planner focuses on a narrower planning question: if price is near a decision reference, is the reaction strong enough, is risk still balanced, and is there enough room before the next obstacle?
The design supports a patient planning mindset: identify the point, read the reaction, check room and invalidation, then decide what deserves attention.
⚡ Why This Script Is Different
Most tools focus on plotting many support/resistance levels or marking every reaction.
This script does NOT create a generic S/R map, order-block scanner, FVG map, or prediction engine.
Instead, it selects one active decision reference and turns it into a planning workflow: Decision Score, Zone Type, Reaction State, Room/Risk, and Next Action.
⚙️ Methodology
1. Context Detection
The script detects the active planning side automatically using trend context and range location, or the user can force Long Context or Short Context.
2. Reference Mapping
It compares three decision references: the latest structure shelf, the active balance edge, and the trend backbone. The closest relevant reference becomes the active decision point.
3. Reaction Evaluation
It evaluates whether price is touching or approaching the zone, whether the candle shows a valid reaction, whether volume supports the reaction, whether trend context agrees, and whether room and invalidation remain balanced.
4. Visual Output
It displays a decision zone, invalidation shelf, target-room corridor, compact chart labels, alerts, and a clean AGPro panel.
🗺️ How to Read the Chart
Decision Zone = the current area where price is being evaluated as a decision point.
Invalidation Shelf = the reference beyond the zone that marks rejection in this rule set.
Target-Room Corridor = the available forward room toward the nearest obstacle or a minimum room guide.
Labels = compact attention markers showing ACTION, WAIT, PATIENCE, REJECTED, ROOM, or D POINT context.
Colors = teal and pink show active directional context, amber shows caution, indigo shows wait/reaction context, and blue is reserved for the AGPro panel header.
Panel = summarizes Decision Score, Zone Type, Reaction State, Room Risk, and Action.
🚦 Signals & States
• ACTION REVIEW → the decision point has enough score, reaction, room, and risk quality to deserve closer review.
• WAIT REACTION → price is near the decision point, but the reaction is still incomplete.
• PATIENCE → the area is active but quality, room, or risk is not clean enough yet.
• REJECTED → price crossed the invalidation shelf for the active decision point.
• STAND BY → price is not close enough to the active decision reference.
🔔 Alerts Logic
• Decision Point Action Review → triggers when the state enters ACTION REVIEW.
• Decision Point Wait Reaction → triggers when price is near the point but reaction is incomplete.
• Decision Point Patience → triggers when the active point requires patience or broader confirmation.
• Decision Point Room Limited → triggers when the point is active but forward room is limited.
• Decision Point Rejected → triggers when price crosses the active invalidation shelf.
Alerts are attention markers. They are not trade instructions.
🧩 Confluence Logic
Decision quality improves when location, reaction candle behavior, volume support, trend context, target room, and invalidation distance align.
The strongest read appears when price is near the decision zone, the reaction candle is efficient, volume is supportive, trend context agrees, room is open, and risk distance is balanced.
📊 When to Use
• Around pullbacks where price is near a meaningful planning reference.
• During breakout or continuation preparation when the next reaction matters.
• Near range edges or balance transitions where patience is required.
• When comparing whether a setup deserves review or should remain on watch.
• On liquid markets where ATR, volume, and recent structure are meaningful.
⚠️ When NOT to Use
• Extremely low-liquidity markets with unreliable volume and candles.
• Highly noisy micro-timeframes where decision references change too frequently.
• News-driven volatility spikes where ATR and candle ranges expand abnormally.
• Charts where the user expects automatic buy/sell signals.
• As a standalone reason to enter or exit a trade.
🎛️ Key Inputs
• Planning Side → selects Auto, Long Context, or Short Context.
• Decision Range Lookback → defines the planning range and target-room obstacle.
• Structure Shelf Pivot Length → controls how strict the structure shelf reference is.
• Decision Reach ATR → controls how close price must be to the active point before review.
• Decision Zone Half-Width ATR → controls the vertical size of the decision zone.
• Target Room and Invalidation Inputs → define room quality and balanced risk distance.
• Visual Settings → control zones, shelves, corridor, labels, panel location, panel theme, and font sizes.
🖥️ Interface & Visual Design
The interface is intentionally chart-first.
The script uses one active decision zone, one invalidation shelf, and one target-room corridor instead of filling the chart with many competing zones. Labels are compact, offset away from candles, and controlled with cooldown and maximum-visible settings.
The panel follows the AGPro publication layout with a single merged blue title row, adjustable location, adjustable theme, and adjustable font size.
🧪 Practical Usage Workflow
1. Read the panel state and Decision Score.
2. Check the active decision zone and zone type.
3. Evaluate the reaction label and candle behavior.
4. Compare target-room corridor and invalidation shelf.
5. Treat alerts as review markers and confirm the broader market context.
🔍 Interpretation Guidelines
A higher Decision Score means the active decision point has stronger alignment inside the script's rule set. It does not mean price must move in the planned direction.
ACTION REVIEW means the area deserves attention, not automatic execution.
WAIT REACTION means the location may be important but the reaction is not complete.
REJECTED means the active invalidation shelf was crossed in this rule set.
🚫 What This Script Is NOT
• Not a prediction engine.
• Not financial advice.
• Not auto trading.
• Not guaranteed signals.
• Not a buy/sell signal service.
• Not a generic support/resistance zone map.
• Not an order-block or FVG scanner.
⚠️ Limitations & Transparency
Decision quality depends on the selected lookback, pivot length, ATR behavior, volume reliability, and timeframe.
Different markets can produce different reference behavior. High volatility can widen invalidation distance. Low volatility can compress target room. Small timeframes may produce more frequent state changes.
The script is rule-based and should be interpreted as an analytical planning layer inside broader market context.
🧠 Market Context Notes
A decision point is useful only when it connects location, reaction, risk, and room.
The same visual area can be weak if reaction is poor, volume is absent, target room is blocked, or invalidation is too tight or too wide.
This script organizes those checks into one readable decision layer.
🧾 Use Case Examples
When price pulls back toward the decision zone and the panel moves from WAIT REACTION to ACTION REVIEW, the area may deserve closer review.
When price touches the zone but the panel shows Room Limited, the user can recognize that the nearby path is obstructed.
When price crosses the invalidation shelf, the script marks the active decision point as rejected inside its rule set.
🧱 System Philosophy
Decision Point Planner follows the AGPro decision-engine approach:
Context first.
Risk before reaction.
Room before confidence.
Attention markers instead of promises.
🔐 Non-Promise Statement
No script can guarantee direction, continuation, reversal, or outcome.
This tool provides structured chart context only.
📉 Risk Disclosure
Trading involves risk.
Users are responsible for their own analysis, risk controls, position sizing, and trading decisions.
This script does not provide financial advice, investment advice, or guaranteed trading outcomes.
📚 Educational Note
Use the script to study how decision quality changes as price moves closer to or away from active planning references.
The most useful reading comes from comparing the panel state with visible price reaction, room, and invalidation context.
Indicator
Indicator
Setup Decay Tracker [AGPro Series]Setup Decay Tracker
🧠 Core Idea
Is a once-valid setup still healthy, or is its quality decaying over time?
📌 Overview / What it does
Setup Decay Tracker is a chart-first execution planning tool built to evaluate what happens after a setup has already started forming. Instead of treating every trigger as equally useful, it separates the process into two stages: setup validation and post-validation quality decay.
The script builds an active decay band, validation rail, follow-through rail, invalidation shelf, expiry marker, state labels, and a compact planning panel. Its purpose is to show whether the active setup is still valid, starting to fade, entering decay review, expiring, reclaiming its trigger side, or invalidating.
It does not predict price, automate trades, or issue buy/sell commands. Alerts and labels are attention markers designed to help traders review setup quality within broader market context.
🎯 Purpose & Design Philosophy
This script was built for traders who already understand that the first setup trigger is only the beginning of the decision process. A setup can look valid at first, then lose quality because time passes, momentum fades, volatility contracts, follow-through stalls, or price loses and reclaims the trigger side.
The gap it fills is post-validation review. Many tools mark a trigger, but fewer tools ask whether that trigger is aging well after it becomes valid. Setup Decay Tracker focuses on that question with a clean visual workflow.
The design supports a planning mindset: validate first, monitor quality second, review decay third.
⚡ Why This Script Is Different
Most tools focus on the moment a signal appears.
This script does NOT behave like a generic signal generator, broad regime classifier, support/resistance map, order-block map, or simple breakout alert.
Instead, it tracks the lifecycle of one active setup after validation. It asks whether the setup is still earning its place on the chart by measuring time risk, follow-through, momentum loss, volatility loss, trigger-side reclaim behavior, and invalidation context.
⚙️ Methodology
1. Context Detection
The script identifies the evaluation side using trend and range context, or the user can force long-side or short-side tracking.
2. Setup Validation
A trigger starts tracking, but the setup is not treated as fully valid until it reaches minimum favorable ATR travel and a validation-quality threshold.
3. Decay Evaluation
After validation, the script measures the active setup with a 0-100 decay model based on time risk, momentum loss, volatility loss, failed follow-through, and reclaim behavior.
4. Visual Output
The result appears as a decay band, validation rail, follow-through rail, invalidation shelf, expiry marker, compact labels, and a premium AGPro planning panel.
🗺️ How to Read the Chart
Zones = the active setup decay band between the follow-through reference and the invalidation shelf.
Labels = state changes such as TRACK, VALID, WATCH, DECAY, RECLAIM, EXPIRED, and INVALID.
Colors = teal for healthier states, gold for watch states, pink/red for decay review or invalidation pressure, and indigo for validation or reclaim context.
Panel = the decision summary showing Decay Score, Time Risk, Follow-Through, Invalidation, and Action.
🚦 Signals & States
• TRACK → a new setup is being monitored for validation
• VALID → the setup reached minimum quality and decay tracking is active
• STILL VALID → decay score remains low and follow-through is still acceptable
• QUALITY WATCH → quality is fading, but the setup has not reached decay review
• DECAY REVIEW → the setup has enough quality decay to deserve closer review
• RECLAIM → price recovered the trigger side after temporary loss
• EXPIRED → the setup aged beyond the active decay window or reached expiry-level decay
• INVALID → the invalidation shelf was crossed inside this rule set
🔔 Alerts Logic
The script includes alerts for:
• New setup tracking
• Setup validation
• Quality watch state
• Decay review state
• Trigger-side reclaim
• Setup expiry
• Setup invalidation
Alerts are attention markers. They are not trade instructions and should be interpreted with market structure, liquidity, volatility, and timeframe context.
🧩 Confluence Logic
The decay model becomes more meaningful when several conditions align.
When time risk rises, follow-through remains weak, momentum fades, volatility contracts, and price struggles around the trigger side, the setup decay context becomes stronger.
When follow-through improves, the trigger side holds, volatility remains healthy, and momentum stays directional, the setup remains cleaner.
📊 When to Use
• Breakout setups that need post-trigger validation
• Trend-reclaim setups where quality can fade after the first reclaim
• Continuation contexts where follow-through matters
• Active trade planning where invalidation and target references need to stay visible
• Markets where setup aging and time risk are part of the decision process
⚠️ When NOT to Use
• Extremely low-liquidity symbols
• Very noisy micro timeframes where triggers appear too frequently
• News-driven candles where normal volatility logic becomes distorted
• Markets with large gaps that make ATR-based validation less stable
• Situations where the user expects automatic entries, exits, or guaranteed outcomes
🎛️ Key Inputs
• Evaluation Side → chooses Auto, Long Setup, or Short Setup tracking
• Trigger Model → controls whether tracking starts from range acceptance, trend reclaim, or impulse continuation
• Sensitivity → changes how strict validation and decay response should be
• Setup Lookback → defines the recent structure window used for trigger context
• Validation Travel ATR → sets the minimum favorable movement needed before a setup is considered valid
• Decay Tracking Bars → controls how long a validated setup remains active
• Follow-Through Target ATR → defines the progress reference used inside the decay model
• Invalidation Buffer ATR → builds the invalidation shelf beyond the trigger candle
• Label and Panel Font Size → controls visual readability
🖥️ Interface & Visual Design
The interface is built around a clean chart-first layout. The decay band gives the setup a visible lifecycle area, while the centered band label summarizes the active state without requiring a dashboard-only workflow.
The panel is compact and decision-focused. Its first row follows the AGPro standard: one merged blue header row containing only the panel title. Panel location, panel theme, and panel font size are adjustable.
Labels are intentionally moderate. The script uses event labels plus sparse context labels so the chart stays alive without becoming crowded.
🧪 Practical Usage Workflow
1. Read the panel and check the active state.
2. Confirm whether the setup is validating, still valid, in watch state, in decay review, expired, or invalidated.
3. Check the decay band, validation rail, follow-through rail, and invalidation shelf.
4. Review labels for the most recent state change.
5. Interpret the output with broader market context before making any decision.
🔍 Interpretation Guidelines
Think of the Decay Score as a quality-loss meter, not a directional forecast.
A low Decay Score suggests that the setup is still holding its validation context.
A rising Decay Score suggests that time, weak progress, fading momentum, volatility loss, or trigger-side instability are reducing setup quality.
A Decay Review state means the setup deserves attention. It does not mean price must reverse or that a trade must be closed.
🚫 What This Script Is NOT
• Not a prediction engine
• Not financial advice
• Not an auto-trading system
• Not a guaranteed signal tool
• Not a generic support/resistance map
• Not a broad market regime classifier
⚠️ Limitations & Transparency
ATR-based rails can behave differently across markets, timeframes, and volatility regimes.
Fast news moves, thin liquidity, and wide spreads can distort validation and decay readings.
No rule-based tool can fully understand every market condition. The output should be read as structured context, not certainty.
🧠 Market Context Notes
Setup decay often matters most when the first trigger was valid but follow-through becomes uncertain. A setup can remain technically alive while losing momentum, time efficiency, or volatility support.
The script focuses on that middle zone between “still valid” and “clearly invalidated.”
🧾 Use Case Examples
When price breaks a recent range, validates with minimum travel, then stalls for many bars without reaching the follow-through rail, the Decay Score can rise into watch or review context.
When price temporarily loses the trigger side and then reclaims it, the script marks reclaim context and continues monitoring quality rather than treating the setup as automatically clean.
When price crosses the invalidation shelf, the setup is marked invalid inside this rule set.
🧱 System Philosophy
Setup Decay Tracker follows the AGPro planning approach: the best public tools should help traders make a decision, not simply show another signal.
The script is designed to answer practical questions:
Is this setup valid?
How much quality has it lost?
Where is the invalidation?
Is follow-through still acceptable?
What should I review now?
🔐 Non-Promise Statement
This script does not provide certainty.
It does not guarantee outcomes.
It provides a structured way to monitor setup quality decay after validation.
📉 Risk Disclosure
Trading involves risk.
Users are responsible for their own analysis, decisions, risk management, and trade execution.
This script is for educational and analytical purposes only and does not provide financial advice.
📚 Educational Note
Use the tool to study how setup quality changes after the first valid trigger. The most useful reading often comes from comparing the panel state, decay band, labels, and broader market context together.
Indicator
Execution Window Planner [AGPro Series]Execution Window Planner
🧠 Core Idea
Where is the cleanest active price window for evaluating execution context?
📌 Overview / What it does
Execution Window Planner is a chart-first execution-readiness tool built to answer one practical question: is price currently sitting inside a clean review window, or is the context too early, too late, too stretched, or already invalidated?
The script maps an active execution window box, a risk edge, a target edge, compact state labels, and a premium AGPro panel. It converts window width, structure alignment, volatility fit, trend support, candle confirmation, and room-to-risk context into a transparent 0-100 Quality Score.
It does not predict price movement, automate orders, or issue buy/sell commands. The output is designed as an analytical planning layer for traders who want cleaner context before making their own execution decisions.
🎯 Purpose & Design Philosophy
This script was built for traders who already have a directional thesis but need a disciplined way to judge whether the current price area is actually usable for execution review.
Many tools show trend, signals, support/resistance, or zones. The missing piece is often the active decision window: the price area where risk is still definable, target room still exists, volatility is not distorted, and confirmation is not too weak.
The design philosophy is simple: execution quality should be evaluated through a defined window, not through excitement around a single candle.
⚡ Why This Script Is Different
Most tools focus on printing a signal, marking a generic support/resistance area, or showing a large multi-feature trading dashboard.
This script does NOT act as a full trading suite, signal service, position sizing tool, ICT/FVG map, order block map, or generic zone scanner.
Instead, it keeps one narrow purpose: identify and score the current execution window using risk edge, target edge, structure, volatility, trend support, and candle confirmation. The result is a focused decision layer rather than another broad indicator.
⚙️ Methodology
1. Context Detection
The script detects the active planning side automatically from trend structure, or lets the user force a long-bias or short-bias view.
2. Reference Mapping
It builds a risk edge from recent structure and a target edge from broader structure or ATR-adjusted room.
3. Window Construction
It creates an active execution window around the current trend reference, then limits that window between the risk edge and target edge.
4. Reaction Evaluation
It scores window width, structure alignment, volatility fit, trend support, and candle confirmation into a 0-100 Quality Score.
5. Visual Output
The chart displays the execution window box, risk/target edges, state labels, alerts, and a premium AGPro panel with the key decision fields.
🗺️ How to Read the Chart
Execution Window = the current price area where the script is evaluating execution context.
Risk Edge = the structure-based invalidation edge for the active window.
Target Edge = the nearest meaningful target-side reference or ATR-adjusted room marker.
Labels = the current window state, score tier, risk distance, and room-to-risk context.
Colors = teal for stronger bullish execution windows, pink for bearish or invalidation contexts, amber for forming/waiting states, and indigo for target-edge or transition states.
Panel = the fastest summary of window state, quality score, risk edge, target edge, and next action.
🚦 Signals & States
• ACTIVE → the execution window meets the quality threshold and confirmation filter.
• FORMING → the window is improving but still needs cleaner confirmation.
• WAIT → the context exists, but structure, volatility, room, or confirmation is not strong enough yet.
• BLOCKED → there is no clean execution window in the current context.
• TARGET EDGE → price has reached the mapped target-side reference and reaction quality should be evaluated.
• INVALIDATED → price closed beyond the active risk edge.
🔔 Alerts Logic
ACTIVE Window alerts trigger when the state upgrades into ACTIVE.
Downgrade alerts trigger when the active window weakens from a stronger previous state.
Risk Edge alerts trigger when price closes beyond the current risk edge.
Target Edge alerts trigger when price reaches the current target edge.
Alerts are attention markers only. They are not trading instructions.
🧩 Confluence Logic
The strongest execution-window context appears when several conditions align:
• Price remains inside the mapped execution window
• The risk edge is still structurally valid
• The target edge leaves enough room relative to risk
• Trend support agrees with the active side
• Candle structure confirms the same direction
• Volatility is close to its recent baseline
When these elements align, the Quality Score improves and the panel state becomes easier to interpret.
📊 When to Use
• When you already have a directional thesis and want to evaluate execution context
• During trend continuation setups where risk and target references remain clear
• Around pullback or reset areas where timing and risk quality matter
• Before reacting to a potential continuation candle
• When you want a cleaner planning layer instead of another simple signal indicator
⚠️ When NOT to Use
• During very low-liquidity conditions where candles print irregularly
• During high-noise chop where risk and target edges change too quickly
• During extreme volatility spikes where ATR context becomes distorted
• On symbols with poor price continuity or unreliable session behavior
• As a standalone reason to enter or exit a trade
🎛️ Key Inputs
• Setup Direction → Auto detects the active planning side, or the user can force Long Bias / Short Bias.
• Sensitivity → controls how selective the model is.
• Structure Lookback → controls how risk edge, target edge, and structure context are mapped.
• Minimum ACTIVE Score → defines the score threshold required for ACTIVE state.
• Confirmation Mode → controls how much trend and candle confirmation must align.
• Label Cooldown Bars → controls historical label density.
• Max Visible Labels → limits older state labels to keep the chart readable.
• Label Detail → Compact is the default clean publication view; Balanced and Full can show more risk/room context.
• Label Offset Strength / Lane Strength → smart placement controls that keep labels near price without burying them inside candles or pushing them too far away on higher timeframes.
• Panel Location / Theme / Font Size → controls the AGPro panel presentation.
• Label Font Size → controls all on-chart labels.
🖥️ Interface & Visual Design
The panel is designed as a compact decision dashboard, not a large command center. The first row uses the standard AGPro merged blue header row, and the remaining rows focus only on the information needed to evaluate the current execution window.
The chart visuals stay restrained: one active execution window, one risk edge, one target edge, a current quality tag, and moderate historical state labels. The goal is a premium, readable chart that does not feel empty but also avoids clutter.
🧪 Practical Usage Workflow
1. Read the panel state first.
2. Check whether price is inside or near the execution window.
3. Compare the risk edge and target edge.
4. Review the Quality Score and confirmation state.
5. Interpret labels as context markers, not as trade commands.
6. Confirm the broader market context with your own process.
🔍 Interpretation Guidelines
ACTIVE does not mean guaranteed continuation. It means the current window has passed the script's rule-based quality model.
FORMING means the setup may be developing, but the script does not yet see enough confirmation.
WAIT means the context may exist, but the window quality is not clean enough.
BLOCKED means the current chart does not offer a useful execution window under the selected settings.
TARGET EDGE means the chart has reached the mapped target-side reference, so reaction quality becomes more important than chasing the move.
INVALIDATED means the risk edge has been broken and the active window should be reset.
🚫 What This Script Is NOT
• Not a prediction engine
• Not financial advice
• Not an auto-trading system
• Not a guaranteed signal tool
• Not a full trading suite
• Not an ICT/FVG or order block map
• Not a generic support/resistance zone scanner
⚠️ Limitations & Transparency
Execution-window quality is rule-based and depends on the selected inputs, timeframe, symbol behavior, and available chart data.
Different timeframes can produce different risk and target edges because market structure changes with resolution.
Fast volatility expansion can make the current edge distances less stable.
Low-volume markets may produce weaker confirmation quality.
The script should be interpreted inside broader market context, not in isolation.
🧠 Market Context Notes
Execution quality is usually strongest when structure, volatility, and trend behavior are aligned.
If volatility expands too quickly, the window can become stretched even if direction looks strong.
If the target edge is too close, the setup may have limited room even when the trend looks clean.
If the risk edge is too far away, the setup may require too much tolerance relative to the available room.
🧾 Use Case Examples
When price pulls back toward the active trend reference, remains inside the execution window, and the risk edge is still structurally protected, the Quality Score may improve.
When price reaches the target edge after an ACTIVE window, the script can shift into TARGET EDGE state so the user can evaluate reaction behavior instead of treating the move as fresh.
When price closes beyond the risk edge, the window becomes INVALIDATED and the panel shifts to a reset-oriented state.
🧱 System Philosophy
Execution Window Planner follows the AGPro Series approach: build scripts that help traders make a decision, not just see another signal.
The script is intentionally narrow. It focuses on one practical question and keeps the chart output centered around that question.
🔐 Non-Promise Statement
No script can provide certainty.
No score guarantees future movement.
No alert should be treated as an instruction to trade.
📉 Risk Disclosure
Trading involves risk.
Users are responsible for their own analysis, execution choices, risk management, and trading outcomes.
This script is for educational and analytical use only and does not provide financial advice.
📚 Educational Note
The best use of this script is to study how execution context changes as price moves between risk edge, execution window, and target edge.
Use it as a structured planning aid, not as a replacement for your own market analysis.
Indicator
Risk Exposure Compass [AGPro Series]Risk Exposure Compass
🧠 Core Idea
Is the current chart exposing the trader to balanced risk, or is price already stretched, blocked, or too early?
📌 Overview / What it does
Risk Exposure Compass is a chart-first risk planning tool designed to evaluate the current exposure quality of a setup before the trader treats it as actionable.
Instead of printing generic buy or sell signals, the script studies ATR stretch, range position, distance from the exposure mean, trend maturity, target-edge room, and invalidation distance. These components are converted into a 0-100 Risk Exposure Score and a clear next-action state.
The script produces a risk compass band, invalidation shelf, target-edge guide, exposure heat labels, alerts, and a clean AGPro planning panel. It does not predict price direction, automate execution, calculate position size, or guarantee that a setup will follow through.
🎯 Purpose & Design Philosophy
This script was built for traders who want to ask a practical pre-decision question: is the chart still offering clean exposure, or has the move become too stretched to evaluate cleanly?
The gap it fills is different from a manual risk/reward visualizer, position planner, or risk runway tool. Risk Exposure Compass focuses on the current chart location itself: how far price is from mean, how mature the move is, whether volatility load is normal, whether target room is open, and whether invalidation distance is controlled.
The design supports a disciplined review mindset. It helps users avoid treating every active move as equal by separating balanced exposure, watch context, stretched risk, blocked room, and reset conditions.
⚡ Why This Script Is Different
Most tools focus on entries, support/resistance zones, take-profit ladders, or manual risk/reward boxes.
This script does NOT build a full trade plan, does NOT calculate position size, does NOT create a TP ladder, and does NOT become a dashboard-only stress meter.
Instead, it draws a live risk compass directly on the chart and scores whether the current price location is balanced, extended, blocked by nearby target structure, or too early for clean planning.
⚙️ Methodology
1. Context Detection
The script reads automatic long-side or short-side exposure using mean and trend context, or lets the user force the exposure side manually.
2. Reference Mapping
It maps an exposure mean, active range, structural invalidation shelf, target-edge obstruction, and a projected compass band.
3. Reaction Evaluation
The model scores five core components: ATR stretch, range position, distance from mean, trend maturity, and target obstruction. Invalidation distance and volatility load refine the final state.
4. Visual Output
The output is shown through a centered compass band label, invalidation and target guide lines, compact exposure labels, deterministic alerts, and a premium AGPro panel.
🗺️ How to Read the Chart
Zones = the risk compass band where price is considered more balanced relative to the active exposure mean.
Labels = compact state markers showing BALANCED, WATCH, STRETCHED, BLOCKED, or RESET context.
Colors = teal marks cleaner exposure, pink marks blocked or failed context, amber marks stretched risk, and indigo marks watch or transition states.
Panel = the panel summarizes Exposure State, Risk Score, Volatility Load, Distance Risk, and Action.
🚦 Signals & States
• BALANCED → exposure is inside the compass band with a strong enough score.
• WATCH → exposure quality is developing but not yet clean enough for balanced status.
• STRETCHED → price is extended from mean, late in range position, volatility is overloaded, or invalidation distance is too wide.
• BLOCKED → nearby target-edge room is limited relative to current exposure.
• RESET → the chart is early, unclear, or below the minimum quality threshold.
🔔 Alerts Logic
Alerts trigger when exposure moves into BALANCED, WATCH, STRETCHED, BLOCKED, or RESET state.
These alerts are attention markers. They are not trade instructions, entry signals, exit signals, or automated strategy commands.
🧩 Confluence Logic
The strongest exposure context appears when ATR stretch is controlled, price is not at an extreme range edge, distance from mean is balanced, trend maturity is not too early or too late, and target room remains open.
When these conditions align, the Risk Exposure Score rises and the panel state becomes easier to interpret.
📊 When to Use
• Before evaluating a discretionary setup
• During pullbacks or pauses where risk location matters
• Around continuation attempts after a trend has already moved
• Before breakouts where price may already be extended
• When comparing whether one chart has cleaner exposure than another
⚠️ When NOT to Use
• Extremely low-liquidity symbols
• Very noisy micro-timeframes
• News-driven volatility spikes
• Non-standard chart types that distort candle range and ATR behavior
• Situations where the user expects a signal-only entry tool
🎛️ Key Inputs
• Exposure Side → controls Auto, Long Exposure, or Short Exposure evaluation.
• Range Lookback → defines the range used for price-location scoring.
• ATR Length → normalizes stretch, distance risk, target room, and label offsets.
• Exposure Mean EMA → defines the mean used for the compass band and distance scoring.
• Target Obstruction Lookback → controls how nearby target-edge room is estimated.
• Invalidation Shelf Lookback → controls the structural invalidation reference.
• Sensitivity → adjusts how strict the exposure model is.
• Visual settings → control compass band, guides, candle heat, labels, panel location, theme, and font sizes.
🖥️ Interface & Visual Design
The interface is built around one primary chart object: the risk compass band.
The panel follows the AGPro public-release standard with one merged blue header row containing only the script name. The rows are kept compact so the tool stays readable without becoming dashboard-heavy.
Labels are intentionally short, offset away from candles, and controlled with cooldown and maximum-visible settings.
🧪 Practical Usage Workflow
1. Read the panel Exposure State and Risk Score.
2. Check whether price is inside, below, or beyond the risk compass band.
3. Review Distance Risk to see whether invalidation is controlled, fragile, or too wide.
4. Check target-edge room before treating exposure as clean.
5. Use alerts as review prompts, not as automated trading instructions.
🔍 Interpretation Guidelines
A high score means the chart is closer to balanced exposure according to the script's rule-based model.
A low score means price may be too early, too stretched, blocked by nearby structure, or unclear relative to mean and range position.
The best interpretation comes from reading score, state, volatility load, distance risk, and target room together instead of relying on one label.
🚫 What This Script Is NOT
• Not a prediction engine
• Not financial advice
• Not auto trading
• Not guaranteed signals
• Not a position sizing calculator
• Not a manual risk/reward visualizer
• Not a take-profit ladder
⚠️ Limitations & Transparency
The model is rule-based and depends on recent structure, ATR, moving averages, candle range, and target-edge mapping.
Different timeframes can produce different exposure states because range, trend maturity, and invalidation shelves change with timeframe.
Fast volatility expansion can move the script quickly from balanced to stretched, while low-volatility environments can keep exposure in reset or watch state for longer.
No rule-based tool can know a user's actual execution plan, account risk, broker rules, or broader market thesis.
🧠 Market Context Notes
Risk exposure is not the same as direction.
A chart can be bullish but stretched, bearish but blocked, or directionally interesting while still offering poor exposure quality.
This script is designed to keep that distinction visible.
🧾 Use Case Examples
When price is above the exposure mean, inside the compass band, with controlled invalidation distance and enough target room, the panel can shift toward BALANCED.
When price accelerates far beyond the compass band with hot volatility and a late range position, the script can mark STRETCHED risk.
When price is close to a prior target edge and the room score is weak, the script can mark BLOCKED even if the broader trend still looks strong.
🧱 System Philosophy
The AGPro approach is to turn chart information into structured decision context.
Risk Exposure Compass follows that approach by converting price location into a cleaner review framework: mean, range, volatility, invalidation, target room, score, and next state.
🔐 Non-Promise Statement
This script does not provide certainty.
It does not guarantee that balanced exposure will lead to follow-through.
It only organizes current chart conditions so exposure quality is easier to review.
📉 Risk Disclosure
Trading involves risk.
Users are responsible for their own analysis, execution, risk management, and decisions.
This script is for educational and analytical purposes only and does not provide financial advice.
📚 Educational Note
Use the tool to study how price moves from reset to watch, from watch to balanced, and from balanced to stretched or blocked as market context changes.
Indicator
R-Multiple Progress Map [AGPro Series]R-Multiple Progress Map
🧠 Core Idea
How far has the active move progressed in R terms, and is that progress still healthy enough to monitor?
📌 Overview / What it does
R-Multiple Progress Map is a chart-first trade management overlay that tracks a setup after activation and converts price movement into R-multiple progress.
Instead of acting like a risk/reward calculator, a position sizing tool, or a take-profit promise system, the script focuses on what happens after an active cycle begins. It maps an entry proxy, invalidation proxy, R ladder, current R marker, partial-review bands, pullback-risk state, and a clean AGPro progress panel.
The script does not predict future price movement, place orders, automate trade management, or tell the user what to buy or sell. It is a structured progress-reading layer for discretionary review.
🎯 Purpose & Design Philosophy
This script was built for traders who think in R-multiples but need a cleaner way to read progress quality after a setup becomes active.
Many tools help plan the trade before activation. Fewer tools focus on the management question after activation: is the move actually making progress, is pullback pressure increasing, where is the next R review zone, and what should the user pay attention to now?
The design supports a decision-engine mindset: measure progress, evaluate health, and keep the chart readable without turning it into a crowded signal board.
⚡ Why This Script Is Different
Most tools focus on drawing entry, stop-loss, and take-profit levels before a trade begins.
This script does NOT try to become a full position planner, risk/reward visualizer, position-size calculator, or target ladder.
Instead, it starts from an activated progress cycle and evaluates the move in R terms. The unique output is not a trade instruction. It is a live progress state that separates ACTIVE, BUILDING, PROGRESSING, EXTENDED, PULLBACK RISK, STALLED, INVALIDATED, and WAIT conditions.
⚙️ Methodology
1. Context Detection
The script detects activation using range-break and trend-pulse logic, or allows the user to restrict the map to long-only or short-only progress context.
2. Reference Mapping
When a progress cycle activates, the script stores an entry proxy, invalidation proxy, R-risk unit, active side, active bar, maximum favorable R progress, and adverse R pressure.
3. Reaction Evaluation
The model evaluates R expansion, candle progress, trend support, drawdown pressure, time efficiency, and volatility stability. These components are blended into a 0-100 progress score.
4. Visual Output
The output is shown through an R ladder, centered partial-review bands, live progress fill, current R marker, event labels, alerts, and a compact AGPro panel.
🗺️ How to Read the Chart
Zones = partial-review R bands between key R levels, such as 0.5R-1R, 1R-2R, and 2R-3R.
Labels = activation, R milestone, pullback-risk, stalled-progress, and invalidation markers.
Colors = bullish progress, bearish progress, warning states, and neutral states use the AGPro color language.
Panel = the panel summarizes Current R, Progress Grade, Pullback Risk, Next R Zone, and Action.
🚦 Signals & States
• ACTIVE → a new progress cycle has activated and early R progress is being measured.
• BUILDING → price has started to make useful R progress but is not yet strong enough for a higher-grade state.
• PROGRESSING → the move has reached meaningful R progress with supportive score conditions.
• EXTENDED → progress is advanced and the next R zone deserves review.
• PULLBACK RISK → price has given back enough favorable R progress to deserve caution.
• STALLED → the active cycle has spent time without enough R progress.
• INVALIDATED → the active cycle touched the invalidation proxy.
• WAIT → no active progress cycle is currently being tracked.
🔔 Alerts Logic
Alerts trigger when a new progress cycle activates, when 0.5R, 1R, or 2R progress is reached, when pullback risk increases, when progress stalls, or when the invalidation proxy is touched.
These alerts are attention markers. They are not trade instructions, entry signals, exit signals, or automated strategy commands.
🧩 Confluence Logic
The strongest progress context appears when multiple components align:
R expansion + strong candle progress + trend support + controlled pullback drawdown + efficient timing + stable volatility.
When these components align, the script can classify the active move as PROGRESSING or EXTENDED. If drawdown pressure rises or time efficiency weakens, the state can shift toward PULLBACK RISK or STALLED.
📊 When to Use
• After a breakout or continuation attempt has activated
• While monitoring whether a setup is progressing in clean R terms
• During discretionary trade management review
• When comparing whether a move is building, stalling, or extending
• When the user wants chart-first R progress without a full position-size calculator
⚠️ When NOT to Use
• Extremely low-liquidity symbols
• Very noisy micro-timeframes with unstable wick behavior
• News-driven volatility spikes
• Markets where recent structure cannot define a useful invalidation proxy
• Situations where the user expects a complete risk/reward planning suite
🎛️ Key Inputs
• Progress Side → controls Auto, Long Progress, or Short Progress evaluation.
• Activation Mode → chooses Range Break, Trend Pulse, or Hybrid activation logic.
• Structure Lookback → defines the activation and context window.
• Invalidation Proxy Lookback → maps the R-risk reference used for progress normalization.
• Minimum Activation Score → controls how selective new progress cycles are.
• Pullback Risk R → defines how much R drawdown triggers caution.
• Visual settings → control R ladder, partial-review bands, progress fill, labels, panel location, theme, and font sizes.
🖥️ Interface & Visual Design
The interface is built around one primary idea: R progress after activation.
The R ladder and partial-review bands keep the chart visually informative, while the panel keeps the decision state compact and readable.
Labels are offset away from candles, limited by maximum count, and controlled with cooldown and sparse context settings for a balanced public-release chart.
🧪 Practical Usage Workflow
1. Read the panel action state.
2. Check the current R and maximum R progress.
3. Review whether pullback risk is low, moderate, or high.
4. Look at the next R zone for management context.
5. Treat alerts as attention markers and confirm the broader market context independently.
🔍 Interpretation Guidelines
A higher progress score means the active move is showing stronger alignment between R expansion, trend support, drawdown control, time efficiency, and volatility stability.
PROGRESSING does not mean a trade should be opened or held. It means the active cycle is showing healthier R progress under the script's rule set.
PULLBACK RISK and STALLED are caution states. They help identify when progress may be weakening after an active move has already started.
🚫 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 is not a full position planner, risk/reward visualizer, or position-size calculator.
⚠️ Limitations & Transparency
Timeframe differences can change activation behavior and invalidation proxy placement.
Volatility changes can alter ATR-normalized risk and R-progress readings.
Market structure can shift quickly after news, low-liquidity movement, or aggressive momentum expansion.
The script is rule-based and should be interpreted as an analytical progress layer, not as certainty.
🧠 Market Context Notes
R progress is not only about distance from activation. It also depends on how much progress is being retained, whether trend context still supports the active side, and whether time spent in the setup is becoming inefficient.
The tool is most useful when it helps the user review an active move with discipline instead of reacting emotionally to each candle.
🧾 Use Case Examples
When a trend-pulse activation reaches 1R with strong score conditions and low drawdown, the script may classify the move as PROGRESSING.
When a move reaches 2R but begins giving back a meaningful amount of favorable progress, the script may show PULLBACK RISK.
When a cycle stays active for many bars without reaching useful R progress, the script may show STALLED.
🧱 System Philosophy
R-Multiple Progress Map follows the AGPro Series decision-engine approach:
Progress after activation.
Risk measured in R.
Management context before emotion.
Attention markers instead of promises.
🔐 Non-Promise Statement
No script can guarantee that R progress will continue.
No state should be interpreted as certainty.
All outputs should be reviewed within broader market context.
📉 Risk Disclosure
Trading involves risk.
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
The script is designed to help users think in structured R-progress terms: activation, progress, pullback, stall, invalidation, and review.
Indicator
Setup Lifecycle Tracker [AGPro Series]Setup Lifecycle Tracker
🧠 Core Idea
What stage is this setup in right now: forming, armed, triggered, invalidated, or expired?
📌 Overview / What it does
Setup Lifecycle Tracker is a chart-first setup planning tool that follows a developing market structure through a defined lifecycle window.
Instead of showing another isolated signal, it maps the setup stage, trigger rail, invalidation rail, expiry marker, time risk, and a 0-100 lifecycle quality score directly on the chart.
The script does not predict price, automate execution, or tell users what to trade. It organizes setup context so the trader can evaluate whether the setup is still valid, still early, close to activation, already invalidated, or simply too old.
🎯 Purpose & Design Philosophy
This script was built for traders who want a cleaner way to manage setup timing.
Many setups look interesting when they first appear, but they often decay, trigger too late, or lose their invalidation logic before the trader reacts. Setup Lifecycle Tracker fills that gap by turning setup timing into a visible planning structure.
The design philosophy is simple: a setup should have a stage, a deadline, a risk reference, and a clear next-action state. Without those elements, the chart can become another collection of loose signals.
⚡ Why This Script Is Different
Most tools focus on entry markers, setup scores, or generic support and resistance levels.
This script does NOT try to clone a setup scorecard, create a buy/sell system, or build a broad support/resistance map.
Instead, it tracks the lifecycle of one active setup window. It shows whether the setup is forming, armed near the trigger rail, already triggered, invalidated by its risk rail, or expired because too much time has passed.
⚙️ Methodology
1. Context Detection
The script reads trend context, recent range structure, volatility, candle behavior, and volume support to decide whether a clean setup window can be tracked.
2. Reference Mapping
When a setup forms, the script creates a trigger rail, an invalidation rail, and a lifecycle window between them.
3. Reaction Evaluation
The model evaluates setup maturity, trigger proximity, confirmation strength, time decay, and invalidation distance to produce a 0-100 lifecycle score.
4. Visual Output
The active lifecycle window, stage labels, trigger rail, invalidation rail, expiry marker, candle tint, and panel summarize the current state.
🗺️ How to Read the Chart
Zones = the lifecycle window between trigger and invalidation.
Labels = current lifecycle stage and optional score.
Colors = stage context:
• Blue / indigo = forming
• Yellow = armed
• Green = triggered
• Red / pink = invalidated or expired
Panel = the compact AG Pro summary showing Stage, Quality Score, Time Risk, Invalidation, and Action.
🚦 Signals & States
• FORMING → a setup window has been detected but is not yet close enough to the trigger rail.
• ARMED → price is close enough to the trigger rail and the lifecycle score is strong enough to deserve attention.
• TRIGGERED → the tracked setup moved beyond its configured trigger condition.
• INVALIDATED → price crossed the invalidation rail and the setup context is no longer valid.
• EXPIRED → the setup stayed active too long without a useful lifecycle resolution.
🔔 Alerts Logic
The script includes alerts for:
• New lifecycle window forming
• Setup armed near the trigger rail
• Setup triggered
• Setup invalidated
• Setup expired
• High-quality lifecycle threshold reached
Alerts are attention markers only. They are not trade instructions, automated entries, or guaranteed outcome signals.
🧩 Confluence Logic
The lifecycle score becomes stronger when setup maturity, trigger proximity, confirmation strength, time health, and invalidation fit align.
For example, a setup that is mature, close to the trigger rail, supported by directional candle behavior, and not too close to invalidation will generally score better than an old setup with weak confirmation and high time risk.
📊 When to Use
• Breakout preparation
• Pullback continuation planning
• Range compression before expansion
• Setups that need a time limit
• Charts where invalidation needs to stay visible
• Traders who want to separate early setups from late setups
⚠️ When NOT to Use
• Extremely low-liquidity markets
• Charts with unreliable volume and erratic candles
• Very noisy micro timeframes
• Extreme volatility spikes where ATR-based references expand too quickly
• Situations where the user wants a direct buy/sell signal instead of a planning map
🎛️ Key Inputs
• Setup Side → selects automatic, long-side, or short-side lifecycle tracking.
• Trigger Model → controls how the setup moves into TRIGGERED state.
• Setup Lookback → defines the forming range used for trigger and invalidation mapping.
• Sensitivity → changes how strict the lifecycle detection and confirmation logic feels.
• Expiry Bars → controls how long an untriggered setup can stay active.
• Minimum Quality Score → defines the threshold for stronger lifecycle contexts.
• Panel / Label Settings → control panel position, theme, font size, label size, and label density.
🖥️ Interface & Visual Design
The interface is built around a single chart-first lifecycle window.
The panel is intentionally compact. It does not replace the chart; it summarizes the active state so the user can quickly read the setup stage, score, time risk, invalidation, and next context action.
Labels are kept moderate and offset away from candles to preserve readability.
🧪 Practical Usage Workflow
1. Read the panel stage.
2. Check the lifecycle window between trigger and invalidation.
3. Watch whether the setup moves from FORMING to ARMED.
4. Review the trigger rail and invalidation rail.
5. Use the expiry marker to avoid stale setup interpretation.
6. Confirm the broader market context before making any decision.
🔍 Interpretation Guidelines
A high lifecycle score means the current setup context is cleaner according to the script's rule set.
An ARMED state means the setup is close to the trigger area, not that a trade must be taken.
An EXPIRED state means time quality has degraded.
An INVALIDATED state means the tracked setup lost its mapped risk reference.
🚫 What This Script Is NOT
• Not a prediction engine
• Not financial advice
• Not an auto-trading tool
• Not a guaranteed signal system
• Not a generic support/resistance mapper
• Not a clone of Setup Quality Scorecard
⚠️ Limitations & Transparency
Lifecycle windows depend on lookback, ATR behavior, and recent structure.
Different timeframes can produce different setup stages.
High-volatility conditions may expand rails and change score behavior.
Low-liquidity symbols can create unstable ranges and misleading candle structure.
🧠 Market Context Notes
Setup lifecycle quality is strongest when structure, volatility, and timing align.
A setup can be technically visible but still weak if it is too old, too far from the trigger rail, too close to invalidation, or unsupported by confirmation behavior.
🧾 Use Case Examples
When price compresses below a range edge and the lifecycle window turns ARMED, the trader can observe whether the trigger rail is reached before the expiry marker.
When a setup remains FORMING for too long, the time risk row helps identify whether the context is becoming stale.
When price crosses the invalidation rail, the script marks the lifecycle as INVALIDATED so the previous setup is no longer treated as active.
🧱 System Philosophy
AGPro tools are designed to help traders read market context with structure and restraint.
Setup Lifecycle Tracker follows that philosophy by converting setup timing into a visible planning workflow instead of adding another isolated signal marker.
🔐 Non-Promise Statement
No script can provide certainty.
No score, state, label, 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, or guaranteed trading outcomes.
Users remain responsible for their own decisions, risk management, and position sizing.
📚 Educational Note
The main educational purpose of this script is to help users think in lifecycle stages: setup formation, activation risk, invalidation, time decay, and context review.
Indicator
Trailing Stop Quality [AGPro Series]Trailing Stop Quality
🧠 Core Idea
Is the current trailing reference defending the move cleanly, or is it creating noise that deserves a risk review?
📌 Overview / What it does
Trailing Stop Quality is a trade-management planner built for traders who want more context around active trailing stops, defense rails, and risk-shift conditions.
The script compares a swing defense rail with a volatility defense rail, evaluates trend-defense quality, measures pullback depth, checks volatility expansion, and converts the result into a 0-100 trailing stop quality score.
It produces trail rails, a centered risk-shift zone, a target-room guide, compact state labels, alerts, and a clean AGPro panel. It does not predict price direction, automate trading, or tell users what to buy or sell.
🎯 Purpose & Design Philosophy
Many trailing stop tools show a stop line, but they do not explain whether the current trail is structurally clean, too close to noise, too loose, or in conflict with another management reference.
This script was built to fill that gap.
It helps traders who already have a move in progress and want to evaluate whether the active trail is still defending the move with enough quality to keep monitoring.
The design philosophy is simple: manage context before reacting to the line.
⚡ Why This Script Is Different
Most tools focus on plotting a trailing stop line, flipping side, or marking stop transitions.
This script does NOT clone a Chandelier Exit flip-zone tool, does not act as a stop-loss optimizer, and does not print direct trade commands.
Instead, it scores the quality of the current trail using swing defense, volatility defense, trend slope, pullback depth, volatility expansion, and rail conflict. The result is a management-readiness layer, not another raw stop signal.
⚙️ Methodology
1. Context Detection
The script reads the active management side automatically or lets the user force long-side or short-side evaluation.
2. Reference Mapping
It maps two trail references: a swing defense rail and a volatility defense rail. The tighter reference becomes the active defense rail.
3. Reaction Evaluation
It scores whether the active trail is balanced, too near, too loose, conflicted, or already broken.
4. Visual Output
It displays the active defense rail, swing rail, volatility rail, risk-shift zone, target guide, compact labels, alerts, and AGPro panel state.
🗺️ How to Read the Chart
Zones = the risk-shift zone shows the gap between the swing defense rail and volatility defense rail. Its centered label summarizes the active conflict or quiet state.
Labels = labels mark TRAIL HOLDS, RISK SHIFT, MONITOR, NOISE, ROOM LIMITED, or DEFENSE LOST contexts.
Colors = green highlights clean defense, pink highlights lost defense, amber highlights risk review, and indigo highlights monitor context.
Panel = the panel summarizes Trail Quality, Stop Distance, Trend Defense, Risk Shift, and Action.
🚦 Signals & States
• TRAIL HOLDS → the active trail is defending cleanly with enough score and no major risk-shift conflict.
• RISK SHIFT → price is close to the active rail or swing and volatility rails disagree enough to deserve review.
• MONITOR → trail quality is acceptable but not strong enough for a clean defense state.
• NOISE → the current trail reference is low quality or too unstable.
• ROOM LIMITED → forward room is limited relative to the active trail risk.
• DEFENSE LOST → price crossed the active defense rail and the current trail context should be reviewed.
🔔 Alerts Logic
Alerts trigger when the script detects a clean trail-hold state, risk-shift state, monitor state, noisy trail state, defense-loss event, or limited target-room condition.
Alerts are attention markers only.
They are not trade instructions and should be interpreted within broader market context.
🧩 Confluence Logic
The strongest context appears when swing defense and volatility defense are aligned, the active trail distance is balanced, trend slope supports the management side, pullback depth is controlled, and volatility is expanding without becoming chaotic.
When those conditions align, the 0-100 trail quality score improves.
📊 When to Use
• During active trend-following management
• After a move has already started and trailing references matter
• When comparing swing-based trail behavior with volatility-based defense
• During pullbacks where the trail may be too close to price
• When evaluating whether a move still has reasonable room before the next structure edge
⚠️ When NOT to Use
• Very low-liquidity symbols with erratic wick behavior
• Extremely noisy chop where no stable management side exists
• Event-driven spikes where volatility changes too quickly
• Charts where the user wants entry signals instead of trail-quality context
🎛️ Key Inputs
• Management Side → controls Auto, Long Management, or Short Management mode.
• Swing Trail Lookback → controls the structural defense rail.
• Volatility Rail Multiple → controls the ATR-based volatility defense rail.
• Sensitivity → adjusts how strict the trail-quality scoring model is.
• Minimum Clean Score → defines when the trail can qualify as a clean defense state.
• Target Guide R Multiple → sets the forward planning reference used for target-room context.
• Visual settings → control rails, risk-shift zone, target guide, labels, panel location, panel theme, and font sizes.
🖥️ Interface & Visual Design
The interface is intentionally chart-first.
The rails show the actual management references, the zone shows swing-versus-volatility conflict, and the panel gives a fast decision read without turning the script into a crowded dashboard.
The AGPro panel uses a single merged blue header row and keeps the key state visible at a glance.
🧪 Practical Usage Workflow
1. Read the panel Trail Quality state.
2. Check whether the active defense rail is still below price in long management or above price in short management.
3. Review the risk-shift zone to see whether swing and volatility references agree.
4. Check whether the target guide still has reasonable forward room.
5. Use the label state as an attention marker, then confirm with broader structure and market context.
🔍 Interpretation Guidelines
Think of the output as trail-quality context, not a trade signal.
A high score means the active trail is better aligned with structure, volatility, trend defense, and pullback depth.
A low score means the current trailing reference may be too noisy, too close, too loose, or already losing defensive value.
🚫 What This Script Is NOT
• Not a prediction engine
• Not financial advice
• Not auto trading
• Not guaranteed signals
• Not a Chandelier Exit clone
• Not a stop-loss optimizer
• Not a buy or sell signal tool
⚠️ Limitations & Transparency
Trailing stop quality can change quickly when volatility expands, contracts, or when price moves into noisy pullback conditions.
Different timeframes may produce different trail rails and score behavior.
Fast markets, low liquidity, and abnormal wick behavior can reduce the usefulness of any rule-based trail-quality model.
🧠 Market Context Notes
Trail quality is not only about distance from price.
It also depends on whether structure is still defending the move, whether volatility is stable enough to support the rail, and whether the next target area leaves enough room relative to current trail risk.
🧾 Use Case Examples
When price trends higher and both swing defense and volatility defense remain below price with a strong score, the script may mark TRAIL HOLDS.
When price compresses toward the active trail or swing and volatility rails separate too much, the script may mark RISK SHIFT.
When price crosses the active defense rail, the script may mark DEFENSE LOST so the user can review the management context.
🧱 System Philosophy
Trailing Stop Quality belongs to the AGPro planner-style family: tools designed to help traders evaluate context before decisions, rather than simply adding another signal to the chart.
🔐 Non-Promise Statement
No output from this script guarantees a result.
No score represents certainty.
📉 Risk Disclosure
Trading involves risk.
Users are responsible for their own decisions, position sizing, and risk management.
This script is for educational and analytical purposes only and does not provide financial advice.
📚 Educational Note
The goal is to make trailing stop context easier to inspect by separating clean defense, risk shift, noisy trails, limited room, and lost defense states.
Indicator
Stop Distance Quality [AGPro Series]Stop Distance Quality
🧠 Core Idea
Is the invalidation distance structurally reasonable, or is it too tight, too wide, or too exposed to noise?
📌 Overview / What it does
Stop Distance Quality is a chart-first risk planning tool built to evaluate stop-distance quality before a setup is treated as clean.
The script studies the active invalidation rail, ATR-normalized stop distance, swing structure fit, wick risk, volatility context, and available target room. It converts those components into a 0-100 risk-quality score and a clear next-action state.
It produces a stop-fit band, an invalidation rail, an ideal-fit guide, compact chart labels, alerts, and a clean AGPro planning panel. It does not select the best stop method, size positions, predict price direction, or automate trade decisions.
🎯 Purpose & Design Philosophy
This script was built to fill a specific planning gap: many tools show where a stop could be placed, but fewer tools ask whether that stop distance is structurally usable.
It helps traders who already have a setup idea and want to evaluate whether the invalidation distance is balanced enough to keep watching.
The design supports disciplined planning: measure the risk first, then decide whether the setup deserves attention.
⚡ Why This Script Is Different
Most tools focus on plotting stop-loss levels, comparing stop-loss methods, or attaching stops to entry signals.
This script does NOT act as a stop-loss optimizer, position-size calculator, target ladder, or directional signal tool.
Instead, it answers one practical planning question: is the current stop distance too tight, too wide, or reasonably aligned with structure and volatility?
⚙️ Methodology
1. Context Detection
The script selects long or short evaluation context using either manual side selection or automatic trend and range-location reading.
2. Reference Mapping
It maps one active swing-based invalidation rail and builds a stop-fit band using minimum, ideal, and maximum ATR-normalized distance boundaries.
3. Reaction Evaluation
It scores stop distance, swing structure fit, wick risk, volatility context, and target room.
4. Visual Output
It displays the stop-fit band, invalidation rail, ideal-fit guide, chart labels, alerts, and AGPro panel state.
🗺️ How to Read the Chart
Zones = the stop-fit band shows the acceptable ATR-normalized area where the active invalidation distance is considered more balanced.
Labels = labels mark FIT, WATCH, TOO TIGHT, TOO WIDE, NO ROOM, or invalidation-check contexts.
Colors = AGPro green highlights balanced fit, pink highlights wide-risk pressure, amber highlights caution, and indigo highlights active watch context.
Panel = the panel summarizes Stop Distance, ATR Context, Structure Fit, Risk Quality, and Action.
🚦 Signals & States
• FIT → stop distance is structurally reasonable enough for active review.
• WATCH → risk quality is improving but not strong enough for FIT.
• TOO TIGHT → invalidation distance is too close relative to ATR and may be vulnerable to normal noise.
• TOO WIDE → invalidation distance is too large relative to the current chart context.
• NO ROOM → target room is not clean enough for the current risk distance.
• WEAK FIT → the current context does not meet the minimum quality threshold.
🔔 Alerts Logic
Alerts trigger when the script enters FIT, WATCH, TOO TIGHT, TOO WIDE, or NO ROOM state.
An additional alert can trigger when price crosses the prior invalidation rail.
Alerts are attention markers only. They are not trade instructions.
🧩 Confluence Logic
The strongest context appears when stop distance sits near the ideal ATR band, swing structure is clear, wick noise is controlled, volatility is readable, and target room remains open.
When several of these conditions align, the risk-quality score improves.
📊 When to Use
• Before evaluating a risk-defined setup
• During pullbacks where invalidation placement matters
• Around breakout retests where stops can be too tight or too wide
• In structured trending or range-extension environments
⚠️ When NOT to Use
• Very low-liquidity symbols with erratic wicks
• Extremely noisy markets where ATR changes too quickly
• News-driven candles or abnormal event spikes
• Charts where no clear swing invalidation exists
🎛️ Key Inputs
• Evaluation Side → controls Auto, Long Context, or Short Context scoring.
• ATR Length → normalizes stop distance, wick risk, target room, and visual offsets.
• Invalidation Lookback → controls the swing rail used as the active invalidation reference.
• Minimum / Ideal / Maximum Stop ATR → define the stop-fit band.
• FIT / WATCH Thresholds → control how selective the planner is.
• Visual settings → control band visibility, guide lines, labels, panel location, theme, and font sizes.
🖥️ Interface & Visual Design
The interface is intentionally narrow and readable.
The chart focuses on one main visual object: the stop-fit band. The panel uses a single merged AGPro header row and keeps the essential risk-quality information visible without turning the script into a dashboard-heavy tool.
Labels are compact, offset from candles, and controlled with cooldown and maximum-visible settings.
🧪 Practical Usage Workflow
1. Read the panel risk-quality state.
2. Check whether the invalidation rail sits inside, below, or beyond the stop-fit band.
3. Review whether the label says FIT, WATCH, TOO TIGHT, TOO WIDE, or NO ROOM.
4. Confirm structure and volatility context before treating the setup as meaningful.
🔍 Interpretation Guidelines
Think of the output as a risk-quality filter, not a trade signal.
A FIT state means the distance is more balanced relative to ATR and structure. It does not mean price must move favorably.
A TOO TIGHT or TOO WIDE state means the risk reference may need more context, more buffer, or a cleaner setup.
🚫 What This Script Is NOT
• Not a prediction engine
• Not financial advice
• Not auto trading
• Not guaranteed signals
• Not a stop-loss optimizer
• Not a position-sizing calculator
⚠️ Limitations & Transparency
Stop-distance quality can change as volatility expands or contracts.
Different timeframes may produce different invalidation rails and ATR readings.
Fast markets, low liquidity, and abnormal wick behavior can reduce the usefulness of any rule-based distance model.
🧠 Market Context Notes
Risk quality is not only about where a stop sits. It also depends on whether volatility is readable, whether the swing reference is meaningful, and whether there is enough room before nearby obstruction.
This script keeps those factors visible without adding unrelated signal logic.
🧾 Use Case Examples
When price pulls back in a trend and the invalidation rail sits inside the stop-fit band, the setup can move into review mode.
When the stop distance is below the minimum ATR boundary, the script may mark TOO TIGHT and suggest waiting for more buffer.
When stop distance is large but target room is limited, the script may mark NO ROOM or TOO WIDE.
🧱 System Philosophy
Stop Distance Quality belongs to the AGPro planner-style family: tools that help traders evaluate context before decisions, rather than simply printing another signal.
🔐 Non-Promise Statement
No output from this script guarantees a result.
No score represents certainty.
📉 Risk Disclosure
Trading involves risk.
Users are responsible for their own decisions, position sizing, and risk management.
This script is for educational and analytical purposes only and does not provide financial advice.
📚 Educational Note
The goal is to make risk distance easier to inspect and compare across changing volatility conditions.
Indicator
