@dealdesk/server 2026.527.0-canary.0

package/dist/services/issue-approvals.js

@@ -0,0 +1,153 @@
+import { and, desc, eq, inArray } from "drizzle-orm";
+import { approvals, issueApprovals, issues } from "@dealdesk/db";
+import { notFound, unprocessable } from "../errors.js";
+import { redactEventPayload } from "../redaction.js";
+export function issueApprovalService(db) {
+    async function getIssue(issueId) {
+        return db
+            .select()
+            .from(issues)
+            .where(eq(issues.id, issueId))
+            .then((rows) => rows[0] ?? null);
+    }
+    async function getApproval(approvalId) {
+        return db
+            .select()
+            .from(approvals)
+            .where(eq(approvals.id, approvalId))
+            .then((rows) => rows[0] ?? null);
+    }
+    async function assertIssueAndApprovalSameCompany(issueId, approvalId) {
+        const issue = await getIssue(issueId);
+        if (!issue)
+            throw notFound("Issue not found");
+        const approval = await getApproval(approvalId);
+        if (!approval)
+            throw notFound("Approval not found");
+        if (issue.companyId !== approval.companyId) {
+            throw unprocessable("Issue and approval must belong to the same company");
+        }
+        return { issue, approval };
+    }
+    return {
+        listApprovalsForIssue: async (issueId) => {
+            const issue = await getIssue(issueId);
+            if (!issue)
+                throw notFound("Issue not found");
+            const result = await db
+                .select({
+                id: approvals.id,
+                companyId: approvals.companyId,
+                type: approvals.type,
+                requestedByAgentId: approvals.requestedByAgentId,
+                requestedByUserId: approvals.requestedByUserId,
+                status: approvals.status,
+                payload: approvals.payload,
+                decisionNote: approvals.decisionNote,
+                decidedByUserId: approvals.decidedByUserId,
+                decidedAt: approvals.decidedAt,
+                createdAt: approvals.createdAt,
+                updatedAt: approvals.updatedAt,
+            })
+                .from(issueApprovals)
+                .innerJoin(approvals, eq(issueApprovals.approvalId, approvals.id))
+                .where(eq(issueApprovals.issueId, issueId))
+                .orderBy(desc(issueApprovals.createdAt));
+            return result.map((approval) => ({
+                ...approval,
+                payload: redactEventPayload(approval.payload) ?? {},
+            }));
+        },
+        listIssuesForApproval: async (approvalId) => {
+            const approval = await getApproval(approvalId);
+            if (!approval)
+                throw notFound("Approval not found");
+            return db
+                .select({
+                id: issues.id,
+                companyId: issues.companyId,
+                projectId: issues.projectId,
+                goalId: issues.goalId,
+                parentId: issues.parentId,
+                title: issues.title,
+                description: issues.description,
+                status: issues.status,
+                priority: issues.priority,
+                assigneeAgentId: issues.assigneeAgentId,
+                createdByAgentId: issues.createdByAgentId,
+                createdByUserId: issues.createdByUserId,
+                issueNumber: issues.issueNumber,
+                identifier: issues.identifier,
+                requestDepth: issues.requestDepth,
+                billingCode: issues.billingCode,
+                startedAt: issues.startedAt,
+                completedAt: issues.completedAt,
+                cancelledAt: issues.cancelledAt,
+                createdAt: issues.createdAt,
+                updatedAt: issues.updatedAt,
+            })
+                .from(issueApprovals)
+                .innerJoin(issues, eq(issueApprovals.issueId, issues.id))
+                .where(eq(issueApprovals.approvalId, approvalId))
+                .orderBy(desc(issueApprovals.createdAt));
+        },
+        link: async (issueId, approvalId, actor) => {
+            const { issue } = await assertIssueAndApprovalSameCompany(issueId, approvalId);
+            await db
+                .insert(issueApprovals)
+                .values({
+                companyId: issue.companyId,
+                issueId,
+                approvalId,
+                linkedByAgentId: actor?.agentId ?? null,
+                linkedByUserId: actor?.userId ?? null,
+            })
+                .onConflictDoNothing();
+            return db
+                .select()
+                .from(issueApprovals)
+                .where(and(eq(issueApprovals.issueId, issueId), eq(issueApprovals.approvalId, approvalId)))
+                .then((rows) => rows[0] ?? null);
+        },
+        unlink: async (issueId, approvalId) => {
+            await assertIssueAndApprovalSameCompany(issueId, approvalId);
+            await db
+                .delete(issueApprovals)
+                .where(and(eq(issueApprovals.issueId, issueId), eq(issueApprovals.approvalId, approvalId)));
+        },
+        linkManyForApproval: async (approvalId, issueIds, actor) => {
+            if (issueIds.length === 0)
+                return;
+            const approval = await getApproval(approvalId);
+            if (!approval)
+                throw notFound("Approval not found");
+            const uniqueIssueIds = Array.from(new Set(issueIds));
+            const rows = await db
+                .select({
+                id: issues.id,
+                companyId: issues.companyId,
+            })
+                .from(issues)
+                .where(inArray(issues.id, uniqueIssueIds));
+            if (rows.length !== uniqueIssueIds.length) {
+                throw notFound("One or more issues not found");
+            }
+            for (const row of rows) {
+                if (row.companyId !== approval.companyId) {
+                    throw unprocessable("Issue and approval must belong to the same company");
+                }
+            }
+            await db
+                .insert(issueApprovals)
+                .values(uniqueIssueIds.map((issueId) => ({
+                companyId: approval.companyId,
+                issueId,
+                approvalId,
+                linkedByAgentId: actor?.agentId ?? null,
+                linkedByUserId: actor?.userId ?? null,
+            })))
+                .onConflictDoNothing();
+        },
+    };
+}
+//# sourceMappingURL=issue-approvals.js.map

package/dist/services/issue-approvals.js.map

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

package/dist/services/issue-assignment-wakeup.d.ts

