kyd-shared-badge 0.2.26 → 0.2.28

package/src/types.ts

@@ -134,6 +134,27 @@ export interface IpRiskAnalysis {
     countries?: string[];
 }
 
+export interface CSLDetails {
+  name: string;
+  description: string;
+  url: string;
+}
+
+export interface FBIWantedDetails {
+  name: string;
+  description: string;
+  url: string;
+}
+
+export interface FBIWantedMatch {
+  uid: string;
+  title: string;
+  url: string;
+  justification: string;
+  // eslint-disable-next-line @typescript-eslint/no-explicit-any
+  raw_result: any;
+}
+
 export interface AssessmentResult {
   report_summary?: string;
   recommendations: {
@@ -142,12 +163,15 @@ export interface AssessmentResult {
   };
   developer_trust_explanation?: string;
   industry_considerations?: string;
-  ai_usage_summary: {
-    explanation?: string;
-    key_findings?: string[];
-    files_with_ai_findings?: number;
-    files_analyzed?: number;
-  } | null;
+    
+  ai_usage_summary?: {
+    explanation: string;
+    key_findings: string[];
+    files_with_ai_findings: number;
+    files_analyzed: number;
+    files_with_disclosure: number;
+    transparency_score: number;
+  };
   key_skills?: string[];
   summary_scores?: {
     developer_trust?: SummaryScore;
@@ -168,19 +192,38 @@ export interface AssessmentResult {
     ofac_screen?: {
       checked?: boolean;
       sources?: string[];
-      matches?: any[];
+      matches?: {
+        sanction: {
+          source: string;
+          name: string;
+          url: string;
+          programs: string[];
+          entityLink: string;
+        };
+        uid: string;
+        title: string;
+        url: string;
+        justification: string;
+        // eslint-disable-next-line @typescript-eslint/no-explicit-any
+        raw_result: any;
+      }[];
+      // eslint-disable-next-line @typescript-eslint/no-explicit-any
       raw?: any;
     };
     sanctions_sources_detailed?: { issuingEntity: string; listName: string; matched?: boolean; sublists?: string[] }[];
     sanctions_sublists?: string[];
-    csl_details?: any;
-    fbi_matches?: any[];
+    csl_details?: CSLDetails;
+    fbi_details?: FBIWantedDetails;
+    fbi_matches?: FBIWantedMatch[];
   };
   top_contributing_rules?: TopContributingRule[];
   rules_graph_s3_key?: string;
-  rules_digest?: any;
   optOutScreening?: boolean;
   clientMetadata?: ClientMetadata;
+  scoring_summary?: ScoringSummary;
+  skills_matrix?: SkillsMatrix;
+  skills_all?: SkillsAll;
+  graph_insights?: GraphInsightsPayload;
 }
 
 export interface ClientMetadata {
@@ -192,6 +235,156 @@ export interface ClientMetadata {
   referrer: string;
 }
 
+// --- Scoring Summary (from rules engine) ---
+export interface ScoringSummaryConfig {
+  coldstart_fraction?: number;
+  system_weights?: { [k: string]: number };
+  genre_mapping?: { [genre: string]: string[] };
+}
+
+export interface ScoreBreakdownTotals {
+  applied?: number;
+  applied_signed?: number;
+  theoretical?: number;
+  coldstart?: number;
+  percent_progress?: number; // 0-100
+  percent_progress_signed?: number; // -100 to 100
+  percent_coldstart_over_final?: number | null;
+}
+
+export interface ScoreBreakdown {
+  categories?: {
+    [category: string]: {
+      applied?: number;
+      applied_signed?: number;
+      theoretical?: number;
+      coldstart?: number;
+      percent_progress?: number;
+      percent_progress_signed?: number;
+      percent_coldstart_over_final?: number | null;
+    };
+  };
+  totals?: ScoreBreakdownTotals;
+}
+
+export interface GenreScoreEntry {
+  categories: string[];
+  atomic: ScoreBreakdownTotals & {};
+  business: ScoreBreakdownTotals & {};
+  combined: { percent_progress?: number; percent_progress_signed?: number; percent_coldstart_over_final?: number | null };
+}
+
+export interface ScoringSummary {
+  config?: ScoringSummaryConfig;
+  overall?: {
+    atomic?: ScoreBreakdownTotals;
+    business?: ScoreBreakdownTotals;
+    combined?: { percent_progress?: number; percent_progress_signed?: number; percent_coldstart_over_final?: number | null };
+  };
+  genres?: { [genre: string]: GenreScoreEntry };
+  category_scores?: {
+    [category: string]: {
+      atomic?: { percent_progress?: number; percent_progress_signed?: number } & Partial<ScoreBreakdownTotals>;
+      business?: { percent_progress?: number; percent_progress_signed?: number } & Partial<ScoreBreakdownTotals>;
+      combined?: { percent_progress?: number; percent_progress_signed?: number };
+    };
+  };
+}
+
+// Graph insights payload rendered by GraphInsights and used in SharedBadgeDisplay
+export type CategoryTopBusinessItem = {
+  label?: string;
+  rule_label?: string;
+  provider?: string;
+  weight?: number;
+};
+
+export interface GraphInsightsPayload {
+  providers?: Array<{
+    name: string;
+    scores?: { atomic?: number; business?: number; total?: number };
+    errorCount?: number;
+  }>;
+  categoryAggregate?: Array<{
+    category: string;
+    applied_weight_sum?: number;
+  }>;
+  // New: per-category percent score (0-100) from rules_engine scoring_summary
+  categoryScoresPercent?: Array<{
+    category: string;
+    percent?: number; // 0-100
+  }>;
+  sanctions?: {
+    ofacMatches?: number;
+    fbiMatches?: number;
+    cslMatched?: boolean;
+  };
+  ipRisk?: { phase?: 'NO_MATCH' | 'POSSIBLE_MATCH' | 'POSITIVE_MATCH' | string };
+  categoryTopBusiness?: { [category: string]: CategoryTopBusinessItem[] };
+  domainAffiliations?: { checkedCount?: number };
+  // New: Skills category radar data
+  skillsCategoryRadar?: Array<{
+    axis: string;
+    observed?: number; // 0-100
+    self_reported?: number; // 0-100
+    certified?: number; // 0-100
+  }>;
+  // New: Flattened list of business rule selections (for appendix)
+  business_rules_all?: Array<{
+    provider: string;
+    category?: string;
+    label?: string;
+    group_id?: string;
+    uid?: string;
+    likert_label?: string;
+    likert_value?: number;
+    weight?: number;
+  }>;
+  // New: Compact UI summary for top summary cards
+  uiSummary?: {
+    technical?: {
+      percent?: number; // 0-100, higher = more evidence
+      label?: string; // e.g., LOW/MODERATE/HIGH EVIDENCE
+      top_movers?: Array<{ label?: string; uid?: string }>;
+    };
+    risk?: {
+      percent_good?: number; // 0-100, higher = lower risk (good)
+      label?: string; // e.g., LOW/MODERATE/HIGH RISK
+      top_movers?: Array<{ label?: string; uid?: string }>;
+    };
+  };
+  ai_usage_summary: {
+    explanation: string;
+    key_findings: string[];
+    files_with_ai_findings: number;
+    files_analyzed: number;
+    files_with_disclosure?: number;
+    transparency_score: number;
+  }
+}
+
+// Skills matrix
+export interface SkillBucket {
+  present: boolean;
+  evidence?: string;
+  sources?: string[];
+}
+
+export interface SkillRow {
+  name: string;
+  observed: SkillBucket;
+  self_reported: SkillBucket;
+  certified: SkillBucket;
+}
+
+export interface SkillsMatrix {
+  skills: SkillRow[];
+}
+
+export interface SkillsAll {
+  skills: SkillRow[];
+}
+
 export interface ScoresByCategory {
   [category: string]: {
     subtotal: number;
@@ -212,4 +405,23 @@ export interface AnalyzedItem {
   summary: string;
   quality_score?: number;
   professional_score?: number;
-} 
+} 
+
+export interface BusinessRule {
+  provider: string;
+  category: string;
+  label: string;
+  group_id: string;
+  likert_label: string;
+  likert_value: number;
+  weight: number;
+  uid: string;
+}
+
+export interface TopBusinessRule {
+  provider: string;
+  category: string;
+  label: string;
+  weight: number;
+  uid: string;
+}