webmcp-cli 1.2.2 → 1.2.3

package/dist/crawler/link-extractor.js

@@ -0,0 +1,49 @@
+import * as cheerio from 'cheerio';
+const NON_PAGE_EXTENSIONS = /\.(?:avif|bmp|gif|ico|jpe?g|png|svg|webp|pdf|docx?|pptx?|xlsx?|zip|rar|7z|tar|gz|mp3|mp4|mpe?g|mov|avi|wmv|ogg|wav|css|js|json|xml|txt|woff2?|ttf|eot)$/i;
+const BLOCKED_PROTOCOLS = /^(?:mailto:|tel:|javascript:|data:)/i;
+function normalizeLink(url, baseUrl, allowedOrigin) {
+    const trimmed = url.trim();
+    if (!trimmed || trimmed.startsWith('#') || BLOCKED_PROTOCOLS.test(trimmed)) {
+        return null;
+    }
+    try {
+        const resolved = new URL(trimmed, baseUrl);
+        if (resolved.origin !== allowedOrigin) {
+            return null;
+        }
+        // Skip static assets and known non-page resources
+        if (NON_PAGE_EXTENSIONS.test(resolved.pathname)) {
+            return null;
+        }
+        resolved.hash = '';
+        if (resolved.pathname.length > 1 && resolved.pathname.endsWith('/')) {
+            resolved.pathname = resolved.pathname.slice(0, -1);
+        }
+        return resolved.href;
+    }
+    catch {
+        return null;
+    }
+}
+export function extractInternalLinks(html, baseUrl) {
+    let allowedOrigin;
+    try {
+        allowedOrigin = new URL(baseUrl).origin;
+    }
+    catch {
+        return [];
+    }
+    const $ = cheerio.load(html);
+    const links = new Set();
+    $('a[href]').each((_index, element) => {
+        const href = $(element).attr('href');
+        if (!href)
+            return;
+        const normalized = normalizeLink(href, baseUrl, allowedOrigin);
+        if (normalized) {
+            links.add(normalized);
+        }
+    });
+    return [...links];
+}
+//# sourceMappingURL=link-extractor.js.map

