chatwerk 0.1.0

checksums.yaml

@@ -0,0 +1,7 @@
+---
+SHA256:
+  metadata.gz: 1f6463014c8b9acb703cc940790b073d41e434b507e7a16cdc5635df1393c9dd
+  data.tar.gz: 3e208195bb1b414e677003e973f4b2c225642cc2de780d78fc32c42f6db75f4b
+SHA512:
+  metadata.gz: bc748648854e35f7bb6dab00d22841ea98c18c4d4754ca8b11935a1c58caec6fe8772603d3a1c92fb27c9462c853a2a2d2f4af84e5b32bb666a9f6d3a06c4065
+  data.tar.gz: d0f2a2e84fab5ec86d22986d508363818cbb11c49a91afa961b585d21c4cd4b26eeb6aaeb4af61cc86c071ddac8e1f225202ae27f35792c4f1d88611320e2f47

data/.rspec

@@ -0,0 +1,3 @@
+--format documentation
+--color
+--require spec_helper

data/.rubocop.yml

@@ -0,0 +1,90 @@
+plugins:
+  - rubocop-sorbet
+  - rubocop-performance
+
+AllCops:
+  TargetRubyVersion: 3.1
+  SuggestExtensions: false
+  NewCops: enable
+  Exclude:
+    - bin/**/*
+    - vendor/**/*
+
+Sorbet/StrictSigil:
+  Enabled: false
+
+Layout/ExtraSpacing:
+  Enabled: true
+  Exclude:
+    - danger-packwerk.gemspec
+
+Layout/SpaceAroundOperators:
+  Enabled: true
+  Exclude:
+    - danger-packwerk.gemspec
+
+Sorbet/ValidSigil:
+  Enabled: true
+
+Gemspec/RequireMFA:
+  Enabled: false
+
+Layout/LineLength:
+  Enabled: false
+
+Metrics/BlockLength:
+  Enabled: false
+
+Style/Documentation:
+  Enabled: false
+
+Style/SignalException:
+  Enabled: false
+
+Style/FrozenStringLiteralComment:
+  Enabled: false
+
+Style/MultilineBlockChain:
+  Enabled: false
+
+Metrics/MethodLength:
+  Enabled: false
+
+Metrics/CyclomaticComplexity:
+  Enabled: false
+
+Metrics/ModuleLength:
+  Enabled: false
+
+Metrics/ClassLength:
+  Enabled: false
+
+Sorbet/FalseSigil:
+  Enabled: false
+
+Lint/UnusedMethodArgument:
+  Enabled: false
+
+Metrics/AbcSize:
+  Enabled: false
+
+Style/GuardClause:
+  Enabled: false
+
+Style/NumericPredicate:
+  Enabled: false
+
+Metrics/PerceivedComplexity:
+  Enabled: false
+
+Metrics/ParameterLists:
+  Enabled: false
+
+Style/SuperArguments:
+  Enabled: false
+
+Style/ArgumentsForwarding:
+  Enabled: false
+
+Naming/BlockForwarding:
+  Enabled: false

data/CHANGELOG.md

@@ -0,0 +1 @@
+See https://github.com/rubyatscale/chatwerk/releases

data/LICENSE.txt

