@angular-modernizer/worker 0.1.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Christian Weiss<CWOIDA>
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -0,0 +1,82 @@
+# @angular-modernizer/worker
+
+Worker thread script for parallel analysis in the Angular Modernization Platform.
+
+## Overview
+
+This package contains the analysis worker script that runs in Node.js worker threads for parallel code analysis. It depends on all plugin packages and is therefore the last package built in the monorepo.
+
+## Why a Separate Package?
+
+Worker threads run in isolated V8 contexts and need access to all analysis plugins. Since plugins depend on `core`, and `core` contains the `WorkerPool`, placing the worker script in `core` would create a circular dependency.
+
+This package resolves that by:
+
+1. Depending on all plugin packages (builds last)
+2. Exporting a helper function to get the worker script path
+3. Being used by both programmatic API users and the MCP adapter
+
+## Usage
+
+```typescript
+import { getWorkerScriptPath } from '@angular-modernizer/worker';
+import { WorkerPool } from '@angular-modernizer/core';
+
+const pool = new WorkerPool({
+  tsConfigPath: '/path/to/tsconfig.json',
+  workerScriptPath: getWorkerScriptPath(),
+  maxWorkers: 4,
+});
+
+const result = await pool.executeTask({
+  id: 'task-1',
+  filePath: '/path/to/file.ts',
+  pluginIds: ['architecture', 'solid'],
+});
+
+await pool.terminate();
+```
+
+## Mode Selection
+
+- Less than 100 files: Promise mode (worker overhead exceeds benefit)
+- 100-500 files: Adaptive mode (auto-selects based on available memory)
+- More than 500 files: Worker mode (5-10x speedup)
+
+Memory pressure: at 85% heap usage, the pool reduces worker count or pauses new tasks.
+
+## Build Order
+
+This package builds last in the monorepo:
+
+```
+1. core
+2. plugin-system
+3. api
+4. plugin-analyzer, plugin-solid, plugin-angular, plugin-standalone, plugin-architecture, orchestration
+5. worker (this package)
+6. adapter-mcp
+```
+
+## Exports
+
+- `getWorkerScriptPath()` - Returns the absolute path to the compiled worker script
+- Re-exports `WorkerTask`, `WorkerResult` types from `@angular-modernizer/core`
+
+## Requirements
+
+All workspace packages must be built before using workers. Run `pnpm build` from the monorepo root.
+
+## Testing
+
+Worker tests are skipped by default to keep CI fast. Set `ENABLE_WORKER_TESTS=true` to run the full worker pool suite:
+
+```bash
+ENABLE_WORKER_TESTS=true pnpm --filter @angular-modernizer/worker test
+```
+
+## Implementation Notes
+
+Workers require `ContextFactory.createAnalysisContext()` — not a bare `{ sourceFile, project, config }` object. Rules that access `context.api` will throw when given a bare object.
+
+Data crossing the thread boundary must be JSON-serializable. Functions, class instances, circular references, and Symbols cannot be serialized and will cause `DataCloneError`.

package/dist/analysis-worker.d.ts

@@ -0,0 +1,26 @@
+/**
+ * @angular-modernizer/worker - Analysis worker script for worker thread execution
+ *
+ * Each worker:
+ * - Creates isolated Project instance (ts-morph) - OPTIMIZED: lazy loading
+ * - Initializes PublicApi and plugins
+ * - Receives tasks via parentPort messages
+ * - Executes analysis rules
+ * - Returns results to main thread
+ *
+ * Communication Protocol:
+ * Main → Worker: WorkerTask { taskId, filePath, ruleIds, pluginIds, config }
+ * Worker → Main: WorkerResult { taskId, results, duration, error? }
+ *
+ * OPTIMIZATION: Workers now use lazy file loading instead of loading the entire
+ * project from tsconfig. This significantly reduces initialization time from
+ * ~2000ms to ~100ms per worker.
+ *
+ * This file is in @angular-modernizer/worker package which depends on ALL plugins.
+ * This solves the circular dependency issue - worker builds LAST after all plugins.
+ *
+ * Build Requirement: All workspace packages must be built before workers can run.
+ * Run `pnpm build` from the monorepo root to compile all packages.
+ */
+export {};
+//# sourceMappingURL=analysis-worker.d.ts.map

package/dist/analysis-worker.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"analysis-worker.d.ts","sourceRoot":"","sources":["../src/analysis-worker.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;GAuBG"}

package/dist/analysis-worker.js

