@aiready/core 0.23.23 → 0.23.24

package/dist/index.js

@@ -965,8 +965,8 @@ var init_python_parser = __esm({
           const fromMatch = line.match(fromImportRegex);
           if (fromMatch) {
             const module2 = fromMatch[1];
-            const imports_str = fromMatch[2];
-            if (imports_str.trim() === "*") {
+            const importsStr = fromMatch[2];
+            if (importsStr.trim() === "*") {
               imports.push({
                 source: module2,
                 specifiers: ["*"],
@@ -977,7 +977,7 @@ var init_python_parser = __esm({
               });
               return;
             }
-            const specifiers = imports_str.split(",").map((s) => s.trim().split(" as ")[0]);
+            const specifiers = importsStr.split(",").map((s) => s.trim().split(" as ")[0]);
             imports.push({
               source: module2,
               specifiers,
@@ -1994,6 +1994,7 @@ __export(index_exports, {
   SeveritySchema: () => SeveritySchema,
   SpokeOutputSchema: () => SpokeOutputSchema,
   SpokeSummarySchema: () => SpokeSummarySchema,
+  TEST_PATTERNS: () => TEST_PATTERNS,
   TOOL_NAME_MAP: () => TOOL_NAME_MAP,
   ToolName: () => ToolName,
   ToolNameSchema: () => ToolNameSchema,
@@ -2033,14 +2034,18 @@ __export(index_exports, {
   clearHistory: () => clearHistory,
   createProvider: () => createProvider,
   createStandardProgressCallback: () => createStandardProgressCallback,
+  detectTestFramework: () => detectTestFramework,
   displayStandardConsoleReport: () => displayStandardConsoleReport,
   emitAnnotation: () => emitAnnotation,
   emitIssuesAsAnnotations: () => emitIssuesAsAnnotations,
   emitProgress: () => emitProgress,
+  ensureDir: () => ensureDir,
   estimateCostFromBudget: () => estimateCostFromBudget,
   estimateTokens: () => estimateTokens,
+  executeSpokeCli: () => executeSpokeCli,
   exportHistory: () => exportHistory,
   extractCodeBlocks: () => extractCodeBlocks,
+  filterBySeverity: () => filterBySeverity,
   findLatestReport: () => findLatestReport,
   findLatestScanReport: () => findLatestScanReport,
   formatAcceptanceRate: () => formatAcceptanceRate,
@@ -2056,13 +2061,14 @@ __export(index_exports, {
   generateReportFooter: () => generateReportFooter,
   generateReportHead: () => generateReportHead,
   generateReportHero: () => generateReportHero,
-  generateScoreCard: () => generateScoreCard,
+  generateStandardHtmlReport: () => generateStandardHtmlReport,
   generateStatCards: () => generateStatCards,
   generateTable: () => generateTable,
   generateValueChain: () => generateValueChain,
   getElapsedTime: () => getElapsedTime,
   getFileCommitTimestamps: () => getFileCommitTimestamps,
   getFileExtension: () => getFileExtension,
+  getFilesByPattern: () => getFilesByPattern,
   getHistorySummary: () => getHistorySummary,
   getLineRangeLastModifiedCached: () => getLineRangeLastModifiedCached,
   getModelPreset: () => getModelPreset,
@@ -2085,6 +2091,7 @@ __export(index_exports, {
   getSeverityBadge: () => getSeverityBadge,
   getSeverityColor: () => getSeverityColor,
   getSeverityEnum: () => getSeverityEnum,
+  getSeverityLabel: () => getSeverityLabel,
   getSeverityLevel: () => getSeverityLevel,
   getSeverityValue: () => getSeverityValue,
   getSupportedLanguages: () => getSupportedLanguages,
@@ -2099,8 +2106,10 @@ __export(index_exports, {
   inferPatternType: () => inferPatternType,
   initTreeSitter: () => initTreeSitter,
   initializeParsers: () => initializeParsers,
+  isBuildArtifact: () => isBuildArtifact,
   isFileSupported: () => isFileSupported,
   isSourceFile: () => isSourceFile,
+  isTestFile: () => isTestFile,
   loadConfig: () => loadConfig,
   loadMergedConfig: () => loadMergedConfig,
   loadScoreHistory: () => loadScoreHistory,
@@ -2108,6 +2117,7 @@ __export(index_exports, {
   normalizeAnalysisResult: () => normalizeAnalysisResult,
   normalizeIssue: () => normalizeIssue,
   normalizeMetrics: () => normalizeMetrics,
+  normalizeSeverity: () => normalizeSeverity,
   normalizeSpokeOutput: () => normalizeSpokeOutput,
   normalizeToolName: () => normalizeToolName,
   parseFileExports: () => parseFileExports,
@@ -2118,6 +2128,7 @@ __export(index_exports, {
   readFileContent: () => readFileContent,
   resolveOutputFormat: () => resolveOutputFormat,
   resolveOutputPath: () => resolveOutputPath,
+  runBatchAnalysis: () => runBatchAnalysis,
   runStandardCliAction: () => runStandardCliAction,
   saveScoreEntry: () => saveScoreEntry,
   scanEntries: () => scanEntries,
@@ -2364,12 +2375,12 @@ var UnifiedReportSchema = import_zod6.z.object({
 // src/types/schemas/config.ts
 var import_zod7 = require("zod");
 var AIReadyConfigSchema = import_zod7.z.object({
-  /** Target score threshold (0-100) */
-  threshold: import_zod7.z.number().optional(),
-  /** Files or directories to include in scan */
-  include: import_zod7.z.array(import_zod7.z.string()).optional(),
   /** Files or directories to exclude from scan */
   exclude: import_zod7.z.array(import_zod7.z.string()).optional(),
+  /** Fail CI/CD if score below threshold (0-100) */
+  threshold: import_zod7.z.number().optional(),
+  /** Fail on issues: critical, major, any */
+  failOn: import_zod7.z.enum(["critical", "major", "any", "none"]).optional(),
   /** Scan-specific configuration */
   scan: import_zod7.z.object({
     include: import_zod7.z.array(import_zod7.z.string()).optional(),
@@ -2750,14 +2761,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])
   ];
@@ -2819,14 +2830,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])
   ];
@@ -2881,26 +2892,15 @@ function isSourceFile(filePath) {
   return ["ts", "tsx", "js", "jsx", "py", "java", "go", "rs"].includes(ext);
 }
 
-// src/utils/cli-helpers.ts
+// src/utils/fs-utils.ts
 var import_fs2 = require("fs");
 var import_path2 = require("path");
-var import_chalk = __toESM(require("chalk"));
 function ensureDir(path2) {
   const dir = (0, import_path2.dirname)(path2);
   if (!(0, import_fs2.existsSync)(dir)) {
     (0, import_fs2.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 (!(0, import_fs2.existsSync)(dir)) return [];
   try {
@@ -2927,16 +2927,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);
@@ -2946,63 +2936,54 @@ function handleJSONOutput(data, outputFile, successMessage) {
     console.log(JSON.stringify(data, null, 2));
   }
 }
-function getTerminalDivider(color = import_chalk.default.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 = import_chalk.default.cyan) {
-  const divider = getTerminalDivider(color);
-  console.log(divider);
-  console.log(import_chalk.default.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 = (0, import_path2.resolve)(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: (0, import_path2.resolve)(aireadyDir, f),
+    mtime: (0, import_fs2.statSync)((0, import_path2.resolve)(aireadyDir, f)).mtime
+  })).sort((a, b) => b.mtime.getTime() - a.mtime.getTime());
+  return sortedFiles[0].path;
 }
-function getSeverityColor(severity, chalkInstance = import_chalk.default) {
-  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 (0, import_path2.join)(scanReportsDir, reportFiles[0]);
+  } catch {
+    console.error("Error while finding latest scan report");
+    return null;
   }
 }
+
+// src/utils/terminal-utils.ts
+var import_chalk2 = __toESM(require("chalk"));
+
+// src/utils/severity-utils.ts
+var import_chalk = __toESM(require("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) {
@@ -3021,23 +3002,6 @@ function getSeverityValue(s) {
 function getSeverityLevel(s) {
   return getSeverityValue(s);
 }
-function getSeverityBadge(severity, chalkInstance = import_chalk.default) {
-  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) {
@@ -3051,39 +3015,125 @@ function getSeverityEnum(s) {
       return "info";
   }
 }
-function findLatestReport(dirPath) {
-  const aireadyDir = (0, import_path2.resolve)(dirPath, ".aiready");
-  let files = getFilesByPattern(aireadyDir, /^aiready-report-.*\.json$/);
-  if (files.length === 0) {
-    files = getFilesByPattern(aireadyDir, /^aiready-scan-.*\.json$/);
+function getSeverityColor(severity, chalkInstance = import_chalk.default) {
+  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 = import_chalk.default) {
+  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: (0, import_path2.resolve)(aireadyDir, f),
-    mtime: (0, import_fs2.statSync)((0, import_path2.resolve)(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 (0, import_path2.join)(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
+var import_chalk3 = __toESM(require("chalk"));
+function printTerminalHeader(title, colorFn = import_chalk3.default.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 = import_chalk3.default.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
 var import_path3 = require("path");
 function getReportTimestamp() {
@@ -3675,6 +3725,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)) {
@@ -3858,114 +3911,148 @@ function generateHTML(graph) {
 </html>`;
 }
 
+// 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/rating-helpers.ts
@@ -4387,12 +4474,12 @@ function calculateHeuristicConfidence(similarity, tokens, lines) {
 }
 
 // src/utils/cli-factory.ts
-var import_chalk2 = __toESM(require("chalk"));
+var import_chalk4 = __toESM(require("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}] ${import_chalk2.default.cyan(`${percent}%`)} ${message}`
+      `\r\x1B[K   [${toolName}] ${import_chalk4.default.cyan(`${percent}%`)} ${message}`
     );
     if (processed === total) {
       process.stdout.write("\n");
@@ -4400,12 +4487,12 @@ function createStandardProgressCallback(toolName) {
   };
 }
 function formatStandardCliResult(toolName, score, issuesCount) {
-  const scoreColor = score >= 75 ? import_chalk2.default.green : score >= 50 ? import_chalk2.default.yellow : import_chalk2.default.red;
+  const scoreColor = score >= 75 ? import_chalk4.default.green : score >= 50 ? import_chalk4.default.yellow : import_chalk4.default.red;
   console.log(`
-${import_chalk2.default.bold(toolName.toUpperCase())} Analysis Complete`);
+${import_chalk4.default.bold(toolName.toUpperCase())} Analysis Complete`);
   console.log(`  Overall Score: ${scoreColor(score)}/100`);
   console.log(
-    `  Issues Found: ${issuesCount > 0 ? import_chalk2.default.red(issuesCount) : import_chalk2.default.green("None")}`
+    `  Issues Found: ${issuesCount > 0 ? import_chalk4.default.red(issuesCount) : import_chalk4.default.green("None")}`
   );
 }
 async function runStandardCliAction(toolName, action) {
@@ -4414,7 +4501,7 @@ async function runStandardCliAction(toolName, action) {
     formatStandardCliResult(toolName, score, issuesCount);
   } catch (error) {
     console.error(
-      import_chalk2.default.red(`
+      import_chalk4.default.red(`
 \u274C [${toolName}] critical error: ${error.message}`)
     );
     process.exit(1);
@@ -4422,13 +4509,13 @@ async function runStandardCliAction(toolName, action) {
 }
 
 // src/utils/reporting.ts
-var import_chalk3 = __toESM(require("chalk"));
+var import_chalk5 = __toESM(require("chalk"));
 function getScoreColor(score) {
-  if (score >= 85) return import_chalk3.default.green;
-  if (score >= 70) return import_chalk3.default.cyan;
-  if (score >= 50) return import_chalk3.default.yellow;
-  if (score >= 30) return import_chalk3.default.red;
-  return import_chalk3.default.bgRed.white;
+  if (score >= 85) return import_chalk5.default.green;
+  if (score >= 70) return import_chalk5.default.cyan;
+  if (score >= 50) return import_chalk5.default.yellow;
+  if (score >= 30) return import_chalk5.default.red;
+  return import_chalk5.default.bgRed.white;
 }
 function displayStandardConsoleReport(data) {
   const {
@@ -4443,27 +4530,27 @@ function displayStandardConsoleReport(data) {
     noIssuesMessage = "\u2728 No issues found!",
     safetyRating
   } = data;
-  console.log(import_chalk3.default.bold(`
+  console.log(import_chalk5.default.bold(`
 ${title}
 `));
   if (safetyRating) {
     if (safetyRating === "blind-risk" || safetyRating === "\u{1F480} blind-risk") {
       console.log(
-        import_chalk3.default.bgRed.white.bold(
+        import_chalk5.default.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(
-        import_chalk3.default.red.bold(
+        import_chalk5.default.red.bold(
           `  \u{1F534} HIGH RISK \u2014 Insufficient test coverage. AI changes may introduce silent bugs.`
         )
       );
       console.log();
     }
   }
-  const safetyColor = safetyRating ? getSeverityColor(safetyRating, import_chalk3.default) : getScoreColor(score);
+  const safetyColor = safetyRating ? getSeverityColor(safetyRating, import_chalk5.default) : getScoreColor(score);
   if (safetyRating) {
     console.log(
       `AI Change Safety: ${safetyColor(`${getSafetyIcon(safetyRating)} ${safetyRating.toUpperCase()}`)}`
@@ -4473,12 +4560,12 @@ ${title}
     `Score:            ${getScoreColor(score)(score + "/100")} (${rating.toUpperCase()})`
   );
   if (stats.length > 0) {
-    const statsStr = stats.map((s) => `${s.label}: ${import_chalk3.default.cyan(s.value)}`).join("   ");
+    const statsStr = stats.map((s) => `${s.label}: ${import_chalk5.default.cyan(s.value)}`).join("   ");
     console.log(statsStr);
   }
-  console.log(`Analysis Time:    ${import_chalk3.default.gray(elapsedTime + "s")}
+  console.log(`Analysis Time:    ${import_chalk5.default.gray(elapsedTime + "s")}
 `);
-  console.log(import_chalk3.default.bold("\u{1F4D0} Dimension Scores\n"));
+  console.log(import_chalk5.default.bold("\u{1F4D0} Dimension Scores\n"));
   for (const dim of dimensions) {
     const color = getScoreColor(dim.value);
     console.log(
@@ -4486,24 +4573,24 @@ ${title}
     );
   }
   if (issues.length > 0) {
-    console.log(import_chalk3.default.bold("\n\u26A0\uFE0F  Issues\n"));
+    console.log(import_chalk5.default.bold("\n\u26A0\uFE0F  Issues\n"));
     for (const issue of issues) {
-      const sev = getSeverityColor(issue.severity, import_chalk3.default);
+      const sev = getSeverityColor(issue.severity, import_chalk5.default);
       console.log(`${sev(issue.severity.toUpperCase())}  ${issue.message}`);
       if (issue.suggestion) {
         console.log(
-          `         ${import_chalk3.default.dim("\u2192")} ${import_chalk3.default.italic(issue.suggestion)}`
+          `         ${import_chalk5.default.dim("\u2192")} ${import_chalk5.default.italic(issue.suggestion)}`
         );
       }
       console.log();
     }
   } else {
-    console.log(import_chalk3.default.green(`
+    console.log(import_chalk5.default.green(`
 ${noIssuesMessage}
 `));
   }
   if (recommendations.length > 0) {
-    console.log(import_chalk3.default.bold("\u{1F4A1} Recommendations\n"));
+    console.log(import_chalk5.default.bold("\u{1F4A1} Recommendations\n"));
     recommendations.forEach((rec, i) => {
       console.log(`${i + 1}. ${rec}`);
     });
@@ -5492,7 +5579,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);
@@ -5605,7 +5702,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)
+    }
   };
 }
 
@@ -6208,6 +6321,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
+var import_chalk6 = __toESM(require("chalk"));
+async function executeSpokeCli(name, description, options, analyzeFn) {
+  console.log(import_chalk6.default.cyan(`Analyzing ${description.toLowerCase()}...`));
+  try {
+    const report = await analyzeFn({
+      rootDir: process.cwd(),
+      ...options
+    });
+    console.log(import_chalk6.default.bold(`
+${name} Analysis Results:`));
+    console.log(
+      `Rating: ${report.summary.rating.toUpperCase()} (Score: ${report.summary.score})`
+    );
+    if (report.issues && report.issues.length > 0) {
+      console.log(import_chalk6.default.red(`
+Found ${report.issues.length} issues.`));
+    } else {
+      console.log(import_chalk6.default.green("\nNo issues detected."));
+    }
+    return report;
+  } catch (err) {
+    console.error(import_chalk6.default.red(`Error during ${name} analysis: ${err.message}`));
+    process.exit(1);
+  }
+}
+
+// src/utils/test-utils.ts
+var import_fs5 = require("fs");
+var import_path6 = require("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 = (0, import_path6.join)(rootDir, m.file);
+    if ((0, import_fs5.existsSync)(p)) {
+      if (m.file === "go.mod") return true;
+      try {
+        const content = (0, import_fs5.readFileSync)(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/");
+}
 // Annotate the CommonJS export names for ESM import in node:
 0 && (module.exports = {
   AIReadyConfigSchema,
@@ -6253,6 +6464,7 @@ function emitIssuesAsAnnotations(issues) {
   SeveritySchema,
   SpokeOutputSchema,
   SpokeSummarySchema,
+  TEST_PATTERNS,
   TOOL_NAME_MAP,
   ToolName,
   ToolNameSchema,
@@ -6292,14 +6504,18 @@ function emitIssuesAsAnnotations(issues) {
   clearHistory,
   createProvider,
   createStandardProgressCallback,
+  detectTestFramework,
   displayStandardConsoleReport,
   emitAnnotation,
   emitIssuesAsAnnotations,
   emitProgress,
+  ensureDir,
   estimateCostFromBudget,
   estimateTokens,
+  executeSpokeCli,
   exportHistory,
   extractCodeBlocks,
+  filterBySeverity,
   findLatestReport,
   findLatestScanReport,
   formatAcceptanceRate,
@@ -6315,13 +6531,14 @@ function emitIssuesAsAnnotations(issues) {
   generateReportFooter,
   generateReportHead,
   generateReportHero,
-  generateScoreCard,
+  generateStandardHtmlReport,
   generateStatCards,
   generateTable,
   generateValueChain,
   getElapsedTime,
   getFileCommitTimestamps,
   getFileExtension,
+  getFilesByPattern,
   getHistorySummary,
   getLineRangeLastModifiedCached,
   getModelPreset,
@@ -6344,6 +6561,7 @@ function emitIssuesAsAnnotations(issues) {
   getSeverityBadge,
   getSeverityColor,
   getSeverityEnum,
+  getSeverityLabel,
   getSeverityLevel,
   getSeverityValue,
   getSupportedLanguages,
@@ -6358,8 +6576,10 @@ function emitIssuesAsAnnotations(issues) {
   inferPatternType,
   initTreeSitter,
   initializeParsers,
+  isBuildArtifact,
   isFileSupported,
   isSourceFile,
+  isTestFile,
   loadConfig,
   loadMergedConfig,
   loadScoreHistory,
@@ -6367,6 +6587,7 @@ function emitIssuesAsAnnotations(issues) {
   normalizeAnalysisResult,
   normalizeIssue,
   normalizeMetrics,
+  normalizeSeverity,
   normalizeSpokeOutput,
   normalizeToolName,
   parseFileExports,
@@ -6377,6 +6598,7 @@ function emitIssuesAsAnnotations(issues) {
   readFileContent,
   resolveOutputFormat,
   resolveOutputPath,
+  runBatchAnalysis,
   runStandardCliAction,
   saveScoreEntry,
   scanEntries,