videobook-engine 5.0.1 → 5.3.2

package/dist/migrate-grid-v23.js

@@ -0,0 +1,31 @@
+import { SCHEMA_VERSION } from "./catalog-metadata.js";
+import { rewriteCatalogMentions } from "./migrate-grid-text.js";
+import { notebookGridAddress } from "./notebook-grid.js";
+// Schema 23 labelled columns a-h and rows 1-64 (@a1-@h64). Schema 24 keeps
+// the same 8x64 slots but letters the rows and numbers the columns, so every
+// stored mention is re-encoded in place; no cell moves.
+const V23_ADDRESS_SOURCE = "[a-h](?:6[0-4]|[1-5][0-9]|[1-9])";
+const V23_MENTION_PATTERN = new RegExp(`@(${V23_ADDRESS_SOURCE})(?![\\w-])`, "giu");
+const V23_ADDRESS_PATTERN = new RegExp(`^${V23_ADDRESS_SOURCE}$`, "iu");
+export function parseV23GridAddress(value) {
+    const address = value.trim().replace(/^@/u, "").toLowerCase();
+    if (!V23_ADDRESS_PATTERN.test(address))
+        return undefined;
+    return {
+        column: address.charCodeAt(0) - 97,
+        row: Number(address.slice(1)) - 1,
+    };
+}
+export function rewriteV23Mentions(text) {
+    return text.replace(V23_MENTION_PATTERN, (raw, address) => {
+        const slot = parseV23GridAddress(address);
+        return slot ? `@${notebookGridAddress(slot)}` : raw;
+    });
+}
+export function applyV23NotebookGridMigration(db) {
+    const rewritten = rewriteCatalogMentions(db, () => rewriteV23Mentions);
+    db.prepare("UPDATE engine_schema SET version=? WHERE singleton=1")
+        .run(SCHEMA_VERSION);
+    return { rewritten };
+}
+//# sourceMappingURL=migrate-grid-v23.js.map

package/dist/migrate-grid-v23.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"migrate-grid-v23.js","sourceRoot":"","sources":["../src/migrate-grid-v23.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,cAAc,EAAE,MAAM,uBAAuB,CAAC;AAEvD,OAAO,EAAE,sBAAsB,EAAE,MAAM,wBAAwB,CAAC;AAChE,OAAO,EAAE,mBAAmB,EAAE,MAAM,oBAAoB,CAAC;AAEzD,2EAA2E;AAC3E,6EAA6E;AAC7E,wDAAwD;AACxD,MAAM,kBAAkB,GAAG,kCAAkC,CAAC;AAC9D,MAAM,mBAAmB,GAAG,IAAI,MAAM,CACpC,KAAK,kBAAkB,aAAa,EACpC,KAAK,CACN,CAAC;AACF,MAAM,mBAAmB,GAAG,IAAI,MAAM,CAAC,IAAI,kBAAkB,GAAG,EAAE,IAAI,CAAC,CAAC;AAMxE,MAAM,UAAU,mBAAmB,CACjC,KAAa;IAEb,MAAM,OAAO,GAAG,KAAK,CAAC,IAAI,EAAE,CAAC,OAAO,CAAC,KAAK,EAAE,EAAE,CAAC,CAAC,WAAW,EAAE,CAAC;IAC9D,IAAI,CAAC,mBAAmB,CAAC,IAAI,CAAC,OAAO,CAAC;QAAE,OAAO,SAAS,CAAC;IACzD,OAAO;QACL,MAAM,EAAE,OAAO,CAAC,UAAU,CAAC,CAAC,CAAC,GAAG,EAAE;QAClC,GAAG,EAAE,MAAM,CAAC,OAAO,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC;KAClC,CAAC;AACJ,CAAC;AAED,MAAM,UAAU,kBAAkB,CAAC,IAAY;IAC7C,OAAO,IAAI,CAAC,OAAO,CAAC,mBAAmB,EAAE,CAAC,GAAW,EAAE,OAAe,EAAE,EAAE;QACxE,MAAM,IAAI,GAAG,mBAAmB,CAAC,OAAO,CAAC,CAAC;QAC1C,OAAO,IAAI,CAAC,CAAC,CAAC,IAAI,mBAAmB,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC,CAAC,GAAG,CAAC;IACtD,CAAC,CAAC,CAAC;AACL,CAAC;AAED,MAAM,UAAU,6BAA6B,CAC3C,EAAgB;IAEhB,MAAM,SAAS,GAAG,sBAAsB,CAAC,EAAE,EAAE,GAAG,EAAE,CAAC,kBAAkB,CAAC,CAAC;IACvE,EAAE,CAAC,OAAO,CAAC,sDAAsD,CAAC;SAC/D,GAAG,CAAC,cAAc,CAAC,CAAC;IACvB,OAAO,EAAE,SAAS,EAAE,CAAC;AACvB,CAAC"}

package/dist/migration-notebooks.d.ts

