@vibeframe/cli 0.105.1 → 0.106.0

package/dist/commands/export.d.ts

@@ -0,0 +1,60 @@
+import { Command } from "commander";
+/**
+ * Get the duration of a media file using ffprobe
+ * For images, returns a default duration since they have no inherent time
+ */
+export declare function getMediaDuration(filePath: string, mediaType: "video" | "audio" | "image", defaultImageDuration?: number): Promise<number>;
+/**
+ * Check if a media file has an audio stream
+ */
+export declare function checkHasAudio(filePath: string): Promise<boolean>;
+/**
+ * Export result for programmatic usage
+ */
+export interface ExportResult {
+    success: boolean;
+    message: string;
+    outputPath?: string;
+}
+/**
+ * Gap filling strategy for timeline gaps
+ * - "black": Fill gaps with black frames (fallback)
+ * - "extend": Extend adjacent clips using source media if available
+ */
+export type GapFillStrategy = "black" | "extend";
+/**
+ * Export options
+ */
+export interface ExportOptions {
+    preset?: "draft" | "standard" | "high" | "ultra";
+    format?: "mp4" | "webm" | "mov" | "gif";
+    overwrite?: boolean;
+    gapFill?: GapFillStrategy;
+    bitrate?: string;
+    fps?: number;
+    resolution?: string;
+    codec?: "h264" | "h265" | "vp9";
+}
+export type VideoCodec = "h264" | "h265" | "vp9";
+export declare const BITRATE_PATTERN: RegExp;
+export declare const RESOLUTION_PATTERN: RegExp;
+export declare const VALID_CODECS: VideoCodec[];
+export interface CustomOverrides {
+    bitrate?: string;
+    fps?: number;
+    resolution?: string;
+    codec?: VideoCodec;
+}
+export declare function validateOverrides(overrides: CustomOverrides): string | null;
+/**
+ * Reusable export function for programmatic usage
+ */
+export declare function runExport(projectPath: string, outputPath: string, options?: ExportOptions): Promise<ExportResult>;
+export declare const exportCommand: Command;
+export interface PresetSettings {
+    resolution: string;
+    videoBitrate: string;
+    audioBitrate: string;
+    ffmpegArgs: string[];
+}
+export declare function applyCustomOverrides(settings: PresetSettings, overrides: CustomOverrides): PresetSettings;

package/dist/commands/export.test.d.ts

@@ -0,0 +1 @@
+export {};

package/dist/commands/generate/background.d.ts

@@ -0,0 +1,22 @@
+/**
+ * @module generate/background
+ * @description `vibe generate background` — OpenAI gpt-image-2 backdrop
+ * generation. Split out of `generate.ts` in v0.69 (Plan G Phase 2).
+ */
+import type { Command } from "commander";
+export interface ExecuteBackgroundOptions {
+    description: string;
+    aspect?: "16:9" | "9:16" | "1:1" | string;
+    output?: string;
+    apiKey?: string;
+}
+export interface ExecuteBackgroundResult {
+    success: boolean;
+    imageUrl?: string;
+    outputPath?: string;
+    base64?: string;
+    revisedPrompt?: string;
+    error?: string;
+}
+export declare function executeBackground(options: ExecuteBackgroundOptions): Promise<ExecuteBackgroundResult>;
+export declare function registerBackgroundCommand(parent: Command): void;

package/dist/commands/generate/image.d.ts

@@ -0,0 +1,8 @@
+/**
+ * @module generate/image
+ * @description `vibe generate image` (alias `img`) — multi-provider image
+ * generation. OpenAI gpt-image-2, Gemini Nano Banana, Grok, Runway. Split
+ * out of `generate.ts` in v0.69 (Plan G Phase 2).
+ */
+import type { Command } from "commander";
+export declare function registerImageCommand(parent: Command): void;

package/dist/commands/generate/music-status.d.ts

