Files
calesthio 355fd2b7d6 Implementation spec: governance, decision intelligence, theme system, and E2E bug fixes
Implements the 2026-04-02 transformation spec (Phases 1-8) and fixes all
critical bugs found during 5-pipeline E2E testing.

Governance & Decision Intelligence:
- Pipeline-specific stage order in checkpoint (replaces global STAGES list)
- Provider scoring engine (lib/scoring.py) with 7-dimension weighted ranking
- Decision log artifact enforced at proposal/idea stage across all 10 pipelines
- Delivery promise classifier prevents silent motion-to-still downgrades
- Structured shot language in scene_plan schema (camera, lens, lighting, DOF)
- Variation checker and slideshow risk scorer block samey output before render
- Creative intake, capability extension, and creative-intake meta skills
- Final self-review artifact with 5 mandatory checks before presenting output
- Source media review contract for user-supplied footage

Render & Theme System:
- Remotion AnimatedBackground now derives colors from playbook (no more hardcoded
  dark blue fintech gradient on every video)
- video_compose builds custom ThemeConfig from playbook YAML colors/fonts —
  custom playbooks flow through to Remotion automatically
- Explainer component wires theme to all child components (charts, cards, etc.)
- resolveAsset() handles absolute paths on Windows/Unix via file:// URIs
- RENDERER_FAMILY_MAP synced with actual Remotion compositions

Critical Bug Fixes:
- Windows npx subprocess: run_command() resolves .cmd wrappers via shutil.which()
- Silent renderer downgrade: Remotion failure now returns explicit error with
  options instead of silently falling back to FFmpeg
- .env inline comment parsing strips trailing # comments from API keys
- concat_path UnboundLocalError in video_compose finally block
- audio_mixer and showcase_card capture=True kwarg bug
- Selector estimate_cost() calls fixed (_select_tool -> _select_best_tool)
- asset_manifest schema expanded with provider, license, subtype fields
- screen-demo subtitle_gen moved from required to optional tools
- Duration drift detection in post-render final review (>25% warns)
2026-04-03 09:35:09 -07:00

1.4 KiB

Publish Director - Animation Pipeline

When To Use

Package the animation so the metadata, thumbnail concept, and platform framing reflect the actual visual system of the project.

Prerequisites

Layer Resource Purpose
Schema schemas/artifacts/publish_log.schema.json Artifact validation
Prior artifacts state.artifacts["compose"]["render_report"], state.artifacts["proposal"]["proposal_packet"], state.artifacts["research"]["research_brief"], state.artifacts["script"]["script"] Final outputs and topic framing
Playbook Active style playbook Visual naming consistency

Process

1. Match Packaging To The Animation Mode

Examples:

  • diagram-heavy videos should look structured and legible,
  • kinetic-type pieces should package around strong copy,
  • illustrative animation should package around hero imagery.

2. Preserve Visual-System Truth

Store in publish_log.metadata:

  • animation_mode
  • hero_frame_notes
  • thumbnail_concept
  • platform_notes

3. Quality Gate

  • metadata fits the actual animation mode,
  • thumbnail concept matches the final visual system,
  • exports are labeled by purpose and platform,
  • the package is usable without extra manual work.

Common Pitfalls

  • Writing generic metadata that ignores the animation style.
  • Creating a thumbnail concept unrelated to the final frames.
  • Mixing platform variants without clear labels.