paperclipai/paperclip · error · WorkspaceGitScanError

workspace_git_scan_failed

workspace_git_scan_failed

Error message

Workspace Git scan path is unavailable

What it means

Workspace Git scan pre-check: fs.realpath on input.workspacePath failed, so the workspace directory does not exist, is not readable, or is not a directory. The scan aborts before queueing because there is no valid workspace path to operate on; ensure the workspace is mounted/created first.

Source

Thrown at server/src/services/workspace-git-operation-scheduler.ts:472

  snapshot(): WorkspaceGitSchedulerSnapshot {
    this.pruneExpiredCache();
    return {
      activeCount: this.activeCount,
      queuedCount: this.queue.length,
      inFlightCount: this.inFlight.size,
      cacheEntryCount: this.cache.size,
      cacheBytes: this.cacheBytes,
      totals: { ...this.totals },
    };
  }

  async run(input: WorkspaceGitScanInput): Promise<WorkspaceGitScanResult> {
    if (input.signal?.aborted) throw abortError("unresolved");
    let canonicalWorkspacePath: string;
    try {
      canonicalWorkspacePath = await fs.realpath(input.workspacePath);
    } catch (error) {
      throw new WorkspaceGitScanError(
        WORKSPACE_GIT_SCAN_ERROR_CODES.failed,
        "Workspace Git scan path is unavailable",
        { cause: error instanceof Error ? error.message : String(error) },
      );
    }
    if (input.signal?.aborted) throw abortError(workspaceIdentity(canonicalWorkspacePath));

    const workspaceHash = workspaceIdentity(canonicalWorkspacePath);
    const timeoutMs = clampInteger(input.timeoutMs, this.timeoutMs, 1, 120_000);
    const maxStdoutBytes = clampInteger(input.maxStdoutBytes, this.maxStdoutBytes, 1, 128 * 1024 * 1024);
    const maxStderrBytes = clampInteger(input.maxStderrBytes, this.maxStderrBytes, 1, 128 * 1024 * 1024);
    const key = scanKey({
      canonicalWorkspacePath,
      args: input.args,
      env: input.env,
      timeoutMs,
      maxStdoutBytes,
      maxStderrBytes,

View on GitHub (pinned to 120ae5428f)

Solutions

1. The Git scan path could not be accessed. Verify the workspace path exists and the server has read permissions.

When it happens

Trigger: Thrown at server/src/services/workspace-git-operation-scheduler.ts:472 when the library encounters an invalid state.

Common situations: See trigger scenarios.

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