{"record":{"id":"bf1b7a98faa6fb27","repo":"ruvnet/ruflo","slug":"bead-not-found","errorCode":"BEAD_NOT_FOUND","errorMessage":"Bead not found: ${beadId}","messagePattern":"Bead not found: (.+?)","errorType":"exception","errorClass":"BdBridgeError","httpStatus":null,"severity":"error","filePath":"v3/plugins/gastown-bridge/src/bridges/bd-bridge.ts","lineNumber":787,"sourceCode":"   */\n  async getBead(beadId: string): Promise<Bead> {\n    this.ensureInitialized();\n\n    const validatedId = BeadIdSchema.parse(beadId);\n\n    // Check single bead cache first\n    const cached = singleBeadCache.get(validatedId);\n    if (cached) {\n      this.logger.debug('Bead cache hit', { beadId: validatedId });\n      return cached;\n    }\n\n    const args = ['get', validatedId, '--format', 'json'];\n\n    const result = await this.execBd(args);\n    if (!result.success) {\n      if (result.error?.includes('not found')) {\n        throw new BdBridgeError(\n          `Bead not found: ${beadId}`,\n          'BEAD_NOT_FOUND',\n          'bd',\n          args\n        );\n      }\n      throw new BdBridgeError(\n        result.error ?? 'Failed to get bead',\n        'EXECUTION_FAILED',\n        'bd',\n        args\n      );\n    }\n\n    const bead = this.parseSingleBead(result.data ?? '');\n\n    // Cache the result\n    singleBeadCache.set(bead.id, bead);","sourceCodeStart":769,"sourceCodeEnd":805,"githubUrl":"https://github.com/ruvnet/ruflo/blob/fa13ee4ad60ac2090b1480656eb233521790d640/v3/plugins/gastown-bridge/src/bridges/bd-bridge.ts#L769-L805","documentation":"getBead() executed 'bd get' and the failure output contains 'not found', meaning no bead exists with the validated bead id. Surfaces as a targeted not-found error (with the id) rather than a generic execution failure.","triggerScenarios":"Thrown at v3/plugins/gastown-bridge/src/bridges/bd-bridge.ts:787 when the library encounters an invalid state.","commonSituations":"See trigger scenarios.","solutions":["Verify the referenced identifier exists before use (list available items and match against user input).","Return a clear 404-style error listing valid identifiers, and have the caller retry with an existing id."],"exampleFix":null,"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-14T00:17:10.932Z"}