videoclaw 3.0.0-alpha.1

package/dist/video/studio/execute.js

@@ -0,0 +1,270 @@
+/**
+ * Allow-list of subcommands verified to be fully offline: they only read/write
+ * local project files and run pure logic — no provider credits, remote storage
+ * pushes, or live external/paid API (Gemini/R2/network) calls. A step is only
+ * classified `free` when its subcommand is on this list; everything else is a
+ * spend step (fail-closed). Keep this list conservative — when in doubt, leave a
+ * subcommand OFF so it is treated as spend rather than silently run.
+ */
+const FREE_SUBCOMMANDS = new Set([
+    // Read-only status / reporting
+    'status',
+    'readiness',
+    'next-actions',
+    'list',
+    'index',
+    'metrics',
+    'report',
+    'doctor-project',
+    'doctor-portfolio',
+    'candidates-list',
+    'candidates-show',
+    // Local HTML portal generation (the publish-* variants push to R2 and are NOT free)
+    'portal',
+    'portal-index',
+    'review-ui',
+    // Pure prompt/cinematography composers + deterministic local renders
+    'filmmaking-prompts',
+    'multi-shot',
+    'prompt-lint',
+    'cinema-profile',
+    'storyboard-grid',
+    // Template / clone-plan reads (local template store + artifacts)
+    'template-list',
+    'template-show',
+    'storyboard-template-list',
+    'storyboard-template-show',
+    'clone-plan',
+    // Character / reference-sheet local artifact reads & writes
+    'character-list',
+    'character-show',
+    'reference-sheet-add',
+    'reference-sheet-list',
+    'reference-sheet-show',
+    'reference-sheet-bind',
+    'reference-sheet-validate',
+    // Scene-candidate selection / chaining (local artifact + event writes)
+    'select-candidate',
+    'reject-candidate',
+    'reroll-scene',
+    'chain-from',
+    'unchain',
+    // Local exports (write to disk / local Obsidian vault, no network)
+    'export-csv',
+    'export-obsidian',
+    'sync-obsidian',
+    // Local batch-queue state rollup (batch-submit/monitor poll+download and are NOT free)
+    'batch-status',
+]);
+/** Env var that unblocks the director storyboard-approval gate. The runner must
+ * never set it, so the gate keeps blocking inside any spawned execute. */
+export const APPROVAL_ENV_VAR = 'VIDEOCLAW_APPROVE_STORYBOARD';
+export class StudioExecuteError extends Error {
+    code;
+    constructor(code, message) {
+        super(message);
+        this.code = code;
+        this.name = 'StudioExecuteError';
+    }
+}
+/**
+ * Tokenizes a Studio command template into argv, honoring single/double quotes
+ * (recipe commands quote multi-word values, e.g. `--client "Acme Inc"`).
+ */
+export function parseStudioCommandArgv(command) {
+    const argv = [];
+    let current = '';
+    let quote = null;
+    let started = false;
+    for (const ch of command) {
+        if (quote) {
+            if (ch === quote)
+                quote = null;
+            else
+                current += ch;
+            started = true;
+        }
+        else if (ch === '"' || ch === "'") {
+            quote = ch;
+            started = true;
+        }
+        else if (ch === ' ' || ch === '\t' || ch === '\n') {
+            if (started) {
+                argv.push(current);
+                current = '';
+                started = false;
+            }
+        }
+        else {
+            current += ch;
+            started = true;
+        }
+    }
+    if (started)
+        argv.push(current);
+    return argv;
+}
+/**
+ * Returns the argv with a leading `vclaw` token removed (recipe commands are
+ * written `vclaw video ...`; the spawned child is the vclaw binary itself).
+ */
+export function studioStepArgv(step) {
+    const argv = parseStudioCommandArgv(step.command);
+    return argv[0] === 'vclaw' ? argv.slice(1) : argv;
+}
+/** The subcommand of a `vclaw video <sub> ...` (or `vclaw <sub> ...`) command. */
+function subcommandOf(argv) {
+    const rest = argv[0] === 'vclaw' ? argv.slice(1) : argv;
+    return rest[0] === 'video' ? rest[1] : rest[0];
+}
+/**
+ * Classifies a step by credit risk, FAIL-CLOSED. A step is only `free` when its
+ * subcommand is on the {@link FREE_SUBCOMMANDS} allow-list; everything else —
+ * including an unknown, typo'd, or missing subcommand — is a spend step:
+ * `spend-dry` when it carries `--dry-run`, else `spend-live` (refused by the
+ * runner on a default dry `--execute`). An empty/undefined subcommand is the
+ * safest classification, `spend-live`.
+ */
+export function classifyStep(step) {
+    const argv = parseStudioCommandArgv(step.command);
+    const sub = subcommandOf(argv);
+    if (sub && FREE_SUBCOMMANDS.has(sub)) {
+        return 'free';
+    }
+    return argv.includes('--dry-run') ? 'spend-dry' : 'spend-live';
+}
+/**
+ * Builds the child env. By default the storyboard-approval var is STRIPPED so the
+ * director gate keeps blocking. Only when `autoApprove` is set (auto-render mode)
+ * is it set to '1' so a real render proceeds unattended.
+ */
+export function studioChildEnv(base = {}, opts = {}) {
+    const env = { ...base };
+    if (opts.autoApprove) {
+        env[APPROVAL_ENV_VAR] = '1';
+    }
+    else {
+        delete env[APPROVAL_ENV_VAR];
+    }
+    return env;
+}
+function interpretChild(result) {
+    if (result.exitCode !== 0) {
+        return { stop: true, status: 'failed', reason: 'child-failed' };
+    }
+    const json = result.json && typeof result.json === 'object' && !Array.isArray(result.json)
+        ? result.json
+        : undefined;
+    const childStatus = json && typeof json.status === 'string' ? json.status : undefined;
+    const blocked = childStatus === 'blocked' ||
+        childStatus === 'awaiting-approval' ||
+        json?.awaitingApproval === true ||
+        json?.state === 'awaiting-approval';
+    if (blocked) {
+        const markdownPath = typeof json?.markdownPath === 'string'
+            ? json.markdownPath
+            : typeof json?.storyboardMarkdownPath === 'string'
+                ? json.storyboardMarkdownPath
+                : undefined;
+        return { stop: true, status: 'blocked', reason: 'child-blocked', childStatus, markdownPath };
+    }
+    return { stop: false, status: 'ran', childStatus };
+}
+/** Returns argv with any `--dry-run` flag removed — used to promote a spend-dry
+ * step to a real run under --confirm-spend.
+ *
+ * NOTE: the paid audio commands (`narrate`/`dialogue`/`sfx`/`soundtrack`) have
+ * their OWN fail-closed CLI gate (`requireSpendConfirmation` in vclaw.ts) that
+ * refuses a real run unless the argv carries `--dry-run` OR `--confirm-spend`.
+ * No STUDIO_RECIPE emits those subcommands today, so stripping `--dry-run` here
+ * is sufficient. If a recipe ever DOES emit one, this promotion must also append
+ * `--confirm-spend` (otherwise the promoted child hits the CLI gate and fails). */
+export function stripDryRunArgv(argv) {
+    return argv.filter((arg) => arg !== '--dry-run');
+}
+/**
+ * Runs a Studio plan's steps in order, stopping (fail-fast, no partial spend) at
+ * the first spend-guard refusal, child block, or child failure. Pure control flow
+ * — all I/O is delegated to `opts.runStep`. Never mutates the input plan.
+ *
+ * Modes (by flags): default = dry (free + spend-dry-as-dry; spend-live refused);
+ * confirmSpend = real spend (spend-dry promoted by stripping --dry-run), still
+ * human-gated; confirmSpend + autoApproveStoryboard = real spend with the director
+ * storyboard gate auto-approved (unattended).
+ */
+export function runStudioPlan(plan, opts) {
+    const confirmSpend = opts.confirmSpend === true;
+    const autoApprove = opts.autoApproveStoryboard === true;
+    if (autoApprove && !confirmSpend) {
+        throw new StudioExecuteError('studio_execute_auto_approve_requires_confirm_spend', '--auto-approve-storyboard only applies together with --confirm-spend.');
+    }
+    const mode = !confirmSpend ? 'dry' : autoApprove ? 'auto-render' : 'confirm-spend';
+    const childEnv = studioChildEnv(opts.baseEnv, { autoApprove: confirmSpend && autoApprove });
+    const results = [];
+    const report = {
+        schemaVersion: 1,
+        goal: plan.goal,
+        mode,
+        executed: false,
+        ranCount: 0,
+        results,
+        warnings: plan.warnings,
+    };
+    if (plan.missingInputs.length > 0) {
+        report.stopReason = 'missing-inputs';
+        return report;
+    }
+    if (mode === 'dry' && plan.steps.some((step) => classifyStep(step) !== 'free')) {
+        report.hint =
+            'Dry run: spend steps used --dry-run. To render for real add --confirm-spend (storyboard approval still required), or --confirm-spend --auto-approve-storyboard for an unattended render.';
+    }
+    let resuming = opts.fromStepId !== undefined;
+    for (const step of plan.steps) {
+        const classification = classifyStep(step);
+        if (resuming) {
+            if (step.id === opts.fromStepId) {
+                resuming = false;
+            }
+            else {
+                results.push({ id: step.id, command: step.command, classification, status: 'skipped-before-resume', exitCode: null });
+                continue;
+            }
+        }
+        // Spend guard: a spend-live step (spend subcommand without --dry-run) runs
+        // only under --confirm-spend; otherwise it is refused and the run stops.
+        if (classification === 'spend-live' && !confirmSpend) {
+            results.push({ id: step.id, command: step.command, classification, status: 'blocked-spend', exitCode: null });
+            report.stoppedAt = step.id;
+            report.stopReason = 'spend-guard';
+            return report;
+        }
+        // Free + spend-dry steps run (the real human checkpoint comes from the child's
+        // own director-approval gate, surfaced as a 'blocked' result — not a coarse
+        // pre-stop). Under --confirm-spend a spend-dry step is promoted to a real run
+        // by stripping its --dry-run.
+        const baseArgv = studioStepArgv(step);
+        const argv = confirmSpend && classification === 'spend-dry' ? stripDryRunArgv(baseArgv) : baseArgv;
+        const runResult = opts.runStep(argv, childEnv);
+        const verdict = interpretChild(runResult);
+        results.push({
+            id: step.id,
+            command: step.command,
+            classification,
+            status: verdict.status,
+            exitCode: runResult.exitCode,
+            ...(verdict.childStatus ? { childStatus: verdict.childStatus } : {}),
+            ...(verdict.markdownPath ? { markdownPath: verdict.markdownPath } : {}),
+        });
+        if (verdict.status === 'ran') {
+            report.ranCount += 1;
+            report.executed = true;
+        }
+        if (verdict.stop) {
+            report.stoppedAt = step.id;
+            report.stopReason = verdict.reason;
+            return report;
+        }
+    }
+    return report;
+}
+//# sourceMappingURL=execute.js.map

