code-mower 0.5.0b23__tar.gz → 0.5.0b25__tar.gz

{code_mower-0.5.0b23 → code_mower-0.5.0b25}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: code-mower
-Version: 0.5.0b23
+Version: 0.5.0b25
 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.0b23
+pipx install --python python3.12 code-mower==0.5.0b25
 code-mower --version
 ```
 
-`0.5.0b23` is a beta release. Until Code Mower publishes a stable `1.0`
+`0.5.0b25` 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.0b23`.
+the latest 10/10 public-package readiness proof for `code-mower==0.5.0b25`.
 
 ## 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.23` from
+The current public beta is `v0.5.0-beta.25` from
 [codemower-ai/code-mower](https://github.com/codemower-ai/code-mower), published
-as `code-mower==0.5.0b23` on [PyPI](https://pypi.org/project/code-mower/).
+as `code-mower==0.5.0b25` 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.0b23 → code_mower-0.5.0b25}/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.0b23
+pipx install --python python3.12 code-mower==0.5.0b25
 code-mower --version
 ```
 
-`0.5.0b23` is a beta release. Until Code Mower publishes a stable `1.0`
+`0.5.0b25` 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.0b23`.
+the latest 10/10 public-package readiness proof for `code-mower==0.5.0b25`.
 
 ## 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.23` from
+The current public beta is `v0.5.0-beta.25` from
 [codemower-ai/code-mower](https://github.com/codemower-ai/code-mower), published
-as `code-mower==0.5.0b23` on [PyPI](https://pypi.org/project/code-mower/).
+as `code-mower==0.5.0b25` 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.0b23 → code_mower-0.5.0b25}/pyproject.toml

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

{code_mower-0.5.0b23 → code_mower-0.5.0b25}/src/code_mower/__init__.py

@@ -1,3 +1,3 @@
 """Code Mower package."""
 
-__version__ = "0.5.0b23"
+__version__ = "0.5.0b25"

{code_mower-0.5.0b23 → code_mower-0.5.0b25}/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.0b23`, or run source checkouts with "
+        "`pipx install code-mower==0.5.0b25`, or run source checkouts with "
         "`PYTHONPATH=src python -m code_mower.cli`."
     )
 
@@ -52,6 +52,8 @@ from . import prompts as code_mower_prompts
 from . import reviewer_metrics
 from . import saas_reviewer_labeler
 from . import trailer_comment_labeler
+from .provider_registry import REFERENCE_PROVIDERS
+from .providers import build_provider_model_env_report
 
 
 def _has_positional_config(argv: list[str], options_with_values: set[str]) -> bool:
@@ -120,6 +122,19 @@ def _providers_main(argv: list[str]) -> int:
     show = subparsers.add_parser("show")
     show.add_argument("provider")
     show.add_argument("--json", action="store_true")
+    provenance_env = subparsers.add_parser("provenance-env")
+    provenance_env.add_argument(
+        "--provider",
+        action="append",
+        default=[],
+        help="Limit to a lane id or provider name. May be passed more than once.",
+    )
+    provenance_env.add_argument("--json", action="store_true")
+    provenance_env.add_argument(
+        "--shell",
+        action="store_true",
+        help="Print export command templates for missing model provenance.",
+    )
     args = parser.parse_args(argv)
 
     try:
@@ -141,6 +156,53 @@ def _providers_main(argv: list[str]) -> int:
             print(provider)
         return 0
 
+    if args.command == "provenance-env":
+        report = build_provider_model_env_report(
+            REFERENCE_PROVIDERS,
+            providers=tuple(args.provider),
+        )
+        if args.json:
+            print(json.dumps(report, indent=2, sort_keys=True))
+        elif args.shell:
+            for row in report["providers"]:
+                if row["action"] == "set_model_env":
+                    print(f"# {row['lane_id']} ({row['provider']})")
+                    print(row["export_command"])
+            if not any(row["action"] == "set_model_env" for row in report["providers"]):
+                print("# No missing model-provenance env vars found.")
+        else:
+            print("Code Mower provider model provenance env setup")
+            print(f"Status: {report['status']}")
+            print(f"Providers: {report['provider_count']}")
+            print(f"Missing model env: {report['missing_model_env_count']}")
+            for row in report["providers"]:
+                if row["action"] == "set_model_env":
+                    aliases = ", ".join(row["env_names"]) or "none"
+                    print(
+                        f"- {row['lane_id']}: set {row['preferred_env']} "
+                        f"(aliases: {aliases})"
+                    )
+                elif row["model_source"] == "vendor_hidden":
+                    print(f"- {row['lane_id']}: provider hides model/version metadata")
+                elif row["model_source"] == "default":
+                    print(f"- {row['lane_id']}: using configured default model")
+                elif row["model_source"].startswith("profile:"):
+                    print(f"- {row['lane_id']}: using profile model")
+                elif row["model_source"] == "env":
+                    print(f"- {row['lane_id']}: model env is configured")
+                elif row["model_source"] == "not_applicable":
+                    print(f"- {row['lane_id']}: model env is not applicable")
+                else:
+                    print(f"- {row['lane_id']}: model provenance is unknown")
+        if report["unknown_providers"]:
+            print(
+                "error: unknown provider(s): "
+                + ", ".join(report["unknown_providers"]),
+                file=sys.stderr,
+            )
+            return 1
+        return 0
+
     if args.command == "show":
         provider = providers.get(args.provider)
         if not isinstance(provider, dict):

{code_mower-0.5.0b23 → code_mower-0.5.0b25}/src/code_mower/providers/__init__.py

@@ -7,9 +7,12 @@ public CLI remains the stable surface while provider internals settle.
 
 from .provenance import (
     TOOL_PROVENANCE_SCHEMA,
+    build_provider_model_env_report,
     build_provider_lane_tool_provenance,
     build_code_mower_tool_provenance,
+    model_env_names,
     normalize_tool_provenance,
+    preferred_model_env_name,
     runtime_environment,
 )
 from .local_cli import detect_local_cli_version, safe_version_line
@@ -18,8 +21,11 @@ __all__ = [
     "TOOL_PROVENANCE_SCHEMA",
     "build_code_mower_tool_provenance",
     "build_provider_lane_tool_provenance",
+    "build_provider_model_env_report",
     "detect_local_cli_version",
+    "model_env_names",
     "normalize_tool_provenance",
+    "preferred_model_env_name",
     "runtime_environment",
     "safe_version_line",
 ]

{code_mower-0.5.0b23 → code_mower-0.5.0b25}/src/code_mower/providers/provenance.py

@@ -183,6 +183,100 @@ def _env_value_any(config: Mapping[str, Any], key: str, any_key: str) -> str:
     return ""
 
 
+def model_env_names(config: Mapping[str, Any]) -> tuple[str, ...]:
+    """Return ordered model env vars for a provider config.
+
+    The primary provider env var is listed first, followed by aliases from
+    ``model_env_any``. Duplicate names are removed while preserving order.
+    """
+
+    env_names: list[str] = []
+    primary = _safe_text(config.get("model_env"))
+    if primary:
+        env_names.append(primary)
+    for env_name in _text_values(config.get("model_env_any")):
+        if env_name not in env_names:
+            env_names.append(env_name)
+    return tuple(env_names)
+
+
+def preferred_model_env_name(config: Mapping[str, Any]) -> str:
+    """Choose the env var Code Mower should recommend setting.
+
+    Prefer the Code Mower-specific alias when present so users can record
+    benchmark model identity without changing the behavior of the provider CLI
+    itself.
+    """
+
+    names = model_env_names(config)
+    for name in names:
+        if name.startswith("CODE_MOWER_"):
+            return name
+    return names[0] if names else ""
+
+
+def build_provider_model_env_report(
+    lanes: Mapping[str, Any],
+    *,
+    providers: tuple[str, ...] = (),
+) -> dict[str, Any]:
+    """Build a privacy-safe model-provenance setup report for provider lanes."""
+
+    requested = {provider.strip() for provider in providers if provider.strip()}
+    rows: list[dict[str, Any]] = []
+    matched: set[str] = set()
+    for lane_id, lane in sorted(lanes.items()):
+        provider = _safe_text(_lane_value(lane, "provider")) or lane_id
+        if requested and lane_id not in requested and provider not in requested:
+            continue
+        if lane_id in requested:
+            matched.add(lane_id)
+        if provider in requested:
+            matched.add(provider)
+        config = _provider_config(lane)
+        driver = _safe_text(_lane_value(lane, "driver")) or "unknown"
+        model, model_source = _configured_model(config, driver)
+        env_names = model_env_names(config)
+        preferred_env = preferred_model_env_name(config)
+        env_status = [
+            {"name": name, "is_set": bool(os.environ.get(name, "").strip())}
+            for name in env_names
+        ]
+        if model_source == "missing" and preferred_env:
+            action = "set_model_env"
+            export_command = f'export {preferred_env}="TODO_MODEL_NAME"'
+        elif model_source == "missing":
+            action = "not_configurable"
+            export_command = ""
+        else:
+            action = "none"
+            export_command = ""
+        rows.append(
+            {
+                "lane_id": lane_id,
+                "provider": provider,
+                "driver": driver,
+                "model_known": bool(model),
+                "model_source": model_source,
+                "env_names": list(env_names),
+                "preferred_env": preferred_env,
+                "env_status": env_status,
+                "action": action,
+                "export_command": export_command,
+            }
+        )
+    unknown = sorted(requested - matched)
+    missing = [row for row in rows if row["action"] == "set_model_env"]
+    return {
+        "mode": "code-mower-provider-model-env-report",
+        "providers": rows,
+        "provider_count": len(rows),
+        "missing_model_env_count": len(missing),
+        "unknown_providers": unknown,
+        "status": "fail" if unknown else "pass",
+    }
+
+
 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 ""

{code_mower-0.5.0b23 → code_mower-0.5.0b25}/src/code_mower.egg-info/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: code-mower
-Version: 0.5.0b23
+Version: 0.5.0b25
 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.0b23
+pipx install --python python3.12 code-mower==0.5.0b25
 code-mower --version
 ```
 
-`0.5.0b23` is a beta release. Until Code Mower publishes a stable `1.0`
+`0.5.0b25` 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.0b23`.
+the latest 10/10 public-package readiness proof for `code-mower==0.5.0b25`.
 
 ## 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.23` from
+The current public beta is `v0.5.0-beta.25` from
 [codemower-ai/code-mower](https://github.com/codemower-ai/code-mower), published
-as `code-mower==0.5.0b23` on [PyPI](https://pypi.org/project/code-mower/).
+as `code-mower==0.5.0b25` 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.0b23 → code_mower-0.5.0b25}/tests/test_cloud_client.py

@@ -299,7 +299,7 @@ def test_provenance_summary_preserves_source_quality_fields() -> None:
                     "tool": {
                         "role": "reporter",
                         "tool_name": "code-mower",
-                        "tool_version": "0.5.0b23",
+                        "tool_version": "0.5.0b25",
                         "provider": "code-mower",
                         "model": "",
                         "model_source": "not_applicable",

{code_mower-0.5.0b23 → code_mower-0.5.0b25}/tests/test_provider_local_cli.py

@@ -4,8 +4,12 @@ import os
 from pathlib import Path
 
 from code_mower.provider_registry import REFERENCE_PROVIDERS
+from code_mower import cli as code_mower_cli
 from code_mower.providers import build_provider_lane_tool_provenance
-from code_mower.providers.provenance import build_code_mower_tool_provenance
+from code_mower.providers.provenance import (
+    build_code_mower_tool_provenance,
+    build_provider_model_env_report,
+)
 from code_mower.providers.local_cli import detect_local_cli_version, safe_version_line
 
 
@@ -129,6 +133,89 @@ def test_provider_lane_tool_provenance_reads_model_env_aliases(
     assert detail["model_source"] == "env"
 
 
+def test_provider_model_env_report_prefers_code_mower_alias(monkeypatch) -> None:
+    monkeypatch.delenv("CODE_MOWER_CODEX_MODEL", raising=False)
+    monkeypatch.delenv("CODEX_MODEL", raising=False)
+    monkeypatch.delenv("OPENAI_MODEL", raising=False)
+
+    report = build_provider_model_env_report(
+        REFERENCE_PROVIDERS,
+        providers=("codex",),
+    )
+
+    assert report["status"] == "pass"
+    assert report["missing_model_env_count"] == 1
+    row = report["providers"][0]
+    assert row["lane_id"] == "codex"
+    assert row["preferred_env"] == "CODE_MOWER_CODEX_MODEL"
+    assert row["env_names"] == [
+        "CODE_MOWER_CODEX_MODEL",
+        "CODEX_MODEL",
+        "OPENAI_MODEL",
+    ]
+    assert row["action"] == "set_model_env"
+    assert row["export_command"] == 'export CODE_MOWER_CODEX_MODEL="TODO_MODEL_NAME"'
+
+
+def test_provider_model_env_report_never_exposes_env_value(monkeypatch) -> None:
+    monkeypatch.setenv("CODE_MOWER_GEMINI_MODEL", "sensitive-model-name")
+
+    report = build_provider_model_env_report(
+        REFERENCE_PROVIDERS,
+        providers=("gemini_cli",),
+    )
+
+    rendered = str(report)
+    assert "sensitive-model-name" not in rendered
+    row = report["providers"][0]
+    assert row["model_source"] == "env"
+    assert row["model_known"] is True
+    assert row["env_status"] == [
+        {"name": "GEMINI_MODEL", "is_set": False},
+        {"name": "CODE_MOWER_GEMINI_MODEL", "is_set": True},
+        {"name": "GOOGLE_GENAI_MODEL", "is_set": False},
+    ]
+    assert row["action"] == "none"
+
+
+def test_providers_provenance_env_cli_shell_output(monkeypatch, capsys) -> None:
+    monkeypatch.delenv("CODE_MOWER_ANTIGRAVITY_MODEL", raising=False)
+    monkeypatch.delenv("ANTIGRAVITY_MODEL", raising=False)
+
+    exit_code = code_mower_cli.main(
+        [
+            "providers",
+            "provenance-env",
+            "--provider",
+            "antigravity_cli",
+            "--shell",
+        ]
+    )
+
+    captured = capsys.readouterr()
+    assert exit_code == 0
+    assert "# antigravity_cli (antigravity)" in captured.out
+    assert 'export CODE_MOWER_ANTIGRAVITY_MODEL="TODO_MODEL_NAME"' in captured.out
+    assert captured.err == ""
+
+
+def test_providers_provenance_env_cli_rejects_unknown(capsys) -> None:
+    exit_code = code_mower_cli.main(
+        [
+            "providers",
+            "provenance-env",
+            "--provider",
+            "not-a-provider",
+            "--json",
+        ]
+    )
+
+    captured = capsys.readouterr()
+    assert exit_code == 1
+    assert '"unknown_providers": [' in captured.out
+    assert "not-a-provider" in captured.err
+
+
 def test_provider_lane_tool_provenance_prefers_primary_model_env(
     monkeypatch,
     tmp_path: Path,
@@ -290,11 +377,11 @@ def test_provider_lane_tool_provenance_reads_model_from_selected_profile(
 def test_code_mower_reporter_provenance_marks_model_not_applicable() -> None:
     tool = build_code_mower_tool_provenance(
         source="unit-test",
-        version="0.5.0b23",
+        version="0.5.0b25",
     )
 
     assert tool["tool_name"] == "code-mower"
-    assert tool["tool_version"] == "0.5.0b23"
+    assert tool["tool_version"] == "0.5.0b25"
     assert tool["provider"] == "code-mower"
     assert tool["model"] == ""
     assert tool["model_source"] == "not_applicable"