Planning

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

Reversal Confirmation Planner [AGPro Series]Reversal Confirmation Planner 🧠 Core Idea Is a reversal actually confirming, or is it still only an early reaction? 📌 Overview / What it does Reversal Confirmation Planner is a chart-first planning tool built to separate early reversal reactions from structured confirmation context. The script detects sweep or wick-rejection reactions around recent swing references, then evaluates whether the reaction develops into a cleaner confirmation plan. It maps a confirmation pocket, invalidation edge, target-room band, compact event labels, alerts, and a clean AG Pro decision panel. It does not predict reversals, automate entries, or scan every classical reversal pattern. The goal is to help traders organize the confirmation phase: reaction quality, confirmation close, momentum turn, volume support, room, invalidation, and next action. 🎯 Purpose & Design Philosophy This script was built for traders who do not want to treat every wick, sweep, or counter-move as a valid reversal. Many reversal tools mark the first reaction. This planner waits for structure. It asks whether price has moved from reaction into confirmation, whether momentum is turning, whether volume supports the shift, and whether the active plan has enough room before the next projected guide. The design supports a decision-making workflow. It does not ask the user to chase every signal. It helps the user decide whether the reversal context is still early, building, confirming, confirmed, failed, expired, or already testing its room. ⚡ Why This Script Is Different Most reversal tools focus on detecting a pattern, labeling a wick, or marking every possible counter-trend reaction. This script does NOT behave like a broad reversal-pattern scanner, double-top/double-bottom detector, head-and-shoulders module, 1-2-3 map, wedge detector, Turtle Soup map, liquidity sweep tool, or generic support/resistance zone script. Instead, it works as a confirmation planner. The core workflow is reaction → confirmation pocket → invalidation edge → target-room context → next-action state. This keeps the public concept narrow, useful, and clearly separate from other AGPro reversal tools. ⚙️ Methodology 1. Context Detection The script watches for bullish or bearish reversal reactions using sweep behavior, wick rejection, candle close location, and prior directional context. 2. Reference Mapping Once a reaction qualifies, the planner creates a confirmation line, confirmation pocket, invalidation edge, and target-room guide. 3. Reaction Evaluation The model scores sweep or rejection quality, confirmation progress, momentum turn, volume support, and available room. 4. Visual Output The chart shows the active confirmation pocket, centered target-room band, risk/target guide lines, compact labels, alert conditions, and an AG Pro panel with the current decision state. 🗺️ How to Read the Chart Confirmation Pocket = the area between the reaction reference and the confirmation close line. Invalidation Edge = the level beyond the reaction extreme where the active confirmation plan is considered failed by the script rules. Target-Room Band = a projected planning zone that shows whether the reversal has enough forward room relative to the active risk distance. Labels = compact state markers such as REACTION, CONFIRMING, CONFIRMED, FAILED, EXPIRED, ROOM TESTED, or PLAN. Colors = teal supports bullish reversal planning, pink supports bearish reversal planning, amber marks developing context, indigo marks target-room context, and red marks invalidation or failed confirmation. Panel = summarizes Reversal Stage, Confirmation Score, Invalidation, Room, and Action. 🚦 Signals & States • REACTION → an early sweep or rejection is active, but confirmation is not complete. • BUILDING → the context is improving, but the confirmation close is not fully qualified. • CONFIRMING → price is testing or closing through the confirmation line with sufficient structure to review. • CONFIRMED → the confirmation score and close behavior meet the script threshold. • ROOM TESTED → the projected target-room guide has been reached after confirmation. • FAILED → the active plan violated its invalidation edge. • EXPIRED → the reaction did not confirm within the selected confirmation window. 🔔 Alerts Logic The script includes alerts for bullish reaction, bearish reaction, bullish confirmation, bearish confirmation, failed confirmation, and high-quality confirmation. Alerts trigger when the internal rule conditions are met. They are attention markers for chart review, not trade instructions, automated entries, or guaranteed reversal signals. 🧩 Confluence Logic The strongest confirmation context appears when multiple layers align: • A clear sweep or rejection reaction forms. • Price progresses through the confirmation pocket. • Momentum begins to turn in the reaction direction. • Volume support is not weak. • The target-room band offers enough room relative to invalidation distance. When these layers align, the confirmation score becomes stronger. When one or more layers are weak, the state usually remains reaction, building, expired, or failed. 📊 When to Use • After visible sweep or rejection behavior. • During possible reversal transitions after directional extension. • Around swing references where confirmation matters more than the first wick. • 4H swing-review charts, where the default label spacing and confirmation pockets usually have the cleanest visual balance. • Daily charts when the user wants fewer but more selective reversal confirmation states. • In markets where traders want to compare reaction quality, invalidation, and room before acting. • For discretionary review of crypto, forex, indices, equities, and commodities on liquid charts. ⚠️ When NOT to Use • Extremely low-liquidity symbols with unreliable wicks or volume. • Very noisy micro-timeframes where reaction candles are unstable. • News spikes or extreme volatility events where confirmation levels can be crossed erratically. • Charts where the user expects a complete reversal-pattern scanner. • Situations where the user wants automated trade execution. 🎛️ Key Inputs • Confirmation Mode → controls whether labels and alerts wait for bar close or update live. • Swing Reference Length → defines the recent swing references used for sweep-based reactions. • Sensitivity → adjusts how selective the reaction model is. • Confirmation Window Bars → limits how long a reaction can wait for confirmation. • Minimum Reaction Score → controls the quality required before tracking a candidate. • CONFIRMED Threshold → controls the minimum 0-100 score required for confirmed state. • Preferred Room / Risk → adjusts how much forward room is preferred relative to invalidation distance. • Visual settings → control pockets, bands, guide lines, labels, panel position, panel theme, and font sizes. 🖥️ Interface & Visual Design The interface is built around a premium chart-first workflow. The confirmation pocket and target-room band are concept-native visuals, not generic support/resistance zones. Their labels are centered inside the boxes for cleaner chart reading. The default visual preset is tuned for 4H-style swing review: enough labels to keep the chart informative, but enough spacing to avoid a crowded reversal scanner look. The AG Pro panel uses a compact structure with one merged blue title row and five decision rows. It is designed to show only the current planning context without turning the chart into a dashboard-heavy script. 🧪 Practical Usage Workflow 1. Read the panel state. 2. Check whether the chart is showing REACTION, BUILDING, CONFIRMING, CONFIRMED, FAILED, or EXPIRED. 3. Review the confirmation pocket and invalidation edge. 4. Compare target-room context against the room/risk readout. 5. Use alerts as review prompts, not as trade instructions. 🔍 Interpretation Guidelines Treat the first reaction as incomplete information. A higher score means the reaction has developed more confirmation structure according to the script rules. It does not mean the reversal must continue. A failed or expired state is also useful information. It tells the user that the reaction did not confirm cleanly under the selected rules. 🚫 What This Script Is NOT • Not a prediction engine. • Not financial advice. • Not auto trading. • Not guaranteed signals. • Not a broad reversal-pattern scanner. • Not a full liquidity sweep system. • Not a generic support/resistance zone tool. ⚠️ Limitations & Transparency All outputs are rule-based and depend on the selected inputs, timeframe, and symbol behavior. Swing references confirm with natural delay. Wick structure can be noisy on low-liquidity symbols. Volume quality varies across markets. Fast volatility can cause reactions to confirm and fail quickly. The confirmation score is an internal comparison model. It is useful for reading this script's framework, but it is not an objective probability model. 🧠 Market Context Notes Reversal confirmation is strongest when price reacts from a meaningful extension, then follows through with cleaner close behavior and improving participation. The script is intentionally focused on the confirmation phase. It does not attempt to map every higher-timeframe structure, order block, fair value gap, harmonic pattern, or reversal formation. 🧾 Use Case Examples When price sweeps below a recent swing low, closes back above it, then starts progressing through the confirmation pocket, the planner may shift from REACTION to BUILDING or CONFIRMING. When price confirms but the room/risk readout is weak, the user can see that the reversal may be structurally less attractive inside this framework. When price violates the invalidation edge before confirmation, the planner marks the context as FAILED instead of leaving the reaction visually ambiguous. 🧱 System Philosophy The AGPro approach is to build decision engines, not decorative signal boards. This script focuses on one clear question: did the reversal reaction earn confirmation, or is it still only a reaction? 🔐 Non-Promise Statement No script can confirm future price movement with certainty. This tool provides structured context, not guarantees. 📉 Risk Disclosure Trading involves risk. This script is for educational, analytical, and chart-review purposes only. It does not provide financial advice, investment advice, or guaranteed trading outcomes. Users remain responsible for their own decisions, risk management, position sizing, and broader market analysis. 📚 Educational Note Use the planner to study how reactions mature, fail, expire, or confirm under consistent rules. The value is in disciplined interpretation, not in treating any single label as a complete trading system.

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

