sfdx-hardis 5.10.2-beta202412231619.0 → 5.10.2-beta202412292224.0

package/lib/common/utils/mermaidUtils.js

@@ -3,7 +3,7 @@ import fs from 'fs-extra';
 import * as Diff from "diff";
 import * as path from "path";
 import which from "which";
-import { execCommand, git, uxLog } from "./index.js";
+import { execCommand, git, isDockerRunning, uxLog } from "./index.js";
 import { parseFlow } from "./flowVisualiser/flowParser.js";
 import { getReportDirectory } from "../../config/index.js";
 import moment from "moment";
@@ -26,13 +26,15 @@ export async function isDockerAvailable() {
     if (IS_DOCKER_AVAILABLE !== null) {
         return IS_DOCKER_AVAILABLE;
     }
-    const isDockerAvailable1 = await which("docker", { nothrow: true });
-    IS_DOCKER_AVAILABLE = isDockerAvailable1 !== null;
+    IS_DOCKER_AVAILABLE = await isDockerRunning();
+    if (!IS_DOCKER_AVAILABLE) {
+        uxLog(this, c.yellow("Docker daemon is not available. If you have issues running npm package @mermaid-js/mermaid-cli, please install Docker and start it"));
+    }
     return IS_DOCKER_AVAILABLE;
 }
