@contractspec/module.provider-ranking 0.7.5 → 0.7.7

package/README.md

@@ -1,34 +1,70 @@
 # @contractspec/module.provider-ranking
 
-Website: https://contractspec.io/
+Website: https://contractspec.io
 
-**AI provider ranking module with persistence and pipeline orchestration**
+**Provider-ranking module that adds persistence adapters and pipeline orchestration on top of lower-level ranking logic.**
 
-AI provider ranking module for benchmarks, model rankings, and ingestion. Re-exports entities, storage adapters, and pipeline orchestration.
+## What It Provides
+
+- Coordinates ingest, storage, scoring, and ranking refresh flows over provider benchmark data.
+- Exposes entities, pipelines, and storage interfaces for ranking-aware applications.
+- Sits between ranking libraries and deployable MCP or application shells.
+- `src/pipeline/` contains pipeline stages and orchestration helpers.
 
 ## Installation
 
-```bash
-bun add @contractspec/module.provider-ranking
-```
+`npm install @contractspec/module.provider-ranking`
 
-## Exports
+or
 
-- `.` — Main entry: entities, storage, and pipelines
-- `./entities` — Schema entities (BenchmarkResult, ModelRanking, IngestionRun)
-- `./storage` — Postgres storage adapter (PostgresProviderRankingStore)
-- `./pipeline` — IngestionPipeline and RankingPipeline orchestration
+`bun add @contractspec/module.provider-ranking`
 
 ## Usage
 
-```typescript
-import {
-  PostgresProviderRankingStore,
-  RankingPipeline,
-} from "@contractspec/module.provider-ranking";
+Import the root entrypoint from `@contractspec/module.provider-ranking`, or choose a documented subpath when you only need one part of the package surface.
+
+## Architecture
+
+- `src/entities/` defines ranking-related domain shapes.
+- `src/pipeline/` contains ingestion and ranking orchestration stages.
+- `src/storage/` contains persistence-facing interfaces and implementations.
+- `src/index.ts` exposes the composed module surface.
+
+## Public Entry Points
+
+- Exports entities, pipeline helpers, named pipeline entrypoints, and storage surfaces.
+- Export `.` resolves through `./src/index.ts`.
+- Export `./entities` resolves through `./src/entities/index.ts`.
+- Export `./pipeline` resolves through `./src/pipeline/index.ts`.
+- Export `./pipeline/ingestion-pipeline` resolves through `./src/pipeline/ingestion-pipeline.ts`.
+- Export `./pipeline/ranking-pipeline` resolves through `./src/pipeline/ranking-pipeline.ts`.
+- Export `./storage` resolves through `./src/storage/index.ts`.
+
+## Local Commands
+
+- `bun run dev` — contractspec-bun-build dev
+- `bun run build` — bun run prebuild && bun run build:bundle && bun run build:types
+- `bun run lint` — bun lint:fix
+- `bun run lint:check` — biome check .
+- `bun run lint:fix` — biome check --write --unsafe --only=nursery/useSortedClasses . && biome check --write .
+- `bun run typecheck` — tsc --noEmit
+- `bun run publish:pkg` — bun publish --tolerate-republish --ignore-scripts --verbose
+- `bun run publish:pkg:canary` — bun publish:pkg --tag canary
+- `bun run clean` — rimraf dist .turbo
+- `bun run build:bundle` — contractspec-bun-build transpile
+- `bun run build:types` — contractspec-bun-build types
+- `bun run prebuild` — contractspec-bun-build prebuild
+
+## Recent Updates
+
+- Replace eslint+prettier by biomejs to optimize speed.
+- Resolve lint, build, and type errors across nine packages.
+- Add Composio universal fallback, fix provider-ranking types, and expand package exports.
+- Add first-class transport, auth, versioning, and BYOK support across all integrations.
+- Add AI provider ranking system with ranking-driven model selection.
 
-const store = new PostgresProviderRankingStore({ database });
-const ranking = new RankingPipeline({ store });
+## Notes
 
-const result = await ranking.refresh();
-```
+- Depends on `lib.provider-ranking` for scoring logic and ingesters -- this module adds persistence and orchestration.
+- Pipeline stages must be idempotent; re-ingesting the same benchmark data should not create duplicates.
+- Storage adapters are swappable -- always code against the interface, not the implementation.

