mt5cli 1.3.3__tar.gz → 1.4.1__tar.gz

mt5cli-1.4.1/.agents/skills/local-qa/scripts/qa.sh

@@ -0,0 +1,41 @@
+#!/usr/bin/env bash
+
+set -euox pipefail
+cd "$(git rev-parse --show-toplevel)"
+
+COOLDOWN_DAYS=7
+export UV_EXCLUDE_NEWER="${COOLDOWN_DAYS} days"
+export NPM_CONFIG_MIN_RELEASE_AGE="${COOLDOWN_DAYS}"
+export PNPM_CONFIG_MINIMUM_RELEASE_AGE=$((COOLDOWN_DAYS * 24 * 60))
+
+# Python
+uv run ruff format .
+uv run ruff check --fix .
+uv run pyright .
+uv run pytest
+
+# Markdown and JSON
+npx -y prettier --write './**/*.{md,json}'
+
+# YAML
+git ls-files -z -- '*.yml' \
+  | xargs -0 -t uvx yamllint -d '{"extends": "relaxed", "rules": {"line-length": "disable"}}'
+
+# GitHub Actions
+case "${OSTYPE}" in
+  darwin* | linux*)
+    # Shell scripts
+    git ls-files -z -- '*.sh' '*.bash' '*.bats' \
+      | xargs -0 -t shfmt --write --indent=2 --binary-next-line --case-indent --space-redirects
+    git ls-files -z -- '*.sh' '*.bash' '*.bats' \
+      | xargs -0 -t shellcheck
+
+    # GitHub Actions
+    zizmor --fix=safe .github/workflows
+    git ls-files -z -- '.github/workflows/*.yml' | xargs -0 -t actionlint
+    checkov --framework=all --output=github_failed_only --directory=.
+    ;;
+  *)
+    echo 'GitHub Actions and shell script linting is only supported on Linux and macOS.'
+    ;;
+esac

{mt5cli-1.3.3 → mt5cli-1.4.1}/.agents/skills/mt5cli/SKILL.md

@@ -12,8 +12,8 @@ command. Output format is auto-detected from the file extension (`.csv`,
 
 ## Requirements
 
-- Python 3.11+ on Windows with MetaTrader 5 installed (pdmt5 requires the
-  MT5 terminal).
+MT5 terminal).
+
 - Install: `pip install -U mt5cli MetaTrader5`.
 - In this repo, run via `uv run mt5cli ...` or `uv run python -m mt5cli ...`.
 

mt5cli-1.4.1/.github/CODEOWNERS

@@ -0,0 +1,2 @@
+# Default owner
+* @dceoy

{mt5cli-1.3.3 → mt5cli-1.4.1}/.github/workflows/ci.yml

@@ -35,7 +35,7 @@ jobs:
       || (github.event_name == 'workflow_dispatch' && inputs.workflow == 'lint-and-test')
     permissions:
       contents: read
-    uses: dceoy/gh-actions-for-devops/.github/workflows/python-package-lint-and-scan.yml@main   # zizmor: ignore[unpinned-uses]
+    uses: dceoy/gha-for-devops/.github/workflows/python-package-lint-and-scan.yml@main   # zizmor: ignore[unpinned-uses]
     with:
       package-path: .
       runs-on: windows-latest
@@ -46,32 +46,28 @@ jobs:
       || (github.event_name == 'workflow_dispatch' && inputs.workflow == 'lint-and-test')
     permissions:
       contents: read
-    uses: dceoy/gh-actions-for-devops/.github/workflows/python-package-test.yml@main  # zizmor: ignore[unpinned-uses]
+    uses: dceoy/gha-for-devops/.github/workflows/python-package-test.yml@main  # zizmor: ignore[unpinned-uses]
     with:
       package-path: .
       runs-on: windows-latest
