@lchase/kiln 0.12.0 → 0.14.0

package/README.md

@@ -271,13 +271,23 @@ Two triggers are built in. `review-requests` is a schedule, cron `0 * * * *` (mi
 }
 ```
 
-`every` defaults to `5m` (`30s`, `5m`, `1h`). `label` and `status` compile to JQL. A `jql` string replaces them. `enabled` defaults to true. The Triggers page and `PUT /api/settings` send `{ "triggers": [{ "id", "enabled" }] }` and leave cron, JQL, and repo on the file.
+`every` defaults to `5m` (`30s`, `5m`, `1h`). `label` and `status` compile to JQL. A `jql` string replaces them. `enabled` defaults to true. The Triggers page and `PUT /api/settings` send `{ "triggers": [{ "id", "enabled" }] }` and leave cron, JQL, label, and repo on the file. The Triggers page shows each trigger's schedule, whether it is enabled, and, for `review-requests`, the label and the two caps. Times on that page are the browser's local time.
 
 A cron fires once per slot. While serve was down, startup fires the latest missed slot once and does not replay the ones behind it. A Jira poll that was missed does the same: one search, not one per skipped interval. The router writes `trigger.routed` with a `dedupe` property (`review:<repo>:<number>:<head sha>`, `jira:<trigger>:<issue>`, `pr:<job>:<comment>`). A later tick that sees that value does not create another job. Comments and commits from `kiln`, a `[bot]` login, a `kiln:` subject, or a `Kiln-Job` trailer are ignored.
 
-A failed fire stores `last_error` and `lastErrorAt` under `<kiln-home>/triggers/state.json`, appends `trigger.failed`, and waits for the next slot. It does not retry on the next tick. Pause and the daily dollar cap append `trigger.skipped` with reason `paused` or `capped` and do not queue the fire.
+A failed fire stores `last_error` and `lastErrorAt` under `<kiln-home>/triggers/state.json`, appends `trigger.failed`, and waits for the next slot. It does not retry on the next tick. Pause and the daily dollar cap append `trigger.skipped` with reason `paused` or `capped` and do not queue the fire. A review over the per-fire cap is `burst-cap`. A review that would pass the number of queued or running review jobs is `queued-cap`. Those two are not queued, so the next fire can pick them up. A disable is read again after the pull-request list returns and before each job is created, including the startup fire, so a trigger that is already disabled does not fire.
 
-`review-requests` lists open pull requests where your `gh` user is the requested reviewer (`gh pr list --search review-requested:@me` in each registered GitHub repo). A pull request already drafted at that head SHA is skipped. The `review` workflow returns findings (severity, file, line, suggested comment) and stops on a gate in the Inbox. Approving the gate does not post, approve, or merge. There is no gated posting path for a review comment yet, so the draft stops there. `reviewPrompt` is a path to your own prompt file. Omitted, Kiln uses `prompts/kiln/review.md`.
+`review-requests` lists open pull requests where your `gh` user is the requested reviewer and the pull request carries a label (`gh pr list --search 'review-requested:@me label:"kiln-review"'` in each registered GitHub repo). The label defaults to `kiln-review` when `triggers[].label` is omitted. That is opt-in: unlabeled pull requests are not picked. Set `label` on the `review-requests` trigger to use a different one. `repos.<name>.reviewLabel` overrides it for that checkout. One fire creates at most `maxNew` new review jobs (default 3). At most `maxQueued` review jobs may be queued or running at once (default 5). A review waiting on the Inbox gate does not count. A pull request already drafted at that head SHA is skipped and does not use a slot. The `review` workflow returns findings (severity, file, line, suggested comment) and stops on a gate in the Inbox. Approving that gate posts the draft as a pull request comment (`COMMENT` only) under your `gh` user: the markdown is the body, and findings with a file and line are inline comments. Kiln does not approve the pull request or merge it. Rejecting or revising the gate does not post. Pause and the daily cap do not post. Posting the same repo, pull request, and head SHA again does not create a second review. A failed post stays in Needs a hand with `review.failed` and does not count as posted. `reviewPrompt` is a path to your own prompt file. Omitted, Kiln uses `prompts/kiln/review.md`.
+
+```json
+{
+  "triggers": [
+    { "id": "review-requests", "kind": "schedule", "label": "kiln-review", "maxNew": 3, "maxQueued": 5 }
+  ]
+}
+```
+
+`kiln cancel --queued` cancels jobs that have not started. `--repo` and `--workflow` narrow it. `POST /api/jobs/cancel` with `{ "queued": true }` does the same for the board. Both are idempotent: a second call cancels nothing new and writes no second `job.cancelled` event. Running, blocked, and finished jobs stay. Cancelling does not delete branches.
 
 Jira search sends `JIRA_API_TOKEN` only as a Basic header in a child process. The token is not written into the job, the spec, or the event log. Polling is the only Jira ingress. A webhook can later call the same issue-to-event function.
 
@@ -311,6 +321,7 @@ State is derived from the yak journal, the gate files, and (for `deliver=pr`) `g
 | State | Meaning |
 | --- | --- |
 | `queued` | Dependencies are met, and the job has not started |
