fedcomp-index 2026.3.2

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 FedComp Index
+
+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,119 @@
+# FedComp Index
+
+![FedComp Index](https://fedcompindex.org/static/img/FedComp-Index-Tabularium-2.png)
+
+Federal contractor competitive intelligence. Scores every federal contractor in a state from 0 to 100 based on public award data, assigns posture classes, and provides pre-scored datasets.
+
+This is the meta-package. It installs:
+
+- **[fedcomp-index-scoring](https://www.npmjs.com/package/fedcomp-index-scoring)** - posture score computation engine
+- **[fedcomp-index-data](https://www.npmjs.com/package/fedcomp-index-data)** - pre-scored contractor datasets
+
+## Install
+
+```bash
+npm install fedcomp-index
+```
+
+## Usage
+
+```javascript
+const { scoreContractor, loadState, lookup, PostureClass } = require("fedcomp-index");
+
+// Score a contractor from raw award data
+const result = scoreContractor(15_000_000, "2025-09-15");
+console.log(result.fedcompIndex);   // 58
+console.log(result.postureClass);   // "Class 2"
+
+// Load pre-scored data
+const contractors = loadState("NV");
+console.log(`${contractors.length} contractors scored`);
+
+// Look up by UEI
+const c = lookup("CGAKREGGN9J3");
+console.log(c.legal_name);        // FLEET VEHICLE SOURCE INC
+console.log(c.fedcomp_index);     // 81
+console.log(c.posture_class);     // Class 1
+```
+
+## Posture scoring methodology
+
+Two index drivers, no normalization:
+
+| Index driver | Weight | How it works |
+|-------------|--------|-------------|
+| Award volume | 90% | log10 of total dollars won, mapped to 0-100 |
+| Award recency | 10% | Last award date, bucketed by age |
+
+Posture classes are fixed thresholds:
+
+| Posture class | FedComp Index score | Typical award volume |
+|---------------|--------------------|--------------------|
+| Class 1 | 60-100 | $100M+ |
+| Class 2 | 40-59 | $5M-$100M |
+| Class 3 | 0-39 | Under $5M |
+
+Full methodology: [fedcompindex.org/methodology](https://fedcompindex.org/methodology/)
+
+See the [FedComp Index Glossary](https://github.com/npetro6/fedcomp-index-glossary) for complete terminology definitions.
+
+## Packages
+
+| Package | What it does |
+|---------|-------------|
+| [fedcomp-index](https://www.npmjs.com/package/fedcomp-index) | Meta-package (this one) |
+| [fedcomp-index-scoring](https://www.npmjs.com/package/fedcomp-index-scoring) | Posture score computation |
+| [fedcomp-index-data](https://www.npmjs.com/package/fedcomp-index-data) | Pre-scored contractor datasets |
+
+## Also available on PyPI
+
+```bash
+pip install fedcomp-index
+```
+
+- [fedcomp-index](https://pypi.org/project/fedcomp-index/) - meta-package
+- [fedcomp-index-scoring](https://pypi.org/project/fedcomp-index-scoring/) - scoring engine
+- [fedcomp-index-data](https://pypi.org/project/fedcomp-index-data/) - pre-scored datasets
+
+## Data sources
+
+All public federal records:
+- [USASpending.gov](https://www.usaspending.gov/) - award history, dollar amounts, agencies, NAICS, PSC
+- [SAM.gov](https://sam.gov/) - entity registration, certifications, CAGE/UEI
+- [SBA.gov](https://www.sba.gov/) - certification verification
+
+## Datasets
+
+- [Nevada Federal Contractors](https://huggingface.co/datasets/npetro6/nevada-federal-contractors) (HuggingFace)
+- [Nevada Federal Contract Awards](https://huggingface.co/datasets/npetro6/nevada-federal-awards) (HuggingFace)
+- [Nevada Federal Contractors](https://www.kaggle.com/datasets/npetro6/nevada-federal-contractors-fedcomp-index) (Kaggle)
+- [Nevada Federal Contract Awards](https://www.kaggle.com/datasets/npetro6/nevada-federal-awards-2026-02) (Kaggle)
+
+## Links
+
+- Website: [https://fedcompindex.org/](https://fedcompindex.org/)
+- Nevada Rankings: [https://fedcompindex.org/nv/](https://fedcompindex.org/nv/)
+- Methodology: [https://fedcompindex.org/methodology/](https://fedcompindex.org/methodology/)
+- Tabularium: [https://fedcompindex.org/tabularium/](https://fedcompindex.org/tabularium/)
+- FAQ: [https://fedcompindex.org/faq/](https://fedcompindex.org/faq/)
+- Glossary: [https://github.com/npetro6/fedcomp-index-glossary](https://github.com/npetro6/fedcomp-index-glossary)
+- Source: [https://github.com/npetro6/FedCompIndex](https://github.com/npetro6/FedCompIndex)
+- npm packages: [https://github.com/npetro6/fedcomp-index-npm](https://github.com/npetro6/fedcomp-index-npm)
+- PyPI: [https://pypi.org/project/fedcomp-index/](https://pypi.org/project/fedcomp-index/)
+- HuggingFace: [https://huggingface.co/datasets/npetro6/nevada-federal-contractors](https://huggingface.co/datasets/npetro6/nevada-federal-contractors)
+- Kaggle: [https://www.kaggle.com/datasets/npetro6/nevada-federal-contractors-fedcomp-index](https://www.kaggle.com/datasets/npetro6/nevada-federal-contractors-fedcomp-index)
+
+## Citation
+
+```bibtex
+@software{fedcomp_index,
+  title = {FedComp Index},
+  author = {FedComp Index},
+  url = {https://fedcompindex.org/},
+  year = {2026}
+}
+```
+
+## License
+
+MIT

package/index.d.ts

@@ -0,0 +1,2 @@
+export { scoreContractor, PostureClass, FedCompResult } from "fedcomp-index-scoring";
+export { loadState, listStates, lookup, Contractor } from "fedcomp-index-data";

package/index.js

@@ -0,0 +1,23 @@
+"use strict";
+
+/**
+ * FedComp Index - Federal contractor competitive intelligence.
+ *
+ * Meta-package that re-exports the full FedComp Index toolkit:
+ * - fedcomp-index-scoring: posture score computation
+ * - fedcomp-index-data: pre-scored contractor datasets
+ *
+ * Website: https://fedcompindex.org/
+ * Methodology: https://fedcompindex.org/methodology/
+ */
+
+const { scoreContractor, PostureClass } = require("fedcomp-index-scoring");
+const { loadState, listStates, lookup } = require("fedcomp-index-data");
+
+module.exports = {
+  scoreContractor,
+  PostureClass,
+  loadState,
+  listStates,
+  lookup,
+};

package/package.json

@@ -0,0 +1,58 @@
+{
+  "name": "fedcomp-index",
+  "version": "2026.3.2",
+  "description": "Federal contractor competitive intelligence. Posture scoring, posture classes, and scored datasets for every federal contractor.",
+  "main": "index.js",
+  "types": "index.d.ts",
+  "files": [
+    "index.js",
+    "index.d.ts",
+    "LICENSE"
+  ],
+  "dependencies": {
+    "fedcomp-index-scoring": ">=2026.3.0",
+    "fedcomp-index-data": ">=2026.3.0"
+  },
+  "keywords": [
+    "federal contracting",
+    "government procurement",
+    "small business",
+    "posture scoring",
+    "fedcomp index",
+    "posture class",
+    "competitive intelligence",
+    "usaspending",
+    "sam.gov",
+    "contractor ranking",
+    "proximity map",
+    "federal awards",
+    "index drivers",
+    "procurement",
+    "contractor dossier",
+    "NAICS",
+    "dataset",
+    "competitive topology",
+    "obligation-verified",
+    "registration-obligation gap",
+    "NAICS corridor",
+    "competitive radius"
+  ],
+  "author": "FedComp Index <contact@fedcompindex.org>",
+  "license": "MIT",
+  "homepage": "https://fedcompindex.org/",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/npetro6/fedcomp-index-npm.git",
+    "directory": "packages/fedcomp-index"
+  },
+  "engines": {
+    "node": ">=14.0.0"
+  },
+  "bugs": {
+    "url": "https://github.com/npetro6/FedCompIndex/issues"
+  },
+  "funding": {
+    "type": "individual",
+    "url": "https://fedcompindex.org/"
+  }
+}