taskchef 7.14.0 → 7.14.1

package/.codex-plugin/plugin.json

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

package/docs/spec.md

@@ -138,6 +138,13 @@ the final link, preserving the delegate skill's immediate-return contract.
    TaskChef MUST atomically close it as `interrupted` before appending the new
    working turn; the executor MUST NOT report semantic `failed` for recovery.
 
+Request and result summaries are the durable source for dashboard related-link
+projection; TaskChef does not scan full Codex transcripts. When known, an
+executor MUST preserve the selected repository as a canonical GitHub repository
+URL and issues or pull requests as canonical URLs. A result spanning both a
+managed child repository and its workspace/root repository MUST include both
+pull-request URLs. Executors MUST NOT guess unresolved repository identity.
+
 If native creation fails after recording, the dispatcher MUST call
 `report_state` with `failed`, null thread/turn IDs, and a bounded summary.
 A link failure MUST remain visible and retryable; the executor MUST report it
@@ -287,8 +294,8 @@ marker, or ineligible state fails.
 | `threadId` | Matching non-empty ID for a linked task; null only for creation failure. |
 | `turnId` | Current canonical Codex UUIDv7 for a linked MCP journey; null only for creation failure. Maximum 256 characters at the MCP boundary. |
 | `status` | `working`, `needs_input`, `completed`, or `failed`. |
-| `summary` | Omitted or null for `working`; required non-empty string of at most 2,000 characters otherwise. |
-| `requestSummary` | Concise current request of at most 1,000 characters for `working`; optional for backward compatibility and omitted for semantic states. |
+| `summary` | Omitted or null for `working`; required non-empty string of at most 2,000 characters otherwise. Known GitHub issues and pull requests use canonical URLs. |
+| `requestSummary` | Concise current request of at most 1,000 characters for `working`; optional for backward compatibility and omitted for semantic states. A known selected GitHub repository uses its canonical URL. |
 
 **Structured output:** `{ task: Task }`.
 

package/docs/workflows.md

@@ -120,6 +120,13 @@ The executor obtains the turn identity from an exact native read of its own
 linked task. `report_state` records live turn state as a paired request/result
 timeline.
 
+That timeline is also the durable GitHub-link source. A working request names a
+known selected repository with its canonical GitHub URL. A terminal result
+keeps full issue and pull-request URLs, including separate child-repository and
+workspace/root pull requests. The dashboard does not recover omitted links by
+scanning the native Codex transcript, and the executor does not guess an
+ambiguous repository.
+
 ```mermaid
 sequenceDiagram
   autonumber

package/package.json

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

package/skills/taskchef-executor/SKILL.md

@@ -35,6 +35,9 @@ Complete this lifecycle setup before substantive assignment work:
 4. Call TaskChef `report_state` with the marked task ID, self-linked thread ID,
    current turn ID, `status: working`, an omitted or null result summary, and a
    concise `requestSummary` describing this turn's assignment or follow-up.
+   When the turn targets a known GitHub repository, include its canonical
+   `https://github.com/<owner>/<repository>` URL so multi-repository projects
+   retain the selected repository instead of leaving TaskChef to guess.
 
 If the preceding TaskChef turn is still unfinished because its terminal report
 was lost, this newer valid working report atomically records that predecessor
@@ -71,6 +74,30 @@ and unnecessary personal data. Identical lifecycle retries are safe; never
 replace a same-turn report with different content or let an older turn
 overwrite newer state.
 
