@nodetool-ai/cli 0.7.0-rc.23 → 0.8.2

package/dist/commands/timeline-score.js

@@ -0,0 +1,89 @@
+import { printCommandError } from "../command-errors.js";
+import { runTimelineRender } from "./timeline-render.js";
+/** Evenly spaced frames a `--sheet` render samples by default. */
+const SHEET_FRAME_COUNT = 12;
+export function evenlySpacedFrames(totalFrames, count) {
+    if (totalFrames <= 1)
+        return [0];
+    const n = Math.min(count, totalFrames);
+    const frames = new Set();
+    for (let i = 0; i < n; i += 1) {
+        frames.add(Math.round((i * (totalFrames - 1)) / Math.max(1, n - 1)));
+    }
+    return [...frames].sort((a, b) => a - b);
+}
+export function registerTimelineScoreCommand(timeline, loadSequence) {
+    timeline
+        .command("score <timeline_id_or_file>")
+        .description("Score a timeline document's craft against the shipped showcase examples (kite, prism, serein, tidewater, voltra) — a deterministic, no-LLM scorecard. Takes a timeline JSON file or a timeline_sequences row id")
+        .option("--json", "Print the full TimelineCraftScoreResult as JSON")
+        .option("--min-score <n>", "Exit non-zero when the score is below this threshold")
+        .option("--sheet <out.png>", `Also render a GPU contact sheet of ${SHEET_FRAME_COUNT} evenly spaced frames through the same renderer 'timeline render --sheet' uses`)
+        .action(async (ref, opts) => {
+        try {
+            const { resolveTimelineTarget } = await import("../timeline-debug/target.js");
+            const { scoreTimelineCraft } = await import("@nodetool-ai/execution/timeline-debug");
+            const sequenceLoader = await loadSequence();
+            const resolved = await resolveTimelineTarget(ref, {
+                loadSequence: sequenceLoader
+            });
+            const result = await scoreTimelineCraft(resolved.raw, {
+                fps: resolved.meta.fps,
+                width: resolved.meta.width,
+                height: resolved.meta.height
+            });
+            if (opts.sheet) {
+                const fps = resolved.meta.fps && resolved.meta.fps > 0
+                    ? resolved.meta.fps
+                    : 30;
+                const durationMs = resolved.meta.durationMs && resolved.meta.durationMs > 0
+                    ? resolved.meta.durationMs
+                    : resolved.document.clips.reduce((end, clip) => Math.max(end, clip.startMs + clip.durationMs), 0);
+                const totalFrames = Math.max(1, Math.round((durationMs / 1000) * fps));
+                const frames = evenlySpacedFrames(totalFrames, SHEET_FRAME_COUNT);
+                await runTimelineRender(ref, { out: opts.sheet, sheet: true, frames: frames.join(",") }, sequenceLoader);
+            }
+            if (opts.json) {
+                console.log(JSON.stringify(result, null, 2));
+            }
+            else {
+                console.log(renderTimelineScore(result).join("\n"));
+            }
+            const failed = opts.minScore !== undefined && result.score < Number(opts.minScore);
+            process.exit(failed ? 1 : 0);
+        }
+        catch (e) {
+            printCommandError(e, opts.json);
+            process.exit(1);
+        }
+    });
+}
+/** Human-readable rendering of a `TimelineCraftScoreResult`. */
+export function renderTimelineScore(result) {
+    const lines = [];
+    const distinctCodes = Object.keys(result.showcaseWarningCodeCounts).length;
+    lines.push(`Craft score: ${result.score.toFixed(1)}/100 (raw ${result.rawScore.toFixed(1)}, -${result.penalty} for ${distinctCodes} distinct showcase warning code(s))`);
+    lines.push(`Reference band: ${result.reference.entries.map((e) => e.slug).join(", ") || "(none found)"}`);
+    lines.push("");
+    lines.push("Metric                         value    median   credit");
+    for (const metric of result.metricScores) {
+        lines.push(`${metric.metric.padEnd(30)} ${metric.value.toFixed(2).padStart(8)} ${metric.referenceMedian.toFixed(2).padStart(8)} ${metric.credit.toFixed(2).padStart(8)}`);
+    }
+    if (result.showcaseWarnings.length > 0) {
+        lines.push("");
+        lines.push("Showcase warnings (penalized once per code, all instances shown):");
+        for (const [code, count] of Object.entries(result.showcaseWarningCodeCounts)) {
+            lines.push(`  - ${code} ×${count}`);
+        }
+        lines.push("");
+        for (const warning of result.showcaseWarnings) {
+            lines.push(`  - [${warning.code}] ${warning.message}`);
+        }
+    }
+    if (!result.validation.ok) {
+        lines.push("");
+        lines.push(`Document has ${result.validation.errors.length} validation error(s) — run 'timeline validate' for details.`);
+    }
+    return lines;
+}
+//# sourceMappingURL=timeline-score.js.map

