@idea1/cli 1.9.1 → 1.10.1

package/dist/workflow/engine/ship-flow.js

@@ -1,12 +1,13 @@
 import { logger } from '../../lib/logger.js';
-import { claudeEntryPointOption } from '../../lib/claude-options.js';
+import { CLAUDE_ENTRY_POINT_OPTION_NAME } from '../../lib/claude-options.js';
 import { isolationModeOption, resolveIsolationMode } from '../../lib/isolation.js';
 import * as git from '../../services/git.js';
 import * as github from '../../services/github.js';
+import * as platform from '../../services/platform.js';
 import * as worktree from '../../services/worktree.js';
 import { WorkflowBranchState } from '../data/workflow-context.js';
 import { WorkflowStates } from '../data/workflow-states.js';
-import { mergeConfirmationOption } from './approval-flow.js';
+import { approvePrOnBranchWithNoItem, assigneeOption, mergeConfirmationOption, readyForApprovalOnBranchWithNoItem } from './approval-flow.js';
 import { branchCreationOptions } from './branch-setup.js';
 import { reviewersOption } from './handlers/ready-for-approval.js';
 import { advanceAsNeededTo, requireLiveContext, startWorkflowManagementAtCommit } from './workflow-engine.js';
@@ -155,24 +156,81 @@ export async function carryLocalChanges(transition, changes) {
         });
     }
     const { branchName } = requireLiveContext(transition);
