iml 0.1.5 → 0.2.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
-SHA1:
-  metadata.gz: b7e6733d34170f5e21e789e97e1bab6445ca7c27
-  data.tar.gz: c4cb48f0dfed03e962079557cb6d1f2a8109b892
+SHA256:
+  metadata.gz: 0df9f622d736c3aa7a80b02aa71d1b038dfb0a3f2f6f050d09a8a012c0e1c6fc
+  data.tar.gz: 72ae2f50c874deec6f145861114a14d4d3cff71a80dbbc74a127bd80d841958c
 SHA512:
-  metadata.gz: 7aa32d2ce71502c7f83f7bf5b49cbd0278dabde6045aa92a00d72c1c08b655e48538b669630a16c6821641904ad69073d068fd81adaa0d0b1a929b7888656f1d
-  data.tar.gz: 80793842a7767881a3e243d04f31f76b73f0786ab6c61272fca0af9f3c6d1a57828f97fda8796fd55ad4d96e83dbfc0dacc1fb8285ed91fb25dcc6e4c5c6208f
+  metadata.gz: ee56baf5a3197379b45cae3065881ef7f2a2517e60434c4cc54a16a55a8e9afd57ef8edf85f94c895e0256ed99ff7190d553a8113bd1acb7757f097b8865cb1e
+  data.tar.gz: 89aba00474efb6bda24faf7c9ba76c8b17cd6d691602a1f1712299c6c33c160fdf4578674d433f7daf4b79f93805d936e82b0d7b5a95b083df33fd2564a6df0c

data/.claude/settings.local.json

@@ -0,0 +1,7 @@
+{
+  "permissions": {
+    "allow": [
+      "WebFetch(domain:thepiratebay.org)"
+    ]
+  }
+}

data/.github/workflows/ci.yml

@@ -0,0 +1,30 @@
+name: CI
+
+on:
+  push:
+    branches: [master]
+  pull_request:
+    branches: [master]
+
+jobs:
+  test:
+    runs-on: ubuntu-latest
+
+    strategy:
+      matrix:
+        ruby-version: ['3.1', '3.2', '3.3']
+
+    steps:
+      - uses: actions/checkout@v4
+
+      - name: Set up Ruby
+        uses: ruby/setup-ruby@v1
+        with:
+          ruby-version: ${{ matrix.ruby-version }}
+          bundler-cache: true
+
+      - name: Run tests
+        run: bundle exec rspec
+
+      - name: Run linter
+        run: bundle exec standardrb

data/.github/workflows/publish.yml

@@ -0,0 +1,32 @@
+name: Publish Gem
+
+on:
+  push:
+    tags:
+      - 'v*'
+
+permissions:
+  contents: write
+  packages: write
+  id-token: write
+
+jobs:
+  publish:
+    runs-on: ubuntu-latest
+
+    steps:
+      - uses: actions/checkout@v4
+
+      - name: Set up Ruby
+        uses: ruby/setup-ruby@v1
+        with:
+          ruby-version: '3.3'
+          bundler-cache: true
+
+      - name: Publish to RubyGems
+        uses: rubygems/release-gem@v1
+
+      - name: Publish to GitHub Packages
+        env:
+          GEM_HOST_API_KEY: "Bearer ${{ secrets.GITHUB_TOKEN }}"
+        run: gem push --host https://rubygems.pkg.github.com/${{ github.repository_owner }} pkg/*.gem

data/Gemfile

@@ -1,6 +1,6 @@
 # frozen_string_literal: true
 
-source 'https://rubygems.org'
+source "https://rubygems.org"
 
 git_source(:github) { |repo_name| "https://github.com/#{repo_name}" }
 

data/Gemfile.lock

@@ -1,87 +1,127 @@
 PATH
   remote: .
   specs:
