supplies 0.1.0

checksums.yaml

@@ -0,0 +1,7 @@
+---
+SHA256:
+  metadata.gz: 9e11cbc6df13eb326ec0edb3173745f8587491ed655c118452d703f01ac6f63f
+  data.tar.gz: 62e11a3e89ff59487d48966ce4b7025e2b2e19ef501ed41d92330daa17e5e377
+SHA512:
+  metadata.gz: c63d3e472513b2d286c9cc38849e39dafc25612889a5db4d7c468334d1f0eb9594e1415cc0b657ac97cde91c76059a0fda24de490890f64710b3811060050078
+  data.tar.gz: f3b9d9524a0e3d44fc0fea7e98eb637e3302b429d278b9486a4a218b12440b94aee0d4000eae4daa61aa9dec9e1669bddb2b7f5e55494192d8326b51b9a5448c

data/LICENSE.txt

@@ -0,0 +1,21 @@
+The MIT License (MIT)
+
+Copyright (c) 2025 Launch Supply
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in
+all copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN
+THE SOFTWARE.

data/README.md

@@ -0,0 +1,271 @@
+# Supplies
+
+Shared Ruby patterns, linting configuration, and AI workflows for Launch Supply Rails development.
+
+## What's in This Repo
+
+Supplies serves two purposes with **different distribution paths**:
+
+| Purpose | Distribution | What it includes |
+|---------|--------------|------------------|
+| **Ruby code** | Public gem on RubyGems | `Supplies::Functional`, RuboCop configs, generators |
+| **AI workflows** | Local clone only | CLAUDE.md, commands, CLI |
+
+## Quick Start
+
+### For Ruby Code (Public Gem)
+
+```ruby
+# Gemfile
+gem 'supplies'
+```
+
+```bash
+bundle install
+rails g supplies:install  # Sets up RuboCop config
+```
+
+### For AI Workflows (Local Clone)
+
+```bash
+# One-time setup per developer machine
+cd ~/Source/launch-supply
+git clone git@github.com:launch-supply/supplies.git
+
+# Add to ~/.zshrc or ~/.bashrc
+export SUPPLIES_ROOT="$HOME/Source/launch-supply/supplies"
+export PATH="$SUPPLIES_ROOT/bin:$PATH"
+
+# Reload shell
+source ~/.zshrc
+
+# Initialize the hub (once per workspace)
+cd ~/Source/launch-supply
+supplies hub init
+
+# Initialize each project
+cd mission-control
+supplies project init
+```
+
+## Terminology
+
+| Term | Definition |
+|------|------------|
+| **Supply Hub** | Directory with shared CLAUDE.md symlink. All projects under it inherit shared workflows. |
+| **Supplied Project** | A project initialized with `supplies project init`. Has its own CLAUDE.md with variables. |
+| **Supply Root** | Local clone of this repo. Set via `$SUPPLIES_ROOT`. |
+
+## Directory Structure
+
+```
+$SUPPLIES_ROOT/
+├── lib/                              # Published to RubyGems
+│   ├── supplies.rb
+│   └── supplies/
+│       ├── functional.rb
+│       └── version.rb
+├── config/rubocop/                   # Published to RubyGems
+│   ├── base.yml
+│   ├── rails.yml
+│   └── ...
+├── ai/                               # Local clone only (NOT in gem)
+│   ├── CLAUDE.md                     # Shared AI workflow base
+│   └── commands/                     # Shared command templates
+└── bin/
+    └── supplies                      # CLI (local clone only)
+
+Supply Hub (~/Source/launch-supply/)
+├── CLAUDE.md → $SUPPLIES_ROOT/ai/CLAUDE.md
+├── mission-control/
+│   ├── CLAUDE.md                     # Project-specific
+│   └── .claude/commands/             # Symlinks to shared
+└── batch-table/
+    ├── CLAUDE.md
+    └── .claude/commands/
+```
+
+## CLI Commands
+
+```bash
+# Hub Commands (run from the hub directory)
+supplies hub init       # Create symlink to shared CLAUDE.md
+supplies hub status     # Show hub health and projects
+
+# Project Commands (run from within a project)
+supplies project init   # Initialize project with CLAUDE.md and command symlinks
+supplies project link   # Add symlinks for new commands after updating supplies
+supplies project status # Show project setup status
+supplies project eject  # Convert symlinked command to local file for customization
+
+# Global Options
+--dry-run              # Preview without making changes
+--quiet                # Suppress non-essential output
+```
+
+## How Variable Substitution Works
+
+The base CLAUDE.md (in supplies) uses placeholder variables. Each project's CLAUDE.md defines the values:
+
+**Base (supplies):**
+```markdown
+Create branch: `feature/PROJECT_PREFIX-123-description`
+```
+
+**Project (mission-control):**
+```markdown
+## Project Variables
+- **PROJECT_PREFIX**: MC
+```
+
+**No preprocessing required.** Claude Code loads both files, sees `PROJECT_PREFIX` in the instructions and `MC` as the defined value, and performs contextual substitution.
+
+## Workflow Examples
+
+### Setting Up a New Developer Machine
+
+```bash
+# Clone supplies
+cd ~/Source/launch-supply
+git clone git@github.com:launch-supply/supplies.git
+
+# Add to shell profile
+export SUPPLIES_ROOT="$HOME/Source/launch-supply/supplies"
+export PATH="$SUPPLIES_ROOT/bin:$PATH"
+
+# Initialize hub
+supplies hub init
+
+# Initialize each project
+cd mission-control && supplies project init
+cd ../batch-table && supplies project init
+```
+
+### Starting a New Rails Project
+
+```bash
+cd ~/Source/launch-supply
+rails new my-app
+cd my-app
+
+# Add gem (Ruby code)
+bundle add supplies
+rails g supplies:install
+
+# Add AI workflows
+supplies project init
+```
+
+### After Updating Supplies
+
+```bash
+# Pull latest changes
+cd $SUPPLIES_ROOT
+git pull
+
+# Existing symlinks auto-update (CLAUDE.md, existing commands)
+# Only need to run this if NEW commands were added:
+cd ~/Source/launch-supply/mission-control
+supplies project link
+```
+
+### Ejecting a Command for Customization
+
+```bash
+# Convert symlink to local file
+supplies project eject implement-issue
+
+# Now you can customize .claude/commands/implement-issue.md
+```
+
+---
+
+## Gem Features
+
+### RuboCop Configuration
+
+The generator creates `.rubocop.yml` that inherits from the gem:
+
+```yaml
+inherit_gem:
+  supplies:
+    - config/rubocop/base.yml
+    - config/rubocop/rails.yml
+    - config/rubocop/rspec.yml
+    - config/rubocop/performance.yml
+```
+
+Updates to RuboCop rules propagate automatically when you update the gem.
+
+### Supplies::Functional
+
+Service object pattern support:
+
+```ruby
+class SendsWelcomeEmail
+  include Supplies::Functional
+
+  def initialize(user:)
+    @user = user
+  end
+
+  def call
+    UserMailer.welcome(@user).deliver_now
+  end
+end
+
+# Usage
+SendsWelcomeEmail.(user: user)
+
+# Currying
+send_email = SendsWelcomeEmail.curry(template: :welcome)
+users.each { |user| send_email.(user: user) }
+```
+
+---
+
+## AI Workflow Features
+
+### Shared CLAUDE.md
+
+The base CLAUDE.md at `ai/CLAUDE.md` provides:
+
+- TDD workflow (red-green-refactor)
+- Linear integration patterns
+- Git conventions (branch naming, commit messages)
+- Code style guidelines
+- PR creation workflow
+
+### Shared Commands
+
+Commands in `ai/commands/` include:
+
+| Command | Purpose |
+|---------|---------|
+| `implement-issue` | Full issue implementation with TDD |
+| `fix-ci-failure` | Diagnose and fix failing CI checks |
+| `handle-pr-feedback` | Address review comments |
+| `process-issues` | Start parallel issue processing |
+| `orchestrate-issues` | Coordinate multiple sub-agents |
+| `rebase-pr` | Rebase PRs with merge conflicts |
+
+---
+
+## Requirements
+
+- Ruby 3.2+
+- Rails 7.1+ (for generator)
+- `linctl` CLI for Linear integration (optional)
+
+## Development
+
+```bash
+cd supplies
+bundle install
+bundle exec rspec
+bundle exec rubocop
+```
+
+## License
+
+MIT License

