Eve library

ISIS v2 Music Cue Pack Output Package Contract

Guide

Revision 1

On this page

Generated: 2026-03-03T16:40:09.131Z Checklist: MXA-0565 (ISIS2-00763) Asset Family: music-cue-pack Phase: Phase 4 | Milestone: M3 Launch (2026-07-27 to 2026-10-30)

Objective#

Define a canonical output package contract for music-cue-pack workflows with deterministic cue-master naming, variant-aware metadata/manifest artifacts, and provenance requirements for reproducible downstream ingest.

Output Class Contracts#

Output Class Package Classes Naming Rules
audio_master audio-master, metadata, manifest FN-001
metadata_manifest metadata, manifest FN-002, FN-003
project_archive archive, metadata, manifest FN-004

File Naming Rules#

Rule ID Applies To Template
FN-001 audio_master masters/{asset_family}/{workflow_variant}/{run_date}/{cue_purpose}/{mood}/{job_id}/{asset_family}_{workflow_variant}_{cue_id}_{cue_purpose}_{mood}_{instrumentation}_{tempo_bpm}bpm_{key_signature}_{time_signature_slug}_{duration_seconds}s_{style_profile_id}_{sample_rate_hz}hz_{seed}_{revision}_master.{wav,flac,aiff}
FN-002 metadata_manifest metadata/{asset_family}/{workflow_variant}/{run_date}/{job_id}/{asset_family}_{workflow_variant}_{cue_id}_{job_id}_manifest.json
FN-003 metadata_manifest manifest/{asset_family}/{workflow_variant}/{run_date}/{job_id}/checksums.sha256
FN-004 project_archive archive/{asset_family}/{workflow_variant}/{run_date}/{job_id}/{asset_family}_{workflow_variant}_{cue_id}_{job_id}_archive.{zip,tar,tar.gz}

Package Class Contracts#

Package Class Storage Tier Required Artifacts
archive COLD archive/package-archive.{zip,tar,tar.gz}
audio-master HOT masters/audio-master.{wav,flac,aiff}
manifest WARM manifest/package-manifest.json, manifest/checksums.sha256
metadata WARM metadata/generation-metadata.json, metadata/provenance.json
preview HOT preview/hero-preview.{png,jpg,webp,mp4}, preview/thumbnail.{png,jpg,webp}

Variant Packaging Overrides#

Variant Workflow ID Filename Prefixes Continuity Manifest
baseline music-cue-pack-baseline music_cue_pack_baseline not-required
image-conditioned music-cue-pack-image-conditioned music_cue_pack_image_conditioned not-required
control-conditioned music-cue-pack-control-conditioned music_cue_pack_control_conditioned not-required
consistency-locked music-cue-pack-consistency-locked music_cue_pack_consistency_locked, music_cue_pack_consistency_locked_manifest, music_cue_pack_consistency_locked_archive required

Metadata Manifest Schema#

  • Required top-level fields:
    • manifestVersion
    • assetFamilyId
    • workflowVariant
    • workflowId
    • cueId
    • cuePurpose
    • mood
    • instrumentation
    • tempoBpm
    • keySignature
    • timeSignature
    • durationSeconds
    • jobId
    • generatedAt
    • runDate
    • seed
    • sampleRateHz
    • targetLufs
    • outputClasses
    • artifacts
    • checksums
    • provenance
    • dependencyManifestRef
  • Required artifact entry fields:
    • artifactId
    • outputClass
    • packageClass
    • relativePath
    • mimeType
    • bytes
    • sha256
    • storageTier
  • Required provenance fields:
    • modelDependenciesDigest
    • nodeClassDependenciesDigest
    • promptFingerprint
    • conditioningSnapshot
    • cueId
    • cuePurpose
    • mood
    • instrumentation
    • tempoBpm
    • keySignature
    • timeSignature
    • durationSeconds
    • targetLufs
    • sampleRateHz
    • outputFormat
    • promptTemplateId
    • styleProfileId
    • modelName
    • conditioningMode
    • referenceMixStrategy
    • referenceAudioDigests
    • controlProfileId
    • controlSignalSnapshot
    • eventAlignmentMode
    • continuityProfileId
    • continuityNotesDigest
    • motifAlignmentScore
    • cueTimingAlignmentScore
    • integratedLufsDelta
    • harmonicDriftScore

Acceptance Criteria#

  • Output class contracts map each required output class to package classes and deterministic naming rules.
  • All variant overrides include mandatory metadata + checksum artifacts, cue mastering artifacts, and preserve workflow-specific filename prefixes.
  • Metadata manifest schema requires cue-level composition provenance, quality metrics, and dependency-manifest linkage fields for reproducibility.
  • Package profile and class requirements remain synchronized with output package taxonomy source of truth.

Traceability#

  • Checklist item: MXA-0565
  • Ticket key: ISIS2-00763
  • Source references:
    • docs/domains/isis/remediation-v2/ISIS_REMEDIATION_V2_TICKETS.json
    • docs/domains/isis/remediation-v2/ISIS_V2_MUSIC_CUE_PACK_REQUIREMENTS_BRIEF.json
    • docs/domains/isis/remediation-v2/ISIS_V2_OUTPUT_PACKAGE_TAXONOMY.json
    • docs/domains/isis/remediation-v2/ISIS_V2_MUSIC_CUE_PACK_MODEL_NODE_DEPENDENCY_MANIFEST.json
    • docs/domains/isis/remediation-v2/ISIS_V2_MUSIC_CUE_PACK_BASELINE_WORKFLOW_GRAPH.json
    • docs/domains/isis/remediation-v2/ISIS_V2_MUSIC_CUE_PACK_IMAGE_CONDITIONED_WORKFLOW_GRAPH.json
    • docs/domains/isis/remediation-v2/ISIS_V2_MUSIC_CUE_PACK_CONTROL_CONDITIONED_WORKFLOW_GRAPH.json
    • docs/domains/isis/remediation-v2/ISIS_V2_MUSIC_CUE_PACK_CONSISTENCY_LOCKED_WORKFLOW_GRAPH.json
    • docs/domains/isis/remediation-v2/ISIS_V2_ACCEPTANCE_CRITERIA.md
    • docs/domains/isis/remediation-v2/ISIS_V2_AUDIO_CONDITIONING_SUPPORT.md
    • docs/domains/isis/remediation-v2/ISIS_V2_MUSIC_CUE_PACK_REQUIREMENTS_BRIEF.md
    • docs/domains/isis/remediation-v2/ISIS_V2_MUSIC_CUE_PACK_CONSISTENCY_LOCKED_WORKFLOW_GRAPH.md
    • ISIS_TODOS_2.md