suma 0.2.4 → 0.2.6

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 0e48ff476d65e79fed1e67ed14aced4a49332640c2cd5765545237eae6b59d57
-  data.tar.gz: 89ce2271fd741533638b798cdeca99c2b4dbc30ba827c2f8c3bf342ab71b3aa5
+  metadata.gz: 6e6db67576d42aaaed54f90f72960ad405774d4084be5f7c0e8f1b277ebbbd50
+  data.tar.gz: ed5cdf3967496436950306f0edcf553751bb3da06c4e4582a014b8e7610e6d35
 SHA512:
-  metadata.gz: 8f139509f972a2700345efe36f8d76709f1338e27447771ec3de966bd7a21c5c6a5c0c3e765162efeba53a102e29517b038d446c7b98c058fd9a7f793b7cdbef
-  data.tar.gz: 65256ed59b74ff76fd7710ce308049c3972e0bdc4a4698de02e090a85a66ddfaf5e4c5e90864ecef9e134de922c0b96534d05488759cd4cce8ec08bfe54deb4e
+  metadata.gz: 0e4e8fe19fb5b9ec7c8023258e55a8ed100c98bb4ee271898562eeed13d5e1646d09c673e0053f2271827c8413408d5cb9295e94cc39d298be7161d33a0805c2
+  data.tar.gz: 8110684a885977266204dace36b4b5bb8a88113c1b410aa78c19d8ad4c58c2a49858f14f9495e433414d43b0bd13716a49e47eb8ef7724ee34306826a215ff15

data/.github/workflows/rake.yml

@@ -2,6 +2,9 @@
 # See https://github.com/metanorma/cimas
 name: rake
 
+permissions:
+  contents: write
+
 on:
   push:
     branches: [ master, main ]

data/.github/workflows/release.yml

@@ -2,6 +2,11 @@
 # See https://github.com/metanorma/cimas
 name: release
 
+permissions:
+  contents: write
+  packages: write
+  id-token: write
+
 on:
   workflow_dispatch:
     inputs:
@@ -22,4 +27,3 @@ jobs:
     secrets:
       rubygems-api-key: ${{ secrets.METANORMA_CI_RUBYGEMS_API_KEY }}
       pat_token: ${{ secrets.METANORMA_CI_PAT_TOKEN }}
-

data/.rubocop_todo.yml

@@ -1,35 +1,34 @@
 # This configuration was generated by
 # `rubocop --auto-gen-config`
-# on 2025-12-18 05:29:37 UTC using RuboCop version 1.81.1.
+# on 2026-05-11 08:57:26 UTC using RuboCop version 1.86.1.
 # The point is for the user to remove these configuration records
 # one by one as the offenses are removed from the code base.
 # Note that changes in the inspected code, or installation of new
 # versions of RuboCop, may require this file to be generated again.
 
 # Offense count: 3
-# Configuration parameters: Severity.
 Gemspec/DuplicatedAssignment:
   Exclude:
     - 'suma.gemspec'
 
 # Offense count: 1
-# Configuration parameters: Severity.
 Gemspec/RequiredRubyVersion:
   Exclude:
     - 'suma.gemspec'
 
-# Offense count: 82
+# Offense count: 120
 # This cop supports safe autocorrection (--autocorrect).
-# Configuration parameters: Max, AllowHeredoc, AllowURI, AllowQualifiedName, URISchemes, IgnoreCopDirectives, AllowedPatterns, SplitStrings.
+# Configuration parameters: Max, AllowHeredoc, AllowURI, AllowQualifiedName, URISchemes, AllowRBSInlineAnnotation, AllowCopDirectives, AllowedPatterns, SplitStrings.
 # URISchemes: http, https
 Layout/LineLength:
   Enabled: false
 