@@ -0,0 +1,25 @@
+import type { DatabaseSync } from "@dolthub/doltlite";
+import type { MigrationIssue } from "./mvp-contracts.js";
+import type { NotebookDocument } from "./notebook/types.js";
+export declare function legacyNotebookPlan(database: DatabaseSync): {
+    documents: NotebookDocument[];
+    issues: MigrationIssue[];
+    decisions: Array<{
+        notebookId: string;
+        properties: Record<string, unknown>;
+        cells: Array<{
+            cellId: string;
+            legacyType: string;
+            type: string;
+            x: number;
+            y: number;
+            row: number;
+            column: number;
+            legacyModel: string | null;
+            model?: string;
+            tool?: string;
+            modelSource: "explicit" | "legacy-default" | "none";
+        }>;
+    }>;
+};
+//# sourceMappingURL=migration-notebooks.d.ts.map

package/dist/migration-notebooks.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"migration-notebooks.d.ts","sourceRoot":"","sources":["../src/migration-notebooks.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,mBAAmB,CAAC;AAEtD,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,oBAAoB,CAAC;AAEzD,OAAO,KAAK,EAAgB,gBAAgB,EAAE,MAAM,qBAAqB,CAAC;AAsC1E,wBAAgB,kBAAkB,CAAC,QAAQ,EAAE,YAAY,GAAG;IAC1D,SAAS,EAAE,gBAAgB,EAAE,CAAC;IAC9B,MAAM,EAAE,cAAc,EAAE,CAAC;IACzB,SAAS,EAAE,KAAK,CAAC;QAAE,UAAU,EAAE,MAAM,CAAC;QAAC,UAAU,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;QAAC,KAAK,EAAE,KAAK,CAAC;YACvF,MAAM,EAAE,MAAM,CAAC;YAAC,UAAU,EAAE,MAAM,CAAC;YAAC,IAAI,EAAE,MAAM,CAAC;YAAC,CAAC,EAAE,MAAM,CAAC;YAAC,CAAC,EAAE,MAAM,CAAC;YAAC,GAAG,EAAE,MAAM,CAAC;YAAC,MAAM,EAAE,MAAM,CAAC;YACpG,WAAW,EAAE,MAAM,GAAG,IAAI,CAAC;YAAC,KAAK,CAAC,EAAE,MAAM,CAAC;YAAC,IAAI,CAAC,EAAE,MAAM,CAAC;YAAC,WAAW,EAAE,UAAU,GAAG,gBAAgB,GAAG,MAAM,CAAC;SAChH,CAAC,CAAA;KAAE,CAAC,CAAC;CACP,CAsDA"}

package/dist/migration-notebooks.js