package/dist/video/studio/execute.js.map

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

package/dist/video/studio/planner.d.ts

@@ -0,0 +1,3 @@
+import type { StudioPlan, StudioPlanInput } from './types.js';
+export declare function buildStudioPlan(input: StudioPlanInput): StudioPlan;
+//# sourceMappingURL=planner.d.ts.map

package/dist/video/studio/planner.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"planner.d.ts","sourceRoot":"","sources":["../../../src/video/studio/planner.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAc,UAAU,EAAE,eAAe,EAAkB,MAAM,YAAY,CAAC;AA+D1F,wBAAgB,eAAe,CAAC,KAAK,EAAE,eAAe,GAAG,UAAU,CAiDlE"}

package/dist/video/studio/planner.js

@@ -0,0 +1,110 @@
+import { STUDIO_RECIPES } from './recipes.js';
+function shellQuote(value) {
+    if (/^[A-Za-z0-9._/:=-]+$/.test(value))
+        return value;
+    return JSON.stringify(value);
+}
+function resolveGoal(input) {
+    if (input.goal)
+        return input.goal;
+    if (input.project)
+        return 'existing-project';
+    return 'create-video';
+}
+function valueForPlaceholder(name, input) {
+    switch (name) {
+        case 'project':
+            return input.project;
+        case 'intent':
+            return input.intent;
+        case 'input':
+            return input.input;
+        case 'client':
+            return input.client ?? 'client';
+        case 'durationSeconds':
+            return String(input.durationSeconds ?? 60);
+        case 'template':
+            return 'template';
+        case 'bucket':
+            return 'bucket';
+        default:
+            return undefined;
+    }
+}
+function fillTemplate(template, input) {
+    return template.replaceAll(/<([A-Za-z0-9]+)>/g, (match, rawName) => {
+        const value = valueForPlaceholder(rawName, input);
+        return value ? shellQuote(value) : match;
+    });
+}
+function commandWithRoot(command, input) {
+    if (input.root === process.cwd())
+        return command;
+    if (!command.startsWith('vclaw video '))
+        return command;
+    if (command.includes(' --root '))
+        return command;
+    return `${command} --root ${shellQuote(input.root)}`;
+}
+function requiredInputMissing(name, input) {
+    switch (name) {
+        case 'project':
+            return !input.project;
+        case 'intent':
+            return !input.intent;
+        case 'input':
+            return !input.input;
+        case 'client':
+            return !input.client;
+        default:
+            return false;
+    }
+}
+export function buildStudioPlan(input) {
+    const goal = resolveGoal(input);
+    const recipe = STUDIO_RECIPES.find((item) => item.id === goal);
+    if (!recipe) {
+        throw new Error(`Unknown studio goal: ${goal}`);
+    }
+    const missingInputs = recipe.requiredInputs.filter((name) => requiredInputMissing(name, input));
+    const warnings = [];
+    if (recipe.riskLevel === 'high') {
+        warnings.push('This recipe can lead to provider credits being spent after approval; keep dry-run until assets and prompts are reviewed.');
+    }
+    if (!input.dryRun) {
+        warnings.push('Phase 1 studio planner is plan-only; execution is intentionally not enabled yet.');
+    }
+    if (input.project && input.projectContext?.projectExists === false) {
+        warnings.push(`Project ${input.project} does not exist yet; start with vclaw video init ${input.project}.`);
+    }
+    if (input.projectContext?.readinessNextAction) {
+        warnings.push(`Project next action: ${input.projectContext.readinessNextAction}`);
+    }
+    if (input.projectContext?.nextActionCount !== undefined) {
+        warnings.push(`Portfolio next-action count: ${input.projectContext.nextActionCount}.`);
+    }
+    const steps = missingInputs.length > 0
+        ? []
+        : recipe.commands.map((command) => ({
+            id: command.id,
+            title: command.title,
+            command: commandWithRoot(fillTemplate(command.primary, input), input),
+            reason: command.when,
+            produces: command.produces,
+            requiresApproval: recipe.executionPolicy === 'approval-gated',
+        }));
+    return {
+        schemaVersion: 1,
+        dryRun: true,
+        goal,
+        title: recipe.title,
+        summary: recipe.goal,
+        missingInputs,
+        warnings,
+        steps,
+        nextAction: missingInputs.length > 0
+            ? `Provide ${missingInputs.join(' and ')} to build this studio plan.`
+            : 'Review the plan. Run the listed commands manually or continue to an approved execution slice.',
+    };
+}
+//# sourceMappingURL=planner.js.map

