{"record":{"id":"e73780e4d5c95a86","repo":"heygen-com/hyperframes","slug":"unknown-media-treatment-capability-id","errorCode":null,"errorMessage":"Unknown media-treatment capability: ${id}","messagePattern":"Unknown media-treatment capability: (.+?)","errorType":"exception","errorClass":"Error","httpStatus":null,"severity":"error","filePath":"packages/cli/src/commands/media-treatment.ts","lineNumber":298,"sourceCode":"      description: \"Seek-safe CSS properties for registered GSAP timelines.\",\n      properties: capabilities.animatable,\n    },\n    lut: {\n      id,\n      description: \"User-owned 3D .cube LUT support.\",\n      contract: capabilities.lut,\n    },\n    overlays: {\n      id,\n      description: \"Authored overlay blocks owned by the HyperFrames Registry.\",\n      discover: \"hyperframes catalog\",\n      apply: \"hyperframes add <overlay> --dir <project> --no-clipboard --json\",\n    },\n  } as const;\n\n  const detail = Object.hasOwn(details, id) ? Reflect.get(details, id) : undefined;\n  if (detail) return detail;\n  throw new Error(`Unknown media-treatment capability: ${id}`);\n}\n\nexport const examples: Example[] = [\n  [\n    \"Discover the complete treatment surface without loading every control\",\n    `hyperframes media-treatment --capabilities --json`,\n  ],\n  [\n    \"Inspect one relevant effect in detail\",\n    `hyperframes media-treatment --capability kuwahara --json`,\n  ],\n  [\n    \"Inspect the exhaustive machine-readable catalog\",\n    `hyperframes media-treatment --capabilities --all --json`,\n  ],\n  [\n    \"Apply a resolved treatment to one media element\",\n    `hyperframes media-treatment --selector '#hero' --grading '{\"preset\":\"skin-soft\",\"intensity\":0.6}' --apply`,","sourceCodeStart":280,"sourceCodeEnd":316,"githubUrl":"https://github.com/heygen-com/hyperframes/blob/c2996c8626135db5253519359d8a063d3bafad8d/packages/cli/src/commands/media-treatment.ts#L280-L316","documentation":"Thrown by getMediaTreatmentCapabilityDetail() in packages/cli/src/commands/media-treatment.ts:298. The function resolves a capability id against families (grading, correction, wheels, curves, hue-curves, secondary, scopes, presets, finishing, palettes, animation, lut, overlays), individual effects, adjustments, finishing controls, presets, and palettes. If the id matches none of those registries, it throws this.","triggerScenarios":"Running `hyperframes media-treatment --capability <id>` where <id> is not any registered family, control, effect, preset, or palette id.","commonSituations":"Typo in the id; using an id introduced in a newer CLI version than is installed; copy-pasting an id from outdated docs; case mismatch (ids are lowercase kebab-case).","solutions":["List valid ids: `hyperframes media-treatment --capabilities --json` (overview) or `--all` (full catalog).","Fix the typo / casing to match a listed id.","Update the CLI (`bun update` / reinstall) if the id is documented for a newer version.","If exploring interactively, drill in with `--capability <family>` first to see child ids."],"exampleFix":"# before\nhyperframes media-treatment --capability whels --json   # typo\n# after\nhyperframes media-treatment --capability wheels --json","handlingStrategy":"validation","validationCode":"import { getMediaTreatmentCapabilityOverview } from './media-treatment.js';\n\nfunction isKnownCapabilityFamily(id: string): boolean {\n  const overview = getMediaTreatmentCapabilityOverview() as { families: { id: string }[] };\n  return overview.families.some((f) => f.id === id);\n}","typeGuard":null,"tryCatchPattern":"try {\n  getMediaTreatmentCapabilityDetail(id);\n} catch (error) {\n  if (/Unknown media-treatment capability/.test(String(error))) {\n    // list valid ids and ask the caller to pick\n    console.error('Unknown capability. Run: hyperframes media-treatment --capabilities --json');\n    process.exit(1);\n  }\n  throw error;\n}","preventionTips":["Always discover ids via --capabilities before hardcoding one in a script.","Pin the CLI version so the capability set doesn't shift under your automation.","Treat capability ids as case-sensitive lowercase kebab-case."],"tags":["cli","validation","color-grading"],"backgroundTag":null,"analyzedSha":"c2996c8626135db5253519359d8a063d3bafad8d","analyzedAt":"2026-08-12T22:18:56.877Z","schemaVersion":2},"datasetVersion":"2026-08-12T23:17:12.415Z"}