OPEN-SOURCE SCRIPT
Mis à jour

R-Multiple Progress Map [AGPro Series]

587
R-Multiple Progress Map [AGPro Series]

🧠 Core Idea

How far has the active move progressed in R terms, and is that progress still healthy enough to monitor?


📌 Overview / What it does

R-Multiple Progress Map [AGPro Series] is a chart-first trade management overlay that tracks a setup after activation and converts price movement into R-multiple progress.

Instead of acting like a risk/reward calculator, a position sizing tool, or a take-profit promise system, the script focuses on what happens after an active cycle begins. It maps an entry proxy, invalidation proxy, R ladder, current R marker, partial-review bands, pullback-risk state, and a clean AGPro progress panel.

The script does not predict future price movement, place orders, automate trade management, or tell the user what to buy or sell. It is a structured progress-reading layer for discretionary review.


🎯 Purpose & Design Philosophy

This script was built for traders who think in R-multiples but need a cleaner way to read progress quality after a setup becomes active.

Many tools help plan the trade before activation. Fewer tools focus on the management question after activation: is the move actually making progress, is pullback pressure increasing, where is the next R review zone, and what should the user pay attention to now?

The design supports a decision-engine mindset: measure progress, evaluate health, and keep the chart readable without turning it into a crowded signal board.


⚡ Why This Script Is Different

Most tools focus on drawing entry, stop-loss, and take-profit levels before a trade begins.

This script does NOT try to become a full position planner, risk/reward visualizer, position-size calculator, or target ladder.

Instead, it starts from an activated progress cycle and evaluates the move in R terms. The unique output is not a trade instruction. It is a live progress state that separates ACTIVE, BUILDING, PROGRESSING, EXTENDED, PULLBACK RISK, STALLED, INVALIDATED, and WAIT conditions.


⚙️ Methodology

1. Context Detection
The script detects activation using range-break and trend-pulse logic, or allows the user to restrict the map to long-only or short-only progress context.

2. Reference Mapping
When a progress cycle activates, the script stores an entry proxy, invalidation proxy, R-risk unit, active side, active bar, maximum favorable R progress, and adverse R pressure.

3. Reaction Evaluation
The model evaluates R expansion, candle progress, trend support, drawdown pressure, time efficiency, and volatility stability. These components are blended into a 0-100 progress score.

4. Visual Output
The output is shown through an R ladder, centered partial-review bands, live progress fill, current R marker, event labels, alerts, and a compact AGPro panel.


🗺️ How to Read the Chart

Zones = partial-review R bands between key R levels, such as 0.5R-1R, 1R-2R, and 2R-3R.

Labels = activation, R milestone, pullback-risk, stalled-progress, and invalidation markers.

Colors = bullish progress, bearish progress, warning states, and neutral states use the AGPro color language.

Panel = the panel summarizes Current R, Progress Grade, Pullback Risk, Next R Zone, and Action.


🚦 Signals & States

• ACTIVE → a new progress cycle has activated and early R progress is being measured.

• BUILDING → price has started to make useful R progress but is not yet strong enough for a higher-grade state.

• PROGRESSING → the move has reached meaningful R progress with supportive score conditions.

• EXTENDED → progress is advanced and the next R zone deserves review.

• PULLBACK RISK → price has given back enough favorable R progress to deserve caution.

• STALLED → the active cycle has spent time without enough R progress.

• INVALIDATED → the active cycle touched the invalidation proxy.

• WAIT → no active progress cycle is currently being tracked.


🔔 Alerts Logic

Alerts trigger when a new progress cycle activates, when 0.5R, 1R, or 2R progress is reached, when pullback risk increases, when progress stalls, or when the invalidation proxy is touched.

These alerts are attention markers. They are not trade instructions, entry signals, exit signals, or automated strategy commands.


🧩 Confluence Logic

The strongest progress context appears when multiple components align:

R expansion + strong candle progress + trend support + controlled pullback drawdown + efficient timing + stable volatility.

When these components align, the script can classify the active move as PROGRESSING or EXTENDED. If drawdown pressure rises or time efficiency weakens, the state can shift toward PULLBACK RISK or STALLED.


📊 When to Use

• After a breakout or continuation attempt has activated

• While monitoring whether a setup is progressing in clean R terms

• During discretionary trade management review

• When comparing whether a move is building, stalling, or extending

• When the user wants chart-first R progress without a full position-size calculator


⚠️ When NOT to Use

• Extremely low-liquidity symbols

• Very noisy micro-timeframes with unstable wick behavior

• News-driven volatility spikes

• Markets where recent structure cannot define a useful invalidation proxy

• Situations where the user expects a complete risk/reward planning suite


🎛️ Key Inputs

• Progress Side → controls Auto, Long Progress, or Short Progress evaluation.

• Activation Mode → chooses Range Break, Trend Pulse, or Hybrid activation logic.

