@avi770/testteam 1.2.0 → 3.0.0

package/agents/46-seo-auditor.ts

@@ -0,0 +1,294 @@
+import type { Browser, Page } from 'playwright';
+import type { Finding } from '../core/types';
+import { BaseAgent } from './base-agent';
+import { resolveEnvironment } from '../helpers/env-resolver';
+import { login } from '../helpers/navigation';
+
+const NAV_TIMEOUT_MS = 5_000;
+
+export class SeoAuditorAgent extends BaseAgent {
+  readonly agentId = 46;
+  readonly agentName = 'SEO Auditor';
+  private baseUrl = '';
+
+  protected async preFlight(): Promise<void> {
+    if (!this.config.modules || this.config.modules.length === 0) {
+      throw new Error('SeoAuditorAgent requires at least one module in config.modules');
+    }
+    const { env } = await resolveEnvironment(this.config, this.phase);
+    this.baseUrl = env.baseUrl;
+  }
+
+  protected async execute(): Promise<Finding[]> {
+    const findings: Finding[] = [];
+    const rawLoginUrl = this.config.auth.loginUrl ?? '/login';
+    const loginUrl = rawLoginUrl.startsWith('http') ? rawLoginUrl : `${this.baseUrl}${rawLoginUrl}`;
+    const credentials =
+      this.config.auth.credentials?.['admin'] ??
+      Object.values(this.config.auth.credentials ?? {})[0];
+
+    const { chromium } = await import('playwright');
+    let browser: Browser | null = null;
+
+    try {
+      browser = await chromium.launch({ headless: true });
+      const page = await browser.newPage();
+
+      if (credentials) {
+        try {
+          await login(page, credentials, loginUrl);
+        } catch (loginError) {
+          findings.push({
+            id: `${this.agentId}-login-failed`,
+            type: 'infra-issue',
+            severity: 'medium',
+            agentId: this.agentId,
+            module: 'seo-auditor',
+            description: `Login failed — continuing anonymously: ${loginError instanceof Error ? loginError.message.split('\n')[0] : String(loginError)}`,
+          });
+        }
+      }
+
+      for (const mod of this.config.modules) {
+        const moduleFindings = await this.auditModule(page, mod.id, mod.route);
+        findings.push(...moduleFindings);
+      }
+
+      // Check robots.txt and sitemap.xml
+      const robotsFindings = await this.checkRobotsAndSitemap();
+      findings.push(...robotsFindings);
+
+      await page.close().catch(() => undefined);
+    } catch (playwrightError) {
+      findings.push({
+        id: `${this.agentId}-playwright-failure`,
+        type: 'infra-issue',
+        severity: 'medium',
+        agentId: this.agentId,
+        module: 'seo-auditor',
+        description: `Playwright execution failed: ${playwrightError instanceof Error ? playwrightError.message.split('\n')[0] : String(playwrightError)}`,
+      });
+    } finally {
+      if (browser) await browser.close().catch(() => undefined);
+    }
+
+    return findings;
+  }
+
+  private async auditModule(
+    page: Page,
+    moduleId: string,
+    moduleRoute: string,
+  ): Promise<Finding[]> {
+    const findings: Finding[] = [];
+    const fullUrl = moduleRoute.startsWith('http')
+      ? moduleRoute
+      : `${this.baseUrl}${moduleRoute}`;
+
+    try {
+      await Promise.race([
+        page.goto(fullUrl, { waitUntil: 'domcontentloaded' }),
+        new Promise((_, reject) =>
+          setTimeout(() => reject(new Error('Navigation timeout')), NAV_TIMEOUT_MS),
+        ),
+      ]);
+    } catch {
+      findings.push({
+        id: `${this.agentId}-nav-failed-${moduleId}`,
+        type: 'test-bug',
+        severity: 'medium',
+        agentId: this.agentId,
+        module: moduleId,
+        description: `Failed to navigate to module ${moduleId} at ${moduleRoute}`,
+      });
+      return findings;
+    }
+
+    // Check <title>
+    try {
+      const title = await page.evaluate(() => document.title);
+      if (!title || title.trim() === '') {
+        findings.push({
+          id: `${this.agentId}-no-title-${moduleId}`,
+          type: 'test-bug',
+          severity: 'medium',
+          agentId: this.agentId,
+          module: moduleId,
+          description: `Module ${moduleId} has no <title> tag`,
+        });
+      } else if (title.length > 60) {
+        findings.push({
+          id: `${this.agentId}-long-title-${moduleId}`,
+          type: 'test-bug',
+          severity: 'low',
+          agentId: this.agentId,
+          module: moduleId,
+          description: `Module ${moduleId} title is ${title.length} chars (recommended <60)`,
+        });
+      }
+    } catch {
+      // Could not evaluate title
+    }
+
+    // Check <meta name="description">
+    try {
+      const metaDesc = await page.evaluate(() => {
+        const el = document.querySelector('meta[name="description"]');
+        return el?.getAttribute('content') ?? null;
+      });
+      if (!metaDesc) {
+        findings.push({
+          id: `${this.agentId}-no-meta-desc-${moduleId}`,
+          type: 'test-bug',
+          severity: 'medium',
+          agentId: this.agentId,
+          module: moduleId,
+          description: `Module ${moduleId} has no <meta name="description">`,
+        });
+      } else if (metaDesc.length > 160) {
+        findings.push({
+          id: `${this.agentId}-long-meta-desc-${moduleId}`,
+          type: 'test-bug',
+          severity: 'low',
+          agentId: this.agentId,
+          module: moduleId,
+          description: `Module ${moduleId} meta description is ${metaDesc.length} chars (recommended <160)`,
+        });
+      }
+    } catch {
+      // Could not evaluate meta description
+    }
+
+    // Check <link rel="canonical">
+    try {
+      const canonical = await page.evaluate(() => {
+        const el = document.querySelector('link[rel="canonical"]');
+        return el?.getAttribute('href') ?? null;
+      });
+      if (!canonical) {
+        findings.push({
+          id: `${this.agentId}-no-canonical-${moduleId}`,
+          type: 'test-bug',
+          severity: 'low',
+          agentId: this.agentId,
+          module: moduleId,
+          description: `Module ${moduleId} has no <link rel="canonical">`,
+        });
+      }
+    } catch {
+      // Could not evaluate canonical
+    }
+
+    // Check <h1> — exactly one
+    try {
+      const h1Count = await Promise.race([
+        page.locator('h1').count(),
+        new Promise<number>((_, reject) =>
+          setTimeout(() => reject(new Error('Timeout')), NAV_TIMEOUT_MS),
+        ),
+      ]) as number;
+
+      if (h1Count === 0) {
+        findings.push({
+          id: `${this.agentId}-no-h1-${moduleId}`,
+          type: 'test-bug',
+          severity: 'medium',
+          agentId: this.agentId,
+          module: moduleId,
+          description: `Module ${moduleId} has no <h1> tag`,
+        });
+      } else if (h1Count > 1) {
+        findings.push({
+          id: `${this.agentId}-multiple-h1-${moduleId}`,
+          type: 'test-bug',
+          severity: 'medium',
+          agentId: this.agentId,
+          module: moduleId,
+          description: `Module ${moduleId} has ${h1Count} <h1> tags (should have exactly 1)`,
+        });
+      }
+    } catch {
+      // Could not count h1 tags
+    }
+
+    // Check og: tags
+    try {
+      const ogTitle = await page.evaluate(() => {
+        const el = document.querySelector('meta[property="og:title"]');
+        return el?.getAttribute('content') ?? null;
+      });
+      if (!ogTitle) {
+        findings.push({
+          id: `${this.agentId}-no-og-title-${moduleId}`,
+          type: 'test-bug',
+          severity: 'low',
+          agentId: this.agentId,
+          module: moduleId,
+          description: `Module ${moduleId} has no og:title meta tag`,
+        });
+      }
+    } catch {
+      // Could not evaluate og tags
+    }
+
+    return findings;
+  }
+
+  private async checkRobotsAndSitemap(): Promise<Finding[]> {
+    const findings: Finding[] = [];
+
+    // Check robots.txt
+    try {
+      const response = await fetch(`${this.baseUrl}/robots.txt`, {
+        signal: AbortSignal.timeout(NAV_TIMEOUT_MS),
+      });
+      if (response.status !== 200) {
+        findings.push({
+          id: `${this.agentId}-no-robots-txt`,
+          type: 'test-bug',
+          severity: 'medium',
+          agentId: this.agentId,
+          module: 'seo-auditor',
+          description: `robots.txt not found (status ${response.status})`,
+        });
+      }
+    } catch {
+      findings.push({
+        id: `${this.agentId}-robots-txt-error`,
+        type: 'infra-issue',
+        severity: 'low',
+        agentId: this.agentId,
+        module: 'seo-auditor',
+        description: 'Failed to fetch robots.txt',
+      });
+    }
+
+    // Check sitemap.xml
+    try {
+      const response = await fetch(`${this.baseUrl}/sitemap.xml`, {
+        signal: AbortSignal.timeout(NAV_TIMEOUT_MS),
+      });
+      if (response.status !== 200) {
+        findings.push({
+          id: `${this.agentId}-no-sitemap-xml`,
+          type: 'test-bug',
+          severity: 'medium',
+          agentId: this.agentId,
+          module: 'seo-auditor',
+          description: `sitemap.xml not found (status ${response.status})`,
+        });
+      }
+    } catch {
+      findings.push({
+        id: `${this.agentId}-sitemap-xml-error`,
+        type: 'infra-issue',
+        severity: 'low',
+        agentId: this.agentId,
+        module: 'seo-auditor',
+        description: 'Failed to fetch sitemap.xml',
+      });
+    }
+
+    return findings;
+  }
+}