data/config/rubocop/base.yml

@@ -0,0 +1,264 @@
+# frozen_string_literal: true
+#
+# LsStandards Base RuboCop Configuration
+# Core Ruby style rules for all projects
+
+AllCops:
+  NewCops: enable
+  DisplayCopNames: true
+  TargetRubyVersion: 3.2
+  SuggestExtensions: false
+  Exclude:
+    - "bin/**/*"
+    - "db/schema.rb"
+    - "db/migrate/**/*"
+    - "config/importmap.rb"
+    - "node_modules/**/*"
+    - "tmp/**/*"
+    - "vendor/**/*"
+
+# Layout Cops
+Layout/ParameterAlignment:
+  EnforcedStyle: with_fixed_indentation
+
+Layout/ArgumentAlignment:
+  EnforcedStyle: with_fixed_indentation
+
+Layout/EmptyLinesAroundAttributeAccessor:
+  Enabled: true
+
+Layout/SpaceAroundMethodCallOperator:
+  Enabled: true
+
+Layout/MultilineMethodCallIndentation:
+  EnforcedStyle: indented
+
+Layout/MultilineOperationIndentation:
+  EnforcedStyle: indented
+
+Layout/FirstArrayElementIndentation:
+  EnforcedStyle: consistent
+
+Layout/FirstHashElementIndentation:
+  EnforcedStyle: consistent
+
+Layout/HashAlignment:
+  EnforcedLastArgumentHashStyle: ignore_explicit
+
+Layout/FirstArrayElementLineBreak:
+  Enabled: true
+
+Layout/FirstHashElementLineBreak:
+  Enabled: true
+
+Layout/FirstMethodArgumentLineBreak:
+  Enabled: false
+
+Layout/FirstMethodParameterLineBreak:
+  Enabled: true
+
+Layout/MultilineAssignmentLayout:
+  Enabled: true
+
+# Lint Cops
+Lint/RaiseException:
+  Enabled: true
+
+Lint/StructNewOverride:
+  Enabled: true
+
+Lint/DeprecatedOpenSSLConstant:
+  Enabled: true
+
+Lint/MixedRegexpCaptureTypes:
+  Enabled: true
+
+Lint/AssignmentInCondition:
+  Enabled: false
+
+Lint/EmptyBlock:
+  Enabled: false
+
+Lint/MissingCopEnableDirective:
+  Exclude:
+    - "spec/fixtures/**/*"
+
+# Metrics Cops - All disabled per team agreement
+Metrics/AbcSize:
+  Enabled: false
+
+Metrics/BlockLength:
+  Enabled: false
+
+Metrics/ClassLength:
+  Enabled: false
+
+Metrics/MethodLength:
+  Enabled: false
+
+Metrics/ModuleLength:
+  Enabled: false
+
+Metrics/ParameterLists:
+  Enabled: false
+
+Metrics/CyclomaticComplexity:
+  Enabled: false
+
+Metrics/PerceivedComplexity:
+  Enabled: false
+
+# Naming Cops
+Naming/PredicatePrefix:
+  Enabled: false
+
+Naming/AccessorMethodName:
+  Enabled: false
+
+Naming/VariableNumber:
+  Enabled: false
+
+Naming/FileName:
+  Exclude:
+    - "spec/views/**/*_spec.rb"
+
+# Style Cops
+Style/Documentation:
+  Enabled: false
+
+Style/BlockDelimiters:
+  EnforcedStyle: semantic
+  AllowBracesOnProceduralOneLiners: true
+  FunctionalMethods:
+    - let
+    - let!
+    - subject
+    - watch
+    - find
+  Exclude:
+    - "spec/factories/*.rb"
+
+Style/FormatString:
+  EnforcedStyle: percent
+
+Style/FormatStringToken:
+  Enabled: false
+
+Style/DoubleNegation:
+  Enabled: false
+
+Style/EmptyMethod:
+  EnforcedStyle: expanded
+
+Style/Alias:
+  EnforcedStyle: prefer_alias_method
+
+Style/NumericPredicate:
+  EnforcedStyle: comparison
+
+Style/RegexpLiteral:
+  Enabled: false
+
+Style/ModuleFunction:
+  EnforcedStyle: extend_self
+
+Style/TrailingCommaInArguments:
+  EnforcedStyleForMultiline: comma
+
+Style/TrailingCommaInArrayLiteral:
+  EnforcedStyleForMultiline: comma
+
+Style/TrailingCommaInHashLiteral:
+  EnforcedStyleForMultiline: comma
+
+Style/MultilineBlockChain:
+  Enabled: false
+
+Style/ExponentialNotation:
+  Enabled: true
+  EnforcedStyle: scientific
+
+Style/GuardClause:
+  MinBodyLength: 3
+
+Style/IfUnlessModifier:
+  Enabled: false
+
+Style/InlineComment:
+  Enabled: true
+  Exclude:
+    - "config/importmap.rb"
+    - "Gemfile"
+
+Style/Lambda:
+  EnforcedStyle: literal
+
+Style/LambdaCall:
+  EnforcedStyle: braces
+
+Style/AutoResourceCleanup:
+  Enabled: true
+
+Style/CollectionMethods:
+  Enabled: true
+
+Style/Copyright:
+  Enabled: false
+
+Style/DocumentationMethod:
+  Enabled: false
+  Exclude:
+    - "spec/**/*"
+    - "test/**/*"
+
+Style/MethodCallWithArgsParentheses:
+  Enabled: false
+
+Style/MethodCalledOnDoEndBlock:
+  Enabled: true
+  Exclude:
+    - "spec/**/*"
+
+Style/MissingElse:
+  Enabled: false
+
+Style/OptionHash:
+  Enabled: false
+
+Style/ReturnNil:
+  Enabled: true
+
+Style/Send:
+  Enabled: true
+  Exclude:
+    - "spec/**/*"
+
+Style/StringMethods:
+  Enabled: false
+
+Style/SignalException:
+  EnforcedStyle: semantic
+
+Style/SingleLineBlockParams:
+  Enabled: false
+
+Style/OpenStructUse:
+  Enabled: false
+
+Style/HashEachMethods:
+  Enabled: true
+
+Style/HashTransformKeys:
+  Enabled: true
+
+Style/HashTransformValues:
+  Enabled: true
+
+Style/RedundantRegexpCharacterClass:
+  Enabled: true
+
+Style/RedundantRegexpEscape:
+  Enabled: true
+
+Style/SlicingWithRange:
+  Enabled: true

