Referenced project ${projectId} has no workspace checkout or

Error message

Referenced project ${projectId} has no workspace checkout or repository URL to realize.

What it means

Workspace-source validation in heartbeat run preparation: the issue resolves to a project (projectId), but none of the project's workspace rows provide a local checkout with content nor a repository URL to clone from. The driver refuses to fabricate an empty managed directory and report success, so launch preparation fails.

Source

Thrown at server/src/services/heartbeat.ts:1980

    };
  }

  if (input.workspaceConfigMetadata) {
    base[WORKSPACE_CONFIG_FINGERPRINT_METADATA_KEY] = {
      version: input.workspaceConfigMetadata.version,
      workspaceHash: input.workspaceConfigMetadata.fingerprint,
      categories: input.workspaceConfigMetadata.categories,
      categoryFingerprints: input.workspaceConfigMetadata.categoryFingerprints,
      lastEvaluatedAt: input.workspaceConfigMetadata.evaluatedAt,
    };
  }

  if (
    (input.shouldReuseExisting && !input.shouldRefreshConfigSnapshot) ||
    !input.configSnapshot
  ) {
    return base;
  }

  return mergeExecutionWorkspaceConfig(base, input.configSnapshot);
}

export function resolveExecutionWorkspaceBranchOwnership(
  executionWorkspace: Pick<
    RealizedExecutionWorkspace,
    "created" | "branchCreatedByRuntime"
  >,
) {
  return executionWorkspace.branchCreatedByRuntime;
}

export function stripWorkspaceRuntimeFromExecutionRunConfig(
  config: Record<string, unknown>,
) {
  const nextConfig = { ...config };
  delete nextConfig.workspaceRuntime;

View on GitHub (pinned to 01ad858492)

Solutions

Configure a workspace checkout or repository URL for the referenced project, then retry.

Defensive patterns

Strategy: validation

When it happens

Trigger: Thrown at server/src/services/heartbeat.ts:1812 when the library encounters an invalid state.

Common situations: See trigger scenarios.

AI-assisted analysis of paperclipai/paperclip@01ad858492 (2026-08-18). Data as JSON: /api/errors/ebdf6413b9b1f9eb. Report an issue: GitHub.