crewly 1.20.181 → 1.20.183

package/dist/cli/backend/src/services/orc/work-item-destination.d.ts

@@ -0,0 +1,198 @@
+/**
+ * Where an agent's answer goes, decided by the WORK it is answering
+ * (specs/2026-10-01-decision-cards.md §6).
+ *
+ * Incident: Atlas posted the output of a scheduled task ("steveswiki 第一次季度
+ * 回看…") into an unrelated #pro-think-tank thread. The 1.20.170 `reply` sent
+ * every answer to "the thread the agent was last asked in", and a cron run
+ * has no asker — so the last owner thread, however old, won.
+ *
+ * Now each work item carries its own origin and the answer follows it:
+ *
+ * | Work | Destination |
+ * |---|---|
+ * | owner asked (newest, < 2 h) | that conversation / thread (turn origin) |
+ * | ticket work | the ticket's Slack thread (created on first post) |
+ * | trigger / cron / auto work | the trigger's `destination`, else a NEW top-level post in the team channel |
+ * | no current work | a NEW top-level post in the team channel |
+ *
+ * Pure functions only; the effects live in `work-item-destination.wiring.ts`.
+ *
+ * @module services/orc/work-item-destination
+ */
+import type { WorkItem } from '../../types/v2/work-item.types.js';
+import type { TurnOrigin } from './orc-reply-route.service.js';
+/** The origin a work item carries in `metadata.origin`. */
+export type WorkItemOrigin = 
+/** Asked by the owner in a conversation / Slack thread */
+{
+    kind: 'owner';
+    conversationId?: string;
+    slackChannelId?: string;
+    threadTs?: string;
+    chatThreadId?: string;
+}
+/** Work on a project ticket */
+ | {
+    kind: 'ticket';
+    projectPath: string;
+    ticketId: string;
+    title?: string;
+    teamId?: string;
+}
+/** Fired by a trigger or a cron task */
+ | {
+    kind: 'trigger';
+    triggerId?: string;
+    cronTaskId?: string;
+    destination?: string;
+    teamId?: string;
+    topic: string;
+};
+/** Where the answer goes. */
+export type WorkDestination = 
+/** The owner's turn origin — the existing `reply` path */
+{
+    kind: 'owner-origin';
+    origin: TurnOrigin;
+    reason: string;
+}
+/** The ticket's Slack thread (created with a `*ID · title*` root when missing) */
+ | {
+    kind: 'ticket-thread';
+    projectPath: string;
+    ticketId: string;
+    title?: string;
+    teamId?: string;
+    reason: string;
+}
+/** An explicit Slack place (a trigger's destination): channel name/id, optional thread */
+ | {
+    kind: 'slack';
+    target: string;
+    threadTs?: string;
+    topic?: string;
+    reason: string;
+}
+/** A new top-level post in the agent's (or the work's) team channel */
+ | {
+    kind: 'new-top-level';
+    teamId?: string;
+    topic?: string;
+    reason: string;
+};
+/**
+ * Build the origin stamped on a trigger- or cron-created work item.
+ *
+ * @param input - Trigger/cron ids, its destination, team and a topic
+ * @returns The origin (topic shortened to one line)
+ */
+export declare function buildTriggerOrigin(input: {
+    triggerId?: string;
+    cronTaskId?: string;
+    destination?: string;
+    teamId?: string;
+    topic: string;
+}): WorkItemOrigin;
+/**
+ * One-line topic, capped at {@link WORK_ITEM_DESTINATION_CONSTANTS.TOPIC_MAX_CHARS}.
+ *
+ * @param text - Any text
+ * @returns Single line, possibly shortened with an ellipsis
+ */
+export declare function shortTopic(text: string | undefined): string;
+/**
+ * The agent's current work item: the newest (by start) item targeted at it
+ * that is running or accepted.
+ *
+ * @param items - Pool items
+ * @param session - Agent session
+ * @returns The item, or null
+ */
+export declare function currentWorkItemOf(items: readonly WorkItem[], session: string): WorkItem | null;
+/**
+ * The origin of a work item: its stamped `metadata.origin`, else what its
+ * other fields say (a linked project ticket, a trigger, a cron task).
+ *
+ * @param wi - Work item
+ * @returns The origin, or null when nothing tells where it came from
+ */
+export declare function originOfWorkItem(wi: WorkItem): WorkItemOrigin | null;
+/**
+ * The origin an owner turn gives the work started from it.
+ *
+ * @param turn - The owner's turn origin (OrcReplyRouteService)
+ * @returns An owner origin
+ */
+export declare function ownerOriginFromTurn(turn: TurnOrigin): WorkItemOrigin;
+/** Inputs of {@link inheritedOrigin}. */
+export interface InheritOriginInput {
+    /** The item being created */
+    workItem: WorkItem;
+    /** The item it continues (verify / retry / subtask parent), when it has one */
+    parent: WorkItem | null;
+    /** Where the creating agent's current work came from (its plan), when an agent creates it */
+    creatorDestination: WorkDestination | null;
+    /** The creating agent's current work item */
+    creatorWorkItem: WorkItem | null;
+}
+/**
+ * The origin a new work item inherits (owner request → delegate → verify /
+ * retry / subtask). Incident 2026-10-01: Atlas delegated the owner's
+ * #morning-brief question to Sage; Sage's [DONE] made a verify item for
+ * Atlas with no origin, and the answer's file landed in an unrelated thread.
+ *
+ * Order: an origin already stamped wins (null = keep it); then the parent's;
+ * then the creator's current owner request; then the creator's current
+ * work item's.
+ *
+ * @param input - New item, its parent, the creator's current work
+ * @returns The origin to stamp, or null (nothing to inherit / already stamped)
+ */
+export declare function inheritedOrigin(input: InheritOriginInput): WorkItemOrigin | null;
+/**
+ * Shape check for a stamped origin.
+ *
+ * @param value - Anything
+ * @returns True for a {@link WorkItemOrigin}
+ */
+export declare function isWorkItemOrigin(value: unknown): value is WorkItemOrigin;
+/**
+ * Split a trigger destination into a post target and an optional thread.
+ *
+ * @param destination - `#name`, `C…` or `C…:<ts>`
+ * @returns Target + thread, or null when unreadable
+ */
+export declare function parseDestination(destination: string): {
+    target: string;
+    threadTs?: string;
+} | null;
+/** Inputs of {@link planWorkDestination}. */
+export interface WorkDestinationInput {
+    /** The agent's current work item (see {@link currentWorkItemOf}) */
+    workItem: WorkItem | null;
+    /** The agent's last owner turn origin (OrcReplyRouteService) */
+    ownerOrigin?: TurnOrigin;
+    /** Clock (epoch ms) */
+    now: number;
+}
+/**
+ * Decide where the answer to the agent's current work goes.
+ *
+ * The current work is the newer of the running work item and the last owner
+ * message — the owner message only counts while it is fresh
+ * ({@link WORK_ITEM_DESTINATION_CONSTANTS.OWNER_ORIGIN_FRESH_MS}).
+ *
+ * @param input - Current work item, owner origin, clock
+ * @returns The destination
+ */
+export declare function planWorkDestination(input: WorkDestinationInput): WorkDestination;
+/**
+ * The text of a new top-level post: the topic line in bold, then the body.
+ *
+ * @param topic - Topic (may be empty)
+ * @param text - Body
+ * @returns Post text
+ */
+export declare function withTopicLine(topic: string | undefined, text: string): string;
+//# sourceMappingURL=work-item-destination.d.ts.map

