{"record":{"id":"a3f7be59a8ca7674","repo":"paperclipai/paperclip","slug":"workspace-git-scan-failed","errorCode":"workspace_git_scan_failed","errorMessage":"Workspace Git scan path is unavailable","messagePattern":"Workspace Git scan path is unavailable","errorType":"http","errorClass":"WorkspaceGitScanError","httpStatus":503,"severity":"error","filePath":"server/src/services/workspace-git-operation-scheduler.ts","lineNumber":472,"sourceCode":"  snapshot(): WorkspaceGitSchedulerSnapshot {\n    this.pruneExpiredCache();\n    return {\n      activeCount: this.activeCount,\n      queuedCount: this.queue.length,\n      inFlightCount: this.inFlight.size,\n      cacheEntryCount: this.cache.size,\n      cacheBytes: this.cacheBytes,\n      totals: { ...this.totals },\n    };\n  }\n\n  async run(input: WorkspaceGitScanInput): Promise<WorkspaceGitScanResult> {\n    if (input.signal?.aborted) throw abortError(\"unresolved\");\n    let canonicalWorkspacePath: string;\n    try {\n      canonicalWorkspacePath = await fs.realpath(input.workspacePath);\n    } catch (error) {\n      throw new WorkspaceGitScanError(\n        WORKSPACE_GIT_SCAN_ERROR_CODES.failed,\n        \"Workspace Git scan path is unavailable\",\n        { cause: error instanceof Error ? error.message : String(error) },\n      );\n    }\n    if (input.signal?.aborted) throw abortError(workspaceIdentity(canonicalWorkspacePath));\n\n    const workspaceHash = workspaceIdentity(canonicalWorkspacePath);\n    const timeoutMs = clampInteger(input.timeoutMs, this.timeoutMs, 1, 120_000);\n    const maxStdoutBytes = clampInteger(input.maxStdoutBytes, this.maxStdoutBytes, 1, 128 * 1024 * 1024);\n    const maxStderrBytes = clampInteger(input.maxStderrBytes, this.maxStderrBytes, 1, 128 * 1024 * 1024);\n    const key = scanKey({\n      canonicalWorkspacePath,\n      args: input.args,\n      env: input.env,\n      timeoutMs,\n      maxStdoutBytes,\n      maxStderrBytes,","sourceCodeStart":454,"sourceCodeEnd":490,"githubUrl":"https://github.com/paperclipai/paperclip/blob/120ae5428fa29bee300bcf806491cd4d965fbb7c/server/src/services/workspace-git-operation-scheduler.ts#L454-L490","documentation":"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.","triggerScenarios":"Thrown at server/src/services/workspace-git-operation-scheduler.ts:472 when the library encounters an invalid state.","commonSituations":"See trigger scenarios.","solutions":["The Git scan path could not be accessed. Verify the workspace path exists and the server has read permissions."],"exampleFix":null,"handlingStrategy":"validation","validationCode":null,"typeGuard":null,"tryCatchPattern":null,"preventionTips":[],"tags":[],"backgroundTag":null,"analyzedSha":"120ae5428fa29bee300bcf806491cd4d965fbb7c","analyzedAt":"2026-08-18T22:49:45.177Z","contentChangedAt":"2026-08-18T22:49:45.177Z","schemaVersion":2},"datasetVersion":"2026-09-14T00:17:10.932Z"}