@mevdragon/vidfarm-devcli 0.2.13 → 0.3.0

package/auto-create-hyperframe-templates/scripts/create-hyperframe-template.mjs

@@ -1,368 +0,0 @@
-#!/usr/bin/env node
-import { spawn } from "node:child_process";
-import { cp, copyFile, mkdir, readFile, stat, writeFile } from "node:fs/promises";
-import path from "node:path";
-import { fileURLToPath } from "node:url";
-
-const scriptDir = path.dirname(fileURLToPath(import.meta.url));
-const harnessRoot = path.resolve(scriptDir, "..");
-const repoRoot = path.resolve(harnessRoot, "..");
-const defaultStackName = "hyperframes-vidfarm-prod";
-const defaultRegion = "us-east-1";
-const memoryBuckets = [2048, 3072, 4096, 6144, 8192, 10240];
-const videoExts = new Set([".mp4", ".mov", ".m4v", ".webm"]);
-const imageExts = new Set([".png", ".jpg", ".jpeg", ".webp"]);
-
-const args = process.argv.slice(2);
-const stageSite = args.includes("--stage-site");
-const inputArg = args.find((arg) => !arg.startsWith("--"));
-
-if (!inputArg) {
-  console.error("Usage: node auto-create-hyperframe-templates/scripts/create-hyperframe-template.mjs <media-path|input-manifest.json> [--stage-site]");
-  process.exit(1);
-}
-
-const manifest = await loadInputManifest(inputArg);
-const outputDir = path.resolve(repoRoot, manifest.output_path);
-const decomposeInput = await prepareInputForDecomposer(manifest);
-
-await runCommand(process.execPath, [
-  path.join(repoRoot, "demo", "scripts", "decompose-static.mjs"),
-  path.relative(repoRoot, decomposeInput)
-]);
-
-const decompositionPath = path.join(outputDir, "composition.json");
-const decomposition = JSON.parse(await readFile(decompositionPath, "utf8"));
-const memoryEstimate = estimateLambdaMemory(decomposition, manifest);
-const lambdaSite = await buildLambdaSiteManifest(manifest, outputDir, memoryEstimate, stageSite);
-
-decomposition.schema = "vidfarm.hyperframe-decomposition.v1";
-decomposition.lambda_memory_estimate = memoryEstimate;
-decomposition.lambda_site = lambdaSite;
-
-await writeFile(decompositionPath, `${JSON.stringify(decomposition, null, 2)}\n`);
-await writeFile(path.join(outputDir, "lambda-site.json"), `${JSON.stringify(lambdaSite, null, 2)}\n`);
-
-console.log(`Wrote ${path.relative(repoRoot, path.join(outputDir, "composition.html"))}`);
-console.log(`Wrote ${path.relative(repoRoot, decompositionPath)}`);
-console.log(`Wrote ${path.relative(repoRoot, path.join(outputDir, "lambda-site.json"))}`);
-console.log(`Lambda memory estimate: ${memoryEstimate.recommended_memory_mb} MB (${memoryEstimate.confidence} confidence)`);
-if (lambdaSite.site_id) {
-  console.log(`Lambda site id: ${lambdaSite.site_id}`);
-}
-
-async function loadInputManifest(input) {
-  const inputPath = path.resolve(repoRoot, input);
-  const inputStats = await stat(inputPath);
-  if (inputStats.isFile() && path.extname(inputPath).toLowerCase() === ".json") {
-    const parsed = JSON.parse(await readFile(inputPath, "utf8"));
-    if (parsed.mode === "autocreate-hyperframe-template") {
-      return normalizeManifest(parsed, inputPath);
-    }
-  }
-
-  const outputPath = inputStats.isDirectory() ? inputPath : path.dirname(inputPath);
-  return normalizeManifest({
-    mode: "autocreate-hyperframe-template",
-    input_path: path.relative(repoRoot, inputPath),
-    output_path: path.relative(repoRoot, outputPath),
-    slug_id: path.basename(outputPath),
-    source_mode: "auto",
-    render_defaults: {
-      width: 720,
-      height: 1280,
-      fps: 30
-    },
-    lambda: {
-      stack_name: defaultStackName,
-      region: defaultRegion,
-      memory_strategy: "estimate"
-    },
-    publish: {
-      prestage_site: false,
-      output_url_policy: "signed_https_final_output_only"
-    }
-  }, inputPath);
-}
-
-function normalizeManifest(manifest, manifestPath) {
-  if (manifest.mode !== "autocreate-hyperframe-template") {
-    throw new Error(`Invalid manifest mode in ${manifestPath}`);
-  }
-  return {
-    ...manifest,
-    output_path: manifest.output_path || path.dirname(manifest.input_path),
-    source_mode: manifest.source_mode || "auto",
-    render_defaults: {
-      width: Number(manifest.render_defaults?.width || 720),
-      height: Number(manifest.render_defaults?.height || 1280),
-      fps: Number(manifest.render_defaults?.fps || 30)
-    },
-    lambda: {
-      stack_name: manifest.lambda?.stack_name || defaultStackName,
-      region: manifest.lambda?.region || defaultRegion,
-      memory_strategy: manifest.lambda?.memory_strategy || "estimate",
-      fixed_memory_mb: manifest.lambda?.fixed_memory_mb
-    },
-    publish: {
-      prestage_site: Boolean(manifest.publish?.prestage_site),
-      output_url_policy: "signed_https_final_output_only"
-    }
-  };
-}
-
-async function prepareInputForDecomposer(manifest) {
-  const inputPath = path.resolve(repoRoot, manifest.input_path);
-  const outputPath = path.resolve(repoRoot, manifest.output_path);
-  const inputStats = await stat(inputPath);
-
-  if (inputStats.isDirectory()) {
-    if (path.resolve(inputPath) !== path.resolve(outputPath)) {
-      await mkdir(outputPath, { recursive: true });
-      await cp(inputPath, outputPath, { recursive: true, force: true });
-      return outputPath;
-    }
-    return inputPath;
-  }
-
-  const ext = path.extname(inputPath).toLowerCase();
-  if (!videoExts.has(ext) && !imageExts.has(ext)) {
-    throw new Error(`Unsupported input media: ${inputPath}`);
-  }
-
-  if (path.resolve(path.dirname(inputPath)) !== path.resolve(outputPath)) {
-    await mkdir(outputPath, { recursive: true });
-    const target = path.join(outputPath, path.basename(inputPath));
-    await copyFile(inputPath, target);
-    return target;
-  }
-
-  return inputPath;
-}
-
-function estimateLambdaMemory(decomposition, manifest) {
-  const renderDefaults = manifest.render_defaults;
-  const layers = Array.isArray(decomposition.editor_layers) ? decomposition.editor_layers : [];
-  const assets = Array.isArray(decomposition.source_assets) ? decomposition.source_assets : [];
-  const firstAsset = assets[0] || {};
-  const width = Number(renderDefaults?.width || firstAsset.width || 720);
-  const height = Number(renderDefaults?.height || firstAsset.height || 1280);
-  const outputPixels = width * height;
-  const durationSeconds = layers.reduce((max, layer) => {
-    return Math.max(max, Number(layer.start || 0) + Number(layer.duration || 0));
-  }, Number(firstAsset.duration || firstAsset.duration_seconds || 0));
-  const videoLayers = layers.filter((layer) => layer.type === "video" || layer.kind === "video");
-  const audioLayers = layers.filter((layer) => layer.type === "audio" || layer.kind === "audio");
-  const textLayers = layers.filter((layer) => ["caption", "text", "shape", "html"].includes(layer.type || layer.kind));
-  const uniqueVideoSources = new Set(videoLayers.map((layer) => layer.src || layer.media?.src).filter(Boolean));
-  const maxSimultaneousVideos = maxOverlap(videoLayers);
-
-  const outputPixelScoreMb = outputPixels <= 1_000_000 ? 0 : outputPixels <= 2_100_000 ? 512 : outputPixels <= 4_000_000 ? 1024 : 2048;
-  let mediaScoreMb = 0;
-  if (videoLayers.length > 0 || assets.some((asset) => asset.type === "video")) {
-    mediaScoreMb += 768;
-    mediaScoreMb += Math.max(0, maxSimultaneousVideos - 1) * 512;
-    mediaScoreMb += Math.max(0, uniqueVideoSources.size - 1) * 256;
-    if (assets.some((asset) => Number(asset.width || 0) * Number(asset.height || 0) > outputPixels * 1.75)) {
-      mediaScoreMb += 512;
-    }
-  }
-
-  let domCaptionScoreMb = layers.length <= 10 ? 0 : layers.length <= 30 ? 256 : 512;
-  if (textLayers.length >= 4) domCaptionScoreMb += 256;
-  if (textLayers.some((layer) => String(layer.textBackgroundStyle || layer.background_style || "").includes("highlight"))) {
-    domCaptionScoreMb += 256;
-  }
-
-  let effectScoreMb = 0;
-  if (textLayers.some((layer) => ["outline", "radial_halo"].includes(layer.textBackgroundStyle || layer.background_style))) {
-    effectScoreMb += 256;
-  }
-  if (layers.some((layer) => layer.filter || layer.mask || layer.mixBlendMode || layer.blur)) {
-    effectScoreMb += 512;
-  }
-
-  let durationAudioScoreMb = durationSeconds <= 30 ? 0 : durationSeconds <= 60 ? 256 : durationSeconds <= 180 ? 512 : 1024;
-  if (audioLayers.length > 0 || assets.some((asset) => asset.type === "audio" || asset.type === "video")) {
-    durationAudioScoreMb += 256;
-  }
-  if (audioLayers.length > 1) durationAudioScoreMb += 256;
-
-  const rawEstimateMb = 1536 + outputPixelScoreMb + mediaScoreMb + domCaptionScoreMb + effectScoreMb + durationAudioScoreMb;
-  let roundedBucketMb = memoryBuckets.find((bucket) => bucket >= rawEstimateMb) || 10240;
-  if (videoLayers.length === 0 && !assets.some((asset) => asset.type === "video")) {
-    roundedBucketMb = Math.min(roundedBucketMb, 2048);
-  }
-  if ((videoLayers.length > 0 || assets.some((asset) => asset.type === "video")) && maxSimultaneousVideos <= 1 && roundedBucketMb < 3072) {
-    roundedBucketMb = 3072;
-  }
-  if (roundedBucketMb > 4096 && rawEstimateMb < 6144) {
-    roundedBucketMb = 4096;
-  }
-  const fixedMemory = manifest.lambda?.memory_strategy === "fixed"
-    ? Number(manifest.lambda?.fixed_memory_mb || 0)
-    : 0;
-  const recommendedMemoryMb = memoryBuckets.includes(fixedMemory) ? fixedMemory : roundedBucketMb;
-  const estimatedBilledSeconds = estimateBilledSeconds(durationSeconds, layers.length, videoLayers.length);
-  const estimatedLambdaGbSeconds = (recommendedMemoryMb / 1024) * estimatedBilledSeconds;
-  const estimatedCostUsd = estimatedLambdaGbSeconds * 0.0000166667 + 40 * 0.000025;
-
-  const riskFlags = [];
-  if (videoLayers.length > 0 || assets.some((asset) => asset.type === "video")) riskFlags.push("source_video_decode");
-  if (maxSimultaneousVideos > 1) riskFlags.push("multiple_simultaneous_video_streams");
-  if (textLayers.length >= 4) riskFlags.push("caption_or_html_overlay_density");
-  if (audioLayers.length > 0 || assets.some((asset) => asset.type === "video")) riskFlags.push("continuous_audio");
-  if (outputPixels > 2_100_000) riskFlags.push("high_output_resolution");
-
-  return {
-    recommended_memory_mb: recommendedMemoryMb,
-    confidence: riskFlags.length >= 3 ? "medium" : "high",
-    complexity_scores: {
-      output_pixels: outputPixels,
-      output_pixel_score_mb: outputPixelScoreMb,
-      max_simultaneous_video_streams: maxSimultaneousVideos,
-      unique_video_sources: uniqueVideoSources.size,
-      media_score_mb: mediaScoreMb,
-      layer_count: layers.length,
-      text_layer_count: textLayers.length,
-      dom_caption_score_mb: domCaptionScoreMb,
-      effect_score_mb: effectScoreMb,
-      duration_seconds: Number(durationSeconds.toFixed(3)),
-      duration_audio_score_mb: durationAudioScoreMb,
-      raw_estimate_mb: rawEstimateMb,
-      rounded_bucket_mb: roundedBucketMb,
-      estimated_billed_seconds: estimatedBilledSeconds
-    },
-    risk_flags: riskFlags,
-    rationale: rationaleForEstimate(recommendedMemoryMb, maxSimultaneousVideos, videoLayers.length, outputPixels, textLayers.length),
-    benchmark_override: null,
-    estimated_lambda_gb_seconds: Number(estimatedLambdaGbSeconds.toFixed(3)),
-    estimated_cost_usd: Number(estimatedCostUsd.toFixed(4))
-  };
-}
-
-function maxOverlap(layers) {
-  if (layers.length === 0) return 0;
-  const points = [];
-  for (const layer of layers) {
-    const start = Number(layer.start || 0);
-    const end = start + Number(layer.duration || 0);
-    if (end > start) {
-      points.push(start + (end - start) / 2);
-      points.push(start + 0.001);
-    }
-  }
-  return points.reduce((max, point) => {
-    const active = layers.filter((layer) => {
-      const start = Number(layer.start || 0);
-      const end = start + Number(layer.duration || 0);
-      return point >= start && point < end;
-    }).length;
-    return Math.max(max, active);
-  }, 0);
-}
-
-function estimateBilledSeconds(durationSeconds, layerCount, videoLayerCount) {
-  const base = videoLayerCount > 0 ? 90 : 20;
-  const durationFactor = durationSeconds * (videoLayerCount > 0 ? 8 : 4);
-  const layerFactor = layerCount * 2;
-  return Math.ceil(Math.max(base, durationFactor + layerFactor));
-}
-
-function rationaleForEstimate(memoryMb, maxVideos, videoLayerCount, outputPixels, textLayerCount) {
-  if (videoLayerCount === 0) {
-    return "No active video decode pressure; simple static/slideshow output fits the 2GB bucket.";
-  }
-  if (memoryMb === 3072) {
-    return "One active social-video stream with deterministic overlays fits the measured 3GB production baseline.";
-  }
-  if (memoryMb === 4096) {
-    return `Raised to 4GB for ${maxVideos} simultaneous video stream(s), ${Math.round(outputPixels / 1_000_000 * 10) / 10}MP output, and ${textLayerCount} text/html layer(s).`;
-  }
-  return "Raised above 4GB because composition complexity crosses the normal social-video range.";
-}
-
-async function buildLambdaSiteManifest(manifest, outputDir, memoryEstimate, shouldStageSite) {
-  const relativeOutput = path.relative(repoRoot, outputDir);
-  const stackName = manifest.lambda.stack_name || defaultStackName;
-  const region = manifest.lambda.region || defaultRegion;
-  const siteUploadCommand = `demo/node_modules/.bin/hyperframes lambda sites create ${shellQuote(relativeOutput)} --stack-name ${shellQuote(stackName)} --region ${shellQuote(region)}`;
-  const site = {
-    schema: "vidfarm.hyperframe.lambda-site.v1",
-    stack_name: stackName,
-    region,
-    site_id: null,
-    project_dir: relativeOutput,
-    composition_file: "composition.html",
-    memory_mb: memoryEstimate.recommended_memory_mb,
-    render_defaults: manifest.render_defaults,
-    output_url_policy: "signed_https_final_output_only",
-    prestage_site_requested: Boolean(manifest.publish?.prestage_site),
-    site_upload_command: siteUploadCommand,
-    estimated_lambda_gb_seconds: memoryEstimate.estimated_lambda_gb_seconds,
-    estimated_cost_usd: memoryEstimate.estimated_cost_usd
-  };
-
-  if (!shouldStageSite) {
-    return site;
-  }
-
-  try {
-    const hyperframesBin = path.join(repoRoot, "demo", "node_modules", ".bin", "hyperframes");
-    const stdout = await runCommand(hyperframesBin, [
-      "lambda",
-      "sites",
-      "create",
-      relativeOutput,
-      "--stack-name",
-      stackName,
-      "--region",
-      region
-    ]);
-    site.site_id = parseSiteId(stdout);
-    site.site_upload_stdout = stdout.trim();
-  } catch (error) {
-    site.site_upload_error = error instanceof Error ? error.message : String(error);
-  }
-
-  return site;
-}
-
-function parseSiteId(stdout) {
-  const text = String(stdout || "");
-  const labeled = text.match(/Site ID:\s*([A-Za-z0-9_-]+)/i);
-  if (labeled) return labeled[1];
-  const generic = text.match(/\b([a-f0-9]{12,64}|[A-Za-z0-9_-]{12,64})\b/);
-  return generic ? generic[1] : null;
-}
-
-function runCommand(command, commandArgs) {
-  return new Promise((resolve, reject) => {
-    const child = spawn(command, commandArgs, {
-      cwd: repoRoot,
-      env: process.env,
-      stdio: ["ignore", "pipe", "pipe"]
-    });
-    let stdout = "";
-    let stderr = "";
-    child.stdout.on("data", (chunk) => {
-      stdout += String(chunk);
-      process.stdout.write(chunk);
-    });
-    child.stderr.on("data", (chunk) => {
-      stderr += String(chunk);
-      process.stderr.write(chunk);
-    });
-    child.on("error", reject);
-    child.on("close", (code) => {
-      if (code === 0) resolve(stdout);
-      else reject(new Error(`${command} exited ${code}: ${stderr}`));
-    });
-  });
-}
-
-function shellQuote(value) {
-  const text = String(value);
-  if (/^[A-Za-z0-9_./:=@-]+$/.test(text)) return text;
-  return `'${text.replaceAll("'", "'\\''")}'`;
-}