package/dist/commands/timeline-score.js.map

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

package/dist/commands/timeline-validation-output.d.ts

@@ -0,0 +1,7 @@
+/**
+ * Human-readable rendering of a `TimelineValidation`, shared by
+ * `timeline validate` and `timeline versions restore`.
+ */
+import type { TimelineValidation } from "@nodetool-ai/execution/timeline-debug";
+export declare function renderTimelineValidation(validation: TimelineValidation): string[];
+//# sourceMappingURL=timeline-validation-output.d.ts.map

package/dist/commands/timeline-validation-output.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"timeline-validation-output.d.ts","sourceRoot":"","sources":["../../src/commands/timeline-validation-output.ts"],"names":[],"mappings":"AAAA;;;GAGG;AACH,OAAO,KAAK,EAEV,kBAAkB,EACnB,MAAM,uCAAuC,CAAC;AAG/C,wBAAgB,wBAAwB,CACtC,UAAU,EAAE,kBAAkB,GAC7B,MAAM,EAAE,CAQV"}

package/dist/commands/timeline-validation-output.js

@@ -0,0 +1,9 @@
+import { issueLocation, renderValidation } from "./validation-output.js";
+export function renderTimelineValidation(validation) {
+    return renderValidation(validation, (issue) => issue.clipId != null
+        ? ` [clip ${issue.clipId}]`
+        : issue.trackId != null
+            ? ` [track ${issue.trackId}]`
+            : issueLocation(issue));
+}
+//# sourceMappingURL=timeline-validation-output.js.map

package/dist/commands/timeline-validation-output.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"timeline-validation-output.js","sourceRoot":"","sources":["../../src/commands/timeline-validation-output.ts"],"names":[],"mappings":"AAQA,OAAO,EAAE,aAAa,EAAE,gBAAgB,EAAE,MAAM,wBAAwB,CAAC;AAEzE,MAAM,UAAU,wBAAwB,CACtC,UAA8B;IAE9B,OAAO,gBAAgB,CAAC,UAAU,EAAE,CAAC,KAAyB,EAAE,EAAE,CAChE,KAAK,CAAC,MAAM,IAAI,IAAI;QAClB,CAAC,CAAC,UAAU,KAAK,CAAC,MAAM,GAAG;QAC3B,CAAC,CAAC,KAAK,CAAC,OAAO,IAAI,IAAI;YACrB,CAAC,CAAC,WAAW,KAAK,CAAC,OAAO,GAAG;YAC7B,CAAC,CAAC,aAAa,CAAC,KAAK,CAAC,CAC3B,CAAC;AACJ,CAAC"}

package/dist/commands/timeline-versions.d.ts

