heathrow 0.7.0

checksums.yaml

@@ -0,0 +1,7 @@
+---
+SHA256:
+  metadata.gz: af875b0f7d9ee70cf0f340207d21b5d367e6a8c98464361560c8b7649b2b6195
+  data.tar.gz: 30cc45fe89911cfe787a32a1e36e6d5d7a41a8e407779a2fb73cb0428b1b2e75
+SHA512:
+  metadata.gz: b2d822a3c2a09d17e13b8f579f4a91fe896145c303be3c51620dc059888ca710c733c302d705eaa7ecd0c709b79bb4524c831bc7f66aff937f39779b3c886c8a
+  data.tar.gz: 7ff0e102006c3bb8c33e527612890832120b67f9e3300840d20419bb04e67c0b50afd9b1896e951025c2abd913fe119b959ddf19554b1eb3a6947209a07341f8

data/.gitignore

@@ -0,0 +1,58 @@
+# Ruby
+*.gem
+*.rbc
+/.config
+/coverage/
+/InstalledFiles
+/pkg/
+/spec/reports/
+/spec/examples.txt
+/test/tmp/
+/test/version_tmp/
+/tmp/
+
+# Bundler
+/.bundle/
+/vendor/bundle
+/vendor/
+/lib/bundler/man/
+.bundle/
+
+# Chitt specific
+~/.chitt/
+*.db
+*.db-shm
+*.db-wal
+/logs/
+/attachments/
+
+# Environment
+.env
+.env.local
+
+# Editor directories
+.vscode/
+.idea/
+*.swp
+*.swo
+*~
+
+# OS
+.DS_Store
+Thumbs.db
+
+# Debug logs
+debug.log
+*.log
+*.bak
+
+# Personal test/setup scripts (contain credentials)
+test_*.rb
+setup_*.rb
+import_*.rb
+update_*.rb
+workspace_login.rb
+CLAUDE.md
+.claude/
+node_modules/
+package*.json

data/README.md

