@skyphusion-labs/vivijure-core 0.9.0

package/dist/scatter.d.ts

@@ -0,0 +1,35 @@
+import type { RenderSubmitArgs } from "./runpod-submit.js";
+export declare function splitShots(shotIds: string[], shardCount: number): string[][];
+export interface ScatterArgs {
+    project: string;
+    bundleKey: string;
+    qualityTier?: "draft" | "standard" | "final";
+    pretrainedLoras: Record<string, string>;
+    shotIds: string[];
+    shardCount: number;
+    renderOverrides?: Record<string, unknown>;
+    shotSlots?: Record<string, string[]>;
+}
+export declare function buildShardJobs(args: ScatterArgs): RenderSubmitArgs[];
+export declare function scopePretrainedToShard(pretrainedLoras: Record<string, string>, shard: string[], shotSlots?: Record<string, string[]>): Record<string, string>;
+export declare function scatterShards(args: Pick<ScatterArgs, "shotIds" | "shardCount" | "pretrainedLoras" | "shotSlots">): Array<{
+    shots: string[];
+    pretrainedLoras: Record<string, string>;
+}>;
+export type GatherDecision = {
+    kind: "finish";
+} | {
+    kind: "waiting";
+    remaining: number;
+} | {
+    kind: "failed";
+    reason: string;
+};
+export interface ShardStatus {
+    status: string;
+    shots: string[];
+}
+export declare function gatherDecision(present: string[], expected: string[], shards: ShardStatus[]): GatherDecision;
+export declare function scatterParentJobId(token: string): string;
+export declare function isScatterParentJobId(jobId: string | null | undefined): boolean;
+//# sourceMappingURL=scatter.d.ts.map

package/dist/scatter.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"scatter.d.ts","sourceRoot":"","sources":["../src/scatter.ts"],"names":[],"mappings":"AAuBA,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,oBAAoB,CAAC;AAa3D,wBAAgB,UAAU,CAAC,OAAO,EAAE,MAAM,EAAE,EAAE,UAAU,EAAE,MAAM,GAAG,MAAM,EAAE,EAAE,CAc5E;AAED,MAAM,WAAW,WAAW;IAC1B,OAAO,EAAE,MAAM,CAAC;IAChB,SAAS,EAAE,MAAM,CAAC;IAClB,WAAW,CAAC,EAAE,OAAO,GAAG,UAAU,GAAG,OAAO,CAAC;IAI7C,eAAe,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IAExC,OAAO,EAAE,MAAM,EAAE,CAAC;IAClB,UAAU,EAAE,MAAM,CAAC;IACnB,eAAe,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IAK1C,SAAS,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,EAAE,CAAC,CAAC;CACtC;AAKD,wBAAgB,cAAc,CAAC,IAAI,EAAE,WAAW,GAAG,gBAAgB,EAAE,CAyBpE;AAMD,wBAAgB,sBAAsB,CACpC,eAAe,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,EACvC,KAAK,EAAE,MAAM,EAAE,EACf,SAAS,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,EAAE,CAAC,GACnC,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAWxB;AAED,wBAAgB,aAAa,CAC3B,IAAI,EAAE,IAAI,CAAC,WAAW,EAAE,SAAS,GAAG,YAAY,GAAG,iBAAiB,GAAG,WAAW,CAAC,GAClF,KAAK,CAAC;IAAE,KAAK,EAAE,MAAM,EAAE,CAAC;IAAC,eAAe,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAA;CAAE,CAAC,CAOrE;AAOD,MAAM,MAAM,cAAc,GACtB;IAAE,IAAI,EAAE,QAAQ,CAAA;CAAE,GAClB;IAAE,IAAI,EAAE,SAAS,CAAC;IAAC,SAAS,EAAE,MAAM,CAAA;CAAE,GACtC;IAAE,IAAI,EAAE,QAAQ,CAAC;IAAC,MAAM,EAAE,MAAM,CAAA;CAAE,CAAC;AAMvC,MAAM,WAAW,WAAW;IAC1B,MAAM,EAAE,MAAM,CAAC;IACf,KAAK,EAAE,MAAM,EAAE,CAAC;CACjB;AAqBD,wBAAgB,cAAc,CAC5B,OAAO,EAAE,MAAM,EAAE,EACjB,QAAQ,EAAE,MAAM,EAAE,EAClB,MAAM,EAAE,WAAW,EAAE,GACpB,cAAc,CA6BhB;AAOD,wBAAgB,kBAAkB,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,CAExD;AAED,wBAAgB,oBAAoB,CAAC,KAAK,EAAE,MAAM,GAAG,IAAI,GAAG,SAAS,GAAG,OAAO,CAE9E"}

package/dist/scatter.js

