agentic-dev-loop 0.14.5__tar.gz → 0.15.0__tar.gz

{agentic_dev_loop-0.14.5/src/agentic_dev_loop.egg-info → agentic_dev_loop-0.15.0}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: agentic-dev-loop
-Version: 0.14.5
+Version: 0.15.0
 Summary: Turn an LLM into a gated, sandboxed, resumable construction loop over your codebase.
 Author: Luke Wilson
 License-Expression: Apache-2.0
@@ -126,8 +126,13 @@ agentic-dev-loop agentic-dev-loop/pipeline.yaml            # run it
 | `--dry-run` | Full load-and-validate pass, then print the resolved plan. No LLM, no Docker, no state writes, no API key. Exit `0` on a clean load. |
 | `--resume <thread-id>` | Continue the latest checkpoint of a previous run (crash, Ctrl-C, exhaustion) with all accumulated notes intact. |
 | `--max-attempts <n>` | Override the pipeline's `max_attempts`. |
+| `--env <file>` | Load secrets from a host env file outside the workspace. Optional: the process environment is the default, a named-but-missing file is a loud error, and values already set in the environment win. |
 | `--no-viz` / `--viz-port <port>` | Suppress the live graph view / set a preferred port (default 8321; falls back to a free port when busy). |
 
+`PIPELINE` is optional and defaults to `agentic-dev-loop/pipeline.yaml`
+(relative to the current directory). Run flags without a positional use that
+default; a missing default fails loudly instead of falling back.
+
 Exit code is `0` on pipeline success, `1` otherwise.
 
 Other commands:
@@ -136,18 +141,19 @@ Other commands:
   mermaid flowchart with the current step highlighted, reading the run-state
   checkpoint database directly. `run-status --install` installs the bundled
   `/run-status` command into OpenCode.
