@freshworks/shiftleft-tools 1.1.8

package/templates/postman/scripts/lib/report_consolidated.py

@@ -0,0 +1,363 @@
+"""
+Consolidated Newman test results report generator (API Test Quality Report).
+"""
+
+import glob
+import json
+import os
+from html import escape as esc
+from report_utils import get_html_template
+
+
+_HTML_EXTRA_HASH_NAV_MARKER = 'mp-installation:htmlextra-hash-nav'
+_HTML_EXTRA_HASH_NAV_SCRIPT = '''<script>
+/* mp-installation:htmlextra-hash-nav */
+(function() {
+  function showFailedTab() {
+    if (window.location.hash !== '#pills-failed' || !window.jQuery) {
+      return;
+    }
+    var $tab = jQuery('.nav-tabs a[href="#pills-failed"]');
+    if ($tab.length) {
+      $tab.tab('show');
+    }
+    var el = document.getElementById('pills-failed');
+    if (el) {
+      el.scrollIntoView({block: 'start'});
+    }
+  }
+  if (document.readyState === 'loading') {
+    document.addEventListener('DOMContentLoaded', showFailedTab);
+  } else {
+    showFailedTab();
+  }
+  window.addEventListener('hashchange', showFailedTab);
+})();
+</script>'''
+
+
+def patch_htmlextra_reports_for_hash_navigation(reports_dir):
+    """Inject script so consolidated links to #pills-failed open the Failed Tests tab."""
+    if not reports_dir or not os.path.isdir(reports_dir):
+        return 0
+    patched = 0
+    for root, _dirs, files in os.walk(reports_dir):
+        for name in files:
+            if not name.endswith('.html'):
+                continue
+            if name.startswith('consolidated-') or name.startswith('quality-'):
+                continue
+            path = os.path.join(root, name)
+            try:
+                with open(path, 'r', encoding='utf-8') as f:
+                    html = f.read()
+            except OSError:
+                continue
+            if 'id="pills-failed"' not in html:
+                continue
+            if _HTML_EXTRA_HASH_NAV_MARKER in html:
+                continue
+            if '</body>' not in html:
+                continue
+            updated = html.replace('</body>', _HTML_EXTRA_HASH_NAV_SCRIPT + '\n</body>', 1)
+            with open(path, 'w', encoding='utf-8') as f:
+                f.write(updated)
+            patched += 1
+    if patched:
+        print(f"Patched {patched} htmlextra report(s) for #pills-failed deep links")
+    return patched
+
+
+def generate_consolidated_report(args):
+
+    def _product_slug(name):
+        return name.lower().replace(' ', '-').replace('_', '-')
+
+    def _parse_col_entry(jf, product_slug):
+        with open(jf, 'r') as f:
+            data = json.load(f)
+        col_name = data.get('collection', {}).get('info', {}).get('name', os.path.basename(jf))
+        if not product_slug:
+            env = data.get('environment') or {}
+            env_name = env.get('name', '') if isinstance(env, dict) else ''
+            product_slug = _product_slug(env_name.split(' - ', 1)[-1]) if ' - ' in env_name else 'legacy'
+        basename_no_ext = os.path.splitext(os.path.basename(jf))[0]
+        html_href = f"{product_slug}/{basename_no_ext}.html" if product_slug != 'legacy' else f"{basename_no_ext}.html"
+
+        run = data.get('run', {})
+        stats = run.get('stats', {})
+        assertions = stats.get('assertions', {})
+        total_a = int(assertions.get('total', 0) or 0)
+        failed_a = int(assertions.get('failed', 0) or 0)
+        passed_a = max(total_a - failed_a, 0)
+
+        failure_labels = []
+        for failure in (run.get('failures') or [])[:5]:
+            err = failure.get('error') if isinstance(failure, dict) else None
+            if isinstance(err, dict):
+                label = err.get('test') or err.get('message') or ''
+                if label:
+                    failure_labels.append(str(label))
+
+        detail_href = f"{html_href}#pills-failed" if failed_a > 0 else html_href
+
+        return {
+            'name': col_name,
+            'file': html_href,
+            'detail_href': detail_href,
+            'product_slug': product_slug,
+            'assertions_total': total_a,
+            'assertions_passed': passed_a,
+            'assertions_failed': failed_a,
+            'failure_labels': failure_labels,
+            'status': 'passed' if failed_a == 0 else 'failed',
+        }
+
+    collections = []
+    postman_json_dir = getattr(args, 'postman_json_dir', None)
+    if postman_json_dir and os.path.isdir(postman_json_dir):
+        subdirs = sorted([d for d in os.listdir(postman_json_dir) if os.path.isdir(os.path.join(postman_json_dir, d))])
+        if subdirs:
+            for subdir in subdirs:
+                slug = _product_slug(subdir)
+                for jf in sorted(glob.glob(os.path.join(postman_json_dir, subdir, '*.json'))):
+                    try:
+                        collections.append(_parse_col_entry(jf, slug))
+                    except Exception as e:
+                        continue
+        for jf in sorted(glob.glob(os.path.join(postman_json_dir, '*.json'))):
+            try:
+                collections.append(_parse_col_entry(jf, 'legacy'))
+            except Exception as e:
+                continue
+    elif args.collection_links:
+        try:
+            for col in json.loads(args.collection_links):
+                f = col.get('file', '')
+                slug = f.split('/')[0] if '/' in f else 'legacy'
+                collections.append({'name': col.get('name', ''), 'file': f, 'product_slug': slug})
+        except json.JSONDecodeError:
+            pass
+
+    api_coverage = None
+    if hasattr(args, 'api_coverage_data') and args.api_coverage_data:
+        try:
+            api_coverage = json.loads(args.api_coverage_data)
+        except json.JSONDecodeError:
+            pass
+
+    status_class = "excellent" if args.status == "PASSED" else "poor"
+    status_icon = "✓" if args.status == "PASSED" else "✗"
+    status_text = "All Passed" if args.status == "PASSED" else "Failures Detected"
+    health = {'class': status_class, 'icon': status_icon, 'label': status_text}
+
+    content = '<div class="summary-grid">'
+    content += f'<div class="summary-card"><div class="value">{args.total_assertions}</div><div class="label">Total Tests</div></div>'
+    content += f'<div class="summary-card success"><div class="value">{args.passed_assertions}</div><div class="label">Passed</div></div>'
+
+    failed_class = 'error' if args.failed_assertions > 0 else 'success'
+    content += f'<div class="summary-card {failed_class}"><div class="value">{args.failed_assertions}</div><div class="label">Failed</div></div>'
+    content += f'<div class="summary-card"><div class="value">{args.total_requests}</div><div class="label">Requests</div></div>'
+
+    if api_coverage:
+        cov_pct = api_coverage.get('coverage_percent', 0)
+        cov_class = 'success' if cov_pct >= 80 else 'warning' if cov_pct >= 60 else 'error'
+        tested = api_coverage.get('tested', 0)
+        total = api_coverage.get('total', 0)
+        content += f'<div class="summary-card {cov_class}"><div class="value">{cov_pct:.0f}%</div><div class="label">API Coverage</div><div class="detail">{tested}/{total} endpoints</div></div>'
+
+    content += '</div>'
+
+    if collections:
+        collections = sorted(
+            collections,
+            key=lambda c: (0 if c.get('assertions_failed', 0) > 0 else 1, c.get('name', '')),
+        )
+
+        def _col_product(col):
+            return col.get('product_slug', 'legacy')
+
+        def _slug_to_display(slug):
+            _KNOWN = {'crm': 'CRM', 'api': 'API', 'sdk': 'SDK'}
+            if slug == 'legacy':
+                return 'Legacy'
+            return ' '.join(_KNOWN.get(w.lower(), w.capitalize()) for w in slug.replace('-', ' ').split())
+
+        products = sorted(set(_col_product(c) for c in collections))
+        real_products = [p for p in products if p != 'legacy']
+        is_multi = len(real_products) > 1
+        has_any_failures = any(c.get('assertions_failed', 0) > 0 for c in collections)
+        failure_collection_count = sum(1 for c in collections if c.get('assertions_failed', 0) > 0)
+
+        def _render_collection_row(col):
+            p = _col_product(col)
+            css_safe = p.replace('-', '_')
+            row_classes = ['cr-row']
+            if is_multi:
+                row_classes.append(f'cr-prod-row cr-prod-{css_safe}')
+            failed_a = col.get('assertions_failed', 0) or 0
+            total_a = col.get('assertions_total', 0) or 0
+            passed_a = col.get('assertions_passed', 0) or 0
+            if failed_a > 0:
+                row_classes.append('cr-has-failures')
+            href = col.get('detail_href') or col.get('file', '#')
+            link_text = 'View failures →' if failed_a > 0 else 'View Details →'
+
+            status_parts = []
+            if total_a > 0:
+                if failed_a > 0:
+                    tip = esc(', '.join(col.get('failure_labels', [])[:3]))
+                    status_parts.append(
+                        f'<span class="cr-badge cr-badge-fail" title="{tip}">{failed_a} failed</span>'
+                    )
+                    status_parts.append(
+                        f'<span class="cr-badge cr-badge-muted">{passed_a}/{total_a} passed</span>'
+                    )
+                else:
+                    status_parts.append(
+                        f'<span class="cr-badge cr-badge-pass">{total_a} passed</span>'
+                    )
+            status_html = ''.join(status_parts)
+
+            return f'''<div class="card {" ".join(row_classes)}">
+                <span class="cr-row-name">{esc(col.get('name', 'Unknown'))}</span>
+                <div class="cr-row-actions">
+                    {status_html}
+                    <a href="{href}" class="cr-row-link">{link_text}</a>
+                </div>
+            </div>'''
+
+        all_filter_groups = (real_products + (['legacy'] if 'legacy' in products else [])) if is_multi else []
+
+        style_rules = [
+            '.cr-row { display:flex; justify-content:space-between; align-items:center; gap:1rem; '
+            'padding:1rem 1.25rem; margin-bottom:0.625rem; }',
+            '.cr-row-name { font-weight:500; flex:1; min-width:0; }',
+            '.cr-row-actions { display:flex; align-items:center; gap:0.625rem; flex-shrink:0; flex-wrap:wrap; '
+            'justify-content:flex-end; }',
+            '.cr-row-link { color:var(--color-primary); text-decoration:none; font-weight:500; white-space:nowrap; }',
+            '.cr-badge { font-size:0.75rem; padding:0.25rem 0.65rem; border-radius:999px; font-weight:600; '
+            'white-space:nowrap; }',
+            '.cr-badge-pass { background:var(--color-success-bg); color:#047857; }',
+            '.cr-badge-fail { background:var(--color-error-bg); color:#b91c1c; }',
+            '.cr-badge-muted { background:#f1f5f9; color:var(--color-muted); font-weight:500; }',
+            '.cr-row.cr-has-failures { border:1px solid #fecaca; background:#fffbfb; }',
+            '.pf-bar { display:flex; gap:0.5rem; justify-content:flex-end; margin-bottom:0.75rem; flex-wrap:wrap; }',
+            '.pf-label { padding:0.35rem 0.85rem; border-radius:20px; cursor:pointer; font-size:0.85rem; '
+            'font-weight:500; border:1px solid var(--color-border); color:var(--color-muted); '
+            'background:var(--color-card); transition:all 0.15s; }',
+        ]
+        parts = ['<div class="cr-filter-wrap">']
+
+        if has_any_failures:
+            parts.append('<input type="radio" name="cr-view" id="cr-view-all" checked style="display:none;">')
+            parts.append('<input type="radio" name="cr-view" id="cr-view-failed" style="display:none;">')
+            style_rules.append(
+                '#cr-view-failed:checked ~ .cr-rows .cr-row:not(.cr-has-failures) { display: none; }'
+            )
+            style_rules.append(
+                '#cr-view-failed:checked ~ .pf-bar-view label[for="cr-view-failed"] '
+                '{ background:var(--color-error); color:#fff; border-color:var(--color-error); }'
+            )
+            style_rules.append(
+                '#cr-view-all:checked ~ .pf-bar-view label[for="cr-view-all"] '
+                '{ background:var(--color-primary); color:#fff; border-color:var(--color-primary); }'
+            )
+            parts.append(
+                f'<div class="pf-bar pf-bar-view" style="justify-content:flex-start;margin-bottom:0.5rem;">'
+                f'<label for="cr-view-all" class="pf-label">All collections</label>'
+                f'<label for="cr-view-failed" class="pf-label">Failures only '
+                f'({failure_collection_count})</label></div>'
+            )
+
+        if is_multi:
+            parts.append('<input type="radio" name="cr-pf" id="cr-pf-all" checked style="display:none;">')
+            for p in all_filter_groups:
+                css_safe = p.replace('-', '_')
+                parts.append(f'<input type="radio" name="cr-pf" id="cr-pf-{css_safe}" style="display:none;">')
+                style_rules.append(f'#cr-pf-{css_safe}:checked ~ .cr-rows .cr-prod-row:not(.cr-prod-{css_safe}) {{ display: none; }}')
+                style_rules.append(f'#cr-pf-{css_safe}:checked ~ .pf-bar-product label[for="cr-pf-{css_safe}"] {{ background:var(--color-primary); color:#fff; border-color:var(--color-primary); }}')
+            style_rules.append('#cr-pf-all:checked ~ .pf-bar-product label[for="cr-pf-all"] { background:var(--color-primary); color:#fff; border-color:var(--color-primary); }')
+
+            label_html = '<label for="cr-pf-all" class="pf-label">All</label>'
+            for p in all_filter_groups:
+                css_safe = p.replace('-', '_')
+                label_html += f'<label for="cr-pf-{css_safe}" class="pf-label">{_slug_to_display(p)}</label>'
+            parts.append(f'<div class="pf-bar pf-bar-product">{label_html}</div>')
+
+        parts.append('<div class="cr-rows">')
+        for col in collections:
+            parts.append(_render_collection_row(col))
+        parts.append('</div>')  # close cr-rows
+        parts.append('</div>')  # close cr-filter-wrap
+
+        style_block = '<style>\n' + '\n'.join(style_rules) + '\n</style>\n' if style_rules else ''
+        col_html = f'<div class="section-title">Collection Reports <span class="count">{len(collections)} collections</span></div>'
+        col_html += style_block + ''.join(parts)
+        content += f'<div class="section">{col_html}</div>'
+
+    if api_coverage:
+        gaps = api_coverage.get('gaps', [])
+        methods = api_coverage.get('by_method', {})
+
+        if methods:
+            content += '<div class="section"><div class="section-title">Coverage by HTTP Method</div>'
+            content += '<table><thead><tr><th>Method</th><th>Coverage</th><th style="width:200px;">Progress</th><th>Tested</th><th>Total</th></tr></thead><tbody>'
+            for method in ['GET', 'POST', 'PUT', 'PATCH', 'DELETE']:
+                if method in methods:
+                    m = methods[method]
+                    pct = (m['tested'] / m['total'] * 100) if m['total'] > 0 else 0
+                    bar_class = 'success' if pct >= 80 else 'warning' if pct >= 60 else 'error'
+                    content += f'''<tr>
+                        <td><span class="method-{method.lower()}">{method}</span></td>
+                        <td><strong>{pct:.0f}%</strong></td>
+                        <td><div class="progress-bar small"><div class="progress-fill {bar_class}" style="width:{pct}%;"></div></div></td>
+                        <td>{m['tested']}</td><td>{m['total']}</td>
+                    </tr>'''
+            content += '</tbody></table></div>'
+
+        if gaps:
+            content += f'<div class="section"><div class="section-title">Untested Endpoints <span class="count">{len(gaps)} gaps</span></div>'
+            content += '<table><thead><tr><th>Method</th><th style="text-align:left;">Endpoint</th><th style="text-align:left;">Controller</th></tr></thead><tbody>'
+            for gap in gaps[:15]:
+                content += f'''<tr>
+                    <td><span class="method-{gap.get('method', 'get').lower()}">{gap.get('method', 'GET')}</span></td>
+                    <td style="text-align:left;"><code>{gap.get('path', '')}</code></td>
+                    <td style="text-align:left;">{gap.get('controller', '')}</td>
+                </tr>'''
+            if len(gaps) > 15:
+                content += f'<tr><td colspan="3" style="text-align:center;color:var(--color-muted);">... and {len(gaps) - 15} more untested endpoints</td></tr>'
+            content += '</tbody></table></div>'
+
+        cov_report = api_coverage.get('full_report', '')
+        if cov_report:
+            content += f'''<div style="text-align: center; margin-top: 1rem;">
+                <a href="{cov_report}" style="color: var(--color-primary); text-decoration: none; font-weight: 500;">
+                    View Full API Coverage Report →
+                </a>
+            </div>'''
+
+    content += f'''
+    <div style="text-align: center; margin-top: 2rem; padding: 1rem; background: var(--color-card); border: 1px solid var(--color-border); border-radius: var(--radius-sm);">
+        <span style="color: var(--color-muted);">Total Duration: <strong style="color: var(--color-heading);">{args.duration}s</strong></span>
+    </div>
+    '''
+
+    logo = getattr(args, 'logo', 'Quality Reports')
+    html = get_html_template(
+        title="API Test Quality Report",
+        logo=logo,
+        content=content,
+        health_badge=health,
+        subtitle=f"{args.env} environment • {args.timestamp}",
+        footer_text="Test Results + API Coverage"
+    )
+
+    with open(args.output_file, 'w') as f:
+        f.write(html)
+
+    print(f"Report generated: {args.output_file}")
+    if api_coverage:
+        print(f"  API Coverage: {api_coverage.get('coverage_percent', 0):.0f}% ({api_coverage.get('tested', 0)}/{api_coverage.get('total', 0)} endpoints)")
+
+    patch_htmlextra_reports_for_hash_navigation(os.path.dirname(args.output_file))