-# Offense count: 2
+# Offense count: 4
 # Configuration parameters: IgnoreLiteralBranches, IgnoreConstantBranches, IgnoreDuplicateElseBranch.
 Lint/DuplicateBranch:
   Exclude:
     - 'lib/suma/jsdai/figure.rb'
+    - 'lib/suma/term_extractor.rb'
 
 # Offense count: 1
 Lint/DuplicateMethods:
@@ -41,48 +40,93 @@ Lint/IneffectiveAccessModifier:
   Exclude:
     - 'lib/suma/cli/export.rb'
 
-# Offense count: 11
+# Offense count: 1
+# This cop supports safe autocorrection (--autocorrect).
+# Configuration parameters: AllowUnusedKeywordArguments, IgnoreEmptyMethods, IgnoreNotImplementedMethods, NotImplementedExceptions.
+# NotImplementedExceptions: NotImplementedError
+Lint/UnusedMethodArgument:
+  Exclude:
+    - 'lib/suma/svg_quality.rb'
+
+# Offense count: 29
 # Configuration parameters: AllowedMethods, AllowedPatterns, CountRepeatedAttributes, Max.
 Metrics/AbcSize:
   Exclude:
-    - 'lib/suma/cli/compare.rb'
+    - 'lib/suma/cli.rb'
+    - 'lib/suma/cli/check_svg_quality.rb'
     - 'lib/suma/jsdai/figure.rb'
     - 'lib/suma/jsdai/figure_image.rb'
+    - 'lib/suma/link_validator.rb'
+    - 'lib/suma/processor.rb'
     - 'lib/suma/schema_attachment.rb'
+    - 'lib/suma/schema_comparer.rb'
     - 'lib/suma/schema_document.rb'
+    - 'lib/suma/schema_manifest_generator.rb'
+    - 'lib/suma/svg_quality/formatters/terminal_formatter.rb'
+    - 'lib/suma/term_extractor.rb'
     - 'lib/suma/thor_ext.rb'
 
-# Offense count: 6
+# Offense count: 1
+# Configuration parameters: CountComments, CountAsOne, AllowedMethods, AllowedPatterns, inherit_mode.
+# AllowedMethods: refine
+Metrics/BlockLength:
+  Max: 54
+
+# Offense count: 14
 # Configuration parameters: AllowedMethods, AllowedPatterns, Max.
 Metrics/CyclomaticComplexity:
   Exclude:
-    - 'lib/suma/cli/compare.rb'
+    - 'lib/suma/cli/check_svg_quality.rb'
     - 'lib/suma/eengine/wrapper.rb'
+    - 'lib/suma/express_schema.rb'
     - 'lib/suma/jsdai/figure.rb'
     - 'lib/suma/jsdai/figure_image.rb'
+    - 'lib/suma/link_validator.rb'
+    - 'lib/suma/schema_comparer.rb'
+    - 'lib/suma/svg_quality/formatters/terminal_formatter.rb'
+    - 'lib/suma/term_extractor.rb'
     - 'lib/suma/thor_ext.rb'
 
-# Offense count: 5
+# Offense count: 25
 # Configuration parameters: CountComments, CountAsOne, AllowedMethods, AllowedPatterns.
 Metrics/MethodLength:
-  Max: 60
+  Max: 59
 
-# Offense count: 4
+# Offense count: 2
+# Configuration parameters: CountKeywordArgs, MaxOptionalParameters.
+Metrics/ParameterLists:
+  Max: 9
+
+# Offense count: 8
 # Configuration parameters: AllowedMethods, AllowedPatterns, Max.
 Metrics/PerceivedComplexity:
   Exclude:
-    - 'lib/suma/cli/compare.rb'
     - 'lib/suma/eengine/wrapper.rb'
     - 'lib/suma/jsdai/figure_image.rb'
+    - 'lib/suma/link_validator.rb'
+    - 'lib/suma/schema_comparer.rb'
+    - 'lib/suma/svg_quality/formatters/terminal_formatter.rb'
+    - 'lib/suma/term_extractor.rb'
 
 # Offense count: 1
 # Configuration parameters: Mode, AllowedMethods, AllowedPatterns, AllowBangMethods, WaywardPredicates.
 # AllowedMethods: call