@@ -0,0 +1,171 @@
+// Distributed scatter/gather render conductor (pure core).
+//
+// A normal render runs every shot in one RunPod job. A *scatter* render splits
+// the storyboard across N jobs that run in parallel, then *gathers* their
+// per-shot clips into one MP4. The win is wall-clock: a 10-shot film that takes
+// ~T on one worker takes ~T/N across N, at the same GPU-second cost.
+//
+// Three things make this safe and cheap, and they already exist on the backend:
+//   1. `process_shot_ids` lets a job render only its slice (orchestrator.plan
+//      scopes scenes to it).
+//   2. `pretrained_loras` lets every shard REUSE the character adapters trained
+//      ONCE up front (handler._stage_pretrained_loras pulls them from R2), so a
+//      shard never retrains, and every shot shares byte-identical identity.
+//   3. `finish_offloaded` makes a shard emit per-shot clips + a manifest and
+//      skip the merge, so the control plane owns the single final assembly.
+//
+// This module is the CONDUCTOR's pure logic: how to split the shots, how to
+// shape each shard's submit args, and how to decide when the gather can finish.
+// No I/O, no Worker runtime: trivially unit-testable. The orchestration that
+// submits jobs, writes the parent/child `renders` rows, and drives the merge
+// lives in index.ts and reuses these helpers plus the gather core already in
+// video-finish.ts (gatherClipPresence / finishInputFromClipKeys / runVideoFinish).
+// Split an ordered shot list into `shardCount` CONTIGUOUS, balanced slices.
+//
+// Contiguous (not round-robin) so each shard is a coherent run of the
+// storyboard: shots that chain from their predecessor (chain_from_previous)
+// stay together in one job, and the gather just concatenates shards in
+// storyboard order. Balanced with a front-loaded remainder, so 10 shots over 3
+// shards => [4, 3, 3], never an empty trailing shard.
+//
+// `shardCount` is clamped to [1, shots.length]: asking for more shards than
+// shots would mint empty jobs (GPU-seconds for nothing), and asking for <1 is
+// just a normal single render. An empty shot list returns [].
+export function splitShots(shotIds, shardCount) {
+    const shots = shotIds.filter((s) => typeof s === "string" && s.length > 0);
+    if (shots.length === 0)
+        return [];
+    const n = Math.max(1, Math.min(Math.floor(shardCount) || 1, shots.length));
+    const base = Math.floor(shots.length / n);
+    const extra = shots.length % n; // the first `extra` shards carry one more
+    const shards = [];
+    let i = 0;
+    for (let s = 0; s < n; s++) {
+        const size = base + (s < extra ? 1 : 0);
+        shards.push(shots.slice(i, i + size));
+        i += size;
+    }
+    return shards;
+}
+// Build one RenderSubmitArgs per shard. Each is a finish-offloaded subset render
+// that reuses the pre-trained LoRAs, so it draws keyframes + i2v for ITS shots
+// and writes per-shot clips to R2 without assembling anything.
+export function buildShardJobs(args) {
+    const shards = splitShots(args.shotIds, args.shardCount);
+    // Explicit empty-shard guard: a shard with no shots would submit
+    // processShotIds: [], and the backend reads an empty process_shot_ids as
+    // "render the WHOLE storyboard". One stray empty shard would therefore render
+    // the entire film (N times over the scatter), so never emit a job for one.
+    // splitShots already avoids empty slices for a non-empty input; this is the
+    // load-bearing safety net, not a redundant check.
+    return shards
+        .filter((shard) => shard.length > 0)
+        .map((shard) => {
+        const pretrained = scopePretrainedToShard(args.pretrainedLoras, shard, args.shotSlots);
+        const job = {
+            project: args.project,
+            bundleKey: args.bundleKey,
+            qualityTier: args.qualityTier,
+            processShotIds: shard,
+            // finish_offloaded is the one raw routing flag the backend reads off the
+            // overrides dict (buildSubmitPayload._OVERRIDE_FLAGS). It makes the shard
+            // emit clips + manifest and skip the merge.
+            renderOverrides: { ...(args.renderOverrides ?? {}), finish_offloaded: true },
+        };
+        if (Object.keys(pretrained).length > 0)
+            job.pretrainedLoras = pretrained;
+        return job;
+    });
+}
+// Restrict the pretrained-LoRA map to the slots a shard's shots actually use.
+// Falls back to the full map when we have no per-shot slot information (the safe
+// default: staging a spare adapter is wasteful, dropping a needed one renders
+// the wrong identity).
+export function scopePretrainedToShard(pretrainedLoras, shard, shotSlots) {
+    if (!shotSlots)
+        return { ...pretrainedLoras };
+    const used = new Set();
+    for (const shotId of shard) {
+        for (const slot of shotSlots[shotId] ?? [])
+            used.add(slot);
+    }
+    const scoped = {};
+    for (const [slot, key] of Object.entries(pretrainedLoras)) {
+        if (used.has(slot))
+            scoped[slot] = key;
+    }
+    return scoped;
+}
+export function scatterShards(args) {
+    return splitShots(args.shotIds, args.shardCount)
+        .filter((shard) => shard.length > 0)
+        .map((shots) => ({
+        shots,
+        pretrainedLoras: scopePretrainedToShard(args.pretrainedLoras, shots, args.shotSlots),
+    }));
+}
+// A shard's terminal RunPod statuses that mean "this slice will never produce
+// its clips" (so if its shots are still missing, the gather is doomed, not just
+// slow). Mirrors RunpodStatus.
+const SHARD_DEAD_STATUSES = new Set(["FAILED", "CANCELLED", "TIMED_OUT"]);
+// Decide what the gather watcher should do, from the clip-presence signal
+// (video-finish.gatherClipPresence) and the shards' last RunPod statuses.
+//
+//   finish  -> every EXPECTED shot has a clip in R2: assemble the MP4.
+//   failed  -> a missing shot can never arrive (its owning shard is dead, or no
+//              shard owns it): stop waiting.
+//   waiting -> shots still missing but a live shard could still produce them.
+//
+// `expected` is the AUTHORITATIVE full storyboard shot-id set; we compute the
+// missing set here from it rather than trusting a caller-supplied count, so a
+// truncated expected-set can never let the gather "finish" a partial film. Finish
+// requires present to cover expected in full (present superset-of expected).
+//
+// Dead-ness is correlated to the specific missing shots' owning shard, not the
+// whole gather: a single dead shard does NOT fail shots that live shards still
+// own (or that the dead shard already re-emitted into `present`). The presence
+// signal leads -- a shard can be COMPLETED yet have re-emitted clips, or a
+// retried shard can fill holes -- so we only call "failed" for shots that are
+// missing AND unrecoverable.
+export function gatherDecision(present, expected, shards) {
+    const expectedShots = expected.filter((s) => typeof s === "string" && s.length > 0);
+    // No authoritative shots means there is nothing to assemble; never silently
+    // "finish" an empty film.
+    if (expectedShots.length === 0) {
+        return { kind: "failed", reason: "no expected shots: nothing to gather" };
+    }
+    const presentSet = new Set(present);
+    const missing = expectedShots.filter((id) => !presentSet.has(id));
+    if (missing.length === 0)
+        return { kind: "finish" };
+    // A missing shot can still arrive only if a NON-dead shard owns it. Missing
+    // shots whose owning shard is dead -- or that no shard owns at all -- can never
+    // land, so the gather is doomed for exactly those shots.
+    const recoverable = new Set();
+    for (const shard of shards) {
+        if (!SHARD_DEAD_STATUSES.has(shard.status)) {
+            for (const shot of shard.shots)
+                recoverable.add(shot);
+        }
+    }
+    const doomed = missing.filter((id) => !recoverable.has(id));
+    if (doomed.length > 0) {
+        return {
+            kind: "failed",
+            reason: `${doomed.length} shot(s) can never arrive (owning shard dead or unassigned): ${doomed.join(", ")}`,
+        };
+    }
+    return { kind: "waiting", remaining: missing.length };
+}
+// Synthetic job_id for the scatter PARENT renders row. The parent is not a
+// RunPod job (it owns N child jobs), but renders.job_id is NOT NULL UNIQUE, so
+// it needs a stable, collision-free id. The caller passes a unique token (e.g.
+// the first child job id, or a timestamp+slug); kept pure so tests are
+// deterministic and the Worker chooses the entropy.
+export function scatterParentJobId(token) {
+    return `scatter-${token}`;
+}
+export function isScatterParentJobId(jobId) {
+    return typeof jobId === "string" && jobId.startsWith("scatter-");
+}
+//# sourceMappingURL=scatter.js.map