-  minimum-dependency-smoke-test:
+  bats-test:
     if: >
       github.event_name == 'push'
       || github.event_name == 'pull_request'
       || (github.event_name == 'workflow_dispatch' && inputs.workflow == 'lint-and-test')
     permissions:
       contents: read
-    runs-on: windows-latest
-    steps:
-      - uses: actions/checkout@9c091bb21b7c1c1d1991bb908d89e4e9dddfe3e0  # v6.0.2
-        with:
-          persist-credentials: false
-      - uses: astral-sh/setup-uv@11f9893b081a58869d3b5fccaea48c9e9e46f990  # v8.3.2
-      - name: Check CLI help with minimum Click and Typer versions
-        run: uv run --with click==8.4.0 --with typer==0.26.0 mt5cli --help
+    uses: dceoy/gha-for-devops/.github/workflows/bats-test.yml@main  # zizmor: ignore[unpinned-uses]
+    with:
+      search-path: ./tests/cli/
+      runs-on: windows-latest
   python-docs-deploy:
     if: >
       github.event_name == 'push'
       || (github.event_name == 'workflow_dispatch' && inputs.workflow == 'docs-deploy')
     permissions:
       contents: write
-    uses: dceoy/gh-actions-for-devops/.github/workflows/python-package-mkdocs-gh-deploy.yml@main  # zizmor: ignore[unpinned-uses]
+    uses: dceoy/gha-for-devops/.github/workflows/python-package-mkdocs-gh-deploy.yml@main  # zizmor: ignore[unpinned-uses]
     with:
       package-path: .
       runs-on: ubuntu-slim
@@ -86,7 +82,7 @@ jobs:
       contents: read
       security-events: write
       actions: read
-    uses: dceoy/gh-actions-for-devops/.github/workflows/github-codeql-analysis.yml@main  # zizmor: ignore[unpinned-uses]
+    uses: dceoy/gha-for-devops/.github/workflows/github-codeql-analysis.yml@main  # zizmor: ignore[unpinned-uses]
     with:
       language: >
         ["python"]
@@ -96,7 +92,8 @@ jobs:
     needs:
       - python-lint-and-scan
       - python-test
-    uses: dceoy/gh-actions-for-devops/.github/workflows/dependabot-auto-merge.yml@main  # zizmor: ignore[unpinned-uses]
+      - bats-test
+    uses: dceoy/gha-for-devops/.github/workflows/dependabot-auto-merge.yml@main  # zizmor: ignore[unpinned-uses]
     permissions:
       contents: write
       pull-requests: write

{mt5cli-1.3.3 → mt5cli-1.4.1}/.github/workflows/claude.yml

@@ -35,7 +35,7 @@ jobs:
       issues: write
       id-token: write
       actions: read
-    uses: dceoy/gh-actions-for-devops/.github/workflows/claude-code-review.yml@main  # zizmor: ignore[unpinned-uses]
+    uses: dceoy/gha-for-devops/.github/workflows/claude-code-review.yml@main  # zizmor: ignore[unpinned-uses]
     secrets:
       CLAUDE_CODE_OAUTH_TOKEN: ${{ secrets.CLAUDE_CODE_OAUTH_TOKEN }}  # zizmor: ignore[secrets-outside-env]
       GH_TOKEN: ${{ secrets.GITHUB_TOKEN }}
@@ -51,7 +51,7 @@ jobs:
       issues: write
       id-token: write
       actions: read
-    uses: dceoy/gh-actions-for-devops/.github/workflows/claude-code-bot.yml@main  # zizmor: ignore[unpinned-uses]
+    uses: dceoy/gha-for-devops/.github/workflows/claude-code-bot.yml@main  # zizmor: ignore[unpinned-uses]
     secrets:
       CLAUDE_CODE_OAUTH_TOKEN: ${{ secrets.CLAUDE_CODE_OAUTH_TOKEN }}  # zizmor: ignore[secrets-outside-env]
       GH_TOKEN: ${{ secrets.GITHUB_TOKEN }}

