Expansion Target Planner [AGPro Series]Expansion Target Planner
🧠 Core Idea
After expansion is confirmed, where is the reasonable target band, how clean is the path, and what should be reviewed next?
📌 Overview / What it does
Expansion Target Planner is a chart-first risk-target planning tool designed to evaluate the target area after a confirmed range expansion.
Instead of drawing a generic target line or copying a measured-move pattern, the script studies the prior range edge, current ATR, continuation pressure, recent structure obstacles, volatility state, and an invalidation shelf behind the move. It then converts that context into a 0-100 Target Quality score and a clear next-action state.
The output is a practical planning workflow: an expansion target band, invalidation shelf, target midpoint guide, path obstruction marker, compact chart labels, alert conditions, and a clean AGPro decision panel. It does not predict the future, automate decisions, or guarantee that any target band will be reached.
🎯 Purpose & Design Philosophy
This script was built for traders who need a cleaner way to evaluate expansion targets after price has already shown confirmation.
Many tools focus on finding a breakout, drawing an equal measured move, or plotting fixed take-profit levels. This tool fills a different gap: it asks whether the next target area is reasonable, whether the path is blocked, and whether the invalidation reference still supports the plan.
The design supports a disciplined target-review mindset. It helps users separate a clean expansion path from a stretched, obstructed, expired, or invalidated plan.
⚡ Why This Script Is Different
Most tools focus on measured moves, ABCD projections, fixed target ladders, or generic breakout confirmation.
This script does NOT become a measured-move projection tool, ABCD pattern detector, take-profit ladder, auto trading system, or generic support/resistance map.
Instead, it builds one active expansion target plan after confirmation and evaluates the quality of that plan. The core output is not a trade command. It is a planning state that helps users review whether the target band, invalidation shelf, volatility, and structure path still make sense.
⚙️ Methodology
1. Context Detection
The script identifies whether price has confirmed expansion beyond a prior range edge. Users can keep the side on Auto or force Long Expansion / Short Expansion.
2. Reference Mapping
Once confirmation appears, the script locks an active target plan. It maps the expansion anchor, ATR-adjusted target distance, target band, invalidation shelf, and recent pivot-based path obstacle.
3. Reaction Evaluation
The script scores the plan using expansion strength, ATR projection fit, nearby structure, continuation pressure, volume support, trend support, and volatility state.
4. Visual Output
The chart displays the active target band, invalidation shelf, guide lines, obstruction marker, event labels, alerts, and AGPro panel state.
🗺️ How to Read the Chart
Zones = the forward target band and the invalidation shelf behind the expansion.
Labels = the current target planning state, such as TARGET READY, WATCH, OBSTRUCTED, TARGET HIT, or INVALID REVIEW.
Colors = green/teal supports cleaner bullish expansion quality, pink marks bearish or risk states, yellow marks caution or obstruction, and indigo is used as a neutral planning accent.
Panel = the compact decision view showing Expansion Side, Target Band, Invalidation, Target Quality, and Action.
🚦 Signals & States
• TARGET READY → the target band has acceptable quality and the path is clean enough for review.
• WATCH → target context is improving, but not enough conditions are aligned yet.
• OBSTRUCTED → a recent structure obstacle sits between current price and the target band.
• TARGET HIT → price has interacted with the active target band.
• INVALID REVIEW → price has crossed the invalidation shelf and the plan should be reviewed.
• EXPIRED → the active plan has spent too many bars without completing.
🔔 Alerts Logic
Alerts trigger when the active target state changes into an important review condition.
• Target Ready alert → target quality moves into a stronger review state.
• Target Watch alert → target context improves but remains incomplete.
• Path Obstructed alert → a structure obstacle blocks the target path.
• Target Band Touched alert → price reaches the active target band.
• Invalidation Review alert → price crosses the invalidation shelf.
Alerts are attention markers, not trade instructions.
🧩 Confluence Logic
The Target Quality score improves when expansion confirmation, ATR projection fit, continuation pressure, volume support, volatility state, and open structure path align.
When the target distance is reasonable, the close is efficient, volume supports the move, and no nearby obstacle blocks the path, the context becomes stronger.
📊 When to Use
• After confirmed range expansion
• During breakout continuation review
• When evaluating whether a target area is too close, too far, or structurally blocked
• When a trader wants target context without a fixed take-profit ladder
• During volatility expansion phases where target planning matters more than another signal
⚠️ When NOT to Use
• Very low-liquidity markets
• Extremely noisy sideways chop
• News-driven spikes where ATR and structure become unstable
• Markets with unreliable volume if volume support is central to your process
• Any situation where the user expects automatic trade instructions
🎛️ Key Inputs
• Expansion Side → Auto, Long Expansion, or Short Expansion planning.
• Prior Range Lookback → defines the range edge used for confirmation.
• Confirmation Break ATR → controls how far beyond the range edge price must close.
• Range Projection Multiple → adjusts how much prior range width contributes to the target distance.
• ATR Projection Multiple → adjusts how much current volatility contributes to the target distance.
• Target Band Width ATR → controls the visual width of the target band.
• Invalidation Shelf Lookback → defines the reference shelf behind the expansion.
• TARGET READY / WATCH thresholds → control how selective the state engine is.
• Visual settings → control target band, shelf, guide lines, obstruction marker, labels, panel location, theme, and font sizes.
🖥️ Interface & Visual Design
The interface is built around one active target plan.
The target band is displayed forward on the chart with centered text. The invalidation shelf is shown behind the move so the risk reference is visible without turning the script into a generic support/resistance tool.
The panel follows the AGPro public-release standard with one merged blue header row containing only the script name. The layout is compact and designed for quick reading during live chart review.
🧪 Practical Usage Workflow
1. Read the panel to identify the active Expansion Side and Target Quality.
2. Check whether the target band is clean or obstructed.
3. Review the invalidation shelf behind the expansion.
4. Use labels and alerts as attention markers.
5. Confirm the broader market context with your own process.
🔍 Interpretation Guidelines
Treat the target band as a planning area, not a guaranteed destination.
A higher Target Quality score means the target plan is cleaner according to the script rules. It does not mean the move must continue.
An OBSTRUCTED state does not mean price cannot move through the obstacle. It means the path contains structure that deserves review.
An INVALID REVIEW state means the active shelf has been crossed and the plan context has changed.
🚫 What This Script Is NOT
• Not a prediction engine
• Not financial advice
• Not auto trading
• Not guaranteed signals
• Not a measured-move projection system
• Not an ABCD pattern scanner
• Not a take-profit ladder
⚠️ Limitations & Transparency
• Timeframe differences can change expansion quality and target distance.
• Volatility shifts can make a previously clean target band less useful.
• Recent structure may not capture every important higher-timeframe obstacle.
• Volume-based scoring can be less useful on symbols with unreliable volume.
• No rule-based tool can fully account for news, liquidity shocks, or sudden regime changes.
🧠 Market Context Notes
Expansion targets are more useful when the market has already shown range release and the target path is not immediately blocked by nearby structure.
Liquidity, volatility, and structure should be read together. A target band can look reasonable by distance but still become lower quality if the path is obstructed or volatility becomes overheated.
🧾 Use Case Examples
When price closes beyond a prior range edge with strong close location and the target path is open, the script may show TARGET READY.
When price expands but a recent pivot sits directly between current price and the target band, the script may show OBSTRUCTED.
When price crosses the invalidation shelf behind the plan, the script may show INVALID REVIEW.
🧱 System Philosophy
AGPro Series tools are designed to support structured decision review, not emotional signal chasing.
This script follows that philosophy by focusing on target quality, invalidation context, and next-action state rather than a simple directional signal.
🔐 Non-Promise Statement
No target band is certain.
No score guarantees continuation.
No alert should be treated as a trade instruction.
📉 Risk Disclosure
Trading involves risk.
Users are responsible for their own decisions, position sizing, risk controls, and market interpretation.
This script is for educational and analytical use only and does not provide financial advice.
📚 Educational Note
Use this tool to study how target quality changes after expansion confirmation.
The strongest value comes from comparing the target band, obstruction marker, invalidation shelf, and broader market context together.
Indicator

Impulse Follow-Through Quality [AGPro Series]Impulse Follow-Through Quality
🧠 Core Idea
Did the impulse receive enough follow-through to remain valid?
📌 Overview / What it does
Impulse Follow-Through Quality is a chart-first momentum expansion planner built to evaluate what happens after a strong impulse candle appears.
Instead of treating every strong candle as a standalone signal, the script starts a follow-through review window and measures whether price extends, pauses constructively, pulls back too deeply, reaches a target-room guide, or crosses a failure rail. These elements are converted into a 0-100 Impulse Quality score and a clear next-action state.
The script produces an impulse highlight, follow-through box, failure rail, measured target guide, compact labels, alerts, and a clean AGPro planning panel. It does not predict continuation, automate trades, or guarantee that momentum will continue.
🎯 Purpose & Design Philosophy
This script was built for traders who want to separate a meaningful impulse from a candle that only looks strong for one bar.
Many momentum tools focus on the impulse itself. The practical question often comes after that candle: does the move attract follow-through, or does it begin to fail? This planner fills that gap by turning the post-impulse phase into a readable decision process.
The design supports a patient review mindset: identify the impulse, watch the follow-through window, evaluate pullback depth, check target room, and review the failure rail before reacting.
⚡ Why This Script Is Different
Most tools focus on strong candles, volume spikes, momentum bursts, or basic continuation labels.
This script does NOT act as a Volume Climax Detector, does NOT rebuild an Institutional Candle Detector, and does NOT reduce the chart to a simple buy/sell momentum signal.
Instead, it evaluates what happens after the impulse. The key output is not the candle itself. The key output is the follow-through quality state: IMPULSE, WAIT FT, FT WATCH, VALID FT, PULLBACK RISK, WEAK FT, FAILED, or TARGET REVIEW.
⚙️ Methodology
1. Context Detection
The script detects qualified bullish or bearish impulse candles using ATR-normalized range, body efficiency, close location, trend context, and participation.
2. Reference Mapping
Once an impulse qualifies, the script maps the impulse origin, follow-through box, failure rail, and target-room guide.
3. Reaction Evaluation
The model evaluates follow-through progress, closes beyond the impulse close, retracement depth, participation support, target room, and whether price crosses the failure rail.
4. Visual Output
The result is displayed through an impulse highlight, centered follow-through box label, failure rail, target guide, compact labels, deterministic alerts, and a premium AGPro panel.
🗺️ How to Read the Chart
Impulse Highlight = the latest qualified impulse leg that starts the review window.
Follow-Through Box = the active planning area between the impulse close and the measured target-room guide. Its label is centered inside the box.
Failure Rail = the practical invalidation reference behind the impulse. It is an analytical line, not a stop order.
Target Guide = a measured target-room reference based on the impulse range.
Labels = compact state markers for impulse start, constructive follow-through, weak follow-through, pullback risk, failure rail review, and target review.
Colors = teal supports constructive long-side follow-through, pink supports short-side or failure context, amber marks review risk, and indigo marks watch states.
Panel = summarizes Impulse Quality, Follow-Through, Pullback Risk, Target Room, and Action.
🚦 Signals & States
• IMPULSE → a qualified impulse candle has started a review window.
• WAIT FT → the impulse exists, but follow-through is not confirmed yet.
• FT WATCH → follow-through conditions are improving but not strong enough for the highest state.
• VALID FT → follow-through quality is constructive according to the rule set.
• PULLBACK RISK → retracement depth is elevated inside the impulse range.
• WEAK FT → the follow-through window is aging without enough progress.
• FAILED → price crossed the failure rail behind the impulse.
• TARGET REVIEW → price reached the measured target-room guide and context should be reviewed.
🔔 Alerts Logic
Alerts can trigger when a new impulse starts, follow-through becomes constructive, follow-through enters watch state, the move weakens, pullback risk rises, price crosses the failure rail, or price reaches the target-room guide.
Each alert is an attention marker. Alerts are not trade instructions, entry commands, exit commands, or automated strategy rules.
🧩 Confluence Logic
The strongest context appears when a clean impulse candle is followed by measurable progress, multiple closes beyond the impulse close, controlled retracement depth, supportive participation, and readable target room.
When these components weaken, the planner can shift toward WAIT FT, FT WATCH, PULLBACK RISK, WEAK FT, or FAILED.
📊 When to Use
• After strong momentum candles where continuation quality matters.
• During trend continuation attempts that need follow-through review.
• After breakout or expansion bars where a one-bar move may be misleading.
• On liquid symbols where ATR, candle structure, and volume behavior are readable.
• When you want a post-impulse planning map instead of another raw momentum signal.
⚠️ When NOT to Use
• Very low-liquidity symbols with unstable candles or unreliable volume.
• Extremely noisy micro-timeframes where impulse candles appear too frequently.
• News-driven spikes where one-bar expansion can distort the model.
• Markets with large gaps that make ATR and failure-rail references less useful.
• Situations where the user expects guaranteed continuation or automated trade signals.
🎛️ Key Inputs
• Follow-Through Side → controls Auto, Long Follow-Through, or Short Follow-Through mode.
• Minimum Impulse ATR → changes how large a candle must be before review begins.
• Minimum Body Efficiency → controls how clean the impulse body must be.
• Minimum Edge Close → controls how near the candle must close to its directional edge.
• Follow-Through Window → controls how many bars are used to judge early continuation.
• Required Progress ATR → defines preferred movement after the impulse close.
• Maximum Pullback Ratio → controls when retracement depth becomes elevated risk.
• Failure Rail Buffer ATR → adjusts the analytical failure rail behind the impulse.
• Visual settings → control the impulse highlight, follow-through box, failure rail, target guide, labels, panel visibility, panel location, theme, and font sizes.
🖥️ Interface & Visual Design
The interface is designed to stay chart-first.
The impulse highlight gives the origin. The follow-through box gives the active planning area. The failure rail and target guide define the practical review frame.
The AGPro panel provides a compact decision summary with a merged blue title row, adjustable panel location, adjustable theme, and adjustable font size.
🧪 Practical Usage Workflow
1. Read the panel Impulse Quality score and Action.
2. Check the impulse highlight and the direction of the follow-through box.
3. Review whether price is extending beyond the impulse close.
4. Compare pullback depth with the failure rail.
5. Use the target guide as a context-review reference, not as a guarantee.
6. Treat alerts as attention markers inside broader analysis.
🔍 Interpretation Guidelines
Think in terms of follow-through quality, not prediction.
A higher score means the impulse has more constructive continuation characteristics according to the script's rule set. A weaker score means the move may be aging, retracing too deeply, lacking progress, or crossing its failure reference.
VALID FT does not mean price must continue. FAILED does not mean the market cannot recover later. The states organize the review process.
🚫 What This Script Is NOT
• Not a prediction engine.
• Not financial advice.
• Not an auto-trading system.
• Not a guaranteed signal tool.
• Not a buy/sell signal service.
• Not a Volume Climax Detector.
• Not an Institutional Candle Detector.
• Not a generic momentum oscillator.
⚠️ Limitations & Transparency
The script is rule-based and depends on recent price action, ATR, candle structure, selected inputs, and volume behavior.
Different timeframes can produce different impulse and follow-through readings. Volatility spikes can temporarily distort the score. Symbols with unreliable volume may produce weaker participation readings.
Outputs should always be interpreted with broader market structure, liquidity, and trader-defined risk controls.
🧠 Market Context Notes
Impulse candles are only useful when the market confirms or rejects them through follow-through.
A clean impulse that receives controlled extension may deserve more attention than a larger candle that immediately retraces. A smaller impulse can also become meaningful when the follow-through window stays organized.
🧾 Use Case Examples
When price prints a strong bullish impulse, closes near the high, then follows through with multiple closes above the impulse close while pullback depth remains controlled, the planner may classify the move as VALID FT.
When an impulse appears but price fails to extend, retraces deeply, or crosses the failure rail, the planner may shift toward WEAK FT, PULLBACK RISK, or FAILED.
🧱 System Philosophy
AGPro planning tools are designed to help traders evaluate context before reacting.
This script follows that philosophy by turning impulse follow-through into a structured planning question: did the move receive enough confirmation, progress, and risk clarity to remain worth reviewing?
🔐 Non-Promise Statement
No indicator can guarantee continuation, reversal, breakout success, or outcome.
This tool provides structured visual context and rule-based attention markers. It does not provide certainty.
📉 Risk Disclosure
Trading involves risk.
Market conditions can change quickly, and no script can remove uncertainty.
Users are responsible for their own analysis, risk management, position sizing, and trading decisions.
This script is for educational and analytical use only and does not provide financial advice.
📚 Educational Note
Use the planner to study how strong candles behave after they appear, how follow-through quality changes across timeframes, and how pullback depth affects the readability of momentum continuation.
Indicator

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

