code-coordinator 0.5.546__tar.gz → 0.5.548__tar.gz

{code_coordinator-0.5.546 → code_coordinator-0.5.548}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: code-coordinator
-Version: 0.5.546
+Version: 0.5.548
 Summary: Coordinate Claude Code workers across multiple machines and repos.
 Author-email: John Donaghy <johnfdonaghy@gmail.com>
 License-Expression: LicenseRef-FSL-1.1-MIT
@@ -33,6 +33,11 @@ Requires-Dist: openpyxl>=3.1; extra == "reports-xlsx"
 Provides-Extra: tui-pty
 Requires-Dist: pyte>=0.8; extra == "tui-pty"
 Requires-Dist: pywinpty>=2.0; sys_platform == "win32" and extra == "tui-pty"
+Provides-Extra: win-native
+Requires-Dist: comtypes>=1.2; sys_platform == "win32" and extra == "win-native"
+Provides-Extra: mac-native
+Requires-Dist: pyobjc-framework-Quartz>=10.0; sys_platform == "darwin" and extra == "mac-native"
+Requires-Dist: pyobjc-framework-ApplicationServices>=10.0; sys_platform == "darwin" and extra == "mac-native"
 Provides-Extra: all
 Requires-Dist: code-coordinator[server]; extra == "all"
 Requires-Dist: code-coordinator[reports-xlsx]; extra == "all"

{code_coordinator-0.5.546 → code_coordinator-0.5.548}/code_coordinator.egg-info/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: code-coordinator
-Version: 0.5.546
+Version: 0.5.548
 Summary: Coordinate Claude Code workers across multiple machines and repos.
 Author-email: John Donaghy <johnfdonaghy@gmail.com>
 License-Expression: LicenseRef-FSL-1.1-MIT
@@ -33,6 +33,11 @@ Requires-Dist: openpyxl>=3.1; extra == "reports-xlsx"
 Provides-Extra: tui-pty
 Requires-Dist: pyte>=0.8; extra == "tui-pty"
 Requires-Dist: pywinpty>=2.0; sys_platform == "win32" and extra == "tui-pty"
+Provides-Extra: win-native
+Requires-Dist: comtypes>=1.2; sys_platform == "win32" and extra == "win-native"
+Provides-Extra: mac-native
+Requires-Dist: pyobjc-framework-Quartz>=10.0; sys_platform == "darwin" and extra == "mac-native"
+Requires-Dist: pyobjc-framework-ApplicationServices>=10.0; sys_platform == "darwin" and extra == "mac-native"
 Provides-Extra: all
 Requires-Dist: code-coordinator[server]; extra == "all"
 Requires-Dist: code-coordinator[reports-xlsx]; extra == "all"

{code_coordinator-0.5.546 → code_coordinator-0.5.548}/code_coordinator.egg-info/SOURCES.txt

@@ -101,6 +101,7 @@ coord/invariant_alarms.py
 coord/issue_store.py
 coord/issues_sync_status.py
 coord/liveness_auditor.py
+coord/mac_native_driver.py
 coord/machine_fault.py
 coord/machine_metrics.py
 coord/machine_onboard.py
@@ -169,6 +170,7 @@ coord/uat_checks.py
 coord/usage.py
 coord/usage_limits.py
 coord/usage_rollup.py
+coord/win_native_driver.py
 coord/worker_events.py
 coord/agents/opencode/.gitignore
 coord/agents/opencode/routing.jsonc
@@ -702,6 +704,7 @@ tests/test_issues_sync_status.py
 tests/test_liveness_auditor.py
 tests/test_liveness_notify.py
 tests/test_lock_contention_ratchet.py
+tests/test_mac_native_driver.py
 tests/test_machine_fault.py
 tests/test_machine_metrics.py
 tests/test_machine_onboard.py
@@ -867,6 +870,7 @@ tests/test_usage_rollup.py
 tests/test_venv_live_install_2121.py
 tests/test_version_single_source.py
 tests/test_watch.py
