@backstage-community/plugin-tech-insights-maturity 0.2.0

package/CHANGELOG.md

@@ -0,0 +1,21 @@
+# @backstage-community/plugin-tech-insights-maturity
+
+## 0.2.0
+
+### Minor Changes
+
+- e919e53: Backstage version bump to v1.35.1
+
+### Patch Changes
+
+- f015469: Introducing a new tech insights react plugin for reusuable frontend utilities. All migrated components and APIs have been marked as deprecated. Please update your imports to come from `@backstage-community/plugin-tech-insights-react`
+
+  Package json files for each plugin have been updated to reflect the new plugin in the Backstage `pluginPackages` metadata.
+
+- Updated dependencies [f015469]
+- Updated dependencies [f015469]
+- Updated dependencies [e919e53]
+- Updated dependencies [c107e0f]
+  - @backstage-community/plugin-tech-insights-maturity-common@0.2.0
+  - @backstage-community/plugin-tech-insights-common@0.5.0
+  - @backstage-community/plugin-tech-insights@0.5.0

package/README.md

@@ -0,0 +1,177 @@
+# Tech Insights Maturity
+
+Tech Insights Maturity helps teams see where their services stand and get actionable steps for improving them. This plugin introduces maturity rankings and categories into your checks.
+
+## Maturity Ranks
+
+Maturity Ranks are assigned to components based on their fulfillment of their required Maturity Checks associated with each Rank.
+
+These are the currently available Maturity Ranks:
+
+<img src="./src/img/stone.png" width="15" height="15" /> **Stone**: Default, base-level rank. Components with this Rank are failing one or more Bronze-level Check.
+
+<img src="./src/img/bronze.png" width="15" height="15" /> **Bronze**: Components with this Rank have fulfilled all Bronze-level Checks.
+
+<img src="./src/img/silver.png" width="15" height="15" /> **Silver**: Components with this Rank have fulfilled all Bronze- and Silver-level Checks.
+
+<img src="./src/img/gold.png" width="15" height="15" /> **Gold**: Components with this Rank have fulfilled all Bronze-, Silver-, and Gold-level Checks.
+
+## Installation
+
+### Install the plugin
+
+```bash
+# From your Backstage root directory
+yarn --cwd packages/app add @backstage-community/plugin-tech-insights-maturity
+```
+
+### Add Maturity Summary Card to the entity overview page:
+
+If you want to show Maturity Summary in the overview of any entity use `EntityMaturitySummaryCard`.
+Note: This applies to all types of entity.
+
+<img src="./img/maturitySummaryCard.png" width="700" height="350" />
+
+```tsx
+// packages/app/src/components/catalog/EntityPage.tsx
+
+import { EntityMaturitySummaryCard } from '@backstage-community/plugin-tech-insights-maturity';
+
+const overviewContent = (
+  <Grid container spacing={3} alignItems="stretch">
+    {entityWarningContent}
+    <Grid item md={3} xs={6}>
+      <EntityAboutCard variant="gridItem" />
+    </Grid>
+    <Grid item md={3} xs={6}>
+      <EntityCatalogGraphCard variant="gridItem" height={400} />
+    </Grid>
+    ...
+    <Grid item md={3} xs={6}>
+      <EntityMaturitySummaryCard />
+    </Grid>
+  </Grid>
+);
+```
+
+### Add Maturity Checks overview (Maturity Scorecards) page to the any Component EntityPage:
+
+Note: This only applies to entities of Kind: 'Component'
+
+<img src="./img/maturityScorecardContent.png" width="700" height="350" />
+
+```tsx
+// packages/app/src/components/catalog/EntityPage.tsx
+
+import { EntityMaturityScorecardContent } from '@backstage-community/plugin-tech-insight-maturity';
+
+const componentEntityPage = (
+  <EntityLayoutWrapper>
+    <EntityLayout.Route path="/" title="Overview">
+      {overviewContent}
+    </EntityLayout.Route>
+    <EntityLayout.Route path="/ci-cd" title="CI/CD">
+      {cicdContent}
+    </EntityLayout.Route>
+    ...
+    <EntityLayout.Route path="/maturity" title="Maturity">
+      <EntityMaturityScorecardContent />
+    </EntityLayout.Route>
+    ...
+  </EntityLayoutWrapper>
+);
+```
+
+### Add Maturity Summary overview page to System/Domain/Group:
+
+Note: This only applies to entities of Kind: 'System', 'Domain', or 'Group'
+
+<img src="./img/maturitySummaryCardContent.png" width="700" height="350" />
+
+```tsx
+// packages/app/src/components/catalog/EntityPage.tsx
+
+import { EntityMaturitySummaryCardContent } from '@backstage-community/plugin-tech-insight-maturity';
+
+const systemEntityPage = (
+  <EntityLayoutWrapper>
+    <EntityLayout.Route path="/" title="Overview">
+      {overviewContent}
+    </EntityLayout.Route>
+    ...
+    <EntityLayout.Route path="/maturity" title="Maturity">
+      <EntityMaturitySummaryCardContent />
+    </EntityLayout.Route>
+    ...
+  </EntityLayoutWrapper>
+);
+```
+
+### Add Maturity page:
+
+<img src="./img/maturityPage.png" width="700" height="350" />
+
+First make the Maturity page available as route
+
+```tsx
+// packages/app/src/App.tsx
+
+import { MaturityPage } from '@backstage-community/plugin-tech-insights-maturity';
+
+const routes = (
+  <FlatRoutes>
+    ...
+    <Route path="/maturity" element={<MaturityPage />} />
+  </FlatRoutes>
+);
+```
+
+Then add it to the navigation menu
+
+```tsx
+// packages/app/src/components/Root/Root.tsx
+
+import EmojiObjectsIcon from '@material-ui/icons/EmojiObjects';
+
+export const Root = ({ children }: PropsWithChildren<{}>) => (
+  ...
+  <SidebarItem icon={EmojiObjectsIcon} to="maturity" text="Maturity" />
+  ...
+);
+```
+
+## Compatibility!!
+
+This module is based on the existing Tech Insights Plugin and should be compatible with any existing implementations of [tech-insights-backend](../../../tech-insights/plugins/tech-insights-backend/README.md) or [tech-insights-backend-module-jsonfc](../../../tech-insights/plugins/tech-insights-backend-module-jsonfc/README.md).
+
+If you don't have any existing Tech Insights implementation, make sure to set it up first before you can use this frontend plugin.
+
+After configuring your backend, add Maturity Metadata to all of your checks!
+
+Sample check written in app-config:
+
+```yaml title="app-config.yaml"
+techInsights:
+  factRetrievers: ...
+  factChecker:
+    checks:
+      groupOwnerCheck:
+        ...
+        metadata:
+          category: 'Ownership',
+          rank: 1, // rank values: Bronze - 1, Silver - 2, Gold - 3
+          solution: 'Add a group owner to spec.owner field in the factbook',
+```
+
+Sample check written in TS
+
+```ts
+export const groupOwnerCheck = {
+  ...,
+  metadata: {
+    category: 'Ownership',
+    rank: 1, // rank values: Bronze - 1, Silver - 2, Gold - 3
+    solution: 'Add a group owner to spec.owner field in the factbook',
+  },
+};
+```

