code-mower 0.5.0b37__tar.gz → 0.5.0b38__tar.gz

{code_mower-0.5.0b37 → code_mower-0.5.0b38}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: code-mower
-Version: 0.5.0b37
+Version: 0.5.0b38
 Summary: Multi-reviewer AI code audit orchestration
 License-Expression: Apache-2.0
 Requires-Python: >=3.11
@@ -103,11 +103,11 @@ Code Mower currently targets Python 3.11+; Python 3.12 is recommended.
 
 ```bash
 python3.12 --version
-pipx install --python python3.12 code-mower==0.5.0b37
+pipx install --python python3.12 code-mower==0.5.0b38
 code-mower --version
 ```
 
-`0.5.0b37` is a beta release. Until Code Mower publishes a stable `1.0`
+`0.5.0b38` is a beta release. Until Code Mower publishes a stable `1.0`
 line, use the explicit beta version above or allow prereleases with:
 
 ```bash
@@ -150,7 +150,7 @@ First-time command map: [docs/launch-command-surface.md](docs/launch-command-sur
 
 The current PyPI beta has been rehearsed end-to-end from a clean install:
 [First-User Install Rehearsal](docs/first-user-install-rehearsal.md) records
-the latest 10/10 public-package readiness proof for `code-mower==0.5.0b37`.
+the latest 10/10 public-package readiness proof for `code-mower==0.5.0b38`.
 
 ## Optional: Plan Before Coding
 
@@ -291,9 +291,9 @@ best?" to "which AI builder plus reviewer loop ships best on this product?" See
 
 ## Installation Status
 
-The current public beta is `v0.5.0-beta.37` from
+The current public beta is `v0.5.0-beta.38` from
 [codemower-ai/code-mower](https://github.com/codemower-ai/code-mower), published
-as `code-mower==0.5.0b37` on [PyPI](https://pypi.org/project/code-mower/).
+as `code-mower==0.5.0b38` on [PyPI](https://pypi.org/project/code-mower/).
 GitHub releases remain the auditable source for tags, build artifacts, and
 release notes.
 

{code_mower-0.5.0b37 → code_mower-0.5.0b38}/README.md

@@ -88,11 +88,11 @@ Code Mower currently targets Python 3.11+; Python 3.12 is recommended.
 
 ```bash
 python3.12 --version
-pipx install --python python3.12 code-mower==0.5.0b37
+pipx install --python python3.12 code-mower==0.5.0b38
 code-mower --version
 ```
 
-`0.5.0b37` is a beta release. Until Code Mower publishes a stable `1.0`
+`0.5.0b38` is a beta release. Until Code Mower publishes a stable `1.0`
 line, use the explicit beta version above or allow prereleases with:
 
 ```bash