+tests/test_win_native_driver.py
 tests/test_windows_job_is_a_real_gate_2000.py
 tests/test_worker_env_venv_isolation.py
 tests/test_worker_events.py

{code_coordinator-0.5.546 → code_coordinator-0.5.548}/code_coordinator.egg-info/requires.txt

@@ -22,6 +22,12 @@ setuptools>=68
 setuptools-scm>=8
 wheel
 
+[mac-native]
+
+[mac-native:sys_platform == "darwin"]
+pyobjc-framework-Quartz>=10.0
+pyobjc-framework-ApplicationServices>=10.0
+
 [postgres]
 psycopg[binary]>=3.1
 
@@ -39,3 +45,8 @@ pyte>=0.8
 
 [tui-pty:sys_platform == "win32"]
 pywinpty>=2.0
+
+[win-native]
+
+[win-native:sys_platform == "win32"]
+comtypes>=1.2

{code_coordinator-0.5.546 → code_coordinator-0.5.548}/code_coordinator.egg-info/scm_file_list.json

@@ -202,6 +202,7 @@
     "coord/issue_store.py",
     "coord/issues_sync_status.py",
     "coord/liveness_auditor.py",
+    "coord/mac_native_driver.py",
     "coord/machine_fault.py",
     "coord/machine_metrics.py",
     "coord/machine_onboard.py",
@@ -296,6 +297,7 @@
     "coord/usage.py",
     "coord/usage_limits.py",
     "coord/usage_rollup.py",
+    "coord/win_native_driver.py",
     "coord/worker_events.py",
     "coordinator.example.yml",
     "deploy/coord-agent.service",
@@ -729,6 +731,7 @@
     "tests/test_liveness_auditor.py",
     "tests/test_liveness_notify.py",
     "tests/test_lock_contention_ratchet.py",
+    "tests/test_mac_native_driver.py",
     "tests/test_machine_fault.py",
     "tests/test_machine_metrics.py",
     "tests/test_machine_onboard.py",
@@ -894,6 +897,7 @@
     "tests/test_venv_live_install_2121.py",
     "tests/test_version_single_source.py",
     "tests/test_watch.py",
+    "tests/test_win_native_driver.py",
     "tests/test_windows_job_is_a_real_gate_2000.py",
     "tests/test_worker_env_venv_isolation.py",
     "tests/test_worker_events.py",

{code_coordinator-0.5.546 → code_coordinator-0.5.548}/code_coordinator.egg-info/scm_version.json