@@ -0,0 +1,131 @@
+import { NOTEBOOK_GRID_CAPACITY, NOTEBOOK_GRID_COLUMN_COUNT } from "./notebook-grid.js";
+import { NOTEBOOK_CELL_TYPES } from "./schema.js";
+const LEGACY_GENERATION_DEFAULTS = {
+    image: "generate_kie_gpt_image_2_text_to_image",
+    video: "generate_kie_wan_2_7_text_to_video",
+};
+export function legacyNotebookPlan(database) {
+    const notebooks = database.prepare("SELECT * FROM notebooks ORDER BY notebook_id").all();
+    const cells = database.prepare(`SELECT c.*, a.kind AS artifact_kind FROM cells c
+    LEFT JOIN artifacts a ON a.artifact_id=c.output_artifact_id
+    ORDER BY c.notebook_id, c.position_y, c.position_x, c.cell_id`).all();
+    const edges = database.prepare("SELECT * FROM edges ORDER BY notebook_id, edge_id").all();
+    const documents = [];
+    const issues = [];
+    const decisions = [];
+    for (const notebook of notebooks) {
+        try {
+            const properties = objectJson(notebook.properties_json, "Notebook properties");
+            const rows = cells.filter((cell) => cell.notebook_id === notebook.notebook_id);
+            if (rows.length > NOTEBOOK_GRID_CAPACITY)
+                throw new Error(`Notebook has ${rows.length} cells; the current grid supports ${NOTEBOOK_GRID_CAPACITY}`);
+            const converted = rows.map((row, ordinal) => {
+                if (!Number.isFinite(row.position_x) || !Number.isFinite(row.position_y))
+                    throw new Error(`Invalid canvas position for ${row.cell_id}`);
+                return {
+                    id: row.cell_id, type: currentCellType(row), label: row.title,
+                    slot: { row: Math.floor(ordinal / NOTEBOOK_GRID_COLUMN_COUNT), column: ordinal % NOTEBOOK_GRID_COLUMN_COUNT },
+                    ...(row.entity_id === null ? {} : { outputEntityId: row.entity_id }),
+                    ...(row.prompt === null ? {} : { prompt: row.prompt }),
+                    ...currentModelFields(row),
+                    inputs: objectJson(row.inputs_json, `Inputs for ${row.cell_id}`),
+                    ...(row.output_artifact_id === null ? {} : { outputArtifactId: row.output_artifact_id }),
+                };
+            });
+            const notebookEdges = edges.filter((edge) => edge.notebook_id === notebook.notebook_id);
+            const occupiedInputs = new Set();
+            for (const edge of notebookEdges) {
+                const key = `${edge.target_cell_id}:${edge.target_input}`;
+                if (occupiedInputs.has(key))
+                    throw new Error(`Multiple edges target the same input: ${key}`);
+                occupiedInputs.add(key);
+            }
+            const document = {
+                ...compatibleProperties(properties),
+                id: notebook.notebook_id, name: notebook.name,
+                createdAt: new Date(notebook.created_at).toISOString(), cells: converted,
+                edges: notebookEdges.map((edge) => ({ id: edge.edge_id, source: edge.source_cell_id,
+                    target: edge.target_cell_id, targetInput: edge.target_input })),
+            };
+            documents.push(document);
+            decisions.push({ notebookId: notebook.notebook_id, properties, cells: rows.map((row, ordinal) => ({
+                    cellId: row.cell_id, legacyType: row.type, type: converted[ordinal].type,
+                    x: row.position_x, y: row.position_y, ...converted[ordinal].slot,
+                    legacyModel: row.model, ...currentModelFields(row),
+                    modelSource: LEGACY_GENERATION_DEFAULTS[row.type] && !row.model
+                        ? "legacy-default" : row.model === null ? "none" : "explicit",
+                })) });
+        }
+        catch (cause) {
+            issues.push({ code: "INVALID_REFERENCE", severity: "error", resource: `notebook:${notebook.notebook_id}`,
+                message: cause instanceof Error ? cause.message : String(cause) });
+        }
+    }
+    return { documents, decisions, issues };
+}
+function currentCellType(cell) {
+    if (cell.type === "image")
+        return "generate_image";
+    if (cell.type === "video")
+        return "generate_video";
+    if (NOTEBOOK_CELL_TYPES.includes(cell.type))
+        return cell.type;
+    if (cell.type === "scene")
+        return "prompt";
+    if (cell.type === "asset") {
+        if (cell.artifact_kind === "image" || cell.artifact_kind === "video" || cell.artifact_kind === "audio")
+            return cell.artifact_kind;
+        if (cell.artifact_kind === "final")
+            return "video";
+        if (cell.artifact_kind === "character")
+            return "character";
+        if (cell.artifact_kind === "script" || cell.artifact_kind === "prompt" || cell.artifact_kind === "scene")
+            return "prompt";
+    }
+    throw new Error(`Cannot represent legacy cell ${cell.cell_id} of type ${cell.type} without a supported source`);
+}
+function currentModelFields(cell) {
+    const fallback = LEGACY_GENERATION_DEFAULTS[cell.type];
+    if (fallback) {
+        const tool = cell.model || fallback;
+        return { model: tool, tool };
+    }
+    return cell.model === null ? {} : { model: cell.model };
+}
+function objectJson(json, label) {
+    const value = JSON.parse(json);
+    if (!value || typeof value !== "object" || Array.isArray(value))
+        throw new Error(`${label} must be an object`);
+    return value;
+}
+function compatibleProperties(properties) {
+    const result = {};
+    for (const key of ["description", "lifecycleState", "analysisRevision"]) {
+        if (properties[key] === undefined)
+            continue;
+        if (typeof properties[key] !== "string")
+            throw new Error(`Notebook ${key} must be a string`);
+        result[key] = properties[key];
+    }
+    if (properties.workflowVersion !== undefined) {
+        if (!Number.isSafeInteger(properties.workflowVersion))
+            throw new Error("Notebook workflowVersion must be an integer");
+        result.workflowVersion = properties.workflowVersion;
+    }
+    for (const key of ["fixture", "execution"]) {
+        if (properties[key] === undefined)
+            continue;
+        if (!properties[key] || typeof properties[key] !== "object" || Array.isArray(properties[key]))
+            throw new Error(`Notebook ${key} must be an object`);
+        result[key] = properties[key];
+    }
+    for (const key of ["generationPlans", "notebookRunPlans"]) {
+        if (properties[key] === undefined)
+            continue;
+        if (!Array.isArray(properties[key]))
+            throw new Error(`Notebook ${key} must be an array`);
+        result[key] = properties[key];
+    }
+    return result;
+}
+//# sourceMappingURL=migration-notebooks.js.map

package/dist/migration-notebooks.js.map

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

package/dist/migration-source.d.ts

@@ -0,0 +1,6 @@
+import { DatabaseSync } from "@dolthub/doltlite";
+export declare function openV4SourceSnapshot(root: string): {
+    database: DatabaseSync;
+    close: () => void;
+};
+//# sourceMappingURL=migration-source.d.ts.map

package/dist/migration-source.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"migration-source.d.ts","sourceRoot":"","sources":["../src/migration-source.ts"],"names":[],"mappings":"AAGA,OAAO,EAAE,YAAY,EAAE,MAAM,mBAAmB,CAAC;AAGjD,wBAAgB,oBAAoB,CAAC,IAAI,EAAE,MAAM,GAAG;IAAE,QAAQ,EAAE,YAAY,CAAC;IAAC,KAAK,EAAE,MAAM,IAAI,CAAA;CAAE,CAwBhG"}

package/dist/migration-source.js