package/dist/scatter.js.map

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

package/dist/secret-store.d.ts

@@ -0,0 +1,5 @@
+export interface SecretsStoreSecret {
+    get(): Promise<string>;
+}
+export declare function secretValue(s: SecretsStoreSecret | string | undefined): Promise<string>;
+//# sourceMappingURL=secret-store.d.ts.map

package/dist/secret-store.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"secret-store.d.ts","sourceRoot":"","sources":["../src/secret-store.ts"],"names":[],"mappings":"AAAA,MAAM,WAAW,kBAAkB;IACjC,GAAG,IAAI,OAAO,CAAC,MAAM,CAAC,CAAC;CACxB;AAOD,wBAAsB,WAAW,CAAC,CAAC,EAAE,kBAAkB,GAAG,MAAM,GAAG,SAAS,GAAG,OAAO,CAAC,MAAM,CAAC,CAS7F"}

package/dist/secret-store.js

@@ -0,0 +1,19 @@
+// Resolve a Secrets Store binding (production) or a plain string (tests / local dev) to its
+// value. Returns "" if unset/unreadable so the existing "not configured" guards still fire
+// FAIL CLOSED. Mirrors the per-module helper (modules/*/src/index.ts). Part of #238 (core half):
+// the credential secrets move from `wrangler secret put` to declarative [[secrets_store_secrets]]
+// bindings, and every read goes through here.
+export async function secretValue(s) {
+    if (typeof s === "string")
+        return s;
+    if (!s)
+        return "";
+    try {
+        return await s.get();
+    }
+    catch (e) {
+        console.warn("secrets-store get failed: " + e.message);
+        return "";
+    }
+}
+//# sourceMappingURL=secret-store.js.map

package/dist/secret-store.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"secret-store.js","sourceRoot":"","sources":["../src/secret-store.ts"],"names":[],"mappings":"AAIA,4FAA4F;AAC5F,2FAA2F;AAC3F,iGAAiG;AACjG,kGAAkG;AAClG,8CAA8C;AAC9C,MAAM,CAAC,KAAK,UAAU,WAAW,CAAC,CAA0C;IAC1E,IAAI,OAAO,CAAC,KAAK,QAAQ;QAAE,OAAO,CAAC,CAAC;IACpC,IAAI,CAAC,CAAC;QAAE,OAAO,EAAE,CAAC;IAClB,IAAI,CAAC;QACH,OAAO,MAAM,CAAC,CAAC,GAAG,EAAE,CAAC;IACvB,CAAC;IAAC,OAAO,CAAC,EAAE,CAAC;QACX,OAAO,CAAC,IAAI,CAAC,4BAA4B,GAAI,CAAW,CAAC,OAAO,CAAC,CAAC;QAClE,OAAO,EAAE,CAAC;IACZ,CAAC;AACH,CAAC"}

package/dist/shot-durations-parse.d.ts

@@ -0,0 +1,3 @@
+/** Parse beat-trimmed per-shot target_seconds from a storyboard.yaml string. */
+export declare function parseShotDurations(yaml: string): Record<string, number>;
+//# sourceMappingURL=shot-durations-parse.d.ts.map

package/dist/shot-durations-parse.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"shot-durations-parse.d.ts","sourceRoot":"","sources":["../src/shot-durations-parse.ts"],"names":[],"mappings":"AAAA,gFAAgF;AAChF,wBAAgB,kBAAkB,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAsCvE"}