{mt5cli-1.3.3 → mt5cli-1.4.1}/.github/workflows/release.yml

@@ -13,7 +13,7 @@ jobs:
     permissions:
       contents: write
       id-token: write
-    uses: dceoy/gh-actions-for-devops/.github/workflows/python-package-release-on-pypi-and-github.yml@main  # zizmor: ignore[unpinned-uses]
+    uses: dceoy/gha-for-devops/.github/workflows/python-package-release-on-pypi-and-github.yml@main  # zizmor: ignore[unpinned-uses]
     with:
       package-path: .
       create-github-release: true
@@ -39,6 +39,6 @@ jobs:
           name: ${{ needs.build-and-release.outputs.distribution-artifact-name }}
           path: dist/
       - name: Publish distribution 📦 to PyPI
-        uses: pypa/gh-action-pypi-publish@cef221092ed1bacb1cc03d23a2d87d1d172e277b  # v1.14.0
+        uses: pypa/gh-action-pypi-publish@dc37677b2e1c63e2034f94d8a5b11f265b73ba33  # v1.14.2
         with:
           verbose: true

mt5cli-1.4.1/AGENTS.md

@@ -0,0 +1,29 @@
+# Repository Guidelines
+
+## Build, Test, and Development Commands
+
+Use `.agents/skills/local-qa/SKILL.md` for pre-handoff QA. It runs `.agents/skills/local-qa/scripts/qa.sh`, which formats, lints, type-checks, tests, formats Markdown, and checks GitHub workflows.
+
+`bats --verbose-run ./tests/cli/` runs the Windows/MT5-oriented CLI tests against the installed `mt5cli` entry point. These require a Windows environment where `uv sync` can install MetaTrader5; state clearly when they were not run.
+
+`skills/mt5cli/SKILL.md` documents the mt5cli agent skill.
+
+## Coding Style & Naming Conventions
+
+Preserve the package’s small, typed helper style rather than adding broad abstractions.
+
+## Design Principles
+
+Apply KISS, DRY, and YAGNI when changing code. Prefer the simplest implementation that satisfies the current CLI/API contract. Remove duplication when shared behavior is already proven by at least two concrete call sites, but avoid generic helpers for speculative reuse. Do not add configuration flags, extension hooks, or alternate backends until a real repository use case requires them.
+
+## Testing Guidelines
+
+Parametrize unit tests with `pytest.mark.parametrize` when the same behavior needs coverage across multiple inputs. Mock MT5/pdmt5 boundaries; do not require a live MetaTrader terminal in unit tests.
+
+## Commit & Pull Request Guidelines
+
+Recent history uses concise imperative commits, sometimes with conventional prefixes such as `feat:` or `chore:` and PR numbers appended by GitHub. Keep commits scoped to one logical change. Pull requests should describe behavior changes, note tests run, link related issues, and call out MT5/live-trading risk where relevant.
+
+## Security & Configuration Tips
+
+Never commit account credentials, broker passwords, exported private data, or local `.venv` contents. Treat `order_send` and CLI `order-send --yes` as live execution paths; gate examples and tests so they cannot place real trades accidentally.

{mt5cli-1.3.3 → mt5cli-1.4.1}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: mt5cli
-Version: 1.3.3
+Version: 1.4.1
 Summary: Generic MT5 data and execution infrastructure for Python applications
 Project-URL: Repository, https://github.com/dceoy/mt5cli.git
 Author-email: dceoy <dceoy@users.noreply.github.com>
@@ -15,7 +15,7 @@ Classifier: Operating System :: Microsoft :: Windows
 Classifier: Programming Language :: Python
 Classifier: Programming Language :: Python :: 3
 Classifier: Topic :: Office/Business :: Financial :: Investment
-Requires-Python: <3.14,>=3.11
+Requires-Python: <3.15,>=3.11
 Requires-Dist: pandas>=2.2.2
 Requires-Dist: pdmt5>=1.2.0
 Requires-Dist: typer>=0.26.0
