v0.3.0

Highlights

Ralphy 0.3.0 is the biggest release yet: HyperFrames is now the default (and only) render engine, the CLI grew ~15 new verbs (units, compose, image ops, guidelines, deep research), and the provider layer got production-grade resilience — retries, self-throttling, ToS auto-resubmit, and preflight checks across the board.

Features

New CLI verbs

• ralphy unit — project units/ layer: curated, append-only deliverables with provenance manifests (#069)
• ralphy compose — timeline-aware composition verb (#013)
• ralphy hyperframes — HF namespace with gen-log wiring + save-version snapshots (#028)
• ralphy guideline — prompt-library rules: list / show <slug>
• ralphy image — chromakey, cutout, fit, svg-rasterize (#037)
• ralphy research run — planner+fan-out deep-research engine with 5-level citation verifier
• ralphy ref locate — vision-based object bbox via Gemini
• ralphy ref pull-site — Playwright crawl for brand-DNA capture (#014)
• ralphy ref pull-bulk / assets unpack — bulk URL pull + zip unpack (#048)
• ralphy template extract — promote a finished project to a reusable template (#033)
• ralphy video frame / extend — i2v anchoring helpers (#012)
• ralphy generate batch / variants / image-batch + cost --dry-run (#024)
• ralphy voice clone + cost/speed/stability flags (#030)
• ralphy editor preflight / trim-analyze (#034)
• ralphy project assets / verify over ffprobe truth (#029) + log-asset --copy-from (#038)

Render

• HyperFrames is the default render engine; Remotion removed entirely
• render --from-clip loudnorm mode (#009), --grade / --quality flags (#036)
• video/audio recipes: grade, VHS, mix-music, compress (#036)

Providers & reliability

• Transient-error retry with exponential backoff (#005); per-endpoint concurrency self-throttle + 403 rewrite (#007)
• kling-v3.0-pro multi-frame + prompt-length preflight (#008); auto-strip C2PA + resize oversized PNG anchors for i2v (#021)
• ElevenLabs: structured ToS rejection + auto-resubmit + prompt linter (#006); per-slot lock + ffprobe-verify (#039)
• Voice/scribe/vision/size preflights on generate + ref (#051)
• Per-provider connector files + --provider flag

Templates & library

• Format→styles taxonomy — "everything is a template" (#052) + --format flag
• Content-entity model: Units + typed blocks, Supabase publish pipeline (#056/#063-066)
• 9 real projects backfilled as templates (#058)

Fixes

• ralphy new unified with project create — no more orphan dirs (#031)
• gen-log canonical schema + slot field (#032); slot-id auto-normalization (#022)
• sidechain ffmpeg filter labels + --loudnorm (#011); silent-source addMusicBed
• captions per-slot output + safe-zone wrap (#010); eval handles record-shaped scenes (#046)
• template --help Examples block so landing snippets resolve

Internal

• Apache 2.0 license; Remotion + dashboard removed; tooling modernized
• AGENTS.md invariants locked in CI (#015, #4); skills renamed (drop ralphy- prefix)
• build: mark electron external so playwright-core bundles under bun --compile

Full Changelog: v0.2.0...v0.3.0