fix(cli): expose render debug mode

Adds the render --debug CLI flag, forwards it through Docker/local render paths, and captures full producer debug artifacts from pipeline start.
This commit is contained in:
Miguel Ángel
2026-06-23 13:04:48 -04:00
committed by GitHub
parent 4961e4e477
commit 7133c396eb
5 changed files with 57 additions and 8 deletions
@@ -171,6 +171,7 @@ describe("buildDockerRunArgs", () => {
videoBitrate: undefined,
videoFrameFormat: "png",
quiet: true,
debug: true,
entryFile: "compositions/intro.html",
},
});
@@ -188,6 +189,7 @@ describe("buildDockerRunArgs", () => {
expect(args).toContain("--video-frame-format");
expect(args).toContain("png");
expect(args).toContain("--quiet");
expect(args).toContain("--debug");
expect(args).toContain("--gpu");
expect(args).toContain("--no-browser-gpu");
expect(args).toContain("--hdr");
@@ -352,6 +354,18 @@ describe("buildDockerRunArgs", () => {
expect(args).toContain("--no-page-side-compositing");
});
it("keeps Docker debug artifacts under the mounted output directory", () => {
const args = buildDockerRunArgs({
...FIXED_INPUT,
options: { ...BASE, debug: true },
});
const envIdx = args.indexOf("PRODUCER_RENDERS_DIR=/output/renders");
const imageIdx = args.indexOf(FIXED_INPUT.imageTag);
expect(envIdx).toBeGreaterThan(-1);
expect(envIdx).toBeLessThan(imageIdx);
expect(args).toContain("--debug");
});
it("omits --no-page-side-compositing when pageSideCompositing is not explicitly false", () => {
const args = buildDockerRunArgs({ ...FIXED_INPUT, options: BASE });
expect(args).not.toContain("--no-page-side-compositing");