data/config/rubocop/performance.yml

@@ -0,0 +1,153 @@
+# frozen_string_literal: true
+#
+# LsStandards Performance RuboCop Configuration
+# Performance-focused rules for optimized Ruby code
+
+inherit_from:
+  - base.yml
+
+# Performance Cops
+Performance:
+  Enabled: true
+
+Performance/AncestorsInclude:
+  Enabled: true
+
+Performance/BigDecimalWithNumericArgument:
+  Enabled: true
+
+Performance/BlockGivenWithExplicitBlock:
+  Enabled: true
+
+Performance/CaseWhenSplat:
+  Enabled: true
+
+Performance/Casecmp:
+  Enabled: true
+
+Performance/ChainArrayAllocation:
+  Enabled: true
+
+Performance/CollectionLiteralInLoop:
+  Enabled: true
+  MinSize: 2
+
+Performance/CompareWithBlock:
+  Enabled: true
+
+Performance/ConcurrentMonotonicTime:
+  Enabled: true
+
+Performance/ConstantRegexp:
+  Enabled: true
+
+Performance/Count:
+  Enabled: true
+
+Performance/DeletePrefix:
+  Enabled: true
+
+Performance/DeleteSuffix:
+  Enabled: true
+
+Performance/Detect:
+  Enabled: true
+
+Performance/DoubleStartEndWith:
+  Enabled: true
+
+Performance/EndWith:
+  Enabled: true
+
+Performance/FixedSize:
+  Enabled: true
+
+Performance/FlatMap:
+  Enabled: true
+
+Performance/InefficientHashSearch:
+  Enabled: true
+
+Performance/IoReadlines:
+  Enabled: true
+
+Performance/MapCompact:
+  Enabled: true
+
+Performance/MapMethodChain:
+  Enabled: true
+
+Performance/MethodObjectAsBlock:
+  Enabled: true
+
+Performance/OpenStruct:
+  Enabled: true
+
+Performance/RangeInclude:
+  Enabled: true
+
+Performance/RedundantBlockCall:
+  Enabled: true
+
+Performance/RedundantEqualityComparisonBlock:
+  Enabled: true
+
+Performance/RedundantMatch:
+  Enabled: true
+
+Performance/RedundantMerge:
+  Enabled: true
+
+Performance/RedundantSortBlock:
+  Enabled: true
+
+Performance/RedundantSplitRegexpArgument:
+  Enabled: true
+
+Performance/RedundantStringChars:
+  Enabled: true
+
+Performance/RegexpMatch:
+  Enabled: true
+
+Performance/ReverseEach:
+  Enabled: true
+
+Performance/ReverseFirst:
+  Enabled: true
+
+Performance/SelectMap:
+  Enabled: true
+
+Performance/Size:
+  Enabled: true
+
+Performance/SortReverse:
+  Enabled: true
+
+Performance/Squeeze:
+  Enabled: true
+
+Performance/StartWith:
+  Enabled: true
+
+Performance/StringIdentifierArgument:
+  Enabled: true
+
+Performance/StringInclude:
+  Enabled: true
+
+Performance/StringReplacement:
+  Enabled: true
+
+Performance/Sum:
+  Enabled: true
+
+Performance/TimesMap:
+  Enabled: true
+
+Performance/UnfreezeString:
+  Enabled: true
+
+Performance/UriDefaultParser:
+  Enabled: true