package/dist/ScoreRouter.esm.js

@@ -0,0 +1,8 @@
+import React from 'react';
+import { Routes, Route } from 'react-router-dom';
+import { MaturityScorePage } from './components/MaturityScorePage/MaturityScorePage.esm.js';
+
+const ScoreRouter = () => /* @__PURE__ */ React.createElement(Routes, null, /* @__PURE__ */ React.createElement(Route, { path: "/", element: /* @__PURE__ */ React.createElement(MaturityScorePage, null) }));
+
+export { ScoreRouter };
+//# sourceMappingURL=ScoreRouter.esm.js.map

package/dist/ScoreRouter.esm.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"ScoreRouter.esm.js","sources":["../src/ScoreRouter.tsx"],"sourcesContent":["/*\n * Copyright 2025 The Backstage Authors\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 React from 'react';\nimport { Route, Routes } from 'react-router-dom';\nimport { MaturityScorePage } from './components/MaturityScorePage';\n\nexport const ScoreRouter = () => (\n  <Routes>\n    <Route path=\"/\" element={<MaturityScorePage />} />\n  </Routes>\n);\n"],"names":[],"mappings":";;;;AAmBO,MAAM,WAAc,GAAA,sBACxB,KAAA,CAAA,aAAA,CAAA,MAAA,EAAA,IAAA,kBACE,KAAA,CAAA,aAAA,CAAA,KAAA,EAAA,EAAM,IAAK,EAAA,GAAA,EAAI,OAAS,kBAAA,KAAA,CAAA,aAAA,CAAC,iBAAkB,EAAA,IAAA,CAAA,EAAI,CAClD;;;;"}

package/dist/SummaryRouter.esm.js

@@ -0,0 +1,8 @@
+import React from 'react';
+import { Routes, Route } from 'react-router-dom';
+import { MaturitySummaryPage } from './components/MaturitySummaryPage/MaturitySummaryPage.esm.js';
+
+const SummaryRouter = () => /* @__PURE__ */ React.createElement(Routes, null, /* @__PURE__ */ React.createElement(Route, { path: "/", element: /* @__PURE__ */ React.createElement(MaturitySummaryPage, null) }));
+
+export { SummaryRouter };
+//# sourceMappingURL=SummaryRouter.esm.js.map

package/dist/SummaryRouter.esm.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"SummaryRouter.esm.js","sources":["../src/SummaryRouter.tsx"],"sourcesContent":["/*\n * Copyright 2025 The Backstage Authors\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 React from 'react';\nimport { Route, Routes } from 'react-router-dom';\nimport { MaturitySummaryPage } from './components/MaturitySummaryPage';\n\nexport const SummaryRouter = () => (\n  <Routes>\n    <Route path=\"/\" element={<MaturitySummaryPage />} />\n  </Routes>\n);\n"],"names":[],"mappings":";;;;AAmBO,MAAM,aAAgB,GAAA,sBAC1B,KAAA,CAAA,aAAA,CAAA,MAAA,EAAA,IAAA,kBACE,KAAA,CAAA,aAAA,CAAA,KAAA,EAAA,EAAM,IAAK,EAAA,GAAA,EAAI,OAAS,kBAAA,KAAA,CAAA,aAAA,CAAC,mBAAoB,EAAA,IAAA,CAAA,EAAI,CACpD;;;;"}

package/dist/api/MaturityApi.esm.js

