simplicio-loop 3.43.3__tar.gz → 3.43.4__tar.gz

{simplicio_loop-3.43.3/simplicio_loop.egg-info → simplicio_loop-3.43.4}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: simplicio-loop
-Version: 3.43.3
+Version: 3.43.4
 Summary: The Universal Looping AI Orchestrator — a runtime-agnostic super-plugin (7 skills) that drains any queue of work end-to-end on any LLM/runtime.
 Author-email: Wesley Simplicio <wesleybob4@gmail.com>
 License-Expression: MIT
@@ -22,7 +22,7 @@ Requires-Python: >=3.11
 Description-Content-Type: text/markdown
 License-File: LICENSE
 Requires-Dist: simplicio-cli<0.19,>=0.18.10
-Requires-Dist: simplicio-mapper<0.27,>=0.26.20
+Requires-Dist: simplicio-mapper<0.27,>=0.26.26
 Requires-Dist: simplicio-fast<3,>=2.0.28
 Requires-Dist: simplicio-prompt<1.15,>=1.14.3
 Requires-Dist: tiktoken<1,>=0.12.0

{simplicio_loop-3.43.3 → simplicio_loop-3.43.4}/pyproject.toml

@@ -4,7 +4,7 @@ build-backend = "setuptools.build_meta"
 
 [project]
 name = "simplicio-loop"
-version = "3.43.3"
+version = "3.43.4"
 description = "The Universal Looping AI Orchestrator — a runtime-agnostic super-plugin (7 skills) that drains any queue of work end-to-end on any LLM/runtime."
 readme = "PYPI.md"
 requires-python = ">=3.11"
@@ -23,14 +23,16 @@ classifiers = [
   "Topic :: Utilities",
   "Operating System :: OS Independent",
 ]
