Api report and changelog

Signed-off-by: sblausten <sam@roadie.io>

.changeset/rich-steaks-juggle.md

@@ -0,0 +1,9 @@
+---
+'@backstage/plugin-tech-insights-node': minor
+'@backstage/plugin-tech-insights-backend': patch
+---
+
+**Breaking**: The FactRetriever model is extended by adding required title and description fields. This allows us to
+display Fact Retrievers in the UI in future.
+
+If you have existing custom `FactRetriever` implementations hardcoded, you'll need to add a `title` and `description` to them.

plugins/tech-insights-node/api-report.md

@@ -46,12 +46,14 @@ export type FactLifecycle = TTL | MaxItems;
 
 // @public
 export interface FactRetriever {
+  description: string;
   entityFilter?:
     | Record<string, string | symbol | (string | symbol)[]>[]
     | Record<string, string | symbol | (string | symbol)[]>;
   handler: (ctx: FactRetrieverContext) => Promise<TechInsightFact[]>;
   id: string;
   schema: FactSchema;
+  title: string;
   version: string;
 }
 

plugins/tech-insights-node/src/facts.ts

@@ -174,6 +174,16 @@ export interface FactRetriever {
    */
   version: string;
 
+  /**
+   * A short display title for the fact retriever to be used in the interface
+   */
+  title: string;
+
+  /**
+   * A short display description for the fact retriever to be used in the interface.
+   */
+  description: string;
+
   /**
    * Handler function that needs to be implemented to retrieve fact values for entities.
    *