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