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

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

Breakout Failure Recovery [AGPro Series]Breakout Failure Recovery
🧠 Core Idea
After a failed breakout, is price recovering through the reclaim level or confirming the failure?
📌 Overview / What it does
Breakout Failure Recovery is a chart-first failed-breakout lifecycle planner built to evaluate what happens after price probes outside a recent range and closes back inside.
The script maps a failure box, reclaim trigger, risk shelf, recovery/rejection labels, and a compact AGPro panel. It converts close-back-inside behavior, reclaim speed, retest response, volume behavior, and time decay into a 0-100 Recovery Score with a clear next-action state.
It does not predict the next move, automate execution, or act as a generic failed-break signal. Its purpose is to organize the post-failure decision context.
🎯 Purpose & Design Philosophy
This script was built for traders who do not want to treat every failed breakout the same way.
Some failed breaks recover quickly through the original breakout level. Others reject the boundary, lose time, and confirm that the attempt has failed. This tool focuses on that decision window.
The design supports a planner mindset: identify the failure, measure the reclaim attempt, locate the risk shelf, and decide whether the context deserves review or should be downgraded.
⚡ Why This Script Is Different
Most tools mark a failed break as a single event.
This script does NOT stop at the failed-break label, does not clone a Swing Failure Pattern engine, and does not become a generic breakout-failure signal board.
Instead, it evaluates the recovery path after the failure. The main output is a recovery state: Recovery Active, Recovery Watch, Failure Confirmed, Reclaim Pending, Window Decaying, or No Active Failure.
⚙️ Methodology
1. Context Detection
The script builds a recent range from prior bars and checks whether price probes beyond the upper or lower boundary before closing back inside.
2. Reference Mapping
When a failed break appears, it maps the failure box, reclaim trigger, and risk shelf around the failed boundary.
3. Reaction Evaluation
The model scores close-back-inside quality, reclaim speed, retest response, volume behavior, and time decay.
4. Visual Output
The result is shown through centered failure-box text, a centered risk-shelf label, reclaim/reject labels, alert conditions, and a clean AGPro planning panel.
🗺️ How to Read the Chart
Failure Box = the failed-break excursion outside the recent range.
Reclaim Trigger = the level that shows the original breakout attempt is trying to recover.
Risk Shelf = the boundary zone where retest response should be reviewed.
Labels = compact markers for failed break, reclaim, reject, decay, and watch context.
Colors = teal highlights constructive recovery context, pink highlights failure or rejection pressure, amber highlights shelf review, and indigo highlights watch states.
Panel = summarizes Failure State, Recovery Score, Reclaim Level, Risk Zone, and Action.
🚦 Signals & States
• Failed Breakout Detected → price probed outside the recent range and closed back inside.
• Recovery Watch → recovery conditions are developing, but reclaim confirmation is incomplete.
• Recovery Active → reclaim behavior and the Recovery Score have reached stronger review context.
• Failure Confirmed → price rejects the failed boundary or moves deeper back into the range.
• Reclaim Pending → an active failure exists, but recovery conditions are not strong enough yet.
• Window Decaying → the failed-break context is getting old and should carry less weight.
🔔 Alerts Logic
Alerts trigger when a failed breakout is detected, when Recovery Watch appears, when Recovery Active appears, or when Failure Confirmed appears.
Alerts are attention markers only. They are not trade instructions, entry commands, exit commands, or automated strategy rules.
🧩 Confluence Logic
The strongest recovery context appears when price closes back inside the range, reclaims the failed boundary quickly, shows a constructive retest response, receives supportive volume, and does not lose too much time after the failed break.
When these components weaken, the script can shift toward Reclaim Pending, Window Decaying, or Failure Confirmed.
📊 When to Use
• After a breakout attempt closes back inside a recent range
• During range-bound markets with frequent boundary tests
• Around failed expansion attempts where reclaim quality matters
• When deciding whether a failed breakout deserves continued monitoring
• On liquid symbols where range, volume, and candle behavior are readable
⚠️ When NOT to Use
• Very low-liquidity symbols with unstable candles
• Extremely noisy micro-timeframes
• News-driven spikes where levels lose structure quickly
• Markets with unreliable volume data
• Situations where the user expects a direct signal-only tool
🎛️ Key Inputs
• Failure Range Lookback → controls the recent range used to detect failed breaks.
• Failure Probe ATR → defines how far price must probe beyond the range boundary.
• Recovery Window Bars → controls how long the failed-break recovery window stays relevant.
• Retest / Shelf ATR → controls risk shelf thickness and boundary response tolerance.
• Recovery Active Threshold → sets the minimum score for the strongest recovery state.
• Label and Panel Font Size → controls chart labels, centered zone text, and panel readability.
🖥️ Interface & Visual Design
The interface is designed to stay chart-first.
The failure box gives the visual story. The reclaim trigger and risk shelf define the practical review frame. Labels remain compact and controlled so the chart stays active without becoming crowded.
The AGPro panel uses a merged blue title row and a compact decision layout for fast reading.
🧪 Practical Usage Workflow
1. Read the panel state and Recovery Score.
2. Check the failure box and failed boundary.
3. Compare price behavior against the reclaim trigger.
4. Review the risk shelf and rejection response.
5. Treat alerts as attention markers, then evaluate broader market context.
🔍 Interpretation Guidelines
Think in terms of failed-break lifecycle, not prediction.
A stronger Recovery Score means the failed breakout is attempting to reclaim quickly with better response and participation. A weaker score means the failure may be aging, rejecting, or losing structural quality.
Failure Confirmed does not mean the market must continue in one direction. It means the failed-break attempt is not recovering cleanly within the current rule set.
🚫 What This Script Is NOT
• Not a prediction engine
• Not financial advice
• Not auto trading
• Not guaranteed signals
• Not a generic failed-break signal
• Not a Swing Failure Pattern clone
⚠️ Limitations & Transparency
The script is rule-based and depends on recent price, volatility, range, volume, and candle behavior.
Different timeframes can change how failure and recovery appear. Volatility spikes can temporarily distort boundary behavior. Symbols with unreliable volume may produce weaker participation readings.
Outputs should always be interpreted with broader market structure, liquidity, and risk context.
🧠 Market Context Notes
Failed breakouts are most useful when the boundary is readable and the follow-up reaction is clear.
A quick reclaim can show that the failed attempt is recovering. A weak retest, slow response, or deep move back into the range can show that the failed break is confirming instead.
🧾 Use Case Examples
When price probes above a range, closes back inside, then quickly reclaims the upper boundary with supportive volume, the planner may classify the context as Recovery Active.
When price probes above a range, closes back inside, retests the boundary from below, and rejects again, the planner may classify the context as Failure Confirmed.
🧱 System Philosophy
AGPro planning tools are designed to help traders evaluate context before reacting.
This script follows that philosophy by turning failed breakouts into a structured decision question: is the attempt recovering, aging, or confirming failure?
🔐 Non-Promise Statement
No indicator can provide certainty.
This tool provides structured visual context and rule-based attention markers. It does not guarantee continuation, reversal, recovery, or rejection.
📉 Risk Disclosure
Trading involves risk. Market conditions can change quickly, and no script can remove uncertainty.
Users are responsible for their own analysis, risk management, and decisions.
This script is for educational and analytical use only and does not provide financial advice.
📚 Educational Note
Use the planner to study how failed breakouts behave after the first rejection, how reclaim speed affects context, and how risk shelves help organize post-failure review.
Indicator

Range Expansion Risk Planner [AGPro Series]Range Expansion Risk Planner
🧠 Core Idea
Does a range expansion offer clean room, or is price moving into immediate failure risk?
📌 Overview / What it does
Range Expansion Risk Planner is a chart-first breakout quality and risk-planning tool built for one specific moment: price has left a defined range, and the trader needs to understand whether the expansion has enough structure to deserve attention.
Instead of printing generic breakout signals, the script maps the source range, freezes the broken edge, builds an expansion runway, tracks a failure rail, estimates target room, evaluates retest behavior, and converts those conditions into a 0-100 planner score.
The script produces a source range box, expansion runway, failed-expansion review band, risk/target rails, full-state labels, deterministic alerts, and a clean AGPro panel. It does not predict future price movement, automate execution, or guarantee that a breakout will continue.
🎯 Purpose & Design Philosophy
This script was built for traders who want to evaluate range expansion quality after price leaves a structure, not simply react to the first candle outside the range.
Many tools mark breakouts, draw range boxes, or highlight volatility expansion. The gap is the planning layer after the break: Is the source range mature? Was the expansion candle strong enough? Did price close clearly beyond the edge? Is the retest accepted or weak? Is there enough room before the next target-side reference?
The design supports a decision-first workflow. It helps users separate a clean range expansion from a weak release, blocked room, failed expansion, or early unconfirmed movement.
⚡ Why This Script Is Different
Most tools focus on breakout arrows, range highs/lows, volatility spikes, or support/resistance zones.
This script does NOT become a generic range breakout signal, a generic S/R zone map, a squeeze indicator, or a target predictor.
Instead, it evaluates the quality of the expansion plan after the range edge is broken. The main output is not a trade command. It is a planning state that helps the user decide whether the current expansion is CLEAN, on REVIEW, waiting for retest, blocked by room risk, or failing back into the source range.
⚙️ Methodology
1. Context Detection
The script maps the active source range using a user-defined lookback and detects whether price has closed beyond the upper or lower edge with enough ATR-normalized distance.
2. Reference Mapping
When a qualified expansion appears, the script freezes the source range, the broken edge, the failure rail, and the target-room marker so the plan can be reviewed consistently.
3. Reaction Evaluation
The model scores range maturity, expansion candle quality, close beyond edge, retest quality, target-room distance, and failure-rail distance.
4. Visual Output
The result is displayed through a source range box, expansion runway, failed-expansion band, risk/target rails, full-state event labels, alerts, and a premium AGPro panel.
🗺️ How to Read the Chart
Zones = the source range shows where the expansion came from. The expansion runway shows the path between the broken edge and the target-room marker. The failed-expansion band shows the area where the release may be losing structure.
Labels = full-state markers show Range Expansion, Clean Expansion, Expansion Review, Retest Accepted, Failed Expansion, Target Room Reached, Failure Risk, or Range Watch context.
Colors = teal highlights cleaner bullish expansion, pink highlights bearish or failed contexts, amber highlights review/risk states, and indigo highlights watch or target-edge states.
Panel = the panel summarizes Range Maturity, Expansion Risk, Room Risk, Confirmation, and Action.
🚦 Signals & States
• CLEAN EXPANSION → range expansion quality is strong enough to deserve active review.
• REVIEW → expansion context is developing, but confirmation or target room is incomplete.
• WAIT RETEST → price has expanded, but the broken edge has not yet been accepted clearly.
• ROOM BLOCKED → target-side room is limited relative to the current risk structure.
• FAILURE RISK → price is back inside the range or close to the failed-expansion area.
• FAILED → price crossed the failure rail and the prior expansion plan should be reviewed.
• TARGET EDGE → price reached the active target-room marker.
• RANGE WATCH → the range is mature enough to monitor, but no qualified expansion is active yet.
🔔 Alerts Logic
Alerts trigger when the planner enters clean expansion, review state, retest accepted state, failed-expansion warning, or target-room reached state.
These alerts are attention markers only. They are not trade instructions, entry signals, automated strategy commands, or guaranteed outcomes.
🧩 Confluence Logic
The strongest context appears when a mature source range releases with a strong expansion candle, price closes clearly beyond the edge, target-side room remains open, the failure rail is not too far away, and the broken edge receives constructive retest behavior.
When those components align, the planner score improves and the action state becomes cleaner.
📊 When to Use
• After price leaves a clear range
• During breakout-review workflows
• When comparing whether a release has enough room to justify attention
• When price retests the broken range edge
• On liquid symbols where ATR, range, and volume behavior are readable
• Especially on 4H swing charts, where range release, retest behavior, failure risk, and target-room context remain visually readable
⚠️ When NOT to Use
• Extremely low-liquidity symbols
• Very noisy micro-timeframes
• News-driven candles that distort the range edge
• Markets with frequent gaps or unreliable volume
• Situations where the user expects a simple buy/sell signal
🎛️ Key Inputs
• Expansion Side → controls Auto, Long Expansion, or Short Expansion planning.
• Sensitivity → changes how selective the range maturity and edge-close requirements are.
• Source Range Lookback → defines the range used before expansion.
• ATR Length → normalizes failure rail, label spacing, expansion distance, and room risk.
• Retest Review Bars → controls how long an edge retest can improve confirmation quality.
• Target-Side Obstacle Lookback → searches for older target-side references before using the measured target.
• CLEAN / REVIEW Scores → adjust how strict the state model is.
• Visual settings → control boxes, runway, rails, labels, panel location, theme, and font sizes.
🖥️ Interface & Visual Design
The interface is built around one primary decision path: source range → expansion runway → failure rail → target room.
The panel uses the AGPro public-release standard with one merged blue header row containing only the script name. It keeps the decision fields readable without turning the chart into a crowded dashboard.
Labels keep full professional state names, are offset away from candles, and are limited by cooldown and max-visible controls.
🧪 Practical Usage Workflow
1. Read the panel action state.
2. Check whether the source range was mature enough before expansion.
3. Review the expansion runway and target-room marker.
4. Check whether price accepted the broken edge or moved back into failure risk.
5. Use alerts as attention markers, then evaluate the broader market context.
🔍 Interpretation Guidelines
A higher score means the model sees better alignment between source range quality, expansion candle quality, edge close, retest behavior, and target room.
CLEAN EXPANSION does not mean a trade must be taken. It means the expansion structure is clean enough to deserve active review.
REVIEW means the release may be developing, but the user should check confirmation and room quality before treating it as clean.
FAILED and FAILURE RISK are caution states. They help identify when an expansion is losing structure after leaving the range.
🚫 What This Script Is NOT
This script is not a prediction engine.
It is not financial advice.
It is not an auto-trading system.
It does not provide guaranteed signals.
It does not replace user judgment, risk management, or broader market analysis.
⚠️ Limitations & Transparency
Timeframe differences can change how range maturity, retests, and target-room references appear.
Volatility changes can widen failure rails or reduce clean target room.
Fast market conditions can move from CLEAN to FAILED quickly if price returns into the source range.
The script is rule-based and should be interpreted as an analytical planning layer, not as certainty.
🧠 Market Context Notes
Range expansion quality is not only about breaking the edge. A cleaner expansion usually needs a readable source range, a decisive close beyond the edge, enough room before obstruction, and a failure reference that is not too wide.
The planner is most useful when it prevents users from treating every breakout as equal.
🧾 Use Case Examples
When price closes beyond a mature range and the target-room marker remains far enough away, the planner may move into REVIEW or CLEAN EXPANSION.
When price retests the broken edge and holds outside the range, confirmation can improve.
When price closes back through the failure rail, the planner marks FAILED so the old expansion idea is not treated as clean anymore.
🧱 System Philosophy
Range Expansion Risk Planner follows the AGPro Series decision-engine approach:
Context first.
Risk before reaction.
Structure before signal.
Attention markers instead of promises.
🔐 Non-Promise Statement
No indicator can remove uncertainty.
No score, state, label, alert, range box, runway, or rail should be interpreted as guaranteed market direction.
📉 Risk Disclosure
Trading involves risk.
All decisions remain the responsibility of the user.
This script is for educational and analytical chart review only and does not provide financial advice.
📚 Educational Note
Use this script to study how range expansions develop, how broken edges behave after release, and how failure risk can be organized visually before making discretionary decisions.
Indicator