@@ -0,0 +1,37 @@
+import { constants, copyFileSync, mkdtempSync, rmSync, statSync } from "node:fs";
+import { tmpdir } from "node:os";
+import { join } from "node:path";
+import { DatabaseSync } from "@dolthub/doltlite";
+import { EngineFault } from "./store.js";
+export function openV4SourceSnapshot(root) {
+    const source = join(root, "data", "videobook.db");
+    const directory = mkdtempSync(join(tmpdir(), "videobook-v4-inspect-"));
+    try {
+        const before = statSync(source, { bigint: true });
+        const target = join(directory, "videobook.db");
+        // Keep native connections and deferred statement cleanup off the legacy file.
+        copyFileSync(source, target, constants.COPYFILE_FICLONE);
+        const after = statSync(source, { bigint: true });
+        if (before.dev !== after.dev || before.ino !== after.ino || before.size !== after.size || before.mtimeNs !== after.mtimeNs) {
+            throw new EngineFault({ code: "STALE_REVISION", message: "Schema-v4 catalog changed while its inspection snapshot was copied" });
+        }
+        const database = new DatabaseSync(target, { readOnly: true });
+        let closed = false;
+        return { database, close: () => {
+                if (closed)
+                    return;
+                closed = true;
+                try {
+                    database.close();
+                }
+                finally {
+                    rmSync(directory, { recursive: true, force: true, maxRetries: 3 });
+                }
+            } };
+    }
+    catch (error) {
+        rmSync(directory, { recursive: true, force: true, maxRetries: 3 });
+        throw error;
+    }
+}
+//# sourceMappingURL=migration-source.js.map

package/dist/migration-source.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"migration-source.js","sourceRoot":"","sources":["../src/migration-source.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAE,YAAY,EAAE,WAAW,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,SAAS,CAAC;AACjF,OAAO,EAAE,MAAM,EAAE,MAAM,SAAS,CAAC;AACjC,OAAO,EAAE,IAAI,EAAE,MAAM,WAAW,CAAC;AACjC,OAAO,EAAE,YAAY,EAAE,MAAM,mBAAmB,CAAC;AACjD,OAAO,EAAE,WAAW,EAAE,MAAM,YAAY,CAAC;AAEzC,MAAM,UAAU,oBAAoB,CAAC,IAAY;IAC/C,MAAM,MAAM,GAAG,IAAI,CAAC,IAAI,EAAE,MAAM,EAAE,cAAc,CAAC,CAAC;IAClD,MAAM,SAAS,GAAG,WAAW,CAAC,IAAI,CAAC,MAAM,EAAE,EAAE,uBAAuB,CAAC,CAAC,CAAC;IACvE,IAAI,CAAC;QACH,MAAM,MAAM,GAAG,QAAQ,CAAC,MAAM,EAAE,EAAE,MAAM,EAAE,IAAI,EAAE,CAAC,CAAC;QAClD,MAAM,MAAM,GAAG,IAAI,CAAC,SAAS,EAAE,cAAc,CAAC,CAAC;QAC/C,8EAA8E;QAC9E,YAAY,CAAC,MAAM,EAAE,MAAM,EAAE,SAAS,CAAC,gBAAgB,CAAC,CAAC;QACzD,MAAM,KAAK,GAAG,QAAQ,CAAC,MAAM,EAAE,EAAE,MAAM,EAAE,IAAI,EAAE,CAAC,CAAC;QACjD,IAAI,MAAM,CAAC,GAAG,KAAK,KAAK,CAAC,GAAG,IAAI,MAAM,CAAC,GAAG,KAAK,KAAK,CAAC,GAAG,IAAI,MAAM,CAAC,IAAI,KAAK,KAAK,CAAC,IAAI,IAAI,MAAM,CAAC,OAAO,KAAK,KAAK,CAAC,OAAO,EAAE,CAAC;YAC3H,MAAM,IAAI,WAAW,CAAC,EAAE,IAAI,EAAE,gBAAgB,EAAE,OAAO,EAAE,oEAAoE,EAAE,CAAC,CAAC;QACnI,CAAC;QACD,MAAM,QAAQ,GAAG,IAAI,YAAY,CAAC,MAAM,EAAE,EAAE,QAAQ,EAAE,IAAI,EAAE,CAAC,CAAC;QAC9D,IAAI,MAAM,GAAG,KAAK,CAAC;QACnB,OAAO,EAAE,QAAQ,EAAE,KAAK,EAAE,GAAG,EAAE;gBAC7B,IAAI,MAAM;oBAAE,OAAO;gBACnB,MAAM,GAAG,IAAI,CAAC;gBACd,IAAI,CAAC;oBAAC,QAAQ,CAAC,KAAK,EAAE,CAAC;gBAAC,CAAC;wBACjB,CAAC;oBAAC,MAAM,CAAC,SAAS,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,KAAK,EAAE,IAAI,EAAE,UAAU,EAAE,CAAC,EAAE,CAAC,CAAC;gBAAC,CAAC;YACjF,CAAC,EAAE,CAAC;IACN,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QACf,MAAM,CAAC,SAAS,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,KAAK,EAAE,IAAI,EAAE,UAAU,EAAE,CAAC,EAAE,CAAC,CAAC;QACnE,MAAM,KAAK,CAAC;IACd,CAAC;AACH,CAAC"}

package/dist/migration-timeline.d.ts

