ranking.ts

export type RankingFeatures = {
  relevanceScore: number;
  venueScore: number;
  citationScore: number;
  recencyScore: number;
  surveyFoundationScore: number;
  crossDomainScore: number;
  domainProfileBoost: number;
};

export type RankingBreakdown = RankingFeatures & {
  finalScore: number;
  reasons: string[];
  readingLevel: "starter" | "advanced" | "frontier";
};

const clamp = (value: number) => Math.max(0, Math.min(1, value));

export function calculateImportanceScore(features: RankingFeatures): RankingBreakdown {
  const normalized: RankingFeatures = {
    relevanceScore: clamp(features.relevanceScore),
    venueScore: clamp(features.venueScore),
    citationScore: clamp(features.citationScore),
    recencyScore: clamp(features.recencyScore),
    surveyFoundationScore: clamp(features.surveyFoundationScore),
    crossDomainScore: clamp(features.crossDomainScore),
    domainProfileBoost: clamp(features.domainProfileBoost)
  };

  const finalScore = Number(
    (
      100 *
      (0.3 * normalized.relevanceScore +
        0.22 * normalized.venueScore +
        0.16 * normalized.citationScore +
        0.1 * normalized.recencyScore +
        0.1 * normalized.surveyFoundationScore +
        0.07 * normalized.crossDomainScore +
        0.05 * normalized.domainProfileBoost)
    ).toFixed(1)
  );

  const reasons: string[] = [];

  if (normalized.relevanceScore > 0.82) reasons.push("Strong thematic match to the survey query");
  if (normalized.venueScore > 0.9) reasons.push("Published in a high-authority venue for the selected domain");
  if (normalized.citationScore > 0.75) reasons.push("Strong citation signal relative to peer papers");
  if (normalized.recencyScore > 0.8) reasons.push("Recent enough for frontier tracking");
  if (normalized.surveyFoundationScore > 0.75) reasons.push("Likely survey, benchmark, or foundational work");
  if (normalized.crossDomainScore > 0.65) reasons.push("Covers multiple selected domains");
  if (normalized.domainProfileBoost > 0.7) reasons.push("Boosted by built-in domain profile priorities");

  const readingLevel =
    normalized.surveyFoundationScore > 0.8 || normalized.venueScore > 0.9
      ? "starter"
      : normalized.recencyScore > 0.8
        ? "frontier"
        : "advanced";

  return {
    ...normalized,
    finalScore,
    reasons,
    readingLevel
  };
}