@mevdragon/vidfarm-devcli 0.2.14 → 0.3.1

package/auto-create-templates/extractor-system-prompt.md

@@ -1,119 +0,0 @@
-# Production Graph Extractor Prompt
-
-You are a Vidfarm template production analyst.
-
-Your job is to inspect one TikTok or short-form source format and extract the repeatable production process as structured JSON. Do not merely describe the video. Convert it into a reusable template recipe that can be implemented with Vidfarm operations, Remotion, AI image/video generation, TTS, STT, OCR, and user-supplied media slots.
-
-The viral DNA is the primary steering contract. The visual DNA is only preservation-critical when it materially supports the viral mechanism. Decide this explicitly before extracting implementation details.
-
-Return only JSON matching `production-graph.schema.json`.
-
-## Inputs You May Receive
-
-- source notes
-- original URL and creator
-- full source video or preview images
-- contact sheet
-- representative frames
-- ffprobe metadata
-- scene cut list
-- STT transcript with word timestamps
-- OCR text from frames
-- viral DNA JSON
-- visual DNA JSON
-- viral steering and visual preservation decision, if already produced
-
-## Extraction Rules
-
-- Treat all supplied media as one format.
-- Separate viral mechanism, visual system, and production implementation.
-- Use viral DNA to decide what the template must optimize for: hook, curiosity, emotional tension, status, proof, payoff, retention, share/save behavior, or native credibility.
-- Evaluate visual DNA through that viral lens. Mark each visual trait as critical, supportive, optional, or low-importance. Do not preserve visual details merely because they are visible.
-- Ignore TikTok platform chrome unless the creator-authored format intentionally imitates an app surface.
-- Identify which elements are fixed, variable, optional, or generated.
-- Extract exact or inferred durations for scenes, captions, overlays, transitions, zooms, holds, and loop points.
-- Treat timing as a reusable control surface. If a source slot has a duration, decide whether future users should be able to override it.
-- Strongly identify TikTok-native typography: font family match, weight, case, outline, shadow, background chip, word highlight, line wrapping, line height, and fallback font stack.
-- Classify every important readable text surface as deterministic overlay text, source-media text, or AI-rendered poster/artifact text. Important captions, subtitles, UI labels, offers, prices, claims, and CTAs should default to deterministic overlay text unless the format is explicitly poster/artifact-native.
-- Treat fonts as an allowlist decision. Prefer approved Vidfarm font IDs where possible: `tiktok_sans_semibold`, `montserrat_semibold`, `source_code_pro_bold`, `georgia_bold`, or `abel`. Mark custom or AI-rendered typography as source-critical only when the viral mechanism depends on it.
-- When a text background color appears, classify it as an inline highlight chip unless the source clearly uses a deliberate poster panel. Record that the chip must be measured per wrapped line and must not become a full-width caption box or paragraph wash.
-- When white creator-authored TikTok captions appear, distinguish native radial black halo/outline from web-style directional drop shadow. Record centered multi-layer shadow/blur requirements when the shadow radiates around the glyphs.
-- When captions wrap across lines, record block-level rendering requirements: one shared font size and line height for the full multiline caption, shadow/outline applied to the whole block, and any per-line chip geometry derived after the shared layout. Do not recommend independently trimmed per-line text images.
-- Prefer deterministic Remotion/HTML composition for layout, captions, overlays, app UI, and final edit.
-- Do not force Remotion when it would become brittle. If the format depends on organic visual detail, character acting, cinematic continuity, generated texture, painterly style, or complex physical motion, mark it as AI-native prompt/reference or hybrid.
-- Use AI image/video only for assets that require generative content.
-- Use TTS/STT when audio drives timing, narration, or captions.
-- Identify compliance risks and avoid making copyrighted media or celebrity likenesses a required dependency.
-
-## Required Analysis Dimensions
-
-Extract:
-
-- first-frame hook
-- viewer promise and payoff
-- viral steering rules that must survive every adaptation
-- visual preservation importance and rationale
-- timeline beats
-- scene/shot list
-- text overlays and captions
-- audio/narration/music/sfx
-- timing controls and duration ranges
-- font and caption styling controls
-- camera moves and edit rhythm
-- UI/screenshot/app surfaces
-- generated-image or generated-video needs
-- media replacement slots
-- Remotion ceiling risk: what would become too brittle if hand-assembled
-- architecture fit: `remotion`, `ai_native_reference`, `hybrid`, or `manual_review`
-- character bible and identity consistency requirements when the same AI-generated character appears across scenes
-- storyboard/keyframe workflow requirements for full AI character videos
-- pointing/circling/magnifying/highlight effects
-- transition rules
-- safe areas and layout constraints
-- provider/tool dependencies
-- validation checklist
-- output quality harness gates: preflight, asset check, composition check, final-output check, and targeted retry rules
-
-## Implementation Classification
-
-For every meaningful element choose one implementation:
-
-- `remotion`: deterministic layout, captions, overlays, cuts, zooms, UI, final render
-- `html_canvas`: static or frame-based graphic composition
-- `ai_image`: generated still image or edited reference
-- `ai_video`: generated motion clip
-- `ai_native_reference`: whole asset or scene generated from source DNA and reference attachments instead of deterministic layer reconstruction
-- `tts`: generated speech
-- `stt`: transcription and word timing
-- `ocr`: source text extraction
-- `user_upload`: caller must provide media
-- `external_clip`: caller-provided clip; do not fetch copyrighted media automatically
-- `media_search`: optional search/reference gathering
-- `manual_review`: human must approve or adjust
-
-## Full AI Character Video Detection
-
-If the source appears to be a full AI-generated video with recurring characters, extract it as a character-consistency workflow. Look for consistent faces, wardrobe, body shape, art material, recurring props, repeated locations, or the same mascot/person acting across multiple scenes.
-
-When detected, the production graph should require:
-
-- `create_character_cards`: character sprite/reference cards and a character bible
-- `create_storyboard`: image storyboard or keyframes for the full video
-- `generate_scene_videos`: one generated video clip per scene
-- `stitch_video`: final Remotion assembly for clips, captions, audio, timing, and overlays
-
-Do not recommend frame-by-frame character acting in Remotion. Remotion is the editor/stitcher for this case; AI image/video generation owns the character motion and scene content.
-
-## Output Bias
-
-Be concrete. A production graph should be implementable.
-
-Bad: "Use engaging captions and quick cuts."
-
-Good: "Render 2-line white uppercase captions centered at y=178 with black 2px shadow, max 22 characters per line, timed to word groups of 700-1400 ms. Insert 1.08x punch-in zoom on every sentence start."
-
-Typography bias: if the format uses creator-authored captions or overlays, default to TikTok-native typography. Prefer TikTok Sans Semibold when available; otherwise choose the closest checked-in or system fallback and record the fallback explicitly. Tune TikTok Sans wrapping, size, and line spacing separately from Montserrat or generic sans defaults. If a background color is present, describe inline line chips that hug the text. If a white caption needs contrast, describe a radial black halo/outline instead of a large one-direction web shadow.
-
-Viral preservation bias: if a choice conflicts between visual sameness and viral effectiveness, preserve the viral mechanism first. Example: if the source wins because of a shocking first-frame claim, preserve the claim structure and pacing even if the background scene changes. If it wins because of a recognizable fake-chat, notification, or game UI container, then visual preservation is likely critical.
-
-Architecture bias: Remotion is excellent for deterministic layout and edit assembly, but brittle for highly organic visuals. Prefer AI-native reference prompting when exact layer reconstruction would be more fragile than asking a capable image/video model to regenerate the style and scene directly.