-- `agentic-dev-loop report [<run-id>]` renders accumulated run history as
-  ASCII markdown: an aggregate dashboard by default (loop health, TDD,
+- `agentic-dev-loop report` serves the **historical runs view** in the
+  browser (default port 8321, falling back to a free port when busy; blocks
+  until ctrl+c and prints the URL). It reads the same run records as the
+  markdown report and lists past runs with since / until / status filters,
+  an aggregate metrics panel, and a per-run detail page carrying the brief,
+  implementation summary, review findings, and QA report. The live viz also
+  links to it from the **History** button in the graph page header (or
+  `/runs`).
+- `agentic-dev-loop report --markdown [<run-id>]` renders the same history
+  as ASCII markdown instead: an aggregate dashboard (loop health, TDD,
   review, and QA metrics with provenance labels) or a deep dive for one
   12-hex run directory. `--since` / `--until` / `--status` filter the set.
-  Reporting is strictly read-only.
-- The live viz also serves a **historical runs view**: click **History** in
-  the graph page header (or open `/runs`), or launch it standalone with
-  `python -m agentic_dev_loop.viz --history`, which needs no pipeline file
-  (default port 8321, falling back to a free port when busy). It lists past
-  runs with since / until / status filters, an aggregate metrics panel, and
-  a per-run detail page carrying the brief, implementation summary, review
-  findings, and QA report.
+  `--markdown` cannot be combined with `--port`.
 - `agentic-dev-loop containers` inspects the engine's sandbox containers and
   networks from the host; `containers --reap` removes registry-owned orphans
   whose owner process is dead. A SIGTERM to a running pipeline still closes
@@ -489,20 +495,20 @@ agentic-dev-loop init --profile python        # or: --profile dotnet-node
 ```
 
 `init` writes the onboarding surface from a bundled toolchain profile:
-`agentic-dev-loop/pipeline.yaml`, the three agent files, an executable
-`trigger-agentic-dev-loop.sh`, `agentic-dev-loop/.engine-version` (the exact
-installed engine version), any missing premise files, gitignore additions,
-and an env-file template. It detects solution files, `package.json`
-directories, lockfiles, README, and AGENTS.md, asks only what detection
-cannot answer, and refuses to overwrite an existing `agentic-dev-loop/`
-directory. A consumer-authored profile file can be passed by path instead of
-a bundled name.
-
-`agentic-dev-loop doctor --fast` is the per-run gate the trigger runs first:
-hard failures abort the run (engine pin mismatch, engine runtime
+`agentic-dev-loop/pipeline.yaml`, the three agent files,
+`agentic-dev-loop/.engine-version` (the exact installed engine version), any
+missing premise files, gitignore additions, and an env-file template. It
+detects solution files, `package.json` directories, lockfiles, README, and
+AGENTS.md, asks only what detection cannot answer, and refuses to overwrite
+an existing `agentic-dev-loop/` directory. A consumer-authored profile file
+can be passed by path instead of a bundled name.
+
+`agentic-dev-loop doctor --fast` probes the host and repo before you run:
+hard failures stop you here (engine pin mismatch, engine runtime
 availability, API version, git repo, `.env*` files); warnings print and
-continue. On a hard failure the trigger runs `agentic-dev-loop upgrade`
-exactly once, then the run fails hard if doctor still fails.
+continue. `agentic-dev-loop upgrade` installs the latest engine release and
+rewrites the pin, so the host install and the committed pin converge in one
+explicit action. Run both yourself; the CLI never runs them for you.
 
 A consumer repo needs a pipeline file and the agent files it names, both
 committed before the first run. `init` writes them; the layout is:
@@ -615,7 +621,7 @@ export OPENAI_API_KEY=...                     # set your LLM key in the host env
 python -m pytest tests/ -q                    # fast suite (in-repo .venv is for tests only)
 python -m pytest tests/ -q -m "not docker"    # skip engine-dependent tests
 agentic-dev-loop agentic-dev-loop/pipeline.yaml --dry-run   # run the shipped pipeline
-./run-demo.sh                                 # viz demo - scripted run replay, no pipeline needed
+.venv-sandbox/bin/python tests/smoke/viz_demo.py  # viz demo - scripted replay, no pipeline needed
 ```
 
 - `setup-venv.sh` builds the throwaway `.venv` for local `pytest` runs. The

{agentic_dev_loop-0.14.5 → agentic_dev_loop-0.15.0}/README.md

@@ -81,8 +81,13 @@ agentic-dev-loop agentic-dev-loop/pipeline.yaml            # run it
 | `--dry-run` | Full load-and-validate pass, then print the resolved plan. No LLM, no Docker, no state writes, no API key. Exit `0` on a clean load. |
 | `--resume <thread-id>` | Continue the latest checkpoint of a previous run (crash, Ctrl-C, exhaustion) with all accumulated notes intact. |
 | `--max-attempts <n>` | Override the pipeline's `max_attempts`. |
+| `--env <file>` | Load secrets from a host env file outside the workspace. Optional: the process environment is the default, a named-but-missing file is a loud error, and values already set in the environment win. |
 | `--no-viz` / `--viz-port <port>` | Suppress the live graph view / set a preferred port (default 8321; falls back to a free port when busy). |
 
+`PIPELINE` is optional and defaults to `agentic-dev-loop/pipeline.yaml`
+(relative to the current directory). Run flags without a positional use that
+default; a missing default fails loudly instead of falling back.
+
 Exit code is `0` on pipeline success, `1` otherwise.
 
 Other commands:
@@ -91,18 +96,19 @@ Other commands:
   mermaid flowchart with the current step highlighted, reading the run-state
   checkpoint database directly. `run-status --install` installs the bundled
   `/run-status` command into OpenCode.
-- `agentic-dev-loop report [<run-id>]` renders accumulated run history as
-  ASCII markdown: an aggregate dashboard by default (loop health, TDD,
+- `agentic-dev-loop report` serves the **historical runs view** in the
+  browser (default port 8321, falling back to a free port when busy; blocks
+  until ctrl+c and prints the URL). It reads the same run records as the
+  markdown report and lists past runs with since / until / status filters,
+  an aggregate metrics panel, and a per-run detail page carrying the brief,
+  implementation summary, review findings, and QA report. The live viz also
+  links to it from the **History** button in the graph page header (or
+  `/runs`).
+- `agentic-dev-loop report --markdown [<run-id>]` renders the same history
+  as ASCII markdown instead: an aggregate dashboard (loop health, TDD,
   review, and QA metrics with provenance labels) or a deep dive for one
   12-hex run directory. `--since` / `--until` / `--status` filter the set.
-  Reporting is strictly read-only.
-- The live viz also serves a **historical runs view**: click **History** in
-  the graph page header (or open `/runs`), or launch it standalone with
-  `python -m agentic_dev_loop.viz --history`, which needs no pipeline file
-  (default port 8321, falling back to a free port when busy). It lists past
-  runs with since / until / status filters, an aggregate metrics panel, and
-  a per-run detail page carrying the brief, implementation summary, review
-  findings, and QA report.
+  `--markdown` cannot be combined with `--port`.
 - `agentic-dev-loop containers` inspects the engine's sandbox containers and
   networks from the host; `containers --reap` removes registry-owned orphans
   whose owner process is dead. A SIGTERM to a running pipeline still closes
@@ -444,20 +450,20 @@ agentic-dev-loop init --profile python        # or: --profile dotnet-node
 ```
 
 `init` writes the onboarding surface from a bundled toolchain profile:
-`agentic-dev-loop/pipeline.yaml`, the three agent files, an executable
-`trigger-agentic-dev-loop.sh`, `agentic-dev-loop/.engine-version` (the exact
-installed engine version), any missing premise files, gitignore additions,
-and an env-file template. It detects solution files, `package.json`
-directories, lockfiles, README, and AGENTS.md, asks only what detection
-cannot answer, and refuses to overwrite an existing `agentic-dev-loop/`
-directory. A consumer-authored profile file can be passed by path instead of
-a bundled name.
-
-`agentic-dev-loop doctor --fast` is the per-run gate the trigger runs first:
-hard failures abort the run (engine pin mismatch, engine runtime
+`agentic-dev-loop/pipeline.yaml`, the three agent files,
+`agentic-dev-loop/.engine-version` (the exact installed engine version), any
+missing premise files, gitignore additions, and an env-file template. It
+detects solution files, `package.json` directories, lockfiles, README, and
+AGENTS.md, asks only what detection cannot answer, and refuses to overwrite
+an existing `agentic-dev-loop/` directory. A consumer-authored profile file
+can be passed by path instead of a bundled name.
+
+`agentic-dev-loop doctor --fast` probes the host and repo before you run:
+hard failures stop you here (engine pin mismatch, engine runtime
 availability, API version, git repo, `.env*` files); warnings print and
-continue. On a hard failure the trigger runs `agentic-dev-loop upgrade`
-exactly once, then the run fails hard if doctor still fails.
+continue. `agentic-dev-loop upgrade` installs the latest engine release and
+rewrites the pin, so the host install and the committed pin converge in one
+explicit action. Run both yourself; the CLI never runs them for you.
 
 A consumer repo needs a pipeline file and the agent files it names, both
 committed before the first run. `init` writes them; the layout is:
@@ -570,7 +576,7 @@ export OPENAI_API_KEY=...                     # set your LLM key in the host env
 python -m pytest tests/ -q                    # fast suite (in-repo .venv is for tests only)
 python -m pytest tests/ -q -m "not docker"    # skip engine-dependent tests
 agentic-dev-loop agentic-dev-loop/pipeline.yaml --dry-run   # run the shipped pipeline
-./run-demo.sh                                 # viz demo - scripted run replay, no pipeline needed
+.venv-sandbox/bin/python tests/smoke/viz_demo.py  # viz demo - scripted replay, no pipeline needed
 ```
 
 - `setup-venv.sh` builds the throwaway `.venv` for local `pytest` runs. The

{agentic_dev_loop-0.14.5 → agentic_dev_loop-0.15.0}/pyproject.toml

@@ -4,7 +4,7 @@ build-backend = "setuptools.build_meta"
 
 [project]
 name = "agentic-dev-loop"
-version = "0.14.5"
+version = "0.15.0"
 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.14.5 → agentic_dev_loop-0.15.0}/src/agentic_dev_loop/engine/cli.py

@@ -22,6 +22,31 @@ from .loaders import mark_plan_completed
 from .registry import Registry, default_registry, load_extensions
 
 
+_DEFAULT_PIPELINE = Path("agentic-dev-loop") / "pipeline.yaml"
+
+_TOP_HELP = """\
+usage: agentic-dev-loop [PIPELINE] [--resume THREAD_ID] [--max-attempts N]
+                        [--no-viz] [--viz-port PORT] [--dry-run] [--version]
+
+Run an OpenHands agent pipeline defined in YAML. PIPELINE defaults to
+agentic-dev-loop/pipeline.yaml; run `agentic-dev-loop <PIPELINE> --help`
+for loader-contributed options (e.g. --plan, --aidlc-unit).
+
+commands:
+  containers       Inspect engine sandbox containers and networks.
+  copilot-login    Run the GitHub device flow and store the Copilot OAuth token.
+  copilot-models   List the Copilot models available to this token's tier.
+  report           Serve the run-history browser view (--markdown for text).
+  run-status       Report the latest agentic-dev-loop run.
+  init             Write agentic-dev-loop pipeline and agent files.
+  doctor           Probe this host and repo for onboarding prerequisites.
+  upgrade          Install the latest engine release and rewrite the project pin.
+  help             Show this list.
+
+Run `agentic-dev-loop <command> --help` for per-command options.
+"""
+
+
 _sigterm_in_progress = False
 
 
@@ -79,8 +104,9 @@ def _core_parser() -> argparse.ArgumentParser:
                     "Document-loader flags contributed by the pipeline's "
                     "extensions appear once PIPELINE is known - see "
                     "`agentic-dev-loop PIPELINE --help`.")
