simplicio-cli 0.11.0__tar.gz → 0.16.2__tar.gz

{simplicio_cli-0.11.0/simplicio_cli.egg-info → simplicio_cli-0.16.2}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: simplicio-cli
-Version: 0.11.0
+Version: 0.16.2
 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
@@ -28,12 +28,13 @@ Requires-Python: >=3.10
 Description-Content-Type: text/markdown
 License-File: LICENSE
 Requires-Dist: numpy>=2.1.0
-Requires-Dist: simplicio-mapper>=0.19.0
+Requires-Dist: simplicio-mapper>=0.24.1
 Requires-Dist: simplicio-prompt>=1.14.1
 Requires-Dist: httpx>=0.28.1
 Requires-Dist: orjson>=3.11.9
 Requires-Dist: diskcache>=5.6.3
 Requires-Dist: libcst>=1.8.6
+Requires-Dist: tiktoken<1,>=0.12.0
 Provides-Extra: providers
 Requires-Dist: anthropic>=0.112.0; extra == "providers"
 Requires-Dist: openai>=2.44.0; extra == "providers"
@@ -44,13 +45,18 @@ Requires-Dist: fpdf2>=2.8.7; extra == "bench"
 Provides-Extra: local
 Requires-Dist: llama-cpp-python>=0.3.32; extra == "local"
 Requires-Dist: huggingface-hub>=1.21.0; extra == "local"
+Provides-Extra: performance
+Requires-Dist: uvloop>=0.21.0; sys_platform != "win32" and extra == "performance"
 Provides-Extra: all
 Requires-Dist: simplicio-cli[providers]; extra == "all"
 Requires-Dist: simplicio-cli[ml]; extra == "all"
 Requires-Dist: simplicio-cli[bench]; extra == "all"
 Requires-Dist: simplicio-cli[local]; extra == "all"
+Requires-Dist: simplicio-cli[performance]; extra == "all"
 Provides-Extra: test
 Requires-Dist: pytest>=8; extra == "test"
+Requires-Dist: pytest-cov>=7; extra == "test"
+Requires-Dist: hypothesis>=6.100; extra == "test"
 Requires-Dist: tomli>=2.0.1; python_version < "3.11" and extra == "test"
 Provides-Extra: dev
 Requires-Dist: simplicio-cli[test]; extra == "dev"
@@ -77,7 +83,11 @@ Dynamic: license-file
 </p>
 
 <p align="center">
-  <img src="output/imagegen/simplicio-cli-readme-hero-web.png" alt="simplicio-cli preview" width="860" />
+  <img src="output/imagegen/simplicio-cli-readme-hero-web.png" alt="simplicio-dev-cli execution pipeline" width="860" />
+</p>
+
+<p align="center">
+  <img src="output/imagegen/simplicio-cli-proof-receipt.png" alt="diff, tests, and verification receipt" width="760" />
 </p>
 
 ---
@@ -88,7 +98,7 @@ Turn a one-line task into a verified code change: mapper context, six-layer cont
 
 ## Project DNA
 
-simplicio-cli is not just a command wrapper; it is the measured execution layer of the ecosystem. Its older README carried the hard proof: real hidden tests, benchmark tables, model comparisons, provider policy, and the honest boundary between better prompting and actual capability. That evidence belongs beside the new hero, not behind it.
+simplicio-dev-cli is the focused implementation and verification operator in the Simplicio ecosystem. It receives a decided task, loads repository context, applies a bounded diff, runs tests, and emits evidence that another operator can inspect. It is not the runtime, the mapper, or the LLM itself: it is the disciplined execution layer between a plan and a trustworthy change.
 
 The new first screen is the doorway; the restored guide below is the workshop. This README should help a stranger understand the promise quickly and still give an operator enough depth to run, validate, and extend the project.
 
@@ -98,52 +108,61 @@ The new first screen is the doorway; the restored guide below is the workshop. T
 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"
