{"record":{"id":"17a8490e833e542a","repo":"paperclipai/paperclip","slug":"worktree-name-is-required","errorCode":null,"errorMessage":"Worktree name is required.","messagePattern":"Worktree name is required\\.","errorType":"validation","errorClass":null,"httpStatus":null,"severity":"error","filePath":"cli/src/commands/worktree.ts","lineNumber":300,"sourceCode":"): string {\n  return [\n    `disabled timer heartbeats: ${summary.disabledTimerHeartbeats}`,\n    `reset running agents: ${summary.resetRunningAgents}`,\n    `quarantined in-progress issues: ${summary.quarantinedInProgressIssues}`,\n    `unassigned todo issues: ${summary.unassignedTodoIssues}`,\n    `unassigned review issues: ${summary.unassignedReviewIssues}`,\n    `stopped project workspace runtimes: ${summary.stoppedProjectWorkspaceRuntimes}`,\n    `stopped execution workspace runtimes: ${summary.stoppedExecutionWorkspaceRuntimes}`,\n    `stopped runtime services: ${summary.stoppedRuntimeServices}`,\n  ].join(\", \");\n}\n\nconst WORKTREE_NAME_PREFIX = \"paperclip-\";\n\nfunction resolveWorktreeMakeName(name: string): string {\n  const value = nonEmpty(name);\n  if (!value) {\n    throw new Error(\"Worktree name is required.\");\n  }\n  if (!/^[A-Za-z0-9._-]+$/.test(value)) {\n    throw new Error(\n      \"Worktree name must contain only letters, numbers, dots, underscores, or dashes.\",\n    );\n  }\n  return value.startsWith(WORKTREE_NAME_PREFIX) ? value : `${WORKTREE_NAME_PREFIX}${value}`;\n}\n\nfunction resolveWorktreeHome(explicit?: string): string {\n  return explicit ?? process.env.PAPERCLIP_WORKTREES_DIR ?? DEFAULT_WORKTREE_HOME;\n}\n\nfunction resolveWorktreeStartPoint(explicit?: string): string | undefined {\n  return explicit ?? nonEmpty(process.env.PAPERCLIP_WORKTREE_START_POINT) ?? undefined;\n}\n\ntype ConfiguredStorage = {","sourceCodeStart":282,"sourceCodeEnd":318,"githubUrl":"https://github.com/paperclipai/paperclip/blob/01ad8584922b5d85292b1723cae71fa0d9b07a19/cli/src/commands/worktree.ts#L282-L318","documentation":"Required-argument guard in the worktree:make name resolver: the positional name argument (and any fallback) resolved to an empty string, so there is no directory/branch name to build the worktree from.","triggerScenarios":"Thrown at cli/src/commands/worktree.ts:267 when the library encounters an invalid state.","commonSituations":"See trigger scenarios.","solutions":["Provide a worktree name argument."],"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-23T08:17:48.524Z"}