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)

pipeline_defs/cinematic.yaml

@@ -17,9 +17,16 @@ orchestration:
   max_send_backs: 3
   max_wall_time_minutes: 12
 
+extensions:
+  custom_scripts: true
+  custom_playbooks: true
+  custom_skills: true
+  custom_tools: false
+
 required_skills:
   - pipelines/cinematic/executive-producer
-  - pipelines/cinematic/idea-director
+  - pipelines/cinematic/research-director
+  - pipelines/cinematic/proposal-director
   - pipelines/cinematic/script-director
   - pipelines/cinematic/scene-director
   - pipelines/cinematic/asset-director
@@ -30,15 +37,41 @@ required_skills:
   - meta/checkpoint-protocol
 
 compatible_playbooks:
-  - clean-professional
-  - flat-motion-graphics
-  - minimalist-diagram
+  recommended:
+    - clean-professional
+    - flat-motion-graphics
+  also_works:
+    - minimalist-diagram
+  custom_allowed: true
 
 stages:
-  - name: idea
-    skill: pipelines/cinematic/idea-director
+  - name: research
+    skill: pipelines/cinematic/research-director
     produces:
-      - brief
+      - research_brief
+    tools_available:
+      - web_search
+    checkpoint_required: true
+    human_approval_default: false
+    review_focus:
+      - Visual references are specific and relevant to the mood
+      - Sound and music direction is substantive, not generic
+      - Motion commitment is honest about available capabilities
+      - At least 3 genuinely different cinematic directions identified
+    success_criteria:
+      - Schema-valid research_brief artifact
+      - At least 8 web searches executed
+      - Visual references include specific URLs and descriptions
+
+  - name: proposal
+    skill: pipelines/cinematic/proposal-director
+    required_artifacts_in:
+      - research_brief
+    optional_artifacts_in:
+      - source_media_review
+    produces:
+      - proposal_packet
+      - decision_log
     tools_available: []
     checkpoint_required: true
     human_approval_default: true
@@ -47,14 +80,19 @@ stages:
       - Motion-required delivery is explicitly identified when applicable
       - Delivery shape is realistic for available footage and assets
       - Cinematic treatment is justified rather than decorative
+      - Delivery promise is explicit and honest
+      - Renderer family is selected and locked
+      - Music plan is resolved
     success_criteria:
-      - Schema-valid brief artifact
-      - Brief records source reality and target output shape
+      - Schema-valid proposal_packet artifact
+      - At least 3 concept options with different emotional arcs
+      - Delivery promise present with motion_required flag
+      - Cost estimate includes per-item breakdown
 
   - name: script
     skill: pipelines/cinematic/script-director
     required_artifacts_in:
-      - brief
+      - proposal_packet
     produces:
       - script
     optional_tools:
@@ -78,7 +116,7 @@ stages:
     required_artifacts_in:
       - script
     optional_artifacts_in:
-      - brief
+      - proposal_packet
     produces:
       - scene_plan
     optional_tools:
@@ -158,6 +196,7 @@ stages:
       - scene_plan
     produces:
       - render_report
+      - final_review
     required_tools:
       - video_compose
       - audio_mixer
@@ -188,8 +227,9 @@ stages:
     skill: pipelines/cinematic/publish-director
     required_artifacts_in:
       - render_report
+      - final_review
     optional_artifacts_in:
-      - brief
+      - proposal_packet
       - script
     produces:
       - publish_log