jhonny-editor/code/src/resources/premiere-surface-registry.json

{
  "schemaVersion": 1,
  "researchedAt": "2026-09-01",
  "completionPolicy": "A surface is complete only when its authoritative symbol or document inventory is generated, every item is classified, freshness is checked in CI, and claimed runtime behavior has the declared verification evidence.",
  "integrationSurfaces": [
    {
      "id": "premiere-dom",
      "kind": "api",
      "authorityUrls": ["https://developer.adobe.com/premiere-pro/uxp/ppro-reference/"],
      "versionSource": "@adobe/premierepro@26.3.0",
      "inventoryArtifact": "dist/resources/adobe-api-inventory.json",
      "betaAafExportOptionsDriftArtifact": "dist/resources/adobe-beta-aaf-export-options-drift.json",
      "betaAafExportOptionsDriftCommand": "npm run adobe:beta-aaf-export-options-drift",
      "betaAafExportOptionsDriftVerificationCommand": "npm run adobe:beta-aaf-export-options-drift:check",
      "betaAafExportOptionsDriftDocumentation": "docs/adobe-beta-aaf-export-options-drift.md",
      "betaProjectOptionsDriftArtifact": "dist/resources/adobe-beta-project-options-drift.json",
      "betaProjectOptionsDriftCommand": "npm run adobe:beta-project-options-drift",
      "betaProjectOptionsDriftVerificationCommand": "npm run adobe:beta-project-options-drift:check",
      "betaProjectOptionsDriftDocumentation": "docs/adobe-beta-project-options-drift.md",
      "betaTransitionOptionsDriftArtifact": "dist/resources/adobe-beta-transition-options-drift.json",
      "betaTransitionOptionsDriftCommand": "npm run adobe:beta-transition-options-drift",
      "betaTransitionOptionsDriftVerificationCommand": "npm run adobe:beta-transition-options-drift:check",
      "betaTransitionOptionsDriftDocumentation": "docs/adobe-beta-transition-options-drift.md",
      "betaRectFDriftArtifact": "dist/resources/adobe-beta-rectf-drift.json",
      "betaRectFDriftCommand": "npm run adobe:beta-rectf-drift",
      "betaRectFDriftVerificationCommand": "npm run adobe:beta-rectf-drift:check",
      "betaRectFDriftDocumentation": "docs/adobe-beta-rectf-drift.md",
      "betaColorDriftArtifact": "dist/resources/adobe-beta-color-drift.json",
      "betaColorDriftCommand": "npm run adobe:beta-color-drift",
      "betaColorDriftVerificationCommand": "npm run adobe:beta-color-drift:check",
      "betaColorDriftDocumentation": "docs/adobe-beta-color-drift.md",
      "betaPointFDriftArtifact": "dist/resources/adobe-beta-pointf-drift.json",
      "betaPointFDriftCommand": "npm run adobe:beta-pointf-drift",
      "betaPointFDriftVerificationCommand": "npm run adobe:beta-pointf-drift:check",
      "betaPointFDriftDocumentation": "docs/adobe-beta-pointf-drift.md",
      "betaGuidDriftArtifact": "dist/resources/adobe-beta-guid-drift.json",
      "betaGuidDriftCommand": "npm run adobe:beta-guid-drift",
      "betaGuidDriftVerificationCommand": "npm run adobe:beta-guid-drift:check",
      "betaGuidDriftDocumentation": "docs/adobe-beta-guid-drift.md",
      "betaFrameRateDriftArtifact": "dist/resources/adobe-beta-frame-rate-drift.json",
      "betaFrameRateDriftCommand": "npm run adobe:beta-frame-rate-drift",
      "betaFrameRateDriftVerificationCommand": "npm run adobe:beta-frame-rate-drift:check",
      "betaFrameRateDriftDocumentation": "docs/adobe-beta-frame-rate-drift.md",
      "betaTickTimeDriftArtifact": "dist/resources/adobe-beta-tick-time-drift.json",
      "betaTickTimeDriftCommand": "npm run adobe:beta-tick-time-drift",
      "betaTickTimeDriftVerificationCommand": "npm run adobe:beta-tick-time-drift:check",
      "betaTickTimeDriftDocumentation": "docs/adobe-beta-tick-time-drift.md",
      "betaC2paDriftArtifact": "dist/resources/adobe-beta-c2pa-drift.json",
      "betaC2paDriftCommand": "npm run adobe:beta-c2pa-drift",
      "betaC2paDriftVerificationCommand": "npm run adobe:beta-c2pa-drift:check",
      "betaC2paDriftDocumentation": "docs/adobe-beta-c2pa-drift.md",
      "betaMediaDriftArtifact": "dist/resources/adobe-beta-media-drift.json",
      "betaMediaDriftCommand": "npm run adobe:beta-media-drift",
      "betaMediaDriftVerificationCommand": "npm run adobe:beta-media-drift:check",
      "betaMediaDriftDocumentation": "docs/adobe-beta-media-drift.md",
      "betaMediaManagerDriftArtifact": "dist/resources/adobe-beta-media-manager-drift.json",
      "betaMediaManagerDriftCommand": "npm run adobe:beta-media-manager-drift",
      "betaMediaManagerDriftVerificationCommand": "npm run adobe:beta-media-manager-drift:check",
      "betaMediaManagerDriftDocumentation": "docs/adobe-beta-media-manager-drift.md",
      "betaTranscriptDriftArtifact": "dist/resources/adobe-beta-transcript-drift.json",
      "betaTranscriptDriftCommand": "npm run adobe:beta-transcript-drift",
      "betaTranscriptDriftVerificationCommand": "npm run adobe:beta-transcript-drift:check",
      "betaTranscriptDriftDocumentation": "docs/adobe-beta-transcript-drift.md",
      "betaWorkAreaDriftArtifact": "dist/resources/adobe-beta-work-area-drift.json",
      "betaWorkAreaDriftCommand": "npm run adobe:beta-work-area-drift",
      "betaWorkAreaDriftVerificationCommand": "npm run adobe:beta-work-area-drift:check",
      "betaWorkAreaDriftDocumentation": "docs/adobe-beta-work-area-drift.md",
      "inventoryState": "complete",
      "implementationState": "partial",
      "notes": "All stable declaration symbols are inventoried; mapped means classified, not necessarily a standalone MCP tool or live-host proof. Separate AAFExportOptions-only, project-options-only, transition-options-only, RectF-only, Color-only, PointF-only, Guid-only, FrameRate-only, TickTime-only, Media-only, MediaManager-only, TranscriptStatic-only, C2PA-only, and WorkAreaUtils-only receipts watch narrow pinned beta declaration deltas without advertising beta members as supported."
    },
    {
      "id": "uxp-javascript",
      "kind": "api",
      "authorityUrls": ["https://developer.adobe.com/premiere-pro/uxp/uxp-api/reference-js/"],
      "versionSource": "@adobe/cc-ext-uxp-types@7.3.1",
      "inventoryArtifact": "dist/resources/uxp-js-api-inventory.json",
      "inventoryState": "complete",
      "implementationState": "partial",
      "notes": "All declarations in Adobe's UXP 7.3 type package are inventoried and classified separately from the Premiere DOM; mapped remains static panel evidence, not licensed-host proof."
    },
    {
      "id": "uxp-html",
      "kind": "api",
      "authorityUrls": ["https://developer.adobe.com/premiere-pro/uxp/uxp-api/reference-html/"],
      "versionSource": "Premiere-bundled UXP runtime",
      "inventoryArtifact": "dist/resources/premiere-doc-inventory.json",
      "inventoryState": "complete",
      "implementationState": "partial",
      "notes": "Supported HTML elements and attributes affect the packaged panel, not the MCP command catalog."
    },
    {
      "id": "uxp-css",
      "kind": "api",
      "authorityUrls": ["https://developer.adobe.com/premiere-pro/uxp/uxp-api/reference-css/"],
      "versionSource": "Premiere-bundled UXP runtime",
      "inventoryArtifact": "dist/resources/premiere-doc-inventory.json",
      "inventoryState": "complete",
      "implementationState": "partial",
      "notes": "Supported CSS properties and features affect the packaged panel, not the MCP command catalog."
    },
    {
      "id": "spectrum-web-components",
      "kind": "api",
      "authorityUrls": ["https://developer.adobe.com/premiere-pro/uxp/uxp-api/reference-spectrum/"],
      "versionSource": "Premiere-bundled UXP runtime",
      "inventoryArtifact": "dist/resources/premiere-doc-inventory.json",
      "inventoryState": "complete",
      "implementationState": "partial",
      "notes": "Spectrum UI coverage is a panel compatibility concern and must not inflate editing-tool coverage."
    },
    {
      "id": "uxp-plugin-guides",
      "kind": "documentation",
      "authorityUrls": ["https://developer.adobe.com/premiere-pro/uxp/plugins/"],
      "versionSource": "Adobe documentation",
      "inventoryArtifact": "dist/resources/premiere-doc-inventory.json",
      "inventoryState": "complete",
      "implementationState": "partial",
      "notes": "Manifest, entrypoint, lifecycle, packaging, distribution, and recipe pages are classified in the live-sitemap inventory; implementation remains partial."
    },
    {
      "id": "uxp-hybrid-cpp",
      "kind": "sdk",
      "authorityUrls": ["https://developer.adobe.com/premiere-pro/uxp/plugins/hybrid-plugins/"],
      "versionSource": "UXP Hybrid Plugin SDK from Adobe Developer Console",
      "inventoryArtifact": null,
      "inventoryState": "blocked_external_artifact",
      "implementationState": "gated",
      "inventoryCommand": "npm run native:sdk-header-inventory",
      "inventoryVerificationCommand": "npm run native:sdk-header-inventory:verify",
      "inventoryDocumentation": "docs/native-sdk-header-inventory.md",
      "benchmarkEvidenceCommand": "npm run benchmark:uxp-hybrid:verify",
      "benchmarkEvidenceSchema": "benchmarks/uxp-hybrid/evidence.schema.json",
      "addonReceiptCommand": "npm run native:hybrid-addon-receipt",
      "addonReceiptVerificationCommand": "npm run native:hybrid-addon-receipt:verify",
      "addonReceiptDocumentation": "docs/uxp-hybrid-addon-receipt.md",
      "ccxReceiptCommand": "npm run native:hybrid-ccx-receipt",
      "ccxReceiptVerificationCommand": "npm run native:hybrid-ccx-receipt:verify",
      "ccxReceiptDocumentation": "docs/uxp-hybrid-ccx-receipt.md",
      "ccxReceiptSchemaVersion": 2,
      "notes": "The downloadable SDK headers are access-controlled. The header receipt and standalone verifier can account for an authorized artifact without copying it; a local addon-layout receipt can additionally account for the public root main.js entrypoint and three-target bundle layout without copying source or binaries. A schema-v2 local CCX archive receipt can bind that current layout receipt to the byte-identical required files, a full safe ZIP entry-name-set digest with unambiguous non-ASCII UTF-8 names and declared UTF-8 file comments, matching and feature-sufficient local ZIP version-needed, Deflate-only compression-option flags, framed non-ZIP64 extra fields, and core header fields, no unaccounted local-record or central-directory-to-end bytes, no declared Unix special file types, nonempty directory entries, or nonzero directory CRC-32 values, required streamed data-descriptor CRC/sizes, recomputed ZIP CRC-32, and exact DEFLATE range consumption for the already-required payloads; it also rejects encrypted-entry, central-directory-encryption, other unsupported general-purpose flags, or ZIP64 entry metadata before reading required payloads, without copying archive contents or entry names. A schema-v3 candidate benchmark must bind its runs to matching verified SDK, addon-layout, and current local CCX receipts, but remains disabled until exact SDK, reproducible builds, signing/notarization, and cross-platform evidence are available."
    },
    {
      "id": "premiere-cpp-sdk",
      "kind": "sdk",
      "authorityUrls": [
        "https://developer.adobe.com/premiere-pro/",
        "https://developer.adobe.com/premiere-pro/access-the-developer-console/"
      ],
      "versionSource": "Premiere Pro C++ SDK from Adobe Developer Console",
      "inventoryArtifact": null,
      "inventoryState": "blocked_external_artifact",
      "implementationState": "not_started",
      "inventoryCommand": "npm run native:sdk-header-inventory",
      "inventoryVerificationCommand": "npm run native:sdk-header-inventory:verify",
      "inventoryDocumentation": "docs/native-sdk-header-inventory.md",
      "notes": "The standalone PrSDK for native importers, exporters, effects, transitions, devices, and related plug-ins is distinct from UXP Hybrid addons. The header receipt and standalone verifier can account for an authorized artifact, but the access-controlled SDK documentation and headers are still required."
    },
    {
      "id": "cep-extendscript",
      "kind": "legacy_api",
      "authorityUrls": ["https://github.com/Adobe-CEP/Samples/tree/master/PProPanel"],
      "communityReferenceUrls": [
        "https://ppro-scripting.docsforadobe.dev/",
        "https://github.com/docsforadobe/premiere-scripting-guide"
      ],
      "versionSource": "Premiere Pro Scripting Guide and bundled host DOM",
      "inventoryArtifact": "dist/resources/extendscript-api-inventory.json",
      "inventoryState": "complete",
      "implementationState": "partial",
      "notes": "Every object member documented by the pinned community scripting guide is inventoried. The executable cheat sheet remains curated, and community coverage is not Adobe authority or proof of runtime compatibility."
    },
    {
      "id": "cep-platform",
      "kind": "legacy_sdk",
      "authorityUrls": ["https://github.com/Adobe-CEP/CEP-Resources"],
      "versionSource": "Adobe-CEP/CEP-Resources@ab5e4e3e53a42fad08e1225a22a991bb1ffe73f6",
      "inventoryArtifact": "dist/resources/cep-reference-inventory.json",
      "inventoryState": "complete",
      "implementationState": "partial",
      "notes": "Every file in the pinned Adobe CEP Resources tree and Premiere PProPanel sample subtree is inventoried and classified; implementation remains partial."
    },
    {
      "id": "qe-dom",
      "kind": "undocumented_api",
      "authorityUrls": [],
      "versionSource": "Runtime observation only",
      "inventoryArtifact": null,
      "inventoryState": "unavailable_authoritative_source",
      "implementationState": "experimental",
      "notes": "Adobe publishes no authoritative QE reference. Runtime probes and explicit experimental boundaries remain required."
    }
  ],
  "competitorSources": [
    {
      "repository": "nepfaff/premiere-pro-mcp",
      "commit": "63215d327384ac226183f29cac4140e64382e7a1",
      "observedAt": "2026-09-01",
      "featureFamilies": ["arbitrary_uxp_javascript", "deferred_result_retrieval", "embedded_api_help"],
      "adoptionBoundary": "Arbitrary code generation is already authority-gated in this project; no unsafe default parity is permitted."
    },
    {
      "repository": "antipaster/Adobe-Premiere-Pro-MCP",
      "commit": "9cb62cf9c7f9a64379e0cb1600ff3be93a46cac5",
      "observedAt": "2026-09-01",
      "featureFamilies": ["ai_workflows", "audio", "captions", "effects", "export", "graphics", "markers", "metadata", "playback", "project", "sequence", "timeline"],
      "adoptionBoundary": "Compare named tools and host scripts against current catalog before treating any advertised family as a gap."
    },
    {
      "repository": "designbyfatur/PremiereMCP",
      "commit": "cce19c2e631015f76e209977472316e56e0faf76",
      "observedAt": "2026-09-01",
      "featureFamilies": ["large_declared_tool_catalog", "cli_chat", "cep_host_bridge", "workflow_orchestration"],
      "adoptionBoundary": "README tool-count claims are not implementation or licensed-host evidence; source extraction is required."
    },
    {
      "repository": "MarvelCollin/adobe-premiere-cc-mcp",
      "commit": "c27152fd18ad27c80591d3b88965a9e9a792845d",
      "observedAt": "2026-09-01",
      "featureFamilies": ["audio_faults", "beats", "color_scopes", "dialogue", "ducking", "frame_analysis", "loudness", "motion", "qc", "review", "split_edits", "stabilizer"],
      "adoptionBoundary": "Outcome workflows must be independently implemented with exact target, confirmation, and verification contracts."
    }
  ]
}