@@ -0,0 +1,205 @@
+# Heathrow
+
+<img src="img/heathrow.svg" align="right" width="150">
+
+**Where all your messages connect.**
+
+![Ruby](https://img.shields.io/badge/language-Ruby-red) [![Gem Version](https://badge.fury.io/rb/heathrow.svg)](https://badge.fury.io/rb/heathrow) ![Unlicense](https://img.shields.io/badge/license-Unlicense-green) [![Documentation](https://img.shields.io/badge/docs-comprehensive-blue)](docs/) ![Stay Amazing](https://img.shields.io/badge/Stay-Amazing-important)
+
+A unified TUI for all your communication. Like Heathrow Airport, every message routes through one hub. Replace mutt, newsboat, weechat, and a dozen chat apps with one terminal interface.
+
+## The Problem
+
+"Dad, I sent you a message." Which app? Email? WhatsApp? Discord? Telegram? SMS? Nobody should have to chase 4-5 apps to find a message from their kid.
+
+## The Solution
+
+All sources in one place. Create your custom views. Full keyboard control.
+
+![RSS Threaded View](img/rss_threaded.png)
+
+## Background
+
+In 2007 I had the idea of One Communication Hub to rule them all. Now, with Claude Code, it was efficient to realize that idea. It has now replaced [mutt](http://mutt.org/) that I've been using since 2003, my RSS readers ([newsboat](https://newsboat.org/index.html) of late) and many other apps. Heathrow now functions as my communication hub :)
+
+## Features
+
+**Sources** (two-way read + reply):
+- Email via Maildir (works with offlineimap, mbsync, fetchmail, gmail_fetch)
+- IRC/Slack via WeeChat relay
+- Discord, Telegram, Instagram DMs, Messenger
+- Reddit
+
+**Sources** (read-only):
+- RSS/Atom feeds
+- Web page change monitoring
+
+**Core:**
+- Threaded, flat, and folder-grouped view modes
+- 10+ custom filtered views with AND/OR logic
+- Compose, reply, forward with address book aliases (mutt-style)
+- Postpone/recall drafts
+- Dynamic message loading with jump-to-date
+- Hidden HTML link extraction (SharePoint, OneDrive, etc.)
+- Full-text search via notmuch
+- Per-source colors, per-view threading, tag/star highlighting
+- RTFM file picker for attachments
+- Configurable editor args, SMTP, OAuth2
+- AI assistant integration (Claude Code)
+- First-time onboarding wizard
+
+![Source Management](img/sources.png)
+
+## Installation
+
+### Requirements
+
+- Ruby >= 2.7
+- [rcurses](https://github.com/isene/rcurses) gem
+- sqlite3 gem
+
+### From RubyGems
+
+```
+gem install heathrow
+```
+
+### From Source
+
+```
+git clone https://github.com/isene/heathrow.git
+cd heathrow
+gem install rcurses sqlite3
+./bin/heathrow
+```
+
+## Quick Start
+
+1. Run `heathrow`
+2. The onboarding wizard guides you through adding your first source
+3. Or press `S` to manage sources, `a` to add one
+
+## Key Bindings
+
+Press `?` for full help. Here are the essentials:
+
+### Navigation
+| Key | Action |
+|-----|--------|
+| `j`/`k` or arrows | Move up/down |
+| `Enter` | Open message |
+| `PgDn`/`PgUp` | Page through messages |
+| `Home`/`End` | First/last message |
+| `J` | Jump to date (yyyy-mm-dd) |
+| `n`/`p` | Next/previous unread |
+
+### Views
+| Key | Action |
+|-----|--------|
+| `A` | All messages |
+| `N` | New (unread) |
+| `S` | Sources management |
+| `0-9`, `F1-F12` | Custom filtered views |
+| `G` | Cycle view mode (flat/threaded/folders) |
+| `B` | Browse all folders |
+| `F` | Browse favorite folders |
+
+### Message Actions
+| Key | Action |
+|-----|--------|
+| `r` | Reply |
+| `e` | Reply with editor |
+| `g` | Reply all |
+| `f` | Forward |
+| `m` | Compose new |
+| `E` | Edit message as new |
+| `R` | Toggle read/unread |
+| `M` | Mark all in view as read |
+| `*` | Toggle star |
+| `t`/`T` | Tag message / tag all |
+| `d` | Mark for deletion |
+| `<` | Purge deleted |
+| `x` | Open in browser |
+| `v` | View attachments |
+| `Y` | Copy right pane to clipboard |
+| `y` | Copy message ID to clipboard |
+
+### Compose Prompt
+| Key | Action |
+|-----|--------|
+| `Enter` | Send |
+| `e` | Edit (re-open editor) |
+| `a` | Attach files (via RTFM picker) |
+| `p` | Postpone (save as draft) |
+| `ESC` | Cancel |
+
+### UI
+| Key | Action |
+|-----|--------|
+| `w` | Cycle pane width |
+| `Ctrl-b` | Cycle border style |
+| `D` | Cycle date format |
+| `o` | Cycle sort order |
+| `P` | Preferences popup |
+| `?` | Help (press again for extended) |
+| `q` | Quit |
+
+## Configuration
+
+All settings live in `~/.heathrow/heathrowrc` (Ruby syntax):
+
+```ruby
+# UI
+set :color_theme,   'Mutt'
+set :date_format,   '%b %-d'
+set :sort_order,    'latest'
+set :pane_width,    3
+set :border_style,  1
+
+# SMTP / OAuth2
+set :default_email,   'you@example.com'
+set :smtp_command,    '~/bin/gmail_smtp'
+set :safe_dir,        '~/.heathrow/mail'
+set :oauth2_script,   '~/bin/oauth2.py'
+set :oauth2_domains,  %w[gmail.com]
+
+# Identities (auto-selected by folder)
+identity 'default',
+  from:      'You <you@example.com>',
+  signature: '~/.signature',
+  smtp:      '~/bin/gmail_smtp'
+
+# Custom views
+view '1', 'Personal', folder: 'Personal'
+view '2', 'Work',     folder: 'Work'
+view '9', 'RSS',      source_type: 'rss'
+
+# Favorite folders
+set :favorite_folders, %w[Personal Work Archive]
+```
+
+Most settings are also available via the `P` preferences popup.
+
+## Architecture
+
+```
++-- Heathrow
+    +-- rcurses TUI (panes, input, rendering)
+    +-- SQLite database (messages, sources, views, settings)
+    +-- Source plugins (maildir, rss, weechat, discord, ...)
+    +-- Message organizer (threading, grouping, sorting)
+    +-- Background poller (per-source sync intervals)
+    +-- Composer (editor integration, address book, SMTP)
+```
+
+Each source is a self-contained plugin. Sources crash independently without affecting the core. Filters default to "show all" on failure.
+
+## Credits
+
+- Created by Geir Isene with [Claude Code](https://claude.ai/claude-code)
+- Built on [rcurses](https://github.com/isene/rcurses) TUI library
+- Inspired by [RTFM](https://github.com/isene/RTFM) file manager
+
+## License
+
+[Unlicense](https://unlicense.org/) - released into the public domain.

data/bin/heathrow

@@ -0,0 +1,42 @@
+#!/usr/bin/env ruby
+# frozen_string_literal: true
+
+# Heathrow - Communication Hub In The Terminal
+# A unified TUI for all your communication sources
+# Author: Geir Isene with Claude Code
+# License: Public Domain
+
+CRASH_LOG = '/tmp/heathrow-crash.log'
+
+require_relative '../lib/heathrow'
+
+begin
+  heathrow = Heathrow::Application.new
+  heathrow.run
+rescue Interrupt
+  # Restore terminal
+  system('stty sane 2>/dev/null')
+  print "\e[?25h\e[0m\e[2J\e[H"
+  $stdout.flush
+  exit 0
+rescue => e
+  # Log full crash details
+  crash = "#{Time.now.strftime('%Y-%m-%d %H:%M:%S')} CRASH in #{e.backtrace&.first}\n"
+  crash << "  #{e.class}: #{e.message}\n"
+  crash << "  Backtrace:\n"
+  e.backtrace&.first(20)&.each { |l| crash << "    #{l}\n" }
+  crash << "\n"
+  File.write(CRASH_LOG, crash, mode: 'a')
+
+  # Restore terminal fully (stty sane handles raw mode reset)
+  system('stty sane 2>/dev/null')
+  print "\e[?25h\e[0m\e[2J\e[H"
+  $stdout.flush
+
+  # Print to stderr (rsh captures this better than stdout)
+  loc = e.backtrace&.first&.sub(/^.*lib\/heathrow\//, '')
+  $stderr.puts "Heathrow crashed: #{e.class}: #{e.message}"
+  $stderr.puts "  at #{loc}"
+  $stderr.puts "  Full log: #{CRASH_LOG}"
+  exit 1
+end

data/bin/heathrowd

@@ -0,0 +1,283 @@
+#!/usr/bin/env ruby
+# frozen_string_literal: true
+
+# Heathrow Daemon - Background polling service
+# This runs independently of any Heathrow UI instances
+# Author: Geir Isene with Claude Code
+# License: Public Domain
+
+require 'fileutils'
+require 'logger'
+require 'optparse'
+require_relative '../lib/heathrow'
+
+class HeathrowDaemon
+  def initialize(options = {})
+    @options = {
+      daemonize: false,
+      pid_file: File.join(HEATHROW_HOME, 'heathrowd.pid'),
+      log_file: File.join(HEATHROW_LOGS, 'heathrowd.log'),
+      poll_interval: 30 # Default 30 seconds between polling cycles
+    }.merge(options)
+    
+    setup_logging
+    setup_components
+  end
+  
+  def start
+    if running?
+      @logger.info "Heathrow daemon already running (PID: #{read_pid})"
+      puts "Heathrow daemon already running"
+      return false
+    end
+    
+    if @options[:daemonize]
+      daemonize
+    end
+    
+    write_pid
+    setup_signal_handlers
+    
+    @logger.info "Starting Heathrow daemon (PID: #{Process.pid})"
+    puts "Starting Heathrow daemon..." unless @options[:daemonize]
+    
+    run_daemon
+  end
+  
+  def stop
+    unless running?
+      puts "Heathrow daemon not running"
+      return false
+    end
+    
+    pid = read_pid
+    begin
+      Process.kill('TERM', pid)
+      puts "Stopping Heathrow daemon (PID: #{pid})"
+      
+      # Wait for process to stop
+      30.times do
+        sleep 0.1
+        break unless running?
+      end
+      
+      if running?
+        Process.kill('KILL', pid)
+        puts "Force killed Heathrow daemon"
+      end
+      
+      cleanup_pid
+      true
+    rescue Errno::ESRCH
+      # Process already stopped
+      cleanup_pid
+      puts "Heathrow daemon was not running"
+      false
+    end
+  end
+  
+  def status
+    if running?
+      pid = read_pid
+      puts "Heathrow daemon running (PID: #{pid})"
+      true
+    else
+      puts "Heathrow daemon not running"
+      false
+    end
+  end
+  
+  private
+  
+  def setup_logging
+    @logger = Logger.new(@options[:log_file])
+    @logger.level = Logger::INFO
+    @logger.formatter = proc do |severity, datetime, progname, msg|
+      "[#{datetime.strftime('%Y-%m-%d %H:%M:%S')}] #{severity}: #{msg}\n"
+    end
+  end
+  
+  def setup_components
+    @db = Heathrow::Database.new
+    @plugin_manager = Heathrow::PluginManager.new(@db)
+    @running = false
+  end
+  
+  def daemonize
+    # Fork and detach from terminal
+    Process.fork && exit
+    Process.setsid
+    Process.fork && exit
+    
+    # Redirect standard streams
+    STDIN.reopen('/dev/null')
+    STDOUT.reopen('/dev/null', 'w')
+    STDERR.reopen('/dev/null', 'w')
+  end
+  
+  def write_pid
+    File.write(@options[:pid_file], Process.pid.to_s)
+  end
+  
+  def read_pid
+    return nil unless File.exist?(@options[:pid_file])
+    File.read(@options[:pid_file]).strip.to_i
+  end
+  
+  def cleanup_pid
+    File.delete(@options[:pid_file]) if File.exist?(@options[:pid_file])
+  end
+  
+  def running?
+    return false unless File.exist?(@options[:pid_file])
+    
+    pid = read_pid
+    return false unless pid && pid > 0
+    
+    begin
+      Process.kill(0, pid)
+      true
+    rescue Errno::ESRCH
+      # Process doesn't exist
+      cleanup_pid
+      false
+    end
+  end
+  
+  def setup_signal_handlers
+    %w[TERM INT].each do |signal|
+      Signal.trap(signal) do
+        @logger.info "Received #{signal} signal, shutting down..."
+        @running = false
+      end
+    end
+    
+    Signal.trap('HUP') do
+      @logger.info "Received HUP signal, reloading configuration..."
+      # Could reload config here if needed
+    end
+  end
+  
+  def run_daemon
+    @running = true
+    @logger.info "Daemon started, polling every #{@options[:poll_interval]} seconds"
+    
+    while @running
+      begin
+        poll_all_sources
+        sleep @options[:poll_interval]
+      rescue StandardError => e
+        @logger.error "Error in daemon loop: #{e.message}"
+        @logger.error e.backtrace.join("\n")
+        sleep 5 # Brief pause on error
+      end
+    end
+    
+    @logger.info "Daemon shutting down"
+    cleanup_pid
+  end
+  
+  def poll_all_sources
+    sources = @db.get_sources(true) # Only enabled sources
+    @logger.debug "Checking #{sources.size} enabled sources"
+    
+    sources.each do |source_data|
+      begin
+        poll_source(source_data)
+      rescue StandardError => e
+        @logger.error "Error polling source #{source_data['name']}: #{e.message}"
+      end
+    end
+  end
+  
+  def poll_source(source_data)
+    source = Heathrow::Source.new(
+      id: source_data['id'],
+      type: source_data['type'],
+      name: source_data['name'],
+      config: source_data['config'],
+      enabled: source_data['enabled'] == 1,
+      poll_interval: source_data['poll_interval'],
+      last_poll: source_data['last_poll']
+    )
+    
+    return unless source.should_poll?
+    
+    @logger.debug "Polling source: #{source.name}"
+    
+    plugin = @plugin_manager.create_source(source.type, source)
+    return unless plugin
+    
+    messages = plugin.fetch_messages
+    new_message_count = 0
+    
+    messages.each do |msg_data|
+      message = Heathrow::Message.new(msg_data)
+      message.source_id = source.id
+      message.source_type = source.type
+      
+      if @db.insert_message(message.to_h.values)
+        new_message_count += 1
+      end
+    end
+    
+    @db.update_source_poll_time(source.id)
+    
+    if new_message_count > 0
+      @logger.info "Fetched #{new_message_count} new messages from #{source.name}"
+    else
+      @logger.debug "No new messages from #{source.name}"
+    end
+  end
+end
+
+# Command line interface
+if __FILE__ == $0
+  options = {}
+  
+  OptionParser.new do |opts|
+    opts.banner = "Usage: heathrowd [options] {start|stop|restart|status}"
+    
+    opts.on("-d", "--daemon", "Run as daemon") do
+      options[:daemonize] = true
+    end
+    
+    opts.on("-i", "--interval SECONDS", Integer, "Polling interval (default: 30)") do |interval|
+      options[:poll_interval] = interval
+    end
+    
+    opts.on("-p", "--pid FILE", "PID file location") do |pid_file|
+      options[:pid_file] = pid_file
+    end
+    
+    opts.on("-l", "--log FILE", "Log file location") do |log_file|
+      options[:log_file] = log_file
+    end
+    
+    opts.on("-h", "--help", "Show this help") do
+      puts opts
+      exit
+    end
+  end.parse!
+  
+  command = ARGV[0]
+  unless %w[start stop restart status].include?(command)
+    puts "Usage: heathrowd [options] {start|stop|restart|status}"
+    exit 1
+  end
+  
+  daemon = HeathrowDaemon.new(options)
+  
+  case command
+  when 'start'
+    daemon.start
+  when 'stop'
+    daemon.stop
+  when 'restart'
+    daemon.stop
+    sleep 1
+    daemon.start
+  when 'status'
+    daemon.status
+  end
+end