ui_guardrails 1.0.0 → 1.2.0

data/lib/tasks/guardrails.rake

@@ -107,19 +107,106 @@ namespace :guardrails do
       }
       $stdout.puts JSON.pretty_generate(payload)
     else
+      # Run each sub-audit against an in-memory sink first so we can
+      # render the top-of-report summary before the per-category
+      # details (the summary needs every detector's count). Then
+      # write the sink + per-category sections out together.
+      #
+      # Important: detectors write into `sink` (StringIO) but make
+      # ANSI-color decisions against `$stdout`. If we let each
+      # detector instantiate its own Style bound to the sink, every
+      # color() call would be false (StringIO isn't a TTY) and the
+      # body of the report would print plain even on a real terminal,
+      # while the top/bottom summary printed straight to $stdout
+      # would still be colored. Pre-build one Style here and thread
+      # it through every detector so the whole report tracks the
+      # real terminal's TTY/NO_COLOR signal consistently.
+      require "guardrails/report/summary"
+      require "guardrails/report/style"
+      sink = StringIO.new
+      report_style = Guardrails::Report::Style.new(io: $stdout)
       violations = Guardrails::Audit.new(
-        root: root, suggest: suggest, apply: apply, format: :text
+        root: root, output: sink, suggest: suggest, apply: apply, format: :text,
+        style: report_style
       ).run
-      stimulus = Guardrails::StimulusAudit.new(root: root).run
+      stimulus = Guardrails::StimulusAudit.new(root: root, output: sink, style: report_style).run
+      similarity_opts[:output] = sink
+      similarity_opts[:style] = report_style
       similarity = Guardrails::PartialSimilarity.new(**similarity_opts).run
-      vc = Guardrails::ViewComponentAudit.new(root: root).run
-      a11y = Guardrails::A11yAudit.new(root: root).run
+      vc = Guardrails::ViewComponentAudit.new(root: root, output: sink, style: report_style).run
+      a11y = Guardrails::A11yAudit.new(root: root, output: sink, style: report_style).run
+      pattern_opts[:output] = sink
+      pattern_opts[:style] = report_style
       patterns = Guardrails::CrossCodebasePatterns.new(**pattern_opts).run
+      classitis_opts[:output] = sink
+      classitis_opts[:style] = report_style
       classitis = Guardrails::ClassItis.new(**classitis_opts).run
-      a11y_deep_runner = axe_json_path ? Guardrails::A11yDeep.new(input: axe_json_path) : nil
+      a11y_deep_runner = axe_json_path ? Guardrails::A11yDeep.new(input: axe_json_path, output: sink, style: report_style) : nil
       a11y_deep = a11y_deep_runner&.run || []
-      visual_diff_runner = visual_diff_on ? Guardrails::VisualDiff.new(root: root) : nil
+      visual_diff_runner = visual_diff_on ? Guardrails::VisualDiff.new(root: root, output: sink, style: report_style) : nil
       visual_diff = visual_diff_runner&.run || []