package/dist/crawler/link-extractor.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"link-extractor.js","sourceRoot":"","sources":["../../src/crawler/link-extractor.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,OAAO,MAAM,SAAS,CAAC;AAEnC,MAAM,mBAAmB,GAAG,0JAA0J,CAAC;AACvL,MAAM,iBAAiB,GAAG,sCAAsC,CAAC;AAEjE,SAAS,aAAa,CAAC,GAAW,EAAE,OAAe,EAAE,aAAqB;IACxE,MAAM,OAAO,GAAG,GAAG,CAAC,IAAI,EAAE,CAAC;IAC3B,IAAI,CAAC,OAAO,IAAI,OAAO,CAAC,UAAU,CAAC,GAAG,CAAC,IAAI,iBAAiB,CAAC,IAAI,CAAC,OAAO,CAAC,EAAE,CAAC;QAC3E,OAAO,IAAI,CAAC;IACd,CAAC;IAED,IAAI,CAAC;QACH,MAAM,QAAQ,GAAG,IAAI,GAAG,CAAC,OAAO,EAAE,OAAO,CAAC,CAAC;QAE3C,IAAI,QAAQ,CAAC,MAAM,KAAK,aAAa,EAAE,CAAC;YACtC,OAAO,IAAI,CAAC;QACd,CAAC;QAED,kDAAkD;QAClD,IAAI,mBAAmB,CAAC,IAAI,CAAC,QAAQ,CAAC,QAAQ,CAAC,EAAE,CAAC;YAChD,OAAO,IAAI,CAAC;QACd,CAAC;QAED,QAAQ,CAAC,IAAI,GAAG,EAAE,CAAC;QACnB,IAAI,QAAQ,CAAC,QAAQ,CAAC,MAAM,GAAG,CAAC,IAAI,QAAQ,CAAC,QAAQ,CAAC,QAAQ,CAAC,GAAG,CAAC,EAAE,CAAC;YACpE,QAAQ,CAAC,QAAQ,GAAG,QAAQ,CAAC,QAAQ,CAAC,KAAK,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC;QACrD,CAAC;QAED,OAAO,QAAQ,CAAC,IAAI,CAAC;IACvB,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,IAAI,CAAC;IACd,CAAC;AACH,CAAC;AAED,MAAM,UAAU,oBAAoB,CAAC,IAAY,EAAE,OAAe;IAChE,IAAI,aAAqB,CAAC;IAC1B,IAAI,CAAC;QACH,aAAa,GAAG,IAAI,GAAG,CAAC,OAAO,CAAC,CAAC,MAAM,CAAC;IAC1C,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,EAAE,CAAC;IACZ,CAAC;IAED,MAAM,CAAC,GAAG,OAAO,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;IAC7B,MAAM,KAAK,GAAG,IAAI,GAAG,EAAU,CAAC;IAEhC,CAAC,CAAC,SAAS,CAAC,CAAC,IAAI,CAAC,CAAC,MAAM,EAAE,OAAO,EAAE,EAAE;QACpC,MAAM,IAAI,GAAG,CAAC,CAAC,OAAO,CAAC,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC;QACrC,IAAI,CAAC,IAAI;YAAE,OAAO;QAElB,MAAM,UAAU,GAAG,aAAa,CAAC,IAAI,EAAE,OAAO,EAAE,aAAa,CAAC,CAAC;QAC/D,IAAI,UAAU,EAAE,CAAC;YACf,KAAK,CAAC,GAAG,CAAC,UAAU,CAAC,CAAC;QACxB,CAAC;IACH,CAAC,CAAC,CAAC;IAEH,OAAO,CAAC,GAAG,KAAK,CAAC,CAAC;AACpB,CAAC"}

package/dist/generators/index.d.ts

@@ -0,0 +1,10 @@
+/**
+ * Report Generators
+ */
+export { generateJsonReport } from './report-json.js';
+export type { AuditReportJson } from './report-json.js';
+export { generateHtmlReport } from './report-html.js';
+export { generateReports } from './report-manager.js';
+export type { ReportOptions, ReportOutput } from './report-manager.js';
+export { generateToolCode, generateAllToolCode, generateCombinedCode, } from './tool-code-generator.js';
+export type { GeneratedCode } from './tool-code-generator.js';

package/dist/generators/index.js

@@ -0,0 +1,8 @@
+/**
+ * Report Generators
+ */
+export { generateJsonReport } from './report-json.js';
+export { generateHtmlReport } from './report-html.js';
+export { generateReports } from './report-manager.js';
+export { generateToolCode, generateAllToolCode, generateCombinedCode, } from './tool-code-generator.js';
+//# sourceMappingURL=index.js.map

package/dist/generators/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/generators/index.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,EAAE,kBAAkB,EAAE,MAAM,kBAAkB,CAAC;AAEtD,OAAO,EAAE,kBAAkB,EAAE,MAAM,kBAAkB,CAAC;AACtD,OAAO,EAAE,eAAe,EAAE,MAAM,qBAAqB,CAAC;AAEtD,OAAO,EACL,gBAAgB,EAChB,mBAAmB,EACnB,oBAAoB,GACrB,MAAM,0BAA0B,CAAC"}

package/dist/generators/report-html.d.ts

@@ -0,0 +1,12 @@
+/**
+ * HTML Report Generator
+ *
+ * Generates a standalone, self-contained HTML audit report with embedded CSS/JS.
+ */
+import type { AuditResult } from '../core/types/index.js';
+/**
+ * Generate a self-contained HTML audit report.
+ *
+ * @returns Absolute path to the written file.
+ */
+export declare function generateHtmlReport(auditResult: AuditResult, outputDir: string): Promise<string>;