@@ -0,0 +1,8 @@
+import { createApiRef } from '@backstage/core-plugin-api';
+
+const maturityApiRef = createApiRef({
+  id: "plugin.maturity.service"
+});
+
+export { maturityApiRef };
+//# sourceMappingURL=MaturityApi.esm.js.map

package/dist/api/MaturityApi.esm.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"MaturityApi.esm.js","sources":["../../src/api/MaturityApi.ts"],"sourcesContent":["/*\n * Copyright 2025 The Backstage Authors\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 { TechInsightsApi } from '@backstage-community/plugin-tech-insights';\nimport { Entity } from '@backstage/catalog-model';\nimport { createApiRef } from '@backstage/core-plugin-api';\nimport {\n  BulkMaturityCheckResponse,\n  BulkMaturitySummary,\n  MaturityRank,\n  MaturityScore,\n  MaturitySummary,\n} from '@backstage-community/plugin-tech-insights-maturity-common';\n\n/**\n *  {@link @backstage/core-plugin-api#ApiRef} for the {@link MaturityApi}\n *\n * @public\n */\nexport const maturityApiRef = createApiRef<MaturityApi>({\n  id: 'plugin.maturity.service',\n});\n\n/**\n * Maturity API client interface extention of TechInsightsApi\n *\n * @public\n */\nexport type MaturityApi = TechInsightsApi & {\n  getMaturityRank(entity: Entity): Promise<MaturityRank>;\n  getMaturityScore(entity: Entity): Promise<MaturityScore>;\n  getBulkMaturityCheckResults(\n    entities: Entity[],\n  ): Promise<BulkMaturityCheckResponse>;\n  getChildMaturityCheckResults(\n    entity: Entity,\n  ): Promise<BulkMaturityCheckResponse>;\n  getMaturitySummary(entity: Entity): Promise<MaturitySummary>;\n  getBulkMaturitySummary(entities: Entity[]): Promise<BulkMaturitySummary>;\n};\n"],"names":[],"mappings":";;AA+BO,MAAM,iBAAiB,YAA0B,CAAA;AAAA,EACtD,EAAI,EAAA;AACN,CAAC;;;;"}

package/dist/api/MaturityClient.esm.js

@@ -0,0 +1,128 @@
+import { getCompoundEntityRef, stringifyEntityRef, isComponentEntity, RELATION_HAS_PART, RELATION_PARENT_OF, RELATION_OWNER_OF } from '@backstage/catalog-model';
+import { getEntityRelations } from '@backstage/plugin-catalog-react';
+import { TechInsightsClient } from '@backstage-community/plugin-tech-insights';
+import { ScoringDataFormatter } from './ScoringDataFormatter.esm.js';
+
+const SDF = new ScoringDataFormatter();
+class MaturityClient extends TechInsightsClient {
+  catalogApi;
+  constructor(options) {
+    super(options);
+    this.catalogApi = options.catalogApi;
+  }
+  async getMaturityRank(entity) {
+    const checksResult = await this.getCheckResults(entity);
+    return SDF.getMaturityRank(checksResult);
+  }
+  async getBulkMaturityCheckResults(entities) {
+    return await this.getBulkCheckResults(
+      entities.map((x) => getCompoundEntityRef(x))
+    );
+  }
+  async getMaturityScore(entity) {
+    const checks = await this.getCheckResults(entity);
+    const rank = SDF.getMaturityRank(checks);
+    const summary = SDF.getMaturitySummary(checks);
+    return {
+      checks,
+      summary,
+      rank
+    };
+  }
+  async getChildMaturityCheckResults(entity) {
+    const entities = await this.getRelatedComponents(entity);
+    return await this.getBulkCheckResults(entities);
+  }
+  async getMaturitySummary(entity) {
+    const checksResult = await this.getCheckResults(entity);
+    return SDF.getMaturitySummary(checksResult);
+  }
+  async getBulkMaturitySummary(entities) {
+    return Promise.all(
+      entities.map(async (x) => {
+        const checks = await this.getCheckResults(x);
+        const summary = SDF.getMaturitySummary(checks);
+        const rank = SDF.getMaturityRank(checks);
+        return {
+          entity: stringifyEntityRef(x),
+          rank: rank.rank,
+          isMaxRank: rank.isMaxRank,
+          summary
+        };
+      })
+    );
+  }
+  async getCheckResults(entity) {
+    if (isComponentEntity(entity)) {
+      return await this.runChecks(
+        getCompoundEntityRef(entity)
+      );
+    }
+    const entities = await this.getRelatedComponents(entity);
+    return await this.getGroupCheckResults(entities);
+  }
+  async getBulkCheckResults(entities) {
+    const bulkResponse = await this.runBulkChecks(entities);
+    return Promise.all(
+      bulkResponse.map(async (x) => {
+        const checks = x.results;
+        const rank = SDF.getMaturityRank(checks);
+        return {
+          entity: x.entity,
+          rank: rank.rank,
+          isMaxRank: rank.isMaxRank,
+          checks
+        };
+      })
+    );
+  }
+  async getGroupCheckResults(entities) {
+    if (entities.length === 0) {
+      return [];
+    }
+    const results = [];
+    const bulkResponse = await this.runBulkChecks(entities);
+    for (const response of bulkResponse) {
+      Array.prototype.push.apply(results, response.results);
+    }
+    return results;
+  }
+  async getRelatedComponents(entity) {
+    switch (entity.kind) {
+      case "System":
+        return getEntityRelations(entity, RELATION_HAS_PART);
+      case "Domain":
+        return await this.getRelatedComponentsByRefs(
+          getEntityRelations(entity, RELATION_HAS_PART)
+        );
+      case "Group":
+        return this.getComponentsForGroup(entity);
+      default:
+        return [getCompoundEntityRef(entity)];
+    }
+  }
+  async getComponentsForGroup(entity) {
+    const childEntities = getEntityRelations(entity, RELATION_PARENT_OF);
+    if (childEntities.length > 0) {
+      return await this.getRelatedComponentsByRefs(childEntities);
+    }
+    const entityPartsRef = getEntityRelations(entity, RELATION_OWNER_OF);
+    return await this.getRelatedComponentsByRefs(entityPartsRef);
+  }
+  async getRelatedComponentsByRefs(refs) {
+    const { items } = await this.catalogApi.getEntitiesByRefs({
+      entityRefs: refs.map((x) => stringifyEntityRef(x))
+    });
+    const entityParts = [];
+    for (const item of items) {
+      Array.prototype.push.apply(
+        entityParts,
+        await this.getRelatedComponents(item)
+      );
+    }
+    return entityParts;
+  }
+}
+
+export { MaturityClient };
+//# sourceMappingURL=MaturityClient.esm.js.map