+### Preserve repository and delivery links
+
+Treat lifecycle summaries as the durable TaskChef timeline; the dashboard does
+not scan the full Codex transcript later. Preserve known GitHub context in that
+timeline with canonical links:
+
+- Use `https://github.com/<owner>/<repository>` when identifying the repository
+  selected for a turn. Derive it from established project or Git remote
+  evidence; never guess from a similarly named directory.
+- Use the full canonical issue or pull-request URL whenever one is known. Do
+  not shorten it to bare `#123` or `PR #123` in a multi-repository project.
+- Include every delivered pull request in the result summary. If work produces
+  both a child-repository pull request and a workspace/root pull request,
+  preserve both URLs and state which repository each belongs to.
+- Keep references specific to the text being reported. Do not copy unrelated
+  links from earlier turns merely to make them visible.
+- Never invent an issue, pull request, or repository link. If repository
+  identity is genuinely unresolved, describe that ambiguity without a link.
+
+For example, a working summary may say `Update dashboard projection in
+https://github.com/favoyang/taskchef`. A terminal summary may say `Shipped the
+child change in https://github.com/favoyang/taskchef/pull/78 and the workspace
+plan in https://github.com/favoyang/skills-workspace/pull/62`.
+
 ## Compatibility
 
 Existing delegated tasks may include the former inline ownership, linking, and

package/src/dashboard/github-links.js

@@ -1,5 +1,5 @@
 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;
+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;
 export const MAX_RELATED_GITHUB_LINKS = 20;
 
 function canonicalRepository(owner, repository) {
@@ -28,13 +28,16 @@ function rawReferences(text) {
     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;
+    if ((match[5] || match[1] || match[9]) && /[\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];
+    let owner = match[1] ?? match[5] ?? match[9] ?? null;
+    let repository = match[2] ?? match[6] ?? match[10] ?? null;
+    if (match[9]) repository = repository.replace(/\.git$/i, "");
+    const number = match[4] ?? match[7] ?? match[8] ?? null;
     const pathType = match[3]?.toLowerCase();
-    const type = pathType === "pull" ? "pull" : pathType === "issues" ? "issue" : "generic";
+    const type = match[9]
+      ? "repository"
+      : pathType === "pull" ? "pull" : pathType === "issues" ? "issue" : "generic";
     const explicit = Boolean(owner && repository);
     if (explicit) {
       if (!validRepositoryName(repository)) continue;
@@ -77,6 +80,17 @@ function resolvedReference(reference, repositoryContext) {
     : repositoryContext;
   if (!repository) return null;
   const [owner, repositoryName] = repository.split("/");
+  if (reference.type === "repository") {
+    return {
+      kind: "link",
+      number: null,
+      owner,
+      repository: repositoryName,
+      text: reference.text,
+      type: reference.type,
+      url: `https://github.com/${owner}/${repositoryName}`,
+    };
+  }
   const path = reference.type === "pull" ? "pull" : "issues";
   return {
     kind: "link",
@@ -133,6 +147,7 @@ function taskTexts(task) {
 }
 
 function relatedLinkLabel(link, includeRepository, includeOwner) {
+  if (link.type === "repository") return `${link.owner}/${link.repository}`;
   const reference = link.type === "pull"
     ? `PR #${link.number}`
     : link.type === "issue"

package/src/mcp.js

@@ -225,7 +225,7 @@ export function createTaskChefMcpServer({
     {
       title: "Report TaskChef state",
       description:
-        "Report this self-linked executor turn's lifecycle state. Use working before substantive work in a newly linked or follow-up turn, with summary omitted or null and a concise requestSummary. Before ending the same turn, report needs_input, completed, or failed with a concise semantic summary and requestSummary omitted. Exact retries are idempotent; stale or mismatched turns are rejected.",
+        "Report this self-linked executor turn's lifecycle state. Use working before substantive work in a newly linked or follow-up turn, with summary omitted or null and a concise requestSummary. Preserve known repository context and delivered issues or pull requests as canonical GitHub URLs, including both child-repository and workspace pull requests when applicable. Before ending the same turn, report needs_input, completed, or failed with a concise semantic summary and requestSummary omitted. Exact retries are idempotent; stale or mismatched turns are rejected.",
       inputSchema: {
         taskId: z.string().min(1),
         threadId: z.string().min(1).nullable(),