Quality

Failed Pullback Reversal Planner [AGPro Series]Failed Pullback Reversal Planner 🧠 Core Idea Did the pullback fail to recover, and is it now creating a reversal-warning context? 📌 Overview / What it does Failed Pullback Reversal Planner is a chart-first reversal risk planner built for one specific situation: a pullback inside an existing trend stops behaving like a healthy retracement and begins losing control. The script maps a failed pullback pocket, control-loss rail, invalidation reference, target-room guide, compact state labels, alerts, and a clean AG Pro panel. It converts pullback depth, failed recovery, close behavior, volume response, and follow-through into a 0-100 Failure Score. It does not predict future price movement, automate entries, or issue guaranteed buy/sell signals. Its role is to organize failed-pullback context into a clearer decision framework. 🎯 Purpose & Design Philosophy This script was built because many pullback tools only focus on continuation quality. They often ask whether the pullback is healthy enough to resume the original trend. Failed Pullback Reversal Planner focuses on the opposite decision layer. It asks whether the pullback failed to recover, lost the control reference, and now deserves reversal-risk review. The design supports traders who want cleaner structure, risk location, target-room context, and next-action guidance without turning every candle into a signal. ⚡ Why This Script Is Different Most tools focus on pullback continuation, moving-average bounces, or generic reversal markers. This script does NOT clone Pullback Acceptance Planner, Low Volume Pullback Zones, Trend Continuation Quality, or a generic reversal signal indicator. Instead, it treats failed pullbacks as a planning problem. Price must first enter a pullback context, then fail recovery around a control rail, then show enough close quality, volume response, and follow-through to raise reversal-risk state. ⚙️ Methodology 1. Context Detection The script identifies former bullish or bearish trend context using fast, base, and slow EMA alignment. 2. Reference Mapping It builds a failed pullback pocket, control-loss rail, invalidation reference, and target-room guide using ATR-normalized logic. 3. Reaction Evaluation It scores pullback depth, failed recovery, close against the former trend, volume response, and nearby follow-through. 4. Visual Output It displays concept-native zones, centered zone labels, compact event labels, guide rails, alerts, and a premium AG Pro planning panel. 🗺️ How to Read the Chart Zones = the failed pullback pocket and reversal-risk zone. Labels = pullback test, control-loss, reversal-risk, or reset markers. Colors = teal shows bullish reversal-risk context, pink shows bearish reversal-risk context, amber shows watch context, red shows control-loss or risk context, and indigo shows reset/recovery context. Panel = a compact decision dashboard showing Pullback State, Failure Score, Reversal Risk, Invalidation, and Action. 🚦 Signals & States • PB TEST → a recent pullback is being monitored for failed-recovery behavior. • CTRL LOST → price has lost the control reference but has not fully qualified the warning state. • REV RISK → failed pullback context has enough score to deserve reversal-risk review. • RESET → optional marker showing that price reclaimed the invalidation reference and the failed-pullback plan should be reset. • NO SETUP → no active failed-pullback context is present. 🔔 Alerts Logic Alerts trigger when the planner detects a monitored failed-pullback setup, a reversal-risk warning, invalidation/reset behavior, or meaningful follow-through after control loss. Alerts are attention markers only. They are not trade instructions. 🧩 Confluence Logic The strongest failed-pullback context appears when pullback depth is meaningful, price loses the control rail, the candle closes against the former trend, volume supports the shift, and follow-through begins beyond nearby structure. When these components align, the Failure Score rises and the panel moves from watch context toward reversal-risk review. 📊 When to Use • Trend pullbacks that start losing recovery quality • Potential reversal transitions after a failed retracement • Markets where a prior trend is weakening around a control reference • Situations where invalidation and target-room context matter ⚠️ When NOT to Use • Very low liquidity markets • Extremely noisy sideways conditions • News-driven volatility spikes • Markets with no clean prior trend context • Symbols where volume behavior is unreliable 🎛️ Key Inputs • Sensitivity → controls how strict the failed-pullback model is. • Former Trend Side → restricts evaluation to bullish-trend or bearish-trend failures when needed. • Failure Window Bars → defines how long after a pullback touch control-loss behavior can qualify. • Control-Loss Buffer ATR → adjusts the rail used to mark failed recovery. • Invalidation Buffer ATR → controls the reset reference beyond the fast trend anchor. • Label and Panel Settings → control panel location, theme, font size, label size, label spacing, and visible label count. 🖥️ Interface & Visual Design The interface is built around a clean AG Pro decision panel and chart-first planning visuals. The first panel row uses the AG Pro merged blue header standard with only the script name. The remaining rows focus on the active decision: pullback state, failure score, reversal risk, invalidation, and action. The chart uses a focused failed pullback pocket, a reversal-risk zone, guide rails, and compact labels. The goal is a premium planning view without crowded generic signals. 🧪 Practical Usage Workflow 1. Read the panel state. 2. Check whether a pullback test is active. 3. Watch whether price loses the control rail. 4. Review the Failure Score and reversal-risk label. 5. Compare the invalidation reference and target-room guide before interpreting the context. 🔍 Interpretation Guidelines Think in terms of failed recovery quality, not prediction. A higher Failure Score means the current pullback has stronger failed-recovery characteristics across depth, control loss, close behavior, volume, and follow-through. A control-loss state means the setup is weakening but may still need more confirmation. A reset state means the failed-pullback idea has been reclaimed and should be reassessed. 🚫 What This Script Is NOT • Not a prediction engine • Not financial advice • Not auto trading • Not guaranteed signals • Not a generic pullback continuation indicator ⚠️ Limitations & Transparency • Timeframe differences can change how pullback depth and failure windows appear. • High volatility can distort ATR-normalized rails. • Low-volume instruments may reduce the reliability of the volume component. • Sideways markets can create repeated failed-pullback noise. • Outputs should be interpreted with broader market structure. 🧠 Market Context Notes Failed pullbacks often matter when a market was expected to recover in the direction of the prior trend but instead loses the control reference. The script does not assume that every failed recovery becomes a full reversal. It simply marks when the context is strong enough to deserve review. 🧾 Use Case Examples When a bullish trend pulls back toward the fast/base EMA area, fails to recover, and closes below the control rail with stronger participation, the planner may raise bearish reversal-risk context. When a bearish trend pulls back upward, fails to reject lower, and closes above the control rail with follow-through, the planner may raise bullish reversal-risk context. 🧱 System Philosophy The script is built around decision quality. It does not try to add another signal layer. It asks whether a specific market behavior is valid, how strong it is, where it is invalidated, and what should be reviewed next. 🔐 Non-Promise Statement No guarantees. No certainty. The script organizes observable market behavior into a structured analytical view. 📉 Risk Disclosure Trading involves risk. Users are responsible for their own analysis, risk management, and decisions. This script does not provide financial advice or guaranteed trading outcomes. 📚 Educational Note Use the planner as an educational framework for studying failed pullbacks, recovery quality, control loss, and reversal-risk context.

Indicator

Expansion Failure Planner [AGPro Series]Expansion Failure Planner 🧠 Core Idea Did volatility expansion create real travel, or did it fail back inside the prior structure? 📌 Overview / What it does Expansion Failure Planner is a public-free PulseWire indicator built to evaluate failed volatility expansion attempts. It detects when price expands beyond a recent range edge, then tracks whether the move produces meaningful travel or quickly loses the edge. The script produces a failed expansion corridor, expansion-edge guide, risk shelf, return-to-range target guide, compact state labels, alerts, and a clean AG Pro planning panel. It does not predict future price direction or automate trade decisions. 🎯 Purpose & Design Philosophy This script was built for traders who do not only want to see that volatility expanded. They want to know whether the expansion still has quality, whether failure risk is rising, and what context should be reviewed next. The design supports a decision-first workflow: identify the expansion attempt, measure failure risk, review target room, and decide whether the context deserves attention. ⚡ Why This Script Is Different Most volatility tools focus on expansion, squeeze release, or breakout continuation. This script does NOT act as a generic breakout signal, generic S/R zone, or continuation-only volatility map. Instead, it focuses on one narrow question: did the expansion fail before producing real travel? ⚙️ Methodology 1. Context Detection The script defines a prior range and watches for a volatility expansion attempt beyond that range edge. 2. Reference Mapping It stores the expansion edge, expansion extreme, prior range midpoint, and return-to-range target area. 3. Reaction Evaluation The planner scores failed travel using ATR expansion, close-back-inside behavior, missing follow-through, volume response, and range re-entry quality. 4. Visual Output It draws the failed expansion corridor, expansion edge, risk shelf, return target, compact labels, and a premium AG Pro panel. 🗺️ How to Read the Chart Zones = the failed expansion corridor between the original edge and the expansion extreme. Labels = expansion attempts, failure-ready states, watch states, hold states, and reset context. Colors = teal for upside expansion attempts, pink for downside expansion attempts, yellow for watch context, and indigo for edge/hold review. Panel = the preferred viewing timeframe, current expansion state, 0-100 failure risk, reclaim status, target room, and next action. 🚦 Signals & States • UP EXP / DN EXP → a volatility expansion attempt has been detected. • UP FAIL / DN FAIL → the expansion failed back inside the prior structure with enough score. • WATCH → failure risk is developing but confirmation is incomplete. • HOLD → expansion is still holding beyond the edge. • RESET / NO FAIL → the active failure window expired or real travel invalidated the failure context. 🔔 Alerts Logic Alerts trigger when expansion failure reaches ready status, when watch context develops, when expansion holds beyond the edge, or when the failure window resets. Alerts are attention markers only. They are not trade instructions. 🧩 Confluence Logic The strongest context appears when ATR expansion, edge loss, missing follow-through, range re-entry, and participation align. When these components agree, the failure risk score increases. 📊 When to Use • After volatility expansion attempts • Around range-edge probes • During breakout failure review • When a move expands but does not travel • When price quickly returns inside prior structure ⚠️ When NOT to Use • Extremely low-liquidity symbols • Very noisy micro ranges • News-driven candles with abnormal gaps • Markets where volume data is unreliable • Charts where the prior range is not structurally meaningful 🎛️ Key Inputs • Sensitivity → changes how strict the failure model is. • Prior Range Lookback → defines the structure used for expansion reference. • Expansion Bar ATR → controls how large a candle must be to qualify. • Required Real Travel ATR → defines how much progress the expansion should produce. • Confirmation Mode → controls close/volume/strict confirmation. • Visual Settings → control corridor, guides, labels, projection, and label size. • Panel Settings → control panel visibility, location, theme, font size, and best-viewed timeframe guidance. 🖥️ Interface & Visual Design The panel is designed as a compact planning cockpit. The first row uses the AGPro merged blue header standard, while the remaining rows show best-viewed timeframe guidance, state, score, reclaim status, target room, and action. The visual hierarchy keeps the chart readable: one active corridor, clear guide lines, and controlled labels. 🧪 Practical Usage Workflow 1. Read the panel state. 2. Check whether price is above or below the expansion edge. 3. Review the failed expansion corridor. 4. Compare failure risk with target room. 5. Use alerts as attention markers, not decisions. 🔍 Interpretation Guidelines Think in terms of failed travel, not prediction. A high score means the script detected stronger failure characteristics. A low score means expansion may still be holding, or failure evidence is not strong enough. 🚫 What This Script Is NOT • Not a prediction engine • Not financial advice • Not auto trading • Not guaranteed signals • Not a generic breakout indicator • Not a generic support/resistance zone map ⚠️ Limitations & Transparency • Timeframe differences can change expansion and failure structure. • Volatility spikes can distort ATR-based scoring. • Volume quality varies by market. • Fast markets can move beyond the corridor before confirmation. • Outputs should be interpreted within broader market context. 🧠 Market Context Notes Expansion failure often matters when volatility appears strong but cannot create distance. This script focuses on that transition point between momentum attempt and failed travel. 🧾 Use Case Examples When price expands above a range, stalls quickly, closes back inside the edge, and fails to build distance, the planner can mark an upside expansion failure. When price expands below a range, loses downside follow-through, and re-enters the structure, the planner can mark a downside expansion failure. 🧱 System Philosophy AGPro tools are built to reduce chart ambiguity by turning raw market events into structured decision context. 🔐 Non-Promise Statement No indicator can provide certainty. This script provides rule-based context only. 📉 Risk Disclosure Trading involves risk. Users are responsible for their own decisions. This script does not provide financial advice or guaranteed trading outcomes. 📚 Educational Note Use the script as a structured learning and review tool for expansion failure behavior, failed travel, and volatility response.

Indicator

Momentum Pullback Continuation [AGPro Series]Momentum Pullback Continuation 🧠 Core Idea Is a momentum pullback resetting cleanly for continuation, or is the move losing its execution quality? 📌 Overview / What it does Momentum Pullback Continuation is a chart-first continuation planner built for traders who review momentum-driven trends after a controlled pullback. The script maps a momentum reset pocket, continuation trigger line, invalidation rail, target-room corridor, state labels, alerts, and a clean AGPro planning panel. It converts trend support, momentum slope, pullback depth, close recovery, volume behavior, and target room into a 0-100 Continuation Score. The default publication preset is 1H-focused. Higher timeframes can be tested from the inputs, but the strongest intended use case is hourly momentum pullback review. It does not predict price, automate entries, or turn every trend pullback into a signal. It is a structured decision tool for evaluating whether the current momentum reset deserves closer review. 🎯 Purpose & Design Philosophy This script was built to fill the gap between basic momentum readings and practical continuation planning. Many traders can see that momentum exists, but the harder question is whether the pullback is resetting in a controlled way or damaging the continuation structure. This planner focuses on that decision layer. The design supports a disciplined workflow: identify the active momentum side, inspect the reset pocket, evaluate the score, locate the invalidation rail, compare target room, and read the next-action state. ⚡ Why This Script Is Different Most tools focus on momentum oscillators, moving-average direction, divergence events, or generic continuation labels. This script does NOT clone Hidden Divergence Continuation Zones, Trend Continuation Quality, Structural Momentum Oscillator, ROC Momentum Shift Map, or a generic pullback signal map. Instead, it treats the pullback as a planning event. The main output is not a buy/sell marker. It is a momentum reset decision state with score, risk edge, target-room context, and action guidance. ⚙️ Methodology 1. Context Detection The script identifies bullish or bearish momentum context using an EMA stack, normalized trend slope, and smoothed rate-of-change pressure. 2. Reference Mapping It builds a concept-native Momentum Reset Pocket around the active trend support area, then maps a continuation trigger line, invalidation rail, and target-room guide. 3. Reaction Evaluation The score model evaluates momentum slope, pullback depth, trend support, close recovery, volume behavior, and available target room. 4. Visual Output The chart shows the reset pocket, target-room corridor, trigger and risk guides, compact event labels, sparse context labels, alerts, and a premium AGPro panel. 🗺️ How to Read the Chart Reset Pocket = the area where a momentum pullback is expected to stabilize before continuation can be reviewed. Trigger Line = the fast continuation reference that price needs to recover after the reset. Invalidation Rail = the planning line where the active reset context is considered lost. Target-Room Corridor = the forward planning area between current price and the target-room guide. Labels = RESET, WATCH, READY, WEAK, and INVALID attention markers. Colors = teal marks bullish continuation context, pink marks bearish continuation context, amber marks weak or caution states, indigo marks watch/target-room context, and red marks invalidation. Panel = summarizes Momentum State, Pullback Quality, Continuation Score, Risk Edge, and Action. 🚦 Signals & States • RESET → price has interacted with the momentum reset pocket. • WATCH → the reset is developing, but recovery or score quality is not complete. • READY → momentum, pullback depth, recovery, volume context, and target room align strongly enough for structured review. • WEAK → the pullback is too deep, low quality, or not recovering well enough. • INVALID → price has crossed the invalidation rail and the active reset context should be rebuilt. 🔔 Alerts Logic Alerts trigger when READY, WATCH, WEAK RESET, or INVALID states appear. Each alert is an attention marker tied to the rule-based state engine. Alerts are not trade instructions and do not guarantee that continuation will occur. 🧩 Confluence Logic The continuation context becomes stronger when trend support, positive momentum slope, controlled pullback depth, clean close recovery, acceptable volume behavior, and target-room availability align. The script intentionally requires multiple conditions instead of labeling every pullback inside a trend as meaningful. 📊 When to Use • Directional markets with visible momentum pressure • 1H charts and nearby intraday momentum review • Trend continuation review workflows • Pullbacks after a clear momentum impulse • Situations where risk edge and target room matter before acting • Markets where volume and close behavior are readable enough to support context ⚠️ When NOT to Use • Low-liquidity symbols with unreliable candles or volume • Extremely choppy markets with frequent trend-side flips • News-driven volatility where reset structure changes too quickly • Very flat markets where momentum pressure is absent • Instruments where the active pullback is far beyond the mapped risk edge 🎛️ Key Inputs • Continuation Side → selects Auto, Bullish Only, or Bearish Only evaluation. • Timeframe Profile → keeps the default script behavior focused on 1H charts, with optional broader intraday or all-timeframe testing. • Sensitivity → adjusts how strict the momentum reset model is. • EMA settings → define trigger, reset, and support references. • Momentum ROC settings → control the internal momentum pressure reading. • Reset Pocket Width → changes how wide the reset area is around trend support. • READY / WATCH Score → sets state thresholds. • Visual settings → control zones, guide lines, labels, panel theme, panel location, and font sizes. 🖥️ Interface & Visual Design The interface is designed to stay chart-first and practical. The reset pocket and target-room corridor provide the main visual planning structure. Labels are compact and spaced with cooldown controls. The AGPro panel uses a single merged blue header row and focuses only on the core decision fields. 🧪 Practical Usage Workflow 1. Read the panel Momentum State. 2. Check whether price is interacting with the Momentum Reset Pocket. 3. Compare Pullback Quality and Continuation Score. 4. Locate the Risk Edge and Target-Room Corridor. 5. Use the Action row to decide whether the context is READY, still WATCH, weak, invalid, or only worth scanning. 🔍 Interpretation Guidelines Think of the script as a continuation readiness map, not a command system. A higher score means the active momentum pullback matches the script's internal definition of cleaner continuation structure. A lower score means one or more components are missing, such as trend support, recovery quality, volume context, or target room. The invalidation rail is a planning boundary for the active context. It is not a guaranteed stop level and should not replace the user's own risk process. 🚫 What This Script Is NOT This script is not a prediction engine. This script is not financial advice. This script is not an auto-trading system. This script does not provide guaranteed signals. This script does not replace independent confirmation, position sizing, or risk management. ⚠️ Limitations & Transparency Momentum continuation behavior changes across symbols, sessions, and timeframes. The default 1H Focus profile intentionally suppresses active labels, zones, and alerts outside the intended hourly review window. Low-liquidity markets can distort volume behavior and reset quality. High volatility can widen risk edges and reduce target-room clarity. Sideways conditions can create repeated resets without clean continuation. No rule-based script can fully account for sudden news, spread changes, slippage, or discretionary execution constraints. 🧠 Market Context Notes Momentum pullbacks are often more useful when the broader trend remains intact, the pullback is controlled rather than impulsive against trend, and the recovery candle shows clear close quality. The best reads usually come from alignment between structure, momentum, volume, volatility, and clean forward room. 🧾 Use Case Examples When price pulls into the reset pocket during bullish momentum and then recovers the trigger line with a stronger score, the script can mark READY for continuation review. When price enters the pocket but momentum slope fades and pullback depth becomes excessive, the script can mark WEAK RESET. When price crosses the invalidation rail, the active reset context is treated as lost and should be rebuilt. 🧱 System Philosophy AGPro tools are built around structured interpretation. The goal is not to create more chart noise. The goal is to turn visible market behavior into a cleaner decision framework: context, quality, risk, target room, and next action. 🔐 Non-Promise Statement No script can provide certainty. No score guarantees continuation. The output should be interpreted as structured context, not as a promise of future price movement. 📉 Risk Disclosure Trading involves risk. Users are responsible for their own analysis, confirmation, position sizing, 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 momentum resets behave across different symbols and timeframes. Over time, compare READY, WATCH, WEAK RESET, and INVALID states to understand which environments produce cleaner continuation structure.

