The Open-Source Lighthouse for the Agentic Web

import { runScan } from '@forkpoint/agent-lighthouse-core';
import { generateHtmlReport, generateMarkdownSummary } from '@forkpoint/agent-lighthouse-report';
import { writeFileSync } from 'node:fs';

// 1. Run live scan
const report = await runScan('https://yourstore.com', {
  onEvent: (event) => {
    if (event.type === 'phase:done') {
      console.log(`[${Math.round(event.fraction * 100)}%] ${event.phase} done`);
    }
  },
});

console.log(`Overall Readiness Score: ${report.overallScore}/100 (${report.scoreTier})`);

// 2. Generate standalone Lighthouse HTML report
const html = generateHtmlReport(report);
writeFileSync('./reports/agent-report.html', html);

// 3. Generate Markdown summary for PR comments
const markdown = generateMarkdownSummary(report);
console.log(markdown);

name: Agent Lighthouse Audit

on:
  pull_request:
    branches: [main]

jobs:
  audit:
    runs-on: ubuntu-latest
    steps:
      - name: Checkout repository
        uses: actions/checkout@v4

      - name: Run Agent Lighthouse Audit
        run: |
          npx @forkpoint/agent-lighthouse https://staging.yourstore.com \
            --preset ecommerce \
            --min-score 80 \
            --output terminal,html,json,md \
            --output-dir ./reports

      - name: Upload HTML Report Artifact
        uses: actions/upload-artifact@v4
        with:
          name: agent-lighthouse-report
          path: ./reports/agent-lighthouse-report.html