package/dist/api/MaturityClient.esm.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"MaturityClient.esm.js","sources":["../../src/api/MaturityClient.ts"],"sourcesContent":["/*\n * Copyright 2025 The Backstage Authors\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 { CatalogApi } from '@backstage/catalog-client';\nimport {\n  CompoundEntityRef,\n  Entity,\n  getCompoundEntityRef,\n  isComponentEntity,\n  RELATION_HAS_PART,\n  RELATION_OWNER_OF,\n  RELATION_PARENT_OF,\n  stringifyEntityRef,\n} from '@backstage/catalog-model';\nimport { DiscoveryApi, IdentityApi } from '@backstage/core-plugin-api';\nimport { getEntityRelations } from '@backstage/plugin-catalog-react';\nimport { TechInsightsClient } from '@backstage-community/plugin-tech-insights';\nimport {\n  BulkMaturityCheckResponse,\n  BulkMaturitySummary,\n  MaturityCheckResult,\n  MaturityRank,\n  MaturityScore,\n  MaturitySummary,\n} from '@backstage-community/plugin-tech-insights-maturity-common';\nimport { MaturityApi } from './MaturityApi';\nimport { ScoringDataFormatter } from './ScoringDataFormatter';\n\nconst SDF = new ScoringDataFormatter();\n\n/**\n * MaturityClient extension of TechInsightsClient\n *\n * @public\n */\nexport class MaturityClient extends TechInsightsClient implements MaturityApi {\n  readonly catalogApi: CatalogApi;\n\n  constructor(options: {\n    discoveryApi: DiscoveryApi;\n    identityApi: IdentityApi;\n    catalogApi: CatalogApi;\n  }) {\n    super(options);\n    this.catalogApi = options.catalogApi;\n  }\n\n  public async getMaturityRank(entity: Entity): Promise<MaturityRank> {\n    const checksResult = await this.getCheckResults(entity);\n    return SDF.getMaturityRank(checksResult);\n  }\n\n  public async getBulkMaturityCheckResults(\n    entities: Entity[],\n  ): Promise<BulkMaturityCheckResponse> {\n    return await this.getBulkCheckResults(\n      entities.map(x => getCompoundEntityRef(x)),\n    );\n  }\n\n  public async getMaturityScore(entity: Entity): Promise<MaturityScore> {\n    const checks = await this.getCheckResults(entity);\n    const rank = SDF.getMaturityRank(checks);\n    const summary = SDF.getMaturitySummary(checks);\n    return {\n      checks,\n      summary,\n      rank,\n    };\n  }\n\n  public async getChildMaturityCheckResults(\n    entity: Entity,\n  ): Promise<BulkMaturityCheckResponse> {\n    const entities = await this.getRelatedComponents(entity);\n    return await this.getBulkCheckResults(entities);\n  }\n\n  public async getMaturitySummary(entity: Entity): Promise<MaturitySummary> {\n    const checksResult = await this.getCheckResults(entity);\n    return SDF.getMaturitySummary(checksResult);\n  }\n\n  public async getBulkMaturitySummary(\n    entities: Entity[],\n  ): Promise<BulkMaturitySummary> {\n    return Promise.all(\n      entities.map(async x => {\n        const checks = await this.getCheckResults(x);\n        const summary = SDF.getMaturitySummary(checks);\n        const rank = SDF.getMaturityRank(checks);\n\n        return {\n          entity: stringifyEntityRef(x),\n          rank: rank.rank,\n          isMaxRank: rank.isMaxRank,\n          summary,\n        };\n      }),\n    );\n  }\n\n  private async getCheckResults(\n    entity: Entity,\n  ): Promise<MaturityCheckResult[]> {\n    if (isComponentEntity(entity)) {\n      return (await this.runChecks(\n        getCompoundEntityRef(entity),\n      )) as MaturityCheckResult[];\n    }\n\n    const entities = await this.getRelatedComponents(entity);\n    return await this.getGroupCheckResults(entities);\n  }\n\n  private async getBulkCheckResults(entities: CompoundEntityRef[]) {\n    const bulkResponse = await this.runBulkChecks(entities);\n    return Promise.all(\n      bulkResponse.map(async x => {\n        const checks = x.results as MaturityCheckResult[];\n        const rank = SDF.getMaturityRank(checks);\n\n        return {\n          entity: x.entity,\n          rank: rank.rank,\n          isMaxRank: rank.isMaxRank,\n          checks,\n        };\n      }),\n    );\n  }\n\n  private async getGroupCheckResults(\n    entities: CompoundEntityRef[],\n  ): Promise<MaturityCheckResult[]> {\n    /**\n     * Passing an empty array into techInsightsClient.runBulkChecks()\n     * now causes checks to run across the entire catalog.\n     * We don't want to run checks here if no entities were provided.\n     */\n    if (entities.length === 0) {\n      return [];\n    }\n\n    const results: MaturityCheckResult[] = [];\n    const bulkResponse = await this.runBulkChecks(entities);\n    for (const response of bulkResponse) {\n      Array.prototype.push.apply(results, response.results);\n    }\n\n    return results;\n  }\n\n  private async getRelatedComponents(\n    entity: Entity,\n  ): Promise<CompoundEntityRef[]> {\n    switch (entity.kind) {\n      case 'System':\n        return getEntityRelations(entity, RELATION_HAS_PART);\n      case 'Domain':\n        return await this.getRelatedComponentsByRefs(\n          getEntityRelations(entity, RELATION_HAS_PART),\n        );\n      case 'Group':\n        return this.getComponentsForGroup(entity);\n      default:\n        return [getCompoundEntityRef(entity)];\n    }\n  }\n\n  private async getComponentsForGroup(\n    entity: Entity,\n  ): Promise<CompoundEntityRef[]> {\n    const childEntities = getEntityRelations(entity, RELATION_PARENT_OF);\n    if (childEntities.length > 0) {\n      return await this.getRelatedComponentsByRefs(childEntities);\n    }\n    const entityPartsRef = getEntityRelations(entity, RELATION_OWNER_OF);\n    return await this.getRelatedComponentsByRefs(entityPartsRef);\n  }\n\n  private async getRelatedComponentsByRefs(refs: CompoundEntityRef[]) {\n    const { items } = await this.catalogApi.getEntitiesByRefs({\n      entityRefs: refs.map(x => stringifyEntityRef(x)),\n    });\n\n    const entityParts: CompoundEntityRef[] = [];\n    for (const item of items) {\n      Array.prototype.push.apply(\n        entityParts,\n        await this.getRelatedComponents(item!),\n      );\n    }\n    return entityParts;\n  }\n}\n"],"names":[],"mappings":"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"}