Initial Balance Break Planner [AGPro Series]Initial Balance Break Planner 🧠 Core Idea Is the Initial Balance break being accepted, or is it becoming vulnerable to failure back inside the balance? 📌 Overview / What it does Initial Balance Break Planner is an intraday session planning tool built around the first major balance of the trading session. It maps a configurable Initial Balance window, tracks the first break beyond that balance, and evaluates whether that break has enough quality to deserve structured review. The default showcase workflow is designed for intraday charts up to 60 minutes. The script produces a locked Initial Balance box, break review labels, acceptance labels, failure-risk labels, failed-IB markers, target rails, and an invalidation reference. The panel summarizes the active state through IB State, Break Side, Acceptance Score, Failure Risk, and Action. It does not predict future price movement, automate trades, or tell the user what to buy or sell. It is a rule-based decision-support overlay for reading Initial Balance behavior with more structure. 🎯 Purpose & Design Philosophy This script was built to solve a common intraday problem: many traders can see that price broke the first balance, but they still need a cleaner way to judge whether that break is accepted, stretched, weak, or vulnerable. The tool is designed for traders who use session structure, Initial Balance concepts, intraday breakouts, and structured risk review. Its purpose is not to create another simple breakout signal. Its purpose is to turn the Initial Balance break into a practical planning framework. The design philosophy is simple: map the balance, evaluate the break, show the risk, project the planning rails, and keep the next action readable. ⚡ Why This Script Is Different Most opening-range tools focus on basic breakout direction, raw high/low levels, or target projections. This script does NOT clone ORB Quality or Opening Range Failure Zones. ORB Quality is focused on opening range breakout quality and drive continuation. Opening Range Failure Zones is focused on failed opening range probes and reclaim zones. Instead, Initial Balance Break Planner focuses on the post-IB decision layer: is the first Initial Balance break accepted, does the retest response support the break, where is the invalidation reference, where are the target rails, and what should the trader review next? ⚙️ Methodology 1. Context Detection The script builds the Initial Balance from a configurable session window. The default uses the first 60 minutes of the New York regular session. 2. Reference Mapping Once the IB window ends, the script locks the IB high, IB low, and midpoint. The box remains centered with an internal state label so the chart stays visually clear. 3. Reaction Evaluation After the first break, the planner scores the setup using: • IB width • Break close quality • Retest response • Relative volume support • Volatility fit 4. Visual Output The chart displays break labels, acceptance labels, risk-review labels, failed-IB markers, target rails, and an invalidation rail. The panel converts the model into a compact next-action state. 🗺️ How to Read the Chart The Initial Balance box represents the first session balance selected by the user. Break labels show when price closes beyond the IB edge with enough buffer to start review. Acceptance labels appear when the break has enough score, enough confirmation time, and controlled failure risk. Failure-risk labels warn that the break is weakening or returning back inside the balance. Target rails show measured planning references from the broken IB edge. The invalidation rail marks the area where the break begins losing acceptance quality. Panel colors summarize the current state: • Teal → stronger acceptance or constructive long-side context • Pink → bearish break side or failed context • Amber → watch, risk review, or unresolved state • Indigo / blue → active planning context 🚦 Signals & States • IB READY → the Initial Balance has locked and the planner is ready to track the first break • BREAK UP REVIEW → price closed beyond the upper IB edge and long-side review has started • BREAK DOWN REVIEW → price closed beyond the lower IB edge and short-side review has started • RETEST HOLD → price retested the broken IB edge without clearly losing it • ACCEPTED → the break met the acceptance threshold with controlled failure risk • RISK REVIEW → the break is not yet accepted and failure vulnerability is rising • FAILED IB → price failed back inside the Initial Balance with elevated weakness context 🔔 Alerts Logic Alerts trigger when the script detects: • A bullish IB break review • A bearish IB break review • Bullish IB acceptance • Bearish IB acceptance • Failure-risk review • Failed return back inside the IB Alerts are attention markers only. They are not trade instructions. 🧩 Confluence Logic The strongest context appears when the break close is clean, the IB width is balanced, volume is supportive, volatility is not overheated, and the retest response holds the broken edge. When these elements align, the Acceptance Score improves and the panel can move from Observe Retest into Review Long or Review Short. 📊 When to Use • Intraday markets with clear session structure • 1-minute to 60-minute charts • Index, futures, FX, and liquid crypto sessions • Initial Balance breakout review • Session expansion planning • Post-break retest evaluation • Risk and target planning after the first session balance breaks ⚠️ When NOT to Use • Very low-liquidity symbols • Extremely noisy micro timeframes • Markets with poor session definition • Events with abnormal volatility spikes • Symbols where volume data is unreliable and should not be weighted heavily • Higher timeframes where the selected IB session has little practical meaning • 4H, daily, weekly, or monthly charts where a one-session Initial Balance cannot be mapped cleanly 🎛️ Key Inputs • Initial Balance Window → defines the balance-building period • Tracking Session → defines when break review can update • Sensitivity → adjusts how selective the planner is • Acceptance Lookback → controls the review window after the first break • Minimum Acceptance Score → sets the threshold for accepted-break states • Confirmation Mode → chooses confirmed-bar behavior or live updating • Break Buffer ATR → controls how far price must close beyond the IB edge • Retest Response Buffer ATR → controls retest tolerance around the broken edge • Failure Buffer ATR → controls how quickly returning inside the IB raises risk • Target Rail Multiples → control measured target references • Max Visible IB Boxes → controls how many recent balance boxes stay on the chart • Max Visible Labels → controls how many recent event labels stay on the chart • Show IB Ready Labels → optionally displays a readiness label when the Initial Balance locks • Visual Settings → control labels, box count, rail projection, and spacing • Panel Settings → control panel visibility, location, theme, and font size 🖥️ Interface & Visual Design The script uses a chart-first design. The Initial Balance box is the main anchor, and the centered box label keeps the active state visible without requiring a large dashboard. Event labels are deliberately compact and offset away from candles. Target rails and invalidation rails are projected only after a break, so the chart remains clean during the balance-building phase. The AG Pro panel uses a single merged blue header row and five compact rows so the user can quickly scan state, side, score, risk, and action. 🧪 Practical Usage Workflow 1. Read the panel after the Initial Balance locks. 2. Wait for price to break one IB edge. 3. Check whether the break receives a clean score or moves into risk review. 4. Watch the broken edge for retest behavior. 5. Use the target rails and invalidation rail as planning references. 6. Interpret the result within broader market context. 🔍 Interpretation Guidelines The Acceptance Score is a quality score, not a prediction. Higher scores mean the break has better internal structure according to the script's rules. Failure Risk is a warning layer. It rises when price loses acceptance quality, moves back inside the IB, shows weak close behavior, or lacks participation. The Action row is the most practical summary. It helps the user decide whether the environment is still building, waiting, reviewing, accepted, vulnerable, or better left alone. 🚫 What This Script Is NOT • Not a prediction engine • Not financial advice • Not auto trading • Not guaranteed signals • Not a generic ORB breakout system • Not Opening Range Failure Zones • Not a broad support/resistance or order-block map ⚠️ Limitations & Transparency Initial Balance behavior changes across symbols, sessions, and timeframes. A 60-minute IB on one market may behave differently from the same window on another market. Relative volume can be less useful on symbols where reported volume is incomplete or inconsistent. Fast news events, thin liquidity, and unusual volatility can reduce the usefulness of any session-break model. The script evaluates rule-based context only. It cannot know future order flow or guarantee what price will do next. 🧠 Market Context Notes Initial Balance analysis is most useful when the session has a meaningful opening phase and a clear expansion phase. A clean break usually needs more than a line cross. The break should show location, acceptance, participation, and controlled risk. A weak break can still travel further, and a strong break can still fail. The script is designed to help structure the review, not remove uncertainty. 🧾 Use Case Examples When price breaks above the IB high, receives a strong acceptance score, holds the broken edge on retest, and keeps failure risk low, the panel may move into Review Long. When price breaks below the IB low but quickly returns back inside the balance with weak close quality, the panel may move into Failure Watch or Failed Back In. When the IB is too wide, volatility is unstable, and the break lacks volume support, the planner can remain cautious even if price has crossed the edge. 🧱 System Philosophy The AGPro Series approach is built around decision structure, not raw signal output. Initial Balance Break Planner follows that philosophy by combining a visible session reference with a score, risk layer, target references, and a next-action panel. The goal is to make the chart easier to interpret without making the chart crowded. 🔐 Non-Promise Statement This script does not provide certainty. It does not guarantee that an accepted break will continue or that a vulnerable break will reverse. All outputs should be interpreted as structured analytical context. 📉 Risk Disclosure Trading involves risk. Users are responsible for their own analysis, execution, and risk management. This script is not financial advice and does not provide guaranteed trading outcomes. 📚 Educational Note Initial Balance analysis can help traders study how a session moves from balance into expansion, but it should always be combined with broader market structure, liquidity, volatility, and personal execution rules.

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

