@nospt/plugin-tech-radar-ng-backend 0.9.0

package/README.md

@@ -0,0 +1,204 @@
+# @nospt/plugin-tech-radar-ng-backend
+
+Backend plugin for the **Tech Radar NG** — a Backstage plugin suite that discovers AI/ML technologies, tracks their metrics over time, and exposes a REST API for the frontend to consume.
+
+This package provides the **discovery engine**, **metrics ingestion**, **temporal snapshots**, and **REST API** that power the Tech Radar NG.
+
+Built with Backstage's [New Backend System](https://backstage.io/docs/backend-system/building-plugins-and-modules/index) using `createBackendPlugin` and Backstage core services (httpRouter, database, scheduler, logger).
+
+---
+
+## Features
+
+- **Automated discovery** — searches GitHub for AI/ML repositories on a configurable cron schedule
+- **50/50 discovery strategy** — balances top absolute scorers with fastest-growing emerging repositories
+- **Temporal snapshots** — each discovery run appends timestamped metrics (stars, forks), preserving full history
+- **Metric evolution** — computes percentage change between consecutive snapshots for trend analysis
+- **Human-curated placement** — no ring or segment is ever assigned automatically; the API supports explicit classification by users
+- **Knex + PostgreSQL** — database migrations managed via Knex; compatible with PostgreSQL (production) and SQLite (development)
+- **Extensible architecture** — service-based design with dependency injection for GitHub, HuggingFace (planned), and future data sources
+
+---
+
+## Installation
+
+From your Backstage root directory:
+
+```bash
+yarn --cwd packages/backend add @nospt/plugin-tech-radar-ng-backend
+```
+
+Register the plugin in `packages/backend/src/index.ts`:
+
+```ts
+const backend = createBackend();
+// ...
+backend.add(import('@nospt/plugin-tech-radar-ng-backend'));
+backend.start();
+```
+
+---
+
+## Configuration
+
+Add the following to your `app-config.yaml`:
+
+```yaml
+techRadarNg:
+  discovery:
+    cron: '0 8 * * 1' # Every Monday at 08:00 (default)
+  github:
+    searchQueries:
+      - 'AI OR ML OR "machine learning" OR "artificial intelligence"'
+      - 'LLM OR "language model" OR GPT OR transformer'
+      - '"generative AI" OR "gen AI" OR chatbot OR assistant'
+
+backend:
+  database:
+    client: pg
+    connection:
+      host: ${POSTGRES_HOST}
+      port: ${POSTGRES_PORT}
+      user: ${POSTGRES_USER}
+      password: ${POSTGRES_PASSWORD}
+      database: ${POSTGRES_DB}
+```
+
+| Key                                | Type       | Default       | Description                                    |
+| ---------------------------------- | ---------- | ------------- | ---------------------------------------------- |
+| `techRadarNg.discovery.cron`       | `string`   | `'0 8 * * 1'` | Cron expression for the discovery schedule     |
+| `techRadarNg.github.searchQueries` | `string[]` | `[]`          | GitHub search queries for repository discovery |
+
+---
+
+## REST API
+
+All endpoints are served under `/api/tech-radar-ng`.
+
+| Method | Path                   | Description                                            |
+| ------ | ---------------------- | ------------------------------------------------------ |
+| `GET`  | `/segments`            | List all radar segments                                |
+| `GET`  | `/rings`               | List all radar rings                                   |
+| `GET`  | `/candidates`          | List candidates (paginated, filterable)                |
+| `PUT`  | `/candidates/classify` | Batch-update candidate ring, segment, and radar status |
+
+### `GET /candidates` Query Parameters
+
+| Parameter      | Type      | Default            | Description                                                               |
+| -------------- | --------- | ------------------ | ------------------------------------------------------------------------- |
+| `page`         | `integer` | `1`                | Page number                                                               |
+| `pageSize`     | `integer` | `10`               | Items per page (max 50)                                                   |
+| `unclassified` | `boolean` | `false`            | Filter to candidates without ring/segment                                 |
+| `in_radar`     | `boolean` | `false`            | Filter to candidates on the radar                                         |
+| `orderBy`      | `enum`    | `popularity_score` | Sort field: `name`, `popularity_score`, `usage_score`, `last_activity_at` |
+| `orderDir`     | `enum`    | `desc`             | Sort direction: `asc`, `desc`                                             |
+| `platforms[]`  | `enum[]`  | `[]`               | Filter by platform: `github`                                              |
+
+### `PUT /candidates/classify` Body
+
+A JSON record mapping candidate IDs to patch objects:
+
+```json
+{
+  "candidate-uuid-1": {
+    "segment": "llm-techniques",
+    "ring": "adopt",
+    "in_radar": true
+  },
+  "candidate-uuid-2": { "ring": "hold" }
+}
+```
+
+---
+
+## Database
+
+The plugin uses Knex migrations located in the [`migrations/`](./migrations) directory:
+
+| Migration                                    | Description                                                         |
+| -------------------------------------------- | ------------------------------------------------------------------- |
+| `001_create_quadrants_table`                 | Creates the `segments` table                                        |
+| `002_add_quadrants`                          | Seeds default segment data                                          |
+| `003_create_rings_table`                     | Creates the `rings` table                                           |
+| `004_add_rings`                              | Seeds default ring data (Adopt, Trial, Assess, Hold)                |
+| `005_create_radar_candidates_table`          | Creates the `radar_candidates` table                                |
+| `006_create_radar_candidates_snapshot_table` | Creates the `radar_candidates_snapshots` table for temporal metrics |
+
+Migrations run automatically on plugin startup.
+
+---
+
+## Plugin Structure
+
+```
+src/
+├── index.ts                # Default export (plugin instance)
+├── plugin.ts               # Plugin definition with DI and scheduler
+├── router.ts               # Express router with REST endpoints
+├── database/
+│   └── TechRadarDb.ts      # Database access layer (Knex)
+├── service/
+│   ├── RadarMetricsService.ts       # Core service — orchestrates discovery + metrics
+│   ├── GitHubMetricsService.ts      # GitHub API integration
+│   └── HuggingFaceMetricsService.ts # HuggingFace integration (planned)
+└── types/
+    ├── index.ts
+    ├── techRadar.ts         # CandidateRow, CandidateSnapshot
+    ├── github.ts            # GitHub API response types
+    └── huggingFace.ts       # HuggingFace API response types
+migrations/
+├── 001_create_quadrants_table.js
+├── 002_add_quadrants.js
+├── 003_create_rings_table.js
+├── 004_add_rings.js
+├── 005_create_radar_candidates_table.js
+└── 006_create_radar_candidates_snapshot_table.js
+```
+
+### Services (Dependency Injection)
+
+| Service Ref                    | Interface                   | Description                                                                   |
+| ------------------------------ | --------------------------- | ----------------------------------------------------------------------------- |
+| `radarMetricsServiceRef`       | `RadarMetricsService`       | Core service — discovery orchestration, metrics retrieval, candidate patching |
+| `gitHubMetricsServiceRef`      | `GitHubMetricsService`      | Fetches and maps GitHub repositories to candidates                            |
+| `huggingFaceMetricsServiceRef` | `HuggingFaceMetricsService` | Fetches HuggingFace models (planned)                                          |
+| `techRadarDbRef`               | `TechRadarDb`               | Database access layer                                                         |
+
+---
+
+## Development
+
+Start the backend in standalone mode:
+
+```bash
+cd plugins/tech-radar-ng-backend
+yarn start
+```
+
+This uses the dev setup in [`dev/index.ts`](./dev/index.ts) with mocked auth. The API is available at `http://localhost:7007/api/tech-radar-ng/`.
+
+To run the full stack (frontend + backend):
+
+```bash
+# From the repository root
+yarn start
+```
+
+---
+
+## Testing
+
+```bash
+yarn backstage-cli package test            # Run tests
+yarn backstage-cli package test --coverage # Run with coverage
+yarn backstage-cli package lint            # Lint
+```
+
+---
+
+## Related Packages
+
+| Package                                                                      | Description                          |
+| ---------------------------------------------------------------------------- | ------------------------------------ |
+| [`@nospt/plugin-tech-radar-ng`](../tech-radar-ng)               | Frontend plugin — Back Office UI     |
+| [`@nospt/plugin-tech-radar-ng-common`](../tech-radar-ng-common) | Shared types, Zod schemas, and enums |