data/config/rubocop/rails.yml

@@ -0,0 +1,23 @@
+# frozen_string_literal: true
+#
+# LsStandards Rails RuboCop Configuration
+# Rails-specific rules for web applications
+
+require:
+  - rubocop-rails
+
+inherit_from:
+  - base.yml
+
+# Rails Cops
+Rails/FindEach:
+  Enabled: false
+
+Rails/SkipsModelValidations:
+  Enabled: false
+
+Rails/RedundantActiveRecordAllMethod:
+  Enabled: false
+
+Rails/FilePath:
+  Enabled: false

data/config/rubocop/rspec.yml

@@ -0,0 +1,79 @@
+# frozen_string_literal: true
+#
+# LsStandards RSpec RuboCop Configuration
+# Testing-specific rules for RSpec test suites
+
+inherit_from:
+  - base.yml
+
+# RSpec Cops
+RSpec/ExampleLength:
+  Enabled: false
+
+RSpec/MessageSpies:
+  Enabled: false
+
+RSpec/NestedGroups:
+  Enabled: false
+
+RSpec/MultipleExpectations:
+  Enabled: false
+
+RSpec/MultipleMemoizedHelpers:
+  Enabled: false
+
+RSpec/ContextWording:
+  Enabled: false
+
+RSpec/EmptyExampleGroup:
+  Enabled: false
+
+RSpec/LetSetup:
+  Enabled: false
+
+RSpec/InstanceVariable:
+  Enabled: false
+
+RSpec/MessageChain:
+  Enabled: false
+
+RSpec/DescribedClass:
+  Enabled: false
+
+RSpec/VerifiedDoubles:
+  IgnoreNameless: true
+  IgnoreSymbolicNames: true
+
+RSpec/DescribeClass:
+  Enabled: false
+
+RSpec/RepeatedExample:
+  Exclude:
+    - "spec/integration/**/*"
+
+RSpec/RepeatedDescription:
+  Exclude:
+    - "spec/integration/**/*"
+
+RSpec/ScatteredSetup:
+  Exclude:
+    - "spec/integration/**/*"
+
+RSpec/StubbedMock:
+  Enabled: false
+
+RSpec/NoExpectationExample:
+  Enabled: false
+
+RSpec/SpecFilePathFormat:
+  Enabled: false
+
+RSpec/SpecFilePathSuffix:
+  Enabled: false
+
+# Capybara Cops
+Capybara/SpecificActions:
+  Enabled: false
+
+Capybara/ClickLinkOrButtonStyle:
+  Enabled: false

