rflib-plugin 0.6.3 → 0.7.0

package/lib/commands/rflib/logging/flow/instrument.d.ts

@@ -0,0 +1,32 @@
+import { SfCommand } from '@salesforce/sf-plugins-core';
+export type RflibLoggingFlowInstrumentResult = {
+    processedFiles: number;
+    modifiedFiles: number;
+};
+export declare class FlowInstrumentationService {
+    private static readonly parser;
+    private static readonly builder;
+    static parseFlowContent(content: string): Promise<any>;
+    static buildFlowContent(flowObj: any): string;
+    static hasRFLIBLogger(flowObj: any): boolean;
+    static isFlowType(flowObj: any): boolean;
+    static instrumentFlow(flowObj: any, flowName: string): any;
+    private static generateUniqueId;
+    private static createLoggingAction;
+    private static enhanceLoggingWithVariables;
+}
+export default class RflibLoggingFlowInstrument extends SfCommand<RflibLoggingFlowInstrumentResult> {
+    static readonly summary: string;
+    static readonly description: string;
+    static readonly examples: string[];
+    static readonly flags: {
+        sourcepath: import("@oclif/core/interfaces").OptionFlag<string, import("@oclif/core/interfaces").CustomOptions>;
+        dryrun: import("@oclif/core/interfaces").BooleanFlag<boolean>;
+        'skip-instrumented': import("@oclif/core/interfaces").BooleanFlag<boolean>;
+    };
+    private logger;
+    private readonly stats;
+    run(): Promise<RflibLoggingFlowInstrumentResult>;
+    private processDirectory;
+    private instrumentFlowFile;
+}

package/lib/commands/rflib/logging/flow/instrument.js