• Structure Lookback → defines the activation and context window.

• Invalidation Proxy Lookback → maps the R-risk reference used for progress normalization.

• Minimum Activation Score → controls how selective new progress cycles are.

• Pullback Risk R → defines how much R drawdown triggers caution.

• Visual settings → control R ladder, partial-review bands, progress fill, labels, panel location, theme, and font sizes.


🖥️ Interface & Visual Design

The interface is built around one primary idea: R progress after activation.

The R ladder and partial-review bands keep the chart visually informative, while the panel keeps the decision state compact and readable.

Labels are offset away from candles, limited by maximum count, and controlled with cooldown and sparse context settings for a balanced public-release chart.


🧪 Practical Usage Workflow

1. Read the panel action state.

2. Check the current R and maximum R progress.

3. Review whether pullback risk is low, moderate, or high.

4. Look at the next R zone for management context.

5. Treat alerts as attention markers and confirm the broader market context independently.


🔍 Interpretation Guidelines

A higher progress score means the active move is showing stronger alignment between R expansion, trend support, drawdown control, time efficiency, and volatility stability.

PROGRESSING does not mean a trade should be opened or held. It means the active cycle is showing healthier R progress under the script's rule set.

PULLBACK RISK and STALLED are caution states. They help identify when progress may be weakening after an active move has already started.


🚫 What This Script Is NOT

This script is not a prediction engine.

It is not financial advice.

It is not an auto-trading system.

It does not provide guaranteed signals.

It is not a full position planner, risk/reward visualizer, or position-size calculator.


⚠️ Limitations & Transparency

Timeframe differences can change activation behavior and invalidation proxy placement.

Volatility changes can alter ATR-normalized risk and R-progress readings.

Market structure can shift quickly after news, low-liquidity movement, or aggressive momentum expansion.

The script is rule-based and should be interpreted as an analytical progress layer, not as certainty.


🧠 Market Context Notes

R progress is not only about distance from activation. It also depends on how much progress is being retained, whether trend context still supports the active side, and whether time spent in the setup is becoming inefficient.

The tool is most useful when it helps the user review an active move with discipline instead of reacting emotionally to each candle.


🧾 Use Case Examples

When a trend-pulse activation reaches 1R with strong score conditions and low drawdown, the script may classify the move as PROGRESSING.

When a move reaches 2R but begins giving back a meaningful amount of favorable progress, the script may show PULLBACK RISK.

When a cycle stays active for many bars without reaching useful R progress, the script may show STALLED.


🧱 System Philosophy

R-Multiple Progress Map follows the AGPro Series decision-engine approach:

Progress after activation.
Risk measured in R.
Management context before emotion.
Attention markers instead of promises.


🔐 Non-Promise Statement

No script can guarantee that R progress will continue.

No state should be interpreted as certainty.

All outputs should be reviewed within broader market context.


📉 Risk Disclosure

Trading involves risk.

Users are responsible for their own decisions, risk management, and trade execution.

This script is for educational and analytical purposes only and does not provide financial advice.


📚 Educational Note

The script is designed to help users think in structured R-progress terms: activation, progress, pullback, stall, invalidation, and review.
Notes de version
UPDATE NOTES - V1.2

This update focuses on Editors Picks readiness, cleaner publication screenshots, label discipline, R-ladder clarity, and premium chart presentation.

The core purpose of the script remains unchanged.
This release improves how the existing R-multiple progress logic is presented, organized, and interpreted on the chart.

This script continues to function as an analytical and visualization tool.
It does not attempt to predict price direction or provide guaranteed outcomes.


------------------------
What Changed
------------------------

* Tightened publication label discipline
Pullback-risk warnings now print once per active R cycle by default, preventing repeated PB RISK labels from dominating the chart.

* Added pullback and expiry label controls
Pullback-risk and expiry labels can now be controlled separately, with expired labels disabled by default for a cleaner public-release view.

* Reduced default maximum visible labels
The default maximum label count was lowered so milestone, activation, and risk labels remain informative without turning the chart into a signal board.

* Refined R-band opacity
Partial-review bands and the live progress fill now use a lighter visual footprint while preserving centered zone text.

* Preserved the core R-progress model
The activation model, R ladder, pullback-risk logic, progress score, and panel interpretation remain aligned with the original script purpose.

* Kept panel conformity
The AG Pro blue merged panel header, panel controls, and publication-ready information flow remain in place.


------------------------
Visual Improvements
------------------------

* Improved chart readability by reducing repeated pullback-risk labels

* Reduced visual clutter around expiry and pullback-risk states

* Refined visual hierarchy so the R ladder and progress fill carry the main message

* Kept partial-review band labels centered inside each R-progress zone

* Adjusted defaults for cleaner screenshot quality and better first-glance interpretation


------------------------
Interface & Usability
------------------------