Breakout Retest Readiness [AGPro Series]Breakout Retest Readiness
🧠 Core Idea
Is the post-breakout retest being accepted with structure, or is the breakout losing quality at the risk edge?
📌 Overview / What it does
Breakout Retest Readiness is a chart-first planning tool built to evaluate what happens after a confirmed breakout and after price starts interacting with the retest pocket.
The script maps the broken structure level, builds a retest pocket around it, places a risk-edge shelf beyond the pocket, and projects a target-room guide for context. It then scores the active retest environment with a 0-100 Acceptance Score and displays a clear next-action state in the AG Pro panel.
This script does not predict continuation. It does not automate entries. It is designed to organize post-breakout retest context so traders can review acceptance, rejection, risk edge, and plan quality in a cleaner way.
🎯 Purpose & Design Philosophy
Most breakout tools focus on the moment price crosses a level. In practice, many useful decisions happen after the break, when price returns toward the broken level and either accepts it or fails around it.
This script was built for traders who want a structured retest planning layer rather than another basic breakout marker. It supports a patient workflow: wait for structure, observe the pocket, evaluate acceptance, and review risk before reacting.
The design philosophy is simple: the chart should answer what state the retest is in, how strong the acceptance context is, where risk is being tested, and what the next review step should be.
⚡ Why This Script Is Different
Most tools focus on detecting a breakout or grading the first retest as a standalone signal.
This script does NOT try to clone a classic break-retest quality grader, and it does not print simple buy or sell commands.
Instead, it works as a post-breakout readiness planner. It arms a retest pocket after a confirmed breakout, waits for price to interact with that pocket, evaluates acceptance versus rejection, tracks the risk edge, and keeps the next-action state visible in the panel.
The difference is the decision layer. The script is less about saying "a retest happened" and more about answering whether the active retest environment is constructive enough to keep reviewing.
⚙️ Methodology
1. Context Detection
The script identifies a confirmed break beyond recent structure using a prior high or prior low reference. The breakout must clear the structure by an ATR-normalized buffer so minor pokes are filtered.
2. Reference Mapping
After a valid break, the script stores the breakout line, builds a retest pocket around it, places an invalidation shelf beyond the broken level, and projects a target-room guide from the prior structure range.
3. Reaction Evaluation
When price interacts with the retest pocket, the script evaluates breakout quality, retest depth, wick rejection, volume change, and trend agreement. These components combine into a 0-100 Acceptance Score.
4. Visual Output
The chart shows the active retest pocket, breakout line, risk edge, target guide, compact event labels, and the AG Pro panel. The panel summarizes retest state, acceptance score, breakout quality, risk edge, and action.
🗺️ How to Read the Chart
Retest Pocket = the zone around the broken structure level where price is being evaluated after the breakout.
Breakout Line = the structure level that was crossed and now anchors the retest plan.
Risk Edge = the invalidation shelf beyond the retest pocket. It is a planning reference, not a stop recommendation.
Target Guide = a target-room marker projected from the prior range. It is context only, not a forecast.
Labels = compact state markers such as ARMED, TEST, ACCEPT, REJECT, RISK EDGE, or EXPIRE.
Colors = bullish retest plans use the AGPro teal tone, bearish plans use the AGPro pink tone, watch states use indigo or amber, and risk conditions use red.
Panel = the main decision interface showing retest state, acceptance score, breakout quality, risk edge, and next action.
🚦 Signals & States
• Breakout Armed → a breakout retest plan has been created after price cleared structure.
• Testing Pocket → price is interacting with the active retest pocket and acceptance is being evaluated.
• Accepted Retest → the retest has held the pocket with enough acceptance quality to deserve review.
• Rejected Retest → the retest has failed around the pocket and quality has weakened.
• Risk Edge Hit → price has moved beyond the mapped risk shelf.
• Expired → the retest window aged out before a constructive interaction.
🔔 Alerts Logic
Alerts are available for breakout plan arming, retest pocket interaction, accepted retest readiness, rejected retest or risk-edge pressure, and expired retest plans.
Each alert is an attention marker. Alerts do not represent trade instructions, guaranteed outcomes, or automated strategy decisions.
🧩 Confluence Logic
The strongest acceptance context appears when the breakout quality, retest depth, wick rejection, volume behavior, and trend agreement support the same side.
When these components align, the retest score improves. When the pocket is too deep, volume behavior is poor, trend context disagrees, or the risk edge is pressured, the readiness state weakens.
📊 When to Use
• After clean breakouts from recent structure
• During trend continuation review
• When price returns toward a broken level
• When the trader wants to separate constructive retests from weak post-break reactions
• On liquid symbols where structure, volume, and candle behavior are readable
⚠️ When NOT to Use
• Extremely low-liquidity instruments
• Highly noisy lower timeframes
• News-driven volatility spikes
• Markets with no clear structure reference
• Situations where the breakout level is too close to major external obstruction
🎛️ Key Inputs
• Breakout Structure Lookback → controls the prior structure reference used for breakout detection.
• Maximum Bars To Retest → controls how long the script waits for the retest pocket to matter.
• Sensitivity → adjusts how strict the breakout and acceptance model should be.
• Minimum Acceptance Score → defines the score needed before accepted readiness can appear.
• Retest Pocket Width ATR → controls the width of the post-breakout pocket.
• Invalidation Shelf ATR → controls the mapped risk-edge distance beyond the broken level.
• Target Guide Range Multiple → controls the forward target-room guide.
• Visual Settings → control pockets, lines, labels, label density, label size, and forward rendering.
• Panel Settings → control panel visibility, location, theme, and font size.
🖥️ Interface & Visual Design
The interface is built around a clean AG Pro panel and one main chart object family: the retest pocket.
The pocket label is centered inside the zone so the active state is visible without needing extra clutter. The breakout line, invalidation shelf, and target guide create a simple visual hierarchy: level, risk, and room.
Labels are intentionally compact and controlled by cooldown and maximum-visible settings so the chart remains active without becoming crowded.
🧪 Practical Usage Workflow
1. Read the panel state.
2. Locate the active retest pocket.
3. Check whether price is testing, accepting, rejecting, or pressing the risk edge.
4. Compare the Acceptance Score with the breakout quality.
5. Use the action row as a review prompt, not as an instruction.
🔍 Interpretation Guidelines
The Acceptance Score should be read as context quality, not certainty.
A higher score means the current retest has cleaner structural behavior under the script's rules. A lower score means the retest is less constructive, too deep, poorly supported, or not aligned with trend context.
The Risk Edge matters because a retest can look acceptable for a few bars and still lose structure if price pushes beyond the invalidation shelf. The panel keeps that condition visible.
🚫 What This Script Is NOT
This script is not a prediction engine.
This script is not financial advice.
This script is not an auto-trading system.
This script does not provide guaranteed signals.
This script is not a generic support and resistance map.
This script is not a clone of a first-retest grading tool.
⚠️ Limitations & Transparency
The script is rule-based and depends on the selected lookback, timeframe, and market structure.
Different symbols can produce different retest behavior. Lower timeframes may show more noise. Higher timeframes may produce fewer but stronger events.
Volatility changes can affect pocket size, risk-edge distance, and event frequency. Users should interpret every output within broader market context.
🧠 Market Context Notes
Breakout retests are most useful when structure is clear, liquidity is sufficient, and price has enough room to continue without immediate obstruction.
Volume behavior can add context, but volume data quality varies across markets. When volume is unreliable, the script treats that component more neutrally.
The retest pocket is not a guaranteed support or resistance zone. It is a structured review area around the broken level.
🧾 Use Case Examples
When price breaks above recent structure and later returns to the pocket with a controlled pullback, the script can mark the retest as Testing Pocket or Accepted Retest depending on score quality.
When price breaks below structure but quickly pushes back above the pocket and pressures the mapped risk edge, the script can mark rejection or risk-edge pressure.
When a breakout never returns to the pocket within the selected time window, the script can expire the plan instead of keeping old context alive.
🧱 System Philosophy
AGPro tools are designed to support structured chart reading. The goal is not to add more random signals, but to turn market behavior into clearer states, cleaner context, and better review discipline.
Breakout Retest Readiness follows that philosophy by turning a common post-breakout question into a visible planning workflow.
🔐 Non-Promise Statement
No script can confirm future price direction with certainty.
This tool organizes retest context. It does not promise continuation, reversal, profit, or accuracy.
📉 Risk Disclosure
Trading involves risk.
All outputs from this script are educational and analytical in nature.
Users are responsible for their own decisions, risk management, position sizing, and market interpretation.
This script does not provide financial advice.
📚 Educational Note
Use the script to study how breakouts behave after price returns to the broken level. The most useful insight is often not the breakout itself, but how the market reacts when the level is tested again.
Indicator

