simplicio-loop 3.43.8__tar.gz → 3.43.10__tar.gz

{simplicio_loop-3.43.8/simplicio_loop.egg-info → simplicio_loop-3.43.10}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: simplicio-loop
-Version: 3.43.8
+Version: 3.43.10
 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
@@ -21,10 +21,10 @@ 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.10
-Requires-Dist: simplicio-mapper<0.27,>=0.26.26
-Requires-Dist: simplicio-fast<3,>=2.0.28
-Requires-Dist: simplicio-prompt<1.15,>=1.14.3
+Requires-Dist: simplicio-cli<0.19,>=0.18.12
+Requires-Dist: simplicio-mapper<0.27,>=0.26.29
+Requires-Dist: simplicio-fast<3,>=2.0.31
+Requires-Dist: simplicio-prompt<1.15,>=1.14.4
 Requires-Dist: tiktoken<1,>=0.12.0
 Provides-Extra: dev
 Requires-Dist: setuptools>=77; extra == "dev"

{simplicio_loop-3.43.8 → simplicio_loop-3.43.10}/pyproject.toml

@@ -4,7 +4,7 @@ build-backend = "setuptools.build_meta"
 
 [project]
 name = "simplicio-loop"
-version = "3.43.8"
+version = "3.43.10"
 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"
