All files / src scoring.ts

100% Statements 4/4
100% Branches 0/0
100% Functions 1/1
100% Lines 4/4

Press n or j to go to the next uncovered block, b, p or k for the previous block.

1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 21 22 23 24 25 26 27 28 29 30 31 32 33 34 35 36 37 38 39 40 41 42 43 44 45 46 47 48 49 50 51 52 53 54 55 56 57 58 59 60 61                                    3x   3x                           3x   3x                                                
import {
  calculateAiSignalClarity,
  ToolName,
  buildStandardToolScore,
} from '@aiready/core';
import type { ToolScoringOutput } from '@aiready/core';
import type { AiSignalClarityReport } from './types';
 
/**
 * Convert AI signal clarity report into a ToolScoringOutput
 * suitable for inclusion in the unified AIReady score.
 *
 * Note: The risk score from core is 0-100 where higher = more risk.
 * We invert it so the spoke score is 0-100 where higher = better.
 */
export function calculateAiSignalClarityScore(
  report: AiSignalClarityReport
): ToolScoringOutput {
  const { aggregateSignals } = report;
 
  const riskResult = calculateAiSignalClarity({
    overloadedSymbols: aggregateSignals.overloadedSymbols,
    magicLiterals: aggregateSignals.magicLiterals,
    booleanTraps: aggregateSignals.booleanTraps,
    implicitSideEffects: aggregateSignals.implicitSideEffects,
    deepCallbacks: aggregateSignals.deepCallbacks,
    ambiguousNames: aggregateSignals.ambiguousNames,
    undocumentedExports: aggregateSignals.undocumentedExports,
    largeFiles: aggregateSignals.largeFiles,
    totalSymbols: Math.max(1, aggregateSignals.totalSymbols),
    totalExports: Math.max(1, aggregateSignals.totalExports),
  });
 
  // Invert: high risk = low score
  const score = Math.max(0, 100 - riskResult.score);
 
  return buildStandardToolScore({
    toolName: ToolName.AiSignalClarity,
    score,
    rawData: {
      riskScore: riskResult.score,
      rating: riskResult.rating,
      topRisk: riskResult.topRisk,
      ...aggregateSignals,
    },
    dimensions: riskResult.dimensions,
    dimensionNames: {
      overloadingScore: 'Symbol Overloading',
      magicLiteralScore: 'Magic Literals',
      booleanTrapScore: 'Boolean Traps',
      implicitSideEffectScore: 'Implicit Side Effects',
      deepCallbackScore: 'Deep Callbacks',
      ambiguityScore: 'Naming Ambiguity',
      documentationScore: 'API Documentation',
      sizeScore: 'File Sizing',
    },
    recommendations: riskResult.recommendations,
    rating: riskResult.rating,
  });
}