False Break Trap Planner [AGPro Series]False Break Trap Planner
🧠 Core Idea
Is a breakout still holding, or is it turning into a false-break trap that deserves caution?
📌 Overview / What it does
False Break Trap Planner is a chart-first breakout failure planner built to evaluate range-edge break attempts after price moves beyond a recent high or low boundary.
Instead of only marking that a breakout happened, the script studies whether the move is holding beyond the edge, being reclaimed back into the range, or becoming a confirmed trap-risk context. It produces a 0-100 Trap Risk score, a reclaim state, a break-quality reading, a failure-room estimate, false-break zones, reclaim rails, and target-back guides.
This script does not predict price direction, automate execution, or claim that a failed break must reverse. It organizes the anatomy of a potential false break so traders can review the setup with cleaner context.
🎯 Purpose & Design Philosophy
This script was built for traders who need a practical decision layer around breakout failure, not another generic signal marker.
The gap it fills is the space between a clean breakout tool and a liquidity sweep tool. Many chart tools mark a level break, a wick, or a reclaim. This planner asks what the trader should review next: is the break holding, is reclaim pressure developing, is the failure fast enough to matter, and is there room back inside the range?
The design mindset is structured caution. The script helps users slow down around breakout traps, separate active risk from confirmed failure, and keep risk / target / invalidation context visible.
⚡ Why This Script Is Different
Most tools focus on breakout confirmation, sweep labels, or generic failed-break signals.
This script does NOT try to become a stop-hunt map, liquidity sweep engine, support/resistance zone scanner, or broad breakout system.
Instead, it focuses on one specific workflow: a prior range edge is broken, the break either holds or gets reclaimed, and the planner scores whether that behavior deserves trap-risk review.
⚙️ Methodology
1. Context Detection
The script maps a recent range high and range low from previous bars, then watches for an ATR-normalized break beyond either edge.
2. Reference Mapping
When a break attempt appears, the planner freezes the range edge, opposite edge, midpoint, and false-break extreme so the event can be evaluated consistently.
3. Reaction Evaluation
The model scores breakout failure speed, reclaim strength, wick size, volume spike, and whether price closes back inside the range.
4. Visual Output
The script displays a false-break box, reclaim or fail rail, target-back line, trap confirmation labels, reclaim-watch labels, and a premium AG Pro panel.
🗺️ How to Read the Chart
Zones = the active false-break box between the broken range edge and the failed extension.
Labels = compact state markers such as Upper Break Watch, Lower Break Watch, Reclaim Watch, Upper Trap, Lower Trap, or Break Accepted.
Colors = teal for lower-break trap recovery context, pink for upper-break trap risk, yellow for watch states, indigo for accepted/holding context, and red for confirmed trap-risk pressure.
Panel = a compact decision panel showing Trap Risk, Reclaim State, Break Quality, Failure Room, and Action.
🚦 Signals & States
• Upper Break Watch → price has moved beyond the upper range edge and the break is under review.
• Lower Break Watch → price has moved beyond the lower range edge and the break is under review.
• Reclaim Watch → price is testing back toward or inside the broken edge, but confirmation is not complete.
• Trap Confirmed → the break has closed back inside the range with enough trap-risk score.
• Break Holding → the break is still outside the range and has not reclaimed.
• Break Accepted → the break has held beyond the acceptance window and should not be treated as an active trap by default.
🔔 Alerts Logic
Alerts trigger when the planner detects confirmed upper or lower trap context, upper or lower reclaim-watch context, or break acceptance.
Each alert is an attention marker. It highlights a state transition that may deserve review. It is not a trade instruction and should not be treated as an automated entry or exit signal.
🧩 Confluence Logic
The strongest trap-risk context appears when several factors align:
• Fast failure after the break
• Close back inside the prior range
• Strong wick rejection
• Volume spike during the failed extension
• Clean room back toward the range midpoint
When these align, the panel score rises and the state becomes easier to interpret.
📊 When to Use
• Breakout and breakdown attempts around a recent range
• Markets where false breaks and failed continuations are common
• Intraday or swing charts where range edges are visually relevant
• Review workflows that need caution before chasing a break
• Breakout traders who want a structured invalidation and failure-room layer
⚠️ When NOT to Use
• Extremely low-liquidity instruments
• Very noisy micro timeframes with unreliable candles
• Markets with poor or synthetic volume data
• News-driven volatility where single-bar extremes distort ATR and volume
• Charts where the selected lookback does not represent a meaningful range
🎛️ Key Inputs
• Range Edge Lookback → controls the prior range used for break attempts.
• Minimum Break ATR → defines how far price must move beyond the edge before the planner starts tracking.
• Fast Reclaim Window → controls how many bars can pass before a reclaim becomes less meaningful.
• Trap Confirmed Score → minimum 0-100 score required for a confirmed trap label.
• Break Acceptance Bars → defines when a break should be treated as holding rather than still failing.
• Visual settings → control boxes, rails, target-back lines, label density, panel location, theme, and font sizes.
🖥️ Interface & Visual Design
The panel is designed as a clean AG Pro planning cockpit. The first row uses the standard merged blue AGPro header row, followed by five decision rows.
The chart visuals are intentionally focused: one active false-break box, a reclaim rail, a soft fail rail, a target-back line, and controlled labels. The goal is premium readability without turning the chart into a generic level map.
🧪 Practical Usage Workflow
1. Read the panel and check the current Reclaim State.
2. Review the false-break box and identify which edge was broken.
3. Check whether price is holding beyond the edge or closing back inside.
4. Compare Trap Risk with Break Quality.
5. Use the target-back line and failure-room reading as context, not as a forecast.
🔍 Interpretation Guidelines
Think in states, not predictions.
A high Trap Risk score means the attempted break has characteristics often associated with failed continuation. It does not mean the next move is guaranteed.
A strong Break Quality score means the break is still showing participation and close-through behavior. In that context, early fading can be premature.
The cleanest reading appears when Trap Risk is high, Break Quality is weak, and price has closed back inside the range.
🚫 What This Script Is NOT
• Not a prediction engine
• Not financial advice
• Not auto trading
• Not guaranteed signals
• Not a stop-hunt map
• Not a liquidity sweep scanner
• Not a support/resistance zone system
• Not a replacement for risk planning
⚠️ Limitations & Transparency
The active range depends on the selected lookback. A different lookback can produce different edges.
ATR and volume conditions can change quickly during high-volatility periods, which may affect scoring.
Breakout behavior differs across symbols, sessions, and timeframes. A trap-like structure on one market may not behave the same way on another.
The script is rule-based and does not know external news, order flow, or hidden liquidity.
🧠 Market Context Notes
False breaks often become more relevant near visible range edges, crowded breakout levels, and late-stage expansion attempts.
The planner is most useful when combined with broader market context, liquidity conditions, volatility regime, and the trader's own risk rules.
🧾 Use Case Examples
When price breaks above a recent range but closes back inside with a long upper wick and strong volume, the planner may mark Upper Trap context.
When price breaks below a range but quickly reclaims the lower edge, the planner may shift into Lower Trap context.
When price breaks and keeps closing beyond the edge after the acceptance window, the planner may mark Break Accepted instead of forcing a trap interpretation.
🧱 System Philosophy
False Break Trap Planner follows the AGPro Series decision-engine direction: score the setup, identify the state, show the risk reference, show the target-back context, and make the next review step clear.
The script is built to help traders make a structured chart-reading decision, not to add another isolated signal.
🔐 Non-Promise Statement
No script can confirm certainty.
No trap score guarantees reversal, continuation, or profitability.
📉 Risk Disclosure
Trading involves risk.
Users are responsible for their own decisions, risk controls, and market interpretation.
This script is for educational and analytical use only and does not provide financial advice or guaranteed trading outcomes.
📚 Educational Note
Use the planner as a structured review layer around breakout failure behavior. The best value comes from comparing state, score, failure room, and broader market context together.
Indicator

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

Volatility Expansion Planner [AGPro Series]Volatility Expansion Planner
🧠 Core Idea
Is volatility expanding with structure, or is the chart only producing random noise?
📌 Overview / What it does
Volatility Expansion Planner is a chart-first volatility expansion and breakout quality tool built to evaluate whether a release from compression has enough structure to deserve active attention.
Instead of showing another generic expansion signal, the script studies ATR expansion, prior range release, close efficiency, volume support, trend alignment, compression age, and the active risk shelf behind the move. These components are converted into a 0-100 Expansion Score and a clear next-action state.
The script produces an expansion corridor, ATR expansion band, prior range edge, risk shelf, compact quality labels, alerts, and a clean AGPro planning panel. It does not predict future price movement, automate decisions, or guarantee that an expansion will continue.
🎯 Purpose & Design Philosophy
This script was built for traders who want to separate structured volatility expansion from unstable noise.
Many volatility tools identify compression, release, or regime changes, but they often stop before answering the practical planning question: is the expansion clean enough to evaluate, and where is the risk reference if the release fails?
The design philosophy is simple: volatility expansion is only useful when it has structure, confirmation, and a readable risk shelf.
⚡ Why This Script Is Different
Most tools focus on squeeze dots, volatility regime labels, ATR readings, or basic breakout markers.
This script does NOT clone a Squeeze Momentum Indicator, does not rebuild an ATR Compression Map, and does not act as a generic breakout signal.
Instead, it evaluates whether expansion is structurally supported. The main output is not a trade command. It is a planning state that helps users distinguish STRUCTURED expansion from WATCH, RISK REVIEW, NOISE, or WAIT conditions.
⚙️ Methodology
1. Context Detection
The script reads the active expansion side using prior range release and trend context, or lets the user force long-side or short-side expansion planning.
2. Reference Mapping
It maps the prior range edge, current ATR expansion, compression age, risk shelf, and projected expansion corridor.
3. Reaction Evaluation
The model scores ATR expansion, range breakout, close efficiency, volume support, trend alignment, compression maturity, and risk shelf quality.
4. Visual Output
The result is displayed through an expansion corridor, ATR band, range edge, risk shelf, compact labels, deterministic alerts, and a premium AGPro panel.
🗺️ How to Read the Chart
Zones = the expansion corridor shows the projected release path from the prior range edge toward a measured target guide. Its label is centered inside the corridor.
Labels = compact state markers show STRUCTURED, WATCH, RISK REVIEW, NOISE, or SHELF CHECK context.
Colors = green highlights cleaner structured expansion, pink highlights unstable expansion risk, amber highlights review conditions, and indigo highlights watch conditions.
Panel = the panel summarizes Expansion Score, Squeeze Age, Confirmation, Risk Shelf, and Action.
🚦 Signals & States
• STRUCTURED → volatility is expanding with range release, confirmation, and a usable risk shelf.
• WATCH → expansion context is improving but confirmation is incomplete.
• RISK REVIEW → expansion is active but the risk shelf is too tight or too wide for clean planning.
• NOISE → volatility is hot or inefficient and may represent unstable movement.
• WAIT → the script does not detect a strong enough expansion context yet.
• SHELF CHECK → price crossed the prior risk shelf and the expansion context should be reviewed.
🔔 Alerts Logic
Alerts trigger when the planner enters STRUCTURED expansion, WATCH state, NOISE state, RISK REVIEW state, or when price crosses the prior risk shelf.
These alerts are attention markers only. They are not trade instructions, entry signals, or automated strategy commands.
🧩 Confluence Logic
The strongest context appears when ATR expands from a prior compressed structure, price closes beyond the prior range edge, candle efficiency is strong, volume support improves, trend alignment agrees with the expansion side, and the risk shelf remains readable.
When these components align, the Expansion Score improves and the state can move from WATCH to STRUCTURED.
📊 When to Use
• Before evaluating volatility expansion after a quiet range
• During breakout or continuation attempts where expansion quality matters
• When price releases from a prior structure but confirmation is uncertain
• When comparing whether an expansion has clean risk context or only noisy movement
• On liquid symbols where range, volume, and ATR behavior are readable
⚠️ When NOT to Use
• Very low-liquidity symbols with unstable candles
• Extremely noisy micro-timeframes
• News-driven spikes where ATR expands abruptly without structure
• Markets where volume is unreliable and price gaps distort the risk shelf
• Situations where the user expects a signal-only entry tool
🎛️ Key Inputs
• Expansion Side → controls Auto, Long Expansion, or Short Expansion mode.
• Prior Range Lookback → controls how the script maps the range edge before release.
• ATR Baseline → controls how current volatility is compared with normal volatility.
• Minimum Squeeze Age → defines how mature compression should be before stronger expansion scoring.
• Risk Shelf Lookback → controls the shelf used behind the expansion for planning context.
• STRUCTURED Threshold → sets the minimum score required for the strongest state.
• Label and Panel Font Size → controls chart labels, corridor text, and panel readability.
🖥️ Interface & Visual Design
The interface is designed to stay chart-first.
The expansion corridor gives the main visual story. The range edge and risk shelf define the practical planning frame. The ATR band adds volatility context without turning the script into a lower-pane oscillator.
The AGPro panel provides a compact decision summary with a merged blue title row and clear state hierarchy.
🧪 Practical Usage Workflow
1. Read the panel state and Expansion Score.
2. Check whether price is releasing from the prior range edge.
3. Review the risk shelf distance and confirmation state.
4. Compare the expansion corridor with broader structure.
5. Treat alerts as attention markers, then evaluate the broader market context.
🔍 Interpretation Guidelines
Think in terms of expansion quality, not prediction.
A stronger score means multiple structural conditions are aligned. A weaker score means expansion may be premature, poorly confirmed, too hot, or difficult to plan around.
RISK REVIEW is especially important because volatility can expand while the practical risk reference remains too tight, too wide, or unclear.
🚫 What This Script Is NOT
• Not a prediction engine
• Not financial advice
• Not an auto-trading system
• Not a guaranteed signal tool
• Not a Squeeze Momentum clone
• Not an ATR Compression Map clone
⚠️ Limitations & Transparency
The script is rule-based and depends on recent price, volatility, range, and volume behavior.
Timeframe differences can change how compression and expansion appear. Volatility spikes can temporarily distort the score. Symbols with unreliable volume may produce weaker participation readings.
Outputs should always be interpreted with broader market structure and liquidity context.
🧠 Market Context Notes
Volatility expansion is most useful when it appears after a readable compression phase and respects a clear structural shelf.
Expansion without shelf clarity can still move, but it is harder to plan around. Expansion with poor close efficiency or excessive ATR heat can be noisy even when price breaks a range edge.
🧾 Use Case Examples
When price closes beyond a prior range edge with rising ATR, improved volume support, efficient candle structure, and a defined risk shelf, the planner may classify the move as STRUCTURED.
When ATR expands sharply but candles close poorly and the shelf is too far away, the planner may classify the context as NOISE or RISK REVIEW.
🧱 System Philosophy
AGPro planning tools are designed to help traders evaluate context before reacting.
This script follows that philosophy by turning volatility expansion into a structured planning question: Is the release clean, confirmed, and readable enough to deserve attention?
🔐 Non-Promise Statement
No indicator can guarantee continuation, reversal, or follow-through.
This tool provides structured visual context and rule-based attention markers. It does not provide certainty.
📉 Risk Disclosure
Trading involves risk. Market conditions can change quickly, and no script can remove uncertainty.
Users are responsible for their own analysis, risk management, and decisions.
This script is for educational and analytical use only and does not provide financial advice.
📚 Educational Note
Use the planner to study how volatility behaves after compression, how expansion quality changes across timeframes, and how risk shelf clarity affects the readability of a move.
Indicator