@@ -0,0 +1,72 @@
+/**
+ * `nodetool timeline versions` — the version-history half of the timeline
+ * harness. The commands themselves live in `version-commands.ts`; this file is
+ * the timeline's row shapes, database seam, columns and messages.
+ *
+ * Timeline sequences keep immutable snapshots: manual saves, autosaves the
+ * server writes at most every five minutes, and the pre-restore snapshot that
+ * makes a restore undoable. The history is read and written directly against
+ * the local database, the way `timeline validate` and `timeline debug` read a
+ * sequence row, so an agent can work without a server.
+ */
+import type { Command } from "commander";
+import type { TimelineValidation } from "@nodetool-ai/execution/timeline-debug";
+import { type JsonValue, type VersionCommandDeps, type VersionStore } from "./version-commands.js";
+export { parseVersionDocument, parseVersionNumber } from "./version-commands.js";
+/** A `timeline_sequences` row as these commands need it. */
+export interface TimelineSequenceRow {
+    id: string;
+    user_id: string;
+    name?: string | null;
+    fps: number;
+    width: number;
+    height: number;
+    duration_ms: number;
+    updated_at: string;
+    document: string;
+}
+/** A `timeline_sequence_versions` row. */
+export interface TimelineVersionRow {
+    id: string;
+    timeline_id: string;
+    version: number;
+    name: string | null;
+    save_type: string;
+    fps: number;
+    width: number;
+    height: number;
+    duration_ms: number;
+    created_at: string;
+    document: string;
+}
+export type TimelineVersionStore = VersionStore<TimelineSequenceRow, TimelineVersionRow>;
+/** The list-item shape, matching the tRPC router's `timelineVersionListItem`. */
+export interface TimelineVersionListItem {
+    id: string;
+    timelineId: string;
+    version: number;
+    name: string | null;
+    saveType: string;
+    fps: number;
+    width: number;
+    height: number;
+    durationMs: number;
+    createdAt: string;
+}
+export declare function toVersionListItem(row: TimelineVersionRow): TimelineVersionListItem;
+/** One table row per version: what it is, when it was taken, what it renders. */
+export declare function versionTableRows(items: TimelineVersionListItem[]): Record<string, unknown>[];
+/** Track / clip / marker counts of whatever a version stored. */
+export declare function documentCounts(document: JsonValue | undefined): {
+    tracks: number;
+    clips: number;
+    markers: number;
+};
+interface TimelineValidateMeta {
+    fps?: number;
+    width?: number;
+    height?: number;
+}
+export type TimelineVersionsDeps = VersionCommandDeps<TimelineSequenceRow, TimelineVersionRow, TimelineValidation, TimelineValidateMeta>;
+export declare function registerTimelineVersionsCommands(timeline: Command, deps?: TimelineVersionsDeps): void;
+//# sourceMappingURL=timeline-versions.d.ts.map

package/dist/commands/timeline-versions.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"timeline-versions.d.ts","sourceRoot":"","sources":["../../src/commands/timeline-versions.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AACH,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AACzC,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,uCAAuC,CAAC;AAEhF,OAAO,EAGL,KAAK,SAAS,EACd,KAAK,kBAAkB,EAEvB,KAAK,YAAY,EAClB,MAAM,uBAAuB,CAAC;AAE/B,OAAO,EAAE,oBAAoB,EAAE,kBAAkB,EAAE,MAAM,uBAAuB,CAAC;AAEjF,4DAA4D;AAC5D,MAAM,WAAW,mBAAmB;IAClC,EAAE,EAAE,MAAM,CAAC;IACX,OAAO,EAAE,MAAM,CAAC;IAChB,IAAI,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IACrB,GAAG,EAAE,MAAM,CAAC;IACZ,KAAK,EAAE,MAAM,CAAC;IACd,MAAM,EAAE,MAAM,CAAC;IACf,WAAW,EAAE,MAAM,CAAC;IACpB,UAAU,EAAE,MAAM,CAAC;IACnB,QAAQ,EAAE,MAAM,CAAC;CAClB;AAED,0CAA0C;AAC1C,MAAM,WAAW,kBAAkB;IACjC,EAAE,EAAE,MAAM,CAAC;IACX,WAAW,EAAE,MAAM,CAAC;IACpB,OAAO,EAAE,MAAM,CAAC;IAChB,IAAI,EAAE,MAAM,GAAG,IAAI,CAAC;IACpB,SAAS,EAAE,MAAM,CAAC;IAClB,GAAG,EAAE,MAAM,CAAC;IACZ,KAAK,EAAE,MAAM,CAAC;IACd,MAAM,EAAE,MAAM,CAAC;IACf,WAAW,EAAE,MAAM,CAAC;IACpB,UAAU,EAAE,MAAM,CAAC;IACnB,QAAQ,EAAE,MAAM,CAAC;CAClB;AAED,MAAM,MAAM,oBAAoB,GAAG,YAAY,CAC7C,mBAAmB,EACnB,kBAAkB,CACnB,CAAC;AAEF,iFAAiF;AACjF,MAAM,WAAW,uBAAuB;IACtC,EAAE,EAAE,MAAM,CAAC;IACX,UAAU,EAAE,MAAM,CAAC;IACnB,OAAO,EAAE,MAAM,CAAC;IAChB,IAAI,EAAE,MAAM,GAAG,IAAI,CAAC;IACpB,QAAQ,EAAE,MAAM,CAAC;IACjB,GAAG,EAAE,MAAM,CAAC;IACZ,KAAK,EAAE,MAAM,CAAC;IACd,MAAM,EAAE,MAAM,CAAC;IACf,UAAU,EAAE,MAAM,CAAC;IACnB,SAAS,EAAE,MAAM,CAAC;CACnB;AAED,wBAAgB,iBAAiB,CAC/B,GAAG,EAAE,kBAAkB,GACtB,uBAAuB,CAazB;AAED,iFAAiF;AACjF,wBAAgB,gBAAgB,CAC9B,KAAK,EAAE,uBAAuB,EAAE,GAC/B,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAAE,CAE3B;AAaD,iEAAiE;AACjE,wBAAgB,cAAc,CAAC,QAAQ,EAAE,SAAS,GAAG,SAAS;IAG1D,MAAM;IACN,KAAK;IACL,OAAO;EAEV;AAkCD,UAAU,oBAAoB;IAC5B,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,MAAM,CAAC,EAAE,MAAM,CAAC;CACjB;AA0DD,MAAM,MAAM,oBAAoB,GAAG,kBAAkB,CACnD,mBAAmB,EACnB,kBAAkB,EAClB,kBAAkB,EAClB,oBAAoB,CACrB,CAAC;AAEF,wBAAgB,gCAAgC,CAC9C,QAAQ,EAAE,OAAO,EACjB,IAAI,GAAE,oBAAyB,GAC9B,IAAI,CAKN"}