package/dist/browser/index.js

@@ -99,6 +99,136 @@ var providerRankingSchemaContribution = {
   entities: providerRankingEntities
 };
 
+// src/pipeline/ingestion-pipeline.ts
+import { normalizeBenchmarkResults } from "@contractspec/lib.provider-ranking/scoring";
+
+class IngestionPipeline {
+  store;
+  registry;
+  ingesterOptions;
+  constructor(options) {
+    this.store = options.store;
+    this.registry = options.ingesterRegistry;
+    this.ingesterOptions = options.ingesterOptions;
+  }
+  async ingest(source, params) {
+    const ingester = this.registry.get(source);
+    if (!ingester) {
+      throw new Error(`No ingester registered for source: ${source}`);
+    }
+    return this.runIngester(ingester, params);
+  }
+  async ingestAll(params) {
+    const results = [];
+    for (const ingester of this.registry.list()) {
+      const result = await this.runIngester(ingester, params);
+      results.push(result);
+    }
+    return results;
+  }
+  mergeOptions(params) {
+    const merged = { ...this.ingesterOptions };
+    if (params?.fromDate)
+      merged.fromDate = new Date(params.fromDate);
+    if (params?.toDate)
+      merged.toDate = new Date(params.toDate);
+    if (params?.dimensions?.length)
+      merged.dimensions = params.dimensions;
+    return merged;
+  }
+  async runIngester(ingester, params) {
+    const ingestionId = `ingest-${ingester.source}-${Date.now()}`;
+    const run = {
+      id: ingestionId,
+      source: ingester.source,
+      status: "running",
+      resultsCount: 0,
+      startedAt: new Date,
+      completedAt: null,
+      error: null
+    };
+    await this.store.createIngestionRun(run);
+    try {
+      const opts = this.mergeOptions(params);
+      const rawResults = await ingester.ingest(opts);
+      const normalized = normalizeBenchmarkResults(rawResults);
+      for (const result of normalized) {
+        await this.store.upsertBenchmarkResult(result);
+      }
+      await this.store.updateIngestionRun(ingestionId, {
+        status: "completed",
+        resultsCount: normalized.length,
+        completedAt: new Date
+      });
+      return {
+        ingestionId,
+        source: ingester.source,
+        resultsCount: normalized.length,
+        status: "completed"
+      };
+    } catch (error) {
+      const errorMessage = error instanceof Error ? error.message : String(error);
+      await this.store.updateIngestionRun(ingestionId, {
+        status: "failed",
+        completedAt: new Date,
+        error: errorMessage
+      });
+      return {
+        ingestionId,
+        source: ingester.source,
+        resultsCount: 0,
+        status: "failed"
+      };
+    }
+  }
+}
+
+// src/pipeline/ranking-pipeline.ts
+import { computeModelRankings } from "@contractspec/lib.provider-ranking/scoring";
+
+class RankingPipeline {
+  store;
+  constructor(options) {
+    this.store = options.store;
+  }
+  async refresh(params) {
+    let allResults = await this.loadAllBenchmarkResults();
+    if (params?.dimensions?.length) {
+      const dimSet = new Set(params.dimensions);
+      allResults = allResults.filter((r) => dimSet.has(r.dimension));
+    }
+    const existingRankings = params?.forceRecalculate ? new Map : new Map((await this.store.listModelRankings({
+      limit: 1e4,
+      requiredTransport: params?.requiredTransport,
+      requiredAuthMethod: params?.requiredAuthMethod
+    })).rankings.map((r) => [r.modelId, r]));
+    const newRankings = computeModelRankings(allResults, params?.weightOverrides ? { weightOverrides: params.weightOverrides } : undefined, existingRankings);
+    for (const ranking of newRankings) {
+      await this.store.upsertModelRanking(ranking);
+    }
+    return {
+      modelsRanked: newRankings.length,
+      updatedAt: new Date
+    };
+  }
+  async loadAllBenchmarkResults() {
+    const pageSize = 500;
+    let offset = 0;
+    const allResults = [];
+    while (true) {
+      const page = await this.store.listBenchmarkResults({
+        limit: pageSize,
+        offset
+      });
+      allResults.push(...page.results);
+      if (allResults.length >= page.total || page.results.length < pageSize) {
+        break;
+      }
+      offset += pageSize;
+    }
+    return allResults;
+  }
+}
 // src/storage/index.ts
 class PostgresProviderRankingStore {
   database;
@@ -395,137 +525,6 @@ function parseJson(value) {
   }
   return value;
 }