@@ -0,0 +1,20 @@
+/**
+ * @module generate/music-status
+ * @description `vibe generate music-status` (hidden) — Replicate music
+ * generation status check. Split out of `generate.ts` in v0.69 (Plan G
+ * Phase 2).
+ */
+import type { Command } from "commander";
+export interface ExecuteMusicStatusOptions {
+    taskId: string;
+    apiKey?: string;
+}
+export interface ExecuteMusicStatusResult {
+    success: boolean;
+    taskId?: string;
+    status?: "completed" | "failed" | "processing";
+    audioUrl?: string;
+    error?: string;
+}
+export declare function executeMusicStatus(options: ExecuteMusicStatusOptions): Promise<ExecuteMusicStatusResult>;
+export declare function registerMusicStatusCommand(parent: Command): void;

package/dist/commands/generate/music.d.ts

@@ -0,0 +1,27 @@
+/**
+ * @module generate/music
+ * @description `vibe generate music` — ElevenLabs Music API (default, sync,
+ * up to 10 min) or Replicate MusicGen (async, max 30 s, optional melody
+ * conditioning). Split out of `generate.ts` in v0.69 (Plan G Phase 2).
+ */
+import type { Command } from "commander";
+export interface ExecuteMusicOptions {
+    prompt: string;
+    output?: string;
+    duration?: number;
+    provider?: "elevenlabs" | "replicate";
+    instrumental?: boolean;
+    wait?: boolean;
+}
+export interface ExecuteMusicResult {
+    success: boolean;
+    outputPath?: string;
+    provider?: string;
+    duration?: number;
+    taskId?: string;
+    status?: string;
+    audioUrl?: string;
+    error?: string;
+}
+export declare function executeMusic(options: ExecuteMusicOptions): Promise<ExecuteMusicResult>;
+export declare function registerMusicCommand(parent: Command): void;

package/dist/commands/generate/sound-effect.d.ts

@@ -0,0 +1,19 @@
+/**
+ * @module generate/sound-effect
+ * @description `vibe generate sound-effect` — ElevenLabs SFX generation.
+ * Split out of `generate.ts` in v0.69 (Plan G Phase 2).
+ */
+import type { Command } from "commander";
+export interface ExecuteSoundEffectOptions {
+    prompt: string;
+    output?: string;
+    duration?: number;
+    promptInfluence?: number;
+}
+export interface ExecuteSoundEffectResult {
+    success: boolean;
+    outputPath?: string;
+    error?: string;
+}
+export declare function executeSoundEffect(options: ExecuteSoundEffectOptions): Promise<ExecuteSoundEffectResult>;
+export declare function registerSoundEffectCommand(parent: Command): void;

package/dist/commands/generate/speech.d.ts

@@ -0,0 +1,21 @@
+/**
+ * @module generate/speech
+ * @description `vibe generate speech` (alias `tts`) — ElevenLabs text-to-
+ * speech with optional duration-fit post-processing. Split out of
+ * `generate.ts` in v0.69 (Plan G Phase 2).
+ */
+import type { Command } from "commander";
+export interface ExecuteSpeechOptions {
+    text: string;
+    output?: string;
+    voice?: string;
+}
+export interface ExecuteSpeechResult {
+    success: boolean;
+    outputPath?: string;
+    characterCount?: number;
+    error?: string;
+}
+export declare function executeSpeech(options: ExecuteSpeechOptions): Promise<ExecuteSpeechResult>;
+export declare function registerSpeechCommand(parent: Command): void;
+export declare function registerNarrationCommand(parent: Command): void;

package/dist/commands/generate/storyboard.d.ts

@@ -0,0 +1,27 @@
+/**
+ * @module generate/storyboard
+ * @description `vibe generate storyboard` — Claude-powered script-to-
+ * storyboard analysis. Split out of `generate.ts` in v0.69 (Plan G Phase 2).
+ */
+import type { Command } from "commander";
+export interface ExecuteStoryboardOptions {
+    content: string;
+    duration?: number;
+    creativity?: "low" | "high";
+    output?: string;
+    apiKey?: string;
+}
+export interface ExecuteStoryboardResult {
+    success: boolean;
+    segments?: Array<{
+        description: string;
+        visuals?: string;
+        duration?: number;
+        narration?: string;
+    }>;
+    segmentCount?: number;
+    outputPath?: string;
+    error?: string;
+}
+export declare function executeStoryboard(options: ExecuteStoryboardOptions): Promise<ExecuteStoryboardResult>;
+export declare function registerStoryboardCommand(parent: Command): void;

