videoclaw 3.0.0-alpha.1

package/dist/cli/args.d.ts

@@ -0,0 +1,59 @@
+export declare function validateInitSlug(value: string): void;
+export declare function parseFlagValue(args: string[], flag: string): string | undefined;
+/**
+ * Parse `--project <slug>` (or another slug-bearing flag) and validate the
+ * value against `isProjectSlug`, so a flag-looking token (`--project --json`)
+ * or malformed slug fails fast as `invalid_slug` instead of being silently
+ * accepted as a project name. Returns undefined when the flag is absent —
+ * callers still decide whether the flag is required.
+ */
+export declare function parseProjectSlugFlag(args: string[], flag?: string): string | undefined;
+export declare function parseRepeatableFlag(args: string[], flag: string): string[];
+export declare function parsePositiveIntegerFlag(args: string[], flag: string): number | undefined;
+export declare function parseNonNegativeIntegerFlag(args: string[], flag: string): number | undefined;
+export declare function parseSceneIndexFlag(args: string[]): number;
+export declare function parseSceneCharacters(args: string[]): Map<number, string[]>;
+/**
+ * Parse `--scene-color <sceneIndex>:<gradeId>` assignments into a sceneIndex →
+ * grade-id map. The grade id is validated against {@link GRADE_FILTER_IDS} so a
+ * typo fails fast rather than silently rendering ungraded. This is the authoring
+ * front door for the narrative color language (the colorState the preview shows
+ * and assemble applies per scene).
+ */
+export declare function parseSceneColorStates(args: string[]): Map<number, string>;
+/**
+ * Parse `--scene-voice <sceneIndex>:<preset>` assignments into a sceneIndex →
+ * voice-preset map. The preset is a Flow v1 voice-narration name routed to the
+ * veo-useapi transport's `flow.ts --voice` (omni-flash-only at the provider).
+ */
+export declare function parseSceneVoicePresets(args: string[]): Map<number, string>;
+/**
+ * Parse `--scene-ref-video <sceneIndex>:<mediaId>` assignments into a
+ * sceneIndex → V2V edit source-media-id map (veo-useapi `flow.ts --ref-video`,
+ * omni-flash-only). This is the dedicated video-to-video reference, NOT the
+ * scene-chaining seed.
+ */
+export declare function parseSceneRefVideos(args: string[]): Map<number, string>;
+/**
+ * Parse `--scene-first-frame <sceneIndex>[,<sceneIndex>...]` (repeatable) into a
+ * Set of scene indices that should use omni-flash First-Frame (startImage / I2V)
+ * mode — gated by VCLAW_OMNI_FIRST_FRAME at execution time (build-ahead). Each
+ * value may be a single index or a comma-separated list.
+ */
+export declare function parseSceneFirstFrames(args: string[]): Set<number>;
+export declare function slugifyProject(value: string): string;
+export declare function shellQuote(value: string): string;
+export declare function requireSpendConfirmation(args: string[], dryRun: boolean, command: string, provider: string): void;
+export declare function parseExecutionProfileFlags(args: string[]): Record<string, unknown>;
+export declare function applyPlatformExecutionProfileDefaults(platform: string | undefined, profile: Record<string, unknown>): Record<string, unknown>;
+export declare function buildBriefEventPayload(input: {
+    artifactPath: string;
+    title: string;
+    targetRuntimeSeconds?: number;
+    clipDurationSeconds?: number;
+    genre?: string;
+    platform?: string;
+    executionProfile?: Record<string, unknown>;
+    source?: string;
+}): Record<string, unknown>;
+//# sourceMappingURL=args.d.ts.map