* Optimized panel layout for clearer information flow

* Added Best View guidance directly in the panel

* Preserved user control over panel visibility, panel location, panel theme, label font size, and panel font size

* Improved label readability with calmer defaults and stronger spacing control

* Added cleaner preset behavior for different market-review styles


------------------------
Behavior Notes
------------------------

This update does not change the core analytical purpose of the script.

The goal is to improve clarity and usability, not to introduce predictive behavior.

R milestones, pullback-risk states, stall states, invalidation states, and expiry states remain attention markers.
They are not trade instructions.

Users should interpret outputs the same way as before, but with improved visual structure and cleaner label rhythm.


------------------------
Limitations Reminder
------------------------

The script remains a rule-based analytical tool.

Market conditions such as volatility, liquidity, trend quality, and timeframe differences may affect how R-progress cycles appear.

Proxy invalidation levels are used for analytical normalization only and should not be treated as automatic stop-loss instructions.

Outputs should always be interpreted within broader market context.


------------------------
Risk Reminder
------------------------

This script is for educational and analytical purposes only.

It does not provide financial advice or guaranteed trading outcomes.

Users remain responsible for their own decisions.
Notes de version
UPDATE NOTES - V1.3

This update focuses on visual hierarchy, R-zone readability, and risk-management workflow clarity.

The core purpose of the script remains unchanged.
This release improves how the existing R-multiple progress logic is presented, organized, and interpreted on the chart.

This script continues to function as an analytical and visualization tool.
It does not attempt to predict price direction or provide guaranteed outcomes.


------------------------
What Changed
------------------------

* Rebuilt the panel into a clearer R-progress dashboard.
The panel now prioritizes Workflow, Current R, Risk Unit, Invalidation, Pullback, Next R Zone, and Review View.

* Added live right-edge review tags.
The chart now shows compact tags for workflow state, current R, maximum R, progress score, pullback pressure, and invalidation context.

* Improved R-zone storytelling.
The 0.5R-1R, 1R-2R, and 2R-3R bands now use stronger contrast settings and centered labels designed to remain readable in publication screenshots.

* Refined workflow language.
Action labels now use clearer review-oriented language such as TRACK EARLY R, WATCH 1R QUALITY, REVIEW PULLBACK, REVIEW PROTECTION, and RESET MAP.

* Improved label spacing defaults.
The default label offset and retained label count were adjusted to keep event markers away from candles while preserving a more complete chart story.


------------------------
Visual Improvements
------------------------

* Improved chart readability by separating milestone labels, R-zone bands, live tags, and the panel hierarchy.

* Strengthened R-zone borders and fills so zone text does not disappear on dark or light chart themes.

* Added a connector from the live review tag area back to the active progress context.

* Kept chart-facing labels uppercase, compact, and suitable for TradingView publication screenshots.


------------------------
Interface & Usability
------------------------

* Preserved the single merged blue AG Pro panel header.

* Confirmed Show Panel, Panel Location, Panel Theme, Panel Font Size, and Label Font Size controls.

* Routed visible chart labels, live tags, and R-zone text through the Label Font Size input.

* Updated the panel reset pattern so the merged header is preserved safely during panel refreshes.


------------------------
Behavior Notes
------------------------

This update does not change the core R-multiple activation, invalidation, progress score, or milestone logic.

The goal is to improve clarity and usability, not to introduce new predictive behavior.

Users should interpret outputs the same way as before, but with improved visual structure and cleaner risk-review wording.


------------------------
Limitations Reminder
------------------------

The script remains a rule-based analytical tool.

Market conditions such as volatility, liquidity, symbol behavior, and timeframe differences may affect how progress cycles appear.

Outputs should always be interpreted within broader market context.


------------------------
Risk Reminder
------------------------

This script is for educational and analytical purposes only.

It does not provide financial advice or guaranteed trading outcomes.

Users remain responsible for their own decisions.
Notes de version
🔧 UPDATE NOTES - V1.5

This update focuses on live-tag readability, right-side spacing, and level attachment clarity.

The core purpose of the script remains unchanged.
This release improves how the existing R-progress logic is presented and interpreted on the chart.

This script continues to function as an analytical and visualization tool.
It does not attempt to predict price direction or provide guaranteed outcomes.


------------------------
What Changed
------------------------

• Refined the right-side live review stack
Workflow, current R, score, and pullback badges now use a cleaner fixed vertical lane so they do not overlap in compressed price ranges.

• Added Live Tag Spacing ATR
Users can now control the vertical spacing between live review badges directly from the visual settings.

• Separated invalidation from the live-info stack
The invalidation tag remains attached to the invalidation level, but it now uses a separate right-side lane so it does not collide with workflow or score badges.

• Extended level references to the tag area
Entry and invalidation guide lines now extend toward the live tag area so level-attached labels remain visually connected to actual references.