package/dist/api/ScoringDataFormatter.esm.js

@@ -0,0 +1,142 @@
+import { Rank } from '@backstage-community/plugin-tech-insights-maturity-common';
+
+class ScoringDataFormatter {
+  getMaturityRank(results) {
+    return this.calculateRank(results);
+  }
+  getMaturitySummary(results) {
+    const { rank, isMaxRank } = this.calculateRank(results);
+    const maxRank = this.calculateMaxRank(results);
+    const nextRank = isMaxRank ? maxRank : rank + 1;
+    const scoresByArea = this.groupCheckResultByCategory(results);
+    let totalChecks = 0;
+    let passedChecks = 0;
+    let rankTotalChecks = 0;
+    let rankPassedChecks = 0;
+    const areaSummaries = Object.entries(scoresByArea).map(([areaName, areaResults]) => {
+      const { rank: areaRank, isMaxRank: areaIsMaxRank } = this.calculateRank(areaResults);
+      const areaMaxRank = this.calculateMaxRank(areaResults);
+      const areaNextRank = areaIsMaxRank ? areaMaxRank : areaRank + 1;
+      let areaTotalChecks = 0;
+      let areaPassedChecks = 0;
+      const areaRankTotalChecks = {
+        [Rank.Stone]: 0,
+        [Rank.Bronze]: 0,
+        [Rank.Silver]: 0,
+        [Rank.Gold]: 0
+      };
+      const areaRankPassedChecks = {
+        [Rank.Stone]: 0,
+        [Rank.Bronze]: 0,
+        [Rank.Silver]: 0,
+        [Rank.Gold]: 0
+      };
+      areaResults.forEach((checkResult) => {
+        areaTotalChecks++;
+        if (checkResult.result) {
+          areaPassedChecks++;
+        }
+        areaRankTotalChecks[checkResult.check.metadata.rank]++;
+        if (checkResult.result) {
+          areaRankPassedChecks[checkResult.check.metadata.rank]++;
+        }
+      });
+      totalChecks += areaTotalChecks;
+      passedChecks += areaPassedChecks;
+      rankTotalChecks += areaRankTotalChecks[nextRank];
+      rankPassedChecks += areaRankPassedChecks[nextRank];
+      const areaProgPercent = this.calculatePercent(
+        areaPassedChecks,
+        areaTotalChecks
+      );
+      const areaRankProgPercent = this.calculatePercent(
+        areaRankPassedChecks[areaNextRank],
+        areaRankTotalChecks[areaNextRank]
+      );
+      return {
+        area: areaName,
+        progress: {
+          passedChecks: areaPassedChecks,
+          totalChecks: areaTotalChecks,
+          percentage: areaProgPercent
+        },
+        rankProgress: {
+          passedChecks: areaRankPassedChecks[areaNextRank],
+          totalChecks: areaRankTotalChecks[areaNextRank],
+          percentage: areaRankProgPercent
+        },
+        rank: areaRank,
+        maxRank: areaMaxRank,
+        isMaxRank: areaIsMaxRank
+      };
+    }).sort((a, b) => a.area > b.area ? -1 : 1);
+    const progPercent = this.calculatePercent(passedChecks, totalChecks);
+    const rankProgPercent = this.calculatePercent(
+      rankPassedChecks,
+      rankTotalChecks
+    );
+    return {
+      points: this.calculatePoints(results),
+      progress: {
+        passedChecks,
+        totalChecks,
+        percentage: progPercent
+      },
+      rankProgress: {
+        passedChecks: rankPassedChecks,
+        totalChecks: rankTotalChecks,
+        percentage: rankProgPercent
+      },
+      rank,
+      maxRank,
+      isMaxRank,
+      areaSummaries
+    };
+  }
+  /**
+   * Some checks within one Area are divided as they should be applied for certain types of Components only
+   * When displaying Area scores in the UI they should be concatenated again for total Area score calculation
+   */
+  groupCheckResultByCategory(results) {
+    const checksByCategory = {};
+    results.forEach((checkResult) => {
+      checksByCategory[checkResult.check.metadata.category] ??= [];
+      checksByCategory[checkResult.check.metadata.category].push(checkResult);
+    });
+    return checksByCategory;
+  }
+  /** Calculated rank based on the total performance of all areas */
+  calculateRank(results) {
+    const maxRank = this.calculateMaxRank(results);
+    let rank = maxRank;
+    results.forEach((checkResult) => {
+      if (!checkResult.result && checkResult.check.metadata.rank <= rank) {
+        rank = checkResult.check.metadata.rank - 1;
+      }
+    });
+    const isMaxRank = rank === maxRank;
+    return { rank, isMaxRank };
+  }
+  calculateMaxRank(results) {
+    let rank = Rank.Stone;
+    results.forEach((checkResult) => {
+      if (checkResult.check.metadata.rank > rank) {
+        rank = checkResult.check.metadata.rank;
+      }
+    });
+    return rank;
+  }
+  calculatePoints(results) {
+    let points = 0;
+    results.filter((checkResult) => checkResult.result).forEach((checkResult) => {
+      points += checkResult.check.metadata.rank * 100;
+    });
+    return points;
+  }
+  calculatePercent(passedChecks, totalChecks) {
+    return totalChecks === 0 ? 0 : Math.round(passedChecks / totalChecks * 100);
+  }
+}
+
+export { ScoringDataFormatter };
+//# sourceMappingURL=ScoringDataFormatter.esm.js.map