package/dist/cli/backend/src/services/orc/work-item-destination.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"work-item-destination.d.ts","sourceRoot":"","sources":["../../../../../../backend/src/services/orc/work-item-destination.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;GAqBG;AAGH,OAAO,KAAK,EAAE,QAAQ,EAAkB,MAAM,mCAAmC,CAAC;AAClF,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,8BAA8B,CAAC;AAG/D,2DAA2D;AAC3D,MAAM,MAAM,cAAc;AACxB,0DAA0D;AACxD;IAAE,IAAI,EAAE,OAAO,CAAC;IAAC,cAAc,CAAC,EAAE,MAAM,CAAC;IAAC,cAAc,CAAC,EAAE,MAAM,CAAC;IAAC,QAAQ,CAAC,EAAE,MAAM,CAAC;IAAC,YAAY,CAAC,EAAE,MAAM,CAAA;CAAE;AAC/G,+BAA+B;GAC7B;IAAE,IAAI,EAAE,QAAQ,CAAC;IAAC,WAAW,EAAE,MAAM,CAAC;IAAC,QAAQ,EAAE,MAAM,CAAC;IAAC,KAAK,CAAC,EAAE,MAAM,CAAC;IAAC,MAAM,CAAC,EAAE,MAAM,CAAA;CAAE;AAC5F,wCAAwC;GACtC;IAAE,IAAI,EAAE,SAAS,CAAC;IAAC,SAAS,CAAC,EAAE,MAAM,CAAC;IAAC,UAAU,CAAC,EAAE,MAAM,CAAC;IAAC,WAAW,CAAC,EAAE,MAAM,CAAC;IAAC,MAAM,CAAC,EAAE,MAAM,CAAC;IAAC,KAAK,EAAE,MAAM,CAAA;CAAE,CAAC;AAEvH,6BAA6B;AAC7B,MAAM,MAAM,eAAe;AACzB,0DAA0D;AACxD;IAAE,IAAI,EAAE,cAAc,CAAC;IAAC,MAAM,EAAE,UAAU,CAAC;IAAC,MAAM,EAAE,MAAM,CAAA;CAAE;AAC9D,kFAAkF;GAChF;IAAE,IAAI,EAAE,eAAe,CAAC;IAAC,WAAW,EAAE,MAAM,CAAC;IAAC,QAAQ,EAAE,MAAM,CAAC;IAAC,KAAK,CAAC,EAAE,MAAM,CAAC;IAAC,MAAM,CAAC,EAAE,MAAM,CAAC;IAAC,MAAM,EAAE,MAAM,CAAA;CAAE;AACnH,0FAA0F;GACxF;IAAE,IAAI,EAAE,OAAO,CAAC;IAAC,MAAM,EAAE,MAAM,CAAC;IAAC,QAAQ,CAAC,EAAE,MAAM,CAAC;IAAC,KAAK,CAAC,EAAE,MAAM,CAAC;IAAC,MAAM,EAAE,MAAM,CAAA;CAAE;AACtF,uEAAuE;GACrE;IAAE,IAAI,EAAE,eAAe,CAAC;IAAC,MAAM,CAAC,EAAE,MAAM,CAAC;IAAC,KAAK,CAAC,EAAE,MAAM,CAAC;IAAC,MAAM,EAAE,MAAM,CAAA;CAAE,CAAC;AAK/E;;;;;GAKG;AACH,wBAAgB,kBAAkB,CAAC,KAAK,EAAE;IACxC,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,KAAK,EAAE,MAAM,CAAC;CACf,GAAG,cAAc,CASjB;AAED;;;;;GAKG;AACH,wBAAgB,UAAU,CAAC,IAAI,EAAE,MAAM,GAAG,SAAS,GAAG,MAAM,CAI3D;AAED;;;;;;;GAOG;AACH,wBAAgB,iBAAiB,CAAC,KAAK,EAAE,SAAS,QAAQ,EAAE,EAAE,OAAO,EAAE,MAAM,GAAG,QAAQ,GAAG,IAAI,CAY9F;AAYD;;;;;;GAMG;AACH,wBAAgB,gBAAgB,CAAC,EAAE,EAAE,QAAQ,GAAG,cAAc,GAAG,IAAI,CAsBpE;AAED;;;;;GAKG;AACH,wBAAgB,mBAAmB,CAAC,IAAI,EAAE,UAAU,GAAG,cAAc,CAWpE;AAED,yCAAyC;AACzC,MAAM,WAAW,kBAAkB;IACjC,6BAA6B;IAC7B,QAAQ,EAAE,QAAQ,CAAC;IACnB,+EAA+E;IAC/E,MAAM,EAAE,QAAQ,GAAG,IAAI,CAAC;IACxB,6FAA6F;IAC7F,kBAAkB,EAAE,eAAe,GAAG,IAAI,CAAC;IAC3C,6CAA6C;IAC7C,eAAe,EAAE,QAAQ,GAAG,IAAI,CAAC;CAClC;AAED;;;;;;;;;;;;GAYG;AACH,wBAAgB,eAAe,CAAC,KAAK,EAAE,kBAAkB,GAAG,cAAc,GAAG,IAAI,CAWhF;AAED;;;;;GAKG;AACH,wBAAgB,gBAAgB,CAAC,KAAK,EAAE,OAAO,GAAG,KAAK,IAAI,cAAc,CAOxE;AAED;;;;;GAKG;AACH,wBAAgB,gBAAgB,CAAC,WAAW,EAAE,MAAM,GAAG;IAAE,MAAM,EAAE,MAAM,CAAC;IAAC,QAAQ,CAAC,EAAE,MAAM,CAAA;CAAE,GAAG,IAAI,CAOlG;AAED,6CAA6C;AAC7C,MAAM,WAAW,oBAAoB;IACnC,oEAAoE;IACpE,QAAQ,EAAE,QAAQ,GAAG,IAAI,CAAC;IAC1B,gEAAgE;IAChE,WAAW,CAAC,EAAE,UAAU,CAAC;IACzB,uBAAuB;IACvB,GAAG,EAAE,MAAM,CAAC;CACb;AAED;;;;;;;;;GASG;AACH,wBAAgB,mBAAmB,CAAC,KAAK,EAAE,oBAAoB,GAAG,eAAe,CA8DhF;AAED;;;;;;GAMG;AACH,wBAAgB,aAAa,CAAC,KAAK,EAAE,MAAM,GAAG,SAAS,EAAE,IAAI,EAAE,MAAM,GAAG,MAAM,CAM7E"}