-    parser.add_argument("pipeline", type=Path,
-                        help="path to the pipeline YAML")
+    parser.add_argument("pipeline", type=Path, nargs="?", default=None,
+                        help="path to the pipeline YAML (default: "
+                             "agentic-dev-loop/pipeline.yaml)")
     parser.add_argument("--resume", metavar="THREAD_ID", default=None,
                         help="resume a checkpointed run by thread id")
     parser.add_argument("--max-attempts", type=int, default=None,
@@ -96,6 +122,9 @@ def _core_parser() -> argparse.ArgumentParser:
                         help="validate the pipeline and print a summary plan "
                              "without executing anything (no LLM, no "
                              "sandbox, no state writes)")
+    parser.add_argument("--env", metavar="FILE", default=None,
+                        help="load secrets from a host env file outside the "
+                             "workspace (default: the process environment)")
     _add_version_flag(parser)
     return parser
 
@@ -164,15 +193,19 @@ def _token_path(value: str | None) -> Path:
     return Path(value).expanduser() if value else TOKEN_PATH.expanduser()
 
 
-def _run_copilot_login(argv: list[str]) -> int:
+def _copilot_login_parser() -> argparse.ArgumentParser:
     parser = argparse.ArgumentParser(
         prog="agentic-dev-loop copilot-login",
         description="Run the GitHub device flow and store the Copilot OAuth "
-                    "token (~/.agentic-dev-loop/auth/copilot.json, mode 600).")
+                    "token.")
     parser.add_argument("--token-file", default=None,
                         help="token path (default: "
                              "~/.agentic-dev-loop/auth/copilot.json)")