@@ -385,7 +385,6 @@ eurusd_m1 = rates["EURUSD", "M1"]  # closed bars only
 
 ## Requirements
 
-- Python 3.11+
 - Windows OS (MetaTrader 5 requirement)
 - MetaTrader 5 platform installed
 

{mt5cli-1.3.3 → mt5cli-1.4.1}/README.md

@@ -356,7 +356,6 @@ eurusd_m1 = rates["EURUSD", "M1"]  # closed bars only
 
 ## Requirements
 
-- Python 3.11+
 - Windows OS (MetaTrader 5 requirement)
 - MetaTrader 5 platform installed
 

{mt5cli-1.3.3 → mt5cli-1.4.1}/docs/api/public-contract.md

@@ -24,10 +24,11 @@ in pdmt5 — the name changed, it was not simply moved.
 
 Downstream packages should import from the package root (`from mt5cli import
 ...`). The contract set `STABLE_SDK_EXPORTS` in `mt5cli.contract` enumerates
-every package-root symbol. Lower-level helpers (schema utilities, export
-functions, parser helpers, low-level MT5 wrappers) are available directly from
-their owning modules (`mt5cli.schemas`, `mt5cli.utils`, `mt5cli.converters`,
-`mt5cli.marketdata`, etc.) and are not part of the root SDK surface.
+every package-root symbol. Helpers promoted for downstream use, including selected configuration and
+parsing utilities, history timeframe resolution, and Grafana schema setup, are
+part of that root contract. Other low-level
+schema, export, conversion, and implementation helpers remain available only
+from their owning modules.
 
 ### Module responsibility map
 
@@ -56,13 +57,14 @@ These names are exported from `mt5cli` and enumerated in
 
 ### Session lifecycle and configuration
 
-| Symbol                                          | Role                                                                                                                                                                                                                                                                              |
-| ----------------------------------------------- | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
-| `MT5Client`                                     | The single connected client for data, history, calculations, order checking, and order sending                                                                                                                                                                                    |
-| `build_config`                                  | Build `pdmt5.Mt5Config` from connection fields; `login` accepts `int \| str \| None` — numeric strings are coerced to `int`, blank strings are treated as unset, and `${ENV_VAR}` / `$ENV_NAME` placeholders in string parameters are expanded when `allow_whole_dollar_env=True` |
-| `mt5_session`                                   | Canonical context manager: initialize/login once, yield `MT5Client`, shut down once; a supplied `client=` remains caller-owned.                                                                                                                                                   |
-| `AccountSpec`                                   | Generic account group: symbols plus optional credentials                                                                                                                                                                                                                          |
-| `resolve_account_spec`, `resolve_account_specs` | Merge overrides and expand `${ENV_VAR}` placeholders; opt-in `allow_whole_dollar_env` for bare `$NAME`                                                                                                                                                                            |
+| Symbol                                          | Role                                                                                                                                                                                                                                                                                                 |
+| ----------------------------------------------- | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
+| `MT5Client`                                     | The single connected client for data, history, calculations, order checking, and order sending                                                                                                                                                                                                       |
+| `build_config`                                  | Build the underlying MT5 connection config from connection fields; `login` accepts `int \| str \| None` — numeric strings are coerced to `int`, blank strings are treated as unset, and `${ENV_VAR}` / `$ENV_NAME` placeholders in string parameters are expanded when `allow_whole_dollar_env=True` |
+| `substitute_mapping_values`                     | Generic selected-key environment substitution for downstream configuration adapters                                                                                                                                                                                                                  |
+| `mt5_session`                                   | Canonical context manager: initialize/login once, yield `MT5Client`, shut down once; a supplied `client=` remains caller-owned.                                                                                                                                                                      |
+| `AccountSpec`                                   | Generic account group: symbols plus optional credentials                                                                                                                                                                                                                                             |
+| `resolve_account_spec`, `resolve_account_specs` | Merge overrides and expand `${ENV_VAR}` placeholders; opt-in `allow_whole_dollar_env` for bare `$NAME`                                                                                                                                                                                               |
 
 ### Closed-bar rate helpers
 
