Skip to main content
The Work page lists the factory’s work items. Each row shows the item’s status, its labels, its pull requests and its checks. Select a row to open the item’s page, where you review it. See Review and merge.

​
The Work list

The Work page lists the factory’s items, newest activity first, 25 items per page. A search box above the list holds the whole filter as text, such as is:open status:stuck sort:cost. The filter is in the page address, so you can bookmark a filtered view or send it to someone. A row whose pull request changes a file under .outerlayer/ carries a caption. It reads Rules for 4 repositories when the pull request is in a control plane that governs three others, and Changes this repository’s rules otherwise. Write qualifiers and plain words in the box:
  • A comma means OR within one qualifier: status:stuck,back.
  • Different qualifiers combine with AND.
  • A comma in label: also means OR: label:bug,ui matches an item with bug, ui or both. Two label: qualifiers mean AND: label:bug label:ui matches only an item with both labels.
  • Any other word matches the item’s title, its number (239 or #239), its tracker key or one of its labels. Every word must match.
  • An unknown qualifier is treated as a plain word.
  • builder: and by: match only an item someone is building now.
  • by:me matches by member name, so two members with the same name see each other’s items.
A search on Closed covers every closed item, and Closed shows its exact total. On Closed, status: matches only shipped, and builder: and by: match nothing. sort:cost sorts Closed too, with items whose cost is unknown last. You do not have to type qualifiers. The list’s header has menus for Status, Repository, Label, Builder, Asked by and Sort. The Label menu lists the labels on the factory’s items. Choosing an option adds it to the box, and choosing it again removes it. Each option shows how many items it would match. The Repository menu appears only when the factory’s items come from more than one repository. Each row shows up to three of the item’s labels, and +N for the rest. Select a label on a row to add it to the box as label:<name>. The Open and Closed tabs count the items that match the filter in each state. The Filters menu beside the box replaces the box’s text with one of five saved filters: When the box holds anything beyond is:, a line under it reads N results · Clear current filters. Clearing leaves only the is: qualifier. A filter that matches nothing shows No work matches these filters with a Clear filters button.

​
Statuses

One status says whose turn it is, on the item’s page and on the Work page:
  • Not started: nothing has been linked to the item or asked of it yet.
  • Queued: a build, or your review notes, wait for a runner to take them.
  • Not picked up: a build, or your review notes, wait, and no runner can take them. No runner that checked in recently takes the item’s repository, or every one that does is unavailable. The line under the title says which.
  • With agent: an agent is working on it.
  • Ready for review: the agent is done and a pull request is open. It is your turn even while checks run or fail. You can send the work back now. Approve waits for the checks and every proof.
  • Approved: a person approved it. It is ready to merge, or merging. It stays Approved for up to ten minutes after its pull request merges, while the issue the pull request closes catches up. The line under the title then reads Merged, waiting for the issue to close.
  • Done: its pull request merged with no blocking verdict. The line under the title reads Shipped.
  • Done, unverified: a pull request merged while its verdict still blocked, so some checks were never proven. The mark is the Done disc with an orange dot, and the line under the title reads Shipped · N checks unproven when checks were left unproven, or Shipped when a person’s “no” was merged over. It stays in the Closed list.
  • Closed, not shipped: its issue closed with nothing merged. If a pull request is still open, the line reads Closed <date> · pull request still open.
  • Needs attention: the last run stopped, or work started and no pull request is open. A stopped run shows, on Activity, why it stopped and how to take it over. A pull request that merged more than ten minutes ago with its issue still open also lands here, reading Merged, but its issue is still open: close the issue, or link the pull request with “Closes #N” next time.
On the Work page, the status is an icon before the item’s title; hover it for the word. The line under the title says why. It names who is working on it or who asked for changes. It can also say that the agent answered your review, how many criteria are missing their proof, or why a run stopped. At the right edge, a pull request icon shows open if any of the item’s pull requests is open, else merged, else closed. A number beside it counts them all. A checks icon follows it, except on a finished row (Done, Done unverified or Closed, not shipped), where nothing is left to fix.

​
Find an item by its status

The status: words do not match the status names one to one. They also look at the checks and the review. Each item has one word, the first of these that applies:
  1. shipped: on Closed, its pull requests merged and their checks passed.
  2. stuck: its last build or amend run failed or timed out, and nobody has asked again.
  3. building: no pull request is open, a check that counts has not passed, or a declared proof is missing.
  4. with-agent: an agent holds the item, or a review waits on an agent’s answer.
  5. merging: a person approved the latest push.
  6. back: a person reviewed it, and it is your turn again.
  7. ready: nobody has reviewed it yet.
A closed item that matches none of these, such as one closed with nothing merged, matches no status: word. The Stuck saved filter, status:stuck, finds the items that read Needs attention after a failed run. To rerun one, see Rerun a Stuck item.