@rudderhq/server 0.7.10 → 0.7.12

package/dist/services/goals.d.ts

@@ -12,8 +12,8 @@
  * - doc/product/domains/organizations-and-goals/goals-and-projects.md
  */
 import type { Db } from "@rudderhq/db";
-import { agents, goalActivities, goalChangeProposals, goalFeedbackEntries, goalOwnerAssignments, goalPlans, goalResultProposals, goals } from "@rudderhq/db";
-import type { AcceptGoalResultProposal, ActivateGoal, AssignGoalOwner, CreateGoalActivity, CreateGoalChangeProposal, CreateGoalFeedback, CreateGoalResultProposal, DecideGoalChangeProposal, EvaluateGoal, GoalContractPatch, GoalContractSnapshot, GoalDependencies, GoalEvaluationCandidate, GoalHistoryItem, GoalHistoryPage, GoalResultProposal, GoalResultReducerPreflight, GoalStartPreview, IssueAssigneeAgentRuntimeOverrides, PreviewGoalStart, PublicGoal, PublicGoalActivity, PublicGoalChangeProposal, PublicGoalOwnerAssignment, PublicGoalPlan, PublicGoalResultProposal, RejectGoalResultProposal, StartGoal, UpdateGoalPlan } from "@rudderhq/shared";
+import { agents, goalActivities, goalChangeProposals, goalCheckpoints, goalFeedbackEntries, goalOwnerAssignments, goalPlans, goalResultProposals, goals } from "@rudderhq/db";
+import type { AcceptGoalResultProposal, ActivateGoal, AssignGoalOwner, CreateGoalActivity, CreateGoalChangeProposal, CreateGoalFeedback, CreateGoalResultProposal, DecideGoalChangeProposal, EvaluateGoal, GoalCheckpointInput, GoalContractPatch, GoalContractSnapshot, GoalDependencies, GoalEvaluationCandidate, GoalHistoryItem, GoalHistoryPage, GoalResultProposal, GoalResultReducerPreflight, GoalStartPreview, IssueAssigneeAgentRuntimeOverrides, PreviewGoalStart, PublicGoal, PublicGoalActivity, PublicGoalChangeProposal, PublicGoalOwnerAssignment, PublicGoalPlan, PublicGoalResultProposal, RejectGoalResultProposal, StartGoal, UpdateGoalPlan } from "@rudderhq/shared";
 type GoalRow = typeof goals.$inferSelect;
 type GoalWakeupActor = {
     actorType: "user" | "agent" | "system";
@@ -24,7 +24,7 @@ type GoalWakeupDispatch = {
     wakeupRequestId: string;
     source: "on_demand";
     triggerDetail: "system";
-    reason: "goal_started" | "goal_feedback" | "goal_change_decided";
+    reason: "goal_started" | "goal_feedback" | "goal_change_decided" | "goal_continuation";
     payload: Record<string, unknown>;
     contextSnapshot: Record<string, unknown>;
     requestedByActorType: GoalWakeupActor["actorType"];
@@ -45,6 +45,28 @@ type PublicEvidenceOptions = {
 export declare function publicGoalText(value: string): string;
 export declare function publicGoalView(goal: GoalRow): PublicGoal;
 export declare function publicGoalActivity(activity: typeof goalActivities.$inferSelect, options?: PublicEvidenceOptions): PublicGoalActivity;
+export declare function publicGoalCheckpoint(checkpoint: typeof goalCheckpoints.$inferSelect): {
+    id: string;
+    orgId: string;
+    goalId: string;
+    runId: string;
+    ownerAgentId: string;
+    submittedByAgentId: string;
+    inputHash: string;
+    idempotencyKey: string;
+    summary: string;
+    evidenceRefs: string[];
+    planPayload: Record<string, unknown> | null;
+    planRevisionBefore: number;
+    planRevisionAfter: number;
+    continuation: {
+        kind: "commitment" | "wait" | "decision" | "verification";
+        summary: string;
+        wakeCondition: string | null;
+    };
+    continuationWakeupRequestId: string | null;
+    createdAt: Date;
+};
 export declare function publicGoalDetail(input: GoalRow & {
     ownerAssignment: typeof goalOwnerAssignments.$inferSelect | null;
     plan: typeof goalPlans.$inferSelect | null;
@@ -62,6 +84,7 @@ export declare function publicGoalDetail(input: GoalRow & {
     } | null;
     activities: PublicGoalActivity[];
     id: string;
+    shortRef?: string;
     orgId: string;
     title: string;
     description: string | null;
@@ -1243,6 +1266,41 @@ export declare function goalService(db: Db): {
         createdAt: Date;
         updatedAt: Date;
     }>;
+    resolveByReference: (orgId: string, reference: string) => Promise<{
+        readonly goal: {
+            id: string;
+            orgId: string;
+            title: string;
+            description: string | null;
+            alignmentQuestion: string | null;
+            outcomeStatement: string | null;
+            objectiveMode: string;
+            lifecycle: string;
+            contractRevision: number;
+            criteria: unknown[];
+            autonomyEnvelope: Record<string, unknown>;
+            humanAuthorities: Record<string, unknown>;
+            evaluationPolicy: Record<string, unknown>;
+            actionDeadline: Date | null;
+            evaluationDeadline: Date | null;
+            evaluationResult: Record<string, unknown> | null;
+            closeReason: string | null;
+            resultPayload: Record<string, unknown> | null;
+            focus: boolean;
+            planRevision: number;
+            continuationKind: string | null;
+            continuationSummary: string | null;
+            wakeCondition: string | null;
+            level: string;
+            status: string;
+            parentId: string | null;
+            ownerAgentId: string | null;
+            ownerAgentRuntimeOverrides: IssueAssigneeAgentRuntimeOverrides | null;
+            createdAt: Date;
+            updatedAt: Date;
+        } | null;
+        readonly ambiguous: boolean;
+    }>;
     getChangeProposalById: (id: string) => Promise<{
         id: string;
         orgId: string;
@@ -1467,6 +1525,53 @@ export declare function goalService(db: Db): {
         createdAt: Date;
         updatedAt: Date;
     }>;
+    latestCheckpoint: (id: string) => Promise<{
+        id: string;
+        orgId: string;
+        goalId: string;
+        runId: string;
+        ownerAgentId: string;
+        submittedByAgentId: string;
+        inputHash: string;
+        idempotencyKey: string;
+        summary: string;
+        evidenceRefs: string[];
+        planPayload: Record<string, unknown> | null;
+        planRevisionBefore: number;
+        planRevisionAfter: number;
+        continuationKind: "commitment" | "wait" | "decision" | "verification";
+        continuationSummary: string;
+        wakeCondition: string | null;
+        continuationWakeupRequestId: string | null;
+        createdAt: Date;
+    }>;
+    recentCheckpoints: (id: string) => Promise<{
+        id: string;
+        orgId: string;
+        goalId: string;
+        runId: string;
+        ownerAgentId: string;
+        submittedByAgentId: string;
+        inputHash: string;
+        idempotencyKey: string;
+        summary: string;
+        evidenceRefs: string[];
+        planPayload: Record<string, unknown> | null;
+        planRevisionBefore: number;
+        planRevisionAfter: number;
+        continuationKind: "commitment" | "wait" | "decision" | "verification";
+        continuationSummary: string;
+        wakeCondition: string | null;
+        continuationWakeupRequestId: string | null;
+        createdAt: Date;
+    }[]>;
+    pendingContinuationWake: (id: string) => Promise<{
+        id: string;
+        status: string;
+        planRevision: number | null;
+        checkpointId: string | null;
+        continuation: Record<string, unknown>;
+    } | null>;
     create: (orgId: string, data: {
         title: string;
         description?: string | null;
@@ -1593,6 +1698,29 @@ export declare function goalService(db: Db): {
         invalidationConditions: unknown[];
         createdByAgentId: string | null;
     }>;
+    checkpoint: (id: string, input: GoalCheckpointInput, actorAgentId: string | null, actorRunId: string | null) => Promise<{
+        checkpoint: {
+            id: string;
+            runId: string;
+            summary: string;
+            orgId: string;
+            ownerAgentId: string;
+            createdAt: Date;
+            goalId: string;
+            wakeCondition: string | null;
+            evidenceRefs: string[];
+            idempotencyKey: string;
+            continuationSummary: string;
+            continuationKind: "commitment" | "wait" | "decision" | "verification";
+            submittedByAgentId: string;
+            inputHash: string;
+            planPayload: Record<string, unknown> | null;
+            planRevisionBefore: number;
+            planRevisionAfter: number;
+            continuationWakeupRequestId: string | null;
+        };
+        dispatch: GoalWakeupDispatch | null;
+    }>;
     listActivities: (id: string) => Omit<import("drizzle-orm/pg-core").PgSelectBase<"goal_activities", {
         id: import("drizzle-orm/pg-core").PgColumn<{
             name: "id";
@@ -2098,10 +2226,10 @@ export declare function goalService(db: Db): {
         orgId: string;
         createdAt: Date;
         goalId: string;
-        commitmentRef: string | null;
-        runRef: string | null;
         evidenceRefs: unknown[];
         idempotencyKey: string | null;
+        commitmentRef: string | null;
+        runRef: string | null;
         occurredAt: Date;
         contractRevision: number;
         submittedByAgentId: string | null;

package/dist/services/goals.d.ts.map

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

package/dist/services/goals.js

@@ -1,9 +1,17 @@
-import { agentWakeupRequests, agents, approvals, assets, authUsers, automations, calendarEvents, costEvents, financeEvents, goalActivities, goalChangeProposals, goalFeedbackEntries, goalOwnerAssignments, goalPlans, goalResultProposals, goalStartRequests, goals, heartbeatRuns, issues, organizations, projectGoals, projects, } from "@rudderhq/db";
-import { activateGoalSchema, parseLibraryEntryMentionHref, parseLibraryFileMentionHref } from "@rudderhq/shared";
+import { agentWakeupRequests, agents, approvals, assets, authUsers, automations, calendarEvents, costEvents, financeEvents, goalActivities, goalChangeProposals, goalCheckpoints, goalFeedbackEntries, goalOwnerAssignments, goalPlans, goalResultProposals, goalStartRequests, goals, heartbeatRuns, issues, organizations, projectGoals, projects, } from "@rudderhq/db";
+import { activateGoalSchema, parseLibraryEntryMentionHref, parseLibraryFileMentionHref, parseShortRef, shortRefFor } from "@rudderhq/shared";
 import { and, asc, desc, eq, gt, inArray, isNotNull, isNull, lt, or, sql } from "drizzle-orm";
 import { createHash, randomUUID } from "node:crypto";
 import { badRequest, conflict, forbidden, notFound, unprocessable } from "../errors.js";
 import { buildDeferredWakePayload, readDeferredWakePayload } from "./runtime-kernel/heartbeat.sessions.js";
+function safeGoalShortRef(id) {
+    try {
+        return shortRefFor("goal", id);
+    }
+    catch {
+        return undefined;
+    }
+}
 const DEPENDENCY_PREVIEW_LIMIT = 5;
 const GOAL_HISTORY_DEFAULT_LIMIT = 50;
 const GOAL_HISTORY_MAX_LIMIT = 100;
@@ -364,6 +372,7 @@ export function publicGoalView(goal) {
     const evaluation = publicGoalRecord(goal.evaluationResult);
     return {
         id: goal.id,
+        ...(safeGoalShortRef(goal.id) ? { shortRef: safeGoalShortRef(goal.id) } : {}),
         orgId: goal.orgId,
         title: goal.title,
         description: goal.description,
@@ -400,6 +409,30 @@ export function publicGoalActivity(activity, options = {}) {
         createdAt: activity.createdAt,
     };
 }
+export function publicGoalCheckpoint(checkpoint) {
+    return {
+        id: checkpoint.id,
+        orgId: checkpoint.orgId,
+        goalId: checkpoint.goalId,
+        runId: checkpoint.runId,
+        ownerAgentId: checkpoint.ownerAgentId,
+        submittedByAgentId: checkpoint.submittedByAgentId,
+        inputHash: checkpoint.inputHash,
+        idempotencyKey: checkpoint.idempotencyKey,
+        summary: publicGoalText(checkpoint.summary),
+        evidenceRefs: checkpoint.evidenceRefs,
+        planPayload: checkpoint.planPayload,
+        planRevisionBefore: checkpoint.planRevisionBefore,
+        planRevisionAfter: checkpoint.planRevisionAfter,
+        continuation: {
+            kind: checkpoint.continuationKind,
+            summary: publicGoalText(checkpoint.continuationSummary),
+            wakeCondition: checkpoint.wakeCondition,
+        },
+        continuationWakeupRequestId: checkpoint.continuationWakeupRequestId,
+        createdAt: checkpoint.createdAt,
+    };
+}
 export function publicGoalDetail(input, options = {}) {
     return {
         ...publicGoalView(input),
@@ -1012,15 +1045,47 @@ export function goalService(db) {
         ]), isNull(agentWakeupRequests.runId))).orderBy(desc(agentWakeupRequests.requestedAt)).limit(1)
             .then((rows) => rows[0] ?? null);
     }
+    async function cancelPendingGoalContinuationWakes(database, goalId, reason) {
+        const pending = await database.select({
+            id: agentWakeupRequests.id,
+            runId: agentWakeupRequests.runId,
+        }).from(agentWakeupRequests).where(and(sql `${agentWakeupRequests.payload} ->> 'goalId' = ${goalId}`, eq(agentWakeupRequests.reason, "goal_continuation"), inArray(agentWakeupRequests.status, ["queued", "deferred_goal_focus", "deferred_agent_paused", "deferred_goal_blocked"])));
+        if (pending.length === 0)
+            return;
+        const now = new Date();
+        for (const wake of pending) {
+            if (wake.runId) {
+                await database.update(heartbeatRuns).set({
+                    status: "cancelled",
+                    finishedAt: now,
+                    error: reason,
+                    errorCode: "goal.result_proposal_ready",
+                    updatedAt: now,
+                }).where(and(eq(heartbeatRuns.id, wake.runId), eq(heartbeatRuns.status, "queued")));
+            }
+            await database.update(agentWakeupRequests).set({
+                status: "cancelled",
+                finishedAt: now,
+                error: reason,
+                updatedAt: now,
+            }).where(and(eq(agentWakeupRequests.id, wake.id), inArray(agentWakeupRequests.status, ["queued", "deferred_goal_focus", "deferred_agent_paused", "deferred_goal_blocked"])));
+        }
+    }
     async function ensureGoalWakeupIntent(database, goal, input) {
         if (!goal.ownerAgentId)
             throw conflict("Goal has no Owner Agent to wake");
+        const currentPlan = goal.planRevision > 0
+            ? await database.select().from(goalPlans).where(and(eq(goalPlans.goalId, goal.id), eq(goalPlans.revision, goal.planRevision))).then((rows) => rows[0] ?? null)
+            : null;
+        const latestCheckpoint = await database.select().from(goalCheckpoints).where(eq(goalCheckpoints.goalId, goal.id)).orderBy(desc(goalCheckpoints.createdAt)).limit(1).then((rows) => rows[0] ?? null);
         const taskKey = `goal:${goal.id}:${input.event}:${input.eventId}`;
         const idempotencyKey = input.event === "goal_started"
             ? `goal-start:${input.eventId}`
             : input.event === "goal_feedback"
                 ? `goal-feedback:${input.eventId}`
-                : `goal-change-decision:${input.eventId}:${input.decision?.decision ?? "unknown"}`;
+                : input.event === "goal_change_decided"
+                    ? `goal-change-decision:${input.eventId}:${input.decision?.decision ?? "unknown"}`
+                    : `goal-continuation:${input.eventId}`;
         const payload = {
             event: input.event,
             goalId: goal.id,
@@ -1028,6 +1093,15 @@ export function goalService(db) {
             ...(input.event === "goal_started" ? { goalStartRequestId: input.eventId } : {}),
             ...(input.feedback ? { feedbackId: input.feedback.id } : {}),
             ...(input.decision ? { goalChangeProposalId: input.eventId, decision: input.decision.decision } : {}),
+            ...(input.continuation ? {
+                checkpointId: input.eventId,
+                planRevision: input.continuation.planRevision,
+                continuation: {
+                    kind: input.continuation.kind,
+                    summary: input.continuation.summary,
+                    wakeCondition: input.continuation.wakeCondition ?? null,
+                },
+            } : {}),
         };
         const contextSnapshot = {
             goalId: goal.id,
@@ -1046,6 +1120,18 @@ export function goalService(db) {
                 actionDeadline: goal.actionDeadline,
                 evaluationDeadline: goal.evaluationDeadline,
             },
+            goalPlan: currentPlan
+                ? {
+                    revision: currentPlan.revision,
+                    summary: currentPlan.summary,
+                    hypotheses: currentPlan.hypotheses,
+                    selectedPaths: currentPlan.selectedPaths,
+                    rejectedPaths: currentPlan.rejectedPaths,
+                    sequencing: currentPlan.sequencing,
+                    budgetAllocations: currentPlan.budgetAllocations,
+                    invalidationConditions: currentPlan.invalidationConditions,
+                }
+                : null,
             goalContinuation: {
                 kind: goal.continuationKind,
                 summary: goal.continuationSummary,
@@ -1066,6 +1152,21 @@ export function goalService(db) {
                     status: input.decision.status,
                 },
             } : {}),
+            ...(latestCheckpoint ? {
+                goalCheckpoint: {
+                    id: latestCheckpoint.id,
+                    summary: latestCheckpoint.summary,
+                    evidenceRefs: latestCheckpoint.evidenceRefs,
+                    planRevisionBefore: latestCheckpoint.planRevisionBefore,
+                    planRevisionAfter: latestCheckpoint.planRevisionAfter,
+                    continuationWakeupRequestId: latestCheckpoint.continuationWakeupRequestId,
+                    continuation: {
+                        kind: latestCheckpoint.continuationKind,
+                        summary: latestCheckpoint.continuationSummary,
+                        wakeCondition: latestCheckpoint.wakeCondition,
+                    },
+                },
+            } : {}),
         };
         const storedPayload = buildDeferredWakePayload(payload, contextSnapshot);
         const [inserted] = await database.insert(agentWakeupRequests).values({
@@ -1591,6 +1692,17 @@ export function goalService(db) {
     return {
         list: (orgId) => db.select().from(goals).where(eq(goals.orgId, orgId)).orderBy(asc(goals.createdAt)),
         getById: (id) => db.select().from(goals).where(eq(goals.id, id)).then((rows) => rows[0] ?? null),
+        resolveByReference: async (orgId, reference) => {
+            const parsed = parseShortRef(reference);
+            if (parsed?.kind !== "goal")
+                return { goal: null, ambiguous: false };
+            const rows = await db.select().from(goals).where(eq(goals.orgId, orgId));
+            const matches = rows.filter((row) => row.id.replaceAll("-", "").toLowerCase().startsWith(parsed.prefix));
+            return {
+                goal: matches.length === 1 ? matches[0] : null,
+                ambiguous: matches.length > 1,
+            };
+        },
         getChangeProposalById: (id) => db.select().from(goalChangeProposals)
             .where(eq(goalChangeProposals.id, id)).then((rows) => rows[0] ?? null),
         getResultProposalById: (id) => db.select().from(goalResultProposals)
@@ -1834,6 +1946,32 @@ export function goalService(db) {
             ]);
             return { ...goal, ownerAssignment, plan, activities };
         },
+        latestCheckpoint: async (id) => db.select().from(goalCheckpoints)
+            .where(eq(goalCheckpoints.goalId, id))
+            .orderBy(desc(goalCheckpoints.createdAt)).limit(1)
+            .then((rows) => rows[0] ?? null),
+        recentCheckpoints: async (id) => db.select().from(goalCheckpoints)
+            .where(eq(goalCheckpoints.goalId, id))
+            .orderBy(desc(goalCheckpoints.createdAt)).limit(3),
+        pendingContinuationWake: async (id) => db.select({
+            id: agentWakeupRequests.id,
+            status: agentWakeupRequests.status,
+            payload: agentWakeupRequests.payload,
+        }).from(agentWakeupRequests).where(and(sql `${agentWakeupRequests.payload} ->> 'goalId' = ${id}`, eq(agentWakeupRequests.reason, "goal_continuation"), inArray(agentWakeupRequests.status, ["queued", "deferred_goal_focus", "deferred_agent_paused", "deferred_goal_blocked"]), isNull(agentWakeupRequests.runId))).orderBy(desc(agentWakeupRequests.requestedAt)).limit(1)
+            .then((rows) => {
+            const row = rows[0];
+            if (!row)
+                return null;
+            const payload = publicGoalRecord(row.payload);
+            const continuation = publicGoalRecord(payload.continuation);
+            return {
+                id: row.id,
+                status: row.status,
+                planRevision: typeof payload.planRevision === "number" ? payload.planRevision : null,
+                checkpointId: typeof payload.checkpointId === "string" ? payload.checkpointId : null,
+                continuation,
+            };
+        }),
         create: async (orgId, data) => {
             if (data.ownerAgentId)
                 await requireInvokableOwner(db, orgId, data.ownerAgentId);
@@ -1970,6 +2108,119 @@ export function goalService(db) {
                 return plan;
             });
         },
+        checkpoint: async (id, input, actorAgentId, actorRunId) => {
+            if (!actorAgentId)
+                throw forbidden("Only the Goal Owner Agent can create a checkpoint");
+            if (!actorRunId)
+                throw unprocessable("Goal checkpoint must be attributed to the current Run");
+            const inputHash = stableGoalHash({
+                summary: input.summary,
+                evidenceRefs: input.evidenceRefs,
+                expectedPlanRevision: input.expectedPlanRevision,
+                plan: input.plan ?? null,
+                continuation: input.continuation,
+            });
+            return db.transaction(async (tx) => {
+                const database = tx;
+                const current = await requireGoalForUpdate(database, id);
+                assertCanonicalActiveGoal(current);
+                assertGoalOwner(current, actorAgentId);
+                const run = await requireGoalRun(database, current, actorRunId, actorAgentId);
+                const existing = await database.select().from(goalCheckpoints).where(and(eq(goalCheckpoints.goalId, id), eq(goalCheckpoints.idempotencyKey, input.idempotencyKey))).then((rows) => rows[0] ?? null);
+                if (existing) {
+                    if (existing.runId !== actorRunId) {
+                        throw conflict("Goal checkpoint idempotency key belongs to a different Run");
+                    }
+                    if (existing.inputHash !== inputHash) {
+                        throw conflict("Goal checkpoint idempotency key was reused with a different payload");
+                    }
+                    return { checkpoint: existing, dispatch: null };
+                }
+                if (run.status !== "running") {
+                    throw conflict("Goal checkpoint must be attributed to the current running Run");
+                }
+                const readyProposal = await database.select({ id: goalResultProposals.id }).from(goalResultProposals).where(and(eq(goalResultProposals.goalId, id), eq(goalResultProposals.status, "ready"))).limit(1).then((rows) => rows[0] ?? null);
+                if (readyProposal)
+                    throw conflict("Goal already has a Result Proposal ready for review");
+                if (current.planRevision !== input.expectedPlanRevision) {
+                    throw conflict("Goal Plan changed before checkpoint", {
+                        expectedPlanRevision: input.expectedPlanRevision,
+                        currentPlanRevision: current.planRevision,
+                    });
+                }
+                const nextPlanRevision = input.plan ? current.planRevision + 1 : current.planRevision;
+                if (input.plan) {
+                    await database.insert(goalPlans).values({
+                        orgId: current.orgId,
+                        goalId: current.id,
+                        revision: nextPlanRevision,
+                        ...input.plan,
+                        createdByAgentId: actorAgentId,
+                    });
+                }
+                const now = new Date();
+                const changedGoal = await database.update(goals).set({
+                    planRevision: nextPlanRevision,
+                    continuationKind: input.continuation.kind,
+                    continuationSummary: input.continuation.summary,
+                    wakeCondition: input.continuation.wakeCondition ?? null,
+                    updatedAt: now,
+                }).where(and(eq(goals.id, id), eq(goals.orgId, current.orgId), eq(goals.lifecycle, "active"), eq(goals.planRevision, input.expectedPlanRevision))).returning().then((rows) => rows[0] ?? null);
+                if (!changedGoal)
+                    throw conflict("Goal changed before checkpoint could be committed");
+                const [checkpoint] = await database.insert(goalCheckpoints).values({
+                    orgId: current.orgId,
+                    goalId: current.id,
+                    runId: actorRunId,
+                    ownerAgentId: current.ownerAgentId,
+                    submittedByAgentId: actorAgentId,
+                    inputHash,
+                    idempotencyKey: input.idempotencyKey,
+                    summary: input.summary,
+                    evidenceRefs: input.evidenceRefs,
+                    planPayload: input.plan ? { ...input.plan } : null,
+                    planRevisionBefore: current.planRevision,
+                    planRevisionAfter: nextPlanRevision,
+                    continuationKind: input.continuation.kind,
+                    continuationSummary: input.continuation.summary,
+                    wakeCondition: input.continuation.wakeCondition ?? null,
+                }).returning();
+                if (!checkpoint)
+                    throw conflict("Goal checkpoint could not be recorded");
+                await database.insert(goalActivities).values({
+                    orgId: current.orgId,
+                    goalId: current.id,
+                    contractRevision: current.contractRevision,
+                    submittedByAgentId: actorAgentId,
+                    agentOwnerRefAtTime: current.ownerAgentId,
+                    activityKind: "checkpoint",
+                    runRef: actorRunId,
+                    summary: input.summary,
+                    evidenceRefs: input.evidenceRefs,
+                    idempotencyKey: `goal-checkpoint:${input.idempotencyKey}`,
+                    occurredAt: now,
+                }).onConflictDoNothing();
+                let dispatch = null;
+                if (input.continuation.kind === "commitment" || input.continuation.kind === "verification") {
+                    dispatch = await ensureGoalWakeupIntent(database, changedGoal, {
+                        event: "goal_continuation",
+                        eventId: checkpoint.id,
+                        actor: { actorType: "agent", actorId: actorAgentId },
+                        continuation: {
+                            kind: input.continuation.kind,
+                            summary: input.continuation.summary,
+                            wakeCondition: input.continuation.wakeCondition ?? null,
+                            planRevision: nextPlanRevision,
+                        },
+                    });
+                    const updated = await database.update(goalCheckpoints).set({ continuationWakeupRequestId: dispatch.wakeupRequestId })
+                        .where(eq(goalCheckpoints.id, checkpoint.id)).returning().then((rows) => rows[0] ?? null);
+                    if (updated)
+                        return { checkpoint: updated, dispatch };
+                }
+                return { checkpoint, dispatch };
+            });
+        },
         listActivities: (id) => db.select().from(goalActivities).where(eq(goalActivities.goalId, id))
             .orderBy(desc(goalActivities.occurredAt), desc(goalActivities.createdAt)).limit(100),
         createActivity: async (id, input, actorAgentId = null) => {
@@ -2304,6 +2555,11 @@ export function goalService(db) {
             const candidateHash = stableGoalHash(candidate);
             return db.transaction(async (tx) => {
                 const database = tx;
+                // Heartbeat claims hold the Owner Agent row before Goal and Run rows;
+                // take the same lock first so Result Proposal cancellation cannot
+                // deadlock on heartbeat_runs.agent_id foreign-key checks.
+                await database.select({ id: agents.id }).from(agents)
+                    .where(eq(agents.id, actorAgentId)).for("update");
                 const current = await requireGoalForUpdate(database, id);
                 assertGoalOwner(current, actorAgentId);
                 if (actorRunId)
@@ -2328,6 +2584,7 @@ export function goalService(db) {
                     if (readyProposal) {
                         throw conflict("This Goal already has a Result Proposal ready for review");
                     }
+                    await cancelPendingGoalContinuationWakes(database, id, "Cancelled because a Goal Result Proposal is ready for human Acceptance");
                 }
                 const [proposal] = await database.insert(goalResultProposals).values({
                     orgId: current.orgId,