@vibeframe/cli 0.107.1 → 0.108.1

package/dist/commands/_shared/scene-lint.d.ts

@@ -85,6 +85,25 @@ export declare function isEpsilonOverlapFinding(finding: LintFinding): boolean;
  * findings pass through unchanged.
  */
 export declare function filterSubCompFalsePositives(findings: LintFinding[], isSubComposition: boolean): LintFinding[];
+/**
+ * VibeFrame-side finding: inner phase clips inside a sub-composition.
+ *
+ * The producer's screenshot render mode does NOT toggle the visibility of
+ * `.clip` elements INSIDE a sub-composition by their `data-start` window —
+ * a scene split into clip phases (0-10s, 10-26s) renders BOTH phases
+ * simultaneously and text stacks on top of itself. Root index.html clips
+ * are unaffected (their windows work); this rule only applies to
+ * sub-composition internals. Phase changes must instead be driven by GSAP
+ * (animate the old phase out with autoAlpha, the new one in) inside
+ * full-window clips.
+ */
+export declare function findInternalPhaseClipFindings(html: string): LintFinding[];
+/**
+ * Append VibeFrame-side findings for sub-composition HTML. Call at every
+ * lint site (batch composer, scene_submit, scene repair, project lint) so
+ * all authoring paths share the exact same contract.
+ */
+export declare function withVibeframeSubCompFindings(findings: LintFinding[], html: string, isSubComposition: boolean): LintFinding[];
 /**
  * Apply mechanical `--fix` rewrites for known-safe finding codes. Returns the
  * (possibly unchanged) HTML and the list of codes that were fixed at least

package/dist/commands/_shared/scene-submit.d.ts

@@ -0,0 +1,41 @@
+/**
+ * @module _shared/scene-submit
+ *
+ * Host-authored scene submission — the missing half of agent-mode compose
+ * for hosts that cannot write files (Claude Desktop and other MCP-only
+ * surfaces). `build --mode agent` already returns a `needs-author` plan with
+ * per-beat compose prompts; this executor accepts the HTML the host agent
+ * authored, validates it with the SAME lint the batch composer uses, and
+ * writes `compositions/scene-<id>.html` on pass. On lint errors nothing is
+ * written and the findings are returned so the agent can fix and resubmit.
+ *
+ * Shared by the `vibe scene submit` CLI command and the `scene_submit`
+ * MCP/agent tool.
+ */
+import { type LintFinding } from "./scene-lint.js";
+export interface SceneSubmitOptions {
+    projectDir: string;
+    beatId: string;
+    /** Scene HTML — a bare `<template>` fragment, optionally ```html-fenced. */
+    html: string;
+    /** Lint only; never write. */
+    validateOnly?: boolean;
+}
+export interface SceneSubmitResult {
+    success: boolean;
+    beatId: string;
+    /** Project-relative path of the scene file. */
+    scenePath: string;
+    written: boolean;
+    /** Lint codes auto-repaired before validation. */
+    mechanicalFixes: string[];
+    lint: {
+        errorCount: number;
+        warningCount: number;
+        findings: LintFinding[];
+    };
+    warnings: string[];
+    retryWith: string[];
+    error?: string;
+}
+export declare function executeSceneSubmit(opts: SceneSubmitOptions): Promise<SceneSubmitResult>;

package/dist/commands/_shared/scene-submit.test.d.ts

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

package/dist/commands/_shared/storyboard-edit.d.ts

@@ -12,6 +12,8 @@ export interface StoryboardValidationResult {
     beats: Beat[];
     issues: StoryboardValidationIssue[];
 }
+/** Beats beyond this render as static, overstuffed scenes. */
+export declare const MAX_RECOMMENDED_BEAT_SEC = 15;
 export declare function validateStoryboardMarkdown(markdown: string): StoryboardValidationResult;
 export declare function getStoryboardBeat(markdown: string, beatId: string): Beat | null;
 export declare function setStoryboardCue(markdown: string, opts: {