agents-relay 2.0.80 → 2.0.82

package/README.md

@@ -266,11 +266,11 @@ npx agents-relay task create --repo OWNER/REPO --pr 5 --id job-1 \
 
 GitHub PR state is authoritative for terminal lifecycle: a merged PR reconciles its managed job to `COMPLETED`; a closed, unmerged PR reconciles to `CANCELLED` and cannot launch queued work. The dashboard exposes `/api/jobs` and shows PR state, durable Job lifecycle, and derived runtime status separately. A merged PR reconciles lifecycle to `COMPLETED`; a closed, unmerged PR reconciles lifecycle to `CANCELLED`.
 
-`adapter: orchestrator` is reserved for synchronous self-work by the exact orchestrator turn that creates the Task. Relay deliberately does not auto-start these Tasks during reconciliation. The creator must perform the work before ending the turn and terminalize the same Task with `npx agents-relay task complete --task-id <id> --summary <summary> ...`. If work should continue asynchronously or in a later turn, use a real worker adapter instead.
+Relay has no orchestrator worker adapter for new work. Orchestrators are external clients that create/plan durable Tasks; Execution Router selects a real worker route (`codex` or `chatgpt`). The CLI and dashboard do not expose manual orchestrator-only `task start`, `task complete`, or synthetic `record` paths.
 
-As a narrow recovery exception, reconciliation converts a `QUEUED` work Task that still has `adapter: orchestrator`, no execution identity, and is at least 30 minutes past `createdAt` into a normal ChatGPT-routable Task. This preserves the Task identity, intent, dependencies, output, lineage, priority, and story size while clearing stale routing state. `RUNNING` and terminal Tasks are never converted; the 30-minute rescue does not weaken the synchronous self-task contract for newly created work.
+Historical stores may still contain `adapter: orchestrator`. Reconciliation treats that value only as legacy migration evidence: QUEUED work that never started can be converted in place to normal worker requirements; RUNNING work with an unknown outcome is quarantined as BLOCKED instead of replayed; only explicit durable `externalCompletionVerified` evidence can complete legacy work without execution. New Task creation and Task update reject that adapter.
 
-For work that was completed outside the relay but must be represented truthfully in durable history, use `npx agents-relay record --task-id <id> --summary <summary> --commit <sha>`. Recorded tasks use the `orchestrator` adapter and terminal `SUCCEEDED` state; they do not pretend a shell/model worker executed the work. This is a repair/backfill mechanism—normal work should be created as a durable Task before execution. For managed jobs, the GitHub PR body is the canonical Job surface: hidden Job metadata marker plus the visible Markdown objective.
+For managed jobs, the GitHub PR body is the canonical collaboration surface while SQLite remains lifecycle authority.
 
 ### Automatic task troubleshooting
 

package/dist/cli-help.js

@@ -116,7 +116,7 @@ Actions:
     'task create': `Create one durable Task under an existing Job.
 
 Required: normal Job storage options plus --input-file PATH|- (preferred) or --input MARKDOWN, and --output task-pr|file. --input and --input-file are mutually exclusive.
-Common: --task-id ID (optional; Relay auto-assigns repository-scoped task number), --idempotency-key KEY, --priority P0|P1|P2|P3, --story-size S|M|L, --agent NAME, --agent-graph-file PATH|-, --deps a,b, --parent ID, --draft. Normal model-backed Tasks omit adapter/provider/model so Relay runs one Execution Router decision over complete worker+model routes. Use --adapter orchestrator only for synchronous self-work; explicit adapter/provider/model remain compatibility/debug constraints.\nTasks with dependencies start DRAFT; tasks without dependencies start QUEUED unless --draft is given.
+Common: --task-id ID (optional; Relay auto-assigns a global increasing integer Task ID), --title TITLE (optional; otherwise derived from the first non-empty input line), --idempotency-key KEY, --priority P0|P1|P2|P3, --story-size S|M|L, --agent NAME, --agent-graph-file PATH|-, --deps a,b, --parent ID, --draft. Normal model-backed Tasks omit adapter/provider/model so Relay runs one Execution Router decision over complete worker+model routes. New Tasks are worker-routed; legacy adapter=orchestrator records are recovery-only and cannot be created or manually executed.\nTasks with dependencies start DRAFT; tasks without dependencies start QUEUED unless --draft is given.
 Directly-created Tasks are not wrapped in a synthetic Plan. Planner-generated Tasks are created internally by Relay from planner output.
 
 Example:
@@ -124,7 +124,7 @@ Example:
     'task update': `Update mutable durable Task fields in place.
 
 Required: --task-id ID and the normal Job storage options.
-Mutable while not RUNNING/SUCCEEDED/CANCELLED: --adapter, --priority, --story-size, --input-file PATH|- or --input MARKDOWN, --project, --agent, --agent-graph-file PATH|-, --parent, --deps, --capabilities, --timeout, --max-attempts, --provider, --model, --profile, --reasoning, --cwd, --chatgpt-project, --chatgpt-tab-close-policy, --draft, --queue.
+Mutable while not RUNNING/SUCCEEDED/CANCELLED: --title, --adapter, --priority, --story-size, --input-file PATH|- or --input MARKDOWN, --project, --agent, --agent-graph-file PATH|-, --parent, --deps, --capabilities, --timeout, --max-attempts, --provider, --model, --profile, --reasoning, --cwd, --chatgpt-project, --chatgpt-tab-close-policy, --draft, --queue.
 Use --clear-routing to remove routing metadata.
 
 Example:
@@ -135,12 +135,6 @@ Required: --task-id ID and the normal Job storage options.`,
     'task list': `List durable Tasks for one Job.
 
 Required: the normal Job storage options.`,
-    'task start': `Mark one orchestrator-owned self Task RUNNING when the creating orchestrator actually begins the work.
-
-Required: --task-id ID and the normal Job storage options. The Task must use adapter=orchestrator and be QUEUED. Start must occur before task complete.`,
-    'task complete': `Complete one orchestrator-owned Task after the creating orchestrator has finished the work.
-
-Required: --task-id ID, --summary TEXT, and the normal Job storage options. The Task must use adapter=orchestrator and already be RUNNING. This command is for the same orchestrator turn that created the self-task; it is not a deferred handoff mechanism.`,
     'task retry': `Retry one durable Task.
 
 Required: --task-id ID and the normal Job storage options.`,
@@ -150,6 +144,9 @@ Required: --task-id ID, --recovery-task-id TROUBLESHOOTER_ID, and the normal Job
     'task cancel': `Cancel one durable Task.
 
 Required: --task-id ID and the normal Job storage options.`,
+    'task supersede': `Mark an already-CANCELLED durable Task as superseded by later corrected work through the Task Resolution Graph.
+
+Required: --task-id ID, --reason TEXT, and the normal managed Job storage options. This does not change Task state and cannot supersede FAILED/BLOCKED/runnable work.`,
     plan: `Invoke the Planner against the current durable Job state.
 
 Required: --repo OWNER/REPO, --pr NUMBER, and --id JOB_ID.

package/dist/cli-review.js

@@ -14,5 +14,5 @@ export async function runReviewCommand(action, reviewArgs) {
         throw new Error('review request requires --repo and --id');
     const threadId = reviewRequestThreadOverride(reviewArgs);
     const job = await relayControlCommand(reviewArgs, { command: 'review.request', jobId, ...(threadId !== undefined ? { threadId } : {}) });
-    console.log(JSON.stringify({ jobId: job.id, pr: job.externalPrNumber ?? job.prNumber ?? 0, reviewerThreadId: job.reviewerThreadId ?? null, status: 'requested', note: 'Relay graph will create the review Task once eligible; this is not a delivery receipt.' }, null, 2));
+    console.log(JSON.stringify({ jobId: job.id, pr: job.prNumber ?? 0, reviewerThreadId: job.reviewerThreadId ?? null, status: 'requested', note: 'Relay graph will create the review Task once eligible; this is not a delivery receipt.' }, null, 2));
 }

