@red-hat-developer-hub/backstage-plugin-scorecard-backend 2.6.0 → 2.7.1

package/CHANGELOG.md

@@ -1,5 +1,26 @@
 # @red-hat-developer-hub/backstage-plugin-scorecard-backend
 
+## 2.7.1
+
+### Patch Changes
+
+- 91e724f: Expose scorecard entity calculation health on drill-down and aggregation APIs, and align the drill-down warning plus homepage subheader with those counts.
+- Updated dependencies [91e724f]
+  - @red-hat-developer-hub/backstage-plugin-scorecard-common@2.7.1
+  - @red-hat-developer-hub/backstage-plugin-scorecard-node@2.7.1
+
+## 2.7.0
+
+### Minor Changes
+
+- bf72ffc: Adds `**average**` as an aggregation KPI type alongside `**statusGrouped**`, with configurable `**options.statusScores**` and optional `**options.thresholds**` (same shape as metric thresholds) for homepage donut coloring against `**averageScore × 100**`, with built-in defaults when omitted.
+
+### Patch Changes
+
+- Updated dependencies [bf72ffc]
+  - @red-hat-developer-hub/backstage-plugin-scorecard-common@2.7.0
+  - @red-hat-developer-hub/backstage-plugin-scorecard-node@2.7.0
+
 ## 2.6.0
 
 ### Minor Changes

package/README.md

@@ -118,7 +118,7 @@ Thresholds define conditions to assign metric values to specific visual categori
 
 Thresholds are evaluated in order, and the first matching rule determines the category. The plugin supports various operators for number metrics (`>`, `>=`, `<`, `<=`, `==`, `!=`, `-` (range)) and boolean metrics (`==`, `!=`).
 
-For comprehensive threshold configuration guide, examples, and best practices, see [thresholds.md](./docs/thresholds.md).
+For comprehensive threshold configuration guide, examples, best practices, and **aggregation KPI result thresholds** for **`type: average`**, see [thresholds.md](./docs/thresholds.md).
 
 ## Aggregation KPIs (homepage and `GET /aggregations`)
 
@@ -137,18 +137,41 @@ scorecard:
       description: 'Open pull requests grouped by status.'
       type: statusGrouped
       metricId: github.open_prs
