@agent-scope/cli 1.15.0 → 1.16.0

package/dist/index.cjs

@@ -1130,9 +1130,9 @@ function createRL() {
   });
 }
 async function ask(rl, question) {
-  return new Promise((resolve15) => {
+  return new Promise((resolve16) => {
     rl.question(question, (answer) => {
-      resolve15(answer.trim());
+      resolve16(answer.trim());
     });
   });
 }
@@ -2412,8 +2412,8 @@ Available: ${available}`
         wastedRenders: opts.wastedRenders
       });
       await shutdownPool2();
-      const fmt = resolveFormat2(opts.format);
-      if (fmt === "json") {
+      const fmt2 = resolveFormat2(opts.format);
+      if (fmt2 === "json") {
         process.stdout.write(`${JSON.stringify(instrumentRoot, null, 2)}
 `);
       } else {
@@ -3132,12 +3132,12 @@ Available: ${available}`
           );
           return;
         }
-        const fmt = resolveSingleFormat(opts.format);
-        if (fmt === "json") {
+        const fmt2 = resolveSingleFormat(opts.format);
+        if (fmt2 === "json") {
           const json = formatRenderJson(componentName, props, result);
           process.stdout.write(`${JSON.stringify(json, null, 2)}
 `);
-        } else if (fmt === "file") {
+        } else if (fmt2 === "file") {
           const dir = path.resolve(process.cwd(), DEFAULT_OUTPUT_DIR);
           fs.mkdirSync(dir, { recursive: true });
           const outPath = path.resolve(dir, `${componentName}.png`);
@@ -3258,8 +3258,8 @@ Available: ${available}`
           process.stderr.write(`Sprite sheet saved to ${spritePath}
 `);
         }
-        const fmt = resolveMatrixFormat(opts.format, opts.sprite !== void 0);
-        if (fmt === "file") {
+        const fmt2 = resolveMatrixFormat(opts.format, opts.sprite !== void 0);
+        if (fmt2 === "file") {
           const { SpriteSheetGenerator: SpriteSheetGenerator2 } = await import('@agent-scope/render');
           const gen = new SpriteSheetGenerator2();
           const sheet = await gen.generate(result);
@@ -3272,10 +3272,10 @@ Available: ${available}`
             `\u2713 ${componentName} matrix (${result.stats.totalCells} cells) \u2192 ${relPath} (${result.stats.wallClockTimeMs.toFixed(0)}ms total)
 `
           );
-        } else if (fmt === "json") {
+        } else if (fmt2 === "json") {
           process.stdout.write(`${JSON.stringify(formatMatrixJson(result), null, 2)}
 `);
-        } else if (fmt === "png") {
+        } else if (fmt2 === "png") {
           if (opts.sprite !== void 0) {
           } else {
             const { SpriteSheetGenerator: SpriteSheetGenerator2 } = await import('@agent-scope/render');
@@ -3283,9 +3283,9 @@ Available: ${available}`
             const sheet = await gen.generate(result);
             process.stdout.write(sheet.png);
           }
-        } else if (fmt === "html") {
+        } else if (fmt2 === "html") {
           process.stdout.write(formatMatrixHtml(componentName, result));
-        } else if (fmt === "csv") {
+        } else if (fmt2 === "csv") {
           process.stdout.write(formatMatrixCsv(componentName, result));
         }
       } catch (err) {
@@ -3586,12 +3586,12 @@ async function runBaseline(options = {}) {
   fs.mkdirSync(rendersDir, { recursive: true });
   let manifest$1;
   if (manifestPath !== void 0) {
-    const { readFileSync: readFileSync11 } = await import('fs');
+    const { readFileSync: readFileSync12 } = await import('fs');
     const absPath = path.resolve(rootDir, manifestPath);
     if (!fs.existsSync(absPath)) {
       throw new Error(`Manifest not found at ${absPath}.`);
     }
-    manifest$1 = JSON.parse(readFileSync11(absPath, "utf-8"));
+    manifest$1 = JSON.parse(readFileSync12(absPath, "utf-8"));
     process.stderr.write(`Loaded manifest from ${manifestPath}
 `);
   } else {
@@ -4225,6 +4225,135 @@ function registerDiffSubCommand(reportCmd) {
     }
   );
 }
+var STATUS_BADGE = {
+  added: "\u2705 added",
+  removed: "\u{1F5D1}\uFE0F removed",
+  unchanged: "\u2014 unchanged",
+  compliance_regressed: "\u274C regressed",
+  compliance_improved: "\u{1F4C8} improved",
+  size_changed: "\u{1F4D0} resized"
+};
+function fmt(n) {
+  return `${(n * 100).toFixed(1)}%`;
+}
+function fmtDelta(delta) {
+  if (delta === null) return "\u2014";
+  const sign = delta >= 0 ? "+" : "";
+  return `${sign}${(delta * 100).toFixed(1)}%`;
+}
+function fmtDimensions(d) {
+  if (d === null) return "\u2014";
+  return `${d.width} \xD7 ${d.height}`;
+}
+function complianceDeltaArrow(diff) {
+  const delta = diff.currentAggregateCompliance - diff.baselineAggregateCompliance;
+  if (Math.abs(delta) < 5e-4) return `\u2192 ${fmt(diff.currentAggregateCompliance)} (no change)`;
+  const arrow = delta > 0 ? "\u2191" : "\u2193";
+  return `${arrow} ${fmtDelta(delta)}`;
+}
+function formatPrComment(diff) {
+  const { summary, components } = diff;
+  const lines = [];
+  const hasRegressions = diff.hasRegressions;
+  const headerEmoji = hasRegressions ? "\u26A0\uFE0F" : "\u2705";
+  lines.push(`## ${headerEmoji} Scope Report`);
+  lines.push("");
+  lines.push("| Metric | Value |");
+  lines.push("|---|---|");
+  lines.push(`| Baseline compliance | ${fmt(diff.baselineAggregateCompliance)} |`);
+  lines.push(`| Current compliance | ${fmt(diff.currentAggregateCompliance)} |`);
+  lines.push(`| Delta | ${complianceDeltaArrow(diff)} |`);
+  lines.push(
+    `| Components | ${summary.total} total \xB7 ${summary.added} added \xB7 ${summary.removed} removed \xB7 ${summary.complianceRegressed} regressed |`
+  );
+  if (summary.renderFailed > 0) {
+    lines.push(`| Render failures | ${summary.renderFailed} |`);
+  }
+  lines.push("");
+  const changed = components.filter((c) => c.status !== "unchanged");
+  const unchanged = components.filter((c) => c.status === "unchanged");
+  if (changed.length > 0) {
+    lines.push("### Changes");
+    lines.push("");
+    lines.push("| Component | Status | Compliance \u0394 | Dimensions |");
+    lines.push("|---|---|---|---|");
+    for (const c of changed) {
+      const badge = STATUS_BADGE[c.status];
+      const delta = fmtDelta(c.complianceDelta);
+      const dims = fmtDimensions(c.currentDimensions ?? c.baselineDimensions);
+      lines.push(`| \`${c.name}\` | ${badge} | ${delta} | ${dims} |`);
+    }
+    lines.push("");
+  }
+  if (unchanged.length > 0) {
+    lines.push(
+      `<details><summary>${unchanged.length} unchanged component${unchanged.length === 1 ? "" : "s"}</summary>`
+    );
+    lines.push("");
+    lines.push("| Component | Compliance |");
+    lines.push("|---|---|");
+    for (const c of unchanged) {
+      lines.push(
+        `| \`${c.name}\` | ${c.currentCompliance !== null ? fmt(c.currentCompliance) : "\u2014"} |`
+      );
+    }
+    lines.push("");
+    lines.push("</details>");
+    lines.push("");
+  }
+  lines.push(
+    `> Generated by [Scope](https://github.com/FlatFilers/Scope) \xB7 diffed at ${diff.diffedAt}`
+  );
+  return lines.join("\n");
+}
+function loadDiffResult(filePath) {
+  const abs = path.resolve(filePath);
+  if (!fs.existsSync(abs)) {
+    throw new Error(`DiffResult file not found: ${abs}`);
+  }
+  let raw;
+  try {
+    raw = fs.readFileSync(abs, "utf-8");
+  } catch (err) {
+    throw new Error(
+      `Failed to read DiffResult file: ${err instanceof Error ? err.message : String(err)}`
+    );
+  }
+  let parsed;
+  try {
+    parsed = JSON.parse(raw);
+  } catch {
+    throw new Error(`DiffResult file is not valid JSON: ${abs}`);
+  }
+  if (typeof parsed !== "object" || parsed === null || !("diffedAt" in parsed) || !("components" in parsed) || !("summary" in parsed)) {
+    throw new Error(
+      `DiffResult file does not match expected shape (missing diffedAt/components/summary): ${abs}`
+    );
+  }
+  return parsed;
+}
+function registerPrCommentSubCommand(reportCmd) {
+  reportCmd.command("pr-comment").description(
+    "Format a DiffResult JSON file as a GitHub PR comment (Markdown, written to stdout)"
+  ).requiredOption("-i, --input <path>", "Path to DiffResult JSON (from scope report diff --json)").option("-o, --output <path>", "Write comment to file instead of stdout").action(async (opts) => {
+    try {
+      const diff = loadDiffResult(opts.input);
+      const comment = formatPrComment(diff);
+      if (opts.output !== void 0) {
+        fs.writeFileSync(path.resolve(opts.output), comment, "utf-8");
+        process.stderr.write(`PR comment written to ${opts.output}
+`);
+      } else {
+        process.stdout.write(`${comment}
+`);
+      }
+    } catch (err) {
+      process.stderr.write(`Error: ${err instanceof Error ? err.message : String(err)}
+`);
+      process.exit(1);
+    }
+  });
+}
 
 // src/tree-formatter.ts
 var BRANCH2 = "\u251C\u2500\u2500 ";
@@ -5520,6 +5649,7 @@ function createProgram(options = {}) {
   if (existingReportCmd !== void 0) {
     registerBaselineSubCommand(existingReportCmd);
     registerDiffSubCommand(existingReportCmd);
+    registerPrCommentSubCommand(existingReportCmd);
   }
   return program;
 }