@mrpatronz/nexusflow 0.2.0 → 0.2.2

package/dist/analyzers/index.d.ts

@@ -26,4 +26,6 @@ export { detectDependencies, findInterRepoDependencies, detectNuGetFeeds } from
 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';
 //# sourceMappingURL=index.d.ts.map

package/dist/analyzers/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/analyzers/index.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAKH,OAAO,KAAK,EAAE,eAAe,EAAE,QAAQ,EAAE,MAAM,aAAa,CAAC;AAQ7D;;;;;;GAMG;AACH,wBAAsB,WAAW,CAAC,IAAI,EAAE,QAAQ,GAAG,OAAO,CAAC,eAAe,CAAC,CAyB1E;AAED;;;;;;GAMG;AACH,wBAAsB,eAAe,CACnC,KAAK,EAAE,QAAQ,EAAE,GAChB,OAAO,CAAC,GAAG,CAAC,MAAM,EAAE,eAAe,CAAC,CAAC,CAoBvC;AAGD,OAAO,EAAE,eAAe,EAAE,MAAM,iBAAiB,CAAC;AAClD,OAAO,EAAE,UAAU,EAAE,MAAM,kBAAkB,CAAC;AAC9C,OAAO,EAAE,kBAAkB,EAAE,yBAAyB,EAAE,gBAAgB,EAAE,MAAM,kBAAkB,CAAC;AACnG,OAAO,EAAE,WAAW,EAAE,MAAM,mBAAmB,CAAC;AAChD,OAAO,EAAE,uBAAuB,EAAE,MAAM,sBAAsB,CAAC;AAC/D,OAAO,EAAE,oBAAoB,EAAE,MAAM,wBAAwB,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/analyzers/index.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAKH,OAAO,KAAK,EAAE,eAAe,EAAE,QAAQ,EAAE,MAAM,aAAa,CAAC;AAU7D;;;;;;GAMG;AACH,wBAAsB,WAAW,CAAC,IAAI,EAAE,QAAQ,GAAG,OAAO,CAAC,eAAe,CAAC,CA6B1E;AAED;;;;;;GAMG;AACH,wBAAsB,eAAe,CACnC,KAAK,EAAE,QAAQ,EAAE,GAChB,OAAO,CAAC,GAAG,CAAC,MAAM,EAAE,eAAe,CAAC,CAAC,CAoBvC;AAGD,OAAO,EAAE,eAAe,EAAE,MAAM,iBAAiB,CAAC;AAClD,OAAO,EAAE,UAAU,EAAE,MAAM,kBAAkB,CAAC;AAC9C,OAAO,EAAE,kBAAkB,EAAE,yBAAyB,EAAE,gBAAgB,EAAE,MAAM,kBAAkB,CAAC;AACnG,OAAO,EAAE,WAAW,EAAE,MAAM,mBAAmB,CAAC;AAChD,OAAO,EAAE,uBAAuB,EAAE,MAAM,sBAAsB,CAAC;AAC/D,OAAO,EAAE,oBAAoB,EAAE,MAAM,wBAAwB,CAAC;AAC9D,OAAO,EAAE,gBAAgB,EAAE,MAAM,yBAAyB,CAAC;AAC3D,OAAO,EAAE,gBAAgB,EAAE,MAAM,mBAAmB,CAAC"}

package/dist/analyzers/index.js

@@ -11,6 +11,8 @@ import { detectDependencies, detectProducedPackages, detectNuGetFeeds } from './
 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}.
