@nodetool-ai/cli-timeline 0.0.0-stage → 0.8.9-beta.2

package/dist/commands/timeline-score.js

@@ -0,0 +1,89 @@
+import { printCommandError } from "@nodetool-ai/pack-manager/command-errors";
+import { numericOptionParser } from "@nodetool-ai/cli-common/numeric-options";
+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", numericOptionParser("--min-score"))
+        .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 < opts.minScore;
+            process.exit(failed ? 1 : 0);
+        }
+        catch (e) {
+            process.exit(printCommandError(e, opts.json));
+        }
+    });
+}
+/** 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 "@nodetool-ai/cli-common/commands/validation-output";
+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,oDAAoD,CAAC;AAErG,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 "@nodetool-ai/cli-common/commands/version-commands";
+export { parseVersionDocument, parseVersionNumber } from "@nodetool-ai/cli-common/commands/version-commands";
+/** 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,mDAAmD,CAAC;AAE3D,OAAO,EAAE,oBAAoB,EAAE,kBAAkB,EAAE,MAAM,mDAAmD,CAAC;AAE7G,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 "@nodetool-ai/cli-common/commands/version-commands";
+export { parseVersionDocument, parseVersionNumber } from "@nodetool-ai/cli-common/commands/version-commands";
+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,CA8F/D"}

package/dist/commands/timeline.js

@@ -0,0 +1,103 @@
+import { printCommandError } from "@nodetool-ai/pack-manager/command-errors";
+import { printDebugSummary } from "@nodetool-ai/cli-common/commands/debug-summary-output";
+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) {
+            process.exit(printCommandError(e, opts.json));
+        }
+    });
+    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) {
+            process.exit(printCommandError(e, opts.json));
+        }
+    });
+    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/index.d.ts

@@ -0,0 +1,19 @@
+/** Run the independently installed cli-timeline command group. */
+export declare function run(argv?: readonly string[]): Promise<void>;
+export declare const descriptor: {
+    readonly id: "cli-timeline";
+    readonly apiVersion: 1;
+    readonly requires: readonly [];
+    readonly capabilities: readonly ["cli:timeline"];
+};
+export declare const feature: {
+    descriptor: {
+        readonly id: "cli-timeline";
+        readonly apiVersion: 1;
+        readonly requires: readonly [];
+        readonly capabilities: readonly ["cli:timeline"];
+    };
+    run: typeof run;
+};
+export default feature;
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAIA,kEAAkE;AAClE,wBAAsB,GAAG,CAAC,IAAI,GAAE,SAAS,MAAM,EAA0B,GAAG,OAAO,CAAC,IAAI,CAAC,CAKxF;AAED,eAAO,MAAM,UAAU;aAAK,EAAE,EAAE,cAAc;aAAE,UAAU,EAAE,CAAC;aAAE,QAAQ;aAAM,YAAY,YAAG,cAAc;CAAY,CAAC;AACvH,eAAO,MAAM,OAAO;;qBADY,cAAc;6BAAc,CAAC;;yCAA+B,cAAc;;;CAChE,CAAC;eAC5B,OAAO"}

package/dist/index.js

@@ -0,0 +1,14 @@
+import { Command } from "commander";
+import { initializeCliRuntime } from "@nodetool-ai/cli-common/runtime-env";
+import { registerTimelineCommands } from "./commands/timeline.js";
+/** Run the independently installed cli-timeline command group. */
+export async function run(argv = process.argv.slice(2)) {
+    initializeCliRuntime(import.meta.url);
+    const program = new Command("nodetool");
+    registerTimelineCommands(program);
+    await program.parseAsync([...argv], { from: "user" });
+}
+export const descriptor = { id: "cli-timeline", apiVersion: 1, requires: [], capabilities: ["cli:timeline"] };
+export const feature = { descriptor, run };
+export default feature;
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AACpC,OAAO,EAAE,oBAAoB,EAAE,MAAM,qCAAqC,CAAC;AAC3E,OAAO,EAAE,wBAAwB,EAAE,MAAM,wBAAwB,CAAC;AAElE,kEAAkE;AAClE,MAAM,CAAC,KAAK,UAAU,GAAG,CAAC,IAAI,GAAsB,OAAO,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC;IACvE,oBAAoB,CAAC,OAAO,IAAI,CAAC,GAAG,CAAC,CAAC;IACtC,MAAM,OAAO,GAAG,IAAI,OAAO,CAAC,UAAU,CAAC,CAAC;IACxC,wBAAwB,CAAC,OAAO,CAAC,CAAC;IAClC,MAAM,OAAO,CAAC,UAAU,CAAC,CAAC,GAAG,IAAI,CAAC,EAAE,EAAE,IAAI,EAAE,MAAM,EAAE,CAAC,CAAC;AACxD,CAAC;AAED,MAAM,CAAC,MAAM,UAAU,GAAG,EAAE,EAAE,EAAE,cAAc,EAAE,UAAU,EAAE,CAAC,EAAE,QAAQ,EAAE,EAAE,EAAE,YAAY,EAAE,CAAC,cAAc,CAAC,EAAW,CAAC;AACvH,MAAM,CAAC,MAAM,OAAO,GAAG,EAAE,UAAU,EAAE,GAAG,EAAE,CAAC;AAC3C,eAAe,OAAO,CAAC"}

package/dist/nodetool.d.ts

@@ -0,0 +1,3 @@
+#!/usr/bin/env node
+export {};
+//# sourceMappingURL=nodetool.d.ts.map

package/dist/nodetool.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"nodetool.d.ts","sourceRoot":"","sources":["../src/nodetool.ts"],"names":[],"mappings":""}

