simplicio-loop 3.38.34__tar.gz → 3.43.0__tar.gz

{simplicio_loop-3.38.34/simplicio_loop.egg-info → simplicio_loop-3.43.0}/PKG-INFO

@@ -1,95 +1,94 @@
-Metadata-Version: 2.4
-Name: simplicio-loop
-Version: 3.38.34
-Summary: The Universal Looping AI Orchestrator — a runtime-agnostic super-plugin (7 skills) that drains any queue of work end-to-end on any LLM/runtime.
-Author-email: Wesley Simplicio <wesleybob4@gmail.com>
-License: MIT
-Project-URL: Homepage, https://github.com/wesleysimplicio/simplicio-loop
-Project-URL: Repository, https://github.com/wesleysimplicio/simplicio-loop
-Project-URL: Issues, https://github.com/wesleysimplicio/simplicio-loop/issues
-Keywords: ai,agent,orchestrator,llm,claude,cursor,automation,ralph-loop,token-economy,cli
-Classifier: Development Status :: 4 - Beta
-Classifier: Intended Audience :: Developers
-Classifier: License :: OSI Approved :: MIT License
-Classifier: Programming Language :: Python :: 3
-Classifier: Programming Language :: Python :: 3 :: Only
-Classifier: Programming Language :: Python :: 3.11
-Classifier: Programming Language :: Python :: 3.12
-Classifier: Programming Language :: Python :: 3.13
-Classifier: Topic :: Software Development :: Build Tools
-Classifier: Topic :: Utilities
-Classifier: Operating System :: OS Independent
-Requires-Python: >=3.11
-Description-Content-Type: text/markdown
-License-File: LICENSE
-Requires-Dist: simplicio-cli>=0.18.6
-Requires-Dist: simplicio-mapper>=0.26.10
-Requires-Dist: simplicio-fast>=2.0.22
-Requires-Dist: tiktoken<1,>=0.12.0
-Provides-Extra: dev
-Requires-Dist: pytest>=7; extra == "dev"
-Requires-Dist: pytest-cov>=4; extra == "dev"
-Requires-Dist: cryptography<50,>=42; extra == "dev"
-Requires-Dist: jsonschema<5,>=4; extra == "dev"
-Provides-Extra: ml
-Requires-Dist: model2vec>=0.3; extra == "ml"
-Requires-Dist: numpy>=1.21; extra == "ml"
-Provides-Extra: uvloop
-Requires-Dist: uvloop>=0.19; platform_system != "Windows" and extra == "uvloop"
-Dynamic: license-file
-
-# simplicio-loop
-
-**The Universal Looping AI Orchestrator** — a runtime-agnostic **super-plugin** (7 skills) that
-drains any queue of work end-to-end on **any LLM / runtime**:
-`discover → implement → verify → merge → close → watch 24/7`, behind safety gates and evidence
-checks, at up to **96% fewer tokens**. Not a chatbot. A worker.
-
-![simplicio-loop](https://raw.githubusercontent.com/wesleysimplicio/simplicio-loop/main/assets/simplicio-loop-hero-2026.png)
-
-## Install
-
-```bash
-pip install simplicio-loop
-```
-
-Then drop the skills + hooks into your project (or globally):
-
-```bash
-simplicio-loop install            # into ./.claude of the current project
-simplicio-loop install --global   # into ~/.claude (all projects)
-```
-
-Now invoke it from your agent runtime (Claude Code, Cursor, Codex, Gemini, …):
-
-```
-/simplicio-loop finish all the open issues
-```
-
-## What you get — 7 skills
-
-| Skill | What it does |
-|---|---|
-| `simplicio-loop` | Unified public entrypoint: orchestrator core + hardened loop behind one command. |
-| `simplicio-tasks` | Legacy alias kept only for compatibility with older installs and saved prompts. |
-| `simplicio-orient` | Terminal-first token economy — output-reduction catalog, tee-cache, signatures-read. |
-| `simplicio-review` | Adversarial review — parallel subagents on distinct rubrics, deduped into one verdict. |
-| `simplicio-compress` | Output + memory compression, byte-preserving identifiers. |
-| `simplicio-autoresearch` | Evolutionary mutate/eval/keep-revert optimizer — yool-guardrailed caps, git-isolated branch, anti-Goodhart gate-first eval. |
-| `simplicio-learn` | Retrospective — durable, deduped lessons written back to memory. |
-
-## Highlights
-
-- **12 runtimes, one protocol** — Claude Code, Codex, VS Code/Copilot, Cursor, Antigravity, Kiro,
-  OpenCode, Gemini, Aider, Simplicio Agent (formerly Hermes), OpenClaw, Orca.
-- **Evidence-gated completion** — never a false "done"; exits only on a verified `<promise>`,
-  cap, spindle handoff, or STOP.
-- **Token economy** — honest "answer concisely" baseline; savings credited only on verified-correct
-  outcomes.
-
-Requires Python 3.11+. The Loop dependency closure includes `simplicio-fast`,
-`simplicio-mapper`, and `simplicio-cli`; Python 3.11 is therefore the honest
-minimum for an installed bundle. The package remains pure cross-platform Python.
-
-MIT — part of the [Simplicio](https://github.com/wesleysimplicio) ecosystem.
-Full docs: <https://github.com/wesleysimplicio/simplicio-loop>
+Metadata-Version: 2.4
+Name: simplicio-loop
+Version: 3.43.0
+Summary: The Universal Looping AI Orchestrator — a runtime-agnostic super-plugin (7 skills) that drains any queue of work end-to-end on any LLM/runtime.
+Author-email: Wesley Simplicio <wesleybob4@gmail.com>
+License-Expression: MIT
+Project-URL: Homepage, https://github.com/wesleysimplicio/simplicio-loop
+Project-URL: Repository, https://github.com/wesleysimplicio/simplicio-loop
+Project-URL: Issues, https://github.com/wesleysimplicio/simplicio-loop/issues
+Keywords: ai,agent,orchestrator,llm,claude,cursor,automation,ralph-loop,token-economy,cli
+Classifier: Development Status :: 4 - Beta
+Classifier: Intended Audience :: Developers
+Classifier: Programming Language :: Python :: 3
+Classifier: Programming Language :: Python :: 3 :: Only
+Classifier: Programming Language :: Python :: 3.11
+Classifier: Programming Language :: Python :: 3.12
+Classifier: Programming Language :: Python :: 3.13
+Classifier: Topic :: Software Development :: Build Tools
+Classifier: Topic :: Utilities
+Classifier: Operating System :: OS Independent
+Requires-Python: >=3.11
+Description-Content-Type: text/markdown
+License-File: LICENSE
+Requires-Dist: simplicio-cli<0.19,>=0.18.9
+Requires-Dist: simplicio-mapper<0.27,>=0.26.18
+Requires-Dist: simplicio-fast<3,>=2.0.27
+Requires-Dist: tiktoken<1,>=0.12.0
+Provides-Extra: dev
+Requires-Dist: pytest>=7; extra == "dev"
+Requires-Dist: pytest-cov>=4; extra == "dev"
+Requires-Dist: cryptography<50,>=42; extra == "dev"
+Requires-Dist: jsonschema<5,>=4; extra == "dev"
+Provides-Extra: ml
+Requires-Dist: model2vec>=0.3; extra == "ml"
+Requires-Dist: numpy>=1.21; extra == "ml"
+Provides-Extra: uvloop
+Requires-Dist: uvloop>=0.19; platform_system != "Windows" and extra == "uvloop"
+Dynamic: license-file
+
+# simplicio-loop
+
+**The Universal Looping AI Orchestrator** — a runtime-agnostic **super-plugin** (7 skills) that
+drains any queue of work end-to-end on **any LLM / runtime**:
+`discover → implement → verify → merge → close → watch 24/7`, behind safety gates and evidence
+checks, at up to **96% fewer tokens**. Not a chatbot. A worker.
+
+![simplicio-loop](https://raw.githubusercontent.com/wesleysimplicio/simplicio-loop/main/assets/simplicio-loop-hero-2026.png)
+
+## Install
+
+```bash
+pip install simplicio-loop
+```
+
+Then drop the skills + hooks into your project (or globally):
+
+```bash
+simplicio-loop install            # into ./.claude of the current project
+simplicio-loop install --global   # into ~/.claude (all projects)
+```
+
+Now invoke it from your agent runtime (Claude Code, Cursor, Codex, Gemini, …):
+
+```
+/simplicio-loop finish all the open issues
+```
+
+## What you get — 7 skills
+
+| Skill | What it does |
+|---|---|
+| `simplicio-loop` | Unified public entrypoint: orchestrator core + hardened loop behind one command. |
+| `simplicio-tasks` | Legacy alias kept only for compatibility with older installs and saved prompts. |
+| `simplicio-orient` | Terminal-first token economy — output-reduction catalog, tee-cache, signatures-read. |
+| `simplicio-review` | Adversarial review — parallel subagents on distinct rubrics, deduped into one verdict. |
+| `simplicio-compress` | Output + memory compression, byte-preserving identifiers. |
+| `simplicio-autoresearch` | Evolutionary mutate/eval/keep-revert optimizer — yool-guardrailed caps, git-isolated branch, anti-Goodhart gate-first eval. |
+| `simplicio-learn` | Retrospective — durable, deduped lessons written back to memory. |
+
+## Highlights
+
+- **12 runtimes, one protocol** — Claude Code, Codex, VS Code/Copilot, Cursor, Antigravity, Kiro,
+  OpenCode, Gemini, Aider, Simplicio Agent (formerly Hermes), OpenClaw, Orca.
+- **Evidence-gated completion** — never a false "done"; exits only on a verified `<promise>`,
+  cap, spindle handoff, or STOP.
+- **Token economy** — honest "answer concisely" baseline; savings credited only on verified-correct
+  outcomes.
+
+Requires Python 3.11+. The Loop dependency closure includes `simplicio-fast`,
+`simplicio-mapper`, and `simplicio-cli`; Python 3.11 is therefore the honest
+minimum for an installed bundle. The package remains pure cross-platform Python.
+
+MIT — part of the [Simplicio](https://github.com/wesleysimplicio) ecosystem.
+Full docs: <https://github.com/wesleysimplicio/simplicio-loop>

{simplicio_loop-3.38.34 → simplicio_loop-3.43.0}/pyproject.toml

@@ -1,20 +1,19 @@
 [build-system]
-requires = ["setuptools>=68", "wheel"]
+requires = ["setuptools>=77", "wheel"]
 build-backend = "setuptools.build_meta"
 
 [project]
 name = "simplicio-loop"
-version = "3.38.34"
+version = "3.43.0"
 description = "The Universal Looping AI Orchestrator — a runtime-agnostic super-plugin (7 skills) that drains any queue of work end-to-end on any LLM/runtime."
 readme = "PYPI.md"
 requires-python = ">=3.11"
-license = { text = "MIT" }
+license = "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",
   "Programming Language :: Python :: 3.11",
@@ -28,10 +27,10 @@ classifiers = [
 # simplicio-cli's transitive dependency alone: partial/no-deps installations must be diagnosed
 # explicitly and the normal `pip install simplicio-loop` closure must request both distributions.
 dependencies = [
-  # Lower floors only — no upper pins. Prefer latest with `pip install -U`.
-  "simplicio-cli>=0.18.6",
-  "simplicio-mapper>=0.26.10",
-  "simplicio-fast>=2.0.22",
+  # Loop is the aggregate distribution. Keep one tested component train.
+  "simplicio-cli>=0.18.9,<0.19",
+  "simplicio-mapper>=0.26.18,<0.27",
+  "simplicio-fast>=2.0.27,<3",
   "tiktoken>=0.12.0,<1",
 ]
 
@@ -63,13 +62,26 @@ simplicio-remote-worker-supervisor = "simplicio_loop.remote_worker_supervisor_cl
 # issue #516: observability/enforcement CLI for the #498 process-supervisor contract
 # (status/top/queue/cancel/drain/reports over the #514 ProcessSpec/Lease/Result adapter).
 simplicio-process-supervisor = "simplicio_loop.process_enforcement_cli:main"
+simplicio-loop-stack = "simplicio_loop.stack_manifest:main"
+simplicio-capabilities = "simplicio_loop.capability_catalog:main"
+simplicio-route = "simplicio_loop.route:main"
 
 [tool.setuptools]
-packages = ["simplicio_loop"]
 include-package-data = true
 
+[tool.setuptools.packages.find]
+where = ["."]
+include = ["simplicio_loop*"]
+namespaces = true
+
 [tool.setuptools.package-data]
-simplicio_loop = ["_bundle/**/*", "_contracts/**/*.json"]
+simplicio_loop = ["_bundle/**/*", "_contracts/**/*.json", "_catalog/*.json"]
+"simplicio_loop._bundle" = ["**/*"]
+"simplicio_loop._contracts" = ["**/*.json", "*.json"]
+"simplicio_loop._catalog" = ["*.json"]
+
+[tool.setuptools.exclude-package-data]
+"*" = ["**/__pycache__/*", "**/*.py[cod]"]
 
 [tool.coverage.run]
 source = ["simplicio_loop"]

{simplicio_loop-3.38.34 → simplicio_loop-3.43.0}/setup.cfg

@@ -1,4 +1,4 @@
-[egg_info]
-tag_build = 
-tag_date = 0
-
+[egg_info]
+tag_build = 
+tag_date = 0
+

{simplicio_loop-3.38.34 → simplicio_loop-3.43.0}/simplicio_loop/__init__.py

@@ -13,6 +13,6 @@ try:
     try:
         __version__ = _v("simplicio-loop")
     except PackageNotFoundError:
-        __version__ = "3.38.34"
+        __version__ = "3.43.0"
 except Exception:  # pragma: no cover
-    __version__ = "3.38.34"
+    __version__ = "3.43.0"

{simplicio_loop-3.38.34 → simplicio_loop-3.43.0}/simplicio_loop/_bundle/hooks/loop_stop.py

@@ -330,7 +330,13 @@ def _delivery_stop_guard(cwd, iteration):
                 baseline = json.load(handle)
 
         def git(*args):
-            result = subprocess.run(["git", *args], cwd=cwd, capture_output=True, text=True)
+            result = subprocess.run(
+                ["git", *args],
+                cwd=cwd,
+                stdin=subprocess.DEVNULL,
+                capture_output=True,
+                text=True,
+            )
             return result.stdout if result.returncode == 0 else ""
 
         current_head = git("rev-parse", "HEAD").strip()

{simplicio_loop-3.38.34 → simplicio_loop-3.43.0}/simplicio_loop/_bundle/scripts/loop_journal.py

@@ -437,8 +437,45 @@ def _lineage_summary(rec):
     return " | ".join(bits)
 
 
+def _emit_loop_observability(rec, wrote, duration_ms):
+    """Record bounded journal-write metrics without affecting loop semantics."""
+    try:
+        from simplicio_loop.telemetry import TelemetryWriter, metric
+
+        writer = TelemetryWriter.for_component(
+            "loop",
+            root=REPO,
+            project="simplicio-loop",
+            operation="journal_record",
+        )
+        writer.emit(
+            correlation={"run_id": "iteration:%s" % rec.get("iteration", 0)},
+            metrics={
+                "duration_ms": metric(
+                    round(float(duration_ms), 4),
+                    "milliseconds",
+                    "time.perf_counter",
+                ),
+                "journal_written": metric(
+                    1 if wrote else 0,
+                    "count",
+                    "loop_journal.locked_append",
+                ),
+            },
+            labels={
+                "stage": "journal",
+                "status": "passed" if wrote else "failed",
+                "reason_code": "ok" if wrote else "journal_lock_unavailable",
+            },
+        )
+    except Exception:
+        # Observability is explicitly fail-open and never changes the loop verdict.
+        pass
+
+
 def cmd_record(opts):
     os.makedirs(LOOP_DIR, exist_ok=True)
+    started = time.perf_counter()
     rec = _build_record(
         opts,
         _read_source(opts.get("gate-output")),
@@ -450,6 +487,11 @@ def cmd_record(opts):
     # concurrent reader never observes a half-written line. FAIL-OPEN on a lock timeout — the
     # write is SKIPPED (never partial, never unlocked), never silently pretended to have happened.
     wrote = locked_append_line(JOURNAL, json.dumps(rec, ensure_ascii=False))
+    _emit_loop_observability(
+        rec,
+        wrote,
+        (time.perf_counter() - started) * 1000,
+    )
     if not wrote:
         log("UNVERIFIED|record: SKIPPED — could not acquire the journal lock in time")
     log("%srecorded iter=%d gate=%s fp=%s action=%r" % (

simplicio_loop-3.43.0/simplicio_loop/_bundle/skills/simplicio-dev-cli/SKILL.md

@@ -0,0 +1,47 @@
+---
+name: simplicio-dev-cli
+description: Perform deterministic Simplicio code changes and validation through the Dev CLI. Use for file edits, patches, implementation, formatting, tests, diagnostics, pre-effect validation, retries, evidence files, and safe mutation workflows. The agent decides intent; Dev CLI owns the mutation and verification.
+---
+
+# Simplicio Dev CLI
+
+Use Dev CLI as the EXECUTE, EDIT, VALIDATE, and DIAGNOSTICS owner. Survey with Mapper first, then pass a bounded plan and evidence to the CLI. Read `references/capabilities.yaml` and `references/interfaces.md` for exact contracts and failure handling.
+
+## Complete interface map
+
+Generate or refresh the Prism inventory for the installed Dev CLI before using a new command. Require the map to cover CLI commands/subcommands, MCP tools, Python/Rust APIs, configuration, I/O, effects, errors, fallbacks, dependencies, cost, version, and compatibility.
+
+## Routing
+
+- Invoke for `editar`, `implementar`, `corrigir`, `refatorar`, `formatar`, `testar`, `validar`, `diagnosticar`, patching, or applying a plan.
+- Require a repository/key/path scope and pre-effect validation before mutating.
+- Do not manually write the intended diff when the Dev CLI operation exists.
+- Do not claim success from a reported receipt without durable evidence and post-effect validation.
+- On unknown effect, preserve the lock and escalate to Runtime reconciliation when configured.
+
+## Required workflow
+
+1. Accept Mapper snapshot, intent, scope, and constraints.
+2. Validate repository, path, key, and preconditions before effect.
+3. Execute one bounded mutation or validation capability.
+4. Collect stdout, stderr, exit status, diff, tests, and evidence file.
+5. Retry only according to the capability contract; never oscillate blindly.
+6. Return a durable result for Loop or Runtime to reconcile.
+
+## Contract
+
+Return `operation_id`, `snapshot_id`, `pre_effect`, `effect`, `post_effect`, `diff`, `tests`, `evidence_file`, `verdict`, and `retry_history`. Verdicts must distinguish proven, unchanged, failed, and ambiguous/diverged.
+
+## Resources
+
+- `references/capabilities.yaml`: machine-readable capability map.
+- `references/interfaces.md`: mutation, validation, diagnostics, lock, retry, and evidence rules.
+- `scripts/probe-capabilities.py`: validate the capability manifest and detect duplicate IDs.
+
+## Runtime integration boundary (normative, 2026-08-05)
+
+Dev CLI remains independently executable as a package, but Runtime exposes it only
+inside an active Loop route as `loop.dev_cli`. It is never a fourth peer Runtime
+route. A direct Runtime edit uses `simplicio edit` by default; an active Loop may
+use Dev CLI for bounded implementation and validation and delegate the mechanical
+write to that Runtime writer.

simplicio_loop-3.43.0/simplicio_loop/_bundle/skills/simplicio-dev-cli/agents/openai.yaml

@@ -0,0 +1,14 @@
+interface:
+  display_name: Simplicio Dev CLI
+  short_description: Apply and validate deterministic code changes
+  default_prompt: Use @simplicio-dev-cli to edit, validate, test, and diagnose changes
+    through the deterministic CLI contract.
+  icon_small: assets/icon.svg
+  icon_large: assets/icon.svg
+policy:
+  products:
+  - chatgpt
+  - codex
+  - api
+  - atlas
+  allow_implicit_invocation: true

simplicio_loop-3.43.0/simplicio_loop/_bundle/skills/simplicio-dev-cli/assets/icon.svg

@@ -0,0 +1,6 @@
+<svg width="24" height="24" viewBox="0 0 24 24" fill="none" xmlns="http://www.w3.org/2000/svg">
+<path d="M7 20.4524C6.225 20.4524 5.53333 20.2857 4.925 19.9524C4.31667 19.6107 3.84167 19.1357 3.5 18.5274C3.16667 17.9191 3 17.2274 3 16.4524V6.45239C3 5.67739 3.16667 4.98573 3.5 4.37739C3.84167 3.76906 4.31667 3.29823 4.925 2.96489C5.53333 2.62323 6.225 2.45239 7 2.45239H17C17.775 2.45239 18.4667 2.62323 19.075 2.96489C19.6833 3.29823 20.1542 3.76906 20.4875 4.37739C20.8292 4.98573 21 5.67739 21 6.45239V16.4524C21 17.2274 20.8292 17.9191 20.4875 18.5274C20.1542 19.1357 19.6833 19.6107 19.075 19.9524C18.4667 20.2857 17.775 20.4524 17 20.4524H7Z" fill="#4D4D4D"/>
+<path fill-rule="evenodd" clip-rule="evenodd" d="M7.95981 8.77245C8.22487 8.41907 8.72648 8.34735 9.07992 8.6123C9.43319 8.87741 9.50509 9.37903 9.24008 9.73241L7.79965 11.6523L9.24008 13.5723C9.50496 13.9257 9.43325 14.4273 9.07992 14.6924C8.72654 14.9573 8.22491 14.8854 7.95981 14.5322L6.16 12.1328C5.94667 11.8484 5.94667 11.4563 6.16 11.1719L7.95981 8.77245Z" fill="white"/>
+<path fill-rule="evenodd" clip-rule="evenodd" d="M12.6844 8.89452C12.882 8.49943 13.3625 8.33957 13.7577 8.5371C14.1526 8.73474 14.3136 9.21526 14.1161 9.61034L11.7157 14.4101C11.5181 14.8051 11.0375 14.9649 10.6424 14.7676C10.2473 14.57 10.0865 14.0895 10.284 13.6943L12.6844 8.89452Z" fill="white"/>
+<path fill-rule="evenodd" clip-rule="evenodd" d="M15.3202 8.6123C15.6736 8.34741 16.1752 8.41908 16.4403 8.77245L18.2401 11.1719C18.4533 11.4563 18.4534 11.8484 18.2401 12.1328L16.4403 14.5322C16.1753 14.8855 15.6736 14.9571 15.3202 14.6924C14.9667 14.4273 14.8949 13.9257 15.16 13.5723L16.5995 11.6523L15.16 9.73241C14.8949 9.37896 14.9667 8.87738 15.3202 8.6123Z" fill="white"/>
+</svg>

simplicio_loop-3.43.0/simplicio_loop/_bundle/skills/simplicio-dev-cli/references/capabilities.yaml

@@ -0,0 +1,60 @@
+schema_version: 1
+owner: simplicio-dev-cli
+role: mutation-and-validation
+capabilities:
+  - id: dev-cli.preflight
+    intent: [preflight, plan-check, scope-check]
+    inputs: [snapshot_id, repository, scope, plan]
+    outputs: [pre_effect, lock]
+    effects: lock-only
+    requires: [mapper.snapshot-create]
+    verifies: [repo-key-path, preconditions]
+  - id: dev-cli.edit
+    intent: [edit, implement, refactor, fix]
+    inputs: [lock, plan, selected_context]
+    outputs: [diff, operation_id]
+    effects: source-mutation
+    requires: [dev-cli.preflight]
+    verifies: [diff-recorded]
+  - id: dev-cli.patch
+    intent: [patch, apply-change, mechanical-change]
+    inputs: [lock, patch]
+    outputs: [diff, operation_id]
+    effects: source-mutation
+    requires: [dev-cli.preflight]
+    verifies: [patch-applied]
+  - id: dev-cli.command
+    intent: [command, build, format, lint]
+    inputs: [scope, command_policy]
+    outputs: [stdout, stderr, exit_status]
+    effects: declared-command-effect
+    requires: [dev-cli.preflight]
+    verifies: [exit-status]
+  - id: dev-cli.tests
+    intent: [test, pytest, cargo-test, smoke, e2e]
+    inputs: [scope, test_policy]
+    outputs: [test_results, logs]
+    effects: test-artifacts
+    requires: [dev-cli.preflight]
+    verifies: [test-run-recorded]
+  - id: dev-cli.diagnostics
+    intent: [diagnose, ruff, mypy, clippy, coverage, contracts]
+    inputs: [scope, diagnostic_policy]
+    outputs: [findings, logs]
+    effects: diagnostic-artifacts
+    requires: [dev-cli.preflight]
+    verifies: [findings-scoped]
+  - id: dev-cli.evidence
+    intent: [evidence, receipt-input, report]
+    inputs: [operation_id, outputs, logs]
+    outputs: [evidence_file]
+    effects: durable-evidence
+    requires: [dev-cli.edit]
+    verifies: [durability, schema]
+  - id: dev-cli.reconcile
+    intent: [reconcile, unknown-effect, ambiguous]
+    inputs: [operation_id, evidence_file, lock]
+    outputs: [verdict]
+    effects: lock-preserving
+    requires: [dev-cli.evidence]
+    verifies: [unchanged-before, proven-after]

simplicio_loop-3.43.0/simplicio_loop/_bundle/skills/simplicio-dev-cli/references/interfaces.md

@@ -0,0 +1,19 @@
+# Dev CLI interfaces
+
+The agent supplies intent and a bounded plan. Dev CLI owns source mutations, validation, diagnostics, and evidence. Resolve the installed command/API/MCP adapter at runtime; never invent flags.
+
+## Mutation guard
+
+Require repository, key/path, scope, snapshot, and pre-effect validation. Keep a lock or equivalent causal marker for every mutation. Empty or malformed input must not create a false lock.
+
+## Verification
+
+Record diff, command output, exit status, tests, and evidence file. A reported success without durable evidence is not proven.
+
+## Unknown effects
+
+Use `unchanged-before`, `proven-after`, `failed`, or `ambiguous-or-diverged`. Preserve the lock on ambiguity and delegate governed reconciliation to Runtime when available.
+
+## Retry
+
+Retry only the declared transient class and within the capability's limit. Do not repeat a mutation when effect status is unknown.

simplicio_loop-3.43.0/simplicio_loop/_bundle/skills/simplicio-fast/SKILL.md

@@ -0,0 +1,45 @@
+---
+name: simplicio-fast
+description: Accelerate Simplicio retrieval with indexed search, ranking, cache, mmap, and bounded parallel reads. Use for repeated or large context lookups, low-latency symbol/file retrieval, snapshot-backed ranking, and cache-aware discovery. Do not use it as the source of truth or as a file mutation tool.
+---
+
+# Simplicio Fast
+
+Use Fast as an acceleration layer over Mapper's canonical survey data. Prefer it when an index is compatible with the requested repository revision and scope. Read `references/capabilities.yaml` and `references/interfaces.md` before using an unfamiliar operation.
+
+## Complete interface map
+
+Use the generated Prism inventory for the installed Fast release. It records CLI/MCP surfaces, Python/Rust APIs, configuration, I/O, effects, errors, fallbacks, dependencies, measured or unmeasured cost, version, and compatibility. Do not promote an inferred field to a guarantee without evidence.
+
+## Routing
+
+- Invoke for `buscar rápido`, repeated lookup, ranking, large repositories, low latency, cache hits, index queries, or parallel read-only retrieval.
+- Require a compatible Mapper snapshot or explicitly report that the result is unanchored.
+- Never treat a stale cache as current project truth.
+- Never edit files, approve a change, or replace Dev CLI validation.
+- Fall back to Mapper's direct survey when the index is missing, stale, corrupt, or incomplete.
+
+## Required workflow
+
+1. Check repository revision, snapshot, index schema, and freshness.
+2. Normalize the query and choose the narrowest index.
+3. Retrieve and rank bounded results.
+4. Return evidence paths, scores, freshness, and omissions.
+5. Let Mapper or Dev CLI verify semantics before action.
+
+## Contract
+
+Return `snapshot_id`, `index_id`, `query`, `results`, `freshness`, `ranking_basis`, `omissions`, and `fallback_used`. Keep ranking explainable and deterministic for the same inputs.
+
+## Resources
+
+- `references/capabilities.yaml`: machine-readable capability map.
+- `references/interfaces.md`: index, cache, ranking, and fallback rules.
+- `scripts/probe-capabilities.py`: validate the capability manifest and detect duplicate IDs.
+
+## Runtime integration boundary (normative, 2026-08-05)
+
+Runtime selects Fast only when a fresh compatible Mapper artifact/handoff exists or
+when client output is explicitly being transformed into a Mapper/Fast artifact.
+Fast is not the default for an unanchored edit or read, never writes source files,
+and falls back to Mapper when its artifact is stale, missing, corrupt, or incomplete.

simplicio_loop-3.43.0/simplicio_loop/_bundle/skills/simplicio-fast/agents/openai.yaml

@@ -0,0 +1,14 @@
+interface:
+  display_name: Simplicio Fast
+  short_description: Accelerate indexed retrieval and ranking
+  default_prompt: Use @simplicio-fast to retrieve and rank indexed project context
+    with low latency.
+  icon_small: assets/icon.svg
+  icon_large: assets/icon.svg
+policy:
+  products:
+  - chatgpt
+  - codex
+  - api
+  - atlas
+  allow_implicit_invocation: true

simplicio_loop-3.43.0/simplicio_loop/_bundle/skills/simplicio-fast/assets/icon.svg

@@ -0,0 +1,3 @@
+<svg width="24" height="24" viewBox="0 0 24 24" fill="none" xmlns="http://www.w3.org/2000/svg">
+<path d="M11.9125 21.4125C11.5292 21.8625 11.0292 22.0958 10.4125 22.1125C9.79586 22.1291 9.29586 21.9208 8.91252 21.4875C8.53752 21.0541 8.45836 20.4541 8.67503 19.6875L9.68752 16H4.57502C4.00836 16 3.56669 15.8375 3.25002 15.5125C2.93336 15.1791 2.77502 14.7791 2.77502 14.3125C2.77502 13.8375 2.92919 13.4125 3.23752 13.0375L12.1375 2.47497C12.5209 2.02497 13.0209 1.79164 13.6375 1.77497C14.2542 1.75831 14.75 1.96664 15.125 2.39997C15.5084 2.83331 15.5917 3.43331 15.375 4.19997L14.3125 7.99998H19.425C19.9917 7.99998 20.4334 8.16664 20.75 8.49997C21.075 8.83331 21.2375 9.23748 21.2375 9.71247C21.2375 10.1791 21.0792 10.5958 20.7625 10.9625L11.9125 21.4125Z" fill="#FFC93C"/>
+</svg>

simplicio_loop-3.43.0/simplicio_loop/_bundle/skills/simplicio-fast/references/capabilities.yaml

@@ -0,0 +1,53 @@
+schema_version: 1
+owner: simplicio-fast
+role: acceleration
+capabilities:
+  - id: fast.index-open
+    intent: [index, open, load, accelerate]
+    inputs: [snapshot_id, index_schema]
+    outputs: [index_id, freshness]
+    effects: read-only
+    requires: [mapper.snapshot-create]
+    verifies: [schema-match, revision-match]
+  - id: fast.search
+    intent: [search, find, lookup, retrieve]
+    inputs: [index_id, query, scope]
+    outputs: [results, evidence]
+    effects: read-only
+    requires: [fast.index-open]
+    verifies: [result-locations]
+  - id: fast.rank
+    intent: [rank, relevance, similar]
+    inputs: [results, ranking_policy]
+    outputs: [ranked-results, ranking_basis]
+    effects: read-only
+    requires: [fast.search]
+    verifies: [deterministic-order]
+  - id: fast.cache-read
+    intent: [cache, repeated, warm]
+    inputs: [index_id, query_key]
+    outputs: [cached-results, cache_age]
+    effects: read-only
+    requires: [fast.index-open]
+    verifies: [ttl, revision-match]
+  - id: fast.cache-refresh
+    intent: [refresh, invalidate, stale]
+    inputs: [snapshot_id, index_id]
+    outputs: [new_index_id, invalidated_keys]
+    effects: local-index-write
+    requires: [mapper.snapshot-create]
+    verifies: [index-integrity]
+  - id: fast.batch-retrieve
+    intent: [batch, parallel, many-lookups]
+    inputs: [index_id, queries, concurrency_limit]
+    outputs: [per-query-results, omissions]
+    effects: read-only
+    requires: [fast.index-open]
+    verifies: [bounded-concurrency]
+  - id: fast.fallback-survey
+    intent: [fallback, missing-index, degraded]
+    inputs: [repository, revision, query]
+    outputs: [survey-request]
+    effects: none
+    requires: [mapper.project-survey]
+    verifies: [fallback-marked]