@@ -31,10 +31,10 @@ classifiers = [
 # closure.
 dependencies = [
   # Loop is the aggregate distribution. Keep one tested component train.
-  "simplicio-cli>=0.18.10,<0.19",
-  "simplicio-mapper>=0.26.26,<0.27",
-  "simplicio-fast>=2.0.28,<3",
-  "simplicio-prompt>=1.14.3,<1.15",
+  "simplicio-cli>=0.18.12,<0.19",
+  "simplicio-mapper>=0.26.29,<0.27",
+  "simplicio-fast>=2.0.31,<3",
+  "simplicio-prompt>=1.14.4,<1.15",
   "tiktoken>=0.12.0,<1",
 ]
 

{simplicio_loop-3.43.8 → simplicio_loop-3.43.10}/simplicio_loop/__init__.py

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

{simplicio_loop-3.43.8 → simplicio_loop-3.43.10}/simplicio_loop/_bundle/scripts/coordinator.py

@@ -31,6 +31,11 @@ Verbs:
               Every issue additionally gets a `duplicate_risk` flag: true when 2+ distinct branches
               posted a claim for the SAME issue within --collision-window-hours of each other with
               no merge in between (the exact `finding_collector.py` vs `findings.py` scenario).
+
+              `VERIFY_PARTIAL` is residual verification of an issue with historical merged delivery; it
+              does not claim active delivery ownership. After the remaining ACs are re-queried and a
+              focused continuation is authorized, a new real claim may proceed. The result also exposes
+              `historical_merged_pr` and `active_delivery_pr` so callers do not conflate those states.
     survey    Best-effort, network-touching helper: shells out to `gh issue list`/`gh issue view`/
               `gh pr list` for --repo and writes a snapshot JSON `decide` can consume. Fail-open: if
               `gh` is missing/unauthenticated, prints an UNVERIFIED stub and exits 0 (the decision
@@ -107,27 +112,67 @@ def extract_claims(comments):
     return claims
 
 
+def _canonical_issue_number(value):
+    """Return a positive canonical issue integer, or None for malformed input."""
+    if isinstance(value, bool):
+        return None
+    if isinstance(value, int):
+        return value if value > 0 else None
+    if isinstance(value, str):
+        text = value.strip()
+        if re.fullmatch(r"[1-9]\d*", text):
+            return int(text)
+    return None
+
+
+def _references_issue(issue_number, text):
+    """Match a GitHub issue reference without treating a larger number as this issue."""
+    canonical = _canonical_issue_number(issue_number)
+    return re.search(rf"(?<!\d)#{canonical}(?!\d)", text or "") is not None if canonical else False
+
+
 def has_merged_pr_referencing(issue_number, prs, after_ts=0.0):
-    """True if any PR in `prs` is MERGED, its body references #issue_number, and (optionally)
-    it merged after `after_ts` — used to tell 'delivered since the claim' from 'delivered before'."""
-    needle = f"#{issue_number}"
+    """True if any PR in `prs` is MERGED, references the issue, and (optionally) merged after `after_ts`."""
     for pr in prs or []:
         if pr.get("state") != "MERGED":
             continue
-        body = pr.get("body") or ""
-        title = pr.get("title") or ""
-        if needle in body or needle in title:
+        if _references_issue(issue_number, pr.get("body") or "") or _references_issue(
+                issue_number, pr.get("title") or ""):
             merged_ts = _parse_ts(_field(pr, "merged_at", "mergedAt"))
             if merged_ts >= after_ts:
                 return True
     return False
 
 
+def has_active_delivery_pr_referencing(issue_number, prs):
+    """True when an OPEN PR references the issue; merged PRs are historical evidence only."""
+    for pr in prs or []:
+        if str(pr.get("state") or "").upper() != "OPEN":
+            continue
+        if _references_issue(issue_number, pr.get("body") or "") or _references_issue(
+                issue_number, pr.get("title") or ""):
+            return True
+    return False
+
+
 def decide_for_issue(issue_number, comments, prs, self_branch,
                       stale_hours=DEFAULT_STALE_HOURS,
                       collision_window_hours=DEFAULT_COLLISION_WINDOW_HOURS,
                       now=None):
     now = now if now is not None else time.time()
+    canonical_issue = _canonical_issue_number(issue_number)
+    if canonical_issue is None:
+        return {
+            "issue": issue_number,
+            "action": "INVALID_INPUT",
+            "reason": "issue number must be a positive integer",
+            "duplicate_risk": False,
+            "claims": [],
+            "has_merged_pr": False,
+            "historical_merged_pr": False,
+            "active_delivery_pr": False,
+        }
+    issue_number = canonical_issue
     claims = extract_claims(comments)
     any_merged_pr = has_merged_pr_referencing(issue_number, prs)
 
@@ -180,7 +225,10 @@ def decide_for_issue(issue_number, comments, prs, self_branch,
         "reason": reason,
         "duplicate_risk": duplicate_risk,
         "claims": [{"branch": b, "ts": t} for b, t in claims],
+        # Compatibility field: a merged PR is historical evidence, not active ownership.
         "has_merged_pr": any_merged_pr,
+        "historical_merged_pr": any_merged_pr,
+        "active_delivery_pr": has_active_delivery_pr_referencing(issue_number, prs),
     }
 
 
@@ -220,7 +268,14 @@ def cmd_survey(opts):
         print("UNVERIFIED|coordinator survey: --repo and --issues are required")
         return 2
     try:
-        issue_numbers = [int(x.strip()) for x in issue_numbers_raw.split(",") if x.strip()]
+        issue_numbers = []
+        for raw_number in issue_numbers_raw.split(","):
+            if not raw_number.strip():
+                continue
+            number = _canonical_issue_number(raw_number)
+            if number is None:
+                raise ValueError
+            issue_numbers.append(number)
     except ValueError:
         print("UNVERIFIED|coordinator survey: --issues must be a comma-separated list of integers")
         return 2

{simplicio_loop-3.43.8 → simplicio_loop-3.43.10}/simplicio_loop/_bundle/scripts/loop_journal.py

@@ -473,7 +473,48 @@ def _emit_loop_observability(rec, wrote, duration_ms):
         pass
 
 
+def _record_validation_errors(opts):
+    """Validate record inputs before any journal or progress path is created."""
+    errors = []
+    known = {
+        "iteration", "action", "hypothesis", "gate", "gate-output", "note",
+        "execution-state", "stage-id", "source-artifact", "chunk-id", "validator",
+        "decision", "retry-count", "blocked-reason", "next-action", "bh-address",
+        "_commit", "_now", "help",
+    }
+    unknown = sorted(key for key in opts if key not in known)
+    errors.extend("--%s is not a valid record option" % key for key in unknown)
+    iteration = opts.get("iteration")
+    try:
+        parsed_iteration = int(iteration) if iteration is not True and iteration is not None else None
+    except (TypeError, ValueError):
+        parsed_iteration = None
+    if parsed_iteration is None or parsed_iteration < 0:
+        errors.append("--iteration must be a non-negative integer")
+
+    action = opts.get("action")
+    if not isinstance(action, str) or not action.strip():
+        errors.append("--action must be a non-empty string")
+
+    gate = opts.get("gate")
+    if gate not in ("pass", "fail", "blocked"):
+        errors.append("--gate must be one of: pass, fail, blocked")
+
+    gate_output = opts.get("gate-output")
+    if gate == "fail" and gate_output is None:
+        errors.append("--gate-output is required when --gate fail")
+    if gate_output is True or gate_output == "":
+        errors.append("--gate-output must name a file or use - for stdin")
+    elif isinstance(gate_output, str) and gate_output != "-" and not os.path.isfile(gate_output):
+        errors.append("--gate-output file does not exist: %s" % gate_output)
+    return errors
+
+
 def cmd_record(opts):
+    errors = _record_validation_errors(opts)
+    if errors:
+        print("UNVERIFIED|record: invalid arguments: %s" % "; ".join(errors), file=sys.stderr)
+        return 2
     os.makedirs(LOOP_DIR, exist_ok=True)
     started = time.perf_counter()
     rec = _build_record(
@@ -1018,12 +1059,51 @@ def cmd_claims_gate_selftest_fail():
     return untagged > 0
 
 
+_HELP_TEXT = """Usage: python3 scripts/loop_journal.py <command> [options]
+Commands: record, fingerprint, stall, resume, status, since, delegation,
+          claims-gate, suggest, selftest
+Use '<command> --help' for command-specific options. Help never writes loop state.
+"""
+
+_COMMAND_HELP = {
+    "record": """Usage: loop_journal.py record --iteration N --action TEXT --gate pass|fail|blocked [options]
+Required: --iteration, --action, --gate
+Optional: --hypothesis, --gate-output FILE|- and lineage flags.
+""",
+    "fingerprint": """Usage: loop_journal.py fingerprint [--file FILE|--input TEXT]
+""",
+    "stall": """Usage: loop_journal.py stall [--k N] [--format text|json|toon] [--exit-code]
+""",
+    "resume": """Usage: loop_journal.py resume [--k N] [--events-root DIR]
+""",
+    "status": """Usage: loop_journal.py status [--n N]
+""",
+    "since": """Usage: loop_journal.py since
+""",
+    "delegation": """Usage: loop_journal.py delegation
+""",
+    "claims-gate": """Usage: loop_journal.py claims-gate [--check FILE|--file FILE]
+""",
+    "suggest": """Usage: loop_journal.py suggest [options]
+""",
+    "selftest": """Usage: loop_journal.py selftest
+""",
+}
+
+
+def _help_text(sub=None):
+    return _COMMAND_HELP.get(sub, _HELP_TEXT)
+
+
 def _parse(args):
     opts = {}
     i = 0
     while i < len(args):
         a = args[i]
-        if a.startswith("--"):
+        if a in ("-h", "--help"):
+            opts["help"] = True
+            i += 1
+        elif a.startswith("--"):
             key = a[2:]
             if i + 1 < len(args) and not args[i + 1].startswith("--"):
                 opts[key] = args[i + 1]
@@ -1039,8 +1119,11 @@ def _parse(args):
 def main():
     argv = sys.argv[1:]
     if not argv:
-        print(__doc__)
+        print(_help_text(), file=sys.stderr)
         sys.exit(2)
+    if argv[0] in ("-h", "--help"):
+        print(_help_text())
+        sys.exit(0)
     # --describe-cli: emit JSON spec of accepted verbs + flags
     if argv[0] == "--describe-cli":
         import json
@@ -1055,13 +1138,23 @@ def main():
         }))
         sys.exit(0)
     sub, opts = argv[0], _parse(argv[1:])
