hyperframes 0.8.113 → 0.8.115

package/dist/{publish-ZGKT7KED.js → publish-WE6AS77D.js}

@@ -26,13 +26,13 @@ import {
   resolveProxy,
   scanProjectMediaCodecMap,
   waitForProxy
-} from "./chunk-LMC46FK5.js";
+} from "./chunk-QMFCL2ZN.js";
 import {
   formatLintStartupMessage
 } from "./chunk-6CSYCFQV.js";
 import {
   resolveAutoProxy
-} from "./chunk-BOUDTDBQ.js";
+} from "./chunk-2GWVY66H.js";
 import "./chunk-XT7X6QCP.js";
 import "./chunk-4YYJOFKS.js";
 import "./chunk-HVW7ABXD.js";
@@ -42,10 +42,11 @@ import {
   q,
   ue
 } from "./chunk-WMQNIQDJ.js";
-import "./chunk-ENHAGQEP.js";
-import "./chunk-DR7QW6C5.js";
-import "./chunk-IP3XINRB.js";
+import "./chunk-TMCJPHPP.js";
+import "./chunk-QXNRRMBQ.js";
+import "./chunk-BDNCUMZM.js";
 import "./chunk-AWDFDFI3.js";
+import "./chunk-P6LJ4Y32.js";
 import "./chunk-GMECXFAN.js";
 import {
   c
@@ -57,10 +58,10 @@ import {
   failCommand,
   setCommandExitCode
 } from "./chunk-PBN6GBJE.js";
-import "./chunk-FCEFKWPM.js";
+import "./chunk-IEE7GIVX.js";
 import "./chunk-UUDQD62L.js";
 import "./chunk-DPVXBVLL.js";
-import "./chunk-C6AIZOQN.js";
+import "./chunk-RRPJEHHW.js";
 import "./chunk-VC76R6W2.js";
 import "./chunk-OFQWTKPW.js";
 import {

package/dist/{remove-background-4LRTT6YL.js → remove-background-XSDOCVN5.js}

@@ -8,7 +8,7 @@ import {
   DEFAULT_QUALITY,
   QUALITIES,
   isQuality
-} from "./chunk-SIN32SJB.js";
+} from "./chunk-YNHP6OFJ.js";
 import {
   DEVICES,
   isDevice
@@ -28,12 +28,12 @@ import {
 import {
   failCommand
 } from "./chunk-PBN6GBJE.js";
-import "./chunk-G2T2X6FZ.js";
-import "./chunk-FCEFKWPM.js";
+import "./chunk-5MXN7WM4.js";
+import "./chunk-IEE7GIVX.js";
 import "./chunk-UUDQD62L.js";
 import "./chunk-DPVXBVLL.js";
-import "./chunk-OCNCK5FQ.js";
-import "./chunk-C6AIZOQN.js";
+import "./chunk-M7XTMZF5.js";
+import "./chunk-RRPJEHHW.js";
 import "./chunk-VC76R6W2.js";
 import "./chunk-OFQWTKPW.js";
 import "./chunk-LCSMOLGX.js";
@@ -159,7 +159,7 @@ var remove_background_default = defineCommand({
     const outputPath = resolve(args.output);
     const backgroundOutputArg = args["background-output"];
     const backgroundOutputPath = backgroundOutputArg ? resolve(backgroundOutputArg) : void 0;
-    const { render } = await import("./pipeline-IWPF5ZMK.js");
+    const { render } = await import("./pipeline-U3OISHWV.js");
     const spin = args.json ? null : ft();
     spin?.start("Preparing background-removal pipeline...");
     try {

package/dist/{render-H6RSJF2V.js → render-5TMRIC73.js}

@@ -28,7 +28,7 @@ import {
   reportVariableIssues,
   resolveVariablesArg,
   validateVariablesAgainstProject
-} from "./chunk-ZMMSMDCA.js";
+} from "./chunk-VDASTWUM.js";
 import {
   buildPublishFileMap,
   zipPublishFileMap
@@ -38,20 +38,20 @@ import "./chunk-DNXD7TOA.js";
 import "./chunk-WEATBQTR.js";
 import {
   resolveProject
-} from "./chunk-IRJBTYJF.js";
+} from "./chunk-XJQ7TRLG.js";
 import {
   errorBox,
   formatBytes,
   formatDuration
 } from "./chunk-IHFUKJOR.js";
 import "./chunk-PFCFR3KZ.js";
-import "./chunk-7CGIICLA.js";
-import "./chunk-DDK22K3I.js";
+import "./chunk-6SEUZGID.js";
+import "./chunk-KLZ7OCHR.js";
 import "./chunk-VWG7OQKU.js";
 import {
   c
 } from "./chunk-ZTZA4UWZ.js";
-import "./chunk-L5QASNBN.js";
+import "./chunk-IOJAVV6J.js";
 import "./chunk-AMKC3AXA.js";
 import {
   defineCommand
@@ -60,12 +60,12 @@ import "./chunk-54HJ63Q2.js";
 import {
   failCommand
 } from "./chunk-PBN6GBJE.js";
-import "./chunk-G2T2X6FZ.js";
-import "./chunk-FCEFKWPM.js";
+import "./chunk-5MXN7WM4.js";
+import "./chunk-IEE7GIVX.js";
 import "./chunk-UUDQD62L.js";
 import "./chunk-DPVXBVLL.js";
-import "./chunk-OCNCK5FQ.js";
-import "./chunk-C6AIZOQN.js";
+import "./chunk-M7XTMZF5.js";
+import "./chunk-RRPJEHHW.js";
 import "./chunk-VC76R6W2.js";
 import "./chunk-OFQWTKPW.js";
 import "./chunk-TWWSYAKJ.js";
@@ -77,12 +77,12 @@ import "./chunk-GK4AIFIH.js";
 import "./chunk-2PSPARWP.js";
 import {
   withMeta
-} from "./chunk-U4VSY56O.js";
+} from "./chunk-T5HXGUM3.js";
 import "./chunk-K4WIOZFP.js";
 import "./chunk-XUXGIA7H.js";
 import "./chunk-WERLJGIC.js";
 import "./chunk-ISN5GRYI.js";
-import "./chunk-3XPZJUKM.js";
+import "./chunk-3R6P5BIG.js";
 import {
   normalizeErrorMessage
 } from "./chunk-KNU5COPB.js";

package/dist/{render-OKNPNMFS.js → render-HVZUCLYW.js}

@@ -6,15 +6,15 @@ var __filename = __hf_fileURLToPath(import.meta.url);
 var __dirname = __hf_dirname(__filename);
 import {
   maybePromptRenderFeedback
-} from "./chunk-ZZIXIOK2.js";
+} from "./chunk-3YTWSGBV.js";
 import {
   reportVariableIssues,
   resolveVariablesArg,
   validateVariablesAgainstProject
-} from "./chunk-ZMMSMDCA.js";
+} from "./chunk-VDASTWUM.js";
 import {
   loadProducer
-} from "./chunk-VLC7JS4K.js";
+} from "./chunk-74RAXWDF.js";
 import {
   renderJobObservabilityTelemetryPayload
 } from "./chunk-VXVRPIJA.js";
@@ -28,11 +28,11 @@ import {
   resolveBrowserTimeoutMsArg,
   resolveCompositionEntryArg,
   resolveDefaultFpsArg
-} from "./chunk-3IUSKIZW.js";
+} from "./chunk-SC7ICSIU.js";
 import "./chunk-YEIFI443.js";
 import {
   resolveProject
-} from "./chunk-IRJBTYJF.js";
+} from "./chunk-XJQ7TRLG.js";
 import {
   formatLintStartupMessage
 } from "./chunk-6CSYCFQV.js";