+simplicio-py --version --json
 ```
 
+The JSON version handshake is the canonical identity surface for runtime/agent consumers. It
+includes the package version, entrypoints, mapper version, and supported contract capabilities.
+
 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.
-- Loads simplicio-mapper artifacts before asking an LLM to edit.
-- Keeps a verification loop around generated diffs instead of trusting the first answer.
-- Works with local Simplicio1, OpenRouter, OpenAI, Anthropic, DeepSeek, Hermes, Codex and Claude-style hosts.
+- Accepts a focused task from the runtime, agent, or CLI surface.
+- Loads simplicio-mapper context and relevant precedent before an edit is attempted.
+- Applies a bounded diff, runs the requested tests, and records a verification receipt.
+- Leaves orchestration, model choice, and long-lived loop state to the surrounding Simplicio layers.
 
-## Why this README is built to earn attention
+## The real product boundary
 
-- clear first-screen promise
-- language links before installation
-- badges and a visual hero for fast trust
-- copy-ready quick start
-- proof before long reference material
-- star history for social proof
+- The CLI turns an already-decided engineering intention into a controlled change.
+- The mapper supplies context; the operator supplies execution and proof.
+- A green-looking diff is not enough: tests and evidence are part of the result.
 
 ## How it works
 
 ```mermaid
 flowchart LR
