@catalyst-cloud/sdk 0.14.2 → 0.16.0

package/dist/node.js

@@ -5073,10 +5073,18 @@ var currentStateEventTypes = {
   }
 };
 var telemetryEventTypes = {
+  "catalyst.mirror.request.summary": {
+    reason: "CTC-4063 \u2014 one request per route and verified caller. Sampling would discard the distribution required for per-key usage.",
+    sampling: { kind: "always" }
+  },
   "telemetry.ingest.tenant-forged": {
     reason: "CTC-2788 \u2014 a gateway payload named a tenant other than its token's on `account_id` or `catalyst.tenant`, and the gateway overwrote it. Rare by construction: a current runner image emits `catalyst.tenant` equal to its own tenant, so this fires only on a stale or wrong token, or on a deliberate forgery. Each occurrence is independently actionable (which tenant held the token, which tenant was claimed, which signal), so it is never sampled away.",
     sampling: { kind: "always" }
   },
+  "telemetry.ingest.scope-forged": {
+    reason: "CTC-2789 \u2014 a gateway payload claimed `catalyst.scope` itself (e.g. `platform`), and the gateway overwrote it to `tenant`, the only scope a tenant credential can ever write. Rare by construction: no producer in this repo sets the attribute, so this fires only on a stale image or a deliberate forgery. Each occurrence is independently actionable (which tenant held the token, which scope was claimed, which signal), so it is never sampled away.",
+    sampling: { kind: "always" }
+  },
   "account.ratelimit.sampled": {
     reason: "A periodic provider rate-limit budget reading \u2014 a gauge, not a state transition."
   },
@@ -5721,6 +5729,18 @@ function stateBucketClause(bucket) {
 }
 var STATE_KEY_SQL = stateKeySql("issues");
 var DONE_KEY_PLACEHOLDERS = DONE_STATE_KEYS.map(() => "?").join(", ");
+function openStateLiteralSql(stateColumn) {
+  const literals = DONE_STATE_KEYS.map((key) => `'${key.replace(/'/g, "''")}'`).join(", ");
+  return `replace(lower(trim(${stateColumn})), ' ', '_') NOT IN (${literals})`;
+}
+var OPEN_ASSIGNEE_INDEX_WHERE = `removed_at IS NULL AND ${openStateLiteralSql("state")}`;
+function whereHash(text2) {
+  let hash = 2166136261;
+  for (let i = 0; i < text2.length; i++)
+    hash = Math.imul(hash ^ text2.charCodeAt(i), 16777619) >>> 0;
+  return hash.toString(16).padStart(8, "0");
+}
+var OPEN_ASSIGNEE_INDEX_NAME = `idx_issues_open_assignee_${whereHash(OPEN_ASSIGNEE_INDEX_WHERE)}`;
 var OPEN_BLOCKED_TARGETS_SQL = `FROM relations r WHERE r.issue_identifier = issues.identifier AND r.type = 'blocks' AND NOT EXISTS (SELECT 1 FROM issues ri WHERE ri.identifier = r.related_identifier AND ri.removed_at IS NULL AND ${stateKeySql("ri")} IN (${DONE_KEY_PLACEHOLDERS}))`;
 function blockedOpenCountSql() {
   return `(SELECT COUNT(*) ${OPEN_BLOCKED_TARGETS_SQL})`;
@@ -5731,7 +5751,14 @@ function waitingOnMeClause(linearUserId, mode, carried = null) {
   const notDone = `${STATE_KEY_SQL} NOT IN (${DONE_KEY_PLACEHOLDERS})`;
   const declared = `(issues.assignee_id = ? AND ${notDone} AND EXISTS (SELECT 1 FROM issue_labels il JOIN labels l ON l.id = il.label_id WHERE il.issue_id = issues.id AND (l.name = ? OR substr(l.name, 1, 4) = ?) AND l.removed_at IS NULL))`;
   const declaredBindings = [linearUserId, ...DONE_STATE_KEYS, ASK_LABEL, ASK_LABEL_PREFIX];
-  if (mode === "asks") return { sql: ` AND ${declared}`, bindings: declaredBindings };
+  const openForMember = ` AND issues.assignee_id = ? AND ${openStateLiteralSql("issues.state")}`;
+  const notDecidedAsk = ` AND NOT (EXISTS (SELECT 1 FROM issue_labels dil JOIN labels dl ON dl.id = dil.label_id WHERE dil.issue_id = issues.id AND (dl.name = ? OR substr(dl.name, 1, 4) = ?) AND dl.removed_at IS NULL) AND EXISTS (SELECT 1 FROM comments dc WHERE dc.issue_id = issues.id AND dc.removed_at IS NULL AND dc.body LIKE 'DECIDED:%'))`;
+  const notDecidedAskBindings = [ASK_LABEL, ASK_LABEL_PREFIX];
+  if (mode === "asks")
+    return {
+      sql: `${openForMember}${notDecidedAsk} AND ${declared}`,
+      bindings: [linearUserId, ...notDecidedAskBindings, ...declaredBindings]
+    };
   const blocksSomethingUnfinished = `EXISTS (SELECT 1 ${OPEN_BLOCKED_TARGETS_SQL})`;
   const notAlreadyAsked = (
     // ⛔ CTC-4306 — `CROSS JOIN`, NOT `JOIN`: SQLite never reorders a CROSS JOIN, so `ar` stays the
@@ -5755,11 +5782,14 @@ function waitingOnMeClause(linearUserId, mode, carried = null) {
   }
   const inferred = `(issues.assignee_id = ? AND issues.delegate_id IS NULL AND ${notDone} AND ${notBacklogDeferred} AND ${blocksSomethingUnfinished} AND ${notAlreadyAsked}${notCarried})`;
   return {
-    sql: ` AND (${declared} OR ${inferred})`,
+    sql: `${openForMember}${notDecidedAsk} AND (${declared} OR ${inferred})`,
     // ⚠️ `DONE_STATE_KEYS` THREE TIMES — this row's own `notDone`, the far-end `IN` list inside the
     // blocking-edge NOT EXISTS, and the covering-ask's own done-list. A missed copy shifts every
-    // parameter after it.
+    // parameter after it. The first binding is `openForMember`'s member id (CTC-4505), then the
+    // decided-ask label family (CTC-5111).
     bindings: [
+      linearUserId,
+      ...notDecidedAskBindings,
       ...declaredBindings,
       linearUserId,
       ...DONE_STATE_KEYS,
@@ -5805,36 +5835,57 @@ function resolveUser(sql2, id) {
 }
 
 // node_modules/@catalyst-cloud/read-model/src/issues.ts
-function resolveBlockedOnAsk(sql2, identifiers) {
+function readAskEdges(sql2, identifiers) {
   const ids = uniqueKeys(identifiers);
-  const out = /* @__PURE__ */ new Map();
-  if (ids.length === 0) return out;
+  if (ids.length === 0) return [];
   const cond = openAskBlockerConditions("ai");
+  const flagBindings = [ASK_LABEL, ...cond.bindings];
+  const step = MAX_BOUND_PARAMS - flagBindings.length;
   const rows = [];
-  const step = MAX_BOUND_PARAMS - cond.bindings.length;
   for (let i = 0; i < ids.length; i += step) {
     const chunk = ids.slice(i, i + step);
     const placeholders2 = chunk.map(() => "?").join(", ");
     rows.push(
       ...sql2.exec(
-        `SELECT ar.related_identifier AS held_identifier, ai.identifier AS ask_identifier,
-                  ai.assignee_id AS ask_assignee_id, ai.assignee AS ask_assignee_legacy,
-                  ai.created_at AS ask_created_at
+        `SELECT ar.related_identifier AS subject_identifier,
+                  ai.identifier  AS ask_identifier,
+                  ai.title       AS ask_title,
+                  ai.state       AS ask_state,
+                  ai.state_type  AS ask_state_type,
+                  ai.assignee_id AS ask_assignee_id,
+                  ai.assignee    AS ask_assignee_legacy,
+                  ai.created_at  AS ask_created_at,
+                  ai.updated_at  AS ask_updated_at,
+                  CASE WHEN ai.title LIKE 'Unblock ' || ar.related_identifier || ' %'
+                       THEN 1 ELSE 0 END AS is_subject,
+                  EXISTS (SELECT 1 FROM issue_labels ail JOIN labels al ON al.id = ail.label_id
+                          WHERE ail.issue_id = ai.id AND al.name = ? AND al.removed_at IS NULL)
+                    AS is_covering,
+                  CASE WHEN ${cond.sql} THEN 1 ELSE 0 END AS is_open_blocker
            FROM relations ar
            JOIN issues ai ON ai.identifier = ar.issue_identifier AND ai.removed_at IS NULL
-           WHERE ar.type IN ('blocks', 'related') AND ar.related_identifier IN (${placeholders2}) AND ${cond.sql}
+           WHERE ar.type IN ('blocks', 'related') AND ar.related_identifier IN (${placeholders2})
            ORDER BY ai.created_at IS NULL, ai.created_at ASC`,
-        ...chunk,
-        ...cond.bindings
+        ...flagBindings,
+        ...chunk
       ).toArray()
     );
   }
+  return rows;
+}
+function resolveBlockedOnAsk(sql2, identifiers) {
+  return blockedOnAskFromEdges(sql2, readAskEdges(sql2, identifiers));
+}
+function blockedOnAskFromEdges(sql2, edges) {
+  const out = /* @__PURE__ */ new Map();
+  const rows = edges.filter((r) => r["is_open_blocker"] === 1);
+  if (rows.length === 0) return out;
   const users2 = resolveUsersByIds(
     sql2,
     rows.map((r) => r["ask_assignee_id"])
   );
   for (const r of rows) {
-    const held = String(r["held_identifier"]);
+    const held = String(r["subject_identifier"]);
     if (out.has(held)) continue;
     const assigneeId = r["ask_assignee_id"] == null ? null : String(r["ask_assignee_id"]);
     out.set(held, {
@@ -5847,6 +5898,7 @@ function resolveBlockedOnAsk(sql2, identifiers) {
   return out;
 }
 var RELATED_STATE_SUBQUERY = `(SELECT ri.state FROM issues ri WHERE ri.identifier = relations.related_identifier AND ri.removed_at IS NULL LIMIT 1) AS related_state`;
+var RELATED_TITLE_SUBQUERY = `(SELECT ri.title FROM issues ri WHERE ri.identifier = relations.related_identifier AND ri.removed_at IS NULL LIMIT 1) AS related_title`;
 var MAX_COVERING_ASKS = 5;
 var ANSWERED_STATE_KEYS = ["done", "completed", "released"];
 var CLOSED_UNANSWERED_STATE_KEYS = ["canceled", "cancelled", "duplicate"];
@@ -5985,6 +6037,7 @@ function drivingFacet(scope) {
   if (scope?.labelId?.trim()) return "label";
   if (scope?.initiativeId?.trim()) return "initiative";
   if (scope?.cycleId?.trim()) return "cycle";
+  if (scope?.stateName?.trim()) return "state";
   return null;
 }
 function issueScopeClause(scope) {
@@ -6005,6 +6058,13 @@ function issueScopeClause(scope) {
     facetSql += " AND priority = ?";
     facetBindings.push(scope.priority);
   }
+  const stateName = scope?.stateName?.trim();
+  if (stateName) {
+    const key = `${stateKeySql("issues")} = replace(lower(trim(?)), ' ', '_')`;
+    facetSql += driver === "state" ? ` AND issues.rowid IN (SELECT rowid FROM issues WHERE removed_at IS NULL AND ${key})` : ` AND ${key}`;
+    facetSql += " AND lower(trim(state)) = lower(trim(?))";
+    facetBindings.push(stateName, stateName);
+  }
   const assignee = scope?.assignee;
   const assigneeId = assignee?.linearUserId?.trim();
   const assigneeName = assignee?.name?.trim();
@@ -6117,7 +6177,8 @@ function hydrateIssueRows(sql2, issueRows) {
   const relationRows = execInChunks(
     sql2,
     issueRows.map((r) => r["identifier"]),
-    (p) => `SELECT id, type, issue_identifier, related_identifier, ${RELATED_STATE_SUBQUERY}
+    (p) => `SELECT id, type, issue_identifier, related_identifier, ${RELATED_STATE_SUBQUERY},
+       ${RELATED_TITLE_SUBQUERY}
        FROM relations
        WHERE issue_identifier IN (${p})`
   );
@@ -6129,30 +6190,17 @@ function hydrateIssueRows(sql2, issueRows) {
       type: r["type"] ?? null,
       issue_identifier: r["issue_identifier"] ?? null,
       related_identifier: r["related_identifier"] ?? null,
-      related_state: r["related_state"] ?? null
+      related_state: r["related_state"] ?? null,
+      related_title: r["related_title"] ?? null
     });
     relationsByIdentifier.set(identifier, list);
   }
-  const coveringByIdentifier = /* @__PURE__ */ new Map();
-  const coveringRows = execInChunks(
+  const askEdges = readAskEdges(
     sql2,
-    issueRows.map((r) => r["identifier"]),
-    (p) => `SELECT ar.related_identifier AS subject_identifier,
-                   ai.identifier  AS ask_identifier,
-                   ai.title       AS ask_title,
-                   ai.state       AS ask_state,
-                   ai.state_type  AS ask_state_type,
-                   ai.assignee_id AS ask_assignee_id,
-                   ai.updated_at  AS ask_updated_at,
-                   CASE WHEN ai.title LIKE 'Unblock ' || ar.related_identifier || ' %'
-                        THEN 1 ELSE 0 END AS is_subject
-            FROM relations ar
-            JOIN issues ai ON ai.identifier = ar.issue_identifier AND ai.removed_at IS NULL
-            WHERE ar.type IN ('blocks', 'related') AND ar.related_identifier IN (${p})
-              AND EXISTS (SELECT 1 FROM issue_labels ail JOIN labels al ON al.id = ail.label_id
-                          WHERE ail.issue_id = ai.id AND al.name = ? AND al.removed_at IS NULL)`,
-    [ASK_LABEL]
+    issueRows.map((r) => r["identifier"])
   );
+  const coveringByIdentifier = /* @__PURE__ */ new Map();
+  const coveringRows = askEdges.filter((r) => r["is_covering"] === 1);
   for (const r of coveringRows) {
     const subjectIdentifier = String(r["subject_identifier"]);
     const state = r["ask_state"];
@@ -6198,10 +6246,7 @@ function hydrateIssueRows(sql2, issueRows) {
       }))
     );
   }
-  const blockedByIdentifier = resolveBlockedOnAsk(
-    sql2,
-    issueRows.map((r) => r["identifier"])
-  );
+  const blockedByIdentifier = blockedOnAskFromEdges(sql2, askEdges);
   return issueRows.map((r) => {
     const id = String(r["id"]);
     const identifier = r["identifier"] ?? null;
@@ -6265,14 +6310,16 @@ function buildIssuesView(sql2, limit = DEFAULT_VIEW_LIMIT, offset = 0, scope) {
 var BLOCKED_COUNT_SQL = blockedOpenCountSql();
 var AGE_UNKNOWN_SENTINEL = 253402300799e3;
 var AGE_KEY_SQL = `COALESCE(created_at, updated_at, ${AGE_UNKNOWN_SENTINEL})`;
-function buildIssueDetail(sql2, identifier) {
+var NO_ROWS = { exec: () => ({ toArray: () => [] }) };
+function buildIssueDetail(sql2, identifier, opts = {}) {
+  const sqlFor = (section) => opts.include?.has(section) ?? true ? sql2 : NO_ROWS;
   const issueRows = sql2.exec(
     `SELECT id, identifier, title, description, state, state_id, assignee, assignee_id, priority, estimate,
               project_id, cycle_id, team_id, team_key, team_name,
               delegate_id, delegate_name, bot_actor_name, bot_actor_type, bot_actor_sub_type,
               parent_id, parent_identifier,
               url, started_at, completed_at, canceled_at, created_at, due_date,
-              priority_label, sort_order, updated_at
+              priority_label, sort_order, updated_at, ${opts.include == null || opts.include.has("blockers") ? effectiveStateTypeSql("issues") : "NULL"} AS state_type
        FROM issues WHERE identifier = ? AND removed_at IS NULL LIMIT 1`,
     identifier
   ).toArray();
@@ -6286,7 +6333,7 @@ function buildIssueDetail(sql2, identifier) {
   let projectProgress = null;
   let projectHealth = null;
   if (projectId != null) {
-    const projectRows = sql2.exec(
+    const projectRows = sqlFor("project").exec(
       "SELECT name, state, description, progress, health FROM projects WHERE id = ? AND removed_at IS NULL LIMIT 1",
       projectId
     ).toArray();
@@ -6302,16 +6349,16 @@ function buildIssueDetail(sql2, identifier) {
   let cycleStartsAt = null;
   let cycleEndsAt = null;
   if (cycleId != null) {
-    const cycleRows = sql2.exec("SELECT number, name, starts_at, ends_at FROM cycles WHERE id = ? LIMIT 1", cycleId).toArray();
+    const cycleRows = sqlFor("cycle").exec("SELECT number, name, starts_at, ends_at FROM cycles WHERE id = ? LIMIT 1", cycleId).toArray();
     cycleNumber = cycleRows[0]?.["number"] ?? null;
     cycleName = cycleRows[0]?.["name"] ?? null;
     cycleStartsAt = cycleRows[0]?.["starts_at"] ?? null;
     cycleEndsAt = cycleRows[0]?.["ends_at"] ?? null;
   }
-  const assigneeUser = resolveUser(sql2, r["assignee_id"] ?? null);
-  const delegateUser = resolveUser(sql2, r["delegate_id"] ?? null);
-  const activity = buildIssueActivity(sql2, id);
-  const comments2 = sql2.exec(
+  const assigneeUser = resolveUser(sqlFor("users"), r["assignee_id"] ?? null);
+  const delegateUser = resolveUser(sqlFor("users"), r["delegate_id"] ?? null);
+  const activity = buildIssueActivity(sqlFor("activity"), id);
+  const comments2 = sqlFor("comments").exec(
     "SELECT id, body, author_id, author_name, author_avatar_url, is_bot, parent_id, created_at, updated_at FROM comments WHERE issue_id = ? AND removed_at IS NULL ORDER BY updated_at",
     id
   ).toArray().map((c) => ({
@@ -6325,7 +6372,7 @@ function buildIssueDetail(sql2, identifier) {
     created_at: c["created_at"] ?? null,
     updated_at: c["updated_at"] ?? null
   }));
-  const agent_sessions2 = sql2.exec(
+  const agent_sessions2 = sqlFor("agentSessions").exec(
     `SELECT id, status, app_user_id, creator_id, created_at, updated_at
          FROM agent_sessions WHERE issue_id = ? AND removed_at IS NULL
         ORDER BY updated_at DESC`,
@@ -6357,7 +6404,7 @@ function buildIssueDetail(sql2, identifier) {
       }))
     };
   });
-  const labels2 = sql2.exec(
+  const labels2 = sqlFor("labels").exec(
     `SELECT l.id AS id, l.name AS name, l.color AS color
        FROM issue_labels il JOIN labels l ON l.id = il.label_id
        WHERE il.issue_id = ? AND l.removed_at IS NULL`,
@@ -6367,17 +6414,18 @@ function buildIssueDetail(sql2, identifier) {
     name: l["name"] ?? null,
     color: l["color"] ?? null
   }));
-  const relations2 = sql2.exec(
-    `SELECT id, type, issue_identifier, related_identifier, ${RELATED_STATE_SUBQUERY} FROM relations WHERE issue_identifier = ?`,
+  const relations2 = sqlFor("relations").exec(
+    `SELECT id, type, issue_identifier, related_identifier, ${RELATED_STATE_SUBQUERY}, ${RELATED_TITLE_SUBQUERY} FROM relations WHERE issue_identifier = ?`,
     identifier
   ).toArray().map((rel) => ({
     id: rel["id"] ?? null,
     type: rel["type"] ?? null,
     issue_identifier: rel["issue_identifier"] ?? null,
     related_identifier: rel["related_identifier"] ?? null,
-    related_state: rel["related_state"] ?? null
+    related_state: rel["related_state"] ?? null,
+    related_title: rel["related_title"] ?? null
   }));
-  const linkedPulls = sql2.exec(
+  const linkedPulls = sqlFor("linkedPulls").exec(
     `SELECT repo_id, number, node_id, title, state, draft, merged
        FROM pull_requests WHERE linear_issue_identifier = ? ORDER BY updated_at DESC`,
     identifier
@@ -6390,6 +6438,7 @@ function buildIssueDetail(sql2, identifier) {
     draft: p["draft"] ?? null,
     merged: p["merged"] ?? null
   }));
+  const blockedBy = readOpenBlockers(sqlFor("blockers"), identifier);
   return {
     id,
     identifier: r["identifier"] ?? null,
@@ -6397,6 +6446,7 @@ function buildIssueDetail(sql2, identifier) {
     description: r["description"] ?? null,
     state: r["state"] ?? null,
     state_id: r["state_id"] ?? null,
+    state_type: r["state_type"] ?? null,
     assignee: r["assignee"] ?? null,
     assignee_id: r["assignee_id"] ?? null,
     assignee_name: assigneeUser.name ?? r["assignee"] ?? null,
@@ -6439,9 +6489,83 @@ function buildIssueDetail(sql2, identifier) {
     activity,
     labels: labels2,
     relations: relations2,
-    linked_pulls: linkedPulls
+    linked_pulls: linkedPulls,
+    blocked_by: blockedBy
   };
 }
+var DONE_KEY_LIST = DONE_STATE_KEYS.map(() => "?").join(", ");
+function readOpenBlockers(sql2, identifier) {
+  const rows = sql2.exec(
+    `SELECT DISTINCT br.issue_identifier AS identifier, bi.id AS mirrored_id,
+              (SELECT COUNT(*) FROM issues lx
+                WHERE lx.identifier = br.issue_identifier AND lx.removed_at IS NULL) AS live_rows,
+              bi.title AS title, bi.state AS state,
+              CASE WHEN EXISTS (SELECT 1 FROM issue_labels kil JOIN labels kl ON kl.id = kil.label_id
+                                WHERE kil.issue_id = bi.id AND kl.removed_at IS NULL
+                                  AND (kl.name = ? OR substr(kl.name, 1, 4) = ?))
+                   THEN 1 ELSE 0 END AS is_ask,
+              CASE WHEN EXISTS (SELECT 1 FROM issue_labels ail JOIN labels al ON al.id = ail.label_id
+                                WHERE ail.issue_id = bi.id AND al.name = ? AND al.removed_at IS NULL)
+                   THEN 1 ELSE 0 END AS is_approval,
+              CASE WHEN EXISTS (SELECT 1 FROM comments dc
+                                WHERE dc.issue_id = bi.id AND dc.removed_at IS NULL
+                                  AND dc.body LIKE 'DECIDED:%')
+                   THEN 1 ELSE 0 END AS is_decided,
+              bi.assignee_id AS assignee_id, bi.assignee AS assignee, bi.created_at AS created_at
+       FROM relations br
+       LEFT JOIN issues bi ON bi.identifier = br.issue_identifier AND bi.removed_at IS NULL
+       WHERE br.type = 'blocks' AND br.related_identifier = ? AND br.issue_identifier != ''
+         AND (bi.id IS NULL OR live_rows != 1 OR ${BLOCKER_OPEN_SQL})
+       ORDER BY bi.id IS NULL, bi.created_at IS NULL, bi.created_at ASC, br.issue_identifier ASC`,
+    ASK_LABEL,
+    ASK_LABEL_PREFIX,
+    APPROVAL_ASK_LABEL,
+    identifier,
+    ...TERMINAL_WORKFLOW_STATE_TYPES,
+    ...DONE_STATE_KEYS
+  ).toArray();
+  const users2 = resolveUsersByIds(
+    sql2,
+    rows.map((b) => b["assignee_id"] ?? null)
+  );
+  const seen = /* @__PURE__ */ new Set();
+  const out = [];
+  for (const b of rows) {
+    const id = String(b["identifier"]);
+    if (seen.has(id)) continue;
+    seen.add(id);
+    if (Number(b["live_rows"]) !== 1) {
+      out.push({
+        identifier: id,
+        title: null,
+        state: null,
+        is_ask: false,
+        is_approval: false,
+        is_decided: false,
+        unresolved: true,
+        assignee_id: null,
+        assignee_name: null
+      });
+      continue;
+    }
+    const assigneeId = b["assignee_id"] ?? null;
+    out.push({
+      identifier: b["identifier"] ?? null,
+      title: b["title"] ?? null,
+      state: b["state"] ?? null,
+      is_ask: Number(b["is_ask"]) === 1,
+      is_approval: Number(b["is_approval"]) === 1,
+      is_decided: Number(b["is_decided"]) === 1,
+      unresolved: false,
+      assignee_id: assigneeId,
+      assignee_name: (assigneeId == null ? void 0 : users2.get(String(assigneeId))?.name) ?? b["assignee"] ?? null
+    });
+  }
+  return out;
+}
+var TERMINAL_WORKFLOW_STATE_TYPES = ["completed", "canceled", "duplicate"];
+var BLOCKER_OPEN_SQL = `(CASE WHEN ${effectiveStateTypeSql("bi")} IS NOT NULL THEN ${effectiveStateTypeSql("bi")} NOT IN (${TERMINAL_WORKFLOW_STATE_TYPES.map(() => "?").join(", ")}) ELSE COALESCE(${stateKeySql("bi")}, '') NOT IN (${DONE_KEY_LIST}) END)`;
+var APPROVAL_ASK_LABEL = "ask/approval";
 var REVIEW_FACET_STATE = {
   approved: "APPROVED",
   changes: "CHANGES_REQUESTED",
@@ -6464,6 +6588,10 @@ function blockedOnAskSql() {
 function pullScopeParts(scope) {
   const parts = [];
   const bindings = [];
+  if (scope?.repositoryIds !== void 0) {
+    parts.push("lower(repo_id) IN (SELECT value FROM json_each(?))");
+    bindings.push(JSON.stringify([...new Set(scope.repositoryIds.map((id) => id.toLowerCase()))]));
+  }
   const repoId = scope?.repoId?.trim();
   if (repoId) {
     parts.push("lower(repo_id) = ?");
@@ -6500,19 +6628,43 @@ function pullScopeClause(scope) {
   const { parts, bindings } = pullScopeParts(scope);
   return { sql: parts.length > 0 ? ` WHERE ${parts.join(" AND ")}` : "", bindings };
 }
-function hydratePullRows(sql2, prRows) {
+function hydratePullRows(sql2, prRows, projection) {
   if (prRows.length === 0) return [];
   const checksByRepoSha = /* @__PURE__ */ new Map();
-  const checkRows = execInChunks(
+  const summariesByRepoSha = /* @__PURE__ */ new Map();
+  const newestRuns = (p) => `SELECT repo_id, head_sha, name, status, conclusion FROM (
+        SELECT repo_id, head_sha, name, status, conclusion,
+          ROW_NUMBER() OVER (PARTITION BY repo_id, head_sha, name
+            ORDER BY CAST(check_run_id AS INTEGER) DESC, check_run_id DESC) AS newest
+        FROM check_runs WHERE head_sha IN (${p}))
+      WHERE newest = 1`;
+  const checkRows = projection === "summary" ? execInChunks(
+    sql2,
+    prRows.map((r) => r["head_sha"]),
+    (p) => `SELECT repo_id, head_sha,
+      SUM(CASE WHEN status = 'completed' AND conclusion = 'success' THEN 1 ELSE 0 END) AS passed,
+      SUM(CASE WHEN status = 'completed' AND conclusion IN ('failure', 'timed_out', 'action_required', 'startup_failure') THEN 1 ELSE 0 END) AS failed,
+      SUM(CASE WHEN status IS NULL OR status <> 'completed' THEN 1 ELSE 0 END) AS pending,
+      SUM(CASE WHEN status = 'completed' AND (conclusion IS NULL OR conclusion NOT IN ('success', 'failure', 'timed_out', 'action_required', 'startup_failure')) THEN 1 ELSE 0 END) AS neutral
+      FROM (${newestRuns(p)}) GROUP BY repo_id, head_sha`
+  ) : execInChunks(
     sql2,
     prRows.map((r) => r["head_sha"]),
-    (p) => `SELECT repo_id, head_sha, name, status, conclusion FROM check_runs
-       WHERE head_sha IN (${p})`
+    newestRuns
   );
   for (const r of checkRows) {
     const sha = r["head_sha"] == null ? "" : String(r["head_sha"]);
     if (sha === "") continue;
     const key = `${r["repo_id"] == null ? "" : String(r["repo_id"])}\0${sha}`;
+    if (projection === "summary") {
+      summariesByRepoSha.set(key, {
+        passed: Number(r["passed"] ?? 0),
+        failed: Number(r["failed"] ?? 0),
+        pending: Number(r["pending"] ?? 0),
+        neutral: Number(r["neutral"] ?? 0)
+      });
+      continue;
+    }
     const list = checksByRepoSha.get(key) ?? [];
     list.push({
       name: r["name"] ?? null,
@@ -6521,7 +6673,6 @@ function hydratePullRows(sql2, prRows) {
     });
     checksByRepoSha.set(key, list);
   }
-  const remediateReviewKeys = /* @__PURE__ */ new Set();
   const latestReviewByReviewer = /* @__PURE__ */ new Map();
   const numbersByRepo = /* @__PURE__ */ new Map();
   for (const r of prRows) {
@@ -6559,10 +6710,15 @@ function hydratePullRows(sql2, prRows) {
       latestReviewByReviewer.set(reviewerKey, { state, submittedAt, reviewId, repoId, prNumber });
     }
   }
+  const summariesByPr = /* @__PURE__ */ new Map();
   for (const { state, repoId, prNumber } of latestReviewByReviewer.values()) {
-    if (state === "COMMENTED" || state === "CHANGES_REQUESTED") {
-      remediateReviewKeys.add(`${repoId}#${prNumber}`);
-    }
+    const k = `${repoId}#${prNumber}`;
+    const summary = summariesByPr.get(k) ?? { reviewers: 0, approved: 0, changes: 0, commented: 0 };
+    summary.reviewers += 1;
+    if (state === "APPROVED") summary.approved += 1;
+    else if (state === "CHANGES_REQUESTED") summary.changes += 1;
+    else if (state === "COMMENTED") summary.commented += 1;
+    summariesByPr.set(k, summary);
   }
   const failingStatusKeys = /* @__PURE__ */ new Set();
   const statusRows = execInChunks(
@@ -6586,6 +6742,15 @@ function hydratePullRows(sql2, prRows) {
     const headSha = r["head_sha"] == null ? "" : String(r["head_sha"]);
     const checkKey = `${r["repo_id"] == null ? "" : String(r["repo_id"])}\0${headSha}`;
     const linkedIdentifier = r["linear_issue_identifier"];
+    const reviewSummary = (() => {
+      const s = summariesByPr.get(`${r["repo_id"] ?? ""}#${r["number"] ?? ""}`);
+      return s === void 0 ? { reviewers: 0, approved: 0, changes: 0, commented: 0 } : {
+        reviewers: s.reviewers,
+        approved: s.approved,
+        changes: s.changes,
+        commented: s.commented
+      };
+    })();
     return {
       repo_id: r["repo_id"] ?? null,
       number: r["number"] ?? null,
@@ -6611,7 +6776,16 @@ function hydratePullRows(sql2, prRows) {
       head_ref: r["head_ref"] ?? null,
       linear_issue_identifier: r["linear_issue_identifier"] ?? null,
       checks: headSha === "" ? [] : checksByRepoSha.get(checkKey) ?? [],
-      has_review_signal: remediateReviewKeys.has(`${r["repo_id"] ?? ""}#${r["number"] ?? ""}`) ? 1 : 0,
+      ...projection === "summary" ? {
+        checks_summary: summariesByRepoSha.get(checkKey) ?? {
+          passed: 0,
+          failed: 0,
+          pending: 0,
+          neutral: 0
+        }
+      } : {},
+      review_summary: reviewSummary,
+      has_review_signal: reviewSummary.changes + reviewSummary.commented > 0 ? 1 : 0,
       has_failing_status: headSha !== "" && failingStatusKeys.has(checkKey) ? 1 : 0,
       blocked_on_ask: linkedIdentifier == null ? null : blockedByIdentifier.get(String(linkedIdentifier)) ?? null
     };
@@ -7140,6 +7314,41 @@ var READ_INDEXES = [
     name: "idx_check_suites_branch",
     table: "check_suites",
     sql: "CREATE INDEX IF NOT EXISTS idx_check_suites_branch ON check_suites(head_branch, updated_at)"
+  },
+  {
+    // CTC-1457 — the check-run ingest's PR resolve (apps/mirror/src/do/MirrorDO.ts handleIngest,
+    // `SELECT number FROM pull_requests WHERE repo_id = ? AND head_sha = ?`). The primary key
+    // `(repo_id, number)` seeks the repository and then walks every one of its PRs: tenant-0 on
+    // 2026-09-28 ran it 36,551 times at 3,709 rows each (about 135M rows a day). With this entry the
+    // lookup seeks the sha and the repository. `repo_id` is in the key because forks share commit
+    // shas: a sha-only key would read every fork's PR at that sha before filtering (Codex review). Rows written: 1 more per pull request upsert (about 5,300 to 7,000 a day on
+    // tenant-0). Both measured in apps/mirror/test-integration/check-run-pull-rows-read.test.ts; plan
+    // and drop-control in apps/mirror/test/do-rows-read-query-plan.test.ts.
+    name: "idx_pulls_head_sha_repo",
+    table: "pull_requests",
+    sql: "CREATE INDEX IF NOT EXISTS idx_pulls_head_sha_repo ON pull_requests(head_sha, repo_id)"
+  },
+  // CTC-4505 — the Waiting view (waitingOnMeClause): a member's OPEN issues. Measured on tenant-0
+  // from durable_object_storage_exec spans, 2026-10-01 22:30-23:10Z: the page and its count each
+  // walked every live issue (18.9k and 18.8k rows), because the member and open-state tests sat inside
+  // an OR. The clause now repeats this WHERE as a top-level conjunct, built from the same constant, so
+  // SQLite seeks here: 201k to 27k VM steps per statement in a replay on a copy of a tenant-0 replica.
+  // ⚠️ Not CTC-3050's rejected `issues(assignee_id, ...)`: that indexed every issue, and one member
+  // holds 60% of them; this holds open issues only (about 2.3k of 8.6k).
+  {
+    // The name carries a hash of the WHERE, so a changed done-state list builds a new index.
+    name: OPEN_ASSIGNEE_INDEX_NAME,
+    table: "issues",
+    sql: `CREATE INDEX IF NOT EXISTS ${OPEN_ASSIGNEE_INDEX_NAME} ON issues(assignee_id) WHERE ${OPEN_ASSIGNEE_INDEX_WHERE}`
+  },
+  // CTC-4505: answered-receipt probes in readAskNudges. Match the reader's literal predicate;
+  // unconstrained nudge/operator receipt lists cannot use this partial index, preserving their
+  // timestamp-tie ordering. Workerd counters and full-answer controls live in the mirror test.
+  // The hub creates this table before ensureReadModelDdl; replicas skip its absent table.
+  {
+    name: "idx_ask_tap_receipts_answered_member_issue",
+    table: "ask_tap_receipts",
+    sql: "CREATE INDEX IF NOT EXISTS idx_ask_tap_receipts_answered_member_issue ON ask_tap_receipts(member_id, issue_id) WHERE outcome IN ('resolved', 'already-resolved')"
   }
 ];
 var RETIRED_READ_INDEXES = [

package/dist/tenant-client.d.ts

@@ -73,6 +73,9 @@ export interface IssueRelationView {
 	 * freeze the value forever. The exact bug CTC-885 reports would survive its own fix, invisibly.
 	 */
 	related_state: SqlValue;
+	/** CTC-4183 — the far end's title, resolved at read time like `related_state`; NULL when the target
+	 *  is not mirrored (or is soft-deleted). Optional on the type for rows from a reader that predates it. */
+	related_title?: SqlValue;
 }
 /** One issue row for the list view — snake_case mirror columns + denormalized labels/relations. */
 export interface IssueView {
@@ -353,6 +356,9 @@ export interface IssueDetailView {
 	state: SqlValue;
 	/** The workflow state's stable Linear id (CTC-148) — behind the `state` name. */
 	state_id: SqlValue;
+	/** CTC-3326 — the EFFECTIVE workflow-state type ({@link effectiveStateTypeSql}), as the list row
+	 *  carries it, so the ticket page decides "finished" the way dispatch does. */
+	state_type: SqlValue;
 	assignee: SqlValue;
 	/** Assignee identity (CTC-USERS): the FK + resolved name/avatar (null when the user isn't mirrored —
 	 *  never fabricated). `assignee_name` falls back to the legacy `assignee` name string. */
@@ -414,6 +420,42 @@ export interface IssueDetailView {
 	/** The PRs that reference this ticket (CTC-269) — the ticket→PR side of the cross-link. Reverse
 	 *  lookup on `pull_requests.linear_issue_identifier`; empty [] when no mirrored PR names this key. */
 	linked_pulls: IssueLinkedPullView[];
+	/** CTC-3326 — the OPEN tickets holding this one up, from their own outgoing `blocks` edges. See
+	 *  {@link IssueBlockerView}. Empty [] when nothing open blocks it. */
+	blocked_by: IssueBlockerView[];
+}
+/**
+ * CTC-3326 — one open ticket that blocks the detail's issue: the far end of an INBOUND `blocks` edge.
+ *
+ * The mirror stores no inverse row (Linear fires no relation webhooks), so an inbound edge is the
+ * blocker's own outgoing row, `relations.related_identifier = <this issue>`, the same read the unblock
+ * sweep and `/inspect` make. `is_ask` is the ask label family, with the same constants and the same
+ * exact `substr` match as {@link openAskBlockerConditions}, but WITHOUT that helper's name-based
+ * "not done" test: openness is already decided by workflow type, and an ask in a started state named
+ * "Released" is still an ask (Codex review, PR #6342).
+ */
+export interface IssueBlockerView {
+	identifier: SqlValue;
+	title: SqlValue;
+	state: SqlValue;
+	/** Whether the blocker carries the ask label family (`catalyst-ask` or `ask/*`). */
+	is_ask: boolean;
+	/** Whether it is an `ask/approval`, which only PORTAL redeems: never answered in the app. */
+	is_approval: boolean;
+	/** Whether the ask already carries its server-written `DECIDED:` comment: the same signal the
+	 *  mirror's `alreadyResolved` reads, and one the replica holds too. The hold-ask table the
+	 *  eligibility check reads (`relay_hold_ask`) lives only in the DO, so it cannot decide this here.
+	 *  A decided ask is never asked again; a `hand-fix` answer can still hold the ticket, so the
+	 *  reader decides how to show it rather than this read dropping it. */
+	is_decided: boolean;
+	/** CTC-3326 (Codex review, PR #6342) — the edge names a blocker with no live mirrored `issues` row
+	 *  (a cross-team or unfetched dependency, or a removed one). Dispatch holds on it as an unknown
+	 *  blocker, so it is listed rather than dropped; its title and state are null. */
+	unresolved: boolean;
+	/** Who answers it. An ask is answered only by its assignee (`answerAskWithOption`'s gate). */
+	assignee_id: SqlValue;
+	/** The assignee's resolved name, falling back to the legacy `assignee` string; null when none. */
+	assignee_name: SqlValue;
 }
 /** A PR that references an issue (CTC-269) — the ticket→PR reverse-lookup row. Carries just enough to
  *  render the Relations card row (a state dot + title) and deep-link straight to the PR on GitHub
@@ -435,6 +477,18 @@ export interface PullCheckView {
 	status: SqlValue;
 	conclusion: SqlValue;
 }
+/** A check on a PR detail: the pill plus GitHub's check-run id. A re-run is a second row with the same
+ *  name, and the SELECT is unordered, so the client picks the newest attempt by this id, which GitHub
+ *  assigns in creation order (`latestCheckRunByName`). Stored as text; null only on a partial row. */
+export interface PullDetailCheckView extends PullCheckView {
+	check_run_id: SqlValue;
+}
+export interface PullChecksSummary {
+	passed: number;
+	failed: number;
+	pending: number;
+	neutral: number;
+}
 /** One PR row for the list view — snake_case mirror columns + denormalized checks. */
 export interface PullView {
 	repo_id: SqlValue;
@@ -466,8 +520,14 @@ export interface PullView {
 	head_ref: SqlValue;
 	linear_issue_identifier: SqlValue;
 	checks: PullCheckView[];
+	/** Present only for the additive cloud summary projection; raw checks stay on detail reads. */
+	checks_summary?: PullChecksSummary;
+	/** CTC-3110 — each reviewer's latest verdict on this PR, counted ({@link PullReviewSummary}), so a
+	 *  client holding every row answers the review facet exactly ({@link pullMatchesReviewFacet}). */
+	review_summary: PullReviewSummary;
 	/** CTC-312: 1 when the PR has any review with state COMMENTED or CHANGES_REQUESTED
-	 *  (case-insensitive). The board's Remediate column reads this; the list view ignores it. */
+	 *  (case-insensitive) — exactly `review_summary.changes + review_summary.commented > 0`. The
+	 *  board's Remediate column reads this; the list view ignores it. */
 	has_review_signal: number;
 	/** CTC-312: 1 when the PR's head sha carries a legacy commit STATUS in a failing state
 	 *  (failure/error). The board's Remediate signal reads this so a repo that reports CI via the
@@ -532,13 +592,23 @@ export interface PullDetailView {
 	head_ref: SqlValue;
 	linear_issue_identifier: SqlValue;
 	linked_issue_state: SqlValue;
-	checks: PullCheckView[];
+	checks: PullDetailCheckView[];
 	reviews: PullReviewView[];
 	commit_statuses: PullStatusView[];
 	/** CTC-1912 — same as `PullView.blocked_on_ask`. Not existence-gated on the linked issue's row
 	 *  (unlike `linear_issue_identifier`/`linked_issue_state`): the edge itself is the evidence. */
 	blocked_on_ask: BlockedOnAskView | null;
 }
+/** CTC-3110 — each reviewer's LATEST review ({@link isLaterReview}) on one PR, counted by verdict. The
+ *  list row carries it so a client holding every row (the browser replica) answers the review facet
+ *  exactly as {@link pullScopeParts} does in SQL. A reviewer is a distinct `user_id` (null is one). */
+export interface PullReviewSummary {
+	/** Reviewers with at least one review row. 0 is the `none` facet. */
+	reviewers: number;
+	approved: number;
+	changes: number;
+	commented: number;
+}
 /** A denormalized parent-initiative reference on a project row (via project_initiatives).
  *  `id` is always present (the edge exists); `name` resolves from the initiatives table and is
  *  null when that initiative isn't mirrored — never fabricated. */

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@catalyst-cloud/sdk",
-  "version": "0.14.2",
+  "version": "0.16.0",
   "description": "Read and update your Catalyst Cloud data, and receive live changes in your apps.",
   "license": "MIT",
   "author": "Coalesce Labs",
@@ -86,7 +86,8 @@
     "test": "vitest run",
     "prepublishOnly": "npm run build",
     "typecheck:scripts": "tsc --noEmit -p tsconfig.scripts.json",
-    "test:pack": "node scripts/verify-pack.mjs"
+    "test:pack": "node scripts/verify-pack.mjs",
+    "release:check": "node scripts/release-train-check.mjs && node --test scripts/release-train-check.test.mjs"
   },
   "keywords": [
     "catalyst",
@@ -98,9 +99,9 @@
     "durable-objects"
   ],
   "devDependencies": {
-    "@catalyst-cloud/read-model": "^0.13.0",
-    "@catalyst-cloud/replicate": "0.13.2",
-    "@catalyst-cloud/schema": "0.13.2",
+    "@catalyst-cloud/read-model": "^0.16.0",
+    "@catalyst-cloud/replicate": "0.16.0",
+    "@catalyst-cloud/schema": "0.16.0",
     "@opentelemetry/api": "^1.9.0",
     "@opentelemetry/context-async-hooks": "^2.8.0",
     "@opentelemetry/resources": "^2.8.0",
@@ -117,9 +118,9 @@
     "@opentelemetry/api": ">=1.3.0 <2",
     "@sqlite.org/sqlite-wasm": "*",
     "better-sqlite3": "*",
-    "@catalyst-cloud/read-model": "^0.13.0",
-    "@catalyst-cloud/replicate": "0.13.2",
-    "@catalyst-cloud/schema": "0.13.2"
+    "@catalyst-cloud/read-model": "^0.16.0",
+    "@catalyst-cloud/replicate": "0.16.0",
+    "@catalyst-cloud/schema": "0.16.0"
   },
   "peerDependenciesMeta": {
     "@opentelemetry/api": {