@@ -0,0 +1,36 @@
+import type { DatabaseSync } from "@dolthub/doltlite";
+import type { ObjectStore } from "./cas.js";
+import type { Engine } from "./engine.js";
+import type { ArtifactStream, MigrationIssue, V4MigrationRequest } from "./mvp-contracts.js";
+interface LegacyPlacement {
+    legacyId: string;
+    artifactId: string;
+    path: string;
+    objectHash: string;
+    kind: "image" | "video" | "audio";
+    startFrame?: number;
+    durationFrames?: number;
+    volume: number | null;
+    fadeInMs: number | null;
+    fadeOutMs: number | null;
+}
+export declare function legacyTimelinePlan(database: DatabaseSync): {
+    placements: LegacyPlacement[];
+    issues: MigrationIssue[];
+};
+export declare function convertLegacyTimeline(engine: Engine, plan: ReturnType<typeof legacyTimelinePlan>, objects: ObjectStore, request: V4MigrationRequest): Promise<{
+    clips: {
+        legacyId: string;
+        clipId: string;
+        sourcePath: string;
+        objectHash: string;
+        startFrame: number;
+        durationFrames: number;
+    }[];
+    videoDurationFrames: number;
+    streams: ArtifactStream[];
+    frameRate: import("./mvp-time.js").Rational;
+    audioPlacement: string;
+}>;
+export {};
+//# sourceMappingURL=migration-timeline.d.ts.map

package/dist/migration-timeline.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"migration-timeline.d.ts","sourceRoot":"","sources":["../src/migration-timeline.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,mBAAmB,CAAC;AAItD,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,UAAU,CAAC;AAC5C,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,aAAa,CAAC;AAC1C,OAAO,KAAK,EAAE,cAAc,EAAgC,cAAc,EAAE,kBAAkB,EAAE,MAAM,oBAAoB,CAAC;AAK3H,UAAU,eAAe;IACvB,QAAQ,EAAE,MAAM,CAAC;IACjB,UAAU,EAAE,MAAM,CAAC;IACnB,IAAI,EAAE,MAAM,CAAC;IACb,UAAU,EAAE,MAAM,CAAC;IACnB,IAAI,EAAE,OAAO,GAAG,OAAO,GAAG,OAAO,CAAC;IAClC,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB,MAAM,EAAE,MAAM,GAAG,IAAI,CAAC;IACtB,QAAQ,EAAE,MAAM,GAAG,IAAI,CAAC;IACxB,SAAS,EAAE,MAAM,GAAG,IAAI,CAAC;CAC1B;AAYD,wBAAgB,kBAAkB,CAAC,QAAQ,EAAE,YAAY,GAAG;IAAE,UAAU,EAAE,eAAe,EAAE,CAAC;IAAC,MAAM,EAAE,cAAc,EAAE,CAAA;CAAE,CA2CtH;AAED,wBAAsB,qBAAqB,CAAC,MAAM,EAAE,MAAM,EAAE,IAAI,EAAE,UAAU,CAAC,OAAO,kBAAkB,CAAC,EAAE,OAAO,EAAE,WAAW,EAAE,OAAO,EAAE,kBAAkB;;kBAMrH,MAAM;gBAAU,MAAM;oBAAc,MAAM;oBAAc,MAAM;oBAAc,MAAM;wBAAkB,MAAM;;;;;;GA6E9I"}

package/dist/migration-timeline.js

