taskchef 7.14.1 → 7.15.0

package/src/dashboard/app.js

@@ -16,7 +16,7 @@ import {
   turnPresentation,
 } from "./state.js";
 import { openTaskFromControl } from "./actions.js";
-import { githubReferenceSegments } from "./github-links.js";
+import { referenceSegments } from "./github-links.js";
 import { formatRelativeTime, RelativeTimeController, parsedTimestamp } from "./time.js";
 
 const state = {
@@ -61,28 +61,33 @@ const elements = {
 };
 let notificationDescriptionSerial = 0;
 
-function githubLink(link, { compact = false } = {}) {
+function referenceLink(link, { compact = false } = {}) {
   const anchor = document.createElement("a");
   anchor.className = compact ? "github-link github-link-compact" : "github-link";
   anchor.href = link.url;
   anchor.target = "_blank";
   anchor.rel = "noopener noreferrer";
   anchor.textContent = link.label ?? link.text;
+  const githubKind = link.type === "issue"
+    ? ", GitHub issue"
+    : link.type === "pull"
+      ? ", GitHub pull request"
+      : link.provider === "github" || link.owner ? " on GitHub" : "";
   anchor.setAttribute(
     "aria-label",
-    `${link.label ?? link.text} on GitHub (opens in a new tab)`,
+    `${link.label ?? link.text}${githubKind} (opens in a new tab)`,
   );
   anchor.addEventListener("click", (event) => event.stopPropagation());
   return anchor;
 }
 
-function appendGitHubText(container, text, task) {
-  const children = githubReferenceSegments(text, {
+function appendLinkedText(container, text, task) {
+  const children = referenceSegments(text, {
     projectRepositories: task.project?.githubRepos,
     taskRepository: task.relatedGitHubRepository,
   }).map((segment) => {
     if (segment.kind === "text") return document.createTextNode(segment.text);
-    if (segment.kind === "link") return githubLink(segment);
+    if (segment.kind === "link") return referenceLink(segment);
     const ambiguous = document.createElement("span");
     ambiguous.className = "github-reference-ambiguous";
     ambiguous.textContent = segment.text;
@@ -99,7 +104,7 @@ function relatedGitHubLinks(task, { compact = false } = {}) {
   const container = document.createElement("nav");
   container.className = `github-links${compact ? " github-links-compact" : ""}`;
   container.setAttribute("aria-label", `Related GitHub links for ${task.title}`);
-  const children = links.map((link) => githubLink(link, { compact }));
+  const children = links.map((link) => referenceLink(link, { compact }));
   if (task.relatedGitHubLinksTruncated) {
     const more = document.createElement("span");
     more.className = "github-links-more";
@@ -254,7 +259,7 @@ function notificationAnnouncement(notification) {
     notificationTitle(notification),
     notification.title,
     notification.summary,
-    notification.turnId ? `Turn ${notification.turnId}` : null,
+    notification.turnRef ? `Turn ref ${notification.turnRef}` : null,
     formatRelativeTime(notification.timestamp),
   ].filter(Boolean).join(". ");
 }
@@ -297,7 +302,7 @@ function turnTimeline(task) {
     const turnStatus = presentation.status;
     status.className = `status status-${turnStatus}`;
     status.textContent = turnStatus.replaceAll("_", " ");
-    const turnKey = turn.turnId ?? `no-turn:${index}`;
+    const turnKey = turn.turnRef ?? turn.turnId ?? `no-turn:${index}`;
     const timestamp = timestampControl(presentation.updatedAt, {
       accessibleName: `Turn updated time for ${turnStatus.replaceAll("_", " ")}`,
       key: `detail:${task.id}:turn:${turnKey}`,
@@ -307,7 +312,7 @@ function turnTimeline(task) {
     requestLabel.textContent = "Request";
     const request = document.createElement("p");
     request.className = "preserve-lines";
-    appendGitHubText(
+    appendLinkedText(
       request,
       turn.requestSummary ?? "Request not recorded by this TaskChef version.",
       task,
@@ -316,12 +321,10 @@ function turnTimeline(task) {
     resultLabel.textContent = "Result";
     const result = document.createElement("p");
     result.className = "preserve-lines";
-    appendGitHubText(result, presentation.summary, task);
+    appendLinkedText(result, presentation.summary, task);
     const turnMetadata = document.createElement("p");
     turnMetadata.className = "result-history-turn";
-    turnMetadata.textContent = turn.turnId
-      ? `Turn ${turn.turnId}`
-      : "No turn ID (creation failure)";
+    turnMetadata.textContent = `Turn ref ${turn.turnRef ?? "not recorded"}; Codex turn ${turn.turnId ?? "unavailable"}`;
     item.append(header, requestLabel, request, resultLabel, result, turnMetadata);
     return item;
   });
@@ -352,9 +355,11 @@ function renderDialog(task) {
   elements.copyThreadId.disabled = !task.threadId;
   elements.dialogMetadata.replaceChildren(
     ...detailRow("Current status", taskStatusLabel(task)),
-    ...detailRow("Current turn ID", task.turnId),
+    ...detailRow("Current turn ref", task.turnRef),
+    ...detailRow("Current Codex turn ID", task.turnId),
     ...detailRow("Last result status", task.lastResult?.status?.replaceAll("_", " ")),
-    ...detailRow("Last result turn ID", task.lastResult?.turnId),
+    ...detailRow("Last result turn ref", task.lastResult?.turnRef),
+    ...detailRow("Last result Codex turn ID", task.lastResult?.turnId),
     ...detailRow("Last result updated", timestampControl(task.lastResult?.updatedAt, {
       accessibleName: `Last result updated time for ${task.title}`,
       key: `detail:${task.id}:last-result-updated`,
@@ -424,12 +429,12 @@ function taskCard(task) {
   requestLabel.textContent = "Request";
   const request = document.createElement("span");
   request.className = "preserve-lines";
-  request.textContent = latest.requestSummary;
+  appendLinkedText(request, latest.requestSummary, task);
   const resultLabel = document.createElement("strong");
   resultLabel.textContent = "Result";
   const result = document.createElement("span");
   result.className = "preserve-lines";
-  result.textContent = latest.resultSummary;
+  appendLinkedText(result, latest.resultSummary, task);
   summary.replaceChildren(requestLabel, request, resultLabel, result);
   const relatedLinks = relatedGitHubLinks(task, { compact: true });
   const time = timestampControl(

package/src/dashboard/github-links.js

@@ -1,5 +1,6 @@
 const GITHUB_REPOSITORY = /^[A-Za-z0-9](?:[A-Za-z0-9-]{0,38})\/[A-Za-z0-9._-]+$/;
-const REFERENCE_PATTERN = /https?:\/\/(?:www\.)?github\.com\/([A-Za-z0-9](?:[A-Za-z0-9-]{0,38}))\/([A-Za-z0-9._-]+)\/(issues|pull)\/([1-9]\d*)(?![A-Za-z0-9_])|([A-Za-z0-9](?:[A-Za-z0-9-]{0,38}))\/([A-Za-z0-9._-]+)#([1-9]\d*)(?![A-Za-z0-9_])|#([1-9]\d*)(?![A-Za-z0-9_])|https?:\/\/(?:www\.)?github\.com\/([A-Za-z0-9](?:[A-Za-z0-9-]{0,38}))\/([A-Za-z0-9](?:[A-Za-z0-9._-]*[A-Za-z0-9_-])?)\/?(?=$|[\s),.;:!?'"\]}>])/gi;
+const REFERENCE_PATTERN = /https?:\/\/(?:www\.)?github\.com\/([A-Za-z0-9](?:[A-Za-z0-9-]{0,38}))\/([A-Za-z0-9._-]+)\/(issues|pull)\/([1-9]\d*)(?![A-Za-z0-9_])|([A-Za-z0-9](?:[A-Za-z0-9-]{0,38}))\/([A-Za-z0-9._-]+)#([1-9]\d*)(?![A-Za-z0-9_])|#([1-9]\d*)(?![A-Za-z0-9_])|https?:\/\/(?:www\.)?github\.com\/([A-Za-z0-9](?:[A-Za-z0-9-]{0,38}))\/([A-Za-z0-9](?:[A-Za-z0-9._-]*[A-Za-z0-9_-])?)\/?(?=$|[\s#),.;:!?'"\]}>])/gi;
+const ABSOLUTE_HTTP_PATTERN = /https?:\/\/[^\s<>"'`]+/gi;
 export const MAX_RELATED_GITHUB_LINKS = 20;
 
 function canonicalRepository(owner, repository) {
@@ -23,10 +24,35 @@ export function normalizeGitHubRepository(value) {
 
 function rawReferences(text) {
   const value = String(text ?? "");
+  const absoluteRanges = absoluteHttpCandidates(value);
   const references = [];
   for (const match of value.matchAll(REFERENCE_PATTERN)) {
     const start = match.index;
     const preceding = start > 0 ? value[start - 1] : "";
+    let explicitAbsoluteUrl = null;
+    const containingAbsoluteUrl = absoluteRanges.find((range) => (
+      start >= range.start && start < range.end
+    ));
+    if (containingAbsoluteUrl) {
+      const explicitGitHubUrl = Boolean(match[1] || match[9]);
+      let absoluteHost = null;
+      try {
+        absoluteHost = new URL(containingAbsoluteUrl.text).hostname.toLowerCase();
+      } catch {
+        // Invalid absolute URL tokens still block nested shorthand recognition.
+      }
+      const completeGitHubUrl = explicitGitHubUrl
+        && start === containingAbsoluteUrl.start
+        && (absoluteHost === "github.com" || absoluteHost === "www.github.com");
+      if (!completeGitHubUrl) continue;
+      const safeUrl = safeAbsoluteHttpUrl(containingAbsoluteUrl.text);
+      if (!safeUrl) continue;
+      explicitAbsoluteUrl = {
+        end: containingAbsoluteUrl.end,
+        suffix: containingAbsoluteUrl.text.slice(match[0].length),
+        text: containingAbsoluteUrl.text,
+      };
+    }
     if (match[8] && /[\w&#/]/.test(preceding)) continue;
     if ((match[5] || match[1] || match[9]) && /[\w/]/.test(preceding)) continue;
 
@@ -45,14 +71,15 @@ function rawReferences(text) {
       [owner, repository] = normalized.split("/");
     }
     references.push({
-      end: start + match[0].length,
+      end: explicitAbsoluteUrl?.end ?? start + match[0].length,
       explicit,
       number,
       owner,
       repository,
       start,
-      text: match[0],
+      text: explicitAbsoluteUrl?.text ?? match[0],
       type,
+      urlSuffix: explicitAbsoluteUrl?.suffix ?? "",
     });
   }
   return references;
@@ -83,26 +110,111 @@ function resolvedReference(reference, repositoryContext) {
   if (reference.type === "repository") {
     return {
       kind: "link",
+      label: `${owner}/${repositoryName}`,
       number: null,
       owner,
+      provider: "github",
       repository: repositoryName,
       text: reference.text,
       type: reference.type,
-      url: `https://github.com/${owner}/${repositoryName}`,
+      url: `https://github.com/${owner}/${repositoryName}${reference.urlSuffix}`,
     };
   }
   const path = reference.type === "pull" ? "pull" : "issues";
   return {
     kind: "link",
+    label: `${owner}/${repositoryName}#${reference.number}`,
     number: reference.number,
     owner,
+    provider: "github",
     repository: repositoryName,
     text: reference.text,
     type: reference.type,
-    url: `https://github.com/${owner}/${repositoryName}/${path}/${reference.number}`,
+    url: `https://github.com/${owner}/${repositoryName}/${path}/${reference.number}${reference.urlSuffix}`,
   };
 }
 
+function trimAbsoluteUrl(candidate) {
+  let trimmed = candidate;
+  let previous;
+  do {
+    previous = trimmed;
+    trimmed = trimmed.replace(/[.,;:!?]+$/u, "");
+    for (const [opening, closing] of [["(", ")"], ["[", "]"], ["{", "}"]]) {
+      while (trimmed.endsWith(closing)) {
+        const openings = [...trimmed].filter((character) => character === opening).length;
+        const closings = [...trimmed].filter((character) => character === closing).length;
+        if (closings <= openings) break;
+        trimmed = trimmed.slice(0, -1);
+      }
+    }
+  } while (trimmed !== previous);
+  return trimmed;
+}
+
+function absoluteHttpCandidates(text) {
+  const candidates = [];
+  for (const match of String(text ?? "").matchAll(ABSOLUTE_HTTP_PATTERN)) {
+    const candidate = trimAbsoluteUrl(match[0]);
+    if (!candidate) continue;
+    candidates.push({
+      end: match.index + candidate.length,
+      start: match.index,
+      text: candidate,
+    });
+  }
+  return candidates;
+}
+
+function hasDotPathSegment(candidate) {
+  const authorityAndPath = candidate.slice(candidate.indexOf("//") + 2).split(/[?#]/u, 1)[0];
+  const pathStart = authorityAndPath.indexOf("/");
+  if (pathStart < 0) return false;
+  return authorityAndPath.slice(pathStart).split("/").some((segment) => {
+    try {
+      const decoded = decodeURIComponent(segment);
+      return decoded === "." || decoded === "..";
+    } catch {
+      return true;
+    }
+  });
+}
+
+function safeAbsoluteHttpUrl(candidate) {
+  try {
+    const url = new URL(candidate);
+    if (
+      !url.hostname
+      || url.username
+      || url.password
+      || candidate.includes("\\")
+      || hasDotPathSegment(candidate)
+    ) return null;
+    return url.href;
+  } catch {
+    return null;
+  }
+}
+
+function rawAbsoluteHttpReferences(text) {
+  const references = [];
+  for (const candidate of absoluteHttpCandidates(text)) {
+    const url = safeAbsoluteHttpUrl(candidate.text);
+    if (!url) continue;
+    references.push({
+      end: candidate.end,
+      kind: "link",
+      label: candidate.text,
+      provider: "web",
+      start: candidate.start,
+      text: candidate.text,
+      type: "url",
+      url,
+    });
+  }
+  return references;
+}
+
 export function githubReferenceSegments(text, {
   projectRepositories = [],
   taskRepository = null,
@@ -134,6 +246,45 @@ export function githubReferenceSegments(text, {
   return segments;
 }
 
+export function referenceSegments(text, options = {}) {
+  const value = String(text ?? "");
+  const githubSegments = githubReferenceSegments(value, options);
+  const references = [];
+  let cursor = 0;
+  for (const segment of githubSegments) {
+    const start = value.indexOf(segment.text, cursor);
+    if (start < 0) continue;
+    if (segment.kind !== "text") {
+      references.push({ end: start + segment.text.length, segment, start });
+    }
+    cursor = start + segment.text.length;
+  }
+  const absoluteReferences = rawAbsoluteHttpReferences(value).filter((reference) => (
+    !references.some(({ end, start }) => reference.start < end && reference.end > start)
+  ));
+  if (absoluteReferences.length === 0) return githubSegments;
+
+  references.push(...absoluteReferences.map((segment) => ({
+    end: segment.end,
+    segment,
+    start: segment.start,
+  })));
+  references.sort((left, right) => left.start - right.start);
+
+  const segments = [];
+  let offset = 0;
+  for (const reference of references) {
+    if (reference.start < offset) continue;
+    if (reference.start > offset) {
+      segments.push({ kind: "text", text: value.slice(offset, reference.start) });
+    }
+    segments.push(reference.segment);
+    offset = reference.end;
+  }
+  if (offset < value.length) segments.push({ kind: "text", text: value.slice(offset) });
+  return segments;
+}
+
 function taskTexts(task) {
   const texts = [task.instruction];
   for (const turn of task.turns ?? []) {
@@ -146,16 +297,9 @@ function taskTexts(task) {
   return texts.filter((text) => typeof text === "string" && text.length > 0);
 }
 
-function relatedLinkLabel(link, includeRepository, includeOwner) {
+function relatedLinkLabel(link) {
   if (link.type === "repository") return `${link.owner}/${link.repository}`;
-  const reference = link.type === "pull"
-    ? `PR #${link.number}`
-    : link.type === "issue"
-      ? `Issue #${link.number}`
-      : `#${link.number}`;
-  if (!includeRepository) return reference;
-  const repository = includeOwner ? `${link.owner}/${link.repository}` : link.repository;
-  return `${repository} ${reference}`;
+  return `${link.owner}/${link.repository}#${link.number}`;
 }
 
 export function taskGitHubProjection(task) {
@@ -179,7 +323,7 @@ export function taskGitHubProjection(task) {
       taskRepository,
     })) {
       if (segment.kind !== "link") continue;
-      const key = segment.url.toLowerCase();
+      const key = segment.url;
       if (seen.has(key)) continue;
       if (links.length === MAX_RELATED_GITHUB_LINKS) {
         truncated = true;
@@ -189,17 +333,9 @@ export function taskGitHubProjection(task) {
       links.push(segment);
     }
   }
-  const repositories = new Set(links.map(({ owner, repository }) => `${owner}/${repository}`));
-  const repositoryNames = new Map();
-  for (const link of links) {
-    const owners = repositoryNames.get(link.repository) ?? new Set();
-    owners.add(link.owner);
-    repositoryNames.set(link.repository, owners);
-  }
-  const includeRepository = repositories.size > 1;
   return {
     relatedGitHubLinks: links.map((link) => ({
-      label: relatedLinkLabel(link, includeRepository, repositoryNames.get(link.repository).size > 1),
+      label: relatedLinkLabel(link),
       number: link.number,
       owner: link.owner,
       repository: link.repository,

package/src/dashboard/state.js

@@ -44,6 +44,7 @@ export function latestTurnPresentation(task) {
   const requestSummary = turn?.requestSummary
     ?? (turn ? "Request not recorded by this TaskChef version." : task.title);
   return {
+    turnRef: turn?.turnRef ?? turn?.turnId ?? task.turnRef ?? task.turnId ?? null,
     turnId: turn?.turnId ?? task.turnId ?? null,
     startedAt: turn?.startedAt ?? task.updatedAt ?? task.createdAt ?? null,
     requestSummary,
@@ -70,11 +71,25 @@ export function mergeProjectedTurns(task, preservedTurns = []) {
   if (!task.latestTurn) return preservedTurns;
   const turns = [...preservedTurns];
   const lastIndex = turns.length - 1;
-  if (lastIndex >= 0 && turns[lastIndex].turnId === task.latestTurn.turnId) {
+  const latestIdentity = task.latestTurn.turnRef ?? task.latestTurn.turnId;
+  const preservedIdentity = lastIndex >= 0
+    ? (turns[lastIndex].turnRef ?? turns[lastIndex].turnId)
+    : null;
+  const migratedFallbackIdentity = lastIndex >= 0
+    && preservedIdentity === null
+    && latestIdentity !== null
+    && turns[lastIndex].turnId == null
+    && task.latestTurn.turnId == null
+    && JSON.stringify({ ...turns[lastIndex], turnRef: null })
+      === JSON.stringify({ ...task.latestTurn, turnRef: null });
+  if (
+    lastIndex >= 0
+    && (preservedIdentity === latestIdentity || migratedFallbackIdentity)
+  ) {
     turns[lastIndex] = task.latestTurn;
   } else {
     if (
-      task.schemaVersion === 8
+      task.schemaVersion >= 8
       && lastIndex >= 0
       && turns[lastIndex].result === null
     ) {
@@ -144,7 +159,30 @@ export function nextDateFilterRefreshDelay(tasks, filter, now = Date.now()) {
 }
 
 export function taskSignature(task) {
-  return JSON.stringify([task.id, task.turnId ?? null, task.status ?? "unresolved"]);
+  return JSON.stringify([
+    task.id,
+    task.turnRef ?? task.turnId ?? null,
+    task.turnId ?? null,
+    task.status ?? "unresolved",
+  ]);
+}
+
+function signaturesDifferOnlyByMigratedFallback(previous, next) {
+  try {
+    const before = JSON.parse(previous);
+    const after = JSON.parse(next);
+    return Array.isArray(before)
+      && Array.isArray(after)
+      && before.length === after.length
+      && before[1] === null
+      && after[1] !== null
+      && before[2] === null
+      && after[2] === null
+      && before[3] !== "working"
+      && before.every((value, index) => index === 1 || value === after[index]);
+  } catch {
+    return false;
+  }
 }
 
 export function findCurrentTask(tasks, taskId) {
@@ -162,14 +200,15 @@ function notificationIdentity(task, event) {
   if (event === "created") {
     return JSON.stringify([task.id, null, event, task.createdAt ?? null]);
   }
-  return JSON.stringify([task.id, task.turnId ?? null, event]);
+  return JSON.stringify([task.id, task.turnRef ?? task.turnId ?? null, event]);
 }
 
 function eventTimestamp(task, event) {
   if (event === "created") return task.createdAt ?? task.updatedAt ?? null;
   if (
     task.lastResult?.status === task.status
-    && task.lastResult?.turnId === task.turnId
+    && (task.lastResult?.turnRef ?? task.lastResult?.turnId)
+      === (task.turnRef ?? task.turnId)
   ) {
     return task.lastResult.updatedAt;
   }
@@ -180,7 +219,8 @@ function eventSummary(task, event) {
   if (!["completed", "needs_input", "failed"].includes(event)) return null;
   if (
     task.lastResult?.status === task.status
-    && task.lastResult?.turnId === task.turnId
+    && (task.lastResult?.turnRef ?? task.lastResult?.turnId)
+      === (task.turnRef ?? task.turnId)
   ) {
     return task.lastResult.summary;
   }
@@ -195,6 +235,7 @@ export function notificationSnapshot(task, event = lifecycleEvent(task)) {
     title: task.title,
     status: created ? "working" : task.status,
     event,
+    turnRef: created ? null : task.turnRef ?? task.turnId ?? null,
     turnId: created ? null : task.turnId ?? null,
     timestamp: eventTimestamp(task, event),
     summary: eventSummary(task, event),
@@ -205,11 +246,16 @@ function resultNotificationSnapshot(task) {
   const result = task.lastResult;
   if (!result) return null;
   return Object.freeze({
-    id: notificationIdentity({ ...task, turnId: result.turnId }, result.status),
+    id: notificationIdentity({
+      ...task,
+      turnRef: result.turnRef ?? result.turnId,
+      turnId: result.turnId,
+    }, result.status),
     taskId: task.id,
     title: task.title,
     status: result.status,
     event: result.status,
+    turnRef: result.turnRef ?? result.turnId ?? null,
     turnId: result.turnId ?? null,
     timestamp: result.updatedAt,
     summary: result.summary,
@@ -259,12 +305,18 @@ export function reconcileNotifications(
     const candidates = [];
     if (!signatures.has(task.id)) {
       const resultNotification = resultNotificationSnapshot(task);
-      if (task.turnId || task.status !== "working" || resultNotification) {
+      if (task.turnRef || task.turnId || task.status !== "working" || resultNotification) {
         candidates.push(notificationSnapshot(task));
         if (resultNotification) candidates.push(resultNotification);
       }
       candidates.push(notificationSnapshot(task, "created"));
-    } else if (signatures.get(task.id) !== nextSignatures.get(task.id)) {
+    } else if (
+      signatures.get(task.id) !== nextSignatures.get(task.id)
+      && !signaturesDifferOnlyByMigratedFallback(
+        signatures.get(task.id),
+        nextSignatures.get(task.id),
+      )
+    ) {
       candidates.push(notificationSnapshot(task));
       const resultNotification = resultNotificationSnapshot(task);
       if (resultNotification) candidates.push(resultNotification);

package/src/dashboard.js

@@ -138,10 +138,13 @@ function assertDashboardTaskBounds(tasks, maximumTasks) {
     boundedText(task.instruction, 250_000, `${name} instruction`);
     boundedText(task.summary, 2_000, `${name} summary`);
     boundedText(task.threadId, 512, `${name} thread ID`);
+    boundedText(task.turnRef, 512, `${name} turn ref`);
     boundedText(task.turnId, 512, `${name} turn ID`);
     boundedText(task.lastResult?.summary, 2_000, `${name} last result summary`);
+    boundedText(task.lastResult?.turnRef, 512, `${name} last result turn ref`);
     boundedText(task.lastResult?.turnId, 512, `${name} last result turn ID`);
     boundedText(task.latestTurn?.requestSummary, 1_000, `${name} latest request summary`);
+    boundedText(task.latestTurn?.turnRef, 512, `${name} latest turn ref`);
     boundedText(task.latestTurn?.turnId, 512, `${name} latest turn ID`);
     const turns = task.turns ?? [];
     if (turns.length > 10_000) {
@@ -149,6 +152,7 @@ function assertDashboardTaskBounds(tasks, maximumTasks) {
     }
     for (const [turnIndex, turn] of turns.entries()) {
       boundedText(turn.requestSummary, 1_000, `${name} turn ${turnIndex + 1} request summary`);
+      boundedText(turn.turnRef, 512, `${name} turn ${turnIndex + 1} turn ref`);
       boundedText(turn.turnId, 512, `${name} turn ${turnIndex + 1} turn ID`);
       boundedText(turn.result?.summary, 2_000, `${name} turn ${turnIndex + 1} result summary`);
     }
@@ -158,6 +162,7 @@ function assertDashboardTaskBounds(tasks, maximumTasks) {
     }
     for (const [resultIndex, result] of results.entries()) {
       boundedText(result.summary, 2_000, `${name} result ${resultIndex + 1} summary`);
+      boundedText(result.turnRef, 512, `${name} result ${resultIndex + 1} turn ref`);
       boundedText(result.turnId, 512, `${name} result ${resultIndex + 1} turn ID`);
     }
     boundedText(task.project.name, 1_000, `${name} project name`);

package/src/delegation.js

@@ -70,17 +70,19 @@ function toolIdentifier(value) {
   return normalized.length > 0 ? normalized : null;
 }
 
-function attachCreationRecovery(error, taskId, resultReporting) {
+function attachCreationRecovery(error, taskId, turnRef, resultReporting) {
   const creationError = error instanceof Error ? error : new Error(String(error));
   try {
     Object.defineProperties(creationError, {
       taskChefTaskId: { value: taskId, enumerable: true },
+      taskChefTurnRef: { value: turnRef, enumerable: true },
       taskChefResultReporting: { value: resultReporting, enumerable: true },
     });
     return creationError;
   } catch {
     const wrapped = new Error(`Executor creation failed for recorded TaskChef task ${taskId}.`, { cause: creationError });
     wrapped.taskChefTaskId = taskId;
+    wrapped.taskChefTurnRef = turnRef;
     wrapped.taskChefResultReporting = resultReporting;
     return wrapped;
   }
@@ -238,16 +240,29 @@ export async function createAndRecordDelegation(input) {
   try {
     createResult = parseToolResult(await createThread({ prompt: prepared.instruction, title, target }), "create_thread result");
   } catch (error) {
+    const creationFailureTurnRef = randomUUID();
     let resultReporting = "unavailable";
     if (reportRecordedResult !== null) {
       try {
-        await reportRecordedResult({ taskId: prepared.id, threadId: null, turnId: null, status: "failed", summary: "Executor creation failed before the executor started." });
+        await reportRecordedResult({
+          taskId: prepared.id,
+          threadId: null,
+          turnRef: creationFailureTurnRef,
+          turnId: null,
+          status: "failed",
+          summary: "Executor creation failed before the executor started.",
+        });
         resultReporting = "recorded";
       } catch {
         resultReporting = "failed";
       }
     }
-    throw attachCreationRecovery(error, prepared.id, resultReporting);
+    throw attachCreationRecovery(
+      error,
+      prepared.id,
+      creationFailureTurnRef,
+      resultReporting,
+    );
   }
 
   const returnedThreadId = toolIdentifier(createResult.threadId);