taskchef 7.13.0 → 7.14.0

package/.codex-plugin/plugin.json

@@ -1,6 +1,6 @@
 {
   "name": "taskchef",
-  "version": "7.13.0",
+  "version": "7.14.0",
   "description": "Dispatch work from a data-only workspace to visible Codex project tasks.",
   "author": {
     "name": "Favo Yang",

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "taskchef",
-  "version": "7.13.0",
+  "version": "7.14.0",
   "description": "A non-blocking interactive dispatcher for visible Codex tasks.",
   "license": "MIT",
   "author": "Favo Yang",

package/src/dashboard/app.js

@@ -16,6 +16,7 @@ import {
   turnPresentation,
 } from "./state.js";
 import { openTaskFromControl } from "./actions.js";
+import { githubReferenceSegments } from "./github-links.js";
 import { formatRelativeTime, RelativeTimeController, parsedTimestamp } from "./time.js";
 
 const state = {
@@ -43,6 +44,7 @@ const elements = {
   dialogInstruction: document.querySelector("#dialog-instruction"),
   dialogMetadata: document.querySelector("#dialog-metadata"),
   dialogProject: document.querySelector("#dialog-project"),
+  dialogRelatedLinks: document.querySelector("#dialog-related-links"),
   dialogResults: document.querySelector("#dialog-results"),
   dialogTitle: document.querySelector("#dialog-title"),
   dismissDashboardMessage: document.querySelector("#dismiss-dashboard-message"),
@@ -59,6 +61,58 @@ const elements = {
 };
 let notificationDescriptionSerial = 0;
 
+function githubLink(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;
+  anchor.setAttribute(
+    "aria-label",
+    `${link.label ?? link.text} on GitHub (opens in a new tab)`,
+  );
+  anchor.addEventListener("click", (event) => event.stopPropagation());
+  return anchor;
+}
+
+function appendGitHubText(container, text, task) {
+  const children = githubReferenceSegments(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);
+    const ambiguous = document.createElement("span");
+    ambiguous.className = "github-reference-ambiguous";
+    ambiguous.textContent = segment.text;
+    ambiguous.tabIndex = 0;
+    ambiguous.title = segment.reason;
+    ambiguous.setAttribute("aria-label", segment.reason);
+    return ambiguous;
+  });
+  container.replaceChildren(...children);
+}
+
+function relatedGitHubLinks(task, { compact = false } = {}) {
+  const links = task.relatedGitHubLinks ?? [];
+  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 }));
+  if (task.relatedGitHubLinksTruncated) {
+    const more = document.createElement("span");
+    more.className = "github-links-more";
+    more.textContent = "+ more";
+    more.title = "Additional related GitHub references are omitted from this bounded dashboard view.";
+    more.setAttribute("aria-label", more.title);
+    children.push(more);
+  }
+  container.hidden = children.length === 0;
+  container.replaceChildren(...children);
+  return container;
+}
+
 function timestampControl(value, { accessibleName, key, prefix = "" }) {
   if (!parsedTimestamp(value)) {
     const missing = document.createElement("span");
@@ -253,12 +307,16 @@ function turnTimeline(task) {
     requestLabel.textContent = "Request";
     const request = document.createElement("p");
     request.className = "preserve-lines";
-    request.textContent = turn.requestSummary ?? "Request not recorded by this TaskChef version.";
+    appendGitHubText(
+      request,
+      turn.requestSummary ?? "Request not recorded by this TaskChef version.",
+      task,
+    );
     const resultLabel = document.createElement("h4");
     resultLabel.textContent = "Result";
     const result = document.createElement("p");
     result.className = "preserve-lines";
-    result.textContent = presentation.summary;
+    appendGitHubText(result, presentation.summary, task);
     const turnMetadata = document.createElement("p");
     turnMetadata.className = "result-history-turn";
     turnMetadata.textContent = turn.turnId
@@ -281,6 +339,14 @@ function renderDialog(task) {
   state.selectedTask = detailedTask;
   elements.dialogProject.textContent = task.project.name;
   elements.dialogTitle.textContent = task.title;
+  elements.dialogRelatedLinks.replaceChildren(...relatedGitHubLinks(detailedTask).children);
+  elements.dialogRelatedLinks.setAttribute(
+    "aria-label",
+    `Related GitHub links for ${task.title}`,
+  );
+  elements.dialogRelatedLinks.hidden = (
+    (task.relatedGitHubLinks?.length ?? 0) === 0 && !task.relatedGitHubLinksTruncated
+  );
   elements.dialogResults.replaceChildren(...turnTimeline(detailedTask));
   elements.dialogInstruction.textContent = task.instruction;
   elements.copyThreadId.disabled = !task.threadId;
@@ -365,6 +431,7 @@ function taskCard(task) {
   result.className = "preserve-lines";
   result.textContent = latest.resultSummary;
   summary.replaceChildren(requestLabel, request, resultLabel, result);
+  const relatedLinks = relatedGitHubLinks(task, { compact: true });
   const time = timestampControl(
     task.meaningfulUpdatedAt ?? task.updatedAt ?? task.createdAt,
     {
@@ -383,7 +450,7 @@ function taskCard(task) {
     showMessage,
   }));
   footer.append(time, openTask);
-  article.append(heading, project, summary, footer);
+  article.append(heading, project, summary, relatedLinks, footer);
   return article;
 }
 

package/src/dashboard/github-links.js

@@ -0,0 +1,197 @@
+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_])/gi;
+export const MAX_RELATED_GITHUB_LINKS = 20;
+
+function canonicalRepository(owner, repository) {
+  return `${owner.toLowerCase()}/${repository.toLowerCase()}`;
+}
+
+function validRepositoryName(repository) {
+  return repository !== "." && repository !== "..";
+}
+
+export function normalizeGitHubRepository(value) {
+  if (typeof value !== "string") return null;
+  let candidate = value.trim();
+  const url = candidate.match(/^https?:\/\/(?:www\.)?github\.com\/([^/?#]+)\/([^/?#]+?)(?:\.git)?\/?$/i);
+  if (url) candidate = `${url[1]}/${url[2]}`;
+  if (!GITHUB_REPOSITORY.test(candidate)) return null;
+  const [owner, repository] = candidate.split("/");
+  if (!validRepositoryName(repository)) return null;
+  return canonicalRepository(owner, repository);
+}
+
+function rawReferences(text) {
+  const value = String(text ?? "");
+  const references = [];
+  for (const match of value.matchAll(REFERENCE_PATTERN)) {
+    const start = match.index;
+    const preceding = start > 0 ? value[start - 1] : "";
+    if (match[8] && /[\w&#/]/.test(preceding)) continue;
+    if ((match[5] || match[1]) && /[\w/]/.test(preceding)) continue;
+
+    let owner = match[1] ?? match[5] ?? null;
+    let repository = match[2] ?? match[6] ?? null;
+    const number = match[4] ?? match[7] ?? match[8];
+    const pathType = match[3]?.toLowerCase();
+    const type = pathType === "pull" ? "pull" : pathType === "issues" ? "issue" : "generic";
+    const explicit = Boolean(owner && repository);
+    if (explicit) {
+      if (!validRepositoryName(repository)) continue;
+      const normalized = canonicalRepository(owner, repository);
+      [owner, repository] = normalized.split("/");
+    }
+    references.push({
+      end: start + match[0].length,
+      explicit,
+      number,
+      owner,
+      repository,
+      start,
+      text: match[0],
+      type,
+    });
+  }
+  return references;
+}
+
+function uniqueExplicitRepository(references) {
+  const repositories = new Set(
+    references.filter(({ explicit }) => explicit).map(({ owner, repository }) => (
+      `${owner}/${repository}`
+    )),
+  );
+  return repositories.size === 1 ? [...repositories][0] : null;
+}
+
+function uniqueProjectRepository(projectRepositories) {
+  const repositories = new Set(
+    (projectRepositories ?? []).map(normalizeGitHubRepository).filter(Boolean),
+  );
+  return repositories.size === 1 ? [...repositories][0] : null;
+}
+
+function resolvedReference(reference, repositoryContext) {
+  const repository = reference.explicit
+    ? `${reference.owner}/${reference.repository}`
+    : repositoryContext;
+  if (!repository) return null;
+  const [owner, repositoryName] = repository.split("/");
+  const path = reference.type === "pull" ? "pull" : "issues";
+  return {
+    kind: "link",
+    number: reference.number,
+    owner,
+    repository: repositoryName,
+    text: reference.text,
+    type: reference.type,
+    url: `https://github.com/${owner}/${repositoryName}/${path}/${reference.number}`,
+  };
+}
+
+export function githubReferenceSegments(text, {
+  projectRepositories = [],
+  taskRepository = null,
+} = {}) {
+  const value = String(text ?? "");
+  const references = rawReferences(value);
+  const sourceRepository = uniqueExplicitRepository(references);
+  const repositoryContext = sourceRepository
+    ?? normalizeGitHubRepository(taskRepository)
+    ?? uniqueProjectRepository(projectRepositories);
+  const segments = [];
+  let offset = 0;
+  for (const reference of references) {
+    if (reference.start > offset) {
+      segments.push({ kind: "text", text: value.slice(offset, reference.start) });
+    }
+    const resolved = resolvedReference(reference, repositoryContext);
+    if (resolved) segments.push(resolved);
+    else {
+      segments.push({
+        kind: "ambiguous",
+        reason: `GitHub reference ${reference.text} is not linked because the repository is ambiguous.`,
+        text: reference.text,
+      });
+    }
+    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 ?? []) {
+    texts.push(turn.requestSummary, turn.result?.summary);
+  }
+  if (!(task.turns?.length > 0)) {
+    for (const result of task.results ?? []) texts.push(result.summary);
+    texts.push(task.summary);
+  }
+  return texts.filter((text) => typeof text === "string" && text.length > 0);
+}
+
+function relatedLinkLabel(link, includeRepository, includeOwner) {
+  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}`;
+}
+
+export function taskGitHubProjection(task) {
+  const texts = taskTexts(task);
+  const explicitRepositories = new Set();
+  for (const text of texts) {
+    for (const reference of rawReferences(text)) {
+      if (reference.explicit) {
+        explicitRepositories.add(`${reference.owner}/${reference.repository}`);
+      }
+    }
+  }
+  const taskRepository = explicitRepositories.size === 1 ? [...explicitRepositories][0] : null;
+  const links = [];
+  const seen = new Set();
+  let truncated = false;
+  sourceLoop:
+  for (const text of texts) {
+    for (const segment of githubReferenceSegments(text, {
+      projectRepositories: task.project?.githubRepos,
+      taskRepository,
+    })) {
+      if (segment.kind !== "link") continue;
+      const key = segment.url.toLowerCase();
+      if (seen.has(key)) continue;
+      if (links.length === MAX_RELATED_GITHUB_LINKS) {
+        truncated = true;
+        break sourceLoop;
+      }
+      seen.add(key);
+      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),
+      number: link.number,
+      owner: link.owner,
+      repository: link.repository,
+      type: link.type,
+      url: link.url,
+    })),
+    relatedGitHubLinksTruncated: truncated,
+    relatedGitHubRepository: taskRepository,
+  };
+}

package/src/dashboard/index.html

@@ -114,6 +114,7 @@
         </button>
         <button id="copy-thread-id" class="secondary-button" type="button">Copy thread ID</button>
       </div>
+      <nav id="dialog-related-links" class="github-links" aria-label="Related GitHub links" hidden></nav>
       <section>
         <h3>Activity timeline</h3>
         <div id="dialog-results" class="result-history"></div>

package/src/dashboard/styles.css

@@ -97,6 +97,15 @@ select { min-width: 180px; min-height: 36px; padding: 7px 32px 7px 10px; border:
 .task-title, .task-summary { overflow-wrap: anywhere; }
 .task-summary { display: grid; max-width: 82ch; margin-bottom: 12px; gap: 2px; font-size: 0.9rem; line-height: 1.45; }
 .task-summary strong { margin-top: 4px; color: var(--muted); font-size: 0.68rem; letter-spacing: 0.04em; text-transform: uppercase; }
+.github-links { display: flex; flex-wrap: wrap; gap: 7px; margin: 0 0 18px; }
+.github-links[hidden] { display: none; }
+.github-links-compact { margin: -2px 0 12px; gap: 5px; }
+.github-link { color: var(--accent); font-weight: 700; text-decoration-thickness: 1px; text-underline-offset: 3px; overflow-wrap: anywhere; }
+.github-link-compact { padding: 2px 7px; border: 1px solid var(--border); border-radius: 999px; background: var(--surface-muted); font-size: 0.72rem; line-height: 1.35; text-decoration: none; }
+.github-link:hover { text-decoration-thickness: 2px; }
+.github-link-compact:hover { border-color: var(--accent); background: var(--accent-soft); }
+.github-links-more { align-self: center; color: var(--muted); font-size: 0.75rem; font-weight: 700; }
+.github-reference-ambiguous { border-bottom: 2px dotted var(--warning); background: color-mix(in srgb, var(--warning) 12%, transparent); cursor: help; }
 time, .timestamp-missing { font-size: 0.75rem; }
 .timestamp-toggle { padding: 2px 0; border: 0; background: none; cursor: pointer; text-align: left; }
 .timestamp-toggle:hover time { color: var(--text); text-decoration: underline; text-underline-offset: 3px; }
@@ -136,7 +145,7 @@ time, .timestamp-missing { font-size: 0.75rem; }
 
 dialog { width: min(760px, calc(100vw - 32px)); max-height: min(82vh, 900px); padding: 28px; border: 1px solid var(--border); border-radius: 12px; background: var(--surface); color: var(--text); box-shadow: var(--shadow); }
 dialog::backdrop { background: rgb(18 23 21 / 50%); backdrop-filter: blur(2px); }
-.dialog-header { display: flex; justify-content: space-between; gap: 20px; }
+.dialog-header { display: flex; align-items: flex-start; justify-content: space-between; gap: 20px; }
 .dialog-header h2 { margin-bottom: 12px; font-size: 1.6rem; }
 .dialog-actions { display: flex; gap: 8px; margin-bottom: 26px; }
 .primary-button, .secondary-button { padding: 8px 12px; border-radius: 7px; font-weight: 700; cursor: pointer; }
@@ -173,6 +182,8 @@ pre { max-height: 280px; margin: 0; padding: 14px; overflow: auto; border-radius
   .task-heading { align-items: flex-start; }
   .task-title, .timestamp-toggle { display: flex; align-items: center; min-height: 36px; }
   .task-footer { align-items: flex-start; flex-direction: column; }
+  .github-links { max-width: 100%; }
+  .github-link-compact { padding-block: 5px; }
   .task-open { align-self: flex-start; }
   select { min-height: 40px; }
   .status-filter-option span { min-height: 38px; }

package/src/dashboard.js

@@ -17,6 +17,7 @@ import {
   readConfig,
 } from "./workspace.js";
 import { DASHBOARD_SERVER_VERSION, TASKCHEF_VERSION } from "./version.js";
+import { taskGitHubProjection } from "./dashboard/github-links.js";
 
 const TASKS_FILE_NAME = "tasks.jsonl";
 const STATIC_ROOT = fileURLToPath(new URL("./dashboard/", import.meta.url));
@@ -43,6 +44,7 @@ const STATIC_FILES = new Map([
   ["/", [path.join(STATIC_ROOT, "index.html"), "text/html; charset=utf-8"]],
   ["/actions.js", [path.join(STATIC_ROOT, "actions.js"), "text/javascript; charset=utf-8"]],
   ["/app.js", [path.join(STATIC_ROOT, "app.js"), "text/javascript; charset=utf-8"]],
+  ["/github-links.js", [path.join(STATIC_ROOT, "github-links.js"), "text/javascript; charset=utf-8"]],
   ["/time.js", [path.join(STATIC_ROOT, "time.js"), "text/javascript; charset=utf-8"]],
   ["/state.js", [path.join(STATIC_ROOT, "state.js"), "text/javascript; charset=utf-8"]],
   ["/styles.css", [path.join(STATIC_ROOT, "styles.css"), "text/css; charset=utf-8"]],
@@ -171,10 +173,17 @@ function assertDashboardTaskBounds(tasks, maximumTasks) {
 }
 
 function taskListProjection(task) {
-  const { turns: _turns, results: _results, ...projection } = task;
+  const { turns: _turns, results: _results, ...projection } = {
+    ...task,
+    ...taskGitHubProjection(task),
+  };
   return projection;
 }
 
+function taskDetailProjection(task) {
+  return { ...task, ...taskGitHubProjection(task) };
+}
+
 export class DashboardMonitor extends EventEmitter {
   constructor(workspace, {
     debounceMs = 75,
@@ -548,7 +557,7 @@ export async function createDashboardServer({
         response.writeHead(200, securityHeaders("application/json; charset=utf-8"));
         response.end();
       } else {
-        sendJson(response, 200, { schemaVersion: 1, task });
+        sendJson(response, 200, { schemaVersion: 1, task: taskDetailProjection(task) });
       }
       return;
     }