@aiready/core 0.21.21 → 0.22.1

package/dist/index.mjs

@@ -20,7 +20,9 @@ import {
   ParseError,
   ReadinessRating,
   RecommendationPriority,
+  SCORING_PROFILES,
   SIZE_ADJUSTED_THRESHOLDS,
+  ScoringProfile,
   Severity,
   SeveritySchema,
   SpokeOutputSchema,
@@ -41,7 +43,7 @@ import {
   getToolWeight,
   normalizeToolName,
   parseWeightString
-} from "./chunk-SWTDBVYJ.mjs";
+} from "./chunk-5HIXDC3X.mjs";
 
 // src/types/contract.ts
 function validateSpokeOutput(toolName, output) {
@@ -3300,6 +3302,8 @@ function calculateAiSignalClarity(params) {
     deepCallbacks,
     ambiguousNames,
     undocumentedExports,
+    largeFiles = 0,
+    // Default to 0 to prevent NaN
     totalSymbols,
     totalExports
   } = params;
@@ -3316,28 +3320,35 @@ function calculateAiSignalClarity(params) {
   const overloadSignal = {
     name: "Symbol Overloading",
     count: overloadedSymbols,
-    riskContribution: Math.round(Math.min(1, overloadRatio) * 100 * 0.25),
+    riskContribution: Math.round(Math.min(1, overloadRatio) * 100 * 0.2),
     description: `${overloadedSymbols} overloaded symbols \u2014 AI picks wrong signature`
   };
+  const largeFileSignal = {
+    name: "Large Files",
+    count: largeFiles,
+    riskContribution: Math.round(Math.min(5, largeFiles) * 5),
+    // up to 25 points
+    description: `${largeFiles} large files \u2014 pushing AI context limits`
+  };
   const magicRatio = magicLiterals / Math.max(1, totalSymbols * 2);
   const magicSignal = {
     name: "Magic Literals",
     count: magicLiterals,
-    riskContribution: Math.round(Math.min(1, magicRatio) * 100 * 0.2),
+    riskContribution: Math.round(Math.min(1, magicRatio) * 100 * 0.15),
     description: `${magicLiterals} unnamed constants \u2014 AI invents wrong values`
   };
   const trapRatio = booleanTraps / Math.max(1, totalSymbols);
   const trapSignal = {
     name: "Boolean Traps",
     count: booleanTraps,
-    riskContribution: Math.round(Math.min(1, trapRatio) * 100 * 0.2),
+    riskContribution: Math.round(Math.min(1, trapRatio) * 100 * 0.15),
     description: `${booleanTraps} boolean trap parameters \u2014 AI inverts intent`
   };
   const sideEffectRatio = implicitSideEffects / Math.max(1, totalExports);
   const sideEffectSignal = {
     name: "Implicit Side Effects",
     count: implicitSideEffects,
-    riskContribution: Math.round(Math.min(1, sideEffectRatio) * 100 * 0.15),
+    riskContribution: Math.round(Math.min(1, sideEffectRatio) * 100 * 0.1),
     description: `${implicitSideEffects} functions with implicit side effects \u2014 AI misses contracts`
   };
   const callbackRatio = deepCallbacks / Math.max(1, totalSymbols * 0.1);
@@ -3351,18 +3362,19 @@ function calculateAiSignalClarity(params) {
   const ambiguousSignal = {
     name: "Ambiguous Names",
     count: ambiguousNames,
-    riskContribution: Math.round(Math.min(1, ambiguousRatio) * 100 * 0.1),
+    riskContribution: Math.round(Math.min(1, ambiguousRatio) * 100 * 0.05),
     description: `${ambiguousNames} non-descriptive identifiers \u2014 AI guesses wrong intent`
   };
   const undocRatio = undocumentedExports / Math.max(1, totalExports);
   const undocSignal = {
     name: "Undocumented Exports",
     count: undocumentedExports,
-    riskContribution: Math.round(Math.min(1, undocRatio) * 100 * 0.1),
+    riskContribution: Math.round(Math.min(1, undocRatio) * 100 * 0.05),
     description: `${undocumentedExports} public functions without docs \u2014 AI fabricates behavior`
   };
   const signals = [
     overloadSignal,
+    largeFileSignal,
     magicSignal,
     trapSignal,
     sideEffectSignal,
@@ -3385,6 +3397,10 @@ function calculateAiSignalClarity(params) {
   );
   const topRisk = topSignal.riskContribution > 0 ? topSignal.description : "No significant issues detected";
   const recommendations = [];
+  if (largeFileSignal.riskContribution > 5)
+    recommendations.push(
+      `Split ${largeFiles} large files (> 500 lines) into smaller, single-responsibility modules`
+    );
   if (overloadSignal.riskContribution > 5)
     recommendations.push(
       `Rename ${overloadedSymbols} overloaded symbols to unique, intent-revealing names`
@@ -4020,6 +4036,46 @@ function getRepoMetadata(directory) {
   }
   return metadata;
 }
+
+// src/utils/github-utils.ts
+function emitAnnotation(params) {
+  const { level, file, line, col, title, message } = params;
+  const parts = [];
+  if (file) parts.push(`file=${file}`);
+  if (line) parts.push(`line=${line}`);
+  if (col) parts.push(`col=${col}`);
+  if (title) parts.push(`title=${title}`);
+  const metadata = parts.length > 0 ? ` ${parts.join(",")}` : "";
+  console.log(`::${level}${metadata}::${message.replace(/\n/g, "%0A")}`);
+}
+function severityToAnnotationLevel(severity) {
+  switch (severity.toLowerCase()) {
+    case "critical":
+    case "high-risk":
+    case "blind-risk":
+      return "error";
+    case "major":
+    case "moderate-risk":
+      return "warning";
+    case "minor":
+    case "info":
+    case "safe":
+    default:
+      return "notice";
+  }
+}
+function emitIssuesAsAnnotations(issues) {
+  issues.forEach((issue) => {
+    emitAnnotation({
+      level: severityToAnnotationLevel(issue.severity || "info"),
+      file: issue.file || issue.fileName || "",
+      line: issue.line || issue.location?.start?.line,
+      col: issue.column || issue.location?.start?.column,
+      title: `${issue.tool || "AIReady"}: ${issue.type || "Issue"}`,
+      message: issue.message || issue.description || "No description provided"
+    });
+  });
+}
 export {
   AnalysisResultSchema,
   AnalysisStatus,
@@ -4050,8 +4106,10 @@ export {
   PythonParser,
   ReadinessRating,
   RecommendationPriority,
+  SCORING_PROFILES,
   SEVERITY_TIME_ESTIMATES,
   SIZE_ADJUSTED_THRESHOLDS,
+  ScoringProfile,
   Severity,
   SeveritySchema,
   SpokeOutputSchema,
@@ -4086,6 +4144,8 @@ export {
   calculateTestabilityIndex,
   calculateTokenBudget,
   clearHistory,
+  emitAnnotation,
+  emitIssuesAsAnnotations,
   emitProgress,
   estimateCostFromBudget,
   estimateTokens,
@@ -4139,6 +4199,7 @@ export {
   scanEntries,
   scanFiles,
   setupParser,
+  severityToAnnotationLevel,
   validateSpokeOutput,
   validateWithSchema
 };

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@aiready/core",
-  "version": "0.21.21",
+  "version": "0.22.1",
   "description": "Shared utilities for AIReady analysis tools",
   "main": "./dist/index.js",
   "module": "./dist/index.mjs",