package/dist/api/ScoringDataFormatter.esm.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"ScoringDataFormatter.esm.js","sources":["../../src/api/ScoringDataFormatter.ts"],"sourcesContent":["/*\n * Copyright 2025 The Backstage Authors\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  MaturityCheckResult,\n  MaturityRank,\n  MaturitySummary,\n  MaturitySummaryByArea,\n  Rank,\n} from '@backstage-community/plugin-tech-insights-maturity-common';\n\n/**\n * Formats scoring data received from TechInsightsPlugin checks run\n */\nexport class ScoringDataFormatter {\n  getMaturityRank(results: MaturityCheckResult[]): MaturityRank {\n    return this.calculateRank(results);\n  }\n\n  getMaturitySummary(results: MaturityCheckResult[]): MaturitySummary {\n    const { rank, isMaxRank } = this.calculateRank(results);\n    const maxRank = this.calculateMaxRank(results);\n    const nextRank = isMaxRank ? maxRank : rank + 1;\n    const scoresByArea = this.groupCheckResultByCategory(results);\n    let totalChecks = 0;\n    let passedChecks = 0;\n    let rankTotalChecks = 0;\n    let rankPassedChecks = 0;\n\n    const areaSummaries: MaturitySummaryByArea[] = Object.entries(scoresByArea)\n      .map(([areaName, areaResults]) => {\n        const { rank: areaRank, isMaxRank: areaIsMaxRank } =\n          this.calculateRank(areaResults);\n        const areaMaxRank = this.calculateMaxRank(areaResults);\n        const areaNextRank = areaIsMaxRank ? areaMaxRank : areaRank + 1;\n        let areaTotalChecks = 0;\n        let areaPassedChecks = 0;\n\n        // Count checks for each rank because overall next rank may be different from area next rank\n        const areaRankTotalChecks: { [key: number]: number } = {\n          [Rank.Stone]: 0,\n          [Rank.Bronze]: 0,\n          [Rank.Silver]: 0,\n          [Rank.Gold]: 0,\n        };\n        const areaRankPassedChecks: { [key: number]: number } = {\n          [Rank.Stone]: 0,\n          [Rank.Bronze]: 0,\n          [Rank.Silver]: 0,\n          [Rank.Gold]: 0,\n        };\n\n        areaResults.forEach(checkResult => {\n          areaTotalChecks++;\n          if (checkResult.result) {\n            areaPassedChecks++;\n          }\n\n          // Count check progress in each rank\n          areaRankTotalChecks[checkResult.check.metadata.rank]++;\n          if (checkResult.result) {\n            areaRankPassedChecks[checkResult.check.metadata.rank]++;\n          }\n        });\n\n        // Aggregate overall check progress\n        totalChecks += areaTotalChecks;\n        passedChecks += areaPassedChecks;\n        // Aggregate check progress from checks in next overall rank\n        rankTotalChecks += areaRankTotalChecks[nextRank];\n        rankPassedChecks += areaRankPassedChecks[nextRank];\n\n        const areaProgPercent = this.calculatePercent(\n          areaPassedChecks,\n          areaTotalChecks,\n        );\n        const areaRankProgPercent = this.calculatePercent(\n          areaRankPassedChecks[areaNextRank],\n          areaRankTotalChecks[areaNextRank],\n        );\n\n        return {\n          area: areaName,\n          progress: {\n            passedChecks: areaPassedChecks,\n            totalChecks: areaTotalChecks,\n            percentage: areaProgPercent,\n          },\n          rankProgress: {\n            passedChecks: areaRankPassedChecks[areaNextRank],\n            totalChecks: areaRankTotalChecks[areaNextRank],\n            percentage: areaRankProgPercent,\n          },\n          rank: areaRank,\n          maxRank: areaMaxRank,\n          isMaxRank: areaIsMaxRank,\n        };\n      })\n      .sort((a, b) => (a.area > b.area ? -1 : 1)); // Sort according to area name\n\n    const progPercent = this.calculatePercent(passedChecks, totalChecks);\n    const rankProgPercent = this.calculatePercent(\n      rankPassedChecks,\n      rankTotalChecks,\n    );\n\n    return {\n      points: this.calculatePoints(results),\n      progress: {\n        passedChecks,\n        totalChecks,\n        percentage: progPercent,\n      },\n      rankProgress: {\n        passedChecks: rankPassedChecks,\n        totalChecks: rankTotalChecks,\n        percentage: rankProgPercent,\n      },\n      rank,\n      maxRank,\n      isMaxRank,\n      areaSummaries,\n    };\n  }\n\n  /**\n   * Some checks within one Area are divided as they should be applied for certain types of Components only\n   * When displaying Area scores in the UI they should be concatenated again for total Area score calculation\n   */\n  private groupCheckResultByCategory(results: MaturityCheckResult[]) {\n    const checksByCategory: {\n      [key: string]: MaturityCheckResult[];\n    } = {};\n\n    results.forEach(checkResult => {\n      checksByCategory[checkResult.check.metadata.category] ??= [];\n      checksByCategory[checkResult.check.metadata.category].push(checkResult);\n    });\n\n    return checksByCategory;\n  }\n\n  /** Calculated rank based on the total performance of all areas */\n  private calculateRank(results: MaturityCheckResult[]): MaturityRank {\n    const maxRank = this.calculateMaxRank(results);\n    let rank = maxRank; // Assume maximum rank\n\n    // Reduce rank if a failing check for a lower rank exists\n    results.forEach(checkResult => {\n      if (!checkResult.result && checkResult.check.metadata.rank <= rank) {\n        rank = checkResult.check.metadata.rank - 1;\n      }\n    });\n\n    const isMaxRank = rank === maxRank;\n\n    return { rank, isMaxRank };\n  }\n\n  private calculateMaxRank(results: MaturityCheckResult[]): Rank {\n    let rank: Rank = Rank.Stone;\n\n    // Get the highest rank achievable for this area\n    results.forEach(checkResult => {\n      if (checkResult.check.metadata.rank > rank) {\n        rank = checkResult.check.metadata.rank;\n      }\n    });\n\n    return rank;\n  }\n\n  private calculatePoints(results: MaturityCheckResult[]): number {\n    let points = 0;\n\n    // Incremental of 100 points for each succeeding rank\n    results\n      .filter(checkResult => checkResult.result)\n      .forEach(checkResult => {\n        points += checkResult.check.metadata.rank * 100;\n      });\n\n    return points;\n  }\n\n  calculatePercent(passedChecks: number, totalChecks: number): number {\n    // Prevent dividing by zero\n    return totalChecks === 0\n      ? 0\n      : Math.round((passedChecks / totalChecks) * 100);\n  }\n}\n"],"names":[],"mappings":"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"}