-# WaywardPredicates: nonzero?
+# WaywardPredicates: infinite?, nonzero?
 Naming/PredicateMethod:
   Exclude:
     - 'lib/suma/eengine/wrapper.rb'
 
+# Offense count: 1
+# Configuration parameters: NamePrefix, ForbiddenPrefixes, AllowedMethods, MethodDefinitionMacros, UseSorbetSigs.
+# NamePrefix: is_, has_, have_, does_
+# ForbiddenPrefixes: is_, has_, have_, does_
+# AllowedMethods: is_a?
+# MethodDefinitionMacros: define_method, define_singleton_method
+Naming/PredicatePrefix:
+  Exclude:
+    - 'spec/**/*'
+    - 'lib/suma/term_extractor.rb'
+
 # Offense count: 2
 # Configuration parameters: EnforcedStyle, CheckMethodNames, CheckSymbols, AllowedIdentifiers, AllowedPatterns.
 # SupportedStyles: snake_case, normalcase, non_integer
@@ -95,9 +139,9 @@ Naming/VariableNumber:
 # Configuration parameters: MinSize.
 Performance/CollectionLiteralInLoop:
   Exclude:
-    - 'spec/suma/cli/compare_spec.rb'
     - 'spec/suma/cli/export_spec.rb'
     - 'spec/suma/cli_spec.rb'
+    - 'spec/suma/schema_comparer_integration_spec.rb'
 
 # Offense count: 2
 # Configuration parameters: Prefixes, AllowedPatterns.
@@ -106,40 +150,40 @@ RSpec/ContextWording:
   Exclude:
     - 'spec/suma/cli/export_spec.rb'
 
-# Offense count: 64
+# Offense count: 71
 # Configuration parameters: CountAsOne.
 RSpec/ExampleLength:
-  Max: 61
+  Max: 60
 
 # Offense count: 4
 # Configuration parameters: Max, AllowedIdentifiers, AllowedPatterns.
 RSpec/IndexedLet:
   Exclude:
-    - 'spec/suma/cli/compare_spec.rb'
     - 'spec/suma/cli/export_spec.rb'
+    - 'spec/suma/schema_comparer_integration_spec.rb'
 
 # Offense count: 22
 # Configuration parameters: AssignmentOnly.
 RSpec/InstanceVariable:
   Exclude:
-    - 'spec/suma/cli/compare_spec.rb'
+    - 'spec/suma/schema_comparer_integration_spec.rb'
 
 # Offense count: 1
 # This cop supports safe autocorrection (--autocorrect).
 RSpec/IteratedExpectation:
   Exclude:
-    - 'spec/suma/cli/compare_spec.rb'
+    - 'spec/suma/schema_comparer_integration_spec.rb'
 
 # Offense count: 1
 # Configuration parameters: EnforcedStyle.
 # SupportedStyles: have_received, receive
 RSpec/MessageSpies:
   Exclude:
-    - 'spec/suma/cli/compare_spec.rb'
+    - 'spec/suma/schema_comparer_integration_spec.rb'
 
-# Offense count: 47
+# Offense count: 50
 RSpec/MultipleExpectations:
-  Max: 23
+  Max: 21
 
 # Offense count: 3
 # Configuration parameters: AllowedGroups.
@@ -147,7 +191,8 @@ RSpec/NestedGroups:
   Max: 4
 
 # Offense count: 1
-# Configuration parameters: CustomTransform, IgnoreMethods, IgnoreMetadata.
+# Configuration parameters: CustomTransform, IgnoreMethods, IgnoreMetadata, InflectorPath, EnforcedInflector.
+# SupportedInflectors: default, active_support
 RSpec/SpecFilePathFormat:
   Exclude:
     - '**/spec/routing/**/*'