package/auto-create-hyperframe-templates/template-plan.schema.json

@@ -1,311 +0,0 @@
-{
-  "$schema": "https://json-schema.org/draft/2020-12/schema",
-  "title": "HyperFrame Template Plan",
-  "type": "object",
-  "required": [
-    "template",
-    "composition",
-    "source_assets",
-    "layers",
-    "caption_layout",
-    "editor_behavior",
-    "lambda",
-    "deployment",
-    "artifacts",
-    "validation",
-    "implementation_files"
-  ],
-  "properties": {
-    "template": {
-      "type": "object",
-      "required": ["slug_id", "title", "description", "source_folder", "source_type"],
-      "properties": {
-        "slug_id": { "type": "string" },
-        "title": { "type": "string" },
-        "description": { "type": "string" },
-        "source_folder": { "type": "string" },
-        "source_type": { "enum": ["single_video", "scene_split_video", "slideshow", "mixed_media"] },
-        "viral_dna": { "type": "object" },
-        "visual_dna": { "type": "object" }
-      },
-      "additionalProperties": false
-    },
-    "composition": {
-      "type": "object",
-      "required": ["composition_id", "width", "height", "fps", "duration_seconds", "background_color", "root_attributes"],
-      "properties": {
-        "composition_id": { "type": "string" },
-        "width": { "type": "integer", "minimum": 1 },
-        "height": { "type": "integer", "minimum": 1 },
-        "fps": { "type": "number", "minimum": 1 },
-        "duration_seconds": { "type": "number", "minimum": 0 },
-        "background_color": { "type": "string" },
-        "root_attributes": {
-          "type": "array",
-          "items": { "type": "string" }
-        }
-      },
-      "additionalProperties": false
-    },
-    "source_assets": {
-      "type": "array",
-      "items": { "$ref": "#/$defs/sourceAsset" }
-    },
-    "layers": {
-      "type": "array",
-      "items": { "$ref": "#/$defs/layer" }
-    },
-    "caption_layout": {
-      "type": "object",
-      "required": ["safe_areas", "default_style", "surfaces", "rules"],
-      "properties": {
-        "safe_areas": { "$ref": "#/$defs/safeAreas" },
-        "default_style": { "$ref": "#/$defs/textStyle" },
-        "surfaces": {
-          "type": "array",
-          "items": {
-            "type": "object",
-            "required": ["id", "layer_ids", "geometry", "rules"],
-            "properties": {
-              "id": { "type": "string" },
-              "layer_ids": { "type": "array", "items": { "type": "string" } },
-              "geometry": { "$ref": "#/$defs/geometry" },
-              "rules": { "type": "array", "items": { "type": "string" } }
-            },
-            "additionalProperties": false
-          }
-        },
-        "rules": { "type": "array", "items": { "type": "string" } }
-      },
-      "additionalProperties": false
-    },
-    "editor_behavior": {
-      "type": "object",
-      "required": ["publish_source_of_truth", "track_collision_policy", "delete_scene_test"],
-      "properties": {
-        "publish_source_of_truth": { "type": "string" },
-        "preview_playback_source_allowed": { "type": "boolean" },
-        "track_collision_policy": { "type": "string" },
-        "delete_scene_test": { "type": "string" }
-      },
-      "additionalProperties": false
-    },
-    "lambda": {
-      "type": "object",
-      "required": ["memory_estimate", "render_defaults"],
-      "properties": {
-        "memory_estimate": { "$ref": "#/$defs/lambdaMemoryEstimate" },
-        "render_defaults": {
-          "type": "object",
-          "required": ["width", "height", "fps"],
-          "properties": {
-            "width": { "type": "integer", "minimum": 1 },
-            "height": { "type": "integer", "minimum": 1 },
-            "fps": { "type": "number", "minimum": 1 }
-          },
-          "additionalProperties": false
-        },
-        "estimated_lambda_gb_seconds": { "type": "number", "minimum": 0 },
-        "estimated_cost_usd": { "type": "number", "minimum": 0 }
-      },
-      "additionalProperties": false
-    },
-    "deployment": {
-      "type": "object",
-      "required": ["prod_lambda_site", "output_url_policy"],
-      "properties": {
-        "prod_lambda_site": {
-          "type": "object",
-          "required": ["schema", "stack_name", "region", "site_id", "project_dir", "composition_file", "memory_mb"],
-          "properties": {
-            "schema": { "const": "vidfarm.hyperframe.lambda-site.v1" },
-            "stack_name": { "type": "string" },
-            "region": { "type": "string" },
-            "site_id": { "type": ["string", "null"] },
-            "project_dir": { "type": "string" },
-            "composition_file": { "type": "string" },
-            "memory_mb": { "enum": [2048, 3072, 4096, 6144, 8192, 10240] },
-            "render_defaults": {
-              "type": "object",
-              "properties": {
-                "width": { "type": "integer", "minimum": 1 },
-                "height": { "type": "integer", "minimum": 1 },
-                "fps": { "type": "number", "minimum": 1 }
-              },
-              "additionalProperties": false
-            },
-            "output_url_policy": { "enum": ["signed_https_final_output_only"] },
-            "prestage_site_requested": { "type": "boolean" },
-            "site_upload_command": { "type": "string" },
-            "site_upload_api": { "type": "string" },
-            "site_upload_stdout": { "type": "string" },
-            "site_upload_error": { "type": "string" },
-            "estimated_lambda_gb_seconds": { "type": "number", "minimum": 0 },
-            "estimated_cost_usd": { "type": "number", "minimum": 0 }
-          },
-          "additionalProperties": false
-        },
-        "output_url_policy": { "enum": ["signed_https_final_output_only"] }
-      },
-      "additionalProperties": false
-    },
-    "artifacts": {
-      "type": "object",
-      "required": ["files", "decomposition_shape", "lambda_site_shape"],
-      "properties": {
-        "files": { "type": "array", "items": { "type": "string" } },
-        "decomposition_shape": { "type": "object" },
-        "lambda_site_shape": { "type": "object" }
-      },
-      "additionalProperties": false
-    },
-    "validation": {
-      "type": "object",
-      "required": ["artifact_checks", "timeline_checks", "publish_checks", "caption_checks", "lambda_checks", "final_output_checks"],
-      "properties": {
-        "artifact_checks": { "type": "array", "items": { "type": "string" } },
-        "timeline_checks": { "type": "array", "items": { "type": "string" } },
-        "publish_checks": { "type": "array", "items": { "type": "string" } },
-        "caption_checks": { "type": "array", "items": { "type": "string" } },
-        "lambda_checks": { "type": "array", "items": { "type": "string" } },
-        "final_output_checks": { "type": "array", "items": { "type": "string" } }
-      },
-      "additionalProperties": false
-    },
-    "implementation_files": {
-      "type": "array",
-      "items": {
-        "type": "object",
-        "required": ["path", "purpose"],
-        "properties": {
-          "path": { "type": "string" },
-          "purpose": { "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
-    }
-  }
-}