+| `cancelled` | Cancelled before it started. Tick does not launch it. No branch is deleted |
 | `blocked` | An after-merged dependency is not `done`, or a stacked dependency has not landed. A missing job id is named |
 | `running` | Yak is alive, or the launch process is alive and has not written a journal |
 | `needs-human` | A gate is open, feedback is exhausted or ambiguous, the attempt cap is used, or the same fingerprint has failed `maxSameFingerprint` times. `kiln retry` clears an attempt-cap or fingerprint stop. `kiln revise --note` sends a gate back with a note |

package/assets/serve.css

@@ -108,16 +108,31 @@ h3 { margin: 0 0 8px; font-size: 13px; line-height: 18px; color: var(--muted); t
 .list-head { margin-bottom: 16px; }
 .list-head .meta, .meta { color: var(--muted); }
 .meta { margin: 0; font-size: 12px; line-height: 16px; }
-.jobs { display: flex; flex-direction: column; border-top: 1px solid var(--line); }
+.jobs { display: flex; flex-direction: column; gap: 10px; }
 .job {
-  display: grid;
-  grid-template-columns: minmax(0, 1fr) auto;
-  gap: 12px;
-  padding: 12px 4px;
-  border-bottom: 1px solid var(--line);
+  display: flex;
+  flex-direction: column;
+  gap: 8px;
+  padding: 14px 16px 12px;
+  background: var(--card);
+  border: 1px solid var(--line);
+  border-radius: 10px;
+}
+.job.human { box-shadow: inset 3px 0 0 var(--human); }
+.job.retrying { box-shadow: inset 3px 0 0 var(--changes); }
+.job .d-actions {
+  margin: 4px -16px -12px;
+  padding: 10px 16px;
+  border-top: 1px solid var(--line);
+  background: color-mix(in srgb, var(--bg) 55%, transparent);
+  border-radius: 0 0 10px 10px;
+}
+.job.decision .approve button {
+  background: var(--primary);
+  color: white;
+  border-color: transparent;
+  font-weight: 500;
 }
-.job.human { box-shadow: inset 2px 0 0 var(--human); }
-.job.retrying { box-shadow: inset 2px 0 0 var(--changes); }
 .job-top { display: flex; align-items: baseline; gap: 8px; }
 .job-title { color: var(--ink); font-size: 15px; line-height: 22px; }
 .job-title:hover { color: var(--code); }
@@ -140,8 +155,116 @@ h3 { margin: 0 0 8px; font-size: 13px; line-height: 18px; color: var(--muted); t
 }
 .links { margin: 6px 0 0; display: flex; gap: 10px; }
 .deps { margin: 6px 0 0; }
-.evidence { margin-top: 8px; display: flex; flex-direction: column; gap: 8px; }
-.evidence .text, .phase .text, .timeline .text, .changes .text { max-height: 180px; overflow: auto; }
+.ask { margin: 8px 0 0; font-size: 15px; line-height: 22px; }
+.ran { margin: 4px 0 0; color: var(--muted); font-size: 12px; line-height: 16px; }
+.ticks { display: flex; flex-wrap: wrap; gap: 6px; list-style: none; margin: 10px 0 0; padding: 0; }
+.tick {
+  display: inline-flex; align-items: center; gap: 4px;
+  padding: 2px 8px; border-radius: 999px; background: var(--code-bg);
+  font: 11px/16px var(--mono); color: var(--faint);
+}
+.tick.done { color: var(--pass); }
+.tick.running { color: var(--live); }
+.tick.failed { color: var(--human); }
+.mark { font-size: 11px; }
+.chip {
+  display: inline-flex; align-items: center; height: 18px; padding: 0 7px;
+  border-radius: 999px; background: var(--code-bg); color: var(--muted);
+  font: 11px/18px var(--mono);
+}
+.chip.running, .chip.ok { color: var(--live); }
+.chip.needs-you { color: var(--human); }
+.chip.needs-hand, .chip.failed { color: var(--changes); }
+.chip.done { color: var(--pass); }
+.chip.queued { color: var(--faint); }
+.prose { margin-top: 10px; }
+.prose h1, .prose h2, .prose h3 {
+  margin: 12px 0 6px; color: var(--ink); font-size: 15px; line-height: 22px;
+  text-transform: none; letter-spacing: 0;
+}
+.prose p { margin: 8px 0; }
+.prose ul, .prose ol { margin: 8px 0; padding-left: 1.2rem; }
+.prose li { margin: 2px 0; }
+.prose pre {
+  margin: 8px 0; padding: 8px 10px; overflow: auto; border-radius: 6px; background: var(--bg);
+}
+.prose code { font-family: var(--mono); font-size: 12px; }
+.prose a { color: var(--code); }
+.findings { margin-top: 12px; }
+.finding-group { margin: 0 0 10px; }
+.finding-group h3 { margin: 0 0 4px; }
+.finding-group ul { list-style: none; margin: 0; padding: 0; }
+.finding-group li {
+  display: grid; grid-template-columns: auto minmax(0, 1fr); gap: 8px;
+  padding: 6px 0; border-top: 1px solid var(--line); font-size: 13px; line-height: 18px;
+}
+.finding-group code { color: var(--code); }
+.notes { margin: 8px 0 0; padding-left: 18px; }
+.pr-line { margin: 8px 0 0; }
+.raw, .log { margin-top: 10px; }
+.raw summary, .log summary { cursor: pointer; color: var(--muted); font-size: 12px; }
+.head-row { display: flex; align-items: center; justify-content: space-between; gap: 12px; }
+#compact {
+  width: 32px; height: 32px; border-radius: 8px; border: 1px solid var(--line-strong);
+  background: var(--card); color: var(--ink); cursor: pointer;
+}
+#compact svg { width: 16px; height: 16px; stroke: currentColor; fill: none; stroke-width: 1.8; }
+.filters { display: flex; flex-wrap: wrap; gap: 16px; margin: 0 0 14px; }
+.filter { display: flex; flex-wrap: wrap; align-items: center; gap: 6px; }
+.repo-f, .wf-f {
+  height: 28px; padding: 0 12px; border: 1px solid var(--line-strong); border-radius: 999px;
+  background: var(--card); color: var(--muted); font: 12px/16px var(--mono); cursor: pointer;
+}
+.repo-f[aria-pressed="true"], .wf-f[aria-pressed="true"] {
+  border-color: transparent; background: color-mix(in srgb, var(--merged) 28%, var(--card)); color: var(--ink);
+}
+.repo-f:hover, .wf-f:hover { color: var(--ink); }
+.board-scroll { overflow-x: auto; padding-bottom: 8px; }
+.board {
+  display: grid;
+  grid-template-columns: var(--cols, repeat(5, minmax(180px, 1fr)));
+  gap: 12px;
+  align-items: start;
+  min-width: 920px;
+}
+.col {
+  background: var(--panel);
+  border: 1px solid var(--line);
+  border-radius: 10px;
+  padding: 10px;
+  min-height: 140px;
+}
+.col .full { display: flex; align-items: baseline; justify-content: space-between; gap: 8px; }
+.col h2 { font-size: 13px; line-height: 18px; color: var(--muted); text-transform: uppercase; letter-spacing: .04em; }
+.col .count { font: 11px/16px var(--mono); color: var(--faint); }
+.slim-face { display: none; }
+.col.slim { min-height: 160px; padding: 8px; }
+.col.slim .full, .col.slim .card, .col.slim .empty { display: none; }
+.col.slim .slim-face {
+  display: flex; align-items: center; gap: 8px; writing-mode: vertical-rl; transform: rotate(180deg);
+  color: var(--muted); font-size: 12px; letter-spacing: .04em; text-transform: uppercase;
+}
+.card {
+  display: block;
+  margin-top: 8px;
+  padding: 10px 12px;
+  background: var(--card);
+  border: 1px solid var(--line);
+  border-radius: 8px;
+}
+.card .job-title { display: block; color: var(--ink); font-size: 14px; line-height: 20px; }
+.card .job-meta { margin-top: 6px; }
+.card:hover { background: var(--card-hover); }
+.state-group { margin: 0 0 18px; }
+.state-group h3 { display: flex; align-items: center; gap: 8px; }
+.stat-grid { display: grid; grid-template-columns: repeat(auto-fit, minmax(180px, 1fr)); gap: 12px; margin: 0 0 18px; }
+.stat-grid .stat {
+  margin: 0; padding: 14px; background: var(--card); border: 1px solid var(--line); border-radius: 10px;
+}
+.stat-num { margin: 0; font-size: 28px; line-height: 34px; font-weight: 500; }
+.run-group { margin: 0 0 18px; }
+.run-group h3 { color: var(--ink); text-transform: none; letter-spacing: 0; font-size: 13px; }
+.phase .text, .timeline .text, .changes .text, .raw .text, .log .text { max-height: 220px; overflow: auto; }
 .feedback { margin: 6px 0 0; padding-left: 18px; }
 .repo-block { margin-bottom: 24px; }
 .repo-block h3 { margin-bottom: 0; }
