paperclip-github-plugin 0.4.9 → 0.5.0

package/dist/worker.js

@@ -636,6 +636,7 @@ var MISSING_MAPPING_SYNC_ACTION = "Open settings, add a repository mapping, let
 var MISSING_BOARD_ACCESS_SYNC_MESSAGE = "Connect Paperclip board access before running sync on this authenticated deployment.";
 var MISSING_BOARD_ACCESS_SYNC_ACTION = "Open plugin settings for each mapped company that sync will touch, connect Paperclip board access, approve the flow, and then run sync again.";
 var IMPORTED_ISSUE_WAKE_REASON = "GitHub Sync imported an assigned issue that is ready for work.";
+var STATUS_TRANSITION_WAKE_REASON = "GitHub Sync moved an assigned issue into its next active state.";
 var ISSUE_LINK_ENTITY_TYPE = "paperclip-github-plugin.issue-link";
 var PULL_REQUEST_LINK_ENTITY_TYPE = "paperclip-github-plugin.pull-request-link";
 var COMMENT_ANNOTATION_ENTITY_TYPE = "paperclip-github-plugin.comment-annotation";
@@ -2668,6 +2669,7 @@ function getPublicSettings(settings) {
     githubTokenRef: _githubTokenRef,
     paperclipBoardApiTokenRefs: _paperclipBoardApiTokenRefs,
     paperclipBoardAccessIdentityByCompanyId: _paperclipBoardAccessIdentityByCompanyId,
+    paperclipBoardAccessUserIdByCompanyId: _paperclipBoardAccessUserIdByCompanyId,
     companyAdvancedSettingsByCompanyId: _companyAdvancedSettingsByCompanyId,
     syncStateByCompanyId: _syncStateByCompanyId,
     scheduleFrequencyMinutesByCompanyId: _scheduleFrequencyMinutesByCompanyId,
@@ -2690,6 +2692,13 @@ function getPaperclipBoardAccessIdentity(settings, companyId) {
   }
   return normalizeOptionalString2(settings.paperclipBoardAccessIdentityByCompanyId?.[normalizedCompanyId]);
 }
+function getPaperclipBoardAccessUserId(settings, companyId) {
+  const normalizedCompanyId = normalizeCompanyId(companyId);
+  if (!normalizedCompanyId) {
+    return void 0;
+  }
+  return normalizeOptionalString2(settings.paperclipBoardAccessUserIdByCompanyId?.[normalizedCompanyId]);
+}
 function getPublicSettingsForScope(settings, companyId) {
   const publicSettings = getPublicSettings(settings);
   const githubTokenLogin = getGitHubTokenLogin(settings, companyId);
@@ -2702,24 +2711,54 @@ function getPublicSettingsForScope(settings, companyId) {
     ...paperclipBoardAccessIdentity ? { paperclipBoardAccessIdentity } : {}
   };
 }