package/dist/commands/generate/thumbnail.d.ts

@@ -0,0 +1,8 @@
+/**
+ * @module generate/thumbnail
+ * @description `vibe generate thumbnail` — DALL-E generation OR
+ * best-frame extraction from video via Gemini analysis. Split out of
+ * `generate.ts` in v0.69 (Plan G Phase 2).
+ */
+import type { Command } from "commander";
+export declare function registerThumbnailCommand(parent: Command): void;

package/dist/commands/generate/video-cancel.d.ts

@@ -0,0 +1,8 @@
+/**
+ * @module generate/video-cancel
+ * @description `vibe generate video-cancel` (hidden) — cancel in-flight Grok
+ * or Runway video generation. Split out of `generate.ts` in v0.69 (Plan G
+ * Phase 2).
+ */
+import type { Command } from "commander";
+export declare function registerVideoCancelCommand(parent: Command): void;

package/dist/commands/generate/video-extend.d.ts

@@ -0,0 +1,8 @@
+/**
+ * @module generate/video-extend
+ * @description `vibe generate video-extend` (hidden) — extend video duration
+ * via Kling or Veo (Gemini). Split out of `generate.ts` in v0.69 (Plan G
+ * Phase 2).
+ */
+import type { Command } from "commander";
+export declare function registerVideoExtendCommand(parent: Command): void;

package/dist/commands/generate/video-status.d.ts

@@ -0,0 +1,8 @@
+/**
+ * @module generate/video-status
+ * @description `vibe generate video-status` (hidden) — check Grok/Runway/
+ * Kling video generation status, optionally wait + download. Split out of
+ * `generate.ts` in v0.69 (Plan G Phase 2).
+ */
+import type { Command } from "commander";
+export declare function registerVideoStatusCommand(parent: Command): void;

package/dist/commands/generate/video.d.ts

@@ -0,0 +1,8 @@
+/**
+ * @module generate/video
+ * @description `vibe generate video` (alias `vid`) — multi-provider video
+ * generation. fal.ai (Seedance 2.0), Grok, Veo (Gemini), Kling, Runway.
+ * Split out of `generate.ts` in v0.69 (Plan G Phase 2).
+ */
+import type { Command } from "commander";
+export declare function registerVideoCommand(parent: Command): void;

package/dist/commands/generate.d.ts

@@ -0,0 +1,36 @@
+/**
+ * @module generate
+ *
+ * Top-level `vibe generate` command group for AI asset generation.
+ *
+ * Commands:
+ *   generate image          - Generate image (Gemini, OpenAI, Grok, Runway)
+ *   generate video          - Generate video (Seedance, Grok, Kling, Runway, Veo)
+ *   generate speech         - Text-to-speech (ElevenLabs)
+ *   generate sound-effect   - Sound effects (ElevenLabs)
+ *   generate music          - Music generation (ElevenLabs default, Replicate MusicGen)
+ *   generate music-status   - Check music generation status
+ *   generate storyboard     - Script-to-storyboard (Claude)
+ *   generate motion         - Standalone motion assets (Claude/Gemini + Remotion)
+ *   generate thumbnail      - Thumbnail generation/extraction
+ *   generate background     - AI background generation (OpenAI)
+ *   generate video-status   - Check video generation status (Grok/Runway/Kling)
+ *   generate video-cancel   - Cancel video generation (Grok/Runway)
+ *   generate video-extend   - Extend video (Kling/Veo)
+ *
+ * @dependencies OpenAI, Gemini, Runway, Kling, ElevenLabs, Replicate, Claude, FFmpeg
+ */
+import { Command } from "commander";
+export { executeSoundEffect } from "./generate/sound-effect.js";
+export type { ExecuteSoundEffectOptions, ExecuteSoundEffectResult, } from "./generate/sound-effect.js";
+export { executeMusicStatus } from "./generate/music-status.js";
+export type { ExecuteMusicStatusOptions, ExecuteMusicStatusResult, } from "./generate/music-status.js";
+export { executeBackground } from "./generate/background.js";
+export type { ExecuteBackgroundOptions, ExecuteBackgroundResult } from "./generate/background.js";
+export { executeStoryboard } from "./generate/storyboard.js";
+export type { ExecuteStoryboardOptions, ExecuteStoryboardResult } from "./generate/storyboard.js";
+export { executeSpeech } from "./generate/speech.js";
+export type { ExecuteSpeechOptions, ExecuteSpeechResult } from "./generate/speech.js";
+export { executeMusic } from "./generate/music.js";
+export type { ExecuteMusicOptions, ExecuteMusicResult } from "./generate/music.js";
+export declare const generateCommand: Command;

