@aiready/core 0.23.23 → 0.24.0

package/dist/index.mjs

@@ -52,13 +52,13 @@ import {
   getToolWeight,
   normalizeToolName,
   parseWeightString
-} from "./chunk-E55RNGGK.mjs";
+} from "./chunk-2ILVUVRK.mjs";
 import {
   TypeScriptParser
 } from "./chunk-UTCRW3N7.mjs";
 import {
   PythonParser
-} from "./chunk-LZHO636W.mjs";
+} from "./chunk-SM6INS52.mjs";
 import {
   JavaParser
 } from "./chunk-SWZOT67M.mjs";
@@ -391,14 +391,14 @@ async function scanFiles(options) {
       ignoreFromFile = [];
     }
   }
-  const TEST_PATTERNS = [
+  const TEST_PATTERNS2 = [
     "**/*.test.*",
     "**/*.spec.*",
     "**/__tests__/**",
     "**/test/**",
     "**/tests/**"
   ];
-  const baseExclude = options.includeTests ? DEFAULT_EXCLUDE.filter((p) => !TEST_PATTERNS.includes(p)) : DEFAULT_EXCLUDE;
+  const baseExclude = options.includeTests ? DEFAULT_EXCLUDE.filter((p) => !TEST_PATTERNS2.includes(p)) : DEFAULT_EXCLUDE;
   const finalExclude = [
     .../* @__PURE__ */ new Set([...exclude || [], ...ignoreFromFile, ...baseExclude])
   ];
@@ -460,14 +460,14 @@ async function scanEntries(options) {
       ignoreFromFile = [];
     }
   }