@@ -0,0 +1,21 @@
+The MIT License (MIT)
+
+Copyright (c) 2025 Martin Emde
+
+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,68 @@
+# Chatwerk
+
+Chatwerk provides AI tool integration for the [QueryPackwerk](https://github.com/rubyatscale/query_packwerk) gem. It adds a Model Context Protocol (MCP) server that allows AI tools like Cursor IDE to access information about your Packwerk packages, dependencies, and violations.
+
+> [!NOTE]
+> This is an early prerelease version. We'll continue to update it as we develop. Contributions and feedback are welcome!
+
+## Installation
+
+Install the gem, either add in to your packwerk'd application's Gemfile:
+
+```ruby
+$ bundle add chatwerk
+$ bundle install
+```
+
+or install it on its own:
+
+```bash
+$ gem install chatwerk
+```
+
+## Usage
+
+### Starting the MCP Server
+
+You can test the inspector to see if it's working
+
+```bash
+$ chatwerk inspect
+```
+
+### Connecting with Cursor IDE
+
+To use Chatwerk with Cursor:
+
+1. In Cursor, open Settings > MCP
+
+2. Add a new MCP connection as a command
+   Name: `chatwerk`
+   Command: `chatwerk mcp`
+
+3. Ask Cursor to check all the tools on packwerk. Give it an example pack name (partial strings work)
+
+### Example Queries for Cursor
+
+Once connected, you can ask Cursor questions about your Packwerk structure:
+
+- "What are all the packages in this codebase?"
+- "Tell me about the dependencies of package X"
+- "What packages depend on package Y?"
+- "Show me all the violations for package Z"
+- "How difficult would it be to separate package X from its dependencies?"
+- "What code patterns are used to access Constant on package Y?"
+
+## Development
+
+After checking out the repo, run `bin/setup` to install dependencies. Then, run `rake spec` to run the tests.
+
+Run `bin/inspect`
+
+## Contributing
+
+Bug reports and pull requests are welcome on GitHub at https://github.com/rubyatscale/chatwerk.
+
+## License
+
+The gem is available as open source under the terms of the [MIT License](https://opensource.org/licenses/MIT).

data/Rakefile

@@ -0,0 +1,12 @@
+# frozen_string_literal: true
+
+require 'bundler/gem_tasks'
+require 'rspec/core/rake_task'
+
+RSpec::Core::RakeTask.new(:spec)
+
+require 'rubocop/rake_task'
+
+RuboCop::RakeTask.new
+
+task default: %i[spec rubocop]

data/config.ru

@@ -0,0 +1,4 @@
+# frozen_string_literal: true
+
+require 'chatwerk'
+run Chatwerk::MCPServer.new

data/exe/chatwerk

@@ -0,0 +1,6 @@
+#!/usr/bin/env ruby
+# frozen_string_literal: true
+
+require 'chatwerk'
+
+Chatwerk::Cli.start(ARGV)

data/lib/chatwerk/api.rb

@@ -0,0 +1,71 @@
+# typed: strict
+# frozen_string_literal: true
+
+require 'yaml'
+
+module Chatwerk
+  module Api
+    class << self
+      def print_env
+        msg = <<~MESSAGE
+          PWD: #{Dir.pwd}
+          PWD from ENV: #{ENV.fetch('PWD', nil)}
+        MESSAGE
+        Helpers.chdir do
+          msg << "Chdir'd to #{Helpers.pwd}\n"
+        end
+        msg << ENV.to_h.map { |key, value| "#{key}=#{value}" }.join("\n")
+        msg
+      end
+
+      def packages(package_path: '')
+        packages = Helpers.all_packages(package_path)
+
+        if packages.empty?
+          has_packwerk_yml = File.exist?('packwerk.yml')
+          Views::NoPackagesView.render(has_packwerk_yml:)
+        else
+          Views::PackagesView.render(packages:)
+        end
+      rescue StandardError => e
+        raise Chatwerk::Error.new(e, package_path:)
+      end
+
+      def package(package_path:)
+        package = Helpers.find_package(package_path)
+
+        Views::PackageView.render(package:)
+      rescue StandardError => e
+        raise Chatwerk::Error.new(e, package_path:)
+      end
+
+      def package_todos(package_path:, constant_name: '')
+        package = Helpers.find_package(package_path)
+        constant_name = Helpers.normalize_constant_name(constant_name)
+        violations = package.todos
+
+        if constant_name.empty?
+          Views::ViolationsListView.render(package:, violations:)
+        else
+          Views::ViolationsDetailsView.render(package:, violations:, constant_name:)
+        end
+      rescue StandardError => e
+        raise Chatwerk::Error.new(e, package_path:, constant_name:)
+      end
+
+      def package_violations(package_path:, constant_name: '')
+        package = Helpers.find_package(package_path)
+        constant_name = Helpers.normalize_constant_name(constant_name)
+        violations = package.violations
+
+        if constant_name.empty?
+          Views::ViolationsListView.render(package:, violations:)
+        else
+          Views::ViolationsDetailsView.render(package:, violations:, constant_name:)
+        end
+      rescue StandardError => e
+        raise Chatwerk::Error.new(e, package_path:, constant_name:)
+      end
+    end
+  end
+end

data/lib/chatwerk/cli.rb

@@ -0,0 +1,59 @@
+# typed: false
+# frozen_string_literal: true
+
+require 'thor'
+
+module Chatwerk
+  # CLI interface for Chatwerk using Thor
+  class Cli < Thor
+    desc 'mcp', 'Start the Model Context Protocol server in stdio mode'
+    def mcp
+      require_relative 'mcp'
+      require 'mcp/transports/stdio'
+      server = Chatwerk::Mcp.server
+      transport = MCP::Transports::StdioTransport.new(server)
+      transport.open
+    end
+
+    desc 'inspect [WORKING_DIRECTORY]', 'Run the MCP inspector with an optional working directory path (defaults to current directory)'
+    def inspect(working_directory = nil)
+      pwd = working_directory || Dir.pwd
+      system("npx @modelcontextprotocol/inspector -e PWD=#{pwd} bundle exec exe/chatwerk mcp")
+    end
+
+    desc 'print_env', 'Show current environment details'
+    def print_env
+      puts Api.print_env
+    end
+
+    desc 'packages [PACKAGE_PATH]', 'List all valid packwerk packages, optionally filtered by package path'
+    def packages(package_path = nil)
+      puts Api.packages(package_path:)
+    end
+
+    desc 'package PACKAGE_PATH', 'Show details for a specific package'
+    def package(package_path)
+      puts Api.package(package_path:)
+    end
+
+    desc 'package_todos PACKAGE_PATH [CONSTANT_NAME]', 'Show dependency violations FROM this package TO others'
+    def package_todos(package_path, constant_name = nil)
+      puts Api.package_todos(package_path:, constant_name:)
+    end
+
+    desc 'package_violations PACKAGE_PATH [CONSTANT_NAME]', 'Show dependency violations TO this package FROM others'
+    def package_violations(package_path, constant_name = nil)
+      puts Api.package_violations(package_path:, constant_name:)
+    end
+
+    desc 'version', 'Display Chatwerk version'
+    def version
+      puts "Chatwerk #{Chatwerk::VERSION}"
+    end
+    map %w[--version -v] => :version
+
+    def self.exit_on_failure?
+      true
+    end
+  end
+end

data/lib/chatwerk/error.rb

@@ -0,0 +1,24 @@
+# frozen_string_literal: true
+
+module Chatwerk
+  class Error < RuntimeError
+    def initialize(error, package_path: nil, **args)
+      message =
+        if package_path && !package_path.empty?
+          "There was a problem finding or accessing #{package_path.inspect}"
+        else
+          'There was a problem accessing package information'
+        end
+
+      super(<<~ERROR)
+        #{message}
+        Error: #{error}
+
+        * Please ensure that the package path is correct.
+        * Check that there is a package.yml file in the given directory.
+        * Check that the path is a project root relative path that doesn't start with a slash.
+        * Try calling the packages tool with the package_path to see if it is valid.
+      ERROR
+    end
+  end
+end

data/lib/chatwerk/helpers.rb

@@ -0,0 +1,71 @@
+module Chatwerk
+  module Helpers
+    def chdir(&)
+      Dir.chdir(env_pwd, &)
+    end
+    module_function :chdir
+
+    def env_pwd
+      path = ENV.fetch('PWD', pwd)
+      # Use realpath if the path exists, otherwise fall back to expand_path
+      File.directory?(path) ? File.realpath(path) : File.expand_path(path)
+    end
+    module_function :env_pwd
+
+    def pwd
+      File.realpath(Dir.pwd)
+    end
+    module_function :pwd
+
+    def normalize_package_path(package_path)
+      package_path = package_path.to_s.strip
+      package_path = package_path.delete_prefix('/')
+      package_path = package_path.delete_suffix('/package.yml')
+      package_path = package_path.delete_suffix('/package_todo.yml')
+      package_path.delete_suffix('/')
+    end
+    module_function :normalize_package_path
+
+    def normalize_constant_name(constant_name)
+      constant_name = constant_name.to_s.strip
+      return '' if constant_name.empty?
+
+      constant_name.sub(/^(::)?/, '::')
+    end
+    module_function :normalize_constant_name
+
+    def all_packages(path_pattern = '')
+      path_pattern = normalize_package_path(path_pattern)
+      if path_pattern.empty?
+        QueryPackwerk::Packages.all.to_a
+      else
+        QueryPackwerk::Packages.where(name: Regexp.new(Regexp.escape(path_pattern))).to_a
+      end
+    end
+    module_function :all_packages
+
+    def find_package(path_pattern)
+      packages = all_packages(path_pattern)
+
+      if packages.empty?
+        raise "Unable to find a package for #{path_pattern.inspect}."
+      elsif packages.size == 1
+        packages.first
+      else
+        # Return an exact match even if it's a subset of another match
+        # e.g. packs/payments and packs/payments_api
+        exact_match = packages.find { |package| package.name == path_pattern }
+        return exact_match if exact_match
+
+        raise Chatwerk::Error, <<~ERROR
+          Found multiple packages for #{path_pattern.inspect}:
+
+          #{packages.map(&:name).join("\n")}
+
+          Please use full path to specify the correct package.
+        ERROR
+      end
+    end
+    module_function :find_package
+  end
+end

data/lib/chatwerk/mcp.rb

@@ -0,0 +1,25 @@
+require 'mcp'
+
+module Chatwerk
+  # MCP Server setup
+  class Mcp
+    def self.server
+      # Set up the server with all tools
+      MCP::Server.new(
+        name: name,
+        version: Chatwerk::VERSION,
+        tools: [
+          Tools::PrintEnvTool,
+          Tools::PackagesTool,
+          Tools::PackageTool,
+          Tools::PackageTodosTool,
+          Tools::PackageViolationsTool
+        ]
+      )
+    end
+
+    def self.name
+      'chatwerk'
+    end
+  end
+end

data/lib/chatwerk/tools/package_todos_tool.rb

@@ -0,0 +1,50 @@
+# frozen_string_literal: true
+
+require 'mcp'
+
+module Chatwerk
+  module Tools
+    # Package todos (violations FROM this package) tool
+    class PackageTodosTool < MCP::Tool
+      description <<~DESC
+        Find code that violates dependency boundaries FROM this package TO other packages.
+
+        Output formats:
+        - Without constant_name: List of violated constants with counts
+          Example: "::OtherPackage::SomeClass # 3 violations"
+        - With constant_name: Detailed examples and locations
+          Example:
+            ::OtherPackage::SomeClass
+              example: OtherPackage::SomeClass.new
+              files:
+                - app/services/my_service.rb
+      DESC
+
+      input_schema(
+        properties: {
+          package_path: {
+            type: 'string',
+            description: "The relative path of a directory containing a package.yml file (e.g. 'packs/product_services/payments/origination_banks')."
+          },
+          constant_name: {
+            type: 'string',
+            description: "The name of a constant to filter the results by. If provided, a more detailed list of code usage examples will be returned. (e.g. '::OtherPackage::SomeClass')"
+          }
+        },
+        required: ['package_path']
+      )
+
+      class << self
+        def call(package_path:, server_context:, constant_name: nil)
+          Helpers.chdir
+          result = Api.package_todos(package_path: package_path, constant_name: constant_name)
+
+          MCP::Tool::Response.new([{
+                                    type: 'text',
+                                    text: result
+                                  }])
+        end
+      end
+    end
+  end
+end

data/lib/chatwerk/tools/package_tool.rb

@@ -0,0 +1,39 @@
+# frozen_string_literal: true
+
+require 'mcp'
+
+module Chatwerk
+  module Tools
+    # Show package details tool
+    class PackageTool < MCP::Tool
+      description <<~DESC
+        Show the details for a specific package.
+
+        Output format:
+        - Package details, including dependencies and configuration
+      DESC
+
+      input_schema(
+        properties: {
+          package_path: {
+            type: 'string',
+            description: "A full relative package path (e.g. 'packs/product_services/payments/banks')."
+          }
+        },
+        required: ['package_path']
+      )
+
+      class << self
+        def call(package_path:, server_context:)
+          Helpers.chdir
+          result = Api.package(package_path: package_path)
+
+          MCP::Tool::Response.new([{
+                                    type: 'text',
+                                    text: result
+                                  }])
+        end
+      end
+    end
+  end
+end

data/lib/chatwerk/tools/package_violations_tool.rb

@@ -0,0 +1,51 @@
+# frozen_string_literal: true
+
+require 'mcp'
+
+module Chatwerk
+  module Tools
+    # Package violations (violations TO this package) tool
+    class PackageViolationsTool < MCP::Tool
+      description <<~DESC
+        Find code that violates dependency boundaries TO this package FROM other packages.
+
+        Output formats:
+        - Without constant_name: List of violated constants with counts
+          Example: "::ThisPackage::SomeClass: 3 violations"
+        - With constant_name: Detailed examples and locations
+          Example:
+            # Constant `::ThisPackage::SomeClass`
+              ## Example:
+                ThisPackage::SomeClass.new
+              ### Files:
+                app/services/other_service.rb
+      DESC
+
+      input_schema(
+        properties: {
+          package_path: {
+            type: 'string',
+            description: "The relative path of a directory containing a package.yml file (e.g. 'packs/product_services/payments/origination_banks'). AKA a 'pack' or 'package'."
+          },
+          constant_name: {
+            type: 'string',
+            description: 'The name of a constant to filter the results by. If provided, a more detailed list of code usage examples will be returned.'
+          }
+        },
+        required: ['package_path']
+      )
+
+      class << self
+        def call(package_path:, server_context:, constant_name: nil)
+          Helpers.chdir
+          result = Api.package_violations(package_path: package_path, constant_name: constant_name)
+
+          MCP::Tool::Response.new([{
+                                    type: 'text',
+                                    text: result
+                                  }])
+        end
+      end
+    end
+  end
+end

data/lib/chatwerk/tools/packages_tool.rb

@@ -0,0 +1,37 @@
+# frozen_string_literal: true
+
+require 'mcp'
+
+module Chatwerk
+  module Tools
+    # List packages tool
+    class PackagesTool < MCP::Tool
+      description <<~DESC
+        List all valid packwerk packages (aka packs) in the project.
+        Use this to find or list packages, optionally matching a substring of the package_path.
+      DESC
+
+      input_schema(
+        properties: {
+          package_path: {
+            type: 'string',
+            description: "A partial package path name to constrain the results (e.g. 'packs/product_services/payments/banks' or 'payments/banks')."
+          }
+        },
+        required: []
+      )
+
+      class << self
+        def call(server_context:, package_path: nil)
+          Helpers.chdir
+          result = Api.packages(package_path: package_path)
+
+          MCP::Tool::Response.new([{
+                                    type: 'text',
+                                    text: result
+                                  }])
+        end
+      end
+    end
+  end
+end

data/lib/chatwerk/tools/print_env_tool.rb

@@ -0,0 +1,35 @@
+require 'mcp'
+require_relative '../helpers'
+
+module Chatwerk
+  module Tools
+    # Print environment information tool
+    class PrintEnvTool < MCP::Tool
+      description 'Get the current working directory and environment path of the MCP server, ensuring correct directory context'
+
+      input_schema(
+        properties: {},
+        required: []
+      )
+
+      class << self
+        def call(server_context:)
+          msg = <<~MESSAGE
+            Relay these exact details to the user:
+            Current Directory: #{Dir.pwd}
+            Environment: #{ENV.fetch('PWD', nil)}
+          MESSAGE
+          Helpers.chdir do
+            msg << "Chdir'd to #{Helpers.pwd}\n"
+          end
+          msg << ENV.to_h.map { |key, value| "#{key}=#{value}" }.join("\n")
+
+          MCP::Tool::Response.new([{
+                                    type: 'text',
+                                    text: msg
+                                  }])
+        end
+      end
+    end
+  end
+end

data/lib/chatwerk/version.rb

@@ -0,0 +1,6 @@
+# typed: false
+# frozen_string_literal: true
+
+module Chatwerk
+  VERSION = '0.1.0'
+end

data/lib/chatwerk/views/base_view.rb

@@ -0,0 +1,54 @@
+# frozen_string_literal: true
+
+module Chatwerk
+  module Views
+    class BaseView
+      def self.render(**data)
+        new(**data).render
+      end
+
+      attr_reader :data, :output
+
+      def initialize(**data)
+        @data = data
+        @output = nil
+      end
+
+      def render
+        @output = nil
+        temp = template(**data)
+        return temp if @output.nil? # allow templates to return a string instead
+
+        @output
+      end
+
+      private
+
+      def template(**data)
+        raise NotImplementedError, 'Subclasses must implement the #template method'
+      end
+
+      def say(message = '')
+        @output ||= +''
+        @output << message << "\n"
+      end
+
+      def method_missing(name, *args, **kwargs, &block)
+        @data[name]
+      end
+
+      def respond_to_missing?(name, include_private = false)
+        data.key?(name) || super
+      end
+
+      def format_count(count, singular, plural = nil)
+        if count == 1
+          "1 #{singular}"
+        else
+          plural ||= "#{singular}s"
+          "#{count} #{plural}"
+        end
+      end
+    end
+  end
+end

data/lib/chatwerk/views/no_packages_view.rb

@@ -0,0 +1,28 @@
+# frozen_string_literal: true
+
+module Chatwerk
+  module Views
+    class NoPackagesView < BaseView
+      def template(has_packwerk_yml: false)
+        if has_packwerk_yml
+          <<~MESSAGE
+            0 packages found.
+            `packwerk.yml` file exists in project root: #{Chatwerk::Helpers.pwd}
+
+            * Check that the project root is correct.
+            * Make sure that packwerk is initialized correctly.
+            * Make sure at least one package is defined.
+          MESSAGE
+        else
+          <<~MESSAGE
+            This project does not appear to be using packwerk.
+            `packwerk.yml` file does not exist in project root: #{Chatwerk::Helpers.pwd}
+
+            * Check that the project root is correct.
+            * Check to make sure that packwerk is installed and initialized correctly.
+          MESSAGE
+        end
+      end
+    end
+  end
+end

data/lib/chatwerk/views/no_violations_view.rb

@@ -0,0 +1,20 @@
+# frozen_string_literal: true
+
+module Chatwerk
+  module Views
+    class NoViolationsView < BaseView
+      def template(package:, constant_name: nil)
+        if constant_name.nil?
+          <<~MESSAGE
+            No violations found in #{package.name.inspect}.
+          MESSAGE
+        else
+          <<~MESSAGE
+            No violations found in #{package.name.inspect} for #{constant_name.inspect}.
+            Ensure that constant_name is given in the format of "::ConstantName" or "::ConstantName::NestedConstant".
+          MESSAGE
+        end
+      end
+    end
+  end
+end

data/lib/chatwerk/views/package_view.rb

@@ -0,0 +1,25 @@
+# frozen_string_literal: true
+
+module Chatwerk
+  module Views
+    class PackageView < BaseView
+      def template(package:, package_path: nil)
+        consumers = QueryPackwerk::Packages.all.to_a.select { |p| p.dependency_names.include?(package.name) }.map(&:name)
+        consumers += package.consumer_names
+        consumers.uniq.sort!
+
+        say YAML.dump({
+          name: package.name,
+          enforce_dependencies: package.enforce_dependencies,
+          enforce_privacy: package.enforce_privacy,
+          owner: package.owner,
+          metadata: package.metadata,
+          dependencies: package.dependency_names,
+          consumers:,
+          todos_count: package.todos.count,
+          violations_count: package.violations.count
+        }.transform_keys(&:to_s))
+      end
+    end
+  end
+end

data/lib/chatwerk/views/packages_view.rb

@@ -0,0 +1,15 @@
+# frozen_string_literal: true
+
+module Chatwerk
+  module Views
+    class PackagesView < BaseView
+      def template(packages:, package_path: nil)
+        if packages.empty?
+          "No packages found matching #{package_path.inspect}\n"
+        else
+          packages.map { |p| "#{p.name}\n" }.sort.join
+        end
+      end
+    end
+  end
+end

data/lib/chatwerk/views/violations_details_view.rb

@@ -0,0 +1,46 @@
+# frozen_string_literal: true
+
+module Chatwerk
+  module Views
+    class ViolationsDetailsView < BaseView
+      def template(package:, violations:, constant_name:)
+        relevant_violations = violations.anonymous_sources_with_locations.select { |c, _| c.start_with?(constant_name) }
+
+        if relevant_violations.empty?
+          Views::NoViolationsView.render(package:, constant_name:)
+        else
+          grep_formatted_violations(relevant_violations)
+        end
+      end
+
+      private
+
+      def grep_formatted_violations(relevant_violations)
+        # Group violations by file
+        files_to_violations = {}
+
+        relevant_violations.each do |constant, source_info|
+          say "No sources found for #{constant}" if source_info.empty?
+          source_info.each do |code, files|
+            say "No files found for #{constant} with code: #{code}" if files.empty?
+
+            files.each do |file_with_line|
+              file, line = file_with_line.split(':')
+              files_to_violations[file] ||= []
+              files_to_violations[file] << { constant:, code:, line: line }
+            end
+          end
+        end
+
+        # Output violations grouped by file
+        files_to_violations.sort.map do |file, violations|
+          lines = violations.sort_by { |v| v[:line].to_i }.map do |violation|
+            "#{violation[:line]}:   #{violation[:code]}"
+          end.join("\n")
+
+          "#{file}\n#{lines}\n"
+        end.join("\n")
+      end
+    end
+  end
+end

data/lib/chatwerk/views/violations_list_view.rb

@@ -0,0 +1,32 @@
+# frozen_string_literal: true
+
+module Chatwerk
+  module Views
+    class ViolationsListView < BaseView
+      # The anonymous_source_counts method returns a hash as follows:
+      # {
+      #   "::Core::User" => {
+      #     "User.find(_)" => 2,
+      #     "User.create(_)" => 1
+      #   }
+      #   "::Core::Product" => {
+      #     "Product.find(_)" => 1,
+      #     "Product.create(_)" => 1
+      #   }
+      # }
+      def template(package:, violations:)
+        sums = violations.anonymous_source_counts.transform_values do |source_counts|
+          source_counts.values.sum
+        end
+
+        if sums.empty?
+          NoViolationsView.render(package:)
+        else
+          sums.sort_by { |_, count| -count }.map do |constant_name, count|
+            "#{constant_name} (#{format_count(count, 'violation')})\n"
+          end.join
+        end
+      end
+    end
+  end
+end

data/lib/chatwerk/views.rb

@@ -0,0 +1,10 @@
+module Chatwerk
+  module Views
+    autoload :NoPackagesView, 'chatwerk/views/no_packages_view'
+    autoload :NoViolationsView, 'chatwerk/views/no_violations_view'
+    autoload :PackageView, 'chatwerk/views/package_view'
+    autoload :PackagesView, 'chatwerk/views/packages_view'
+    autoload :ViolationsDetailsView, 'chatwerk/views/violations_details_view'
+    autoload :ViolationsListView, 'chatwerk/views/violations_list_view'
+  end
+end

data/lib/chatwerk.rb

@@ -0,0 +1,16 @@
+# typed: strict
+# frozen_string_literal: true
+
+require 'zeitwerk'
+require 'query_packwerk'
+require 'sorbet-runtime'
+require 'chatwerk/version'
+
+loader = Zeitwerk::Loader.for_gem
+loader.setup
+
+# Chatwerk provides integration between QueryPackwerk and AI tools
+# via the Model Context Protocol (MCP) server.
+module Chatwerk
+  class NotFoundError < Error; end
+end

data/mise.toml

@@ -0,0 +1,2 @@
+[tools]
+ruby = "3.4.2"

data/sig/chatwerk.rbs

@@ -0,0 +1,4 @@
+module Chatwerk
+  VERSION: String
+  # See the writing guide of rbs: https://github.com/ruby/rbs#guides
+end

metadata

@@ -0,0 +1,145 @@
+--- !ruby/object:Gem::Specification
+name: chatwerk
+version: !ruby/object:Gem::Version
+  version: 0.1.0
+platform: ruby
+authors:
+- Gusto Engineering
+bindir: exe
+cert_chain: []
+date: 1980-01-02 00:00:00.000000000 Z
+dependencies:
+- !ruby/object:Gem::Dependency
+  name: mcp
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '0.1'
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '0.1'
+- !ruby/object:Gem::Dependency
+  name: query_packwerk
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '0.1'
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '0.1'
+- !ruby/object:Gem::Dependency
+  name: sorbet-runtime
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '0'
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '0'
+- !ruby/object:Gem::Dependency
+  name: thor
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '0'
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '0'
+- !ruby/object:Gem::Dependency
+  name: zeitwerk
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '0'
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '0'
+description: MCP server and API for integrating Packwerk with AI tools like Cursor.
+email:
+- dev@gusto.com
+executables:
+- chatwerk
+extensions: []
+extra_rdoc_files: []
+files:
+- ".rspec"
+- ".rubocop.yml"
+- CHANGELOG.md
+- LICENSE.txt
+- README.md
+- Rakefile
+- config.ru
+- exe/chatwerk
+- lib/chatwerk.rb
+- lib/chatwerk/api.rb
+- lib/chatwerk/cli.rb
+- lib/chatwerk/error.rb
+- lib/chatwerk/helpers.rb
+- lib/chatwerk/mcp.rb
+- lib/chatwerk/tools/package_todos_tool.rb
+- lib/chatwerk/tools/package_tool.rb
+- lib/chatwerk/tools/package_violations_tool.rb
+- lib/chatwerk/tools/packages_tool.rb
+- lib/chatwerk/tools/print_env_tool.rb
+- lib/chatwerk/version.rb
+- lib/chatwerk/views.rb
+- lib/chatwerk/views/base_view.rb
+- lib/chatwerk/views/no_packages_view.rb
+- lib/chatwerk/views/no_violations_view.rb
+- lib/chatwerk/views/package_view.rb
+- lib/chatwerk/views/packages_view.rb
+- lib/chatwerk/views/violations_details_view.rb
+- lib/chatwerk/views/violations_list_view.rb
+- mise.toml
+- sig/chatwerk.rbs
+homepage: https://github.com/rubyatscale/chatwerk
+licenses:
+- MIT
+metadata:
+  allowed_push_host: https://rubygems.org
+  homepage_uri: https://github.com/rubyatscale/chatwerk
+  source_code_uri: https://github.com/rubyatscale/chatwerk
+  changelog_uri: https://github.com/rubyatscale/chatwerk/blob/main/CHANGELOG.md
+rdoc_options: []
+require_paths:
+- lib
+required_ruby_version: !ruby/object:Gem::Requirement
+  requirements:
+  - - ">="
+    - !ruby/object:Gem::Version
+      version: 3.1.0
+required_rubygems_version: !ruby/object:Gem::Requirement
+  requirements:
+  - - ">="
+    - !ruby/object:Gem::Version
+      version: '0'
+requirements: []
+rubygems_version: 3.7.1
+specification_version: 4
+summary: 'Chatwerk: AI integration for Packwerk'
+test_files: []