Indicator

Volatility Cooldown Planner [AGPro Series]Volatility Cooldown Planner 🧠 Core Idea Has volatility cooled down enough to read the chart again? 📌 Overview / What it does Volatility Cooldown Planner is a chart-first volatility risk and readiness tool built for the period after a sharp ATR spike, wide-range candle, or large wick event. Instead of printing another directional signal, the script asks whether the market is still unstable, cooling, ready for review, or readable again. It produces a spike box, a forward cooldown band, spike rails, unsafe volatility warnings, readiness labels, alerts, and a clean AGPro planning panel. The script does not predict news events, identify hidden catalysts, automate decisions, or tell users what to buy or sell. Its role is to organize post-spike volatility context into a readable decision workflow. 🎯 Purpose & Design Philosophy This script was built for traders who often face the same problem after sudden volatility: the chart is active, but not always readable. Many tools focus on volatility expansion, squeeze release, regime classification, or breakout confirmation. Those can be useful, but they do not always answer the practical question that appears after a spike: should the trader keep reading this structure now, or wait until volatility load normalizes? The design philosophy is simple: after unstable volatility, the first decision is not direction. The first decision is whether the chart is clean enough to evaluate. ⚡ Why This Script Is Different Most volatility tools focus on detecting expansion, squeeze release, high ATR regimes, or dramatic candles. This script does NOT try to detect news events, does not clone a volatility expansion planner, does not act as a stop-run model, and does not classify broad volatility cycles. Instead, it studies the cooling process after the spike. The main output is a 0-100 Cooldown Score and a next-action state that separates UNSAFE, TOO EARLY, COOLING, READINESS REVIEW, and CHART READABLE conditions. ⚙️ Methodology 1. Spike Detection The engine identifies spike context using ATR Load, single-bar range expansion, and dominant wick size. 2. Cooldown Mapping When a spike appears, the script draws a spike box and a forward cooldown band. The band becomes the active review area for post-spike readability. 3. Readiness Evaluation The model scores ATR load normalization, range contraction, time decay, close-to-close stability, and wick pressure. 4. Visual Output The planner displays the active state through labels, rails, band color, alert conditions, and a compact AGPro panel. 🗺️ How to Read the Chart Spike Box = the original volatility shock area. Cooldown Band = the forward review window where the script evaluates whether volatility is becoming readable again. Spike Rails = the upper and lower reference boundaries from the spike event. They are volatility context rails, not entry or stop instructions. Readability Trail = an optional lightweight dot layer for users who want extra chart presence between major labels. It is disabled by default for a cleaner publication preset. Unsafe Label = volatility has reloaded before cooldown completed. Ready / Readable Labels = the cooldown score has reached a stronger review state. Panel = a compact decision view showing Spike State, Cooldown Score, Volatility Load, Readiness, Action, and Best View. 🚦 Signals & States • SPIKE → a new volatility shock has been registered. • UNSAFE → volatility reloaded before the cooldown process became stable. • TOO EARLY → not enough bars have passed after the spike. • COOLING → volatility is improving, but readiness is not strong enough yet. • READINESS REVIEW → conditions are strong enough to review the chart again. • CHART READABLE → ATR load has normalized and the cooldown score is strong. 🔔 Alerts Logic Volatility Spike Registered triggers when ATR load, range expansion, or wick pressure qualifies as a spike event. Unsafe Volatility Reload triggers when volatility expands again during the active cooldown window. Cooldown Readiness Review triggers when the cooldown score reaches the readiness threshold. Chart Readable After Cooldown triggers when volatility load and cooldown quality both reach the strongest readable state. Alerts are attention markers, not trade instructions. 🧩 Confluence Logic The strongest cooldown state appears when multiple conditions align: ATR load falls toward the target area, recent ranges contract, close-to-close movement stabilizes, wick pressure fades, and enough time has passed after the spike. When these conditions align, the chart becomes more readable under the script's rules. This does not create certainty or directional prediction. 📊 When to Use • After sharp ATR spikes • After wide-range candles • After large wick events • After fast liquidation-style movement • During post-event stabilization • When the chart feels too unstable to interpret cleanly • Best visual fit: 4H charts and intraday-swing volatility review • Daily charts can work for broader context, but they may look more sparse because fewer cooldown events appear ⚠️ When NOT to Use • Very low-liquidity markets • Illiquid sessions with unreliable candle structure • Extreme news volatility where conditions keep changing quickly • Symbols with irregular gaps or poor feed quality • As a standalone directional entry system 🎛️ Key Inputs • Sensitivity → controls how demanding spike detection is. • ATR Length → normalizes spike size and label offsets. • ATR Baseline Length → defines the local volatility baseline. • Cooldown Review Window → controls how long the spike remains under review. • Cooldown Target ATR Load → defines the internal volatility load target for readability. • Readiness Score Threshold → defines when the panel can mark readiness review. • Visual settings → control spike boxes, cooldown bands, rails, markers, and background warnings. • Readability Trail → optional subtle chart presence during active cooldown or elevated volatility. • Label and Panel Font Size → control chart labels and panel readability. 🖥️ Interface & Visual Design The interface is designed to stay chart-first. The spike box explains where the instability started. The cooldown band shows the active review window. The centered band label gives the current state without forcing the user into a lower-pane dashboard. The default visual preset keeps the chart calmer by hiding standalone spike event labels, sparse context labels, label scores, readable-upgrade follow-up labels, and the optional readability trail. Users can enable those layers when they want a denser visual review. The AGPro panel follows the public-release standard with one merged blue header row containing only the panel title. The remaining rows focus on decision context rather than raw data overload, including a Best View row that points users toward the 4H chart when needed. 🧪 Practical Usage Workflow 1. Read the panel Readiness and Action fields. 2. Start with a 4H chart when preparing a visual review or publication screenshot. 3. Check whether the chart is still inside an active cooldown band. 4. Watch Volatility Load and Cooldown Score. 5. Treat UNSAFE as a warning that the chart may still be unstable. 6. Treat READINESS REVIEW or CHART READABLE as a prompt to evaluate broader structure, not as an automatic trade command. 🔍 Interpretation Guidelines A high cooldown score means volatility has normalized under the script's rule set. It does not mean price must continue, reverse, or respect the spike rails. The best use is as a readability filter after unstable movement. It helps the trader decide whether the market is still too hot, cooling, or clean enough to study again. 🚫 What This Script Is NOT • Not a prediction engine • Not financial advice • Not auto trading • Not guaranteed signals • Not a news-event detector • Not a volatility expansion breakout tool • Not a stop-run or liquidity-sweep model ⚠️ Limitations & Transparency This script uses standard PulseWire OHLCV data and ATR-based measurements. It cannot identify the real-world cause of volatility. It cannot know whether a spike came from news, liquidation, session flow, thin liquidity, or normal order flow. Timeframe selection, symbol liquidity, session structure, and volatility regime can affect how quickly cooldown states appear. The default preset is visually best suited to 4H charts; lower timeframes may require stricter inputs, while Daily charts may naturally show fewer events. 🧠 Market Context Notes Volatility often becomes hardest to interpret immediately after a sharp event. Some spikes create clean follow-through. Others create unstable noise, whipsaw, or delayed normalization. This planner focuses on the cooling process, not the directional outcome. 🧾 Use Case Examples When a wide candle appears and the panel shows UNSAFE, the trader can wait for volatility load to normalize before interpreting follow-through. When a spike box remains active but the score rises into READINESS REVIEW, the trader can compare the cooldown band with broader structure, trend, liquidity, and personal execution rules. When the panel reaches CHART READABLE, the market is no longer classified as overheated by the script, but the user still needs independent context. 🧱 System Philosophy AGPro tools are designed to convert market structure into decision context. This script follows that philosophy by turning post-spike volatility into a readable workflow: identify the shock, monitor the cooldown, evaluate the readiness state, and avoid treating every fast move as immediately actionable. 🔐 Non-Promise Statement No script can remove uncertainty. No cooldown state guarantees that the next move will be clean. The output is a structured analytical context, not certainty. 📉 Risk Disclosure Trading involves risk. Users are responsible for their own analysis, risk management, and decisions. This script is for educational and analytical use only and does not provide financial advice. 📚 Educational Note Use the planner to study how volatility behaves after spikes, how long different symbols take to normalize, and how readability changes across timeframes.

Indicator

Failed Reclaim Planner [AGPro Series]Failed Reclaim Planner 🧠 Core Idea Did price lose a visible swing shelf, retest it, and fail to reclaim that level with enough rejection quality, risk clarity, and continuation room to matter? 📌 Overview / What it does Failed Reclaim Planner is a chart-first failed reclaim decision engine built around visible swing shelves. The script identifies when price breaks a confirmed swing high or swing low shelf, watches the retest of that broken level, and evaluates whether the reclaim attempt fails with enough rejection quality to become meaningful context. It produces visible shelf zones, failed reclaim pockets, BULL / BEAR quality labels, planning room bands, risk / target guides, and a compact AGPro panel with a 0-100 failure score, rejection quality, room, and next-action state. This script does not predict price direction or automate execution. It is designed to organize reclaim-failure context so traders can review structure, risk, and room more clearly. 🎯 Purpose & Design Philosophy The script was built for traders who want more than another signal marker. Most reclaim tools show whether price crossed a level. Failed Reclaim Planner focuses on the decision process after a visible shelf breaks: was the retest valid, did the reclaim fail, how strong was the rejection, where is invalidation, and is there enough room for the idea to matter? The design supports a planning mindset: identify the broken shelf, wait for the retest, evaluate the failed reclaim, check room, and then decide whether the context deserves attention. ⚡ Why This Script Is Different Most tools focus on fixed references such as VWAP, moving averages, prior-day levels, or broad support/resistance zones. This script does NOT act as a generic S/R scanner, VWAP reclaim indicator, EMA reclaim map, previous-day sweep tool, or liquidity sweep engine. Instead, it focuses on one narrow workflow: failed reclaim planning after a visible swing shelf breaks. The reference level is visible on the chart, the failure pocket is mapped, the rejection is scored, and the panel summarizes the next action. ⚙️ Methodology 1. Swing Shelf Detection The script confirms visible swing highs and swing lows using left/right pivot structure. 2. Shelf Break Activation When price closes beyond a confirmed shelf with enough ATR-adjusted separation, that shelf becomes an active reclaim reference. 3. Retest and Failure Evaluation During the retest window, the script checks whether price returns into the shelf area and then rejects the reclaim. The failure score evaluates retest depth, close rejection, wick quality, volume participation, follow-through, and continuation room. 4. Planning Output Qualified events create a scored BULL / BEAR label, a failed reclaim pocket, planning room band, invalidation guide, target-room guide, and panel state. 🗺️ How to Read the Chart Shelf Zones = visible broken swing shelves that price may attempt to reclaim. Failure Pockets = highlighted reclaim-failure areas where the retest rejected the broken shelf. Planning Room Bands = projected continuation room after a qualified failed reclaim. These are planning references, not targets or promises. Score Labels = compact BULL / BEAR labels showing the failure quality score. Risk / Target Guides = dashed and dotted reference lines that help locate invalidation and continuation room. Panel = the decision layer showing Reclaim State, Failure Score, Rejection Quality, Room, and Action. 🚦 Signals & States • UP SHELF → a visible swing high was broken and is now monitored as a reclaim shelf. • DN SHELF → a visible swing low was broken and is now monitored as a reclaim shelf. • Bear Failure Active → bearish failed reclaim context is active after a broken shelf retest. • Bull Failure Active → bullish failed reclaim context is active after a broken shelf retest. • Failure Score → 0-100 quality score for the reclaim failure. • Rejection Quality → how cleanly price rejected the reclaim attempt. • Room → ATR-based continuation space available from the failure context. • Action → the current planning state shown in plain language. 🔔 Alerts Logic Alerts are available for: • Bearish Failed Reclaim • Bullish Failed Reclaim • New Broken Shelf • Shelf Recovered Alerts are attention markers. They are not trade instructions, automation signals, or guaranteed outcomes. 🧩 Confluence Logic The context becomes stronger when several conditions align: • A visible swing shelf has already broken • Price retests the broken shelf • The reclaim attempt fails with wick and close rejection • Participation is not weak • There is still continuation room beyond the failed reclaim When these elements align, the script treats the event as a stronger planning context. 📊 When to Use • After clear swing highs or swing lows have broken • During retests of broken structure • In trending or transitioning markets where reclaim failure can matter • When you want risk, invalidation, and room mapped visually • When you prefer decision support over raw signal spam ⚠️ When NOT to Use • Very low-liquidity charts • Extremely noisy sideways chop • News-driven spikes where ATR behavior becomes distorted • Markets with poor swing structure • Situations where you specifically need VWAP, session, or moving-average reclaim logic 🎛️ Key Inputs • Sensitivity → adjusts how quickly the script reacts to shelf breaks and failures. • Swing Left Bars / Swing Right Bars → define how visible swing shelves are confirmed. • Retest Window Bars → controls how long a broken shelf remains active for reclaim evaluation. • Minimum Failure Score → sets the quality threshold for confirmed failed reclaim events. • Shelf Buffer ATR → controls the thickness of the reclaim shelf zone. • Target Room ATR Multiple → controls fallback room projection when nearby structure is limited. • Show Planning Room Band → displays the continuation room corridor after qualified failed reclaim events. • Visual Memory Bars → controls how long historical zones, labels, and guide objects remain visible. • Panel / Label Settings → control panel location, theme, visibility, and font size. 🖥️ Interface & Visual Design The interface is designed to look like a planning tool, not a crowded signal overlay. The chart carries the core story: shelf break, retest, failed reclaim pocket, score label, planning room, and risk / target references. The panel uses the AGPro public-release standard: one merged blue header row containing only the script name. The rest of the panel summarizes the current decision state without covering the chart. 🧪 Practical Usage Workflow 1. Read the panel state. 2. Check whether a visible shelf is active or already failed. 3. Review the failed reclaim pocket and BULL / BEAR score label. 4. Compare the rejection quality with the planning room band. 5. Use risk / target guides as context references. 6. Interpret the output within broader market structure. 🔍 Interpretation Guidelines A higher Failure Score means the reclaim failure is cleaner under the script's rules. It does not guarantee continuation. Rejection Quality helps distinguish weak shelf touches from stronger failed reclaim behavior. Room shows whether there is enough practical continuation space for the context to matter. The Action row is the main planning summary. It is designed to guide review, not replace trader judgment. 🚫 What This Script Is NOT • Not a prediction engine • Not financial advice • Not auto trading • Not guaranteed signals • Not a VWAP reclaim tool • Not an EMA reclaim map • Not a previous-day sweep reclaim script • Not a generic support/resistance scanner ⚠️ Limitations & Transparency Different timeframes can produce different shelves because swing structure changes with timeframe. Volatility changes can affect shelf width, label spacing, and room projections. Low-volume conditions may weaken the reliability of wick and participation components. Sideways markets may create repeated shelf tests that require extra discretion. 🧠 Market Context Notes Failed reclaim behavior often becomes important when price loses a visible structural shelf and cannot regain that area on the retest. This is different from a successful reclaim, liquidity sweep, VWAP reclaim, or moving-average retest. The script is intentionally narrow so the chart remains focused on one decision workflow. 🧾 Use Case Examples Example 1: Price breaks below a confirmed swing low, retests that shelf from underneath, leaves rejection, and fails to reclaim. A BEAR score label appears with a failure pocket and planning room. Example 2: Price breaks above a confirmed swing high, retests the broken shelf, holds above it, and rejects back upward. A BULL score label appears with risk and room context. 🧱 System Philosophy Failed Reclaim Planner follows the AGPro decision-engine approach: Do not just show another signal. Show the reference. Score the failure. Map the risk. Map the room. Summarize the next action. 🔐 Non-Promise Statement No script provides certainty. No failed reclaim guarantees continuation. Outputs should be interpreted as structured analytical context, not as a promise of future price behavior. 📉 Risk Disclosure Trading involves risk. Users are responsible for their own decisions, position sizing, execution, and risk management. This script does not provide financial advice, investment advice, or guaranteed trading outcomes. 📚 Educational Note Use this script to study how broken swing shelves behave when price attempts to reclaim them. The strongest value comes from comparing the shelf zone, failure pocket, score label, planning room, and panel state with broader market structure and your own rules.

