hyper-animator-codex 0.7.1 → 0.8.0

package/skills/hyper-animator-codex/references/beat-sync-workflow.md

@@ -31,6 +31,13 @@ MP3/M4A/AAC/WMA require system `ffmpeg`; WAV/FLAC/OGG are safer.
 ## Map Beats To Animation
 
 - Use `meta.bpm` for global pacing.
+- Read `meta.beat_grid`. It is a least-squares fit over all detected beat
+  timestamps, with `phase_ms`, `period_ms`, `max_residual_ms`, and
+  `rms_residual_ms`.
+- A global beat grid is reliable only when `meta.beat_grid.reliable` is true
+  (`max_residual_ms <= 15`). If false, keep using the explicit `beats[]`
+  timestamps, split the music into locally stable sections, and flag the
+  timing for review instead of forcing one BPM across the track.
 - Use beats with `beat_in_bar: 1` for major scene changes, title reveals, camera moves, and transitions.
 - Use `energy_level: strong` for visual accents, scale pulses, light sweeps, flashes, or cut emphasis.
 - Use weak beats for secondary motion only.

package/skills/hyper-animator-codex/references/examples/shot-plan-dual-catalog.json

@@ -0,0 +1,69 @@
+{
+  "schema_version": "1.0.0",
+  "generation_mode": "generate_new_hyperframes_html",
+  "catalog_strategy": "dual_catalog",
+  "dimensions": {
+    "width": 1920,
+    "height": 1080
+  },
+  "duration_seconds": 12,
+  "audio": {
+    "narration": {
+      "mode": "generated",
+      "provider": "minimax_cn"
+    },
+    "bgm": {
+      "mode": "generated",
+      "provider": "minimax_cn"
+    }
+  },
+  "model_routing": {
+    "page_animation_authoring": "gpt-5.6-sol",
+    "planning_and_validation": "gpt-5.6-terra"
+  },
+  "shots": [
+    {
+      "id": "open",
+      "start_seconds": 0,
+      "end_seconds": 3,
+      "purpose": "Establish the product promise",
+      "hyperframes_refs": [
+        "app-showcase"
+      ],
+      "shotcraft_refs": [
+        "scene-locked-title"
+      ],
+      "narration_scene": "1"
+    },
+    {
+      "id": "proof",
+      "start_seconds": 3,
+      "end_seconds": 8,
+      "purpose": "Show the result and supporting evidence",
+      "hyperframes_refs": [
+        "caption-pill-karaoke"
+      ],
+      "shotcraft_refs": [
+        "ai-stream-response"
+      ],
+      "narration_scene": "2"
+    },
+    {
+      "id": "outro",
+      "start_seconds": 8,
+      "end_seconds": 12,
+      "purpose": "Resolve to brand and call to action",
+      "hyperframes_refs": [
+        "logo-outro"
+      ],
+      "shotcraft_refs": [
+        "ui-strip-away-outro"
+      ],
+      "narration_scene": "3"
+    }
+  ],
+  "assumptions": [
+    "Shot durations will be reconciled with narration-manifest.json after MiniMax generation",
+    "ShotCraft TSX is translated into HyperFrames/GSAP rather than rendered with Remotion"
+  ]
+}

package/skills/hyper-animator-codex/references/hyperframes-agent-pseudocode.ts

@@ -153,7 +153,7 @@ ${bodyParts.join("\n")}
 async function generateNewHyperFramesHtml(plan: FinalPlan, profile: IntentProfile): Promise<string> {
   return generateWithLLM({
     mode: "generate_new_hyperframes_html",
-    patternsReference: "/Users/zhichao/claude/hf-projects/HyperFrames-AI-Generation-Patterns-codex.md",
+    patternsReference: "references/HyperFrames-AI-Generation-Patterns-codex.md",
     requirements: [
       "Generate complete HyperFrames HTML, not just data-composition-src wrapper.",
       "Use fixed data-composition-id, data-width, data-height, data-duration.",