{"record":{"id":"3d971c443b51e19e","repo":"ruvnet/ruflo","slug":"unknown-headless-worker-type-workertype","errorCode":null,"errorMessage":"Unknown headless worker type: ${workerType}","messagePattern":"Unknown headless worker type: (.+?)","errorType":"validation","errorClass":null,"httpStatus":null,"severity":"error","filePath":"v3/@claude-flow/cli/src/services/headless-worker-executor.ts","lineNumber":756,"sourceCode":"\n  /**\n   * Get Claude Code version\n   */\n  async getVersion(): Promise<string | null> {\n    await this.isAvailable();\n    return this.claudeCodeVersion;\n  }\n\n  /**\n   * Execute a headless worker\n   */\n  async execute(\n    workerType: HeadlessWorkerType,\n    configOverrides?: Partial<HeadlessOptions>\n  ): Promise<HeadlessExecutionResult> {\n    const baseConfig = HEADLESS_WORKER_CONFIGS[workerType];\n    if (!baseConfig) {\n      throw new Error(`Unknown headless worker type: ${workerType}`);\n    }\n\n    // Check availability\n    const available = await this.isAvailable();\n    if (!available) {\n      const result = this.createErrorResult(\n        workerType,\n        'Claude Code CLI not available. Install with: npm install -g @anthropic-ai/claude-code'\n      );\n      this.emit('error', result);\n      return result;\n    }\n\n    // Check concurrent limit\n    if (this.processPool.size >= this.config.maxConcurrent) {\n      // Queue the request\n      return new Promise((resolve, reject) => {\n        const entry: QueueEntry = {","sourceCodeStart":738,"sourceCodeEnd":774,"githubUrl":"https://github.com/ruvnet/ruflo/blob/fa13ee4ad60ac2090b1480656eb233521790d640/v3/@claude-flow/cli/src/services/headless-worker-executor.ts#L738-L774","documentation":"execute() looked up workerType in the static HEADLESS_WORKER_CONFIGS table and got undefined — the caller asked for a worker kind that is not one of the registered headless worker types. Usually a typo, an unregistered variant, or a worker type added without a config entry.","triggerScenarios":"Thrown at v3/@claude-flow/cli/src/services/headless-worker-executor.ts:756 when the library encounters an invalid state.","commonSituations":"See trigger scenarios.","solutions":["Use one of the supported headless worker types","Check the list of registered worker types before dispatch"],"exampleFix":"Use a supported headless worker type; check the executor's registered worker types and correct the --worker-type value.","handlingStrategy":"validation","validationCode":null,"typeGuard":null,"tryCatchPattern":null,"preventionTips":[],"tags":[],"backgroundTag":null,"analyzedSha":"fa13ee4ad60ac2090b1480656eb233521790d640","analyzedAt":"2026-08-18T21:34:22.708Z","contentChangedAt":"2026-08-18T21:34:22.708Z","schemaVersion":2},"datasetVersion":"2026-09-23T08:17:48.524Z"}