Scope#
WS07-003 implements storyboard-to-shot workflow templates that compile
storyboard frames into deterministic shot requests with configurable parameter
inheritance behavior.
Research and Existing Implementation Alignment#
The implementation extends existing workflow/template capabilities instead of rebuilding execution logic:
- Existing
TemplateEnginehandles prompt expression rendering. - Existing
SequenceContinuityOrchestratorhandles shot-chain continuity orchestration.
This task adds a storyboard compiler that prepares sequence-shot plans and feeds that existing execution stack.
Deliverables#
- Added storyboard compiler module:
StoryboardShotTemplateCompilercreateStoryboardShotTemplateCompiler- Typed storyboard defaults, frames, inheritance config, and compile result contracts.
- Implemented configurable parameter inheritance:
cascadingstrategy (shot N inherits resolved parameters from shot N-1).global_onlystrategy (each shot inherits only global defaults).- Array merge policies:
append_uniqueandreplace. - Top-level reset keys to intentionally drop carry-forward parameters.
- Implemented continuity-aware shot request generation:
- Generates
SequenceShotRequestentries per frame. - Merges default + per-frame continuity directives/preset IDs.
- Auto-populates scene continuity scope (
sequenceId,shotId) per shot. - Adds storyboard metadata + duration into shot
requestParameters.
- Implemented deterministic normalization and validation:
- Stable shot ordering by
order(with input-order tie-break). - Duplicate shot ID rejection after normalization.
- Warning emission for empty resolved prompts.
- Added full test coverage:
- Cascading inheritance behavior.
- Global-only inheritance behavior.
- Reset-key behavior.
- Duplicate-shot validation.
- Exported compiler via package entrypoints:
libs/isis/workflows/src/templates/index.tslibs/isis/workflows/src/index.ts
Verification Commands#
bash
pnpm --filter @isis/workflows exec vitest run src/templates/storyboard-shot-templates.spec.ts src/consistency/sequence-orchestration.spec.ts src/consistency/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