crewly 1.20.182 → 1.20.184

package/dist/cli/backend/src/services/orc/orc-status-routing.js

@@ -0,0 +1,145 @@
+/**
+ * Who an agent status report wakes (specs/2026-10-01-orc-status-wakes.md).
+ *
+ * Every `report-status` line used to be queued for the orchestrator. On
+ * 2026-09-29 that was 134 full-context orchestrator turns, almost all of them
+ * team members' [DONE] lines about work their own team lead owns and reviews.
+ * Now the report goes to whoever is responsible:
+ *
+ * | Report | Goes to |
+ * |---|---|
+ * | [IN_PROGRESS] [ACTIVE] [READY] [WORKING] [IDLE] … | recorded only |
+ * | [DONE] that a pending owner delivery is waiting for | orchestrator |
+ * | [DONE] on work the orchestrator delegated | orchestrator |
+ * | [DONE] on anyone else's work item | recorded (the lead's review path takes it) |
+ * | [DONE] with no work item | digest (actionable only without a lead) |
+ * | [BLOCKED] [FAILED] [ERROR] | the sender's lead; orchestrator when there is none or the lead sent it |
+ * | [MILESTONE] | orchestrator (it forwards milestones to the owner) |
+ * | other markers | digest (actionable only on orchestrator work or without a lead) |
+ * | no marker (an answer someone waits for) | orchestrator, as before |
+ *
+ * Pure functions only; {@link OrcStatusRouterService} carries out the plan.
+ *
+ * @module services/orc/orc-status-routing
+ */
+import { ORC_WAKE_CONSTANTS } from '../../constants.js';
+/**
+ * The bracketed marker a report starts with, upper-cased.
+ *
+ * @param content - Report text
+ * @returns e.g. `DONE`, or null when the text has no leading marker
+ */
+export function statusMarkerOf(content) {
+    const m = /^\s*\[([A-Za-z_ ]{2,40})\]/.exec(content ?? '');
+    return m ? m[1].trim().toUpperCase() : null;
+}
+/**
+ * Whether the orchestrator delegated (or created) a work item: its owner is
+ * the orchestrator, or the orchestrator stamped itself as the delegator.
+ *
+ * @param wi - Work item
+ * @param isOrchestrator - Orchestrator check
+ * @returns True for orchestrator work
+ */
+export function isOrcDelegated(wi, isOrchestrator) {
+    if (wi.owner === 'orchestrator')
+        return true;
+    const meta = (wi.metadata ?? {});
+    for (const key of ['delegatedBy', 'createdBy']) {
+        const v = meta[key];
+        if (typeof v === 'string' && v && isOrchestrator(v))
+            return true;
+    }
+    return false;
+}
+/**
+ * The work item a report is about: the one it names; else the sender's
+ * running/accepted item (newest); else the sender's most recently finished
+ * item, when it finished within {@link ORC_WAKE_CONSTANTS.RECENT_COMPLETION_MS}.
+ *
+ * `report-status` posts the line BEFORE it completes the item, so the
+ * running item is normally the answer.
+ *
+ * @param items - Pool items
+ * @param sender - Reporting agent
+ * @param workItemId - Id the report named, if any
+ * @param now - Clock (epoch ms)
+ * @returns The item, or null
+ */
+export function findStatusWorkItem(items, sender, workItemId, now) {
+    if (workItemId) {
+        const named = items.find((wi) => wi.id === workItemId);
+        if (named)
+            return named;
+    }
+    let running = null;
+    let runningAt = -Infinity;
+    let finished = null;
+    let finishedAt = -Infinity;
+    for (const wi of items) {
+        if (wi.target !== sender)
+            continue;
+        if (wi.status === 'running' || wi.status === 'accepted') {
+            const at = Date.parse(wi.startedAt ?? wi.createdAt) || 0;
+            if (at > runningAt) {
+                running = wi;
+                runningAt = at;
+            }
+            continue;
+        }
+        const doneAt = Date.parse(wi.completedAt ?? '') || 0;
+        if (doneAt && now - doneAt <= ORC_WAKE_CONSTANTS.RECENT_COMPLETION_MS && doneAt > finishedAt) {
+            finished = wi;
+            finishedAt = doneAt;
+        }
+    }
+    return running ?? finished;
+}
+/**
+ * Decide where one agent status report goes.
+ *
+ * @param input - Report, sender, its work item and lead
+ * @returns The route
+ */
+export function planOrcStatusRoute(input) {
+    const { content, sender, workItem, lead, senderIsLead, deliveryOwed, isOrchestrator } = input;
+    const marker = statusMarkerOf(content);
+    const hasLead = Boolean(lead) && lead !== sender && !isOrchestrator(String(lead));
+    if (ORC_WAKE_CONSTANTS.RECORD_ONLY_MARKERS.test(content)) {
+        return { action: 'record', reason: `progress marker [${marker}]` };
+    }
+    if (deliveryOwed) {
+        return { action: 'orc', category: 'owner', reason: 'the owner is waiting on the orchestrator to deliver this' };
+    }
+    if (!marker) {
+        return { action: 'orc', category: 'other', reason: 'not a status line — someone may be waiting for this answer' };
+    }
+    if (ORC_WAKE_CONSTANTS.ALWAYS_ORC_MARKERS.test(content)) {
+        return { action: 'orc', category: 'other', reason: `[${marker}] is forwarded to the owner by the orchestrator` };
+    }
+    const orcWork = workItem ? isOrcDelegated(workItem, isOrchestrator) : false;
+    if (ORC_WAKE_CONSTANTS.DONE_MARKERS.test(content)) {
+        if (workItem && orcWork) {
+            return { action: 'orc', category: 'delegated-done', reason: `work item ${workItem.id} was delegated by the orchestrator` };
+        }
+        if (workItem) {
+            return { action: 'record', reason: `work item ${workItem.id} is owned by ${workItem.owner}; its review path takes the [DONE]` };
+        }
+        return hasLead
+            ? { action: 'digest', actionable: false, reason: `no work item; ${sender} reports to ${lead}` }
+            : { action: 'digest', actionable: true, reason: `no work item and no lead above ${sender}` };
+    }
+    if (ORC_WAKE_CONSTANTS.ATTENTION_MARKERS.test(content)) {
+        if (hasLead && lead)
+            return { action: 'team-lead', lead, reason: `[${marker}] goes to ${sender}'s lead first` };
+        return { action: 'orc', category: 'escalation', reason: senderIsLead ? `[${marker}] from a team lead` : `[${marker}] and ${sender} has no lead` };
+    }
+    // Structured reports and unknown markers.
+    const actionable = orcWork || !hasLead;
+    return {
+        action: 'digest',
+        actionable,
+        reason: actionable ? `[${marker}] ${orcWork ? 'on orchestrator work' : 'from an agent with no lead'}` : `[${marker}] on work its lead owns`,
+    };
+}
+//# sourceMappingURL=orc-status-routing.js.map

