lhci-ai-assistant 0.1.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2024
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -0,0 +1,228 @@
+# LHCI AI Assistant
+
+AI-powered companion tool for [Lighthouse CI](https://github.com/GoogleChrome/lighthouse-ci) that analyzes performance regressions, explains root causes, and suggests fixes.
+
+## Features
+
+- **AI-Powered Analysis**: Uses GitHub Copilot, OpenAI, or local heuristics to analyze Lighthouse results
+- **Regression Detection**: Automatically identifies performance regressions by comparing against baselines
+- **Root Cause Analysis**: Explains why performance degraded based on code changes and Lighthouse audits
+- **Auto-Fix Suggestions**: Generates specific code fixes for common performance issues
+- **GitHub Integration**: Posts analysis as PR comments and fetches code diffs for context
+- **Multiple Output Formats**: Terminal (colored), JSON, Markdown
+
+## Installation
+
+```bash
+npm install -g lhci-ai-assistant
+# or
+pnpm add -g lhci-ai-assistant
+```
+
+## Quick Start
+
+1. Run Lighthouse CI to collect reports:
+
+```bash
+lhci collect --url https://your-site.com
+```
+
+2. Analyze with AI:
+
+```bash
+# Using local heuristics (no API key required)
+lhci-ai analyze
+
+# Using GitHub Copilot (requires gh auth login or GITHUB_TOKEN)
+gh auth login  # One-time setup
+lhci-ai analyze --provider copilot
+
+# Using OpenAI
+lhci-ai analyze --provider openai --openai-key $OPENAI_API_KEY
+```
+
+## Commands
+
+### `lhci-ai analyze`
+
+Analyze Lighthouse results with AI assistance.
+
+```bash
+lhci-ai analyze [options]
+
+Options:
+  --provider <name>      AI provider: copilot | openai | local (default: local)
+  --github-token <token> GitHub token for Copilot/PR access
+  --openai-key <key>     OpenAI API key
+  --auto-fix             Generate auto-fix suggestions
+  --post-comment         Post analysis to GitHub PR
+  --pr-number <number>   PR number for posting comments
+  --repo <repo>          GitHub repository (owner/repo)
+  --output <format>      Output format: terminal | json | markdown (default: terminal)
+  --config <path>        Config file path
+```
+
+### `lhci-ai check`
+
+Quick threshold check for CI/CD gates.
+
+```bash
+lhci-ai check [options]
+
+Options:
+  --performance <score>     Minimum performance score (0-100)
+  --accessibility <score>   Minimum accessibility score (0-100)
+  --best-practices <score>  Minimum best practices score (0-100)
+  --seo <score>             Minimum SEO score (0-100)
+```
+
+Example:
+
+```bash
+# Fail if performance drops below 90%
+lhci-ai check --performance 90
+```
+
+### `lhci-ai init`
+
+Display configuration setup instructions.
+
+## Configuration
+
+Create a `.lhci-ai.js` or add to your existing `.lhcirc.js`:
+
+```javascript
+module.exports = {
+  ai: {
+    provider: 'local',        // 'copilot' | 'openai' | 'local'
+    autoFix: true,
+    outputFormat: 'terminal',
+  },
+  thresholds: {
+    performance: 0.9,
+    accessibility: 0.9,
+    bestPractices: 0.9,
+    seo: 0.9,
+  },
+};
+```
+
+### Environment Variables
+
+- `GITHUB_TOKEN` - GitHub token for PR comments (Copilot uses GitHub CLI auth)
+- `OPENAI_API_KEY` - OpenAI API key
+
+### Copilot Authentication
+
+The Copilot provider uses the official [GitHub Copilot SDK](https://github.com/github/copilot-sdk) which authenticates via:
+
+1. **GitHub CLI** (recommended): Run `gh auth login` once
+2. **Environment variable**: Set `GITHUB_TOKEN` with a token that has Copilot access
+
+## CI/CD Integration
+
+### GitHub Actions
+
+```yaml
+name: Lighthouse CI
+
+on: [push, pull_request]
+
+jobs:
+  lighthouse:
+    runs-on: ubuntu-latest
+    steps:
+      - uses: actions/checkout@v4
+
+      - name: Setup Node
+        uses: actions/setup-node@v4
+        with:
+          node-version: '20'
+
+      - name: Install dependencies
+        run: npm ci
+
+      - name: Build
+        run: npm run build
+
+      - name: Run Lighthouse CI
+        run: |
+          npm install -g @lhci/cli lhci-ai-assistant
+          lhci collect --url http://localhost:3000
+          lhci-ai analyze --provider copilot --post-comment
+        env:
+          GITHUB_TOKEN: ${{ secrets.GITHUB_TOKEN }}
+```
+
+## Programmatic API
+
+```typescript
+import { analyze, quickCheck, loadLighthouseReports } from 'lhci-ai-assistant';
+
+// Run full analysis
+const result = await analyze({
+  provider: 'local',
+  output: 'json',
+  autoFix: true,
+});
+
+console.log(result.summary);
+console.log(result.regressions);
+console.log(result.recommendations);
+
+// Quick threshold check
+const check = await quickCheck({
+  performance: 0.9,
+  accessibility: 0.9,
+});
+
+if (!check.passed) {
+  console.log('Threshold failures:', check.failures);
+  process.exit(1);
+}
+```
+
+## How It Works
+
+1. **Load Reports**: Reads Lighthouse JSON reports from `.lighthouseci/` directory
+2. **Extract Metrics**: Parses Core Web Vitals (FCP, LCP, TBT, CLS) and category scores
+3. **Compare**: Identifies regressions and improvements vs baseline
+4. **Fetch Context**: Retrieves code changes from GitHub PR diff
+5. **Analyze**: Uses AI or heuristics to identify root causes
+6. **Recommend**: Generates prioritized, actionable recommendations
+7. **Output**: Formats results for terminal, JSON, or PR comments
+
+## Supported Metrics
+
+- **Performance Score**: Overall Lighthouse performance score
+- **FCP**: First Contentful Paint
+- **LCP**: Largest Contentful Paint
+- **TBT**: Total Blocking Time
+- **CLS**: Cumulative Layout Shift
+- **Speed Index**: Visual progress speed
+- **TTI**: Time to Interactive
+
+## Auto-Fix Patterns
+
+The tool can detect and suggest fixes for:
+
+- Missing `loading="lazy"` on images
+- Missing image dimensions (CLS fix)
+- Scripts without `defer` or `async`
+- Missing `preconnect` hints
+- Missing `font-display: swap`
+- Render-blocking resources
+
+## Contributing
+
+See [CONTRIBUTING.md](CONTRIBUTING.md) for development setup and guidelines.
+
+## License
+
+MIT - see [LICENSE](LICENSE)
+
+## Related Projects
+
+- [Lighthouse CI](https://github.com/GoogleChrome/lighthouse-ci)
+- [Lighthouse](https://github.com/GoogleChrome/lighthouse)
+- [web.dev](https://web.dev)

package/dist/ai/copilot.d.ts

@@ -0,0 +1,40 @@
+/**
+ * GitHub Copilot SDK client for performance analysis
+ * Uses the official @github/copilot-sdk for programmatic access to Copilot
+ */
+export interface CopilotOptions {
+    token?: string;
+    model?: string;
+    maxTokens?: number;
+    timeout?: number;
+}
+/**
+ * Analyze performance data using GitHub Copilot SDK
+ */
+export declare function analyzeWithCopilot(prompt: string, options?: CopilotOptions): Promise<string>;
+/**
+ * Check if Copilot access is available
+ */
+export declare function checkCopilotAccess(_token?: string): Promise<boolean>;
+/**
+ * Stop the Copilot client and clean up resources
+ */
+export declare function stopCopilotClient(): Promise<void>;
+/**
+ * List available models
+ */
+export declare function listCopilotModels(): Promise<string[]>;
+/**
+ * Custom error class for Copilot API errors
+ */
+export declare class CopilotError extends Error {
+    statusCode: number;
+    constructor(message: string, statusCode: number);
+    isAuthError(): boolean;
+    isRateLimit(): boolean;
+}
+/**
+ * Get a helpful error message for Copilot errors
+ */
+export declare function getCopilotErrorMessage(error: unknown): string;
+//# sourceMappingURL=copilot.d.ts.map

package/dist/ai/copilot.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"copilot.d.ts","sourceRoot":"","sources":["../../src/ai/copilot.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAMH,MAAM,WAAW,cAAc;IAC7B,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,OAAO,CAAC,EAAE,MAAM,CAAC;CAClB;AA4CD;;GAEG;AACH,wBAAsB,kBAAkB,CACtC,MAAM,EAAE,MAAM,EACd,OAAO,GAAE,cAAmB,GAC3B,OAAO,CAAC,MAAM,CAAC,CAmDjB;AAED;;GAEG;AACH,wBAAsB,kBAAkB,CAAC,MAAM,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC,CAQ1E;AAED;;GAEG;AACH,wBAAsB,iBAAiB,IAAI,OAAO,CAAC,IAAI,CAAC,CAWvD;AAED;;GAEG;AACH,wBAAsB,iBAAiB,IAAI,OAAO,CAAC,MAAM,EAAE,CAAC,CAQ3D;AAED;;GAEG;AACH,qBAAa,YAAa,SAAQ,KAAK;IAG5B,UAAU,EAAE,MAAM;gBADzB,OAAO,EAAE,MAAM,EACR,UAAU,EAAE,MAAM;IAM3B,WAAW,IAAI,OAAO;IAItB,WAAW,IAAI,OAAO;CAGvB;AAED;;GAEG;AACH,wBAAgB,sBAAsB,CAAC,KAAK,EAAE,OAAO,GAAG,MAAM,CAgB7D"}

package/dist/ai/copilot.js

@@ -0,0 +1,176 @@
+"use strict";
+/**
+ * GitHub Copilot SDK client for performance analysis
+ * Uses the official @github/copilot-sdk for programmatic access to Copilot
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.CopilotError = void 0;
+exports.analyzeWithCopilot = analyzeWithCopilot;
+exports.checkCopilotAccess = checkCopilotAccess;
+exports.stopCopilotClient = stopCopilotClient;
+exports.listCopilotModels = listCopilotModels;
+exports.getCopilotErrorMessage = getCopilotErrorMessage;
+// Singleton client instance for reuse across calls
+let clientInstance = null;
+let clientInitPromise = null;
+/**
+ * Dynamically import the ESM SDK
+ * Uses Function to prevent TypeScript from converting to require()
+ */
+async function importSDK() {
+    // eslint-disable-next-line @typescript-eslint/no-implied-eval
+    const dynamicImport = new Function('specifier', 'return import(specifier)');
+    return dynamicImport('@github/copilot-sdk');
+}
+/**
+ * Get or create the Copilot client singleton
+ */
+async function getClient() {
+    if (clientInstance && clientInstance.getState() === 'connected') {
+        return clientInstance;
+    }
+    if (clientInitPromise) {
+        return clientInitPromise;
+    }
+    clientInitPromise = (async () => {
+        const { CopilotClient } = await importSDK();
+        const client = new CopilotClient({
+            autoStart: true,
+            autoRestart: true,
+            logLevel: 'error',
+        });
+        await client.start();
+        clientInstance = client;
+        return client;
+    })();
+    return clientInitPromise;
+}
+/**
+ * Analyze performance data using GitHub Copilot SDK
+ */
+async function analyzeWithCopilot(prompt, options = {}) {
+    const client = await getClient();
+    let session = null;
+    try {
+        // Create a session with the performance expert system message
+        session = await client.createSession({
+            model: options.model || 'gpt-4o',
+            systemMessage: {
+                mode: 'append',
+                content: 'You are a web performance expert specializing in Lighthouse optimization. You provide specific, actionable advice for improving Core Web Vitals and overall performance scores.',
+            },
+            streaming: false,
+        });
+        // Send the prompt and wait for the response
+        const timeout = options.timeout || 60000;
+        const response = await session.sendAndWait({ prompt }, timeout);
+        if (!response) {
+            throw new CopilotError('No response received from Copilot', 500);
+        }
+        return response.data.content || 'No analysis available.';
+    }
+    catch (error) {
+        if (error instanceof CopilotError) {
+            throw error;
+        }
+        // Map SDK errors to CopilotError
+        const message = error instanceof Error ? error.message : String(error);
+        if (message.includes('not authenticated') || message.includes('auth')) {
+            throw new CopilotError('GitHub Copilot authentication failed. Please run `gh auth login` or ensure GITHUB_TOKEN is set.', 401);
+        }
+        if (message.includes('rate limit') || message.includes('429')) {
+            throw new CopilotError('GitHub Copilot rate limit exceeded. Please try again later.', 429);
+        }
+        throw new CopilotError(`Copilot SDK error: ${message}`, 500);
+    }
+    finally {
+        // Clean up the session
+        if (session) {
+            try {
+                await session.destroy();
+            }
+            catch {
+                // Ignore cleanup errors
+            }
+        }
+    }
+}
+/**
+ * Check if Copilot access is available
+ */
+async function checkCopilotAccess(_token) {
+    try {
+        const client = await getClient();
+        const authStatus = await client.getAuthStatus();
+        return authStatus.isAuthenticated;
+    }
+    catch {
+        return false;
+    }
+}
+/**
+ * Stop the Copilot client and clean up resources
+ */
+async function stopCopilotClient() {
+    if (clientInstance) {
+        try {
+            await clientInstance.stop();
+        }
+        catch {
+            await clientInstance.forceStop();
+        }
+        finally {
+            clientInstance = null;
+            clientInitPromise = null;
+        }
+    }
+}
+/**
+ * List available models
+ */
+async function listCopilotModels() {
+    try {
+        const client = await getClient();
+        const models = await client.listModels();
+        return models.map(m => m.id);
+    }
+    catch {
+        return [];
+    }
+}
+/**
+ * Custom error class for Copilot API errors
+ */
+class CopilotError extends Error {
+    constructor(message, statusCode) {
+        super(message);
+        this.statusCode = statusCode;
+        this.name = 'CopilotError';
+    }
+    isAuthError() {
+        return this.statusCode === 401 || this.statusCode === 403;
+    }
+    isRateLimit() {
+        return this.statusCode === 429;
+    }
+}
+exports.CopilotError = CopilotError;
+/**
+ * Get a helpful error message for Copilot errors
+ */
+function getCopilotErrorMessage(error) {
+    if (error instanceof CopilotError) {
+        if (error.isAuthError()) {
+            return 'GitHub Copilot access denied. Please run `gh auth login` or ensure you have an active Copilot subscription.';
+        }
+        if (error.isRateLimit()) {
+            return 'GitHub Copilot rate limit exceeded. Please try again later.';
+        }
+        return error.message;
+    }
+    if (error instanceof Error) {
+        return error.message;
+    }
+    return 'Unknown error occurred while calling Copilot SDK';
+}
+//# sourceMappingURL=copilot.js.map

package/dist/ai/copilot.js.map

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

package/dist/ai/local.d.ts

@@ -0,0 +1,11 @@
+import { MetricComparison, Opportunity, AnalysisResult } from '../types';
+/**
+ * Local heuristic-based analysis when no AI provider is available
+ * This provides basic analysis without external API calls
+ */
+export declare function analyzeLocally(data: {
+    regressions: MetricComparison[];
+    improvements: MetricComparison[];
+    opportunities: Opportunity[];
+}): AnalysisResult;
+//# sourceMappingURL=local.d.ts.map

package/dist/ai/local.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"local.d.ts","sourceRoot":"","sources":["../../src/ai/local.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,gBAAgB,EAAE,WAAW,EAAE,cAAc,EAA6B,MAAM,UAAU,CAAC;AAEpG;;;GAGG;AACH,wBAAgB,cAAc,CAAC,IAAI,EAAE;IACnC,WAAW,EAAE,gBAAgB,EAAE,CAAC;IAChC,YAAY,EAAE,gBAAgB,EAAE,CAAC;IACjC,aAAa,EAAE,WAAW,EAAE,CAAC;CAC9B,GAAG,cAAc,CAWjB"}

package/dist/ai/local.js

@@ -0,0 +1,199 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.analyzeLocally = analyzeLocally;
+/**
+ * Local heuristic-based analysis when no AI provider is available
+ * This provides basic analysis without external API calls
+ */
+function analyzeLocally(data) {
+    const rootCauses = identifyRootCauses(data.regressions, data.opportunities);
+    const recommendations = generateRecommendations(data.regressions, data.opportunities);
+    return {
+        summary: generateSummary(data),
+        regressions: data.regressions,
+        improvements: data.improvements,
+        rootCauses,
+        recommendations,
+    };
+}
+/**
+ * Generate a text summary of the analysis
+ */
+function generateSummary(data) {
+    const parts = [];
+    if (data.regressions.length > 0) {
+        const critical = data.regressions.filter((r) => r.severity === 'critical');
+        const high = data.regressions.filter((r) => r.severity === 'high');
+        parts.push(`Found ${data.regressions.length} performance regression(s).`);
+        if (critical.length > 0) {
+            parts.push(`${critical.length} critical issue(s) require immediate attention.`);
+        }
+        if (high.length > 0) {
+            parts.push(`${high.length} high-severity issue(s) should be addressed soon.`);
+        }
+    }
+    else {
+        parts.push('No performance regressions detected.');
+    }
+    if (data.improvements.length > 0) {
+        parts.push(`${data.improvements.length} metric(s) improved.`);
+    }
+    return parts.join(' ');
+}
+/**
+ * Identify likely root causes based on heuristics
+ */
+function identifyRootCauses(regressions, opportunities) {
+    const causes = [];
+    for (const regression of regressions) {
+        const cause = getRootCauseForMetric(regression, opportunities);
+        if (cause) {
+            causes.push(cause);
+        }
+    }
+    return causes;
+}
+/**
+ * Get root cause for a specific metric regression
+ */
+function getRootCauseForMetric(regression, opportunities) {
+    const metric = regression.metric;
+    // Map metrics to likely causes
+    const causeMap = {
+        FCP: {
+            cause: 'First Contentful Paint regression often indicates render-blocking resources, slow server response, or increased initial HTML/CSS size.',
+            relatedOpps: ['render-blocking-resources', 'server-response-time', 'uses-rel-preconnect'],
+        },
+        LCP: {
+            cause: 'Largest Contentful Paint regression typically indicates slow loading of the main content element (images, video, or text blocks).',
+            relatedOpps: ['largest-contentful-paint-element', 'uses-responsive-images', 'offscreen-images'],
+        },
+        TBT: {
+            cause: 'Total Blocking Time regression indicates increased main thread blocking from JavaScript execution.',
+            relatedOpps: ['mainthread-work-breakdown', 'bootup-time', 'unused-javascript'],
+        },
+        CLS: {
+            cause: 'Cumulative Layout Shift regression indicates visual instability from elements moving after initial render.',
+            relatedOpps: ['layout-shift-elements', 'unsized-images', 'non-composited-animations'],
+        },
+        'Speed Index': {
+            cause: 'Speed Index regression indicates slower visual progress during page load.',
+            relatedOpps: ['render-blocking-resources', 'critical-request-chains'],
+        },
+        TTI: {
+            cause: 'Time to Interactive regression indicates the page takes longer to become fully interactive.',
+            relatedOpps: ['mainthread-work-breakdown', 'bootup-time', 'third-party-summary'],
+        },
+        'Performance Score': {
+            cause: 'Overall performance score decreased. Review individual Core Web Vitals for specific causes.',
+            relatedOpps: [],
+        },
+    };
+    const info = causeMap[metric];
+    if (!info) {
+        return null;
+    }
+    // Find related opportunities
+    const relatedOpportunities = opportunities.filter((o) => info.relatedOpps.includes(o.id));
+    let cause = info.cause;
+    if (relatedOpportunities.length > 0) {
+        cause += ` Lighthouse flagged: ${relatedOpportunities.map((o) => o.title).join(', ')}.`;
+    }
+    return {
+        metric,
+        cause,
+        confidence: relatedOpportunities.length > 0 ? 'high' : 'medium',
+        relatedFiles: undefined,
+    };
+}
+/**
+ * Generate recommendations based on regressions and opportunities
+ */
+function generateRecommendations(regressions, opportunities) {
+    const recommendations = [];
+    // Add recommendations based on opportunities
+    for (const opp of opportunities.slice(0, 5)) {
+        recommendations.push({
+            title: opp.title,
+            description: getRecommendationDescription(opp),
+            priority: opp.savingsMs && opp.savingsMs > 500 ? 'high' : 'medium',
+            impact: opp.savingsMs ? `~${opp.savingsMs.toFixed(0)}ms potential improvement` : 'Variable impact',
+            effort: getEstimatedEffort(opp.id),
+        });
+    }
+    // Add general recommendations based on regression patterns
+    const hasLCPRegression = regressions.some((r) => r.metric === 'LCP');
+    const hasTBTRegression = regressions.some((r) => r.metric === 'TBT');
+    const hasCLSRegression = regressions.some((r) => r.metric === 'CLS');
+    if (hasLCPRegression && !recommendations.some((r) => r.title.includes('image'))) {
+        recommendations.push({
+            title: 'Optimize largest contentful paint element',
+            description: 'Identify the LCP element and ensure it loads quickly. Use preload for critical images, optimize image formats (WebP/AVIF), and implement responsive images.',
+            priority: 'high',
+            impact: 'Can improve LCP by 500ms-2s',
+            effort: 'medium',
+        });
+    }
+    if (hasTBTRegression && !recommendations.some((r) => r.title.includes('JavaScript'))) {
+        recommendations.push({
+            title: 'Reduce JavaScript execution time',
+            description: 'Audit third-party scripts, implement code splitting, and defer non-critical JavaScript. Consider using Web Workers for heavy computations.',
+            priority: 'high',
+            impact: 'Can improve TBT by 100-500ms',
+            effort: 'high',
+        });
+    }
+    if (hasCLSRegression) {
+        recommendations.push({
+            title: 'Fix layout shifts',
+            description: 'Add explicit dimensions to images and embedded content. Reserve space for dynamic content and avoid inserting content above existing content.',
+            priority: 'medium',
+            impact: 'Can reduce CLS by 0.05-0.1',
+            effort: 'low',
+        });
+    }
+    // Sort by priority
+    const priorityOrder = { high: 0, medium: 1, low: 2 };
+    return recommendations.sort((a, b) => priorityOrder[a.priority] - priorityOrder[b.priority]);
+}
+/**
+ * Get a detailed description for a recommendation
+ */
+function getRecommendationDescription(opp) {
+    const descriptions = {
+        'render-blocking-resources': 'Identify and defer or inline critical CSS/JS. Use async/defer for non-critical scripts.',
+        'unused-javascript': 'Remove or lazy-load unused JavaScript. Use code splitting to reduce initial bundle size.',
+        'unused-css-rules': 'Remove unused CSS rules or implement critical CSS extraction.',
+        'uses-responsive-images': 'Implement srcset and sizes attributes for responsive images. Use appropriate image dimensions.',
+        'offscreen-images': 'Implement lazy loading for images below the fold using loading="lazy" or Intersection Observer.',
+        'uses-optimized-images': 'Compress images without quality loss. Consider WebP or AVIF formats.',
+        'uses-text-compression': 'Enable GZIP or Brotli compression on your server for text-based resources.',
+        'server-response-time': 'Optimize server configuration, use caching, or consider a CDN for faster initial response.',
+        'uses-rel-preconnect': 'Add preconnect hints for critical third-party origins.',
+        'third-party-summary': 'Audit third-party scripts and remove or defer non-essential ones.',
+    };
+    return descriptions[opp.id] || opp.description || opp.title;
+}
+/**
+ * Estimate effort for an optimization
+ */
+function getEstimatedEffort(oppId) {
+    const lowEffort = [
+        'uses-text-compression',
+        'uses-rel-preconnect',
+        'uses-rel-preload',
+        'offscreen-images',
+    ];
+    const highEffort = [
+        'unused-javascript',
+        'mainthread-work-breakdown',
+        'bootup-time',
+        'third-party-summary',
+    ];
+    if (lowEffort.includes(oppId))
+        return 'low';
+    if (highEffort.includes(oppId))
+        return 'high';
+    return 'medium';
+}
+//# sourceMappingURL=local.js.map