alissa-tools-github-devloop 0.8.56__tar.gz → 0.8.58__tar.gz

{alissa_tools_github_devloop-0.8.56/src/main/alissa_tools_github_devloop.egg-info → alissa_tools_github_devloop-0.8.58}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: alissa-tools-github-devloop
-Version: 0.8.56
+Version: 0.8.58
 Summary: ALISSA-TOOLS-GITHUB-DEVLOOP
 Home-page: https://alissa.app
 Author: Fahera

{alissa_tools_github_devloop-0.8.56 → alissa_tools_github_devloop-0.8.58}/src/main/alissa/tools/github/devloop/loop.py

@@ -516,6 +516,44 @@ from .state import State
 
 log = logging.getLogger(__name__)
 
+# The criteria-typing rule (issue #194). orcloop ticks only `evidence`
+# criteria when a PR merges, and the soft validator answers "needs a human"
+# for every `human` one -- so a worker that types a FACT ("PR ready for
+# review", "screenshots committed") as `human` parks its task at
+# pending_validation forever (TASK-183426950, PR #2652: 103 fleet tasks piled
+# up and the backlog brake paused every release). The worker picks the type,
+# so the directive must say how: by who can close the criterion. The
+# operator-gate list stays out of the criteria because orcloop already
+# harvests it from the PR body into the origin task's "Needs a look"
+# checklist; copied in, it would turn every unverifiable item into a human
+# criterion again. The legacy type words are deliberately never written here
+# (a test pins their absence from every directive): naming them, even to
+# forbid them, is how they get copied.
+_CRITERIA_RULE = (
+    "Type every validation criterion on your implementation task by WHO CAN "
+    "CLOSE IT, writing the type as exactly one of `evidence`, `check` or "
+    "`human`: `evidence` is the default — it closes from what the PR, the "
+    "delivery note, a merged commit, a test run or a committed file shows "
+    "(orcloop ticks these on merge); `check`, with a `source`, when "
+    "a machine signal names it (`ci:<owner>/<repo>[#<check>]` for \"CI "
+    "green\"); `human` ONLY for a person's judgment (taste, a live phone "
+    "check, a pilot user, a decision) — and then say so in the criterion's "
+    "text. Facts are never `human`: \"PR ready / review requested / approved "
+    "/ merged\", \"tests X pass\", \"screenshots at <path> committed\", "
+    "\"doc section added\", \"delivery note registered\" are all "
+    "`evidence`. Never copy the PR body's \"Not verified — operator's gate\" "
+    "list into task criteria: orcloop harvests it into a \"Needs a look\" "
+    "checklist on the origin task by itself."
+)
+
+# The adopt half: a resumed or fix-round session inherits a task some other
+# session typed, possibly before this rule existed.
+_CRITERIA_ADOPT = (
+    " On a task you ADOPT, retype any criterion that breaks this rule (a fact "
+    "typed `human` becomes `evidence`), and type any criterion you add the "
+    "same way."
+)
+
 # The origin-task instruction is split in two because the downstream rule is
 # the same either way -- only the starting point differs: a present ref is
 # authoritative; an absent one (spawn_anyway / warn_and_spawn) makes locating
@@ -525,6 +563,8 @@ _TASK_WITH_ORIGIN = (
     "implementation task DOWNSTREAM of it (create_downstream_task), and keep "
     "its status honest: in_progress while you work, pending_validation at "
     "handoff."
+    + " "
+    + _CRITERIA_RULE
 )
 
 _TASK_WITHOUT_ORIGIN = (
@@ -532,6 +572,8 @@ _TASK_WITHOUT_ORIGIN = (
     "behind this issue, or create one, then create your implementation task "
     "DOWNSTREAM of it before writing code, and keep its status honest: "
     "in_progress while you work, pending_validation at handoff."
+    + " "
+    + _CRITERIA_RULE
 )
 
 # The resume counterparts. A resumed attempt inherits a PR the dead session
@@ -547,6 +589,9 @@ _RESUME_TASK_WITH_ORIGIN = (
     "in_progress while you work, pending_validation at handoff. Only if the "
     "PR body names none, create your implementation task DOWNSTREAM of the "
     "origin (create_downstream_task) before writing code."
+    + " "
+    + _CRITERIA_RULE
+    + _CRITERIA_ADOPT
 )
 
 _RESUME_TASK_WITHOUT_ORIGIN = (
@@ -555,6 +600,9 @@ _RESUME_TASK_WITHOUT_ORIGIN = (
     "in_progress while you work, pending_validation at handoff); otherwise "
     "locate the origin task behind this issue, or create one, and create "
     "your implementation task DOWNSTREAM of it before writing code."
+    + " "
+    + _CRITERIA_RULE
+    + _CRITERIA_ADOPT
 )
 
 # The delivery note (issue #63). A worker's highest-value output is not the
@@ -1514,6 +1562,9 @@ FIX_DIRECTIVE = (
     "keep its status honest — in_progress while you work, pending_validation "
     "at handoff. If a ref is missing from the PR body, restoring both is part "
     "of your job: the PR body is the canonical cross-actor record. "
+    + _CRITERIA_RULE
+    + _CRITERIA_ADOPT
+    + " "
     "Golden path: your cwd is the repo's worktree hub ROOT and the PR's head "
     "branch `{head_ref}` already exists — re-attach its worktree with `git "
     "worktree add {worktree_dir} {head_ref}` if it is missing (the directory "
@@ -1567,6 +1618,9 @@ FIX_RESUME_DIRECTIVE = (
     "in_progress while you work, pending_validation at handoff. If a ref is "
     "missing from the PR body, restoring both is part of your job: the PR "
     "body is the canonical cross-actor record. "
+    + _CRITERIA_RULE
+    + _CRITERIA_ADOPT
+    + " "
     "FIRST hydrate the context you did not live through: read the PR (body, "
     "commits, and every review thread) and the issue behind it, to see how "
     "far the dead session got. Golden path: your cwd is the repo's worktree "

alissa_tools_github_devloop-0.8.58/src/main/alissa/tools/github/devloop/version

@@ -0,0 +1 @@
+0.8.58

{alissa_tools_github_devloop-0.8.56 → alissa_tools_github_devloop-0.8.58/src/main/alissa_tools_github_devloop.egg-info}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: alissa-tools-github-devloop
-Version: 0.8.56
+Version: 0.8.58
 Summary: ALISSA-TOOLS-GITHUB-DEVLOOP
 Home-page: https://alissa.app
 Author: Fahera

alissa_tools_github_devloop-0.8.56/src/main/alissa/tools/github/devloop/version

@@ -1 +0,0 @@
-0.8.56