entkapp 5.0.0 → 5.2.0

package/src/performance/WorkerTaskRunner.js

@@ -64,7 +64,7 @@ async function runTask() {
           success = await oxcAnalyzer.parseFile(filePath, content, node);
         }
       } catch (oxcError) {
-        success = false; // Fehler abfangen, um den TS-Fallback zu erzwingen
+        success = false; // Catch error to force TS fallback
       }
       
       // UPGRADE: Improved fallback logic for CommonJS files in worker threads
@@ -78,8 +78,8 @@ async function runTask() {
       // 3. OXC found no dependencies but file has CommonJS keywords
       if (!success || (oxcFailedToFindDependencies && (hasImportExportKeywords || hasCommonJSKeywords))) {
         try {
-          // CRITICAL FIX: Scope-Reset für den TS-Parser im isolierten Thread-Kontext
-          // Verhindert, dass unvollständige Scope-Ketten der vorangegangenen Datei zu 'children of undefined' führen
+          // CRITICAL FIX: Scope reset for the TS parser in isolated thread context
+          // Prevents incomplete scope chains from the previous file from leading to 'children of undefined'
           astAnalyzer.currentScope = { symbols: new Map(), parent: null, children: [] };
           astAnalyzer.scopeStack = [astAnalyzer.currentScope];
           astAnalyzer.scopeCounter = 0;
@@ -87,14 +87,14 @@ async function runTask() {
           await astAnalyzer.parseFile(filePath, content, node);
         } catch (tsError) {
           if (contextOptions.verbose) {
-            console.error(`[Worker-Fallback-Error] TS-Parser versagte bei ${filePath}: ${tsError.message}`);
+            console.error(`[Worker-Fallback-Error] TS parser failed at ${filePath}: ${tsError.message}`);
           }
           results.push(null);
           continue;
         }
       }
 
-      // Sichere Serialisierung: Verhindert Abstürze, falls internalExports oder symbolSourceLocations keine Maps mehr sind
+      // Safe serialization: Prevents crashes if internalExports or symbolSourceLocations are no longer Maps
       const serializedExports = node.internalExports instanceof Map 
         ? Object.fromEntries(node.internalExports) 
         : {};
@@ -129,9 +129,9 @@ async function runTask() {
       });
     } catch (err) {
       if (contextOptions.verbose) {
-        console.error(`[Worker-Loop-Exception] Fehler bei Datei ${filePath}: ${err.message}`);
+        console.error(`[Worker-Loop-Exception] Error in file ${filePath}: ${err.message}`);
       }
-      results.push(null); // Modul überspringen, Thread am Leben erhalten
+      results.push(null); // Skip module, keep thread alive
     }
   }
 

package/src/plugins/BasePlugin.js