@@ -0,0 +1,187 @@
+import { execFile } from "node:child_process";
+import { extname } from "node:path";
+import { promisify } from "node:util";
+import sharp from "sharp";
+import { v7 as uuidv7 } from "uuid";
+import { MVP_CONTRACT_VERSION } from "./mvp-contracts.js";
+import { sequenceFramesToSourceTicks, sourceTicksToSequenceFrames } from "./mvp-time.js";
+import { EngineFault } from "./store.js";
+export function legacyTimelinePlan(database) {
+    const files = database.prepare("SELECT artifact_id, path, object_hash FROM artifact_files ORDER BY artifact_id, path").all();
+    const slots = database.prepare(`SELECT s.*, a.kind FROM timeline_slots s JOIN artifacts a ON a.artifact_id=s.artifact_id
+    ORDER BY s.ordinal, s.slot_id`).all();
+    const audio = database.prepare(`SELECT s.*, a.kind FROM timeline_audio s JOIN artifacts a ON a.artifact_id=s.artifact_id
+    ORDER BY s.ordinal, s.audio_id`).all();
+    const placements = [];
+    const issues = [];
+    const add = (legacyId, artifactId, kind, values) => {
+        const extensions = kind === "image" ? [".png", ".jpg", ".jpeg", ".webp", ".avif"]
+            : kind === "video" ? [".mp4", ".mov", ".webm", ".mkv", ".avi"]
+                : [".wav", ".mp3", ".m4a", ".ogg", ".flac", ".aac", ".weba", ".mp4", ".mov", ".webm"];
+        const candidates = files.filter((file) => file.artifact_id === artifactId && extensions.includes(extname(file.path).toLowerCase()));
+        candidates.sort((left, right) => sourcePriority(left.path, kind) - sourcePriority(right.path, kind) || left.path.localeCompare(right.path));
+        const file = candidates[0];
+        if (!file) {
+            issues.push({ code: "UNSUPPORTED_MEDIA", severity: "error", resource: `timeline:${legacyId}`, message: `No supported ${kind} source file`, details: { artifactId } });
+            return;
+        }
+        if ([values.volume, values.fadeInMs, values.fadeOutMs].some((value) => value !== null && (!Number.isFinite(value) || value < 0))
+            || (values.startFrame !== undefined && (!Number.isSafeInteger(values.startFrame) || values.startFrame < 0))
+            || (values.durationFrames !== undefined && (!Number.isSafeInteger(values.durationFrames) || values.durationFrames <= 0))) {
+            issues.push({ code: "INVALID_REFERENCE", severity: "error", resource: `timeline:${legacyId}`, message: "Invalid legacy placement, volume or fade" });
+            return;
+        }
+        placements.push({ legacyId, artifactId, path: file.path, objectHash: file.object_hash, kind, ...values });
+        if (kind !== "image")
+            issues.push({ code: "PROBE_REQUIRED", severity: "warning", resource: `timeline:${legacyId}`,
+                message: `${kind} source will be probed during migration before publishing clips`, details: { artifactId, sourcePath: file.path } });
+    };
+    for (const slot of slots) {
+        if (!["image", "video", "final"].includes(slot.kind)) {
+            issues.push({ code: "UNSUPPORTED_MEDIA", severity: "error", resource: `timeline:${slot.slot_id}`, message: `Unsupported video-track artifact kind: ${slot.kind}` });
+            continue;
+        }
+        add(slot.slot_id, slot.artifact_id, slot.kind === "image" ? "image" : "video", {
+            volume: slot.volume, fadeInMs: slot.audio_fade_in, fadeOutMs: slot.audio_fade_out,
+        });
+    }
+    for (const clip of audio)
+        add(clip.audio_id, clip.artifact_id, "audio", {
+            startFrame: clip.start_frame, durationFrames: clip.duration_frames,
+            volume: clip.volume, fadeInMs: clip.fade_in, fadeOutMs: clip.fade_out,
+        });
+    return { placements, issues };
+}
+export async function convertLegacyTimeline(engine, plan, objects, request) {
+    const sequence = engine.sequences.getPrimary();
+    const videoTrack = sequence.tracks.find((track) => track.kind === "video");
+    const audioTrack = sequence.tracks.find((track) => track.kind === "audio");
+    const streams = new Map();
+    const images = new Set();
+    const decisions = [];
+    let videoEndFrame = 0;
+    let audioEndFrame = 0;
+    let operations = [];
+    const flush = async () => {
+        if (!operations.length)
+            return;
+        const intent = { intentVersion: MVP_CONTRACT_VERSION, commandId: uuidv7(), sequenceId: sequence.sequenceId,
+            baseRevision: engine.head, actor: "schema-v4-migration", sourceSurface: "system",
+            confirmationPolicy: "always", operations };
+        const preview = engine.edits.preview(intent);
+        if (!preview.ok)
+            throw new EngineFault(preview.error);
+        if (!preview.value.valid)
+            throw new EngineFault({ code: "INVALID_INPUT", message: "Legacy timeline cannot be represented",
+                details: { conflicts: preview.value.conflicts } });
+        const committed = await engine.edits.commit(intent, preview.value.previewHash);
+        if (!committed.ok)
+            throw new EngineFault(committed.error);
+        operations = [];
+    };
+    for (const [index, item] of plan.placements.entries()) {
+        if (request.signal?.aborted)
+            throw new EngineFault({ code: "CANCELLED", message: "Schema-v4 migration cancelled" });
+        const filePath = await objects.ensureLocalPath(item.objectHash);
+        let source;
+        let durationFrames;
+        if (item.kind === "image") {
+            if (!images.has(item.objectHash)) {
+                const metadata = await sharp(filePath).metadata();
+                if (!metadata.width || !metadata.height)
+                    throw new Error(`Invalid legacy image: ${item.path}`);
+                images.add(item.objectHash);
+            }
+            source = { kind: "still", artifactId: item.artifactId, sourcePath: item.path, objectHash: item.objectHash };
+            durationFrames = 90;
+        }
+        else {
+            const key = `${item.artifactId}:${item.path}:${item.kind}`;
+            let stream = streams.get(key);
+            if (!stream) {
+                const profile = await probeStream(filePath, item.kind, request);
+                const registered = await engine.streams.register({ ...profile, artifactId: item.artifactId, sourcePath: item.path, objectHash: item.objectHash });
+                if (!registered.ok)
+                    throw new EngineFault(registered.error);
+                stream = registered.value;
+                streams.set(key, stream);
+            }
+            durationFrames = item.durationFrames ?? Math.max(1, sourceTicksToSequenceFrames(stream.durationTicks, stream.timeBase, sequence.frameRate));
+            const durationTicks = item.kind === "audio"
+                ? Math.max(1, Math.min(stream.durationTicks, sequenceFramesToSourceTicks(durationFrames, sequence.frameRate, stream.timeBase)))
+                : stream.durationTicks;
+            source = { kind: "timed", artifactId: item.artifactId, range: { streamId: stream.streamId, objectHash: item.objectHash,
+                    startTick: 0, durationTicks, timeBase: stream.timeBase } };
+        }
+        const timelineStartFrame = item.startFrame ?? videoEndFrame;
+        const fadeInFrames = Math.round((item.fadeInMs ?? 0) * 30 / 1000);
+        const fadeOutFrames = Math.round((item.fadeOutMs ?? 0) * 30 / 1000);
+        if (fadeInFrames + fadeOutFrames > durationFrames) {
+            throw new EngineFault({ code: "INVALID_INPUT", message: `Legacy fades exceed the clip duration: ${item.legacyId}`,
+                details: { legacyId: item.legacyId, durationFrames, fadeInFrames, fadeOutFrames } });
+        }
+        const clipId = uuidv7();
+        const placement = {
+            trackId: item.kind === "audio" ? audioTrack.trackId : videoTrack.trackId, timelineStartFrame, durationFrames, source,
+            ...(source.kind === "timed" ? { speed: { numerator: 1, denominator: 1 }, reverse: false, audioPolicy: "preserve-pitch" } : {}),
+            ...(item.kind !== "audio" ? { transform: { fit: "fit", positionX: 0, positionY: 0, scaleX: 1, scaleY: 1,
+                    anchorX: 0.5, anchorY: 0.5, rotationDegrees: 0, cropTop: 0, cropRight: 0, cropBottom: 0, cropLeft: 0, opacity: 1, blendMode: "normal" } } : {}),
+            audio: { gainDb: item.volume === null ? 0 : item.volume === 0 ? -120 : 20 * Math.log10(item.volume / 100),
+                muted: item.volume === 0, fadeInFrames, fadeOutFrames },
+        };
+        if (item.kind === "audio") {
+            operations.push({ kind: "insert-clip", clipId, placement: { ...placement, timelineStartFrame: audioEndFrame }, mode: "insert" });
+            operations.push({ kind: "move-clip", clipId, trackId: audioTrack.trackId, timelineStartFrame });
+            audioEndFrame = Math.max(audioEndFrame, timelineStartFrame + durationFrames);
+        }
+        else
+            operations.push({ kind: "insert-clip", clipId, placement, mode: "overwrite" });
+        decisions.push({ legacyId: item.legacyId, clipId, sourcePath: item.path, objectHash: item.objectHash, startFrame: timelineStartFrame, durationFrames });
+        if (item.kind !== "audio")
+            videoEndFrame += durationFrames;
+        if (operations.length >= 100)
+            await flush();
+        request.onProgress?.({ phase: "copy-timeline", completed: index + 1, total: plan.placements.length });
+    }
+    if (request.signal?.aborted)
+        throw new EngineFault({ code: "CANCELLED", message: "Schema-v4 migration cancelled" });
+    await flush();
+    return { clips: decisions, videoDurationFrames: videoEndFrame, streams: [...streams.values()], frameRate: sequence.frameRate,
+        audioPlacement: "legacy start/duration at 30fps; native playback speed; fades in milliseconds" };
+}
+function sourcePriority(path, kind) {
+    if (kind === "audio" && /^audio_original\./i.test(path))
+        return 0;
+    if (/^original\./i.test(path))
+        return 1;
+    return 2;
+}
+async function probeStream(filePath, kind, request) {
+    const { stdout } = await promisify(execFile)(request.ffprobePath ?? "ffprobe", ["-v", "error", "-show_streams", "-show_format", "-of", "json", filePath], { encoding: "utf8", signal: request.signal, timeout: 60_000, maxBuffer: 4 * 1024 * 1024 });
+    const data = JSON.parse(stdout);
+    const stream = data.streams?.find((value) => value.codec_type === kind);
+    if (!stream)
+        throw new EngineFault({ code: "INVALID_INPUT", message: `No ${kind} stream in legacy media` });
+    const timeBase = ratio(String(stream.time_base));
+    const durationTicks = Number(stream.duration_ts ?? Math.round(Number(stream.duration ?? data.format?.duration) * timeBase.denominator / timeBase.numerator));
+    if (!Number.isSafeInteger(durationTicks) || durationTicks <= 0)
+        throw new EngineFault({ code: "INVALID_INPUT", message: "Legacy media has no finite positive source duration" });
+    const common = { streamIndex: Number(stream.index), kind, timeBase, durationTicks, codec: String(stream.codec_name ?? "unknown") };
+    if (kind === "audio")
+        return { ...common, audio: { sampleRateHz: Number(stream.sample_rate), channels: Number(stream.channels),
+                channelLayout: String(stream.channel_layout ?? (Number(stream.channels) === 1 ? "mono" : Number(stream.channels) === 2 ? "stereo" : "unknown")) } };
+    const sideData = stream.side_data_list;
+    const tags = stream.tags;
+    const rotationDegrees = Number(sideData?.find((value) => value.rotation !== undefined)?.rotation ?? tags?.rotate ?? 0);
+    return { ...common, video: { width: Number(stream.width), height: Number(stream.height), rotationDegrees,
+            pixelAspect: !stream.sample_aspect_ratio || stream.sample_aspect_ratio === "N/A" || stream.sample_aspect_ratio === "0:1"
+                ? { numerator: 1, denominator: 1 } : ratio(String(stream.sample_aspect_ratio).replace(":", "/")),
+            ...(stream.avg_frame_rate && stream.avg_frame_rate !== "0/0" ? { averageFrameRate: ratio(String(stream.avg_frame_rate)) } : {}) } };
+}
+function ratio(value) {
+    const [numerator, denominator] = value.split("/").map(Number);
+    if (!Number.isSafeInteger(numerator) || !Number.isSafeInteger(denominator) || numerator <= 0 || denominator <= 0)
+        throw new Error(`Invalid legacy media ratio: ${value}`);
+    return { numerator: numerator, denominator: denominator };
+}
+//# sourceMappingURL=migration-timeline.js.map

