simplicio-cli 0.5.0__tar.gz → 0.5.12__tar.gz

{simplicio_cli-0.5.0 → simplicio_cli-0.5.12}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: simplicio-cli
-Version: 0.5.0
+Version: 0.5.12
 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
@@ -27,21 +27,21 @@ Classifier: Topic :: Scientific/Engineering :: Artificial Intelligence
 Requires-Python: >=3.9
 Description-Content-Type: text/markdown
 License-File: LICENSE
-Requires-Dist: sentence-transformers>=2.2
-Requires-Dist: numpy>=1.23
-Requires-Dist: anthropic>=0.30
-Requires-Dist: openai>=1.30
-Requires-Dist: simplicio-mapper>=0.6.1
-Requires-Dist: simplicio-prompt>=1.12.0
-Requires-Dist: httpx>=0.27
-Requires-Dist: orjson>=3.10
-Requires-Dist: diskcache>=5.6
-Requires-Dist: libcst>=1.8
+Requires-Dist: sentence-transformers>=5.1.2
+Requires-Dist: numpy>=2.0.2
+Requires-Dist: anthropic>=0.105.2
+Requires-Dist: openai>=2.38.0
+Requires-Dist: simplicio-mapper>=0.6.6
+Requires-Dist: simplicio-prompt>=1.12.1
+Requires-Dist: httpx>=0.28.1
+Requires-Dist: orjson>=3.11.5
+Requires-Dist: diskcache>=5.6.3
+Requires-Dist: libcst>=1.8.6
 Provides-Extra: bench
-Requires-Dist: fpdf2>=2.7; extra == "bench"
+Requires-Dist: fpdf2>=2.8.4; extra == "bench"
 Provides-Extra: local
-Requires-Dist: llama-cpp-python>=0.3.2; extra == "local"
-Requires-Dist: huggingface-hub>=0.23; extra == "local"
+Requires-Dist: llama-cpp-python>=0.3.23; extra == "local"
+Requires-Dist: huggingface-hub>=1.8.0; extra == "local"
 Dynamic: license-file
 
 # simplicio-cli
@@ -64,6 +64,23 @@ pip install simplicio-cli
 ```
 
 ---
+## Recommended Default Stack (Official)
+
+The recommended and supported way to use `simplicio-dev-cli` is as part of the full Simplicio execution stack:
+
+**simplicio-dev-cli + simplicio-prompt + agents/skills**
+
+- `simplicio-dev-cli`: 6-layer contract, verification loop, and core task execution.
+- `simplicio-prompt`: Subagent runtime, fan-out, behavior consensus aggregator, and advanced orchestration.
+- **Agents & Skills**: Reusable capabilities from `.skills/`, `.agents/`, and the Simplicio starter (AGENTS.md, specs-as-code, etc.).
+
+This combination is the **official default** across the Simplicio ecosystem. All benchmarks, examples, and documentation assume this full stack.
+
+See the canonical policy:
+- [docs/LLM_USAGE_POLICY.md](docs/LLM_USAGE_POLICY.md)
+
+When bootstrapping a new project with the Simplicio starter, this stack is configured by default.
+
 
 ## Why it works — the numbers
 
@@ -562,7 +579,8 @@ simplicio smoke      # prints provider config + one test call
 simplicio ships an **in-process** backend powered by
 [`llama-cpp-python`](https://github.com/abetlen/llama-cpp-python). When **no
 provider is configured** (`SIMPLICIO_MODEL` *and* `SIMPLICIO_BASE_URL` both
-unset), it runs **Qwen2.5-Coder-1.5B-Instruct (Q5_K_M GGUF)** directly — small,
+unset), it runs **Qwen2.5-Coder-1.5B-Instruct Q8_0 GGUF** directly, falling
+back to **Q6_K_L** if the primary file is unavailable — small,
 code-specialized, fast on CPU, no API key, no Ollama, no HTTP overhead. The
 6-layer contract is what makes a 1.5B usable: it lifts the same model from ~34%
 to ~88% pass-rate on the local benchmark.
@@ -579,7 +597,7 @@ simplicio task "add input validation to createUser" \
 Explicit routes (override the default model/weights):
 
 ```bash
-SIMPLICIO_MODEL=local-llama/default                                  # bundled default
+SIMPLICIO_MODEL=local-llama/default                                  # Q8_0 primary, Q6_K_L fallback
 SIMPLICIO_MODEL=local-llama/bartowski/Qwen2.5-Coder-7B-Instruct-GGUF::Qwen2.5-Coder-7B-Instruct-Q4_K_M.gguf
 SIMPLICIO_MODEL=local-llama//models/my-model.gguf                    # direct local path
 SIMPLICIO_LOCAL_MODEL_PATH=/models/my-model.gguf                     # always wins
