{"record":{"id":"5fefb3e81ce9ff0f","repo":"ruvnet/ruflo","slug":"unsupported-api-version","errorCode":"UNSUPPORTED_API_VERSION","errorMessage":"API version \"${manifest.apiVersion}\" is not supported (expected \"${SUPPORTED_API_VERSION}\")","messagePattern":"API version \"(.+?)\" is not supported \\(expected \"(.+?)\"\\)","errorType":"validation","errorClass":"ValidationError","httpStatus":null,"severity":"error","filePath":"v3/@claude-flow/guidance/src/manifest-validator.ts","lineNumber":720,"sourceCode":"      if (!TRACE_LEVELS.includes(manifest.observability.traceLevel as typeof TRACE_LEVELS[number])) {\n        errors.push({\n          code: 'INVALID_ENUM',\n          field: 'observability.traceLevel',\n          message: `traceLevel must be one of: ${TRACE_LEVELS.join(', ')}`,\n          severity: 'error',\n        });\n      }\n    }\n\n    return errors;\n  }\n\n  private validateApiVersion(manifest: AgentCellManifest): ValidationError[] {\n    if (!manifest.apiVersion) return []; // caught by requiredFields\n\n    if (manifest.apiVersion !== SUPPORTED_API_VERSION) {\n      return [{\n        code: 'UNSUPPORTED_API_VERSION',\n        field: 'apiVersion',\n        message: `API version \"${manifest.apiVersion}\" is not supported (expected \"${SUPPORTED_API_VERSION}\")`,\n        severity: 'error',\n      }];\n    }\n    return [];\n  }\n\n  private validateDigest(manifest: AgentCellManifest): ValidationError[] {\n    if (!manifest.cell?.codeRef?.digest) return []; // caught by requiredFields\n\n    if (!SHA256_DIGEST_RE.test(manifest.cell.codeRef.digest)) {\n      return [{\n        code: 'INVALID_DIGEST',\n        field: 'cell.codeRef.digest',\n        message: `Digest must match \"sha256:<64 hex chars>\" format (got \"${manifest.cell.codeRef.digest}\")`,\n        severity: 'error',\n      }];","sourceCodeStart":702,"sourceCodeEnd":738,"githubUrl":"https://github.com/ruvnet/ruflo/blob/fa13ee4ad60ac2090b1480656eb233521790d640/v3/@claude-flow/guidance/src/manifest-validator.ts#L702-L738","documentation":"validateApiVersion() found manifest.apiVersion differs from the single SUPPORTED_API_VERSION. UNSUPPORTED_API_VERSION error: the cell manifest was authored for a different platform generation and cannot be validated/loaded against this validator's schema.","triggerScenarios":"Thrown at v3/@claude-flow/guidance/src/manifest-validator.ts:720 when the library encounters an invalid state.","commonSituations":"See trigger scenarios.","solutions":["Set apiVersion to the supported version indicated in the message.","Pin the manifest generator to the supported API version to avoid drift."],"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-14T05:17:10.506Z"}