@@ -0,0 +1,332 @@
+/**
+ * @angular-modernizer/worker - Analysis worker script for worker thread execution
+ *
+ * Each worker:
+ * - Creates isolated Project instance (ts-morph) - OPTIMIZED: lazy loading
+ * - Initializes PublicApi and plugins
+ * - Receives tasks via parentPort messages
+ * - Executes analysis rules
+ * - Returns results to main thread
+ *
+ * Communication Protocol:
+ * Main → Worker: WorkerTask { taskId, filePath, ruleIds, pluginIds, config }
+ * Worker → Main: WorkerResult { taskId, results, duration, error? }
+ *
+ * OPTIMIZATION: Workers now use lazy file loading instead of loading the entire
+ * project from tsconfig. This significantly reduces initialization time from
+ * ~2000ms to ~100ms per worker.
+ *
+ * This file is in @angular-modernizer/worker package which depends on ALL plugins.
+ * This solves the circular dependency issue - worker builds LAST after all plugins.
+ *
+ * Build Requirement: All workspace packages must be built before workers can run.
+ * Run `pnpm build` from the monorepo root to compile all packages.
+ */
+import { parentPort, workerData } from 'node:worker_threads';
+import { Project } from 'ts-morph';
+import { createPublicApi } from '@angular-modernizer/api';
+import { ContextFactory } from '@angular-modernizer/plugin-system';
+import { ArchitecturePlugin } from '@angular-modernizer/plugin-architecture';
+import { SolidPlugin } from '@angular-modernizer/plugin-solid';
+import { AngularPlugin } from '@angular-modernizer/plugin-angular';
+import { AnalyzerPlugin } from '@angular-modernizer/plugin-analyzer';
+import { StandalonePlugin } from '@angular-modernizer/plugin-standalone';
+/**
+ * Worker state (isolated per worker)
+ */
+let project = null;
+let workerId;
+let publicApi = null;
+const pluginRulesCache = new Map();
+/**
+ * Initialize worker with Project and plugins.
+ * Loads full project from tsconfig because analysis rules need cross-file context
+ * (inheritance chains, import analysis, etc.)
+ */
+function initializeWorker() {
+    const initStart = Date.now();
+    const data = workerData;
+    workerId = data.workerId;
+    log(`Worker ${workerId} starting initialization...`);
+    // Create isolated Project instance - load all files for cross-file analysis
+    project = new Project({
+        tsConfigFilePath: data.tsConfigPath,
+        skipAddingFilesFromTsConfig: false, // Load all files for cross-file analysis
+    });
+    const fileCount = project.getSourceFiles().length;
+    const projectLoadTime = Date.now() - initStart;
+    log(`Worker ${workerId} loaded project with ${fileCount} files in ${projectLoadTime}ms`);
+    // Create PublicApi instance for this worker
+    publicApi = createPublicApi(project);
+    const totalInitTime = Date.now() - initStart;
+    log(`Worker ${workerId} fully initialized in ${totalInitTime}ms`);
+}
+/**
+ * Load plugin rules based on plugin IDs.
+ * Rules are cached per plugin ID to avoid re-instantiation.
+ */
+function loadPluginRules(pluginIds) {
+    const allRules = [];
+    for (const pluginId of pluginIds) {
+        // Check cache first
+        if (pluginRulesCache.has(pluginId)) {
+            const cachedRules = pluginRulesCache.get(pluginId);
+            allRules.push(...cachedRules);
+            continue;
+        }
+        // Load plugin and get its rules
+        let rules = [];
+        switch (pluginId) {
+            case 'architecture':
+            case '@angular-modernizer/plugin-architecture': {
+                try {
+                    const plugin = new ArchitecturePlugin();
+                    rules = plugin.getAnalysisRules();
+                }
+                catch (error) {
+                    log(`Warning: Failed to load ArchitecturePlugin: ${error instanceof Error ? error.message : String(error)}`);
+                }
+                break;
+            }
+            case 'solid':
+            case '@angular-modernizer/plugin-solid': {
+                try {
+                    const plugin = new SolidPlugin();
+                    rules = plugin.getAnalysisRules();
+                }
+                catch (error) {
+                    log(`Warning: Failed to load SolidPlugin: ${error instanceof Error ? error.message : String(error)}`);
+                }
+                break;
+            }
+            case 'angular':
+            case '@angular-modernizer/plugin-angular': {
+                try {
+                    const plugin = new AngularPlugin();
+                    rules = plugin.getAnalysisRules();
+                }
+                catch (error) {
+                    log(`Warning: Failed to load AngularPlugin: ${error instanceof Error ? error.message : String(error)}`);
+                }
+                break;
+            }
+            case 'analyzer':
+            case '@angular-modernizer/plugin-analyzer': {
+                try {
+                    const plugin = new AnalyzerPlugin();
+                    rules = plugin.getAnalysisRules();
+                }
+                catch (error) {
+                    log(`Warning: Failed to load AnalyzerPlugin: ${error instanceof Error ? error.message : String(error)}`);
+                }
+                break;
+            }
+            case 'standalone':
+            case '@angular-modernizer/plugin-standalone': {
+                try {
+                    const plugin = new StandalonePlugin();
+                    // StandalonePlugin has transform rules, not analysis rules
+                    // Use getTransformRules if available, otherwise empty array
+                    rules =
+                        plugin.getAnalysisRules?.() ?? [];
+                }
+                catch (error) {
+                    log(`Warning: Failed to load StandalonePlugin: ${error instanceof Error ? error.message : String(error)}`);
+                }
+                break;
+            }
+            default:
+                log(`Warning: Unknown plugin ID: ${pluginId}`);
+                continue;
+        }
+        // Cache the rules
+        pluginRulesCache.set(pluginId, rules);
+        allRules.push(...rules);
+    }
+    return allRules;
+}
+/**
+ * Filter rules by rule IDs if specified.
+ */
+function filterRulesByIds(rules, ruleIds) {
+    if (!ruleIds || ruleIds.length === 0) {
+        return rules;
+    }
+    return rules.filter((rule) => ruleIds.includes(rule.id));
+}
+/**
+ * Convert plugin-system AnalysisResult to orchestration AnalysisResult.
+ * The orchestration type requires a severity field.
+ */
+function convertToOrchestrationResult(pluginResult) {
+    return {
+        ruleId: pluginResult.ruleId,
+        filePath: pluginResult.filePath,
+        message: pluginResult.message,
+        severity: 'warning', // Default severity (plugin results don't have this field)
+        line: pluginResult.line,
+        column: pluginResult.column,
+    };
+}
+/**
+ * Execute analysis task.
+ */
+async function executeTask(task) {
+    const startTime = Date.now();
+    log(`Starting task ${task.id} for file: ${task.filePath}`);
+    try {
+        if (!project) {
+            throw new Error('Worker not initialized');
+        }
+        if (!publicApi) {
+            throw new Error('PublicApi not initialized');
+        }
+        // Get the source file from the pre-loaded project
+        log(`Getting source file for ${task.filePath}`);
+        const sourceFile = project.getSourceFile(task.filePath);
+        if (!sourceFile) {
+            throw new Error(`Source file not found in project: ${task.filePath}`);
+        }
+        // Load plugin rules based on task.pluginIds
+        log(`Loading plugin rules for plugins: ${task.pluginIds.join(', ') || 'none'}`);
+        const allRules = loadPluginRules(task.pluginIds || []);
+        // Filter rules by ruleIds if specified
+        const rules = filterRulesByIds(allRules, task.ruleIds);
+        log(`Executing ${rules.length} rules for ${task.filePath}`);
+        if (rules.length === 0) {
+            log(`Warning: No rules to execute for task ${task.id}`);
+            return {
+                taskId: task.id,
+                results: [],
+                duration: Date.now() - startTime,
+                workerId,
+            };
+        }
+        // Create analysis context
+        const context = ContextFactory.createAnalysisContext({
+            sourceFile,
+            project,
+            api: publicApi,
+            config: task.config ?? {},
+        });
+        // Execute all rules and collect results
+        const results = [];
+        for (const rule of rules) {
+            try {
+                log(`Executing rule ${rule.id} for ${task.filePath}`);
+                const ruleStartTime = Date.now();
+                const ruleResults = await rule.analyze(context);
+                const ruleDuration = Date.now() - ruleStartTime;
+                log(`Rule ${rule.id} completed in ${ruleDuration}ms with ${ruleResults.length} results`);
+                // Convert plugin results to orchestration results
+                const convertedResults = ruleResults.map((r) => convertToOrchestrationResult(r));
+                results.push(...convertedResults);
+            }
+            catch (ruleError) {
+                // Log rule error but continue with other rules
+                log(`Error executing rule ${rule.id}: ${ruleError instanceof Error ? ruleError.message : String(ruleError)}`);
+            }
+        }
+        const duration = Date.now() - startTime;
+        log(`Task ${task.id} completed in ${duration}ms with ${results.length} total results`);
+        return {
+            taskId: task.id,
+            results,
+            duration,
+            workerId,
+        };
+    }
+    catch (error) {
+        const duration = Date.now() - startTime;
+        log(`Task ${task.id} failed: ${error instanceof Error ? error.message : String(error)}`);
+        return {
+            taskId: task.id,
+            results: [],
+            duration,
+            error: error instanceof Error ? error.message : String(error),
+            workerId,
+        };
+    }
+}
+/**
+ * Main message handler.
+ */
+if (parentPort) {
+    // Set up global error handlers for uncaught errors
+    process.on('uncaughtException', (error) => {
+        const data = workerData;
+        console.error(`[Worker ${data.workerId}] Uncaught exception:`, error);
+        if (parentPort) {
+            parentPort.postMessage({
+                type: 'init-error',
+                workerId: data.workerId,
+                error: error.message,
+            });
+        }
+        process.exit(1);
+    });
+    process.on('unhandledRejection', (reason) => {
+        const data = workerData;
+        console.error(`[Worker ${data.workerId}] Unhandled rejection:`, reason);
+        if (parentPort) {
+            parentPort.postMessage({
+                type: 'init-error',
+                workerId: data.workerId,
+                error: String(reason),
+            });
+        }
+        process.exit(1);
+    });
+    // Initialize on startup (with error handling)
+    try {
+        initializeWorker();
+        // Send ready signal to parent (after initialization)
+        const data = workerData;
+        parentPort.postMessage({ type: 'ready', workerId: data.workerId });
+    }
+    catch (error) {
+        // Send initialization error to parent
+        const data = workerData;
+        const errorMessage = error instanceof Error ? error.message : String(error);
+        console.error(`[Worker ${data.workerId}] Initialization error: ${errorMessage}`);
+        parentPort.postMessage({
+            type: 'init-error',
+            workerId: data.workerId,
+            error: errorMessage,
+        });
+        process.exit(1);
+    }
+    // Handle incoming tasks
+    parentPort.on('message', (task) => {
+        log(`Received task ${task.id}`);
+        void executeTask(task)
+            .then((result) => {
+            parentPort.postMessage(result);
+        })
+            .catch((error) => {
+            // Send error result
+            const errorResult = {
+                taskId: task.id,
+                results: [],
+                duration: 0,
+                error: error instanceof Error ? error.message : String(error),
+                workerId,
+            };
+            parentPort.postMessage(errorResult);
+        });
+    });
+    // Handle errors
+    parentPort.on('messageerror', (error) => {
+        log(`Message error: ${String(error)}`);
+    });
+}
+else {
+    throw new Error('This script must be run as a worker thread');
+}
+/**
+ * Log message (includes worker ID).
+ */
+function log(message) {
+    console.info(`[Worker ${workerId}] ${message}`);
+}
+//# sourceMappingURL=analysis-worker.js.map