-
-// src/pipeline/ingestion-pipeline.ts
-import { normalizeBenchmarkResults } from "@contractspec/lib.provider-ranking/scoring";
-
-class IngestionPipeline {
-  store;
-  registry;
-  ingesterOptions;
-  constructor(options) {
-    this.store = options.store;
-    this.registry = options.ingesterRegistry;
-    this.ingesterOptions = options.ingesterOptions;
-  }
-  async ingest(source, params) {
-    const ingester = this.registry.get(source);
-    if (!ingester) {
-      throw new Error(`No ingester registered for source: ${source}`);
-    }
-    return this.runIngester(ingester, params);
-  }
-  async ingestAll(params) {
-    const results = [];
-    for (const ingester of this.registry.list()) {
-      const result = await this.runIngester(ingester, params);
-      results.push(result);
-    }
-    return results;
-  }
-  mergeOptions(params) {
-    const merged = { ...this.ingesterOptions };
-    if (params?.fromDate)
-      merged.fromDate = new Date(params.fromDate);
-    if (params?.toDate)
-      merged.toDate = new Date(params.toDate);
-    if (params?.dimensions?.length)
-      merged.dimensions = params.dimensions;
-    return merged;
-  }
-  async runIngester(ingester, params) {
-    const ingestionId = `ingest-${ingester.source}-${Date.now()}`;
-    const run = {
-      id: ingestionId,
-      source: ingester.source,
-      status: "running",
-      resultsCount: 0,
-      startedAt: new Date,
-      completedAt: null,
-      error: null
-    };
-    await this.store.createIngestionRun(run);
-    try {
-      const opts = this.mergeOptions(params);
-      const rawResults = await ingester.ingest(opts);
-      const normalized = normalizeBenchmarkResults(rawResults);
-      for (const result of normalized) {
-        await this.store.upsertBenchmarkResult(result);
-      }
-      await this.store.updateIngestionRun(ingestionId, {
-        status: "completed",
-        resultsCount: normalized.length,
-        completedAt: new Date
-      });
-      return {
-        ingestionId,
-        source: ingester.source,
-        resultsCount: normalized.length,
-        status: "completed"
-      };
-    } catch (error) {
-      const errorMessage = error instanceof Error ? error.message : String(error);
-      await this.store.updateIngestionRun(ingestionId, {
-        status: "failed",
-        completedAt: new Date,
-        error: errorMessage
-      });
-      return {
-        ingestionId,
-        source: ingester.source,
-        resultsCount: 0,
-        status: "failed"
-      };
-    }
-  }
-}
-
-// src/pipeline/ranking-pipeline.ts
-import { computeModelRankings } from "@contractspec/lib.provider-ranking/scoring";
-
-class RankingPipeline {
-  store;
-  constructor(options) {
-    this.store = options.store;
-  }
-  async refresh(params) {
-    let allResults = await this.loadAllBenchmarkResults();
-    if (params?.dimensions?.length) {
-      const dimSet = new Set(params.dimensions);
-      allResults = allResults.filter((r) => dimSet.has(r.dimension));
-    }
-    const existingRankings = params?.forceRecalculate ? new Map : new Map((await this.store.listModelRankings({
-      limit: 1e4,
-      requiredTransport: params?.requiredTransport,
-      requiredAuthMethod: params?.requiredAuthMethod
-    })).rankings.map((r) => [r.modelId, r]));
-    const newRankings = computeModelRankings(allResults, params?.weightOverrides ? { weightOverrides: params.weightOverrides } : undefined, existingRankings);
-    for (const ranking of newRankings) {
-      await this.store.upsertModelRanking(ranking);
-    }
-    return {
-      modelsRanked: newRankings.length,
-      updatedAt: new Date
-    };
-  }
-  async loadAllBenchmarkResults() {
-    const pageSize = 500;
-    let offset = 0;
-    const allResults = [];
-    while (true) {
-      const page = await this.store.listBenchmarkResults({
-        limit: pageSize,
-        offset
-      });
-      allResults.push(...page.results);
-      if (allResults.length >= page.total || page.results.length < pageSize) {
-        break;
-      }
-      offset += pageSize;
-    }
-    return allResults;
-  }
-}
 export {
   providerRankingSchemaContribution,
   providerRankingEntities,

package/dist/index.d.ts

@@ -1,3 +1,3 @@
 export * from './entities';
-export * from './storage';
 export * from './pipeline';
+export * from './storage';

package/dist/index.js

@@ -100,6 +100,136 @@ var providerRankingSchemaContribution = {
   entities: providerRankingEntities
 };
 
+// src/pipeline/ingestion-pipeline.ts
+import { normalizeBenchmarkResults } from "@contractspec/lib.provider-ranking/scoring";
+
+class IngestionPipeline {
+  store;
+  registry;
+  ingesterOptions;
+  constructor(options) {
+    this.store = options.store;
+    this.registry = options.ingesterRegistry;
+    this.ingesterOptions = options.ingesterOptions;
+  }
+  async ingest(source, params) {
+    const ingester = this.registry.get(source);
+    if (!ingester) {
+      throw new Error(`No ingester registered for source: ${source}`);
+    }
+    return this.runIngester(ingester, params);
+  }
+  async ingestAll(params) {
+    const results = [];
+    for (const ingester of this.registry.list()) {
+      const result = await this.runIngester(ingester, params);
+      results.push(result);
+    }
+    return results;
+  }
+  mergeOptions(params) {
+    const merged = { ...this.ingesterOptions };
+    if (params?.fromDate)
+      merged.fromDate = new Date(params.fromDate);
+    if (params?.toDate)
+      merged.toDate = new Date(params.toDate);
+    if (params?.dimensions?.length)
+      merged.dimensions = params.dimensions;
+    return merged;
+  }
+  async runIngester(ingester, params) {
+    const ingestionId = `ingest-${ingester.source}-${Date.now()}`;
+    const run = {
+      id: ingestionId,
+      source: ingester.source,
+      status: "running",
+      resultsCount: 0,
+      startedAt: new Date,
+      completedAt: null,
+      error: null
+    };
+    await this.store.createIngestionRun(run);
+    try {
+      const opts = this.mergeOptions(params);
+      const rawResults = await ingester.ingest(opts);
+      const normalized = normalizeBenchmarkResults(rawResults);
+      for (const result of normalized) {
+        await this.store.upsertBenchmarkResult(result);
+      }
+      await this.store.updateIngestionRun(ingestionId, {
+        status: "completed",
+        resultsCount: normalized.length,
+        completedAt: new Date
+      });
+      return {
+        ingestionId,
+        source: ingester.source,
+        resultsCount: normalized.length,
+        status: "completed"
+      };
+    } catch (error) {
+      const errorMessage = error instanceof Error ? error.message : String(error);
+      await this.store.updateIngestionRun(ingestionId, {
+        status: "failed",
+        completedAt: new Date,
+        error: errorMessage
+      });
+      return {
+        ingestionId,
+        source: ingester.source,
+        resultsCount: 0,
+        status: "failed"
+      };
+    }
+  }
+}
+
+// src/pipeline/ranking-pipeline.ts
+import { computeModelRankings } from "@contractspec/lib.provider-ranking/scoring";
+
+class RankingPipeline {
+  store;
+  constructor(options) {
+    this.store = options.store;
+  }
+  async refresh(params) {
+    let allResults = await this.loadAllBenchmarkResults();
+    if (params?.dimensions?.length) {
+      const dimSet = new Set(params.dimensions);
+      allResults = allResults.filter((r) => dimSet.has(r.dimension));
+    }
+    const existingRankings = params?.forceRecalculate ? new Map : new Map((await this.store.listModelRankings({
+      limit: 1e4,
+      requiredTransport: params?.requiredTransport,
+      requiredAuthMethod: params?.requiredAuthMethod
+    })).rankings.map((r) => [r.modelId, r]));
+    const newRankings = computeModelRankings(allResults, params?.weightOverrides ? { weightOverrides: params.weightOverrides } : undefined, existingRankings);
+    for (const ranking of newRankings) {
+      await this.store.upsertModelRanking(ranking);
+    }
+    return {
+      modelsRanked: newRankings.length,
+      updatedAt: new Date
+    };
+  }
+  async loadAllBenchmarkResults() {
+    const pageSize = 500;
+    let offset = 0;
+    const allResults = [];
+    while (true) {
+      const page = await this.store.listBenchmarkResults({
+        limit: pageSize,
+        offset
+      });
+      allResults.push(...page.results);
+      if (allResults.length >= page.total || page.results.length < pageSize) {
+        break;
+      }
+      offset += pageSize;
+    }
+    return allResults;
+  }
+}
 // src/storage/index.ts
 class PostgresProviderRankingStore {
   database;
@@ -396,137 +526,6 @@ function parseJson(value) {
   }
   return value;
 }
-
-// src/pipeline/ingestion-pipeline.ts
-import { normalizeBenchmarkResults } from "@contractspec/lib.provider-ranking/scoring";
-
-class IngestionPipeline {
-  store;
-  registry;
-  ingesterOptions;
-  constructor(options) {
-    this.store = options.store;
-    this.registry = options.ingesterRegistry;
-    this.ingesterOptions = options.ingesterOptions;
-  }
-  async ingest(source, params) {
-    const ingester = this.registry.get(source);
-    if (!ingester) {
-      throw new Error(`No ingester registered for source: ${source}`);
-    }
-    return this.runIngester(ingester, params);
-  }
-  async ingestAll(params) {
-    const results = [];
-    for (const ingester of this.registry.list()) {
-      const result = await this.runIngester(ingester, params);
-      results.push(result);
-    }
-    return results;
-  }
-  mergeOptions(params) {
-    const merged = { ...this.ingesterOptions };
-    if (params?.fromDate)
-      merged.fromDate = new Date(params.fromDate);
-    if (params?.toDate)
-      merged.toDate = new Date(params.toDate);
-    if (params?.dimensions?.length)
-      merged.dimensions = params.dimensions;
-    return merged;
-  }
-  async runIngester(ingester, params) {
-    const ingestionId = `ingest-${ingester.source}-${Date.now()}`;
-    const run = {
-      id: ingestionId,
-      source: ingester.source,
-      status: "running",
-      resultsCount: 0,
-      startedAt: new Date,
-      completedAt: null,
-      error: null
-    };
-    await this.store.createIngestionRun(run);
-    try {
-      const opts = this.mergeOptions(params);
-      const rawResults = await ingester.ingest(opts);
-      const normalized = normalizeBenchmarkResults(rawResults);
-      for (const result of normalized) {
-        await this.store.upsertBenchmarkResult(result);
-      }
-      await this.store.updateIngestionRun(ingestionId, {
-        status: "completed",
-        resultsCount: normalized.length,
-        completedAt: new Date
-      });
-      return {
-        ingestionId,
-        source: ingester.source,
-        resultsCount: normalized.length,
-        status: "completed"
-      };
-    } catch (error) {
-      const errorMessage = error instanceof Error ? error.message : String(error);
-      await this.store.updateIngestionRun(ingestionId, {
-        status: "failed",
-        completedAt: new Date,
-        error: errorMessage
-      });
-      return {
-        ingestionId,
-        source: ingester.source,
-        resultsCount: 0,
-        status: "failed"
-      };
-    }
-  }
-}
-
-// src/pipeline/ranking-pipeline.ts
-import { computeModelRankings } from "@contractspec/lib.provider-ranking/scoring";
-
-class RankingPipeline {
-  store;
-  constructor(options) {
-    this.store = options.store;
-  }
-  async refresh(params) {
-    let allResults = await this.loadAllBenchmarkResults();
-    if (params?.dimensions?.length) {
-      const dimSet = new Set(params.dimensions);
-      allResults = allResults.filter((r) => dimSet.has(r.dimension));
-    }
-    const existingRankings = params?.forceRecalculate ? new Map : new Map((await this.store.listModelRankings({
-      limit: 1e4,
-      requiredTransport: params?.requiredTransport,
-      requiredAuthMethod: params?.requiredAuthMethod
-    })).rankings.map((r) => [r.modelId, r]));
-    const newRankings = computeModelRankings(allResults, params?.weightOverrides ? { weightOverrides: params.weightOverrides } : undefined, existingRankings);
-    for (const ranking of newRankings) {
-      await this.store.upsertModelRanking(ranking);
-    }
-    return {
-      modelsRanked: newRankings.length,
-      updatedAt: new Date
-    };
-  }
-  async loadAllBenchmarkResults() {
-    const pageSize = 500;
-    let offset = 0;
-    const allResults = [];
-    while (true) {
-      const page = await this.store.listBenchmarkResults({
-        limit: pageSize,
-        offset
-      });
-      allResults.push(...page.results);
-      if (allResults.length >= page.total || page.results.length < pageSize) {
-        break;
-      }
-      offset += pageSize;
-    }
-    return allResults;
-  }
-}
 export {
   providerRankingSchemaContribution,
   providerRankingEntities,

package/dist/node/index.js

@@ -99,6 +99,136 @@ var providerRankingSchemaContribution = {
   entities: providerRankingEntities
 };
 
+// src/pipeline/ingestion-pipeline.ts
+import { normalizeBenchmarkResults } from "@contractspec/lib.provider-ranking/scoring";
+
+class IngestionPipeline {
+  store;
+  registry;
+  ingesterOptions;
+  constructor(options) {
+    this.store = options.store;
+    this.registry = options.ingesterRegistry;
+    this.ingesterOptions = options.ingesterOptions;
+  }
+  async ingest(source, params) {
+    const ingester = this.registry.get(source);
+    if (!ingester) {
+      throw new Error(`No ingester registered for source: ${source}`);
+    }
+    return this.runIngester(ingester, params);
+  }
+  async ingestAll(params) {
+    const results = [];
+    for (const ingester of this.registry.list()) {
+      const result = await this.runIngester(ingester, params);
+      results.push(result);
+    }
+    return results;
+  }
+  mergeOptions(params) {
+    const merged = { ...this.ingesterOptions };
+    if (params?.fromDate)
+      merged.fromDate = new Date(params.fromDate);
+    if (params?.toDate)
+      merged.toDate = new Date(params.toDate);
+    if (params?.dimensions?.length)
+      merged.dimensions = params.dimensions;
+    return merged;
+  }
+  async runIngester(ingester, params) {
+    const ingestionId = `ingest-${ingester.source}-${Date.now()}`;
+    const run = {
+      id: ingestionId,
+      source: ingester.source,
+      status: "running",
+      resultsCount: 0,
+      startedAt: new Date,
+      completedAt: null,
+      error: null
+    };
+    await this.store.createIngestionRun(run);
+    try {
+      const opts = this.mergeOptions(params);
+      const rawResults = await ingester.ingest(opts);
+      const normalized = normalizeBenchmarkResults(rawResults);
+      for (const result of normalized) {
+        await this.store.upsertBenchmarkResult(result);
+      }
+      await this.store.updateIngestionRun(ingestionId, {
+        status: "completed",
+        resultsCount: normalized.length,
+        completedAt: new Date
+      });
+      return {
+        ingestionId,
+        source: ingester.source,
+        resultsCount: normalized.length,
+        status: "completed"
+      };
+    } catch (error) {
+      const errorMessage = error instanceof Error ? error.message : String(error);
+      await this.store.updateIngestionRun(ingestionId, {
+        status: "failed",
+        completedAt: new Date,
+        error: errorMessage
+      });
+      return {
+        ingestionId,
+        source: ingester.source,
+        resultsCount: 0,
+        status: "failed"
+      };
+    }
+  }
+}
+
+// src/pipeline/ranking-pipeline.ts
+import { computeModelRankings } from "@contractspec/lib.provider-ranking/scoring";
+
+class RankingPipeline {
+  store;
+  constructor(options) {
+    this.store = options.store;
+  }
+  async refresh(params) {
+    let allResults = await this.loadAllBenchmarkResults();
+    if (params?.dimensions?.length) {
+      const dimSet = new Set(params.dimensions);
+      allResults = allResults.filter((r) => dimSet.has(r.dimension));
+    }
+    const existingRankings = params?.forceRecalculate ? new Map : new Map((await this.store.listModelRankings({
+      limit: 1e4,
+      requiredTransport: params?.requiredTransport,
+      requiredAuthMethod: params?.requiredAuthMethod
+    })).rankings.map((r) => [r.modelId, r]));
+    const newRankings = computeModelRankings(allResults, params?.weightOverrides ? { weightOverrides: params.weightOverrides } : undefined, existingRankings);
+    for (const ranking of newRankings) {
+      await this.store.upsertModelRanking(ranking);
+    }
+    return {
+      modelsRanked: newRankings.length,
+      updatedAt: new Date
+    };
+  }
+  async loadAllBenchmarkResults() {
+    const pageSize = 500;
+    let offset = 0;
+    const allResults = [];
+    while (true) {
+      const page = await this.store.listBenchmarkResults({
+        limit: pageSize,
+        offset
+      });
+      allResults.push(...page.results);
+      if (allResults.length >= page.total || page.results.length < pageSize) {
+        break;
+      }
+      offset += pageSize;
+    }
+    return allResults;
+  }
+}
 // src/storage/index.ts
 class PostgresProviderRankingStore {
   database;
@@ -395,137 +525,6 @@ function parseJson(value) {
   }
   return value;
 }
-
-// src/pipeline/ingestion-pipeline.ts
-import { normalizeBenchmarkResults } from "@contractspec/lib.provider-ranking/scoring";
-
-class IngestionPipeline {
-  store;
-  registry;
-  ingesterOptions;
-  constructor(options) {
-    this.store = options.store;
-    this.registry = options.ingesterRegistry;
-    this.ingesterOptions = options.ingesterOptions;
-  }
-  async ingest(source, params) {
-    const ingester = this.registry.get(source);
-    if (!ingester) {
-      throw new Error(`No ingester registered for source: ${source}`);
-    }
-    return this.runIngester(ingester, params);
-  }
-  async ingestAll(params) {
-    const results = [];
-    for (const ingester of this.registry.list()) {
-      const result = await this.runIngester(ingester, params);
-      results.push(result);
-    }
-    return results;
-  }
-  mergeOptions(params) {
-    const merged = { ...this.ingesterOptions };
-    if (params?.fromDate)
-      merged.fromDate = new Date(params.fromDate);
-    if (params?.toDate)
-      merged.toDate = new Date(params.toDate);
-    if (params?.dimensions?.length)
-      merged.dimensions = params.dimensions;
-    return merged;
-  }
-  async runIngester(ingester, params) {
-    const ingestionId = `ingest-${ingester.source}-${Date.now()}`;
-    const run = {
-      id: ingestionId,
-      source: ingester.source,
-      status: "running",
-      resultsCount: 0,
-      startedAt: new Date,
-      completedAt: null,
-      error: null
-    };
-    await this.store.createIngestionRun(run);
-    try {
-      const opts = this.mergeOptions(params);
-      const rawResults = await ingester.ingest(opts);
-      const normalized = normalizeBenchmarkResults(rawResults);
-      for (const result of normalized) {
-        await this.store.upsertBenchmarkResult(result);
-      }
-      await this.store.updateIngestionRun(ingestionId, {
-        status: "completed",
-        resultsCount: normalized.length,
-        completedAt: new Date
-      });
-      return {
-        ingestionId,
-        source: ingester.source,
-        resultsCount: normalized.length,
-        status: "completed"
-      };
-    } catch (error) {
-      const errorMessage = error instanceof Error ? error.message : String(error);
-      await this.store.updateIngestionRun(ingestionId, {
-        status: "failed",
-        completedAt: new Date,
-        error: errorMessage
-      });
-      return {
-        ingestionId,
-        source: ingester.source,
-        resultsCount: 0,
-        status: "failed"
-      };
-    }
-  }
-}
-
-// src/pipeline/ranking-pipeline.ts
-import { computeModelRankings } from "@contractspec/lib.provider-ranking/scoring";
-
-class RankingPipeline {
-  store;
-  constructor(options) {
-    this.store = options.store;
-  }
-  async refresh(params) {
-    let allResults = await this.loadAllBenchmarkResults();
-    if (params?.dimensions?.length) {
-      const dimSet = new Set(params.dimensions);
-      allResults = allResults.filter((r) => dimSet.has(r.dimension));
-    }
-    const existingRankings = params?.forceRecalculate ? new Map : new Map((await this.store.listModelRankings({
-      limit: 1e4,
-      requiredTransport: params?.requiredTransport,
-      requiredAuthMethod: params?.requiredAuthMethod
-    })).rankings.map((r) => [r.modelId, r]));
-    const newRankings = computeModelRankings(allResults, params?.weightOverrides ? { weightOverrides: params.weightOverrides } : undefined, existingRankings);
-    for (const ranking of newRankings) {
-      await this.store.upsertModelRanking(ranking);
-    }
-    return {
-      modelsRanked: newRankings.length,
-      updatedAt: new Date
-    };
-  }
-  async loadAllBenchmarkResults() {
-    const pageSize = 500;
-    let offset = 0;
-    const allResults = [];
-    while (true) {
-      const page = await this.store.listBenchmarkResults({
-        limit: pageSize,
-        offset
-      });
-      allResults.push(...page.results);
-      if (allResults.length >= page.total || page.results.length < pageSize) {
-        break;
-      }
-      offset += pageSize;
-    }
-    return allResults;
-  }
-}
 export {
   providerRankingSchemaContribution,
   providerRankingEntities,

package/dist/pipeline/ingestion-pipeline.d.ts

@@ -1,7 +1,6 @@
+import type { IngesterOptions, IngesterRegistry } from '@contractspec/lib.provider-ranking/ingesters';
 import type { ProviderRankingStore } from '@contractspec/lib.provider-ranking/store';
 import type { BenchmarkDimension, BenchmarkSource, IngestionRun } from '@contractspec/lib.provider-ranking/types';
-import type { IngesterOptions } from '@contractspec/lib.provider-ranking/ingesters';
-import type { IngesterRegistry } from '@contractspec/lib.provider-ranking/ingesters';
 export interface IngestionPipelineOptions {
     store: ProviderRankingStore;
     ingesterRegistry: IngesterRegistry;

package/dist/pipeline/ranking-pipeline.d.ts

@@ -1,5 +1,5 @@
 import type { ProviderRankingStore } from '@contractspec/lib.provider-ranking/store';
-import type { BenchmarkDimension, DimensionWeightConfig, ProviderTransportSupport, ProviderAuthSupport } from '@contractspec/lib.provider-ranking/types';
+import type { BenchmarkDimension, DimensionWeightConfig, ProviderAuthSupport, ProviderTransportSupport } from '@contractspec/lib.provider-ranking/types';
 export interface RankingPipelineOptions {
     store: ProviderRankingStore;
 }

package/dist/storage/index.d.ts

@@ -1,6 +1,6 @@
+import type { DatabaseProvider } from '@contractspec/lib.contracts-integrations';
 import type { ProviderRankingStore } from '@contractspec/lib.provider-ranking/store';
 import type { BenchmarkResult, BenchmarkResultListResult, BenchmarkResultQuery, IngestionRun, ModelProfile, ModelRanking, RankingListResult, RankingQuery } from '@contractspec/lib.provider-ranking/types';
-import type { DatabaseProvider } from '@contractspec/lib.contracts-integrations';
 export interface PostgresProviderRankingStoreOptions {
     database: DatabaseProvider;
     schema?: string;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@contractspec/module.provider-ranking",
-  "version": "0.7.5",
+  "version": "0.7.7",
   "description": "AI provider ranking module with persistence and pipeline orchestration",
   "keywords": [
     "contractspec",
@@ -20,19 +20,19 @@
     "dev": "contractspec-bun-build dev",
     "clean": "rimraf dist .turbo",
     "lint": "bun lint:fix",
-    "lint:fix": "eslint src --fix",
-    "lint:check": "eslint src",
+    "lint:fix": "biome check --write --unsafe --only=nursery/useSortedClasses . && biome check --write .",
+    "lint:check": "biome check .",
     "prebuild": "contractspec-bun-build prebuild",
     "typecheck": "tsc --noEmit"
   },
   "dependencies": {
-    "@contractspec/lib.provider-ranking": "0.7.5",
-    "@contractspec/lib.schema": "3.7.5",
-    "@contractspec/lib.contracts-integrations": "3.7.5"
+    "@contractspec/lib.provider-ranking": "0.7.6",
+    "@contractspec/lib.schema": "3.7.6",
+    "@contractspec/lib.contracts-integrations": "3.7.7"
   },
   "devDependencies": {
-    "@contractspec/tool.typescript": "3.7.5",
-    "@contractspec/tool.bun": "3.7.5",
+    "@contractspec/tool.typescript": "3.7.6",
+    "@contractspec/tool.bun": "3.7.6",
     "typescript": "^5.9.3"
   },
   "exports": {