Resolve and report MT4/5 paths, terminal hash, and missing-component issues.

Enumerate all MetaTrader terminal data folders under %APPDATA%\MetaQuotes\Terminal.

Compile a .mq4/.mq5/.mqh source via MetaEditor CLI.

Args: source: Absolute path to the source file. include: Optional MQL root override (parent of Include/). Defaults to terminal MQL root. log_file: Optional explicit log path. Defaults to .log. timeout_sec: Subprocess timeout.

Returns: returncode, structured errors/warnings lists, result_errors/result_warnings, log_path, log_excerpt (last 80 lines), cmd.

Launch terminal with /config:<tester.ini>.

Args: config: Absolute path to tester.ini. wait: Block until terminal exits (requires ShutdownTerminal=1 in ini). timeout_sec: Wait timeout. portable: Pass /portable flag.

Returns: returncode, elapsed_sec, latest_tester_log path.

Force-kill all running terminal processes for the configured edition.

Read last N lines from terminal logs.

Args: mode: "live" (Files/LiveLog.txt), "journal" (Logs/YYYYMMDD.log), "tester" (latest tester log). lines: Tail line count. date: Override YYYYMMDD for journal mode. structured: Parse journal lines into ts/source/message records.

Copy compiled .ex4/.ex5 binary into Experts/.

Args: source_ex: Path to compiled .ex4/.ex5. name: Optional rename target.

Copy a .mqh into the terminal Include folder (e.g. for LiveLog.mqh).

Args: source: Absolute path to source .mqh. target_name: Optional rename.

List compiled EAs in Experts/.

Locate and parse latest MT5 tester HTML report.

Args: path: Explicit report path. If omitted, find latest *.htm under Tester/. raw_truncate: Max chars of raw HTML returned.

Update fields in a tester.ini file in-place.

Args: config: Path to tester.ini. updates: Mapping of Section.Key → value (e.g. {"Tester.Symbol": "EURUSD", "Tester.FromDate": "2025.01.01"}).

Returns dict listing applied + skipped keys.

Compile then deploy resulting .ex5/.ex4 to Experts/ in one shot.

Parse input <type> <name> = <default>; declarations from a source file.

Generate a [TesterInputs] block from EA inputs.

If write_to points at a tester.ini, the block is appended/replaced in-place.

Recursively resolve #include directives. Reports unresolved files.

Grep a symbol across MQL files, skipping comments and string literals.

Compute LOC/function/nesting metrics for a file or every MQL file under a root.

Extract MetaEditor //+--+ //| ... +--+ doc blocks from a source file.

Find duplicate magic-number assignments across the project.

Compile a source via MetaEditor's syntax-only mode (/s) and return diagnostics.

Run structural lint rules (missing handlers, unused inputs, hardcoded magic/symbol).

Flag MT4-style deprecated API calls in MT5 source.

Sanity-check a tester.ini. If source given, cross-check inputs vs EA declarations.

Format an MQL file via clang-format (treats source as C++).

Report whether a file needs formatting without writing it.

Rename a symbol across MQL files (whole-word match). dry_run=True previews only.

Parse the latest .opt file in the Tester folder, or one given by path.

Sort optimization passes by criterion and return the top N.

Diff two MT5 tester HTML reports key-by-key with absolute and percent deltas.

Verify candidate report stays within guard thresholds vs baseline.

Freeze a copy of source files into a timestamped folder under dest.

List all snapshot folders under dest.

Switch the active terminal data folder for this session.

Provide one of: origin (install path stored in origin.txt), hash (32-char folder name), or install (auto-scan for the matching origin).

Subsequent tool calls will use the new layout until the server restarts.

Compile, deploy, run a 1-day headless backtest, and scan the journal for runtime errors.

Returns ok: true only if compilation, deployment, run, and the journal scan all pass.

Extract a contiguous block of lines into a new helper function.

Brace-counting + regex param detection — not a full AST parser. Returns the proposed helper, call site, and parameter list. Set dry_run=False to write.