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

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

@@ -1,16 +1,15 @@
 Metadata-Version: 2.4
 Name: simplicio-loop
-Version: 3.38.34
+Version: 3.43.1
 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
+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: License :: OSI Approved :: MIT License
 Classifier: Programming Language :: Python :: 3
 Classifier: Programming Language :: Python :: 3 :: Only
 Classifier: Programming Language :: Python :: 3.11
@@ -22,9 +21,9 @@ 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: simplicio-cli<0.19,>=0.18.10
+Requires-Dist: simplicio-mapper<0.27,>=0.26.20
+Requires-Dist: simplicio-fast<3,>=2.0.28
 Requires-Dist: tiktoken<1,>=0.12.0
 Provides-Extra: dev
 Requires-Dist: pytest>=7; extra == "dev"

{simplicio_loop-3.38.34 → simplicio_loop-3.43.1}/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.1"
 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.10,<0.19",
+  "simplicio-mapper>=0.26.20,<0.27",
+  "simplicio-fast>=2.0.28,<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.1}/simplicio_loop/__init__.py

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

{simplicio_loop-3.38.34 → simplicio_loop-3.43.1}/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.1}/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.1/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.1/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.1/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.1/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.1/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.1/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.1/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.1/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.1/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]

simplicio_loop-3.43.1/simplicio_loop/_bundle/skills/simplicio-fast/references/interfaces.md

@@ -0,0 +1,19 @@
+# Fast interfaces
+
+Fast is an acceleration layer, not canonical project truth. Bind every index and cache result to a Mapper `snapshot_id` and repository revision.
+
+## Selection
+
+Use indexed retrieval for repeated, broad, or latency-sensitive read-only queries. Use direct Mapper survey when the index is stale, absent, corrupt, incomplete, or semantically ambiguous.
+
+## Result integrity
+
+Return evidence paths, score/ranking basis, index schema, cache age, revision, and omissions. A cache hit without freshness proof is `untrusted-cache`.
+
+## Parallelism
+
+Bound batch concurrency and preserve query order. Do not let a fast partial batch appear complete; report per-query status.
+
+## Side effects
+
+Index refresh may write only index/cache state. Fast never edits source files and never substitutes Dev CLI validation.

{simplicio_loop-3.38.34 → simplicio_loop-3.43.1}/simplicio_loop/_bundle/skills/simplicio-learn/SKILL.md

@@ -78,3 +78,21 @@ correct; padding memory with one-offs makes every future load more expensive.
   overrides the safety gates.
 - Memory is governed: bounded size, deduped, evictable. A lesson that turns out wrong is deleted,
   not kept.
+
+<!-- simplicio-global-llm-architecture-rules:start -->
+## Regras arquiteturais globais (obrigatórias)
+
+- Delete diretamente o que está obsoleto; não preserve compatibilidade retroativa,
+  não crie migrações e não deixe fallbacks.
+- Escolha a implementação mais simples para a necessidade atual; sem abstrações
+  preventivas ou configuração desnecessária.
+- Entregue primeiro o mínimo end-to-end e evolua por camadas longas, sem desmontar
+  o que funciona por complexidade inacabada.
+- Mantenha modularidade e separação clara de responsabilidades.
+- Prefira bibliotecas maduras e mantidas; reescreva do zero apenas com motivo
+  técnico explícito.
+- Inspecione as dependências existentes antes de adicionar pacotes ou reimplementar.
+- Tome decisões arquiteturais para o longo prazo; não deixe soluções temporárias.
+- Reutilize padrões validados por produtos maduros; não reinvente a roda.
+
+<!-- simplicio-global-llm-architecture-rules:end -->

{simplicio_loop-3.38.34 → simplicio_loop-3.43.1}/simplicio_loop/_bundle/skills/simplicio-loop/SKILL.md

@@ -110,15 +110,19 @@ the block concise, stable, and free of task-specific details; update the ADR and
 the focused hook tests when changing it.
 
 <!-- SIMPLICIO-LLM-ORIENTATION:BEGIN -->
-Orientação operacional do Loop:
-- Trabalhe somente na tarefa/ACs atuais; faça a menor alteração segura e preserve dirty work e ownership.
-- Use o menor raciocínio suficiente; não mostre raciocínio privado passo a passo; seja conciso.
-- Não faça pesquisa web genérica nem use conectores externos, agentes/subagentes ou LLM local por padrão.
-- Use GitHub/gh somente quando a tarefa exigir estado atual de issue, PR ou release, pois é a fonte de verdade do Loop.
-- Use somente ferramentas locais autorizadas: Mapper/Fast para contexto e Dev CLI/Runtime para edição e verificação.
+Orientação operacional do Loop (MAX SPEED — detail: docs/LLM_MAX_SPEED_ORIENTATION.md):
+- Runtime first: `simplicio loop decide --json`; honor `.simplicio/runtime/loop-decision.json` (não bypass Runtime).
+- Economy-parallel: `simplicio-loop economy apply --json` + `preflight --strict` antes de trabalho autônomo.
+- Hot path: Mapper (scan/handoff) → Fast (understand|plan|apply se up) → dev-cli/edit --plan (STRICT; sem hand-edit).
+- Trabalhe só na tarefa/ACs atuais; menor alteração segura; preserve dirty work, lease e ownership.
+- Paralelismo: 1–3 tasks = direct; >3 = Prism (`arm_drain_prism --slots 0 --batch-size N`, default/min 10); writes serializados; governor físico admite capacity.
+- Gates mínimos que provam o AC; proibido full-repo fmt/test residual, review-panel×3 em metadata, reinstall operators.
+- GitHub/gh só quando a tarefa exigir issue/PR/release (SoT do drain).
+- Use o menor raciocínio suficiente; sem web genérica/subagentes/LLM local por padrão; seja conciso.
 - Não edite com contexto stale, lock ativo, artifacts ausentes ou capacidade não verificada.
