@mrpatronz/nexusflow 0.2.18 → 1.3.0

package/src/analyzers/detect-ports.ts

@@ -1,110 +0,0 @@
-/**
- * @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 +0,0 @@
-/**
- * @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';

package/src/analyzers/messaging-analyzer.ts

@@ -1,254 +0,0 @@
-/**
- * @module analyzers/messaging-analyzer
- * Detects publishers and subscribers for pub/sub messaging topologies
- * across multiple programming languages and frameworks.
- */
-
-import * as fs from 'node:fs/promises';
-import * as path from 'node:path';
-import { globby } from 'globby';
-import type { MessagingTopology, MessagePublisher, MessageSubscriber } from '../types.js';
-
-/**
- * Analyzes messaging/event topology in a repository.
- *
- * Scans C#, JS/TS, Python, and Go source files for publish and subscribe
- * patterns and extracts message/event contracts.
- *
- * @param repoPath - Absolute path to the repository root.
- * @returns Detected publishers and subscribers.
- */
-export async function analyzeMessaging(repoPath: string): Promise<MessagingTopology> {
-  const publishers: MessagePublisher[] = [];
-  const subscribers: MessageSubscriber[] = [];
-
-  try {
-    const files = await globby(
-      ['**/*.ts', '**/*.js', '**/*.cs', '**/*.py', '**/*.go'],
-      {
-        cwd: repoPath,
-        absolute: true,
-        ignore: ['**/node_modules/**', '**/bin/**', '**/obj/**', '**/dist/**', '**/out/**', '**/.git/**'],
-      }
-    );
-
-    for (const file of files) {
-      try {
-        const stat = await fs.stat(file);
-        if (!stat.isFile() || stat.size > 200_000) continue; // Skip large files
-
-        const content = await fs.readFile(file, 'utf-8');
-        const relPath = path.relative(repoPath, file).replace(/\\/g, '/');
-
-        if (file.endsWith('.cs')) {
-          // ── C# Messaging Patterns ────────────────────────────────────────
-
-          // MediatR notification handler
-          // INotificationHandler<MyNotification>
-          const mediatrSubRegex = /:\s*INotificationHandler\s*<\s*(\w+)\s*>/g;
-          let match: RegExpExecArray | null;
-          while ((match = mediatrSubRegex.exec(content)) !== null) {
-            subscribers.push({
-              contractType: match[1]!,
-              handlerFile: relPath,
-              registrationFile: relPath,
-            });
-          }
-
-          // MediatR command/query handler
-          // IRequestHandler<MyRequest, MyResponse> or IRequestHandler<MyRequest>
-          const requestHandlerRegex = /:\s*IRequestHandler\s*<\s*(\w+)(?:\s*,\s*\w+)?\s*>/g;
-          while ((match = requestHandlerRegex.exec(content)) !== null) {
-            subscribers.push({
-              contractType: match[1]!,
-              handlerFile: relPath,
-              registrationFile: relPath,
-            });
-          }
-
-          // MassTransit Consumer: IConsumer<MyMessage>
-          const massTransitSubRegex = /:\s*IConsumer\s*<\s*(\w+)\s*>/g;
-          while ((match = massTransitSubRegex.exec(content)) !== null) {
-            subscribers.push({
-              contractType: match[1]!,
-              handlerFile: relPath,
-              registrationFile: relPath,
-            });
-          }
-
-          // NServiceBus Handler: IHandleMessages<MyMessage>
-          const nserviceBusSubRegex = /:\s*IHandleMessages\s*<\s*(\w+)\s*>/g;
-          while ((match = nserviceBusSubRegex.exec(content)) !== null) {
-            subscribers.push({
-              contractType: match[1]!,
-              handlerFile: relPath,
-              registrationFile: relPath,
-            });
-          }
-
-          // Azure Service Bus triggers: [ServiceBusTrigger("queueOrTopicName")]
-          const sbtRegex = /\[ServiceBusTrigger\s*\(\s*"([^"]+)"(?:\s*,\s*"[^"]+")?\s*\)\]/g;
-          while ((match = sbtRegex.exec(content)) !== null) {
-            subscribers.push({
-              contractType: 'ServiceBusMessage',
-              handlerFile: relPath,
-              registrationFile: relPath,
-            });
-          }
-
-          // Publishers in C#
-          // .Publish<MyEvent>( or .PublishAsync<MyEvent>( or .Send<MyCommand>( or .SendAsync<MyCommand>(
-          const csPubRegex = /\b(?:Publish|PublishAsync|Send|SendAsync)\s*<\s*(\w+)\s*>\s*\(/g;
-          while ((match = csPubRegex.exec(content)) !== null) {
-            publishers.push({
-              contractType: match[1]!,
-              topicOrQueue: 'direct/inferred',
-              publisherFile: relPath,
-            });
-          }
-          
-          const mediatorSendRegex = /\bmediator\s*\.\s*(?:Send|Publish)\s*\(\s*new\s+(\w+)\s*\(/gi;
-          while ((match = mediatorSendRegex.exec(content)) !== null) {
-            publishers.push({
-              contractType: match[1]!,
-              topicOrQueue: 'mediator',
-              publisherFile: relPath,
-            });
-          }
-
-        } else if (file.endsWith('.ts') || file.endsWith('.js')) {
-          // ── TS/JS Messaging Patterns ─────────────────────────────────────
-
-          // EventEmitter emitters: emit('event-name', ...)
-          const tsEmitRegex = /\bemit\s*\(\s*['"`]([^'"`]+)['"`]/g;
-          let match: RegExpExecArray | null;
-          while ((match = tsEmitRegex.exec(content)) !== null) {
-            publishers.push({
-              contractType: match[1]!,
-              topicOrQueue: 'EventEmitter',
-              publisherFile: relPath,
-            });
-          }
-
-          // EventEmitter listeners: on('event-name', ...) or addListener('event-name', ...)
-          const tsOnRegex = /\b(?:on|addListener)\s*\(\s*['"`]([^'"`]+)['"`]/g;
-          while ((match = tsOnRegex.exec(content)) !== null) {
-            subscribers.push({
-              contractType: match[1]!,
-              handlerFile: relPath,
-              registrationFile: relPath,
-            });
-          }
-
-          // Kafka/RabbitMQ subscribe: topic: 'topic-name' inside subscription object
-          const tsSubTopicRegex = /topic\s*:\s*['"`]([^'"`]+)['"`]/g;
-          while ((match = tsSubTopicRegex.exec(content)) !== null) {
-            subscribers.push({
-              contractType: 'Kafka/MQ Message',
-              handlerFile: relPath,
-              registrationFile: relPath,
-            });
-          }
-
-          // BullMQ add: queue.add('job-name', ...)
-          const bullmqAddRegex = /\badd\s*\(\s*['"`]([^'"`]+)['"`]/g;
-          while ((match = bullmqAddRegex.exec(content)) !== null) {
-            publishers.push({
-              contractType: match[1]!,
-              topicOrQueue: 'BullMQ',
-              publisherFile: relPath,
-            });
-          }
-
-        } else if (file.endsWith('.py')) {
-          // ── Python Messaging Patterns ────────────────────────────────────
-
-          // Celery task definitions: @app.task or @shared_task
-          const celeryTaskRegex = /@(?:[a-zA-Z0-9_]+\.)?(?:task|shared_task)(?:\([^)]*\))?\s*\n\s*def\s+(\w+)\s*\(/g;
-          let match: RegExpExecArray | null;
-          while ((match = celeryTaskRegex.exec(content)) !== null) {
-            subscribers.push({
-              contractType: match[1]!,
-              handlerFile: relPath,
-              registrationFile: relPath,
-            });
-          }
-
-          // Celery task invocations: task.delay(...) or task.apply_async(...)
-          const celeryDelayRegex = /\b(\w+)\s*\.\s*(?:delay|apply_async)\s*\(/g;
-          while ((match = celeryDelayRegex.exec(content)) !== null) {
-            publishers.push({
-              contractType: match[1]!,
-              topicOrQueue: 'Celery',
-              publisherFile: relPath,
-            });
-          }
-
-          // RabbitMQ basic_publish: routing_key='key'
-          const pikaPublishRegex = /routing_key\s*=\s*['"`]([^'"`]+)['"`]/g;
-          while ((match = pikaPublishRegex.exec(content)) !== null) {
-            publishers.push({
-              contractType: match[1]!,
-              topicOrQueue: 'RabbitMQ',
-              publisherFile: relPath,
-            });
-          }
-
-        } else if (file.endsWith('.go')) {
-          // ── Go Messaging Patterns ────────────────────────────────────────
-
-          // Go publish/produce calls: Publish("topic", ...) or Produce("topic", ...)
-          const goPubRegex = /\b(?:Publish|Produce|Send)\s*\(\s*['"`]([^'"`]+)['"`]/g;
-          let match: RegExpExecArray | null;
-          while ((match = goPubRegex.exec(content)) !== null) {
-            publishers.push({
-              contractType: 'GoMessage',
-              topicOrQueue: match[1]!,
-              publisherFile: relPath,
-            });
-          }
-
-          // Go subscribe/consume calls: Subscribe("topic", ...) or Consume("topic", ...)
-          const goSubRegex = /\b(?:Subscribe|Consume)\s*\(\s*['"`]([^'"`]+)['"`]/g;
-          while ((match = goSubRegex.exec(content)) !== null) {
-            subscribers.push({
-              contractType: 'GoMessage',
-              handlerFile: relPath,
-              registrationFile: relPath,
-            });
-          }
-        }
-      } catch {
-        // Skip unreadable files
-      }
-    }
-  } catch {
-    // Ignore errors
-  }
-
-  // De-duplicate publishers & subscribers
-  const uniquePublishers: MessagePublisher[] = [];
-  const seenPub = new Set<string>();
-  for (const p of publishers) {
-    const key = `${p.contractType}:${p.topicOrQueue}:${p.publisherFile}`;
-    if (!seenPub.has(key)) {
-      seenPub.add(key);
-      uniquePublishers.push(p);
-    }
-  }
-
-  const uniqueSubscribers: MessageSubscriber[] = [];
-  const seenSub = new Set<string>();
-  for (const s of subscribers) {
-    const key = `${s.contractType}:${s.handlerFile}:${s.registrationFile}`;
-    if (!seenSub.has(key)) {
-      seenSub.add(key);
-      uniqueSubscribers.push(s);
-    }
-  }
-
-  return {
-    publishers: uniquePublishers,
-    subscribers: uniqueSubscribers,
-  };
-}

package/src/analyzers/readme-summarizer.ts

@@ -1,102 +0,0 @@
-/**
- * @module analyzers/readme-summarizer
- * Extracts a summary from a repository's README.md file.
- */
-
-import * as fs from 'node:fs/promises';
-import * as path from 'node:path';
-
-/**
- * Reads a repository's README.md and extracts the first meaningful
- * prose paragraph as a summary. Looks for README.md (case-insensitive).
- *
- * It automatically strips badges, TOC lists, headers, HTML tags, and redacts ClientIDs/Secrets.
- *
- * @param repoPath - Absolute path to the repository root.
- * @returns The extracted summary text, or null if no README is found.
- */
-export async function extractReadmeSummary(
-  repoPath: string,
-): Promise<string | null> {
-  // Try common README filenames
-  const candidates = ['README.md', 'readme.md', 'Readme.md', 'README.MD', 'README'];
-
-  let content: string | null = null;
-
-  for (const filename of candidates) {
-    try {
-      content = await fs.readFile(path.join(repoPath, filename), 'utf-8');
-      break;
-    } catch {
-      continue;
-    }
-  }
-
-  if (!content) return null;
-
-  // 1. Strip code blocks to avoid false matching on secrets/prose
-  content = content.replace(/```[\s\S]*?```/g, '');
-
-  // 2. Scrub ClientIDs/Secrets/Credentials
-  // Match standard secret/ID patterns: GUIDs, client_id/secret variables, hex keys
-  const clientSecretsRegex = /(client_id|client_secret|appid|secret|password|key|token|credential)\s*[:=]\s*["']?[a-zA-Z0-9-_\/\+\.]{16,}["']?/gi;
-  const guidRegex = /[a-fA-F0-9]{8}-[a-fA-F0-9]{4}-[a-fA-F0-9]{4}-[a-fA-F0-9]{4}-[a-fA-F0-9]{12}/g;
-  
-  content = content
-    .replace(clientSecretsRegex, (match, p1) => `${p1}: [REDACTED]`)
-    .replace(guidRegex, '[REDACTED_ID]');
-
-  // 3. Process line-by-line to find the first prose paragraph
-  const lines = content.split('\n');
-  const proseLines: string[] = [];
-
-  for (const line of lines) {
-    const trimmed = line.trim();
-
-    // Skip empty lines
-    if (!trimmed) {
-      if (proseLines.length > 0) {
-        // We found a paragraph and hit an empty line. Let's finish!
-        break;
-      }
-      continue;
-    }
-
-    // Skip HTML tags
-    if (trimmed.startsWith('<') && trimmed.endsWith('>')) continue;
-
-    // Skip badges
-    if (trimmed.startsWith('[![') || (trimmed.startsWith('![') && trimmed.includes('http'))) continue;
-
-    // Skip horizontal rules
-    if (/^(-{3,}|={3,}|\*{3,})$/.test(trimmed)) continue;
-
-    // Skip headers (Markdown # )
-    if (trimmed.startsWith('#')) continue;
-
-    // Detect Table of Contents (TOC) lists
-    // Skip lines that look like: - [About](#about) or 1. [About](#about) or * 1. [Section](#section)
-    if (/^(?:[-*+]\s*|\d+\.\s*)(\d+\.)?\s*\[[^\]]+\]\(#[^)]+\)/.test(trimmed)) {
-      continue;
-    }
-
-    // Skip link-only lines (e.g., "[API Docs](https://...)")
-    if (/^\[[^\]]+\]\([^)]+\)$/.test(trimmed)) {
-      continue;
-    }
-
-    // Skip standard bullet and numbered lists if we are searching for prose (e.g. at the top of README before prose)
-    if (proseLines.length === 0 && (/^[-*+]\s+/.test(trimmed) || /^\d+\.\s+/.test(trimmed))) {
-      continue;
-    }
-
-    // Accumulate prose lines
-    proseLines.push(line);
-  }
-
-  const summary = proseLines.join(' ').replace(/\s+/g, ' ').trim();
-  if (!summary) return null;
-  
-  // Limit the summary to a concise paragraph (first 250 characters)
-  return summary.length > 250 ? summary.slice(0, 250) + '...' : summary;
-}