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

Trailing Stop Quality [AGPro Series]Trailing Stop Quality
🧠 Core Idea
Is the current trailing reference defending the move cleanly, or is it creating noise that deserves a risk review?
📌 Overview / What it does
Trailing Stop Quality is a trade-management planner built for traders who want more context around active trailing stops, defense rails, and risk-shift conditions.
The script compares a swing defense rail with a volatility defense rail, evaluates trend-defense quality, measures pullback depth, checks volatility expansion, and converts the result into a 0-100 trailing stop quality score.
It produces trail rails, a centered risk-shift zone, a target-room guide, compact state labels, alerts, and a clean AGPro panel. It does not predict price direction, automate trading, or tell users what to buy or sell.
🎯 Purpose & Design Philosophy
Many trailing stop tools show a stop line, but they do not explain whether the current trail is structurally clean, too close to noise, too loose, or in conflict with another management reference.
This script was built to fill that gap.
It helps traders who already have a move in progress and want to evaluate whether the active trail is still defending the move with enough quality to keep monitoring.
The design philosophy is simple: manage context before reacting to the line.
⚡ Why This Script Is Different
Most tools focus on plotting a trailing stop line, flipping side, or marking stop transitions.
This script does NOT clone a Chandelier Exit flip-zone tool, does not act as a stop-loss optimizer, and does not print direct trade commands.
Instead, it scores the quality of the current trail using swing defense, volatility defense, trend slope, pullback depth, volatility expansion, and rail conflict. The result is a management-readiness layer, not another raw stop signal.
⚙️ Methodology
1. Context Detection
The script reads the active management side automatically or lets the user force long-side or short-side evaluation.
2. Reference Mapping
It maps two trail references: a swing defense rail and a volatility defense rail. The tighter reference becomes the active defense rail.
3. Reaction Evaluation
It scores whether the active trail is balanced, too near, too loose, conflicted, or already broken.
4. Visual Output
It displays the active defense rail, swing rail, volatility rail, risk-shift zone, target guide, compact labels, alerts, and AGPro panel state.
🗺️ How to Read the Chart
Zones = the risk-shift zone shows the gap between the swing defense rail and volatility defense rail. Its centered label summarizes the active conflict or quiet state.
Labels = labels mark TRAIL HOLDS, RISK SHIFT, MONITOR, NOISE, ROOM LIMITED, or DEFENSE LOST contexts.
Colors = green highlights clean defense, pink highlights lost defense, amber highlights risk review, and indigo highlights monitor context.
Panel = the panel summarizes Trail Quality, Stop Distance, Trend Defense, Risk Shift, and Action.
🚦 Signals & States
• TRAIL HOLDS → the active trail is defending cleanly with enough score and no major risk-shift conflict.
• RISK SHIFT → price is close to the active rail or swing and volatility rails disagree enough to deserve review.
• MONITOR → trail quality is acceptable but not strong enough for a clean defense state.
• NOISE → the current trail reference is low quality or too unstable.
• ROOM LIMITED → forward room is limited relative to the active trail risk.
• DEFENSE LOST → price crossed the active defense rail and the current trail context should be reviewed.
🔔 Alerts Logic
Alerts trigger when the script detects a clean trail-hold state, risk-shift state, monitor state, noisy trail state, defense-loss event, or limited target-room condition.
Alerts are attention markers only.
They are not trade instructions and should be interpreted within broader market context.
🧩 Confluence Logic
The strongest context appears when swing defense and volatility defense are aligned, the active trail distance is balanced, trend slope supports the management side, pullback depth is controlled, and volatility is expanding without becoming chaotic.
When those conditions align, the 0-100 trail quality score improves.
📊 When to Use
• During active trend-following management
• After a move has already started and trailing references matter
• When comparing swing-based trail behavior with volatility-based defense
• During pullbacks where the trail may be too close to price
• When evaluating whether a move still has reasonable room before the next structure edge
⚠️ When NOT to Use
• Very low-liquidity symbols with erratic wick behavior
• Extremely noisy chop where no stable management side exists
• Event-driven spikes where volatility changes too quickly
• Charts where the user wants entry signals instead of trail-quality context
🎛️ Key Inputs
• Management Side → controls Auto, Long Management, or Short Management mode.
• Swing Trail Lookback → controls the structural defense rail.
• Volatility Rail Multiple → controls the ATR-based volatility defense rail.
• Sensitivity → adjusts how strict the trail-quality scoring model is.
• Minimum Clean Score → defines when the trail can qualify as a clean defense state.
• Target Guide R Multiple → sets the forward planning reference used for target-room context.
• Visual settings → control rails, risk-shift zone, target guide, labels, panel location, panel theme, and font sizes.
🖥️ Interface & Visual Design
The interface is intentionally chart-first.
The rails show the actual management references, the zone shows swing-versus-volatility conflict, and the panel gives a fast decision read without turning the script into a crowded dashboard.
The AGPro panel uses a single merged blue header row and keeps the key state visible at a glance.
🧪 Practical Usage Workflow
1. Read the panel Trail Quality state.
2. Check whether the active defense rail is still below price in long management or above price in short management.
3. Review the risk-shift zone to see whether swing and volatility references agree.
4. Check whether the target guide still has reasonable forward room.
5. Use the label state as an attention marker, then confirm with broader structure and market context.
🔍 Interpretation Guidelines
Think of the output as trail-quality context, not a trade signal.
A high score means the active trail is better aligned with structure, volatility, trend defense, and pullback depth.
A low score means the current trailing reference may be too noisy, too close, too loose, or already losing defensive value.
🚫 What This Script Is NOT
• Not a prediction engine
• Not financial advice
• Not auto trading
• Not guaranteed signals
• Not a Chandelier Exit clone
• Not a stop-loss optimizer
• Not a buy or sell signal tool
⚠️ Limitations & Transparency
Trailing stop quality can change quickly when volatility expands, contracts, or when price moves into noisy pullback conditions.
Different timeframes may produce different trail rails and score behavior.
Fast markets, low liquidity, and abnormal wick behavior can reduce the usefulness of any rule-based trail-quality model.
🧠 Market Context Notes
Trail quality is not only about distance from price.
It also depends on whether structure is still defending the move, whether volatility is stable enough to support the rail, and whether the next target area leaves enough room relative to current trail risk.
🧾 Use Case Examples
When price trends higher and both swing defense and volatility defense remain below price with a strong score, the script may mark TRAIL HOLDS.
When price compresses toward the active trail or swing and volatility rails separate too much, the script may mark RISK SHIFT.
When price crosses the active defense rail, the script may mark DEFENSE LOST so the user can review the management context.
🧱 System Philosophy
Trailing Stop Quality belongs to the AGPro planner-style family: tools designed to help traders evaluate context before decisions, rather than simply adding another signal to the chart.
🔐 Non-Promise Statement
No output from this script guarantees a result.
No score represents certainty.
📉 Risk Disclosure
Trading involves risk.
Users are responsible for their own decisions, position sizing, and risk management.
This script is for educational and analytical purposes only and does not provide financial advice.
📚 Educational Note
The goal is to make trailing stop context easier to inspect by separating clean defense, risk shift, noisy trails, limited room, and lost defense states.
Indicator