@@ -19,7 +21,7 @@ import { extractReadmeSummary } from './readme-summarizer.js';
  * @returns Full analysis result.
  */
 export async function analyzeRepo(repo) {
-    const [techStack, endpoints, dependencies, produces, nugetFeeds, ports, existingAIConfigs, readmeSummary] = await Promise.all([
+    const [techStack, endpoints, dependencies, produces, nugetFeeds, ports, existingAIConfigs, readmeSummary, messaging, runConfig] = await Promise.all([
         detectTechStack(repo.path),
         detectApis(repo.path),
         detectDependencies(repo.path),
@@ -28,6 +30,8 @@ export async function analyzeRepo(repo) {
         detectPorts(repo.path),
         detectExistingAIConfigs(repo.path),
         extractReadmeSummary(repo.path),
+        analyzeMessaging(repo.path),
+        analyzeRunConfig(repo.path),
     ]);
     return {
         name: repo.name,
@@ -40,6 +44,8 @@ export async function analyzeRepo(repo) {
         ports,
         existingAIConfigs,
         readmeSummary,
+        messaging,
+        runConfig,
     };
 }
 /**
@@ -75,4 +81,6 @@ export { detectDependencies, findInterRepoDependencies, detectNuGetFeeds } from
 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';
 //# sourceMappingURL=index.js.map

package/dist/analyzers/index.js.map

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

package/dist/analyzers/messaging-analyzer.d.ts

@@ -0,0 +1,17 @@
+/**
+ * @module analyzers/messaging-analyzer
+ * Detects publishers and subscribers for pub/sub messaging topologies
+ * across multiple programming languages and frameworks.
+ */
+import type { MessagingTopology } 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 declare function analyzeMessaging(repoPath: string): Promise<MessagingTopology>;
+//# sourceMappingURL=messaging-analyzer.d.ts.map

package/dist/analyzers/messaging-analyzer.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"messaging-analyzer.d.ts","sourceRoot":"","sources":["../../src/analyzers/messaging-analyzer.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAKH,OAAO,KAAK,EAAE,iBAAiB,EAAuC,MAAM,aAAa,CAAC;AAE1F;;;;;;;;GAQG;AACH,wBAAsB,gBAAgB,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,iBAAiB,CAAC,CAyOnF"}

package/dist/analyzers/messaging-analyzer.js

@@ -0,0 +1,229 @@
+/**
+ * @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';
+/**
+ * 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) {
+    const publishers = [];
+    const subscribers = [];
+    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;
+                    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;
+                    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;
+                    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;
+                    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 = [];
+    const seenPub = new Set();
+    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 = [];
+    const seenSub = new Set();
+    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,
+    };
+}
+//# sourceMappingURL=messaging-analyzer.js.map

package/dist/analyzers/messaging-analyzer.js.map

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

package/dist/analyzers/readme-summarizer.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"readme-summarizer.d.ts","sourceRoot":"","sources":["../../src/analyzers/readme-summarizer.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAKH;;;;;;;;GAQG;AACH,wBAAsB,oBAAoB,CACxC,QAAQ,EAAE,MAAM,GACf,OAAO,CAAC,MAAM,GAAG,IAAI,CAAC,CA6ExB"}
+{"version":3,"file":"readme-summarizer.d.ts","sourceRoot":"","sources":["../../src/analyzers/readme-summarizer.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAKH;;;;;;;;GAQG;AACH,wBAAsB,oBAAoB,CACxC,QAAQ,EAAE,MAAM,GACf,OAAO,CAAC,MAAM,GAAG,IAAI,CAAC,CAkFxB"}

package/dist/analyzers/readme-summarizer.js

@@ -63,12 +63,16 @@ export async function extractReadmeSummary(repoPath) {
         if (trimmed.startsWith('#'))
             continue;
         // Detect Table of Contents (TOC) lists
-        // Skip lines that look like: - [About](#about) or * 1. [Section](#section)
-        if (/^[-*+]\s*(\d+\.)?\s*\[[^\]]+\]\(#[^)]+\)/.test(trimmed)) {
+        // 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 standard bullet lists if we are searching for prose (e.g. at the top of README before prose)
-        if (proseLines.length === 0 && /^[-*+]\s+/.test(trimmed)) {
+        // 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

package/dist/analyzers/readme-summarizer.js.map

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

package/dist/analyzers/run-analyzer.d.ts

@@ -0,0 +1,15 @@
+/**
+ * @module analyzers/run-analyzer
+ * Analyzes projects to discover local run configurations, entry points,
+ * database dependencies, external services, and flags shared staging/test
+ * infrastructure or committed secrets.
+ */
+import type { RunConfig } from '../types.js';
+/**
+ * Analyzes local run configurations, databases, and dependencies in a repository.
+ *
+ * @param repoPath - Absolute path to the repository root.
+ * @returns Run configuration analysis.
+ */
+export declare function analyzeRunConfig(repoPath: string): Promise<RunConfig>;
+//# sourceMappingURL=run-analyzer.d.ts.map

package/dist/analyzers/run-analyzer.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"run-analyzer.d.ts","sourceRoot":"","sources":["../../src/analyzers/run-analyzer.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAMH,OAAO,KAAK,EAAE,SAAS,EAAwF,MAAM,aAAa,CAAC;AAEnI;;;;;GAKG;AACH,wBAAsB,gBAAgB,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,SAAS,CAAC,CAyP3E"}

package/dist/analyzers/run-analyzer.js

@@ -0,0 +1,246 @@
+/**
+ * @module analyzers/run-analyzer
+ * Analyzes projects to discover local run configurations, entry points,
+ * database dependencies, external services, and flags shared staging/test
+ * infrastructure or committed secrets.
+ */
+import * as fsp from 'node:fs/promises';
+import * as path from 'node:path';
+import { globby } from 'globby';
+/**
+ * Analyzes local run configurations, databases, and dependencies in a repository.
+ *
+ * @param repoPath - Absolute path to the repository root.
+ * @returns Run configuration analysis.
+ */
+export async function analyzeRunConfig(repoPath) {
+    const entryPoints = [];
+    const databases = [];
+    const sharedInfraWarnings = [];
+    const committedSecrets = [];
+    const externalDependencies = [];
+    const isLocalHost = (host) => {
+        const h = host.toLowerCase().trim();
+        return (h.includes('localhost') ||
+            h.includes('127.0.0.1') ||
+            h.includes('[::1]') ||
+            h.includes('(localdb)') ||
+            h === 'db' ||
+            h === 'postgres' ||
+            h === 'redis' ||
+            h === 'mongo');
+    };
+    try {
+        // ── 1. Entry Points Detection ──────────────────────────────────────────
+        // A. Check for C# Web/Worker apps
+        const csprojFiles = await globby('**/*.csproj', {
+            cwd: repoPath,
+            absolute: true,
+            ignore: ['**/node_modules/**', '**/bin/**', '**/obj/**', '**/dist/**', '**/out/**', '**/.git/**'],
+        });
+        for (const file of csprojFiles) {
+            try {
+                const content = await fsp.readFile(file, 'utf-8');
+                const relPath = path.relative(repoPath, file).replace(/\\/g, '/');
+                if (content.includes('Sdk="Microsoft.NET.Sdk.Web"')) {
+                    entryPoints.push({
+                        projectPath: relPath,
+                        type: 'aspnet',
+                        command: 'dotnet run',
+                    });
+                }
+                else if (content.includes('Sdk="Microsoft.NET.Sdk.Worker"')) {
+                    entryPoints.push({
+                        projectPath: relPath,
+                        type: 'worker',
+                        command: 'dotnet run',
+                    });
+                }
+            }
+            catch { }
+        }
+        // B. Check for package.json (Node/JS/TS)
+        const packageJsonPath = path.join(repoPath, 'package.json');
+        try {
+            const raw = await fsp.readFile(packageJsonPath, 'utf-8');
+            const pkg = JSON.parse(raw);
+            if (pkg.scripts && (pkg.scripts.start || pkg.scripts.dev)) {
+                entryPoints.push({
+                    projectPath: 'package.json',
+                    type: pkg.dependencies && pkg.dependencies.next ? 'nextjs' : 'node',
+                    command: pkg.scripts.dev ? 'npm run dev' : 'npm start',
+                });
+            }
+        }
+        catch { }
+        // C. Check for Python/Go
+        const goModFiles = await globby('**/go.mod', { cwd: repoPath, absolute: true });
+        if (goModFiles.length > 0) {
+            entryPoints.push({
+                projectPath: path.relative(repoPath, goModFiles[0]).replace(/\\/g, '/'),
+                type: 'go',
+                command: 'go run .',
+            });
+        }
+        const pyFiles = await globby(['**/requirements.txt', '**/Pipfile', '**/pyproject.toml'], { cwd: repoPath, absolute: true });
+        if (pyFiles.length > 0) {
+            entryPoints.push({
+                projectPath: path.relative(repoPath, pyFiles[0]).replace(/\\/g, '/'),
+                type: 'python',
+                command: 'python main.py',
+            });
+        }
+        // ── 2. Config Files Parsing (DBs, Shared Infra, Secrets) ───────────────
+        const configFiles = await globby(['**/appsettings.json', '**/appsettings.Development.json', '**/appsettings.*.json', '**/.env', '**/.env.development', '**/.env.local'], {
+            cwd: repoPath,
+            absolute: true,
+            ignore: ['**/node_modules/**', '**/bin/**', '**/obj/**', '**/dist/**', '**/out/**', '**/.git/**'],
+        });
+        for (const file of configFiles) {
+            try {
+                const content = await fsp.readFile(file, 'utf-8');
+                const relPath = path.relative(repoPath, file).replace(/\\/g, '/');
+                // Secrets Check (Universal regex for high probability secrets)
+                const secretRegex = /(?:password|pwd|secret|key|token|privatekey|accountkey|sharedaccesskey)\s*[=:]\s*['"`]?([^'";\s]{12,})['"`]?/gi;
+                let secretMatch;
+                while ((secretMatch = secretRegex.exec(content)) !== null) {
+                    const matchedVal = secretMatch[1];
+                    // Skip if it looks like a placeholder
+                    if (!matchedVal.includes('placeholder') && !matchedVal.includes('<your') && !matchedVal.toLowerCase().includes('your_')) {
+                        committedSecrets.push({
+                            file: relPath,
+                            lineHint: secretMatch[0].split(/[=:]/)[0].trim(),
+                        });
+                    }
+                }
+                if (file.endsWith('.json')) {
+                    const parsed = JSON.parse(content);
+                    // connectionStrings
+                    if (parsed.ConnectionStrings) {
+                        for (const [key, value] of Object.entries(parsed.ConnectionStrings)) {
+                            if (typeof value === 'string') {
+                                let provider = 'unknown';
+                                if (value.toLowerCase().includes('sql server') || value.toLowerCase().includes('sqlexpress') || value.toLowerCase().includes('server=')) {
+                                    provider = 'SQL Server';
+                                }
+                                if (value.toLowerCase().includes('postgresql') || value.toLowerCase().includes('port=5432')) {
+                                    provider = 'PostgreSQL';
+                                }
+                                // Extract Host
+                                const hostMatch = value.match(/Server=([^;]+)/i) ?? value.match(/Host=([^;]+)/i) ?? value.match(/Data Source=([^;]+)/i);
+                                const host = hostMatch ? hostMatch[1].trim() : 'unknown';
+                                databases.push({
+                                    provider,
+                                    host,
+                                    configFile: relPath,
+                                });
+                                if (host !== 'unknown' && !isLocalHost(host)) {
+                                    sharedInfraWarnings.push({
+                                        resource: key,
+                                        host,
+                                        configFile: relPath,
+                                        warning: `⚠️ SHARED INFRA: ${relPath} binds ConnectionString "${key}" to non-local host (${host}). Running locally may connect to shared test/production databases.`,
+                                    });
+                                }
+                            }
+                        }
+                    }
+                    // Service Bus or MQ settings
+                    const rabbitRegex = /"HostName"\s*:\s*"([^"]+)"/gi;
+                    let rabbitMatch;
+                    while ((rabbitMatch = rabbitRegex.exec(content)) !== null) {
+                        const host = rabbitMatch[1];
+                        if (!isLocalHost(host)) {
+                            sharedInfraWarnings.push({
+                                resource: 'RabbitMQ',
+                                host,
+                                configFile: relPath,
+                                warning: `⚠️ SHARED INFRA: ${relPath} binds RabbitMQ host to non-local host (${host}).`,
+                            });
+                        }
+                    }
+                }
+                else {
+                    // B. .env parsing
+                    const lines = content.split('\n');
+                    for (const line of lines) {
+                        const cleanLine = line.trim();
+                        if (cleanLine.startsWith('#') || !cleanLine.includes('='))
+                            continue;
+                        const [key, val] = cleanLine.split('=', 2);
+                        if (!key || !val)
+                            continue;
+                        const cleanKey = key.trim();
+                        const cleanVal = val.trim().replace(/^['"]|['"]$/g, '');
+                        // DB UrL e.g. DATABASE_URL=postgres://user:pass@host:port/db
+                        if (cleanKey.includes('DATABASE_URL') || cleanKey.includes('MONGODB_URI') || cleanKey.includes('REDIS_URL')) {
+                            let provider = 'unknown';
+                            if (cleanVal.startsWith('postgres'))
+                                provider = 'PostgreSQL';
+                            else if (cleanVal.startsWith('mongodb'))
+                                provider = 'MongoDB';
+                            else if (cleanVal.startsWith('redis'))
+                                provider = 'Redis';
+                            // Extract Host from URL
+                            const hostMatch = cleanVal.match(/@([^:/]+)/);
+                            const host = hostMatch ? hostMatch[1] : cleanVal;
+                            databases.push({
+                                provider,
+                                host,
+                                configFile: relPath,
+                            });
+                            if (!isLocalHost(host)) {
+                                sharedInfraWarnings.push({
+                                    resource: cleanKey,
+                                    host,
+                                    configFile: relPath,
+                                    warning: `⚠️ SHARED INFRA: .env variable "${cleanKey}" points to non-local host (${host}).`,
+                                });
+                            }
+                        }
+                    }
+                }
+            }
+            catch { }
+        }
+    }
+    catch {
+        // Ignore errors
+    }
+    // De-duplicate external dependencies / warnings
+    const uniqueInfraWarnings = [];
+    const seenInfra = new Set();
+    for (const w of sharedInfraWarnings) {
+        const key = `${w.resource}:${w.host}:${w.configFile}`;
+        if (!seenInfra.has(key)) {
+            seenInfra.add(key);
+            uniqueInfraWarnings.push(w);
+        }
+    }
+    const uniqueDatabases = [];
+    const seenDb = new Set();
+    for (const db of databases) {
+        const key = `${db.provider}:${db.host}:${db.configFile}`;
+        if (!seenDb.has(key)) {
+            seenDb.add(key);
+            uniqueDatabases.push(db);
+        }
+    }
+    const uniqueSecrets = [];
+    const seenSecret = new Set();
+    for (const s of committedSecrets) {
+        const key = `${s.file}:${s.lineHint}`;
+        if (!seenSecret.has(key)) {
+            seenSecret.add(key);
+            uniqueSecrets.push(s);
+        }
+    }
+    return {
+        entryPoints,
+        databases: uniqueDatabases,
+        sharedInfraWarnings: uniqueInfraWarnings,
+        committedSecrets: uniqueSecrets,
+        externalDependencies,
+    };
+}
+//# sourceMappingURL=run-analyzer.js.map