devex-cli 0.30.0__tar.gz → 0.30.1__tar.gz

{devex_cli-0.30.0 → devex_cli-0.30.1}/.github/workflows/test.yml

@@ -5,13 +5,23 @@ on:
     branches: [main]
   pull_request:
 
+# Cancel superseded runs on the same ref so a rapid push sequence doesn't pile
+# up parallel matrices (Actions-quota savings — see issue #84).
+concurrency:
+  group: ${{ github.workflow }}-${{ github.ref }}
+  cancel-in-progress: true
+
 jobs:
+  # Linux-only matrix. macOS (runner ×10) and Windows (×2) were dropped to cut
+  # GitHub Actions quota — see issue #84 (devex was the org's #2 private-repo
+  # consumer; the 4 macOS legs were 65% of the quota cost from 19% of raw
+  # minutes). Trade-off: the Windows-specific guards this repo cares about
+  # (portalocker over fcntl/msvcrt; utf-8 encoding) are no longer exercised in CI.
   test:
-    runs-on: ${{ matrix.os }}
+    runs-on: ubuntu-latest
     strategy:
       fail-fast: false
       matrix:
-        os: [ubuntu-latest, macos-latest, windows-latest]
         python: ["3.10", "3.11", "3.12", "3.13"]
     steps:
       - uses: actions/checkout@34e114876b0b11c390a56381ad16ebd13914f8d5  # v4

{devex_cli-0.30.0 → devex_cli-0.30.1}/CHANGELOG.md

@@ -7,6 +7,20 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0
 
 ## [Unreleased]
 