Indicator

Continuation Acceptance Planner [AGPro Series]Continuation Acceptance Planner 🧠 Core Idea Is this continuation setup being accepted, delayed, or invalidated before the next decision point? 📌 Overview / What it does Continuation Acceptance Planner is a chart-first continuation planning tool built to evaluate whether a pullback inside an active trend is producing real acceptance or only temporary hesitation. The script builds a live continuation acceptance band around a trend base, scores the context from 0 to 100, maps the invalidation rail, checks target room against the nearest obstruction, and prints compact state labels such as ACCEPTED, DELAYED, PAUSED, WATCH, and INVALID. It does not predict future price movement, automate entries, or produce guaranteed trade signals. Its role is to organize continuation context into a cleaner decision framework. 🎯 Purpose & Design Philosophy This script was built for traders who want to judge continuation quality without turning every trend pullback into a signal. Most continuation tools focus on bounce detection or trend strength only. This planner focuses on the decision layer: acceptance quality, pullback risk, target room, invalidation context, and the next action state. The design supports a patient execution mindset. It helps the user ask whether the continuation is actually being accepted, still delayed, temporarily paused, too extended, or losing validity. ⚡ Why This Script Is Different Most tools focus on generic trend continuation signals after a moving average touch or pullback bounce. This script does NOT act as a simple buy/sell continuation indicator, and it does not clone a broad trend-continuation quality scanner. Instead, it treats continuation as a planning problem: price must interact with an acceptance band, show a quality close, maintain enough room before obstruction, and stay above or below a clear invalidation rail. ⚙️ Methodology 1. Context Detection The script identifies bullish or bearish continuation context using fast, base, and slow EMA alignment plus trend slope. 2. Reference Mapping It creates a continuation acceptance band around the base EMA and maps the invalidation rail using the band edge, slow EMA, and ATR buffer. 3. Reaction Evaluation It evaluates pullback depth, close acceptance, volume support, and whether price is delaying, accepting, extending, or moving toward invalidation. 4. Visual Output The script displays a centered acceptance-band label, invalidation and target guides, compact state labels, and a premium AG Pro planning panel. 🗺️ How to Read the Chart Zones = the live continuation acceptance band around the trend base. Labels = accepted, delayed, invalidation, or watch-state markers with optional 0-100 score. Colors = bullish continuation context uses teal, bearish continuation context uses pink, delayed context uses amber, and risk or invalidation context uses red. Panel = a compact decision dashboard showing Continuation Score, Acceptance, Pullback Risk, Target Room, and Action. 🚦 Signals & States • ACCEPTED → continuation context has a qualified acceptance close and enough score to review. • DELAYED → price is interacting with the acceptance band but has not produced enough clean acceptance. • PAUSED → the prior continuation side still matters, but the trend stack needs to rebuild before the setup becomes clean again. • WATCH → continuation context exists, but the setup still needs clearer reaction. • EXTENDED → price is away from the acceptance band and may be late for clean continuation planning. • INVALID RISK → price is moving beyond the planner's invalidation rail. 🔔 Alerts Logic Alerts trigger when continuation acceptance, delayed acceptance, invalidation risk, or blocked target room conditions appear. Alerts are attention markers only. They are not trade instructions and should be interpreted with the broader chart context. 🧩 Confluence Logic The strongest continuation context appears when trend alignment, controlled pullback depth, close acceptance, volume support, and clean target room align. When these components align, the continuation score improves and the panel moves toward a clearer planning state. 📊 When to Use • Primary timeframe: 1H • Secondary timeframe: 4H • Trending markets with structured pullbacks • Continuation setups after a controlled pause • Pullbacks into a moving trend base • Situations where target room and invalidation clarity matter ⚠️ When NOT to Use • When expecting dense signals on 1D or 1W charts • Very low liquidity environments • Extremely noisy sideways conditions • High-volatility shock moves where trend anchors distort quickly • Markets with no clean trend alignment 🎛️ Key Inputs • Sensitivity → changes how strict the acceptance engine is. • Target Obstruction Lookback → defines the prior obstruction used for target-room evaluation. • Acceptance Band Width ATR → controls the width of the continuation band. • Confirmation Mode → defines whether acceptance requires close behavior only, close plus volume, or stricter alignment. • Label and Panel Settings → control visual density, font size, panel location, and theme. 🖥️ Interface & Visual Design The panel is designed as a compact planning dashboard, not a data-heavy scanner. The first row follows the AG Pro blue merged-header standard. The remaining rows focus only on the information needed for continuation planning: score, acceptance, pullback risk, target room, and action. Chart visuals are intentionally controlled so the acceptance band, invalidation rail, target guide, and labels remain readable. 🧪 Practical Usage Workflow 1. Read the panel state. 2. Check whether price is interacting with the acceptance band. 3. Review the continuation score and pullback risk. 4. Compare target room with the invalidation rail. 5. Use labels and alerts as attention markers, not as automatic decisions. 🔍 Interpretation Guidelines Think in terms of setup quality, not prediction. A higher score means the current continuation context has stronger alignment across trend, pullback depth, close behavior, volume, and target room. A delayed state means the idea is not necessarily invalid, but the chart has not yet produced clean acceptance. A paused state means the prior continuation context is still nearby, but alignment weakened enough that patience matters more than chasing. An invalidation-risk state means the continuation structure should be reassessed. 🚫 What This Script Is NOT • Not a prediction engine • Not financial advice • Not an auto-trading system • Not a guaranteed signal generator • Not a generic support/resistance or order-block map • Not a gap continuation planner or breakout acceptance planner ⚠️ Limitations & Transparency Timeframe differences can change how continuation bands and target-room references appear. Volatility expansion can move the acceptance band and invalidation rail quickly. Low-volume or synthetic symbols may reduce the usefulness of the volume component. All outputs are rule-based and should be interpreted within broader market context. 🧠 Market Context Notes Continuation planning depends on trend structure, liquidity, volatility, and obstruction distance. The cleanest cases usually appear when pullbacks are controlled, the acceptance close is clear, and the next obstruction is not too close. In the current public-release tuning, the script reads cleanest on 1H charts and remains usable on 4H. Daily and weekly charts can still provide context, but they are less expressive for the intended acceptance-versus-delay workflow. 🧾 Use Case Examples When price pulls back into the acceptance band during a bullish trend and closes back above the base EMA with sufficient target room, the planner may shift toward ACCEPTED. When price stays inside the band without a clean close, the planner may remain DELAYED. When price closes beyond the invalidation rail, the planner flags INVALID RISK. 🧱 System Philosophy The script follows the AGProLabs decision-engine approach: a useful public tool should help traders evaluate validity, strength, risk, target room, and the next action state. It is built to guide interpretation, not to replace trader judgment. 🔐 Non-Promise Statement No script can provide certainty. No output from this script guarantees continuation, reversal, profit, or loss avoidance. 📉 Risk Disclosure Trading involves risk. Users are responsible for their own decisions. This script does not provide financial advice and should be used only as an educational and analytical tool. 📚 Educational Note Use the planner to study how continuation acceptance develops across different symbols, sessions, volatility regimes, and timeframes.

Indicator

Asterion Regime Lattice [JOAT]Asterion Regime Lattice Introduction Asterion Regime Lattice is an open-source market regime oscillator designed to classify whether conditions are directional, transitional, or balanced by combining multiple independent measurements into one continuous score. Instead of relying on a single trend indicator, it evaluates trend displacement, momentum, volatility behavior, directional movement, efficiency, choppiness, entropy, and higher-timeframe confirmation. The problem this script solves is regime ambiguity. Many entries fail because traders apply trend logic in rotational conditions or mean-reversion logic in expanding directional phases. Asterion Regime Lattice provides a higher-level state model first, so any downstream tool can be interpreted in the proper context. The pane output uses layered lattice bands, a smoothed score curve, regime shading, and a compact dashboard to make the current state readable at a glance without covering price. Core Concepts 1. Composite Regime Scoring The script builds a regime score from several independent components rather than one oscillator. It measures fast/slow trend displacement, momentum direction, volatility expansion, directional movement, efficiency ratio, choppiness, Shannon entropy, fractal dimension, RSI state, and ADX-derived trend strength. Each component is normalized, weighted, and added into a single signed score where positive values indicate bullish expansion and negative values indicate bearish expansion. 2. Higher-Timeframe Confirmation Two higher timeframes are requested with `request.security()` using `lookahead = barmerge.lookahead_off`. This keeps the script non-repainting while allowing the current timeframe to compare itself against broader directional conditions. The higher-timeframe pack contributes trend bias, momentum bias, volatility bias, directional movement bias, slope, ROC, and ADX strength. = request.security(syminfo.tickerid, htfOne, f_htfPack(), lookahead = barmerge.lookahead_off) 3. Structure Quality and Noise Separation The script uses efficiency, choppiness, entropy, and fractal-dimension style measurements to separate clean directional movement from noisy rotation. That matters because two markets can have similar momentum but very different trade quality. Asterion does not only ask "is price moving?" It also asks whether the move is organized enough to treat as a real regime. 4. Lattice Bands and Regime Zones The oscillator uses inner and outer bands around the smoothed score curve to display soft and strong regime zones. When the score pushes beyond soft thresholds the state becomes directional. When it pushes through stronger thresholds with quality and higher-timeframe agreement, the state becomes more decisive. This layered presentation makes the transition from balance to expansion visible before and during the full move. 5. Confirmed State Transitions Alerts and state changes are only confirmed on closed bars. This keeps the script suitable for live use and avoids intrabar state flips being treated as final. Features Composite regime score: Blends trend, momentum, volatility, efficiency, entropy, fractal behavior, RSI, and DMI/ADX context Dual higher-timeframe confirmation: Uses two configurable timeframes with `lookahead_off` Trend quality layer: Separates clean directional movement from noisy or choppy conditions Inner and outer lattice bands: Visualize soft and strong directional zones Pane regime shading: Background tint shifts with the current market state Optional bar tinting: Can color price bars by current regime while keeping the oscillator in a separate pane Dashboard summary: Reports regime, quality, HTF alignment, volatility, momentum, efficiency, entropy, and directional state Confirmed-bar alerts: Bull, bear, soft bull, soft bear, and transition events trigger only after bar confirmation Input Parameters Core: Fast Length and Slow Length: Trend displacement backbone Momentum Length and Trend Slope Length: Speed and directional persistence measurements Structure Length, Volume Length, Volatility Length: Core normalization windows Efficiency Length, Choppiness Length, Entropy Length, Entropy Bins, Fractal Length: Noise and organization diagnostics RSI Length and ADX Length: Directional strength and internal pressure inputs Higher-Timeframe Confirmation: Primary HTF and Secondary HTF Strong ADX and Weak ADX thresholds Visuals: Pane shading toggle Lattice band toggle Score curve toggle Bar tint toggle Curve smoothing and band multipliers How to Use This Indicator Step 1: Read the Regime Row Start with the Regime row in the dashboard and the position of the score relative to the soft and hard thresholds. This tells you whether the market is directional, balanced, or in transition. Step 2: Check Quality Before Acting A high-magnitude regime score with weak quality is less reliable than a slightly smaller score with strong quality. Use the Quality row to decide whether the move is organized enough to trust. Step 3: Compare With Higher Timeframes The HTF row helps determine whether the current timeframe is aligned with the broader backdrop or fighting it. Stronger follow-through usually appears when local and higher-timeframe states agree. Step 4: Use It as a Context Filter Asterion is best used as a regime filter. Trend systems generally perform better when the oscillator is directional and quality is strong. Mean-reversion logic is generally more appropriate when the score is near balance and noise metrics dominate. Indicator Limitations The script is a classifier, not a predictive model. It describes current conditions; it does not forecast future direction Higher-timeframe confirmation can lag turning points because those bars must close before their state is final In low-range grinding markets, the oscillator can remain transitional for extended periods Any weighted composite reflects design choices; different markets may require threshold adjustments Originality Statement Asterion Regime Lattice is original in the way it combines directional scoring, higher-timeframe agreement, and multiple noise-quality measurements into one structured regime model. It is not a simple trend oscillator with a new color scheme. The script is built around the idea that regime is a blend of direction, organization, and alignment across timeframes, and its lattice presentation is designed to make those layers visible rather than hiding them behind a single line. Disclaimer This script is provided for educational and informational purposes only. It is not financial advice and does not guarantee any outcome. Regime measurements are based on historical price and volume behavior and can produce false or delayed readings, especially during sudden event-driven changes in market conditions. Always use independent judgment and risk management.

Indicator

by officialjackofalltrades