@@ -1,7 +1,7 @@
 {
-  "tag": "0.5.546",
+  "tag": "0.5.548",
   "distance": 0,
-  "node": "g943ce5e80a36cebf246516f67c4e6727011815e4",
+  "node": "g378143c91298f98bb93541f85ec389ff3a6525b2",
   "dirty": false,
   "branch": "HEAD",
   "node_date": "2026-09-30"

{code_coordinator-0.5.546 → code_coordinator-0.5.548}/coord/acceptance_drivers.py

@@ -7,12 +7,14 @@ is the one seam that varies per medium — TUI (quadraui ``TuiDriver``), CLI
 *run* a repo's declared acceptance suite and *parse* its raw output into a
 normalized list of ``{"id": str, "status": "pass"|"fail"|"skip", "message":
 str}`` dicts (``cli-pytest`` additionally carries ``"expected"``/``"got"``
-on a failing test — see :func:`parse_pytest_junit_xml`). ``tui-tuidriver``,
-``cli-pytest`` (#1125), ``web-playwright`` (#1539), ``terraform``
-(#3232), and ``tui-pty`` (#3483) are implemented; other ``kind`` values are
-declared in ``coordinator.yml`` (see :class:`coord.config.AcceptanceConfig`)
-but rejected here with a clear "not yet implemented" error until their
-issues land (native).
+on a failing test — see :func:`parse_pytest_junit_xml`; ``win-native``
+additionally carries ``"capture_b64"`` on a failing step — see
+:func:`_run_win_native`). ``tui-tuidriver``, ``cli-pytest`` (#1125),
+``web-playwright`` (#1539), ``terraform`` (#3232), ``tui-pty`` (#3483), and
+``win-native`` (#3484) are implemented; other ``kind`` values are declared
+in ``coordinator.yml`` (see :class:`coord.config.AcceptanceConfig`) but
+rejected here with a clear "not yet implemented" error until their issues
+land.
 
 ``cli-pytest`` parses pytest's built-in ``--junit-xml`` report (a core
 pytest flag, not a plugin — no extra dependency required in the driven
@@ -61,6 +63,40 @@ seam: it resolves the smoke spec from the driver's ``entrypoint:`` (the
 ``tui-pty`` analogue of ``tui-tuidriver``'s own entrypoint-as-sealed-file
 convention) and hands off to :func:`coord.tui_pty_driver.run_smoke_spec`.
 
+``win-native`` (#3484, the Win32-native tier below ``tui-pty``) launches the
+driven repo's real compiled Windows exe — a GUI app in its own window, or a
+TUI binary hosted inside a real Windows Terminal/conhost window — and drives
+it with real ``SendInput``/``PostMessage`` input while probing real OS
+state: ``GetMenu``, ``WM_NCHITTEST``, and the UI Automation tree, with a
+``PrintWindow`` capture attached to every failing step as evidence. On
+2026-09-29 vimcode's window had a real native menu (``GetMenu`` -> 7 items)
+that was completely invisible because a custom caption left 0 px of
+non-client area, and no min/max/close — both passed every ``tui-tuidriver``/
+``tui-pty`` test, because neither ever asks the real OS those questions.
+All of the spec parsing, the Win32/UIA call seam, and the step executor live
+in :mod:`coord.win_native_driver` — see that module's docstring for the spec
+format. This adapter (:func:`_run_win_native`) is the same thin seam
+:func:`_run_tui_pty` is: it resolves the native spec from the driver's
+``entrypoint:`` and hands off to
+:func:`coord.win_native_driver.run_native_spec`.
+
+``mac-native`` (#3485, the macOS-native tier alongside ``win-native``)
+launches the driven repo's real compiled ``.app``/binary and drives it with
+real ``CGEvent`` input while probing real OS state: the Accessibility (AX)
+tree (covering the ``expect_a11y``/``expect_a11y_within`` steps) and a
+per-window ``screencapture -l <windowid>`` capture attached to every failing
+step as evidence. It deliberately speaks the *same* step vocabulary
+``win-native`` already defines for its ``mode: window`` case (``launch``,
+``key``, ``click``, ``wait``, ``capture``, ``expect_a11y``,
+``expect_a11y_within``, ``expect_closed``) — no macOS-specific spec fork —
+so one spec file can drive either platform's native tier. All of the spec
+parsing, the Quartz/AX call seam, and the step executor live in
+:mod:`coord.mac_native_driver` — see that module's docstring for the spec
+format and the platform-parity rationale. This adapter
+(:func:`_run_mac_native`) is the same thin seam :func:`_run_win_native` is:
+it resolves the native spec from the driver's ``entrypoint:`` and hands off
+to :func:`coord.mac_native_driver.run_native_spec`.
+
 ``terraform`` additionally runs a deterministic policy gate (#3234, epic
 #3230 child 3) whenever the driven repo has opted in by carrying the
 convention files: ``tflint`` (rule-based HCL/provider checks — pinned
@@ -91,7 +127,10 @@ from pathlib import Path
 # Driver kinds this module knows how to run. Keep in sync with the adapters
 # implemented below — a kind can be *declared* in coordinator.yml ahead of its
 # adapter landing, but running it must fail loudly rather than silently no-op.
-SUPPORTED_KINDS = ("tui-tuidriver", "cli-pytest", "web-playwright", "terraform", "tui-pty")
+SUPPORTED_KINDS = (
+    "tui-tuidriver", "cli-pytest", "web-playwright", "terraform", "tui-pty",
+    "win-native", "mac-native",
+)
 
 # #2748 (IL-2): driver kinds whose `run` produces a real pass/fail verdict
 # but NOT yet a deterministic one, because an input they depend on hasn't
@@ -268,9 +307,11 @@ def run_driver(
     into a driver's own "wrote no report" crash message.
 
     *entrypoint* (``AcceptanceDriverConfig.entrypoint``) is only consulted
-    by ``tui-pty`` (#3483) — it names the repo-root-relative smoke-spec YAML
-    file (see :mod:`coord.tui_pty_driver`), the same way ``entrypoint``
-    already names ``tui-tuidriver``'s sealed Rust acceptance file for
+    by ``tui-pty`` (#3483), ``win-native`` (#3484) and ``mac-native``
+    (#3485) — it names the repo-root-relative smoke/native-spec YAML file
+    (see :mod:`coord.tui_pty_driver`/:mod:`coord.win_native_driver`/
+    :mod:`coord.mac_native_driver`), the same way ``entrypoint`` already
+    names ``tui-tuidriver``'s sealed Rust acceptance file for
     :func:`coord.acceptance.acceptance_root_for_driver`. Every other kind
     ignores it.
     """
@@ -294,6 +335,10 @@ def run_driver(
         return _run_terraform(run_command, cwd, timeout=timeout)
     if kind == "tui-pty":
         return _run_tui_pty(run_command, cwd, entrypoint, timeout=timeout)
+    if kind == "win-native":
+        return _run_win_native(run_command, cwd, entrypoint, timeout=timeout)
+    if kind == "mac-native":
+        return _run_mac_native(run_command, cwd, entrypoint, timeout=timeout)
     return _run_generic(run_command, cwd, timeout=timeout)
 
 
@@ -659,6 +704,128 @@ def _run_tui_pty(run_command: str, cwd: str, entrypoint: str, *, timeout: int) -
     return DriverResult(exit_code=exit_code, tests=tests, raw_output=raw_output)
 
 
+def _run_win_native(run_command: str, cwd: str, entrypoint: str, *, timeout: int) -> DriverResult:
+    """The ``win-native`` shape (#3484): *run_command* is the shell command
+    that launches the driven repo's real compiled Windows exe — the
+    platform-neutral native spec YAML that drives it lives at *entrypoint*
+    (repo-root-relative), the ``win-native`` analogue of ``tui-pty``'s own
+    ``entrypoint:`` convention (see :func:`_run_tui_pty` and the module
+    docstring).
+
+    All of the real Win32/UIA calls and the step executor live in
+    :mod:`coord.win_native_driver` — this function is the thin seam that
+    resolves *entrypoint* to a spec file and calls
+    :func:`coord.win_native_driver.run_native_spec`, then folds its
+    normalized ``tests`` list (each failing entry optionally carrying a
+    ``capture_b64`` ``PrintWindow`` snapshot) into a :class:`DriverResult`
+    the same way :func:`_run_tui_pty` does.
+
+    Raises :class:`DriverError` — never a bare exception — for a missing
+    ``entrypoint:``, a spec file that doesn't exist, or a malformed spec
+    (an invalid-YAML/unknown-step-type
+    :class:`coord.win_native_driver.WinNativeSpecError`). A process that
+    never launches, a window that never appears, or a failed probe do NOT
+    raise here — :func:`coord.win_native_driver.run_native_spec` folds those
+    into individual failing entries in ``tests`` instead.
+    """
+    from coord.win_native_driver import (  # noqa: PLC0415 — see module docstring on the deferred import
+        WinNativeRuntimeError,
+        WinNativeSpecError,
+        run_native_spec,
+    )
+
+    if not entrypoint:
+        raise DriverError(
+            "win-native driver requires an `entrypoint:` naming the native "
+            "spec YAML file (repo-root-relative) — none configured"
+        )
+    spec_path = Path(cwd) / entrypoint
+    if not spec_path.is_file():
+        raise DriverError(f"win-native spec not found: {spec_path}")
+
+    try:
+        spec_text = spec_path.read_text()
+    except OSError as e:
+        raise DriverError(f"win-native spec could not be read: {spec_path}: {e}") from e
+
+    try:
+        tests = run_native_spec(
+            spec_text, launch_command=run_command, cwd=cwd, timeout=timeout,
+        )
+    except WinNativeSpecError as e:
+        raise DriverError(f"win-native spec is invalid: {e}") from e
+    except WinNativeRuntimeError as e:
+        raise DriverError(f"win-native driver could not run: {e}") from e
+
+    exit_code = 0 if tests and all(t.get("status") != "fail" for t in tests) else 1
+    raw_output = "\n".join(
+        f"{t.get('status')}: {t.get('id')} {t.get('message', '')}".rstrip()
+        for t in tests
+    )
+    return DriverResult(exit_code=exit_code, tests=tests, raw_output=raw_output)
+
+
+def _run_mac_native(run_command: str, cwd: str, entrypoint: str, *, timeout: int) -> DriverResult:
+    """The ``mac-native`` shape (#3485): *run_command* is the shell command
+    that launches the driven repo's real compiled ``.app``/binary — the
+    platform-neutral native spec YAML that drives it lives at *entrypoint*
+    (repo-root-relative), the ``mac-native`` analogue of ``win-native``'s own
+    ``entrypoint:`` convention (see :func:`_run_win_native` and the module
+    docstring).
+
+    All of the real Quartz/AX calls and the step executor live in
+    :mod:`coord.mac_native_driver` — this function is the thin seam that
+    resolves *entrypoint* to a spec file and calls
+    :func:`coord.mac_native_driver.run_native_spec`, then folds its
+    normalized ``tests`` list (each failing entry optionally carrying a
+    ``capture_b64`` ``screencapture`` snapshot) into a :class:`DriverResult`
+    the same way :func:`_run_win_native` does.
+
+    Raises :class:`DriverError` — never a bare exception — for a missing
+    ``entrypoint:``, a spec file that doesn't exist, or a malformed spec
+    (an invalid-YAML/unknown-step-type
+    :class:`coord.mac_native_driver.MacNativeSpecError`). A process that
+    never launches, a window that never appears, or a failed probe do NOT
+    raise here — :func:`coord.mac_native_driver.run_native_spec` folds those
+    into individual failing entries in ``tests`` instead.
+    """
+    from coord.mac_native_driver import (  # noqa: PLC0415 — see module docstring on the deferred import
+        MacNativeRuntimeError,
+        MacNativeSpecError,
+        run_native_spec,
+    )
+
+    if not entrypoint:
+        raise DriverError(
+            "mac-native driver requires an `entrypoint:` naming the native "
+            "spec YAML file (repo-root-relative) — none configured"
+        )
+    spec_path = Path(cwd) / entrypoint
+    if not spec_path.is_file():
+        raise DriverError(f"mac-native spec not found: {spec_path}")
+
+    try:
+        spec_text = spec_path.read_text()
+    except OSError as e:
+        raise DriverError(f"mac-native spec could not be read: {spec_path}: {e}") from e
+
+    try:
+        tests = run_native_spec(
+            spec_text, launch_command=run_command, cwd=cwd, timeout=timeout,
+        )
+    except MacNativeSpecError as e:
+        raise DriverError(f"mac-native spec is invalid: {e}") from e
+    except MacNativeRuntimeError as e:
+        raise DriverError(f"mac-native driver could not run: {e}") from e
+
+    exit_code = 0 if tests and all(t.get("status") != "fail" for t in tests) else 1
+    raw_output = "\n".join(
+        f"{t.get('status')}: {t.get('id')} {t.get('message', '')}".rstrip()
+        for t in tests
+    )
+    return DriverResult(exit_code=exit_code, tests=tests, raw_output=raw_output)
+
+
 def parse_test_output(output: str) -> list[dict]:
     """Parse a driver's stdout into normalized ``{"id", "status", "message"}``.