@ossintel/scoring 0.0.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 turboforge-dev
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -0,0 +1,109 @@
+# @ossintel/scoring <img src="https://raw.githubusercontent.com/mayank1513/mayank1513/main/popper.png" style="height: 40px"/>
+
+<p className="flex gap-2">
+  <a href="https://github.com/mayank1513/ossintel/actions/workflows/ci.yml" rel="noopener noreferrer">
+    <img alt="CI" src="https://github.com/mayank1513/ossintel/actions/workflows/ci.yml/badge.svg" />
+  </a>
+  <a href="https://codecov.io/gh/mayank1513/ossintel/tree/main/packages/@ossintel/scoring" rel="noopener noreferrer">
+    <img alt="codecov" src="https://codecov.io/gh/mayank1513/ossintel/graph/badge.svg?flag=@ossintel/scoring" />
+  </a> 
+  <a href="https://npmjs.com/package/@ossintel/scoring" rel="noopener noreferrer">
+    <img alt="npm version" src="https://img.shields.io/npm/v/@ossintel/scoring" />
+  </a>
+  <a href="https://npmjs.com/package/@ossintel/scoring" rel="noopener noreferrer">
+    <img alt="npm downloads" src="https://img.shields.io/npm/d18m/@ossintel/scoring" />
+  </a>
+  <a href="https://npmjs.com/package/@ossintel/scoring" rel="noopener noreferrer">
+    <img alt="npm bundle size" src="https://img.shields.io/bundlephobia/minzip/@ossintel/scoring" />
+  </a>
+  <img alt="license" src="https://img.shields.io/npm/l/@ossintel/scoring" />
+</p>
+
+> @ossintel/scoring: Deterministic scoring engine for calculating OSS health, impact, risk, activity, and community metrics from normalized repository and ecosystem data.
+
+# @ossintel/scoring
+
+Deterministic OSS scoring engine.
+
+## Purpose
+
+Converts normalized repository and developer metrics into objective scores.
+
+## Responsibilities
+
+Calculate:
+
+- Overall Score
+- Health Score
+- Impact Score
+- Activity Score
+- Community Score
+- Risk Score
+
+## Philosophy
+
+Scores should always be reproducible.
+
+The same inputs should always produce the same outputs.
+
+No AI should participate in score calculation.
+
+## Inputs
+
+Normalized domain models.
+
+## Outputs
+
+```ts
+{
+  overall, health, impact, activity, community, risk;
+}
+```
+
+## Non-goals
+
+- API calls
+- AI
+- Charts
+- UI
+
+## Testing
+
+Every scoring algorithm should have comprehensive unit tests.
+
+No external dependencies should affect score calculation.
+
+---
+
+## ✨ Why @ossintel/scoring?
+
+-
+-
+
+---
+
+## 📦 Installation
+
+```bash
+$ pnpm add @ossintel/scoring
+```
+
+**_or_**
+
+```bash
+$ npm install @ossintel/scoring
+```
+
+**_or_**
+
+```bash
+$ yarn add @ossintel/scoring
+```
+
+## License
+
+This library is licensed under the MIT open-source license.
+
+<hr />
+
+<p align="center">with 💖 by <a href="https://mayankchaudhari.com" target="_blank">Mayank Kumar Chaudhari</a></p>

package/dist/index.d.mts

@@ -0,0 +1,36 @@
+import { NormalizedRepository, NormalizedContributor, NormalizedRelease, NormalizedLanguage } from '@ossintel/github-normalizer';
+
+interface ScoringInputs {
+    repository: NormalizedRepository;
+    contributors?: NormalizedContributor[];
+    releases?: NormalizedRelease[];
+    languages?: NormalizedLanguage[];
+}
+interface RepositoryScores {
+    overall: number;
+    health: number;
+    impact: number;
+    activity: number;
+    community: number;
+    risk: number;
+}
+interface NpmPackageStats {
+    name: string;
+    downloads: number;
+    stars?: number;
+}
+interface IdentityScoringInputs {
+    repositories: NormalizedRepository[];
+    npmPackages?: NpmPackageStats[];
+}
+type IdentityScores = RepositoryScores;
+
+declare const calculateImpactScore: (repository: ScoringInputs["repository"]) => number;
+declare const calculateActivityScore: (repository: ScoringInputs["repository"], releases: ScoringInputs["releases"]) => number;
+declare const calculateCommunityScore: (repository: ScoringInputs["repository"], contributors: ScoringInputs["contributors"]) => number;
+declare const calculateHealthScore: (repository: ScoringInputs["repository"]) => number;
+declare const calculateRiskScore: (repository: ScoringInputs["repository"], contributors: ScoringInputs["contributors"]) => number;
+declare const calculateRepositoryScore: (inputs: ScoringInputs) => RepositoryScores;
+declare const calculateIdentityScore: (inputs: IdentityScoringInputs) => IdentityScores;
+
+export { type IdentityScores, type IdentityScoringInputs, type NpmPackageStats, type RepositoryScores, type ScoringInputs, calculateActivityScore, calculateCommunityScore, calculateHealthScore, calculateIdentityScore, calculateImpactScore, calculateRepositoryScore, calculateRiskScore };

