scryer 1.0.0 → 1.2.0

data/lib/scryer/report_renderer.rb

@@ -12,7 +12,15 @@ module Scryer
   class ReportRenderer
     SEVERITY_ORDER = %w[critical warning info].freeze
     SEVERITY_LABELS = { "critical" => "Critical", "warning" => "Warning", "info" => "Info" }.freeze
-    CSV_HEADERS = %w[kind identifier severity location message suggested_fix code_snippet url].freeze
+    CSV_HEADERS = %w[kind identifier severity confidence cwe owasp_category location message
+                      suggested_fix code_snippet url].freeze
+
+    # Tiebreak within the same severity for top_risks — a critical finding
+    # is a critical finding regardless of category, but when severity is
+    # equal this is the order that best matches "what's actually riskiest":
+    # a security hole, then a known-vulnerable dependency, ahead of a
+    # performance or style issue at the same nominal severity.
+    CATEGORY_RISK_PRIORITY = { "security" => 0, "dependency" => 1, "performance" => 2, "code quality" => 3 }.freeze
 
     # `dependency_findings` is an optional array of Scryer::DependencyAudit::
     # Finding (insecure_sources + vulnerable_gems) — pass it to fold a
@@ -46,7 +54,9 @@ module Scryer
         "performance_findings" => @result.performance_findings.map(&:to_h),
         "style_findings" => @result.style_findings.map(&:to_h),
         "duplicate_groups" => @result.duplicate_groups.map { |g| duplicate_group_hash(g) },
-        "dependency_findings" => @dependency_findings.map(&:to_h)
+        "dependency_findings" => @dependency_findings.map(&:to_h),
+        "security_score" => security_score,
+        "rules_clean_rate" => rules_clean_rate
       }
     end
 
@@ -54,6 +64,121 @@ module Scryer
       JSON.pretty_generate(as_hash)
     end
 
+    DEFAULT_TOP_RISKS_LIMIT = 5
+
+    # This is what actually backs "tells you what to fix first" — Scryer's
+    # categories (security, dependencies, performance, code quality) each
+    # already carry a severity ("critical"/"warning"/"info"), but they're
+    # scanned and reported separately; nothing ranks across them. top_risks
+    # merges every severity-bearing finding (rule-based + dependency) into
+    # one list, sorted by severity first and then by category (a security
+    # hole outranks a stylistic one at the same severity) — pure aggregation
+    # of data every format already has, no new detection logic. Used by the
+    # console summary (CLI + rake) and the top of the HTML report; JSON/CSV/
+    # SARIF are consumed by other tools that do their own sorting/filtering,
+    # so this stays a display-only convenience rather than a new field there.
+    def top_risks(limit: DEFAULT_TOP_RISKS_LIMIT)
+      h = as_hash
+      entries = []
+      h["security_findings"].each { |f| entries << finding_risk_entry("security", f) }
+      h["performance_findings"].each { |f| entries << finding_risk_entry("performance", f) }
+      h["style_findings"].each { |f| entries << finding_risk_entry("code quality", f) }
+      h["dependency_findings"].each { |f| entries << dependency_risk_entry(f) }
+
+      entries.sort_by { |e| [SEVERITY_ORDER.index(e[:severity]) || SEVERITY_ORDER.size, CATEGORY_RISK_PRIORITY[e[:category]] || 99] }
+             .first(limit)
+    end
+
+    # How many of this scan's security findings fall into each OWASP Top 10
+    # (2021) category — [[category, count], ...] sorted by count descending.
+    # A byproduct of every security rule already carrying an owasp_category
+    # (see Rule.owasp_category) rather than new detection logic: this is
+    # purely "count what's already tagged," not a separate audit against
+    # OWASP's own benchmark suite or certification of any kind. Scryer's
+    # CWE/OWASP tags are its own best-effort categorization for practitioner
+    # convenience and compliance-reporting purposes (e.g. "does our tooling
+    # catch OWASP category X" conversations) — not an OWASP-endorsed mapping
+    # and not independently audited; see the README for the caveat in full.
+    def owasp_coverage
+      counts = Hash.new(0)
+      as_hash["security_findings"].each { |f| counts[f["owasp_category"]] += 1 if f["owasp_category"] }
+      counts.sort_by { |category, count| [-count, category] }
+    end
+
+    # A single 0-100 number (plus a letter grade) summarizing this scan's
+    # security risk exposure — security findings and dependency findings
+    # only (performance/code-quality findings aren't security risk, so
+    # they're deliberately excluded; a slow app doesn't lower a *security*
+    # score). Deliberately NOT normalized by files-scanned or lines of code:
+    # it reflects this scan's absolute finding exposure, so it's meaningful
+    # for tracking one project's trend over time (does the next scan score
+    # higher or lower), not for comparing two differently-sized codebases
+    # against each other — a bigger app with the same finding *density* will
+    # naturally score lower here, and that's a documented limitation, not a
+    # bug.
+    #
+    # Exponential decay rather than linear subtraction from 100: a single
+    # critical/high finding should visibly move the score (100 -> ~86) without
+    # a handful of findings driving a real app straight to a hard-clamped 0,
+    # which would make the score useless for comparing "bad" against "worse."
+    # weighted_penalty combines severity (the dominant factor) with
+    # confidence (a low-confidence rule's finding shouldn't hurt the score as
+    # much as a high-confidence one saying the same severity) — same
+    # philosophy as SARIF's `rank` (see sarif_rank above), computed once here
+    # for a single scan-level number instead of per-result.
+    SCORE_SEVERITY_WEIGHT = { "critical" => 15, "warning" => 6, "info" => 1 }.freeze
+    SCORE_CONFIDENCE_WEIGHT = { "high" => 1.0, "medium" => 0.7, "low" => 0.4 }.freeze
+    SCORE_DECAY_CONSTANT = 100.0
+
+    # Deliberately reads @result/@dependency_findings directly rather than
+    # going through as_hash — as_hash includes this method's own output (so
+    # JSON consumers get the score without a separate call), and as_hash
+    # calling security_score while security_score called as_hash would
+    # recurse forever.
+    def security_score
+      # .to_h (not the full as_hash) so this works uniformly across Finding
+      # (has "confidence") and DependencyAudit::Finding (doesn't — a plain
+      # Hash returns nil for a missing key rather than raising, unlike
+      # calling #confidence directly on a struct that has no such member).
+      findings = (@result.security_findings + @dependency_findings).map(&:to_h)
+
+      weighted_penalty = findings.sum do |f|
+        (SCORE_SEVERITY_WEIGHT[f["severity"]] || 3) * (SCORE_CONFIDENCE_WEIGHT[f["confidence"]] || 0.7)
+      end
+
+      score = (100 * Math.exp(-weighted_penalty / SCORE_DECAY_CONSTANT)).round
+      { "score" => score, "grade" => score_grade(score), "finding_count" => findings.size }
+    end
+
+    SCORE_GRADE_BANDS = [[90, "A"], [80, "B"], [70, "C"], [60, "D"]].freeze
+
+    def score_grade(score)
+      SCORE_GRADE_BANDS.each { |threshold, grade| return grade if score >= threshold }
+      "F"
+    end
+
+    # "N/M rules clean" — how many of the registered Scryer::Rule checks
+    # (security + performance + style; NOT the dependency checks, which
+    # aren't backed by a Rule subclass at all — see DEPENDENCY_SARIF_RULES)
+    # fired zero findings in this scan, out of every rule that exists to
+    # fire. A rule-level pass rate, distinct from security_score (which is
+    # finding-weighted, not rule-counted) — a codebase can have a high clean
+    # rate (few distinct rules triggered) and still a low score (the few
+    # that did trigger were severe/high-confidence), or the reverse (many
+    # different rules each firing once, none of them serious). Report both;
+    # neither alone tells the whole story.
+    def rules_clean_rate
+      all_rule_ids = Scryer::RuleSet.all.map(&:rule_id)
+      fired_rule_ids = (@result.security_findings + @result.performance_findings + @result.style_findings)
+                       .map(&:rule_id).uniq
+
+      total = all_rule_ids.size
+      clean = total - (all_rule_ids & fired_rule_ids).size
+      percent = total.zero? ? 100.0 : (clean.to_f / total * 100).round(1)
+
+      { "clean" => clean, "total" => total, "percent" => percent }
+    end
+
     # Flat, one-row-per-finding CSV — security + performance findings plus
     # any dependency findings, in that order — for dropping into a
     # spreadsheet or importing into a ticketing tool. Deliberately excludes
