@valescoagency/runway 0.12.0 → 0.13.0

package/README.md

@@ -541,7 +541,7 @@ These are tractable, just not v1.
 
 ## Status
 
-0.12.0 — production-shaped and dogfooded against live Linear queues.
+0.13.0 — production-shaped and dogfooded against live Linear queues.
 The end-to-end pipeline (init → run → review → PR) is stable; surface
 may still shift as the orchestrator's policy and iteration mechanics
 mature. See [CHANGELOG.md](./CHANGELOG.md) for per-release detail.

package/dist/commands/dash.js

@@ -5,15 +5,22 @@ import { execa } from "execa";
  * runway-using project without cloning the runway repo or maintaining
  * a docker-compose file.
  *
- * Three verbs:
- *   up     pull the published image and run it as a detached
- *          container (`runway-dashboard`) with loopback ports and a
- *          named volume for the SQLite db.
- *   logs   stream `docker logs` for the container (`--follow` toggles
- *          `-f`; default tails recent output without following).
- *   stop   stop and `rm` the container. The named volume stays so
- *          history survives across restarts; explicit `--purge` drops
- *          the volume too.
+ * Four verbs:
+ *   up      pull the published image and run it as a detached
+ *           container (`runway-dashboard`) with loopback ports and a
+ *           named volume for the SQLite db.
+ *   logs    stream `docker logs` for the container (`--follow` toggles
+ *           `-f`; default tails recent output without following).
+ *   stop    stop and `rm` the container. The named volume stays so
+ *           history survives across restarts; explicit `--purge` drops
+ *           the volume too.
+ *   upgrade VA-451: pull a fresh image, then stop + `rm` the existing
+ *           container and start a new one against the same named
+ *           volume. The pull happens first so a failed pull leaves the
+ *           existing dashboard running. Schema migrations on the
+ *           SQLite db are idempotent (ALTER TABLE ADD COLUMN swallowed
+ *           on duplicate), so column-add releases like VA-450 carry
+ *           forward without operator intervention.
  *
  * Defaults to the `:latest` tag published by `.github/workflows/dashboard-image.yml`.
  * Override via `--image` or the `RUNWAY_DASHBOARD_IMAGE` env var.
