@polymorphism-tech/morph-spec 7.9.3 → 8.0.0

package/src/lib/detectors/index.js

@@ -1,217 +1,217 @@
-/**
- * @fileoverview Project Detector
- *
- * Scans a project directory for stack, architecture, UI library, and integrations.
- * Used by mcp-setup, morph-init, and session-start hooks.
- *
- * @module detectors/index
- */
-
-import { existsSync, readFileSync, readdirSync } from 'fs';
-import { join } from 'path';
-
-/**
- * Detect project structure from filesystem evidence.
- *
- * @param {string} targetPath - Root path of the project
- * @param {Object} [opts] - Options
- * @param {boolean} [opts.generateStandards=false] - Whether to generate inferred markdown
- * @returns {{ structure: { stack: string, architecture: string|null, uiLibrary: string|null, integrations: string[], hasVercel: boolean }, inferred: { markdown: string } }}
- */
-export function detectProject(targetPath, opts = {}) {
-  const structure = {
-    stack: 'unknown',
-    architecture: null,
-    uiLibrary: null,
-    integrations: [],
-    hasVercel: false,
-  };
-
-  try {
-    // ── Package.json analysis ──────────────────────────────────────────────
-    // Collect deps from root and common monorepo subfolders
-    const pkgLocations = ['.', 'src/frontend', 'src/web', 'frontend', 'apps/web', 'packages/app'];
-    const allDeps = {};
-    let rootPkg = null;
-    let scripts = [];
-    for (const loc of pkgLocations) {
-      const pkgPath = join(targetPath, loc, 'package.json');
-      if (!existsSync(pkgPath)) continue;
-      try {
-        const pkg = JSON.parse(readFileSync(pkgPath, 'utf8'));
-        if (loc === '.') rootPkg = pkg;
-        Object.assign(allDeps, pkg.dependencies, pkg.devDependencies);
-        scripts.push(...Object.keys(pkg.scripts || {}));
-        // Track frontend path for config
-        if (loc !== '.' && (pkg.dependencies?.next || pkg.dependencies?.react || pkg.dependencies?.vue)) {
-          structure.frontendPath = loc;
-        }
-      } catch { /* invalid JSON */ }
-    }
-    const depNames = Object.keys(allDeps);
-
-    if (depNames.length > 0) {
-
-      // Stack detection from deps
-      if (depNames.includes('next')) {
-        structure.stack = 'nextjs';
-      } else if (depNames.includes('react')) {
-        structure.stack = 'react';
-      } else if (depNames.includes('vue')) {
-        structure.stack = 'vue';
-      } else if (depNames.includes('express') || depNames.includes('fastify') || depNames.includes('hono')) {
-        structure.stack = 'nodejs';
-      } else if (rootPkg?.name) {
-        structure.stack = 'nodejs';
-      }
-
-      // UI library detection
-      if (existsSync(join(targetPath, 'components.json')) || existsSync(join(targetPath, structure.frontendPath || '.', 'components.json')) || depNames.includes('@shadcn/ui')) {
-        structure.uiLibrary = 'shadcn';
-      }
-
-      // Integrations
-      if (depNames.includes('@neondatabase/serverless') || depNames.includes('postgres') || depNames.includes('pg')) {
-        structure.integrations.push('neon');
-      }
-      if (depNames.includes('@neondatabase/auth')) {
-        structure.integrations.push('neon-auth');
-      }
-      if (depNames.includes('stripe')) {
-        structure.integrations.push('stripe');
-      }
-
-      // Vercel detection
-      if (depNames.includes('vercel') || scripts.includes('vercel')) {
-        structure.hasVercel = true;
-      }
-    }
-
-    // ── .csproj detection ──────────────────────────────────────────────────
-    let hasDotnet = false;
-    const csprojLocations = ['.', 'src', 'src/Api', 'src/Web', 'src/backend'];
-
-    function checkCsproj(filePath) {
-      hasDotnet = true;
-      try {
-        const content = readFileSync(filePath, 'utf8');
-        if (content.includes('Hangfire')) {
-          if (!structure.integrations.includes('hangfire')) structure.integrations.push('hangfire');
-        }
-      } catch { /* ignore */ }
-    }
-
-    for (const loc of csprojLocations) {
-      try {
-        const dir = join(targetPath, loc);
-        if (!existsSync(dir)) continue;
-        const entries = readdirSyncSafe(dir);
-        // Direct .csproj files
-        for (const e of entries.filter(f => f.endsWith('.csproj'))) {
-          checkCsproj(join(dir, e));
-        }
-        // One level deeper (e.g., src/backend/MyProject/*.csproj)
-        for (const sub of entries) {
-          const subDir = join(dir, sub);
-          for (const e of readdirSyncSafe(subDir).filter(f => f.endsWith('.csproj'))) {
-            checkCsproj(join(subDir, e));
-          }
-        }
-      } catch { /* ignore */ }
-    }
-
-    // Determine stack: monorepo (nextjs+dotnet), dotnet, or keep frontend stack
-    if (hasDotnet) {
-      if (structure.stack === 'nextjs' || structure.stack === 'react' || structure.stack === 'vue') {
-        // Monorepo: frontend + .NET backend
-        structure.stack = `${structure.stack}+dotnet`;
-      } else if (structure.stack === 'unknown') {
-        structure.stack = 'dotnet';
-      }
-    }
-
-    // ── vercel.json detection ──────────────────────────────────────────────
-    if (existsSync(join(targetPath, 'vercel.json'))) {
-      structure.hasVercel = true;
-    }
-
-    // ── tsconfig.json detection (fallback for stack) ────────────────────────
-    if (structure.stack === 'unknown' && existsSync(join(targetPath, 'tsconfig.json'))) {
-      structure.stack = 'nodejs';
-    }
-
-    // ── Architecture detection ─────────────────────────────────────────────
-    try {
-      const configPath = join(targetPath, '.morph/config/config.json');
-      if (existsSync(configPath)) {
-        const config = JSON.parse(readFileSync(configPath, 'utf8'));
-        if (config.architecture?.style) {
-          structure.architecture = config.architecture.style;
-        }
-      }
-    } catch { /* ignore */ }
-
-    // ── Docker detection ───────────────────────────────────────────────────
-    if (existsSync(join(targetPath, 'docker-compose.yml')) ||
-        existsSync(join(targetPath, 'docker-compose.yaml')) ||
-        existsSync(join(targetPath, 'Dockerfile'))) {
-      if (!structure.integrations.includes('docker')) structure.integrations.push('docker');
-    }
-
-    // ── Azure detection ────────────────────────────────────────────────────
-    const azureSignals = [
-      '.azure',
-      'azure-pipelines.yml',
-      'infra/main.bicep',
-      'infra',
-    ];
-    const hasAzure = azureSignals.some(signal => {
-      const p = join(targetPath, signal);
-      if (!existsSync(p)) return false;
-      if (signal === 'infra') {
-        // Check for .bicep files inside infra/
-        return readdirSyncSafe(p).some(f => f.endsWith('.bicep'));
-      }
-      return true;
-    });
-    if (hasAzure && !structure.integrations.includes('azure')) {
-      structure.integrations.push('azure');
-    }
-  } catch {
-    // Fail-safe — return defaults
-  }
-
-  return {
-    structure,
-    inferred: {
-      markdown: opts.generateStandards ? generateInferredMarkdown(structure) : '',
-    },
-  };
-}
-
-/**
- * Safe readdir that returns [] on error.
- * @param {string} dir
- * @returns {string[]}
- */
-function readdirSyncSafe(dir) {
-  try {
-    return readdirSync(dir);
-  } catch {
-    return [];
-  }
-}
-
-/**
- * Generate a markdown summary from detected structure.
- * @param {Object} structure
- * @returns {string}
- */
-function generateInferredMarkdown(structure) {
-  const lines = [`## Detected Stack: ${structure.stack}`];
-  if (structure.architecture) lines.push(`Architecture: ${structure.architecture}`);
-  if (structure.uiLibrary) lines.push(`UI Library: ${structure.uiLibrary}`);
-  if (structure.integrations.length > 0) lines.push(`Integrations: ${structure.integrations.join(', ')}`);
-  if (structure.hasVercel) lines.push(`Vercel: detected`);
-  return lines.join('\n');
-}
+/**
+ * @fileoverview Project Detector
+ *
+ * Scans a project directory for stack, architecture, UI library, and integrations.
+ * Used by mcp-setup, morph-init, and session-start hooks.
+ *
+ * @module detectors/index
+ */
+
+import { existsSync, readFileSync, readdirSync } from 'fs';
+import { join } from 'path';
+
+/**
+ * Detect project structure from filesystem evidence.
+ *
+ * @param {string} targetPath - Root path of the project
+ * @param {Object} [opts] - Options
+ * @param {boolean} [opts.generateStandards=false] - Whether to generate inferred markdown
+ * @returns {{ structure: { stack: string, architecture: string|null, uiLibrary: string|null, integrations: string[], hasVercel: boolean }, inferred: { markdown: string } }}
+ */
+export function detectProject(targetPath, opts = {}) {
+  const structure = {
+    stack: 'unknown',
+    architecture: null,
+    uiLibrary: null,
+    integrations: [],
+    hasVercel: false,
+  };
+
+  try {
+    // ── Package.json analysis ──────────────────────────────────────────────
+    // Collect deps from root and common monorepo subfolders
+    const pkgLocations = ['.', 'src/frontend', 'src/web', 'frontend', 'apps/web', 'packages/app'];
+    const allDeps = {};
+    let rootPkg = null;
+    let scripts = [];
+    for (const loc of pkgLocations) {
+      const pkgPath = join(targetPath, loc, 'package.json');
+      if (!existsSync(pkgPath)) continue;
+      try {
+        const pkg = JSON.parse(readFileSync(pkgPath, 'utf8'));
+        if (loc === '.') rootPkg = pkg;
+        Object.assign(allDeps, pkg.dependencies, pkg.devDependencies);
+        scripts.push(...Object.keys(pkg.scripts || {}));
+        // Track frontend path for config
+        if (loc !== '.' && (pkg.dependencies?.next || pkg.dependencies?.react || pkg.dependencies?.vue)) {
+          structure.frontendPath = loc;
+        }
+      } catch { /* invalid JSON */ }
+    }
+    const depNames = Object.keys(allDeps);
+
+    if (depNames.length > 0) {
+
+      // Stack detection from deps
+      if (depNames.includes('next')) {
+        structure.stack = 'nextjs';
+      } else if (depNames.includes('react')) {
+        structure.stack = 'react';
+      } else if (depNames.includes('vue')) {
+        structure.stack = 'vue';
+      } else if (depNames.includes('express') || depNames.includes('fastify') || depNames.includes('hono')) {
+        structure.stack = 'nodejs';
+      } else if (rootPkg?.name) {
+        structure.stack = 'nodejs';
+      }
+
+      // UI library detection
+      if (existsSync(join(targetPath, 'components.json')) || existsSync(join(targetPath, structure.frontendPath || '.', 'components.json')) || depNames.includes('@shadcn/ui')) {
+        structure.uiLibrary = 'shadcn';
+      }
+
+      // Integrations
+      if (depNames.includes('@neondatabase/serverless') || depNames.includes('postgres') || depNames.includes('pg')) {
+        structure.integrations.push('neon');
+      }
+      if (depNames.includes('@neondatabase/auth')) {
+        structure.integrations.push('neon-auth');
+      }
+      if (depNames.includes('stripe')) {
+        structure.integrations.push('stripe');
+      }
+
+      // Vercel detection
+      if (depNames.includes('vercel') || scripts.includes('vercel')) {
+        structure.hasVercel = true;
+      }
+    }
+
+    // ── .csproj detection ──────────────────────────────────────────────────
+    let hasDotnet = false;
+    const csprojLocations = ['.', 'src', 'src/Api', 'src/Web', 'src/backend'];
+
+    function checkCsproj(filePath) {
+      hasDotnet = true;
+      try {
+        const content = readFileSync(filePath, 'utf8');
+        if (content.includes('Hangfire')) {
+          if (!structure.integrations.includes('hangfire')) structure.integrations.push('hangfire');
+        }
+      } catch { /* ignore */ }
+    }
+
+    for (const loc of csprojLocations) {
+      try {
+        const dir = join(targetPath, loc);
+        if (!existsSync(dir)) continue;
+        const entries = readdirSyncSafe(dir);
+        // Direct .csproj files
+        for (const e of entries.filter(f => f.endsWith('.csproj'))) {
+          checkCsproj(join(dir, e));
+        }
+        // One level deeper (e.g., src/backend/MyProject/*.csproj)
+        for (const sub of entries) {
+          const subDir = join(dir, sub);
+          for (const e of readdirSyncSafe(subDir).filter(f => f.endsWith('.csproj'))) {
+            checkCsproj(join(subDir, e));
+          }
+        }
+      } catch { /* ignore */ }
+    }
+
+    // Determine stack: monorepo (nextjs+dotnet), dotnet, or keep frontend stack
+    if (hasDotnet) {
+      if (structure.stack === 'nextjs' || structure.stack === 'react' || structure.stack === 'vue') {
+        // Monorepo: frontend + .NET backend
+        structure.stack = `${structure.stack}+dotnet`;
+      } else if (structure.stack === 'unknown') {
+        structure.stack = 'dotnet';
+      }
+    }
+
+    // ── vercel.json detection ──────────────────────────────────────────────
+    if (existsSync(join(targetPath, 'vercel.json'))) {
+      structure.hasVercel = true;
+    }
+
+    // ── tsconfig.json detection (fallback for stack) ────────────────────────
+    if (structure.stack === 'unknown' && existsSync(join(targetPath, 'tsconfig.json'))) {
+      structure.stack = 'nodejs';
+    }
+
+    // ── Architecture detection ─────────────────────────────────────────────
+    try {
+      const configPath = join(targetPath, '.morph/config/config.json');
+      if (existsSync(configPath)) {
+        const config = JSON.parse(readFileSync(configPath, 'utf8'));
+        if (config.architecture?.style) {
+          structure.architecture = config.architecture.style;
+        }
+      }
+    } catch { /* ignore */ }
+
+    // ── Docker detection ───────────────────────────────────────────────────
+    if (existsSync(join(targetPath, 'docker-compose.yml')) ||
+        existsSync(join(targetPath, 'docker-compose.yaml')) ||
+        existsSync(join(targetPath, 'Dockerfile'))) {
+      if (!structure.integrations.includes('docker')) structure.integrations.push('docker');
+    }
+
+    // ── Azure detection ────────────────────────────────────────────────────
+    const azureSignals = [
+      '.azure',
+      'azure-pipelines.yml',
+      'infra/main.bicep',
+      'infra',
+    ];
+    const hasAzure = azureSignals.some(signal => {
+      const p = join(targetPath, signal);
+      if (!existsSync(p)) return false;
+      if (signal === 'infra') {
+        // Check for .bicep files inside infra/
+        return readdirSyncSafe(p).some(f => f.endsWith('.bicep'));
+      }
+      return true;
+    });
+    if (hasAzure && !structure.integrations.includes('azure')) {
+      structure.integrations.push('azure');
+    }
+  } catch {
+    // Fail-safe — return defaults
+  }
+
+  return {
+    structure,
+    inferred: {
+      markdown: opts.generateStandards ? generateInferredMarkdown(structure) : '',
+    },
+  };
+}
+
+/**
+ * Safe readdir that returns [] on error.
+ * @param {string} dir
+ * @returns {string[]}
+ */
+function readdirSyncSafe(dir) {
+  try {
+    return readdirSync(dir);
+  } catch {
+    return [];
+  }
+}
+
+/**
+ * Generate a markdown summary from detected structure.
+ * @param {Object} structure
+ * @returns {string}
+ */
+function generateInferredMarkdown(structure) {
+  const lines = [`## Detected Stack: ${structure.stack}`];
+  if (structure.architecture) lines.push(`Architecture: ${structure.architecture}`);
+  if (structure.uiLibrary) lines.push(`UI Library: ${structure.uiLibrary}`);
+  if (structure.integrations.length > 0) lines.push(`Integrations: ${structure.integrations.join(', ')}`);
+  if (structure.hasVercel) lines.push(`Vercel: detected`);
+  return lines.join('\n');
+}