package/dist/commands/init.d.ts

@@ -0,0 +1,24 @@
+/**
+ * @module commands/init
+ *
+ * `vibe init [project-dir]` — v0.61 C2 project-scope scaffolder.
+ *
+ * Pairs with v0.61 C1 `vibe setup` (user scope). Where setup writes
+ * machine-wide config (`~/.vibeframe/config.yaml`), init writes
+ * project-local files: `AGENTS.md` (cross-tool), `CLAUDE.md` (Claude
+ * Code, imports `@AGENTS.md`), `.env.example`, `.gitignore` additions,
+ * and an optional `vibe.project.yaml`.
+ *
+ * Scaffolding decision tree:
+ *   - Always: `.gitignore` additions, `.env.example`
+ *   - If Claude Code detected (or `--agent claude|all`): `CLAUDE.md`
+ *   - If any non-Claude host detected (or `--agent codex|cursor|all`): `AGENTS.md`
+ *   - If neither detected: write `AGENTS.md` anyway (safe default; works
+ *     for future-installed agents)
+ *
+ * **Idempotent by default**: existing files are skipped (the user's
+ * customisations are sacred). `--force` overwrites them. `--dry-run`
+ * prints the file list without writing.
+ */
+import { Command } from "commander";
+export declare const initCommand: Command;

package/dist/commands/init.test.d.ts

@@ -0,0 +1 @@
+export {};

package/dist/commands/inspect.d.ts

@@ -0,0 +1,20 @@
+/**
+ * @module inspect
+ *
+ * Top-level `vibe inspect` command group for media analysis. (Renamed
+ * from `analyze` in v0.74; `analyze` and `az` aliases were removed in
+ * v0.75. The rename clarifies the read-only intent — `analyze` doubled
+ * as both group and verb in the old design.)
+ *
+ * Commands:
+ *   inspect project - Local project completeness and composition checks
+ *   inspect render  - Local rendered video checks plus optional Gemini review
+ *   inspect media   - Unified analysis for images, videos, and YouTube URLs (Gemini)
+ *   inspect video   - Analyze video files or YouTube URLs with Gemini
+ *   inspect review  - AI video quality review and auto-fix (Gemini)
+ *   inspect suggest - Get AI edit suggestions using Gemini
+ *
+ * @dependencies Gemini (Google), FFmpeg (auto-fix filters)
+ */
+import { Command } from "commander";
+export declare const inspectCommand: Command;

package/dist/commands/media.d.ts

@@ -0,0 +1,2 @@
+import { Command } from "commander";
+export declare const mediaCommand: Command;

package/dist/commands/output.d.ts