@@ -111,6 +236,8 @@ module Scryer
             #{h["parse_errors"].any? ? "&middot; <span class=\"crit\">#{h["parse_errors"].size} parse error(s)</span>" : ""}
           </p>
 
+          #{render_executive_summary(h, h["security_score"], h["rules_clean_rate"])}
+
           #{render_toc(h)}
 
           <section id="overview">
@@ -123,8 +250,13 @@ module Scryer
             #{render_summary_table(security, performance, style, duplicate_groups, dependency_findings)}
           </section>
 
+          <section id="owasp-coverage">
+            <h2>OWASP Top 10 (2021) coverage</h2>
+            #{render_owasp_coverage(owasp_coverage)}
+          </section>
+
           <section id="checks-performed">
-            <h2>Checks performed</h2>
+            <h2>Checks performed #{expand_collapse_controls("#checks-performed")}</h2>
             #{render_checks_performed}
           </section>
 
@@ -135,16 +267,20 @@ module Scryer
 
           <section id="findings">
             <h2>Findings (#{all_findings.size}) #{expand_collapse_controls("#findings")}</h2>
+
+            <input type="search" id="findings-search" class="findings-search"
+                   placeholder="Filter by rule, file, or message text&hellip;" aria-label="Filter findings">
+
+            <div id="top-priorities">
+              <h3>Top priorities — fix these first</h3>
+              #{render_top_priorities(top_risks)}
+            </div>
+
             #{render_severity_section("critical", by_severity["critical"] || [])}
             #{render_severity_section("warning", by_severity["warning"] || [])}
             #{render_severity_section("info", by_severity["info"] || [])}
           </section>
 
-          <section id="duplicates">
-            <h2>Duplicate code groups (#{duplicate_groups.size}) #{expand_collapse_controls("#duplicates")}</h2>
-            #{render_duplicate_groups(duplicate_groups)}
-          </section>
-
           <section id="dependency-audit">
             <h2>Dependency audit (#{dependency_findings.size}) #{expand_collapse_controls("#dependency-audit")}</h2>
             #{render_dependency_findings(dependency_findings)}
@@ -155,10 +291,13 @@ module Scryer
             #{render_parse_errors(h["parse_errors"])}
           </section>
 
+          <section id="duplicates">
+            <h2>Duplicate code groups (#{duplicate_groups.size}) #{expand_collapse_controls("#duplicates")}</h2>
+            #{render_duplicate_groups(duplicate_groups)}
+          </section>
+
           <p class="footer">
-            Generated by Scryer v#{h["scryer_version"]} (Ruby #{escape(h["ruby_version"])}) &middot;
-            heuristic static analysis, not full data-flow/taint analysis — review every finding in
-            its surrounding context before acting on it.
+            Generated by Scryer v#{h["scryer_version"]} (Ruby #{escape(h["ruby_version"])})
           </p>
 
           <script>#{JS}</script>
@@ -174,16 +313,72 @@ module Scryer
         <nav class="toc">
           <a href="#overview">Overview</a>
           <a href="#summary">Summary</a>
+          <a href="#owasp-coverage">OWASP Top 10 coverage</a>
           <a href="#checks-performed">Checks performed</a>
           <a href="#warnings-by-type">Warnings by type</a>
           <a href="#findings">Findings</a>
-          <a href="#duplicates">Duplicate code (#{h["duplicate_groups"].size})</a>
+          <a href="#top-priorities">Top priorities</a>
           <a href="#dependency-audit">Dependency audit (#{h["dependency_findings"].size})</a>
           <a href="#errors">Parse errors (#{h["parse_errors"].size})</a>
+          <a href="#duplicates">Duplicate code (#{h["duplicate_groups"].size})</a>
         </nav>
       HTML
     end
 
+    # The score badge + severity bar chart at the very top of the report —
+    # an "is this bad or fine" answer in the first thing a reader sees,
+    # ahead of even the table of contents. Scoped to security + dependency
+    # findings only, same as ReportRenderer#security_score itself
+    # (performance/code-quality findings aren't part of the security score,
+    # so they're not part of this chart either — the Summary table further
+    # down still shows those breakdowns).
+    def render_executive_summary(h, score, clean_rate)
+      sec_and_deps = h["security_findings"] + h["dependency_findings"]
+      by_severity = Hash.new(0)
+      sec_and_deps.each { |f| by_severity[f["severity"]] += 1 }
+      total = by_severity.values.sum
+
+      # Links to the matching #sev-critical/#sev-warning/#sev-info heading
+      # already rendered under Findings (render_severity_section) — a plain
+      # anchor jump, no JS needed (the existing hashchange handler already
+      # scrolls to it). Slightly imprecise for one reason worth being
+      # explicit about: this bar's count includes dependency findings (see
+      # sec_and_deps above), but #sev-* only groups security/performance/
+      # style findings — dependency findings live in the separate
+      # "Dependency audit" section with no severity-grouped anchors of their
+      # own. Still the right destination for the bulk of what's counted;
+      # dependency findings are one section away via the TOC.
+      bars = SEVERITY_ORDER.map do |sev|
+        count = by_severity[sev]
+        pct = total.zero? ? 0 : (count.to_f / total * 100).round(1)
+        <<~BAR
+          <div class="score-bar-row">
+            <span class="score-bar-label">#{SEVERITY_LABELS[sev]}</span>
+            <div class="score-bar-track"><div class="score-bar-fill #{sev}" style="width: #{pct}%"></div></div>
+            <a href="##{"sev-#{sev}"}" class="score-bar-count">#{count}</a>
+          </div>
+        BAR
+      end.join
+
+      <<~HTML
+        <div class="score-panel">
+          <div class="score-badge grade-#{score["grade"]}">
+            <span class="score-number">#{score["score"]}</span>
+            <span class="score-grade">#{score["grade"]}</span>
+          </div>
+          <div class="score-details">
+            <p class="score-label">Security Score — #{score["finding_count"]} security + dependency
+              finding(s), weighted by severity and this rule's confidence. Not normalized by app
+              size — see the README for what this number does and doesn't mean.
+              <strong>#{clean_rate["clean"]}/#{clean_rate["total"]}</strong> rules clean
+              (#{clean_rate["percent"]}%) — a rule-level pass rate, a different (and not always
+              matching) signal from the finding-weighted score.</p>
+            #{bars}
+          </div>
+        </div>
+      HTML
+    end
+
     def render_overview_table(h)
       rows = {
         "Project" => h["project_name"],
@@ -207,26 +402,66 @@ module Scryer
       total_counts = SEVERITY_ORDER.each_with_object({}) { |s, acc| acc[s] = sec_counts[s] + perf_counts[s] + style_counts[s] }
 
       header = "<tr><th>Category</th>" + SEVERITY_ORDER.map { |s| "<th>#{SEVERITY_LABELS[s]}</th>" }.join + "<th>Total</th></tr>"
-      sec_row = summary_row("Security", sec_counts)
-      perf_row = summary_row("Performance", perf_counts)
-      style_row = summary_row("Style", style_counts)
-      total_row = summary_row("Total", total_counts, css_class: "total")
-      dup_row = "<tr><th>Duplicate code</th><td colspan=\"#{SEVERITY_ORDER.size}\">—</td><td>#{duplicate_groups.size} group(s)</td></tr>"
-      deps_row = "<tr><th>Dependency audit</th><td colspan=\"#{SEVERITY_ORDER.size}\">—</td><td>#{dependency_findings.size} finding(s)</td></tr>"
+      # Category rows link via the same search-filter mechanism as the OWASP
+      # coverage table (a "security"/"performance"/"style" tag was added to
+      # every finding specifically so this can match precisely — see
+      # render_finding_tags) — a cell like "Security × Critical" has no
+      # existing anchor of its own to jump to, unlike a plain severity total.
+      sec_row = summary_row("Security", sec_counts, filter_term: "security")
+      perf_row = summary_row("Performance", perf_counts, filter_term: "performance")
+      style_row = summary_row("Style", style_counts, filter_term: "style")
+      # The Total row has no single category tag to filter by (it's the sum
+      # across all three), so its per-severity cells link straight to the
+      # matching #sev-* heading instead — same anchors, same precision, as
+      # the severity distribution chart at the top of the report.
+      total_row = summary_row("Total", total_counts, css_class: "total", severity_anchors: true)
+      dup_row = "<tr><th>Duplicate code</th><td colspan=\"#{SEVERITY_ORDER.size}\">—</td>" \
+                "<td><a class=\"jump-link\" href=\"#duplicates\">#{duplicate_groups.size} group(s)</a></td></tr>"
+      deps_row = "<tr><th>Dependency audit</th><td colspan=\"#{SEVERITY_ORDER.size}\">—</td>" \
+                 "<td><a class=\"jump-link\" href=\"#dependency-audit\">#{dependency_findings.size} finding(s)</a></td></tr>"
 
       "<table class=\"summary\">#{header}#{sec_row}#{perf_row}#{style_row}#{dup_row}#{deps_row}#{total_row}</table>"
     end
 
-    def summary_row(label, counts, css_class: nil)
-      cells = SEVERITY_ORDER.map { |s| "<td>#{counts[s]}</td>" }.join
+    def summary_row(label, counts, css_class: nil, filter_term: nil, severity_anchors: false)
+      cells = SEVERITY_ORDER.map do |s|
+        if severity_anchors
+          "<td><a class=\"jump-link\" href=\"#sev-#{s}\">#{counts[s]}</a></td>"
+        elsif filter_term
+          "<td><a href=\"#findings\" class=\"filter-link\" data-filter=\"#{filter_term} #{s}\">#{counts[s]}</a></td>"
+        else
+          "<td>#{counts[s]}</td>"
+        end
+      end.join
       total = counts.values.sum
-      "<tr#{css_class ? " class=\"#{css_class}\"" : ""}><th>#{escape(label)}</th>#{cells}<td>#{total}</td></tr>"
+      total_cell = filter_term ? "<a href=\"#findings\" class=\"filter-link\" data-filter=\"#{filter_term}\">#{total}</a>" : total
+      "<tr#{css_class ? " class=\"#{css_class}\"" : ""}><th>#{escape(label)}</th>#{cells}<td>#{total_cell}</td></tr>"
     end
 
     def count_by_severity(findings)
       SEVERITY_ORDER.each_with_object(Hash.new(0)) { |s, acc| acc[s] = findings.count { |f| f["severity"] == s } }
     end
 
+    def render_owasp_coverage(coverage)
+      return "<p class=\"muted\">No security findings — nothing to categorize.</p>" if coverage.empty?
+
+      # The count links into the same Findings search box render_finding_tags
+      # feeds (see that method's comment) — clicking jumps to #findings and
+      # fills/triggers the search with this exact category string, so
+      # "detailed information" for a category is "the matching findings
+      # themselves," not a second, separately-maintained breakdown view.
+      rows = coverage.map do |category, count|
+        "<tr><td>#{escape(category)}</td>" \
+        "<td><a href=\"#findings\" class=\"filter-link\" data-filter=\"#{escape(category)}\">#{count}</a></td></tr>"
+      end.join
+
+      "<table class=\"summary\"><tr><th>Category</th><th>Findings</th></tr>#{rows}</table>" \
+      "<p class=\"muted\">Scryer's own best-effort categorization of each rule's findings, for a " \
+      "quick answer to \"does this cover OWASP category X\" — not an OWASP-endorsed or " \
+      "independently audited mapping. See the README for details. Click a count to see those " \
+      "findings.</p>"
+    end
+
     def rules_by_category
       Scryer::RuleSet.all.group_by(&:category)
     end
@@ -235,14 +470,31 @@ module Scryer
       Scryer::RuleSet.all.each_with_object({}) { |r, acc| acc[r.rule_id] = r.title }
     end
 
+    # Collapsed by default, same as render_rule_group — this is reference
+    # material (every rule that *can* fire, not what actually did), and with
+    # 26 security rules alone, showing all three category tables expanded by
+    # default buried the sections a reader actually came for (Findings,
+    # Top priorities) under a wall of rows nobody needed to see up front.
     def render_checks_performed
-      security_rules = rules_by_category["security"] || []
-      performance_rules = rules_by_category["performance"] || []
-      style_rules = rules_by_category["style"] || []
+      [
+        checks_accordion("checks-security", "Security", rules_by_category["security"] || []),
+        checks_accordion("checks-performance", "Performance", rules_by_category["performance"] || []),
+        checks_accordion("checks-style", "Style", rules_by_category["style"] || [])
+      ].join
+    end
 
-      "<h3>Security (#{security_rules.size})</h3>#{checks_table(security_rules)}" \
-      "<h3>Performance (#{performance_rules.size})</h3>#{checks_table(performance_rules)}" \
-      "<h3>Style (#{style_rules.size})</h3>#{checks_table(style_rules)}"
+    def checks_accordion(anchor, label, rules)
+      <<~HTML
+        <div class="accordion" id="#{anchor}">
+          <button type="button" class="accordion-header">
+            <span>#{escape(label)}</span>
+            <span class="accordion-meta">#{rules.size} rule#{"s" unless rules.size == 1}<span class="chevron">&#9656;</span></span>
+          </button>
+          <div class="accordion-body">
+            #{checks_table(rules)}
+          </div>
+        </div>
+      HTML
     end
 
     def checks_table(rules)
@@ -269,7 +521,7 @@ module Scryer
         "<td>#{escape(titles[rule_id] || rule_id)}</td>" \
         "<td>#{escape(findings.first["category"])}</td>" \
         "<td><span class=\"badge #{worst}\">#{SEVERITY_LABELS[worst]}</span></td>" \
-        "<td>#{findings.size}</td></tr>"
+        "<td><a class=\"jump-link\" href=\"##{anchor}\">#{findings.size}</a></td></tr>"
       end.join
 
       "<table class=\"checks\"><tr><th>Rule ID</th><th>Description</th><th>Category</th>" \
@@ -363,13 +615,47 @@ module Scryer
             <code>#{escape(f["rule_id"])}</code>
             <span class="loc">#{escape(f["file"])}#{f["line"] ? ":#{f["line"]}" : ""}</span>
           </div>
+          #{render_finding_tags(f)}
           <p>#{escape(f["message"])}</p>
           #{f["code_snippet"] ? "<pre>#{escape(f["code_snippet"])}</pre>" : ""}
           <div class="fix"><strong>Suggested fix:</strong>#{render_markdown(f["suggested_fix"])}</div>
+          #{render_fix_verified_badge(f["fix_verified"])}
         </div>
       ROW
     end
 
+    # fix_verified is only ever non-nil when an ai_client is configured (see
+    # AiFixSuggester/FixVerifier) — nil (the default for every finding
+    # otherwise) renders nothing at all, so a report from a scan with no AI
+    # client configured looks exactly like it did before this existed.
+    def render_fix_verified_badge(fix_verified)
+      case fix_verified
+      when true
+        "<p class=\"fix-verified verified\">&#10003; AI fix verified — re-scanning with this " \
+          "fix applied, the rule no longer fires here.</p>"
+      when false
+        "<p class=\"fix-verified unverified\">&#10007; AI fix NOT verified — re-scanning with " \
+          "this fix applied, the rule still fires (or the rewritten line didn't parse). Review " \
+          "before using it.</p>"
+      else
+        ""
+      end
+    end
+
+    # CWE/owasp_category are security-only (nil for performance/style
+    # findings — see Rule.cwe/owasp_category); confidence applies to every
+    # category. Rendered as plain text tags specifically so the existing
+    # Findings search box (which matches on each .finding's textContent)
+    # can filter by any of them for free — typing "A01" or "CWE-89" into
+    # that box is the actual answer to "how do I see which findings are in
+    # OWASP category X," not a separate feature.
+    def render_finding_tags(f)
+      tags = [f["category"], f["cwe"], f["owasp_category"], f["confidence"] && "#{f["confidence"]} confidence"].compact
+      return "" if tags.empty?
+
+      "<p class=\"finding-tags\">#{tags.map { |t| "<span class=\"tag\">#{escape(t)}</span>" }.join}</p>"
+    end
+
     KIND_LABELS = {
       "method_duplicate" => "Method duplicate",
       "query_duplicate" => "Query duplicate",
@@ -407,17 +693,23 @@ module Scryer
     # patched_versions/message/suggested_fix) — a different shape from the
     # rule-based Finding hashes rendered by render_finding, so this has its
     # own layout rather than reusing render_severity_section.
+    # One accordion per finding, collapsed by default — same pattern as
+    # render_rule_group under Findings and the Checks-performed tables.
+    # Previously these rendered as always-expanded `.finding` divs with no
+    # `.accordion` wrapper at all, so the "Expand all"/"Collapse all"
+    # buttons on this section's heading (added when every other section got
+    # the same controls) had nothing to actually expand or collapse.
     def render_dependency_findings(dependency_findings)
       return "<p class=\"muted\">None detected (run with dependency auditing enabled to check " \
              "Gemfile.lock against OSV.dev and for insecure git/http sources).</p>" if dependency_findings.empty?
 
       sorted = dependency_findings.sort_by { |f| [SEVERITY_ORDER.index(f["severity"]) || 99, f["gem_name"].to_s] }
-      rows = sorted.map { |f| render_dependency_finding(f) }.join
+      rows = sorted.each_with_index.map { |f, index| render_dependency_finding(f, index) }.join
 
       "<div class=\"dep-list\">#{rows}</div>"
     end
 
-    def render_dependency_finding(f)
+    def render_dependency_finding(f, index)
       severity = f["severity"]
       heading = f["kind"] == "insecure_source" ? "Insecure gem source" : "#{escape(f["gem_name"])} #{escape(f["installed_version"])}"
       advisory_text = [f["advisory_id"], f["title"]].compact.map { |t| escape(t) }.join(" — ")
@@ -425,18 +717,65 @@ module Scryer
       link = f["url"] ? " &middot; <a href=\"#{escape(f["url"])}\" target=\"_blank\" rel=\"noopener\">advisory</a>" : ""
       patched = Array(f["patched_versions"])
 
-      <<~ROW
-        <div class="finding #{severity}">
-          <div class="finding-head">
-            <span class="badge #{severity}">#{severity.upcase}</span>
-            <strong>#{heading}</strong>
-            #{advisory}#{link}
+      <<~HTML
+        <div class="accordion" id="dep-#{index}">
+          <button type="button" class="accordion-header">
+            <span><span class="badge #{severity}">#{severity.upcase}</span> <strong>#{heading}</strong> #{advisory}</span>
+            <span class="accordion-meta"><span class="chevron">&#9656;</span></span>
+          </button>
+          <div class="accordion-body">
+            <p>#{escape(f["message"])}#{link}</p>
+            #{patched.empty? ? "" : "<p class=\"loc\">Patched version(s): #{escape(patched.join(", "))}</p>"}
+            <div class="fix"><strong>Suggested fix:</strong>#{render_markdown(f["suggested_fix"])}</div>
           </div>
-          <p>#{escape(f["message"])}</p>
-          #{patched.empty? ? "" : "<p class=\"loc\">Patched version(s): #{escape(patched.join(", "))}</p>"}
-          <div class="fix"><strong>Suggested fix:</strong>#{render_markdown(f["suggested_fix"])}</div>
         </div>
-      ROW
+      HTML
+    end
+
+    def render_top_priorities(risks)
+      return "<p class=\"muted\">Nothing critical or above — the highest-priority findings, " \
+             "if any, are in the sections below.</p>" if risks.empty?
+
+      items = risks.map do |r|
+        <<~ITEM
+          <li class="finding #{r[:severity]}">
+            <div class="finding-head">
+              <span class="badge #{r[:severity]}">#{r[:severity].upcase}</span>
+              <span class="loc">#{escape(r[:category])} &middot; <code>#{escape(r[:label].to_s)}</code> &middot; #{escape(r[:location].to_s)}</span>
+            </div>
+            <p>#{escape(r[:message])}</p>
+          </li>
+        ITEM
+      end.join
+
+      "<ol class=\"top-risks\">#{items}</ol>"
+    end
+
+    def finding_risk_entry(category, f)
+      {
+        severity: f["severity"],
+        category: category,
+        label: f["rule_id"],
+        location: f["line"] ? "#{f["file"]}:#{f["line"]}" : f["file"],
+        message: f["message"]
+      }
+    end
+
+    def dependency_risk_entry(f)
+      location =
+        if f["gem_name"]
+          f["installed_version"] ? "#{f["gem_name"]} #{f["installed_version"]}" : f["gem_name"]
+        else
+          "Gemfile.lock"
+        end
+
+      {
+        severity: f["severity"],
+        category: "dependency",
+        label: f["kind"],
+        location: location,
+        message: f["message"]
+      }
     end
 
     def escape(text)
@@ -487,7 +826,7 @@ module Scryer
 
     def static_csv_row(f)
       [
-        f["category"], f["rule_id"], f["severity"],
+        f["category"], f["rule_id"], f["severity"], f["confidence"], f["cwe"], f["owasp_category"],
         "#{f["file"]}#{f["line"] ? ":#{f["line"]}" : ""}",
         f["message"], f["suggested_fix"], f["code_snippet"], nil
       ]
@@ -502,7 +841,7 @@ module Scryer
         else
           "#{f["gem_name"]} #{f["installed_version"]}"
         end
-      [f["kind"], identifier, f["severity"], "Gemfile.lock", f["message"], f["suggested_fix"], nil, f["url"]]
+      [f["kind"], identifier, f["severity"], nil, nil, nil, "Gemfile.lock", f["message"], f["suggested_fix"], nil, f["url"]]
     end
 
     def csv_field(value)
@@ -550,8 +889,9 @@ module Scryer
           "id" => rule.rule_id,
           "name" => rule.rule_id,
           "shortDescription" => { "text" => rule.title },
-          "defaultConfiguration" => { "level" => SARIF_LEVEL_BY_SEVERITY[rule.default_severity] || "warning" }
-        }
+          "defaultConfiguration" => { "level" => SARIF_LEVEL_BY_SEVERITY[rule.default_severity] || "warning" },
+          "properties" => sarif_rule_properties(rule.cwe, rule.owasp_category)
+        }.compact
       end
 
       dependency_entries = DEPENDENCY_SARIF_RULES.map do |r|
@@ -566,6 +906,39 @@ module Scryer
       rule_entries + dependency_entries
     end
 
+    # `external/cwe/cwe-NN` is the tag GitHub Code Scanning specifically
+    # looks for to show a "CWE-NN" badge and link on a Security tab alert —
+    # see docs.github.com/code-security/code-scanning (SARIF properties.tags
+    # for rules). The OWASP category has no equivalent standardized SARIF
+    # tag convention, so it's included as a plain readable tag instead —
+    # still valid SARIF (tags are freeform strings), just not something
+    # GitHub's UI specifically recognizes the way it does CWE tags.
+    def sarif_rule_properties(cwe, owasp_category)
+      return nil unless cwe || owasp_category
+
+      tags = []
+      tags << "external/cwe/#{cwe.downcase}" if cwe
+      tags << owasp_category if owasp_category
+      { "tags" => tags }
+    end
+
+    # SARIF's own "how important is this result" field (0-100, higher =
+    # more urgent) — the per-result equivalent of what ReportRenderer#
+    # top_risks does across a whole scan, so a SARIF consumer (GitHub Code
+    # Scanning, a CI dashboard) can sort/prioritize without recomputing it.
+    # Combines severity (the bulk of the signal) with confidence (this
+    # rule's own precision estimate) rather than either alone — a
+    # high-severity, low-confidence finding like idor should rank below a
+    # high-severity, high-confidence one like sql_injection, not tie with it.
+    SEVERITY_RANK_BASE = { "critical" => 100, "warning" => 60, "info" => 20 }.freeze
+    CONFIDENCE_RANK_MULTIPLIER = { "high" => 1.0, "medium" => 0.75, "low" => 0.5 }.freeze
+
+    def sarif_rank(severity, confidence)
+      base = SEVERITY_RANK_BASE[severity] || 50
+      multiplier = CONFIDENCE_RANK_MULTIPLIER[confidence] || 0.75
+      (base * multiplier).round
+    end
+
     def sarif_result(f)
       physical_location = { "artifactLocation" => { "uri" => f["file"] } }
       physical_location["region"] = { "startLine" => f["line"] } if f["line"]
@@ -573,18 +946,23 @@ module Scryer
       {
         "ruleId" => f["rule_id"],
         "level" => SARIF_LEVEL_BY_SEVERITY[f["severity"]] || "warning",
+        "rank" => sarif_rank(f["severity"], f["confidence"]),
         "message" => { "text" => f["message"] },
-        "locations" => [{ "physicalLocation" => physical_location }]
+        "locations" => [{ "physicalLocation" => physical_location }],
+        "properties" => { "confidence" => f["confidence"], "cwe" => f["cwe"], "owasp_category" => f["owasp_category"] }.compact
       }
     end
 
     # Dependency findings don't point at a line in app source — Gemfile.lock
     # itself is the meaningful "location" (no region: nothing to underline
-    # inside it the way a code finding underlines a specific line).
+    # inside it the way a code finding underlines a specific line). No
+    # confidence/CWE/OWASP metadata — these aren't backed by a Scryer::Rule,
+    # see DEPENDENCY_SARIF_RULES above.
     def sarif_dependency_result(f)
       {
         "ruleId" => f["kind"],
         "level" => SARIF_LEVEL_BY_SEVERITY[f["severity"]] || "warning",
+        "rank" => SEVERITY_RANK_BASE[f["severity"]] || 50,
         "message" => { "text" => f["message"] },
         "locations" => [{ "physicalLocation" => { "artifactLocation" => { "uri" => "Gemfile.lock" } } }]
       }
@@ -596,6 +974,34 @@ module Scryer
       h2 { margin-top: 2rem; border-bottom: 1px solid #e2e8f0; padding-bottom: 0.35rem; }
       .meta { color: #64748b; font-size: 0.875rem; margin-top: 0; }
       .crit { color: #b91c1c; font-weight: 600; }
+      .score-panel { display: flex; gap: 1.5rem; align-items: center; background: #f8fafc;
+        border: 1px solid #e2e8f0; border-radius: 12px; padding: 1.25rem 1.5rem; margin: 1rem 0 1.25rem; }
+      .score-badge { flex: 0 0 auto; width: 5.5rem; height: 5.5rem; border-radius: 50%;
+        display: flex; flex-direction: column; align-items: center; justify-content: center;
+        color: #fff; }
+      .score-badge .score-number { font-size: 1.5rem; font-weight: 700; line-height: 1; }
+      .score-badge .score-grade { font-size: 0.9rem; font-weight: 600; opacity: 0.9; }
+      .score-badge.grade-A { background: #16a34a; }
+      .score-badge.grade-B { background: #0891b2; }
+      .score-badge.grade-C { background: #d97706; }
+      .score-badge.grade-D { background: #ea580c; }
+      .score-badge.grade-F { background: #dc2626; }
+      .score-details { flex: 1 1 auto; min-width: 0; }
+      .score-label { margin: 0 0 0.6rem; font-size: 0.82rem; color: #475569; }
+      .score-bar-row { display: flex; align-items: center; gap: 0.6rem; font-size: 0.8rem; margin: 0.25rem 0; }
+      .score-bar-label { flex: 0 0 4.5rem; color: #475569; }
+      .score-bar-track { flex: 1 1 auto; background: #e2e8f0; border-radius: 999px; height: 0.6rem; overflow: hidden; }
+      .score-bar-fill { height: 100%; border-radius: 999px; }
+      .score-bar-fill.critical { background: #dc2626; }
+      .score-bar-fill.warning { background: #d97706; }
+      .score-bar-fill.info { background: #64748b; }
+      .score-bar-count { flex: 0 0 1.75rem; text-align: right; color: #1e293b; font-weight: 600;
+        text-decoration: none; }
+      .score-bar-count:hover { text-decoration: underline; }
+      .findings-search { display: block; width: 100%; max-width: 28rem; margin: 0.75rem 0 1.25rem;
+        padding: 0.5rem 0.75rem; font: inherit; font-size: 0.85rem; border: 1px solid #cbd5e1;
+        border-radius: 8px; box-sizing: border-box; }
+      .findings-search:focus { outline: 2px solid #6366f1; outline-offset: 1px; }
       .toc { display: flex; flex-wrap: wrap; gap: 0.5rem 1rem; background: #f8fafc; border: 1px solid #e2e8f0;
              border-radius: 8px; padding: 0.75rem 1rem; font-size: 0.85rem; }
       .toc a { color: #3730a3; text-decoration: none; }
@@ -607,8 +1013,16 @@ module Scryer
       table.kv th { width: 12rem; background: #f8fafc; color: #475569; font-weight: 600; }
       table.summary th, table.checks th { background: #f8fafc; color: #475569; }
       table.summary tr.total { font-weight: 700; }
+      #top-priorities { margin-bottom: 1.5rem; padding-bottom: 1rem; border-bottom: 2px solid #e2e8f0; }
+      .top-risks { list-style: none; padding: 0; margin: 0; }
       .finding { border: 1px solid #e2e8f0; border-radius: 8px; padding: 0.75rem 1rem; margin-bottom: 0.75rem; }
+      .finding.highlight { border-color: #6366f1; box-shadow: 0 0 0 2px #6366f1; background: #eef2ff; }
       .finding-head { display: flex; align-items: center; gap: 0.5rem; margin-bottom: 0.5rem; }
+      .finding-tags { margin: -0.15rem 0 0.5rem; }
+      .finding-tags .tag { display: inline-block; font-size: 0.72rem; color: #475569; background: #f1f5f9;
+        border-radius: 4px; padding: 0.1rem 0.45rem; margin: 0.15rem 0.3rem 0.15rem 0; }
+      .filter-link { color: #3730a3; text-decoration: none; font-weight: 600; }
+      .filter-link:hover { text-decoration: underline; }
       .badge { font-size: 0.7rem; font-weight: 700; padding: 0.15rem 0.5rem; border-radius: 4px; }
       .badge.critical { background: #fee2e2; color: #991b1b; }
       .badge.warning { background: #fef3c7; color: #92400e; }
@@ -621,6 +1035,9 @@ module Scryer
       .fix > strong { display: block; margin-bottom: 0.35rem; }
       .fix p { margin: 0 0 0.5rem; }
       .fix p:last-child { margin-bottom: 0; }
+      .fix-verified { margin: 0.4rem 0 0; font-size: 0.8rem; font-weight: 600; }
+      .fix-verified.verified { color: #166534; }
+      .fix-verified.unverified { color: #991b1b; }
       .fix pre { margin: 0.5rem 0 0; }
       .fix pre:last-child { margin-bottom: 0; }
       .dup-member { margin-top: 0.5rem; }
@@ -695,6 +1112,82 @@ module Scryer
 
         window.addEventListener("hashchange", openHashTarget);
         openHashTarget();
+
+        // Filters every .finding — both the accordion entries under
+        // #findings and the fixed top-5 list items under #top-priorities —
+        // by rule id, file, or message text, all already part of each
+        // .finding's rendered text content, so no separate index is needed.
+        // A non-matching finding is hidden entirely (including a
+        // now-empty Top priorities list item, same as a now-empty
+        // accordion); a matching one gets the `.highlight` treatment
+        // (visually distinct, not just "still visible") specifically so a
+        // filter applied via typing OR via one of the click-through links
+        // (OWASP coverage counts, severity bar counts) makes it obvious
+        // which finding(s) are "the" target, not just that unrelated ones
+        // got hidden. Matching accordions (rule groups) auto-open so
+        // results are visible without an extra click; a group with zero
+        // matches hides entirely. Clearing the search restores everything
+        // to its pre-search open/closed state isn't attempted — simplest
+        // correct behavior is "show everything, closed," same as a fresh
+        // page load.
+        var searchBox = document.getElementById("findings-search");
+
+        // `terms` (plural) rather than one substring: a Summary-table cell
+        // like "Security × Critical" links with a two-word query
+        // ("security critical") and needs BOTH words present, not the
+        // literal two-word phrase — a finding's category tag and severity
+        // badge aren't adjacent text. Every existing single-term or
+        // multi-word-phrase query (an OWASP category like "A03:2021-
+        // Injection" splits into ["a03:2021-injection"] with no spaces, so
+        // it's unaffected either way) still works the same: requiring every
+        // term to appear somewhere is a strict superset of "the exact
+        // phrase appears," never stricter.
+        function matchAndMarkFinding(finding, terms) {
+          var text = finding.textContent.toLowerCase();
+          var match = terms.length === 0 || terms.every(function (term) { return text.indexOf(term) !== -1; });
+          finding.style.display = match ? "" : "none";
+          finding.classList.toggle("highlight", terms.length > 0 && match);
+          return match;
+        }
+
+        function applyFindingsFilter() {
+          var terms = searchBox.value.trim().toLowerCase().split(/\s+/).filter(Boolean);
+
+          var findingsSection = document.getElementById("findings");
+          findingsSection.querySelectorAll(".accordion").forEach(function (acc) {
+            var anyVisible = false;
+            acc.querySelectorAll(".finding").forEach(function (finding) {
+              if (matchAndMarkFinding(finding, terms)) anyVisible = true;
+            });
+            acc.style.display = anyVisible ? "" : "none";
+            if (terms.length) setOpen(acc, anyVisible);
+          });
+
+          var topPriorities = document.getElementById("top-priorities");
+          if (topPriorities) {
+            topPriorities.querySelectorAll(".finding").forEach(function (finding) {
+              matchAndMarkFinding(finding, terms);
+            });
+          }
+        }
+
+        if (searchBox) {
+          searchBox.addEventListener("input", applyFindingsFilter);
+        }
+
+        // OWASP coverage table counts (and, by the same mechanism, any
+        // future "count that means a specific set of findings") link into
+        // the Findings search box rather than a second breakdown view —
+        // set the search value to this row's exact category string, run
+        // the same filter the search box itself uses, then let the link's
+        // own #findings href do the scrolling.
+        document.addEventListener("click", function (e) {
+          var link = e.target.closest(".filter-link");
+          if (link && searchBox) {
+            searchBox.value = link.dataset.filter;
+            applyFindingsFilter();
+          }
+        });
       })();
     JS
   end