Eve library

ISIS v2 WS07-001: Shot-Level Workflow Schema

Guide

Revision 1

On this page

Scope#

WS07-001 defines first-class shot-level schema support in workflow contracts, including:

  • Shot type.
  • Shot duration.
  • Camera path classification.
  • Continuity constraints.

Research and Existing Implementation Alignment#

The update extends existing cinematic metadata already present in WorkflowInfoSchema:

  • shot_type
  • camera_motion_curve
  • lens_profile
  • pacing_control

Instead of replacing those fields, the implementation adds a normalized shot_profile object and keeps backward compatibility by mapping legacy top-level cinematic controls into the new schema output.

Deliverables#

  1. Added new schema primitives:
  • CameraPath
  • ShotContinuityConstraintsSchema
  • ShotProfileSchema
  1. Extended WorkflowInfoSchema with:
  • shot_profile (shot type, duration seconds, camera path, motion curve, lens profile, pacing, continuity constraints)
  1. Added normalization behavior:
  • Legacy top-level cinematic fields are propagated into shot_profile when shot_profile is omitted or left at defaults.
  1. Expanded workflow schema tests:
  • Defaults for shot_profile
  • Explicit shot-profile validation
  • Legacy-to-shot-profile normalization
  • Invalid camera path rejection

Verification Commands#

bash
pnpm --filter @isis/workflows exec vitest run src/workflows.spec.ts
pnpm --filter @isis/workflows exec tsc -p tsconfig.json --noEmit
node scripts/isis/validate-v2-compliance-gate.mjs