alissa-tools-github-devloop 0.8.57__py3-none-any.whl → 0.8.58__py3-none-any.whl

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/version

@@ -1 +1 @@
-0.8.57
+0.8.58

{alissa_tools_github_devloop-0.8.57.dist-info → alissa_tools_github_devloop-0.8.58.dist-info}/METADATA

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

{alissa_tools_github_devloop-0.8.57.dist-info → alissa_tools_github_devloop-0.8.58.dist-info}/RECORD

@@ -10,13 +10,13 @@ alissa/tools/github/devloop/hubs.py,sha256=yjnsnSHLG7GNNP8X2hILeAMV6P5n4JGc_IaAx
 alissa/tools/github/devloop/hungtests.py,sha256=TozIDydUe_Kn1m5EtGeGtYt_BrLqGznrNjikLYhxH-Q,24621
 alissa/tools/github/devloop/integration_check.py,sha256=JkFwz3JqOQBIvzszmiql-IMVGSH3lDers6mJUHh9zMM,17928
 alissa/tools/github/devloop/janitor.py,sha256=R8REoHBeY2cfW7fYJVhKr-F5z9Mjlc-vmv-z4KtvBZc,27360
-alissa/tools/github/devloop/loop.py,sha256=Zn_zsOqMq32iQ5XBesTXcDlvqvRFGH_P-31Oi6coXZc,693419
+alissa/tools/github/devloop/loop.py,sha256=zseujnScvwQaQxAQaWZJ7FipwnFddCjwi7sk2MFW5UU,695978
 alissa/tools/github/devloop/loop_events.py,sha256=9b7G2ak69Zm-oc_3IK8PplgOEdBydfER_ZFjKlCJJ5A,38093
 alissa/tools/github/devloop/parking.py,sha256=7h3Gg2XQ0eqlvn0M6K6NeEg9xbqnlUPrZNs9gRofzxc,12410
 alissa/tools/github/devloop/proc.py,sha256=nzfsxJSHFWRQcrXmfv588KazFysv8dVQrhMPH1q5eRk,3134
 alissa/tools/github/devloop/prompts.py,sha256=VzN6ec5eF2wwg7QSCRg52WLcxo-tGbGRgQbc4HSahUc,55169
 alissa/tools/github/devloop/state.py,sha256=uVwhbkogUTjWXXFq-COKzUeYrpuGbHzi05CjfEzAtPA,88668
-alissa/tools/github/devloop/version,sha256=MmZY68HwZt5iLQCJVUOiH7wKDxEJOZCTf-GD5eCddik,7
+alissa/tools/github/devloop/version,sha256=jbJJYfy1NcvGPpw31pt2VRtpDpZ8FX7UhBwTKUK-jFo,7
 alissa/tools/github/devloop/version.py,sha256=znuuOaitXGrBpbskNy78_rlVpFdtmKmk_3k1ACxZrl0,1418
 alissa/tools/github/devloop/webui/__init__.py,sha256=vdXYoyGYzD7BrJ5lV6XdH8Bpw_pej8-RK0hjfxop7-8,1513
 alissa/tools/github/devloop/webui/__main__.py,sha256=wORyW5AkgsniK0TZcrOrvm_P7Q4Mr-fH-4S6qj9XcgA,6137
@@ -25,10 +25,10 @@ alissa/tools/github/devloop/webui/page.py,sha256=4OD3e01ByvVM4Wo04AZyFuyOYTFEMT2
 alissa/tools/github/devloop/webui/server.py,sha256=3aGYGesjUSrPrgcpfy-oYDefBNKnAj3lGfRzwsRkv_I,27031
 alissa/tools/github/devloop/webui/sources.py,sha256=Uw_2B5QGSmW6f66WfVbQb6yLLYmSv6uuF7HNJ5OSr_I,39314
 alissa/tools/github/devloop/webui/sysinfo.py,sha256=ptlogH9alFv0vZ-pQfyUaA3w-K7LQS3tQHGv0d8Tdlk,9649
-alissa_tools_github_devloop-0.8.57.dist-info/licenses/LICENSE,sha256=z8d0m5b2O9McPEK1xHG_dWgUBT6EfBDz6wA0F7xSPTA,11358
-alissa_tools_github_devloop-0.8.57.dist-info/licenses/NOTICE,sha256=FKstNs3uw_tQod4_1XcFLD1FUTJQXf4FC0oXJAOA_HE,260
-alissa_tools_github_devloop-0.8.57.dist-info/METADATA,sha256=htBHtY3IvqJjWIHvAwCEZoOVQ5ChyYG3ovef-4MsP-g,15973
-alissa_tools_github_devloop-0.8.57.dist-info/WHEEL,sha256=a-udL2m4V_6Yn8b-uKzWb12RjRxwwMo6ohYFM24tpaY,91
-alissa_tools_github_devloop-0.8.57.dist-info/entry_points.txt,sha256=8aC7Ajzx4bu9ZRR37a40IDfuStacvZP5KsAxY1dbFKU,145
-alissa_tools_github_devloop-0.8.57.dist-info/top_level.txt,sha256=DodjDg-l-TWQnlxG-Vuc3G5sB4O7cWGQwe6XrVx3u-A,7
-alissa_tools_github_devloop-0.8.57.dist-info/RECORD,,
+alissa_tools_github_devloop-0.8.58.dist-info/licenses/LICENSE,sha256=z8d0m5b2O9McPEK1xHG_dWgUBT6EfBDz6wA0F7xSPTA,11358
+alissa_tools_github_devloop-0.8.58.dist-info/licenses/NOTICE,sha256=FKstNs3uw_tQod4_1XcFLD1FUTJQXf4FC0oXJAOA_HE,260
+alissa_tools_github_devloop-0.8.58.dist-info/METADATA,sha256=VSQAsLRKCHN13_i7eLfVUkYfCy70pxnEIzJc7b2r8yc,15973
+alissa_tools_github_devloop-0.8.58.dist-info/WHEEL,sha256=mOdXR9C3wMVov7cSY8PY-XCzo3SmmWCHvGQr5csJoao,91
+alissa_tools_github_devloop-0.8.58.dist-info/entry_points.txt,sha256=8aC7Ajzx4bu9ZRR37a40IDfuStacvZP5KsAxY1dbFKU,145
+alissa_tools_github_devloop-0.8.58.dist-info/top_level.txt,sha256=DodjDg-l-TWQnlxG-Vuc3G5sB4O7cWGQwe6XrVx3u-A,7
+alissa_tools_github_devloop-0.8.58.dist-info/RECORD,,

{alissa_tools_github_devloop-0.8.57.dist-info → alissa_tools_github_devloop-0.8.58.dist-info}/WHEEL

@@ -1,5 +1,5 @@
 Wheel-Version: 1.0
-Generator: setuptools (84.2.0)
+Generator: setuptools (84.2.1)
 Root-Is-Purelib: true
 Tag: py3-none-any