-    args = parser.parse_args(argv)
+    return parser
+
+
+def _run_copilot_login(argv: list[str]) -> int:
+    args = _copilot_login_parser().parse_args(argv)
     path = _token_path(args.token_file)
     try:
         login(token_path=path)
@@ -183,7 +216,7 @@ def _run_copilot_login(argv: list[str]) -> int:
     return 0
 
 
-def _run_copilot_models(argv: list[str]) -> int:
+def _copilot_models_parser() -> argparse.ArgumentParser:
     parser = argparse.ArgumentParser(
         prog="agentic-dev-loop copilot-models",
         description="List the Copilot models available to this token's tier.")
@@ -192,7 +225,11 @@ def _run_copilot_models(argv: list[str]) -> int:
                              "~/.agentic-dev-loop/auth/copilot.json)")
     parser.add_argument("--json", action="store_true",
                         help="emit the model list as JSON")
-    args = parser.parse_args(argv)
+    return parser
+
+
+def _run_copilot_models(argv: list[str]) -> int:
+    args = _copilot_models_parser().parse_args(argv)
     try:
         models = list_copilot_models(read_token(_token_path(args.token_file)))
     except CopilotAuthError as e:
@@ -209,11 +246,16 @@ def _run_copilot_models(argv: list[str]) -> int:
 def _report_parser() -> argparse.ArgumentParser:
     parser = argparse.ArgumentParser(
         prog="agentic-dev-loop report",
-        description="Report accumulated agentic-dev-loop run history as "
-                    "read-only markdown.")
+        description="Serve the run-history browser view (--markdown for text).")
     parser.add_argument("run_id", nargs="?", default=None,
                         help="12-hex run dir name for a deep dive "
-                             "(default: aggregate report)")
+                             "(markdown mode only)")
+    parser.add_argument("--markdown", action="store_true",
+                        help="render read-only markdown instead of serving "
+                             "the browser view")
+    parser.add_argument("--port", type=int, default=None,
+                        help="server port (default: 8321; falls back to a "
+                             "free port when busy)")
     parser.add_argument("--since", default=None,
                         help="only threads starting at or after this ISO "
                              "datetime")
