agent-roast 0.3.0 → 0.4.0

package/README.md

@@ -35,6 +35,12 @@ npx agent-roast --fail-under 70 # exit code 1 if score is below 70
 # Audit pull request diffs (CI gate)
 npx agent-roast --base origin/main --head HEAD
 npx agent-roast --base origin/main --head HEAD --fail-on test-skip,trivial-assert,stub-abandonment --format github
+npx agent-roast --base origin/main --format markdown # rich markdown for PR comments
+
+# Generate AI discipline badge for your README
+npx agent-roast badge          # prints Shields.io Markdown snippet
+npx agent-roast badge --out ./badge.svg # exports standalone SVG badge
+npx agent-roast badge --json   # Shields.io dynamic endpoint payload
 ```
 
 What a report looks like (a real repository audit, trimmed):
@@ -77,7 +83,7 @@ Configure custom ignore paths, rule severities, and CI thresholds with a `.agent
 
 ```json
 {
-  "$schema": "https://raw.githubusercontent.com/sidzuya/agent-roast/main/schema.json",
+  "$schema": "https://raw.githubusercontent.com/Nari-Ab/agent-roast/main/schema.json",
   "ignorePaths": [
     "**/*.min.js",
     "**/vendor/**",

package/dist/{chunk-SMZZAGFS.js → chunk-O4SB2FCT.js}

@@ -1397,6 +1397,49 @@ function formatGithubStepSummary(result) {
   }
   return lines.join("\n");
 }
+function formatPrMarkdownComment(result) {
+  const lines = [];
+  const titleEmoji = result.passed ? "\u2705" : "\u274C";
+  const titleStatus = result.passed ? "PASSED" : "BLOCKED";
+  lines.push(`## \u{1F6E1}\uFE0F agent-roast audit: ${titleStatus} ${titleEmoji}`);
+  lines.push("");
+  if (!result.hasSupportedChanges) {
+    lines.push("No supported source file changes detected in this pull request.");
+    lines.push("");
+    lines.push("---");
+    lines.push("*Audited 100% offline with [agent-roast](https://github.com/Nari-Ab/agent-roast)*");
+    return lines.join("\n");
+  }
+  const statusText = result.passed ? "\u2705 Passed" : `\u274C Blocked on ${result.failedRules.join(", ")}`;
+  lines.push("| Status | Defect Density | Files Inspected | Lines Added | Infractions |");
+  lines.push("| :--- | :--- | :--- | :--- | :--- |");
+  lines.push(
+    `| ${statusText} | ${result.defectDensityPer100Lines} / 100 LOC | ${result.filesInspected} | +${result.linesAdded} | ${result.infractions.length} |`
+  );
+  lines.push("");
+  if (result.infractions.length > 0) {
+    lines.push("<details>");
+    lines.push(`<summary><b>View Detected Infractions (${result.infractions.length})</b></summary>`);
+    lines.push("");
+    lines.push("| Type | File:Line | Description | Snippet |");
+    lines.push("| :--- | :--- | :--- | :--- |");
+    const sorted = sortInfractionsDeterministic(result.infractions);
+    for (const inf of sorted) {
+      const loc = inf.file ? `\`${inf.file}:${inf.lineNumber || 1}\`` : "*history*";
+      const snippet = inf.lineSnippet ? `\`${inf.lineSnippet.replace(/\|/g, "\\|")}\`` : "-";
+      lines.push(`| \`${inf.type}\` | ${loc} | ${inf.reason} | ${snippet} |`);
+    }
+    lines.push("");
+    lines.push("</details>");
+    lines.push("");
+  } else {
+    lines.push("\u2728 **Clean pull request**: Zero AI shortcuts, bypassed tests, or compiler type escapes detected.");
+    lines.push("");
+  }
+  lines.push("---");
+  lines.push("*Audited 100% offline with [agent-roast](https://github.com/Nari-Ab/agent-roast)*");
+  return lines.join("\n");
+}
 
 // src/types.ts
 var VALID_DETECTORS = [
@@ -1412,7 +1455,7 @@ var VALID_DETECTORS = [
 import * as fs2 from "fs";
 import * as path2 from "path";
 var DEFAULT_CONFIG_TEMPLATE = {
-  $schema: "https://raw.githubusercontent.com/sidzuya/agent-roast/main/schema.json",
+  $schema: "https://raw.githubusercontent.com/Nari-Ab/agent-roast/main/schema.json",
   ignorePaths: [
     "**/*.min.js",
     "**/vendor/**",
@@ -1512,6 +1555,64 @@ async function initProject(options = {}) {
   return { created, skipped };
 }
 
+// src/badge.ts
+function getScoreColor(score) {
+  if (score === null || isNaN(score)) {
+    return { name: "lightgrey", hex: "#9f9f9f" };
+  }
+  if (score >= 90) return { name: "brightgreen", hex: "#4c1" };
+  if (score >= 80) return { name: "green", hex: "#97ca00" };
+  if (score >= 70) return { name: "yellowgreen", hex: "#a4a61d" };
+  if (score >= 60) return { name: "yellow", hex: "#dfb317" };
+  return { name: "red", hex: "#e05d44" };
+}
+function generateSvgBadge(score, label = "AI Discipline") {
+  const value = score !== null && !isNaN(score) ? `${score}/100` : "N/A";
+  const color = getScoreColor(score);
+  const labelWidth = Math.round(label.length * 6.8 + 14);
+  const valueWidth = Math.round(value.length * 7.2 + 14);
+  const totalWidth = labelWidth + valueWidth;
+  const labelX = Math.round(labelWidth / 2);
+  const valueX = Math.round(labelWidth + valueWidth / 2);
+  return `<svg xmlns="http://www.w3.org/2000/svg" width="${totalWidth}" height="20" role="img" aria-label="${label}: ${value}">
+  <linearGradient id="s" x2="0" y2="100%">
+    <stop offset="0" stop-color="#bbb" stop-opacity=".1"/>
+    <stop offset="1" stop-opacity=".1"/>
+  </linearGradient>
+  <clipPath id="r">
+    <rect width="${totalWidth}" height="20" rx="3" fill="#fff"/>
+  </clipPath>
+  <g clip-path="url(#r)">
+    <rect width="${labelWidth}" height="20" fill="#555"/>
+    <rect x="${labelWidth}" width="${valueWidth}" height="20" fill="${color.hex}"/>
+    <rect width="${totalWidth}" height="20" fill="url(#s)"/>
+  </g>
+  <g fill="#fff" text-anchor="middle" font-family="Verdana,Geneva,DejaVu Sans,sans-serif" text-rendering="geometricPrecision" font-size="110">
+    <text aria-hidden="true" x="${labelX * 10}" y="150" fill="#010101" fill-opacity=".3" transform="scale(.1)" textLength="${(labelWidth - 14) * 10}">${label}</text>
+    <text x="${labelX * 10}" y="140" transform="scale(.1)" fill="#fff" textLength="${(labelWidth - 14) * 10}">${label}</text>
+    <text aria-hidden="true" x="${valueX * 10}" y="150" fill="#010101" fill-opacity=".3" transform="scale(.1)" textLength="${(valueWidth - 14) * 10}">${value}</text>
+    <text x="${valueX * 10}" y="140" transform="scale(.1)" fill="#fff" textLength="${(valueWidth - 14) * 10}">${value}</text>
+  </g>
+</svg>`;
+}
+function generateShieldsMarkdown(score, label = "AI Discipline", repoUrl = "https://github.com/Nari-Ab/agent-roast") {
+  const value = score !== null && !isNaN(score) ? `${score}%2F100` : "N%2FA";
+  const color = getScoreColor(score);
+  const encodedLabel = encodeURIComponent(label);
+  const badgeUrl = `https://img.shields.io/badge/${encodedLabel}-${value}-${color.name}?style=flat-square`;
+  return `[![${label}](${badgeUrl})](${repoUrl})`;
+}
+function generateShieldsJson(score, label = "AI Discipline") {
+  const value = score !== null && !isNaN(score) ? `${score}/100` : "N/A";
+  const color = getScoreColor(score);
+  return {
+    schemaVersion: 1,
+    label,
+    message: value,
+    color: color.name
+  };
+}
+
 // src/index.ts
 var InvalidDetectorError = class extends Error {
   constructor(message) {
@@ -1589,6 +1690,8 @@ async function auditPullRequest(options) {
     result.output = JSON.stringify(result, null, 2);
   } else if (format === "github") {
     result.output = formatGithubAnnotations(result);
+  } else if (format === "markdown") {
+    result.output = formatPrMarkdownComment(result);
   } else {
     result.output = formatPrTerminalCard(result);
   }
@@ -1623,11 +1726,16 @@ export {
   formatPrTerminalCard,
   formatGithubAnnotations,
   formatGithubStepSummary,
+  formatPrMarkdownComment,
   VALID_DETECTORS,
   DEFAULT_CONFIG_TEMPLATE,
   GITHUB_WORKFLOW_TEMPLATE,
   PRE_COMMIT_HOOK_TEMPLATE,
   initProject,
+  getScoreColor,
+  generateSvgBadge,
+  generateShieldsMarkdown,
+  generateShieldsJson,
   InvalidDetectorError,
   roastRepository,
   auditPullRequest

package/dist/cli.js

@@ -5,19 +5,23 @@ import {
   InvalidDetectorError,
   auditPullRequest,
   formatGithubStepSummary,
+  generateShieldsJson,
+  generateShieldsMarkdown,
+  generateSvgBadge,
   initProject,
   loadConfig,
   roastRepository
-} from "./chunk-SMZZAGFS.js";
+} from "./chunk-O4SB2FCT.js";
 
 // src/cli.ts
 import { Command } from "commander";
 import { createRequire } from "module";
 import * as fs from "fs";
+import * as path from "path";
 var require2 = createRequire(import.meta.url);
 var pkg = require2("../package.json");
 var program = new Command();
-program.name("agent-roast").description("Audit your git history or PR diffs for AI coding shortcuts and panic loops").version(pkg.version || "0.3.0").argument("[path]", "Path to git repository (default: current directory)", ".").option("-a, --all", "Audit ALL commits regardless of AI attribution tags", false).option("-s, --since <time>", "Time window for git analysis", "90 days ago").option("-v, --verbose", "Show commit SHAs and line snippets for all infractions", false).option("--json", "Output results as raw JSON", false).option("--base <ref>", "Base git ref/branch for PR mode audit (e.g. origin/main)").option("--head <ref>", "Head git ref/SHA for PR mode audit (default: HEAD)", "HEAD").option("--fail-on <rules>", "Comma-separated detectors that trigger CI failure").option("--fail-under <score>", "Fail CI if agent score is below threshold (0-100)").option("--format <format>", "Output format: terminal, json, github", "terminal").option("--authors", "Display author names and emails in report", false).action(async (repoPath, options) => {
+program.name("agent-roast").description("Audit your git history or PR diffs for AI coding shortcuts and panic loops").version(pkg.version || "0.4.0").argument("[path]", "Path to git repository (default: current directory)", ".").option("-a, --all", "Audit ALL commits regardless of AI attribution tags", false).option("-s, --since <time>", "Time window for git analysis", "90 days ago").option("-v, --verbose", "Show commit SHAs and line snippets for all infractions", false).option("--json", "Output results as raw JSON", false).option("--base <ref>", "Base git ref/branch for PR mode audit (e.g. origin/main)").option("--head <ref>", "Head git ref/SHA for PR mode audit (default: HEAD)", "HEAD").option("--fail-on <rules>", "Comma-separated detectors that trigger CI failure").option("--fail-under <score>", "Fail CI if agent score is below threshold (0-100)").option("--format <format>", "Output format: terminal, json, github, markdown", "terminal").option("--authors", "Display author names and emails in report", false).action(async (repoPath, options) => {
   try {
     if (process.env.GITHUB_EVENT_NAME === "pull_request_target") {
       console.warn(
@@ -127,4 +131,46 @@ program.command("init").description("Initialize .agentroastrc.json and CI/hook c
     process.exitCode = 1;
   }
 });
+program.command("badge").description("Generate an AI discipline badge (SVG, Markdown, or Shields JSON)").argument("[path]", "Path to git repository (default: current directory)", ".").option("-a, --all", "Audit ALL commits regardless of AI attribution tags", false).option("-s, --since <time>", "Time window for git analysis", "90 days ago").option("--label <text>", "Badge label text", "AI Discipline").option("--out <file>", "Output SVG file path (e.g. ./badge.svg)").action(async (repoPath, opts) => {
+  try {
+    const rootOpts = program.opts();
+    const isJson = Boolean(opts.json || rootOpts.json);
+    const isAll = Boolean(opts.all || rootOpts.all);
+    const since = opts.since || rootOpts.since || "90 days ago";
+    const config = await loadConfig(repoPath);
+    const result = await roastRepository({
+      cwd: repoPath,
+      since,
+      all: isAll,
+      ignorePaths: config.ignorePaths
+    });
+    const score = result.summary.score;
+    const label = opts.label || "AI Discipline";
+    if (isJson) {
+      const payload = generateShieldsJson(score, label);
+      console.log(JSON.stringify(payload, null, 2));
+      process.exitCode = 0;
+      return;
+    }
+    if (opts.out) {
+      const svg = generateSvgBadge(score, label);
+      const outPath = path.resolve(opts.out);
+      fs.mkdirSync(path.dirname(outPath), { recursive: true });
+      fs.writeFileSync(outPath, svg, "utf-8");
+      console.log(`Generated SVG badge at: ${opts.out}`);
+      process.exitCode = 0;
+      return;
+    }
+    const markdown = generateShieldsMarkdown(score, label);
+    console.log(`
+Badge for README.md:
+
+${markdown}
+`);
+    process.exitCode = 0;
+  } catch (err) {
+    console.error(`Error generating badge: ${err.message}`);
+    process.exitCode = 1;
+  }
+});
 program.parse(process.argv);

package/dist/index.d.ts

@@ -55,7 +55,7 @@ interface PrAuditOptions {
     base: string;
     head: string;
     failOn?: string[];
-    format?: "terminal" | "json" | "github";
+    format?: "terminal" | "json" | "github" | "markdown";
     verbose?: boolean;
     authors?: boolean;
     ignorePaths?: string[];
@@ -206,6 +206,10 @@ declare function formatGithubAnnotations(result: PrAuditResult): string;
  * Generates GitHub Step Summary Markdown
  */
 declare function formatGithubStepSummary(result: PrAuditResult): string;
+/**
+ * Generates rich GitHub PR Comment Markdown (for PR comments / sticky bots)
+ */
+declare function formatPrMarkdownComment(result: PrAuditResult): string;
 
 interface AgentRoastConfig {
     /** Detector rules to fail CI on in PR mode */
@@ -256,6 +260,20 @@ declare const GITHUB_WORKFLOW_TEMPLATE = "name: Agent Roast\non:\n  pull_request
 declare const PRE_COMMIT_HOOK_TEMPLATE = "#!/bin/sh\n# Run agent-roast pre-commit verification\nnpx agent-roast --fail-under 70\n";
 declare function initProject(options?: InitOptions): Promise<InitResult>;
 
+interface ShieldsEndpointResponse {
+    schemaVersion: 1;
+    label: string;
+    message: string;
+    color: string;
+}
+declare function getScoreColor(score: number | null): {
+    name: string;
+    hex: string;
+};
+declare function generateSvgBadge(score: number | null, label?: string): string;
+declare function generateShieldsMarkdown(score: number | null, label?: string, repoUrl?: string): string;
+declare function generateShieldsJson(score: number | null, label?: string): ShieldsEndpointResponse;
+
 declare class InvalidDetectorError extends Error {
     constructor(message: string);
 }
@@ -265,4 +283,4 @@ declare function roastRepository(options?: RoastOptions): Promise<{
 }>;
 declare function auditPullRequest(options: PrAuditOptions): Promise<PrAuditResult>;
 
-export { type AgentRoastConfig, type AiAttributionResult, type CommitInfo, DEFAULT_CONFIG, DEFAULT_CONFIG_TEMPLATE, type DetectorType, FIELD_SEPARATOR, GITHUB_WORKFLOW_TEMPLATE, GitError, GitResolutionError, HERMETIC_GIT_FLAGS, type Infraction, type InitOptions, type InitResult, InvalidDetectorError, type MetricSummary, MetricsCollector, PRE_COMMIT_HOOK_TEMPLATE, type ParseDiffResult, type ParsedCommit, type ParsedDiffLine, type ParsedFileDiff, type PrAuditOptions, type PrAuditResult, RECORD_SEPARATOR, type RoastOptions, VALID_DETECTORS, auditFileDiffs, auditPullRequest, detectAiAttribution, findMergeBase, formatGithubAnnotations, formatGithubStepSummary, formatPrTerminalCard, formatTerminalCard, generateShareUrl, getHermeticGitEnv, initProject, isCodeFile, isTestFile, loadConfig, matchIgnorePath, parseDiff, parseGitLogStream, resolveCommitSha, roastRepository, streamGitDiff, streamGitLog, stripStringAndRegexLiterals, unquoteGitPath };
+export { type AgentRoastConfig, type AiAttributionResult, type CommitInfo, DEFAULT_CONFIG, DEFAULT_CONFIG_TEMPLATE, type DetectorType, FIELD_SEPARATOR, GITHUB_WORKFLOW_TEMPLATE, GitError, GitResolutionError, HERMETIC_GIT_FLAGS, type Infraction, type InitOptions, type InitResult, InvalidDetectorError, type MetricSummary, MetricsCollector, PRE_COMMIT_HOOK_TEMPLATE, type ParseDiffResult, type ParsedCommit, type ParsedDiffLine, type ParsedFileDiff, type PrAuditOptions, type PrAuditResult, RECORD_SEPARATOR, type RoastOptions, type ShieldsEndpointResponse, VALID_DETECTORS, auditFileDiffs, auditPullRequest, detectAiAttribution, findMergeBase, formatGithubAnnotations, formatGithubStepSummary, formatPrMarkdownComment, formatPrTerminalCard, formatTerminalCard, generateShareUrl, generateShieldsJson, generateShieldsMarkdown, generateSvgBadge, getHermeticGitEnv, getScoreColor, initProject, isCodeFile, isTestFile, loadConfig, matchIgnorePath, parseDiff, parseGitLogStream, resolveCommitSha, roastRepository, streamGitDiff, streamGitLog, stripStringAndRegexLiterals, unquoteGitPath };

package/dist/index.js

@@ -18,10 +18,15 @@ import {
   findMergeBase,
   formatGithubAnnotations,
   formatGithubStepSummary,
+  formatPrMarkdownComment,
   formatPrTerminalCard,
   formatTerminalCard,
   generateShareUrl,
+  generateShieldsJson,
+  generateShieldsMarkdown,
+  generateSvgBadge,
   getHermeticGitEnv,
+  getScoreColor,
   initProject,
   isCodeFile,
   isTestFile,
@@ -35,7 +40,7 @@ import {
   streamGitLog,
   stripStringAndRegexLiterals,
   unquoteGitPath
-} from "./chunk-SMZZAGFS.js";
+} from "./chunk-O4SB2FCT.js";
 export {
   DEFAULT_CONFIG,
   DEFAULT_CONFIG_TEMPLATE,
@@ -55,10 +60,15 @@ export {
   findMergeBase,
   formatGithubAnnotations,
   formatGithubStepSummary,
+  formatPrMarkdownComment,
   formatPrTerminalCard,
   formatTerminalCard,
   generateShareUrl,
+  generateShieldsJson,
+  generateShieldsMarkdown,
+  generateSvgBadge,
   getHermeticGitEnv,
+  getScoreColor,
   initProject,
   isCodeFile,
   isTestFile,

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "agent-roast",
-  "version": "0.3.0",
+  "version": "0.4.0",
   "description": "Zero-telemetry CLI scorecard analyzing git history for AI coding agent infractions and panic loops",
   "type": "module",
   "main": "./dist/index.js",