package/dist/cli/args.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"args.d.ts","sourceRoot":"","sources":["../../src/cli/args.ts"],"names":[],"mappings":"AAmCA,wBAAgB,gBAAgB,CAAC,KAAK,EAAE,MAAM,GAAG,IAAI,CAuCpD;AAED,wBAAgB,cAAc,CAAC,IAAI,EAAE,MAAM,EAAE,EAAE,IAAI,EAAE,MAAM,GAAG,MAAM,GAAG,SAAS,CAI/E;AAED;;;;;;GAMG;AACH,wBAAgB,oBAAoB,CAAC,IAAI,EAAE,MAAM,EAAE,EAAE,IAAI,SAAc,GAAG,MAAM,GAAG,SAAS,CAoB3F;AAED,wBAAgB,mBAAmB,CAAC,IAAI,EAAE,MAAM,EAAE,EAAE,IAAI,EAAE,MAAM,GAAG,MAAM,EAAE,CAQ1E;AAED,wBAAgB,wBAAwB,CAAC,IAAI,EAAE,MAAM,EAAE,EAAE,IAAI,EAAE,MAAM,GAAG,MAAM,GAAG,SAAS,CAQzF;AAED,wBAAgB,2BAA2B,CAAC,IAAI,EAAE,MAAM,EAAE,EAAE,IAAI,EAAE,MAAM,GAAG,MAAM,GAAG,SAAS,CAQ5F;AAED,wBAAgB,mBAAmB,CAAC,IAAI,EAAE,MAAM,EAAE,GAAG,MAAM,CAU1D;AAED,wBAAgB,oBAAoB,CAAC,IAAI,EAAE,MAAM,EAAE,GAAG,GAAG,CAAC,MAAM,EAAE,MAAM,EAAE,CAAC,CAkB1E;AAED;;;;;;GAMG;AACH,wBAAgB,qBAAqB,CAAC,IAAI,EAAE,MAAM,EAAE,GAAG,GAAG,CAAC,MAAM,EAAE,MAAM,CAAC,CAgBzE;AAED;;;;GAIG;AACH,wBAAgB,sBAAsB,CAAC,IAAI,EAAE,MAAM,EAAE,GAAG,GAAG,CAAC,MAAM,EAAE,MAAM,CAAC,CAa1E;AAED;;;;;GAKG;AACH,wBAAgB,mBAAmB,CAAC,IAAI,EAAE,MAAM,EAAE,GAAG,GAAG,CAAC,MAAM,EAAE,MAAM,CAAC,CAavE;AAED;;;;;GAKG;AACH,wBAAgB,qBAAqB,CAAC,IAAI,EAAE,MAAM,EAAE,GAAG,GAAG,CAAC,MAAM,CAAC,CAajE;AAED,wBAAgB,cAAc,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,CAOpD;AAED,wBAAgB,UAAU,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,CAEhD;AAED,wBAAgB,wBAAwB,CACtC,IAAI,EAAE,MAAM,EAAE,EACd,MAAM,EAAE,OAAO,EACf,OAAO,EAAE,MAAM,EACf,QAAQ,EAAE,MAAM,GACf,IAAI,CAON;AAED,wBAAgB,0BAA0B,CAAC,IAAI,EAAE,MAAM,EAAE,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAWlF;AAED,wBAAgB,qCAAqC,CACnD,QAAQ,EAAE,MAAM,GAAG,SAAS,EAC5B,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAC/B,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAazB;AAED,wBAAgB,sBAAsB,CAAC,KAAK,EAAE;IAC5C,YAAY,EAAE,MAAM,CAAC;IACrB,KAAK,EAAE,MAAM,CAAC;IACd,oBAAoB,CAAC,EAAE,MAAM,CAAC;IAC9B,mBAAmB,CAAC,EAAE,MAAM,CAAC;IAC7B,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,gBAAgB,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IAC3C,MAAM,CAAC,EAAE,MAAM,CAAC;CACjB,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAa1B"}

package/dist/cli/args.js