@@ -93,6 +95,11 @@ timestamp normalization in downstream apps.
 See [History Collection (SQLite)](history.md) for schema, view naming, and ER
 diagrams.
 
+Shared package-root helpers used by downstream adapters include `Dataset`,
+`parse_timeframe`, and `resolve_history_timeframes`. These are stable exports;
+downstream applications should not import them from `mt5cli.utils` or
+`mt5cli.history`.
+
 ### Trading and sizing primitives (generic)
 
 These helpers implement broker-facing calculations only. They do not encode
@@ -108,7 +115,7 @@ strategy entries, exits, Kelly sizing, or signal logic.
 | `CalibrationStatus`, `ClockStatus`                                                                                             | Literal status types for clock calibration and normalization      |
 | `detect_position_side`                                                                                                         | Net long / short / flat from open positions                       |
 | `calculate_spread_ratio`                                                                                                       | Relative bid-ask spread                                           |
-| `calculate_margin_and_volume`, `calculate_volume_by_margin`, `calculate_new_position_margin_ratio`                             | Margin budget and volume sizing                                   |
+| `calculate_margin_and_volume`, `calculate_volume_by_margin`, `calculate_account_projected_margin_ratio`                        | Margin budget and volume sizing                                   |
 | `normalize_order_volume`, `estimate_order_margin`, `calculate_positions_margin`                                                | Broker volume normalization and margin totals                     |
 | `calculate_positions_margin_by_symbol`                                                                                         | Per-symbol margin map (resilient, first-seen order)               |
 | `calculate_positions_margin_safe`                                                                                              | Summed total margin across symbols (failed symbols skipped)       |
@@ -230,8 +237,9 @@ workflows call the facade's canonical data methods (`account_info`, `positions`,
 | `grafana_realized_pnl` | Cumulative realized PnL per symbol    |
 | `grafana_trade_stats`  | Win/loss counts and profit per symbol |
 
-Lower-level helpers (`ensure_grafana_schema`, `create_grafana_views`,
-`create_grafana_indexes`, `create_snapshot_tables`, `start_snapshot_run`,
+`ensure_grafana_schema` is a stable package-root helper for downstream setup.
+Other lower-level helpers (`create_grafana_views`, `create_grafana_indexes`,
+`create_snapshot_tables`, `start_snapshot_run`,
 `insert_account_snapshot`, `insert_position_snapshots`, `insert_order_snapshots`,
 `insert_terminal_snapshot`, `record_snapshot_run`) are available directly from
 `mt5cli.grafana` and are not part of the package-root stable surface.
@@ -367,7 +375,7 @@ their own adapter layer.
 
 ## Contract verification
 
-`tests/test_contracts.py` asserts that every name in `STABLE_SDK_EXPORTS` is
+`tests/unit/test_contracts.py` asserts that every name in `STABLE_SDK_EXPORTS` is
 importable from `mt5cli`, that all package-root exports are covered by the
 stable set, and documents key closed-bar, SQLite loading, account-resolution,
 and trading-session behaviors.

{mt5cli-1.3.3 → mt5cli-1.4.1}/docs/api/trading.md

@@ -264,7 +264,9 @@ A normalized snapshot keeps the raw/UTC distinction explicit:
 
 `copy_ticks_range()` is not used for calibration: its documented UTC contract
 is broker/terminal-dependent and not independently verified here (see
-above), so it cannot serve as an out-of-band UTC reference. Instead, the only
+above), so neither the query timestamps nor the returned historical tick
+timestamps can serve as an out-of-band UTC reference, and historical copied
+rows are never used to infer the server offset. Instead, the only
 independent reference available is **this process's own clock**: every
 calibration poll
 fetches one live `symbol_info_tick()` value and stamps it with