package/dist/commands/timeline-versions.js

@@ -0,0 +1,108 @@
+import { renderTimelineValidation } from "./timeline-validation-output.js";
+import { countArray, registerVersionCommands } from "./version-commands.js";
+export { parseVersionDocument, parseVersionNumber } from "./version-commands.js";
+export function toVersionListItem(row) {
+    return {
+        id: row.id,
+        timelineId: row.timeline_id,
+        version: row.version,
+        name: row.name ?? null,
+        saveType: row.save_type,
+        fps: row.fps,
+        width: row.width,
+        height: row.height,
+        durationMs: row.duration_ms,
+        createdAt: row.created_at
+    };
+}
+/** One table row per version: what it is, when it was taken, what it renders. */
+export function versionTableRows(items) {
+    return items.map(tableRow);
+}
+function tableRow(v) {
+    return {
+        version: v.version,
+        saveType: v.saveType,
+        name: v.name ?? "",
+        createdAt: v.createdAt,
+        fps: v.fps,
+        resolution: `${v.width}x${v.height}`
+    };
+}
+/** Track / clip / marker counts of whatever a version stored. */
+export function documentCounts(document) {
+    const doc = (document ?? {});
+    return {
+        tracks: countArray(doc.tracks),
+        clips: countArray(doc.clips),
+        markers: countArray(doc.markers)
+    };
+}
+async function defaultStore() {
+    const { initDb, TimelineSequence, TimelineSequenceVersion } = await import("@nodetool-ai/models");
+    const { getDefaultDbPath } = await import("@nodetool-ai/config");
+    initDb(getDefaultDbPath());
+    return {
+        load: async (id) => await TimelineSequence.findById(id),
+        listVersions: async (timelineId, opts) => await TimelineSequenceVersion.listForTimeline(timelineId, opts),
+        findVersion: async (timelineId, version) => await TimelineSequenceVersion.findByVersion(timelineId, version),
+        snapshot: async (seq, opts) => await TimelineSequenceVersion.snapshot(seq, opts),
+        restore: async (seq, version) => await TimelineSequence.updateFieldsIfUnchanged(seq.id, seq.updated_at, {
+            document: version.document,
+            fps: version.fps,
+            width: version.width,
+            height: version.height,
+            duration_ms: version.duration_ms
+        }),
+        deleteVersion: async (timelineId, version) => {
+            const row = await TimelineSequenceVersion.findByVersion(timelineId, version);
+            if (row)
+                await row.delete();
+        }
+    };
+}
+async function defaultValidate(raw, meta) {
+    const { validateTimelineSequence } = await import("@nodetool-ai/execution/timeline-debug");
+    return await validateTimelineSequence(raw, meta);
+}
+const spec = {
+    idArg: "timeline_id",
+    idKey: "timelineId",
+    descriptions: {
+        group: "Inspect and restore the snapshot history of a timeline sequence (manual saves, autosaves, pre-restore snapshots)",
+        list: "List a timeline's versions, newest first",
+        show: "Print one version's metadata and the document it stored",
+        create: "Snapshot the sequence as it stands now (a manual save)",
+        restore: "Restore a version onto the sequence. The pre-restore state is snapshotted first, and the restored document is validated against the current schema — a restore whose document no longer validates exits non-zero",
+        delete: "Delete one version from a timeline's history",
+        restoreJson: "Print the restore result and validation as JSON"
+    },
+    notFoundDocument: (id) => `Timeline sequence not found: ${id}`,
+    notFoundVersion: (id, version) => `Timeline version not found: ${id} v${version}`,
+    conflict: "Timeline has been modified since last load",
+    confirmDelete: (id, version) => `Delete v${version} of timeline ${id}?`,
+    deleted: (id, version) => `✅ Deleted v${version} of timeline ${id}`,
+    toItem: toVersionListItem,
+    tableRow,
+    counts: documentCounts,
+    showSummary: (counts, item) => `\n  ${counts.tracks} track(s), ${counts.clips} clip(s), ${counts.markers} marker(s), ${item.durationMs}ms`,
+    restoreSummary: (id, version, counts, row) => `✅ Restored v${version} onto ${id}: ${counts.tracks} track(s), ${counts.clips} clip(s), ${row.duration_ms}ms @ ${row.fps}fps ${row.width}x${row.height}`,
+    restoreJsonExtra: (seq) => ({
+        sequence: {
+            id: seq.id,
+            fps: seq.fps,
+            width: seq.width,
+            height: seq.height,
+            durationMs: seq.duration_ms
+        }
+    }),
+    validateMeta: (row) => ({ fps: row.fps, width: row.width, height: row.height }),
+    renderValidation: renderTimelineValidation
+};
+export function registerTimelineVersionsCommands(timeline, deps = {}) {
+    registerVersionCommands(timeline, spec, deps, {
+        store: defaultStore,
+        validate: defaultValidate
+    });
+}
+//# sourceMappingURL=timeline-versions.js.map

