{"record":{"id":"1aee608ea376b187","repo":"ruvnet/ruflo","slug":"sdk-version-this-currentversion-full-is-not-com","errorCode":null,"errorMessage":"SDK version ${this.currentVersion.full} is not compatible. Required: ${compatibility.minVersion.full} - ${compatibility.maxVersion.full}","messagePattern":"SDK version (.+?) is not compatible\\. Required: (.+?) - (.+?)","errorType":"exception","errorClass":null,"httpStatus":null,"severity":"error","filePath":"v3/@claude-flow/integration/src/sdk-bridge.ts","lineNumber":99,"sourceCode":"\n  /**\n   * Initialize the SDK bridge\n   */\n  async initialize(): Promise<void> {\n    if (this.initialized) {\n      return;\n    }\n\n    this.emit('initializing');\n\n    try {\n      // Detect SDK version\n      this.currentVersion = await this.detectVersion();\n\n      // Check compatibility\n      const compatibility = await this.checkCompatibility();\n      if (!compatibility.compatible) {\n        throw new Error(\n          `SDK version ${this.currentVersion.full} is not compatible. ` +\n          `Required: ${compatibility.minVersion.full} - ${compatibility.maxVersion.full}`\n        );\n      }\n\n      // Detect available features\n      await this.detectFeatures();\n\n      this.initialized = true;\n      this.emit('initialized', {\n        version: this.currentVersion,\n        features: Array.from(this.availableFeatures)\n      });\n    } catch (error) {\n      this.emit('initialization-failed', { error });\n      throw error;\n    }\n  }","sourceCodeStart":81,"sourceCodeEnd":117,"githubUrl":"https://github.com/ruvnet/ruflo/blob/fa13ee4ad60ac2090b1480656eb233521790d640/v3/@claude-flow/integration/src/sdk-bridge.ts#L81-L117","documentation":"SDKBridge.initialize() detects the installed SDK's version, then checks it against the bridge's supported min-max compatibility range; a version outside [minVersion, maxVersion] aborts initialization with this error and leaves the bridge uninitialized.","triggerScenarios":"Calling initialize() (directly or via createSDKBridge) when the detected SDK version is older than compatibility.minVersion or newer than compatibility.maxVersion — e.g. a fresh install pulled a new major, or a stale lockfile still holds a too-old copy.","commonSituations":"npm update / yarn upgrade bumps the SDK past the bridge's supported ceiling; a cached or hoisted old SDK in a monorepo resolves instead of the expected one; the integration package is newer or older than the SDK it wraps.","solutions":["Pin the SDK to a version inside the reported range (e.g. change '^2.0.0' to '~1.9.0') and do a clean reinstall","Upgrade @claude-flow/integration to a release whose bridge supports your SDK version","In monorepos, verify which SDK copy actually resolves (npm ls / yarn why) — a hoisted duplicate is a common culprit"],"exampleFix":"// before (package.json)\n\"dependencies\": { \"@claude-flow/sdk\": \"^2.0.0\" } // bridge requires 1.2.0 - 1.9.x\n\n// after\n\"dependencies\": { \"@claude-flow/sdk\": \"~1.9.0\" } // inside the supported range","handlingStrategy":"validation","validationCode":"// Fail fast at boot with an actionable message instead of failing mid-run\nimport { satisfies } from 'semver';\nconst sdkVersion = getInstalledSdkVersion(); // e.g. require('...package.json').version\nif (!satisfies(sdkVersion, '>=1.2.0 <2.0.0')) {\n  throw new Error(`SDK ${sdkVersion} outside supported range — pin ~1.9.0 or upgrade the bridge`);\n}","typeGuard":null,"tryCatchPattern":"try {\n  const bridge = await createSDKBridge(config);\n} catch (e) {\n  if (e instanceof Error && e.message.includes('is not compatible')) {\n    // surface a setup hint (pin/upgrade) and abort startup — retrying won't change the version\n  }\n  throw e;\n}","preventionTips":["Lock the SDK version (~ or exact) instead of ^ when the bridge has a narrow supported range","Add a CI step that runs bridge initialization against the locked SDK","After any dependency refresh, run a canary initialize() before deploying"],"tags":["version","compatibility","sdk","initialization"],"backgroundTag":"sdk-version-incompatible","analyzedSha":"fa13ee4ad60ac2090b1480656eb233521790d640","analyzedAt":"2026-08-18T21:34:22.708Z","contentChangedAt":"2026-08-18T21:34:22.708Z","schemaVersion":2},"datasetVersion":"2026-09-14T05:17:10.506Z"}