ghostrail 0.18.0 → 0.20.1

package/dist/config/schema.d.ts

@@ -74,6 +74,18 @@ export interface GateConfig {
 export interface RespondConfigSection {
     /** Prompt file for the respond agent (reads `.ghostrail/feedback.md`). */
     prompt: string;
+    /**
+     * Comment authors the respond pass ignores, on top of the source kind's
+     * built-in defaults and `GHOSTRAIL_SELF_LOGINS`. Bot logins, not
+     * credentials, so they live in the config rather than the secrets file.
+     */
+    ignoreAuthors: string[];
+    /**
+     * How often `watch` runs this pass, in milliseconds. Undefined when
+     * `every = "off"`, which keeps `ghostrail respond` working by hand while
+     * leaving it out of the watch loop.
+     */
+    everyMs?: number;
 }
 /** Optional triage stage: decompose large issues into ordered sub-issues. */
 export interface TriageConfig {
@@ -81,6 +93,12 @@ export interface TriageConfig {
     prompt: string;
     /** Which issues form the triage queue (typically a `triage` label + assignee). */
     eligible: EligibleFilter;
+    /**
+     * How often `watch` runs this pass, in milliseconds. Undefined when
+     * `every = "off"`, which keeps `ghostrail triage` working by hand while
+     * leaving it out of the watch loop.
+     */
+    everyMs?: number;
 }
 /**
  * A guardrail spending cap: a positive USD amount, or `"unlimited"` to
@@ -102,6 +120,30 @@ export interface Guardrails {
      * concurrently; the per-tick total is still bounded by `maxItemsPerRun`.
      */
     concurrency: number;
+    /**
+     * How many consecutive "persistent" failures (a red gate, or the agent
+     * itself reporting failure) an item may accrue before the factory stops
+     * claiming it and hands it to a human. Optional so ad hoc `Guardrails`
+     * literals built before this field existed keep compiling; a missing value
+     * falls back to {@link DEFAULT_MAX_FAILURES} wherever retry decisions are made.
+     */
+    maxFailures?: number;
+    /**
+     * Same allowance as {@link Guardrails.maxFailures}, but for "transient"
+     * failures (a provisioning error, an agent timeout) — counted separately so
+     * a flake does not spend down the allowance a real dead end needs, and does
+     * not give up too early on it either. Falls back to
+     * {@link DEFAULT_MAX_TRANSIENT_FAILURES} when unset.
+     */
+    maxTransientFailures?: number;
+    /**
+     * Base delay, in milliseconds, of the exponential backoff applied after a
+     * failed attempt: `retryBackoffMs * 2^(failures - 1)`, capped at
+     * `retryBackoffCapMs`. Falls back to {@link DEFAULT_RETRY_BACKOFF_MS}.
+     */
+    retryBackoffMs?: number;
+    /** Cap on the backoff computed from {@link Guardrails.retryBackoffMs}. Falls back to {@link DEFAULT_RETRY_BACKOFF_CAP_MS}. */
+    retryBackoffCapMs?: number;
 }
 export interface OutputConfig {
     openPr: boolean;
@@ -134,8 +176,23 @@ export interface GhostrailConfig {
 }
 /** Default agent tool allowlist: read + write files and run shell/search only. */
 export declare const DEFAULT_ALLOWED_TOOLS: readonly string[];
+/** See {@link Guardrails.maxFailures}. */
+export declare const DEFAULT_MAX_FAILURES = 3;
+/** See {@link Guardrails.maxTransientFailures}. */
+export declare const DEFAULT_MAX_TRANSIENT_FAILURES = 5;
+/** See {@link Guardrails.retryBackoffMs}. */
+export declare const DEFAULT_RETRY_BACKOFF_MS: number;
+/** See {@link Guardrails.retryBackoffCapMs}. */
+export declare const DEFAULT_RETRY_BACKOFF_CAP_MS: number;
 /** Guardrail defaults, carried over from the reference factory. */
 export declare const DEFAULT_GUARDRAILS: Guardrails;
+/**
+ * How often `watch` runs each schedulable pass when its section sets no
+ * `every`. Respond answers a human who is waiting, so it runs often; triage
+ * costs an agent run and decomposing an issue is never urgent, so it does not.
+ */
+export declare const DEFAULT_RESPOND_EVERY_MS: number;
+export declare const DEFAULT_TRIAGE_EVERY_MS: number;
 export declare const DEFAULT_BASE_BRANCH = "main";
 export declare const DEFAULT_BACKEND_KIND: BackendKind;
 /**

package/dist/config/schema.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"schema.d.ts","sourceRoot":"","sources":["../../src/config/schema.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"schema.d.ts","sourceRoot":"","sources":["../../src/config/schema.ts"],"names":[],"mappings":"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"}

package/dist/config/schema.js

@@ -25,6 +25,14 @@ export const DEFAULT_ALLOWED_TOOLS = [
     "Grep",
     "Glob",
 ];
+/** See {@link Guardrails.maxFailures}. */
+export const DEFAULT_MAX_FAILURES = 3;
+/** See {@link Guardrails.maxTransientFailures}. */
+export const DEFAULT_MAX_TRANSIENT_FAILURES = 5;
+/** See {@link Guardrails.retryBackoffMs}. */
+export const DEFAULT_RETRY_BACKOFF_MS = 10 * 60_000;
+/** See {@link Guardrails.retryBackoffCapMs}. */
+export const DEFAULT_RETRY_BACKOFF_CAP_MS = 4 * 3_600_000;
 /** Guardrail defaults, carried over from the reference factory. */
 export const DEFAULT_GUARDRAILS = {
     maxItemsPerRun: 3,
@@ -33,7 +41,18 @@ export const DEFAULT_GUARDRAILS = {
     maxCostUsdPerRun: 5,
     claimTtlMs: 2 * 3_600_000,
     concurrency: 1,
+    maxFailures: DEFAULT_MAX_FAILURES,
+    maxTransientFailures: DEFAULT_MAX_TRANSIENT_FAILURES,
+    retryBackoffMs: DEFAULT_RETRY_BACKOFF_MS,
+    retryBackoffCapMs: DEFAULT_RETRY_BACKOFF_CAP_MS,
 };
+/**
+ * How often `watch` runs each schedulable pass when its section sets no
+ * `every`. Respond answers a human who is waiting, so it runs often; triage
+ * costs an agent run and decomposing an issue is never urgent, so it does not.
+ */
+export const DEFAULT_RESPOND_EVERY_MS = 5 * 60_000;
+export const DEFAULT_TRIAGE_EVERY_MS = 30 * 60_000;
 export const DEFAULT_BASE_BRANCH = "main";
 export const DEFAULT_BACKEND_KIND = "local-worktree";
 /**

package/dist/config/schema.js.map

@@ -1 +1 @@
-{"version":3,"file":"schema.js","sourceRoot":"","sources":["../../src/config/schema.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,MAAM,CAAC,MAAM,YAAY,GAAG,CAAC,QAAQ,EAAE,eAAe,EAAE,OAAO,CAAU,CAAC;AAG1E,MAAM,CAAC,MAAM,aAAa,GAAG;IAC3B,gBAAgB;IAChB,WAAW;IACX,aAAa;IACb,KAAK;IACL,QAAQ;CACA,CAAC;AAwHX,mEAAmE;AACnE,MAAM,CAAC,MAAM,qBAAqB,GAAG,WAAW,CAAC;AACjD,MAAM,CAAC,MAAM,mBAAmB,GAAG,OAAO,CAAC;AAkB3C,kFAAkF;AAClF,MAAM,CAAC,MAAM,qBAAqB,GAAsB;IACtD,MAAM;IACN,MAAM;IACN,OAAO;IACP,MAAM;IACN,MAAM;IACN,MAAM;CACP,CAAC;AAEF,mEAAmE;AACnE,MAAM,CAAC,MAAM,kBAAkB,GAAe;IAC5C,cAAc,EAAE,CAAC;IACjB,gBAAgB,EAAE,CAAC;IACnB,SAAS,EAAE,EAAE,GAAG,MAAM;IACtB,gBAAgB,EAAE,CAAC;IACnB,UAAU,EAAE,CAAC,GAAG,SAAS;IACzB,WAAW,EAAE,CAAC;CACf,CAAC;AAEF,MAAM,CAAC,MAAM,mBAAmB,GAAG,MAAM,CAAC;AAC1C,MAAM,CAAC,MAAM,oBAAoB,GAAgB,gBAAgB,CAAC;AAElE;;;GAGG;AACH,MAAM,CAAC,MAAM,wBAAwB,GAAG,IAAI,CAAC"}
+{"version":3,"file":"schema.js","sourceRoot":"","sources":["../../src/config/schema.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,MAAM,CAAC,MAAM,YAAY,GAAG,CAAC,QAAQ,EAAE,eAAe,EAAE,OAAO,CAAU,CAAC;AAG1E,MAAM,CAAC,MAAM,aAAa,GAAG;IAC3B,gBAAgB;IAChB,WAAW;IACX,aAAa;IACb,KAAK;IACL,QAAQ;CACA,CAAC;AAkKX,mEAAmE;AACnE,MAAM,CAAC,MAAM,qBAAqB,GAAG,WAAW,CAAC;AACjD,MAAM,CAAC,MAAM,mBAAmB,GAAG,OAAO,CAAC;AAkB3C,kFAAkF;AAClF,MAAM,CAAC,MAAM,qBAAqB,GAAsB;IACtD,MAAM;IACN,MAAM;IACN,OAAO;IACP,MAAM;IACN,MAAM;IACN,MAAM;CACP,CAAC;AAEF,0CAA0C;AAC1C,MAAM,CAAC,MAAM,oBAAoB,GAAG,CAAC,CAAC;AACtC,mDAAmD;AACnD,MAAM,CAAC,MAAM,8BAA8B,GAAG,CAAC,CAAC;AAChD,6CAA6C;AAC7C,MAAM,CAAC,MAAM,wBAAwB,GAAG,EAAE,GAAG,MAAM,CAAC;AACpD,gDAAgD;AAChD,MAAM,CAAC,MAAM,4BAA4B,GAAG,CAAC,GAAG,SAAS,CAAC;AAE1D,mEAAmE;AACnE,MAAM,CAAC,MAAM,kBAAkB,GAAe;IAC5C,cAAc,EAAE,CAAC;IACjB,gBAAgB,EAAE,CAAC;IACnB,SAAS,EAAE,EAAE,GAAG,MAAM;IACtB,gBAAgB,EAAE,CAAC;IACnB,UAAU,EAAE,CAAC,GAAG,SAAS;IACzB,WAAW,EAAE,CAAC;IACd,WAAW,EAAE,oBAAoB;IACjC,oBAAoB,EAAE,8BAA8B;IACpD,cAAc,EAAE,wBAAwB;IACxC,iBAAiB,EAAE,4BAA4B;CAChD,CAAC;AAEF;;;;GAIG;AACH,MAAM,CAAC,MAAM,wBAAwB,GAAG,CAAC,GAAG,MAAM,CAAC;AACnD,MAAM,CAAC,MAAM,uBAAuB,GAAG,EAAE,GAAG,MAAM,CAAC;AAEnD,MAAM,CAAC,MAAM,mBAAmB,GAAG,MAAM,CAAC;AAC1C,MAAM,CAAC,MAAM,oBAAoB,GAAgB,gBAAgB,CAAC;AAElE;;;GAGG;AACH,MAAM,CAAC,MAAM,wBAAwB,GAAG,IAAI,CAAC"}

package/dist/dashboard/index.d.ts

@@ -1,4 +1,5 @@
 export { DASHBOARD_PAGE_HTML } from "./page.js";
-export { type DashboardDeps, type DashboardOptions, type GhostrailHealth, type GhostrailView, collectViews, createDashboardServer, defaultStateDir, } from "./server.js";
-export { type DashboardRoute, isCrossOriginWrite, parseDashboardRoute, parseWatchUpdate, } from "./routes.js";
+export { REVIEW_PAGE_HTML } from "./review-page.js";
+export { type DashboardDeps, type DashboardOptions, type GhostrailHealth, type GhostrailView, MERGE_TRIGGER_COMMENT, collectViews, createDashboardServer, defaultStateDir, } from "./server.js";
+export { type DashboardRoute, isCrossOriginWrite, parseDashboardRoute, parseGhostrailQuery, parseWatchUpdate, } from "./routes.js";
 //# sourceMappingURL=index.d.ts.map

package/dist/dashboard/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/dashboard/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,mBAAmB,EAAE,MAAM,WAAW,CAAC;AAChD,OAAO,EACL,KAAK,aAAa,EAClB,KAAK,gBAAgB,EACrB,KAAK,eAAe,EACpB,KAAK,aAAa,EAClB,YAAY,EACZ,qBAAqB,EACrB,eAAe,GAChB,MAAM,aAAa,CAAC;AACrB,OAAO,EACL,KAAK,cAAc,EACnB,kBAAkB,EAClB,mBAAmB,EACnB,gBAAgB,GACjB,MAAM,aAAa,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/dashboard/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,mBAAmB,EAAE,MAAM,WAAW,CAAC;AAChD,OAAO,EAAE,gBAAgB,EAAE,MAAM,kBAAkB,CAAC;AACpD,OAAO,EACL,KAAK,aAAa,EAClB,KAAK,gBAAgB,EACrB,KAAK,eAAe,EACpB,KAAK,aAAa,EAClB,qBAAqB,EACrB,YAAY,EACZ,qBAAqB,EACrB,eAAe,GAChB,MAAM,aAAa,CAAC;AACrB,OAAO,EACL,KAAK,cAAc,EACnB,kBAAkB,EAClB,mBAAmB,EACnB,mBAAmB,EACnB,gBAAgB,GACjB,MAAM,aAAa,CAAC"}

package/dist/dashboard/index.js

@@ -1,4 +1,5 @@
 export { DASHBOARD_PAGE_HTML } from "./page.js";
-export { collectViews, createDashboardServer, defaultStateDir, } from "./server.js";
-export { isCrossOriginWrite, parseDashboardRoute, parseWatchUpdate, } from "./routes.js";
+export { REVIEW_PAGE_HTML } from "./review-page.js";
+export { MERGE_TRIGGER_COMMENT, collectViews, createDashboardServer, defaultStateDir, } from "./server.js";
+export { isCrossOriginWrite, parseDashboardRoute, parseGhostrailQuery, parseWatchUpdate, } from "./routes.js";
 //# sourceMappingURL=index.js.map

package/dist/dashboard/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/dashboard/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,mBAAmB,EAAE,MAAM,WAAW,CAAC;AAChD,OAAO,EAKL,YAAY,EACZ,qBAAqB,EACrB,eAAe,GAChB,MAAM,aAAa,CAAC;AACrB,OAAO,EAEL,kBAAkB,EAClB,mBAAmB,EACnB,gBAAgB,GACjB,MAAM,aAAa,CAAC"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/dashboard/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,mBAAmB,EAAE,MAAM,WAAW,CAAC;AAChD,OAAO,EAAE,gBAAgB,EAAE,MAAM,kBAAkB,CAAC;AACpD,OAAO,EAKL,qBAAqB,EACrB,YAAY,EACZ,qBAAqB,EACrB,eAAe,GAChB,MAAM,aAAa,CAAC;AACrB,OAAO,EAEL,kBAAkB,EAClB,mBAAmB,EACnB,mBAAmB,EACnB,gBAAgB,GACjB,MAAM,aAAa,CAAC"}

package/dist/dashboard/page.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"page.d.ts","sourceRoot":"","sources":["../../src/dashboard/page.ts"],"names":[],"mappings":"AAEA;;;;;;;;;;;;;GAaG;AACH,eAAO,MAAM,mBAAmB,QAoQ/B,CAAC"}
+{"version":3,"file":"page.d.ts","sourceRoot":"","sources":["../../src/dashboard/page.ts"],"names":[],"mappings":"AAEA;;;;;;;;;;;;;GAaG;AACH,eAAO,MAAM,mBAAmB,QAwU/B,CAAC"}

package/dist/dashboard/page.js

@@ -34,7 +34,9 @@ export const DASHBOARD_PAGE_HTML = `<!doctype html>
   table.runs th { font-weight: 600; opacity: .7; font-size: .85em; }
   a { color: inherit; }
   .state { font-weight: 600; }
-  .done { color: #2a9d3a; } .failed { color: #d33; } .blocked { color: #d90; }
+  .hist-entry { margin: 6px 0 0 0; padding-left: 8px; border-left: 2px solid #ddd; }
+  .row-err { font-size: 12px; color: #b3261e; margin-top: 2px; overflow-wrap: anywhere; }
+  .done { color: #2a9d3a; } .failed { color: #d33; } .blocked, .abandoned { color: #d90; }
   .noop, .skipped { opacity: .6; } .muted { opacity: .6; }
   .twirl {
     background: none; border: none; cursor: pointer; font: inherit; padding: 0 .3rem;
@@ -47,6 +49,10 @@ export const DASHBOARD_PAGE_HTML = `<!doctype html>
   .detail-cell ul { margin: .25rem 0 0; padding-left: 1.2rem; }
   .subtable { border-collapse: collapse; margin-top: .25rem; }
   .subtable td { padding: .15rem .5rem .15rem 0; border-bottom: none; }
+  .review { margin-left: auto; font-size: .85em; }
+  .merge-row { display: flex; align-items: center; gap: .5rem; }
+  .merge-btn { font: inherit; }
+  .merge-status { font-size: .85em; opacity: .8; }
 </style>
 <h1>ghostrails</h1>
 <p class="sub">The checkbox is what <code>ghostrail start</code> should bring up. The pill beside it is what is running right now.</p>
@@ -124,6 +130,34 @@ function prStatusHtml(status) {
   return parts.join("");
 }
 
+function mergeButtonHtml(path, r) {
+  if (r.prNumber === undefined) return "";
+  return "<div class='merge-row'><button class='merge-btn' type='button' data-path='" + esc(path) +
+    "' data-run='" + esc(r.runId) + "'>resolve conflicts and merge</button>" +
+    "<span class='merge-status'></span></div>";
+}
+
+/**
+ * What earlier passes said, once a later one has superseded them. The row's own
+ * Error and Comment above are always the latest pass's; this is the record of
+ * the ones before it, so a comment posted on the PR two passes ago is still
+ * readable here (TJ-1676).
+ */
+function outcomeHistoryHtml(row) {
+  const all = row.outcomes || [];
+  if (all.length < 2) return "";
+  const earlier = all.slice(0, -1).reverse();
+  const items = earlier.map((o) => {
+    const said = o.error || o.summary || "";
+    return "<div class=hist-entry>" +
+      "<span class='state " + esc(o.state) + "'>" + esc(o.state) + "</span> " +
+      "<span class=muted>" + esc(fmtWhen(o.ts)) + "</span>" +
+      (said ? "<pre>" + esc(said) + "</pre>" : "") +
+      "</div>";
+  }).join("");
+  return "<div><b>Earlier passes</b>" + items + "</div>";
+}
+
 function detailHtml(path, r) {
   const parts = [];
   parts.push(
@@ -141,11 +175,13 @@ function detailHtml(path, r) {
   parts.push("<div><b>Gate</b>" + gateStepsHtml(r.gate) + "</div>");
   if (r.error) parts.push("<div><b>Error</b><pre class=failed>" + esc(r.error) + "</pre></div>");
   if (r.summary) parts.push("<div><b>Comment</b><pre>" + esc(r.summary) + "</pre></div>");
+  parts.push(outcomeHistoryHtml(r));
   if (r.prUrl) {
     parts.push(
       "<div><b>PR</b> <a href='" + esc(r.prUrl) + "'" + NEWTAB + ">" + esc(r.prUrl) + "</a></div>",
     );
   }
+  parts.push(mergeButtonHtml(path, r));
   parts.push(artifactsHtml(path, r.artifacts));
   if (r.prNumber !== undefined) parts.push(prStatusHtml(prStatus.get(rowKey(path, r.runId))));
   parts.push(
@@ -156,6 +192,14 @@ function detailHtml(path, r) {
   return parts.join("");
 }
 
+/** A failed row's reason on the summary line, truncated, full text on hover (TJ-1676). */
+function errLine(r) {
+  if (!r.error) return "";
+  const oneLine = String(r.error).replace(/\\s+/g, " ").trim();
+  const short = oneLine.length > 120 ? oneLine.slice(0, 119) + "…" : oneLine;
+  return "<div class='row-err' title='" + esc(oneLine) + "'>" + esc(short) + "</div>";
+}
+
 function runsHtml(g, gi) {
   if (!g.runs.length) {
     return "<p class='none'>" + (g.health === "ok" ? "no runs yet" : esc(g.health)) + "</p>";
@@ -172,7 +216,7 @@ function runsHtml(g, gi) {
       " aria-expanded='" + open + "' data-path='" + esc(g.path) + "' data-run='" + esc(r.runId) + "'" +
       " title='show detail'>▶</button></td>" +
       "<td class=muted>" + esc(r.runId.slice(0, 8)) + "</td>" +
-      "<td>" + itemLink(r, r.title || r.itemId || "") + "</td>" +
+      "<td>" + itemLink(r, r.title || r.itemId || "") + errLine(r) + "</td>" +
       "<td class='state " + state + "'>" + state + "</td>" +
       "<td>" + esc(r.backend || "") + "</td>" +
       "<td>" + gate + "</td>" +
@@ -199,6 +243,7 @@ function render(ghostrails) {
     "<span class='name'>" + esc(g.name) + "</span>" +
     "<span class='pill'>" + esc(g.state) + "</span>" +
     "<span class='path'>" + esc(g.path) + "</span>" +
+    "<a class='review' href='" + esc(api("review?path=" + enc(g.path))) + "'>review</a>" +
     "</div>" + runsHtml(g, gi) + "</div>"
   ).join("");
 }
@@ -236,11 +281,34 @@ function toggle(path, runId, buttonId) {
   if (expanded.has(k)) refreshPrStatus();
 }
 
+async function postMerge(path, runId, button) {
+  const status = button.parentElement.querySelector(".merge-status");
+  button.disabled = true;
+  if (status) status.textContent = "posting…";
+  try {
+    const res = await fetch(
+      api("/api/merge?path=" + enc(path) + "&run=" + enc(runId)),
+      { method: "POST" },
+    );
+    const data = await res.json();
+    if (!res.ok || data.posted !== true) throw new Error(data.error || res.statusText);
+    if (status) status.textContent = "posted — the next respond pass will pick it up";
+  } catch (err) {
+    if (status) status.textContent = "failed: " + err.message;
+    button.disabled = false;
+  }
+}
+
 const list = document.getElementById("list");
 
 list.addEventListener("click", (e) => {
-  const btn = e.target.closest(".twirl");
-  if (btn) toggle(btn.dataset.path, btn.dataset.run, btn.id);
+  const twirlBtn = e.target.closest(".twirl");
+  if (twirlBtn) {
+    toggle(twirlBtn.dataset.path, twirlBtn.dataset.run, twirlBtn.id);
+    return;
+  }
+  const mergeBtn = e.target.closest(".merge-btn");
+  if (mergeBtn) postMerge(mergeBtn.dataset.path, mergeBtn.dataset.run, mergeBtn);
 });
 
 list.addEventListener("change", async (e) => {

package/dist/dashboard/page.js.map

@@ -1 +1 @@
-{"version":3,"file":"page.js","sourceRoot":"","sources":["../../src/dashboard/page.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,iBAAiB,EAAE,MAAM,oBAAoB,CAAC;AAEvD;;;;;;;;;;;;;GAaG;AACH,MAAM,CAAC,MAAM,mBAAmB,GAAG;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;mCAyJA,IAAI,CAAC,SAAS,CAAC,iBAAiB,CAAC;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CA2GnE,CAAC"}
+{"version":3,"file":"page.js","sourceRoot":"","sources":["../../src/dashboard/page.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,iBAAiB,EAAE,MAAM,oBAAoB,CAAC;AAEvD;;;;;;;;;;;;;GAaG;AACH,MAAM,CAAC,MAAM,mBAAmB,GAAG;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;mCAqMA,IAAI,CAAC,SAAS,CAAC,iBAAiB,CAAC;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CAmInE,CAAC"}

package/dist/dashboard/review-page.d.ts

@@ -0,0 +1,14 @@
+/**
+ * The review-mode page: one ghostrail's runs, one at a time, with Prev/Next.
+ *
+ * Inline, like the dashboard's own page, so the package ships one file and the
+ * server needs no static asset handling. It reads `path` (which ghostrail),
+ * `run` (which run to open first), and `token` from `location.search`, the
+ * same way the dashboard page reads `token`.
+ *
+ * The detail rendering (gate steps, artifacts, PR status) intentionally mirrors
+ * `page.ts`'s: same information, same shape, because this is the same detail
+ * panel shown one run at a time instead of behind a twirl.
+ */
+export declare const REVIEW_PAGE_HTML: string;
+//# sourceMappingURL=review-page.d.ts.map

package/dist/dashboard/review-page.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"review-page.d.ts","sourceRoot":"","sources":["../../src/dashboard/review-page.ts"],"names":[],"mappings":"AAEA;;;;;;;;;;;GAWG;AACH,eAAO,MAAM,gBAAgB,QAiP5B,CAAC"}

package/dist/dashboard/review-page.js

@@ -0,0 +1,256 @@
+import { IN_PROGRESS_STATE } from "../store/events.js";
+/**
+ * The review-mode page: one ghostrail's runs, one at a time, with Prev/Next.
+ *
+ * Inline, like the dashboard's own page, so the package ships one file and the
+ * server needs no static asset handling. It reads `path` (which ghostrail),
+ * `run` (which run to open first), and `token` from `location.search`, the
+ * same way the dashboard page reads `token`.
+ *
+ * The detail rendering (gate steps, artifacts, PR status) intentionally mirrors
+ * `page.ts`'s: same information, same shape, because this is the same detail
+ * panel shown one run at a time instead of behind a twirl.
+ */
+export const REVIEW_PAGE_HTML = `<!doctype html>
+<meta charset="utf-8">
+<title>ghostrail review</title>
+<style>
+  :root { color-scheme: light dark; }
+  body { font: 15px/1.5 ui-sans-serif, system-ui, sans-serif; margin: 2rem auto; max-width: 56rem; padding: 0 1rem; }
+  h1 { font-size: 1.3rem; margin: 0 0 .25rem; }
+  .sub { opacity: .7; margin: 0 0 1.5rem; }
+  .back { display: inline-block; margin-bottom: 1rem; }
+  .nav { display: flex; align-items: center; gap: .75rem; margin-bottom: 1rem; }
+  .nav button { font: inherit; padding: .3rem .8rem; }
+  .pos { opacity: .7; font-size: .9em; }
+  .panel { border: 1px solid color-mix(in oklab, currentColor 20%, transparent); border-radius: 8px; padding: 1rem 1.25rem; }
+  .panel > div { margin-bottom: .5rem; }
+  .panel pre { white-space: pre-wrap; word-break: break-word; margin: .25rem 0 0; font: inherit; }
+  .panel ul { margin: .25rem 0 0; padding-left: 1.2rem; }
+  .title { font-weight: 600; font-size: 1.1em; }
+  .state { font-weight: 600; }
+  .done { color: #2a9d3a; } .failed { color: #d33; } .blocked, .abandoned { color: #d90; }
+  .noop, .skipped { opacity: .6; } .muted { opacity: .6; }
+  a { color: inherit; }
+  .subtable { border-collapse: collapse; margin-top: .25rem; }
+  .subtable td { padding: .15rem .5rem .15rem 0; border-bottom: none; }
+  .merge-btn { font: inherit; }
+  .merge-status { margin-left: .5rem; font-size: .85em; }
+  .none { opacity: .55; }
+  .err { color: #b00; }
+</style>
+<a class="back" href="./">&larr; back to the dashboard</a>
+<h1 id="heading">review</h1>
+<p class="sub" id="sub"></p>
+<div class="nav" id="nav" hidden>
+  <button id="prev" type="button">&larr; prev</button>
+  <span class="pos" id="pos"></span>
+  <button id="next" type="button">next &rarr;</button>
+</div>
+<div id="body">loading…</div>
+<script>
+const params = new URLSearchParams(location.search);
+const ghostrailPath = params.get("path") || "";
+const tok = params.get("token");
+const api = (p) => p + (tok ? (p.includes("?") ? "&" : "?") + "token=" + encodeURIComponent(tok) : "");
+const esc = (s) => String(s ?? "").replace(/[&<>"']/g, (c) =>
+  ({ "&": "&amp;", "<": "&lt;", ">": "&gt;", '"': "&quot;", "'": "&#39;" }[c] || c));
+const enc = encodeURIComponent;
+// Every link this page renders leaves it, so it opens in a new tab, with the
+// \`rel\` that stops the opened page reaching back through \`window.opener\`. Same
+// rule, same reason, as the dashboard page (TJ-1653).
+const NEWTAB = " target='_blank' rel='noopener noreferrer'";
+// The item's label, linked to whatever the run's \`url\` points at when the row
+// carries one.
+const itemLink = (r, label) =>
+  r.url ? "<a href='" + esc(r.url) + "'" + NEWTAB + ">" + esc(label) + "</a>" : esc(label);
+
+let runs = [];
+let index = 0;
+let name = "";
+const prStatus = new Map();
+
+function fmtWhen(ts) {
+  return ts ? new Date(ts).toLocaleString() : "";
+}
+
+function gateStepsHtml(gate) {
+  if (!gate || gate.length === 0) return "<div class=muted>no gate steps</div>";
+  const rows = gate.map((s) =>
+    "<tr><td>" + esc(s.name) + "</td><td class='" + (s.exitCode === 0 ? "done" : "failed") + "'>" +
+    (s.exitCode === 0 ? "passed" : "failed (exit " + esc(s.exitCode) + ")") + "</td><td class=muted>" +
+    esc(s.durationMs) + "ms</td></tr>"
+  ).join("");
+  return "<table class=subtable>" + rows + "</table>";
+}
+
+function artifactsHtml(artifacts) {
+  if (!artifacts || artifacts.length === 0) return "";
+  const items = artifacts.map((a) => {
+    const href = api("/api/artifact?path=" + enc(ghostrailPath) + "&hash=" + enc(a.hash));
+    return "<li><a href='" + esc(href) + "'" + NEWTAB + ">" + esc(a.name) + "</a></li>";
+  }).join("");
+  return "<div><b>Artifacts</b><ul>" + items + "</ul></div>";
+}
+
+function checkLineHtml(c) {
+  const label = c.conclusion || c.status;
+  const cls = c.conclusion === "success" ? "done" : c.conclusion ? "failed" : "muted";
+  const label2 = c.url
+    ? "<a href='" + esc(c.url) + "'" + NEWTAB + ">" + esc(c.name) + "</a>"
+    : esc(c.name);
+  return "<li>" + label2 + ": <span class='" + cls + "'>" + esc(label) + "</span></li>";
+}
+
+function prStatusHtml(status) {
+  if (!status) return "<div class=muted>loading CI status…</div>";
+  if (!status.available) {
+    return "<div class=muted>PR status unknown" + (status.error ? ": " + esc(status.error) : "") + "</div>";
+  }
+  const merged = status.state === "merged";
+  const parts = [
+    "<div><b>PR state:</b> " + esc(status.state) +
+    (merged && status.mergedAt ? " at " + esc(new Date(status.mergedAt).toLocaleString()) : "") + "</div>",
+  ];
+  if (status.checks && status.checks.length > 0) {
+    parts.push("<div><b>CI checks</b><ul>" + status.checks.map(checkLineHtml).join("") + "</ul></div>");
+  } else {
+    parts.push("<div class=muted>no CI checks reported</div>");
+  }
+  return parts.join("");
+}
+
+function mergeButtonHtml(r) {
+  if (r.prNumber === undefined) return "";
+  return "<div><button class='merge-btn' type='button' data-run='" + esc(r.runId) +
+    "'>resolve conflicts and merge</button><span class='merge-status' id='merge-status'></span></div>";
+}
+
+function detailHtml(r) {
+  const parts = [];
+  parts.push(
+    "<div class=title>" + itemLink(r, r.title || r.itemId || "(untitled run)") + "</div>",
+  );
+  parts.push(
+    "<div><b>Item</b> " + itemLink(r, r.itemId || "") +
+    (r.kind ? " (" + esc(r.kind) + ")" : "") + "</div>",
+  );
+  const state = esc(r.state || ${JSON.stringify(IN_PROGRESS_STATE)});
+  parts.push("<div><b>State</b> <span class='state " + state + "'>" + state + "</span></div>");
+  if (r.branch) parts.push("<div><b>Branch</b> " + esc(r.branch) + "</div>");
+  if (r.backend) parts.push("<div><b>Backend</b> " + esc(r.backend) + "</div>");
+  if (r.costUsd !== undefined) {
+    parts.push("<div><b>Cost</b> $" + esc(Number(r.costUsd).toFixed(4)) + "</div>");
+  }
+  if (r.tokensIn !== undefined || r.tokensOut !== undefined) {
+    parts.push("<div><b>Tokens</b> in " + esc(r.tokensIn ?? 0) + " / out " + esc(r.tokensOut ?? 0) + "</div>");
+  }
+  parts.push("<div><b>Gate</b>" + gateStepsHtml(r.gate) + "</div>");
+  if (r.error) parts.push("<div><b>Error</b><pre class=failed>" + esc(r.error) + "</pre></div>");
+  if (r.summary) parts.push("<div><b>Comment</b><pre>" + esc(r.summary) + "</pre></div>");
+  if (r.prUrl) {
+    parts.push(
+      "<div><b>PR</b> <a href='" + esc(r.prUrl) + "'" + NEWTAB + ">" + esc(r.prUrl) + "</a></div>",
+    );
+  }
+  parts.push(mergeButtonHtml(r));
+  parts.push(artifactsHtml(r.artifacts));
+  if (r.prNumber !== undefined) parts.push(prStatusHtml(prStatus.get(r.runId)));
+  parts.push(
+    "<div class=muted>started " + esc(fmtWhen(r.startedAt)) +
+    (r.finishedAt ? ", finished " + esc(fmtWhen(r.finishedAt)) : ", still running") +
+    "</div>",
+  );
+  return parts.join("");
+}
+
+function render() {
+  document.getElementById("sub").textContent = name ? name + " — " + ghostrailPath : ghostrailPath;
+  const nav = document.getElementById("nav");
+  const body = document.getElementById("body");
+  if (runs.length === 0) {
+    nav.hidden = true;
+    body.innerHTML = "<p class=none>no runs yet</p>";
+    return;
+  }
+  nav.hidden = false;
+  document.getElementById("pos").textContent = "run " + (index + 1) + " of " + runs.length;
+  document.getElementById("prev").disabled = index <= 0;
+  document.getElementById("next").disabled = index >= runs.length - 1;
+  body.innerHTML = "<div class=panel>" + detailHtml(runs[index]) + "</div>";
+  const run = runs[index];
+  const next = new URLSearchParams(location.search);
+  next.set("run", run.runId);
+  history.replaceState(null, "", location.pathname + "?" + next.toString());
+  // Fetched once per run and cached: without the guard, a successful fetch
+  // triggers a re-render, which (with no guard) would ask for status again,
+  // forever.
+  if (run.prNumber !== undefined && !prStatus.has(run.runId)) loadPrStatus(run.runId);
+}
+
+async function loadPrStatus(runId) {
+  let status;
+  try {
+    status = await (
+      await fetch(api("/api/pr-status?path=" + enc(ghostrailPath) + "&run=" + enc(runId)))
+    ).json();
+  } catch {
+    return;
+  }
+  prStatus.set(runId, status);
+  if (runs[index] && runs[index].runId === runId) render();
+}
+
+async function postMerge(runId, button) {
+  const status = document.getElementById("merge-status");
+  button.disabled = true;
+  if (status) status.textContent = "posting…";
+  try {
+    const res = await fetch(
+      api("/api/merge?path=" + enc(ghostrailPath) + "&run=" + enc(runId)),
+      { method: "POST" },
+    );
+    const data = await res.json();
+    if (!res.ok || data.posted !== true) throw new Error(data.error || res.statusText);
+    if (status) status.textContent = "posted — the next respond pass will pick it up";
+  } catch (err) {
+    if (status) status.textContent = "failed: " + err.message;
+    button.disabled = false;
+  }
+}
+
+document.getElementById("body").addEventListener("click", (e) => {
+  const btn = e.target.closest(".merge-btn");
+  if (btn) postMerge(btn.dataset.run, btn);
+});
+
+document.getElementById("prev").addEventListener("click", () => {
+  if (index > 0) { index -= 1; render(); }
+});
+document.getElementById("next").addEventListener("click", () => {
+  if (index < runs.length - 1) { index += 1; render(); }
+});
+
+async function load() {
+  if (!ghostrailPath) {
+    document.getElementById("body").innerHTML = "<p class=err>no ?path= given</p>";
+    return;
+  }
+  try {
+    const res = await fetch(api("/api/runs?path=" + enc(ghostrailPath)));
+    if (!res.ok) throw new Error((await res.json()).error || res.statusText);
+    const data = await res.json();
+    name = data.name || "";
+    runs = data.runs || [];
+    const wanted = params.get("run");
+    const found = wanted ? runs.findIndex((r) => r.runId === wanted) : -1;
+    index = found >= 0 ? found : 0;
+    render();
+  } catch (err) {
+    document.getElementById("body").innerHTML = "<p class=err>" + esc(err.message) + "</p>";
+  }
+}
+load();
+</script>
+`;
+//# sourceMappingURL=review-page.js.map

package/dist/dashboard/review-page.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"review-page.js","sourceRoot":"","sources":["../../src/dashboard/review-page.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,iBAAiB,EAAE,MAAM,oBAAoB,CAAC;AAEvD;;;;;;;;;;;GAWG;AACH,MAAM,CAAC,MAAM,gBAAgB,GAAG;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;iCA4HC,IAAI,CAAC,SAAS,CAAC,iBAAiB,CAAC;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CAqHjE,CAAC"}

package/dist/dashboard/routes.d.ts

@@ -6,6 +6,8 @@ import type { IncomingHttpHeaders } from "node:http";
  */
 export type DashboardRoute = {
     kind: "page";
+} | {
+    kind: "review";
 } | {
     kind: "ghostrails";
 } | {
@@ -14,11 +16,27 @@ export type DashboardRoute = {
     kind: "prStatus";
 } | {
     kind: "artifact";
+} | {
+    kind: "runs";
+} | {
+    kind: "merge";
 } | {
     kind: "notfound";
 };
 /** Map a request pathname to a route. Total; never throws. */
 export declare function parseDashboardRoute(pathname: string): DashboardRoute;
+/**
+ * The ghostrail a request names, or undefined when `path` is missing or
+ * empty.
+ *
+ * Shares `parseDetailQuery`'s reasoning for using a query parameter rather
+ * than a path segment (a ghostrail's identity does not survive one), but
+ * `GET /api/runs` needs only `path`, not a second key naming a run or a
+ * hash within it.
+ */
+export declare function parseGhostrailQuery(params: URLSearchParams): {
+    path: string;
+} | undefined;
 /**
  * The ghostrail a detail request is about, plus the run or artifact within it.
  *

package/dist/dashboard/routes.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"routes.d.ts","sourceRoot":"","sources":["../../src/dashboard/routes.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,WAAW,CAAC;AAGrD;;;;GAIG;AAEH,MAAM,MAAM,cAAc,GACtB;IAAE,IAAI,EAAE,MAAM,CAAA;CAAE,GAChB;IAAE,IAAI,EAAE,YAAY,CAAA;CAAE,GACtB;IAAE,IAAI,EAAE,OAAO,CAAA;CAAE,GACjB;IAAE,IAAI,EAAE,UAAU,CAAA;CAAE,GACpB;IAAE,IAAI,EAAE,UAAU,CAAA;CAAE,GACpB;IAAE,IAAI,EAAE,UAAU,CAAA;CAAE,CAAC;AAEzB,8DAA8D;AAC9D,wBAAgB,mBAAmB,CAAC,QAAQ,EAAE,MAAM,GAAG,cAAc,CAcpE;AAED;;;;;;;;;;;;;GAaG;AACH,wBAAgB,gBAAgB,CAC9B,MAAM,EAAE,eAAe,EACvB,GAAG,EAAE,KAAK,GAAG,MAAM,GAClB;IAAE,IAAI,EAAE,MAAM,CAAC;IAAC,KAAK,EAAE,MAAM,CAAA;CAAE,GAAG,SAAS,CAM7C;AAED;;;;;;;;GAQG;AACH,wBAAgB,iBAAiB,CAAC,MAAM,EAAE,eAAe,GAAG,MAAM,GAAG,SAAS,CAI7E;AA2BD;;;;;;;;;;;;GAYG;AACH,wBAAgB,kBAAkB,CAAC,OAAO,EAAE,mBAAmB,GAAG,OAAO,CAYxE;AAOD;;;;;;GAMG;AACH;;;;GAIG;AACH,wBAAgB,gBAAgB,CAAC,IAAI,EAAE,MAAM,GAAG;IAAE,IAAI,EAAE,MAAM,CAAC;IAAC,KAAK,EAAE,OAAO,CAAA;CAAE,GAAG,SAAS,CAY3F"}
+{"version":3,"file":"routes.d.ts","sourceRoot":"","sources":["../../src/dashboard/routes.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,WAAW,CAAC;AAGrD;;;;GAIG;AAEH,MAAM,MAAM,cAAc,GACtB;IAAE,IAAI,EAAE,MAAM,CAAA;CAAE,GAChB;IAAE,IAAI,EAAE,QAAQ,CAAA;CAAE,GAClB;IAAE,IAAI,EAAE,YAAY,CAAA;CAAE,GACtB;IAAE,IAAI,EAAE,OAAO,CAAA;CAAE,GACjB;IAAE,IAAI,EAAE,UAAU,CAAA;CAAE,GACpB;IAAE,IAAI,EAAE,UAAU,CAAA;CAAE,GACpB;IAAE,IAAI,EAAE,MAAM,CAAA;CAAE,GAChB;IAAE,IAAI,EAAE,OAAO,CAAA;CAAE,GACjB;IAAE,IAAI,EAAE,UAAU,CAAA;CAAE,CAAC;AAEzB,8DAA8D;AAC9D,wBAAgB,mBAAmB,CAAC,QAAQ,EAAE,MAAM,GAAG,cAAc,CAoBpE;AAED;;;;;;;;GAQG;AACH,wBAAgB,mBAAmB,CAAC,MAAM,EAAE,eAAe,GAAG;IAAE,IAAI,EAAE,MAAM,CAAA;CAAE,GAAG,SAAS,CAIzF;AAED;;;;;;;;;;;;;GAaG;AACH,wBAAgB,gBAAgB,CAC9B,MAAM,EAAE,eAAe,EACvB,GAAG,EAAE,KAAK,GAAG,MAAM,GAClB;IAAE,IAAI,EAAE,MAAM,CAAC;IAAC,KAAK,EAAE,MAAM,CAAA;CAAE,GAAG,SAAS,CAM7C;AAED;;;;;;;;GAQG;AACH,wBAAgB,iBAAiB,CAAC,MAAM,EAAE,eAAe,GAAG,MAAM,GAAG,SAAS,CAI7E;AA2BD;;;;;;;;;;;;GAYG;AACH,wBAAgB,kBAAkB,CAAC,OAAO,EAAE,mBAAmB,GAAG,OAAO,CAYxE;AAOD;;;;;;GAMG;AACH;;;;GAIG;AACH,wBAAgB,gBAAgB,CAAC,IAAI,EAAE,MAAM,GAAG;IAAE,IAAI,EAAE,MAAM,CAAC;IAAC,KAAK,EAAE,OAAO,CAAA;CAAE,GAAG,SAAS,CAY3F"}