playhead-cli 0.1.1 → 0.1.2

package/README.md

@@ -142,6 +142,24 @@ Scaffold one with `npx playhead init`.
 Add `--vision` to `render`/`verify` for an optional Claude review of the contact sheet (needs
 `ANTHROPIC_API_KEY`; skipped cleanly without one, so CI stays deterministic).
 
+### Narration voices
+
+`output.audio.narration: tts` speaks each step's narration line. Two providers:
+
+| `provider` | Voice | Deps | Platforms |
+|---|---|---|---|
+| `kokoro` (recommended) | Natural neural (Kokoro-82M). `voice:` = `heart` (**default**) or `michael` | `npm i -g kokoro-js` (~400MB, one-time; model ~90MB auto-downloads on first use) | Mac · Linux · Windows |
+| `say` | macOS built-in (robotic). `voice:` = a `say` voice name | none | macOS only |
+
+```yaml
+output:
+  audio: { narration: tts, provider: kokoro }   # → Heart, offline, cross-platform
+```
+
+Behind a TLS-intercepting proxy, the one-time model download needs the system CA:
+`NODE_EXTRA_CA_CERTS=/etc/ssl/cert.pem playhead render …`. `playhead doctor --ci` reports which
+providers are available.
+
 **Exit codes are a contract:** `0` publishable · `1` the app broke the flow (a partial bundle
 **and a watchable failure clip** are written) · `2` rendered but failed verification ·
 `3` infra · `4` bad spec/arguments.

package/dist/audio/tts.d.ts

@@ -1,8 +1,10 @@
 export interface NarrationOptions {
-    /** Only 'say' (macOS local TTS) is implemented today; the seam is here for cloud providers. */
-    provider: 'say';
+    /** 'say' — macOS built-in (zero deps, Mac-only). 'kokoro' — natural neural voice, offline,
+     *  cross-platform, via the optional kokoro-js package. */
+    provider: 'say' | 'kokoro';
+    /** say: a macOS voice name (Samantha). kokoro: a voice id (af_heart, am_michael, …). */
     voice?: string;
-    /** Words per minute (say-specific). */
+    /** say: words per minute. kokoro: playback speed × 100 (100 = 1.0×). */
     rate?: number;
 }
 export interface NarrationLine {

package/dist/audio/tts.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"tts.d.ts","sourceRoot":"","sources":["../../src/audio/tts.ts"],"names":[],"mappings":"AAYA,MAAM,WAAW,gBAAgB;IAC/B,+FAA+F;IAC/F,QAAQ,EAAE,KAAK,CAAC;IAChB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,uCAAuC;IACvC,IAAI,CAAC,EAAE,MAAM,CAAC;CACf;AAED,MAAM,WAAW,aAAa;IAC5B,OAAO,EAAE,MAAM,CAAC;IAChB,IAAI,EAAE,MAAM,CAAC;CACd;AAED,MAAM,WAAW,aAAa;IAC5B,OAAO,EAAE,MAAM,CAAC;IAChB,IAAI,EAAE,MAAM,CAAC;IACb,UAAU,EAAE,MAAM,CAAC;CACpB;AAqCD;;;;GAIG;AACH,wBAAsB,mBAAmB,CACvC,KAAK,EAAE,aAAa,EAAE,EACtB,IAAI,EAAE,gBAAgB,EACtB,QAAQ,EAAE,MAAM,GACf,OAAO,CAAC,GAAG,CAAC,MAAM,EAAE,aAAa,CAAC,CAAC,CAWrC"}
+{"version":3,"file":"tts.d.ts","sourceRoot":"","sources":["../../src/audio/tts.ts"],"names":[],"mappings":"AAYA,MAAM,WAAW,gBAAgB;IAC/B;8DAC0D;IAC1D,QAAQ,EAAE,KAAK,GAAG,QAAQ,CAAC;IAC3B,wFAAwF;IACxF,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,wEAAwE;IACxE,IAAI,CAAC,EAAE,MAAM,CAAC;CACf;AAED,MAAM,WAAW,aAAa;IAC5B,OAAO,EAAE,MAAM,CAAC;IAChB,IAAI,EAAE,MAAM,CAAC;CACd;AAED,MAAM,WAAW,aAAa;IAC5B,OAAO,EAAE,MAAM,CAAC;IAChB,IAAI,EAAE,MAAM,CAAC;IACb,UAAU,EAAE,MAAM,CAAC;CACpB;AA6FD;;;;GAIG;AACH,wBAAsB,mBAAmB,CACvC,KAAK,EAAE,aAAa,EAAE,EACtB,IAAI,EAAE,gBAAgB,EACtB,QAAQ,EAAE,MAAM,GACf,OAAO,CAAC,GAAG,CAAC,MAAM,EAAE,aAAa,CAAC,CAAC,CAYrC"}