Structure Retest Planner [AGPro Series]Structure Retest Planner 🧠 Core Idea Is the active structure retest being accepted, rejected, or invalidated? 📌 Overview / What it does Structure Retest Planner is a structure-based trade planning overlay designed to help traders evaluate how price behaves when it returns to an important swing-derived structure rail. The script maps the active support-side or resistance-side rail, draws a focused retest box around that rail, scores the retest from 0-100, and projects practical invalidation and target guides. The goal is to organize the retest decision process: structure state, score, acceptance, invalidation, and next action. It does not predict the next move, does not automate trading, and does not turn every swing point into a generic support/resistance signal. It is a decision-support planner for reading acceptance and rejection around a live structure retest. 🎯 Purpose & Design Philosophy This script was built for traders who use price structure but need a cleaner way to judge whether a retest deserves attention. Most structure tools identify levels, breaks, or swing labels. Structure Retest Planner focuses on the next decision after a rail is present: is price responding cleanly enough, is invalidation nearby, and what should be reviewed next? The design supports a planning mindset rather than a signal-chasing mindset. It is meant to make the chart easier to interpret while keeping the trader responsible for context and risk. ⚡ Why This Script Is Different Most tools focus on plotting structure breaks, BOS / CHoCH labels, or broad support and resistance zones. This script does NOT clone a BOS / CHoCH detector and does NOT duplicate a first-break retest grader. Instead, it treats the active structure rail as a planning reference and evaluates acceptance, rejection, volatility fit, trend agreement, invalidation distance, and next-action state in one workflow. ⚙️ Methodology 1. Context Detection The script confirms swing-derived structure rails using pivot logic and identifies whether the active planning side is support retest, resistance retest, or automatic nearest-rail context. 2. Reference Mapping It draws a retest box around the active rail, plus an invalidation shelf and target guide. These are planning references, not guaranteed outcomes. 3. Reaction Evaluation The 0-100 score combines level origin quality, retest response, close location, volatility fit, and trend agreement. 4. Visual Output The script shows a centered retest-box label, compact event labels, rail/invalidation/target guides, alerts, and a premium AG Pro panel. 🗺️ How to Read the Chart Zones = the active retest box around the selected structure rail. Labels = watch, accepted, rejected, invalidated, or risk-review states with optional score and grade. Colors = teal for support-side acceptance, pink for resistance-side or rejection pressure, yellow for review states, and indigo for planning context. Panel = structure state, retest score, acceptance state, invalidation shelf, and next action. 🚦 Signals & States • Retest Watch → price is close enough to the active rail and the score is improving. • Accepted → price tested the rail and closed constructively on the expected side. • Ready → acceptance is active and the score reached the ready threshold. • Rejected → price tested the rail but did not show clean acceptance. • Invalidated → price closed beyond the invalidation shelf. • Risk Review → retest behavior exists, but volatility is too hot for clean reading. 🔔 Alerts Logic Alerts trigger when the script detects a new watch state, accepted retest, high-quality retest review, rejected retest, or invalidation shelf break. Alerts are attention markers. They are not trade instructions and should always be interpreted with broader market context. 🧩 Confluence Logic The score improves when the active rail has a cleaner structural origin, price reacts near the rail, the close lands on the expected side, volatility is not overheated, and trend context agrees with the retest side. When these factors align, the retest context becomes easier to review. When they conflict, the panel shifts toward waiting, context confirmation, risk review, or reset. 📊 When to Use • Pullbacks toward confirmed swing structure • Trend continuation retests • Resistance retests after bearish structure pressure • Support retests after bullish structure pressure • Markets where structure rails are visible and not excessively noisy ⚠️ When NOT to Use • Very low-liquidity symbols • Extremely noisy sideways markets • News-driven volatility spikes • Markets where pivot structure is too compressed to provide useful rails • Any situation where the user expects automated entry or exit instructions 🎛️ Key Inputs • Retest Side → selects Auto, Support Retest, or Resistance Retest. • Structure Pivot Length → controls how structure rails are confirmed. • Sensitivity → changes retest-box width and activation behavior. • Retest Ready Score → sets the minimum score for stronger review states. • Invalidation Shelf ATR → adjusts the planning invalidation reference. • Target Guide R Multiple → projects the forward target guide from planning risk. • Label and Panel Font Size → controls visual readability. • Panel Location and Theme → adjusts interface placement and style. 🖥️ Interface & Visual Design The panel is built as a compact planning dashboard with one merged blue AG Pro header row and five decision rows. The chart visuals are intentionally restrained: one active retest box, centered box text, structure rail, invalidation shelf, target guide, and controlled labels. The design goal is to make the active retest decision readable without turning the chart into a dense support/resistance map. 🧪 Practical Usage Workflow 1. Read the panel to identify the active structure state. 2. Check whether price is approaching or testing the retest box. 3. Review the retest score and acceptance state. 4. Compare the invalidation shelf and target guide. 5. Use your own broader context before making any decision. 🔍 Interpretation Guidelines A higher score means the retest is cleaner within the script's rule set. It does not mean price must continue. Acceptance means the bar closed constructively relative to the rail. Rejection means the rail is not holding cleanly. Invalidation means the planning reference has been crossed and the setup should be reviewed again. Use the script to organize thinking, not to outsource judgment. 🚫 What This Script Is NOT • Not a prediction engine • Not financial advice • Not auto trading • Not guaranteed signals • Not a BOS / CHoCH auto detector • Not a generic support/resistance zone map ⚠️ Limitations & Transparency The script uses pivot-based structure, so rails appear only after pivots are confirmed. Timeframe choice, volatility, liquidity, and symbol behavior can materially change how retests appear. Fast markets may pass through a rail before the retest can be evaluated cleanly. Sideways markets may create repeated low-quality tests. 🧠 Market Context Notes Structure retests are easier to interpret when liquidity, trend context, and volatility are aligned. A clean rail is not enough on its own. The reaction, close location, invalidation distance, and broader environment all matter. 🧾 Use Case Examples When price returns to a prior support rail and closes back above it with a strong lower wick, the planner may shift from watch to accepted if the score is high enough. When price tests resistance but closes back below the rail with volatility under control, the planner may mark a cleaner resistance-side review state. When price closes beyond the invalidation shelf, the planner marks the context as invalidated and the plan should be reset. 🧱 System Philosophy Structure Retest Planner is part of the AGPro Series decision-engine direction: tools should help traders answer what is valid, how strong it is, where risk is, and what should be reviewed next. 🔐 Non-Promise Statement No signal from this script guarantees continuation, reversal, or profit. The output is a structured analytical read, not certainty. 📉 Risk Disclosure Trading involves risk. Users are responsible for their own analysis, risk management, and decisions. This script does not provide financial advice and does not guarantee trading outcomes. 📚 Educational Note Use the planner to study how structure retests behave across symbols and timeframes, especially how acceptance, rejection, volatility, and invalidation interact.

Indicator

Swing Retest Quality [AGPro Series]Swing Retest Quality 🧠 Core Idea Is the active swing retest clean enough to treat as valid context, or is the pullback too weak, too deep, or too hard to plan? 📌 Overview / What it does Swing Retest Quality is a chart-first swing retest planner built to evaluate pullbacks into an active swing leg. The script maps a focused swing retest pocket, defense line, target-room zone, compact labels, deterministic alerts, and a clean AGPro panel. It converts swing clarity, retest depth, wick rejection, close response, and volume support into a 0-100 Retest Quality score. It does not predict future price movement, automate entries, print buy/sell commands, or replace broader market context. Its purpose is to help traders judge whether a swing retest has enough structure to deserve attention. 🎯 Purpose & Design Philosophy This script was built for traders who evaluate pullbacks, retests, and continuation structure but want a more disciplined way to judge retest quality. Many tools show structure levels or retest markers without answering the practical planning question: is this retest clean, defended, and readable enough to review? The design philosophy is simple: a retest is not useful just because price touches a level. It becomes useful when the swing reference is clear, the pullback depth is controlled, the response is readable, and risk/target context can be mapped. ⚡ Why This Script Is Different Most tools focus on support/resistance touches, break-and-retest markers, BOS/CHOCH events, or broad supply/demand zones. This script does NOT clone Break-Retest Quality, does not require a structure break first, does not map order blocks, does not create a generic S/R zone map, and does not become a broad swing scanner. Instead, it evaluates one active swing leg and asks whether the pullback into that swing has enough quality to be treated as valid context. The main output is not a trade command. It is a planner state: VALID RETEST, WATCH, DEFENSE REVIEW, LOST, or WAIT. ⚙️ Methodology 1. Context Detection The script detects confirmed swing highs and lows, then identifies the active bull or bear swing leg. 2. Reference Mapping It builds a concept-native retest pocket inside the active swing, adds a defense line behind the swing origin, and projects a target-room zone toward the swing terminal. 3. Reaction Evaluation The model scores swing clarity, retest depth, wick rejection, close response, and optional volume support. 4. Visual Output The result is displayed through a centered retest pocket, centered target-room zone, defense guide, swing leg, compact labels, alerts, and a premium AGPro panel. 🗺️ How to Read the Chart Zones = the retest pocket shows where a pullback into the active swing leg is being evaluated. The target-room zone shows the available room back toward the swing terminal or extension guide. Labels = compact event labels mark pocket tests, hold retests, watch states, room reviews, and defense-loss events. Colors = teal marks cleaner bull-side retest context, pink marks bear-side or lost-defense context, amber marks caution/review, and indigo marks watch/transition context. Panel = the panel summarizes Retest Quality, Swing Side, Defense State, Risk Room, and Action. 🚦 Signals & States • VALID RETEST → the active swing retest is holding with enough quality and room for review. • WATCH → the retest context is improving, but confirmation is incomplete. • DEFENSE REVIEW → price has tested the pocket, but quality, response, or room is not strong enough. • LOST → price has crossed the defense line and the swing context should be rebuilt. • WAIT → no active swing retest context is strong enough yet. 🔔 Alerts Logic Alerts trigger when price touches the swing retest pocket, when a valid swing retest appears, when a watch state appears, when target room becomes limited, and when the defense line is lost. These alerts are attention markers only. They are not trade instructions, entry signals, or automated strategy commands. 🧩 Confluence Logic The strongest context appears when a clear swing leg is followed by a controlled retest depth, visible wick rejection, a constructive close response, supportive relative volume, and enough target room relative to the defense line. When these components align, the Retest Quality score improves and the state can move from WATCH to VALID RETEST. 📊 When to Use • During pullbacks inside a clear directional swing • When price is retesting a prior swing leg rather than breaking a new structure level • When planning continuation context around a readable defense line • When comparing whether a pullback is clean enough to monitor or too weak to trust • On liquid symbols where pivots, candles, and volume behavior are readable ⚠️ When NOT to Use • Very low-liquidity symbols with irregular candles • Extremely noisy micro-timeframes • News-driven spikes where swing structure becomes distorted • Markets where volume is unreliable and should not affect scoring • Situations where the user expects a signal-only entry tool 🎛️ Key Inputs • Swing Pivot Length → controls how confirmed swing highs and lows are detected. • Max Swing Age → controls how long a swing leg remains active. • Shallow / Deep Pocket Depth → controls the retest pocket inside the swing leg. • Ideal Retest Depth → defines the preferred pullback depth for stronger scoring. • Defense Buffer ATR → controls the defense line behind the swing origin. • Minimum Target Room ATR → defines how much room is preferred before VALID state. • Label and Panel Font Size → controls chart labels, centered zone text, and panel readability. 🖥️ Interface & Visual Design The interface is designed to stay chart-first. The retest pocket gives the main visual story. The defense line defines where the swing context becomes weak. The target-room zone shows whether the pullback still has practical room to evaluate. The AGPro panel uses a merged blue title row and a compact decision hierarchy so the user can read state, quality, risk, and next action quickly. 🧪 Practical Usage Workflow 1. Read the panel state and Retest Quality score. 2. Check whether price has touched the swing retest pocket. 3. Review the defense line and target-room zone. 4. Evaluate whether the label says HOLD, WATCH, ROOM REVIEW, or DEFENSE LOST. 5. Compare the retest with broader trend, liquidity, volatility, and timeframe context. 🔍 Interpretation Guidelines Think in terms of retest quality, not prediction. A stronger score means multiple structural conditions are aligned. A weaker score means the swing may be unclear, the pullback may be too shallow or too deep, the response may be weak, or target room may be limited. The script helps organize the review process. It does not decide for the user. 🚫 What This Script Is NOT • Not a prediction engine • Not financial advice • Not an auto-trading system • Not a guaranteed signal tool • Not a Break-Retest Quality clone • Not a BOS/CHOCH scanner • Not a generic support/resistance zone map • Not a supply/demand, order block, or FVG map ⚠️ Limitations & Transparency • Pivot-based swing references depend on the selected Swing Pivot Length. • Scores can vary across symbols, sessions, and timeframes. • Volume support depends on exchange-provided volume data. • Fast, news-driven movement can distort retest depth and defense readings. • In Live Updating mode, active-bar values can change before the bar closes. 🧠 Market Context Notes Swing retests are most useful when the broader chart has readable structure. Liquidity, volatility, trend maturity, and higher-timeframe context can all affect whether a retest should be treated as meaningful. The script provides a structured review layer, not a complete trading system. 🧾 Use Case Examples When a bull swing is clear and price pulls back into the retest pocket, a HOLD RETEST label with a strong score indicates that the pullback response is clean enough to review. When price touches the pocket but target room is too limited, ROOM REVIEW highlights that the structure may be readable but planning space is constrained. When price crosses the defense line, DEFENSE LOST indicates that the active swing context should be rebuilt. 🧱 System Philosophy Swing Retest Quality follows the AGPro decision-engine approach: map the context, score the quality, show the risk reference, show the target room, and summarize the next action without issuing trade commands. 🔐 Non-Promise Statement No indicator can provide certainty. The script does not guarantee that a retest will hold, continue, reverse, or produce any specific outcome. 📉 Risk Disclosure Trading involves risk. Users are responsible for their own analysis, risk management, and trading decisions. This script is provided for educational and analytical purposes only and does not constitute financial advice. 📚 Educational Note Use the script as a structured retest-review framework. The best results come from combining the panel, zones, labels, and alerts with broader chart context and disciplined risk evaluation.

Indicator

Reaction Follow-Through Planner [AGPro Series]Reaction Follow-Through Planner 🧠 Core Idea Did the first reaction actually create follow-through, or did price only bounce and fade? 📌 Overview / What it does Reaction Follow-Through Planner is a decision-oriented overlay that evaluates what happens after price produces an initial reaction around a confirmed swing reference. Instead of only marking the reaction itself, the script opens a structured follow-through window, measures progress, tracks defense of the reaction zone, defines invalidation, estimates target room, and converts the context into a 0-100 planner score. It produces reaction zones, follow-through tracks, continuation markers, failed-reaction labels, risk/target guide lines, and a compact AGPro panel. It does not predict future price, place trades, automate execution, or claim that any reaction must continue. 🎯 Purpose & Design Philosophy This script was built for traders who already understand that a reaction candle is not enough. Many charts show a wick, bounce, rejection, hold, or local response, but the real question comes after that first response: did the market follow through with clean progress, participation, and defended invalidation? The design philosophy is simple: treat reaction analysis as a planning workflow. The script helps organize the reaction into strength, follow-through, invalidation, room, and next action. ⚡ Why This Script Is Different Most reaction tools focus on finding the reaction candle, drawing the level, or scoring the first response. This script does NOT clone a rejection-block detector, a support/resistance reaction map, or a generic pivot reaction score. Instead, it starts after the first reaction appears. It tracks whether that reaction can defend its zone, produce directional progress, maintain follow-through, and offer enough room before the context becomes stale or failed. ⚙️ Methodology 1. Context Detection The engine tracks confirmed swing reaction references and waits for price to interact with them. 2. Reference Mapping When the first response is accepted, the script builds a reaction zone from the first response candle and defines an invalidation edge beyond the defended area. 3. Reaction Evaluation The script grades the initial reaction candle using close defense, wick defense, body participation, and direction agreement. 4. Follow-Through Tracking During the tracking window, the model measures best directional progress, next-bar response, volume support, adverse excursion, time decay, and whether the invalidation edge remains defended. 5. Visual Output The chart displays reaction zones, follow-through tracks, target room, invalidation guides, continuation markers, failed-reaction labels, and a clean AGPro planner panel. 🗺️ How to Read the Chart Zones = the defended first-reaction area that should remain intact for the follow-through case to stay valid. Follow-through track = the movement path from the reaction close toward the current follow-through position. Invalidation guide = the price edge where the reaction context is considered failed by the script logic. Target room guide = the nearby structure or ATR-based room estimate used to judge whether the reaction still has space. Labels = optional reaction start markers, follow-through continuation, or failed-reaction context. Start labels and failed-reaction X markers are disabled by default, while failed-reaction labels use a separate low cap for a cleaner publication view. Colors = teal for bullish reaction continuation, pink for bearish reaction continuation, gold for weak or stalled contexts, and indigo for higher-quality follow-through. Panel = the current reaction strength, follow-through state, invalidation level, room estimate, and next action. 🚦 Signals & States • Bull Reaction Watch → a bullish reaction window is active, but follow-through still needs progress. • Bear Reaction Watch → a bearish reaction window is active, but follow-through still needs progress. • Bull Follow-Through → bullish follow-through reached the planner threshold. • Bear Follow-Through → bearish follow-through reached the planner threshold. • No Follow-Through → the reaction stayed defended but did not generate enough progress inside the tracking window. • Failed Reaction → price closed beyond the reaction invalidation edge. 🔔 Alerts Logic Alerts are attention markers, not trade instructions. New Bull Reaction Window triggers when a bullish first-response window opens. New Bear Reaction Window triggers when a bearish first-response window opens. Bull Follow-Through Ready triggers when bullish follow-through reaches the score and progress thresholds. Bear Follow-Through Ready triggers when bearish follow-through reaches the score and progress thresholds. Reaction Failed triggers when price closes beyond the active invalidation edge. 🧩 Confluence Logic The strongest context appears when reaction strength, next-bar progress, volume response, wick defense, and room all align. When the reaction candle is strong but follow-through is weak, the panel will usually remain in watch or no-follow-through mode. When follow-through progresses but invalidation is too close or room is limited, interpretation should stay cautious. 📊 When to Use • After a visible reaction from a swing high or swing low reference. • During retest, hold, rejection, or continuation planning. • When you want to separate first-response reactions from reactions that actually continue. • On symbols and timeframes with enough liquidity for clean candle structure. ⚠️ When NOT to Use • Extremely low-liquidity markets where reaction candles are unreliable. • Very noisy micro timeframes with erratic wicks. • News-driven volatility where invalidation and room can shift quickly. • Situations where the user expects automatic entries or guaranteed outcomes. 🎛️ Key Inputs • Swing Reaction Lookback → controls how selective the reaction references are. • First Response Mode → controls how strict the first reaction filter is. • Follow-Through Track Bars → controls how long the script evaluates continuation after the reaction. • Minimum Planner Score → sets the threshold for continuation-ready context. • Invalidation Buffer → controls how far beyond the reaction zone the invalidation edge sits. • Fallback Target Room → estimates room when no clean opposite structure is nearby. • Visual settings → control zones, optional start labels, outcome labels, failed-reaction label cap, optional failed markers, guides, density, and panel layout. 🖥️ Interface & Visual Design The interface is built around a clean AGPro panel and chart-first visuals. The panel gives the decision summary. The chart shows the defended reaction zone, follow-through track, invalidation edge, target room, and state labels. The visual hierarchy is intentionally restrained: enough labels to make the chart alive, but not so many that the reaction workflow becomes noisy. 🧪 Practical Usage Workflow 1. Read the panel to see whether a reaction window is active. 2. Check the reaction zone and invalidation edge. 3. Watch whether the follow-through track expands away from the zone. 4. Compare the score with available target room. 5. Treat alerts as review prompts, not execution commands. 🔍 Interpretation Guidelines A strong reaction is not automatically a strong follow-through. A clean follow-through usually needs directional progress, defended invalidation, supportive participation, and enough remaining room. If the panel says No Follow-Through, the reaction may still be interesting visually, but the script did not detect enough post-reaction continuation quality. If the panel says Failed Reaction, the original reaction context is no longer valid according to the script rules. 🚫 What This Script Is NOT • Not a prediction engine. • Not financial advice. • Not auto trading. • Not guaranteed signals. • Not a replacement for risk management. • Not a generic support/resistance map. • Not a rejection-block scanner. ⚠️ Limitations & Transparency The script is rule-based and depends on confirmed swing references, ATR normalization, volume baselines, and selected sensitivity settings. Different timeframes can produce different reaction windows. High volatility can expand invalidation distance and reduce room quality. Low-liquidity markets can create misleading wick behavior. 🧠 Market Context Notes Reaction follow-through is strongest when the first response is supported by participation and clean progress away from the defended zone. It is weaker when price reacts but stalls near the zone, repeatedly revisits invalidation, or lacks target room. The script is designed to help traders think in terms of reaction quality, not certainty. 🧾 Use Case Examples When price reacts from a swing low and the next bars defend the reaction zone with rising progress, the planner may shift from Bull Reaction Watch to Bull Follow-Through. When price rejects a swing high but immediately reclaims the invalidation edge, the planner may mark Failed Reaction. When price bounces but fails to expand before the tracking window expires, the panel may show No Follow-Through. 🧱 System Philosophy The AGPro approach favors decision engines over simple signal indicators. This script follows that philosophy by turning a reaction into a structured review process: strength, follow-through, invalidation, room, and action. 🔐 Non-Promise Statement No score guarantees continuation. No alert confirms a profitable outcome. No visual state should be treated as certainty. 📉 Risk Disclosure Trading involves risk. Users are responsible for their own decisions, risk management, position sizing, and market interpretation. This script is for educational and analytical purposes only and does not provide financial advice. 📚 Educational Note Use this script to study how reactions behave after the first response. The goal is to improve interpretation discipline, not to replace a complete trading plan.