@@ -46,22 +46,23 @@ import {
 } from "./chunk-IHFUKJOR.js";
 import {
   runEnvironmentChecks
-} from "./chunk-E52XEEAA.js";
+} from "./chunk-BQG33YTI.js";
 import "./chunk-PFCFR3KZ.js";
 import {
   loadProjectConfig,
   readProjectConfigWithStatus,
   seedProjectAuthoringSkill
-} from "./chunk-BOUDTDBQ.js";
+} from "./chunk-2GWVY66H.js";
 import "./chunk-XT7X6QCP.js";
 import "./chunk-4YYJOFKS.js";
 import {
   normalizeSkillSlug
 } from "./chunk-HVW7ABXD.js";
-import "./chunk-ENHAGQEP.js";
-import "./chunk-DR7QW6C5.js";
-import "./chunk-IP3XINRB.js";
+import "./chunk-TMCJPHPP.js";
+import "./chunk-QXNRRMBQ.js";
+import "./chunk-BDNCUMZM.js";
 import "./chunk-AWDFDFI3.js";
+import "./chunk-P6LJ4Y32.js";
 import "./chunk-GMECXFAN.js";
 import {
   H264EncoderUnavailableError,
@@ -73,21 +74,21 @@ import {
 } from "./chunk-TVCRUG2S.js";
 import {
   createRenderCancellationScope
-} from "./chunk-7543YIMQ.js";
+} from "./chunk-3J4EBX5M.js";
 import {
   trackRenderComplete,
   trackRenderError,
   trackRenderObservation,
   trackRenderPreflightRejected
-} from "./chunk-7CGIICLA.js";
-import "./chunk-DDK22K3I.js";
+} from "./chunk-6SEUZGID.js";
+import "./chunk-KLZ7OCHR.js";
 import "./chunk-VWG7OQKU.js";
 import {
   c
 } from "./chunk-ZTZA4UWZ.js";
 import {
   bytesToMb
-} from "./chunk-L5QASNBN.js";
+} from "./chunk-IOJAVV6J.js";
 import "./chunk-AMKC3AXA.js";
 import {
   markRenderSucceeded,
@@ -109,13 +110,13 @@ import {
   MAX_VP9_CPU_USED,
   MIN_VP9_CPU_USED,
   isVideoFrameFormat
-} from "./chunk-G2T2X6FZ.js";
+} from "./chunk-5MXN7WM4.js";
 import {
   formatRenderOutputTimestamp,
   fpsToFfmpegArg,
   fpsToNumber,
   parseFps
-} from "./chunk-FCEFKWPM.js";
+} from "./chunk-IEE7GIVX.js";
 import {
   checkOutputResolutionCompatibility,
   isAspectAgnosticResolutionAlias,
@@ -123,8 +124,8 @@ import {
   suggestMatchingPreset
 } from "./chunk-UUDQD62L.js";
 import "./chunk-DPVXBVLL.js";
-import "./chunk-OCNCK5FQ.js";
-import "./chunk-C6AIZOQN.js";
+import "./chunk-M7XTMZF5.js";
+import "./chunk-RRPJEHHW.js";
 import "./chunk-VC76R6W2.js";
 import "./chunk-OFQWTKPW.js";
 import {
@@ -161,7 +162,7 @@ import {
 } from "./chunk-ISN5GRYI.js";
 import {
   VERSION
-} from "./chunk-3XPZJUKM.js";
+} from "./chunk-3R6P5BIG.js";
 import {
   normalizeErrorMessage
 } from "./chunk-KNU5COPB.js";
@@ -659,7 +660,7 @@ async function executeRenderPlan(plan, dependencies, cancellation) {
   let batchModule;
   let preparedBatch;
   if (plan.batchPath) {
-    batchModule = await import("./batchRender-QVJ7NEUH.js");
+    batchModule = await import("./batchRender-QVLLL5DN.js");
     try {
       preparedBatch = batchModule.prepareBatchRender({
         batchPath: plan.batchPath,

package/dist/{render-TGCDBKMP.js → render-QX6AKB6Y.js}

@@ -15,7 +15,7 @@ import {
   reportVariableIssues,
   resolveVariablesArg,
   validateVariablesAgainstProject
-} from "./chunk-ZMMSMDCA.js";
+} from "./chunk-VDASTWUM.js";
 import "./chunk-5Z63TBTX.js";
 import "./chunk-IHFUKJOR.js";
 import "./chunk-PFCFR3KZ.js";
@@ -25,10 +25,10 @@ import {
 import {
   setCommandExitCode
 } from "./chunk-PBN6GBJE.js";
-import "./chunk-FCEFKWPM.js";
+import "./chunk-IEE7GIVX.js";
 import "./chunk-UUDQD62L.js";
 import "./chunk-DPVXBVLL.js";
-import "./chunk-C6AIZOQN.js";
+import "./chunk-RRPJEHHW.js";
 import "./chunk-VC76R6W2.js";
 import "./chunk-OFQWTKPW.js";
 import "./chunk-TQFG7HTI.js";

package/dist/{render-batch-WRQFW4UC.js → render-batch-QJXFVTDE.js}

@@ -14,7 +14,7 @@ import {
   loadProjectVariableSchema,
   reportVariableIssues,
   validateVariablesAgainstSchema
-} from "./chunk-ZMMSMDCA.js";
+} from "./chunk-VDASTWUM.js";
 import "./chunk-5Z63TBTX.js";
 import {
   errorBox
@@ -27,10 +27,10 @@ import {
   failCommand,
   setCommandExitCode
 } from "./chunk-PBN6GBJE.js";
-import "./chunk-FCEFKWPM.js";
+import "./chunk-IEE7GIVX.js";
 import "./chunk-UUDQD62L.js";
 import "./chunk-DPVXBVLL.js";
-import "./chunk-C6AIZOQN.js";
+import "./chunk-RRPJEHHW.js";
 import "./chunk-VC76R6W2.js";
 import "./chunk-OFQWTKPW.js";
 import "./chunk-TQFG7HTI.js";

package/dist/{renderCancellation-BFCQYGVV.js → renderCancellation-WSSSHRFR.js}

@@ -7,13 +7,13 @@ var __dirname = __hf_dirname(__filename);
 import {
   createRenderCancellationScope,
   stoppedByCancelSignal
-} from "./chunk-7543YIMQ.js";
-import "./chunk-G2T2X6FZ.js";
-import "./chunk-FCEFKWPM.js";
+} from "./chunk-3J4EBX5M.js";
+import "./chunk-5MXN7WM4.js";
+import "./chunk-IEE7GIVX.js";
 import "./chunk-UUDQD62L.js";
 import "./chunk-DPVXBVLL.js";
-import "./chunk-OCNCK5FQ.js";
-import "./chunk-C6AIZOQN.js";
+import "./chunk-M7XTMZF5.js";
+import "./chunk-RRPJEHHW.js";
 import "./chunk-VC76R6W2.js";
 import "./chunk-OFQWTKPW.js";
 import "./chunk-LAOCA3MQ.js";

package/dist/{resolver-37UOGAMT.js → resolver-WTXO6WXA.js}

@@ -11,14 +11,15 @@ import {
   resolveItemWithDependencies,
   resolveItemsByTag,
   unreachableRegistryMessage
-} from "./chunk-ENHAGQEP.js";
-import "./chunk-IP3XINRB.js";
+} from "./chunk-TMCJPHPP.js";
+import "./chunk-BDNCUMZM.js";
 import "./chunk-AWDFDFI3.js";
+import "./chunk-P6LJ4Y32.js";
 import "./chunk-GMECXFAN.js";
-import "./chunk-FCEFKWPM.js";
+import "./chunk-IEE7GIVX.js";
 import "./chunk-UUDQD62L.js";
 import "./chunk-DPVXBVLL.js";
-import "./chunk-C6AIZOQN.js";
+import "./chunk-RRPJEHHW.js";
 import "./chunk-VC76R6W2.js";
 import "./chunk-OFQWTKPW.js";
 import "./chunk-TQFG7HTI.js";

package/dist/{sherpa-SDVKYXCX.js → sherpa-S6ZBBEFO.js}

@@ -11,20 +11,20 @@ import "./chunk-WEATBQTR.js";
 import {
   getPreparedWavDurationSeconds,
   prepareWav
-} from "./chunk-HTQR7SUZ.js";
+} from "./chunk-4P2TOD7N.js";
 import "./chunk-OAF4XJOW.js";
 import "./chunk-X5HWXQPU.js";
 import "./chunk-TVCRUG2S.js";
 import {
   stoppedByCancelSignal
-} from "./chunk-7543YIMQ.js";
+} from "./chunk-3J4EBX5M.js";
 import "./chunk-AMKC3AXA.js";
-import "./chunk-G2T2X6FZ.js";
-import "./chunk-FCEFKWPM.js";
+import "./chunk-5MXN7WM4.js";
+import "./chunk-IEE7GIVX.js";
 import "./chunk-UUDQD62L.js";
 import "./chunk-DPVXBVLL.js";
-import "./chunk-OCNCK5FQ.js";
-import "./chunk-C6AIZOQN.js";
+import "./chunk-M7XTMZF5.js";
+import "./chunk-RRPJEHHW.js";
 import "./chunk-VC76R6W2.js";
 import "./chunk-OFQWTKPW.js";
 import "./chunk-LAOCA3MQ.js";

package/dist/skills/hyperframes/SKILL.md

@@ -16,6 +16,10 @@ description: >
 
 # HyperFrames entry point
 
+### Check remaining usage
+
+At the start of creation, run `npx hyperframes usage --json`. Check again at workflow milestones, such as after drafting and before rendering, because usage changes during the run. Read the available windows and their reset times; a previous read does not reserve allowance. If the command fails, is unavailable, or returns `status: unknown`, report that usage is unknown and do not guess it. Keep scope and workflow choices with the user.
+
 HyperFrames **renders video from HTML** — a composition is an HTML file whose DOM declares timing with `data-*` attributes, whose animation runtime is seekable, and whose media playback is owned by the framework. The full authoring contract lives in `/hyperframes-core`; read it before writing composition HTML. Brief, storyboard, review, production, dispatch, and frame-worker contracts live in this skill's `references/`.
 
 ## 1. Start from project state

package/dist/skills/hyperframes-cli/SKILL.md

@@ -178,3 +178,11 @@ Two entries in `hyperframes --help` are not part of the authoring loop, and reac
 
 - `events` is the telemetry endpoint skills use to report their **own** invocation, ideally from a bundled script. It emits an anonymous event and exits 0 no matter what you pass it. It is not a way to read telemetry back, and an agent has no reason to call it by hand.
 - `validate`, `inspect`, and `layout` are deprecated aliases kept for old scripts. `check` is the one that is maintained, and it is what every reference in this skill assumes.
+
+## Remaining harness usage
+
+Run `npx hyperframes usage --json` at the start of a video workflow and again at milestones such as after drafting and before rendering. A fresh read at handoff can serve as the start read. Use `--harness claude-code`, `--harness codex`, or `--harness grok` to select explicitly.
+
+Known results contain `status: "known"`, `harness`, `planTier`, `session`, and `weekly`. Each available window contains `usedPercent`, `remainingPercent`, and `resetsAt`; an unavailable window is `null`. `planTier` is the readable subscription tier when available, otherwise `null`. Claude Code reports its shared five-hour and weekly windows. Codex reports its shared session and weekly windows when available. Grok reports its included weekly allowance with `session: null`.
+
+Unknown results contain `status: "unknown"` and a token-free `reason`. Missing, expired, unsupported, ambiguous, or unreadable logins and unavailable provider responses return unknown. Report the unknown state without guessing allowance. The command reads existing credentials without refreshing or rewriting them and emits no tokens or telemetry. Usage is a snapshot; it does not reserve allowance or estimate the next video's cost. Keep scope and workflow choices with the user.

package/dist/skills/hyperframes-cli/references/upgrade-info-misc.md

@@ -124,3 +124,11 @@ npx hyperframes remove-background
 These produce assets (narration audio, word-level transcripts, transparent video) that get dropped into a composition. Each may download its own model on first run.
 
 For voice selection, Whisper model rules, output format choice, and the TTS → transcript → captions chain, invoke the `media-use` skill. This skill stays focused on the dev loop.
+
+## Remaining harness usage
+
+Run `npx hyperframes usage --json` at the start of a video workflow and again at milestones such as after drafting and before rendering. A fresh read at handoff can serve as the start read. Use `--harness claude-code`, `--harness codex`, or `--harness grok` to select explicitly.
+
+Known results contain `status: "known"`, `harness`, `planTier`, `session`, and `weekly`. Each available window contains `usedPercent`, `remainingPercent`, and `resetsAt`; an unavailable window is `null`. `planTier` is the readable subscription tier when available, otherwise `null`. Claude Code reports its shared five-hour and weekly windows. Codex reports its shared session and weekly windows when available. Grok reports its included weekly allowance with `session: null`.
+
+Unknown results contain `status: "unknown"` and a token-free `reason`. Missing, expired, unsupported, ambiguous, or unreadable logins and unavailable provider responses return unknown. Report the unknown state without guessing allowance. The command reads existing credentials without refreshing or rewriting them and emits no tokens or telemetry. Usage is a snapshot; it does not reserve allowance or estimate the next video's cost. Keep scope and workflow choices with the user.

package/dist/skills/media-use/audio/scripts/audio.mjs

@@ -109,7 +109,10 @@ try {
 }
 const lines = Array.isArray(request.lines) ? request.lines : [];
 const lang = langOverride || request.lang || "en";
-const speed = Number(speedOverride ?? request.speed ?? 1.0) || 1.0;
+const speedInput = speedOverride ?? request.speed ?? 1;
+const speed = Number(speedInput);
+if (!(speed > 0 && speed <= 3))
+  die(`speed must be above 0 and at most 3, got ${JSON.stringify(speedInput)}`);
 
 // ── env + HeyGen availability (the single switch) ─────────────────────────────
 loadEnvFromDir(hyperframesDir);

package/dist/skills/media-use/audio/scripts/audio.test.mjs

@@ -1,6 +1,7 @@
 import { strict as assert } from "node:assert";
 import { test } from "node:test";
 import { mkdtempSync, mkdirSync, readFileSync, rmSync, existsSync, writeFileSync } from "node:fs";
+import { spawnSync } from "node:child_process";
 import { join, dirname } from "node:path";
 import { tmpdir } from "node:os";
 import { fileURLToPath } from "node:url";
@@ -124,3 +125,35 @@ test("two effects never share a file when one's name is taken by the person, run
     rmSync(dir, { recursive: true, force: true });
   }
 });