@@ -0,0 +1,80 @@
+/**
+ * @module output
+ * @description Shared output helper for --json structured output support.
+ */
+import ora from "ora";
+export declare enum ExitCode {
+    SUCCESS = 0,
+    GENERAL = 1,
+    USAGE = 2,
+    NOT_FOUND = 3,
+    AUTH = 4,
+    API_ERROR = 5,
+    NETWORK = 6
+}
+export interface StructuredError {
+    success: false;
+    error: string;
+    message?: string;
+    code: string;
+    exitCode: ExitCode;
+    suggestion?: string;
+    retryWith?: string[];
+    recoverable?: boolean;
+    retryable: boolean;
+}
+export declare function usageError(msg: string, suggestion?: string): StructuredError;
+export declare function authError(envVar: string, provider: string): StructuredError;
+export declare function apiError(msg: string, retryable?: boolean): StructuredError;
+export declare function notFoundError(path: string): StructuredError;
+export declare function networkError(msg: string): StructuredError;
+export declare function generalError(msg: string, suggestion?: string): StructuredError;
+/** Output structured error then exit */
+export declare function exitWithError(err: StructuredError): never;
+/** Check if --json flag is active */
+export declare function isJsonMode(): boolean;
+/** Check if --quiet flag is active */
+export declare function isQuietMode(): boolean;
+/** Estimated cost ranges by command */
+export declare const COST_ESTIMATES: Record<string, {
+    min: number;
+    max: number;
+    unit: string;
+}>;
+export interface SuccessEnvelopeOptions {
+    /** Canonical command name, e.g. "generate image". Matches `vibe schema --list`. */
+    command: string;
+    /** Domain payload — provider-specific success keys (`provider`, `images`, `outputPath`, etc.). */
+    data: Record<string, unknown>;
+    /** Wallclock start. Use `Date.now()` at the top of the action handler. */
+    startedAt: number;
+    /** Actual cost. Omit for free ops (defaults to 0). For dry-run, defaults to COST_ESTIMATES upper bound. */
+    costUsd?: number;
+    /** Non-fatal signals (provider fallback, deprecated flag, partial cache miss). */
+    warnings?: string[];
+    /** Pass-through of `--dry-run` flag — surfaces as a top-level `dryRun: true` in the envelope. */
+    dryRun?: boolean;
+}
+/**
+ * Emit a canonical success envelope (#33 — 2c). JSON mode prints the
+ * envelope; quiet mode prints a single primary value extracted from
+ * `data.outputPath ?? data.output ?? data.path ?? data.url ?? data.id`;
+ * human mode prints nothing — the caller renders human output itself.
+ *
+ * Canary scope: `generate image` only in 2c-canary. 2c-sweep migrates
+ * the rest. Old `outputResult()` remains for the sweep transition.
+ */
+export declare function outputSuccess(opts: SuccessEnvelopeOptions): void;
+/** Output result - JSON mode outputs JSON, quiet mode outputs primary value only */
+export declare function outputResult(result: Record<string, unknown>): void;
+/** Wrap console output - suppressed in JSON/quiet mode */
+export declare function log(...args: unknown[]): void;
+/** Create a spinner that is silent in JSON/quiet mode */
+export declare function spinner(text: string): ReturnType<typeof ora>;
+/** Suggest next steps - only in human interactive mode */
+export declare function suggestNext(tip: string): void;
+export declare function emitDeprecationWarning(oldName: string, newName: string, removeIn: string): void;
+/** Test-only: reset deduplication memory between cases. */
+export declare function _resetDeprecationMemoryForTesting(): void;
+/** Output an error - always outputs (JSON mode writes to stdout as JSON) */
+export declare function outputError(error: string, details?: Record<string, unknown>): void;

package/dist/commands/output.test.d.ts

@@ -0,0 +1 @@
+export {};

package/dist/commands/plan.d.ts

@@ -0,0 +1,2 @@
+import { Command } from "commander";
+export declare const planCommand: Command;

package/dist/commands/project.d.ts

@@ -0,0 +1,2 @@
+import { Command } from "commander";
+export declare const projectCommand: Command;

package/dist/commands/project.test.d.ts

@@ -0,0 +1 @@
+export {};

package/dist/commands/provider-config-cli.test.d.ts

@@ -0,0 +1 @@
+export {};

package/dist/commands/q-flag-collision.test.d.ts