package/dist/commands/timeline-versions.js.map

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

package/dist/commands/timeline.d.ts

@@ -0,0 +1,22 @@
+/**
+ * `nodetool timeline validate`, `debug`, `render` and `versions` — the
+ * timeline harness commands.
+ *
+ * `validate` checks a timeline document statically: tracks a clip points at,
+ * fields a round trip through the schema would strip, timings that cannot
+ * render. `debug` additionally replays a scripted `--interact` edit session
+ * against the headless `ui_timeline_*` bridge and writes a bundle. Both take a
+ * timeline JSON file or a `timeline_sequences` row id. `render`
+ * (timeline-render.ts) renders the picture through the GPU compositor.
+ * `versions` (timeline-versions.ts) reads and restores a sequence's snapshot
+ * history.
+ *
+ * Heavy dependencies (the database, the validator core, the bridge) are
+ * imported lazily inside each action, so command registration stays light and
+ * unit-testable.
+ */
+import type { Command } from "commander";
+import { renderTimelineValidation } from "./timeline-validation-output.js";
+export { renderTimelineValidation };
+export declare function registerTimelineCommands(program: Command): void;
+//# sourceMappingURL=timeline.d.ts.map

package/dist/commands/timeline.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"timeline.d.ts","sourceRoot":"","sources":["../../src/commands/timeline.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;GAgBG;AACH,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAKzC,OAAO,EAAE,wBAAwB,EAAE,MAAM,iCAAiC,CAAC;AAK3E,OAAO,EAAE,wBAAwB,EAAE,CAAC;AAuCpC,wBAAgB,wBAAwB,CAAC,OAAO,EAAE,OAAO,GAAG,IAAI,CAgG/D"}