package/templates/postman/scripts/lib/report_generator.py

@@ -0,0 +1,121 @@
+#!/usr/bin/env python3
+"""
+Universal HTML Report Generator
+================================
+Entry point — dispatches to the appropriate report module.
+
+Usage:
+    python3 report_generator.py migration <mapping_file> <output_file> [options]
+    python3 report_generator.py consolidated <output_file> [options]
+    python3 report_generator.py mutation <mutations_xml> <output_file>
+    python3 report_generator.py unit-test <output_file> [options]
+    python3 report_generator.py combined <output_file> [options]
+    python3 report_generator.py css
+"""
+
+import sys
+import os
+import argparse
+from datetime import datetime
+
+# Ensure lib/ is on the path when invoked directly
+sys.path.insert(0, os.path.dirname(__file__))
+
+from report_utils import SHARED_CSS
+from report_migration import generate_migration_report
+from report_consolidated import generate_consolidated_report
+from report_mutation import generate_mutation_report
+from report_unit import generate_unit_test_report
+from report_combined import generate_combined_report
+
+DEFAULT_LOGO = 'Quality Reports'
+
+
+def main():
+    parser = argparse.ArgumentParser(description='Universal Report Generator')
+    subparsers = parser.add_subparsers(dest='command', help='Report type')
+
+    subparsers.add_parser('css', help='Print shared CSS')
+
+    mig = subparsers.add_parser('migration', help='Generate migration report')
+    mig.add_argument('mapping_file')
+    mig.add_argument('output_file')
+    mig.add_argument('--logo', default=DEFAULT_LOGO)
+    mig.add_argument('--source-folder', required=True)
+    mig.add_argument('--postman-folder', required=True)
+    mig.add_argument('--source-files', type=int, default=0)
+    mig.add_argument('--source-tests', type=int, default=0)
+    mig.add_argument('--source-suites', type=int, default=0)
+    mig.add_argument('--postman-files', type=int, default=0)
+    mig.add_argument('--postman-requests', type=int, default=0)
+    mig.add_argument('--postman-assertions', type=int, default=0)
+    mig.add_argument('--postman-only-file')
+    mig.add_argument('--postman-scenarios')
+
+    con = subparsers.add_parser('consolidated', help='Generate API test quality report')
+    con.add_argument('output_file')
+    con.add_argument('--logo', default=DEFAULT_LOGO)
+    con.add_argument('--env', default='local')
+    con.add_argument('--timestamp', default=datetime.now().strftime('%Y%m%d-%H%M%S'))
+    con.add_argument('--total-assertions', type=int, default=0)
+    con.add_argument('--passed-assertions', type=int, default=0)
+    con.add_argument('--failed-assertions', type=int, default=0)
+    con.add_argument('--total-requests', type=int, default=0)
+    con.add_argument('--duration', default='0')
+    con.add_argument('--status', default='PASSED', choices=['PASSED', 'FAILED'])
+    con.add_argument('--collection-links')
+    con.add_argument('--postman-json-dir')
+    con.add_argument('--api-coverage-data')
+
+    mut = subparsers.add_parser('mutation', help='Generate mutation report')
+    mut.add_argument('mutations_xml')
+    mut.add_argument('output_file')
+    mut.add_argument('--logo', default=DEFAULT_LOGO)
+
+    unit = subparsers.add_parser('unit-test', help='Generate unit test quality report')
+    unit.add_argument('output_file')
+    unit.add_argument('--logo', default=DEFAULT_LOGO)
+    unit.add_argument('--surefire-dir')
+    unit.add_argument('--jacoco-xml')
+    unit.add_argument('--mutations-xml')
+
+    comb = subparsers.add_parser('combined', help='Generate combined quality report')
+    comb.add_argument('output_file')
+    comb.add_argument('--logo', default=DEFAULT_LOGO)
+    comb.add_argument('--surefire-dir')
+    comb.add_argument('--jacoco-xml')
+    comb.add_argument('--mutations-xml')
+    comb.add_argument('--postman-assertions-total', type=int, default=0)
+    comb.add_argument('--postman-assertions-passed', type=int, default=0)
+    comb.add_argument('--postman-assertions-failed', type=int, default=0)
+    comb.add_argument('--postman-requests', type=int, default=0)
+    comb.add_argument('--postman-duration', default='0')
+    comb.add_argument('--postman-collections-passed', type=int, default=0)
+    comb.add_argument('--postman-collections-failed', type=int, default=0)
+    comb.add_argument('--api-coverage-file')
+    comb.add_argument('--api-coverage-html')
+    comb.add_argument('--postman-json-dir')
+    comb.add_argument('--postman-consolidated-html')
+    comb.add_argument('--env', default=None)
+    comb.add_argument('--timestamp', default=None)
+
+    args = parser.parse_args()
+
+    if args.command == 'css':
+        print(SHARED_CSS)
+    elif args.command == 'migration':
+        generate_migration_report(args)
+    elif args.command == 'consolidated':
+        generate_consolidated_report(args)
+    elif args.command == 'mutation':
+        generate_mutation_report(args)
+    elif args.command == 'unit-test':
+        generate_unit_test_report(args)
+    elif args.command == 'combined':
+        generate_combined_report(args)
+    else:
+        parser.print_help()
+
+
+if __name__ == '__main__':
+    main()