Stop Distance Quality [AGPro Series]Stop Distance Quality
🧠 Core Idea
Is the invalidation distance structurally reasonable, or is it too tight, too wide, or too exposed to noise?
📌 Overview / What it does
Stop Distance Quality is a chart-first risk planning tool built to evaluate stop-distance quality before a setup is treated as clean.
The script studies the active invalidation rail, ATR-normalized stop distance, swing structure fit, wick risk, volatility context, and available target room. It converts those components into a 0-100 risk-quality score and a clear next-action state.
It produces a stop-fit band, an invalidation rail, an ideal-fit guide, compact chart labels, alerts, and a clean AGPro planning panel. It does not select the best stop method, size positions, predict price direction, or automate trade decisions.
🎯 Purpose & Design Philosophy
This script was built to fill a specific planning gap: many tools show where a stop could be placed, but fewer tools ask whether that stop distance is structurally usable.
It helps traders who already have a setup idea and want to evaluate whether the invalidation distance is balanced enough to keep watching.
The design supports disciplined planning: measure the risk first, then decide whether the setup deserves attention.
⚡ Why This Script Is Different
Most tools focus on plotting stop-loss levels, comparing stop-loss methods, or attaching stops to entry signals.
This script does NOT act as a stop-loss optimizer, position-size calculator, target ladder, or directional signal tool.
Instead, it answers one practical planning question: is the current stop distance too tight, too wide, or reasonably aligned with structure and volatility?
⚙️ Methodology
1. Context Detection
The script selects long or short evaluation context using either manual side selection or automatic trend and range-location reading.
2. Reference Mapping
It maps one active swing-based invalidation rail and builds a stop-fit band using minimum, ideal, and maximum ATR-normalized distance boundaries.
3. Reaction Evaluation
It scores stop distance, swing structure fit, wick risk, volatility context, and target room.
4. Visual Output
It displays the stop-fit band, invalidation rail, ideal-fit guide, chart labels, alerts, and AGPro panel state.
🗺️ How to Read the Chart
Zones = the stop-fit band shows the acceptable ATR-normalized area where the active invalidation distance is considered more balanced.
Labels = labels mark FIT, WATCH, TOO TIGHT, TOO WIDE, NO ROOM, or invalidation-check contexts.
Colors = AGPro green highlights balanced fit, pink highlights wide-risk pressure, amber highlights caution, and indigo highlights active watch context.
Panel = the panel summarizes Stop Distance, ATR Context, Structure Fit, Risk Quality, and Action.
🚦 Signals & States
• FIT → stop distance is structurally reasonable enough for active review.
• WATCH → risk quality is improving but not strong enough for FIT.
• TOO TIGHT → invalidation distance is too close relative to ATR and may be vulnerable to normal noise.
• TOO WIDE → invalidation distance is too large relative to the current chart context.
• NO ROOM → target room is not clean enough for the current risk distance.
• WEAK FIT → the current context does not meet the minimum quality threshold.
🔔 Alerts Logic
Alerts trigger when the script enters FIT, WATCH, TOO TIGHT, TOO WIDE, or NO ROOM state.
An additional alert can trigger when price crosses the prior invalidation rail.
Alerts are attention markers only. They are not trade instructions.
🧩 Confluence Logic
The strongest context appears when stop distance sits near the ideal ATR band, swing structure is clear, wick noise is controlled, volatility is readable, and target room remains open.
When several of these conditions align, the risk-quality score improves.
📊 When to Use
• Before evaluating a risk-defined setup
• During pullbacks where invalidation placement matters
• Around breakout retests where stops can be too tight or too wide
• In structured trending or range-extension environments
⚠️ When NOT to Use
• Very low-liquidity symbols with erratic wicks
• Extremely noisy markets where ATR changes too quickly
• News-driven candles or abnormal event spikes
• Charts where no clear swing invalidation exists
🎛️ Key Inputs
• Evaluation Side → controls Auto, Long Context, or Short Context scoring.
• ATR Length → normalizes stop distance, wick risk, target room, and visual offsets.
• Invalidation Lookback → controls the swing rail used as the active invalidation reference.
• Minimum / Ideal / Maximum Stop ATR → define the stop-fit band.
• FIT / WATCH Thresholds → control how selective the planner is.
• Visual settings → control band visibility, guide lines, labels, panel location, theme, and font sizes.
🖥️ Interface & Visual Design
The interface is intentionally narrow and readable.
The chart focuses on one main visual object: the stop-fit band. The panel uses a single merged AGPro header row and keeps the essential risk-quality information visible without turning the script into a dashboard-heavy tool.
Labels are compact, offset from candles, and controlled with cooldown and maximum-visible settings.
🧪 Practical Usage Workflow
1. Read the panel risk-quality state.
2. Check whether the invalidation rail sits inside, below, or beyond the stop-fit band.
3. Review whether the label says FIT, WATCH, TOO TIGHT, TOO WIDE, or NO ROOM.
4. Confirm structure and volatility context before treating the setup as meaningful.
🔍 Interpretation Guidelines
Think of the output as a risk-quality filter, not a trade signal.
A FIT state means the distance is more balanced relative to ATR and structure. It does not mean price must move favorably.
A TOO TIGHT or TOO WIDE state means the risk reference may need more context, more buffer, or a cleaner setup.
🚫 What This Script Is NOT
• Not a prediction engine
• Not financial advice
• Not auto trading
• Not guaranteed signals
• Not a stop-loss optimizer
• Not a position-sizing calculator
⚠️ Limitations & Transparency
Stop-distance quality can change as volatility expands or contracts.
Different timeframes may produce different invalidation rails and ATR readings.
Fast markets, low liquidity, and abnormal wick behavior can reduce the usefulness of any rule-based distance model.
🧠 Market Context Notes
Risk quality is not only about where a stop sits. It also depends on whether volatility is readable, whether the swing reference is meaningful, and whether there is enough room before nearby obstruction.
This script keeps those factors visible without adding unrelated signal logic.
🧾 Use Case Examples
When price pulls back in a trend and the invalidation rail sits inside the stop-fit band, the setup can move into review mode.
When the stop distance is below the minimum ATR boundary, the script may mark TOO TIGHT and suggest waiting for more buffer.
When stop distance is large but target room is limited, the script may mark NO ROOM or TOO WIDE.
🧱 System Philosophy
Stop Distance Quality belongs to the AGPro planner-style family: tools that help traders evaluate context before decisions, rather than simply printing another signal.
🔐 Non-Promise Statement
No output from this script guarantees a result.
No score represents certainty.
📉 Risk Disclosure
Trading involves risk.
Users are responsible for their own decisions, position sizing, and risk management.
This script is for educational and analytical purposes only and does not provide financial advice.
📚 Educational Note
The goal is to make risk distance easier to inspect and compare across changing volatility conditions.
Indicator

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

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