package/dist/shot-durations-parse.js

@@ -0,0 +1,43 @@
+/** Parse beat-trimmed per-shot target_seconds from a storyboard.yaml string. */
+export function parseShotDurations(yaml) {
+    const out = {};
+    let inScenes = false;
+    let idx = 0;
+    let curId = null;
+    let curTarget = null;
+    const flush = () => {
+        if (idx === 0)
+            return;
+        const shot = curId || `shot_${String(idx).padStart(2, "0")}`;
+        if (curTarget !== null && Number.isFinite(curTarget) && curTarget > 0) {
+            out[shot] = curTarget;
+        }
+    };
+    for (const line of yaml.split(/\r?\n/)) {
+        if (!inScenes) {
+            if (/^scenes:\s*$/.test(line))
+                inScenes = true;
+            continue;
+        }
+        if (/^ {2}-\s/.test(line)) {
+            flush();
+            idx++;
+            curId = null;
+            curTarget = null;
+            continue;
+        }
+        const idM = line.match(/^ {4}id:\s*"((?:[^"\\]|\\.)*)"\s*$/);
+        if (idM) {
+            curId = idM[1].replace(/\\(.)/g, "$1");
+            continue;
+        }
+        const tsM = line.match(/^ {4}target_seconds:\s*([0-9]+(?:\.[0-9]+)?)\s*$/);
+        if (tsM) {
+            curTarget = parseFloat(tsM[1]);
+            continue;
+        }
+    }
+    flush();
+    return out;
+}
+//# sourceMappingURL=shot-durations-parse.js.map

package/dist/shot-durations-parse.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"shot-durations-parse.js","sourceRoot":"","sources":["../src/shot-durations-parse.ts"],"names":[],"mappings":"AAAA,gFAAgF;AAChF,MAAM,UAAU,kBAAkB,CAAC,IAAY;IAC7C,MAAM,GAAG,GAA2B,EAAE,CAAC;IACvC,IAAI,QAAQ,GAAG,KAAK,CAAC;IACrB,IAAI,GAAG,GAAG,CAAC,CAAC;IACZ,IAAI,KAAK,GAAkB,IAAI,CAAC;IAChC,IAAI,SAAS,GAAkB,IAAI,CAAC;IACpC,MAAM,KAAK,GAAG,GAAS,EAAE;QACvB,IAAI,GAAG,KAAK,CAAC;YAAE,OAAO;QACtB,MAAM,IAAI,GAAG,KAAK,IAAI,QAAQ,MAAM,CAAC,GAAG,CAAC,CAAC,QAAQ,CAAC,CAAC,EAAE,GAAG,CAAC,EAAE,CAAC;QAC7D,IAAI,SAAS,KAAK,IAAI,IAAI,MAAM,CAAC,QAAQ,CAAC,SAAS,CAAC,IAAI,SAAS,GAAG,CAAC,EAAE,CAAC;YACtE,GAAG,CAAC,IAAI,CAAC,GAAG,SAAS,CAAC;QACxB,CAAC;IACH,CAAC,CAAC;IACF,KAAK,MAAM,IAAI,IAAI,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,EAAE,CAAC;QACvC,IAAI,CAAC,QAAQ,EAAE,CAAC;YACd,IAAI,cAAc,CAAC,IAAI,CAAC,IAAI,CAAC;gBAAE,QAAQ,GAAG,IAAI,CAAC;YAC/C,SAAS;QACX,CAAC;QACD,IAAI,UAAU,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,CAAC;YAC1B,KAAK,EAAE,CAAC;YACR,GAAG,EAAE,CAAC;YACN,KAAK,GAAG,IAAI,CAAC;YACb,SAAS,GAAG,IAAI,CAAC;YACjB,SAAS;QACX,CAAC;QACD,MAAM,GAAG,GAAG,IAAI,CAAC,KAAK,CAAC,oCAAoC,CAAC,CAAC;QAC7D,IAAI,GAAG,EAAE,CAAC;YACR,KAAK,GAAG,GAAG,CAAC,CAAC,CAAC,CAAC,OAAO,CAAC,QAAQ,EAAE,IAAI,CAAC,CAAC;YACvC,SAAS;QACX,CAAC;QACD,MAAM,GAAG,GAAG,IAAI,CAAC,KAAK,CAAC,kDAAkD,CAAC,CAAC;QAC3E,IAAI,GAAG,EAAE,CAAC;YACR,SAAS,GAAG,UAAU,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC;YAC/B,SAAS;QACX,CAAC;IACH,CAAC;IACD,KAAK,EAAE,CAAC;IACR,OAAO,GAAG,CAAC;AACb,CAAC"}

package/dist/srt.d.ts

@@ -0,0 +1,11 @@
+/** Parse an SRT `HH:MM:SS,mmm` timestamp to whole milliseconds (0 on a non-match, defensively). */
+export declare function parseTimestamp(ts: string): number;
+/** Format whole milliseconds as an SRT `HH:MM:SS,mmm` timestamp, rolling seconds into minutes and
+ *  minutes into hours. A negative input clamps to zero; hours are not capped (SubRip zero-pads to 2 but
+ *  tolerates more, and a very long film can in theory exceed 99h). */
+export declare function formatTimestamp(ms: number): string;
+/** Shift every cue timestamp in an SRT document by `offsetSeconds`. A zero (or non-finite) offset returns
+ *  the input UNCHANGED (the no-op the core relies on when there is no title card / credits-only). Only
+ *  lines carrying the `-->` cue arrow are rewritten, so indices and caption text are preserved exactly. */
+export declare function retimeSrt(srt: string, offsetSeconds: number): string;
+//# sourceMappingURL=srt.d.ts.map

