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.tsalready provides deterministic single-shot continuity planning.libs/isis/workflows/src/consistency/shot-profiles.tsalready 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#
- Added sequence continuity orchestrator module:
SequenceContinuityOrchestratorcreateSequenceContinuityOrchestrator- Sequence request/result contracts with shot ordering, chain carry state, and sequence tokenization.
- 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.
- 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.
- 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.
- Exported new APIs via package entrypoints:
libs/isis/workflows/src/consistency/index.tslibs/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