@aiready/core 0.23.2 → 0.23.4

package/dist/chunk-YCA4FTEK.mjs

@@ -1,79 +1,79 @@
 // src/types/schema.ts
-import { z } from "zod";
+import { z } from 'zod';
 var Severity = /* @__PURE__ */ ((Severity2) => {
-  Severity2["Critical"] = "critical";
-  Severity2["Major"] = "major";
-  Severity2["Minor"] = "minor";
-  Severity2["Info"] = "info";
+  Severity2['Critical'] = 'critical';
+  Severity2['Major'] = 'major';
+  Severity2['Minor'] = 'minor';
+  Severity2['Info'] = 'info';
   return Severity2;
 })(Severity || {});
 var SeveritySchema = z.nativeEnum(Severity);
 var ToolName = /* @__PURE__ */ ((ToolName2) => {
-  ToolName2["PatternDetect"] = "pattern-detect";
-  ToolName2["ContextAnalyzer"] = "context-analyzer";
-  ToolName2["NamingConsistency"] = "naming-consistency";
-  ToolName2["AiSignalClarity"] = "ai-signal-clarity";
-  ToolName2["AgentGrounding"] = "agent-grounding";
-  ToolName2["TestabilityIndex"] = "testability-index";
-  ToolName2["DocDrift"] = "doc-drift";
-  ToolName2["DependencyHealth"] = "dependency-health";
-  ToolName2["ChangeAmplification"] = "change-amplification";
-  ToolName2["CognitiveLoad"] = "cognitive-load";
-  ToolName2["PatternEntropy"] = "pattern-entropy";
-  ToolName2["ConceptCohesion"] = "concept-cohesion";
-  ToolName2["SemanticDistance"] = "semantic-distance";
+  ToolName2['PatternDetect'] = 'pattern-detect';
+  ToolName2['ContextAnalyzer'] = 'context-analyzer';
+  ToolName2['NamingConsistency'] = 'naming-consistency';
+  ToolName2['AiSignalClarity'] = 'ai-signal-clarity';
+  ToolName2['AgentGrounding'] = 'agent-grounding';
+  ToolName2['TestabilityIndex'] = 'testability-index';
+  ToolName2['DocDrift'] = 'doc-drift';
+  ToolName2['DependencyHealth'] = 'dependency-health';
+  ToolName2['ChangeAmplification'] = 'change-amplification';
+  ToolName2['CognitiveLoad'] = 'cognitive-load';
+  ToolName2['PatternEntropy'] = 'pattern-entropy';
+  ToolName2['ConceptCohesion'] = 'concept-cohesion';
+  ToolName2['SemanticDistance'] = 'semantic-distance';
   return ToolName2;
 })(ToolName || {});
 var ToolNameSchema = z.nativeEnum(ToolName);
 var FRIENDLY_TOOL_NAMES = {
-  ["pattern-detect" /* PatternDetect */]: "Semantic Duplicates",
-  ["context-analyzer" /* ContextAnalyzer */]: "Context Fragmentation",
-  ["naming-consistency" /* NamingConsistency */]: "Naming Consistency",
-  ["ai-signal-clarity" /* AiSignalClarity */]: "AI Signal Clarity",
-  ["agent-grounding" /* AgentGrounding */]: "Agent Grounding",
-  ["testability-index" /* TestabilityIndex */]: "Testability Index",
-  ["doc-drift" /* DocDrift */]: "Documentation Health",
-  ["dependency-health" /* DependencyHealth */]: "Dependency Health",
-  ["change-amplification" /* ChangeAmplification */]: "Change Amplification",
-  ["cognitive-load" /* CognitiveLoad */]: "Cognitive Load",
-  ["pattern-entropy" /* PatternEntropy */]: "Pattern Entropy",
-  ["concept-cohesion" /* ConceptCohesion */]: "Concept Cohesion",
-  ["semantic-distance" /* SemanticDistance */]: "Semantic Distance"
+  ['pattern-detect' /* PatternDetect */]: 'Semantic Duplicates',
+  ['context-analyzer' /* ContextAnalyzer */]: 'Context Fragmentation',
+  ['naming-consistency' /* NamingConsistency */]: 'Naming Consistency',
+  ['ai-signal-clarity' /* AiSignalClarity */]: 'AI Signal Clarity',
+  ['agent-grounding' /* AgentGrounding */]: 'Agent Grounding',
+  ['testability-index' /* TestabilityIndex */]: 'Testability Index',
+  ['doc-drift' /* DocDrift */]: 'Documentation Health',
+  ['dependency-health' /* DependencyHealth */]: 'Dependency Health',
+  ['change-amplification' /* ChangeAmplification */]: 'Change Amplification',
+  ['cognitive-load' /* CognitiveLoad */]: 'Cognitive Load',
+  ['pattern-entropy' /* PatternEntropy */]: 'Pattern Entropy',
+  ['concept-cohesion' /* ConceptCohesion */]: 'Concept Cohesion',
+  ['semantic-distance' /* SemanticDistance */]: 'Semantic Distance',
 };
 var IssueType = /* @__PURE__ */ ((IssueType2) => {
-  IssueType2["DuplicatePattern"] = "duplicate-pattern";
-  IssueType2["PatternInconsistency"] = "pattern-inconsistency";
-  IssueType2["ContextFragmentation"] = "context-fragmentation";
-  IssueType2["DependencyHealth"] = "dependency-health";
-  IssueType2["CircularDependency"] = "circular-dependency";
-  IssueType2["DocDrift"] = "doc-drift";
-  IssueType2["NamingInconsistency"] = "naming-inconsistency";
-  IssueType2["NamingQuality"] = "naming-quality";
-  IssueType2["ArchitectureInconsistency"] = "architecture-inconsistency";
-  IssueType2["DeadCode"] = "dead-code";
-  IssueType2["MissingTypes"] = "missing-types";
-  IssueType2["MagicLiteral"] = "magic-literal";
-  IssueType2["BooleanTrap"] = "boolean-trap";
-  IssueType2["AiSignalClarity"] = "ai-signal-clarity";
-  IssueType2["LowTestability"] = "low-testability";
-  IssueType2["AgentNavigationFailure"] = "agent-navigation-failure";
-  IssueType2["AmbiguousApi"] = "ambiguous-api";
-  IssueType2["ChangeAmplification"] = "change-amplification";
+  IssueType2['DuplicatePattern'] = 'duplicate-pattern';
+  IssueType2['PatternInconsistency'] = 'pattern-inconsistency';
+  IssueType2['ContextFragmentation'] = 'context-fragmentation';
+  IssueType2['DependencyHealth'] = 'dependency-health';
+  IssueType2['CircularDependency'] = 'circular-dependency';
+  IssueType2['DocDrift'] = 'doc-drift';
+  IssueType2['NamingInconsistency'] = 'naming-inconsistency';
+  IssueType2['NamingQuality'] = 'naming-quality';
+  IssueType2['ArchitectureInconsistency'] = 'architecture-inconsistency';
+  IssueType2['DeadCode'] = 'dead-code';
+  IssueType2['MissingTypes'] = 'missing-types';
+  IssueType2['MagicLiteral'] = 'magic-literal';
+  IssueType2['BooleanTrap'] = 'boolean-trap';
+  IssueType2['AiSignalClarity'] = 'ai-signal-clarity';
+  IssueType2['LowTestability'] = 'low-testability';
+  IssueType2['AgentNavigationFailure'] = 'agent-navigation-failure';
+  IssueType2['AmbiguousApi'] = 'ambiguous-api';
+  IssueType2['ChangeAmplification'] = 'change-amplification';
   return IssueType2;
 })(IssueType || {});
 var IssueTypeSchema = z.nativeEnum(IssueType);
 var AnalysisStatus = /* @__PURE__ */ ((AnalysisStatus2) => {
-  AnalysisStatus2["Processing"] = "processing";
-  AnalysisStatus2["Completed"] = "completed";
-  AnalysisStatus2["Failed"] = "failed";
+  AnalysisStatus2['Processing'] = 'processing';
+  AnalysisStatus2['Completed'] = 'completed';
+  AnalysisStatus2['Failed'] = 'failed';
   return AnalysisStatus2;
 })(AnalysisStatus || {});
 var AnalysisStatusSchema = z.nativeEnum(AnalysisStatus);
 var ModelTier = /* @__PURE__ */ ((ModelTier2) => {
-  ModelTier2["Compact"] = "compact";
-  ModelTier2["Standard"] = "standard";
-  ModelTier2["Extended"] = "extended";
-  ModelTier2["Frontier"] = "frontier";
+  ModelTier2['Compact'] = 'compact';
+  ModelTier2['Standard'] = 'standard';
+  ModelTier2['Extended'] = 'extended';
+  ModelTier2['Frontier'] = 'frontier';
   return ModelTier2;
 })(ModelTier || {});
 var ModelTierSchema = z.nativeEnum(ModelTier);
