video_workflow_plan

tech.kyanitelabs/kinocut · Verify this server

Produce a no-render plan for an agent workflow job-spec. Validates the spec first (fail-closed) and then builds a dry-run plan artifact WITHOUT rendering any media: the ordered operation graph, per-source ffprobe results (duration/resolution/codec) and sha256 content hashes where the source file exists, declared output intents, a variant-expansion summary, tool + FFmpeg versions, and warnings for runtime concerns that are not structural errors (e.g. a source file that does not exist yet). The only file written is the optional plan JSON at ``save_plan``; paths inside the artifact are workspace-relative. Pass ``variant`` to plan a single named batch variant: the plan reflects that variant's EFFECTIVE (post-override) steps and auto-named output paths and records ``workflow.variant``. An unknown variant or malformed override fails closed (``invalid_workflow_variant``). Returns the plan artifact on success. On a structurally invalid spec it fails closed with a specific error ``code`` (same codes as ``video_workflow_validate``). Args: spec_path: Absolute path to the workflow job-spec JSON file. save_plan: Optional path to write the plan artifact as JSON. variant: Optional declared variant id to plan its effective steps.