+
+// The engine owns speed parsing; a fallback before the check would turn 0 or junk into 1.
+function runEngineWith(request, ...args) {
+  const dir = mkdtempSync(join(tmpdir(), "audio-speed-range-"));
+  try {
+    writeFileSync(join(dir, "audio_request.json"), JSON.stringify({ lines: [], ...request }));
+    return spawnSync(process.execPath, [join(HERE, "audio.mjs"), "--hyperframes", dir, ...args], {
+      encoding: "utf8",
+    });
+  } finally {
+    rmSync(dir, { recursive: true, force: true });
+  }
+}
+
+for (const [label, request, args, shown] of [
+  ["request speed 5", { speed: 5 }, [], "5"],
+  ["request speed 0", { speed: 0 }, [], "0"],
+  ["request speed -1", { speed: -1 }, [], "-1"],
+  ["request speed text", { speed: "fast" }, [], '"fast"'],
+  ["--speed 0", {}, ["--speed", "0"], '"0"'],
+  ["--speed text", { speed: 1 }, ["--speed", "abc"], '"abc"'],
+]) {
+  test(`${label} stops the engine before any TTS runs`, () => {
+    const r = runEngineWith(request, ...args);
+    assert.equal(r.status, 1);
+    assert.ok(r.stderr.includes(`speed must be above 0 and at most 3, got ${shown}`), r.stderr);
+  });
+}
+
+test("a numeric string speed, as the adapters forward it, passes the check", () => {
+  assert.doesNotMatch(runEngineWith({ speed: "0.8" }, "--only", "tts").stderr, /speed must/);
+});