package/dist/components/MaturityChartCard/MaturityChartCard.esm.js

@@ -0,0 +1,79 @@
+import { useApi } from '@backstage/core-plugin-api';
+import { Rank } from '@backstage-community/plugin-tech-insights-maturity-common';
+import Card from '@mui/material/Card';
+import CardContent from '@mui/material/CardContent';
+import CircularProgress from '@mui/material/CircularProgress';
+import { styled } from '@mui/material/styles';
+import { useDrawingArea } from '@mui/x-charts/hooks';
+import { PieChart } from '@mui/x-charts/PieChart';
+import React from 'react';
+import useAsyncRetry from 'react-use/lib/useAsync';
+import { maturityApiRef } from '../../api/MaturityApi.esm.js';
+import '@backstage/catalog-model';
+import '@backstage/plugin-catalog-react';
+import '@backstage-community/plugin-tech-insights';
+import { getRankColor } from '../../helpers/utils.esm.js';
+
+const size = {
+  width: 380,
+  height: 300
+};
+const StyledText = styled("text")(({ theme }) => ({
+  fill: theme.palette.text.primary,
+  textAnchor: "middle",
+  dominantBaseline: "central",
+  fontSize: 20
+}));
+function PieCenterLabel({ children }) {
+  const { width, height, left, top } = useDrawingArea();
+  return /* @__PURE__ */ React.createElement(StyledText, { x: left + width / 2, y: top + height / 2 }, children);
+}
+const MaturityChartCard = ({ entities }) => {
+  const api = useApi(maturityApiRef);
+  const { loading, value } = useAsyncRetry(
+    async () => api.getBulkMaturityCheckResults(entities),
+    [api]
+  );
+  return /* @__PURE__ */ React.createElement(Card, null, /* @__PURE__ */ React.createElement(CardContent, null, loading && /* @__PURE__ */ React.createElement(CircularProgress, { size: 100 }), value && value.length > 0 && /* @__PURE__ */ React.createElement(
+    PieChart,
+    {
+      colors: [
+        getRankColor(Rank.Stone),
+        getRankColor(Rank.Bronze),
+        getRankColor(Rank.Silver),
+        getRankColor(Rank.Gold)
+      ],
+      series: [
+        {
+          arcLabel: (item) => item.value > 0 ? `${(item.value / value.length * 100).toFixed()}%` : "",
+          data: [
+            {
+              value: value.filter((x) => x.rank === Rank.Stone).length,
+              label: Rank[Rank.Stone]
+            },
+            {
+              value: value.filter((x) => x.rank === Rank.Bronze).length,
+              label: Rank[Rank.Bronze]
+            },
+            {
+              value: value.filter((x) => x.rank === Rank.Silver).length,
+              label: Rank[Rank.Silver]
+            },
+            {
+              value: value.filter((x) => x.rank === Rank.Gold).length,
+              label: Rank[Rank.Gold]
+            }
+          ],
+          highlightScope: { faded: "global", highlighted: "item" },
+          faded: { color: "gray" },
+          innerRadius: 90
+        }
+      ],
+      ...size
+    },
+    /* @__PURE__ */ React.createElement(PieCenterLabel, null, `${value.length} services`)
+  )));
+};
+
+export { MaturityChartCard };
+//# sourceMappingURL=MaturityChartCard.esm.js.map