package/dist/analysis-worker.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"analysis-worker.js","sourceRoot":"","sources":["../src/analysis-worker.ts"],"names":[],"mappings":"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"}

package/dist/index.d.ts

@@ -0,0 +1,24 @@
+/**
+ * @angular-modernizer/worker
+ *
+ * Worker thread script for parallel analysis.
+ * This package must be built LAST because it depends on ALL plugins.
+ */
+/**
+ * Get the path to the analysis worker script.
+ * Used by WorkerPool to spawn worker threads.
+ *
+ * @example
+ * ```typescript
+ * import { getWorkerScriptPath } from '@angular-modernizer/worker';
+ * import { WorkerPool } from '@angular-modernizer/core';
+ *
+ * const pool = new WorkerPool({
+ *   tsConfigPath: '/path/to/tsconfig.json',
+ *   workerScriptPath: getWorkerScriptPath(),
+ * });
+ * ```
+ */
+export declare function getWorkerScriptPath(): string;
+export type { WorkerTask, WorkerResult } from '@angular-modernizer/core';
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAKH;;;;;;;;;;;;;;GAcG;AACH,wBAAgB,mBAAmB,IAAI,MAAM,CAG5C;AAGD,YAAY,EAAE,UAAU,EAAE,YAAY,EAAE,MAAM,0BAA0B,CAAC"}