Indicator

Candle Expansion Readiness [AGPro Series]Candle Expansion Readiness 🧠 Core Idea Is the current candle expansion meaningful enough to monitor, or is it only a noisy wide candle? 📌 Overview / What it does Candle Expansion Readiness is a chart-first candle quality planner built to evaluate whether an active expansion candle has enough structure to deserve attention. Instead of treating every wide candle as important, the script studies body efficiency, wick control, relative volume, ATR-normalized expansion, recent range behavior, and close location. These components are converted into a 0-100 Expansion Readiness Score with a clear state: READY, WATCH, FADE RISK, or WAIT. The script produces expansion candle labels, a forward follow-through box, risk edge, target guide, failure/fade states, alerts, and a clean AGPro planning panel. It does not predict future price movement, automate decisions, or guarantee that an expansion candle will continue. 🎯 Purpose & Design Philosophy This script was built for traders who want a cleaner way to judge expansion candles before reacting to them. The gap it fills is practical: many candle tools mark a candle after it appears, but they do not explain whether that candle is efficient, supported, close-positioned, and monitorable. Candle Expansion Readiness turns that moment into a structured planning question. The design supports a decision-first workflow: read the candle quality, check whether follow-through is developing, identify the risk edge, and decide whether the context deserves more attention. ⚡ Why This Script Is Different Most tools focus on large candles, volume spikes, engulfing patterns, institutional candle labels, or general breakout signals. This script does NOT clone Institutional Candle Detector, does not classify candles into institutional taxonomies, does not build an absorption system, and does not act as a generic breakout-volume tool. Instead, it evaluates the current expansion candle as a readiness event. The output is not a trade command. It is a planning state that helps users separate monitorable expansion from weak, noisy, or fading candle behavior. ⚙️ Methodology 1. Context Detection The script reads the active candle side from candle direction and close behavior, or lets the user force bullish or bearish readiness mode. 2. Reference Mapping It maps the expansion candle, risk edge, follow-through window, and target guide. 3. Reaction Evaluation The model scores body efficiency, wick control, relative volume, ATR expansion, recent range expansion, and directional close location. 4. Visual Output The result appears through compact labels, candle glow, a forward follow-through box, risk edge, target guide, deterministic alerts, and the AGPro planning panel. 🗺️ How to Read the Chart Zones = the follow-through box shows the monitored area from the expansion risk edge toward the target guide. Its label is centered inside the box. Labels = compact markers show READY, WATCH, DOWNGRADE, CONFIRMED, INVALID, or FADED context. Colors = green highlights stronger bullish readiness or confirmation, pink highlights bearish or invalidated context, amber highlights caution, and indigo highlights watch behavior. Panel = the panel summarizes Candle Efficiency, Volume Support, Expansion Score, Follow-Through, and Action. 🚦 Signals & States • READY → candle expansion quality is strong enough to monitor. • WATCH → candle quality is improving but confirmation is incomplete. • FADE RISK → the candle expanded, but wick or close behavior is weak. • CONFIRMED → follow-through reached the active target guide. • INVALIDATED → price crossed the active risk edge. • FADED → the follow-through window expired without confirmation. • WAIT → no strong enough expansion context is active. 🔔 Alerts Logic Alerts trigger when the planner enters READY state, downgrades from READY or WATCH, crosses the active risk edge, confirms at the target guide, or fades after the follow-through window. These alerts are attention markers only. They are not trade instructions, entry signals, or automated strategy commands. 🧩 Confluence Logic The readiness state becomes stronger when body efficiency, close location, relative volume, ATR expansion, and wick control align on the same candle. When those elements align and the follow-through box remains active without risk-edge violation, the candle context becomes cleaner. When the score is high but follow-through fails, the planner intentionally downgrades the context instead of ignoring the failure. 📊 When to Use • Active intraday or swing charts where candle expansion matters. • Breakout attempts where candle quality needs review. • Continuation moves that require follow-through monitoring. • Reversal attempts where the trader wants to know whether the impulse candle is efficient or noisy. • Liquid symbols with reliable OHLC and volume data. ⚠️ When NOT to Use • Very low-liquidity markets with unreliable candles. • Extremely noisy sessions where wide candles fail repeatedly. • Symbols with poor or missing volume data if volume support is central to your workflow. • News-driven spikes where normal candle-quality rules may lose relevance. • As a standalone entry system without broader market context. 🎛️ Key Inputs • Sensitivity → controls how strict the readiness model is. • Expansion Lookback → compares the current candle to recent range behavior. • READY Threshold → minimum 0-100 score required for READY state. • Confirmation Mode → controls whether close quality alone is enough or whether volume/edge confirmation is required. • Follow-Through Bars → defines how long the script monitors the active expansion. • Risk Edge Buffer ATR → moves the invalidation reference slightly beyond the candle edge. • Visual settings → control boxes, risk edge, target guide, candle glow, labels, panel theme, and font sizes. 🖥️ Interface & Visual Design The interface is designed to stay chart-first. The panel gives the current decision state without becoming a crowded dashboard. The follow-through box creates a clean visual planning area, while compact labels keep the chart active without burying price candles. The first panel row follows the AGPro merged blue header standard and shows only the script name. 🧪 Practical Usage Workflow 1. Read the Expansion Score and Action row. 2. Check whether the candle is READY, WATCH, or FADE RISK. 3. If READY appears, inspect the follow-through box and risk edge. 4. Watch whether price confirms, fades, or invalidates. 5. Interpret the result within your broader structure, liquidity, and risk plan. 🔍 Interpretation Guidelines Think of the script as a candle expansion planner, not a signal caller. A READY candle deserves attention because its structure is cleaner than average. A WATCH candle needs more evidence. A FADE RISK candle warns that expansion exists, but the candle quality is not clean. INVALIDATED and FADED states are part of the workflow because failed expansion is useful information. 🚫 What This Script Is NOT • Not a prediction engine. • Not financial advice. • Not auto trading. • Not guaranteed signals. • Not an institutional candle detector. • Not an order block, fair value gap, or support/resistance map. ⚠️ Limitations & Transparency • Timeframe differences can change how expansion candles appear. • Volatility spikes can temporarily distort candle-quality readings. • Volume data may differ by exchange, broker, symbol, and feed. • Follow-through is evaluated through a fixed monitoring window. • Market conditions can shift after a READY candle appears. 🧠 Market Context Notes Candle expansion is most useful when interpreted with liquidity, structure, volatility, and location. The script focuses on the candle itself and the immediate follow-through plan. Traders should still consider broader trend context, nearby levels, session behavior, and event risk. 🧾 Use Case Examples When a bullish candle closes near its high with strong body efficiency and relative volume, the script may mark READY and project a follow-through box above the risk edge. When a wide candle has heavy wick behavior and poor close location, the script may flag FADE RISK instead of treating the candle as clean expansion. When a READY candle fails back through its risk edge, the active plan becomes INVALIDATED. 🧱 System Philosophy AGPro tools are designed to support structured chart reading. The goal is to convert market behavior into clean, rule-based context that helps traders think more clearly. Candle Expansion Readiness follows that philosophy by turning a single expansion candle into a monitored planning state. 🔐 Non-Promise Statement No script can provide certainty. This tool organizes candle expansion context, but it does not guarantee continuation, reversal, profit, or any specific market outcome. 📉 Risk Disclosure Trading involves risk. Users are responsible for their own analysis, execution, position sizing, and risk management. Nothing in this script or description is financial advice. 📚 Educational Note Use the script to study how clean expansion candles behave across different symbols and timeframes. The value is in comparing candle quality, follow-through, and failure behavior over time.

Indicator

Acceptance Breakout Planner [AGPro Series]Acceptance Breakout Planner 🧠 Core Idea Did price truly accept beyond the breakout level, or did it only tag the level and fail to hold? 📌 Overview / What it does Acceptance Breakout Planner is a chart-first breakout decision tool designed to evaluate what happens after price moves beyond a key rolling reference edge. Instead of treating every breakout as meaningful, the script measures close persistence, time beyond the level, retest-hold behavior, range distance, candle quality, volume support, and failure shelf risk. It converts that evidence into a 0-100 Acceptance Score and a clear next-action state. The script produces an acceptance band, a failure shelf, a target-room guide, controlled chart labels, alerts, and a clean AGPro planning panel. It does not predict price movement, automate execution, or claim that acceptance will continue. 🎯 Purpose & Design Philosophy This script was built to fill the gap between a simple breakout marker and a full trade-management system. Many traders can see when price crosses a level. The harder question is whether price is spending enough time beyond that level to deserve attention, or whether the break is only a low-commitment tag. The design supports a planner mindset: observe the break, measure acceptance, watch the failure shelf, and review the next state with structure instead of reacting to a single candle. ⚡ Why This Script Is Different Most breakout tools focus on the moment price crosses a level. This script does NOT function as a generic breakout signal, volume-spike detector, consolidation breakout box, Donchian channel tool, or broad break-retest scanner. Instead, it focuses on post-break acceptance quality. The key question is not simply "did price break?" The key question is "did price remain accepted beyond the broken reference long enough to reduce tag-only risk?" This keeps the script separate from Breakout Volume Quality, Consolidation Breakout Quality, Break-Retest Quality, Price Acceptance Profile, and reference-specific breakout tools in the AGPro catalog. ⚙️ Methodology 1. Context Detection The script maps rolling upper and lower reference edges from prior bars. These references are used only as breakout acceptance anchors. 2. Reference Mapping When price closes beyond a reference edge by an ATR-adjusted buffer, the planner starts an active acceptance sequence. 3. Reaction Evaluation The active sequence is scored through close persistence, time beyond the level, acceptance-band retests, candle quality, relative volume support, and distance from the failure shelf. 4. Visual Output The chart shows an acceptance band, a failure shelf, a target-room guide, compact state labels, and a panel that summarizes acceptance score, time beyond, break side, failure risk, and action. 🗺️ How to Read the Chart Acceptance Band = the zone around the broken level where price should hold if acceptance is developing. Failure Shelf = the invalidation context behind the broken level. A close through this shelf means the breakout acceptance sequence needs review. Target Room = a projected planning guide based on the prior reference range. It is not a forecast or promised target. Labels = compact event markers such as BULL BRK, BEAR BRK, WATCH, HOLD, ACCEPT, TAG, RISK, and REJECT. Colors = teal supports constructive acceptance, pink marks rejection or failure pressure, yellow marks caution, and indigo marks active watch states. Panel = a compact decision view showing Acceptance Score, Time Beyond, Break Side, Failure Risk, and Action. 🚦 Signals & States • BULL BRK → price closed beyond the upper reference and started an acceptance review. • BEAR BRK → price closed beyond the lower reference and started an acceptance review. • WATCH → acceptance evidence is improving but is not mature yet. • HOLD → price revisited the acceptance band and held beyond the broken reference. • ACCEPT → close persistence, score quality, and time beyond the level reached the accepted state. • TAG → the sequence is active, but close persistence is still weak after the review window. • RISK → acceptance is not mature and the failure shelf is becoming more relevant. • REJECT → price closed through the failure shelf after the breakout sequence. 🔔 Alerts Logic Alerts trigger when a new acceptance break starts, when accepted state appears, when a retest hold is detected, when failure risk rises, or when price rejects through the failure shelf. Alerts are attention markers. They are not trade instructions, automation commands, or certainty statements. 🧩 Confluence Logic The strongest acceptance context appears when several conditions align: • price closes beyond the broken reference more than once • the acceptance band holds during a retest • candle structure remains directional • failure shelf distance remains healthy • volume support is present without being the only reason for the score When these elements align, the Acceptance Score rises and the state becomes easier to interpret. 📊 When to Use • Breakout review after price crosses a visible range edge • Markets where one-bar breakout tags are common • Trend continuation attempts that need acceptance confirmation • Range expansion moves where the trader wants to separate holding behavior from weak level pokes • Chart review workflows that need a clear post-break next-action state ⚠️ When NOT to Use • Extremely low-liquidity markets with unreliable candles • Very noisy symbols where reference edges are constantly pierced • News-driven volatility where ATR buffers may become unstable • Situations where the user expects automatic trade entries • Markets where volume data is missing and volume support is treated as less useful 🎛️ Key Inputs • Break Side → controls whether the planner evaluates bullish breaks, bearish breaks, or both. • Reference Lookback → defines the prior-bar range used to map breakout reference edges. • Close Beyond Level ATR → controls how far beyond the level price must close before a sequence starts. • Acceptance Band ATR → controls the retest-hold zone around the broken level. • Failure Shelf ATR → controls the invalidation context behind the broken level. • Minimum Beyond Closes → controls how much close persistence is required before acceptance can mature. • ACCEPTED Threshold → sets the minimum 0-100 score for accepted state. • Label / Panel Controls → adjust visual density, placement, theme, and font size. 🖥️ Interface & Visual Design The interface is designed to stay chart-first. The acceptance band and failure shelf show the current structure, while labels mark only meaningful state changes. The panel uses the AGPro standard: a single blue merged header row, compact rows, clear state colors, adjustable location, adjustable theme, and normal font size by default. The visual hierarchy is intentionally restrained so the chart looks active without becoming crowded. 🧪 Practical Usage Workflow 1. Read the panel to see the current Acceptance Score and action state. 2. Check whether price is holding beyond the broken reference or drifting back into the band. 3. Watch the failure shelf to understand whether the breakout is losing acceptance. 4. Review labels only as context markers, not as standalone decisions. 5. Confirm the broader market context before acting on any chart interpretation. 🔍 Interpretation Guidelines Think of the script as a post-break acceptance reviewer. A higher Acceptance Score means the breakout has stronger evidence of persistence according to the script model. A lower score means the move may still be early, weak, or vulnerable to failure. The most useful reading is the relationship between time beyond the level, retest behavior, and failure shelf distance. 🚫 What This Script Is NOT • Not a prediction engine • Not financial advice • Not an auto-trading system • Not guaranteed signals • Not a generic support/resistance map • Not a consolidation breakout box tool • Not a pure volume breakout detector • Not a full break-retest scanner ⚠️ Limitations & Transparency Breakout acceptance is sensitive to timeframe, volatility, liquidity, and symbol behavior. The reference edges are rolling and can change as older bars leave the lookback window. ATR-based buffers can expand or contract during volatile market conditions. Relative volume may be less useful on symbols with limited or inconsistent volume data. 🧠 Market Context Notes Acceptance after a breakout is often more useful than the initial break itself. A level tag shows that price reached a reference. Acceptance shows whether price can keep spending time beyond that reference. This distinction is the core purpose of the planner. 🧾 Use Case Examples When price closes above a reference edge and then holds the acceptance band on a later retest, the script may shift from watch context toward stronger acceptance. When price breaks a reference but quickly returns through the failure shelf, the script marks rejection context instead of treating the break as mature. When price remains beyond the level but does not build enough persistence, the script can show TAG ONLY or FAILURE RISK. 🧱 System Philosophy Acceptance Breakout Planner follows the AGPro decision-engine approach: It does not ask users to react to a raw signal. It organizes the chart into quality, state, risk, target-room context, and next-action review. 🔐 Non-Promise Statement No script can remove uncertainty from markets. No state, score, label, band, shelf, or alert guarantees future price behavior. 📉 Risk Disclosure Trading involves risk. This script is for educational and analytical use only. It does not provide financial advice, investment advice, trade instructions, or guaranteed outcomes. Users remain responsible for their own decisions, risk management, and market evaluation. 📚 Educational Note Use the script to study the difference between a breakout tag and breakout acceptance. The strongest value comes from comparing the planner state with broader structure, volatility, liquidity, and personal execution rules.

