agentic-dev-loop 0.10.3__tar.gz → 0.10.5__tar.gz

{agentic_dev_loop-0.10.3/src/agentic_dev_loop.egg-info → agentic_dev_loop-0.10.5}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: agentic-dev-loop
-Version: 0.10.3
+Version: 0.10.5
 Summary: Turn an LLM into a gated, sandboxed, resumable construction loop over your codebase.
 Author: Luke Wilson
 License-Expression: Apache-2.0
@@ -492,8 +492,10 @@ before.
 `agentic-dev-loop doctor --fast` is the per-run gate the trigger runs first.
 Hard failures abort the run (engine pin mismatch, engine runtime availability,
 API version, git repo, `.env*` files); warnings print and continue. `doctor
---json` emits the same results mechanically. The trigger repairs a pin/install
-mismatch exactly once, then fails hard.
+--json` emits the same results mechanically. On a hard failure the trigger
+runs `agentic-dev-loop upgrade` exactly once: it installs the latest release
+with pipx and rewrites `.engine-version` to match, then the run fails hard if
+doctor still fails.
 
 A consumer repo needs a pipeline file and the agent files it names, both
 committed before the first run (the host-boundary check refuses dirty tooling,

{agentic_dev_loop-0.10.3 → agentic_dev_loop-0.10.5}/README.md

@@ -448,8 +448,10 @@ before.
 `agentic-dev-loop doctor --fast` is the per-run gate the trigger runs first.
 Hard failures abort the run (engine pin mismatch, engine runtime availability,
 API version, git repo, `.env*` files); warnings print and continue. `doctor
---json` emits the same results mechanically. The trigger repairs a pin/install
-mismatch exactly once, then fails hard.
+--json` emits the same results mechanically. On a hard failure the trigger
+runs `agentic-dev-loop upgrade` exactly once: it installs the latest release
+with pipx and rewrites `.engine-version` to match, then the run fails hard if
+doctor still fails.
 
 A consumer repo needs a pipeline file and the agent files it names, both
 committed before the first run (the host-boundary check refuses dirty tooling,

{agentic_dev_loop-0.10.3 → agentic_dev_loop-0.10.5}/pyproject.toml

@@ -4,7 +4,7 @@ build-backend = "setuptools.build_meta"
 
 [project]
 name = "agentic-dev-loop"
-version = "0.10.3"
+version = "0.10.5"
 description = "Turn an LLM into a gated, sandboxed, resumable construction loop over your codebase."
 readme = "README.md"
 requires-python = ">=3.12"

{agentic_dev_loop-0.10.3 → agentic_dev_loop-0.10.5}/src/agentic_dev_loop/core/profiles/__init__.py

@@ -81,18 +81,16 @@ def parse_version(text: str) -> tuple[int, int, int, int, int]:
     return (int(major), int(minor), int(patch), _RANK[pre], int(num))
 
 
-def check_engine_min(engine_min: str, installed: str,
-                     latest: str | None = None) -> None:
+def check_engine_min(engine_min: str, installed: str) -> None:
     """Raise unless ``installed`` satisfies ``engine_min``.
 
-    ``latest`` is substituted into the fix line by the caller (doctor); when
-    omitted the floor itself is used.
+    The fix line names the upgrade command: it installs the latest release,
+    which always satisfies the floor.
     """
     if parse_version(installed) < parse_version(engine_min):
-        target = latest or engine_min
         raise ProfileError(
             f"profile requires engine >= {engine_min}; installed {installed}. "
-            f'Upgrade: pipx install --force "agentic-dev-loop=={target}"')
+            "Upgrade: run agentic-dev-loop upgrade")
 
 
 def _data_dir():

{agentic_dev_loop-0.10.3 → agentic_dev_loop-0.10.5}/src/agentic_dev_loop/engine/cli.py

@@ -171,6 +171,9 @@ def main(argv: list[str] | None = None) -> int:
     if argv and argv[0] == "doctor":
         from .onboarding.doctor import run_doctor
         return run_doctor(argv[1:])