------------------------
Visual Improvements
------------------------

• Improved chart readability by spacing live review badges more cleanly

• Reduced overlap between workflow, current R, score, pullback, and invalidation tags

• Refined visual hierarchy so informational badges and real level tags are easier to distinguish

• Adjusted positioning of elements to avoid overlap with candles and active R-map objects


------------------------
Interface & Usability
------------------------

• Added a new Live Tag Spacing ATR control for publication-quality layout tuning

• Preserved the existing Live Tag Offset Bars control

• Kept the AG Pro panel layout, theme controls, location controls, and font-size controls unchanged

• Improved first-glance readability without changing the underlying progress model


------------------------
Behavior Notes
------------------------

This update does not change the core analytical logic of the script.

The goal is to improve clarity and usability, not to introduce new predictive behavior.

Users should interpret outputs the same way as before, but with improved visual structure.


------------------------
Limitations Reminder
------------------------

The script remains a rule-based analytical tool.

Market conditions such as volatility, liquidity, and timeframe differences may affect how signals appear.

Outputs should always be interpreted within broader market context.


------------------------
Risk Reminder
------------------------

This script is for educational and analytical purposes only.

It does not provide financial advice or guaranteed trading outcomes.

Users remain responsible for their own decisions.
Notes de version
🔧 UPDATE NOTES - v1.6

This update focuses on decision confidence and proof.

The core purpose of the script remains unchanged.
This release adds a confirmation-anchored proof layer that measures how often
activated R-cycles reached 1R before invalidation on the current symbol.

This script continues to function as an analytical and visualization tool.
It does not attempt to predict price direction or provide guaranteed outcomes.


------------------------
What Changed
------------------------

• Added a Proof Layer (Follow / Hold / React / Flip)
The panel now reports how reliably activated R-cycles progressed on the current symbol and
timeframe. Each time a cycle activates, it is tracked forward over a configurable horizon
with its entry proxy, invalidation proxy, and risk unit frozen at activation:
- Follow Rate : share of activated cycles that reached 1R in favor before touching the
invalidation proxy
- Hold Rate : share whose invalidation proxy was not touched through resolution
- React Rate : share that produced an early favorable R reaction
- Flip Rate : share whose invalidation proxy was touched within the horizon
A sample size (n) is shown so the rates are read in context, and they display as
"building" only until the first activated cycle resolves.

• Added rate outputs to the hidden data plots
The Follow / Hold / React / Flip rates join the existing current-R, maximum-R, drawdown-R,
progress score, and adverse-R outputs as hidden plots so they can be referenced by alerts,
screeners, or other tools without changing the chart visuals.


------------------------
Visual Improvements
------------------------

• Grouped the proof metrics into a clean block under a dedicated "Proof @ Confirm" heading,
below the existing progress rows.

• Preserved the existing R ladder, partial-review bands, progress fill, centered badges,
live review stack, and event labels.

• Refined panel structure so the workflow, current R, risk unit, invalidation, pullback,
next R zone, and proof context form a single, scannable management card.

• Kept band badges centered in their bands and all event labels offset away from candles
for clean readability.


------------------------
Interface & Usability
------------------------

• Optimized panel layout for clearer information flow with the new proof block.

• Improved at-a-glance interpretation by reporting how often activated cycles reached 1R
before invalidation.

• Adjusted default visual settings for a more balanced appearance.

• Added a Proof input group (show/hide, proof horizon bars, reaction window bars, reaction
progress threshold) so the proof layer is fully configurable without affecting the core
R-progress logic.


------------------------
Behavior Notes
------------------------

This update does not change the core analytical logic of the script.

The proof rates are descriptive statistics of activated R-cycles on the current symbol and
timeframe. They measure how often a cycle reached 1R before its invalidation proxy, not
trade performance, and they do not change how the progress score or workflow state is
classified.

Users should interpret outputs the same way as before, now with added reliability context.


------------------------
Limitations Reminder
------------------------

The script remains a rule-based analytical tool.

Proof rates depend on the amount of available history and on how many cycles have activated
on the current symbol and timeframe; a small sample (low n) should be treated with caution.
Each activated cycle is counted once, with its entry proxy, invalidation proxy, and risk
unit frozen at activation. Market conditions such as volatility, liquidity, and timeframe
differences may affect how cycles and rates appear.

Outputs should always be interpreted within broader market context.


------------------------
Risk Reminder
------------------------

This script is for educational and analytical purposes only.

It does not provide financial advice or guaranteed trading outcomes.

Users remain responsible for their own decisions.

Clause de non-responsabilité

Les informations et publications ne sont pas destinées à être, et ne constituent pas, des conseils ou recommandations financiers, d'investissement, de trading ou autres fournis ou approuvés par TradingView. Pour en savoir plus, consultez les Conditions d'utilisation.