Cup and Handle Quality [AGPro Series]Cup and Handle Quality
🧩 OVERVIEW
Cup and Handle Quality is a visual pattern-quality overlay for one of the most recognized continuation structures in technical analysis: the cup and handle.
The script is designed to map the full pattern lifecycle instead of only marking a breakout candle. It studies the left cup rim, the cup base, the right rim recovery, the controlled handle pullback, the breakout behavior, and the measured projection context. The goal is to make cup and handle structures easier to recognize, compare, and explain directly on the chart.
The final visual output is intentionally clear. The detected cup and handle candle ranges are framed with subtle boxes, while thick curved outlines make the formation readable at a glance. The rim line, target line, DEPTH arrow, and MOVE arrow help users understand how the structure is measured, not just where the label appears.
✅ WHAT MAKES IT DIFFERENT
Most public cup and handle tools focus on one of two things: either they draw a simple breakout marker, or they scan aggressively and leave the chart crowded with low-context shapes. Cup and Handle Quality takes a narrower approach.
It combines three layers:
- Structure recognition: left rim, cup base, right rim, and handle low
- Quality scoring: cup symmetry, handle depth, and breakout quality
- Visual education: cup box, handle box, thick pattern outline, rim line, target line, and measurement arrows
This makes the script more than a pattern detector. It is also a visual explanation tool. The chart shows where the cup was detected, where the handle formed, how deep the cup is, and where the measured projection line comes from.
🧭 WHY THIS DOES NOT OVERLAP WITH OTHER AGPRO TOOLS
This script has its own lane inside the AGPro Series.
It is not a flag scanner, wedge detector, triangle breakout module, inside-bar breakout tool, Donchian breakout validator, double-top detector, head-and-shoulders detector, generic support-resistance map, or supply-demand zone script.
Its lane is specifically:
Cup rim recovery -> controlled handle depth -> breakout participation -> measured projection line.
The script focuses on the complete cup and handle lifecycle. It does not try to replace broader breakout engines, market-structure tools, support-resistance tools, liquidity tools, or trend dashboards. The defining feature is the combination of a recognizable cup-and-handle drawing with a quality panel that grades the actual pattern components.
⚙️ METHODOLOGY
The engine builds the pattern from pivot structure. A qualified setup begins with a left rim, moves into a cup low, recovers into a right rim, and then forms a handle pullback after the right rim.
The quality model evaluates:
1. Cup Symmetry
The script compares the two rim areas and measures how balanced the cup is over time. A cleaner return from the cup base into the right rim area produces a stronger symmetry reading.
2. Handle Depth
The handle is measured as a percentage of cup depth. A useful handle should create structure without pulling so deeply that the cup profile loses strength. The input range allows the user to control how strict or flexible the handle requirement should be.
3. Breakout Quality
Breakout quality is calculated from candle behavior and participation context. The script checks distance beyond the rim, candle body efficiency, close location, and relative volume against a configurable baseline.
4. Final Score
The final score combines the structure score and breakout behavior into a compact quality reading. Developing setups can be shown before breakout confirmation, while confirmed breakouts require the breakout quality gate.
📊 PANEL
The AGPro panel displays the main quality dimensions in a compact format:
- Cup Symmetry
- Handle Depth
- Breakout Quality
- Score
The first row follows the AGPro standard with a merged blue title row. Panel location, panel theme, panel font size, and label font size are adjustable from settings.
🎛️ KEY INPUTS
- Pivot Span controls structural sensitivity.
- Minimum Cup Bars defines the shortest accepted cup duration.
- Maximum Cup Bars defines the longest accepted cup duration.
- Maximum Rim Variance % controls how closely the left and right rims must align.
- Minimum Cup Depth ATR filters shallow structures.
- Minimum Handle Depth % filters handles that are too shallow.
- Maximum Handle Depth % filters handles that are too deep.
- Breakout Volume Baseline controls the relative volume comparison.
- Minimum Setup Score controls developing setup visibility.
- Minimum Breakout Quality controls confirmed breakout strictness.
- Minimum Pattern Score controls the final quality gate.
- Show Developing Setup controls pre-breakout visualization.
- Show Cup Path controls the curved cup drawing and cup candle box.
- Show Handle Box controls the detected handle range.
- Show Target Line controls the measured projection line.
- Show Measurement Arrows controls the DEPTH and MOVE explanation arrows.
- Pattern Stroke Width controls the thickness of the cup and handle outlines.
- Target Projection Bars controls how far the measured target line extends.
🔍 HOW TO READ IT
Start with the rim line. This is the reference level the structure must recover into and eventually move beyond.
Then read the cup. The subtle cup box marks the detected candle range, while the thick curved outline helps the formation read visually as a cup instead of a simple V-shaped swing.
Next read the handle. The handle box marks the controlled pullback area after the right rim. The curved handle outline makes the handle easier to recognize without turning it into a generic rectangle pattern.
The DEPTH arrow shows the measured cup depth. The MOVE arrow transfers that depth upward from the rim area. The TARGET line shows the forward measured projection level.
The panel summarizes the same structure numerically. Stronger Cup Symmetry, disciplined Handle Depth, and stronger Breakout Quality combine into the final Score.
🧩 BEST USE CASES
Cup and Handle Quality is best used on liquid symbols and timeframes where swing structure has enough room to develop. It is especially useful for users who want a clean visual map of a classic continuation pattern without filling the chart with unrelated pattern families.
The default settings are tuned for active discovery. Users who want fewer patterns can raise pivot sensitivity or score thresholds. Users who want a more reactive view can lower the score thresholds, while still using the chart visuals to review pattern quality.
🧠 VISUAL DESIGN PHILOSOPHY
The design philosophy is simple: make the pattern understandable without making the chart noisy.
The cup and handle are drawn with thick curved lines because this pattern is visual by nature. Newer users should be able to see the shape immediately. At the same time, the candle boxes keep the drawing grounded in the actual detected structure.
The target is shown as a line rather than a large zone, keeping the projection clean. The DEPTH and MOVE arrows explain the measurement logic without turning the indicator into a crowded education panel. Labels are compact, and the panel is restrained so the chart remains the main focus.
🔔 ALERTS
The script includes an alert condition for confirmed cup and handle breakouts.
Alert name:
Cup and Handle Quality Breakout
Alert message:
Cup and Handle Quality : high-quality cup and handle breakout confirmed on {{ticker}} at {{close}}.
Alerts are tied to confirmed breakout logic, which means the structure, breakout quality, and pattern score must pass the configured gates.
🔹 LIMITATIONS AND TRANSPARENCY
Cup and handle structures are pattern-based and depend on pivot interpretation. Different sensitivity settings can produce different structures on the same chart.
Very noisy markets, illiquid symbols, extreme gaps, and unusually compressed price action can reduce pattern readability. Lower thresholds may produce more setups, but visual review remains important when using any chart-pattern tool.
The thick cup and handle lines are designed as visual guides. The subtle candle boxes identify the detected structure ranges, while the curved outlines make the pattern easier to understand on the chart.
✅ IDEAL USER
This script is built for traders and analysts who want a clean, visual, and structured way to study cup and handle formations.
It is especially useful for:
- Users who want classic chart patterns with a modern quality layer
- Price-action traders who care about structure, handle depth, and breakout behavior
- Chart reviewers who want a clear visual explanation of the setup
- Newer users who benefit from seeing the cup, handle, depth, move, and target drawn directly on the chart
- AGPro users who want a focused cup-and-handle tool that does not overlap with broader breakout or market-structure scripts Indicator

