simplicio-loop 3.36.0__tar.gz → 3.36.1__tar.gz

{simplicio_loop-3.36.0/simplicio_loop.egg-info → simplicio_loop-3.36.1}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: simplicio-loop
-Version: 3.36.0
+Version: 3.36.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

{simplicio_loop-3.36.0 → simplicio_loop-3.36.1}/pyproject.toml

@@ -1,69 +1,69 @@
-[build-system]
-requires = ["setuptools>=68", "wheel"]
-build-backend = "setuptools.build_meta"
-
-[project]
-name = "simplicio-loop"
-version = "3.36.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.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 the operator package (`simplicio-cli`), which exposes
-# `simplicio-dev-cli` and also brings the survey binary `simplicio-mapper` transitively.
-dependencies = [
-  "simplicio-cli>=0.16.1",
-]
-
-# Optional: the real embedding backend for `simplicio-cli semantic --ml` / `simplicio-cli rag --ml`.
-# The native engine itself is stdlib-only; this only enables embedding-based semantic dedup +
-# meaning retrieval. `pip install "simplicio-loop[ml]"`.
-[project.optional-dependencies]
-# Dev/test: the suite ALSO self-runs on bare python3 (`python3 scripts/check.py`), so pytest is
-# only a convenience for nicer output / IDE integration — never required.
-dev = ["pytest>=7", "pytest-cov>=4"]
-ml = ["model2vec>=0.3", "numpy>=1.21"]
-
-[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"
-# issue #286 step 11: the multi-device remote-worker protocol's server + worker + supervisor
-# are genuinely installable binaries, not source that only runs from a git checkout.
-simplicio-remote-queue-server = "simplicio_loop.remote_queue_server_cli:main"
-simplicio-remote-worker = "simplicio_loop.remote_worker_cli:main"
-simplicio-remote-worker-supervisor = "simplicio_loop.remote_worker_supervisor_cli:main"
-
-[tool.setuptools]
-packages = ["simplicio_loop"]
-include-package-data = true
-
-[tool.setuptools.package-data]
-simplicio_loop = ["_bundle/**/*"]
-
-[tool.coverage.run]
-source = ["simplicio_loop"]
-omit = [
-  "simplicio_loop/_bundle/*",
-]
-
-[tool.coverage.report]
-exclude_lines = [
-  "pragma: no cover",
-  "if __name__ == .__main__.:",
-]
+[build-system]
+requires = ["setuptools>=68", "wheel"]
+build-backend = "setuptools.build_meta"
+
+[project]
+name = "simplicio-loop"
+version = "3.36.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.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 the operator package (`simplicio-cli`), which exposes
+# `simplicio-dev-cli` and also brings the survey binary `simplicio-mapper` transitively.
+dependencies = [
+  "simplicio-cli>=0.16.1",
+]
+
+# Optional: the real embedding backend for `simplicio-cli semantic --ml` / `simplicio-cli rag --ml`.
+# The native engine itself is stdlib-only; this only enables embedding-based semantic dedup +
+# meaning retrieval. `pip install "simplicio-loop[ml]"`.
+[project.optional-dependencies]
+# Dev/test: the suite ALSO self-runs on bare python3 (`python3 scripts/check.py`), so pytest is
+# only a convenience for nicer output / IDE integration — never required.
+dev = ["pytest>=7", "pytest-cov>=4"]
+ml = ["model2vec>=0.3", "numpy>=1.21"]
+
+[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"
+# issue #286 step 11: the multi-device remote-worker protocol's server + worker + supervisor
+# are genuinely installable binaries, not source that only runs from a git checkout.
+simplicio-remote-queue-server = "simplicio_loop.remote_queue_server_cli:main"
+simplicio-remote-worker = "simplicio_loop.remote_worker_cli:main"
+simplicio-remote-worker-supervisor = "simplicio_loop.remote_worker_supervisor_cli:main"
+
+[tool.setuptools]
+packages = ["simplicio_loop"]
+include-package-data = true
+
+[tool.setuptools.package-data]
+simplicio_loop = ["_bundle/**/*"]
+
+[tool.coverage.run]
+source = ["simplicio_loop"]
+omit = [
+  "simplicio_loop/_bundle/*",
+]
+
+[tool.coverage.report]
+exclude_lines = [
+  "pragma: no cover",
+  "if __name__ == .__main__.:",
+]

{simplicio_loop-3.36.0 → simplicio_loop-3.36.1}/simplicio_loop/__init__.py

@@ -1,18 +1,18 @@
-"""simplicio-loop — The Universal Looping AI Orchestrator.
-
-A runtime-agnostic super-plugin (7 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.
-"""
-
-# Single source of truth = the package metadata (pyproject `version`); the literal is only a
-# fallback for an editable/source checkout that was never installed. No more version drift.
-try:
-    from importlib.metadata import version as _v, PackageNotFoundError
-
-    try:
-        __version__ = _v("simplicio-loop")
-    except PackageNotFoundError:
-        __version__ = "3.36.0"
-except Exception:  # pragma: no cover
-        __version__ = "3.36.0"
+"""simplicio-loop — The Universal Looping AI Orchestrator.
+
+A runtime-agnostic super-plugin (7 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.
+"""
+
+# Single source of truth = the package metadata (pyproject `version`); the literal is only a
+# fallback for an editable/source checkout that was never installed. No more version drift.
+try:
+    from importlib.metadata import version as _v, PackageNotFoundError
+
+    try:
+        __version__ = _v("simplicio-loop")
+    except PackageNotFoundError:
+        __version__ = "3.36.1"
+except Exception:  # pragma: no cover
+        __version__ = "3.36.1"

simplicio_loop-3.36.1/simplicio_loop/orca_lifecycle.py

@@ -0,0 +1,87 @@
+"""Best-effort Orca Dev worktree-card lifecycle projection.
+
+Orca is a host rather than a second source-of-truth API.  The adapter therefore
+uses the public ``orca worktree`` CLI and scopes every write to the active
+worktree only after ``worktree current`` proves that an Orca context exists.
+Outside Orca this is an explicit no-op, so a local or GitHub-only run cannot
+touch another workspace's card.
+"""
+from __future__ import annotations
+
+import json
+import os
+import subprocess
+from typing import Any, Callable, Dict, Mapping, Sequence
+
+
+ORCA_STATUS_BY_LIFECYCLE = {
+    "DISCOVERED": "todo",
+    "CLAIMED": "in-progress",
+    "PLANNED": "in-progress",
+    "IN_PROGRESS": "in-progress",
+    "VERIFYING": "in-progress",
+    "BLOCKED": "in-progress",
+    "PAUSED_NETWORK": "in-progress",
+    "AWAITING_DECISION": "in-progress",
+    "PR_OPEN": "in-review",
+    "MERGE_READY": "in-review",
+    "MERGED": "completed",
+    "CLOSING": "completed",
+    "CLOSE_PENDING_RECONCILIATION": "in-progress",
+    "CLOSED": "completed",
+    "RELEASED": "completed",
+}
+
+
+def lifecycle_to_orca_status(state: str) -> str:
+    return ORCA_STATUS_BY_LIFECYCLE.get(str(state or "").upper(), "in-progress")
+
+
+def _disabled() -> bool:
+    return str(os.environ.get("SIMPLICIO_LOOP_ORCA_LIFECYCLE_SYNC") or "").strip().lower() in {
+        "0", "false", "no", "off", "legacy",
+    }
+
+
+def _command() -> str:
+    return str(os.environ.get("SIMPLICIO_LOOP_ORCA_COMMAND") or "orca").strip() or "orca"
+
+
+def _run_default(args: Sequence[str]) -> subprocess.CompletedProcess[str]:
+    return subprocess.run([_command(), *args], capture_output=True, text=True, timeout=20)
+
+
+def sync_orca_status(state: Mapping[str, Any], event: Mapping[str, Any], *,
+                     runner: Callable[..., subprocess.CompletedProcess[str]] = _run_default) -> Dict[str, Any]:
+    """Update only the current Orca worktree card, or return an explicit skip."""
+    if _disabled():
+        return {"status": "skipped", "reason": "disabled"}
+    current = runner(["worktree", "current", "--json"])
+    if current.returncode != 0:
+        return {"status": "skipped", "reason": "not_in_orca", "detail": (current.stderr or "").strip()[:240]}
+    try:
+        context = json.loads(current.stdout or "{}")
+    except (TypeError, ValueError):
+        return {"status": "skipped", "reason": "invalid_orca_context"}
+    if not isinstance(context, dict) or not context.get("id"):
+        return {"status": "skipped", "reason": "no_active_worktree"}
+
+    lifecycle = str(event.get("lifecycle_state") or event.get("state") or state.get("phase") or "IN_PROGRESS").upper()
+    status = lifecycle_to_orca_status(lifecycle)
+    run_id = str(state.get("run_id") or "")
+    message = str(event.get("message") or event.get("reason") or "").strip().replace("\n", " ")
+    comment = f"Simplicio Loop — {lifecycle}"
+    if run_id:
+        comment += f" · run {run_id}"
+    if message:
+        comment += f" · {message[:180]}"
+    updated = runner([
+        "worktree", "set", "--worktree", "active", "--comment", comment,
+        "--workspace-status", status, "--json",
+    ])
+    if updated.returncode != 0:
+        return {"status": "failed", "reason": "orca_update_failed", "detail": (updated.stderr or "").strip()[:240]}
+    return {
+        "status": "synced", "worktree_id": str(context.get("id")),
+        "lifecycle_state": lifecycle, "workspace_status": status, "comment": comment,
+    }

{simplicio_loop-3.36.0 → simplicio_loop-3.36.1}/simplicio_loop/runner.py

@@ -20,6 +20,7 @@ from .delivery import (build_delivery_receipt, normalize_delivery_target,
 from .evidence import build_evidence_receipt, redact_sensitive_text
 from .source_state import github_delivery_payload, infer_github_delivery_state
 from . import github_lifecycle as _github_lifecycle
+from .orca_lifecycle import sync_orca_status
 from .source_adapter import GitHubSourceAdapter
 from .task_contract import compile_many, validate_contract
 from .plan_contract import PLAN_SCHEMA, validate_plan
@@ -1155,9 +1156,39 @@ def _record_event(run_dir: Path, state: Dict[str, Any], event: Dict[str, Any],
     _write_json(run_dir / "state.json", state)
     _append_jsonl(run_dir / "events.jsonl", event)
     _sync_github_lifecycle(run_dir, state, event)
+    _sync_orca_lifecycle(run_dir, state, event)
     return state
 
 
+def _sync_orca_lifecycle(run_dir: Path, state: Dict[str, Any], event: Dict[str, Any]) -> None:
+    """Project the same lifecycle event onto the active Orca Dev card.
+
+    Orca is optional and host-local: a missing Orca context is recorded as a
+    typed skip rather than treated as a failed delivery or a reason to touch a
+    different worktree.
+    """
+    lifecycle_state = _github_lifecycle.lifecycle_state_for_phase_event(
+        str(event.get("kind") or event.get("phase") or ""))
+    if not lifecycle_state:
+        return
+    try:
+        receipt = sync_orca_status(
+            state, {**event, "lifecycle_state": lifecycle_state},
+        )
+        _append_jsonl(run_dir / "orca-sync.jsonl", {
+            "run_id": str(state.get("run_id") or ""),
+            "event": str(event.get("kind") or event.get("phase") or ""),
+            **receipt,
+        })
+    except Exception as exc:  # noqa: BLE001 -- optional host integration is fail-open
+        try:
+            _append_jsonl(run_dir / "orca-sync-errors.jsonl", {
+                "run_id": str(state.get("run_id") or ""), "error": str(exc),
+            })
+        except Exception:
+            pass
+
+
 def _github_source_adapter(owner: str, repo: str, *, publish_comment_fn: Callable,
                            outbox_dir: Optional[str | Path] = None) -> GitHubSourceAdapter:
     """One construction point for the #285 `GitHubSourceAdapter` binding runner.py uses,

{simplicio_loop-3.36.0 → simplicio_loop-3.36.1/simplicio_loop.egg-info}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: simplicio-loop
-Version: 3.36.0
+Version: 3.36.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

{simplicio_loop-3.36.0 → simplicio_loop-3.36.1}/simplicio_loop.egg-info/SOURCES.txt

@@ -24,6 +24,7 @@ simplicio_loop/model_registry.py
 simplicio_loop/model_router.py
 simplicio_loop/ops_ledger.py
 simplicio_loop/oracle.py
+simplicio_loop/orca_lifecycle.py
 simplicio_loop/phase_events.py
 simplicio_loop/plan_contract.py
 simplicio_loop/planning_gate.py
@@ -214,6 +215,7 @@ tests/test_ops_ledger_integration.py
 tests/test_oracle_gates_unit.py
 tests/test_oracle_perf_benchmark_unit.py
 tests/test_oracle_source_lifecycle_gate_integration.py
+tests/test_orca_lifecycle_unit.py
 tests/test_orca_preset_integration.py
 tests/test_phase_events_unit.py
 tests/test_plan_contract_unit.py

{simplicio_loop-3.36.0 → simplicio_loop-3.36.1}/tests/test_github_status_sync_unit.py

@@ -25,7 +25,7 @@ class FakeApi:
         self.calls.append(("GRAPHQL", query, variables))
         if query.lstrip().startswith("mutation"):
             return {"updateProjectV2ItemFieldValue": {"projectV2Item": {"id": "item-1"}}}
-        return {"organization": {"projectV2": {
+        return {"repository": {"projectV2": {
             "id": "project-1",
             "fields": {"nodes": [{"id": "status-1", "name": "Status",
                                     "options": [{"id": "todo", "name": "Todo"},
@@ -49,7 +49,8 @@ def test_sync_event_updates_label_and_project_for_any_runtime():
         "action": "created", "issue": {"number": 415}, "comment": {"body": body},
     }, project_number=7, project_owner="acme")
     assert result == {"status": "synced", "issue": 415, "state": "IN_PROGRESS",
-                      "label": "simplicio:status:in_progress", "project_moved": True}
+                      "label": "simplicio:status:in_progress", "project_moved": True,
+                      "project_number": 7, "project_reason": "moved"}
     assert any(call[0] == "GRAPHQL" and str(call[2].get("option")) == "progress"
                for call in api.calls)
 
@@ -72,6 +73,36 @@ def test_issue_close_and_reopen_are_reconciled_without_comments():
     assert reopened["state"] == "IN_PROGRESS"
 
 
+class AutoProjectApi(FakeApi):
+    def graphql(self, query, variables):
+        self.calls.append(("GRAPHQL", query, variables))
+        if "projectsV2" in query:
+            return {"repository": {"projectsV2": {"nodes": [{"number": 9, "title": "repo"}]}}}
+        if "addProjectV2ItemById" in query:
+            return {"addProjectV2ItemById": {"item": {"id": "item-added"}}}
+        if "issue(number" in query:
+            return {"repository": {"issue": {"id": "issue-1"}}}
+        if query.lstrip().startswith("mutation"):
+            return {"updateProjectV2ItemFieldValue": {"projectV2Item": {"id": "item-added"}}}
+        return {"repository": {"projectV2": {
+            "id": "project-1",
+            "fields": {"nodes": [{"id": "status-1", "name": "Status",
+                                    "options": [{"id": "progress", "name": "In Progress"}]}]},
+            "items": {"nodes": []},
+        }}}
+
+
+def test_sync_event_discovers_repo_project_and_adds_missing_issue():
+    api = AutoProjectApi()
+    body = "| Estado | IN_PROGRESS |\n" + LIFECYCLE_MARKER
+    result = sync_event(api, "acme/repo", "issue_comment", {
+        "action": "created", "issue": {"number": 415}, "comment": {"body": body},
+    })
+    assert result["project_number"] == 9
+    assert result["project_moved"] is True
+    assert any("addProjectV2ItemById" in call[1] for call in api.calls if call[0] == "GRAPHQL")
+
+
 if __name__ == "__main__":
     import pytest
     raise SystemExit(pytest.main([__file__, "-q"]))

simplicio_loop-3.36.1/tests/test_orca_lifecycle_unit.py

@@ -0,0 +1,44 @@
+from __future__ import annotations
+
+import json
+import subprocess
+
+from simplicio_loop.orca_lifecycle import lifecycle_to_orca_status, sync_orca_status
+
+
+def _completed(returncode=0, stdout="", stderr=""):
+    return subprocess.CompletedProcess(["orca"], returncode, stdout, stderr)
+
+
+def test_lifecycle_status_mapping_is_stable():
+    assert lifecycle_to_orca_status("PR_OPEN") == "in-review"
+    assert lifecycle_to_orca_status("MERGED") == "completed"
+    assert lifecycle_to_orca_status("BLOCKED") == "in-progress"
+
+
+def test_sync_updates_only_active_orca_worktree():
+    calls = []
+
+    def runner(args):
+        calls.append(args)
+        if args[:3] == ["worktree", "current", "--json"]:
+            return _completed(stdout=json.dumps({"id": "wt-1"}))
+        return _completed(stdout="{}")
+
+    result = sync_orca_status(
+        {"run_id": "run-1", "phase": "in_progress"},
+        {"lifecycle_state": "PR_OPEN", "message": "PR criada"},
+        runner=runner,
+    )
+    assert result["status"] == "synced"
+    assert result["workspace_status"] == "in-review"
+    assert calls[-1][0:4] == ["worktree", "set", "--worktree", "active"]
+    assert any("PR_OPEN" in value for value in calls[-1])
+
+
+def test_sync_is_a_typed_noop_outside_orca():
+    result = sync_orca_status(
+        {"run_id": "run-1"}, {"lifecycle_state": "IN_PROGRESS"},
+        runner=lambda args: _completed(returncode=1, stderr="no active worktree"),
+    )
+    assert result == {"status": "skipped", "reason": "not_in_orca", "detail": "no active worktree"}