@@ -0,0 +1,29 @@
+type WakeupTriggerDetail = "manual" | "ping" | "callback" | "system";
+type WakeupSource = "timer" | "assignment" | "on_demand" | "automation";
+export interface IssueAssignmentWakeupDeps {
+    wakeup: (agentId: string, opts: {
+        source?: WakeupSource;
+        triggerDetail?: WakeupTriggerDetail;
+        reason?: string | null;
+        payload?: Record<string, unknown> | null;
+        requestedByActorType?: "user" | "agent" | "system";
+        requestedByActorId?: string | null;
+        contextSnapshot?: Record<string, unknown>;
+    }) => Promise<unknown>;
+}
+export declare function queueIssueAssignmentWakeup(input: {
+    heartbeat: IssueAssignmentWakeupDeps;
+    issue: {
+        id: string;
+        assigneeAgentId: string | null;
+        status: string;
+    };
+    reason: string;
+    mutation: string;
+    contextSource: string;
+    requestedByActorType?: "user" | "agent" | "system";
+    requestedByActorId?: string | null;
+    rethrowOnError?: boolean;
+}): Promise<unknown> | undefined;
+export {};
+//# sourceMappingURL=issue-assignment-wakeup.d.ts.map

package/dist/services/issue-assignment-wakeup.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"issue-assignment-wakeup.d.ts","sourceRoot":"","sources":["../../src/services/issue-assignment-wakeup.ts"],"names":[],"mappings":"AAEA,KAAK,mBAAmB,GAAG,QAAQ,GAAG,MAAM,GAAG,UAAU,GAAG,QAAQ,CAAC;AACrE,KAAK,YAAY,GAAG,OAAO,GAAG,YAAY,GAAG,WAAW,GAAG,YAAY,CAAC;AAExE,MAAM,WAAW,yBAAyB;IACxC,MAAM,EAAE,CACN,OAAO,EAAE,MAAM,EACf,IAAI,EAAE;QACJ,MAAM,CAAC,EAAE,YAAY,CAAC;QACtB,aAAa,CAAC,EAAE,mBAAmB,CAAC;QACpC,MAAM,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;QACvB,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,IAAI,CAAC;QACzC,oBAAoB,CAAC,EAAE,MAAM,GAAG,OAAO,GAAG,QAAQ,CAAC;QACnD,kBAAkB,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;QACnC,eAAe,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;KAC3C,KACE,OAAO,CAAC,OAAO,CAAC,CAAC;CACvB;AAED,wBAAgB,0BAA0B,CAAC,KAAK,EAAE;IAChD,SAAS,EAAE,yBAAyB,CAAC;IACrC,KAAK,EAAE;QAAE,EAAE,EAAE,MAAM,CAAC;QAAC,eAAe,EAAE,MAAM,GAAG,IAAI,CAAC;QAAC,MAAM,EAAE,MAAM,CAAA;KAAE,CAAC;IACtE,MAAM,EAAE,MAAM,CAAC;IACf,QAAQ,EAAE,MAAM,CAAC;IACjB,aAAa,EAAE,MAAM,CAAC;IACtB,oBAAoB,CAAC,EAAE,MAAM,GAAG,OAAO,GAAG,QAAQ,CAAC;IACnD,kBAAkB,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IACnC,cAAc,CAAC,EAAE,OAAO,CAAC;CAC1B,gCAkBA"}

package/dist/services/issue-assignment-wakeup.js

@@ -0,0 +1,22 @@
+import { logger } from "../middleware/logger.js";
+export function queueIssueAssignmentWakeup(input) {
+    if (!input.issue.assigneeAgentId || input.issue.status === "backlog")
+        return;
+    return input.heartbeat
+        .wakeup(input.issue.assigneeAgentId, {
+        source: "assignment",
+        triggerDetail: "system",
+        reason: input.reason,
+        payload: { issueId: input.issue.id, mutation: input.mutation },
+        requestedByActorType: input.requestedByActorType,
+        requestedByActorId: input.requestedByActorId ?? null,
+        contextSnapshot: { issueId: input.issue.id, source: input.contextSource },
+    })
+        .catch((err) => {
+        logger.warn({ err, issueId: input.issue.id }, "failed to wake assignee on issue assignment");
+        if (input.rethrowOnError)
+            throw err;
+        return null;
+    });
+}
+//# sourceMappingURL=issue-assignment-wakeup.js.map

package/dist/services/issue-assignment-wakeup.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"issue-assignment-wakeup.js","sourceRoot":"","sources":["../../src/services/issue-assignment-wakeup.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,EAAE,MAAM,yBAAyB,CAAC;AAoBjD,MAAM,UAAU,0BAA0B,CAAC,KAS1C;IACC,IAAI,CAAC,KAAK,CAAC,KAAK,CAAC,eAAe,IAAI,KAAK,CAAC,KAAK,CAAC,MAAM,KAAK,SAAS;QAAE,OAAO;IAE7E,OAAO,KAAK,CAAC,SAAS;SACnB,MAAM,CAAC,KAAK,CAAC,KAAK,CAAC,eAAe,EAAE;QACnC,MAAM,EAAE,YAAY;QACpB,aAAa,EAAE,QAAQ;QACvB,MAAM,EAAE,KAAK,CAAC,MAAM;QACpB,OAAO,EAAE,EAAE,OAAO,EAAE,KAAK,CAAC,KAAK,CAAC,EAAE,EAAE,QAAQ,EAAE,KAAK,CAAC,QAAQ,EAAE;QAC9D,oBAAoB,EAAE,KAAK,CAAC,oBAAoB;QAChD,kBAAkB,EAAE,KAAK,CAAC,kBAAkB,IAAI,IAAI;QACpD,eAAe,EAAE,EAAE,OAAO,EAAE,KAAK,CAAC,KAAK,CAAC,EAAE,EAAE,MAAM,EAAE,KAAK,CAAC,aAAa,EAAE;KAC1E,CAAC;SACD,KAAK,CAAC,CAAC,GAAG,EAAE,EAAE;QACb,MAAM,CAAC,IAAI,CAAC,EAAE,GAAG,EAAE,OAAO,EAAE,KAAK,CAAC,KAAK,CAAC,EAAE,EAAE,EAAE,6CAA6C,CAAC,CAAC;QAC7F,IAAI,KAAK,CAAC,cAAc;YAAE,MAAM,GAAG,CAAC;QACpC,OAAO,IAAI,CAAC;IACd,CAAC,CAAC,CAAC;AACP,CAAC"}

package/dist/services/issue-continuation-summary.d.ts