-async function listAvailableAssignees(ctx, companyId) {
+function compareGitHubSyncAssigneeOptions(left, right) {
+  if (left.kind !== right.kind) {
+    return left.kind === "user" ? -1 : 1;
+  }
+  return left.name.localeCompare(right.name);
+}
+function sortGitHubSyncAssigneeOptions(options) {
+  return [...options].sort(compareGitHubSyncAssigneeOptions);
+}
+function getConnectedBoardUserAssigneeOption(settings, companyId) {
+  const userId = getPaperclipBoardAccessUserId(settings, companyId);
+  if (!userId) {
+    return null;
+  }
+  const identityLabel = getPaperclipBoardAccessIdentity(settings, companyId);
+  return {
+    kind: "user",
+    id: userId,
+    name: "Me",
+    ...identityLabel ? { title: identityLabel } : {}
+  };
+}
+async function listAvailableAssignees(ctx, companyId, settings) {
+  const connectedBoardUserOption = settings ? getConnectedBoardUserAssigneeOption(settings, companyId) : null;
   try {
     const agents = await ctx.agents.list({
       companyId,
       limit: 500
     });
-    return agents.filter((agent) => agent.status !== "terminated").map((agent) => ({
+    const assignees = agents.filter((agent) => agent.status !== "terminated").map((agent) => ({
+      kind: "agent",
       id: agent.id,
       name: agent.name,
       ...agent.title?.trim() ? { title: agent.title.trim() } : {},
       ...agent.status ? { status: agent.status } : {}
-    })).sort((left, right) => left.name.localeCompare(right.name));
+    }));
+    if (connectedBoardUserOption) {
+      assignees.push(connectedBoardUserOption);
+    }
+    return sortGitHubSyncAssigneeOptions(
+      [...new Map(assignees.map((assignee) => [`${assignee.kind}:${assignee.id}`, assignee])).values()]
+    );
   } catch (error) {
     ctx.logger.warn("Unable to list company agents for GitHub Sync advanced settings.", {
       companyId,
       error: getErrorMessage(error)
     });
-    return [];
+    return connectedBoardUserOption ? [connectedBoardUserOption] : [];
   }
 }
 async function resolvePaperclipIssueDrawerAgents(ctx, companyId, agentIds) {
@@ -3218,6 +3257,20 @@ function normalizePaperclipBoardAccessIdentityByCompanyId(value) {
   }
   return Object.fromEntries(entries);
 }
+function normalizePaperclipBoardAccessUserIdByCompanyId(value) {
+  if (!value || typeof value !== "object") {
+    return void 0;
+  }
+  const entries = Object.entries(value).map(([companyId, userId]) => {
+    const normalizedCompanyId = normalizeCompanyId(companyId);
+    const normalizedUserId = normalizeOptionalString2(userId);
+    return normalizedCompanyId && normalizedUserId ? [normalizedCompanyId, normalizedUserId] : null;
+  }).filter((entry) => entry !== null);
+  if (entries.length === 0) {
+    return void 0;
+  }
+  return Object.fromEntries(entries);
+}
 function normalizeSyncCancellationRequest(value) {
   if (!value || typeof value !== "object") {
     return null;
@@ -3308,17 +3361,46 @@ function normalizeAgentIds(value) {
   const entries = Array.isArray(value) ? value.map((entry) => normalizeOptionalString2(entry)).filter((entry) => Boolean(entry)) : [];
   return [...new Set(entries)].sort((left, right) => left.localeCompare(right));
 }
+function normalizeAdvancedSettingsAssigneeOverride(record, keys) {
+  const userId = normalizeOptionalString2(record[keys.userId]);
+  if (userId) {
+    return {
+      [keys.userId]: userId
+    };
+  }
+  const agentId = normalizeOptionalString2(record[keys.agentId]);
+  if (agentId) {
+    return {
+      [keys.agentId]: agentId
+    };
+  }
+  return {};
+}
 function normalizeAdvancedSettings(value) {
   if (!value || typeof value !== "object") {
     return DEFAULT_ADVANCED_SETTINGS;
   }
   const record = value;
-  const defaultAssigneeAgentId = normalizeOptionalString2(record.defaultAssigneeAgentId);
   const defaultStatus = "defaultStatus" in record ? coercePaperclipIssueStatus(record.defaultStatus) : DEFAULT_ADVANCED_SETTINGS.defaultStatus;
   const ignoredIssueAuthorUsernames = "ignoredIssueAuthorUsernames" in record ? normalizeIgnoredIssueAuthorUsernames(record.ignoredIssueAuthorUsernames) : DEFAULT_ADVANCED_SETTINGS.ignoredIssueAuthorUsernames;
   const githubTokenPropagationAgentIds = "githubTokenPropagationAgentIds" in record ? normalizeAgentIds(record.githubTokenPropagationAgentIds) : [];
   return {
-    ...defaultAssigneeAgentId ? { defaultAssigneeAgentId } : {},
+    ...normalizeAdvancedSettingsAssigneeOverride(record, {
+      agentId: "defaultAssigneeAgentId",
+      userId: "defaultAssigneeUserId"
+    }),
+    ...normalizeAdvancedSettingsAssigneeOverride(record, {
+      agentId: "executorAssigneeAgentId",
+      userId: "executorAssigneeUserId"
+    }),
+    ...normalizeAdvancedSettingsAssigneeOverride(record, {
+      agentId: "reviewerAssigneeAgentId",
+      userId: "reviewerAssigneeUserId"
+    }),
+    ...normalizeAdvancedSettingsAssigneeOverride(record, {
+      agentId: "approverAssigneeAgentId",
+      userId: "approverAssigneeUserId"
+    }),
     defaultStatus,
     ignoredIssueAuthorUsernames,
     ...githubTokenPropagationAgentIds.length > 0 ? { githubTokenPropagationAgentIds } : {}
@@ -3476,6 +3558,9 @@ function normalizeSettings(value) {
   const paperclipBoardAccessIdentityByCompanyId = normalizePaperclipBoardAccessIdentityByCompanyId(
     record.paperclipBoardAccessIdentityByCompanyId
   );
+  const paperclipBoardAccessUserIdByCompanyId = normalizePaperclipBoardAccessUserIdByCompanyId(
+    record.paperclipBoardAccessUserIdByCompanyId
+  );
   const companyAdvancedSettingsByCompanyId = normalizeCompanyAdvancedSettingsByCompanyId(record.companyAdvancedSettingsByCompanyId);
   return {
     mappings: normalizeMappings(record.mappings),
@@ -3491,6 +3576,7 @@ function normalizeSettings(value) {
     ...githubTokenLogin ? { githubTokenLogin } : {},
     ...paperclipBoardApiTokenRefs ? { paperclipBoardApiTokenRefs } : {},
     ...paperclipBoardAccessIdentityByCompanyId ? { paperclipBoardAccessIdentityByCompanyId } : {},
+    ...paperclipBoardAccessUserIdByCompanyId ? { paperclipBoardAccessUserIdByCompanyId } : {},
     ...companyAdvancedSettingsByCompanyId ? { companyAdvancedSettingsByCompanyId } : {},
     updatedAt: typeof record.updatedAt === "string" ? record.updatedAt : void 0
   };
@@ -4107,9 +4193,9 @@ function classifyGitHubPullRequestCiState(contexts) {
   }
   return hasPendingContext ? "unfinished" : "green";
 }
-function resolvePaperclipStatusFromLinkedPullRequests(linkedPullRequests) {
+function resolvePaperclipStatusFromLinkedPullRequests(linkedPullRequests, options) {
   if (linkedPullRequests.some((pullRequest) => pullRequest.hasUnresolvedReviewThreads || pullRequest.ciState === "red")) {
-    return "todo";
+    return options?.preferInProgress ? "in_progress" : "todo";
   }
   if (linkedPullRequests.length > 0 && linkedPullRequests.every(
     (pullRequest) => pullRequest.ciState === "green" && pullRequest.hasUnresolvedReviewThreads === false
@@ -4141,6 +4227,354 @@ function formatPaperclipIssueStatus(status) {
 function normalizePaperclipIssueStatus(value) {
   return PAPERCLIP_ISSUE_STATUSES.includes(value) ? value : void 0;
 }
+function normalizePaperclipIssueExecutionStageType(value) {
+  return value === "review" || value === "approval" ? value : void 0;
+}
+function normalizePaperclipIssueAssigneePrincipal(value) {
+  if (!value || typeof value !== "object") {
+    return null;
+  }
+  const record = value;
+  const principalType = normalizeOptionalString2(record.type);
+  const agentId = normalizeOptionalString2(record.agentId);
+  const userId = normalizeOptionalString2(record.userId);
+  if ((principalType === void 0 || principalType === "agent") && agentId) {
+    return {
+      kind: "agent",
+      id: agentId
+    };
+  }
+  if ((principalType === void 0 || principalType === "user") && userId) {
+    return {
+      kind: "user",
+      id: userId
+    };
+  }
+  return null;
+}
+function normalizePaperclipIssueExecutionStage(value) {
+  if (!value || typeof value !== "object") {
+    return null;
+  }
+  const record = value;
+  const type = normalizePaperclipIssueExecutionStageType(record.type);
+  const participants = Array.isArray(record.participants) ? record.participants.map((participant) => normalizePaperclipIssueAssigneePrincipal(participant)).filter((participant) => participant !== null) : [];
+  if (!type || participants.length === 0) {
+    return null;
+  }
+  const id = normalizeOptionalString2(record.id);
+  return {
+    ...id ? { id } : {},
+    type,
+    participants
+  };
+}
+function normalizePaperclipIssueExecutionPolicy(value) {
+  if (!value || typeof value !== "object") {
+    return null;
+  }
+  const rawStages = value.stages;
+  const stages = Array.isArray(rawStages) ? rawStages.map((stage) => normalizePaperclipIssueExecutionStage(stage)).filter((stage) => stage !== null) : [];
+  return stages.length > 0 ? {
+    stages
+  } : null;
+}
+function normalizePaperclipIssueExecutionState(value) {
+  if (!value || typeof value !== "object") {
+    return null;
+  }
+  const record = value;
+  const status = normalizeOptionalString2(record.status);
+  const currentStageId = normalizeOptionalString2(record.currentStageId) ?? null;
+  const currentStageIndex = typeof record.currentStageIndex === "number" && Number.isInteger(record.currentStageIndex) ? record.currentStageIndex : null;
+  const currentStageType = normalizePaperclipIssueExecutionStageType(record.currentStageType) ?? null;
+  const currentParticipant = normalizePaperclipIssueAssigneePrincipal(record.currentParticipant);
+  const returnAssignee = normalizePaperclipIssueAssigneePrincipal(record.returnAssignee);
+  const lastDecisionId = normalizeOptionalString2(record.lastDecisionId) ?? null;
+  const lastDecisionOutcome = normalizeOptionalString2(record.lastDecisionOutcome) ?? null;
+  const completedStageIds = Array.isArray(record.completedStageIds) ? record.completedStageIds.map((stageId) => normalizeOptionalString2(stageId)).filter((stageId) => Boolean(stageId)) : [];
+  if (!status && currentStageId === null && currentStageIndex === null && currentStageType === null && currentParticipant === null && returnAssignee === null && completedStageIds.length === 0 && lastDecisionId === null && lastDecisionOutcome === null) {
+    return null;
+  }
+  return {
+    ...status ? { status } : {},
+    currentStageId,
+    currentStageIndex,
+    currentStageType,
+    currentParticipant,
+    returnAssignee,
+    completedStageIds,
+    ...lastDecisionId !== null ? { lastDecisionId } : {},
+    ...lastDecisionOutcome !== null ? { lastDecisionOutcome } : {}
+  };
+}
+function getPaperclipIssueAssigneePrincipal(issue) {
+  const record = issue;
+  const assigneeAgentId = normalizeOptionalString2(record.assigneeAgentId);
+  if (assigneeAgentId) {
+    return {
+      kind: "agent",
+      id: assigneeAgentId
+    };
+  }
+  const assigneeUserId = normalizeOptionalString2(record.assigneeUserId);
+  return assigneeUserId ? {
+    kind: "user",
+    id: assigneeUserId
+  } : null;
+}
+function getPaperclipIssueSyncContext(issue) {
+  const record = issue;
+  return {
+    assignee: getPaperclipIssueAssigneePrincipal(issue),
+    executionPolicy: normalizePaperclipIssueExecutionPolicy(record.executionPolicy),
+    executionState: normalizePaperclipIssueExecutionState(record.executionState)
+  };
+}
+function isSamePaperclipIssueAssigneePrincipal(left, right) {
+  if (!left || !right) {
+    return !left && !right;
+  }
+  return left.kind === right.kind && left.id === right.id;
+}
+function serializePaperclipIssueAssigneePrincipal(principal) {
+  if (!principal) {
+    return null;
+  }
+  return principal.kind === "agent" ? {
+    type: "agent",
+    agentId: principal.id,
+    userId: null
+  } : {
+    type: "user",
+    agentId: null,
+    userId: principal.id
+  };
+}
+function selectPaperclipIssueExecutionStageParticipant(stage, options = {}) {
+  const participants = stage.participants.filter((participant) => !isSamePaperclipIssueAssigneePrincipal(
+    participant,
+    options.exclude
+  ));
+  if (participants.length === 0) {
+    return null;
+  }
+  if (options.preferred) {
+    const preferredParticipant = participants.find((participant) => isSamePaperclipIssueAssigneePrincipal(
+      participant,
+      options.preferred
+    ));
+    if (preferredParticipant) {
+      return preferredParticipant;
+    }
+  }
+  return participants[0] ?? null;
+}
+function findPaperclipIssueExecutionStageMatch(executionPolicy, executionState) {
+  const stages = executionPolicy?.stages ?? [];
+  if (stages.length === 0) {
+    return null;
+  }
+  const currentStageId = executionState?.currentStageId;
+  if (currentStageId) {
+    const matchedStageIndex = stages.findIndex((stage) => stage.id === currentStageId);
+    if (matchedStageIndex >= 0) {
+      const matchedStage = stages[matchedStageIndex];
+      if (matchedStage) {
+        return {
+          stage: matchedStage,
+          index: matchedStageIndex
+        };
+      }
+    }
+  }
+  const currentStageIndex = executionState?.currentStageIndex;
+  if (typeof currentStageIndex === "number" && currentStageIndex >= 0 && currentStageIndex < stages.length) {
+    const matchedStage = stages[currentStageIndex];
+    if (matchedStage) {
+      return {
+        stage: matchedStage,
+        index: currentStageIndex
+      };
+    }
+  }
+  const completedStageIds = new Set(executionState?.completedStageIds ?? []);
+  for (const [stageIndex, stage] of stages.entries()) {
+    if (!stage.id || !completedStageIds.has(stage.id)) {
+      return {
+        stage,
+        index: stageIndex
+      };
+    }
+  }
+  const firstStage = stages[0];
+  return firstStage ? {
+    stage: firstStage,
+    index: 0
+  } : null;
+}
+function getConfiguredAdvancedAssigneePrincipal(advancedSettings, role) {
+  switch (role) {
+    case "default":
+      return advancedSettings.defaultAssigneeUserId ? { kind: "user", id: advancedSettings.defaultAssigneeUserId } : advancedSettings.defaultAssigneeAgentId ? { kind: "agent", id: advancedSettings.defaultAssigneeAgentId } : null;
+    case "executor":
+      return advancedSettings.executorAssigneeUserId ? { kind: "user", id: advancedSettings.executorAssigneeUserId } : advancedSettings.executorAssigneeAgentId ? { kind: "agent", id: advancedSettings.executorAssigneeAgentId } : null;
+    case "reviewer":
+      return advancedSettings.reviewerAssigneeUserId ? { kind: "user", id: advancedSettings.reviewerAssigneeUserId } : advancedSettings.reviewerAssigneeAgentId ? { kind: "agent", id: advancedSettings.reviewerAssigneeAgentId } : null;
+    case "approver":
+      return advancedSettings.approverAssigneeUserId ? { kind: "user", id: advancedSettings.approverAssigneeUserId } : advancedSettings.approverAssigneeAgentId ? { kind: "agent", id: advancedSettings.approverAssigneeAgentId } : null;
+  }
+}
+function resolvePaperclipIssueReviewAssignee(syncContext, advancedSettings) {
+  const currentParticipant = syncContext.executionState?.currentParticipant;
+  const currentStageType = syncContext.executionState?.currentStageType;
+  if (currentParticipant && currentStageType) {
+    return {
+      principal: currentParticipant,
+      role: currentStageType === "approval" ? "approver" : "reviewer"
+    };
+  }
+  const nextStageMatch = findPaperclipIssueExecutionStageMatch(syncContext.executionPolicy, syncContext.executionState);
+  const nextStage = nextStageMatch?.stage ?? null;
+  const nextStageParticipant = nextStage ? selectPaperclipIssueExecutionStageParticipant(nextStage, {
+    exclude: syncContext.executionState?.returnAssignee ?? syncContext.assignee
+  }) : null;
+  if (nextStage && nextStageParticipant) {
+    return {
+      principal: nextStageParticipant,
+      role: nextStage.type === "approval" ? "approver" : "reviewer"
+    };
+  }
+  const approverOverride = getConfiguredAdvancedAssigneePrincipal(advancedSettings, "approver");
+  if (nextStage?.type === "approval" && approverOverride) {
+    return {
+      principal: approverOverride,
+      role: "approver"
+    };
+  }
+  const reviewerOverride = getConfiguredAdvancedAssigneePrincipal(advancedSettings, "reviewer");
+  if (reviewerOverride) {
+    return {
+      principal: reviewerOverride,
+      role: "reviewer"
+    };
+  }
+  if (approverOverride) {
+    return {
+      principal: approverOverride,
+      role: "approver"
+    };
+  }
+  return null;
+}
+function resolvePaperclipIssueExecutorAssignee(syncContext, advancedSettings) {
+  const returnAssignee = syncContext.executionState?.returnAssignee;
+  if (returnAssignee) {
+    return {
+      principal: returnAssignee,
+      role: "executor"
+    };
+  }
+  const executorOverride = getConfiguredAdvancedAssigneePrincipal(advancedSettings, "executor");
+  if (executorOverride) {
+    return {
+      principal: executorOverride,
+      role: "executor"
+    };
+  }
+  const defaultOverride = getConfiguredAdvancedAssigneePrincipal(advancedSettings, "default");
+  if (defaultOverride) {
+    return {
+      principal: defaultOverride,
+      role: "executor"
+    };
+  }
+  return null;
+}
+function resolveSyncTransitionAssignee(params) {
+  const { nextStatus, syncContext, advancedSettings } = params;
+  if (nextStatus === "in_review") {
+    return resolvePaperclipIssueReviewAssignee(syncContext, advancedSettings);
+  }
+  if (nextStatus === "todo" || nextStatus === "in_progress") {
+    return resolvePaperclipIssueExecutorAssignee(syncContext, advancedSettings);
+  }
+  return null;
+}
+function doesPaperclipIssueAssigneeMatch(currentAssignee, nextAssignee) {
+  return isSamePaperclipIssueAssigneePrincipal(currentAssignee, nextAssignee);
+}
+function isActionablePaperclipIssueStatus(status) {
+  return status === "todo" || status === "in_progress" || status === "in_review";
+}
+function buildPaperclipPendingExecutionState(params) {
+  const { previousState, stage, stageIndex, participant, returnAssignee } = params;
+  return {
+    status: "pending",
+    currentStageId: stage.id ?? null,
+    currentStageIndex: stageIndex,
+    currentStageType: stage.type,
+    currentParticipant: serializePaperclipIssueAssigneePrincipal(participant),
+    returnAssignee: serializePaperclipIssueAssigneePrincipal(returnAssignee),
+    completedStageIds: [...previousState?.completedStageIds ?? []],
+    lastDecisionId: previousState?.lastDecisionId ?? null,
+    lastDecisionOutcome: previousState?.lastDecisionOutcome ?? null
+  };
+}
+function buildPaperclipChangesRequestedExecutionState(params) {
+  const { previousState, stage, stageIndex } = params;
+  return {
+    status: "changes_requested",
+    currentStageId: stage.id ?? previousState.currentStageId ?? null,
+    currentStageIndex: stageIndex,
+    currentStageType: stage.type,
+    currentParticipant: serializePaperclipIssueAssigneePrincipal(previousState.currentParticipant),
+    returnAssignee: serializePaperclipIssueAssigneePrincipal(previousState.returnAssignee),
+    completedStageIds: [...previousState.completedStageIds],
+    lastDecisionId: previousState.lastDecisionId ?? null,
+    lastDecisionOutcome: "changes_requested"
+  };
+}
+function buildSyncFallbackExecutionStatePatch(params) {
+  const { currentStatus, nextStatus, syncContext, nextAssignee } = params;
+  const previousState = syncContext.executionState;
+  if ((currentStatus === "done" || currentStatus === "cancelled") && nextStatus !== "done" && nextStatus !== "cancelled") {
+    return previousState ? null : void 0;
+  }
+  if (nextStatus === "in_review" && syncContext.executionPolicy) {
+    const nextStageMatch = findPaperclipIssueExecutionStageMatch(syncContext.executionPolicy, previousState);
+    if (!nextStageMatch) {
+      return previousState ? null : void 0;
+    }
+    const returnAssignee = previousState?.returnAssignee ?? syncContext.assignee;
+    const participant = selectPaperclipIssueExecutionStageParticipant(nextStageMatch.stage, {
+      preferred: previousState?.status === "changes_requested" ? nextAssignee ?? previousState.currentParticipant : nextAssignee ?? previousState?.currentParticipant,
+      exclude: returnAssignee
+    });
+    if (!participant) {
+      return previousState ? null : void 0;
+    }
+    return buildPaperclipPendingExecutionState({
+      previousState,
+      stage: nextStageMatch.stage,
+      stageIndex: nextStageMatch.index,
+      participant,
+      returnAssignee
+    });
+  }
+  if ((nextStatus === "todo" || nextStatus === "in_progress") && currentStatus === "in_review") {
+    const currentStageMatch = findPaperclipIssueExecutionStageMatch(syncContext.executionPolicy, previousState);
+    if (previousState?.status === "pending" && previousState.returnAssignee && currentStageMatch) {
+      return buildPaperclipChangesRequestedExecutionState({
+        previousState,
+        stage: currentStageMatch.stage,
+        stageIndex: currentStageMatch.index
+      });
+    }
+    return previousState ? null : void 0;
+  }
+  return void 0;
+}
 function describeGitHubStatusTransitionReason(params) {
   const { snapshot, previousCommentCount, hasTrustedNewComment, maintainerAuthoredImportedIssue } = params;
   if (snapshot.state === "closed") {
@@ -4233,7 +4667,8 @@ function resolvePaperclipIssueStatus(params) {
     hasTrustedNewComment,
     wasImportedThisRun,
     defaultImportedStatus,
-    maintainerAuthoredImportedIssue
+    maintainerAuthoredImportedIssue,
+    hasExecutorHandoffTarget
   } = params;
   if (snapshot.state === "closed") {
     return snapshot.stateReason === "duplicate" || snapshot.stateReason === "not_planned" ? "cancelled" : "done";
@@ -4243,10 +4678,12 @@ function resolvePaperclipIssueStatus(params) {
   }
   const baselineCommentCount = previousCommentCount ?? snapshot.commentCount;
   if (snapshot.commentCount > baselineCommentCount && hasTrustedNewComment) {
-    return "todo";
+    return hasExecutorHandoffTarget ? "in_progress" : "todo";
   }
   if (snapshot.linkedPullRequests.length > 0) {
-    return resolvePaperclipStatusFromLinkedPullRequests(snapshot.linkedPullRequests);
+    return resolvePaperclipStatusFromLinkedPullRequests(snapshot.linkedPullRequests, {
+      preferInProgress: hasExecutorHandoffTarget
+    });
   }
   if (wasImportedThisRun) {
     return maintainerAuthoredImportedIssue ? "todo" : defaultImportedStatus;
@@ -5398,7 +5835,7 @@ async function detectPaperclipBoardAccessRequirement(paperclipApiBaseUrl) {
     return false;
   }
 }
-async function wakePaperclipAssigneeForImportedIssue(ctx, params) {
+async function wakePaperclipIssueAssignee(ctx, params) {
   if (!params.assigneeAgentId || !params.paperclipApiBaseUrl) {
     return;
   }
@@ -5414,10 +5851,12 @@ async function wakePaperclipAssigneeForImportedIssue(ctx, params) {
         body: JSON.stringify({
           source: "assignment",
           triggerDetail: "system",
-          reason: IMPORTED_ISSUE_WAKE_REASON,
+          reason: params.reason,
           payload: {
             issueId: params.paperclipIssueId,
-            mutation: "import"
+            mutation: params.mutation,
+            ...params.previousStatus ? { previousStatus: params.previousStatus } : {},
+            ...params.nextStatus ? { nextStatus: params.nextStatus } : {}
           }
         })
       },
@@ -5429,11 +5868,12 @@ async function wakePaperclipAssigneeForImportedIssue(ctx, params) {
       throw new Error(`Wakeup request failed with status ${response.status}.`);
     }
   } catch (error) {
-    ctx.logger.warn("GitHub sync could not wake the assignee for an imported Paperclip issue.", {
+    ctx.logger.warn("GitHub sync could not wake the assignee for a Paperclip issue.", {
       issueId: params.paperclipIssueId,
       agentId: params.assigneeAgentId,
       companyId: params.companyId,
       paperclipApiBaseUrl: params.paperclipApiBaseUrl,
+      mutation: params.mutation,
       error: error instanceof Error ? error.message : String(error)
     });
   }
@@ -6132,10 +6572,32 @@ function doIssueNumberListsMatch(left, right) {
   }
   return left.every((value, index) => value === right[index]);
 }
-async function updatePaperclipIssueStatus(ctx, params) {
-  const { companyId, issueId, nextStatus, transitionComment, transitionCommentAnnotation, paperclipApiBaseUrl } = params;
+async function updatePaperclipIssueState(ctx, params) {
+  const {
+    companyId,
+    issueId,
+    currentStatus,
+    syncContext,
+    nextStatus,
+    nextAssignee,
+    transitionComment,
+    transitionCommentAnnotation,
+    paperclipApiBaseUrl
+  } = params;
   const trimmedTransitionComment = transitionComment.trim();
-  let statusUpdated = false;
+  let issueUpdated = false;
+  const issuePatch = {
+    status: nextStatus
+  };
+  if (nextAssignee) {
+    if (nextAssignee.kind === "agent") {
+      issuePatch.assigneeAgentId = nextAssignee.id;
+      issuePatch.assigneeUserId = null;
+    } else {
+      issuePatch.assigneeAgentId = null;
+      issuePatch.assigneeUserId = nextAssignee.id;
+    }
+  }
   if (paperclipApiBaseUrl) {
     try {
       const response = await fetchPaperclipApi(
@@ -6146,9 +6608,7 @@ async function updatePaperclipIssueStatus(ctx, params) {
             accept: "application/json",
             "content-type": "application/json"
           },
-          body: JSON.stringify({
-            status: nextStatus
-          })
+          body: JSON.stringify(issuePatch)
         },
         {
           companyId
@@ -6159,7 +6619,7 @@ async function updatePaperclipIssueStatus(ctx, params) {
         bodyRequired: false
       });
       if (!payloadResult.failure) {
-        statusUpdated = true;
+        issueUpdated = true;
       }
       if (payloadResult.failure && (payloadResult.failure.status ?? response.status) !== 404 && (payloadResult.failure.status ?? response.status) !== 405) {
         logPaperclipIssueStatusUpdateFailure(ctx, {
@@ -6181,8 +6641,29 @@ async function updatePaperclipIssueStatus(ctx, params) {
       });
     }
   }
-  if (!statusUpdated) {
-    await ctx.issues.update(issueId, { status: nextStatus }, companyId);
+  if (!issueUpdated) {
+    const fallbackExecutionStatePatch = buildSyncFallbackExecutionStatePatch({
+      currentStatus,
+      nextStatus,
+      syncContext,
+      nextAssignee
+    });
+    const preserveExistingUserAssigneeWithoutLocalApi = nextAssignee?.kind === "user" && !paperclipApiBaseUrl;
+    const sdkIssuePatch = {
+      ...issuePatch,
+      ...fallbackExecutionStatePatch !== void 0 ? { executionState: fallbackExecutionStatePatch } : {}
+    };
+    if (preserveExistingUserAssigneeWithoutLocalApi) {
+      delete sdkIssuePatch.assigneeAgentId;
+      delete sdkIssuePatch.assigneeUserId;
+      ctx.logger.warn("GitHub sync could not reassign a Paperclip issue to a user without the local Paperclip API. Preserving the existing assignee.", {
+        companyId,
+        issueId,
+        nextStatus,
+        assigneeUserId: nextAssignee.id
+      });
+    }
+    await ctx.issues.update(issueId, sdkIssuePatch, companyId);
   }
   if (trimmedTransitionComment && typeof ctx.issues.createComment === "function") {
     const createdComment = await ctx.issues.createComment(issueId, trimmedTransitionComment, companyId);
@@ -6242,22 +6723,76 @@ function shouldIgnoreGitHubIssue(issue, advancedSettings) {
     (ignoredUsername) => buildGitHubUsernameAliases(ignoredUsername).some((alias) => issueAuthorAliases.has(alias))
   );
 }
+async function assignImportedPaperclipIssueToUser(ctx, params) {
+  if (!params.paperclipApiBaseUrl) {
+    ctx.logger.warn("GitHub sync could not assign a newly imported Paperclip issue to a user without the local Paperclip API. Preserving the imported issue assignment.", {
+      companyId: params.companyId,
+      issueId: params.issueId,
+      assigneeUserId: params.assigneeUserId
+    });
+    return;
+  }
+  try {
+    const response = await fetchPaperclipApi(
+      getPaperclipIssueEndpoint(params.paperclipApiBaseUrl, params.issueId),
+      {
+        method: "PATCH",
+        headers: {
+          accept: "application/json",
+          "content-type": "application/json"
+        },
+        body: JSON.stringify({
+          assigneeAgentId: null,
+          assigneeUserId: params.assigneeUserId
+        })
+      },
+      {
+        companyId: params.companyId
+      }
+    );
+    const payloadResult = await readPaperclipApiJsonResponse(response, {
+      operationLabel: "issue update",
+      bodyRequired: false
+    });
+    if (!payloadResult.failure) {
+      return;
+    }
+    throw new Error(payloadResult.failure.errorMessage ?? `Issue update failed with status ${payloadResult.failure.status ?? response.status}.`);
+  } catch (error) {
+    ctx.logger.warn("GitHub sync could not assign a newly imported Paperclip issue to a Paperclip user.", {
+      companyId: params.companyId,
+      issueId: params.issueId,
+      assigneeUserId: params.assigneeUserId,
+      paperclipApiBaseUrl: params.paperclipApiBaseUrl,
+      error: getErrorMessage(error)
+    });
+  }
+}
 async function createPaperclipIssue(ctx, mapping, advancedSettings, issue, availableLabels, paperclipApiBaseUrl, syncFailureContext) {
   if (!mapping.companyId || !mapping.paperclipProjectId) {
     throw new Error(`Mapping ${mapping.id} is missing resolved Paperclip project identifiers.`);
   }
   const title = issue.title;
   const description = buildPaperclipIssueDescription(issue);
+  const defaultAssignee = getConfiguredAdvancedAssigneePrincipal(advancedSettings, "default");
   const createdIssue = await ctx.issues.create({
     companyId: mapping.companyId,
     projectId: mapping.paperclipProjectId,
     title,
     ...description ? { description } : {},
-    ...advancedSettings.defaultAssigneeAgentId ? { assigneeAgentId: advancedSettings.defaultAssigneeAgentId } : {}
+    ...defaultAssignee?.kind === "agent" ? { assigneeAgentId: defaultAssignee.id } : defaultAssignee?.kind === "user" ? { assigneeUserId: defaultAssignee.id } : {}
   });
   const ensuredCreatedIssueId = createdIssue.id;
   const normalizedCreatedIssueDescription = createdIssue.description ?? void 0;
   const createPath = "sdk";
+  if (defaultAssignee?.kind === "user") {
+    await assignImportedPaperclipIssueToUser(ctx, {
+      companyId: mapping.companyId,
+      issueId: ensuredCreatedIssueId,
+      assigneeUserId: defaultAssignee.id,
+      paperclipApiBaseUrl
+    });
+  }
   if (normalizeIssueDescriptionValue(normalizedCreatedIssueDescription) !== description) {
     logIssueDescriptionDiagnostic(
       ctx,
@@ -6395,7 +6930,7 @@ async function synchronizePaperclipIssueStatuses(ctx, octokit, repository, mappi
   let updatedDescriptionsCount = 0;
   let completedIssueCount = 0;
   const totalIssueCount = importedIssues.length;
-  const queuedImportedIssueWakeups = [];
+  const queuedIssueWakeups = [];
   for (const importedIssue of importedIssues) {
     if (assertNotCancelled) {
       await assertNotCancelled();
@@ -6518,6 +7053,11 @@ async function synchronizePaperclipIssueStatuses(ctx, octokit, repository, mappi
         githubIssue,
         maintainerCache: repositoryMaintainerCache
       }) : false;
+      const paperclipIssueSyncContext = getPaperclipIssueSyncContext(paperclipIssue);
+      const executorTransitionAssignee = resolvePaperclipIssueExecutorAssignee(
+        paperclipIssueSyncContext,
+        advancedSettings
+      );
       const nextStatus = resolvePaperclipIssueStatus({
         currentStatus: paperclipIssue.status,
         snapshot,
@@ -6525,16 +7065,26 @@ async function synchronizePaperclipIssueStatuses(ctx, octokit, repository, mappi
         hasTrustedNewComment,
         wasImportedThisRun,
         defaultImportedStatus: advancedSettings.defaultStatus,
-        maintainerAuthoredImportedIssue
+        maintainerAuthoredImportedIssue,
+        hasExecutorHandoffTarget: Boolean(executorTransitionAssignee)
       });
-      const shouldWakeImportedAssignee = wasImportedThisRun && nextStatus === "todo" && Boolean(paperclipIssue.assigneeAgentId);
+      const nextTransitionAssignee = resolveSyncTransitionAssignee({
+        nextStatus,
+        syncContext: paperclipIssueSyncContext,
+        advancedSettings
+      });
+      const nextAssigneeChanged = nextTransitionAssignee ? !doesPaperclipIssueAssigneeMatch(paperclipIssueSyncContext.assignee, nextTransitionAssignee.principal) : false;
+      const shouldWakeImportedAssignee = wasImportedThisRun && paperclipIssue.status === nextStatus && nextStatus === "todo" && paperclipIssueSyncContext.assignee?.kind === "agent";
+      const shouldWakeTransitionAssignee = paperclipIssue.status !== nextStatus && nextTransitionAssignee?.principal.kind === "agent" && isActionablePaperclipIssueStatus(nextStatus) && (nextAssigneeChanged || paperclipIssue.status !== nextStatus);
       importedIssue.githubIssueNumber = githubIssue.number;
       importedIssue.lastSeenCommentCount = snapshot.commentCount;
       if (paperclipIssue.status === nextStatus) {
         if (shouldWakeImportedAssignee) {
-          queuedImportedIssueWakeups.push({
-            assigneeAgentId: paperclipIssue.assigneeAgentId,
-            paperclipIssueId: importedIssue.paperclipIssueId
+          queuedIssueWakeups.push({
+            assigneeAgentId: paperclipIssueSyncContext.assignee?.kind === "agent" ? paperclipIssueSyncContext.assignee.id : null,
+            paperclipIssueId: importedIssue.paperclipIssueId,
+            reason: IMPORTED_ISSUE_WAKE_REASON,
+            mutation: "import"
           });
         }
         continue;
@@ -6553,19 +7103,26 @@ async function synchronizePaperclipIssueStatuses(ctx, octokit, repository, mappi
         repositoryUrl: repository.url,
         githubIssueNumber: githubIssue.number
       });
-      await updatePaperclipIssueStatus(ctx, {
+      await updatePaperclipIssueState(ctx, {
         companyId: mapping.companyId,
         issueId: importedIssue.paperclipIssueId,
+        currentStatus: paperclipIssue.status,
+        syncContext: paperclipIssueSyncContext,
         nextStatus,
+        ...nextTransitionAssignee ? { nextAssignee: nextTransitionAssignee.principal } : {},
         transitionComment: transitionComment.body,
         transitionCommentAnnotation: transitionComment.annotation,
         paperclipApiBaseUrl
       });
       updatedStatusesCount += 1;
-      if (shouldWakeImportedAssignee) {
-        queuedImportedIssueWakeups.push({
-          assigneeAgentId: paperclipIssue.assigneeAgentId,
-          paperclipIssueId: importedIssue.paperclipIssueId
+      if (shouldWakeTransitionAssignee && nextTransitionAssignee?.principal.kind === "agent") {
+        queuedIssueWakeups.push({
+          assigneeAgentId: nextTransitionAssignee.principal.id,
+          paperclipIssueId: importedIssue.paperclipIssueId,
+          reason: STATUS_TRANSITION_WAKE_REASON,
+          mutation: "status_transition",
+          previousStatus: paperclipIssue.status,
+          nextStatus
         });
       }
     } catch (error) {
@@ -6587,13 +7144,17 @@ async function synchronizePaperclipIssueStatuses(ctx, octokit, repository, mappi
     }
   }
   await mapWithConcurrency(
-    queuedImportedIssueWakeups,
+    queuedIssueWakeups,
     IMPORTED_ISSUE_WAKEUP_CONCURRENCY,
-    async (queuedWakeup) => wakePaperclipAssigneeForImportedIssue(ctx, {
+    async (queuedWakeup) => wakePaperclipIssueAssignee(ctx, {
       assigneeAgentId: queuedWakeup.assigneeAgentId,
       paperclipIssueId: queuedWakeup.paperclipIssueId,
       companyId: mapping.companyId,
-      paperclipApiBaseUrl
+      paperclipApiBaseUrl,
+      reason: queuedWakeup.reason,
+      mutation: queuedWakeup.mutation,
+      previousStatus: queuedWakeup.previousStatus,
+      nextStatus: queuedWakeup.nextStatus
     })
   );
   return {
@@ -11026,7 +11587,7 @@ var plugin = definePlugin({
         await saveSettingsSyncState(ctx, normalizedSettings, settingsForResponse.syncState, requestedCompanyId);
       }
       const scopedMappings = filterMappingsByCompany(settingsForResponse.mappings, requestedCompanyId);
-      const availableAssignees = includeAssignees && requestedCompanyId ? await listAvailableAssignees(ctx, requestedCompanyId) : [];
+      const availableAssignees = includeAssignees && requestedCompanyId ? await listAvailableAssignees(ctx, requestedCompanyId, settingsForResponse) : [];
       return {
         ...getPublicSettingsForScope(settingsForResponse, requestedCompanyId),
         ...includeAssignees ? { availableAssignees } : {},
@@ -11137,6 +11698,7 @@ var plugin = definePlugin({
         ...githubTokenLogin ? { githubTokenLogin } : {},
         paperclipBoardApiTokenRefs: previous.paperclipBoardApiTokenRefs,
         paperclipBoardAccessIdentityByCompanyId: previous.paperclipBoardAccessIdentityByCompanyId,
+        paperclipBoardAccessUserIdByCompanyId: previous.paperclipBoardAccessUserIdByCompanyId,
         ...Object.keys(nextCompanyAdvancedSettingsByCompanyId).length > 0 ? { companyAdvancedSettingsByCompanyId: nextCompanyAdvancedSettingsByCompanyId } : {},
         ...githubTokenRef ? { githubTokenRef } : {}
       });
@@ -11163,6 +11725,7 @@ var plugin = definePlugin({
         ...current.githubTokenLogin ? { githubTokenLogin: current.githubTokenLogin } : {},
         ...current.paperclipBoardApiTokenRefs ? { paperclipBoardApiTokenRefs: current.paperclipBoardApiTokenRefs } : {},
         ...current.paperclipBoardAccessIdentityByCompanyId ? { paperclipBoardAccessIdentityByCompanyId: current.paperclipBoardAccessIdentityByCompanyId } : {},
+        ...current.paperclipBoardAccessUserIdByCompanyId ? { paperclipBoardAccessUserIdByCompanyId: current.paperclipBoardAccessUserIdByCompanyId } : {},
         ...current.companyAdvancedSettingsByCompanyId ? { companyAdvancedSettingsByCompanyId: current.companyAdvancedSettingsByCompanyId } : {},
         ...githubTokenRef ? { githubTokenRef } : {},
         updatedAt: (/* @__PURE__ */ new Date()).toISOString()
@@ -11177,7 +11740,7 @@ var plugin = definePlugin({
       return {
         ...getPublicSettingsForScope(next, requestedCompanyId),
         ...scopedGitHubTokenLogin ? { githubTokenLogin: scopedGitHubTokenLogin } : {},
-        availableAssignees: requestedCompanyId ? await listAvailableAssignees(ctx, requestedCompanyId) : []
+        availableAssignees: requestedCompanyId ? await listAvailableAssignees(ctx, requestedCompanyId, next) : []
       };
     });
     ctx.actions.register("settings.updateBoardAccess", async (input) => {
@@ -11195,11 +11758,15 @@ var plugin = definePlugin({
       const nextPaperclipBoardAccessIdentityByCompanyId = {
         ...previous.paperclipBoardAccessIdentityByCompanyId ?? {}
       };
+      const nextPaperclipBoardAccessUserIdByCompanyId = {
+        ...previous.paperclipBoardAccessUserIdByCompanyId ?? {}
+      };
       if (nextSecretRef) {
         nextPaperclipBoardApiTokenRefs[companyId] = nextSecretRef;
       } else {
         delete nextPaperclipBoardApiTokenRefs[companyId];
         delete nextPaperclipBoardAccessIdentityByCompanyId[companyId];
+        delete nextPaperclipBoardAccessUserIdByCompanyId[companyId];
       }
       if ("paperclipBoardAccessIdentity" in record) {
         const nextIdentityLabel = normalizeOptionalString2(record.paperclipBoardAccessIdentity);
@@ -11209,15 +11776,25 @@ var plugin = definePlugin({
           delete nextPaperclipBoardAccessIdentityByCompanyId[companyId];
         }
       }
+      if ("paperclipBoardAccessUserId" in record) {
+        const nextUserId = normalizeOptionalString2(record.paperclipBoardAccessUserId);
+        if (nextUserId) {
+          nextPaperclipBoardAccessUserIdByCompanyId[companyId] = nextUserId;
+        } else {
+          delete nextPaperclipBoardAccessUserIdByCompanyId[companyId];
+        }
+      }
       const {
         paperclipBoardApiTokenRefs: _previousPaperclipBoardApiTokenRefs,
         paperclipBoardAccessIdentityByCompanyId: _previousPaperclipBoardAccessIdentityByCompanyId,
+        paperclipBoardAccessUserIdByCompanyId: _previousPaperclipBoardAccessUserIdByCompanyId,
         ...previousWithoutBoardAccess
       } = previous;
       const nextBase = sanitizeSettingsForCurrentSetup({
         ...previousWithoutBoardAccess,
         ...Object.keys(nextPaperclipBoardApiTokenRefs).length > 0 ? { paperclipBoardApiTokenRefs: nextPaperclipBoardApiTokenRefs } : {},
         ...Object.keys(nextPaperclipBoardAccessIdentityByCompanyId).length > 0 ? { paperclipBoardAccessIdentityByCompanyId: nextPaperclipBoardAccessIdentityByCompanyId } : {},
+        ...Object.keys(nextPaperclipBoardAccessUserIdByCompanyId).length > 0 ? { paperclipBoardAccessUserIdByCompanyId: nextPaperclipBoardAccessUserIdByCompanyId } : {},
         updatedAt: (/* @__PURE__ */ new Date()).toISOString()
       }, {
         hasToken: hasConfiguredGithubToken(previous, config, companyId),