package/auto-create-templates/production-graph.schema.json

@@ -1,276 +0,0 @@
-{
-  "$schema": "https://json-schema.org/draft/2020-12/schema",
-  "title": "Vidfarm Auto Template Production Graph",
-  "type": "object",
-  "required": [
-    "format_summary",
-    "classification",
-    "viral_mechanics",
-    "viral_steering",
-    "visual_preservation",
-    "visual_system",
-    "timeline",
-    "replaceable_slots",
-    "production_strategy",
-    "dependencies",
-    "validation"
-  ],
-  "properties": {
-    "format_summary": {
-      "type": "object",
-      "required": ["title", "one_sentence", "source_kind", "duration_ms"],
-      "properties": {
-        "title": { "type": "string" },
-        "one_sentence": { "type": "string" },
-        "source_kind": { "type": "string" },
-        "duration_ms": { "type": "integer", "minimum": 0 },
-        "aspect_ratio": { "type": "string" },
-        "resolution": { "type": "string" }
-      }
-    },
-    "classification": {
-      "type": "object",
-      "required": ["difficulty", "primary_container", "recognition_mode", "recommended_architecture"],
-      "properties": {
-        "difficulty": { "enum": ["easy", "medium", "hard"] },
-        "primary_container": { "type": "string" },
-        "recognition_mode": { "enum": ["presentation-centric", "character-centric", "vibe-centric", "mixed"] },
-        "recommended_architecture": {
-          "enum": [
-            "static_composite",
-            "ai_image",
-            "ai_native_reference",
-            "slideshow_remotion",
-            "captioned_source_clip",
-            "ui_shell_remotion",
-            "ugc_edit",
-            "storyboard_to_video",
-            "full_ai_character_video",
-            "animated_explainer",
-            "hybrid"
-          ]
-        }
-      }
-    },
-    "viral_mechanics": {
-      "type": "object",
-      "properties": {
-        "hook": { "type": "string" },
-        "curiosity_gap": { "type": "string" },
-        "emotional_trigger": { "type": "string" },
-        "payoff": { "type": "string" },
-        "loop_or_rewatch_driver": { "type": "string" }
-      }
-    },
-    "viral_steering": {
-      "type": "object",
-      "required": ["must_preserve", "must_not_dilute", "generation_rules", "validation_checks"],
-      "properties": {
-        "must_preserve": { "type": "array", "items": { "type": "string" } },
-        "must_not_dilute": { "type": "array", "items": { "type": "string" } },
-        "generation_rules": { "type": "array", "items": { "type": "string" } },
-        "validation_checks": { "type": "array", "items": { "type": "string" } }
-      }
-    },
-    "visual_preservation": {
-      "type": "object",
-      "required": ["importance", "preserve_because", "preserve", "can_change"],
-      "properties": {
-        "importance": { "enum": ["critical", "supportive", "optional", "low"] },
-        "preserve_because": { "type": "string" },
-        "preserve": { "type": "array", "items": { "type": "string" } },
-        "can_change": { "type": "array", "items": { "type": "string" } },
-        "decision_notes": { "type": "array", "items": { "type": "string" } }
-      }
-    },
-    "visual_system": {
-      "type": "object",
-      "properties": {
-        "must_preserve": { "type": "array", "items": { "type": "string" } },
-        "can_adapt": { "type": "array", "items": { "type": "string" } },
-        "caption_rules": { "type": "array", "items": { "type": "string" } },
-        "layout_rules": { "type": "array", "items": { "type": "string" } },
-        "style_rules": { "type": "array", "items": { "type": "string" } }
-      }
-    },
-    "timeline": {
-      "type": "array",
-      "items": {
-        "type": "object",
-        "required": ["id", "start_ms", "end_ms", "duration_ms", "role", "asset_kind", "replaceability", "implementation"],
-        "properties": {
-          "id": { "type": "string" },
-          "start_ms": { "type": "integer", "minimum": 0 },
-          "end_ms": { "type": "integer", "minimum": 0 },
-          "duration_ms": { "type": "integer", "minimum": 0 },
-          "role": { "type": "string" },
-          "description": { "type": "string" },
-          "asset_kind": {
-            "enum": [
-              "source_video",
-              "generated_video",
-              "generated_image",
-              "uploaded_image",
-              "uploaded_video",
-              "rendered_ui",
-              "text",
-              "audio",
-              "shape",
-              "effect"
-            ]
-          },
-          "replaceability": { "enum": ["fixed", "variable", "optional", "generated"] },
-          "implementation": {
-            "enum": [
-              "remotion",
-              "html_canvas",
-              "ai_image",
-              "ai_video",
-              "tts",
-              "stt",
-              "ocr",
-              "user_upload",
-              "external_clip",
-              "media_search",
-              "manual_review"
-            ]
-          },
-          "inputs": { "type": "array", "items": { "type": "string" } },
-          "outputs": { "type": "array", "items": { "type": "string" } },
-          "timing_notes": { "type": "string" },
-          "layout_notes": { "type": "string" },
-          "safe_area_notes": { "type": "string" },
-          "validation_notes": { "type": "string" }
-        }
-      }
-    },
-    "timing_controls": {
-      "type": "object",
-      "properties": {
-        "total_duration_ms": { "type": "integer", "minimum": 0 },
-        "user_configurable": { "type": "boolean" },
-        "default_scene_duration_ms": { "type": "integer", "minimum": 0 },
-        "default_transition_ms": { "type": "integer", "minimum": 0 },
-        "default_hold_ms": { "type": "integer", "minimum": 0 },
-        "min_slot_duration_ms": { "type": "integer", "minimum": 0 },
-        "max_slot_duration_ms": { "type": "integer", "minimum": 0 },
-        "caption_timing_mode": {
-          "enum": ["transcript_word_timestamps", "fixed_groups", "manual_timestamps", "none"]
-        },
-        "notes": { "type": "array", "items": { "type": "string" } }
-      }
-    },
-    "typography_controls": {
-      "type": "object",
-      "properties": {
-        "user_configurable": { "type": "boolean" },
-        "recommended_font": { "type": "string" },
-        "fallback_fonts": { "type": "array", "items": { "type": "string" } },
-        "font_size_rules": { "type": "array", "items": { "type": "string" } },
-        "caption_style_rules": { "type": "array", "items": { "type": "string" } },
-        "tiktok_native_match_notes": { "type": "array", "items": { "type": "string" } }
-      }
-    },
-    "replaceable_slots": {
-      "type": "array",
-      "items": {
-        "type": "object",
-        "required": ["name", "kind", "required", "description"],
-        "properties": {
-          "name": { "type": "string" },
-          "kind": {
-            "enum": ["text", "image", "video", "audio", "product", "person", "app_screen", "url", "stat", "brand", "style", "cta"]
-          },
-          "required": { "type": "boolean" },
-          "description": { "type": "string" },
-          "constraints": { "type": "array", "items": { "type": "string" } },
-          "default_generation_prompt": { "type": "string" }
-        }
-      }
-    },
-    "production_strategy": {
-      "type": "object",
-      "required": ["architecture_fit", "stages"],
-      "properties": {
-        "architecture_fit": {
-          "enum": ["remotion", "ai_native_reference", "hybrid", "manual_review"]
-        },
-        "remotion_ceiling_risk": {
-          "enum": ["low", "medium", "high"]
-        },
-        "architecture_rationale": { "type": "string" },
-        "ai_native_reference_plan": {
-          "type": "object",
-          "properties": {
-            "needed": { "type": "boolean" },
-            "reference_inputs": { "type": "array", "items": { "type": "string" } },
-            "prompt_contract": { "type": "array", "items": { "type": "string" } },
-            "when_to_avoid_remotion": { "type": "array", "items": { "type": "string" } }
-          }
-        },
-        "character_workflow": {
-          "type": "object",
-          "properties": {
-            "detected": { "type": "boolean" },
-            "consistency_level": { "enum": ["none", "light", "strict", "identity_locked"] },
-            "characters": {
-              "type": "array",
-              "items": {
-                "type": "object",
-                "required": ["name", "role", "visual_identity"],
-                "properties": {
-                  "name": { "type": "string" },
-                  "role": { "type": "string" },
-                  "visual_identity": { "type": "array", "items": { "type": "string" } },
-                  "wardrobe": { "type": "array", "items": { "type": "string" } },
-                  "props": { "type": "array", "items": { "type": "string" } },
-                  "reference_card_requirements": { "type": "array", "items": { "type": "string" } }
-                }
-              }
-            },
-            "required_operations": {
-              "type": "array",
-              "items": {
-                "enum": ["create_character_cards", "create_storyboard", "generate_scene_videos", "stitch_video"]
-              }
-            },
-            "storyboard_requirements": { "type": "array", "items": { "type": "string" } },
-            "scene_video_requirements": { "type": "array", "items": { "type": "string" } }
-          }
-        },
-        "stages": {
-          "type": "array",
-          "items": {
-            "type": "object",
-            "required": ["name", "purpose", "tools"],
-            "properties": {
-              "name": { "type": "string" },
-              "purpose": { "type": "string" },
-              "tools": { "type": "array", "items": { "type": "string" } },
-              "outputs": { "type": "array", "items": { "type": "string" } }
-            }
-          }
-        }
-      }
-    },
-    "dependencies": {
-      "type": "object",
-      "properties": {
-        "needs_remotion": { "type": "boolean" },
-        "needs_ai_image": { "type": "boolean" },
-        "needs_ai_video": { "type": "boolean" },
-        "needs_tts": { "type": "boolean" },
-        "needs_stt": { "type": "boolean" },
-        "needs_ocr": { "type": "boolean" },
-        "provider_notes": { "type": "array", "items": { "type": "string" } }
-      }
-    },
-    "validation": {
-      "type": "object",
-      "properties": {
-        "checks": { "type": "array", "items": { "type": "string" } },
-        "known_risks": { "type": "array", "items": { "type": "string" } }
-      }
-    }
-  }
-}