+    if argv and argv[0] == "upgrade":
+        from .onboarding.upgrade import run_upgrade
+        return run_upgrade(argv[1:])
     probe = argparse.ArgumentParser(add_help=False)
     probe.add_argument("pipeline", type=Path, nargs="?")
     _add_version_flag(probe)

{agentic_dev_loop-0.10.3 → agentic_dev_loop-0.10.5}/src/agentic_dev_loop/engine/extensions/aidlc.py

@@ -74,12 +74,18 @@ def resolve_unit_docs_with_sources(
                 sources[f"inception/{file.name}"] = file
 
     # The unit's code-generation plans are the build spec - absent is fine,
-    # present is how the spec reaches agents.
+    # present is how the spec reaches agents. Two shapes are in the wild:
+    # bare (`unit-3-code-generation-plan.md`) and infixed
+    # (`unit-3-scan-core-types-code-generation-plan.md`); the bare shape must
+    # not be lost, and neither pattern may leak into a slug that merely
+    # extends this one (unit-3 must not match a unit-30 plan).
     plans_dir = docs_dir / "construction" / "plans"
     if plans_dir.is_dir():
-        for file in sorted(plans_dir.glob(f"{unit_slug}-*-code-generation-plan.md")):
-            docs[f"plans/{file.name}"] = file.read_text(encoding="utf-8")
-            sources[f"plans/{file.name}"] = file
+        for pattern in (f"{unit_slug}-code-generation-plan.md",
+                        f"{unit_slug}-*-code-generation-plan.md"):
+            for file in sorted(plans_dir.glob(pattern)):
+                docs[f"plans/{file.name}"] = file.read_text(encoding="utf-8")
+                sources[f"plans/{file.name}"] = file
 
     return docs, sources
 

{agentic_dev_loop-0.10.3 → agentic_dev_loop-0.10.5}/src/agentic_dev_loop/engine/onboarding/checks.py

@@ -25,6 +25,7 @@ __all__ = ["Check", "HostProbes", "collect_checks"]
 ENV_WHITELIST = frozenset({".env.example", ".env.template", ".env.sample"})
 MIN_API = (1, 43)
 PYPI_URL = "https://pypi.org/pypi/agentic-dev-loop/json"
+FIX_UPGRADE = "run agentic-dev-loop upgrade"
 
 
 @dataclass(frozen=True)
@@ -171,12 +172,12 @@ def collect_checks(profile: Profile | None, pipeline, installed: str,
     if pin is None:
         checks.append(_hard(
             "pin", False, f"no engine pin file at {pin_path}",
-            "run agentic-dev-loop init (or write agentic-dev-loop/.engine-version)"))
+            FIX_UPGRADE))
     else:
         checks.append(_hard(
             "pin", pin == installed,
             f"installed {installed}, pin {pin}",
-            f'pipx install --force "agentic-dev-loop=={pin}"'))
+            FIX_UPGRADE))
         latest = probes.latest_release()
         if latest is None:
             checks.append(_hard("pin-latest", True,
@@ -189,7 +190,7 @@ def collect_checks(profile: Profile | None, pipeline, installed: str,
             checks.append(_hard(
                 "pin-latest", not behind,
                 f"pin {pin} is behind latest release {latest}",
-                f'pipx install --force "agentic-dev-loop=={latest}"'))
+                FIX_UPGRADE))
 
     present = probes.docker_present()
     checks.append(_hard(

{agentic_dev_loop-0.10.3 → agentic_dev_loop-0.10.5}/src/agentic_dev_loop/engine/onboarding/templates/trigger-agentic-dev-loop.sh

@@ -5,7 +5,6 @@ ROOT="$(cd "$(dirname "$0")" && pwd)"
 cd "$ROOT"
 
 PIPELINE="$ROOT/agentic-dev-loop/pipeline.yaml"
-PIN_FILE="$ROOT/agentic-dev-loop/.engine-version"
 
 # Optional host environment file. The default lives outside the workspace so
 # secrets never enter the repo; set AGENTIC_DEV_LOOP_ENV_FILE to override.
@@ -25,24 +24,17 @@ if ! command -v agentic-dev-loop >/dev/null 2>&1; then
   exit 1
 fi
 
-if [[ ! -f "$PIN_FILE" ]]; then
-  echo "error: missing engine pin file: $PIN_FILE" >&2
-  echo "       run 'agentic-dev-loop init' in this repo to write it" >&2
-  exit 1
-fi
-PIN="$(cat "$PIN_FILE")"
-
 # doctor --fast is the per-run gate: hard failures abort, warnings continue.
-# A pin/install mismatch is repaired exactly once, then the run fails hard.
+# A failing gate is repaired exactly once by upgrading to the latest engine
+# release (which also rewrites the project pin), then the run fails hard.
 if ! agentic-dev-loop doctor --fast; then
-  echo "error: doctor --fast failed - repairing the engine pin $PIN once" >&2
-  if ! pipx install --force "agentic-dev-loop==$PIN"; then
-    echo "error: could not install agentic-dev-loop==$PIN" >&2
-    echo "       the install may not be pipx-managed, or the index is unreachable" >&2
+  echo "doctor --fast failed - upgrading to the latest engine release" >&2
+  if ! agentic-dev-loop upgrade; then
+    echo "error: agentic-dev-loop upgrade failed" >&2
     exit 1
   fi
   if ! agentic-dev-loop doctor --fast; then
-    echo "error: doctor --fast still fails after repairing the engine pin" >&2
+    echo "error: doctor --fast still fails after upgrading the engine" >&2
     exit 1
   fi
 fi

agentic_dev_loop-0.10.5/src/agentic_dev_loop/engine/onboarding/upgrade.py

@@ -0,0 +1,76 @@
+"""``agentic-dev-loop upgrade``: install the latest engine and sync the pin.
+
+Installs the latest release with pipx and rewrites
+``agentic-dev-loop/.engine-version`` to the installed version, so the host
+install and the committed pin converge in one action.
+"""
+
+from __future__ import annotations
+
+import argparse
+import shutil
+import subprocess
+import sys
+from pathlib import Path
+
+from agentic_dev_loop.core.profiles import ProfileError, parse_version
+
+__all__ = ["run_upgrade"]
+
+
+def _resolve(name: str, env: dict | None) -> str | None:
+    if env is not None:
+        return shutil.which(name, path=env.get("PATH", ""))
+    return shutil.which(name)
+
+
+def run_upgrade(argv: list[str], *, workspace: Path | None = None,
+                env: dict | None = None) -> int:
+    parser = argparse.ArgumentParser(
+        prog="agentic-dev-loop upgrade",
+        description="Install the latest engine release and rewrite the "
+                    "project pin file to match.")
+    parser.parse_args(argv)
+
+    root = Path(workspace or Path.cwd()).resolve()
+    pipx = _resolve("pipx", env)
+    if pipx is None:
+        print("error: pipx is not on PATH; the engine install must be "
+              "pipx-managed", file=sys.stderr)
+        return 1
+
+    result = subprocess.run(
+        [pipx, "install", "--force", "agentic-dev-loop"],
+        capture_output=True, text=True, check=False, env=env)
+    if result.returncode != 0:
+        detail = (result.stderr or "unknown error").strip()
+        print(f"error: pipx install failed: {detail}", file=sys.stderr)
+        return 1
+
+    cli = _resolve("agentic-dev-loop", env)
+    if cli is None:
+        print("error: agentic-dev-loop is not on PATH", file=sys.stderr)
+        return 1
+    version_result = subprocess.run(
+        [cli, "--version"], capture_output=True, text=True,
+        check=False, env=env)
+    if version_result.returncode != 0:
+        detail = (version_result.stderr or "unknown error").strip()
+        print(f"error: could not read the installed version: {detail}",
+              file=sys.stderr)
+        return 1
+
+    tokens = version_result.stdout.split()
+    version = tokens[-1] if tokens else ""
+    try:
+        parse_version(version)
+    except ProfileError:
+        print("error: unreadable version from --version output: "
+              f"{version_result.stdout.strip()!r}", file=sys.stderr)
+        return 1
+
+    out = root / "agentic-dev-loop"
+    out.mkdir(parents=True, exist_ok=True)
+    (out / ".engine-version").write_text(version + "\n", encoding="utf-8")
+    print(f"upgraded agentic-dev-loop to {version}; .engine-version updated")
+    return 0

{agentic_dev_loop-0.10.3 → agentic_dev_loop-0.10.5/src/agentic_dev_loop.egg-info}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: agentic-dev-loop
-Version: 0.10.3
+Version: 0.10.5
 Summary: Turn an LLM into a gated, sandboxed, resumable construction loop over your codebase.
 Author: Luke Wilson
 License-Expression: Apache-2.0
@@ -492,8 +492,10 @@ before.
 `agentic-dev-loop doctor --fast` is the per-run gate the trigger runs first.
 Hard failures abort the run (engine pin mismatch, engine runtime availability,
 API version, git repo, `.env*` files); warnings print and continue. `doctor
---json` emits the same results mechanically. The trigger repairs a pin/install
-mismatch exactly once, then fails hard.
+--json` emits the same results mechanically. On a hard failure the trigger
+runs `agentic-dev-loop upgrade` exactly once: it installs the latest release
+with pipx and rewrites `.engine-version` to match, then the run fails hard if
+doctor still fails.
 
 A consumer repo needs a pipeline file and the agent files it names, both
 committed before the first run (the host-boundary check refuses dirty tooling,

{agentic_dev_loop-0.10.3 → agentic_dev_loop-0.10.5}/src/agentic_dev_loop.egg-info/SOURCES.txt

@@ -55,6 +55,7 @@ src/agentic_dev_loop/engine/onboarding/doctor.py
 src/agentic_dev_loop/engine/onboarding/init.py
 src/agentic_dev_loop/engine/onboarding/recipes.py
 src/agentic_dev_loop/engine/onboarding/templates.py
+src/agentic_dev_loop/engine/onboarding/upgrade.py
 src/agentic_dev_loop/engine/onboarding/recipes/dotnet-node.yaml
 src/agentic_dev_loop/engine/onboarding/recipes/python.yaml
 src/agentic_dev_loop/engine/onboarding/templates/dev.agent.md
@@ -81,6 +82,7 @@ tests/test_055_profiles.py
 tests/test_055_recipes.py
 tests/test_055_schema_lock.py
 tests/test_055_templates.py
+tests/test_055_upgrade.py
 tests/test_actions.py
 tests/test_agent_error_guide.py
 tests/test_agents.py

{agentic_dev_loop-0.10.3 → agentic_dev_loop-0.10.5}/tests/test_055_cli.py

@@ -1,4 +1,4 @@
-"""055 Task 8: CLI dispatch for init and doctor."""
+"""055 Task 8: CLI dispatch for init, doctor, and upgrade."""
 
 from __future__ import annotations
 
@@ -24,6 +24,13 @@ def test_init_help_exits_zero(capsys):
     assert "usage" in capsys.readouterr().out.lower()
 
 
+def test_upgrade_help_exits_zero(capsys):
+    with pytest.raises(SystemExit) as exc:
+        main(["upgrade", "--help"])
+    assert exc.value.code == 0
+    assert "usage" in capsys.readouterr().out.lower()
+
+
 def test_doctor_json_fast_returns_int(monkeypatch, capsys):
     from agentic_dev_loop.engine.onboarding import checks
 

{agentic_dev_loop-0.10.3 → agentic_dev_loop-0.10.5}/tests/test_055_doctor.py

@@ -95,7 +95,7 @@ def test_installed_pin_mismatch_is_hard_with_fix_text(tmp_path: Path, capsys):
     out = capsys.readouterr().out
     assert code == 1
     assert "HARD" in out
-    assert 'pipx install --force "agentic-dev-loop==0.9.2"' in out
+    assert "run agentic-dev-loop upgrade" in out
 
 
 def test_missing_placeholder_on_path_is_hard(tmp_path: Path, capsys):

{agentic_dev_loop-0.10.3 → agentic_dev_loop-0.10.5}/tests/test_055_profiles.py

@@ -41,7 +41,7 @@ def test_check_engine_min_blocks_with_exact_message():
         check_engine_min("0.10.0", "0.9.2")
     assert str(exc.value) == (
         'profile requires engine >= 0.10.0; installed 0.9.2. '
-        'Upgrade: pipx install --force "agentic-dev-loop==0.10.0"'
+        'Upgrade: run agentic-dev-loop upgrade'
     )
 
 

{agentic_dev_loop-0.10.3 → agentic_dev_loop-0.10.5}/tests/test_055_templates.py

@@ -63,9 +63,9 @@ def test_dev_template_missing_heading_reports_actual_headings():
 
 def test_trigger_template_contract():
     text = load_template("trigger-agentic-dev-loop.sh")
-    assert ".engine-version" in text
     assert "doctor --fast" in text
-    assert "pipx install --force" in text
+    assert "agentic-dev-loop upgrade" in text
+    assert "pipx install --force" not in text
     assert "pipx upgrade" not in text
     assert "AGENTIC_DEV_LOOP_ENV_FILE" in text
     assert "exec agentic-dev-loop" in text

agentic_dev_loop-0.10.5/tests/test_055_upgrade.py

@@ -0,0 +1,125 @@
+"""055 follow-up: the ``upgrade`` command.
+
+``agentic-dev-loop upgrade`` installs the latest engine release with pipx and
+rewrites ``agentic-dev-loop/.engine-version`` to the installed version, so
+the host install and the committed pin converge in one action. Tests drive
+the real function with stub executables on PATH - no network, no mocks of
+the upgrade logic.
+"""
+
+import os
+from pathlib import Path
+
+import pytest
+
+from agentic_dev_loop.engine.onboarding.upgrade import run_upgrade
+
+
+def _make_stub(bin_dir: Path, name: str, body: str) -> None:
+    path = bin_dir / name
+    path.write_text(f"#!/bin/bash\n{body}\n")
+    path.chmod(0o755)
+    if not os.access(path, os.X_OK):
+        pytest.skip("tmp filesystem is mounted noexec; stub executables cannot run")
+
+
+def _env_with(bin_dir: Path | None = None) -> dict:
+    entries = ["/usr/bin", "/bin"]
+    if bin_dir is not None:
+        entries.insert(0, str(bin_dir))
+    return {**os.environ, "PATH": ":".join(entries)}
+
+
+def _stub_env(tmp_path: Path, *, pipx_body: str, cli_body: str) -> Path:
+    bin_dir = tmp_path / "bin"
+    bin_dir.mkdir()
+    _make_stub(bin_dir, "pipx", pipx_body)
+    _make_stub(bin_dir, "agentic-dev-loop", cli_body)
+    return bin_dir
+
+
+def test_upgrade_installs_latest_and_writes_pin(tmp_path, capsys):
+    pipx_log = tmp_path / "pipx.log"
+    bin_dir = _stub_env(
+        tmp_path,
+        pipx_body=f'echo "$*" >> "{pipx_log}"',
+        cli_body='echo "agentic-dev-loop 0.10.4"',
+    )
+
+    code = run_upgrade([], workspace=tmp_path, env=_env_with(bin_dir))
+
+    assert code == 0
+    assert pipx_log.read_text().strip() == "install --force agentic-dev-loop"
+    pin = tmp_path / "agentic-dev-loop" / ".engine-version"
+    assert pin.read_text(encoding="utf-8") == "0.10.4\n"
+    assert "upgraded agentic-dev-loop to 0.10.4" in capsys.readouterr().out
+
+
+def test_upgrade_overwrites_existing_pin(tmp_path):
+    out = tmp_path / "agentic-dev-loop"
+    out.mkdir()
+    (out / ".engine-version").write_text("0.10.2\n", encoding="utf-8")
+    bin_dir = _stub_env(
+        tmp_path,
+        pipx_body="exit 0",
+        cli_body='echo "agentic-dev-loop 0.10.4"',
+    )
+
+    code = run_upgrade([], workspace=tmp_path, env=_env_with(bin_dir))
+
+    assert code == 0
+    assert (out / ".engine-version").read_text(encoding="utf-8") == "0.10.4\n"
+
+
+def test_upgrade_pipx_failure_is_loud(tmp_path, capsys):
+    bin_dir = _stub_env(
+        tmp_path,
+        pipx_body="echo index-unreachable >&2; exit 1",
+        cli_body='echo "agentic-dev-loop 0.10.4"',
+    )
+
+    code = run_upgrade([], workspace=tmp_path, env=_env_with(bin_dir))
+
+    assert code == 1
+    captured = capsys.readouterr()
+    assert "index-unreachable" in captured.err
+    assert not (tmp_path / "agentic-dev-loop" / ".engine-version").exists()
+
+
+def test_upgrade_version_read_failure_is_loud(tmp_path, capsys):
+    bin_dir = _stub_env(
+        tmp_path,
+        pipx_body="exit 0",
+        cli_body="echo version-unknown >&2; exit 1",
+    )
+
+    code = run_upgrade([], workspace=tmp_path, env=_env_with(bin_dir))
+
+    assert code == 1
+    assert "could not read the installed version" in capsys.readouterr().err
+    assert not (tmp_path / "agentic-dev-loop" / ".engine-version").exists()
+
+
+def test_upgrade_unparseable_version_is_loud(tmp_path, capsys):
+    bin_dir = _stub_env(
+        tmp_path,
+        pipx_body="exit 0",
+        cli_body='echo "agentic-dev-loop nope"',
+    )
+
+    code = run_upgrade([], workspace=tmp_path, env=_env_with(bin_dir))
+
+    assert code == 1
+    assert "unreadable version" in capsys.readouterr().err
+    assert not (tmp_path / "agentic-dev-loop" / ".engine-version").exists()
+
+
+def test_upgrade_missing_pipx_is_loud(tmp_path, capsys):
+    bin_dir = tmp_path / "bin"
+    bin_dir.mkdir()
+    _make_stub(bin_dir, "agentic-dev-loop", 'echo "agentic-dev-loop 0.10.4"')
+
+    code = run_upgrade([], workspace=tmp_path, env=_env_with(bin_dir))
+
+    assert code == 1
+    assert "pipx is not on PATH" in capsys.readouterr().err

{agentic_dev_loop-0.10.3 → agentic_dev_loop-0.10.5}/tests/test_aidlc.py

@@ -135,6 +135,21 @@ class TestResolveUnitDocs:
         assert not any("nfr-design" in k for k in docs)
         assert not any("unit-2" in k for k in docs)
 
+    def test_loads_bare_slug_code_generation_plan(self, tmp_path):
+        """`{slug}-code-generation-plan.md` (no infix) is the build spec -
+        the repo's actual plan filenames, e.g. unit-3-code-generation-plan.md,
+        must load, not only infixed variants like unit-3-scan-*."""
+        unit_dir = tmp_path / "construction" / "unit-3"
+        unit_dir.mkdir(parents=True)
+        (unit_dir / "design.md").write_text("# Design")
+        plans = tmp_path / "construction" / "plans"
+        plans.mkdir(parents=True)
+        (plans / "unit-3-code-generation-plan.md").write_text("# Build spec")
+
+        docs = resolve_unit_docs(tmp_path, "unit-3")
+
+        assert docs["plans/unit-3-code-generation-plan.md"] == "# Build spec"
+
     def test_missing_plans_dir_is_not_an_error(self, tmp_path):
         unit_dir = tmp_path / "construction" / "unit-2"
         unit_dir.mkdir(parents=True)