@transitrix/diagrams 1.13.2 → 1.14.0-rc.0

package/src/compliance/types.ts

@@ -176,6 +176,8 @@ export interface ObjectDetailInput {
 }
 
 export interface ComplianceIndexInput {
+  records?: ChainRecord[];
+  findings?: ChainFinding[];
   requirements: IndexRequirement[];
   assertions: IndexAssertion[];
   /** Optional — absent inputs (existing callers) simply index no verifications. */
@@ -188,6 +190,8 @@ export interface ComplianceIndexInput {
 
 /** The reverse-index — all maps are keyed by canonical id. */
 export interface ComplianceIndex {
+  recordsById: Map<string, ChainRecord[]>;
+  findings: ChainFinding[];
   requirementById: Map<string, IndexRequirement>;
   /** Codex artefact id → requirements whose `derived_from` names it. */
   requirementsByLaw: Map<string, IndexRequirement[]>;
@@ -313,3 +317,20 @@ export interface TraceElementCatalog {
   /** id → human-readable name (or the id itself when unnamed). */
   nameById: Map<string, string>;
 }
+
+/** Lossless records retained beside the compatible legacy projections. */
+export interface ChainRecord {
+  id: string;
+  type: string;
+  sourcePath: string;
+  raw: Record<string, unknown>;
+}
+export interface ChainFinding {
+  id: string;
+  owner: string;
+  field: string;
+  code: string;
+  message: string;
+  reference: boolean;
+  severity: 'error' | 'warning';
+}

package/src/fgca/parse-canonical.ts

@@ -332,6 +332,7 @@ export function parseCanonicalFGCA(
       name: String(el!['name'] ?? ''),
       goal_id: goalRefs.length > 0 ? goalRefs[0] : null,
       ...(typeVal !== undefined ? { type: typeVal } : {}),
+      ...(typeof el!['link'] === 'string' ? { link: el!['link'] } : {}),
       ...(progressVal !== undefined ? { progress: progressVal } : {}),
     };
   });

package/src/fgca/preview-layout.ts

@@ -30,6 +30,7 @@ export interface FGCAPreviewChange {
   activity_ids: Array<number | string>;
 }
 export interface FGCAPreviewActivity {
+  link?: string;
   id: number | string;
   name: string;
   goal_id?: number | string | null;
@@ -387,7 +388,7 @@ export function layoutFGCAPreview(
       ...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, linked: a.goal_id != null })),
+    activity: doc.activities.map(a => ({ id: `activity_${a.id}`, label: a.name, progress: a.progress, linked: Boolean(a.link?.trim()) })),
   };
 
   // Build predecessor map: for each node, which node IDs in the previous column

package/src/fgca/types.ts

@@ -25,6 +25,8 @@ export interface ActivityItem {
   activity_type_id?: number;
   /** Canonical values: initiative | programme | project | work_package. Unknown values pass through without error. */
   type?: string;
+  /** Tracker link, independent of goal relationships. */
+  link?: string;
   progress?: {
     percent: number;
     computedAt: string;

package/src/webview/completion-percent.ts

@@ -0,0 +1,18 @@
+/** Shared completion display contract for Action, DGA and DGCA previews. */
+export interface ActionProgress {
+  percent: number;
+  computedAt: string;
+}
+
+export function completionPercentState(progress: ActionProgress | undefined, linked: boolean, enabled = true, now = Date.now()): { label: string; stale: boolean } | undefined {
+  if (!enabled) return undefined;
+  if (progress && Number.isFinite(progress.percent) && progress.percent >= 0 && progress.percent <= 100 && Number.isFinite(Date.parse(progress.computedAt))) {
+    return { label: `${progress.percent}%`, stale: now - Date.parse(progress.computedAt) > 7 * 24 * 60 * 60 * 1000 };
+  }
+  return linked ? { label: '–%', stale: false } : undefined;
+}
+
+export function completionPercentSvg(progress: ActionProgress | undefined, linked: boolean, x: number, y: number, enabled = true): string {
+  const state = completionPercentState(progress, linked, enabled);
+  return state ? `<text class="text-id completion-percent" x="${x}" y="${y}" text-anchor="end" dominant-baseline="hanging" font-size="10"${state.stale ? ' opacity="0.5"' : ''}>${state.label}</text>` : '';
+}

package/src/webview/render-activities.ts

@@ -16,6 +16,7 @@
  * in `renderActivitiesNetworkBody` and is shared verbatim with the VS Code
  * preview's `networkSvg`.
  */
+import { completionPercentSvg } from './completion-percent.js';
 import { layoutActivities } from '../activities/layout.js';
 import { computeCpm } from '../activities/cpm.js';
 import type {
@@ -147,6 +148,7 @@ function activityNodeSvg(
   return [
     `<rect class="${cls}" x="${x}" y="${y}" width="${n.width}" height="${n.height}" rx="8"/>`,
     textSvg,
+    completionPercentSvg(n.data.progress, Boolean(n.data.link?.trim()), x + n.width - 8, y + 6),
     durLabel ? `<text class="text-secondary" x="${x + n.width - 8}" y="${y + n.height - 8}" text-anchor="end">${durLabel}</text>` : '',
   ].filter(Boolean).join('\n');
 }

package/src/webview/render-fgca.ts

@@ -12,6 +12,7 @@
  * `change` column (`hideChanges` / the layout's Goal → Activity collapse),
  * exactly as the extension preview does.
  */
+import { completionPercentSvg } from './completion-percent.js';
 import {
   layoutFGCAPreview,
   FGCA_NODE_W,
@@ -65,7 +66,6 @@ export function renderFgcaBody(
   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
     .map(({ col, x }) =>
@@ -103,20 +103,8 @@ export function renderFgcaBody(
       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 = showCompletionPercent && n.col === 'activity'
-        ? (() => {
-            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 '';
-          })()
+      const progressBadge = n.col === 'activity'
+        ? completionPercentSvg(n.progress, Boolean(n.linked), n.x + nodeWidth - 6, n.y + 22, showCompletionPercent)
         : '';
       return [
         `<g>`,