@@ -0,0 +1,279 @@
+/**
+ * CLI argument parsing + slug/spend helpers for `vclaw`, plus the shared
+ * execution-profile / brief-event payload builders.
+ *
+ * These are the pure, stateless helpers every command handler relies on,
+ * extracted from the monolithic `vclaw.ts` so handlers can move into their own
+ * modules that import from here — `parseFlagValue` alone is used 480+ times, so
+ * it has to live in a leaf module before any handler can be split out.
+ * `parseExecutionProfileFlags` / `applyPlatformExecutionProfileDefaults` /
+ * `buildBriefEventPayload` live here too because they are shared by several
+ * handler modules (create, clone) and a leaf home keeps those modules from
+ * importing each other. Nothing here touches process or global state; the only
+ * dependencies are the `VclawError` type, the `isProjectSlug` validator, the
+ * `GRADE_FILTER_IDS` list, and the `parseExecutionProfileInput` normalizer (none
+ * of which import the CLI, so there is no import cycle).
+ */
+import { VclawError } from '../video/errors.js';
+import { isProjectSlug } from '../video/projects.js';
+import { GRADE_FILTER_IDS } from '../video/assemble/stitch.js';
+import { parseExecutionProfileInput } from '../video/execution-profile.js';
+const RESERVED_SLUG_NAMES = new Set([
+    'history',
+    'artifacts',
+    'checkpoints',
+    'events',
+    'state',
+    'outputs',
+    'assets',
+    'obsidian',
+    'characters',
+    'notes',
+    'tmp',
+]);
+export function validateInitSlug(value) {
+    if (value.length < 3 || value.length > 64) {
+        throw new VclawError('invalid_slug', `video init: slug must be 3-64 chars (got ${value.length}): ${JSON.stringify(value)}`, { slug: value, reason: 'length' });
+    }
+    if (value.startsWith('-')) {
+        throw new VclawError('invalid_slug', `video init: slug cannot start with '-' (looks like a CLI flag): ${JSON.stringify(value)}. ` +
+            `If you meant to pass --project as a flag value, that's the argv-as-slug bug — run \`vclaw video init <real-slug>\` instead.`, { slug: value, reason: 'leading-hyphen' });
+    }
+    if (!isProjectSlug(value)) {
+        throw new VclawError('invalid_slug', `video init: slug must match /^[a-z0-9](?:[a-z0-9-]*[a-z0-9])?$/ (got ${JSON.stringify(value)}). ` +
+            `Lowercase letters, digits, and single hyphens only; must start and end with [a-z0-9].`, { slug: value, reason: 'pattern' });
+    }
+    if (RESERVED_SLUG_NAMES.has(value)) {
+        throw new VclawError('invalid_slug', `video init: slug ${JSON.stringify(value)} is a reserved per-project directory name. ` +
+            `Reserved: ${[...RESERVED_SLUG_NAMES].sort().join(', ')}.`, { slug: value, reason: 'reserved' });
+    }
+    if (value.includes('--')) {
+        throw new VclawError('invalid_slug', `video init: slug cannot contain consecutive hyphens '--' (got ${JSON.stringify(value)}).`, { slug: value, reason: 'double-hyphen' });
+    }
+}
+export function parseFlagValue(args, flag) {
+    const index = args.indexOf(flag);
+    if (index < 0)
+        return undefined;
+    return args[index + 1];
+}
+/**
+ * Parse `--project <slug>` (or another slug-bearing flag) and validate the
+ * value against `isProjectSlug`, so a flag-looking token (`--project --json`)
+ * or malformed slug fails fast as `invalid_slug` instead of being silently
+ * accepted as a project name. Returns undefined when the flag is absent —
+ * callers still decide whether the flag is required.
+ */
+export function parseProjectSlugFlag(args, flag = '--project') {
+    const value = parseFlagValue(args, flag);
+    if (value === undefined)
+        return undefined;
+    if (value.startsWith('-')) {
+        throw new VclawError('invalid_slug', `${flag} value ${JSON.stringify(value)} looks like a CLI flag, not a project slug. ` +
+            `Did you forget the slug after ${flag}?`, { slug: value, flag, reason: 'leading-hyphen' });
+    }
+    if (!isProjectSlug(value)) {
+        throw new VclawError('invalid_slug', `${flag} value ${JSON.stringify(value)} is not a valid project slug ` +
+            `(lowercase letters, digits, and single hyphens; must start and end with [a-z0-9]).`, { slug: value, flag, reason: 'pattern' });
+    }
+    return value;
+}
+export function parseRepeatableFlag(args, flag) {
+    const values = [];
+    for (let index = 0; index < args.length; index += 1) {
+        if (args[index] === flag) {
+            values.push(args[index + 1] ?? '');
+        }
+    }
+    return values.filter(Boolean);
+}
+export function parsePositiveIntegerFlag(args, flag) {
+    const raw = parseFlagValue(args, flag);
+    if (raw === undefined)
+        return undefined;
+    const value = Number(raw);
+    if (!Number.isInteger(value) || value <= 0) {
+        throw new VclawError('invalid_flag_value', `video multi-shot: ${flag} must be a positive integer, got: ${raw}`, { flag, value: raw });
+    }
+    return value;
+}
+export function parseNonNegativeIntegerFlag(args, flag) {
+    const raw = parseFlagValue(args, flag);
+    if (raw === undefined)
+        return undefined;
+    const value = Number(raw);
+    if (!Number.isInteger(value) || value < 0) {
+        throw new VclawError('invalid_flag_value', `video multi-shot: ${flag} must be a non-negative integer, got: ${raw}`, { flag, value: raw });
+    }
+    return value;
+}
+export function parseSceneIndexFlag(args) {
+    const raw = parseFlagValue(args, '--scene');
+    if (raw === undefined) {
+        throw new VclawError('missing_required_flag', 'missing --scene <sceneIndex>', { missing: ['--scene'] });
+    }
+    const value = Number(raw);
+    if (!Number.isInteger(value) || value < 0) {
+        throw new VclawError('invalid_flag_value', `invalid --scene value: ${raw}. Expected a non-negative integer.`, { flag: '--scene', value: raw });
+    }
+    return value;
+}
+export function parseSceneCharacters(args) {
+    const assignments = parseRepeatableFlag(args, '--scene-character');
+    const charactersByScene = new Map();
+    for (const assignment of assignments) {
+        const separatorIndex = assignment.indexOf(':');
+        if (separatorIndex < 0) {
+            throw new Error(`Invalid --scene-character value: "${assignment}". Expected sceneIndex:name`);
+        }
+        const sceneIndex = Number(assignment.slice(0, separatorIndex));
+        const name = assignment.slice(separatorIndex + 1).trim();
+        if (!Number.isInteger(sceneIndex) || sceneIndex < 0 || !name) {
+            throw new Error(`Invalid --scene-character value: "${assignment}". Expected sceneIndex:name`);
+        }
+        const current = charactersByScene.get(sceneIndex) ?? [];
+        current.push(name);
+        charactersByScene.set(sceneIndex, current);
+    }
+    return charactersByScene;
+}
+/**
+ * Parse `--scene-color <sceneIndex>:<gradeId>` assignments into a sceneIndex →
+ * grade-id map. The grade id is validated against {@link GRADE_FILTER_IDS} so a
+ * typo fails fast rather than silently rendering ungraded. This is the authoring
+ * front door for the narrative color language (the colorState the preview shows
+ * and assemble applies per scene).
+ */
+export function parseSceneColorStates(args) {
+    const assignments = parseRepeatableFlag(args, '--scene-color');
+    const colorByScene = new Map();
+    for (const assignment of assignments) {
+        const separatorIndex = assignment.indexOf(':');
+        const sceneIndex = separatorIndex >= 0 ? Number(assignment.slice(0, separatorIndex)) : NaN;
+        const gradeId = separatorIndex >= 0 ? assignment.slice(separatorIndex + 1).trim() : '';
+        if (!Number.isInteger(sceneIndex) || sceneIndex < 0 || !gradeId) {
+            throw new Error(`Invalid --scene-color value: "${assignment}". Expected sceneIndex:gradeId`);
+        }
+        if (!GRADE_FILTER_IDS.includes(gradeId)) {
+            throw new Error(`Invalid --scene-color grade "${gradeId}". Known grades: ${GRADE_FILTER_IDS.join(', ')}`);
+        }
+        colorByScene.set(sceneIndex, gradeId);
+    }
+    return colorByScene;
+}
+/**
+ * Parse `--scene-voice <sceneIndex>:<preset>` assignments into a sceneIndex →
+ * voice-preset map. The preset is a Flow v1 voice-narration name routed to the
+ * veo-useapi transport's `flow.ts --voice` (omni-flash-only at the provider).
+ */
+export function parseSceneVoicePresets(args) {
+    const assignments = parseRepeatableFlag(args, '--scene-voice');
+    const voiceByScene = new Map();
+    for (const assignment of assignments) {
+        const separatorIndex = assignment.indexOf(':');
+        const sceneIndex = separatorIndex >= 0 ? Number(assignment.slice(0, separatorIndex)) : NaN;
+        const preset = separatorIndex >= 0 ? assignment.slice(separatorIndex + 1).trim() : '';
+        if (!Number.isInteger(sceneIndex) || sceneIndex < 0 || !preset) {
+            throw new Error(`Invalid --scene-voice value: "${assignment}". Expected sceneIndex:preset`);
+        }
+        voiceByScene.set(sceneIndex, preset);
+    }
+    return voiceByScene;
+}
+/**
+ * Parse `--scene-ref-video <sceneIndex>:<mediaId>` assignments into a
+ * sceneIndex → V2V edit source-media-id map (veo-useapi `flow.ts --ref-video`,
+ * omni-flash-only). This is the dedicated video-to-video reference, NOT the
+ * scene-chaining seed.
+ */
+export function parseSceneRefVideos(args) {
+    const assignments = parseRepeatableFlag(args, '--scene-ref-video');
+    const refVideoByScene = new Map();
+    for (const assignment of assignments) {
+        const separatorIndex = assignment.indexOf(':');
+        const sceneIndex = separatorIndex >= 0 ? Number(assignment.slice(0, separatorIndex)) : NaN;
+        const mediaId = separatorIndex >= 0 ? assignment.slice(separatorIndex + 1).trim() : '';
+        if (!Number.isInteger(sceneIndex) || sceneIndex < 0 || !mediaId) {
+            throw new Error(`Invalid --scene-ref-video value: "${assignment}". Expected sceneIndex:mediaId`);
+        }
+        refVideoByScene.set(sceneIndex, mediaId);
+    }
+    return refVideoByScene;
+}
+/**
+ * Parse `--scene-first-frame <sceneIndex>[,<sceneIndex>...]` (repeatable) into a
+ * Set of scene indices that should use omni-flash First-Frame (startImage / I2V)
+ * mode — gated by VCLAW_OMNI_FIRST_FRAME at execution time (build-ahead). Each
+ * value may be a single index or a comma-separated list.
+ */
+export function parseSceneFirstFrames(args) {
+    const assignments = parseRepeatableFlag(args, '--scene-first-frame');
+    const firstFrameScenes = new Set();
+    for (const assignment of assignments) {
+        for (const token of assignment.split(',')) {
+            const sceneIndex = Number(token.trim());
+            if (!Number.isInteger(sceneIndex) || sceneIndex < 0) {
+                throw new Error(`Invalid --scene-first-frame value: "${assignment}". Expected sceneIndex or sceneIndex,sceneIndex`);
+            }
+            firstFrameScenes.add(sceneIndex);
+        }
+    }
+    return firstFrameScenes;
+}
+export function slugifyProject(value) {
+    return value
+        .trim()
+        .toLowerCase()
+        .replace(/[^a-z0-9]+/g, '-')
+        .replace(/^-+|-+$/g, '')
+        .slice(0, 80);
+}
+export function shellQuote(value) {
+    return JSON.stringify(value);
+}
+export function requireSpendConfirmation(args, dryRun, command, provider) {
+    if (dryRun || args.includes('--confirm-spend'))
+        return;
+    throw new VclawError('spend_confirmation_required', `video ${command} would call a PAID ${provider} provider. Re-run with --dry-run to preview offline, or --confirm-spend to authorize the spend.`, { command, hint: '--dry-run | --confirm-spend' });
+}
+export function parseExecutionProfileFlags(args) {
+    const audioRaw = parseFlagValue(args, '--audio');
+    const profile = parseExecutionProfileInput({
+        aspectRatio: parseFlagValue(args, '--aspect-ratio'),
+        quality: parseFlagValue(args, '--quality'),
+        resolution: parseFlagValue(args, '--resolution'),
+        generateAudio: audioRaw === undefined ? undefined : audioRaw === 'on' ? true : audioRaw === 'off' ? false : undefined,
+        outputCount: parseFlagValue(args, '--outputs') ? Number(parseFlagValue(args, '--outputs')) : undefined,
+        veoModel: parseFlagValue(args, '--veo-model'),
+    });
+    return Object.keys(profile).length > 0 ? profile : {};
+}
+export function applyPlatformExecutionProfileDefaults(platform, profile) {
+    const normalized = String(platform ?? '').trim().toLowerCase();
+    if (!normalized)
+        return profile;
+    if (!profile.aspectRatio) {
+        if (['tiktok', 'reels', 'shorts', 'instagram-reels', 'youtube-shorts'].includes(normalized)) {
+            profile.aspectRatio = '9:16';
+        }
+        else if (['youtube', 'linkedin', 'web'].includes(normalized)) {
+            profile.aspectRatio = '16:9';
+        }
+    }
+    return profile;
+}
+export function buildBriefEventPayload(input) {
+    return {
+        artifactPath: input.artifactPath,
+        title: input.title,
+        ...(typeof input.targetRuntimeSeconds === 'number' ? { targetRuntimeSeconds: input.targetRuntimeSeconds } : {}),
+        ...(typeof input.clipDurationSeconds === 'number' ? { clipDurationSeconds: input.clipDurationSeconds } : {}),
+        ...(input.genre ? { genre: input.genre } : {}),
+        ...(input.platform ? { platform: input.platform } : {}),
+        ...(input.executionProfile && Object.keys(input.executionProfile).length > 0
+            ? { executionProfile: input.executionProfile }
+            : {}),
+        ...(input.source ? { source: input.source } : {}),
+    };
+}
+//# sourceMappingURL=args.js.map