@@ -3,8 +3,9 @@ import path from 'path';
 
 /**
  * Base class for all entkapp plugins.
- * Defines the contract for ecosystem detection and entry point mapping.
- * Version 3.2.0: Added support for dynamic custom getters.
+ * Defines the contract for ecosystem detection, entry point mapping,
+ * and missing dependency / devDependency detection.
+ * Version 5.0.0: Added getMissingDependencies(), getOrphanedConfigs(), runDependencyDiagnostics().
  */
 export class BasePlugin {
     constructor(context) {
@@ -40,6 +41,174 @@ export class BasePlugin {
         return ['default'];
     }
 
+    /**
+     * Returns the npm package names required for this plugin to work.
+     * Each entry is either a string or an object:
+     *   { name: string, dev?: boolean, optional?: boolean }
+     *   - dev: true  => expected in devDependencies
+     *   - dev: false => expected in dependencies
+     *   - optional   => only warn, not error
+     *
+     * Override in subclasses to enable automatic dependency checking.
+     * @returns {Array<string | {name: string, dev?: boolean, optional?: boolean}>}
+     */
+    getRequiredPackages() {
+        return [];
+    }
+
+    /**
+     * Version 5.0.0: Checks whether all required packages are present in package.json.
+     * Returns an array of diagnostic objects describing missing or misplaced dependencies.
+     *
+     * @param {string} baseDir - The project root directory
+     * @returns {Promise<Array>}
+     */
+    async getMissingDependencies(baseDir) {
+        const diagnostics = [];
+        const requiredPackages = this.getRequiredPackages();
+        if (requiredPackages.length === 0) return diagnostics;
+
+        let pkg = null;
+        try {
+            const raw = await fs.readFile(path.join(baseDir, 'package.json'), 'utf8');
+            pkg = JSON.parse(raw);
+        } catch {
+            return diagnostics;
+        }
+
+        const deps = pkg.dependencies || {};
+        const devDeps = pkg.devDependencies || {};
+
+        for (const entry of requiredPackages) {
+            const pkgName = typeof entry === 'string' ? entry : entry.name;
+            const isDev = typeof entry === 'object' ? entry.dev : undefined;
+            const isOptional = typeof entry === 'object' ? (entry.optional ?? false) : false;
+
+            const inDeps = pkgName in deps;
+            const inDevDeps = pkgName in devDeps;
+            const found = inDeps ? 'dependencies' : inDevDeps ? 'devDependencies' : null;
+
+            if (!found) {
+                let triggerFile = null;
+                for (const cfgFile of this.getConfigFiles()) {
+                    try {
+                        await fs.access(path.join(baseDir, cfgFile));
+                        triggerFile = cfgFile;
+                        break;
+                    } catch { /* not found */ }
+                }
+
+                const expectedIn = isDev === true ? 'devDependencies' : isDev === false ? 'dependencies' : 'either';
+                const severity = isOptional ? 'warning' : 'error';
+
+                let message = `Plugin "${this.name}": package "${pkgName}" is not installed`;
+                if (triggerFile) {
+                    message += ` (config file "${triggerFile}" was found)`;
+                }
+                if (isDev === true) {
+                    message += ` — expected in devDependencies`;
+                } else if (isDev === false) {
+                    message += ` — expected in dependencies`;
+                }
+
+                diagnostics.push({
+                    plugin: this.name,
+                    package: pkgName,
+                    expectedIn,
+                    foundIn: null,
+                    configFile: triggerFile,
+                    severity,
+                    message,
+                });
+            } else if (isDev === true && found === 'dependencies') {
+                diagnostics.push({
+                    plugin: this.name,
+                    package: pkgName,
+                    expectedIn: 'devDependencies',
+                    foundIn: 'dependencies',
+                    configFile: null,
+                    severity: 'warning',
+                    message: `Plugin "${this.name}": package "${pkgName}" is in "dependencies" but should be in "devDependencies"`,
+                });
+            } else if (isDev === false && found === 'devDependencies') {
+                diagnostics.push({
+                    plugin: this.name,
+                    package: pkgName,
+                    expectedIn: 'dependencies',
+                    foundIn: 'devDependencies',
+                    configFile: null,
+                    severity: 'warning',
+                    message: `Plugin "${this.name}": package "${pkgName}" is in "devDependencies" but should be in "dependencies"`,
+                });
+            }
+        }
+
+        return diagnostics;
+    }
+
+    /**
+     * Version 5.0.0: Checks for config files that exist without the corresponding package.
+     * Detects "orphaned" configs – e.g. .prettierrc exists but prettier is not installed.
+     *
+     * @param {string} baseDir
+     * @returns {Promise<Array>}
+     */
+    async getOrphanedConfigs(baseDir) {
+        const diagnostics = [];
+        const requiredPackages = this.getRequiredPackages();
+        if (requiredPackages.length === 0) return diagnostics;
+
+        let pkg = null;
+        try {
+            const raw = await fs.readFile(path.join(baseDir, 'package.json'), 'utf8');
+            pkg = JSON.parse(raw);
+        } catch {
+            return diagnostics;
+        }
+
+        const allDeps = { ...(pkg.dependencies || {}), ...(pkg.devDependencies || {}) };
+
+        const anyPackagePresent = requiredPackages.some(entry => {
+            const pkgName = typeof entry === 'string' ? entry : entry.name;
+            return pkgName in allDeps;
+        });
+
+        if (!anyPackagePresent) {
+            for (const cfgFile of this.getConfigFiles()) {
+                try {
+                    await fs.access(path.join(baseDir, cfgFile));
+                    const missingPkgs = requiredPackages
+                        .map(e => typeof e === 'string' ? e : e.name)
+                        .filter(n => !(n in allDeps));
+
+                    diagnostics.push({
+                        plugin: this.name,
+                        configFile: cfgFile,
+                        severity: 'error',
+                        message: `Plugin "${this.name}": config file "${cfgFile}" exists but required package(s) [${missingPkgs.join(', ')}] are not installed`,
+                    });
+                } catch { /* file not found */ }
+            }
+        }
+
+        return diagnostics;
+    }
+
+    /**
+     * Version 5.0.0: Run all dependency diagnostics (missing + orphaned).
+     * Convenience method combining getMissingDependencies and getOrphanedConfigs.
+     *
+     * @param {string} baseDir
+     * @returns {Promise<Array>}
+     */
+    async runDependencyDiagnostics(baseDir) {
+        const [missing, orphaned] = await Promise.all([
+            this.getMissingDependencies(baseDir),
+            this.getOrphanedConfigs(baseDir),
+        ]);
+        return [...missing, ...orphaned];
+    }
+
     /**
      * Version 3.2.0: Dynamic getter for custom plugin properties.
      * @param {string} key - The property key to retrieve

package/src/plugins/PluginRegistry.js

@@ -2,11 +2,13 @@ import { loadAdditionalPlugins } from "./ecosystems/PluginLoader.js";
 import path from 'path';
 import fs from 'fs/promises';
 import { pathToFileURL } from 'url';
-import { execa } from 'execa';
 
 /**
+ * ============================================================================
+ * Plugin Registry for entkapp v5.0.0
+ * ============================================================================
  * Advanced Plugin Registry supporting Builtin and Custom plugins.
- * Enhanced with TypeScript support and folder-based plugin wrapping.
+ * v5.0.0: Added runAllDependencyDiagnostics() for project-wide dependency checks.
  */
 export class PluginRegistry {
     constructor(context) {
@@ -26,69 +28,118 @@ export class PluginRegistry {
                 useCustomPlugins: true,
             };
         }
-
-        if (this.config.useBuiltinPlugins) {
+        if (this.config.useBuiltinPlugins !== false) {
             await this.loadBuiltinPlugins();
         }
-
-        if (this.config.useCustomPlugins) {
+        if (this.config.useCustomPlugins !== false) {
             await this.loadCustomPlugins(projectRoot);
         }
-
-
     }
 
     async loadBuiltinPlugins() {
-        const { NextJsPlugin } = await import('./ecosystems/NextJsPlugin.js');
-        const { NuxtPlugin, RemixPlugin, SvelteKitPlugin, AstroPlugin, VitepressPlugin } = await import('./ecosystems/GenericPlugins.js');
-        const { TypeScriptPlugin } = await import('./ecosystems/TypeScriptPlugin.js');
-        const { ReactPlugin, VuePlugin, SveltePlugin, AngularPlugin } = await import('./ecosystems/ModernFrameworks.js');
-        const { GraphQLPlugin, DatabasePlugin } = await import('./ecosystems/BackendServices.js');
-        const {
-            TailwindPlugin, PostcssPlugin, JestPlugin, VitestPlugin,
-            PlaywrightPlugin, CypressPlugin, StorybookPlugin,
-            EslintPlugin, PrettierPlugin, HuskyPlugin, LintStagedPlugin,
-            CommitlintPlugin, BabelPlugin, RollupPlugin, WebpackPlugin,
-            GithubActionsPlugin
-        } = await import('./ecosystems/MorePlugins.js');
-
-        const builtins = [
-            new NextJsPlugin(this.context),
-            new NuxtPlugin(this.context),
-            new RemixPlugin(this.context),
-            new SvelteKitPlugin(this.context),
-            new AstroPlugin(this.context),
-            new VitepressPlugin(this.context),
-            new TypeScriptPlugin(this.context),
-            new ReactPlugin(this.context),
-            new VuePlugin(this.context),
-            new SveltePlugin(this.context),
-            new AngularPlugin(this.context),
-            new GraphQLPlugin(this.context),
-            new DatabasePlugin(this.context),
-            new TailwindPlugin(this.context),
-            new PostcssPlugin(this.context),
-            new JestPlugin(this.context),
-            new VitestPlugin(this.context),
-            new PlaywrightPlugin(this.context),
-            new CypressPlugin(this.context),
-            new StorybookPlugin(this.context),
-            new EslintPlugin(this.context),
-            new PrettierPlugin(this.context),
-            new HuskyPlugin(this.context),
-            new LintStagedPlugin(this.context),
-            new CommitlintPlugin(this.context),
-            new BabelPlugin(this.context),
-            new RollupPlugin(this.context),
-            new WebpackPlugin(this.context),
-            new GithubActionsPlugin(this.context)
-        ];
-
-        builtins.forEach(p => {
-            if (!this.config.enabledPlugins || this.config.enabledPlugins.includes(p.name)) {
-                this.register(p);
-            }
-        });
+        // Delegate to PluginLoader which registers all built-in plugins
+        loadAdditionalPlugins(this);
+
+        // Also load TypeScript and Next.js plugins (primary framework plugins)
+        const { ReactPlugin, VuePlugin, SveltePlugin, AngularPlugin, PreactPlugin, SolidPlugin, QwikPlugin, LitPlugin, NuxtPlugin, RemixPlugin, SvelteKitPlugin, AstroPlugin, VitepressPlugin, GatsbyPlugin, RedwoodPlugin, NextJsPlugin, TypeScriptPlugin, ExpressPlugin, FastifyPlugin, NestJsPlugin, HonoPlugin, KoaPlugin, ElysiaPlugin, GraphQLPlugin, ApolloPlugin, TRPCPlugin, DatabasePlugin, PrismaPlugin, DrizzlePlugin, MongoosePlugin, SupabasePlugin, FirebasePlugin, ClerkPlugin, ReduxPlugin, ZustandPlugin, JotaiPlugin, RecoilPlugin, MobXPlugin, PiniaPlugin, TanStackQueryPlugin, ReactRouterPlugin, TanStackRouterPlugin, VueRouterPlugin, AntdPlugin, MuiPlugin, ShadcnPlugin, RadixUIPlugin, ChakraUIPlugin, FramerMotionPlugin, GSAPPlugin, ZodPlugin, YupPlugin, ValibotPlugin, I18nextPlugin, VueI18nPlugin, SentryPlugin, OpenTelemetryPlugin, SocketIoPlugin, TailwindPlugin, PostcssPlugin, UnoCSSPlugin, StylelintPlugin, EslintPlugin, PrettierPlugin, BiomePlugin, OxlintPlugin, HuskyPlugin, LintStagedPlugin, CommitlintPlugin, ChangesetPlugin, BabelPlugin, SWCPlugin, VitePlugin, EsbuildPlugin, RollupPlugin, WebpackPlugin, ParcelPlugin, TurboPlugin, NxPlugin, JestPlugin, VitestPlugin, PlaywrightPlugin, CypressPlugin, StorybookPlugin, MswPlugin, GithubActionsPlugin, DockerPlugin, TerraformPlugin, EditorConfigPlugin, NvmPlugin, VoltaPlugin, DotenvPlugin, PnpmPlugin, YarnPlugin, BunPlugin, SwiperPlugin, QuillPlugin, EnvelopPlugin } = await import('./ecosystems/UltimateBundle.js');
+        this.register(new ReactPlugin(this.context));
+        this.register(new VuePlugin(this.context));
+        this.register(new SveltePlugin(this.context));
+        this.register(new AngularPlugin(this.context));
+        this.register(new PreactPlugin(this.context));
+        this.register(new SolidPlugin(this.context));
+        this.register(new QwikPlugin(this.context));
+        this.register(new LitPlugin(this.context));
+        this.register(new NuxtPlugin(this.context));
+        this.register(new RemixPlugin(this.context));
+        this.register(new SvelteKitPlugin(this.context));
+        this.register(new AstroPlugin(this.context));
+        this.register(new VitepressPlugin(this.context));
+        this.register(new GatsbyPlugin(this.context));
+        this.register(new RedwoodPlugin(this.context));
+        this.register(new NextJsPlugin(this.context));
+        this.register(new TypeScriptPlugin(this.context));
+        this.register(new ExpressPlugin(this.context));
+        this.register(new FastifyPlugin(this.context));
+        this.register(new NestJsPlugin(this.context));
+        this.register(new HonoPlugin(this.context));
+        this.register(new KoaPlugin(this.context));
+        this.register(new ElysiaPlugin(this.context));
+        this.register(new GraphQLPlugin(this.context));
+        this.register(new ApolloPlugin(this.context));
+        this.register(new TRPCPlugin(this.context));
+        this.register(new DatabasePlugin(this.context));
+        this.register(new PrismaPlugin(this.context));
+        this.register(new DrizzlePlugin(this.context));
+        this.register(new MongoosePlugin(this.context));
+        this.register(new SupabasePlugin(this.context));
+        this.register(new FirebasePlugin(this.context));
+        this.register(new ClerkPlugin(this.context));
+        this.register(new ReduxPlugin(this.context));
+        this.register(new ZustandPlugin(this.context));
+        this.register(new JotaiPlugin(this.context));
+        this.register(new RecoilPlugin(this.context));
+        this.register(new MobXPlugin(this.context));
+        this.register(new PiniaPlugin(this.context));
+        this.register(new TanStackQueryPlugin(this.context));
+        this.register(new ReactRouterPlugin(this.context));
+        this.register(new TanStackRouterPlugin(this.context));
+        this.register(new VueRouterPlugin(this.context));
+        this.register(new AntdPlugin(this.context));
+        this.register(new MuiPlugin(this.context));
+        this.register(new ShadcnPlugin(this.context));
+        this.register(new RadixUIPlugin(this.context));
+        this.register(new ChakraUIPlugin(this.context));
+        this.register(new FramerMotionPlugin(this.context));
+        this.register(new GSAPPlugin(this.context));
+        this.register(new ZodPlugin(this.context));
+        this.register(new YupPlugin(this.context));
+        this.register(new ValibotPlugin(this.context));
+        this.register(new I18nextPlugin(this.context));
+        this.register(new VueI18nPlugin(this.context));
+        this.register(new SentryPlugin(this.context));
+        this.register(new OpenTelemetryPlugin(this.context));
+        this.register(new SocketIoPlugin(this.context));
+        this.register(new TailwindPlugin(this.context));
+        this.register(new PostcssPlugin(this.context));
+        this.register(new UnoCSSPlugin(this.context));
+        this.register(new StylelintPlugin(this.context));
+        this.register(new EslintPlugin(this.context));
+        this.register(new PrettierPlugin(this.context));
+        this.register(new BiomePlugin(this.context));
+        this.register(new OxlintPlugin(this.context));
+        this.register(new HuskyPlugin(this.context));
+        this.register(new LintStagedPlugin(this.context));
+        this.register(new CommitlintPlugin(this.context));
+        this.register(new ChangesetPlugin(this.context));
+        this.register(new BabelPlugin(this.context));
+        this.register(new SWCPlugin(this.context));
+        this.register(new VitePlugin(this.context));
+        this.register(new EsbuildPlugin(this.context));
+        this.register(new RollupPlugin(this.context));
+        this.register(new WebpackPlugin(this.context));
+        this.register(new ParcelPlugin(this.context));
+        this.register(new TurboPlugin(this.context));
+        this.register(new NxPlugin(this.context));
+        this.register(new JestPlugin(this.context));
+        this.register(new VitestPlugin(this.context));
+        this.register(new PlaywrightPlugin(this.context));
+        this.register(new CypressPlugin(this.context));
+        this.register(new StorybookPlugin(this.context));
+        this.register(new MswPlugin(this.context));
+        this.register(new GithubActionsPlugin(this.context));
+        this.register(new DockerPlugin(this.context));
+        this.register(new TerraformPlugin(this.context));
+        this.register(new EditorConfigPlugin(this.context));
+        this.register(new NvmPlugin(this.context));
+        this.register(new VoltaPlugin(this.context));
+        this.register(new DotenvPlugin(this.context));
+        this.register(new PnpmPlugin(this.context));
+        this.register(new YarnPlugin(this.context));
+        this.register(new BunPlugin(this.context));
+        this.register(new SwiperPlugin(this.context));
+        this.register(new QuillPlugin(this.context));
+        this.register(new EnvelopPlugin(this.context));
     }
 
     async loadCustomPlugins(projectRoot) {
@@ -97,20 +148,17 @@ export class PluginRegistry {
             const entries = await fs.readdir(pluginsDir, { withFileTypes: true });
             for (const entry of entries) {
                 let pluginPath = path.join(pluginsDir, entry.name);
-                
-                // --- NEW: Folder-based plugin support ---
+                // Folder-based plugin support
                 if (entry.isDirectory()) {
-                    // Look for index.ts or index.js in the folder
                     const files = await fs.readdir(pluginPath);
                     if (files.includes('index.ts')) {
                         pluginPath = path.join(pluginPath, 'index.ts');
                     } else if (files.includes('index.js')) {
                         pluginPath = path.join(pluginPath, 'index.js');
                     } else {
-                        continue; // No entry point found in folder
+                        continue;
                     }
                 }
-
                 if (pluginPath.endsWith('.ts')) {
                     await this.loadTypeScriptPlugin(pluginPath);
                 } else if (pluginPath.endsWith('.js') || pluginPath.endsWith('.mjs')) {
@@ -134,27 +182,11 @@ export class PluginRegistry {
     }
 
     async loadTypeScriptPlugin(pluginPath) {
-        // --- TypeScript Plugin Support ---
-        // Transpile TS to JS on the fly using esbuild or similar if available, 
-        // or use a simple wrapper that uses ts-node/register if we were in that env.
-        // For this sandbox, we'll simulate a "wrap it" approach by using a temporary JS file.
         try {
-            const tempJsPath = pluginPath.replace(/\.ts$/, '.tmp.mjs');
-            // We use a simple trick: if we have oxc or esbuild, we could transpile.
-            // For now, let's assume we can use a basic transpilation or just inform the user.
-            // In a real scenario, we'd use `tsx` or `esbuild` to run this.
-            if (this.context.verbose) {
+            if (this.context?.verbose) {
                 console.log(`[PluginRegistry] Transpiling TS plugin: ${pluginPath}`);
             }
-            
-            // For the sake of "wrapping it", we'll use a dynamic loader if possible.
-            // In this implementation, we'll just try to import it if the runtime supports it (like node with --loader ts-node/esm)
-            // But since we want it to "just work", let's implement a more robust loading logic.
-            
-            // Implementation detail: we could use `esbuild` to bundle it to a string and then import.
-            // Since we don't want to add too many dependencies, we'll just log and try a standard import 
-            // which might fail without a loader, but it's the right direction.
-            await this.loadJavaScriptPlugin(pluginPath); 
+            await this.loadJavaScriptPlugin(pluginPath);
         } catch (e) {
             console.error(`[PluginRegistry] Failed to load TS plugin ${pluginPath}:`, e);
         }
@@ -183,4 +215,84 @@ export class PluginRegistry {
         }
         return active;
     }
+
+    /**
+     * Version 5.0.0: Run dependency diagnostics across all registered plugins.
+     * Returns a consolidated list of missing/misplaced dependencies and orphaned configs.
+     *
+     * @param {string} baseDir - The project root directory to check
+     * @returns {Promise<Array<{
+     *   plugin: string,
+     *   severity: 'error' | 'warning',
+     *   message: string,
+     *   package?: string,
+     *   configFile?: string,
+     *   expectedIn?: string,
+     *   foundIn?: string | null
+     * }>>}
+     */
+    async runAllDependencyDiagnostics(baseDir) {
+        const allDiagnostics = [];
+        const seenMessages = new Set();
+
+        for (const plugin of this.plugins.values()) {
+            if (typeof plugin.runDependencyDiagnostics === 'function') {
+                try {
+                    const diagnostics = await plugin.runDependencyDiagnostics(baseDir);
+                    for (const d of diagnostics) {
+                        // Deduplicate by message to avoid noise from overlapping plugins
+                        if (!seenMessages.has(d.message)) {
+                            seenMessages.add(d.message);
+                            allDiagnostics.push(d);
+                        }
+                    }
+                } catch (e) {
+                    if (this.context?.verbose) {
+                        console.warn(`[PluginRegistry] Dependency diagnostic failed for plugin "${plugin.name}":`, e.message);
+                    }
+                }
+            }
+        }
+
+        // Sort: errors first, then warnings; then alphabetically by plugin name
+        return allDiagnostics.sort((a, b) => {
+            if (a.severity !== b.severity) return a.severity === 'error' ? -1 : 1;
+            return a.plugin.localeCompare(b.plugin);
+        });
+    }
+
+    /**
+     * Version 5.0.0: Format dependency diagnostics for console output.
+     * @param {Array} diagnostics - Result of runAllDependencyDiagnostics()
+     * @returns {string} Formatted string ready for console output
+     */
+    formatDependencyDiagnostics(diagnostics) {
+        if (diagnostics.length === 0) {
+            return '[entkapp] No missing dependencies detected.';
+        }
+
+        const errors = diagnostics.filter(d => d.severity === 'error');
+        const warnings = diagnostics.filter(d => d.severity === 'warning');
+
+        const lines = [];
+        lines.push(`[entkapp] Dependency Diagnostics: ${errors.length} error(s), ${warnings.length} warning(s)`);
+        lines.push('');
+
+        if (errors.length > 0) {
+            lines.push('  Errors:');
+            for (const d of errors) {
+                lines.push(`    [ERROR]  ${d.message}`);
+            }
+            lines.push('');
+        }
+
+        if (warnings.length > 0) {
+            lines.push('  Warnings:');
+            for (const d of warnings) {
+                lines.push(`    [WARN]   ${d.message}`);
+            }
+        }
+
+        return lines.join('\n');
+    }
 }