@mevdragon/vidfarm-devcli 0.2.14 → 0.3.1

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

@@ -1,314 +0,0 @@
-{
-  "$schema": "https://json-schema.org/draft/2020-12/schema",
-  "title": "HyperFrames Production Graph",
-  "type": "object",
-  "required": [
-    "format_summary",
-    "input_contract",
-    "visual_system",
-    "timeline",
-    "layer_decomposition",
-    "caption_system",
-    "lambda_memory_estimate",
-    "deployment",
-    "validation"
-  ],
-  "properties": {
-    "format_summary": {
-      "type": "object",
-      "required": ["slug_id", "title", "source_type", "summary", "width", "height", "duration_seconds"],
-      "properties": {
-        "slug_id": { "type": "string" },
-        "title": { "type": "string" },
-        "source_type": { "enum": ["single_video", "scene_split_video", "slideshow", "mixed_media"] },
-        "summary": { "type": "string" },
-        "width": { "type": "integer", "minimum": 1 },
-        "height": { "type": "integer", "minimum": 1 },
-        "fps": { "type": "number", "minimum": 1 },
-        "duration_seconds": { "type": "number", "minimum": 0 }
-      },
-      "additionalProperties": false
-    },
-    "input_contract": {
-      "type": "object",
-      "required": ["source_assets", "replaceable_slots"],
-      "properties": {
-        "source_assets": {
-          "type": "array",
-          "items": { "$ref": "#/$defs/sourceAsset" }
-        },
-        "replaceable_slots": {
-          "type": "array",
-          "items": {
-            "type": "object",
-            "required": ["name", "kind", "required", "description"],
-            "properties": {
-              "name": { "type": "string" },
-              "kind": { "enum": ["text", "image", "video", "audio", "html", "style", "duration", "cta"] },
-              "required": { "type": "boolean" },
-              "description": { "type": "string" },
-              "constraints": { "type": "array", "items": { "type": "string" } }
-            },
-            "additionalProperties": false
-          }
-        }
-      },
-      "additionalProperties": false
-    },
-    "viral_mechanics": {
-      "type": "object",
-      "properties": {
-        "hook_mechanic": { "type": "string" },
-        "retention_mechanic": { "type": "string" },
-        "payoff": { "type": "string" },
-        "must_preserve": { "type": "array", "items": { "type": "string" } },
-        "must_not_dilute": { "type": "array", "items": { "type": "string" } }
-      },
-      "additionalProperties": false
-    },
-    "visual_system": {
-      "type": "object",
-      "required": ["safe_areas", "layout_rules", "style_rules"],
-      "properties": {
-        "safe_areas": { "$ref": "#/$defs/safeAreas" },
-        "layout_rules": { "type": "array", "items": { "type": "string" } },
-        "style_rules": { "type": "array", "items": { "type": "string" } },
-        "subject_regions": {
-          "type": "array",
-          "items": {
-            "type": "object",
-            "required": ["id", "role", "geometry"],
-            "properties": {
-              "id": { "type": "string" },
-              "role": { "type": "string" },
-              "geometry": { "$ref": "#/$defs/geometry" }
-            },
-            "additionalProperties": false
-          }
-        }
-      },
-      "additionalProperties": false
-    },
-    "timeline": {
-      "type": "object",
-      "required": ["total_duration_seconds", "beats"],
-      "properties": {
-        "total_duration_seconds": { "type": "number", "minimum": 0 },
-        "beats": {
-          "type": "array",
-          "items": {
-            "type": "object",
-            "required": ["id", "start", "duration", "role", "coverage"],
-            "properties": {
-              "id": { "type": "string" },
-              "start": { "type": "number", "minimum": 0 },
-              "duration": { "type": "number", "exclusiveMinimum": 0 },
-              "role": { "type": "string" },
-              "coverage": { "enum": ["media", "html_overlay", "caption_only", "blank_background", "audio_only"] },
-              "notes": { "type": "string" }
-            },
-            "additionalProperties": false
-          }
-        }
-      },
-      "additionalProperties": false
-    },
-    "layer_decomposition": {
-      "type": "object",
-      "required": ["composition_id", "background_color", "layers"],
-      "properties": {
-        "composition_id": { "type": "string" },
-        "background_color": { "type": "string" },
-        "layers": {
-          "type": "array",
-          "items": { "$ref": "#/$defs/layer" }
-        },
-        "track_policy": {
-          "type": "object",
-          "properties": {
-            "collision_free_by_default": { "type": "boolean" },
-            "composited_tracks": { "type": "array", "items": { "type": "integer" } }
-          },
-          "additionalProperties": false
-        }
-      },
-      "additionalProperties": false
-    },
-    "caption_system": {
-      "type": "object",
-      "required": ["surfaces", "default_style"],
-      "properties": {
-        "surfaces": {
-          "type": "array",
-          "items": {
-            "type": "object",
-            "required": ["id", "layer_ids", "placement", "safe_area_notes"],
-            "properties": {
-              "id": { "type": "string" },
-              "layer_ids": { "type": "array", "items": { "type": "string" } },
-              "placement": { "$ref": "#/$defs/geometry" },
-              "safe_area_notes": { "type": "string" },
-              "wrap_rules": { "type": "array", "items": { "type": "string" } }
-            },
-            "additionalProperties": false
-          }
-        },
-        "default_style": { "$ref": "#/$defs/textStyle" }
-      },
-      "additionalProperties": false
-    },
-    "lambda_memory_estimate": { "$ref": "#/$defs/lambdaMemoryEstimate" },
-    "deployment": {
-      "type": "object",
-      "required": ["stack_name", "region", "site_strategy", "output_url_policy"],
-      "properties": {
-        "stack_name": { "type": "string" },
-        "region": { "type": "string" },
-        "site_strategy": { "enum": ["pre_stage_site", "stage_on_publish", "manual"] },
-        "output_url_policy": { "enum": ["signed_https_final_output_only"] },
-        "render_defaults": {
-          "type": "object",
-          "properties": {
-            "width": { "type": "integer", "minimum": 1 },
-            "height": { "type": "integer", "minimum": 1 },
-            "fps": { "type": "number", "minimum": 1 }
-          },
-          "additionalProperties": false
-        }
-      },
-      "additionalProperties": false
-    },
-    "validation": {
-      "type": "object",
-      "required": ["checks"],
-      "properties": {
-        "checks": { "type": "array", "items": { "type": "string" } },
-        "known_risks": { "type": "array", "items": { "type": "string" } }
-      },
-      "additionalProperties": false
-    }
-  },
-  "additionalProperties": false,
-  "$defs": {
-    "sourceAsset": {
-      "type": "object",
-      "required": ["id", "type", "path"],
-      "properties": {
-        "id": { "type": "string" },
-        "type": { "enum": ["video", "image", "audio", "font", "json", "html"] },
-        "path": { "type": "string" },
-        "width": { "type": "integer", "minimum": 0 },
-        "height": { "type": "integer", "minimum": 0 },
-        "duration_seconds": { "type": "number", "minimum": 0 },
-        "role": { "type": "string" }
-      },
-      "additionalProperties": false
-    },
-    "geometry": {
-      "type": "object",
-      "required": ["x", "y", "width", "height"],
-      "properties": {
-        "x": { "type": "number" },
-        "y": { "type": "number" },
-        "width": { "type": "number", "exclusiveMinimum": 0 },
-        "height": { "type": "number", "exclusiveMinimum": 0 },
-        "unit": { "const": "percent" }
-      },
-      "additionalProperties": false
-    },
-    "safeAreas": {
-      "type": "object",
-      "properties": {
-        "top_percent": { "type": "number", "minimum": 0 },
-        "right_percent": { "type": "number", "minimum": 0 },
-        "bottom_percent": { "type": "number", "minimum": 0 },
-        "left_percent": { "type": "number", "minimum": 0 },
-        "notes": { "type": "array", "items": { "type": "string" } }
-      },
-      "additionalProperties": false
-    },
-    "textStyle": {
-      "type": "object",
-      "properties": {
-        "font_family": { "type": "string" },
-        "font_weight": { "type": "integer" },
-        "font_size_px": { "type": "number" },
-        "line_height": { "type": "number" },
-        "color": { "type": "string" },
-        "background": { "type": "string" },
-        "background_style": { "enum": ["plain", "outline", "radial_halo", "highlight_solid", "highlight_translucent", "panel"] },
-        "text_align": { "enum": ["left", "center", "right"] },
-        "max_lines": { "type": "integer", "minimum": 1 }
-      },
-      "additionalProperties": false
-    },
-    "layer": {
-      "type": "object",
-      "required": ["id", "kind", "start", "duration", "track", "z", "mode", "source_of_truth", "geometry", "viral_alignment"],
-      "properties": {
-        "id": { "type": "string" },
-        "kind": { "enum": ["video", "image", "audio", "caption", "html", "shape", "effect"] },
-        "start": { "type": "number", "minimum": 0 },
-        "duration": { "type": "number", "exclusiveMinimum": 0 },
-        "track": { "type": "integer", "minimum": 0 },
-        "z": { "type": "integer" },
-        "mode": { "enum": ["both", "editor", "publish"] },
-        "source_of_truth": { "enum": ["source_media", "deterministic_html", "generated_asset", "user_asset", "computed_effect"] },
-        "geometry": { "$ref": "#/$defs/geometry" },
-        "media": {
-          "type": "object",
-          "properties": {
-            "src": { "type": "string" },
-            "asset_id": { "type": "string" },
-            "media_start": { "type": "number", "minimum": 0 },
-            "media_end": { "type": "number", "minimum": 0 },
-            "fit": { "enum": ["cover", "contain", "fill", "none"] },
-            "muted": { "type": "boolean" },
-            "volume": { "type": "number", "minimum": 0 }
-          },
-          "additionalProperties": false
-        },
-        "text": {
-          "type": "object",
-          "properties": {
-            "content": { "type": "string" },
-            "style": { "$ref": "#/$defs/textStyle" }
-          },
-          "additionalProperties": false
-        },
-        "html_contract": {
-          "type": "object",
-          "properties": {
-            "description": { "type": "string" },
-            "required_classes": { "type": "array", "items": { "type": "string" } },
-            "editable_fields": { "type": "array", "items": { "type": "string" } }
-          },
-          "additionalProperties": false
-        },
-        "viral_alignment": { "type": "string" },
-        "publish_notes": { "type": "string" }
-      },
-      "additionalProperties": false
-    },
-    "lambdaMemoryEstimate": {
-      "type": "object",
-      "required": ["recommended_memory_mb", "confidence", "complexity_scores", "rationale", "risk_flags"],
-      "properties": {
-        "recommended_memory_mb": { "enum": [2048, 3072, 4096, 6144, 8192, 10240] },
-        "confidence": { "enum": ["low", "medium", "high"] },
-        "complexity_scores": { "type": "object", "additionalProperties": { "type": ["number", "integer", "string", "boolean"] } },
-        "rationale": { "type": "string" },
-        "risk_flags": { "type": "array", "items": { "type": "string" } },
-        "benchmark_override": {
-          "type": ["object", "null"],
-          "properties": {
-            "memory_mb": { "enum": [2048, 3072, 4096, 6144, 8192, 10240] },
-            "reason": { "type": "string" }
-          },
-          "additionalProperties": false
-        }
-      },
-      "additionalProperties": false
-    }
-  }
-}

