earl-bot 0.1.0

data/lib/earl/tool_input_formatter.rb

@@ -0,0 +1,44 @@
+# frozen_string_literal: true
+
+module Earl
+  # Shared tool input formatting for display in Mattermost posts and permission requests.
+  module ToolInputFormatter
+    TOOL_ICONS = {
+      "Bash" => "🔧", "Read" => "📖", "Edit" => "✏️", "Write" => "📝",
+      "WebFetch" => "🌐", "WebSearch" => "🌐", "Glob" => "🔍", "Grep" => "🔍",
+      "Task" => "👥", "AskUserQuestion" => "❓"
+    }.freeze
+
+    def format_tool_display(tool_name, input)
+      icon = TOOL_ICONS.fetch(tool_name, "⚙️")
+      detail = extract_tool_detail_from(tool_name, input)
+
+      if detail
+        "#{icon} `#{tool_name}`\n```\n#{detail}\n```"
+      else
+        "#{icon} `#{tool_name}`"
+      end
+    end
+
+    private
+
+    def extract_tool_detail_from(tool_name, input)
+      key = TOOL_DETAIL_KEYS[tool_name]
+      key ? input&.dig(key) : summarize_input(input)
+    end
+
+    TOOL_DETAIL_KEYS = {
+      "Bash" => "command", "Read" => "file_path", "Edit" => "file_path",
+      "Write" => "file_path", "WebFetch" => "url", "WebSearch" => "query",
+      "Grep" => "pattern", "Glob" => "pattern"
+    }.freeze
+    private_constant :TOOL_DETAIL_KEYS
+
+    def summarize_input(input)
+      return nil unless input
+
+      entries = input.to_h.compact
+      entries.empty? ? nil : JSON.generate(entries)
+    end
+  end
+end

data/lib/earl/version.rb

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

data/lib/earl.rb

@@ -0,0 +1,87 @@
+# frozen_string_literal: true
+
+require "json"
+require "net/http"
+require "uri"
+require "logger"
+require "open3"
+require "securerandom"
+require "fileutils"
+require "tmpdir"
+require "time"
+
+require_relative "earl/version"
+require_relative "earl/logging"
+require_relative "earl/formatting"
+require_relative "earl/permission_config"
+require_relative "earl/tool_input_formatter"
+require_relative "earl/config"
+require_relative "earl/mattermost"
+require_relative "earl/claude_session"
+require_relative "earl/session_store"
+require_relative "earl/session_manager"
+require_relative "earl/streaming_response"
+require_relative "earl/message_queue"
+require_relative "earl/command_parser"
+require_relative "earl/command_executor"
+require_relative "earl/question_handler"
+require_relative "earl/mcp/config"
+require_relative "earl/mcp/handler_base"
+require_relative "earl/mcp/approval_handler"
+require_relative "earl/mcp/memory_handler"
+require_relative "earl/mcp/heartbeat_handler"
+require_relative "earl/mcp/tmux_handler"
+require_relative "earl/mcp/github_pat_handler"
+require_relative "earl/mcp/server"
+require_relative "earl/memory/store"
+require_relative "earl/memory/prompt_builder"
+require_relative "earl/cron_parser"
+require_relative "earl/heartbeat_config"
+require_relative "earl/heartbeat_scheduler"
+require_relative "earl/safari_automation"
+require_relative "earl/tmux"
+require_relative "earl/tmux_session_store"
+require_relative "earl/tmux_monitor"
+require_relative "earl/runner/thread_context_builder"
+require_relative "earl/runner/service_builder"
+require_relative "earl/runner/startup"
+require_relative "earl/runner/lifecycle"
+require_relative "earl/runner/message_handling"
+require_relative "earl/runner/reaction_handling"
+require_relative "earl/runner/response_lifecycle"
+require_relative "earl/runner/idle_management"
+require_relative "earl/runner"
+
+# Top-level module for EARL (Eric's Automated Response Line), a Mattermost bot
+# that bridges team chat with Claude AI sessions for interactive assistance.
+module Earl
+  VALID_ENVIRONMENTS = %w[production development].freeze
+
+  def self.env
+    @env ||= ENV.fetch("EARL_ENV", "production").tap do |value|
+      unless VALID_ENVIRONMENTS.include?(value)
+        raise ArgumentError, "Invalid EARL_ENV=#{value.inspect}. Valid: #{VALID_ENVIRONMENTS.join(", ")}"
+      end
+    end
+  end
+
+  def self.development?
+    env == "development"
+  end
+
+  def self.config_root
+    @config_root ||= File.join(Dir.home, ".config", development? ? "earl-dev" : "earl")
+  end
+
+  def self.logger
+    @logger ||= Logger.new($stdout, level: Logger::INFO).tap do |log|
+      log.formatter = proc do |severity, datetime, _progname, msg|
+        "#{datetime.strftime("%H:%M:%S")} [#{severity}] #{msg}\n"
+      end
+    end
+  end
+
+  def self.logger=(logger)
+    @logger = logger
+  end
+end

data/lib/tasks/.keep

@@ -0,0 +1 @@
+

metadata