@@ -0,0 +1 @@
+export {};

package/dist/commands/remix.d.ts

@@ -0,0 +1,20 @@
+/**
+ * @module remix
+ *
+ * Top-level `vibe remix` command group for AI media transformations
+ * on existing video / audio files. (Renamed from `pipeline` in v0.74;
+ * the `pipeline` and `pipe` aliases were removed in v0.75.)
+ *
+ * For BUILDING new video from text intent (storyboard -> MP4), see
+ * `vibe build` (v0.60+) - that's the skills-driven path. Remix here
+ * processes media you already have.
+ *
+ * Commands:
+ *   remix highlights       - Extract highlights from long-form content
+ *   remix auto-shorts      - Generate short-form clips from long-form video
+ *   remix animated-caption - Add word-by-word animated captions
+ *
+ * @dependencies Whisper, Claude, Gemini, ElevenLabs, Kling, Runway, FFmpeg
+ */
+import { Command } from "commander";
+export declare const remixCommand: Command;

package/dist/commands/render.d.ts

@@ -0,0 +1,2 @@
+import { Command } from "commander";
+export declare const renderCommand: Command;

package/dist/commands/run.d.ts

@@ -0,0 +1,14 @@
+/**
+ * `vibe run` command — Execute declarative YAML video pipelines.
+ *
+ * Video as Code: define reproducible, shareable video workflows in YAML.
+ * Each step maps to an existing CLI command's execute function.
+ *
+ * Usage:
+ *   vibe run pipeline.yaml
+ *   vibe run pipeline.yaml --dry-run
+ *   vibe run pipeline.yaml --resume
+ *   vibe run pipeline.yaml -o ./output/
+ */
+import { Command } from "commander";
+export declare const runCommand: Command;

package/dist/commands/sanitize.d.ts

@@ -0,0 +1,20 @@
+/**
+ * @module sanitize
+ * @description Sanitize AI/LLM responses to prevent prompt injection and terminal exploits.
+ */
+/**
+ * Strip suspicious prompt injection patterns from LLM text output.
+ * Catches common injection attempts like "Ignore previous instructions",
+ * fake system prompts, and markdown-disguised commands.
+ */
+export declare function sanitizeLLMResponse(text: string): string;
+/**
+ * Sanitize a file path returned by an AI model.
+ * Prevents path traversal and null byte injection.
+ */
+export declare function sanitizeFilePath(path: string): string;
+/**
+ * Sanitize structured data from AI responses (e.g., JSON parsed results).
+ * Recursively sanitizes all string values.
+ */
+export declare function sanitizeAIResult<T>(data: T): T;

package/dist/commands/scene.d.ts