-  const TEST_PATTERNS = [
+  const TEST_PATTERNS2 = [
     "**/*.test.*",
     "**/*.spec.*",
     "**/__tests__/**",
     "**/test/**",
     "**/tests/**"
   ];
-  const baseExclude = includeTests ? DEFAULT_EXCLUDE.filter((p) => !TEST_PATTERNS.includes(p)) : DEFAULT_EXCLUDE;
+  const baseExclude = includeTests ? DEFAULT_EXCLUDE.filter((p) => !TEST_PATTERNS2.includes(p)) : DEFAULT_EXCLUDE;
   const finalExclude = [
     .../* @__PURE__ */ new Set([...exclude || [], ...ignoreFromFile, ...baseExclude])
   ];
@@ -522,7 +522,7 @@ function isSourceFile(filePath) {
   return ["ts", "tsx", "js", "jsx", "py", "java", "go", "rs"].includes(ext);
 }
 
-// src/utils/cli-helpers.ts
+// src/utils/fs-utils.ts
 import {
   writeFileSync,
   mkdirSync,
@@ -531,23 +531,12 @@ import {
   statSync
 } from "fs";
 import { join as join2, dirname as dirname2, resolve as resolvePath } from "path";
-import chalk from "chalk";
 function ensureDir(path) {
   const dir = dirname2(path);
   if (!existsSync2(dir)) {
     mkdirSync(dir, { recursive: true });
   }
 }
-function normalizeSeverity(s) {
-  if (!s) return null;
-  const lower = s.toLowerCase();
-  if (["critical", "high-risk", "blind-risk"].includes(lower))
-    return "critical" /* Critical */;
-  if (["major", "moderate-risk"].includes(lower)) return "major" /* Major */;
-  if (["minor", "safe"].includes(lower)) return "minor" /* Minor */;
-  if (lower === "info") return "info" /* Info */;
-  return null;
-}
 function getFilesByPattern(dir, pattern) {
   if (!existsSync2(dir)) return [];
   try {
@@ -574,16 +563,6 @@ function resolveOutputPath(userPath, defaultFilename, workingDir = process.cwd()
   ensureDir(outputPath);
   return outputPath;
 }
-async function loadMergedConfig(directory, defaults, cliOptions) {
-  const config = await loadConfig(directory);
-  const mergedConfig = mergeConfigWithDefaults(config, defaults);
-  const result = {
-    ...mergedConfig,
-    ...cliOptions,
-    rootDir: directory
-  };
-  return result;
-}
 function handleJSONOutput(data, outputFile, successMessage) {
   if (outputFile) {
     ensureDir(outputFile);
@@ -593,63 +572,54 @@ function handleJSONOutput(data, outputFile, successMessage) {
     console.log(JSON.stringify(data, null, 2));
   }
 }
-function getTerminalDivider(color = chalk.cyan, maxWidth = 60) {
-  const terminalWidth = process.stdout.columns || 80;
-  const dividerWidth = Math.min(maxWidth, terminalWidth - 2);
-  return color("\u2501".repeat(dividerWidth));
-}
-function printTerminalHeader(title, color = chalk.cyan) {
-  const divider = getTerminalDivider(color);
-  console.log(divider);
-  console.log(chalk.bold.white(`  ${title.toUpperCase()}`));
-  console.log(divider + "\n");
-}
-function handleCLIError(error, commandName) {
-  console.error(`\u274C ${commandName} failed:`, error);
-  process.exit(1);
-}
-function getElapsedTime(startTime) {
-  return ((Date.now() - startTime) / 1e3).toFixed(2);
-}
-function getScoreBar(val) {
-  const clamped = Math.max(0, Math.min(100, val));
-  return "\u2588".repeat(Math.round(clamped / 10)).padEnd(10, "\u2591");
-}
-function getSafetyIcon(rating) {
-  switch (rating) {
-    case "safe":
-      return "\u2705";
-    case "moderate-risk":
-      return "\u26A0\uFE0F ";
-    case "high-risk":
-      return "\u{1F534}";
-    case "blind-risk":
-      return "\u{1F480}";
-    default:
-      return "\u2753";
+function findLatestReport(dirPath) {
+  const aireadyDir = resolvePath(dirPath, ".aiready");
+  let files = getFilesByPattern(aireadyDir, /^aiready-report-.*\.json$/);
+  if (files.length === 0) {
+    files = getFilesByPattern(aireadyDir, /^aiready-scan-.*\.json$/);
   }
-}
-function emitProgress(processed, total, toolId, message, onProgress, throttleCount = 50) {
-  if (!onProgress) return;
-  if (processed % throttleCount === 0 || processed === total) {
-    onProgress(processed, total, `${message} (${processed}/${total})`);
+  if (files.length === 0) {
+    return null;
   }
+  const sortedFiles = files.map((f) => ({
+    name: f,
+    path: resolvePath(aireadyDir, f),
+    mtime: statSync(resolvePath(aireadyDir, f)).mtime
+  })).sort((a, b) => b.mtime.getTime() - a.mtime.getTime());
+  return sortedFiles[0].path;
 }
-function getSeverityColor(severity, chalkInstance = chalk) {
-  const normalized = normalizeSeverity(severity);
-  switch (normalized) {
-    case "critical" /* Critical */:
-      return chalkInstance.red;
-    case "major" /* Major */:
-      return chalkInstance.yellow;
-    case "minor" /* Minor */:
-      return chalkInstance.green;
-    case "info" /* Info */:
-      return chalkInstance.blue;
-    default:
-      return chalkInstance.white;
+function findLatestScanReport(scanReportsDir, reportFilePrefix) {
+  try {
+    const prefixRegex = new RegExp(`^${reportFilePrefix}\\d+\\.json$`);
+    const reportFiles = getFilesByPattern(scanReportsDir, prefixRegex);
+    if (reportFiles.length === 0) return null;
+    reportFiles.sort((a, b) => {
+      const idA = parseInt(a.match(/\d+/)?.[0] || "0", 10);
+      const idB = parseInt(b.match(/\d+/)?.[0] || "0", 10);
+      return idB - idA;
+    });
+    return join2(scanReportsDir, reportFiles[0]);
+  } catch {
+    console.error("Error while finding latest scan report");
+    return null;
   }
 }
+
+// src/utils/terminal-utils.ts
+import chalk2 from "chalk";
+
+// src/utils/severity-utils.ts
+import chalk from "chalk";
+function normalizeSeverity(s) {
+  if (!s) return null;
+  const lower = s.toLowerCase();
+  if (["critical", "high-risk", "blind-risk"].includes(lower))
+    return "critical" /* Critical */;
+  if (["major", "moderate-risk"].includes(lower)) return "major" /* Major */;
+  if (["minor", "safe"].includes(lower)) return "minor" /* Minor */;
+  if (lower === "info") return "info" /* Info */;
+  return null;
+}
 function getSeverityValue(s) {
   const normalized = normalizeSeverity(s);
   switch (normalized) {
@@ -668,23 +638,6 @@ function getSeverityValue(s) {
 function getSeverityLevel(s) {
   return getSeverityValue(s);
 }
-function getSeverityBadge(severity, chalkInstance = chalk) {
-  const val = getSeverityValue(
-    typeof severity === "string" ? severity : severity
-  );
-  switch (val) {
-    case 4:
-      return chalkInstance.bgRed.white.bold(" CRITICAL ");
-    case 3:
-      return chalkInstance.bgYellow.black.bold(" MAJOR ");
-    case 2:
-      return chalkInstance.bgBlue.white.bold(" MINOR ");
-    case 1:
-      return chalkInstance.bgCyan.black(" INFO ");
-    default:
-      return chalkInstance.bgCyan.black(" INFO ");
-  }
-}
 function getSeverityEnum(s) {
   const level = getSeverityLevel(s);
   switch (level) {
@@ -698,39 +651,125 @@ function getSeverityEnum(s) {
       return "info";
   }
 }
-function findLatestReport(dirPath) {
-  const aireadyDir = resolvePath(dirPath, ".aiready");
-  let files = getFilesByPattern(aireadyDir, /^aiready-report-.*\.json$/);
-  if (files.length === 0) {
-    files = getFilesByPattern(aireadyDir, /^aiready-scan-.*\.json$/);
+function getSeverityColor(severity, chalkInstance = chalk) {
+  const normalized = normalizeSeverity(severity);
+  switch (normalized) {
+    case "critical" /* Critical */:
+      return chalkInstance.red;
+    case "major" /* Major */:
+      return chalkInstance.yellow;
+    case "minor" /* Minor */:
+      return chalkInstance.green;
+    case "info" /* Info */:
+      return chalkInstance.blue;
+    default:
+      return chalkInstance.white;
   }
-  if (files.length === 0) {
-    return null;
+}
+function getSeverityBadge(severity, chalkInstance = chalk) {
+  const normalized = normalizeSeverity(severity);
+  switch (normalized) {
+    case "critical" /* Critical */:
+      return chalkInstance.bgRed.white.bold(" CRITICAL ");
+    case "major" /* Major */:
+      return chalkInstance.bgYellow.black.bold(" MAJOR ");
+    case "minor" /* Minor */:
+      return chalkInstance.bgGreen.black.bold(" MINOR ");
+    case "info" /* Info */:
+      return chalkInstance.bgBlue.white.bold(" INFO ");
+    default:
+      return chalkInstance.bgCyan.black(" UNKNOWN ");
   }
-  const sortedFiles = files.map((f) => ({
-    name: f,
-    path: resolvePath(aireadyDir, f),
-    mtime: statSync(resolvePath(aireadyDir, f)).mtime
-  })).sort((a, b) => b.mtime.getTime() - a.mtime.getTime());
-  return sortedFiles[0].path;
 }
-function findLatestScanReport(scanReportsDir, reportFilePrefix) {
-  try {
-    const prefixRegex = new RegExp(`^${reportFilePrefix}\\d+\\.json$`);
-    const reportFiles = getFilesByPattern(scanReportsDir, prefixRegex);
-    if (reportFiles.length === 0) return null;
-    reportFiles.sort((a, b) => {
-      const idA = parseInt(a.match(/\d+/)?.[0] || "0", 10);
-      const idB = parseInt(b.match(/\d+/)?.[0] || "0", 10);
-      return idB - idA;
-    });
-    return join2(scanReportsDir, reportFiles[0]);
-  } catch {
-    console.error("Error while finding latest scan report");
-    return null;
+function getSeverityLabel(severity) {
+  const labels = {
+    ["critical" /* Critical */]: "\u{1F534} CRITICAL",
+    ["major" /* Major */]: "\u{1F7E1} MAJOR",
+    ["minor" /* Minor */]: "\u{1F535} MINOR",
+    ["info" /* Info */]: "\u2139\uFE0F  INFO"
+  };
+  return labels[severity];
+}
+function filterBySeverity(items, minSeverity) {
+  const severityOrder = [
+    "info" /* Info */,
+    "minor" /* Minor */,
+    "major" /* Major */,
+    "critical" /* Critical */
+  ];
+  const minIndex = severityOrder.indexOf(minSeverity);
+  if (minIndex === -1) return items;
+  return items.filter((item) => {
+    const itemIndex = severityOrder.indexOf(item.severity);
+    return itemIndex >= minIndex;
+  });
+}
+
+// src/utils/terminal-utils.ts
+function getSafetyIcon(rating) {
+  switch (rating) {
+    case "safe":
+      return "\u2705";
+    case "moderate-risk":
+      return "\u26A0\uFE0F ";
+    case "high-risk":
+      return "\u{1F534}";
+    case "blind-risk":
+      return "\u{1F480}";
+    default:
+      return "\u2753";
   }
 }
 
+// src/utils/terminal-ui.ts
+import chalk3 from "chalk";
+function printTerminalHeader(title, colorFn = chalk3.cyan.bold, width = 80) {
+  const divider = "\u2501".repeat(width);
+  console.log(colorFn(`
+${divider}`));
+  console.log(colorFn(`  ${title.toUpperCase()}`));
+  console.log(colorFn(`${divider}
+`));
+}
+function getTerminalDivider(colorFn = chalk3.gray, width = 80) {
+  return colorFn("\u2501".repeat(width));
+}
+function getScoreBar(score, width = 10) {
+  const normalized = Math.max(0, Math.min(100, score));
+  const solid = Math.round(normalized / 100 * width);
+  const empty = width - solid;
+  return "\u2588".repeat(solid) + "\u2591".repeat(empty);
+}
+
+// src/utils/progress-utils.ts
+function emitProgress(processed, total, toolId, message, onProgress, throttleCount = 50) {
+  if (!onProgress) return;
+  if (processed % throttleCount === 0 || processed === total) {
+    onProgress(processed, total, `${message} (${processed}/${total})`);
+  }
+}
+
+// src/utils/cli-utils.ts
+function getElapsedTime(startTime) {
+  return ((Date.now() - startTime) / 1e3).toFixed(2);
+}
+function handleCLIError(error, commandName) {
+  console.error(`\u274C ${commandName} failed:`, error);
+  process.exit(1);
+}
+
+// src/utils/cli-helpers.ts
+async function loadMergedConfig(directory, defaults, cliOptions) {
+  const config = await loadConfig(directory);
+  const mergedConfig = mergeConfigWithDefaults(config, defaults);
+  const result = {
+    ...mergedConfig,
+    ...cliOptions,
+    rootDir: directory
+  };
+  return result;
+}
+
 // src/utils/cli-action-helpers.ts
 import { resolve as resolvePath2 } from "path";
 function getReportTimestamp() {
@@ -873,7 +912,7 @@ var ParserFactory = class _ParserFactory {
       return new TypeScriptParser2();
     });
     this.registerLazyParser("python" /* Python */, async () => {
-      const { PythonParser: PythonParser2 } = await import("./python-parser-FNFK2473.mjs");
+      const { PythonParser: PythonParser2 } = await import("./python-parser-SJ3LFZFJ.mjs");
       return new PythonParser2();
     });
     this.registerLazyParser("java" /* Java */, async () => {
@@ -1318,6 +1357,9 @@ function mergeConfigWithDefaults(userConfig, defaults) {
     if (userConfig.scan.include) mergedConfig.include = userConfig.scan.include;
     if (userConfig.scan.exclude) mergedConfig.exclude = userConfig.scan.exclude;
   }
+  if (userConfig.threshold !== void 0)
+    mergedConfig.threshold = userConfig.threshold;
+  if (userConfig.failOn !== void 0) mergedConfig.failOn = userConfig.failOn;
   if (userConfig.tools) {
     if (!mergedConfig.toolConfigs) mergedConfig.toolConfigs = {};
     for (const [toolName, toolConfig] of Object.entries(userConfig.tools)) {
@@ -1335,114 +1377,148 @@ function mergeConfigWithDefaults(userConfig, defaults) {
   return mergedConfig;
 }
 
+// src/utils/report-styles.ts
+var REPORT_STYLES = `
+  body { font-family: -apple-system, BlinkMacSystemFont, 'Segoe UI', Roboto, Oxygen, Ubuntu, Cantarell, 'Open Sans', 'Helvetica Neue', sans-serif; line-height: 1.6; color: #333; max-width: 1200px; margin: 0 auto; padding: 2rem; background-color: #f9f9f9; }
+  h1, h2, h3 { color: #1a1a1a; border-bottom: 2px solid #eaeaea; padding-bottom: 0.5rem; }
+  .card { background: white; padding: 1.5rem; border-radius: 8px; box-shadow: 0 2px 4px rgba(0,0,0,0.05); margin-bottom: 2rem; border: 1px solid #eaeaea; }
+  .stats { display: grid; grid-template-columns: repeat(auto-fit, minmax(200px, 1fr)); gap: 1rem; margin-bottom: 2rem; }
+  .stat-card { background: #fff; padding: 1rem; border-radius: 6px; text-align: center; border: 1px solid #eaeaea; }
+  .stat-value { font-size: 1.8rem; font-weight: bold; color: #2563eb; }
+  .stat-label { font-size: 0.875rem; color: #666; text-transform: uppercase; }
+  .hero { background: linear-gradient(135deg, #667eea 0%, #764ba2 100%); color: white; padding: 30px; border-radius: 8px; margin-bottom: 30px; }
+  .hero h1 { border: none; color: white; margin: 0; }
+  .hero p { margin: 10px 0 0 0; opacity: 0.9; }
+  table { width: 100%; border-collapse: collapse; margin-top: 1rem; background: white; border-radius: 4px; overflow: hidden; }
+  th, td { text-align: left; padding: 0.875rem 1rem; border-bottom: 1px solid #eaeaea; }
+  th { background-color: #f8fafc; font-weight: 600; color: #475569; }
+  tr:last-child td { border-bottom: none; }
+  .critical { color: #dc2626; font-weight: bold; }
+  .major { color: #ea580c; font-weight: bold; }
+  .minor { color: #2563eb; }
+  .issue-critical { color: #dc2626; font-weight: bold; text-transform: uppercase; }
+  .issue-major { color: #ea580c; font-weight: bold; text-transform: uppercase; }
+  .issue-minor { color: #2563eb; font-weight: bold; text-transform: uppercase; }
+  code { background: #f1f5f9; padding: 0.2rem 0.4rem; border-radius: 4px; font-size: 0.875rem; color: #334155; }
+  .footer { margin-top: 4rem; text-align: center; color: #94a3b8; font-size: 0.875rem; }
+  a { color: #2563eb; text-decoration: none; }
+  a:hover { text-decoration: underline; }
+`;
+
 // src/utils/report-formatters.ts
-function generateReportHead(title) {
+function tag(name, content = "", attrs = {}) {
+  const attrStr = Object.entries(attrs).map(([k, v]) => ` ${k}="${v}"`).join("");
+  return `<${name}${attrStr}>${content}</${name}>`;
+}
+function generateReportHead(title, styles = REPORT_STYLES) {
   return `<!DOCTYPE html>
 <html lang="en">
 <head>
   <meta charset="UTF-8">
   <meta name="viewport" content="width=device-width, initial-scale=1.0">
-  <title>${title}</title>
-  <style>
-    body { font-family: -apple-system, BlinkMacSystemFont, 'Segoe UI', Roboto, Oxygen, Ubuntu, Cantarell, 'Open Sans', 'Helvetica Neue', sans-serif; line-height: 1.6; color: #333; max-width: 1200px; margin: 0 auto; padding: 2rem; background-color: #f9f9f9; }
-    h1, h2, h3 { color: #1a1a1a; border-bottom: 2px solid #eaeaea; padding-bottom: 0.5rem; }
-    .card { background: white; padding: 1.5rem; border-radius: 8px; box-shadow: 0 2px 4px rgba(0,0,0,0.05); margin-bottom: 2rem; border: 1px solid #eaeaea; }
-    .stats { display: grid; grid-template-columns: repeat(auto-fit, minmax(200px, 1fr)); gap: 1rem; margin-bottom: 2rem; }
-    .stat-card { background: #fff; padding: 1rem; border-radius: 6px; text-align: center; border: 1px solid #eaeaea; }
-    .stat-value { font-size: 1.8rem; font-weight: bold; color: #2563eb; }
-    .stat-label { font-size: 0.875rem; color: #666; text-transform: uppercase; }
-    .hero { background: linear-gradient(135deg, #667eea 0%, #764ba2 100%); color: white; padding: 30px; border-radius: 8px; margin-bottom: 30px; }
-    .hero h1 { border: none; color: white; margin: 0; }
-    .hero p { margin: 10px 0 0 0; opacity: 0.9; }
-    table { width: 100%; border-collapse: collapse; margin-top: 1rem; background: white; border-radius: 4px; overflow: hidden; }
-    th, td { text-align: left; padding: 0.875rem 1rem; border-bottom: 1px solid #eaeaea; }
-    th { background-color: #f8fafc; font-weight: 600; color: #475569; }
-    tr:last-child td { border-bottom: none; }
-    .critical { color: #dc2626; font-weight: bold; }
-    .major { color: #ea580c; font-weight: bold; }
-    .minor { color: #2563eb; }
-    .issue-critical { color: #dc2626; font-weight: bold; text-transform: uppercase; }
-    .issue-major { color: #ea580c; font-weight: bold; text-transform: uppercase; }
-    .issue-minor { color: #2563eb; font-weight: bold; text-transform: uppercase; }
-    code { background: #f1f5f9; padding: 0.2rem 0.4rem; border-radius: 4px; font-size: 0.875rem; color: #334155; }
-    .footer { margin-top: 4rem; text-align: center; color: #94a3b8; font-size: 0.875rem; }
-    a { color: #2563eb; text-decoration: none; }
-    a:hover { text-decoration: underline; }
-  </style>
+  ${tag("title", title)}
+  ${tag("style", styles)}
 </head>`;
 }
 function generateReportHero(title, subtitle) {
-  const subtitleHtml = subtitle ? `<p>${subtitle}</p>` : "";
-  return `<div class="hero">
-    <h1>${title}</h1>
-    ${subtitleHtml}
-  </div>`;
+  return tag("div", tag("h1", title) + (subtitle ? tag("p", subtitle) : ""), {
+    class: "hero"
+  });
 }
 function generateStatCards(cards) {
   const cardsHtml = cards.map(
-    (card) => `
-    <div class="stat-card">
-      <div class="stat-value"${card.color ? ` style="color: ${card.color}"` : ""}>${card.value}</div>
-      <div class="stat-label">${card.label}</div>
-    </div>`
+    (c) => tag(
+      "div",
+      tag("div", String(c.value), {
+        class: "stat-value",
+        ...c.color ? { style: `color: ${c.color}` } : {}
+      }) + tag("div", c.label, { class: "stat-label" }),
+      { class: "stat-card" }
+    )
   ).join("");
-  return `<div class="stats">${cardsHtml}</div>`;
-}
-function generateScoreCard(value, label) {
-  return `<div class="stat-card" style="margin-bottom: 2rem;">
-    <div class="stat-label">${label}</div>
-    <div class="stat-value">${value}</div>
-  </div>`;
+  return tag("div", cardsHtml, { class: "stats" });
 }
 function generateTable(config) {
-  const headersHtml = config.headers.map((h) => `<th>${h}</th>`).join("");
-  const rowsHtml = config.rows.map((row) => `<tr>${row.map((cell) => `<td>${cell}</td>`).join("")}</tr>`).join("");
-  return `<table>
-    <thead><tr>${headersHtml}</tr></thead>
-    <tbody>${rowsHtml}</tbody>
-  </table>`;
-}
-function generateIssueSummary(critical, major, minor, potentialSavings) {
-  const savingsHtml = potentialSavings ? `<p><strong>Potential Savings:</strong> ${potentialSavings.toLocaleString()} tokens</p>` : "";
-  return `<div class="card" style="margin-bottom: 30px;">
-    <h2>\u26A0\uFE0F Issues Summary</h2>
-    <p>
-      <span class="critical">\u{1F534} Critical: ${critical}</span> &nbsp;
-      <span class="major">\u{1F7E1} Major: ${major}</span> &nbsp;
-      <span class="minor">\u{1F535} Minor: ${minor}</span>
-    </p>
-    ${savingsHtml}
-  </div>`;
+  const head = tag(
+    "thead",
+    tag("tr", config.headers.map((h) => tag("th", h)).join(""))
+  );
+  const body = tag(
+    "tbody",
+    config.rows.map(
+      (row) => tag("tr", row.map((cell) => tag("td", cell)).join(""))
+    ).join("")
+  );
+  return tag("table", head + body);
+}
+function generateIssueSummary(crit, maj, min, savings) {
+  const details = [
+    tag("span", `\u{1F534} Critical: ${crit}`, { class: "critical" }),
+    tag("span", `\u{1F7E1} Major: ${maj}`, { class: "major" }),
+    tag("span", `\u{1F535} Minor: ${min}`, { class: "minor" })
+  ].join(" &nbsp; ");
+  const savingsHtml = savings ? tag(
+    "p",
+    tag("strong", "Potential Savings: ") + savings.toLocaleString() + " tokens"
+  ) : "";
+  return tag(
+    "div",
+    tag("h2", "\u26A0\uFE0F Issues Summary") + tag("p", details) + savingsHtml,
+    { class: "card", style: "margin-bottom: 30px;" }
+  );
 }
 function generateReportFooter(options) {
-  const versionText = options.version ? ` v${options.version}` : "";
+  const version = options.version ? ` v${options.version}` : "";
   const links = [];
-  if (options.packageUrl) {
-    links.push(`<a href="${options.packageUrl}">Star us on GitHub</a>`);
-  }
-  if (options.bugUrl) {
-    links.push(`<a href="${options.bugUrl}">Report it here</a>`);
-  }
-  const linksHtml = links.length ? links.map((l) => `<p>Like AIReady? ${l}</p>`).join("\n    ") : "";
-  return `<div class="footer">
-    <p>Generated by <strong>@aiready/${options.packageName}</strong>${versionText}</p>
-    ${linksHtml}
-  </div>`;
+  if (options.packageUrl)
+    links.push(
+      tag(
+        "p",
+        `Like AIReady? ${tag("a", "Star us on GitHub", { href: options.packageUrl })}`
+      )
+    );
+  if (options.bugUrl)
+    links.push(
+      tag(
+        "p",
+        `Like AIReady? ${tag("a", "Report it here", { href: options.bugUrl })}`
+      )
+    );
+  return tag(
+    "div",
+    tag(
+      "p",
+      `Generated by ${tag("strong", "@aiready/" + options.packageName)}` + version
+    ) + links.join(""),
+    { class: "footer" }
+  );
 }
 function wrapInCard(content, title) {
-  const titleHtml = title ? `<h2>${title}</h2>` : "";
-  return `<div class="card">
-    ${titleHtml}
-    ${content}
-  </div>`;
-}
-function generateCompleteReport(options, bodyContent) {
-  return `${generateReportHead(options.title)}
-<body>
-  ${bodyContent}
-  ${generateReportFooter(options)}
-</body>
-</html>`;
+  return tag("div", (title ? tag("h2", title) : "") + content, {
+    class: "card"
+  });
+}
+function generateCompleteReport(options, body) {
+  return generateReportHead(options.title) + tag("body", body + generateReportFooter(options));
+}
+function generateStandardHtmlReport(options, stats, sections, score) {
+  const hero = generateReportHero(
+    `${options.emoji || "\u{1F50D}"} AIReady ${options.title}`,
+    `Generated on ${(/* @__PURE__ */ new Date()).toLocaleString()}`
+  );
+  const scoreCard = score ? tag(
+    "div",
+    tag("div", String(score.value), { class: "score-value" }) + tag("div", score.label, { class: "score-label" }),
+    { class: "score-card" }
+  ) : "";
+  const statsCards = generateStatCards(stats);
+  const bodyContent = `
+    ${hero}
+    ${scoreCard}
+    ${statsCards}
+    ${sections.map((s) => wrapInCard(s.content, s.title)).join("\n")}
+  `;
+  return generateCompleteReport(options, bodyContent);
 }
 
 // src/utils/scoring-helpers.ts
@@ -1539,12 +1615,12 @@ function calculateHeuristicConfidence(similarity, tokens, lines) {
 }
 
 // src/utils/cli-factory.ts
-import chalk2 from "chalk";
+import chalk4 from "chalk";
 function createStandardProgressCallback(toolName) {
   return (processed, total, message) => {
     const percent = Math.round(processed / Math.max(1, total) * 100);
     process.stdout.write(
-      `\r\x1B[K   [${toolName}] ${chalk2.cyan(`${percent}%`)} ${message}`
+      `\r\x1B[K   [${toolName}] ${chalk4.cyan(`${percent}%`)} ${message}`
     );
     if (processed === total) {
       process.stdout.write("\n");
@@ -1552,12 +1628,12 @@ function createStandardProgressCallback(toolName) {
   };
 }
 function formatStandardCliResult(toolName, score, issuesCount) {
-  const scoreColor = score >= 75 ? chalk2.green : score >= 50 ? chalk2.yellow : chalk2.red;
+  const scoreColor = score >= 75 ? chalk4.green : score >= 50 ? chalk4.yellow : chalk4.red;
   console.log(`
-${chalk2.bold(toolName.toUpperCase())} Analysis Complete`);
+${chalk4.bold(toolName.toUpperCase())} Analysis Complete`);
   console.log(`  Overall Score: ${scoreColor(score)}/100`);
   console.log(
-    `  Issues Found: ${issuesCount > 0 ? chalk2.red(issuesCount) : chalk2.green("None")}`
+    `  Issues Found: ${issuesCount > 0 ? chalk4.red(issuesCount) : chalk4.green("None")}`
   );
 }
 async function runStandardCliAction(toolName, action) {
@@ -1566,7 +1642,7 @@ async function runStandardCliAction(toolName, action) {
     formatStandardCliResult(toolName, score, issuesCount);
   } catch (error) {
     console.error(
-      chalk2.red(`
+      chalk4.red(`
 \u274C [${toolName}] critical error: ${error.message}`)
     );
     process.exit(1);
@@ -1574,13 +1650,13 @@ async function runStandardCliAction(toolName, action) {
 }
 
 // src/utils/reporting.ts
-import chalk3 from "chalk";
+import chalk5 from "chalk";
 function getScoreColor(score) {
-  if (score >= 85) return chalk3.green;
-  if (score >= 70) return chalk3.cyan;
-  if (score >= 50) return chalk3.yellow;
-  if (score >= 30) return chalk3.red;
-  return chalk3.bgRed.white;
+  if (score >= 85) return chalk5.green;
+  if (score >= 70) return chalk5.cyan;
+  if (score >= 50) return chalk5.yellow;
+  if (score >= 30) return chalk5.red;
+  return chalk5.bgRed.white;
 }
 function displayStandardConsoleReport(data) {
   const {
@@ -1595,27 +1671,27 @@ function displayStandardConsoleReport(data) {
     noIssuesMessage = "\u2728 No issues found!",
     safetyRating
   } = data;
-  console.log(chalk3.bold(`
+  console.log(chalk5.bold(`
 ${title}
 `));
   if (safetyRating) {
     if (safetyRating === "blind-risk" || safetyRating === "\u{1F480} blind-risk") {
       console.log(
-        chalk3.bgRed.white.bold(
+        chalk5.bgRed.white.bold(
           "  \u{1F480} BLIND RISK \u2014 NO TESTS DETECTED. AI-GENERATED CHANGES CANNOT BE VERIFIED.  "
         )
       );
       console.log();
     } else if (safetyRating === "high-risk" || safetyRating === "\u{1F534} high-risk") {
       console.log(
-        chalk3.red.bold(
+        chalk5.red.bold(
           `  \u{1F534} HIGH RISK \u2014 Insufficient test coverage. AI changes may introduce silent bugs.`
         )
       );
       console.log();
     }
   }
-  const safetyColor = safetyRating ? getSeverityColor(safetyRating, chalk3) : getScoreColor(score);
+  const safetyColor = safetyRating ? getSeverityColor(safetyRating, chalk5) : getScoreColor(score);
   if (safetyRating) {
     console.log(
       `AI Change Safety: ${safetyColor(`${getSafetyIcon(safetyRating)} ${safetyRating.toUpperCase()}`)}`
@@ -1625,12 +1701,12 @@ ${title}
     `Score:            ${getScoreColor(score)(score + "/100")} (${rating.toUpperCase()})`
   );
   if (stats.length > 0) {
-    const statsStr = stats.map((s) => `${s.label}: ${chalk3.cyan(s.value)}`).join("   ");
+    const statsStr = stats.map((s) => `${s.label}: ${chalk5.cyan(s.value)}`).join("   ");
     console.log(statsStr);
   }
-  console.log(`Analysis Time:    ${chalk3.gray(elapsedTime + "s")}
+  console.log(`Analysis Time:    ${chalk5.gray(elapsedTime + "s")}
 `);
-  console.log(chalk3.bold("\u{1F4D0} Dimension Scores\n"));
+  console.log(chalk5.bold("\u{1F4D0} Dimension Scores\n"));
   for (const dim of dimensions) {
     const color = getScoreColor(dim.value);
     console.log(
@@ -1638,24 +1714,24 @@ ${title}
     );
   }
   if (issues.length > 0) {
-    console.log(chalk3.bold("\n\u26A0\uFE0F  Issues\n"));
+    console.log(chalk5.bold("\n\u26A0\uFE0F  Issues\n"));
     for (const issue of issues) {
-      const sev = getSeverityColor(issue.severity, chalk3);
+      const sev = getSeverityColor(issue.severity, chalk5);
       console.log(`${sev(issue.severity.toUpperCase())}  ${issue.message}`);
       if (issue.suggestion) {
         console.log(
-          `         ${chalk3.dim("\u2192")} ${chalk3.italic(issue.suggestion)}`
+          `         ${chalk5.dim("\u2192")} ${chalk5.italic(issue.suggestion)}`
         );
       }
       console.log();
     }
   } else {
-    console.log(chalk3.green(`
+    console.log(chalk5.green(`
 ${noIssuesMessage}
 `));
   }
   if (recommendations.length > 0) {
-    console.log(chalk3.bold("\u{1F4A1} Recommendations\n"));
+    console.log(chalk5.bold("\u{1F4A1} Recommendations\n"));
     recommendations.forEach((rec, i) => {
       console.log(`${i + 1}. ${rec}`);
     });
@@ -2636,7 +2712,17 @@ function calculateAiSignalClarity(params) {
       rating: "minimal",
       signals: [],
       topRisk: "No symbols to analyze",
-      recommendations: []
+      recommendations: [],
+      dimensions: {
+        overloadingScore: 100,
+        magicLiteralScore: 100,
+        booleanTrapScore: 100,
+        implicitSideEffectScore: 100,
+        deepCallbackScore: 100,
+        ambiguityScore: 100,
+        documentationScore: 100,
+        sizeScore: 100
+      }
     };
   }
   const overloadRatio = overloadedSymbols / Math.max(1, totalSymbols);
@@ -2749,7 +2835,23 @@ function calculateAiSignalClarity(params) {
     rating,
     signals: signals.filter((s) => s.count > 0),
     topRisk,
-    recommendations
+    recommendations,
+    dimensions: {
+      overloadingScore: Math.max(0, 100 - overloadSignal.riskContribution * 5),
+      magicLiteralScore: Math.max(0, 100 - magicSignal.riskContribution * 6.6),
+      booleanTrapScore: Math.max(0, 100 - trapSignal.riskContribution * 6.6),
+      implicitSideEffectScore: Math.max(
+        0,
+        100 - sideEffectSignal.riskContribution * 10
+      ),
+      deepCallbackScore: Math.max(
+        0,
+        100 - callbackSignal.riskContribution * 10
+      ),
+      ambiguityScore: Math.max(0, 100 - ambiguousSignal.riskContribution * 20),
+      documentationScore: Math.max(0, 100 - undocSignal.riskContribution * 20),
+      sizeScore: Math.max(0, 100 - largeFileSignal.riskContribution * 4)
+    }
   };
 }
 
@@ -3352,6 +3454,104 @@ function emitIssuesAsAnnotations(issues) {
     });
   });
 }
+
+// src/utils/analysis-orchestrator.ts
+async function runBatchAnalysis(items, label, toolId, onProgress, processFn, onResult) {
+  let processed = 0;
+  for (const item of items) {
+    processed++;
+    emitProgress(processed, items.length, toolId, label, onProgress);
+    const result = await processFn(item);
+    onResult(result);
+  }
+}
+
+// src/utils/spoke-cli-helpers.ts
+import chalk6 from "chalk";
+async function executeSpokeCli(name, description, options, analyzeFn) {
+  console.log(chalk6.cyan(`Analyzing ${description.toLowerCase()}...`));
+  try {
+    const report = await analyzeFn({
+      rootDir: process.cwd(),
+      ...options
+    });
+    console.log(chalk6.bold(`
+${name} Analysis Results:`));
+    console.log(
+      `Rating: ${report.summary.rating.toUpperCase()} (Score: ${report.summary.score})`
+    );
+    if (report.issues && report.issues.length > 0) {
+      console.log(chalk6.red(`
+Found ${report.issues.length} issues.`));
+    } else {
+      console.log(chalk6.green("\nNo issues detected."));
+    }
+    return report;
+  } catch (err) {
+    console.error(chalk6.red(`Error during ${name} analysis: ${err.message}`));
+    process.exit(1);
+  }
+}
+
+// src/utils/test-utils.ts
+import { readFileSync as readFileSync3, existsSync as existsSync5 } from "fs";
+import { join as join5 } from "path";
+var TEST_PATTERNS = [
+  /\.(test|spec)\.(ts|tsx|js|jsx)$/,
+  /_test\.go$/,
+  /test_.*\.py$/,
+  /.*_test\.py$/,
+  /.*Test\.java$/,
+  /.*Tests\.cs$/,
+  /__tests__\//,
+  /\/tests?\//,
+  /\/e2e\//,
+  /\/fixtures\//
+];
+function isTestFile(filePath, extraPatterns) {
+  if (TEST_PATTERNS.some((p) => p.test(filePath))) return true;
+  if (extraPatterns) return extraPatterns.some((p) => filePath.includes(p));
+  return false;
+}
+function detectTestFramework(rootDir) {
+  const manifests = [
+    {
+      file: "package.json",
+      deps: [
+        "jest",
+        "vitest",
+        "mocha",
+        "jasmine",
+        "ava",
+        "tap",
+        "playwright",
+        "cypress"
+      ]
+    },
+    { file: "requirements.txt", deps: ["pytest", "unittest", "nose"] },
+    { file: "pyproject.toml", deps: ["pytest"] },
+    { file: "pom.xml", deps: ["junit", "testng"] },
+    { file: "build.gradle", deps: ["junit", "testng"] },
+    { file: "go.mod", deps: ["testing"] }
+    // go testing is built-in
+  ];
+  for (const m of manifests) {
+    const p = join5(rootDir, m.file);
+    if (existsSync5(p)) {
+      if (m.file === "go.mod") return true;
+      try {
+        const content = readFileSync3(p, "utf-8");
+        if (m.deps.some((d) => content.includes(d))) return true;
+      } catch {
+      }
+    }
+  }
+  return false;
+}
+function isBuildArtifact(filePath) {
+  const lower = filePath.toLowerCase();
+  return lower.includes("/node_modules/") || lower.includes("/dist/") || lower.includes("/build/") || lower.includes("/out/") || lower.includes("/.next/") || lower.includes("/target/") || lower.includes("/bin/");
+}
 export {
   AIReadyConfigSchema,
   AnalysisResultSchema,
@@ -3396,6 +3596,7 @@ export {
   SeveritySchema,
   SpokeOutputSchema,
   SpokeSummarySchema,
+  TEST_PATTERNS,
   TOOL_NAME_MAP,
   ToolName,
   ToolNameSchema,
@@ -3435,14 +3636,18 @@ export {
   clearHistory,
   createProvider,
   createStandardProgressCallback,
+  detectTestFramework,
   displayStandardConsoleReport,
   emitAnnotation,
   emitIssuesAsAnnotations,
   emitProgress,
+  ensureDir,
   estimateCostFromBudget,
   estimateTokens,
+  executeSpokeCli,
   exportHistory,
   extractCodeBlocks,
+  filterBySeverity,
   findLatestReport,
   findLatestScanReport,
   formatAcceptanceRate,
@@ -3458,13 +3663,14 @@ export {
   generateReportFooter,
   generateReportHead,
   generateReportHero,
-  generateScoreCard,
+  generateStandardHtmlReport,
   generateStatCards,
   generateTable,
   generateValueChain,
   getElapsedTime,
   getFileCommitTimestamps,
   getFileExtension,
+  getFilesByPattern,
   getHistorySummary,
   getLineRangeLastModifiedCached,
   getModelPreset,
@@ -3487,6 +3693,7 @@ export {
   getSeverityBadge,
   getSeverityColor,
   getSeverityEnum,
+  getSeverityLabel,
   getSeverityLevel,
   getSeverityValue,
   getSupportedLanguages,
@@ -3501,8 +3708,10 @@ export {
   inferPatternType,
   initTreeSitter,
   initializeParsers,
+  isBuildArtifact,
   isFileSupported,
   isSourceFile,
+  isTestFile,
   loadConfig,
   loadMergedConfig,
   loadScoreHistory,
@@ -3510,6 +3719,7 @@ export {
   normalizeAnalysisResult,
   normalizeIssue,
   normalizeMetrics,
+  normalizeSeverity,
   normalizeSpokeOutput,
   normalizeToolName,
   parseFileExports,
@@ -3520,6 +3730,7 @@ export {
   readFileContent,
   resolveOutputFormat,
   resolveOutputPath,
+  runBatchAnalysis,
   runStandardCliAction,
   saveScoreEntry,
   scanEntries,