@@ -0,0 +1,68 @@
+import type { Db } from "@dealdesk/db";
+import { ISSUE_CONTINUATION_SUMMARY_DOCUMENT_KEY } from "@dealdesk/shared";
+export { ISSUE_CONTINUATION_SUMMARY_DOCUMENT_KEY };
+export declare const ISSUE_CONTINUATION_SUMMARY_TITLE = "Continuation Summary";
+export declare const ISSUE_CONTINUATION_SUMMARY_MAX_BODY_CHARS = 8000;
+type IssueSummaryInput = {
+    id: string;
+    identifier: string | null;
+    title: string;
+    description: string | null;
+    status: string;
+    priority: string;
+};
+type RunSummaryInput = {
+    id: string;
+    status: string;
+    error: string | null;
+    errorCode?: string | null;
+    resultJson?: Record<string, unknown> | null;
+    stdoutExcerpt?: string | null;
+    stderrExcerpt?: string | null;
+    finishedAt?: Date | null;
+};
+type AgentSummaryInput = {
+    id: string;
+    name: string;
+    adapterType: string | null;
+};
+export type IssueContinuationSummaryDocument = {
+    key: typeof ISSUE_CONTINUATION_SUMMARY_DOCUMENT_KEY;
+    title: string | null;
+    body: string;
+    latestRevisionId: string | null;
+    latestRevisionNumber: number;
+    updatedAt: Date;
+};
+export declare function extractContinuationSummaryNextAction(body: string | null | undefined): string | null;
+export declare function continuationSummaryParksExecutor(body: string | null | undefined): boolean;
+export declare function buildContinuationSummaryMarkdown(input: {
+    issue: IssueSummaryInput;
+    run: RunSummaryInput;
+    agent: AgentSummaryInput;
+    previousSummaryBody?: string | null;
+}): string;
+export declare function getIssueContinuationSummaryDocument(db: Db, issueId: string): Promise<IssueContinuationSummaryDocument | null>;
+export declare function refreshIssueContinuationSummary(input: {
+    db: Db;
+    issueId: string;
+    run: RunSummaryInput;
+    agent: AgentSummaryInput;
+}): Promise<{
+    id: string;
+    companyId: string;
+    issueId: string;
+    key: string;
+    title: string | null;
+    format: string;
+    body: string;
+    latestRevisionId: string;
+    latestRevisionNumber: number;
+    createdByAgentId: string | null;
+    createdByUserId: string | null;
+    updatedByAgentId: string | null;
+    updatedByUserId: string | null;
+    createdAt: Date;
+    updatedAt: Date;
+} | null>;
+//# sourceMappingURL=issue-continuation-summary.d.ts.map

package/dist/services/issue-continuation-summary.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"issue-continuation-summary.d.ts","sourceRoot":"","sources":["../../src/services/issue-continuation-summary.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,EAAE,EAAE,MAAM,cAAc,CAAC;AAEvC,OAAO,EAAE,uCAAuC,EAAE,MAAM,kBAAkB,CAAC;AAG3E,OAAO,EAAE,uCAAuC,EAAE,CAAC;AACnD,eAAO,MAAM,gCAAgC,yBAAyB,CAAC;AACvE,eAAO,MAAM,yCAAyC,OAAQ,CAAC;AAM/D,KAAK,iBAAiB,GAAG;IACvB,EAAE,EAAE,MAAM,CAAC;IACX,UAAU,EAAE,MAAM,GAAG,IAAI,CAAC;IAC1B,KAAK,EAAE,MAAM,CAAC;IACd,WAAW,EAAE,MAAM,GAAG,IAAI,CAAC;IAC3B,MAAM,EAAE,MAAM,CAAC;IACf,QAAQ,EAAE,MAAM,CAAC;CAClB,CAAC;AAEF,KAAK,eAAe,GAAG;IACrB,EAAE,EAAE,MAAM,CAAC;IACX,MAAM,EAAE,MAAM,CAAC;IACf,KAAK,EAAE,MAAM,GAAG,IAAI,CAAC;IACrB,SAAS,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IAC1B,UAAU,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,IAAI,CAAC;IAC5C,aAAa,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IAC9B,aAAa,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IAC9B,UAAU,CAAC,EAAE,IAAI,GAAG,IAAI,CAAC;CAC1B,CAAC;AAEF,KAAK,iBAAiB,GAAG;IACvB,EAAE,EAAE,MAAM,CAAC;IACX,IAAI,EAAE,MAAM,CAAC;IACb,WAAW,EAAE,MAAM,GAAG,IAAI,CAAC;CAC5B,CAAC;AAEF,MAAM,MAAM,gCAAgC,GAAG;IAC7C,GAAG,EAAE,OAAO,uCAAuC,CAAC;IACpD,KAAK,EAAE,MAAM,GAAG,IAAI,CAAC;IACrB,IAAI,EAAE,MAAM,CAAC;IACb,gBAAgB,EAAE,MAAM,GAAG,IAAI,CAAC;IAChC,oBAAoB,EAAE,MAAM,CAAC;IAC7B,SAAS,EAAE,IAAI,CAAC;CACjB,CAAC;AA6EF,wBAAgB,oCAAoC,CAAC,IAAI,EAAE,MAAM,GAAG,IAAI,GAAG,SAAS,iBAEnF;AAED,wBAAgB,gCAAgC,CAAC,IAAI,EAAE,MAAM,GAAG,IAAI,GAAG,SAAS,WAI/E;AAED,wBAAgB,gCAAgC,CAAC,KAAK,EAAE;IACtD,KAAK,EAAE,iBAAiB,CAAC;IACzB,GAAG,EAAE,eAAe,CAAC;IACrB,KAAK,EAAE,iBAAiB,CAAC;IACzB,mBAAmB,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;CACrC,UAoEA;AAED,wBAAsB,mCAAmC,CACvD,EAAE,EAAE,EAAE,EACN,OAAO,EAAE,MAAM,GACd,OAAO,CAAC,gCAAgC,GAAG,IAAI,CAAC,CAwBlD;AAED,wBAAsB,+BAA+B,CAAC,KAAK,EAAE;IAC3D,EAAE,EAAE,EAAE,CAAC;IACP,OAAO,EAAE,MAAM,CAAC;IAChB,GAAG,EAAE,eAAe,CAAC;IACrB,KAAK,EAAE,iBAAiB,CAAC;CAC1B;;;;;;;;;;;;;;;;UAqCA"}

package/dist/services/issue-continuation-summary.js