@@ -622,6 +640,11 @@ API key from any of the providers above (OpenRouter is the cheapest way to
 try multiple models behind one key), set `SIMPLICIO_API_KEY` +
 `SIMPLICIO_MODEL` + optional `SIMPLICIO_BASE_URL`, run `simplicio task ...`.
 
+**"How do I load `.env.local` safely before running a local API?"** Use
+`eval "$(simplicio env-export .env.local)"` instead of `source .env.local`.
+This preserves values with semicolons, such as PostgreSQL connection strings,
+without executing the dotenv file as shell code.
+
 **"I have Codex CLI / ChatGPT Plus and don't want to pay for an API key."**
 Not auto-wired yet. Workarounds: (a) get an OpenRouter key (~$2 covers
 thousands of tasks at small-model rates), (b) wait for the shell-out provider

{simplicio_cli-0.5.0 → simplicio_cli-0.5.12}/README.md

@@ -18,6 +18,23 @@ pip install simplicio-cli
 ```
 
 ---
+## Recommended Default Stack (Official)
+
+The recommended and supported way to use `simplicio-dev-cli` is as part of the full Simplicio execution stack:
+
+**simplicio-dev-cli + simplicio-prompt + agents/skills**
+
+- `simplicio-dev-cli`: 6-layer contract, verification loop, and core task execution.
+- `simplicio-prompt`: Subagent runtime, fan-out, behavior consensus aggregator, and advanced orchestration.
+- **Agents & Skills**: Reusable capabilities from `.skills/`, `.agents/`, and the Simplicio starter (AGENTS.md, specs-as-code, etc.).
+
+This combination is the **official default** across the Simplicio ecosystem. All benchmarks, examples, and documentation assume this full stack.
+
+See the canonical policy:
+- [docs/LLM_USAGE_POLICY.md](docs/LLM_USAGE_POLICY.md)
+
+When bootstrapping a new project with the Simplicio starter, this stack is configured by default.
+
 
 ## Why it works — the numbers
 
@@ -516,7 +533,8 @@ simplicio smoke      # prints provider config + one test call
 simplicio ships an **in-process** backend powered by
 [`llama-cpp-python`](https://github.com/abetlen/llama-cpp-python). When **no
 provider is configured** (`SIMPLICIO_MODEL` *and* `SIMPLICIO_BASE_URL` both
-unset), it runs **Qwen2.5-Coder-1.5B-Instruct (Q5_K_M GGUF)** directly — small,
+unset), it runs **Qwen2.5-Coder-1.5B-Instruct Q8_0 GGUF** directly, falling
+back to **Q6_K_L** if the primary file is unavailable — small,
 code-specialized, fast on CPU, no API key, no Ollama, no HTTP overhead. The
 6-layer contract is what makes a 1.5B usable: it lifts the same model from ~34%
 to ~88% pass-rate on the local benchmark.
@@ -533,7 +551,7 @@ simplicio task "add input validation to createUser" \
 Explicit routes (override the default model/weights):
 
 ```bash
-SIMPLICIO_MODEL=local-llama/default                                  # bundled default
+SIMPLICIO_MODEL=local-llama/default                                  # Q8_0 primary, Q6_K_L fallback
 SIMPLICIO_MODEL=local-llama/bartowski/Qwen2.5-Coder-7B-Instruct-GGUF::Qwen2.5-Coder-7B-Instruct-Q4_K_M.gguf
 SIMPLICIO_MODEL=local-llama//models/my-model.gguf                    # direct local path
 SIMPLICIO_LOCAL_MODEL_PATH=/models/my-model.gguf                     # always wins
@@ -576,6 +594,11 @@ API key from any of the providers above (OpenRouter is the cheapest way to
 try multiple models behind one key), set `SIMPLICIO_API_KEY` +
 `SIMPLICIO_MODEL` + optional `SIMPLICIO_BASE_URL`, run `simplicio task ...`.
 
+**"How do I load `.env.local` safely before running a local API?"** Use
+`eval "$(simplicio env-export .env.local)"` instead of `source .env.local`.
+This preserves values with semicolons, such as PostgreSQL connection strings,
+without executing the dotenv file as shell code.
+
 **"I have Codex CLI / ChatGPT Plus and don't want to pay for an API key."**
 Not auto-wired yet. Workarounds: (a) get an OpenRouter key (~$2 covers
 thousands of tasks at small-model rates), (b) wait for the shell-out provider

{simplicio_cli-0.5.0 → simplicio_cli-0.5.12}/pyproject.toml

@@ -1,6 +1,6 @@
 [project]
 name = "simplicio-cli"
-version = "0.5.0"
+version = "0.5.12"
 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" }
