initial code (#2)

* feat: initial code port from hyperframes-internal

Port all OSS-ready packages from the internal monorepo:
- @hyperframes/core — shared types, HTML generation, GSAP utilities, runtime
- @hyperframes/cli — CLI for creating, previewing, and rendering compositions
- @hyperframes/engine — framework-agnostic rendering engine (BeginFrame + FFmpeg)
- @hyperframes/producer — video rendering pipeline (Puppeteer + FFmpeg)
- @hyperframes/ui-player — browser-based video player component
- @hyperframes/studio — composition editor (React frontend + Hono backend)

Includes regression test suite with Docker-based test harness.

All HeyGen-internal references, deployment infrastructure, and
proprietary assets have been removed. Package names migrated
from @app/* to @hyperframes/*.

Co-Authored-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com>

* fix: scrub internal codenames and stale references from OSS port

- Replace static.heygen.ai runtime URLs in test fixtures
- Remove internal CDN publish script (publish-hyperframe-runtime.ts)
- Replace sandbox-studio, sandbox-interceptor, __magicEditRuntime
  with neutral names (studio, hyperframe-runtime, __hyperframeRuntime)
- Fix stale Vault API / localhost references in docs
- Remove broken deprecated_studio link

Co-Authored-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com>

* fix: remove remaining internal codenames and stale references

- Delete stale producer README.md and PIPELINE.md (referenced nonexistent files)
- Replace "Cerberus" codename with "HyperFrames" in test design reviews
- Replace magic-edit postMessage identifiers with hf-preview/hf-parent
- Rename debug-magic-edit-timeline.ts to debug-timeline.ts
- Replace "Motion Cut" with "HyperFrames" in Timeline comments
- Fix studio/CLI references to nonexistent archive package
  (use local data/projects/ dir, stub render proxy)

Co-Authored-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com>

---------

Co-authored-by: Claude Opus 4.6 (1M context) <noreply@anthropic.com>

packages/engine/src/utils/gpuEncoder.ts

@@ -0,0 +1,58 @@
+/**
+ * GPU Encoder Detection
+ *
+ * Shared GPU encoder detection and naming utilities used by both
+ * chunkEncoder and streamingEncoder services.
+ */
+
+import { spawn } from "child_process";
+
+export type GpuEncoder = "nvenc" | "videotoolbox" | "vaapi" | "qsv" | null;
+
+export async function detectGpuEncoder(): Promise<GpuEncoder> {
+  return new Promise((resolve) => {
+    const ffmpeg = spawn("ffmpeg", ["-encoders"], {
+      stdio: ["pipe", "pipe", "pipe"],
+    });
+    let stdout = "";
+
+    ffmpeg.stdout.on("data", (data) => {
+      stdout += data.toString();
+    });
+
+    ffmpeg.on("close", () => {
+      if (stdout.includes("h264_nvenc")) resolve("nvenc");
+      else if (stdout.includes("h264_videotoolbox")) resolve("videotoolbox");
+      else if (stdout.includes("h264_vaapi")) resolve("vaapi");
+      else if (stdout.includes("h264_qsv")) resolve("qsv");
+      else resolve(null);
+    });
+
+    ffmpeg.on("error", () => resolve(null));
+  });
+}
+
+let cachedGpuEncoder: GpuEncoder | undefined = undefined;
+
+export async function getCachedGpuEncoder(): Promise<GpuEncoder> {
+  if (cachedGpuEncoder === undefined) {
+    cachedGpuEncoder = await detectGpuEncoder();
+  }
+  return cachedGpuEncoder;
+}
+
+export function getGpuEncoderName(encoder: GpuEncoder, codec: "h264" | "h265"): string {
+  if (!encoder) return codec === "h264" ? "libx264" : "libx265";
+  switch (encoder) {
+    case "nvenc":
+      return codec === "h264" ? "h264_nvenc" : "hevc_nvenc";
+    case "videotoolbox":
+      return codec === "h264" ? "h264_videotoolbox" : "hevc_videotoolbox";
+    case "vaapi":
+      return codec === "h264" ? "h264_vaapi" : "hevc_vaapi";
+    case "qsv":
+      return codec === "h264" ? "h264_qsv" : "hevc_qsv";
+    default:
+      return codec === "h264" ? "libx264" : "libx265";
+  }
+}