@ovh-ux/manager-static-analysis-kit 0.9.0 → 0.11.0

package/bin/tests-coverage-cli-tests.js

@@ -3,14 +3,12 @@ import { spawnSync } from 'node:child_process';
 
 import { logError, logInfo } from './utils/log-utils.js';
 
+// Define the set of validation test cases
 const cases = [
-  // Debug only — very slow, runs across all apps
-  // { name: 'Auto-discovery (all apps)', cmd: 'yarn manager-tests-coverage', expect: 0 },
-
   { name: 'Single app (zimbra)', cmd: 'yarn manager-tests-coverage --app zimbra', expect: 0 },
   {
-    name: 'Multiple apps (container,zimbra,web-ongoing-operations,key-management-service)',
-    cmd: 'yarn manager-tests-coverage --apps container,zimbra,web-ongoing-operations,key-management-service',
+    name: 'Multiple apps (container,zimbra)',
+    cmd: 'yarn manager-tests-coverage --apps container,zimbra',
     expect: 0,
   },
   {
@@ -23,6 +21,36 @@ const cases = [
     cmd: 'yarn manager-tests-coverage --packages @ovh-ux/manager-zimbra-app,@ovh-ux/manager-pci-workflow-app',
     expect: 0,
   },
+  {
+    name: 'Single library static path by folder name (manager-react-components)',
+    cmd: 'yarn manager-tests-coverage --library manager-react-components',
+    expect: 0,
+  },
+  {
+    name: 'Single library static path by package name (manager-react-components)',
+    cmd: 'yarn manager-tests-coverage --library @ovh-ux/manager-react-components',
+    expect: 0,
+  },
+  {
+    name: 'Single library dynamic path by folder name (shell-client)',
+    cmd: 'yarn manager-tests-coverage --library shell-client',
+    expect: 0,
+  },
+  {
+    name: 'Single library static path by package name (shell-client)',
+    cmd: 'yarn manager-tests-coverage --library @ovh-ux/manager-react-shell-client',
+    expect: 0,
+  },
+  {
+    name: 'Multiple libraries by folder names (manager-wiki,manager-react-components,shell-client,logs-to-customer)',
+    cmd: 'yarn manager-tests-coverage --libraries manager-wiki,manager-react-components,shell-client,logs-to-customer',
+    expect: 0,
+  },
+  {
+    name: 'Multiple libraries by package names (manager-wiki,manager-react-components,shell-client,logs-to-customer)',
+    cmd: 'yarn manager-tests-coverage --libraries @ovh-ux/manager-wiki,@ovh-ux/manager-react-components,@ovh-ux/manager-react-shell-client,@ovh-ux/logs-to-customer',
+    expect: 0,
+  },
   {
     name: 'Mixed valid+invalid apps',
     cmd: 'yarn manager-tests-coverage --apps zimbra,unknown-app,container',
@@ -30,7 +58,12 @@ const cases = [
   },
   {
     name: 'Mixed valid+invalid packages',
-    cmd: 'yarn manager-tests-coverage --packages @ovh-ux/manager-zimbra-app,@ovh-ux/manager-ghost-app',
+    cmd: 'yarn manager-tests-coverage --packages @ovh-ux/manager-wiki,manager-react-components,@ovh-ux/manager-ghost-app',
+    expect: 0,
+  },
+  {
+    name: 'Mixed valid+invalid libraries',
+    cmd: 'yarn manager-tests-coverage --libraries @ovh-ux/manager-zimbra-app,@ovh-ux/manager-ghost-app',
     expect: 0,
   },
   {
@@ -43,6 +76,11 @@ const cases = [
     cmd: 'yarn manager-tests-coverage --packages @ovh-ux/manager-ghost-app,@ovh-ux/manager-missing-app',
     expect: 1,
   },
+  {
+    name: 'Turbo build failure simulation (pci-ai-tools)',
+    cmd: 'yarn manager-tests-coverage --app pci-ai-tools',
+    expect: 0,
+  },
 ];
 
 let failed = 0;

package/bin/tests-coverage-cli.js

@@ -8,17 +8,16 @@ import {
   generateTestsCoverageHtml,
 } from '../dist/adapters/tests-coverage/helpers/tests-coverage-analysis-helper.js';
 import {
-  appsDir,
-  outputRootDir,
   rootDir,
   testsCoverageCombinedHtmlReportName,
   testsCoverageCombinedJsonReportName,
+  testsCoverageOutputRootDir,
   testsCoverageReportsRootDirName,
 } from './cli-path-config.js';
 import { parseCliTargets } from './utils/args-parse-utils.js';
 import { logError, logInfo, logWarn } from './utils/log-utils.js';
-import { runAppsAnalysis } from './utils/runner-utils.js';
-import { resolveTurboFilters, runTurboBuild, runTurboTests } from './utils/turbo-utils.js';
+import { runModulesAnalysis } from './utils/runner-utils.js';
+import { runTurboBuild, runTurboTests } from './utils/turbo-utils.js';
 
 /**
  * Locate common coverage artifacts inside an app directory.
@@ -63,7 +62,11 @@ function findCoverageFiles(appDir) {
  */
 function harvestAppCoverage(appDir, appShortName) {
   const { summary, lcov } = findCoverageFiles(appDir);
-  const outDir = path.join(outputRootDir, testsCoverageReportsRootDirName, appShortName);
+  const outDir = path.join(
+    testsCoverageOutputRootDir,
+    testsCoverageReportsRootDirName,
+    appShortName,
+  );
   fs.mkdirSync(outDir, { recursive: true });
 
   if (!summary) {
@@ -89,32 +92,39 @@ function harvestAppCoverage(appDir, appShortName) {
  */
 function main() {
   try {
-    const { appFolders, packageNames } = parseCliTargets(appsDir);
-    const turboFilters = resolveTurboFilters({ appsDir, appFolders, packageNames });
+    const modules = parseCliTargets();
 
     // 1) Build all selected targets (best-effort)
-    runTurboBuild(rootDir, turboFilters);
+    runTurboBuild(
+      rootDir,
+      modules.map((item) => item.packageName),
+      ['--continue'],
+    );
 
     // 2) Run tests with coverage; keep args minimal for Vitest/Jest compatibility
     //    (Projects should already be configured to emit json-summary/lcov.)
-    runTurboTests(rootDir, turboFilters, [
-      '--',
-      '--coverage',
-      '--coverage.reporter',
-      'json-summary',
-      '--coverage.reporter',
-      'lcov',
-      '--coverage.reporter',
-      'html',
-    ]);
+    runTurboTests(
+      rootDir,
+      modules.map((item) => item.packageName),
+      [
+        '--continue', // turbo: keep going even if some tests fail
+        '--', // pass the rest to the test runner
+        '--coverage',
+        '--coverage.reportOnFailure',
+        '--coverage.reporter',
+        'json-summary',
+        '--coverage.reporter',
+        'lcov',
+        '--coverage.reporter',
+        'html',
+      ],
+    );
 
     // 3) Per-app harvest + combined reports
-    runAppsAnalysis({
-      appsDir,
-      appFolders,
-      requireReact: false,
+    runModulesAnalysis({
+      modules,
       binaryLabel: 'Tests coverage',
-      appRunner: harvestAppCoverage,
+      analysisRunner: harvestAppCoverage,
       reportsRootDirName: testsCoverageReportsRootDirName,
       combinedJson: testsCoverageCombinedJsonReportName,
       combinedHtml: testsCoverageCombinedHtmlReportName,
@@ -122,9 +132,9 @@ function main() {
       generateHtmlFn: (combined) =>
         generateTestsCoverageHtml(
           combined,
-          path.join(outputRootDir, testsCoverageReportsRootDirName),
+          path.join(testsCoverageOutputRootDir, testsCoverageReportsRootDirName),
         ),
-      outputRootDir,
+      outputRootDir: testsCoverageOutputRootDir,
     });
   } catch (err) {
     logError(`Fatal error: ${err.stack || err.message}`);

package/bin/types-coverage-cli.js

@@ -2,22 +2,22 @@
 import fs from 'node:fs';
 import path from 'node:path';
 import process from 'node:process';
+import ts from 'typescript';
 
 import {
   collectTypesCoverage,
   generateTypesCoverageHtml,
 } from '../dist/adapters/types-coverage/helpers/types-coverage-analysis-helper.js';
 import {
-  appsDir,
-  outputRootDir,
   tsTypesCoverageBin,
   typesCoverageCombinedHtmlReportName,
   typesCoverageCombinedJsonReportName,
+  typesCoverageOutputRootDir,
   typesCoverageReportsRootDirName,
 } from './cli-path-config.js';
 import { buildTypesCoverageArgs, parseCliTargets } from './utils/args-parse-utils.js';
 import { logError, logInfo, logWarn } from './utils/log-utils.js';
-import { ensureBinExists, runAppsAnalysis, runCommand } from './utils/runner-utils.js';
+import { ensureBinExists, runCommand, runModulesAnalysis } from './utils/runner-utils.js';
 
 /**
  * Temporarily strip "extends" from tsconfig.json before analysis,
@@ -60,6 +60,66 @@ function patchTsConfig(appDir, fn) {
   }
 }
 
+/**
+ * Count loose TypeScript constructs (`as`, `any`, `unknown`) in src/.
+ *
+ * Uses the TypeScript compiler API to avoid false positives from strings, comments, etc.
+ *
+ * @param {string} appDir Absolute path to app root
+ * @returns {{ as: number; any: number; unknown: number }}
+ */
+export function countLooseTypes(appDir) {
+  const srcDir = path.join(appDir, 'src');
+  let asCount = 0;
+  let anyCount = 0;
+  let unknownCount = 0;
+
+  function analyzeFile(filePath) {
+    const content = fs.readFileSync(filePath, 'utf8');
+    const source = ts.createSourceFile(filePath, content, ts.ScriptTarget.Latest, true);
+
+    function visit(node) {
+      // "as" expressions: foo as string
+      if (ts.isAsExpression(node)) {
+        asCount++;
+        if (node.type.kind === ts.SyntaxKind.AnyKeyword) {
+          anyCount++;
+        } else if (node.type.kind === ts.SyntaxKind.UnknownKeyword) {
+          unknownCount++;
+        }
+      }
+
+      // Type annotations like let x: any or function foo(x: unknown)
+      if (node.kind === ts.SyntaxKind.AnyKeyword) {
+        anyCount++;
+      } else if (node.kind === ts.SyntaxKind.UnknownKeyword) {
+        unknownCount++;
+      }
+
+      ts.forEachChild(node, visit);
+    }
+
+    visit(source);
+  }
+
+  function walk(dir) {
+    for (const entry of fs.readdirSync(dir, { withFileTypes: true })) {
+      const fullPath = path.join(dir, entry.name);
+      if (entry.isDirectory()) {
+        walk(fullPath);
+      } else if (/\.(ts|tsx)$/.test(entry.name)) {
+        analyzeFile(fullPath);
+      }
+    }
+  }
+
+  if (fs.existsSync(srcDir)) {
+    walk(srcDir);
+  }
+
+  return { as: asCount, any: anyCount, unknown: unknownCount };
+}
+
 /**
  * Run TypeScript coverage for one app.
  *
@@ -70,7 +130,7 @@ function patchTsConfig(appDir, fn) {
 function runAppTypesCoverage(appDir, appShortName) {
   return patchTsConfig(appDir, () => {
     const absoluteOutputDir = path.join(
-      outputRootDir,
+      typesCoverageOutputRootDir,
       typesCoverageReportsRootDirName,
       appShortName,
     );
@@ -82,6 +142,10 @@ function runAppTypesCoverage(appDir, appShortName) {
     const args = buildTypesCoverageArgs(relativeOutputDir);
     const ok = runCommand(tsTypesCoverageBin, args, appDir);
 
+    const looseTypes = countLooseTypes(appDir);
+    const looseTypeReport = path.join(absoluteOutputDir, 'loose-types.json');
+    fs.writeFileSync(looseTypeReport, JSON.stringify(looseTypes, null, 2));
+
     const jsonReport = path.join(absoluteOutputDir, 'typescript-coverage.json');
     const htmlReport = path.join(absoluteOutputDir, 'index.html');
 
@@ -91,6 +155,9 @@ function runAppTypesCoverage(appDir, appShortName) {
     if (!fs.existsSync(htmlReport)) {
       logWarn(`⚠️ Missing index.html at ${htmlReport}`);
     }
+    if (!fs.existsSync(looseTypeReport)) {
+      logWarn(`⚠️ Missing loose-types.json at ${looseTypeReport}`);
+    }
 
     return ok;
   });
@@ -103,20 +170,18 @@ function main() {
   try {
     ensureBinExists(tsTypesCoverageBin, 'typescript-coverage-report');
 
-    const { appFolders } = parseCliTargets(appsDir);
+    const modules = parseCliTargets();
 
-    runAppsAnalysis({
-      appsDir,
-      appFolders,
-      requireReact: true,
+    runModulesAnalysis({
+      modules,
       binaryLabel: 'Type coverage',
-      appRunner: runAppTypesCoverage,
+      analysisRunner: runAppTypesCoverage,
       reportsRootDirName: typesCoverageReportsRootDirName,
       combinedJson: typesCoverageCombinedJsonReportName,
       combinedHtml: typesCoverageCombinedHtmlReportName,
       collectFn: collectTypesCoverage,
       generateHtmlFn: generateTypesCoverageHtml,
-      outputRootDir,
+      outputRootDir: typesCoverageOutputRootDir,
     });
   } catch (err) {
     logError(`Fatal error: ${err.stack || err.message}`);

package/bin/types-coverage-tests-cli.js

@@ -3,15 +3,12 @@ import { spawnSync } from 'node:child_process';
 
 import { logError, logInfo } from './utils/log-utils.js';
 
-// Define the set of validation test cases for types-coverage-tests CLI
+// Define the set of validation test cases
 const cases = [
-  // Debug only — very slow, runs across all apps
-  // { name: 'Auto-discovery (all apps)', cmd: 'yarn manager-types-coverage', expect: 0 },
-
   { name: 'Single app (zimbra)', cmd: 'yarn manager-types-coverage --app zimbra', expect: 0 },
   {
-    name: 'Multiple apps (container,zimbra,web-ongoing-operations,key-management-service)',
-    cmd: 'yarn manager-types-coverage --apps container,zimbra,web-ongoing-operations,key-management-service',
+    name: 'Multiple apps (container,zimbra)',
+    cmd: 'yarn manager-types-coverage --apps container,zimbra',
     expect: 0,
   },
   {
@@ -24,6 +21,36 @@ const cases = [
     cmd: 'yarn manager-types-coverage --packages @ovh-ux/manager-zimbra-app,@ovh-ux/manager-pci-workflow-app',
     expect: 0,
   },
+  {
+    name: 'Single library static path by folder name (manager-react-components)',
+    cmd: 'yarn manager-types-coverage --library manager-react-components',
+    expect: 0,
+  },
+  {
+    name: 'Single library static path by package name (manager-react-components)',
+    cmd: 'yarn manager-types-coverage --library @ovh-ux/manager-react-components',
+    expect: 0,
+  },
+  {
+    name: 'Single library dynamic path by folder name (shell-client)',
+    cmd: 'yarn manager-types-coverage --library shell-client',
+    expect: 0,
+  },
+  {
+    name: 'Single library static path by package name (shell-client)',
+    cmd: 'yarn manager-types-coverage --library @ovh-ux/manager-react-shell-client',
+    expect: 0,
+  },
+  {
+    name: 'Multiple libraries by folder names (manager-wiki,manager-react-components,shell-client,logs-to-customer)',
+    cmd: 'yarn manager-types-coverage --libraries manager-wiki,manager-react-components,shell-client,logs-to-customer',
+    expect: 0,
+  },
+  {
+    name: 'Multiple libraries by package names (manager-wiki,manager-react-components,shell-client,logs-to-customer)',
+    cmd: 'yarn manager-types-coverage --libraries @ovh-ux/manager-wiki,@ovh-ux/manager-react-components,@ovh-ux/manager-react-shell-client,@ovh-ux/logs-to-customer',
+    expect: 0,
+  },
   {
     name: 'Mixed valid+invalid apps',
     cmd: 'yarn manager-types-coverage --apps zimbra,unknown-app,container',
@@ -31,7 +58,12 @@ const cases = [
   },
   {
     name: 'Mixed valid+invalid packages',
-    cmd: 'yarn manager-types-coverage --packages @ovh-ux/manager-zimbra-app,@ovh-ux/manager-ghost-app',
+    cmd: 'yarn manager-types-coverage --packages @ovh-ux/manager-wiki,manager-react-components,@ovh-ux/manager-ghost-app',
+    expect: 0,
+  },
+  {
+    name: 'Mixed valid+invalid libraries',
+    cmd: 'yarn manager-types-coverage --libraries @ovh-ux/manager-zimbra-app,@ovh-ux/manager-ghost-app',
     expect: 0,
   },
   {
@@ -44,6 +76,11 @@ const cases = [
     cmd: 'yarn manager-types-coverage --packages @ovh-ux/manager-ghost-app,@ovh-ux/manager-missing-app',
     expect: 1,
   },
+  {
+    name: 'Turbo build failure simulation (pci-ai-tools)',
+    cmd: 'yarn manager-types-coverage --app pci-ai-tools',
+    expect: 0,
+  },
 ];
 
 let failed = 0;

package/bin/utils/args-parse-utils.js

@@ -1,143 +1,106 @@
-import fs from 'node:fs';
-import path from 'node:path';
 import process from 'node:process';
 
 import { codeDuplicationConfig } from '../../dist/configs/code-duplication-config.js';
 import { typesCoverageConfig } from '../../dist/configs/types-coverage-config.js';
-import { isReactApp } from './apps-utils.js';
-import { logError, logInfo, logWarn } from './log-utils.js';
+import { logError, logInfo } from './log-utils.js';
+import { getModule } from './module-utils.js';
 
 /**
- * Extract an app folder name from an OVH Manager package name.
+ * Parse CLI arguments to resolve target modules (apps, packages, or libraries).
  *
- * Example:
- *   "@ovh-ux/manager-zimbra-app" → "zimbra"
+ * This function looks for one of the supported flags in `process.argv`:
+ * - `--apps` or `--app`
+ * - `--packages` or `--package`
+ * - `--libraries` or `--library`
  *
- * @param {string} packageName - Full npm package name.
- * @returns {string|null} The extracted app folder name, or null if the format is invalid.
- */
-function extractAppFolderFromPackageName(packageName) {
-  const match = packageName.match(/^@ovh-ux\/manager-(.+)-app$/);
-  if (!match) {
-    logError(`❌ Invalid package name format: ${packageName}`);
-    return null;
-  }
-  return match[1];
-}
-
-/**
- * Parse CLI arguments for `--apps` or `--app` flags.
+ * Each flag must be followed by a comma-separated list of module identifiers.
+ * Each identifier is resolved using {@link getModule}, which returns a module descriptor.
  *
- * Accepts a comma-separated list of app folder names. Example:
- *   `--apps zimbra,web`
+ * For every valid pattern:
+ * - The corresponding module descriptor (containing `fullPath`, `shortPath`, and `packageName`)
+ *   is added to the result list.
+ * - If a module cannot be resolved, an error is logged and it is skipped.
  *
- * @param {string} appsDir - Absolute path to the apps root directory.
- * @returns {{appFolders: string[], packageNames: string[]} | null}
- *   Object containing valid app folders and an empty `packageNames` array,
- *   or null if no `--apps`/`--app` flag is provided.
- */
-function parseAppsArg(appsDir) {
-  const appsArg = process.argv.find((arg) => arg === '--apps' || arg === '--app');
-  if (!appsArg) return null;
-
-  const index = process.argv.indexOf(appsArg);
-  const rawValue = process.argv[index + 1] || '';
-  const appFolders = rawValue
-    .split(',')
-    .map((n) => n.trim())
-    .filter(Boolean);
-
-  const validFolders = appFolders.filter((folder) => {
-    if (!fs.existsSync(path.join(appsDir, folder))) {
-      logError(`❌ App not found: ${folder} → skipping`);
-      return false;
-    }
-    return true;
-  });
-
-  logInfo(`Running in apps mode for: ${validFolders.join(', ')}`);
-  return { appFolders: validFolders, packageNames: [] };
-}
-
-/**
- * Parse CLI arguments for `--packages` or `--package` flags.
+ * @typedef {Object} ModuleDescriptor
+ * @property {string} fullPath - Absolute path to the module directory.
+ * @property {string} shortPath - Folder name (short identifier) of the module.
+ * @property {string} packageName - Full npm package name (e.g. "@ovh-ux/manager-core-shell").
  *
- * Accepts a comma-separated list of package names. Example:
- *   `--packages @ovh-ux/manager-zimbra-app,@ovh-ux/manager-web-app`
+ * @returns {ModuleDescriptor[] | null}
+ * Array of resolved module descriptors, or `null` if no supported CLI flags were provided.
  *
- * Each package name is mapped to its corresponding app folder.
+ * @example
+ * // Example 1: Apps mode
+ * // CLI: --apps zimbra,web
+ * parseArgs();
+ * // → [
+ * //   { fullPath: "/.../manager/apps/zimbra", shortPath: "zimbra", packageName: "@ovh-ux/manager-zimbra-app" },
+ * //   { fullPath: "/.../manager/apps/web", shortPath: "web", packageName: "@ovh-ux/manager-web-app" }
+ * // ]
  *
- * @param {string} appsDir - Absolute path to the apps root directory.
- * @returns {{appFolders: string[], packageNames: string[]} | null}
- *   Object mapping package names to discovered app folders,
- *   or null if no `--packages`/`--package` flag is provided.
+ * @example
+ * // Example 2: Libraries mode
+ * // CLI: --libraries core-shell,react-components
+ * parseArgs();
+ * // → [
+ * //   { fullPath: "/.../packages/manager/core/core-shell", shortPath: "core-shell", packageName: "@ovh-ux/manager-core-shell" },
+ * //   { fullPath: "/.../packages/components/react-components", shortPath: "react-components", packageName: "@ovh-ux/manager-react-components" }
+ * // ]
  */
-function parsePackagesArg(appsDir) {
+export function parseArgs() {
+  const libsArg = process.argv.find((arg) => arg === '--libraries' || arg === '--library');
   const packagesArg = process.argv.find((arg) => arg === '--packages' || arg === '--package');
-  if (!packagesArg) return null;
+  const appsArg = process.argv.find((arg) => arg === '--apps' || arg === '--app');
+
+  const moduleModeArgs = libsArg || packagesArg || appsArg;
 
-  const index = process.argv.indexOf(packagesArg);
+  if (!moduleModeArgs) return null;
+
+  const index = process.argv.indexOf(moduleModeArgs);
   const rawValue = process.argv[index + 1] || '';
-  const packageNames = rawValue
+
+  const modulePatterns = rawValue
     .split(',')
     .map((n) => n.trim())
     .filter(Boolean);
 
-  const mappedFolders = [];
-  for (const pkgName of packageNames) {
-    const folder = extractAppFolderFromPackageName(pkgName);
-    if (folder && fs.existsSync(path.join(appsDir, folder))) {
-      mappedFolders.push(folder);
+  /** @type {ModuleDescriptor[]} */
+  const modules = [];
+
+  for (const modulePattern of modulePatterns) {
+    const discoveredModule = getModule(modulePattern, !!libsArg);
+    if (discoveredModule) {
+      modules.push(discoveredModule);
     } else {
-      logError(`❌ Package ${pkgName} → app folder ${folder} not found, skipping`);
+      logError(
+        `❌ Module ${modulePattern} → folder ${discoveredModule?.shortPath || 'unknown'} not found, skipping`,
+      );
     }
   }
 
   logInfo(
-    `Running in packages mode for: ${packageNames.join(', ')} → apps: ${mappedFolders.join(', ')}`,
+    `patterns ${modulePatterns.join(', ')} → folders: ${modules
+      .map((item) => item.fullPath)
+      .join(', ')}`,
   );
-  return { appFolders: mappedFolders, packageNames };
-}
 
-/**
- * Discover all React apps in the apps directory when no CLI flags are provided.
- *
- * Only apps that contain a `package.json` file and are identified as React apps
- * (via `isReactApp`) will be included.
- *
- * @param {string} appsDir - Absolute path to the apps root directory.
- * @returns {{appFolders: string[], packageNames: string[]}}
- *   Object containing discovered app folders and an empty `packageNames` array.
- */
-function discoverApps(appsDir) {
-  const discoveredAppFolders = fs.readdirSync(appsDir).filter((dir) => {
-    const pkgPath = path.join(appsDir, dir, 'package.json');
-    return fs.existsSync(pkgPath) && isReactApp(pkgPath);
-  });
-
-  if (discoveredAppFolders.length === 0) {
-    logWarn('⚠️ No React apps found to analyze.');
-    return { appFolders: [], packageNames: [] };
-  }
-
-  logInfo(`Running in auto-discovery mode (${discoveredAppFolders.length} apps).`);
-  return { appFolders: discoveredAppFolders, packageNames: [] };
+  return modules;
 }
 
 /**
- * Parse CLI arguments to resolve which apps or packages should be analyzed.
+ * Alias for {@link parseArgs}, used for semantic clarity in CLI entrypoints.
  *
- * Priority order:
- *  1. Explicit `--apps` flag
- *  2. Explicit `--packages` flag
- *  3. Auto-discovery fallback
+ * This function simply delegates to {@link parseArgs} and returns the same result.
  *
- * @param {string} appsDir - Absolute path to the apps root directory.
- * @returns {{appFolders: string[], packageNames: string[]}}
- *   Object containing app folder names and package names for analysis.
+ * @returns {ModuleDescriptor[] | null}
+ * Array of resolved module descriptors, or `null` if no valid flags were provided.
+ *
+ * @example
+ * parseCliTargets();
+ * // Equivalent to parseArgs(), typically used in CLI commands.
  */
-export function parseCliTargets(appsDir) {
-  return parseAppsArg(appsDir) || parsePackagesArg(appsDir) || discoverApps(appsDir);
+export function parseCliTargets() {
+  return parseArgs();
 }
 
 /**
@@ -217,6 +180,13 @@ export function buildCodeDuplicationArgs(outputDir) {
     // https://github.com/kucherenko/jscpd/blob/master/apps/jscpd/README.md#ignore
     args.push('--ignore', cfg.ignore.join(','));
   }
-
+  // jscpd accepts regex patterns via `--ignore-pattern` (singular).
+  // Multiple regexes should be joined by comma.
+  // https://github.com/kucherenko/jscpd/blob/master/apps/jscpd/README.md#ignore-pattern
+  if (Array.isArray(cfg.ignorePatterns) && cfg.ignorePatterns.length > 0) {
+    for (const pat of cfg.ignorePatterns) {
+      args.push('--ignore-pattern', `'${pat}'`);
+    }
+  }
   return args;
 }