{"record":{"id":"e8ff96e73367aa31","repo":"paperclipai/paperclip","slug":"dev-server-supervisor-unavailable","errorCode":null,"errorMessage":"dev_server_supervisor_unavailable","messagePattern":"dev_server_supervisor_unavailable","errorType":"http","errorClass":null,"httpStatus":404,"severity":"error","filePath":"server/src/routes/health.ts","lineNumber":147,"sourceCode":"  } = {\n    deploymentMode: \"local_trusted\",\n    deploymentExposure: \"private\",\n    authReady: true,\n    companyDeletionEnabled: true,\n  },\n) {\n  const router = Router();\n\n  router.post(\"/dev-server/restart\", async (req, res) => {\n    const actorType = \"actor\" in req ? req.actor?.type : null;\n    if (opts.deploymentMode === \"authenticated\" && actorType !== \"board\") {\n      res.status(403).json({ error: \"board_access_required\" });\n      return;\n    }\n\n    const persistedDevServerStatus = readPersistedDevServerStatus();\n    if (!persistedDevServerStatus) {\n      res.status(404).json({ error: \"dev_server_supervisor_unavailable\" });\n      return;\n    }\n\n    const restartRequired =\n      persistedDevServerStatus.dirty ||\n      persistedDevServerStatus.changedPathCount > 0 ||\n      persistedDevServerStatus.pendingMigrations.length > 0;\n    if (!restartRequired) {\n      res.status(409).json({ error: \"restart_not_required\" });\n      return;\n    }\n\n    if (!db) {\n      res.status(503).json({ error: \"database_unavailable\" });\n      return;\n    }\n\n    const requestId = randomUUID();","sourceCodeStart":129,"sourceCodeEnd":165,"githubUrl":"https://github.com/paperclipai/paperclip/blob/01ad8584922b5d85292b1723cae71fa0d9b07a19/server/src/routes/health.ts#L129-L165","documentation":"404 sentinel on POST /dev-server/restart: no persisted dev-server supervisor status record was found, meaning the supervisor is not tracking this deployment and cannot accept restart requests.","triggerScenarios":"Thrown at server/src/routes/health.ts:104 when the library encounters an invalid state.","commonSituations":"See trigger scenarios.","solutions":["Check the health/connectivity of the backing service (database, dev server supervisor, storage), fix the underlying fault, and retry."],"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"}