{"record":{"id":"6a0dd0dd9cd9322c","repo":"paperclipai/paperclip","slug":"invalid-port-value-rawport","errorCode":null,"errorMessage":"Invalid --port value: ${rawPort}","messagePattern":"Invalid --port value: (.+?)","errorType":"exception","errorClass":null,"httpStatus":null,"severity":"error","filePath":"packages/plugins/sdk/src/dev-cli.ts","lineNumber":24,"sourceCode":"  const index = process.argv.indexOf(flag);\n  if (index < 0) return undefined;\n  return process.argv[index + 1];\n}\n\n/**\n * CLI entrypoint for the local plugin UI preview server.\n *\n * This is intentionally minimal and delegates all serving behavior to\n * `startPluginDevServer` so tests and programmatic usage share one path.\n */\nasync function main() {\n  const rootDir = parseArg(\"--root\") ?? process.cwd();\n  const uiDir = parseArg(\"--ui-dir\") ?? \"dist/ui\";\n  const host = parseArg(\"--host\") ?? \"127.0.0.1\";\n  const rawPort = parseArg(\"--port\") ?? \"4177\";\n  const port = Number.parseInt(rawPort, 10);\n  if (!Number.isFinite(port) || port <= 0 || port > 65535) {\n    throw new Error(`Invalid --port value: ${rawPort}`);\n  }\n\n  const server = await startPluginDevServer({\n    rootDir: path.resolve(rootDir),\n    uiDir,\n    host,\n    port,\n  });\n\n  // eslint-disable-next-line no-console\n  console.log(`Paperclip plugin dev server listening at ${server.url}`);\n\n  const shutdown = async () => {\n    await server.close();\n    process.exit(0);\n  };\n\n  process.on(\"SIGINT\", () => {","sourceCodeStart":6,"sourceCodeEnd":42,"githubUrl":"https://github.com/paperclipai/paperclip/blob/120ae5428fa29bee300bcf806491cd4d965fbb7c/packages/plugins/sdk/src/dev-cli.ts#L6-L42","documentation":"Error \"Invalid --port value: ${rawPort}\" thrown in paperclipai/paperclip.","triggerScenarios":"Thrown at packages/plugins/sdk/src/dev-cli.ts:24 when the library encounters an invalid state.","commonSituations":"See trigger scenarios.","solutions":["Pass a valid integer TCP port (1-65535) to --port."],"exampleFix":null,"handlingStrategy":null,"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-14T05:17:10.506Z"}