sfdx-hardis 5.24.3 → 5.25.1

package/CHANGELOG.md

@@ -4,6 +4,16 @@
 
 Note: Can be used with `sfdx plugins:install sfdx-hardis@beta` and docker image `hardisgroupcom/sfdx-hardis@beta`
 
+## [5.25.1] 2025-04-08
+
+- [hardis:doc:project2markdown](https://sfdx-hardis.cloudity.com/hardis/doc/project2markdown/): Fix typo for Object description prompt
+
+## [5.25.0] 2025-04-06
+
+- [hardis:doc:project2markdown](https://sfdx-hardis.cloudity.com/hardis/doc/project2markdown/): Add profile documentation generated by AI
+- Refactor document generation code
+- GitHub Integration: Use ENV variables as fallback [in case the job runner is not GitHub Actions](https://sfdx-hardis.cloudity.com/salesforce-ci-cd-setup-integration-github/#using-github-integration-without-github-actions), like Codefresh
+
 ## [5.24.3] 2025-04-04
 
 - Fix visualization of [Azure DevOps](https://sfdx-hardis.cloudity.com/salesforce-ci-cd-setup-integration-azure/#azure-pull-request-notes) images by linking attachments to a generic work item.

package/lib/commands/hardis/doc/packagexml2markdown.js

@@ -2,7 +2,7 @@
 import { SfCommand, Flags, optionalOrgFlagWithDeprecations } from '@salesforce/sf-plugins-core';
 import { Messages } from '@salesforce/core';
 import { WebSocketClient } from '../../../common/websocketClient.js';
-import { generatePackageXmlMarkdown } from '../../../common/docBuilder/docUtils.js';
+import { DocBuilderPackageXML } from '../../../common/docBuilder/docBuilderPackageXml.js';
 Messages.importMessagesDirectoryFromMetaUrl(import.meta.url);
 const messages = Messages.loadMessages('sfdx-hardis', 'org');
 export default class PackageXml2Markdown extends SfCommand {
@@ -47,7 +47,7 @@ export default class PackageXml2Markdown extends SfCommand {
         this.debugMode = flags.debug || false;
         // Generate markdown for package.xml
         const instanceUrl = flags?.['target-org']?.getConnection()?.instanceUrl;
-        this.outputFile = await generatePackageXmlMarkdown(this.inputFile, this.outputFile, null, instanceUrl);
+        this.outputFile = await DocBuilderPackageXML.generatePackageXmlMarkdown(this.inputFile, this.outputFile, null, instanceUrl);
         // Open file in a new VsCode tab if available
         WebSocketClient.requestOpenFile(this.outputFile);
         // Return an object to be displayed with --json

package/lib/commands/hardis/doc/packagexml2markdown.js.map

@@ -1 +1 @@
-{"version":3,"file":"packagexml2markdown.js","sourceRoot":"","sources":["../../../../src/commands/hardis/doc/packagexml2markdown.ts"],"names":[],"mappings":"AAAA,wBAAwB;AACxB,OAAO,EAAE,SAAS,EAAE,KAAK,EAAE,+BAA+B,EAAE,MAAM,6BAA6B,CAAC;AAChG,OAAO,EAAE,QAAQ,EAAE,MAAM,kBAAkB,CAAC;AAE5C,OAAO,EAAE,eAAe,EAAE,MAAM,oCAAoC,CAAC;AACrE,OAAO,EAAE,0BAA0B,EAAE,MAAM,wCAAwC,CAAC;AAEpF,QAAQ,CAAC,kCAAkC,CAAC,MAAM,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;AAC7D,MAAM,QAAQ,GAAG,QAAQ,CAAC,YAAY,CAAC,aAAa,EAAE,KAAK,CAAC,CAAC;AAE7D,MAAM,CAAC,OAAO,OAAO,mBAAoB,SAAQ,SAAc;IACtD,MAAM,CAAC,KAAK,GAAG,wBAAwB,CAAC;IAExC,MAAM,CAAC,WAAW,GAAG,4DAA4D,CAAC;IAElF,MAAM,CAAC,QAAQ,GAAG;QACvB,qCAAqC;QACrC,0EAA0E;KAC3E,CAAC;IAEK,MAAM,CAAC,KAAK,GAAQ;QACzB,SAAS,EAAE,KAAK,CAAC,MAAM,CAAC;YACtB,IAAI,EAAE,GAAG;YACT,WAAW,EAAE,sFAAsF;SACpG,CAAC;QACF,UAAU,EAAE,KAAK,CAAC,MAAM,CAAC;YACvB,IAAI,EAAE,GAAG;YACT,WAAW,EAAE,kEAAkE;SAChF,CAAC;QACF,KAAK,EAAE,KAAK,CAAC,OAAO,CAAC;YACnB,IAAI,EAAE,GAAG;YACT,OAAO,EAAE,KAAK;YACd,WAAW,EAAE,QAAQ,CAAC,UAAU,CAAC,WAAW,CAAC;SAC9C,CAAC;QACF,SAAS,EAAE,KAAK,CAAC,MAAM,CAAC;YACtB,WAAW,EAAE,QAAQ,CAAC,UAAU,CAAC,WAAW,CAAC;SAC9C,CAAC;QACF,QAAQ,EAAE,KAAK,CAAC,OAAO,CAAC;YACtB,WAAW,EAAE,+DAA+D;SAC7E,CAAC;QACF,YAAY,EAAE,+BAA+B;KAC9C,CAAC;IAEF,uGAAuG;IAChG,MAAM,CAAC,eAAe,GAAG,KAAK,CAAC;IAE5B,SAAS,CAAC;IACV,UAAU,CAAC;IACX,SAAS,GAAG,KAAK,CAAC;IAC5B,sBAAsB;IAEf,KAAK,CAAC,GAAG;QACd,MAAM,EAAE,KAAK,EAAE,GAAG,MAAM,IAAI,CAAC,KAAK,CAAC,mBAAmB,CAAC,CAAC;QACxD,IAAI,CAAC,SAAS,GAAG,KAAK,CAAC,SAAS,IAAI,IAAI,CAAC;QACzC,IAAI,CAAC,UAAU,GAAG,KAAK,CAAC,UAAU,IAAI,IAAI,CAAC;QAC3C,IAAI,CAAC,SAAS,GAAG,KAAK,CAAC,KAAK,IAAI,KAAK,CAAC;QAEtC,oCAAoC;QACpC,MAAM,WAAW,GAAG,KAAK,EAAE,CAAC,YAAY,CAAC,EAAE,aAAa,EAAE,EAAE,WAAW,CAAC;QACxE,IAAI,CAAC,UAAU,GAAG,MAAM,0BAA0B,CAAC,IAAI,CAAC,SAAS,EAAE,IAAI,CAAC,UAAU,EAAE,IAAI,EAAE,WAAW,CAAC,CAAC;QAEvG,6CAA6C;QAC7C,eAAe,CAAC,eAAe,CAAC,IAAI,CAAC,UAAU,CAAC,CAAC;QAEjD,+CAA+C;QAC/C,OAAO,EAAE,UAAU,EAAE,IAAI,CAAC,UAAU,EAAE,CAAC;IACzC,CAAC"}
+{"version":3,"file":"packagexml2markdown.js","sourceRoot":"","sources":["../../../../src/commands/hardis/doc/packagexml2markdown.ts"],"names":[],"mappings":"AAAA,wBAAwB;AACxB,OAAO,EAAE,SAAS,EAAE,KAAK,EAAE,+BAA+B,EAAE,MAAM,6BAA6B,CAAC;AAChG,OAAO,EAAE,QAAQ,EAAE,MAAM,kBAAkB,CAAC;AAE5C,OAAO,EAAE,eAAe,EAAE,MAAM,oCAAoC,CAAC;AACrE,OAAO,EAAE,oBAAoB,EAAE,MAAM,oDAAoD,CAAC;AAE1F,QAAQ,CAAC,kCAAkC,CAAC,MAAM,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;AAC7D,MAAM,QAAQ,GAAG,QAAQ,CAAC,YAAY,CAAC,aAAa,EAAE,KAAK,CAAC,CAAC;AAE7D,MAAM,CAAC,OAAO,OAAO,mBAAoB,SAAQ,SAAc;IACtD,MAAM,CAAC,KAAK,GAAG,wBAAwB,CAAC;IAExC,MAAM,CAAC,WAAW,GAAG,4DAA4D,CAAC;IAElF,MAAM,CAAC,QAAQ,GAAG;QACvB,qCAAqC;QACrC,0EAA0E;KAC3E,CAAC;IAEK,MAAM,CAAC,KAAK,GAAQ;QACzB,SAAS,EAAE,KAAK,CAAC,MAAM,CAAC;YACtB,IAAI,EAAE,GAAG;YACT,WAAW,EAAE,sFAAsF;SACpG,CAAC;QACF,UAAU,EAAE,KAAK,CAAC,MAAM,CAAC;YACvB,IAAI,EAAE,GAAG;YACT,WAAW,EAAE,kEAAkE;SAChF,CAAC;QACF,KAAK,EAAE,KAAK,CAAC,OAAO,CAAC;YACnB,IAAI,EAAE,GAAG;YACT,OAAO,EAAE,KAAK;YACd,WAAW,EAAE,QAAQ,CAAC,UAAU,CAAC,WAAW,CAAC;SAC9C,CAAC;QACF,SAAS,EAAE,KAAK,CAAC,MAAM,CAAC;YACtB,WAAW,EAAE,QAAQ,CAAC,UAAU,CAAC,WAAW,CAAC;SAC9C,CAAC;QACF,QAAQ,EAAE,KAAK,CAAC,OAAO,CAAC;YACtB,WAAW,EAAE,+DAA+D;SAC7E,CAAC;QACF,YAAY,EAAE,+BAA+B;KAC9C,CAAC;IAEF,uGAAuG;IAChG,MAAM,CAAC,eAAe,GAAG,KAAK,CAAC;IAE5B,SAAS,CAAC;IACV,UAAU,CAAC;IACX,SAAS,GAAG,KAAK,CAAC;IAC5B,sBAAsB;IAEf,KAAK,CAAC,GAAG;QACd,MAAM,EAAE,KAAK,EAAE,GAAG,MAAM,IAAI,CAAC,KAAK,CAAC,mBAAmB,CAAC,CAAC;QACxD,IAAI,CAAC,SAAS,GAAG,KAAK,CAAC,SAAS,IAAI,IAAI,CAAC;QACzC,IAAI,CAAC,UAAU,GAAG,KAAK,CAAC,UAAU,IAAI,IAAI,CAAC;QAC3C,IAAI,CAAC,SAAS,GAAG,KAAK,CAAC,KAAK,IAAI,KAAK,CAAC;QAEtC,oCAAoC;QACpC,MAAM,WAAW,GAAG,KAAK,EAAE,CAAC,YAAY,CAAC,EAAE,aAAa,EAAE,EAAE,WAAW,CAAC;QACxE,IAAI,CAAC,UAAU,GAAG,MAAM,oBAAoB,CAAC,0BAA0B,CAAC,IAAI,CAAC,SAAS,EAAE,IAAI,CAAC,UAAU,EAAE,IAAI,EAAE,WAAW,CAAC,CAAC;QAE5H,6CAA6C;QAC7C,eAAe,CAAC,eAAe,CAAC,IAAI,CAAC,UAAU,CAAC,CAAC;QAEjD,+CAA+C;QAC/C,OAAO,EAAE,UAAU,EAAE,IAAI,CAAC,UAAU,EAAE,CAAC;IACzC,CAAC"}

package/lib/commands/hardis/doc/project2markdown.d.ts

@@ -22,6 +22,7 @@ export default class Project2Markdown extends SfCommand<any> {
     protected apexDescriptions: any[];
     protected flowDescriptions: any[];
     protected pageDescriptions: any[];
+    protected profileDescriptions: any[];
     protected objectDescriptions: any[];
     protected objectFiles: string[];
     protected allObjectsNames: string[];
@@ -29,24 +30,17 @@ export default class Project2Markdown extends SfCommand<any> {
     run(): Promise<AnyJson>;
     private generateApexDocumentation;
     private generatePagesDocumentation;
+    private generateAuthorizationsDocumentation;
     private buildMkDocsYml;
     private generateObjectsDocumentation;
     private buildAttributesTables;
     private generateLinksInfo;
     private generateFlowsDocumentation;
     private humanDisplay;
-    private buildFlowsTable;
-    private buildObjectsTable;
-    private buildApexTable;
-    private buildPagesTable;
-    private buildCustomFieldsTable;
-    private buildValidationRulesTable;
     private buildInstalledPackages;
     private buildSfdxHardisParams;
     private buildMajorBranchesAndOrgs;
     private manageLocalPackages;
-    private buildPackagesIndex;
     private addNavNode;
     private generatePackageXmlMarkdown;
-    private listPackageXmlCandidates;
 }

package/lib/commands/hardis/doc/project2markdown.js

@@ -8,8 +8,8 @@ import { XMLParser } from "fast-xml-parser";
 import sortArray from 'sort-array';
 import { Messages } from '@salesforce/core';
 import { WebSocketClient } from '../../../common/websocketClient.js';
-import { completeApexDocWithAiDescription, completeAttributesDescriptionWithAi, generateLightningPageMarkdown, generateObjectMarkdown, generatePackageXmlMarkdown, getMetaHideLines, readMkDocsFile, replaceInFile, writeMkDocsFile } from '../../../common/docBuilder/docUtils.js';
-import { countPackageXmlItems, parseXmlFile } from '../../../common/utils/xmlUtils.js';
+import { completeAttributesDescriptionWithAi, getMetaHideLines, readMkDocsFile, replaceInFile, writeMkDocsFile } from '../../../common/docBuilder/docUtils.js';
+import { parseXmlFile } from '../../../common/utils/xmlUtils.js';
 import { bool2emoji, createTempDir, execCommand, execSfdxJson, getCurrentGitBranch, uxLog } from '../../../common/utils/index.js';
 import { CONSTANTS, getConfig } from '../../../config/index.js';
 import { listMajorOrgs } from '../../../common/utils/orgConfigUtils.js';
@@ -19,10 +19,15 @@ import { generateFlowMarkdownFile, generateHistoryDiffMarkdown, generateMarkdown
 import { MetadataUtils } from '../../../common/metadata-utils/index.js';
 import { PACKAGE_ROOT_DIR } from '../../../settings.js';
 import { BranchStrategyMermaidBuilder } from '../../../common/utils/branchStrategyMermaidBuilder.js';
-import { mdTableCell } from '../../../common/gitProvider/utilsMarkdown.js';
 import { prettifyFieldName } from '../../../common/utils/flowVisualiser/nodeFormatUtils.js';
 import { ObjectModelBuilder } from '../../../common/docBuilder/objectModelBuilder.js';
 import { generatePdfFileFromMarkdown } from '../../../common/utils/markdownUtils.js';
+import { DocBuilderPage } from '../../../common/docBuilder/docBuilderPage.js';
+import { DocBuilderProfile } from '../../../common/docBuilder/docBuilderProfile.js';
+import { DocBuilderObject } from '../../../common/docBuilder/docBuilderObject.js';
+import { DocBuilderApex } from '../../../common/docBuilder/docBuilderApex.js';
+import { DocBuilderFlow } from '../../../common/docBuilder/docBuilderFlow.js';
+import { DocBuilderPackageXML } from '../../../common/docBuilder/docBuilderPackageXml.js';
 Messages.importMessagesDirectoryFromMetaUrl(import.meta.url);
 const messages = Messages.loadMessages('sfdx-hardis', 'org');
 export default class Project2Markdown extends SfCommand {
@@ -139,6 +144,7 @@ ${this.htmlInstructions}
     apexDescriptions = [];
     flowDescriptions = [];
     pageDescriptions = [];
+    profileDescriptions = [];
     objectDescriptions = [];
     objectFiles;
     allObjectsNames;
@@ -161,6 +167,7 @@ ${this.htmlInstructions}
             "- [Objects](objects/index.md)",
             "- [Flows](flows/index.md)",
             "- [Apex](apex/index.md)",
+            "- [Profiles](profiles/index.md)",
             "- [Lightning Pages](pages/index.md)",
             "- [SFDX-Hardis Config](sfdx-hardis-params.md)",
             "- [Branches & Orgs](sfdx-hardis-branches-and-orgs.md)",
@@ -189,11 +196,12 @@ ${this.htmlInstructions}
         this.addNavNode("Object Model", "object-model.md");
         */
         // List SFDX packages and generate a manifest for each of them, except if there is only force-app with a package.xml
-        this.packageXmlCandidates = this.listPackageXmlCandidates();
+        this.packageXmlCandidates = DocBuilderPackageXML.listPackageXmlCandidates();
         await this.manageLocalPackages();
         const instanceUrl = flags?.['target-org']?.getConnection()?.instanceUrl;
         await this.generatePackageXmlMarkdown(this.packageXmlCandidates, instanceUrl);
-        const packageLines = await this.buildPackagesIndex();
+        const { packageLines, packagesForMenu } = await DocBuilderPackageXML.buildIndexTable(this.outputPackageXmlMarkdownFiles);
+        this.addNavNode("Manifests", packagesForMenu);
         await fs.writeFile(path.join(this.outputMarkdownRoot, "manifests.md"), getMetaHideLines() + packageLines.join("\n") + `\n${this.footer}\n`);
         // List managed packages
         const installedPackages = await this.buildInstalledPackages();
@@ -212,14 +220,18 @@ ${this.htmlInstructions}
         if (!(process?.env?.GENERATE_FLOW_DOC === 'false')) {
             await this.generateFlowsDocumentation();
         }
-        // List flows & generate doc
+        // List pages & generate doc
         if (!(process?.env?.GENERATE_PAGES_DOC === 'false')) {
             await this.generatePagesDocumentation();
         }
-        // List flows & generate doc
+        // List objects & generate doc
         if (!(process?.env?.GENERATE_OBJECTS_DOC === 'false')) {
             await this.generateObjectsDocumentation();
         }
+        // List profiles & generate doc
+        if (!(process?.env?.GENERATE_PROFILES_DOC === 'false')) {
+            await this.generateAuthorizationsDocumentation();
+        }
         // Write output index file
         await fs.ensureDir(path.dirname(this.outputMarkdownIndexFile));
         await fs.writeFile(this.outputMarkdownIndexFile, getMetaHideLines() + this.mdLines.join("\n") + `\n\n${this.footer}\n`);
@@ -296,10 +308,15 @@ ${Project2Markdown.htmlInstructions}
                 apexMdContent = apexMdContent.replaceAll("..\\custom-objects\\", "../objects/").replaceAll("../custom-objects/", "../objects/");
                 // Add text before the first ##
                 if (!["MetadataService"].includes(apexName)) {
-                    const insertion = `## AI-Generated description\n\n<!-- Apex description -->\n\n## Apex Code\n\n\`\`\`java\n${apexContent}\n\`\`\`\n\n`;
+                    const insertion = `<!-- Apex description -->\n\n## Apex Code\n\n\`\`\`java\n${apexContent}\n\`\`\`\n\n`;
                     const firstHeading = apexMdContent.indexOf("## ");
                     apexMdContent = apexMdContent.substring(0, firstHeading) + insertion + apexMdContent.substring(firstHeading);
-                    apexMdContent = await completeApexDocWithAiDescription(apexMdContent, apexName, apexContent);
+                    const apexDocBuilder = new DocBuilderApex(apexName, apexContent, "", {
+                        "CLASS_NAME": apexName,
+                        "APEX_CODE": apexContent
+                    });
+                    apexDocBuilder.markdownDoc = apexMdContent;
+                    apexMdContent = await apexDocBuilder.completeDocWithAiDescription();
                     await fs.writeFile(mdFile, getMetaHideLines() + apexMdContent);
                 }
                 uxLog(this, c.grey(`Generated markdown for Apex class ${apexName}`));
@@ -312,7 +329,7 @@ ${Project2Markdown.htmlInstructions}
         // Write index file for apex folder
         await fs.ensureDir(path.join(this.outputMarkdownRoot, "apex"));
         const apexIndexFile = path.join(this.outputMarkdownRoot, "apex", "index.md");
-        await fs.writeFile(apexIndexFile, getMetaHideLines() + this.buildApexTable('').join("\n") + `\n\n${this.footer}\n`);
+        await fs.writeFile(apexIndexFile, getMetaHideLines() + DocBuilderApex.buildIndexTable('', this.apexDescriptions).join("\n") + `\n\n${this.footer}\n`);
     }
     async generatePagesDocumentation() {
         const packageDirs = this.project?.getPackageDirectories() || [];
@@ -330,7 +347,7 @@ ${Project2Markdown.htmlInstructions}
                 type: prettifyFieldName(pageXmlParsed?.FlexiPage?.type || "Unknown"),
                 impactedObjects: this.allObjectsNames.filter(objectName => pageXml.includes(`${objectName}`)).join(", ")
             });
-            await generateLightningPageMarkdown(pageName, pageXml, mdFile);
+            await new DocBuilderPage(pageName, pageXml, mdFile).generateMarkdownFileFromXml();
             if (this.withPdf) {
                 await generatePdfFileFromMarkdown(mdFile);
             }
@@ -339,7 +356,34 @@ ${Project2Markdown.htmlInstructions}
         // Write index file for apex folder
         await fs.ensureDir(path.join(this.outputMarkdownRoot, "pages"));
         const pagesIndexFile = path.join(this.outputMarkdownRoot, "pages", "index.md");
-        await fs.writeFile(pagesIndexFile, getMetaHideLines() + this.buildPagesTable('').join("\n") + `\n\n${this.footer}\n`);
+        await fs.writeFile(pagesIndexFile, getMetaHideLines() + DocBuilderPage.buildIndexTable('', this.pageDescriptions).join("\n") + `\n\n${this.footer}\n`);
+    }
+    async generateAuthorizationsDocumentation() {
+        uxLog(this, c.cyan("Generating Authorizations documentation... (if you don't want it, define GENERATE_PROFILES_DOC=false in your environment variables)"));
+        const profilesForMenu = { "All Profiles": "profiles/index.md" };
+        const profilesFiles = (await glob("**/profiles/**.profile-meta.xml", { cwd: process.cwd(), ignore: GLOB_IGNORE_PATTERNS })).sort();
+        for (const profileFile of profilesFiles) {
+            const profileName = path.basename(profileFile, ".profile-meta.xml");
+            const mdFile = path.join(this.outputMarkdownRoot, "profiles", profileName + ".md");
+            profilesForMenu[profileName] = "profiles/" + profileName + ".md";
+            const profileXml = await fs.readFile(profileFile, "utf8");
+            const profileXmlParsed = new XMLParser().parse(profileXml);
+            this.profileDescriptions.push({
+                name: profileName,
+                userLicense: prettifyFieldName(profileXmlParsed?.Profile?.userLicense || "Unknown"),
+                impactedObjects: this.allObjectsNames.filter(objectName => profileXml.includes(`${objectName}`)).join(", ")
+            });
+            // Add apex code in documentation
+            await new DocBuilderProfile(profileName, profileXml, mdFile).generateMarkdownFileFromXml();
+            if (this.withPdf) {
+                await generatePdfFileFromMarkdown(mdFile);
+            }
+        }
+        this.addNavNode("Profiles", profilesForMenu);
+        // Write index file for profiles folder
+        await fs.ensureDir(path.join(this.outputMarkdownRoot, "profiles"));
+        const profilesIndexFile = path.join(this.outputMarkdownRoot, "profiles", "index.md");
+        await fs.writeFile(profilesIndexFile, getMetaHideLines() + DocBuilderProfile.buildIndexTable('', this.profileDescriptions).join("\n") + `\n\n${this.footer}\n`);
     }
     async buildMkDocsYml() {
         // Copy default files (mkdocs.yml and other files can be updated by the SF Cli plugin developer later)
@@ -388,7 +432,7 @@ ${Project2Markdown.htmlInstructions}
         // Remove deprecated Flows History if found
         mkdocsYml.nav = mkdocsYml.nav.filter(navItem => !navItem["Flows History"]);
         // Order nav items with this elements in first
-        const firstItemsInOrder = ["Home", "Object Model", "Objects", "Flows", "Apex", "Lightning Pages", "SFDX-Hardis Config", "Branches & Orgs", "Installed Packages", "Manifests"];
+        const firstItemsInOrder = ["Home", "Object Model", "Objects", "Flows", "Apex", "Profiles", "Lightning Pages", "SFDX-Hardis Config", "Branches & Orgs", "Installed Packages", "Manifests"];
         mkdocsYml.nav = firstItemsInOrder.map(item => mkdocsYml.nav.find(navItem => Object.keys(navItem)[0] === item)).filter(item => item).concat(mkdocsYml.nav.filter(navItem => !firstItemsInOrder.includes(Object.keys(navItem)[0])));
         // Update mkdocs file
         await writeMkDocsFile(mkdocsYmlFile, mkdocsYml);
@@ -411,7 +455,10 @@ ${Project2Markdown.htmlInstructions}
             // Build filtered XML
             const objectXmlParsed = new XMLParser().parse(objectXml);
             // Main AI markdown
-            await generateObjectMarkdown(objectName, objectXml, this.allObjectsNames.join(","), objectLinksInfo, objectMdFile);
+            await new DocBuilderObject(objectName, objectXml, objectMdFile, {
+                "ALL_OBJECTS_LIST": this.allObjectsNames.join(","),
+                "ALL_OBJECT_LINKS": objectLinksInfo
+            }).generateMarkdownFileFromXml();
             // Fields table
             await this.buildAttributesTables(objectName, objectXmlParsed, objectMdFile);
             // Mermaid schema
@@ -422,11 +469,11 @@ ${Project2Markdown.htmlInstructions}
                 await generateMarkdownFileWithMermaid(objectMdFile, objectMdFile, null, true);
             }
             // Flows Tables
-            const relatedObjectFlowsTable = await this.buildFlowsTable('../flows/', objectName);
+            const relatedObjectFlowsTable = DocBuilderFlow.buildIndexTable('../flows/', this.flowDescriptions, this.outputMarkdownRoot, objectName);
             await replaceInFile(objectMdFile, '<!-- Flows table -->', relatedObjectFlowsTable.join("\n"));
-            const relatedApexTable = this.buildApexTable('../apex/', objectName);
+            const relatedApexTable = DocBuilderApex.buildIndexTable('../apex/', this.apexDescriptions, objectName);
             await replaceInFile(objectMdFile, '<!-- Apex table -->', relatedApexTable.join("\n"));
-            const relatedPages = this.buildPagesTable('../pages/', objectName);
+            const relatedPages = DocBuilderPage.buildIndexTable('../pages/', this.pageDescriptions, objectName);
             await replaceInFile(objectMdFile, '<!-- Pages table -->', relatedPages.join("\n"));
             this.objectDescriptions.push({
                 name: objectName,
@@ -441,13 +488,13 @@ ${Project2Markdown.htmlInstructions}
         this.addNavNode("Objects", objectsForMenu);
         // Write index file for objects folder
         await fs.ensureDir(path.join(this.outputMarkdownRoot, "objects"));
-        const objectsTableLinesForIndex = await this.buildObjectsTable('');
+        const objectsTableLinesForIndex = DocBuilderObject.buildIndexTable('', this.objectDescriptions);
         const objectsIndexFile = path.join(this.outputMarkdownRoot, "objects", "index.md");
         await fs.writeFile(objectsIndexFile, getMetaHideLines() + objectsTableLinesForIndex.join("\n") + `\n${this.footer}\n`);
     }
     async buildAttributesTables(objectName, objectXmlParsed, objectMdFile) {
-        const fieldsTable = await this.buildCustomFieldsTable(objectXmlParsed?.CustomObject?.fields || []);
-        const validationRulesTable = await this.buildValidationRulesTable(objectXmlParsed?.CustomObject?.validationRules || []);
+        const fieldsTable = DocBuilderObject.buildCustomFieldsTable(objectXmlParsed?.CustomObject?.fields || []);
+        const validationRulesTable = DocBuilderObject.buildValidationRulesTable(objectXmlParsed?.CustomObject?.validationRules || []);
         const attributesLines = [...fieldsTable, ...validationRulesTable];
         const attributesMarkdown = await completeAttributesDescriptionWithAi(attributesLines.join("\n"), objectName);
         await replaceInFile(objectMdFile, '<!-- Attributes tables -->', attributesMarkdown);
@@ -555,7 +602,7 @@ ${Project2Markdown.htmlInstructions}
         }
         // Write index file for flow folder
         await fs.ensureDir(path.join(this.outputMarkdownRoot, "flows"));
-        const flowTableLinesForIndex = await this.buildFlowsTable('');
+        const flowTableLinesForIndex = DocBuilderFlow.buildIndexTable('', this.flowDescriptions, this.outputMarkdownRoot);
         const flowIndexFile = path.join(this.outputMarkdownRoot, "flows", "index.md");
         await fs.writeFile(flowIndexFile, getMetaHideLines() + flowTableLinesForIndex.join("\n") + `\n${this.footer}\n`);
         this.addNavNode("Flows", flowsForMenu);
@@ -564,133 +611,6 @@ ${Project2Markdown.htmlInstructions}
     humanDisplay(flows) {
         return flows.map(flow => path.basename(flow, ".flow-meta.xml")).join(", ");
     }
-    async buildFlowsTable(prefix, filterObject = null) {
-        const filteredFlows = filterObject ? this.flowDescriptions.filter(flow => flow.object === filterObject || flow.impactedObjects.includes(filterObject)) : this.flowDescriptions;
-        if (filteredFlows.length === 0) {
-            return [];
-        }
-        const lines = [];
-        lines.push(...[
-            filterObject ? "## Related Flows" : "## Flows",
-            "",
-            "| Object | Name      | Type | Description |",
-            "| :----  | :-------- | :--: | :---------- | "
-        ]);
-        for (const flow of filteredFlows) {
-            const outputFlowHistoryMdFile = path.join(this.outputMarkdownRoot, "flows", flow.name + "-history.md");
-            const flowNameCell = fs.existsSync(outputFlowHistoryMdFile) ?
-                `[${flow.name}](${prefix}${flow.name}.md) [🕒](${prefix}${flow.name}-history.md)` :
-                `[${flow.name}](${prefix}${flow.name}.md)`;
-            lines.push(...[
-                `| ${flow.object || "💻"} | ${flowNameCell} | ${prettifyFieldName(flow.type)} | ${mdTableCell(flow.description)} |`
-            ]);
-        }
-        lines.push("");
-        return lines;
-    }
-    async buildObjectsTable(prefix) {
-        const lines = [];
-        lines.push(...[
-            "## Objects",
-            "",
-            "| Name      | Label | Description |",
-            "| :-------- | :---- | :---------- | "
-        ]);
-        for (const objectDescription of this.objectDescriptions) {
-            const objectNameCell = `[${objectDescription.name}](${prefix}${objectDescription.name}.md)`;
-            lines.push(...[
-                `| ${objectNameCell} | ${objectDescription.label || ""} | ${mdTableCell(objectDescription.description)} |`
-            ]);
-        }
-        lines.push("");
-        return lines;
-    }
-    buildApexTable(prefix, filterObject = null) {
-        const filteredApex = filterObject ? this.apexDescriptions.filter(apex => apex.impactedObjects.includes(filterObject)) : this.apexDescriptions;
-        if (filteredApex.length === 0) {
-            return [];
-        }
-        const lines = [];
-        lines.push(...[
-            filterObject ? "## Related Apex Classes" : "## Apex Classes",
-            "",
-            "| Apex Class | Type |",
-            "| :----      | :--: | "
-        ]);
-        for (const apex of filteredApex) {
-            const flowNameCell = `[${apex.name}](${prefix}${apex.name}.md)`;
-            lines.push(...[
-                `| ${flowNameCell} | ${apex.type} |`
-            ]);
-        }
-        lines.push("");
-        return lines;
-    }
-    buildPagesTable(prefix, filterObject = null) {
-        const filteredPages = filterObject ? this.pageDescriptions.filter(page => page.impactedObjects.includes(filterObject)) : this.pageDescriptions;
-        if (filteredPages.length === 0) {
-            return [];
-        }
-        const lines = [];
-        lines.push(...[
-            filterObject ? "## Related Lightning Pages" : "## Lightning Pages",
-            "",
-            "| Lightning Page | Type |",
-            "| :----      | :--: | "
-        ]);
-        for (const page of filteredPages) {
-            const pageNameCell = `[${page.name}](${prefix}${page.name}.md)`;
-            lines.push(...[
-                `| ${pageNameCell} | ${page.type} |`
-            ]);
-        }
-        lines.push("");
-        return lines;
-    }
-    async buildCustomFieldsTable(fields) {
-        if (!Array.isArray(fields)) {
-            fields = [fields];
-        }
-        if (fields.length === 0) {
-            return [];
-        }
-        const lines = [];
-        lines.push(...[
-            "## Fields",
-            "",
-            "| Name      | Label | Type | Description |",
-            "| :-------- | :---- | :--: | :---------- | "
-        ]);
-        for (const field of fields) {
-            lines.push(...[
-                `| ${field.fullName} | ${field.label || ""} | ${field.type || ""} | ${mdTableCell(field.description)} |`
-            ]);
-        }
-        lines.push("");
-        return lines;
-    }
-    async buildValidationRulesTable(validationRules) {
-        if (!Array.isArray(validationRules)) {
-            validationRules = [validationRules];
-        }
-        if (validationRules.length === 0) {
-            return [];
-        }
-        const lines = [];
-        lines.push(...[
-            "## Validation Rules",
-            "",
-            "| Rule      | Active | Description | Formula |",
-            "| :-------- | :---- | :---------- | :------ |"
-        ]);
-        for (const rule of validationRules) {
-            lines.push(...[
-                `| ${rule.fullName} | ${rule.active ? "Yes" : "No ⚠️"} | ${rule.description || ""} | \`${rule.errorConditionFormula}\` |`
-            ]);
-        }
-        lines.push("");
-        return lines;
-    }
     async buildInstalledPackages() {
         // CI/CD context
         const packages = this.sfdxHardisConfig.installedPackages || [];
@@ -802,29 +722,6 @@ ${Project2Markdown.htmlInstructions}
             }
         }
     }
-    async buildPackagesIndex() {
-        const packageLines = [];
-        const packagesForMenu = { "All manifests": "manifests.md" };
-        packageLines.push(...[
-            "## Package XML files",
-            "",
-            "| Package name | Description |",
-            "| :----------- | :---------- |"
-        ]);
-        for (const outputPackageXmlDef of this.outputPackageXmlMarkdownFiles) {
-            const metadataNb = await countPackageXmlItems(outputPackageXmlDef.path);
-            const packageMdFile = path.basename(outputPackageXmlDef.path) + ".md";
-            const label = outputPackageXmlDef.name ? `Package folder: ${outputPackageXmlDef.name}` : path.basename(outputPackageXmlDef.path);
-            const packageTableLine = `| [${label}](${packageMdFile}) (${metadataNb}) | ${outputPackageXmlDef.description} |`;
-            packageLines.push(packageTableLine);
-            packagesForMenu[label] = packageMdFile;
-        }
-        packageLines.push("");
-        packageLines.push("___");
-        packageLines.push("");
-        this.addNavNode("Manifests", packagesForMenu);
-        return packageLines;
-    }
     addNavNode(nodeName, nodeValue) {
         const nodeIndex = this.mkDocsNavNodes.findIndex(navNode => Object.keys(navNode)[0] === nodeName);
         if (nodeIndex > -1) {
@@ -841,7 +738,7 @@ ${Project2Markdown.htmlInstructions}
         for (const packageXmlCandidate of packageXmlCandidates) {
             if (fs.existsSync(packageXmlCandidate.path)) {
                 // Generate markdown for package.xml
-                const packageMarkdownFile = await generatePackageXmlMarkdown(packageXmlCandidate.path, null, packageXmlCandidate, instanceUrl);
+                const packageMarkdownFile = await DocBuilderPackageXML.generatePackageXmlMarkdown(packageXmlCandidate.path, null, packageXmlCandidate, instanceUrl);
                 // Open file in a new VsCode tab if available
                 WebSocketClient.requestOpenFile(packageMarkdownFile);
                 packageXmlCandidate.markdownFile = packageMarkdownFile;
@@ -849,39 +746,5 @@ ${Project2Markdown.htmlInstructions}
             }
         }
     }
-    listPackageXmlCandidates() {
-        return [
-            // CI/CD package files
-            {
-                path: "manifest/package.xml",
-                description: "Contains all deployable metadatas of the SFDX project"
-            },
-            {
-                path: "manifest/packageDeployOnce.xml",
-                description: "Contains all metadatas that will never be overwritten during deployment if they are already existing in the target org"
-            },
-            {
-                path: "manifest/package-no-overwrite.xml",
-                description: "Contains all metadatas that will never be overwritten during deployment if they are already existing in the target org"
-            },
-            {
-                path: "manifest/destructiveChanges.xml",
-                description: "Contains all metadatas that will be deleted during deployment, in case they are existing in the target org"
-            },
-            // Monitoring package files
-            {
-                path: "manifest/package-all-org-items.xml",
-                description: "Contains the entire list of metadatas that are present in the monitored org (not all of them are in the git backup)"
-            },
-            {
-                path: "manifest/package-backup-items.xml",
-                description: "Contains the list of metadatas that are in the git backup"
-            },
-            {
-                path: "manifest/package-skip-items.xml",
-                description: "Contains the list of metadatas that are excluded from the backup.<br/>Other metadata types might be skipped using environment variable MONITORING_BACKUP_SKIP_METADATA_TYPES"
-            },
-        ];
-    }
 }
 //# sourceMappingURL=project2markdown.js.map