@@ -303,7 +305,11 @@ to a plausible bucket (`unstable_offset`), an unrealistic rounded delta
 missing live data (`no_live_tick`) — snapshots fail closed: `clock_status` is
 `"uncalibrated"`, `time_utc` and `server_clock_offset_seconds` are `None`,
 and the raw fields remain available. A raw timestamp is never silently
-treated as UTC. `normalizer.calibration` exposes the full
+treated as UTC. The same fail-closed rule applies after a successful
+calibration: once periodic revalidation invalidates the cached offset (see
+below), subsequent snapshots are normalized only by a successful full
+recalibration — never by the refuted cache. `normalizer.calibration`
+exposes the full
 `TickClockCalibration` diagnostics: status, offset, distinct sample count,
 evidence symbols, last calibration time, and (for troubleshooting a failed
 attempt) the most recently considered sample's symbol, raw server-labeled
@@ -323,15 +329,55 @@ symbols and calls. A cached offset is recomputed in three cases:
   future — evidence that the broker offset grew, e.g. a UTC+2 to UTC+3
   transition.
 - Periodically, at most once per `revalidation_interval_seconds` (default 5
-  minutes), each configured symbol is polled once and compared against that
-  symbol's last known observation (from the initial calibration or a prior
-  revalidation) until one confirms the still-cached offset. Closed or
-  inconclusive symbols are skipped; a detected disagreement forces full
-  recalibration. This is what catches a broker offset _decrease_ (e.g. UTC+3
-  to UTC+2): the resulting normalized time looks stale rather than future,
+  minutes), through one full revalidation round over every configured
+  symbol. This is what catches a broker offset _decrease_ (e.g. UTC+3 to
+  UTC+2): the resulting normalized time looks stale rather than future,
   which a future-skew check alone cannot distinguish from ordinary
   quiet-market staleness.
 
+In a revalidation round each configured symbol is polled once and compared
+against that symbol's last known observation (from the initial calibration
+or a prior revalidation), and the whole round is evaluated before any
+decision is made — revalidation never stops at the first confirming symbol.
+A symbol is inconclusive — skipped, neither confirming nor refuting the
+cache — when its fetch is unusable, when it has no prior observation to
+compare against, or when its tick epoch is unchanged since that observation
+(ordinary tick age, e.g. a closed or illiquid symbol). Every other advancing
+sample is evidence the cache must be able to explain:
+
+- an accepted offset equal to the cached one confirms the cache, but never
+  cancels another symbol's refuting evidence from the same round;
+- an accepted offset that differs from the cached one refutes the cache (a
+  clean broker offset change) — unless the cached offset, widened by the
+  elapsed time since that symbol's prior observation plus that prior
+  observation's own inferred delay under the cached offset, still explains
+  the disagreeing raw offset. That case is forgiven once per symbol and held as
+  a pending disagreement instead of refuting immediately, since it cannot
+  yet be told apart from a maximally delayed tick under the cached offset.
+  A pending disagreement escalates to a refutation only if that same
+  symbol's next conclusive round rounds to the identical bucket again; any
+  inconclusive, differently-bucketed, or unusable round in between clears
+  it instead of letting unrelated samples accumulate into false
+  corroboration;
+- an advancing sample with no usable offset (`unstable_offset` or
+  `implausible_offset`) also refutes the cache, subject to the same
+  once-per-symbol forgiveness above — but an unusable sample can never
+  itself be held as, or match, a pending disagreement, since it carries no
+  specific offset to corroborate. A fresh market event whose raw offset is
+  neither reconciled with any plausible 30-minute bucket nor forgiven this
+  way is contradictory evidence the cached calibration cannot explain.
+
+Any refuting evidence invalidates the cached calibration and forces full
+recalibration; when several symbols refute the cache in one round, the
+reported evidence is deterministic (`implausible_offset` first, then
+`unstable_offset`, then a clean disagreement). The recalibration either
+re-establishes a validated offset or fails closed — a raw tick is never
+normalized with a cached offset that advancing evidence has just refuted. A
+wholly inconclusive round keeps the cache, and a round in which no symbol
+had a comparable baseline does not consume the interval, so the next call
+retries immediately instead of waiting a full
+`revalidation_interval_seconds`.
+
 If recalibration still cannot validate the timestamp, the snapshot fails
 closed. Failed calibrations are recorded for diagnostics but never reused;
 retries are bounded to at most once per `failed_calibration_retry_seconds`