package/dist/cli/backend/src/services/orc/work-item-destination.js

@@ -0,0 +1,288 @@
+/**
+ * Where an agent's answer goes, decided by the WORK it is answering
+ * (specs/2026-10-01-decision-cards.md §6).
+ *
+ * Incident: Atlas posted the output of a scheduled task ("steveswiki 第一次季度
+ * 回看…") into an unrelated #pro-think-tank thread. The 1.20.170 `reply` sent
+ * every answer to "the thread the agent was last asked in", and a cron run
+ * has no asker — so the last owner thread, however old, won.
+ *
+ * Now each work item carries its own origin and the answer follows it:
+ *
+ * | Work | Destination |
+ * |---|---|
+ * | owner asked (newest, < 2 h) | that conversation / thread (turn origin) |
+ * | ticket work | the ticket's Slack thread (created on first post) |
+ * | trigger / cron / auto work | the trigger's `destination`, else a NEW top-level post in the team channel |
+ * | no current work | a NEW top-level post in the team channel |
+ *
+ * Pure functions only; the effects live in `work-item-destination.wiring.ts`.
+ *
+ * @module services/orc/work-item-destination
+ */
+import { WORK_ITEM_DESTINATION_CONSTANTS } from '../../constants.js';
+import { parseSlackThreadKey } from '../slack/slack-thread-key.js';
+/** Statuses in which a work item is the agent's current work. */
+const CURRENT_STATUSES = new Set(['running', 'accepted']);
+/**
+ * Build the origin stamped on a trigger- or cron-created work item.
+ *
+ * @param input - Trigger/cron ids, its destination, team and a topic
+ * @returns The origin (topic shortened to one line)
+ */
+export function buildTriggerOrigin(input) {
+    return {
+        kind: 'trigger',
+        ...(input.triggerId ? { triggerId: input.triggerId } : {}),
+        ...(input.cronTaskId ? { cronTaskId: input.cronTaskId } : {}),
+        ...(input.destination?.trim() ? { destination: input.destination.trim() } : {}),
+        ...(input.teamId ? { teamId: input.teamId } : {}),
+        topic: shortTopic(input.topic),
+    };
+}
+/**
+ * One-line topic, capped at {@link WORK_ITEM_DESTINATION_CONSTANTS.TOPIC_MAX_CHARS}.
+ *
+ * @param text - Any text
+ * @returns Single line, possibly shortened with an ellipsis
+ */
+export function shortTopic(text) {
+    const flat = String(text ?? '').replace(/\s+/g, ' ').trim();
+    const max = WORK_ITEM_DESTINATION_CONSTANTS.TOPIC_MAX_CHARS;
+    return flat.length > max ? `${flat.slice(0, max - 1)}…` : flat;
+}
+/**
+ * The agent's current work item: the newest (by start) item targeted at it
+ * that is running or accepted.
+ *
+ * @param items - Pool items
+ * @param session - Agent session
+ * @returns The item, or null
+ */
+export function currentWorkItemOf(items, session) {
+    let best = null;
+    let bestAt = -Infinity;
+    for (const wi of items) {
+        if (wi.target !== session || !CURRENT_STATUSES.has(wi.status))
+            continue;
+        const at = startOf(wi);
+        if (at > bestAt) {
+            best = wi;
+            bestAt = at;
+        }
+    }
+    return best;
+}
+/**
+ * When a work item started (else when it was created).
+ *
+ * @param wi - Work item
+ * @returns Epoch ms (0 when unreadable)
+ */
+function startOf(wi) {
+    return Date.parse(wi.startedAt ?? '') || Date.parse(wi.createdAt) || 0;
+}
+/**
+ * The origin of a work item: its stamped `metadata.origin`, else what its
+ * other fields say (a linked project ticket, a trigger, a cron task).
+ *
+ * @param wi - Work item
+ * @returns The origin, or null when nothing tells where it came from
+ */
+export function originOfWorkItem(wi) {
+    const meta = (wi.metadata ?? {});
+    const stamped = meta[WORK_ITEM_DESTINATION_CONSTANTS.METADATA_KEY];
+    if (isWorkItemOrigin(stamped))
+        return stamped;
+    const link = meta.projectTicket;
+    if (link && typeof link.projectPath === 'string' && typeof link.id === 'string') {
+        return {
+            kind: 'ticket',
+            projectPath: link.projectPath,
+            ticketId: link.id,
+            ...(typeof meta.teamId === 'string' ? { teamId: meta.teamId } : {}),
+        };
+    }
+    if (wi.triggerId)
+        return buildTriggerOrigin({ triggerId: wi.triggerId, topic: wi.title });
+    if (meta.source === 'cron') {
+        return buildTriggerOrigin({
+            ...(typeof meta.cronTaskId === 'string' ? { cronTaskId: meta.cronTaskId } : {}),
+            ...(typeof meta.targetTeamId === 'string' ? { teamId: meta.targetTeamId } : {}),
+            topic: wi.description ?? wi.title,
+        });
+    }
+    return null;
+}
+/**
+ * The origin an owner turn gives the work started from it.
+ *
+ * @param turn - The owner's turn origin (OrcReplyRouteService)
+ * @returns An owner origin
+ */
+export function ownerOriginFromTurn(turn) {
+    const key = parseSlackThreadKey(turn.slackThreadKey);
+    const slackChannelId = key?.slackChannelId ?? turn.slackChannelId;
+    const threadTs = key?.threadTs ?? turn.slackThreadTs;
+    return {
+        kind: 'owner',
+        conversationId: turn.conversationId,
+        ...(slackChannelId ? { slackChannelId } : {}),
+        ...(threadTs ? { threadTs } : {}),
+        ...(turn.chatThreadId ? { chatThreadId: turn.chatThreadId } : {}),
+    };
+}
+/**
+ * The origin a new work item inherits (owner request → delegate → verify /
+ * retry / subtask). Incident 2026-10-01: Atlas delegated the owner's
+ * #morning-brief question to Sage; Sage's [DONE] made a verify item for
+ * Atlas with no origin, and the answer's file landed in an unrelated thread.
+ *
+ * Order: an origin already stamped wins (null = keep it); then the parent's;
+ * then the creator's current owner request; then the creator's current
+ * work item's.
+ *
+ * @param input - New item, its parent, the creator's current work
+ * @returns The origin to stamp, or null (nothing to inherit / already stamped)
+ */
+export function inheritedOrigin(input) {
+    const meta = (input.workItem.metadata ?? {});
+    if (isWorkItemOrigin(meta[WORK_ITEM_DESTINATION_CONSTANTS.METADATA_KEY]))
+        return null;
+    if (input.parent) {
+        const fromParent = originOfWorkItem(input.parent);
+        if (fromParent)
+            return fromParent;
+    }
+    const dest = input.creatorDestination;
+    if (dest?.kind === 'owner-origin')
+        return ownerOriginFromTurn(dest.origin);
+    if (input.creatorWorkItem)
+        return originOfWorkItem(input.creatorWorkItem);
+    return null;
+}
+/**
+ * Shape check for a stamped origin.
+ *
+ * @param value - Anything
+ * @returns True for a {@link WorkItemOrigin}
+ */
+export function isWorkItemOrigin(value) {
+    if (!value || typeof value !== 'object')
+        return false;
+    const v = value;
+    if (v.kind === 'owner')
+        return true;
+    if (v.kind === 'ticket')
+        return typeof v.projectPath === 'string' && typeof v.ticketId === 'string';
+    if (v.kind === 'trigger')
+        return typeof v.topic === 'string';
+    return false;
+}
+/**
+ * Split a trigger destination into a post target and an optional thread.
+ *
+ * @param destination - `#name`, `C…` or `C…:<ts>`
+ * @returns Target + thread, or null when unreadable
+ */
+export function parseDestination(destination) {
+    const d = destination.trim();
+    const thread = /^([CG][A-Z0-9]{6,}):(\d{6,}\.\d+)$/.exec(d);
+    if (thread)
+        return { target: thread[1], threadTs: thread[2] };
+    if (/^[CG][A-Z0-9]{6,}$/.test(d))
+        return { target: d };
+    if (/^#[a-z0-9][a-z0-9._-]*$/.test(d))
+        return { target: d };
+    return null;
+}
+/**
+ * Decide where the answer to the agent's current work goes.
+ *
+ * The current work is the newer of the running work item and the last owner
+ * message — the owner message only counts while it is fresh
+ * ({@link WORK_ITEM_DESTINATION_CONSTANTS.OWNER_ORIGIN_FRESH_MS}).
+ *
+ * @param input - Current work item, owner origin, clock
+ * @returns The destination
+ */
+export function planWorkDestination(input) {
+    const { workItem, ownerOrigin, now } = input;
+    const ownerFresh = !!ownerOrigin && now - ownerOrigin.receivedAt < WORK_ITEM_DESTINATION_CONSTANTS.OWNER_ORIGIN_FRESH_MS;
+    if (ownerOrigin && ownerFresh && (!workItem || ownerOrigin.receivedAt >= startOf(workItem))) {
+        return { kind: 'owner-origin', origin: ownerOrigin, reason: workItem ? 'the owner asked after the work item started' : 'the owner asked (no work item running)' };
+    }
+    if (!workItem) {
+        return { kind: 'new-top-level', reason: ownerOrigin ? 'no current work; the last owner message is stale' : 'no current work' };
+    }
+    const origin = originOfWorkItem(workItem);
+    if (!origin) {
+        return { kind: 'new-top-level', topic: shortTopic(workItem.title), reason: `work item ${workItem.id} has no recorded origin` };
+    }
+    switch (origin.kind) {
+        case 'owner': {
+            if (origin.conversationId) {
+                const threadKey = origin.slackChannelId && origin.threadTs ? `${origin.slackChannelId}:${origin.threadTs}` : undefined;
+                return {
+                    kind: 'owner-origin',
+                    origin: {
+                        conversationId: origin.conversationId,
+                        ...(origin.slackChannelId ? { slackChannelId: origin.slackChannelId } : {}),
+                        ...(origin.threadTs ? { slackThreadTs: origin.threadTs } : {}),
+                        ...(threadKey ? { slackThreadKey: threadKey } : {}),
+                        ...(origin.chatThreadId ? { chatThreadId: origin.chatThreadId } : {}),
+                        receivedAt: startOf(workItem),
+                    },
+                    reason: `work item ${workItem.id} was asked by the owner`,
+                };
+            }
+            if (origin.slackChannelId) {
+                return { kind: 'slack', target: origin.slackChannelId, ...(origin.threadTs ? { threadTs: origin.threadTs } : {}), reason: `work item ${workItem.id} was asked by the owner in Slack` };
+            }
+            return { kind: 'new-top-level', topic: shortTopic(workItem.title), reason: `work item ${workItem.id} owner origin has no place` };
+        }
+        case 'ticket':
+            return {
+                kind: 'ticket-thread',
+                projectPath: origin.projectPath,
+                ticketId: origin.ticketId,
+                ...(origin.title ? { title: origin.title } : {}),
+                ...(origin.teamId ? { teamId: origin.teamId } : {}),
+                reason: `work item ${workItem.id} is ticket ${origin.ticketId}`,
+            };
+        case 'trigger': {
+            const parsed = origin.destination ? parseDestination(origin.destination) : null;
+            if (parsed) {
+                return {
+                    kind: 'slack',
+                    target: parsed.target,
+                    ...(parsed.threadTs ? { threadTs: parsed.threadTs } : { topic: origin.topic }),
+                    reason: `scheduled work item ${workItem.id}: its trigger's destination`,
+                };
+            }
+            return {
+                kind: 'new-top-level',
+                ...(origin.teamId ? { teamId: origin.teamId } : {}),
+                topic: origin.topic,
+                reason: `scheduled work item ${workItem.id}: new top-level post`,
+            };
+        }
+    }
+}
+/**
+ * The text of a new top-level post: the topic line in bold, then the body.
+ *
+ * @param topic - Topic (may be empty)
+ * @param text - Body
+ * @returns Post text
+ */
+export function withTopicLine(topic, text) {
+    const t = shortTopic(topic);
+    if (!t)
+        return text;
+    // An agent that already opened with the topic needs no second copy.
+    if (text.trimStart().startsWith(`*${t}*`))
+        return text;
+    return `*${t}*\n${text}`;
+}
+//# sourceMappingURL=work-item-destination.js.map

package/dist/cli/backend/src/services/orc/work-item-destination.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"work-item-destination.js","sourceRoot":"","sources":["../../../../../../backend/src/services/orc/work-item-destination.ts"],"names":[],"mappings":"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"}