package/dist/cli/args.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"args.js","sourceRoot":"","sources":["../../src/cli/args.ts"],"names":[],"mappings":"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"}

package/dist/cli/handlers/analysis.d.ts

@@ -0,0 +1,3 @@
+export declare function handleVideoAnalyze(args: string[]): Promise<void>;
+export declare function handleVideoBrandExtract(args: string[]): Promise<void>;
+//# sourceMappingURL=analysis.d.ts.map

package/dist/cli/handlers/analysis.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"analysis.d.ts","sourceRoot":"","sources":["../../../src/cli/handlers/analysis.ts"],"names":[],"mappings":"AA0BA,wBAAsB,kBAAkB,CAAC,IAAI,EAAE,MAAM,EAAE,GAAG,OAAO,CAAC,IAAI,CAAC,CAuEtE;AAED,wBAAsB,uBAAuB,CAAC,IAAI,EAAE,MAAM,EAAE,GAAG,OAAO,CAAC,IAAI,CAAC,CAsB3E"}

package/dist/cli/handlers/analysis.js

@@ -0,0 +1,111 @@
+/**
+ * Reference-analysis command handlers for `vclaw`.
+ *
+ * Extracted verbatim from the monolithic `vclaw.ts`: `analyze` (capture a
+ * reference video's analyze-output artifact, manual flags or `--auto` via
+ * the Gemini key pool) and `brand-extract` (scrape a website -> brand-DNA
+ * artifact for `brief --from-brand-dna`). Dispatch stays in `vclaw.ts`.
+ */
+import { basename } from 'node:path';
+import { parseFlagValue, parseProjectSlugFlag, parseRepeatableFlag } from '../args.js';
+import { VclawError } from '../../video/errors.js';
+import { ensureProjectWorkspace, updateProjectManifestState } from '../../video/workspace.js';
+import { writeArtifact } from '../../video/artifact-store.js';
+import { appendProjectEvent } from '../../video/events.js';
+import { writeStageCheckpoint } from '../../video/checkpoints.js';
+import { createAnalyzeOutput } from '../../video/analyze-output.js';
+import { generateAnalyzeOutputWithGemini } from '../../video/gemini-analyze.js';
+import { appendVideoContextChangelog } from '../../video/video-context.js';
+import { scrapeSite, runBrandExtraction, createBrandDnaArtifact, writeBrandDnaArtifact, } from '../../video/brand-dna.js';
+export async function handleVideoAnalyze(args) {
+    const slug = parseProjectSlugFlag(args);
+    const source = parseFlagValue(args, '--source');
+    if (!slug || !source) {
+        throw new VclawError('missing_required_flag', 'video analyze requires --project <slug> and --source <path-or-url>');
+    }
+    const root = parseFlagValue(args, '--root') ?? process.cwd();
+    const workspace = await ensureProjectWorkspace(slug, root);
+    const title = parseFlagValue(args, '--title') ?? basename(source);
+    const durationRaw = parseFlagValue(args, '--duration');
+    const pacing = (parseFlagValue(args, '--pacing') ?? 'mixed');
+    const motion = (parseFlagValue(args, '--motion') ?? 'unknown');
+    const beats = parseRepeatableFlag(args, '--beat');
+    const keep = parseRepeatableFlag(args, '--keep');
+    const change = parseRepeatableFlag(args, '--change');
+    const reusableVariables = parseRepeatableFlag(args, '--var');
+    const auto = args.includes('--auto');
+    const artifact = auto
+        ? await generateAnalyzeOutputWithGemini({
+            source,
+            title,
+            durationSeconds: durationRaw ? Number(durationRaw) : undefined,
+        })
+        : createAnalyzeOutput({
+            reference: {
+                source,
+                title,
+                durationSeconds: durationRaw ? Number(durationRaw) : undefined,
+            },
+            pacing: {
+                label: pacing,
+                notes: [],
+            },
+            structure: {
+                beats,
+            },
+            motionClassification: {
+                primaryMode: motion,
+                notes: [],
+            },
+            keep,
+            change,
+            reusableVariables,
+        });
+    const artifactPath = await writeArtifact(workspace, 'analyze-output', artifact);
+    await writeStageCheckpoint(workspace, {
+        stage: 'brief',
+        status: 'completed',
+        generatedAt: artifact.generatedAt,
+        artifacts: {
+            'analyze-output': artifactPath,
+        },
+        summary: 'Reference analysis artifact captured.',
+        issues: [],
+        nextAction: 'Use analyze output to draft the project brief and storyboard.',
+    });
+    await appendProjectEvent(workspace, {
+        type: 'artifact.analyze-output.written',
+        recordedAt: artifact.generatedAt,
+        payload: { artifactPath, source },
+    });
+    await updateProjectManifestState(workspace, {
+        updatedAt: artifact.generatedAt,
+        currentStage: 'storyboard',
+        lastCompletedStage: 'brief',
+        lastCheckpointStatus: 'completed',
+    });
+    await appendVideoContextChangelog(root, `${artifact.generatedAt} analyze: captured reference "${title}" for project ${slug}.`);
+    process.stdout.write(`${JSON.stringify({ workspace, artifactPath, artifact }, null, 2)}\n`);
+}
+export async function handleVideoBrandExtract(args) {
+    const slug = parseProjectSlugFlag(args);
+    const url = parseFlagValue(args, '--url');
+    if (!slug || !url) {
+        const missing = [];
+        if (!slug)
+            missing.push('--project');
+        if (!url)
+            missing.push('--url');
+        throw new VclawError('missing_required_flag', 'video brand-extract requires --project <slug> and --url <website>', { missing });
+    }
+    const root = parseFlagValue(args, '--root') ?? process.cwd();
+    const endpoint = parseFlagValue(args, '--gemini-endpoint') ?? undefined;
+    const workspace = await ensureProjectWorkspace(slug, root);
+    const scraped = await scrapeSite(url);
+    const content = await runBrandExtraction(scraped, { ...(endpoint ? { endpoint } : {}) });
+    const artifact = createBrandDnaArtifact({ projectSlug: slug, content });
+    const artifactPath = await writeBrandDnaArtifact(workspace, artifact);
+    await appendVideoContextChangelog(root, `${artifact.createdAt} brand-extract: captured brand DNA for project ${slug} from ${url}.`);
+    process.stdout.write(`${JSON.stringify({ workspace, artifactPath, artifact }, null, 2)}\n`);
+}
+//# sourceMappingURL=analysis.js.map

