heathrow 0.7.0

data/lib/heathrow/ui/views.rb

@@ -0,0 +1,8 @@
+# View management for Heathrow
+module Heathrow
+  module UI
+    module Views
+      # View filtering and management
+    end
+  end
+end

data/lib/heathrow/version.rb

@@ -0,0 +1,3 @@
+module Heathrow
+  VERSION = '0.7.0'
+end

data/lib/heathrow/wizards/discord_wizard.rb

@@ -0,0 +1,193 @@
+#!/usr/bin/env ruby
+# frozen_string_literal: true
+
+require 'net/http'
+require 'json'
+require 'io/console'
+
+module Heathrow
+  module Wizards
+    class DiscordWizard
+      def self.run(source = nil)
+        new(source).run
+      end
+      
+      def initialize(source = nil)
+        @source = source
+        @config = source ? source.config : {}
+      end
+      
+      def run
+        puts "\n=== Discord Configuration Wizard ==="
+        puts
+        
+        # Get token
+        token = get_token
+        return nil unless token
+        
+        # Test token
+        is_bot = test_token(token)
+        return nil unless is_bot
+        
+        @config['token'] = token
+        @config['is_bot'] = is_bot
+        
+        # Discover servers and channels
+        puts "\nDiscovering servers and channels..."
+        discover_and_select_channels(token, is_bot)
+        
+        # Set other options
+        @config['fetch_limit'] ||= 50
+        @config['polling_interval'] ||= 300
+        
+        puts "\n=== Configuration Complete ==="
+        puts "Token: #{token[0..20]}..."
+        puts "Bot account: #{is_bot ? 'Yes' : 'No'}"
+        puts "Channels: #{@config['channels'].split(',').length} selected" if @config['channels']
+        puts "Guilds: #{@config['guilds'].split(',').length} selected" if @config['guilds'] && !@config['guilds'].empty?
+        
+        @config
+      end
+      
+      private
+      
+      def get_token
+        puts "Discord Token Setup"
+        puts "-" * 40
+        puts "You can use either:"
+        puts "  1. Bot token (recommended) - Create at https://discord.com/developers/applications"
+        puts "  2. User token (against ToS) - Found in browser DevTools"
+        puts
+        
+        existing = @config['token']
+        if existing
+          print "Current token: #{existing[0..20]}...\nKeep this token? (Y/n): "
+          keep = gets.chomp.downcase
+          return existing unless keep == 'n'
+        end
+        
+        print "Enter Discord token: "
+        token = gets.chomp.strip
+        
+        if token.empty?
+          puts "Error: Token cannot be empty"
+          return nil
+        end
+        
+        token
+      end
+      
+      def test_token(token)
+        # Try as bot token first
+        uri = URI("https://discord.com/api/v10/users/@me")
+        
+        [true, false].each do |is_bot|
+          request = Net::HTTP::Get.new(uri)
+          request['Authorization'] = is_bot ? "Bot #{token}" : token
+          
+          response = Net::HTTP.start(uri.hostname, uri.port, use_ssl: true) do |http|
+            http.request(request)
+          end
+          
+          if response.is_a?(Net::HTTPSuccess)
+            user_data = JSON.parse(response.body)
+            puts "✓ Connected as: #{user_data['username']}##{user_data['discriminator']}"
+            puts "  Account type: #{is_bot ? 'Bot' : 'User'}"
+            return is_bot
+          end
+        end
+        
+        puts "✗ Failed to authenticate with Discord"
+        false
+      end
+      
+      def discover_and_select_channels(token, is_bot)
+        # Get user's guilds
+        uri = URI("https://discord.com/api/v10/users/@me/guilds")
+        request = Net::HTTP::Get.new(uri)
+        request['Authorization'] = is_bot ? "Bot #{token}" : token
+        
+        response = Net::HTTP.start(uri.hostname, uri.port, use_ssl: true) do |http|
+          http.request(request)
+        end
+        
+        unless response.is_a?(Net::HTTPSuccess)
+          puts "Could not fetch guilds. You can manually add channel IDs later."
+          return
+        end
+        
+        guilds = JSON.parse(response.body)
+        puts "\nFound #{guilds.length} servers:"
+        
+        # Show guilds and their channels
+        selected_channels = []
+        selected_guilds = []
+        
+        guilds.each_with_index do |guild, index|
+          puts "\n#{index + 1}. #{guild['name']}"
+          
+          # Get channels for this guild
+          channels_uri = URI("https://discord.com/api/v10/guilds/#{guild['id']}/channels")
+          channels_request = Net::HTTP::Get.new(channels_uri)
+          channels_request['Authorization'] = is_bot ? "Bot #{token}" : token
+          
+          channels_response = Net::HTTP.start(channels_uri.hostname, channels_uri.port, use_ssl: true) do |http|
+            http.request(channels_request)
+          end
+          
+          if channels_response.is_a?(Net::HTTPSuccess)
+            channels = JSON.parse(channels_response.body)
+            text_channels = channels.select { |c| c['type'] == 0 }  # Type 0 = text channel
+            
+            puts "   Channels:"
+            text_channels.first(10).each do |channel|
+              puts "    - ##{channel['name']} (ID: #{channel['id']})"
+            end
+            puts "    ... and #{text_channels.length - 10} more" if text_channels.length > 10
+          else
+            puts "   Could not fetch channels for this server"
+          end
+        end
+        
+        puts "\n" + "=" * 40
+        puts "Channel Selection Options:"
+        puts "  1. Select all channels from specific servers"
+        puts "  2. Select individual channels (enter IDs)"
+        puts "  3. Use existing configuration"
+        puts "  4. Skip for now"
+        print "\nChoice (1-4): "
+        
+        choice = gets.chomp
+        
+        case choice
+        when '1'
+          print "Enter server numbers (comma-separated, e.g., 1,3,5): "
+          numbers = gets.chomp.split(',').map(&:strip)
+          
+          numbers.each do |num|
+            idx = num.to_i - 1
+            if idx >= 0 && idx < guilds.length
+              selected_guilds << guilds[idx]['id']
+              puts "  Added: #{guilds[idx]['name']}"
+            end
+          end
+          
+          @config['guilds'] = selected_guilds.join(',') unless selected_guilds.empty?
+          
+        when '2'
+          puts "Enter channel IDs (comma-separated):"
+          puts "Tip: Right-click channel in Discord > Copy ID"
+          print "> "
+          channels = gets.chomp
+          @config['channels'] = channels unless channels.empty?
+          
+        when '3'
+          puts "Keeping existing configuration"
+          
+        else
+          puts "Skipping channel configuration"
+        end
+      end
+    end
+  end
+end

