# ISIS v2 WS07-002: Sequence-Level Continuity Orchestrator

## Scope

`WS07-002` implements a sequence-level orchestrator that chains shot continuity
planning while preserving continuity profile state across adjacent shots.

## Research and Existing Implementation Alignment

Before implementation, the existing continuity stack was analyzed:

- `libs/isis/workflows/src/consistency/orchestration.ts` already provides
  deterministic single-shot continuity planning.
- `libs/isis/workflows/src/consistency/shot-profiles.ts` already provides
  revisioned shot continuity profile hydration.

The new implementation composes those proven primitives into a dedicated
sequence orchestrator rather than re-implementing continuity logic.

## Deliverables

1. Added sequence continuity orchestrator module:

- `SequenceContinuityOrchestrator`
- `createSequenceContinuityOrchestrator`
- Sequence request/result contracts with shot ordering, chain carry state, and
  sequence tokenization.

2. Implemented deterministic shot chaining behavior:

- Orders shots by `shotIndex` (stable tie-break by input order).
- Applies shared + per-shot continuity directives.
- Carries continuity state between shots with configurable carry modes:
  `full_state`, `locked_only`, `profiles_only`.

3. Implemented continuity preservation safeguards:

- Preserves continuity profile keys across shot boundaries.
- Auto-stamps scene scope (`sequenceId`, `shotId`) when scene continuity is
  active.
- Emits warnings when resolved shot profile metadata mismatches requested
  sequence/shot identifiers.

4. Added comprehensive tests:

- Multi-shot chaining and profile preservation.
- Explicit continuity reset via `preserveContinuity: false`.
- Deterministic sequence token generation across semantically equivalent input.
- Duplicate shot ID rejection.
- Sequence mismatch warning detection.

5. Exported new APIs via package entrypoints:

- `libs/isis/workflows/src/consistency/index.ts`
- `libs/isis/workflows/src/index.ts`

## Verification Commands

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