package/dist/database/TechRadarDb.cjs.js

@@ -0,0 +1,244 @@
+'use strict';
+
+var backendPluginApi = require('@backstage/backend-plugin-api');
+var errors = require('@backstage/errors');
+var pluginTechRadarNgCommon = require('@nospt/plugin-tech-radar-ng-common');
+var uuid = require('uuid');
+
+class DefaultTechRadarDb {
+  #logger;
+  #database;
+  constructor(options) {
+    this.#logger = options.logger;
+    this.#database = options.database;
+  }
+  static create(options) {
+    return new DefaultTechRadarDb(options);
+  }
+  async findQuadrants() {
+    this.#logger.debug("Fetching segments from the database");
+    try {
+      const knex = await this.#database.getClient();
+      const segments = await knex("segments").select(
+        "id",
+        "name",
+        "search_params"
+      );
+      this.#logger.debug("Successfully fetched segments from the database");
+      return segments.map((q) => ({
+        ...q,
+        search_params: typeof q.search_params === "string" ? JSON.parse(q.search_params) : q.search_params
+      }));
+    } catch (error) {
+      this.#logger.error(`Error fetching segments: ${errors.stringifyError(error)}`);
+      return [];
+    }
+  }
+  async findRings() {
+    this.#logger.debug("Fetching rings from the database");
+    try {
+      const knex = await this.#database.getClient();
+      const rings = await knex("rings").select("id", "name", "color");
+      this.#logger.debug("Successfully fetched rings from the database");
+      return rings;
+    } catch (error) {
+      this.#logger.error(`Error fetching rings: ${errors.stringifyError(error)}`);
+      return [];
+    }
+  }
+  async insertCandidates(candidates) {
+    this.#logger.debug(
+      `Bulk upserting ${candidates.length} AI radar candidates into the database`
+    );
+    try {
+      const knex = await this.#database.getClient();
+      const now = /* @__PURE__ */ new Date();
+      const rows = candidates.map((candidate) => ({
+        id: uuid.v4(),
+        platform_id: candidate.platform_id,
+        full_name: candidate.full_name,
+        name: candidate.name,
+        description: candidate.description,
+        url: candidate.url,
+        homepage: candidate.homepage,
+        primary_language: candidate.primary_language,
+        license: candidate.license,
+        ring: candidate.ring,
+        segment: candidate.segment,
+        is_active: candidate.is_active,
+        platform: candidate.platform,
+        last_activity_at: candidate.last_activity_at,
+        created_at: now,
+        last_synced_at: now
+      }));
+      const upsertedIds = await knex("radar_candidates").insert(rows).onConflict("platform_id").merge({
+        full_name: knex.raw("EXCLUDED.full_name"),
+        name: knex.raw("EXCLUDED.name"),
+        url: knex.raw("EXCLUDED.url"),
+        description: knex.raw("EXCLUDED.description"),
+        homepage: knex.raw("EXCLUDED.homepage"),
+        primary_language: knex.raw("EXCLUDED.primary_language"),
+        license: knex.raw("EXCLUDED.license"),
+        is_active: knex.raw("EXCLUDED.is_active"),
+        platform: knex.raw("EXCLUDED.platform"),
+        last_synced_at: now
+      }).returning(["id", "platform_id"]);
+      this.#logger.debug(
+        `Successfully bulk upserted ${upsertedIds.length} AI radar candidates`
+      );
+      return upsertedIds;
+    } catch (error) {
+      this.#logger.error(
+        `Error bulk upserting AI radar candidates: ${errors.stringifyError(error)}`
+      );
+      return null;
+    }
+  }
+  async insertCandidateSnapshots(candidates) {
+    this.#logger.debug(
+      `Inserting ${candidates.length} AI radar candidate snapshots into the database`
+    );
+    try {
+      const knex = await this.#database.getClient();
+      const rows = candidates.map((candidate) => ({
+        id: uuid.v4(),
+        candidate_id: candidate.id,
+        popularity_score: candidate.popularity_score,
+        usage_score: candidate.usage_score,
+        snapshot_at: /* @__PURE__ */ new Date()
+      }));
+      const insertedIds = await knex("radar_candidates_snapshots").insert(rows).returning("id");
+      this.#logger.debug(
+        `Successfully inserted AI radar candidate snapshots with IDs: ${insertedIds.join(
+          ", "
+        )}`
+      );
+      return insertedIds;
+    } catch (error) {
+      this.#logger.error(
+        `Error inserting AI radar candidate snapshots: ${errors.stringifyError(
+          error
+        )}`
+      );
+      return null;
+    }
+  }
+  async fetchCandidates(opts) {
+    const {
+      page,
+      pageSize,
+      unclassified,
+      in_radar,
+      orderBy,
+      orderDir,
+      platforms
+    } = opts;
+    const offset = (page - 1) * pageSize;
+    this.#logger.debug(
+      `Fetching candidates page=${page} pageSize=${pageSize} unclassified=${unclassified} in_radar=${in_radar} orderBy=${orderBy} orderDir=${orderDir}`
+    );
+    try {
+      const db = await this.#database.getClient();
+      const applyFilters = (qb) => {
+        if (platforms && platforms.length > 0) {
+          qb.whereIn("c.platform", platforms);
+        }
+        if (unclassified) {
+          qb.where(
+            (b) => b.whereNull("c.segment").orWhereNull("c.ring")
+          );
+        }
+      };
+      const [countResult] = await db("radar_candidates as c").where("c.is_active", true).andWhere("c.in_radar", in_radar).modify(applyFilters).count("c.id as count");
+      const total = Number(countResult.count);
+      const orderByColumnMap = /* @__PURE__ */ new Map([
+        [pluginTechRadarNgCommon.CandidateOrderBy.NAME, "c.name"],
+        [pluginTechRadarNgCommon.CandidateOrderBy.PopularityScore, "popularity_score"],
+        [pluginTechRadarNgCommon.CandidateOrderBy.UsageScore, "usage_score"],
+        [pluginTechRadarNgCommon.CandidateOrderBy.LastActivityAt, "c.last_activity_at"]
+      ]);
+      const items = await db("radar_candidates as c").where("c.is_active", true).modify(applyFilters).select([
+        "c.id",
+        "c.name",
+        "c.description",
+        "c.url",
+        "c.homepage",
+        "c.primary_language",
+        "c.license",
+        "c.ring",
+        "c.segment",
+        "c.in_radar",
+        "c.is_active",
+        "c.platform"
+      ]).select(
+        db.raw(
+          "(SELECT popularity_score FROM radar_candidates_snapshots WHERE candidate_id = c.id ORDER BY snapshot_at DESC LIMIT 1) as popularity_score"
+        ),
+        db.raw(
+          "(SELECT usage_score FROM radar_candidates_snapshots WHERE candidate_id = c.id ORDER BY snapshot_at DESC LIMIT 1) as usage_score"
+        ),
+        db.raw(
+          "(SELECT popularity_score FROM radar_candidates_snapshots WHERE candidate_id = c.id ORDER BY snapshot_at DESC LIMIT 1 OFFSET 1) as prev_popularity_score"
+        ),
+        db.raw(
+          "(SELECT usage_score FROM radar_candidates_snapshots WHERE candidate_id = c.id ORDER BY snapshot_at DESC LIMIT 1 OFFSET 1) as prev_usage_score"
+        )
+      ).orderBy(orderByColumnMap.get(orderBy), orderDir).limit(pageSize).offset(offset);
+      this.#logger.debug(
+        `Successfully fetched ${items.length} candidates (total: ${total})`
+      );
+      return {
+        items,
+        total,
+        page,
+        pageSize,
+        totalPages: Math.ceil(total / pageSize)
+      };
+    } catch (error) {
+      this.#logger.error(`Error fetching candidates: ${errors.stringifyError(error)}`);
+      return { items: [], total: 0, page, pageSize, totalPages: 0 };
+    }
+  }
+  async patchCandidates(candidatesPatch) {
+    try {
+      const db = await this.#database.getClient();
+      this.#logger.debug(
+        `Patching candidates with updates for ${Object.keys(candidatesPatch).length} candidates`
+      );
+      await db.transaction(async (trx) => {
+        for (const [candidateId, patch] of Object.entries(candidatesPatch)) {
+          const updateBody = {};
+          if (patch.segment !== void 0) updateBody.segment = patch.segment;
+          if (patch.ring !== void 0) updateBody.ring = patch.ring;
+          if (patch.in_radar !== void 0)
+            updateBody.in_radar = patch.in_radar;
+          await trx("radar_candidates").update(updateBody).where({ id: candidateId });
+        }
+      });
+    } catch (dbError) {
+      this.#logger.error(
+        `Error patching candidates: ${errors.stringifyError(dbError)}`
+      );
+      throw new errors.ConflictError(
+        "Failed to patch candidates due to a conflict. Please try again."
+      );
+    }
+  }
+}
+const techRadarDbRef = backendPluginApi.createServiceRef({
+  id: "tech.radar.db",
+  defaultFactory: async (service) => backendPluginApi.createServiceFactory({
+    service,
+    deps: {
+      logger: backendPluginApi.coreServices.logger,
+      database: backendPluginApi.coreServices.database
+    },
+    async factory(deps) {
+      return DefaultTechRadarDb.create(deps);
+    }
+  })
+});
+
+exports.DefaultTechRadarDb = DefaultTechRadarDb;
+exports.techRadarDbRef = techRadarDbRef;
+//# sourceMappingURL=TechRadarDb.cjs.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"TechRadarDb.cjs.js","sources":["../../src/database/TechRadarDb.ts"],"sourcesContent":["import {\n  coreServices,\n  createServiceFactory,\n  createServiceRef,\n  DatabaseService,\n  LoggerService,\n} from '@backstage/backend-plugin-api';\nimport { ConflictError, stringifyError } from '@backstage/errors';\nimport {\n  Segment,\n  Ring,\n  PaginatedResult,\n  CandidatesPatch,\n  CandidateQueryValues,\n  CandidateOrderBy,\n} from '@nospt/plugin-tech-radar-ng-common';\nimport { CandidateRow } from '../types';\nimport { Knex } from 'knex';\nimport { v4 as uuidv4 } from 'uuid';\n\nexport interface TechRadarDb {\n  findQuadrants(): Promise<Segment[]>;\n  findRings(): Promise<Ring[]>;\n  insertCandidates(\n    candidates: CandidateRow[],\n  ): Promise<{ id: string; platform_id: string }[] | null>;\n  insertCandidateSnapshots(\n    candidates: CandidateRow[],\n  ): Promise<string[] | null>;\n  fetchCandidates(\n    opts: CandidateQueryValues,\n  ): Promise<PaginatedResult<CandidateRow>>;\n  patchCandidates(candidatesPatch: CandidatesPatch): Promise<void>;\n}\n\ninterface TechRadarDbOptions {\n  logger: LoggerService;\n  database: DatabaseService;\n}\nexport class DefaultTechRadarDb implements TechRadarDb {\n  readonly #logger: LoggerService;\n  readonly #database: DatabaseService;\n\n  private constructor(options: TechRadarDbOptions) {\n    this.#logger = options.logger;\n    this.#database = options.database;\n  }\n\n  static create(options: TechRadarDbOptions) {\n    return new DefaultTechRadarDb(options);\n  }\n\n  async findQuadrants(): Promise<Segment[]> {\n    this.#logger.debug('Fetching segments from the database');\n    try {\n      const knex = await this.#database.getClient();\n      const segments = await knex('segments').select<Segment[]>(\n        'id',\n        'name',\n        'search_params',\n      );\n\n      this.#logger.debug('Successfully fetched segments from the database');\n      return segments.map(q => ({\n        ...q,\n        search_params:\n          typeof q.search_params === 'string'\n            ? JSON.parse(q.search_params)\n            : q.search_params,\n      }));\n    } catch (error) {\n      this.#logger.error(`Error fetching segments: ${stringifyError(error)}`);\n      return [];\n    }\n  }\n\n  async findRings(): Promise<Ring[]> {\n    this.#logger.debug('Fetching rings from the database');\n    try {\n      const knex = await this.#database.getClient();\n      const rings = await knex('rings').select<Ring[]>('id', 'name', 'color');\n\n      this.#logger.debug('Successfully fetched rings from the database');\n      return rings;\n    } catch (error) {\n      this.#logger.error(`Error fetching rings: ${stringifyError(error)}`);\n      return [];\n    }\n  }\n\n  async insertCandidates(\n    candidates: CandidateRow[],\n  ): Promise<{ id: string; platform_id: string }[] | null> {\n    this.#logger.debug(\n      `Bulk upserting ${candidates.length} AI radar candidates into the database`,\n    );\n    try {\n      const knex = await this.#database.getClient();\n      const now = new Date();\n      const rows = candidates.map(candidate => ({\n        id: uuidv4(),\n        platform_id: candidate.platform_id,\n        full_name: candidate.full_name,\n        name: candidate.name,\n        description: candidate.description,\n        url: candidate.url,\n        homepage: candidate.homepage,\n        primary_language: candidate.primary_language,\n        license: candidate.license,\n        ring: candidate.ring,\n        segment: candidate.segment,\n        is_active: candidate.is_active,\n        platform: candidate.platform,\n        last_activity_at: candidate.last_activity_at,\n        created_at: now,\n        last_synced_at: now,\n      }));\n\n      const upsertedIds = await knex('radar_candidates')\n        .insert(rows)\n        .onConflict('platform_id')\n        .merge({\n          full_name: knex.raw('EXCLUDED.full_name'),\n          name: knex.raw('EXCLUDED.name'),\n          url: knex.raw('EXCLUDED.url'),\n          description: knex.raw('EXCLUDED.description'),\n          homepage: knex.raw('EXCLUDED.homepage'),\n          primary_language: knex.raw('EXCLUDED.primary_language'),\n          license: knex.raw('EXCLUDED.license'),\n          is_active: knex.raw('EXCLUDED.is_active'),\n          platform: knex.raw('EXCLUDED.platform'),\n          last_synced_at: now,\n        })\n        .returning(['id', 'platform_id']);\n\n      this.#logger.debug(\n        `Successfully bulk upserted ${upsertedIds.length} AI radar candidates`,\n      );\n      return upsertedIds;\n    } catch (error) {\n      this.#logger.error(\n        `Error bulk upserting AI radar candidates: ${stringifyError(error)}`,\n      );\n      return null;\n    }\n  }\n\n  async insertCandidateSnapshots(\n    candidates: CandidateRow[],\n  ): Promise<string[] | null> {\n    this.#logger.debug(\n      `Inserting ${candidates.length} AI radar candidate snapshots into the database`,\n    );\n    try {\n      const knex = await this.#database.getClient();\n\n      const rows = candidates.map(candidate => ({\n        id: uuidv4(),\n        candidate_id: candidate.id,\n        popularity_score: candidate.popularity_score,\n        usage_score: candidate.usage_score,\n        snapshot_at: new Date(),\n      }));\n\n      const insertedIds = await knex('radar_candidates_snapshots')\n        .insert(rows)\n        .returning('id');\n\n      this.#logger.debug(\n        `Successfully inserted AI radar candidate snapshots with IDs: ${insertedIds.join(\n          ', ',\n        )}`,\n      );\n      return insertedIds;\n    } catch (error) {\n      this.#logger.error(\n        `Error inserting AI radar candidate snapshots: ${stringifyError(\n          error,\n        )}`,\n      );\n      return null;\n    }\n  }\n\n  async fetchCandidates(\n    opts: CandidateQueryValues,\n  ): Promise<PaginatedResult<CandidateRow>> {\n    const {\n      page,\n      pageSize,\n      unclassified,\n      in_radar,\n      orderBy,\n      orderDir,\n      platforms,\n    } = opts;\n    const offset = (page - 1) * pageSize;\n    this.#logger.debug(\n      `Fetching candidates page=${page} pageSize=${pageSize} unclassified=${unclassified} in_radar=${in_radar} orderBy=${orderBy} orderDir=${orderDir}`,\n    );\n    try {\n      const db = await this.#database.getClient();\n\n      const applyFilters = (qb: Knex.QueryBuilder<CandidateRow, any>) => {\n        if (platforms && platforms.length > 0) {\n          qb.whereIn('c.platform', platforms);\n        }\n\n        if (unclassified) {\n          qb.where((b: Knex.QueryBuilder<CandidateRow, any>) =>\n            b.whereNull('c.segment').orWhereNull('c.ring'),\n          );\n        }\n      };\n\n      const [countResult] = await db('radar_candidates as c')\n        .where('c.is_active', true)\n        .andWhere('c.in_radar', in_radar)\n        .modify(applyFilters)\n        .count<[{ count: number }]>('c.id as count');\n\n      const total = Number(countResult.count);\n\n      const orderByColumnMap: Map<CandidateOrderBy, string> = new Map([\n        [CandidateOrderBy.NAME, 'c.name'],\n        [CandidateOrderBy.PopularityScore, 'popularity_score'],\n        [CandidateOrderBy.UsageScore, 'usage_score'],\n        [CandidateOrderBy.LastActivityAt, 'c.last_activity_at'],\n      ]);\n\n      const items = await db('radar_candidates as c')\n        .where('c.is_active', true)\n        .modify(applyFilters)\n        .select<CandidateRow[]>([\n          'c.id',\n          'c.name',\n          'c.description',\n          'c.url',\n          'c.homepage',\n          'c.primary_language',\n          'c.license',\n          'c.ring',\n          'c.segment',\n          'c.in_radar',\n          'c.is_active',\n          'c.platform',\n        ])\n        .select(\n          db.raw(\n            '(SELECT popularity_score FROM radar_candidates_snapshots WHERE candidate_id = c.id ORDER BY snapshot_at DESC LIMIT 1) as popularity_score',\n          ),\n          db.raw(\n            '(SELECT usage_score FROM radar_candidates_snapshots WHERE candidate_id = c.id ORDER BY snapshot_at DESC LIMIT 1) as usage_score',\n          ),\n          db.raw(\n            '(SELECT popularity_score FROM radar_candidates_snapshots WHERE candidate_id = c.id ORDER BY snapshot_at DESC LIMIT 1 OFFSET 1) as prev_popularity_score',\n          ),\n          db.raw(\n            '(SELECT usage_score FROM radar_candidates_snapshots WHERE candidate_id = c.id ORDER BY snapshot_at DESC LIMIT 1 OFFSET 1) as prev_usage_score',\n          ),\n        )\n        .orderBy(orderByColumnMap.get(orderBy) as string, orderDir)\n        .limit(pageSize)\n        .offset(offset);\n\n      this.#logger.debug(\n        `Successfully fetched ${items.length} candidates (total: ${total})`,\n      );\n      return {\n        items,\n        total,\n        page,\n        pageSize,\n        totalPages: Math.ceil(total / pageSize),\n      };\n    } catch (error) {\n      this.#logger.error(`Error fetching candidates: ${stringifyError(error)}`);\n      return { items: [], total: 0, page, pageSize, totalPages: 0 };\n    }\n  }\n\n  async patchCandidates(candidatesPatch: CandidatesPatch): Promise<void> {\n    try {\n      const db = await this.#database.getClient();\n\n      this.#logger.debug(\n        `Patching candidates with updates for ${\n          Object.keys(candidatesPatch).length\n        } candidates`,\n      );\n\n      await db.transaction(async trx => {\n        for (const [candidateId, patch] of Object.entries(candidatesPatch)) {\n          const updateBody: Partial<{\n            segment: string;\n            ring: string;\n            in_radar: boolean;\n          }> = {};\n\n          if (patch.segment !== undefined) updateBody.segment = patch.segment;\n          if (patch.ring !== undefined) updateBody.ring = patch.ring;\n          if (patch.in_radar !== undefined)\n            updateBody.in_radar = patch.in_radar;\n\n          await trx('radar_candidates')\n            .update(updateBody)\n            .where({ id: candidateId });\n        }\n      });\n    } catch (dbError) {\n      this.#logger.error(\n        `Error patching candidates: ${stringifyError(dbError)}`,\n      );\n\n      throw new ConflictError(\n        'Failed to patch candidates due to a conflict. Please try again.',\n      );\n    }\n  }\n}\n\nexport const techRadarDbRef = createServiceRef<TechRadarDb>({\n  id: 'tech.radar.db',\n  defaultFactory: async service =>\n    createServiceFactory({\n      service,\n      deps: {\n        logger: coreServices.logger,\n        database: coreServices.database,\n      },\n      async factory(deps) {\n        return DefaultTechRadarDb.create(deps);\n      },\n    }),\n});\n"],"names":["stringifyError","uuidv4","CandidateOrderBy","ConflictError","createServiceRef","createServiceFactory","coreServices"],"mappings":"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"}