package/dist/index.d.ts

@@ -0,0 +1,36 @@
+import { NormalizedRepository, NormalizedContributor, NormalizedRelease, NormalizedLanguage } from '@ossintel/github-normalizer';
+
+interface ScoringInputs {
+    repository: NormalizedRepository;
+    contributors?: NormalizedContributor[];
+    releases?: NormalizedRelease[];
+    languages?: NormalizedLanguage[];
+}
+interface RepositoryScores {
+    overall: number;
+    health: number;
+    impact: number;
+    activity: number;
+    community: number;
+    risk: number;
+}
+interface NpmPackageStats {
+    name: string;
+    downloads: number;
+    stars?: number;
+}
+interface IdentityScoringInputs {
+    repositories: NormalizedRepository[];
+    npmPackages?: NpmPackageStats[];
+}
+type IdentityScores = RepositoryScores;
+
+declare const calculateImpactScore: (repository: ScoringInputs["repository"]) => number;
+declare const calculateActivityScore: (repository: ScoringInputs["repository"], releases: ScoringInputs["releases"]) => number;
+declare const calculateCommunityScore: (repository: ScoringInputs["repository"], contributors: ScoringInputs["contributors"]) => number;
+declare const calculateHealthScore: (repository: ScoringInputs["repository"]) => number;
+declare const calculateRiskScore: (repository: ScoringInputs["repository"], contributors: ScoringInputs["contributors"]) => number;
+declare const calculateRepositoryScore: (inputs: ScoringInputs) => RepositoryScores;
+declare const calculateIdentityScore: (inputs: IdentityScoringInputs) => IdentityScores;
+
+export { type IdentityScores, type IdentityScoringInputs, type NpmPackageStats, type RepositoryScores, type ScoringInputs, calculateActivityScore, calculateCommunityScore, calculateHealthScore, calculateIdentityScore, calculateImpactScore, calculateRepositoryScore, calculateRiskScore };

package/dist/index.js