data/lib/heathrow/wizards/slack_wizard.rb

@@ -0,0 +1,140 @@
+#!/usr/bin/env ruby
+# frozen_string_literal: true
+
+require 'json'
+require_relative '../sources/slack'
+
+module Heathrow
+  module Wizards
+    # Setup wizard for Slack integration
+    class SlackWizard
+      def self.run
+        puts "\n=== Slack Setup Wizard ==="
+        puts "This will help you configure Slack integration for Heathrow.\n\n"
+        
+        puts "You'll need a Slack API token. You can get one by:"
+        puts "1. Creating a Slack App at https://api.slack.com/apps"
+        puts "2. Installing it to your workspace"
+        puts "3. Getting a User OAuth Token (xoxp-...) or Bot Token (xoxb-...)"
+        puts "\nFor full access to all channels and DMs, use a User Token."
+        puts "For limited bot access, use a Bot Token.\n\n"
+        
+        config = {}
+        
+        # Get API token
+        print "Enter your Slack API token (xoxp-... or xoxb-...): "
+        config['api_token'] = gets.chomp
+        
+        # Test the token
+        print "\nTesting connection..."
+        test_source = Heathrow::Sources::Slack.new(config)
+        
+        unless test_source.test_connection
+          puts "\nFailed to connect. Please check your token and try again."
+          return nil
+        end
+        
+        puts " Success!\n\n"
+        
+        # Get workspace name (optional)
+        print "Enter a name for this workspace (optional, for display): "
+        workspace = gets.chomp
+        config['workspace'] = workspace unless workspace.empty?
+        
+        # Ask about channel configuration
+        puts "\nChannel Configuration:"
+        puts "1. Monitor all channels I have access to (default)"
+        puts "2. Monitor specific channels only"
+        print "Choose option [1]: "
+        
+        choice = gets.chomp
+        choice = '1' if choice.empty?
+        
+        if choice == '2'
+          puts "\nEnter channel IDs to monitor (one per line, empty line to finish):"
+          puts "Example: C1234567890"
+          puts "You can find channel IDs in Slack by right-clicking a channel."
+          
+          channels = []
+          loop do
+            print "> "
+            channel = gets.chomp
+            break if channel.empty?
+            channels << channel
+          end
+          config['channel_ids'] = channels unless channels.empty?
+        end
+        
+        # Ask about DM configuration
+        puts "\nDirect Message Configuration:"
+        puts "1. Monitor all DMs (default)"
+        puts "2. Monitor specific users only"
+        print "Choose option [1]: "
+        
+        choice = gets.chomp
+        choice = '1' if choice.empty?
+        
+        if choice == '2'
+          puts "\nEnter user IDs to monitor DMs with (one per line, empty line to finish):"
+          puts "Example: U1234567890"
+          
+          users = []
+          loop do
+            print "> "
+            user = gets.chomp
+            break if user.empty?
+            users << user
+          end
+          config['dm_user_ids'] = users unless users.empty?
+        end
+        
+        # Ask about fetch interval
+        print "\nHow often to fetch messages (in seconds) [300]: "
+        interval = gets.chomp
+        config['fetch_interval'] = interval.empty? ? 300 : interval.to_i
+        
+        # Save configuration
+        source_name = workspace.empty? ? 'slack' : "slack_#{workspace.downcase.gsub(/\s+/, '_')}"
+        config_file = File.join(Dir.home, '.config', 'heathrow', 'sources', "#{source_name}.json")
+        
+        # Create directory if it doesn't exist
+        FileUtils.mkdir_p(File.dirname(config_file))
+        
+        # Write config
+        File.write(config_file, JSON.pretty_generate(config))
+        
+        puts "\n✓ Slack configuration saved to: #{config_file}"
+        puts "\nYou can now use this source in Heathrow!"
+        puts "The source will appear as: #{source_name}"
+        
+        config
+      end
+      
+      def self.run_oauth_flow
+        puts "\n=== Slack OAuth Setup (Alternative) ==="
+        puts "This method uses OAuth authentication flow.\n\n"
+        
+        puts "1. Go to: https://api.slack.com/apps"
+        puts "2. Create a new app or select existing"
+        puts "3. Add these OAuth scopes:"
+        puts "   - channels:history"
+        puts "   - channels:read"
+        puts "   - groups:history"
+        puts "   - groups:read"
+        puts "   - im:history"
+        puts "   - im:read"
+        puts "   - mpim:history"
+        puts "   - mpim:read"
+        puts "   - users:read"
+        puts "   - chat:write"
+        puts "4. Install the app to your workspace"
+        puts "5. Copy the User OAuth Token\n\n"
+        
+        print "Press Enter when ready to continue..."
+        gets
+        
+        run
+      end
+    end
+  end
+end