Volatility Stop Run Planner [AGPro Series]Volatility Stop Run Planner 🧠 Core Idea Is the current volatility spike a stop-run review context, or is it behaving more like real expansion? 📌 Overview / What it does Volatility Stop Run Planner is a chart-first volatility risk and execution-readiness tool designed to evaluate sharp ATR expansion around recent range edges. The script studies wick expansion, ATR load, close recovery, range-edge penetration, reclaim quality, and early follow-through. It then converts qualified events into a 0-100 planner score, a clear next-action state, reclaim guides, invalidation guides, target-room references, stop-run review zones, expansion review zones, and a clean AGPro planning panel. It does not predict where price must go next. It does not automate entries or exits. It is built to organize volatile stop-run and expansion contexts so traders can evaluate the event with more structure. 🎯 Purpose & Design Philosophy This script was built for traders who need a practical decision framework during fast volatility spikes. Many charts look most confusing exactly when volatility expands: wicks stretch, stops may be triggered, range edges are breached, and the candle can either reclaim or continue. This planner fills that gap by asking whether the spike is showing stop-run characteristics, real expansion behavior, or a cooldown state that still needs confirmation. The design supports a planning mindset: identify the event, evaluate quality, locate the reclaim level, define invalidation context, estimate target room, and decide what deserves attention next. ⚡ Why This Script Is Different Most stop-run tools focus on liquidity sweeps, stop-hunt zones, or level raids. This script does NOT try to become another liquidity grab detector, stop-hunt map, order block map, or generic sweep marker. Instead, it focuses on the volatility event itself. It evaluates whether a spike around a recent range edge is recovering, rejecting, expanding, or entering a cooldown window. The core output is not a buy or sell signal. It is a planner state that helps the user decide whether the current volatility context deserves review, patience, or no action. ⚙️ Methodology 1. Context Detection The script measures ATR load, candle range relative to ATR, wick dominance, body efficiency, and recent range-edge interaction. 2. Reference Mapping It maps the recent high / low reference range, the reclaim level, the spike extreme, the invalidation guide, and the target-room reference. 3. Reaction Evaluation The model scores stop-run risk, reclaim quality, volatility load, range-edge penetration, and expansion quality. These components are blended into a 0-100 planner score. 4. Visual Output Qualified events are displayed through stop-run review zones, expansion review zones, reclaim lines, active risk / target guides, optional volatility cooldown boxes, premium labels, alerts, and a compact AGPro panel. 🗺️ How to Read the Chart Zones = stop-run or expansion review areas created around qualified volatility spike events. Labels = compact event markers showing the detected context, planner score, score tier, and next-action state. Colors = bullish reclaim contexts use AGPro teal, bearish reclaim contexts use AGPro pink, and expansion / neutral review contexts use controlled accent tones. Panel = the panel summarizes Spike State, Planner Score, Stop-Run Risk, Reclaim Quality, Risk / Target, Volatility Load, and Action. 🚦 Signals & States • Bull Stop-Run → downside spike below the recent range edge followed by reclaim-quality behavior. • Bear Stop-Run → upside spike above the recent range edge followed by rejection-quality behavior. • Expansion Up → volatility spike closes cleanly above the recent range edge with stronger body efficiency. • Expansion Down → volatility spike closes cleanly below the recent range edge with stronger body efficiency. • Spike Watch → volatility is elevated, but the candle has not yet produced enough reclaim or expansion evidence. • Normal Load → no qualified volatility event is currently detected. 🔔 Alerts Logic Alerts trigger when the planner detects a qualified Bull Stop-Run Review, Bear Stop-Run Review, Expansion Up Review, Expansion Down Review, or Spike Watch context. These alerts are attention markers. They are not trade instructions, entry signals, exit signals, or automated strategy commands. 🧩 Confluence Logic The strongest planner states appear when multiple conditions align: ATR spike + wick expansion + range-edge penetration + reclaim quality + clean risk / target context. When the spike reclaims the reference level with strong wick rejection, the stop-run review context becomes stronger. When the candle closes beyond the range edge with strong body efficiency, the expansion review context becomes stronger. 📊 When to Use • Around sudden volatility spikes • Near recent range highs or lows • During breakout or breakdown attempts • After large wick candles that need structured interpretation • When deciding whether a fast move deserves review, patience, or no action ⚠️ When NOT to Use • Extremely low-liquidity symbols • Very noisy micro-timeframes • News-driven candles with abnormal gaps • Markets where ATR is distorted by isolated historical spikes • Situations where the user expects a simple signal-only entry tool 🎛️ Key Inputs • Sensitivity → controls how selective the spike and stop-run planner should be. • Reference Lookback → defines the recent range edge used for spike evaluation. • ATR Length → normalizes volatility, invalidation, target room, and label spacing. • Minimum Planner Score → sets the score required before events are drawn. • Confirmation Mode → controls how strict reclaim or expansion confirmation should be. • Cooldown Bars → defines the post-spike visual review window. • Visual settings → control zones, labels, guides, panel theme, panel location, and font sizes. 🖥️ Interface & Visual Design The interface is designed to stay chart-first. The panel provides the decision summary. The chart zones show where the volatility event happened. The reclaim line identifies the reference level. The risk / target guides frame the active review context without turning the script into a trade command system. The visual hierarchy is intentionally compact, premium, and readable. 🧪 Practical Usage Workflow 1. Read the panel to identify the current Spike State and Planner Score. 2. Check whether the chart is showing a stop-run review, expansion review, or spike watch context. 3. Compare the reclaim line with the candle close and wick behavior. 4. Review the invalidation and target-room guides. 5. Interpret the event within broader market structure and volatility conditions. 🔍 Interpretation Guidelines A high stop-run risk score means the spike has stronger rejection and reclaim characteristics. A high expansion score means the spike is behaving more like continuation through the range edge. A cooldown window means the event needs follow-through review rather than immediate interpretation. No single score should be read in isolation. The strongest use case is to combine the planner state with structure, liquidity, trend, and timeframe context. 🚫 What This Script Is NOT • Not a prediction engine • Not financial advice • Not an auto trading system • Not a guaranteed signal tool • Not a liquidity grab detector • Not a stop-hunt zone map • Not an order block or FVG map ⚠️ Limitations & Transparency Volatility behavior changes across symbols, sessions, and timeframes. ATR can expand sharply during news, low-liquidity gaps, or abnormal market conditions. Some stop-run-looking candles can still continue in the same direction. Some expansion-looking candles can fail quickly. The script provides structured context, not certainty. 🧠 Market Context Notes Stop-run behavior often appears when price briefly trades through visible reference areas and then reclaims them. Expansion behavior often appears when price accepts beyond the reference with stronger body efficiency and less rejection. The planner is designed to help users separate these contexts with a consistent rule-based framework. 🧾 Use Case Examples When price spikes below a recent low, leaves a large lower wick, and closes back above the reference, the script may classify the event as a Bull Stop-Run Review. When price expands above a recent high with a strong body close and limited upper rejection, the script may classify the event as Expansion Up. When volatility spikes but reclaim or expansion evidence is incomplete, the script may show Spike Watch or keep the event in cooldown. 🧱 System Philosophy Volatility Stop Run Planner follows the AGPro Series decision-engine approach: Context first. Risk before reaction. Reclaim before assumption. Expansion quality before excitement. Attention markers instead of promises. 🔐 Non-Promise Statement No indicator can remove uncertainty. No state, score, label, alert, line, or zone should be interpreted as guaranteed market direction. 📉 Risk Disclosure Trading involves risk. Users remain responsible for their own analysis, risk management, and decisions. This script is for educational and analytical purposes only and does not provide financial advice. 📚 Educational Note The script is designed to make volatile candles easier to review by separating stop-run behavior, expansion behavior, and cooldown context into a clean visual planning workflow.

Indicator

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

Indicator

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

Indicator

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

Indicator

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

Indicator

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

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

Indicator

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

Indicator

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

Indicator

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

Indicator

Trade Management Map [AGPro Series]

Indicator

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

Indicator

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

Indicator

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

Indicator

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