+    transition.workingPath = await checkOutCarriedBranch(options, changes, branchName, commitSha, treeSha);
+    logger.success(`Carried the uncommitted changes onto ${branchName} (${commitSha.substring(0, 12)})`);
+    logger.hint(`Working directory: ${transition.workingPath}`);
+}
+/**
+ * Give a branch made from carried changes its local checkout per the isolation mode, and make the
+ * checkout the working directory; returns its path. In the main repository, the checkout that held
+ * the changes switches to the branch with its working tree as it is, which is the branch's tip.
+ * Otherwise the branch gets a worktree, and the checkout that held the changes is cleaned of them,
+ * unless they changed meanwhile.
+ */
+async function checkOutCarriedBranch(options, changes, branchName, commitSha, treeSha) {
+    const { sourceBranch, checkoutPath } = changes;
     if (resolveIsolationMode(options) === 'main-repo') {
         await git.switchToCommitKeepingWorkingTree(branchName, commitSha);
-        transition.workingPath = checkoutPath;
+        return checkoutPath;
+    }
+    const { workingPath } = await worktree.ensureBranchEnvironment('worktree', branchName);
+    if (await git.writeWorkingTreeTree() === treeSha) {
+        await git.discardWorkingTreeChanges();
+        logger.dim(`Removed the carried changes from ${checkoutPath}, which stays on ${sourceBranch}`);
     }
     else {
-        const { workingPath } = await worktree.ensureBranchEnvironment('worktree', branchName);
-        if (await git.writeWorkingTreeTree() === treeSha) {
-            await git.discardWorkingTreeChanges();
-            logger.dim(`Removed the carried changes from ${checkoutPath}, which stays on ${sourceBranch}`);
-        }
-        else {
-            logger.warning(`The changes in ${checkoutPath} changed while they were carried, so they were left there. Discard them once you have checked ${branchName}.`);
-        }
-        transition.workingPath = workingPath;
-        process.chdir(workingPath);
+        logger.warning(`The changes in ${checkoutPath} changed while they were carried, so they were left there. Discard them once you have checked ${branchName}.`);
+    }
+    process.chdir(workingPath);
+    return workingPath;
+}
+/**
+ * Ship the uncommitted changes of the base branch checkout with no project item: they are committed
+ * onto a new branch on origin, which gets a PR into the base branch assigned to the person running
+ * the command, and the PR merges once the required checks pass - `ready-for-approval` and
+ * `approve-pr` on a branch with no item, with nothing asked on the way. No workflow status is
+ * recorded anywhere.
+ *
+ * Reads `commit-message`, `branch-name`, `base-branch` and `isolation` from the options.
+ */
+export async function shipWithoutItem(options) {
+    const changes = await findLocalChanges(options['base-branch'] || await worktree.resolveBaseBranch());
+    if (!changes) {
+        throw new Error('There are no uncommitted changes to ship.');
+    }
+    const { sourceBranch, checkoutPath } = changes;
+    process.chdir(checkoutPath);
+    logger.section(`Carry uncommitted changes from ${sourceBranch}`);
+    const self = await platform.resolveTeammate(await github.getCurrentLogin());
+    const message = options['commit-message'] || `Changes carried from ${sourceBranch}`;
+    const shortBranchName = options['branch-name'] || carriedBranchName(options['commit-message']);
+    const branchName = `${await worktree.resolveBranchPrefix()}/${shortBranchName}`;
+    if (await git.branchExists(branchName)) {
+        throw new Error(`Branch '${branchName}' already exists. Pass --branch-name to choose a different name.`);
     }
+    const treeSha = await git.writeWorkingTreeTree();
+    const commitSha = await git.commitTree(treeSha, 'HEAD', message);
+    await git.pushCommitToBranch(branchName, commitSha, null);
+    await checkOutCarriedBranch(options, changes, branchName, commitSha, treeSha);
     logger.success(`Carried the uncommitted changes onto ${branchName} (${commitSha.substring(0, 12)})`);
-    logger.hint(`Working directory: ${transition.workingPath}`);
+    const branchOptions = {
+        ...options,
+        [assigneeOption.longName]: self.email,
+        [reviewersOption.longName]: options[reviewersOption.longName] ?? '',
+        [mergeConfirmationOption.longName]: 'true',
+        'base-branch': sourceBranch,
+        title: message
+    };
+    await readyForApprovalOnBranchWithNoItem(branchName, branchOptions);
+    await approvePrOnBranchWithNoItem(branchName, true);
+}
+/**
+ * The name, under the branch prefix, of a branch made from carried changes with no item to name it:
+ * the commit message as a slug, else the time.
+ */
+function carriedBranchName(commitMessage) {
+    const slug = (commitMessage ?? '').toLowerCase().replace(/[^a-z0-9]+/g, '-').replace(/^-+|-+$/g, '').substring(0, 40).replace(/-+$/, '');
+    return slug || `changes-${new Date().toISOString().replace(/\D/g, '').substring(0, 12)}`;
 }
 /**
  * The tip on origin of an item's live branch that changes can be carried onto: one cut from the
@@ -203,17 +261,18 @@ async function requireBranchWithNoCommitsOfItsOwn(context, sourceBranch) {
 /**
  * Advance the item through every workflow state up to Approved and Merged, asking nothing: the
  * states on the way get the options a person would otherwise be asked for. No Claude session is
- * started on the way through Agent Implementation, the PR is assigned to the person running the
- * command, who merges it once the required checks pass (which brings the base branch's local
- * checkout up to date with the merge). Each state runs its usual automation, so a run that stops -
- * on failing checks, say - continues from where it stopped when run again.
+ * started on the way through Agent Implementation, the item and its PR are assigned to the person
+ * running the command - the team member whose linked GitHub account `gh` is signed in as - who
+ * merges it once the required checks pass (which brings the base branch's local checkout up to
+ * date with the merge). Each state runs its usual automation, so a run that stops - on failing
+ * checks, say - continues from where it stopped when run again.
  */
 export async function approveAndMerge(transition) {
-    const login = await github.getCurrentLogin();
+    const self = await platform.resolveTeammate(await github.getCurrentLogin());
     Object.assign(transition.options, {
         [isolationModeOption.longName]: resolveIsolationMode(transition.options),
-        [claudeEntryPointOption.longName]: 'none',
-        assignee: login,
+        [CLAUDE_ENTRY_POINT_OPTION_NAME]: 'none',
+        [assigneeOption.longName]: self.email,
         [reviewersOption.longName]: transition.options[reviewersOption.longName] ?? '',
         [mergeConfirmationOption.longName]: 'true'
     });

package/dist/workflow/engine/ship-flow.js.map

@@ -1 +1 @@
-{"version":3,"file":"ship-flow.js","sourceRoot":"","sources":["../../../src/workflow/engine/ship-flow.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"ship-flow.js","sourceRoot":"","sources":["../../../src/workflow/engine/ship-flow.ts"],"names":[],"mappings":"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"}

package/dist/workflow/engine/workflow-engine.d.ts

@@ -24,17 +24,32 @@ import { type WorkflowState } from '../data/workflow-states.js';
  *
  * A command resolves the transition it operates on and, when it changes the item, calls the
  * operation that says so: `advanceAsNeededTo` to move the item on, `reenterState` to run the
- * automation of the state it is already in. Both put the item under workflow management on the way
+ * automation of the state it is already in, `advanceOrReenter` for either. They all put the item under workflow management on the way
  * in - an item with no live branch gets one, created on origin and recorded on the platform as the
  * item's - so a command never arranges that for itself and every handler runs on a branch.
  *
  * The workflow changes the item's context; the branch itself carries the work. A branch's PR is
  * therefore gated on a CI/CD run of exactly what merges, and approving merges that run's head.
  *
+ * Entering some states takes a teammate assignment for the item (`getAssignmentRequirement`):
+ * optional on the way into the early states, required on the way into Needs Approval for Release,
+ * where the assignee approves the pull request. The engine asks for the teammate once per
+ * transition, before any slow work, and records the assignment with the first such state it
+ * enters. An item out of scope (in no project) has no assignee.
+ *
  * One thing lives locally, and only here: the item URL of each branch is remembered in the clone's
  * git config, so "is this branch under workflow?" and "which item?" are answered instantly for
  * display. The platform is the truth.
  */
+/**
+ * An item's place in the project plan, as far as a transition needs it.
+ */
+export interface ProjectItemPlan {
+    /** The Project the item is planned in; null for an item out of scope, which has no assignee. */
+    projectId: string | null;
+    /** The team member the item is assigned to; null when it is unassigned. */
+    assignedToUserId: string | null;
+}
 /**
  * One project item moving through the workflow, as the engine and the state handlers see it.
  */
@@ -44,11 +59,18 @@ export interface WorkflowTransition {
     context: WorkflowContext | null;
     /** The item's current state; null when it is outside workflow management. */
     currentState: WorkflowState | null;
+    /** The item's place in the project plan, as read before the transition. */
+    plan: ProjectItemPlan;
     /** Local checkout of the branch (worktree or main repo), or null when none exists. */
     workingPath: string | null;
     /** Resolved command options the handlers read (model, effort, assignee, ...). */
     options: Record<string, string>;
 }
+/**
+ * What is known of a project item before a transition moves it: enough to ask for everything the
+ * transition will need.
+ */
+export type ItemBeforeTransition = Pick<WorkflowTransition, 'projectItemUrl' | 'currentState' | 'plan'>;
 /**
  * Side effects attached to entering a workflow state. `prepare` runs before the new state is
  * recorded (it must succeed for the transition to happen); `complete` runs after the state has been
@@ -104,12 +126,10 @@ export interface TargetSummary {
     target: string;
     /** What progress output calls the target: `#<id> <title>` for an item, the branch name otherwise. */
     label: string;
-    /** The item's URL; null for a branch with no project item. */
-    projectItemUrl: string | null;
+    /** The project item, with its state (null outside workflow management); null for a branch with no project item. */
+    item: ItemBeforeTransition | null;
     /** The branch carrying the work; null for an item with no live branch in this repository. */
     branchName: string | null;
-    /** The item's state; null for an item outside workflow management or a branch with no item. */
-    currentState: WorkflowState | null;
 }
 /**
  * What a target is - its item, branch and state - read without moving into any checkout or
@@ -135,27 +155,43 @@ export declare function startWorkflowManagementAtCommit(transition: WorkflowTran
 /**
  * Move the item to `targetState` one state at a time: each state on the way is entered in order -
  * its handler prepares, the state is recorded on the item, its handler completes - exactly as
- * advancing to each state with its own command would. The options of every handler on the way are
- * asked for before the first state is entered. An item that is not under workflow management yet
- * is put under it first, so advancing an item that has never been started to the first state is
- * what starts it; an item already at or past `targetState` keeps its state and only gains its
- * branch, so advancing again is a no-op and a run that stopped part way continues where it stopped.
+ * advancing to each state with its own command would. The options of every handler on the way,
+ * and the teammate assignment when a state on the way takes one, are asked for before anything
+ * else happens. An item that is not under workflow management yet is put under it first, so
+ * advancing an item that has never been started to the first state is what starts it; an item
+ * already at or past `targetState` keeps its state and only gains its branch, so advancing again
+ * is a no-op and a run that stopped part way continues where it stopped.
+ *
+ * The assignment is recorded once, with the first state entered that takes one. Creating the
+ * branch of an item outside workflow management enters the first state by itself, so that state is
+ * recorded again with the assignment right after.
  */
 export declare function advanceAsNeededTo(transition: WorkflowTransition, targetState: WorkflowState): Promise<void>;
 /**
  * Run the automation of the state the item is already in, without a transition: the state's
  * handler prepares and completes again, so its working environment is set up and its session
  * starts afresh. The item's status stays as it is; a pull request the handler found or opened for
- * the branch is recorded on the item alongside it.
+ * the branch is recorded on the item alongside it. A state that requires a teammate assignment
+ * requires it again: the assignee is asked for, as entering the state does, and recorded.
  */
 export declare function reenterState(transition: WorkflowTransition, state: WorkflowState): Promise<void>;
 /**
- * Prompt for every handler option that was not supplied on the command line and that advancing
- * from `fromState` to `targetState` needs, so a handler reached through `next` asks the same
- * questions as its dedicated command would. A batch asks this for each of its items, up front, so
- * its unattended runs are asked nothing; an option answered once is not asked again.
+ * Bring the item to `targetState` with that state's automation run: an item already in it re-enters
+ * it (`reenterState`), so the automation runs again - a pull request that needs its assignee gets
+ * one - and an item before it advances to it (`advanceAsNeededTo`). An item past it keeps its state.
+ */
+export declare function advanceOrReenter(transition: WorkflowTransition, targetState: WorkflowState): Promise<void>;
+/**
+ * Ask for everything that advancing the item to `targetState` needs and was not supplied on the
+ * command line: the options of every handler on the way, so a handler reached through `next` asks
+ * the same questions as its dedicated command would, and the teammate to assign the item to when a
+ * state on the way takes an assignment (an item already in a state that requires one is asked again,
+ * since entering that state again re-runs its automation). Every answer goes into `options`; the assignment is also
+ * returned, as the email of the teammate to record (null when there is none to record). A batch
+ * asks this for each of its items, up front, so its unattended runs are asked nothing; an option
+ * answered once is not asked again.
  */
-export declare function resolveOptionsForAdvancing(fromState: WorkflowState | null, targetState: WorkflowState, options: Record<string, string>): Promise<void>;
+export declare function resolveOptionsForAdvancing(item: ItemBeforeTransition, targetState: WorkflowState, options: Record<string, string>): Promise<string | null>;
 /**
  * The summary of the project item a branch in this repository implements, with the item's workflow
  * context. Null for a branch outside workflow management, which the base branch always is: no item

package/dist/workflow/engine/workflow-engine.d.ts.map

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

package/dist/workflow/engine/workflow-engine.js

@@ -2,12 +2,14 @@ import { logger } from '../../lib/logger.js';
 import { resolveOptions } from '../../cli/resolver.js';
 import { resolveIsolationMode } from '../../lib/isolation.js';
 import { isProjectItemUrl } from '../../lib/project-item-url.js';
+import { promptSelect } from '../../lib/prompt.js';
 import * as git from '../../services/git.js';
 import * as github from '../../services/github.js';
 import * as platform from '../../services/platform.js';
 import * as worktree from '../../services/worktree.js';
 import { WorkflowBranchState } from '../data/workflow-context.js';
-import { WorkflowStates, getWorkflowStatesBetween, isStateAtOrAfter, normalizeWorkflowState } from '../data/workflow-states.js';
+import { WorkflowStates, getAssignmentRequirement, getStateAssignmentRequirement, getWorkflowStatesBetween, isStateAtOrAfter, normalizeWorkflowState } from '../data/workflow-states.js';
+import { approverGitHubLogin, assigneeOption } from './approval-flow.js';
 import { collectBranchCreationChoices } from './branch-setup.js';
 import { HANDLERS_BY_STATE, getHandler } from './handlers/index.js';
 /**
@@ -63,7 +65,7 @@ export async function readTarget(target) {
         const branchName = await branchNameForTarget(trimmed);
         const branchItem = await getProjectItemSummaryForBranch(branchName);
         if (!branchItem) {
-            return { target: trimmed, label: branchName, projectItemUrl: null, branchName, currentState: null };
+            return { target: trimmed, label: branchName, item: null, branchName };
         }
         item = branchItem;
     }
@@ -71,11 +73,20 @@ export async function readTarget(target) {
     return {
         target: trimmed,
         label: `#${item.externalId} ${item.title}`,
-        projectItemUrl: item.url,
-        branchName: await liveBranchHere(context) ? context.branchName : null,
-        currentState: context ? normalizeWorkflowState(context.workflowStatus) : null
+        item: {
+            projectItemUrl: item.url,
+            currentState: context ? normalizeWorkflowState(context.workflowStatus) : null,
+            plan: planOf(item)
+        },
+        branchName: await liveBranchHere(context) ? context.branchName : null
     };
 }
+/**
+ * The item's place in the project plan, from its summary.
+ */
+function planOf(item) {
+    return { projectId: item.projectId, assignedToUserId: item.assignedToUserId };
+}
 /**
  * The branch a branch-name or PR URL target names: the PR's head branch, or the name itself.
  */
@@ -112,6 +123,7 @@ async function transitionForItem(item, options) {
         projectItemUrl: item.url,
         context,
         currentState: context ? normalizeWorkflowState(context.workflowStatus) : null,
+        plan: planOf(item),
         workingPath: null,
         options
     };
@@ -132,6 +144,7 @@ async function transitionForManagedBranch(item, options) {
         projectItemUrl: item.url,
         context,
         currentState: normalizeWorkflowState(context.workflowStatus),
+        plan: planOf(item),
         workingPath: await enterCheckout(context.branchName),
         options
     };
@@ -302,31 +315,45 @@ async function createRecordedBranch(transition, record, startCommit) {
     }
     transition.context = item.workflowContext;
     transition.currentState = item.workflowContext ? normalizeWorkflowState(item.workflowContext.workflowStatus) : null;
+    transition.plan = planOf(item);
     transition.workingPath = null;
 }
 /**
  * Move the item to `targetState` one state at a time: each state on the way is entered in order -
  * its handler prepares, the state is recorded on the item, its handler completes - exactly as
- * advancing to each state with its own command would. The options of every handler on the way are
- * asked for before the first state is entered. An item that is not under workflow management yet
- * is put under it first, so advancing an item that has never been started to the first state is
- * what starts it; an item already at or past `targetState` keeps its state and only gains its
- * branch, so advancing again is a no-op and a run that stopped part way continues where it stopped.
+ * advancing to each state with its own command would. The options of every handler on the way,
+ * and the teammate assignment when a state on the way takes one, are asked for before anything
+ * else happens. An item that is not under workflow management yet is put under it first, so
+ * advancing an item that has never been started to the first state is what starts it; an item
+ * already at or past `targetState` keeps its state and only gains its branch, so advancing again
+ * is a no-op and a run that stopped part way continues where it stopped.
+ *
+ * The assignment is recorded once, with the first state entered that takes one. Creating the
+ * branch of an item outside workflow management enters the first state by itself, so that state is
+ * recorded again with the assignment right after.
  */
 export async function advanceAsNeededTo(transition, targetState) {
+    const wasUnmanaged = transition.currentState === null;
+    let assignee = await resolveOptionsForAdvancing(transition, targetState, transition.options);
     await startWorkflowManagement(transition, targetState);
+    if (assignee !== null && wasUnmanaged && transition.currentState !== null && getStateAssignmentRequirement(transition.currentState) !== 'none') {
+        await persistState(transition, transition.currentState, assignee);
+        assignee = null;
+    }
     if (transition.currentState !== null && isStateAtOrAfter(transition.currentState, targetState)) {
         logger.info(`Already at "${transition.currentState}"; nothing to advance to reach "${targetState}".`);
         return;
     }
-    const steps = getWorkflowStatesBetween(transition.currentState, targetState);
-    await resolveOptionsForAdvancing(transition.currentState, targetState, transition.options);
-    for (const state of steps) {
+    for (const state of getWorkflowStatesBetween(transition.currentState, targetState)) {
         logger.status(`Workflow: ${transition.currentState ?? '(not started)'} → ${state}`);
         const handler = HANDLERS_BY_STATE.get(state);
+        const assigneeForState = assignee !== null && getStateAssignmentRequirement(state) !== 'none' ? assignee : null;
         await handler?.prepare?.(transition);
-        await persistState(transition, state);
+        await persistState(transition, state, assigneeForState);
         await handler?.complete?.(transition);
+        if (assigneeForState !== null) {
+            assignee = null;
+        }
         await refreshWorkingPath(transition);
     }
 }
@@ -348,31 +375,113 @@ async function refreshWorkingPath(transition) {
  * Run the automation of the state the item is already in, without a transition: the state's
  * handler prepares and completes again, so its working environment is set up and its session
  * starts afresh. The item's status stays as it is; a pull request the handler found or opened for
- * the branch is recorded on the item alongside it.
+ * the branch is recorded on the item alongside it. A state that requires a teammate assignment
+ * requires it again: the assignee is asked for, as entering the state does, and recorded.
  */
 export async function reenterState(transition, state) {
     await startWorkflowManagement(transition, state);
     const handler = getHandler(state);
+    const assignee = await resolveAssignee(transition, state, reentryAssignmentRequirement(state), transition.options);
     await resolveHandlerOptions(transition.options, [handler]);
     const recordedPullRequestUrl = requireContext(transition).pullRequestUrl;
     await handler.prepare?.(transition);
-    if (requireContext(transition).pullRequestUrl !== recordedPullRequestUrl) {
-        await persistState(transition, requireCurrentState(transition));
+    if (assignee !== null || requireContext(transition).pullRequestUrl !== recordedPullRequestUrl) {
+        await persistState(transition, requireCurrentState(transition), assignee?.email ?? null);
     }
     await handler.complete?.(transition);
 }
+/** Entering a state again takes the assignment its first entry does only when the state requires one. */
+function reentryAssignmentRequirement(state) {
+    return getStateAssignmentRequirement(state) === 'required' ? 'required' : 'none';
+}
 /**
- * Prompt for every handler option that was not supplied on the command line and that advancing
- * from `fromState` to `targetState` needs, so a handler reached through `next` asks the same
- * questions as its dedicated command would. A batch asks this for each of its items, up front, so
- * its unattended runs are asked nothing; an option answered once is not asked again.
+ * Bring the item to `targetState` with that state's automation run: an item already in it re-enters
+ * it (`reenterState`), so the automation runs again - a pull request that needs its assignee gets
+ * one - and an item before it advances to it (`advanceAsNeededTo`). An item past it keeps its state.
  */
-export async function resolveOptionsForAdvancing(fromState, targetState, options) {
-    if (fromState !== null && isStateAtOrAfter(fromState, targetState)) {
+export async function advanceOrReenter(transition, targetState) {
+    if (transition.currentState === targetState) {
+        await reenterState(transition, targetState);
         return;
     }
-    const entered = new Set(getWorkflowStatesBetween(fromState, targetState));
-    await resolveHandlerOptions(options, [...HANDLERS_BY_STATE.values()].filter(handler => entered.has(handler.state)));
+    await advanceAsNeededTo(transition, targetState);
+}
+/**
+ * Ask for everything that advancing the item to `targetState` needs and was not supplied on the
+ * command line: the options of every handler on the way, so a handler reached through `next` asks
+ * the same questions as its dedicated command would, and the teammate to assign the item to when a
+ * state on the way takes an assignment (an item already in a state that requires one is asked again,
+ * since entering that state again re-runs its automation). Every answer goes into `options`; the assignment is also
+ * returned, as the email of the teammate to record (null when there is none to record). A batch
+ * asks this for each of its items, up front, so its unattended runs are asked nothing; an option
+ * answered once is not asked again.
+ */
+export async function resolveOptionsForAdvancing(item, targetState, options) {
+    const fromState = item.currentState;
+    const reenters = fromState === targetState && reentryAssignmentRequirement(targetState) === 'required';
+    if (fromState !== null && isStateAtOrAfter(fromState, targetState) && !reenters) {
+        return null;
+    }
+    const entered = reenters ? [targetState] : getWorkflowStatesBetween(fromState, targetState);
+    const requirement = reenters ? 'required' : getAssignmentRequirement(fromState, targetState);
+    const assignee = await resolveAssignee(item, targetState, requirement, options);
+    if (assignee !== null && entered.includes(WorkflowStates.NeedsApprovalForRelease)) {
+        approverGitHubLogin(assignee);
+    }
+    await resolveHandlerOptions(options, [...HANDLERS_BY_STATE.values()].filter(handler => entered.includes(handler.state)));
+    return assignee?.email ?? null;
+}
+/**
+ * The teammate the item is assigned to on its way to `targetState`. Resolved from the `assignee`
+ * option when it was supplied (a teammate's email or GitHub login, or empty for none) and asked for
+ * otherwise - with "none", which keeps the current assignee, where the assignment is optional, and
+ * from the team's members alone, defaulting to the current assignee, where it is required. The
+ * option is left holding the teammate's email, or empty for none. An item out of scope has no
+ * assignee: an optional assignment is skipped, a required one refused. Returns the teammate to
+ * record, or null when there is nothing to record.
+ */
+async function resolveAssignee(item, targetState, requirement, options) {
+    if (requirement === 'none') {
+        return null;
+    }
+    if (item.plan.projectId === null) {
+        if (requirement === 'required') {
+            throw new Error(`Assign ${item.projectItemUrl} to a project first: an item out of scope has no assignee, and "${targetState}" needs one.`);
+        }
+        logger.dim(`${item.projectItemUrl} is out of scope (in no project), so it has no assignee to set.`);
+        options[assigneeOption.longName] = '';
+        return null;
+    }
+    const members = await platform.listTeamMembers();
+    const current = members.find(member => member.userId === item.plan.assignedToUserId) ?? null;
+    const supplied = options[assigneeOption.longName];
+    const required = requirement === 'required';
+    const identity = supplied === undefined ? await promptForAssignee(members, current, required) : supplied.trim();
+    const assignee = identity.length > 0
+        ? await platform.resolveTeammate(identity)
+        : keepCurrentAssignee(current, required, targetState);
+    options[assigneeOption.longName] = assignee?.email ?? '';
+    return assignee;
+}
+/**
+ * No teammate named: none to record where the assignment is optional; where it is required, the
+ * current assignee, which then has to exist.
+ */
+function keepCurrentAssignee(current, required, targetState) {
+    if (!required) {
+        return null;
+    }
+    if (!current) {
+        throw new Error(`"${targetState}" needs a teammate assignment: pass --assignee <email or GitHub login>, the assignee approves the pull request.`);
+    }
+    return current;
+}
+async function promptForAssignee(members, current, required) {
+    const memberChoices = members.map(member => ({ label: member.email, value: member.email }));
+    if (required) {
+        return promptSelect('Assign to a teammate', memberChoices, { default: current?.email });
+    }
+    return promptSelect('Assign to a teammate', [{ label: `None (keep ${current?.email ?? 'unassigned'})`, value: '' }, ...memberChoices], { default: '' });
 }
 async function resolveHandlerOptions(options, handlers) {
     for (const handler of handlers) {
@@ -397,14 +506,20 @@ async function resolveHandlerOptions(options, handlers) {
 }
 /**
  * Record the new state where it lives: the item's workflow context on idea1.ai, together with the
- * pull request of the item's branch once a handler has found or opened it. The item's status is the
- * state of the work for every clone and for the web app alike, and its pull request link stays
- * recorded once the pull request merges or closes.
- */
-async function persistState(transition, targetState) {
+ * pull request of the item's branch once a handler has found or opened it, and the teammate the
+ * item is assigned to when the state takes an assignment (null leaves the assignment as it is).
+ * The item's status is the state of the work for every clone and for the web app alike, and its
+ * pull request link stays recorded once the pull request merges or closes. A state that could not
+ * be recorded is still the state the run reached; an assignment that could not be recorded stops
+ * the run, since the assignee is who the work goes to next.
+ */
+async function persistState(transition, targetState, assignedToEmail) {
     const context = requireContext(transition);
     const pullRequestUrl = context.pullRequestUrl.length > 0 ? context.pullRequestUrl : null;
-    await platform.setWorkflowStatus(transition.projectItemUrl, targetState, pullRequestUrl);
+    const recorded = await platform.setWorkflowStatus(transition.projectItemUrl, targetState, pullRequestUrl, assignedToEmail);
+    if (!recorded && assignedToEmail !== null) {
+        throw new Error(`Could not record "${targetState}" with the assignment to ${assignedToEmail} on ${transition.projectItemUrl}.`);
+    }
     context.workflowStatus = targetState;
     transition.currentState = targetState;
 }