@@ -0,0 +1,248 @@
+--- !ruby/object:Gem::Specification
+name: earl-bot
+version: !ruby/object:Gem::Version
+  version: 0.1.0
+platform: ruby
+authors:
+- Eric Boehs
+bindir: exe
+cert_chain: []
+date: 1980-01-02 00:00:00.000000000 Z
+dependencies:
+- !ruby/object:Gem::Dependency
+  name: websocket-client-simple
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '0.9'
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '0.9'
+- !ruby/object:Gem::Dependency
+  name: bundler-audit
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '0.9'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '0.9'
+- !ruby/object:Gem::Dependency
+  name: minitest
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '5.0'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '5.0'
+- !ruby/object:Gem::Dependency
+  name: rake
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '13.0'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '13.0'
+- !ruby/object:Gem::Dependency
+  name: reek
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '6.0'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '6.0'
+- !ruby/object:Gem::Dependency
+  name: rubocop
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '1.0'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '1.0'
+- !ruby/object:Gem::Dependency
+  name: rubocop-rake
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '0.7'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '0.7'
+- !ruby/object:Gem::Dependency
+  name: simplecov
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '0.22'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '0.22'
+description: EARL (Eric's Automated Response Line) connects to Mattermost via WebSocket,
+  listens for messages, spawns Claude Code CLI sessions, and streams responses back
+  as threaded replies.
+email:
+- ericboehs@gmail.com
+executables:
+- earl
+- earl-install
+- earl-permission-server
+extensions: []
+extra_rdoc_files: []
+files:
+- ".ruby-version"
+- CHANGELOG.md
+- CLAUDE.md
+- Gemfile
+- Gemfile.lock
+- LICENSE
+- README.md
+- Rakefile
+- bin/README.md
+- bin/ci
+- bin/claude-context
+- bin/claude-usage
+- bin/coverage
+- bin/rubocop
+- bin/watch-ci
+- config/earl-claude-home/.claude/CLAUDE.md
+- config/earl-claude-home/.claude/settings.json
+- earl-bot.gemspec
+- exe/earl
+- exe/earl-install
+- exe/earl-permission-server
+- lib/earl.rb
+- lib/earl/claude_session.rb
+- lib/earl/claude_session/stats.rb
+- lib/earl/command_executor.rb
+- lib/earl/command_executor/constants.rb
+- lib/earl/command_executor/heartbeat_display.rb
+- lib/earl/command_executor/lifecycle_handler.rb
+- lib/earl/command_executor/session_handler.rb
+- lib/earl/command_executor/spawn_handler.rb
+- lib/earl/command_executor/stats_formatter.rb
+- lib/earl/command_executor/usage_handler.rb
+- lib/earl/command_parser.rb
+- lib/earl/config.rb
+- lib/earl/cron_parser.rb
+- lib/earl/formatting.rb
+- lib/earl/heartbeat_config.rb
+- lib/earl/heartbeat_scheduler.rb
+- lib/earl/heartbeat_scheduler/config_reloading.rb
+- lib/earl/heartbeat_scheduler/execution.rb
+- lib/earl/heartbeat_scheduler/heartbeat_state.rb
+- lib/earl/heartbeat_scheduler/lifecycle.rb
+- lib/earl/logging.rb
+- lib/earl/mattermost.rb
+- lib/earl/mattermost/api_client.rb
+- lib/earl/mcp/approval_handler.rb
+- lib/earl/mcp/config.rb
+- lib/earl/mcp/github_pat_handler.rb
+- lib/earl/mcp/handler_base.rb
+- lib/earl/mcp/heartbeat_handler.rb
+- lib/earl/mcp/memory_handler.rb
+- lib/earl/mcp/server.rb
+- lib/earl/mcp/tmux_handler.rb
+- lib/earl/memory/prompt_builder.rb
+- lib/earl/memory/store.rb
+- lib/earl/message_queue.rb
+- lib/earl/permission_config.rb
+- lib/earl/question_handler.rb
+- lib/earl/question_handler/question_posting.rb
+- lib/earl/runner.rb
+- lib/earl/runner/idle_management.rb
+- lib/earl/runner/lifecycle.rb
+- lib/earl/runner/message_handling.rb
+- lib/earl/runner/reaction_handling.rb
+- lib/earl/runner/response_lifecycle.rb
+- lib/earl/runner/service_builder.rb
+- lib/earl/runner/startup.rb
+- lib/earl/runner/thread_context_builder.rb
+- lib/earl/safari_automation.rb
+- lib/earl/session_manager.rb
+- lib/earl/session_manager/persistence.rb
+- lib/earl/session_manager/session_creation.rb
+- lib/earl/session_store.rb
+- lib/earl/streaming_response.rb
+- lib/earl/tmux.rb
+- lib/earl/tmux/parsing.rb
+- lib/earl/tmux/processes.rb
+- lib/earl/tmux/sessions.rb
+- lib/earl/tmux_monitor.rb
+- lib/earl/tmux_monitor/alert_dispatcher.rb
+- lib/earl/tmux_monitor/output_analyzer.rb
+- lib/earl/tmux_monitor/permission_forwarder.rb
+- lib/earl/tmux_monitor/question_forwarder.rb
+- lib/earl/tmux_session_store.rb
+- lib/earl/tool_input_formatter.rb
+- lib/earl/version.rb
+- lib/tasks/.keep
+homepage: https://github.com/ericboehs/earl
+licenses:
+- MIT
+metadata:
+  homepage_uri: https://github.com/ericboehs/earl
+  source_code_uri: https://github.com/ericboehs/earl
+  changelog_uri: https://github.com/ericboehs/earl/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'
+required_rubygems_version: !ruby/object:Gem::Requirement
+  requirements:
+  - - ">="
+    - !ruby/object:Gem::Version
+      version: '0'
+requirements: []
+rubygems_version: 4.0.3
+specification_version: 4
+summary: A Mattermost bot that spawns Claude Code CLI sessions
+test_files: []