Indicator

Reclaim Breakout Planner [AGPro Series]Reclaim Breakout Planner 🧠 Core Idea Is a recently broken structural level being lost and reclaimed in a way that creates a valid breakout planning area? 📌 Overview / What it does Reclaim Breakout Planner is a chart-first breakout planning tool built around structural pivot reclaim behavior. It detects when price breaks beyond a confirmed pivot level, temporarily moves back through that broken level, and then closes back on the breakout side with measurable acceptance quality. The script produces a 0-100 Acceptance Score, an active Reclaim State, an Acceptance Pocket, a Risk Edge, a Target Corridor, controlled chart labels, and a compact AG Pro panel. The goal is to help traders organize reclaim context after a structural breakout attempt. This script does not predict price direction, automate trades, or mark every pivot as important. It filters for a specific sequence: structural level break -> temporary level loss -> reclaim close -> planning state. 🎯 Purpose & Design Philosophy Many breakout tools stop after price crosses a level. Many retest tools treat any return to the level as meaningful. This script was built for the narrower question that often matters after a breakout: did price briefly lose the broken level and then reclaim it with enough quality to deserve attention? It is designed for traders who want a cleaner decision-support layer around breakout acceptance, not another crowded support/resistance map. The mindset is planning first: evaluate validity, score quality, locate risk, estimate target room, and decide whether the context deserves monitoring. ⚡ Why This Script Is Different Most tools focus on the breakout candle or the retest touch. This script does NOT clone VWAP Reclaim Quality, Previous Day Sweep & Reclaim, EMA reclaim maps, session VWAP reaction tools, or a simple breakout retest readiness model. Instead, it focuses on structural pivot reclaim after a level is briefly lost. The reclaim must come from a confirmed pivot break, a temporary move back through the broken level, and a close back on the breakout side. That creates a distinct reclaim-planning workflow rather than a generic level scanner. ⚙️ Methodology 1. Context Detection The script identifies confirmed pivot highs and pivot lows as structural levels. These levels are not VWAP, previous-day highs/lows, session anchors, order blocks, or fixed support/resistance zones. 2. Breakout Arming When price closes beyond a pivot level by an ATR-normalized amount, the planner arms a reclaim watch. A bullish watch begins after a close above resistance. A bearish watch begins after a close below support. 3. Reclaim Evaluation The script waits for price to temporarily lose the broken level and then close back through it. It scores the event using reclaim close distance, retest depth, volume support, trend alignment, and wick rejection. 4. Visual Output Accepted reclaims create an Acceptance Pocket, Risk Edge, Target Corridor, event labels, sparse context labels, and panel state. The visuals are designed to stay readable without leaving the chart empty. 🗺️ How to Read the Chart Acceptance Pocket = the reclaimed structural level area where the breakout side is being tested. Risk Edge = the failed-side reference beyond the pocket. It is a planning boundary, not a trading instruction. Target Corridor = a projected review area based on the reclaim risk distance and the selected R multiple. Labels = compact event and context markers such as Bull Reclaim, Bear Reclaim, Retest Watch, and Failed Reclaim. Target Review labels are optional because the target corridor already marks the review area. Colors = bullish reclaim context uses teal, bearish reclaim context uses pink, caution/watch states use gold or indigo, and risk/failure context uses red. Panel = shows Reclaim State, Acceptance Score, Risk Edge, Target Room, and Action. 🚦 Signals & States • Scan Structure → no active reclaim plan exists yet. • Bull Retest Watch → price broke above a structural pivot and is waiting for a valid reclaim sequence. • Bear Retest Watch → price broke below a structural pivot and is waiting for a valid reclaim sequence. • Acceptance Watch → reclaim exists, but the score is not strong enough for the highest planning state. • Plan Review → reclaim quality is strong enough to monitor as structured planning context. • Risk Edge Test → price is testing the failed-side boundary. • Failed Reclaim → the active reclaim plan closed beyond the risk edge. • Target Review → price reached the projected target corridor area. 🔔 Alerts Logic Bullish Reclaim Breakout Plan triggers when a bullish structural reclaim is accepted and the score is above the alert threshold. Bearish Reclaim Breakout Plan triggers when a bearish structural reclaim is accepted and the score is above the alert threshold. Reclaim Risk Edge Failed triggers when an active reclaim plan closes beyond the risk edge. Reclaim Target Corridor Reached triggers when price reaches the projected target corridor. Alerts are attention markers. They are not trade instructions. 🧩 Confluence Logic The context becomes stronger when a confirmed pivot breakout, temporary level loss, reclaim close, supportive volume, trend alignment, and wick rejection appear together. The score compresses those components into one readable 0-100 Acceptance Score. 📊 When to Use • After structural breakouts where price returns to the broken level • During trending or transitioning markets where reclaim behavior matters • When evaluating whether a breakout level is being accepted after a brief failure • When a trader needs risk edge and target-room context around a reclaim sequence ⚠️ When NOT to Use • Very low-liquidity symbols with unreliable volume and erratic candles • Extremely noisy ranges where pivots form too frequently • News-driven candles where ATR-normalized structure can be distorted • Markets where price is far from any meaningful structural pivot 🎛️ Key Inputs • Reclaim Side → selects Auto, Bullish Only, or Bearish Only. • Pivot Strength → controls how selective structural levels are. • Minimum Break Close ATR → defines how far beyond the pivot price must close before a reclaim watch is armed. • Minimum Level Loss ATR → requires price to temporarily move back through the broken level before reclaim evaluation. • Acceptance Pocket ATR → controls the visual and logical reclaim pocket size. • Retest Window Bars → controls how long the reclaim watch remains valid. • Risk Edge Buffer ATR → adjusts the failed-side planning boundary. • Target Corridor R Multiple → controls the projected target review area. • Label and Panel Settings → control chart label density, optional target review labels, font size, panel location, and panel theme. 🖥️ Interface & Visual Design The interface is intentionally compact. The chart carries the main decision layer through acceptance pockets, risk edges, target corridors, and event labels. The panel acts as a quick readout for state, score, risk, target room, and next action. The first panel row follows the AGPro style with a merged blue title row. Label density is controlled by cooldown and maximum visible label settings so the chart remains premium and readable. 🧪 Practical Usage Workflow 1. Read the panel state. 2. Check whether the planner is scanning, watching a retest, or showing an accepted reclaim. 3. Inspect the Acceptance Pocket and Risk Edge. 4. Compare the Acceptance Score with the active state. 5. Use the Target Corridor as a review area, not as a guaranteed objective. 🔍 Interpretation Guidelines A high score means the reclaim sequence is cleaner under the script's rules. It does not mean the market must continue. A weak score means the reclaim lacks enough acceptance quality, volume support, trend alignment, or wick rejection. A failed reclaim means the planning structure has weakened and should be re-evaluated in broader market context. 🚫 What This Script Is NOT • Not a prediction engine • Not financial advice • Not auto trading • Not guaranteed signals • Not a VWAP reclaim tool • Not a previous-day sweep reclaim script • Not a generic support/resistance map • Not an order block or FVG scanner ⚠️ Limitations & Transparency Timeframe selection affects pivot behavior. Lower timeframes may create more reclaim sequences, while higher timeframes may produce fewer but more important structural levels. Volatility can widen pockets and risk edges. During extreme volatility, reclaim signals can appear later or fail faster. Volume quality may be less reliable on markets where reported volume is synthetic, incomplete, or inconsistent. 🧠 Market Context Notes Reclaim behavior often matters when a market tests whether a broken level is becoming accepted. A clean reclaim can show that a breakout area is still being defended. A failed reclaim can show that the attempted breakout lost structure. The script treats that behavior as planning context, not certainty. 🧾 Use Case Examples When price closes above a pivot high, dips back below the broken level, then closes back above it with rejection wick and supportive volume, the planner may create a bullish reclaim plan. When price closes below a pivot low, trades back above the broken level, then closes back below it with rejection behavior, the planner may create a bearish reclaim plan. 🧱 System Philosophy AGPro tools are designed to help traders organize context, not chase isolated signals. This script follows that principle by turning reclaim behavior into a structured planning workflow with score, state, risk edge, target room, and action text. 🔐 Non-Promise Statement No script can guarantee continuation, reversal, or future price behavior. Reclaim structure can fail, especially in fast, illiquid, or news-driven markets. 📉 Risk Disclosure Trading involves risk. This script is for educational and analytical use only. It does not provide financial advice, investment advice, or guaranteed trading outcomes. Users remain responsible for their own decisions. 📚 Educational Note Use the script to study how reclaimed structural levels behave across symbols, timeframes, and volatility environments. The best use is disciplined observation, comparison, and context building.

Indicator

Gap Continuation Planner [AGPro Series]TITLE Gap Continuation Planner 🧠 Core Idea Is the active gap being accepted for continuation, or is it losing the structure needed for a clean plan? 📌 Overview / What it does Gap Continuation Planner is a chart-first gap planning tool built to evaluate what happens after a gap appears. Instead of treating every gap as an automatic fill candidate, it asks whether price is accepting the gap edge, following through away from the gap, and preserving a measurable defense line. The script produces a gap defense zone, a continuation corridor, an acceptance edge, a defense line, a target guide, compact labels, alerts, and a clean AGPro decision panel. The panel converts the live context into a 0-100 continuation score, fill-risk reading, and next-action state. It does not predict future price, automate trades, or tell the user to buy or sell. It organizes observable gap behavior into a more disciplined continuation-planning framework. 🎯 Purpose & Design Philosophy This script was built for traders who do not want to reduce every gap to a simple fill-or-fade idea. Many gaps initially look strong, but the important question is whether the market continues to accept the gap after the first reaction. Gap Continuation Planner focuses on that middle layer: gap acceptance, follow-through, volatility load, defense quality, fill pressure, and forward room. The design supports a planner mindset. The goal is to slow the decision process down and review whether the structure is valid enough to deserve attention. ⚡ Why This Script Is Different Most gap tools focus on gap detection, gap fill percentage, or historical gap zones. This script does NOT work as a generic gap-fill reaction tool, support/resistance map, imbalance catalog, or automatic signal generator. Instead, it treats the latest gap as a continuation planning object. The model studies whether price is accepting the continuation side of the gap, whether follow-through is developing, whether the defense line remains intact, whether fill risk is rising, and whether there is enough forward room for the plan to remain clean. ⚙️ Methodology 1. Context Detection The script detects classic opening gaps, wick gaps, body-separation gaps, and controlled continuation launch windows when adaptive mode is enabled. 2. Reference Mapping Each accepted gap creates a gap defense zone, an acceptance edge, a defense line, and a target guide. 3. Reaction Evaluation The engine scores gap size, open acceptance, follow-through, volatility load, fill risk, and forward room. 4. Visual Output The chart displays a centered gap-zone label, a centered continuation-corridor label, event labels, planner lines, and a compact AGPro panel. 🗺️ How to Read the Chart Zones = the detected gap defense area. Continuation corridor = the forward planning area between the accepted gap edge and target guide. Acceptance edge = the side of the gap that price should hold for continuation structure to remain stronger. Defense line = an ATR-buffered invalidation reference beyond the far side of the gap. Labels = state changes such as new gap, acceptance watch, continuation ready, defense review, or failed acceptance. Colors = bullish continuation context uses teal, bearish continuation context uses pink, watch states use indigo, and caution states use amber. Panel = summarizes gap state, continuation score, defense line, fill risk, and next action. 🚦 Signals & States • New Gap → a fresh gap continuation window has been detected. • Acceptance Watch → price is holding the continuation side of the gap, but follow-through still needs confirmation. • Continuation Ready → the gap has stronger acceptance, follow-through, room, and risk structure. • Defense Test → price is retesting the gap edge or defense area. • Fill Risk → the gap is being penetrated enough to reduce continuation quality. • Gap Failed → the active gap has lost continuation acceptance. 🔔 Alerts Logic Alerts trigger when a new gap continuation window appears, when the gap reaches READY state, when acceptance watch begins, when defense review becomes relevant, or when gap acceptance is lost. Alerts are attention markers. They are not trade instructions and do not guarantee that continuation will occur. 🧩 Confluence Logic The strongest continuation context appears when gap size, gap-edge acceptance, follow-through distance, stable volatility, low fill pressure, and enough forward room align. When these elements align, the continuation score improves. When fill pressure rises or volatility becomes too hot, the score weakens. 📊 When to Use • After opening gaps in stocks, indices, futures, or session-based markets • During continuation attempts after a strong gap • When reviewing whether a gap is holding acceptance or losing structure • Around breakout continuation sessions where risk and target references need to be visible ⚠️ When NOT to Use • Extremely low-liquidity markets • Very noisy or overlapping session opens • News-driven gaps with unstable spreads • Markets where volume and session structure behave unusually • Environments where price is already far beyond a reasonable risk reference 🎛️ Key Inputs • Sensitivity → adjusts how strict the gap and score requirements are. • Gap Mode → controls whether the script reads classic gaps only or adaptive continuation windows. • Acceptance Bars → changes how many bars must hold the continuation side of the gap. • Follow-Through ATR → controls the preferred travel away from the gap edge. • Defense Buffer → sets the ATR spacing for the defense line. • Forward Room Lookback → helps estimate whether nearby structure limits continuation room. • Minimum Continuation Score → sets the READY threshold. • Visual settings → control zones, corridors, lines, labels, object limits, and panel appearance. • Show Failed / Stale Objects → controls whether old failed corridors remain visible. It is disabled by default for a cleaner publication view. 🖥️ Interface & Visual Design The interface is built for quick planner-style review. The chart carries the structural map, while the panel provides the decision summary. The first panel row follows the AGPro merged blue header standard. The remaining rows focus only on the practical planning fields: state, score, defense, fill risk, and action. The visual hierarchy is intentionally restrained so the gap, corridor, and labels are readable without turning the chart into a crowded signal map. By default, failed or stale gap objects are hidden after they lose live planning value. Event labels remain available so the chart keeps context without carrying too many old failed boxes. 🧪 Practical Usage Workflow 1. Read the panel state and continuation score. 2. Check whether price is holding the gap acceptance edge. 3. Review the continuation corridor and target guide. 4. Compare fill risk against the defense line. 5. Use alerts as review markers, not execution commands. 6. Confirm the context with broader market structure, liquidity, and personal risk rules. 🔍 Interpretation Guidelines A high continuation score means the active gap has stronger structure inside this model. It does not mean the move must continue. Low fill risk supports continuation structure. Rising fill risk means price is starting to challenge the gap. The defense line is a planning reference. It is not a guaranteed stop level and should not replace the user's own risk process. Continuation corridors are visual planning areas, not promised target zones. 🚫 What This Script Is NOT This script is not a prediction engine. This script is not financial advice. This script is not an auto-trading system. This script does not provide guaranteed signals. This script does not replace independent confirmation, risk management, or execution discipline. ⚠️ Limitations & Transparency Gap behavior varies heavily across asset classes, sessions, and timeframes. Adaptive launch windows can help continuous markets, but they should still be interpreted as structured gap-like planning areas rather than classic exchange-session gaps. High volatility can make defense and target references wider. Low liquidity can distort gap quality, label timing, and fill-risk readings. No rule-based script can fully account for news, slippage, spread changes, or sudden liquidity shifts. 🧠 Market Context Notes Gap continuation is often more meaningful when it aligns with trend pressure, session participation, volatility structure, and clean forward room. A gap is not important simply because it exists. It becomes more useful when price accepts one side of it and maintains a measurable defense structure. 🧾 Use Case Examples When price gaps up, holds above the gap edge, and the continuation score improves, the script can help review whether the gap is being defended. When price gaps down and repeatedly rejects back below the gap edge, the panel can help evaluate bearish continuation structure. When fill risk rises quickly, the script highlights that the gap may be losing acceptance rather than continuing cleanly. 🧱 System Philosophy AGProLabs tools are built around structured interpretation. The goal is not to add more signals to the chart. The goal is to turn market behavior into a cleaner review process. Gap Continuation Planner follows that approach by converting a raw gap into a measurable planning object. 🔐 Non-Promise Statement No indicator can remove uncertainty. No score can guarantee continuation. No planner can replace the trader's responsibility to manage risk. 📉 Risk Disclosure Trading involves risk. This script is provided for educational and analytical use only. It does not provide financial advice, investment advice, trading advice, or guaranteed outcomes. Users remain responsible for their own decisions, risk management, position sizing, and execution. 📚 Educational Note The strongest use of this tool is to study whether a gap is being accepted or rejected as structure develops. It is designed to support review, patience, and disciplined interpretation.