Pre-Breakout Pressure Planner [AGPro Series]Pre-Breakout Pressure Planner
🧠 Core Idea
Is pressure building before a breakout, or is the setup still premature?
📌 Overview / What it does
Pre-Breakout Pressure Planner is a chart-first breakout readiness tool designed to evaluate pressure before price leaves a range.
The script maps an active pressure box, upper and lower trigger corridors, directional buildup side, volume support, fakeout-risk context, invalidation reference, and target-room projection. These factors are converted into a 0-100 Pressure Score with a clear next-action state such as Bull Pressure, Bear Pressure, Coil Watch, Premature, Fakeout Risk, or Trigger Review.
It does not predict breakouts, automate entries, or confirm post-breakout acceptance. It is built to help traders organize the pre-breakout decision process before reacting to price movement.
🎯 Purpose & Design Philosophy
This script was built for traders who want to evaluate whether a breakout setup is becoming valid before the breakout actually happens.
Many traders notice a range only after price has already moved. This tool focuses on the earlier planning phase: Is the range compressed? Is one side applying pressure? Is volume supportive? Is the candle behavior constructive? Is there fakeout risk near the boundary?
The design supports a planning mindset. It helps the user read pressure quality, risk location, target room, and next-action context without turning the chart into a generic signal board.
⚡ Why This Script Is Different
Most breakout tools focus on the moment price breaks a level.
This script does NOT focus on post-breakout confirmation, measured move corridors, generic support/resistance boxes, or simple buy/sell labels.
Instead, it evaluates the setup before the break. The core question is whether pressure is building in a structured way or whether the range is still too early, too wide, too weak, or vulnerable to a fakeout.
This keeps the concept separate from consolidation breakout tools. The purpose is not to grade a completed breakout. The purpose is to organize the pre-breakout readiness window.
⚙️ Methodology
1. Context Detection
The script builds a live pressure range from prior bars and evaluates whether price remains inside the active box, probes a boundary, or enters a trigger corridor.
2. Reference Mapping
It maps the pressure box, upper trigger corridor, lower trigger corridor, active-side invalidation reference, and projected target-room reference.
3. Reaction Evaluation
The model scores range compression, higher-lows or lower-highs buildup, relative volume behavior, candle pressure, and close location inside the box.
4. Visual Output
The script displays the active pressure box, centered status label, trigger corridors, optional risk/target guides, compact event labels, alerts, and a premium AGPro panel.
🗺️ How to Read the Chart
Pressure Box = the active range where pre-breakout pressure is being evaluated.
Trigger Corridors = narrow upper and lower zones where breakout review becomes relevant.
Risk / Target Guides = active-side invalidation and target-room references used for planning context.
Labels = compact state markers showing pressure, watch, fakeout risk, or trigger-review context.
Colors = teal supports bullish buildup, pink supports bearish buildup, amber marks neutral or developing pressure, and red marks elevated fakeout risk.
Panel = summarizes Pressure Score, Buildup Side, Volume Support, Fakeout Risk, Risk / Target, and Action.
🚦 Signals & States
• Bull Pressure → bullish buildup is forming inside the pressure box near the upper trigger context.
• Bear Pressure → bearish buildup is forming inside the pressure box near the lower trigger context.
• Coil Watch → compression or pressure exists, but the directional side is not clear enough yet.
• Premature → the setup does not yet meet the pressure score or structural requirements.
• Fakeout Risk → a boundary probe appears with weak support, poor candle pressure, or elevated rejection risk.
• Trigger Review → price has entered or crossed a trigger corridor and deserves context review.
🔔 Alerts Logic
Alerts can trigger when bullish pressure appears, bearish pressure appears, fakeout risk appears, or price enters trigger-review context.
Each alert is an attention marker. Alerts are not trade instructions, entry commands, exit commands, or automated strategy rules.
🧩 Confluence Logic
The strongest pressure read appears when multiple conditions align:
Range compression + directional buildup + supportive relative volume + constructive candle pressure + close location near the active trigger side.
When these conditions weaken, the planner can shift toward Coil Watch, Premature, or Fakeout Risk.
📊 When to Use
• Before evaluating a potential range breakout.
• During tight ranges where pressure may be building on one side.
• Around breakout watchlists where fakeout risk needs context.
• During volatility compression before expansion attempts.
• On liquid symbols where ATR, range boundaries, and relative volume are meaningful.
⚠️ When NOT to Use
• Extremely low-liquidity symbols with unreliable candles or volume.
• Very noisy micro-timeframes where range boundaries change too often.
• News-driven volatility spikes where pre-breakout pressure can distort quickly.
• Markets where the recent range is too wide to represent meaningful compression.
• As a standalone reason to enter or exit a trade.
🎛️ Key Inputs
• Pressure Range Lookback → controls the prior range used to build the active pressure box.
• Buildup Slope Lookback → controls how the script measures rising lows or falling highs.
• Sensitivity → changes how strict the compression model is.
• Minimum Pressure Score → sets the score needed for Bull Pressure or Bear Pressure states.
• Volume Support Level → defines constructive relative volume before breakout.
• Trigger Corridor ATR Width → controls the size of the upper and lower trigger corridors.
• Invalidation Buffer ATR → controls the active-side invalidation reference.
• Target Room Multiple → projects target-room context from the pressure range height.
• Visual settings → control boxes, guides, labels, panel visibility, panel location, theme, and font sizes.
🖥️ Interface & Visual Design
The interface is designed to be chart-first.
The main visual object is the active pressure box with a centered status label. Trigger corridors are narrow and controlled so the chart does not become a generic zone map. Event labels are compact, offset away from candles, and limited by cooldown and maximum-visible settings.
The AGPro panel follows the standard publication layout with a single merged blue title row, adjustable panel location, adjustable theme, and adjustable font size.
🧪 Practical Usage Workflow
1. Read the panel Pressure Score and Action.
2. Check whether the pressure box is tight or still too wide.
3. Review the Buildup Side and Volume Support rows.
4. Check whether Fakeout Risk is Low, Moderate, or Elevated.
5. Compare the active trigger corridor with invalidation and target-room context.
6. Treat labels and alerts as attention markers inside broader analysis.
🔍 Interpretation Guidelines
A high Pressure Score means the pre-breakout setup is more organized according to the script's rule set. It does not mean price must break out.
Bull Pressure and Bear Pressure describe directional buildup, not guaranteed direction.
Fakeout Risk means the boundary behavior deserves caution and context review. It does not mean a breakout cannot continue later.
Trigger Review means price is interacting with a corridor. It is a review state, not a command.
🚫 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 post-breakout confirmation engine.
• Not a generic support/resistance zone map.
• Not an order-block, FVG, or supply/demand scanner.
⚠️ Limitations & Transparency
The script depends on selected lookback values, ATR normalization, relative volume behavior, and current timeframe.
Different symbols may compress differently. Some markets can show pressure for a long time before expansion. Others may probe a boundary and return inside the range several times.
The model is rule-based. Outputs should always be interpreted with broader structure, volatility, liquidity, and trader-defined risk controls.
🧠 Market Context Notes
Pre-breakout pressure is useful because the quality of a range can change before the breakout candle appears.
Rising lows can show pressure toward the upper boundary. Falling highs can show pressure toward the lower boundary. Volume support and candle pressure help judge whether that buildup is constructive or weak.
The script organizes these factors into a clean planner view so the user can decide whether the setup deserves attention, patience, or caution.
🧾 Use Case Examples
When price remains inside a tight range and the panel shifts to Bull Pressure with supported volume, the upper trigger corridor becomes the main review area.
When price presses into a boundary but the panel shows Elevated Fakeout Risk, the user can recognize that the probe may be weak or vulnerable to rejection.
When the score stays low and the state remains Premature, the range may need more time before it deserves attention.
🧱 System Philosophy
Pre-Breakout Pressure Planner follows the AGPro decision-engine approach: a script should help traders evaluate setup quality, risk, target 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 before the chart forces a decision.
🔐 Non-Promise Statement
No script can guarantee direction, continuation, breakout success, or outcome.
This tool provides structured pre-breakout 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 pressure builds inside ranges before breakout attempts.
The strongest learning value comes from comparing the panel state, pressure box, trigger corridors, and fakeout-risk labels with the broader chart context.
Indicator

Decision Point Planner [AGPro Series]Decision Point Planner
🧠 Core Idea
Is price sitting at a decision point that deserves review, patience, or rejection?
📌 Overview / What it does
Decision Point Planner is a chart-first risk planning tool built to evaluate whether the current price area is meaningful enough to deserve attention.
The script maps one active decision point from structure shelf, balance edge, or trend backbone context, then scores the area using location quality, reaction candle behavior, volume support, trend context, available room, and invalidation distance. The output is a 0-100 Decision Score, a clear next-action state, a decision zone, an invalidation shelf, a target-room corridor, compact labels, alerts, and a premium AGPro panel.
It does not predict price direction, automate execution, or print direct buy/sell signals.
🎯 Purpose & Design Philosophy
This script was built for traders who want to know whether the chart is actually at a meaningful decision area or simply moving through noise.
Many tools show levels, zones, or signals in isolation. Decision Point Planner focuses on a narrower planning question: if price is near a decision reference, is the reaction strong enough, is risk still balanced, and is there enough room before the next obstacle?
The design supports a patient planning mindset: identify the point, read the reaction, check room and invalidation, then decide what deserves attention.
⚡ Why This Script Is Different
Most tools focus on plotting many support/resistance levels or marking every reaction.
This script does NOT create a generic S/R map, order-block scanner, FVG map, or prediction engine.
Instead, it selects one active decision reference and turns it into a planning workflow: Decision Score, Zone Type, Reaction State, Room/Risk, and Next Action.
⚙️ Methodology
1. Context Detection
The script detects the active planning side automatically using trend context and range location, or the user can force Long Context or Short Context.
2. Reference Mapping
It compares three decision references: the latest structure shelf, the active balance edge, and the trend backbone. The closest relevant reference becomes the active decision point.
3. Reaction Evaluation
It evaluates whether price is touching or approaching the zone, whether the candle shows a valid reaction, whether volume supports the reaction, whether trend context agrees, and whether room and invalidation remain balanced.
4. Visual Output
It displays a decision zone, invalidation shelf, target-room corridor, compact chart labels, alerts, and a clean AGPro panel.
🗺️ How to Read the Chart
Decision Zone = the current area where price is being evaluated as a decision point.
Invalidation Shelf = the reference beyond the zone that marks rejection in this rule set.
Target-Room Corridor = the available forward room toward the nearest obstacle or a minimum room guide.
Labels = compact attention markers showing ACTION, WAIT, PATIENCE, REJECTED, ROOM, or D POINT context.
Colors = teal and pink show active directional context, amber shows caution, indigo shows wait/reaction context, and blue is reserved for the AGPro panel header.
Panel = summarizes Decision Score, Zone Type, Reaction State, Room Risk, and Action.
🚦 Signals & States
• ACTION REVIEW → the decision point has enough score, reaction, room, and risk quality to deserve closer review.
• WAIT REACTION → price is near the decision point, but the reaction is still incomplete.
• PATIENCE → the area is active but quality, room, or risk is not clean enough yet.
• REJECTED → price crossed the invalidation shelf for the active decision point.
• STAND BY → price is not close enough to the active decision reference.
🔔 Alerts Logic
• Decision Point Action Review → triggers when the state enters ACTION REVIEW.
• Decision Point Wait Reaction → triggers when price is near the point but reaction is incomplete.
• Decision Point Patience → triggers when the active point requires patience or broader confirmation.
• Decision Point Room Limited → triggers when the point is active but forward room is limited.
• Decision Point Rejected → triggers when price crosses the active invalidation shelf.
Alerts are attention markers. They are not trade instructions.
🧩 Confluence Logic
Decision quality improves when location, reaction candle behavior, volume support, trend context, target room, and invalidation distance align.
The strongest read appears when price is near the decision zone, the reaction candle is efficient, volume is supportive, trend context agrees, room is open, and risk distance is balanced.
📊 When to Use
• Around pullbacks where price is near a meaningful planning reference.
• During breakout or continuation preparation when the next reaction matters.
• Near range edges or balance transitions where patience is required.
• When comparing whether a setup deserves review or should remain on watch.
• On liquid markets where ATR, volume, and recent structure are meaningful.
⚠️ When NOT to Use
• Extremely low-liquidity markets with unreliable volume and candles.
• Highly noisy micro-timeframes where decision references change too frequently.
• News-driven volatility spikes where ATR and candle ranges expand abnormally.
• Charts where the user expects automatic buy/sell signals.
• As a standalone reason to enter or exit a trade.
🎛️ Key Inputs
• Planning Side → selects Auto, Long Context, or Short Context.
• Decision Range Lookback → defines the planning range and target-room obstacle.
• Structure Shelf Pivot Length → controls how strict the structure shelf reference is.
• Decision Reach ATR → controls how close price must be to the active point before review.
• Decision Zone Half-Width ATR → controls the vertical size of the decision zone.
• Target Room and Invalidation Inputs → define room quality and balanced risk distance.
• Visual Settings → control zones, shelves, corridor, labels, panel location, panel theme, and font sizes.
🖥️ Interface & Visual Design
The interface is intentionally chart-first.
The script uses one active decision zone, one invalidation shelf, and one target-room corridor instead of filling the chart with many competing zones. Labels are compact, offset away from candles, and controlled with cooldown and maximum-visible settings.
The panel follows the AGPro publication layout with a single merged blue title row, adjustable location, adjustable theme, and adjustable font size.
🧪 Practical Usage Workflow
1. Read the panel state and Decision Score.
2. Check the active decision zone and zone type.
3. Evaluate the reaction label and candle behavior.
4. Compare target-room corridor and invalidation shelf.
5. Treat alerts as review markers and confirm the broader market context.
🔍 Interpretation Guidelines
A higher Decision Score means the active decision point has stronger alignment inside the script's rule set. It does not mean price must move in the planned direction.
ACTION REVIEW means the area deserves attention, not automatic execution.
WAIT REACTION means the location may be important but the reaction is not complete.
REJECTED means the active invalidation shelf was crossed in this rule set.
🚫 What This Script Is NOT
• Not a prediction engine.
• Not financial advice.
• Not auto trading.
• Not guaranteed signals.
• Not a buy/sell signal service.
• Not a generic support/resistance zone map.
• Not an order-block or FVG scanner.
⚠️ Limitations & Transparency
Decision quality depends on the selected lookback, pivot length, ATR behavior, volume reliability, and timeframe.
Different markets can produce different reference behavior. High volatility can widen invalidation distance. Low volatility can compress target room. Small timeframes may produce more frequent state changes.
The script is rule-based and should be interpreted as an analytical planning layer inside broader market context.
🧠 Market Context Notes
A decision point is useful only when it connects location, reaction, risk, and room.
The same visual area can be weak if reaction is poor, volume is absent, target room is blocked, or invalidation is too tight or too wide.
This script organizes those checks into one readable decision layer.
🧾 Use Case Examples
When price pulls back toward the decision zone and the panel moves from WAIT REACTION to ACTION REVIEW, the area may deserve closer review.
When price touches the zone but the panel shows Room Limited, the user can recognize that the nearby path is obstructed.
When price crosses the invalidation shelf, the script marks the active decision point as rejected inside its rule set.
🧱 System Philosophy
Decision Point Planner follows the AGPro decision-engine approach:
Context first.
Risk before reaction.
Room before confidence.
Attention markers instead of promises.
🔐 Non-Promise Statement
No script can guarantee direction, continuation, reversal, or outcome.
This tool provides structured chart context only.
📉 Risk Disclosure
Trading involves risk.
Users are responsible for their own analysis, risk controls, position sizing, and trading decisions.
This script does not provide financial advice, investment advice, or guaranteed trading outcomes.
📚 Educational Note
Use the script to study how decision quality changes as price moves closer to or away from active planning references.
The most useful reading comes from comparing the panel state with visible price reaction, room, and invalidation context.
Indicator

