OptionalautoEnable automatic mode selection based on project complexity, default: true. When enabled, the executor analyzes project metrics (file count, LOC, memory pressure) and automatically chooses between Promise-based and worker thread parallelism.
Set to false to disable auto-selection and use Promise-based mode by default. If useWorkerThreads is explicitly set (true or false), this option is ignored.
OptionalbaseGit commit or branch to compare against in incremental mode.
OptionalbatchMaximum files per worker batch (default: 10)
OptionalenableEnable real-time memory monitoring in Promise mode, default: true. Monitors heap usage and projects peak memory to abort if critical threshold exceeded.
OptionalenableReport progress while scanning.
OptionalexcludePatterns of files to exclude.
OptionalfallbackAllow automatic fallback to workers if Promise mode aborts, default: true. Only used when autoSelectMode is true and monitoring detects memory pressure.
OptionalincrementalAnalyze only changed files and their dependents.
OptionalmaxMaximum concurrent workers (default: CPU cores - 1)
OptionalminMinimum number of files required to use worker threads (default: 200). Worker thread initialization has significant overhead (loading ts-morph project, plugins, etc.). For small file sets, Promise-based parallelism is faster. Set to 0 to always use workers when useWorkerThreads is true.
OptionalonEnable progress callbacks
OptionalparallelRun files in parallel.
OptionalpluginPlugin IDs to load in workers
OptionalresourceResource limits for the scan.
OptionalmaxMemory?: numberMaximum heap memory in bytes.
OptionalmaxWorkers?: numberMaximum number of concurrent workers.
OptionalsignalEnable cancellation
OptionalthresholdsCustom thresholds for automatic mode selection. Only used when autoSelectMode is true.
OptionaltimeoutTask timeout in milliseconds (default: 30000)
OptionaltsTypeScript config path (required for worker threads)
OptionaluseUse worker threads for true parallelism
OptionalworkerPath to worker script (required for worker threads). Use getWorkerScriptPath() from @angular-modernizer/worker package.
Extended orchestration options for tools that scan a project in parallel.