package/dist/srt.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"srt.d.ts","sourceRoot":"","sources":["../src/srt.ts"],"names":[],"mappings":"AAeA,mGAAmG;AACnG,wBAAgB,cAAc,CAAC,EAAE,EAAE,MAAM,GAAG,MAAM,CAIjD;AAED;;sEAEsE;AACtE,wBAAgB,eAAe,CAAC,EAAE,EAAE,MAAM,GAAG,MAAM,CASlD;AAED;;2GAE2G;AAC3G,wBAAgB,SAAS,CAAC,GAAG,EAAE,MAAM,EAAE,aAAa,EAAE,MAAM,GAAG,MAAM,CAapE"}

package/dist/srt.js

@@ -0,0 +1,54 @@
+// SRT (SubRip) sidecar re-timer for the film.finish chain (#663).
+//
+// The subtitle film.finish module (ui.order 5) writes its soft .srt sidecar against the assembled
+// 0-based timeline: each cue starts at the film`s real start, because the timed cues the core hands it
+// are measured from the assembled film`s 0 (see src/captions.ts). A LATER film.finish step -- film-titles
+// (ui.order 10) -- then PREPENDS an opening title card, shifting the FINAL film forward by title_seconds.
+// The BURNED captions ride the video through that prepend (they are part of the frames), but the soft
+// .srt sidecar is a SEPARATE artifact and does NOT, so against the final film every cue runs early by the
+// prepend duration. The core re-times the sidecar AFTER the chain by that known offset (module-reported
+// prepend_seconds), so the soft subtitles line up with the delivered film.
+//
+// Pure string transform, no I/O: parse each `HH:MM:SS,mmm --> HH:MM:SS,mmm` cue line, add the offset
+// (a negative result clamps to 0), reformat with minute/hour rollover. Everything else (cue indices,
+// caption text, blank lines, any trailing position extension on the cue line) passes through verbatim.
+/** Parse an SRT `HH:MM:SS,mmm` timestamp to whole milliseconds (0 on a non-match, defensively). */
+export function parseTimestamp(ts) {
+    const m = /(\d{1,2}):(\d{2}):(\d{2}),(\d{3})/.exec(ts);
+    if (!m)
+        return 0;
+    return Number(m[1]) * 3600000 + Number(m[2]) * 60000 + Number(m[3]) * 1000 + Number(m[4]);
+}
+/** Format whole milliseconds as an SRT `HH:MM:SS,mmm` timestamp, rolling seconds into minutes and
+ *  minutes into hours. A negative input clamps to zero; hours are not capped (SubRip zero-pads to 2 but
+ *  tolerates more, and a very long film can in theory exceed 99h). */
+export function formatTimestamp(ms) {
+    const totalMs = Math.max(0, Math.round(ms));
+    const msPart = totalMs % 1000;
+    const totalSec = Math.floor(totalMs / 1000);
+    const s = totalSec % 60;
+    const m = Math.floor(totalSec / 60) % 60;
+    const h = Math.floor(totalSec / 3600);
+    const pad = (n, w = 2) => String(n).padStart(w, "0");
+    return `${pad(h)}:${pad(m)}:${pad(s)},${pad(msPart, 3)}`;
+}
+/** Shift every cue timestamp in an SRT document by `offsetSeconds`. A zero (or non-finite) offset returns
+ *  the input UNCHANGED (the no-op the core relies on when there is no title card / credits-only). Only
+ *  lines carrying the `-->` cue arrow are rewritten, so indices and caption text are preserved exactly. */
+export function retimeSrt(srt, offsetSeconds) {
+    if (!Number.isFinite(offsetSeconds) || offsetSeconds === 0)
+        return srt;
+    const offsetMs = Math.round(offsetSeconds * 1000);
+    return srt
+        .split("\n")
+        .map((line) => {
+        if (!line.includes("-->"))
+            return line;
+        return line.replace(/(\d{1,2}):(\d{2}):(\d{2}),(\d{3})/g, (_m, h, mm, ss, mmm) => {
+            const base = Number(h) * 3600000 + Number(mm) * 60000 + Number(ss) * 1000 + Number(mmm);
+            return formatTimestamp(base + offsetMs);
+        });
+    })
+        .join("\n");
+}
+//# sourceMappingURL=srt.js.map