Indicator

Setup Decay Tracker [AGPro Series]Setup Decay Tracker
🧠 Core Idea
Is a once-valid setup still healthy, or is its quality decaying over time?
📌 Overview / What it does
Setup Decay Tracker is a chart-first execution planning tool built to evaluate what happens after a setup has already started forming. Instead of treating every trigger as equally useful, it separates the process into two stages: setup validation and post-validation quality decay.
The script builds an active decay band, validation rail, follow-through rail, invalidation shelf, expiry marker, state labels, and a compact planning panel. Its purpose is to show whether the active setup is still valid, starting to fade, entering decay review, expiring, reclaiming its trigger side, or invalidating.
It does not predict price, automate trades, or issue buy/sell commands. Alerts and labels are attention markers designed to help traders review setup quality within broader market context.
🎯 Purpose & Design Philosophy
This script was built for traders who already understand that the first setup trigger is only the beginning of the decision process. A setup can look valid at first, then lose quality because time passes, momentum fades, volatility contracts, follow-through stalls, or price loses and reclaims the trigger side.
The gap it fills is post-validation review. Many tools mark a trigger, but fewer tools ask whether that trigger is aging well after it becomes valid. Setup Decay Tracker focuses on that question with a clean visual workflow.
The design supports a planning mindset: validate first, monitor quality second, review decay third.
⚡ Why This Script Is Different
Most tools focus on the moment a signal appears.
This script does NOT behave like a generic signal generator, broad regime classifier, support/resistance map, order-block map, or simple breakout alert.
Instead, it tracks the lifecycle of one active setup after validation. It asks whether the setup is still earning its place on the chart by measuring time risk, follow-through, momentum loss, volatility loss, trigger-side reclaim behavior, and invalidation context.
⚙️ Methodology
1. Context Detection
The script identifies the evaluation side using trend and range context, or the user can force long-side or short-side tracking.
2. Setup Validation
A trigger starts tracking, but the setup is not treated as fully valid until it reaches minimum favorable ATR travel and a validation-quality threshold.
3. Decay Evaluation
After validation, the script measures the active setup with a 0-100 decay model based on time risk, momentum loss, volatility loss, failed follow-through, and reclaim behavior.
4. Visual Output
The result appears as a decay band, validation rail, follow-through rail, invalidation shelf, expiry marker, compact labels, and a premium AGPro planning panel.
🗺️ How to Read the Chart
Zones = the active setup decay band between the follow-through reference and the invalidation shelf.
Labels = state changes such as TRACK, VALID, WATCH, DECAY, RECLAIM, EXPIRED, and INVALID.
Colors = teal for healthier states, gold for watch states, pink/red for decay review or invalidation pressure, and indigo for validation or reclaim context.
Panel = the decision summary showing Decay Score, Time Risk, Follow-Through, Invalidation, and Action.
🚦 Signals & States
• TRACK → a new setup is being monitored for validation
• VALID → the setup reached minimum quality and decay tracking is active
• STILL VALID → decay score remains low and follow-through is still acceptable
• QUALITY WATCH → quality is fading, but the setup has not reached decay review
• DECAY REVIEW → the setup has enough quality decay to deserve closer review
• RECLAIM → price recovered the trigger side after temporary loss
• EXPIRED → the setup aged beyond the active decay window or reached expiry-level decay
• INVALID → the invalidation shelf was crossed inside this rule set
🔔 Alerts Logic
The script includes alerts for:
• New setup tracking
• Setup validation
• Quality watch state
• Decay review state
• Trigger-side reclaim
• Setup expiry
• Setup invalidation
Alerts are attention markers. They are not trade instructions and should be interpreted with market structure, liquidity, volatility, and timeframe context.
🧩 Confluence Logic
The decay model becomes more meaningful when several conditions align.
When time risk rises, follow-through remains weak, momentum fades, volatility contracts, and price struggles around the trigger side, the setup decay context becomes stronger.
When follow-through improves, the trigger side holds, volatility remains healthy, and momentum stays directional, the setup remains cleaner.
📊 When to Use
• Breakout setups that need post-trigger validation
• Trend-reclaim setups where quality can fade after the first reclaim
• Continuation contexts where follow-through matters
• Active trade planning where invalidation and target references need to stay visible
• Markets where setup aging and time risk are part of the decision process
⚠️ When NOT to Use
• Extremely low-liquidity symbols
• Very noisy micro timeframes where triggers appear too frequently
• News-driven candles where normal volatility logic becomes distorted
• Markets with large gaps that make ATR-based validation less stable
• Situations where the user expects automatic entries, exits, or guaranteed outcomes
🎛️ Key Inputs
• Evaluation Side → chooses Auto, Long Setup, or Short Setup tracking
• Trigger Model → controls whether tracking starts from range acceptance, trend reclaim, or impulse continuation
• Sensitivity → changes how strict validation and decay response should be
• Setup Lookback → defines the recent structure window used for trigger context
• Validation Travel ATR → sets the minimum favorable movement needed before a setup is considered valid
• Decay Tracking Bars → controls how long a validated setup remains active
• Follow-Through Target ATR → defines the progress reference used inside the decay model
• Invalidation Buffer ATR → builds the invalidation shelf beyond the trigger candle
• Label and Panel Font Size → controls visual readability
🖥️ Interface & Visual Design
The interface is built around a clean chart-first layout. The decay band gives the setup a visible lifecycle area, while the centered band label summarizes the active state without requiring a dashboard-only workflow.
The panel is compact and decision-focused. Its first row follows the AGPro standard: one merged blue header row containing only the panel title. Panel location, panel theme, and panel font size are adjustable.
Labels are intentionally moderate. The script uses event labels plus sparse context labels so the chart stays alive without becoming crowded.
🧪 Practical Usage Workflow
1. Read the panel and check the active state.
2. Confirm whether the setup is validating, still valid, in watch state, in decay review, expired, or invalidated.
3. Check the decay band, validation rail, follow-through rail, and invalidation shelf.
4. Review labels for the most recent state change.
5. Interpret the output with broader market context before making any decision.
🔍 Interpretation Guidelines
Think of the Decay Score as a quality-loss meter, not a directional forecast.
A low Decay Score suggests that the setup is still holding its validation context.
A rising Decay Score suggests that time, weak progress, fading momentum, volatility loss, or trigger-side instability are reducing setup quality.
A Decay Review state means the setup deserves attention. It does not mean price must reverse or that a trade must be closed.
🚫 What This Script Is NOT
• Not a prediction engine
• Not financial advice
• Not an auto-trading system
• Not a guaranteed signal tool
• Not a generic support/resistance map
• Not a broad market regime classifier
⚠️ Limitations & Transparency
ATR-based rails can behave differently across markets, timeframes, and volatility regimes.
Fast news moves, thin liquidity, and wide spreads can distort validation and decay readings.
No rule-based tool can fully understand every market condition. The output should be read as structured context, not certainty.
🧠 Market Context Notes
Setup decay often matters most when the first trigger was valid but follow-through becomes uncertain. A setup can remain technically alive while losing momentum, time efficiency, or volatility support.
The script focuses on that middle zone between “still valid” and “clearly invalidated.”
🧾 Use Case Examples
When price breaks a recent range, validates with minimum travel, then stalls for many bars without reaching the follow-through rail, the Decay Score can rise into watch or review context.
When price temporarily loses the trigger side and then reclaims it, the script marks reclaim context and continues monitoring quality rather than treating the setup as automatically clean.
When price crosses the invalidation shelf, the setup is marked invalid inside this rule set.
🧱 System Philosophy
Setup Decay Tracker follows the AGPro planning approach: the best public tools should help traders make a decision, not simply show another signal.
The script is designed to answer practical questions:
Is this setup valid?
How much quality has it lost?
Where is the invalidation?
Is follow-through still acceptable?
What should I review now?
🔐 Non-Promise Statement
This script does not provide certainty.
It does not guarantee outcomes.
It provides a structured way to monitor setup quality decay after validation.
📉 Risk Disclosure
Trading involves risk.
Users are responsible for their own analysis, decisions, risk management, and trade execution.
This script is for educational and analytical purposes only and does not provide financial advice.
📚 Educational Note
Use the tool to study how setup quality changes after the first valid trigger. The most useful reading often comes from comparing the panel state, decay band, labels, and broader market context together.
Indicator