-  mapper["simplicio-mapper
-repo context"] --> runtime["simplicio-runtime
-task and MCP surface"]
-  loop["simplicio-loop
-proven task flow"] --> runtime
-  runtime --> current["simplicio-cli
-focused implementation"]
-  current --> edit["simplicio edit
-mechanical writes"]
-  current --> evidence["validated evidence
-tests, docs, screenshots"]
-  runtime --> sprint["simplicio-sprint
-delivery status"]
+  task(["bounded task"])
+  subgraph install["SIMPLICIO-DEV-CLI 0.16.1 INSTALL SURFACE"]
+    mapper["simplicio-mapper 0.23.1<br/>context + precedent"]
+    operator["focused operator"]
+    diff["bounded diff"]
+    tests["tests + gates"]
+  end
+  subgraph proof["PROOF"]
+    receipt[("evidence receipt")]
+  end
+  task --> mapper --> operator
+  operator --> diff
+  operator --> tests
+  diff --> receipt
+  tests --> receipt
+  classDef input fill:#13233f,stroke:#79d8ff,color:#ffffff
+  classDef action fill:#102e2a,stroke:#48e0ae,color:#ffffff
+  classDef proofNode fill:#3a244e,stroke:#ffb86b,color:#ffffff
+  class task input
+  class mapper,operator,diff,tests action
+  class receipt proofNode
 ```
 
 ## Proof and validation
 
-- Benchmark docs compare plain prompting vs the Simplicio contract on real code tasks.
-- Package metadata tests pin ecosystem dependency floors.
-- The CLI is the executor layer used by SendSprint and SimplicioCode flows.
+- The package metadata and mapper handoff are covered by contract tests.
+- Build, lint, test, and packaging gates are recorded with releases when available.
+- The operator is designed to be called by simplicio-runtime, simplicio-loop, agents, or directly from the CLI.
 
 ## Simplicio ecosystem
 
@@ -158,8 +177,8 @@ delivery status"]
 - [docs/PYTHON_PACKAGE_INTERDEPENDENCE.md](docs/PYTHON_PACKAGE_INTERDEPENDENCE.md) —
   **generated, not hand-edited** (#101). Regenerate after touching
   `pyproject.toml`'s version/dependencies/extras:
-  `python3 scripts/gen_package_interdependence.py`. CI enforces it hasn't
-  drifted (`python3 scripts/gen_package_interdependence.py --check`, also
+  `python3 scripts/gen_package_interdependence.py`. The local gate enforces it
+  hasn't drifted (`python3 scripts/gen_package_interdependence.py --check`, also
   covered by `tests/python/test_generated_docs.py`).
 - [docs/LLM_USAGE_POLICY.md](docs/LLM_USAGE_POLICY.md)
 - [docs/readme-globalization-standard.md](docs/readme-globalization-standard.md)
@@ -168,13 +187,13 @@ delivery status"]
 
 The section below restores the project-specific README material that existed before the globalization pass. Keep this substance when refreshing the top-level narrative: add polish, do not erase operational memory.
 
-**Your tasks with 99% accuracy using any LLM (Claude, DeepSeek, Codex, Gemini, Hermes, OpenClaw, Cursor).**
+**A focused execution operator for turning decided engineering tasks into verified changes across LLM providers.**
 
 [![PyPI](https://img.shields.io/pypi/v/simplicio-cli.svg)](https://pypi.org/project/simplicio-cli/)
 [![Python](https://img.shields.io/pypi/pyversions/simplicio-cli.svg)](https://pypi.org/project/simplicio-cli/)
 [![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](LICENSE)
 
-[![simplicio-cli pipeline hero: one-line task to verified code change](https://raw.githubusercontent.com/wesleysimplicio/simplicio-cli/master/output/imagegen/simplicio-cli-readme-hero-web.png)](output/imagegen/simplicio-cli-readme-hero.png)
+[![simplicio-dev-cli pipeline: task to verified code change](https://raw.githubusercontent.com/wesleysimplicio/simplicio-dev-cli/main/output/imagegen/simplicio-cli-readme-hero-web.png)](output/imagegen/simplicio-cli-readme-hero.png)
 
 > *"hide the Delete button for non-admins"* → diff + test + applied + verified.
 > **Zero API key inside Claude Code** (auto-installs, uses your subscription) — or
@@ -519,15 +538,18 @@ Missing an extra never crashes with a raw traceback — every optional import
 is guarded and raises an actionable error naming the exact extra to install
 (e.g. `pip install 'simplicio-cli[providers]'`).
 
-#### Local-equivalent of the CI gate
+#### Local quality gate
 
-`.github/workflows/ci.yml` is the primary required gate (the Node/Playwright
-harness in `starter-e2e.yml` validates the starter-kit template only and does
-not gate merges). Reproduce it locally with:
+GitHub Actions is disabled for this repository and `.github/workflows/` is
+intentionally absent. The reproducible merge gate runs locally; attach its
+command output to the pull request:
 
 ```bash
-pip install -e ".[test]"             # base install + pytest (+ tomli on 3.10)
-pytest                               # tests/python + tests/contracts, per pyproject.toml testpaths
+python -m pip install -e ".[dev]" build twine
+ruff check . && ruff format --check . && mypy simplicio
+pytest --cov=simplicio --cov-report=json:coverage.json
+python3 scripts/coverage_gate.py --report coverage.json
+python3 scripts/token_budget.py --check
 python3 scripts/gen_package_interdependence.py --check  # generated-doc drift gate (#101)
 simplicio-py --help                  # entrypoint smoke (x3)
 simplicio-cli --help
@@ -640,6 +662,13 @@ cost_usd, diff_summary, warnings}`. Repeat `--bound-paths <glob>` to reject
 diffs outside the allowed edit surface; violations are reported in `warnings`
 and the command exits non-zero.
 
+See [structured blocked-precondition receipts](docs/blocked-preconditions.md) for the JSON `status`, `blocked_preconditions`, `reason`, and `next_surface` contract.
+See [patch receipts](docs/patch-receipts.md) for parser strategy, recovery fingerprint, and requested/effective capability evidence.
+See [the evidence ledger](docs/evidence-ledger.md) for append-only AC/RN receipts and stale-artifact gates.
+See [multi-task batches](docs/multi-task-batches.md) for deterministic DAG state and resumable transitions.
+See [prompt envelopes](docs/prompt-envelopes.md) for layer budgets, stable prefix hashes, and typed retry deltas.
+The deterministic delivery corpus is available with `python -m bench.run_delivery_corpus`.
+
 #### Path 3 example — standalone with API key
 
 ```bash

{simplicio_cli-0.11.0 → simplicio_cli-0.16.2}/README.md

@@ -17,7 +17,11 @@
 </p>
 
 <p align="center">
-  <img src="output/imagegen/simplicio-cli-readme-hero-web.png" alt="simplicio-cli preview" width="860" />
+  <img src="output/imagegen/simplicio-cli-readme-hero-web.png" alt="simplicio-dev-cli execution pipeline" width="860" />
+</p>
+
+<p align="center">
+  <img src="output/imagegen/simplicio-cli-proof-receipt.png" alt="diff, tests, and verification receipt" width="760" />
 </p>
 
 ---
@@ -28,7 +32,7 @@ Turn a one-line task into a verified code change: mapper context, six-layer cont
 
 ## Project DNA
 
-simplicio-cli is not just a command wrapper; it is the measured execution layer of the ecosystem. Its older README carried the hard proof: real hidden tests, benchmark tables, model comparisons, provider policy, and the honest boundary between better prompting and actual capability. That evidence belongs beside the new hero, not behind it.
+simplicio-dev-cli is the focused implementation and verification operator in the Simplicio ecosystem. It receives a decided task, loads repository context, applies a bounded diff, runs tests, and emits evidence that another operator can inspect. It is not the runtime, the mapper, or the LLM itself: it is the disciplined execution layer between a plan and a trustworthy change.
 
 The new first screen is the doorway; the restored guide below is the workshop. This README should help a stranger understand the promise quickly and still give an operator enough depth to run, validate, and extend the project.
 
@@ -38,52 +42,61 @@ The new first screen is the doorway; the restored guide below is the workshop. T
 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"
+simplicio-py --version --json
 ```
 
+The JSON version handshake is the canonical identity surface for runtime/agent consumers. It
+includes the package version, entrypoints, mapper version, and supported contract capabilities.
+
 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.
-- Loads simplicio-mapper artifacts before asking an LLM to edit.
-- Keeps a verification loop around generated diffs instead of trusting the first answer.
-- Works with local Simplicio1, OpenRouter, OpenAI, Anthropic, DeepSeek, Hermes, Codex and Claude-style hosts.
+- Accepts a focused task from the runtime, agent, or CLI surface.
+- Loads simplicio-mapper context and relevant precedent before an edit is attempted.
+- Applies a bounded diff, runs the requested tests, and records a verification receipt.
+- Leaves orchestration, model choice, and long-lived loop state to the surrounding Simplicio layers.
 
-## Why this README is built to earn attention
+## The real product boundary
 
-- clear first-screen promise
-- language links before installation
-- badges and a visual hero for fast trust
-- copy-ready quick start
-- proof before long reference material
-- star history for social proof
+- The CLI turns an already-decided engineering intention into a controlled change.
+- The mapper supplies context; the operator supplies execution and proof.
+- A green-looking diff is not enough: tests and evidence are part of the result.
 
 ## How it works
 
 ```mermaid
 flowchart LR
-  mapper["simplicio-mapper
-repo context"] --> runtime["simplicio-runtime
-task and MCP surface"]
-  loop["simplicio-loop
-proven task flow"] --> runtime
-  runtime --> current["simplicio-cli
-focused implementation"]
-  current --> edit["simplicio edit
-mechanical writes"]
-  current --> evidence["validated evidence
-tests, docs, screenshots"]
-  runtime --> sprint["simplicio-sprint
-delivery status"]
+  task(["bounded task"])
+  subgraph install["SIMPLICIO-DEV-CLI 0.16.1 INSTALL SURFACE"]
+    mapper["simplicio-mapper 0.23.1<br/>context + precedent"]
+    operator["focused operator"]
+    diff["bounded diff"]
+    tests["tests + gates"]
+  end
+  subgraph proof["PROOF"]
+    receipt[("evidence receipt")]
+  end
+  task --> mapper --> operator
+  operator --> diff
+  operator --> tests
+  diff --> receipt
+  tests --> receipt
+  classDef input fill:#13233f,stroke:#79d8ff,color:#ffffff
+  classDef action fill:#102e2a,stroke:#48e0ae,color:#ffffff
+  classDef proofNode fill:#3a244e,stroke:#ffb86b,color:#ffffff
+  class task input
+  class mapper,operator,diff,tests action
+  class receipt proofNode
 ```
 
 ## Proof and validation
 
-- Benchmark docs compare plain prompting vs the Simplicio contract on real code tasks.
-- Package metadata tests pin ecosystem dependency floors.
-- The CLI is the executor layer used by SendSprint and SimplicioCode flows.
+- The package metadata and mapper handoff are covered by contract tests.
+- Build, lint, test, and packaging gates are recorded with releases when available.
+- The operator is designed to be called by simplicio-runtime, simplicio-loop, agents, or directly from the CLI.
 
 ## Simplicio ecosystem
 
@@ -98,8 +111,8 @@ delivery status"]
 - [docs/PYTHON_PACKAGE_INTERDEPENDENCE.md](docs/PYTHON_PACKAGE_INTERDEPENDENCE.md) —
   **generated, not hand-edited** (#101). Regenerate after touching
   `pyproject.toml`'s version/dependencies/extras:
-  `python3 scripts/gen_package_interdependence.py`. CI enforces it hasn't
-  drifted (`python3 scripts/gen_package_interdependence.py --check`, also
+  `python3 scripts/gen_package_interdependence.py`. The local gate enforces it
+  hasn't drifted (`python3 scripts/gen_package_interdependence.py --check`, also
   covered by `tests/python/test_generated_docs.py`).
 - [docs/LLM_USAGE_POLICY.md](docs/LLM_USAGE_POLICY.md)
 - [docs/readme-globalization-standard.md](docs/readme-globalization-standard.md)
@@ -108,13 +121,13 @@ delivery status"]
 
 The section below restores the project-specific README material that existed before the globalization pass. Keep this substance when refreshing the top-level narrative: add polish, do not erase operational memory.
 
-**Your tasks with 99% accuracy using any LLM (Claude, DeepSeek, Codex, Gemini, Hermes, OpenClaw, Cursor).**
+**A focused execution operator for turning decided engineering tasks into verified changes across LLM providers.**
 
 [![PyPI](https://img.shields.io/pypi/v/simplicio-cli.svg)](https://pypi.org/project/simplicio-cli/)
 [![Python](https://img.shields.io/pypi/pyversions/simplicio-cli.svg)](https://pypi.org/project/simplicio-cli/)
 [![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](LICENSE)
 
-[![simplicio-cli pipeline hero: one-line task to verified code change](https://raw.githubusercontent.com/wesleysimplicio/simplicio-cli/master/output/imagegen/simplicio-cli-readme-hero-web.png)](output/imagegen/simplicio-cli-readme-hero.png)
+[![simplicio-dev-cli pipeline: task to verified code change](https://raw.githubusercontent.com/wesleysimplicio/simplicio-dev-cli/main/output/imagegen/simplicio-cli-readme-hero-web.png)](output/imagegen/simplicio-cli-readme-hero.png)
 
 > *"hide the Delete button for non-admins"* → diff + test + applied + verified.
 > **Zero API key inside Claude Code** (auto-installs, uses your subscription) — or
@@ -459,15 +472,18 @@ Missing an extra never crashes with a raw traceback — every optional import
 is guarded and raises an actionable error naming the exact extra to install
 (e.g. `pip install 'simplicio-cli[providers]'`).
 
-#### Local-equivalent of the CI gate
+#### Local quality gate
 
-`.github/workflows/ci.yml` is the primary required gate (the Node/Playwright
-harness in `starter-e2e.yml` validates the starter-kit template only and does
-not gate merges). Reproduce it locally with:
+GitHub Actions is disabled for this repository and `.github/workflows/` is
+intentionally absent. The reproducible merge gate runs locally; attach its
+command output to the pull request:
 
 ```bash
-pip install -e ".[test]"             # base install + pytest (+ tomli on 3.10)
-pytest                               # tests/python + tests/contracts, per pyproject.toml testpaths
+python -m pip install -e ".[dev]" build twine
+ruff check . && ruff format --check . && mypy simplicio
+pytest --cov=simplicio --cov-report=json:coverage.json
+python3 scripts/coverage_gate.py --report coverage.json
+python3 scripts/token_budget.py --check
 python3 scripts/gen_package_interdependence.py --check  # generated-doc drift gate (#101)
 simplicio-py --help                  # entrypoint smoke (x3)
 simplicio-cli --help
@@ -580,6 +596,13 @@ cost_usd, diff_summary, warnings}`. Repeat `--bound-paths <glob>` to reject
 diffs outside the allowed edit surface; violations are reported in `warnings`
 and the command exits non-zero.
 
+See [structured blocked-precondition receipts](docs/blocked-preconditions.md) for the JSON `status`, `blocked_preconditions`, `reason`, and `next_surface` contract.
+See [patch receipts](docs/patch-receipts.md) for parser strategy, recovery fingerprint, and requested/effective capability evidence.
+See [the evidence ledger](docs/evidence-ledger.md) for append-only AC/RN receipts and stale-artifact gates.
+See [multi-task batches](docs/multi-task-batches.md) for deterministic DAG state and resumable transitions.
+See [prompt envelopes](docs/prompt-envelopes.md) for layer budgets, stable prefix hashes, and typed retry deltas.
+The deterministic delivery corpus is available with `python -m bench.run_delivery_corpus`.
+
 #### Path 3 example — standalone with API key
 
 ```bash

{simplicio_cli-0.11.0 → simplicio_cli-0.16.2}/pyproject.toml

@@ -1,6 +1,6 @@
 [project]
 name = "simplicio-cli"
-version = "0.11.0"
+version = "0.16.2"
 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" }
@@ -53,12 +53,13 @@ classifiers = [
 # (generated, `--check`-able) for the full graph and #99 for the audit.
 dependencies = [
   "numpy>=2.1.0",
-  "simplicio-mapper>=0.19.0",
+  "simplicio-mapper>=0.24.1",
   "simplicio-prompt>=1.14.1",
   "httpx>=0.28.1",
   "orjson>=3.11.9",
   "diskcache>=5.6.3",
   "libcst>=1.8.6",
+  "tiktoken>=0.12.0,<1",
 ]
 
 [project.optional-dependencies]
@@ -74,15 +75,31 @@ bench = ["fpdf2>=2.8.7"]
 # Offline fallback in-process inference. Pulls the llama.cpp Python bindings
 # plus huggingface-hub to fetch MiniCPM5-1B-Q4_K_M.gguf.
 local = ["llama-cpp-python>=0.3.32", "huggingface-hub>=1.21.0"]
+# Opt-in faster asyncio event loop for the structured-concurrency runtime
+# (simplicio.runtime_async, issue #212). Never required: `install_uvloop()`
+# no-ops on Windows or when this extra is absent, falling back to stdlib
+# asyncio.
+performance = ["uvloop>=0.21.0; sys_platform != 'win32'"]
 all = [
   "simplicio-cli[providers]",
   "simplicio-cli[ml]",
   "simplicio-cli[bench]",
   "simplicio-cli[local]",
+  "simplicio-cli[performance]",
 ]
 # CI/dev-only, not a product extra: pytest to run tests/python, plus tomli
 # on 3.10 (tomllib is stdlib only from 3.11+; several tests parse this file).
-test = ["pytest>=8", "tomli>=2.0.1; python_version < '3.11'"]
+# pytest-cov (#202) backs the coverage gate: `scripts/coverage_gate.py`
+# consumes the `coverage.json` report this generates. hypothesis backs
+# property-based tests (e.g. tests/python/test_mechanical_edit.py's
+# operation-ordering invariant, DoD Camada 2 issue #246) that fuzz random
+# plan shapes instead of only asserting the one hand-written regression case.
+test = [
+  "pytest>=8",
+  "pytest-cov>=7",
+  "hypothesis>=6.100",
+  "tomli>=2.0.1; python_version < '3.11'",
+]
 # CI/dev-only lint+type gate (#102): never a base/product dependency.
 # `ruff format --check .` / `ruff check .` / `mypy simplicio` is the local
 # command (see CONTRIBUTING.md / AGENTS.md "Comandos importantes").
@@ -118,12 +135,61 @@ simplicio = [
   "templates/stacks/**/*",
   "templates/stacks/*/tree/.gitignore",
   "templates/stacks/*/tree/.eslintrc.json",
+  # `score-skill` loads these builtin scenario fixtures at runtime from
+  # Path(__file__).resolve().parent / "scenarios" (see
+  # simplicio/commands/score_skill.py:_resolve_scenarios). Without this
+  # entry the wheel ships score_skill.py but not its data, so an installed
+  # `simplicio-py score-skill` with no --scenario silently fails outside the
+  # checkout (#167 AC "Package instalado contem docs/schemas esperados").
+  "commands/scenarios/*.json",
 ]
 
 [tool.pytest.ini_options]
 pythonpath = ["."]
 testpaths = ["tests/python", "tests/contracts"]
 
+# --------------------------------------------------------------------------- #
+# Coverage gate (#202): 85% global, 90% on the "critical" modules listed in
+# `[tool.coverage.simplicio_critical]` below. `scripts/coverage_gate.py`
+# enforces both numbers from the `coverage.json` report; the plain
+# `fail_under` here is a second, redundant floor so a local
+# `pytest --cov=simplicio --cov-fail-under=85` also fails fast without
+# needing the extra script.
+[tool.coverage.run]
+source = ["simplicio"]
+branch = true
+omit = [
+  "simplicio/templates/*",
+  "*/tests/*",
+]
+
+[tool.coverage.report]
+fail_under = 85
+show_missing = true
+skip_covered = false
+exclude_lines = [
+  "pragma: no cover",
+  "if TYPE_CHECKING:",
+  "raise NotImplementedError",
+  "def __repr__",
+]
+
+# Not a standard coverage.py table -- read only by scripts/coverage_gate.py
+# to apply the stricter 90% floor from issue #202 ("coverage crítico") to
+# the modules an agent/task pipeline run always exercises: CLI entrypoint,
+# the pipeline/mechanical-edit/mapper core, and the doctor/execution
+# contracts that gate every run.
+[tool.coverage.simplicio_critical]
+threshold = 90
+modules = [
+  "simplicio/cli.py",
+  "simplicio/pipeline.py",
+  "simplicio/mechanical_edit.py",
+  "simplicio/mapper.py",
+  "simplicio/execution_contract.py",
+  "simplicio/doctor.py",
+]
+
 # --------------------------------------------------------------------------- #
 # Lint / type gate (#102). Dev-only tooling — see the `dev` extra above.
 # Baseline is intentionally permissive (not `mypy --strict`); documented here

{simplicio_cli-0.11.0 → simplicio_cli-0.16.2}/simplicio/__init__.py

@@ -1,4 +1,4 @@
-__version__ = "0.11.0"
+__version__ = "0.16.2"
 
 from .mapper_api import mapper_module, mapper_version
 

{simplicio_cli-0.11.0 → simplicio_cli-0.16.2}/simplicio/bench.py

@@ -26,7 +26,14 @@ def _test(output: str, root: str, test_cmd: str) -> bool:
     os.makedirs(os.path.join(root, ".simplicio"), exist_ok=True)
     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)
+    p = subprocess.run(
+        test_cmd,
+        shell=True,
+        cwd=root,
+        stdin=subprocess.DEVNULL,
+        capture_output=True,
+        text=True,
+    )
     return p.returncode == 0
 
 

{simplicio_cli-0.11.0 → simplicio_cli-0.16.2}/simplicio/cache.py

@@ -15,6 +15,14 @@ import os
 import numpy as np
 
 
+class EmbeddingCacheMissError(KeyError):
+    """Raised by EmbeddingCache.lookup() when one or more texts have no cached
+    vector yet (e.g. embedding indexing was skipped/disabled). Callers should
+    check whether indexing is enabled before calling lookup(); this exists as
+    a defensive guard so a miss surfaces as a clear, actionable error instead
+    of a raw KeyError on an opaque hash string."""
+
+
 class EmbeddingCache:
     def __init__(self, root):
         self.dir = os.path.join(root, ".simplicio")
@@ -54,7 +62,21 @@ class EmbeddingCache:
             self.index[self.h(t)] = base + i
 
     def lookup(self, texts):
-        """Returns a matrix of vectors in the texts' order (all already cached)."""
+        """Returns a matrix of vectors in the texts' order (all already cached).
+
+        Raises EmbeddingCacheMissError (a KeyError subclass) instead of a raw
+        KeyError when a text's hash isn't cached yet, so callers get an
+        actionable message instead of an opaque hash lookup failure.
+        """
+        missing = [t for t in texts if self.h(t) not in self.index]
+        if missing:
+            raise EmbeddingCacheMissError(
+                f"{len(missing)} of {len(texts)} text block(s) are not in the "
+                "embedding cache yet. This usually means embedding indexing "
+                "was skipped (SIMPLICIO_ENABLE_EMBED_INDEX not set) or the "
+                "cache is stale. Enable indexing and re-run index_repo(), or "
+                "avoid calling lookup() when indexing is disabled."
+            )
         rows = [self.index[self.h(t)] for t in texts]
         return self.vectors[rows]
 

{simplicio_cli-0.11.0 → simplicio_cli-0.16.2}/simplicio/cache_cli.py

@@ -18,30 +18,35 @@ from ._cache import cache
 
 
 def _cmd_stats(args: argparse.Namespace) -> int:
+    # cache().stats() returns a plain dict (see _cache.py's Cache.stats):
+    # entries/bytes/root/enabled/bust/oldest_age_s, not an object with
+    # attributes — accessing it as `s.entries` etc. raised AttributeError
+    # on every invocation of this command.
     s = cache().stats()
+    oldest_age_days = round(s["oldest_age_s"] / 86400, 2) if s["oldest_age_s"] is not None else None
     if args.json:
         print(
             json.dumps(
                 {
-                    "entries": s.entries,
-                    "size_bytes": s.size_bytes,
-                    "size_mb": round(s.size_bytes / (1024 * 1024), 2),
-                    "oldest_age_days": s.oldest_age_days,
-                    "enabled": s.enabled,
-                    "bust_active": s.bust_active,
-                    "root": s.root,
+                    "entries": s["entries"],
+                    "size_bytes": s["bytes"],
+                    "size_mb": s["mb"],
+                    "oldest_age_days": oldest_age_days,
+                    "enabled": s["enabled"],
+                    "bust_active": s["bust"],
+                    "root": s["root"],
                 },
                 indent=2,
             )
         )
         return 0
     print("simplicio-py cache stats")
-    print(f"  root              {s.root}")
-    print(f"  enabled           {'yes' if s.enabled else 'no (SIMPLICIO_CACHE=0)'}")
-    print(f"  bust active       {'YES (SIMPLICIO_BUST_CACHE=1)' if s.bust_active else 'no'}")
-    print(f"  entries           {s.entries}")
-    print(f"  size              {s.size_bytes / (1024 * 1024):.2f} MB")
-    print(f"  oldest entry      {s.oldest_age_days} days")
+    print(f"  root              {s['root']}")
+    print(f"  enabled           {'yes' if s['enabled'] else 'no (SIMPLICIO_CACHE=0)'}")
+    print(f"  bust active       {'YES (SIMPLICIO_BUST_CACHE=1)' if s['bust'] else 'no'}")
+    print(f"  entries           {s['entries']}")
+    print(f"  size              {s['mb']:.2f} MB")
+    print(f"  oldest entry      {oldest_age_days} days")
     return 0