-export async function generateFlowMarkdownFile(flowName, flowXml, outputFlowMdFile) {
+export async function generateFlowMarkdownFile(flowName, flowXml, outputFlowMdFile, options = { collapsedDetails: true }) {
     try {
-        const flowDocGenResult = await parseFlow(flowXml, 'mermaid', { outputAsMarkdown: true });
+        const flowDocGenResult = await parseFlow(flowXml, 'mermaid', { outputAsMarkdown: true, collapsedDetails: options.collapsedDetails });
         const flowMarkdownDoc = flowDocGenResult.uml;
         await fs.writeFile(outputFlowMdFile, flowMarkdownDoc);
         uxLog(this, c.grey(`Written ${flowName} documentation in ${outputFlowMdFile}`));
@@ -99,59 +101,80 @@ export async function generateMarkdownFileWithMermaidCli(outputFlowMdFile) {
     }
 }
 export function getMermaidExtraClasses() {
-    return `classDef actionCallsAdded fill:#344568,color:white,stroke:#00ff00,stroke-width:12px;
-classDef assignmentsAdded fill:#F97924,color:white,stroke:#00ff00,stroke-width:12px;
-classDef collectionProcessorsAdded fill:#DD7A00,color:white,stroke:#00ff00,stroke-width:12px;
-classDef customErrorsAdded fill:#032D60,color:white,stroke:#00ff00,stroke-width:12px;
-classDef decisionsAdded fill:#DD7A00,color:white,stroke:#00ff00,stroke-width:12px;
-classDef loopsAdded fill:#E07D1C,color:undefined,stroke:#00ff00,stroke-width:12px;
-classDef recordCreatesAdded fill:#F9548A,color:white,stroke:#00ff00,stroke-width:12px;
-classDef recordDeletesAdded fill:#F9548A,color:white,stroke:#00ff00,stroke-width:12px;
-classDef recordLookupsAdded fill:#F9548A,color:white,stroke:#00ff00,stroke-width:12px;
-classDef recordUpdatesAdded fill:#F9548A,color:white,stroke:#00ff00,stroke-width:12px;
-classDef screensAdded fill:#1B96FF,color:white,stroke:#00ff00,stroke-width:12px;
-classDef subflowsAdded fill:#032D60,color:white,stroke:#00ff00,stroke-width:12px;
-  
-classDef actionCallsRemoved fill:#344568,color:white,stroke:#ff0000,stroke-width:12px;
-classDef assignmentsRemoved fill:#F97924,color:white,stroke:#ff0000,stroke-width:12px;
-classDef collectionProcessorsRemoved fill:#DD7A00,color:white,stroke:#ff0000,stroke-width:12px;
-classDef customErrorsRemoved fill:#032D60,color:white,stroke:#ff0000,stroke-width:12px;
-classDef decisionsRemoved fill:#DD7A00,color:white,stroke:#ff0000,stroke-width:12px;
-classDef loopsRemoved fill:#E07D1C,color:undefined,stroke:#ff0000,stroke-width:12px;
-classDef recordCreatesRemoved fill:#F9548A,color:white,stroke:#ff0000,stroke-width:12px;
-classDef recordDeletesRemoved fill:#F9548A,color:white,stroke:#ff0000,stroke-width:12px;
-classDef recordLookupsRemoved fill:#F9548A,color:white,stroke:#ff0000,stroke-width:12px;
-classDef recordUpdatesRemoved fill:#F9548A,color:white,stroke:#ff0000,stroke-width:12px;
-classDef screensRemoved fill:#1B96FF,color:white,stroke:#ff0000,stroke-width:12px;
-classDef subflowsRemoved fill:#032D60,color:white,stroke:#ff0000,stroke-width:12px;
+    const added = 'fill:green,color:white,stroke-width:4px,max-height:100px';
+    const removed = 'fill:red,color:white,stroke-width:4px,max-height:100px';
+    const changed = 'fill:orange,color:white,stroke-width:4px,max-height:100px';
+    const addedClasses = [
+        'actionCallsAdded',
+        'assignmentsAdded',
+        'collectionProcessorsAdded',
+        'customErrorsAdded',
+        'decisionsAdded',
+        'loopsAdded',
+        'recordCreatesAdded',
+        'recordDeletesAdded',
+        'recordLookupsAdded',
+        'recordUpdatesAdded',
+        'screensAdded',
+        'subflowsAdded',
+        'startClassAdded'
+    ];
+    const removedClasses = [
+        'actionCallsRemoved',
+        'assignmentsRemoved',
+        'collectionProcessorsRemoved',
+        'customErrorsRemoved',
+        'decisionsRemoved',
+        'loopsRemoved',
+        'recordCreatesRemoved',
+        'recordDeletesRemoved',
+        'recordLookupsRemoved',
+        'recordUpdatesRemoved',
+        'screensRemoved',
+        'subflowsRemoved',
+        'startClassRemoved'
+    ];
+    const changedClasses = [
+        'actionCallsChanged',
+        'assignmentsChanged',
+        'collectionProcessorsChanged',
+        'customErrorsChanged',
+        'decisionsChanged',
+        'loopsChanged',
+        'recordCreatesChanged',
+        'recordDeletesChanged',
+        'recordLookupsChanged',
+        'recordUpdatesChanged',
+        'screensChanged',
+        'subflowsChanged',
+        'startClassChanged'
+    ];
+    const formatClasses = (classList, style) => classList.map(className => `classDef ${className} ${style}`).join('\n');
+    return `
+${formatClasses(addedClasses, added)}
 
-classDef actionCallsChanged fill:#344568,color:white,stroke:#edaa18,stroke-width:12px;
-classDef assignmentsChanged fill:#F97924,color:white,stroke:#edaa18,stroke-width:12px;
-classDef collectionProcessorsChanged fill:#DD7A00,color:white,stroke:#edaa18,stroke-width:12px;
-classDef customErrorsChanged fill:#032D60,color:white,stroke:#edaa18,stroke-width:12px;
-classDef decisionsChanged fill:#DD7A00,color:white,stroke:#edaa18,stroke-width:12px;
-classDef loopsChanged fill:#E07D1C,color:undefined,stroke:#edaa18,stroke-width:12px;
-classDef recordCreatesChanged fill:#F9548A,color:white,stroke:#edaa18,stroke-width:12px;
-classDef recordDeletesChanged fill:#F9548A,color:white,stroke:#edaa18,stroke-width:12px;
-classDef recordLookupsChanged fill:#F9548A,color:white,stroke:#edaa18,stroke-width:12px;
-classDef recordUpdatesChanged fill:#F9548A,color:white,stroke:#edaa18,stroke-width:12px;
-classDef screensChanged fill:#1B96FF,color:white,stroke:#edaa18,stroke-width:12px;
-classDef subflowsChanged fill:#032D60,color:white,stroke:#edaa18,stroke-width:12px;
+${formatClasses(removedClasses, removed)}
 
-classDef addedLink stroke:#00ff00,stroke-width:3px;
-classDef removedLink stroke:#ff0000,stroke-width:3px;
-`;
+${formatClasses(changedClasses, changed)}
+  `;
 }
 export async function generateFlowVisualGitDiff(flowFile, commitBefore, commitAfter, options = { mermaidMd: false, svgMd: true, debug: false }) {
+    const result = { outputDiffMdFile: "", hasFlowDiffs: false };
     const mermaidMdBefore = await buildMermaidMarkdown(commitBefore, flowFile);
     const mermaidMdAfter = await buildMermaidMarkdown(commitAfter, flowFile);
     const flowLabel = path.basename(flowFile, ".flow-meta.xml");
+    const reportDir = await getReportDirectory();
+    await fs.ensureDir(path.join(reportDir, "flow-diff"));
+    const diffMdFile = path.join(reportDir, 'flow-diff', `${flowLabel}_${moment().format("YYYYMMDD-hhmmss")}.md`);
     if (options.debug) {
         uxLog(this, c.grey("FLOW DOC BEFORE:\n" + mermaidMdBefore) + "\n");
+        await fs.writeFile(diffMdFile.replace(".md", ".mermaid-before.md"), mermaidMdBefore);
         uxLog(this, c.grey("FLOW DOC AFTER:\n" + mermaidMdAfter) + "\n");
+        await fs.writeFile(diffMdFile.replace(".md", ".mermaid-after.md"), mermaidMdAfter);
     }
     const flowDiffs = Diff.diffLines(mermaidMdBefore, mermaidMdAfter);
-    // uxLog(this, JSON.stringify(flowDiffs, null, 2));
+    result.hasFlowDiffs = flowDiffs.some(line => line.added || line.removed);
+    result.diffLines = flowDiffs.filter(line => line.added || line.removed);
     const mixedLines = [];
     for (const line of flowDiffs) {
         if (line.added) {
@@ -166,26 +189,26 @@ export async function generateFlowVisualGitDiff(flowFile, commitBefore, commitAf
     }
     // uxLog(this, JSON.stringify(mixedLines, null, 2));
     const compareMdLines = [];
-    buildFinalCompareMarkdown(mixedLines, compareMdLines, false, false);
+    const linkLines = [];
+    buildFinalCompareMarkdown(mixedLines, compareMdLines, false, false, linkLines);
     // Write markdown with diff in a file
-    const reportDir = await getReportDirectory();
-    await fs.ensureDir(path.join(reportDir, "flow-diff"));
-    const diffMdFile = path.join(reportDir, 'flow-diff', `${flowLabel}_${moment().format("YYYYMMDD-hhmmss")}.md`);
     await fs.writeFile(diffMdFile, compareMdLines.join("\n"));
     if (options.mermaidMd) {
-        await fs.copyFile(diffMdFile, diffMdFile + ".mermaid.md");
+        await fs.copyFile(diffMdFile, diffMdFile.replace(".md", ".mermaid.md"));
     }
     if (!options.svgMd) {
-        return diffMdFile;
+        result.outputDiffMdFile = diffMdFile;
+        return result;
     }
     // Generate final markdown with mermaid SVG
     const finalRes = await generateMarkdownFileWithMermaid(diffMdFile);
     if (finalRes) {
         uxLog(this, c.green(`Successfully generated visual git diff for flow: ${diffMdFile}`));
     }
-    return diffMdFile;
+    result.outputDiffMdFile = diffMdFile;
+    return result;
 }
-function buildFinalCompareMarkdown(mixedLines, compareMdLines, isMermaid, isTableStarted) {
+function buildFinalCompareMarkdown(mixedLines, compareMdLines, isMermaid, isTableStarted, linkLines) {
     if (mixedLines.length === 0) {
         return;
     }
@@ -197,19 +220,37 @@ function buildFinalCompareMarkdown(mixedLines, compareMdLines, isMermaid, isTabl
     }
     else if (isMermaid === true && currentLine.includes("```")) {
         compareMdLines.push(...getMermaidExtraClasses().split("\n"));
+        // Build link positions
+        let pos = 0;
+        const positions = {
+            added: [],
+            removed: [],
+            unchanged: []
+        };
+        for (const linkType of linkLines) {
+            positions[linkType].push(pos);
+            pos++;
+        }
+        // Build added and removed links styles
+        if (positions.added.length > 0) {
+            compareMdLines.push("linkStyle " + positions.added.join(",") + " stroke:#00ff00,stroke-width:4px,color:green;");
+        }
+        if (positions.removed.length > 0) {
+            compareMdLines.push("linkStyle " + positions.removed.join(",") + " stroke:#ff0000,stroke-width:4px,color:red;");
+        }
         isMermaid = false;
     }
     let styledLine = currentLine;
     // Remove next diff line if not relevant
-    if (styledLine.startsWith("|") && mixedLines.length > 1 && mixedLines[0][1] === '' && mixedLines[1][1].startsWith("|")) {
+    if (styledLine.startsWith("|") && mixedLines.length > 1 && mixedLines[0][1] === '' && mixedLines[1][1].startsWith("|") && !mixedLines[1][1].startsWith("|Condition Id|") && !mixedLines[1][1].startsWith("|Filter Id|")) {
         mixedLines.shift();
     }
     // Skip table block if there are no updated lines within
-    if (styledLine.startsWith("## ") && !styledLine.startsWith("## Flow")) {
+    if (styledLine.startsWith("## ") && !styledLine.startsWith("## Flow Diagram")) {
         let updatedInBlock = false;
         let nextBlockPos = 0;
         for (const nextLine of mixedLines) {
-            if (nextLine[1].startsWith("## ") || nextLine[1].startsWith("_Documentation")) {
+            if (nextLine[1].startsWith("## ") || nextLine[1].includes("_Documentation") || nextLine[1].startsWith("___")) {
                 break;
             }
             if (nextLine[0] === "removed" || nextLine[0] === "added") {
@@ -220,7 +261,7 @@ function buildFinalCompareMarkdown(mixedLines, compareMdLines, isMermaid, isTabl
         if (!updatedInBlock) {
             const mixedLinesStartingFromNextBlock = mixedLines.slice(nextBlockPos);
             // Continue processing next lines
-            buildFinalCompareMarkdown(mixedLinesStartingFromNextBlock, compareMdLines, isMermaid, isTableStarted);
+            buildFinalCompareMarkdown(mixedLinesStartingFromNextBlock, compareMdLines, isMermaid, false, linkLines);
             return;
         }
     }
@@ -230,7 +271,26 @@ function buildFinalCompareMarkdown(mixedLines, compareMdLines, isMermaid, isTabl
         let updatedInBlock = false;
         let nextBlockPos = 0;
         for (const nextLine of mixedLines) {
-            if (nextLine[1].startsWith("### ") || nextLine[1].startsWith("_Documentation")) {
+            if (nextLine[1].startsWith("### ") || nextLine[1].startsWith("## ") || nextLine[1].includes("_Documentation") || nextLine[1].startsWith("___")) {
+                break;
+            }
+            if (nextLine[0] === "removed" || nextLine[0] === "added") {
+                updatedInBlock = true;
+            }
+            nextBlockPos++;
+        }
+        if (!updatedInBlock) {
+            const mixedLinesStartingFromNextBlock = mixedLines.slice(nextBlockPos);
+            // Continue processing next lines
+            buildFinalCompareMarkdown(mixedLinesStartingFromNextBlock, compareMdLines, isMermaid, false, linkLines);
+            return;
+        }
+    }
+    else if (styledLine.startsWith("#### ")) {
+        let updatedInBlock = false;
+        let nextBlockPos = 0;
+        for (const nextLine of mixedLines) {
+            if (nextLine[1].startsWith("#### ") || nextLine[1].startsWith("### ") || nextLine[1].startsWith("## ") || nextLine[1].includes("_Documentation") || nextLine[1].startsWith("___")) {
                 break;
             }
             if (nextLine[0] === "removed" || nextLine[0] === "added") {
@@ -241,7 +301,7 @@ function buildFinalCompareMarkdown(mixedLines, compareMdLines, isMermaid, isTabl
         if (!updatedInBlock) {
             const mixedLinesStartingFromNextBlock = mixedLines.slice(nextBlockPos);
             // Continue processing next lines
-            buildFinalCompareMarkdown(mixedLinesStartingFromNextBlock, compareMdLines, isMermaid, isTableStarted);
+            buildFinalCompareMarkdown(mixedLinesStartingFromNextBlock, compareMdLines, isMermaid, false, linkLines);
             return;
         }
     }
@@ -252,62 +312,76 @@ function buildFinalCompareMarkdown(mixedLines, compareMdLines, isMermaid, isTabl
         const tableFilteredLines = [];
         let endTablePos = 0;
         for (const nextLine of mixedLines) {
-            if (!nextLine[1].startsWith("|") && nextLine[1] !== "") {
+            if ((!nextLine[1].startsWith("|") || nextLine[1].includes("Condition Id") || nextLine[1].includes("Filter Id")) && nextLine[1] !== "") {
                 break;
             }
-            if (nextLine[0] === "removed" || nextLine[0] === "added" || endTablePos === 0) {
+            if ((nextLine[0] === "removed" || nextLine[0] === "added" || endTablePos === 0) && nextLine[1] !== "") {
                 tableFilteredLines.push(nextLine);
             }
             endTablePos++;
         }
-        compareMdLines.push(styledLine);
-        const mixedLinesStartingFromEndOfTable = mixedLines.slice(endTablePos);
-        const newMixedLines = [...tableFilteredLines, ...mixedLinesStartingFromEndOfTable];
-        // Continue processing next lines
-        buildFinalCompareMarkdown(newMixedLines, compareMdLines, isMermaid, true);
+        if (tableFilteredLines.length < 2) {
+            // Empty table
+            const mixedLinesStartingFromEndOfTable = mixedLines.slice(endTablePos);
+            buildFinalCompareMarkdown(mixedLinesStartingFromEndOfTable, compareMdLines, isMermaid, false, linkLines);
+        }
+        else {
+            compareMdLines.push(styledLine);
+            const mixedLinesStartingFromEndOfTable = mixedLines.slice(endTablePos);
+            const newMixedLines = [...tableFilteredLines, ...[["unchanged", ""]], ...mixedLinesStartingFromEndOfTable];
+            // Continue processing next lines
+            buildFinalCompareMarkdown(newMixedLines, compareMdLines, isMermaid, true, linkLines);
+        }
         return;
     }
     // Tables lines
     if (!isMermaid && status === "removed" && styledLine.startsWith("|") && !styledLine.startsWith("|:-")) {
-        styledLine = "|🟥" + styledLine.split("|").filter(e => e !== "").map((col) => `<span style="background-color: red;"><i>${col}</i></span>`).join("|") + "|";
+        styledLine = "|🟥" + styledLine.split("|").filter(e => e !== "").map((col) => `<span style="background-color: #ff7f7f;"><i>${col}</i></span>`).join("|") + "|";
     }
     else if (!isMermaid && status === "added" && styledLine.startsWith("|") && !styledLine.startsWith("|:-")) {
-        styledLine = "|🟩" + styledLine.split("|").filter(e => e !== "").map((col) => `<span style="background-color: green;"><b>${col}</b></span>`).join("|") + "|";
+        styledLine = "|🟩" + styledLine.split("|").filter(e => e !== "").map((col) => `<span style="background-color: #a6e22e;"><b>${col}</b></span>`).join("|") + "|";
+    }
+    // Normal lines header 3
+    else if (!isMermaid && status === "removed" && styledLine.startsWith("#### ")) {
+        styledLine = `#### 🟥${styledLine.replace("#### ", "")}`;
+    }
+    else if (!isMermaid && status === "added" && styledLine.startsWith("#### ")) {
+        styledLine = `#### 🟩${styledLine.replace("#### ", "")}`;
     }
     // Normal lines header 2
-    else if (!isMermaid && status === "removed" && styledLine.startsWith("###")) {
+    else if (!isMermaid && status === "removed" && styledLine.startsWith("### ")) {
         styledLine = `### 🟥${styledLine.replace("### ", "")}`;
     }
-    else if (!isMermaid && status === "added" && styledLine.startsWith("###")) {
+    else if (!isMermaid && status === "added" && styledLine.startsWith("### ")) {
         styledLine = `### 🟩${styledLine.replace("### ", "")}`;
     }
     // Normal lines header 3
-    else if (!isMermaid && status === "removed" && styledLine.startsWith("##")) {
+    else if (!isMermaid && status === "removed" && styledLine.startsWith("## ")) {
         styledLine = `## 🟥${styledLine.replace("## ", "")}`;
     }
-    else if (!isMermaid && status === "added" && styledLine.startsWith("##")) {
+    else if (!isMermaid && status === "added" && styledLine.startsWith("## ")) {
         styledLine = `## 🟩${styledLine.replace("## ", "")}`;
     }
     // Normal lines
-    else if (!isMermaid && status === "removed" && styledLine !== "" && !styledLine.startsWith("|:-")) {
-        styledLine = `<span style="background-color: red;"><i>🟥${styledLine}</i></span>`;
+    else if (!isMermaid && status === "removed" && styledLine !== "" && !styledLine.startsWith("|:-") && !styledLine.startsWith("___")) {
+        styledLine = `<span style="background-color: #ff7f7f;"><i>🟥${styledLine}</i></span>`;
     }
-    else if (!isMermaid && status === "added" && styledLine !== "" && !styledLine.startsWith("|:-")) {
-        styledLine = `<span style="background-color: green;"><b>🟩${styledLine}</b></span>`;
+    else if (!isMermaid && status === "added" && styledLine !== "" && !styledLine.startsWith("|:-") && !styledLine.startsWith("___")) {
+        styledLine = `<span style="background-color: #a6e22e;"><b>🟩${styledLine}</b></span>`;
     }
     // Boxes lines
     else if (isMermaid === true && status === "removed" && currentLine.split(":::").length === 2) {
         styledLine = styledLine + "Removed";
         if (styledLine.split('"').length === 3) {
             const splits = styledLine.split('"');
-            styledLine = splits[0] + '"🟥<i>' + splits[1] + '</i>"' + splits[2];
+            styledLine = splits[0] + '"<i>' + splits[1] + '</i>"' + splits[2];
         }
     }
     else if (isMermaid === true && status === "added" && currentLine.split(":::").length === 2) {
         styledLine = styledLine + "Added";
         if (styledLine.split('"').length === 3) {
             const splits = styledLine.split('"');
-            styledLine = splits[0] + '"🟩<b>' + splits[1] + '</b>"' + splits[2];
+            styledLine = splits[0] + '"<b>' + splits[1] + '</b>"' + splits[2];
         }
     }
     else if (isMermaid === true && currentLine.includes(":::")) {
@@ -315,58 +389,73 @@ function buildFinalCompareMarkdown(mixedLines, compareMdLines, isMermaid, isTabl
         const splits = currentLine.split(/[[({]/);
         if (splits.length > 1) {
             const boxName = splits[0];
-            const changed = mixedLines.filter(([lineStatus, line]) => { return line.startsWith(`click ${boxName}`) && ["added", "changed"].includes(lineStatus); }).length;
+            const changed = mixedLines.filter(([lineStatus, line]) => { return line.startsWith(`click ${boxName}`) && ["added", "removed"].includes(lineStatus); }).length;
             if (changed > 0) {
                 styledLine = styledLine + "Changed";
                 if (styledLine.split('"').length === 3) {
                     const splits = styledLine.split('"');
-                    styledLine = splits[0] + '"🟧<b>' + splits[1] + '</b>"' + splits[2];
+                    styledLine = splits[0] + '"<b>' + splits[1] + '</b>"' + splits[2];
+                }
+                // Remove "removed" line from mixedLines
+                const removedNodePos = mixedLines.findIndex(([lineStatus, line]) => { return line.startsWith(`click ${boxName}`) && lineStatus === "removed"; });
+                if (removedNodePos !== -1) {
+                    mixedLines.splice(removedNodePos, 1);
                 }
             }
         }
     }
     // Long Link lines
     else if (isMermaid === true && status === "removed" && currentLine.includes('-. Fault .->')) {
-        styledLine = styledLine.replace('-. Fault .->', '-. 🟥Fault .->') + ":::removedLink";
+        styledLine = styledLine.replace('-. Fault .->', '-. 🟥Fault .->'); //+ ":::removedLink"
+        linkLines.push("removed");
     }
     else if (isMermaid === true && status === "added" && currentLine.includes('-. Fault .->')) {
-        styledLine = styledLine.replace('-. Fault .->', '-. 🟩Fault .->') + ":::addedLink";
+        styledLine = styledLine.replace('-. Fault .->', '-. 🟩Fault .->'); // + ":::addedLink"
+        linkLines.push("added");
     }
     /* jscpd:ignore-start */
     // Long Link lines
     else if (isMermaid === true && status === "removed" && currentLine.includes('--->')) {
-        styledLine = styledLine.replace("--->", "--.->") + ":::removedLink";
+        styledLine = styledLine.replace("--->", "--.->"); //+ ":::removedLink"
+        linkLines.push("removed");
         if (styledLine.split("|").length === 3) {
             const splits = styledLine.split("|");
-            styledLine = splits[0] + "|🟥<i>" + splits[1] + "</i>|" + splits[2];
+            styledLine = splits[0] + '|"🟥<i>' + removeQuotes(splits[1]) + '</i>"|' + splits[2];
         }
     }
     else if (isMermaid === true && status === "added" && currentLine.includes('--->')) {
-        styledLine = styledLine.replace("--->", "===>") + ":::addedLink";
+        styledLine = styledLine.replace("--->", "===>"); // + ":::addedLink"
+        linkLines.push("added");
         if (styledLine.split("|").length === 3) {
             const splits = styledLine.split("|");
-            styledLine = splits[0] + "|🟩<b>" + splits[1] + "</b>|" + splits[2];
+            styledLine = splits[0] + '|"🟩<b>' + removeQuotes(splits[1]) + '</b>"|' + splits[2];
         }
     }
     // Link lines
     else if (isMermaid === true && status === "removed" && currentLine.includes('-->')) {
-        styledLine = styledLine.replace("-->", "-.->") + ":::removedLink";
+        styledLine = styledLine.replace("-->", "-.->"); // + ":::removedLink"
+        linkLines.push("removed");
         if (styledLine.split("|").length === 3) {
             const splits = styledLine.split("|");
-            styledLine = splits[0] + "|🟥<i>" + splits[1] + "</i>|" + splits[2];
+            styledLine = splits[0] + '|"🟥<i>' + removeQuotes(splits[1]) + '</i>"|' + splits[2];
         }
     }
     else if (isMermaid === true && status === "added" && currentLine.includes('-->')) {
-        styledLine = styledLine.replace("-->", "==>") + ":::addedLink";
+        styledLine = styledLine.replace("-->", "==>"); // + ":::addedLink"
+        linkLines.push("added");
         if (styledLine.split("|").length === 3) {
             const splits = styledLine.split("|");
-            styledLine = splits[0] + "|🟩<b>" + splits[1] + "</b>|" + splits[2];
+            styledLine = splits[0] + '|"🟩<b>' + removeQuotes(splits[1]) + '</b>"|' + splits[2];
         }
     }
+    else if (isMermaid === true && !["added", "removed"].includes(status) &&
+        (currentLine.includes('-->') || currentLine.includes('-. Fault .->'))) {
+        linkLines.push("unchanged");
+    }
     /* jscpd:ignore-end */
     compareMdLines.push(styledLine);
     // Continue processing next lines
-    buildFinalCompareMarkdown(mixedLines, compareMdLines, isMermaid, (styledLine.startsWith("|") && isTableStarted));
+    buildFinalCompareMarkdown(mixedLines, compareMdLines, isMermaid, (styledLine.startsWith("|") && isTableStarted), linkLines);
 }
 async function buildMermaidMarkdown(commit, flowFile) {
     const flowXml = await git().show([`${commit}:${flowFile}`]);
@@ -378,4 +467,101 @@ async function buildMermaidMarkdown(commit, flowFile) {
         throw new SfError(`Unable to build Graph for flow ${flowFile}: ${err.message}`);
     }
 }
+function removeQuotes(str) {
+    if (str.startsWith('"')) {
+        str = str.slice(1);
+    }
+    if (str.endsWith('"')) {
+        str = str.slice(0, -1);
+    }
+    return str;
+}
+export async function generateHistoryDiffMarkdown(flowFile, debugMode) {
+    await fs.ensureDir(path.join("docs", "flows"));
+    const diffMdFile = path.join("docs", "flows", path.basename(flowFile).replace(".flow-meta.xml", "-history.md"));
+    // Compute for all states
+    const fileHistory = await git().log({ file: flowFile });
+    const flowLabel = path.basename(flowFile, ".flow-meta.xml");
+    uxLog(this, c.cyan(`Generating ${flowLabel} markdown diff between ${fileHistory.all.length} Flow states...`));
+    const diffMdFiles = [];
+    for (let i = 0; i < fileHistory.all.length; i++) {
+        const commitAfter = fileHistory.all[i];
+        // Initial state
+        if (i === fileHistory.all.length - 1) {
+            const flowXml = await git().show([`${fileHistory.all[i].hash}:${flowFile}`]);
+            const reportDir = await getReportDirectory();
+            await fs.ensureDir(path.join(reportDir, "flow-diff"));
+            const diffMdFileTmp = path.join(reportDir, 'flow-diff', `${flowLabel}_${moment().format("YYYYMMDD-hhmmss")}.md`);
+            const genRes = await generateFlowMarkdownFile(flowFile, flowXml, diffMdFileTmp, { collapsedDetails: false });
+            if (!genRes) {
+                throw new Error(`Error generating markdown file for flow ${flowFile}`);
+            }
+            diffMdFiles.push({
+                initialVersion: true,
+                commitAfter: commitAfter,
+                markdown: fs.readFileSync(diffMdFileTmp, "utf8")
+            });
+        }
+        else {
+            const commitBefore = fileHistory.all[i + 1];
+            const genDiffRes = await generateFlowVisualGitDiff(flowFile, commitBefore.hash, commitAfter.hash, { svgMd: false, mermaidMd: true, debug: debugMode });
+            if (genDiffRes.hasFlowDiffs && fs.existsSync(genDiffRes.outputDiffMdFile)) {
+                diffMdFiles.push({
+                    commitBefore: commitBefore,
+                    commitAfter: commitAfter,
+                    markdown: fs.readFileSync(genDiffRes.outputDiffMdFile, "utf8")
+                });
+            }
+            else {
+                uxLog(this, c.yellow(`No real flow diff has been found between ${commitBefore.hash} and ${commitAfter.hash}`));
+            }
+        }
+    }
+    // Set all the results in a single tabbed markdown
+    uxLog(this, c.cyan(`Aggregating results in summary tabbed file ${diffMdFile}...`));
+    let finalMd = `# ${flowLabel} history\n\n`;
+    for (const diffMdFile of diffMdFiles) {
+        finalMd += `=== "${moment(diffMdFile.commitAfter.date).format("ll")}` + (diffMdFile.initialVersion ? " (Initial)" : "") + `"\n\n`;
+        finalMd += `    _${moment(diffMdFile.commitAfter.date).format("ll")}, by ${diffMdFile.commitAfter.author_name} in commit ${diffMdFile.commitAfter.message}_\n\n`;
+        // Remove title and add indentation for tabs to be displayed
+        finalMd += diffMdFile.markdown.split("\n").filter(line => !line.startsWith("# ")).map(line => `    ${line}`).join("\n");
+        finalMd += "\n\n";
+    }
+    await fs.writeFile(diffMdFile, finalMd);
+    if (debugMode) {
+        await fs.copyFile(diffMdFile, diffMdFile.replace(".md", ".mermaid.md"));
+    }
+    const genSvgRes = await generateMarkdownFileWithMermaid(diffMdFile);
+    if (!genSvgRes) {
+        throw new Error("Error generating mermaid markdown file");
+    }
+    // Fix indentation for mermaid SVG links
+    const diffMarkdown = await fs.readFile(diffMdFile, "utf8");
+    const diffMarkdownFixed = diffMarkdown.split("\n").map(line => {
+        if (line.startsWith("![diagram]")) {
+            return `    ${line}`;
+        }
+        return line;
+    }).join("\n");
+    await fs.writeFile(diffMdFile, diffMarkdownFixed);
+    // Add link to main flow doc 
+    const mainFlowDoc = path.join("docs", "flows", path.basename(flowFile).replace(".flow-meta.xml", ".md"));
+    if (fs.existsSync(mainFlowDoc)) {
+        const mainFlowDocContent = await fs.readFile(mainFlowDoc, "utf8");
+        const mainFlowDocLink = `[_View History_](${path.basename(flowFile).replace(".flow-meta.xml", "-history.md")})`;
+        if (!mainFlowDocContent.includes(mainFlowDocLink)) {
+            let replaced = false;
+            const updatedFlowDocContent = mainFlowDocContent.split("\n").map(line => {
+                if (line.startsWith("![") && replaced === false) {
+                    replaced = true;
+                    return `${line}\n\n ${mainFlowDocLink}\n`;
+                }
+                return line;
+            }).join("\n");
+            await fs.writeFile(mainFlowDoc, updatedFlowDocContent);
+        }
+    }
+    uxLog(this, c.green(`Markdown diff between ${fileHistory.all.length} Flow states generated in ${diffMdFile}`));
+    return diffMdFile;
+}
 //# sourceMappingURL=mermaidUtils.js.map