@@ -82,14 +82,14 @@ var LocationSchema = z.object({
   line: z.number(),
   column: z.number().optional(),
   endLine: z.number().optional(),
-  endColumn: z.number().optional()
+  endColumn: z.number().optional(),
 });
 var IssueSchema = z.object({
   type: IssueTypeSchema,
   severity: SeveritySchema,
   message: z.string(),
   location: LocationSchema,
-  suggestion: z.string().optional()
+  suggestion: z.string().optional(),
 });
 var MetricsSchema = z.object({
   tokenCost: z.number().optional(),
@@ -109,117 +109,128 @@ var MetricsSchema = z.object({
   comprehensionDifficultyIndex: z.number().optional(),
   // Extended metrics for specific spokes
   totalSymbols: z.number().optional(),
-  totalExports: z.number().optional()
+  totalExports: z.number().optional(),
 });
 var AnalysisResultSchema = z.object({
   fileName: z.string(),
   issues: z.array(IssueSchema),
-  metrics: MetricsSchema
+  metrics: MetricsSchema,
 });
-var SpokeSummarySchema = z.object({
-  totalFiles: z.number().optional(),
-  totalIssues: z.number().optional(),
-  criticalIssues: z.number().optional(),
-  majorIssues: z.number().optional(),
-  score: z.number().optional()
-}).catchall(z.any());
+var SpokeSummarySchema = z
+  .object({
+    totalFiles: z.number().optional(),
+    totalIssues: z.number().optional(),
+    criticalIssues: z.number().optional(),
+    majorIssues: z.number().optional(),
+    score: z.number().optional(),
+  })
+  .catchall(z.any());
 var SpokeOutputSchema = z.object({
   results: z.array(AnalysisResultSchema),
   summary: SpokeSummarySchema,
-  metadata: z.object({
-    toolName: z.string(),
-    version: z.string().optional(),
-    timestamp: z.string().optional()
-  }).catchall(z.any()).optional()
+  metadata: z
+    .object({
+      toolName: z.string(),
+      version: z.string().optional(),
+      timestamp: z.string().optional(),
+    })
+    .catchall(z.any())
+    .optional(),
 });
-var UnifiedReportSchema = z.object({
-  summary: z.object({
-    totalFiles: z.number(),
-    totalIssues: z.number(),
-    criticalIssues: z.number(),
-    majorIssues: z.number()
-  }),
-  results: z.array(AnalysisResultSchema),
-  scoring: z.object({
-    overall: z.number(),
-    rating: z.string(),
-    timestamp: z.string(),
-    breakdown: z.array(
-      z.object({
-        toolName: z.union([ToolNameSchema, z.string()]),
-        score: z.number()
-      }).catchall(z.any())
-    )
-  }).optional()
-}).catchall(z.any());
+var UnifiedReportSchema = z
+  .object({
+    summary: z.object({
+      totalFiles: z.number(),
+      totalIssues: z.number(),
+      criticalIssues: z.number(),
+      majorIssues: z.number(),
+    }),
+    results: z.array(AnalysisResultSchema),
+    scoring: z
+      .object({
+        overall: z.number(),
+        rating: z.string(),
+        timestamp: z.string(),
+        breakdown: z.array(
+          z
+            .object({
+              toolName: z.union([ToolNameSchema, z.string()]),
+              score: z.number(),
+            })
+            .catchall(z.any())
+        ),
+      })
+      .optional(),
+  })
+  .catchall(z.any());
 
 // src/types/language.ts
 var Language = /* @__PURE__ */ ((Language2) => {
-  Language2["TypeScript"] = "typescript";
-  Language2["JavaScript"] = "javascript";
-  Language2["Python"] = "python";
-  Language2["Java"] = "java";
-  Language2["Go"] = "go";
-  Language2["Rust"] = "rust";
-  Language2["CSharp"] = "csharp";
+  Language2['TypeScript'] = 'typescript';
+  Language2['JavaScript'] = 'javascript';
+  Language2['Python'] = 'python';
+  Language2['Java'] = 'java';
+  Language2['Go'] = 'go';
+  Language2['Rust'] = 'rust';
+  Language2['CSharp'] = 'csharp';
   return Language2;
 })(Language || {});
 var LANGUAGE_EXTENSIONS = {
-  ".ts": "typescript" /* TypeScript */,
-  ".tsx": "typescript" /* TypeScript */,
-  ".js": "javascript" /* JavaScript */,
-  ".jsx": "javascript" /* JavaScript */,
-  ".py": "python" /* Python */,
-  ".java": "java" /* Java */,
-  ".go": "go" /* Go */,
-  ".rs": "rust" /* Rust */,
-  ".cs": "csharp" /* CSharp */
+  '.ts': 'typescript' /* TypeScript */,
+  '.tsx': 'typescript' /* TypeScript */,
+  '.js': 'javascript' /* JavaScript */,
+  '.jsx': 'javascript' /* JavaScript */,
+  '.py': 'python' /* Python */,
+  '.java': 'java' /* Java */,
+  '.go': 'go' /* Go */,
+  '.rs': 'rust' /* Rust */,
+  '.cs': 'csharp' /* CSharp */,
 };
 var ParseError = class extends Error {
   constructor(message, filePath, loc) {
     super(message);
     this.filePath = filePath;
     this.loc = loc;
-    this.name = "ParseError";
+    this.name = 'ParseError';
   }
 };
 
 // src/scoring.ts
 var DEFAULT_TOOL_WEIGHTS = {
-  ["pattern-detect" /* PatternDetect */]: 22,
-  ["context-analyzer" /* ContextAnalyzer */]: 19,
-  ["naming-consistency" /* NamingConsistency */]: 14,
-  ["ai-signal-clarity" /* AiSignalClarity */]: 11,
-  ["agent-grounding" /* AgentGrounding */]: 10,
-  ["testability-index" /* TestabilityIndex */]: 10,
-  ["doc-drift" /* DocDrift */]: 8,
-  ["dependency-health" /* DependencyHealth */]: 6,
-  ["change-amplification" /* ChangeAmplification */]: 8
+  ['pattern-detect' /* PatternDetect */]: 22,
+  ['context-analyzer' /* ContextAnalyzer */]: 19,
+  ['naming-consistency' /* NamingConsistency */]: 14,
+  ['ai-signal-clarity' /* AiSignalClarity */]: 11,
+  ['agent-grounding' /* AgentGrounding */]: 10,
+  ['testability-index' /* TestabilityIndex */]: 10,
+  ['doc-drift' /* DocDrift */]: 8,
+  ['dependency-health' /* DependencyHealth */]: 6,
+  ['change-amplification' /* ChangeAmplification */]: 8,
 };
 var TOOL_NAME_MAP = {
-  patterns: "pattern-detect" /* PatternDetect */,
-  "pattern-detect": "pattern-detect" /* PatternDetect */,
-  context: "context-analyzer" /* ContextAnalyzer */,
-  "context-analyzer": "context-analyzer" /* ContextAnalyzer */,
-  consistency: "naming-consistency" /* NamingConsistency */,
-  "naming-consistency": "naming-consistency" /* NamingConsistency */,
-  "ai-signal": "ai-signal-clarity" /* AiSignalClarity */,
-  "ai-signal-clarity": "ai-signal-clarity" /* AiSignalClarity */,
-  grounding: "agent-grounding" /* AgentGrounding */,
-  "agent-grounding": "agent-grounding" /* AgentGrounding */,
-  testability: "testability-index" /* TestabilityIndex */,
-  "testability-index": "testability-index" /* TestabilityIndex */,
-  "doc-drift": "doc-drift" /* DocDrift */,
-  "deps-health": "dependency-health" /* DependencyHealth */,
-  "dependency-health": "dependency-health" /* DependencyHealth */,
-  "change-amp": "change-amplification" /* ChangeAmplification */,
-  "change-amplification": "change-amplification" /* ChangeAmplification */
+  patterns: 'pattern-detect' /* PatternDetect */,
+  'pattern-detect': 'pattern-detect' /* PatternDetect */,
+  context: 'context-analyzer' /* ContextAnalyzer */,
+  'context-analyzer': 'context-analyzer' /* ContextAnalyzer */,
+  consistency: 'naming-consistency' /* NamingConsistency */,
+  'naming-consistency': 'naming-consistency' /* NamingConsistency */,
+  'ai-signal': 'ai-signal-clarity' /* AiSignalClarity */,
+  'ai-signal-clarity': 'ai-signal-clarity' /* AiSignalClarity */,
+  grounding: 'agent-grounding' /* AgentGrounding */,
+  'agent-grounding': 'agent-grounding' /* AgentGrounding */,
+  testability: 'testability-index' /* TestabilityIndex */,
+  'testability-index': 'testability-index' /* TestabilityIndex */,
+  'doc-drift': 'doc-drift' /* DocDrift */,
+  'deps-health': 'dependency-health' /* DependencyHealth */,
+  'dependency-health': 'dependency-health' /* DependencyHealth */,
+  'change-amp': 'change-amplification' /* ChangeAmplification */,
+  'change-amplification': 'change-amplification' /* ChangeAmplification */,
 };
 var CONTEXT_TIER_THRESHOLDS = {
   compact: { idealTokens: 3e3, criticalTokens: 1e4, idealDepth: 4 },
   standard: { idealTokens: 5e3, criticalTokens: 15e3, idealDepth: 5 },
   extended: { idealTokens: 15e3, criticalTokens: 5e4, idealDepth: 7 },
-  frontier: { idealTokens: 5e4, criticalTokens: 15e4, idealDepth: 10 }
+  frontier: { idealTokens: 5e4, criticalTokens: 15e4, idealDepth: 10 },
 };
 var SIZE_ADJUSTED_THRESHOLDS = {
   xs: 80,
@@ -230,20 +241,21 @@ var SIZE_ADJUSTED_THRESHOLDS = {
   // 200-500 files
   large: 65,
   // 500-2000 files
-  enterprise: 58
+  enterprise: 58,
   // 2000+ files
 };
 function getProjectSizeTier(fileCount) {
-  if (fileCount < 50) return "xs";
-  if (fileCount < 200) return "small";
-  if (fileCount < 500) return "medium";
-  if (fileCount < 2e3) return "large";
-  return "enterprise";
+  if (fileCount < 50) return 'xs';
+  if (fileCount < 200) return 'small';
+  if (fileCount < 500) return 'medium';
+  if (fileCount < 2e3) return 'large';
+  return 'enterprise';
 }
-function getRecommendedThreshold(fileCount, modelTier = "standard") {
+function getRecommendedThreshold(fileCount, modelTier = 'standard') {
   const sizeTier = getProjectSizeTier(fileCount);
   const base = SIZE_ADJUSTED_THRESHOLDS[sizeTier];
-  const modelBonus = modelTier === "frontier" ? -3 : modelTier === "extended" ? -2 : 0;
+  const modelBonus =
+    modelTier === 'frontier' ? -3 : modelTier === 'extended' ? -2 : 0;
   return base + modelBonus;
 }
 function normalizeToolName(shortName) {
@@ -257,9 +269,9 @@ function getToolWeight(toolName, toolConfig, cliOverride) {
 function parseWeightString(weightStr) {
   const weights = /* @__PURE__ */ new Map();
   if (!weightStr) return weights;
-  const pairs = weightStr.split(",");
+  const pairs = weightStr.split(',');
   for (const pair of pairs) {
-    const [toolShortName, weightStr2] = pair.split(":");
+    const [toolShortName, weightStr2] = pair.split(':');
     if (toolShortName && weightStr2) {
       const toolName = normalizeToolName(toolShortName.trim());
       const weight = parseInt(weightStr2.trim(), 10);
@@ -272,13 +284,14 @@ function parseWeightString(weightStr) {
 }
 function calculateOverallScore(toolOutputs, config, cliWeights) {
   if (toolOutputs.size === 0) {
-    throw new Error("No tool outputs provided for scoring");
+    throw new Error('No tool outputs provided for scoring');
   }
   const weights = /* @__PURE__ */ new Map();
   for (const [toolName] of toolOutputs.entries()) {
     const cliWeight = cliWeights?.get(toolName);
     const configWeight = config?.tools?.[toolName]?.scoreWeight;
-    const weight = cliWeight ?? configWeight ?? DEFAULT_TOOL_WEIGHTS[toolName] ?? 5;
+    const weight =
+      cliWeight ?? configWeight ?? DEFAULT_TOOL_WEIGHTS[toolName] ?? 5;
     weights.set(toolName, weight);
   }
   let weightedSum = 0;
@@ -302,44 +315,44 @@ function calculateOverallScore(toolOutputs, config, cliWeights) {
       return `(${output.score} \xD7 ${w})`;
     }
   );
-  const formulaStr = `[${formulaParts.join(" + ")}] / ${totalWeight} = ${overall}`;
+  const formulaStr = `[${formulaParts.join(' + ')}] / ${totalWeight} = ${overall}`;
   return {
     overall,
     rating,
-    timestamp: (/* @__PURE__ */ new Date()).toISOString(),
+    timestamp: /* @__PURE__ */ new Date().toISOString(),
     toolsUsed,
     breakdown,
     calculation: {
       formula: formulaStr,
       weights: calculationWeights,
-      normalized: formulaStr
-    }
+      normalized: formulaStr,
+    },
   };
 }
 function getRating(score) {
-  if (score >= 90) return "Excellent";
-  if (score >= 75) return "Good";
-  if (score >= 60) return "Fair";
-  if (score >= 40) return "Needs Work";
-  return "Critical";
+  if (score >= 90) return 'Excellent';
+  if (score >= 75) return 'Good';
+  if (score >= 60) return 'Fair';
+  if (score >= 40) return 'Needs Work';
+  return 'Critical';
 }
-function getRatingWithContext(score, fileCount, modelTier = "standard") {
+function getRatingWithContext(score, fileCount, modelTier = 'standard') {
   const threshold = getRecommendedThreshold(fileCount, modelTier);
   const normalized = score - threshold + 70;
   return getRating(normalized);
 }
 function getRatingDisplay(rating) {
   switch (rating) {
-    case "Excellent":
-      return { emoji: "\u2705", color: "green" };
-    case "Good":
-      return { emoji: "\u{1F44D}", color: "blue" };
-    case "Fair":
-      return { emoji: "\u26A0\uFE0F", color: "yellow" };
-    case "Needs Work":
-      return { emoji: "\u{1F528}", color: "orange" };
-    case "Critical":
-      return { emoji: "\u274C", color: "red" };
+    case 'Excellent':
+      return { emoji: '\u2705', color: 'green' };
+    case 'Good':
+      return { emoji: '\u{1F44D}', color: 'blue' };
+    case 'Fair':
+      return { emoji: '\u26A0\uFE0F', color: 'yellow' };
+    case 'Needs Work':
+      return { emoji: '\u{1F528}', color: 'orange' };
+    case 'Critical':
+      return { emoji: '\u274C', color: 'red' };
   }
 }
 function formatScore(result) {
@@ -354,17 +367,22 @@ function formatToolScore(output) {
     result += `  Factors:
 `;
     output.factors.forEach((factor) => {
-      const impactSign = factor.impact > 0 ? "+" : "";
+      const impactSign = factor.impact > 0 ? '+' : '';
       result += `    \u2022 ${factor.name}: ${impactSign}${factor.impact} - ${factor.description}
 `;
     });
-    result += "\n";
+    result += '\n';
   }
   if (output.recommendations && output.recommendations.length > 0) {
     result += `  Recommendations:
 `;
     output.recommendations.forEach((rec, i) => {
-      const priorityIcon = rec.priority === "high" ? "\u{1F534}" : rec.priority === "medium" ? "\u{1F7E1}" : "\u{1F535}";
+      const priorityIcon =
+        rec.priority === 'high'
+          ? '\u{1F534}'
+          : rec.priority === 'medium'
+            ? '\u{1F7E1}'
+            : '\u{1F535}';
       result += `    ${i + 1}. ${priorityIcon} ${rec.action}
 `;
       result += `       Impact: +${rec.estimatedImpact} points
@@ -578,5 +596,5 @@ export {
   getRatingDisplay,
   formatScore,
   formatToolScore,
-  generateHTML
+  generateHTML,
 };