@@ -0,0 +1,222 @@
+import { and, eq } from "drizzle-orm";
+import { documents, issueDocuments, issues } from "@dealdesk/db";
+import { ISSUE_CONTINUATION_SUMMARY_DOCUMENT_KEY } from "@dealdesk/shared";
+import { documentService } from "./documents.js";
+export { ISSUE_CONTINUATION_SUMMARY_DOCUMENT_KEY };
+export const ISSUE_CONTINUATION_SUMMARY_TITLE = "Continuation Summary";
+export const ISSUE_CONTINUATION_SUMMARY_MAX_BODY_CHARS = 8_000;
+const SUMMARY_SECTION_MAX_CHARS = 1_200;
+const PATH_CANDIDATE_RE = /(?:^|[\s`"'(])((?:server|ui|packages|doc|scripts|\.github)\/[A-Za-z0-9._/-]+)/g;
+const WAITING_FOR_REVIEW_OR_APPROVAL_RE = /\bwait(?:ing)? for\b.{0,160}\b(?:review(?:er)?(?: feedback)?|approval|board|human|user|operator)\b/i;
+function truncateText(value, maxChars) {
+    const trimmed = value.trim();
+    if (trimmed.length <= maxChars)
+        return trimmed;
+    return `${trimmed.slice(0, Math.max(0, maxChars - 20)).trimEnd()}\n[truncated]`;
+}
+function asNonEmptyString(value) {
+    return typeof value === "string" && value.trim().length > 0 ? value.trim() : null;
+}
+function readResultSummary(resultJson) {
+    if (!resultJson || typeof resultJson !== "object" || Array.isArray(resultJson))
+        return null;
+    return (asNonEmptyString(resultJson.summary) ??
+        asNonEmptyString(resultJson.result) ??
+        asNonEmptyString(resultJson.message) ??
+        asNonEmptyString(resultJson.error) ??
+        null);
+}
+function extractMarkdownSection(markdown, heading) {
+    if (!markdown)
+        return null;
+    const escaped = heading.replace(/[.*+?^${}()|[\]\\]/g, "\\$&");
+    const re = new RegExp(`^##\\s+${escaped}\\s*$([\\s\\S]*?)(?=^##\\s+|(?![\\s\\S]))`, "im");
+    const match = re.exec(markdown);
+    const section = match?.[1]?.trim();
+    return section ? truncateText(section, SUMMARY_SECTION_MAX_CHARS) : null;
+}
+function extractPathCandidates(...texts) {
+    const seen = new Set();
+    for (const text of texts) {
+        if (!text)
+            continue;
+        for (const match of text.matchAll(PATH_CANDIDATE_RE)) {
+            const path = match[1]?.replace(/[),.;:]+$/, "");
+            if (path)
+                seen.add(path);
+            if (seen.size >= 12)
+                break;
+        }
+        if (seen.size >= 12)
+            break;
+    }
+    return [...seen];
+}
+function inferMode(issue, run) {
+    if (issue.status === "done" || issue.status === "in_review")
+        return "review";
+    if (run.status === "failed" || run.status === "timed_out" || run.status === "cancelled")
+        return "implementation";
+    if (issue.status === "backlog" || issue.status === "todo")
+        return "plan";
+    return "implementation";
+}
+function inferNextAction(issue, run, previousNextAction) {
+    if (issue.status === "done")
+        return "Review the completed issue output and close any remaining follow-up comments.";
+    if (issue.status === "in_review")
+        return "Wait for reviewer feedback or approval before continuing executor work.";
+    if (run.status === "failed" || run.status === "timed_out") {
+        return "Inspect the failed run, fix the cause, and resume from the most recent concrete action above.";
+    }
+    if (run.status === "cancelled")
+        return "Confirm the cancellation reason before starting another run.";
+    return previousNextAction ?? "Resume implementation from the acceptance criteria, latest comments, and this summary.";
+}
+function bulletList(items, empty) {
+    if (items.length === 0)
+        return `- ${empty}`;
+    return items.map((item) => `- ${item}`).join("\n");
+}
+function extractPreviousNextAction(previousBody) {
+    const section = extractMarkdownSection(previousBody, "Next Action");
+    if (!section)
+        return null;
+    return section
+        .split(/\r?\n/)
+        .map((line) => line.replace(/^[-*]\s+/, "").trim())
+        .find(Boolean) ?? null;
+}
+export function extractContinuationSummaryNextAction(body) {
+    return extractPreviousNextAction(body);
+}
+export function continuationSummaryParksExecutor(body) {
+    const nextAction = extractContinuationSummaryNextAction(body);
+    if (!nextAction)
+        return false;
+    return WAITING_FOR_REVIEW_OR_APPROVAL_RE.test(nextAction);
+}
+export function buildContinuationSummaryMarkdown(input) {
+    const { issue, run, agent } = input;
+    const resultSummary = readResultSummary(run.resultJson);
+    const recentActions = [
+        `Run \`${run.id}\` finished with status \`${run.status}\`${run.finishedAt ? ` at ${run.finishedAt.toISOString()}` : ""}.`,
+        resultSummary ? truncateText(resultSummary, SUMMARY_SECTION_MAX_CHARS) : "No adapter-provided result summary was captured for this run.",
+    ];
+    if (run.error) {
+        recentActions.push(`Latest run error${run.errorCode ? ` (${run.errorCode})` : ""}: ${truncateText(run.error, 500)}`);
+    }
+    const paths = extractPathCandidates(resultSummary, run.stdoutExcerpt, run.stderrExcerpt, input.previousSummaryBody);
+    const objective = extractMarkdownSection(issue.description, "Objective") ?? issue.description?.trim() ?? "No objective captured.";
+    const acceptanceCriteria = extractMarkdownSection(issue.description, "Acceptance Criteria") ?? "No explicit acceptance criteria captured.";
+    const mode = inferMode(issue, run);
+    const nextAction = inferNextAction(issue, run, extractPreviousNextAction(input.previousSummaryBody));
+    const body = [
+        "# Continuation Summary",
+        "",
+        `- Issue: ${issue.identifier ?? issue.id} — ${issue.title}`,
+        `- Status: ${issue.status}`,
+        `- Priority: ${issue.priority}`,
+        `- Current mode: ${mode}`,
+        `- Last updated by run: ${run.id}`,
+        `- Agent: ${agent.name} (${agent.adapterType ?? "unknown"})`,
+        "",
+        "## Objective",
+        "",
+        truncateText(objective, SUMMARY_SECTION_MAX_CHARS),
+        "",
+        "## Acceptance Criteria",
+        "",
+        acceptanceCriteria,
+        "",
+        "## Recent Concrete Actions",
+        "",
+        bulletList(recentActions, "No recent actions captured."),
+        "",
+        "## Files / Routes Touched",
+        "",
+        bulletList(paths.map((path) => `\`${path}\``), "No file or route paths were detected in the captured run summary."),
+        "",
+        "## Commands Run",
+        "",
+        bulletList([
+            `Heartbeat run \`${run.id}\` invoked adapter \`${agent.adapterType ?? "unknown"}\`.`,
+            "Detailed shell/tool commands remain in the run log and transcript.",
+        ], "No command metadata captured."),
+        "",
+        "## Blockers / Decisions",
+        "",
+        bulletList(run.error
+            ? [`Latest run ended with \`${run.status}\`; inspect the error before continuing.`]
+            : ["No new blocker was recorded by the latest run."], "No blockers or decisions captured."),
+        "",
+        "## Next Action",
+        "",
+        `- ${nextAction}`,
+    ].join("\n");
+    return truncateText(body, ISSUE_CONTINUATION_SUMMARY_MAX_BODY_CHARS);
+}
+export async function getIssueContinuationSummaryDocument(db, issueId) {
+    const row = await db
+        .select({
+        key: issueDocuments.key,
+        title: documents.title,
+        body: documents.latestBody,
+        latestRevisionId: documents.latestRevisionId,
+        latestRevisionNumber: documents.latestRevisionNumber,
+        updatedAt: documents.updatedAt,
+    })
+        .from(issueDocuments)
+        .innerJoin(documents, eq(issueDocuments.documentId, documents.id))
+        .where(and(eq(issueDocuments.issueId, issueId), eq(issueDocuments.key, ISSUE_CONTINUATION_SUMMARY_DOCUMENT_KEY)))
+        .then((rows) => rows[0] ?? null);
+    if (!row)
+        return null;
+    return {
+        key: ISSUE_CONTINUATION_SUMMARY_DOCUMENT_KEY,
+        title: row.title,
+        body: row.body,
+        latestRevisionId: row.latestRevisionId,
+        latestRevisionNumber: row.latestRevisionNumber,
+        updatedAt: row.updatedAt,
+    };
+}
+export async function refreshIssueContinuationSummary(input) {
+    const { db, issueId, run, agent } = input;
+    const [issue, existing] = await Promise.all([
+        db
+            .select({
+            id: issues.id,
+            identifier: issues.identifier,
+            title: issues.title,
+            description: issues.description,
+            status: issues.status,
+            priority: issues.priority,
+        })
+            .from(issues)
+            .where(eq(issues.id, issueId))
+            .then((rows) => rows[0] ?? null),
+        getIssueContinuationSummaryDocument(db, issueId),
+    ]);
+    if (!issue)
+        return null;
+    const body = buildContinuationSummaryMarkdown({
+        issue,
+        run,
+        agent,
+        previousSummaryBody: existing?.body ?? null,
+    });
+    const result = await documentService(db).upsertIssueDocument({
+        issueId,
+        key: ISSUE_CONTINUATION_SUMMARY_DOCUMENT_KEY,
+        title: ISSUE_CONTINUATION_SUMMARY_TITLE,
+        format: "markdown",
+        body,
+        baseRevisionId: existing?.latestRevisionId ?? null,
+        changeSummary: `Refresh continuation summary after run ${run.id}`,
+        createdByAgentId: agent.id,
+        createdByRunId: run.id,
+    });
+    return result.document;
+}
+//# sourceMappingURL=issue-continuation-summary.js.map

