voxflow 1.14.0 → 1.15.1

package/README.md

@@ -31,6 +31,12 @@ npx voxflow publish --video input.mp4 --audio narration.wav --publish local
 
 # Browse available voices
 npx voxflow voices --search "温柔"
+
+# Render a Slice deck locally to 1080×1920 mp4 (offline, no quota)
+npx voxflow slice render deck.json --output out.mp4
+
+# Preview Slice cards in a browser (thumbnail grid, no mp4 needed)
+npx voxflow slice preview deck.json
 ```
 
 A browser window will open for login on first use. After that, your token is cached automatically.
@@ -103,10 +109,11 @@ echo "Hello world" | voxflow narrate
 
 ### `voxflow voices [options]`
 
-Browse and filter available TTS voices (no login required).
+Browse and filter available TTS voices. The default catalog query is public (no login required); `--mine` switches to your **cloned voices** (login required, since 1.12.0).
 
 ```bash
-voxflow voices
+voxflow voices                              # public catalog
+voxflow voices --mine                       # YOUR cloned voices (since 1.12.0)
 voxflow voices --search "温柔" --gender female
 voxflow voices --language en --extended
 voxflow voices --json
@@ -114,6 +121,7 @@ voxflow voices --json
 
 | Flag | Default | Description |
 |------|---------|-------------|
+| `--mine` | `false` | List your cloned voices via `/api/voice/list` (requires login) |
 | `--search <query>` | | Search by name, tone, style |
 | `--gender <m\|f>` | | Filter by gender |
 | `--language <code>` | | Filter by language: zh, en, etc. |
@@ -422,6 +430,32 @@ voxflow publish --input video.mp4 --to ja \
 | `--title <text>` | filename | Title metadata |
 | `--json` | `false` | Print machine-readable JSON result |
 
+### `voxflow slice render <deck.json>` / `voxflow slice preview <deck.json>`
+
+Turn a Slice `deck.json` into a 1080×1920 vertical card video — **locally, offline, no API call, no quota**. The CLI ships with VoxFlow's 30+ curated Remotion themes pre-bundled, so a 20-second deck renders in ~30s on Apple Silicon.
+
+```bash
+# Preview cards in a browser before paying the render cost (~2s for 5 stills)
+voxflow slice preview deck.json
+# → opens http://localhost:5555 with a thumbnail grid
+
+# Render the full mp4 locally
+voxflow slice render deck.json --output out.mp4
+
+# Generate deck.json with your own Claude Code (no quota)
+# In Claude Code: invoke the bundled `voxflow-slice` skill on an article
+```
+
+| Flag | Default | Description |
+|------|---------|-------------|
+| `--output <path>` / `-o` | `out.mp4` | Output mp4 path (render only) |
+
+**First-run note**: Remotion downloads a ~90 MB headless Chrome on the first `render` or `preview` call (one-time, ~30s). Subsequent runs use the cached binary.
+
+**deck.json shape**: see `cli/skills/voxflow-slice/SKILL.md` for the schema; or use the `voxflow-slice` skill in Claude Code to generate one from any article.
+
+**Cloud path**: `voxflow slice <article.md> --theme paper-slide` still calls VoxFlow's hosted slicer (200 quota) — keep using that if you want the LLM slicing done for you. The offline `render`/`preview` subcommands operate on an existing `deck.json` and never call the API.
+
 ### `voxflow login` / `logout` / `status` / `dashboard`
 
 ```bash
@@ -431,6 +465,39 @@ voxflow status      # Show login status and token info
 voxflow dashboard   # Open Web dashboard in browser
 ```
 
+### `voxflow upgrade [options]` *(since 1.12.0)*
+
+One-shot self-update. Auto-detects your package manager (npm / pnpm / yarn / bun) and refreshes bundled skills so SKILL.md files stay in sync with the CLI binary.
+
+```bash
+voxflow upgrade --check      # only report whether a newer version exists
+voxflow upgrade              # interactive upgrade (prompts)
+voxflow upgrade -y           # non-interactive (for agents / CI / Skills)
+voxflow upgrade --dry-run    # print what would run
+voxflow upgrade --version 1.13.0  # install a specific version
+voxflow upgrade --no-skills  # skip post-install skills sync
+voxflow upgrade --force      # reinstall even if already on latest
+```
+
+| Flag | Description |
+|------|-------------|
+| `-y`, `--yes` | Skip the confirmation prompt |
+| `--check` | Report version skew without installing |
+| `--dry-run` | Print the install command instead of running it |
+| `--force` | Reinstall even when already on the latest version |
+| `--no-skills` | Skip the post-install `voxflow skills install --all` |
+| `--version <ver>` | Install a specific version (e.g. `1.13.0`) |
+
+Override the auto-detected package manager with `VOXFLOW_UPGRADE_PM=npm` (or `pnpm` / `yarn` / `bun`).
+
+**Update-notifier hint** (since 1.11.5, structured since 1.14.0): every CLI invocation does a non-blocking 24h-cached check against the npm registry. When a newer version exists, an agent-readable line is emitted on stderr:
+
+```
+<voxflow-hint v="1" type="cli-outdated" current="1.10.21" latest="1.14.0" action="voxflow upgrade -y" />
+```
+
+Human users see a dim grey `▲ voxflow X → Y available` instead. Opt out with `NO_UPDATE_NOTIFIER=1` or `VOXFLOW_NO_UPDATE_CHECK=1`.
+
 ### `voxflow add <name>` *(experimental — Day-1 MVP)*
 
 Pull a curated flow / voice recipe / CLI preset from the official registry into your current project.

package/bin/voxflow.js

@@ -0,0 +1,27 @@
+#!/usr/bin/env node
+
+// Recommend the voxflow Claude Code plugin when running inside Claude Code.
+// The hint line is stripped by Claude Code before it reaches the model and
+// shown as a one-time install prompt. No-op outside Claude Code sessions.
+if (process.env.CLAUDECODE) {
+  process.stderr.write('<claude-code-hint v="1" type="plugin" value="voxflow@claude-plugins-official" />\n');
+}
+
+const { run } = require('../lib/cli');
+const { logger } = require('../lib/core/logger');
+const { scheduleUpdateCheck } = require('../lib/core/update-check');
+
+// Non-blocking npm registry check. Prints a one-line hint at exit when a
+// newer version is published. Auto-skips in CI, non-TTY, and when
+// VOXFLOW_NO_UPDATE_CHECK=1. See lib/core/update-check.js.
+try {
+  scheduleUpdateCheck(require('../package.json').version);
+} catch { /* update check is best-effort */ }
+
+run().catch((err) => {
+  // User-facing single-line error on stderr (parity with previous output).
+  // Full stack only shows when the user asked for verbosity (`-vv+`).
+  process.stderr.write(`\nFatal error: ${err.message}\n`);
+  logger.debug({ err }, 'fatal error');
+  process.exit(1);
+});