data/lib/generators/supplies/install_generator.rb

@@ -0,0 +1,100 @@
+# frozen_string_literal: true
+
+require 'rails/generators'
+
+module Supplies
+  module Generators
+    # Installs Supplies RuboCop configuration into a Rails application.
+    #
+    # This generator:
+    # - Adds RuboCop gems to Gemfile (development/test group)
+    # - Creates `.rubocop.yml` that inherits from the gem's configurations
+    #
+    # RuboCop rules auto-update when the gem is updated.
+    #
+    # AI workflows (CLAUDE.md, commands) are managed separately via the
+    # `supplies` CLI from a local clone of the supplies repo.
+    #
+    # @example Running the generator
+    #   rails g supplies:install
+    #
+    class InstallGenerator < Rails::Generators::Base
+      source_root File.expand_path('templates', __dir__)
+
+      desc 'Installs Supplies RuboCop configuration'
+
+      RUBOCOP_GEMS = [
+        "gem 'rubocop', '~> 1.60', require: false",
+        "gem 'rubocop-capybara', '~> 2.20', require: false",
+        "gem 'rubocop-factory_bot', '~> 2.25', require: false",
+        "gem 'rubocop-md', '~> 2.0', require: false",
+        "gem 'rubocop-performance', '~> 1.20', require: false",
+        "gem 'rubocop-rails', '~> 2.23', require: false",
+        "gem 'rubocop-rspec', '~> 3.8', require: false",
+      ].freeze
+
+      # Adds RuboCop gems to the Gemfile in the development/test group.
+      #
+      # @return [void]
+      def add_rubocop_gems
+        gemfile_content = File.read('Gemfile')
+
+        # Check if gems are already present
+        if gemfile_content.include?("gem 'rubocop'") || gemfile_content.include?('gem "rubocop"')
+          say 'RuboCop gems already in Gemfile, skipping...', :yellow
+          return
+        end
+
+        gem_entries = RUBOCOP_GEMS.map { |g| "  #{g}" }.join("\n")
+        append_to_file 'Gemfile', <<~GEMS
+
+          # RuboCop linting (added by supplies:install)
+          group :development, :test do
+          #{gem_entries}
+          end
+        GEMS
+
+        say 'Added RuboCop gems to Gemfile', :green
+      end
+
+      # Creates the .rubocop.yml configuration file.
+      #
+      # @return [void]
+      def create_rubocop_config
+        template 'rubocop.yml.tt', '.rubocop.yml'
+      end
+
+      # Displays post-install instructions.
+      #
+      # @return [void]
+      def show_post_install_message
+        say ''
+        say '=' * 60, :green
+        say 'Supplies RuboCop configuration installed!', :green
+        say '=' * 60, :green
+        say ''
+        say 'Files created/modified:'
+        say '  - Gemfile (RuboCop gems added to development/test group)'
+        say '  - .rubocop.yml (inherits from gem - auto-updates)'
+        say ''
+        say 'Next steps:', :yellow
+        say "  1. Run 'bundle install' to install RuboCop gems"
+        say "  2. Run 'bundle exec rubocop' to check your code"
+        say "  3. Run 'bundle exec rubocop -a' to auto-fix issues"
+        say ''
+        say 'For AI workflows (CLAUDE.md, commands), use the supplies CLI:', :yellow
+        say '  supplies project init'
+        say ''
+      end
+
+      private
+
+      # Returns the current Ruby version (major.minor).
+      #
+      # @return [String] the Ruby version
+      def ruby_version
+        RUBY_VERSION.split('.').take(2).join('.')
+      end
+    end
+  end
+end