+## [0.30.1] - 2026-06-19
+
+### Added
+
+- devex.core.qodo.MIN_PYTHON + python_supported() — the single in-code source of truth for qodo-cli's Python floor (mirrors the pyproject [qodo] marker).
+
+### Changed
+
+- CI: trimmed test.yml to a Linux-only matrix (was 3 OS x 4 Python, 12 jobs) and added workflow-level concurrency with cancel-in-progress to cut GitHub Actions quota (#84).
+
+### Fixed
+
+- devex reviewer unavailable notice and its "Next step:" footer no longer recommend pip install 'devex-cli[qodo]' on Python < 3.12, where the marker-gated extra cannot install at all — they now explain the interpreter is too old and show how to recreate the environment on Python >= 3.12.
+
 ## [0.30.0] - 2026-06-19
 
 ### Added

{devex_cli-0.30.0 → devex_cli-0.30.1}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: devex-cli
-Version: 0.30.0
+Version: 0.30.1
 Summary: Agent-operated developer-experience CLI — deterministic per-backend markdown briefings for autonomous agents.
 Project-URL: Homepage, https://culture.dev/devex/
 Project-URL: Repository, https://github.com/agentculture/devex

{devex_cli-0.30.0 → devex_cli-0.30.1}/pyproject.toml

@@ -1,6 +1,6 @@
 [project]
 name = "devex-cli"
-version = "0.30.0"
+version = "0.30.1"
 description = "Agent-operated developer-experience CLI — deterministic per-backend markdown briefings for autonomous agents."
 authors = [{name = "Ori Nachum"}]
 license = {text = "MIT"}

{devex_cli-0.30.0 → devex_cli-0.30.1}/src/devex/commands/reviewer/assets/backends/acp.yaml

@@ -1,5 +1,6 @@
 hints:
   reviewer_unavailable: "Install the integration with `uv tool install 'devex-cli[qodo]'`, then re-run the command — or keep using `{{ prog }} pr read` for Qodo findings."
+  reviewer_unavailable_old_python: "Recreate the environment on Python ≥ {{ min_python }} as shown above, then re-run the command — or keep using `{{ prog }} pr read` for Qodo findings."
   reviewer_failed: "Fix the cause above (pass `--pr <n>`, set `~/.qodo/config.json`, or run `gh auth login`), then re-run the `{{ prog }} reviewer` command."
   reviewer_rules: "Apply the most relevant rule above to your change, then continue your task (refine with `{{ prog }} reviewer rules \"...\"`)."
   reviewer_review_findings: "Triage the comments above, prepare fixes, then clear them with `{{ prog }} reviewer review resolve <id>`."

{devex_cli-0.30.0 → devex_cli-0.30.1}/src/devex/commands/reviewer/assets/backends/claude-code.yaml

@@ -1,5 +1,6 @@
 hints:
   reviewer_unavailable: "Install the integration with `uv tool install 'devex-cli[qodo]'`, then re-run the command — or keep using `{{ prog }} pr read` for Qodo findings."
+  reviewer_unavailable_old_python: "Recreate the environment on Python ≥ {{ min_python }} as shown above, then re-run the command — or keep using `{{ prog }} pr read` for Qodo findings."
   reviewer_failed: "Fix the cause above (pass `--pr <n>`, set `~/.qodo/config.json`, or run `gh auth login`), then re-run the `{{ prog }} reviewer` command."
   reviewer_rules: "Apply the most relevant rule above to your change, then continue your task (refine with `{{ prog }} reviewer rules \"...\"`)."
   reviewer_review_findings: "Triage the comments above, prepare fixes, then clear them with `{{ prog }} reviewer review resolve <id>`."

{devex_cli-0.30.0 → devex_cli-0.30.1}/src/devex/commands/reviewer/assets/backends/codex.yaml

@@ -1,5 +1,6 @@
 hints:
   reviewer_unavailable: "Install the integration with `uv tool install 'devex-cli[qodo]'`, then re-run the command — or keep using `{{ prog }} pr read` for Qodo findings."
+  reviewer_unavailable_old_python: "Recreate the environment on Python ≥ {{ min_python }} as shown above, then re-run the command — or keep using `{{ prog }} pr read` for Qodo findings."
   reviewer_failed: "Fix the cause above (pass `--pr <n>`, set `~/.qodo/config.json`, or run `gh auth login`), then re-run the `{{ prog }} reviewer` command."
   reviewer_rules: "Apply the most relevant rule above to your change, then continue your task (refine with `{{ prog }} reviewer rules \"...\"`)."
   reviewer_review_findings: "Triage the comments above, prepare fixes, then clear them with `{{ prog }} reviewer review resolve <id>`."

{devex_cli-0.30.0 → devex_cli-0.30.1}/src/devex/commands/reviewer/assets/backends/copilot.yaml

@@ -1,5 +1,6 @@
 hints:
   reviewer_unavailable: "Install the integration with `uv tool install 'devex-cli[qodo]'`, then re-run the command — or keep using `{{ prog }} pr read` for Qodo findings."
+  reviewer_unavailable_old_python: "Recreate the environment on Python ≥ {{ min_python }} as shown above, then re-run the command — or keep using `{{ prog }} pr read` for Qodo findings."
   reviewer_failed: "Fix the cause above (pass `--pr <n>`, set `~/.qodo/config.json`, or run `gh auth login`), then re-run the `{{ prog }} reviewer` command."
   reviewer_rules: "Apply the most relevant rule above to your change, then continue your task (refine with `{{ prog }} reviewer rules \"...\"`)."
   reviewer_review_findings: "Triage the comments above, prepare fixes, then clear them with `{{ prog }} reviewer review resolve <id>`."

devex_cli-0.30.1/src/devex/commands/reviewer/assets/unsupported.md.j2

@@ -0,0 +1,24 @@
+## `{{ verb_label }}` needs the optional qodo-cli integration
+
+`{{ verb_label }}` is powered by the sibling **qodo-cli**, which isn't installed in this environment.
+
+**To enable it:**
+
+{% if py_supported -%}
+```bash
+uv tool install 'devex-cli[qodo]'   # or: pip install 'devex-cli[qodo]'
+```
+{%- else -%}
+This environment is Python {{ py_version }}, but qodo-cli requires Python ≥ {{ min_python }}, so the `[qodo]` extra **can't install here at all** (it's marker-gated). Recreate the environment on Python {{ min_python }} first, then install:
+
+```bash
+uv venv --python {{ min_python }} && uv pip install -e '.[dev,qodo]'
+# or, as a standalone tool:  uv tool install --python {{ min_python }} 'devex-cli[qodo]'
+```
+{%- endif %}
+
+devex degrades gracefully without it — `pr read` / `pr await` still surface Qodo findings via the built-in HTML reader.
+
+Want this supported differently, or hit a problem? Open an issue: <{{ issue_url }}>
+
+{{ footer }}

{devex_cli-0.30.0 → devex_cli-0.30.1}/src/devex/commands/reviewer/scripts/next_step.py

@@ -13,7 +13,12 @@ from typing import Any
 def reviewer_next_step(verb_key: str, ctx: dict[str, Any]) -> tuple[str, dict[str, Any]]:
     """Return the footer rule key + context for a reviewer verb render."""
     if verb_key == "unavailable":
-        return "reviewer_unavailable", {}
+        # A too-old interpreter can't install the [qodo] extra at all (it's
+        # marker-gated to Python >= 3.12), so the footer must not repeat the
+        # "uv tool install" advice the body already replaced for that case.
+        if ctx.get("py_supported", True):
+            return "reviewer_unavailable", {}
+        return "reviewer_unavailable_old_python", {"min_python": ctx.get("min_python", "3.12")}
     if verb_key == "failed":
         return "reviewer_failed", {}
     if verb_key == "rules":

{devex_cli-0.30.0 → devex_cli-0.30.1}/src/devex/commands/reviewer/scripts/reviewer.py

@@ -20,6 +20,7 @@ read-only.
 
 from __future__ import annotations
 
+import sys
 from importlib.resources import files
 from importlib.resources.abc import Traversable
 from typing import Any
@@ -51,7 +52,13 @@ def _render(name: str, backend: Backend, verb_key: str, ctx: dict[str, Any]) ->
 
 
 def _unavailable(backend: Backend, verb_label: str) -> tuple[str, int, str]:
