deploy: 71b99ada26

api/public-contract/index.html

@@ -425,6 +425,10 @@ strategy entries, exits, Kelly sizing, or signal logic.</p>
 <td><code>OrderSide</code>, <code>OrderFillingMode</code>, <code>OrderTimeMode</code>, <code>PositionSide</code>, <code>ExecutionStatus</code></td>
 <td>Typed enums for order helpers</td>
 </tr>
+<tr>
+<td><code>ProjectionMode</code></td>
+<td>Literal type for <code>calculate_symbol_group_margin_ratio</code> projection</td>
+</tr>
 </tbody>
 </table>
 <p><code>MT5Client.order_send()</code> and CLI <code>order-send --yes</code> are live execution paths.</p>
@@ -546,6 +550,12 @@ the MT5 SDK helper.</p>
 </tr>
 </tbody>
 </table>
+<p><code>calculate_symbol_group_margin_ratio</code> supports an optional <code>projection_mode</code>
+parameter (<code>"add"</code> by default). Pass <code>projection_mode="replace_symbol"</code> to
+subtract current exposure for <code>new_symbol</code> before adding the candidate margin —
+useful for reversal-style projections. mt5cli only calculates broker-facing
+exposure; downstream applications own thresholds, risk guard actions, and
+strategy policy.</p>
 <h2 id="cli-commands">CLI commands<a class="headerlink" href="#cli-commands" title="Permanent link">&para;</a></h2>
 <p>The Typer application in <code>mt5cli.cli</code> exposes file-export commands documented in
 <a href="../cli/">CLI Module</a> and the project README. CLI commands:</p>
@@ -556,7 +566,12 @@ the MT5 SDK helper.</p>
 <li>Delegate to the same Python APIs described here; they are not duplicated
   business logic.</li>
 </ul>
-<p><code>order-send</code> requires <code>--yes</code> before placing live trades.</p>
+<p><code>order-send</code> is the expert raw-request path; it requires <code>--yes</code> and a fully
+constructed request payload. <code>close-positions</code> is the safer high-level helper
+that closes open positions by <code>--symbol</code> or <code>--ticket</code> using
+<code>close_open_positions()</code>. Both <code>order-send --yes</code> and <code>close-positions --yes</code>
+are live execution paths. <code>close-positions --dry-run</code> previews close orders
+without placing them and does not require <code>--yes</code>.</p>
 <h2 id="internal-helpers-not-stable">Internal helpers (not stable)<a class="headerlink" href="#internal-helpers-not-stable" title="Permanent link">&para;</a></h2>
 <p>Do not import these for downstream contracts; they may change without a semver
 notice:</p>

index.html

@@ -653,5 +653,5 @@
 
 <!--
 MkDocs version : 1.6.1
-Build Date UTC : 2026-06-24 16:55:39.272524+00:00
+Build Date UTC : 2026-06-24 17:08:56.633989+00:00
 -->