data/lib/generators/supplies/templates/rubocop.yml.tt

@@ -0,0 +1,20 @@
+# frozen_string_literal: true
+#
+# RuboCop configuration
+# Generated by supplies gem - inherits from gem, auto-updates
+#
+# To customize, add your overrides below.
+# See: https://docs.rubocop.org/rubocop/configuration.html
+
+inherit_gem:
+  supplies:
+    - config/rubocop/base.yml
+    - config/rubocop/rails.yml
+    - config/rubocop/rspec.yml
+    - config/rubocop/performance.yml
+
+AllCops:
+  TargetRubyVersion: <%= ruby_version %>
+  NewCops: enable
+
+# Add your project-specific overrides below:

data/lib/supplies/functional.rb

@@ -0,0 +1,116 @@
+# frozen_string_literal: true
+
+module Supplies
+  # Functional module for service objects that provides a consistent `.call`
+  # class method interface and support for currying.
+  #
+  # This module enables the service object pattern where business logic is
+  # encapsulated in classes with a single public `#call` method. Including
+  # this module provides:
+  #
+  # - A class-level `.call` method that instantiates and invokes the service
+  # - A `.curry` method for partial application of arguments
+  #
+  # @example Basic usage
+  #   class SendsWelcomeEmail
+  #     include Supplies::Functional
+  #
+  #     def initialize(user:)
+  #       @user = user
+  #     end
+  #
+  #     def call
+  #       UserMailer.welcome(@user).deliver_now
+  #     end
+  #   end
+  #
+  #   # Invoke with class method
+  #   SendsWelcomeEmail.call(user: user)
+  #
+  # @example Using curry for partial application
+  #   class SendsNotification
+  #     include Supplies::Functional
+  #
+  #     def initialize(user:, message:)
+  #       @user = user
+  #       @message = message
+  #     end
+  #
+  #     def call
+  #       NotificationService.send(@user, @message)
+  #     end
+  #   end
+  #
+  #   # Create a curried version with preset message
+  #   notify_welcome = SendsNotification.curry(message: "Welcome!")
+  #   users.each { |user| notify_welcome.call(user: user) }
+  #
+  # @example With block support
+  #   class ProcessesItems
+  #     include Supplies::Functional
+  #
+  #     def initialize(items:)
+  #       @items = items
+  #     end
+  #
+  #     def call(&block)
+  #       @items.each { |item| block.call(item) }
+  #     end
+  #   end
+  #
+  #   ProcessesItems.call(items: items) { |item| puts item }
+  #
+  # @see ADR-0001 for the full architectural decision record
+  module Functional
+    # Hook called when this module is included in a class.
+    # Extends the including class with ClassMethods.
+    #
+    # @param base [Class] the class including this module
+    def self.included(base)
+      base.extend(ClassMethods)
+    end
+
+    # Class methods added to any class that includes Functional.
+    module ClassMethods
+      # Instantiates the service and calls it with the provided arguments.
+      #
+      # This method supports both positional and keyword arguments, as well
+      # as blocks that are passed through to the instance's `#call` method.
+      #
+      # @param args [Array] positional arguments passed to initialize
+      # @param kwargs [Hash] keyword arguments passed to initialize
+      # @param block [Proc] optional block passed to the instance's call method
+      # @return [Object] the return value of the instance's `#call` method
+      #
+      # @example
+      #   SendsEmail.call(user: user, template: :welcome)
+      #
+      # @example With hash as first argument (merged with kwargs)
+      #   base_args = { user: user }
+      #   SendsEmail.call(base_args, template: :welcome)
+      def call(*args, **kwargs, &)
+        if args.first.is_a?(Hash)
+          # Merge hash with kwargs (kwargs take precedence)
+          kwargs = args.shift.merge(kwargs)
+        end
+        new(*args, **kwargs).(&)
+      end
+
+      # Creates a lambda that calls the service with preset arguments.
+      #
+      # This enables partial application, where some arguments are provided
+      # upfront and the rest are supplied later when the lambda is called.
+      #
+      # @param args [Hash] keyword arguments to preset
+      # @return [Proc] a lambda that accepts remaining arguments and calls the service
+      #
+      # @example
+      #   # Preset the admin_user, supply user later
+      #   send_reset = SendsPasswordResetEmail.curry(admin_user: admin)
+      #   users.each { |user| send_reset.call(user: user) }
+      def curry(**args)
+        ->(**next_args) { call(**args, **next_args) }
+      end
+    end
+  end
+end