@@ -156,4 +201,11 @@ RSpec/SpecFilePathFormat:
 # Offense count: 1
 RSpec/StubbedMock:
   Exclude:
-    - 'spec/suma/cli/compare_spec.rb'
+    - 'spec/suma/schema_comparer_integration_spec.rb'
+
+# Offense count: 1
+# Configuration parameters: AllowedMethods.
+# AllowedMethods: respond_to_missing?
+Style/OptionalBooleanParameter:
+  Exclude:
+    - 'lib/suma/cli/check_svg_quality.rb'

data/CLAUDE.md

@@ -0,0 +1,76 @@
+# CLAUDE.md
+
+This file provides guidance to Claude Code (claude.ai/code) when working with code in this repository.
+
+## Overview
+
+Suma is a Ruby gem for processing EXPRESS schemas (ISO 10303 STEP standards). It reads Metanorma site manifests, discovers EXPRESS schemas, compiles them into documentation, and can export/compare schemas.
+
+## Commands
+
+### Development
+
+```bash
+bundle install              # Install dependencies
+rake spec                   # Run RSpec tests
+rake rubocop                # Run RuboCop linter
+rake                        # Run both tests and linter (default task)
+rspec spec/path/to_spec.rb  # Run a single spec file
+rspec spec/path/to_spec.rb:42  # Run a single test at line 42
+```
+
+### CLI usage
+
+```bash
+exe/suma build METANORMA_YAML                          # Build collection from site manifest
+exe/suma export -o OUTPUT_DIR schema1.yml schema2.exp  # Export schemas (YAML manifest or .exp files)
+exe/suma compare TRIAL_SCHEMA REFERENCE_SCHEMA -v VER  # Compare schemas, generate .changes.yaml
+exe/suma reformat PATH                                  # Reformat EXP files (use -r for recursive)
+exe/suma generate-schemas METANORMA_YAML SCHEMAS_YAML  # Generate schema manifest from site manifest
+exe/suma extract-terms SCHEMA_YAML GLOSSARIST_DIR      # Extract terms to Glossarist v2 format
+exe/suma validate links SCHEMAS_FILE DOCS_PATH          # Validate EXPRESS cross-reference links
+```
+
+## Architecture
+
+### Core pipeline (build command)
+
+1. `Processor.run` receives a Metanorma site manifest YAML
+2. `SiteConfig` reads the site manifest, finds collection YAML paths
+3. `CollectionConfig` extends `Metanorma::Collection::Config` with a `CollectionManifest` that discovers `schemas.yaml` files
+4. `SchemaCollection` loads all discovered schemas via `Expressir`, exports plain `.exp` files, and compiles documentation (Metanorma `.adoc` → XML/HTML)
+5. `SchemaExporter` handles exporting schemas to a directory (with optional ZIP packaging)
+
+### Key classes
+
+- **`ExpressSchema`** — wraps a single EXPRESS schema file; parses via `Expressir::Express::Parser`, can output plain or annotated `.exp`
+- **`SchemaAttachment`** — compiles one schema into a Metanorma `.adoc` document and renders it via `Metanorma::Compile`
+- **`SchemaDocument`** (extends `SchemaAttachment`) — adds cross-reference bookmarks and uses XML-only output
+- **`SchemaCollection`** — orchestrates processing of all schemas from a config
+- **`SchemaExporter`** — standalone export of schemas from manifest or `.exp` files to a directory, with optional ZIP
+- **`CollectionManifest`** — traverses collection YAML files, builds unified `Expressir::SchemaManifest`
+
+### CLI structure
+
+- `Suma::Cli::Core` (Thor subclass) — top-level CLI entrypoint
+- Subcommands delegate to `Cli::Build`, `Cli::Export`, `Cli::Compare`, `Cli::Validate`, `Cli::Reformat`, `Cli::GenerateSchemas`, `Cli::ExtractTerms`, `Cli::ConvertJsdai`
+- Thor extension (`ThorExt::Start`) adds `-h`/`--help` support and error formatting
+
+### External dependencies
+
+- **expressir** — EXPRESS schema parsing and manifest handling
+- **metanorma** — document compilation (`.adoc` → XML/HTML/PDF)
+- **lutaml-model** — YAML/XML model serialization (used in `SiteConfig`, `CollectionConfig`)
+- **glossarist** — term extraction output format
+- **eengine** (optional, external binary) — schema comparison via `Eengine::Wrapper`
+
+### Schema comparison flow
+
+The `compare` command uses an external `eengine` binary to diff two EXPRESS schemas, producing XML. `EengineConverter` then converts that XML into a `.changes.yaml` file managed by `Expressir::Changes::SchemaChange`.
+
+## Code style
+
+- Ruby 3.0+ with `frozen_string_literal: true` in every file
+- RuboCop with performance, rake, and rspec plugins; inherits from riboseinc OSS guide
+- Some CLI files are excluded from RuboCop in `.rubocop.yml`
+- Use `Utils.log` for user-facing output (prefixes with `[suma]`)

