tickwork 0.3.0__py3-none-any.whl

tickwork-0.3.0.data/data/share/tickwork/examples/pr-loop.states.yaml

@@ -0,0 +1,81 @@
+# The PR loop's states as data: the exactly-one-owner state machine the
+# tickwork workflow engine drives, one entry per state.
+# Load via tickwork.workflow_states.load(); nothing in the loop evaluates
+# these predicates yet (the engine ships them before the loop consumes them).
+#
+# Each state: a predicate over artifacts → (owner, board bucket).
+# `override: true` states are cross-cutting (closed / held by the human /
+# unassigned intake / blocked) and win in listed order. All other predicates
+# must stay disjoint:
+# an item matching zero or 2+ of them is an anomaly, reported by
+# tickwork.workflow_states.check(): nothing in the loop evaluates these
+# predicates yet (the engine ships them before the loop consumes them).
+#
+# Roles are role names (dev, reviewer, planner, verifier) and `human`;
+# the caller maps roles to logins. Never a persona login here.
+
+workflow: pr-loop
+version: 1
+states:
+  done:
+    override: true
+    when: { issue.state: closed }
+    board: done
+    terminal: true
+
+  waiting_on_human:
+    override: true
+    # a merged PR leaves this state even while still assigned to the human,
+    # so a human merge hands off to `verifying` like an automated one
+    when: { any: [ { issue.assignee: human }, { pr.assignee: human, pr.state: open } ] }
+    board: waiting_on_human
+    owner: human
+
+  intake:
+    # the board buckets unassigned open issues here even when they have open
+    # dependencies, so this must win over `blocked`
+    override: true
+    when: { issue.state: open, issue.assignee: none, pr: none }
+    board: intake
+    owner: human               # visibility only; a human or the planner picks it up
+
+  blocked:
+    override: true
+    when: { issue.dependencies: open, not: { issue.assignee: human } }
+    board: blocked
+    owner: human               # unblocking is a manual step; entry assigns the human
+
+  triage:
+    when: { issue.assignee: planner, pr: none }
+    board: queued
+    owner: planner
+
+  ready_for_dev:
+    when: { issue.assignee: dev, pr: none }
+    board: queued
+    owner: dev
+
+  in_review:
+    when: { pr.state: open, pr.requested_reviewers: reviewer, pr.reviewed_on_head: false }
+    board: in_progress
+    owner: reviewer
+
+  revising:
+    when: { pr.state: open, pr.assignee: dev }
+    board: in_progress
+    owner: dev
+
+  merging:
+    when: { pr.state: open, pr.requested_reviewers: reviewer, pr.approved_on_head: true }
+    board: in_progress
+    owner: reviewer
+
+  decomposing:
+    when: { pr.state: open, pr.assignee: planner }
+    board: in_progress
+    owner: planner
+
+  verifying:
+    when: { issue.state: open, pr.state: merged }   # whoever merged
+    board: in_progress
+    owner: verifier

tickwork-0.3.0.dist-info/METADATA

@@ -0,0 +1,9 @@
+Metadata-Version: 2.4
+Name: tickwork
+Version: 0.3.0
+Summary: A generic, instance-neutral workflow engine: states, transitions, sweeps and call replay over a queue of work items
+License: MIT
+Requires-Python: >=3.11
+License-File: LICENSE
+Requires-Dist: PyYAML>=6.0
+Dynamic: license-file

tickwork-0.3.0.dist-info/RECORD

@@ -0,0 +1,18 @@
+tickwork/__init__.py,sha256=jInwTDObOX31-qnQStUZD6m2pAbrYgIc3jBjU488E6Y,466
+tickwork/__main__.py,sha256=edtzJrMhp4TDfL2jhuIpgp-HGAWKPAMZtsOmctkSKns,163
+tickwork/cli.py,sha256=Agjpbn7atXX---PWsavHU5At5TbfpVeU_xA4QrjhHzk,11701
+tickwork/effect_log.py,sha256=MdoPWcqaWdHXkx-fxtHdTPlFHZ2NeO8b5o5feztmfSo,13250
+tickwork/pool.py,sha256=j-ZrJ7tts2tp_vm5XvnbLyyXut9zRz8ADMdJR4hryXA,8576
+tickwork/replay.py,sha256=paQrFR4jRaNqE3rwsxGOhWXwno8satTlPy70RZFzhys,5169
+tickwork/workflow_states.py,sha256=VuI1Kt1dkJnef1U8ZCDOqRBrDIlsuRzjgzphcEhu1UE,8847
+tickwork/providers/__init__.py,sha256=cZ2YRqiZuOnUJxjxYNinWRgn1vVAwaWq4tu_-gurQ_o,351
+tickwork/providers/openai_compat.py,sha256=IFAlDYWegrR2LuZyuCRoqmUI0oc24F0UOYITgu0DTIw,3801
+tickwork-0.3.0.data/data/share/tickwork/examples/items.jsonl,sha256=NRgpQy9W6uD7RYHMjCIpENtuZasAgOtfWZmBZw0r4B8,643
+tickwork-0.3.0.data/data/share/tickwork/examples/logins.yaml,sha256=2Rfqjqbt1TPx-9LcmZhtIQRHGZYrZ_SNC7BmYGbswmU,220
+tickwork-0.3.0.data/data/share/tickwork/examples/pr-loop.states.yaml,sha256=FDLylJikvp1X3NKJGvsbiSLJ_p4PkJL2F3br37BSB7U,2672
+tickwork-0.3.0.dist-info/licenses/LICENSE,sha256=wF_BQ0ncgP_JcCqkcYi980ABBUFtojT-ZsuzIiiI31Y,1072
+tickwork-0.3.0.dist-info/METADATA,sha256=O4j8DtPG2hjyxpvhSuIgCAUxS1FXBoXg5xpoK-wjT8s,285
+tickwork-0.3.0.dist-info/WHEEL,sha256=mOdXR9C3wMVov7cSY8PY-XCzo3SmmWCHvGQr5csJoao,91
+tickwork-0.3.0.dist-info/entry_points.txt,sha256=EENEN49XqVPzj5mkG69iZMpfCWNXvx-uoavcIQ8TYzY,47
+tickwork-0.3.0.dist-info/top_level.txt,sha256=F5ebSpYiCnrm5zmBBi0tKf4qfpmzEnaB9zeRwgriCxI,9
+tickwork-0.3.0.dist-info/RECORD,,

tickwork-0.3.0.dist-info/WHEEL

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

tickwork-0.3.0.dist-info/entry_points.txt

@@ -0,0 +1,2 @@
+[console_scripts]
+tickwork = tickwork.cli:main

tickwork-0.3.0.dist-info/licenses/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) The tickwork Authors
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

tickwork-0.3.0.dist-info/top_level.txt

@@ -0,0 +1 @@
+tickwork