@@ -41,23 +41,23 @@ classifiers = [
   "Topic :: Scientific/Engineering :: Artificial Intelligence",
 ]
 dependencies = [
-  "sentence-transformers>=2.2",
-  "numpy>=1.23",
-  "anthropic>=0.30",
-  "openai>=1.30",
-  "simplicio-mapper>=0.6.1",
-  "simplicio-prompt>=1.12.0",
-  "httpx>=0.27",
-  "orjson>=3.10",
-  "diskcache>=5.6",
-  "libcst>=1.8",
+  "sentence-transformers>=5.1.2",
+  "numpy>=2.0.2",
+  "anthropic>=0.105.2",
+  "openai>=2.38.0",
+  "simplicio-mapper>=0.6.6",
+  "simplicio-prompt>=1.12.1",
+  "httpx>=0.28.1",
+  "orjson>=3.11.5",
+  "diskcache>=5.6.3",
+  "libcst>=1.8.6",
 ]
 
 [project.optional-dependencies]
-bench = ["fpdf2>=2.7"]
+bench = ["fpdf2>=2.8.4"]
 # Offline-first in-process inference (Path 4). Pulls the llama.cpp Python
 # bindings plus huggingface-hub to fetch the default Qwen2.5-Coder-1.5B GGUF.
-local = ["llama-cpp-python>=0.3.2", "huggingface-hub>=0.23"]
+local = ["llama-cpp-python>=0.3.23", "huggingface-hub>=1.8.0"]
 
 [project.urls]
 Homepage = "https://github.com/wesleysimplicio/simplicio-cli"

simplicio_cli-0.5.12/simplicio/__init__.py

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

{simplicio_cli-0.5.0 → simplicio_cli-0.5.12}/simplicio/_cache.py

@@ -196,7 +196,11 @@ class CompletionCache:
         try:
             if not self.root.exists():
                 return []
-            return [path for path in self.root.rglob("*.json") if path.is_file()]
+            return [
+                path
+                for path in self.root.rglob("*.json")
+                if path.is_file() and _is_completion_cache_file(self.root, path)
+            ]
         except OSError:
             return []
 
@@ -239,6 +243,18 @@ def cache() -> CompletionCache:
     return _cache
 
 
+def _is_completion_cache_file(root: Path, path: Path) -> bool:
+    try:
+        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]
+    )
+
+
 def reset_for_tests() -> None:
     global _cache
     _cache = None

{simplicio_cli-0.5.0 → simplicio_cli-0.5.12}/simplicio/bench.py

@@ -13,10 +13,12 @@ import os, json, time, subprocess
 from .observability import estimate_tokens, log_run
 from .prompt import build_prompt
 from .providers import generate
+from .runtime_env import wrap_project_command
 
 def _test(output, root, test_cmd):
     os.makedirs(os.path.join(root, ".simplicio"), exist_ok=True)
     open(os.path.join(root, ".simplicio/bench_out.txt"), "w").write(output or "")
+    test_cmd = wrap_project_command(root, test_cmd)
     p = subprocess.run(test_cmd, shell=True, cwd=root, capture_output=True, text=True)
     return p.returncode == 0
 

simplicio_cli-0.5.12/simplicio/cache_cli.py

@@ -0,0 +1,68 @@
+"""cache_cli.py — `simplicio cache` subcommand (stats / clear).
+
+Lightweight management surface for the content-addressed completion cache
+landed by issue #34.
+
+  simplicio cache stats            print hit/miss/size/oldest
+  simplicio cache clear            wipe cache directory
+  simplicio cache stats --json     machine-readable
+"""
+from __future__ import annotations
+
+import argparse
+import json
+import sys
+
+from ._cache import cache
+
+
+def _cmd_stats(args: argparse.Namespace) -> int:
+    s = cache().stats()
+    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,
+        }, indent=2))
+        return 0
+    print(f"simplicio 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")
+    return 0
+
+
+def _cmd_clear(args: argparse.Namespace) -> int:
+    if not args.force:
+        print("[cache] refusing to clear without --force; "
+              "this removes every cached completion.", file=sys.stderr)
+        return 2
+    removed = cache().clear()
+    print(f"[cache] cleared {removed} entries", file=sys.stderr)
+    return 0
+
+
+def main(argv: list[str] | None = None) -> int:
+    p = argparse.ArgumentParser(prog="simplicio cache")
+    sub = p.add_subparsers(dest="verb", required=True)
+
+    ps = sub.add_parser("stats", help="show cache size/age/state")
+    ps.add_argument("--json", action="store_true")
+
+    pc = sub.add_parser("clear", help="remove every cached completion")
+    pc.add_argument("--force", action="store_true",
+                    help="required: confirm destructive op")
+
+    args = p.parse_args(argv)
+    if args.verb == "stats":
+        return _cmd_stats(args)
+    if args.verb == "clear":
+        return _cmd_clear(args)
+    return 2