package/dist/video/studio/planner.js.map

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

package/dist/video/studio/project-context.d.ts

@@ -0,0 +1,4 @@
+import type { VideoProductionMode } from '../types.js';
+import type { StudioProjectContext } from './types.js';
+export declare function loadStudioProjectContext(root: string, project: string | undefined, mode?: VideoProductionMode): Promise<StudioProjectContext>;
+//# sourceMappingURL=project-context.d.ts.map

package/dist/video/studio/project-context.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"project-context.d.ts","sourceRoot":"","sources":["../../../src/video/studio/project-context.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,aAAa,CAAC;AAEvD,OAAO,KAAK,EAAE,oBAAoB,EAAE,MAAM,YAAY,CAAC;AAEvD,wBAAsB,wBAAwB,CAC5C,IAAI,EAAE,MAAM,EACZ,OAAO,EAAE,MAAM,GAAG,SAAS,EAC3B,IAAI,GAAE,mBAAkC,GACvC,OAAO,CAAC,oBAAoB,CAAC,CAa/B"}

package/dist/video/studio/project-context.js

@@ -0,0 +1,20 @@
+import { existsSync } from 'node:fs';
+import { buildNextActions } from '../next-actions.js';
+import { buildProjectReadiness } from '../readiness.js';
+import { resolveProjectWorkspace } from '../workspace.js';
+export async function loadStudioProjectContext(root, project, mode = 'storyboard') {
+    if (!project)
+        return { projectExists: false };
+    const workspace = resolveProjectWorkspace(project, root);
+    if (!existsSync(workspace.projectDir))
+        return { projectExists: false };
+    const readiness = await buildProjectReadiness(project, root, mode);
+    const nextActions = await buildNextActions(root, mode);
+    return {
+        projectExists: true,
+        readinessReady: readiness.ready,
+        readinessNextAction: readiness.nextAction,
+        nextActionCount: nextActions.actions.length,
+    };
+}
+//# sourceMappingURL=project-context.js.map

