crewly 1.20.158 → 1.20.160

package/dist/backend/backend/src/services/project-tickets/delegation-ticket-route.d.ts

@@ -0,0 +1,63 @@
+/**
+ * Delegation through project tickets — the rule deciding whether a WorkItem
+ * created through `POST /api/task-pool/add` is routed through a project
+ * ticket (specs/2026-09-28-project-tickets.md §11).
+ *
+ * Pure: no I/O. The workflow service gathers the inputs (who is calling, the
+ * projects of the target's teams) and acts on the decision.
+ *
+ * @module services/project-tickets/delegation-ticket-route
+ */
+import type { WorkItem } from '../../types/v2/work-item.types.js';
+/** The WorkItem fields the rule looks at. */
+export type DelegationRouteItem = Pick<WorkItem, 'type' | 'owner' | 'target' | 'triggerId' | 'scheduledAt' | 'metadata'>;
+/** Inputs of {@link decideDelegationTicketRoute}. */
+export interface DelegationRouteInput {
+    /** The WorkItem about to be added */
+    workItem: DelegationRouteItem;
+    /** The delegating agent (X-Agent-Session, or `metadata.delegatedBy`); absent = unknown */
+    callerSession?: string;
+    /** `--ticket <ID>` given by the delegator */
+    explicitTicketId?: string;
+    /** Ids of the projects the target's teams work on */
+    targetProjectIds: readonly string[];
+}
+/**
+ * What to do with the WorkItem.
+ *
+ * - `route`: go through a ticket (the given one, or a new one).
+ * - `skip`: add the WorkItem as before, no ticket.
+ * - `refuse`: the delegator named a ticket, but this item cannot carry one.
+ */
+export type DelegationRouteDecision = {
+    action: 'route';
+} | {
+    action: 'skip';
+    reason: string;
+} | {
+    action: 'refuse';
+    reason: string;
+};
+/**
+ * Decide whether a WorkItem goes through a project ticket.
+ *
+ * Routed: a `delegate` item from a known agent (or the owner, with an
+ * explicit ticket) to a DIFFERENT agent whose team works on a project. Never
+ * routed: review/verify items, system / trigger / scheduled items, items an
+ * agent targets at itself, targets with no project, items already linked.
+ * Naming a ticket on an item that cannot carry one is refused rather than
+ * silently ignored.
+ *
+ * @param input - The WorkItem, the caller, the explicit ticket, the target's projects
+ * @returns The decision
+ */
+export declare function decideDelegationTicketRoute(input: DelegationRouteInput): DelegationRouteDecision;
+/**
+ * Ticket title for a delegation title: the first non-empty line, markdown
+ * heading marks dropped, capped.
+ *
+ * @param title - WorkItem title (may be the first 200 chars of a brief)
+ * @returns Title (never empty)
+ */
+export declare function delegationTicketTitle(title: string): string;
+//# sourceMappingURL=delegation-ticket-route.d.ts.map

package/dist/backend/backend/src/services/project-tickets/delegation-ticket-route.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"delegation-ticket-route.d.ts","sourceRoot":"","sources":["../../../../../../backend/src/services/project-tickets/delegation-ticket-route.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAGH,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,mCAAmC,CAAC;AAGlE,6CAA6C;AAC7C,MAAM,MAAM,mBAAmB,GAAG,IAAI,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,GAAG,QAAQ,GAAG,WAAW,GAAG,aAAa,GAAG,UAAU,CAAC,CAAC;AAEzH,qDAAqD;AACrD,MAAM,WAAW,oBAAoB;IACnC,qCAAqC;IACrC,QAAQ,EAAE,mBAAmB,CAAC;IAC9B,0FAA0F;IAC1F,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,6CAA6C;IAC7C,gBAAgB,CAAC,EAAE,MAAM,CAAC;IAC1B,qDAAqD;IACrD,gBAAgB,EAAE,SAAS,MAAM,EAAE,CAAC;CACrC;AAED;;;;;;GAMG;AACH,MAAM,MAAM,uBAAuB,GAC/B;IAAE,MAAM,EAAE,OAAO,CAAA;CAAE,GACnB;IAAE,MAAM,EAAE,MAAM,CAAC;IAAC,MAAM,EAAE,MAAM,CAAA;CAAE,GAClC;IAAE,MAAM,EAAE,QAAQ,CAAC;IAAC,MAAM,EAAE,MAAM,CAAA;CAAE,CAAC;AAyBzC;;;;;;;;;;;;GAYG;AACH,wBAAgB,2BAA2B,CAAC,KAAK,EAAE,oBAAoB,GAAG,uBAAuB,CAIhG;AAED;;;;;;GAMG;AACH,wBAAgB,qBAAqB,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,CAQ3D"}

