simplicio-loop 1.0.3__tar.gz → 1.0.4__tar.gz

{simplicio_loop-1.0.3/simplicio_loop.egg-info → simplicio_loop-1.0.4}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: simplicio-loop
-Version: 1.0.3
+Version: 1.0.4
 Summary: The Universal Looping AI Orchestrator — a runtime-agnostic super-plugin (6 skills) that drains any queue of work end-to-end on any LLM/runtime.
 Author-email: Wesley Simplicio <wesleybob4@gmail.com>
 License: MIT
@@ -19,6 +19,8 @@ Classifier: Operating System :: OS Independent
 Requires-Python: >=3.8
 Description-Content-Type: text/markdown
 License-File: LICENSE
+Requires-Dist: simplicio-mapper
+Requires-Dist: simplicio-cli
 Dynamic: license-file
 
 # simplicio-loop

{simplicio_loop-1.0.3 → simplicio_loop-1.0.4}/pyproject.toml

@@ -1,38 +1,45 @@
-[build-system]
-requires = ["setuptools>=68", "wheel"]
-build-backend = "setuptools.build_meta"
-
-[project]
-name = "simplicio-loop"
-version = "1.0.3"
-description = "The Universal Looping AI Orchestrator — a runtime-agnostic super-plugin (6 skills) that drains any queue of work end-to-end on any LLM/runtime."
-readme = "PYPI.md"
-requires-python = ">=3.8"
-license = { text = "MIT" }
-authors = [{ name = "Wesley Simplicio", email = "wesleybob4@gmail.com" }]
-keywords = ["ai", "agent", "orchestrator", "llm", "claude", "cursor", "automation", "ralph-loop", "token-economy", "cli"]
-classifiers = [
-  "Development Status :: 4 - Beta",
-  "Intended Audience :: Developers",
-  "License :: OSI Approved :: MIT License",
-  "Programming Language :: Python :: 3",
-  "Programming Language :: Python :: 3 :: Only",
-  "Topic :: Software Development :: Build Tools",
-  "Topic :: Utilities",
-  "Operating System :: OS Independent",
-]
-
-[project.urls]
-Homepage = "https://github.com/wesleysimplicio/simplicio-loop"
-Repository = "https://github.com/wesleysimplicio/simplicio-loop"
-Issues = "https://github.com/wesleysimplicio/simplicio-loop/issues"
-
-[project.scripts]
-simplicio-loop = "simplicio_loop.cli:main"
-
-[tool.setuptools]
-packages = ["simplicio_loop"]
-include-package-data = true
-
-[tool.setuptools.package-data]
-simplicio_loop = ["_bundle/**/*"]
+[build-system]
+requires = ["setuptools>=68", "wheel"]
+build-backend = "setuptools.build_meta"
+
+[project]
+name = "simplicio-loop"
+version = "1.0.4"
+description = "The Universal Looping AI Orchestrator — a runtime-agnostic super-plugin (6 skills) that drains any queue of work end-to-end on any LLM/runtime."
+readme = "PYPI.md"
+requires-python = ">=3.8"
+license = { text = "MIT" }
+authors = [{ name = "Wesley Simplicio", email = "wesleybob4@gmail.com" }]
+keywords = ["ai", "agent", "orchestrator", "llm", "claude", "cursor", "automation", "ralph-loop", "token-economy", "cli"]
+classifiers = [
+  "Development Status :: 4 - Beta",
+  "Intended Audience :: Developers",
+  "License :: OSI Approved :: MIT License",
+  "Programming Language :: Python :: 3",
+  "Programming Language :: Python :: 3 :: Only",
+  "Topic :: Software Development :: Build Tools",
+  "Topic :: Utilities",
+  "Operating System :: OS Independent",
+]
+# The simplicio-loop drive REQUIRES two operators (see .claude/skills/simplicio-loop/SKILL.md):
+#   simplicio-mapper -> the repo-survey step (binds `orient`)
+#   simplicio-cli    -> the operator that applies+verifies changes (binds `execute`/`deterministic_edit`)
+dependencies = [
+  "simplicio-mapper",
+  "simplicio-cli",
+]
+
+[project.urls]
+Homepage = "https://github.com/wesleysimplicio/simplicio-loop"
+Repository = "https://github.com/wesleysimplicio/simplicio-loop"
+Issues = "https://github.com/wesleysimplicio/simplicio-loop/issues"
+
+[project.scripts]
+simplicio-loop = "simplicio_loop.cli:main"
+
+[tool.setuptools]
+packages = ["simplicio_loop"]
+include-package-data = true
+
+[tool.setuptools.package-data]
+simplicio_loop = ["_bundle/**/*"]