data/lib/supplies/railtie.rb

@@ -0,0 +1,15 @@
+# frozen_string_literal: true
+
+require 'rails/railtie'
+
+module Supplies
+  # Railtie for integrating Supplies with Rails applications.
+  #
+  # This railtie ensures proper initialization of the gem within
+  # the Rails boot process and makes generators available.
+  class Railtie < Rails::Railtie
+    generators do
+      require 'generators/supplies/install_generator'
+    end
+  end
+end

data/lib/supplies/version.rb

@@ -0,0 +1,5 @@
+# frozen_string_literal: true
+
+module Supplies
+  VERSION = '0.1.0'
+end

data/lib/supplies.rb

@@ -0,0 +1,39 @@
+# frozen_string_literal: true
+
+require_relative 'supplies/version'
+require_relative 'supplies/functional'
+require_relative 'supplies/railtie' if defined?(Rails::Railtie)
+
+# Supplies provides shared coding conventions, linting configuration,
+# and AI tool context files for Rails development.
+#
+# @example Installation
+#   # Add to Gemfile
+#   gem "supplies", group: [:development, :test]
+#
+#   # Run the install generator
+#   rails g supplies:install
+#
+module Supplies
+  class Error < StandardError; end
+
+  class << self
+    # Returns the root path of the gem installation.
+    #
+    # @return [Pathname] the gem's root directory path
+    # @example
+    #   Supplies.root #=> #<Pathname:/path/to/supplies>
+    def root
+      Pathname.new(__dir__).parent
+    end
+
+    # Returns the path to the RuboCop configuration directory.
+    #
+    # @return [Pathname] path to config/rubocop within the gem
+    # @example
+    #   Supplies.rubocop_config_path #=> #<Pathname:/path/to/supplies/config/rubocop>
+    def rubocop_config_path
+      root.join('config', 'rubocop')
+    end
+  end
+end