package/dist/video/studio/project-context.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"project-context.js","sourceRoot":"","sources":["../../../src/video/studio/project-context.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAE,MAAM,SAAS,CAAC;AACrC,OAAO,EAAE,gBAAgB,EAAE,MAAM,oBAAoB,CAAC;AACtD,OAAO,EAAE,qBAAqB,EAAE,MAAM,iBAAiB,CAAC;AAExD,OAAO,EAAE,uBAAuB,EAAE,MAAM,iBAAiB,CAAC;AAG1D,MAAM,CAAC,KAAK,UAAU,wBAAwB,CAC5C,IAAY,EACZ,OAA2B,EAC3B,OAA4B,YAAY;IAExC,IAAI,CAAC,OAAO;QAAE,OAAO,EAAE,aAAa,EAAE,KAAK,EAAE,CAAC;IAC9C,MAAM,SAAS,GAAG,uBAAuB,CAAC,OAAO,EAAE,IAAI,CAAC,CAAC;IACzD,IAAI,CAAC,UAAU,CAAC,SAAS,CAAC,UAAU,CAAC;QAAE,OAAO,EAAE,aAAa,EAAE,KAAK,EAAE,CAAC;IAEvE,MAAM,SAAS,GAAG,MAAM,qBAAqB,CAAC,OAAO,EAAE,IAAI,EAAE,IAAI,CAAC,CAAC;IACnE,MAAM,WAAW,GAAG,MAAM,gBAAgB,CAAC,IAAI,EAAE,IAAI,CAAC,CAAC;IACvD,OAAO;QACL,aAAa,EAAE,IAAI;QACnB,cAAc,EAAE,SAAS,CAAC,KAAK;QAC/B,mBAAmB,EAAE,SAAS,CAAC,UAAU;QACzC,eAAe,EAAE,WAAW,CAAC,OAAO,CAAC,MAAM;KAC5C,CAAC;AACJ,CAAC"}

package/dist/video/studio/recipes.d.ts

@@ -0,0 +1,4 @@
+import type { StudioRecipe } from './types.js';
+export declare const STUDIO_RECIPES: StudioRecipe[];
+export declare function findStudioRecipe(id: string): StudioRecipe | undefined;
+//# sourceMappingURL=recipes.d.ts.map

package/dist/video/studio/recipes.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"recipes.d.ts","sourceRoot":"","sources":["../../../src/video/studio/recipes.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,YAAY,CAAC;AAE/C,eAAO,MAAM,cAAc,EAAE,YAAY,EAmVxC,CAAC;AAEF,wBAAgB,gBAAgB,CAAC,EAAE,EAAE,MAAM,GAAG,YAAY,GAAG,SAAS,CAErE"}