simplicio-cli 0.9.1__tar.gz → 0.9.3__tar.gz

{simplicio_cli-0.9.1 → simplicio_cli-0.9.3}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: simplicio-cli
-Version: 0.9.1
+Version: 0.9.3
 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
@@ -26,21 +26,35 @@ Classifier: Topic :: Scientific/Engineering :: Artificial Intelligence
 Requires-Python: >=3.10
 Description-Content-Type: text/markdown
 License-File: LICENSE
-Requires-Dist: sentence-transformers>=5.6.0
-Requires-Dist: numpy>=2.5.0
-Requires-Dist: anthropic>=0.112.0
-Requires-Dist: openai>=2.44.0
-Requires-Dist: simplicio-mapper>=0.13.0
+Requires-Dist: numpy>=2.1.0
+Requires-Dist: simplicio-mapper>=0.16.0
 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
+Provides-Extra: providers
+Requires-Dist: anthropic>=0.112.0; extra == "providers"
+Requires-Dist: openai>=2.44.0; extra == "providers"
+Provides-Extra: ml
+Requires-Dist: sentence-transformers>=5.6.0; extra == "ml"
 Provides-Extra: bench
 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: 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"
+Provides-Extra: test
+Requires-Dist: pytest>=8; 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"
+Requires-Dist: ruff>=0.15.8; extra == "dev"
+Requires-Dist: mypy>=1.19.1; extra == "dev"
 Dynamic: license-file
 
 <h1 align="center">simplicio-cli</h1>
@@ -136,7 +150,12 @@ delivery status"]
 
 ## Documentation standard
 
-- [docs/PYTHON_PACKAGE_INTERDEPENDENCE.md](docs/PYTHON_PACKAGE_INTERDEPENDENCE.md)
+- [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
+  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)
 
@@ -435,6 +454,38 @@ classifies failures, and sends targeted retry feedback. Bench and pipeline runs
 can append lightweight JSONL records to `.simplicio/runs.jsonl` with prompt
 variant, model/provider, estimated tokens, target, mode and failure class.
 