metadata

@@ -0,0 +1,169 @@
+--- !ruby/object:Gem::Specification
+name: supplies
+version: !ruby/object:Gem::Version
+  version: 0.1.0
+platform: ruby
+authors:
+- Launch Supply
+bindir: bin
+cert_chain: []
+date: 1980-01-02 00:00:00.000000000 Z
+dependencies:
+- !ruby/object:Gem::Dependency
+  name: railties
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '7.1'
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '7.1'
+- !ruby/object:Gem::Dependency
+  name: rubocop
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '1.60'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '1.60'
+- !ruby/object:Gem::Dependency
+  name: rubocop-capybara
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '2.20'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '2.20'
+- !ruby/object:Gem::Dependency
+  name: rubocop-factory_bot
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '2.25'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '2.25'
+- !ruby/object:Gem::Dependency
+  name: rubocop-md
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '2.0'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '2.0'
+- !ruby/object:Gem::Dependency
+  name: rubocop-performance
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '1.20'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '1.20'
+- !ruby/object:Gem::Dependency
+  name: rubocop-rails
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '2.23'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '2.23'
+- !ruby/object:Gem::Dependency
+  name: rubocop-rspec
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '3.8'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '3.8'
+description: A collection of tools used by Launch Supply for Ruby developmentand Rubocop
+  configs for consistent Rails development practices.
+email:
+- dev@launchsupply.com
+executables: []
+extensions: []
+extra_rdoc_files: []
+files:
+- LICENSE.txt
+- README.md
+- config/rubocop/base.yml
+- config/rubocop/performance.yml
+- config/rubocop/rails.yml
+- config/rubocop/rspec.yml
+- lib/generators/supplies/install_generator.rb
+- lib/generators/supplies/templates/rubocop.yml.tt
+- lib/supplies.rb
+- lib/supplies/functional.rb
+- lib/supplies/railtie.rb
+- lib/supplies/version.rb
+homepage: https://www.launchsupply.com/
+licenses:
+- MIT
+metadata:
+  homepage_uri: https://www.launchsupply.com/
+  source_code_uri: https://www.launchsupply.com/
+  changelog_uri: https://www.launchsupply.com//blob/main/CHANGELOG.md
+  rubygems_mfa_required: 'true'
+rdoc_options: []
+require_paths:
+- lib
+required_ruby_version: !ruby/object:Gem::Requirement
+  requirements:
+  - - ">="
+    - !ruby/object:Gem::Version
+      version: 3.2.0
+required_rubygems_version: !ruby/object:Gem::Requirement
+  requirements:
+  - - ">="
+    - !ruby/object:Gem::Version
+      version: '0'
+requirements: []
+rubygems_version: 4.0.0
+specification_version: 4
+summary: Shared Ruby patterns and linting for Rails development
+test_files: []