package/dist/skills/media-use/audio/scripts/lib/tts.mjs

@@ -290,6 +290,7 @@ export async function synthesizeOne({
   const wavRel = relTo(hyperframesDir, wavAbs);
   const args = ["hyperframes", "tts", writeTmpText(text), "--voice", voiceId, "--output", wavRel];
   if (lang !== "en") args.push("--lang", lang);
+  if (speed !== 1) args.push("--speed", String(speed));
   const r = await spawnP("npx", args, { cwd: hyperframesDir });
   return synthResult(r, wavAbs, "kokoro (npx hyperframes tts)");
 }

package/dist/skills/media-use/audio/scripts/lib/tts.test.mjs

@@ -1,6 +1,6 @@
 import { test } from "node:test";
 import assert from "node:assert/strict";
-import { mkdtempSync, writeFileSync, chmodSync, rmSync, existsSync } from "node:fs";
+import { mkdtempSync, readFileSync, writeFileSync, chmodSync, rmSync, existsSync } from "node:fs";
 import { join, dirname } from "node:path";
 import { tmpdir } from "node:os";
 import {
@@ -155,3 +155,46 @@ test("synthResult names a non-zero subprocess exit", () => {
   assert.equal(res.ok, false);
   assert.match(res.error, /kokoro .* exited with status 2/);
 });
+
+// Kokoro shells out to `npx hyperframes tts`; a fake npx on PATH records the argv
+// synthesizeOne really builds, so a dropped flag fails here. Windows runs npx via
+// node directly, so the stub never resolves there.
+async function kokoroArgv(options) {
+  const dir = mkdtempSync(join(tmpdir(), "tts-kokoro-argv-"));
+  const argvLog = join(dir, "argv.txt");
+  writeFileSync(join(dir, "npx"), `#!/bin/sh\nprintf '%s\\n' "$@" > "${argvLog}"\n`);
+  chmodSync(join(dir, "npx"), 0o755);
+  const originalPath = process.env.PATH;
+  try {
+    process.env.PATH = dir;
+    await synthesizeOne({
+      provider: "kokoro",
+      text: "hi",
+      voiceId: "am_michael",
+      wavAbs: join(dir, "line-0.wav"),
+      hyperframesDir: dir,
+      ...options,
+    });
+    return readFileSync(argvLog, "utf8").trim().split("\n");
+  } finally {
+    process.env.PATH = originalPath;
+    rmSync(dir, { recursive: true, force: true });
+  }
+}
+
+test(
+  "synthesizeOne(kokoro) forwards a non-default speed to the CLI",
+  { skip: process.platform === "win32" },
+  async () => {
+    const argv = await kokoroArgv({ speed: 0.8, lang: "es" });
+    assert.deepEqual(argv.slice(-4), ["--lang", "es", "--speed", "0.8"]);
+  },
+);
+
+test(
+  "synthesizeOne(kokoro) leaves --speed off at the default",
+  { skip: process.platform === "win32" },
+  async () => {
+    assert.ok(!(await kokoroArgv({})).includes("--speed"));
+  },
+);

package/dist/{skills-O25ZTFTO.js → skills-CDRSTETB.js}

@@ -9,15 +9,15 @@ import {
 } from "./chunk-WMQNIQDJ.js";
 import {
   trackSkillsInstallSkipped
-} from "./chunk-7CGIICLA.js";
-import "./chunk-DDK22K3I.js";
+} from "./chunk-6SEUZGID.js";
+import "./chunk-KLZ7OCHR.js";
 import {
   diag
 } from "./chunk-VWG7OQKU.js";
 import {
   c
 } from "./chunk-ZTZA4UWZ.js";
-import "./chunk-L5QASNBN.js";
+import "./chunk-IOJAVV6J.js";
 import "./chunk-AMKC3AXA.js";
 import {
   defineCommand
@@ -27,12 +27,12 @@ import {
   CliResultSignal,
   setCommandExitCode
 } from "./chunk-PBN6GBJE.js";
-import "./chunk-G2T2X6FZ.js";
-import "./chunk-FCEFKWPM.js";
+import "./chunk-5MXN7WM4.js";
+import "./chunk-IEE7GIVX.js";
 import "./chunk-UUDQD62L.js";
 import "./chunk-DPVXBVLL.js";
-import "./chunk-OCNCK5FQ.js";
-import "./chunk-C6AIZOQN.js";
+import "./chunk-M7XTMZF5.js";
+import "./chunk-RRPJEHHW.js";
 import "./chunk-VC76R6W2.js";
 import "./chunk-OFQWTKPW.js";
 import "./chunk-TWWSYAKJ.js";
@@ -51,15 +51,15 @@ import {
   isCoreSkill,
   presentSkills,
   pruneOrphanedLockEntries
-} from "./chunk-FXHVADV6.js";
+} from "./chunk-SAO3NQPF.js";
 import {
   withMeta
-} from "./chunk-U4VSY56O.js";
+} from "./chunk-T5HXGUM3.js";
 import "./chunk-K4WIOZFP.js";
 import "./chunk-XUXGIA7H.js";
 import "./chunk-WERLJGIC.js";
 import "./chunk-ISN5GRYI.js";
-import "./chunk-3XPZJUKM.js";
+import "./chunk-3R6P5BIG.js";
 import "./chunk-KNU5COPB.js";
 import {
   buildNpxCommand

package/dist/{skillsUpdateCheck-Y2V4OMMT.js → skillsUpdateCheck-FKREJXSF.js}

@@ -9,13 +9,13 @@ import {
   printSkillsUpdateNotice,
   refreshSkillsCache,
   skillsCheckDue
-} from "./chunk-FXHVADV6.js";
-import "./chunk-U4VSY56O.js";
+} from "./chunk-SAO3NQPF.js";
+import "./chunk-T5HXGUM3.js";
 import "./chunk-K4WIOZFP.js";
 import "./chunk-XUXGIA7H.js";
 import "./chunk-WERLJGIC.js";
 import "./chunk-ISN5GRYI.js";
-import "./chunk-3XPZJUKM.js";
+import "./chunk-3R6P5BIG.js";
 import "./chunk-KNU5COPB.js";
 import "./chunk-M2WBOQ2Q.js";
 export {