@xenonbyte/da-vinci-workflow 0.1.23 → 0.1.24

package/lib/cli.js

@@ -42,6 +42,10 @@ const {
   loadIconAliases,
   expandQueryWithAliases
 } = require("./icon-aliases");
+const {
+  runDesignSupervisorReview,
+  formatDesignSupervisorReviewReport
+} = require("./supervisor-review");
 
 function getOption(args, name) {
   const direct = args.find((arg) => arg.startsWith(`${name}=`));
@@ -105,6 +109,7 @@ function printHelp() {
       "  da-vinci audit [project-path]",
       "  da-vinci icon-sync [--output <path>] [--timeout-ms <value>] [--strict]",
       "  da-vinci icon-search --query <text> [--family <value>] [--top <value>] [--catalog <path>] [--aliases <path>] [--json]",
+      "  da-vinci supervisor-review --project <path> --change <id> [--run-reviewers] [--review-concurrency <value>] [--review-retries <value>] [--review-retry-delay-ms <value>] [--source <skill|manual|inferred>] [--executed-reviewers <csv>] [--status <PASS|WARN|BLOCK>] [--issue-list <text>] [--revision-outcome <text>] [--write] [--json]",
       "  da-vinci preflight-pencil --ops-file <path>",
       "  da-vinci ensure-pen --output <path>",
       "  da-vinci write-pen --output <path> --nodes-file <path> [--variables-file <path>]",
@@ -125,8 +130,21 @@ function printHelp() {
       "  --project <path>     override project path for audit",
       "  --catalog <path>     icon catalog path for icon-search/icon-sync (default: ~/.da-vinci/icon-catalog.json)",
       "  --aliases <path>     icon alias mapping file for icon-search (default: ~/.da-vinci/icon-aliases.json)",
+      "  --pencil-design <path> explicit pencil-design.md path for supervisor-review",
       "  --query <text>       icon-search query text",
       "  --family <value>     icon-search family filter: all, material, rounded, outlined, sharp, lucide, feather, phosphor",
+      "  --status <value>     PASS, WARN, or BLOCK for supervisor-review",
+      "  --source <value>     review source: skill, manual, inferred",
+      "  --executed-reviewers <csv> reviewer skills that executed this review",
+      "  --run-reviewers      execute configured reviewer skills through codex exec",
+      "  --review-concurrency <value> max parallel reviewer executions (default 2)",
+      "  --review-retries <value> retry count per reviewer before failing (default 1)",
+      "  --review-retry-delay-ms <value> initial retry delay in milliseconds (default 400, exponential backoff)",
+      "  --codex-bin <path>   codex executable path for --run-reviewers (default: codex)",
+      "  --max-images <value> max screenshots attached to reviewer runs (default 6)",
+      "  --review-timeout-ms <value> timeout per reviewer run in milliseconds",
+      "  --issue-list <text>  supervisor-review issue summary",
+      "  --revision-outcome <text> supervisor-review revision result summary",
       "  --top <value>        icon-search result count (1-50, default 8)",
       "  --timeout-ms <value> network timeout for icon-sync requests",
       "  --strict             fail icon-sync when any upstream source request fails",
@@ -162,6 +180,18 @@ async function runCli(argv) {
     "--top",
     "--catalog",
     "--aliases",
+    "--pencil-design",
+    "--status",
+    "--source",
+    "--executed-reviewers",
+    "--codex-bin",
+    "--max-images",
+    "--review-timeout-ms",
+    "--review-concurrency",
+    "--review-retries",
+    "--review-retry-delay-ms",
+    "--issue-list",
+    "--revision-outcome",
     "--timeout-ms",
     "--ops-file",
     "--input",
@@ -394,6 +424,73 @@ async function runCli(argv) {
     return;
   }
 
+  if (command === "supervisor-review") {
+    if (argv.includes("--help") || argv.includes("-h")) {
+      console.log(
+        [
+          "da-vinci supervisor-review",
+          "",
+          "Usage:",
+          "  da-vinci supervisor-review --project <path> --change <id> [--run-reviewers] [--review-concurrency <value>] [--review-retries <value>] [--review-retry-delay-ms <value>] [--source <skill|manual|inferred>] [--executed-reviewers <csv>] [--status <PASS|WARN|BLOCK>] [--issue-list <text>] [--revision-outcome <text>] [--write] [--json]",
+          "  da-vinci supervisor-review --project <path> --pencil-design <path> [--run-reviewers] [--review-concurrency <value>] [--review-retries <value>] [--review-retry-delay-ms <value>] [--source <skill|manual|inferred>] [--executed-reviewers <csv>] [--status <PASS|WARN|BLOCK>] [--issue-list <text>] [--revision-outcome <text>] [--write] [--json]",
+          "",
+          "Notes:",
+          "  - omit --status to infer a conservative review status from current design artifacts",
+          "  - use --run-reviewers to execute configured reviewer skills automatically via codex exec",
+          "  - `design-supervisor review` is a compatibility alias for this command"
+        ].join("\n")
+      );
+      return;
+    }
+
+    const projectPath = getOption(argv, "--project") || process.cwd();
+    const changeId = getOption(argv, "--change");
+    const pencilDesignPath = getOption(argv, "--pencil-design");
+    const status = getOption(argv, "--status");
+    const source = getOption(argv, "--source");
+    const executedReviewers = getOption(argv, "--executed-reviewers");
+    const codexBin = getOption(argv, "--codex-bin");
+    const maxImages = getOption(argv, "--max-images");
+    const reviewerTimeoutMs = getOption(argv, "--review-timeout-ms");
+    const reviewConcurrency = getOption(argv, "--review-concurrency");
+    const reviewerRetries = getOption(argv, "--review-retries");
+    const reviewerRetryDelayMs = getOption(argv, "--review-retry-delay-ms");
+    const issueList = getOption(argv, "--issue-list");
+    const revisionOutcome = getOption(argv, "--revision-outcome");
+    const write = argv.includes("--write");
+    const acceptWarn = argv.includes("--accept-warn");
+    const runReviewers = argv.includes("--run-reviewers");
+    const jsonOutput = argv.includes("--json");
+
+    const result = await runDesignSupervisorReview({
+      projectPath,
+      changeId,
+      pencilDesignPath,
+      status,
+      source,
+      executedReviewers,
+      codexBin,
+      maxImages,
+      reviewerTimeoutMs,
+      reviewConcurrency,
+      reviewerRetries,
+      reviewerRetryDelayMs,
+      issueList,
+      revisionOutcome,
+      write,
+      acceptWarn,
+      runReviewers
+    });
+
+    if (jsonOutput) {
+      console.log(JSON.stringify(result, null, 2));
+      return;
+    }
+
+    console.log(formatDesignSupervisorReviewReport(result));
+    return;
+  }
+
   if (command === "ensure-pen") {
     const outputPath = getOption(argv, "--output");
     const version = getOption(argv, "--version");