agent-relay-server 0.115.0 → 0.116.0

package/src/branch-landed.ts

@@ -2,7 +2,7 @@ import { errMessage, type BaseWorktreeSyncResult } from "agent-relay-sdk";
 import { emitRelayEvent } from "./events";
 import { routeNotification, INFORMATIONAL_TTL_MS } from "./notification-router";
 import { registerDefaultAudienceRules, audiencePredicates } from "./notification-rules";
-import { createActivityEvent, getAgent, updateWorkspaceStatus } from "./db";
+import { createActivityEvent, deliverableTaskIdsByBranch, deliverableTaskIdsByOwnerAgent, getAgent, getTaskDetail, updateWorkspaceStatus } from "./db";
 import { renderTemplate } from "./prompt-resolver";
 import { resolveCoordinatorAgentId } from "./steward-identity";
 import { stewardFallbackTarget } from "./config";
@@ -85,6 +85,15 @@ function landedCommitSubjects(input: BranchLandedInput, log: BranchLandedLogFn):
   }
 }
 
+function resolveLandedTask(workspace: Pick<WorkspaceRecord, "branch" | "ownerAgentId">): { taskId: number; taskLabel: string } | undefined {
+  const branchTaskId = workspace.branch ? deliverableTaskIdsByBranch(workspace.branch)[0] : undefined;
+  const ownerTaskIds = !branchTaskId && workspace.ownerAgentId ? deliverableTaskIdsByOwnerAgent(workspace.ownerAgentId) : [];
+  const taskId = branchTaskId ?? (ownerTaskIds.length === 1 ? ownerTaskIds[0] : undefined);
+  if (!taskId) return undefined;
+  const task = getTaskDetail(taskId);
+  return task ? { taskId: task.id, taskLabel: task.title } : undefined;
+}
+
 /**
  * #239 — turn an authoritative land completion into a relay-driven push so the author
  * stops polling to learn it merged. Always emits the durable `branch.landed` event (the
@@ -100,6 +109,7 @@ export function notifyBranchLanded(input: BranchLandedInput): void {
   const shortSha = input.mergedSha ? input.mergedSha.slice(0, 12) : undefined;
   const lifecycleLog = (message: string) => console.warn(message);
   const commitSubjects = landedCommitSubjects(input, lifecycleLog);
+  const landedTask = resolveLandedTask(workspace);
 
   emitRelayEvent({
     type: "branch.landed",
@@ -115,6 +125,7 @@ export function notifyBranchLanded(input: BranchLandedInput): void {
       author: workspace.ownerAgentId,
       newBranch: input.newBranch,
       pushed: input.pushed,
+      ...landedTask,
     },
   });
   emitRelayEvent({
@@ -132,6 +143,7 @@ export function notifyBranchLanded(input: BranchLandedInput): void {
       newBranch: input.newBranch,
       pushed: input.pushed,
       notification: "landed-success",
+      ...landedTask,
     },
   });
   // #482/#833 issue close FIRST, then the #831 Task drive: the Task's close PROJECTION
@@ -164,6 +176,7 @@ export function notifyBranchLanded(input: BranchLandedInput): void {
     author,
     newBranch: input.newBranch,
     pushed: input.pushed,
+    ...landedTask,
   };
 
   // A local-only land (push disabled, or base has no upstream) has NOT reached the

package/src/db/mappers.ts

@@ -277,6 +277,7 @@ export function rowToTask(row: any): Task {
   return {
     id: row.id,
     source: row.source,
+    label: row.title,
     title: row.title,
     body: row.body,
     severity: row.severity as TaskSeverity,
@@ -310,6 +311,8 @@ export function rowToTask(row: any): Task {
     ...(row.commits != null ? { commits: parseJson(row.commits, []) } : {}),
     ...(row.done_when != null ? { doneWhen: row.done_when } : {}),
     ...(row.team_id != null ? { teamId: row.team_id } : {}),
+    ...(row.project_id != null ? { projectId: row.project_id } : {}),
+    ...(row.repo != null ? { repo: row.repo } : {}),
     ...(row.created_by != null ? { createdBy: row.created_by } : {}),
     ...(row.owner_agent_id != null ? { ownerAgentId: row.owner_agent_id } : {}),
     ...(row.dispatch != null ? { dispatch: parseJson(row.dispatch, {}) } : {}),

package/src/db/migrations.ts

@@ -1049,6 +1049,8 @@ export function applyMigrations(): void {
   addTaskCol("commits", "commits TEXT");
   addTaskCol("done_when", "done_when TEXT");
   addTaskCol("team_id", "team_id TEXT");
+  addTaskCol("project_id", "project_id TEXT");
+  addTaskCol("repo", "repo TEXT");
   addTaskCol("created_by", "created_by TEXT");
   addTaskCol("owner_agent_id", "owner_agent_id TEXT");
   addTaskCol("dispatch", "dispatch TEXT");
@@ -1056,6 +1058,43 @@ export function applyMigrations(): void {
   getDb().run("CREATE INDEX IF NOT EXISTS idx_tasks_kind ON tasks(kind, status, updated_at)");
   getDb().run("CREATE INDEX IF NOT EXISTS idx_tasks_branch ON tasks(branch) WHERE branch IS NOT NULL");
   getDb().run("CREATE INDEX IF NOT EXISTS idx_tasks_team ON tasks(team_id) WHERE team_id IS NOT NULL");
+  getDb().run("CREATE INDEX IF NOT EXISTS idx_tasks_project ON tasks(project_id, status, updated_at) WHERE project_id IS NOT NULL");
+  getDb().run("CREATE INDEX IF NOT EXISTS idx_tasks_repo ON tasks(repo, status, updated_at) WHERE repo IS NOT NULL");
+  getDb().run(`
+    UPDATE tasks
+    SET repo = (
+      SELECT ir.repo
+      FROM issue_associations ia
+      JOIN issue_refs ir ON ir.id = ia.issue_ref_id
+      WHERE ia.entity_type = 'task' AND ia.entity_id = CAST(tasks.id AS TEXT)
+      ORDER BY ia.created_at ASC, ir.id ASC
+      LIMIT 1
+    )
+    WHERE kind = 'deliverable'
+      AND (repo IS NULL OR trim(repo) = '')
+      AND EXISTS (
+        SELECT 1 FROM issue_associations ia
+        JOIN issue_refs ir ON ir.id = ia.issue_ref_id
+        WHERE ia.entity_type = 'task' AND ia.entity_id = CAST(tasks.id AS TEXT)
+      )
+  `);
+  getDb().run(`
+    UPDATE tasks
+    SET project_id = (
+      SELECT p.id
+      FROM projects p
+      WHERE p.scope = 'project' AND p.issue_repo = tasks.repo
+      ORDER BY p.created_at ASC, p.id ASC
+      LIMIT 1
+    )
+    WHERE kind = 'deliverable'
+      AND (project_id IS NULL OR trim(project_id) = '')
+      AND repo IS NOT NULL AND trim(repo) <> ''
+      AND EXISTS (
+        SELECT 1 FROM projects p
+        WHERE p.scope = 'project' AND p.issue_repo = tasks.repo
+      )
+  `);
 
   getDb().run(`
     CREATE TABLE IF NOT EXISTS task_dependencies (

package/src/db/schema.ts

@@ -657,6 +657,8 @@ export function initDb(path: string = "agent-relay.db"): Database {
       commits TEXT,
       done_when TEXT,
       team_id TEXT,
+      project_id TEXT,
+      repo TEXT,
       created_by TEXT,
       owner_agent_id TEXT,
       dispatch TEXT,

package/src/db/task-entity.ts

@@ -28,6 +28,7 @@ import {
   type TaskGateState,
   type TaskGateStatus,
   type TaskIssueLink,
+  type TaskListItem,
   type TaskStatus,
 } from "../types";
 import { parseJson } from "../utils";
@@ -38,6 +39,7 @@ import { latestTaskDispatchDecision, taskBoundWorkerModel, taskDispatchWorkShape
 import { TASK_SELECT, insertTaskEvent, DELIVERABLE_TASK_KIND } from "./task-core.ts";
 import { associateIssue, listIssuesForEntity, removeAssociation } from "./issue-associations.ts";
 import { resolveIssueRefFromString } from "./issue-refs.ts";
+import { getProject } from "./projects.ts";
 
 // Execution-status axis (#834): the existing claim FSM vocabulary, reused so there is no
 // enum break. not-started=open, working=in_progress, plus claimed/blocked/done/failed/canceled.
@@ -100,6 +102,38 @@ function cleanDispatch(value: unknown): TaskDispatch | undefined {
   return out;
 }
 
+function projectForRepo(repo: string | undefined): string | undefined {
+  const cleaned = repo?.trim();
+  if (!cleaned) return undefined;
+  const row = getDb()
+    .query("SELECT id FROM projects WHERE scope = 'project' AND issue_repo = ? ORDER BY created_at ASC, id ASC LIMIT 1")
+    .get(cleaned) as { id: string } | undefined;
+  return row?.id;
+}
+
+function cleanTaskProject(input: { projectId?: unknown; repo?: unknown }): { projectId?: string; repo?: string } {
+  const projectId = optionalText(input.projectId, "projectId", 120);
+  const project = projectId ? getProject(projectId) : null;
+  const repo = optionalText(input.repo, "repo", 500) ?? project?.issueRepo;
+  return {
+    ...(projectId ? { projectId } : repo ? { projectId: projectForRepo(repo) } : {}),
+    ...(repo ? { repo } : {}),
+  };
+}
+
+function fillTaskProjectFromRepo(id: number, repo: string, now = Date.now()): void {
+  const cleaned = optionalText(repo, "repo", 500);
+  if (!cleaned) return;
+  const projectId = projectForRepo(cleaned);
+  getDb().query(`
+    UPDATE tasks
+    SET repo = COALESCE(NULLIF(trim(repo), ''), ?),
+        project_id = COALESCE(NULLIF(trim(project_id), ''), ?),
+        updated_at = ?
+    WHERE id = ?
+  `).run(cleaned, projectId ?? null, now, id);
+}
+
 function getRawTask(id: number): Task | null {
   const row = getDb().query(`${TASK_SELECT} WHERE id = ?`).get(id) as any;
   return row ? rowToTask(row) : null;
@@ -119,6 +153,8 @@ export interface CreateDeliverableTaskInput {
   context?: string;
   doneWhen?: string;
   teamId?: string;
+  projectId?: string;
+  repo?: string;
   createdBy: string;
   source?: string;
   target?: string;
@@ -134,13 +170,14 @@ export function createDeliverableTask(input: CreateDeliverableTaskInput): TaskDe
   const dispatch = cleanDispatch(input.dispatch);
   const complexity = cleanTaskComplexity(input.complexity ?? dispatch?.complexity, "complexity") ?? DEFAULT_TASK_COMPLEXITY;
   const context = optionalText(input.context, "context", 1_000_000);
+  const taskProject = cleanTaskProject(input);
   // Legacy NOT-NULL columns have no DB defaults (#834 finding 6) — set them explicitly.
   const result = getDb().query(`
     INSERT INTO tasks (
       source, title, body, severity, status, target, occurrence_count, metadata,
       created_at, updated_at, last_seen_at,
-      kind, intent, complexity, context, latest_steer, deliverable_stage, done_when, team_id, created_by, dispatch
-    ) VALUES (?, ?, ?, 'info', 'open', ?, 1, '{}', ?, ?, ?, '${DELIVERABLE_TASK_KIND}', ?, ?, ?, ?, 'none', ?, ?, ?, ?)
+      kind, intent, complexity, context, latest_steer, deliverable_stage, done_when, team_id, project_id, repo, created_by, dispatch
+    ) VALUES (?, ?, ?, 'info', 'open', ?, 1, '{}', ?, ?, ?, '${DELIVERABLE_TASK_KIND}', ?, ?, ?, ?, 'none', ?, ?, ?, ?, ?, ?)
   `).run(
     optionalText(input.source, "source", 200) ?? "coordinator",
     title,
@@ -153,6 +190,8 @@ export function createDeliverableTask(input: CreateDeliverableTaskInput): TaskDe
     optionalText(input.latestSteer, "latestSteer", 1_000_000) ?? null,
     optionalText(input.doneWhen, "doneWhen", 1_000_000) ?? null,
     optionalText(input.teamId, "teamId", 200) ?? null,
+    taskProject.projectId ?? null,
+    taskProject.repo ?? null,
     createdBy,
     dispatch ? JSON.stringify(dispatch) : null,
   );
@@ -163,7 +202,7 @@ export function createDeliverableTask(input: CreateDeliverableTaskInput): TaskDe
     severity: "info",
     title: `Task created: ${title}`,
     body: intent,
-    metadata: { createdBy, complexity, ...(context ? { context } : {}), ...(dispatch ? { dispatch } : {}) },
+    metadata: { createdBy, complexity, ...(context ? { context } : {}), ...(taskProject.projectId ? { projectId: taskProject.projectId } : {}), ...(taskProject.repo ? { repo: taskProject.repo } : {}), ...(dispatch ? { dispatch } : {}) },
   }, now);
   return getTaskDetail(id)!;
 }
@@ -177,6 +216,8 @@ export interface UpdateDeliverableTaskInput {
   doneWhen?: string;
   dispatch?: TaskDispatch;
   teamId?: string;
+  projectId?: string;
+  repo?: string;
   actor?: string;
 }
 
@@ -192,6 +233,11 @@ export function updateDeliverableTask(id: number, input: UpdateDeliverableTaskIn
   if (input.latestSteer !== undefined) push("latest_steer", optionalText(input.latestSteer, "latestSteer", 1_000_000) ?? null);
   if (input.doneWhen !== undefined) push("done_when", optionalText(input.doneWhen, "doneWhen", 1_000_000) ?? null);
   if (input.teamId !== undefined) push("team_id", optionalText(input.teamId, "teamId", 200) ?? null);
+  if (input.projectId !== undefined || input.repo !== undefined) {
+    const taskProject = cleanTaskProject(input);
+    if (input.projectId !== undefined) push("project_id", taskProject.projectId ?? null);
+    if (input.repo !== undefined) push("repo", taskProject.repo ?? null);
+  }
   if (input.dispatch !== undefined) { const d = cleanDispatch(input.dispatch); push("dispatch", d ? JSON.stringify(d) : null); }
   const now = Date.now();
   if (sets.length > 0) {
@@ -424,6 +470,7 @@ export function addTaskRef(id: number, input: AddTaskRefInput): TaskDetail {
   if (input.issue) {
     const ref = resolveIssueRefFromString({ ref: input.issue, defaultRepo: optionalText(input.defaultRepo, "defaultRepo", 500) });
     associateIssue(ref.id, "task", taskEntityId(String(id)));
+    fillTaskProjectFromRepo(id, ref.repo, now);
     insertTaskEvent(id, {
       source: input.actor ?? "agent-relay",
       type: "ref.issue.added",
@@ -619,6 +666,8 @@ export interface ListDeliverableTasksFilter {
   teamId?: string;
   createdBy?: string;
   ownerAgentId?: string;
+  projectId?: string;
+  repo?: string;
   limit?: number;
 }
 
@@ -630,11 +679,37 @@ export function listDeliverableTasks(filter: ListDeliverableTasksFilter = {}): T
   if (filter.teamId) { conditions.push("team_id = ?"); params.push(filter.teamId); }
   if (filter.createdBy) { conditions.push("created_by = ?"); params.push(filter.createdBy); }
   if (filter.ownerAgentId) { conditions.push("owner_agent_id = ?"); params.push(filter.ownerAgentId); }
+  if (filter.projectId) { conditions.push("project_id = ?"); params.push(filter.projectId); }
+  if (filter.repo) { conditions.push("repo = ?"); params.push(filter.repo); }
   const limit = Math.min(Math.max(filter.limit ?? 100, 1), 500);
   params.push(limit);
   return (getDb().query(`${TASK_SELECT} WHERE ${conditions.join(" AND ")} ORDER BY updated_at DESC LIMIT ?`).all(...params as any[]) as any[]).map(rowToTask);
 }
 
+function taskListItem(task: Task): TaskListItem {
+  return {
+    id: task.id,
+    label: task.title,
+    title: task.title,
+    status: task.status,
+    kind: task.kind,
+    ...(task.deliverableStage ? { deliverableStage: task.deliverableStage } : {}),
+    ...(task.teamId ? { teamId: task.teamId } : {}),
+    ...(task.projectId ? { projectId: task.projectId } : {}),
+    ...(task.repo ? { repo: task.repo } : {}),
+    ...(task.createdBy ? { createdBy: task.createdBy } : {}),
+    ...(task.ownerAgentId ? { ownerAgentId: task.ownerAgentId } : {}),
+    ...(task.branch ? { branch: task.branch } : {}),
+    createdAt: task.createdAt,
+    updatedAt: task.updatedAt,
+    ...(task.reapedAt ? { reapedAt: task.reapedAt } : {}),
+  };
+}
+
+export function listDeliverableTaskSummaries(filter: ListDeliverableTasksFilter = {}): TaskListItem[] {
+  return listDeliverableTasks(filter).map(taskListItem);
+}
+
 // Task-aware issue resolution for the land→close bridge (#833/#834 finding 4). Deliverable
 // Tasks own `branch`, so a landed branch resolves to its Task(s). The land WIRING is #831;
 // this is the resolution path + entity-type the bridge needs to be ABLE to fire. The issue

package/src/mcp-task-tools.ts

@@ -12,7 +12,7 @@ import {
   assignTaskEntityAgent,
   createTaskEntity,
   getTaskEntity,
-  listTaskEntities,
+  listTaskEntitySummaries,
   recordTaskEntityGate,
   removeTaskEntityDependency,
   removeTaskEntityRef,
@@ -80,23 +80,26 @@ export const TASK_TOOLS = [
       type: "object",
       properties: {
         title: { type: "string" },
+        label: { type: "string", description: "alias for title; concise task label" },
         intent: { type: "string", description: "original prompt / why this task exists" },
         complexity: { type: "string", enum: TASK_DISPATCH_COMPLEXITIES, description: "coarse task complexity; defaults to moderate" },
         context: { type: "string", description: "optional context needed to understand or execute the task" },
         doneWhen: { type: "string", description: "exit predicate / acceptance for execution" },
         teamId: { type: "string" },
+        projectId: { type: "string" },
+        repo: { type: "string", description: "owner/repo for the task's project/repository" },
         dispatch: DISPATCH_SCHEMA,
         issueRefs: { type: "array", items: { type: "string" }, description: "#n, owner/repo#n, GitHub URL, or issue_<id>" },
         defaultRepo: { type: "string", description: "owner/repo for bare #n issue refs" },
         dependsOn: { type: "array", items: { type: "integer", minimum: 1 } },
       },
-      required: ["title", "intent"],
+      required: ["intent"],
       additionalProperties: false,
     },
   },
   { name: "relay_task_get", description: "Fetch a deliverable Task with its issue links, dependency edges, and current gate state.", requiredScopes: ["task:read"], inputSchema: { type: "object", properties: { taskId: TASK_ID_PROP }, required: ["taskId"], additionalProperties: false } },
-  { name: "relay_task_list", description: "List deliverable Tasks, optionally filtered by execution status, deliverable stage, or team.", requiredScopes: ["task:read"], inputSchema: { type: "object", properties: { status: { type: "string", enum: DELIVERABLE_STATUS_ENUM }, deliverableStage: { type: "string", enum: TASK_DELIVERABLE_STAGES }, teamId: { type: "string" }, limit: { type: "integer", minimum: 1, maximum: 500 } }, additionalProperties: false } },
-  { name: "relay_task_update", description: "Update a deliverable Task's editable fields (title, intent, complexity, context, latest steer, doneWhen, dispatch, team).", requiredScopes: ["task:write"], inputSchema: { type: "object", properties: { taskId: TASK_ID_PROP, title: { type: "string" }, intent: { type: "string" }, complexity: { type: "string", enum: TASK_DISPATCH_COMPLEXITIES }, context: { type: "string" }, latestSteer: { type: "string" }, doneWhen: { type: "string" }, dispatch: DISPATCH_SCHEMA, teamId: { type: "string" } }, required: ["taskId"], additionalProperties: false } },
+  { name: "relay_task_list", description: "List lean deliverable Task summaries, optionally filtered by execution status, deliverable stage, team, project, or repo. Does not return full intent.", requiredScopes: ["task:read"], inputSchema: { type: "object", properties: { status: { type: "string", enum: DELIVERABLE_STATUS_ENUM }, deliverableStage: { type: "string", enum: TASK_DELIVERABLE_STAGES }, teamId: { type: "string" }, projectId: { type: "string" }, repo: { type: "string" }, limit: { type: "integer", minimum: 1, maximum: 500 } }, additionalProperties: false } },
+  { name: "relay_task_update", description: "Update a deliverable Task's editable fields (title/label, intent, complexity, context, latest steer, doneWhen, dispatch, team, project/repo).", requiredScopes: ["task:write"], inputSchema: { type: "object", properties: { taskId: TASK_ID_PROP, title: { type: "string" }, label: { type: "string" }, intent: { type: "string" }, complexity: { type: "string", enum: TASK_DISPATCH_COMPLEXITIES }, context: { type: "string" }, latestSteer: { type: "string" }, doneWhen: { type: "string" }, dispatch: DISPATCH_SCHEMA, teamId: { type: "string" }, projectId: { type: "string" }, repo: { type: "string" } }, required: ["taskId"], additionalProperties: false } },
   { name: "relay_task_set_status", description: "Transition execution status (open|claimed|in_progress|blocked|done|failed|canceled). blockedBy is required when status is 'blocked'. Appends to the audit ledger; never touches the claim lease.", requiredScopes: ["task:write"], inputSchema: { type: "object", properties: { taskId: TASK_ID_PROP, status: { type: "string", enum: DELIVERABLE_STATUS_ENUM }, blockedBy: { type: "array", items: BLOCKER_SCHEMA }, note: { type: "string" } }, required: ["taskId", "status"], additionalProperties: false } },
   { name: "relay_task_set_stage", description: "Set the deliverable-position stage (none→uncommitted→committed-on-branch→landed-on-main→deploying→deployed). Normally driven by the land/deploy pipeline; exposed for manual/test use.", requiredScopes: ["task:write"], inputSchema: { type: "object", properties: { taskId: TASK_ID_PROP, deliverableStage: { type: "string", enum: TASK_DELIVERABLE_STAGES }, branch: { type: "string" }, commit: COMMIT_SCHEMA }, required: ["taskId", "deliverableStage"], additionalProperties: false } },
   { name: "relay_task_record_gate", description: "Record a quality-gate run (typecheck, test, file-size, api-spec, smoke, …) in the append-only ledger. Idempotent by runId; latest run per gate wins.", requiredScopes: ["task:write"], inputSchema: { type: "object", properties: { taskId: TASK_ID_PROP, gate: { type: "string" }, status: { type: "string", enum: TASK_GATE_STATUSES }, detail: { type: "string" }, commitSha: { type: "string" }, runId: { type: "string" } }, required: ["taskId", "gate", "status"], additionalProperties: false } },
@@ -129,12 +132,14 @@ export function relayTaskTool(auth: McpAuthLike, name: string, args: Record<stri
 
   if (name === "relay_task_create") {
     const created = createTaskEntity({
-      title: cleanString(args.title, "title", { required: true, max: 500 })!,
+      title: cleanString(args.title ?? args.label, "title", { required: true, max: 500 })!,
       intent: cleanString(args.intent, "intent", { required: true, max: 1_000_000 })!,
       complexity: optionalEnum(args.complexity, "complexity", TASK_DISPATCH_COMPLEXITIES),
       context: cleanString(args.context, "context", { max: 1_000_000 }),
       doneWhen: cleanString(args.doneWhen, "doneWhen", { max: 1_000_000 }),
       teamId: cleanString(args.teamId, "teamId", { max: 200 }),
+      projectId: cleanString(args.projectId, "projectId", { max: 120 }),
+      repo: cleanString(args.repo, "repo", { max: 500 }),
       dispatch: args.dispatch as TaskDispatch | undefined,
       createdBy: actor,
     });
@@ -155,17 +160,19 @@ export function relayTaskTool(auth: McpAuthLike, name: string, args: Record<stri
   }
   if (name === "relay_task_list") {
     return {
-      tasks: listTaskEntities({
+      tasks: listTaskEntitySummaries({
         status: optionalEnum(args.status, "status", DELIVERABLE_STATUS_ENUM),
         deliverableStage: optionalEnum(args.deliverableStage, "deliverableStage", TASK_DELIVERABLE_STAGES),
         teamId: cleanString(args.teamId, "teamId", { max: 200 }),
+        projectId: cleanString(args.projectId, "projectId", { max: 120 }),
+        repo: cleanString(args.repo, "repo", { max: 500 }),
         limit: typeof args.limit === "number" ? args.limit : undefined,
       }),
     };
   }
   if (name === "relay_task_update") {
     return updateTaskEntity(taskIdArg(args.taskId), {
-      ...(args.title !== undefined ? { title: cleanString(args.title, "title", { max: 500 }) } : {}),
+      ...(args.title !== undefined || args.label !== undefined ? { title: cleanString(args.title ?? args.label, "title", { max: 500 }) } : {}),
       ...(args.intent !== undefined ? { intent: cleanString(args.intent, "intent", { max: 1_000_000 }) ?? "" } : {}),
       ...(args.complexity !== undefined ? { complexity: optionalEnum(args.complexity, "complexity", TASK_DISPATCH_COMPLEXITIES) } : {}),
       ...(args.context !== undefined ? { context: cleanString(args.context, "context", { max: 1_000_000 }) ?? "" } : {}),
@@ -173,6 +180,8 @@ export function relayTaskTool(auth: McpAuthLike, name: string, args: Record<stri
       ...(args.doneWhen !== undefined ? { doneWhen: cleanString(args.doneWhen, "doneWhen", { max: 1_000_000 }) ?? "" } : {}),
       ...(args.dispatch !== undefined ? { dispatch: args.dispatch as TaskDispatch } : {}),
       ...(args.teamId !== undefined ? { teamId: cleanString(args.teamId, "teamId", { max: 200 }) ?? "" } : {}),
+      ...(args.projectId !== undefined ? { projectId: cleanString(args.projectId, "projectId", { max: 120 }) ?? "" } : {}),
+      ...(args.repo !== undefined ? { repo: cleanString(args.repo, "repo", { max: 500 }) ?? "" } : {}),
       actor,
     }) as unknown as Record<string, unknown>;
   }

package/src/routes/tasks.ts

@@ -9,7 +9,7 @@ import { ValidationError, claimTask, getMessage, getTask, listTaskEvents, listTa
 import { readTaskMemoryEnvelope } from "../db/task-memory";
 import {
   addTaskEntityDependency, addTaskEntityRef, assignTaskEntityAgent, createTaskEntity, getTaskEntity,
-  listTaskEntities, recordTaskEntityGate, removeTaskEntityDependency, removeTaskEntityRef, setTaskEntityStage, setTaskEntityStatus, taskEntityHistory, updateTaskEntity,
+  listTaskEntitySummaries, recordTaskEntityGate, removeTaskEntityDependency, removeTaskEntityRef, setTaskEntityStage, setTaskEntityStatus, taskEntityHistory, updateTaskEntity,
 } from "../services/task-entity";
 import { CommentThroughError, commentOnTaskThrough, taskCloseBridge } from "../services/task-issue-weave";
 import { captureTaskResultMemory, injectMemoryForTaskClaim } from "../memory-service";
@@ -52,11 +52,13 @@ export const getTasks: Handler = (req) => {
   // durable Tasks (optionally filtered by deliverable stage / team).
   const kind = url.searchParams.get("kind") ?? undefined;
   if (kind === "deliverable") {
-    return json(listTaskEntities({
+    return json(listTaskEntitySummaries({
       status: url.searchParams.get("status") ?? undefined,
       deliverableStage: url.searchParams.get("deliverableStage") ?? undefined,
       teamId: url.searchParams.get("teamId") ?? undefined,
       ownerAgentId: url.searchParams.get("ownerAgentId") ?? undefined,
+      projectId: url.searchParams.get("projectId") ?? undefined,
+      repo: url.searchParams.get("repo") ?? undefined,
       limit: limitRaw ?? 100,
     }));
   }
@@ -73,11 +75,13 @@ export const getTaskEntities: Handler = (req) => {
   const url = new URL(req.url);
   const limitRaw = parseQueryInt(url.searchParams.get("limit"), { min: 1, max: 500 });
   if (Number.isNaN(limitRaw)) return error("limit must be an integer between 1 and 500");
-  return json(listTaskEntities({
+  return json(listTaskEntitySummaries({
     status: url.searchParams.get("status") ?? undefined,
     deliverableStage: url.searchParams.get("deliverableStage") ?? undefined,
     teamId: url.searchParams.get("teamId") ?? undefined,
     createdBy: url.searchParams.get("createdBy") ?? undefined,
+    projectId: url.searchParams.get("projectId") ?? undefined,
+    repo: url.searchParams.get("repo") ?? undefined,
     limit: limitRaw ?? 100,
   }));
 };
@@ -91,12 +95,14 @@ export const postTaskCreate: Handler = async (req) => {
   if (!isRecord(body)) return error("JSON object body required");
   try {
     const created = createTaskEntity({
-      title: body.title as string,
+      title: (body.title ?? body.label) as string,
       intent: cleanString(body.intent, "intent", { required: true, max: MAX_BODY_BYTES })!,
       complexity: optionalEnum(body.complexity, "complexity", TASK_DISPATCH_COMPLEXITIES),
       context: cleanString(body.context, "context", { max: MAX_BODY_BYTES }),
       doneWhen: cleanString(body.doneWhen, "doneWhen", { max: MAX_BODY_BYTES }),
       teamId: cleanString(body.teamId, "teamId", { max: 200 }),
+      projectId: cleanString(body.projectId, "projectId", { max: 120 }),
+      repo: cleanString(body.repo, "repo", { max: 500 }),
       dispatch: body.dispatch as TaskDispatch | undefined,
       createdBy: actorOf(req, body.createdBy),
     });
@@ -155,7 +161,7 @@ export const patchTaskEntity: Handler = async (req, params) => {
   if (!isRecord(body)) return error("JSON object body required");
   try {
     const detail = updateTaskEntity(id, {
-      ...(body.title !== undefined ? { title: cleanString(body.title, "title", { max: 500 }) } : {}),
+      ...(body.title !== undefined || body.label !== undefined ? { title: cleanString(body.title ?? body.label, "title", { max: 500 }) } : {}),
       ...(body.intent !== undefined ? { intent: cleanString(body.intent, "intent", { max: MAX_BODY_BYTES }) ?? "" } : {}),
       ...(body.complexity !== undefined ? { complexity: optionalEnum(body.complexity, "complexity", TASK_DISPATCH_COMPLEXITIES) } : {}),
       ...(body.context !== undefined ? { context: cleanString(body.context, "context", { max: MAX_BODY_BYTES }) ?? "" } : {}),
@@ -163,6 +169,8 @@ export const patchTaskEntity: Handler = async (req, params) => {
       ...(body.doneWhen !== undefined ? { doneWhen: cleanString(body.doneWhen, "doneWhen", { max: MAX_BODY_BYTES }) ?? "" } : {}),
       ...(body.dispatch !== undefined ? { dispatch: body.dispatch as TaskDispatch } : {}),
       ...(body.teamId !== undefined ? { teamId: cleanString(body.teamId, "teamId", { max: 200 }) ?? "" } : {}),
+      ...(body.projectId !== undefined ? { projectId: cleanString(body.projectId, "projectId", { max: 120 }) ?? "" } : {}),
+      ...(body.repo !== undefined ? { repo: cleanString(body.repo, "repo", { max: 500 }) ?? "" } : {}),
       actor: actorOf(req),
     });
     return json(detail);

package/src/services/spawn-agent.ts

@@ -267,7 +267,9 @@ function spawnBrief(input: SpawnAgentInput): string | undefined {
   return undefined;
 }
 
-function taskTitleFromBrief(brief: string): string {
+function taskTitleFromBrief(brief: string, label?: string): string {
+  const cleanLabel = label?.trim();
+  if (cleanLabel) return cleanLabel.length <= 500 ? cleanLabel : `${cleanLabel.slice(0, 497)}...`;
   const firstLine = brief.split(/\r?\n/).map((line) => line.trim()).find(Boolean) ?? "Spawned work";
   return firstLine.length <= 500 ? firstLine : `${firstLine.slice(0, 497)}...`;
 }
@@ -349,16 +351,34 @@ export async function spawnAgent(input: SpawnAgentInput, ctx: AuthContext): Prom
   // outside its cwd prefix, and MCP now honors the same bound.
   assertResourceAllowed(ctx, { scope: "agent:write", resource: { orchestratorId: orchestrator.id, cwd: resolvedCwd } });
 
+  // Provenance actor: the resolved caller agent when known, else the transport's label, else
+  // the raw token actor. Recorded in the command payload, the token mint, and the audit row.
+  const requestedBy = callerId ?? taskCreatorAgentId ?? input.requestedBy ?? ctx.actor.id;
+
+  // #405 — durable project binding: the project whose registered root contains the spawn cwd.
+  // Stamped on both the child token and an auto-scaffolded Task row so issueless spawned work
+  // stays filterable by project.
+  let callerProject = resolveProjectForCwd(resolvedCwd);
+  try {
+    const seeded = autoSeedProjectForCwd(resolvedCwd, requestedBy);
+    callerProject = seeded?.project ?? callerProject;
+    if (seeded?.ingestError) {
+      console.warn(`project auto-seed failed to ingest CLAUDE.md for ${resolvedCwd}: ${seeded.ingestError.message}`);
+    }
+  } catch (err) {
+    if (!callerProject) console.warn(`project auto-seed skipped for ${resolvedCwd}: ${errMessage(err)}`);
+  }
+
   if (shouldAutoScaffoldTask(input, profileName)) {
     const brief = spawnBrief(input)!;
-    const taskRequestedBy = callerId ?? input.requestedBy ?? ctx.actor.id;
     linkedTask = createTaskEntity({
-      title: taskTitleFromBrief(brief),
+      title: taskTitleFromBrief(brief, input.label),
       intent: brief,
       latestSteer: input.steer,
-      createdBy: taskRequestedBy,
+      createdBy: requestedBy,
       source: "spawn",
-      target: taskRequestedBy,
+      target: requestedBy,
+      ...(callerProject ? { projectId: callerProject.id, repo: callerProject.issueRepo } : {}),
     });
     input = { ...input, taskId: linkedTask.id };
     autoScaffoldedTask = { id: linkedTask.id, autoScaffolded: true, nudge: AUTO_SCAFFOLD_TASK_NUDGE };
@@ -474,26 +494,9 @@ export async function spawnAgent(input: SpawnAgentInput, ctx: AuthContext): Prom
     };
   }
 
-  // Provenance actor: the resolved caller agent when known, else the transport's label, else
-  // the raw token actor. Recorded in the command payload, the token mint, and the audit row.
-  const requestedBy = callerId ?? taskCreatorAgentId ?? input.requestedBy ?? ctx.actor.id;
   const callerTeam = lineageAgentId ? (lineageAgent?.teamId ? { id: lineageAgent.teamId } : ensureTeam(lineageAgentId)) : undefined;
   if (lineageAgentId && callerTeam && !lineageAgent?.teamId) setAgentTeam(lineageAgentId, callerTeam.id);
 
-  // #405 — durable project binding: the project whose registered root contains the spawn cwd.
-  // Stamped on the child token's constraints (identity-only, like teamId) so callerProject(auth)
-  // resolves it. Absent (graceful) when the cwd is inside no registered root.
-  let callerProject = resolveProjectForCwd(resolvedCwd);
-  try {
-    const seeded = autoSeedProjectForCwd(resolvedCwd, requestedBy);
-    callerProject = seeded?.project ?? callerProject;
-    if (seeded?.ingestError) {
-      console.warn(`project auto-seed failed to ingest CLAUDE.md for ${resolvedCwd}: ${seeded.ingestError.message}`);
-    }
-  } catch (err) {
-    if (!callerProject) console.warn(`project auto-seed skipped for ${resolvedCwd}: ${errMessage(err)}`);
-  }
-
   // #409 + #463 + #557 — the instruction-sources half of the launch-assembly contract.
   // composeSpawnInstructions is the single home that composes the prompt material handed to
   // providers (project preamble → profile system → profile append → caller/fork context) and

package/src/services/task-entity.ts

@@ -8,6 +8,7 @@ import {
   assignTaskAgent,
   createDeliverableTask,
   getTaskDetail,
+  listDeliverableTaskSummaries,
   listDeliverableTasks,
   listTaskEvents,
   recordGate,
@@ -28,7 +29,7 @@ import {
   type UpdateDeliverableTaskInput,
 } from "../db";
 import { emitTaskChanged } from "../sse";
-import type { Task, TaskDetail, TaskEvent, TaskGateState } from "../types";
+import type { Task, TaskDetail, TaskEvent, TaskGateState, TaskListItem } from "../types";
 import { removeSubscriptionsForTask } from "../db/notification-subscriptions";
 import { stageSatisfiesDoneWhen } from "./task-done-when";
 import { autoSubscribeTaskCoordinator, emitTaskSemanticNotification, taskTransitionForStage, taskTransitionForStatus } from "./task-semantic-events";
@@ -54,6 +55,10 @@ export function listTaskEntities(filter: ListDeliverableTasksFilter = {}): Task[
   return listDeliverableTasks(filter);
 }
 
+export function listTaskEntitySummaries(filter: ListDeliverableTasksFilter = {}): TaskListItem[] {
+  return listDeliverableTaskSummaries(filter);
+}
+
 export function updateTaskEntity(id: number, input: UpdateDeliverableTaskInput): TaskDetail {
   const detail = updateDeliverableTask(id, input);
   emitTaskChanged(detail, "task.updated");