@transitrix/diagrams 1.13.0 → 1.13.2

package/dist/fgca/preview-layout.d.ts

@@ -94,6 +94,8 @@ export interface FGCAPreviewNode {
     };
     /** Marks a synthesized node (e.g. virtual Change) vs. a real entity. */
     virtual?: boolean;
+    /** For activity nodes: true if the activity is linked to a goal. */
+    linked?: boolean;
 }
 export interface FGCAPreviewEdge {
     sx: number;

package/dist/fgca/preview-layout.js

@@ -235,6 +235,7 @@ export function layoutFGCAPreview(inputDoc, options = {}) {
     const coveredActivities = new Set(changes.flatMap(c => c.activity_ids.map(String)));
     // Synthesize virtual Change nodes for activities without a real Change.
     // Each virtual node is 1:1 with one activity (not shared across activities).
+    // The layout key embeds the activity id for uniqueness; it is not a display id.
     const virtualChanges = [];
     for (const a of doc.activities) {
         if (a.goal_id != null && !coveredActivities.has(String(a.id))) {
@@ -249,7 +250,7 @@ export function layoutFGCAPreview(inputDoc, options = {}) {
             ...changes.map(c => ({ id: `change_${c.id}`, label: c.name })),
             ...virtualChanges.map(v => ({ id: v.id, label: '–', virtual: true })),
         ],
-        activity: doc.activities.map(a => ({ id: `activity_${a.id}`, label: a.name, progress: a.progress })),
+        activity: doc.activities.map(a => ({ id: `activity_${a.id}`, label: a.name, progress: a.progress, linked: a.goal_id != null })),
     };
     // Build predecessor map: for each node, which node IDs in the previous column
     // connect to it from the left. Used for barycenter crossing minimization.
@@ -321,6 +322,7 @@ export function layoutFGCAPreview(inputDoc, options = {}) {
                 type: item.type,
                 progress: item.progress,
                 virtual: item.virtual,
+                linked: item.linked,
             };
             nodes.push(node);
             nodeMap.set(item.id, node);

package/dist/fgca/resolver.d.ts

@@ -33,6 +33,10 @@ export interface FGCAViewConfig {
 export interface FGCACanonSources {
     elements: unknown[];
     relations: unknown[];
+    progressData?: Map<string, {
+        percent: number;
+        computedAt: string;
+    }>;
 }
 /**
  * Returns true when the parsed view document uses the canon-projection form

package/dist/fgca/resolver.js

@@ -148,5 +148,6 @@ export function resolveFGCA(viewDoc, sources) {
         view_config: viewDoc['view_config'],
         __outOfScopeGoalIds: outOfScopeGoalIds,
         __outOfScopeFactorIds: outOfScopeFactorIds,
+        __progressData: sources.progressData,
     };
 }

package/dist/webview/entity-text-layout.d.ts

@@ -64,7 +64,8 @@ export interface LayoutCenteredEntityOptions {
     boxHeight: number;
     name: string;
     type?: string;
-    id: string;
+    /** Canonical entity id. Empty or omitted skips the id row (placeholder nodes). */
+    id?: string;
     nameMaxLines?: number;
     idMaxLines?: number;
     marginX?: number;

package/dist/webview/entity-text-layout.js

@@ -159,7 +159,15 @@ export function truncateId(id, maxChars) {
  * to avoid overlap.
  */
 const HALF_EXTENT_PRIMARY = 6; // text-primary, 12px font
+const HALF_EXTENT_SECONDARY = 6; // text-secondary, same size as name
 const HALF_EXTENT_ID = 5; // text-id, 10px font
+function glyphHalfExtent(cls) {
+    if (cls === 'text-id')
+        return HALF_EXTENT_ID;
+    if (cls === 'text-secondary')
+        return HALF_EXTENT_SECONDARY;
+    return HALF_EXTENT_PRIMARY;
+}
 /** Place `groups`' lines starting at `startY`, advancing by each line's own height and gap. */
 function placeLines(groups, startY) {
     const out = [];
@@ -201,15 +209,18 @@ export function layoutCenteredEntityText(opts) {
     const maxCharsType = maxCharsForInnerWidth(innerW, CHAR_W_SECONDARY);
     const maxCharsId = maxCharsForInnerWidth(innerW, CHAR_W_ID);
     const typeLine = opts.type?.trim() ? truncateLine(opts.type, maxCharsType) : undefined;
+    const idText = opts.id?.trim() ?? '';
     const idMaxLines = opts.idMaxLines ?? 1;
-    const idLines = idMaxLines <= 1 ? [truncateId(opts.id, maxCharsId)] : wrapId(opts.id, maxCharsId, idMaxLines);
+    const idLines = idText
+        ? (idMaxLines <= 1 ? [truncateId(idText, maxCharsId)] : wrapId(idText, maxCharsId, idMaxLines))
+        : [];
     function buildGroups(nameLines) {
         const groups = [
             {
                 cls: 'text-primary',
                 lines: nameLines,
                 lineHeight: LINE_H_PRIMARY,
-                gapAfter: typeLine ? ROW_GROUP_GAP : NAME_ID_GAP,
+                gapAfter: typeLine ? ROW_GROUP_GAP : idLines.length > 0 ? NAME_ID_GAP : 0,
             },
         ];
         if (typeLine) {
@@ -217,28 +228,30 @@ export function layoutCenteredEntityText(opts) {
                 cls: 'text-secondary',
                 lines: [typeLine],
                 lineHeight: LINE_H_SECONDARY,
-                gapAfter: NAME_ID_GAP,
+                gapAfter: idLines.length > 0 ? NAME_ID_GAP : 0,
+            });
+        }
+        if (idLines.length > 0) {
+            groups.push({
+                cls: 'text-id',
+                lines: idLines,
+                lineHeight: LINE_H_ID,
+                gapAfter: 0,
             });
         }
-        groups.push({
-            cls: 'text-id',
-            lines: idLines,
-            lineHeight: LINE_H_ID,
-            gapAfter: 0,
-        });
         return groups;
     }
-    // groups[0] is always the name (text-primary) and the last group is always
-    // the id (text-id), so the edge-padding half-extents below are fixed.
+    // groups[0] is always the name (text-primary). The last group is the id when
+    // one is present, otherwise type or name; edge padding uses that class.
     const requestedNameMaxLines = Math.max(1, opts.nameMaxLines ?? 2);
     const availableHeight = Math.max(0, opts.boxHeight - marginY * 2);
     let nameLines = wrapWords(opts.name, maxCharsName, requestedNameMaxLines);
     let groups = buildGroups(nameLines);
-    let contentSpan = centerSpan(groups) + HALF_EXTENT_PRIMARY + HALF_EXTENT_ID;
+    let contentSpan = centerSpan(groups) + HALF_EXTENT_PRIMARY + glyphHalfExtent(groups[groups.length - 1].cls);
     for (let cap = requestedNameMaxLines - 1; cap >= 1 && contentSpan > availableHeight; cap--) {
         nameLines = wrapWords(opts.name, maxCharsName, cap);
         groups = buildGroups(nameLines);
-        contentSpan = centerSpan(groups) + HALF_EXTENT_PRIMARY + HALF_EXTENT_ID;
+        contentSpan = centerSpan(groups) + HALF_EXTENT_PRIMARY + glyphHalfExtent(groups[groups.length - 1].cls);
     }
     const margin = Math.max(0, (opts.boxHeight - contentSpan) / 2);
     const firstY = Math.round(opts.boxY + margin + HALF_EXTENT_PRIMARY);

package/dist/webview/render-fgca.d.ts

@@ -21,6 +21,7 @@ export interface RenderFgcaBodyOptions {
     nodeWidth?: number;
     nodeHeight?: number;
     edgeStyle?: EdgeStyle;
+    showCompletionPercent?: boolean;
 }
 /**
  * Canonical DGCA/DGA body — the column headers, node rects and edge paths that
@@ -46,6 +47,8 @@ export interface RenderFgcaOptions {
     layoutOptions?: Parameters<typeof layoutFGCAPreview>[1];
     /** Show scope caption when goal-scoped projection omits goals that reference out-of-scope goals. */
     scopeCaption?: boolean;
+    /** Show completion percent badges on action nodes. */
+    showCompletionPercent?: boolean;
 }
 export declare function renderFgcaSvg(doc: FGCADoc, options?: RenderFgcaOptions): string;
 export {};

package/dist/webview/render-fgca.js

@@ -37,6 +37,7 @@ export function renderFgcaBody(columns, nodes, edges, curvature, entryCurvature,
     const nodeWidth = bodyOptions.nodeWidth ?? FGCA_NODE_W;
     const nodeHeight = bodyOptions.nodeHeight ?? FGCA_NODE_H;
     const edgeStyle = bodyOptions.edgeStyle;
+    const showCompletionPercent = bodyOptions.showCompletionPercent ?? true;
     const headerTruncate = Math.max(8, Math.floor((nodeWidth - 16) / 7));
     const STALENESS_THRESHOLD_MS = 7 * 24 * 60 * 60 * 1000;
     const headerSvg = columns
@@ -47,7 +48,9 @@ export function renderFgcaBody(columns, nodes, edges, curvature, entryCurvature,
         .join('\n');
     const nodeSvg = nodes
         .map((n) => {
-        const entityId = n.id.slice(n.id.indexOf('_') + 1);
+        // Virtual Change nodes use a layout key such as `vchange_activity_<id>`;
+        // slicing at the first `_` would print `activity_<id>` on a Change.
+        const entityId = n.virtual ? '' : n.id.slice(n.id.indexOf('_') + 1);
         const nodeClass = n.virtual ? 'diagram-node layer-virtual' : `diagram-node layer-${n.col}`;
         const specs = layoutCenteredEntityText({
             boxX: n.x,
@@ -60,18 +63,25 @@ export function renderFgcaBody(columns, nodes, edges, curvature, entryCurvature,
             idMaxLines: 1,
         });
         const textSvg = emitCenteredTextSvg(specs, n.x + nodeWidth / 2, escXml);
-        const titleContent = `${escXml(n.label)} (${escXml(entityId)})`;
+        const titleContent = n.virtual
+            ? escXml(n.label)
+            : `${escXml(n.label)} (${escXml(entityId)})`;
         const typeBadge = n.type && n.col === 'activity'
             ? `<text class="text-id" x="${n.x + nodeWidth - 6}" y="${n.y + 10}" text-anchor="end" dominant-baseline="hanging" font-size="10">${escXml(n.type)}</text>`
             : '';
-        const progressBadge = n.progress && n.col === 'activity'
+        const progressBadge = showCompletionPercent && n.col === 'activity'
             ? (() => {
-                const computedAt = new Date(n.progress.computedAt);
-                const now = new Date();
-                const isStale = now.getTime() - computedAt.getTime() > STALENESS_THRESHOLD_MS;
-                const className = isStale ? 'text-id' : 'text-id';
-                const opacity = isStale ? ' opacity="0.5"' : '';
-                return `<text class="${className}" x="${n.x + nodeWidth - 6}" y="${n.y + 22}" text-anchor="end" dominant-baseline="hanging" font-size="10"${opacity}>${escXml(n.progress.percent + '%')}</text>`;
+                if (n.progress) {
+                    const computedAt = new Date(n.progress.computedAt);
+                    const now = new Date();
+                    const isStale = now.getTime() - computedAt.getTime() > STALENESS_THRESHOLD_MS;
+                    const opacity = isStale ? ' opacity="0.5"' : '';
+                    return `<text class="text-id" x="${n.x + nodeWidth - 6}" y="${n.y + 22}" text-anchor="end" dominant-baseline="hanging" font-size="10"${opacity}>${escXml(n.progress.percent + '%')}</text>`;
+                }
+                if (n.linked) {
+                    return `<text class="text-id" x="${n.x + nodeWidth - 6}" y="${n.y + 22}" text-anchor="end" dominant-baseline="hanging" font-size="10">–%</text>`;
+                }
+                return '';
             })()
             : '';
         return [
@@ -88,7 +98,7 @@ export function renderFgcaBody(columns, nodes, edges, curvature, entryCurvature,
     return `${headerSvg}\n${nodeSvg}\n${edgeSvg}`;
 }
 export function renderFgcaSvg(doc, options = {}) {
-    const { variant = 'dgca', title = '', curvature = DEFAULT_EDGE_CURVATURE, entryCurvature, edgeStyle, nodeSizePreset = 'normal', layoutOptions, scopeCaption = false, } = options;
+    const { variant = 'dgca', title = '', curvature = DEFAULT_EDGE_CURVATURE, entryCurvature, edgeStyle, nodeSizePreset = 'normal', layoutOptions, scopeCaption = false, showCompletionPercent = true, } = options;
     const hideChanges = variant === 'dga' || doc.hideChanges === true;
     const nodeSize = resolveDgcaNodeSize(parseNodeSizePreset(nodeSizePreset));
     const { nodes, edges, columns, width, height } = layoutFGCAPreview(doc, {
@@ -104,6 +114,7 @@ export function renderFgcaSvg(doc, options = {}) {
         nodeWidth: nodeSize.width,
         nodeHeight: nodeSize.height,
         edgeStyle,
+        showCompletionPercent,
     });
     const titleSvg = title
         ? `<text class="text-header" x="${PAD}" y="${PAD - 6}">${escXml(title)}</text>`

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@transitrix/diagrams",
-  "version": "1.13.0",
+  "version": "1.13.2",
   "type": "module",
   "description": "Shared rendering, validation, and pure mutations for Transitrix custom diagram formats.",
   "license": "MIT",
@@ -53,7 +53,7 @@
   },
   "devDependencies": {
     "@testing-library/dom": "^10.4.1",
-    "@testing-library/react": "^16.3.2",
+    "@testing-library/react": "^16.3.3",
     "@types/react": "^19.2.17",
     "@types/react-dom": "^19.2.5",
     "jsdom": "^29.1.1",

package/src/fgca/preview-layout.ts

@@ -315,6 +315,8 @@ export interface FGCAPreviewNode {
   };
   /** Marks a synthesized node (e.g. virtual Change) vs. a real entity. */
   virtual?: boolean;
+  /** For activity nodes: true if the activity is linked to a goal. */
+  linked?: boolean;
 }
 export interface FGCAPreviewEdge {
   sx: number;
@@ -369,6 +371,7 @@ export function layoutFGCAPreview(
 
   // Synthesize virtual Change nodes for activities without a real Change.
   // Each virtual node is 1:1 with one activity (not shared across activities).
+  // The layout key embeds the activity id for uniqueness; it is not a display id.
   const virtualChanges: Array<{ id: string; activityId: string; goalId: string }> = [];
   for (const a of doc.activities) {
     if (a.goal_id != null && !coveredActivities.has(String(a.id))) {
@@ -377,14 +380,14 @@ export function layoutFGCAPreview(
     }
   }
 
-  const colItems: Record<FGCAPreviewColumn, Array<{ id: string; label: string; type?: string; progress?: { percent: number; computedAt: string }; virtual?: boolean }>> = {
+  const colItems: Record<FGCAPreviewColumn, Array<{ id: string; label: string; type?: string; progress?: { percent: number; computedAt: string }; virtual?: boolean; linked?: boolean }>> = {
     driver:   doc.factors.map(f => ({ id: `driver_${f.id}`,     label: f.name })),
     goal:     doc.goals.map(g   => ({ id: `goal_${g.id}`,       label: g.name })),
     change:   [
       ...changes.map(c => ({ id: `change_${c.id}`, label: c.name })),
       ...virtualChanges.map(v => ({ id: v.id, label: '–', virtual: true })),
     ],
-    activity: doc.activities.map(a => ({ id: `activity_${a.id}`, label: a.name, progress: a.progress })),
+    activity: doc.activities.map(a => ({ id: `activity_${a.id}`, label: a.name, progress: a.progress, linked: a.goal_id != null })),
   };
 
   // Build predecessor map: for each node, which node IDs in the previous column
@@ -429,9 +432,9 @@ export function layoutFGCAPreview(
   // Nodes with no predecessors sort last (Infinity barycenter) so they don't
   // displace connected nodes.
   function barycentricSort(
-    items: Array<{ id: string; label: string; type?: string; progress?: { percent: number; computedAt: string }; virtual?: boolean }>,
+    items: Array<{ id: string; label: string; type?: string; progress?: { percent: number; computedAt: string }; virtual?: boolean; linked?: boolean }>,
     yCenters: Map<string, number>,
-  ): Array<{ id: string; label: string; type?: string; progress?: { percent: number; computedAt: string }; virtual?: boolean }> {
+  ): Array<{ id: string; label: string; type?: string; progress?: { percent: number; computedAt: string }; virtual?: boolean; linked?: boolean }> {
     return [...items].sort((a, b) => {
       const pA = (predecessors.get(a.id) ?? []).map(p => yCenters.get(p) ?? 0).filter(v => v > 0);
       const pB = (predecessors.get(b.id) ?? []).map(p => yCenters.get(p) ?? 0).filter(v => v > 0);
@@ -462,6 +465,7 @@ export function layoutFGCAPreview(
         type: item.type,
         progress: item.progress,
         virtual: item.virtual,
+        linked: item.linked,
       };
       nodes.push(node);
       nodeMap.set(item.id, node);

package/src/fgca/resolver.ts

@@ -26,6 +26,7 @@ export interface FGCAViewConfig {
 export interface FGCACanonSources {
   elements: unknown[];
   relations: unknown[];
+  progressData?: Map<string, { percent: number; computedAt: string }>;
 }
 
 function isObject(v: unknown): v is Record<string, unknown> {
@@ -192,5 +193,6 @@ export function resolveFGCA(
     view_config: viewDoc['view_config'],
     __outOfScopeGoalIds: outOfScopeGoalIds,
     __outOfScopeFactorIds: outOfScopeFactorIds,
+    __progressData: sources.progressData,
   };
 }

package/src/webview/entity-text-layout.ts

@@ -165,7 +165,8 @@ export interface LayoutCenteredEntityOptions {
   boxHeight: number;
   name: string;
   type?: string;
-  id: string;
+  /** Canonical entity id. Empty or omitted skips the id row (placeholder nodes). */
+  id?: string;
   nameMaxLines?: number;
   idMaxLines?: number;
   marginX?: number;
@@ -189,8 +190,15 @@ interface TextRowGroup {
  * to avoid overlap.
  */
 const HALF_EXTENT_PRIMARY = 6; // text-primary, 12px font
+const HALF_EXTENT_SECONDARY = 6; // text-secondary, same size as name
 const HALF_EXTENT_ID = 5; // text-id, 10px font
 
+function glyphHalfExtent(cls: string): number {
+  if (cls === 'text-id') return HALF_EXTENT_ID;
+  if (cls === 'text-secondary') return HALF_EXTENT_SECONDARY;
+  return HALF_EXTENT_PRIMARY;
+}
+
 /** Place `groups`' lines starting at `startY`, advancing by each line's own height and gap. */
 function placeLines(groups: TextRowGroup[], startY: number): TextLineSpec[] {
   const out: TextLineSpec[] = [];
@@ -234,8 +242,11 @@ export function layoutCenteredEntityText(opts: LayoutCenteredEntityOptions): Tex
   const maxCharsId = maxCharsForInnerWidth(innerW, CHAR_W_ID);
 
   const typeLine = opts.type?.trim() ? truncateLine(opts.type, maxCharsType) : undefined;
+  const idText = opts.id?.trim() ?? '';
   const idMaxLines = opts.idMaxLines ?? 1;
-  const idLines = idMaxLines <= 1 ? [truncateId(opts.id, maxCharsId)] : wrapId(opts.id, maxCharsId, idMaxLines);
+  const idLines = idText
+    ? (idMaxLines <= 1 ? [truncateId(idText, maxCharsId)] : wrapId(idText, maxCharsId, idMaxLines))
+    : [];
 
   function buildGroups(nameLines: string[]): TextRowGroup[] {
     const groups: TextRowGroup[] = [
@@ -243,7 +254,7 @@ export function layoutCenteredEntityText(opts: LayoutCenteredEntityOptions): Tex
         cls: 'text-primary',
         lines: nameLines,
         lineHeight: LINE_H_PRIMARY,
-        gapAfter: typeLine ? ROW_GROUP_GAP : NAME_ID_GAP,
+        gapAfter: typeLine ? ROW_GROUP_GAP : idLines.length > 0 ? NAME_ID_GAP : 0,
       },
     ];
     if (typeLine) {
@@ -251,26 +262,28 @@ export function layoutCenteredEntityText(opts: LayoutCenteredEntityOptions): Tex
         cls: 'text-secondary',
         lines: [typeLine],
         lineHeight: LINE_H_SECONDARY,
-        gapAfter: NAME_ID_GAP,
+        gapAfter: idLines.length > 0 ? NAME_ID_GAP : 0,
+      });
+    }
+    if (idLines.length > 0) {
+      groups.push({
+        cls: 'text-id',
+        lines: idLines,
+        lineHeight: LINE_H_ID,
+        gapAfter: 0,
       });
     }
-    groups.push({
-      cls: 'text-id',
-      lines: idLines,
-      lineHeight: LINE_H_ID,
-      gapAfter: 0,
-    });
     return groups;
   }
 
-  // groups[0] is always the name (text-primary) and the last group is always
-  // the id (text-id), so the edge-padding half-extents below are fixed.
+  // groups[0] is always the name (text-primary). The last group is the id when
+  // one is present, otherwise type or name; edge padding uses that class.
   const requestedNameMaxLines = Math.max(1, opts.nameMaxLines ?? 2);
   const availableHeight = Math.max(0, opts.boxHeight - marginY * 2);
 
   let nameLines = wrapWords(opts.name, maxCharsName, requestedNameMaxLines);
   let groups = buildGroups(nameLines);
-  let contentSpan = centerSpan(groups) + HALF_EXTENT_PRIMARY + HALF_EXTENT_ID;
+  let contentSpan = centerSpan(groups) + HALF_EXTENT_PRIMARY + glyphHalfExtent(groups[groups.length - 1].cls);
   for (
     let cap = requestedNameMaxLines - 1;
     cap >= 1 && contentSpan > availableHeight;
@@ -278,7 +291,7 @@ export function layoutCenteredEntityText(opts: LayoutCenteredEntityOptions): Tex
   ) {
     nameLines = wrapWords(opts.name, maxCharsName, cap);
     groups = buildGroups(nameLines);
-    contentSpan = centerSpan(groups) + HALF_EXTENT_PRIMARY + HALF_EXTENT_ID;
+    contentSpan = centerSpan(groups) + HALF_EXTENT_PRIMARY + glyphHalfExtent(groups[groups.length - 1].cls);
   }
 
   const margin = Math.max(0, (opts.boxHeight - contentSpan) / 2);

package/src/webview/render-fgca.ts

@@ -40,6 +40,7 @@ export interface RenderFgcaBodyOptions {
   nodeWidth?: number;
   nodeHeight?: number;
   edgeStyle?: EdgeStyle;
+  showCompletionPercent?: boolean;
 }
 
 /**
@@ -62,6 +63,7 @@ export function renderFgcaBody(
   const nodeWidth = bodyOptions.nodeWidth ?? FGCA_NODE_W;
   const nodeHeight = bodyOptions.nodeHeight ?? FGCA_NODE_H;
   const edgeStyle = bodyOptions.edgeStyle;
+  const showCompletionPercent = bodyOptions.showCompletionPercent ?? true;
   const headerTruncate = Math.max(8, Math.floor((nodeWidth - 16) / 7));
   const STALENESS_THRESHOLD_MS = 7 * 24 * 60 * 60 * 1000;
 
@@ -80,7 +82,9 @@ export function renderFgcaBody(
 
   const nodeSvg = nodes
     .map((n) => {
-      const entityId = n.id.slice(n.id.indexOf('_') + 1);
+      // Virtual Change nodes use a layout key such as `vchange_activity_<id>`;
+      // slicing at the first `_` would print `activity_<id>` on a Change.
+      const entityId = n.virtual ? '' : n.id.slice(n.id.indexOf('_') + 1);
       const nodeClass = n.virtual ? 'diagram-node layer-virtual' : `diagram-node layer-${n.col}`;
       const specs = layoutCenteredEntityText({
         boxX: n.x,
@@ -93,18 +97,25 @@ export function renderFgcaBody(
         idMaxLines: 1,
       });
       const textSvg = emitCenteredTextSvg(specs, n.x + nodeWidth / 2, escXml);
-      const titleContent = `${escXml(n.label)} (${escXml(entityId)})`;
+      const titleContent = n.virtual
+        ? escXml(n.label)
+        : `${escXml(n.label)} (${escXml(entityId)})`;
       const typeBadge = n.type && n.col === 'activity'
         ? `<text class="text-id" x="${n.x + nodeWidth - 6}" y="${n.y + 10}" text-anchor="end" dominant-baseline="hanging" font-size="10">${escXml(n.type)}</text>`
         : '';
-      const progressBadge = n.progress && n.col === 'activity'
+      const progressBadge = showCompletionPercent && n.col === 'activity'
         ? (() => {
-            const computedAt = new Date(n.progress.computedAt);
-            const now = new Date();
-            const isStale = now.getTime() - computedAt.getTime() > STALENESS_THRESHOLD_MS;
-            const className = isStale ? 'text-id' : 'text-id';
-            const opacity = isStale ? ' opacity="0.5"' : '';
-            return `<text class="${className}" x="${n.x + nodeWidth - 6}" y="${n.y + 22}" text-anchor="end" dominant-baseline="hanging" font-size="10"${opacity}>${escXml(n.progress.percent + '%')}</text>`;
+            if (n.progress) {
+              const computedAt = new Date(n.progress.computedAt);
+              const now = new Date();
+              const isStale = now.getTime() - computedAt.getTime() > STALENESS_THRESHOLD_MS;
+              const opacity = isStale ? ' opacity="0.5"' : '';
+              return `<text class="text-id" x="${n.x + nodeWidth - 6}" y="${n.y + 22}" text-anchor="end" dominant-baseline="hanging" font-size="10"${opacity}>${escXml(n.progress.percent + '%')}</text>`;
+            }
+            if (n.linked) {
+              return `<text class="text-id" x="${n.x + nodeWidth - 6}" y="${n.y + 22}" text-anchor="end" dominant-baseline="hanging" font-size="10">–%</text>`;
+            }
+            return '';
           })()
         : '';
       return [
@@ -136,6 +147,8 @@ export interface RenderFgcaOptions {
   layoutOptions?: Parameters<typeof layoutFGCAPreview>[1];
   /** Show scope caption when goal-scoped projection omits goals that reference out-of-scope goals. */
   scopeCaption?: boolean;
+  /** Show completion percent badges on action nodes. */
+  showCompletionPercent?: boolean;
 }
 
 export function renderFgcaSvg(doc: FGCADoc, options: RenderFgcaOptions = {}): string {
@@ -148,6 +161,7 @@ export function renderFgcaSvg(doc: FGCADoc, options: RenderFgcaOptions = {}): st
     nodeSizePreset = 'normal',
     layoutOptions,
     scopeCaption = false,
+    showCompletionPercent = true,
   } = options;
   const hideChanges = variant === 'dga' || doc.hideChanges === true;
   const nodeSize = resolveDgcaNodeSize(parseNodeSizePreset(nodeSizePreset));
@@ -167,6 +181,7 @@ export function renderFgcaSvg(doc: FGCADoc, options: RenderFgcaOptions = {}): st
     nodeWidth: nodeSize.width,
     nodeHeight: nodeSize.height,
     edgeStyle,
+    showCompletionPercent,
   });
 
   const titleSvg = title