jest-test-lineage-reporter 2.1.1 → 2.1.3

package/README.md

@@ -100,17 +100,21 @@ jest-lineage mutate --threshold 90
 jest-lineage mutate --debug --debug-dir ./mutations
 ```
 
+**Note**: Mutation results are saved to `.jest-lineage-mutation-results.json`. Run `jest-lineage report` after mutation testing to generate an HTML report with mutation data included.
+
 #### `jest-lineage report`
-Generate HTML report from existing lineage data.
+Generate HTML report from existing lineage data and mutation results.
 
 ```bash
-# Generate and open report
+# Generate and open report (includes mutation results if available)
 jest-lineage report --open
 
 # Custom output path
 jest-lineage report --output coverage-report.html
 ```
 
+**Tip**: The report command automatically loads mutation results from `.jest-lineage-mutation-results.json` if available.
+
 #### `jest-lineage query <file> [line]`
 Query which tests cover specific files or lines.
 

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "jest-test-lineage-reporter",
-  "version": "2.1.1",
+  "version": "2.1.3",
   "main": "src/TestCoverageReporter.js",
   "bin": {
     "jest-lineage": "./bin/jest-lineage.js"
@@ -57,6 +57,7 @@
     "LICENSE"
   ],
   "dependencies": {
+    "@babel/runtime": "^7.28.4",
     "@modelcontextprotocol/sdk": "^0.5.0",
     "chalk": "^4.1.2",
     "cli-table3": "^0.6.3",

package/src/TestCoverageReporter.js

@@ -3104,7 +3104,7 @@ class TestCoverageReporter {
                 // Group mutations by line
                 const mutationsByLine = {};
                 fileData.mutations.forEach(mutation => {
-                    const line = mutation.line || 'unknown';
+                    const line = mutation.lineNumber || mutation.line || 'unknown';
                     if (!mutationsByLine[line]) {
                         mutationsByLine[line] = [];
                     }

package/src/cli/commands/init.js

@@ -22,6 +22,20 @@ async function initCommand(options) {
       process.exit(1);
     }
 
+    // Detect if jest-test-lineage-reporter is installed locally or globally
+    const isLocalInstall = isInstalledLocally(cwd);
+
+    if (!isLocalInstall) {
+      warning('jest-test-lineage-reporter is installed globally.');
+      warning('For best results, install it locally in your project:\n');
+      console.log('   npm install --save-dev jest-test-lineage-reporter\n');
+
+      if (!options.force) {
+        error('Global installation detected. Use --force to continue with absolute paths.');
+        process.exit(1);
+      }
+    }
+
     // Read package.json to check dependencies
     const packageJson = JSON.parse(fs.readFileSync(packageJsonPath, 'utf8'));
     const allDeps = {
@@ -51,8 +65,11 @@ async function initCommand(options) {
       if (!options.force) {
         warning(`jest.config.js already exists. Use --force to overwrite.`);
         info('Please manually add the following to your jest.config.js:');
+        const setupPath = isLocalInstall
+          ? 'jest-test-lineage-reporter/src/testSetup.js'
+          : getGlobalPackagePath('testSetup.js');
         console.log(`