{simplicio_loop-1.0.3 → simplicio_loop-1.0.4}/simplicio_loop/__init__.py

@@ -1,8 +1,8 @@
-"""simplicio-loop — The Universal Looping AI Orchestrator.
-
-A runtime-agnostic super-plugin (6 skills + loop/token hooks) that drains any
-queue of work end-to-end on any LLM/runtime. This package ships the skills and
-hooks and installs them into a runtime's skills location.
-"""
-
-__version__ = "1.0.3"
+"""simplicio-loop — The Universal Looping AI Orchestrator.
+
+A runtime-agnostic super-plugin (6 skills + loop/token hooks) that drains any
+queue of work end-to-end on any LLM/runtime. This package ships the skills and
+hooks and installs them into a runtime's skills location.
+"""
+
+__version__ = "1.0.3"

{simplicio_loop-1.0.3 → simplicio_loop-1.0.4}/simplicio_loop/_bundle/skills/simplicio-loop/SKILL.md

@@ -21,6 +21,58 @@ the simplicio safety spine (evidence-gated promise, budget kill-switch, cross-pl
 - As the engine for `simplicio-tasks` when it must drain a queue unattended.
 - NOT for a one-shot edit — use the host's normal flow.
 
+## Bound operators (REQUIRED): survey + operate
+
+This loop does NOT survey the repo with the LLM, and it does NOT hand-edit files with the LLM.
+Two installed CLIs are the operators; the model only DECIDES, the operators DO. Both ship as
+hard dependencies of the `simplicio-loop` package (`pip install simplicio-loop` pulls them):
+
+| Operator | CLI (binary) | Binds | Role in the loop |
+|---|---|---|---|
+| **simplicio-mapper** | `simplicio-mapper` | `orient` / `recall` | **Survey** — maps the repo(s) into `.simplicio/*.json` (project-map, precedent-index, symbol-index, call-graph, docs). This survey, not an ad-hoc LLM read, is what feeds the goal each turn. |
+| **simplicio-dev-cli** | `simplicio-dev-cli` | `execute` / `deterministic_edit` / `validate` / `diagnostics` | **Operate** — applies a DECIDED change through its 6-layer contract (mapper context → precedent → prompt → diff → test → verify, ≤3 retries). The CLI edits and verifies; the AI does not hand-write the diff. |
+
+**Preflight (MANDATORY, BLOCKING).** Before iteration 1, confirm both operators are on PATH:
+```bash
+simplicio-mapper --version   # survey operator
+simplicio-dev-cli --help     # action operator (pkg simplicio-cli; exposes `simplicio-dev-cli`)
+```
+The action binary is `simplicio-dev-cli` (from `pip install simplicio-cli`) — NOT the bare
+`simplicio`, which is reserved for the compiled Rust `simplicio-runtime` and is not what this loop
+binds. `simplicio-dev-cli` has no `--version` subcommand; `--help` exiting 0 is the readiness
+proof. If either operator is missing, do NOT fall back to LLM survey/editing — STOP and emit
+`simplicio-loop: BLOCKED — missing operator <name>; run: pip install simplicio-loop` (the install
+re-pulls `simplicio-mapper` + `simplicio-cli`). This requirement is scoped to the loop drive.
+
+**Survey step (each loop start + on any structural change).** Run
+`simplicio-mapper index . --json` (add `--watch` for long runs) to (re)build `.simplicio/`. Read
+the survey artifacts — never re-scan the tree by hand when a fresh map exists. For a multi-repo
+levantamento, run the mapper per repo root and aggregate the JSON.
+
+**Operate step (every turn that mutates code).** Once the AC and the change are DECIDED, delegate
+the mutation to the operator, one decided change at a time:
+```bash
+simplicio-dev-cli task "<the decided, AC-scoped change>" --target <file> [--json]
+```
+The operator applies the diff, runs the tests, and self-corrects up to 3× — its passing
+verification IS the in-turn evidence the promise gate needs (below). The AI never edits the file
+directly inside the loop; if `simplicio-dev-cli` cannot complete a change after its retries, treat that
+as a genuine blocker to investigate, not a reason to hand-edit around it.
+
+**Where each operator fires.** The AI only DECIDES (triage, AC extraction, choosing the change,
+merge/close gates); the operators do survey + apply:
+
+| Phase | Operator | Command |
+|---|---|---|
+| Preflight (before iteration 1) | both | `simplicio-mapper --version` · `simplicio-dev-cli --help` → BLOCK if missing |
+| Survey (loop start; multi-repo: per root) | mapper | `simplicio-mapper index . --json` → `.simplicio/*.json` |
+| Loop contract step 2 — Triage (every turn) | mapper | re-read `.simplicio/*.json`; `simplicio-mapper index . --json` to refresh if the tree changed |
+| Loop contract step 3 — Work the goal | dev-cli | `simplicio-dev-cli task "<decided change>" --target <file> [--json]` |
+| Evidence-gated `<promise>` / `simplicio-tasks` Step 4b | dev-cli | the operator's passing test+verify pass = in-turn evidence |
+
+One turn: `preflight → survey (mapper) → triage (re-read survey) → DECIDE (AI) → operate
+(simplicio-dev-cli task: apply+test+retry ≤3×) → <promise> only if the operator's gate passed`.
+
 ## State file (single source of truth)
 
 `.orchestrator/loop/scratchpad.md` — human-readable, trivially editable/cancellable:
@@ -45,13 +97,17 @@ A sibling flag file `.orchestrator/loop/done` is `touch`ed only when the promise
    `max_iterations` safety net even when the user wants "unlimited" — pair unlimited with the
    `.orchestrator/loop-budget.json` $ kill-switch (see `simplicio-tasks` Step 1a/7).
 2. **Triage the live state FIRST (mandatory).** Before any action each turn, re-read the ground
-   truth — `git status`/`git diff`, the working tree, the scratchpad notes, AND the source of
-   record (re-query the open issues/PRs, existing branches, the `.orchestrator/loop/done` flag).
-   Act only on what is still genuinely open; never redo done work or act on a stale picture
-   (idempotency).
-3. **Work the goal** each turn as if fresh, against that triaged state. End EVERY iteration with
-   a short, concrete verification — one gate / command / `file:line` receipt. Keep iterations
-   small and verifiable: a turn that only edits without verifying is incomplete.
+   truth — the **`simplicio-mapper` survey** (`.simplicio/*.json`; refresh it with
+   `simplicio-mapper index . --json` if the tree changed), `git status`/`git diff`, the working
+   tree, the scratchpad notes, AND the source of record (re-query the open issues/PRs, existing
+   branches, the `.orchestrator/loop/done` flag). Act only on what is still genuinely open; never
+   redo done work or act on a stale picture (idempotency).
+3. **Work the goal** each turn as if fresh, against that triaged state. The model DECIDES the
+   AC-scoped change; the **`simplicio-dev-cli` operator APPLIES and verifies it**
+   (`simplicio-dev-cli task "<change>" --target <file>`) — do not hand-edit inside the loop. End EVERY
+   iteration with a short, concrete verification — the operator's passing test run, or one gate /
+   command / `file:line` receipt. Keep iterations small and verifiable: a turn that only edits
+   without verifying is incomplete.
 4. **Re-feed** happens at turn end via the stop-hook (below). Each re-fed turn is prefixed
    `[simplicio-loop iteration N. To finish: output <promise>TEXT</promise> ONLY when genuinely true.]`.
 5. **Exit** by emitting the sentinel `<promise>EXACT TEXT</promise>` — and ONLY when every
@@ -62,7 +118,8 @@ A sibling flag file `.orchestrator/loop/done` is `touch`ed only when the promise
 The classic Ralph loop trusts the model to be honest. We do not. A `<promise>` is accepted
 only if, in the SAME turn, there is concrete evidence the work is truly done:
 
-- the run-verification gate passed ("works, not just compiles" — `simplicio-tasks` Step 4b), or
+- the run-verification gate passed ("works, not just compiles" — `simplicio-tasks` Step 4b) —
+  the `simplicio-dev-cli` operator's passing test+verify pass (its contract step 5/6) satisfies this, or
 - the named acceptance criteria are each checked with a `file:line` or command-output receipt, or
 - for a queue, the source re-query confirms the items are actually closed/merged.
 

{simplicio_loop-1.0.3 → simplicio_loop-1.0.4}/simplicio_loop/_bundle/skills/simplicio-tasks/SKILL.md

@@ -88,6 +88,12 @@ ABSTRACTION, never a runtime — the INVERTED DEPENDENCY (the skill names no run
 detects the skill). Full table + fallbacks: `references/extension-points.md`. Core rule: any
 DECIDED change goes through `deterministic_edit` — never hand-write or regenerate it with a model.
 
+When the run is driven by `simplicio-loop` (Step 0 auto-arm), two points are bound to REQUIRED
+operators instead of LLM fallbacks: `simplicio-mapper` surveys the repo (`orient`) and
+`simplicio-dev-cli task` applies+verifies each decided change (`execute`/`deterministic_edit`) — the AI
+decides, the operators act. Both ship with `pip install simplicio-loop`; the loop BLOCKS if either
+is absent (see `references/extension-points.md` § bound operators).
+
 ## Step 1b' — Companion skills (the super-plugin satellites)
 simplicio-tasks ships as a super-plugin: this orchestrator + five satellites. Each is the deep,
 standalone form of a discipline; when loaded, DELEGATE to it (richer + cheaper); when absent, the

{simplicio_loop-1.0.3 → simplicio_loop-1.0.4}/simplicio_loop/_bundle/skills/simplicio-tasks/references/extension-points.md

@@ -54,6 +54,20 @@ Rule: any change already DECIDED goes through `deterministic_edit` — never han
 or regenerate it with a model when a mechanical apply exists. Reach for a paid model only for
 genuine reasoning the deterministic layer cannot do (model routing in orchestration.md).
 
+## simplicio-loop's bound operators (REQUIRED for the loop drive)
+
+The `simplicio-loop` companion skill is NOT runtime-optional about two of these points — it binds
+them to two installed CLIs (hard deps of `pip install simplicio-loop`) and BLOCKS if absent:
+
+| Point(s) | Bound CLI | What replaces the LLM fallback |
+|---|---|---|
+| `orient` / `recall` | `simplicio-mapper` (`simplicio-mapper index . --json`) | the repo SURVEY — `.simplicio/*.json` (project-map, precedent-index, symbol-index, call-graph) instead of ad-hoc LLM reads |
+| `execute` / `deterministic_edit` / `validate` / `diagnostics` | `simplicio-dev-cli task` (binary `simplicio-dev-cli`, pkg `simplicio-cli`) | the OPERATOR — applies a decided change via its 6-layer contract (mapper→precedent→prompt→diff→test→verify, ≤3 retries); the AI never hand-writes the diff inside the loop |
+
+This is the one place the abstraction is realized by a REQUIRED binding rather than an optional
+one. Everywhere else the inverted-dependency rule below still holds. See
+`.claude/skills/simplicio-loop/SKILL.md` (§ Bound operators).
+
 A host runtime MAY detect that this skill is running (by name) and auto-bind its native commands
 to these points — transparently, at near-zero token cost — without the skill ever naming that
 runtime. The binding lives in the host runtime, not here. This is the INVERTED DEPENDENCY: the

{simplicio_loop-1.0.3 → simplicio_loop-1.0.4/simplicio_loop.egg-info}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: simplicio-loop
-Version: 1.0.3
+Version: 1.0.4
 Summary: The Universal Looping AI Orchestrator — a runtime-agnostic super-plugin (6 skills) that drains any queue of work end-to-end on any LLM/runtime.
 Author-email: Wesley Simplicio <wesleybob4@gmail.com>
 License: MIT
@@ -19,6 +19,8 @@ Classifier: Operating System :: OS Independent
 Requires-Python: >=3.8
 Description-Content-Type: text/markdown
 License-File: LICENSE
+Requires-Dist: simplicio-mapper
+Requires-Dist: simplicio-cli
 Dynamic: license-file
 
 # simplicio-loop

{simplicio_loop-1.0.3 → simplicio_loop-1.0.4}/simplicio_loop.egg-info/SOURCES.txt

@@ -9,6 +9,7 @@ simplicio_loop.egg-info/PKG-INFO
 simplicio_loop.egg-info/SOURCES.txt
 simplicio_loop.egg-info/dependency_links.txt
 simplicio_loop.egg-info/entry_points.txt
+simplicio_loop.egg-info/requires.txt
 simplicio_loop.egg-info/top_level.txt
 simplicio_loop/_bundle/hooks/hooks.claude.json
 simplicio_loop/_bundle/hooks/hooks.json

simplicio_loop-1.0.4/simplicio_loop.egg-info/requires.txt

@@ -0,0 +1,2 @@
+simplicio-mapper
+simplicio-cli