@@ -234,11 +276,28 @@ def _report_parser() -> argparse.ArgumentParser:
 
 
 def _run_report(argv: list[str]) -> int:
+    args = _report_parser().parse_args(argv)
+    if args.markdown:
+        if args.port is not None:
+            print("report: --markdown and --port are mutually exclusive",
+                  file=sys.stderr)
+            return 2
+        return _render_report(args)
+    markdown_only = [flag for flag, value in (
+        ("run_id", args.run_id), ("--since", args.since),
+        ("--until", args.until), ("--status", args.status)) if value]
+    if markdown_only:
+        print(f"report: {markdown_only[0]} requires --markdown",
+              file=sys.stderr)
+        return 2
+    return _serve_report(args)
+
+
+def _render_report(args) -> int:
     from agentic_dev_loop.reporting import (
         apply_filters, build_run_records, discover, find_run_dir,
         pure_metrics, read_audit, read_dir, render_markdown, runs_root)
 
-    args = _report_parser().parse_args(argv)
     root = runs_root(args.runs_root)
     notice = None
     if args.run_id is not None:
@@ -271,6 +330,78 @@ def _run_report(argv: list[str]) -> int:
     return 0
 
 
+def _serve_report(args) -> int:
+    from agentic_dev_loop.viz import serve_history
+
+    port = 8321 if args.port is None else args.port
+    try:
+        httpd, _thread = serve_history(port, runs_root=args.runs_root,
+                                       audit_dir=args.audit_dir)
+    except OSError as exc:
+        print(f"report: {exc}", file=sys.stderr)
+        return 1
+    bound = httpd.server_address[1]
+    url = f"http://127.0.0.1:{bound}"
+    print(f"Run history viz: {url}", flush=True)
+    if port and bound != port:
+        print(f"report port {port} busy - serving on {url}", flush=True)
+    try:
+        _wait_for_interrupt()
+    except KeyboardInterrupt:
+        pass
+    finally:
+        httpd.shutdown()
+    return 0
+
+
+def _probe_parser() -> argparse.ArgumentParser:
+    """Phase-1 parser: find PIPELINE (or the default) without loading any
+    extension or SDK module."""
+    probe = argparse.ArgumentParser(add_help=False)
+    probe.add_argument("pipeline", type=Path, nargs="?")
+    probe.add_argument("--resume", default=None)
+    probe.add_argument("--max-attempts", default=None)
+    probe.add_argument("--viz-port", default=None)
+    probe.add_argument("--env", default=None)
+    probe.add_argument("--no-viz", action="store_true")
+    probe.add_argument("--dry-run", action="store_true")
+    _add_version_flag(probe)
+    return probe
+
+
+def _load_env_file(path: Path) -> str | None:
+    """Load KEY=VALUE lines from a host file into the process environment.
+
+    The file must live outside the workspace (doctor refuses workspace
+    ``.env*`` files; the run path uses the same boundary). Values already set
+    in the environment win, so a file never overrides the operator's shell.
+    Returns an error message, or ``None`` on success.
+    """
+    target = path.expanduser().resolve()
+    workspace = Path.cwd().resolve()
+    if target == workspace or target.is_relative_to(workspace):
+        return (f"--env file {target} is inside the workspace {workspace}; "
+                "secret files must live outside the workspace")
+    if not target.is_file():
+        return f"--env file not found: {target}"
+    for raw in target.read_text(encoding="utf-8").splitlines():
+        line = raw.strip()
+        if not line or line.startswith("#"):
+            continue
+        if line.startswith("export "):
+            line = line[len("export "):].strip()
+        key, sep, value = line.partition("=")
+        key = key.strip()
+        if not sep or not key:
+            continue
+        value = value.strip()
+        if len(value) >= 2 and value[0] == value[-1] and value[0] in "'\"":
+            value = value[1:-1]
+        if key not in os.environ:
+            os.environ[key] = value
+    return None
+
+
 def build_parser(cfg_path) -> argparse.ArgumentParser:
     """The full parser for one pipeline: core flags + loader-contributed."""
     registry, _ = _registry_for(cfg_path)
