@fairfox/polly 0.1.3 → 0.1.4

package/vendor/analysis/src/extract/adr.ts

@@ -1,212 +0,0 @@
-// ADR (Architecture Decision Record) extractor
-// Parses ADRs from markdown files following Michael Nygard's format
-
-import * as fs from "node:fs";
-import * as path from "node:path";
-import type { ADR, ADRStatus, ADRLink, ADRCollection } from "../types/adr";
-
-export class ADRExtractor {
-  private projectRoot: string;
-
-  constructor(projectRoot: string) {
-    this.projectRoot = projectRoot;
-  }
-
-  /**
-   * Extract ADRs from docs/adr directory
-   */
-  extract(): ADRCollection {
-    const adrDir = this.findADRDirectory();
-
-    if (!adrDir || !fs.existsSync(adrDir)) {
-      return {
-        adrs: [],
-        directory: adrDir || path.join(this.projectRoot, "docs", "adr"),
-      };
-    }
-
-    const files = fs
-      .readdirSync(adrDir)
-      .filter((file) => file.endsWith(".md"))
-      .map((file) => path.join(adrDir, file));
-
-    const adrs: ADR[] = [];
-
-    for (const file of files) {
-      try {
-        const adr = this.parseADR(file);
-        if (adr) {
-          adrs.push(adr);
-        }
-      } catch (error) {
-        console.warn(`Failed to parse ADR: ${file}`, error);
-      }
-    }
-
-    // Sort by ID
-    adrs.sort((a, b) => a.id.localeCompare(b.id));
-
-    return {
-      adrs,
-      directory: adrDir,
-    };
-  }
-
-  /**
-   * Find ADR directory
-   */
-  private findADRDirectory(): string | null {
-    const candidates = [
-      path.join(this.projectRoot, "docs", "adr"),
-      path.join(this.projectRoot, "docs", "architecture", "decisions"),
-      path.join(this.projectRoot, "adr"),
-      path.join(this.projectRoot, "architecture", "decisions"),
-    ];
-
-    for (const candidate of candidates) {
-      if (fs.existsSync(candidate)) {
-        return candidate;
-      }
-    }
-
-    return null;
-  }
-
-  /**
-   * Parse ADR from markdown file
-   */
-  private parseADR(filePath: string): ADR | null {
-    const content = fs.readFileSync(filePath, "utf-8");
-    const fileName = path.basename(filePath, ".md");
-
-    // Extract ID from filename (e.g., "0001-use-preact.md" → "0001")
-    const idMatch = fileName.match(/^(\d+)/);
-    const id = idMatch ? idMatch[1] : fileName;
-
-    // Extract title from first heading
-    const titleMatch = content.match(/^#\s+(.+)$/m);
-    const title = titleMatch ? titleMatch[1].trim() : fileName;
-
-    // Extract status
-    const status = this.extractStatus(content);
-
-    // Extract date
-    const date = this.extractDate(content);
-
-    // Extract sections
-    const context = this.extractSection(content, "Context");
-    const decision = this.extractSection(content, "Decision");
-    const consequences = this.extractSection(content, "Consequences");
-
-    // Extract alternatives (if present)
-    const alternativesSection = this.extractSection(content, "Alternatives");
-    const alternatives = alternativesSection
-      ? alternativesSection
-          .split("\n")
-          .filter((line) => line.trim().startsWith("-"))
-          .map((line) => line.replace(/^-\s*/, "").trim())
-      : undefined;
-
-    // Extract links
-    const links = this.extractLinks(content);
-
-    if (!context || !decision || !consequences) {
-      // Not a valid ADR format
-      return null;
-    }
-
-    return {
-      id,
-      title,
-      status,
-      date,
-      context,
-      decision,
-      consequences,
-      alternatives,
-      links,
-      source: filePath,
-    };
-  }
-
-  /**
-   * Extract status from content
-   */
-  private extractStatus(content: string): ADRStatus {
-    const statusMatch = content.match(/Status:\s*(\w+)/i);
-    if (!statusMatch) return "accepted";
-
-    const status = statusMatch[1].toLowerCase();
-    if (["proposed", "accepted", "deprecated", "superseded"].includes(status)) {
-      return status as ADRStatus;
-    }
-
-    return "accepted";
-  }
-
-  /**
-   * Extract date from content
-   */
-  private extractDate(content: string): string {
-    // Try to find date in various formats
-    const dateMatch =
-      content.match(/Date:\s*(\d{4}-\d{2}-\d{2})/i) || content.match(/(\d{4}-\d{2}-\d{2})/i);
-
-    return dateMatch ? dateMatch[1] : new Date().toISOString().split("T")[0];
-  }
-
-  /**
-   * Extract section content
-   */
-  private extractSection(content: string, sectionName: string): string {
-    // Match section heading and capture content until next heading or end
-    const regex = new RegExp(`##\\s+${sectionName}\\s*\\n([\\s\\S]*?)(?=\\n##|$)`, "i");
-    const match = content.match(regex);
-
-    return match ? match[1].trim() : "";
-  }
-
-  /**
-   * Extract links to other ADRs
-   */
-  private extractLinks(content: string): ADRLink[] {
-    const links: ADRLink[] = [];
-
-    // Look for supersedes/superseded-by links
-    const supersedesMatch = content.match(/Supersedes:\s*ADR-(\d+)/gi);
-    if (supersedesMatch) {
-      for (const match of supersedesMatch) {
-        const idMatch = match.match(/ADR-(\d+)/);
-        if (idMatch) {
-          links.push({
-            type: "supersedes",
-            adrId: idMatch[1],
-          });
-        }
-      }
-    }
-
-    const supersededByMatch = content.match(/Superseded by:\s*ADR-(\d+)/gi);
-    if (supersededByMatch) {
-      for (const match of supersededByMatch) {
-        const idMatch = match.match(/ADR-(\d+)/);
-        if (idMatch) {
-          links.push({
-            type: "superseded-by",
-            adrId: idMatch[1],
-          });
-        }
-      }
-    }
-
-    return links;
-  }
-}
-
-/**
- * Extract ADRs from project
- */
-export function extractADRs(projectRoot: string): ADRCollection {
-  const extractor = new ADRExtractor(projectRoot);
-  return extractor.extract();
-}

package/vendor/analysis/src/extract/architecture.ts

@@ -1,160 +0,0 @@
-// Architecture analysis - main orchestrator
-
-import * as fs from "node:fs";
-import * as path from "node:path";
-import type { ArchitectureAnalysis, ContextInfo } from "../types/architecture";
-import { ManifestParser } from "./manifest";
-import { ContextAnalyzer } from "./contexts";
-import { FlowAnalyzer } from "./flows";
-import { IntegrationAnalyzer } from "./integrations";
-import { HandlerExtractor } from "./handlers";
-import { extractADRs } from "./adr";
-
-export interface ArchitectureAnalysisOptions {
-  /** Path to tsconfig.json */
-  tsConfigPath: string;
-
-  /** Project root directory (where manifest.json is) */
-  projectRoot: string;
-
-  /** Optional: Override detected contexts */
-  contexts?: string[];
-}
-
-/**
- * Comprehensive architecture analyzer
- */
-export class ArchitectureAnalyzer {
-  private options: ArchitectureAnalysisOptions;
-
-  constructor(options: ArchitectureAnalysisOptions) {
-    this.options = options;
-  }
-
-  /**
-   * Perform complete architecture analysis
-   */
-  async analyze(): Promise<ArchitectureAnalysis> {
-    // 1. Parse manifest.json
-    const manifestParser = new ManifestParser(this.options.projectRoot);
-    const manifest = manifestParser.parse();
-    const entryPoints = manifestParser.getContextEntryPoints();
-
-    // 2. Extract message handlers
-    const handlerExtractor = new HandlerExtractor(this.options.tsConfigPath);
-    const { handlers } = handlerExtractor.extractHandlers();
-
-    // 3. Analyze each context
-    const contextAnalyzer = new ContextAnalyzer(this.options.tsConfigPath);
-    const contexts: Record<string, ContextInfo> = {};
-
-    for (const [contextType, entryPoint] of Object.entries(entryPoints)) {
-      try {
-        const contextInfo = contextAnalyzer.analyzeContext(contextType, entryPoint, handlers);
-        contexts[contextType] = contextInfo;
-      } catch (error) {
-        console.warn(`Failed to analyze context ${contextType}: ${error}`);
-      }
-    }
-
-    // 4. Analyze message flows
-    const flowAnalyzer = new FlowAnalyzer(this.options.tsConfigPath, handlers);
-    const messageFlows = flowAnalyzer.analyzeFlows();
-
-    // 5. Analyze external integrations
-    const integrationAnalyzer = new IntegrationAnalyzer(this.options.tsConfigPath);
-    const integrations = integrationAnalyzer.analyzeIntegrations();
-
-    // 6. Merge external API calls into context info
-    this.mergeExternalAPIsIntoContexts(contexts, integrations);
-
-    // 7. Extract ADRs (Architecture Decision Records)
-    const adrs = extractADRs(this.options.projectRoot);
-
-    // 8. Extract repository info
-    const repository = this.extractRepositoryInfo();
-
-    return {
-      system: {
-        name: manifest.name,
-        version: manifest.version,
-        description: manifest.description,
-      },
-      manifest,
-      contexts,
-      messageFlows,
-      integrations,
-      adrs: adrs.adrs.length > 0 ? adrs : undefined,
-      repository,
-    };
-  }
-
-  /**
-   * Merge external API calls into their respective contexts
-   */
-  private mergeExternalAPIsIntoContexts(
-    contexts: Record<string, ContextInfo>,
-    integrations: ExternalIntegration[]
-  ): void {
-    for (const integration of integrations) {
-      if (integration.calls) {
-        for (const call of integration.calls) {
-          // Find which context this call belongs to
-          for (const [contextType, contextInfo] of Object.entries(contexts)) {
-            if (call.location.file.includes(`/${contextType}/`)) {
-              contextInfo.externalAPIs.push(call);
-              break;
-            }
-          }
-        }
-      }
-    }
-  }
-
-  /**
-   * Extract repository information from package.json
-   */
-  private extractRepositoryInfo(): ArchitectureAnalysis["repository"] {
-    const packageJsonPath = path.join(this.options.projectRoot, "package.json");
-
-    if (!fs.existsSync(packageJsonPath)) {
-      return undefined;
-    }
-
-    try {
-      const content = fs.readFileSync(packageJsonPath, "utf-8");
-      const packageJson = JSON.parse(content);
-
-      if (packageJson.repository) {
-        if (typeof packageJson.repository === "string") {
-          return {
-            url: packageJson.repository,
-            type: "git",
-          };
-        }
-
-        return {
-          url: packageJson.repository.url || packageJson.repository,
-          type: packageJson.repository.type || "git",
-        };
-      }
-    } catch (error) {
-      console.warn(`Failed to parse package.json: ${error}`);
-    }
-
-    return undefined;
-  }
-}
-
-/**
- * Convenience function to analyze architecture
- */
-export async function analyzeArchitecture(
-  options: ArchitectureAnalysisOptions
-): Promise<ArchitectureAnalysis> {
-  const analyzer = new ArchitectureAnalyzer(options);
-  return analyzer.analyze();
-}
-
-// Fix: Import ExternalIntegration type
-import type { ExternalIntegration } from "../types/architecture";

package/vendor/analysis/src/extract/contexts.ts

@@ -1,298 +0,0 @@
-// Context analysis - analyze individual execution contexts
-
-import { Project, Node, SyntaxKind } from "ts-morph";
-import type { ContextInfo, ComponentInfo } from "../types/architecture";
-import type { MessageHandler } from "../types/core";
-
-export class ContextAnalyzer {
-  private project: Project;
-
-  constructor(tsConfigPath: string) {
-    this.project = new Project({
-      tsConfigFilePath: tsConfigPath,
-    });
-  }
-
-  /**
-   * Analyze a specific context given its entry point
-   */
-  analyzeContext(contextType: string, entryPoint: string, handlers: MessageHandler[]): ContextInfo {
-    const sourceFile = this.project.getSourceFile(entryPoint);
-
-    if (!sourceFile) {
-      throw new Error(`Could not find source file: ${entryPoint}`);
-    }
-
-    // Extract Chrome API usage
-    const chromeAPIs = this.extractChromeAPIs(sourceFile);
-
-    // Extract dependencies
-    const dependencies = this.extractDependencies(sourceFile);
-
-    // Extract JSDoc description
-    const description = this.extractDescription(sourceFile);
-
-    // Extract components (for UI contexts)
-    const components = this.isUIContext(contextType)
-      ? this.extractComponents(sourceFile)
-      : undefined;
-
-    // Filter handlers for this context
-    const contextHandlers = handlers.filter((h) => h.node === contextType);
-
-    return {
-      type: contextType,
-      entryPoint,
-      handlers: contextHandlers,
-      chromeAPIs,
-      externalAPIs: [], // Will be filled by integration analyzer
-      components,
-      dependencies,
-      description,
-    };
-  }
-
-  /**
-   * Extract Chrome API usage from source file
-   */
-  private extractChromeAPIs(sourceFile: any): string[] {
-    const apis = new Set<string>();
-
-    sourceFile.forEachDescendant((node: any) => {
-      if (Node.isPropertyAccessExpression(node)) {
-        const text = node.getText();
-
-        // Match chrome.* API calls
-        if (text.startsWith("chrome.")) {
-          // Extract API namespace (e.g., "chrome.tabs", "chrome.storage.local")
-          const match = text.match(/^chrome\.([^.(]+(?:\.[^.(]+)?)/);
-          if (match) {
-            apis.add(match[1]);
-          }
-        }
-
-        // Also match browser.* for Firefox compatibility
-        if (text.startsWith("browser.")) {
-          const match = text.match(/^browser\.([^.(]+(?:\.[^.(]+)?)/);
-          if (match) {
-            apis.add(match[1]);
-          }
-        }
-
-        // Match bus.adapters.* pattern (framework abstraction over Chrome APIs)
-        // e.g., bus.adapters.storage.get() -> storage
-        //       bus.adapters.tabs.query() -> tabs
-        if (text.includes("bus.adapters.")) {
-          const match = text.match(/bus\.adapters\.([^.(]+)/);
-          if (match) {
-            apis.add(match[1]);
-          }
-        }
-      }
-    });
-
-    return Array.from(apis).sort();
-  }
-
-  /**
-   * Extract import dependencies
-   */
-  private extractDependencies(sourceFile: any): string[] {
-    const deps: string[] = [];
-
-    for (const importDecl of sourceFile.getImportDeclarations()) {
-      const moduleSpecifier = importDecl.getModuleSpecifierValue();
-      deps.push(moduleSpecifier);
-    }
-
-    return deps;
-  }
-
-  /**
-   * Extract JSDoc description from file
-   */
-  private extractDescription(sourceFile: any): string | undefined {
-    // Look for file-level JSDoc comment
-    const firstStatement = sourceFile.getStatements()[0];
-    if (!firstStatement) return undefined;
-
-    const leadingComments = firstStatement.getLeadingCommentRanges();
-    if (leadingComments.length === 0) return undefined;
-
-    const comment = leadingComments[0].getText();
-
-    // Extract description from JSDoc
-    const descMatch = comment.match(/@description\s+(.+?)(?:\n|$)/s);
-    if (descMatch) {
-      return descMatch[1].trim();
-    }
-
-    // Or just take the first line of the comment
-    const lines = comment
-      .split("\n")
-      .map((l: string) => l.replace(/^[\s*]+/, "").trim())
-      .filter((l: string) => l && !l.startsWith("@"));
-
-    return lines[0] || undefined;
-  }
-
-  /**
-   * Extract React/Preact components from source file
-   */
-  private extractComponents(sourceFile: any): ComponentInfo[] {
-    const components: ComponentInfo[] = [];
-
-    sourceFile.forEachDescendant((node: any) => {
-      // Function components
-      if (Node.isFunctionDeclaration(node)) {
-        const name = node.getName();
-        if (name && this.looksLikeComponent(name, node)) {
-          components.push({
-            name,
-            type: "function",
-            filePath: sourceFile.getFilePath(),
-            line: node.getStartLineNumber(),
-            props: this.extractProps(node),
-            description: this.extractJSDocDescription(node),
-          });
-        }
-      }
-
-      // Arrow function components (const Foo = () => ...)
-      if (Node.isVariableDeclaration(node)) {
-        const name = node.getName();
-        const initializer = node.getInitializer();
-
-        if (
-          name &&
-          initializer &&
-          (Node.isArrowFunction(initializer) || Node.isFunctionExpression(initializer))
-        ) {
-          if (this.looksLikeComponent(name, initializer)) {
-            components.push({
-              name,
-              type: "function",
-              filePath: sourceFile.getFilePath(),
-              line: node.getStartLineNumber(),
-              props: this.extractProps(initializer),
-              description: this.extractJSDocDescription(node),
-            });
-          }
-        }
-      }
-
-      // Class components
-      if (Node.isClassDeclaration(node)) {
-        const name = node.getName();
-        if (name && this.looksLikeClassComponent(node)) {
-          components.push({
-            name,
-            type: "class",
-            filePath: sourceFile.getFilePath(),
-            line: node.getStartLineNumber(),
-            props: this.extractPropsFromClass(node),
-            description: this.extractJSDocDescription(node),
-          });
-        }
-      }
-    });
-
-    return components;
-  }
-
-  /**
-   * Check if a function looks like a React/Preact component
-   */
-  private looksLikeComponent(name: string, node: any): boolean {
-    // Component names should start with uppercase
-    if (!/^[A-Z]/.test(name)) return false;
-
-    // Check if it returns JSX
-    const body = node.getBody();
-    if (!body) return false;
-
-    let hasJSX = false;
-
-    if (Node.isBlock(body)) {
-      body.forEachDescendant((child: any) => {
-        if (Node.isJsxElement(child) || Node.isJsxSelfClosingElement(child)) {
-          hasJSX = true;
-        }
-      });
-    } else {
-      // Arrow function with implicit return
-      if (Node.isJsxElement(body) || Node.isJsxSelfClosingElement(body)) {
-        hasJSX = true;
-      }
-    }
-
-    return hasJSX;
-  }
-
-  /**
-   * Check if a class looks like a React component
-   */
-  private looksLikeClassComponent(node: any): boolean {
-    const extendedTypes = node.getExtends();
-    if (!extendedTypes) return false;
-
-    const extendsText = extendedTypes.getText();
-    return /Component|PureComponent/.test(extendsText);
-  }
-
-  /**
-   * Extract props from function component
-   */
-  private extractProps(node: any): string[] {
-    const params = node.getParameters();
-    if (params.length === 0) return [];
-
-    const propsParam = params[0];
-    const type = propsParam.getType();
-
-    const props: string[] = [];
-    for (const prop of type.getProperties()) {
-      props.push(prop.getName());
-    }
-
-    return props;
-  }
-
-  /**
-   * Extract props from class component
-   */
-  private extractPropsFromClass(node: any): string[] {
-    const extendedTypes = node.getExtends();
-    if (!extendedTypes) return [];
-
-    const typeArgs = extendedTypes.getType().getTypeArguments();
-    if (typeArgs.length === 0) return [];
-
-    const propsType = typeArgs[0];
-    const props: string[] = [];
-
-    for (const prop of propsType.getProperties()) {
-      props.push(prop.getName());
-    }
-
-    return props;
-  }
-
-  /**
-   * Extract JSDoc description from node
-   */
-  private extractJSDocDescription(node: any): string | undefined {
-    const jsDocs = node.getJsDocs();
-    if (jsDocs.length === 0) return undefined;
-
-    const description = jsDocs[0].getDescription().trim();
-    return description || undefined;
-  }
-
-  /**
-   * Check if context is a UI context
-   */
-  private isUIContext(contextType: string): boolean {
-    return ["popup", "options", "devtools"].includes(contextType);
-  }
-}