package/dist/commands/timeline.js

@@ -0,0 +1,105 @@
+import { printCommandError } from "../command-errors.js";
+import { printDebugSummary } from "./debug-summary-output.js";
+import { renderTimelineValidation } from "./timeline-validation-output.js";
+import { registerTimelineRenderCommand } from "./timeline-render.js";
+import { registerTimelineScoreCommand } from "./timeline-score.js";
+import { registerTimelineVersionsCommands } from "./timeline-versions.js";
+export { renderTimelineValidation };
+/** Read a sequence row through the local database. */
+async function sequenceLoader() {
+    const { initDb, TimelineSequence } = await import("@nodetool-ai/models");
+    const { getDefaultDbPath } = await import("@nodetool-ai/config");
+    let ready = false;
+    return async (id) => {
+        if (!ready) {
+            initDb(getDefaultDbPath());
+            ready = true;
+        }
+        const row = await TimelineSequence.findById(id);
+        return row
+            ? {
+                id: row.id,
+                name: row.name,
+                fps: row.fps,
+                width: row.width,
+                height: row.height,
+                document: row.document
+            }
+            : null;
+    };
+}
+export function registerTimelineCommands(program) {
+    const timeline = program
+        .command("timeline")
+        .description("Work with timeline sequences");
+    timeline
+        .command("validate <timeline_id_or_file>")
+        .description("Validate a timeline document without rendering it: clips on missing tracks, fields a schema round trip would strip, unrenderable timings. Takes a timeline JSON file or a timeline_sequences row id")
+        .option("--json", "Print the full TimelineValidation as JSON")
+        .option("--warnings-as-errors", "Exit non-zero when there are warnings (not just errors)")
+        .action(async (ref, opts) => {
+        try {
+            const { runTimelineValidate } = await import("../timeline-debug/index.js");
+            const { target, validation } = await runTimelineValidate(ref, {
+                loadSequence: await sequenceLoader()
+            });
+            if (opts.json) {
+                console.log(JSON.stringify({ target, validation }, null, 2));
+            }
+            else {
+                console.log(renderTimelineValidation(validation).join("\n"));
+            }
+            const failed = !validation.ok ||
+                (opts.warningsAsErrors === true && validation.warnings.length > 0);
+            process.exit(failed ? 1 : 0);
+        }
+        catch (e) {
+            printCommandError(e, opts.json);
+            process.exit(1);
+        }
+    });
+    timeline
+        .command("debug <timeline_id_or_file>")
+        .description("Replay a scripted edit session against a timeline headlessly and collect a debug bundle (the document, the report, every step's result)")
+        .option("--interact <json>", 'Scripted steps: [{"tool":"add_track","input":{"type":"audio"}}] — the ui_timeline_ prefix is optional')
+        .option("--out <dir>", "Bundle output directory (default: nodetool-debug/timeline-<id>-<timestamp>)")
+        .option("--json", "Print the full TimelineDebugReport as JSON to stdout")
+        .action(async (ref, opts) => {
+        try {
+            const { parseInteractionScript, runTimelineDebug } = await import("../timeline-debug/index.js");
+            const interact = opts.interact
+                ? parseInteractionScript(opts.interact)
+                : undefined;
+            const debugOptions = {};
+            if (interact) {
+                debugOptions.interact = interact;
+            }
+            if (opts.out) {
+                debugOptions.outDir = opts.out;
+            }
+            const { report, bundleDir } = await runTimelineDebug(ref, debugOptions, {
+                loadSequence: await sequenceLoader(),
+                onLog: (line) => console.error(line)
+            });
+            if (opts.json) {
+                console.log(JSON.stringify(report, null, 2));
+            }
+            else {
+                printDebugSummary(report, bundleDir, {
+                    label: "timeline",
+                    meta: `${report.meta.trackCount} track(s), ${report.meta.clipCount} clip(s), ${report.meta.durationMs}ms @ ${report.meta.fps}fps`,
+                    file: "timeline.json"
+                });
+            }
+            process.exit(report.verdict.ok ? 0 : 1);
+        }
+        catch (e) {
+            printCommandError(e, opts.json);
+            process.exit(1);
+        }
+    });
+    registerTimelineRenderCommand(timeline, sequenceLoader);
+    registerTimelineScoreCommand(timeline, sequenceLoader);
+    registerTimelineVersionsCommands(timeline);
+}
+//# sourceMappingURL=timeline.js.map