package/dist/srt.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"srt.js","sourceRoot":"","sources":["../src/srt.ts"],"names":[],"mappings":"AAAA,kEAAkE;AAClE,EAAE;AACF,kGAAkG;AAClG,uGAAuG;AACvG,0GAA0G;AAC1G,0GAA0G;AAC1G,sGAAsG;AACtG,0GAA0G;AAC1G,wGAAwG;AACxG,2EAA2E;AAC3E,EAAE;AACF,qGAAqG;AACrG,qGAAqG;AACrG,uGAAuG;AAEvG,mGAAmG;AACnG,MAAM,UAAU,cAAc,CAAC,EAAU;IACvC,MAAM,CAAC,GAAG,mCAAmC,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;IACvD,IAAI,CAAC,CAAC;QAAE,OAAO,CAAC,CAAC;IACjB,OAAO,MAAM,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,GAAG,OAAO,GAAG,MAAM,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,GAAG,KAAK,GAAG,MAAM,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,GAAG,IAAI,GAAG,MAAM,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC;AAC5F,CAAC;AAED;;sEAEsE;AACtE,MAAM,UAAU,eAAe,CAAC,EAAU;IACxC,MAAM,OAAO,GAAG,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,IAAI,CAAC,KAAK,CAAC,EAAE,CAAC,CAAC,CAAC;IAC5C,MAAM,MAAM,GAAG,OAAO,GAAG,IAAI,CAAC;IAC9B,MAAM,QAAQ,GAAG,IAAI,CAAC,KAAK,CAAC,OAAO,GAAG,IAAI,CAAC,CAAC;IAC5C,MAAM,CAAC,GAAG,QAAQ,GAAG,EAAE,CAAC;IACxB,MAAM,CAAC,GAAG,IAAI,CAAC,KAAK,CAAC,QAAQ,GAAG,EAAE,CAAC,GAAG,EAAE,CAAC;IACzC,MAAM,CAAC,GAAG,IAAI,CAAC,KAAK,CAAC,QAAQ,GAAG,IAAI,CAAC,CAAC;IACtC,MAAM,GAAG,GAAG,CAAC,CAAS,EAAE,CAAC,GAAG,CAAC,EAAU,EAAE,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,QAAQ,CAAC,CAAC,EAAE,GAAG,CAAC,CAAC;IACrE,OAAO,GAAG,GAAG,CAAC,CAAC,CAAC,IAAI,GAAG,CAAC,CAAC,CAAC,IAAI,GAAG,CAAC,CAAC,CAAC,IAAI,GAAG,CAAC,MAAM,EAAE,CAAC,CAAC,EAAE,CAAC;AAC3D,CAAC;AAED;;2GAE2G;AAC3G,MAAM,UAAU,SAAS,CAAC,GAAW,EAAE,aAAqB;IAC1D,IAAI,CAAC,MAAM,CAAC,QAAQ,CAAC,aAAa,CAAC,IAAI,aAAa,KAAK,CAAC;QAAE,OAAO,GAAG,CAAC;IACvE,MAAM,QAAQ,GAAG,IAAI,CAAC,KAAK,CAAC,aAAa,GAAG,IAAI,CAAC,CAAC;IAClD,OAAO,GAAG;SACP,KAAK,CAAC,IAAI,CAAC;SACX,GAAG,CAAC,CAAC,IAAI,EAAE,EAAE;QACZ,IAAI,CAAC,IAAI,CAAC,QAAQ,CAAC,KAAK,CAAC;YAAE,OAAO,IAAI,CAAC;QACvC,OAAO,IAAI,CAAC,OAAO,CAAC,oCAAoC,EAAE,CAAC,EAAE,EAAE,CAAC,EAAE,EAAE,EAAE,EAAE,EAAE,GAAG,EAAE,EAAE;YAC/E,MAAM,IAAI,GAAG,MAAM,CAAC,CAAC,CAAC,GAAG,OAAO,GAAG,MAAM,CAAC,EAAE,CAAC,GAAG,KAAK,GAAG,MAAM,CAAC,EAAE,CAAC,GAAG,IAAI,GAAG,MAAM,CAAC,GAAG,CAAC,CAAC;YACxF,OAAO,eAAe,CAAC,IAAI,GAAG,QAAQ,CAAC,CAAC;QAC1C,CAAC,CAAC,CAAC;IACL,CAAC,CAAC;SACD,IAAI,CAAC,IAAI,CAAC,CAAC;AAChB,CAAC"}

package/dist/storyboard-ids.d.ts

@@ -0,0 +1,2 @@
+export declare function coerceShotId(rawId: string | undefined, index: number): string;
+//# sourceMappingURL=storyboard-ids.d.ts.map

package/dist/storyboard-ids.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"storyboard-ids.d.ts","sourceRoot":"","sources":["../src/storyboard-ids.ts"],"names":[],"mappings":"AAIA,wBAAgB,YAAY,CAAC,KAAK,EAAE,MAAM,GAAG,SAAS,EAAE,KAAK,EAAE,MAAM,GAAG,MAAM,CAM7E"}

package/dist/storyboard-ids.js

@@ -0,0 +1,12 @@
+// Storyboard shot-id coercion (pure). Full validator: storyboard-validate.ts.
+const SHOT_ID_RE = /^shot_\d+$/;
+export function coerceShotId(rawId, index) {
+    const desired = `shot_${String(index + 1).padStart(2, "0")}`;
+    if (typeof rawId !== "string")
+        return desired;
+    const trimmed = rawId.trim();
+    if (trimmed.length === 0)
+        return desired;
+    return SHOT_ID_RE.test(trimmed) ? trimmed : desired;
+}
+//# sourceMappingURL=storyboard-ids.js.map

package/dist/storyboard-ids.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"storyboard-ids.js","sourceRoot":"","sources":["../src/storyboard-ids.ts"],"names":[],"mappings":"AAAA,8EAA8E;AAE9E,MAAM,UAAU,GAAG,YAAY,CAAC;AAEhC,MAAM,UAAU,YAAY,CAAC,KAAyB,EAAE,KAAa;IACnE,MAAM,OAAO,GAAG,QAAQ,MAAM,CAAC,KAAK,GAAG,CAAC,CAAC,CAAC,QAAQ,CAAC,CAAC,EAAE,GAAG,CAAC,EAAE,CAAC;IAC7D,IAAI,OAAO,KAAK,KAAK,QAAQ;QAAE,OAAO,OAAO,CAAC;IAC9C,MAAM,OAAO,GAAG,KAAK,CAAC,IAAI,EAAE,CAAC;IAC7B,IAAI,OAAO,CAAC,MAAM,KAAK,CAAC;QAAE,OAAO,OAAO,CAAC;IACzC,OAAO,UAAU,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,OAAO,CAAC;AACtD,CAAC"}