Execution Window Planner [AGPro Series]Execution Window Planner
🧠 Core Idea
Where is the cleanest active price window for evaluating execution context?
📌 Overview / What it does
Execution Window Planner is a chart-first execution-readiness tool built to answer one practical question: is price currently sitting inside a clean review window, or is the context too early, too late, too stretched, or already invalidated?
The script maps an active execution window box, a risk edge, a target edge, compact state labels, and a premium AGPro panel. It converts window width, structure alignment, volatility fit, trend support, candle confirmation, and room-to-risk context into a transparent 0-100 Quality Score.
It does not predict price movement, automate orders, or issue buy/sell commands. The output is designed as an analytical planning layer for traders who want cleaner context before making their own execution decisions.
🎯 Purpose & Design Philosophy
This script was built for traders who already have a directional thesis but need a disciplined way to judge whether the current price area is actually usable for execution review.
Many tools show trend, signals, support/resistance, or zones. The missing piece is often the active decision window: the price area where risk is still definable, target room still exists, volatility is not distorted, and confirmation is not too weak.
The design philosophy is simple: execution quality should be evaluated through a defined window, not through excitement around a single candle.
⚡ Why This Script Is Different
Most tools focus on printing a signal, marking a generic support/resistance area, or showing a large multi-feature trading dashboard.
This script does NOT act as a full trading suite, signal service, position sizing tool, ICT/FVG map, order block map, or generic zone scanner.
Instead, it keeps one narrow purpose: identify and score the current execution window using risk edge, target edge, structure, volatility, trend support, and candle confirmation. The result is a focused decision layer rather than another broad indicator.
⚙️ Methodology
1. Context Detection
The script detects the active planning side automatically from trend structure, or lets the user force a long-bias or short-bias view.
2. Reference Mapping
It builds a risk edge from recent structure and a target edge from broader structure or ATR-adjusted room.
3. Window Construction
It creates an active execution window around the current trend reference, then limits that window between the risk edge and target edge.
4. Reaction Evaluation
It scores window width, structure alignment, volatility fit, trend support, and candle confirmation into a 0-100 Quality Score.
5. Visual Output
The chart displays the execution window box, risk/target edges, state labels, alerts, and a premium AGPro panel with the key decision fields.
🗺️ How to Read the Chart
Execution Window = the current price area where the script is evaluating execution context.
Risk Edge = the structure-based invalidation edge for the active window.
Target Edge = the nearest meaningful target-side reference or ATR-adjusted room marker.
Labels = the current window state, score tier, risk distance, and room-to-risk context.
Colors = teal for stronger bullish execution windows, pink for bearish or invalidation contexts, amber for forming/waiting states, and indigo for target-edge or transition states.
Panel = the fastest summary of window state, quality score, risk edge, target edge, and next action.
🚦 Signals & States
• ACTIVE → the execution window meets the quality threshold and confirmation filter.
• FORMING → the window is improving but still needs cleaner confirmation.
• WAIT → the context exists, but structure, volatility, room, or confirmation is not strong enough yet.
• BLOCKED → there is no clean execution window in the current context.
• TARGET EDGE → price has reached the mapped target-side reference and reaction quality should be evaluated.
• INVALIDATED → price closed beyond the active risk edge.
🔔 Alerts Logic
ACTIVE Window alerts trigger when the state upgrades into ACTIVE.
Downgrade alerts trigger when the active window weakens from a stronger previous state.
Risk Edge alerts trigger when price closes beyond the current risk edge.
Target Edge alerts trigger when price reaches the current target edge.
Alerts are attention markers only. They are not trading instructions.
🧩 Confluence Logic
The strongest execution-window context appears when several conditions align:
• Price remains inside the mapped execution window
• The risk edge is still structurally valid
• The target edge leaves enough room relative to risk
• Trend support agrees with the active side
• Candle structure confirms the same direction
• Volatility is close to its recent baseline
When these elements align, the Quality Score improves and the panel state becomes easier to interpret.
📊 When to Use
• When you already have a directional thesis and want to evaluate execution context
• During trend continuation setups where risk and target references remain clear
• Around pullback or reset areas where timing and risk quality matter
• Before reacting to a potential continuation candle
• When you want a cleaner planning layer instead of another simple signal indicator
⚠️ When NOT to Use
• During very low-liquidity conditions where candles print irregularly
• During high-noise chop where risk and target edges change too quickly
• During extreme volatility spikes where ATR context becomes distorted
• On symbols with poor price continuity or unreliable session behavior
• As a standalone reason to enter or exit a trade
🎛️ Key Inputs
• Setup Direction → Auto detects the active planning side, or the user can force Long Bias / Short Bias.
• Sensitivity → controls how selective the model is.
• Structure Lookback → controls how risk edge, target edge, and structure context are mapped.
• Minimum ACTIVE Score → defines the score threshold required for ACTIVE state.
• Confirmation Mode → controls how much trend and candle confirmation must align.
• Label Cooldown Bars → controls historical label density.
• Max Visible Labels → limits older state labels to keep the chart readable.
• Label Detail → Compact is the default clean publication view; Balanced and Full can show more risk/room context.
• Label Offset Strength / Lane Strength → smart placement controls that keep labels near price without burying them inside candles or pushing them too far away on higher timeframes.
• Panel Location / Theme / Font Size → controls the AGPro panel presentation.
• Label Font Size → controls all on-chart labels.
🖥️ Interface & Visual Design
The panel is designed as a compact decision dashboard, not a large command center. The first row uses the standard AGPro merged blue header row, and the remaining rows focus only on the information needed to evaluate the current execution window.
The chart visuals stay restrained: one active execution window, one risk edge, one target edge, a current quality tag, and moderate historical state labels. The goal is a premium, readable chart that does not feel empty but also avoids clutter.
🧪 Practical Usage Workflow
1. Read the panel state first.
2. Check whether price is inside or near the execution window.
3. Compare the risk edge and target edge.
4. Review the Quality Score and confirmation state.
5. Interpret labels as context markers, not as trade commands.
6. Confirm the broader market context with your own process.
🔍 Interpretation Guidelines
ACTIVE does not mean guaranteed continuation. It means the current window has passed the script's rule-based quality model.
FORMING means the setup may be developing, but the script does not yet see enough confirmation.
WAIT means the context may exist, but the window quality is not clean enough.
BLOCKED means the current chart does not offer a useful execution window under the selected settings.
TARGET EDGE means the chart has reached the mapped target-side reference, so reaction quality becomes more important than chasing the move.
INVALIDATED means the risk edge has been broken and the active window should be reset.
🚫 What This Script Is NOT
• Not a prediction engine
• Not financial advice
• Not an auto-trading system
• Not a guaranteed signal tool
• Not a full trading suite
• Not an ICT/FVG or order block map
• Not a generic support/resistance zone scanner
⚠️ Limitations & Transparency
Execution-window quality is rule-based and depends on the selected inputs, timeframe, symbol behavior, and available chart data.
Different timeframes can produce different risk and target edges because market structure changes with resolution.
Fast volatility expansion can make the current edge distances less stable.
Low-volume markets may produce weaker confirmation quality.
The script should be interpreted inside broader market context, not in isolation.
🧠 Market Context Notes
Execution quality is usually strongest when structure, volatility, and trend behavior are aligned.
If volatility expands too quickly, the window can become stretched even if direction looks strong.
If the target edge is too close, the setup may have limited room even when the trend looks clean.
If the risk edge is too far away, the setup may require too much tolerance relative to the available room.
🧾 Use Case Examples
When price pulls back toward the active trend reference, remains inside the execution window, and the risk edge is still structurally protected, the Quality Score may improve.
When price reaches the target edge after an ACTIVE window, the script can shift into TARGET EDGE state so the user can evaluate reaction behavior instead of treating the move as fresh.
When price closes beyond the risk edge, the window becomes INVALIDATED and the panel shifts to a reset-oriented state.
🧱 System Philosophy
Execution Window Planner follows the AGPro Series approach: build scripts that help traders make a decision, not just see another signal.
The script is intentionally narrow. It focuses on one practical question and keeps the chart output centered around that question.
🔐 Non-Promise Statement
No script can provide certainty.
No score guarantees future movement.
No alert should be treated as an instruction to trade.
📉 Risk Disclosure
Trading involves risk.
Users are responsible for their own analysis, execution choices, risk management, and trading outcomes.
This script is for educational and analytical use only and does not provide financial advice.
📚 Educational Note
The best use of this script is to study how execution context changes as price moves between risk edge, execution window, and target edge.
Use it as a structured planning aid, not as a replacement for your own market analysis.
Indicator

Risk Exposure Compass [AGPro Series]Risk Exposure Compass
🧠 Core Idea
Is the current chart exposing the trader to balanced risk, or is price already stretched, blocked, or too early?
📌 Overview / What it does
Risk Exposure Compass is a chart-first risk planning tool designed to evaluate the current exposure quality of a setup before the trader treats it as actionable.
Instead of printing generic buy or sell signals, the script studies ATR stretch, range position, distance from the exposure mean, trend maturity, target-edge room, and invalidation distance. These components are converted into a 0-100 Risk Exposure Score and a clear next-action state.
The script produces a risk compass band, invalidation shelf, target-edge guide, exposure heat labels, alerts, and a clean AGPro planning panel. It does not predict price direction, automate execution, calculate position size, or guarantee that a setup will follow through.
🎯 Purpose & Design Philosophy
This script was built for traders who want to ask a practical pre-decision question: is the chart still offering clean exposure, or has the move become too stretched to evaluate cleanly?
The gap it fills is different from a manual risk/reward visualizer, position planner, or risk runway tool. Risk Exposure Compass focuses on the current chart location itself: how far price is from mean, how mature the move is, whether volatility load is normal, whether target room is open, and whether invalidation distance is controlled.
The design supports a disciplined review mindset. It helps users avoid treating every active move as equal by separating balanced exposure, watch context, stretched risk, blocked room, and reset conditions.
⚡ Why This Script Is Different
Most tools focus on entries, support/resistance zones, take-profit ladders, or manual risk/reward boxes.
This script does NOT build a full trade plan, does NOT calculate position size, does NOT create a TP ladder, and does NOT become a dashboard-only stress meter.
Instead, it draws a live risk compass directly on the chart and scores whether the current price location is balanced, extended, blocked by nearby target structure, or too early for clean planning.
⚙️ Methodology
1. Context Detection
The script reads automatic long-side or short-side exposure using mean and trend context, or lets the user force the exposure side manually.
2. Reference Mapping
It maps an exposure mean, active range, structural invalidation shelf, target-edge obstruction, and a projected compass band.
3. Reaction Evaluation
The model scores five core components: ATR stretch, range position, distance from mean, trend maturity, and target obstruction. Invalidation distance and volatility load refine the final state.
4. Visual Output
The output is shown through a centered compass band label, invalidation and target guide lines, compact exposure labels, deterministic alerts, and a premium AGPro panel.
🗺️ How to Read the Chart
Zones = the risk compass band where price is considered more balanced relative to the active exposure mean.
Labels = compact state markers showing BALANCED, WATCH, STRETCHED, BLOCKED, or RESET context.
Colors = teal marks cleaner exposure, pink marks blocked or failed context, amber marks stretched risk, and indigo marks watch or transition states.
Panel = the panel summarizes Exposure State, Risk Score, Volatility Load, Distance Risk, and Action.
🚦 Signals & States
• BALANCED → exposure is inside the compass band with a strong enough score.
• WATCH → exposure quality is developing but not yet clean enough for balanced status.
• STRETCHED → price is extended from mean, late in range position, volatility is overloaded, or invalidation distance is too wide.
• BLOCKED → nearby target-edge room is limited relative to current exposure.
• RESET → the chart is early, unclear, or below the minimum quality threshold.
🔔 Alerts Logic
Alerts trigger when exposure moves into BALANCED, WATCH, STRETCHED, BLOCKED, or RESET state.
These alerts are attention markers. They are not trade instructions, entry signals, exit signals, or automated strategy commands.
🧩 Confluence Logic
The strongest exposure context appears when ATR stretch is controlled, price is not at an extreme range edge, distance from mean is balanced, trend maturity is not too early or too late, and target room remains open.
When these conditions align, the Risk Exposure Score rises and the panel state becomes easier to interpret.
📊 When to Use
• Before evaluating a discretionary setup
• During pullbacks or pauses where risk location matters
• Around continuation attempts after a trend has already moved
• Before breakouts where price may already be extended
• When comparing whether one chart has cleaner exposure than another
⚠️ When NOT to Use
• Extremely low-liquidity symbols
• Very noisy micro-timeframes
• News-driven volatility spikes
• Non-standard chart types that distort candle range and ATR behavior
• Situations where the user expects a signal-only entry tool
🎛️ Key Inputs
• Exposure Side → controls Auto, Long Exposure, or Short Exposure evaluation.
• Range Lookback → defines the range used for price-location scoring.
• ATR Length → normalizes stretch, distance risk, target room, and label offsets.
• Exposure Mean EMA → defines the mean used for the compass band and distance scoring.
• Target Obstruction Lookback → controls how nearby target-edge room is estimated.
• Invalidation Shelf Lookback → controls the structural invalidation reference.
• Sensitivity → adjusts how strict the exposure model is.
• Visual settings → control compass band, guides, candle heat, labels, panel location, theme, and font sizes.
🖥️ Interface & Visual Design
The interface is built around one primary chart object: the risk compass band.
The panel follows the AGPro public-release standard with one merged blue header row containing only the script name. The rows are kept compact so the tool stays readable without becoming dashboard-heavy.
Labels are intentionally short, offset away from candles, and controlled with cooldown and maximum-visible settings.
🧪 Practical Usage Workflow
1. Read the panel Exposure State and Risk Score.
2. Check whether price is inside, below, or beyond the risk compass band.
3. Review Distance Risk to see whether invalidation is controlled, fragile, or too wide.
4. Check target-edge room before treating exposure as clean.
5. Use alerts as review prompts, not as automated trading instructions.
🔍 Interpretation Guidelines
A high score means the chart is closer to balanced exposure according to the script's rule-based model.
A low score means price may be too early, too stretched, blocked by nearby structure, or unclear relative to mean and range position.
The best interpretation comes from reading score, state, volatility load, distance risk, and target room together instead of relying on one label.
🚫 What This Script Is NOT
• Not a prediction engine
• Not financial advice
• Not auto trading
• Not guaranteed signals
• Not a position sizing calculator
• Not a manual risk/reward visualizer
• Not a take-profit ladder
⚠️ Limitations & Transparency
The model is rule-based and depends on recent structure, ATR, moving averages, candle range, and target-edge mapping.
Different timeframes can produce different exposure states because range, trend maturity, and invalidation shelves change with timeframe.
Fast volatility expansion can move the script quickly from balanced to stretched, while low-volatility environments can keep exposure in reset or watch state for longer.
No rule-based tool can know a user's actual execution plan, account risk, broker rules, or broader market thesis.
🧠 Market Context Notes
Risk exposure is not the same as direction.
A chart can be bullish but stretched, bearish but blocked, or directionally interesting while still offering poor exposure quality.
This script is designed to keep that distinction visible.
🧾 Use Case Examples
When price is above the exposure mean, inside the compass band, with controlled invalidation distance and enough target room, the panel can shift toward BALANCED.
When price accelerates far beyond the compass band with hot volatility and a late range position, the script can mark STRETCHED risk.
When price is close to a prior target edge and the room score is weak, the script can mark BLOCKED even if the broader trend still looks strong.
🧱 System Philosophy
The AGPro approach is to turn chart information into structured decision context.
Risk Exposure Compass follows that approach by converting price location into a cleaner review framework: mean, range, volatility, invalidation, target room, score, and next state.
🔐 Non-Promise Statement
This script does not provide certainty.
It does not guarantee that balanced exposure will lead to follow-through.
It only organizes current chart conditions so exposure quality is easier to review.
📉 Risk Disclosure
Trading involves risk.
Users are responsible for their own analysis, execution, risk management, and decisions.
This script is for educational and analytical purposes only and does not provide financial advice.
📚 Educational Note
Use the tool to study how price moves from reset to watch, from watch to balanced, and from balanced to stretched or blocked as market context changes.
Indicator

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

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

