agents-relay 2.0.90 → 2.0.92

package/dist/cli-help.js

@@ -129,6 +129,12 @@ Use --clear-routing to remove routing metadata.
 
 Example:
   npx agents-relay task update --repo OWNER/REPO --pr 12 --id job-1 --task-id build --adapter chatgpt --provider chatgpt --model gpt-5.6-sol --reasoning high`,
+    'task comment': `Append an immutable Task comment. Does not retry or change Task state.
+
+Required: --repo OWNER/REPO --id JOB_ID --task-id TASK_ID and --message TEXT or --message-file FILE.`,
+    'task comments': `List append-only Task comments.
+
+Required: --repo OWNER/REPO --id JOB_ID --task-id TASK_ID.`,
     'task context': `Read the authoritative execution-scoped Task contract.
 
 Required: --repo OWNER/REPO --id JOB_ID --task-id TASK_ID --execution-id EXECUTION_ID. Fails closed on stale execution.`,

package/dist/cli.js

@@ -68,7 +68,7 @@ async function runManagedTaskCommand(action, args) {
     console.log(JSON.stringify(task, null, 2));
 }
 async function runTaskCommand(action, args) {
-    if (!['create', 'update', 'show', 'context', 'list', 'retry', 'recover', 'unblock', 'cancel', 'supersede'].includes(action))
+    if (!['create', 'update', 'show', 'context', 'comment', 'comments', '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) {
@@ -79,6 +79,23 @@ async function runTaskCommand(action, args) {
             return;
         }
         const taskId = arg(args, '--task-id');
+        if (action === 'comment') {
+            if (!taskId)
+                throw new Error('task comment requires --task-id');
+            const message = await textOption(args, '--message', '--message-file');
+            console.log(JSON.stringify(await relayControlCommand(args, { command: 'task.comment', jobId, taskId, message }), null, 2));
+            return;
+        }
+        if (action === 'comments') {
+            if (!taskId)
+                throw new Error('task comments requires --task-id');
+            const job = await relayControlJob(args, jobId);
+            const task = job.tasks.find(item => item.id === taskId);
+            if (!task)
+                throw new Error(`Task ${taskId} not found`);
+            console.log(JSON.stringify(task.comments ?? [], null, 2));
+            return;
+        }
         if (action === 'context') {
             if (!taskId)
                 throw new Error('task context requires --task-id');

package/dist/local-authority-store.js

@@ -260,7 +260,7 @@ export class LocalAuthorityDurableStore {
             if (current.attempt === task.attempt && current.updatedAt === task.updatedAt
                 && TASK_STATE_ORDER[current.state] >= TASK_STATE_ORDER[task.state])
                 return job;
-            job.tasks[index] = structuredClone(task);
+            job.tasks[index] = { ...structuredClone(task), comments: current.comments ?? task.comments };
             return job;
         });
     }

package/dist/reconciler.js

@@ -1,3 +1,4 @@
+import { taskCommentContext } from './task-comments.js';
 import { cancelActiveTasks } from './reconciler-cancellation.js';
 import { authorizedInjection } from './e2e-injection.js';
 import { implementationComplete } from './runtime-status.js';
@@ -450,7 +451,7 @@ export class Reconciler extends ReconcilerReviewBase {
         const workerInput = canonicalProjectRun
             ? `${baseWorkerInput}\n\n[Canonical Neo project run]\nExecution cwd: ${executionContext.project.path}\nKeep generated artifacts under runs/.`
             : baseWorkerInput;
-        const workerTask = { ...task, input: workerInput, routing: task.routing ? { ...task.routing, cwd: executionContext.project.path } : task.routing };
+        const workerTask = { ...task, input: workerInput + taskCommentContext(task), routing: task.routing ? { ...task.routing, cwd: executionContext.project.path } : task.routing };
         const startAckSetup = task.adapter === 'chatgpt' ? await this.startAck(job.id, task.id, sourceId, Date.now(), this.options.startAckTimeoutMs ?? chatGptStartAckTimeoutMs(task.timeoutMs)) : null;
         const closePolicy = task.chatgptTabClosePolicy ?? this.options.chatgptTabClosePolicy ?? adapter.tabClosePolicy ?? 'after-start';
         const terminalWait = task.adapter === 'chatgpt' && closePolicy === 'after-terminal' ? this.terminalWait(task.id, durableExecutionId, startedAt - 1) : null;

package/dist/relay-store.js

@@ -1,3 +1,4 @@
+import { preserveTaskComments } from './task-comments.js';
 import { DatabaseSync } from 'node:sqlite';
 import { dirname } from 'node:path';
 import { mkdirSync } from 'node:fs';
@@ -23,7 +24,7 @@ function mergeRecords(local, remote) {
 }
 export function mergeInboundJobSnapshot(local, remote) {
     const base = remote.updatedAt > local.updatedAt ? structuredClone(remote) : structuredClone(local);
-    base.tasks = mergeRecords(local.tasks, remote.tasks);
+    base.tasks = preserveTaskComments(local.tasks, mergeRecords(local.tasks, remote.tasks));
     const localPlans = local.plans ?? [];
     const remotePlans = remote.plans ?? [];
     if (localPlans.length > 0 || remotePlans.length > 0) {

package/dist/relayd-control.js

@@ -1,3 +1,4 @@
+import { appendTaskComment } from './task-comments.js';
 import { normalizeThreadId } from './reviewer-thread.js';
 import { supersedeCancelledTask } from './task-actions.js';
 export function createWorkspaceControl(deps) {
@@ -107,6 +108,15 @@ export function createWorkspaceControl(deps) {
             await pool.reconcileLocalJob(jobId, 'control.job.unblock');
             return await store.load(jobId);
         }
+        if (command === 'task.comment') {
+            const taskId = typeof body.taskId === 'string' ? body.taskId : '';
+            const message = typeof body.message === 'string' ? body.message : '';
+            if (!taskId || !message.trim())
+                throw new Error('task comment requires taskId and message');
+            let appended;
+            await store.mutateJob(jobId, (current) => { appended = appendTaskComment(current, taskId, message); return current; });
+            return appended;
+        }
         if (command === 'task.supersede') {
             const taskId = typeof body.taskId === 'string' ? body.taskId : '';
             const reason = typeof body.reason === 'string' ? body.reason : '';

package/dist/task-comments.js

@@ -0,0 +1,31 @@
+import { randomUUID } from 'node:crypto';
+export function appendTaskComment(job, taskId, message, author = 'cli') {
+    const task = job.tasks.find(item => item.id === taskId);
+    if (!task)
+        throw new Error(`Task ${taskId} not found`);
+    if (!message.trim())
+        throw new Error('task comment requires nonempty --message');
+    const comment = { id: randomUUID(), text: message.trim(), author, createdAt: new Date().toISOString() };
+    task.comments = [...(task.comments ?? []), comment];
+    return comment;
+}
+export function taskCommentContext(task) {
+    if (!task.comments?.length)
+        return '';
+    return '\n\n[Task comments — append-only supplementary context]\n' + task.comments.map(c => `${c.createdAt} (${c.author}, ${c.id}): ${c.text}`).join('\n');
+}
+/** Preserve append-only comments across stale external or lifecycle snapshots. */
+export function preserveTaskComments(previous, incoming) {
+    return incoming.map(task => {
+        const old = previous.find(item => item.id === task.id);
+        if (!old?.comments?.length)
+            return task;
+        const comments = [...old.comments], known = new Set(comments.map(comment => comment.id));
+        for (const comment of task.comments ?? [])
+            if (!known.has(comment.id)) {
+                comments.push(comment);
+                known.add(comment.id);
+            }
+        return { ...task, comments };
+    });
+}

package/dist/task-context.js

@@ -8,7 +8,7 @@ export function taskExecutionContext(job, taskId, executionId) {
     if (task.executionId !== executionId || !['QUEUED', 'RUNNING'].includes(task.state))
         throw new Error(`Stale Task execution ${taskId}/${executionId}; current state ${task.state}`);
     return { job: { id: job.id, repository: job.repository, title: job.title, objective: job.objective,
-            projectPath: job.projectPath, state: job.state }, task, dependencies: task.dependencies.map(id => job.tasks.find(item => item.id === id) ?? { id, missing: true }),
+            projectPath: job.projectPath, state: job.state }, task, comments: task.comments ?? [], dependencies: task.dependencies.map(id => job.tasks.find(item => item.id === id) ?? { id, missing: true }),
         plan: job.plans?.find(plan => plan.id === task.planningDecisionId) ?? null };
 }
 export function taskReferencePrompt(repository, jobId, taskId, executionId) {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "agents-relay",
-  "version": "2.0.90",
+  "version": "2.0.92",
   "description": "Durable async agent jobs coordinated through GitHub pull requests",
   "type": "module",
   "bin": {