-# The loop ships with bound operators and the Prompt contract runtime as direct
-# dependencies. Do not rely on transitive installs: partial/no-deps installations
-# must be diagnosed explicitly and normal `pip install simplicio-loop` must request
-# the complete route -> enrichment closure.
+# The loop ships with its two bound operators and the Prompt contract runtime as
+# direct dependencies. `simplicio-cli` is the distribution that exports the
+# `simplicio-dev-cli` entrypoint. Do not rely on transitive installs: partial /
+# no-deps installations must be diagnosed explicitly and normal
+# `pip install simplicio-loop` must request the complete route -> enrichment
+# closure.
 dependencies = [
   # Loop is the aggregate distribution. Keep one tested component train.
   "simplicio-cli>=0.18.10,<0.19",
-  "simplicio-mapper>=0.26.20,<0.27",
+  "simplicio-mapper>=0.26.26,<0.27",
   "simplicio-fast>=2.0.28,<3",
   "simplicio-prompt>=1.14.3,<1.15",
   "tiktoken>=0.12.0,<1",

{simplicio_loop-3.43.3 → simplicio_loop-3.43.4}/simplicio_loop/__init__.py

@@ -13,6 +13,6 @@ try:
     try:
         __version__ = _v("simplicio-loop")
     except PackageNotFoundError:
-        __version__ = "3.43.3"
+        __version__ = "3.43.4"
 except Exception:  # pragma: no cover
-    __version__ = "3.43.3"
+    __version__ = "3.43.4"

{simplicio_loop-3.43.3 → simplicio_loop-3.43.4}/simplicio_loop/_bundle/skills/simplicio-learn/SKILL.md

@@ -39,7 +39,7 @@ Three durable categories — everything else is noise and is dropped:
    - `sibling_files`: related files changed
    - `hit_count`: incremented when the same fingerprint is seen again
    - `last_seen`: ISO timestamp
-   
+
    When `hit_count > 1`, flag the module for structural attention — it keeps breaking.
 4. **Stable facts & preferences** — durable workspace facts (build command, test runner, repo
    conventions) and recurring user preferences. Not one-time state.

{simplicio_loop-3.43.3/simplicio_loop/_bundle/skills/simplicio-tasks → simplicio_loop-3.43.4/simplicio_loop/_bundle/skills/simplicio-loop}/references/lmcache-adapter.md

@@ -5,8 +5,8 @@ using [LMCache](https://github.com/LMCache/LMCache) — a high-performance KV ca
 layer for LLM inference. Reduces Time-To-First-Token (TTFT), improves throughput, and lowers
 GPU cost by caching KV caches across GPU, CPU, disk, and remote storage.
 
-**Author:** LMCache team / CMU + Princeton.  
-**Repo:** [github.com/LMCache/LMCache](https://github.com/LMCache/LMCache)  
+**Author:** LMCache team / CMU + Princeton.
+**Repo:** [github.com/LMCache/LMCache](https://github.com/LMCache/LMCache)
 **Docs:** [docs.lmcache.ai](https://docs.lmcache.ai)
 
 ---

{simplicio_loop-3.43.3 → simplicio_loop-3.43.4}/simplicio_loop/_bundle/skills/simplicio-tasks/SKILL.md

@@ -48,4 +48,3 @@ mention `/simplicio-tasks` keep working without breaking.
 - Reutilize padrões validados por produtos maduros; não reinvente a roda.
 
 <!-- simplicio-global-llm-architecture-rules:end -->
-

{simplicio_loop-3.43.3/simplicio_loop/_bundle/skills/simplicio-loop → simplicio_loop-3.43.4/simplicio_loop/_bundle/skills/simplicio-tasks}/references/lmcache-adapter.md

@@ -5,8 +5,8 @@ using [LMCache](https://github.com/LMCache/LMCache) — a high-performance KV ca
 layer for LLM inference. Reduces Time-To-First-Token (TTFT), improves throughput, and lowers
 GPU cost by caching KV caches across GPU, CPU, disk, and remote storage.
 
-**Author:** LMCache team / CMU + Princeton.  
-**Repo:** [github.com/LMCache/LMCache](https://github.com/LMCache/LMCache)  
+**Author:** LMCache team / CMU + Princeton.
+**Repo:** [github.com/LMCache/LMCache](https://github.com/LMCache/LMCache)
 **Docs:** [docs.lmcache.ai](https://docs.lmcache.ai)
 
 ---

simplicio_loop-3.43.4/simplicio_loop/stack_manifest.py

@@ -0,0 +1,281 @@
+"""Single installed-stack manifest for Mapper, Fast, Dev CLI and Loop.
+
+Release-train floors (#558) are derived from this package's ``pyproject.toml``
+lower bounds when available so stack health does not drift from dependency pins.
+"""
+
+from __future__ import annotations
+
+import argparse
+import importlib.metadata as metadata
+import json
+import re
+import shutil
+import sys
+from pathlib import Path
+from typing import Any
+
+STACK_SCHEMA = "simplicio.loop-stack/v1"
+
+# Role labels are fixed; expected floors come from pyproject (see _train_components).
+_COMPONENT_ROLES = (
+    ("simplicio-mapper", "understand"),
+    ("simplicio-fast", "search"),
+    ("simplicio-cli", "change,verify"),
+    ("simplicio-loop", "run"),
+)
+
+# Fallback floors when pyproject cannot be read (offline wheel / missing checkout).
+_FALLBACK_FLOORS = {
+    "simplicio-mapper": "0.26.26",
+    "simplicio-fast": "2.0.28",
+    "simplicio-cli": "0.18.10",
+    "simplicio-loop": "3.43.4",
+}
+
+# These are operator identities, not distribution names.  ``simplicio-dev-cli``
+# is the required mutation entrypoint exported by the ``simplicio-cli``
+# distribution; it is intentionally checked separately from the distribution
+# so a partial or transitive install cannot look like a complete Loop stack.
+REQUIRED_OPERATOR_BINDINGS = (
+    ("simplicio-mapper", "simplicio-mapper", "simplicio-mapper"),
+    ("simplicio-dev-cli", "simplicio-cli", "simplicio-dev-cli"),
+)
+
+_REQUIREMENT_NAME = re.compile(r"^\s*([A-Za-z0-9_.-]+)")
+
+
+def _normalize_distribution_name(name: str) -> str:
+    """Normalize a Python distribution name according to PEP 503."""
+    return re.sub(r"[-_.]+", "-", str(name).strip()).lower()
+
+
+def _requirement_name(spec: str) -> str | None:
+    match = _REQUIREMENT_NAME.match(str(spec))
+    return _normalize_distribution_name(match.group(1)) if match else None
+
+
+def _dependency_specs_from_pyproject(pyproject_text: str) -> dict[str, str]:
+    """Return direct project dependencies keyed by normalized distribution name."""
+    try:
+        import tomllib
+
+        project = tomllib.loads(pyproject_text).get("project", {})
+        dependencies = project.get("dependencies", []) if isinstance(project, dict) else []
+    except (ImportError, TypeError, ValueError):
+        dependencies = []
+    if not isinstance(dependencies, list):
+        return {}
+    result: dict[str, str] = {}
+    for spec in dependencies:
+        name = _requirement_name(str(spec))
+        if name:
+            result[name] = str(spec)
+    return result
+
+
+def _declared_dependency_specs() -> dict[str, str]:
+    """Read Loop's direct dependencies from checkout or installed metadata.
+
+    A wheel does not contain the repository's ``pyproject.toml``.  Falling back
+    to ``Requires-Dist`` keeps the same validation available to users who run
+    ``simplicio-loop-stack`` after a normal PyPI installation.
+    """
+    path = _pyproject_path()
+    if path.is_file():
+        try:
+            return _dependency_specs_from_pyproject(path.read_text(encoding="utf-8"))
+        except OSError:
+            pass
+    try:
+        requirements = metadata.requires("simplicio-loop") or []
+    except metadata.PackageNotFoundError:
+        requirements = []
+    return {
+        name: str(spec)
+        for spec in requirements
+        if (name := _requirement_name(str(spec)))
+        and "; extra ==" not in str(spec).lower()
+    }
+
+
+def _console_entrypoint_owners() -> dict[str, set[str]]:
+    """Return console-script names grouped by their owning distribution."""
+    owners: dict[str, set[str]] = {}
+    try:
+        entrypoints = metadata.entry_points(group="console_scripts")
+    except TypeError:  # pragma: no cover - compatibility with older metadata APIs.
+        entrypoints = metadata.entry_points().get("console_scripts", ())
+    for entrypoint in entrypoints:
+        distribution = getattr(entrypoint, "dist", None)
+        distribution_name = getattr(distribution, "name", None)
+        if not distribution_name:
+            continue
+        owners.setdefault(_normalize_distribution_name(distribution_name), set()).add(
+            str(entrypoint.name)
+        )
+    return owners
+
+
+def operator_bindings() -> list[dict[str, Any]]:
+    """Verify the two mandatory Loop operators and their real entrypoints."""
+    declared = _declared_dependency_specs()
+    owners = _console_entrypoint_owners()
+    bindings: list[dict[str, Any]] = []
+    for operator, distribution, entrypoint in REQUIRED_OPERATOR_BINDINGS:
+        normalized_distribution = _normalize_distribution_name(distribution)
+        dependency_declared = normalized_distribution in declared
+        installed = _installed_version(distribution)
+        entrypoint_declared = entrypoint in owners.get(normalized_distribution, set())
+        resolved = shutil.which(entrypoint) or ""
+        if not dependency_declared:
+            status = "dependency-not-declared"
+        elif installed is None:
+            status = "dependency-missing"
+        elif not entrypoint_declared:
+            status = "entrypoint-not-declared"
+        elif not resolved:
+            status = "entrypoint-not-on-path"
+        else:
+            status = "ok"
+        bindings.append({
+            "operator": operator,
+            "distribution": distribution,
+            "entrypoint": entrypoint,
+            "dependency_declared": dependency_declared,
+            "dependency_spec": declared.get(normalized_distribution, ""),
+            "installed": installed,
+            "entrypoint_declared": entrypoint_declared,
+            "resolved": resolved,
+            "status": status,
+        })
+    return bindings
+
+
+def _installed_version(distribution: str) -> str | None:
+    try:
+        return metadata.version(distribution)
+    except metadata.PackageNotFoundError:
+        return None
+
+
+def _version_tuple(version: str) -> tuple[int, int, int] | None:
+    match = re.match(r"^(\d+)(?:\.(\d+))?(?:\.(\d+))?", version.strip())
+    if not match:
+        return None
+    return (
+        int(match.group(1)),
+        int(match.group(2) or 0),
+        int(match.group(3) or 0),
+    )
+
+
+def _pyproject_path() -> Path:
+    return Path(__file__).resolve().parent.parent / "pyproject.toml"
+
+
+def _parse_train_floors(pyproject_text: str) -> dict[str, str]:
+    """Extract lower-bound floors for train packages + package version for loop."""
+    floors = dict(_FALLBACK_FLOORS)
+    version_match = re.search(r'(?m)^version\s*=\s*"([^"]+)"', pyproject_text)
+    if version_match:
+        floors["simplicio-loop"] = version_match.group(1)
+    for name, spec in _dependency_specs_from_pyproject(pyproject_text).items():
+        if name not in floors or name == "simplicio-loop":
+            continue
+        # Prefer >= / == / ~= lower bound as the train floor.
+        floor_match = re.search(r"(?:>=|==|~=)\s*([0-9A-Za-z.\-+]+)", spec)
+        if floor_match:
+            floors[name] = floor_match.group(1)
+    return floors
+
+
+def _train_components() -> list[tuple[str, str, str]]:
+    floors = dict(_FALLBACK_FLOORS)
+    path = _pyproject_path()
+    if path.is_file():
+        try:
+            floors = _parse_train_floors(path.read_text(encoding="utf-8"))
+        except OSError:
+            pass
+    else:
+        # Installed wheels carry dependency metadata, but not the checkout's
+        # pyproject.  Use that metadata instead of retaining stale fallback
+        # floors from an older release.
+        for name, spec in _declared_dependency_specs().items():
+            if name not in floors or name == "simplicio-loop":
+                continue
+            floor_match = re.search(r"(?:>=|==|~=)\s*([0-9A-Za-z.\-+]+)", spec)
+            if floor_match:
+                floors[name] = floor_match.group(1)
+        installed_loop = _installed_version("simplicio-loop")
+        if installed_loop:
+            floors["simplicio-loop"] = installed_loop
+    return [(name, role, floors[name]) for name, role in _COMPONENT_ROLES]
+
+
+# Back-compat for tests/imports that still read COMPONENTS as a static tuple.
+COMPONENTS = tuple(_train_components())
+
+
+def stack_manifest() -> dict[str, Any]:
+    components = []
+    drifted = []
+    for distribution, role, expected in _train_components():
+        installed = _installed_version(distribution)
+        # Healthy when installed meets the train floor (at floor or newer patch/minor).
+        status = "ok"
+        if installed is None:
+            status = "missing-or-drifted"
+        elif installed != expected:
+            inst_t = _version_tuple(installed)
+            exp_t = _version_tuple(expected)
+            if inst_t is None or exp_t is None or inst_t < exp_t:
+                status = "missing-or-drifted"
+        components.append({
+            "distribution": distribution,
+            "role": role,
+            "expected": expected,
+            "installed": installed,
+            "status": status,
+        })
+        if status != "ok":
+            drifted.append(distribution)
+    bindings = operator_bindings()
+    binding_drift = [item["operator"] for item in bindings if item["status"] != "ok"]
+    missing_or_drifted = list(dict.fromkeys([*drifted, *binding_drift]))
+    return {
+        "schema": STACK_SCHEMA,
+        "version": 1,
+        "package": "simplicio-loop",
+        "components": components,
+        "operator_bindings": bindings,
+        "operator_contract_healthy": not binding_drift,
+        "healthy": not missing_or_drifted,
+        "missing_or_drifted": missing_or_drifted,
+        "source": "pyproject.toml or installed Requires-Dist metadata",
+    }
+
+
+def main(argv: list[str] | None = None) -> int:
+    parser = argparse.ArgumentParser(description="Inspect the installed Simplicio Loop stack")
+    parser.add_argument("--json", action="store_true", help="emit the machine-readable manifest")
+    parser.add_argument("--check", action="store_true", help="exit non-zero when the stack drifts")
+    args = parser.parse_args(argv)
+    document = stack_manifest()
+    if args.json or args.check:
+        print(json.dumps(document, ensure_ascii=False, sort_keys=True))
+    else:
+        print("simplicio-loop stack: " + ("healthy" if document["healthy"] else "drifted"))
+        for component in document["components"]:
+            print(f"- {component['distribution']}: {component['installed'] or 'missing'} ({component['role']})")
+        for binding in document["operator_bindings"]:
+            print(
+                f"- operator {binding['operator']}: {binding['status']} "
+                f"({binding['distribution']} -> {binding['entrypoint']})"
+            )
+    return 0 if document["healthy"] or not args.check else 1
+
+
+if __name__ == "__main__":
+    sys.exit(main())

{simplicio_loop-3.43.3 → simplicio_loop-3.43.4/simplicio_loop.egg-info}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: simplicio-loop
-Version: 3.43.3
+Version: 3.43.4
 Summary: The Universal Looping AI Orchestrator — a runtime-agnostic super-plugin (7 skills) that drains any queue of work end-to-end on any LLM/runtime.
 Author-email: Wesley Simplicio <wesleybob4@gmail.com>
 License-Expression: MIT
@@ -22,7 +22,7 @@ Requires-Python: >=3.11
 Description-Content-Type: text/markdown
 License-File: LICENSE
 Requires-Dist: simplicio-cli<0.19,>=0.18.10
-Requires-Dist: simplicio-mapper<0.27,>=0.26.20
+Requires-Dist: simplicio-mapper<0.27,>=0.26.26
 Requires-Dist: simplicio-fast<3,>=2.0.28
 Requires-Dist: simplicio-prompt<1.15,>=1.14.3
 Requires-Dist: tiktoken<1,>=0.12.0

{simplicio_loop-3.43.3 → simplicio_loop-3.43.4}/simplicio_loop.egg-info/SOURCES.txt

@@ -867,6 +867,7 @@ tests/test_source_snapshot_unit.py
 tests/test_source_state_unit.py
 tests/test_sprint_issue_routing.py
 tests/test_stack_lock.py
+tests/test_stack_manifest.py
 tests/test_stage_agent_conformance.py
 tests/test_stage_agent_contract.py
 tests/test_stage_agent_coordinator.py

{simplicio_loop-3.43.3 → simplicio_loop-3.43.4}/simplicio_loop.egg-info/requires.txt

@@ -1,5 +1,5 @@
 simplicio-cli<0.19,>=0.18.10
-simplicio-mapper<0.27,>=0.26.20
+simplicio-mapper<0.27,>=0.26.26
 simplicio-fast<3,>=2.0.28
 simplicio-prompt<1.15,>=1.14.3
 tiktoken<1,>=0.12.0

{simplicio_loop-3.43.3 → simplicio_loop-3.43.4}/tests/test_operator_bootstrap.py

@@ -21,7 +21,7 @@ class _Result:
 def test_normal_package_contract_requests_both_operator_distributions():
     pyproject = (Path(__file__).parents[1] / "pyproject.toml").read_text(encoding="utf-8")
     assert '"simplicio-cli>=0.18.10,<0.19"' in pyproject
-    assert '"simplicio-mapper>=0.26.20,<0.27"' in pyproject
+    assert '"simplicio-mapper>=0.26.26,<0.27"' in pyproject
 
 
 def test_available_operators_do_not_run_pip(tmp_path, monkeypatch):

{simplicio_loop-3.43.3 → simplicio_loop-3.43.4}/tests/test_prism_integrity_851.py

@@ -72,7 +72,7 @@ def test_version_fallback_drift_is_blocked(tmp_path):
     repo = fixture_repo(tmp_path)
     package = repo / "simplicio_loop" / "__init__.py"
     package.write_text(
-        package.read_text(encoding="utf-8").replace("3.43.3", "9.9.9"),
+        package.read_text(encoding="utf-8").replace("3.43.4", "9.9.9"),
         encoding="utf-8",
     )
     report = evaluate(repo)

{simplicio_loop-3.43.3 → simplicio_loop-3.43.4}/tests/test_release_train_reconciler_558.py

@@ -43,7 +43,7 @@ def _repo(tmp_path: Path) -> Path:
         "[project]\n"
         "dependencies = [\n"
         '  "simplicio-cli>=0.18.10,<0.19",\n'
-        '  "simplicio-mapper>=0.26.20,<0.27",\n'
+        '  "simplicio-mapper>=0.26.26,<0.27",\n'
         "]\n",
         encoding="utf-8",
     )

simplicio_loop-3.43.4/tests/test_stack_manifest.py

@@ -0,0 +1,71 @@
+from __future__ import annotations
+
+import tomllib
+from pathlib import Path
+
+from simplicio_loop import stack_manifest as manifest
+
+
+ROOT = Path(__file__).parents[1]
+
+
+def test_loop_declares_both_required_operator_distributions_directly() -> None:
+    project = tomllib.loads((ROOT / "pyproject.toml").read_text(encoding="utf-8"))["project"]
+    dependencies = manifest._dependency_specs_from_pyproject(
+        (ROOT / "pyproject.toml").read_text(encoding="utf-8")
+    )
+    assert "simplicio-mapper" in dependencies
+    assert "simplicio-cli" in dependencies
+    assert "simplicio-dev-cli" not in {
+        str(spec).split(";", 1)[0].split(">", 1)[0].split("<", 1)[0].strip()
+        for spec in project["dependencies"]
+    }
+
+
+def test_stack_manifest_proves_operator_distribution_and_entrypoint_ownership(monkeypatch) -> None:
+    monkeypatch.setattr(
+        manifest,
+        "_declared_dependency_specs",
+        lambda: {"simplicio-mapper": "simplicio-mapper>=1.0", "simplicio-cli": "simplicio-cli>=1.0"},
+    )
+    monkeypatch.setattr(manifest, "_installed_version", lambda _name: "1.0.0")
+    monkeypatch.setattr(
+        manifest,
+        "_console_entrypoint_owners",
+        lambda: {
+            "simplicio-mapper": {"simplicio-mapper"},
+            "simplicio-cli": {"simplicio-dev-cli"},
+        },
+    )
+    monkeypatch.setattr(manifest.shutil, "which", lambda name: "/bin/" + name)
+    monkeypatch.setattr(manifest, "_train_components", lambda: [("simplicio-loop", "run", "1.0.0")])
+
+    report = manifest.stack_manifest()
+
+    assert report["healthy"] is True
+    assert report["operator_contract_healthy"] is True
+    bindings = {item["operator"]: item for item in report["operator_bindings"]}
+    assert bindings["simplicio-mapper"]["status"] == "ok"
+    assert bindings["simplicio-dev-cli"]["distribution"] == "simplicio-cli"
+    assert bindings["simplicio-dev-cli"]["entrypoint_declared"] is True
+
+
+def test_stack_manifest_fails_when_mapper_dependency_or_dev_cli_entrypoint_is_missing(monkeypatch) -> None:
+    monkeypatch.setattr(manifest, "_declared_dependency_specs", lambda: {"simplicio-cli": "simplicio-cli>=1.0"})
+    monkeypatch.setattr(manifest, "_installed_version", lambda _name: "1.0.0")
+    monkeypatch.setattr(
+        manifest,
+        "_console_entrypoint_owners",
+        lambda: {"simplicio-cli": set()},
+    )
+    monkeypatch.setattr(manifest.shutil, "which", lambda _name: None)
+    monkeypatch.setattr(manifest, "_train_components", lambda: [("simplicio-loop", "run", "1.0.0")])
+
+    report = manifest.stack_manifest()
+
+    bindings = {item["operator"]: item for item in report["operator_bindings"]}
+    assert report["healthy"] is False
+    assert report["operator_contract_healthy"] is False
+    assert bindings["simplicio-mapper"]["status"] == "dependency-not-declared"
+    assert bindings["simplicio-dev-cli"]["status"] == "entrypoint-not-declared"
+    assert set(report["missing_or_drifted"]) == {"simplicio-mapper", "simplicio-dev-cli"}

simplicio_loop-3.43.3/simplicio_loop/stack_manifest.py

@@ -1,146 +0,0 @@
-"""Single installed-stack manifest for Mapper, Fast, Dev CLI and Loop.
-
-Release-train floors (#558) are derived from this package's ``pyproject.toml``
-lower bounds when available so stack health does not drift from dependency pins.
-"""
-
-from __future__ import annotations
-
-import argparse
-import importlib.metadata as metadata
-import json
-import re
-import sys
-from pathlib import Path
-from typing import Any
-
-STACK_SCHEMA = "simplicio.loop-stack/v1"
-
-# Role labels are fixed; expected floors come from pyproject (see _train_components).
-_COMPONENT_ROLES = (
-    ("simplicio-mapper", "understand"),
-    ("simplicio-fast", "search"),
-    ("simplicio-cli", "change,verify"),
-    ("simplicio-loop", "run"),
-)
-
-# Fallback floors when pyproject cannot be read (offline wheel / missing checkout).
-_FALLBACK_FLOORS = {
-    "simplicio-mapper": "0.26.20",
-    "simplicio-fast": "2.0.28",
-    "simplicio-cli": "0.18.10",
-    "simplicio-loop": "3.43.2",
-}
-
-
-def _installed_version(distribution: str) -> str | None:
-    try:
-        return metadata.version(distribution)
-    except metadata.PackageNotFoundError:
-        return None
-
-
-def _version_tuple(version: str) -> tuple[int, int, int] | None:
-    match = re.match(r"^(\d+)(?:\.(\d+))?(?:\.(\d+))?", version.strip())
-    if not match:
-        return None
-    return (
-        int(match.group(1)),
-        int(match.group(2) or 0),
-        int(match.group(3) or 0),
-    )
-
-
-def _pyproject_path() -> Path:
-    return Path(__file__).resolve().parent.parent / "pyproject.toml"
-
-
-def _parse_train_floors(pyproject_text: str) -> dict[str, str]:
-    """Extract lower-bound floors for train packages + package version for loop."""
-    floors = dict(_FALLBACK_FLOORS)
-    version_match = re.search(r'(?m)^version\s*=\s*"([^"]+)"', pyproject_text)
-    if version_match:
-        floors["simplicio-loop"] = version_match.group(1)
-    deps_match = re.search(r"(?m)^dependencies\s*=\s*\[(.*?)\]", pyproject_text, re.S)
-    if not deps_match:
-        return floors
-    for spec in re.findall(r'"([^"]+)"', deps_match.group(1)):
-        name_match = re.match(r"^([A-Za-z0-9_.\-]+)", spec.strip())
-        if not name_match:
-            continue
-        name = name_match.group(1)
-        if name not in floors or name == "simplicio-loop":
-            continue
-        # Prefer >= / == / ~= lower bound as the train floor.
-        floor_match = re.search(r"(?:>=|==|~=)\s*([0-9A-Za-z.\-+]+)", spec)
-        if floor_match:
-            floors[name] = floor_match.group(1)
-    return floors
-
-
-def _train_components() -> list[tuple[str, str, str]]:
-    floors = dict(_FALLBACK_FLOORS)
-    path = _pyproject_path()
-    if path.is_file():
-        try:
-            floors = _parse_train_floors(path.read_text(encoding="utf-8"))
-        except OSError:
-            pass
-    return [(name, role, floors[name]) for name, role in _COMPONENT_ROLES]
-
-
-# Back-compat for tests/imports that still read COMPONENTS as a static tuple.
-COMPONENTS = tuple(_train_components())
-
-
-def stack_manifest() -> dict[str, Any]:
-    components = []
-    drifted = []
-    for distribution, role, expected in _train_components():
-        installed = _installed_version(distribution)
-        # Healthy when installed meets the train floor (at floor or newer patch/minor).
-        status = "ok"
-        if installed is None:
-            status = "missing-or-drifted"
-        elif installed != expected:
-            inst_t = _version_tuple(installed)
-            exp_t = _version_tuple(expected)
-            if inst_t is None or exp_t is None or inst_t < exp_t:
-                status = "missing-or-drifted"
-        components.append({
-            "distribution": distribution,
-            "role": role,
-            "expected": expected,
-            "installed": installed,
-            "status": status,
-        })
-        if status != "ok":
-            drifted.append(distribution)
-    return {
-        "schema": STACK_SCHEMA,
-        "version": 1,
-        "package": "simplicio-loop",
-        "components": components,
-        "healthy": not drifted,
-        "missing_or_drifted": drifted,
-        "source": "pyproject.toml",
-    }
-
-
-def main(argv: list[str] | None = None) -> int:
-    parser = argparse.ArgumentParser(description="Inspect the installed Simplicio Loop stack")
-    parser.add_argument("--json", action="store_true", help="emit the machine-readable manifest")
-    parser.add_argument("--check", action="store_true", help="exit non-zero when the stack drifts")
-    args = parser.parse_args(argv)
-    document = stack_manifest()
-    if args.json or args.check:
-        print(json.dumps(document, ensure_ascii=False, sort_keys=True))
-    else:
-        print("simplicio-loop stack: " + ("healthy" if document["healthy"] else "drifted"))
-        for component in document["components"]:
-            print(f"- {component['distribution']}: {component['installed'] or 'missing'} ({component['role']})")
-    return 0 if document["healthy"] or not args.check else 1
-
-
-if __name__ == "__main__":
-    sys.exit(main())