@@ -0,0 +1 @@
+"use strict";var M=Object.defineProperty;var x=Object.getOwnPropertyDescriptor;var A=Object.getOwnPropertyNames;var R=Object.prototype.hasOwnProperty;var F=(t,e)=>{for(var o in e)M(t,o,{get:e[o],enumerable:!0})},z=(t,e,o,i)=>{if(e&&typeof e=="object"||typeof e=="function")for(let c of A(e))!R.call(t,c)&&c!==o&&M(t,c,{get:()=>e[c],enumerable:!(i=x(e,c))||i.enumerable});return t};var T=t=>z(M({},"__esModule",{value:!0}),t);var H={};F(H,{calculateActivityScore:()=>C,calculateCommunityScore:()=>w,calculateHealthScore:()=>y,calculateIdentityScore:()=>Y,calculateImpactScore:()=>k,calculateRepositoryScore:()=>v,calculateRiskScore:()=>D});module.exports=T(H);var k=t=>{let e=t.stargazersCount,o=t.forksCount,i=t.watchersCount,c=Math.min(100,Math.log10(e+1)*20),n=Math.min(100,Math.log10(o+1)*25),s=Math.min(100,Math.log10(i+1)*30);return Math.round(c*.5+n*.35+s*.15)},C=(t,e)=>{if(t.isArchived)return 0;let o=new Date,i=new Date(t.pushedAt),c=o.getTime()-i.getTime(),n=Math.max(0,c/(1e3*60*60*24)),s=0;n<=1?s=100:n<=7?s=90:n<=30?s=80:n<=90?s=60:n<=180?s=40:n<=365&&(s=20);let u=50;if(e){let l=new Date;l.setFullYear(o.getFullYear()-1);let p=e.filter(f=>f.publishedAt&&new Date(f.publishedAt)>=l).length;u=Math.min(100,p*20)}return Math.round(s*.6+u*.4)},w=(t,e)=>{let o=e?e.length:0,i=Math.min(100,Math.log10(o+1)*50),c=t.topics.length>0?100:0,n=(t.description?50:0)+(t.homepage?50:0);return Math.round(i*.7+c*.15+n*.15)},y=t=>{if(t.isArchived)return 0;let e=t.stargazersCount+t.forksCount,o=100;if(t.openIssuesCount>0){let l=t.openIssuesCount/(e+10);o=Math.max(0,100-l*500)}let i=new Date(t.updatedAt),c=Date.now()-i.getTime(),n=Math.max(0,c/(1e3*60*60*24)),s=0;n<=30?s=100:n<=90?s=80:n<=180?s=60:n<=365?s=40:s=10;let u=t.isFork?50:100;return Math.round(o*.5+s*.3+u*.2)},D=(t,e)=>{let o=0,i=new Date(t.pushedAt),c=(Date.now()-i.getTime())/(1e3*60*60*24);c>365?o+=30:c>180?o+=20:c>90&&(o+=10);let n=e?e.length:1;n<=1?o+=30:n<=3?o+=20:n<=5&&(o+=10),t.isFork&&(o+=20);let s=t.stargazersCount+t.forksCount;return t.openIssuesCount>50&&t.openIssuesCount>s?o+=20:t.openIssuesCount>20&&(o+=10),Math.min(100,Math.round(o))},v=t=>{let{repository:e,contributors:o,releases:i}=t,c=y(e),n=k(e),s=C(e,i),u=w(e,o),l=D(e,o);return{overall:Math.round(c*.3+n*.25+s*.2+u*.15+(100-l)*.1),health:c,impact:n,activity:s,community:u,risk:l}},Y=t=>{let{repositories:e,npmPackages:o}=t;if(e.length===0)return{overall:0,health:0,impact:0,activity:0,community:0,risk:100};let i=e.reduce((r,a)=>r+a.stargazersCount,0),c=e.reduce((r,a)=>r+a.forksCount,0),n=e.reduce((r,a)=>r+a.watchersCount,0),s=Math.min(100,Math.log10(i+1)*20),u=Math.min(100,Math.log10(c+1)*25),l=Math.min(100,Math.log10(n+1)*30),p=s*.5+u*.35+l*.15;if(o&&o.length>0){let r=o.reduce((h,b)=>h+b.downloads,0),a=Math.min(100,Math.log10(r+1)*15);p=p*.8+a*.2}let f=Math.round(p),I=e.filter(r=>!r.isArchived),m=0,d=0,g=0,S=100;if(I.length>0){let r=I.map(a=>v({repository:a}));m=Math.round(r.reduce((a,h)=>a+h.health,0)/r.length),d=Math.round(r.reduce((a,h)=>a+h.activity,0)/r.length),g=Math.round(r.reduce((a,h)=>a+h.community,0)/r.length),S=Math.round(r.reduce((a,h)=>a+h.risk,0)/r.length)}return{overall:Math.round(m*.3+f*.25+d*.2+g*.15+(100-S)*.1),health:m,impact:f,activity:d,community:g,risk:S}};0&&(module.exports={calculateActivityScore,calculateCommunityScore,calculateHealthScore,calculateIdentityScore,calculateImpactScore,calculateRepositoryScore,calculateRiskScore});

package/dist/index.mjs