-    ctx = {"verb_label": verb_label, "issue_url": _ISSUE_URL}
+    ctx = {
+        "verb_label": verb_label,
+        "issue_url": _ISSUE_URL,
+        "py_supported": qodo_adapter.python_supported(),
+        "py_version": ".".join(str(n) for n in sys.version_info[:3]),
+        "min_python": ".".join(str(n) for n in qodo_adapter.MIN_PYTHON),
+    }
     return _render("unsupported.md.j2", backend, "unavailable", ctx), 0, ""
 
 

{devex_cli-0.30.0 → devex_cli-0.30.1}/src/devex/core/qodo.py

@@ -28,9 +28,26 @@ from __future__ import annotations
 
 import io
 import json
+import sys
 from contextlib import redirect_stderr, redirect_stdout
 from typing import Any
 
+# qodo-cli's Python floor — mirrors the `python_version >= '3.12'` marker on the
+# [qodo] extra in pyproject.toml. Kept here as the single in-code source of truth
+# so the reviewer "unsupported" notice can tell the user the accurate reason the
+# extra is missing (too-old interpreter vs. simply not installed).
+MIN_PYTHON: tuple[int, int] = (3, 12)
+
+
+def python_supported() -> bool:
+    """True iff the running interpreter is new enough to host qodo-cli (>= MIN_PYTHON).
+
+    Deterministic, read-only, never raises. On 3.10/3.11 the [qodo] extra can't
+    install at all (marker-gated), so the reviewer notice uses this to give
+    accurate guidance instead of advice that silently no-ops.
+    """
+    return sys.version_info[:2] >= MIN_PYTHON
+
 
 def _exit_code(exc: SystemExit) -> int:
     """Normalize a ``SystemExit`` code to an int (``None`` -> 0, str/other -> 1)."""

{devex_cli-0.30.0 → devex_cli-0.30.1}/tests/commands/test_reviewer.py

@@ -153,13 +153,33 @@ def test_config_renders_nested_payload(captured):
 # --- degradation (c14/h11) -------------------------------------------------
 
 
-def test_unavailable_is_exit_0_notice(monkeypatch):
+def test_unavailable_notice_supported_python(monkeypatch):
+    """On a new-enough interpreter the notice gives the install command."""
     monkeypatch.setattr(reviewer.qodo_adapter, "available", lambda: False)
+    monkeypatch.setattr(reviewer.qodo_adapter, "python_supported", lambda: True)
     out, code, _ = reviewer.rules(_BACKEND, "x")
     assert code == 0
     assert "needs the optional qodo-cli integration" in out
     assert "devex-cli[qodo]" in out
     assert "**Next step:**" in out
+    assert "Install the integration" in out  # footer matches the install body
+
+
+def test_unavailable_notice_old_python(monkeypatch):
+    """On Python < 3.12 the notice says the extra can't install — recreate on 3.12.
+
+    Both the body AND the "Next step:" footer must drop the install advice that
+    silently no-ops on a too-old interpreter.
+    """
+    monkeypatch.setattr(reviewer.qodo_adapter, "available", lambda: False)
+    monkeypatch.setattr(reviewer.qodo_adapter, "python_supported", lambda: False)
+    out, code, _ = reviewer.rules(_BACKEND, "x")
+    assert code == 0
+    assert "needs the optional qodo-cli integration" in out
+    assert "can't install here" in out
+    assert "3.12" in out
+    assert "**Next step:**" in out
+    assert "Recreate the environment" in out  # version-aware footer, not the install hint
 
 
 def test_qodo_failure_is_exit_0_notice(monkeypatch):

{devex_cli-0.30.0 → devex_cli-0.30.1}/tests/test_footer_hints.py

@@ -60,6 +60,7 @@ _FULL_CONTEXT: dict = {
     "backend": "claude-code",
     "elapsed": "42",
     "fail_count": 3,
+    "min_python": "3.12",
     "pr": 99,
     "reviewers": "@alice, @bob",
     "topic": "pr",

{devex_cli-0.30.0 → devex_cli-0.30.1}/uv.lock

@@ -206,7 +206,7 @@ toml = [
 
 [[package]]
 name = "devex-cli"
-version = "0.30.0"
+version = "0.30.1"
 source = { editable = "." }
 dependencies = [
     { name = "jinja2" },

devex_cli-0.30.0/src/devex/commands/reviewer/assets/unsupported.md.j2

@@ -1,15 +0,0 @@
-## `{{ verb_label }}` needs the optional qodo-cli integration
-
-`{{ verb_label }}` is powered by the sibling **qodo-cli**, which isn't installed in this environment.
-
-**To enable it:**
-
-```bash
-uv tool install 'devex-cli[qodo]'   # or: pip install 'devex-cli[qodo]'
-```
-
-(qodo-cli requires Python ≥ 3.12.) devex degrades gracefully without it — `pr read` / `pr await` still surface Qodo findings via the built-in HTML reader.
-
-Want this supported differently, or hit a problem? Open an issue: <{{ issue_url }}>
-
-{{ footer }}