package/dist/nodetool.js

@@ -0,0 +1,4 @@
+#!/usr/bin/env node
+import { run } from "./index.js";
+void run().catch((error) => { process.stderr.write(`${error instanceof Error ? error.message : String(error)}\n`); process.exitCode = 1; });
+//# sourceMappingURL=nodetool.js.map

package/dist/nodetool.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"nodetool.js","sourceRoot":"","sources":["../src/nodetool.ts"],"names":[],"mappings":";AACA,OAAO,EAAE,GAAG,EAAE,MAAM,YAAY,CAAC;AACjC,KAAK,GAAG,EAAE,CAAC,KAAK,CAAC,CAAC,KAAc,EAAE,EAAE,GAAG,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,GAAG,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC,CAAC,OAAO,CAAC,QAAQ,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC"}

package/dist/timeline-debug/harness.d.ts

@@ -0,0 +1,93 @@
+/**
+ * The timeline debug harness: the CLI host around the shared validator.
+ *
+ * `runTimelineValidate` is the cheap pre-flight — load a document, check it,
+ * report. `runTimelineDebug` additionally replays a scripted edit session
+ * against the headless `ui_timeline_*` bridge (the one the tool-loop eval
+ * drives), validates the document the session left behind, and writes a
+ * self-contained bundle.
+ *
+ * Everything that could pull in a heavy package is injected with a lazy
+ * default: the validator core (`@nodetool-ai/execution/timeline-debug`) and the
+ * bridge factory (`@nodetool-ai/agents`). Tests supply their own and load
+ * neither.
+ */
+import type { TimelineDocument } from "@nodetool-ai/protocol/api-schemas/timeline.js";
+import type { TimelineDebugReport, TimelineInteractionRecord, TimelineValidation } from "@nodetool-ai/execution/timeline-debug";
+import type { TimelineInteractionStep } from "./interactions.js";
+import { type ResolvedTimelineTarget, type TimelineSequenceSettings, type TimelineTargetDeps } from "./target.js";
+/** The pieces of the shared core this host calls. */
+export interface TimelineDebugCore {
+    validateTimelineSequence: (raw: unknown, meta?: TimelineSequenceSettings) => TimelineValidation | Promise<TimelineValidation>;
+    buildTimelineDebugReport: (input: {
+        target: TimelineDebugReport["target"];
+        document: unknown;
+        meta?: TimelineSequenceSettings;
+        interactions?: TimelineInteractionRecord[];
+        finalState?: unknown;
+        finalDocument?: unknown;
+    }) => TimelineDebugReport | Promise<TimelineDebugReport>;
+    renderTimelineReportMarkdown: (report: TimelineDebugReport) => string;
+}
+/** The bridge surface this host drives — one tool per `ui_timeline_*` name. */
+export interface TimelineBridgeTool {
+    name: string;
+    /**
+     * HOLDOUT (anti-slop/no-unknown-returns): a `ui_timeline_*` tool answers in
+     * the open tool-result domain, and the bridge that implements this lives in
+     * `@nodetool-ai/agents`.
+     */
+    execute: (args: Record<string, unknown>) => Promise<unknown>;
+}
+/** The bridge's snapshot, including the full document the session ended with. */
+export interface TimelineBridgeSnapshot {
+    documentTracks?: TimelineDocument["tracks"];
+    documentClips?: TimelineDocument["clips"];
+    markers?: TimelineDocument["markers"];
+    /** The tempo the session ended on — `set_tempo`, or the first midi track. */
+    tempo?: TimelineDocument["tempo"];
+    camera2d?: TimelineDocument["camera2d"];
+}
+export interface TimelineBridge {
+    tools: TimelineBridgeTool[];
+    finalState: () => TimelineBridgeSnapshot;
+}
+export type CreateTimelineBridge = (initial: {
+    sequence: TimelineSequenceSettings & {
+        tracks: TimelineDocument["tracks"];
+        clips: TimelineDocument["clips"];
+        markers?: TimelineDocument["markers"];
+        tempo?: TimelineDocument["tempo"];
+        camera2d?: TimelineDocument["camera2d"];
+    };
+}) => TimelineBridge;
+export interface TimelineDebugDeps extends TimelineTargetDeps {
+    /** Defaults to `@nodetool-ai/execution/timeline-debug`. */
+    core?: TimelineDebugCore;
+    /** Defaults to `createTimelineToolBridge` from `@nodetool-ai/agents`. */
+    createBridge?: CreateTimelineBridge;
+    onLog?: (line: string) => void;
+}
+export interface TimelineDebugOptions {
+    interact?: TimelineInteractionStep[];
+    outDir?: string;
+}
+export interface TimelineValidateResult {
+    target: ResolvedTimelineTarget["target"];
+    validation: TimelineValidation;
+}
+export interface TimelineDebugResult {
+    report: TimelineDebugReport;
+    bundleDir: string;
+}
+/** Load a timeline and validate it — no bridge, no bundle. */
+export declare function runTimelineValidate(ref: string, deps: TimelineDebugDeps): Promise<TimelineValidateResult>;
+/**
+ * Replay `--interact` against the headless bridge and write the bundle.
+ *
+ * A failing step is recorded and the script continues: a run that stops at the
+ * first error hides every problem behind it, and the report is what the caller
+ * came for.
+ */
+export declare function runTimelineDebug(ref: string, options: TimelineDebugOptions, deps: TimelineDebugDeps): Promise<TimelineDebugResult>;
+//# sourceMappingURL=harness.d.ts.map

package/dist/timeline-debug/harness.d.ts.map

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