@@ -285,6 +416,12 @@ def main(argv: list[str] | None = None, *, keep_alive: bool = True) -> int:
         argv = sys.argv[1:]
     else:
         argv = list(argv)
+    if argv and argv[0] == "help":
+        if len(argv) > 1:
+            print("error: help takes no arguments", file=sys.stderr)
+            return 2
+        print(_TOP_HELP)
+        return 0
     if argv and argv[0] == "containers":
         return _run_containers(argv[1:])
     if argv and argv[0] == "copilot-login":
@@ -305,20 +442,32 @@ def main(argv: list[str] | None = None, *, keep_alive: bool = True) -> int:
     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)
-    known, _ = probe.parse_known_args(argv)
+    if not argv:
+        print(_TOP_HELP)
+        return 0
+    known, _ = _probe_parser().parse_known_args(argv)
     if known.pipeline is None:
-        # No pipeline → the extension surface is unknowable; the core parser
-        # handles --help and the missing-positional error itself (both exit).
-        _core_parser().parse_args(argv)
-        return 2  # unreachable - parse_args exits first
-    registry, cfg = _registry_for(known.pipeline)
+        if "-h" in argv or "--help" in argv:
+            print(_TOP_HELP)
+            return 0
+        if not _DEFAULT_PIPELINE.is_file():
+            print(f"agentic-dev-loop: no pipeline at {_DEFAULT_PIPELINE} "
+                  "and none given", file=sys.stderr)
+            return 1
+        pipeline = _DEFAULT_PIPELINE
+    else:
+        pipeline = known.pipeline
+    if known.env is not None:
+        error = _load_env_file(Path(known.env))
+        if error is not None:
+            print(f"agentic-dev-loop: {error}", file=sys.stderr)
+            return 1
+    registry, cfg = _registry_for(pipeline)
     parser = _core_parser()
     for loader in registry.document_loaders:
         loader.add_cli_args(parser)
     args = parser.parse_args(argv)
