ManulEngine

Add a new configuration setting to ManulEngine end-to-end — EngineConfig field, MANUL_* env var, JSON config key, prompts.py global, and the MANUL_CONFIG_CONTRACT.md entry — honoring the precedence layering. Invoke when the user says "add a config option", "new setting", "new MANUL_ env var", "make X configurable", "додай налаштування", "новий конфіг". A new public ctor kwarg is "Ask first" per CLAUDE.md.

Author a @custom_control handler that overrides ManulEngine's element resolution for a specific (page, target) pair — for widgets the heuristics can't drive (React date pickers, canvas, custom web components). Wires the handler into a controls/ module, aligns the page label with pages/*.json, and adds a test. Invoke when the user says "add a custom control", "override resolution for X", "the heuristics can't click this widget", "handle this React/canvas component", "додай кастомний контрол".

Add a new DSL step kind (e.g. WAIT FOR DOWNLOAD, EXTRACT TABLE, …) to ManulEngine end-to-end. Wires classify_step + dispatch in BOTH the main run_mission loop AND the conditional-branch _dispatch_step executor, then adds a synthetic-DOM test. Invoke when the user says "add step", "new DSL keyword", "support a new action".

Run the ManulEngine synthetic-DOM test suite (manul_engine/test/test_*.py — 54 function-based suites, NOT unittest) and surface failures concisely. Invoke when the user says "run tests", "run the suite", "are tests passing", "запусти тести", or after non-trivial code changes to core.py / scoring.py / helpers.py / actions.py / cli.py before reporting work as done.

Create a working Python virtualenv for ManulEngine and run its tests. ManulEngine drives a system Chrome/Chromium directly over CDP — there is no Playwright and no bundled-browser download. Invoke when the user says "create venv", "setup env", "set up the environment", "install deps", "створи венв", "налаштуй середовище", or when a test run fails with "No module named 'websockets'" or "Chrome/Chromium not found".

Verify and reconcile the frozen public-surface contracts under contracts/MANUL_*_CONTRACT.md against the current code. Invoke when the user says "check contracts", "are contracts up to date", "sync contracts", or after any change that touches the DSL grammar, CLI flags, ManulEngine/ManulSession ctor, EngineConfig fields, hooks, reporter JSON, or scoring weights.

Bump the ManulEngine version atomically across all 17 files using bump_version.py (the single source of truth is pyproject.toml). Invoke when the user says "bump to X.Y.Z", "онови версію", "cut a release", or any phrasing that implies a version change. Refuses to run if the working tree is on an inconsistent version base.