mcp-react-toolkit 1.0.1 → 1.3.0

package/tools/json-viewer/build/index.js

@@ -1,5 +1,5 @@
 #!/usr/bin/env node
-import { McpServerBase } from '@mcp-showcase/shared';
+import { McpServerBase, safeReadJson } from '@mcp-showcase/shared';
 import * as fs from 'fs';
 import * as path from 'path';
 import * as os from 'os';
@@ -176,6 +176,28 @@ class JsonViewerServer extends McpServerBase {
             },
             required: ['data'],
         }, this.handleViewJson.bind(this));
+        this.addTool('view_json_file', 'Read a JSON file from disk and open an interactive HTML viewer — no need to paste raw JSON.', {
+            type: 'object',
+            properties: {
+                path: { type: 'string', description: 'Absolute or relative path to the JSON file' },
+                label: { type: 'string', description: 'Label for this viewer (defaults to the filename)' },
+                open: { type: 'boolean', description: 'Automatically open in browser (default: true)', default: true },
+            },
+            required: ['path'],
+        }, async (args) => {
+            const { path: filePath, label, open = true } = args;
+            try {
+                const resolved = path.resolve(filePath);
+                if (!fs.existsSync(resolved))
+                    throw new Error(`File not found: ${resolved}`);
+                const raw = fs.readFileSync(resolved, 'utf-8');
+                const derivedLabel = label ?? path.basename(resolved);
+                return this.handleViewJson({ data: raw, label: derivedLabel, open });
+            }
+            catch (error) {
+                return this.error(error);
+            }
+        });
         this.addTool('list_responses', 'List all saved JSON responses with timestamps and metadata.', {
             type: 'object',
             properties: {
@@ -244,10 +266,9 @@ class JsonViewerServer extends McpServerBase {
                 .sort().reverse().slice(0, limit);
             const responses = [];
             for (const file of files) {
-                try {
-                    responses.push(JSON.parse(fs.readFileSync(path.join(RESPONSES_DIR, file), 'utf-8')));
-                }
-                catch { /* skip corrupted */ }
+                const entry = safeReadJson(path.join(RESPONSES_DIR, file));
+                if (entry)
+                    responses.push(entry);
             }
             return this.success({ total: responses.length, responses });
         }
@@ -262,7 +283,9 @@ class JsonViewerServer extends McpServerBase {
             const metaPath = path.join(RESPONSES_DIR, `${id}.meta.json`);
             if (!fs.existsSync(metaPath))
                 throw new Error(`Response not found: ${id}`);
-            const meta = JSON.parse(fs.readFileSync(metaPath, 'utf-8'));
+            const meta = safeReadJson(metaPath);
+            if (!meta)
+                throw new Error(`Could not read metadata for: ${id}`);
             if (!fs.existsSync(meta.htmlPath))
                 throw new Error(`HTML viewer not found for: ${id}`);
             const cmd = process.platform === 'darwin' ? 'open' : process.platform === 'win32' ? 'start' : 'xdg-open';

package/tools/json-viewer/build/index.js.map

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

package/tools/legacy-analyzer/README.md

@@ -0,0 +1,66 @@
+# legacy-analyzer
+
+MCP server with 22 analysis sub-tools that produce a health score (0–100) and prioritized migration hints for any React-based app — CRA, Vite, Next.js (app or pages router), Remix, Gatsby.
+
+## Tools (22)
+
+| Tool | What it does |
+|---|---|
+| `analyze-legacy-app` | Run all 22 tools and produce a unified health report |
+| `detect-project-tech` | Detect React version, language, framework, major deps |
+| `analyze-folder-structure` | Flat vs feature-based, standard folders, nesting depth |
+| `analyze-components` | Count, large (>300L), complex (multiple responsibilities) |
+| `analyze-state-management` | Redux, Context, Zustand, local state patterns |
+| `analyze-api-layer` | HTTP clients, centralized vs scattered, duplicate endpoints |
+| `analyze-routing` | Router library, flat vs nested, lazy loading |
+| `analyze-styling` | CSS/SCSS/Tailwind, inline styles, hardcoded colors |
+| `analyze-assets` | Large images/videos, assets inside src, unused assets |
+| `detect-anti-patterns` | Prop drilling, tight coupling, god components, a11y |
+| `detect-duplication` | Duplicate components (Jaccard similarity), duplicate utils |
+| `analyze-dependencies-usage` | Import anti-patterns, UI package usage |
+| `detect-features` | Identify logical domains via file names + import clustering |
+| `classify-files` | Feature-specific vs shared vs utility vs config |
+| `detect-shared-modules` | Files imported by multiple features |
+| `design-target-structure` | Suggest scalable feature-based folder structure |
+| `map-files-to-target` | Map current files to proposed structure |
+| `detect-boundary-violations` | Cross-feature imports, deep relative imports |
+| `suggest-module-splitting` | Split large/generic files into focused modules |
+| `naming-standardizer` | Suggest consistent file and folder naming |
+| `generate-refactor-plan` | Combine all outputs into a structured refactor plan |
+| `refactor-folder-structure` | Aggregated restructure plan |
+
+## Usage
+
+```sh
+# Full health audit
+echo '{"jsonrpc":"2.0","id":1,"method":"tools/call","params":{"name":"analyze-legacy-app","arguments":{"path":"/path/to/your/app"}}}' \
+  | node build/index.js
+```
+
+## Output
+
+```json
+{
+  "success": true,
+  "summary": { "healthScore": 72, "totalIssues": 18 },
+  "tech": { "framework": "Next.js", "reactVersion": "18", "language": "TypeScript" },
+  "migrationHints": [
+    { "priority": "high", "category": "API Layer", "description": "..." }
+  ]
+}
+```
+
+## Framework support
+
+Automatically detects the correct source directory:
+- `src/` → CRA, Vite
+- `app/` → Next.js App Router
+- `pages/` → Next.js Pages Router
+- root → bare React projects
+
+## Build & test
+
+```sh
+npm run build
+npm test
+```

package/tools/legacy-analyzer/build/index.d.ts

@@ -0,0 +1,3 @@
+#!/usr/bin/env node
+export {};
+//# sourceMappingURL=index.d.ts.map

package/tools/legacy-analyzer/build/index.d.ts.map

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

package/tools/legacy-analyzer/build/index.js

@@ -0,0 +1,209 @@
+#!/usr/bin/env node
+import { McpServerBase } from '@mcp-showcase/shared';
+import { detectProjectTech } from './tools/01-detect-project-tech.js';
+import { analyzeFolderStructure } from './tools/02-analyze-folder-structure.js';
+import { analyzeComponents } from './tools/03-analyze-components.js';
+import { analyzeStateManagement } from './tools/04-analyze-state-management.js';
+import { analyzeApiLayer } from './tools/05-analyze-api-layer.js';
+import { analyzeRouting } from './tools/06-analyze-routing.js';
+import { analyzeStyling } from './tools/07-analyze-styling.js';
+import { analyzeAssets } from './tools/08-analyze-assets.js';
+import { detectAntiPatterns } from './tools/09-detect-anti-patterns.js';
+import { detectDuplication } from './tools/10-detect-duplication.js';
+import { analyzeDependenciesUsage } from './tools/11-analyze-dependencies-usage.js';
+import { analyzeLegacyApp } from './tools/12-analyze-legacy-app.js';
+import { detectFeatures } from './tools/13-detect-features.js';
+import { classifyFiles } from './tools/14-classify-files.js';
+import { detectSharedModules } from './tools/15-detect-shared-modules.js';
+import { designTargetStructure } from './tools/16-design-target-structure.js';
+import { mapFilesToTarget } from './tools/17-map-files-to-target.js';
+import { detectBoundaryViolations } from './tools/18-detect-boundary-violations.js';
+import { suggestModuleSplitting } from './tools/19-suggest-module-splitting.js';
+import { namingStandardizer } from './tools/20-naming-standardizer.js';
+import { generateRefactorPlan } from './tools/21-generate-refactor-plan.js';
+import { refactorFolderStructure } from './tools/22-refactor-folder-structure.js';
+// ============================================================================
+// TOOL DEFINITIONS
+// ============================================================================
+const CONFIG_SCHEMA = {
+    type: 'object',
+    description: 'Optional configuration overrides',
+    properties: {
+        largeComponentLines: { type: 'number', description: 'Line count threshold for large components (default: 300)' },
+        largeUtilLines: { type: 'number', description: 'Line count threshold for large utility files (default: 200)' },
+        largeAssetImageKB: { type: 'number', description: 'Size threshold in KB for large images (default: 100)' },
+        largeAssetVideoMB: { type: 'number', description: 'Size threshold in MB for large videos (default: 1)' },
+        propDrillingDepth: { type: 'number', description: 'Depth threshold for prop drilling detection (default: 3)' },
+        duplicationThreshold: { type: 'number', description: 'Similarity threshold 0-1 for duplication detection (default: 0.8)' },
+    },
+};
+const TOOLS = [
+    {
+        name: 'detect-project-tech',
+        description: 'Detect React version, language (JS/TS), framework (CRA/Vite/Next.js/Remix/Gatsby/React Native), and major dependencies',
+        inputSchema: { type: 'object', properties: { path: { type: 'string', description: 'Path to app root directory (CRA, Vite, Next.js, Remix, Gatsby, plain React)' }, config: CONFIG_SCHEMA }, required: ['path'] },
+    },
+    {
+        name: 'analyze-folder-structure',
+        description: 'Analyze folder structure: flat vs feature-based, presence of standard folders, nesting depth',
+        inputSchema: { type: 'object', properties: { path: { type: 'string', description: 'Path to app root directory (CRA, Vite, Next.js, Remix, Gatsby, plain React)' }, config: CONFIG_SCHEMA }, required: ['path'] },
+    },
+    {
+        name: 'analyze-components',
+        description: 'Scan all components: count, large components (>300 lines), complex components with multiple responsibilities',
+        inputSchema: { type: 'object', properties: { path: { type: 'string', description: 'Path to app root directory (CRA, Vite, Next.js, Remix, Gatsby, plain React)' }, config: CONFIG_SCHEMA }, required: ['path'] },
+    },
+    {
+        name: 'analyze-state-management',
+        description: 'Detect Redux, Context API, local state patterns, normalized state, derived state, Reselect usage',
+        inputSchema: { type: 'object', properties: { path: { type: 'string', description: 'Path to app root directory (CRA, Vite, Next.js, Remix, Gatsby, plain React)' }, config: CONFIG_SCHEMA }, required: ['path'] },
+    },
+    {
+        name: 'analyze-api-layer',
+        description: 'Detect HTTP client usage (axios/fetch/superagent/ky), Next.js API routes, centralized vs scattered pattern, endpoint duplication',
+        inputSchema: { type: 'object', properties: { path: { type: 'string', description: 'Path to app root directory (CRA, Vite, Next.js, Remix, Gatsby, plain React)' }, config: CONFIG_SCHEMA }, required: ['path'] },
+    },
+    {
+        name: 'analyze-routing',
+        description: 'Detect react-router usage, route structure (flat vs nested), lazy loading usage',
+        inputSchema: { type: 'object', properties: { path: { type: 'string', description: 'Path to app root directory (CRA, Vite, Next.js, Remix, Gatsby, plain React)' }, config: CONFIG_SCHEMA }, required: ['path'] },
+    },
+    {
+        name: 'analyze-styling',
+        description: 'Detect CSS/SCSS/Tailwind/styled-components, inline styles, hardcoded colors, duplicate classes',
+        inputSchema: { type: 'object', properties: { path: { type: 'string', description: 'Path to app root directory (CRA, Vite, Next.js, Remix, Gatsby, plain React)' }, config: CONFIG_SCHEMA }, required: ['path'] },
+    },
+    {
+        name: 'analyze-assets',
+        description: 'Detect large images/videos, assets inside src, unused assets',
+        inputSchema: { type: 'object', properties: { path: { type: 'string', description: 'Path to app root directory (CRA, Vite, Next.js, Remix, Gatsby, plain React)' }, config: CONFIG_SCHEMA }, required: ['path'] },
+    },
+    {
+        name: 'detect-anti-patterns',
+        description: 'Detect prop drilling, tight coupling, duplicated logic, large utility files, god components',
+        inputSchema: { type: 'object', properties: { path: { type: 'string', description: 'Path to app root directory (CRA, Vite, Next.js, Remix, Gatsby, plain React)' }, config: CONFIG_SCHEMA }, required: ['path'] },
+    },
+    {
+        name: 'detect-duplication',
+        description: 'Detect duplicate components, duplicate utility functions, similar file structures',
+        inputSchema: { type: 'object', properties: { path: { type: 'string', description: 'Path to app root directory (CRA, Vite, Next.js, Remix, Gatsby, plain React)' }, config: CONFIG_SCHEMA }, required: ['path'] },
+    },
+    {
+        name: 'analyze-dependencies-usage',
+        description: 'Deep analysis of external libraries, internal imports, UI package usage, import anti-patterns',
+        inputSchema: { type: 'object', properties: { path: { type: 'string', description: 'Path to app root directory (CRA, Vite, Next.js, Remix, Gatsby, plain React)' }, config: CONFIG_SCHEMA }, required: ['path'] },
+    },
+    {
+        name: 'analyze-legacy-app',
+        description: 'Complete analysis for any React-based app (CRA, Vite, Next.js, Remix, Gatsby). Runs all 22 sub-tools and produces a unified health score (0-100) with prioritized migration hints.',
+        inputSchema: { type: 'object', properties: { path: { type: 'string', description: 'Path to app root directory (CRA, Vite, Next.js, Remix, Gatsby, plain React)' }, config: CONFIG_SCHEMA }, required: ['path'] },
+    },
+    {
+        name: 'detect-features',
+        description: 'Identify logical features/domains in the app using file names, routing, folder grouping, and import clustering',
+        inputSchema: { type: 'object', properties: { path: { type: 'string', description: 'Path to app root directory (CRA, Vite, Next.js, Remix, Gatsby, plain React)' }, config: CONFIG_SCHEMA }, required: ['path'] },
+    },
+    {
+        name: 'classify-files',
+        description: 'Classify each file into feature-specific, shared, utility, or config type',
+        inputSchema: { type: 'object', properties: { path: { type: 'string', description: 'Path to app root directory (CRA, Vite, Next.js, Remix, Gatsby, plain React)' }, config: CONFIG_SCHEMA }, required: ['path'] },
+    },
+    {
+        name: 'detect-shared-modules',
+        description: 'Identify files used across multiple features (shared modules)',
+        inputSchema: { type: 'object', properties: { path: { type: 'string', description: 'Path to app root directory (CRA, Vite, Next.js, Remix, Gatsby, plain React)' }, config: CONFIG_SCHEMA }, required: ['path'] },
+    },
+    {
+        name: 'design-target-structure',
+        description: 'Generate scalable folder structure suggestion based on feature-based architecture',
+        inputSchema: { type: 'object', properties: { path: { type: 'string', description: 'Path to app root directory (CRA, Vite, Next.js, Remix, Gatsby, plain React)' }, config: CONFIG_SCHEMA }, required: ['path'] },
+    },
+    {
+        name: 'map-files-to-target',
+        description: 'Map existing files to new target structure',
+        inputSchema: { type: 'object', properties: { path: { type: 'string', description: 'Path to app root directory (CRA, Vite, Next.js, Remix, Gatsby, plain React)' }, config: CONFIG_SCHEMA }, required: ['path'] },
+    },
+    {
+        name: 'detect-boundary-violations',
+        description: 'Detect cross-feature imports, deep relative imports, and tight coupling issues',
+        inputSchema: { type: 'object', properties: { path: { type: 'string', description: 'Path to app root directory (CRA, Vite, Next.js, Remix, Gatsby, plain React)' }, config: CONFIG_SCHEMA }, required: ['path'] },
+    },
+    {
+        name: 'suggest-module-splitting',
+        description: 'Suggest splitting large or generic files into smaller modules',
+        inputSchema: { type: 'object', properties: { path: { type: 'string', description: 'Path to app root directory (CRA, Vite, Next.js, Remix, Gatsby, plain React)' }, config: CONFIG_SCHEMA }, required: ['path'] },
+    },
+    {
+        name: 'naming-standardizer',
+        description: 'Suggest better file and folder naming conventions',
+        inputSchema: { type: 'object', properties: { path: { type: 'string', description: 'Path to app root directory (CRA, Vite, Next.js, Remix, Gatsby, plain React)' }, config: CONFIG_SCHEMA }, required: ['path'] },
+    },
+    {
+        name: 'generate-refactor-plan',
+        description: 'Combine all analysis outputs into a single structured refactor plan',
+        inputSchema: { type: 'object', properties: { path: { type: 'string', description: 'Path to app root directory (CRA, Vite, Next.js, Remix, Gatsby, plain React)' }, config: CONFIG_SCHEMA }, required: ['path'] },
+    },
+    {
+        name: 'refactor-folder-structure',
+        description: 'Aggregator: calls all refactoring suggestion tools and produces final structured plan',
+        inputSchema: { type: 'object', properties: { path: { type: 'string', description: 'Path to app root directory (CRA, Vite, Next.js, Remix, Gatsby, plain React)' }, config: CONFIG_SCHEMA }, required: ['path'] },
+    },
+];
+const HANDLERS = {
+    'detect-project-tech': detectProjectTech,
+    'analyze-folder-structure': analyzeFolderStructure,
+    'analyze-components': analyzeComponents,
+    'analyze-state-management': analyzeStateManagement,
+    'analyze-api-layer': analyzeApiLayer,
+    'analyze-routing': analyzeRouting,
+    'analyze-styling': analyzeStyling,
+    'analyze-assets': analyzeAssets,
+    'detect-anti-patterns': detectAntiPatterns,
+    'detect-duplication': detectDuplication,
+    'analyze-dependencies-usage': analyzeDependenciesUsage,
+    'analyze-legacy-app': analyzeLegacyApp,
+    'detect-features': detectFeatures,
+    'classify-files': classifyFiles,
+    'detect-shared-modules': detectSharedModules,
+    'design-target-structure': designTargetStructure,
+    'map-files-to-target': mapFilesToTarget,
+    'detect-boundary-violations': detectBoundaryViolations,
+    'suggest-module-splitting': suggestModuleSplitting,
+    'naming-standardizer': namingStandardizer,
+    'generate-refactor-plan': generateRefactorPlan,
+    'refactor-folder-structure': refactorFolderStructure,
+};
+// ============================================================================
+// SERVER
+// ============================================================================
+class LegacyAnalyzerServer extends McpServerBase {
+    constructor() {
+        super({ name: 'legacy-analyzer', version: '1.0.0' });
+    }
+    registerTools() {
+        for (const tool of TOOLS) {
+            const toolName = tool.name;
+            // eslint-disable-next-line @typescript-eslint/no-explicit-any
+            this.addTool(toolName, tool.description, tool.inputSchema, (args) => this.dispatchTool(toolName, args));
+        }
+    }
+    async dispatchTool(name, args) {
+        const { path: appPath, config } = args;
+        const handler = HANDLERS[name];
+        if (!handler) {
+            return this.error(new Error(`Unknown tool: ${name}`));
+        }
+        try {
+            const result = await handler(appPath, config);
+            return this.success(result);
+        }
+        catch (error) {
+            return this.error(error);
+        }
+    }
+}
+// ============================================================================
+// ENTRY POINT
+// ============================================================================
+new LegacyAnalyzerServer().run().catch(console.error);
+//# sourceMappingURL=index.js.map

package/tools/legacy-analyzer/build/index.js.map

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

package/tools/legacy-analyzer/build/tools/01-detect-project-tech.d.ts

@@ -0,0 +1,3 @@
+import type { ProjectTechOutput, AnalyzerConfig } from '../types.js';
+export declare function detectProjectTech(appPath: string, config?: Partial<AnalyzerConfig>): Promise<ProjectTechOutput>;
+//# sourceMappingURL=01-detect-project-tech.d.ts.map

package/tools/legacy-analyzer/build/tools/01-detect-project-tech.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"01-detect-project-tech.d.ts","sourceRoot":"","sources":["../../src/tools/01-detect-project-tech.ts"],"names":[],"mappings":"AAQA,OAAO,KAAK,EAAE,iBAAiB,EAAE,cAAc,EAAkB,MAAM,aAAa,CAAC;AAiCrF,wBAAsB,iBAAiB,CAAC,OAAO,EAAE,MAAM,EAAE,MAAM,CAAC,EAAE,OAAO,CAAC,cAAc,CAAC,GAAG,OAAO,CAAC,iBAAiB,CAAC,CA6ErH"}

package/tools/legacy-analyzer/build/tools/01-detect-project-tech.js

@@ -0,0 +1,115 @@
+// ============================================================================
+// TOOL #1: detect-project-tech
+// Detects React version, language, framework (CRA/Next/Vite/Remix/Gatsby/Expo),
+// and major dependencies — works for any React-based app
+// ============================================================================
+import { readPackageJson, hasConfigFile } from '../utils/file-scanner.js';
+const MAJOR_DEPS = [
+    // Core
+    'react', 'react-dom', 'react-scripts',
+    // State management
+    'redux', '@reduxjs/toolkit', 'react-redux', 'zustand', 'jotai', 'recoil', 'mobx',
+    // Routing
+    'react-router-dom', 'react-router',
+    // Data fetching
+    'axios', 'swr', 'react-query', '@tanstack/react-query',
+    // Styling
+    'styled-components', '@emotion/react', '@emotion/styled', 'tailwindcss',
+    // Forms
+    'formik', 'react-hook-form',
+    // Validation
+    'zod', 'yup',
+    // Utilities
+    'lodash', 'ramda',
+    // Date
+    'moment', 'dayjs', 'date-fns',
+    // Async/reactive
+    'rxjs',
+    // GraphQL
+    'graphql', '@apollo/client', 'urql',
+    // Real-time
+    'socket.io-client',
+    // i18n
+    'react-intl', 'react-i18next',
+    // Meta-frameworks
+    'next', 'gatsby',
+];
+export async function detectProjectTech(appPath, config) {
+    const pkg = readPackageJson(appPath);
+    if (!pkg) {
+        return {
+            framework: 'unknown',
+            reactVersion: 'unknown',
+            language: 'JavaScript',
+            hasCRAConfig: false,
+            majorDependencies: [],
+        };
+    }
+    const allDeps = {
+        ...pkg.dependencies,
+        ...pkg.devDependencies,
+    };
+    // Detect React version
+    let reactVersion = 'unknown';
+    const reactDep = allDeps['react'] || '';
+    const versionMatch = reactDep.match(/(\d+)\./);
+    if (versionMatch) {
+        reactVersion = versionMatch[1];
+    }
+    // Detect language
+    const hasTypeScript = !!(allDeps['typescript'] || allDeps['@types/react']);
+    const hasTSConfig = hasConfigFile(appPath, ['tsconfig.json']);
+    const language = (hasTypeScript || hasTSConfig) ? 'TypeScript' : 'JavaScript';
+    // Detect CRA
+    const hasReactScripts = !!allDeps['react-scripts'];
+    const hasCRAConfig = hasConfigFile(appPath, [
+        'config-overrides',
+        '.env',
+        '.env.local',
+        '.env.development',
+        '.env.production',
+    ]);
+    const isCRA = hasReactScripts || hasCRAConfig;
+    // Detect framework (order matters — check specific before generic)
+    let framework = 'unknown';
+    if (allDeps['next'])
+        framework = 'Next.js';
+    else if (allDeps['@remix-run/react'] || allDeps['@remix-run/node'])
+        framework = 'Remix';
+    else if (allDeps['gatsby'])
+        framework = 'Gatsby';
+    else if (allDeps['expo'] || allDeps['react-native'])
+        framework = 'React Native / Expo';
+    else if (isCRA)
+        framework = 'CRA';
+    else if (allDeps['vite'] || allDeps['@vitejs/plugin-react'] || hasConfigFile(appPath, ['vite.config.ts', 'vite.config.js']))
+        framework = 'Vite';
+    else if (allDeps['react'])
+        framework = 'React';
+    // Next.js app router vs pages router
+    let routerType;
+    if (framework === 'Next.js') {
+        const hasAppDir = hasConfigFile(appPath, ['app', 'src/app']);
+        const hasPagesDir = hasConfigFile(appPath, ['pages', 'src/pages']);
+        if (hasAppDir)
+            routerType = 'app-router';
+        else if (hasPagesDir)
+            routerType = 'pages-router';
+    }
+    void routerType; // used by analyze-routing
+    // Detect major dependencies
+    const majorDependencies = [];
+    for (const dep of MAJOR_DEPS) {
+        if (allDeps[dep]) {
+            majorDependencies.push(dep);
+        }
+    }
+    return {
+        framework,
+        reactVersion,
+        language,
+        hasCRAConfig: isCRA,
+        majorDependencies,
+    };
+}
+//# sourceMappingURL=01-detect-project-tech.js.map

package/tools/legacy-analyzer/build/tools/01-detect-project-tech.js.map

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

package/tools/legacy-analyzer/build/tools/02-analyze-folder-structure.d.ts

@@ -0,0 +1,3 @@
+import type { FolderStructureOutput, AnalyzerConfig } from '../types.js';
+export declare function analyzeFolderStructure(appPath: string, config?: Partial<AnalyzerConfig>): Promise<FolderStructureOutput>;
+//# sourceMappingURL=02-analyze-folder-structure.d.ts.map

package/tools/legacy-analyzer/build/tools/02-analyze-folder-structure.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"02-analyze-folder-structure.d.ts","sourceRoot":"","sources":["../../src/tools/02-analyze-folder-structure.ts"],"names":[],"mappings":"AAOA,OAAO,KAAK,EAAE,qBAAqB,EAAE,cAAc,EAAE,MAAM,aAAa,CAAC;AAiBzE,wBAAsB,sBAAsB,CAAC,OAAO,EAAE,MAAM,EAAE,MAAM,CAAC,EAAE,OAAO,CAAC,cAAc,CAAC,GAAG,OAAO,CAAC,qBAAqB,CAAC,CAiF9H"}

package/tools/legacy-analyzer/build/tools/02-analyze-folder-structure.js

@@ -0,0 +1,85 @@
+// ============================================================================
+// TOOL #2: analyze-folder-structure
+// Analyzes directory structure: flat vs feature-based, folder presence, depth
+// ============================================================================
+import * as path from 'path';
+import { getDirectoriesAtDepth, calculateMaxDepth, findSourceFiles, resolveSourceDir } from '../utils/file-scanner.js';
+const COMMON_FOLDERS = [
+    'components', 'component', 'ui',
+    'utils', 'util', 'helpers', 'helper',
+    'services', 'service', 'api',
+    'hooks', 'hook', 'custom-hooks',
+    'pages', 'page', 'views', 'screens',
+    'store', 'stores', 'redux', 'state',
+    'assets', 'static', 'public',
+    'styles', 'css', 'scss',
+    'constants', 'config',
+    'types', 'interfaces', 'models',
+    'features', 'modules',
+    'contexts', 'providers',
+];
+export async function analyzeFolderStructure(appPath, config) {
+    const srcPath = resolveSourceDir(appPath);
+    const allDirs = getDirectoriesAtDepth(srcPath, 5);
+    // Get top-level directories in src/
+    const topLevelDirs = allDirs.filter((d) => !d.includes(path.sep));
+    const secondLevelDirs = allDirs.filter((d) => d.split(path.sep).length === 2);
+    // Detect which common folders exist
+    const folders = [];
+    const foundFolders = new Set();
+    for (const dir of allDirs) {
+        const parts = dir.split(path.sep);
+        for (const part of parts) {
+            const lower = part.toLowerCase();
+            if (COMMON_FOLDERS.includes(lower) && !foundFolders.has(lower)) {
+                foundFolders.add(lower);
+                folders.push(dir);
+            }
+        }
+    }
+    // Classify structure type
+    let structureType;
+    const hasFeatures = topLevelDirs.some((d) => ['features', 'modules', 'pages', 'screens', 'views'].includes(d.toLowerCase()));
+    const hasFlatStructure = topLevelDirs.some((d) => ['components', 'utils', 'services', 'hooks'].includes(d.toLowerCase()));
+    if (hasFeatures && hasFlatStructure) {
+        structureType = 'mixed';
+    }
+    else if (hasFeatures) {
+        structureType = 'feature-based';
+    }
+    else {
+        structureType = 'flat';
+    }
+    // Calculate depth
+    const maxDepth = calculateMaxDepth(srcPath);
+    // Detect issues
+    const issues = [];
+    if (maxDepth > 5) {
+        issues.push(`Deep nesting detected (${maxDepth} levels). Consider flattening the structure.`);
+    }
+    if (!foundFolders.has('components') && !foundFolders.has('component')) {
+        issues.push('No dedicated components folder found.');
+    }
+    if (!foundFolders.has('utils') && !foundFolders.has('util') && !foundFolders.has('helpers')) {
+        issues.push('No dedicated utils/helpers folder found. Utility code may be scattered.');
+    }
+    if (structureType === 'mixed') {
+        issues.push('Mixed folder structure detected (both flat and feature-based). Consider standardizing.');
+    }
+    // Check for src at wrong level
+    const sourceFiles = await findSourceFiles(appPath);
+    const filesOutsideSrc = sourceFiles.filter((f) => {
+        const rel = path.relative(appPath, f);
+        return !rel.startsWith('src' + path.sep) && rel !== 'src';
+    });
+    if (filesOutsideSrc.length > 0) {
+        issues.push(`${filesOutsideSrc.length} source files found outside src/ directory.`);
+    }
+    return {
+        structureType,
+        folders: folders.sort(),
+        maxDepth,
+        issues,
+    };
+}
+//# sourceMappingURL=02-analyze-folder-structure.js.map

package/tools/legacy-analyzer/build/tools/02-analyze-folder-structure.js.map

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