-    {"record": cmd_record, "fingerprint": cmd_fingerprint, "stall": cmd_stall,
-     "resume": cmd_resume, "status": cmd_status, "since": cmd_since,
-     "delegation": cmd_delegation, "claims-gate": cmd_claims_gate,
-     "suggest": cmd_suggest,
-     "selftest": cmd_selftest}.get(
-        sub, lambda _o: (print("unknown command '%s'. choices: record fingerprint stall resume "
-                               "status since delegation claims-gate suggest selftest" % sub), sys.exit(2)))(opts)
+    if "help" in opts:
+        if sub not in _COMMAND_HELP:
+            print("unknown command '%s'" % sub, file=sys.stderr)
+            sys.exit(2)
+        print(_help_text(sub))
+        sys.exit(0)
+    handler = {"record": cmd_record, "fingerprint": cmd_fingerprint, "stall": cmd_stall,
+               "resume": cmd_resume, "status": cmd_status, "since": cmd_since,
+               "delegation": cmd_delegation, "claims-gate": cmd_claims_gate,
+               "suggest": cmd_suggest, "selftest": cmd_selftest}.get(sub)
+    if handler is None:
+        print("unknown command '%s'. choices: record fingerprint stall resume status since "
+              "delegation claims-gate suggest selftest" % sub)
+        sys.exit(2)
+    result = handler(opts)
+    if isinstance(result, int):
+        sys.exit(result)
 
 
 if __name__ == "__main__":

{simplicio_loop-3.43.8 → simplicio_loop-3.43.10}/simplicio_loop/_bundle/skills/simplicio-loop/SKILL.md

@@ -47,6 +47,8 @@ ones without a recorded human decision.
 - **Review limits:** use one implementation review and one final independent verification, with at
   most two AC-scoped repair rounds. If a blocker remains, stop `BLOCKED` with evidence and ownership
   instead of opening an unbounded review/fix loop.
+
+- **Authorized continuation:** When the coordinator receives an explicit human instruction to continue the same frozen issue and acceptance criteria after this budget stops, record that instruction as the human decision that permits one new bounded continuation epoch. Preserve every prior review, repair, journal, anchor, and provenance record; append the authorization and lineage instead of resetting or deleting history. Set a fresh finite `max_iterations` and keep the review budget finite (at most two AC-scoped repair rounds in the continuation). Do not ask for the same authorization again. A changed goal or AC requires a new human decision; a routine base refresh/rebase or explicitly authorized owner handoff requires re-query, re-anchoring, and re-validation under the existing decision. A changed delivery authority without that handoff requires a new decision. This exception does not relax resource admission, safety, authorization/authentication, integrity/signatures, lease/fence, evidence, required human approvals, host hard limits, or branch protection. Unknown model telemetry remains unknown; its absence is not a blanket blocker.
 - **Ownership and integration:** only the active owner mutates the delivery branch. Reviewers are
   read-only unless ownership is explicitly handed off. Before the first mutation, acquire and
   confirm the cross-session claim/lease/fence against the live source; a stale or conflicting