Darvas Box Breakout Quality [AGPro Series]Darvas Box Breakout Quality
🔹 OVERVIEW
Darvas Box Breakout Quality is built for one of the most recognizable and widely searched chart-pattern structures in technical analysis: the Darvas Box.
The script focuses on the full Darvas lifecycle:
Box formation → compression quality → breakout direction → volume support → failed-break behavior.
Instead of treating every horizontal range as support and resistance, this script waits for a Darvas-style structure to form, validates the box by age and volatility-adjusted height, then evaluates how price resolves from that box. The result is a clean chart-pattern workflow designed for traders who want to study rectangular compression and breakout quality without turning the chart into a crowded zone map.
The main visual element is the active Darvas box itself. By default, resolved boxes are removed after breakout so the chart stays focused on the current live structure instead of filling with old rectangles.
🔹 WHAT MAKES IT DIFFERENT
Most box or breakout tools stop at drawing a rectangle or marking the first break beyond a level. Darvas Box Breakout Quality adds structure, scoring, and failure awareness.
Core differentiators:
• Darvas-first structure logic
The rectangle is not a generic support/resistance zone. It comes from a Darvas box formation process built around a fresh seed high, containment, age, and volatility-adjusted box height.
• Compression quality
The script measures whether the box has enough maturity and controlled range behavior before treating it as a meaningful active structure.
• Breakout quality score
Every qualified breakout is evaluated with a 0-100 model that includes compression quality, relative volume, breakout distance, candle body participation, and directional close location.
• Volume confirmation
Breakout labels can require volume support, helping separate stronger participation events from weaker boundary pokes.
• Failed-break tracking
After breakout, the script watches whether price returns back inside the former box within the selected failure window. If it does, the event is marked as a failed break.
• Premium visual restraint
The default chart view uses one active box, compact labels, controlled label spacing, and a compact AGPro panel. The goal is to make the chart informative without making it noisy.
🧭 WHY THIS DOES NOT OVERLAP WITH OTHER AGPRO TOOLS
This script is intentionally separated from the existing AGPro breakout and chart-pattern family.
It is not Inside Bar Breakout Quality, because it does not require a mother bar or inside-bar compression sequence.
It is not Donchian Breakout Quality, because it is not based on rolling channel highs and lows.
It is not Opening Range Breakout logic, because it is not tied to a session-defined range.
It is not Triangle Breakout Quality, because it does not use converging pivot boundaries, apex pressure, or diagonal structure.
It is not Breakout Volume Quality, because volume is only one part of the confirmation model, not the entire concept.
It is not a supply/demand, order-block, or generic support/resistance zone script. The rectangle exists only when the Darvas box formation process supports it.
That distinction matters visually and analytically. On the chart, this script tells a Darvas story: rectangular compression, active box behavior, quality of release, and failed-break review.
⚙️ METHODOLOGY
1. Darvas seed detection
The script looks for a fresh high over the selected lookback period. This high becomes the initial reference for a potential Darvas box.
2. Box formation
After the seed appears, price must spend enough time contained beneath the upper boundary while the lower boundary develops. The box remains in formation until it meets the selected age and height requirements.
3. Volatility normalization
The box height is measured relative to ATR. This helps filter boxes that are too flat to matter or too wide to represent clean compression.
4. Active box state
When the box qualifies, the script displays the active Darvas box and optional midpoint. The box projects forward so the active breakout boundary remains visible while price approaches it.
5. Breakout confirmation
A bullish breakout requires price to resolve above the Darvas top. A bearish breakout requires price to resolve below the Darvas bottom. Users can require close-based confirmation for stricter filtering.
6. Quality score
The breakout score combines:
• Compression quality
• Relative volume support
• ATR-normalized breakout distance
• Candle body participation
• Directional close location
7. Failed-break monitoring
After breakout, the script watches a defined number of bars. If price returns back inside the former Darvas boundary, the failed-break marker is printed.
📊 PANEL
The AGPro panel summarizes the current Darvas environment:
• Box Age
• Compression
• Breakout Side
• Volume Support
• Latest Quality / State
The first panel row follows the AGPro publication standard: one merged blue header row containing only the panel title. Panel location, panel theme, and panel font size are adjustable from settings.
🎛️ KEY INPUTS
Darvas Box Detection
• New High Lookback
• Minimum Box Age
• Maximum Box Age
• ATR Length
• Minimum Box Height ATR
• Maximum Box Height ATR
• Require Close Beyond Box
Breakout Quality
• Volume MA Length
• Volume Support Threshold
• Require Volume Support
• Target Break Distance ATR
• Minimum Breakout Score
• Failed Break Window
Visual Controls
• Show Active Darvas Box
• Show Box Midline
• Show Breakout Labels
• Show Failed Break Markers
• Keep Resolved Box
• Box Projection Bars
• Label Cooldown Bars
• Maximum Visible Labels
• Label Offset ATR
• Label Stack Offset ATR
• Label Font Size
Panel
• Panel Location
• Panel Theme
• Panel Font Size
🔍 HOW TO READ IT
When a Darvas box becomes active, the chart displays the live rectangular structure. The panel shows how old the box is, how compressed it is, and whether the latest environment has breakout direction or volume support.
When price resolves outside the box with enough quality, the chart prints a compact breakout label such as UP 79 or DN 75. The number represents the breakout quality score.
When price fails to hold outside the box and returns back inside during the selected failure window, the script prints a compact failed-break marker such as FAIL UP or FAIL DN.
The best readings come when the box is visually clear, compression is meaningful, and the breakout candle has both directional close quality and volume support.
🧩 BEST USE CASES
• Classic Darvas box formations
• Rectangular range compression
• Box breakout quality review
• Volume-backed breakout confirmation
• Failed-break review after a box release
• Clean chart-pattern study
• Multi-timeframe Darvas structure observation
• Screenshot-friendly public chart analysis
🧠 VISUAL DESIGN PHILOSOPHY
Darvas Box Breakout Quality is designed to look premium through restraint.
The script avoids filling the chart with old boxes by default. It keeps the active Darvas box as the main visual layer, uses short event labels, adds cooldown and stack spacing to reduce overlap, and keeps the panel compact.
This makes the indicator easier to publish, easier to read, and easier to use across different symbols and timeframes.
🔔 ALERTS
The script includes alert conditions for:
• High-quality bullish Darvas breakout
• High-quality bearish Darvas breakout
• Failed bullish Darvas breakout
• Failed bearish Darvas breakout
These alerts follow the same structure-aware logic used by the chart labels.
🔹 LIMITATIONS AND TRANSPARENCY
Darvas box detection is structure-based and depends on the selected lookback, age, and ATR filters. Changing those settings can make the script more selective or more active.
Volume support depends on the quality of the symbol's volume feed. On instruments where volume is less informative, users may prefer to adjust the volume threshold or disable the volume requirement.
The score is a structured description of breakout quality according to the script's internal model. It is designed to help compare Darvas box releases by quality, not to replace the user's broader market context.
✅ IDEAL USER
This script is designed for traders who want a focused Darvas box tool with cleaner structure detection, breakout quality scoring, volume confirmation, failed-break awareness, and a premium chart layout.
It is best suited for users who want the Darvas box itself to remain the main story on the chart. Indicator