data/Gemfile

@@ -6,7 +6,9 @@ source "https://rubygems.org"
 gemspec
 
 gem "canon"
-gem "metanorma-standoc"
+gem "metanorma", github: "metanorma/metanorma", branch: "main"
+gem "metanorma-plugin-lutaml", github: "metanorma/metanorma-plugin-lutaml", branch: "main"
+gem "metanorma-standoc", github: "metanorma/metanorma-standoc", branch: "main"
 gem "nokogiri"
 gem "openssl", "~> 3.0"
 gem "rake"

data/README.adoc

@@ -864,6 +864,137 @@ For complete documentation of all Expressir commands and options, see the
 https://github.com/lutaml/expressir[Expressir documentation].
 
 
+=== Check SVG quality command
+
+==== General
+
+The `check_svg_quality` command validates SVG files for conformance and quality
+using the https://github.com/claricle/svg_conform[svg_conform] library. It supports
+both batch directory scanning and single file analysis.
+
+By default, it uses the `metanorma` profile which allows raster images
+(PNG, JPEG) and other features specific to Metanorma documentation.
+
+[source,sh]
+----
+$ suma check_svg_quality [PATH] [options]
+----
+
+Parameters:
+
+`PATH`:: Path to directory containing SVG files or a single SVG file.
+Defaults to `schemas` directory.
+
+==== Batch directory scanning
+
+When given a directory, it scans all SVG files and produces a quality report
+sorted by error count (most problematic files first).
+
+[example]
+.Check all SVG files in schemas directory
+[source,sh]
+----
+$ suma check_svg_quality ../iso-10303/schemas
+----
+
+.Output
+----
+🔍 Scanning 3878 SVG files...
+
+╔══════════════════════════════════════════════════════════════════════════════╗
+║  🔍 SVG Quality Report    Sorted by error count (most first)             ║
+╚══════════════════════════════════════════════════════════════════════════════╝
+
+  📊 OVERVIEW
+
+    ● Total Files   : 3878
+    ● Valid         : 3845 ✅
+    ● Invalid      : 33 ❌
+    ...
+
+  💥 CRITICAL QUALITY (2 files)
+
+    ✗   0/100    813 errors  schemas/resources/action_schema/action_schemaexpg2.svg
+    ✗  25/100    156 errors  schemas/modules/activity/mimexpg1.svg
+----
+
+==== Single file analysis
+
+When given a path to a single SVG file, it shows detailed error breakdown
+grouped by requirement type.
+
+[example]
+.Analyze a single SVG file
+[source,sh]
+----
+$ suma check_svg_quality schemas/resources/action_schema/action_schemaexpg2.svg
+----
+
+.Output
+----
+📄 SVG Quality Report: schemas/resources/action_schema/action_schemaexpg2.svg
+
+  Valid: NO ❌
+  Errors: 813
+
+  📋 Error Details
+
+  style (56 occurrences)
+    - Style property 'enable-background' removed
+    - Style property 'overflow' removed
+    ...
+
+  allowed_elements (109 occurrences)
+    - The element 'image' is not allowed as a child of 'svg'
+    ...
+
+  color_restrictions (108 occurrences)
+    - Color 'rgb(33, 128, 255)' in style property 'fill' is not allowed
+    ...
+----
+
+Options:
+
+`--profile=PROFILE`:: Validation profile to use (default: `metanorma`).
+Other options: `svg_1_2_rfc`, `svg_1_2_rfc_with_rdf`, `base`, `lucid_fix`
+
+`--sort=MODE`:: Sort order: `errors` (most errors first, default) or
+`quality` (lowest quality scores first)
+
+`--format=FORMAT`:: Output format: `terminal` (default), `json`, or `yaml`
+
+`--output=PATH`, `-o PATH`:: Write output to file instead of stdout
+
+`--min_errors=N`:: Filter to show only files with at least N errors
+
+`--limit=N`:: Limit output to top N files
+
+`--progress`:: Show progress during batch scanning
+
+`--summary-only`:: Show only summary, not individual file details
+
+[example]
+.Check with custom profile
+[source,sh]
+----
+$ suma check_svg_quality schemas/ --profile svg_1_2_rfc
+----
+
+[example]
+.Output as JSON
+[source,sh]
+----
+$ suma check_svg_quality schemas/ --format json --output quality_report.json
+----
+
+[example]
+.Show only files with 100+ errors
+[source,sh]
+----
+$ suma check_svg_quality schemas/ --min_errors 100
+----
+
+
 == Usage: Ruby
 
 === General