package/dist/commands/timeline.js.map

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

package/dist/commands/validate.d.ts

@@ -0,0 +1,22 @@
+/**
+ * `nodetool validate` — static workflow validator.
+ *
+ * Loads a workflow (DB id, JSON file, or DSL .ts file) and checks it against
+ * the node registry without running it: unknown node types, missing required
+ * properties, unselected models, dangling/mis-typed edges. Returns in well
+ * under a second, so it's the fast pre-flight before an expensive `debug` run.
+ * Heavy deps are imported lazily so command registration stays light.
+ */
+import type { Command } from "commander";
+import { type GraphValidationReport } from "@nodetool-ai/node-sdk";
+type SecretLookup = (key: string) => Promise<string | null | undefined> | string | null | undefined;
+/** Resolve declared node settings exactly as BaseNode secret injection does. */
+export declare function collectAvailableSecrets(keys: readonly string[], getSecret: SecretLookup): Promise<Set<string>>;
+export declare function registerValidateCommand(program: Command): void;
+/**
+ * Human-readable report: headline, one line per issue, then a legend for the
+ * codes that occurred. Pure so it can be asserted on directly.
+ */
+export declare function renderValidation(report: GraphValidationReport): string[];
+export {};
+//# sourceMappingURL=validate.d.ts.map

package/dist/commands/validate.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"validate.d.ts","sourceRoot":"","sources":["../../src/commands/validate.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AACH,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AACzC,OAAO,EAGL,KAAK,qBAAqB,EAC3B,MAAM,uBAAuB,CAAC;AAQ/B,KAAK,YAAY,GAAG,CAClB,GAAG,EAAE,MAAM,KACR,OAAO,CAAC,MAAM,GAAG,IAAI,GAAG,SAAS,CAAC,GAAG,MAAM,GAAG,IAAI,GAAG,SAAS,CAAC;AAEpE,gFAAgF;AAChF,wBAAsB,uBAAuB,CAC3C,IAAI,EAAE,SAAS,MAAM,EAAE,EACvB,SAAS,EAAE,YAAY,GACtB,OAAO,CAAC,GAAG,CAAC,MAAM,CAAC,CAAC,CAOtB;AAED,wBAAgB,uBAAuB,CAAC,OAAO,EAAE,OAAO,GAAG,IAAI,CA0D9D;AAuCD;;;GAGG;AACH,wBAAgB,gBAAgB,CAAC,MAAM,EAAE,qBAAqB,GAAG,MAAM,EAAE,CAqBxE"}

package/dist/commands/validate.js