Heikin Ashi Trend Zones [AGPro Series]Heikin Ashi Trend Zones
Heikin Ashi Trend Zones is a clean overlay built for traders who like the smoothing behavior of Heikin Ashi but still want to keep the original market candles visible. Instead of repainting the chart with synthetic candles, the script reads the internal Heikin Ashi state in the background and converts it into a focused trend-state layer.
The engine follows four core ideas:
1. Internal HA Side
The script calculates the active Heikin Ashi side from synthetic HA open and close values, then filters weak neutral bodies so the state does not flip on every small candle.
2. HA Streak Quality
The panel tracks how long the current HA side has been active. This helps separate early state changes from mature continuation phases.
3. Optional Transition Zones
When the HA side changes with enough body strength, wick cleanliness, close location, ATR pressure, and prior-state maturity, the script can project a compact rectangular transition zone. This layer is disabled by default so the public chart view stays clean, but it remains available for traders who want to inspect HA changeover corridors.
4. Continuation Quality
Once a HA streak matures, the script scores continuation quality using body strength, wick cleanliness, close location, smoothed HA slope, streak depth, and ATR context. Labels appear only when the continuation score is strong enough and the cooldown rules allow a clean chart presentation.
What makes this script different
- It does not replace real candles with Heikin Ashi candles.
- It does not behave like a generic trend-following dashboard.
- It focuses on HA state transitions, HA streak maturity, and continuation quality.
- Optional transition boxes are concept-native HA corridors, not broad horizontal support/resistance zones.
- Label density is capped with cooldown and maximum visible label controls.
- The panel exposes HA side, streak, transition quality, continuation quality, and ATR context in a compact AGPro layout.
Visual design
The overlay stays restrained:
- A slim trend-state ribbon follows the smoothed HA path.
- Optional transition zones can extend forward as compact rectangles when enabled.
- Continuation labels are offset from candles with ATR spacing.
- Panel location, panel theme, panel font size, and label font size are adjustable.
Suggested usage
Use the script to study whether Heikin Ashi structure is shifting, stabilizing, or continuing while the original candles remain visible. The strongest reads usually come from alignment between a clean HA side, a growing streak, strong continuation quality, and an ATR context that supports the current state.
Default settings are tuned for a balanced public chart view with a clean ribbon and selective continuation labels. Faster traders can reduce smoothing and cooldown values. Swing traders can enable transition zones, increase transition projection, and require higher continuation quality for fewer labels. Indicator

Opening Range Failure Zones [AGPro Series]📌 Bollinger Walk Quality
Bollinger Walk Quality is built for one specific question: when price starts walking the outer Bollinger Band, is that walk strong enough to support continuation, or is the structure beginning to fail?
Many Bollinger Band tools focus on band touches, volatility contraction, width percentiles, or squeeze-style expansion setups. This script takes a different approach. It studies the behavior that comes after expansion: persistent upper-band or lower-band walking, directional pressure around the outer lane, pullback quality inside the band structure, and the point where the walk begins to lose control.
The goal is to make Bollinger Band continuation easier to read directly on the chart. Instead of treating every band touch as meaningful, the script scores whether price is staying in the correct outer lane, whether the Bollinger basis supports the active direction, whether pressure is persisting across multiple bars, and whether a pullback is holding in a healthy continuation pocket.
🧭 What The Script Measures
1. Walk Side
The panel identifies whether the active environment is an Upper Walk, Lower Walk, Cooling Walk, or Neutral state.
Upper Walk means price is persistently operating near the upper Bollinger lane while the basis supports upward continuation pressure.
Lower Walk means price is persistently operating near the lower Bollinger lane while the basis supports downward continuation pressure.
Cooling states appear when a recent walk is no longer fully active, but the script is still monitoring pullback quality and failure risk for a limited memory window.
2. Band Pressure
Band Pressure is a quality score for the active or developing walk. It combines outer-lane position, persistence, band contact behavior, basis slope support, and candle direction. A higher score means the walk has stronger structural pressure. A lower score means price is no longer showing durable outer-band control.
This keeps the script focused on continuation quality instead of simple band interaction. The chart can show a band touch, but the panel helps separate a weak touch from a real band-walk environment.
3. Pullback Quality
Healthy band walks often reset toward the middle of the Bollinger structure before continuing. Bollinger Walk Quality tracks that reset through a concept-native pullback pocket.
The pullback pocket is not a generic support or resistance rectangle. It is projected from the current Bollinger structure and represents the area where a band walk can cool off while still keeping its continuation profile intact.
The panel can show states such as Awaiting Pullback, Testing Pocket, Clean Hold, or Weak Reset. This helps distinguish a controlled continuation reset from a walk that is losing quality.
4. Failure Risk
Failure Risk is designed to catch the moment when an active or recently active band walk starts to break down. It rises when price loses the outer lane, pressure falls, the basis slope weakens, or price begins to threaten the Bollinger basis.
The failure label is intentionally restrained. It appears only on fresh failure events, so the chart remains clean and readable instead of filling with repeated warnings.
🎯 Core Features
- Outer-band walk detection for upper and lower Bollinger continuation phases
- Band pressure scoring based on lane position, persistence, slope support, and band contact behavior
- Pullback-to-band quality state for continuation resets
- Projected pullback pockets that show where a healthy walk can reset without losing structure
- Failure warning labels when the active walk loses pressure or threatens the basis
- Clean AG Pro panel with walk side, band pressure, pullback quality, and failure risk
- Adjustable panel location, theme, font sizes, label spacing, label clearance, zone projection, and visual density
📊 Visual Design
The default view is designed for a clean public PulseWire chart.
The script displays Bollinger Bands, highlights the active walk track, projects a limited number of pullback zones, and uses event labels with spacing controls. Labels are anchored outside the local candle envelope so they do not disappear inside candles or cover important price action.
The chart remains active enough to be visually informative, but the object count and label density are controlled by default. This keeps the indicator suitable for repeated use across different symbols and timeframes.
🧩 Panel
The AG Pro panel summarizes the current state in four compact rows:
- Walk Side
- Band Pressure
- Pullback Quality
- Failure Risk
Panel location, panel theme, panel font size, label font size, label spacing, label clearance, zone projection, zone opacity, and object limits are all adjustable from the settings menu.
🔎 How This Is Different
Bollinger Walk Quality is not a squeeze map and does not rely on compression logic. It does not use Keltner confirmation, volatility percentile ranking, or width contraction states.
Its lane is continuation after expansion:
- Is price walking the band?
- Which side controls the walk?
- Is the walk supported by pressure and basis slope?
- Is the pullback still healthy?
- Is the walk beginning to fail?
That makes it a separate Bollinger Band workflow from squeeze-focused tools. It is designed for traders who want to evaluate trend continuation rhythm, pullback behavior, and outer-band pressure in a more structured way.
✅ Best Use Cases
- Studying Bollinger Band walk continuation
- Reviewing trend pressure after expansion
- Identifying controlled pullbacks inside active band-walk environments
- Monitoring when a walk is cooling or losing quality
- Comparing upper-band and lower-band pressure across market phases
- Keeping Bollinger Band continuation analysis clean and visual
⚙️ Settings Overview
Engine settings control the Bollinger length, multiplier, source, basis slope lookback, and ATR normalization.
Band Walk Logic settings control the outer-lane depth, minimum walk persistence, minimum walk score, pullback memory, and failure warning threshold.
Visual settings control Bollinger Bands, walk highlight, pullback zones, event labels, label spacing, label count, label offset, label clearance, and label font size.
Pullback Zone settings control zone projection length, maximum visible zones, and opacity.
Panel settings control the information panel, location, theme, and font size.
🏁 Design Intent
Bollinger Walk Quality is designed to make Bollinger Band continuation more readable without turning the chart into a crowded signal dashboard.
The script focuses on structure, persistence, pullback quality, and failure behavior. It gives the chart a clear visual rhythm while keeping the panel concise and the labels controlled.
This makes the script useful as a premium public Bollinger continuation tool and keeps it clearly differentiated from Bollinger squeeze, compression, and volatility expansion maps. Indicator

