Eve library

ISIS v2 WS07-002: Sequence-Level Continuity Orchestrator

Guide

Revision 1

On this page

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.
  1. 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.
  1. 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.
  1. 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.
  1. 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