data/lib/heathrow.rb

@@ -0,0 +1,55 @@
+# Main Heathrow module
+require 'fileutils'
+require 'yaml'
+require 'json'
+require 'sqlite3'
+require 'time'
+
+# Create Heathrow home directory structure
+HEATHROW_HOME = File.expand_path('~/.heathrow')
+HEATHROW_DB = File.join(HEATHROW_HOME, 'heathrow.db')
+HEATHROW_CONFIG = File.join(HEATHROW_HOME, 'config.yml')
+HEATHROW_SOURCES = File.join(HEATHROW_HOME, 'sources')
+HEATHROW_VIEWS = File.join(HEATHROW_HOME, 'views')
+HEATHROW_ATTACHMENTS = File.join(HEATHROW_HOME, 'attachments')
+HEATHROW_PLUGINS = File.join(HEATHROW_HOME, 'plugins')
+HEATHROW_LOGS = File.join(HEATHROW_HOME, 'logs')
+
+# Create directory structure
+[HEATHROW_HOME, HEATHROW_SOURCES, HEATHROW_VIEWS, HEATHROW_ATTACHMENTS, HEATHROW_PLUGINS, HEATHROW_LOGS].each do |dir|
+  FileUtils.mkdir_p(dir)
+end
+
+# Load all components
+require_relative 'heathrow/version'
+
+# Core infrastructure (Phase 0)
+require_relative 'heathrow/logger'
+require_relative 'heathrow/event_bus'
+require_relative 'heathrow/database'
+require_relative 'heathrow/config'
+
+# Plugin system
+require_relative 'heathrow/plugin/base'
+require_relative 'heathrow/plugin_manager'
+
+# Models
+require_relative 'heathrow/message'
+require_relative 'heathrow/source'
+
+# Sources
+require_relative 'heathrow/sources/source_manager'
+
+# Background polling
+require_relative 'heathrow/poller'
+
+# UI components
+require_relative 'heathrow/ui/application'
+require_relative 'heathrow/ui/source_wizard'
+require_relative 'heathrow/ui/panes'
+require_relative 'heathrow/ui/navigation'
+require_relative 'heathrow/ui/views'
+
+module Heathrow
+  class Error < StandardError; end
+end

metadata