Bollinger Walk Quality [AGPro Series]📌 Bollinger Walk Quality
Bollinger Walk Quality is built for one specific question: when price starts walking the outer Bollinger Band, is that walk strong enough to support continuation, or is the structure beginning to fail?
Many Bollinger Band tools focus on band touches, volatility contraction, width percentiles, or squeeze-style expansion setups. This script takes a different approach. It studies the behavior that comes after expansion: persistent upper-band or lower-band walking, directional pressure around the outer lane, pullback quality inside the band structure, and the point where the walk begins to lose control.
The goal is to make Bollinger Band continuation easier to read directly on the chart. Instead of treating every band touch as meaningful, the script scores whether price is staying in the correct outer lane, whether the Bollinger basis supports the active direction, whether pressure is persisting across multiple bars, and whether a pullback is holding in a healthy continuation pocket.
🧭 What The Script Measures
1. Walk Side
The panel identifies whether the active environment is an Upper Walk, Lower Walk, Cooling Walk, or Neutral state.
Upper Walk means price is persistently operating near the upper Bollinger lane while the basis supports upward continuation pressure.
Lower Walk means price is persistently operating near the lower Bollinger lane while the basis supports downward continuation pressure.
Cooling states appear when a recent walk is no longer fully active, but the script is still monitoring pullback quality and failure risk for a limited memory window.
2. Band Pressure
Band Pressure is a quality score for the active or developing walk. It combines outer-lane position, persistence, band contact behavior, basis slope support, and candle direction. A higher score means the walk has stronger structural pressure. A lower score means price is no longer showing durable outer-band control.
This keeps the script focused on continuation quality instead of simple band interaction. The chart can show a band touch, but the panel helps separate a weak touch from a real band-walk environment.
3. Pullback Quality
Healthy band walks often reset toward the middle of the Bollinger structure before continuing. Bollinger Walk Quality tracks that reset through a concept-native pullback pocket.
The pullback pocket is not a generic support or resistance rectangle. It is projected from the current Bollinger structure and represents the area where a band walk can cool off while still keeping its continuation profile intact.
The panel can show states such as Awaiting Pullback, Testing Pocket, Clean Hold, or Weak Reset. This helps distinguish a controlled continuation reset from a walk that is losing quality.
4. Failure Risk
Failure Risk is designed to catch the moment when an active or recently active band walk starts to break down. It rises when price loses the outer lane, pressure falls, the basis slope weakens, or price begins to threaten the Bollinger basis.
The failure label is intentionally restrained. It appears only on fresh failure events, so the chart remains clean and readable instead of filling with repeated warnings.
🎯 Core Features
- Outer-band walk detection for upper and lower Bollinger continuation phases
- Band pressure scoring based on lane position, persistence, slope support, and band contact behavior
- Pullback-to-band quality state for continuation resets
- Projected pullback pockets that show where a healthy walk can reset without losing structure
- Failure warning labels when the active walk loses pressure or threatens the basis
- Clean AG Pro panel with walk side, band pressure, pullback quality, and failure risk
- Adjustable panel location, theme, font sizes, label spacing, label clearance, zone projection, and visual density
📊 Visual Design
The default view is designed for a clean public PulseWire chart.
The script displays Bollinger Bands, highlights the active walk track, projects a limited number of pullback zones, and uses event labels with spacing controls. Labels are anchored outside the local candle envelope so they do not disappear inside candles or cover important price action.
The chart remains active enough to be visually informative, but the object count and label density are controlled by default. This keeps the indicator suitable for repeated use across different symbols and timeframes.
🧩 Panel
The AG Pro panel summarizes the current state in four compact rows:
- Walk Side
- Band Pressure
- Pullback Quality
- Failure Risk
Panel location, panel theme, panel font size, label font size, label spacing, label clearance, zone projection, zone opacity, and object limits are all adjustable from the settings menu.
🔎 How This Is Different
Bollinger Walk Quality is not a squeeze map and does not rely on compression logic. It does not use Keltner confirmation, volatility percentile ranking, or width contraction states.
Its lane is continuation after expansion:
- Is price walking the band?
- Which side controls the walk?
- Is the walk supported by pressure and basis slope?
- Is the pullback still healthy?
- Is the walk beginning to fail?
That makes it a separate Bollinger Band workflow from squeeze-focused tools. It is designed for traders who want to evaluate trend continuation rhythm, pullback behavior, and outer-band pressure in a more structured way.
✅ Best Use Cases
- Studying Bollinger Band walk continuation
- Reviewing trend pressure after expansion
- Identifying controlled pullbacks inside active band-walk environments
- Monitoring when a walk is cooling or losing quality
- Comparing upper-band and lower-band pressure across market phases
- Keeping Bollinger Band continuation analysis clean and visual
⚙️ Settings Overview
Engine settings control the Bollinger length, multiplier, source, basis slope lookback, and ATR normalization.
Band Walk Logic settings control the outer-lane depth, minimum walk persistence, minimum walk score, pullback memory, and failure warning threshold.
Visual settings control Bollinger Bands, walk highlight, pullback zones, event labels, label spacing, label count, label offset, label clearance, and label font size.
Pullback Zone settings control zone projection length, maximum visible zones, and opacity.
Panel settings control the information panel, location, theme, and font size.
🏁 Design Intent
Bollinger Walk Quality is designed to make Bollinger Band continuation more readable without turning the chart into a crowded signal dashboard.
The script focuses on structure, persistence, pullback quality, and failure behavior. It gives the chart a clear visual rhythm while keeping the panel concise and the labels controlled.
This makes the script useful as a premium public Bollinger continuation tool and keeps it clearly differentiated from Bollinger squeeze, compression, and volatility expansion maps.
Indicator