@@ -0,0 +1,95 @@
+/**
+ * @module scene
+ *
+ * `vibe scene <sub>` — lower-level namespace for scene authoring,
+ * linting, and visual-style browsing. Users and AI agents can
+ * hand-author rich per-scene HTML instead of relying on flat YAML steps
+ * or opaque MP4s.
+ *
+ * For the project flow (init / build / render), see the canonical
+ * top-level commands (`packages/cli/src/commands/{init,build,render}.ts`).
+ * This file owns the lower-level subcommands only:
+ *   - add               — author one scene (template + assets)
+ *   - lint              — in-process Hyperframes lint + --fix
+ *   - repair            — deterministic mechanical repairs
+ *   - list-styles       — browse vendored visual identities
+ *   - install-skill     — retroactive composition-rules install
+ *   - compose-prompts   — emit per-beat plan for a host agent (no LLM call)
+ */
+import { Command } from "commander";
+import { type TtsProviderName } from "./_shared/tts-resolve.js";
+import { type ScenePreset, type LottieOverlayInput } from "./_shared/scene-html-emit.js";
+export declare const sceneCommand: Command;
+export interface SceneAddOptions {
+    name: string;
+    preset: ScenePreset;
+    /** Narration text. If the value is an existing file path, its content is used. */
+    narration?: string;
+    /**
+     * Path to an existing narration audio file (.wav/.mp3). When provided,
+     * skips TTS entirely and copies the file into the project's `assets/`.
+     * Compatible with `npx hyperframes tts`, `say`, or any other external
+     * synthesis tool. The transcript is still generated unless
+     * `skipTranscribe` is set.
+     */
+    narrationFile?: string;
+    /** Explicit duration in seconds. Overrides narration-derived duration. */
+    duration?: number;
+    /** Image generation prompt. */
+    visuals?: string;
+    headline?: string;
+    kicker?: string;
+    /** Project directory. Defaults to cwd. */
+    projectDir?: string;
+    /** Filename of the root composition (relative to projectDir). */
+    insertInto?: string;
+    /** "gemini" | "openai". */
+    imageProvider?: string;
+    /** TTS provider preference. Defaults to `"auto"` (ElevenLabs if key set, else Kokoro). */
+    tts?: TtsProviderName;
+    /** Voice id (ElevenLabs name/id, or Kokoro id like `af_heart`). */
+    voice?: string;
+    /** When true, skip TTS even if narration is provided. */
+    skipAudio?: boolean;
+    /** When true, skip image generation even if visuals is provided. */
+    skipImage?: boolean;
+    /**
+     * When true, skip the Whisper word-level transcribe step that would
+     * otherwise emit `assets/transcript-<id>.json`.
+     */
+    skipTranscribe?: boolean;
+    /** BCP-47 language hint forwarded to Whisper (e.g. `"en"`, `"ko"`). */
+    transcribeLanguage?: string;
+    /** Overwrite existing compositions/scene-<id>.html. */
+    force?: boolean;
+    /** Lottie animation overlay options. */
+    lottie?: LottieOverlayInput;
+    /** Progress sink (CLI spinner / agent stream). */
+    onProgress?: (msg: string) => void;
+}
+export interface SceneAddResult {
+    success: boolean;
+    id: string;
+    preset: ScenePreset;
+    start: number;
+    duration: number;
+    scenePath: string;
+    rootPath: string;
+    audioPath?: string;
+    imagePath?: string;
+    /**
+     * Project-relative path to `assets/transcript-<id>.json` when Whisper
+     * word-level transcribe ran. `undefined` when skipped or when the audio
+     * source produced no narration text to transcribe.
+     */
+    transcriptPath?: string;
+    /** Number of word entries emitted into the transcript JSON. */
+    transcriptWordCount?: number;
+    lottiePath?: string;
+    error?: string;
+}
+export declare function executeSceneAdd(opts: SceneAddOptions): Promise<SceneAddResult>;
+export declare function resolveSceneRepairTarget(rootArg?: string, projectArg?: string): Promise<{
+    projectDir: string;
+    rootRel: string;
+}>;

package/dist/commands/scene.test.d.ts

@@ -0,0 +1 @@
+export {};

package/dist/commands/schema.d.ts

@@ -0,0 +1,12 @@
+/**
+ * @module schema
+ * @description Schema introspection command. Outputs JSON Schema for any CLI command,
+ * enabling agent introspection without static docs.
+ *
+ * Usage: vibe schema generate.image
+ *        vibe schema edit.silence-cut
+ *        vibe schema --list
+ */
+import { Command } from "commander";
+export declare const schemaCommand: Command;
+export declare function buildSchema(cmd: Command, toolName: string, commandPath?: string): Record<string, unknown>;

package/dist/commands/setup.d.ts

@@ -0,0 +1,5 @@
+/**
+ * Setup command - Interactive configuration wizard
+ */
+import { Command } from "commander";
+export declare const setupCommand: Command;

package/dist/commands/setup.test.d.ts

@@ -0,0 +1 @@
+export {};

package/dist/commands/status.d.ts

@@ -0,0 +1,2 @@
+import { Command } from "commander";
+export declare const statusCommand: Command;

package/dist/commands/storyboard.d.ts

@@ -0,0 +1,2 @@
+import { Command } from "commander";
+export declare const storyboardCommand: Command;