package/dist/cli-support.js

@@ -77,9 +77,9 @@ export async function storeFor(args) {
     if (!binding || binding.job.repository !== repo)
         throw new Error('Immutable local Job not found for repository: ' + jobId);
     const suppliedPr = arg(args, '--pr');
-    const boundPr = binding.job.externalPrNumber ?? (binding.job.prNumber > 0 ? binding.job.prNumber : 0);
+    const boundPr = binding.job.prNumber > 0 ? binding.job.prNumber : 0;
     if (suppliedPr && boundPr !== Number(suppliedPr))
-        throw new Error('Local Job external PR binding mismatch');
+        throw new Error('Local Job/PR binding mismatch');
     return { store: binding.store, job: await binding.store.load(jobId), localFile: null };
 }
 export async function saveLocal(file, job) { if (file)
@@ -247,26 +247,6 @@ export async function publishTaskUnblocked(bus, job, taskId, reason) { if (!bus)
 catch (error) {
     process.stderr.write(`warning: unblock event unavailable: ${error instanceof Error ? error.message : String(error)}\n`);
 } }
-export async function publishOrchestratorTaskStarted(bus, job, task) {
-    if (!bus)
-        return;
-    try {
-        await bus.publish(eventFor(job.id, task.id, task.parentTaskId, 'task.started', 'running', `Task ${task.id} started by orchestrator`, 'orchestrator', { adapter: 'orchestrator' }, { agent: 'relay', component: 'agents-relay' }));
-    }
-    catch (error) {
-        process.stderr.write(`warning: orchestrator task start event unavailable for ${job.id}/${task.id}: ${error instanceof Error ? error.message : String(error)}\n`);
-    }
-}
-export async function publishOrchestratorTaskCompletion(bus, job, task, summary) {
-    if (!bus)
-        return;
-    try {
-        await bus.publish(eventFor(job.id, task.id, task.parentTaskId, 'task.completed', 'succeeded', `Task ${task.id} completed by orchestrator`, 'orchestrator', { adapter: 'orchestrator', summary }, { agent: 'relay', component: 'agents-relay' }));
-    }
-    catch (error) {
-        process.stderr.write(`warning: orchestrator task completion event unavailable for ${job.id}/${task.id}: ${error instanceof Error ? error.message : String(error)}\n`);
-    }
-}
 export async function publishDependentUnblocked(bus, targets, reason) { if (!bus)
     return; for (const target of targets) {
     try {

package/dist/cli-worker-task.js

@@ -14,23 +14,24 @@ export async function workerTaskFromArgs(job, args, now) {
         parseAgentGraph(agentGraph);
     if (!input.trim())
         throw new Error('task create requires --input-file PATH|- or --input MARKDOWN');
-    if (!['codex', 'chatgpt', 'orchestrator'].includes(adapter))
-        throw new Error('task create --adapter must be codex, chatgpt, or orchestrator');
+    if (!['codex', 'chatgpt'].includes(adapter))
+        throw new Error('task create --adapter must be codex or chatgpt; orchestrator is reserved for legacy recovery only');
     if (outputKind !== 'task-pr' && outputKind !== 'file')
         throw new Error('task create requires --output task-pr|file');
     if (outputKind === 'file' && !outputPath)
         throw new Error('--output file requires --output-path');
-    if (adapter !== 'orchestrator' && ['--provider', '--profile', '--reasoning', '--cwd', '--chatgpt-project'].some(flag => hasArg(args, flag)) && !model)
+    if (['--provider', '--profile', '--reasoning', '--cwd', '--chatgpt-project'].some(flag => hasArg(args, flag)) && !model)
         throw new Error('task create explicit routing requires --model');
-    const routing = adapter === 'orchestrator' || !model ? undefined : { provider: arg(args, '--provider', 'openai'), model, profile: arg(args, '--profile') || undefined, reasoning: arg(args, '--reasoning') || undefined, cwd: arg(args, '--cwd') || undefined, projectId: arg(args, '--chatgpt-project') || undefined, decidedBy: 'cli', decidedAt: now };
-    const workerRequirements = adapter === 'orchestrator' || routing ? undefined : { capabilities: [], runtime: adapterValue ? adapter : undefined };
+    const routing = !model ? undefined : { provider: arg(args, '--provider', 'openai'), model, profile: arg(args, '--profile') || undefined, reasoning: arg(args, '--reasoning') || undefined, cwd: arg(args, '--cwd') || undefined, projectId: arg(args, '--chatgpt-project') || undefined, decidedBy: 'cli', decidedAt: now };
+    const workerRequirements = routing ? undefined : { capabilities: [], runtime: adapterValue ? adapter : undefined };
     const closePolicy = hasArg(args, '--chatgpt-tab-close-policy') ? chatGptTabClosePolicy(args) : undefined;
     const size = storySize(args);
     const dependencies = arg(args, '--deps').split(',').filter(Boolean);
-    const timeoutMs = adapter === 'orchestrator' ? 0 : hasArg(args, '--timeout') ? integerArg(args, '--timeout', taskOverallTimeoutMs(size, routing?.reasoning)) : routing ? taskOverallTimeoutMs(size, routing.reasoning) : 0;
+    const timeoutMs = hasArg(args, '--timeout') ? integerArg(args, '--timeout', taskOverallTimeoutMs(size, routing?.reasoning)) : routing ? taskOverallTimeoutMs(size, routing.reasoning) : 0;
     return createTaskEntity(job, {
         jobId: job.id,
         id: arg(args, '--task-id', 'initial'),
+        title: arg(args, '--title') || undefined,
         priority: priority(args, job.priority ?? 'P2'),
         storySize: size,
         projectName: arg(args, '--project') || undefined,

package/dist/cli.js

@@ -18,7 +18,7 @@ import { codexAndZaiUsageRegistry } from './usage.js';
 import { decisionMode, executionDecisionEngine } from './decision.js';
 import { discoverAgents } from './registry.js';
 import { AgentObjectivePlanner, CommandObjectivePlanner } from './planner.js';
-import { applyOrchestratorStartAction, applyOrchestratorCompleteAction, applyTaskHoldAction, applyTaskQueueAction, dispatchTaskAction } from './task-actions.js';
+import { applyTaskHoldAction, applyTaskQueueAction, dispatchTaskAction } from './task-actions.js';
 import { applyJobActivateAction, applyJobCancelAction } from './job-actions.js';
 import { resolveExecutionContext } from './execution-context.js';
 import { startServiceExternalActionFlusher } from './service-external-actions.js';
@@ -59,12 +59,6 @@ async function runManagedTaskCommand(action, args) {
         if (!id)
             id = result.createdTaskId ?? '';
     }
-    else if (action === 'complete') {
-        const summary = arg(args, '--summary');
-        if (!summary)
-            throw new Error('task complete requires --summary');
-        result = await relayTaskCommand(args, { jobId, taskId: id, action, summary });
-    }
     else
         result = await relayTaskCommand(args, { jobId, taskId: id, action });
     const task = result.tasks.find(item => item.id === id);
@@ -73,7 +67,7 @@ async function runManagedTaskCommand(action, args) {
     console.log(JSON.stringify(task, null, 2));
 }
 async function runTaskCommand(action, args) {
-    if (!['create', 'update', 'show', 'list', 'start', 'complete', 'retry', 'recover', 'unblock', 'cancel'].includes(action))
+    if (!['create', 'update', 'show', 'list', 'retry', 'recover', 'unblock', 'cancel', 'supersede'].includes(action))
         throw new Error(usage);
     const managed = !arg(args, '--file') && Boolean(arg(args, '--repo') && arg(args, '--id'));
     if (managed) {
@@ -94,10 +88,20 @@ async function runTaskCommand(action, args) {
             console.log(JSON.stringify(task, null, 2));
             return;
         }
-        if (['create', 'start', 'complete', 'retry', 'cancel'].includes(action)) {
+        if (['create', 'retry', 'cancel'].includes(action)) {
             await runManagedTaskCommand(action, args);
             return;
         }
+        if (action === 'supersede') {
+            if (!taskId)
+                throw new Error('task supersede requires --task-id');
+            const reason = arg(args, '--reason');
+            if (!reason.trim())
+                throw new Error('task supersede requires --reason');
+            const job = await relayControlCommand(args, { command: 'task.supersede', jobId, taskId, reason });
+            console.log(JSON.stringify(job.tasks.find(item => item.id === taskId), null, 2));
+            return;
+        }
         if (action === 'recover') {
             if (!taskId)
                 throw new Error('task recover requires --task-id');
@@ -126,10 +130,12 @@ async function runTaskCommand(action, args) {
             const expectedUpdatedAt = task.updatedAt;
             if (['RUNNING', 'UNBLOCKED', 'SUCCEEDED', 'CANCELLED'].includes(task.state))
                 throw new Error(`Task ${taskId} is ${task.state}; durable execution fields are immutable in this state`);
+            if (hasArg(args, '--title'))
+                task.title = arg(args, '--title');
             if (hasArg(args, '--adapter')) {
                 const adapter = arg(args, '--adapter');
-                if (!['codex', 'chatgpt', 'orchestrator'].includes(adapter))
-                    throw new Error('--adapter must be codex, chatgpt, or orchestrator');
+                if (!['codex', 'chatgpt'].includes(adapter))
+                    throw new Error('--adapter must be codex or chatgpt');
                 task.adapter = adapter;
             }
             if (hasArg(args, '--priority'))
@@ -203,23 +209,6 @@ async function runTaskCommand(action, args) {
         await runTaskUnblockCommand(args, store, job, task, localFile);
         return;
     }
-    if (action === 'start') {
-        await applyOrchestratorStartAction(task);
-        await store.saveTask(task);
-        await saveLocal(localFile, await store.load(job.id));
-        console.log(JSON.stringify(task, null, 2));
-        return;
-    }
-    if (action === 'complete') {
-        const summary = arg(args, '--summary');
-        if (!summary)
-            throw new Error('task complete requires --summary');
-        await applyOrchestratorCompleteAction(task, summary);
-        await store.saveTask(task);
-        await saveLocal(localFile, await store.load(job.id));
-        console.log(JSON.stringify(task, null, 2));
-        return;
-    }
     if (action === 'retry' || action === 'recover' || action === 'cancel') {
         let outputJob = job;
         let outputTask = task;
@@ -250,8 +239,8 @@ async function runTaskCommand(action, args) {
         throw new Error(`Task ${id} is ${task.state}; durable execution fields are immutable in this state`);
     if (hasArg(args, '--adapter')) {
         const adapter = arg(args, '--adapter');
-        if (!['codex', 'chatgpt', 'orchestrator'].includes(adapter))
-            throw new Error('--adapter must be codex, chatgpt, or orchestrator');
+        if (!['codex', 'chatgpt'].includes(adapter))
+            throw new Error('--adapter must be codex or chatgpt');
         task.adapter = adapter;
     }
     if (hasArg(args, '--priority'))
@@ -402,7 +391,7 @@ async function runJobCommand(action, args) {
         console.log(JSON.stringify(job, null, 2));
         return;
     }
-    const boundPrNumber = job.externalPrNumber ?? (job.prNumber > 0 ? job.prNumber : 0);
+    const boundPrNumber = job.prNumber > 0 ? job.prNumber : 0;
     if (job.repository !== repo || (prValue && boundPrNumber !== prNumber)) {
         throw new Error('Local Job/PR binding mismatch');
     }
@@ -504,7 +493,7 @@ export async function createService(args) {
     const webhook = !noGitHubMode(args) && repo && webhookSecret ? {
         secret: webhookSecret,
         repositories: new Set([repo]),
-        pullRequest: loaded.job.externalPrNumber ?? loaded.job.prNumber,
+        pullRequest: loaded.job.prNumber,
         jobId: loaded.job.id,
         wake: async (event) => {
             if (event.pullRequestFacts && loaded.store.applyPullRequestFacts) {
@@ -655,7 +644,7 @@ async function main() {
         console.log(JSON.stringify(await response.json(), null, 2));
         return;
     }
-    if (!arg(args, '--file') && ['plan', 'reconcile', 'record', 'agent-register', 'agent-discover'].includes(command)) {
+    if (!arg(args, '--file') && ['plan', 'reconcile', 'agent-register', 'agent-discover'].includes(command)) {
         const jobId = arg(args, '--id');
         if (!jobId)
             throw new Error(`${command} requires --repo and --id`);
@@ -668,18 +657,6 @@ async function main() {
             console.log(JSON.stringify(await relayControlCommand(args, { command: 'job.reconcile', jobId }), null, 2));
             return;
         }
-        if (command === 'record') {
-            const now = new Date().toISOString();
-            const id = arg(args, '--task-id', randomUUID());
-            const summary = arg(args, '--summary');
-            if (!summary)
-                throw new Error('record requires --summary');
-            const commit = arg(args, '--commit');
-            const task = { jobId, id, projectName: arg(args, '--project') || undefined, agentName: arg(args, '--agent', 'orchestrator'), parentTaskId: arg(args, '--parent') || null, dependencies: arg(args, '--deps').split(',').filter(Boolean), capabilities: [], adapter: 'orchestrator', input: arg(args, '--input', summary), continuation: null, continuationDeliveredAt: null, state: 'SUCCEEDED', attempt: 1, maxAttempts: 1, leaseOwner: null, leaseExpiresAt: null, executionId: commit || null, threadId: null, result: { summary, data: commit ? { commit } : undefined }, error: null, timeoutMs: 0, createdAt: now, updatedAt: now };
-            const updated = await relayControlCommand(args, { command: 'record', jobId, task });
-            console.log(JSON.stringify(updated.tasks.find(item => item.id === id), null, 2));
-            return;
-        }
         if (command === 'agent-register') {
             const now = new Date().toISOString();
             const agent = { id: arg(args, '--agent-id', randomUUID()), name: arg(args, '--name'), responsibility: arg(args, '--responsibility'), role: arg(args, '--role'), capabilities: arg(args, '--capabilities').split(',').filter(Boolean), boundaries: arg(args, '--boundaries').split('|').filter(Boolean), endpoint: { kind: arg(args, '--endpoint-kind', 'adapter'), target: arg(args, '--endpoint') }, runtime: { adapter: arg(args, '--runtime', arg(args, '--adapter', 'shell')), provider: arg(args, '--provider') || undefined, model: arg(args, '--model') || undefined }, availability: arg(args, '--availability', 'available'), routing: { labels: arg(args, '--labels').split(',').filter(Boolean).reduce((out, item) => { const [key, value] = item.split('=', 2); if (key && value)
@@ -729,20 +706,6 @@ async function main() {
         console.log(JSON.stringify(candidates, null, 2));
         return;
     }
-    if (command === 'record') {
-        const now = new Date().toISOString();
-        const id = arg(args, '--task-id', randomUUID());
-        const summary = arg(args, '--summary');
-        if (!summary)
-            throw new Error('record requires --summary');
-        const commit = arg(args, '--commit');
-        const task = { jobId: job.id, id, projectName: arg(args, '--project') || undefined, agentName: arg(args, '--agent', 'orchestrator'), parentTaskId: arg(args, '--parent') || null, dependencies: arg(args, '--deps').split(',').filter(Boolean), capabilities: [], adapter: 'orchestrator', input: arg(args, '--input', summary), continuation: null, continuationDeliveredAt: null, state: 'SUCCEEDED', attempt: 1, maxAttempts: 1, leaseOwner: null, leaseExpiresAt: null, executionId: commit || null, threadId: null, result: { summary, data: commit ? { commit } : undefined }, error: null, timeoutMs: 0, createdAt: now, updatedAt: now };
-        await store.appendTask(task);
-        job.tasks.push(task);
-        await saveLocal(localFile, job);
-        console.log(`Recorded ${id}`);
-        return;
-    }
     if (command === 'serve') {
         await startService(args);
         return;

package/dist/dashboard-actions.js

@@ -24,7 +24,8 @@ export function dashboardJobSetState(store) {
         if (state === 'CANCELLED') {
             if (job.state !== 'CANCELLED')
                 await applyJobCancelAction(store, job);
-            await store.closePullRequest?.();
+            if (!job.localMerge?.sourceRef)
+                await store.closePullRequest?.();
             return await store.load(job.id);
         }
         if (job.state === state)

package/dist/dashboard-html.js

@@ -345,7 +345,7 @@ function cadence(job){const schedule=job?.schedule;if(!schedule?.cron)return '
 function safePrUrl(repository,prNumber){if(typeof repository!=='string'||!Number.isInteger(prNumber)||prNumber<=0)return null;const parts=repository.split('/');if(parts.length!==2)return null;const [owner,repo]=parts;if(!owner||!repo||owner==='.'||owner==='..'||repo==='.'||repo==='..')return null;if(!/^[A-Za-z0-9-]+$/.test(owner)||!/^[A-Za-z0-9._-]+$/.test(repo))return null;return 'https://github.com/'+owner+'/'+repo+'/pull/'+prNumber;}
 function safeCommitUrl(repository,sha){if(typeof repository!=='string'||typeof sha!=='string'||!/^[0-9a-f]{7,64}$/i.test(sha))return null;const parts=repository.split('/');if(parts.length!==2||!parts[0]||!parts[1])return null;return 'https://github.com/'+parts[0]+'/'+parts[1]+'/commit/'+sha;}
 function commitField(label,job,sha){const box=element('div','detail-group');box.append(element('p','detail-label',text(label)));const line=element('p','detail-value');const url=safeCommitUrl(job?.repository,sha);if(url){const link=document.createElement('a');link.href=url;link.target='_blank';link.rel='noopener noreferrer';link.textContent=sha.slice(0,7);line.append(link);}else line.append(text(sha||'—'));box.append(line);return box;}
-function prField(job){const box=element('div','detail-group');box.append(element('p','detail-label',text('GitHub PR')));const line=element('p','detail-value');const prNumber=Number(job.externalPrNumber||job.prNumber||0);const url=safePrUrl(job.repository,prNumber);if(url){const link=document.createElement('a');link.href=url;link.target='_blank';link.rel='noopener noreferrer';link.textContent='PR #'+prNumber;line.append(link);}else line.append(text('unavailable'));box.append(line);return box;}
+function prField(job){const box=element('div','detail-group');box.append(element('p','detail-label',text('GitHub PR')));const line=element('p','detail-value');const prNumber=Number(job.prNumber||0);const url=safePrUrl(job.repository,prNumber);if(url){const link=document.createElement('a');link.href=url;link.target='_blank';link.rel='noopener noreferrer';link.textContent='PR #'+prNumber;line.append(link);}else line.append(text('unavailable'));box.append(line);return box;}
 function chatField(task){const box=element('div','detail-group');box.append(element('p','detail-label',text('Chat')));const line=element('p','detail-value');if(task.adapter==='chatgpt'&&typeof task.threadId==='string'&&task.threadId){const link=document.createElement('a');link.href='https://chatgpt.com/c/'+encodeURIComponent(task.threadId);link.target='_blank';link.rel='noopener noreferrer';link.textContent='Open chat';line.append(link);}else line.append(text('—'));box.append(line);return box;}
 function taskCommentField(task){const box=element('div','detail-group');box.append(element('p','detail-label',text('PR comment')));const line=element('p','detail-value');if(typeof task.taskUrl==='string'&&task.taskUrl.startsWith('https://github.com/')){const link=document.createElement('a');link.className='task-link';link.href=task.taskUrl;link.target='_blank';link.rel='noopener noreferrer';link.textContent='Open task comment';line.append(link);}else line.append(text('—'));box.append(line);return box;}
 function parseAgentGraphSource(source){if(typeof source!=='string'||!source.trim())return null;const agents=new Map(),edges=[];for(const raw of source.split(/\\r?\\n/)){const line=raw.trim();if(!line||line.startsWith('%%')||line.startsWith('flowchart '))continue;let match=line.match(/^([A-Za-z_][A-Za-z0-9_.-]*)(?:\\[agent:([A-Za-z_][A-Za-z0-9_.-]*)\\])?\\s*-->\\s*([A-Za-z_][A-Za-z0-9_.-]*)(?:\\[agent:([A-Za-z_][A-Za-z0-9_.-]*)\\])?$/);if(match){agents.set(match[1],match[2]||agents.get(match[1])||match[1]);agents.set(match[3],match[4]||agents.get(match[3])||match[3]);edges.push([match[1],match[3]]);continue;}match=line.match(/^([A-Za-z_][A-Za-z0-9_.-]*)\\[agent:([A-Za-z_][A-Za-z0-9_.-]*)\\]$/);if(match){agents.set(match[1],match[2]);continue;}return null;}const incoming=new Map([...agents.keys()].map(id=>[id,0]));for(const [,to] of edges)incoming.set(to,(incoming.get(to)||0)+1);const remaining=new Map(incoming),waves=[];let ready=[...remaining].filter(([,degree])=>degree===0).map(([id])=>id).sort();while(ready.length){waves.push(ready);const next=[];for(const id of ready)for(const [from,to] of edges)if(from===id){const degree=(remaining.get(to)||0)-1;remaining.set(to,degree);if(degree===0)next.push(to);}ready=[...new Set(next)].sort();}return {agents,waves};}
@@ -384,14 +384,14 @@ const DEFAULT_CHAT_SHORTCUTS=[
 ].join('\\n');
 function chatShortcutText(){return localStorage.getItem(CHAT_SHORTCUTS_KEY)||DEFAULT_CHAT_SHORTCUTS;}
 function parseChatShortcuts(source){return String(source||'').split(/\\r?\\n/).map(line=>line.trim()).filter(Boolean).map(line=>{const split=line.indexOf(':');return split>0?{name:line.slice(0,split).trim(),prompt:line.slice(split+1).trim()}:null;}).filter(item=>item&&item.name&&item.prompt);}
-function jobChatRef(job){const pr=Number(job?.externalPrNumber||job?.prNumber||0);return repoName(job?.repository)+"/job:"+value(job?.id)+(pr>0?"/pr#"+pr:"")+": "+value(job?.title||job?.id);}
+function jobChatRef(job){const pr=Number(job?.prNumber||0);return repoName(job?.repository)+"/job:"+value(job?.id)+(pr>0?"/pr#"+pr:"")+": "+value(job?.title||job?.id);}
 function chatShortcutUrl(prompt){return 'https://chatgpt.com/?prompt='+encodeURIComponent(prompt);}
 const CHAT_SHORTCUT_TARGET='agents-relay-shortcut';
 function chatShortcutField(job){const box=element('div','detail-group');box.append(element('p','detail-label',text('ChatGPT shortcut')));const select=document.createElement('select');select.className='job-filter job-chat-shortcut-select';select.setAttribute('aria-label','ChatGPT shortcut');select.append(new Option('',''));for(const item of parseChatShortcuts(chatShortcutText()))select.append(new Option(item.name,item.prompt));select.value='';select.addEventListener('change',()=>{if(!select.value)return;const prompt=select.value.replaceAll('%1',jobChatRef(job));window.open(chatShortcutUrl(prompt),CHAT_SHORTCUT_TARGET,'noopener');select.value='';});box.append(select);return box;}
-function renderJobList(){jobList.replaceChildren();const visible=filteredJobs();if(!jobs.length){jobList.append(element('li','empty',text('No durable jobs discovered.')));return;}if(!visible.length){jobList.append(element('li','empty',text('No jobs match the selected repo.')));return;}for(const job of visible){const row=element('div','job-row'+(isCompleteUnmerged(job)?' complete-unmerged':''));row.setAttribute('aria-current',String(jobSelectionKey(job)===selectedJob));row.addEventListener('click',()=>selectJob(job));const content=element('div','job-content');const select=document.createElement('button');select.type='button';select.className='job-button';select.setAttribute('aria-current',String(jobSelectionKey(job)===selectedJob));select.title=job.title||job.id;select.addEventListener('click',event=>{event.stopPropagation();selectJob(job);});select.append(element('span','job-title',text(repoName(job.repository)+'/'+(Number(job.externalPrNumber||job.prNumber||0)>0?'PR#'+value(job.externalPrNumber||job.prNumber):'Job '+shortManagedId(job.id,job.repository,'j'))+': '+value(job.title||job.id))));const states=element('span','job-status-line');states.append(element('span','badge '+value(job.state),text(value(job.state))),element('span','badge '+value(job.runtimeStatus||'IDLE'),text(value(job.runtimeStatus||'IDLE'))));if(job.publicationFailure)states.append(element('span','badge FAILED',text('PUBLISH FAILED: '+value(job.publicationFailure.stage))));else if(job.publication?.version)states.append(element('span','badge SUCCEEDED',text('v'+job.publication.version)));else if(Number(job.externalPrNumber||0)>0&&job.githubState==='MERGED')states.append(element('span','badge MERGED',text('PR Merged')));else if(job.state==='COMPLETED'&&job.githubState==='CLOSED')states.append(element('span','badge SUCCEEDED',text('PR Archived')));if(job.executionMode==='autonomous')states.append(element('span','badge flag-autonomous',text('AUTONOMOUS')));if(job.state==='ACTIVE'&&job.reviewEnabled!==false)states.append(element('span','badge flag-review',text('REVIEW REQUIRED')));if(isCompleteUnmerged(job))states.append(element('span','badge MERGE_PENDING',text('MERGE PENDING')));const primary=element('div','job-primary');primary.append(states);const lastLine=element('div','job-last-line');lastLine.append(element('span','subtle',text(compactCounts(counts(job.tasks)))),element('span','subtle',text(relativeTime(job.updatedAt))));content.append(select,primary,lastLine);row.append(content);jobList.append(element('li','',row));}}
+function renderJobList(){jobList.replaceChildren();const visible=filteredJobs();if(!jobs.length){jobList.append(element('li','empty',text('No durable jobs discovered.')));return;}if(!visible.length){jobList.append(element('li','empty',text('No jobs match the selected repo.')));return;}for(const job of visible){const row=element('div','job-row'+(isCompleteUnmerged(job)?' complete-unmerged':''));row.setAttribute('aria-current',String(jobSelectionKey(job)===selectedJob));row.addEventListener('click',()=>selectJob(job));const content=element('div','job-content');const select=document.createElement('button');select.type='button';select.className='job-button';select.setAttribute('aria-current',String(jobSelectionKey(job)===selectedJob));select.title=job.title||job.id;select.addEventListener('click',event=>{event.stopPropagation();selectJob(job);});select.append(element('span','job-title',text(repoName(job.repository)+'/'+(Number(job.prNumber||0)>0?'PR#'+value(job.prNumber):'Job '+shortManagedId(job.id,job.repository,'j'))+': '+value(job.title||job.id))));const states=element('span','job-status-line');states.append(element('span','badge '+value(job.state),text(value(job.state))),element('span','badge '+value(job.runtimeStatus||'IDLE'),text(value(job.runtimeStatus||'IDLE'))));if(job.publicationFailure)states.append(element('span','badge FAILED',text('PUBLISH FAILED: '+value(job.publicationFailure.stage))));else if(job.publication?.version)states.append(element('span','badge SUCCEEDED',text('v'+job.publication.version)));else if(Number(job.prNumber||0)>0&&job.githubState==='MERGED')states.append(element('span','badge MERGED',text('PR Merged')));else if(job.state==='COMPLETED'&&job.githubState==='CLOSED')states.append(element('span','badge SUCCEEDED',text('PR Archived')));if(job.executionMode==='autonomous')states.append(element('span','badge flag-autonomous',text('AUTONOMOUS')));if(job.state==='ACTIVE'&&job.reviewEnabled!==false)states.append(element('span','badge flag-review',text('REVIEW REQUIRED')));if(isCompleteUnmerged(job))states.append(element('span','badge MERGE_PENDING',text('MERGE PENDING')));const primary=element('div','job-primary');primary.append(states);const lastLine=element('div','job-last-line');lastLine.append(element('span','subtle',text(compactCounts(counts(job.tasks)))),element('span','subtle',text(relativeTime(job.updatedAt))));content.append(select,primary,lastLine);row.append(content);jobList.append(element('li','',row));}}
 function taskTagDisplay(job,task){const display=task.tag&&job?.tag?.values?.[task.tag];return typeof display==='string'&&display?display:null;}
 function taskSubtreeComplete(task,children){return ['SUCCEEDED','CANCELLED'].includes(task.state)&&(children.get(task.id)||[]).every(child=>taskSubtreeComplete(child,children));}
-function taskNode(task,children,depth){const li=element('li');const nested=children.get(task.id)||[];const line=element('div','task-line');if(nested.length){const key=(selectedJob||'')+':'+task.id;const collapsed=collapsedTasks.has(key)||(!expandedTasks.has(key)&&taskSubtreeComplete(task,children));const fold=document.createElement('button');fold.type='button';fold.className='task-fold';fold.setAttribute('aria-expanded',String(!collapsed));fold.setAttribute('aria-label',(collapsed?'Expand ':'Collapse ')+task.id);fold.textContent=collapsed?'▸':'▾';line.append(fold);const ul=element('ul','tree');ul.hidden=collapsed;for(const child of nested)ul.append(taskNode(child,children,depth+1));fold.addEventListener('click',()=>{const next=!ul.hidden;ul.hidden=next;fold.setAttribute('aria-expanded',String(!next));fold.setAttribute('aria-label',(next?'Expand ':'Collapse ')+task.id);fold.textContent=next?'▸':'▾';if(next){collapsedTasks.add(key);expandedTasks.delete(key);}else{collapsedTasks.delete(key);expandedTasks.add(key);}});li.append(line,ul);}else li.append(line);const row=document.createElement('button');row.type='button';row.className='task-row';row.setAttribute('aria-current',String(task.id===selectedTaskId));row.title=task.id;row.addEventListener('click',()=>{const deselect=selectedTaskId===task.id;selectedTaskId=deselect?null:task.id;eventTaskId=deselect?null:task.id;rememberSelection();clearEvents();renderAll();void loadEventHistory();});const id=element('span','task-id',text(shortManagedId(task.id,selected()?.repository,'t')));id.style.paddingLeft=Math.min(depth,4)*6+'px';row.append(id,element('span','badge '+value(task.state),text(task.state)));const tag=taskTagDisplay(selected(),task);if(tag){const badge=element('span','task-tag',text(tag));badge.title=(selected()?.tag?.description||'Task tag')+': '+task.tag;row.append(badge);}line.append(row);return li;}
+function taskNode(task,children,depth){const li=element('li');const nested=children.get(task.id)||[];const line=element('div','task-line');if(nested.length){const key=(selectedJob||'')+':'+task.id;const collapsed=collapsedTasks.has(key)||(!expandedTasks.has(key)&&taskSubtreeComplete(task,children));const fold=document.createElement('button');fold.type='button';fold.className='task-fold';fold.setAttribute('aria-expanded',String(!collapsed));fold.setAttribute('aria-label',(collapsed?'Expand ':'Collapse ')+task.id);fold.textContent=collapsed?'▸':'▾';line.append(fold);const ul=element('ul','tree');ul.hidden=collapsed;for(const child of nested)ul.append(taskNode(child,children,depth+1));fold.addEventListener('click',()=>{const next=!ul.hidden;ul.hidden=next;fold.setAttribute('aria-expanded',String(!next));fold.setAttribute('aria-label',(next?'Expand ':'Collapse ')+task.id);fold.textContent=next?'▸':'▾';if(next){collapsedTasks.add(key);expandedTasks.delete(key);}else{collapsedTasks.delete(key);expandedTasks.add(key);}});li.append(line,ul);}else li.append(line);const row=document.createElement('button');row.type='button';row.className='task-row';row.setAttribute('aria-current',String(task.id===selectedTaskId));row.title=task.id;row.addEventListener('click',()=>{const deselect=selectedTaskId===task.id;selectedTaskId=deselect?null:task.id;eventTaskId=deselect?null:task.id;rememberSelection();clearEvents();renderAll();void loadEventHistory();});const label=element('span','task-id',text(task.title||task.input?.split(/\\r?\\n/).find(line=>line.trim())?.trim()||shortManagedId(task.id,selected()?.repository,'t')));label.style.paddingLeft=Math.min(depth,4)*6+'px';row.append(label,element('span','badge '+value(task.state),text(task.state)));const tag=taskTagDisplay(selected(),task);if(tag){const badge=element('span','task-tag',text(tag));badge.title=(selected()?.tag?.description||'Task tag')+': '+task.tag;row.append(badge);}line.append(row);return li;}
 function buildTree(tasks){taskTree.replaceChildren();if(!Array.isArray(tasks)||!tasks.length){taskTree.append(element('li','empty',text('No tasks in durable state.')));return;}const work=tasks.filter(task=>task.kind!=='planner');if(!work.length){taskTree.append(element('li','empty',text('No work tasks in durable state.')));return;}const known=new Set(work.map(task=>task.id));const children=new Map();const roots=[];for(const task of work){if(!task.parentTaskId||!known.has(task.parentTaskId))roots.push(task);else{const siblings=children.get(task.parentTaskId)||[];siblings.push(task);children.set(task.parentTaskId,siblings);}}for(const task of roots)taskTree.append(taskNode(task,children,0));}
 function attemptBudget(task){const attempt=Number(task?.attempt)||0;const max=Number(task?.maxAttempts)||0;if(max>=3&&max%3===0){const effectiveMax=Math.max(max,Math.ceil(attempt/3)*3);return attempt+' / 3×'+(effectiveMax/3);}return attempt+' / '+max;}
 const JOB_STATES=['DRAFT','ACTIVE','COMPLETED','CANCELLED'];
@@ -401,7 +401,7 @@ const TASK_STATES=['DRAFT','QUEUED','RUNNING','BLOCKED','UNBLOCKED','SUCCEEDED',
 async function setTaskState(task,state,select){const job=selected();if(!job||state===task.state)return;select.disabled=true;try{const params=new URLSearchParams({id:job.id,task:task.id,state,repo:job.repository,pr:String(job.prNumber)});const response=await fetch('/api/task-state?'+params.toString(),{method:'POST'});if(!response.ok)throw new Error(response.status+' '+response.statusText);const updated=await response.json();const index=jobs.findIndex(candidate=>jobSelectionKey(candidate)===jobSelectionKey(job));if(index>=0)jobs[index]=updated;else jobs.push(updated);renderAll();void loadEventHistory();}catch(error){select.title='Set task state: '+error.message;select.value=task.state;}finally{select.disabled=false;}}
 function taskStateField(task){const box=element('div','detail-group');box.append(element('p','detail-label',text('State')));const select=document.createElement('select');select.className='job-filter task-state-select';select.setAttribute('aria-label','Task state');for(const state of TASK_STATES){const option=new Option(state,state);if(state==='UNBLOCKED'&&task.state!=='UNBLOCKED')option.disabled=true;select.append(option);}select.value=task.state;select.addEventListener('change',()=>void setTaskState(task,select.value,select));box.append(select);return box;}
 function manualOverrideField(task){const rows=Array.isArray(task.manualStateOverrides)?task.manualStateOverrides:[];const last=rows.at(-1);return field('Manual override',last?last.from+' → '+last.to+' · '+relativeTime(last.at):'—');}
-function renderTaskDetail(task){taskDetailRoot.replaceChildren();if(!task){taskDetailRoot.append(element('p','empty',text('Select a task to inspect execution details.')));return;}const routing=task.routing||{};const groups=element('div','detail-groups');groups.append(field('Task',task.id),field('Kind',task.kind||'work'),taskStateField(task),manualOverrideField(task),field('Planning decision',task.planningDecisionId||'—'),field('Planning source',task.planningSource||'—'),field('Planning round',task.planningRound===undefined?'—':String(task.planningRound)),field('Project / agent',value(task.projectName)+' / '+value(task.agentName)),field('Parent task',task.parentTaskId||'root'),field('Adapter',task.adapter),field('Provider / model',value(routing.provider)+' / '+value(routing.model)),field('Reasoning / profile',value(routing.reasoning||routing.profile)),field('Attempt',attemptBudget(task)),field('Dependencies',Array.isArray(task.dependencies)&&task.dependencies.length?task.dependencies.join(', '):'none'),taskCommentField(task),chatField(task));const job=selected();if(task.reviewHeadSha&&job)groups.append(commitField('HEAD commit',job,task.reviewHeadSha));const graph=agentGraphField(task);if(graph)groups.append(graph);if(task.plannerResult)groups.append(field('Objective status',task.plannerResult.objective_status),markdownField('Assessment',task.plannerResult.assessment));if(task.error)groups.append(field('Error',task.error));taskDetailRoot.append(groups);}
+function renderTaskDetail(task){taskDetailRoot.replaceChildren();if(!task){taskDetailRoot.append(element('p','empty',text('Select a task to inspect execution details.')));return;}const routing=task.routing||{};const groups=element('div','detail-groups');groups.append(field('Title',task.title||'—'),field('Task ID',task.id),field('Kind',task.kind||'work'),taskStateField(task),manualOverrideField(task),field('Planning decision',task.planningDecisionId||'—'),field('Planning source',task.planningSource||'—'),field('Planning round',task.planningRound===undefined?'—':String(task.planningRound)),field('Project / agent',value(task.projectName)+' / '+value(task.agentName)),field('Parent task',task.parentTaskId||'root'),field('Adapter',task.adapter),field('Provider / model',value(routing.provider)+' / '+value(routing.model)),field('Reasoning / profile',value(routing.reasoning||routing.profile)),field('Attempt',attemptBudget(task)),field('Dependencies',Array.isArray(task.dependencies)&&task.dependencies.length?task.dependencies.join(', '):'none'),taskCommentField(task),chatField(task));const job=selected();if(task.reviewHeadSha&&job)groups.append(commitField('HEAD commit',job,task.reviewHeadSha));const graph=agentGraphField(task);if(graph)groups.append(graph);if(task.plannerResult)groups.append(field('Objective status',task.plannerResult.objective_status),markdownField('Assessment',task.plannerResult.assessment));if(task.error)groups.append(field('Error',task.error));taskDetailRoot.append(groups);}
 function reviewStatus(job){const review=job?.review;if(!review)return 'Not started';if(review.outcome==='approved'&&review.headSha===job.headSha)return 'MERGE READY · approved';const stale=Array.isArray(job?.tasks)&&job.tasks.some(task=>task.agentName==='reviewer'&&task.reviewHeadSha&&job.headSha&&task.reviewHeadSha!==job.headSha);if(stale)return 'STALE · awaiting review';return String(review.outcome||'pending').replace('_',' ').toUpperCase();}
 function renderSelectedJob(){jobDetail.replaceChildren();const job=selected();if(!job){selectedJobTitle.textContent='';jobDetail.append(element('div','empty',text('No durable jobs discovered.')));buildTree([]);renderTaskDetail(null);return;}selectedJobTitle.textContent=value(job.title||job.id);if(jobSelectionKey(job)!==selectedJob){selectedJob=jobSelectionKey(job);selectedTaskId=null;eventTaskId=null;clearEvents();rememberSelection();}const summary=element('div','job-summary');summary.append(field('PR state',job.githubState||'UNKNOWN'),jobStateField(job),field('Runtime status',job.runtimeStatus||'IDLE'),field('Execution mode',job.executionMode||'fixed'),field('Cadence',cadence(job)),field('Review',reviewStatus(job)),field('Creator thread',job.creatorThreadId||'—'),field('Implementation thread',job.implementationThreadId||'—'),field('Reviewer thread',job.reviewerThreadId||'—'),commitField('Review head SHA',job,job.review?.headSha||job.headSha||''),prField(job),field('Repository',job.repository||'—'),field('Last activity',relativeTime(job.updatedAt)),field('Task states',compactCounts(job.tasks)),chatShortcutField(job));jobDetail.append(summary);const selectedTask=(job.tasks||[]).find(task=>task.id===selectedTaskId)||null;if(selectedTaskId&&!selectedTask){selectedTaskId=null;eventTaskId=null;clearEvents();rememberSelection();}buildTree(job.tasks||[]);renderTaskDetail(selectedTask);renderEventScope();}
 function renderAll(){jobs.sort(compareJobs);syncFilters();renderJobList();renderSelectedJob();syncMobileJobsView();}

package/dist/dashboard.js

@@ -308,14 +308,10 @@ export function serveDashboard(store, port = 8787, bus, refreshMs = 300000, jobI
                     result = await resolvedActions.taskCreate(requestedJobId, body.task, body.idempotencyKey);
                 else if (body.action === 'update' && isTaskId(requestedTaskId) && body.task && body.expectedUpdatedAt && resolvedActions?.taskUpdate)
                     result = await resolvedActions.taskUpdate(requestedJobId, requestedTaskId, body.task, body.expectedUpdatedAt);
-                else if (body.action === 'start' && isTaskId(requestedTaskId) && resolvedActions?.taskStart)
-                    result = await resolvedActions.taskStart(requestedJobId, requestedTaskId);
                 else if (body.action === 'retry' && isTaskId(requestedTaskId) && resolvedActions?.taskRetry)
                     result = await resolvedActions.taskRetry(requestedJobId, requestedTaskId);
                 else if (body.action === 'cancel' && isTaskId(requestedTaskId) && resolvedActions?.taskCancel)
                     result = await resolvedActions.taskCancel(requestedJobId, requestedTaskId);
-                else if (body.action === 'complete' && isTaskId(requestedTaskId) && typeof body.summary === 'string' && body.summary.trim() && resolvedActions?.taskComplete)
-                    result = await resolvedActions.taskComplete(requestedJobId, requestedTaskId, body.summary);
                 else
                     throw new Error('Task command unavailable');
                 if (!res.headersSent)

package/dist/github-binding-order.js

@@ -3,7 +3,7 @@ export function orderGitHubBindingCandidates(items) {
     return [...items].sort((a, b) => score(a.job) - score(b.job) || a.job.createdAt.localeCompare(b.job.createdAt));
 }
 function score(job) {
-    const bound = (job.externalPrNumber ?? (job.prNumber > 0 ? job.prNumber : 0)) > 0;
+    const bound = (job.prNumber) > 0;
     const terminal = ['COMPLETED', 'CANCELLED'].includes(job.state);
     if (!terminal && !bound)
         return 0;

package/dist/job-pr-number-migration.js

@@ -0,0 +1,24 @@
+import { deriveTaskTitle } from './task-title.js';
+export function normalizeLegacyJobPrNumber(input) {
+    const record = input;
+    const legacyKey = 'external' + 'PrNumber';
+    const legacy = record[legacyKey];
+    if ((!Number.isInteger(input.prNumber) || input.prNumber <= 0) && Number.isInteger(legacy) && Number(legacy) > 0)
+        input.prNumber = Number(legacy);
+    delete record[legacyKey];
+    for (const task of input.tasks ?? []) {
+        if (!task.title?.trim())
+            task.title = deriveTaskTitle(task.input, task.agentName ? `${task.agentName} task` : 'Task');
+    }
+    return input;
+}
+export function migrateLegacyJobPrNumbers(db) {
+    const rows = db.prepare('SELECT job_id,json FROM job_snapshot').all();
+    const update = db.prepare('UPDATE job_snapshot SET json=? WHERE job_id=?');
+    for (const row of rows) {
+        const normalized = normalizeLegacyJobPrNumber(JSON.parse(row.json));
+        const json = JSON.stringify(normalized);
+        if (json !== row.json)
+            update.run(json, row.job_id);
+    }
+}

package/dist/job-task-id-sequence.js

@@ -8,12 +8,20 @@ export function generatedEntityPrefix(repository, kind) {
     return `${kind === 'job' ? 'j' : 't'}-${owner.length}-${owner}-${repo}-`;
 }
 export function isGeneratedEntityId(id, repository, kind) {
+    if (kind === 'task') {
+        if (/^[1-9][0-9]*$/.test(id))
+            return true;
+        const legacyPrefix = generatedEntityPrefix(repository, kind);
+        return id.startsWith(legacyPrefix) && /^[0-9]+$/.test(id.slice(legacyPrefix.length));
+    }
     const prefix = generatedEntityPrefix(repository, kind);
     return id.startsWith(prefix) && /^[0-9]+$/.test(id.slice(prefix.length));
 }
-/** Repository-scoped, monotonically increasing IDs. Allocation is serialized by SQLite. */
+/** Jobs remain repository-scoped. Task IDs are one Relay-global monotonically increasing integer sequence. Allocation is serialized by SQLite. */
 export function allocateEntityId(directory, repository, kind, requestKey, occupied = new Set()) {
-    const prefix = generatedEntityPrefix(repository, kind);
+    const prefix = kind === 'job' ? generatedEntityPrefix(repository, kind) : '';
+    const scope = kind === 'task' ? '*' : repository;
+    const scopedRequestKey = requestKey && kind === 'task' ? `${repository}:${requestKey}` : requestKey;
     if (requestKey !== undefined && (!requestKey || requestKey.length > 512))
         throw new Error('Invalid idempotency key');
     mkdirSync(directory, { recursive: true });
@@ -23,22 +31,21 @@ export function allocateEntityId(directory, repository, kind, requestKey, occupi
         db.exec('CREATE TABLE IF NOT EXISTS sequences (repository TEXT NOT NULL, kind TEXT NOT NULL, value INTEGER NOT NULL, PRIMARY KEY(repository,kind)); CREATE TABLE IF NOT EXISTS idempotency (repository TEXT NOT NULL, kind TEXT NOT NULL, request_key TEXT NOT NULL, entity_id TEXT NOT NULL, PRIMARY KEY(repository,kind,request_key));');
         db.exec('BEGIN IMMEDIATE');
         try {
-            if (requestKey) {
-                const row = db.prepare('SELECT entity_id FROM idempotency WHERE repository=? AND kind=? AND request_key=?').get(repository, kind, requestKey);
+            if (scopedRequestKey) {
+                const row = db.prepare('SELECT entity_id FROM idempotency WHERE repository=? AND kind=? AND request_key=?').get(scope, kind, scopedRequestKey);
                 if (row) {
                     db.exec('COMMIT');
                     return row.entity_id;
                 }
             }
-            const old = db.prepare('SELECT value FROM sequences WHERE repository=? AND kind=?').get(repository, kind);
+            const old = db.prepare('SELECT value FROM sequences WHERE repository=? AND kind=?').get(scope, kind);
             let next = (old?.value ?? 0) + 1;
             while (occupied.has(prefix + next))
                 next++;
-            db.prepare('INSERT INTO sequences VALUES (?,?,?) ON CONFLICT(repository,kind) DO UPDATE SET value=excluded.value').run(repository, kind, next);
-            // Length prefix keeps repository names unambiguous while satisfying dashboard ID validation.
+            db.prepare('INSERT INTO sequences VALUES (?,?,?) ON CONFLICT(repository,kind) DO UPDATE SET value=excluded.value').run(scope, kind, next);
             const id = prefix + next;
-            if (requestKey)
-                db.prepare('INSERT INTO idempotency VALUES (?,?,?,?)').run(repository, kind, requestKey, id);
+            if (scopedRequestKey)
+                db.prepare('INSERT INTO idempotency VALUES (?,?,?,?)').run(scope, kind, scopedRequestKey, id);
             db.exec('COMMIT');
             return id;
         }

package/dist/legacy-orchestrator-repair.js

@@ -0,0 +1,51 @@
+import { eventFor } from './events.js';
+import { orchestratorRescueFacts, prepareOrchestratorRepair } from './workflow/orchestrator-rescue.js';
+import { reclaimStaleExecutionProcess } from './execution-process-tracker.js';
+/** Durable, race-safe repair effect selected by workflow/orchestrator-rescue.mmd. */
+export async function repairLegacyOrchestrators(jobId, now, ports) {
+    const { store } = ports;
+    const repairOne = async (taskId) => {
+        if (store.mutateJob) {
+            let outcome = { repaired: false, externallyCompleted: false, blocked: false, ageMs: 0 };
+            return await store.mutateJob(jobId, current => {
+                const task = current.tasks.find(item => item.id === taskId);
+                if (!task)
+                    return current;
+                const repair = prepareOrchestratorRepair(task, now);
+                if (repair.repaired)
+                    outcome = repair;
+                return current;
+            }).then(() => outcome);
+        }
+        const job = await store.load(jobId);
+        const task = job.tasks.find(item => item.id === taskId);
+        if (!task)
+            return null;
+        const repair = prepareOrchestratorRepair(task, now);
+        if (repair.repaired)
+            await store.saveTask(task);
+        return repair;
+    };
+    for (const stale of (await store.load(jobId)).tasks) {
+        const facts = orchestratorRescueFacts(stale, now);
+        if (facts.legacyActive !== true)
+            continue;
+        if (facts.verifiedExternalCompletion !== true && facts.unknownStartedOutcome !== true && facts.rescuable !== true)
+            continue;
+        if (stale.executionId && !await reclaimStaleExecutionProcess(store, stale, ports.owner))
+            continue;
+        const repair = await repairOne(stale.id);
+        if (!repair?.repaired)
+            continue;
+        const job = await store.load(jobId);
+        const task = job.tasks.find(item => item.id === stale.id);
+        const type = repair.externallyCompleted ? 'task.external_completion_applied'
+            : repair.blocked ? 'task.orchestrator_quarantined' : 'task.orchestrator_rescued';
+        const status = repair.externallyCompleted ? 'succeeded' : repair.blocked ? 'blocked' : 'queued';
+        await ports.emit(eventFor(job.id, task.id, task.parentTaskId, type, status, repair.externallyCompleted
+            ? `Applied durable external completion for legacy orchestrator task ${task.id}`
+            : repair.blocked
+                ? `Quarantined legacy RUNNING orchestrator task ${task.id}; external outcome must be verified before replacement work`
+                : `Recovered legacy orchestrator task ${task.id} through Execution Router`, 'orchestrator', { ageMs: repair.ageMs, adapter: repair.externallyCompleted || repair.blocked ? undefined : 'execution-router' }, { agent: 'relay', component: 'agents-relay' }));
+    }
+}

package/dist/local-job-registry.js

@@ -19,10 +19,9 @@ export function createJobIdRegistryResolver(directory, openStores, options = {})
         }
         // SQLite remains lifecycle authority. A positive PR binding only enables
         // the external collaboration adapter for projection/merge side effects.
-        const externalPrNumber = job.externalPrNumber ?? (job.prNumber > 0 ? job.prNumber : 0);
-        const githubEnabled = !options.noGitHub && externalPrNumber > 0 && options.client;
+        const githubEnabled = !options.noGitHub && job.prNumber > 0 && options.client;
         const github = githubEnabled
-            ? new GitHubStore(options.client, job.repository, externalPrNumber, options.trustedAuthors ?? new Set())
+            ? new GitHubStore(options.client, job.repository, job.prNumber, options.trustedAuthors ?? new Set())
             : new InMemoryStore();
         return { job, relay, store: new LocalAuthorityDurableStore(relay, github, undefined, !githubEnabled) };
     };

package/dist/local-merge-delivery.js

@@ -28,7 +28,7 @@ export async function reconcileLocalGitCompletion(store, finalState, headSha, no
                         throw new Error('Local Git merge requires an explicit project path');
                     const repoPath = await projectPathForJob(finalState);
                     const delivered = deliverLocalMerge(repoPath, { ...activeReceipt, sourceSha: activeReceipt.sourceSha ?? headSha ?? undefined,
-                        correlationJobId: finalState.id, displayPrNumber: finalState.externalPrNumber ?? (finalState.prNumber > 0 ? finalState.prNumber : undefined) });
+                        correlationJobId: finalState.id, displayPrNumber: finalState.prNumber > 0 ? finalState.prNumber : undefined });
                     finalState.localMerge = { ...activeReceipt, ...delivered, status: 'succeeded', projectionStrategy: 'target_ref_push',
                         error: undefined, nextAttemptAt: undefined, updatedAt: new Date().toISOString() };
                 }