-    iml (0.1.5)
-      activesupport (~> 5.2)
-      nokogiri (~> 1.8)
-      tqdm (~> 0.3)
+    iml (0.2.0)
 
 GEM
   remote: https://rubygems.org/
   specs:
-    activesupport (5.2.0)
-      concurrent-ruby (~> 1.0, >= 1.0.2)
-      i18n (>= 0.7, < 2)
-      minitest (~> 5.1)
-      tzinfo (~> 1.1)
-    addressable (2.5.2)
-      public_suffix (>= 2.0.2, < 4.0)
-    codeclimate-test-reporter (1.0.7)
-      simplecov
-    coderay (1.1.2)
-    concurrent-ruby (1.0.5)
-    crack (0.4.3)
-      safe_yaml (~> 1.0.0)
-    diff-lcs (1.3)
-    docile (1.3.1)
-    hashdiff (0.3.7)
-    i18n (1.0.1)
-      concurrent-ruby (~> 1.0)
-    json (2.1.0)
-    method_source (0.9.0)
-    mini_portile2 (2.3.0)
-    minitest (5.11.3)
-    nokogiri (1.8.4)
-      mini_portile2 (~> 2.3.0)
-    pry (0.11.3)
-      coderay (~> 1.1.0)
-      method_source (~> 0.9.0)
-    public_suffix (3.0.2)
-    rake (12.3.1)
-    rspec (3.7.0)
-      rspec-core (~> 3.7.0)
-      rspec-expectations (~> 3.7.0)
-      rspec-mocks (~> 3.7.0)
-    rspec-core (3.7.1)
-      rspec-support (~> 3.7.0)
-    rspec-expectations (3.7.0)
+    ast (2.4.3)
+    diff-lcs (1.6.2)
+    docile (1.4.1)
+    json (2.18.1)
+    language_server-protocol (3.17.0.5)
+    lint_roller (1.1.0)
+    parallel (1.27.0)
+    parser (3.3.10.1)
+      ast (~> 2.4.1)
+      racc
+    prism (1.9.0)
+    racc (1.8.1)
+    rainbow (3.1.1)
+    rake (13.3.1)
+    regexp_parser (2.11.3)
+    rspec (3.13.2)
+      rspec-core (~> 3.13.0)
+      rspec-expectations (~> 3.13.0)
+      rspec-mocks (~> 3.13.0)
+    rspec-core (3.13.6)
+      rspec-support (~> 3.13.0)
+    rspec-expectations (3.13.5)
       diff-lcs (>= 1.2.0, < 2.0)
-      rspec-support (~> 3.7.0)
-    rspec-mocks (3.7.0)
+      rspec-support (~> 3.13.0)
+    rspec-mocks (3.13.7)
       diff-lcs (>= 1.2.0, < 2.0)
-      rspec-support (~> 3.7.0)
-    rspec-support (3.7.1)
-    safe_yaml (1.0.4)
-    simplecov (0.16.1)
+      rspec-support (~> 3.13.0)
+    rspec-support (3.13.7)
+    rubocop (1.82.1)
+      json (~> 2.3)
+      language_server-protocol (~> 3.17.0.2)
+      lint_roller (~> 1.1.0)
+      parallel (~> 1.10)
+      parser (>= 3.3.0.2)
+      rainbow (>= 2.2.2, < 4.0)
+      regexp_parser (>= 2.9.3, < 3.0)
+      rubocop-ast (>= 1.48.0, < 2.0)
+      ruby-progressbar (~> 1.7)
+      unicode-display_width (>= 2.4.0, < 4.0)
+    rubocop-ast (1.49.0)
+      parser (>= 3.3.7.2)
+      prism (~> 1.7)
+    rubocop-performance (1.26.1)
+      lint_roller (~> 1.1)
+      rubocop (>= 1.75.0, < 2.0)
+      rubocop-ast (>= 1.47.1, < 2.0)
+    ruby-progressbar (1.13.0)
+    simplecov (0.22.0)
       docile (~> 1.1)