-- Rode testes focados; não declare concluído sem evidência desta rodada e gates do Loop.
-- Se houver falha ou ambiguidade, informe o bloqueio real; não invente nem repita a mesma tentativa cegamente.
+- Testes focados; saída com evidência da rodada + tags MEASURED| / UNVERIFIED| (nunca inventar métricas).
+- Fim de mensagem: DONE | NEXT(<1 passo>) | BLOCKED(<código>) — act > narrate.
+- Falha/ambiguidade: bloqueio real; não invente nem repita a mesma tentativa cegamente.
 <!-- SIMPLICIO-LLM-ORIENTATION:END -->
 
 ## Definition of Done (DoD) — mandatory quality gate
@@ -245,13 +249,23 @@ gates, the operator dispatch table): **`references/bound-operators.md`**.
 
 Cloud workers and host adapters are accelerators, not prerequisites. If no cloud
 environment/queue is configured, the queue is unavailable, or Orca is absent, the Loop
-continues with isolated local worktrees and bounded parallelism based on the measured machine
-capacity. `dispatch_operator_batch` admits local tasks through the native
+continues with isolated local worktrees and logically unbounded fan-out; physical workers remain
+governed by measured machine capacity. `dispatch_operator_batch` admits local tasks through the native
 `simplicio_loop.prism_scheduler.PrismScheduler` (dependencies, conflicts, leases, and worker
 budget) and then runs the admitted work concurrently; it does not require a remote worker or
 Orca client. Set `SIMPLICIO_LOOP_LOCAL_FALLBACK=0` only for deployments that explicitly require
 remote claims. A remote task that was accepted is never duplicated locally after a timeout.
 
+### Prism routing and slot policy
+
+The deterministic router uses direct parallelism for one to three tasks. A request with more than
+three tasks activates Prism. When the request does not specify a quantity, the default and minimum
+logical batch is ten tasks per slot; an explicit larger batch is valid and there is no logical upper
+limit on slot count, slot capacity, or Prism waves. This does not disable the physical governor:
+CPU, memory, disk, provider, lease, worktree, and observed worker capacity can delay admission
+without changing the logical plan. Fast is queried from the fresh Mapper snapshot before selecting
+the route, and Runtime is added for native execution, gates, checkpoints, or receipts.
+
 ### Strict mode (force every AI onto the full stack)
 
 Arm once per session / shell before any autonomous work:
@@ -779,3 +793,33 @@ to narrate it. Self-paced runtimes (no hooks) run the same `render --turn-header
 
 Confirm the loop is armed (goal, cap, promise, hook-bound vs self-paced), then start
 iteration 1 immediately.
+
+<!-- simplicio-global-llm-architecture-rules:start -->
+## Regras arquiteturais globais (obrigatórias)
+
+- Delete diretamente o que está obsoleto; não preserve compatibilidade retroativa,
+  não crie migrações e não deixe fallbacks.
+- Escolha a implementação mais simples para a necessidade atual; sem abstrações
+  preventivas ou configuração desnecessária.
+- Entregue primeiro o mínimo end-to-end e evolua por camadas longas, sem desmontar
+  o que funciona por complexidade inacabada.
+- Mantenha modularidade e separação clara de responsabilidades.
+- Prefira bibliotecas maduras e mantidas; reescreva do zero apenas com motivo
+  técnico explícito.
+- Inspecione as dependências existentes antes de adicionar pacotes ou reimplementar.
+- Tome decisões arquiteturais para o longo prazo; não deixe soluções temporárias.
+- Reutilize padrões validados por produtos maduros; não reinvente a roda.
+
+<!-- simplicio-global-llm-architecture-rules:end -->
+
+
+## Runtime integration boundary (normative, 2026-08-05)
+
+Runtime decides whether Loop is active. Mapper and Fast remain separate peer
+decisions, while Dev CLI is nested only under `loop.dev_cli`. A typical active
+implementation path may be `mapper -> fast (when anchored) -> loop.dev_cli ->
+simplicio edit -> validate`; the actual hops remain evidence-driven.
+
+The Loop package remains standalone-capable when Runtime is absent, but that path
+must report degraded Runtime-backed completion rather than claiming Runtime
+activation or consolidated Runtime evidence.

simplicio_loop-3.43.1/simplicio_loop/_bundle/skills/simplicio-loop/references/max-speed-orientation.md

@@ -0,0 +1,10 @@
+# Max-speed orientation (pointer)
+
+Canonical: [`docs/LLM_MAX_SPEED_ORIENTATION.md`](../../../docs/LLM_MAX_SPEED_ORIENTATION.md)
+
+Runtime twin: `simplicio-runtime/docs/LLM_MAX_SPEED_ORIENTATION.md`
+
+Re-fed every loop turn: `SKILL.md` block `SIMPLICIO-LLM-ORIENTATION`.
+
+Economy profile surfaces the same intent as JSON key `llm_orientation` on
+`simplicio-loop economy status --json`.