package/dist/cli/handlers/analysis.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"analysis.js","sourceRoot":"","sources":["../../../src/cli/handlers/analysis.ts"],"names":[],"mappings":"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"}

package/dist/cli/handlers/audio.d.ts

@@ -0,0 +1,25 @@
+export declare function handleVideoSoundtrack(args: string[]): Promise<void>;
+export declare function handleVideoNarrate(args: string[]): Promise<void>;
+/**
+ * Fail-closed spend gate for the paid audio commands (narrate / dialogue / sfx /
+ * soundtrack). A direct CLI invocation that is neither a `--dry-run` preview nor
+ * an explicit `--confirm-spend` authorization is REFUSED rather than silently
+ * calling a paid provider. Orchestrated runs are gated separately by the studio
+ * `--execute` classifier (these commands are NOT on its FREE allow-list).
+ */
+export declare function handleVideoDialogue(args: string[]): Promise<void>;
+export declare function handleVideoSfx(args: string[]): Promise<void>;
+/**
+ * `voice-clone` — build a reusable "blank video with audio" voice reference (the
+ * cartoon-show voice-cloning trick). Given an audio sample, render a black-frame
+ * MP4 carrying that voice and persist it as a voice clone asset
+ * (`artifacts/voice-clones.json`), optionally bound to a character so any scene
+ * featuring that character locks the cloned voice in the Seedance generation (or
+ * reference a voice explicitly with an `@<voice-name>` tag).
+ *
+ * Local ffmpeg only → no provider spend, so NO `--confirm-spend` gate. But it is
+ * still default-safe: without `--execute` (or with `--dry-run`) it PLANS only —
+ * prints the ffmpeg command(s) + would-be artifact and writes/renders nothing.
+ */
+export declare function handleVideoVoiceClone(args: string[]): Promise<void>;
+//# sourceMappingURL=audio.d.ts.map

package/dist/cli/handlers/audio.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"audio.d.ts","sourceRoot":"","sources":["../../../src/cli/handlers/audio.ts"],"names":[],"mappings":"AAsBA,wBAAsB,qBAAqB,CAAC,IAAI,EAAE,MAAM,EAAE,GAAG,OAAO,CAAC,IAAI,CAAC,CAqEzE;AAED,wBAAsB,kBAAkB,CAAC,IAAI,EAAE,MAAM,EAAE,GAAG,OAAO,CAAC,IAAI,CAAC,CAmEtE;AAED;;;;;;GAMG;AACH,wBAAsB,mBAAmB,CAAC,IAAI,EAAE,MAAM,EAAE,GAAG,OAAO,CAAC,IAAI,CAAC,CAgEvE;AAED,wBAAsB,cAAc,CAAC,IAAI,EAAE,MAAM,EAAE,GAAG,OAAO,CAAC,IAAI,CAAC,CAoElE;AAED;;;;;;;;;;;GAWG;AACH,wBAAsB,qBAAqB,CAAC,IAAI,EAAE,MAAM,EAAE,GAAG,OAAO,CAAC,IAAI,CAAC,CAkFzE"}