+**TOON-encoded prompt context (`SIMPLICIO_PROMPT_TOON`, default on).** The
+uniform-array context blocks injected into generation prompts — mapper
+handoff `files[]`, project-map `Relevant files`, `Precedent candidates` — are
+rendered as [TOON](https://github.com/toon-format/toon) instead of
+hand-rolled bullets, ~27% fewer tokens on the same content (measured over
+`bench/cases.json`, see `bench/results_toon_ab.md`), losslessly. Non-uniform
+arrays fall back to compact JSON automatically. Set
+`SIMPLICIO_PROMPT_TOON=0` to restore the legacy bullet rendering.
+
+**Per-call usage events (`SIMPLICIO_LOG_ROOT`, opt-in).** Point this at a
+project root and `generate()`/`planner_complete()` append one usage event to
+`.simplicio/runs.jsonl` per provider call (cache hit or miss), labeling
+whether the token count is real provider-reported usage or the canonical
+estimator's guess. TOON activations and other measured token savings are
+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.
+
+`simplicio-dev-cli memory init|store|recall` is a markdown + git store under
+`~/.simplicio/memory/` (override with `SIMPLICIO_MEMORY_DIR`) for handing
+context off between agent vendors — a decision stored by one tool is
+recallable by another. Recall is deterministic keyword search, no LLM call,
+no network; real FTS5/vector-hybrid recall is a documented follow-up, not
+claimed here.
+
 **The idea in one line: don't ask the model to guess — hand it the path.**
 Each layer terminates one decision the model would otherwise hallucinate.
 Relevant > complete — inject the *right* context, never *all* of it.
@@ -449,6 +500,45 @@ pip install simplicio-cli           # from PyPI (pulls simplicio-mapper + simpli
 pip install -e .                    # from this repo
 ```
 
+#### Install profiles (extras)
+
+The base install (above) is just the executor/contract/mapper-context/
+edit-verify core — **no PyTorch, no provider SDKs**. Everything else is an
+opt-in extra, picked to match what the code actually imports (#99):
+
+| Extra | Adds | When you need it |
+|---|---|---|
+| *(base)* | `numpy`, `simplicio-mapper`, `simplicio-prompt`, `httpx`, `orjson`, `diskcache`, `libcst` | mechanical edit, mapper handoff, doctor/runtime contracts, `claude-cli`/`codex-cli` shell-out providers, cache/token primitives. `numpy` stays in base because `task`/`run`'s precedent+skill-router cosine-similarity ranking imports it unconditionally — it's lightweight (no GPU/torch), unlike the embedding model itself. |
+| `simplicio-cli[providers]` | `openai`, `anthropic` | native Anthropic models, or any OpenAI-compatible endpoint (OpenRouter, GLM, DeepSeek, ...) via `SIMPLICIO_MODEL`/`SIMPLICIO_BASE_URL`. |
+| `simplicio-cli[ml]` | `sentence-transformers` (pulls PyTorch, ~3 GB) | semantic precedent/skill ranking once cached vectors run out (`all-MiniLM-L6-v2`). |
+| `simplicio-cli[local]` | `llama-cpp-python`, `huggingface-hub` | offline in-process inference (default local GGUF, or any `local-llama/<repo>::<file>` model). |
+| `simplicio-cli[bench]` | `fpdf2` | `bench` command's PDF report. |
+| `simplicio-cli[all]` | union of the four above | everything. |
+
+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
+
+`.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:
+
+```bash
+pip install -e ".[test]"             # base install + pytest (+ tomli on 3.10)
+pytest                               # tests/python + tests/contracts, per pyproject.toml testpaths
+python3 scripts/gen_package_interdependence.py --check  # generated-doc drift gate (#101)
+simplicio-py --help                  # entrypoint smoke (x3)
+simplicio-cli --help
+simplicio-dev-cli --help
+
+pip install -e ".[providers]" && python -c "import openai, anthropic"  # extras coverage
+pip install build twine
+python -m build                      # sdist + wheel
+python -m twine check dist/*         # packaging smoke
+```
+
 The install ships **three Simplicio packages** that play distinct roles:
 
 - **`simplicio-cli`** (this repo) — the 6-layer task contract + verify loop.

simplicio_cli-0.9.1/simplicio_cli.egg-info/PKG-INFO → simplicio_cli-0.9.3/README.md

@@ -1,48 +1,3 @@
-Metadata-Version: 2.4
-Name: simplicio-cli
-Version: 0.9.1
-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
-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
-Classifier: Intended Audience :: Developers
-Classifier: License :: OSI Approved :: MIT License
-Classifier: Operating System :: OS Independent
-Classifier: Programming Language :: Python :: 3
-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: Topic :: Software Development
-Classifier: Topic :: Software Development :: Code Generators
-Classifier: Topic :: Software Development :: Libraries :: Python Modules
-Classifier: Topic :: Scientific/Engineering :: Artificial Intelligence
-Requires-Python: >=3.10
-Description-Content-Type: text/markdown
-License-File: LICENSE
-Requires-Dist: sentence-transformers>=5.6.0
-Requires-Dist: numpy>=2.5.0
-Requires-Dist: anthropic>=0.112.0
-Requires-Dist: openai>=2.44.0
-Requires-Dist: simplicio-mapper>=0.13.0
-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
-Provides-Extra: bench
-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"
-Dynamic: license-file
-
 <h1 align="center">simplicio-cli</h1>
 
 <p align="center">
@@ -136,7 +91,12 @@ delivery status"]
 
 ## Documentation standard
 
-- [docs/PYTHON_PACKAGE_INTERDEPENDENCE.md](docs/PYTHON_PACKAGE_INTERDEPENDENCE.md)
+- [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
+  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)
 
@@ -435,6 +395,38 @@ classifies failures, and sends targeted retry feedback. Bench and pipeline runs
 can append lightweight JSONL records to `.simplicio/runs.jsonl` with prompt
 variant, model/provider, estimated tokens, target, mode and failure class.
 
+**TOON-encoded prompt context (`SIMPLICIO_PROMPT_TOON`, default on).** The
+uniform-array context blocks injected into generation prompts — mapper
+handoff `files[]`, project-map `Relevant files`, `Precedent candidates` — are
+rendered as [TOON](https://github.com/toon-format/toon) instead of
+hand-rolled bullets, ~27% fewer tokens on the same content (measured over
+`bench/cases.json`, see `bench/results_toon_ab.md`), losslessly. Non-uniform
+arrays fall back to compact JSON automatically. Set
+`SIMPLICIO_PROMPT_TOON=0` to restore the legacy bullet rendering.
+
+**Per-call usage events (`SIMPLICIO_LOG_ROOT`, opt-in).** Point this at a
+project root and `generate()`/`planner_complete()` append one usage event to
+`.simplicio/runs.jsonl` per provider call (cache hit or miss), labeling
+whether the token count is real provider-reported usage or the canonical
+estimator's guess. TOON activations and other measured token savings are
+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.
+
+`simplicio-dev-cli memory init|store|recall` is a markdown + git store under
+`~/.simplicio/memory/` (override with `SIMPLICIO_MEMORY_DIR`) for handing
+context off between agent vendors — a decision stored by one tool is
+recallable by another. Recall is deterministic keyword search, no LLM call,
+no network; real FTS5/vector-hybrid recall is a documented follow-up, not
+claimed here.
+
 **The idea in one line: don't ask the model to guess — hand it the path.**
 Each layer terminates one decision the model would otherwise hallucinate.
 Relevant > complete — inject the *right* context, never *all* of it.
@@ -449,6 +441,45 @@ pip install simplicio-cli           # from PyPI (pulls simplicio-mapper + simpli
 pip install -e .                    # from this repo
 ```
 
+#### Install profiles (extras)
+
+The base install (above) is just the executor/contract/mapper-context/
+edit-verify core — **no PyTorch, no provider SDKs**. Everything else is an
+opt-in extra, picked to match what the code actually imports (#99):
+
+| Extra | Adds | When you need it |
+|---|---|---|
+| *(base)* | `numpy`, `simplicio-mapper`, `simplicio-prompt`, `httpx`, `orjson`, `diskcache`, `libcst` | mechanical edit, mapper handoff, doctor/runtime contracts, `claude-cli`/`codex-cli` shell-out providers, cache/token primitives. `numpy` stays in base because `task`/`run`'s precedent+skill-router cosine-similarity ranking imports it unconditionally — it's lightweight (no GPU/torch), unlike the embedding model itself. |
+| `simplicio-cli[providers]` | `openai`, `anthropic` | native Anthropic models, or any OpenAI-compatible endpoint (OpenRouter, GLM, DeepSeek, ...) via `SIMPLICIO_MODEL`/`SIMPLICIO_BASE_URL`. |
+| `simplicio-cli[ml]` | `sentence-transformers` (pulls PyTorch, ~3 GB) | semantic precedent/skill ranking once cached vectors run out (`all-MiniLM-L6-v2`). |
+| `simplicio-cli[local]` | `llama-cpp-python`, `huggingface-hub` | offline in-process inference (default local GGUF, or any `local-llama/<repo>::<file>` model). |
+| `simplicio-cli[bench]` | `fpdf2` | `bench` command's PDF report. |
+| `simplicio-cli[all]` | union of the four above | everything. |
+
+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
+
+`.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:
+
+```bash
+pip install -e ".[test]"             # base install + pytest (+ tomli on 3.10)
+pytest                               # tests/python + tests/contracts, per pyproject.toml testpaths
+python3 scripts/gen_package_interdependence.py --check  # generated-doc drift gate (#101)
+simplicio-py --help                  # entrypoint smoke (x3)
+simplicio-cli --help
+simplicio-dev-cli --help
+
+pip install -e ".[providers]" && python -c "import openai, anthropic"  # extras coverage
+pip install build twine
+python -m build                      # sdist + wheel
+python -m twine check dist/*         # packaging smoke
+```
+
 The install ships **three Simplicio packages** that play distinct roles:
 
 - **`simplicio-cli`** (this repo) — the 6-layer task contract + verify loop.

simplicio_cli-0.9.3/pyproject.toml

@@ -0,0 +1,215 @@
+[project]
+name = "simplicio-cli"
+version = "0.9.3"
+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" }
+requires-python = ">=3.10"
+authors = [{ name = "Wesley Simplicio", email = "wesleybob4@gmail.com" }]
+keywords = [
+  "llm",
+  "ai",
+  "agent",
+  "code-generation",
+  "prompt-engineering",
+  "openrouter",
+  "openai",
+  "anthropic",
+  "claude",
+  "developer-tools",
+  "cli",
+  "rag",
+  "embeddings",
+  "verify-loop",
+  "task-automation",
+]
+classifiers = [
+  "Development Status :: 4 - Beta",
+  "Environment :: Console",
+  "Intended Audience :: Developers",
+  "License :: OSI Approved :: MIT License",
+  "Operating System :: OS Independent",
+  "Programming Language :: Python :: 3",
+  "Programming Language :: Python :: 3 :: Only",
+  "Programming Language :: Python :: 3.10",
+  "Programming Language :: Python :: 3.11",
+  "Programming Language :: Python :: 3.12",
+  "Topic :: Software Development",
+  "Topic :: Software Development :: Code Generators",
+  "Topic :: Software Development :: Libraries :: Python Modules",
+  "Topic :: Scientific/Engineering :: Artificial Intelligence",
+]
+# Base install is the executor/contract/mapper-context/edit-verify core:
+# mechanical edit, mapper handoff, task/run pipeline (precedent + skill
+# router use numpy for cosine-similarity ranking, but NOT the embedding
+# model itself), doctor/runtime contracts, caching. numpy stays in base
+# (lightweight, no GPU/torch) because it is imported unconditionally by
+# simplicio.cache -> simplicio.precedent/skill_router, which the core
+# `task`/`run` commands import even when no remote/semantic provider is
+# configured. The genuinely heavy ML dependency (sentence-transformers,
+# which pulls PyTorch + CUDA wheels, ~3 GB) moves to the `ml` extra; remote
+# provider SDKs move to `providers`. See docs/PYTHON_PACKAGE_INTERDEPENDENCE.md
+# (generated, `--check`-able) for the full graph and #99 for the audit.
+dependencies = [
+  "numpy>=2.1.0",
+  "simplicio-mapper>=0.16.0",
+  "simplicio-prompt>=1.14.1",
+  "httpx>=0.28.1",
+  "orjson>=3.11.9",
+  "diskcache>=5.6.3",
+  "libcst>=1.8.6",
+]
+
+[project.optional-dependencies]
+# Remote LLM provider SDKs (native Anthropic path + any OpenAI-compatible
+# endpoint: OpenRouter, GLM, DeepSeek, ...). Not needed for claude-cli/
+# codex-cli shell-out providers or the local llama.cpp path.
+providers = ["anthropic>=0.112.0", "openai>=2.44.0"]
+# Semantic precedent/skill ranking (sentence-transformers -> PyTorch). Only
+# needed once `task`/`run` actually reach the embedding path (no cached
+# vectors yet); the numpy-only cosine-similarity math stays in base.
+ml = ["sentence-transformers>=5.6.0"]
+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"]
+all = [
+  "simplicio-cli[providers]",
+  "simplicio-cli[ml]",
+  "simplicio-cli[bench]",
+  "simplicio-cli[local]",
+]
+# 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'"]
+# 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").
+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"
+
+[project.scripts]
+simplicio-cli = "simplicio.cli:main"
+simplicio-py = "simplicio.cli:main"
+simplicio-dev-cli = "simplicio.cli:main"
+
+[build-system]
+requires = ["setuptools>=68", "wheel"]
+build-backend = "setuptools.build_meta"
+
+[tool.setuptools.packages.find]
+where = ["."]
+include = ["simplicio*"]
+
+[tool.setuptools.package-data]
+simplicio = [
+  "py.typed",
+  "templates/*.md",
+  "templates/*.sh",
+  "templates/recipes/**/*.json",
+  "templates/recipes/**/*.yaml",
+  "templates/recipes/**/*.yml",
+  "templates/stacks/**/*",
+  "templates/stacks/*/tree/.gitignore",
+  "templates/stacks/*/tree/.eslintrc.json",
+]
+
+[tool.pytest.ini_options]
+pythonpath = ["."]
+testpaths = ["tests/python", "tests/contracts"]
+
+# --------------------------------------------------------------------------- #
+# Lint / type gate (#102). Dev-only tooling — see the `dev` extra above.
+# Baseline is intentionally permissive (not `mypy --strict`); documented here
+# rather than left implicit so future tightening is a deliberate diff.
+# --------------------------------------------------------------------------- #
+[tool.ruff]
+# 110 rather than the ruff default of 88: several product modules carry
+# long but meaningful lines (URLs, JSON schema literals, long f-strings in
+# provider/pipeline diagnostics) that read worse wrapped than left alone.
+line-length = 110
+target-version = "py310"
+extend-exclude = [
+  "bench",
+  "output",
+  ".simplicio",
+  ".orchestrator",
+  "simplicio/templates",
+]
+
+[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
+# 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;
+# revisit case-by-case with a scoped noqa instead of a blanket ignore.
+ignore = []
+
+[tool.ruff.lint.per-file-ignores]
+# Test modules intentionally shadow fixtures/imports and use long fixtures.
+"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
+# stay covered by the bare T201 rule above with zero suppressions.
+"simplicio/cli.py" = ["T201"]
+"simplicio/doctor.py" = ["T201"]
+"simplicio/init.py" = ["T201"]
+"simplicio/cache_cli.py" = ["T201"]
+"simplicio/bench.py" = ["T201"]
+"simplicio/detect.py" = ["T201"]
+"simplicio/commands/*.py" = ["T201"]
+"simplicio/scratch/cli.py" = ["T201"]
+"simplicio/scratch/skill_opt.py" = ["T201"]
+# Standalone dev/CI scripts outside the `simplicio` package — their stdout
+# is their entire purpose (doc-generator output, demo pipeline summary).
+"scripts/**/*.py" = ["T201"]
+
+[tool.ruff.format]
+quote-style = "double"
+indent-style = "space"
+
+[tool.mypy]
+python_version = "3.10"
+files = ["simplicio"]
+# Baseline rigor (#102 AC): permissive on missing third-party stubs, but
+# real within the package. Tighten per-module (`[[tool.mypy.overrides]]`)
+# once a module's own tests give confidence to raise the bar.
+ignore_missing_imports = true
+warn_redundant_casts = true
+warn_unused_ignores = false
+exclude = ["simplicio/templates/"]
+
+# Legacy-debt allowlist (#102 baseline): these modules predate the mypy gate
+# and lean on dynamic dict/Any shapes (JSON-parsed configs, duck-typed
+# introspection over an optional `libcst`/`cst` dependency, dataclass-ish
+# `object` placeholders) that a real fix means non-trivial refactors, not a
+# quick annotation. Tracked as debt rather than silenced with a blanket
+# `ignore_missing_imports`-style rule repo-wide. New code should NOT be
+# added to this list — annotate it properly instead. Shrink this list as
+# each module gets tightened (see issue #102 follow-up).
+[[tool.mypy.overrides]]
+module = [
+  "simplicio.scratch.codegen.python_cst",
+  "simplicio.scratch.stack_registry",
+  "simplicio.mechanical_edit",
+  "simplicio.orchestrator.cost_governor",
+  "simplicio.scratch.codegen.typescript_next_route",
+  "simplicio.scratch.codegen.python_orm",
+  "simplicio.commands.test_run",
+  "simplicio.cache_cli",
+  "simplicio.precedent",
+  "simplicio.mcp_server",
+  "simplicio.scratch.executor",
+  "simplicio.orchestrator.feature",
+  "simplicio.scratch.cli",
+]
+ignore_errors = true

simplicio_cli-0.9.3/simplicio/__init__.py

@@ -0,0 +1 @@
+__version__ = "0.9.3"

{simplicio_cli-0.9.1 → simplicio_cli-0.9.3}/simplicio/_cache.py

@@ -10,7 +10,7 @@ import tempfile
 import time
 from dataclasses import dataclass, field
 from pathlib import Path
-from typing import Any, Dict, Optional
+from typing import Any
 
 
 def _env_flag(name: str, default: bool) -> bool:
@@ -55,9 +55,9 @@ class CacheEntry:
     provider_id: str = ""
     model: str = ""
     created_at: float = field(default_factory=time.time)
-    metadata: Dict[str, Any] = field(default_factory=dict)
+    metadata: dict[str, Any] = field(default_factory=dict)
 
-    def to_dict(self) -> Dict[str, Any]:
+    def to_dict(self) -> dict[str, Any]:
         return {
             "completion": self.completion,
             "provider_id": self.provider_id,
@@ -67,7 +67,7 @@ class CacheEntry:
         }
 
     @classmethod
-    def from_dict(cls, payload: Dict[str, Any]) -> "CacheEntry":
+    def from_dict(cls, payload: dict[str, Any]) -> CacheEntry:
         return cls(
             completion=str(payload.get("completion", "")),
             provider_id=str(payload.get("provider_id", "")),
@@ -80,20 +80,14 @@ class CacheEntry:
 class CompletionCache:
     def __init__(
         self,
-        root: Optional[Path] = None,
+        root: Path | None = None,
         *,
-        ttl_days: Optional[float] = None,
-        max_mb: Optional[float] = None,
+        ttl_days: float | None = None,
+        max_mb: float | None = None,
     ) -> None:
         self.root = Path(root) if root is not None else _cache_root()
-        self.ttl_days = (
-            ttl_days
-            if ttl_days is not None
-            else _env_float("SIMPLICIO_CACHE_TTL_DAYS", 30)
-        )
-        self.max_mb = (
-            max_mb if max_mb is not None else _env_float("SIMPLICIO_CACHE_MAX_MB", 500)
-        )
+        self.ttl_days = ttl_days if ttl_days is not None else _env_float("SIMPLICIO_CACHE_TTL_DAYS", 30)
+        self.max_mb = max_mb if max_mb is not None else _env_float("SIMPLICIO_CACHE_MAX_MB", 500)
         self.hits = 0
         self.misses = 0
         self.puts = 0
@@ -109,7 +103,7 @@ class CompletionCache:
     def path_for(self, key: str) -> Path:
         return self.root / key[:2] / f"{key}.json"
 
-    def get(self, key: str) -> Optional[CacheEntry]:
+    def get(self, key: str) -> CacheEntry | None:
         if not self.enabled or self.bust:
             self.misses += 1
             return None
@@ -167,7 +161,7 @@ class CompletionCache:
             shutil.rmtree(self.root)
         return int(n)
 
-    def stats(self) -> Dict[str, Any]:
+    def stats(self) -> dict[str, Any]:
         files = list(self._files())
         total_bytes = sum(path.stat().st_size for path in files if path.exists())
         now = time.time()
@@ -182,9 +176,7 @@ class CompletionCache:
             "hits": self.hits,
             "misses": self.misses,
             "puts": self.puts,
-            "hit_rate": round(self.hits / (self.hits + self.misses), 4)
-            if self.hits + self.misses
-            else 0.0,
+            "hit_rate": round(self.hits / (self.hits + self.misses), 4) if self.hits + self.misses else 0.0,
             "bytes": total_bytes,
             "mb": round(total_bytes / (1024 * 1024), 3),
             "oldest_age_s": round(oldest, 3) if oldest is not None else None,
@@ -233,7 +225,7 @@ class CompletionCache:
             return
 
 
-_cache: Optional[CompletionCache] = None
+_cache: CompletionCache | None = None
 
 
 def cache() -> CompletionCache:
@@ -248,11 +240,7 @@ def _is_completion_cache_file(root: Path, path: Path) -> bool:
         rel = path.relative_to(root)
     except ValueError:
         return False
-    return (
-        len(rel.parts) == 2
-        and len(path.stem) == 64
-        and rel.parts[0] == path.stem[:2]
-    )
+    return len(rel.parts) == 2 and len(path.stem) == 64 and rel.parts[0] == path.stem[:2]
 
 
 def reset_for_tests() -> None: