@mrpatronz/nexusflow 0.2.12 → 0.2.17

package/src/analyzers/detect-existing.ts

@@ -1,74 +1,74 @@
-/**
- * @module analyzers/detect-existing
- * Detects existing AI assistant configuration files in a repository.
- * These are merged into the generated workspace context to preserve
- * repo-specific instructions.
- */
-
-import * as fs from 'node:fs/promises';
-import * as path from 'node:path';
-
-import type { ExistingAIConfig } from '../types.js';
-
-/** Maximum chars to include as a content preview. */
-const PREVIEW_LENGTH = 500;
-
-/** Known AI config file locations. */
-const AI_CONFIG_FILES = [
-  { assistant: 'claude' as const, relativePath: 'CLAUDE.md' },
-  { assistant: 'claude' as const, relativePath: 'CLAUDE.local.md' },
-  { assistant: 'agents' as const, relativePath: 'AGENTS.md' },
-  { assistant: 'copilot' as const, relativePath: '.github/copilot-instructions.md' },
-  { assistant: 'cursor' as const, relativePath: '.cursorrules' },
-];
-
-/**
- * Scans a repository for existing AI assistant configuration files.
- *
- * @param repoPath - Absolute path to the repository root.
- * @returns Array of detected {@link ExistingAIConfig} objects.
- */
-export async function detectExistingAIConfigs(
-  repoPath: string,
-): Promise<ExistingAIConfig[]> {
-  const results: ExistingAIConfig[] = [];
-
-  for (const config of AI_CONFIG_FILES) {
-    const filePath = path.join(repoPath, config.relativePath);
-
-    try {
-      const content = await fs.readFile(filePath, 'utf-8');
-      results.push({
-        assistant: config.assistant,
-        relativePath: config.relativePath,
-        contentPreview: content.slice(0, PREVIEW_LENGTH),
-      });
-    } catch {
-      // File doesn't exist — skip
-    }
-  }
-
-  // Also check for Cursor rules directory
-  const cursorRulesDir = path.join(repoPath, '.cursor', 'rules');
-  try {
-    const entries = await fs.readdir(cursorRulesDir);
-    const mdcFiles = entries.filter((e) => e.endsWith('.mdc'));
-
-    for (const mdc of mdcFiles) {
-      try {
-        const content = await fs.readFile(path.join(cursorRulesDir, mdc), 'utf-8');
-        results.push({
-          assistant: 'cursor',
-          relativePath: `.cursor/rules/${mdc}`,
-          contentPreview: content.slice(0, PREVIEW_LENGTH),
-        });
-      } catch {
-        // Skip unreadable files
-      }
-    }
-  } catch {
-    // No .cursor/rules directory
-  }
-
-  return results;
-}
+/**
+ * @module analyzers/detect-existing
+ * Detects existing AI assistant configuration files in a repository.
+ * These are merged into the generated workspace context to preserve
+ * repo-specific instructions.
+ */
+
+import * as fs from 'node:fs/promises';
+import * as path from 'node:path';
+
+import type { ExistingAIConfig } from '../types.js';
+
+/** Maximum chars to include as a content preview. */
+const PREVIEW_LENGTH = 500;
+
+/** Known AI config file locations. */
+const AI_CONFIG_FILES = [
+  { assistant: 'claude' as const, relativePath: 'CLAUDE.md' },
+  { assistant: 'claude' as const, relativePath: 'CLAUDE.local.md' },
+  { assistant: 'agents' as const, relativePath: 'AGENTS.md' },
+  { assistant: 'copilot' as const, relativePath: '.github/copilot-instructions.md' },
+  { assistant: 'cursor' as const, relativePath: '.cursorrules' },
+];
+
+/**
+ * Scans a repository for existing AI assistant configuration files.
+ *
+ * @param repoPath - Absolute path to the repository root.
+ * @returns Array of detected {@link ExistingAIConfig} objects.
+ */
+export async function detectExistingAIConfigs(
+  repoPath: string,
+): Promise<ExistingAIConfig[]> {
+  const results: ExistingAIConfig[] = [];
+
+  for (const config of AI_CONFIG_FILES) {
+    const filePath = path.join(repoPath, config.relativePath);
+
+    try {
+      const content = await fs.readFile(filePath, 'utf-8');
+      results.push({
+        assistant: config.assistant,
+        relativePath: config.relativePath,
+        contentPreview: content.slice(0, PREVIEW_LENGTH),
+      });
+    } catch {
+      // File doesn't exist — skip
+    }
+  }
+
+  // Also check for Cursor rules directory
+  const cursorRulesDir = path.join(repoPath, '.cursor', 'rules');
+  try {
+    const entries = await fs.readdir(cursorRulesDir);
+    const mdcFiles = entries.filter((e) => e.endsWith('.mdc'));
+
+    for (const mdc of mdcFiles) {
+      try {
+        const content = await fs.readFile(path.join(cursorRulesDir, mdc), 'utf-8');
+        results.push({
+          assistant: 'cursor',
+          relativePath: `.cursor/rules/${mdc}`,
+          contentPreview: content.slice(0, PREVIEW_LENGTH),
+        });
+      } catch {
+        // Skip unreadable files
+      }
+    }
+  } catch {
+    // No .cursor/rules directory
+  }
+
+  return results;
+}

package/src/analyzers/detect-ports.ts

@@ -1,110 +1,110 @@
-/**
- * @module analyzers/detect-ports
- * Detects configured ports and services in a repository by inspecting
- * environment files, Docker configs, and framework-specific settings.
- */
-
-import * as fs from 'node:fs/promises';
-import * as path from 'node:path';
-
-import type { ServicePort } from '../types.js';
-
-/**
- * Detects ports and service endpoints configured in a repository.
- *
- * Scans:
- * - .env / .env.* files for PORT= patterns
- * - docker-compose.yml for port mappings
- * - launchSettings.json (.NET) for applicationUrl
- * - package.json scripts for --port flags
- *
- * @param repoPath - Absolute path to the repository root.
- * @returns Array of detected {@link ServicePort} objects.
- */
-export async function detectPorts(repoPath: string): Promise<ServicePort[]> {
-  const ports: ServicePort[] = [];
-  const seen = new Set<number>();
-
-  const addPort = (port: number, protocol: 'http' | 'https' | 'grpc' | 'other', source: string) => {
-    if (!seen.has(port)) {
-      seen.add(port);
-      ports.push({ port, protocol, source });
-    }
-  };
-
-  // ── .env files ────────────────────────────────────────────────────
-  const envFiles = ['.env', '.env.local', '.env.development'];
-  for (const envFile of envFiles) {
-    try {
-      const content = await fs.readFile(path.join(repoPath, envFile), 'utf-8');
-      const portMatch = content.match(/PORT\s*=\s*(\d+)/i);
-      if (portMatch) {
-        addPort(parseInt(portMatch[1]!, 10), 'http', envFile);
-      }
-    } catch {
-      // File doesn't exist
-    }
-  }
-
-  // ── docker-compose.yml ────────────────────────────────────────────
-  const composeFiles = ['docker-compose.yml', 'docker-compose.yaml', 'compose.yaml', 'compose.yml'];
-  for (const composeFile of composeFiles) {
-    try {
-      const content = await fs.readFile(path.join(repoPath, composeFile), 'utf-8');
-      // Simple regex to extract port mappings like "3000:3000" or "- 8080:80"
-      const portRegex = /["']?(\d+):(\d+)["']?/g;
-      let match: RegExpExecArray | null;
-      while ((match = portRegex.exec(content)) !== null) {
-        addPort(parseInt(match[1]!, 10), 'http', composeFile);
-      }
-    } catch {
-      // File doesn't exist
-    }
-  }
-
-  // ── launchSettings.json (.NET) ────────────────────────────────────
-  const launchSettingsPath = path.join(repoPath, 'Properties', 'launchSettings.json');
-  try {
-    const raw = await fs.readFile(launchSettingsPath, 'utf-8');
-    const settings = JSON.parse(raw) as Record<string, unknown>;
-    const profiles = settings.profiles as Record<string, Record<string, unknown>> | undefined;
-
-    if (profiles) {
-      for (const profile of Object.values(profiles)) {
-        const appUrl = profile.applicationUrl as string | undefined;
-        if (appUrl) {
-          const urlParts = appUrl.split(';');
-          for (const url of urlParts) {
-            const portMatch = url.match(/:(\d+)/);
-            if (portMatch) {
-              const protocol = url.startsWith('https') ? 'https' : 'http';
-              addPort(parseInt(portMatch[1]!, 10), protocol, 'launchSettings.json');
-            }
-          }
-        }
-      }
-    }
-  } catch {
-    // No launchSettings.json
-  }
-
-  // ── package.json scripts ──────────────────────────────────────────
-  try {
-    const raw = await fs.readFile(path.join(repoPath, 'package.json'), 'utf-8');
-    const pkg = JSON.parse(raw) as Record<string, unknown>;
-    const scripts = pkg.scripts as Record<string, string> | undefined;
-
-    if (scripts) {
-      for (const script of Object.values(scripts)) {
-        const portMatch = script.match(/--port\s+(\d+)/i) ?? script.match(/-p\s+(\d+)/);
-        if (portMatch) {
-          addPort(parseInt(portMatch[1]!, 10), 'http', 'package.json scripts');
-        }
-      }
-    }
-  } catch {
-    // No package.json
-  }
-
-  return ports;
-}
+/**
+ * @module analyzers/detect-ports
+ * Detects configured ports and services in a repository by inspecting
+ * environment files, Docker configs, and framework-specific settings.
+ */
+
+import * as fs from 'node:fs/promises';
+import * as path from 'node:path';
+
+import type { ServicePort } from '../types.js';
+
+/**
+ * Detects ports and service endpoints configured in a repository.
+ *
+ * Scans:
+ * - .env / .env.* files for PORT= patterns
+ * - docker-compose.yml for port mappings
+ * - launchSettings.json (.NET) for applicationUrl
+ * - package.json scripts for --port flags
+ *
+ * @param repoPath - Absolute path to the repository root.
+ * @returns Array of detected {@link ServicePort} objects.
+ */
+export async function detectPorts(repoPath: string): Promise<ServicePort[]> {
+  const ports: ServicePort[] = [];
+  const seen = new Set<number>();
+
+  const addPort = (port: number, protocol: 'http' | 'https' | 'grpc' | 'other', source: string) => {
+    if (!seen.has(port)) {
+      seen.add(port);
+      ports.push({ port, protocol, source });
+    }
+  };
+
+  // ── .env files ────────────────────────────────────────────────────
+  const envFiles = ['.env', '.env.local', '.env.development'];
+  for (const envFile of envFiles) {
+    try {
+      const content = await fs.readFile(path.join(repoPath, envFile), 'utf-8');
+      const portMatch = content.match(/PORT\s*=\s*(\d+)/i);
+      if (portMatch) {
+        addPort(parseInt(portMatch[1]!, 10), 'http', envFile);
+      }
+    } catch {
+      // File doesn't exist
+    }
+  }
+
+  // ── docker-compose.yml ────────────────────────────────────────────
+  const composeFiles = ['docker-compose.yml', 'docker-compose.yaml', 'compose.yaml', 'compose.yml'];
+  for (const composeFile of composeFiles) {
+    try {
+      const content = await fs.readFile(path.join(repoPath, composeFile), 'utf-8');
+      // Simple regex to extract port mappings like "3000:3000" or "- 8080:80"
+      const portRegex = /["']?(\d+):(\d+)["']?/g;
+      let match: RegExpExecArray | null;
+      while ((match = portRegex.exec(content)) !== null) {
+        addPort(parseInt(match[1]!, 10), 'http', composeFile);
+      }
+    } catch {
+      // File doesn't exist
+    }
+  }
+
+  // ── launchSettings.json (.NET) ────────────────────────────────────
+  const launchSettingsPath = path.join(repoPath, 'Properties', 'launchSettings.json');
+  try {
+    const raw = await fs.readFile(launchSettingsPath, 'utf-8');
+    const settings = JSON.parse(raw) as Record<string, unknown>;
+    const profiles = settings.profiles as Record<string, Record<string, unknown>> | undefined;
+
+    if (profiles) {
+      for (const profile of Object.values(profiles)) {
+        const appUrl = profile.applicationUrl as string | undefined;
+        if (appUrl) {
+          const urlParts = appUrl.split(';');
+          for (const url of urlParts) {
+            const portMatch = url.match(/:(\d+)/);
+            if (portMatch) {
+              const protocol = url.startsWith('https') ? 'https' : 'http';
+              addPort(parseInt(portMatch[1]!, 10), protocol, 'launchSettings.json');
+            }
+          }
+        }
+      }
+    }
+  } catch {
+    // No launchSettings.json
+  }
+
+  // ── package.json scripts ──────────────────────────────────────────
+  try {
+    const raw = await fs.readFile(path.join(repoPath, 'package.json'), 'utf-8');
+    const pkg = JSON.parse(raw) as Record<string, unknown>;
+    const scripts = pkg.scripts as Record<string, string> | undefined;
+
+    if (scripts) {
+      for (const script of Object.values(scripts)) {
+        const portMatch = script.match(/--port\s+(\d+)/i) ?? script.match(/-p\s+(\d+)/);
+        if (portMatch) {
+          addPort(parseInt(portMatch[1]!, 10), 'http', 'package.json scripts');
+        }
+      }
+    }
+  } catch {
+    // No package.json
+  }
+
+  return ports;
+}

package/src/analyzers/index.ts

@@ -1,97 +1,97 @@
-/**
- * @module analyzers/index
- * Orchestrates all project analyzers and produces a full ProjectAnalysis
- * for each repository.
- */
-
-import chalk from 'chalk';
-import ora from 'ora';
-
-import type { ProjectAnalysis, RepoInfo } from '../types.js';
-import { detectTechStack } from './tech-stack.js';
-import { detectApis } from './detect-apis.js';
-import { detectDependencies, detectProducedPackages, detectNuGetFeeds } from './detect-deps.js';
-import { detectPorts } from './detect-ports.js';
-import { detectExistingAIConfigs } from './detect-existing.js';
-import { extractReadmeSummary } from './readme-summarizer.js';
-import { analyzeMessaging } from './messaging-analyzer.js';
-import { analyzeRunConfig } from './run-analyzer.js';
-
-/**
- * Runs all analyzers against a single repository and returns
- * a complete {@link ProjectAnalysis}.
- *
- * @param repo - The repo metadata.
- * @returns Full analysis result.
- */
-export async function analyzeRepo(repo: RepoInfo): Promise<ProjectAnalysis> {
-  const [techStack, endpoints, dependencies, produces, nugetFeeds, ports, existingAIConfigs, readmeSummary, messaging, runConfig] =
-    await Promise.all([
-      detectTechStack(repo.path),
-      detectApis(repo.path),
-      detectDependencies(repo.path),
-      detectProducedPackages(repo.path),
-      detectNuGetFeeds(repo.path),
-      detectPorts(repo.path),
-      detectExistingAIConfigs(repo.path),
-      extractReadmeSummary(repo.path),
-      analyzeMessaging(repo.path),
-      analyzeRunConfig(repo.path),
-    ]);
-
-  return {
-    name: repo.name,
-    path: repo.path,
-    techStack,
-    endpoints,
-    dependencies,
-    produces,
-    nugetFeeds,
-    ports,
-    existingAIConfigs,
-    readmeSummary,
-    messaging,
-    runConfig,
-  };
-}
-
-/**
- * Analyzes all repos in a list and returns a Map of path → analysis.
- * Shows a progress spinner while running.
- *
- * @param repos - Array of repos to analyze.
- * @returns Map of repo path to {@link ProjectAnalysis}.
- */
-export async function analyzeAllRepos(
-  repos: RepoInfo[],
-): Promise<Map<string, ProjectAnalysis>> {
-  const spinner = ora('Analyzing projects...').start();
-  const results = new Map<string, ProjectAnalysis>();
-
-  for (let i = 0; i < repos.length; i++) {
-    const repo = repos[i]!;
-    spinner.text = `Analyzing ${chalk.bold(repo.name)} (${i + 1}/${repos.length})...`;
-
-    try {
-      const analysis = await analyzeRepo(repo);
-      results.set(repo.path, analysis);
-    } catch (error) {
-      const msg = error instanceof Error ? error.message : String(error);
-      spinner.warn(`Failed to analyze ${repo.name}: ${msg}`);
-      spinner.start();
-    }
-  }
-
-  spinner.succeed(`Analyzed ${chalk.bold(results.size)} projects`);
-  return results;
-}
-
-// Re-export individual analyzers
-export { detectTechStack } from './tech-stack.js';
-export { detectApis } from './detect-apis.js';
-export { detectDependencies, findInterRepoDependencies, detectNuGetFeeds } from './detect-deps.js';
-export { detectPorts } from './detect-ports.js';
-export { detectExistingAIConfigs } from './detect-existing.js';
-export { extractReadmeSummary } from './readme-summarizer.js';
-export { analyzeMessaging } from './messaging-analyzer.js';
-export { analyzeRunConfig } from './run-analyzer.js';
+/**
+ * @module analyzers/index
+ * Orchestrates all project analyzers and produces a full ProjectAnalysis
+ * for each repository.
+ */
+
+import chalk from 'chalk';
+import ora from 'ora';
+
+import type { ProjectAnalysis, RepoInfo } from '../types.js';
+import { detectTechStack } from './tech-stack.js';
+import { detectApis } from './detect-apis.js';
+import { detectDependencies, detectProducedPackages, detectNuGetFeeds } from './detect-deps.js';
+import { detectPorts } from './detect-ports.js';
+import { detectExistingAIConfigs } from './detect-existing.js';
+import { extractReadmeSummary } from './readme-summarizer.js';
+import { analyzeMessaging } from './messaging-analyzer.js';
+import { analyzeRunConfig } from './run-analyzer.js';
+
+/**
+ * Runs all analyzers against a single repository and returns
+ * a complete {@link ProjectAnalysis}.
+ *
+ * @param repo - The repo metadata.
+ * @returns Full analysis result.
+ */
+export async function analyzeRepo(repo: RepoInfo): Promise<ProjectAnalysis> {
+  const [techStack, endpoints, dependencies, produces, nugetFeeds, ports, existingAIConfigs, readmeSummary, messaging, runConfig] =
+    await Promise.all([
+      detectTechStack(repo.path),
+      detectApis(repo.path),
+      detectDependencies(repo.path),
+      detectProducedPackages(repo.path),
+      detectNuGetFeeds(repo.path),
+      detectPorts(repo.path),
+      detectExistingAIConfigs(repo.path),
+      extractReadmeSummary(repo.path),
+      analyzeMessaging(repo.path),
+      analyzeRunConfig(repo.path),
+    ]);
+
+  return {
+    name: repo.name,
+    path: repo.path,
+    techStack,
+    endpoints,
+    dependencies,
+    produces,
+    nugetFeeds,
+    ports,
+    existingAIConfigs,
+    readmeSummary,
+    messaging,
+    runConfig,
+  };
+}
+
+/**
+ * Analyzes all repos in a list and returns a Map of path → analysis.
+ * Shows a progress spinner while running.
+ *
+ * @param repos - Array of repos to analyze.
+ * @returns Map of repo path to {@link ProjectAnalysis}.
+ */
+export async function analyzeAllRepos(
+  repos: RepoInfo[],
+): Promise<Map<string, ProjectAnalysis>> {
+  const spinner = ora('Analyzing projects...').start();
+  const results = new Map<string, ProjectAnalysis>();
+
+  for (let i = 0; i < repos.length; i++) {
+    const repo = repos[i]!;
+    spinner.text = `Analyzing ${chalk.bold(repo.name)} (${i + 1}/${repos.length})...`;
+
+    try {
+      const analysis = await analyzeRepo(repo);
+      results.set(repo.path, analysis);
+    } catch (error) {
+      const msg = error instanceof Error ? error.message : String(error);
+      spinner.warn(`Failed to analyze ${repo.name}: ${msg}`);
+      spinner.start();
+    }
+  }
+
+  spinner.succeed(`Analyzed ${chalk.bold(results.size)} projects`);
+  return results;
+}
+
+// Re-export individual analyzers
+export { detectTechStack } from './tech-stack.js';
+export { detectApis } from './detect-apis.js';
+export { detectDependencies, findInterRepoDependencies, detectNuGetFeeds } from './detect-deps.js';
+export { detectPorts } from './detect-ports.js';
+export { detectExistingAIConfigs } from './detect-existing.js';
+export { extractReadmeSummary } from './readme-summarizer.js';
+export { analyzeMessaging } from './messaging-analyzer.js';
+export { analyzeRunConfig } from './run-analyzer.js';