+    args.pipeline = pipeline
     if args.dry_run:
         from .dryrun import dry_run
         return dry_run(args.pipeline, args, registry)

{agentic_dev_loop-0.14.5 → agentic_dev_loop-0.15.0}/src/agentic_dev_loop/engine/hostboundary.py

@@ -32,8 +32,7 @@ if TYPE_CHECKING:
 # the dogfood pipeline and the consumer repo use); the other tooling paths are config- or
 # pipeline-file-relative.
 TOOLING_DIR_NAMES = ("aidlc-docs", "tools")
-TOOLING_FILE_NAMES = ("trigger-agentic-dev-loop.sh",
-                      "agentic-dev-loop/.engine-version")
+TOOLING_FILE_NAMES = ("agentic-dev-loop/.engine-version",)
 
 
 class HostBoundaryError(RuntimeError):

{agentic_dev_loop-0.14.5 → agentic_dev_loop-0.15.0}/src/agentic_dev_loop/engine/onboarding/doctor.py

@@ -38,9 +38,7 @@ def _print_failures(checks: list[Check]) -> None:
                 print(f"  fix: {check.fix_text}")
 
 
-def run_doctor(argv: list[str], *, workspace: Path | None = None,
-               probes: HostProbes | None = None,
-               installed: str | None = None) -> int:
+def _doctor_parser() -> argparse.ArgumentParser:
     parser = argparse.ArgumentParser(
         prog="agentic-dev-loop doctor",
         description="Probe this host and repo for onboarding prerequisites.")
@@ -49,7 +47,13 @@ def run_doctor(argv: list[str], *, workspace: Path | None = None,
                              "round trip")
     parser.add_argument("--json", action="store_true",
                         help="emit machine-readable JSON results")
-    args = parser.parse_args(argv)
+    return parser
+
+
+def run_doctor(argv: list[str], *, workspace: Path | None = None,
+               probes: HostProbes | None = None,
+               installed: str | None = None) -> int:
+    args = _doctor_parser().parse_args(argv)
 
     root = Path(workspace or Path.cwd()).resolve()
     probes = probes or HostProbes()

{agentic_dev_loop-0.14.5 → agentic_dev_loop-0.15.0}/src/agentic_dev_loop/engine/onboarding/init.py

@@ -308,11 +308,6 @@ def _write(root: Path, profile: Profile, pipeline: dict, texts: dict,
         (agents / f"{name}.agent.md").write_text(
             load_template(f"{name}.agent.md"), encoding="utf-8")
 
-    trigger = root / "trigger-agentic-dev-loop.sh"
-    trigger.write_text(load_template("trigger-agentic-dev-loop.sh"),
-                       encoding="utf-8")
-    trigger.chmod(0o755)
-
     (out / ".engine-version").write_text(installed + "\n", encoding="utf-8")
 
     for premise in profile.premise_files:
@@ -368,11 +363,10 @@ def _answers(root: Path, profile_ref: str, yes: bool) -> dict:
     }
 
 
-def run_init(argv: list[str]) -> int:
+def _init_parser() -> argparse.ArgumentParser:
     parser = argparse.ArgumentParser(
         prog="agentic-dev-loop init",
-        description="Write agentic-dev-loop pipeline, agent, and trigger "
-                    "files for this repo.")
+        description="Write agentic-dev-loop pipeline and agent files.")
     parser.add_argument("--profile", default="python",
                         help="bundled profile name or path (default: python)")
     parser.add_argument("--recipe", default=None,
@@ -382,7 +376,11 @@ def run_init(argv: list[str]) -> int:
                         help="accept defaults without prompting")
     parser.add_argument("--dir", default=".",
                         help="repo root to write into (default: .)")
