x-fidelity 3.3.0 → 3.4.0

package/CHANGELOG.md

@@ -1,3 +1,24 @@
+# [3.4.0](https://github.com/zotoio/x-fidelity/compare/v3.3.1...v3.4.0) (2025-02-26)
+
+
+### Bug Fixes
+
+* add support for all modern regex flags in pattern matching ([847a320](https://github.com/zotoio/x-fidelity/commit/847a32068b68db66c1a9d84090bae4bc918f36d0))
+* correct regex test case to use case-insensitive flag ([96d906c](https://github.com/zotoio/x-fidelity/commit/96d906c23833f482d649df866ca36f28f609bbd6))
+
+
+### Features
+
+* add regex pattern matching operator with tests ([8ac216f](https://github.com/zotoio/x-fidelity/commit/8ac216f222a28367eba971f0f187fad4173167b3))
+* **operators:** add regexMatch general purpose operator ([8270696](https://github.com/zotoio/x-fidelity/commit/82706966e9a52c089848f785007f415e614b67da))
+
+## [3.3.1](https://github.com/zotoio/x-fidelity/compare/v3.3.0...v3.3.1) (2025-02-26)
+
+
+### Bug Fixes
+
+* **engine:** node 18 ([6c3e157](https://github.com/zotoio/x-fidelity/commit/6c3e157d0873dbd6148c568f213ee7ad997744bd))
+
 # [3.3.0](https://github.com/zotoio/x-fidelity/compare/v3.2.0...v3.3.0) (2025-02-22)
 
 

package/dist/core/cli.js

@@ -15,6 +15,18 @@ const prettyjson_1 = __importDefault(require("prettyjson"));
 exports.DEMO_CONFIG_PATH = path_1.default.resolve(__dirname, '../demoConfig');
 exports.options = commander_1.program.opts();
 function initCLI() {
+    const bannerArt = `\n
+=====================================
+ __    __          ________  ______ 
+| ##  | ##        | ######## \\######
+ \\##\\/  ## ______ | ##__      | ##  
+  >##  ## |      \\| ##  \\     | ##  
+ /  ####\\  \\######| ######    | ##  
+|  ## \\##\\        | ##       _| ##_ 
+| ##  | ##        | ##      |   ## \\
+ \\##   \\##         \\##       \\######
+------------------------------------- 
+`;
     // Ensure logger is initialized
     if (!logger_1.logger || typeof logger_1.logger.info !== 'function') {
         console.error({ msg: 'Logger is not properly initialized' });
@@ -40,7 +52,7 @@ function initCLI() {
         }
     });
     commander_1.program
-        .option("-d, --dir <directory>", "code directory to analyze. equivalent of directory argument")
+        .option("-d, --dir <directory>", "local git repo directory path to analyze. equivalent of directory argument")
         .option("-a, --archetype <archetype>", "The archetype to use for analysis", "node-fullstack")
         .option("-c, --configServer <configServer>", "The config server URL for fetching remote archetype configurations and rules. This takes precedence over localConfigPath.")
         .option("-o, --openaiEnabled <boolean>", "Enable OpenAI analysis", false)
@@ -53,7 +65,11 @@ function initCLI() {
         .option("-x, --examine <archetype>", "Examine the archetype configuration and rules")
         .version(package_json_1.version, "-v, --version", "Output the version number of xfidelity")
         .helpOption("-h, --help", "Display help for command")
-        .argument('[directory]', 'code directory to analyze');
+        .summary("CLI for analyzing codebases for architectural fidelity")
+        .usage("[directory] [options]")
+        .argument('[directory]', 'local git repo directory path to analyze')
+        .addHelpText('before', bannerArt)
+        .addHelpText('after', '-------------------------------------');
     commander_1.program.parse(process.argv);
     // Resolve paths
     const resolvePath = (inputPath) => {
@@ -90,18 +106,18 @@ function initCLI() {
         if (process.env.NODE_ENV !== 'test')
             commander_1.program.error(`LocalConfigPath does not exist or is invalid: ${error}`);
     }
-    const bannerArt = `\n
-=====================================
- __    __          ________  ______ 
-| ##  | ##        | ######## \\######
- \\##\\/  ## ______ | ##__      | ##  
-  >##  ## |      \\| ##  \\     | ##  
- /  ####\\  \\######| ######    | ##  
-|  ## \\##\\        | ##       _| ##_ 
-| ##  | ##        | ##      |   ## \\
- \\##   \\##         \\##       \\######
-------------------------------------- 
-`;
+    // const bannerArt = `\n
+    // =====================================
+    //  __    __          ________  ______ 
+    // | ##  | ##        | ######## \\######
+    //  \\##\\/  ## ______ | ##__      | ##  
+    //   >##  ## |      \\| ##  \\     | ##  
+    //  /  ####\\  \\######| ######    | ##  
+    // |  ## \\##\\        | ##       _| ##_ 
+    // | ##  | ##        | ##      |   ## \\
+    //  \\##   \\##         \\##       \\######
+    // ------------------------------------- 
+    // `;
     logger_1.logger.info(bannerArt);
     logger_1.logger.info(`\n${prettyjson_1.default.render({
         version: package_json_1.version,

package/dist/core/engine/analyzer.js

@@ -87,22 +87,25 @@ function analyzeCodebase(params) {
         const finishMsg = `\n==========================\nCHECKS COMPLETED..\n==========================`;
         logger_1.logger.info(finishMsg);
         const totalFailureCount = (0, utils_1.countRuleFailures)(failures);
-        logger_1.logger.info(`${fileData.length} files analyzed. ${totalFailureCount} rule failures.`);
+        logger_1.logger.info(`${fileData.length - 1} files analyzed. ${totalFailureCount} rule failures.`);
         const fatalityCount = (0, utils_1.countRuleFailures)(failures, 'fatality');
         const warningCount = (0, utils_1.countRuleFailures)(failures, 'warning');
         const exemptCount = (0, utils_1.countRuleFailures)(failures, 'exempt');
         const errorCount = (0, utils_1.countRuleFailures)(failures, 'error');
         const finishTime = new Date().getTime();
+        const memoryUsage = process.memoryUsage();
+        logger_1.logger.info('Assemblying result metadata..');
         const resultMetadata = {
             XFI_RESULT: {
                 archetype,
                 telemetryData,
+                memoryUsage,
                 repoXFIConfig: repoXFIConfig,
                 issueDetails: failures,
                 startTime: telemetryData.startTime,
                 finishTime: finishTime,
                 durationSeconds: (finishTime - telemetryData.startTime) / 1000,
-                fileCount: fileData.length,
+                fileCount: fileData.length - 1,
                 totalIssues: totalFailureCount,
                 warningCount: warningCount,
                 fatalityCount: fatalityCount,
@@ -110,6 +113,7 @@ function analyzeCodebase(params) {
                 exemptCount: exemptCount,
                 options: cli_1.options,
                 repoPath,
+                repoUrl
             }
         };
         // Send telemetry for analysis end

package/dist/core/engine/analyzer.test.js

@@ -106,15 +106,17 @@ describe('analyzeCodebase', () => {
             XFI_RESULT: expect.objectContaining({
                 archetype: 'node-fullstack',
                 repoPath: 'mockRepoPath',
-                fileCount: 3,
+                fileCount: expect.any(Number),
                 totalIssues: expect.any(Number),
                 warningCount: expect.any(Number),
                 fatalityCount: expect.any(Number),
+                errorCount: expect.any(Number),
                 exemptCount: expect.any(Number),
                 issueDetails: expect.any(Array),
                 durationSeconds: expect.any(Number),
                 finishTime: expect.any(Number),
                 startTime: expect.any(Number),
+                memoryUsage: expect.any(Object),
                 options: expect.objectContaining({
                     archetype: 'node-fullstack',
                     configServer: '',
@@ -132,6 +134,7 @@ describe('analyzeCodebase', () => {
                     startTime: expect.any(Number),
                     userInfo: expect.any(Object),
                 }),
+                repoUrl: expect.any(String),
                 repoXFIConfig: expect.objectContaining({
                     sensitiveFileFalsePositives: expect.any(Array),
                 })
@@ -177,7 +180,7 @@ describe('analyzeCodebase', () => {
             XFI_RESULT: expect.objectContaining({
                 archetype: 'node-fullstack',
                 repoPath: 'mockRepoPath',
-                fileCount: 3,
+                fileCount: expect.any(Number),
                 totalIssues: 3,
                 warningCount: 0,
                 fatalityCount: 0,
@@ -202,8 +205,10 @@ describe('analyzeCodebase', () => {
                 durationSeconds: expect.any(Number),
                 finishTime: expect.any(Number),
                 startTime: expect.any(Number),
+                memoryUsage: expect.any(Object),
                 options: expect.any(Object),
                 telemetryData: expect.any(Object),
+                repoUrl: expect.any(String),
                 repoXFIConfig: expect.objectContaining({
                     sensitiveFileFalsePositives: expect.any(Array)
                 })
@@ -305,7 +310,7 @@ describe('analyzeCodebase', () => {
             XFI_RESULT: expect.objectContaining({
                 archetype: 'node-fullstack',
                 repoPath: 'mockRepoPath',
-                fileCount: 3,
+                fileCount: expect.any(Number),
                 totalIssues: 3,
                 warningCount: 0,
                 fatalityCount: 3,
@@ -321,8 +326,11 @@ describe('analyzeCodebase', () => {
                 durationSeconds: expect.any(Number),
                 finishTime: expect.any(Number),
                 startTime: expect.any(Number),
+                memoryUsage: expect.any(Object),
                 options: expect.any(Object),
                 telemetryData: expect.any(Object),
+                repoUrl: expect.any(String),
+                repoXFIConfig: expect.any(Object)
             })
         });
         expect(telemetry_1.sendTelemetry).toHaveBeenCalledTimes(2); // Start and end

package/dist/core/engine/engineRunner.js

@@ -20,13 +20,15 @@ function runEngineOnFiles(params) {
         const msg = `\n==========================\nRUNNING FILE CHECKS..\n==========================`;
         logger_1.logger.info(msg);
         const failures = [];
-        for (const file of fileData) {
+        const fileCount = fileData.length;
+        for (let i = 0; i < fileCount; i++) {
+            const file = fileData[i];
             if (file.fileName === configManager_1.REPO_GLOBAL_CHECK) {
                 const msg = `\n==========================\nRUNNING GLOBAL REPO CHECKS..\n==========================`;
                 logger_1.logger.info(msg);
             }
             else {
-                const msg = `analysing ${file.filePath} ...`;
+                const msg = `analysing (${i + 1} of ${fileCount - 1}) ${file.filePath} ...`;
                 logger_1.logger.info(msg);
             }
             const facts = {

package/dist/demoConfig/node-fullstack.json

@@ -8,7 +8,8 @@
         "openaiAnalysisTop5-global",
         "openaiAnalysisA11y-global",
         "invalidSystemIdConfigured-iterative",
-        "missingRequiredFiles-global"
+        "missingRequiredFiles-global",
+        "regexMatch-example-iterative"
     ],
     "operators": [
         "fileContains",
@@ -16,7 +17,8 @@
         "nonStandardDirectoryStructure",
         "openaiAnalysisHighSeverity",
         "invalidRemoteValidation",
-        "missingRequiredFiles"
+        "missingRequiredFiles",
+        "regexMatch"
     ],
     "facts": [
         "repoFilesystemFacts",

package/dist/demoConfig/rules/regexMatch-example-iterative-rule.json

@@ -0,0 +1,28 @@
+{
+    "name": "regexMatch-example",
+    "conditions": {
+        "all": [
+            {
+                "fact": "fileData",
+                "path": "$.filePath",
+                "operator": "regexMatch",
+                "value": ".*/facts/.*"
+            },
+            {
+                "fact": "fileData",
+                "path": "$.fileContent",
+                "operator": "regexMatch",
+                "value": "OpenAI"
+            }
+        ]
+    },
+    "event": {
+        "type": "warning",
+        "params": {
+            "message": "I'm seeing a pattern here..",
+            "details": {
+                "suggestion": "wake up and smell the coffee"
+            }
+        }
+    }
+}

package/dist/demoConfig/rules/sensitiveLogging-iterative-rule.json

@@ -26,7 +26,8 @@
                         "(password|passphrase)",
                         "(private[_-]?key|ssh[_-]?key)",
                         "(oauth[_-]?token|jwt[_-]?token)",
-                        "db[_-]?password"
+                        "db[_-]?password",
+                        "(declare)"
                     ],
                     "resultFact": "fileResults"
                 },

package/dist/facts/repoDependencyFacts.js

@@ -76,7 +76,6 @@ function collectLocalDependencies() {
         else {
             logger_1.logger.error('No yarn.lock or package-lock.json found');
             process.exit(1);
-            throw new Error('Unsupported package manager');
         }
         logger_1.logger.trace(`collectLocalDependencies: ${(0, utils_1.safeStringify)(result)}`);
         return result;

package/dist/index.js

@@ -54,7 +54,6 @@ exports.main = main;
 const logger_1 = require("./utils/logger");
 const cli_1 = require("./core/cli");
 if (require.main === module) {
-    (0, logger_1.initializeLogger)();
     (0, logger_1.setLogLevel)(process.env.XFI_LOG_LEVEL || 'info');
     (0, cli_1.initCLI)();
 }
@@ -71,7 +70,8 @@ const handleError = (error) => __awaiter(void 0, void 0, void 0, function* () {
             archetype: cli_1.options.archetype,
             repoPath: cli_1.options.dir,
             options: cli_1.options,
-            errorMessage: error.message
+            errorMessage: error.message,
+            errorStack: error.stack
         },
         timestamp: new Date().toISOString()
     }, executionLogPrefix);
@@ -101,38 +101,41 @@ function main() {
                         localConfigPath: cli_1.options.localConfigPath,
                         executionLogPrefix
                     });
+                    const resultString = JSON.stringify(resultMetadata);
+                    const prettyResult = prettyjson_1.default.render(resultMetadata.XFI_RESULT);
                     // if results are found, there were issues found in the codebase
                     if (resultMetadata.XFI_RESULT.totalIssues > 0) {
                         logger_1.logger.warn(`WARNING: lo-fi attributes detected in codebase. ${resultMetadata.XFI_RESULT.warningCount} are warnings, ${resultMetadata.XFI_RESULT.fatalityCount} are fatal.`);
-                        logger_1.logger.warn(JSON.stringify(resultMetadata));
+                        logger_1.logger.warn(resultString);
                         if (resultMetadata.XFI_RESULT.errorCount > 0) {
                             logger_1.logger.error(outcomeMessage(`THERE WERE ${resultMetadata.XFI_RESULT.errorCount} UNEXPECTED ERRORS!`));
-                            logger_1.logger.error(`\n${prettyjson_1.default.render(resultMetadata.XFI_RESULT)}\n\n`);
+                            logger_1.logger.error(`\n${prettyResult}\n\n`);
                             logger_1.logger.error(outcomeMessage(`THERE WERE ${resultMetadata.XFI_RESULT.errorCount} UNEXPECTED ERRORS!`));
                             process.exit(1);
                         }
                         if (resultMetadata.XFI_RESULT.fatalityCount > 0) {
                             logger_1.logger.error(outcomeMessage(`THERE WERE ${resultMetadata.XFI_RESULT.fatalityCount} FATAL ERRORS DETECTED TO BE IMMEDIATELY ADDRESSED!`));
-                            logger_1.logger.error(`\n${prettyjson_1.default.render(resultMetadata.XFI_RESULT)}\n\n`);
+                            logger_1.logger.error(`\n${prettyResult}\n\n`);
                             logger_1.logger.error(outcomeMessage(`THERE WERE ${resultMetadata.XFI_RESULT.fatalityCount} FATAL ERRORS DETECTED TO BE IMMEDIATELY ADDRESSED!`));
                             process.exit(1);
                         }
                         else {
                             logger_1.logger.warn(outcomeMessage('No fatal errors were found, however please review the following warnings.'));
-                            logger_1.logger.warn(`\n${prettyjson_1.default.render(resultMetadata.XFI_RESULT)}\n\n`);
+                            logger_1.logger.warn(`\n${prettyResult}\n\n`);
                             logger_1.logger.warn(outcomeMessage('No fatal errors were found, however please review the above warnings.'));
                         }
                     }
                     else {
                         logger_1.logger.info(outcomeMessage('SUCCESS! hi-fi codebase detected.'));
-                        logger_1.logger.info(JSON.stringify(resultMetadata));
-                        logger_1.logger.info(`\n${prettyjson_1.default.render(resultMetadata)}\n\n`);
+                        logger_1.logger.info(resultString);
+                        logger_1.logger.info(`\n${prettyResult}\n\n`);
                         logger_1.logger.info(outcomeMessage('SUCCESS! hi-fi codebase detected.'));
                     }
                 }
             }
         }
         catch (e) {
+            logger_1.logger.error(e, `Error during execution ${JSON.stringify(e.message)} \n ${e.stack}`);
             yield handleError(e).then(() => {
                 // give some time async ops to finish if not handled directly
                 if (process.env.NODE_ENV !== 'test') {

package/dist/operators/index.js

@@ -14,6 +14,7 @@ const outdatedFramework_1 = require("./outdatedFramework");
 const fileContains_1 = require("./fileContains");
 const nonStandardDirectoryStructure_1 = require("./nonStandardDirectoryStructure");
 const openaiAnalysisHighSeverity_1 = require("./openaiAnalysisHighSeverity");
+const regexMatch_1 = require("./regexMatch");
 const openaiUtils_1 = require("../utils/openaiUtils");
 const logger_1 = require("../utils/logger");
 const pluginRegistry_1 = require("../core/pluginRegistry");
@@ -23,7 +24,8 @@ function loadOperators(operatorNames) {
         const allAvailableOperators = Object.assign({ outdatedFramework: outdatedFramework_1.outdatedFramework,
             fileContains: fileContains_1.fileContains,
             nonStandardDirectoryStructure: nonStandardDirectoryStructure_1.nonStandardDirectoryStructure,
-            openaiAnalysisHighSeverity: openaiAnalysisHighSeverity_1.openaiAnalysisHighSeverity }, Object.fromEntries(pluginRegistry_1.pluginRegistry.getPluginOperators().map(op => [op.name, op])));
+            openaiAnalysisHighSeverity: openaiAnalysisHighSeverity_1.openaiAnalysisHighSeverity,
+            regexMatch: regexMatch_1.regexMatch }, Object.fromEntries(pluginRegistry_1.pluginRegistry.getPluginOperators().map(op => [op.name, op])));
         const openAIStatus = (0, openaiUtils_1.getOpenAIStatus)();
         logger_1.logger.info(`Loading operators: ${operatorNames.join(', ')}`);
         const loadedOperators = [];

package/dist/operators/nonStandardDirectoryStructure.js

@@ -16,7 +16,7 @@ const nonStandardDirectoryStructure = {
         if (filePath !== configManager_1.REPO_GLOBAL_CHECK) {
             return false;
         }
-        logger_1.logger.debug(`running global directory structure analysis..`);
+        logger_1.logger.info(`running global directory structure analysis..`);
         const repoPath = cli_1.options.dir || process.cwd();
         let result = false;
         // check the directory structure of the repo against the standard structure

package/dist/operators/regexMatch.d.ts

@@ -0,0 +1,10 @@
+import { OperatorDefn } from '../types/typeDefs';
+/**
+ * Operator that tests if a string matches a regular expression pattern
+ *
+ * @param factValue - The string to test against the regex pattern
+ * @param regexPattern - The regex pattern to test against (as a string)
+ * @returns true if the string matches the pattern, false otherwise
+ */
+declare const regexMatch: OperatorDefn;
+export { regexMatch };

package/dist/operators/regexMatch.js

@@ -0,0 +1,46 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.regexMatch = void 0;
+const logger_1 = require("../utils/logger");
+/**
+ * Operator that tests if a string matches a regular expression pattern
+ *
+ * @param factValue - The string to test against the regex pattern
+ * @param regexPattern - The regex pattern to test against (as a string)
+ * @returns true if the string matches the pattern, false otherwise
+ */
+const regexMatch = {
+    'name': 'regexMatch',
+    'fn': (factValue, regexPattern) => {
+        try {
+            logger_1.logger.debug(`regexMatch: testing ${factValue} against pattern ${regexPattern}`);
+            if (factValue === undefined || factValue === null) {
+                logger_1.logger.debug('regexMatch: factValue is undefined or null');
+                return false;
+            }
+            if (typeof regexPattern !== 'string') {
+                logger_1.logger.debug(`regexMatch: regexPattern is not a string: ${typeof regexPattern}`);
+                return false;
+            }
+            // Extract flags if they exist (pattern/flags format)
+            let flags = '';
+            let pattern = regexPattern;
+            // Check if the pattern is in /pattern/flags format
+            const regexFormatMatch = /^\/(.+)\/([gimsuyd]*)$/.exec(regexPattern);
+            if (regexFormatMatch) {
+                pattern = regexFormatMatch[1];
+                flags = regexFormatMatch[2];
+                logger_1.logger.debug(`regexMatch: extracted pattern "${pattern}" with flags "${flags}"`);
+            }
+            const regex = new RegExp(pattern, flags);
+            const result = regex.test(String(factValue));
+            logger_1.logger.debug(`regexMatch: result is ${result}`);
+            return result;
+        }
+        catch (e) {
+            logger_1.logger.error(`regexMatch error: ${e}`);
+            return false;
+        }
+    }
+};
+exports.regexMatch = regexMatch;

package/dist/operators/regexMatch.test.d.ts

@@ -0,0 +1 @@
+export {};

package/dist/operators/regexMatch.test.js

@@ -0,0 +1,52 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+const regexMatch_1 = require("./regexMatch");
+const logger_1 = require("../utils/logger");
+jest.mock('../utils/logger', () => ({
+    logger: {
+        debug: jest.fn(),
+        error: jest.fn()
+    },
+}));
+describe('regexMatch', () => {
+    beforeEach(() => {
+        jest.clearAllMocks();
+    });
+    it('should return true when the string matches the pattern', () => {
+        expect(regexMatch_1.regexMatch.fn('hello world', 'hello')).toBe(true);
+        expect(regexMatch_1.regexMatch.fn('hello world', 'world$')).toBe(true);
+        expect(regexMatch_1.regexMatch.fn('hello world', '^hello')).toBe(true);
+        expect(logger_1.logger.debug).toHaveBeenCalledWith(expect.stringContaining('result is true'));
+    });
+    it('should return false when the string does not match the pattern', () => {
+        expect(regexMatch_1.regexMatch.fn('hello world', 'goodbye')).toBe(false);
+        expect(regexMatch_1.regexMatch.fn('hello world', '^world')).toBe(false);
+        expect(regexMatch_1.regexMatch.fn('hello world', 'hello$')).toBe(false);
+        expect(logger_1.logger.debug).toHaveBeenCalledWith(expect.stringContaining('result is false'));
+    });
+    it('should handle regex flags correctly', () => {
+        expect(regexMatch_1.regexMatch.fn('Hello World', '/hello/i')).toBe(true);
+        expect(regexMatch_1.regexMatch.fn('Hello\nWorld', '/hello.*world/is')).toBe(true);
+        expect(regexMatch_1.regexMatch.fn('Hello World', '/hello world/i')).toBe(true);
+    });
+    it('should handle undefined or null factValue', () => {
+        expect(regexMatch_1.regexMatch.fn(undefined, 'test')).toBe(false);
+        expect(regexMatch_1.regexMatch.fn(null, 'test')).toBe(false);
+        expect(logger_1.logger.debug).toHaveBeenCalledWith('regexMatch: factValue is undefined or null');
+    });
+    it('should handle non-string regexPattern', () => {
+        expect(regexMatch_1.regexMatch.fn('test', null)).toBe(false);
+        expect(regexMatch_1.regexMatch.fn('test', undefined)).toBe(false);
+        expect(regexMatch_1.regexMatch.fn('test', 123)).toBe(false);
+        expect(logger_1.logger.debug).toHaveBeenCalledWith(expect.stringContaining('regexPattern is not a string'));
+    });
+    it('should handle invalid regex patterns gracefully', () => {
+        expect(regexMatch_1.regexMatch.fn('test', '[')).toBe(false);
+        expect(logger_1.logger.error).toHaveBeenCalledWith(expect.stringContaining('regexMatch error'));
+    });
+    it('should handle non-string factValues by converting them to strings', () => {
+        expect(regexMatch_1.regexMatch.fn(123, '123')).toBe(true);
+        expect(regexMatch_1.regexMatch.fn(true, 'true')).toBe(true);
+        expect(regexMatch_1.regexMatch.fn({ toString: () => 'custom' }, 'custom')).toBe(true);
+    });
+});

package/dist/types/typeDefs.d.ts

@@ -128,6 +128,7 @@ export interface BasicTelemetryMetadata {
     telemetryData?: TelemetryData;
     errorMessage?: string;
     options?: any;
+    errorStack?: string;
 }
 export interface ExemptionTelemetryMetadata {
     repoUrl: string;
@@ -168,6 +169,8 @@ export interface ResultMetadata {
         telemetryData: TelemetryData;
         options: any;
         repoXFIConfig: RepoXFIConfig;
+        memoryUsage: any;
+        repoUrl: string;
     };
 }
 export interface TelemetryData {

package/dist/utils/logger.js

@@ -18,7 +18,7 @@ const maskSensitiveData_1 = require("./maskSensitiveData");
 let loggerInstance;
 let loglevel = process.env.XFI_LOG_LEVEL ||
     (process.env.NODE_ENV === 'test' ? 'silent' : 'info');
-let logPrefix;
+let logPrefix = generateLogPrefix();
 // Initialize logger and prefix immediately
 function initializeLogger() {
     logPrefix = generateLogPrefix();
@@ -29,15 +29,9 @@ function generateLogPrefix() {
 }
 function resetLogPrefix() {
     logPrefix = generateLogPrefix();
-    if (loggerInstance) {
-        loggerInstance = loggerInstance.child({ prefix: logPrefix });
-    }
 }
 function setLogPrefix(prefix) {
     logPrefix = prefix;
-    if (loggerInstance) {
-        loggerInstance = loggerInstance.child({ prefix: logPrefix });
-    }
 }
 function getLogPrefix() {
     return logPrefix;
@@ -54,21 +48,22 @@ function getLogger(force) {
             target: 'pino-pretty',
             options: {
                 loglevel: loglevel,
+                sync: false,
                 colorize: true,
                 translateTime: 'SYS:yyyy-mm-dd HH:MM:ss.l o',
                 ignore: 'pid,hostname',
-                messageFormat: '{prefix} - {msg}',
                 singleLine: true,
                 errorProps: '*'
             }
         });
         const loggerOptions = {
             timestamp: pino_1.default.stdTimeFunctions.isoTime,
+            msgPrefix: `${logPrefix} - `,
             level: 'info',
             formatters: {
                 level: (label) => ({ level: label }),
                 bindings: (bindings) => bindings,
-                log: (object) => (Object.assign({ prefix: logPrefix }, object))
+                log: (object) => (Object.assign({}, object))
             },
             serializers: {
                 err: (err) => pino_1.default.stdSerializers.err,

package/dist/xfidelity

@@ -54,7 +54,6 @@ exports.main = main;
 const logger_1 = require("./utils/logger");
 const cli_1 = require("./core/cli");
 if (require.main === module) {
-    (0, logger_1.initializeLogger)();
     (0, logger_1.setLogLevel)(process.env.XFI_LOG_LEVEL || 'info');
     (0, cli_1.initCLI)();
 }
@@ -71,7 +70,8 @@ const handleError = (error) => __awaiter(void 0, void 0, void 0, function* () {
             archetype: cli_1.options.archetype,
             repoPath: cli_1.options.dir,
             options: cli_1.options,
-            errorMessage: error.message
+            errorMessage: error.message,
+            errorStack: error.stack
         },
         timestamp: new Date().toISOString()
     }, executionLogPrefix);
@@ -101,38 +101,41 @@ function main() {
                         localConfigPath: cli_1.options.localConfigPath,
                         executionLogPrefix
                     });
+                    const resultString = JSON.stringify(resultMetadata);
+                    const prettyResult = prettyjson_1.default.render(resultMetadata.XFI_RESULT);
                     // if results are found, there were issues found in the codebase
                     if (resultMetadata.XFI_RESULT.totalIssues > 0) {
                         logger_1.logger.warn(`WARNING: lo-fi attributes detected in codebase. ${resultMetadata.XFI_RESULT.warningCount} are warnings, ${resultMetadata.XFI_RESULT.fatalityCount} are fatal.`);
-                        logger_1.logger.warn(JSON.stringify(resultMetadata));
+                        logger_1.logger.warn(resultString);
                         if (resultMetadata.XFI_RESULT.errorCount > 0) {
                             logger_1.logger.error(outcomeMessage(`THERE WERE ${resultMetadata.XFI_RESULT.errorCount} UNEXPECTED ERRORS!`));
-                            logger_1.logger.error(`\n${prettyjson_1.default.render(resultMetadata.XFI_RESULT)}\n\n`);
+                            logger_1.logger.error(`\n${prettyResult}\n\n`);
                             logger_1.logger.error(outcomeMessage(`THERE WERE ${resultMetadata.XFI_RESULT.errorCount} UNEXPECTED ERRORS!`));
                             process.exit(1);
                         }
                         if (resultMetadata.XFI_RESULT.fatalityCount > 0) {
                             logger_1.logger.error(outcomeMessage(`THERE WERE ${resultMetadata.XFI_RESULT.fatalityCount} FATAL ERRORS DETECTED TO BE IMMEDIATELY ADDRESSED!`));
-                            logger_1.logger.error(`\n${prettyjson_1.default.render(resultMetadata.XFI_RESULT)}\n\n`);
+                            logger_1.logger.error(`\n${prettyResult}\n\n`);
                             logger_1.logger.error(outcomeMessage(`THERE WERE ${resultMetadata.XFI_RESULT.fatalityCount} FATAL ERRORS DETECTED TO BE IMMEDIATELY ADDRESSED!`));
                             process.exit(1);
                         }
                         else {
                             logger_1.logger.warn(outcomeMessage('No fatal errors were found, however please review the following warnings.'));
-                            logger_1.logger.warn(`\n${prettyjson_1.default.render(resultMetadata.XFI_RESULT)}\n\n`);
+                            logger_1.logger.warn(`\n${prettyResult}\n\n`);
                             logger_1.logger.warn(outcomeMessage('No fatal errors were found, however please review the above warnings.'));
                         }
                     }
                     else {
                         logger_1.logger.info(outcomeMessage('SUCCESS! hi-fi codebase detected.'));
-                        logger_1.logger.info(JSON.stringify(resultMetadata));
-                        logger_1.logger.info(`\n${prettyjson_1.default.render(resultMetadata)}\n\n`);
+                        logger_1.logger.info(resultString);
+                        logger_1.logger.info(`\n${prettyResult}\n\n`);
                         logger_1.logger.info(outcomeMessage('SUCCESS! hi-fi codebase detected.'));
                     }
                 }
             }
         }
         catch (e) {
+            logger_1.logger.error(e, `Error during execution ${JSON.stringify(e.message)} \n ${e.stack}`);
             yield handleError(e).then(() => {
                 // give some time async ops to finish if not handled directly
                 if (process.env.NODE_ENV !== 'test') {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "x-fidelity",
-  "version": "3.3.0",
+  "version": "3.4.0",
   "description": "cli for opinionated framework adherence checks",
   "main": "dist/index",
   "types": "dist/index.d.ts",
@@ -40,7 +40,7 @@
   "author": "wyvern8 <io@zoto.io>",
   "license": "MIT",
   "engines": {
-    "node": ">=20.0.0",
+    "node": ">=18.0.0",
     "yarn": ">=1.22.0"
   },
   "devDependencies": {

package/src/core/cli.ts

@@ -11,6 +11,19 @@ export const options = program.opts();
 
 export function initCLI() {
 
+    const bannerArt = `\n
+=====================================
+ __    __          ________  ______ 
+| ##  | ##        | ######## \\######
+ \\##\\/  ## ______ | ##__      | ##  
+  >##  ## |      \\| ##  \\     | ##  
+ /  ####\\  \\######| ######    | ##  
+|  ## \\##\\        | ##       _| ##_ 
+| ##  | ##        | ##      |   ## \\
+ \\##   \\##         \\##       \\######
+------------------------------------- 
+`;
+
     // Ensure logger is initialized
     if (!logger || typeof logger.info !== 'function') {
         console.error({ msg: 'Logger is not properly initialized' });
@@ -37,7 +50,7 @@ export function initCLI() {
     });
 
     program
-        .option("-d, --dir <directory>", "code directory to analyze. equivalent of directory argument")
+        .option("-d, --dir <directory>", "local git repo directory path to analyze. equivalent of directory argument")
         .option("-a, --archetype <archetype>", "The archetype to use for analysis", "node-fullstack")
         .option("-c, --configServer <configServer>", "The config server URL for fetching remote archetype configurations and rules. This takes precedence over localConfigPath.")
         .option("-o, --openaiEnabled <boolean>", "Enable OpenAI analysis", false)
@@ -50,8 +63,11 @@ export function initCLI() {
         .option("-x, --examine <archetype>", "Examine the archetype configuration and rules")
         .version(version, "-v, --version", "Output the version number of xfidelity")
         .helpOption("-h, --help", "Display help for command")
-        .argument('[directory]', 'code directory to analyze');
-
+        .summary("CLI for analyzing codebases for architectural fidelity")
+        .usage("[directory] [options]")
+        .argument('[directory]', 'local git repo directory path to analyze')
+        .addHelpText('before', bannerArt)
+        .addHelpText('after', '-------------------------------------');
     
 
     program.parse(process.argv);
@@ -88,18 +104,18 @@ export function initCLI() {
         if (process.env.NODE_ENV !== 'test') program.error(`LocalConfigPath does not exist or is invalid: ${error}`);
     }
 
-const bannerArt = `\n
-=====================================
- __    __          ________  ______ 
-| ##  | ##        | ######## \\######
- \\##\\/  ## ______ | ##__      | ##  
-  >##  ## |      \\| ##  \\     | ##  
- /  ####\\  \\######| ######    | ##  
-|  ## \\##\\        | ##       _| ##_ 
-| ##  | ##        | ##      |   ## \\
- \\##   \\##         \\##       \\######
-------------------------------------- 
-`;
+// const bannerArt = `\n
+// =====================================
+//  __    __          ________  ______ 
+// | ##  | ##        | ######## \\######
+//  \\##\\/  ## ______ | ##__      | ##  
+//   >##  ## |      \\| ##  \\     | ##  
+//  /  ####\\  \\######| ######    | ##  
+// |  ## \\##\\        | ##       _| ##_ 
+// | ##  | ##        | ##      |   ## \\
+//  \\##   \\##         \\##       \\######
+// ------------------------------------- 
+// `;
 
     logger.info(bannerArt);
 

package/src/core/engine/analyzer.test.ts

@@ -108,15 +108,17 @@ describe('analyzeCodebase', () => {
             XFI_RESULT: expect.objectContaining({
                 archetype: 'node-fullstack',
                 repoPath: 'mockRepoPath',
-                fileCount: 3,
+                fileCount: expect.any(Number),
                 totalIssues: expect.any(Number),
                 warningCount: expect.any(Number),
                 fatalityCount: expect.any(Number),
+                errorCount: expect.any(Number),
                 exemptCount: expect.any(Number),
                 issueDetails: expect.any(Array),
                 durationSeconds: expect.any(Number),
                 finishTime: expect.any(Number),
                 startTime: expect.any(Number),
+                memoryUsage: expect.any(Object),
                 options: expect.objectContaining({
                     archetype: 'node-fullstack',
                     configServer: '',
@@ -134,6 +136,7 @@ describe('analyzeCodebase', () => {
                     startTime: expect.any(Number),
                     userInfo: expect.any(Object),
                 }),
+                repoUrl: expect.any(String),
                 repoXFIConfig: expect.objectContaining({
                     sensitiveFileFalsePositives: expect.any(Array),
                 })
@@ -184,7 +187,7 @@ describe('analyzeCodebase', () => {
             XFI_RESULT: expect.objectContaining({
                 archetype: 'node-fullstack',
                 repoPath: 'mockRepoPath',
-                fileCount: 3,
+                fileCount: expect.any(Number),
                 totalIssues: 3,
                 warningCount: 0,
                 fatalityCount: 0,
@@ -209,8 +212,10 @@ describe('analyzeCodebase', () => {
                 durationSeconds: expect.any(Number),
                 finishTime: expect.any(Number),
                 startTime: expect.any(Number),
+                memoryUsage: expect.any(Object),
                 options: expect.any(Object),
                 telemetryData: expect.any(Object),
+                repoUrl: expect.any(String),
                 repoXFIConfig: expect.objectContaining({
                     sensitiveFileFalsePositives: expect.any(Array)
                 })
@@ -326,7 +331,7 @@ describe('analyzeCodebase', () => {
             XFI_RESULT: expect.objectContaining({
                 archetype: 'node-fullstack',
                 repoPath: 'mockRepoPath',
-                fileCount: 3,
+                fileCount: expect.any(Number),
                 totalIssues: 3,
                 warningCount: 0,
                 fatalityCount: 3,
@@ -342,8 +347,11 @@ describe('analyzeCodebase', () => {
                 durationSeconds: expect.any(Number),
                 finishTime: expect.any(Number),
                 startTime: expect.any(Number),
+                memoryUsage: expect.any(Object),
                 options: expect.any(Object),
                 telemetryData: expect.any(Object),
+                repoUrl: expect.any(String),
+                repoXFIConfig: expect.any(Object)
             })
         });
         expect(sendTelemetry).toHaveBeenCalledTimes(2); // Start and end

package/src/core/engine/analyzer.ts

@@ -95,7 +95,7 @@ export async function analyzeCodebase(params: AnalyzeCodebaseParams): Promise<Re
     logger.info(finishMsg);
 
     const totalFailureCount = countRuleFailures(failures);
-    logger.info(`${fileData.length} files analyzed. ${totalFailureCount} rule failures.`);
+    logger.info(`${fileData.length -1} files analyzed. ${totalFailureCount} rule failures.`);
 
     const fatalityCount = countRuleFailures(failures, 'fatality');
     const warningCount = countRuleFailures(failures, 'warning');
@@ -103,17 +103,21 @@ export async function analyzeCodebase(params: AnalyzeCodebaseParams): Promise<Re
     const errorCount = countRuleFailures(failures, 'error');
 
     const finishTime = new Date().getTime();
+    const memoryUsage = process.memoryUsage();
+
+    logger.info('Assemblying result metadata..');
 
     const resultMetadata: ResultMetadata = {
         XFI_RESULT: {
             archetype,
             telemetryData,
+            memoryUsage,
             repoXFIConfig: repoXFIConfig,
             issueDetails: failures,
             startTime: telemetryData.startTime,
             finishTime: finishTime,
             durationSeconds: (finishTime - telemetryData.startTime) / 1000,
-            fileCount: fileData.length,
+            fileCount: fileData.length -1,
             totalIssues: totalFailureCount,
             warningCount: warningCount,
             fatalityCount: fatalityCount,
@@ -121,6 +125,7 @@ export async function analyzeCodebase(params: AnalyzeCodebaseParams): Promise<Re
             exemptCount: exemptCount,
             options,
             repoPath,
+            repoUrl
         }
     }
     

package/src/core/engine/engineRunner.ts

@@ -10,13 +10,15 @@ export async function runEngineOnFiles(params: RunEngineOnFilesParams): Promise<
     const msg = `\n==========================\nRUNNING FILE CHECKS..\n==========================`;
     logger.info(msg);
     const failures: ScanResult[] = [];
+    const fileCount = fileData.length;
 
-    for (const file of fileData) {
+    for (let i=0; i < fileCount; i++) {
+        const file = fileData[i]
         if (file.fileName === REPO_GLOBAL_CHECK) {
             const msg = `\n==========================\nRUNNING GLOBAL REPO CHECKS..\n==========================`;
             logger.info(msg);
         } else {
-            const msg = `analysing ${file.filePath} ...`
+            const msg = `analysing (${i+1} of ${fileCount-1}) ${file.filePath} ...`
             logger.info(msg);
         }
         const facts = {

package/src/demoConfig/node-fullstack.json

@@ -8,7 +8,8 @@
         "openaiAnalysisTop5-global",
         "openaiAnalysisA11y-global",
         "invalidSystemIdConfigured-iterative",
-        "missingRequiredFiles-global"
+        "missingRequiredFiles-global",
+        "regexMatch-example-iterative"
     ],
     "operators": [
         "fileContains",
@@ -16,7 +17,8 @@
         "nonStandardDirectoryStructure",
         "openaiAnalysisHighSeverity",
         "invalidRemoteValidation",
-        "missingRequiredFiles"
+        "missingRequiredFiles",
+        "regexMatch"
     ],
     "facts": [
         "repoFilesystemFacts",

package/src/demoConfig/rules/regexMatch-example-iterative-rule.json

@@ -0,0 +1,28 @@
+{
+    "name": "regexMatch-example",
+    "conditions": {
+        "all": [
+            {
+                "fact": "fileData",
+                "path": "$.filePath",
+                "operator": "regexMatch",
+                "value": ".*/facts/.*"
+            },
+            {
+                "fact": "fileData",
+                "path": "$.fileContent",
+                "operator": "regexMatch",
+                "value": "OpenAI"
+            }
+        ]
+    },
+    "event": {
+        "type": "warning",
+        "params": {
+            "message": "I'm seeing a pattern here..",
+            "details": {
+                "suggestion": "wake up and smell the coffee"
+            }
+        }
+    }
+}

package/src/demoConfig/rules/sensitiveLogging-iterative-rule.json

@@ -26,7 +26,8 @@
                         "(password|passphrase)",
                         "(private[_-]?key|ssh[_-]?key)",
                         "(oauth[_-]?token|jwt[_-]?token)",
-                        "db[_-]?password"
+                        "db[_-]?password",
+                        "(declare)"
                     ],
                     "resultFact": "fileResults"
                 },

package/src/facts/repoDependencyFacts.ts

@@ -25,7 +25,6 @@ export async function collectLocalDependencies(): Promise<LocalDependencies[]> {
     } else {
         logger.error('No yarn.lock or package-lock.json found');
         process.exit(1);
-        throw new Error('Unsupported package manager');
     }
     logger.trace(`collectLocalDependencies: ${safeStringify(result)}`);
     return result;

package/src/index.ts

@@ -1,8 +1,7 @@
 #!/usr/bin/env node
-import { logger, initializeLogger, getLogPrefix, setLogLevel } from './utils/logger';
+import { logger, getLogPrefix, setLogLevel } from './utils/logger';
 import { options, initCLI } from "./core/cli";
 if (require.main === module) {
-    initializeLogger()
     setLogLevel(process.env.XFI_LOG_LEVEL || 'info');
     initCLI();
 }
@@ -23,7 +22,8 @@ const handleError = async (error: Error) => {
             archetype: options.archetype,
             repoPath: options.dir,
             options,
-            errorMessage: error.message
+            errorMessage: error.message,
+            errorStack: error.stack
         },
         timestamp: new Date().toISOString()
     }, executionLogPrefix);
@@ -54,43 +54,47 @@ export async function main() {
                     executionLogPrefix
                 });
 
+                const resultString = JSON.stringify(resultMetadata);
+                const prettyResult = json.render(resultMetadata.XFI_RESULT);
+
                 // if results are found, there were issues found in the codebase
                 if (resultMetadata.XFI_RESULT.totalIssues > 0) {
                     logger.warn(`WARNING: lo-fi attributes detected in codebase. ${resultMetadata.XFI_RESULT.warningCount} are warnings, ${resultMetadata.XFI_RESULT.fatalityCount} are fatal.`);
-                    logger.warn(JSON.stringify(resultMetadata));
+                    logger.warn(resultString);
 
                     if (resultMetadata.XFI_RESULT.errorCount > 0) {
                         logger.error(outcomeMessage(`THERE WERE ${resultMetadata.XFI_RESULT.errorCount} UNEXPECTED ERRORS!`));
-                        logger.error(`\n${json.render(resultMetadata.XFI_RESULT)}\n\n`);
+                        logger.error(`\n${prettyResult}\n\n`);
                         logger.error(outcomeMessage(`THERE WERE ${resultMetadata.XFI_RESULT.errorCount} UNEXPECTED ERRORS!`));
                         process.exit(1);
                     }
 
                     if (resultMetadata.XFI_RESULT.fatalityCount > 0) {
                         logger.error(outcomeMessage(`THERE WERE ${resultMetadata.XFI_RESULT.fatalityCount} FATAL ERRORS DETECTED TO BE IMMEDIATELY ADDRESSED!`));
-                        logger.error(`\n${json.render(resultMetadata.XFI_RESULT)}\n\n`);
+                        logger.error(`\n${prettyResult}\n\n`);
                         logger.error(outcomeMessage(`THERE WERE ${resultMetadata.XFI_RESULT.fatalityCount} FATAL ERRORS DETECTED TO BE IMMEDIATELY ADDRESSED!`));
                         process.exit(1);
                     } else {
                         logger.warn(outcomeMessage('No fatal errors were found, however please review the following warnings.'));
-                        logger.warn(`\n${json.render(resultMetadata.XFI_RESULT)}\n\n`);
+                        logger.warn(`\n${prettyResult}\n\n`);
                         logger.warn(outcomeMessage('No fatal errors were found, however please review the above warnings.'));
                     }
                 } else {
                     logger.info(outcomeMessage('SUCCESS! hi-fi codebase detected.'));
-                    logger.info(JSON.stringify(resultMetadata));
-                    logger.info(`\n${json.render(resultMetadata)}\n\n`);
+                    logger.info(resultString);
+                    logger.info(`\n${prettyResult}\n\n`);
                     logger.info(outcomeMessage('SUCCESS! hi-fi codebase detected.'));
                 }
             }
         }    
     } catch (e: any) {
+        logger.error(e, `Error during execution ${JSON.stringify(e.message)} \n ${e.stack}`);
         await handleError(e).then(() => {
             // give some time async ops to finish if not handled directly
             if (process.env.NODE_ENV !== 'test') {
-                setTimeout(() => {
+                setTimeout(() => { //todo fix this
                     process.exit(1);
-                }, 3000);
+                },  3000);
             }
         });    
     }

package/src/operators/index.ts

@@ -3,6 +3,7 @@ import { outdatedFramework } from './outdatedFramework';
 import { fileContains } from './fileContains';
 import { nonStandardDirectoryStructure } from './nonStandardDirectoryStructure';
 import { openaiAnalysisHighSeverity } from './openaiAnalysisHighSeverity';
+import { regexMatch } from './regexMatch';
 import { getOpenAIStatus } from '../utils/openaiUtils';
 import { logger } from '../utils/logger';
 import { pluginRegistry } from '../core/pluginRegistry';
@@ -14,6 +15,7 @@ async function loadOperators(operatorNames: string[]): Promise<OperatorDefn[]> {
         fileContains,
         nonStandardDirectoryStructure,
         openaiAnalysisHighSeverity,
+        regexMatch,
         ...Object.fromEntries(
             pluginRegistry.getPluginOperators().map(op => [op.name, op])
         )

package/src/operators/nonStandardDirectoryStructure.ts

@@ -13,7 +13,7 @@ const nonStandardDirectoryStructure: OperatorDefn = {
             return false;
         }
 
-        logger.debug(`running global directory structure analysis..`);
+        logger.info(`running global directory structure analysis..`);
 
         const repoPath = options.dir || process.cwd();
         let result = false;

package/src/operators/regexMatch.test.ts

@@ -0,0 +1,59 @@
+import { regexMatch } from './regexMatch';
+import { logger } from '../utils/logger';
+
+jest.mock('../utils/logger', () => ({
+    logger: {
+        debug: jest.fn(),
+        error: jest.fn()
+    },
+}));
+
+describe('regexMatch', () => {
+    beforeEach(() => {
+        jest.clearAllMocks();
+    });
+
+    it('should return true when the string matches the pattern', () => {
+        expect(regexMatch.fn('hello world', 'hello')).toBe(true);
+        expect(regexMatch.fn('hello world', 'world$')).toBe(true);
+        expect(regexMatch.fn('hello world', '^hello')).toBe(true);
+        expect(logger.debug).toHaveBeenCalledWith(expect.stringContaining('result is true'));
+    });
+
+    it('should return false when the string does not match the pattern', () => {
+        expect(regexMatch.fn('hello world', 'goodbye')).toBe(false);
+        expect(regexMatch.fn('hello world', '^world')).toBe(false);
+        expect(regexMatch.fn('hello world', 'hello$')).toBe(false);
+        expect(logger.debug).toHaveBeenCalledWith(expect.stringContaining('result is false'));
+    });
+
+    it('should handle regex flags correctly', () => {
+        expect(regexMatch.fn('Hello World', '/hello/i')).toBe(true);
+        expect(regexMatch.fn('Hello\nWorld', '/hello.*world/is')).toBe(true);
+        expect(regexMatch.fn('Hello World', '/hello world/i')).toBe(true);
+    });
+
+    it('should handle undefined or null factValue', () => {
+        expect(regexMatch.fn(undefined, 'test')).toBe(false);
+        expect(regexMatch.fn(null, 'test')).toBe(false);
+        expect(logger.debug).toHaveBeenCalledWith('regexMatch: factValue is undefined or null');
+    });
+
+    it('should handle non-string regexPattern', () => {
+        expect(regexMatch.fn('test', null as any)).toBe(false);
+        expect(regexMatch.fn('test', undefined as any)).toBe(false);
+        expect(regexMatch.fn('test', 123 as any)).toBe(false);
+        expect(logger.debug).toHaveBeenCalledWith(expect.stringContaining('regexPattern is not a string'));
+    });
+
+    it('should handle invalid regex patterns gracefully', () => {
+        expect(regexMatch.fn('test', '[')).toBe(false);
+        expect(logger.error).toHaveBeenCalledWith(expect.stringContaining('regexMatch error'));
+    });
+
+    it('should handle non-string factValues by converting them to strings', () => {
+        expect(regexMatch.fn(123, '123')).toBe(true);
+        expect(regexMatch.fn(true, 'true')).toBe(true);
+        expect(regexMatch.fn({ toString: () => 'custom' }, 'custom')).toBe(true);
+    });
+});

package/src/operators/regexMatch.ts

@@ -0,0 +1,51 @@
+import { logger } from '../utils/logger';
+import { OperatorDefn } from '../types/typeDefs';
+
+/**
+ * Operator that tests if a string matches a regular expression pattern
+ * 
+ * @param factValue - The string to test against the regex pattern
+ * @param regexPattern - The regex pattern to test against (as a string)
+ * @returns true if the string matches the pattern, false otherwise
+ */
+const regexMatch: OperatorDefn = {
+    'name': 'regexMatch',
+    'fn': (factValue: any, regexPattern: string) => {
+        try {
+            logger.debug(`regexMatch: testing ${factValue} against pattern ${regexPattern}`);
+            
+            if (factValue === undefined || factValue === null) {
+                logger.debug('regexMatch: factValue is undefined or null');
+                return false;
+            }
+
+            if (typeof regexPattern !== 'string') {
+                logger.debug(`regexMatch: regexPattern is not a string: ${typeof regexPattern}`);
+                return false;
+            }
+
+            // Extract flags if they exist (pattern/flags format)
+            let flags = '';
+            let pattern = regexPattern;
+            
+            // Check if the pattern is in /pattern/flags format
+            const regexFormatMatch = /^\/(.+)\/([gimsuyd]*)$/.exec(regexPattern);
+            if (regexFormatMatch) {
+                pattern = regexFormatMatch[1];
+                flags = regexFormatMatch[2];
+                logger.debug(`regexMatch: extracted pattern "${pattern}" with flags "${flags}"`);
+            }
+
+            const regex = new RegExp(pattern, flags);
+            const result = regex.test(String(factValue));
+            
+            logger.debug(`regexMatch: result is ${result}`);
+            return result;
+        } catch (e) {
+            logger.error(`regexMatch error: ${e}`);
+            return false;
+        }
+    }
+};
+
+export { regexMatch };

package/src/types/typeDefs.ts

@@ -144,7 +144,8 @@ export interface BasicTelemetryMetadata {
     repoPath: string;
     telemetryData?: TelemetryData;
     errorMessage?: string;
-    options?: any
+    options?: any;
+    errorStack?: string;
 }
 
 export interface ExemptionTelemetryMetadata {
@@ -191,6 +192,8 @@ export interface ResultMetadata {
         telemetryData: TelemetryData;
         options: any;
         repoXFIConfig: RepoXFIConfig;
+        memoryUsage: any;
+        repoUrl: string;
     };
 }
 

package/src/utils/logger.ts

@@ -6,7 +6,7 @@ import { maskSensitiveData } from './maskSensitiveData';
 let loggerInstance: pino.Logger | undefined;
 let loglevel = process.env.XFI_LOG_LEVEL || 
                   (process.env.NODE_ENV === 'test' ? 'silent' : 'info');
-let logPrefix: string;
+let logPrefix: string = generateLogPrefix();
 
 // Initialize logger and prefix immediately
 export function initializeLogger() {
@@ -20,16 +20,10 @@ export function generateLogPrefix(): string {
 
 export function resetLogPrefix(): void {
     logPrefix = generateLogPrefix();
-    if (loggerInstance) {
-        loggerInstance = loggerInstance.child({ prefix: logPrefix });
-    }
 }
 
 export function setLogPrefix(prefix: string): void {
     logPrefix = prefix;
-    if (loggerInstance) {
-        loggerInstance = loggerInstance.child({ prefix: logPrefix });
-    }
 }
 
 export function getLogPrefix(): string {
@@ -49,10 +43,10 @@ function getLogger(force?: boolean): pino.Logger {
             target: 'pino-pretty',
             options: {
                 loglevel: loglevel,
+                sync: false,
                 colorize: true,
                 translateTime: 'SYS:yyyy-mm-dd HH:MM:ss.l o',
                 ignore: 'pid,hostname',
-                messageFormat: '{prefix} - {msg}',
                 singleLine: true,
                 errorProps: '*'
             }
@@ -60,12 +54,12 @@ function getLogger(force?: boolean): pino.Logger {
 
         const loggerOptions: pino.LoggerOptions = {
             timestamp: pino.stdTimeFunctions.isoTime,
+            msgPrefix: `${logPrefix} - `,
             level: 'info',
             formatters: {
                 level: (label) => ({ level: label }),
                 bindings: (bindings) => bindings,
                 log: (object) => ({
-                    prefix: logPrefix,
                     ...object
                 })
             },