batch

Dispatch a batch of tickets

Announce at start: "Using csw:batch to dispatch tonight's tickets."

Tonight's invocation carried: $ARGUMENTS

Two modifiers, and they compose:

• A bare integer lowers tonight's cap. Never raises it — see Step 2.
• --dry-run, also written dry-run or dry run, runs selection and stops — see Step 3.

So /csw:batch 2 --dry-run shows tonight's plan cut at 2 without dispatching anything. Anything else in $ARGUMENTS is not a modifier: say what you ignored and why, rather than guessing at what it meant.

Before the first run: the prerequisite

This loop's first filter is "drop blocked tickets," and it only works if the tracker knows what blocks what. If blockedBy is empty on most tickets while relatedTo carries three or four links each, the dependency information exists but is in the wrong field and in prose.

Backfill blocking relations on the Todo column before relying on this. Check a sample first, and if blockedBy is empty across the board, say so and stop rather than dispatching a batch whose ordering constraints are invisible.

Prepped tickets dispatch better. /csw:prep <ticket> leaves a spec and its open questions on the ticket, and csw:work Step 2 reads them, so a question that would have cost a whole dispatch to discover is already answered when the loop reaches it. It is not required, and this loop does not skip unprepped tickets — an optional command that silently became a gate would be a new manual step in front of every ticket in the column.

Step 1: Pull the candidates

Either way, this step ends with candidates_json holding a JSON array in the shape Step 2 pipes into csw-batch-filter:

[
  {
    "id": "ENG-1075",
    "state": "Todo",
    "priority": 2,
    "labels": ["migration"],
    "blockedBy": [],
    "relatedTo": ["ENG-1080", "ENG-1081"]
  }
]

Which way depends on one key:

csw-config get trackerCommand

Empty — read the tracker. Read every Todo ticket from the tracker named by csw-config get tracker and shape it into the array above yourself. This is the default, and it is what tracker: linear does through MCP.