+
+      summary_entries = [
+        Guardrails::Report::Summary::Entry.new(
+          category: "raw_color", count: violations.count { |v| v.type == :raw_color },
+          severity: :error, auto_fix: true
+        ),
+        Guardrails::Report::Summary::Entry.new(
+          category: "tailwind_arbitrary", count: violations.count { |v| v.type == :tailwind_arbitrary },
+          severity: :error, auto_fix: true
+        ),
+        Guardrails::Report::Summary::Entry.new(
+          category: "inline_style", count: violations.count { |v| v.type == :inline_style },
+          severity: :warning
+        ),
+        Guardrails::Report::Summary::Entry.new(
+          category: "helper_recommended", count: violations.count { |v| v.type == :helper_recommended },
+          severity: :warning
+        ),
+        Guardrails::Report::Summary::Entry.new(
+          category: "a11y (static)", count: a11y.length, severity: :error
+        ),
+        Guardrails::Report::Summary::Entry.new(
+          category: "a11y (deep)", count: a11y_deep.length, severity: :error
+        ),
+        Guardrails::Report::Summary::Entry.new(
+          category: "stimulus orphaned", count: stimulus.orphaned.length, severity: :warning
+        ),
+        Guardrails::Report::Summary::Entry.new(
+          category: "stimulus dead", count: stimulus.dead.length, severity: :warning
+        ),
+        Guardrails::Report::Summary::Entry.new(
+          category: "missing previews", count: vc.missing_previews.length, severity: :warning
+        ),
+        Guardrails::Report::Summary::Entry.new(
+          category: "orphan slots", count: vc.orphan_slots.length, severity: :warning
+        ),
+        Guardrails::Report::Summary::Entry.new(
+          category: "visual diff", count: visual_diff.length, severity: :error
+        ),
+        Guardrails::Report::Summary::Entry.new(
+          category: "similar partials", count: similarity.length, severity: :suggestion,
+          unit: "pairs", action: "consider deduplicating"
+        ),
+        Guardrails::Report::Summary::Entry.new(
+          category: "cross-codebase patterns", count: patterns.length, severity: :suggestion,
+          unit: "candidates", action: "consider extracting partials"
+        ),
+        Guardrails::Report::Summary::Entry.new(
+          category: "class-itis", count: classitis.length, severity: :suggestion,
+          unit: "clusters", action: "consider extracting component / @apply"
+        )
+      ]
+
+      # Render the summary twice — once at the top so the reader
+      # knows what to expect, once at the bottom as a recap so they
+      # don't have to scroll back up after the per-detector dump.
+      # On a long output (Patchvault has 981 findings) the bottom
+      # recap is the load-bearing one.
+      summary = Guardrails::Report::Summary.new(entries: summary_entries, output: $stdout, style: report_style)
+      summary.render
+      $stdout.write sink.string
+      summary.render(recap: true)
     end
 
     # Deep a11y findings only fail the audit when their impact crosses

metadata

@@ -1,14 +1,13 @@
 --- !ruby/object:Gem::Specification
 name: ui_guardrails
 version: !ruby/object:Gem::Version
-  version: 1.0.0
+  version: 1.2.0
 platform: ruby
 authors:
 - John Athayde
-autorequire:
 bindir: bin
 cert_chain: []
-date: 2026-05-11 00:00:00.000000000 Z
+date: 1980-01-02 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: railties
@@ -16,14 +15,14 @@ dependencies:
     requirements:
     - - ">="
       - !ruby/object:Gem::Version
-        version: '7.1'
+        version: '7.2'
   type: :runtime
   prerelease: false
   version_requirements: !ruby/object:Gem::Requirement
     requirements:
     - - ">="
       - !ruby/object:Gem::Version
-        version: '7.1'
+        version: '7.2'
 - !ruby/object:Gem::Dependency
   name: herb
   requirement: !ruby/object:Gem::Requirement
@@ -80,6 +79,7 @@ files:
 - doc/LOOKBOOK.md
 - doc/PRD.md
 - doc/PUBLISHING.md
+- doc/RESEARCH-visual-diff.md
 - doc/ROADMAP.md
 - doc/UPSTREAM-snap_diff-issue-draft.md
 - doc/VISUAL-DIFF.md
@@ -105,6 +105,8 @@ files:
 - lib/guardrails/lookbook/views/lookbook_panels/_guardrails.html.erb
 - lib/guardrails/partial_similarity.rb
 - lib/guardrails/railtie.rb
+- lib/guardrails/report/style.rb
+- lib/guardrails/report/summary.rb
 - lib/guardrails/stimulus_audit.rb
 - lib/guardrails/token_matcher.rb
 - lib/guardrails/tokens.rb
@@ -123,7 +125,6 @@ metadata:
   source_code_uri: https://github.com/meticulous/guardrails
   changelog_uri: https://github.com/meticulous/guardrails/blob/main/CHANGELOG.md
   rubygems_mfa_required: 'true'
-post_install_message:
 rdoc_options: []
 require_paths:
 - lib
@@ -131,15 +132,14 @@ required_ruby_version: !ruby/object:Gem::Requirement
   requirements:
   - - ">="
     - !ruby/object:Gem::Version
-      version: 3.2.0
+      version: 3.4.0
 required_rubygems_version: !ruby/object:Gem::Requirement
   requirements:
   - - ">="
     - !ruby/object:Gem::Version
       version: '0'
 requirements: []
-rubygems_version: 3.4.19
-signing_key:
+rubygems_version: 3.6.9
 specification_version: 4
 summary: Rails toolset for preventing UI drift in AI-assisted applications.
 test_files: []