feat(cli): add --formats flag to support multiple output formats

Add support for selecting output formats via CLI with the new --formats flag.
Update documentation to explain usage and maintain existing programmatic config.

Author: JuanVqz

.trae/documents/Add --formats flag to Skunk CLI.md

@@ -0,0 +1,35 @@
+## Summary
+
+Add a new `--formats` CLI flag wired directly to `Skunk::Config.formats` during option parsing, plus documentation updates to show how to use it.
+
+## Implementation
+
+1. CLI option parsing
+
+- File: lib/skunk/cli/options/argv.rb
+  - Add `require "skunk/config"` at the top so the parser can set formats.
+  - In `parse`, add: `opts.on("--formats x,y,z", Array, "Output formats: json,html,console") { |list| Skunk::Config.formats = list.map(&:to_sym) }`
+  - Do not add any new accessors and do not modify `to_h`.
+
+2. Tests
+
+- File: test/lib/skunk/cli/options/argv_test.rb
+  - Add a test that passes `--formats=json,html`, invokes `parse`, asserts `Skunk::Config.formats == %i[json html]`, and resets with `Skunk::Config.reset`.
+
+3. Documentation
+
+- File: README.md
+  - Add a short “CLI formats” subsection showing:
+    - `skunk --formats=json`
+    - `skunk --formats=json,html`
+    - Mention accepted values: `json`, `html`, `console` and that default is `console` when omitted.
+  - Keep existing programmatic examples, but clarify they are equivalent to the CLI flag.
+
+## Validation
+
+- Run tests to ensure the flag is parsed and configuration is applied.
+- Optional manual steps: run `skunk --formats=json` and `skunk --formats=json,html` and observe the generated reports.
+
+## Notes
+
+- No changes to `Application` or option hashes; minimal surface change following your preference.

CHANGELOG.md

@@ -7,6 +7,7 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0
 
 ## main [(unreleased)](https://github.com/fastruby/skunk/compare/v0.5.4...HEAD)
 
+* [FEATURE: Add `--formats` CLI flag to select report formats (json, html, console)]
 * [REFACTOR: Move Console Report](https://github.com/fastruby/skunk/pull/128)
 * [BUGFIX: Set the right content type in the share HTTP request](https://github.com/fastruby/skunk/pull/129)
 * [REFACTOR: Centralize Skunk analysis into RubyCritic module](https://github.com/fastruby/skunk/pull/127)

README.md

@@ -158,16 +158,33 @@ This should give you an idea if you're moving in the direction of maintaining th
 
 ### Setting Output Formats
 
-Skunk provides a simple configuration class to control output formats programmatically. You can use `Skunk::Config` to set which formats should be generated when running Skunk.
+Skunk supports multiple output formats and you can select them via CLI or programmatically.
 
 **Supported formats:**
-- `:json` - JSON report (default)
+- `:json` - JSON report
 - `:html` - HTML report with visual charts and tables
+- `:console` - Console output (default)
+
+#### CLI flag
+
+You can choose one or more formats from the command line:
+
+```
+skunk --formats=json
+skunk --f json,html
+skunk --formats console,json
+```
+
+If omitted, Skunk defaults to `console`.
+
+#### Programmatic configuration
+
+You can also configure formats in code using `Skunk::Config`:
 
 ```ruby
 require 'skunk/config'
 
-# Set multiple formats
+# Set multiple formats (equivalent to `--formats=json,html`)
 Skunk::Config.formats = [:json, :html]
 
 # Add a format to the existing list
@@ -177,7 +194,7 @@ Skunk::Config.add_format(:html)
 Skunk::Config.remove_format(:json)
 
 # Check supported formats
-Skunk::Config.supported_formats # => [:json, :html]
+Skunk::Config.supported_formats # => [:json, :html, :console]
 Skunk::Config.supported_format?(:json) # => true
 
 # Reset to defaults

lib/skunk/cli/options/argv.rb

@@ -1,6 +1,7 @@
 # frozen_string_literal: true
 
 require "rubycritic/cli/options/argv"
+require "skunk/config"
 
 module Skunk
   module Cli
@@ -26,6 +27,10 @@ def parse
               self.output_filename = filename
             end
 
+            opts.on("-f", "--formats x,y,z", Array, "Output formats: json,html,console") do |list|
+              Skunk::Config.formats = Array(list).map(&:to_sym)
+            end
+
             opts.on_tail("-v", "--version", "Show gem's version") do
               self.mode = :version
             end

test/lib/skunk/cli/options/argv_test.rb

@@ -24,4 +24,20 @@
       end
     end
   end
+
+  describe "#formats" do
+    context "passing --formats option" do
+      let(:argv) { ["--formats=json,html"] }
+
+      it "applies formats to Skunk::Config" do
+        begin
+          parser = Skunk::Cli::Options::Argv.new(argv)
+          parser.parse
+          _(Skunk::Config.formats).must_equal %i[json html]
+        ensure
+          Skunk::Config.reset
+        end
+      end
+    end
+  end
 end