simplicio-cli 0.9.6__tar.gz → 0.10.0__tar.gz

{simplicio_cli-0.9.6 → simplicio_cli-0.10.0}/PKG-INFO

@@ -1,13 +1,13 @@
 Metadata-Version: 2.4
 Name: simplicio-cli
-Version: 0.9.6
+Version: 0.10.0
 Summary: Portable task-to-code pipeline that works with any LLM. Turn a one-line task into a verified code change — diff + test + verify loop. +55 pts on a 156-check benchmark, 21% faster, ~same tokens.
 Author-email: Wesley Simplicio <wesleybob4@gmail.com>
 License: MIT
-Project-URL: Homepage, https://github.com/wesleysimplicio/simplicio-cli
-Project-URL: Repository, https://github.com/wesleysimplicio/simplicio-cli
-Project-URL: Issues, https://github.com/wesleysimplicio/simplicio-cli/issues
-Project-URL: Changelog, https://github.com/wesleysimplicio/simplicio-cli/releases
+Project-URL: Homepage, https://github.com/wesleysimplicio/simplicio-dev-cli
+Project-URL: Repository, https://github.com/wesleysimplicio/simplicio-dev-cli
+Project-URL: Issues, https://github.com/wesleysimplicio/simplicio-dev-cli/issues
+Project-URL: Changelog, https://github.com/wesleysimplicio/simplicio-dev-cli/releases
 Keywords: llm,ai,agent,code-generation,prompt-engineering,openrouter,openai,anthropic,claude,developer-tools,cli,rag,embeddings,verify-loop,task-automation
 Classifier: Development Status :: 4 - Beta
 Classifier: Environment :: Console
@@ -19,6 +19,7 @@ Classifier: Programming Language :: Python :: 3 :: Only
 Classifier: Programming Language :: Python :: 3.10
 Classifier: Programming Language :: Python :: 3.11
 Classifier: Programming Language :: Python :: 3.12
+Classifier: Programming Language :: Python :: 3.13
 Classifier: Topic :: Software Development
 Classifier: Topic :: Software Development :: Code Generators
 Classifier: Topic :: Software Development :: Libraries :: Python Modules
@@ -27,7 +28,7 @@ Requires-Python: >=3.10
 Description-Content-Type: text/markdown
 License-File: LICENSE
 Requires-Dist: numpy>=2.1.0
-Requires-Dist: simplicio-mapper>=0.17.0
+Requires-Dist: simplicio-mapper>=0.18.0
 Requires-Dist: simplicio-prompt>=1.14.1
 Requires-Dist: httpx>=0.28.1
 Requires-Dist: orjson>=3.11.9