{mt5cli-1.3.3 → mt5cli-1.4.1}/docs/index.md

@@ -224,7 +224,6 @@ See the [History schema diagram](api/history.md#entity-relationship-diagram) for
 
 ## Requirements
 
-- Python 3.11+
 - Windows OS (MetaTrader 5 requirement)
 - MetaTrader 5 platform
 

{mt5cli-1.3.3 → mt5cli-1.4.1}/mt5cli/__init__.py

@@ -9,7 +9,7 @@ strategy responsibilities.
 
 from importlib.metadata import version
 
-from .client import MT5Client, build_config, mt5_session
+from .client import MT5Client, build_config, mt5_session, substitute_mapping_values
 from .contract import STABLE_SDK_EXPORTS
 from .exceptions import (
     Mt5CliError,
@@ -17,6 +17,7 @@ from .exceptions import (
     Mt5OperationError,
     Mt5SchemaError,
 )
+from .grafana import ensure_grafana_schema
 from .history import (
     RateTarget,
     ThrottledHistoryUpdater,
@@ -26,6 +27,7 @@ from .history import (
     load_rate_series_by_granularity,
     load_rate_series_from_sqlite,
     report_rate_gaps,
+    resolve_history_timeframes,
     update_history,
     update_history_with_config,
 )
@@ -56,7 +58,6 @@ from .trading import (
     TickClockNormalizer,
     calculate_account_projected_margin_ratio,
     calculate_margin_and_volume,
-    calculate_new_position_margin_ratio,
     calculate_positions_margin,
     calculate_positions_margin_by_symbol,
     calculate_positions_margin_safe,
@@ -82,6 +83,7 @@ from .trading import (
     update_sltp_for_open_positions,
     update_trailing_stop_loss_for_open_positions,
 )
+from .utils import Dataset, parse_timeframe
 
 __version__ = version(__package__) if __package__ else None
 

{mt5cli-1.3.3 → mt5cli-1.4.1}/mt5cli/contract.py

@@ -123,11 +123,11 @@ STABLE_SDK_EXPORTS: frozenset[str] = frozenset({
     "TickClockNormalizer",
     "RateTarget",
     "ThrottledHistoryUpdater",
+    "Dataset",
     "build_config",
     "build_rate_targets",
     "calculate_account_projected_margin_ratio",
     "calculate_margin_and_volume",
-    "calculate_new_position_margin_ratio",
     "calculate_projected_margin_ratio",
     "calculate_positions_margin",
     "calculate_positions_margin_by_symbol",
@@ -144,6 +144,7 @@ STABLE_SDK_EXPORTS: frozenset[str] = frozenset({
     "detect_position_side",
     "determine_order_limits",
     "drop_forming_rate_bar",
+    "ensure_grafana_schema",
     "ensure_symbol_selected",
     "estimate_order_margin",
     "extract_tick_price",
@@ -157,11 +158,14 @@ STABLE_SDK_EXPORTS: frozenset[str] = frozenset({
     "load_rate_series_from_sqlite",
     "mt5_session",
     "normalize_order_volume",
+    "parse_timeframe",
     "place_market_order",
     "report_rate_gaps",
     "resolve_broker_filling_mode",
     "resolve_account_spec",
     "resolve_account_specs",
+    "resolve_history_timeframes",
+    "substitute_mapping_values",
     "update_history",
     "update_history_with_config",
     "update_observability",