Wedge Reversal Detector [AGPro Series]Wedge Reversal Detector
🔷 Overview
Wedge Reversal Detector is a focused chart-pattern engine built for one specific structure: the rising wedge and falling wedge. Instead of scanning every possible reversal pattern, drawing broad support and resistance, or behaving like a generic breakout dashboard, this script studies the geometry of a wedge itself: confirmed pivot boundaries, slope convergence, pattern maturity, reversal break quality, projected reaction zone, and invalidation context.
The goal is to make wedge analysis cleaner and more objective on a live chart. A valid wedge is not treated as just two random trendlines. The script requires a confirmed pivot structure, a meaningful initial width, a narrowing final width, and the correct slope relationship for either a rising wedge or a falling wedge. Once a qualified structure is active, it draws the converging boundaries directly on the chart and waits for a reversal-side break.
The detector also includes two visual preparation layers. The developing-wedge preview layer can draw dashed boundaries before the structure is fully armed. The Wedge Radar layer keeps the latest compression window visible when no confirmed candidate is active. Radar projection is capped so higher-timeframe charts stay clean, and low-compression radar states can remain boundary-only until the structure becomes visually meaningful. Break labels, reaction zones, and invalidation guides remain reserved for stricter confirmed candidates. This keeps the chart visually informative without weakening the actual confirmation logic.
The visual layer includes compact boundary tags that label the upper and lower rails directly on the right side of the structure. These tags are designed as chart annotations, not signal spam: they identify whether the rail is acting as a rejection rail, compression rail, reclaim rail, break rail, or invalidation rail. A single optional compression tag can also summarize the current radar or wedge state.
🔶 Why This Is Different
Many wedge indicators stop at pattern drawing. Others become broad pattern scanners that mix wedges with channels, double tops, double bottoms, triangles, support and resistance zones, and unrelated reversal signals. Wedge Reversal Detector intentionally stays narrower.
Its edge is the sequence:
1. Detect a qualified rising or falling wedge from confirmed pivots.
2. Measure whether the boundaries are genuinely converging.
3. Grade wedge maturity before any break occurs.
4. Confirm the reversal-side break with an optional close-based rule and ATR buffer.
5. Score break quality using maturity, boundary expansion, candle structure, close location, and volume participation.
6. Project a concept-native reaction zone from the wedge width.
7. Display a clean invalidation guide so the structure remains readable after the break.
This makes the script a wedge lifecycle tool, not a general reversal scanner.
💎 Unique Edge
The most important difference is that the script treats a wedge as a living geometric compression structure. It does not simply connect the latest two highs and lows and call the pattern complete. A candidate must pass span, width, convergence, and slope requirements before it becomes active.
For rising wedges, the script looks for rising pivot highs and rising pivot lows where the lower boundary is climbing faster than the upper boundary. This creates upward compression, which is the core geometry behind a rising wedge. For falling wedges, it looks for falling pivot highs and falling pivot lows where the upper boundary is falling faster than the lower boundary. This creates downward compression, which is the core geometry behind a falling wedge.
That difference matters because many weak wedge tools confuse ordinary channels with wedge compression. This script separates those structures by requiring the final width to be materially smaller than the starting width.
🔹 Methodology
The engine begins with confirmed pivot highs and pivot lows. The user controls the pivot confirmation length, which allows the detector to be tuned for intraday, swing, or higher-timeframe charts.
From the latest confirmed swing pair, the script builds two boundary lines:
- Upper boundary from confirmed pivot highs
- Lower boundary from confirmed pivot lows
The detector then evaluates:
- Pattern span in bars
- Initial boundary width measured against ATR
- Final boundary width relative to the starting width
- Upper boundary slope
- Lower boundary slope
- Correct rising-wedge or falling-wedge geometry
Only when those requirements align does the pattern become an active wedge.
🔸 Break Quality Model
A wedge break is scored only after the reversal-side boundary is broken. The break quality score is built from multiple factors:
- Wedge maturity
- Distance beyond the broken boundary
- Candle body participation
- Close location inside the break candle
- Volume ratio versus recent average volume
The score is translated into a simple grade so the chart stays easy to read. This does not claim that a break must continue. It gives the user a structured read of how strong the confirmed break appears under the script's own rules.
🎯 Projected Reaction Zone
After a confirmed wedge reversal break, the script projects a reaction zone using the initial wedge width. This zone is not a generic support/resistance box. It is tied directly to the wedge geometry and appears only after the structure confirms. The goal is to show the next area where price may naturally react after escaping the compression.
The zone width and projection length are configurable, so users can keep the chart compact or allow more forward context depending on timeframe and style.
🧭 Invalidation Context
The script also draws an invalidation guide after a confirmed break. For a bullish falling-wedge break, invalidation is tracked below the opposite wedge boundary with an ATR buffer. For a bearish rising-wedge break, invalidation is tracked above the opposite wedge boundary with an ATR buffer.
This keeps the post-break structure organized without adding trade instructions or turning the script into a strategy.
📊 Panel
The compact AGPro panel summarizes the current wedge lifecycle:
- Wedge Type
- Maturity
- Break Quality
- Target Zone
Panel location, panel theme, and panel font size are adjustable from settings. The first panel row uses the AGPro standard: one merged blue header row containing only the panel title.
⚙️ Key Settings
- Pivot Confirmation Length controls how strict the swing structure is.
- Minimum Wedge Span filters out tiny patterns.
- Maximum Final Width Ratio controls how much convergence is required.
- Developing Wedge Preview Ratio controls how early dashed formation boundaries can appear.
- Wedge Radar controls the latest-window visual radar that prevents panel-only charts while waiting for confirmed wedge geometry.
- Radar Projection Bars limits how far radar boundaries extend into future bars.
- Radar Fill Threshold keeps low-compression radar structures from creating oversized filled areas.
- Boundary Tags add compact right-side rail annotations so the structure is easier to read without covering candles.
- Compression Tag shows one status label for radar compression or armed-wedge maturity.
- Boundary Break Buffer ATR adds confirmation distance beyond the wedge boundary.
- Volume Confirmation Ratio contributes to break quality scoring.
- Projection Length Bars controls how long the reaction zone extends forward.
- Label Font Size and Label Offset ATR help maintain a clean chart presentation.
🧩 How It Differs From Other AGPro Tools
This script is intentionally separate from AGPro channel, breakout, liquidity, and broad reversal tools.
It is not a channel map. Channel tools organize parallel or multi-family structure. Wedge Reversal Detector only studies converging wedge geometry.
It is not a double top or double bottom detector. Those patterns are based on repeated horizontal rejection and neckline behavior. This script is based on converging diagonal boundaries.
It is not a broad reversal scanner. It does not combine every reversal pattern into one dashboard. It stays focused on wedge compression, wedge maturity, reversal break, projected reaction zone, and invalidation.
It is not a generic breakout quality tool. Break quality is evaluated only after a valid rising or falling wedge exists.
🔔 Alerts
The script includes alerts for:
- Bullish falling wedge break
- Bearish rising wedge break
- High quality wedge break
- Wedge invalidation
These alerts are event notifications for the detected structure, not automated trading instructions.
✨ Best Use Case
Wedge Reversal Detector is best suited for traders who already watch chart patterns, market structure, compression, and failed trend continuation. It helps reduce manual drawing by highlighting qualified wedge structures, then keeping the chart organized through the confirmation, projection, and invalidation phases.
The result is a clean, premium, wedge-specific workflow designed for public chart reading: fewer random lines, fewer noisy labels, and a clearer view of whether the wedge structure is still forming, breaking, projecting, or invalidating.
Indicator