package/dist/index.js

@@ -0,0 +1,28 @@
+/**
+ * @angular-modernizer/worker
+ *
+ * Worker thread script for parallel analysis.
+ * This package must be built LAST because it depends on ALL plugins.
+ */
+import { dirname, join } from 'node:path';
+import { fileURLToPath } from 'node:url';
+/**
+ * Get the path to the analysis worker script.
+ * Used by WorkerPool to spawn worker threads.
+ *
+ * @example
+ * ```typescript
+ * import { getWorkerScriptPath } from '@angular-modernizer/worker';
+ * import { WorkerPool } from '@angular-modernizer/core';
+ *
+ * const pool = new WorkerPool({
+ *   tsConfigPath: '/path/to/tsconfig.json',
+ *   workerScriptPath: getWorkerScriptPath(),
+ * });
+ * ```
+ */
+export function getWorkerScriptPath() {
+    const __dirname = dirname(fileURLToPath(import.meta.url));
+    return join(__dirname, 'analysis-worker.js');
+}
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,EAAE,OAAO,EAAE,IAAI,EAAE,MAAM,WAAW,CAAC;AAC1C,OAAO,EAAE,aAAa,EAAE,MAAM,UAAU,CAAC;AAEzC;;;;;;;;;;;;;;GAcG;AACH,MAAM,UAAU,mBAAmB;IACjC,MAAM,SAAS,GAAG,OAAO,CAAC,aAAa,CAAC,MAAM,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,CAAC;IAC1D,OAAO,IAAI,CAAC,SAAS,EAAE,oBAAoB,CAAC,CAAC;AAC/C,CAAC"}

