taskchef 7.15.6 → 7.17.0

package/.codex-plugin/plugin.json

@@ -1,6 +1,6 @@
 {
   "name": "taskchef",
-  "version": "7.15.6",
+  "version": "7.17.0",
   "description": "Dispatch work from a data-only workspace to visible Codex project tasks.",
   "author": {
     "name": "Favo Yang",
@@ -29,10 +29,10 @@
     ],
     "websiteURL": "https://github.com/favoyang/taskchef",
     "defaultPrompt": [
-      "$taskchef-bootstrap Set up TaskChef and index my Codex projects.",
-      "$taskchef-delegate Dispatch this request to the right project.",
-      "$taskchef-executor Execute this delegated TaskChef assignment.",
-      "$taskchef-copilot Explain TaskChef outcomes and recommend the next action."
+      "$taskchef-bootstrap Set up TaskChef and index my local Codex projects.",
+      "$taskchef-delegate Do X in Y project.",
+      "Start and open the TaskChef dashboard.",
+      "$taskchef-copilot Summarize recent delegated work and tell me what needs attention."
     ],
     "brandColor": "#D97706",
     "composerIcon": "./assets/taskchef.svg",

package/README.md

@@ -41,7 +41,7 @@ no elevated permissions.
 Ask the bootstrap skill to create the per-user dispatcher:
 
 ```text
-$taskchef-bootstrap Set up TaskChef.
+$taskchef-bootstrap Set up TaskChef and index my local Codex projects.
 ```
 
 The canonical workspace is `~/.agents/taskchef`. TaskChef owns only:
@@ -181,7 +181,7 @@ The dashboard is the primary monitoring and browsing UI. Ask copilot when you
 want a concise explanation or recommendation:
 
 ```text
-$taskchef-copilot What finished, what needs attention, and what should I do next?
+$taskchef-copilot Summarize recent delegated work and tell me what needs attention.
 ```
 
 Copilot starts from TaskChef's normalized cached brief. It uses live Codex
@@ -219,6 +219,12 @@ eight-character prefix.
 
 ## Dashboard
 
+Ask the dispatcher to make the dashboard available and open it:
+
+```text
+Start and open the TaskChef dashboard.
+```
+
 Dispatcher turns call the input-free `ensure_dashboard` MCP tool. It starts at
 most one dashboard inside the existing TaskChef MCP process on
 `127.0.0.1:3210`, or reuses a listener only when its bounded `/api/health`

package/assets/taskchef-dispatcher-instructions.md

@@ -6,6 +6,10 @@ This folder is the canonical per-user TaskChef dispatcher workspace.
 - Early in every dispatcher turn, best-effort call the TaskChef
   `ensure_dashboard` MCP tool. Dashboard startup failure must not block direct
   TaskChef answers, reporting, or delegation.
+- A request to start or open the TaskChef dashboard is TaskChef maintenance,
+  not delegated project work. Call `ensure_dashboard`, then open or navigate to
+  its returned URL when an in-app browser capability is available. Otherwise,
+  return the URL as a clickable link.
 - Use `$taskchef-bootstrap` when initializing or refreshing this workspace,
   changing or listing its configured projects, running TaskChef doctor,
   or repairing its managed instructions.

package/package.json

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

package/src/dashboard/app.js

@@ -16,7 +16,11 @@ import {
   turnPresentation,
 } from "./state.js";
 import { openTaskFromControl } from "./actions.js";
-import { referenceSegments } from "./github-links.js";
+import {
+  githubReferenceAccessibleLabel,
+  githubReferenceDisplayLabels,
+  referenceSegments,
+} from "./github-links.js";
 import { formatRelativeTime, RelativeTimeController, parsedTimestamp } from "./time.js";
 
 const state = {
@@ -63,23 +67,15 @@ const elements = {
 };
 let notificationDescriptionSerial = 0;
 
-function typedReferenceLabel(link, label, typePrefix) {
-  if (!typePrefix) return label;
-  if (link.type === "pull") return `PR ${label}`;
-  if (link.type === "issue") return `Issue ${label}`;
-  return label;
-}
-
-function referenceLink(link, { compact = false, displayLabel, typePrefix = false } = {}) {
+function referenceLink(link, { compact = false, displayLabel } = {}) {
   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";
   const label = link.label ?? link.text;
-  const visibleLabel = typedReferenceLabel(link, displayLabel ?? label, typePrefix);
-  const accessibleLabel = typedReferenceLabel(link, label, typePrefix);
-  anchor.textContent = visibleLabel;
+  anchor.textContent = displayLabel ?? label;
+  const accessibleLabel = githubReferenceAccessibleLabel(link);
   const githubKind = link.type === "issue"
     ? ", GitHub issue"
     : link.type === "pull"
@@ -94,12 +90,20 @@ function referenceLink(link, { compact = false, displayLabel, typePrefix = false
 }
 
 function appendLinkedText(container, text, task) {
-  const children = referenceSegments(text, {
+  const segments = referenceSegments(text, {
     projectRepositories: task.project?.githubRepos,
     taskRepository: task.relatedGitHubRepository,
-  }).map((segment) => {
+  });
+  const links = segments.filter((segment) => segment.kind === "link");
+  const displayLabels = githubReferenceDisplayLabels(links);
+  let linkIndex = 0;
+  const children = segments.map((segment) => {
     if (segment.kind === "text") return document.createTextNode(segment.text);
-    if (segment.kind === "link") return referenceLink(segment, { typePrefix: true });
+    if (segment.kind === "link") {
+      const displayLabel = displayLabels[linkIndex];
+      linkIndex += 1;
+      return referenceLink(segment, { displayLabel });
+    }
     const ambiguous = document.createElement("span");
     ambiguous.className = "github-reference-ambiguous";
     ambiguous.textContent = segment.text;
@@ -121,18 +125,10 @@ 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 seenRepositories = new Set();
-  const children = links.map((link) => {
-    const repository = link.owner && link.repository
-      ? `${link.owner}/${link.repository}`
-      : null;
-    const repeatedRepository = repository && seenRepositories.has(repository);
-    if (repository) seenRepositories.add(repository);
-    const displayLabel = repeatedRepository && link.number
-      ? `#${link.number}`
-      : link.label;
-    return referenceLink(link, { compact, displayLabel, typePrefix: true });
-  });
+  const displayLabels = githubReferenceDisplayLabels(links, { related: true });
+  const children = links.map((link, index) => (
+    referenceLink(link, { compact, displayLabel: displayLabels[index] })
+  ));
   if (task.relatedGitHubLinksTruncated) {
     const more = document.createElement("span");
     more.className = "github-links-more";
@@ -160,7 +156,7 @@ function renderProject(container, task) {
         repository: repositoryName,
         type: "repository",
         url: `https://github.com/${repository}`,
-      }),
+      }, { displayLabel: repositoryName }),
     );
   }
   container.replaceChildren(...children);

package/src/dashboard/github-links.js

@@ -3,6 +3,64 @@ const REFERENCE_PATTERN = /https?:\/\/(?:www\.)?github\.com\/([A-Za-z0-9](?:[A-Z
 const ABSOLUTE_HTTP_PATTERN = /https?:\/\/[^\s<>"'`]+/gi;
 export const MAX_RELATED_GITHUB_LINKS = 20;
 
+function repositoryIdentity(link) {
+  if (!link?.owner || !link?.repository) return null;
+  return `${link.owner.toLowerCase()}/${link.repository.toLowerCase()}`;
+}
+
+function collidingRepositoryBasenames(links) {
+  const repositoriesByBasename = new Map();
+  for (const link of links) {
+    const identity = repositoryIdentity(link);
+    if (!identity) continue;
+    const basename = link.repository.toLowerCase();
+    const repositories = repositoriesByBasename.get(basename) ?? new Set();
+    repositories.add(identity);
+    repositoriesByBasename.set(basename, repositories);
+  }
+  return new Set(
+    [...repositoriesByBasename]
+      .filter(([, repositories]) => repositories.size > 1)
+      .map(([basename]) => basename),
+  );
+}
+
+function visibleRepositoryLabel(link, collisions) {
+  return collisions.has(link.repository.toLowerCase())
+    ? `${link.owner}/${link.repository}`
+    : link.repository;
+}
+
+export function githubReferenceDisplayLabels(links, { related = false } = {}) {
+  const collisions = collidingRepositoryBasenames(links);
+  let previousRepository = null;
+  return links.map((link) => {
+    if (link.provider !== "github" && !link.owner) return link.label ?? link.text;
+    const repository = repositoryIdentity(link);
+    const repositoryLabel = visibleRepositoryLabel(link, collisions);
+    if (link.type === "repository") return repositoryLabel;
+    if (related) {
+      const label = repository === previousRepository
+        ? `#${link.number}`
+        : `${repositoryLabel} #${link.number}`;
+      previousRepository = repository;
+      return label;
+    }
+    if (link.type === "pull") return `${repositoryLabel} PR #${link.number}`;
+    if (link.type === "issue") return `${repositoryLabel} Issue #${link.number}`;
+    return `${repositoryLabel} #${link.number}`;
+  });
+}
+
+export function githubReferenceAccessibleLabel(link) {
+  const repository = repositoryIdentity(link);
+  if (!repository) return link.label ?? link.text;
+  if (link.type === "repository") return repository;
+  if (link.type === "pull") return `${repository} PR #${link.number}`;
+  if (link.type === "issue") return `${repository} Issue #${link.number}`;
+  return `${repository} #${link.number}`;
+}
+
 function canonicalRepository(owner, repository) {
   return `${owner.toLowerCase()}/${repository.toLowerCase()}`;
 }