+    openPrsWeightedKpi:
+      title: 'GitHub open PRs (weighted health)'
+      description: 'Weighted health from status counts using configurable scores.'
+      type: average
+      metricId: github.open_prs
+      options:
+        statusScores:
+          success: 100
+          warning: 50
+          error: 0
+        # Optional: colors for the average-score donut (expressions apply to percentage 0–100)
+        thresholds:
+          rules:
+            - key: success
+              expression: '>=75'
+              color: success.main
+            - key: warning
+              expression: '10-74'
+              color: warning.main
+            - key: error
+              expression: '<10'
+              color: error.main
 ```
 
-| Field         | Description                                                    |
-| ------------- | -------------------------------------------------------------- |
-| `title`       | Display title for this aggregation (returned in API metadata). |
-| `description` | Display description for this aggregation.                      |
-| `type`        | Aggregation algorithm; currently `statusGrouped`.              |
-| `metricId`    | Metric provider id used to load thresholds and compute counts. |
+| Field         | Description                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                         |
+| ------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
+| `title`       | Display title for this aggregation (returned in API metadata).                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                      |
+| `description` | Display description for this aggregation.                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                           |
+| `type`        | Aggregation algorithm: `statusGrouped` (counts per threshold status) or `average` (normalized weighted score).                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                      |
+| `metricId`    | Metric provider id used to load thresholds and compute counts.                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                      |
+| `options`     | Optional for `statusGrouped`. **Required** for `average`: must include **`options.statusScores`** — map status keys to numeric weights (typically one entry per **metric threshold rule key**). Optionally **`options.thresholds`** (same shape as metric thresholds; see [thresholds.md — Aggregation KPI result thresholds](./docs/thresholds.md#4-aggregation-kpi-result-thresholds-average-type)); evaluated on **`averageScore × 100`**; first match sets **`aggregationChartDisplayColor`**. The API includes **`averageScore`** (ratio **0–1**, **one decimal**), **`averageWeightedSum`**, **`averageMaxPossible`**, and **`aggregationChartDisplayColor`** (from configured or default result thresholds). |
 
 - **Path**: `scorecard.aggregationKPIs.<aggregationId>`.
 - If **`aggregationKPIs` is omitted** or a given id is not listed, **`GET /aggregations/:aggregationId`** still works when **`aggregationId` equals the metric id** (e.g. `github.open_prs`): the backend uses that metric with the default `statusGrouped` aggregation and metric-defined title/description.
-- Invalid KPI entries may be logged and skipped at runtime; prefer fixing config per backend validation.
+- **Startup validation**: the backend validates every **`scorecard.aggregationKPIs`** entry when the plugin loads. Invalid configuration (including **`average`** KPIs without **`options.statusScores`**, bad expressions, or unregistered **`metricId`**) causes the backend to **fail to start** with a clear error. At runtime, some edge cases may still be logged (for example skipping a KPI with unusable weights); prefer correcting app-config. See [aggregation.md](./docs/aggregation.md#configuration-validation).
 
 **Homepage cards** are configured in the app (for example Dynamic Home Page mount points). They should pass **`aggregationId`** matching a key in `aggregationKPIs` or the metric id for the default case. See the [Scorecard frontend plugin README](../scorecard/README.md#homepage-scorecard-cards).
 

package/config.d.ts

@@ -15,7 +15,11 @@
  */
 
 import { SchedulerServiceTaskScheduleDefinitionConfig } from '@backstage/backend-plugin-api';
-import { AggregationType } from '@red-hat-developer-hub/backstage-plugin-scorecard-common';
+import {
+  AggregationType,
+  ThresholdConfig,
+  AggregationThresholdRule,
+} from '@red-hat-developer-hub/backstage-plugin-scorecard-common';
 
 export interface Config {
   /** Configuration for scorecard plugin */
@@ -32,6 +36,20 @@ export interface Config {
         type: AggregationType;
         /** Metric ID for which the aggregation is calculated */
         metricId: string;
+        /** Type-specific settings */
+        options?: {
+          /** Required under `options` when `type` is `average` */
+          statusScores?: {
+            [thresholdRuleKey: string]: number;
+          };
+          /**
+           * Optional: threshold rules for coloring the KPI headline value from the aggregation result
+           * (e.g. average percentage 0–100 for `average` KPIs).
+           */
+          thresholds?: {
+            rules: AggregationThresholdRule[];
+          };
+        };
       };
     };
     /** Number of days to retain metric data in the database. Older data will be automatically cleaned up. Default: 365 days */
@@ -57,47 +75,7 @@ export interface Config {
          */
         [metricName: string]: {
           /** Threshold configuration for the metric */
-          thresholds?: {
-            /**
-             * Rules describe how metric values are categorized and how that category is presented in the UI.
-             * They are evaluated in order and the first matching rule is applied.
-             */
-            rules?: Array<{
-              /**
-               * Threshold category key that a metric value is assigned to when this rule
-               * matches (for example `success`, `warning`, `error`, or a custom key).
-               */
-              key: string;
-              /**
-               * Threshold expression that determines whether a metric value matches this
-               * rule. Supports:`>=`, `<=`, `>`, `<`, `==`, `!=`, `-` (range).
-               *
-               * @example `<= 10` - Metric value must be less than or equal to 10.
-               * @example `10-60` - Metric value must be between 10 and 60 (inclusive).
-               */
-              expression: string;
-              /**
-               * Color configuration - supports multiple formats:
-               * - theme palette reference (`success.main` / `warning.main` / `error.main`)
-               * - HEX code (e.g. '#FFA500')
-               * - RGB/RGBA (e.g. 'rgb(255, 0, 0)')
-               *
-               * Threshold rules 'success', 'warning' and 'error' have default colors.
-               */
-              color?: string;
-              /**
-               * Icon configuration - supports multiple formats:
-               * - Backstage system icons: 'kind:component', 'kind:api', etc.
-               * - Material Design icons: 'settings', 'home', 'build', etc.
-               * - SVG strings: '<svg xmlns="http://www.w3.org/2000/svg">...</svg>'
-               * - URLs: 'https://example.com/icon.png', '/assets/icon.svg'
-               * - Data URIs: 'data:image/svg+xml;base64,...'
-               *
-               * Threshold rules 'success', 'warning' and 'error' have default icons.
-               */
-              icon?: string;
-            }>;
-          };
+          thresholds?: ThresholdConfig;
           /**
            * Schedule for collecting this metric. If not set, the default hourly schedule is used.
            *

package/dist/constants/aggregationKPIs.cjs.js

@@ -1,6 +1,28 @@
 'use strict';
 
+var backstagePluginScorecardCommon = require('@red-hat-developer-hub/backstage-plugin-scorecard-common');
+
 const AGGREGATION_KPIS_CONFIG_PATH = "scorecard.aggregationKPIs";
+const DEFAULT_AVERAGE_KPI_RESULT_THRESHOLDS = {
+  rules: [
+    {
+      key: "success",
+      expression: ">=80",
+      color: backstagePluginScorecardCommon.ScorecardThresholdRuleColors.SUCCESS
+    },
+    {
+      key: "warning",
+      expression: "30-79",
+      color: backstagePluginScorecardCommon.ScorecardThresholdRuleColors.WARNING
+    },
+    {
+      key: "error",
+      expression: "<30",
+      color: backstagePluginScorecardCommon.ScorecardThresholdRuleColors.ERROR
+    }
+  ]
+};
 
 exports.AGGREGATION_KPIS_CONFIG_PATH = AGGREGATION_KPIS_CONFIG_PATH;
+exports.DEFAULT_AVERAGE_KPI_RESULT_THRESHOLDS = DEFAULT_AVERAGE_KPI_RESULT_THRESHOLDS;
 //# sourceMappingURL=aggregationKPIs.cjs.js.map

package/dist/constants/aggregationKPIs.cjs.js.map

@@ -1 +1 @@
-{"version":3,"file":"aggregationKPIs.cjs.js","sources":["../../src/constants/aggregationKPIs.ts"],"sourcesContent":["/*\n * Copyright Red Hat, Inc.\n *\n * Licensed under the Apache License, Version 2.0 (the \"License\");\n * you may not use this file except in compliance with the License.\n * You may obtain a copy of the License at\n *\n *     http://www.apache.org/licenses/LICENSE-2.0\n *\n * Unless required by applicable law or agreed to in writing, software\n * distributed under the License is distributed on an \"AS IS\" BASIS,\n * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.\n * See the License for the specific language governing permissions and\n * limitations under the License.\n */\n\nexport const AGGREGATION_KPIS_CONFIG_PATH =\n  'scorecard.aggregationKPIs' as const;\n"],"names":[],"mappings":";;AAgBO,MAAM,4BACX,GAAA;;;;"}
+{"version":3,"file":"aggregationKPIs.cjs.js","sources":["../../src/constants/aggregationKPIs.ts"],"sourcesContent":["/*\n * Copyright Red Hat, Inc.\n *\n * Licensed under the Apache License, Version 2.0 (the \"License\");\n * you may not use this file except in compliance with the License.\n * You may obtain a copy of the License at\n *\n *     http://www.apache.org/licenses/LICENSE-2.0\n *\n * Unless required by applicable law or agreed to in writing, software\n * distributed under the License is distributed on an \"AS IS\" BASIS,\n * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.\n * See the License for the specific language governing permissions and\n * limitations under the License.\n */\n\nimport {\n  type ThresholdConfig,\n  ScorecardThresholdRuleColors,\n} from '@red-hat-developer-hub/backstage-plugin-scorecard-common';\n\nexport const AGGREGATION_KPIS_CONFIG_PATH =\n  'scorecard.aggregationKPIs' as const;\n\n/**\n * Default applied by `AverageAggregationStrategy` when `options.thresholds` is omitted\n * from app-config. Higher headline percentage (0–100) = better. Evaluated in order; first match wins.\n */\nexport const DEFAULT_AVERAGE_KPI_RESULT_THRESHOLDS: ThresholdConfig = {\n  rules: [\n    {\n      key: 'success',\n      expression: '>=80',\n      color: ScorecardThresholdRuleColors.SUCCESS,\n    },\n    {\n      key: 'warning',\n      expression: '30-79',\n      color: ScorecardThresholdRuleColors.WARNING,\n    },\n    {\n      key: 'error',\n      expression: '<30',\n      color: ScorecardThresholdRuleColors.ERROR,\n    },\n  ],\n};\n"],"names":["ScorecardThresholdRuleColors"],"mappings":";;;;AAqBO,MAAM,4BACX,GAAA;AAMK,MAAM,qCAAyD,GAAA;AAAA,EACpE,KAAO,EAAA;AAAA,IACL;AAAA,MACE,GAAK,EAAA,SAAA;AAAA,MACL,UAAY,EAAA,MAAA;AAAA,MACZ,OAAOA,2DAA6B,CAAA;AAAA,KACtC;AAAA,IACA;AAAA,MACE,GAAK,EAAA,SAAA;AAAA,MACL,UAAY,EAAA,OAAA;AAAA,MACZ,OAAOA,2DAA6B,CAAA;AAAA,KACtC;AAAA,IACA;AAAA,MACE,GAAK,EAAA,OAAA;AAAA,MACL,UAAY,EAAA,KAAA;AAAA,MACZ,OAAOA,2DAA6B,CAAA;AAAA;AACtC;AAEJ;;;;;"}

package/dist/database/DatabaseMetricValues.cjs.js

@@ -34,19 +34,50 @@ class DatabaseMetricValues {
    * Get aggregated metrics by status for multiple entities and metrics.
    */
   async readAggregatedMetricByEntityRefs(catalog_entity_refs, metric_id) {
+    if (catalog_entity_refs.length === 0) {
+      return void 0;
+    }
     const latestIdsSubquery = this.dbClient(this.tableName).max("id").where("metric_id", metric_id).whereIn("catalog_entity_ref", catalog_entity_refs).groupBy("catalog_entity_ref");
-    const statusRows = await this.dbClient(this.tableName).select("status").count("* as count").max("timestamp as max_timestamp").whereIn("id", latestIdsSubquery).whereNotNull("status").whereNotNull("value").groupBy("status");
-    if (!statusRows || statusRows.length === 0) {
+    const metricValueIsMissingExpr = "(value IS NULL OR CAST(value AS TEXT) = 'null')";
+    const statsRow = await this.dbClient(this.tableName).whereIn("id", latestIdsSubquery).select(
+      this.dbClient.raw("COUNT(*) as latest_row_count"),
+      this.dbClient.raw(
+        `SUM(CASE WHEN error_message IS NOT NULL AND ${metricValueIsMissingExpr} THEN 1 ELSE 0 END) as calculation_error_count`
+      ),
+      this.dbClient.raw("MAX(timestamp) as max_timestamp")
+    ).first();
+    const latestRowCount = Number(
+      statsRow?.latest_row_count ?? 0
+    );
+    if (latestRowCount === 0) {
       return void 0;
     }
+    const calculation_error_count = Number(
+      statsRow?.calculation_error_count ?? 0
+    );
     const normalizeTimestamp = (timestamp) => {
       if (timestamp instanceof Date) {
         return timestamp;
-      } else if (typeof timestamp === "number" || typeof timestamp === "string") {
+      }
+      if (typeof timestamp === "number" || typeof timestamp === "string") {
         return new Date(timestamp);
       }
       return /* @__PURE__ */ new Date();
     };
+    const maxTimestampAllLatest = normalizeTimestamp(
+      statsRow?.max_timestamp
+    );
+    const statusRows = await this.dbClient(this.tableName).select("status").count("* as count").max("timestamp as max_timestamp").whereIn("id", latestIdsSubquery).whereNotNull("status").whereRaw(`NOT ${metricValueIsMissingExpr}`).groupBy("status");
+    if (!statusRows || statusRows.length === 0) {
+      return {
+        metric_id,
+        total: 0,
+        max_timestamp: maxTimestampAllLatest,
+        statusCounts: {},
+        calculation_error_count,
+        latest_entity_count: latestRowCount
+      };
+    }
     let maxTimestamp = /* @__PURE__ */ new Date(0);
     let total = 0;
     const statusCounts = {};
@@ -60,11 +91,14 @@ class DatabaseMetricValues {
       statusCounts[name] = count;
       total += count;
     }
+    const mergedMax = maxTimestampAllLatest.getTime() >= maxTimestamp.getTime() ? maxTimestampAllLatest : maxTimestamp;
     return {
       metric_id,
       total,
-      max_timestamp: maxTimestamp,
-      statusCounts
+      max_timestamp: mergedMax,
+      statusCounts,
+      calculation_error_count,
+      latest_entity_count: latestRowCount
     };
   }
   /**

package/dist/database/DatabaseMetricValues.cjs.js.map

@@ -1 +1 @@
-{"version":3,"file":"DatabaseMetricValues.cjs.js","sources":["../../src/database/DatabaseMetricValues.ts"],"sourcesContent":["/*\n * Copyright Red Hat, Inc.\n *\n * Licensed under the Apache License, Version 2.0 (the \"License\");\n * you may not use this file except in compliance with the License.\n * You may obtain a copy of the License at\n *\n *     http://www.apache.org/licenses/LICENSE-2.0\n *\n * Unless required by applicable law or agreed to in writing, software\n * distributed under the License is distributed on an \"AS IS\" BASIS,\n * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.\n * See the License for the specific language governing permissions and\n * limitations under the License.\n */\n\nimport { Knex } from 'knex';\nimport {\n  DbMetricValueCreate,\n  DbMetricValue,\n  DbAggregatedMetric,\n} from './types';\n\ntype ReadEntityMetricsWithFiltersOptions = {\n  status?: string;\n  entityName?: string;\n  entityKind?: string;\n  entityNamespace?: string;\n  entityOwner?: string[];\n  sortBy?:\n    | 'entityName'\n    | 'owner'\n    | 'entityKind'\n    | 'timestamp'\n    | 'metricValue'\n    | 'namespace'\n    | 'status';\n  sortOrder?: 'asc' | 'desc';\n  pagination?: { limit: number; offset: number };\n};\n\nexport class DatabaseMetricValues {\n  private readonly tableName = 'metric_values';\n\n  constructor(private readonly dbClient: Knex<any, any[]>) {}\n\n  /**\n   * Insert multiple metric values\n   */\n  async createMetricValues(metricValues: DbMetricValueCreate[]): Promise<void> {\n    if (metricValues.length === 0) {\n      return;\n    }\n    await this.dbClient(this.tableName).insert(metricValues);\n  }\n\n  /**\n   * Get the latest metric values for a specific entity and metrics\n   */\n  async readLatestEntityMetricValues(\n    catalog_entity_ref: string,\n    metric_ids: string[],\n  ): Promise<DbMetricValue[]> {\n    return await this.dbClient(this.tableName)\n      .select('*')\n      .whereIn(\n        'id',\n        this.dbClient(this.tableName)\n          .max('id')\n          .whereIn('metric_id', metric_ids)\n          .where('catalog_entity_ref', catalog_entity_ref)\n          .groupBy('metric_id'),\n      );\n  }\n\n  /**\n   * Delete metric values that are older than the given date\n   */\n  async cleanupExpiredMetrics(olderThan: Date): Promise<number> {\n    return await this.dbClient(this.tableName)\n      .where('timestamp', '<', olderThan)\n      .del();\n  }\n\n  /**\n   * Get aggregated metrics by status for multiple entities and metrics.\n   */\n  async readAggregatedMetricByEntityRefs(\n    catalog_entity_refs: string[],\n    metric_id: string,\n  ): Promise<DbAggregatedMetric | undefined> {\n    const latestIdsSubquery = this.dbClient(this.tableName)\n      .max('id')\n      .where('metric_id', metric_id)\n      .whereIn('catalog_entity_ref', catalog_entity_refs)\n      .groupBy('catalog_entity_ref');\n\n    const statusRows = await this.dbClient(this.tableName)\n      .select('status')\n      .count('* as count')\n      .max('timestamp as max_timestamp')\n      .whereIn('id', latestIdsSubquery)\n      .whereNotNull('status')\n      .whereNotNull('value')\n      .groupBy('status');\n\n    if (!statusRows || statusRows.length === 0) {\n      return undefined;\n    }\n\n    // Normalize types for cross-database compatibility\n    // PostgreSQL returns COUNT/SUM as strings, SQLite returns numbers\n    // PostgreSQL returns MAX(timestamp) as Date, SQLite returns number (milliseconds)\n    const normalizeTimestamp = (timestamp: any): Date => {\n      if (timestamp instanceof Date) {\n        return timestamp;\n      } else if (\n        typeof timestamp === 'number' ||\n        typeof timestamp === 'string'\n      ) {\n        return new Date(timestamp);\n      }\n      return new Date();\n    };\n\n    let maxTimestamp = new Date(0);\n    let total = 0;\n    const statusCounts: Record<string, number> = {};\n    for (const row of statusRows) {\n      const rowTimestamp = normalizeTimestamp(row.max_timestamp);\n      if (rowTimestamp > maxTimestamp) {\n        maxTimestamp = rowTimestamp;\n      }\n      const name = row.status as string;\n      const count = Number(row.count);\n      statusCounts[name] = count;\n      total += count;\n    }\n\n    return {\n      metric_id,\n      total,\n      max_timestamp: maxTimestamp,\n      statusCounts,\n    };\n  }\n\n  /**\n   * Fetch the latest entity metric values for a given metric, with optional filtering\n   * by status, name, kind, namespace, or owner, plus sorting and pagination.\n   */\n  async readEntityMetricsWithFilters(\n    metric_id: string,\n    options: ReadEntityMetricsWithFiltersOptions,\n  ): Promise<DbMetricValue[]> {\n    const clientName: string =\n      (this.dbClient as any).client?.config?.client ?? '';\n    const isPostgres = clientName === 'pg' || clientName.includes('postgres');\n\n    const latestIdsSubquery = this.dbClient(this.tableName)\n      .max('id')\n      .where('metric_id', metric_id)\n      .groupBy('catalog_entity_ref');\n\n    const query = this.dbClient(this.tableName)\n      .select('*')\n      .whereIn('id', latestIdsSubquery);\n\n    const sortColumnMap: Record<string, string> = {\n      entityName: 'catalog_entity_ref',\n      owner: 'entity_owner',\n      entityKind: 'entity_kind',\n      timestamp: 'timestamp',\n      metricValue: 'value',\n      namespace: 'entity_namespace',\n      status: 'status',\n    };\n\n    const column =\n      (options.sortBy && sortColumnMap[options.sortBy]) ?? 'timestamp';\n    const direction = options.sortOrder === 'asc' ? 'asc' : 'desc';\n\n    this.applySort(query, options.sortBy, column, direction, isPostgres);\n\n    if (options.status) {\n      query.where('status', options.status);\n    }\n\n    if (options.entityName) {\n      const escaped = options.entityName.replace(/[%_\\\\]/g, '\\\\$&');\n      query.whereRaw(\"catalog_entity_ref LIKE ? ESCAPE '\\\\'\", [`%${escaped}%`]);\n    }\n\n    if (options.entityKind) {\n      query.where('entity_kind', options.entityKind);\n    }\n\n    if (options.entityNamespace) {\n      query.where('entity_namespace', options.entityNamespace);\n    }\n\n    if (options.entityOwner && options.entityOwner.length > 0) {\n      query.whereIn('entity_owner', options.entityOwner);\n    }\n\n    if (options.pagination) {\n      query.limit(options.pagination.limit).offset(options.pagination.offset);\n    }\n\n    return await query;\n  }\n\n  private applySort(\n    query: any,\n    sortBy: string | undefined,\n    column: string,\n    direction: string,\n    isPostgres: boolean,\n  ): void {\n    if (sortBy === 'metricValue') {\n      // value is JSON and nullable; cast for numeric sort with NULLs last\n      if (isPostgres) {\n        query.orderByRaw(\n          `CAST(value::text AS DOUBLE PRECISION) ${direction} NULLS LAST, id ASC`,\n        );\n      } else {\n        // SQLite: \"value IS NULL\" puts nulls last; double-cast handles JSON-stored values\n        query.orderByRaw(\n          `value IS NULL, CAST(CAST(value AS TEXT) AS REAL) ${direction}, id ASC`,\n        );\n      }\n    } else if (sortBy === 'status') {\n      // status is nullable; NULLs always sort last regardless of direction\n      if (isPostgres) {\n        query.orderByRaw(`status ${direction} NULLS LAST, id ASC`);\n      } else {\n        // SQLite: \"status IS NULL\" evaluates to 1 for NULLs, pushing them to the end\n        query.orderByRaw(`status IS NULL, status ${direction}, id ASC`);\n      }\n    } else {\n      query.orderBy(column, direction);\n      // Ensure a stable sort when two metrics share the same primary sort value\n      query.orderBy('id', 'asc');\n    }\n  }\n}\n"],"names":[],"mappings":"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"}
+{"version":3,"file":"DatabaseMetricValues.cjs.js","sources":["../../src/database/DatabaseMetricValues.ts"],"sourcesContent":["/*\n * Copyright Red Hat, Inc.\n *\n * Licensed under the Apache License, Version 2.0 (the \"License\");\n * you may not use this file except in compliance with the License.\n * You may obtain a copy of the License at\n *\n *     http://www.apache.org/licenses/LICENSE-2.0\n *\n * Unless required by applicable law or agreed to in writing, software\n * distributed under the License is distributed on an \"AS IS\" BASIS,\n * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.\n * See the License for the specific language governing permissions and\n * limitations under the License.\n */\n\nimport { Knex } from 'knex';\nimport {\n  DbMetricValueCreate,\n  DbMetricValue,\n  DbAggregatedMetric,\n} from './types';\n\ntype ReadEntityMetricsWithFiltersOptions = {\n  status?: string;\n  entityName?: string;\n  entityKind?: string;\n  entityNamespace?: string;\n  entityOwner?: string[];\n  sortBy?:\n    | 'entityName'\n    | 'owner'\n    | 'entityKind'\n    | 'timestamp'\n    | 'metricValue'\n    | 'namespace'\n    | 'status';\n  sortOrder?: 'asc' | 'desc';\n  pagination?: { limit: number; offset: number };\n};\n\nexport class DatabaseMetricValues {\n  private readonly tableName = 'metric_values';\n\n  constructor(private readonly dbClient: Knex<any, any[]>) {}\n\n  /**\n   * Insert multiple metric values\n   */\n  async createMetricValues(metricValues: DbMetricValueCreate[]): Promise<void> {\n    if (metricValues.length === 0) {\n      return;\n    }\n    await this.dbClient(this.tableName).insert(metricValues);\n  }\n\n  /**\n   * Get the latest metric values for a specific entity and metrics\n   */\n  async readLatestEntityMetricValues(\n    catalog_entity_ref: string,\n    metric_ids: string[],\n  ): Promise<DbMetricValue[]> {\n    return await this.dbClient(this.tableName)\n      .select('*')\n      .whereIn(\n        'id',\n        this.dbClient(this.tableName)\n          .max('id')\n          .whereIn('metric_id', metric_ids)\n          .where('catalog_entity_ref', catalog_entity_ref)\n          .groupBy('metric_id'),\n      );\n  }\n\n  /**\n   * Delete metric values that are older than the given date\n   */\n  async cleanupExpiredMetrics(olderThan: Date): Promise<number> {\n    return await this.dbClient(this.tableName)\n      .where('timestamp', '<', olderThan)\n      .del();\n  }\n\n  /**\n   * Get aggregated metrics by status for multiple entities and metrics.\n   */\n  async readAggregatedMetricByEntityRefs(\n    catalog_entity_refs: string[],\n    metric_id: string,\n  ): Promise<DbAggregatedMetric | undefined> {\n    if (catalog_entity_refs.length === 0) {\n      return undefined;\n    }\n\n    const latestIdsSubquery = this.dbClient(this.tableName)\n      .max('id')\n      .where('metric_id', metric_id)\n      .whereIn('catalog_entity_ref', catalog_entity_refs)\n      .groupBy('catalog_entity_ref');\n\n    // `value` is a JSON column. Depending on database/driver, a \"missing\" metric value can\n    // arrive either as SQL NULL or as JSON literal null (`CAST(value AS TEXT) = 'null'`).\n    const metricValueIsMissingExpr =\n      \"(value IS NULL OR CAST(value AS TEXT) = 'null')\";\n\n    // One round-trip for latest-row count, calculation-error count, and max timestamp\n    // (same latest-id set as the status breakdown query below).\n    const statsRow = await this.dbClient(this.tableName)\n      .whereIn('id', latestIdsSubquery)\n      .select(\n        this.dbClient.raw('COUNT(*) as latest_row_count'),\n        this.dbClient.raw(\n          `SUM(CASE WHEN error_message IS NOT NULL AND ${metricValueIsMissingExpr} THEN 1 ELSE 0 END) as calculation_error_count`,\n        ),\n        this.dbClient.raw('MAX(timestamp) as max_timestamp'),\n      )\n      .first();\n\n    const latestRowCount = Number(\n      (statsRow as { latest_row_count?: string | number } | undefined)\n        ?.latest_row_count ?? 0,\n    );\n    if (latestRowCount === 0) {\n      return undefined;\n    }\n\n    const calculation_error_count = Number(\n      (statsRow as { calculation_error_count?: string | number } | undefined)\n        ?.calculation_error_count ?? 0,\n    );\n\n    // Normalize types for cross-database compatibility\n    // PostgreSQL returns COUNT/SUM as strings, SQLite returns numbers\n    // PostgreSQL returns MAX(timestamp) as Date, SQLite returns number (milliseconds)\n    const normalizeTimestamp = (timestamp: unknown): Date => {\n      if (timestamp instanceof Date) {\n        return timestamp;\n      }\n      if (typeof timestamp === 'number' || typeof timestamp === 'string') {\n        return new Date(timestamp);\n      }\n      return new Date();\n    };\n\n    const maxTimestampAllLatest = normalizeTimestamp(\n      (statsRow as { max_timestamp?: unknown })?.max_timestamp,\n    );\n\n    const statusRows = await this.dbClient(this.tableName)\n      .select('status')\n      .count('* as count')\n      .max('timestamp as max_timestamp')\n      .whereIn('id', latestIdsSubquery)\n      .whereNotNull('status')\n      .whereRaw(`NOT ${metricValueIsMissingExpr}`)\n      .groupBy('status');\n\n    if (!statusRows || statusRows.length === 0) {\n      return {\n        metric_id,\n        total: 0,\n        max_timestamp: maxTimestampAllLatest,\n        statusCounts: {},\n        calculation_error_count,\n        latest_entity_count: latestRowCount,\n      };\n    }\n\n    let maxTimestamp = new Date(0);\n    let total = 0;\n    const statusCounts: Record<string, number> = {};\n    for (const row of statusRows) {\n      const rowTimestamp = normalizeTimestamp(row.max_timestamp);\n      if (rowTimestamp > maxTimestamp) {\n        maxTimestamp = rowTimestamp;\n      }\n      const name = row.status as string;\n      const count = Number(row.count);\n      statusCounts[name] = count;\n      total += count;\n    }\n\n    const mergedMax =\n      maxTimestampAllLatest.getTime() >= maxTimestamp.getTime()\n        ? maxTimestampAllLatest\n        : maxTimestamp;\n\n    return {\n      metric_id,\n      total,\n      max_timestamp: mergedMax,\n      statusCounts,\n      calculation_error_count,\n      latest_entity_count: latestRowCount,\n    };\n  }\n\n  /**\n   * Fetch the latest entity metric values for a given metric, with optional filtering\n   * by status, name, kind, namespace, or owner, plus sorting and pagination.\n   */\n  async readEntityMetricsWithFilters(\n    metric_id: string,\n    options: ReadEntityMetricsWithFiltersOptions,\n  ): Promise<DbMetricValue[]> {\n    const clientName: string =\n      (this.dbClient as any).client?.config?.client ?? '';\n    const isPostgres = clientName === 'pg' || clientName.includes('postgres');\n\n    const latestIdsSubquery = this.dbClient(this.tableName)\n      .max('id')\n      .where('metric_id', metric_id)\n      .groupBy('catalog_entity_ref');\n\n    const query = this.dbClient(this.tableName)\n      .select('*')\n      .whereIn('id', latestIdsSubquery);\n\n    const sortColumnMap: Record<string, string> = {\n      entityName: 'catalog_entity_ref',\n      owner: 'entity_owner',\n      entityKind: 'entity_kind',\n      timestamp: 'timestamp',\n      metricValue: 'value',\n      namespace: 'entity_namespace',\n      status: 'status',\n    };\n\n    const column =\n      (options.sortBy && sortColumnMap[options.sortBy]) ?? 'timestamp';\n    const direction = options.sortOrder === 'asc' ? 'asc' : 'desc';\n\n    this.applySort(query, options.sortBy, column, direction, isPostgres);\n\n    if (options.status) {\n      query.where('status', options.status);\n    }\n\n    if (options.entityName) {\n      const escaped = options.entityName.replace(/[%_\\\\]/g, '\\\\$&');\n      query.whereRaw(\"catalog_entity_ref LIKE ? ESCAPE '\\\\'\", [`%${escaped}%`]);\n    }\n\n    if (options.entityKind) {\n      query.where('entity_kind', options.entityKind);\n    }\n\n    if (options.entityNamespace) {\n      query.where('entity_namespace', options.entityNamespace);\n    }\n\n    if (options.entityOwner && options.entityOwner.length > 0) {\n      query.whereIn('entity_owner', options.entityOwner);\n    }\n\n    if (options.pagination) {\n      query.limit(options.pagination.limit).offset(options.pagination.offset);\n    }\n\n    return await query;\n  }\n\n  private applySort(\n    query: any,\n    sortBy: string | undefined,\n    column: string,\n    direction: string,\n    isPostgres: boolean,\n  ): void {\n    if (sortBy === 'metricValue') {\n      // value is JSON and nullable; cast for numeric sort with NULLs last\n      if (isPostgres) {\n        query.orderByRaw(\n          `CAST(value::text AS DOUBLE PRECISION) ${direction} NULLS LAST, id ASC`,\n        );\n      } else {\n        // SQLite: \"value IS NULL\" puts nulls last; double-cast handles JSON-stored values\n        query.orderByRaw(\n          `value IS NULL, CAST(CAST(value AS TEXT) AS REAL) ${direction}, id ASC`,\n        );\n      }\n    } else if (sortBy === 'status') {\n      // status is nullable; NULLs always sort last regardless of direction\n      if (isPostgres) {\n        query.orderByRaw(`status ${direction} NULLS LAST, id ASC`);\n      } else {\n        // SQLite: \"status IS NULL\" evaluates to 1 for NULLs, pushing them to the end\n        query.orderByRaw(`status IS NULL, status ${direction}, id ASC`);\n      }\n    } else {\n      query.orderBy(column, direction);\n      // Ensure a stable sort when two metrics share the same primary sort value\n      query.orderBy('id', 'asc');\n    }\n  }\n}\n"],"names":[],"mappings":"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"}

package/dist/plugin.cjs.js

@@ -13,6 +13,7 @@ var migration = require('./database/migration.cjs.js');
 var DatabaseMetricValues = require('./database/DatabaseMetricValues.cjs.js');
 var index = require('./scheduler/index.cjs.js');
 var validateAggregationConfig = require('./validation/validateAggregationConfig.cjs.js');
+var AggregationService = require('./service/aggregations/AggregationService.cjs.js');
 
 const scorecardPlugin = backendPluginApi.createBackendPlugin({
   pluginId: "scorecard",
@@ -66,8 +67,12 @@ const scorecardPlugin = backendPluginApi.createBackendPlugin({
           auth,
           registry: metricProvidersRegistry,
           database: dbMetricValues,
-          logger,
-          config
+          logger
+        });
+        const aggregationsService = new AggregationService.AggregationsService({
+          config,
+          database: dbMetricValues,
+          logger
         });
         validateAggregationConfig.validateAggregationConfig({
           rootConfig: config,
@@ -83,10 +88,14 @@ const scorecardPlugin = backendPluginApi.createBackendPlugin({
           metricProvidersRegistry,
           thresholdEvaluator: new ThresholdEvaluator.ThresholdEvaluator()
         }).start();
+        const service = {
+          aggregationsService,
+          catalogMetricService
+        };
         httpRouter.use(
           await router.createRouter({
             metricProvidersRegistry,
-            catalogMetricService,
+            service,
             catalog,
             httpAuth,
             permissions,

package/dist/plugin.cjs.js.map

@@ -1 +1 @@
-{"version":3,"file":"plugin.cjs.js","sources":["../src/plugin.ts"],"sourcesContent":["/*\n * Copyright Red Hat, Inc.\n *\n * Licensed under the Apache License, Version 2.0 (the \"License\");\n * you may not use this file except in compliance with the License.\n * You may obtain a copy of the License at\n *\n *     http://www.apache.org/licenses/LICENSE-2.0\n *\n * Unless required by applicable law or agreed to in writing, software\n * distributed under the License is distributed on an \"AS IS\" BASIS,\n * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.\n * See the License for the specific language governing permissions and\n * limitations under the License.\n */\nimport {\n  coreServices,\n  createBackendPlugin,\n} from '@backstage/backend-plugin-api';\nimport { createRouter } from './service/router';\nimport { catalogServiceRef } from '@backstage/plugin-catalog-node';\nimport {\n  MetricProvider,\n  scorecardMetricsExtensionPoint,\n} from '@red-hat-developer-hub/backstage-plugin-scorecard-node';\nimport { MetricProvidersRegistry } from './providers/MetricProvidersRegistry';\nimport { CatalogMetricService } from './service/CatalogMetricService';\nimport { ThresholdEvaluator } from './threshold/ThresholdEvaluator';\nimport { scorecardPermissions } from '@red-hat-developer-hub/backstage-plugin-scorecard-common';\nimport {\n  scorecardMetricPermissionResourceRef,\n  rules as scorecardRules,\n} from './permissions/rules';\nimport { migrate } from './database/migration';\nimport { DatabaseMetricValues } from './database/DatabaseMetricValues';\nimport { Scheduler } from './scheduler';\nimport { validateAggregationConfig } from './validation/validateAggregationConfig';\n\n/**\n * scorecardPlugin backend plugin\n *\n * @public\n */\nexport const scorecardPlugin = createBackendPlugin({\n  pluginId: 'scorecard',\n  register(env) {\n    const metricProvidersRegistry = new MetricProvidersRegistry();\n\n    env.registerExtensionPoint(scorecardMetricsExtensionPoint, {\n      addMetricProvider(...newMetricProviders: MetricProvider[]) {\n        newMetricProviders.forEach(metricProvider => {\n          metricProvidersRegistry.register(metricProvider);\n        });\n      },\n    });\n\n    env.registerInit({\n      deps: {\n        auth: coreServices.auth,\n        catalog: catalogServiceRef,\n        config: coreServices.rootConfig,\n        database: coreServices.database,\n        httpRouter: coreServices.httpRouter,\n        httpAuth: coreServices.httpAuth,\n        logger: coreServices.logger,\n        permissions: coreServices.permissions,\n        permissionsRegistry: coreServices.permissionsRegistry,\n        scheduler: coreServices.scheduler,\n      },\n      async init({\n        auth,\n        catalog,\n        config,\n        database,\n        httpRouter,\n        httpAuth,\n        logger,\n        permissions,\n        permissionsRegistry,\n        scheduler,\n      }) {\n        permissionsRegistry.addResourceType({\n          resourceRef: scorecardMetricPermissionResourceRef,\n          getResources: async (resourceRefs: string[]) => {\n            return metricProvidersRegistry.listMetrics(resourceRefs);\n          },\n          permissions: scorecardPermissions,\n          rules: Object.values(scorecardRules),\n        });\n\n        // Run database migrations\n        await migrate(database);\n\n        const client = await database.getClient();\n        const dbMetricValues = new DatabaseMetricValues(client);\n\n        const catalogMetricService = new CatalogMetricService({\n          catalog,\n          auth,\n          registry: metricProvidersRegistry,\n          database: dbMetricValues,\n          logger: logger,\n          config,\n        });\n\n        validateAggregationConfig({\n          rootConfig: config,\n          registry: metricProvidersRegistry,\n        });\n\n        Scheduler.create({\n          auth,\n          catalog,\n          config,\n          logger,\n          scheduler,\n          database: dbMetricValues,\n          metricProvidersRegistry,\n          thresholdEvaluator: new ThresholdEvaluator(),\n        }).start();\n\n        httpRouter.use(\n          await createRouter({\n            metricProvidersRegistry,\n            catalogMetricService,\n            catalog,\n            httpAuth,\n            permissions,\n            logger,\n          }),\n        );\n      },\n    });\n  },\n});\n"],"names":["createBackendPlugin","MetricProvidersRegistry","scorecardMetricsExtensionPoint","coreServices","catalogServiceRef","scorecardMetricPermissionResourceRef","scorecardPermissions","scorecardRules","migrate","DatabaseMetricValues","CatalogMetricService","validateAggregationConfig","Scheduler","ThresholdEvaluator","createRouter"],"mappings":";;;;;;;;;;;;;;;;AA2CO,MAAM,kBAAkBA,oCAAoB,CAAA;AAAA,EACjD,QAAU,EAAA,WAAA;AAAA,EACV,SAAS,GAAK,EAAA;AACZ,IAAM,MAAA,uBAAA,GAA0B,IAAIC,+CAAwB,EAAA;AAE5D,IAAA,GAAA,CAAI,uBAAuBC,2DAAgC,EAAA;AAAA,MACzD,qBAAqB,kBAAsC,EAAA;AACzD,QAAA,kBAAA,CAAmB,QAAQ,CAAkB,cAAA,KAAA;AAC3C,UAAA,uBAAA,CAAwB,SAAS,cAAc,CAAA;AAAA,SAChD,CAAA;AAAA;AACH,KACD,CAAA;AAED,IAAA,GAAA,CAAI,YAAa,CAAA;AAAA,MACf,IAAM,EAAA;AAAA,QACJ,MAAMC,6BAAa,CAAA,IAAA;AAAA,QACnB,OAAS,EAAAC,mCAAA;AAAA,QACT,QAAQD,6BAAa,CAAA,UAAA;AAAA,QACrB,UAAUA,6BAAa,CAAA,QAAA;AAAA,QACvB,YAAYA,6BAAa,CAAA,UAAA;AAAA,QACzB,UAAUA,6BAAa,CAAA,QAAA;AAAA,QACvB,QAAQA,6BAAa,CAAA,MAAA;AAAA,QACrB,aAAaA,6BAAa,CAAA,WAAA;AAAA,QAC1B,qBAAqBA,6BAAa,CAAA,mBAAA;AAAA,QAClC,WAAWA,6BAAa,CAAA;AAAA,OAC1B;AAAA,MACA,MAAM,IAAK,CAAA;AAAA,QACT,IAAA;AAAA,QACA,OAAA;AAAA,QACA,MAAA;AAAA,QACA,QAAA;AAAA,QACA,UAAA;AAAA,QACA,QAAA;AAAA,QACA,MAAA;AAAA,QACA,WAAA;AAAA,QACA,mBAAA;AAAA,QACA;AAAA,OACC,EAAA;AACD,QAAA,mBAAA,CAAoB,eAAgB,CAAA;AAAA,UAClC,WAAa,EAAAE,0CAAA;AAAA,UACb,YAAA,EAAc,OAAO,YAA2B,KAAA;AAC9C,YAAO,OAAA,uBAAA,CAAwB,YAAY,YAAY,CAAA;AAAA,WACzD;AAAA,UACA,WAAa,EAAAC,mDAAA;AAAA,UACb,KAAA,EAAO,MAAO,CAAA,MAAA,CAAOC,WAAc;AAAA,SACpC,CAAA;AAGD,QAAA,MAAMC,kBAAQ,QAAQ,CAAA;AAEtB,QAAM,MAAA,MAAA,GAAS,MAAM,QAAA,CAAS,SAAU,EAAA;AACxC,QAAM,MAAA,cAAA,GAAiB,IAAIC,yCAAA,CAAqB,MAAM,CAAA;AAEtD,QAAM,MAAA,oBAAA,GAAuB,IAAIC,yCAAqB,CAAA;AAAA,UACpD,OAAA;AAAA,UACA,IAAA;AAAA,UACA,QAAU,EAAA,uBAAA;AAAA,UACV,QAAU,EAAA,cAAA;AAAA,UACV,MAAA;AAAA,UACA;AAAA,SACD,CAAA;AAED,QAA0BC,mDAAA,CAAA;AAAA,UACxB,UAAY,EAAA,MAAA;AAAA,UACZ,QAAU,EAAA;AAAA,SACX,CAAA;AAED,QAAAC,eAAA,CAAU,MAAO,CAAA;AAAA,UACf,IAAA;AAAA,UACA,OAAA;AAAA,UACA,MAAA;AAAA,UACA,MAAA;AAAA,UACA,SAAA;AAAA,UACA,QAAU,EAAA,cAAA;AAAA,UACV,uBAAA;AAAA,UACA,kBAAA,EAAoB,IAAIC,qCAAmB;AAAA,SAC5C,EAAE,KAAM,EAAA;AAET,QAAW,UAAA,CAAA,GAAA;AAAA,UACT,MAAMC,mBAAa,CAAA;AAAA,YACjB,uBAAA;AAAA,YACA,oBAAA;AAAA,YACA,OAAA;AAAA,YACA,QAAA;AAAA,YACA,WAAA;AAAA,YACA;AAAA,WACD;AAAA,SACH;AAAA;AACF,KACD,CAAA;AAAA;AAEL,CAAC;;;;"}
+{"version":3,"file":"plugin.cjs.js","sources":["../src/plugin.ts"],"sourcesContent":["/*\n * Copyright Red Hat, Inc.\n *\n * Licensed under the Apache License, Version 2.0 (the \"License\");\n * you may not use this file except in compliance with the License.\n * You may obtain a copy of the License at\n *\n *     http://www.apache.org/licenses/LICENSE-2.0\n *\n * Unless required by applicable law or agreed to in writing, software\n * distributed under the License is distributed on an \"AS IS\" BASIS,\n * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.\n * See the License for the specific language governing permissions and\n * limitations under the License.\n */\nimport {\n  coreServices,\n  createBackendPlugin,\n} from '@backstage/backend-plugin-api';\nimport { createRouter } from './service/router';\nimport { catalogServiceRef } from '@backstage/plugin-catalog-node';\nimport {\n  MetricProvider,\n  scorecardMetricsExtensionPoint,\n} from '@red-hat-developer-hub/backstage-plugin-scorecard-node';\nimport { MetricProvidersRegistry } from './providers/MetricProvidersRegistry';\nimport { CatalogMetricService } from './service/CatalogMetricService';\nimport { ThresholdEvaluator } from './threshold/ThresholdEvaluator';\nimport { scorecardPermissions } from '@red-hat-developer-hub/backstage-plugin-scorecard-common';\nimport {\n  scorecardMetricPermissionResourceRef,\n  rules as scorecardRules,\n} from './permissions/rules';\nimport { migrate } from './database/migration';\nimport { DatabaseMetricValues } from './database/DatabaseMetricValues';\nimport { Scheduler } from './scheduler';\nimport { validateAggregationConfig } from './validation/validateAggregationConfig';\nimport { AggregationsService } from './service/aggregations/AggregationService';\n\n/**\n * scorecardPlugin backend plugin\n *\n * @public\n */\nexport const scorecardPlugin = createBackendPlugin({\n  pluginId: 'scorecard',\n  register(env) {\n    const metricProvidersRegistry = new MetricProvidersRegistry();\n\n    env.registerExtensionPoint(scorecardMetricsExtensionPoint, {\n      addMetricProvider(...newMetricProviders: MetricProvider[]) {\n        newMetricProviders.forEach(metricProvider => {\n          metricProvidersRegistry.register(metricProvider);\n        });\n      },\n    });\n\n    env.registerInit({\n      deps: {\n        auth: coreServices.auth,\n        catalog: catalogServiceRef,\n        config: coreServices.rootConfig,\n        database: coreServices.database,\n        httpRouter: coreServices.httpRouter,\n        httpAuth: coreServices.httpAuth,\n        logger: coreServices.logger,\n        permissions: coreServices.permissions,\n        permissionsRegistry: coreServices.permissionsRegistry,\n        scheduler: coreServices.scheduler,\n      },\n      async init({\n        auth,\n        catalog,\n        config,\n        database,\n        httpRouter,\n        httpAuth,\n        logger,\n        permissions,\n        permissionsRegistry,\n        scheduler,\n      }) {\n        permissionsRegistry.addResourceType({\n          resourceRef: scorecardMetricPermissionResourceRef,\n          getResources: async (resourceRefs: string[]) => {\n            return metricProvidersRegistry.listMetrics(resourceRefs);\n          },\n          permissions: scorecardPermissions,\n          rules: Object.values(scorecardRules),\n        });\n\n        // Run database migrations\n        await migrate(database);\n\n        const client = await database.getClient();\n        const dbMetricValues = new DatabaseMetricValues(client);\n\n        const catalogMetricService = new CatalogMetricService({\n          catalog,\n          auth,\n          registry: metricProvidersRegistry,\n          database: dbMetricValues,\n          logger: logger,\n        });\n\n        const aggregationsService = new AggregationsService({\n          config,\n          database: dbMetricValues,\n          logger: logger,\n        });\n\n        validateAggregationConfig({\n          rootConfig: config,\n          registry: metricProvidersRegistry,\n        });\n\n        Scheduler.create({\n          auth,\n          catalog,\n          config,\n          logger,\n          scheduler,\n          database: dbMetricValues,\n          metricProvidersRegistry,\n          thresholdEvaluator: new ThresholdEvaluator(),\n        }).start();\n\n        const service = {\n          aggregationsService: aggregationsService,\n          catalogMetricService: catalogMetricService,\n        };\n\n        httpRouter.use(\n          await createRouter({\n            metricProvidersRegistry,\n            service,\n            catalog,\n            httpAuth,\n            permissions,\n            logger,\n          }),\n        );\n      },\n    });\n  },\n});\n"],"names":["createBackendPlugin","MetricProvidersRegistry","scorecardMetricsExtensionPoint","coreServices","catalogServiceRef","scorecardMetricPermissionResourceRef","scorecardPermissions","scorecardRules","migrate","DatabaseMetricValues","CatalogMetricService","AggregationsService","validateAggregationConfig","Scheduler","ThresholdEvaluator","createRouter"],"mappings":"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"}

package/dist/service/CatalogMetricService.cjs.js

@@ -5,17 +5,25 @@ var normalizeOwnerRef = require('../utils/normalizeOwnerRef.cjs.js');
 var errors = require('@backstage/errors');
 var permissionUtils = require('../permissions/permissionUtils.cjs.js');
 var mergeEntityAndProviderThresholds = require('../utils/mergeEntityAndProviderThresholds.cjs.js');
+var metricCalculationError = require('../utils/metricCalculationError.cjs.js');
 var mappers = require('./mappers.cjs.js');
-var buildAggregationConfig = require('../utils/buildAggregationConfig.cjs.js');
-var aggregationKPIs = require('../constants/aggregationKPIs.cjs.js');
 
 class CatalogMetricService {
+  static entityHealthSummary(accessibleRows, countsArePartial) {
+    const calculationErrorCount = accessibleRows.filter(
+      (row) => metricCalculationError.isMetricCalculationError(row)
+    ).length;
+    return {
+      totalEntities: accessibleRows.length,
+      calculationErrorCount,
+      countsArePartial
+    };
+  }
   logger;
   catalog;
   auth;
   registry;
   database;
-  config;
   static MAX_FETCHABLE_ROWS = 1e4;
   static BATCH_SIZE = 100;
   constructor(options) {
@@ -24,7 +32,6 @@ class CatalogMetricService {
     this.registry = options.registry;
     this.database = options.database;
     this.logger = options.logger;
-    this.config = options.config;
   }
   /**
    * Get latest metric results for a specific catalog entity.
@@ -67,7 +74,10 @@ class CatalogMetricService {
         } catch (error) {
           thresholdError = errors.stringifyError(error);
         }
-        const isMetricCalcError = error_message !== null && value === null;
+        const isMetricCalcError = metricCalculationError.isMetricCalculationError({
+          value,
+          error_message
+        });
         return {
           id: metric.id,
           status: isMetricCalcError ? "error" : "success",
@@ -163,7 +173,8 @@ class CatalogMetricService {
           total: 0,
           totalPages: 0,
           isCapped: false
-        }
+        },
+        entityHealth: CatalogMetricService.entityHealthSummary([], false)
       };
     }
     const rows = await this.database.readEntityMetricsWithFilters(metricId, {
@@ -219,7 +230,8 @@ class CatalogMetricService {
           total: 0,
           totalPages: 0,
           isCapped: false
-        }
+        },
+        entityHealth: CatalogMetricService.entityHealthSummary([], false)
       };
     }
     const isCapped = rows.length === CatalogMetricService.MAX_FETCHABLE_ROWS;
@@ -243,7 +255,11 @@ class CatalogMetricService {
           total: totalFiltered,
           totalPages: Math.ceil(totalFiltered / options.limit),
           isCapped
-        }
+        },
+        entityHealth: CatalogMetricService.entityHealthSummary(
+          accessibleRows,
+          isCapped
+        )
       };
     }
     const enrichedEntities = [];
@@ -275,40 +291,13 @@ class CatalogMetricService {
         total: totalFiltered,
         totalPages: Math.ceil(totalFiltered / options.limit),
         isCapped
-      }
+      },
+      entityHealth: CatalogMetricService.entityHealthSummary(
+        accessibleRows,
+        isCapped
+      )
     };
   }
-  /**
-   * Get the aggregation configs for a given aggregation IDs filtered by metric IDs.
-   * If no aggregation IDs are provided, all aggregation configs will be returned.
-   * If no metric IDs are provided, all metrics will be included.
-   *
-   * @param aggregationIds - Optional array of aggregation IDs to fetch the configs for.
-   * @param metricIds - Optional array of metric IDs, when provided, only aggregations whose config metricId is in this array will be returned.
-   * @returns Aggregation configs
-   */
-  getAggregationConfigs(aggregationIds = [], metricIds = []) {
-    const aggregationKPIsConfig = this.config.getOptionalConfig(
-      aggregationKPIs.AGGREGATION_KPIS_CONFIG_PATH
-    );
-    if (!aggregationKPIsConfig) {
-      return [];
-    }
-    const aggregations = [];
-    const aggregationConfigIds = aggregationIds.length > 0 ? aggregationIds : aggregationKPIsConfig.keys();
-    for (const aggregationId of aggregationConfigIds) {
-      const config = aggregationKPIsConfig.getOptionalConfig(aggregationId);
-      if (config) {
-        const aggregationConfig = buildAggregationConfig.buildAggregationConfig(aggregationId, {
-          config
-        });
-        if (metricIds.length === 0 || metricIds.includes(aggregationConfig.metricId)) {
-          aggregations.push(aggregationConfig);
-        }
-      }
-    }
-    return aggregations;
-  }
 }
 
 exports.CatalogMetricService = CatalogMetricService;