@spectratools/graphic-designer-cli 0.14.1 → 0.14.2

package/dist/cli.js

@@ -5997,11 +5997,89 @@ async function runRenderPipeline(spec, options) {
     }
   };
 }
+var renderOptions = z3.object({
+  spec: z3.string().describe('Path to DesignSpec JSON file (or "-" to read JSON from stdin)'),
+  out: z3.string().optional().describe("Output file path (.png) or output directory"),
+  output: z3.string().optional().describe("Alias for --out. Output file path (.png) or output directory"),
+  specOut: z3.string().optional().describe("Optional explicit output path for normalized spec JSON"),
+  iteration: z3.number().int().positive().optional().describe("Optional iteration number for iterative workflows (1-indexed)"),
+  iterationNotes: z3.string().optional().describe("Optional notes for the current iteration metadata"),
+  maxIterations: z3.number().int().positive().optional().describe("Optional maximum planned iteration count"),
+  previousHash: z3.string().optional().describe("Optional artifact hash from the previous iteration"),
+  allowQaFail: z3.boolean().default(false).describe("Allow render success even if QA fails")
+});
+function resolveOut(options) {
+  const resolved = options.out ?? options.output;
+  if (!resolved) {
+    throw new Error("Either --out or --output is required.");
+  }
+  return resolved;
+}
 cli.command("render", {
   description: "Render a deterministic design artifact from a DesignSpec JSON file.",
+  options: renderOptions,
+  output: renderOutputSchema,
+  examples: [
+    {
+      options: {
+        spec: "./specs/pipeline.json",
+        out: "./output"
+      },
+      description: "Render a design spec and write .png/.meta/.spec artifacts"
+    }
+  ],
+  async run(c) {
+    let out;
+    try {
+      out = resolveOut(c.options);
+    } catch (error) {
+      const message = error instanceof Error ? error.message : String(error);
+      return c.error({
+        code: "MISSING_OUTPUT",
+        message,
+        retryable: false
+      });
+    }
+    const spec = parseDesignSpec(await readJson(c.options.spec));
+    let iteration;
+    try {
+      iteration = parseIterationMeta({
+        ...c.options.iteration != null ? { iteration: c.options.iteration } : {},
+        ...c.options.maxIterations != null ? { maxIterations: c.options.maxIterations } : {},
+        ...c.options.iterationNotes ? { iterationNotes: c.options.iterationNotes } : {},
+        ...c.options.previousHash ? { previousHash: c.options.previousHash } : {}
+      });
+    } catch (error) {
+      const message = error instanceof Error ? error.message : String(error);
+      return c.error({
+        code: "INVALID_ITERATION_OPTIONS",
+        message,
+        retryable: false
+      });
+    }
+    const runReport = await runRenderPipeline(spec, {
+      out,
+      ...c.options.specOut ? { specOut: c.options.specOut } : {},
+      ...iteration ? { iteration } : {}
+    });
+    if (!runReport.qa.pass && !c.options.allowQaFail) {
+      return c.error({
+        code: "QA_FAILED",
+        message: `Render completed but QA failed (${runReport.qa.issueCount} issues). Review qa output.`,
+        retryable: false
+      });
+    }
+    return c.ok(runReport);
+  }
+});
+cli.command("draw", {
+  description: "Alias for render. Render a deterministic design artifact from a DesignSpec JSON.",
+  args: z3.object({
+    spec: z3.string().describe('Path to DesignSpec JSON file (or "-" to read JSON from stdin)')
+  }),
   options: z3.object({
-    spec: z3.string().describe('Path to DesignSpec JSON file (or "-" to read JSON from stdin)'),
-    out: z3.string().describe("Output file path (.png) or output directory"),
+    out: z3.string().optional().describe("Output file path (.png) or output directory"),
+    output: z3.string().optional().describe("Alias for --out. Output file path (.png) or output directory"),
     specOut: z3.string().optional().describe("Optional explicit output path for normalized spec JSON"),
     iteration: z3.number().int().positive().optional().describe("Optional iteration number for iterative workflows (1-indexed)"),
     iterationNotes: z3.string().optional().describe("Optional notes for the current iteration metadata"),
@@ -6012,15 +6090,24 @@ cli.command("render", {
   output: renderOutputSchema,
   examples: [
     {
-      options: {
-        spec: "./specs/pipeline.json",
-        out: "./output"
-      },
-      description: "Render a design spec and write .png/.meta/.spec artifacts"
+      args: { spec: "/tmp/spec.json" },
+      options: { output: "/tmp/out" },
+      description: "Render a spec using the draw alias with --output"
     }
   ],
   async run(c) {
-    const spec = parseDesignSpec(await readJson(c.options.spec));
+    let out;
+    try {
+      out = resolveOut(c.options);
+    } catch (error) {
+      const message = error instanceof Error ? error.message : String(error);
+      return c.error({
+        code: "MISSING_OUTPUT",
+        message,
+        retryable: false
+      });
+    }
+    const spec = parseDesignSpec(await readJson(c.args.spec));
     let iteration;
     try {
       iteration = parseIterationMeta({
@@ -6038,7 +6125,7 @@ cli.command("render", {
       });
     }
     const runReport = await runRenderPipeline(spec, {
-      out: c.options.out,
+      out,
       ...c.options.specOut ? { specOut: c.options.specOut } : {},
       ...iteration ? { iteration } : {}
     });

package/dist/index.js

@@ -6065,11 +6065,89 @@ async function runRenderPipeline(spec, options) {
     }
   };
 }
+var renderOptions = z3.object({
+  spec: z3.string().describe('Path to DesignSpec JSON file (or "-" to read JSON from stdin)'),
+  out: z3.string().optional().describe("Output file path (.png) or output directory"),
+  output: z3.string().optional().describe("Alias for --out. Output file path (.png) or output directory"),
+  specOut: z3.string().optional().describe("Optional explicit output path for normalized spec JSON"),
+  iteration: z3.number().int().positive().optional().describe("Optional iteration number for iterative workflows (1-indexed)"),
+  iterationNotes: z3.string().optional().describe("Optional notes for the current iteration metadata"),
+  maxIterations: z3.number().int().positive().optional().describe("Optional maximum planned iteration count"),
+  previousHash: z3.string().optional().describe("Optional artifact hash from the previous iteration"),
+  allowQaFail: z3.boolean().default(false).describe("Allow render success even if QA fails")
+});
+function resolveOut(options) {
+  const resolved = options.out ?? options.output;
+  if (!resolved) {
+    throw new Error("Either --out or --output is required.");
+  }
+  return resolved;
+}
 cli.command("render", {
   description: "Render a deterministic design artifact from a DesignSpec JSON file.",
+  options: renderOptions,
+  output: renderOutputSchema,
+  examples: [
+    {
+      options: {
+        spec: "./specs/pipeline.json",
+        out: "./output"
+      },
+      description: "Render a design spec and write .png/.meta/.spec artifacts"
+    }
+  ],
+  async run(c) {
+    let out;
+    try {
+      out = resolveOut(c.options);
+    } catch (error) {
+      const message = error instanceof Error ? error.message : String(error);
+      return c.error({
+        code: "MISSING_OUTPUT",
+        message,
+        retryable: false
+      });
+    }
+    const spec = parseDesignSpec(await readJson(c.options.spec));
+    let iteration;
+    try {
+      iteration = parseIterationMeta({
+        ...c.options.iteration != null ? { iteration: c.options.iteration } : {},
+        ...c.options.maxIterations != null ? { maxIterations: c.options.maxIterations } : {},
+        ...c.options.iterationNotes ? { iterationNotes: c.options.iterationNotes } : {},
+        ...c.options.previousHash ? { previousHash: c.options.previousHash } : {}
+      });
+    } catch (error) {
+      const message = error instanceof Error ? error.message : String(error);
+      return c.error({
+        code: "INVALID_ITERATION_OPTIONS",
+        message,
+        retryable: false
+      });
+    }
+    const runReport = await runRenderPipeline(spec, {
+      out,
+      ...c.options.specOut ? { specOut: c.options.specOut } : {},
+      ...iteration ? { iteration } : {}
+    });
+    if (!runReport.qa.pass && !c.options.allowQaFail) {
+      return c.error({
+        code: "QA_FAILED",
+        message: `Render completed but QA failed (${runReport.qa.issueCount} issues). Review qa output.`,
+        retryable: false
+      });
+    }
+    return c.ok(runReport);
+  }
+});
+cli.command("draw", {
+  description: "Alias for render. Render a deterministic design artifact from a DesignSpec JSON.",
+  args: z3.object({
+    spec: z3.string().describe('Path to DesignSpec JSON file (or "-" to read JSON from stdin)')
+  }),
   options: z3.object({
-    spec: z3.string().describe('Path to DesignSpec JSON file (or "-" to read JSON from stdin)'),
-    out: z3.string().describe("Output file path (.png) or output directory"),
+    out: z3.string().optional().describe("Output file path (.png) or output directory"),
+    output: z3.string().optional().describe("Alias for --out. Output file path (.png) or output directory"),
     specOut: z3.string().optional().describe("Optional explicit output path for normalized spec JSON"),
     iteration: z3.number().int().positive().optional().describe("Optional iteration number for iterative workflows (1-indexed)"),
     iterationNotes: z3.string().optional().describe("Optional notes for the current iteration metadata"),
@@ -6080,15 +6158,24 @@ cli.command("render", {
   output: renderOutputSchema,
   examples: [
     {
-      options: {
-        spec: "./specs/pipeline.json",
-        out: "./output"
-      },
-      description: "Render a design spec and write .png/.meta/.spec artifacts"
+      args: { spec: "/tmp/spec.json" },
+      options: { output: "/tmp/out" },
+      description: "Render a spec using the draw alias with --output"
     }
   ],
   async run(c) {
-    const spec = parseDesignSpec(await readJson(c.options.spec));
+    let out;
+    try {
+      out = resolveOut(c.options);
+    } catch (error) {
+      const message = error instanceof Error ? error.message : String(error);
+      return c.error({
+        code: "MISSING_OUTPUT",
+        message,
+        retryable: false
+      });
+    }
+    const spec = parseDesignSpec(await readJson(c.args.spec));
     let iteration;
     try {
       iteration = parseIterationMeta({
@@ -6106,7 +6193,7 @@ cli.command("render", {
       });
     }
     const runReport = await runRenderPipeline(spec, {
-      out: c.options.out,
+      out,
       ...c.options.specOut ? { specOut: c.options.specOut } : {},
       ...iteration ? { iteration } : {}
     });

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@spectratools/graphic-designer-cli",
-  "version": "0.14.1",
+  "version": "0.14.2",
   "description": "Deterministic visual content generator — code screenshots, terminal shots, flowcharts, and infographics. No browser dependency.",
   "type": "module",
   "license": "MIT",