package/dist/storyboard-projects-db.d.ts

@@ -0,0 +1,31 @@
+import type { DbEnv } from "./db-env.js";
+export interface StoryboardProject {
+    id: number;
+    public_id: string;
+    slug: string;
+    name: string;
+    prefs: Record<string, unknown>;
+    last_storyboard: unknown | null;
+    created_at: string;
+    updated_at: string;
+}
+export type PublicStoryboardProject = Omit<StoryboardProject, "id" | "public_id"> & {
+    id: string;
+};
+export declare function toPublicProject(row: StoryboardProject): PublicStoryboardProject;
+export declare function slugifyProject(name: string): string;
+export declare function allocateProjectSlug(env: DbEnv, base: string): Promise<string>;
+export declare function listProjects(env: DbEnv): Promise<StoryboardProject[]>;
+export declare function getProjectIdByPublicId(env: DbEnv, publicId: string): Promise<number | null>;
+export declare function getProjectById(env: DbEnv, id: number): Promise<StoryboardProject | null>;
+export declare function createProject(env: DbEnv, input: {
+    name: string;
+    prefs?: Record<string, unknown>;
+}): Promise<StoryboardProject>;
+export declare function updateProjectMeta(env: DbEnv, id: number, patch: {
+    name?: string;
+    prefs?: Record<string, unknown>;
+}): Promise<StoryboardProject | null>;
+export declare function setLastStoryboard(env: DbEnv, id: number, storyboard: unknown): Promise<StoryboardProject | null>;
+export declare function deleteProject(env: DbEnv, id: number): Promise<StoryboardProject | null>;
+//# sourceMappingURL=storyboard-projects-db.d.ts.map

package/dist/storyboard-projects-db.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"storyboard-projects-db.d.ts","sourceRoot":"","sources":["../src/storyboard-projects-db.ts"],"names":[],"mappings":"AASA,OAAO,KAAK,EAAE,KAAK,EAAE,MAAM,aAAa,CAAC;AAGzC,MAAM,WAAW,iBAAiB;IAEhC,EAAE,EAAE,MAAM,CAAC;IAEX,SAAS,EAAE,MAAM,CAAC;IAClB,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,MAAM,CAAC;IACb,KAAK,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IAC/B,eAAe,EAAE,OAAO,GAAG,IAAI,CAAC;IAChC,UAAU,EAAE,MAAM,CAAC;IACnB,UAAU,EAAE,MAAM,CAAC;CACpB;AAwCD,MAAM,MAAM,uBAAuB,GAAG,IAAI,CAAC,iBAAiB,EAAE,IAAI,GAAG,WAAW,CAAC,GAAG;IAAE,EAAE,EAAE,MAAM,CAAA;CAAE,CAAC;AAEnG,wBAAgB,eAAe,CAAC,GAAG,EAAE,iBAAiB,GAAG,uBAAuB,CAG/E;AAID,wBAAgB,cAAc,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CASnD;AAED,wBAAsB,mBAAmB,CAAC,GAAG,EAAE,KAAK,EAAE,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC,CAcnF;AAMD,wBAAsB,YAAY,CAAC,GAAG,EAAE,KAAK,GAAG,OAAO,CAAC,iBAAiB,EAAE,CAAC,CAW3E;AAID,wBAAsB,sBAAsB,CAAC,GAAG,EAAE,KAAK,EAAE,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,GAAG,IAAI,CAAC,CAOjG;AAED,wBAAsB,cAAc,CAAC,GAAG,EAAE,KAAK,EAAE,EAAE,EAAE,MAAM,GAAG,OAAO,CAAC,iBAAiB,GAAG,IAAI,CAAC,CAW9F;AAED,wBAAsB,aAAa,CACjC,GAAG,EAAE,KAAK,EACV,KAAK,EAAE;IAAE,IAAI,EAAE,MAAM,CAAC;IAAC,KAAK,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAA;CAAE,GACvD,OAAO,CAAC,iBAAiB,CAAC,CAc5B;AAED,wBAAsB,iBAAiB,CACrC,GAAG,EAAE,KAAK,EACV,EAAE,EAAE,MAAM,EACV,KAAK,EAAE;IAAE,IAAI,CAAC,EAAE,MAAM,CAAC;IAAC,KAAK,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAA;CAAE,GACxD,OAAO,CAAC,iBAAiB,GAAG,IAAI,CAAC,CAyBnC;AAED,wBAAsB,iBAAiB,CACrC,GAAG,EAAE,KAAK,EACV,EAAE,EAAE,MAAM,EACV,UAAU,EAAE,OAAO,GAClB,OAAO,CAAC,iBAAiB,GAAG,IAAI,CAAC,CAYnC;AAED,wBAAsB,aAAa,CAAC,GAAG,EAAE,KAAK,EAAE,EAAE,EAAE,MAAM,GAAG,OAAO,CAAC,iBAAiB,GAAG,IAAI,CAAC,CAS7F"}

package/dist/storyboard-projects-db.js

