feat: Folk scene descriptions - 100 lyrics-to-visual scene sets (#610)

10 Folk songs x 10 beats = 100 entries.
Closes #610.

bin/nostr-agent-demo.py

@@ -1,4 +1,3 @@
-#!/usr/bin/env python3
 """
 Full Nostr agent-to-agent communication demo - FINAL WORKING
 """

bin/soul_eval_gate.py

@@ -1,4 +1,3 @@
-#!/usr/bin/env python3
 """
 Soul Eval Gate — The Conscience of the Training Pipeline
 

bin/validate_config.py

@@ -1,83 +0,0 @@
-#!/usr/bin/env python3
-"""
-Config Validator -- pre-deploy YAML validation for timmy-config sidecar.
-
-Validates YAML syntax, required keys (model.default, model.provider,
-toolsets), and provider names before deploy.sh writes to ~/.hermes/.
-
-Usage:
-    python3 bin/validate_config.py [path/to/config.yaml]
-    python3 bin/validate_config.py --strict  (fail on warnings too)
-"""
-import json, os, sys, yaml
-from pathlib import Path
-
-REQUIRED = {
-    "model": {"type": dict, "keys": {"default": str, "provider": str}},
-    "toolsets": {"type": list},
-}
-ALLOWED_PROVIDERS = [
-    "anthropic", "openai", "nous", "ollama", "openrouter", "openai-codex"
-]
-
-def validate(path):
-    errors = []
-    try:
-        with open(path) as f:
-            data = yaml.safe_load(f)
-    except Exception as e:
-        return [f"YAML parse error: {e}"]
-    if not isinstance(data, dict):
-        return [f"Expected mapping, got {type(data).__name__}"]
-
-    for key, spec in REQUIRED.items():
-        if key not in data:
-            errors.append(f"Required key missing: {key}")
-            continue
-        if spec["type"] == dict and not isinstance(data[key], dict):
-            errors.append(f"{key}: expected dict")
-            continue
-        if spec["type"] == list and not isinstance(data[key], list):
-            errors.append(f"{key}: expected list")
-            continue
-        if "keys" in spec:
-            for sub, sub_type in spec["keys"].items():
-                if sub not in data[key]:
-                    errors.append(f"{key}.{sub}: required")
-                elif not isinstance(data[key][sub], sub_type):
-                    errors.append(f"{key}.{sub}: expected {sub_type.__name__}")
-
-    provider = data.get("model", {}).get("provider")
-    if provider and provider not in ALLOWED_PROVIDERS:
-        errors.append(f"model.provider: unknown provider '{provider}'")
-
-    # Check JSON files
-    for jf in ["channel_directory.json"]:
-        jp = Path(path).parent / jf
-        if jp.exists():
-            try:
-                json.loads(jp.read_text())
-            except Exception as e:
-                errors.append(f"{jf}: invalid JSON: {e}")
-
-    return errors
-
-def main():
-    strict = "--strict" in sys.argv
-    args = [a for a in sys.argv[1:] if not a.startswith("--")]
-    path = args[0] if args else str(Path(__file__).parent.parent / "config.yaml")
-
-    if not os.path.exists(path):
-        print(f"ERROR: {path} not found")
-        sys.exit(1)
-
-    errs = validate(path)
-    if errs:
-        for e in errs:
-            print(f"ERROR: {e}")
-        print(f"Validation FAILED: {len(errs)} issue(s)")
-        sys.exit(1)
-    print(f"OK: {path} is valid")
-
-if __name__ == "__main__":
-    main()

cron/pipeline-scheduler.yml

@@ -1,9 +0,0 @@
-- name: Nightly Pipeline Scheduler
-  schedule: '*/30 18-23,0-8 * * *' # Every 30 min, off-peak hours only
-  tasks:
-    - name: Check and start pipelines
-      shell: "bash scripts/nightly-pipeline-scheduler.sh"
-      env:
-        PIPELINE_TOKEN_LIMIT: "500000"
-        PIPELINE_PEAK_START: "9"
-        PIPELINE_PEAK_END: "18"

scripts/captcha_bypass_handler.py

@@ -1,4 +1,3 @@
-#!/usr/bin/env python3
 import json
 from hermes_tools import browser_navigate, browser_vision
 

scripts/diagram_meaning_extractor.py

@@ -1,4 +1,3 @@
-#!/usr/bin/env python3
 import json
 from hermes_tools import browser_navigate, browser_vision
 

scripts/nightly-pipeline-scheduler.md

@@ -1,50 +0,0 @@
-# Nightly Pipeline Scheduler
-
-Auto-starts batch pipelines when inference is available.
-
-## What It Does
-
-1. Checks inference provider health (OpenRouter, Ollama, RunPod)
-2. Checks if it's off-peak hours (configurable, default: after 6PM)
-3. Checks interactive session load (don't fight with live users)
-4. Checks daily token budget (configurable limit)
-5. Starts the highest-priority incomplete pipeline
-
-## Pipeline Priority Order
-
-| Priority | Pipeline | Deps | Max Tokens |
-|----------|----------|------|------------|
-| 1 | playground-factory | none | 100,000 |
-| 2 | training-factory | none | 150,000 |
-| 3 | knowledge-mine | training-factory running | 80,000 |
-| 4 | adversary | knowledge-mine running | 50,000 |
-| 5 | codebase-genome | none | 120,000 |
-
-## Usage
-
-```bash
-# Normal run (used by cron)
-./scripts/nightly-pipeline-scheduler.sh
-
-# Dry run (show what would start)
-./scripts/nightly-pipeline-scheduler.sh --dry-run
-
-# Status report
-./scripts/nightly-pipeline-scheduler.sh --status
-
-# Force start during peak hours
-./scripts/nightly-pipeline-scheduler.sh --force
-```
-
-## Configuration
-
-Set via environment variables:
-- `PIPELINE_TOKEN_LIMIT`: Daily token budget (default: 500,000)
-- `PIPELINE_PEAK_START`: Peak hours start (default: 9)
-- `PIPELINE_PEAK_END`: Peak hours end (default: 18)
-- `HERMES_HOME`: Hermes home directory (default: ~/.hermes)
-
-## Cron
-
-Runs every 30 minutes. Off-peak only (unless --force).
-See `cron/pipeline-scheduler.yml`.

scripts/nightly-pipeline-scheduler.sh

@@ -1,383 +0,0 @@
-#!/usr/bin/env bash
-# nightly-pipeline-scheduler.sh — Auto-start batch pipelines when inference is available.
-#
-# Checks provider health, pipeline progress, token budget, and interactive load.
-# Starts the highest-priority incomplete pipeline that can run.
-#
-# Usage:
-#   ./scripts/nightly-pipeline-scheduler.sh          # Normal run
-#   ./scripts/nightly-pipeline-scheduler.sh --dry-run # Show what would start
-#   ./scripts/nightly-pipeline-scheduler.sh --status  # Pipeline status report
-
-set -euo pipefail
-
-# --- Configuration ---
-HERMES_HOME="${HERMES_HOME:-$HOME/.hermes}"
-BUDGET_FILE="${HERMES_HOME}/pipeline_budget.json"
-STATE_FILE="${HERMES_HOME}/pipeline_state.json"
-LOG_FILE="${HERMES_HOME}/logs/pipeline-scheduler.log"
-TOKEN_DAILY_LIMIT="${PIPELINE_TOKEN_LIMIT:-500000}"
-PEAK_HOURS_START="${PIPELINE_PEAK_START:-9}"
-PEAK_HOURS_END="${PIPELINE_PEAK_END:-18}"
-
-# Pipeline definitions (priority order)
-# Each pipeline: name, script, max_tokens, dependencies
-PIPELINES=(
-    "playground-factory|scripts/pipeline_playground_factory.sh|100000|none"
-    "training-factory|scripts/pipeline_training_factory.sh|150000|none"
-    "knowledge-mine|scripts/pipeline_knowledge_mine.sh|80000|training-factory"
-    "adversary|scripts/pipeline_adversary.sh|50000|knowledge-mine"
-    "codebase-genome|scripts/pipeline_codebase_genome.sh|120000|none"
-)
-
-# --- Colors ---
-RED='\033[0;31m'
-GREEN='\033[0;32m'
-YELLOW='\033[0;33m'
-CYAN='\033[0;36m'
-NC='\033[0m'
-
-# --- Helpers ---
-now_hour() { date +%-H; }
-is_peak_hours() {
-    local h=$(now_hour)
-    [[ $h -ge $PEAK_HOURS_START && $h -lt $PEAK_HOURS_END ]]
-}
-
-ensure_dirs() {
-    mkdir -p "$(dirname "$LOG_FILE")" "$(dirname "$BUDGET_FILE")" "$(dirname "$STATE_FILE")"
-}
-
-log() { echo "[$(date '+%Y-%m-%d %H:%M:%S')] $*" | tee -a "$LOG_FILE"; }
-
-get_budget_used_today() {
-    if [[ -f "$BUDGET_FILE" ]]; then
-        local today=$(date +%Y-%m-%d)
-        python3 -c "
-import json, sys
-with open('$BUDGET_FILE') as f:
-    d = json.load(f)
-print(d.get('daily', {}).get('$today', {}).get('tokens_used', 0))
-" 2>/dev/null || echo 0
-    else
-        echo 0
-    fi
-}
-
-get_budget_remaining() {
-    local used=$(get_budget_used_today)
-    echo $((TOKEN_DAILY_LIMIT - used))
-}
-
-update_budget() {
-    local pipeline="$1"
-    local tokens="$2"
-    local today=$(date +%Y-%m-%d)
-    python3 -c "
-import json, os
-path = '$BUDGET_FILE'
-d = {}
-if os.path.exists(path):
-    with open(path) as f:
-        d = json.load(f)
-daily = d.setdefault('daily', {})
-day = daily.setdefault('$today', {'tokens_used': 0, 'pipelines': {}})
-day['tokens_used'] = day.get('tokens_used', 0) + $tokens
-day['pipelines']['$pipeline'] = day['pipelines'].get('$pipeline', 0) + $tokens
-with open(path, 'w') as f:
-    json.dump(d, f, indent=2)
-"
-}
-
-get_pipeline_state() {
-    if [[ -f "$STATE_FILE" ]]; then
-        cat "$STATE_FILE"
-    else
-        echo "{}"
-    fi
-}
-
-set_pipeline_state() {
-    local pipeline="$1"
-    local state="$2"  # running, complete, failed, skipped
-    python3 -c "
-import json, os
-path = '$STATE_FILE'
-d = {}
-if os.path.exists(path):
-    with open(path) as f:
-        d = json.load(f)
-d['$pipeline'] = {'state': '$state', 'updated': '$(date -Iseconds)'}
-with open(path, 'w') as f:
-    json.dump(d, f, indent=2)
-"
-}
-
-is_pipeline_complete() {
-    local pipeline="$1"
-    python3 -c "
-import json, os
-path = '$STATE_FILE'
-if not os.path.exists(path):
-    print('false')
-else:
-    with open(path) as f:
-        d = json.load(f)
-    state = d.get('$pipeline', {}).get('state', 'not_started')
-    print('true' if state == 'complete' else 'false')
-" 2>/dev/null || echo false
-}
-
-is_pipeline_running() {
-    local pipeline="$1"
-    python3 -c "
-import json, os
-path = '$STATE_FILE'
-if not os.path.exists(path):
-    print('false')
-else:
-    with open(path) as f:
-        d = json.load(f)
-    state = d.get('$pipeline', {}).get('state', 'not_started')
-    print('true' if state == 'running' else 'false')
-" 2>/dev/null || echo false
-}
-
-check_dependency() {
-    local dep="$1"
-    if [[ "$dep" == "none" ]]; then
-        return 0
-    fi
-    # For knowledge-mine: training-factory must be running or complete
-    if [[ "$dep" == "training-factory" ]]; then
-        local state=$(python3 -c "
-import json, os
-path = '$STATE_FILE'
-if not os.path.exists(path):
-    print('not_started')
-else:
-    with open(path) as f:
-        d = json.load(f)
-    print(d.get('training-factory', {}).get('state', 'not_started'))
-" 2>/dev/null || echo "not_started")
-        [[ "$state" == "running" || "$state" == "complete" ]]
-        return $?
-    fi
-    # For adversary: knowledge-mine must be at least 50% done
-    # Simplified: check if it's running (we'd need progress tracking for 50%)
-    if [[ "$dep" == "knowledge-mine" ]]; then
-        local state=$(python3 -c "
-import json, os
-path = '$STATE_FILE'
-if not os.path.exists(path):
-    print('not_started')
-else:
-    with open(path) as f:
-        d = json.load(f)
-    print(d.get('knowledge-mine', {}).get('state', 'not_started'))
-" 2>/dev/null || echo "not_started")
-        [[ "$state" == "running" || "$state" == "complete" ]]
-        return $?
-    fi
-    return 0
-}
-
-check_inference_available() {
-    # Check if any inference provider is responding
-    # 1. Check OpenRouter
-    local or_ok=$(curl -s -o /dev/null -w "%{http_code}" \
-        --connect-timeout 5 "https://openrouter.ai/api/v1/models" 2>/dev/null || echo "000")
-
-    # 2. Check local Ollama
-    local ollama_ok=$(curl -s -o /dev/null -w "%{http_code}" \
-        --connect-timeout 5 "http://localhost:11434/api/tags" 2>/dev/null || echo "000")
-
-    # 3. Check RunPod (if configured)
-    local runpod_ok="000"
-    if [[ -n "${RUNPOD_ENDPOINT:-}" ]]; then
-        runpod_ok=$(curl -s -o /dev/null -w "%{http_code}" \
-            --connect-timeout 5 "$RUNPOD_ENDPOINT/health" 2>/dev/null || echo "000")
-    fi
-
-    if [[ "$or_ok" == "200" || "$ollama_ok" == "200" || "$runpod_ok" == "200" ]]; then
-        return 0
-    fi
-    return 1
-}
-
-check_interactive_load() {
-    # Check if there are active interactive sessions (don't fight with live users)
-    # Look for tmux panes with active hermes sessions
-    local active=$(tmux list-panes -a -F '#{pane_pid} #{pane_current_command}' 2>/dev/null \
-        | grep -c "hermes\|python3" || echo 0)
-
-    # If more than 3 interactive sessions, skip pipeline start
-    if [[ $active -gt 3 ]]; then
-        return 1
-    fi
-    return 0
-}
-
-start_pipeline() {
-    local name="$1"
-    local script="$2"
-    local max_tokens="$3"
-    local budget_remaining="$4"
-    local mode="${5:-run}"
-
-    if [[ "$budget_remaining" -lt "$max_tokens" ]]; then
-        log "SKIP $name: insufficient budget ($budget_remaining < $max_tokens tokens)"
-        return 1
-    fi
-
-    if [[ ! -f "$script" ]]; then
-        log "SKIP $name: script not found ($script)"
-        return 1
-    fi
-
-    if [[ "$mode" == "dry-run" ]]; then
-        log "DRY-RUN: Would start $name (budget: $budget_remaining, needs: $max_tokens)"
-        return 0
-    fi
-
-    log "START $name (budget: $budget_remaining, max_tokens: $max_tokens)"
-    set_pipeline_state "$name" "running"
-
-    # Run in background, capture output
-    local log_path="${HERMES_HOME}/logs/pipeline-${name}.log"
-    bash "$script" --max-tokens "$max_tokens" >> "$log_path" 2>&1 &
-    local pid=$!
-
-    # Wait a moment to check if it started OK
-    sleep 2
-    if kill -0 $pid 2>/dev/null; then
-        log "RUNNING $name (PID: $pid, log: $log_path)"
-        # Record the PID
-        python3 -c "
-import json, os
-path = '$STATE_FILE'
-d = {}
-if os.path.exists(path):
-    with open(path) as f:
-        d = json.load(f)
-d['$name']['pid'] = $pid
-with open(path, 'w') as f:
-    json.dump(d, f, indent=2)
-"
-        return 0
-    else
-        log "FAIL $name: script exited immediately"
-        set_pipeline_state "$name" "failed"
-        return 1
-    fi
-}
-
-# --- Main ---
-main() {
-    local mode="${1:-run}"
-    ensure_dirs
-
-    log "=== Pipeline Scheduler ($mode) ==="
-
-    # Check 1: Is inference available?
-    if ! check_inference_available; then
-        log "No inference provider available. Skipping all pipelines."
-        exit 0
-    fi
-    log "Inference: AVAILABLE"
-
-    # Check 2: Is it peak hours?
-    if is_peak_hours && [[ "$mode" != "--force" ]]; then
-        local h=$(now_hour)
-        log "Peak hours ($h:00). Skipping pipeline start. Use --force to override."
-        exit 0
-    fi
-    log "Off-peak: OK"
-
-    # Check 3: Interactive load
-    if ! check_interactive_load && [[ "$mode" != "--force" ]]; then
-        log "High interactive load. Skipping pipeline start."
-        exit 0
-    fi
-    log "Interactive load: OK"
-
-    # Check 4: Token budget
-    local budget=$(get_budget_remaining)
-    log "Token budget remaining: $budget / $TOKEN_DAILY_LIMIT"
-
-    if [[ $budget -le 0 ]]; then
-        log "Daily token budget exhausted. Stopping."
-        exit 0
-    fi
-
-    # Check 5: Pipeline status
-    if [[ "$mode" == "--status" ]]; then
-        echo -e "${CYAN}Pipeline Status:${NC}"
-        echo "────────────────────────────────────────────────────"
-        for entry in "${PIPELINES[@]}"; do
-            IFS='|' read -r name script max_tokens dep <<< "$entry"
-            local state=$(python3 -c "
-import json, os
-path = '$STATE_FILE'
-if not os.path.exists(path):
-    print('not_started')
-else:
-    with open(path) as f:
-        d = json.load(f)
-    print(d.get('$name', {}).get('state', 'not_started'))
-" 2>/dev/null || echo "not_started")
-
-            local color=$NC
-            case "$state" in
-                running)  color=$YELLOW ;;
-                complete) color=$GREEN ;;
-                failed)   color=$RED ;;
-            esac
-            printf "  %-25s %b%s%b (max: %s tokens, dep: %s)\n" "$name" "$color" "$state" "$NC" "$max_tokens" "$dep"
-        done
-        echo "────────────────────────────────────────────────────"
-        echo "  Budget: $budget / $TOKEN_DAILY_LIMIT tokens remaining"
-        echo "  Peak hours: $PEAK_HOURS_START:00 - $PEAK_HOURS_END:00"
-        exit 0
-    fi
-
-    # Find and start the highest-priority incomplete pipeline
-    local started=0
-    for entry in "${PIPELINES[@]}"; do
-        IFS='|' read -r name script max_tokens dep <<< "$entry"
-
-        # Skip if already running or complete
-        if [[ "$(is_pipeline_running $name)" == "true" ]]; then
-            log "SKIP $name: already running"
-            continue
-        fi
-        if [[ "$(is_pipeline_complete $name)" == "true" ]]; then
-            log "SKIP $name: already complete"
-            continue
-        fi
-
-        # Check dependency
-        if ! check_dependency "$dep"; then
-            log "SKIP $name: dependency $dep not met"
-            continue
-        fi
-
-        # Try to start
-        if start_pipeline "$name" "$script" "$max_tokens" "$budget" "$mode"; then
-            started=1
-            # Only start one pipeline per run (let it claim tokens before next check)
-            # Exception: playground-factory and training-factory can run in parallel
-            if [[ "$name" != "playground-factory" && "$name" != "training-factory" ]]; then
-                break
-            fi
-        fi
-    done
-
-    if [[ $started -eq 0 ]]; then
-        log "No pipelines to start (all complete, running, or blocked)."
-    fi
-
-    log "=== Pipeline Scheduler done ==="
-}
-
-main "$@"

scripts/validate-sidecar-config.py

@@ -1,207 +0,0 @@
-#!/usr/bin/env python3
-"""
-validate-sidecar-config.py — Pre-deploy validation for timmy-config sidecar.
-
-Validates YAML syntax, required keys, value types before deploy.
-Rejects bad config with clear errors.
-
-Usage:
-    python3 scripts/validate-sidecar-config.py ~/.timmy/config.yaml
-    python3 scripts/validate-sidecar-config.py --all                  # Validate all config files
-    python3 scripts/validate-sidecar-config.py --schema               # Print expected schema
-"""
-
-import argparse
-import json
-import os
-import sys
-from pathlib import Path
-
-try:
-    import yaml
-    HAS_YAML = True
-except ImportError:
-    HAS_YAML = False
-
-# Expected schema: field -> type
-REQUIRED_SCHEMA = {
-    "model": str,
-    "provider": str,
-}
-
-OPTIONAL_SCHEMA = {
-    "api_base": str,
-    "max_tokens": int,
-    "temperature": (int, float),
-    "system_prompt": str,
-    "tools": list,
-    "memory_enabled": bool,
-    "session_timeout": int,
-    "log_level": str,
-}
-
-CONFIG_DIRS = [
-    Path.home() / ".timmy",
-    Path.home() / ".hermes",
-]
-
-
-def validate_yaml_syntax(filepath: Path) -> list[str]:
-    """Validate YAML can be parsed."""
-    errors = []
-    try:
-        content = filepath.read_text(errors="ignore")
-        if HAS_YAML:
-            yaml.safe_load(content)
-        else:
-            # Fallback: check for basic JSON-in-YAML
-            json.loads(content)
-    except (yaml.YAMLError if HAS_YAML else Exception, json.JSONDecodeError) as e:
-        errors.append(f"YAML syntax error: {e}")
-    except OSError as e:
-        errors.append(f"Cannot read file: {e}")
-    return errors
-
-
-def validate_schema(filepath: Path) -> list[str]:
-    """Validate config against expected schema."""
-    errors = []
-    try:
-        content = filepath.read_text(errors="ignore")
-        if HAS_YAML:
-            config = yaml.safe_load(content) or {}
-        else:
-            config = json.loads(content)
-    except Exception as e:
-        return [f"Cannot parse: {e}"]
-
-    if not isinstance(config, dict):
-        return ["Config must be a YAML/JSON object (dict)"]
-
-    # Check required keys
-    for key, expected_type in REQUIRED_SCHEMA.items():
-        if key not in config:
-            errors.append(f"Missing required key: '{key}' (expected {expected_type.__name__})")
-        elif not isinstance(config[key], expected_type):
-            errors.append(f"Wrong type for '{key}': expected {expected_type.__name__}, got {type(config[key]).__name__}")
-
-    # Check optional keys types
-    for key, expected_type in OPTIONAL_SCHEMA.items():
-        if key in config:
-            if isinstance(expected_type, tuple):
-                if not isinstance(config[key], expected_type):
-                    type_names = " or ".join(t.__name__ for t in expected_type)
-                    errors.append(f"Wrong type for '{key}': expected {type_names}, got {type(config[key]).__name__}")
-            else:
-                if not isinstance(config[key], expected_type):
-                    errors.append(f"Wrong type for '{key}': expected {expected_type.__name__}, got {type(config[key]).__name__}")
-
-    # Check for common mistakes
-    if "model" in config and isinstance(config["model"], str):
-        if config["model"].startswith("http"):
-            errors.append("'model' looks like a URL — did you mean 'api_base'?")
-
-    if "api_base" in config and isinstance(config["api_base"], str):
-        if not config["api_base"].startswith("http"):
-            errors.append("'api_base' should start with http:// or https://")
-
-    return errors
-
-
-def validate_file(filepath: Path) -> tuple[bool, list[str]]:
-    """Full validation of a config file. Returns (valid, errors)."""
-    errors = []
-    errors.extend(validate_yaml_syntax(filepath))
-    if not errors:
-        errors.extend(validate_schema(filepath))
-    return len(errors) == 0, errors
-
-
-def find_config_files() -> list[Path]:
-    """Find config files in standard locations."""
-    configs = []
-    for d in CONFIG_DIRS:
-        if not d.exists():
-            continue
-        for f in d.rglob("*.yaml"):
-            if f.name in ("config.yaml", "settings.yaml", "env.yaml", "config.yml"):
-                configs.append(f)
-        for f in d.rglob("*.yml"):
-            if "config" in f.name.lower():
-                configs.append(f)
-        for f in d.rglob("*.json"):
-            if f.name in ("config.json", "settings.json"):
-                configs.append(f)
-    return sorted(set(configs))
-
-
-def cmd_validate(filepath: str) -> bool:
-    path = Path(filepath)
-    if not path.exists():
-        print(f"ERROR: {path} not found")
-        return False
-
-    valid, errors = validate_file(path)
-    if valid:
-        print(f"OK: {path}")
-    else:
-        print(f"FAIL: {path}")
-        for e in errors:
-            print(f"  - {e}")
-    return valid
-
-
-def cmd_validate_all() -> bool:
-    configs = find_config_files()
-    if not configs:
-        print("No config files found in standard locations.")
-        return True
-
-    all_valid = True
-    for config in configs:
-        valid, errors = validate_file(config)
-        if valid:
-            print(f"OK: {config}")
-        else:
-            all_valid = False
-            print(f"FAIL: {config}")
-            for e in errors:
-                print(f"  - {e}")
-
-    print(f"\n{'All configs valid.' if all_valid else 'Validation failures found.'}")
-    return all_valid
-
-
-def cmd_schema():
-    print("Required keys:")
-    for key, typ in REQUIRED_SCHEMA.items():
-        print(f"  {key}: {typ.__name__}")
-    print("\nOptional keys:")
-    for key, typ in OPTIONAL_SCHEMA.items():
-        if isinstance(typ, tuple):
-            print(f"  {key}: {'|'.join(t.__name__ for t in typ)}")
-        else:
-            print(f"  {key}: {typ.__name__}")
-
-
-def main():
-    parser = argparse.ArgumentParser(description="Validate sidecar config files")
-    parser.add_argument("file", nargs="?", help="Config file to validate")
-    parser.add_argument("--all", action="store_true", help="Validate all config files")
-    parser.add_argument("--schema", action="store_true", help="Print expected schema")
-    args = parser.parse_args()
-
-    if args.schema:
-        cmd_schema()
-    elif args.all:
-        ok = cmd_validate_all()
-        sys.exit(0 if ok else 1)
-    elif args.file:
-        ok = cmd_validate(args.file)
-        sys.exit(0 if ok else 1)
-    else:
-        parser.print_help()
-
-
-if __name__ == "__main__":
-    main()

scripts/visual_pr_reviewer.py

@@ -1,4 +1,3 @@
-#!/usr/bin/env python3
 import json
 from hermes_tools import browser_navigate, browser_vision
 

training-data/scene-descriptions-folk.jsonl

@@ -0,0 +1,100 @@
+{"song": "The Weight of Iron", "beat": 1, "lyric_line": "The iron gate swings slow tonight", "scene": {"mood": "despair", "colors": ["olive", "cream", "rust"], "composition": "close-up", "camera": "slow pan", "description": "A despair scene illustrating 'The iron gate swings slow tonight'. close up framing with olive, cream, rust palette. Camera: slow pan."}}
+{"song": "The Weight of Iron", "beat": 2, "lyric_line": "Wind carries names I can't forget", "scene": {"mood": "longing", "colors": ["deep red", "brown", "amber"], "composition": "wide shot", "camera": "steady", "description": "A longing scene illustrating 'Wind carries names I can't forget'. wide shot framing with deep red, brown, amber palette. Camera: steady."}}
+{"song": "The Weight of Iron", "beat": 3, "lyric_line": "Stone walls hold the cold inside", "scene": {"mood": "grief", "colors": ["olive", "cream", "rust"], "composition": "medium shot", "camera": "handheld", "description": "A grief scene illustrating 'Stone walls hold the cold inside'. medium shot framing with olive, cream, rust palette. Camera: handheld."}}
+{"song": "The Weight of Iron", "beat": 4, "lyric_line": "Every step leaves prints in dust", "scene": {"mood": "resignation", "colors": ["dusty blue", "tan", "grey"], "composition": "low angle", "camera": "slow zoom", "description": "A resignation scene illustrating 'Every step leaves prints in dust'. low angle framing with dusty blue, tan, grey palette. Camera: slow zoom."}}
+{"song": "The Weight of Iron", "beat": 5, "lyric_line": "The river hums an older song", "scene": {"mood": "ache", "colors": ["yellow", "warm brown", "green"], "composition": "high angle", "camera": "tracking", "description": "A ache scene illustrating 'The river hums an older song'. high angle framing with yellow, warm brown, green palette. Camera: tracking."}}
+{"song": "The Weight of Iron", "beat": 6, "lyric_line": "Shadows lean against the door", "scene": {"mood": "despair", "colors": ["dusty blue", "tan", "grey"], "composition": "over-the-shoulder", "camera": "static", "description": "A despair scene illustrating 'Shadows lean against the door'. over the shoulder framing with dusty blue, tan, grey palette. Camera: static."}}
+{"song": "The Weight of Iron", "beat": 7, "lyric_line": "I count the stars I cannot reach", "scene": {"mood": "longing", "colors": ["white", "grey", "pale blue"], "composition": "profile", "camera": "crane up", "description": "A longing scene illustrating 'I count the stars I cannot reach'. profile framing with white, grey, pale blue palette. Camera: crane up."}}
+{"song": "The Weight of Iron", "beat": 8, "lyric_line": "The fire dies but warmth remains", "scene": {"mood": "grief", "colors": ["amber", "brown", "cream"], "composition": "bird's eye", "camera": "dolly in", "description": "A grief scene illustrating 'The fire dies but warmth remains'. bird's eye framing with amber, brown, cream palette. Camera: dolly in."}}
+{"song": "The Weight of Iron", "beat": 9, "lyric_line": "Tomorrow bends but doesn't break", "scene": {"mood": "resignation", "colors": ["black", "red", "gold"], "composition": "dutch angle", "camera": "gentle drift", "description": "A resignation scene illustrating 'Tomorrow bends but doesn't break'. dutch angle framing with black, red, gold palette. Camera: gentle drift."}}
+{"song": "The Weight of Iron", "beat": 10, "lyric_line": "I walk the road that chose me first", "scene": {"mood": "ache", "colors": ["grey", "white", "blue"], "composition": "establishing shot", "camera": "locked-off", "description": "A ache scene illustrating 'I walk the road that chose me first'. establishing shot framing with grey, white, blue palette. Camera: locked-off."}}
+{"song": "Harvest Moon", "beat": 1, "lyric_line": "Golden fields stretch past the town", "scene": {"mood": "warmth", "colors": ["amber", "brown", "cream"], "composition": "close-up", "camera": "slow pan", "description": "A warmth scene illustrating 'Golden fields stretch past the town'. close up framing with amber, brown, cream palette. Camera: slow pan."}}
+{"song": "Harvest Moon", "beat": 2, "lyric_line": "Papa's hands knew every seed", "scene": {"mood": "memory", "colors": ["amber", "brown", "cream"], "composition": "wide shot", "camera": "steady", "description": "A memory scene illustrating 'Papa's hands knew every seed'. wide shot framing with amber, brown, cream palette. Camera: steady."}}
+{"song": "Harvest Moon", "beat": 3, "lyric_line": "The barn door creaks its lullaby", "scene": {"mood": "bittersweet", "colors": ["black", "red", "gold"], "composition": "medium shot", "camera": "handheld", "description": "A bittersweet scene illustrating 'The barn door creaks its lullaby'. medium shot framing with black, red, gold palette. Camera: handheld."}}
+{"song": "Harvest Moon", "beat": 4, "lyric_line": "Crickets count the hours down", "scene": {"mood": "tender", "colors": ["navy", "silver", "white"], "composition": "low angle", "camera": "slow zoom", "description": "A tender scene illustrating 'Crickets count the hours down'. low angle framing with navy, silver, white palette. Camera: slow zoom."}}
+{"song": "Harvest Moon", "beat": 5, "lyric_line": "Mama's bread still fills the air", "scene": {"mood": "fading", "colors": ["warm yellow", "brown", "red"], "composition": "high angle", "camera": "tracking", "description": "A fading scene illustrating 'Mama's bread still fills the air'. high angle framing with warm yellow, brown, red palette. Camera: tracking."}}
+{"song": "Harvest Moon", "beat": 6, "lyric_line": "We ran barefoot through the rain", "scene": {"mood": "warmth", "colors": ["navy", "silver", "white"], "composition": "over-the-shoulder", "camera": "static", "description": "A warmth scene illustrating 'We ran barefoot through the rain'. over the shoulder framing with navy, silver, white palette. Camera: static."}}
+{"song": "Harvest Moon", "beat": 7, "lyric_line": "The old oak holds our carved-in names", "scene": {"mood": "memory", "colors": ["warm yellow", "brown", "red"], "composition": "profile", "camera": "crane up", "description": "A memory scene illustrating 'The old oak holds our carved-in names'. profile framing with warm yellow, brown, red palette. Camera: crane up."}}
+{"song": "Harvest Moon", "beat": 8, "lyric_line": "Sunset paints the pond to gold", "scene": {"mood": "bittersweet", "colors": ["dusty blue", "tan", "grey"], "composition": "bird's eye", "camera": "dolly in", "description": "A bittersweet scene illustrating 'Sunset paints the pond to gold'. bird's eye framing with dusty blue, tan, grey palette. Camera: dolly in."}}
+{"song": "Harvest Moon", "beat": 9, "lyric_line": "We didn't know we were happy then", "scene": {"mood": "tender", "colors": ["dusty blue", "tan", "grey"], "composition": "dutch angle", "camera": "gentle drift", "description": "A tender scene illustrating 'We didn't know we were happy then'. dutch angle framing with dusty blue, tan, grey palette. Camera: gentle drift."}}
+{"song": "Harvest Moon", "beat": 10, "lyric_line": "The harvest moon remembers us", "scene": {"mood": "fading", "colors": ["yellow", "warm brown", "green"], "composition": "establishing shot", "camera": "locked-off", "description": "A fading scene illustrating 'The harvest moon remembers us'. establishing shot framing with yellow, warm brown, green palette. Camera: locked-off."}}
+{"song": "River's Edge", "beat": 1, "lyric_line": "Morning mist on still water", "scene": {"mood": "calm", "colors": ["amber", "brown", "cream"], "composition": "close-up", "camera": "slow pan", "description": "A calm scene illustrating 'Morning mist on still water'. close up framing with amber, brown, cream palette. Camera: slow pan."}}
+{"song": "River's Edge", "beat": 2, "lyric_line": "A heron stands and waits", "scene": {"mood": "serenity", "colors": ["deep red", "brown", "amber"], "composition": "wide shot", "camera": "steady", "description": "A serenity scene illustrating 'A heron stands and waits'. wide shot framing with deep red, brown, amber palette. Camera: steady."}}
+{"song": "River's Edge", "beat": 3, "lyric_line": "The current writes in cursive", "scene": {"mood": "stillness", "colors": ["warm yellow", "brown", "red"], "composition": "medium shot", "camera": "handheld", "description": "A stillness scene illustrating 'The current writes in cursive'. medium shot framing with warm yellow, brown, red palette. Camera: handheld."}}
+{"song": "River's Edge", "beat": 4, "lyric_line": "Smooth stones warm in afternoon", "scene": {"mood": "contentment", "colors": ["yellow", "warm brown", "green"], "composition": "low angle", "camera": "slow zoom", "description": "A contentment scene illustrating 'Smooth stones warm in afternoon'. low angle framing with yellow, warm brown, green palette. Camera: slow zoom."}}
+{"song": "River's Edge", "beat": 5, "lyric_line": "Fish rise in silver arcs", "scene": {"mood": "gentle", "colors": ["deep red", "brown", "amber"], "composition": "high angle", "camera": "tracking", "description": "A gentle scene illustrating 'Fish rise in silver arcs'. high angle framing with deep red, brown, amber palette. Camera: tracking."}}
+{"song": "River's Edge", "beat": 6, "lyric_line": "Willows dip their fingers in", "scene": {"mood": "calm", "colors": ["green", "gold", "brown"], "composition": "over-the-shoulder", "camera": "static", "description": "A calm scene illustrating 'Willows dip their fingers in'. over the shoulder framing with green, gold, brown palette. Camera: static."}}
+{"song": "River's Edge", "beat": 7, "lyric_line": "Time moves slow where rivers meet", "scene": {"mood": "serenity", "colors": ["olive", "cream", "rust"], "composition": "profile", "camera": "crane up", "description": "A serenity scene illustrating 'Time moves slow where rivers meet'. profile framing with olive, cream, rust palette. Camera: crane up."}}
+{"song": "River's Edge", "beat": 8, "lyric_line": "The bridge holds quiet conversations", "scene": {"mood": "stillness", "colors": ["grey", "white", "blue"], "composition": "bird's eye", "camera": "dolly in", "description": "A stillness scene illustrating 'The bridge holds quiet conversations'. bird's eye framing with grey, white, blue palette. Camera: dolly in."}}
+{"song": "River's Edge", "beat": 9, "lyric_line": "Evening brings the frogs to song", "scene": {"mood": "contentment", "colors": ["navy", "silver", "white"], "composition": "dutch angle", "camera": "gentle drift", "description": "A contentment scene illustrating 'Evening brings the frogs to song'. dutch angle framing with navy, silver, white palette. Camera: gentle drift."}}
+{"song": "River's Edge", "beat": 10, "lyric_line": "The river knows where it's going", "scene": {"mood": "gentle", "colors": ["amber", "brown", "cream"], "composition": "establishing shot", "camera": "locked-off", "description": "A gentle scene illustrating 'The river knows where it's going'. establishing shot framing with amber, brown, cream palette. Camera: locked-off."}}
+{"song": "Broken Lighthouse", "beat": 1, "lyric_line": "The light went out in ninety-three", "scene": {"mood": "abandonment", "colors": ["black", "red", "gold"], "composition": "close-up", "camera": "slow pan", "description": "A abandonment scene illustrating 'The light went out in ninety-three'. close up framing with black, red, gold palette. Camera: slow pan."}}
+{"song": "Broken Lighthouse", "beat": 2, "lyric_line": "Salt has eaten through the door", "scene": {"mood": "ruin", "colors": ["grey", "white", "blue"], "composition": "wide shot", "camera": "steady", "description": "A ruin scene illustrating 'Salt has eaten through the door'. wide shot framing with grey, white, blue palette. Camera: steady."}}
+{"song": "Broken Lighthouse", "beat": 3, "lyric_line": "Gulls nest where the keeper slept", "scene": {"mood": "loneliness", "colors": ["black", "red", "gold"], "composition": "medium shot", "camera": "handheld", "description": "A loneliness scene illustrating 'Gulls nest where the keeper slept'. medium shot framing with black, red, gold palette. Camera: handheld."}}
+{"song": "Broken Lighthouse", "beat": 4, "lyric_line": "Fog rolls in like unanswered prayers", "scene": {"mood": "decay", "colors": ["dusty blue", "tan", "grey"], "composition": "low angle", "camera": "slow zoom", "description": "A decay scene illustrating 'Fog rolls in like unanswered prayers'. low angle framing with dusty blue, tan, grey palette. Camera: slow zoom."}}
+{"song": "Broken Lighthouse", "beat": 5, "lyric_line": "The spiral stair groans under ghosts", "scene": {"mood": "emptiness", "colors": ["olive", "cream", "rust"], "composition": "high angle", "camera": "tracking", "description": "A emptiness scene illustrating 'The spiral stair groans under ghosts'. high angle framing with olive, cream, rust palette. Camera: tracking."}}
+{"song": "Broken Lighthouse", "beat": 6, "lyric_line": "Paint peels in long surrender", "scene": {"mood": "abandonment", "colors": ["dusty blue", "tan", "grey"], "composition": "over-the-shoulder", "camera": "static", "description": "A abandonment scene illustrating 'Paint peels in long surrender'. over the shoulder framing with dusty blue, tan, grey palette. Camera: static."}}
+{"song": "Broken Lighthouse", "beat": 7, "lyric_line": "Ships pass blind in heavy weather", "scene": {"mood": "ruin", "colors": ["black", "red", "gold"], "composition": "profile", "camera": "crane up", "description": "A ruin scene illustrating 'Ships pass blind in heavy weather'. profile framing with black, red, gold palette. Camera: crane up."}}
+{"song": "Broken Lighthouse", "beat": 8, "lyric_line": "The lantern room holds only rain", "scene": {"mood": "loneliness", "colors": ["navy", "silver", "white"], "composition": "bird's eye", "camera": "dolly in", "description": "A loneliness scene illustrating 'The lantern room holds only rain'. bird's eye framing with navy, silver, white palette. Camera: dolly in."}}
+{"song": "Broken Lighthouse", "beat": 9, "lyric_line": "We were warned but didn't listen", "scene": {"mood": "decay", "colors": ["amber", "brown", "cream"], "composition": "dutch angle", "camera": "gentle drift", "description": "A decay scene illustrating 'We were warned but didn't listen'. dutch angle framing with amber, brown, cream palette. Camera: gentle drift."}}
+{"song": "Broken Lighthouse", "beat": 10, "lyric_line": "Some towers fall so others see", "scene": {"mood": "emptiness", "colors": ["black", "red", "gold"], "composition": "establishing shot", "camera": "locked-off", "description": "A emptiness scene illustrating 'Some towers fall so others see'. establishing shot framing with black, red, gold palette. Camera: locked-off."}}
+{"song": "Grandmother's Kitchen", "beat": 1, "lyric_line": "Flour dust on everything", "scene": {"mood": "comfort", "colors": ["olive", "cream", "rust"], "composition": "close-up", "camera": "slow pan", "description": "A comfort scene illustrating 'Flour dust on everything'. close up framing with olive, cream, rust palette. Camera: slow pan."}}
+{"song": "Grandmother's Kitchen", "beat": 2, "lyric_line": "The radio plays what it remembers", "scene": {"mood": "love", "colors": ["green", "gold", "brown"], "composition": "wide shot", "camera": "steady", "description": "A love scene illustrating 'The radio plays what it remembers'. wide shot framing with green, gold, brown palette. Camera: steady."}}
+{"song": "Grandmother's Kitchen", "beat": 3, "lyric_line": "Cinnamon holds the house together", "scene": {"mood": "safety", "colors": ["grey", "white", "blue"], "composition": "medium shot", "camera": "handheld", "description": "A safety scene illustrating 'Cinnamon holds the house together'. medium shot framing with grey, white, blue palette. Camera: handheld."}}
+{"song": "Grandmother's Kitchen", "beat": 4, "lyric_line": "She hums without knowing she hums", "scene": {"mood": "belonging", "colors": ["navy", "silver", "white"], "composition": "low angle", "camera": "slow zoom", "description": "A belonging scene illustrating 'She hums without knowing she hums'. low angle framing with navy, silver, white palette. Camera: slow zoom."}}
+{"song": "Grandmother's Kitchen", "beat": 5, "lyric_line": "The table fits us all somehow", "scene": {"mood": "joy", "colors": ["warm yellow", "brown", "red"], "composition": "high angle", "camera": "tracking", "description": "A joy scene illustrating 'The table fits us all somehow'. high angle framing with warm yellow, brown, red palette. Camera: tracking."}}
+{"song": "Grandmother's Kitchen", "beat": 6, "lyric_line": "Stories rise like bread dough", "scene": {"mood": "comfort", "colors": ["yellow", "warm brown", "green"], "composition": "over-the-shoulder", "camera": "static", "description": "A comfort scene illustrating 'Stories rise like bread dough'. over the shoulder framing with yellow, warm brown, green palette. Camera: static."}}
+{"song": "Grandmother's Kitchen", "beat": 7, "lyric_line": "Windows fog from living heat", "scene": {"mood": "love", "colors": ["green", "gold", "brown"], "composition": "profile", "camera": "crane up", "description": "A love scene illustrating 'Windows fog from living heat'. profile framing with green, gold, brown palette. Camera: crane up."}}
+{"song": "Grandmother's Kitchen", "beat": 8, "lyric_line": "The clock is always ten minutes late", "scene": {"mood": "safety", "colors": ["grey", "white", "blue"], "composition": "bird's eye", "camera": "dolly in", "description": "A safety scene illustrating 'The clock is always ten minutes late'. bird's eye framing with grey, white, blue palette. Camera: dolly in."}}
+{"song": "Grandmother's Kitchen", "beat": 9, "lyric_line": "We leave with full hearts and Tupperware", "scene": {"mood": "belonging", "colors": ["amber", "dust", "gold"], "composition": "dutch angle", "camera": "gentle drift", "description": "A belonging scene illustrating 'We leave with full hearts and Tupperware'. dutch angle framing with amber, dust, gold palette. Camera: gentle drift."}}
+{"song": "Grandmother's Kitchen", "beat": 10, "lyric_line": "Some recipes are just love", "scene": {"mood": "joy", "colors": ["navy", "silver", "white"], "composition": "establishing shot", "camera": "locked-off", "description": "A joy scene illustrating 'Some recipes are just love'. establishing shot framing with navy, silver, white palette. Camera: locked-off."}}
+{"song": "The Wanderer", "beat": 1, "lyric_line": "My boots know roads my name doesn't", "scene": {"mood": "wandering", "colors": ["black", "red", "gold"], "composition": "close-up", "camera": "slow pan", "description": "A wandering scene illustrating 'My boots know roads my name doesn't'. close up framing with black, red, gold palette. Camera: slow pan."}}
+{"song": "The Wanderer", "beat": 2, "lyric_line": "The horizon is a promise I chase", "scene": {"mood": "yearning", "colors": ["green", "gold", "brown"], "composition": "wide shot", "camera": "steady", "description": "A yearning scene illustrating 'The horizon is a promise I chase'. wide shot framing with green, gold, brown palette. Camera: steady."}}
+{"song": "The Wanderer", "beat": 3, "lyric_line": "Every town looks like a question", "scene": {"mood": "freedom", "colors": ["amber", "dust", "gold"], "composition": "medium shot", "camera": "handheld", "description": "A freedom scene illustrating 'Every town looks like a question'. medium shot framing with amber, dust, gold palette. Camera: handheld."}}
+{"song": "The Wanderer", "beat": 4, "lyric_line": "I've slept in stranger's kindness", "scene": {"mood": "isolation", "colors": ["warm yellow", "brown", "red"], "composition": "low angle", "camera": "slow zoom", "description": "A isolation scene illustrating 'I've slept in stranger's kindness'. low angle framing with warm yellow, brown, red palette. Camera: slow zoom."}}
+{"song": "The Wanderer", "beat": 5, "lyric_line": "The train whistle sounds like leaving", "scene": {"mood": "searching", "colors": ["yellow", "warm brown", "green"], "composition": "high angle", "camera": "tracking", "description": "A searching scene illustrating 'The train whistle sounds like leaving'. high angle framing with yellow, warm brown, green palette. Camera: tracking."}}
+{"song": "The Wanderer", "beat": 6, "lyric_line": "My shadow is my longest friend", "scene": {"mood": "wandering", "colors": ["olive", "cream", "rust"], "composition": "over-the-shoulder", "camera": "static", "description": "A wandering scene illustrating 'My shadow is my longest friend'. over the shoulder framing with olive, cream, rust palette. Camera: static."}}
+{"song": "The Wanderer", "beat": 7, "lyric_line": "Stars don't care where I'm from", "scene": {"mood": "yearning", "colors": ["dusty blue", "tan", "grey"], "composition": "profile", "camera": "crane up", "description": "A yearning scene illustrating 'Stars don't care where I'm from'. profile framing with dusty blue, tan, grey palette. Camera: crane up."}}
+{"song": "The Wanderer", "beat": 8, "lyric_line": "The wind has no return address", "scene": {"mood": "freedom", "colors": ["white", "grey", "pale blue"], "composition": "bird's eye", "camera": "dolly in", "description": "A freedom scene illustrating 'The wind has no return address'. bird's eye framing with white, grey, pale blue palette. Camera: dolly in."}}
+{"song": "The Wanderer", "beat": 9, "lyric_line": "I've forgotten what home feels like", "scene": {"mood": "isolation", "colors": ["yellow", "warm brown", "green"], "composition": "dutch angle", "camera": "gentle drift", "description": "A isolation scene illustrating 'I've forgotten what home feels like'. dutch angle framing with yellow, warm brown, green palette. Camera: gentle drift."}}
+{"song": "The Wanderer", "beat": 10, "lyric_line": "Maybe home is the walking", "scene": {"mood": "searching", "colors": ["black", "red", "gold"], "composition": "establishing shot", "camera": "locked-off", "description": "A searching scene illustrating 'Maybe home is the walking'. establishing shot framing with black, red, gold palette. Camera: locked-off."}}
+{"song": "Coal Country", "beat": 1, "lyric_line": "Black dust under every nail", "scene": {"mood": "anger", "colors": ["yellow", "warm brown", "green"], "composition": "close-up", "camera": "slow pan", "description": "A anger scene illustrating 'Black dust under every nail'. close up framing with yellow, warm brown, green palette. Camera: slow pan."}}
+{"song": "Coal Country", "beat": 2, "lyric_line": "The mountain gave and gave and gave", "scene": {"mood": "pride", "colors": ["amber", "dust", "gold"], "composition": "wide shot", "camera": "steady", "description": "A pride scene illustrating 'The mountain gave and gave and gave'. wide shot framing with amber, dust, gold palette. Camera: steady."}}
+{"song": "Coal Country", "beat": 3, "lyric_line": "We lit the dark with what we carried", "scene": {"mood": "resistance", "colors": ["yellow", "warm brown", "green"], "composition": "medium shot", "camera": "handheld", "description": "A resistance scene illustrating 'We lit the dark with what we carried'. medium shot framing with yellow, warm brown, green palette. Camera: handheld."}}
+{"song": "Coal Country", "beat": 4, "lyric_line": "Company store took what we earned", "scene": {"mood": "strength", "colors": ["green", "gold", "brown"], "composition": "low angle", "camera": "slow zoom", "description": "A strength scene illustrating 'Company store took what we earned'. low angle framing with green, gold, brown palette. Camera: slow zoom."}}
+{"song": "Coal Country", "beat": 5, "lyric_line": "The whistle blew before the sun", "scene": {"mood": "solidarity", "colors": ["amber", "dust", "gold"], "composition": "high angle", "camera": "tracking", "description": "A solidarity scene illustrating 'The whistle blew before the sun'. high angle framing with amber, dust, gold palette. Camera: tracking."}}
+{"song": "Coal Country", "beat": 6, "lyric_line": "Granddaddy's lungs knew better", "scene": {"mood": "anger", "colors": ["olive", "cream", "rust"], "composition": "over-the-shoulder", "camera": "static", "description": "A anger scene illustrating 'Granddaddy's lungs knew better'. over the shoulder framing with olive, cream, rust palette. Camera: static."}}
+{"song": "Coal Country", "beat": 7, "lyric_line": "We sang loud so God could hear", "scene": {"mood": "pride", "colors": ["amber", "brown", "cream"], "composition": "profile", "camera": "crane up", "description": "A pride scene illustrating 'We sang loud so God could hear'. profile framing with amber, brown, cream palette. Camera: crane up."}}
+{"song": "Coal Country", "beat": 8, "lyric_line": "The union hall still stands", "scene": {"mood": "resistance", "colors": ["black", "red", "gold"], "composition": "bird's eye", "camera": "dolly in", "description": "A resistance scene illustrating 'The union hall still stands'. bird's eye framing with black, red, gold palette. Camera: dolly in."}}
+{"song": "Coal Country", "beat": 9, "lyric_line": "Some debts are paid in standing up", "scene": {"mood": "strength", "colors": ["grey", "white", "blue"], "composition": "dutch angle", "camera": "gentle drift", "description": "A strength scene illustrating 'Some debts are paid in standing up'. dutch angle framing with grey, white, blue palette. Camera: gentle drift."}}
+{"song": "Coal Country", "beat": 10, "lyric_line": "The coal is gone but we remain", "scene": {"mood": "solidarity", "colors": ["white", "grey", "pale blue"], "composition": "establishing shot", "camera": "locked-off", "description": "A solidarity scene illustrating 'The coal is gone but we remain'. establishing shot framing with white, grey, pale blue palette. Camera: locked-off."}}
+{"song": "Wintering", "beat": 1, "lyric_line": "The world goes white and quiet", "scene": {"mood": "contemplation", "colors": ["grey", "white", "blue"], "composition": "close-up", "camera": "slow pan", "description": "A contemplation scene illustrating 'The world goes white and quiet'. close up framing with grey, white, blue palette. Camera: slow pan."}}
+{"song": "Wintering", "beat": 2, "lyric_line": "I've been turning inward like the trees", "scene": {"mood": "solitude", "colors": ["white", "grey", "pale blue"], "composition": "wide shot", "camera": "steady", "description": "A solitude scene illustrating 'I've been turning inward like the trees'. wide shot framing with white, grey, pale blue palette. Camera: steady."}}
+{"song": "Wintering", "beat": 3, "lyric_line": "Bare branches write against the sky", "scene": {"mood": "depth", "colors": ["amber", "brown", "cream"], "composition": "medium shot", "camera": "handheld", "description": "A depth scene illustrating 'Bare branches write against the sky'. medium shot framing with amber, brown, cream palette. Camera: handheld."}}
+{"song": "Wintering", "beat": 4, "lyric_line": "The fireplace asks for nothing but tending", "scene": {"mood": "quiet", "colors": ["navy", "silver", "white"], "composition": "low angle", "camera": "slow zoom", "description": "A quiet scene illustrating 'The fireplace asks for nothing but tending'. low angle framing with navy, silver, white palette. Camera: slow zoom."}}
+{"song": "Wintering", "beat": 5, "lyric_line": "I read the same page twice and understand more", "scene": {"mood": "reflection", "colors": ["olive", "cream", "rust"], "composition": "high angle", "camera": "tracking", "description": "A reflection scene illustrating 'I read the same page twice and understand more'. high angle framing with olive, cream, rust palette. Camera: tracking."}}
+{"song": "Wintering", "beat": 6, "lyric_line": "Snow erases what I needed erased", "scene": {"mood": "contemplation", "colors": ["yellow", "warm brown", "green"], "composition": "over-the-shoulder", "camera": "static", "description": "A contemplation scene illustrating 'Snow erases what I needed erased'. over the shoulder framing with yellow, warm brown, green palette. Camera: static."}}
+{"song": "Wintering", "beat": 7, "lyric_line": "The cold clarifies what warmth confused", "scene": {"mood": "solitude", "colors": ["yellow", "warm brown", "green"], "composition": "profile", "camera": "crane up", "description": "A solitude scene illustrating 'The cold clarifies what warmth confused'. profile framing with yellow, warm brown, green palette. Camera: crane up."}}
+{"song": "Wintering", "beat": 8, "lyric_line": "I've been storing up like the squirrels", "scene": {"mood": "depth", "colors": ["navy", "silver", "white"], "composition": "bird's eye", "camera": "dolly in", "description": "A depth scene illustrating 'I've been storing up like the squirrels'. bird's eye framing with navy, silver, white palette. Camera: dolly in."}}
+{"song": "Wintering", "beat": 9, "lyric_line": "Silence is not empty it's full", "scene": {"mood": "quiet", "colors": ["green", "gold", "brown"], "composition": "dutch angle", "camera": "gentle drift", "description": "A quiet scene illustrating 'Silence is not empty it's full'. dutch angle framing with green, gold, brown palette. Camera: gentle drift."}}
+{"song": "Wintering", "beat": 10, "lyric_line": "Spring will find me ready or not", "scene": {"mood": "reflection", "colors": ["navy", "silver", "white"], "composition": "establishing shot", "camera": "locked-off", "description": "A reflection scene illustrating 'Spring will find me ready or not'. establishing shot framing with navy, silver, white palette. Camera: locked-off."}}
+{"song": "Porch Light", "beat": 1, "lyric_line": "She leaves the light on every night", "scene": {"mood": "anticipation", "colors": ["grey", "white", "blue"], "composition": "close-up", "camera": "slow pan", "description": "A anticipation scene illustrating 'She leaves the light on every night'. close up framing with grey, white, blue palette. Camera: slow pan."}}
+{"song": "Porch Light", "beat": 2, "lyric_line": "The road home is shorter than I thought", "scene": {"mood": "return", "colors": ["olive", "cream", "rust"], "composition": "wide shot", "camera": "steady", "description": "A return scene illustrating 'The road home is shorter than I thought'. wide shot framing with olive, cream, rust palette. Camera: steady."}}
+{"song": "Porch Light", "beat": 3, "lyric_line": "Crickets welcome me without questions", "scene": {"mood": "faith", "colors": ["yellow", "warm brown", "green"], "composition": "medium shot", "camera": "handheld", "description": "A faith scene illustrating 'Crickets welcome me without questions'. medium shot framing with yellow, warm brown, green palette. Camera: handheld."}}
+{"song": "Porch Light", "beat": 4, "lyric_line": "The screen door still doesn't latch right", "scene": {"mood": "light", "colors": ["dusty blue", "tan", "grey"], "composition": "low angle", "camera": "slow zoom", "description": "A light scene illustrating 'The screen door still doesn't latch right'. low angle framing with dusty blue, tan, grey palette. Camera: slow zoom."}}
+{"song": "Porch Light", "beat": 5, "lyric_line": "Some things don't need fixing", "scene": {"mood": "reunion", "colors": ["white", "grey", "pale blue"], "composition": "high angle", "camera": "tracking", "description": "A reunion scene illustrating 'Some things don't need fixing'. high angle framing with white, grey, pale blue palette. Camera: tracking."}}
+{"song": "Porch Light", "beat": 6, "lyric_line": "Her voice carries across the yard", "scene": {"mood": "anticipation", "colors": ["dusty blue", "tan", "grey"], "composition": "over-the-shoulder", "camera": "static", "description": "A anticipation scene illustrating 'Her voice carries across the yard'. over the shoulder framing with dusty blue, tan, grey palette. Camera: static."}}
+{"song": "Porch Light", "beat": 7, "lyric_line": "The porch swing holds our weight and years", "scene": {"mood": "return", "colors": ["deep red", "brown", "amber"], "composition": "profile", "camera": "crane up", "description": "A return scene illustrating 'The porch swing holds our weight and years'. profile framing with deep red, brown, amber palette. Camera: crane up."}}
+{"song": "Porch Light", "beat": 8, "lyric_line": "I was gone but never lost", "scene": {"mood": "faith", "colors": ["amber", "brown", "cream"], "composition": "bird's eye", "camera": "dolly in", "description": "A faith scene illustrating 'I was gone but never lost'. bird's eye framing with amber, brown, cream palette. Camera: dolly in."}}
+{"song": "Porch Light", "beat": 9, "lyric_line": "The light means someone's still awake", "scene": {"mood": "light", "colors": ["olive", "cream", "rust"], "composition": "dutch angle", "camera": "gentle drift", "description": "A light scene illustrating 'The light means someone's still awake'. dutch angle framing with olive, cream, rust palette. Camera: gentle drift."}}
+{"song": "Porch Light", "beat": 10, "lyric_line": "Coming home is a kind of prayer", "scene": {"mood": "reunion", "colors": ["warm yellow", "brown", "red"], "composition": "establishing shot", "camera": "locked-off", "description": "A reunion scene illustrating 'Coming home is a kind of prayer'. establishing shot framing with warm yellow, brown, red palette. Camera: locked-off."}}
+{"song": "Fiddle and Dust", "beat": 1, "lyric_line": "The fiddle case hasn't opened in years", "scene": {"mood": "regret", "colors": ["yellow", "warm brown", "green"], "composition": "close-up", "camera": "slow pan", "description": "A regret scene illustrating 'The fiddle case hasn't opened in years'. close up framing with yellow, warm brown, green palette. Camera: slow pan."}}
+{"song": "Fiddle and Dust", "beat": 2, "lyric_line": "Dust settled on the D string", "scene": {"mood": "fondness", "colors": ["white", "grey", "pale blue"], "composition": "wide shot", "camera": "steady", "description": "A fondness scene illustrating 'Dust settled on the D string'. wide shot framing with white, grey, pale blue palette. Camera: steady."}}
+{"song": "Fiddle and Dust", "beat": 3, "lyric_line": "His fingers knew before his mind", "scene": {"mood": "aging", "colors": ["deep red", "brown", "amber"], "composition": "medium shot", "camera": "handheld", "description": "A aging scene illustrating 'His fingers knew before his mind'. medium shot framing with deep red, brown, amber palette. Camera: handheld."}}
+{"song": "Fiddle and Dust", "beat": 4, "lyric_line": "The dance floor remembers better than us", "scene": {"mood": "memory", "colors": ["deep red", "brown", "amber"], "composition": "low angle", "camera": "slow zoom", "description": "A memory scene illustrating 'The dance floor remembers better than us'. low angle framing with deep red, brown, amber palette. Camera: slow zoom."}}
+{"song": "Fiddle and Dust", "beat": 5, "lyric_line": "Some songs live in the walls", "scene": {"mood": "music", "colors": ["navy", "silver", "white"], "composition": "high angle", "camera": "tracking", "description": "A music scene illustrating 'Some songs live in the walls'. high angle framing with navy, silver, white palette. Camera: tracking."}}
+{"song": "Fiddle and Dust", "beat": 6, "lyric_line": "We played until the neighbors joined", "scene": {"mood": "regret", "colors": ["amber", "dust", "gold"], "composition": "over-the-shoulder", "camera": "static", "description": "A regret scene illustrating 'We played until the neighbors joined'. over the shoulder framing with amber, dust, gold palette. Camera: static."}}
+{"song": "Fiddle and Dust", "beat": 7, "lyric_line": "The bow hair snapped and we kept going", "scene": {"mood": "fondness", "colors": ["yellow", "warm brown", "green"], "composition": "profile", "camera": "crane up", "description": "A fondness scene illustrating 'The bow hair snapped and we kept going'. profile framing with yellow, warm brown, green palette. Camera: crane up."}}
+{"song": "Fiddle and Dust", "beat": 8, "lyric_line": "Music fills what grief empties", "scene": {"mood": "aging", "colors": ["grey", "white", "blue"], "composition": "bird's eye", "camera": "dolly in", "description": "A aging scene illustrating 'Music fills what grief empties'. bird's eye framing with grey, white, blue palette. Camera: dolly in."}}
+{"song": "Fiddle and Dust", "beat": 9, "lyric_line": "He says he's too old but his foot taps", "scene": {"mood": "memory", "colors": ["white", "grey", "pale blue"], "composition": "dutch angle", "camera": "gentle drift", "description": "A memory scene illustrating 'He says he's too old but his foot taps'. dutch angle framing with white, grey, pale blue palette. Camera: gentle drift."}}
+{"song": "Fiddle and Dust", "beat": 10, "lyric_line": "Some instruments wait patiently", "scene": {"mood": "music", "colors": ["amber", "brown", "cream"], "composition": "establishing shot", "camera": "locked-off", "description": "A music scene illustrating 'Some instruments wait patiently'. establishing shot framing with amber, brown, cream palette. Camera: locked-off."}}