package/dist/migration-timeline.js.map

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

package/dist/migration-validation.d.ts

@@ -0,0 +1,12 @@
+import type { DatabaseSync } from "@dolthub/doltlite";
+import type { MigrationIssue } from "./mvp-contracts.js";
+export declare function legacyReferenceIssues(database: DatabaseSync): MigrationIssue[];
+export declare function legacyStateSummary(database: DatabaseSync): {
+    digest: string;
+    tables: Array<{
+        table: string;
+        rows: number;
+        digest: string;
+    }>;
+};
+//# sourceMappingURL=migration-validation.d.ts.map

package/dist/migration-validation.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"migration-validation.d.ts","sourceRoot":"","sources":["../src/migration-validation.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,mBAAmB,CAAC;AACtD,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,oBAAoB,CAAC;AAgBzD,wBAAgB,qBAAqB,CAAC,QAAQ,EAAE,YAAY,GAAG,cAAc,EAAE,CAgC9E;AAED,wBAAgB,kBAAkB,CAAC,QAAQ,EAAE,YAAY,GAAG;IAC1D,MAAM,EAAE,MAAM,CAAC;IAAC,MAAM,EAAE,KAAK,CAAC;QAAE,KAAK,EAAE,MAAM,CAAC;QAAC,IAAI,EAAE,MAAM,CAAC;QAAC,MAAM,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC;CAChF,CASA"}