package/auto-create-templates/runbook.md

@@ -1,140 +0,0 @@
-# Auto-Create Template Runbook
-
-Use this runbook when a source TikTok/video should become a Vidfarm template.
-
-## 1. Create A Run Folder
-
-```bash
-RUN_ID="<format-slug>-$(date +%Y%m%d-%H%M%S)"
-mkdir -p "auto-create-templates/runs/${RUN_ID}"/{source,frames,audio,transcripts,ocr,motion,dna,extraction,plan}
-```
-
-Copy source media and notes into `source/`.
-
-## 2. Extract Basic Media Artifacts
-
-```bash
-ffprobe -v error -show_entries format=duration:stream=codec_type,width,height,avg_frame_rate -of json source/source.mp4 \
-  > "auto-create-templates/runs/${RUN_ID}/source/ffprobe.json"
-
-ffmpeg -y -i source/source.mp4 \
-  -vf "fps=1/2,scale=240:-1,tile=3x4" \
-  -frames:v 1 "auto-create-templates/runs/${RUN_ID}/frames/contact-sheet.jpg"
-
-ffmpeg -y -i source/source.mp4 \
-  -vn -ac 1 -ar 16000 "auto-create-templates/runs/${RUN_ID}/audio/source.wav"
-```
-
-Add scene detection, OCR, and STT with whichever local tool/provider is available. The important part is writing results into the run folder so the extraction prompt can cite concrete timing and text.
-
-## 3. Scaffold Template And Run DNA
-
-```bash
-npx @mevdragon/vidfarm-devcli generate-template \
-  --slug-id <slug_id> \
-  --template-dir ./templates/vidfarm_template_<slug> \
-  --source-notes-path ./drafts/<format_slug>/source.md \
-  --source-preview-dir ./drafts/<format_slug>/preview \
-  --link-to-original "<original_url>"
-```
-
-If DNA did not run during scaffold:
-
-```bash
-npx @mevdragon/vidfarm-devcli analyze-viral-dna --template-dir ./templates/vidfarm_template_<slug>
-npx @mevdragon/vidfarm-devcli analyze-visual-dna --template-dir ./templates/vidfarm_template_<slug>
-```
-
-Copy `research/viral_dna.extraction.json` and `research/visual_dna.extraction.json` into the run folder.
-
-## 4. Decide Viral Steering And Visual Preservation
-
-Before generating the production graph, create:
-
-```txt
-auto-create-templates/runs/<run_id>/dna/preservation_decision.json
-```
-
-This decision must be viral-first:
-
-- extract the hook, tension, payoff, retention, and share/save mechanics from viral DNA
-- decide which visual traits materially support those mechanics
-- mark visual preservation as `critical`, `supportive`, `optional`, or `low`
-- list what must be preserved and what can vary
-
-Do not preserve visual traits blindly. Some formats win because of the visual container; others win because of premise, pacing, voice, or story.
-
-## 5. Decide Architecture Fit
-
-Before generating the production graph, also decide whether the format is:
-
-- `remotion`: deterministic layout/edit assembly is robust
-- `ai_native_reference`: source-faithful prompt/reference generation is more robust than layer reconstruction
-- `hybrid`: AI generates complex assets; Remotion assembles, captions, crops, times, and packages
-- `manual_review`: legal, likeness, copyright, or complexity risk needs human approval
-
-Mark `remotion_ceiling_risk` as `low`, `medium`, or `high`. High risk means the source has organic visual style, complex character acting, cinematic motion, dense texture, or too many brittle layers to rebuild deterministically.
-
-Also detect whether this is a `full_ai_character_video`. If the same generated character, mascot, clay figure, anime figure, game character, or illustrated persona appears across multiple scenes, plan the character workflow:
-
-- `create_character_cards`
-- `create_storyboard`
-- `generate_scene_videos`
-- `stitch_video`
-
-The key decision is whether identity consistency is `light`, `strict`, or `identity_locked`. Strict and identity-locked workflows should create reusable character cards before storyboarding.
-
-## 6. Generate Production Graph
-
-Send the extractor prompt, source notes, media artifacts, DNA files, preservation decision, and contact sheet to a multimodal model.
-
-Write the result to:
-
-```txt
-auto-create-templates/runs/<run_id>/extraction/production_graph.json
-```
-
-Validate against:
-
-```txt
-auto-create-templates/production-graph.schema.json
-```
-
-## 7. Generate Template Plan
-
-Send the template planner prompt plus `production_graph.json`.
-
-Write the result to:
-
-```txt
-auto-create-templates/runs/<run_id>/plan/template_plan.json
-```
-
-Validate against:
-
-```txt
-auto-create-templates/template-plan.schema.json
-```
-
-## 8. Implement
-
-Implementation should usually happen in this order:
-
-1. update `src/template.ts` metadata and schemas
-2. persist viral steering and visual preservation rules in metadata, prompt constants/comments, and docs
-3. implement operation workflows
-4. add Remotion composition only when the architecture fit calls for it
-5. wire storage outputs and manifests
-6. update template-local `SKILL.md`
-7. add representative smoke test payloads
-
-## 9. Validate
-
-```bash
-npx @mevdragon/vidfarm-devcli validate-template --template-id <slug_id>
-npx @mevdragon/vidfarm-devcli session
-```
-
-Launch at least one local job through the standard operation endpoint and inspect output artifacts.
-
-The generated output should be checked for viral compliance, not just render correctness.