@@ -157,7 +280,8 @@ h3 { margin: 0 0 8px; font-size: 13px; line-height: 18px; color: var(--muted); t
   padding: 0 0 16px 14px;
   margin-left: 6px;
 }
-.phase.completed { border-color: var(--pass); }
+.phase.done, .phase.completed { border-color: var(--pass); }
+.phase.running { border-color: var(--live); }
 .phase.failed { border-color: var(--human); }
 .phase header, .timeline li { display: flex; flex-wrap: wrap; gap: 8px; align-items: baseline; }
 .step { font-weight: 500; }
@@ -285,4 +409,5 @@ body.open .drawer { transform: none; }
   .rail { position: static; }
   .d-actions .revise input { min-width: 0; width: 100%; }
   .job { grid-template-columns: 1fr; }
+  .board { min-width: 720px; }
 }

package/assets/serve.js

@@ -24,6 +24,8 @@
   try { compact = localStorage.getItem("kiln-compact") !== "off"; } catch (err) { compact = true; }
   var repo = "";
   try { repo = localStorage.getItem("kiln-repo") || ""; } catch (err) { repo = ""; }
+  var workflow = "";
+  try { workflow = localStorage.getItem("kiln-workflow") || ""; } catch (err) { workflow = ""; }
 
   var COMPACT = {
     on: ["expand empty columns", '<path d="M3 12h7m0 0-3-3m3 3-3 3M21 12h-7m0 0 3-3m-3 3 3 3M12 4v16"/>'],
@@ -66,12 +68,19 @@
     var cards = document.querySelectorAll(".board .card");
     for (var i = 0; i < cards.length; i++) {
       var cardRepo = cards[i].getAttribute("data-repo") || "";
-      cards[i].hidden = Boolean(repo) && cardRepo !== repo;
+      var cardWorkflow = cards[i].getAttribute("data-workflow") || "";
+      var hideRepo = Boolean(repo) && cardRepo !== repo;
+      var hideWorkflow = Boolean(workflow) && cardWorkflow !== workflow;
+      cards[i].hidden = hideRepo || hideWorkflow;
     }
     var chips = document.querySelectorAll(".repo-f");
     for (var j = 0; j < chips.length; j++) {
       chips[j].setAttribute("aria-pressed", (chips[j].getAttribute("data-repo") || "") === repo ? "true" : "false");
     }
+    var flows = document.querySelectorAll(".wf-f");
+    for (var k = 0; k < flows.length; k++) {
+      flows[k].setAttribute("aria-pressed", (flows[k].getAttribute("data-workflow") || "") === workflow ? "true" : "false");
+    }
     layout();
   }
 