package/dist/generators/report-html.js

@@ -0,0 +1,470 @@
+/**
+ * HTML Report Generator
+ *
+ * Generates a standalone, self-contained HTML audit report with embedded CSS/JS.
+ */
+import { writeFile } from 'fs/promises';
+import { join } from 'path';
+/* ------------------------------------------------------------------ */
+/*  Helpers                                                            */
+/* ------------------------------------------------------------------ */
+function escapeHtml(text) {
+    return text
+        .replace(/&/g, '&')
+        .replace(/</g, '&lt;')
+        .replace(/>/g, '&gt;')
+        .replace(/"/g, '&quot;')
+        .replace(/'/g, '&#039;');
+}
+function severityColor(severity) {
+    switch (severity) {
+        case 'critical':
+            return '#ef4444';
+        case 'warning':
+            return '#f59e0b';
+        case 'info':
+            return '#3b82f6';
+        default:
+            return '#6b7280';
+    }
+}
+function severityBg(severity) {
+    switch (severity) {
+        case 'critical':
+            return '#fef2f2';
+        case 'warning':
+            return '#fffbeb';
+        case 'info':
+            return '#eff6ff';
+        default:
+            return '#f9fafb';
+    }
+}
+function gradeColor(grade) {
+    if (grade.startsWith('A'))
+        return '#22c55e';
+    if (grade.startsWith('B'))
+        return '#84cc16';
+    if (grade.startsWith('C'))
+        return '#f59e0b';
+    if (grade === 'D')
+        return '#f97316';
+    return '#ef4444';
+}
+function formatDuration(ms) {
+    if (ms < 1000)
+        return `${ms}ms`;
+    return `${(ms / 1000).toFixed(1)}s`;
+}
+/* ------------------------------------------------------------------ */
+/*  Section Renderers                                                  */
+/* ------------------------------------------------------------------ */
+function renderCss() {
+    return `
+    :root {
+      --bg: #0f172a;
+      --surface: #1e293b;
+      --surface-2: #334155;
+      --border: #475569;
+      --text: #f1f5f9;
+      --text-dim: #94a3b8;
+      --accent: #38bdf8;
+      --green: #22c55e;
+      --red: #ef4444;
+      --yellow: #f59e0b;
+      --blue: #3b82f6;
+      --orange: #f97316;
+    }
+    * { margin: 0; padding: 0; box-sizing: border-box; }
+    body {
+      font-family: -apple-system, BlinkMacSystemFont, 'Segoe UI', Roboto, 'Helvetica Neue', sans-serif;
+      background: var(--bg);
+      color: var(--text);
+      line-height: 1.6;
+      padding: 2rem;
+      max-width: 1100px;
+      margin: 0 auto;
+    }
+    h1, h2, h3 { font-weight: 600; }
+    h1 { font-size: 1.5rem; color: var(--accent); }
+    h2 { font-size: 1.25rem; margin-bottom: 1rem; color: var(--text); border-bottom: 1px solid var(--border); padding-bottom: 0.5rem; }
+    h3 { font-size: 1rem; color: var(--text-dim); }
+    a { color: var(--accent); text-decoration: none; }
+    a:hover { text-decoration: underline; }
+
+    .header { display: flex; align-items: center; justify-content: space-between; margin-bottom: 2rem; }
+    .header-left { display: flex; align-items: center; gap: 1rem; }
+    .header-meta { color: var(--text-dim); font-size: 0.85rem; }
+
+    .grade-badge {
+      display: inline-flex; align-items: center; justify-content: center;
+      width: 72px; height: 72px; border-radius: 50%;
+      font-size: 1.75rem; font-weight: 700;
+      border: 3px solid;
+    }
+    .score-number { font-size: 2.5rem; font-weight: 700; }
+
+    .summary-cards { display: grid; grid-template-columns: repeat(auto-fit, minmax(200px, 1fr)); gap: 1rem; margin-bottom: 2rem; }
+    .card {
+      background: var(--surface); border-radius: 8px; padding: 1.25rem;
+      border: 1px solid var(--border);
+    }
+    .card-label { font-size: 0.8rem; color: var(--text-dim); text-transform: uppercase; letter-spacing: 0.05em; margin-bottom: 0.25rem; }
+    .card-value { font-size: 1.5rem; font-weight: 700; }
+
+    .section { background: var(--surface); border-radius: 8px; padding: 1.5rem; margin-bottom: 1.5rem; border: 1px solid var(--border); }
+
+    .cat-bar { margin-bottom: 0.75rem; }
+    .cat-bar-header { display: flex; justify-content: space-between; font-size: 0.85rem; margin-bottom: 0.25rem; }
+    .cat-bar-track { background: var(--surface-2); border-radius: 4px; height: 8px; overflow: hidden; }
+    .cat-bar-fill { height: 100%; border-radius: 4px; transition: width 0.6s ease; }
+
+    table { width: 100%; border-collapse: collapse; font-size: 0.9rem; }
+    th { text-align: left; padding: 0.5rem 0.75rem; color: var(--text-dim); font-weight: 500; font-size: 0.8rem; text-transform: uppercase; letter-spacing: 0.05em; border-bottom: 1px solid var(--border); }
+    td { padding: 0.5rem 0.75rem; border-bottom: 1px solid var(--surface-2); vertical-align: top; }
+    tr:last-child td { border-bottom: none; }
+
+    .severity-badge {
+      display: inline-block; padding: 0.15rem 0.5rem; border-radius: 4px;
+      font-size: 0.75rem; font-weight: 600; text-transform: uppercase;
+    }
+
+    .tool-card { background: var(--surface-2); border-radius: 6px; padding: 1rem; margin-bottom: 0.75rem; }
+    .tool-name { font-weight: 600; color: var(--accent); }
+    .tool-source { font-size: 0.75rem; padding: 0.1rem 0.4rem; border-radius: 3px; background: var(--surface); color: var(--text-dim); }
+    .tool-desc { color: var(--text-dim); font-size: 0.9rem; margin: 0.25rem 0; }
+    .param-list { list-style: none; font-size: 0.85rem; color: var(--text-dim); margin-top: 0.5rem; }
+    .param-list li { padding: 0.15rem 0; }
+    .param-list li::before { content: '\\251C\\2500\\2500 '; font-family: monospace; color: var(--border); }
+    .param-list li:last-child::before { content: '\\2514\\2500\\2500 '; }
+
+    .rec-list { list-style: none; counter-reset: rec; }
+    .rec-item { padding: 0.75rem 0; border-bottom: 1px solid var(--surface-2); display: flex; gap: 0.75rem; align-items: flex-start; }
+    .rec-item:last-child { border-bottom: none; }
+    .rec-num { display: flex; align-items: center; justify-content: center; width: 28px; height: 28px; border-radius: 50%; background: var(--accent); color: var(--bg); font-weight: 700; font-size: 0.85rem; flex-shrink: 0; }
+    .rec-impact { color: var(--green); font-weight: 600; font-size: 0.85rem; }
+    .rec-effort { font-size: 0.75rem; padding: 0.1rem 0.4rem; border-radius: 3px; }
+
+    .filters { display: flex; gap: 0.5rem; margin-bottom: 1rem; flex-wrap: wrap; }
+    .filter-btn {
+      padding: 0.3rem 0.75rem; border-radius: 4px; border: 1px solid var(--border);
+      background: transparent; color: var(--text-dim); cursor: pointer; font-size: 0.8rem;
+      transition: all 0.2s;
+    }
+    .filter-btn:hover, .filter-btn.active { background: var(--accent); color: var(--bg); border-color: var(--accent); }
+
+    .collapsible summary {
+      cursor: pointer; list-style: none; display: flex; align-items: center; gap: 0.5rem;
+    }
+    .collapsible summary::before { content: '\\25B6'; font-size: 0.7rem; transition: transform 0.2s; }
+    .collapsible[open] summary::before { transform: rotate(90deg); }
+    .collapsible-content { padding-top: 0.75rem; }
+
+    .footer { text-align: center; color: var(--text-dim); font-size: 0.8rem; margin-top: 2rem; padding-top: 1rem; border-top: 1px solid var(--border); }
+
+    @media print {
+      body { background: #fff; color: #000; }
+      .section { border-color: #ddd; }
+      .filter-btn { display: none; }
+    }
+  `;
+}
+function renderJs() {
+    return `
+    document.addEventListener('DOMContentLoaded', () => {
+      // Severity filters
+      const filterBtns = document.querySelectorAll('.filter-btn[data-severity]');
+      const findingRows = document.querySelectorAll('.finding-row');
+
+      let activeFilters = new Set(['critical', 'warning', 'info']);
+
+      filterBtns.forEach(btn => {
+        btn.classList.add('active');
+        btn.addEventListener('click', () => {
+          const severity = btn.dataset.severity;
+          if (severity === 'all') {
+            activeFilters = new Set(['critical', 'warning', 'info']);
+            filterBtns.forEach(b => b.classList.add('active'));
+          } else {
+            if (activeFilters.has(severity)) {
+              activeFilters.delete(severity);
+              btn.classList.remove('active');
+            } else {
+              activeFilters.add(severity);
+              btn.classList.add('active');
+            }
+            // Update "all" button
+            const allBtn = document.querySelector('.filter-btn[data-severity="all"]');
+            if (allBtn) {
+              allBtn.classList.toggle('active', activeFilters.size === 3);
+            }
+          }
+
+          findingRows.forEach(row => {
+            row.style.display = activeFilters.has(row.dataset.severity) ? '' : 'none';
+          });
+        });
+      });
+    });
+  `;
+}
+function renderExecutiveSummary(result) {
+    const gc = gradeColor(result.score.grade);
+    const { critical, warning, info } = result.score.issueCount;
+    return `
+    <div class="header">
+      <div class="header-left">
+        <div>
+          <h1>WebMCP Audit Report</h1>
+          <div class="header-meta">
+            <a href="${escapeHtml(result.url)}" target="_blank">${escapeHtml(result.url)}</a><br>
+            ${escapeHtml(result.startedAt.toLocaleString())} &middot; ${formatDuration(result.duration)} &middot; v${escapeHtml(result.cliVersion)}
+          </div>
+        </div>
+      </div>
+      <div style="text-align:center">
+        <div class="grade-badge" style="color:${gc}; border-color:${gc};">${escapeHtml(result.score.grade)}</div>
+        <div class="score-number" style="color:${gc};">${result.score.total}</div>
+        <div style="color:var(--text-dim); font-size:0.8rem;">out of 100</div>
+      </div>
+    </div>
+
+    <div class="summary-cards">
+      <div class="card">
+        <div class="card-label">Tools Detected</div>
+        <div class="card-value" style="color:var(--accent);">${result.tools.length}</div>
+      </div>
+      <div class="card">
+        <div class="card-label">Opportunities</div>
+        <div class="card-value" style="color:var(--yellow);">${result.opportunities.length}</div>
+      </div>
+      <div class="card">
+        <div class="card-label">Critical Issues</div>
+        <div class="card-value" style="color:var(--red);">${critical}</div>
+      </div>
+      <div class="card">
+        <div class="card-label">Warnings</div>
+        <div class="card-value" style="color:var(--yellow);">${warning}</div>
+      </div>
+      <div class="card">
+        <div class="card-label">Info</div>
+        <div class="card-value" style="color:var(--blue);">${info}</div>
+      </div>
+      <div class="card">
+        <div class="card-label">WebMCP API</div>
+        <div class="card-value" style="color:${result.hasWebMCP ? 'var(--green)' : 'var(--red)'};">${result.hasWebMCP ? 'Detected' : 'Not Found'}</div>
+      </div>
+    </div>
+  `;
+}
+function renderCategoryBars(categories) {
+    const bars = categories
+        .map((cat) => {
+        const pct = cat.percentage;
+        const color = pct >= 80 ? 'var(--green)' : pct >= 60 ? 'var(--yellow)' : 'var(--red)';
+        return `
+      <div class="cat-bar">
+        <div class="cat-bar-header">
+          <span>${escapeHtml(cat.name)}</span>
+          <span>${pct}% (${cat.score}/${cat.maxScore})</span>
+        </div>
+        <div class="cat-bar-track">
+          <div class="cat-bar-fill" style="width:${pct}%; background:${color};"></div>
+        </div>
+      </div>
+    `;
+    })
+        .join('');
+    return `
+    <div class="section">
+      <h2>Score Breakdown</h2>
+      ${bars}
+    </div>
+  `;
+}
+function renderFindings(findings) {
+    if (findings.length === 0) {
+        return `
+      <div class="section">
+        <h2>Findings</h2>
+        <p style="color:var(--green);">No issues found. Great job!</p>
+      </div>
+    `;
+    }
+    const rows = findings
+        .map((f) => {
+        const sc = severityColor(f.severity);
+        const sb = severityBg(f.severity);
+        return `
+      <tr class="finding-row" data-severity="${f.severity}">
+        <td><span class="severity-badge" style="background:${sb}; color:${sc};">${escapeHtml(f.severity)}</span></td>
+        <td style="font-family:monospace; font-size:0.8rem;">${escapeHtml(f.ruleId)}</td>
+        <td>${escapeHtml(f.message)}</td>
+        <td style="color:var(--text-dim);">${escapeHtml(f.tool ?? f.page ?? '—')}</td>
+        <td style="color:var(--text-dim);">${f.fix ? escapeHtml(f.fix) : '—'}</td>
+        <td style="text-align:right;">${f.scoreImpact > 0 ? `<span style="color:var(--red);">-${f.scoreImpact}</span>` : '—'}</td>
+      </tr>
+    `;
+    })
+        .join('');
+    return `
+    <div class="section">
+      <h2>Findings (${findings.length})</h2>
+      <div class="filters">
+        <button class="filter-btn active" data-severity="all">All</button>
+        <button class="filter-btn active" data-severity="critical">Critical</button>
+        <button class="filter-btn active" data-severity="warning">Warning</button>
+        <button class="filter-btn active" data-severity="info">Info</button>
+      </div>
+      <table>
+        <thead>
+          <tr>
+            <th>Severity</th>
+            <th>Rule</th>
+            <th>Issue</th>
+            <th>Tool / Page</th>
+            <th>Suggested Fix</th>
+            <th style="text-align:right;">Impact</th>
+          </tr>
+        </thead>
+        <tbody>
+          ${rows}
+        </tbody>
+      </table>
+    </div>
+  `;
+}
+function renderToolCard(tool) {
+    const params = tool.inputSchema?.properties
+        ? Object.entries(tool.inputSchema.properties)
+            .map(([name, schema]) => {
+            const s = schema;
+            const required = tool.inputSchema?.required?.includes(name);
+            return `<li><code>${escapeHtml(name)}</code> <span style="color:var(--text-dim);">(${escapeHtml(String(s['type'] ?? 'any'))}${required ? ', required' : ''})</span>${s['description'] ? ` — ${escapeHtml(String(s['description']))}` : ''}</li>`;
+        })
+            .join('')
+        : '<li style="color:var(--text-dim);">No parameters defined</li>';
+    return `
+    <div class="tool-card">
+      <div style="display:flex; align-items:center; gap:0.5rem;">
+        <span class="tool-name">${escapeHtml(tool.name)}</span>
+        <span class="tool-source">${escapeHtml(tool.source)}</span>
+        ${tool.hasExecute ? '<span class="tool-source" style="color:var(--green);">executable</span>' : ''}
+      </div>
+      <div class="tool-desc">${escapeHtml(tool.description || '(no description)')}</div>
+      <ul class="param-list">${params}</ul>
+    </div>
+  `;
+}
+function renderToolInventory(tools) {
+    if (tools.length === 0) {
+        return `
+      <div class="section">
+        <h2>Tool Inventory</h2>
+        <p style="color:var(--text-dim);">No tools detected on this site.</p>
+      </div>
+    `;
+    }
+    const imperative = tools.filter((t) => t.source === 'imperative');
+    const declarative = tools.filter((t) => t.source === 'declarative');
+    let content = '<h2>Tool Inventory (' + tools.length + ')</h2>';
+    if (imperative.length > 0) {
+        content += `<h3 style="margin:0.75rem 0 0.5rem;">Imperative (JavaScript API) — ${imperative.length}</h3>`;
+        content += imperative.map(renderToolCard).join('');
+    }
+    if (declarative.length > 0) {
+        content += `<h3 style="margin:0.75rem 0 0.5rem;">Declarative (HTML Forms) — ${declarative.length}</h3>`;
+        content += declarative.map(renderToolCard).join('');
+    }
+    return `<div class="section">${content}</div>`;
+}
+function renderRecommendations(recs) {
+    if (recs.length === 0)
+        return '';
+    const effortColor = (e) => e === 'low' ? 'var(--green)' : e === 'medium' ? 'var(--yellow)' : 'var(--red)';
+    const items = recs
+        .slice(0, 10)
+        .map((r) => `
+      <div class="rec-item">
+        <div class="rec-num">${r.priority}</div>
+        <div style="flex:1;">
+          <div>${escapeHtml(r.action)}</div>
+          <div style="margin-top:0.25rem;">
+            <span class="rec-impact">+${r.scoreImpact} pts</span>
+            <span class="rec-effort" style="background:var(--surface-2); color:${effortColor(r.effort)}; margin-left:0.5rem;">${r.effort} effort</span>
+            <span style="color:var(--text-dim); font-size:0.8rem; margin-left:0.5rem;">${escapeHtml(r.ruleId)}</span>
+          </div>
+        </div>
+      </div>
+    `)
+        .join('');
+    return `
+    <div class="section">
+      <h2>Top Recommendations</h2>
+      <div class="rec-list">${items}</div>
+    </div>
+  `;
+}
+function renderPages(result) {
+    if (result.pages.length <= 1)
+        return '';
+    const rows = result.pages
+        .map((p) => `
+    <details class="collapsible" style="margin-bottom:0.5rem;">
+      <summary>
+        <span style="color:${p.hasWebMCP ? 'var(--green)' : 'var(--text-dim)'};">${p.hasWebMCP ? '●' : '○'}</span>
+        <span>${escapeHtml(p.title || p.url)}</span>
+        <span style="color:var(--text-dim); font-size:0.8rem;">${p.toolCount} tools, ${p.formCount} forms</span>
+      </summary>
+      <div class="collapsible-content" style="padding-left:1.5rem; font-size:0.85rem; color:var(--text-dim);">
+        <div>URL: <a href="${escapeHtml(p.url)}" target="_blank">${escapeHtml(p.url)}</a></div>
+        <div>WebMCP: ${p.hasWebMCP ? 'Yes' : 'No'} · Tools: ${p.toolCount} · Forms: ${p.formCount} · Opportunities: ${p.opportunityCount}</div>
+      </div>
+    </details>
+  `)
+        .join('');
+    return `
+    <div class="section">
+      <h2>Pages Analyzed (${result.pages.length})</h2>
+      ${rows}
+    </div>
+  `;
+}
+/* ------------------------------------------------------------------ */
+/*  Main Generator                                                     */
+/* ------------------------------------------------------------------ */
+/**
+ * Generate a self-contained HTML audit report.
+ *
+ * @returns Absolute path to the written file.
+ */
+export async function generateHtmlReport(auditResult, outputDir) {
+    const html = `<!DOCTYPE html>
+<html lang="en">
+<head>
+  <meta charset="UTF-8">
+  <meta name="viewport" content="width=device-width, initial-scale=1.0">
+  <title>WebMCP Audit — ${escapeHtml(auditResult.url)} — ${auditResult.score.grade} (${auditResult.score.total}/100)</title>
+  <style>${renderCss()}</style>
+</head>
+<body>
+  ${renderExecutiveSummary(auditResult)}
+  ${renderCategoryBars(auditResult.score.categories)}
+  ${renderFindings(auditResult.findings)}
+  ${renderToolInventory(auditResult.tools)}
+  ${renderRecommendations(auditResult.recommendations)}
+  ${renderPages(auditResult)}
+
+  <div class="footer">
+    Generated by <strong>webmcp-cli</strong> v${escapeHtml(auditResult.cliVersion)} &middot;
+    <a href="https://webmcp.org" target="_blank">webmcp.org</a>
+  </div>
+
+  <script>${renderJs()}</script>
+</body>
+</html>`;
+    const filePath = join(outputDir, 'audit-report.html');
+    await writeFile(filePath, html, 'utf-8');
+    return filePath;
+}
+//# sourceMappingURL=report-html.js.map

package/dist/generators/report-html.js.map

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

package/dist/generators/report-json.d.ts

@@ -0,0 +1,95 @@
+/**
+ * JSON Report Generator
+ *
+ * Generates a machine-readable JSON audit report.
+ */
+import type { AuditResult } from '../core/types/index.js';
+export interface AuditReportJson {
+    meta: {
+        tool: string;
+        version: string;
+        timestamp: string;
+        targetUrl: string;
+        auditDuration: number;
+    };
+    score: {
+        total: number;
+        grade: string;
+        categories: Record<string, {
+            score: number;
+            maxScore: number;
+            percentage: number;
+            weight: number;
+            rulesChecked: number;
+            rulesPassed: number;
+        }>;
+    };
+    pages: Array<{
+        url: string;
+        title: string;
+        hasWebMCP: boolean;
+        toolCount: number;
+        formCount: number;
+        opportunityCount: number;
+    }>;
+    tools: {
+        existing: SerializedTool[];
+        opportunities: SerializedOpportunity[];
+    };
+    findings: SerializedFinding[];
+    recommendations: SerializedRecommendation[];
+    summary: {
+        totalFindings: number;
+        critical: number;
+        warnings: number;
+        info: number;
+        topActions: string[];
+    };
+}
+interface SerializedTool {
+    name: string;
+    description: string;
+    source: 'imperative' | 'declarative';
+    pageUrl: string;
+    hasExecute?: boolean;
+    registrationMethod?: string;
+    inputSchema?: Record<string, unknown>;
+    annotations?: Record<string, unknown>;
+}
+interface SerializedOpportunity {
+    index: number;
+    sensitivity: string;
+    agenticValue: string;
+    fieldCount: number;
+    contextClues: {
+        formAction: string | null;
+        formMethod: string;
+        submitText: string | null;
+        nearestHeading: string | null;
+        fieldNames: string[];
+    };
+}
+interface SerializedFinding {
+    ruleId: string;
+    severity: string;
+    message: string;
+    tool?: string;
+    page?: string;
+    fix?: string;
+    scoreImpact: number;
+}
+interface SerializedRecommendation {
+    priority: number;
+    action: string;
+    scoreImpact: number;
+    effort: string;
+    ruleId: string;
+    affectedTools?: string[];
+}
+/**
+ * Generate machine-readable JSON report file.
+ *
+ * @returns Absolute path to the written file.
+ */
+export declare function generateJsonReport(auditResult: AuditResult, outputDir: string): Promise<string>;
+export {};