Initiatives: add URLs to remote files in node descriptions (#1670)

Small UI improvement, making it easier to inspect and reference initiatives.

src/plugins/initiatives/createGraph.js

@@ -18,16 +18,20 @@ import {
   contributesToEdgeType,
   championsEdgeType,
 } from "./declaration";
+import {initiativeFileURL} from "./initiativesDirectory";
 
 function initiativeAddress(initiative: Initiative): NodeAddressT {
   return addressFromId(initiative.id);
 }
 
 function initiativeNode(initiative: Initiative): Node {
+  const address = initiativeAddress(initiative);
+  const url = initiativeFileURL(address);
   return {
-    address: initiativeAddress(initiative),
+    address,
     timestampMs: initiative.timestampMs,
-    description: initiative.title,
+    description:
+      url == null ? initiative.title : `[${initiative.title}](${url})`,
   };
 }
 

src/plugins/initiatives/createGraph.test.js

@@ -8,7 +8,7 @@ import {
 } from "../../core/graph";
 import type {ReferenceDetector, URL} from "../../core/references";
 import type {Initiative, InitiativeRepository} from "./initiative";
-import {createId} from "./initiative";
+import {createId, addressFromId} from "./initiative";
 import {createGraph} from "./createGraph";
 import {
   initiativeNodeType,
@@ -135,6 +135,25 @@ describe("plugins/initiatives/createGraph", () => {
       ]);
     });
 
+    it("should add initiative file urls to the description", () => {
+      // Given
+      const {repo, refs} = example();
+      const remoteUrl = "http://foo.bar/dir";
+      const fileName = "sample.json";
+      const id = createId("INITIATIVE_FILE", remoteUrl, fileName);
+      const addres = addressFromId(id);
+      repo.addInitiative({id});
+
+      // When
+      const graph = createGraph(repo, refs);
+
+      // Then
+      const node = graph.node(addres);
+      expect(node).toMatchObject({
+        description: `[Example Initiative 1](${remoteUrl}/${fileName})`,
+      });
+    });
+
     describe("reference detection attempts", () => {
       it("should attempt to resolve dependency URLs", () => {
         // Given