@@ -0,0 +1,127 @@
+import { validationHeadline } from "@nodetool-ai/node-sdk";
+import { printCommandError } from "../command-errors.js";
+/** Resolve declared node settings exactly as BaseNode secret injection does. */
+export async function collectAvailableSecrets(keys, getSecret) {
+    const found = new Set();
+    for (const key of keys) {
+        const value = await getSecret(key);
+        if (value)
+            found.add(key);
+    }
+    return found;
+}
+export function registerValidateCommand(program) {
+    program
+        .command("validate <workflow_id_or_file>")
+        .description("Validate a workflow against the node registry without running it (unknown nodes, missing props, bad edges)")
+        .option("--json", "Print the full validation report as JSON")
+        .option("--warnings-as-errors", "Exit non-zero when there are warnings (not just errors)")
+        .action(async (ref, opts) => {
+        try {
+            const { runValidate } = await import("../validate/index.js");
+            // Only a DB-id target needs the database; file/DSL targets validate
+            // with no DB at all, so initialize it lazily on first lookup.
+            let dbReady = false;
+            const ensureDb = async () => {
+                if (!dbReady) {
+                    const { initDb } = await import("@nodetool-ai/models");
+                    const { getDefaultDbPath } = await import("@nodetool-ai/config");
+                    initDb(getDefaultDbPath());
+                    dbReady = true;
+                }
+            };
+            const { target, report } = await runValidate(ref, {
+                loadFromDb: async (id) => {
+                    await ensureDb();
+                    const { Workflow } = await import("@nodetool-ai/models");
+                    return Workflow.get(id);
+                },
+                // Node required settings use exact names. Provider aliases are
+                // resolved separately by the run preflight.
+                availableSecrets: async (keys) => {
+                    await ensureDb();
+                    const { getSecret } = await import("@nodetool-ai/models");
+                    return collectAvailableSecrets(keys, (key) => getSecret(key, "1"));
+                }
+            });
+            if (opts.json) {
+                console.log(JSON.stringify({ target, report }, null, 2));
+            }
+            else {
+                console.log(renderValidation(report).join("\n"));
+            }
+            const failed = !report.ok ||
+                (opts.warningsAsErrors === true && report.counts.warnings > 0);
+            process.exit(failed ? 1 : 0);
+        }
+        catch (e) {
+            printCommandError(e, opts.json);
+            process.exit(1);
+        }
+    });
+}
+/**
+ * One line per issue code, printed as a legend under the issues so the report
+ * explains itself without a trip to the docs.
+ */
+const CODE_LEGEND = {
+    invalid_graph: "the graph's nodes or edges is not an array",
+    unknown_node: "node type is not in the registry",
+    duplicate_id: "two nodes share an id",
+    property: "property is missing, empty, or the wrong shape",
+    dangling_edge: "edge references a node the graph does not contain",
+    unknown_handle: "edge references a handle the node does not have",
+    type_mismatch: "the two ends of an edge carry different types",
+    fan_in: "several edges target one input that takes a single value",
+    untyped_dynamic_slot: "edge targets a dynamic input with no declared type, so the connection is not type-checked — expected on workflows saved before typed slots, one per dynamic edge; informational, never a failure",
+    dynamic_type_mismatch: "inline value of a dynamic input does not match the type the slot declares",
+    unknown_provider: "a model property names a provider the runtime cannot build",
+    missing_secret: "a node declares a credential this install cannot resolve — the run may fail when the node executes",
+    slot_type_alias: "a dynamic slot is typed with a JSON-Schema/TypeScript name instead of NodeTool's, so the handle will not connect",
+    code_syntax: "a Code node's body is not valid JavaScript",
+    code_module: "a Code node's body uses `export`, a dynamic import, or an import the sandbox loader cannot serve",
+    code_undefined_name: "a Code node reads a name that is neither a sandbox API nor one of its inputs",
+    code_no_return: "a Code node can finish without returning its outputs",
+    code_return_shape: "a Code node returns something other than an output object",
+    code_missing_output: "a return path leaves a declared output unset",
+    code_undeclared_output: "a Code node returns a key it does not declare as an output handle",
+    code_unused_input: "a Code node input the body never reads"
+};
+/**
+ * Human-readable report: headline, one line per issue, then a legend for the
+ * codes that occurred. Pure so it can be asserted on directly.
+ */
+export function renderValidation(report) {
+    const mark = report.ok ? (report.counts.warnings ? "⚠️" : "✅") : "❌";
+    const lines = ["", `${mark} ${validationHeadline(report)}`];
+    if (report.issues.length === 0)
+        return lines;
+    lines.push("");
+    for (const issue of report.issues) {
+        lines.push(`  ${formatIssue(issue)}`);
+    }
+    const codes = [...new Set(report.issues.map((i) => i.code))]
+        .filter((code) => code in CODE_LEGEND)
+        .sort();
+    if (codes.length > 0) {
+        lines.push("", "  Codes:");
+        for (const code of codes) {
+            lines.push(`    ${code} — ${CODE_LEGEND[code]}`);
+        }
+    }
+    return lines;
+}
+function formatIssue(issue) {
+    const tag = issue.severity === "error"
+        ? "error"
+        : issue.severity === "info"
+            ? "info "
+            : "warn ";
+    const where = issue.nodeId != null
+        ? ` [${issue.nodeType ?? "node"} ${issue.nodeId}]`
+        : issue.edgeId != null
+            ? ` [edge ${issue.edgeId}]`
+            : "";
+    return `${tag} ${issue.message}${where} (${issue.code})`;
+}
+//# sourceMappingURL=validate.js.map

package/dist/commands/validate.js.map

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