package/dist/index.cjs.js

@@ -0,0 +1,10 @@
+'use strict';
+
+Object.defineProperty(exports, '__esModule', { value: true });
+
+var plugin = require('./plugin.cjs.js');
+
+
+
+exports.default = plugin.techRadarNgPlugin;
+//# sourceMappingURL=index.cjs.js.map

package/dist/index.cjs.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.cjs.js","sources":[],"sourcesContent":[],"names":[],"mappings":";;;;;;;;"}

package/dist/index.d.ts

@@ -0,0 +1,10 @@
+import * as _backstage_backend_plugin_api from '@backstage/backend-plugin-api';
+
+/**
+ * techRadarNgPlugin backend plugin
+ *
+ * @public
+ */
+declare const techRadarNgPlugin: _backstage_backend_plugin_api.BackendFeature;
+
+export { techRadarNgPlugin as default };

package/dist/plugin.cjs.js

@@ -0,0 +1,67 @@
+'use strict';
+
+var backendPluginApi = require('@backstage/backend-plugin-api');
+var router = require('./router.cjs.js');
+var RadarMetricsService = require('./service/RadarMetricsService.cjs.js');
+var rootHttpRouter = require('@backstage/backend-defaults/rootHttpRouter');
+
+const techRadarNgPlugin = backendPluginApi.createBackendPlugin({
+  pluginId: "tech-radar-ng",
+  register(env) {
+    env.registerInit({
+      deps: {
+        httpRouter: backendPluginApi.coreServices.httpRouter,
+        database: backendPluginApi.coreServices.database,
+        logger: backendPluginApi.coreServices.logger,
+        config: backendPluginApi.coreServices.rootConfig,
+        scheduler: backendPluginApi.coreServices.scheduler,
+        radarMetricsService: RadarMetricsService.radarMetricsServiceRef
+      },
+      async init({
+        httpRouter,
+        database,
+        logger,
+        config,
+        scheduler,
+        radarMetricsService
+      }) {
+        const knex = await database.getClient();
+        const migrationsDir = backendPluginApi.resolvePackagePath(
+          "@nospt/plugin-tech-radar-ng-backend",
+          "migrations"
+        );
+        logger.info(`Running migrations from: ${migrationsDir}`);
+        const [batchNo, log] = await knex.migrate.latest({
+          directory: migrationsDir
+        });
+        logger.info(
+          `Migrations complete \u2014 batch ${batchNo}, ran: ${log.join(", ") || "none (already up to date)"} on DB: ${knex.client.config.connection?.database ?? "unknown"}`
+        );
+        const router$1 = await router.createRouter({
+          logger,
+          radarMetricsService
+        });
+        const middleware = rootHttpRouter.MiddlewareFactory.create({ config, logger });
+        router$1.use(middleware.notFound());
+        router$1.use(middleware.error);
+        httpRouter.use(router$1);
+        const frequency = config.getOptional("techRadarNg.discovery.frequency") ?? { days: 1 };
+        const initialDelay = config.getOptional("techRadarNg.discovery.initialDelay") ?? { minutes: 1 };
+        const timeout = config.getOptional("techRadarNg.discovery.timeout") ?? { minutes: 15 };
+        await scheduler.scheduleTask({
+          id: "tech-radar-ng-weekly-sync",
+          frequency,
+          timeout,
+          initialDelay,
+          fn: async () => {
+            logger.info("Running Tech Radar Ng sync");
+            await radarMetricsService.discover();
+          }
+        });
+      }
+    });
+  }
+});
+
+exports.techRadarNgPlugin = techRadarNgPlugin;
+//# sourceMappingURL=plugin.cjs.js.map