@@ -185,13 +194,33 @@
     view.innerHTML = text ? markdown(localizeIso(text)) : '<p class="empty">Nothing written yet.</p>';
   }
 
-  function localTime(iso, withDate) {
+  function relativeTime(iso) {
     var date = new Date(iso);
     if (!isFinite(date.getTime())) return iso;
-    if (!withDate) return date.toLocaleTimeString(undefined, { hour: "numeric", minute: "2-digit" });
+    var delta = Date.now() - date.getTime();
+    var future = delta < 0;
+    var abs = Math.abs(delta);
+    var sec = Math.round(abs / 1000);
+    if (sec < 45) return future ? "in a moment" : "just now";
+    var min = Math.round(sec / 60);
+    var prefix = future ? "in " : "";
+    var suffix = future ? "" : " ago";
+    if (min < 60) return prefix + min + "m" + suffix;
+    var hr = Math.round(min / 60);
+    if (hr < 36) return prefix + hr + "h" + suffix;
+    var day = Math.round(hr / 24);
+    if (day < 14) return prefix + day + "d" + suffix;
     return date.toLocaleString();
   }
 
+  function localTime(iso, mode) {
+    var date = new Date(iso);
+    if (!isFinite(date.getTime())) return iso;
+    if (mode === "clock" || mode === false) return date.toLocaleTimeString();
+    if (mode === "rel") return relativeTime(iso);
+    return date.toLocaleString(undefined, { dateStyle: "medium", timeStyle: "short" });
+  }
+
   function localizeIso(text) {
     return String(text).replace(/\d{4}-\d{2}-\d{2}T\d{2}:\d{2}:\d{2}(?:\.\d+)?(?:Z|[+-]\d{2}:\d{2})/g, function (iso) {
       return localTime(iso, true);
@@ -202,7 +231,7 @@
     var nodes = (root || document).querySelectorAll("time[datetime]");
     for (var i = 0; i < nodes.length; i++) {
     var iso = nodes[i].getAttribute("datetime");
-    if (iso) nodes[i].textContent = localTime(iso, nodes[i].getAttribute("data-time") !== "clock");
+    if (iso) nodes[i].textContent = localTime(iso, nodes[i].getAttribute("data-time") || "local");
     }
   }
 
@@ -1185,6 +1214,16 @@
       applyRepo();
       return;
     }
+    var flow = target.closest(".wf-f");
+    if (flow) {
+      workflow = flow.getAttribute("data-workflow") || "";
+      try {
+        if (workflow) localStorage.setItem("kiln-workflow", workflow);
+        else localStorage.removeItem("kiln-workflow");
+      } catch (err) { /* private mode */ }
+      applyRepo();
+      return;
+    }
     if (target.closest("a[href]")) return;
     if (target.closest("[data-close]")) {
       closeDrawer();
@@ -1215,6 +1254,7 @@
   });
 
   function stamp(ok) {
+    localizeTimes(document);
     var el = document.getElementById("status");
     if (!el) return;
     if (!ok) {
@@ -1225,7 +1265,6 @@
     el.className = "status";
     var jobs = document.querySelectorAll(".job").length;
     el.textContent = jobs + (jobs === 1 ? " job · " : " jobs · ") + new Date().toLocaleTimeString();
-    localizeTimes(document);
   }
 
   function poll() {

package/dist/attention.js

@@ -15,7 +15,7 @@ import { SANDBOX_PREFLIGHT_PREFIX } from "./sandbox.js";
  */
 const NEEDS_YOU = ["needs-human", "dead", "failed", "in-review", "invalid"];
 const IN_FLIGHT = ["running", "approved", "queued", "blocked"];
-const SETTLED = ["done", "rejected"];
+const SETTLED = ["done", "rejected", "cancelled"];
 /** Reasons an automatic retry is allowed to schedule. A rejected gate is not one of these. */
 const RETRYABLE_REASONS = new Set(["stalled", "crashed", "orphaned", "failed"]);
 /**
@@ -102,6 +102,8 @@ function toItem(job) {
 export function attentionReason(job, tail = errorTail(job)) {
     switch (job.state) {
         case "needs-human": {
+            if (job.reviewPostError)
+                return job.reviewPostError;
             if (job.stopReason === "attempt-cap")
                 return "Attempt cap reached";
             if (job.stopReason === "fingerprint")
@@ -147,6 +149,8 @@ export function attentionReason(job, tail = errorTail(job)) {
             return job.prUrl ? "Merged" : "Done";
         case "rejected":
             return "Rejected";
+        case "cancelled":
+            return "Cancelled";
         default:
             return job.state;
     }

package/dist/board-view.js

@@ -1,8 +1,8 @@
 import { spawnSync } from "node:child_process";
-import { attentionReason, scheduledRetry } from "./attention.js";
-import { feedbackRoundLabel } from "./feedback.js";
+import { isFinished, isHand, isInbox, projectJob } from "./job-view.js";
 import { ledgerRows } from "./ledger.js";
 import { localDay, spendSnapshot } from "./rails.js";
+export { isFinished, isHand, isInbox };
 /**
  * Lists, stats, and job pages for the serve shell. Job state still comes
  * from `jobState` (via the status view). Everything else is read off the
@@ -60,25 +60,8 @@ export function parseSeenQuery(values) {
     }
     return seen;
 }
-export function isInbox(job) {
-    if (job.canApprove || job.canReject || job.canRevise)
-        return true;
-    return job.state === "needs-human" && job.gates.length > 0 && !job.stopReason && !job.feedbackReason;
-}
-/**
- * Needs a person, and not an open gate. A failure that still has a scheduled
- * retry is in flight, so it stays off this list.
- */
-export function isHand(job) {
-    if (isInbox(job) || scheduledRetry(job))
-        return false;
-    return job.state === "needs-human" || job.state === "failed" || job.state === "dead" || job.state === "invalid";
-}
-export function isFinished(job) {
-    return job.state === "done" || job.state === "rejected";
-}
 export function buildBoard(jobs, events) {
-    const rows = jobs.map((job) => toBoardJob(job, events));
+    const rows = jobs.map((job) => projectJob(job, events));
     const inbox = rows.filter((job) => job.inbox);
     const hand = rows.filter((job) => job.hand);
     const history = rows.filter((job) => job.finished);
@@ -272,7 +255,7 @@ export function jobDetail(input) {
     const jobEvents = input.events.filter((event) => event.job_id === input.job.jobId);
     const changes = jobChanges(input.job, input.events, input.commits ?? [], input.diffStat);
     return {
-        job: toBoardJob(input.job, input.events),
+        job: projectJob(input.job, input.events),
         overview: phaseFeed(input.events, input.job.jobId),
         changes,
         timeline: jobEvents,
@@ -442,147 +425,6 @@ export function branchOf(job, events) {
     }
     return branch;
 }
-function toBoardJob(job, events) {
-    const inbox = isInbox(job);
-    const hand = isHand(job);
-    const finished = isFinished(job);
-    const failure = latestFailure(events, job.jobId);
-    const activity = jobActivity(events, job.jobId);
-    const waiting = scheduledRetry(job);
-    const reason = hand ? handLine(job, failure) : attentionReason(job);
-    const notes = [];
-    if (job.launchError?.trim())
-        notes.push(job.launchError.trim());
-    if (job.failureDetail?.trim())
-        notes.push(job.failureDetail.trim());
-    if (job.waitReason)
-        notes.push(job.waitReason);
-    const feedback = [];
-    for (const round of job.feedbackRounds ?? []) {
-        const url = round.items.find((item) => item.url)?.url;
-        feedback.push({ label: feedbackRoundLabel(round), ...(url ? { url } : {}) });
-    }
-    let historyLine;
-    if (finished)
-        historyLine = finishedLine(job);
-    return {
-        jobId: job.jobId,
-        title: job.title || job.jobId,
-        repo: job.repo,
-        workflow: job.workflow,
-        state: job.state,
-        reason,
-        inbox,
-        hand,
-        finished,
-        retry: (job.state === "failed" || job.state === "dead" || (job.state === "needs-human" && Boolean(job.stopReason))) && job.gates.length === 0,
-        sandboxed: job.sandboxed === true,
-        canApprove: job.canApprove,
-        canReject: job.canReject,
-        canRevise: job.canRevise,
-        attemptCount: job.attemptCount,
-        maxAttempts: job.maxAttempts,
-        scheduledRetry: waiting,
-        ...(waiting && job.nextRetryAt ? { nextRetryAt: job.nextRetryAt } : {}),
-        ...(attemptLine(job) ? { attemptLine: attemptLine(job) } : {}),
-        ...(failure?.class ? { failureClass: failure.class } : {}),
-        ...(failure?.fingerprint ? { fingerprint: shortFingerprint(failure.fingerprint) } : {}),
-        ...(activity.latest ? { latestEventAt: activity.latest } : {}),
-        eventCount: activity.count,
-        ...(job.prUrl ? { prUrl: job.prUrl } : {}),
-        ...(job.prNumber ? { prNumber: job.prNumber } : {}),
-        dependsOn: job.dependsOn.map((dep) => ({
-            jobId: dep.jobId,
-            state: dep.state,
-            ...(dep.blockedDetail ? { detail: dep.blockedDetail } : {}),
-        })),
-        evidence: evidenceTexts(job),
-        feedback,
-        notes,
-        ...(historyLine ? { historyLine } : {}),
-        findings: Boolean(job.findingsPath),
-        spec: Boolean(job.specPath),
-        log: Boolean(job.logPath),
-        ...(job.logTail?.trim() ? { logTail: job.logTail.trim() } : {}),
-    };
-}
-function finishedLine(job) {
-    if (job.state === "rejected")
-        return "Rejected";
-    if (job.prNumber)
-        return `merged · PR #${job.prNumber}`;
-    if (job.prUrl && httpUrl(job.prUrl))
-        return "merged · PR";
-    return job.branch ? `landed locally · ${job.branch}` : "landed locally";
-}
-function httpUrl(url) {
-    try {
-        const parsed = new URL(url);
-        return parsed.protocol === "http:" || parsed.protocol === "https:";
-    }
-    catch {
-        return false;
-    }
-}
-function handLine(job, failure) {
-    let label = "Needs a person";
-    if (job.stopReason === "attempt-cap")
-        label = "Attempt cap";
-    else if (job.stopReason === "fingerprint")
-        label = "Same failure";
-    else if (job.feedbackReason === "feedback-exhausted")
-        label = "Fix round cap";
-    else if (job.feedbackReason === "feedback-ambiguous")
-        label = "Feedback unclear";
-    else if (job.state === "failed" || job.state === "dead" || job.state === "invalid")
-        label = attentionReason(job);
-    const parts = [label];
-    if (failure?.class)
-        parts.push(failure.class);
-    const fingerprint = shortFingerprint(failure?.fingerprint);
-    if (fingerprint)
-        parts.push(fingerprint);
-    return parts.join(" · ");
-}
-function evidenceTexts(job) {
-    const texts = [];
-    if (job.workflow !== "investigation" && job.diffSummary?.trim())
-        texts.push(job.diffSummary.trim());
-    for (const gate of job.gates) {
-        const body = gate.rendered?.trim() || gate.prompt?.trim();
-        if (body)
-            texts.push(body);
-        for (const review of gate.reviews ?? [])
-            if (review.summary?.trim())
-                texts.push(review.summary.trim());
-        for (const artifact of gate.artifacts ?? [])
-            if (artifact.summary?.trim())
-                texts.push(artifact.summary.trim());
-    }
-    return texts;
-}
-function attemptLine(job) {
-    if (job.attemptCount <= 0 && !job.lastFailureReason)
-        return undefined;
-    const parts = [];
-    if (job.attemptCount > 0)
-        parts.push(`attempt ${job.attemptCount}/${job.maxAttempts}`);
-    if (job.lastFailureReason)
-        parts.push(job.lastFailureReason);
-    return parts.join(" · ");
-}
-function jobActivity(events, jobId) {
-    let count = 0;
-    let latest;
-    for (const event of events) {
-        if (event.job_id !== jobId)
-            continue;
-        count += 1;
-        if (!latest || event.ts > latest)
-            latest = event.ts;
-    }
-    return { count, ...(latest ? { latest } : {}) };
-}
 function latestFailure(events, jobId) {
     let found;
     for (const event of events) {

package/dist/cli.js

@@ -1,7 +1,7 @@
 #!/usr/bin/env node
 import { addRepo, renderRepoList, resolveKilnConfig } from "./config.js";
 import { renderSandboxStatus, runSandboxBuild } from "./sandbox.js";
-import { answerJob, retryJob, reviseJob, runStatus, runTick } from "./driver.js";
+import { answerJob, cancelQueuedJobs, retryJob, reviseJob, runStatus, runTick } from "./driver.js";
 import { productionHost } from "./host.js";
 import { pauseFactory, resumeFactory } from "./rails.js";
 import { parseSince, renderLedgerFile } from "./ledger.js";
@@ -23,6 +23,7 @@ function usage() {
         "       kiln reject <jobId> [--config <file>]",
         "       kiln revise <jobId> --note <text> [--config <file>]",
         "       kiln retry <jobId> [--config <file>]",
+        "       kiln cancel --queued [--repo <name>] [--workflow <name>] [--config <file>]",
         "       kiln pause [--config <file>]",
         "       kiln resume [--config <file>]",
         "       kiln ledger [--since 7d] [--repo <name>] [--config <file>]",
@@ -63,7 +64,9 @@ function usage() {
         "yak/<run-id> and opens a draft pull request. An investigation is done when",
         "its gate is approved. It does not open a pull request. status prints the",
         "derived state, and the findings path once an investigation is approved.",
-        "approve and reject answer the human gate. retry launches a failed or dead",
+        "approve and reject answer the human gate. Approving a review draft posts",
+        "it as a pull request comment and does not approve or merge that pull request.",
+        "retry launches a failed or dead",
         "job again, the same way tick launches, and clears the attempt ledger.",
         "A landed job that only failed to open its pull request is delivered again.",
         "A running job with no yak event or log output for stallTimeoutMs (default",
@@ -94,6 +97,12 @@ function usage() {
         "when a slot was missed. Jira polls are per repo. Kiln-owned pull",
         "request activity uses the same read as the fix loop. A failed fire",
         "waits for the next slot. Pause and the daily cap skip the fire.",
+        "review-requests only picks pull requests labeled kiln-review, unless",
+        "the trigger sets label (repos.<name>.reviewLabel overrides that repo).",
+        "One fire creates at most 3 new review jobs, and at most 5 review jobs",
+        "may be queued or running. The rest are skipped until a later fire.",
+        "kiln cancel --queued cancels jobs that have not started. It does not",
+        "delete branches. A second cancel changes nothing.",
         "",
         "serve listens on 127.0.0.1. The page is a board of workflow stages:",
         "queued, spec, build, review, approve, land, PR review, Done (landed locally),",
@@ -116,7 +125,7 @@ function usage() {
     process.exit(2);
 }
 function parseFlags(argv) {
-    const bag = { positionals: [], after: [], dryRun: false, stack: false, noTick: false };
+    const bag = { positionals: [], after: [], dryRun: false, stack: false, noTick: false, queued: false };
     for (let i = 0; i < argv.length; i += 1) {
         const flag = argv[i];
         const next = argv[i + 1];
@@ -205,6 +214,10 @@ function parseFlags(argv) {
             bag.stack = true;
             continue;
         }
+        if (flag === "--queued") {
+            bag.queued = true;
+            continue;
+        }
         if (flag === "--deliver") {
             if (next !== "local" && next !== "pr")
                 usage();
@@ -418,6 +431,37 @@ function statusCommand(argv) {
     const config = resolveKilnConfig({ configPath: flags.configPath });
     process.stdout.write(runStatus(config, flags.positionals[0]));
 }
+function cancelCommand(argv) {
+    const flags = parseFlags(argv);
+    rejectServeFlags(flags);
+    if (!flags.queued ||
+        flags.positionals.length !== 0 ||
+        flags.test ||
+        flags.spec ||
+        flags.prompt ||
+        flags.jira ||
+        flags.title ||
+        flags.issue ||
+        flags.context ||
+        flags.dryRun ||
+        flags.stack ||
+        flags.after.length > 0 ||
+        flags.deliver ||
+        flags.base ||
+        flags.note) {
+        usage();
+    }
+    const config = resolveKilnConfig({ configPath: flags.configPath });
+    const result = cancelQueuedJobs(config, {
+        ...(flags.repo ? { repo: flags.repo } : {}),
+        ...(flags.workflow ? { workflow: flags.workflow } : {}),
+    });
+    if (result.cancelled.length === 0) {
+        process.stdout.write("cancelled 0\n");
+        return;
+    }
+    process.stdout.write(`${result.cancelled.map((id) => `cancelled ${id}`).join("\n")}\n`);
+}
 function retryCommand(argv) {
     const flags = parseFlags(argv);
     rejectServeFlags(flags);
@@ -562,6 +606,10 @@ async function main() {
         retryCommand(argv.slice(1));
         return;
     }
+    if (command === "cancel") {
+        cancelCommand(argv.slice(1));
+        return;
+    }
     if (command === "revise") {
         reviseCommand(argv.slice(1));
         return;

package/dist/config.js

@@ -33,6 +33,7 @@ export function loadKilnConfig(configPath, options = {}) {
             ...(entry.branch ? { branchTemplate: entry.branch } : {}),
             ...(entry.maxAttempts !== undefined ? { maxAttempts: entry.maxAttempts } : {}),
             ...(entry.maxFixRounds !== undefined ? { maxFixRounds: entry.maxFixRounds } : {}),
+            ...(entry.reviewLabel ? { reviewLabel: entry.reviewLabel } : {}),
         };
     }
     const kilnDir = configDir;