R-Multiple Progress Map [AGPro Series]R-Multiple Progress Map
🧠 Core Idea
How far has the active move progressed in R terms, and is that progress still healthy enough to monitor?
📌 Overview / What it does
R-Multiple Progress Map is a chart-first trade management overlay that tracks a setup after activation and converts price movement into R-multiple progress.
Instead of acting like a risk/reward calculator, a position sizing tool, or a take-profit promise system, the script focuses on what happens after an active cycle begins. It maps an entry proxy, invalidation proxy, R ladder, current R marker, partial-review bands, pullback-risk state, and a clean AGPro progress panel.
The script does not predict future price movement, place orders, automate trade management, or tell the user what to buy or sell. It is a structured progress-reading layer for discretionary review.
🎯 Purpose & Design Philosophy
This script was built for traders who think in R-multiples but need a cleaner way to read progress quality after a setup becomes active.
Many tools help plan the trade before activation. Fewer tools focus on the management question after activation: is the move actually making progress, is pullback pressure increasing, where is the next R review zone, and what should the user pay attention to now?
The design supports a decision-engine mindset: measure progress, evaluate health, and keep the chart readable without turning it into a crowded signal board.
⚡ Why This Script Is Different
Most tools focus on drawing entry, stop-loss, and take-profit levels before a trade begins.
This script does NOT try to become a full position planner, risk/reward visualizer, position-size calculator, or target ladder.
Instead, it starts from an activated progress cycle and evaluates the move in R terms. The unique output is not a trade instruction. It is a live progress state that separates ACTIVE, BUILDING, PROGRESSING, EXTENDED, PULLBACK RISK, STALLED, INVALIDATED, and WAIT conditions.
⚙️ Methodology
1. Context Detection
The script detects activation using range-break and trend-pulse logic, or allows the user to restrict the map to long-only or short-only progress context.
2. Reference Mapping
When a progress cycle activates, the script stores an entry proxy, invalidation proxy, R-risk unit, active side, active bar, maximum favorable R progress, and adverse R pressure.
3. Reaction Evaluation
The model evaluates R expansion, candle progress, trend support, drawdown pressure, time efficiency, and volatility stability. These components are blended into a 0-100 progress score.
4. Visual Output
The output is shown through an R ladder, centered partial-review bands, live progress fill, current R marker, event labels, alerts, and a compact AGPro panel.
🗺️ How to Read the Chart
Zones = partial-review R bands between key R levels, such as 0.5R-1R, 1R-2R, and 2R-3R.
Labels = activation, R milestone, pullback-risk, stalled-progress, and invalidation markers.
Colors = bullish progress, bearish progress, warning states, and neutral states use the AGPro color language.
Panel = the panel summarizes Current R, Progress Grade, Pullback Risk, Next R Zone, and Action.
🚦 Signals & States
• ACTIVE → a new progress cycle has activated and early R progress is being measured.
• BUILDING → price has started to make useful R progress but is not yet strong enough for a higher-grade state.
• PROGRESSING → the move has reached meaningful R progress with supportive score conditions.
• EXTENDED → progress is advanced and the next R zone deserves review.
• PULLBACK RISK → price has given back enough favorable R progress to deserve caution.
• STALLED → the active cycle has spent time without enough R progress.
• INVALIDATED → the active cycle touched the invalidation proxy.
• WAIT → no active progress cycle is currently being tracked.
🔔 Alerts Logic
Alerts trigger when a new progress cycle activates, when 0.5R, 1R, or 2R progress is reached, when pullback risk increases, when progress stalls, or when the invalidation proxy is touched.
These alerts are attention markers. They are not trade instructions, entry signals, exit signals, or automated strategy commands.
🧩 Confluence Logic
The strongest progress context appears when multiple components align:
R expansion + strong candle progress + trend support + controlled pullback drawdown + efficient timing + stable volatility.
When these components align, the script can classify the active move as PROGRESSING or EXTENDED. If drawdown pressure rises or time efficiency weakens, the state can shift toward PULLBACK RISK or STALLED.
📊 When to Use
• After a breakout or continuation attempt has activated
• While monitoring whether a setup is progressing in clean R terms
• During discretionary trade management review
• When comparing whether a move is building, stalling, or extending
• When the user wants chart-first R progress without a full position-size calculator
⚠️ When NOT to Use
• Extremely low-liquidity symbols
• Very noisy micro-timeframes with unstable wick behavior
• News-driven volatility spikes
• Markets where recent structure cannot define a useful invalidation proxy
• Situations where the user expects a complete risk/reward planning suite
🎛️ Key Inputs
• Progress Side → controls Auto, Long Progress, or Short Progress evaluation.
• Activation Mode → chooses Range Break, Trend Pulse, or Hybrid activation logic.
• Structure Lookback → defines the activation and context window.
• Invalidation Proxy Lookback → maps the R-risk reference used for progress normalization.
• Minimum Activation Score → controls how selective new progress cycles are.
• Pullback Risk R → defines how much R drawdown triggers caution.
• Visual settings → control R ladder, partial-review bands, progress fill, labels, panel location, theme, and font sizes.
🖥️ Interface & Visual Design
The interface is built around one primary idea: R progress after activation.
The R ladder and partial-review bands keep the chart visually informative, while the panel keeps the decision state compact and readable.
Labels are offset away from candles, limited by maximum count, and controlled with cooldown and sparse context settings for a balanced public-release chart.
🧪 Practical Usage Workflow
1. Read the panel action state.
2. Check the current R and maximum R progress.
3. Review whether pullback risk is low, moderate, or high.
4. Look at the next R zone for management context.
5. Treat alerts as attention markers and confirm the broader market context independently.
🔍 Interpretation Guidelines
A higher progress score means the active move is showing stronger alignment between R expansion, trend support, drawdown control, time efficiency, and volatility stability.
PROGRESSING does not mean a trade should be opened or held. It means the active cycle is showing healthier R progress under the script's rule set.
PULLBACK RISK and STALLED are caution states. They help identify when progress may be weakening after an active move has already started.
🚫 What This Script Is NOT
This script is not a prediction engine.
It is not financial advice.
It is not an auto-trading system.
It does not provide guaranteed signals.
It is not a full position planner, risk/reward visualizer, or position-size calculator.
⚠️ Limitations & Transparency
Timeframe differences can change activation behavior and invalidation proxy placement.
Volatility changes can alter ATR-normalized risk and R-progress readings.
Market structure can shift quickly after news, low-liquidity movement, or aggressive momentum expansion.
The script is rule-based and should be interpreted as an analytical progress layer, not as certainty.
🧠 Market Context Notes
R progress is not only about distance from activation. It also depends on how much progress is being retained, whether trend context still supports the active side, and whether time spent in the setup is becoming inefficient.
The tool is most useful when it helps the user review an active move with discipline instead of reacting emotionally to each candle.
🧾 Use Case Examples
When a trend-pulse activation reaches 1R with strong score conditions and low drawdown, the script may classify the move as PROGRESSING.
When a move reaches 2R but begins giving back a meaningful amount of favorable progress, the script may show PULLBACK RISK.
When a cycle stays active for many bars without reaching useful R progress, the script may show STALLED.
🧱 System Philosophy
R-Multiple Progress Map follows the AGPro Series decision-engine approach:
Progress after activation.
Risk measured in R.
Management context before emotion.
Attention markers instead of promises.
🔐 Non-Promise Statement
No script can guarantee that R progress will continue.
No state should be interpreted as certainty.
All outputs should be reviewed within broader market context.
📉 Risk Disclosure
Trading involves risk.
Users are responsible for their own decisions, risk management, and trade execution.
This script is for educational and analytical purposes only and does not provide financial advice.
📚 Educational Note
The script is designed to help users think in structured R-progress terms: activation, progress, pullback, stall, invalidation, and review.
Indicator

Setup Lifecycle Tracker [AGPro Series]Setup Lifecycle Tracker
🧠 Core Idea
What stage is this setup in right now: forming, armed, triggered, invalidated, or expired?
📌 Overview / What it does
Setup Lifecycle Tracker is a chart-first setup planning tool that follows a developing market structure through a defined lifecycle window.
Instead of showing another isolated signal, it maps the setup stage, trigger rail, invalidation rail, expiry marker, time risk, and a 0-100 lifecycle quality score directly on the chart.
The script does not predict price, automate execution, or tell users what to trade. It organizes setup context so the trader can evaluate whether the setup is still valid, still early, close to activation, already invalidated, or simply too old.
🎯 Purpose & Design Philosophy
This script was built for traders who want a cleaner way to manage setup timing.
Many setups look interesting when they first appear, but they often decay, trigger too late, or lose their invalidation logic before the trader reacts. Setup Lifecycle Tracker fills that gap by turning setup timing into a visible planning structure.
The design philosophy is simple: a setup should have a stage, a deadline, a risk reference, and a clear next-action state. Without those elements, the chart can become another collection of loose signals.
⚡ Why This Script Is Different
Most tools focus on entry markers, setup scores, or generic support and resistance levels.
This script does NOT try to clone a setup scorecard, create a buy/sell system, or build a broad support/resistance map.
Instead, it tracks the lifecycle of one active setup window. It shows whether the setup is forming, armed near the trigger rail, already triggered, invalidated by its risk rail, or expired because too much time has passed.
⚙️ Methodology
1. Context Detection
The script reads trend context, recent range structure, volatility, candle behavior, and volume support to decide whether a clean setup window can be tracked.
2. Reference Mapping
When a setup forms, the script creates a trigger rail, an invalidation rail, and a lifecycle window between them.
3. Reaction Evaluation
The model evaluates setup maturity, trigger proximity, confirmation strength, time decay, and invalidation distance to produce a 0-100 lifecycle score.
4. Visual Output
The active lifecycle window, stage labels, trigger rail, invalidation rail, expiry marker, candle tint, and panel summarize the current state.
🗺️ How to Read the Chart
Zones = the lifecycle window between trigger and invalidation.
Labels = current lifecycle stage and optional score.
Colors = stage context:
• Blue / indigo = forming
• Yellow = armed
• Green = triggered
• Red / pink = invalidated or expired
Panel = the compact AG Pro summary showing Stage, Quality Score, Time Risk, Invalidation, and Action.
🚦 Signals & States
• FORMING → a setup window has been detected but is not yet close enough to the trigger rail.
• ARMED → price is close enough to the trigger rail and the lifecycle score is strong enough to deserve attention.
• TRIGGERED → the tracked setup moved beyond its configured trigger condition.
• INVALIDATED → price crossed the invalidation rail and the setup context is no longer valid.
• EXPIRED → the setup stayed active too long without a useful lifecycle resolution.
🔔 Alerts Logic
The script includes alerts for:
• New lifecycle window forming
• Setup armed near the trigger rail
• Setup triggered
• Setup invalidated
• Setup expired
• High-quality lifecycle threshold reached
Alerts are attention markers only. They are not trade instructions, automated entries, or guaranteed outcome signals.
🧩 Confluence Logic
The lifecycle score becomes stronger when setup maturity, trigger proximity, confirmation strength, time health, and invalidation fit align.
For example, a setup that is mature, close to the trigger rail, supported by directional candle behavior, and not too close to invalidation will generally score better than an old setup with weak confirmation and high time risk.
📊 When to Use
• Breakout preparation
• Pullback continuation planning
• Range compression before expansion
• Setups that need a time limit
• Charts where invalidation needs to stay visible
• Traders who want to separate early setups from late setups
⚠️ When NOT to Use
• Extremely low-liquidity markets
• Charts with unreliable volume and erratic candles
• Very noisy micro timeframes
• Extreme volatility spikes where ATR-based references expand too quickly
• Situations where the user wants a direct buy/sell signal instead of a planning map
🎛️ Key Inputs
• Setup Side → selects automatic, long-side, or short-side lifecycle tracking.
• Trigger Model → controls how the setup moves into TRIGGERED state.
• Setup Lookback → defines the forming range used for trigger and invalidation mapping.
• Sensitivity → changes how strict the lifecycle detection and confirmation logic feels.
• Expiry Bars → controls how long an untriggered setup can stay active.
• Minimum Quality Score → defines the threshold for stronger lifecycle contexts.
• Panel / Label Settings → control panel position, theme, font size, label size, and label density.
🖥️ Interface & Visual Design
The interface is built around a single chart-first lifecycle window.
The panel is intentionally compact. It does not replace the chart; it summarizes the active state so the user can quickly read the setup stage, score, time risk, invalidation, and next context action.
Labels are kept moderate and offset away from candles to preserve readability.
🧪 Practical Usage Workflow
1. Read the panel stage.
2. Check the lifecycle window between trigger and invalidation.
3. Watch whether the setup moves from FORMING to ARMED.
4. Review the trigger rail and invalidation rail.
5. Use the expiry marker to avoid stale setup interpretation.
6. Confirm the broader market context before making any decision.
🔍 Interpretation Guidelines
A high lifecycle score means the current setup context is cleaner according to the script's rule set.
An ARMED state means the setup is close to the trigger area, not that a trade must be taken.
An EXPIRED state means time quality has degraded.
An INVALIDATED state means the tracked setup lost its mapped risk reference.
🚫 What This Script Is NOT
• Not a prediction engine
• Not financial advice
• Not an auto-trading tool
• Not a guaranteed signal system
• Not a generic support/resistance mapper
• Not a clone of Setup Quality Scorecard
⚠️ Limitations & Transparency
Lifecycle windows depend on lookback, ATR behavior, and recent structure.
Different timeframes can produce different setup stages.
High-volatility conditions may expand rails and change score behavior.
Low-liquidity symbols can create unstable ranges and misleading candle structure.
🧠 Market Context Notes
Setup lifecycle quality is strongest when structure, volatility, and timing align.
A setup can be technically visible but still weak if it is too old, too far from the trigger rail, too close to invalidation, or unsupported by confirmation behavior.
🧾 Use Case Examples
When price compresses below a range edge and the lifecycle window turns ARMED, the trader can observe whether the trigger rail is reached before the expiry marker.
When a setup remains FORMING for too long, the time risk row helps identify whether the context is becoming stale.
When price crosses the invalidation rail, the script marks the lifecycle as INVALIDATED so the previous setup is no longer treated as active.
🧱 System Philosophy
AGPro tools are designed to help traders read market context with structure and restraint.
Setup Lifecycle Tracker follows that philosophy by converting setup timing into a visible planning workflow instead of adding another isolated signal marker.
🔐 Non-Promise Statement
No script can provide certainty.
No score, state, label, or alert guarantees future price behavior.
📉 Risk Disclosure
Trading involves risk.
This script is for educational and analytical use only.
It does not provide financial advice, investment advice, or guaranteed trading outcomes.
Users remain responsible for their own decisions, risk management, and position sizing.
📚 Educational Note
The main educational purpose of this script is to help users think in lifecycle stages: setup formation, activation risk, invalidation, time decay, and context review.
Indicator

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