@@ -0,0 +1,296 @@
+/* eslint-disable no-await-in-loop */
+/* eslint-disable @typescript-eslint/return-await */
+/* eslint-disable @typescript-eslint/no-explicit-any */
+/* eslint-disable @typescript-eslint/no-unsafe-call */
+/* eslint-disable @typescript-eslint/no-unsafe-assignment */
+/* eslint-disable @typescript-eslint/no-unsafe-return */
+/* eslint-disable @typescript-eslint/no-unsafe-member-access */
+import * as fs from 'node:fs';
+import * as path from 'node:path';
+import { SfCommand, Flags } from '@salesforce/sf-plugins-core';
+import { Messages, Logger } from '@salesforce/core';
+import * as xml2js from 'xml2js';
+Messages.importMessagesDirectoryFromMetaUrl(import.meta.url);
+const messages = Messages.loadMessages('rflib-plugin', 'rflib.logging.flow.instrument');
+// Type definition removed to fix compiler error
+// This was used to document valid Flow variable types: 'String' | 'Number' | 'Boolean' | 'SObject' | 'SObjectCollection'
+export class FlowInstrumentationService {
+    static parser = new xml2js.Parser({
+        explicitArray: false,
+        preserveChildrenOrder: true,
+        xmlns: false
+    });
+    static builder = new xml2js.Builder({
+        xmldec: { version: '1.0', encoding: 'UTF-8' },
+        cdata: true
+    });
+    static async parseFlowContent(content) {
+        try {
+            return await this.parser.parseStringPromise(content);
+        }
+        catch (error) {
+            if (error instanceof Error) {
+                throw new Error(`Flow parsing failed: ${error.message}`);
+            }
+            throw new Error('Flow parsing failed with unknown error');
+        }
+    }
+    static buildFlowContent(flowObj) {
+        try {
+            return this.builder.buildObject(flowObj);
+        }
+        catch (error) {
+            if (error instanceof Error) {
+                throw new Error(`Flow building failed: ${error.message}`);
+            }
+            throw new Error('Flow building failed with unknown error');
+        }
+    }
+    // Helper to check if flow already contains RFLIB logger
+    static hasRFLIBLogger(flowObj) {
+        if (!flowObj?.Flow?.actionCalls) {
+            return false;
+        }
+        const actionCalls = Array.isArray(flowObj.Flow.actionCalls)
+            ? flowObj.Flow.actionCalls
+            : [flowObj.Flow.actionCalls];
+        return actionCalls.some((action) => action.actionName === 'rflib:Logger' ||
+            action.actionName === 'rflib_LoggerFlowAction' ||
+            action.actionName === 'rflib_ApplicationEventLoggerAction' ||
+            (action.name && typeof action.name === 'string' && action.name.startsWith('RFLIB_Flow_Logger')));
+    }
+    // Helper to check if flow is of type "Flow" that we want to instrument
+    static isFlowType(flowObj) {
+        return flowObj?.Flow?.processType === 'Flow';
+    }
+    // Main instrumentation function
+    static instrumentFlow(flowObj, flowName) {
+        // Deep clone the object to avoid modifying the original
+        const instrumentedFlow = JSON.parse(JSON.stringify(flowObj));
+        // Skip if already instrumented
+        if (this.hasRFLIBLogger(instrumentedFlow)) {
+            return instrumentedFlow;
+        }
+        // Make sure Flow exists in the object
+        if (!instrumentedFlow.Flow) {
+            return instrumentedFlow;
+        }
+        // Create logging action element
+        let loggingAction = this.createLoggingAction(flowName);
+        // Add variables to the logging message if available
+        loggingAction = this.enhanceLoggingWithVariables(loggingAction, instrumentedFlow);
+        // Add logging action to actionCalls
+        if (!instrumentedFlow.Flow.actionCalls) {
+            instrumentedFlow.Flow.actionCalls = loggingAction;
+        }
+        else if (Array.isArray(instrumentedFlow.Flow.actionCalls)) {
+            instrumentedFlow.Flow.actionCalls.push(loggingAction);
+        }
+        else {
+            // If only one action exists, convert to array
+            instrumentedFlow.Flow.actionCalls = [instrumentedFlow.Flow.actionCalls, loggingAction];
+        }
+        // Find startElementReference and connect logger to it
+        if (instrumentedFlow.Flow.startElementReference) {
+            // Save the original start reference
+            const startNodeReference = instrumentedFlow.Flow.startElementReference;
+            // Create connector between logger and original start element
+            loggingAction.connector = {
+                targetReference: startNodeReference
+            };
+            // Update flow startElementReference to point to our logger
+            instrumentedFlow.Flow.startElementReference = loggingAction.name;
+        }
+        else {
+            // If no start element, try to find another entry point
+            // Common patterns: decisions, screens, or first element in the process
+            if (Array.isArray(instrumentedFlow.Flow.decisions) && instrumentedFlow.Flow.decisions.length > 0) {
+                // Find the first decision and connect to it
+                const firstDecision = instrumentedFlow.Flow.decisions[0];
+                loggingAction.connector = {
+                    targetReference: firstDecision.name
+                };
+            }
+            else if (Array.isArray(instrumentedFlow.Flow.screens) && instrumentedFlow.Flow.screens.length > 0) {
+                // Find the first screen and connect to it
+                const firstScreen = instrumentedFlow.Flow.screens[0];
+                loggingAction.connector = {
+                    targetReference: firstScreen.name
+                };
+            }
+            // Create a startElementReference pointing to our logger if none exists
+            instrumentedFlow.Flow.startElementReference = loggingAction.name;
+        }
+        // Add interviewLabel if not present
+        if (!instrumentedFlow.Flow.interviewLabel) {
+            instrumentedFlow.Flow.interviewLabel = `${flowName} {!$Flow.CurrentDateTime}`;
+        }
+        // Ensure processType is set to 'Flow'
+        instrumentedFlow.Flow.processType = 'Flow';
+        // Add variables if not present (needed for variable references)
+        if (!instrumentedFlow.Flow.variables) {
+            instrumentedFlow.Flow.variables = [];
+        }
+        else if (!Array.isArray(instrumentedFlow.Flow.variables)) {
+            instrumentedFlow.Flow.variables = [instrumentedFlow.Flow.variables];
+        }
+        return instrumentedFlow;
+    }
+    // Helper to generate unique IDs for new flow elements
+    static generateUniqueId() {
+        return `RFLIB_LOG_${Date.now().toString(36)}_${Math.random().toString(36).substring(2, 9)}`;
+    }
+    // Helper to create a logging action element
+    static createLoggingAction(flowName) {
+        const loggerId = this.generateUniqueId();
+        return {
+            actionName: 'rflib_LoggerFlowAction',
+            actionType: 'apex',
+            name: `RFLIB_Flow_Logger_${loggerId}`,
+            label: 'Log Flow Invocation',
+            locationX: 176,
+            locationY: 50,
+            inputParameters: [
+                {
+                    name: 'context',
+                    value: {
+                        stringValue: flowName,
+                    },
+                },
+                {
+                    name: 'logLevel',
+                    value: {
+                        stringValue: 'INFO',
+                    },
+                },
+                {
+                    name: 'message',
+                    value: {
+                        stringValue: `Flow ${flowName} started`,
+                    },
+                },
+            ],
+        };
+    }
+    // Helper to add variable references to the logging message when available
+    static enhanceLoggingWithVariables(loggingAction, flowObj) {
+        // Find input variables or parameters that might be useful to log
+        const variables = flowObj.Flow.variables || [];
+        const inputVariables = Array.isArray(variables)
+            ? variables.filter((v) => v.isInput === 'true' || v.isCollection === 'true')
+            : (variables.isInput === 'true' || variables.isCollection === 'true' ? [variables] : []);
+        if (inputVariables.length > 0) {
+            // Find the message parameter - case insensitive search
+            const messageParamIndex = loggingAction.inputParameters.findIndex((p) => p.name?.toLowerCase() === 'message');
+            if (messageParamIndex >= 0) {
+                // Enhance the message with variable information
+                const varRefs = inputVariables
+                    .map((v) => `${v.name}: {!${v.name}}`)
+                    .join(', ');
+                const baseMessage = loggingAction.inputParameters[messageParamIndex];
+                const originalMessage = baseMessage.value.stringValue;
+                baseMessage.value.stringValue = `${originalMessage} with ${varRefs}`;
+            }
+        }
+        return loggingAction;
+    }
+}
+export default class RflibLoggingFlowInstrument extends SfCommand {
+    static summary = messages.getMessage('summary');
+    static description = messages.getMessage('description');
+    static examples = messages.getMessages('examples');
+    static flags = {
+        sourcepath: Flags.string({
+            summary: messages.getMessage('flags.sourcepath.summary'),
+            description: messages.getMessage('flags.sourcepath.description'),
+            char: 's',
+            required: true,
+        }),
+        dryrun: Flags.boolean({
+            summary: messages.getMessage('flags.dryrun.summary'),
+            description: messages.getMessage('flags.dryrun.description'),
+            char: 'd',
+            default: false,
+        }),
+        'skip-instrumented': Flags.boolean({
+            summary: messages.getMessage('flags.skip-instrumented.summary') || 'Skip flows that already have RFLIB logging',
+            description: messages.getMessage('flags.skip-instrumented.description') || 'Do not instrument flows where RFLIB logging is already present',
+            default: false,
+        }),
+    };
+    logger;
+    stats = {
+        processedFiles: 0,
+        modifiedFiles: 0,
+    };
+    async run() {
+        this.logger = await Logger.child(this.ctor.name);
+        const startTime = Date.now();
+        const { flags } = await this.parse(RflibLoggingFlowInstrument);
+        const sourcePath = flags.sourcepath;
+        const isDryRun = flags.dryrun;
+        const skipInstrumented = flags['skip-instrumented'];
+        this.log(`Scanning Flow files in ${sourcePath} and sub directories`);
+        this.logger.debug(`Dry run mode: ${isDryRun}`);
+        this.logger.debug(`Skip instrumented: ${skipInstrumented}`);
+        this.spinner.start('Running...');
+        await this.processDirectory(sourcePath, isDryRun, skipInstrumented);
+        this.spinner.stop();
+        const duration = Date.now() - startTime;
+        this.logger.debug(`Completed instrumentation in ${duration}ms`);
+        this.log('\nInstrumentation complete.');
+        this.log(`Processed files: ${this.stats.processedFiles}`);
+        this.log(`Modified files: ${this.stats.modifiedFiles}`);
+        return { ...this.stats };
+    }
+    async processDirectory(dirPath, isDryRun, skipInstrumented) {
+        this.logger.debug(`Processing directory: ${dirPath}`);
+        const files = await fs.promises.readdir(dirPath);
+        for (const file of files) {
+            const filePath = path.join(dirPath, file);
+            const stat = await fs.promises.stat(filePath);
+            if (stat.isDirectory()) {
+                await this.processDirectory(filePath, isDryRun, skipInstrumented);
+            }
+            else if (file.endsWith('.flow-meta.xml')) {
+                await this.instrumentFlowFile(filePath, isDryRun, skipInstrumented);
+            }
+        }
+    }
+    async instrumentFlowFile(filePath, isDryRun, skipInstrumented) {
+        const flowName = path.basename(filePath, '.flow-meta.xml');
+        this.logger.debug(`Processing flow: ${flowName}`);
+        try {
+            this.stats.processedFiles++;
+            const content = await fs.promises.readFile(filePath, 'utf8');
+            const flowObj = await FlowInstrumentationService.parseFlowContent(content);
+            // Only instrument flows with processType="Flow", skip all others
+            if (!FlowInstrumentationService.isFlowType(flowObj)) {
+                this.logger.debug(`Skipping non-Flow type: ${flowName} (processType=${flowObj?.Flow?.processType || 'undefined'})`);
+                return;
+            }
+            // Check if flow already has RFLIB logging and skip if needed
+            if (skipInstrumented && FlowInstrumentationService.hasRFLIBLogger(flowObj)) {
+                this.logger.info(`Skipping already instrumented flow: ${flowName}`);
+                return;
+            }
+            const instrumentedFlow = FlowInstrumentationService.instrumentFlow(flowObj, flowName);
+            const newContent = FlowInstrumentationService.buildFlowContent(instrumentedFlow);
+            if (content !== newContent) {
+                this.stats.modifiedFiles++;
+                if (!isDryRun) {
+                    await fs.promises.writeFile(filePath, newContent);
+                    this.logger.info(`Modified: ${filePath}`);
+                }
+                else {
+                    this.logger.info(`Would modify: ${filePath}`);
+                }
+            }
+        }
+        catch (error) {
+            this.logger.error(`Error processing flow ${flowName}`, error);
+            throw error;
+        }
+    }
+}
+//# sourceMappingURL=instrument.js.map