package/dist/services/issue-continuation-summary.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"issue-continuation-summary.js","sourceRoot":"","sources":["../../src/services/issue-continuation-summary.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,GAAG,EAAE,EAAE,EAAE,MAAM,aAAa,CAAC;AAEtC,OAAO,EAAE,SAAS,EAAE,cAAc,EAAE,MAAM,EAAE,MAAM,cAAc,CAAC;AACjE,OAAO,EAAE,uCAAuC,EAAE,MAAM,kBAAkB,CAAC;AAC3E,OAAO,EAAE,eAAe,EAAE,MAAM,gBAAgB,CAAC;AAEjD,OAAO,EAAE,uCAAuC,EAAE,CAAC;AACnD,MAAM,CAAC,MAAM,gCAAgC,GAAG,sBAAsB,CAAC;AACvE,MAAM,CAAC,MAAM,yCAAyC,GAAG,KAAK,CAAC;AAC/D,MAAM,yBAAyB,GAAG,KAAK,CAAC;AACxC,MAAM,iBAAiB,GAAG,gFAAgF,CAAC;AAC3G,MAAM,iCAAiC,GACrC,qGAAqG,CAAC;AAqCxG,SAAS,YAAY,CAAC,KAAa,EAAE,QAAgB;IACnD,MAAM,OAAO,GAAG,KAAK,CAAC,IAAI,EAAE,CAAC;IAC7B,IAAI,OAAO,CAAC,MAAM,IAAI,QAAQ;QAAE,OAAO,OAAO,CAAC;IAC/C,OAAO,GAAG,OAAO,CAAC,KAAK,CAAC,CAAC,EAAE,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,QAAQ,GAAG,EAAE,CAAC,CAAC,CAAC,OAAO,EAAE,eAAe,CAAC;AAClF,CAAC;AAED,SAAS,gBAAgB,CAAC,KAAc;IACtC,OAAO,OAAO,KAAK,KAAK,QAAQ,IAAI,KAAK,CAAC,IAAI,EAAE,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC,IAAI,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC;AACpF,CAAC;AAED,SAAS,iBAAiB,CAAC,UAAsD;IAC/E,IAAI,CAAC,UAAU,IAAI,OAAO,UAAU,KAAK,QAAQ,IAAI,KAAK,CAAC,OAAO,CAAC,UAAU,CAAC;QAAE,OAAO,IAAI,CAAC;IAC5F,OAAO,CACL,gBAAgB,CAAC,UAAU,CAAC,OAAO,CAAC;QACpC,gBAAgB,CAAC,UAAU,CAAC,MAAM,CAAC;QACnC,gBAAgB,CAAC,UAAU,CAAC,OAAO,CAAC;QACpC,gBAAgB,CAAC,UAAU,CAAC,KAAK,CAAC;QAClC,IAAI,CACL,CAAC;AACJ,CAAC;AAED,SAAS,sBAAsB,CAAC,QAAmC,EAAE,OAAe;IAClF,IAAI,CAAC,QAAQ;QAAE,OAAO,IAAI,CAAC;IAC3B,MAAM,OAAO,GAAG,OAAO,CAAC,OAAO,CAAC,qBAAqB,EAAE,MAAM,CAAC,CAAC;IAC/D,MAAM,EAAE,GAAG,IAAI,MAAM,CAAC,UAAU,OAAO,2CAA2C,EAAE,IAAI,CAAC,CAAC;IAC1F,MAAM,KAAK,GAAG,EAAE,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAC;IAChC,MAAM,OAAO,GAAG,KAAK,EAAE,CAAC,CAAC,CAAC,EAAE,IAAI,EAAE,CAAC;IACnC,OAAO,OAAO,CAAC,CAAC,CAAC,YAAY,CAAC,OAAO,EAAE,yBAAyB,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC;AAC3E,CAAC;AAED,SAAS,qBAAqB,CAAC,GAAG,KAAuC;IACvE,MAAM,IAAI,GAAG,IAAI,GAAG,EAAU,CAAC;IAC/B,KAAK,MAAM,IAAI,IAAI,KAAK,EAAE,CAAC;QACzB,IAAI,CAAC,IAAI;YAAE,SAAS;QACpB,KAAK,MAAM,KAAK,IAAI,IAAI,CAAC,QAAQ,CAAC,iBAAiB,CAAC,EAAE,CAAC;YACrD,MAAM,IAAI,GAAG,KAAK,CAAC,CAAC,CAAC,EAAE,OAAO,CAAC,WAAW,EAAE,EAAE,CAAC,CAAC;YAChD,IAAI,IAAI;gBAAE,IAAI,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC;YACzB,IAAI,IAAI,CAAC,IAAI,IAAI,EAAE;gBAAE,MAAM;QAC7B,CAAC;QACD,IAAI,IAAI,CAAC,IAAI,IAAI,EAAE;YAAE,MAAM;IAC7B,CAAC;IACD,OAAO,CAAC,GAAG,IAAI,CAAC,CAAC;AACnB,CAAC;AAED,SAAS,SAAS,CAAC,KAAwB,EAAE,GAAoB;IAC/D,IAAI,KAAK,CAAC,MAAM,KAAK,MAAM,IAAI,KAAK,CAAC,MAAM,KAAK,WAAW;QAAE,OAAO,QAAQ,CAAC;IAC7E,IAAI,GAAG,CAAC,MAAM,KAAK,QAAQ,IAAI,GAAG,CAAC,MAAM,KAAK,WAAW,IAAI,GAAG,CAAC,MAAM,KAAK,WAAW;QAAE,OAAO,gBAAgB,CAAC;IACjH,IAAI,KAAK,CAAC,MAAM,KAAK,SAAS,IAAI,KAAK,CAAC,MAAM,KAAK,MAAM;QAAE,OAAO,MAAM,CAAC;IACzE,OAAO,gBAAgB,CAAC;AAC1B,CAAC;AAED,SAAS,eAAe,CAAC,KAAwB,EAAE,GAAoB,EAAE,kBAAiC;IACxG,IAAI,KAAK,CAAC,MAAM,KAAK,MAAM;QAAE,OAAO,+EAA+E,CAAC;IACpH,IAAI,KAAK,CAAC,MAAM,KAAK,WAAW;QAAE,OAAO,yEAAyE,CAAC;IACnH,IAAI,GAAG,CAAC,MAAM,KAAK,QAAQ,IAAI,GAAG,CAAC,MAAM,KAAK,WAAW,EAAE,CAAC;QAC1D,OAAO,+FAA+F,CAAC;IACzG,CAAC;IACD,IAAI,GAAG,CAAC,MAAM,KAAK,WAAW;QAAE,OAAO,8DAA8D,CAAC;IACtG,OAAO,kBAAkB,IAAI,wFAAwF,CAAC;AACxH,CAAC;AAED,SAAS,UAAU,CAAC,KAAe,EAAE,KAAa;IAChD,IAAI,KAAK,CAAC,MAAM,KAAK,CAAC;QAAE,OAAO,KAAK,KAAK,EAAE,CAAC;IAC5C,OAAO,KAAK,CAAC,GAAG,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,KAAK,IAAI,EAAE,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;AACrD,CAAC;AAED,SAAS,yBAAyB,CAAC,YAAuC;IACxE,MAAM,OAAO,GAAG,sBAAsB,CAAC,YAAY,EAAE,aAAa,CAAC,CAAC;IACpE,IAAI,CAAC,OAAO;QAAE,OAAO,IAAI,CAAC;IAC1B,OAAO,OAAO;SACX,KAAK,CAAC,OAAO,CAAC;SACd,GAAG,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,IAAI,CAAC,OAAO,CAAC,UAAU,EAAE,EAAE,CAAC,CAAC,IAAI,EAAE,CAAC;SAClD,IAAI,CAAC,OAAO,CAAC,IAAI,IAAI,CAAC;AAC3B,CAAC;AAED,MAAM,UAAU,oCAAoC,CAAC,IAA+B;IAClF,OAAO,yBAAyB,CAAC,IAAI,CAAC,CAAC;AACzC,CAAC;AAED,MAAM,UAAU,gCAAgC,CAAC,IAA+B;IAC9E,MAAM,UAAU,GAAG,oCAAoC,CAAC,IAAI,CAAC,CAAC;IAC9D,IAAI,CAAC,UAAU;QAAE,OAAO,KAAK,CAAC;IAC9B,OAAO,iCAAiC,CAAC,IAAI,CAAC,UAAU,CAAC,CAAC;AAC5D,CAAC;AAED,MAAM,UAAU,gCAAgC,CAAC,KAKhD;IACC,MAAM,EAAE,KAAK,EAAE,GAAG,EAAE,KAAK,EAAE,GAAG,KAAK,CAAC;IACpC,MAAM,aAAa,GAAG,iBAAiB,CAAC,GAAG,CAAC,UAAU,CAAC,CAAC;IACxD,MAAM,aAAa,GAAG;QACpB,SAAS,GAAG,CAAC,EAAE,6BAA6B,GAAG,CAAC,MAAM,KAAK,GAAG,CAAC,UAAU,CAAC,CAAC,CAAC,OAAO,GAAG,CAAC,UAAU,CAAC,WAAW,EAAE,EAAE,CAAC,CAAC,CAAC,EAAE,GAAG;QACzH,aAAa,CAAC,CAAC,CAAC,YAAY,CAAC,aAAa,EAAE,yBAAyB,CAAC,CAAC,CAAC,CAAC,+DAA+D;KACzI,CAAC;IACF,IAAI,GAAG,CAAC,KAAK,EAAE,CAAC;QACd,aAAa,CAAC,IAAI,CAAC,mBAAmB,GAAG,CAAC,SAAS,CAAC,CAAC,CAAC,KAAK,GAAG,CAAC,SAAS,GAAG,CAAC,CAAC,CAAC,EAAE,KAAK,YAAY,CAAC,GAAG,CAAC,KAAK,EAAE,GAAG,CAAC,EAAE,CAAC,CAAC;IACvH,CAAC;IAED,MAAM,KAAK,GAAG,qBAAqB,CAAC,aAAa,EAAE,GAAG,CAAC,aAAa,EAAE,GAAG,CAAC,aAAa,EAAE,KAAK,CAAC,mBAAmB,CAAC,CAAC;IACpH,MAAM,SAAS,GAAG,sBAAsB,CAAC,KAAK,CAAC,WAAW,EAAE,WAAW,CAAC,IAAI,KAAK,CAAC,WAAW,EAAE,IAAI,EAAE,IAAI,wBAAwB,CAAC;IAClI,MAAM,kBAAkB,GAAG,sBAAsB,CAAC,KAAK,CAAC,WAAW,EAAE,qBAAqB,CAAC,IAAI,2CAA2C,CAAC;IAC3I,MAAM,IAAI,GAAG,SAAS,CAAC,KAAK,EAAE,GAAG,CAAC,CAAC;IACnC,MAAM,UAAU,GAAG,eAAe,CAAC,KAAK,EAAE,GAAG,EAAE,yBAAyB,CAAC,KAAK,CAAC,mBAAmB,CAAC,CAAC,CAAC;IAErG,MAAM,IAAI,GAAG;QACX,wBAAwB;QACxB,EAAE;QACF,YAAY,KAAK,CAAC,UAAU,IAAI,KAAK,CAAC,EAAE,MAAM,KAAK,CAAC,KAAK,EAAE;QAC3D,aAAa,KAAK,CAAC,MAAM,EAAE;QAC3B,eAAe,KAAK,CAAC,QAAQ,EAAE;QAC/B,mBAAmB,IAAI,EAAE;QACzB,0BAA0B,GAAG,CAAC,EAAE,EAAE;QAClC,YAAY,KAAK,CAAC,IAAI,KAAK,KAAK,CAAC,WAAW,IAAI,SAAS,GAAG;QAC5D,EAAE;QACF,cAAc;QACd,EAAE;QACF,YAAY,CAAC,SAAS,EAAE,yBAAyB,CAAC;QAClD,EAAE;QACF,wBAAwB;QACxB,EAAE;QACF,kBAAkB;QAClB,EAAE;QACF,4BAA4B;QAC5B,EAAE;QACF,UAAU,CAAC,aAAa,EAAE,6BAA6B,CAAC;QACxD,EAAE;QACF,2BAA2B;QAC3B,EAAE;QACF,UAAU,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,KAAK,IAAI,IAAI,CAAC,EAAE,mEAAmE,CAAC;QACnH,EAAE;QACF,iBAAiB;QACjB,EAAE;QACF,UAAU,CACR;YACE,mBAAmB,GAAG,CAAC,EAAE,wBAAwB,KAAK,CAAC,WAAW,IAAI,SAAS,KAAK;YACpF,oEAAoE;SACrE,EACD,+BAA+B,CAChC;QACD,EAAE;QACF,yBAAyB;QACzB,EAAE;QACF,UAAU,CACR,GAAG,CAAC,KAAK;YACP,CAAC,CAAC,CAAC,2BAA2B,GAAG,CAAC,MAAM,0CAA0C,CAAC;YACnF,CAAC,CAAC,CAAC,gDAAgD,CAAC,EACtD,oCAAoC,CACrC;QACD,EAAE;QACF,gBAAgB;QAChB,EAAE;QACF,KAAK,UAAU,EAAE;KAClB,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;IAEb,OAAO,YAAY,CAAC,IAAI,EAAE,yCAAyC,CAAC,CAAC;AACvE,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,mCAAmC,CACvD,EAAM,EACN,OAAe;IAEf,MAAM,GAAG,GAAG,MAAM,EAAE;SACjB,MAAM,CAAC;QACN,GAAG,EAAE,cAAc,CAAC,GAAG;QACvB,KAAK,EAAE,SAAS,CAAC,KAAK;QACtB,IAAI,EAAE,SAAS,CAAC,UAAU;QAC1B,gBAAgB,EAAE,SAAS,CAAC,gBAAgB;QAC5C,oBAAoB,EAAE,SAAS,CAAC,oBAAoB;QACpD,SAAS,EAAE,SAAS,CAAC,SAAS;KAC/B,CAAC;SACD,IAAI,CAAC,cAAc,CAAC;SACpB,SAAS,CAAC,SAAS,EAAE,EAAE,CAAC,cAAc,CAAC,UAAU,EAAE,SAAS,CAAC,EAAE,CAAC,CAAC;SACjE,KAAK,CAAC,GAAG,CAAC,EAAE,CAAC,cAAc,CAAC,OAAO,EAAE,OAAO,CAAC,EAAE,EAAE,CAAC,cAAc,CAAC,GAAG,EAAE,uCAAuC,CAAC,CAAC,CAAC;SAChH,IAAI,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,IAAI,CAAC,CAAC,CAAC,IAAI,IAAI,CAAC,CAAC;IAEnC,IAAI,CAAC,GAAG;QAAE,OAAO,IAAI,CAAC;IACtB,OAAO;QACL,GAAG,EAAE,uCAAuC;QAC5C,KAAK,EAAE,GAAG,CAAC,KAAK;QAChB,IAAI,EAAE,GAAG,CAAC,IAAI;QACd,gBAAgB,EAAE,GAAG,CAAC,gBAAgB;QACtC,oBAAoB,EAAE,GAAG,CAAC,oBAAoB;QAC9C,SAAS,EAAE,GAAG,CAAC,SAAS;KACzB,CAAC;AACJ,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,+BAA+B,CAAC,KAKrD;IACC,MAAM,EAAE,EAAE,EAAE,OAAO,EAAE,GAAG,EAAE,KAAK,EAAE,GAAG,KAAK,CAAC;IAC1C,MAAM,CAAC,KAAK,EAAE,QAAQ,CAAC,GAAG,MAAM,OAAO,CAAC,GAAG,CAAC;QAC1C,EAAE;aACC,MAAM,CAAC;YACN,EAAE,EAAE,MAAM,CAAC,EAAE;YACb,UAAU,EAAE,MAAM,CAAC,UAAU;YAC7B,KAAK,EAAE,MAAM,CAAC,KAAK;YACnB,WAAW,EAAE,MAAM,CAAC,WAAW;YAC/B,MAAM,EAAE,MAAM,CAAC,MAAM;YACrB,QAAQ,EAAE,MAAM,CAAC,QAAQ;SAC1B,CAAC;aACD,IAAI,CAAC,MAAM,CAAC;aACZ,KAAK,CAAC,EAAE,CAAC,MAAM,CAAC,EAAE,EAAE,OAAO,CAAC,CAAC;aAC7B,IAAI,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,IAAI,CAAC,CAAC,CAAC,IAAI,IAAI,CAAC;QAClC,mCAAmC,CAAC,EAAE,EAAE,OAAO,CAAC;KACjD,CAAC,CAAC;IAEH,IAAI,CAAC,KAAK;QAAE,OAAO,IAAI,CAAC;IACxB,MAAM,IAAI,GAAG,gCAAgC,CAAC;QAC5C,KAAK;QACL,GAAG;QACH,KAAK;QACL,mBAAmB,EAAE,QAAQ,EAAE,IAAI,IAAI,IAAI;KAC5C,CAAC,CAAC;IACH,MAAM,MAAM,GAAG,MAAM,eAAe,CAAC,EAAE,CAAC,CAAC,mBAAmB,CAAC;QAC3D,OAAO;QACP,GAAG,EAAE,uCAAuC;QAC5C,KAAK,EAAE,gCAAgC;QACvC,MAAM,EAAE,UAAU;QAClB,IAAI;QACJ,cAAc,EAAE,QAAQ,EAAE,gBAAgB,IAAI,IAAI;QAClD,aAAa,EAAE,0CAA0C,GAAG,CAAC,EAAE,EAAE;QACjE,gBAAgB,EAAE,KAAK,CAAC,EAAE;QAC1B,cAAc,EAAE,GAAG,CAAC,EAAE;KACvB,CAAC,CAAC;IACH,OAAO,MAAM,CAAC,QAAQ,CAAC;AACzB,CAAC"}

