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_typecamera_motion_curvelens_profilepacing_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#
- Added new schema primitives:
CameraPathShotContinuityConstraintsSchemaShotProfileSchema
- Extended
WorkflowInfoSchemawith:
shot_profile(shot type, duration seconds, camera path, motion curve, lens profile, pacing, continuity constraints)
- Added normalization behavior:
- Legacy top-level cinematic fields are propagated into
shot_profilewhenshot_profileis omitted or left at defaults.
- 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