Triangle Breakout Quality [AGPro Series]Triangle Breakout Quality
🔺 OVERVIEW
Triangle Breakout Quality is built for one of the most searched and visually recognizable chart structures in technical analysis: the triangle breakout.
The script automatically detects triangle candidates from confirmed pivot highs and pivot lows, projects the upper and lower converging boundaries, measures how much the structure has compressed, locates the projected apex, and grades the quality of the eventual breakout. After the release, it monitors the first return toward the broken triangle boundary so the user can see whether price accepted the breakout or quickly lost structural quality.
The goal is not to mark every small consolidation or every trendline touch. The goal is to isolate the full triangle sequence:
Formation -> compression -> apex pressure -> boundary release -> first retest state.
That full lifecycle is what gives the tool its own identity. A triangle is not just a range, not just a single diagonal line, and not just a breakout candle. It is a narrowing structure where both sides of price are being compressed into a decision point. This script is designed around that idea from the ground up.
🔹 WHAT MAKES IT DIFFERENT
Most triangle tools stop at drawing two lines. Most breakout tools stop at the first candle outside a boundary. Triangle Breakout Quality does more by turning the structure into a scored, state-aware workflow.
Core differentiators:
• Dual-boundary validation
The script requires both an upper pivot boundary and a lower pivot boundary. The two lines must converge. This prevents the logic from acting like a generic trendline-break detector.
• Compression measurement
The engine compares the opening width of the triangle with the current width. A pattern must show meaningful narrowing before it can qualify.
• Apex pressure logic
The script projects where the upper and lower boundaries intersect and evaluates whether the current structure is close enough to that decision zone to matter.
• Breakout quality score
Every displayed breakout receives a 0-100 score based on compression, apex pressure, breakout distance, candle body participation, close quality, and optional volume expansion.
• Retest state
After a breakout, the script watches the first return toward the broken triangle boundary. A held retest and a failed retest are visually different states, not the same event.
• Premium visual restraint
The chart shows active triangle lines, controlled breakout labels, optional retest labels, subtle candle tint, and a compact AGPro panel. Label density is capped so the layout stays clean for live use and publication screenshots.
🧭 WHY THIS DOES NOT OVERLAP WITH OTHER AGPRO TOOLS
This script is intentionally separated from the existing AGPro breakout and structure family.
It is not Break-Retest Quality, because it does not begin with a horizontal pivot break and then grade the first retest of that static level. Triangle Breakout Quality first requires a valid converging triangle structure.
It is not Failed Break Quality, because it is not centered on false breaks and reclaim behavior. It tracks the primary breakout from a valid triangle and then monitors the first boundary retest.
It is not Consolidation Breakout Quality, because the reference structure is not a horizontal range. A triangle must have two projected pivot boundaries that move toward each other.
It is not Donchian Breakout Quality, because it is not based on period highs and lows or channel escape logic.
It is not ATR Envelope Breakout Quality, because it does not use a volatility envelope as the breakout shell.
It is not Auto Trendline Break Quality, because it does not score isolated trendline breaks. The event only matters when the upper and lower lines together form a valid triangle compression structure.
That distinction matters visually and analytically. On the chart, this script tells a triangle story: converging boundaries, apex pressure, breakout quality, and retest state. It belongs in the chart-pattern lane, not the generic breakout lane.
⚙️ METHODOLOGY
1. Pivot anchors
The script uses confirmed pivot highs and pivot lows to define the latest upper and lower triangle boundaries. This keeps the structure rules transparent and reproducible.
2. Convergence filter
The upper boundary and lower boundary must move toward each other. The current width of the pattern must be smaller than the starting width, and the compression percentage must meet the selected threshold.
3. Width and maturity filters
The pattern must be old enough to represent a real structure, but not so old that it becomes stale. The starting width and current width are also normalized by ATR so the same logic can adapt across symbols and timeframes.
4. Apex projection
The script calculates where the two projected boundaries intersect. This creates the apex pressure layer, which helps separate mature triangle compression from loose diagonal movement.
5. Breakout confirmation
A bullish breakout requires price to close beyond the projected upper boundary by an ATR-normalized buffer. A bearish breakout requires price to close beyond the projected lower boundary by the same type of buffer.
6. Quality score
The breakout score combines:
• Compression quality
• Apex pressure
• Breakout distance beyond the boundary
• Candle body participation
• Close position inside the breakout candle
• Optional volume participation
The result is displayed as a compact grade and score so the chart remains readable.
7. Retest state
After a breakout, the script projects the broken triangle boundary forward internally and evaluates an ATR-scaled retest tolerance around it. If price revisits that boundary area and holds the correct side, the retest is marked as held. If price loses the boundary, the retest state is marked as failed.
📊 PANEL
The AGPro panel summarizes the current structure and latest event:
• Pattern Age
• Compression
• Apex Pressure
• Breakout Side
• Retest Quality
• Current State
Panel location, theme, and font size are adjustable. The first row follows the AGPro publication standard: one merged blue header row containing only the panel title.
🎛️ KEY INPUTS
Triangle Structure
• Pivot Length
• Minimum Pattern Age
• Maximum Pattern Age
• Minimum Compression %
• Minimum Starting Width ATR
• Maximum Current Width ATR
• Maximum Forward Apex Bars
Breakout Quality
• ATR Length
• Volume Average Length
• Use Volume Participation
• Volume Full-Score Ratio
• Minimum Break Distance ATR
• High Quality Threshold
• Minimum Label Score
• Visual Cooldown Bars
Retest State
• Retest Minimum Bars
• Retest Window Bars
• Retest Tolerance ATR
Visual Controls
• Show Triangle Lines
• Show Breakout Labels
• Show Retest Labels
• Tint Breakout Candles
• Label Offset ATR
• Label Font Size
• Maximum Visible Events
Panel
• Show Panel
• Panel Position
• Panel Theme
• Panel Font Size
🔍 HOW TO READ IT
When a valid triangle is forming, the chart displays the converging upper and lower boundaries. The panel reports apex pressure and compression so the projected decision area is visible without adding extra rectangles to the chart. Compression shows how much the pattern has tightened relative to its opening width.
When price closes beyond a valid boundary, the script prints a compact breakout label with a quality grade and score. A higher score means the breakout candle carried stronger structural qualities according to the script's rules.
After the breakout, retest labels and the panel show whether the first return toward the broken triangle boundary held or failed. A held retest suggests cleaner acceptance of the breakout boundary. A failed retest suggests the release lost quality.
Use the tool as a structured chart-reading layer. It is designed to help users compare triangle breakouts by quality, not to replace broader context such as trend, liquidity, session behavior, or personal execution rules.
🧩 BEST USE CASES
• Symmetrical triangle compression
• Ascending triangle pressure
• Descending triangle pressure
• Breakout candle quality review
• First retest monitoring after triangle release
• Screenshot-friendly pattern study
• Multi-symbol scanning for cleaner chart-pattern candidates
🔹 LIMITATIONS AND TRANSPARENCY
Triangle detection is based on confirmed pivots, so the final anchor points appear only after the selected pivot length has elapsed. This is standard pivot behavior and keeps the structure rules visible.
The live triangle can change while new pivots form. Breakout and retest labels are event-based and are designed to remain stable after confirmation.
Volume participation is optional because volume quality varies across markets and feeds. On instruments where volume is less informative, the volume component can be disabled.
The score is a structured description of the triangle release according to the script's internal model. It should be read as context, not as an execution command.
Indicator
