(2c95d38) Gate a blocker by the column it is in, not by whether it is done, and bump to 0.33.1

check_blockers refused every move while a blocked by target was still open, so a
dependent sat in backlog until its blocker landed even when the blocker was in
reviewing and its code was there to build on. The way out was -f, which also waives
the backward and skipping guard, on every move for as long as the pair existed.

The rule is now the columns: a ticket may stand level with what it waits on but never
ahead of it, so a blocker in reviewing lets the dependent be committed and reviewed
and gates only done. util::blocks_move is the one place it is decided, taking the
status moved into and the blocker's own, and mv passes the target through. A finished
blocker still holds up nothing, answered through is_open, and a target of discarded
is answered by name rather than by its place in Status::ALL, where it sits last.

The refusal now names the status moved into and only the blockers still behind it: a
dependent told to wait for work already ahead of it has nothing to act on. The board
asks the same function about the column one stage ahead, so the blocked mark means the
card cannot advance rather than that a dependency was ever recorded, which also takes
it off cards in the two terminal columns.

Co-Authored-By: Claude Opus 5 (1M context) <noreply@anthropic.com>
This commit is contained in:
Ansho Rei
2026-09-10 11:38:17 +02:00
co-authored by Claude Opus 5
parent 9c224fb768
commit ead3c4340d
15 changed files with 409 additions and 90 deletions
+18 -8
View File
@@ -32,8 +32,9 @@ go straight to `reviewing` and has to be walked through `committed` anyway. Doin
front is the same two commands in a more useful order. `-f` allows a backward or
skipping move, for correcting a mistake.
A move is also refused while the ticket is blocked by one that is not done yet, see
[Relating tickets](#relating-tickets).
A move is also refused while it would take the ticket a column ahead of one it is
blocked by: a pair can be committed together and reviewed together, and only the move to
`done` waits for the blocker to land. See [Relating tickets](#relating-tickets).
`mv` stamps the time as it goes: `Committed On`, `Submitted On`, `Completed On` and
`Discarded On`, shown by `show` among the rest of the metadata. They **accumulate**, so a
@@ -63,7 +64,7 @@ What it means everywhere else:
`ls discarded` and `--ids` still reach it
- A campaign counts a discarded member as **finished**: the work left the campaign rather
than sitting in it unfinished
- A discarded ticket **blocks nothing**, so a ticket waiting on it can move
- A discarded ticket **blocks nothing**, so a ticket waiting on it can move anywhere
- Discarding a ticket that open tickets are blocked by is **refused**, naming them: their
plans depended on this work, so they need a look first. `-f` says you looked
- Getting it back is a backward move, so it needs `-f`:
@@ -253,11 +254,20 @@ tickets each blocking the other is two facts and the block shows both. A symmetr
comes off with `--clear` at the end that stores it, since that is the only end holding a
line to remove.
`--blocked-by` is enforced: `mv` refuses to move a ticket while a ticket it is blocked by
is not in `done` or `discarded`, whichever move it is, and names every open blocker. `-f`
moves it anyway, beside the backward and skipping moves it already allows. It is enforced
from the other end too: discarding a ticket that open tickets are blocked by is refused,
naming them. The other two kinds are reference data and never refuse anything.
`--blocked-by` is enforced by the column: **a ticket cannot move to a status ahead of
the one its blocker is in**, and standing level with it is allowed. So a blocker in
`reviewing` lets the dependent be committed and submitted for review and refuses only
`done`; a blocker still in `backlog` holds the dependent in `backlog`. With several
blockers the least advanced one sets the ceiling, and the refusal names the status you
tried to move to and every blocker still behind it. A blocker in `done` or `discarded`
holds up nothing at all.
That is what makes it worth recording an edge on work you are about to start rather than
work you have finished: waiting on a ticket in review costs nothing until the last move.
`-f` moves past it anyway, beside the backward and skipping moves it already allows. It
is enforced from the other end too: discarding a ticket that open tickets are blocked by
is refused, naming them. The other two kinds are reference data and never refuse
anything.
Recording a relation the ticket already holds reports no change. A ticket cannot relate
to itself, and a target that later disappears shows as `_missing_` rather than silently