fix(pr-to-video): bound first-run workspace and context (#2382)

* fix(pr-to-video): bound first-run workspace and context

* fix(cli): expose validation gate in help

* fix(pr-to-video): harden workflow guardrails

* style(pr-to-video): apply repository formatting

* chore(skills): refresh pr-to-video manifest

skills/pr-to-video/scripts/preflight.mjs

@@ -0,0 +1,38 @@
+#!/usr/bin/env node
+
+import { spawnSync } from "node:child_process";
+import { pathToFileURL } from "node:url";
+
+export function hasCliCommand(helpText, command) {
+  const escaped = command.replace(/[.*+?^${}()|[\]\\]/g, "\\$&");
+  return new RegExp(`^\\s+${escaped}(?:\\s+|$)`, "m").test(String(helpText));
+}
+
+export function runCliPreflight({ command = "check", spawn = spawnSync } = {}) {
+  const result = spawn("npx", ["hyperframes", "--help"], {
+    encoding: "utf8",
+    shell: process.platform === "win32",
+  });
+  const output = `${result.stdout ?? ""}\n${result.stderr ?? ""}`;
+  if (result.status !== 0) {
+    throw new Error(`unable to inspect HyperFrames CLI capabilities\n${output.trim()}`);
+  }
+  if (!hasCliCommand(output, command)) {
+    throw new Error(
+      `the installed HyperFrames CLI does not provide \`${command}\`, but the current pr-to-video skill requires it. Upgrade the CLI before starting frame work.`,
+    );
+  }
+  return true;
+}
+
+function main() {
+  try {
+    runCliPreflight();
+    console.log("✓ pr-to-video preflight: required CLI capabilities are available");
+  } catch (error) {
+    console.error(`✗ pr-to-video preflight: ${error.message}`);
+    process.exit(1);
+  }
+}
+
+if (pathToFileURL(process.argv[1] ?? "").href === import.meta.url) main();