-      json (>= 1.8, < 3)
-      simplecov-html (~> 0.10.0)
-    simplecov-html (0.10.2)
-    thread_safe (0.3.6)
-    tqdm (0.3.0)
-    tzinfo (1.2.5)
-      thread_safe (~> 0.1)
-    vcr (4.0.0)
-    webmock (3.4.2)
-      addressable (>= 2.3.6)
-      crack (>= 0.3.2)
-      hashdiff
-    yard (0.9.14)
+      simplecov-html (~> 0.11)
+      simplecov_json_formatter (~> 0.1)
+    simplecov-html (0.13.2)
+    simplecov_json_formatter (0.1.4)
+    standard (1.53.0)
+      language_server-protocol (~> 3.17.0.2)
+      lint_roller (~> 1.0)
+      rubocop (~> 1.82.0)
+      standard-custom (~> 1.0.0)
+      standard-performance (~> 1.8)
+    standard-custom (1.0.2)
+      lint_roller (~> 1.0)
+      rubocop (~> 1.50)
+    standard-performance (1.9.0)
+      lint_roller (~> 1.1)
+      rubocop-performance (~> 1.26.0)
+    unicode-display_width (3.2.0)
+      unicode-emoji (~> 4.1)
+    unicode-emoji (4.2.0)
+    yard (0.9.38)
 
 PLATFORMS
+  arm64-darwin-25
   ruby
 
 DEPENDENCIES
-  bundler (~> 1.16)
-  codeclimate-test-reporter (~> 1.0)
+  bundler (>= 2.4)
   iml!
-  pry (~> 0.11)
-  rake (~> 12.3)
-  rspec (~> 3.7)
-  simplecov (~> 0.16)
-  vcr (~> 4.0)
-  webmock (~> 3.4)
+  rake (~> 13.0)
+  rspec (~> 3.13)
+  simplecov (~> 0.22)
+  standard (~> 1.40)
   yard (~> 0.9)
 