Exit Readiness Planner [AGPro Series]Exit Readiness Planner
🧠 Core Idea
Is the active move showing enough decay to prepare an exit review?
📌 Overview / What it does
Exit Readiness Planner is a chart-first trade management tool built to evaluate whether an active move is losing enough quality to deserve closer review. Its cleanest default use case is 4H swing-management review, where structure, target proximity, and decay are usually easier to read than on very small timeframes.
The script converts momentum decay, candle-efficiency loss, target proximity, volatility contraction, and reversal pressure into a 0-100 Exit Readiness Score. It produces an exit-pressure zone, target and risk-shift rails, exhaustion fade context, compact state labels, alerts, and a clean AGPro panel.
It does not predict price direction, automate exits, or print direct sell commands. Its purpose is to organize exit-review context while the user remains responsible for all decisions.
🎯 Purpose & Design Philosophy
Many traders plan entries carefully but review exits only after momentum has already faded. This script was built to make the exit-review question more structured.
It helps traders who manage active moves and want a cleaner way to monitor whether the move still has room, strength, and volatility support, or whether it is shifting into a review state.
The design supports a management mindset: read the current pressure, check remaining room, review exhaustion, then decide what deserves attention.
⚡ Why This Script Is Different
Most tools focus on take-profit ladders, trailing stops, or direct exit signals.
This script does NOT build a profit-target ladder, a Chandelier Exit clone, a stop-loss optimizer, or a buy/sell command system.
Instead, it asks a narrower decision question: is the active move showing enough decay, target proximity, or risk-shift pressure to prepare an exit review?
⚙️ Methodology
1. Context Detection
The script identifies the active move side using Auto Context, Long Move, or Short Move.
2. Reference Mapping
It maps target-side structure, remaining room, a fast trend reference, and an exit-pressure zone around the active target rail.
3. Reaction Evaluation
The model scores momentum decay, candle-efficiency loss, target proximity, volatility contraction, and reversal pressure.
4. Visual Output
The output appears as a forward exit-pressure zone, exhaustion fade band, compact labels, alert conditions, and a premium AGPro panel.
🗺️ How to Read the Chart
Zones = the forward exit-pressure area near the active target rail.
Labels = clear attention markers such as EXIT REVIEW, EXIT WATCH, TARGET NEAR, RISK SHIFT, or PRESSURE EASED.
Colors = teal suggests calmer monitor context, amber suggests watch or target proximity, pink/red suggests stronger exit-review pressure.
Panel = summarizes Exit Pressure, Remaining Room, Exhaustion State, Risk Shift, and Action.
🚦 Signals & States
• EXIT REVIEW → the score and supporting conditions show stronger decay or pressure.
• EXIT WATCH → review context is developing but is not yet in the stronger review state.
• TARGET NEAR → price is close to the active target-side reference.
• RISK SHIFT → pressure appeared against the active move near the trend reference.
• MONITOR → exit pressure is not strong enough for active review attention.
🔔 Alerts Logic
• Exit Readiness Review → triggers when the planner enters Exit Review state.
• Exit Readiness Watch → triggers when watch context appears.
• Target Near → triggers when price becomes close to the active target rail.
• Risk Shift → triggers when pressure appears against the active move.
• Pressure Eased → triggers when active pressure returns to monitor context.
Alerts are attention markers. They are not trade instructions.
🧩 Confluence Logic
The strongest review context appears when momentum decay, candle-efficiency loss, target proximity, volatility contraction, and reversal pressure align.
When only one factor appears, the state may remain Watch or Monitor. When several factors align, the score can move toward Exit Review.
📊 When to Use
• During active trade management.
• Especially on 4H swing-management charts.
• When price is approaching a target-side reference.
• During trend moves that may be losing momentum.
• After strong directional candles begin to compress.
• On liquid symbols where ATR and pivot references are meaningful.
⚠️ When NOT to Use
• Extremely low-liquidity markets with unreliable candles.
• News spikes where volatility changes too quickly.
• Very noisy micro-timeframes with unstable wick behavior.
• As a standalone reason to close a position.
• When the user has no broader trade plan or risk framework.
🎛️ Key Inputs
• Active Move Side → selects Auto Context, Long Move, or Short Move.
• Sensitivity → controls how quickly decay and pressure affect the score.
• Lookback → defines the structure window for target references and room.
• Exit Review Score → sets the threshold for the stronger review state.
• Exit Watch Score → sets the lower attention threshold.
• Visual Settings → control zones, rails, fade bands, labels, optional move-side prefixes, optional micro markers, panel visibility, theme, location, and font sizes.
🖥️ Interface & Visual Design
The interface is chart-first and built around one primary visual object: the exit-pressure zone.
The panel uses the AGPro publication layout with a single merged blue title row, adjustable location, adjustable theme, and adjustable font size.
Labels use clear full-text state names, offset from candles, and are controlled by cooldown and maximum-visible settings to keep the chart active without becoming crowded. Move-side prefixes and tiny micro markers are available but disabled by default for a cleaner 4H publication preset.
🧪 Practical Usage Workflow
1. Read the panel Action state.
2. Check the Exit Pressure score.
3. Review the remaining room to the active target rail.
4. Compare the exhaustion state with candle behavior.
5. Treat alerts and labels as review prompts, not trade commands.
🔍 Interpretation Guidelines
A high score means the script sees more exit-review pressure according to its rules. It does not mean price must reverse.
Target Near means remaining room is compressed relative to ATR. It does not mean the target must hold.
Risk Shift means pressure appeared against the active move. 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 sell-signal service.
• Not a take-profit ladder.
• Not a trailing-stop strategy.
⚠️ Limitations & Transparency
Exit-readiness behavior depends on the selected lookback, ATR length, target pivot length, sensitivity, timeframe, and market condition.
Low volatility can make target proximity more frequent. High volatility can widen references and delay review states. Small timeframes can produce more frequent state changes.
The script is rule-based and should be read as an analytical management layer inside a broader plan.
🧠 Market Context Notes
An active move can remain valid while still deserving review.
Exit readiness is not the same as bearish or bullish prediction. It is a structured way to notice when the move may be losing quality, nearing a reference, or showing pressure against the active side.
🧾 Use Case Examples
When price approaches the target rail and candle efficiency falls, the planner may move from Monitor to Exit Watch.
When target proximity, momentum decay, and reversal pressure align, the planner may mark Exit Review.
When pressure eases and the move regains quality, the script can return to Monitor.
🧱 System Philosophy
Exit Readiness Planner follows the AGPro decision-engine approach:
Context before reaction.
Review before emotion.
Attention markers instead of commands.
🔐 Non-Promise Statement
No indicator can guarantee continuation, reversal, target behavior, or exit timing.
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 exit-review pressure changes as momentum fades, room compresses, volatility contracts, and pressure appears against the active move.
Indicator

Breakeven Review Planner [AGPro Series]Breakeven Review Planner
🧠 Core Idea
Has the move progressed enough to review breakeven protection, or is the context still too early, weak, or exposed?
📌 Overview / What it does
Breakeven Review Planner is a trade-management overlay designed to evaluate post-activation move progress. Instead of asking users to manually draw a full entry, stop, and take-profit plan, the script detects a qualified directional move, anchors an activation reference, builds a structural invalidation shelf, and measures live R progress from that context.
The output is a clean breakeven review workflow: a BE review zone, activation reference, invalidation shelf, current R reading, trend-support state, pullback-risk state, event labels, alerts, and a premium AGPro panel.
It does not predict price direction, place trades, calculate position size, build a take-profit ladder, or tell users to move a stop. Alerts and labels are attention markers for review context only.
🎯 Purpose & Design Philosophy
This script was built for traders who already manage active moves and need a cleaner way to evaluate whether the move has earned a breakeven review.
The gap it fills is not pre-trade risk/reward planning. AGPro already has tools for that. This script focuses on the management phase after a move is active: progress, structure, trend support, and pullback risk.
The design supports a disciplined review mindset. It helps users read whether the chart has built enough progress to deserve attention without turning that review into an automated instruction.
⚡ Why This Script Is Different
Most risk/reward tools focus on manual entry, stop-loss, targets, position sizing, and breakeven probability.
This script does NOT build a full trade plan, does NOT create TP ladders, and does NOT tell users to move a stop.
Instead, it watches the live chart for a qualified management context, scores the move's progress toward a breakeven review threshold, and keeps the user focused on whether the current structure is strong, weak, stale, or invalidated.
⚙️ Methodology
1. Context Detection
The script detects directional activation when price escapes recent structure with enough ATR-normalized impulse, candle commitment, close-location quality, and trend support.
2. Reference Mapping
After activation, the script anchors an activation reference and builds an invalidation shelf from the latest confirmed swing plus an ATR buffer.
3. Reaction Evaluation
The engine measures current R, best favorable R, trend support, candle quality, volatility fit, and pullback depth after progress.
4. Visual Output
The chart displays the BE review zone, progress fill, context lines, event labels, candle tint, alerts, and the AGPro panel.
🗺️ How to Read the Chart
Zones = the BE review area around the configured R trigger. It is a review zone, not a command.
Labels = context markers such as armed context, progress milestones, BE review, pullback watch, stale context, and invalidation.
Colors = teal for bullish-supported context, pink for bearish or invalid context, amber for caution, and indigo for breakeven review focus.
Panel = the current decision cockpit. It shows Review Score, Current R, BE Trigger, Progress State, Trend Support, and Action.
🚦 Signals & States
• Bull Context Armed → a bullish management context was activated after structure escape.
• Bear Context Armed → a bearish management context was activated after structure escape.
• BE Review Active → current progress reached the configured R threshold for breakeven review.
• Review + Pullback → price reached review progress but has pulled back enough to require closer attention.
• Stale → the context spent too many bars without enough progress.
• Invalidated → price reached the structural invalidation shelf.
🔔 Alerts Logic
Alerts trigger when a new management context activates, the BE review zone is reached, the review quality is high, pullback risk increases after review progress, the invalidation shelf is reached, or the context becomes stale.
Alerts are attention markers. They are not trading instructions, broker actions, or automated stop-management commands.
🧩 Confluence Logic
The strongest review context appears when R progress, trend support, candle close quality, controlled pullback depth, and normal volatility fit align.
When these conditions align, the Review Score rises and the panel state becomes easier to interpret.
📊 When to Use
• Active directional moves after structure expansion
• Trend continuation environments
• Breakout follow-through review
• Trade-management review after favorable progress
• Charts where users want R-style context without a full manual RR planner
⚠️ When NOT to Use
• Very low-liquidity symbols
• Extremely noisy ranges
• News shock candles with distorted ATR behavior
• Non-standard chart types that alter candle structure
• Situations where the user needs exact broker-level stop management
🎛️ Key Inputs
• Sensitivity → changes how quickly or strictly the script activates a management context.
• Structure Lookback → controls the recent structure boundary used for activation.
• BE Review Trigger (R) → sets the R threshold for review-zone activation.
• Invalidation Shelf Buffer ATR → controls how much ATR padding is added beyond the latest swing.
• Pullback Warning Depth (R) → controls when post-review pullback risk is marked.
• Visual settings → control labels, zones, progress fill, line extension, candle tint, and object limits.
• 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 stay active but not crowded. It uses a single review zone, clean context lines, a subtle progress fill, and capped event labels.
Label and panel font sizes are adjustable, with Normal as the default.
🧪 Practical Usage Workflow
1. Read the panel Review Score and Progress State.
2. Check whether price is below, inside, or beyond the BE review zone.
3. Compare Current R with best favorable R to understand whether progress is expanding or pulling back.
4. Confirm whether trend support is still aligned.
5. Treat alerts as review prompts, not as automated trade actions.
🔍 Interpretation Guidelines
A high score means the move has progressed toward the review zone with stronger internal structure according to the script's rules.
A low score means the move is early, weak, stale, pulling back, or structurally invalidated.
The most useful interpretation comes from reading score, state, trend support, and invalidation together instead of relying on a single 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 planner
⚠️ Limitations & Transparency
The activation model is rule-based and depends on recent structure, ATR, candle behavior, and trend filters.
Different timeframes can produce different activation references and invalidation shelves.
Fast volatility expansion can make R progress move quickly, while low volatility can keep contexts stale.
No rule-based tool can know a user's actual broker order, risk tolerance, or execution plan.
🧠 Market Context Notes
Breakeven review is most useful when progress, structure, and volatility are read together.
A move can reach a review zone while still having weak trend support or heavy pullback risk.
The script is designed to keep those differences visible.
🧾 Use Case Examples
When price breaks recent structure, trend support is aligned, and current R approaches the BE review threshold, the panel may shift from Building to Approaching Review.
When current R reaches the configured BE trigger and the score is strong, the script marks the review zone and can trigger a high-quality review alert.
When best favorable R was strong but current R pulls back by the configured amount, the script marks Pullback Watch instead of treating the move as automatically healthy.
🧱 System Philosophy
The AGPro approach is to turn chart information into structured decision context.
This script follows that philosophy by converting move progress into a clean review framework: activation, invalidation, R progress, trend support, pullback risk, and next review state.
🔐 Non-Promise Statement
This script does not provide certainty.
It does not guarantee that a breakeven review will improve trade outcome.
It only organizes the conditions that may make breakeven review context more visible.
📉 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 active moves progress, stall, pull back, or invalidate around a structured management threshold.
Indicator