@@ -135,7 +135,7 @@ First-time command map: [docs/launch-command-surface.md](docs/launch-command-sur
 
 The current PyPI beta has been rehearsed end-to-end from a clean install:
 [First-User Install Rehearsal](docs/first-user-install-rehearsal.md) records
-the latest 10/10 public-package readiness proof for `code-mower==0.5.0b37`.
+the latest 10/10 public-package readiness proof for `code-mower==0.5.0b38`.
 
 ## Optional: Plan Before Coding
 
@@ -276,9 +276,9 @@ best?" to "which AI builder plus reviewer loop ships best on this product?" See
 
 ## Installation Status
 
-The current public beta is `v0.5.0-beta.37` from
+The current public beta is `v0.5.0-beta.38` from
 [codemower-ai/code-mower](https://github.com/codemower-ai/code-mower), published
-as `code-mower==0.5.0b37` on [PyPI](https://pypi.org/project/code-mower/).
+as `code-mower==0.5.0b38` on [PyPI](https://pypi.org/project/code-mower/).
 GitHub releases remain the auditable source for tags, build artifacts, and
 release notes.
 

{code_mower-0.5.0b37 → code_mower-0.5.0b38}/pyproject.toml

@@ -4,7 +4,7 @@ build-backend = "setuptools.build_meta"
 
 [project]
 name = "code-mower"
-version = "0.5.0b37"
+version = "0.5.0b38"
 description = "Multi-reviewer AI code audit orchestration"
 requires-python = ">=3.11"
 readme = "README.md"

{code_mower-0.5.0b37 → code_mower-0.5.0b38}/src/code_mower/__init__.py

@@ -1,3 +1,3 @@
 """Code Mower package."""
 
-__version__ = "0.5.0b37"
+__version__ = "0.5.0b38"

{code_mower-0.5.0b37 → code_mower-0.5.0b38}/src/code_mower/calibration/arms.py

@@ -9,7 +9,13 @@ DEFAULT_LOCAL_LLM_PROFILES = (
     "qwen3-coder-next-lmstudio",
     "gemma4-ollama",
 )
-DEFAULT_CLI_LANES = ("gemini_cli", "antigravity_cli", "hermes_cli", "coderabbit_cli")
+DEFAULT_CLI_LANES = (
+    "gemini_cli",
+    "antigravity_cli",
+    "hermes_cli",
+    "coderabbit_cli",
+    "grok_build",
+)
 
 
 def default_arms() -> list[dict[str, Any]]:

{code_mower-0.5.0b37 → code_mower-0.5.0b38}/src/code_mower/calibration/commands.py

@@ -137,7 +137,12 @@ def materialize_command(
     lane_id = command_lane_id(command)
     repo = str(item.get("repo") or "")
     repo_path = repo_path_for_item(item, repo_path_map)
-    historical_local_cli_lanes = {"antigravity-cli", "gemini-cli", "hermes-cli"}
+    historical_local_cli_lanes = {
+        "antigravity-cli",
+        "gemini-cli",
+        "grok-build",
+        "hermes-cli",
+    }
     if lane_id in {"coderabbit-cli", "local-llm", *historical_local_cli_lanes}:
         existing_repo_path = option_value(materialized, "--repo-path")
         if repo_path:
@@ -169,6 +174,8 @@ def summary_path_for_command(command: Sequence[Any]) -> Path | None:
         return root / "antigravity-cli.summary.json"
     if lane_id == "gemini-cli":
         return root / "gemini-cli.summary.json"
+    if lane_id == "grok-build":
+        return root / "grok-build.summary.json"
     if lane_id == "hermes-cli":
         return root / "hermes-cli.summary.json"
     if lane_id == "coderabbit-cli":

{code_mower-0.5.0b37 → code_mower-0.5.0b38}/src/code_mower/calibration/context_inputs.py

@@ -16,7 +16,12 @@ else:  # pragma: no cover - import shape depends on package layout.
     from .. import code_mower_context_packs
 
 
-CONTEXT_PACK_CLI_LANES = {"antigravity-cli", "gemini-cli", "hermes-cli"}
+CONTEXT_PACK_CLI_LANES = {
+    "antigravity-cli",
+    "gemini-cli",
+    "grok-build",
+    "hermes-cli",
+}
 
 
 def repo_roots_from_path_map(repo_path_map: Mapping[str, str]) -> dict[str, Path]:

{code_mower-0.5.0b37 → code_mower-0.5.0b38}/src/code_mower/calibration/planning.py

@@ -227,7 +227,12 @@ def build_pilot_plan(
                             for lens in reviewer.get("lenses", ["base-audit"])
                             if str(lens).strip()
                         ] or ["base-audit"]
-                        if lane_id in {"antigravity_cli", "gemini_cli", "hermes_cli"}:
+                        if lane_id in {
+                            "antigravity_cli",
+                            "gemini_cli",
+                            "grok_build",
+                            "hermes_cli",
+                        }:
                             output_leaf = _local_cli_output_leaf(
                                 lane_slug=lane_slug,
                                 lane_id=lane_id,

{code_mower-0.5.0b37 → code_mower-0.5.0b38}/src/code_mower/calibration/results.py

@@ -165,10 +165,17 @@ def run_records_from_summary(
             return expected_finding_matches(expected_findings, findings)
         return 1
 
-    if mode in {"antigravity-cli-audit", "gemini-cli-audit", "hermes-cli-audit"}:
+    if mode in {
+        "antigravity-cli-audit",
+        "gemini-cli-audit",
+        "grok-build-audit",
+        "hermes-cli-audit",
+    }:
         default_reviewer = (
             "antigravity-cli"
             if mode == "antigravity-cli-audit"
+            else "grok-build"
+            if mode == "grok-build-audit"
             else "hermes-cli"
             if mode == "hermes-cli-audit"
             else "gemini-cli"

{code_mower-0.5.0b37 → code_mower-0.5.0b38}/src/code_mower/cli.py

@@ -14,7 +14,7 @@ from pathlib import Path
 if __package__ in {None, ""}:
     raise SystemExit(
         "code_mower.cli is a packaged entrypoint. Install Code Mower with "
-        "`pipx install code-mower==0.5.0b37`, or run source checkouts with "
+        "`pipx install code-mower==0.5.0b38`, or run source checkouts with "
         "`PYTHONPATH=src python -m code_mower.cli`."
     )
 
@@ -39,6 +39,7 @@ from . import code_mower_telemetry
 from . import config as code_mower_config
 from . import doctor as code_mower_doctor
 from . import gemini_cli_audit_pr
+from . import grok_build_audit_pr
 from . import hermes_cli_audit_pr
 from . import init as code_mower_init
 from . import local_llm_audit_pr
@@ -395,6 +396,7 @@ COMMAND_DESCRIPTIONS: dict[str, str] = {
     "codex-audit-schema-smoke": "Smoke-test Codex audit schema parsing.",
     "doctor": "Check runtime, GitHub, providers, privacy, and cloud setup.",
     "gemini-cli": "Run a Gemini CLI structured audit lane.",
+    "grok-build": "Run a Grok Build informational audit lane.",
     "hermes-cli": "Run a Hermes CLI structured audit lane.",
     "init": "Render safe easy-mode setup output.",
     "local-llm": "Probe and run local OpenAI-compatible model lanes.",
@@ -524,6 +526,7 @@ COMMAND_HANDLERS: dict[str, CommandHandler] = {
     "codex-audit-schema-smoke": codex_audit_schema_smoke.main,
     "doctor": code_mower_doctor.main,
     "gemini-cli": gemini_cli_audit_pr.main,
+    "grok-build": grok_build_audit_pr.main,
     "hermes-cli": hermes_cli_audit_pr.main,
     "init": _init_main,
     "local-llm": _local_llm_main,

{code_mower-0.5.0b37 → code_mower-0.5.0b38}/src/code_mower/codex_audit_env_preflight.py

@@ -10,6 +10,7 @@ from __future__ import annotations
 
 import argparse
 import os
+import shutil
 import subprocess
 import sys
 from dataclasses import dataclass
@@ -17,7 +18,7 @@ from pathlib import Path
 from typing import Callable, Mapping, Optional, Sequence
 
 
-DEFAULT_CODEX_CLI_PATH = "/Applications/Codex.app/Contents/Resources/codex"
+DEFAULT_CODEX_CLI_PATH = "codex"
 DEFAULT_GITHUB_API_URL = "https://api.github.com"
 ENV_HELP = "Run: source tools/codex_audit_env.sh"
 
@@ -37,10 +38,18 @@ def resolve_required_setting(
     env: Mapping[str, str],
     env_name: str,
     label: str,
+    allow_path_lookup: bool = False,
 ) -> CheckResult:
     value = cli_value or env.get(env_name)
+    if not value and allow_path_lookup:
+        value = DEFAULT_CODEX_CLI_PATH
     if not value:
         return CheckResult(label, False, f"{env_name} is not set. {ENV_HELP}")
+    if allow_path_lookup and os.sep not in value and not (os.altsep and os.altsep in value):
+        resolved = shutil.which(value)
+        if not resolved:
+            return CheckResult(label, False, f"{env_name} command not found on PATH: {value}")
+        return CheckResult(label, True, resolved)
     path = Path(value)
     if not path.exists():
         return CheckResult(label, False, f"{env_name} does not exist: {value}")
@@ -164,8 +173,8 @@ def _parse_args(argv: Optional[Sequence[str]] = None) -> argparse.Namespace:
     )
     parser.add_argument(
         "--codex-cli-path",
-        default=os.environ.get("CODEX_CLI_PATH"),
-        help="Codex CLI path. Defaults to CODEX_CLI_PATH.",
+        default=os.environ.get("CODEX_CLI_PATH", DEFAULT_CODEX_CLI_PATH),
+        help="Codex CLI path or command. Defaults to CODEX_CLI_PATH or `codex` on PATH.",
     )
     parser.add_argument(
         "--github-url",
@@ -200,6 +209,7 @@ def main(argv: Optional[Sequence[str]] = None) -> int:
         env=env,
         env_name="CODEX_CLI_PATH",
         label="Codex CLI",
+        allow_path_lookup=True,
     )
     setup_results = [python_check, codex_check]
     if not all(result.ok for result in setup_results):

{code_mower-0.5.0b37 → code_mower-0.5.0b38}/src/code_mower/codex_audit_pr.py

@@ -146,7 +146,7 @@ else:  # pragma: no cover - exercised after package extraction.
 
 # ----- Configuration / defaults -----
 
-DEFAULT_CODEX_CLI_PATH = "/Applications/Codex.app/Contents/Resources/codex"
+DEFAULT_CODEX_CLI_PATH = "codex"
 DEFAULT_CODEX_TIMEOUT = 900  # 15 min; Codex review can take 5-10 min on a large diff
 DEFAULT_BASE_REF = "origin/main"
 DEFAULT_REPOS = "owner/repo,owner/other-repo"

{code_mower-0.5.0b37 → code_mower-0.5.0b38}/src/code_mower/doctor_checks/common.py

@@ -37,7 +37,15 @@ else:  # pragma: no cover - exercised after package extraction.
     from .. import secrets as code_mower_secrets
 
 
-SUPPORTED_TOKEN_FILE_ENV_NAMES = frozenset({"GEMINI_API_KEY", "GOOGLE_API_KEY"})
+SUPPORTED_TOKEN_FILE_ENV_NAMES = frozenset(
+    {
+        "GEMINI_API_KEY",
+        "GOOGLE_API_KEY",
+        "GROK_API_KEY",
+        "GROK_DEPLOYMENT_KEY",
+        "XAI_API_KEY",
+    }
+)
 TRUTHY_ENV_VALUES = frozenset({"1", "true", "yes", "on"})
 ACTIONS_BILLING_BLOCK_PATTERNS = (
     "recent account payments have failed",
@@ -122,6 +130,11 @@ def token_remediation(
                 "set GEMINI_API_KEY or GOOGLE_API_KEY, or run "
                 "`code-mower init auth gemini` and export GEMINI_API_KEY_FILE"
             )
+        elif set(names) & {"XAI_API_KEY", "GROK_DEPLOYMENT_KEY", "GROK_API_KEY"}:
+            parts.append(
+                "run `grok login --device-code` locally, or set XAI_API_KEY "
+                "or GROK_DEPLOYMENT_KEY before enabling the Grok Build lane"
+            )
         else:
             parts.append("set one of " + join_names(names))
     if not parts:

{code_mower-0.5.0b37 → code_mower-0.5.0b38}/src/code_mower/doctor_checks/provider_env.py

@@ -75,9 +75,15 @@ def check_required_env(lane_id: str, lane: Mapping[str, Any]) -> list[DoctorChec
         return []
     required = list(env_status.required)
     required_truthy = list(env_status.required_truthy)
+    required_any = list(env_status.required_any)
+    required_truthy_any = list(env_status.required_truthy_any)
     missing = list(env_status.missing)
     missing_truthy = list(env_status.missing_truthy)
-    if missing or missing_truthy:
+    if missing or missing_truthy or env_status.missing_any:
+        missing_parts = [*missing, *missing_truthy]
+        if env_status.missing_any:
+            any_group = [*required_any, *required_truthy_any]
+            missing_parts.append("one of: " + ", ".join(any_group))
         return [
             DoctorCheck(
                 name="env.required",
@@ -85,13 +91,16 @@ def check_required_env(lane_id: str, lane: Mapping[str, Any]) -> list[DoctorChec
                 lane=lane_id,
                 message=(
                     "missing required env vars: "
-                    + ", ".join([*missing, *missing_truthy])
+                    + ", ".join(missing_parts)
                 ),
                 detail={
                     "missing": missing,
                     "missing_truthy": missing_truthy,
+                    "missing_any": env_status.missing_any,
                     "required_env": required,
                     "required_env_truthy": required_truthy,
+                    "required_env_any": required_any,
+                    "required_env_truthy_any": required_truthy_any,
                 },
                 remediation=(
                     "Set the required env vars only when you accept the lane's "
@@ -108,6 +117,8 @@ def check_required_env(lane_id: str, lane: Mapping[str, Any]) -> list[DoctorChec
             detail={
                 "required_env": required,
                 "required_env_truthy": required_truthy,
+                "required_env_any": required_any,
+                "required_env_truthy_any": required_truthy_any,
             },
         )
     ]

{code_mower-0.5.0b37 → code_mower-0.5.0b38}/src/code_mower/doctor_checks/provider_env_required.py

@@ -13,22 +13,30 @@ from .common import TRUTHY_ENV_VALUES, as_sequence
 class ProviderRequiredEnvStatus:
     required: tuple[str, ...]
     required_truthy: tuple[str, ...]
+    required_any: tuple[str, ...]
+    required_truthy_any: tuple[str, ...]
     missing: tuple[str, ...]
     missing_truthy: tuple[str, ...]
+    missing_any: bool
 
     @property
     def declares_required_env(self) -> bool:
-        return bool(self.required or self.required_truthy)
+        return bool(
+            self.required
+            or self.required_truthy
+            or self.required_any
+            or self.required_truthy_any
+        )
 
     @property
     def all_present(self) -> bool:
-        return not self.missing and not self.missing_truthy
+        return not self.missing and not self.missing_truthy and not self.missing_any
 
 
 def provider_required_env_status(lane: Mapping[str, Any]) -> ProviderRequiredEnvStatus:
     provider_config = lane.get("provider_config", {})
     if not isinstance(provider_config, Mapping):
-        return ProviderRequiredEnvStatus((), (), (), ())
+        return ProviderRequiredEnvStatus((), (), (), (), (), (), False)
     required = tuple(
         str(name)
         for name in as_sequence(provider_config.get("required_env", []))
@@ -39,17 +47,35 @@ def provider_required_env_status(lane: Mapping[str, Any]) -> ProviderRequiredEnv
         for name in as_sequence(provider_config.get("required_env_truthy", []))
         if str(name).strip()
     )
+    required_any = tuple(
+        str(name)
+        for name in as_sequence(provider_config.get("required_env_any", []))
+        if str(name).strip()
+    )
+    required_truthy_any = tuple(
+        str(name)
+        for name in as_sequence(provider_config.get("required_env_truthy_any", []))
+        if str(name).strip()
+    )
     missing = tuple(name for name in required if not os.environ.get(name))
     missing_truthy = tuple(
         name
         for name in required_truthy
         if os.environ.get(name, "").strip().lower() not in TRUTHY_ENV_VALUES
     )
+    any_satisfied = any(os.environ.get(name) for name in required_any) or any(
+        os.environ.get(name, "").strip().lower() in TRUTHY_ENV_VALUES
+        for name in required_truthy_any
+    )
+    missing_any = bool(required_any or required_truthy_any) and not any_satisfied
     return ProviderRequiredEnvStatus(
         required=required,
         required_truthy=required_truthy,
+        required_any=required_any,
+        required_truthy_any=required_truthy_any,
         missing=missing,
         missing_truthy=missing_truthy,
+        missing_any=missing_any,
     )