package/dist/cli/backend/src/services/orc/orc-status-routing.js.map

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

package/dist/cli/backend/src/services/orc/orc-wake-counter.d.ts

@@ -0,0 +1,86 @@
+/**
+ * Hourly count of orchestrator turns, by why it was woken
+ * (specs/2026-10-01-orc-status-wakes.md).
+ *
+ * Every orchestrator turn re-reads its whole context (~70k tokens on
+ * 2026-09-29), so the number of turns IS the cost. Once an hour the counter
+ * logs one line:
+ *
+ *   orc wakes: 14 (owner 3, delegated-done 2, escalations 1, digest 2, other 6)
+ *
+ * - `N` and `owner` are counted when the queue processor starts an
+ *   orchestrator turn (`owner` = any non-system source: Slack, web chat, …).
+ * - `delegated-done`, `escalations`, `digest` are counted when the status
+ *   router decides to wake the orchestrator (several queued system events
+ *   can coalesce into one turn, so these may add up to more than the turns
+ *   they caused).
+ * - `other` = turns that are neither owner messages nor status-router wakes
+ *   (cron, wiki, triggers, enforcer reminders, …).
+ *
+ * @module services/orc/orc-wake-counter
+ */
+import type { OrcWakeCategory } from './orc-status-routing.js';
+/** One hour's numbers. */
+export interface OrcWakeCounts {
+    /** Orchestrator turns started */
+    turns: number;
+    /** Turns for an owner message */
+    owner: number;
+    /** Status-router wakes: [DONE] on orchestrator-delegated work (incl. owed deliveries) */
+    delegatedDone: number;
+    /** Status-router wakes: [BLOCKED]/[FAILED] with no lead to take it */
+    escalations: number;
+    /** Status digests sent */
+    digest: number;
+    /** Status-router wakes for an answer that was not a status line */
+    statusOther: number;
+}
+/**
+ * The log line for one period.
+ *
+ * @param c - Counts
+ * @returns `orc wakes: N (owner X, delegated-done Y, escalations Z, digest W, other V)`
+ */
+export declare function formatOrcWakeLine(c: OrcWakeCounts): string;
+/** Counts orchestrator wakes and logs them once per period. */
+export declare class OrcWakeCounter {
+    private readonly now;
+    private static instance;
+    private counts;
+    private periodStart;
+    private timer;
+    private readonly logger;
+    /**
+     * @param now - Clock (tests)
+     */
+    constructor(now?: () => number);
+    /** The process-wide counter. */
+    static getInstance(): OrcWakeCounter;
+    /** Drop the singleton (tests). */
+    static resetInstance(): void;
+    /** Log every {@link ORC_WAKE_CONSTANTS.COUNTER_LOG_INTERVAL_MS}. Idempotent. */
+    start(): void;
+    /** Stop the periodic log. */
+    stop(): void;
+    /**
+     * An orchestrator turn started (queue processor).
+     *
+     * @param source - Message source of the turn
+     */
+    noteTurn(source: string): void;
+    /**
+     * The status router decided to wake the orchestrator.
+     *
+     * @param category - Why
+     */
+    noteRouted(category: OrcWakeCategory): void;
+    /** The current period's numbers (copy). */
+    snapshot(): OrcWakeCounts;
+    /**
+     * Log the period's line and start a new period.
+     *
+     * @returns The logged line
+     */
+    flush(): string;
+}
+//# sourceMappingURL=orc-wake-counter.d.ts.map

