@fairfox/polly 0.1.1 → 0.1.2

package/vendor/verify/src/adapters/detection.ts

@@ -0,0 +1,281 @@
+// ═══════════════════════════════════════════════════════════════
+// Adapter Auto-Detection
+// ═══════════════════════════════════════════════════════════════
+//
+// Automatically detects which adapter to use based on project structure,
+// dependencies, and code patterns.
+
+import { Project, type SourceFile } from "ts-morph";
+import type { RoutingAdapter } from "./base";
+import { WebExtensionAdapter, type WebExtensionAdapterConfig } from "./web-extension";
+import { EventBusAdapter, type EventBusAdapterConfig } from "./event-bus";
+
+// ─────────────────────────────────────────────────────────────────
+// Detection Result
+// ─────────────────────────────────────────────────────────────────
+
+export interface AdapterDetectionResult {
+  /** The recommended adapter type */
+  adapterType: "web-extension" | "event-bus" | "worker" | "unknown";
+
+  /** Confidence level (0-100) */
+  confidence: number;
+
+  /** Evidence supporting this detection */
+  evidence: string[];
+
+  /** Suggested adapter configuration */
+  suggestedAdapter?: RoutingAdapter;
+
+  /** Alternative adapters that might also work */
+  alternatives?: Array<{
+    adapterType: string;
+    confidence: number;
+    evidence: string[];
+  }>;
+}
+
+// ─────────────────────────────────────────────────────────────────
+// Adapter Detector
+// ─────────────────────────────────────────────────────────────────
+
+export class AdapterDetector {
+  private project: Project;
+
+  constructor(tsConfigPath: string) {
+    this.project = new Project({
+      tsConfigFilePath: tsConfigPath,
+    });
+  }
+
+  /**
+   * Detect the most appropriate adapter for this project
+   */
+  detect(): AdapterDetectionResult {
+    const sourceFiles = this.project.getSourceFiles();
+
+    // Run all detection heuristics
+    const webExtensionScore = this.detectWebExtension(sourceFiles);
+    const eventBusScore = this.detectEventBus(sourceFiles);
+    const workerScore = this.detectWorker(sourceFiles);
+
+    // Determine the best match
+    const scores = [
+      { type: "web-extension" as const, ...webExtensionScore },
+      { type: "event-bus" as const, ...eventBusScore },
+      { type: "worker" as const, ...workerScore },
+    ].sort((a, b) => b.confidence - a.confidence);
+
+    const best = scores[0]!;
+    const alternatives = scores.slice(1).filter((s) => s.confidence > 20);
+
+    // Create suggested adapter for the best match
+    let suggestedAdapter: RoutingAdapter | undefined;
+    if (best.confidence > 50) {
+      if (best.type === "web-extension") {
+        suggestedAdapter = new WebExtensionAdapter({
+          tsConfigPath:
+            (this.project.getCompilerOptions().configFilePath as string) || "tsconfig.json",
+          maxInFlight: 6,
+          maxTabs: 2,
+        });
+      } else if (best.type === "event-bus") {
+        suggestedAdapter = new EventBusAdapter({
+          tsConfigPath:
+            (this.project.getCompilerOptions().configFilePath as string) || "tsconfig.json",
+          maxInFlight: 5,
+        });
+      }
+    }
+
+    return {
+      adapterType: best.confidence > 30 ? best.type : "unknown",
+      confidence: best.confidence,
+      evidence: best.evidence,
+      suggestedAdapter,
+      alternatives: alternatives.map((a) => ({
+        adapterType: a.type,
+        confidence: a.confidence,
+        evidence: a.evidence,
+      })),
+    };
+  }
+
+  // ─────────────────────────────────────────────────────────────────
+  // Detection Heuristics
+  // ─────────────────────────────────────────────────────────────────
+
+  /**
+   * Detect web extension patterns
+   */
+  private detectWebExtension(files: SourceFile[]): { confidence: number; evidence: string[] } {
+    let confidence = 0;
+    const evidence: string[] = [];
+
+    // Check for manifest.json
+    const hasManifest = files.some((f) => f.getFilePath().includes("manifest.json"));
+    if (hasManifest) {
+      confidence += 30;
+      evidence.push("Found manifest.json");
+    }
+
+    // Check for chrome API imports
+    let chromeApiCount = 0;
+    for (const file of files) {
+      const text = file.getFullText();
+      if (text.includes("chrome.runtime") || text.includes("chrome.tabs")) {
+        chromeApiCount++;
+      }
+    }
+    if (chromeApiCount > 0) {
+      confidence += Math.min(30, chromeApiCount * 10);
+      evidence.push(`Found ${chromeApiCount} file(s) using chrome.* APIs`);
+    }
+
+    // Check for extension directories
+    const hasBackground = files.some((f) => f.getFilePath().includes("/background/"));
+    const hasContent = files.some((f) => f.getFilePath().includes("/content/"));
+    const hasPopup = files.some((f) => f.getFilePath().includes("/popup/"));
+
+    const contextCount = [hasBackground, hasContent, hasPopup].filter(Boolean).length;
+    if (contextCount > 0) {
+      confidence += contextCount * 15;
+      evidence.push(`Found ${contextCount} extension context directories`);
+    }
+
+    // Check for MessageBus usage
+    let messageBusCount = 0;
+    for (const file of files) {
+      const text = file.getFullText();
+      if (text.includes("MessageBus") || text.includes("getMessageBus")) {
+        messageBusCount++;
+      }
+    }
+    if (messageBusCount > 0) {
+      confidence += Math.min(20, messageBusCount * 5);
+      evidence.push(`Found ${messageBusCount} file(s) using MessageBus`);
+    }
+
+    return { confidence: Math.min(100, confidence), evidence };
+  }
+
+  /**
+   * Detect event bus patterns
+   */
+  private detectEventBus(files: SourceFile[]): { confidence: number; evidence: string[] } {
+    let confidence = 0;
+    const evidence: string[] = [];
+
+    // Check for EventEmitter imports
+    let eventEmitterImports = 0;
+    for (const file of files) {
+      const imports = file.getImportDeclarations();
+      for (const imp of imports) {
+        const module = imp.getModuleSpecifierValue();
+        if (module === "events" || module === "eventemitter3" || module === "mitt") {
+          eventEmitterImports++;
+        }
+      }
+    }
+    if (eventEmitterImports > 0) {
+      confidence += Math.min(40, eventEmitterImports * 15);
+      evidence.push(`Found ${eventEmitterImports} EventEmitter import(s)`);
+    }
+
+    // Check for emitter.on() pattern
+    let emitterOnCount = 0;
+    for (const file of files) {
+      const text = file.getFullText();
+      const matches = text.match(/\.on\s*\(\s*['"`]/g);
+      if (matches) {
+        emitterOnCount += matches.length;
+      }
+    }
+    if (emitterOnCount > 0) {
+      confidence += Math.min(30, emitterOnCount * 5);
+      evidence.push(`Found ${emitterOnCount} .on() call(s)`);
+    }
+
+    // Check for emitter.emit() pattern
+    let emitterEmitCount = 0;
+    for (const file of files) {
+      const text = file.getFullText();
+      const matches = text.match(/\.emit\s*\(\s*['"`]/g);
+      if (matches) {
+        emitterEmitCount += matches.length;
+      }
+    }
+    if (emitterEmitCount > 0) {
+      confidence += Math.min(30, emitterEmitCount * 3);
+      evidence.push(`Found ${emitterEmitCount} .emit() call(s)`);
+    }
+
+    // Penalty if chrome APIs are present (likely not pure event bus)
+    let chromeApiCount = 0;
+    for (const file of files) {
+      if (file.getFullText().includes("chrome.runtime")) {
+        chromeApiCount++;
+      }
+    }
+    if (chromeApiCount > 5) {
+      confidence = Math.max(0, confidence - 20);
+      evidence.push("Note: Also found Chrome APIs (might be extension)");
+    }
+
+    return { confidence: Math.min(100, confidence), evidence };
+  }
+
+  /**
+   * Detect web worker patterns
+   */
+  private detectWorker(files: SourceFile[]): { confidence: number; evidence: string[] } {
+    let confidence = 0;
+    const evidence: string[] = [];
+
+    // Check for Worker usage
+    let workerCount = 0;
+    for (const file of files) {
+      const text = file.getFullText();
+      if (text.includes("new Worker(") || text.includes("new SharedWorker(")) {
+        workerCount++;
+      }
+    }
+    if (workerCount > 0) {
+      confidence += Math.min(40, workerCount * 20);
+      evidence.push(`Found ${workerCount} Worker instantiation(s)`);
+    }
+
+    // Check for postMessage usage
+    let postMessageCount = 0;
+    for (const file of files) {
+      const text = file.getFullText();
+      const matches = text.match(/\.postMessage\s*\(/g);
+      if (matches) {
+        postMessageCount += matches.length;
+      }
+    }
+    if (postMessageCount > 0) {
+      confidence += Math.min(30, postMessageCount * 5);
+      evidence.push(`Found ${postMessageCount} .postMessage() call(s)`);
+    }
+
+    // Check for worker directories
+    const hasWorkerDir = files.some(
+      (f) => f.getFilePath().includes("/worker/") || f.getFilePath().includes("/workers/")
+    );
+    if (hasWorkerDir) {
+      confidence += 20;
+      evidence.push("Found worker directory");
+    }
+
+    return { confidence: Math.min(100, confidence), evidence };
+  }
+}
+
+/**
+ * Detect the most appropriate adapter for a project
+ */
+export function detectAdapter(tsConfigPath: string): AdapterDetectionResult {
+  const detector = new AdapterDetector(tsConfigPath);
+  return detector.detect();
+}