robosystems-content-machine/justfile at main · RoboFinSystems/robosystems-content-machine · GitHub

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
# =============================================================================
# ROBOSYSTEMS CONTENT MACHINE — VIDEO CONTENT PIPELINE
# =============================================================================
#
# QUICK START:
#   just new NVDA                                # Generic template
#   just campaign GTBIF cannabis_coverage         # Campaign coverage
#   just pipeline GTBIF                           # Run full pipeline
#
# STEP BY STEP:
#   just screenshots TICKER     # Screenshot charts/slides to PNG
#   just voiceover TICKER       # Generate ElevenLabs voiceovers
#   just assemble TICKER        # Assemble final video via Shotstack
#   just podcast TICKER         # Extract podcast audio (MP3)
#   just avatar TICKER          # Generate HeyGen avatar segments (mixed mode only)
#
# =============================================================================

_env := ".env"

default:
    @just --list

[private]
ensure-env:
    @test -f {{_env}} || cp .env.example {{_env}}

# ─── Coverage Setup ──────────────────────────────────────────

# Initiate coverage on a company (generic template)
new ticker:
    ./tools/new_project.sh {{ticker}}

# Initiate coverage on a company with a campaign
campaign ticker campaign_name:
    ./tools/new_project.sh {{ticker}} {{campaign_name}}

# List all coverage projects
projects:
    @ls -1 projects/ 2>/dev/null || echo "No projects yet. Run: just new TICKER"

# List available campaigns
campaigns:
    @ls -1 campaigns/ 2>/dev/null || echo "No campaigns yet."

# Open a project folder
open project:
    open projects/{{project}}

# ─── QA ──────────────────────────────────────────────────────

# Validate cowork outputs before running pipeline
validate project:
    @just ensure-env
    UV_ENV_FILE={{_env}} uv run python tools/validate_project.py {{project}}

# Validate and auto-fix common schema issues
validate-fix project:
    @just ensure-env
    UV_ENV_FILE={{_env}} uv run python tools/validate_project.py {{project}} --fix

# ─── Pipeline Steps ──────────────────────────────────────────

# Screenshot chart HTMLs to PNGs
screenshots project:
    @just ensure-env
    UV_ENV_FILE={{_env}} uv run python tools/screenshot_charts.py {{project}}

# Generate avatar video segments via HeyGen (mixed mode only)
avatar project:
    @just ensure-env
    UV_ENV_FILE={{_env}} uv run python tools/generate_avatar_segments.py {{project}}

# Resume polling HeyGen (if interrupted)
avatar-poll project:
    @just ensure-env
    UV_ENV_FILE={{_env}} uv run python tools/generate_avatar_segments.py {{project}} --poll

# Generate voiceover audio via ElevenLabs
voiceover project:
    @just ensure-env
    UV_ENV_FILE={{_env}} uv run python tools/generate_voiceover_audio.py {{project}}

# Assemble final video via Shotstack (add --production to use credits)
assemble project *args:
    @just ensure-env
    UV_ENV_FILE={{_env}} uv run python tools/assemble_video.py {{project}} {{args}}

# Run full pipeline: validate → screenshots → voiceover → assemble
pipeline project:
    @just ensure-env
    ./tools/run_pipeline.sh {{project}}

# Extract podcast audio (MP3) from final video
podcast project:
    #!/usr/bin/env bash
    set -euo pipefail
    VIDEO=$(ls projects/{{project}}/videos/*_final.mp4 2>/dev/null | head -1)
    if [ -z "$VIDEO" ]; then
        echo "No final video found. Run the pipeline first."
        exit 1
    fi
    TICKER="{{project}}"
    OUTPUT="projects/{{project}}/videos/${TICKER}_podcast.mp3"
    echo "Extracting audio: $VIDEO → $OUTPUT"
    ffmpeg -i "$VIDEO" -vn -acodec libmp3lame -q:a 2 -y "$OUTPUT" 2>/dev/null
    DURATION=$(ffprobe -v quiet -show_entries format=duration -of csv=p=0 "$OUTPUT" | cut -d. -f1)
    MINS=$((DURATION / 60))
    SECS=$((DURATION % 60))
    SIZE=$(du -h "$OUTPUT" | cut -f1)
    echo "Done: $OUTPUT ($SIZE, ${MINS}m${SECS}s)"

# ─── Utilities ────────────────────────────────────────────────

# Play the final video
play project:
    open projects/{{project}}/videos/*_final.mp4

# Get media durations via ffprobe
durations project:
    ./tools/durations.sh {{project}}

# Clean generated assets (keep sources/scripts/charts HTML, remove videos/PNGs)
clean project:
    rm -rf projects/{{project}}/videos projects/{{project}}/charts/png
    echo "Cleaned generated assets for {{project}}"