package/dist/cli/backend/src/services/runtime-fallback/runtime-fallback.types.d.ts

@@ -0,0 +1,136 @@
+/**
+ * Runtime fallback — shared types, settings defaults and validation.
+ *
+ * specs/2026-10-01-runtime-fallback.md
+ *
+ * @module services/runtime-fallback/runtime-fallback.types
+ */
+/** Every runtime id Crewly knows. */
+export declare const KNOWN_RUNTIMES: readonly string[];
+/** Why an agent runs on a runtime other than its configured one. */
+export type RuntimeOverrideReason = 'usage_limit';
+/**
+ * An agent temporarily running on another runtime. The member's configured
+ * runtime (`primary`) is never changed.
+ */
+export interface RuntimeOverride {
+    /** Runtime the agent runs on now */
+    runtime: string;
+    /** The member's configured runtime */
+    primary: string;
+    reason: RuntimeOverrideReason;
+    /** ISO time the override started */
+    since: string;
+    /** ISO time the primary is expected back, when known */
+    until?: string;
+    /** Conversation id of the primary, restored when switching back */
+    primarySessionId?: string;
+    /** The primary is back; revert at the next idle boundary */
+    revertPending?: boolean;
+}
+/** A runtime that is out of usage on this machine (account-wide). */
+export interface ExhaustedRuntime {
+    runtime: string;
+    /** ISO time it was detected */
+    since: string;
+    /** ISO time it resets, when known (never for `billing`) */
+    until?: string;
+    /**
+     * `usage_limit` (a window that resets) or `billing` (out of money/credit:
+     * no timed retry, probed at most every BILLING_PROBE_INTERVAL_MS).
+     * Missing = `usage_limit` (state from before the field existed).
+     */
+    kind?: 'usage_limit' | 'billing';
+    /** Switch-backs that failed (the limit came straight back); backs off the next probe */
+    failedReverts?: number;
+    /** Rule that matched (never contains output) */
+    ruleId: string;
+    /** Last switch-back probe (ISO) */
+    lastProbeAt?: string;
+    /** Sessions switched away during this event */
+    switched: string[];
+    /** Fallback runtimes those sessions went to */
+    switchedTo: string[];
+    /** The owner was told about this event */
+    notified: boolean;
+    /** No fallback was available for at least one agent */
+    noFallback?: boolean;
+}
+/** Owner-editable settings. */
+export interface RuntimeFallbackSettings {
+    enabled: boolean;
+    /** Global fallback order */
+    chain: string[];
+    /** Per-member chains, keyed by member id */
+    memberChains: Record<string, string[]>;
+    /** The orchestrator switches too */
+    orcFollows: boolean;
+    /** provider/model a Crewly Agent fallback runs */
+    crewlyAgentModel: string;
+    probeIntervalMinutes: number;
+}
+/** What is persisted. */
+export interface RuntimeFallbackState {
+    version: 1;
+    settings: RuntimeFallbackSettings;
+    exhausted: Record<string, ExhaustedRuntime>;
+    /** Active overrides, keyed by session name */
+    overrides: Record<string, RuntimeOverride>;
+}
+/** Availability of one runtime as a fallback target. */
+export interface RuntimeAvailability {
+    runtime: string;
+    label: string;
+    /** Installed and signed in (Crewly Agent: an API key for its model's provider) */
+    selectable: boolean;
+    /** Why not, when not selectable ("Not installed", "Not signed in", …) */
+    reason?: string;
+    /** Not selectable because its Terms are not accepted (the owner can still add it: that asks again) */
+    termsBlocked?: boolean;
+}
+/**
+ * Default settings.
+ *
+ * @returns A fresh copy
+ */
+export declare function defaultRuntimeFallbackSettings(): RuntimeFallbackSettings;
+/**
+ * Display name of a runtime.
+ *
+ * @param runtime - Runtime id
+ * @param crewlyAgentModel - Model a Crewly Agent runs (a DeepSeek model reads as "DeepSeek")
+ * @returns e.g. "Claude Code", "DeepSeek"
+ */
+export declare function runtimeLabel(runtime: string, crewlyAgentModel?: string): string;
+/**
+ * Short name of a runtime for "(Claude limit)".
+ *
+ * @param runtime - Runtime id
+ * @returns e.g. "Claude"
+ */
+export declare function runtimeShortLabel(runtime: string): string;
+/** A validation failure. */
+export declare class RuntimeFallbackSettingsError extends Error {
+}
+/**
+ * Apply a partial settings update.
+ *
+ * @param current - Current settings
+ * @param patch - Owner's update (untrusted)
+ * @returns New settings
+ * @throws RuntimeFallbackSettingsError when the patch is invalid
+ *
+ * @example
+ * ```ts
+ * applySettingsPatch(defaultRuntimeFallbackSettings(), { chain: ['claude-code', 'antigravity-cli'] });
+ * ```
+ */
+export declare function applySettingsPatch(current: RuntimeFallbackSettings, patch: unknown): RuntimeFallbackSettings;
+/**
+ * Settings read from disk, with defaults for anything missing or invalid.
+ *
+ * @param raw - Parsed JSON (untrusted)
+ * @returns Settings
+ */
+export declare function normalizeSettings(raw: unknown): RuntimeFallbackSettings;
+//# sourceMappingURL=runtime-fallback.types.d.ts.map

package/dist/cli/backend/src/services/runtime-fallback/runtime-fallback.types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"runtime-fallback.types.d.ts","sourceRoot":"","sources":["../../../../../../backend/src/services/runtime-fallback/runtime-fallback.types.ts"],"names":[],"mappings":"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"}