Compression Breakout Readiness [AGPro Series]Compression Breakout Readiness
🧠 Core Idea
Is compression mature enough for a breakout watch state, or is the range still early, noisy, or structurally weak?
📌 Overview / What it does
Compression Breakout Readiness is a chart-first breakout planning tool designed to evaluate whether a compressed range has developed enough maturity to deserve active attention.
Instead of printing a generic breakout signal, the script studies range contraction, ATR compression, pivot tightening, volume dry-up, directional side bias, invalidation-edge distance, and projected breakout room. These components are converted into a 0-100 Readiness Score and a clear next-action state.
The script produces an active compression box, breakout watch corridor, invalidation edge, target guide, compact state labels, alerts, and a clean AGPro planning panel. It does not predict direction, automate execution, or guarantee that a breakout will follow through.
🎯 Purpose & Design Philosophy
This script was built for traders who want to evaluate the quality of compression before reacting to a breakout attempt.
Many breakout tools only mark the moment price crosses a level. The more useful planning question often comes earlier: is the range actually tight, mature, quiet, and biased enough to watch, or is the structure still too loose?
The design supports a decision-first workflow: identify compression, measure readiness, check risk edge, review the watch side, then decide whether the chart deserves attention.
⚡ Why This Script Is Different
Most tools focus on squeeze dots, breakout arrows, generic consolidation boxes, or simple high/low range breaks.
This script does NOT act as a generic squeeze indicator, a choppiness filter, a support/resistance mapper, or a direct buy/sell signal generator.
Instead, it evaluates compression maturity before and around the breakout edge. The main output is not a trade command. It is a readiness state that helps the user separate READY WATCH conditions from early, neutral, overheated, or invalidated compression contexts.
⚙️ Methodology
1. Context Detection
The script maps the active compression range and evaluates whether current volatility and range width are contracting relative to their baselines.
2. Reference Mapping
It builds the compression box, active breakout watch corridor, invalidation edge, and target guide from the current structure.
3. Reaction Evaluation
The model scores range contraction, ATR compression, pivot tightening, volume dry-up, side bias, and compression age. It also checks whether the invalidation edge is too tight, too wide, or balanced.
4. Visual Output
The result is shown through centered zone text, compact chart labels, clean edge lines, deterministic alerts, and a premium AGPro panel.
🗺️ How to Read the Chart
Compression Box = the active range being evaluated for breakout readiness.
Breakout Watch Corridor = the planning area beyond the active compression edge.
Invalidation Edge = the opposite-side reference used to judge risk context.
Labels = compact state markers such as READY WATCH, WATCH, EDGE REVIEW, PREMATURE, HOT RISK, and INVALID EDGE.
Colors = teal for bullish watch context, pink for bearish or invalid context, amber for caution, and indigo for watch/neutral emphasis.
Panel = the panel summarizes Compression Age, Readiness Score, Expansion Side, Risk Edge, and Action.
🚦 Signals & States
• READY WATCH → compression is mature, biased, and risk edge distance is balanced enough for active review.
• WATCH → compression is developing, but at least one readiness component remains incomplete.
• EDGE REVIEW → price has moved beyond the compression edge and the user should verify the close and broader context.
• PREMATURE → compression has not lasted long enough to build strong maturity.
• HOT RISK → volatility has expanded too aggressively for clean readiness interpretation.
• NO BIAS → compression exists, but the directional side is not clear enough in Auto mode.
• INVALID EDGE → price crossed the active invalidation edge and the prior context may need reset.
🔔 Alerts Logic
Alerts trigger when the planner enters READY WATCH, WATCH, EDGE REVIEW, HOT RISK, or INVALID EDGE state.
These alerts are attention markers. They are not trade instructions, entry signals, broker actions, or automated strategy commands.
🧩 Confluence Logic
The strongest readiness state appears when multiple components align:
Range contraction + ATR compression + pivot tightening + volume dry-up + directional side bias + balanced risk edge.
When those components improve together, the score can rise toward READY WATCH. If volatility becomes too hot, risk becomes distorted, or the active edge fails, the state downgrades.
📊 When to Use
• Before evaluating a possible breakout setup
• During narrow ranges where volatility is compressing
• Around coiling structures that need maturity review
• When comparing whether one compression range is cleaner than another
• On liquid symbols where range, ATR, and volume behavior are meaningful
⚠️ When NOT to Use
• Extremely low-liquidity markets
• Highly noisy micro-timeframes
• News-driven volatility spikes
• Symbols with unreliable or missing volume data
• Situations where the user wants a simple breakout arrow or automated trade signal
🎛️ Key Inputs
• Breakout Watch Side → selects Auto, Bullish Watch, or Bearish Watch evaluation.
• Compression Lookback → defines the active range used for readiness scoring.
• ATR Baseline → controls volatility compression comparison.
• Volume Dry-Up Length → evaluates whether participation is contracting inside compression.
• Minimum Compression Age → controls how mature a range must be before stronger readiness states appear.
• READY / WATCH Thresholds → adjust how selective the planner is.
• Visual settings → control compression box, breakout corridor, range edges, invalidation edge, projection length, labels, and candle tint.
• Panel settings → control panel visibility, location, theme, and font size.
🖥️ Interface & Visual Design
The interface is intentionally chart-first.
The compression box uses centered text so the user can read score and age directly inside the structure. The breakout corridor provides a clean forward planning reference without filling the chart with many competing levels.
The AGPro panel uses a single merged blue header row and a compact five-row decision layout. Label and panel font sizes are adjustable, with Normal as the default.
🧪 Practical Usage Workflow
1. Read the panel Readiness Score and Action.
2. Check whether the compression box is mature or premature.
3. Review the Expansion Side and breakout watch corridor.
4. Compare the Risk Edge with the visible structure.
5. Treat labels and alerts as review prompts, not trade commands.
🔍 Interpretation Guidelines
A higher score means the script sees stronger compression maturity according to its rule set.
READY WATCH does not mean price must break out. It means the compression context is organized enough to deserve attention.
WATCH means the structure may be developing but is not fully mature.
HOT RISK and INVALID EDGE are caution states. They warn that the range may no longer be clean enough for the same readiness read.
🚫 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 generic squeeze indicator.
It is not a choppiness dashboard.
It is not a support/resistance scanner.
It is not a direct breakout entry tool.
⚠️ Limitations & Transparency
Compression quality depends on the selected lookback, timeframe, volatility baseline, and market condition.
Volume dry-up may be less reliable on symbols with inconsistent exchange volume.
Fast volatility expansion can quickly change the readiness state.
Different timeframes can show different compression ranges and side-bias context.
The script is rule-based and should be interpreted as an analytical planning layer, not as certainty.
🧠 Market Context Notes
Compression by itself is not enough.
A useful breakout watch context also needs maturity, reduced noise, a readable side, and a practical invalidation edge.
This script keeps those elements visible so users can review breakout readiness before reacting emotionally to a candle crossing a range edge.
🧾 Use Case Examples
When a range contracts, ATR falls below baseline, volume dries up, and side bias becomes clear, the planner may move toward WATCH or READY WATCH.
When price pushes beyond the edge while readiness is acceptable, the script can mark EDGE REVIEW so the user can verify the close and broader context.
When ATR expands too aggressively before structure is mature, the planner can show HOT RISK instead of treating every move as a clean breakout context.
🧱 System Philosophy
Compression Breakout Readiness follows the AGPro Series decision-engine approach:
Context first.
Readiness before reaction.
Risk edge before target guide.
Attention markers instead of promises.
🔐 Non-Promise Statement
No script can remove uncertainty.
No state, score, label, alert, box, corridor, or line should be interpreted as guaranteed market direction.
📉 Risk Disclosure
Trading involves risk.
All decisions remain the responsibility of the user.
This script is for educational and analytical chart review only and does not provide financial advice.
📚 Educational Note
Use the script to study how compression matures, weakens, breaks, or invalidates around range edges. The strongest reading comes from combining the panel state with the visible chart structure and broader market context.
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