package/dist/components/MaturityChartCard/MaturityChartCard.esm.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"MaturityChartCard.esm.js","sources":["../../../src/components/MaturityChartCard/MaturityChartCard.tsx"],"sourcesContent":["/*\n * Copyright 2025 The Backstage Authors\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 { Entity } from '@backstage/catalog-model';\nimport { useApi } from '@backstage/core-plugin-api';\nimport { Rank } from '@backstage-community/plugin-tech-insights-maturity-common';\nimport Card from '@mui/material/Card';\nimport CardContent from '@mui/material/CardContent';\nimport CircularProgress from '@mui/material/CircularProgress';\nimport { styled } from '@mui/material/styles';\nimport { useDrawingArea } from '@mui/x-charts/hooks';\nimport { PieChart } from '@mui/x-charts/PieChart';\nimport React from 'react';\nimport useAsyncRetry from 'react-use/lib/useAsync';\nimport { maturityApiRef } from '../../api';\nimport { getRankColor } from '../../helpers/utils';\n\ntype Props = {\n  entities: Entity[];\n};\n\nconst size = {\n  width: 380,\n  height: 300,\n};\n\nconst StyledText = styled('text')(({ theme }) => ({\n  fill: theme.palette.text.primary,\n  textAnchor: 'middle',\n  dominantBaseline: 'central',\n  fontSize: 20,\n}));\n\nfunction PieCenterLabel({ children }: { children: React.ReactNode }) {\n  const { width, height, left, top } = useDrawingArea();\n  return (\n    <StyledText x={left + width / 2} y={top + height / 2}>\n      {children}\n    </StyledText>\n  );\n}\n\nexport const MaturityChartCard = ({ entities }: Props) => {\n  const api = useApi(maturityApiRef);\n  const { loading, value } = useAsyncRetry(\n    async () => api.getBulkMaturityCheckResults(entities),\n    [api],\n  );\n\n  return (\n    <Card>\n      <CardContent>\n        {loading && <CircularProgress size={100} />}\n        {value && value.length > 0 && (\n          <PieChart\n            colors={[\n              getRankColor(Rank.Stone),\n              getRankColor(Rank.Bronze),\n              getRankColor(Rank.Silver),\n              getRankColor(Rank.Gold),\n            ]}\n            series={[\n              {\n                arcLabel: item =>\n                  item.value > 0\n                    ? `${((item.value / value.length) * 100).toFixed()}%`\n                    : '',\n                data: [\n                  {\n                    value: value.filter(x => x.rank === Rank.Stone).length,\n                    label: Rank[Rank.Stone],\n                  },\n                  {\n                    value: value.filter(x => x.rank === Rank.Bronze).length,\n                    label: Rank[Rank.Bronze],\n                  },\n                  {\n                    value: value.filter(x => x.rank === Rank.Silver).length,\n                    label: Rank[Rank.Silver],\n                  },\n                  {\n                    value: value.filter(x => x.rank === Rank.Gold).length,\n                    label: Rank[Rank.Gold],\n                  },\n                ],\n                highlightScope: { faded: 'global', highlighted: 'item' },\n                faded: { color: 'gray' },\n                innerRadius: 90,\n              },\n            ]}\n            {...size}\n          >\n            <PieCenterLabel>{`${value.length} services`}</PieCenterLabel>\n          </PieChart>\n        )}\n      </CardContent>\n    </Card>\n  );\n};\n"],"names":[],"mappings":"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"}