package/dist/cli/backend/src/services/orc/orc-wake-counter.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"orc-wake-counter.d.ts","sourceRoot":"","sources":["../../../../../../backend/src/services/orc/orc-wake-counter.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;GAoBG;AAIH,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,yBAAyB,CAAC;AAE/D,0BAA0B;AAC1B,MAAM,WAAW,aAAa;IAC5B,iCAAiC;IACjC,KAAK,EAAE,MAAM,CAAC;IACd,iCAAiC;IACjC,KAAK,EAAE,MAAM,CAAC;IACd,yFAAyF;IACzF,aAAa,EAAE,MAAM,CAAC;IACtB,sEAAsE;IACtE,WAAW,EAAE,MAAM,CAAC;IACpB,0BAA0B;IAC1B,MAAM,EAAE,MAAM,CAAC;IACf,mEAAmE;IACnE,WAAW,EAAE,MAAM,CAAC;CACrB;AAOD;;;;;GAKG;AACH,wBAAgB,iBAAiB,CAAC,CAAC,EAAE,aAAa,GAAG,MAAM,CAI1D;AAED,+DAA+D;AAC/D,qBAAa,cAAc;IAUb,OAAO,CAAC,QAAQ,CAAC,GAAG;IAThC,OAAO,CAAC,MAAM,CAAC,QAAQ,CAA+B;IACtD,OAAO,CAAC,MAAM,CAAyB;IACvC,OAAO,CAAC,WAAW,CAAS;IAC5B,OAAO,CAAC,KAAK,CAA+B;IAC5C,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAkB;IAEzC;;OAEG;gBAC0B,GAAG,GAAE,MAAM,MAAiB;IAKzD,gCAAgC;IAChC,MAAM,CAAC,WAAW,IAAI,cAAc;IAKpC,kCAAkC;IAClC,MAAM,CAAC,aAAa,IAAI,IAAI;IAK5B,gFAAgF;IAChF,KAAK,IAAI,IAAI;IAMb,6BAA6B;IAC7B,IAAI,IAAI,IAAI;IAKZ;;;;OAIG;IACH,QAAQ,CAAC,MAAM,EAAE,MAAM,GAAG,IAAI;IAK9B;;;;OAIG;IACH,UAAU,CAAC,QAAQ,EAAE,eAAe,GAAG,IAAI;IAiB3C,2CAA2C;IAC3C,QAAQ,IAAI,aAAa;IAIzB;;;;OAIG;IACH,KAAK,IAAI,MAAM;CAUhB"}

package/dist/cli/backend/src/services/orc/orc-wake-counter.js