package/dist/migration-validation.js

@@ -0,0 +1,68 @@
+import { createHash } from "node:crypto";
+const REFERENCES = [
+    ["artifact_files", "artifact_id", "artifacts", "artifact_id"],
+    ["artifact_files", "object_hash", "objects", "object_hash"],
+    ["artifact_metadata", "artifact_id", "artifacts", "artifact_id"],
+    ["cells", "notebook_id", "notebooks", "notebook_id"],
+    ["cells", "entity_id", "entities", "entity_id"],
+    ["cells", "output_artifact_id", "artifacts", "artifact_id"],
+    ["runs", "notebook_id", "notebooks", "notebook_id"],
+    ["timeline", "book_id", "book", "book_id"],
+    ["timeline_slots", "artifact_id", "artifacts", "artifact_id"],
+    ["timeline_audio", "artifact_id", "artifacts", "artifact_id"],
+    ["audio_waveforms", "artifact_id", "artifacts", "artifact_id"],
+];
+export function legacyReferenceIssues(database) {
+    const issues = [];
+    for (const [table, field, parent, parentField] of REFERENCES) {
+        const missing = database.prepare(`SELECT c.${field} AS id FROM ${table} c
+      LEFT JOIN ${parent} p ON p.${parentField}=c.${field}
+      WHERE c.${field} IS NOT NULL AND p.${parentField} IS NULL`).all();
+        for (const row of missing)
+            issues.push(invalid(`${table}:${row.id}`, `Missing ${parent} reference from ${table}.${field}`));
+    }
+    for (const field of ["source_cell_id", "target_cell_id"]) {
+        const missing = database.prepare(`SELECT e.edge_id FROM edges e LEFT JOIN cells c
+      ON c.notebook_id=e.notebook_id AND c.cell_id=e.${field}
+      WHERE c.cell_id IS NULL`).all();
+        for (const row of missing)
+            issues.push(invalid(`edge:${row.edge_id}`, `Missing notebook-local ${field}`));
+    }
+    const files = database.prepare("SELECT artifact_id, path, object_hash FROM artifact_files").all();
+    for (const file of files) {
+        if (!file.path || file.path.startsWith("/") || file.path.includes("\\") || file.path.includes("\0")
+            || file.path.split("/").some((part) => part === "." || part === ".." || part === "")) {
+            issues.push(invalid(`artifact:${file.artifact_id}`, `Invalid source file path: ${file.path}`));
+        }
+    }
+    for (const [table, field] of [["book_metadata", "value_json"], ["artifact_metadata", "value_json"], ["entities", "data_json"],
+        ["runs", "cell_order_json"], ["runs", "outputs_json"], ["prompt_entries", "context_json"], ["messages", "body_json"], ["audio_waveforms", "peaks_json"]]) {
+        const rows = database.prepare(`SELECT ${field} AS value FROM ${table}`).all();
+        for (const row of rows) {
+            try {
+                JSON.parse(row.value);
+            }
+            catch {
+                issues.push(invalid(`${table}:${field}`, "Malformed JSON in legacy semantic state"));
+            }
+        }
+    }
+    return issues;
+}
+export function legacyStateSummary(database) {
+    const names = database.prepare("SELECT name FROM sqlite_master WHERE type='table' ORDER BY name").all();
+    const tables = names.filter(({ name }) => !name.startsWith("runtime_") && !name.startsWith("sqlite_") && !name.startsWith("dolt_"))
+        .map(({ name }) => {
+        const rows = database.prepare(`SELECT * FROM "${name.replaceAll('"', '""')}"`).all();
+        const encoded = rows.map((row) => JSON.stringify(row, (_, value) => typeof value === "bigint" ? String(value) : value)).sort();
+        return { table: name, rows: rows.length, digest: digest(encoded) };
+    });
+    return { digest: digest(tables), tables };
+}
+function digest(value) {
+    return `sha256:${createHash("sha256").update(JSON.stringify(value)).digest("hex")}`;
+}
+function invalid(resource, message) {
+    return { code: "INVALID_REFERENCE", severity: "error", resource, message };
+}
+//# sourceMappingURL=migration-validation.js.map

package/dist/migration-validation.js.map

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