@@ -99,6 +100,10 @@ simplicio-py detect "hide the Delete button for non-admins"
 simplicio-py task "hide the Delete button for non-admins"
 ```
 
+Auto-upgrade is now opt-in: set `SIMPLICIO_AUTO_UPGRADE=1` for session-start upgrades, or run `simplicio-py doctor --upgrade` explicitly.
+Python consumers can expose the bundled mapper dependency directly with
+`from simplicio import mapper_module, mapper_version` or `import simplicio.mapper_api`.
+
 ## What it does
 
 - Classifies the task before execution so small fixes stay small and sprint-scale work becomes a plan.
@@ -472,12 +477,7 @@ recorded to a separate append-only ledger,
 `.simplicio/ledger/savings-events.jsonl` (`simplicio.savings-event/v1`), via
 `simplicio.observability.record_savings_event()`.
 
-#### MCP server and cross-vendor memory
-
-`simplicio-dev-cli serve --mcp` runs this CLI as an MCP stdio server
-(stdlib-only JSON-RPC 2.0, no extra dependency), exposing `dev_cli_edit`,
-`dev_cli_validate`, and `dev_cli_memory` as tools any MCP client (Claude
-Code, Codex, Cursor, VS Code) can call directly.
+#### Cross-vendor memory
 
 `simplicio-dev-cli memory init|store|recall` is a markdown + git store under
 `~/.simplicio/memory/` (override with `SIMPLICIO_MEMORY_DIR`) for handing

{simplicio_cli-0.9.6 → simplicio_cli-0.10.0}/README.md

@@ -34,11 +34,15 @@ The new first screen is the doorway; the restored guide below is the workshop. T
 
 ## Quick Start
 
-```bash
-pip install -U simplicio-cli
-simplicio-py detect "hide the Delete button for non-admins"
-simplicio-py task "hide the Delete button for non-admins"
-```
+```bash
+pip install -U simplicio-cli
+simplicio-py detect "hide the Delete button for non-admins"
+simplicio-py task "hide the Delete button for non-admins"
+```
+
+Auto-upgrade is now opt-in: set `SIMPLICIO_AUTO_UPGRADE=1` for session-start upgrades, or run `simplicio-py doctor --upgrade` explicitly.
+Python consumers can expose the bundled mapper dependency directly with
+`from simplicio import mapper_module, mapper_version` or `import simplicio.mapper_api`.
 
 ## What it does
 
@@ -413,12 +417,7 @@ recorded to a separate append-only ledger,
 `.simplicio/ledger/savings-events.jsonl` (`simplicio.savings-event/v1`), via
 `simplicio.observability.record_savings_event()`.
 
-#### MCP server and cross-vendor memory
-
-`simplicio-dev-cli serve --mcp` runs this CLI as an MCP stdio server
-(stdlib-only JSON-RPC 2.0, no extra dependency), exposing `dev_cli_edit`,
-`dev_cli_validate`, and `dev_cli_memory` as tools any MCP client (Claude
-Code, Codex, Cursor, VS Code) can call directly.
+#### Cross-vendor memory
 
 `simplicio-dev-cli memory init|store|recall` is a markdown + git store under
 `~/.simplicio/memory/` (override with `SIMPLICIO_MEMORY_DIR`) for handing

{simplicio_cli-0.9.6 → simplicio_cli-0.10.0}/pyproject.toml

@@ -1,6 +1,6 @@
 [project]
 name = "simplicio-cli"
-version = "0.9.6"
+version = "0.10.0"
 description = "Portable task-to-code pipeline that works with any LLM. Turn a one-line task into a verified code change — diff + test + verify loop. +55 pts on a 156-check benchmark, 21% faster, ~same tokens."
 readme = "README.md"
 license = { text = "MIT" }
@@ -33,7 +33,8 @@ classifiers = [
   "Programming Language :: Python :: 3 :: Only",
   "Programming Language :: Python :: 3.10",
   "Programming Language :: Python :: 3.11",
-  "Programming Language :: Python :: 3.12",
+  "Programming Language :: Python :: 3.12",
+  "Programming Language :: Python :: 3.13",
   "Topic :: Software Development",
   "Topic :: Software Development :: Code Generators",
   "Topic :: Software Development :: Libraries :: Python Modules",
@@ -52,7 +53,7 @@ classifiers = [
 # (generated, `--check`-able) for the full graph and #99 for the audit.
 dependencies = [
   "numpy>=2.1.0",
-  "simplicio-mapper>=0.17.0",
+  "simplicio-mapper>=0.18.0",
   "simplicio-prompt>=1.14.1",
   "httpx>=0.28.1",
   "orjson>=3.11.9",
@@ -88,10 +89,10 @@ test = ["pytest>=8", "tomli>=2.0.1; python_version < '3.11'"]
 dev = ["simplicio-cli[test]", "ruff>=0.15.8", "mypy>=1.19.1"]
 
 [project.urls]
-Homepage = "https://github.com/wesleysimplicio/simplicio-cli"
-Repository = "https://github.com/wesleysimplicio/simplicio-cli"
-Issues = "https://github.com/wesleysimplicio/simplicio-cli/issues"
-Changelog = "https://github.com/wesleysimplicio/simplicio-cli/releases"
+Homepage = "https://github.com/wesleysimplicio/simplicio-dev-cli"
+Repository = "https://github.com/wesleysimplicio/simplicio-dev-cli"
+Issues = "https://github.com/wesleysimplicio/simplicio-dev-cli/issues"
+Changelog = "https://github.com/wesleysimplicio/simplicio-dev-cli/releases"
 
 [project.scripts]
 simplicio-cli = "simplicio.cli:main"
@@ -145,7 +146,7 @@ extend-exclude = [
 [tool.ruff.lint]
 # E/F = pyflakes+pycodestyle core, I = isort, UP = pyupgrade, B = bugbear,
 # T20 = flake8-print (issue #106 — blocks new print() regressions in
-# library/MCP-adjacent code; see per-file-ignores below for the documented
+# library code; see per-file-ignores below for the documented
 # CLI-handler exception, where stdout IS the subcommand's intended output).
 select = ["E", "F", "I", "UP", "B", "T20"]
 # B008: PLAN_JSON-style default args show up in a few argparse builders;
@@ -157,8 +158,8 @@ ignore = []
 "tests/**/*.py" = ["E501", "T201"]
 # CLI-handler exception (#106): stdout IS the intended output of these
 # subcommand entry points (JSON payloads, tables, human summaries), so
-# print() is the correct tool here — never in mcp_server.py, providers.py,
-# pipeline.py, mapper.py, or any other library/MCP-adjacent module, which
+# print() is the correct tool here — never in providers.py, pipeline.py,
+# mapper.py, or any other library module, which
 # stay covered by the bare T201 rule above with zero suppressions.
 "simplicio/cli.py" = ["T201"]
 "simplicio/doctor.py" = ["T201"]
@@ -178,7 +179,7 @@ quote-style = "double"
 indent-style = "space"
 
 [tool.mypy]
-python_version = "3.10"
+python_version = "3.13"
 files = ["simplicio"]
 # Baseline rigor (#102 AC): permissive on missing third-party stubs, but
 # real within the package. Tighten per-module (`[[tool.mypy.overrides]]`)
@@ -207,7 +208,6 @@ module = [
   "simplicio.commands.test_run",
   "simplicio.cache_cli",
   "simplicio.precedent",
-  "simplicio.mcp_server",
   "simplicio.scratch.executor",
   "simplicio.orchestrator.feature",
   "simplicio.scratch.cli",

simplicio_cli-0.10.0/simplicio/__init__.py

@@ -0,0 +1,5 @@
+__version__ = "0.10.0"
+
+from .mapper_api import mapper_module, mapper_version
+
+__all__ = ["__version__", "mapper_module", "mapper_version"]

{simplicio_cli-0.9.6 → simplicio_cli-0.10.0}/simplicio/_cache.py

@@ -30,6 +30,16 @@ def _env_float(name: str, default: float) -> float:
         return default
 
 
+def _env_int(name: str, default: int) -> int:
+    raw = os.environ.get(name)
+    if raw is None or not raw.strip():
+        return default
+    try:
+        return int(raw)
+    except ValueError:
+        return default
+
+
 def _cache_root() -> Path:
     override = os.environ.get("SIMPLICIO_CACHE_DIR")
     if override:
@@ -153,7 +163,9 @@ class CompletionCache:
             if os.path.exists(tmp_name):
                 self._safe_unlink(Path(tmp_name))
         self.puts += 1
-        self._evict_if_needed()
+        evict_every = max(1, _env_int("SIMPLICIO_CACHE_EVICT_EVERY", 16))
+        if self.puts == 1 or self.puts % evict_every == 0:
+            self._evict_if_needed()
 
     def clear(self) -> int:
         n = self.stats()["entries"]

{simplicio_cli-0.9.6 → simplicio_cli-0.10.0}/simplicio/bench.py

@@ -14,6 +14,7 @@ import json
 import os
 import subprocess
 import time
+from pathlib import Path
 
 from .observability import estimate_tokens, log_run
 from .prompt import build_prompt
@@ -21,15 +22,15 @@ from .providers import generate
 from .runtime_env import wrap_project_command
 
 
-def _test(output, root, test_cmd):
+def _test(output: str, root: str, test_cmd: str) -> bool:
     os.makedirs(os.path.join(root, ".simplicio"), exist_ok=True)
-    open(os.path.join(root, ".simplicio/bench_out.txt"), "w").write(output or "")
+    Path(root, ".simplicio", "bench_out.txt").write_text(output or "", encoding="utf-8")
     test_cmd = wrap_project_command(root, test_cmd)
     p = subprocess.run(test_cmd, shell=True, cwd=root, capture_output=True, text=True)
     return p.returncode == 0
 
 
-def _baseline(case, root):
+def _baseline(case: dict[str, str], root: str) -> str:
     # baseline: raw goal, zero built context
     prompt = case["goal"]
     out = generate(prompt)
@@ -45,7 +46,7 @@ def _baseline(case, root):
     return out
 
 
-def _pipeline(case, root, stack):
+def _pipeline(case: dict[str, str], root: str, stack: str) -> str:
     prompt = build_prompt(
         root,
         stack,
@@ -67,9 +68,19 @@ def _pipeline(case, root, stack):
     return out
 
 
-def run_bench(root, stack, cases_path):
-    cases = json.load(open(cases_path))
+def run_bench(root: str, stack: str, cases_path: str) -> int:
+    try:
+        cases = json.loads(Path(cases_path).read_text(encoding="utf-8"))
+    except (OSError, ValueError) as exc:
+        print(f"simplicio-py: error: cannot read benchmark cases: {exc}")
+        return 1
+    if not isinstance(cases, list):
+        print("simplicio-py: error: benchmark cases must be a JSON list")
+        return 1
     rows, n = [], len(cases)
+    if n == 0:
+        print("simplicio-py: error: benchmark cases list is empty")
+        return 1
     hits = {"without": 0, "with": 0}
     hallucination_flags = {"without": 0, "with": 0}
     for c in cases:
@@ -97,10 +108,12 @@ def run_bench(root, stack, cases_path):
     )
     out = os.path.join(root, "bench", "results.md")
     os.makedirs(os.path.dirname(out), exist_ok=True)
-    open(out, "w").write(
+    Path(out).write_text(
         f"# Benchmark (generated by `simplicio-py bench`)\n\n"
         f"Provider: {os.environ.get('SIMPLICIO_PROVIDER', 'claude')} · "
-        f"cases: {n} · date: {time.strftime('%Y-%m-%d')}\n\n{table}\n"
+        f"cases: {n} · date: {time.strftime('%Y-%m-%d')}\n\n{table}\n",
+        encoding="utf-8",
     )
     print(table)
     print(f"\n-> {out}")
+    return 0

{simplicio_cli-0.9.6 → simplicio_cli-0.10.0}/simplicio/cli.py

@@ -55,23 +55,28 @@ def _dispatch_nested(argv: list[str]) -> int | None:
     parsing (unchanged by issue #103's cli.py cleanup)."""
     from .commands._shared import parse_rust_flags, try_route_via_simplicio
 
+    def wants_help(args: list[str]) -> bool:
+        return any(arg in {"-h", "--help"} for arg in args)
+
     if argv and argv[0] == "gate":
         clean_args, native, python = parse_rust_flags(argv[1:])
-        result = try_route_via_simplicio(
-            "gate", clean_args, prefer_native=native or not python, prefer_python=python
-        )
-        if result is not None:
-            return result
+        if not wants_help(clean_args):
+            result = try_route_via_simplicio(
+                "gate", clean_args, prefer_native=native or not python, prefer_python=python
+            )
+            if result is not None:
+                return result
         from .commands.gate import main as gate_main
 
         return gate_main(clean_args)
     if argv and argv[0] == "nest":
         clean_args, native, python = parse_rust_flags(argv[1:])
-        result = try_route_via_simplicio(
-            "nest", clean_args, prefer_native=native or not python, prefer_python=python
-        )
-        if result is not None:
-            return result
+        if not wants_help(clean_args):
+            result = try_route_via_simplicio(
+                "nest", clean_args, prefer_native=native or not python, prefer_python=python
+            )
+            if result is not None:
+                return result
         from .commands.nest import main as nest_main
 
         return nest_main(clean_args)
@@ -383,15 +388,6 @@ def _build_parser() -> argparse.ArgumentParser:
     p_runtime_doctor.add_argument("--root", default=".")
     p_runtime_doctor.add_argument("--json", action="store_true")
 
-    p_serve = sub.add_parser(
-        "serve", help="run simplicio-dev-cli as a server (--mcp for the MCP stdio protocol)"
-    )
-    p_serve.add_argument(
-        "--mcp",
-        action="store_true",
-        help="serve MCP tools (dev_cli_edit, dev_cli_validate, dev_cli_memory) over stdio",
-    )
-
     p_memory = sub.add_parser(
         "memory", help="cross-vendor memory handoff (markdown + git under ~/.simplicio/memory)"
     )
@@ -435,7 +431,6 @@ _COMMAND_MODULES = {
     "test": "test",
     "token": "token",
     "runtime": "runtime",
-    "serve": "serve",
     "memory": "memory",
 }
 
@@ -448,48 +443,58 @@ def main(argv=None):
 
     configure_logging(quiet=quiet, verbose=verbose)
 
-    # Session-start ecosystem-freshness check (closes the runtime gap where
-    # pyproject pins >=X but the installed version is older). Idempotent +
-    # opt-out via SIMPLICIO_NO_AUTO_UPGRADE=1. See simplicio/ecosystem.py.
     try:
-        from .ecosystem import maybe_run_session_start
-
-        maybe_run_session_start()
-    except Exception as e:
-        # Never let the freshness check break the CLI.
-        print(f"{CLI_PROG}: ecosystem check skipped ({e})", file=sys.stderr)
-
-    nested = _dispatch_nested(argv)
-    if nested is not None:
-        return nested
-
-    ap = _build_parser()
-    a = ap.parse_args(argv)
-    maybe_autoinstall(a.cmd)
-
-    # `mechanical-edit`/`edit`/`score-skill` need a little dispatch logic
-    # of their own (edit falls back to mechanical-edit; score-skill tries
-    # the Rust binary first) that doesn't fit the flat name->module table.
-    if a.cmd == "mechanical-edit":
-        from .commands.edit import run_mechanical_edit
-
-        return run_mechanical_edit(a)
-    if a.cmd == "edit":
-        from .commands.edit import run_edit
-
-        return run_edit(a)
-    if a.cmd == "score-skill":
-        from .commands.score_skill import run as score_skill_run
-
-        return score_skill_run(a)
-
-    module_name = _COMMAND_MODULES.get(a.cmd)
-    if module_name is None:
-        return 0
-    import importlib
-
-    command_module = importlib.import_module(f".commands.{module_name}", package=__package__)
-    return command_module.run(a)
+        # Session-start ecosystem-freshness check (closes the runtime gap where
+        # pyproject pins >=X but the installed version is older). Idempotent +
+        # opt-in via SIMPLICIO_AUTO_UPGRADE=1. See simplicio/ecosystem.py.
+        try:
+            from .ecosystem import maybe_run_session_start
+
+            maybe_run_session_start()
+        except Exception as e:
+            # Never let the freshness check break the CLI.
+            print(f"{CLI_PROG}: ecosystem check skipped ({e})", file=sys.stderr)
+
+        nested = _dispatch_nested(argv)
+        if nested is not None:
+            return nested
+
+        ap = _build_parser()
+        a = ap.parse_args(argv)
+        maybe_autoinstall(a.cmd)
+
+        # `mechanical-edit`/`edit`/`score-skill` need a little dispatch logic
+        # of their own (edit falls back to mechanical-edit; score-skill tries
+        # the Rust binary first) that doesn't fit the flat name->module table.
+        if a.cmd == "mechanical-edit":
+            from .commands.edit import run_mechanical_edit
+
+            return run_mechanical_edit(a)
+        if a.cmd == "edit":
+            from .commands.edit import run_edit
+
+            return run_edit(a)
+        if a.cmd == "score-skill":
+            from .commands.score_skill import run as score_skill_run
+
+            return score_skill_run(a)
+
+        module_name = _COMMAND_MODULES.get(a.cmd)
+        if module_name is None:
+            return 0
+        import importlib
+
+        command_module = importlib.import_module(f".commands.{module_name}", package=__package__)
+        return command_module.run(a)
+    except KeyboardInterrupt:
+        return 130
+    except BrokenPipeError:
+        return 130
+    except Exception as exc:
+        if verbose:
+            raise
+        print(f"{CLI_PROG}: error: {exc}", file=sys.stderr)
+        return 1
 
 
 if __name__ == "__main__":

{simplicio_cli-0.9.6 → simplicio_cli-0.10.0}/simplicio/commands/_shared.py

@@ -17,7 +17,11 @@ def read_text_source(path: str) -> str:
     """Read *path*, or stdin when *path* is the literal string ``"-"``."""
     if path == "-":
         return sys.stdin.read()
-    return Path(path).read_text(encoding="utf-8")
+    try:
+        return Path(path).read_text(encoding="utf-8")
+    except (FileNotFoundError, OSError) as exc:
+        print(f"{Path(sys.argv[0]).name}: error: cannot read {path}: {exc}", file=sys.stderr)
+        raise SystemExit(2) from exc
 
 
 def force_local_if_requested(a: argparse.Namespace) -> None:

{simplicio_cli-0.9.6 → simplicio_cli-0.10.0}/simplicio/commands/run.py

@@ -14,6 +14,7 @@ import sys
 import time
 from pathlib import Path
 
+from ..utils.fs import write_text_atomic
 from ._shared import force_local_if_requested
 
 CLI_PROG = "simplicio-py"
@@ -158,7 +159,7 @@ def _write_sprint_state(
         "dod": dod_results,
         "cost": cost,
     }
-    path.write_text(json.dumps(payload, indent=2, sort_keys=True), encoding="utf-8")
+    write_text_atomic(path, json.dumps(payload, indent=2, sort_keys=True), encoding="utf-8")
 
 
 def _run_sprint(a: argparse.Namespace) -> int:

{simplicio_cli-0.9.6 → simplicio_cli-0.10.0}/simplicio/commands/test_run.py

@@ -69,7 +69,11 @@ def _run_via_runtime(a: argparse.Namespace, extra_args: list[str]) -> int | None
     binary = discover_simplicio()
     if binary is None:
         return None
-    cmd = [binary, *_build_runtime_args(a, extra_args)]
+    binary_path = Path(binary)
+    if sys.platform == "win32" and binary_path.suffix.lower() not in {".exe", ".bat", ".cmd", ".ps1", ".py"}:
+        cmd = [sys.executable, binary, *_build_runtime_args(a, extra_args)]
+    else:
+        cmd = [binary, *_build_runtime_args(a, extra_args)]
     try:
         completed = subprocess.run(
             cmd,
@@ -93,7 +97,7 @@ def _run_via_runtime(a: argparse.Namespace, extra_args: list[str]) -> int | None
         _print_human(payload)
     if completed.stderr:
         print(completed.stderr, end="", file=sys.stderr)
-    return completed.returncode
+    return int(payload.get("exit_code", completed.returncode))
 
 
 def _parse_pytest_summary(output: str) -> tuple[int | None, int | None, int | None, float | None, str | None]:

{simplicio_cli-0.9.6 → simplicio_cli-0.10.0}/simplicio/dod.py

@@ -2,13 +2,16 @@
 
 from __future__ import annotations
 
+import os
 import re
+import shlex
 import subprocess
 from dataclasses import dataclass
 from pathlib import Path
 
 _CHECK_RE = re.compile(r"^\s*-\s+\[(?P<mark>[ xX])\]\s+(?P<label>.+?)\s*$")
 _COMMAND_RE = re.compile(r"`([^`]+)`")
+_SHELL_META_RE = re.compile(r"[|;&><$`]")
 
 
 @dataclass
@@ -54,6 +57,7 @@ def load_sprint_dod(sprint_root: str | Path) -> list[DodGate]:
 
 def run_dod_gates(root: str | Path, gates: list[DodGate]) -> list[dict]:
     results = []
+    allow_shell = os.environ.get("SIMPLICIO_DOD_ALLOW_SHELL", "").strip().lower() in {"1", "true", "yes"}
     for gate in gates:
         if not gate.command:
             results.append(
@@ -66,21 +70,45 @@ def run_dod_gates(root: str | Path, gates: list[DodGate]) -> list[dict]:
                 }
             )
             continue
-        proc = subprocess.run(
-            gate.command,
-            shell=True,
-            cwd=root,
-            capture_output=True,
-            text=True,
-            timeout=600,
-            check=False,
-        )
+        try:
+            if allow_shell:
+                proc = subprocess.run(
+                    gate.command,
+                    shell=True,
+                    cwd=root,
+                    capture_output=True,
+                    text=True,
+                    timeout=600,
+                    check=False,
+                )
+            else:
+                if _SHELL_META_RE.search(gate.command):
+                    raise ValueError(
+                        "shell metacharacters are blocked by default; rerun with SIMPLICIO_DOD_ALLOW_SHELL=1"
+                    )
+                proc = subprocess.run(
+                    shlex.split(gate.command),
+                    shell=False,
+                    cwd=root,
+                    capture_output=True,
+                    text=True,
+                    timeout=600,
+                    check=False,
+                )
+            passed = proc.returncode == 0
+            log = (proc.stdout + proc.stderr)[-1500:]
+        except subprocess.TimeoutExpired as exc:
+            passed = False
+            log = f"command timed out after {exc.timeout}s"
+        except ValueError as exc:
+            passed = False
+            log = str(exc)
         results.append(
             {
                 "label": gate.label,
-                "passed": proc.returncode == 0,
+                "passed": passed,
                 "command": gate.command,
-                "log": (proc.stdout + proc.stderr)[-1500:],
+                "log": log,
                 "manual": False,
             }
         )

{simplicio_cli-0.9.6 → simplicio_cli-0.10.0}/simplicio/ecosystem.py

@@ -16,9 +16,9 @@ API:
 Cached: PyPI lookups go through a 24h cache in ~/.simplicio/cache/pypi_versions.json
 so we don't hit pypi.org on every invocation.
 
-Opt-out:
-  SIMPLICIO_NO_AUTO_UPGRADE=1   # skip session-start upgrade entirely
-  SIMPLICIO_AUTO_UPGRADE=1      # force run even in CI
+Controls:
+  SIMPLICIO_AUTO_UPGRADE=1      # enable session-start upgrade check
+  SIMPLICIO_NO_AUTO_UPGRADE=1   # skip it even when AUTO_UPGRADE is set
 """
 
 from __future__ import annotations
@@ -150,14 +150,19 @@ def _pypi_latest(name: str, timeout: float = 5.0, refresh: bool = False) -> str
 
 
 def _version_lt(a: str | None, b: str | None) -> bool:
-    """Naive but adequate lex-on-int-tuple compare. Returns False if either is
-    None — we don't try to guess what 'unknown' means."""
+    """PEP-440-lite compare for numeric releases plus dev/a/b/rc prereleases."""
     if a is None or b is None:
         return False
 
-    def parse(v: str) -> tuple[int, ...]:
-        parts = re.split(r"[^0-9]+", v)
-        return tuple(int(x) for x in parts if x.isdigit())
+    def parse(v: str) -> tuple[tuple[int, ...], tuple[int, int]]:
+        match = re.match(r"^\s*(\d+(?:\.\d+)*)\s*([A-Za-z]+)?\s*(\d+)?\s*$", v)
+        if not match:
+            raise ValueError(v)
+        release = tuple(int(part) for part in match.group(1).split("."))
+        stage_raw = (match.group(2) or "").lower()
+        stage_num = int(match.group(3) or 0)
+        stage_order = {"dev": 0, "a": 1, "alpha": 1, "b": 2, "beta": 2, "rc": 3, "c": 3, "": 4}
+        return release, (stage_order.get(stage_raw, 4), stage_num)
 
     try:
         return parse(a) < parse(b)
@@ -297,6 +302,8 @@ def maybe_run_session_start() -> None:
         "yes",
     ):
         return