Adaptive Fibonacci Trailing System [WillyAlgoTrader]🚀 Adaptive Fibonacci Trailing System (AFT) is a premium overlay toolkit that combines a regime-aware adaptive trailing stop, a dynamic Fibonacci premium/discount cloud, a 6-factor confidence grading engine, full SL/TP risk management with break-even logic, and a built-in backtest tracker — all in one indicator. Every signal arrives with a clear direction, a confidence grade (A+ / A / B / C), a recommended position size, and pre-placed stop-loss and three take-profit levels.
This is not a static trailing stop. This is not another Fibonacci retracement tool you have to draw by hand. This is a complete trade-management system that automatically detects market structure, classifies the current regime (Trending / Ranging / Volatile), adapts its stop placement to the conditions, scores every setup from 0 to 100%, and tracks every closed trade so you can see whether your settings actually work on your market.
🎯 WHO THIS IS FOR
— Trend traders who want a structural trailing stop that adapts to volatility instead of trailing a fixed percentage
— Swing traders who need clean Buy/Sell signals with pre-calculated SL, TP1, TP2, TP3
— Day traders and scalpers who need fast regime detection so they don't trade trend signals in a ranging market
— Discretionary traders who want a confidence score to filter low-quality setups
— Systematic traders who want JSON webhook alerts for automation
— Anyone tired of generic Fibonacci tools that ignore market context
— Traders who want a built-in backtest tracker to validate the system on their own market and timeframe
💎 WHY TRADERS CHOOSE THIS INDICATOR
✅ Adaptive trailing stop — not a fixed ATR multiple.
The trailing stop is anchored to Fibonacci levels of the most recent swing range and adjusts itself based on the detected regime. In trending markets it widens to let winners run. In ranging markets it tightens to exit fast. In volatile markets it sits at the midpoint. You don't choose a static distance — the indicator chooses the right distance for current conditions.
✅ Built-in market regime detection.
Every bar is classified as Trending , Ranging , or Volatile using ADX and a volatility ratio (current ATR vs. 50-bar average). Hysteresis is applied so the regime doesn't flicker on borderline values. You always know what kind of market you're in before you take the trade.
✅ Dynamic Fibonacci cloud.
A premium/discount zone is drawn live between the 0.382 and 0.618 levels of the current swing structure. The cloud re-anchors automatically every time the structure changes — no manual drawing, no stale levels from last week. Three visual styles available: Gradient, Solid, or Pulsing (brightens when price approaches the 0.5 inflection point).
✅ Two signal modes for two trader styles.
Trail Flip mode fires signals only when the adaptive trail flips direction — fewer signals, strong trend conviction. 0.5 Cross mode fires when price crosses the Fibonacci 0.5 (premium/discount inflection) with full triple-confirmation — earlier entries, more signals. The 0.5 Cross mode also has three strictness levels (Strict / Relaxed / None) so you can dial signal frequency to match your style.
✅ 6-factor confidence score on every signal.
Every Buy/Sell signal comes with a percentage score and a letter grade. Grades range from D (poor) to A+ (premium setup). The score combines structure strength, regime alignment, ADX strength, volume, volatility favorability, and Fibonacci/SMA50 confluence — weighted into a single number you can filter on. Set a minimum confidence threshold and weak signals are blocked automatically.
✅ Adaptive position sizing.
Set your base risk per trade once. The indicator scales it by signal grade: C grade gets 0.5× base, B grade 0.75×, A grade 1.0×, A+ grade 1.5×. You take small positions on average setups and larger positions on premium setups — automatically. Recommended risk % is shown live in the dashboard.
✅ Full risk management with one-click presets.
Choose Conservative, Balanced, Aggressive, Scalping, or Custom. Every Buy/Sell signal automatically draws Entry, SL, TP1, TP2, TP3 lines on the chart with price and percent-from-entry labels. Lines extend forward and update live until the trade closes.
✅ Break-even trail after TP1.
When TP1 is hit, the stop-loss automatically moves to entry. Your remaining position becomes risk-free. The original SL line dims to show it's no longer active, and the entry label updates to "→ SL (BE)" so you always know where the real stop is.
✅ Built-in backtest tracker — per-grade.
Every closed trade is tracked: total trades, wins, losses, win rate, average R, profit factor, total R. Then it's broken down by confidence grade so you can see whether A+ signals actually outperform B signals on your market. If they don't, you know to retune. The tracker auto-resets when you change critical inputs so old stats never pollute new tests.
✅ Triple-confirmation breakout filter.
Direction changes require body ratio + ATR-based penetration + regime gate. No more wick-based fakeouts triggering position flips. You can dial the strictness for both modes independently.
✅ Universal — works on every market and timeframe.
Forex, crypto, stocks, futures, indices. Scalping (1m, 5m), intraday (15m, 1h), swing (4h, 1D), position (1W). The structure engine adapts to whatever pivot length you set. Volume is auto-detected and gracefully ignored on FX where it's unreliable.
✅ Professional dashboard with full live state.
At a glance: Regime, ADX, Volatility ratio, Signal mode, Confidence + grade, Suggested risk %, Direction, Trail Stop price, Timeframe, full SL/TP/RR/Risk block, and a complete Backtest section with per-grade breakdown.
✅ Alerts in plain text or JSON for webhooks.
Buy / Sell / SL hit / TP1, TP2, TP3 hit / Break-even activated. JSON payload includes ticker, timeframe, price, SL, all three TPs, R:R, regime, mode, confidence, grade, and recommended risk % — ready to feed any automation pipeline.
🚀 HOW IT CHANGES YOUR WORKFLOW
Before: You draw Fibonacci retracements by hand on every swing. You guess where to place the stop — fixed ATR multiple, recent low, gut feel. You take signals in any market without checking if it's trending or ranging. You have no idea whether your "best" setups actually win more often. You miss break-even opportunities and watch winners turn into losers. You manage three TPs in your head and forget which one was already hit.
After: You add the indicator. The Fibonacci cloud is already drawn — re-anchored to the current swing automatically. The dashboard tells you the regime, the signal grade, and the recommended risk % before you click Buy. SL, TP1, TP2, TP3 are pre-placed and labeled with prices and percentages. When TP1 hits, your stop is moved to entry without you touching anything. Every closed trade is logged and broken down by grade. After 50 trades, you know exactly which signal mode and confidence threshold work on your market.
What used to take 5 minutes of manual setup per trade now takes 5 seconds — read the dashboard, decide.
📖 HOW TO USE
🎯 Quick start (for beginners):
1. Add the indicator to your chart (any market, any timeframe).
2. Look at the dashboard in the top-right corner. It tells you the regime (Trending / Ranging / Volatile), the current confidence score, and the suggested risk %.
3. Wait for a "▲ Long " or "▼ Short " label to appear under or above a candle. The grade letter (C, B, A, A+) tells you the quality of the signal.
4. The indicator automatically draws Entry, SL, TP1, TP2, TP3 lines on the right side of the chart with prices and percentages.
5. Place your trade with the suggested risk % from the dashboard. Use the SL and TP levels exactly as drawn.
6. When TP1 hits (line turns cyan with a ✓), your SL automatically moves to entry — your trade is now risk-free. Let it run to TP2 and TP3.
7. The Backtest panel at the bottom of the dashboard tracks every closed trade. Watch your stats grow.
👁️ Reading the chart:
— 🟢 Green "▲ Long " label = Buy signal with grade letter
— 🔴 Red "▼ Short " label = Sell signal with grade letter
— 🟡 The colored cloud between two Fib lines = the current premium/discount zone
— The middle dotted line (Fib 0.5) = the inflection between premium and discount
— Solid colored line that follows price = the adaptive trailing stop (green when long, red when short)
— Blue dotted line = your entry price
— Red solid line = your stop-loss
— Green dashed lines (3 of them) = TP1, TP2, TP3
— When a TP is hit, its line turns cyan and the label gets a ✓ check mark
— When break-even activates, the SL line dims and the entry label becomes amber with "→ SL (BE)"
📊 Dashboard fields:
— Regime : current market state (Trending, Ranging, Volatile)
— ADX : trend strength number
— Vol Ratio : how volatile the market is right now (1.0 = average)
— Signal : which signal mode is active and its strictness
— Confidence : the score and grade of the most recent / pending signal
— Sugg. Risk : the recommended position size as % of account
— Direction : current trail direction (Bullish / Bearish / Flat)
— Trail Stop : the live trailing stop price
— TF : your current timeframe
— SL / TP1 / TP2 / TP3 : active trade levels (BE @ price when break-even is on)
— R:R : risk-to-reward ratio at TP1
— Risk : distance from entry to SL as % of price
— Backtest section : Trades, Win Rate, Avg R, Profit Factor, Total R
— By Grade : same stats broken down by A+ / A / B / C / D
💡 Trading ideas:
— Trend-follower setup : Use Trail Flip mode + Conservative risk preset on 1H or 4H. Take only A and A+ signals. Let trades run to TP3.
— Premium/discount swing setup : Use 0.5 Cross + Strict + Balanced risk on 15m or 1H. The 0.5 cross catches reversals at the Fibonacci inflection point.
— Scalping setup : Use 0.5 Cross + Relaxed + Scalping preset on 1m or 5m. Lower the minimum confidence to 50%. Exit at TP1 or TP2.
— Confirmation overlay : Run AFT alongside your existing system. Only take your trades when AFT confidence shows B or higher in the same direction.
— Beginner-safe mode : Set minimum confidence to 75 (A grade or above). Use Conservative risk preset. Let break-even handle most management.
— Backtest-then-trade workflow : Toggle Reset Backtest, scroll the chart back, let the indicator collect 30+ trades, check the per-grade stats, then start trading the grades that perform best.
🔧 Tuning guide:
— Too many signals? Increase Min Confidence (try 60 or 75), or switch from "None" to "Strict" cross strictness, or use Trail Flip mode.
— Too few signals? Lower Min Confidence (try 40 or 50), or set strictness to "Relaxed" or "None".
— Stop too tight? Switch trailing mode from Aggressive to Balanced or Conservative, or pick the Conservative risk preset.
— Stop too wide? Switch to Aggressive trailing mode or Aggressive / Scalping risk preset.
— Whipsaw on ranging markets? Increase Breakout Confirmation to 0.3 or 0.5, raise Min Body Ratio to 0.6.
— Want only premium setups? Set Min Confidence to 90 (A+ only). Expect 1-3 signals per week on most markets.
⚙️ KEY FEATURES
🏛️ Structure Engine:
— Score-filtered swing detection (every swing is rated by ATR-normalized impulse and volume)
— Adjustable pivot length (3 to 50 bars)
— Memory of the last 5 swings for stable Fibonacci anchoring
— Optional swing labels showing the score number
📡 Market Regime Engine:
— ADX-based trend detection with adjustable threshold
— Volatility ratio (current ATR vs. 50-bar average) for volatile-state detection
— Hysteresis on both thresholds — no regime flicker
— Optional background highlight for 10 bars after each regime change
🎯 Trailing Stop Engine:
— 4 modes: Aggressive (tight), Balanced, Conservative (wide), Adaptive (auto-adjusts to regime)
— Volatility-inverse adjustment: tighter in low vol, wider in high vol
— Direction-locked update: longs only lift the stop, shorts only lower it
— Triple-confirmation breakout filter (body ratio + ATR penetration + regime gate)
🌀 Fibonacci Cloud:
— Auto-anchored to the latest valid swing high/low
— 3 visual styles: Gradient, Solid, Pulsing
— Optional confluence markers when a Fib level aligns with SMA50
— Toggleable Fib level lines (0.382 / 0.5 / 0.618)
🛡️ Risk Management:
— 5 presets: Conservative, Balanced, Aggressive, Scalping, Custom
— ATR-based stop sizing with adjustable multiplier
— Three take-profit levels with adjustable risk-multiples
— Break-even trail toggle (moves SL to entry on TP1 hit)
— Live SL/TP lines with price + percent-from-entry labels
— Position lock: new signals are blocked while a trade is active
🎓 Confidence & Sizing Engine:
— 6-factor scoring (structure / regime / ADX / volume / volatility / confluence)
— 5 grades: D / C / B / A / A+
— Minimum confidence filter (0–100%) blocks weak signals
— Adaptive position sizing toggle scales risk by grade
— Adjustable base risk % per trade
📈 Backtest Tracker:
— Tracks every closed trade (closed by SL or TP3)
— Win/loss outcome model with TP1/TP2/TP3 partial-success recognition
— Win rate, average R, profit factor, total R
— Per-grade breakdown (validate the confidence engine on your market)
— Auto-reset on critical input changes
🎨 Visual System:
— Auto / Dark / Light theme detection
— Configurable label and dashboard font sizes
— Compact Pro-style design — no chart clutter
— Optional WillyAlgoTrader watermark
🔔 Alert System:
— Buy / Sell signals with full payload
— SL Hit, TP1/TP2/TP3 Hit, Break-even Activated
— Plain text or JSON webhook format
— Bar-close confirmed (no repainting)
📊 Dashboard:
— 5 position options (corners + middle right)
— 3 font sizes
— Adapts to your visible feature set (collapses sections that aren't enabled)
⚠️ IMPORTANT NOTES
— 🚫 No repainting. All signals fire only on confirmed bar close. Pivots use equal left/right lookback (the swing point is in the past by N bars — this is delayed confirmation, not repainting). Alerts use alert.freq_once_per_bar_close.
— 📐 The trailing stop and Fibonacci anchors require at least two opposing swings in memory. Fresh charts and new symbols need a brief warm-up period (typically 50 bars).
— 📐 On markets with no reliable volume data (most FX pairs), the volume-confirmation factor is replaced by a neutral default. The indicator works fully on FX.
— ⚖️ The backtest tracker counts only confirmed closures (SL hit or TP3 hit). Partial profits at TP1/TP2 are recognized in the win/loss outcome but realize at the level reached when the trade ultimately closes. Real-trading slippage, spread, and fees are not modeled.
— ⚖️ The confidence score is a quantitative filter, not a prediction of profit. It reflects setup quality based on the inputs available — not future performance.
— 🛠️ This is an analysis and trade-management tool, not an automated trading bot. It detects structure, classifies regime, scores setups, places SL/TP levels, and tracks outcomes — trade decisions remain yours .
— 🌐 Universal compatibility — works on all markets (Forex, crypto, stocks, futures, indices) and all timeframes from 1m to 1M. 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

Entry Timing Quality [AGPro Series]Entry Timing Quality
🧠 Core Idea
Is the current setup timing early, improving, in-window, late, or already exhausted?
📌 Overview / What it does
Entry Timing Quality is a chart-first execution timing tool built to evaluate when a setup deserves attention from a timing perspective.
The script produces a 0-100 Timing Score, a timing window, an invalidation rail, target-side room context, early / improving / prime / late / exhausted state labels, a momentum clock marker, alert conditions, and a clean AGPro panel.
It does not predict price direction, automate execution, print directional commands, or replace a trader's own setup model. Its purpose is to organize timing quality after a setup thesis already exists.
🎯 Purpose & Design Philosophy
This script was built for traders who already see a possible setup but need a cleaner way to judge whether the timing is too early, becoming actionable, already extended, or no longer fresh.
The gap it fills is specific: many tools show entries, signals, levels, or broad readiness states, but they do not isolate the timing phase of a setup.
The design supports a disciplined execution-review mindset: timing first, risk context second, action only after independent confirmation.
⚡ Why This Script Is Different
Most tools focus on printing entries, highlighting generic signals, or building full trade plans.
This script does NOT act as a full Entry Execution Readiness system, Position Planner, Reward Room Analyzer, or directional signal indicator.
Instead, it answers a narrower timing question: is the setup still early, improving into a better timing window, in a prime timing phase, late, exhausted, or structurally invalidated?
⚙️ Methodology
1. Context Detection
The script detects the active timing side automatically from trend structure, or lets the user force long-side or short-side timing review.
2. Reference Mapping
It maps a timing window around the active trigger reference, an invalidation rail from recent structure, a late timing rail, and target-side reference room.
3. Reaction Evaluation
The model scores trigger proximity, candle efficiency, pullback maturity, momentum reset, volatility expansion, risk distance, and target-side room.
4. Visual Output
The chart displays the active timing window, target-side room context, invalidation rail, late timing rail, momentum clock marker, event labels, alerts, and the AGPro panel.
🗺️ How to Read the Chart
Zones = the timing window and target-side room context.
Invalidation rail = the structural level that weakens or resets the current timing read.
Late timing rail = the area where timing may become extended rather than fresh.
Labels = compact markers for Early, Improving, Prime, Late, Exhausted, and Invalidated states.
Colors = teal for stronger long-side timing context, pink for short-side or invalidation context, amber for early or late caution, and indigo for improving timing.
Panel = the fast decision cockpit showing Timing Score, Window State, Momentum Phase, Risk Distance, and Action.
🚦 Signals & States
• PRIME -> timing score and confirmation conditions align inside or near the active timing window.
• IMPROVING -> timing is building but has not reached the Prime threshold.
• EARLY -> the setup exists, but timing still needs cleaner proximity, reset, or candle quality.
• LATE -> price has stretched away from the timing window and may be less fresh.
• EXHAUSTED -> extension, pullback damage, or momentum heat suggests the timing phase needs reset.
• INVALIDATED -> price closed beyond the structural invalidation rail.
🔔 Alerts Logic
Prime Timing alerts trigger when the state upgrades into Prime Timing.
Improving Timing alerts trigger when the setup moves into an active monitoring state.
Late / Exhausted alerts trigger when the timing phase becomes stretched or no longer fresh.
Invalidation alerts trigger when price closes beyond the active invalidation rail.
Alerts are attention markers. They are not trading instructions.
🧩 Confluence Logic
Timing quality improves when trigger proximity, candle efficiency, pullback maturity, momentum reset, stable volatility, trend support, and target-side room align.
The score is intentionally multi-factor so a single candle or a single trend condition cannot dominate the timing read.
📊 When to Use
• Pullback timing reviews
• Trend continuation setups that need timing discipline
• Breakout continuation setups after a reset
• Execution-review workflows where a setup thesis already exists
• Charts where the user wants to avoid chasing late movement
⚠️ When NOT to Use
• Very low-liquidity symbols
• Extremely noisy sideways markets
• News-shock volatility spikes
• Charts where no independent setup thesis exists
• Situations where exact broker-level execution rules are required
🎛️ Key Inputs
• Timing Side -> Auto, Long Timing, or Short Timing review mode.
• Sensitivity -> adjusts how early or selective the timing model becomes.
• Timing Lookback -> affects structure references, pullback maturity, risk distance, and target-side room.
• Minimum Prime Timing Score -> sets the threshold required for Prime Timing.
• Confirmation Mode -> controls how much candle, trend, and momentum confirmation is required.
• Label Cooldown / Max Visible Labels -> controls label density and chart cleanliness.
• Visual settings -> control timing window, momentum clock marker, label offsets, and font sizes.
• Panel settings -> control panel visibility, location, theme, and font size.
🖥️ Interface & Visual Design
The panel follows the AGPro public-release standard with one merged blue header row containing only the script name.
The chart is designed to feel active but not crowded. It uses one timing window, one invalidation rail, one late rail, target-side room context, a compact momentum clock marker, and controlled event labels.
Label and panel font sizes are adjustable, with Normal as the default.
🧪 Practical Usage Workflow
1. Read the panel Timing Score and Window State.
2. Check whether price is inside, near, late beyond, or away from the timing window.
3. Review the Momentum Phase to see whether timing is resetting, expanding, hot, or cooling.
4. Compare Risk Distance with target-side room context.
5. Treat Prime Timing as a review state, not as an automatic execution command.
🔍 Interpretation Guidelines
A high Timing Score means the modeled timing conditions are cleaner than usual according to the script's rules.
An Improving state can be useful because it shows timing is building but not yet fully aligned.
A Late or Exhausted state does not mean price must reverse. It means the timing read is no longer fresh and should be reviewed with extra caution.
The best interpretation comes from reading score, state, momentum phase, risk distance, and invalidation together.
🚫 What This Script Is NOT
• Not a prediction engine
• Not financial advice
• Not auto trading
• Not guaranteed signals
• Not a full position-sizing planner
• Not a directional command system
• Not a full reward-room or target-planning tool
⚠️ Limitations & Transparency
The model is rule-based and depends on recent structure, ATR, moving-average context, candle behavior, and RSI-based momentum reset.
Different timeframes can produce different timing windows and invalidation rails.
Fast volatility expansion can move a setup from Improving to Late quickly.
No rule-based tool can know future price behavior, order-book conditions, spreads, or a user's execution plan.
🧠 Market Context Notes
Timing is most useful when read together with broader market structure, liquidity, trend condition, volatility, and session context.
A setup can have good direction but poor timing.
A setup can also have a clean timing window but poor broader context.
🧾 Use Case Examples
When price pulls back near the timing window, momentum resets, candle quality improves, and risk distance remains controlled, the state may move from Early to Improving or Prime.
When price stretches far beyond the late rail while momentum becomes hot, the script may mark Late or Exhausted rather than encouraging the user to chase.
When price closes beyond the invalidation rail, the active timing read is marked as Invalidated.
🧱 System Philosophy
AGPro tools are designed to convert visible chart information into structured decision context.
This script follows that philosophy by separating timing quality from generic signals, full trade planning, or prediction language.
🔐 Non-Promise Statement
No script can provide certainty.
No timing score can guarantee a future outcome.
This tool organizes visible timing conditions so users can perform a more structured 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 script to study how timing improves, becomes prime, stretches late, exhausts, or invalidates around a structured execution window.
Indicator

Invalidation Quality Planner [AGPro Series]Invalidation Quality Planner
🧠 Core Idea
Is the active invalidation shelf meaningful enough to build a plan around, or is it fragile, distant, weak, or already violated?
📌 Overview / What it does
Invalidation Quality Planner is a chart-first risk planning tool designed to evaluate the quality of the level that would invalidate a setup idea.
Instead of drawing generic support/resistance zones or printing buy/sell signals, the script studies one active invalidation shelf and converts its structure into a 0-100 quality score. It measures swing clarity, defended reactions, prior violations, wick pressure, volatility buffer, forward room, and violation risk.
The output is a focused planning workflow: an invalidation shelf zone, shelf and violation guides, forward-room reference, compact event labels, alerts, and a clean AGPro decision panel. It does not predict future price movement, automate decisions, or guarantee that any shelf will hold.
🎯 Purpose & Design Philosophy
This script was built for traders who want to judge whether their risk reference is structurally meaningful before relying on it.
Many tools show entries, targets, support/resistance zones, or stop distances. This tool focuses on the deeper planning question: is the invalidation level itself strong enough to deserve trust?
The design supports a disciplined setup-review mindset. It helps users separate a clean invalidation shelf from a weak, noisy, overextended, or already violated one.
⚡ Why This Script Is Different
Most tools focus on signals, stop-loss placement, support/resistance mapping, or risk/reward drawings.
This script does NOT become a generic S/R zone map, a stop-loss optimizer, a position-size calculator, a target ladder, or an entry signal tool.
Instead, it evaluates the quality of the invalidation reference. The core output is not a trade command. It is a planning state that helps users decide whether the current shelf is VALID, on WATCH, FRAGILE, DISTANT, DEFENDED, WEAK, or VIOLATED.
⚙️ Methodology
1. Context Detection
The script detects the active planning side using trend context and range location, or allows the user to force long-context or short-context evaluation.
2. Reference Mapping
It maps the active invalidation shelf from confirmed swing pivots, with a fallback structure reference when no fresh pivot is available.
3. Reaction Evaluation
The model scores swing clarity, defended shelf reactions, clean history, wick pressure, ATR-normalized shelf distance, volatility context, violation risk, and forward room.
4. Visual Output
The output is shown through an invalidation shelf zone, violation guide, forward-room guide, compact labels, deterministic alerts, and a premium AGPro panel.
🗺️ How to Read the Chart
Zones = the active invalidation shelf used by the planner. It is a risk reference, not a generic support/resistance zone.
Labels = compact state markers showing VALID, WATCH, DEFENDED, FRAGILE, DISTANT, WEAK, or VIOLATED context.
Colors = teal marks cleaner planning context, pink marks violation or weak context, amber marks caution, and indigo marks watch/transition context.
Panel = the panel summarizes Invalidation Quality, Distance, Structure Support, Violation Risk, and Action.
🚦 Signals & States
• VALID → the active invalidation shelf has enough structure and quality to deserve review.
• WATCH → the shelf is improving but not clean enough for VALID state.
• DEFENDED → price tested the shelf and closed back in favor of the active planning side.
• FRAGILE → price is too close to the shelf, making normal noise more important.
• DISTANT → the shelf is too far from price for clean planning context.
• WEAK → the shelf lacks enough structure, reaction memory, or clean history.
• VIOLATED → price crossed the active violation guide and the context should be rebuilt.
🔔 Alerts Logic
Alerts trigger when the planner enters VALID state, enters WATCH state, detects a defended shelf reaction, marks a weak/fragile/distant shelf, or detects a shelf violation.
These alerts are attention markers. They are not trade instructions, entry signals, exit commands, or automated strategy actions.
🧩 Confluence Logic
The strongest invalidation context appears when swing clarity, defended reactions, clean violation history, controlled wick pressure, balanced ATR distance, and sufficient forward room align.
When those factors align, the quality score rises and the panel can move from WATCH to VALID. If the shelf becomes too close, too distant, noisy, or violated, the state downgrades.
📊 When to Use
• Before evaluating a discretionary setup
• During pullbacks where a structural invalidation shelf is forming
• Around continuation setups where risk needs a clean reference
• Before breakout or reclaim attempts where the failure point matters
• When comparing whether one setup has a cleaner invalidation reference than another
⚠️ When NOT to Use
• Extremely low-liquidity symbols
• Very noisy micro-timeframes with unstable wicks
• News-driven volatility spikes
• Markets where recent structure is distorted and no useful invalidation shelf exists
• Situations where the user expects a signal-only entry tool
🎛️ Key Inputs
• Planning Side → controls Auto, Long Context, or Short Context evaluation.
• Shelf Pivot Left / Right → controls how strict the confirmed swing shelf detection is.
• Shelf Fallback Lookback → defines the backup structure reference when no fresh pivot exists.
• Reaction Memory Lookback → controls how far back defended reactions and violations are counted.
• Shelf Zone Buffer ATR → controls the width of the invalidation shelf zone.
• Violation Buffer ATR → controls when price is treated as crossing beyond the shelf.
• VALID / WATCH Thresholds → adjust how selective the planner is.
• Visual settings → control shelf zones, guide lines, memory zones, labels, panel location, theme, and font sizes.
🖥️ Interface & Visual Design
The interface is built around one primary chart object: the invalidation shelf zone.
The panel follows the AGPro public-release standard with one merged blue header row containing only the script name. The layout keeps the key planning information readable without turning the script into a dashboard-heavy overlay.
Labels are compact, offset away from candles, and controlled with cooldown and maximum-visible settings.
🧪 Practical Usage Workflow
1. Read the panel Invalidation Quality and Action state.
2. Check whether price is respecting, approaching, or violating the shelf zone.
3. Review the Distance row to see whether the shelf is balanced, fragile, or distant.
4. Compare Structure Support with Violation Risk.
5. Treat alerts as review prompts and confirm the broader market context before making any decision.
🔍 Interpretation Guidelines
A higher score means the planner sees stronger alignment between shelf structure, reaction memory, clean history, distance quality, violation risk, and forward room.
VALID does not mean a trade must be taken. It means the invalidation shelf is meaningful enough to deserve attention.
WATCH means the shelf may be developing but still needs stronger evidence.
FRAGILE, DISTANT, WEAK, and VIOLATED are caution states that help users avoid building a plan around a poor invalidation reference.
🚫 What This Script Is NOT
• Not a prediction engine
• Not financial advice
• Not auto trading
• Not guaranteed signals
• Not a generic support/resistance mapper
• Not a stop-loss optimizer
• Not a position sizing calculator
• Not a take-profit planner
⚠️ Limitations & Transparency
Pivot-based shelves are confirmed after the selected pivot strength completes, so the script is intentionally reactive rather than predictive.
Different timeframes can create different shelf references, reaction counts, and violation-risk readings.
Volatility changes can alter ATR-normalized distance, shelf width, and forward-room conditions.
The script is rule-based and should be interpreted as an analytical planning layer, not as certainty.
🧠 Market Context Notes
Invalidation quality is not only about distance. A shelf can be close but meaningful, distant but inefficient, or visually obvious but already weakened by violations.
The planner is most useful when it helps the user ask better questions before trusting a setup idea.
🧾 Use Case Examples
When price pulls back toward a clean swing shelf, defends it, and still has enough forward room, the planner may show DEFENDED or VALID context.
When price is sitting directly on the shelf with heavy wick pressure, the planner may mark FRAGILE even if the level looks visually interesting.
When price crosses beyond the violation guide, the planner marks VIOLATED so the old risk reference is not treated as still clean.
🧱 System Philosophy
Invalidation Quality Planner follows the AGPro Series decision-engine approach:
Context first.
Risk reference before target.
Structure before signal.
Attention markers instead of promises.
🔐 Non-Promise Statement
No indicator can remove uncertainty.
No state, score, label, alert, or visual zone should be interpreted as guaranteed market direction.
📉 Risk Disclosure
Trading involves risk.
All decisions remain the responsibility of the user.
This script is for educational and analytical chart review only and does not provide financial advice.
📚 Educational Note
Use the tool to study how invalidation references form, defend, weaken, or fail across different market conditions.
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

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

No-Progress Failure Map [AGPro Series]No-Progress Failure Map
🧠 Core Idea
Did price trigger a setup but fail to travel far enough afterward?
📌 Overview / What it does
No-Progress Failure Map is a post-trigger execution failure planner designed to evaluate whether an active setup is actually moving after it triggers, or simply stalling around the trigger area.
The script builds a progress window, maps a risk shelf, projects a minimum progress rail, tracks elapsed bars, measures distance travelled in ATR, evaluates candle efficiency, reads volume participation, and converts the result into a 0-100 Progress Score with a clear action state.
It does not predict price direction, automate trading, or print guaranteed entry or exit commands. Its purpose is to organize the question of progress versus failure after a trigger appears.
🎯 Purpose & Design Philosophy
This script was built for traders who do not want to judge a setup only at the moment it triggers.
Many setups look valid at first, but the real weakness appears later: price does not travel far enough, time passes, participation fades, or the trigger side is lost. This tool turns that hidden execution problem into a visible decision layer.
It supports a planning mindset: trigger, observe progress, evaluate time cost, check failure risk, and decide what deserves attention next.
⚡ Why This Script Is Different
Most tools focus on finding the trigger itself.
This script does NOT behave like a generic signal indicator, opening range failure tool, RSI failure swing detector, order-block map, support/resistance scanner, or broad regime dashboard.
Instead, it asks a narrower execution question: after a setup starts, is price travelling enough to keep the idea alive, or is the setup becoming a no-progress failure?
⚙️ Methodology
1. Context Detection
The script selects the evaluation side using Auto, Long Context, or Short Context. Auto mode follows trend and slope context.
2. Trigger Mapping
The planner starts a tracking window from a selected trigger model: Range Break, Impulse Close, or Trend Reclaim.
3. Progress Evaluation
It measures favorable travel, elapsed bars, close efficiency, relative volume, time decay, reclaim behavior, and risk shelf pressure.
4. Visual Output
It displays a stalled-move box, minimum progress rail, risk shelf, trigger line, event labels, alerts, and a compact AGPro panel.
🗺️ How to Read the Chart
Zones = the stalled-move box between the risk shelf and the minimum progress rail.
Labels = compact event markers for Trigger, No Progress, Reclaim, Travel OK, and Failed states.
Colors = teal marks accepted progress, pink/red marks failure or invalidation, amber marks stalled progress, and indigo marks active watch or recovery context.
Panel = summarizes Progress Score, Elapsed Bars, Distance Travelled, Failure Risk, and Action.
🚦 Signals & States
• Trigger → a new post-trigger progress window is active.
• Watch Progress → the setup is active but has not yet proven enough travel.
• Stalled → price has lost the trigger side or is not progressing cleanly.
• No Progress → the evaluation window matured without enough favorable travel.
• Reclaim → price recovered the trigger side after temporary loss.
• Travel OK → the setup reached the accepted progress threshold.
• Failed → the tracked setup crossed its risk shelf.
🔔 Alerts Logic
Alerts trigger when a new progress window starts, when no-progress failure risk appears, when travel is accepted, when a reclaim appears, or when the risk shelf is crossed.
Alerts are attention markers. They are not trade instructions, automated strategy commands, or certainty signals.
🧩 Confluence Logic
The strongest progress context appears when favorable travel, close efficiency, volume participation, time efficiency, and trigger-side control align.
When travel is weak and elapsed bars increase, the failure-risk reading rises. When the trigger side is lost and reclaimed, the script marks recovery context but does not treat it as certainty.
📊 When to Use
• After a breakout-style trigger appears.
• During continuation attempts that should show progress quickly.
• Around trend reclaim setups where follow-through matters.
• When a setup looks active but price remains trapped near the trigger.
• On liquid markets where ATR and relative volume are meaningful.
⚠️ When NOT to Use
• Extremely low-liquidity markets with unreliable candles or volume.
• Very noisy micro-timeframes where trigger-side loss is frequent.
• News-driven volatility spikes where ATR expands suddenly.
• Symbols where volume data is missing or not useful.
• As a standalone reason to enter, exit, or size a trade.
🎛️ Key Inputs
• Evaluation Side → controls Auto, Long Context, or Short Context.
• Trigger Model → selects Range Break, Impulse Close, or Trend Reclaim activation.
• Evaluation Window Bars → defines how long the setup has to show minimum progress.
• Minimum Progress ATR → defines the expected favorable travel threshold.
• Progress Accepted ATR → defines stronger follow-through.
• Risk Shelf Buffer ATR → controls invalidation distance around the initial shelf.
• Visual Settings → control boxes, rails, prior boxes, labels, panel location, theme, and font sizes.
🖥️ Interface & Visual Design
The interface is chart-first.
The stalled-move box is the primary visual object and contains a centered progress meter. Rails show trigger, risk, and progress references without turning the chart into a crowded level map.
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 Progress Score.
2. Check whether price is travelling beyond the minimum progress rail.
3. Review elapsed bars versus the evaluation window.
4. Watch for No Progress, Reclaim, Travel OK, or Failed labels.
5. Interpret the output inside broader market structure and risk context.
🔍 Interpretation Guidelines
A high Progress Score means the setup is moving efficiently relative to this rule set. It does not mean price must continue.
A No Progress label means the setup has not travelled enough after the selected trigger. It does not guarantee failure, but it highlights weakening execution quality.
A Failed state means the mapped risk shelf was crossed. It should be read as rule-based invalidation context, not as financial advice.
🚫 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 an opening range failure tool.
• Not an RSI failure swing detector.
• Not a generic support/resistance or order-block map.
⚠️ Limitations & Transparency
Progress quality depends on the selected trigger model, lookback, ATR length, timeframe, and market conditions.
Different symbols may produce different volume behavior. High volatility can expand the tracking box quickly, while low volatility can make progress thresholds harder to interpret.
The script is rule-based and should be used as an analytical planning layer, not as a complete trading system.
🧠 Market Context Notes
No-progress behavior is often a time and efficiency problem, not just a price-level problem.
A setup can trigger, remain technically alive, and still become unattractive if it fails to move far enough while time passes. This script makes that condition visible.
🧾 Use Case Examples
When price breaks a recent range but remains near the trigger after the evaluation window, the map can mark No Progress and increase failure risk.
When price loses the trigger side and then reclaims it, the script can mark Reclaim so the user can review whether recovery is meaningful.
When price travels beyond the accepted progress threshold with efficient closes, the panel can move toward Travel OK context.
🧱 System Philosophy
No-Progress Failure Map follows the AGPro decision-engine approach: the script should help users evaluate context, quality, risk, progress, and next action without promising an outcome.
The goal is not to add another signal. The goal is to make post-trigger progress easier to judge.
🔐 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 triggered setups behave after activation. The most useful reading comes from comparing progress, elapsed bars, risk shelf behavior, and broader market context.
Indicator

Time Stop Planner [AGPro Series]Time Stop Planner
🧠 Core Idea
Has a setup spent too much time without enough progress?
📌 Overview / What it does
Time Stop Planner is a chart-first trade management overlay designed to evaluate the lifecycle of a triggered setup after price breaks from a prior structure. Instead of showing another generic signal, it asks whether the setup is actually making enough progress before the time window starts working against it.
The script builds a forward lifecycle box, maps a trigger reference, an invalidation rail, and a progress target reference, then scores the active setup from 0 to 100 using elapsed bars, distance traveled, follow-through quality, volatility decay, and invalidation proximity.
It does not predict future price movement, automate trade decisions, or promise that a setup will continue. Its purpose is to turn time, progress, and risk context into a cleaner visual decision framework.
🎯 Purpose & Design Philosophy
This script was built for traders who already have a setup idea but need a cleaner way to judge whether that setup is still alive, losing quality, or becoming stale.
Many tools focus on entries or targets. Time Stop Planner focuses on the often-overlooked middle stage: what happens after a setup activates but before the outcome is clear. It supports a disciplined review process by showing whether progress is keeping pace with elapsed time.
The design philosophy is simple: a setup should not remain interesting forever just because it once looked valid. The chart should make lifecycle quality visible.
⚡ Why This Script Is Different
Most tools focus on trigger signals, stop levels, or target projections.
This script does NOT behave like a generic timer dashboard, a stop-loss optimizer, a full position planner, or a profit-target ladder.
Instead, it connects time directly to progress quality. A setup is evaluated through a visible lifecycle window, a progress score, time-risk pressure, invalidation context, and a clear next-action state.
⚙️ Methodology
1. Context Detection
The script detects a directional setup lifecycle when price breaks beyond a prior structure boundary with sufficient candle body strength, close location quality, and optional trend support.
2. Reference Mapping
After activation, the script maps the trigger reference, invalidation rail, and ATR-based progress target reference. These levels create the lifecycle framework used for progress and risk evaluation.
3. Reaction Evaluation
The engine measures elapsed bars, directional travel, close-based follow-through, volatility behavior, and distance from invalidation. These components are converted into a 0-100 quality score and a separate time-risk reading.
4. Visual Output
The chart displays a lifecycle box, rails, checkpoint labels, state labels, and a compact AGPro panel. The active box text is centered inside the lifecycle area for clean chart reading.
🗺️ How to Read the Chart
Zones = the lifecycle box shows the active time window in which the setup should show reasonable progress.
Rails = the trigger reference, progress target reference, and invalidation rail define the active setup map.
Labels = setup, checkpoint, continue, time-risk, expired, and invalidated labels mark important lifecycle events.
Colors = green/teal suggests constructive progress, amber suggests time-risk or expiry pressure, pink suggests invalidation or failed lifecycle context, and indigo marks neutral active structure.
Panel = the panel summarizes Bars Active, Progress Score, Time Risk, Invalidation, and Action.
🚦 Signals & States
• New Time Stop Lifecycle → a new setup lifecycle window has been detected.
• Continue Review → progress and quality are strong enough to keep the lifecycle under constructive review.
• Time Risk → elapsed time is high relative to progress, so the setup deserves closer review.
• Lifecycle Expired → the active lifecycle reached its time boundary without enough progress.
• Lifecycle Invalidated → price closed beyond the invalidation rail.
🔔 Alerts Logic
The script includes alerts for:
• New Time Stop Lifecycle
• Continue Review State
• Time Risk State
• Lifecycle Expired
• Lifecycle Invalidated
These alerts are attention markers. They are not trade instructions, automated orders, or guaranteed outcome signals.
🧩 Confluence Logic
The strongest lifecycle context appears when structure break quality, candle body strength, close location, trend support, progress travel, and invalidation distance align.
When progress improves while time-risk stays low, the active lifecycle becomes more constructive. When elapsed bars increase while progress remains weak, the setup becomes more vulnerable to time-stop review.
📊 When to Use
• After a clean structure break
• During breakout follow-through review
• During trend continuation management
• When a setup is active but progress is unclear
• When you want a rule-based way to identify stale setups
⚠️ When NOT to Use
• Extremely low-liquidity symbols
• Very noisy markets with repeated false breaks
• News-driven spikes where ATR behavior becomes distorted
• Markets where structure boundaries are not meaningful
• As a standalone entry or exit system
🎛️ Key Inputs
• Sensitivity → controls how strict the setup activation logic is.
• Structure Lookback → defines the prior boundary used for lifecycle activation.
• Lifecycle Window Bars → sets how long a setup can remain active before time-risk becomes dominant.
• Minimum Progress % → defines how much progress is expected before expiry pressure matters.
• Progress Target ATR → sets the ATR-based progress reference.
• Invalidation Buffer ATR → controls the distance of the invalidation rail.
• Label Font Size and Panel Font Size → control visual readability.
• Panel Location and Panel Theme → customize the AGPro summary panel.
🖥️ Interface & Visual Design
The interface is built around a clean chart-first workflow. The lifecycle box is the primary visual object, and its centered text summarizes the active state without requiring extra dashboard interpretation.
The panel is compact and uses the AGPro standard first row: one merged blue header row containing only the panel title. The remaining rows focus on time, progress, risk, invalidation, and the next review state.
Labels are limited by cooldown and max-visible controls so the chart remains informative without becoming crowded.
🧪 Practical Usage Workflow
1. Read the panel to identify the current lifecycle state.
2. Check the lifecycle box and rails to understand the active structure.
3. Compare Bars Active with Progress Score.
4. Watch whether Time Risk rises before meaningful progress appears.
5. Use invalidation context to decide whether the setup is still structurally relevant.
🔍 Interpretation Guidelines
A high score does not mean price must continue. It means the active lifecycle is progressing well under the script's rules.
A high time-risk reading does not mean price must reverse. It means time is becoming less favorable relative to progress.
An expired lifecycle does not judge the broader market. It only says the active setup window did not produce enough progress within the configured time boundary.
🚫 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 full position planner
• Not a profit-target promise tool
⚠️ Limitations & Transparency
The script uses rule-based structure detection and ATR-based references, so results can vary across symbols, sessions, and timeframes.
Confirmed lifecycle states depend on the selected lookback, sensitivity, ATR settings, and volatility conditions.
During sideways chop, repeated structure breaks may produce lifecycles that expire quickly. During extreme volatility, time and progress readings may change rapidly.
🧠 Market Context Notes
Time is part of risk. A setup that does not progress can become less useful even if it has not technically invalidated.
This script is designed to make that time component visible without turning it into a direct trade command.
🧾 Use Case Examples
When price breaks above a prior structure and the lifecycle box appears, the trader can watch whether progress develops before the time window matures.
When progress remains weak and the Time Risk state appears, the trader can reassess whether the original setup idea still deserves attention.
When price closes beyond the invalidation rail, the lifecycle is marked invalidated and the context resets.
🧱 System Philosophy
Time Stop Planner belongs to the AGPro decision-engine style: it does not simply show data. It organizes setup validity, progress quality, risk context, and next-action state into one readable workflow.
🔐 Non-Promise Statement
This script does not provide certainty.
It does not guarantee continuation, reversal, profit, or protection from loss.
📉 Risk Disclosure
Trading involves risk.
All outputs from this script are educational and analytical only.
Users remain responsible for their own decisions, risk management, and market interpretation.
This script does not provide financial advice.
📚 Educational Note
Use the script as a structured way to study time, progress, and invalidation behavior after a setup activates. The value is in consistent interpretation, not in treating any state as a command.
Indicator

Trade Location Quality [AGPro Series]Trade Location Quality
🧠 Core Idea
Is price in a clean trade location, or is it too close to obstruction, invalidation, or noisy range edges?
📌 Overview / What it does
Trade Location Quality is a chart-overlay risk-location planner designed to evaluate whether the current price area is practical for setup review.
The script measures range position, nearby obstruction rails, ATR-normalized risk distance, target room, trend support, and volatility fit. These inputs are combined into a 0-100 Location Quality Score with a clear state such as Clean Location, Watch Location, Obstructed, Danger Close, Risk Wide, or Poor Location.
It produces a forward location window, target/risk rails, compact event labels, alert conditions, and a premium AGPro panel. It does not predict price direction, automate execution, or print direct buy/sell commands.
🎯 Purpose & Design Philosophy
This script was built to solve a common planning problem: a setup may look interesting, but the trade location may still be weak because price is too stretched, too close to the next obstacle, or too close to invalidation.
The goal is to help traders think in terms of location quality before reacting to a setup. It supports a planning mindset: check context, evaluate room, review risk, then decide whether the area deserves attention.
It is designed for traders who want a clean decision layer rather than another generic signal marker.
⚡ Why This Script Is Different
Most tools focus on detecting a level, zone, breakout, or signal.
This script does NOT build a premium/discount map, OTE model, generic support/resistance scanner, order-block map, or prediction engine.
Instead, it asks a narrower planning question: is the current location clean enough to evaluate, or is the chart already blocked by risk, obstruction, or poor range position?
⚙️ Methodology
1. Context Detection
The script identifies the active evaluation side using either Auto Context, Long Context, or Short Context. Auto Context follows the trend-support basis.
2. Reference Mapping
It maps the recent range, nearest obstruction rails, opposite-side risk rail, estimated invalidation reference, and ATR-normalized room.
3. Reaction Evaluation
It scores location quality using range position, target room, risk distance, trend support, and volatility fit.
4. Visual Output
It displays a forward location window, target/risk rails, state labels, alerts, and a compact AGPro panel.
🗺️ How to Read the Chart
Location Window = the current area where price location is being evaluated.
Target Obstruction Rail = the nearest meaningful obstacle in the evaluation direction.
Risk Rail = the opposite-side reference used to estimate invalidation distance.
Labels = compact state markers showing the current planner condition and score.
Colors = teal and indigo suggest stronger quality, amber suggests caution, and pink/red suggests weak or risky location.
Panel = summarizes score, state, range position, obstruction distance, risk state, and next action.
🚦 Signals & States
• Clean Location → location score is strong, room is sufficient, and risk distance is balanced.
• Watch Location → context is acceptable but not strong enough for the clean-location state.
• Obstructed → price is too close to the next target-side obstruction rail.
• Danger Close → invalidation is too close for a balanced location read.
• Risk Wide → invalidation is too far away, making the location less efficient.
• Poor Location → score and context are not strong enough for planning attention.
🔔 Alerts Logic
• Clean Location → triggers when the script enters the Clean Location state.
• Obstructed Location → triggers when price becomes too close to the next obstruction rail.
• Risk Location Warning → triggers when risk distance becomes too tight or too wide.
• Watch Location → triggers when a watchable location context appears without reaching Clean Location.
Alerts are attention markers. They are not trade instructions.
🧩 Confluence Logic
Location quality improves when range position, target room, balanced risk distance, trend support, and stable volatility align.
The strongest read appears when the score is high and the panel also shows enough obstruction distance with a balanced risk state.
📊 When to Use
• During setup planning before reacting to a signal.
• Around pullbacks where risk and target room matter.
• During trend continuation review when price may be clean or already stretched.
• Before breakout or reversal evaluation when nearby obstruction can change the quality of the idea.
• On liquid markets where ATR and pivot references are meaningful.
⚠️ When NOT to Use
• Extremely low-liquidity markets with unreliable candles.
• Highly noisy periods where rails change too frequently.
• Extreme volatility spikes where ATR-based distance can expand rapidly.
• Charts where the user has no broader context for directional evaluation.
• As a standalone reason to enter or exit a trade.
🎛️ Key Inputs
• Evaluation Context → selects Auto, Long, or Short planning context.
• Location Lookback → defines the recent structure window.
• Obstruction Pivot Length → controls how strict obstruction rails are.
• Minimum Clean Score → sets the quality threshold for Clean Location.
• Minimum Target Room ATR → controls how much room must exist before the next obstruction.
• Risk Buffer Inputs → define what counts as too close or too wide.
• Visual Settings → control compact or detailed labels, rails, location window, panel visibility, theme, location, and font sizes.
🖥️ Interface & Visual Design
The interface is intentionally chart-first.
The location window shows the active evaluation area without filling the chart with many competing zones. The obstruction rails provide practical reference points. The default labels use compact state tags, while hover tooltips retain the deeper score, room, risk, and action context. Cooldown and maximum-visible settings keep the chart active but not crowded.
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 score and state.
2. Check whether target-side room is open or obstructed.
3. Review whether risk distance is balanced, too close, or too wide.
4. Compare the location window with broader market context.
5. Treat alerts and labels as attention markers, not decisions.
🔍 Interpretation Guidelines
A high score means the location is cleaner relative to the script's rule set. It does not mean price must move in the evaluated direction.
An obstructed state means room is limited before the next nearby reference. It does not mean price cannot break through that area.
A risk warning means the current location is less balanced for planning. It should be interpreted with timeframe, volatility, and broader structure.
🚫 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 premium/discount or OTE zone engine.
• Not a generic support/resistance zone scanner.
⚠️ Limitations & Transparency
Location quality depends on the selected lookback, pivot length, volatility profile, and timeframe.
Different markets can produce different rail behavior. High volatility may widen risk distance. Low volatility may compress target room. Small timeframes may produce more frequent state changes.
The script is rule-based and should be read as a planning tool inside broader analysis.
🧠 Market Context Notes
Trade location is not only about where price is. It is also about what sits nearby.
A location can look attractive but still be weak if there is not enough clean room before the next obstruction. A location can also be risky if invalidation is too close or too far for the current volatility environment.
This script organizes those conditions into a single readable decision layer.
🧾 Use Case Examples
When price pulls back inside a trend and the score improves while risk remains balanced, the chart may deserve closer review.
When price is near a target-side rail and the panel shows Obstructed, the user can recognize that nearby room is limited.
When volatility expands and risk distance becomes too wide, the script can mark the location as less efficient for planning.
🧱 System Philosophy
Trade Location Quality follows the AGPro decision-engine approach: the script should help the user evaluate context, quality, risk, room, and next action without promising an outcome.
The goal is not to add another signal. The goal is to improve the quality of the planning process.
🔐 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 trade location changes as price moves closer to risk, target, obstruction, and range edges. The most useful reading comes from comparing the panel state with the visible chart context.
Indicator

Risk Runway Planner [AGPro Series]Risk Runway Planner
🧠 Core Idea
Is the current setup offering a clean risk runway, or is risk too wide, too blocked, or still too early?
📌 Overview / What it does
Risk Runway Planner is a chart-first risk planning and execution readiness tool designed to evaluate whether a setup has enough structure to deserve active attention.
Instead of printing generic buy or sell signals, the script studies stop-distance quality, invalidation clarity, expansion room, volatility state, trend support, and price location. It then converts those factors into a 0-100 quality score and a clear next-action state.
The script produces an active risk runway box, invalidation and target-edge guides, compact chart labels, alerts, and a clean AGPro planning panel. It does not predict future price movement, automate decisions, or guarantee that a setup will follow through.
🎯 Purpose & Design Philosophy
This script was built for traders who want to evaluate setup quality before execution, not after the chart has already moved.
Many tools show signals, volatility compression, or target levels in isolation. Risk Runway Planner is designed to connect the practical planning questions: Where is invalidation? Is stop distance reasonable? Is there enough room before obstruction? Is volatility supportive or unstable? What should the trader pay attention to now?
The design mindset is simple: a cleaner decision framework is more useful than another crowded signal layer.
⚡ Why This Script Is Different
Most tools focus on entries, squeeze conditions, support/resistance zones, or target projections as separate ideas.
This script does NOT try to become a generic compression map, a take-profit ladder, a position-sizing calculator, or a signal generator.
Instead, it evaluates the quality of the risk runway between invalidation and the next target edge. The core output is not a trade command. It is a planning state that helps the user decide whether a setup is READY, still on WATCH, BLOCKED by poor room, or exposed to WIDE RISK.
⚙️ Methodology
1. Context Detection
The script detects the active planning side using trend structure and price location, or allows the user to force long-context or short-context evaluation.
2. Reference Mapping
It maps the current planning range, recent invalidation shelf, nearby obstacle, ATR-normalized stop distance, and projected expansion room.
3. Reaction Evaluation
The model scores stop quality, expansion room, trend support, volatility state, and range location. These components are blended into a 0-100 quality score.
4. Visual Output
The output is shown through a risk runway box, invalidation guide, target-edge guide, compact labels, deterministic alerts, and a premium planning panel.
🗺️ How to Read the Chart
Zones = the active risk runway between invalidation and target edge.
Labels = compact state markers showing READY, WATCH, DOWNGRADE, INVALIDATED, or TARGET EDGE context.
Colors = bullish and bearish context use AGPro state colors, while neutral and warning conditions use controlled accent tones.
Panel = the panel summarizes Risk Compression, Expansion Room, Volatility State, Quality Score, Risk Edge, and Action.
🚦 Signals & States
• READY → the current risk runway has enough quality to justify active attention.
• WATCH → the setup is improving but does not yet meet the stricter readiness threshold.
• WIDE RISK → stop distance or invalidation quality is too weak for clean planning context.
• BLOCKED → expansion room is limited or the nearest obstacle is too close.
• WAIT → the planner does not detect a strong enough structure yet.
• INVALIDATED → a prior active invalidation shelf has been crossed.
• TARGET EDGE → a prior target edge has been reached.
🔔 Alerts Logic
Alerts trigger when the planner enters READY state, enters WATCH state, downgrades from READY, crosses a prior invalidation shelf, or reaches a prior target edge.
These alerts are attention markers. They are not trade instructions, entry signals, or automated strategy commands.
🧩 Confluence Logic
The strongest planning state appears when multiple components align:
Stop-distance quality + expansion room + trend support + controlled volatility + favorable price location.
When these factors align, the script can move from WATCH to READY. If risk widens or room becomes blocked, the state can downgrade.
📊 When to Use
• Before evaluating a discretionary setup
• During trend pauses where invalidation is becoming clearer
• Before breakout or continuation attempts when risk needs structure
• Around pullbacks where stop distance and target room need review
• When comparing whether one setup has cleaner risk than another
⚠️ When NOT to Use
• Extremely low-liquidity symbols
• Very noisy micro-timeframes with unstable wicks
• News-driven volatility spikes
• Markets where recent structure is too distorted to define a useful invalidation shelf
• Situations where the user expects a signal-only entry tool
🎛️ Key Inputs
• Planning Side → controls Auto, Long Context, or Short Context evaluation.
• ATR Length → normalizes stop distance, room, labels, and volatility state.
• Planning Range → defines the broader structure used for price location and range context.
• Invalidation Lookback → controls how the invalidation shelf is mapped.
• Obstacle Lookback → controls how nearby target-edge obstruction is estimated.
• READY / WATCH Thresholds → adjust how selective the planner is.
• Visual settings → control runway boxes, guide lines, memory boxes, labels, panel location, theme, and font sizes.
🖥️ Interface & Visual Design
The interface is built around a clean planning panel and one primary chart object: the risk runway box.
The panel uses a single merged AGPro header row and keeps the key planning information readable without turning the chart into a dashboard-heavy layout.
Labels are intentionally compact, offset away from candles, and controlled with cooldown and maximum-visible settings.
🧪 Practical Usage Workflow
1. Read the panel action state.
2. Check whether the risk runway box has enough room between invalidation and target edge.
3. Review whether the Risk Edge is reasonable in ATR terms.
4. Confirm whether the chart context supports the selected planning side.
5. Treat alerts as attention markers and review the broader market context before making any decision.
🔍 Interpretation Guidelines
A higher score means the planner sees better alignment between risk, room, volatility, trend support, and location.
READY does not mean a trade must be taken. It means the setup has enough planning quality to deserve attention.
WATCH means the structure may be developing, but at least one component still needs improvement.
WIDE RISK and BLOCKED are caution states. They help identify when the chart may be less efficient for planning.
🚫 What This Script Is NOT
This script is not a prediction engine.
It is not financial advice.
It is not an auto-trading system.
It does not provide guaranteed signals.
It does not replace user judgment, risk management, or broader market analysis.
⚠️ Limitations & Transparency
Timeframe differences can change how invalidation shelves and obstacles are detected.
Volatility changes can alter ATR-normalized risk and room conditions.
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 planning layer, not as certainty.
🧠 Market Context Notes
Risk quality is not only about stop distance. It also depends on whether price has enough clean room to move, whether volatility is controlled, and whether structure supports the active side.
The planner is most useful when it helps the user avoid low-quality setups before they become emotional decisions.
🧾 Use Case Examples
When price is near a constructive invalidation shelf and still has clean room toward the next target edge, the planner may move toward WATCH or READY.
When price is too close to the nearest obstacle, the planner may show BLOCKED even if trend direction looks attractive.
When stop distance becomes too wide relative to ATR, the planner can show WIDE RISK even if the setup still looks visually interesting.
🧱 System Philosophy
Risk Runway Planner follows the AGPro Series decision-engine approach:
Context first.
Risk before reward.
Structure before signal.
Attention markers instead of promises.
🔐 Non-Promise Statement
No indicator can remove uncertainty.
No state, score, label, alert, or visual box should be interpreted as guaranteed market direction.
📉 Risk Disclosure
Trading involves risk.
All decisions remain the responsibility of the user.
This script is for educational and analytical chart review only and does not provide financial advice.
📚 Educational Note
The script is designed to help users think more clearly about setup quality, invalidation, volatility, and available room before reacting to price movement.
Indicator

Entry Execution Readiness [AGPro Series]Entry Execution Readiness
🧠 Core Idea
Is this setup ready for execution attention now, or should it remain on watch?
📌 Overview / What it does
Entry Execution Readiness is a chart-first decision engine built to evaluate whether an active setup has enough structure, risk quality, and target room to deserve execution attention.
The script produces a 0-100 Readiness Score, a clear entry state, an entry pocket, an invalidation rail, a target-room band, premium state labels, and a compact AGPro panel. It is designed to organize setup quality, not to predict price or automate execution.
It does not publish buy or sell commands. It does not replace a trader's own execution model. Its purpose is to turn observable setup conditions into a cleaner readiness map.
🎯 Purpose & Design Philosophy
This script was built for traders who already see a potential setup but need a disciplined way to decide whether the setup is clean enough to keep under execution review.
The gap it fills is practical: many tools identify signals, levels, or zones, but they do not answer whether the setup has acceptable risk distance, enough target room, suitable volatility, and directional confirmation at the same time.
The design philosophy is simple: execution should be reviewed through readiness, not excitement.
⚡ Why This Script Is Different
Most tools focus on printing a signal or highlighting a level.
This script does NOT act as a full Position Planner, position sizing model, signal service, or trade automation system.
Instead, it evaluates execution readiness through a compact decision layer: trend alignment, candle efficiency, distance to invalidation, target-room quality, and volatility fit are compressed into one transparent score and one clear next-action state.
⚙️ Methodology
1. Context Detection
The script detects the active setup side automatically, or lets the user force a long-bias or short-bias readiness view.
2. Reference Mapping
It maps an entry pocket around the active trend reference, builds an invalidation rail from recent structure, and projects target room from nearby structure or ATR-adjusted continuation space.
3. Reaction Evaluation
It scores trend alignment, candle efficiency, risk distance, reward room, and volatility fit from 0 to 100.
4. Visual Output
The chart displays the readiness state through zones, labels, alerts, and a premium AGPro panel with the key decision fields.
🗺️ How to Read the Chart
Zones = the active entry pocket and target-room band.
Invalidation rail = the structural level that would weaken or reset the current setup context.
Labels = the current readiness state, score tier, and risk context.
Colors = teal for stronger long-readiness contexts, pink for bearish or invalidation contexts, amber for waiting states, and indigo for monitoring/transition states.
Panel = the fastest summary of score, state, risk distance, target room, and next action.
🚦 Signals & States
• READY → the setup meets the score threshold and confirmation filter.
• MONITOR → the setup is improving but still needs cleaner confirmation or score strength.
• WAIT → the setup exists, but risk, target room, or confirmation is not yet strong enough.
• BLOCKED → the current context does not offer a clean execution-readiness profile.
• INVALIDATED → price closed beyond the active invalidation rail.
🔔 Alerts Logic
READY alerts trigger when the state upgrades into READY.
Downgrade alerts trigger when the active setup weakens from a stronger state.
Invalidation alerts trigger when price closes beyond the current invalidation rail.
Confirmation alerts trigger when score and confirmation improve together near the READY threshold.
Alerts are attention markers. They are not trade instructions.
🧩 Confluence Logic
The setup becomes stronger when directional trend alignment, candle quality, controlled invalidation distance, acceptable volatility, and clean target room improve at the same time.
The score is intentionally multi-factor so a single strong candle or a single clean level cannot dominate the full readiness view.
📊 When to Use
• Trend continuation setups
• Pullback-to-reference execution reviews
• Breakout continuation contexts with enough target room
• Active trade-planning workflows where the trader already has a directional thesis
• Intraday or swing charts where risk and target room need to be evaluated quickly
• 4-hour swing/execution review charts where the active pocket, invalidation rail, and target room can be read without excessive label compression
⚠️ When NOT to Use
• Very low liquidity markets
• Extremely noisy sideways conditions
• News-driven volatility spikes
• Charts where the user has no independent setup thesis
• Markets with poor execution conditions, wide spreads, or unreliable fills
🎛️ Key Inputs
• Setup Direction → Auto, Long Bias, or Short Bias readiness mode.
• Sensitivity → controls how selective the model is.
• Structure Lookback → affects structure, risk rail, target room, and volatility context.
• Minimum READY Score → defines the threshold required for READY state.
• Confirmation Mode → controls how much candle and trend confirmation is required.
• Label Cooldown / Max Visible Labels → controls label density.
• Panel Location / Panel Theme / Font Sizes → controls visual presentation.
🖥️ Interface & Visual Design
The interface is built around a clean premium overlay.
The panel uses the AGPro standard single merged blue header row and summarizes only the most decision-relevant fields.
The chart visuals are deliberately limited to the current entry pocket, invalidation rail, target room, and moderate state labels so the script remains readable in publication screenshots.
🧪 Practical Usage Workflow
1. Read the panel state and Readiness Score.
2. Check whether price is interacting cleanly with the entry pocket.
3. Review the invalidation rail and risk distance.
4. Compare the target-room band against the current risk.
5. Treat READY as a review state, not as an automatic execution command.
🔍 Interpretation Guidelines
Think of the output as a readiness filter.
A high score means the modeled conditions are aligned more cleanly than usual. It does not mean the setup will work.
A WAIT or MONITOR state can still be useful because it shows what part of the setup is not yet ready.
An INVALIDATED state means the current setup context should be reset or reviewed again from a fresh structure.
🚫 What This Script Is NOT
• Not a prediction engine
• Not financial advice
• Not auto trading
• Not guaranteed signals
• Not a full position-sizing planner
• Not a buy/sell command system
⚠️ Limitations & Transparency
Timeframe differences can change how structure, volatility, and target room appear.
Volatility expansion or contraction can make the readiness state change quickly.
Market conditions can shift faster than any rule-based chart tool can summarize.
The model is transparent and deterministic, but it cannot know future price behavior.
🧠 Market Context Notes
Entry readiness is most useful when it is read together with liquidity, structure, session context, and broader volatility conditions.
The script is strongest when the trader already has a setup thesis and needs a cleaner way to review whether execution conditions are improving or weakening.
🧾 Use Case Examples
When price pulls back toward the entry pocket, trend alignment remains intact, risk distance stays controlled, and target room remains clean, the setup may upgrade into MONITOR or READY.
When price stretches too far from the pocket or target room becomes too thin relative to invalidation distance, the score can weaken even if direction still looks attractive.
When price closes beyond the invalidation rail, the active setup context is marked as INVALIDATED.
🧱 System Philosophy
AGPro tools are designed to support structured chart reading, decision clarity, and rule-based interpretation.
This script follows that philosophy by focusing on execution readiness instead of generic signals.
🔐 Non-Promise Statement
No script can provide certainty.
No score can guarantee a future outcome.
This tool organizes visible chart conditions so the user can make a more structured review.
📉 Risk Disclosure
Trading involves risk. Market movement can be unpredictable, and any setup can fail.
Users are responsible for their own analysis, execution, risk management, and decisions.
This script does not provide financial advice, investment advice, or guaranteed trading outcomes.
📚 Educational Note
Use the script as a structured decision-support layer. The strongest benefit comes from reviewing why the state is READY, WAIT, MONITOR, BLOCKED, or INVALIDATED rather than treating any single label as a standalone answer.
Indicator

Parabolic SAR Flip Quality [AGPro Series]Parabolic SAR Flip Quality
🧠 Core Idea
Is this Parabolic SAR flip strong enough to plan around, or is it just another noisy stop-and-reverse signal?
📌 Overview / What it does
Parabolic SAR Flip Quality is a planner-style Parabolic SAR overlay built to evaluate PSAR flip conditions as trade-decision context, not as simple directional signals.
The script keeps the classic Parabolic SAR dot trail visible, then adds a professional quality model that measures flip strength, trend alignment, SAR distance, candle efficiency, volatility expansion, and prior-leg maturity. The result is a clear 0-100 readiness score that helps traders judge whether the current PSAR flip environment is valid, weak, developing, or blocked.
It produces qualified flip labels, SAR dots, a SAR-native protection band, and a compact AGPro panel showing Flip Side, SAR Distance, Trend Filter, and Quality Score. It does not automate trades, predict future price, or tell users what to buy or sell. It organizes PSAR flip context into a cleaner decision framework.
🎯 Purpose & Design Philosophy
Most Parabolic SAR tools show where the SAR dots are and where the stop-and-reverse event happened. That is useful, but it often leaves the trader with the harder question: is this flip actually good enough to act on, monitor, or ignore?
This script was built to fill that gap. It turns a classic indicator into a structured decision engine by asking whether the flip has enough distance, trend support, expansion, and maturity behind it.
The design supports traders who want cleaner execution readiness, not more noise. It is built for chart readers who want to evaluate setup quality, risk area, invalidation context, and next-action state before making their own decision.
⚡ Why This Script Is Different
Most tools focus on printing every Parabolic SAR flip as if all flips have similar meaning.
This script does NOT treat a dot-side change as a complete setup. It also does not turn PSAR into a generic signal board or a generic support/resistance zone map.
Instead, it evaluates the flip as a planning event. The script scores the quality of the transition, checks whether trend conditions support the new side, measures how far price is from the SAR reference, and projects a SAR Protection Band that represents the stop-defense area created by the qualified flip.
The difference is the decision layer:
• Is the flip valid?
• How strong is it?
• Where is the SAR-based invalidation area?
• Is the trend filter helping or blocking the setup?
• What is the current read now?
⚙️ Methodology
1. Context Detection
The script detects whether price is currently operating on the bullish or bearish side of the Parabolic SAR. It also tracks raw SAR flips and measures how mature the prior SAR leg was before the transition.
2. Reference Mapping
The active SAR value becomes the primary reference point. Distance from SAR is normalized by ATR so the read adapts across symbols and timeframes.
3. Reaction Evaluation
Each flip is evaluated through a multi-factor quality model:
• SAR distance versus ATR
• EMA trend alignment
• EMA slope direction
• DMI directional agreement
• ADX trend strength
• Candle body efficiency
• Range expansion
• Prior-leg maturity
These conditions are combined into a 0-100 Quality Score.
4. Visual Output
When a flip passes the quality threshold, trend filter, SAR distance requirement, confirmation setting, and cooldown control, the script promotes it into a qualified chart label. It can also draw a SAR Protection Band around the flip's SAR reference for forward context.
🗺️ How to Read the Chart
SAR dots show the classic Parabolic SAR trail. Bullish dots appear below price, and bearish dots appear above price.
Qualified flip labels mark PSAR flips that passed the quality and trend conditions. The label includes the flip side and the quality score, allowing quick comparison between stronger and weaker transitions.
The SAR Protection Band represents the PSAR-based stop-defense area created after a qualified flip. It is not a generic support/resistance zone. It is a SAR-native invalidation and planning reference.
Colors follow the AGPro visual language:
• Teal = bullish side or bullish qualified flip
• Pink = bearish side or bearish qualified flip
• Gold = neutral, blocked, or caution state
• Indigo = trend backbone reference
The panel summarizes the active read:
• Flip Side
• SAR Distance
• Trend Filter
• Quality Score
🚦 Signals & States
• Bullish Flip → A qualified PSAR transition to the bullish side.
• Bearish Flip → A qualified PSAR transition to the bearish side.
• Trend Filter PASS → The broader trend filter agrees with the current SAR side.
• Trend Filter BLOCKED → The SAR side is active, but the broader trend filter does not fully support it.
• High Quality Score → The flip has stronger alignment across distance, trend, expansion, efficiency, and maturity.
• WAIT Grade → The current condition does not meet the preferred readiness profile.
These are analytical states, not trade instructions.
🔔 Alerts Logic
Alerts trigger only when a qualified bullish or bearish PSAR flip is confirmed by the script's quality rules.
• Qualified Bullish PSAR Flip → A bullish SAR flip passed the trend filter, quality threshold, SAR distance threshold, cooldown rule, and confirmation setting.
• Qualified Bearish PSAR Flip → A bearish SAR flip passed the trend filter, quality threshold, SAR distance threshold, cooldown rule, and confirmation setting.
Alerts are attention markers. They are not automated trading instructions and do not guarantee future movement.
🧩 Confluence Logic
The strongest context appears when several conditions align at the same time:
• PSAR flips to a new side
• Price has enough ATR-normalized distance from SAR
• EMA trend direction supports the flip
• DMI confirms directional pressure
• ADX shows enough trend strength
• Candle structure shows real expansion
• The previous SAR leg was mature enough
When these elements align, the flip becomes more useful as a planning reference.
📊 When to Use
This script is best suited for:
• Trending markets where SAR transitions can develop into continuation phases
• Swing-trading review on higher timeframes
• Crypto, forex, stocks, indices, and commodities with enough liquidity
• PSAR users who want a readiness score instead of raw dot flips
• Traders who want a cleaner invalidation reference around qualified SAR flips
• Multi-timeframe analysis where the user wants to compare flip quality across chart periods
⚠️ When NOT to Use
This script is less useful in:
• Very low-liquidity markets
• Extremely noisy sideways chop
• News-driven spikes where ATR and structure can distort quickly
• Ultra-low timeframes with unstable spread or poor execution quality
• Markets where price repeatedly flips around the SAR without trend expansion
In these conditions, raw PSAR flips and quality labels can become less reliable as planning references.
🎛️ Key Inputs
• SAR Start → Controls the initial Parabolic SAR acceleration factor.
• SAR Increment → Controls how quickly the SAR acceleration increases as the trend develops.
• SAR Maximum → Controls the maximum SAR acceleration level.
• Trend EMA Length → Defines the trend backbone used by the filter.
• DMI Length and ADX Smoothing → Control directional pressure and trend-strength measurement.
• Minimum ADX → Sets the required trend-strength floor.
• Minimum Quality Score → Defines how selective qualified flip labels should be.
• Minimum SAR Distance ATR → Blocks cramped flips that occur too close to the SAR reference.
• Prior Leg Maturity Bars → Requires the prior SAR leg to have enough development before a flip receives full maturity credit.
• Flip Cooldown Bars → Controls label density and keeps the chart readable.
• SAR Protection Band settings → Control the width, forward projection, and maximum active bands.
• Panel and Label Font Size → Adjust visual readability, with Normal as the default.
• Panel Location and Theme → Control the AGPro panel placement and appearance.
🖥️ Interface & Visual Design
The interface is designed to be premium, compact, and decision-focused.
The chart keeps the classic PSAR dots as the main visual anchor. Qualified labels appear only when the flip passes the selected filters. The SAR Protection Band is transparent and restrained so it adds planning context without overwhelming candles.
The AGPro panel uses a single merged blue header row with the script name, followed by a clean four-row readout. Its purpose is to summarize the current decision state without turning the chart into a dashboard-heavy layout.
🧪 Practical Usage Workflow
1. Read the panel.
Check the active Flip Side, SAR Distance, Trend Filter, and Quality Score.
2. Check the latest qualified label.
Compare the quality score with the minimum threshold and with prior labels on the chart.
3. Review the SAR Protection Band.
Use the band as a SAR-native planning reference for where the qualified flip should remain structurally defended.
4. Confirm broader context.
Compare the flip with trend direction, volatility, market structure, and timeframe behavior.
5. Decide independently.
Use the output as structured context, not as an automatic trade command.
🔍 Interpretation Guidelines
A strong read usually has a qualified flip label, a passing trend filter, enough SAR distance, and a higher quality grade.
A weaker read may show an active SAR side but a blocked trend filter or a low score. This means the SAR state exists, but the planning context is not strong enough under the script's model.
The SAR Protection Band should be interpreted as a stop-defense and invalidation reference. If price respects it, the flip context remains cleaner. If price violates it, the qualified flip has lost part of its structural value.
The best use of the script is comparison: compare current flip quality against previous flips, across timeframes, and across market conditions.
🚫 What This Script Is NOT
This script is not a prediction engine.
It is not financial advice.
It is not an auto-trading system.
It does not guarantee profitable signals.
It does not replace independent analysis, position sizing, risk management, or broader market context.
⚠️ Limitations & Transparency
Parabolic SAR is a trend-following concept, so it can struggle in choppy or directionless markets.
Quality scoring improves structure, but it cannot remove all false transitions. Timeframe selection, volatility regime, liquidity, and market session can affect how signals appear and how useful the SAR Protection Band becomes.
The script is rule-based and transparent. It reads current and historical chart data according to the selected inputs. It does not know future price behavior.
🧠 Market Context Notes
PSAR flips tend to become more meaningful when they occur with volatility expansion, directional pressure, and enough distance from the SAR reference.
In compressed markets, the dots may switch sides more frequently and the score may change quickly. In stronger trends, the SAR dots often create cleaner trailing structure, and qualified flips can become more useful as planning events.
The best interpretation comes from combining the panel state, SAR distance, label quality, protection band behavior, and the broader market environment.
🧾 Use Case Examples
When price flips bullish, the trend filter passes, SAR distance expands above the minimum threshold, and the quality score is high, the user can treat that area as a cleaner bullish planning context.
When price flips bearish but the trend filter is blocked, the script communicates caution. The SAR side changed, but the broader read is not aligned.
When price returns to the SAR Protection Band after a qualified flip, the user can monitor whether the band is respected or violated as part of the invalidation read.
🧱 System Philosophy
The purpose of this script is not to add another signal to the chart.
The purpose is to turn a classic indicator into a decision-support framework:
• Setup validity
• Quality strength
• Trend agreement
• Risk reference
• Invalidation context
• Current action state
This is the AGPro direction: tools that help traders make better decisions, not tools that simply decorate the chart with more signals.
🔐 Non-Promise Statement
No indicator can provide certainty.
This script does not promise future outcomes, guaranteed performance, or risk-free execution.
Its role is to organize Parabolic SAR flip context into a clearer analytical structure.
📉 Risk Disclosure
Trading involves risk, and market conditions can change quickly.
This script is provided for educational and analytical purposes only. It does not provide financial advice, investment advice, or guaranteed trading outcomes.
Users are responsible for their own analysis, decisions, risk management, and trading results.
📚 Educational Note
Parabolic SAR is one of the most recognized stop-and-reverse indicators because it makes trend state visually simple. This script keeps that visual simplicity while adding a quality and planning layer so users can study which flips deserve more attention and which ones should remain secondary context. Indicator

Choppiness Setup Planner [AGPro Series]Choppiness Setup Planner
🧠 Core Idea
Is this choppy market still a no-trade environment, or has it matured into a valid setup with defined risk, invalidation, and targets?
📌 Overview / What it does
Choppiness Setup Planner is a planner-style overlay built for one of the most common decision problems in technical analysis: what should a trader do when price is trapped inside a choppy range, but pressure starts building near the edge?
The script detects no-trade chop conditions, builds a decision range around the active structure, scores setup quality from 0 to 100, and turns a mature range release into a clear planning map with invalidation and target levels. Instead of only saying "the market is choppy," it answers whether the setup is still avoidable, preparing, weak, valid, active, or invalidated.
The cleanest visual use case is higher-timeframe planning. Weekly and daily charts allow the full range-to-plan lifecycle to breathe: no-trade structure, preparation, release, target, and invalidation can all be read without the chart feeling crowded.
It does not automate execution, predict future price, or replace personal trade selection. It is an analytical planner designed to organize context, risk, and next-action state directly on the chart.
🎯 Purpose & Design Philosophy
This script was built because many market-state tools show information without helping the user make a decision. A Choppiness Index value, ADX filter, or range box can be useful, but those outputs often stop before the practical question: what now?
Choppiness Setup Planner fills that gap by connecting chop detection with a structured planning workflow. It is intended for discretionary traders, breakout traders, and range-to-expansion traders who want to avoid low-quality noise while preparing for stronger releases from mature ranges.
The design philosophy is simple: first protect attention, then qualify the setup, then map risk only when the structure deserves it.
⚡ Why This Script Is Different
Most tools focus on detecting chop, drawing a box, or marking a breakout.
This script does NOT act like a generic signal indicator, generic support/resistance tool, or simple Choppiness Index panel.
Instead, it turns a choppy market into a decision sequence:
1. Detect the no-trade environment.
2. Track range age and pressure.
3. Grade setup validity with a 0-100 score.
4. Define the next action state.
5. Map invalidation and targets only after a valid release.
That makes the script closer to a decision engine than a visual marker. It is also intentionally separated from manual position planners: users do not enter their own position parameters. The script derives its planning levels from the detected chop range and the release quality model.
⚙️ Methodology
1. Context Detection
The engine blends Choppiness Index, directional weakness, path efficiency, range tightness, wick noise, and volatility behavior to determine whether the market is inefficient enough to qualify as a no-trade chop environment.
2. Reference Mapping
When chop persists long enough, the script builds a decision range around the active structure. This range is not a generic support/resistance zone; it is a planning container for the current no-trade condition.
3. Reaction Evaluation
The script evaluates whether pressure is improving through range age, chop release, ADX lift, path-efficiency improvement, ATR lift, edge pressure, candle body quality, close quality, and optional volume participation.
4. Visual Output
The chart displays the no-trade ribbon, decision range box, centered zone label, preparation markers, valid plan markers, weak-release markers, invalidation level, target levels, and a compact AGPro planner panel.
🗺️ How to Read the Chart
Zones represent the active no-trade decision range. A centered label inside the box shows whether the structure is still a no-trade zone or has moved into preparation mode.
Labels represent state changes. PREP marks a mature range with improving setup quality. PLAN UP and PLAN DN mark valid releases. SKIP marks a release that happened but failed the minimum plan-quality threshold. T1, T2, and INVALID track the active plan lifecycle.
Colors follow the AGPro state palette. Teal is used for stronger upside planning states, pink for downside or invalidation states, amber for caution and no-trade states, and indigo for preparation/readiness.
The panel shows Setup Quality, Next Action, Chop / Ready, Range Age, Invalidation, and Targets.
🚦 Signals & States
• Avoid: Chop → the market is inefficient and still belongs in no-trade mode.
• Prepare: Edge Watch → the range has matured and internal readiness is improving.
• Skip: Low Quality → price released from the range, but the quality score was not strong enough.
• Track Upside Plan → upside release met the minimum valid plan score.
• Track Downside Plan → downside release met the minimum valid plan score.
• Manage: T1 Reached → the active plan reached its first target level.
• Review: T2 Reached → the active plan reached its second target level.
• Reset: Invalidated → the active plan crossed its invalidation level.
🔔 Alerts Logic
Alerts are available for preparation state, valid upside plan, valid downside plan, weak release, Target 1 reached, Target 2 reached, and invalidation.
Each alert is an attention marker. Alerts are not trade instructions, not automation rules, and not execution commands.
🧩 Confluence Logic
The setup becomes stronger when a mature chop range aligns with improving readiness, edge pressure, candle body participation, release distance, and optional volume participation.
When these components align, the script can convert the release into a valid plan. When price releases without enough score, the script marks the event as SKIP instead of treating every breakout as useful.
📊 When to Use
• Choppy markets where the user needs a no-trade filter.
• Weekly, daily, and 4H planning where range structure matters more than micro-noise.
• Mature ranges that may be preparing for expansion.
• Breakout-preparation workflows.
• Range-to-trend transition monitoring.
• Symbols where invalidation and target structure should be visible before acting.
⚠️ When NOT to Use
• Extremely illiquid markets with unreliable candles.
• Symbols where volume data is misleading, unless volume participation is disabled.
• News-driven spikes where a single candle can distort range logic.
• Very low timeframes with excessive spread noise.
• Scalping workflows that require rapid-fire signals instead of structural planning.
• Markets where the user has no broader context for trend, liquidity, or session behavior.
🎛️ Key Inputs
• Choppiness Length → controls the chop-detection backbone.
• Decision Range Length → controls how the active no-trade range is framed.
• Minimum Range Age → controls how long chop must persist before planning begins.
• Preparation Threshold → controls when the range moves from avoid mode to preparation mode.
• Minimum Valid Plan Score → controls how selective valid plan labels should be.
• Release Buffer ATR → controls how far price must move beyond the range boundary.
• Invalidation Buffer ATR → controls the distance behind the released boundary used for invalidation.
• Target 1 / Target 2 R Multiples → control target projection from the plan risk.
• Panel Location / Theme / Font Size → control the AGPro panel interface.
• Label Font Size / Cooldown / Maximum Visible Labels → control chart readability.
🖥️ Interface & Visual Design
The interface is designed around fast decision reading. The chart carries the range box, no-trade ribbon, centered zone label, event labels, and active risk/target levels. The panel summarizes the same workflow without becoming a large dashboard.
The first panel row follows the AGPro standard: one merged blue header row containing only the script name.
Visual density is intentionally moderate. The chart should not look empty, but it should also avoid crowded signal spam.
🧪 Practical Usage Workflow
1. Read the panel.
Check Setup Quality and Next Action first.
2. Check the decision range.
If the box says NO-TRADE, the structure is still inefficient. If it says PREP, the range is maturing.
3. Evaluate the release.
A valid PLAN label means the release met the quality threshold. A SKIP label means the release was not strong enough.
4. Review invalidation and targets.
When a plan is active, use the plotted levels to understand structure, not as automatic orders.
5. Confirm broader context.
Combine the planner output with trend, liquidity, timeframe, session, and personal execution rules.
For publication screenshots, higher-timeframe examples are usually the cleanest because they show the complete planning sequence without compressing labels and boxes into a noisy layout.
🔍 Interpretation Guidelines
Think in states, not isolated signals.
NO-TRADE protects attention.
PREP means the market is becoming more interesting.
PLAN means the release has enough structure to track.
SKIP means the release happened but did not earn quality.
INVALID means the plan lost its structural premise.
🚫 What This Script Is NOT
This script is not a prediction engine.
It is not financial advice.
It is not auto trading.
It is not guaranteed signals.
It is not a strategy tester.
It is not a replacement for independent analysis.
⚠️ Limitations & Transparency
The script is rule-based and depends on selected inputs, timeframe, volatility, and available market data.
Different symbols and sessions can produce different behavior. Low liquidity, sudden volatility shocks, and abnormal gaps can reduce the usefulness of range-based planning.
Volume participation is optional because volume quality differs across markets and feeds.
🧠 Market Context Notes
Chop is not always weakness. Sometimes it is absorption, sometimes indecision, and sometimes simple noise. The script does not claim to know the cause. It organizes the observable structure so the user can decide whether the environment is worth attention.
🧾 Use Case Examples
When price spends several bars inside a tight inefficient range and the panel says Avoid: Chop, the script is acting as a no-trade filter.
When the range matures and the centered label changes to PREP, the script is showing that pressure has improved enough to monitor the edge.
When price releases and receives PLAN UP or PLAN DN, the script maps invalidation and targets from the structure.
When price releases but receives SKIP, the script is saying the event did not meet the model's quality threshold.
On weekly charts, a single valid plan can show the entire decision chain: range maturity, preparation, release, target reaction, and invalidation. This is the strongest showcase environment for the script.
🧱 System Philosophy
AGPro tools are built around structured decision support: define the condition, score the quality, map the relevant structure, and keep the chart readable.
Choppiness Setup Planner follows that philosophy by turning a noisy no-trade environment into a cleaner decision workflow.
🔐 Non-Promise Statement
No script can provide certainty.
No score guarantees follow-through.
No label guarantees an outcome.
📉 Risk Disclosure
Trading involves risk. Market conditions can change quickly, planned setups can fail, and losses can occur. This script is provided for educational and analytical use only. It does not provide financial advice or guaranteed trading outcomes. Users remain responsible for their own analysis, decisions, risk management, and execution.
📚 Educational Note
Use this script to study how choppy markets mature, how range releases differ in quality, and how invalidation and target logic can be organized visually before a decision is made. Indicator

Gap Fill Reaction Planner [AGPro Series]Gap Fill Reaction Planner
🧠 Core Idea
Is this gap reaction actually ready for planning, or is it just another rectangle on the chart?
📌 Overview / What it does
Gap Fill Reaction Planner is a planner-style price action tool built around gap fill behavior, reaction quality, and execution readiness. Instead of simply drawing gap zones, it evaluates whether the active gap reaction has enough structure to become a measurable plan.
The script detects gap support and gap resistance zones, tracks fill progress, classifies reaction state, and converts the active setup into a 0-100 readiness score. It also maps a live entry reference, invalidation level, target projection, and estimated R multiple so the user can review the structure as a plan rather than as an isolated signal.
It does not automate trades, predict future price, or replace independent analysis. Its purpose is to organize gap reaction context into a cleaner decision framework.
🎯 Purpose & Design Philosophy
This script was built to move beyond passive gap marking. A normal gap indicator can show where a gap exists, but it does not answer the questions that matter before a trade idea is considered:
Is the reaction valid?
How strong is the setup?
Where is the invalidation?
Where is the target?
What should the trader watch next?
Gap Fill Reaction Planner was designed for traders who want a structured workflow around opening gaps, continuous-market reaction bands, partial fills, full fills, rejection behavior, and acceptance risk. The mindset is not "take every gap." The mindset is "measure the reaction first."
⚡ Why This Script Is Different
Most gap tools focus on detection. They draw every gap, imbalance, or separation zone and leave the decision process to the user.
This script does NOT act as a generic gap highlighter, generic support/resistance map, or broad imbalance catalog.
Instead, it treats each gap as a planning object. Every active zone is evaluated through fill depth, reaction state, volatility context, participation, age, and structural validity. The panel then translates that context into readiness, next action, invalidation, target, and risk/reward information.
That planner layer is the difference. The script helps the user decide whether a gap reaction deserves attention, not merely whether a gap exists.
⚙️ Methodology
1. Context Detection
The script first searches for gap reaction zones. It prioritizes classic open-to-previous-close gaps, then supports adaptive reaction bands for continuous markets where clean opening gaps may be rare.
2. Reference Mapping
Each detected zone receives a fixed-length rectangular band. The zone is not dragged forward forever; it remains anchored to its origin so old structures do not distort the current chart. Thin zones are displayed with a minimum visual height so the chart keeps a cleaner, more professional planning layer.
3. Reaction Evaluation
The engine tracks fill percentage, partial fill, full fill, rejection, and acceptance. Rejection behavior is treated differently from simple fill behavior because a filled gap and a rejected gap communicate different planning context.
4. Planner Scoring
The readiness score combines gap size, fill quality, reaction behavior, volatility participation, and recency. The score is normalized from 0 to 100.
5. Risk / Target Projection
For the active planner zone, the script calculates an invalidation reference beyond the far side of the gap and projects a target using the selected R multiple.
6. Visual Output
The chart shows gap zones, centered zone labels, optional fill progress, planner labels, and active plan levels. The panel summarizes the decision state.
🗺️ How to Read the Chart
Zones
Gap Support zones represent upward gap reactions that may act as support-style planning areas.
Gap Resistance zones represent downward gap reactions that may act as resistance-style planning areas.
Zone Labels
Focused zones can display a centered label showing the zone role, state, and readiness score. This keeps the chart readable without turning every historical zone into a text cluster.
Colors
Bullish planner context uses the AGPro green state color.
Bearish planner context uses the AGPro pink state color.
Neutral or unfinished context uses restrained secondary colors.
Panel
The panel shows readiness, next action, plan side, gap size, fill/state, invalidation, target/R, and bias.
Plan Levels
When an active planner zone exists, the script can display entry reference, invalidation, and target lines.
🚦 Signals & States
• Fresh → A new gap zone exists but has not reached meaningful fill depth.
• Partial Fill → Price has returned into the gap enough to begin reaction monitoring.
• Rejected → Price filled part of the gap and then closed back away from the zone.
• Full Fill → The gap has reached the full-fill threshold and becomes more neutral.
• Accepted → Price closed beyond the far boundary of the gap, meaning the zone has lost its original reaction role.
• Planner Ready → A rejection setup reached the configured readiness threshold.
🔔 Alerts Logic
New Gap Support Zone
Triggers when a bullish gap support planning zone is created.
New Gap Resistance Zone
Triggers when a bearish gap resistance planning zone is created.
Gap Partial Fill
Triggers when a tracked zone reaches the partial-fill threshold.
Gap Full Fill
Triggers when a tracked zone reaches the full-fill threshold.
Gap Planner Ready
Triggers when a rejection setup reaches the readiness score threshold.
Gap Acceptance
Triggers when price accepts beyond the far side of the gap.
Alerts are attention markers and workflow prompts. They are not trade instructions.
🧩 Confluence Logic
The planner score becomes stronger when multiple conditions align:
• The gap has enough ATR-normalized size
• Fill depth is meaningful but not exhausted
• Reaction behavior confirms away from the zone
• Current volatility and participation support the reaction
• The zone is recent enough to remain relevant
When these pieces align, the gap becomes a stronger planning candidate.
📊 When to Use
• After large opening gaps
• During pullbacks into gap support or gap resistance
• Around partial fill and rejection behavior
• In trending markets where gaps create reaction shelves
• In volatile markets where gap fill behavior matters
• On crypto and FX charts where adaptive reaction bands may help continuous-market analysis
⚠️ When NOT to Use
• Extremely low-liquidity symbols
• Very noisy micro timeframes
• Market conditions where spread, slippage, or data quality is poor
• When the chart is moving too fast for structured planning
• When a trader has not defined broader market context
🎛️ Key Inputs
Detection Mode
Controls whether the script uses only classic open gaps or adaptive reaction bands.
Minimum Gap Size
Filters out small gaps using ATR normalization.
Readiness Threshold
Defines the minimum score required for a planner-ready label.
Target Multiple (R)
Projects the target from the current reference price using the invalidation distance.
Invalidation Buffer
Adds ATR-based spacing beyond the far side of the gap zone.
Zone Right Extension
Controls how far each zone projects from its origin.
Panel / Label Settings
Control panel visibility, panel theme, panel location, and font sizes.
🖥️ Interface & Visual Design
The interface is built for quick decision review. The panel provides the planner summary, while the chart emphasizes the most important structural elements: premium-height zones, focused centered labels, action labels, and active plan levels.
The visual hierarchy is intentionally clean. Zones explain context, labels explain state, and the panel explains what to do next from an analytical standpoint.
🧪 Practical Usage Workflow
1. Read the panel readiness score.
2. Check whether the next action is monitor, wait, plan, or stand aside.
3. Review the active gap zone and its centered label.
4. Compare fill percentage with the reaction state.
5. Review invalidation and target levels.
6. Confirm the idea with broader market context before acting.
🔍 Interpretation Guidelines
A high score does not mean certainty. It means the gap reaction has stronger planning structure.
A partial fill means price has started interacting with the gap, but reaction quality still matters.
A rejection state is more meaningful when it occurs with strong score, clean invalidation, and acceptable target distance.
An accepted zone should usually be treated as a failed reaction context rather than an active planning area.
🚫 What This Script Is NOT
This script is not a prediction engine.
This script is not an automated trading system.
This script is not a financial advice tool.
This script does not provide guaranteed outcomes.
This script does not replace risk management, trade review, or independent confirmation.
⚠️ Limitations & Transparency
Gap behavior can change significantly across symbols and timeframes.
Continuous markets may produce fewer classic opening gaps, which is why the script includes adaptive detection modes.
Volatility expansion can make targets and invalidation levels wider.
Low-liquidity environments may reduce the reliability of reaction labels and score readings.
No rule-based tool can fully account for news events, sudden liquidity shifts, or execution quality.
🧠 Market Context Notes
Gap reactions are often more useful when they are read together with trend structure, volatility, session behavior, and liquidity context. A gap zone is not automatically important because it exists. It becomes more useful when price returns to it, reacts clearly, and produces a measurable planning structure.
🧾 Use Case Examples
When price returns into a Gap Support zone and rejects upward with a high readiness score, the panel can help review whether invalidation and target structure are measurable.
When price fills a Gap Resistance zone and accepts above it, the script marks the context as acceptance rather than treating the zone as a still-valid resistance area.
When the panel shows low readiness, the script is communicating that the structure may exist visually but is not yet a strong planner candidate.
🧱 System Philosophy
AGProLabs tools are built around structured interpretation. The goal is not to add more noise to the chart. The goal is to convert raw market behavior into a cleaner decision framework that traders can review with discipline.
🔐 Non-Promise Statement
No indicator can remove uncertainty.
No score can guarantee a result.
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, or guaranteed trading outcomes. Users remain responsible for their own research, risk management, position sizing, and execution decisions.
📚 Educational Note
The best use of this script is not to chase every gap. The best use is to slow the decision process down, measure the reaction, and decide whether the setup is structured enough to deserve attention.
Indicator