package/dist/backend/backend/src/services/project-tickets/delegation-ticket-route.js

@@ -0,0 +1,80 @@
+/**
+ * Delegation through project tickets — the rule deciding whether a WorkItem
+ * created through `POST /api/task-pool/add` is routed through a project
+ * ticket (specs/2026-09-28-project-tickets.md §11).
+ *
+ * Pure: no I/O. The workflow service gathers the inputs (who is calling, the
+ * projects of the target's teams) and acts on the decision.
+ *
+ * @module services/project-tickets/delegation-ticket-route
+ */
+import { PROJECT_TICKET_CONSTANTS } from '../../constants.js';
+import { readProjectTicketLink } from '../../types/project-ticket.types.js';
+/**
+ * Why an item is never routed through a ticket, or null when it may be.
+ *
+ * @param input - Rule inputs
+ * @returns Reason, or null
+ */
+function exclusionReason(input) {
+    const { workItem: wi, callerSession } = input;
+    const types = PROJECT_TICKET_CONSTANTS.DELEGATION_WORK_ITEM_TYPES;
+    if (!types.includes(wi.type))
+        return `a ${wi.type} item is not a delegation`;
+    if (readProjectTicketLink(wi.metadata))
+        return 'the item already carries a project ticket';
+    if (typeof wi.metadata?.verifyOf === 'string')
+        return 'review / verify items do not get tickets';
+    if (wi.owner === 'system')
+        return 'system items do not get tickets';
+    if (wi.triggerId)
+        return 'trigger / cron items do not get tickets';
+    if (wi.scheduledAt)
+        return 'scheduled reminders do not get tickets';
+    const target = typeof wi.target === 'string' ? wi.target.trim() : '';
+    if (!target)
+        return 'an unassigned item has nobody to put on a ticket';
+    if (!callerSession && !input.explicitTicketId)
+        return 'the delegator is unknown, so a self-reminder cannot be told apart';
+    if (callerSession && callerSession === target)
+        return 'an item an agent targets at itself is a self-reminder';
+    if (input.targetProjectIds.length === 0)
+        return `${target} is not on a team with a project`;
+    return null;
+}
+/**
+ * Decide whether a WorkItem goes through a project ticket.
+ *
+ * Routed: a `delegate` item from a known agent (or the owner, with an
+ * explicit ticket) to a DIFFERENT agent whose team works on a project. Never
+ * routed: review/verify items, system / trigger / scheduled items, items an
+ * agent targets at itself, targets with no project, items already linked.
+ * Naming a ticket on an item that cannot carry one is refused rather than
+ * silently ignored.
+ *
+ * @param input - The WorkItem, the caller, the explicit ticket, the target's projects
+ * @returns The decision
+ */
+export function decideDelegationTicketRoute(input) {
+    const reason = exclusionReason(input);
+    if (!reason)
+        return { action: 'route' };
+    return input.explicitTicketId ? { action: 'refuse', reason: `--ticket ${input.explicitTicketId} refused: ${reason}` } : { action: 'skip', reason };
+}
+/**
+ * Ticket title for a delegation title: the first non-empty line, markdown
+ * heading marks dropped, capped.
+ *
+ * @param title - WorkItem title (may be the first 200 chars of a brief)
+ * @returns Title (never empty)
+ */
+export function delegationTicketTitle(title) {
+    const line = String(title ?? '')
+        .split('\n')
+        .map((l) => l.replace(/^#+\s*/, '').trim())
+        .find((l) => l.length > 0) ?? '';
+    const max = PROJECT_TICKET_CONSTANTS.DELEGATION_TITLE_MAX_CHARS;
+    const text = line || 'Delegated task';
+    return text.length > max ? `${text.slice(0, max - 1).trimEnd()}…` : text;
+}
+//# sourceMappingURL=delegation-ticket-route.js.map

package/dist/backend/backend/src/services/project-tickets/delegation-ticket-route.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"delegation-ticket-route.js","sourceRoot":"","sources":["../../../../../../backend/src/services/project-tickets/delegation-ticket-route.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAEH,OAAO,EAAE,wBAAwB,EAAE,MAAM,oBAAoB,CAAC;AAE9D,OAAO,EAAE,qBAAqB,EAAE,MAAM,qCAAqC,CAAC;AA6B5E;;;;;GAKG;AACH,SAAS,eAAe,CAAC,KAA2B;IAClD,MAAM,EAAE,QAAQ,EAAE,EAAE,EAAE,aAAa,EAAE,GAAG,KAAK,CAAC;IAC9C,MAAM,KAAK,GAAsB,wBAAwB,CAAC,0BAA0B,CAAC;IACrF,IAAI,CAAC,KAAK,CAAC,QAAQ,CAAC,EAAE,CAAC,IAAI,CAAC;QAAE,OAAO,KAAK,EAAE,CAAC,IAAI,2BAA2B,CAAC;IAC7E,IAAI,qBAAqB,CAAC,EAAE,CAAC,QAAQ,CAAC;QAAE,OAAO,2CAA2C,CAAC;IAC3F,IAAI,OAAO,EAAE,CAAC,QAAQ,EAAE,QAAQ,KAAK,QAAQ;QAAE,OAAO,0CAA0C,CAAC;IACjG,IAAI,EAAE,CAAC,KAAK,KAAK,QAAQ;QAAE,OAAO,iCAAiC,CAAC;IACpE,IAAI,EAAE,CAAC,SAAS;QAAE,OAAO,yCAAyC,CAAC;IACnE,IAAI,EAAE,CAAC,WAAW;QAAE,OAAO,wCAAwC,CAAC;IACpE,MAAM,MAAM,GAAG,OAAO,EAAE,CAAC,MAAM,KAAK,QAAQ,CAAC,CAAC,CAAC,EAAE,CAAC,MAAM,CAAC,IAAI,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;IACrE,IAAI,CAAC,MAAM;QAAE,OAAO,kDAAkD,CAAC;IACvE,IAAI,CAAC,aAAa,IAAI,CAAC,KAAK,CAAC,gBAAgB;QAAE,OAAO,mEAAmE,CAAC;IAC1H,IAAI,aAAa,IAAI,aAAa,KAAK,MAAM;QAAE,OAAO,uDAAuD,CAAC;IAC9G,IAAI,KAAK,CAAC,gBAAgB,CAAC,MAAM,KAAK,CAAC;QAAE,OAAO,GAAG,MAAM,kCAAkC,CAAC;IAC5F,OAAO,IAAI,CAAC;AACd,CAAC;AAED;;;;;;;;;;;;GAYG;AACH,MAAM,UAAU,2BAA2B,CAAC,KAA2B;IACrE,MAAM,MAAM,GAAG,eAAe,CAAC,KAAK,CAAC,CAAC;IACtC,IAAI,CAAC,MAAM;QAAE,OAAO,EAAE,MAAM,EAAE,OAAO,EAAE,CAAC;IACxC,OAAO,KAAK,CAAC,gBAAgB,CAAC,CAAC,CAAC,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,EAAE,YAAY,KAAK,CAAC,gBAAgB,aAAa,MAAM,EAAE,EAAE,CAAC,CAAC,CAAC,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,CAAC;AACrJ,CAAC;AAED;;;;;;GAMG;AACH,MAAM,UAAU,qBAAqB,CAAC,KAAa;IACjD,MAAM,IAAI,GAAG,MAAM,CAAC,KAAK,IAAI,EAAE,CAAC;SAC7B,KAAK,CAAC,IAAI,CAAC;SACX,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,OAAO,CAAC,QAAQ,EAAE,EAAE,CAAC,CAAC,IAAI,EAAE,CAAC;SAC1C,IAAI,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,MAAM,GAAG,CAAC,CAAC,IAAI,EAAE,CAAC;IACnC,MAAM,GAAG,GAAG,wBAAwB,CAAC,0BAA0B,CAAC;IAChE,MAAM,IAAI,GAAG,IAAI,IAAI,gBAAgB,CAAC;IACtC,OAAO,IAAI,CAAC,MAAM,GAAG,GAAG,CAAC,CAAC,CAAC,GAAG,IAAI,CAAC,KAAK,CAAC,CAAC,EAAE,GAAG,GAAG,CAAC,CAAC,CAAC,OAAO,EAAE,GAAG,CAAC,CAAC,CAAC,IAAI,CAAC;AAC3E,CAAC"}

package/dist/backend/backend/src/services/project-tickets/project-ticket-workflow.service.d.ts

@@ -27,7 +27,9 @@ export interface ProjectTicketCaller {
 export type ProjectTicketAccess = 'owner' | 'orchestrator' | 'lead' | 'member' | 'outsider';
 /** The subset of the task pool this service uses. */
 export interface ProjectTicketPool {
-    addToPool(workItem: WorkItem): Promise<void>;
+    addToPool(workItem: WorkItem, options?: {
+        creatorSession?: string;
+    }): Promise<void>;
     claimSpecificItem(agentId: string, workItemId: string): Promise<{
         workItem: WorkItem;
     } | null>;
@@ -36,6 +38,7 @@ export interface ProjectTicketPool {
     cancelQueued(workItemId: string, reason: string): Promise<void>;
     transitionStatus(workItemId: string, status: WorkItemStatus, actor: 'system', mutator?: (wi: WorkItem) => void, reason?: string): Promise<WorkItem | null>;
     releaseClaim(workItemId: string, endReason: string): Promise<void>;
+    mergeItemMetadata(workItemId: string, patch: Record<string, unknown>): Promise<WorkItem | null>;
 }
 /** The subset of storage this service uses. */
 export interface ProjectTicketDirectory {
@@ -57,6 +60,28 @@ export interface StartedTicketWork {
     /** True when the WorkItem was claimed for the assignee right away */
     claimed: boolean;
 }
+/** A delegated WorkItem routed through a ticket (spec §11). */
+export interface RoutedDelegation {
+    ticket: ProjectTicket;
+    /** The delegated WorkItem as added to the pool, now carrying `metadata.projectTicket` */
+    workItem: WorkItem;
+    project: Project;
+    /** True when the ticket was created for this delegation */
+    createdTicket: boolean;
+}
+/** Inputs of {@link ProjectTicketWorkflowService.routeDelegation}. */
+export interface RouteDelegationInput {
+    /** The WorkItem the delegate skill is adding (built, not yet in the pool) */
+    workItem: WorkItem;
+    /** The delegator (X-Agent-Session or `metadata.delegatedBy`); absent = owner / unknown */
+    callerSession?: string;
+    /** `--ticket <ID>` */
+    ticketId?: string;
+    /** Options passed through to the pool's add */
+    addOptions?: {
+        creatorSession?: string;
+    };
+}
 /** What {@link ProjectTicketWorkflowService.syncTicket} did. */
 export type TicketSyncOutcome = 'unchanged' | 'done' | 'review' | 'relinked' | 'returned';
 /** Tickets of one project, for the per-agent listing. */
@@ -283,6 +308,43 @@ export declare class ProjectTicketWorkflowService {
      * @returns The started work, or null
      */
     claimNextForAgent(session: string): Promise<StartedTicketWork | null>;
+    /**
+     * Route a delegated WorkItem through a project ticket, or leave it alone.
+     *
+     * When {@link decideDelegationTicketRoute} says `route`, the WorkItem is
+     * added to the pool here (under the ticket folder lock, through the same
+     * path as {@link assign}) instead of by the caller:
+     * - with `ticketId`: that ticket (must be `backlog`/`ready`, no live
+     *   WorkItem, caller owner/orc/lead) is assigned to the target;
+     * - without: a ticket is created from the delegation (title, brief,
+     *   target's team, priority) and assigned to the target at once.
+     * The WorkItem keeps all its fields; `metadata.projectTicket` (plus
+     * `projectId` / `projectPath` / `teamId` when missing) is added.
+     *
+     * @param input - WorkItem, delegator, optional ticket, add options
+     * @returns The routed delegation, or null when the caller should add the WorkItem itself
+     * @throws ProjectTicketError when a named ticket cannot take this delegation
+     */
+    routeDelegation(input: RouteDelegationInput): Promise<RoutedDelegation | null>;
+    /**
+     * Link a live WorkItem that is already in flight to a ticket (spec §11).
+     *
+     * The ticket must not be done/cancelled and must have no other live
+     * WorkItem; the WorkItem must be live and carry no other ticket. The item
+     * gets `metadata.projectTicket`; the ticket becomes `in_progress` (a ticket
+     * in `review` stays there), assignee = the item's target, workItemId set.
+     *
+     * @param ref - Project reference
+     * @param id - Ticket id
+     * @param workItemId - The live WorkItem
+     * @param caller - Owner, orchestrator or a lead of a project team
+     * @returns Updated ticket and WorkItem
+     * @throws ProjectTicketError(400/403/404/409)
+     */
+    link(ref: string, id: string, workItemId: string, caller: ProjectTicketCaller): Promise<{
+        ticket: ProjectTicket;
+        workItem: WorkItem;
+    }>;
     /**
      * React to a pool lifecycle event: find the ticket the WorkItem (or one of
      * its ancestors — a reviewer's retry or review item) belongs to and sync it.
@@ -353,6 +415,35 @@ export declare class ProjectTicketWorkflowService {
      * @param reason - Cancel reason
      */
     private cancelLiveWorkItem;
+    /**
+     * Projects an agent's (non-archived) teams work on, with the team.
+     *
+     * @param session - Agent session
+     * @returns One entry per project (first team wins)
+     */
+    private projectsOfAgent;
+    /**
+     * Which of the target's projects a delegation belongs to: the one matching
+     * the item's `metadata.projectPath`, else the only one, else (with a
+     * ticket id) the one holding that ticket.
+     *
+     * @param candidates - Target's projects
+     * @param wi - Delegated WorkItem
+     * @param ticketId - Explicit ticket, if any
+     * @returns The choice, or null when it cannot be told
+     */
+    private pickDelegationProject;
+    /**
+     * The delegated WorkItem with the ticket link added; every other field is
+     * kept as the delegator built it.
+     *
+     * @param wi - Delegated WorkItem
+     * @param project - Project
+     * @param t - Ticket
+     * @param teamId - Target's team on the project
+     * @returns WorkItem to add
+     */
+    private linkDelegatedItem;
     /**
      * The team an agent would work a ticket for, or null when it may not.
      *

package/dist/backend/backend/src/services/project-tickets/project-ticket-workflow.service.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"project-ticket-workflow.service.d.ts","sourceRoot":"","sources":["../../../../../../backend/src/services/project-tickets/project-ticket-workflow.service.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"project-ticket-workflow.service.d.ts","sourceRoot":"","sources":["../../../../../../backend/src/services/project-tickets/project-ticket-workflow.service.ts"],"names":[],"mappings":"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"}

package/dist/backend/backend/src/services/project-tickets/project-ticket-workflow.service.js

@@ -16,9 +16,10 @@ import { v4 as uuidv4 } from 'uuid';
 import { ORCHESTRATOR_SESSION_NAME, PROJECT_TICKET_CONSTANTS } from '../../constants.js';
 import { LoggerService } from '../core/logger.service.js';
 import { MAX_BRIEF_MARKDOWN_BYTES, getWorkItemDisposition, } from '../../types/v2/work-item.types.js';
-import { projectTicketPriorityRank, readProjectTicketLink, } from '../../types/project-ticket.types.js';
+import { normalizeProjectTicketPriority, projectTicketPriorityRank, readProjectTicketLink, } from '../../types/project-ticket.types.js';
 import { ProjectTicketError, } from './project-ticket.service.js';
 import { SUPERSEDED_BY_METADATA_KEY } from '../v3/request-completion.js';
+import { decideDelegationTicketRoute, delegationTicketTitle } from './delegation-ticket-route.js';
 /** WorkItem statuses that still carry the ticket's work. */
 const LIVE_STATUSES = new Set([
     'queued',
@@ -491,6 +492,184 @@ export class ProjectTicketWorkflowService {
         return null;
     }
     // ---------------------------------------------------------------------------
+    // Delegation through tickets (spec §11)
+    // ---------------------------------------------------------------------------
+    /**
+     * Route a delegated WorkItem through a project ticket, or leave it alone.
+     *
+     * When {@link decideDelegationTicketRoute} says `route`, the WorkItem is
+     * added to the pool here (under the ticket folder lock, through the same
+     * path as {@link assign}) instead of by the caller:
+     * - with `ticketId`: that ticket (must be `backlog`/`ready`, no live
+     *   WorkItem, caller owner/orc/lead) is assigned to the target;
+     * - without: a ticket is created from the delegation (title, brief,
+     *   target's team, priority) and assigned to the target at once.
+     * The WorkItem keeps all its fields; `metadata.projectTicket` (plus
+     * `projectId` / `projectPath` / `teamId` when missing) is added.
+     *
+     * @param input - WorkItem, delegator, optional ticket, add options
+     * @returns The routed delegation, or null when the caller should add the WorkItem itself
+     * @throws ProjectTicketError when a named ticket cannot take this delegation
+     */
+    async routeDelegation(input) {
+        const { workItem, callerSession } = input;
+        const ticketId = input.ticketId?.trim() || undefined;
+        const target = typeof workItem.target === 'string' ? workItem.target.trim() : '';
+        const candidates = target ? await this.projectsOfAgent(target) : [];
+        const decision = decideDelegationTicketRoute({
+            workItem,
+            callerSession,
+            explicitTicketId: ticketId,
+            targetProjectIds: candidates.map((c) => c.project.id),
+        });
+        if (decision.action === 'refuse')
+            throw new ProjectTicketError(400, decision.reason);
+        if (decision.action === 'skip') {
+            this.logger.debug('Delegation not routed through a project ticket', { workItemId: workItem.id, target, reason: decision.reason });
+            return null;
+        }
+        const choice = await this.pickDelegationProject(candidates, workItem, ticketId);
+        if (!choice) {
+            if (ticketId)
+                throw new ProjectTicketError(404, `Ticket ${ticketId} not found in any project of ${target}'s teams`);
+            this.logger.info('Delegation not routed: target works on several projects and none was named', { workItemId: workItem.id, target });
+            return null;
+        }
+        const { project } = choice;
+        const caller = callerSession ? { session: callerSession } : {};
+        const actor = this.actorName(caller);
+        if (ticketId) {
+            const { access } = await this.accessOf(caller, project);
+            this.requireAccess(access, ['owner', 'orchestrator', 'lead'], `delegate ticket ${ticketId}`);
+            const ticket = await this.tickets.get(project.path, ticketId);
+            if (!ticket)
+                throw new ProjectTicketError(404, `Ticket not found: ${ticketId}`);
+            const teamId = await this.eligibleTeamOf(project, ticket, target);
+            if (!teamId)
+                throw new ProjectTicketError(403, `${target} is not on a team that works on ${ticket.id}`);
+            const started = await this.startWork(project, ticket.id, target, actor, teamId, {
+                self: false,
+                allowed: ['backlog', 'ready'],
+                prepared: (t) => this.linkDelegatedItem(workItem, project, t, teamId),
+                addOptions: input.addOptions,
+                logFirst: [`delegated by ${actor}`],
+            });
+            return { ticket: started.ticket, workItem: started.workItem, project, createdTicket: false };
+        }
+        const teamId = choice.teamId;
+        const brief = workItem.briefMarkdown || workItem.description || '';
+        // A ticket store that cannot be written must not stop delegation itself:
+        // the WorkItem is then added as before, without a ticket.
+        let created;
+        try {
+            created = await this.tickets.create(project.path, project.name, {
+                title: delegationTicketTitle(workItem.title),
+                description: brief,
+                team: teamId,
+                priority: normalizeProjectTicketPriority(workItem.metadata?.priority) ?? undefined,
+                status: 'backlog',
+                source: callerSession ? `agent:${callerSession}` : 'owner',
+                requestId: workItem.requestId ?? null,
+            }, actor);
+        }
+        catch (err) {
+            this.logger.warn('Could not create a ticket for a delegation; adding the WorkItem without one', {
+                projectPath: project.path,
+                workItemId: workItem.id,
+                error: err instanceof Error ? err.message : String(err),
+            });
+            return null;
+        }
+        try {
+            const started = await this.startWork(project, created.id, target, actor, teamId, {
+                self: false,
+                allowed: ['backlog'],
+                prepared: (t) => this.linkDelegatedItem(workItem, project, t, teamId),
+                addOptions: input.addOptions,
+                logFirst: [`created from delegation by ${actor}`],
+            });
+            this.logger.info('Delegation routed through a new project ticket', { projectPath: project.path, id: created.id, workItemId: started.workItem.id });
+            return { ticket: started.ticket, workItem: started.workItem, project, createdTicket: true };
+        }
+        catch (err) {
+            // The delegation did not start: do not leave an orphan backlog ticket behind.
+            await this.tickets
+                .transition(project.path, created.id, 'cancelled', 'crewly', `delegation could not start: ${err instanceof Error ? err.message : String(err)}`)
+                .catch(() => undefined);
+            throw err;
+        }
+    }
+    /**
+     * Link a live WorkItem that is already in flight to a ticket (spec §11).
+     *
+     * The ticket must not be done/cancelled and must have no other live
+     * WorkItem; the WorkItem must be live and carry no other ticket. The item
+     * gets `metadata.projectTicket`; the ticket becomes `in_progress` (a ticket
+     * in `review` stays there), assignee = the item's target, workItemId set.
+     *
+     * @param ref - Project reference
+     * @param id - Ticket id
+     * @param workItemId - The live WorkItem
+     * @param caller - Owner, orchestrator or a lead of a project team
+     * @returns Updated ticket and WorkItem
+     * @throws ProjectTicketError(400/403/404/409)
+     */
+    async link(ref, id, workItemId, caller) {
+        const project = await this.resolveProject(ref);
+        const { access } = await this.accessOf(caller, project);
+        this.requireAccess(access, ['owner', 'orchestrator', 'lead'], 'link WorkItems to tickets');
+        const wiId = String(workItemId ?? '').trim();
+        if (!wiId)
+            throw new ProjectTicketError(400, 'workItemId is required');
+        const actor = this.actorName(caller);
+        let linked = null;
+        let wroteMetadata = false;
+        try {
+            const ticket = await this.tickets.mutate(project.path, id, actor, async (t) => {
+                if (t.status === 'done' || t.status === 'cancelled') {
+                    throw new ProjectTicketError(409, `${t.id} is ${t.status}; reopen it before linking work to it`);
+                }
+                const wi = await this.pool.findWorkItem(wiId);
+                if (!wi)
+                    throw new ProjectTicketError(404, `WorkItem not found: ${wiId}`);
+                if (!LIVE_STATUSES.has(wi.status))
+                    throw new ProjectTicketError(409, `WorkItem ${wi.id} is ${wi.status}; only live work can be linked`);
+                const existing = readProjectTicketLink(wi.metadata);
+                const sameTicket = !!existing && existing.id === t.id && path.resolve(existing.projectPath) === path.resolve(project.path);
+                if (existing && !sameTicket)
+                    throw new ProjectTicketError(409, `WorkItem ${wi.id} already works ticket ${existing.id}`);
+                const live = await this.findLiveLinkedWorkItem(project.path, t);
+                if (live && live.id !== wi.id)
+                    throw new ProjectTicketError(409, `${t.id} is already being worked in WorkItem ${live.id}`);
+                linked = wi;
+                if (sameTicket && t.workItemId === wi.id)
+                    return null;
+                if (!sameTicket) {
+                    const updated = await this.pool.mergeItemMetadata(wi.id, {
+                        [PROJECT_TICKET_CONSTANTS.WORK_ITEM_METADATA_KEY]: { projectPath: project.path, id: t.id },
+                    });
+                    if (!updated)
+                        throw new ProjectTicketError(404, `WorkItem not found: ${wi.id}`);
+                    wroteMetadata = true;
+                    linked = updated;
+                }
+                const status = t.status === 'review' ? 'review' : 'in_progress';
+                return {
+                    fields: { status, workItemId: wi.id, ...(wi.target ? { assignee: wi.target } : {}) },
+                    log: [`linked to WorkItem ${wi.id} (${wi.status}${wi.target ? `, ${wi.target}` : ''}) by ${actor}`],
+                };
+            });
+            this.logger.info('Project ticket linked to a WorkItem', { projectPath: project.path, id, workItemId: wiId });
+            return { ticket, workItem: linked };
+        }
+        catch (err) {
+            if (wroteMetadata) {
+                await this.pool.mergeItemMetadata(wiId, { [PROJECT_TICKET_CONSTANTS.WORK_ITEM_METADATA_KEY]: undefined }).catch(() => undefined);
+            }
+            throw err;
+        }
+    }
+    // ---------------------------------------------------------------------------
     // Sync (WorkItem → ticket)
     // ---------------------------------------------------------------------------
     /**
@@ -631,11 +810,14 @@ export class ProjectTicketWorkflowService {
                 const live = await this.findLiveLinkedWorkItem(project.path, t);
                 if (live)
                     throw new ProjectTicketError(409, `${t.id} is already being worked in WorkItem ${live.id}`);
-                created = this.buildWorkItem(project, t, assignee, teamId);
-                await this.pool.addToPool(created);
+                created = options.prepared ? options.prepared(t) : this.buildWorkItem(project, t, assignee, teamId);
+                await this.pool.addToPool(created, options.addOptions);
                 return {
                     fields: { status: 'in_progress', assignee, workItemId: created.id },
-                    log: [options.self ? `claimed by ${assignee} — WorkItem ${created.id}` : `assigned to ${assignee} — WorkItem ${created.id}`],
+                    log: [
+                        ...(options.logFirst ?? []),
+                        options.self ? `claimed by ${assignee} — WorkItem ${created.id}` : `assigned to ${assignee} — WorkItem ${created.id}`,
+                    ],
                 };
             });
         }
@@ -797,6 +979,75 @@ export class ProjectTicketWorkflowService {
             this.logger.warn('Could not cancel the linked WorkItem', { workItemId, error: err instanceof Error ? err.message : String(err) });
         }
     }
+    /**
+     * Projects an agent's (non-archived) teams work on, with the team.
+     *
+     * @param session - Agent session
+     * @returns One entry per project (first team wins)
+     */
+    async projectsOfAgent(session) {
+        const teams = (await this.directory.getTeams()).filter((t) => !t.archived && (t.members ?? []).some((m) => isSession(m, session)));
+        if (teams.length === 0)
+            return [];
+        const projects = await this.directory.getProjects();
+        const out = [];
+        for (const team of teams) {
+            for (const pid of team.projectIds ?? []) {
+                const project = projects.find((p) => p.id === pid);
+                if (project && !out.some((o) => o.project.id === pid))
+                    out.push({ project, teamId: team.id });
+            }
+        }
+        return out;
+    }
+    /**
+     * Which of the target's projects a delegation belongs to: the one matching
+     * the item's `metadata.projectPath`, else the only one, else (with a
+     * ticket id) the one holding that ticket.
+     *
+     * @param candidates - Target's projects
+     * @param wi - Delegated WorkItem
+     * @param ticketId - Explicit ticket, if any
+     * @returns The choice, or null when it cannot be told
+     */
+    async pickDelegationProject(candidates, wi, ticketId) {
+        const wanted = typeof wi.metadata?.projectPath === 'string' && wi.metadata.projectPath ? path.resolve(wi.metadata.projectPath) : null;
+        const byPath = wanted ? candidates.find((c) => path.resolve(c.project.path) === wanted) : undefined;
+        if (ticketId) {
+            const ordered = byPath ? [byPath, ...candidates.filter((c) => c !== byPath)] : candidates;
+            for (const c of ordered) {
+                if (await this.tickets.get(c.project.path, ticketId).catch(() => null))
+                    return c;
+            }
+            return null;
+        }
+        if (byPath)
+            return byPath;
+        return candidates.length === 1 ? candidates[0] : null;
+    }
+    /**
+     * The delegated WorkItem with the ticket link added; every other field is
+     * kept as the delegator built it.
+     *
+     * @param wi - Delegated WorkItem
+     * @param project - Project
+     * @param t - Ticket
+     * @param teamId - Target's team on the project
+     * @returns WorkItem to add
+     */
+    linkDelegatedItem(wi, project, t, teamId) {
+        const meta = wi.metadata ?? {};
+        return {
+            ...wi,
+            metadata: {
+                ...meta,
+                [PROJECT_TICKET_CONSTANTS.WORK_ITEM_METADATA_KEY]: { projectPath: project.path, id: t.id },
+                ...(meta.projectId ? {} : { projectId: project.id }),
+                ...(meta.projectPath ? {} : { projectPath: project.path }),
+                ...(meta.teamId ? {} : { teamId }),
+            },
+        };
+    }
     /**
      * The team an agent would work a ticket for, or null when it may not.
      *