package/package.json

@@ -0,0 +1,74 @@
+{
+  "name": "@angular-modernizer/worker",
+  "version": "0.1.0",
+  "description": "Worker thread script for parallel analysis in the Angular Modernization Platform",
+  "keywords": [
+    "angular",
+    "modernization",
+    "typescript",
+    "ast",
+    "ts-morph",
+    "worker-threads",
+    "parallelism"
+  ],
+  "license": "MIT",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/eiweiss/tsanalyzer.git",
+    "directory": "packages/worker"
+  },
+  "homepage": "https://github.com/eiweiss/tsanalyzer#readme",
+  "bugs": "https://github.com/eiweiss/tsanalyzer/issues",
+  "type": "module",
+  "main": "./dist/index.js",
+  "types": "./dist/index.d.ts",
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "import": "./dist/index.js"
+    },
+    "./analysis-worker": {
+      "types": "./dist/analysis-worker.d.ts",
+      "import": "./dist/analysis-worker.js"
+    }
+  },
+  "files": [
+    "dist",
+    "src",
+    "!dist/**/__tests__/**",
+    "!src/**/__tests__/**",
+    "!src/**/*.test.ts",
+    "!src/**/*.spec.ts"
+  ],
+  "dependencies": {
+    "ts-morph": "^27.0.2",
+    "@angular-modernizer/core": "0.1.0",
+    "@angular-modernizer/plugin-system": "0.1.0",
+    "@angular-modernizer/plugin-analyzer": "0.1.0",
+    "@angular-modernizer/api": "0.1.0",
+    "@angular-modernizer/plugin-solid": "0.1.0",
+    "@angular-modernizer/plugin-angular": "0.1.0",
+    "@angular-modernizer/plugin-architecture": "0.1.0",
+    "@angular-modernizer/plugin-standalone": "0.1.0"
+  },
+  "devDependencies": {
+    "@types/node": "^24.10.0",
+    "rimraf": "^6.1.0",
+    "typescript": "^5.9.3"
+  },
+  "publishConfig": {
+    "access": "public"
+  },
+  "typedocOptions": {
+    "entryPoints": [
+      "./src/index.ts"
+    ],
+    "tsconfig": "./tsconfig.json"
+  },
+  "scripts": {
+    "build": "tsc --build",
+    "test": "jest --passWithNoTests",
+    "lint": "eslint src/**/*.ts",
+    "clean": "rimraf dist tsconfig.tsbuildinfo"
+  }
+}

package/src/analysis-worker.ts