@@ -0,0 +1,130 @@
+/**
+ * Hourly count of orchestrator turns, by why it was woken
+ * (specs/2026-10-01-orc-status-wakes.md).
+ *
+ * Every orchestrator turn re-reads its whole context (~70k tokens on
+ * 2026-09-29), so the number of turns IS the cost. Once an hour the counter
+ * logs one line:
+ *
+ *   orc wakes: 14 (owner 3, delegated-done 2, escalations 1, digest 2, other 6)
+ *
+ * - `N` and `owner` are counted when the queue processor starts an
+ *   orchestrator turn (`owner` = any non-system source: Slack, web chat, …).
+ * - `delegated-done`, `escalations`, `digest` are counted when the status
+ *   router decides to wake the orchestrator (several queued system events
+ *   can coalesce into one turn, so these may add up to more than the turns
+ *   they caused).
+ * - `other` = turns that are neither owner messages nor status-router wakes
+ *   (cron, wiki, triggers, enforcer reminders, …).
+ *
+ * @module services/orc/orc-wake-counter
+ */
+import { MESSAGE_SOURCES, ORC_WAKE_CONSTANTS } from '../../constants.js';
+import { LoggerService } from '../core/logger.service.js';
+/** A fresh, zeroed count. */
+function zero() {
+    return { turns: 0, owner: 0, delegatedDone: 0, escalations: 0, digest: 0, statusOther: 0 };
+}
+/**
+ * The log line for one period.
+ *
+ * @param c - Counts
+ * @returns `orc wakes: N (owner X, delegated-done Y, escalations Z, digest W, other V)`
+ */
+export function formatOrcWakeLine(c) {
+    const routed = c.delegatedDone + c.escalations + c.digest;
+    const other = Math.max(0, c.turns - c.owner - routed);
+    return `orc wakes: ${c.turns} (owner ${c.owner}, delegated-done ${c.delegatedDone}, escalations ${c.escalations}, digest ${c.digest}, other ${other})`;
+}
+/** Counts orchestrator wakes and logs them once per period. */
+export class OrcWakeCounter {
+    now;
+    static instance = null;
+    counts = zero();
+    periodStart;
+    timer = null;
+    logger;
+    /**
+     * @param now - Clock (tests)
+     */
+    constructor(now = Date.now) {
+        this.now = now;
+        this.periodStart = now();
+        this.logger = LoggerService.getInstance().createComponentLogger('OrcWakes');
+    }
+    /** The process-wide counter. */
+    static getInstance() {
+        if (!OrcWakeCounter.instance)
+            OrcWakeCounter.instance = new OrcWakeCounter();
+        return OrcWakeCounter.instance;
+    }
+    /** Drop the singleton (tests). */
+    static resetInstance() {
+        OrcWakeCounter.instance?.stop();
+        OrcWakeCounter.instance = null;
+    }
+    /** Log every {@link ORC_WAKE_CONSTANTS.COUNTER_LOG_INTERVAL_MS}. Idempotent. */
+    start() {
+        if (this.timer)
+            return;
+        this.timer = setInterval(() => this.flush(), ORC_WAKE_CONSTANTS.COUNTER_LOG_INTERVAL_MS);
+        this.timer.unref?.();
+    }
+    /** Stop the periodic log. */
+    stop() {
+        if (this.timer)
+            clearInterval(this.timer);
+        this.timer = null;
+    }
+    /**
+     * An orchestrator turn started (queue processor).
+     *
+     * @param source - Message source of the turn
+     */
+    noteTurn(source) {
+        this.counts.turns += 1;
+        if (source !== MESSAGE_SOURCES.SYSTEM_EVENT)
+            this.counts.owner += 1;
+    }
+    /**
+     * The status router decided to wake the orchestrator.
+     *
+     * @param category - Why
+     */
+    noteRouted(category) {
+        switch (category) {
+            case 'owner':
+            case 'delegated-done':
+                this.counts.delegatedDone += 1;
+                break;
+            case 'escalation':
+                this.counts.escalations += 1;
+                break;
+            case 'digest':
+                this.counts.digest += 1;
+                break;
+            default:
+                this.counts.statusOther += 1;
+        }
+    }
+    /** The current period's numbers (copy). */
+    snapshot() {
+        return { ...this.counts };
+    }
+    /**
+     * Log the period's line and start a new period.
+     *
+     * @returns The logged line
+     */
+    flush() {
+        const line = formatOrcWakeLine(this.counts);
+        this.logger.info(line, {
+            since: new Date(this.periodStart).toISOString(),
+            ...this.counts,
+        });
+        this.counts = zero();
+        this.periodStart = this.now();
+        return line;
+    }
+}
+//# sourceMappingURL=orc-wake-counter.js.map

package/dist/cli/backend/src/services/orc/orc-wake-counter.js.map

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

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":"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"}