+    if os.environ.get("SIMPLICIO_AUTO_UPGRADE", "").strip().lower() not in {"1", "true", "yes"}:
+        return
 
     upgraded = ensure_latest()
     if upgraded:

simplicio_cli-0.10.0/simplicio/mapper_api.py

@@ -0,0 +1,34 @@
+"""Public bridge to the installed ``simplicio-mapper`` package.
+
+This keeps ``simplicio-cli`` as the operational CLI while exposing the
+underlying mapper dependency for downstream Python consumers that want a
+single import surface from this distribution.
+"""
+
+from __future__ import annotations
+
+from importlib import import_module
+from importlib.metadata import version
+from types import ModuleType
+from typing import Any
+
+_DIST_NAME = "simplicio-mapper"
+_MODULE_NAME = "simplicio_mapper"
+
+
+def mapper_module() -> ModuleType:
+    """Return the installed ``simplicio_mapper`` module."""
+    return import_module(_MODULE_NAME)
+
+
+def mapper_version() -> str:
+    """Return the installed ``simplicio-mapper`` distribution version."""
+    return version(_DIST_NAME)
+
+
+def __getattr__(name: str) -> Any:
+    """Proxy attributes to the underlying ``simplicio_mapper`` module."""
+    return getattr(mapper_module(), name)
+
+
+__all__ = ["mapper_module", "mapper_version"]