@@ -0,0 +1,147 @@
+--- !ruby/object:Gem::Specification
+name: heathrow
+version: !ruby/object:Gem::Version
+  version: 0.7.0
+platform: ruby
+authors:
+- Geir Isene
+- Claude Code
+autorequire:
+bindir: bin
+cert_chain: []
+date: 2026-03-16 00:00:00.000000000 Z
+dependencies:
+- !ruby/object:Gem::Dependency
+  name: rcurses
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '5.0'
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '5.0'
+- !ruby/object:Gem::Dependency
+  name: sqlite3
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '1.4'
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '1.4'
+description: A unified TUI application for managing all your communication sources
+  in one place. Brings together emails, WhatsApp, Discord, Reddit, RSS feeds, and
+  more into a single, efficient terminal interface.
+email:
+- g@isene.com
+executables:
+- heathrow
+extensions: []
+extra_rdoc_files: []
+files:
+- ".gitignore"
+- README.md
+- bin/heathrow
+- bin/heathrowd
+- docs/ARCHITECTURE.md
+- docs/DATABASE_SCHEMA.md
+- docs/DEVELOPMENT_WORKFLOW.md
+- docs/DISCORD_SETUP.md
+- docs/GMAIL_OAUTH_SETUP.md
+- docs/PLUGIN_SYSTEM.md
+- docs/PROJECT_PLAN.md
+- docs/README.md
+- docs/REDDIT_SETUP.md
+- docs/REPLY_FORWARD.md
+- docs/WHATSAPP_TELEGRAM_SETUP.md
+- heathrow.gemspec
+- heathrowd.service
+- img/heathrow.svg
+- img/rss_threaded.png
+- img/sources.png
+- lib/heathrow.rb
+- lib/heathrow/address_book.rb
+- lib/heathrow/config.rb
+- lib/heathrow/database.rb
+- lib/heathrow/database_new.rb
+- lib/heathrow/event_bus.rb
+- lib/heathrow/logger.rb
+- lib/heathrow/message.rb
+- lib/heathrow/message_composer.rb
+- lib/heathrow/message_organizer.rb
+- lib/heathrow/migrations/001_initial_schema.rb
+- lib/heathrow/notmuch.rb
+- lib/heathrow/oauth2_smtp.rb
+- lib/heathrow/plugin/base.rb
+- lib/heathrow/plugin_manager.rb
+- lib/heathrow/poller.rb
+- lib/heathrow/smtp_sender.rb
+- lib/heathrow/source.rb
+- lib/heathrow/sources/base.rb
+- lib/heathrow/sources/discord.rb
+- lib/heathrow/sources/gmail.rb
+- lib/heathrow/sources/imap.rb
+- lib/heathrow/sources/instagram.rb
+- lib/heathrow/sources/instagram_fetch.py
+- lib/heathrow/sources/instagram_send.py
+- lib/heathrow/sources/instagram_send_marionette.py
+- lib/heathrow/sources/maildir.rb
+- lib/heathrow/sources/messenger.rb
+- lib/heathrow/sources/messenger_fetch.js
+- lib/heathrow/sources/messenger_fetch_marionette.py
+- lib/heathrow/sources/messenger_send.js
+- lib/heathrow/sources/messenger_send.py
+- lib/heathrow/sources/reddit.rb
+- lib/heathrow/sources/rss.rb
+- lib/heathrow/sources/slack.rb
+- lib/heathrow/sources/source_manager.rb
+- lib/heathrow/sources/telegram.rb
+- lib/heathrow/sources/webpage.rb
+- lib/heathrow/sources/weechat.rb
+- lib/heathrow/sources/whatsapp.rb
+- lib/heathrow/ui/application.rb
+- lib/heathrow/ui/navigation.rb
+- lib/heathrow/ui/panes.rb
+- lib/heathrow/ui/source_wizard.rb
+- lib/heathrow/ui/threaded_view.rb
+- lib/heathrow/ui/views.rb
+- lib/heathrow/version.rb
+- lib/heathrow/wizards/discord_wizard.rb
+- lib/heathrow/wizards/slack_wizard.rb
+homepage: https://github.com/isene/heathrow
+licenses:
+- Unlicense
+metadata:
+  homepage_uri: https://github.com/isene/heathrow
+  source_code_uri: https://github.com/isene/heathrow
+  changelog_uri: https://github.com/isene/heathrow/blob/master/CHANGELOG.md
+post_install_message:
+rdoc_options: []
+require_paths:
+- lib
+required_ruby_version: !ruby/object:Gem::Requirement
+  requirements:
+  - - ">="
+    - !ruby/object:Gem::Version
+      version: 2.7.0
+required_rubygems_version: !ruby/object:Gem::Requirement
+  requirements:
+  - - ">="
+    - !ruby/object:Gem::Version
+      version: '0'
+requirements: []
+rubygems_version: 3.4.20
+signing_key:
+specification_version: 4
+summary: Communication Hub In The Terminal
+test_files: []