package/dist/services/issue-execution-policy.d.ts

@@ -0,0 +1,93 @@
+import type { IssueExecutionDecision, IssueExecutionMonitorClearReason, IssueExecutionPolicy, IssueExecutionStagePrincipal, IssueExecutionState, IssueMonitorScheduledBy } from "@dealdesk/shared";
+type AssigneeLike = {
+    assigneeAgentId?: string | null;
+    assigneeUserId?: string | null;
+};
+type IssueLike = AssigneeLike & {
+    status: string;
+    executionPolicy?: IssueExecutionPolicy | Record<string, unknown> | null;
+    executionState?: IssueExecutionState | Record<string, unknown> | null;
+    monitorNextCheckAt?: Date | null;
+    monitorWakeRequestedAt?: Date | null;
+    monitorLastTriggeredAt?: Date | null;
+    monitorAttemptCount?: number | null;
+    monitorNotes?: string | null;
+    monitorScheduledBy?: string | null;
+};
+type ActorLike = {
+    agentId?: string | null;
+    userId?: string | null;
+};
+type RequestedAssigneePatch = {
+    assigneeAgentId?: string | null;
+    assigneeUserId?: string | null;
+};
+type TransitionInput = {
+    issue: IssueLike;
+    policy: IssueExecutionPolicy | null;
+    previousPolicy?: IssueExecutionPolicy | null;
+    requestedStatus?: string;
+    requestedAssigneePatch: RequestedAssigneePatch;
+    actor: ActorLike;
+    commentBody?: string | null;
+    reviewRequest?: IssueExecutionState["reviewRequest"] | null;
+    monitorExplicitlyUpdated?: boolean;
+};
+type TransitionResult = {
+    patch: Record<string, unknown>;
+    decision?: Pick<IssueExecutionDecision, "stageId" | "stageType" | "outcome" | "body">;
+    workflowControlledAssignment?: boolean;
+};
+export declare const REDACTED_ISSUE_MONITOR_EXTERNAL_REF = "[redacted]";
+export declare function redactIssueMonitorExternalRef(value: string | null | undefined): "[redacted]" | null;
+export declare function stripMonitorFromExecutionPolicy(policy: IssueExecutionPolicy | null): IssueExecutionPolicy | null;
+export declare function setIssueExecutionPolicyMonitorScheduledBy(policy: IssueExecutionPolicy | null, scheduledBy: IssueMonitorScheduledBy): IssueExecutionPolicy | null;
+export declare function normalizeIssueExecutionPolicy(input: unknown): IssueExecutionPolicy | null;
+export declare function parseIssueExecutionState(input: unknown): IssueExecutionState | null;
+export declare function assigneePrincipal(input: AssigneeLike): IssueExecutionStagePrincipal | null;
+export declare function buildInitialIssueMonitorFields(input: {
+    policy: IssueExecutionPolicy | null;
+    status: string;
+    assigneeAgentId?: string | null;
+    assigneeUserId?: string | null;
+}): {
+    monitorNextCheckAt?: undefined;
+    monitorWakeRequestedAt?: undefined;
+    monitorNotes?: undefined;
+    monitorScheduledBy?: undefined;
+    executionState?: undefined;
+} | {
+    monitorNextCheckAt: Date;
+    monitorWakeRequestedAt: null;
+    monitorNotes: string | null;
+    monitorScheduledBy: "board" | "assignee";
+    executionState: Record<string, unknown> | null;
+};
+export declare function buildIssueMonitorTriggeredPatch(input: {
+    issue: IssueLike;
+    policy: IssueExecutionPolicy | null;
+    triggeredAt: Date;
+}): {
+    executionPolicy: Record<string, unknown> | null;
+    executionState: Record<string, unknown> | null;
+    monitorNextCheckAt: null;
+    monitorWakeRequestedAt: null;
+    monitorLastTriggeredAt: Date;
+    monitorAttemptCount: number;
+    monitorNotes: string | null;
+    monitorScheduledBy: "board" | "assignee" | null;
+};
+export declare function buildIssueMonitorClearedPatch(input: {
+    issue: IssueLike;
+    policy: IssueExecutionPolicy | null;
+    clearReason: IssueExecutionMonitorClearReason;
+    clearedAt?: Date;
+}): {
+    executionPolicy: Record<string, unknown> | null;
+    executionState: Record<string, unknown> | null;
+    monitorNextCheckAt: null;
+    monitorWakeRequestedAt: null;
+};
+export declare function applyIssueExecutionPolicyTransition(input: TransitionInput): TransitionResult;
+export {};
+//# sourceMappingURL=issue-execution-policy.d.ts.map

package/dist/services/issue-execution-policy.d.ts.map

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