Function validateTaskUpdate

packages/core/src/task-ledger.ts:431–470

(
  previousTask: Task,
  input: unknown,
  options: ValidateTaskUpdateOptions = {},
)

export interface ValidateTaskUpdateOptions extends TaskStatusTransitionOptions {}

export function validateTaskUpdate(
  previousTask: Task,
  input: unknown,
  options: ValidateTaskUpdateOptions = {},
): TaskLedgerNormalizeResult<{
  subject?: string;
  status?: TaskStatus;
  blockedReason?: string;
  failureReason?: string;
  completionEvidence?: string;
  explicitReopen?: boolean;
}> {
  const normalized = normalizeUpdateTaskInput(input);
  if (!normalized.ok) return normalized;
  const { explicitReopen: patchExplicitReopen, ...taskPatch } = normalized.value;
  const nextTask: Task = {
    ...previousTask,
    ...taskPatch,
  };
  const explicitReopen = options.explicitReopen === true || patchExplicitReopen === true;
  if (
    normalized.value.status !== undefined &&
    !canTransitionTaskStatus(previousTask.status, normalized.value.status, {
      ...options,
      explicitReopen,
    })
  ) {
    const recovery =
      previousTask.status === 'pending' && normalized.value.status === 'completed'
        ? '. Call task_update with status "in_progress" first, then call task_update with status "completed" and completionEvidence.'
        : '';
    return invalid(
      'invalid_transition',
      `Invalid task status transition from ${previousTask.status} to ${normalized.value.status}${recovery}`,
    );
  }
  const evidence = validateTaskEvidence(nextTask);
  if (!evidence.ok) return evidence;
  return normalized;
}

export interface TaskResumeTrustRefs {
  corruptLedger?: boolean;