Indicator

Session Range Expansion Planner [AGPro Series]Session Range Expansion Planner 🧠 Core Idea Is the session expanding from balance into a valid range extension, or is the break still too weak to trust as context? 📌 Overview / What it does Session Range Expansion Planner is a 1H-focused intraday execution-readiness tool built around one clear workflow: define the early-session balance, track expansion beyond that range, and score whether the move has enough acceptance, volume support, volatility fit, and target room to deserve attention. The script produces a session range box, accepted target-room bands, acceptance/rejection context, alerts, and a premium AGPro panel with a 0-100 planner score. The default visual preset is optimized for 1H and lower charts. Higher intraday charts such as 4H are intentionally kept clean by default. It does not predict the next candle, automate entries, or issue buy/sell commands. It organizes session behavior into a structured decision layer so the user can evaluate the setup within their own plan. 🎯 Purpose & Design Philosophy This script was built to fill the gap between simple session boxes and generic breakout indicators. Most tools show where the session range is. Fewer tools explain whether the break from that range is actually being accepted, whether participation supports it, and whether there is usable room beyond the range. Session Range Expansion Planner supports a planning mindset: define balance first, wait for expansion, check acceptance, evaluate room, then decide whether the context is worth further review. ⚡ Why This Script Is Different Most session tools focus on marking opens, coloring sessions, or printing a breakout label as soon as price crosses a high or low. This script does NOT act as a generic session high/low map, generic support/resistance tool, or broad session reaction scanner. Instead, it treats the first part of the session as a balance structure and asks whether the later expansion has enough quality to become actionable context. The decision layer is built around acceptance bars, volume support, ATR regime, obstacle distance, and target-room quality. ⚙️ Methodology 1. Context Detection The script reads the selected intraday session and builds an initial balance range from the first user-defined number of bars. 2. Reference Mapping The session balance high and low become the only active expansion boundaries. The tool does not use PDH, PDL, weekly open, order blocks, FVGs, or generic swing zones. 3. Reaction Evaluation When price breaks beyond the balance range, the engine measures acceptance closes, volume support, ATR regime quality, break distance, and nearby obstacle room. 4. Visual Output The script displays a centered session range label, directional expansion labels, target-room band, acceptance/rejection labels, alerts, and a premium panel with score and next-action state. 🗺️ How to Read the Chart Session Range Box = the early-session balance area. Expansion Labels = the side where price first expands beyond the balance high or low. Target-Room Band = the projected room beyond the broken boundary after expansion has been accepted, scaled by session range or ATR. Acceptance Labels = confirmation that price has sustained closes beyond the range for the configured number of bars. Rejection Labels = warning that price has failed back through the broken boundary. Colors: • Teal = upside expansion context • Pink = downside expansion context • Amber = neutral, warning, or rejection context • Indigo = AGPro visual accent and target-room support Panel = the decision cockpit showing planner score, session range, expansion side, acceptance, room score, and next action. 🚦 Signals & States • Range Set → the initial balance window has completed. • Expansion Up → price expanded above the session balance high. • Expansion Down → price expanded below the session balance low. • Accepted → the expansion held beyond the range for the required acceptance bars. • Rejection Risk → price failed back through the broken boundary. • Room Check Reached → price reached the projected target-room area. 🔔 Alerts Logic Alerts trigger when: • Upside range expansion is detected • Downside range expansion is detected • Expansion becomes accepted • Rejection risk appears after expansion Alerts are attention markers. They are not trade instructions and should be interpreted together with broader market context. 🧩 Confluence Logic The strongest context appears when expansion direction, sustained acceptance, volume support, balanced ATR regime, and clean target room align at the same time. When those conditions stack together, the planner score rises and the panel moves toward a review-ready state. 📊 When to Use • 1H intraday charts with clear session behavior • Opening balance or early-session range workflows • Breakout quality review • Volatility expansion planning • Session continuation evaluation The script is most useful when a trader wants to know whether a session range break is actually being accepted, not just whether a line was crossed. ⚠️ When NOT to Use • Very low-liquidity symbols • Extremely noisy micro timeframes • Markets with unreliable volume • Sessions with irregular trading hours • News-driven candles where range expansion is disorderly In weak conditions, reduce sensitivity or require stricter acceptance. 🎛️ Key Inputs • Session Timezone → defines how the selected session is interpreted. • Expansion Session → sets the active intraday window. The default full-day session is designed to work cleanly on crypto and other 24-hour symbols. • Visual Timeframe Preset → controls which intraday timeframes show chart objects. The default is 1H and lower because 4H session expansion charts can become too compressed. • Balance Window Bars → controls how many early-session bars define the range. • Acceptance Bars → defines how much sustained closing behavior is required. • Sensitivity → adjusts how fast the script recognizes expansion. • Confirmation Mode → controls wick, close, or strict acceptance confirmation. • Minimum Planner Score → sets the score threshold for review-ready context. • ATR Length → controls volatility normalization and label spacing. • Obstacle Lookback → estimates nearby structure that may reduce room quality. • Target Room Multiplier → controls the projected target-room distance. • Visual Settings → control range boxes, centered range label limit, rails, accepted target-room band, minimum visual score, optional expansion labels, optional room-check labels, optional range-set labels, label size, and object limits. • Panel Settings → control panel visibility, location, theme, and font size. 🖥️ Interface & Visual Design The interface is chart-first. The range box and target-room band carry the main visual story, while labels explain state transitions only when meaningful events occur. The panel is intentionally compact. It gives a fast read of expansion quality without forcing the user to decode many separate plots. The first panel row follows the AGPro standard: a single merged blue header row with only the script name. 🧪 Practical Usage Workflow 1. Apply the script to an intraday chart. 2. Confirm the correct session and timezone. 3. Let the initial balance window complete. 4. Watch for expansion beyond the balance high or low. 5. Check whether acceptance bars confirm sustained behavior. 6. Read the planner score and room score. 7. Use the next-action state as context for your own execution plan. 🔍 Interpretation Guidelines A clean expansion is not just a break beyond the range. It should show acceptance, participation, reasonable volatility, and enough room before nearby obstruction. Low scores usually mean the break is early, unsupported, too noisy, too extended, or too close to an obstacle. The best use is comparative: review which sessions and symbols repeatedly produce clean accepted expansions versus weak false breaks. 🚫 What This Script Is NOT • Not a prediction engine • Not financial advice • Not auto trading • Not guaranteed signals • Not a buy/sell command system • Not a generic support/resistance map • Not an order block, FVG, or liquidity sweep scanner ⚠️ Limitations & Transparency Session behavior can vary across assets, timeframes, exchanges, and trading hours. ATR regime and volume support are rule-based approximations, not certainty models. On very low timeframes, labels may appear more frequently. On higher intraday timeframes, fewer but more meaningful events are expected. Markets can expand cleanly and still reverse later. The tool measures context quality, not future certainty. 🧠 Market Context Notes Session range expansion often becomes more meaningful when it is read together with broader trend, liquidity, volatility, and higher-timeframe structure. The script deliberately stays focused on session balance and expansion quality. Users can combine it with their own broader framework without duplicating other AGPro tools. 🧾 Use Case Examples When price breaks above the session range, holds above the balance high for the required acceptance bars, and room score remains strong, the panel may shift into review-ready continuation context. When price breaks the range but quickly closes back inside the balance, the script marks rejection risk and the panel moves away from continuation review. 🧱 System Philosophy AGPro tools are built to help traders organize context into clear decision layers. Session Range Expansion Planner follows that philosophy by turning a common intraday event into a structured planning process: balance, expansion, acceptance, room, action. 🔐 Non-Promise Statement No script can guarantee future price movement. The score is a structured context model, not a certainty model. 📉 Risk Disclosure Trading involves risk. Market conditions can change quickly, and historical session behavior does not guarantee future outcomes. Users are responsible for their own decisions, risk management, and position sizing. This script is provided for educational and analytical use only and does not provide financial advice. 📚 Educational Note Use the script to study how different markets expand from early-session balance. The most valuable insight is not a single label, but the repeated relationship between range quality, acceptance, room, and market context.

Indicator

Opening Drive Quality [AGPro Series]Opening Drive Quality 🧠 Core Idea Is the first directional drive of the session strong enough to plan around, or is it already losing execution quality? 📌 Overview / What it does Opening Drive Quality is a session execution planner that evaluates the first directional drive after the market opens. It studies the opening drive channel, early follow-through, pullback acceptance, risk-line integrity, and target-room structure in one clean decision framework. The script produces a 0-100 quality score, a clear next-action state, an opening drive channel, a pullback acceptance zone, an invalidation risk line, target guide, compact chart labels, alerts, and a premium AGPro panel. It does not predict price direction, automate trades, or mark every opening range breakout. Its purpose is to help traders evaluate whether the early session drive has enough structure, acceptance, and risk clarity to deserve attention. 🎯 Purpose & Design Philosophy The script was built for traders who need more than an opening range box or a simple breakout marker. The first session move often sets the tone, but the useful question is not only whether price moved. The useful question is whether that move produced clean follow-through, controllable risk, and a meaningful pullback area. Opening Drive Quality fills that gap by turning the opening move into a structured planning map. It supports traders who study session execution, intraday momentum, and pullback planning without relying on generic signals. The design philosophy is simple: evaluate the quality of the first drive, define the risk line, project the pullback acceptance zone, and make the next state readable at a glance. ⚡ Why This Script Is Different Most tools focus on opening range breakouts, session boxes, fixed kill zones, or failed-break signals. This script does NOT try to clone a generic ORB tool, a kill-zone session engine, or an opening range failure map. Instead, it focuses on the quality of the first directional drive itself. It asks whether the drive has real thrust, whether follow-through appears after the drive locks, whether price accepts a pullback zone, where the risk line sits, and what the next planning state should be. ⚙️ Methodology 1. Context Detection The script builds the opening drive from either a fixed session window or the first bars of a new day. This keeps the tool useful across regular-market assets and 24/7 markets. 2. Reference Mapping After the drive locks, the script maps the opening drive channel, pullback acceptance zone, invalidation risk line, and target-room guide. These references come from the opening drive structure, not from generic support and resistance pivots. 3. Reaction Evaluation The engine scores drive thrust, close location, range expansion, optional relative volume, follow-through distance, pullback behavior, and risk-line integrity. 4. Visual Output The chart shows the active drive channel, projected pullback zone, risk line, target guide, state labels, and a compact panel with the key planning reads. 🗺️ How to Read the Chart Opening Drive Channel = the locked first directional drive of the session. Pullback Acceptance Zone = the area where a controlled pullback can be evaluated after a valid drive. Risk Line = the invalidation line derived from the drive base, pullback zone, and ATR buffer. Target Guide = a projected target-room reference based on the opening drive range. Labels = compact markers for drive lock, follow-through, pullback acceptance, weak drive, risk break, and target check. Colors = teal for bullish drive context, pink for bearish drive context, amber for review states, and indigo for structural emphasis. Panel = the decision layer showing Drive Side, Follow-Through, Pullback Quality, Risk Line, and Action. 🚦 Signals & States • DRIVE Q → the opening drive has locked and received a 0-100 quality score. • FOLLOW Q → the drive has produced directional follow-through after locking. • PULLBACK ACCEPTED → price is reacting constructively inside the projected pullback acceptance zone. • WEAK DRIVE → follow-through has not developed inside the review window. • RISK BROKEN → the active drive has violated its invalidation line. • TARGET CHECK → price has reached the projected target-room guide. 🔔 Alerts Logic The script includes alerts for: • Opening Drive Quality Locked → a qualified opening drive has completed. • Drive Follow-Through → directional extension appears after the drive locks. • Pullback Accepted → price reacts inside the projected pullback acceptance zone. • Risk Line Broken → price violates the active drive risk line. • Target Guide Reached → price reaches the projected target-room guide. Alerts are attention markers. They are not trade instructions. 🧩 Confluence Logic The context becomes stronger when opening drive thrust, close location, session volatility, relative volume, follow-through, and pullback acceptance align. The context becomes weaker when the opening drive locks with poor thrust, cannot extend, pulls back too deeply, or breaks the risk line. 📊 When to Use • Intraday session planning. • Opening-drive analysis after the first market push. • Markets where the opening session often defines early direction. • Pullback planning after a strong first drive. • Session review where risk line and target-room context matter. ⚠️ When NOT to Use • Very low-liquidity markets. • Extremely noisy opens with unstable spreads. • News-driven bars where the first drive is unusually distorted. • Assets where the selected opening session is not meaningful. • Higher timeframes where the opening drive window has no practical session context. 🎛️ Key Inputs • Opening Drive Mode → chooses first bars of day or a fixed session window. First Bars Of Day is the default so the chart loads with visible drive structure across more symbols. • Opening Drive Session → defines the drive-building window. • Tracking Session → defines when follow-through and pullback logic remains active. • Minimum Quality Threshold → controls when stronger planning labels appear. • Follow-Through ATR → defines the extension needed for follow-through confirmation. • Pullback Acceptance Depth → controls the projected pullback zone depth. • Risk Line Buffer ATR → adjusts the invalidation line beyond the drive structure. • Target Guide Multiple → controls the projected target-room guide. • Panel / Label Settings → control panel location, theme, font size, label size, visible label count, minimum label quality, label cooldown, and optional compact plot markers. 🖥️ Interface & Visual Design The interface is built around a clean AGPro panel and chart-first planning visuals. The panel uses a single merged blue header row with only the script name, then five practical rows: Drive Side, Follow-Through, Pullback Quality, Risk Line, and Action. The chart uses one opening drive channel, one pullback acceptance zone, one risk line, one target guide, and compact labels. The goal is a premium session-planning view without clutter. 🧪 Practical Usage Workflow 1. Read the panel after the opening drive locks. 2. Check whether the drive side and score show a valid planning context. 3. Watch follow-through quality after the drive locks. 4. Evaluate whether price pulls back into the acceptance zone constructively. 5. Use the risk line and target guide as planning references, not automatic decisions. 🔍 Interpretation Guidelines A strong score means the opening drive has better structure, cleaner close location, stronger volatility context, and better follow-through support. A pullback acceptance label means price is reacting inside the projected drive-based zone. It does not mean price must continue. A risk-line break means the original drive plan has lost structural integrity and should be reassessed. The most useful interpretation comes from combining the panel state with broader market context, liquidity, and timeframe alignment. 🚫 What This Script Is NOT • Not a prediction engine. • Not financial advice. • Not an auto-trading system. • Not guaranteed signals. • Not a generic support and resistance mapper. • Not a clone of an ORB breakout tool. • Not a kill-zone timing dashboard. • Not an opening range failure scanner. ⚠️ Limitations & Transparency Timeframe selection affects the opening drive shape. A 5-minute chart and a 15-minute chart can produce different drive channels. Volatility changes can expand or compress the pullback zone and risk line. Session definitions matter. The selected opening window should match the asset being studied. High-impact news, abnormal spreads, and low liquidity can reduce the reliability of the opening drive map. 🧠 Market Context Notes Opening drives are most useful when liquidity is active and the first session push creates a clear directional reference. A clean drive does not guarantee continuation, but it can create a structured area for evaluating pullback acceptance and invalidation. The script intentionally keeps its references tied to the opening drive. It avoids pivot maps, order block language, broad S/R zones, and generic failed-break logic. 🧾 Use Case Examples When price locks a strong bullish opening drive, extends beyond the channel, and then pulls back into the acceptance zone without breaking the risk line, the panel may shift toward a constructive planning state. When price locks a drive but cannot create follow-through inside the review window, the script can mark the drive as weak and shift the action state toward bias reduction. When price violates the risk line, the original opening drive plan is no longer structurally intact inside this model. 🧱 System Philosophy Opening Drive Quality follows the AGPro decision-engine philosophy: a script should help the trader evaluate validity, strength, risk, target room, and next state instead of only printing another signal. The tool is designed to make the opening session easier to interpret through structured references and clean visual hierarchy. 🔐 Non-Promise Statement No script can provide certainty. No opening drive model can guarantee continuation, reversal, or profitability. This script provides structured context only. 📉 Risk Disclosure Trading involves risk. Users are responsible for their own decisions. This script does not provide financial advice, investment advice, or guaranteed trading outcomes. 📚 Educational Note Use this script as an educational planning and visualization tool. The strongest use comes from reading the opening drive together with broader market structure, liquidity, volatility, and personal risk rules.