@@ -0,0 +1,408 @@
+/**
+ * @angular-modernizer/worker - Analysis worker script for worker thread execution
+ *
+ * Each worker:
+ * - Creates isolated Project instance (ts-morph) - OPTIMIZED: lazy loading
+ * - Initializes PublicApi and plugins
+ * - Receives tasks via parentPort messages
+ * - Executes analysis rules
+ * - Returns results to main thread
+ *
+ * Communication Protocol:
+ * Main → Worker: WorkerTask { taskId, filePath, ruleIds, pluginIds, config }
+ * Worker → Main: WorkerResult { taskId, results, duration, error? }
+ *
+ * OPTIMIZATION: Workers now use lazy file loading instead of loading the entire
+ * project from tsconfig. This significantly reduces initialization time from
+ * ~2000ms to ~100ms per worker.
+ *
+ * This file is in @angular-modernizer/worker package which depends on ALL plugins.
+ * This solves the circular dependency issue - worker builds LAST after all plugins.
+ *
+ * Build Requirement: All workspace packages must be built before workers can run.
+ * Run `pnpm build` from the monorepo root to compile all packages.
+ */
+
+import { parentPort, workerData } from 'node:worker_threads';
+import { Project } from 'ts-morph';
+import type {
+  WorkerTask,
+  WorkerResult,
+  AnalysisResult as OrchestrationAnalysisResult,
+} from '@angular-modernizer/core';
+import type { PublicApi } from '@angular-modernizer/api';
+import { createPublicApi } from '@angular-modernizer/api';
+import type {
+  AnalysisRule,
+  AnalysisResult as PluginAnalysisResult,
+  AnalysisContext,
+} from '@angular-modernizer/plugin-system';
+import { ContextFactory } from '@angular-modernizer/plugin-system';
+import { ArchitecturePlugin } from '@angular-modernizer/plugin-architecture';
+import { SolidPlugin } from '@angular-modernizer/plugin-solid';
+import { AngularPlugin } from '@angular-modernizer/plugin-angular';
+import { AnalyzerPlugin } from '@angular-modernizer/plugin-analyzer';
+import { StandalonePlugin } from '@angular-modernizer/plugin-standalone';
+
+// Worker initialization data
+interface WorkerData {
+  workerId: number;
+  tsConfigPath: string;
+}
+
+/**
+ * Worker state (isolated per worker)
+ */
+let project: Project | null = null;
+let workerId: number;
+let publicApi: PublicApi | null = null;
+const pluginRulesCache = new Map<string, AnalysisRule[]>();
+
+/**
+ * Initialize worker with Project and plugins.
+ * Loads full project from tsconfig because analysis rules need cross-file context
+ * (inheritance chains, import analysis, etc.)
+ */
+function initializeWorker(): void {
+  const initStart = Date.now();
+  const data = workerData as WorkerData;
+  workerId = data.workerId;
+
+  log(`Worker ${workerId} starting initialization...`);
+
+  // Create isolated Project instance - load all files for cross-file analysis
+  project = new Project({
+    tsConfigFilePath: data.tsConfigPath,
+    skipAddingFilesFromTsConfig: false, // Load all files for cross-file analysis
+  });
+
+  const fileCount = project.getSourceFiles().length;
+  const projectLoadTime = Date.now() - initStart;
+  log(
+    `Worker ${workerId} loaded project with ${fileCount} files in ${projectLoadTime}ms`,
+  );
+
+  // Create PublicApi instance for this worker
+  publicApi = createPublicApi(project);
+
+  const totalInitTime = Date.now() - initStart;
+  log(`Worker ${workerId} fully initialized in ${totalInitTime}ms`);
+}
+
+/**
+ * Load plugin rules based on plugin IDs.
+ * Rules are cached per plugin ID to avoid re-instantiation.
+ */
+function loadPluginRules(pluginIds: string[]): AnalysisRule[] {
+  const allRules: AnalysisRule[] = [];
+
+  for (const pluginId of pluginIds) {
+    // Check cache first
+    if (pluginRulesCache.has(pluginId)) {
+      const cachedRules = pluginRulesCache.get(pluginId)!;
+      allRules.push(...cachedRules);
+      continue;
+    }
+
+    // Load plugin and get its rules
+    let rules: AnalysisRule[] = [];
+
+    switch (pluginId) {
+      case 'architecture':
+      case '@angular-modernizer/plugin-architecture': {
+        try {
+          const plugin = new ArchitecturePlugin();
+          rules = plugin.getAnalysisRules();
+        } catch (error) {
+          log(
+            `Warning: Failed to load ArchitecturePlugin: ${error instanceof Error ? error.message : String(error)}`,
+          );
+        }
+        break;
+      }
+      case 'solid':
+      case '@angular-modernizer/plugin-solid': {
+        try {
+          const plugin = new SolidPlugin();
+          rules = plugin.getAnalysisRules();
+        } catch (error) {
+          log(
+            `Warning: Failed to load SolidPlugin: ${error instanceof Error ? error.message : String(error)}`,
+          );
+        }
+        break;
+      }
+      case 'angular':
+      case '@angular-modernizer/plugin-angular': {
+        try {
+          const plugin = new AngularPlugin();
+          rules = plugin.getAnalysisRules();
+        } catch (error) {
+          log(
+            `Warning: Failed to load AngularPlugin: ${error instanceof Error ? error.message : String(error)}`,
+          );
+        }
+        break;
+      }
+      case 'analyzer':
+      case '@angular-modernizer/plugin-analyzer': {
+        try {
+          const plugin = new AnalyzerPlugin();
+          rules = plugin.getAnalysisRules();
+        } catch (error) {
+          log(
+            `Warning: Failed to load AnalyzerPlugin: ${error instanceof Error ? error.message : String(error)}`,
+          );
+        }
+        break;
+      }
+      case 'standalone':
+      case '@angular-modernizer/plugin-standalone': {
+        try {
+          const plugin = new StandalonePlugin();
+          // StandalonePlugin has transform rules, not analysis rules
+          // Use getTransformRules if available, otherwise empty array
+          rules =
+            (
+              plugin as unknown as { getAnalysisRules?: () => AnalysisRule[] }
+            ).getAnalysisRules?.() ?? [];
+        } catch (error) {
+          log(
+            `Warning: Failed to load StandalonePlugin: ${error instanceof Error ? error.message : String(error)}`,
+          );
+        }
+        break;
+      }
+      default:
+        log(`Warning: Unknown plugin ID: ${pluginId}`);
+        continue;
+    }
+
+    // Cache the rules
+    pluginRulesCache.set(pluginId, rules);
+    allRules.push(...rules);
+  }
+
+  return allRules;
+}
+
+/**
+ * Filter rules by rule IDs if specified.
+ */
+function filterRulesByIds(
+  rules: AnalysisRule[],
+  ruleIds?: string[],
+): AnalysisRule[] {
+  if (!ruleIds || ruleIds.length === 0) {
+    return rules;
+  }
+
+  return rules.filter((rule) => ruleIds.includes(rule.id));
+}
+
+/**
+ * Convert plugin-system AnalysisResult to orchestration AnalysisResult.
+ * The orchestration type requires a severity field.
+ */
+function convertToOrchestrationResult(
+  pluginResult: PluginAnalysisResult,
+): OrchestrationAnalysisResult {
+  return {
+    ruleId: pluginResult.ruleId,
+    filePath: pluginResult.filePath,
+    message: pluginResult.message,
+    severity: 'warning', // Default severity (plugin results don't have this field)
+    line: pluginResult.line,
+    column: pluginResult.column,
+  };
+}
+
+/**
+ * Execute analysis task.
+ */
+async function executeTask(task: WorkerTask): Promise<WorkerResult> {
+  const startTime = Date.now();
+  log(`Starting task ${task.id} for file: ${task.filePath}`);
+
+  try {
+    if (!project) {
+      throw new Error('Worker not initialized');
+    }
+
+    if (!publicApi) {
+      throw new Error('PublicApi not initialized');
+    }
+
+    // Get the source file from the pre-loaded project
+    log(`Getting source file for ${task.filePath}`);
+    const sourceFile = project.getSourceFile(task.filePath);
+    if (!sourceFile) {
+      throw new Error(`Source file not found in project: ${task.filePath}`);
+    }
+
+    // Load plugin rules based on task.pluginIds
+    log(
+      `Loading plugin rules for plugins: ${task.pluginIds.join(', ') || 'none'}`,
+    );
+    const allRules = loadPluginRules(task.pluginIds || []);
+
+    // Filter rules by ruleIds if specified
+    const rules = filterRulesByIds(allRules, task.ruleIds);
+    log(`Executing ${rules.length} rules for ${task.filePath}`);
+
+    if (rules.length === 0) {
+      log(`Warning: No rules to execute for task ${task.id}`);
+      return {
+        taskId: task.id,
+        results: [],
+        duration: Date.now() - startTime,
+        workerId,
+      };
+    }
+
+    // Create analysis context
+    const context: AnalysisContext = ContextFactory.createAnalysisContext({
+      sourceFile,
+      project,
+      api: publicApi,
+      config: task.config ?? {},
+    });
+
+    // Execute all rules and collect results
+    const results: OrchestrationAnalysisResult[] = [];
+    for (const rule of rules) {
+      try {
+        log(`Executing rule ${rule.id} for ${task.filePath}`);
+        const ruleStartTime = Date.now();
+        const ruleResults = await rule.analyze(context);
+        const ruleDuration = Date.now() - ruleStartTime;
+        log(
+          `Rule ${rule.id} completed in ${ruleDuration}ms with ${ruleResults.length} results`,
+        );
+        // Convert plugin results to orchestration results
+        const convertedResults = ruleResults.map((r: PluginAnalysisResult) =>
+          convertToOrchestrationResult(r),
+        );
+        results.push(...convertedResults);
+      } catch (ruleError) {
+        // Log rule error but continue with other rules
+        log(
+          `Error executing rule ${rule.id}: ${ruleError instanceof Error ? ruleError.message : String(ruleError)}`,
+        );
+      }
+    }
+
+    const duration = Date.now() - startTime;
+    log(
+      `Task ${task.id} completed in ${duration}ms with ${results.length} total results`,
+    );
+
+    return {
+      taskId: task.id,
+      results,
+      duration,
+      workerId,
+    };
+  } catch (error) {
+    const duration = Date.now() - startTime;
+    log(
+      `Task ${task.id} failed: ${error instanceof Error ? error.message : String(error)}`,
+    );
+    return {
+      taskId: task.id,
+      results: [],
+      duration,
+      error: error instanceof Error ? error.message : String(error),
+      workerId,
+    };
+  }
+}
+
+/**
+ * Main message handler.
+ */
+if (parentPort) {
+  // Set up global error handlers for uncaught errors
+  process.on('uncaughtException', (error) => {
+    const data = workerData as WorkerData;
+    console.error(`[Worker ${data.workerId}] Uncaught exception:`, error);
+    if (parentPort) {
+      parentPort.postMessage({
+        type: 'init-error',
+        workerId: data.workerId,
+        error: error.message,
+      });
+    }
+    process.exit(1);
+  });
+
+  process.on('unhandledRejection', (reason) => {
+    const data = workerData as WorkerData;
+    console.error(`[Worker ${data.workerId}] Unhandled rejection:`, reason);
+    if (parentPort) {
+      parentPort.postMessage({
+        type: 'init-error',
+        workerId: data.workerId,
+        error: String(reason),
+      });
+    }
+    process.exit(1);
+  });
+
+  // Initialize on startup (with error handling)
+  try {
+    initializeWorker();
+
+    // Send ready signal to parent (after initialization)
+    const data = workerData as WorkerData;
+    parentPort.postMessage({ type: 'ready', workerId: data.workerId });
+  } catch (error) {
+    // Send initialization error to parent
+    const data = workerData as WorkerData;
+    const errorMessage = error instanceof Error ? error.message : String(error);
+    console.error(
+      `[Worker ${data.workerId}] Initialization error: ${errorMessage}`,
+    );
+    parentPort.postMessage({
+      type: 'init-error',
+      workerId: data.workerId,
+      error: errorMessage,
+    });
+    process.exit(1);
+  }
+
+  // Handle incoming tasks
+  parentPort.on('message', (task: WorkerTask) => {
+    log(`Received task ${task.id}`);
+
+    void executeTask(task)
+      .then((result) => {
+        parentPort!.postMessage(result);
+      })
+      .catch((error) => {
+        // Send error result
+        const errorResult: WorkerResult = {
+          taskId: task.id,
+          results: [],
+          duration: 0,
+          error: error instanceof Error ? error.message : String(error),
+          workerId,
+        };
+        parentPort!.postMessage(errorResult);
+      });
+  });
+
+  // Handle errors
+  parentPort.on('messageerror', (error) => {
+    log(`Message error: ${String(error)}`);
+  });
+} else {
+  throw new Error('This script must be run as a worker thread');
+}
+
+/**
+ * Log message (includes worker ID).
+ */
+function log(message: string): void {
+  console.info(`[Worker ${workerId}] ${message}`);
+}

package/src/index.ts

@@ -0,0 +1,32 @@
+/**
+ * @angular-modernizer/worker
+ *
+ * Worker thread script for parallel analysis.
+ * This package must be built LAST because it depends on ALL plugins.
+ */
+
+import { dirname, join } from 'node:path';
+import { fileURLToPath } from 'node:url';
+
+/**
+ * Get the path to the analysis worker script.
+ * Used by WorkerPool to spawn worker threads.
+ *
+ * @example
+ * ```typescript
+ * import { getWorkerScriptPath } from '@angular-modernizer/worker';
+ * import { WorkerPool } from '@angular-modernizer/core';
+ *
+ * const pool = new WorkerPool({
+ *   tsConfigPath: '/path/to/tsconfig.json',
+ *   workerScriptPath: getWorkerScriptPath(),
+ * });
+ * ```
+ */
+export function getWorkerScriptPath(): string {
+  const __dirname = dirname(fileURLToPath(import.meta.url));
+  return join(__dirname, 'analysis-worker.js');
+}
+
+// Re-export worker types for convenience
+export type { WorkerTask, WorkerResult } from '@angular-modernizer/core';