Operations

Operations

All commands are intended to run from the repository root in PowerShell.

Validate

.\.venv\Scripts\python.exe -m unittest discover -s tests
.\.venv\Scripts\python.exe -m compileall llbot apps tests

Probe MetaScalp

.\.venv\Scripts\python.exe apps\probe_metascalp.py

MetaScalp discovery scans 127.0.0.1:17845-17855.

Capture Public Market Data

Binance USD-M book ticker:

.\.venv\Scripts\python.exe apps\collect_market.py --venue binance-usdm --symbol BTCUSDT --events 20 --out data\replay\binance_usdm_BTCUSDT.jsonl --open-timeout-sec 30

MEXC contract ticker/depth:

.\.venv\Scripts\python.exe apps\collect_market.py --venue mexc-contract --symbol BTC_USDT --events 20 --out data\replay\mexc_contract_BTC_USDT.jsonl --mexc-depth --open-timeout-sec 30

These commands only read public market data.

Replay And Paper

Replay saved JSONL through paper trading:

.\.venv\Scripts\python.exe apps\runner_paper.py --input data\replay\smoke_binance_usdm_BTCUSDT.jsonl --input data\replay\smoke_mexc_contract_BTC_USDT.jsonl --min-samples 1 --fee-bps 5 --slippage-bps 5 --take-profit-bps 10 --stale-feed-ms 1500 --summary-out reports\runner_paper_summary_smoke.json

Bounded public WebSocket paper pass:

.\.venv\Scripts\python.exe apps\runner_paper.py --live-ws --events 100 --symbol BTCUSDT --leader-symbol BTCUSDT --lagger-symbol BTC_USDT --min-samples 1 --stale-feed-ms 1500 --summary-out reports\runner_paper_live_ws_summary.json --health-out reports\runner_paper_live_ws_health.json

The paper runner does not contact MetaScalp.

MetaScalp Demo Runner

Dry-run bridge from public signals to MetaScalp demo audit records:

.\.venv\Scripts\python.exe apps\runner_metascalp_demo.py --events 100 --connection-id 4 --summary-out reports\metascalp_demo_runner_summary.json --paper-audit-out reports\metascalp_demo_runner_paper.jsonl --metascalp-audit-out reports\metascalp_demo_runner_orders.jsonl

Real demo POST requires explicit confirmation:

.\.venv\Scripts\python.exe apps\runner_metascalp_demo.py --events 500 --connection-id 4 --max-demo-orders 1 --submit-demo --confirm-demo-submit METASCALP_DEMO_ORDER --summary-out reports\metascalp_demo_runner_submit_summary.json --paper-audit-out reports\metascalp_demo_runner_submit_paper.jsonl --metascalp-audit-out reports\metascalp_demo_runner_submit_orders.jsonl

Health And Dashboard

Build health report:

.\.venv\Scripts\python.exe apps\health_check.py --runner-summary reports\metascalp_demo_runner_live_dry_both_streams.json --discover-metascalp --select-demo-mexc --db reports\health_check_smoke.duckdb --out reports\health_check_metascalp_smoke.json

Refresh static dashboard:

.\.venv\Scripts\python.exe apps\refresh_dashboard.py --runner-summary reports\metascalp_demo_runner_live_dry_both_streams.json --health-out reports\health_check_metascalp_smoke.json --dashboard-out reports\dashboard.html

Serve static dashboard locally:

.\.venv\Scripts\python.exe apps\serve_dashboard.py --dashboard reports\dashboard.html --host 127.0.0.1 --port 8765

The dashboard is read-only and has no order controls.

Reports

Useful local artifacts:

• reports/latest_test_report.md
• reports/current_execplan.md
• reports/dashboard.html
• reports/daily_summary_smoke.json
• reports/replay_research_smoke.json
• reports/demo_fill_compare_smoke.json
• reports/metascalp_reconcile_smoke.json