package/lib/commands/rflib/logging/flow/instrument.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"instrument.js","sourceRoot":"","sources":["../../../../../src/commands/rflib/logging/flow/instrument.ts"],"names":[],"mappings":"AAAA,qCAAqC;AACrC,oDAAoD;AACpD,uDAAuD;AACvD,sDAAsD;AACtD,4DAA4D;AAC5D,wDAAwD;AACxD,+DAA+D;AAC/D,OAAO,KAAK,EAAE,MAAM,SAAS,CAAC;AAC9B,OAAO,KAAK,IAAI,MAAM,WAAW,CAAC;AAClC,OAAO,EAAE,SAAS,EAAE,KAAK,EAAE,MAAM,6BAA6B,CAAC;AAC/D,OAAO,EAAE,QAAQ,EAAE,MAAM,EAAE,MAAM,kBAAkB,CAAC;AACpD,OAAO,KAAK,MAAM,MAAM,QAAQ,CAAC;AAOjC,QAAQ,CAAC,kCAAkC,CAAC,MAAM,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;AAC7D,MAAM,QAAQ,GAAG,QAAQ,CAAC,YAAY,CAAC,cAAc,EAAE,+BAA+B,CAAC,CAAC;AAExF,gDAAgD;AAChD,yHAAyH;AAEzH,MAAM,OAAO,0BAA0B;IAC7B,MAAM,CAAU,MAAM,GAAG,IAAI,MAAM,CAAC,MAAM,CAAC;QACjD,aAAa,EAAE,KAAK;QACpB,qBAAqB,EAAE,IAAI;QAC3B,KAAK,EAAE,KAAK;KACb,CAAC,CAAC;IAEK,MAAM,CAAU,OAAO,GAAG,IAAI,MAAM,CAAC,OAAO,CAAC;QACnD,MAAM,EAAE,EAAE,OAAO,EAAE,KAAK,EAAE,QAAQ,EAAE,OAAO,EAAE;QAC7C,KAAK,EAAE,IAAI;KACZ,CAAC,CAAC;IAEI,MAAM,CAAC,KAAK,CAAC,gBAAgB,CAAC,OAAe;QAClD,IAAI,CAAC;YACH,OAAO,MAAM,IAAI,CAAC,MAAM,CAAC,kBAAkB,CAAC,OAAO,CAAC,CAAC;QACvD,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACf,IAAI,KAAK,YAAY,KAAK,EAAE,CAAC;gBAC3B,MAAM,IAAI,KAAK,CAAC,wBAAwB,KAAK,CAAC,OAAO,EAAE,CAAC,CAAC;YAC3D,CAAC;YACD,MAAM,IAAI,KAAK,CAAC,wCAAwC,CAAC,CAAC;QAC5D,CAAC;IACH,CAAC;IAEM,MAAM,CAAC,gBAAgB,CAAC,OAAY;QACzC,IAAI,CAAC;YACH,OAAO,IAAI,CAAC,OAAO,CAAC,WAAW,CAAC,OAAO,CAAC,CAAC;QAC3C,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACf,IAAI,KAAK,YAAY,KAAK,EAAE,CAAC;gBAC3B,MAAM,IAAI,KAAK,CAAC,yBAAyB,KAAK,CAAC,OAAO,EAAE,CAAC,CAAC;YAC5D,CAAC;YACD,MAAM,IAAI,KAAK,CAAC,yCAAyC,CAAC,CAAC;QAC7D,CAAC;IACH,CAAC;IAED,wDAAwD;IACjD,MAAM,CAAC,cAAc,CAAC,OAAY;QACvC,IAAI,CAAC,OAAO,EAAE,IAAI,EAAE,WAAW,EAAE,CAAC;YAChC,OAAO,KAAK,CAAC;QACf,CAAC;QAED,MAAM,WAAW,GAAG,KAAK,CAAC,OAAO,CAAC,OAAO,CAAC,IAAI,CAAC,WAAW,CAAC;YACzD,CAAC,CAAC,OAAO,CAAC,IAAI,CAAC,WAAW;YAC1B,CAAC,CAAC,CAAC,OAAO,CAAC,IAAI,CAAC,WAAW,CAAC,CAAC;QAE/B,OAAO,WAAW,CAAC,IAAI,CACrB,CAAC,MAAW,EAAE,EAAE,CACd,MAAM,CAAC,UAAU,KAAK,cAAc;YACpC,MAAM,CAAC,UAAU,KAAK,wBAAwB;YAC9C,MAAM,CAAC,UAAU,KAAK,oCAAoC;YAC1D,CAAC,MAAM,CAAC,IAAI,IAAI,OAAO,MAAM,CAAC,IAAI,KAAK,QAAQ,IAAI,MAAM,CAAC,IAAI,CAAC,UAAU,CAAC,mBAAmB,CAAC,CAAC,CAClG,CAAC;IACJ,CAAC;IAED,uEAAuE;IAChE,MAAM,CAAC,UAAU,CAAC,OAAY;QACnC,OAAO,OAAO,EAAE,IAAI,EAAE,WAAW,KAAK,MAAM,CAAC;IAC/C,CAAC;IAED,gCAAgC;IACzB,MAAM,CAAC,cAAc,CAAC,OAAY,EAAE,QAAgB;QACzD,wDAAwD;QACxD,MAAM,gBAAgB,GAAG,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,SAAS,CAAC,OAAO,CAAC,CAAC,CAAC;QAE7D,+BAA+B;QAC/B,IAAI,IAAI,CAAC,cAAc,CAAC,gBAAgB,CAAC,EAAE,CAAC;YAC1C,OAAO,gBAAgB,CAAC;QAC1B,CAAC;QAED,sCAAsC;QACtC,IAAI,CAAC,gBAAgB,CAAC,IAAI,EAAE,CAAC;YAC3B,OAAO,gBAAgB,CAAC;QAC1B,CAAC;QAED,gCAAgC;QAChC,IAAI,aAAa,GAAG,IAAI,CAAC,mBAAmB,CAAC,QAAQ,CAAC,CAAC;QAEvD,oDAAoD;QACpD,aAAa,GAAG,IAAI,CAAC,2BAA2B,CAAC,aAAa,EAAE,gBAAgB,CAAC,CAAC;QAElF,oCAAoC;QACpC,IAAI,CAAC,gBAAgB,CAAC,IAAI,CAAC,WAAW,EAAE,CAAC;YACvC,gBAAgB,CAAC,IAAI,CAAC,WAAW,GAAG,aAAa,CAAC;QACpD,CAAC;aAAM,IAAI,KAAK,CAAC,OAAO,CAAC,gBAAgB,CAAC,IAAI,CAAC,WAAW,CAAC,EAAE,CAAC;YAC5D,gBAAgB,CAAC,IAAI,CAAC,WAAW,CAAC,IAAI,CAAC,aAAa,CAAC,CAAC;QACxD,CAAC;aAAM,CAAC;YACN,8CAA8C;YAC9C,gBAAgB,CAAC,IAAI,CAAC,WAAW,GAAG,CAAC,gBAAgB,CAAC,IAAI,CAAC,WAAW,EAAE,aAAa,CAAC,CAAC;QACzF,CAAC;QAED,sDAAsD;QACtD,IAAI,gBAAgB,CAAC,IAAI,CAAC,qBAAqB,EAAE,CAAC;YAChD,oCAAoC;YACpC,MAAM,kBAAkB,GAAG,gBAAgB,CAAC,IAAI,CAAC,qBAAqB,CAAC;YAEvE,6DAA6D;YAC7D,aAAa,CAAC,SAAS,GAAG;gBACxB,eAAe,EAAE,kBAAkB;aACpC,CAAC;YAEF,2DAA2D;YAC3D,gBAAgB,CAAC,IAAI,CAAC,qBAAqB,GAAG,aAAa,CAAC,IAAI,CAAC;QACnE,CAAC;aAAM,CAAC;YACN,uDAAuD;YACvD,uEAAuE;YACvE,IAAI,KAAK,CAAC,OAAO,CAAC,gBAAgB,CAAC,IAAI,CAAC,SAAS,CAAC,IAAI,gBAAgB,CAAC,IAAI,CAAC,SAAS,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;gBACjG,4CAA4C;gBAC5C,MAAM,aAAa,GAAG,gBAAgB,CAAC,IAAI,CAAC,SAAS,CAAC,CAAC,CAAC,CAAC;gBACzD,aAAa,CAAC,SAAS,GAAG;oBACxB,eAAe,EAAE,aAAa,CAAC,IAAI;iBACpC,CAAC;YACJ,CAAC;iBAAM,IAAI,KAAK,CAAC,OAAO,CAAC,gBAAgB,CAAC,IAAI,CAAC,OAAO,CAAC,IAAI,gBAAgB,CAAC,IAAI,CAAC,OAAO,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;gBACpG,0CAA0C;gBAC1C,MAAM,WAAW,GAAG,gBAAgB,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC;gBACrD,aAAa,CAAC,SAAS,GAAG;oBACxB,eAAe,EAAE,WAAW,CAAC,IAAI;iBAClC,CAAC;YACJ,CAAC;YAED,uEAAuE;YACvE,gBAAgB,CAAC,IAAI,CAAC,qBAAqB,GAAG,aAAa,CAAC,IAAI,CAAC;QACnE,CAAC;QAED,oCAAoC;QACpC,IAAI,CAAC,gBAAgB,CAAC,IAAI,CAAC,cAAc,EAAE,CAAC;YAC1C,gBAAgB,CAAC,IAAI,CAAC,cAAc,GAAG,GAAG,QAAQ,2BAA2B,CAAC;QAChF,CAAC;QAED,sCAAsC;QACtC,gBAAgB,CAAC,IAAI,CAAC,WAAW,GAAG,MAAM,CAAC;QAE3C,gEAAgE;QAChE,IAAI,CAAC,gBAAgB,CAAC,IAAI,CAAC,SAAS,EAAE,CAAC;YACrC,gBAAgB,CAAC,IAAI,CAAC,SAAS,GAAG,EAAE,CAAC;QACvC,CAAC;aAAM,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,gBAAgB,CAAC,IAAI,CAAC,SAAS,CAAC,EAAE,CAAC;YAC3D,gBAAgB,CAAC,IAAI,CAAC,SAAS,GAAG,CAAC,gBAAgB,CAAC,IAAI,CAAC,SAAS,CAAC,CAAC;QACtE,CAAC;QAED,OAAO,gBAAgB,CAAC;IAC1B,CAAC;IAED,sDAAsD;IAC9C,MAAM,CAAC,gBAAgB;QAC7B,OAAO,aAAa,IAAI,CAAC,GAAG,EAAE,CAAC,QAAQ,CAAC,EAAE,CAAC,IAAI,IAAI,CAAC,MAAM,EAAE,CAAC,QAAQ,CAAC,EAAE,CAAC,CAAC,SAAS,CAAC,CAAC,EAAE,CAAC,CAAC,EAAE,CAAC;IAC9F,CAAC;IAED,4CAA4C;IACpC,MAAM,CAAC,mBAAmB,CAAC,QAAgB;QACjD,MAAM,QAAQ,GAAG,IAAI,CAAC,gBAAgB,EAAE,CAAC;QACzC,OAAO;YACL,UAAU,EAAE,wBAAwB;YACpC,UAAU,EAAE,MAAM;YAClB,IAAI,EAAE,qBAAqB,QAAQ,EAAE;YACrC,KAAK,EAAE,qBAAqB;YAC5B,SAAS,EAAE,GAAG;YACd,SAAS,EAAE,EAAE;YACb,eAAe,EAAE;gBACf;oBACE,IAAI,EAAE,SAAS;oBACf,KAAK,EAAE;wBACL,WAAW,EAAE,QAAQ;qBACtB;iBACF;gBACD;oBACE,IAAI,EAAE,UAAU;oBAChB,KAAK,EAAE;wBACL,WAAW,EAAE,MAAM;qBACpB;iBACF;gBACD;oBACE,IAAI,EAAE,SAAS;oBACf,KAAK,EAAE;wBACL,WAAW,EAAE,QAAQ,QAAQ,UAAU;qBACxC;iBACF;aACF;SACF,CAAC;IACJ,CAAC;IAED,0EAA0E;IAClE,MAAM,CAAC,2BAA2B,CAAC,aAAkB,EAAE,OAAY;QACzE,iEAAiE;QACjE,MAAM,SAAS,GAAG,OAAO,CAAC,IAAI,CAAC,SAAS,IAAI,EAAE,CAAC;QAC/C,MAAM,cAAc,GAAG,KAAK,CAAC,OAAO,CAAC,SAAS,CAAC;YAC7C,CAAC,CAAC,SAAS,CAAC,MAAM,CAAC,CAAC,CAAM,EAAE,EAAE,CAAC,CAAC,CAAC,OAAO,KAAK,MAAM,IAAI,CAAC,CAAC,YAAY,KAAK,MAAM,CAAC;YACjF,CAAC,CAAC,CAAC,SAAS,CAAC,OAAO,KAAK,MAAM,IAAI,SAAS,CAAC,YAAY,KAAK,MAAM,CAAC,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC;QAE3F,IAAI,cAAc,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;YAC9B,uDAAuD;YACvD,MAAM,iBAAiB,GAAG,aAAa,CAAC,eAAe,CAAC,SAAS,CAC/D,CAAC,CAAM,EAAE,EAAE,CAAC,CAAC,CAAC,IAAI,EAAE,WAAW,EAAE,KAAK,SAAS,CAChD,CAAC;YAEF,IAAI,iBAAiB,IAAI,CAAC,EAAE,CAAC;gBAC3B,gDAAgD;gBAChD,MAAM,OAAO,GAAG,cAAc;qBAC3B,GAAG,CAAC,CAAC,CAAM,EAAE,EAAE,CAAC,GAAG,CAAC,CAAC,IAAI,OAAO,CAAC,CAAC,IAAI,GAAG,CAAC;qBAC1C,IAAI,CAAC,IAAI,CAAC,CAAC;gBAEd,MAAM,WAAW,GAAG,aAAa,CAAC,eAAe,CAAC,iBAAiB,CAAC,CAAC;gBACrE,MAAM,eAAe,GAAG,WAAW,CAAC,KAAK,CAAC,WAAW,CAAC;gBACtD,WAAW,CAAC,KAAK,CAAC,WAAW,GAAG,GAAG,eAAe,SAAS,OAAO,EAAE,CAAC;YACvE,CAAC;QACH,CAAC;QAED,OAAO,aAAa,CAAC;IACvB,CAAC;;AAGH,MAAM,CAAC,OAAO,OAAO,0BAA2B,SAAQ,SAA2C;IAC1F,MAAM,CAAU,OAAO,GAAG,QAAQ,CAAC,UAAU,CAAC,SAAS,CAAC,CAAC;IACzD,MAAM,CAAU,WAAW,GAAG,QAAQ,CAAC,UAAU,CAAC,aAAa,CAAC,CAAC;IACjE,MAAM,CAAU,QAAQ,GAAG,QAAQ,CAAC,WAAW,CAAC,UAAU,CAAC,CAAC;IAE5D,MAAM,CAAU,KAAK,GAAG;QAC7B,UAAU,EAAE,KAAK,CAAC,MAAM,CAAC;YACvB,OAAO,EAAE,QAAQ,CAAC,UAAU,CAAC,0BAA0B,CAAC;YACxD,WAAW,EAAE,QAAQ,CAAC,UAAU,CAAC,8BAA8B,CAAC;YAChE,IAAI,EAAE,GAAG;YACT,QAAQ,EAAE,IAAI;SACf,CAAC;QACF,MAAM,EAAE,KAAK,CAAC,OAAO,CAAC;YACpB,OAAO,EAAE,QAAQ,CAAC,UAAU,CAAC,sBAAsB,CAAC;YACpD,WAAW,EAAE,QAAQ,CAAC,UAAU,CAAC,0BAA0B,CAAC;YAC5D,IAAI,EAAE,GAAG;YACT,OAAO,EAAE,KAAK;SACf,CAAC;QACF,mBAAmB,EAAE,KAAK,CAAC,OAAO,CAAC;YACjC,OAAO,EAAE,QAAQ,CAAC,UAAU,CAAC,iCAAiC,CAAC,IAAI,4CAA4C;YAC/G,WAAW,EAAE,QAAQ,CAAC,UAAU,CAAC,qCAAqC,CAAC,IAAI,gEAAgE;YAC3I,OAAO,EAAE,KAAK;SACf,CAAC;KACH,CAAC;IAEM,MAAM,CAAU;IACP,KAAK,GAAqC;QACzD,cAAc,EAAE,CAAC;QACjB,aAAa,EAAE,CAAC;KACjB,CAAC;IAEK,KAAK,CAAC,GAAG;QACd,IAAI,CAAC,MAAM,GAAG,MAAM,MAAM,CAAC,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;QACjD,MAAM,SAAS,GAAG,IAAI,CAAC,GAAG,EAAE,CAAC;QAE7B,MAAM,EAAE,KAAK,EAAE,GAAG,MAAM,IAAI,CAAC,KAAK,CAAC,0BAA0B,CAAC,CAAC;QAC/D,MAAM,UAAU,GAAG,KAAK,CAAC,UAAU,CAAC;QACpC,MAAM,QAAQ,GAAG,KAAK,CAAC,MAAM,CAAC;QAC9B,MAAM,gBAAgB,GAAG,KAAK,CAAC,mBAAmB,CAAC,CAAC;QAEpD,IAAI,CAAC,GAAG,CAAC,0BAA0B,UAAU,sBAAsB,CAAC,CAAC;QACrE,IAAI,CAAC,MAAM,CAAC,KAAK,CAAC,iBAAiB,QAAQ,EAAE,CAAC,CAAC;QAC/C,IAAI,CAAC,MAAM,CAAC,KAAK,CAAC,sBAAsB,gBAAgB,EAAE,CAAC,CAAC;QAE5D,IAAI,CAAC,OAAO,CAAC,KAAK,CAAC,YAAY,CAAC,CAAC;QACjC,MAAM,IAAI,CAAC,gBAAgB,CAAC,UAAU,EAAE,QAAQ,EAAE,gBAAgB,CAAC,CAAC;QACpE,IAAI,CAAC,OAAO,CAAC,IAAI,EAAE,CAAC;QAEpB,MAAM,QAAQ,GAAG,IAAI,CAAC,GAAG,EAAE,GAAG,SAAS,CAAC;QACxC,IAAI,CAAC,MAAM,CAAC,KAAK,CAAC,gCAAgC,QAAQ,IAAI,CAAC,CAAC;QAEhE,IAAI,CAAC,GAAG,CAAC,6BAA6B,CAAC,CAAC;QACxC,IAAI,CAAC,GAAG,CAAC,oBAAoB,IAAI,CAAC,KAAK,CAAC,cAAc,EAAE,CAAC,CAAC;QAC1D,IAAI,CAAC,GAAG,CAAC,mBAAmB,IAAI,CAAC,KAAK,CAAC,aAAa,EAAE,CAAC,CAAC;QAExD,OAAO,EAAE,GAAG,IAAI,CAAC,KAAK,EAAE,CAAC;IAC3B,CAAC;IAEO,KAAK,CAAC,gBAAgB,CAAC,OAAe,EAAE,QAAiB,EAAE,gBAAyB;QAC1F,IAAI,CAAC,MAAM,CAAC,KAAK,CAAC,yBAAyB,OAAO,EAAE,CAAC,CAAC;QACtD,MAAM,KAAK,GAAG,MAAM,EAAE,CAAC,QAAQ,CAAC,OAAO,CAAC,OAAO,CAAC,CAAC;QAEjD,KAAK,MAAM,IAAI,IAAI,KAAK,EAAE,CAAC;YACzB,MAAM,QAAQ,GAAG,IAAI,CAAC,IAAI,CAAC,OAAO,EAAE,IAAI,CAAC,CAAC;YAC1C,MAAM,IAAI,GAAG,MAAM,EAAE,CAAC,QAAQ,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAC;YAE9C,IAAI,IAAI,CAAC,WAAW,EAAE,EAAE,CAAC;gBACvB,MAAM,IAAI,CAAC,gBAAgB,CAAC,QAAQ,EAAE,QAAQ,EAAE,gBAAgB,CAAC,CAAC;YACpE,CAAC;iBAAM,IAAI,IAAI,CAAC,QAAQ,CAAC,gBAAgB,CAAC,EAAE,CAAC;gBAC3C,MAAM,IAAI,CAAC,kBAAkB,CAAC,QAAQ,EAAE,QAAQ,EAAE,gBAAgB,CAAC,CAAC;YACtE,CAAC;QACH,CAAC;IACH,CAAC;IAEO,KAAK,CAAC,kBAAkB,CAAC,QAAgB,EAAE,QAAiB,EAAE,gBAAyB;QAC7F,MAAM,QAAQ,GAAG,IAAI,CAAC,QAAQ,CAAC,QAAQ,EAAE,gBAAgB,CAAC,CAAC;QAC3D,IAAI,CAAC,MAAM,CAAC,KAAK,CAAC,oBAAoB,QAAQ,EAAE,CAAC,CAAC;QAElD,IAAI,CAAC;YACH,IAAI,CAAC,KAAK,CAAC,cAAc,EAAE,CAAC;YAC5B,MAAM,OAAO,GAAG,MAAM,EAAE,CAAC,QAAQ,CAAC,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC,CAAC;YAC7D,MAAM,OAAO,GAAG,MAAM,0BAA0B,CAAC,gBAAgB,CAAC,OAAO,CAAC,CAAC;YAE3E,iEAAiE;YACjE,IAAI,CAAC,0BAA0B,CAAC,UAAU,CAAC,OAAO,CAAC,EAAE,CAAC;gBACpD,IAAI,CAAC,MAAM,CAAC,KAAK,CAAC,2BAA2B,QAAQ,iBAAiB,OAAO,EAAE,IAAI,EAAE,WAAW,IAAI,WAAW,GAAG,CAAC,CAAC;gBACpH,OAAO;YACT,CAAC;YAED,6DAA6D;YAC7D,IAAI,gBAAgB,IAAI,0BAA0B,CAAC,cAAc,CAAC,OAAO,CAAC,EAAE,CAAC;gBAC3E,IAAI,CAAC,MAAM,CAAC,IAAI,CAAC,uCAAuC,QAAQ,EAAE,CAAC,CAAC;gBACpE,OAAO;YACT,CAAC;YAED,MAAM,gBAAgB,GAAG,0BAA0B,CAAC,cAAc,CAAC,OAAO,EAAE,QAAQ,CAAC,CAAC;YACtF,MAAM,UAAU,GAAG,0BAA0B,CAAC,gBAAgB,CAAC,gBAAgB,CAAC,CAAC;YAEjF,IAAI,OAAO,KAAK,UAAU,EAAE,CAAC;gBAC3B,IAAI,CAAC,KAAK,CAAC,aAAa,EAAE,CAAC;gBAC3B,IAAI,CAAC,QAAQ,EAAE,CAAC;oBACd,MAAM,EAAE,CAAC,QAAQ,CAAC,SAAS,CAAC,QAAQ,EAAE,UAAU,CAAC,CAAC;oBAClD,IAAI,CAAC,MAAM,CAAC,IAAI,CAAC,aAAa,QAAQ,EAAE,CAAC,CAAC;gBAC5C,CAAC;qBAAM,CAAC;oBACN,IAAI,CAAC,MAAM,CAAC,IAAI,CAAC,iBAAiB,QAAQ,EAAE,CAAC,CAAC;gBAChD,CAAC;YACH,CAAC;QACH,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACf,IAAI,CAAC,MAAM,CAAC,KAAK,CAAC,yBAAyB,QAAQ,EAAE,EAAE,KAAK,CAAC,CAAC;YAC9D,MAAM,KAAK,CAAC;QACd,CAAC;IACH,CAAC","sourcesContent":["/* eslint-disable no-await-in-loop */\n/* eslint-disable @typescript-eslint/return-await */\n/* eslint-disable @typescript-eslint/no-explicit-any */\n/* eslint-disable @typescript-eslint/no-unsafe-call */\n/* eslint-disable @typescript-eslint/no-unsafe-assignment */\n/* eslint-disable @typescript-eslint/no-unsafe-return */\n/* eslint-disable @typescript-eslint/no-unsafe-member-access */\nimport * as fs from 'node:fs';\nimport * as path from 'node:path';\nimport { SfCommand, Flags } from '@salesforce/sf-plugins-core';\nimport { Messages, Logger } from '@salesforce/core';\nimport * as xml2js from 'xml2js';\n\nexport type RflibLoggingFlowInstrumentResult = {\n  processedFiles: number;\n  modifiedFiles: number;\n};\n\nMessages.importMessagesDirectoryFromMetaUrl(import.meta.url);\nconst messages = Messages.loadMessages('rflib-plugin', 'rflib.logging.flow.instrument');\n\n// Type definition removed to fix compiler error\n// This was used to document valid Flow variable types: 'String' | 'Number' | 'Boolean' | 'SObject' | 'SObjectCollection'\n\nexport class FlowInstrumentationService {\n  private static readonly parser = new xml2js.Parser({\n    explicitArray: false,\n    preserveChildrenOrder: true,\n    xmlns: false\n  });\n\n  private static readonly builder = new xml2js.Builder({\n    xmldec: { version: '1.0', encoding: 'UTF-8' },\n    cdata: true\n  });\n\n  public static async parseFlowContent(content: string): Promise<any> {\n    try {\n      return await this.parser.parseStringPromise(content);\n    } catch (error) {\n      if (error instanceof Error) {\n        throw new Error(`Flow parsing failed: ${error.message}`);\n      }\n      throw new Error('Flow parsing failed with unknown error');\n    }\n  }\n\n  public static buildFlowContent(flowObj: any): string {\n    try {\n      return this.builder.buildObject(flowObj);\n    } catch (error) {\n      if (error instanceof Error) {\n        throw new Error(`Flow building failed: ${error.message}`);\n      }\n      throw new Error('Flow building failed with unknown error');\n    }\n  }\n\n  // Helper to check if flow already contains RFLIB logger\n  public static hasRFLIBLogger(flowObj: any): boolean {\n    if (!flowObj?.Flow?.actionCalls) {\n      return false;\n    }\n\n    const actionCalls = Array.isArray(flowObj.Flow.actionCalls)\n      ? flowObj.Flow.actionCalls\n      : [flowObj.Flow.actionCalls];\n\n    return actionCalls.some(\n      (action: any) => \n        action.actionName === 'rflib:Logger' || \n        action.actionName === 'rflib_LoggerFlowAction' ||\n        action.actionName === 'rflib_ApplicationEventLoggerAction' ||\n        (action.name && typeof action.name === 'string' && action.name.startsWith('RFLIB_Flow_Logger'))\n    );\n  }\n\n  // Helper to check if flow is of type \"Flow\" that we want to instrument\n  public static isFlowType(flowObj: any): boolean {\n    return flowObj?.Flow?.processType === 'Flow';\n  }\n\n  // Main instrumentation function\n  public static instrumentFlow(flowObj: any, flowName: string): any {\n    // Deep clone the object to avoid modifying the original\n    const instrumentedFlow = JSON.parse(JSON.stringify(flowObj));\n\n    // Skip if already instrumented\n    if (this.hasRFLIBLogger(instrumentedFlow)) {\n      return instrumentedFlow;\n    }\n\n    // Make sure Flow exists in the object\n    if (!instrumentedFlow.Flow) {\n      return instrumentedFlow;\n    }\n\n    // Create logging action element\n    let loggingAction = this.createLoggingAction(flowName);\n\n    // Add variables to the logging message if available\n    loggingAction = this.enhanceLoggingWithVariables(loggingAction, instrumentedFlow);\n\n    // Add logging action to actionCalls\n    if (!instrumentedFlow.Flow.actionCalls) {\n      instrumentedFlow.Flow.actionCalls = loggingAction;\n    } else if (Array.isArray(instrumentedFlow.Flow.actionCalls)) {\n      instrumentedFlow.Flow.actionCalls.push(loggingAction);\n    } else {\n      // If only one action exists, convert to array\n      instrumentedFlow.Flow.actionCalls = [instrumentedFlow.Flow.actionCalls, loggingAction];\n    }\n\n    // Find startElementReference and connect logger to it\n    if (instrumentedFlow.Flow.startElementReference) {\n      // Save the original start reference\n      const startNodeReference = instrumentedFlow.Flow.startElementReference;\n      \n      // Create connector between logger and original start element\n      loggingAction.connector = {\n        targetReference: startNodeReference\n      };\n      \n      // Update flow startElementReference to point to our logger\n      instrumentedFlow.Flow.startElementReference = loggingAction.name;\n    } else {\n      // If no start element, try to find another entry point\n      // Common patterns: decisions, screens, or first element in the process\n      if (Array.isArray(instrumentedFlow.Flow.decisions) && instrumentedFlow.Flow.decisions.length > 0) {\n        // Find the first decision and connect to it\n        const firstDecision = instrumentedFlow.Flow.decisions[0];\n        loggingAction.connector = {\n          targetReference: firstDecision.name\n        };\n      } else if (Array.isArray(instrumentedFlow.Flow.screens) && instrumentedFlow.Flow.screens.length > 0) {\n        // Find the first screen and connect to it\n        const firstScreen = instrumentedFlow.Flow.screens[0];\n        loggingAction.connector = {\n          targetReference: firstScreen.name\n        };\n      }\n\n      // Create a startElementReference pointing to our logger if none exists\n      instrumentedFlow.Flow.startElementReference = loggingAction.name;\n    }\n\n    // Add interviewLabel if not present\n    if (!instrumentedFlow.Flow.interviewLabel) {\n      instrumentedFlow.Flow.interviewLabel = `${flowName} {!$Flow.CurrentDateTime}`;\n    }\n\n    // Ensure processType is set to 'Flow'\n    instrumentedFlow.Flow.processType = 'Flow';\n\n    // Add variables if not present (needed for variable references)\n    if (!instrumentedFlow.Flow.variables) {\n      instrumentedFlow.Flow.variables = [];\n    } else if (!Array.isArray(instrumentedFlow.Flow.variables)) {\n      instrumentedFlow.Flow.variables = [instrumentedFlow.Flow.variables];\n    }\n\n    return instrumentedFlow;\n  }\n\n  // Helper to generate unique IDs for new flow elements\n  private static generateUniqueId(): string {\n    return `RFLIB_LOG_${Date.now().toString(36)}_${Math.random().toString(36).substring(2, 9)}`;\n  }\n\n  // Helper to create a logging action element\n  private static createLoggingAction(flowName: string): any {\n    const loggerId = this.generateUniqueId();\n    return {\n      actionName: 'rflib_LoggerFlowAction',\n      actionType: 'apex',\n      name: `RFLIB_Flow_Logger_${loggerId}`,\n      label: 'Log Flow Invocation',\n      locationX: 176,\n      locationY: 50,\n      inputParameters: [\n        {\n          name: 'context',\n          value: {\n            stringValue: flowName,\n          },\n        },\n        {\n          name: 'logLevel',\n          value: {\n            stringValue: 'INFO',\n          },\n        },\n        {\n          name: 'message',\n          value: {\n            stringValue: `Flow ${flowName} started`,\n          },\n        },\n      ],\n    };\n  }\n\n  // Helper to add variable references to the logging message when available\n  private static enhanceLoggingWithVariables(loggingAction: any, flowObj: any): any {\n    // Find input variables or parameters that might be useful to log\n    const variables = flowObj.Flow.variables || [];\n    const inputVariables = Array.isArray(variables)\n      ? variables.filter((v: any) => v.isInput === 'true' || v.isCollection === 'true')\n      : (variables.isInput === 'true' || variables.isCollection === 'true' ? [variables] : []);\n\n    if (inputVariables.length > 0) {\n      // Find the message parameter - case insensitive search\n      const messageParamIndex = loggingAction.inputParameters.findIndex(\n        (p: any) => p.name?.toLowerCase() === 'message'\n      );\n\n      if (messageParamIndex >= 0) {\n        // Enhance the message with variable information\n        const varRefs = inputVariables\n          .map((v: any) => `${v.name}: {!${v.name}}`)\n          .join(', ');\n\n        const baseMessage = loggingAction.inputParameters[messageParamIndex];\n        const originalMessage = baseMessage.value.stringValue;\n        baseMessage.value.stringValue = `${originalMessage} with ${varRefs}`;\n      }\n    }\n\n    return loggingAction;\n  }\n}\n\nexport default class RflibLoggingFlowInstrument extends SfCommand<RflibLoggingFlowInstrumentResult> {\n  public static readonly summary = messages.getMessage('summary');\n  public static readonly description = messages.getMessage('description');\n  public static readonly examples = messages.getMessages('examples');\n\n  public static readonly flags = {\n    sourcepath: Flags.string({\n      summary: messages.getMessage('flags.sourcepath.summary'),\n      description: messages.getMessage('flags.sourcepath.description'),\n      char: 's',\n      required: true,\n    }),\n    dryrun: Flags.boolean({\n      summary: messages.getMessage('flags.dryrun.summary'),\n      description: messages.getMessage('flags.dryrun.description'),\n      char: 'd',\n      default: false,\n    }),\n    'skip-instrumented': Flags.boolean({\n      summary: messages.getMessage('flags.skip-instrumented.summary') || 'Skip flows that already have RFLIB logging',\n      description: messages.getMessage('flags.skip-instrumented.description') || 'Do not instrument flows where RFLIB logging is already present',\n      default: false,\n    }),\n  };\n\n  private logger!: Logger;\n  private readonly stats: RflibLoggingFlowInstrumentResult = {\n    processedFiles: 0,\n    modifiedFiles: 0,\n  };\n\n  public async run(): Promise<RflibLoggingFlowInstrumentResult> {\n    this.logger = await Logger.child(this.ctor.name);\n    const startTime = Date.now();\n\n    const { flags } = await this.parse(RflibLoggingFlowInstrument);\n    const sourcePath = flags.sourcepath;\n    const isDryRun = flags.dryrun;\n    const skipInstrumented = flags['skip-instrumented'];\n\n    this.log(`Scanning Flow files in ${sourcePath} and sub directories`);\n    this.logger.debug(`Dry run mode: ${isDryRun}`);\n    this.logger.debug(`Skip instrumented: ${skipInstrumented}`);\n\n    this.spinner.start('Running...');\n    await this.processDirectory(sourcePath, isDryRun, skipInstrumented);\n    this.spinner.stop();\n\n    const duration = Date.now() - startTime;\n    this.logger.debug(`Completed instrumentation in ${duration}ms`);\n\n    this.log('\\nInstrumentation complete.');\n    this.log(`Processed files: ${this.stats.processedFiles}`);\n    this.log(`Modified files: ${this.stats.modifiedFiles}`);\n\n    return { ...this.stats };\n  }\n\n  private async processDirectory(dirPath: string, isDryRun: boolean, skipInstrumented: boolean): Promise<void> {\n    this.logger.debug(`Processing directory: ${dirPath}`);\n    const files = await fs.promises.readdir(dirPath);\n\n    for (const file of files) {\n      const filePath = path.join(dirPath, file);\n      const stat = await fs.promises.stat(filePath);\n\n      if (stat.isDirectory()) {\n        await this.processDirectory(filePath, isDryRun, skipInstrumented);\n      } else if (file.endsWith('.flow-meta.xml')) {\n        await this.instrumentFlowFile(filePath, isDryRun, skipInstrumented);\n      }\n    }\n  }\n\n  private async instrumentFlowFile(filePath: string, isDryRun: boolean, skipInstrumented: boolean): Promise<void> {\n    const flowName = path.basename(filePath, '.flow-meta.xml');\n    this.logger.debug(`Processing flow: ${flowName}`);\n\n    try {\n      this.stats.processedFiles++;\n      const content = await fs.promises.readFile(filePath, 'utf8');\n      const flowObj = await FlowInstrumentationService.parseFlowContent(content);\n\n      // Only instrument flows with processType=\"Flow\", skip all others\n      if (!FlowInstrumentationService.isFlowType(flowObj)) {\n        this.logger.debug(`Skipping non-Flow type: ${flowName} (processType=${flowObj?.Flow?.processType || 'undefined'})`);\n        return;\n      }\n\n      // Check if flow already has RFLIB logging and skip if needed\n      if (skipInstrumented && FlowInstrumentationService.hasRFLIBLogger(flowObj)) {\n        this.logger.info(`Skipping already instrumented flow: ${flowName}`);\n        return;\n      }\n\n      const instrumentedFlow = FlowInstrumentationService.instrumentFlow(flowObj, flowName);\n      const newContent = FlowInstrumentationService.buildFlowContent(instrumentedFlow);\n\n      if (content !== newContent) {\n        this.stats.modifiedFiles++;\n        if (!isDryRun) {\n          await fs.promises.writeFile(filePath, newContent);\n          this.logger.info(`Modified: ${filePath}`);\n        } else {\n          this.logger.info(`Would modify: ${filePath}`);\n        }\n      }\n    } catch (error) {\n      this.logger.error(`Error processing flow ${flowName}`, error);\n      throw error;\n    }\n  }\n}\n"]}

package/messages/rflib.logging.flow.instrument.md

@@ -0,0 +1,36 @@
+# summary
+
+Summary of a command.
+
+# description
+
+More information about a command. Don't repeat the summary. 
+
+# flags.sourcepath.summary
+
+Directory containing Apex classes to instrument with logging.
+
+# flags.sourcepath.description
+
+Path to the source directory containing Apex classes that should be instrumented with RFLIB logging statements. Test classes (ending with 'Test.cls') are automatically excluded.
+
+# flags.dryrun.summary
+
+Preview changes without modifying files.
+
+# flags.dryrun.description
+
+When enabled, shows which files would be modified without making actual changes. Useful for reviewing the impact before applying changes.
+
+# flags.skip-instrumented.summary
+
+Skips any files where a logger is already present.
+
+# flags.skip-instrumented.description
+
+When provided, the command will not add log statements to any Flows that already contains a RFLIB logging node.
+
+# examples
+
+- <%= config.bin %> <%= command.id %>
+