Metadata-Version: 2.4
Name: simplicio-cli
Version: 0.18.16
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
Project-URL: Homepage, https://github.com/simpletibr/simplicio-loop/tree/main/packages/dev-cli
Project-URL: Repository, https://github.com/simpletibr/simplicio-loop/tree/main/packages/dev-cli
Project-URL: Issues, https://github.com/simpletibr/simplicio-loop/issues
Project-URL: Changelog, https://github.com/simpletibr/simplicio-loop/releases
Keywords: deterministic,verification,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: Programming Language :: Python :: 3.13
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: numpy>=2.1.0
Requires-Dist: simplicio-mapper<0.27,>=0.26.31
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: ml
Requires-Dist: sentence-transformers>=5.6.0; extra == "ml"
Provides-Extra: bench
Requires-Dist: fpdf2>=2.8.7; extra == "bench"
Provides-Extra: performance
Requires-Dist: uvloop>=0.21.0; sys_platform != "win32" and extra == "performance"
Provides-Extra: all
Requires-Dist: simplicio-cli[ml]; extra == "all"
Requires-Dist: simplicio-cli[bench]; 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"
Requires-Dist: ruff>=0.15.8; extra == "dev"
Requires-Dist: mypy>=1.19.1; extra == "dev"
Dynamic: license-file

# simplicio-cli (`simplicio-dev-cli`)

Deterministic task-to-code contract and verification CLI. It never executes or
provisions an LLM: the agent decides the change, and this CLI applies and
verifies it.

## Commands

- `simplicio-dev-cli edit --root <repo> --plan <edit-plan.json> --apply --json`:
  applies a `{"operations": [{"path", "find", "replace"}]}` plan (each `find`
  must match exactly once), then runs a bounded, scoped verification and prints
  one JSON receipt with `mutation_receipt.verification.status`.
- `simplicio-dev-cli test` runs the project's verifier.
- `simplicio-dev-cli capabilities` lists what this install supports.

Part of the `simplicio-loop` monorepo (`packages/dev-cli`). Install for
development with `bash scripts/dev_install.sh` from the repository root.

## What the model sees

The model writes the edit plan and reads back one JSON receipt: files changed,
the plan digest, and the verification result with a short stdout/stderr tail.
It never sees the CLI's internal compile or diff stages.

### Token effect

A change is paid once as the plan, a few find/replace pairs, instead of whole
rewritten files. The receipt keeps only a bounded output tail.

### KV cache effect

The receipt is printed with sorted keys and holds no model-visible prompt text.
Appending it at the end of the conversation leaves the earlier cached prefix
untouched.
