Merge remote-tracking branch 'upstream/main' into feat/move-request-specs-too

* upstream/main:
  Modernize dependencies, fix CI, and add rubocop-gusto (rubyatscale#178)
  Fix typos and grammatical issues (rubyatscale#179)
  Add AGENTS.md and CLAUDE.md for AI coding agent guidance (rubyatscale#177)
  Add CODEOWNERS file (rubyatscale#176)

Author: Envek

.github/CODEOWNERS

@@ -0,0 +1 @@
+* @rubyatscale/ruby-at-scale

.rubocop.yml

@@ -1,3 +1,17 @@
+inherit_from: .rubocop_todo.yml
+
+inherit_mode:
+  merge:
+    - Exclude
+    - Include
+
+inherit_gem:
+  rubocop-gusto:
+    - config/default.yml
+
+plugins:
+  - rubocop-gusto
+
 # The behavior of RuboCop can be controlled via the .rubocop.yml
 # configuration file. It makes it possible to enable/disable
 # certain cops (checks) and to alter their behavior if they accept
@@ -13,7 +27,7 @@ AllCops:
   SuggestExtensions: false
   Exclude:
     - vendor/bundle/**/**
-  TargetRubyVersion: 2.6.0
+  TargetRubyVersion: 3.2
 
 Metrics/ParameterLists:
   Enabled: false
@@ -50,9 +64,6 @@ Style/GuardClause:
 Metrics/ModuleLength:
   Enabled: false
 
-Layout/LineLength:
-  Enabled: false
-
 Metrics/BlockLength:
   Enabled: false
 
@@ -93,10 +104,6 @@ Style/EmptyElse:
 Style/RedundantCondition:
   Enabled: false
 
-# This leads to code that is not very readable at times (very long lines)
-Layout/MultilineMethodCallIndentation:
-  Enabled: false
-
 # Blocks across lines are okay sometimes
 Style/BlockDelimiters:
   Enabled: false
@@ -105,19 +112,8 @@ Style/BlockDelimiters:
 Naming/AccessorMethodName:
   Enabled: false
 
-# This leads to code that is not very readable at times (very long lines)
-Layout/FirstArgumentIndentation:
-  Enabled: false
-
-# This leads to code that is not very readable at times (very long lines)
-Layout/ArgumentAlignment:
-  Enabled: false
-
 Style/AccessorGrouping:
   Enabled: false
 
 Style/NumericPredicate:
   Enabled: false
-
-Layout/BlockEndNewline:
-  Enabled: false

.rubocop_todo.yml

@@ -0,0 +1,75 @@
+# This configuration was generated by
+# `rubocop --auto-gen-config --auto-gen-only-exclude --exclude-limit 100`
+# on 2026-03-05 21:24:10 UTC using RuboCop version 1.85.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: 8
+Gusto/NoMetaprogramming:
+  Exclude:
+    - 'lib/packs/cli.rb'
+    - 'lib/packs/private/interactive_cli/use_cases/interface.rb'
+    - 'spec/packs/private/cli_spec.rb'
+
+# Offense count: 5
+# This cop supports safe autocorrection (--autocorrect).
+# Configuration parameters: AllowedPatterns.
+Sorbet/BlockMethodDefinition:
+  Exclude:
+    - 'spec/packs/private/cli_spec.rb'
+    - 'spec/packs_spec.rb'
+
+# Offense count: 2
+# This cop supports safe autocorrection (--autocorrect).
+# Configuration parameters: EnforcedStyle, BlockForwardingName.
+# SupportedStyles: anonymous, explicit
+Naming/BlockForwarding:
+  Exclude:
+    - 'lib/packs/configuration.rb'
+    - 'lib/packs/logging.rb'
+
+# Offense count: 1
+# Configuration parameters: Mode, AllowedMethods, AllowedPatterns, AllowBangMethods, WaywardPredicates.
+# AllowedMethods: call
+# WaywardPredicates: infinite?, nonzero?
+Naming/PredicateMethod:
+  Exclude:
+    - 'lib/packs/configuration.rb'
+
+# Offense count: 1
+Performance/MapMethodChain:
+  Exclude:
+    - 'lib/packs/private/interactive_cli/use_cases/get_info.rb'
+
+# Offense count: 65
+# Configuration parameters: Prefixes, AllowedPatterns.
+# Prefixes: when, with, without
+RSpec/ContextWording:
+  Exclude:
+    - 'spec/packs/private/cli_spec.rb'
+    - 'spec/packs_spec.rb'
+
+# Offense count: 2
+# Configuration parameters: CustomTransform, IgnoreMethods, IgnoreMetadata, InflectorPath, EnforcedInflector.
+# SupportedInflectors: default, active_support
+RSpec/SpecFilePathFormat:
+  Exclude:
+    - 'spec/packs/private/cli_spec.rb'
+    - 'spec/verify_docs_spec.rb'
+
+# Offense count: 12
+Sorbet/ConstantsFromStrings:
+  Exclude:
+    - 'spec/packs/private/cli_spec.rb'
+    - 'spec/packs_spec.rb'
+    - 'spec/spec_helper.rb'
+
+# Offense count: 2
+# This cop supports unsafe autocorrection (--autocorrect-all).
+# Configuration parameters: SuggestedStrictness.
+Sorbet/StrictSigil:
+  Exclude:
+    - 'sorbet/tapioca/require.rb'
+    - 'spec/spec_helper.rb'

AGENTS.md

@@ -0,0 +1,32 @@
+This file provides guidance to AI coding agents when working with code in this repository.
+
+## What this project is
+
+`packs` is a Ruby gem that provides the development CLI for the packs packaging system — a way to modularize Ruby applications. It provides `bin/packs` commands to create packs, move files between packs, add dependencies, and manage pack configuration.
+
+## Commands
+
+```bash
+bundle install
+
+# Run all tests (RSpec)
+bundle exec rspec
+
+# Run a single spec file
+bundle exec rspec spec/path/to/spec.rb
+
+# Lint
+bundle exec rubocop
+bundle exec rubocop -a  # auto-correct
+
+# Type checking (Sorbet)
+bundle exec srb tc
+```
+
+## Architecture
+
+- `lib/packs.rb` — public API entry point
+- `lib/packs/` — core library: `Configuration`, `CLI` (Thor-based command definitions), post-processors (`RubocopPostProcessor`, `CodeOwnershipPostProcessor`, `UpdateReferencesPostProcessor`), and the `UserEventLogger` interface
+- `lib/packs/private/` — internal implementation; `interactive_cli/` contains the interactive TUI mode
+- `bin/packs` — CLI executable; runs the interactive mode when called with no arguments, otherwise dispatches to `Packs::CLI` commands like `create`, `add_dependency`, `move`, `validate`, `check`
+- `spec/` — RSpec tests; tests use temporary directories created via `packs/rspec/support` rather than static fixtures

CLAUDE.md

@@ -0,0 +1 @@
+@AGENTS.md

Gemfile

@@ -2,5 +2,3 @@ source 'https://rubygems.org'
 
 # Specify your gem's dependencies in packs.gemspec
 gemspec
-
-gem 'packwerk', github: 'Shopify/packwerk', branch: 'main'