-  setupFilesAfterEnv: ['jest-test-lineage-reporter/src/testSetup.js'],
+  setupFilesAfterEnv: ['${setupPath}'],
 
   reporters: [
     'default',
@@ -70,11 +87,11 @@ async function initCommand(options) {
   },
 `);
       } else {
-        createJestConfig(jestConfigPath, options);
+        createJestConfig(jestConfigPath, options, isLocalInstall);
         jestConfigCreated = true;
       }
     } else {
-      createJestConfig(jestConfigPath, options);
+      createJestConfig(jestConfigPath, options, isLocalInstall);
       jestConfigCreated = true;
     }
 
@@ -84,17 +101,20 @@ async function initCommand(options) {
       if (!options.force) {
         warning(`babel.config.js already exists. Use --force to overwrite.`);
         info('Please manually add the lineage tracker plugin to your babel.config.js:');
+        const pluginPath = isLocalInstall
+          ? 'jest-test-lineage-reporter/src/babel-plugin-lineage-tracker.js'
+          : getGlobalPackagePath('babel-plugin-lineage-tracker.js');
         console.log(`
   plugins: [
-    'jest-test-lineage-reporter/src/babel-plugin-lineage-tracker.js',
+    '${pluginPath}',
   ],
 `);
       } else {
-        createBabelConfig(babelConfigPath, options);
+        createBabelConfig(babelConfigPath, options, isLocalInstall);
         babelConfigCreated = true;
       }
     } else {
-      createBabelConfig(babelConfigPath, options);
+      createBabelConfig(babelConfigPath, options, isLocalInstall);
       babelConfigCreated = true;
     }
 
@@ -137,14 +157,17 @@ async function initCommand(options) {
   }
 }
 
-function createJestConfig(filePath, options) {
+function createJestConfig(filePath, options, isLocalInstall) {
   const isTypeScript = options.typescript || hasTypeScriptFiles();
+  const setupPath = isLocalInstall
+    ? 'jest-test-lineage-reporter/src/testSetup.js'
+    : getGlobalPackagePath('testSetup.js');
 
   const config = `module.exports = {
   testEnvironment: 'node',
 
   // Required: Setup file for lineage tracking
-  setupFilesAfterEnv: ['jest-test-lineage-reporter/src/testSetup.js'],
+  setupFilesAfterEnv: ['${setupPath}'],
 
   // Add the lineage reporter
   reporters: [
@@ -179,8 +202,11 @@ function createJestConfig(filePath, options) {
   fs.writeFileSync(filePath, config, 'utf8');
 }
 
-function createBabelConfig(filePath, options) {
+function createBabelConfig(filePath, options, isLocalInstall) {
   const isTypeScript = options.typescript || hasTypeScriptFiles();
+  const pluginPath = isLocalInstall
+    ? 'jest-test-lineage-reporter/src/babel-plugin-lineage-tracker.js'
+    : getGlobalPackagePath('babel-plugin-lineage-tracker.js');
 
   const config = `module.exports = {
   presets: [
@@ -189,7 +215,7 @@ function createBabelConfig(filePath, options) {
   ],
   plugins: [
     // Required: Lineage tracker plugin for instrumentation
-    'jest-test-lineage-reporter/src/babel-plugin-lineage-tracker.js',
+    '${pluginPath}',
   ],
 };
 `;
@@ -211,4 +237,18 @@ function hasTypeScriptFiles() {
   }
 }
 
+function isInstalledLocally(cwd) {
+  const localPath = path.join(cwd, 'node_modules', 'jest-test-lineage-reporter');
+  return fs.existsSync(localPath);
+}
+
+function getGlobalPackagePath(filename) {
+  // Get the directory where this script is running from
+  const scriptDir = path.dirname(path.dirname(path.dirname(__dirname)));
+  const srcPath = path.join(scriptDir, 'src', filename);
+
+  // Return absolute path
+  return srcPath;
+}
+
 module.exports = initCommand;

package/src/cli/commands/mutate.js

@@ -55,6 +55,13 @@ async function mutateCommand(options) {
       spin.succeed('Mutation testing completed!');
     }
 
+    // Save results to file for HTML report
+    const fs = require('fs');
+    const path = require('path');
+    const resultsPath = path.join(process.cwd(), '.jest-lineage-mutation-results.json');
+    fs.writeFileSync(resultsPath, JSON.stringify(results, null, 2));
+    info(`Mutation results saved to: ${chalk.yellow(resultsPath)}`);
+
     // Print results
     printMutationSummary(results);
 

package/src/cli/commands/report.js

@@ -26,6 +26,19 @@ async function reportCommand(options) {
     // Process lineage data
     const lineageData = processLineageDataForMutation(rawData);
 
+    // Load mutation results if available
+    const fs = require('fs');
+    const mutationResultsPath = path.join(process.cwd(), '.jest-lineage-mutation-results.json');
+    let mutationResults = null;
+    if (fs.existsSync(mutationResultsPath)) {
+      try {
+        mutationResults = JSON.parse(fs.readFileSync(mutationResultsPath, 'utf8'));
+        info(`Loaded mutation results: ${chalk.cyan(mutationResults.totalMutations)} mutations tested`);
+      } catch (e) {
+        // Ignore errors loading mutation results
+      }
+    }
+
     // Create reporter instance with minimal config
     const reporter = new TestCoverageReporter(
       { rootDir: process.cwd() },
@@ -35,6 +48,11 @@ async function reportCommand(options) {
     // Load data into reporter
     reporter.processLineageResults(lineageData, 'unknown');
 
+    // Set mutation results if available
+    if (mutationResults) {
+      reporter.mutationResults = mutationResults;
+    }
+
     // Generate HTML report
     const spin = spinner('Generating HTML report...');
     spin.start();

package/src/cli/utils/jest-runner.js

@@ -39,6 +39,12 @@ async function runJest(options = {}) {
     jestArgs.push('--coverage');
   }
 
+  // Run tests serially when lineage tracking is enabled to avoid race conditions
+  // with file writes from parallel workers
+  if (enableLineage && !jestArgs.includes('--runInBand') && !jestArgs.includes('--maxWorkers')) {
+    jestArgs.push('--runInBand');
+  }
+
   // Set environment variables for lineage tracking
   const env = {
     ...process.env,

package/src/testSetup.js

@@ -278,7 +278,31 @@ function createTestWrapper(originalFn, testType) {
         if (process.env.JEST_LINEAGE_MUTATION !== 'true') {
           // Also store in a more persistent way for the reporter
           if (!global.__LINEAGE_PERSISTENT_DATA__) {
-            global.__LINEAGE_PERSISTENT_DATA__ = [];
+            // Initialize array - load existing tests from file if merging is enabled
+            // This ensures data persists across test files running in separate workers
+            const shouldMerge = process.env.JEST_LINEAGE_MERGE !== 'false';
+            if (shouldMerge) {
+              const fs = require('fs');
+              const path = require('path');
+              const filePath = path.join(process.cwd(), '.jest-lineage-data.json');
+
+              if (fs.existsSync(filePath)) {
+                try {
+                  const existingData = JSON.parse(fs.readFileSync(filePath, 'utf8'));
+                  // Convert coverage objects back to Maps
+                  global.__LINEAGE_PERSISTENT_DATA__ = existingData.tests.map(test => ({
+                    ...test,
+                    coverage: new Map(Object.entries(test.coverage || {}))
+                  }));
+                } catch (e) {
+                  global.__LINEAGE_PERSISTENT_DATA__ = [];
+                }
+              } else {
+                global.__LINEAGE_PERSISTENT_DATA__ = [];
+              }
+            } else {
+              global.__LINEAGE_PERSISTENT_DATA__ = [];
+            }
           }
           global.__LINEAGE_PERSISTENT_DATA__.push(testData);
 
@@ -645,8 +669,9 @@ function writeTrackingDataToFile() {
   try {
     const filePath = path.join(process.cwd(), '.jest-lineage-data.json');
 
-    // Check if we should merge with existing data (default: false - recreate from scratch)
-    const shouldMerge = process.env.JEST_LINEAGE_MERGE === 'true';
+    // Check if we should merge with existing data (default: true for multiple test files)
+    // Set JEST_LINEAGE_MERGE=false to disable merging and recreate from scratch
+    const shouldMerge = process.env.JEST_LINEAGE_MERGE !== 'false';
 
     let existingData = { timestamp: Date.now(), tests: [] };
     if (shouldMerge && fs.existsSync(filePath)) {
@@ -717,8 +742,6 @@ function writeTrackingDataToFile() {
     }
 
     fs.writeFileSync(filePath, JSON.stringify(dataToWrite, null, 2));
-
-    // console.log(`📝 Wrote tracking data: ${dataToWrite.tests.length} total tests to ${filePath}`);
   } catch (error) {
     console.warn('Warning: Could not write tracking data to file:', error.message);
   }