package/templates/postman/scripts/lib/report_migration.py

@@ -0,0 +1,156 @@
+"""
+Migration report generator — compares source test files to Postman collections.
+"""
+
+import os
+from html import escape as esc
+from report_utils import get_html_template
+
+
+def generate_migration_report(args):
+    mappings = []
+    with open(args.mapping_file, 'r') as f:
+        for line in f:
+            line = line.strip()
+            if not line:
+                continue
+            parts = line.split('|')
+            if len(parts) >= 5:
+                mappings.append({
+                    'filename': parts[0],
+                    'folder': parts[1],
+                    'test_count': parts[2],
+                    'status': parts[3],
+                    'collection': parts[4] if len(parts) > 4 else ''
+                })
+
+    postman_only = []
+    if args.postman_only_file and os.path.exists(args.postman_only_file):
+        with open(args.postman_only_file, 'r') as f:
+            for line in f:
+                line = line.strip()
+                if not line:
+                    continue
+                parts = line.split('|')
+                if len(parts) >= 5:
+                    postman_only.append({
+                        'filename': parts[0],
+                        'folder': parts[1],
+                        'name': parts[2],
+                        'requests': parts[3],
+                        'assertions': parts[4]
+                    })
+
+    total_source = len(mappings)
+    migrated = sum(1 for m in mappings if m['status'] == 'MIGRATED')
+    partial = sum(1 for m in mappings if m['status'] == 'PARTIAL')
+    not_found = sum(1 for m in mappings if m['status'] == 'NOT_FOUND')
+
+    if not_found == 0 and partial == 0 and migrated > 0:
+        health = {'class': 'excellent', 'icon': '🟢', 'label': 'Complete'}
+        migration_percent = 100
+        health_desc = "All source tests have been fully migrated"
+    elif not_found == 0 and partial > 0:
+        health = {'class': 'good', 'icon': '🟡', 'label': 'Mostly Complete'}
+        migration_percent = (migrated * 100 + partial * 50) // total_source if total_source > 0 else 100
+        health_desc = f"{partial} file(s) have partial matches"
+    elif total_source > 0 and migrated * 100 // total_source >= 70:
+        health = {'class': 'good', 'icon': '🟡', 'label': 'In Progress'}
+        migration_percent = migrated * 100 // total_source
+        health_desc = f"{not_found} file(s) still need migration"
+    else:
+        health = {'class': 'poor', 'icon': '🔴', 'label': 'In Progress'}
+        migration_percent = migrated * 100 // total_source if total_source > 0 else 0
+        health_desc = f"Significant gaps - {not_found} file(s) not migrated"
+
+    progress_class = "success" if migration_percent >= 90 else "warning" if migration_percent >= 70 else "error"
+    progress_color = "var(--color-success)" if migration_percent >= 90 else "var(--color-warning)" if migration_percent >= 70 else "var(--color-error)"
+
+    content = f'''
+    <div class="progress-container">
+        <div class="progress-header">
+            <span class="progress-title">Migration Progress</span>
+            <span class="progress-value" style="color: {progress_color};">{migration_percent}%</span>
+        </div>
+        <div class="progress-bar">
+            <div class="progress-fill {progress_class}" style="width: {migration_percent}%;"></div>
+        </div>
+        <p style="margin-top: 0.75rem; color: var(--color-muted); font-size: 0.85rem;">{health_desc}</p>
+    </div>
+
+    <div class="summary-grid">
+        <div class="summary-card health {health['class']}">
+            <div class="icon">{health['icon']}</div>
+            <div class="value" style="font-size: 1.5rem;">{health['label']}</div>
+            <div class="label">Status</div>
+        </div>
+        <div class="summary-card success">
+            <div class="value">{migrated}</div>
+            <div class="label">Migrated</div>
+        </div>
+        <div class="summary-card {'warning' if partial > 0 else ''}">
+            <div class="value">{partial}</div>
+            <div class="label">Partial</div>
+        </div>
+        <div class="summary-card {'error' if not_found > 0 else 'success'}">
+            <div class="value">{not_found}</div>
+            <div class="label">Not Migrated</div>
+        </div>
+    </div>
+
+    <div class="section">
+        <div class="section-title">Source vs Target Comparison</div>
+        <div class="grid-3">
+            <div class="card">
+                <h4 style="color: var(--color-muted); font-size: 0.85rem; text-transform: uppercase; margin-bottom: 0.875rem;">Source (JavaScript/Mocha)</h4>
+                <div style="font-size: 2.5rem; font-weight: 700; color: var(--color-muted);">{args.source_files}</div>
+                <div style="color: var(--color-muted); font-size: 0.85rem;">Files</div>
+                <div style="margin-top: 0.5rem; font-size: 0.9rem;"><strong>{args.source_tests}</strong> tests • <strong>{args.source_suites}</strong> suites</div>
+            </div>
+            <div class="card">
+                <h4 style="color: var(--color-muted); font-size: 0.85rem; text-transform: uppercase; margin-bottom: 0.875rem;">Target (Postman)</h4>
+                <div style="font-size: 2.5rem; font-weight: 700; color: var(--color-success);">{args.postman_files}</div>
+                <div style="color: var(--color-muted); font-size: 0.85rem;">Collections</div>
+                <div style="margin-top: 0.5rem; font-size: 0.9rem;"><strong>{args.postman_requests}</strong> requests • <strong>{args.postman_assertions}</strong> assertions</div>
+            </div>
+            <div class="card">
+                <h4 style="color: var(--color-muted); font-size: 0.85rem; text-transform: uppercase; margin-bottom: 0.875rem;">Postman-Only (New)</h4>
+                <div style="font-size: 2.5rem; font-weight: 700; color: var(--color-primary);">{len(postman_only)}</div>
+                <div style="color: var(--color-muted); font-size: 0.85rem;">Collections</div>
+            </div>
+        </div>
+    </div>
+
+    <div class="section">
+        <div class="section-title">Detailed Mapping <span class="count">{total_source} files</span></div>
+        <table>
+            <thead><tr><th>Source File</th><th>Folder</th><th style="text-align:center;">Tests</th><th style="text-align:center;">Status</th><th>Target Collection(s)</th></tr></thead>
+            <tbody>
+    '''
+
+    for m in mappings:
+        badge_class = 'success' if m['status'] == 'MIGRATED' else 'warning' if m['status'] == 'PARTIAL' else 'error'
+        collection = m['collection'] if m['collection'] else '—'
+        content += f'''<tr>
+            <td class="code">{m['filename']}</td>
+            <td>{m['folder']}</td>
+            <td class="center">{m['test_count']}</td>
+            <td class="center"><span class="badge badge-{badge_class}">{m['status']}</span></td>
+            <td class="code">{collection}</td>
+        </tr>'''
+
+    content += '</tbody></table></div>'
+
+    html = get_html_template(
+        title="API Test Migration Report",
+        logo=getattr(args, 'logo', 'Quality Reports'),
+        content=content,
+        health_badge=health,
+        subtitle=f"Source: {os.path.basename(args.source_folder)} → Target: {os.path.basename(args.postman_folder)}",
+        footer_text="Generated by Migration Report Generator"
+    )
+
+    with open(args.output_file, 'w') as f:
+        f.write(html)
+
+    print(f"Report generated: {args.output_file}")