Eve library

ISIS v2 EDL Output Schema and Metadata Contract

Guide

Revision 1

On this page

Generated: 2026-03-06T09:57:22.378Z Checklist: MXD-0065 (ISIS2-01255) Format: edl (application/edl) Phase: Phase 4 | Milestone: M3 Launch (2026-07-27 to 2026-10-30)

Objective#

Define a canonical schema and metadata contract for EDL outputs with frame-rate/drop-frame validation, deterministic timecode signaling, event inventory coverage, and workflow provenance aligned to existing editorial bundle generation.

Canonical Schema#

  • Schema ID: isis.v2.output.edl.package
  • Schema Version: 1.0.0
  • Binary signature: 54 49 54 4C 45
  • Required top-level fields:
    • schemaVersion
    • format
    • fps
    • dropFrame
    • timelineStartTimecode
    • eventCount
    • reelCount
    • transitionCount
    • includesVideoEvents
    • includesAudioEvents
    • artifactRole
    • manifest
  • Manifest fields:
    • filename
    • mimeType
    • checksumAlgorithm
    • checksum
    • generatedAt
    • provenance
  • Provenance fields:
    • assetFamilyId
    • workflowId
    • workflowVariant
    • promptFingerprint
    • seed
    • modelId
    • dependencyManifestRef

Supported Package Classes#

Package Class Storage Tier Required Artifacts

Supported Output Classes#

Output Class Package Classes

Applicable Asset Families#

Asset Family Output Classes Naming Rules

Validation Invariants#

  • Drop-frame EDL outputs require 29.97 or 59.94 fps.
  • timelineStartTimecode separator must align with dropFrame mode.
  • transitionCount cannot exceed eventCount for EDL outputs.
  • EDL outputs must include video or audio events.
  • RegisterOutputRequest mimeType must be application/edl, type must be document, and storage.key must end with .edl when edlPackage is supplied.
  • EDL manifest checksum uses sha256 and must preserve workflow/dependency provenance linkage.

Verification Commands#

  • pnpm --filter @isis/output-registry exec vitest run src/schemas/output.schema.spec.ts
  • pnpm --filter @isis/generation-api exec vitest run src/schemas/job.schema.spec.ts
  • node scripts/isis/validate-v2-edl-output-schema-metadata-contract.mjs

Acceptance Criteria#

  • Output registry accepts first-class EDL package metadata with strict validation over frame rate, drop-frame behavior, event inventory, and manifest checksum fields.
  • Canonical EDL contract documents the current shared taxonomy support surface while aligning MIME handling with the existing editorial bundle runtime.
  • EDL manifest provenance preserves workflow-variant and dependency-manifest linkage needed for deterministic downstream ingest of editorial timeline artifacts.
  • Validator and schema tests catch invalid EDL registrations and enforce the canonical metadata surface.

Traceability#

  • Checklist item: MXD-0065
  • Ticket key: ISIS2-01255
  • Source references:
    • docs/domains/isis/remediation-v2/ISIS_REMEDIATION_V2_TICKETS.json
    • docs/domains/isis/remediation-v2/ISIS_V2_OUTPUT_PACKAGE_TAXONOMY.json
    • apps/isis/output-registry/src/schemas/output.schema.ts
    • apps/isis/output-registry/src/schemas/output.schema.spec.ts
    • apps/isis/output-registry/src/services/output.service.ts
    • apps/isis/output-registry/src/types.ts
    • apps/isis/generation-api/src/workflows/executor.ts
    • apps/isis/generation-api/src/schemas/job.schema.spec.ts
    • docs/domains/isis/remediation-v2/ISIS_V2_EDITORIAL_EXPORT_BUNDLES.md
    • ISIS_TODOS_2.md