data/lib/suma/cli/build.rb

@@ -31,16 +31,15 @@ module Suma
       private
 
       def run(manifest, options)
-        # Set schemas_all_path to match metanorma_yaml_path
         schemas_all_path = options[:schemas_all_path] ||
           manifest.gsub("metanorma", "schemas")
 
-        Processor.run(
+        Processor.new(
           metanorma_yaml_path: manifest,
           schemas_all_path: schemas_all_path,
           compile: options[:compile],
           output_directory: "_site",
-        )
+        ).run
       end
 
       def log_error(error)

data/lib/suma/cli/check_svg_quality.rb

@@ -0,0 +1,178 @@
+# frozen_string_literal: true
+
+require "pathname"
+require_relative "../svg_quality"
+require_relative "../svg_quality/report"
+require_relative "../svg_quality/batch_report"
+require_relative "../svg_quality/formatters/terminal_formatter"
+require_relative "../svg_quality/formatters/json_formatter"
+require_relative "../svg_quality/formatters/yaml_formatter"
+
+module Suma
+  module Cli
+    # Check SVG quality using svg_conform Validator API - thin CLI wrapper
+    class CheckSvgQuality
+      DATA_PATH = "schemas"
+      DEFAULT_PATTERN = "**/*.svg"
+      DEFAULT_PROFILE = :metanorma
+
+      def initialize(pattern: DEFAULT_PATTERN, profile: DEFAULT_PROFILE,
+                    format: "terminal", output: nil, min_errors: nil,
+                    summary_only: false, progress: false, limit: nil,
+                    sort: "errors")
+        @options = {
+          pattern: pattern,
+          profile: profile,
+          format: format,
+          output: output,
+          min_errors: min_errors,
+          summary_only: summary_only,
+          progress: progress,
+          limit: limit,
+          sort: sort.to_sym,
+        }
+      end
+
+      def run(path = DATA_PATH)
+        require "svg_conform"
+
+        path_obj = Pathname.new(path).expand_path
+
+        # Enable progress by default when outputting to terminal
+        show_progress = options[:progress] || ($stdout.tty? && !options[:output])
+        if show_progress
+          $stdout.sync = true
+          $stderr.sync = true
+        end
+
+        if path_obj.file?
+          # Single file mode - show detailed errors
+          analyze_single_file(path_obj)
+        else
+          # Directory mode - show batch report
+          svg_files = find_svg_files(path_obj)
+
+          if svg_files.empty?
+            puts "No SVG files found in #{path}"
+            return
+          end
+
+          puts "🔍 Scanning #{svg_files.size} SVG files..."
+          puts
+
+          reports = analyze_files_one_by_one(svg_files, show_progress)
+          batch_report = SvgQuality::BatchReport.new(reports)
+          sorted_report = sort_report(batch_report)
+          output_report(sorted_report)
+        end
+      end
+
+      def analyze_single_file(path)
+        validator = SvgConform::Validator.new
+        result = validator.validate_file(path.to_s, profile: options[:profile])
+
+        puts "📄 SVG Quality Report: #{path}"
+        puts ""
+        puts "  Valid: #{result.valid? ? 'YES ✅' : 'NO ❌'}"
+        puts "  Errors: #{result.error_count}"
+        puts ""
+
+        if result.errors.any?
+          puts "  📋 Error Details"
+          puts ""
+
+          # Group errors by requirement_id
+          by_req = result.errors.group_by(&:requirement_id)
+
+          by_req.each do |req_id, errors|
+            puts "  #{req_id} (#{errors.size} occurrences)"
+            errors.first(5).each do |e|
+              puts "    - #{e.message}"
+            end
+            if errors.size > 5
+              puts "    ... and #{errors.size - 5} more"
+            end
+            puts ""
+          end
+        end
+      end
+
+      private
+
+      attr_reader :options
+
+      def find_svg_files(path)
+        if path.directory?
+          Pathname.glob(path.join(options[:pattern])).select(&:file?)
+        elsif path.file? && path.extname == ".svg"
+          [path]
+        else
+          []
+        end
+      end
+
+      def analyze_files_one_by_one(files, show_progress = false)
+        validator = SvgConform::Validator.new
+        reports = []
+
+        files.each_with_index do |file, index|
+          result = validator.validate_file(file.to_s,
+                                           profile: options[:profile])
+          report = SvgQuality::Report.new(file.to_s, result)
+          reports << report
+
+          if show_progress
+            tier = report.quality_tier
+            status = report.valid? ? "✅" : "❌"
+            msg = "  [#{index + 1}/#{files.size}] #{tier[:emoji]} #{report.error_count} errors #{status} #{shorten_path(file)}\n"
+            $stderr.print msg
+            $stderr.flush
+          end
+        end
+
+        reports
+      end
+
+      def sort_report(batch_report)
+        case options[:sort]
+        when :quality
+          batch_report.sort_by_quality
+        else
+          batch_report.sort_by_errors
+        end
+      end
+
+      def output_report(batch_report)
+        filtered = batch_report.filter_by_min_errors(options[:min_errors])
+        limited = filtered.limit(options[:limit])
+
+        formatter = case options[:format].to_sym
+                    when :json
+                      SvgQuality::Formatters::JsonFormatter.new(limited,
+                                                                output: options[:output])
+                    when :yaml
+                      SvgQuality::Formatters::YamlFormatter.new(limited,
+                                                                output: options[:output])
+                    else
+                      SvgQuality::Formatters::TerminalFormatter.new(limited,
+                                                                    output: options[:output], sort: options[:sort])
+                    end
+
+        puts formatter.format
+      end
+
+      def shorten_path(path)
+        p = Pathname.new(path)
+        if p.absolute?
+          begin
+            p.relative_path_from(Pathname.pwd)
+          rescue StandardError
+            p
+          end
+        else
+          p
+        end.to_s
+      end
+    end
+  end
+end