Indicator

Volume Expansion Breakout Planner [AGPro Series]Volume Expansion Breakout Planner 🧠 Core Idea After a breakout, is volume expanding in a constructive path, or is the move losing participation and acceptance? 📌 Overview / What it does Volume Expansion Breakout Planner is a chart-first breakout planning tool built around post-breakout participation quality. Instead of judging only the breakout candle, the script maps the broken reference level, draws an acceptance band, monitors relative volume after the break, tracks whether price holds the path, and converts the full sequence into a 0-100 quality score. The output includes compact breakout path labels, volume expansion labels, hold labels, failed-volume labels, an invalidation rail, a room or review guide, and a clean AGPro decision panel. It does not predict price, automate entries, or issue trade commands. 🎯 Purpose & Design Philosophy This script was built to fill the gap between simple breakout markers and full trade-management tools. Many breakouts look strong on the first candle but quickly lose participation. Others start quietly and become stronger as post-break volume expands. This tool is designed for traders who want to evaluate that path with structure, not emotion. The mindset is planning-first: identify the breakout reference, evaluate volume expansion, check acceptance, respect invalidation, and decide whether the path deserves continued attention. ⚡ Why This Script Is Different Most breakout tools focus on the first break beyond a level. This script does NOT try to clone a standard breakout volume confirmation tool, a Darvas breakout system, a triangle breakout scanner, or a generic support/resistance map. Instead, it focuses on the post-break volume expansion path: what happens after the level breaks, whether volume remains constructive, whether price accepts the broken area, and whether the path becomes suspicious or failed. ⚙️ Methodology 1. Context Detection The script builds a prior price structure from a configurable lookback and identifies the upper and lower breakout references. 2. Reference Mapping When price closes beyond the reference by an ATR-normalized buffer, the script starts a breakout path and draws the broken level, acceptance band, invalidation rail, and a room or review guide. 3. Reaction Evaluation The model evaluates relative volume, candle efficiency, close location, breakout distance, trend alignment, range quality, post-break participation, progress, acceptance, and failure behavior. 4. Visual Output The chart displays compact path labels, volume expansion labels, accepted-path labels, failed-volume labels, and a premium AGPro panel summarizing the current decision state. 🗺️ How to Read the Chart Zones = the acceptance band around the broken level. Its text changes by state, such as BULL PATH REVIEW, ACCEPTED BULL PATH, or FAILED BEAR PATH. Labels = compact path state markers such as UP, DN, VOL+, HOLD, FAIL, WATCH UP, and WATCH DN. Label scores can be enabled from settings if the user wants more detail. Colors = teal for constructive bullish paths, pink for constructive bearish paths, yellow for watch or caution states, indigo for room or review guide emphasis, and muted gray for expired paths. Panel = the current breakout side, volume expansion state, acceptance state, quality score, and next action. 🚦 Signals & States • UP → a bullish breakout path has started. • DN → a bearish breakout path has started. • VOL+ → post-break volume is expanding with directional follow-through. • HOLD → the path held beyond the acceptance band with constructive volume. • FAIL → the path returned into weak-volume or invalidation conditions. • WATCH UP / WATCH DN → optional approach labels when price is near a breakout reference while relative volume is building. 🔔 Alerts Logic Alerts trigger when a high-quality bullish or bearish volume expansion path starts, when post-break volume expands, when the path becomes accepted, or when failed-volume conditions appear. These alerts are attention markers for chart review. They are not trade instructions. 🧩 Confluence Logic The strongest readings usually occur when the breakout closes cleanly beyond the reference, relative volume expands above baseline, candle structure is efficient, trend alignment supports the side, and price later accepts the broken area. When these conditions align, the quality score improves and the next-action state becomes more constructive. 📊 When to Use • Breakout continuation review • Range exits where volume quality matters • Post-break acceptance monitoring • Breakouts that need a clear invalidation reference • Multi-symbol review where traders need fast path-quality comparison ⚠️ When NOT to Use • Low-liquidity symbols with unreliable volume • Markets with irregular session volume or distorted feeds • Extremely choppy periods where every break returns inside the prior structure • Events driven by abnormal news volatility where technical volume baselines become less stable 🎛️ Key Inputs • Breakout Lookback → controls the prior structure used for breakout references. • Break Buffer ATR → defines how far price must close beyond the level. • Volume Baseline Length → controls the relative volume baseline. • Expansion RVOL Threshold → defines the required volume expansion for strong pulses. • Minimum Planner Score → controls how selective the main path states are. • Acceptance Band ATR → controls the decision zone around the broken level. • Invalidation Rail ATR → controls the structural failure reference. • Panel / Label Settings → control location, theme, font size, label scores, optional watch labels, and label density. 🖥️ Interface & Visual Design The interface is built for fast chart reading. The acceptance band is the main visual anchor. The breakout line, invalidation rail, and room or review guide create a compact planning map without filling the chart with generic zones. Labels are short, shifted slightly away from the candle, and capped by user settings. The AGPro panel follows the publication standard with a single merged blue header row containing only the script name. 🧪 Practical Usage Workflow 1. Read the panel to see whether a breakout path is active. 2. Check the acceptance band and broken level. 3. Evaluate whether volume is expanding or fading. 4. Watch for ACCEPTED or FAILED VOL states. 5. Use the invalidation rail and room or review guide as planning references within broader market context. 🔍 Interpretation Guidelines Read the score as a structured quality model, not as certainty. A higher score means the path has cleaner participation, stronger candle structure, better close quality, better trend alignment, and stronger acceptance behavior according to the script's rules. A lower score means the path is weaker, less accepted, or more vulnerable to failed-volume behavior. 🚫 What This Script Is NOT • Not a prediction engine • Not financial advice • Not auto trading • Not guaranteed signals • Not a complete trading system • Not a generic buy/sell indicator ⚠️ Limitations & Transparency Volume quality depends on the reliability of the PulseWire volume feed for the selected symbol. Different timeframes can produce different breakout references and acceptance behavior. High-volatility news periods, low-liquidity markets, and irregular session activity can reduce the usefulness of relative volume baselines. The script is rule-based and should be interpreted alongside broader context. 🧠 Market Context Notes Volume expansion is most useful when it is connected to structure. The broken level matters because it gives the move a reference. The acceptance band matters because it shows whether the market is holding that reference. The invalidation rail matters because it defines when the path has lost structural quality. 🧾 Use Case Examples When price breaks above a prior range with strong RVOL and later holds the acceptance band, the path may remain constructive. When price breaks below a range but volume fades and price returns above the broken reference, the path may become suspicious or failed. When price approaches a reference with building volume but no confirmed break, VOL WATCH keeps the trader aware without turning the tool into a signal board. 🧱 System Philosophy The script is part of the AGPro planner-style workflow: show the reference, score the context, define invalidation, monitor acceptance, and guide the next review step. 🔐 Non-Promise Statement No script can guarantee continuation, reversal, or outcome certainty. This tool organizes breakout-volume context so users can evaluate the chart more clearly. 📉 Risk Disclosure Trading involves risk. Users are responsible for their own decisions, risk management, and market interpretation. This script is provided for educational and analytical use only and does not provide financial advice. 📚 Educational Note Use the script to study how post-breakout volume behaves after price leaves a prior structure. The most useful insights often come from comparing accepted paths against failed-volume paths over many examples.

Indicator

Range Escape Planner [AGPro Series]Range Escape Planner 🧠 Core Idea Is price escaping a mature range with enough quality to monitor, or is the move still vulnerable to failure? 📌 Overview / What it does Range Escape Planner is a chart-first breakout quality and trade planning tool built around mature range escape behavior. Instead of printing a generic breakout signal, the script maps the active range boundary, projected escape corridor, invalidation edge, target guide, obstruction room, follow-through quality, and retest behavior. These components are converted into a 0-100 Escape Score and a clear next-action state. The script produces a range boundary box, escape corridor, risk/target guide lines, compact labels, alerts, and a clean AGPro planning panel. It does not predict future price movement, automate decisions, or guarantee that a range escape will continue. 🎯 Purpose & Design Philosophy This script was built for traders who want to evaluate breakout quality after price leaves a mature range. Many breakout tools identify the break itself but stop before answering the practical planning questions: is the range mature, is the close beyond the boundary strong enough, is volatility expanding constructively, is there clean room, and where is the failure reference? The design philosophy is simple: a range escape is only useful when it has maturity, confirmation, room, and a readable invalidation edge. ⚡ Why This Script Is Different Most tools focus on basic range breaks, box breakouts, session opening ranges, or simple breakout markers. This script does NOT clone Darvas Box Breakout Quality, does NOT rebuild an ORB model, and does NOT act as a generic consolidation breakout signal. Instead, it treats the move as a planning problem. The main output is not a buy or sell command. It is a structured state that helps users separate VALID ESCAPE, ESCAPE WATCH, RANGE READY, OBSTRUCTION, FAILED, and WAIT RANGE conditions. ⚙️ Methodology 1. Context Detection The script maps the prior range from previous bars and checks whether price is still inside, near an edge, or closing beyond the boundary. 2. Reference Mapping It draws the mature range, escape edge, invalidation edge, projected target guide, and older swing obstruction room. 3. Reaction Evaluation The model scores range maturity, close beyond range, volatility expansion, follow-through, retest quality, and obstruction room. 4. Visual Output The result is displayed through centered zone labels, compact event labels, guide lines, deterministic alerts, and a premium AGPro panel. 🗺️ How to Read the Chart Zones = the range box shows the active mature range. The escape corridor shows the projected planning path from the broken boundary toward a target guide. Zone text is centered inside the boxes. Labels = compact markers identify RANGE READY, ESCAPE WATCH, VALID ESCAPE, RETEST HOLD, OBSTRUCTION, and FAILED context. Colors = green highlights cleaner long-side escape quality, pink highlights short-side or failure risk, amber highlights review conditions, and indigo highlights watch or mature-range context. Panel = the panel summarizes Escape Score, Range Age, Confirmation, Obstruction, and Action. 🚦 Signals & States • RANGE READY → the range is mature and price is near an escape edge. • ESCAPE WATCH → price has escaped the range, but follow-through or retest confirmation is still incomplete. • VALID ESCAPE → the escape has stronger score alignment, follow-through or retest support, and acceptable obstruction context. • RETEST HOLD → price retested the escape edge and held outside the prior range. • OBSTRUCTION → the escape is active, but older structure may limit clean room. • FAILED → price returned through the escape edge and the escape context is no longer clean. • WAIT RANGE → no mature range escape context is active. 🔔 Alerts Logic Alerts trigger when the planner detects RANGE READY, New Range Escape, ESCAPE WATCH, VALID ESCAPE, RETEST HOLD, OBSTRUCTION REVIEW, or FAILED ESCAPE conditions. These alerts are attention markers only. They are not trade instructions, entry signals, or automated strategy commands. 🧩 Confluence Logic The strongest context appears when a range is mature, price closes beyond the range boundary, volatility expands constructively, candle follow-through improves, the broken edge holds on retest, and obstruction room remains acceptable. When these components align, the Escape Score improves and the state can progress from RANGE READY to ESCAPE WATCH or VALID ESCAPE. 📊 When to Use • During range breakout and range expansion review • 4H and multi-hour swing charts where the range structure has enough space to breathe • After price has spent time inside a defined range • When evaluating whether a breakout has clean follow-through • When a trader needs a visible invalidation edge and target-room reference • On liquid markets where ATR, range, and swing structure are readable ⚠️ When NOT to Use • Very low-liquidity symbols with unstable candles • Extremely noisy micro-timeframes • Very compressed intraday charts where labels and range boxes can crowd the price action • News-driven spikes where price gaps far beyond the range • Markets where older swing structure is too messy to define clean obstruction room • Situations where the user expects a signal-only entry tool 🎛️ Key Inputs • Planning Side → controls Auto, Long Escape, or Short Escape mode. • Range Lookback → controls how the prior range boundary is mapped. • Minimum Range Age → defines how mature the range should be before stronger scoring. • Minimum Close Beyond Edge ATR → controls how far price must close beyond the boundary before an escape registers. • Follow-Through ATR → defines stronger post-escape movement beyond the edge. • Retest Tolerance ATR → controls how close price can revisit the broken boundary and still count as a hold. • Obstruction Lookback → controls how older swing structure is checked for clean room. • Label and Panel Font Size → controls chart labels, centered box text, and panel readability. 🖥️ Interface & Visual Design The interface is designed to stay chart-first. The range box defines the active decision area. The escape corridor shows the forward planning path. The invalidation, target, and obstruction lines add context without turning the chart into a crowded signal board. The AGPro panel provides a compact decision summary with a merged blue title row and clear state hierarchy. 🧪 Practical Usage Workflow 1. Read the panel state and Escape Score. 2. Check whether the range is mature enough. 3. Review the escape corridor and edge line. 4. Check confirmation, retest behavior, and obstruction room. 5. Treat alerts as attention markers, then evaluate broader market context. 🔍 Interpretation Guidelines Think in terms of escape quality, not prediction. A stronger score means multiple structural conditions are aligned. A weaker score means the escape may be premature, poorly confirmed, obstructed, too noisy, or already failed. OBSTRUCTION is especially important because a range can break cleanly while nearby older structure still limits practical room. 🚫 What This Script Is NOT • Not a prediction engine • Not financial advice • Not an auto-trading system • Not a guaranteed signal tool • Not a Darvas Box clone • Not an ORB model • Not a generic support/resistance zone map ⚠️ Limitations & Transparency The script is rule-based and depends on recent price, volatility, range, and older swing structure. Timeframe differences can change how range maturity and escape quality appear. Volatility spikes can distort the score. Thin markets can create false escape or failure behavior. Outputs should always be interpreted with broader market structure, liquidity, and risk context. 🧠 Market Context Notes Range escape behavior is most useful when a readable balance area exists before expansion. An escape with no follow-through may still be early. An escape with immediate obstruction may require extra caution. An escape that returns through the broken edge is treated as failed context, not as a new opposite prediction. 🧾 Use Case Examples When price closes beyond a mature range, volatility expands from normal conditions, the candle holds beyond the edge, and older obstruction room is clean, the planner may classify the move as VALID ESCAPE. When price breaks the boundary but quickly returns through the edge, the planner may classify the context as FAILED. When price escapes but older swing structure is immediately ahead, the planner may show OBSTRUCTION even if the score is otherwise improving. 🧱 System Philosophy AGPro planning tools are designed to help traders evaluate context before reacting. This script follows that philosophy by turning a range breakout into a structured planning question: is the escape mature, confirmed, readable, and supported by clean room? 🔐 Non-Promise Statement No indicator can guarantee continuation, reversal, or follow-through. This tool provides structured visual context and rule-based attention markers. It does not provide certainty. 📉 Risk Disclosure Trading involves risk. Market conditions can change quickly, and no script can remove uncertainty. Users are responsible for their own analysis, risk management, and decisions. This script is for educational and analytical use only and does not provide financial advice. 📚 Educational Note Use the planner to study how mature ranges resolve, how escape quality changes after the first break, and how obstruction room affects the readability of breakout continuation.

Indicator

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

Indicator

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

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

In-depth global business and economic analysis Comprehensive trading education and market insights