simplicio-cli 0.18.11__tar.gz → 0.18.12__tar.gz

{simplicio_cli-0.18.11 → simplicio_cli-0.18.12}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: simplicio-cli
-Version: 0.18.11
+Version: 0.18.12
 Summary: Deterministic task-to-code contract and verification CLI. It never executes or provisions an LLM.
 Author-email: Wesley Simplicio <wesleybob4@gmail.com>
 License: MIT
@@ -28,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.27,>=0.26.20
+Requires-Dist: simplicio-mapper<0.27,>=0.26.27
 Requires-Dist: simplicio-prompt>=1.14.1
 Requires-Dist: httpx>=0.28.1
 Requires-Dist: orjson>=3.11.9

{simplicio_cli-0.18.11 → simplicio_cli-0.18.12}/pyproject.toml

@@ -1,6 +1,6 @@
 [project]
 name = "simplicio-cli"
-version = "0.18.11"
+version = "0.18.12"
 description = "Deterministic task-to-code contract and verification CLI. It never executes or provisions an LLM."
 readme = "README.md"
 license = { text = "MIT" }
@@ -45,7 +45,7 @@ classifiers = [
 # (generated, `--check`-able) for the full graph and #99 for the audit.
 dependencies = [
   "numpy>=2.1.0",
-  "simplicio-mapper>=0.26.20,<0.27",
+  "simplicio-mapper>=0.26.27,<0.27",
   "simplicio-prompt>=1.14.1",
   "httpx>=0.28.1",
   "orjson>=3.11.9",

{simplicio_cli-0.18.11 → simplicio_cli-0.18.12}/simplicio/cli.py

@@ -413,6 +413,27 @@ def _build_parser() -> argparse.ArgumentParser:
         help="bypass the 24h PyPI cache when resolving mapper latest_known",
     )
 
+    p_release_train = sub.add_parser(
+        "release-train",
+        help="verify Mapper release events, immutable artifacts, and N/N-1 conformance",
+    )
+    release_train_sub = p_release_train.add_subparsers(dest="release_train_command", required=True)
+    release_verify = release_train_sub.add_parser(
+        "verify", help="fail-closed verification of one component-release-event/v1"
+    )
+    release_verify.add_argument("--event", required=True, help="Mapper release event JSON")
+    release_verify.add_argument("--conformance", help="installed N/N-1 conformance JSON")
+    release_verify.add_argument("--root", default=".", help="Dev CLI checkout containing pyproject.toml/uv.lock")
+    release_verify.add_argument("--declared-range")
+    release_verify.add_argument("--tested-against")
+    release_verify.add_argument("--state", default="", help="deduplication state JSON")
+    release_verify.add_argument("--record", action="store_true", help="record accepted event atomically")
+    release_verify.add_argument("--active-task", action="store_true", help="defer while a task is active")
+    release_verify.add_argument("--json", action="store_true", help="emit stable JSON")
+    release_doctor = release_train_sub.add_parser("doctor", help="report release-train evidence readiness")
+    release_doctor.add_argument("--root", default=".")
+    release_doctor.add_argument("--json", action="store_true", help="emit stable JSON")
+
     p_env_export = sub.add_parser(
         "env-export",
         help="print shell-safe exports from a dotenv file without sourcing it",
@@ -788,6 +809,7 @@ _COMMAND_MODULES = {
     "doctor": "doctor",
     "fast": "fast",
     "versions": "versions",
+    "release-train": "release_train",
     "env-export": "env_export",
     "changeset": "changeset",
     "file": "file",

simplicio_cli-0.18.12/simplicio/commands/release_train.py

@@ -0,0 +1,98 @@
+"""CLI adapter for the deterministic release-train contract."""
+
+from __future__ import annotations
+
+import argparse
+import json
+import os
+import tempfile
+from pathlib import Path
+from typing import Any
+
+from ..release_train import (
+    ReleaseTrainError,
+    evaluate_release_event,
+    release_train_doctor,
+)
+from ..component_manifest import (
+    declared_dependency_range,
+    tested_dependency_version,
+)
+
+
+def _read_json(path: Path) -> Any:
+    try:
+        return json.loads(path.read_text(encoding="utf-8"))
+    except (OSError, json.JSONDecodeError) as error:
+        raise ReleaseTrainError(f"cannot read JSON {path}: {error}") from error
+
+
+def _write_json_atomic(path: Path, value: dict[str, Any]) -> None:
+    path = path.resolve()
+    path.parent.mkdir(parents=True, exist_ok=True)
+    fd, temporary = tempfile.mkstemp(prefix=f".{path.name}.", suffix=".tmp", dir=str(path.parent))
+    try:
+        with os.fdopen(fd, "w", encoding="utf-8") as handle:
+            json.dump(value, handle, ensure_ascii=False, sort_keys=True, indent=2)
+            handle.write("\n")
+            handle.flush()
+            os.fsync(handle.fileno())
+        os.replace(temporary, path)
+    except Exception:
+        try:
+            os.unlink(temporary)
+        except OSError:
+            pass
+        raise
+
+
+def _load_state(path: Path | None) -> dict[str, Any]:
+    if path is None or not path.exists():
+        return {"processed_event_ids": [], "last_processed_version": None}
+    state = _read_json(path)
+    if not isinstance(state, dict):
+        raise ReleaseTrainError("release-train state must be an object")
+    ids = state.get("processed_event_ids", [])
+    last = state.get("last_processed_version")
+    if not isinstance(ids, list) or not all(isinstance(item, str) for item in ids):
+        raise ReleaseTrainError("state.processed_event_ids must be a list of strings")
+    if last is not None and not isinstance(last, str):
+        raise ReleaseTrainError("state.last_processed_version must be a string or null")
+    return {"processed_event_ids": sorted(set(ids)), "last_processed_version": last}
+
+
+def run(a: argparse.Namespace) -> int:
+    if a.release_train_command == "doctor":
+        print(json.dumps(release_train_doctor(a.root), ensure_ascii=False, indent=2, sort_keys=True))
+        return 0
+
+    try:
+        root = a.root
+        declared = a.declared_range or declared_dependency_range("simplicio-mapper", root)
+        tested = a.tested_against
+        if tested is None:
+            tested, _ = tested_dependency_version("simplicio-mapper", root)
+        state_path = Path(a.state) if a.state else None
+        state = _load_state(state_path)
+        evidence = _read_json(Path(a.conformance)) if a.conformance else None
+        decision = evaluate_release_event(
+            _read_json(Path(a.event)),
+            declared_range=declared,
+            tested_against=tested,
+            conformance=evidence,
+            active_task=a.active_task,
+            processed_event_ids=state["processed_event_ids"],
+            last_processed_version=state["last_processed_version"],
+        )
+        if a.record and decision.status == "accepted" and state_path is not None:
+            _write_json_atomic(state_path, decision.state)
+        print(json.dumps(decision.to_dict(), ensure_ascii=False, indent=2, sort_keys=True))
+        return 0 if decision.status in {"accepted", "duplicate"} else 2
+    except (OSError, ReleaseTrainError, TypeError, ValueError) as error:
+        print(json.dumps({
+            "schema": "simplicio.dev-cli.release-train/v1",
+            "status": "blocked",
+            "reason_code": "invalid_input",
+            "reason": str(error),
+        }, ensure_ascii=False, indent=2, sort_keys=True))
+        return 2

{simplicio_cli-0.18.11 → simplicio_cli-0.18.12}/simplicio/commands/versions.py

@@ -44,6 +44,7 @@ from ..component_manifest import (
     tested_dependency_version,
 )
 from ..ecosystem import _pypi_latest
+from ..release_train import release_train_doctor
 
 CLI_PROG = "simplicio-py"
 MAPPER_DIST_NAME = "simplicio-mapper"
@@ -111,6 +112,7 @@ def versions_report(
         tested_against=tested_against,
     )
     own_manifest = build_own_manifest(root)
+    release_train = release_train_doctor(root)
 
     return {
         "schema": "simplicio.dev-cli.versions/v1",
@@ -126,6 +128,7 @@ def versions_report(
         },
         "drift": drift.to_dict(),
         "own_manifest": own_manifest.to_dict(),
+        "release_train": release_train,
     }
 
 
@@ -158,6 +161,11 @@ def _render_human(payload: dict[str, Any]) -> None:
     print(f"  version       {own['version']}")
     print(f"  commit        {own['commit'] or '(unknown)'}")
     print(f"  schema count  {len(own['schema_versions'])}")
+    train = payload["release_train"]
+    print()
+    print("release train readiness:")
+    print(f"  status        {train['status']}")
+    print(f"  reason        {train['reason_code']}")
 
 
 def run(a: argparse.Namespace) -> int:

{simplicio_cli-0.18.11 → simplicio_cli-0.18.12}/simplicio/component_manifest.py

@@ -3,11 +3,11 @@ manifests and check them against this repo's own declared compatibility
 range (issue #232).
 
 Context (verified in the issue): `simplicio-cli` declares
-`simplicio-mapper>=0.23.1` in `pyproject.toml`, while the Mapper already
-publishes 0.24.0/0.24.1. That range lets a *clean* install resolve to the
+`simplicio-mapper>=0.26.27,<0.27` in `pyproject.toml`, while the Mapper already
+publishes the 0.26.x train. That range lets a *clean* install resolve to the
 newer Mapper, but it never proves the combination was actually exercised,
 and it never updates an *existing* environment/lock (this repo's own
-`uv.lock` still pins `simplicio-mapper==0.23.1` — see
+`uv.lock` is now expected to pin the verified train candidate — see
 :func:`tested_mapper_version`). Issue #280 on the Mapper side (built by a
 parallel agent, not visible from here) is expected to add a
 ``simplicio.component-release/v1`` manifest and a `simplicio-mapper version
@@ -20,7 +20,7 @@ parallel agent, not visible from here) is expected to add a
 - :func:`check_component_compatibility` — real semver-range logic deciding
   whether a candidate manifest's version is COMPATIBLE, INCOMPATIBLE, or
   NEEDS_REVIEW against a declared range (e.g. this repo's own
-  ``simplicio-mapper>=0.23.1``), parsed for real out of `pyproject.toml`.
+  ``simplicio-mapper>=0.26.27,<0.27``), parsed for real out of `pyproject.toml`.
 - :func:`build_own_manifest` — the reverse direction: build *this* repo's
   own ``simplicio.component-release/v1`` manifest (name=`simplicio-cli`,
   version from `pyproject.toml`/`__version__`, commit from

{simplicio_cli-0.18.11 → simplicio_cli-0.18.12}/simplicio/doctor.py

@@ -136,6 +136,9 @@ def _render_mapper_versions(payload: dict) -> None:
         print(f"  drift            {drift['kind']}: {drift['reason']}")
     else:
         print("  drift            none")
+    train = payload.get("release_train")
+    if train:
+        print(f"  release train    {train['status']} — {train['reason_code']}")
 
 
 def _render_native_delegation(summary: dict) -> None: