coleam00/Archon · error · WorkflowAdoptionError

Cannot adopt run ' ': workflow ' ' disables worktrees, so…

Error message

Cannot adopt run '${options.adoptRunId}': workflow '${workflow.name}' disables worktrees, so there is no worktree or branch estate to inherit. Drop the adoption or run a worktree-isolated workflow.

What it means

WorkflowAdoptionError thrown by dispatchOrchestratorWorkflowOwned when a run adoption (adoptRunId) is requested while the target workflow explicitly disables worktrees (workflow.worktree.enabled === false) and the adoption lane is not in-place. Adoption inherits the previous run's worktree/branch estate; with worktrees disabled there is nothing to inherit, so the engine refuses rather than silently dropping the adoption.

Solutions

1. Drop the adoptRunId option and dispatch without adoption.
2. Enable worktrees on the workflow (worktree.enabled: true) so there is an estate to inherit.
3. If in-place continuation is acceptable, configure the adoption lane as in-place.

Example fix

// before
await dispatchOrchestratorWorkflow({ adoptRunId: runId }); // workflow has worktree.enabled: false
// after
await dispatchOrchestratorWorkflow({ adoptRunId: runId }); // with worktree.enabled: true
// or
await dispatchOrchestratorWorkflow({}); // no adoption

if (adoptRunId && workflow.worktree?.enabled === false) {
  throw new Error('Adoption requires a worktree-enabled workflow');
}

try {
  await dispatchOrchestratorWorkflow({ adoptRunId });
} catch (e) {
  if (e instanceof WorkflowAdoptionError && e.message.includes('disables worktrees')) {
    await dispatchOrchestratorWorkflow({}); // dispatch without adoption
  } else throw e;
}

When it happens

Trigger: Dispatching the orchestrator workflow with options.adoptRunId set while the workflow definition sets worktree.enabled: false and the computed adoption lane is not 'in-place'.

Common situations: Reusing an adoption-capable command or platform message against a workflow that was switched to run in-place only; a user asks to 'continue that run in a fresh checkout' but the workflow is configured without worktrees.

Related errors

• Cannot adopt run ' ': this conversation already continues…
• Cannot adopt worktree at
• Cannot adopt : .git pointer is not a git-worktree reference.
• Cannot determine git remote for
• Node ' ': unknown provider ' '. Registered

AI-assisted analysis of coleam00/Archon@0773b97458 (2026-09-01). Data as JSON: /api/errors/0dfc8fb11a08bd41. Report an issue: GitHub.

Appendix: source

Thrown at packages/core/src/orchestrator/orchestrator-agent.ts:799

        await resolveWorkflowAdoption({
          adoptedRunId: options.adoptRunId,
          codebaseId: codebase.id,
          codebasePath: codebase.default_cwd,
          codebaseKind: codebase.kind,
        })
      ).lane
    : undefined;

  // A lane other than in-place inherits a worktree or branch estate; a workflow
  // that opted out of worktrees runs in the parent checkout and has nothing to
  // inherit, so honoring the adoption would mean silently dropping the lane.
  if (
    options?.adoptRunId !== undefined &&
    adoptionLane !== undefined &&
    adoptionLane.kind !== 'in-place' &&
    workflow.worktree?.enabled === false
  ) {
    throw new WorkflowAdoptionError(
      `Cannot adopt run '${options.adoptRunId}': workflow '${workflow.name}' disables ` +
        'worktrees, so there is no worktree or branch estate to inherit. ' +
        'Drop the adoption or run a worktree-isolated workflow.'
    );
  }

  // Per-child isolation resolver (#2121 slice 2, PR-A): a `workflow:` node with
  // `isolation: 'worktree'` gets its own worktree per child. Built for git-repo
  // codebases only — a folder project can't make worktrees, so the engine fails
  // such a node fast (no resolver injected). Shared across every dispatch below.
  const resolveChildIsolation =
    codebase.kind !== 'folder'
      ? createChildWorktreeResolver({
          codebaseId: codebase.id,
          codebaseName: codebase.name,
          canonicalRepoPath: codebase.default_cwd,
          baseBranch: codebaseBaseBranch,
          createdByPlatform: platform.getPlatformType(),

View on GitHub (pinned to 0773b97458)