{"record":{"id":"e66c9565b9e69de8","repo":"paperclipai/paperclip","slug":"missing-persisted-execution-workspace","errorCode":"missing_persisted_execution_workspace","errorMessage":"Issue ${issue.identifier ?? issue.id} requires a project execution workspace, but none was persisted before adapter launch.","messagePattern":"Issue (.+?) requires a project execution workspace, but none was persisted before adapter launch\\.","errorType":"validation","errorClass":"WorkspaceValidationFailure","httpStatus":null,"severity":"error","filePath":"server/src/services/heartbeat.ts","lineNumber":2302,"sourceCode":"      scrubGitCredentialText(\n        `Failed to prepare managed checkout for \"${input.repoUrl}\" at \"${cwd}\": ${reason}${authNote ? ` ${authNote}` : \"\"}`,\n      ),\n    );\n  }\n\n  try {\n    await fs.rename(cloneTmpDir, cwd);\n  } catch (renameError) {\n    await fs\n      .rm(cloneTmpDir, { recursive: true, force: true })\n      .catch(() => undefined);\n    // The target appearing between the emptiness check and the rename means another\n    // materialization won the race; adopt its checkout instead of failing the run.\n    if (await hasAdoptableGitDir()) {\n      return { cwd, warning: null };\n    }\n    const reason =\n      renameError instanceof Error ? renameError.message : String(renameError);\n    throw new Error(\n      `Failed to move managed checkout into place at \"${cwd}\": ${reason}`,\n    );\n  }\n  return { cwd, warning: null };\n}\n\n/**\n * Resolve one project workspace row to a usable cwd. The anchor path and each additional\n * referenced project share this step: use the configured cwd when present, otherwise clone or\n * create the managed checkout directory for the project. It throws only when the managed\n * checkout cannot be prepared (for example, a clone failure).\n */\nasync function resolveConfiguredOrManagedProjectCwd(input: {\n  companyId: string;\n  projectId: string;\n  cwd: string | null;\n  repoUrl: string | null;","sourceCodeStart":2284,"sourceCodeEnd":2320,"githubUrl":"https://github.com/paperclipai/paperclip/blob/01ad8584922b5d85292b1723cae71fa0d9b07a19/server/src/services/heartbeat.ts#L2284-L2320","documentation":"Launch-safety guard in the heartbeat pre-launch workspace checks: the issue requires a project execution workspace, but no workspace cwd was persisted before the adapter launch (the persisted workspace record is missing its path). Refusing to launch avoids running the agent against an undefined working directory.","triggerScenarios":"Thrown at server/src/services/heartbeat.ts:2134 when the library encounters an invalid state.","commonSituations":"See trigger scenarios.","solutions":["Ensure an execution workspace is persisted for the issue before adapter launch; retry the run so workspace resolution completes."],"exampleFix":null,"handlingStrategy":"validation","validationCode":null,"typeGuard":null,"tryCatchPattern":null,"preventionTips":[],"tags":[],"backgroundTag":null,"analyzedSha":"01ad8584922b5d85292b1723cae71fa0d9b07a19","analyzedAt":"2026-08-18T22:49:45.177Z","contentChangedAt":"2026-08-18T22:49:45.177Z","schemaVersion":2},"datasetVersion":"2026-09-14T05:17:10.506Z"}