+CHECKSUMS
+  ast (2.4.3) sha256=954615157c1d6a382bc27d690d973195e79db7f55e9765ac7c481c60bdb4d383
+  diff-lcs (1.6.2) sha256=9ae0d2cba7d4df3075fe8cd8602a8604993efc0dfa934cff568969efb1909962
+  docile (1.4.1) sha256=96159be799bfa73cdb721b840e9802126e4e03dfc26863db73647204c727f21e
+  iml (0.2.0)
+  json (2.18.1) sha256=fe112755501b8d0466b5ada6cf50c8c3f41e897fa128ac5d263ec09eedc9f986
+  language_server-protocol (3.17.0.5) sha256=fd1e39a51a28bf3eec959379985a72e296e9f9acfce46f6a79d31ca8760803cc
+  lint_roller (1.1.0) sha256=2c0c845b632a7d172cb849cc90c1bce937a28c5c8ccccb50dfd46a485003cc87
+  parallel (1.27.0) sha256=4ac151e1806b755fb4e2dc2332cbf0e54f2e24ba821ff2d3dcf86bf6dc4ae130
+  parser (3.3.10.1) sha256=06f6a725d2cd91e5e7f2b7c32ba143631e1f7c8ae2fb918fc4cebec187e6a688
+  prism (1.9.0) sha256=7b530c6a9f92c24300014919c9dcbc055bf4cdf51ec30aed099b06cd6674ef85
+  racc (1.8.1) sha256=4a7f6929691dbec8b5209a0b373bc2614882b55fc5d2e447a21aaa691303d62f
+  rainbow (3.1.1) sha256=039491aa3a89f42efa1d6dec2fc4e62ede96eb6acd95e52f1ad581182b79bc6a
+  rake (13.3.1) sha256=8c9e89d09f66a26a01264e7e3480ec0607f0c497a861ef16063604b1b08eb19c
+  regexp_parser (2.11.3) sha256=ca13f381a173b7a93450e53459075c9b76a10433caadcb2f1180f2c741fc55a4
+  rspec (3.13.2) sha256=206284a08ad798e61f86d7ca3e376718d52c0bc944626b2349266f239f820587
+  rspec-core (3.13.6) sha256=a8823c6411667b60a8bca135364351dda34cd55e44ff94c4be4633b37d828b2d
+  rspec-expectations (3.13.5) sha256=33a4d3a1d95060aea4c94e9f237030a8f9eae5615e9bd85718fe3a09e4b58836
+  rspec-mocks (3.13.7) sha256=0979034e64b1d7a838aaaddf12bf065ea4dc40ef3d4c39f01f93ae2c66c62b1c
+  rspec-support (3.13.7) sha256=0640e5570872aafefd79867901deeeeb40b0c9875a36b983d85f54fb7381c47c
+  rubocop (1.82.1) sha256=09f1a6a654a960eda767aebea33e47603080f8e9c9a3f019bf9b94c9cab5e273
+  rubocop-ast (1.49.0) sha256=49c3676d3123a0923d333e20c6c2dbaaae2d2287b475273fddee0c61da9f71fd
+  rubocop-performance (1.26.1) sha256=cd19b936ff196df85829d264b522fd4f98b6c89ad271fa52744a8c11b8f71834
+  ruby-progressbar (1.13.0) sha256=80fc9c47a9b640d6834e0dc7b3c94c9df37f08cb072b7761e4a71e22cff29b33
+  simplecov (0.22.0) sha256=fe2622c7834ff23b98066bb0a854284b2729a569ac659f82621fc22ef36213a5
+  simplecov-html (0.13.2) sha256=bd0b8e54e7c2d7685927e8d6286466359b6f16b18cb0df47b508e8d73c777246
+  simplecov_json_formatter (0.1.4) sha256=529418fbe8de1713ac2b2d612aa3daa56d316975d307244399fa4838c601b428
+  standard (1.53.0) sha256=f3c9493385db7079d0abce6f7582f553122156997b81258cd361d3480eeacf9c
+  standard-custom (1.0.2) sha256=424adc84179a074f1a2a309bb9cf7cd6bfdb2b6541f20c6bf9436c0ba22a652b
+  standard-performance (1.9.0) sha256=49483d31be448292951d80e5e67cdcb576c2502103c7b40aec6f1b6e9c88e3f2
+  unicode-display_width (3.2.0) sha256=0cdd96b5681a5949cdbc2c55e7b420facae74c4aaf9a9815eee1087cb1853c42
+  unicode-emoji (4.2.0) sha256=519e69150f75652e40bf736106cfbc8f0f73aa3fb6a65afe62fefa7f80b0f80f
+  yard (0.9.38) sha256=721fb82afb10532aa49860655f6cc2eaa7130889df291b052e1e6b268283010f
+
 BUNDLED WITH
-   1.16.2
+  4.0.5

data/PLAN.md