package/dist/plugin.cjs.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"plugin.cjs.js","sources":["../src/plugin.ts"],"sourcesContent":["import {\n  coreServices,\n  createBackendPlugin,\n  resolvePackagePath,\n} from '@backstage/backend-plugin-api';\nimport { createRouter } from './router';\nimport { radarMetricsServiceRef } from './service/RadarMetricsService';\nimport { MiddlewareFactory } from '@backstage/backend-defaults/rootHttpRouter';\nimport { HumanDuration } from '@backstage/types';\n\n/**\n * techRadarNgPlugin backend plugin\n *\n * @public\n */\nexport const techRadarNgPlugin = createBackendPlugin({\n  pluginId: 'tech-radar-ng',\n  register(env) {\n    env.registerInit({\n      deps: {\n        httpRouter: coreServices.httpRouter,\n        database: coreServices.database,\n        logger: coreServices.logger,\n        config: coreServices.rootConfig,\n        scheduler: coreServices.scheduler,\n        radarMetricsService: radarMetricsServiceRef,\n      },\n      async init({\n        httpRouter,\n        database,\n        logger,\n        config,\n        scheduler,\n        radarMetricsService,\n      }) {\n        const knex = await database.getClient();\n        const migrationsDir = resolvePackagePath(\n          '@nospt/plugin-tech-radar-ng-backend',\n          'migrations',\n        );\n        logger.info(`Running migrations from: ${migrationsDir}`);\n        const [batchNo, log] = await knex.migrate.latest({\n          directory: migrationsDir,\n        });\n        logger.info(\n          `Migrations complete — batch ${batchNo}, ran: ${\n            log.join(', ') || 'none (already up to date)'\n          } on DB: ${knex.client.config.connection?.database ?? 'unknown'}`,\n        );\n\n        const router = await createRouter({\n          logger,\n          radarMetricsService,\n        });\n\n        const middleware = MiddlewareFactory.create({ config, logger });\n        router.use(middleware.notFound());\n          router.use(middleware.error);\n\n        httpRouter.use(router);\n\n        const frequency: HumanDuration =\n          config.getOptional('techRadarNg.discovery.frequency') ?? { days: 1 }; // default to once a day\n\n          const initialDelay: HumanDuration = config.getOptional('techRadarNg.discovery.initialDelay') ?? { minutes: 1 };\n          const timeout: HumanDuration = config.getOptional('techRadarNg.discovery.timeout') ?? { minutes: 15 };\n\n        // Run immediately on startup, then once a week (every Monday at 08:00)\n        await scheduler.scheduleTask({\n          id: 'tech-radar-ng-weekly-sync',\n          frequency,\n          timeout,\n          initialDelay,\n          fn: async () => {\n            logger.info('Running Tech Radar Ng sync');\n            await radarMetricsService.discover(); // call your service\n          },\n        });\n      },\n    });\n  },\n});\n"],"names":["createBackendPlugin","coreServices","radarMetricsServiceRef","resolvePackagePath","router","createRouter","MiddlewareFactory"],"mappings":";;;;;;;AAeO,MAAM,oBAAoBA,oCAAA,CAAoB;AAAA,EACnD,QAAA,EAAU,eAAA;AAAA,EACV,SAAS,GAAA,EAAK;AACZ,IAAA,GAAA,CAAI,YAAA,CAAa;AAAA,MACf,IAAA,EAAM;AAAA,QACJ,YAAYC,6BAAA,CAAa,UAAA;AAAA,QACzB,UAAUA,6BAAA,CAAa,QAAA;AAAA,QACvB,QAAQA,6BAAA,CAAa,MAAA;AAAA,QACrB,QAAQA,6BAAA,CAAa,UAAA;AAAA,QACrB,WAAWA,6BAAA,CAAa,SAAA;AAAA,QACxB,mBAAA,EAAqBC;AAAA,OACvB;AAAA,MACA,MAAM,IAAA,CAAK;AAAA,QACT,UAAA;AAAA,QACA,QAAA;AAAA,QACA,MAAA;AAAA,QACA,MAAA;AAAA,QACA,SAAA;AAAA,QACA;AAAA,OACF,EAAG;AACD,QAAA,MAAM,IAAA,GAAO,MAAM,QAAA,CAAS,SAAA,EAAU;AACtC,QAAA,MAAM,aAAA,GAAgBC,mCAAA;AAAA,UACpB,qCAAA;AAAA,UACA;AAAA,SACF;AACA,QAAA,MAAA,CAAO,IAAA,CAAK,CAAA,yBAAA,EAA4B,aAAa,CAAA,CAAE,CAAA;AACvD,QAAA,MAAM,CAAC,OAAA,EAAS,GAAG,IAAI,MAAM,IAAA,CAAK,QAAQ,MAAA,CAAO;AAAA,UAC/C,SAAA,EAAW;AAAA,SACZ,CAAA;AACD,QAAA,MAAA,CAAO,IAAA;AAAA,UACL,CAAA,iCAAA,EAA+B,OAAO,CAAA,OAAA,EACpC,GAAA,CAAI,KAAK,IAAI,CAAA,IAAK,2BACpB,CAAA,QAAA,EAAW,IAAA,CAAK,MAAA,CAAO,MAAA,CAAO,UAAA,EAAY,YAAY,SAAS,CAAA;AAAA,SACjE;AAEA,QAAA,MAAMC,QAAA,GAAS,MAAMC,mBAAA,CAAa;AAAA,UAChC,MAAA;AAAA,UACA;AAAA,SACD,CAAA;AAED,QAAA,MAAM,aAAaC,gCAAA,CAAkB,MAAA,CAAO,EAAE,MAAA,EAAQ,QAAQ,CAAA;AAC9D,QAAAF,QAAA,CAAO,GAAA,CAAI,UAAA,CAAW,QAAA,EAAU,CAAA;AAC9B,QAAAA,QAAA,CAAO,GAAA,CAAI,WAAW,KAAK,CAAA;AAE7B,QAAA,UAAA,CAAW,IAAIA,QAAM,CAAA;AAErB,QAAA,MAAM,YACJ,MAAA,CAAO,WAAA,CAAY,iCAAiC,CAAA,IAAK,EAAE,MAAM,CAAA,EAAE;AAEnE,QAAA,MAAM,eAA8B,MAAA,CAAO,WAAA,CAAY,oCAAoC,CAAA,IAAK,EAAE,SAAS,CAAA,EAAE;AAC7G,QAAA,MAAM,UAAyB,MAAA,CAAO,WAAA,CAAY,+BAA+B,CAAA,IAAK,EAAE,SAAS,EAAA,EAAG;AAGtG,QAAA,MAAM,UAAU,YAAA,CAAa;AAAA,UAC3B,EAAA,EAAI,2BAAA;AAAA,UACJ,SAAA;AAAA,UACA,OAAA;AAAA,UACA,YAAA;AAAA,UACA,IAAI,YAAY;AACd,YAAA,MAAA,CAAO,KAAK,4BAA4B,CAAA;AACxC,YAAA,MAAM,oBAAoB,QAAA,EAAS;AAAA,UACrC;AAAA,SACD,CAAA;AAAA,MACH;AAAA,KACD,CAAA;AAAA,EACH;AACF,CAAC;;;;"}