package/agents/47-social-preview-tester.ts

@@ -0,0 +1,232 @@
+import type { Browser, Page } from 'playwright';
+import type { Finding } from '../core/types';
+import { BaseAgent } from './base-agent';
+import { resolveEnvironment } from '../helpers/env-resolver';
+import { login } from '../helpers/navigation';
+
+const NAV_TIMEOUT_MS = 5_000;
+
+export class SocialPreviewTesterAgent extends BaseAgent {
+  readonly agentId = 47;
+  readonly agentName = 'Social Preview Tester';
+  private baseUrl = '';
+
+  protected async preFlight(): Promise<void> {
+    if (!this.config.modules || this.config.modules.length === 0) {
+      throw new Error('SocialPreviewTesterAgent requires at least one module in config.modules');
+    }
+    const { env } = await resolveEnvironment(this.config, this.phase);
+    this.baseUrl = env.baseUrl;
+  }
+
+  protected async execute(): Promise<Finding[]> {
+    const findings: Finding[] = [];
+    const rawLoginUrl = this.config.auth.loginUrl ?? '/login';
+    const loginUrl = rawLoginUrl.startsWith('http') ? rawLoginUrl : `${this.baseUrl}${rawLoginUrl}`;
+    const credentials =
+      this.config.auth.credentials?.['admin'] ??
+      Object.values(this.config.auth.credentials ?? {})[0];
+
+    const { chromium } = await import('playwright');
+    let browser: Browser | null = null;
+
+    try {
+      browser = await chromium.launch({ headless: true });
+      const page = await browser.newPage();
+
+      if (credentials) {
+        try {
+          await login(page, credentials, loginUrl);
+        } catch (loginError) {
+          findings.push({
+            id: `${this.agentId}-login-failed`,
+            type: 'infra-issue',
+            severity: 'medium',
+            agentId: this.agentId,
+            module: 'social-preview',
+            description: `Login failed — continuing anonymously: ${loginError instanceof Error ? loginError.message.split('\n')[0] : String(loginError)}`,
+          });
+        }
+      }
+
+      for (const mod of this.config.modules) {
+        const moduleFindings = await this.testModulePreview(page, mod.id, mod.route);
+        findings.push(...moduleFindings);
+      }
+
+      await page.close().catch(() => undefined);
+    } catch (playwrightError) {
+      findings.push({
+        id: `${this.agentId}-playwright-failure`,
+        type: 'infra-issue',
+        severity: 'medium',
+        agentId: this.agentId,
+        module: 'social-preview',
+        description: `Playwright execution failed: ${playwrightError instanceof Error ? playwrightError.message.split('\n')[0] : String(playwrightError)}`,
+      });
+    } finally {
+      if (browser) await browser.close().catch(() => undefined);
+    }
+
+    return findings;
+  }
+
+  private async testModulePreview(
+    page: Page,
+    moduleId: string,
+    moduleRoute: string,
+  ): Promise<Finding[]> {
+    const findings: Finding[] = [];
+    const fullUrl = moduleRoute.startsWith('http')
+      ? moduleRoute
+      : `${this.baseUrl}${moduleRoute}`;
+
+    try {
+      await Promise.race([
+        page.goto(fullUrl, { waitUntil: 'domcontentloaded' }),
+        new Promise((_, reject) =>
+          setTimeout(() => reject(new Error('Navigation timeout')), NAV_TIMEOUT_MS),
+        ),
+      ]);
+    } catch {
+      findings.push({
+        id: `${this.agentId}-nav-failed-${moduleId}`,
+        type: 'test-bug',
+        severity: 'medium',
+        agentId: this.agentId,
+        module: moduleId,
+        description: `Failed to navigate to module ${moduleId} at ${moduleRoute}`,
+      });
+      return findings;
+    }
+
+    // Check og:image
+    try {
+      const ogImage = await page.evaluate(() => {
+        const el = document.querySelector('meta[property="og:image"]');
+        return el?.getAttribute('content') ?? null;
+      });
+
+      if (!ogImage) {
+        findings.push({
+          id: `${this.agentId}-no-og-image-${moduleId}`,
+          type: 'test-bug',
+          severity: 'medium',
+          agentId: this.agentId,
+          module: moduleId,
+          description: `Module ${moduleId} has no og:image meta tag`,
+        });
+      } else {
+        // Verify image URL returns 200
+        try {
+          const imageUrl = ogImage.startsWith('http') ? ogImage : `${this.baseUrl}${ogImage}`;
+          const response = await fetch(imageUrl, {
+            method: 'HEAD',
+            signal: AbortSignal.timeout(NAV_TIMEOUT_MS),
+          });
+          if (response.status !== 200) {
+            findings.push({
+              id: `${this.agentId}-og-image-broken-${moduleId}`,
+              type: 'test-bug',
+              severity: 'medium',
+              agentId: this.agentId,
+              module: moduleId,
+              description: `og:image URL returns ${response.status} for module ${moduleId}`,
+            });
+          }
+        } catch {
+          findings.push({
+            id: `${this.agentId}-og-image-unreachable-${moduleId}`,
+            type: 'test-bug',
+            severity: 'medium',
+            agentId: this.agentId,
+            module: moduleId,
+            description: `og:image URL is unreachable for module ${moduleId}`,
+          });
+        }
+      }
+    } catch {
+      // Could not evaluate og:image
+    }
+
+    // Check og:title
+    try {
+      const ogTitle = await page.evaluate(() => {
+        const el = document.querySelector('meta[property="og:title"]');
+        return el?.getAttribute('content') ?? null;
+      });
+      if (!ogTitle) {
+        findings.push({
+          id: `${this.agentId}-no-og-title-${moduleId}`,
+          type: 'test-bug',
+          severity: 'medium',
+          agentId: this.agentId,
+          module: moduleId,
+          description: `Module ${moduleId} has no og:title meta tag`,
+        });
+      } else if (ogTitle.length > 60) {
+        findings.push({
+          id: `${this.agentId}-long-og-title-${moduleId}`,
+          type: 'test-bug',
+          severity: 'low',
+          agentId: this.agentId,
+          module: moduleId,
+          description: `Module ${moduleId} og:title is ${ogTitle.length} chars (recommended <60)`,
+        });
+      }
+    } catch {
+      // Could not evaluate og:title
+    }
+
+    // Check og:description
+    try {
+      const ogDesc = await page.evaluate(() => {
+        const el = document.querySelector('meta[property="og:description"]');
+        return el?.getAttribute('content') ?? null;
+      });
+      if (!ogDesc) {
+        findings.push({
+          id: `${this.agentId}-no-og-desc-${moduleId}`,
+          type: 'test-bug',
+          severity: 'low',
+          agentId: this.agentId,
+          module: moduleId,
+          description: `Module ${moduleId} has no og:description meta tag`,
+        });
+      } else if (ogDesc.length > 160) {
+        findings.push({
+          id: `${this.agentId}-long-og-desc-${moduleId}`,
+          type: 'test-bug',
+          severity: 'low',
+          agentId: this.agentId,
+          module: moduleId,
+          description: `Module ${moduleId} og:description is ${ogDesc.length} chars (recommended <160)`,
+        });
+      }
+    } catch {
+      // Could not evaluate og:description
+    }
+
+    // Check twitter:card
+    try {
+      const twitterCard = await page.evaluate(() => {
+        const el = document.querySelector('meta[name="twitter:card"]');
+        return el?.getAttribute('content') ?? null;
+      });
+      if (!twitterCard) {
+        findings.push({
+          id: `${this.agentId}-no-twitter-card-${moduleId}`,
+          type: 'test-bug',
+          severity: 'low',
+          agentId: this.agentId,
+          module: moduleId,
+          description: `Module ${moduleId} has no twitter:card meta tag`,
+        });
+      }
+    } catch {
+      // Could not evaluate twitter:card
+    }
+
+    return findings;
+  }
+}