# ISIS v2 WS07-001: Shot-Level Workflow Schema

## 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`

2. Extended `WorkflowInfoSchema` with:

- `shot_profile` (shot type, duration seconds, camera path, motion curve, lens
  profile, pacing, continuity constraints)

3. Added normalization behavior:

- Legacy top-level cinematic fields are propagated into `shot_profile` when
  `shot_profile` is omitted or left at defaults.

4. 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
```