@@ -0,0 +1,350 @@
+# Plan: IML Gem Comprehensive Refactor
+
+## Phase 1: Modernize Dependencies and Tooling
+
+### Description
+Update all dependencies to modern versions, replace Travis CI with GitHub Actions for testing, switch linting from RuboCop to StandardRB, and bump minimum Ruby version to 3.1+. This phase establishes the foundation for all subsequent changes.
+
+### Steps
+
+#### Step 1.1: Update Ruby Version Requirement and Gemspec
+- **Objective**: Bump minimum Ruby to 3.1, modernize gemspec structure
+- **Files**: `iml.gemspec`, `gemspec.yml`, `.ruby-version` (create)
+- **Dependencies**: None
+- **Implementation**:
+  - Set `required_ruby_version` to `>= 3.1`
+  - Update `activesupport` from `~> 5.2` to `~> 7.1`
+  - Update `bundler` dev dependency to `~> 2.4`
+  - Update `rake` to `~> 13.0`
+  - Update `rspec` to `~> 3.13`
+  - Replace `simplecov ~> 0.16` with `simplecov ~> 0.22`
+  - Remove `codeclimate-test-reporter` (deprecated)
+  - Remove `pry` dependency (use `irb` or `debug` gem instead)
+  - Remove `tqdm` dependency (replace with Ruby-native progress in CLI)
+  - Add `standard ~> 1.40` as dev dependency
+  - Create `.ruby-version` file with `3.1.0`
+
+#### Step 1.2: Replace Travis CI with GitHub Actions
+- **Objective**: Modern CI pipeline with matrix testing
+- **Files**: `.github/workflows/ci.yml` (create), `.travis.yml` (delete)
+- **Dependencies**: Step 1.1
+- **Implementation**:
+  - Create GitHub Actions workflow for CI (Ruby 3.1, 3.2, 3.3)
+  - Run `bundle exec rspec` and `bundle exec standardrb`
+  - Remove `.travis.yml`
+
+#### Step 1.3: Switch Linting to StandardRB
+- **Objective**: Replace RuboCop with StandardRB for zero-config linting
+- **Files**: `.rubocop.yml` (delete), `.standard.yml` (create)
+- **Dependencies**: Step 1.1
+- **Implementation**:
+  - Remove `.rubocop.yml`
+  - Create `.standard.yml` if any overrides needed
+  - Update Rakefile to include StandardRB task
+
+#### Step 1.4: Update Gemfile and Run Bundle Install
+- **Objective**: Lock new dependency versions
+- **Files**: `Gemfile`, `Gemfile.lock`
+- **Dependencies**: Steps 1.1-1.3
+- **Implementation**:
+  - Update Gemfile if needed
+  - Run `bundle install`
+  - Verify all dependencies resolve
+
+## Phase 2: Architecture Rewrite — Composition Over Inheritance
+
+### Description
+Replace OpenStruct inheritance with plain Ruby objects using composition. Eliminate `method_missing` reliance in favor of explicit interfaces. Replace `IML::Hash` with a simple configuration object. This phase fundamentally restructures the core domain model.
+
+### Steps
+
+#### Step 2.1: Create Configuration Module
+- **Objective**: Replace `IML::Hash` and `IML::Patterns.config` with a proper configuration object
+- **Files**: `lib/iml/configuration.rb` (create), `lib/iml/hash.rb` (delete)
+- **Dependencies**: Phase 1 complete
+- **Implementation**:
+  - Create `IML::Configuration` class that loads `patterns.yml`
+  - Use `Struct` or plain Ruby with explicit accessors instead of `HashWithIndifferentAccess`
+  - Provide `IML.configuration` singleton method
+  - Cache loaded config (load once, not on every pattern build)
+  - Remove dependency on `activesupport/core_ext/hash`
+
+#### Step 2.2: Rewrite Pattern Builder
+- **Objective**: Replace `method_missing`-based pattern building with explicit methods
+- **Files**: `lib/iml/pattern_builder.rb` (create), `lib/iml/patterns.rb` (rewrite)
+- **Dependencies**: Step 2.1
+- **Implementation**:
+  - Create `IML::PatternBuilder` that constructs regex from config
+  - Explicit methods for each pattern component (`title_pattern`, `year_pattern`, etc.)
+  - Move pattern templates (movie/tv formats) into config or constants
+  - Remove `method_missing` / `respond_to_missing?` from patterns
+  - Return frozen Regexp objects
+
+#### Step 2.3: Create Media Result Value Objects
+- **Objective**: Replace OpenStruct-based Base/Movie/TVSeries with composition-based value objects
+- **Files**: `lib/iml/media/result.rb` (create), `lib/iml/media/movie.rb` (create), `lib/iml/media/tv_series.rb` (create)
+- **Dependencies**: Step 2.1
+- **Implementation**:
+  - Create `IML::Media::Result` as a plain Ruby class with explicit attributes
+  - Use `Data.define` (Ruby 3.2+) or `Struct` for immutable value objects
+  - Compose with a `Formatter` for output path generation (not inherited)
+  - Compose with a `Normalizer` for codec/audio normalization
+  - `IML::Media::Movie` and `IML::Media::TvSeries` as specialized result types
+  - Remove all OpenStruct usage
+
+#### Step 2.4: Create Formatter Service
+- **Objective**: Extract output path formatting into a dedicated service
+- **Files**: `lib/iml/formatter.rb` (create)
+- **Dependencies**: Step 2.3
+- **Implementation**:
+  - Create `IML::Formatter` that takes a result and format string
+  - `call(result, format: nil)` returns formatted string
+  - Placeholder definitions live with the formatter, not the model
+  - Support custom format strings
+
+#### Step 2.5: Create Normalizer Service
+- **Objective**: Extract codec/audio normalization into a dedicated service
+- **Files**: `lib/iml/normalizer.rb` (create)
+- **Dependencies**: Steps 2.1, 2.3
+- **Implementation**:
+  - Create `IML::Normalizer` that normalizes codec and audio names
+  - `call(attributes)` returns normalized attribute hash
+  - Uses config for lookup tables
+  - Handles title case conversion
+
+#### Step 2.6: Rewrite Parser (formerly Text)
+- **Objective**: Replace `IML::Text < String` with a proper parser using composition
+- **Files**: `lib/iml/parser.rb` (create), `lib/iml/text.rb` (delete)
+- **Dependencies**: Steps 2.2, 2.3, 2.5
+- **Implementation**:
+  - Create `IML::Parser` class (does not inherit from String)
+  - `parse(filename)` returns `Media::Movie`, `Media::TvSeries`, or `nil`
+  - Inject pattern builder and normalizer
+  - Clean separation: parsing, normalization, and result creation are distinct steps
+
+#### Step 2.7: Create File Mover Service
+- **Objective**: Extract file operations from Base into a dedicated service
+- **Files**: `lib/iml/file_mover.rb` (create)
+- **Dependencies**: Steps 2.3, 2.4
+- **Implementation**:
+  - Create `IML::FileMover` service
+  - `call(source_path, result, format: nil, target: nil, pretend: false)`
+  - Handles directory creation, file moving, error handling
+  - Returns result object (success/failure) instead of integer codes
+
+#### Step 2.8: Update Main Entry Point
+- **Objective**: Wire up new architecture in `lib/iml.rb`
+- **Files**: `lib/iml.rb` (rewrite)
+- **Dependencies**: Steps 2.1-2.7
+- **Implementation**:
+  - Remove old requires (text, base, movie, tvseries, hash)
+  - Add new requires (configuration, parser, formatter, normalizer, file_mover, media/*)
+  - Provide `IML.parse(filename)` convenience method
+  - Provide `IML.configuration` accessor
+  - Remove conditional `pry` require
+  - Remove `puts` for missing iml-imdb (use proper logging or silence)
+
+#### Step 2.9: Delete Legacy Files
+- **Objective**: Remove old architecture files
+- **Files**: `lib/iml/base.rb`, `lib/iml/text.rb`, `lib/iml/movie.rb`, `lib/iml/tvseries.rb`, `lib/iml/hash.rb` (all delete)
+- **Dependencies**: Steps 2.6-2.8
+- **Implementation**:
+  - Delete all legacy class files
+  - Verify no remaining references
+
+## Phase 3: CLI Modernization
+
+### Description
+Rewrite the CLI script to use the new architecture, add `--version` flag, remove `tqdm` dependency, and improve error handling.
+
+### Steps
+
+#### Step 3.1: Rewrite CLI Script
+- **Objective**: Modern CLI using new architecture with proper structure
+- **Files**: `bin/iml` (rewrite)
+- **Dependencies**: Phase 2 complete
+- **Implementation**:
+  - Add `--version` / `-V` flag (print `IML::VERSION` and exit)
+  - Replace `tqdm` progress bar with simple STDERR output or `$stderr.print`
+  - Use `IML::Parser` and `IML::FileMover` services
+  - Move `file_operations` from top-level method into a CLI class or module
+  - Proper exit codes (0 success, 1 error)
+  - Replace `Logger.new(STDOUT)` with configurable logger
+  - Handle SIGINT gracefully
+
+## Phase 4: Remove ActiveSupport Dependency
+
+### Description
+Replace remaining ActiveSupport usage with lightweight Ruby equivalents to eliminate the heavy dependency.
+
+### Steps
+
+#### Step 4.1: Replace ActiveSupport Inflector
+- **Objective**: Remove `titleize` dependency on ActiveSupport
+- **Files**: `lib/iml/utils.rb` (create)
+- **Dependencies**: Phase 2 complete
+- **Implementation**:
+  - Create `IML::Utils.titleize(string)` — simple implementation
+  - Replace `.titleize` calls with `IML::Utils.titleize`
+  - Verify edge cases match expected behavior
+
+#### Step 4.2: Remove HashWithIndifferentAccess Usage
+- **Objective**: Eliminate remaining ActiveSupport hash dependency
+- **Files**: Various (already handled in Phase 2 config rewrite)
+- **Dependencies**: Step 2.1
+- **Implementation**:
+  - Verify `IML::Configuration` uses plain Ruby hashes with string keys
+  - Use `transform_keys(&:to_s)` or `symbolize_keys` as needed
+  - Remove `require 'active_support/core_ext/hash'`
+
+#### Step 4.3: Remove ActiveSupport from Gemspec
+- **Objective**: Drop the activesupport runtime dependency entirely
+- **Files**: `gemspec.yml`, `lib/iml.rb`
+- **Dependencies**: Steps 4.1-4.2
+- **Implementation**:
+  - Remove `activesupport` from dependencies in `gemspec.yml`
+  - Remove all `require 'active_support/*'` lines
+  - Run tests to verify nothing breaks
+
+## Phase 5: Comprehensive Test Suite
+
+### Description
+Rewrite the test suite to match the new architecture with thorough coverage, proper organization, and `:verified` tags.
+
+### Steps
+
+#### Step 5.1: Set Up Test Infrastructure
+- **Objective**: Modern RSpec configuration with proper helpers
+- **Files**: `spec/spec_helper.rb` (rewrite), `.rspec` (update)
+- **Dependencies**: Phase 2 complete
+- **Implementation**:
+  - Configure SimpleCov with minimum coverage threshold
+  - Add `:verified` tag filtering
+  - Set up shared contexts for common test data
+  - Create `spec/support/` directory for shared examples
+
+#### Step 5.2: Test Configuration
+- **Objective**: Full coverage of pattern configuration loading
+- **Files**: `spec/configuration_spec.rb` (create)
+- **Dependencies**: Step 5.1
+- **Implementation**:
+  - Test config loads from YAML
+  - Test all config keys accessible
+  - Test caching behavior
+  - Test with missing/malformed config file
+
+#### Step 5.3: Test Pattern Builder
+- **Objective**: Full coverage of regex pattern construction
+- **Files**: `spec/pattern_builder_spec.rb` (create)
+- **Dependencies**: Step 5.1
+- **Implementation**:
+  - Test each pattern component generates valid regex
+  - Test movie patterns match expected filenames
+  - Test TV patterns match expected filenames
+  - Test patterns reject non-matching filenames
+  - Edge cases: special characters, unusual formats
+
+#### Step 5.4: Test Parser
+- **Objective**: Comprehensive filename parsing tests
+- **Files**: `spec/parser_spec.rb` (create)
+- **Dependencies**: Step 5.1
+- **Implementation**:
+  - Test movie detection with various formats
+  - Test TV series detection with various formats
+  - Test unrecognized filenames return nil
+  - Test edge cases: missing fields, unusual separators, 4K content
+  - Test with real-world filename examples
+
+#### Step 5.5: Test Media Result Objects
+- **Objective**: Full coverage of value objects
+- **Files**: `spec/media/movie_spec.rb` (create), `spec/media/tv_series_spec.rb` (create)
+- **Dependencies**: Step 5.1
+- **Implementation**:
+  - Test attribute access
+  - Test immutability (if using Data.define)
+  - Test type predicates (`movie?`, `tv?`)
+  - Test season_i / episode_i for TV series
+
+#### Step 5.6: Test Formatter
+- **Objective**: Full coverage of output path formatting
+- **Files**: `spec/formatter_spec.rb` (create)
+- **Dependencies**: Step 5.1
+- **Implementation**:
+  - Test default format strings for movie and TV
+  - Test custom format strings
+  - Test all placeholder substitutions
+  - Test with missing attributes (graceful handling)
+
+#### Step 5.7: Test Normalizer
+- **Objective**: Full coverage of codec/audio normalization
+- **Files**: `spec/normalizer_spec.rb` (create)
+- **Dependencies**: Step 5.1
+- **Implementation**:
+  - Test video codec normalization (x264 -> h.264, etc.)
+  - Test audio codec normalization with channels
+  - Test title case conversion
+  - Test unknown codecs pass through unchanged
+
+#### Step 5.8: Test File Mover
+- **Objective**: Full coverage of file operations
+- **Files**: `spec/file_mover_spec.rb` (create)
+- **Dependencies**: Step 5.1
+- **Implementation**:
+  - Test directory creation
+  - Test file moving
+  - Test pretend mode (no actual operations)
+  - Test error handling (missing source, permission errors)
+  - Use tmpdir for actual file operations
+
+#### Step 5.9: Delete Legacy Tests
+- **Objective**: Remove old test file
+- **Files**: `spec/iml_spec.rb` (delete)
+- **Dependencies**: Steps 5.2-5.8
+- **Implementation**:
+  - Delete monolithic test file
+  - Verify all test scenarios covered by new specs
+  - Run full suite to confirm green
+
+## Phase 6: Final Cleanup and Verification
+
+### Description
+Run all linters and tests, verify the gem builds, update documentation, and ensure everything is release-ready.
+
+### Steps
+
+#### Step 6.1: Run StandardRB and Fix Issues
+- **Objective**: Zero linting warnings
+- **Files**: Various (auto-fix)
+- **Dependencies**: Phases 1-5 complete
+- **Implementation**:
+  - Run `bundle exec standardrb --fix .`
+  - Review and manually fix any remaining issues
+  - Ensure all files have `frozen_string_literal: true`
+
+#### Step 6.2: Run Full Test Suite
+- **Objective**: All tests pass with good coverage
+- **Files**: None (verification only)
+- **Dependencies**: Step 6.1
+- **Implementation**:
+  - Run `bundle exec rspec`
+  - Verify coverage meets threshold
+  - Fix any failures
+
+#### Step 6.3: Build and Verify Gem
+- **Objective**: Gem builds cleanly
+- **Files**: None (verification only)
+- **Dependencies**: Step 6.2
+- **Implementation**:
+  - Run `gem build iml.gemspec`
+  - Verify gem file contents are correct
+  - Test `gem install` locally
+
+#### Step 6.4: Update README
+- **Objective**: Documentation reflects new architecture and usage
+- **Files**: `README.md`
+- **Dependencies**: Step 6.2
+- **Implementation**:
+  - Update usage examples to new API (`IML.parse`)
+  - Update dependency requirements (Ruby 3.1+)
+  - Document new CLI flags (`--version`)
+  - Remove references to ActiveSupport