@@ -0,0 +1 @@
+var k=t=>{let o=t.stargazersCount,e=t.forksCount,i=t.watchersCount,a=Math.min(100,Math.log10(o+1)*20),n=Math.min(100,Math.log10(e+1)*25),s=Math.min(100,Math.log10(i+1)*30);return Math.round(a*.5+n*.35+s*.15)},C=(t,o)=>{if(t.isArchived)return 0;let e=new Date,i=new Date(t.pushedAt),a=e.getTime()-i.getTime(),n=Math.max(0,a/(1e3*60*60*24)),s=0;n<=1?s=100:n<=7?s=90:n<=30?s=80:n<=90?s=60:n<=180?s=40:n<=365&&(s=20);let u=50;if(o){let l=new Date;l.setFullYear(e.getFullYear()-1);let p=o.filter(f=>f.publishedAt&&new Date(f.publishedAt)>=l).length;u=Math.min(100,p*20)}return Math.round(s*.6+u*.4)},w=(t,o)=>{let e=o?o.length:0,i=Math.min(100,Math.log10(e+1)*50),a=t.topics.length>0?100:0,n=(t.description?50:0)+(t.homepage?50:0);return Math.round(i*.7+a*.15+n*.15)},y=t=>{if(t.isArchived)return 0;let o=t.stargazersCount+t.forksCount,e=100;if(t.openIssuesCount>0){let l=t.openIssuesCount/(o+10);e=Math.max(0,100-l*500)}let i=new Date(t.updatedAt),a=Date.now()-i.getTime(),n=Math.max(0,a/(1e3*60*60*24)),s=0;n<=30?s=100:n<=90?s=80:n<=180?s=60:n<=365?s=40:s=10;let u=t.isFork?50:100;return Math.round(e*.5+s*.3+u*.2)},D=(t,o)=>{let e=0,i=new Date(t.pushedAt),a=(Date.now()-i.getTime())/(1e3*60*60*24);a>365?e+=30:a>180?e+=20:a>90&&(e+=10);let n=o?o.length:1;n<=1?e+=30:n<=3?e+=20:n<=5&&(e+=10),t.isFork&&(e+=20);let s=t.stargazersCount+t.forksCount;return t.openIssuesCount>50&&t.openIssuesCount>s?e+=20:t.openIssuesCount>20&&(e+=10),Math.min(100,Math.round(e))},v=t=>{let{repository:o,contributors:e,releases:i}=t,a=y(o),n=k(o),s=C(o,i),u=w(o,e),l=D(o,e);return{overall:Math.round(a*.3+n*.25+s*.2+u*.15+(100-l)*.1),health:a,impact:n,activity:s,community:u,risk:l}},x=t=>{let{repositories:o,npmPackages:e}=t;if(o.length===0)return{overall:0,health:0,impact:0,activity:0,community:0,risk:100};let i=o.reduce((c,r)=>c+r.stargazersCount,0),a=o.reduce((c,r)=>c+r.forksCount,0),n=o.reduce((c,r)=>c+r.watchersCount,0),s=Math.min(100,Math.log10(i+1)*20),u=Math.min(100,Math.log10(a+1)*25),l=Math.min(100,Math.log10(n+1)*30),p=s*.5+u*.35+l*.15;if(e&&e.length>0){let c=e.reduce((h,I)=>h+I.downloads,0),r=Math.min(100,Math.log10(c+1)*15);p=p*.8+r*.2}let f=Math.round(p),M=o.filter(c=>!c.isArchived),m=0,d=0,g=0,S=100;if(M.length>0){let c=M.map(r=>v({repository:r}));m=Math.round(c.reduce((r,h)=>r+h.health,0)/c.length),d=Math.round(c.reduce((r,h)=>r+h.activity,0)/c.length),g=Math.round(c.reduce((r,h)=>r+h.community,0)/c.length),S=Math.round(c.reduce((r,h)=>r+h.risk,0)/c.length)}return{overall:Math.round(m*.3+f*.25+d*.2+g*.15+(100-S)*.1),health:m,impact:f,activity:d,community:g,risk:S}};export{C as calculateActivityScore,w as calculateCommunityScore,y as calculateHealthScore,x as calculateIdentityScore,k as calculateImpactScore,v as calculateRepositoryScore,D as calculateRiskScore};

package/package.json

@@ -0,0 +1,63 @@
+{
+  "name": "@ossintel/scoring",
+  "author": "Mayank Kumar Chaudhari <https://mayankchaudhari.com>",
+  "private": false,
+  "version": "0.0.0",
+  "description": "Deterministic scoring engine for calculating OSS health, impact, risk, activity, and community metrics from normalized repository and ecosystem data.",
+  "license": "MIT",
+  "main": "./dist/index.js",
+  "module": "./dist/index.mjs",
+  "types": "./dist/index.d.ts",
+  "exports": {
+    ".": {
+      "import": {
+        "types": "./dist/index.d.mts",
+        "default": "./dist/index.mjs"
+      },
+      "require": {
+        "types": "./dist/index.d.ts",
+        "default": "./dist/index.js"
+      }
+    },
+    "./package.json": "./package.json"
+  },
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/mayank1513/ossintel",
+    "directory": "packages/scoring"
+  },
+  "bugs": "https://github.com/mayank1513/ossintel/issues",
+  "homepage": "https://github.com/mayank1513/ossintel/blob/main/packages/scoring/README.md",
+  "sideEffects": false,
+  "files": [
+    "dist/**"
+  ],
+  "dependencies": {
+    "@ossintel/github-normalizer": "0.0.0"
+  },
+  "devDependencies": {
+    "@types/node": "latest",
+    "tsup": "latest",
+    "typescript": "latest"
+  },
+  "forge": {
+    "aliases": [],
+    "icon": "LibraryBig",
+    "description": ""
+  },
+  "funding": [
+    {
+      "type": "github",
+      "url": "https://github.com/sponsors/mayank1513"
+    }
+  ],
+  "keywords": [
+    "@ossintel/scoring",
+    "turboforge"
+  ],
+  "scripts": {
+    "build": "tsup && gzip -c dist/index.js | wc -c",
+    "clean": "rm -rf dist",
+    "dev": "tsup --watch"
+  }
+}