Add best-effort @sap/cds-indexer support to CDS extractor

- Integrate indexer orchestration into cds-extractor.ts between
  dependency installation and compilation phases
- New src/cds/indexer.ts: detect projects using @sap/cds-indexer and
  run `npx --yes @sap/cds-indexer` before compilation, with graceful
  error handling and diagnostic warnings on failure
- Include @sap/cds-indexer in dependency cache when declared in
  project package.json (dependencies or devDependencies)
- Add addCdsIndexerDiagnostic() to diagnostics.ts
- Add unit tests to cover new indexer and diagnostic functions
- Fix Jest localstorage-file warnings on Node.js v25+

Author: data-douser

extractors/cds/tools/cds-extractor.ts

@@ -3,6 +3,7 @@ import { join } from 'path';
 import { sync as globSync } from 'glob';
 
 import { orchestrateCompilation } from './src/cds/compiler';
+import { orchestrateCdsIndexer } from './src/cds/indexer';
 import { buildCdsProjectDependencyGraph, type CdsDependencyGraph } from './src/cds/parser';
 import { handleEarlyExit, runJavaScriptExtractionWithMarker } from './src/codeql';
 import {
@@ -206,6 +207,23 @@ if (projectCacheDirMap.size === 0) {
   );
 }
 
+// Run cds-indexer for projects that use it (before compilation)
+logPerformanceTrackingStart('CDS Indexer');
+const cdsIndexerSummary = orchestrateCdsIndexer(
+  dependencyGraph,
+  sourceRoot,
+  projectCacheDirMap,
+  codeqlExePath,
+);
+logPerformanceTrackingStop('CDS Indexer');
+
+if (cdsIndexerSummary.projectsRequiringIndexer > 0) {
+  logPerformanceMilestone(
+    'CDS indexer completed',
+    `${cdsIndexerSummary.successfulRuns} succeeded, ${cdsIndexerSummary.failedRuns} failed`,
+  );
+}
+
 // Collect all CDS files to process
 const cdsFilePathsToProcess: string[] = [];
 for (const project of dependencyGraph.projects.values()) {

extractors/cds/tools/dist/cds-extractor.bundle.js

@@ -1,3 +1,20 @@
+// Suppress Node.js v25+ localStorage warning triggered by jest-environment-node
+// teardown accessing globalThis.localStorage before --localstorage-file is set.
+// Setting the env var here ensures it propagates to all Jest worker processes.
+const nodeVersion = parseInt(process.versions.node, 10);
+if (nodeVersion >= 25 && !process.env.NODE_OPTIONS?.includes('--localstorage-file')) {
+  const localStoragePath = require('path').join(
+    require('os').tmpdir(),
+    '.jest-cds-extractor-localstorage',
+  );
+  process.env.NODE_OPTIONS = [
+    process.env.NODE_OPTIONS,
+    `--localstorage-file=${localStoragePath}`,
+  ]
+    .filter(Boolean)
+    .join(' ');
+}
+
 /** @type {import('ts-jest').JestConfigWithTsJest} */
 module.exports = {
   preset: 'ts-jest',