@@ -39,6 +46,9 @@ const FORWARDED_ENV_KEYS = [
     "LINEAR_POLL_INTERVAL_SECONDS",
     "RUNWAY_LINEAR_TEAM",
     "RUNWAY_READY_LABEL",
+    // VA-452: workspace slug for the dashboard's `↗ open in Linear`
+    // affordance. Unset → identifiers render as plain text.
+    "RUNWAY_LINEAR_WORKSPACE",
 ];
 export function printDashUsage() {
     console.log(`runway dash — operate the runway operations dashboard
@@ -48,19 +58,25 @@ project without cloning the runway repo. The published image is
 ${DEFAULT_IMAGE}; override via --image or RUNWAY_DASHBOARD_IMAGE.
 
 USAGE
-  runway dash up   [--image=…] [--otlp-port=N] [--dashboard-port=N]
-  runway dash logs [--follow]
-  runway dash stop [--purge]
+  runway dash up      [--image=…] [--otlp-port=N] [--dashboard-port=N]
+  runway dash upgrade [--image=…] [--otlp-port=N] [--dashboard-port=N]
+  runway dash logs    [--follow]
+  runway dash stop    [--purge]
 
 VERBS
-  up     Pull and start the dashboard as a detached container
-         (\`${DEFAULT_CONTAINER_NAME}\`). Ports publish to 127.0.0.1
-         only; a named volume (\`${DEFAULT_VOLUME_NAME}\`) persists
-         the SQLite db across runs.
-  logs   Stream container logs (\`docker logs ${DEFAULT_CONTAINER_NAME}\`).
-         Pass --follow to tail with -f.
-  stop   Stop and remove the container. The named volume stays unless
-         --purge is passed.
+  up       Pull and start the dashboard as a detached container
+           (\`${DEFAULT_CONTAINER_NAME}\`). Ports publish to 127.0.0.1
+           only; a named volume (\`${DEFAULT_VOLUME_NAME}\`) persists
+           the SQLite db across runs.
+  upgrade  Pull a fresh image and replace the running container with
+           one based on it. The pull runs first, so if it fails the
+           existing container is left untouched. The named volume
+           (\`${DEFAULT_VOLUME_NAME}\`) is preserved across the
+           replacement — SQLite history + schema migrate forward.
+  logs     Stream container logs (\`docker logs ${DEFAULT_CONTAINER_NAME}\`).
+           Pass --follow to tail with -f.
+  stop     Stop and remove the container. The named volume stays unless
+           --purge is passed.
 
 OPTIONS
   --image=REF         Override the dashboard image reference.
@@ -85,15 +101,18 @@ OTEL EXPORTER
 }
 export function parseDashArgs(argv) {
     if (argv.length === 0) {
-        throw new Error("missing verb — expected one of: up, logs, stop. Run `runway dash --help`.");
+        throw new Error("missing verb — expected one of: up, upgrade, logs, stop. Run `runway dash --help`.");
     }
     const [verbRaw, ...rest] = argv;
     if (verbRaw === "--help" || verbRaw === "-h") {
         printDashUsage();
         process.exit(0);
     }
-    if (verbRaw !== "up" && verbRaw !== "logs" && verbRaw !== "stop") {
-        throw new Error(`unknown verb "${verbRaw}" — expected one of: up, logs, stop.`);
+    if (verbRaw !== "up" &&
+        verbRaw !== "logs" &&
+        verbRaw !== "stop" &&
+        verbRaw !== "upgrade") {
+        throw new Error(`unknown verb "${verbRaw}" — expected one of: up, upgrade, logs, stop.`);
     }
     const verb = verbRaw;
     let image;
@@ -196,6 +215,9 @@ export async function dashCommand(argv) {
         case "up":
             await dashUp(opts);
             return;
+        case "upgrade":
+            await dashUpgrade(opts);
+            return;
         case "logs":
             await dashLogs(opts);
             return;
@@ -252,6 +274,40 @@ async function dashUp(opts) {
     await execa("docker", args, { stdio: "inherit" });
     await printAccessHints(opts);
 }
+/**
+ * VA-451: pull-then-replace. The pull runs BEFORE the stop so a
+ * failed pull (network, auth, manifest mismatch) leaves the existing
+ * container running — we never take the dashboard down on a failed
+ * upgrade attempt. The named volume is preserved across the
+ * replacement; the dashboard's idempotent ALTER TABLE migrations
+ * handle any column adds on the new container's next boot.
+ */
+async function dashUpgrade(opts) {
+    console.log(`[runway dash] upgrade: pulling ${opts.image}`);
+    try {
+        await execa("docker", ["pull", opts.image], { stdio: "inherit" });
+    }
+    catch {
+        throw new Error(`failed to pull ${opts.image}. ` +
+            "The existing container is unchanged. " +
+            "If the image is private, run `docker login ghcr.io` first.");
+    }
+    const existing = await containerState(opts.containerName);
+    if (existing === "running") {
+        console.log(`[runway dash] upgrade: stopping ${opts.containerName}`);
+        await execa("docker", ["stop", opts.containerName], {
+            stdio: "inherit",
+        });
+    }
+    if (existing !== "absent") {
+        console.log(`[runway dash] upgrade: removing ${opts.containerName} (volume ${opts.volumeName} kept)`);
+        await execa("docker", ["rm", opts.containerName], { stdio: "inherit" });
+    }
+    const args = buildDockerRunArgs(opts);
+    console.log(`[runway dash] starting container ${opts.containerName}`);
+    await execa("docker", args, { stdio: "inherit" });
+    await printAccessHints(opts);
+}
 async function dashLogs(opts) {
     const args = ["logs"];
     if (opts.follow)

package/dist/dashboard/linear-sync.js

@@ -24,6 +24,7 @@ export function createLinearAdapter(opts) {
             identifier: raw.identifier,
             title: raw.title,
             status: state?.name ?? "",
+            statusType: state?.type ?? "",
             labels: labels.nodes.map((l) => l.name),
             projectId: project?.id ?? null,
             projectName: project?.name ?? null,
@@ -110,18 +111,29 @@ export function startLinearSync(opts) {
             // the preview.
             opts.storage.clearLinearQueuePositions();
             const at = new Date().toISOString();
-            queue.forEach((q, i) => {
+            // VA-453: issues whose Linear workflow-state type is `completed`
+            // or `canceled` get saved without a queue position so they drop
+            // out of the Todo queue preview even when they still carry the
+            // `ready-for-agent` label. The snapshot row stays in
+            // linear_snapshots so per-row status badges on the
+            // issue-process list continue to resolve.
+            let position = 0;
+            queue.forEach((q) => {
                 queuedIds.add(q.identifier);
+                const isInactive = q.statusType === "completed" || q.statusType === "canceled";
                 opts.storage.saveLinearSnapshot({
                     issueIdentifier: q.identifier,
                     snapshotAt: at,
                     status: q.status,
+                    statusType: q.statusType,
                     title: q.title,
                     labels: q.labels,
-                    queuePosition: i,
+                    queuePosition: isInactive ? null : position,
                     projectId: q.projectId,
                     projectName: q.projectName,
                 });
+                if (!isInactive)
+                    position += 1;
             });
             log("info", `[runway dashboard] linear sync: refreshed ready queue (${queue.length} issue${queue.length === 1 ? "" : "s"})`);
         }
@@ -144,6 +156,7 @@ export function startLinearSync(opts) {
                         issueIdentifier: r.identifier,
                         snapshotAt: at,
                         status: r.status,
+                        statusType: r.statusType,
                         title: r.title,
                         labels: r.labels,
                         queuePosition: null,

package/dist/dashboard/server.js

@@ -34,6 +34,7 @@ const MAX_BODY_BYTES = 10 * 1024 * 1024; // 10 MiB — generous; a runway drain
  */
 export function buildServer(storage, opts = {}) {
     const linearEnabled = opts.linearEnabled ?? false;
+    const linearWorkspace = opts.linearWorkspace ?? null;
     // VA-391: an in-process event bus is plumbed through every request
     // handler so the OTLP ingest paths can publish change events that
     // the SSE detail-pane stream re-emits to the browser. Callers can
@@ -41,7 +42,7 @@ export function buildServer(storage, opts = {}) {
     // production gets a fresh per-server bus.
     const events = opts.events ?? createEventBus();
     return createServer((req, res) => {
-        handle(req, res, storage, linearEnabled, events).catch((err) => {
+        handle(req, res, storage, linearEnabled, linearWorkspace, events).catch((err) => {
             writeError(res, 500, "internal_error", asMessage(err));
         });
     });
@@ -53,6 +54,7 @@ export function buildServer(storage, opts = {}) {
 export async function startServer(opts) {
     const server = buildServer(opts.storage, {
         linearEnabled: opts.linearEnabled,
+        linearWorkspace: opts.linearWorkspace,
         events: opts.events,
     });
     const port = opts.port ?? 4318;
@@ -74,7 +76,7 @@ export async function startServer(opts) {
         }),
     };
 }
-async function handle(req, res, storage, linearEnabled, events) {
+async function handle(req, res, storage, linearEnabled, linearWorkspace, events) {
     // Route on method + path. Nothing fancy — slice 1 only has two
     // endpoints; a router becomes worth its weight in slice 2.
     const url = req.url ?? "/";
@@ -88,14 +90,14 @@ async function handle(req, res, storage, linearEnabled, events) {
         return;
     }
     if (method === "GET" && (url === "/" || url.startsWith("/?"))) {
-        handleListView(req, res, storage, linearEnabled);
+        handleListView(req, res, storage, linearEnabled, linearWorkspace);
         return;
     }
     // VA-391: fragment endpoint returns just the tbody so the list view
     // can poll via htmx without redrawing the rest of the page.
     if (method === "GET" &&
         (url === "/issue-processes" || url.startsWith("/issue-processes?"))) {
-        handleIssueProcessRowsFragment(req, res, storage, linearEnabled);
+        handleIssueProcessRowsFragment(req, res, storage, linearEnabled, linearWorkspace);
         return;
     }
     if (method === "GET") {
@@ -111,7 +113,7 @@ async function handle(req, res, storage, linearEnabled, events) {
         const issueProcessMatch = ISSUE_PROCESS_DETAIL_RE.exec(pathOnly);
         if (issueProcessMatch) {
             const spanId = decodeURIComponent(issueProcessMatch[1] ?? "");
-            handleIssueProcessDetailView(res, storage, spanId);
+            handleIssueProcessDetailView(res, storage, spanId, linearWorkspace);
             return;
         }
         // VA-407: meta-review list + detail. List matches the bare path or
@@ -133,7 +135,7 @@ async function handle(req, res, storage, linearEnabled, events) {
         if (detailMatch) {
             const traceId = decodeURIComponent(detailMatch[1] ?? "");
             const spanId = decodeURIComponent(detailMatch[2] ?? "");
-            handleDetailView(res, storage, traceId, spanId);
+            handleDetailView(res, storage, traceId, spanId, linearWorkspace);
             return;
         }
     }
@@ -318,7 +320,7 @@ function handleIssueProcessStream(req, res, storage, events, spanId) {
  * preview and drain summary strip stay static between polls — they
  * have their own swap triggers (or sit above the polling target).
  */
-function handleIssueProcessRowsFragment(req, res, storage, linearEnabled) {
+function handleIssueProcessRowsFragment(req, res, storage, linearEnabled, linearWorkspace) {
     // VA-392: the fragment endpoint applies the same filter state as the
     // full list view so a polled refresh doesn't reset the user's chips.
     // The query string is the source of truth — htmx mirrors the page's
@@ -336,6 +338,7 @@ function handleIssueProcessRowsFragment(req, res, storage, linearEnabled) {
         linearEnabled,
         snapshotsByIdentifier,
         isFiltered: isFilteredState(filterState),
+        linearWorkspace,
     });
     res.writeHead(200, { "content-type": "text/html; charset=utf-8" });
     res.end(html);
@@ -346,7 +349,7 @@ function writeSseFrame(res, event, data) {
     const lines = data.split("\n").map((line) => `data: ${line}`).join("\n");
     res.write(`event: ${event}\n${lines}\n\n`);
 }
-function handleListView(req, res, storage, linearEnabled) {
+function handleListView(req, res, storage, linearEnabled, linearWorkspace) {
     // VA-392: filter chips state is encoded in the URL query string so
     // the view is shareable. Parse once and reuse both for the storage
     // query and the chip render (the latter needs to know which chips
@@ -378,6 +381,7 @@ function handleListView(req, res, storage, linearEnabled) {
         filterState,
         recentDrains,
         isFiltered: isFilteredState(filterState),
+        linearWorkspace,
     });
     res.writeHead(200, { "content-type": "text/html; charset=utf-8" });
     res.end(html);
@@ -471,28 +475,28 @@ function formatSqliteDatetime(d) {
  * (trace_id, span_id) pair doesn't match a known issue process — the
  * dashboard never auto-creates rows from a URL.
  */
-function handleDetailView(res, storage, traceId, spanId) {
+function handleDetailView(res, storage, traceId, spanId, linearWorkspace) {
     const ip = storage.getIssueProcess(traceId, spanId);
     if (!ip) {
         writeError(res, 404, "not_found", `no issue process for trace=${traceId} span=${spanId}`);
         return;
     }
-    renderDetailFor(res, storage, ip);
+    renderDetailFor(res, storage, ip, linearWorkspace);
 }
 /**
  * VA-387: detail-route handler keyed on the issue process span_id
  * alone. Reuses the same view model as the older two-segment route
  * once the row is resolved.
  */
-function handleIssueProcessDetailView(res, storage, spanId) {
+function handleIssueProcessDetailView(res, storage, spanId, linearWorkspace) {
     const ip = storage.getIssueProcessBySpanId(spanId);
     if (!ip) {
         writeError(res, 404, "not_found", `no issue process for span=${spanId}`);
         return;
     }
-    renderDetailFor(res, storage, ip);
+    renderDetailFor(res, storage, ip, linearWorkspace);
 }
-function renderDetailFor(res, storage, ip) {
+function renderDetailFor(res, storage, ip, linearWorkspace) {
     const iterations = storage.listAgentIterations(ip.traceId, ip.spanId);
     const phaseSpans = storage.listPhaseSpans(ip.traceId, ip.spanId, [
         ...DETAIL_PHASE_NAMES,
@@ -507,6 +511,7 @@ function renderDetailFor(res, storage, ip) {
         iterations,
         phaseSpans,
         logs,
+        linearWorkspace,
     });
     res.writeHead(200, { "content-type": "text/html; charset=utf-8" });
     res.end(html);
@@ -652,6 +657,13 @@ export async function main() {
     // and start polling at LINEAR_POLL_INTERVAL_SECONDS (default 300).
     const linearApiKey = process.env.LINEAR_API_KEY;
     const linearEnabled = Boolean(linearApiKey);
+    // VA-452: workspace slug for the `↗ open in Linear` affordance.
+    // Trim + collapse empty to null so a stray empty env var doesn't
+    // produce broken `linear.app//issue/...` URLs.
+    const linearWorkspaceRaw = process.env.RUNWAY_LINEAR_WORKSPACE?.trim();
+    const linearWorkspace = linearWorkspaceRaw && linearWorkspaceRaw.length > 0
+        ? linearWorkspaceRaw
+        : null;
     let linearSync = null;
     if (linearApiKey) {
         const adapter = createLinearAdapter({
@@ -675,6 +687,7 @@ export async function main() {
         port: otlpPort,
         host: otlpHost,
         linearEnabled,
+        linearWorkspace,
     });
     // The two listeners can share a server only when both port AND host
     // match — different bind addresses need different listeners.
@@ -685,6 +698,7 @@ export async function main() {
             port: dashboardPort,
             host: dashboardHost,
             linearEnabled,
+            linearWorkspace,
         });
     console.log(`[runway dashboard] OTLP ${otlpHost}:${otlp.port} · dashboard ${dashboardHost}:${dashboard.port}; sqlite=${sqlitePath}`);
     const shutdown = async (signal) => {

package/dist/dashboard/storage.js

@@ -101,7 +101,8 @@ const SCHEMA = `
     labels_json TEXT,
     queue_position INTEGER,
     project_id TEXT,
-    project_name TEXT
+    project_name TEXT,
+    status_type TEXT
   );
 
   CREATE INDEX IF NOT EXISTS idx_linear_snapshots_queue_position
@@ -294,6 +295,10 @@ export function createStorage(path, opts = {}) {
         // VA-450: project Name + UUID for the Todo queue Project column.
         `ALTER TABLE linear_snapshots ADD COLUMN project_id TEXT`,
         `ALTER TABLE linear_snapshots ADD COLUMN project_name TEXT`,
+        // VA-453: workflow-state TYPE (not name) for cancelled/done queue
+        // filtering. Old rows decode to "" — the poller only filters on
+        // known type values so pre-migration rows behave unchanged.
+        `ALTER TABLE linear_snapshots ADD COLUMN status_type TEXT`,
     ]) {
         try {
             db.exec(sql);
@@ -409,8 +414,8 @@ export function createStorage(path, opts = {}) {
     const upsertLinearSnapshot = db.prepare(`
     INSERT INTO linear_snapshots (
       issue_identifier, snapshot_at, status, title, labels_json, queue_position,
-      project_id, project_name
-    ) VALUES (?, ?, ?, ?, ?, ?, ?, ?)
+      project_id, project_name, status_type
+    ) VALUES (?, ?, ?, ?, ?, ?, ?, ?, ?)
     ON CONFLICT (issue_identifier) DO UPDATE SET
       snapshot_at = excluded.snapshot_at,
       status = excluded.status,
@@ -418,19 +423,20 @@ export function createStorage(path, opts = {}) {
       labels_json = excluded.labels_json,
       queue_position = excluded.queue_position,
       project_id = excluded.project_id,
-      project_name = excluded.project_name
+      project_name = excluded.project_name,
+      status_type = excluded.status_type
   `);
     const clearQueuePositionsStmt = db.prepare(`UPDATE linear_snapshots SET queue_position = NULL`);
     const listTodoQueueStmt = db.prepare(`
     SELECT issue_identifier, snapshot_at, status, title, labels_json, queue_position,
-           project_id, project_name
+           project_id, project_name, status_type
     FROM linear_snapshots
     WHERE queue_position IS NOT NULL
     ORDER BY queue_position ASC
   `);
     const listAllSnapshotsStmt = db.prepare(`
     SELECT issue_identifier, snapshot_at, status, title, labels_json, queue_position,
-           project_id, project_name
+           project_id, project_name, status_type
     FROM linear_snapshots
   `);
     // VA-391: "active drain" = a trace_id with one or more
@@ -626,7 +632,7 @@ export function createStorage(path, opts = {}) {
     };
     const listAggregates = () => selectAggregates.all().map(rowToAggregate);
     const saveLinearSnapshot = (s) => {
-        upsertLinearSnapshot.run(s.issueIdentifier, s.snapshotAt, s.status, s.title, s.labels.length === 0 ? null : JSON.stringify(s.labels), s.queuePosition, s.projectId, s.projectName);
+        upsertLinearSnapshot.run(s.issueIdentifier, s.snapshotAt, s.status, s.title, s.labels.length === 0 ? null : JSON.stringify(s.labels), s.queuePosition, s.projectId, s.projectName, s.statusType);
     };
     const clearLinearQueuePositions = () => {
         clearQueuePositionsStmt.run();
@@ -872,6 +878,7 @@ function rowToLinearSnapshot(row) {
         queuePosition: nullableNum(r.queue_position),
         projectId: r.project_id == null ? null : String(r.project_id),
         projectName: r.project_name == null ? null : String(r.project_name),
+        statusType: r.status_type == null ? "" : String(r.status_type),
     };
 }
 /**

package/dist/dashboard/views.js

@@ -34,6 +34,9 @@ const SHARED_STYLE = `
     .detail { color: #d4d4d8; }
     .muted { color: #9ca3af; }
     .project-uuid { color: #9ca3af; font-size: 11px; display: block; }
+    .linear-link { color: #6b7280; text-decoration: none; margin-left: 6px;
+                   font-size: 11px; vertical-align: middle; }
+    .linear-link:hover { color: #93c5fd; }
     code { background: #1f2937; padding: 1px 6px; border-radius: 3px; }
     .status-badge { display: inline-block; margin-left: 8px;
                     padding: 1px 6px; border-radius: 3px; font-size: 11px;
@@ -53,13 +56,17 @@ export function renderListView(input) {
     const filterState = vm.filterState ?? EMPTY_FILTER_STATE;
     const isFiltered = vm.isFiltered ?? false;
     const recentDrains = vm.recentDrains ?? [];
+    const linearWorkspace = vm.linearWorkspace ?? null;
     const tableBody = renderIssueProcessRows({
         rows: vm.rows,
         linearEnabled: vm.linearEnabled,
         snapshotsByIdentifier: vm.snapshotsByIdentifier,
         isFiltered,
+        linearWorkspace,
     });
-    const queueSection = vm.linearEnabled ? renderTodoQueue(vm.todoQueue) : "";
+    const queueSection = vm.linearEnabled
+        ? renderTodoQueue(vm.todoQueue, linearWorkspace)
+        : "";
     // VA-391: drain summary strip renders ABOVE the queue + run list
     // so the operator sees in-flight progress at the top of the page.
     const drainStrip = renderDrainStrip(vm.activeDrain ?? null);
@@ -191,10 +198,24 @@ export function renderIssueProcessRows(input) {
         }
         return `<tr><td colspan="4" class="empty">No issue processes yet. Run <code>runway run</code> with <code>OTEL_EXPORTER_OTLP_ENDPOINT</code> pointing here to populate.</td></tr>`;
     }
+    const linearWorkspace = input.linearWorkspace ?? null;
     return input.rows
-        .map((r) => renderRow(r, input.snapshotsByIdentifier))
+        .map((r) => renderRow(r, input.snapshotsByIdentifier, linearWorkspace))
         .join("");
 }
+/**
+ * VA-452: render the `↗` anchor that opens the issue in Linear, or
+ * an empty string when the workspace slug isn't configured. Kept
+ * tiny + identifier-agnostic so every render site uses the same
+ * shape. Linear's URL accepts the identifier alone — no slug needed,
+ * the server redirects to the canonical URL.
+ */
+function linearIssueLink(identifier, workspace) {
+    if (workspace == null || workspace === "")
+        return "";
+    const url = `https://linear.app/${encodeURIComponent(workspace)}/issue/${encodeURIComponent(identifier)}`;
+    return ` <a class="linear-link" target="_blank" rel="noopener noreferrer" title="Open ${escapeHtml(identifier)} in Linear" href="${escapeHtml(url)}">↗</a>`;
+}
 // ---------------------------------------------------------------------------
 // VA-392: filter chips
 // ---------------------------------------------------------------------------
@@ -315,10 +336,10 @@ export function filterStateToQueryString(state) {
  * with an empty-state row so the operator knows the poller ran and
  * found nothing to pick up.
  */
-function renderTodoQueue(queue) {
+function renderTodoQueue(queue, linearWorkspace) {
     const body = queue.length === 0
-        ? `<tr><td colspan="4" class="empty">Linear Todo queue is empty.</td></tr>`
-        : queue.map(renderQueueRow).join("");
+        ? `<tr><td colspan="5" class="empty">Linear Todo queue is empty.</td></tr>`
+        : queue.map((s) => renderQueueRow(s, linearWorkspace)).join("");
     return `<h2>Todo queue (next up)</h2>
   <table>
     <thead>
@@ -326,13 +347,14 @@ function renderTodoQueue(queue) {
         <th>Issue</th>
         <th>Title</th>
         <th>Labels</th>
+        <th>Status</th>
         <th>Project</th>
       </tr>
     </thead>
     <tbody>${body}</tbody>
   </table>`;
 }
-function renderQueueRow(s) {
+function renderQueueRow(s, linearWorkspace) {
     const labels = s.labels.length === 0 ? "" : s.labels.join(", ");
     // VA-450: project cell shows the name on top with the UUID muted
     // underneath in the same column. Unprojected issues degrade to an
@@ -343,14 +365,20 @@ function renderQueueRow(s) {
             (s.projectId == null
                 ? ""
                 : `<span class="project-uuid">${escapeHtml(s.projectId)}</span>`);
+    // VA-453: workflow status display name. Empty → em-dash so the
+    // column is never visually empty.
+    const status = s.status === ""
+        ? `<span class="muted">—</span>`
+        : escapeHtml(s.status);
     return `<tr>
-    <td class="id">${escapeHtml(s.issueIdentifier)}</td>
+    <td class="id">${escapeHtml(s.issueIdentifier)}${linearIssueLink(s.issueIdentifier, linearWorkspace)}</td>
     <td class="detail">${escapeHtml(s.title)}</td>
     <td class="muted">${escapeHtml(labels)}</td>
+    <td class="detail">${status}</td>
     <td class="detail">${project}</td>
   </tr>`;
 }
-function renderRow(r, snapshots) {
+function renderRow(r, snapshots, linearWorkspace) {
     const kind = r.outcomeKind ?? "pending";
     const outcomeCls = `outcome outcome-${escapeHtml(kind)}`;
     // VA-387: canonical detail link uses the span_id alone.
@@ -367,7 +395,7 @@ function renderRow(r, snapshots) {
         ? `<span class="status-badge">${escapeHtml(snapshot.status)}</span>`
         : "";
     return `<tr>
-    <td class="id"><a href="${escapeHtml(href)}">${escapeHtml(r.issueIdentifier)}</a>${statusBadge}</td>
+    <td class="id"><a href="${escapeHtml(href)}">${escapeHtml(r.issueIdentifier)}</a>${linearIssueLink(r.issueIdentifier, linearWorkspace)}${statusBadge}</td>
     <td class="${outcomeCls}">${escapeHtml(kind)}</td>
     <td class="detail">${escapeHtml(r.outcomeDetail ?? "")}</td>
     <td>${escapeHtml(r.insertedAt)}</td>
@@ -450,7 +478,7 @@ export function renderDetailView(vm) {
 </head>
 <body>
   <div class="breadcrumb"><a href="/">← all issue processes</a></div>
-  <h1>${escapeHtml(ip.issueIdentifier)} · <span class="${outcomeCls}">${escapeHtml(kind)}</span></h1>
+  <h1>${escapeHtml(ip.issueIdentifier)}${linearIssueLink(ip.issueIdentifier, vm.linearWorkspace ?? null)} · <span class="${outcomeCls}">${escapeHtml(kind)}</span></h1>
   ${titleLine}
   <div class="meta">
     <div><span class="label">branch:</span><code>${escapeHtml(ip.branch ?? "—")}</code></div>

package/dist/linear.js

@@ -357,6 +357,28 @@ export function createLinearGateway(config, limiter = null) {
                             continue;
                         if (labels.includes(config.hitlLabel))
                             continue;
+                        // VA-453: skip issues whose workflow state is already
+                        // terminal (`completed` / `canceled`). Operators sometimes
+                        // mark an issue Done but forget to strip
+                        // `ready-for-agent`; without this check the drain would
+                        // pick up a Done ticket and waste a sandcastle run.
+                        // Filtering by `state.type` (not display name) is robust
+                        // to teams renaming "Cancelled" to "Won't fix" or
+                        // similar. Missing/undecodable state falls through
+                        // (treated as non-terminal) — matches the
+                        // `hasActiveBlocker` posture for the same edge case.
+                        try {
+                            const state = await raw.state;
+                            if (state) {
+                                const stateType = decodeWorkflowStateTypeNode(state).type;
+                                if (isTerminalStateType(stateType))
+                                    continue;
+                            }
+                        }
+                        catch {
+                            // Schema drift or transient SDK error — fall through
+                            // to the existing checks rather than blocking the drain.
+                        }
                         if (await hasActiveBlocker(raw))
                             continue;
                         if (await hasChildIssues(raw)) {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@valescoagency/runway",
-  "version": "0.12.0",
+  "version": "0.13.0",
   "description": "Linear-driven orchestrator + scaffolder for coding agents on Sandcastle. `runway init` scaffolds a target repo (sandcastle + varlock + 1Password); `runway run` drains a Linear queue against it; `runway doctor`, `runway upgrade`, `runway upgrade-repo` round out the lifecycle.",
   "license": "MIT",
   "author": {