@@ -0,0 +1,153 @@
+// D1 helpers for persisted storyboard projects (v0.53.0). One row per project; holds a free-form
+// prefs object and a snapshot of the last saved storyboard so the planner can resume across
+// sessions and devices.
+//
+// Vivijure is a SINGLE-OPERATOR studio: there is no per-user scoping. Slugs are globally unique;
+// every query is unscoped (the legacy identity column was removed in the identity strip; memory:
+// vivijure-user-email-strip). Mirrors src/cast-db.ts shape: pure-row interface, slug allocation
+// bounded at 200 attempts.
+import { newPublicId } from "./public-id.js";
+function parseJson(raw, fallback) {
+    if (!raw)
+        return fallback;
+    try {
+        return JSON.parse(raw);
+    }
+    catch {
+        return fallback;
+    }
+}
+function rowToProject(row) {
+    return {
+        id: row.id,
+        public_id: row.public_id,
+        slug: row.slug,
+        name: row.name,
+        prefs: parseJson(row.prefs_json, {}),
+        last_storyboard: row.last_storyboard_json
+            ? parseJson(row.last_storyboard_json, null)
+            : null,
+        created_at: row.created_at,
+        updated_at: row.updated_at,
+    };
+}
+export function toPublicProject(row) {
+    const { id: _internalId, public_id, ...rest } = row;
+    return { ...rest, id: public_id };
+}
+// URL-safe slug from a display name. Empty / all-punctuation falls
+// back to "project". Matches the planner-side slug rules.
+export function slugifyProject(name) {
+    const s = name
+        .toLowerCase()
+        .normalize("NFKD")
+        .replace(/[^a-z0-9\s-]+/g, "")
+        .trim()
+        .replace(/[\s-]+/g, "-")
+        .replace(/^-+|-+$/g, "");
+    return s || "project";
+}
+export async function allocateProjectSlug(env, base) {
+    let candidate = base;
+    let suffix = 2;
+    while (suffix < 200) {
+        const existing = await env.DB.prepare(`SELECT id FROM storyboard_projects WHERE slug = ? LIMIT 1`)
+            .bind(candidate)
+            .first();
+        if (!existing)
+            return candidate;
+        candidate = `${base}-${suffix}`;
+        suffix++;
+    }
+    throw new Error(`Could not allocate project slug after 200 attempts (base='${base}')`);
+}
+// Bound the project list so it can never scan unboundedly (issue #12). Generous, so the
+// newest-first list is effectively complete while the query stays capped.
+const PROJECT_LIST_LIMIT = 500;
+export async function listProjects(env) {
+    const result = await env.DB.prepare(`SELECT id, public_id, slug, name, prefs_json, last_storyboard_json,
+            created_at, updated_at
+       FROM storyboard_projects
+      ORDER BY created_at DESC
+      LIMIT ?`)
+        .bind(PROJECT_LIST_LIMIT)
+        .all();
+    return (result.results || []).map(rowToProject);
+}
+// Resolve an opaque public id to the internal integer PK (the :id route + ?project_id boundary).
+// Null when no project carries that public_id -- a bare integer matches nothing, so callers 404.
+export async function getProjectIdByPublicId(env, publicId) {
+    const row = await env.DB.prepare(`SELECT id FROM storyboard_projects WHERE public_id = ? LIMIT 1`)
+        .bind(publicId)
+        .first();
+    return row ? Number(row.id) : null;
+}
+export async function getProjectById(env, id) {
+    const row = await env.DB.prepare(`SELECT id, public_id, slug, name, prefs_json, last_storyboard_json,
+            created_at, updated_at
+       FROM storyboard_projects
+      WHERE id = ?
+      LIMIT 1`)
+        .bind(id)
+        .first();
+    return row ? rowToProject(row) : null;
+}
+export async function createProject(env, input) {
+    const baseSlug = slugifyProject(input.name);
+    const slug = await allocateProjectSlug(env, baseSlug);
+    const prefsJson = JSON.stringify(input.prefs ?? {});
+    const row = await env.DB.prepare(`INSERT INTO storyboard_projects (public_id, slug, name, prefs_json)
+     VALUES (?, ?, ?, ?)
+     RETURNING id, public_id, slug, name, prefs_json, last_storyboard_json,
+               created_at, updated_at`)
+        .bind(newPublicId(), slug, input.name, prefsJson)
+        .first();
+    if (!row)
+        throw new Error("createProject: INSERT...RETURNING produced no row");
+    return rowToProject(row);
+}
+export async function updateProjectMeta(env, id, patch) {
+    const fields = [];
+    const values = [];
+    if (patch.name !== undefined) {
+        fields.push("name = ?");
+        values.push(patch.name);
+    }
+    if (patch.prefs !== undefined) {
+        fields.push("prefs_json = ?");
+        values.push(JSON.stringify(patch.prefs));
+    }
+    if (fields.length === 0) {
+        return getProjectById(env, id);
+    }
+    fields.push("updated_at = datetime('now')");
+    values.push(id);
+    const row = await env.DB.prepare(`UPDATE storyboard_projects SET ${fields.join(", ")}
+      WHERE id = ?
+     RETURNING id, public_id, slug, name, prefs_json, last_storyboard_json,
+               created_at, updated_at`)
+        .bind(...values)
+        .first();
+    return row ? rowToProject(row) : null;
+}
+export async function setLastStoryboard(env, id, storyboard) {
+    const sbJson = JSON.stringify(storyboard);
+    const row = await env.DB.prepare(`UPDATE storyboard_projects
+        SET last_storyboard_json = ?, updated_at = datetime('now')
+      WHERE id = ?
+     RETURNING id, public_id, slug, name, prefs_json, last_storyboard_json,
+               created_at, updated_at`)
+        .bind(sbJson, id)
+        .first();
+    return row ? rowToProject(row) : null;
+}
+export async function deleteProject(env, id) {
+    const cur = await getProjectById(env, id);
+    if (!cur)
+        return null;
+    await env.DB.prepare(`DELETE FROM storyboard_projects WHERE id = ?`)
+        .bind(id)
+        .run();
+    return cur;
+}
+//# sourceMappingURL=storyboard-projects-db.js.map

package/dist/storyboard-projects-db.js.map

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