package/auto-create-hyperframe-templates/runbook.md

@@ -1,198 +0,0 @@
-# Auto-Create HyperFrame Template Runbook
-
-Use this runbook when a simple MP4 or slideshow should become an editable HyperFrames composition and production Lambda site.
-
-## 1. Create A Run Folder
-
-```bash
-RUN_ID="<format-slug>-$(date -u +%Y%m%dT%H%M%SZ)"
-mkdir -p "auto-create-hyperframe-templates/runs/${RUN_ID}"/{source,frames,audio,transcripts,ocr,motion,extraction,plan,output}
-```
-
-Copy source media and notes into `source/`.
-
-If running through automation, create `manifest.json` matching `input-manifest.schema.json` before copying media:
-
-```json
-{
-  "mode": "autocreate-hyperframe-template",
-  "input_path": "drafts/example/preview/source.mp4",
-  "output_path": "drafts/example",
-  "slug_id": "example",
-  "source_mode": "auto",
-  "render_defaults": {
-    "width": 720,
-    "height": 1280,
-    "fps": 30
-  },
-  "lambda": {
-    "stack_name": "hyperframes-vidfarm-prod",
-    "region": "us-east-1",
-    "memory_strategy": "estimate"
-  },
-  "publish": {
-    "prestage_site": false,
-    "output_url_policy": "signed_https_final_output_only"
-  }
-}
-```
-
-## 2. Extract Media Artifacts
-
-For MP4:
-
-```bash
-ffprobe -v error -show_entries format=duration:stream=codec_type,width,height,avg_frame_rate -of json source/source.mp4 \
-  > "auto-create-hyperframe-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-hyperframe-templates/runs/${RUN_ID}/frames/contact-sheet.jpg"
-
-ffmpeg -y -i source/source.mp4 \
-  -vn -ac 1 -ar 16000 "auto-create-hyperframe-templates/runs/${RUN_ID}/audio/source.wav"
-```
-
-For slideshows, probe each image and create a contact sheet:
-
-```bash
-ffprobe -v error -show_entries stream=width,height -of json source/slide-01.png \
-  > "auto-create-hyperframe-templates/runs/${RUN_ID}/source/slide-01.ffprobe.json"
-```
-
-Add scene detection, OCR, STT, and layout/subject-region detection with whichever local or provider tool is available. The important part is to write concrete timing, text, and bounding boxes into the run folder before planning.
-
-## 3. Decide Source Mode
-
-Classify the input:
-
-- `single_video`: one MP4 drives the full timeline
-- `scene_split_video`: one MP4 should be split into editable timed scene clips
-- `slideshow`: images become timed slides
-- `mixed_media`: video, images, audio, and HTML overlays need explicit composition
-
-Record whether source media contains baked text that should be extracted as deterministic captions/HTML overlays.
-
-## 4. Generate Production Graph
-
-Send `extractor-system-prompt.md`, source notes, artifacts, contact sheet, transcript, OCR, and scene cuts to a multimodal model.
-
-Write:
-
-```txt
-auto-create-hyperframe-templates/runs/<run_id>/extraction/production_graph.json
-```
-
-Validate against:
-
-```txt
-auto-create-hyperframe-templates/production-graph.schema.json
-```
-
-## 5. Generate HyperFrame Template Plan
-
-Send `template-planner-prompt.md` plus `production_graph.json`.
-
-Write:
-
-```txt
-auto-create-hyperframe-templates/runs/<run_id>/plan/template_plan.json
-```
-
-Validate against:
-
-```txt
-auto-create-hyperframe-templates/template-plan.schema.json
-```
-
-## 6. Write Composition Artifacts
-
-Create or update the target source folder:
-
-```txt
-drafts/<format_slug>/
-  composition.html
-  composition.json
-  lambda-site.json
-```
-
-For simple MP4/slideshow inputs, the local bridge can do this step directly:
-
-```bash
-node auto-create-hyperframe-templates/scripts/create-hyperframe-template.mjs drafts/<format_slug>/preview/source.mp4
-node auto-create-hyperframe-templates/scripts/create-hyperframe-template.mjs drafts/<format_slug>/preview --stage-site
-```
-
-Implementation order:
-
-1. write `composition.json` from `template_plan.layers`
-2. write `composition.html` from the same layer manifest
-3. include root `data-composition-id`, `data-width`, `data-height`, `data-duration`, and `data-source-folder`
-4. write `lambda-site.json` with stack, region, memory, render defaults, and site upload status
-5. run local editor smoke test
-
-## 7. HyperFrames Layer Rules
-
-Use these data attributes in `composition.html`:
-
-- `data-hf-id`
-- `data-layer-kind`
-- `data-layer-mode`
-- `data-start`
-- `data-duration`
-- `data-track-index`
-- `data-label`
-- `data-media-start` for timed media slices
-- `data-playback-start` for editor/publish compatibility
-- `data-src` when using a timeline proxy
-
-For video scene clips, prefer timed real `<video>` elements or a timeline proxy that publish normalization rewrites into a real `<video>`. A preview-only `data-vf-playback-source` may help editor scrubbing, but it must not be the publish source of truth.
-
-## 8. Estimate Lambda Memory
-
-Use `lambda-memory-estimator.md`.
-
-Recommended baseline:
-
-- `2048` MB: static images, simple slideshows, minimal HTML, no video decode pressure
-- `3072` MB: default for vertical social video with one decoded video stream and deterministic overlays
-- `4096` MB: 1080p video, multiple streams, heavy captions, large shadows, masks, or long audio
-- `6144+` MB: high-resolution, many active layers, complex filters, or measured failures
-
-Write both the recommendation and the reasoning into `composition.json` and `lambda-site.json`.
-
-## 9. Stage Production Lambda Site
-
-After the project folder is valid, pre-stage it for repeat publishing:
-
-```bash
-hyperframes lambda sites create drafts/<format_slug> \
-  --stack-name hyperframes-vidfarm-prod \
-  --region us-east-1
-```
-
-If using the SDK or demo API instead of the CLI, write the returned content-addressed site id into `lambda-site.json`.
-
-The frontend should show the final signed output URL after publish. Do not expose S3 Console or Step Functions Console links as user-facing CTAs.
-
-## 10. Validate Publish
-
-Run one local render and one Lambda publish:
-
-```bash
-hyperframes lambda render drafts/<format_slug> \
-  --stack-name hyperframes-vidfarm-prod \
-  --region us-east-1 \
-  --site-id <site_id> \
-  --width 720 \
-  --height 1280 \
-  --wait
-```
-
-Check:
-
-- final output reflects deleted/hidden scene layers
-- caption timing matches the editor timeline
-- blank gaps remain blank when no media layer covers them
-- audio does not silently disappear after scene splitting
-- output URL is accessible without AWS Console login when surfaced in the product