code-mower 0.5.0b16__tar.gz → 0.5.0b18__tar.gz

{code_mower-0.5.0b16 → code_mower-0.5.0b18}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: code-mower
-Version: 0.5.0b16
+Version: 0.5.0b18
 Summary: Multi-reviewer AI code audit orchestration
 License-Expression: Apache-2.0
 Requires-Python: >=3.11
@@ -101,11 +101,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.0b16
+pipx install --python python3.12 code-mower==0.5.0b18
 code-mower --version
 ```
 
-`0.5.0b16` is a beta release. Until Code Mower publishes a stable `1.0`
+`0.5.0b18` is a beta release. Until Code Mower publishes a stable `1.0`
 line, use the explicit beta version above or allow prereleases with:
 
 ```bash
@@ -148,7 +148,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.0b16`.
+the latest 10/10 public-package readiness proof for `code-mower==0.5.0b18`.
 
 ## Why Not Just Run Codex Or Claude Yourself?
 
@@ -253,9 +253,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.16` from
+The current public beta is `v0.5.0-beta.18` from
 [codemower-ai/code-mower](https://github.com/codemower-ai/code-mower), published
-as `code-mower==0.5.0b16` on [PyPI](https://pypi.org/project/code-mower/).
+as `code-mower==0.5.0b18` 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.0b16 → code_mower-0.5.0b18}/README.md

@@ -86,11 +86,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.0b16
+pipx install --python python3.12 code-mower==0.5.0b18
 code-mower --version
 ```
 
-`0.5.0b16` is a beta release. Until Code Mower publishes a stable `1.0`
+`0.5.0b18` is a beta release. Until Code Mower publishes a stable `1.0`
 line, use the explicit beta version above or allow prereleases with:
 
 ```bash
@@ -133,7 +133,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.0b16`.
+the latest 10/10 public-package readiness proof for `code-mower==0.5.0b18`.
 
 ## Why Not Just Run Codex Or Claude Yourself?
 
@@ -238,9 +238,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.16` from
+The current public beta is `v0.5.0-beta.18` from
 [codemower-ai/code-mower](https://github.com/codemower-ai/code-mower), published
-as `code-mower==0.5.0b16` on [PyPI](https://pypi.org/project/code-mower/).
+as `code-mower==0.5.0b18` 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.0b16 → code_mower-0.5.0b18}/pyproject.toml

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

{code_mower-0.5.0b16 → code_mower-0.5.0b18}/src/code_mower/__init__.py

@@ -1,3 +1,3 @@
 """Code Mower package."""
 
-__version__ = "0.5.0b16"
+__version__ = "0.5.0b18"

{code_mower-0.5.0b16 → code_mower-0.5.0b18}/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.0b16`, or run source checkouts with "
+        "`pipx install code-mower==0.5.0b18`, or run source checkouts with "
         "`PYTHONPATH=src python -m code_mower.cli`."
     )
 

{code_mower-0.5.0b16 → code_mower-0.5.0b18}/src/code_mower/doctor_checks/provider_review_hygiene.py

@@ -2,6 +2,7 @@
 
 from __future__ import annotations
 
+from pathlib import Path
 from typing import Any, Mapping
 
 from .common import DoctorCheck, STATUS_FAIL, STATUS_PASS, STATUS_SKIP, as_sequence
@@ -12,6 +13,7 @@ def check_review_hygiene(
     lane: Mapping[str, Any],
     *,
     effective_lane: Mapping[str, Any] | None = None,
+    repo_root: Path | None = None,
 ) -> DoctorCheck:
     """Verify that merge-authority lanes have stale terminal-label protection."""
 
@@ -78,6 +80,36 @@ def check_review_hygiene(
             ),
         )
 
+    if repo_root is not None:
+        workflow_path = Path(workflow)
+        if not workflow_path.is_absolute():
+            workflow_path = repo_root / workflow_path
+        if not workflow_path.is_file():
+            return DoctorCheck(
+                name="provider.review_hygiene",
+                status=STATUS_FAIL,
+                lane=lane_id,
+                message=(
+                    "merge-authority lane stale terminal-label workflow is "
+                    f"configured but missing from the repo: {workflow}"
+                ),
+                detail={
+                    **detail,
+                    "workflow_exists": False,
+                    "workflow_path": str(workflow_path),
+                },
+                remediation=(
+                    "Run `code-mower init --easy --apply` from the repository "
+                    "root, commit the generated clear-stale workflow, then rerun "
+                    "doctor before relying on this lane as merge authority."
+                ),
+            )
+        detail = {
+            **detail,
+            "workflow_exists": True,
+            "workflow_path": str(workflow_path),
+        }
+
     return DoctorCheck(
         name="provider.review_hygiene",
         status=STATUS_PASS,

{code_mower-0.5.0b16 → code_mower-0.5.0b18}/src/code_mower/doctor_checks/providers.py

@@ -2,6 +2,7 @@
 
 from __future__ import annotations
 
+from pathlib import Path
 from typing import Any, Mapping
 
 from .common import (
@@ -112,11 +113,19 @@ def check_lane_runtime(
     lane: Mapping[str, Any],
     *,
     source_lane: Mapping[str, Any] | None = None,
+    repo_root: Path | None = None,
     probe_runtime: bool,
     http_timeout: int,
 ) -> list[DoctorCheck]:
     hygiene_source = source_lane if source_lane is not None else lane
-    checks = [check_review_hygiene(lane_id, hygiene_source, effective_lane=lane)]
+    checks = [
+        check_review_hygiene(
+            lane_id,
+            hygiene_source,
+            effective_lane=lane,
+            repo_root=repo_root,
+        )
+    ]
     checks.extend(check_token_env(lane_id, lane))
     checks.extend(check_required_env(lane_id, lane))
     driver = str(lane.get("driver", ""))

{code_mower-0.5.0b16 → code_mower-0.5.0b18}/src/code_mower/doctor_checks/runner.py

@@ -75,6 +75,10 @@ def run_doctor(
 ) -> DoctorReport:
     plan = build_doctor_run_plan(github=github, cloud=cloud)
     enabled_stages = {stage.id for stage in plan}
+    # `doctor --easy` can inspect the packaged example before a repo has written
+    # code-mower.yml. In that mode the example should teach the user about stale
+    # guards without failing because product workflow files are not installed yet.
+    repo_root = None if config_path.name == "code-mower.example.yml" else config_path.parent
     config, templates, checks = load_inputs(config_path, provider_templates_path)
     checks.append(
         _run_plan_check(
@@ -163,6 +167,7 @@ def run_doctor(
                 lane_id,
                 effective,
                 source_lane=lane,
+                repo_root=repo_root,
                 probe_runtime=probe_runtime,
                 http_timeout=http_timeout,
             )

{code_mower-0.5.0b16 → code_mower-0.5.0b18}/src/code_mower/providers/provenance.py

@@ -162,6 +162,31 @@ def _env_value(config: Mapping[str, Any], key: str) -> str:
     return _safe_text(os.environ.get(env_name)) if env_name else ""
 
 
+def _profile_model(config: Mapping[str, Any]) -> tuple[str, str]:
+    profile_env = _safe_text(config.get("profile_env"))
+    profile_id = _safe_text(os.environ.get(profile_env)) if profile_env else ""
+    profiles = config.get("profiles")
+    if not profile_id or not isinstance(profiles, Mapping):
+        return "", ""
+    profile = profiles.get(profile_id)
+    if not isinstance(profile, Mapping):
+        return "", profile_id
+    return _safe_text(profile.get("model")), profile_id
+
+
+def _configured_model(config: Mapping[str, Any]) -> tuple[str, str]:
+    env_model = _env_value(config, "model_env")
+    if env_model:
+        return env_model, "env"
+    profile_model, profile_id = _profile_model(config)
+    if profile_model:
+        return profile_model, f"profile:{profile_id}"
+    default_model = _safe_text(config.get("default_model"))
+    if default_model:
+        return default_model, "default"
+    return "", "missing"
+
+
 def _configured_command_candidates(
     config: Mapping[str, Any],
     provider: str,
@@ -208,7 +233,7 @@ def build_provider_lane_tool_provenance(
     driver = _safe_text(_lane_value(lane, "driver")) or "unknown"
     command_candidates = _configured_command_candidates(config, provider)
     command, resolved_command = _select_available_command(command_candidates)
-    model = _env_value(config, "model_env") or _safe_text(config.get("default_model"))
+    model, model_source = _configured_model(config)
     provider_from_env = _env_value(config, "provider_env")
     if provider_from_env:
         provider = provider_from_env
@@ -228,7 +253,9 @@ def build_provider_lane_tool_provenance(
         "command": command if driver == "local_cli" else "",
         "command_candidates": list(command_candidates) if driver == "local_cli" else [],
         "model_known": bool(model),
+        "model_source": model_source,
         "version_known": False,
+        "version_source": "not_probed" if driver != "local_cli" else "missing",
     }
     tool_version = ""
     if driver == "local_cli" and include_version_probe and command:
@@ -238,6 +265,7 @@ def build_provider_lane_tool_provenance(
             version_detail = detect_local_cli_version(resolved_command)
             tool_version = _safe_text(version_detail.get("tool_version"))
             detail["version_known"] = bool(tool_version)
+            detail["version_source"] = "cli_version_probe" if tool_version else "missing"
             detail["tool_version_available"] = bool(
                 version_detail.get("tool_version_available")
             )

{code_mower-0.5.0b16 → code_mower-0.5.0b18}/src/code_mower.egg-info/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: code-mower
-Version: 0.5.0b16
+Version: 0.5.0b18
 Summary: Multi-reviewer AI code audit orchestration
 License-Expression: Apache-2.0
 Requires-Python: >=3.11
@@ -101,11 +101,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.0b16
+pipx install --python python3.12 code-mower==0.5.0b18
 code-mower --version
 ```
 
-`0.5.0b16` is a beta release. Until Code Mower publishes a stable `1.0`
+`0.5.0b18` is a beta release. Until Code Mower publishes a stable `1.0`
 line, use the explicit beta version above or allow prereleases with:
 
 ```bash
@@ -148,7 +148,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.0b16`.
+the latest 10/10 public-package readiness proof for `code-mower==0.5.0b18`.
 
 ## Why Not Just Run Codex Or Claude Yourself?
 
@@ -253,9 +253,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.16` from
+The current public beta is `v0.5.0-beta.18` from
 [codemower-ai/code-mower](https://github.com/codemower-ai/code-mower), published
-as `code-mower==0.5.0b16` on [PyPI](https://pypi.org/project/code-mower/).
+as `code-mower==0.5.0b18` 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.0b16 → code_mower-0.5.0b18}/tests/test_doctor_provider_review_hygiene.py

@@ -1,5 +1,7 @@
 from __future__ import annotations
 
+from pathlib import Path
+from tempfile import TemporaryDirectory
 import unittest
 
 from code_mower.doctor_checks.provider_review_hygiene import check_review_hygiene
@@ -63,6 +65,50 @@ class DoctorProviderReviewHygieneTests(unittest.TestCase):
         self.assertEqual(check.detail["dispatch_workflow"], "codex-audit-labeler.yml")
         self.assertEqual(check.detail["trusted_authors"], ["codex[bot]"])
 
+    def test_merge_authority_lane_fails_when_configured_workflow_is_missing(self) -> None:
+        with TemporaryDirectory() as tmp:
+            repo_root = Path(tmp)
+            check = check_review_hygiene(
+                "codex",
+                {
+                    "merge_authority": True,
+                    "review_hygiene": {
+                        "workflow": ".github/workflows/codex-clear-stale.yml",
+                        "token_env": "GITHUB_TOKEN",
+                    },
+                },
+                repo_root=repo_root,
+            )
+
+        self.assertEqual(check.status, "fail")
+        self.assertIn("configured but missing", check.message)
+        self.assertEqual(check.detail["workflow_exists"], False)
+        self.assertIn(".github/workflows/codex-clear-stale.yml", check.detail["workflow_path"])
+        self.assertIn("code-mower init --easy --apply", check.remediation)
+
+    def test_merge_authority_lane_passes_when_configured_workflow_exists(self) -> None:
+        with TemporaryDirectory() as tmp:
+            repo_root = Path(tmp)
+            workflow = repo_root / ".github/workflows/codex-clear-stale.yml"
+            workflow.parent.mkdir(parents=True)
+            workflow.write_text("name: clear stale\n", encoding="utf-8")
+
+            check = check_review_hygiene(
+                "codex",
+                {
+                    "merge_authority": True,
+                    "review_hygiene": {
+                        "workflow": ".github/workflows/codex-clear-stale.yml",
+                        "token_env": "GITHUB_TOKEN",
+                    },
+                },
+                repo_root=repo_root,
+            )
+
+        self.assertEqual(check.status, "pass")
+        self.assertEqual(check.detail["workflow_exists"], True)
+        self.assertEqual(check.detail["workflow_path"], str(workflow))
+
     def test_merge_authority_lane_rejects_custom_hygiene_token_until_template_supports_it(self) -> None:
         check = check_review_hygiene(
             "devin",

code_mower-0.5.0b18/tests/test_doctor_registry.py

@@ -0,0 +1,140 @@
+import tempfile
+import unittest
+from pathlib import Path
+
+from code_mower.doctor_checks import (
+    build_doctor_run_plan,
+    default_check_group_ids,
+    run_doctor,
+)
+
+ROOT = Path(__file__).resolve().parents[1]
+
+
+class DoctorRegistryTests(unittest.TestCase):
+    def test_default_check_groups_stay_stable(self) -> None:
+        self.assertEqual(
+            default_check_group_ids(),
+            ("runtime", "github", "providers", "cloud", "output"),
+        )
+
+    def test_run_plan_enables_optional_stages_explicitly(self) -> None:
+        base_plan = build_doctor_run_plan()
+        self.assertEqual(
+            tuple(stage.id for stage in base_plan),
+            ("load-inputs", "select-profile", "runtime", "providers"),
+        )
+        self.assertTrue(all(not stage.optional for stage in base_plan))
+
+        full_plan = build_doctor_run_plan(github=True, cloud=True)
+        self.assertEqual(
+            tuple(stage.id for stage in full_plan),
+            ("load-inputs", "select-profile", "runtime", "providers", "github", "cloud"),
+        )
+        self.assertEqual(
+            {stage.id for stage in full_plan if stage.optional},
+            {"github", "cloud"},
+        )
+
+    def test_runner_emits_sanitized_run_plan_check_even_when_inputs_fail(self) -> None:
+        with tempfile.TemporaryDirectory() as root:
+            root_path = Path(root)
+            report = run_doctor(
+                config_path=root_path / "missing-code-mower.yml",
+                provider_templates_path=root_path / "missing-providers.yml",
+                profile="recommended",
+                github=True,
+                cloud=True,
+            )
+
+        plan_check = next(check for check in report.checks if check.name == "doctor.plan")
+        self.assertEqual(plan_check.status, "pass")
+        self.assertIn("github", plan_check.message)
+        self.assertIn("cloud", plan_check.message)
+        self.assertEqual(plan_check.detail["probe_runtime"], False)
+        self.assertEqual(
+            tuple(stage["id"] for stage in plan_check.detail["stages"]),
+            ("load-inputs", "select-profile", "runtime", "providers", "github", "cloud"),
+        )
+        self.assertEqual(
+            tuple(stage["id"] for stage in report.run_plan),
+            ("load-inputs", "select-profile", "runtime", "providers", "github", "cloud"),
+        )
+        self.assertEqual(
+            tuple(stage["id"] for stage in report.as_dict()["run_plan"]),
+            ("load-inputs", "select-profile", "runtime", "providers", "github", "cloud"),
+        )
+
+    def test_packaged_example_config_does_not_require_installed_stale_workflow(self) -> None:
+        report = run_doctor(
+            config_path=ROOT / "src/code_mower/templates/code-mower.example.yml",
+            provider_templates_path=ROOT / "src/code_mower/templates/providers.yml",
+            profile="recommended",
+        )
+
+        hygiene_checks = [
+            check for check in report.checks if check.name == "provider.review_hygiene"
+        ]
+        self.assertTrue(hygiene_checks)
+        self.assertFalse(
+            any(
+                check.status == "fail"
+                and "workflow is configured but missing" in check.message
+                for check in hygiene_checks
+            )
+        )
+
+    def test_real_config_requires_configured_stale_workflow_file(self) -> None:
+        with tempfile.TemporaryDirectory() as root:
+            root_path = Path(root)
+            config_path = root_path / "code-mower.yml"
+            config_path.write_text(
+                "\n".join(
+                    [
+                        "version: 1",
+                        "project:",
+                        "  name: test",
+                        "  state_dir: .code-mower",
+                        "repositories:",
+                        "  - slug: owner/repo",
+                        "    default_branch: main",
+                        "lanes:",
+                        "  codex:",
+                        "    type: audit",
+                        "    provider: codex",
+                        "    merge_authority: true",
+                        "    driver: manual",
+                        "    labels:",
+                        "      needs: needs-codex-audit",
+                        "      done: codex-audit-done",
+                        "      blocked: codex-audit-blocked",
+                        "    review_hygiene:",
+                        "      workflow: .github/workflows/codex-clear-stale.yml",
+                        "      token_env: GITHUB_TOKEN",
+                        "profiles:",
+                        "  recommended:",
+                        "    description: recommended lanes",
+                        "    lanes: [codex]",
+                    ]
+                ),
+                encoding="utf-8",
+            )
+
+            report = run_doctor(
+                config_path=config_path,
+                provider_templates_path=ROOT / "src/code_mower/templates/providers.yml",
+                profile="recommended",
+            )
+
+        hygiene_check = next(
+            check
+            for check in report.checks
+            if check.name == "provider.review_hygiene" and check.lane == "codex"
+        )
+        self.assertEqual(hygiene_check.status, "fail")
+        self.assertEqual(hygiene_check.detail["workflow_exists"], False)
+        self.assertIn("configured but missing", hygiene_check.message)
+
+
+if __name__ == "__main__":
+    unittest.main()

{code_mower-0.5.0b16 → code_mower-0.5.0b18}/tests/test_provider_local_cli.py

@@ -86,7 +86,9 @@ def test_provider_lane_tool_provenance_reads_version_and_model_env(
     assert detail["command_candidates"] == ["provider-cli"]
     assert detail["command_found"] is True
     assert detail["model_known"] is True
+    assert detail["model_source"] == "env"
     assert detail["version_known"] is True
+    assert detail["version_source"] == "cli_version_probe"
 
 
 def test_provider_lane_tool_provenance_uses_available_alternate_command(
@@ -121,3 +123,43 @@ def test_provider_lane_tool_provenance_uses_available_alternate_command(
     assert detail["command_candidates"] == ["agy", "antigravity"]
     assert detail["command_found"] is True
     assert detail["version_known"] is True
+
+
+def test_provider_lane_tool_provenance_reads_model_from_selected_profile(
+    monkeypatch,
+    tmp_path: Path,
+) -> None:
+    executable = _write_executable(
+        tmp_path / "local-model-cli",
+        "#!/bin/sh\nprintf 'local-model-cli 1.0.0\\n'\n",
+    )
+    monkeypatch.setenv("PATH", os.fspath(executable.parent))
+    monkeypatch.setenv("LOCAL_LLM_PROFILE", "qwen3-coder-next-lmstudio")
+    monkeypatch.delenv("LOCAL_LLM_MODEL", raising=False)
+    lane = {
+        "driver": "local_cli",
+        "provider": "openai_compatible",
+        "provider_config": {
+            "command": "local-model-cli",
+            "model_env": "LOCAL_LLM_MODEL",
+            "profile_env": "LOCAL_LLM_PROFILE",
+            "profiles": {
+                "qwen3-coder-next-lmstudio": {
+                    "model": "qwen/qwen3-coder-next",
+                    "endpoint": "lmstudio",
+                }
+            },
+        },
+    }
+
+    tool, detail = build_provider_lane_tool_provenance(
+        "local_llm",
+        lane,
+        source="unit-test",
+    )
+
+    assert tool["model"] == "qwen/qwen3-coder-next"
+    assert detail["model_known"] is True
+    assert detail["model_source"] == "profile:qwen3-coder-next-lmstudio"
+    assert detail["version_known"] is True
+    assert detail["version_source"] == "cli_version_probe"