-    args = parser.parse_args(argv)
+    return parser
+
+
+def run_init(argv: list[str]) -> int:
+    args = _init_parser().parse_args(argv)
     root = Path(args.dir).resolve()
     try:
         pipeline_path = root / "agentic-dev-loop" / "pipeline.yaml"
@@ -423,10 +421,10 @@ def _print_next_steps(pipeline_path: Path) -> None:
         Wrote {pipeline_path}
         Next steps:
           1. Export the LLM key named by api_key_env in the host environment
-             (or set AGENTIC_DEV_LOOP_ENV_FILE to a host env file).
+             (or pass --env FILE, a host env file outside the workspace).
           2. Review agentic-dev-loop/pipeline.yaml and the agent files under
              agentic-dev-loop/sdk_agents/.
           3. Validate: agentic-dev-loop agentic-dev-loop/pipeline.yaml --dry-run
-          4. Run: ./trigger-agentic-dev-loop.sh --plan <path> (or --aidlc-unit,
-             or --resume).
+          4. Run: agentic-dev-loop agentic-dev-loop/pipeline.yaml --plan <path>
+             (or --aidlc-unit, or --resume).
         """))

agentic_dev_loop-0.15.0/src/agentic_dev_loop/engine/onboarding/templates/env.example

@@ -0,0 +1,13 @@
+# Host environment file for agentic-dev-loop.
+#
+# Copy it outside the workspace (for example to
+# ~/.config/<repo-name>/agentic-dev-loop.env) and fill in values there.
+# Pass it to a run with --env FILE. Never commit a filled copy: the engine
+# refuses a run when the workspace contains a .env* file, and this template
+# carries no secret values. Values already set in the process environment
+# win over the file.
+#
+# OPENAI_API_KEY=...
+#
+# Optional: override the toolchain image for a local build.
+# AGENTIC_DEV_LOOP_DEV_IMAGE=...

{agentic_dev_loop-0.14.5 → agentic_dev_loop-0.15.0}/src/agentic_dev_loop/engine/onboarding/templates.py

@@ -1,4 +1,4 @@
-"""Onboarding templates: agent prompts, the trigger script, env template."""
+"""Onboarding templates: agent prompts and the env template."""
 
 from __future__ import annotations
 

{agentic_dev_loop-0.14.5 → agentic_dev_loop-0.15.0}/src/agentic_dev_loop/engine/onboarding/upgrade.py

@@ -24,13 +24,17 @@ def _resolve(name: str, env: dict | None) -> str | None:
     return shutil.which(name)
 
 
-def run_upgrade(argv: list[str], *, workspace: Path | None = None,
-                env: dict | None = None) -> int:
+def _upgrade_parser() -> argparse.ArgumentParser:
     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)
+                    "project pin.")
+    return parser
+
+
+def run_upgrade(argv: list[str], *, workspace: Path | None = None,
+                env: dict | None = None) -> int:
+    _upgrade_parser().parse_args(argv)
 
     root = Path(workspace or Path.cwd()).resolve()
     pipx = _resolve("pipx", env)

{agentic_dev_loop-0.14.5 → agentic_dev_loop-0.15.0}/src/agentic_dev_loop/engine/run_status.py

@@ -311,7 +311,7 @@ def install_command(dest_dir: Path | None = None) -> Path:
     return target
 
 
-def _run_status(argv: list[str]) -> int:
+def _run_status_parser() -> argparse.ArgumentParser:
     parser = argparse.ArgumentParser(
         prog="agentic-dev-loop run-status",
         description="Report the latest agentic-dev-loop run.",
@@ -330,7 +330,11 @@ def _run_status(argv: list[str]) -> int:
         help="install the /run-status OpenCode command into the consumer "
         "commands directory and exit",
     )
-    args = parser.parse_args(argv)
+    return parser
+
+
+def _run_status(argv: list[str]) -> int:
+    args = _run_status_parser().parse_args(argv)
 
     if args.install:
         target = install_command()