timely-calendar 1.0.0

data/lib/timely/ui/panes.rb

@@ -0,0 +1,46 @@
+module Timely
+  module UI
+    module Panes
+      def setup_display
+        require 'io/console'
+        if IO.console
+          @h, @w = IO.console.winsize
+        else
+          @h = ENV['LINES']&.to_i || 24
+          @w = ENV['COLUMNS']&.to_i || 80
+        end
+      end
+
+      def create_panes
+        @panes = {}
+
+        # Layout: info(1) + top(months, fixed 9) + mid(week, flexible) + bottom(details) + status(1)
+        # Top pane: 1 blank row + 8 month rows = 9
+        top_h = 9
+        bottom_h = (@h * 0.2).to_i
+        bottom_h = [bottom_h, 5].max
+        mid_h = @h - 2 - top_h - bottom_h  # 2 = info + status
+        mid_h = [mid_h, 4].max
+
+        # Adjust if overflow
+        if 2 + top_h + mid_h + bottom_h > @h
+          bottom_h = @h - 2 - top_h - mid_h
+          bottom_h = [bottom_h, 3].max
+        end
+
+        info_bg = @config ? @config.get('colors.info_bg', 235) : 235
+        status_bg = @config ? @config.get('colors.status_bg', 235) : 235
+        @panes[:info] = Rcurses::Pane.new(1, 1, @w, 1, 255, info_bg)
+        @panes[:top] = Rcurses::Pane.new(1, 2, @w, top_h)
+        @panes[:mid] = Rcurses::Pane.new(1, 2 + top_h, @w, mid_h)
+        @panes[:bottom] = Rcurses::Pane.new(1, 2 + top_h + mid_h, @w, bottom_h)
+        @panes[:status] = Rcurses::Pane.new(1, @h, @w, 1, 252, status_bg)
+
+        @panes.each_value do |p|
+          p.border = false
+          p.scroll = false
+        end
+      end
+    end
+  end
+end

data/lib/timely/ui/views/month.rb

@@ -0,0 +1,118 @@
+module Timely
+  module UI
+    module Views
+      module Month
+        WEEKDAYS = %w[Mo Tu We Th Fr Sa Su].freeze
+        MINI_WIDTH = 25  # 3 extra for "WW " week number prefix
+
+        # Render a compact mini-month calendar.
+        # Returns an array of strings (one per line), about 8-9 lines tall.
+        # selected_day: day number to highlight with reverse video (or nil)
+        # today: Date.today for bold+underline marking
+        # events_by_date: hash of Date => [event_hashes] for coloring event days
+        # width: available width (typically 22 chars)
+        def self.render_mini_month(year, month, selected_day, today, events_by_date, width = MINI_WIDTH, today_bg: 246)
+          lines = []
+
+          # Title: centered month and year
+          title = Date.new(year, month, 1).strftime("%B %Y")
+          pad = [(width - title.length) / 2, 1].max
+          lines << (" " * pad + title).b
+
+          # Weekday headers (with space for week number column)
+          header = "    " + WEEKDAYS.each_with_index.map { |d, i|
+            s = d.rjust(2)
+            case i
+            when 5 then s.fg(208)  # Saturday
+            when 6 then s.fg(167)  # Sunday
+            else s.fg(245)
+            end
+          }.join(" ")
+          lines << header
+
+          # Build calendar grid
+          first_day = Date.new(year, month, 1)
+          last_day = Date.new(year, month, -1)
+          start_offset = first_day.cwday - 1
+
+          week = []
+          start_offset.times { week << nil }
+
+          (1..last_day.day).each do |day|
+            week << day
+            if week.length == 7
+              lines << format_week(week, year, month, today, selected_day, events_by_date, today_bg)
+              week = []
+            end
+          end
+
+          # Final partial week
+          unless week.empty?
+            week << nil while week.length < 7
+            lines << format_week(week, year, month, today, selected_day, events_by_date, today_bg)
+          end
+
+          # Pad to consistent height (title + header + 6 week rows = 8 lines)
+          while lines.length < 8
+            lines << " " * width
+          end
+
+          lines
+        end
+
+        private
+
+        def self.format_week(week, year, month, today, selected_day, events_by_date, today_bg = 236)
+          # Find week number from first non-nil day in this row
+          first_day = week.compact.first
+          wn = first_day ? Date.new(year, month, first_day).cweek.to_s.rjust(2) : "  "
+
+          cells = week.map do |day|
+            if day.nil?
+              "  "
+            else
+              format_day(day, year, month, today, selected_day, events_by_date, today_bg)
+            end
+          end
+          wn.fg(238) + " " + cells.join(" ")
+        end
+
+        def self.format_day(day, year, month, today, selected_day, events_by_date, today_bg = 236)
+          date = Date.new(year, month, day)
+          events = events_by_date[date]
+
+          is_today = (date == today)
+          is_selected = (selected_day && day == selected_day && date.month == today.month && date.year == today.year) ||
+                        (selected_day && day == selected_day)
+
+          # selected_day is only meaningful when this is the selected month
+          # The caller controls which month gets a non-nil selected_day
+
+          # Base fg color: event > sunday > saturday > default
+          base_color = if events && !events.empty?
+            events.first['calendar_color'] || 39
+          elsif date.sunday?
+            167
+          elsif date.saturday?
+            208
+          else
+            nil
+          end
+
+          d = day.to_s.rjust(2)
+          if is_selected && is_today
+            base_color ? d.b.u.fg(base_color).bg(today_bg) : d.b.u.bg(today_bg)
+          elsif is_selected
+            base_color ? d.b.u.fg(base_color) : d.b.u
+          elsif is_today
+            base_color ? d.fg(base_color).bg(today_bg) : d.bg(today_bg)
+          elsif base_color
+            d.fg(base_color)
+          else
+            d
+          end
+        end
+      end
+    end
+  end
+end

data/lib/timely/version.rb

@@ -0,0 +1,3 @@
+module Timely
+  VERSION = '1.0.0'
+end

data/lib/timely/weather.rb

@@ -0,0 +1,111 @@
+require 'net/http'
+require 'json'
+require 'uri'
+
+module Timely
+  module Weather
+    SYMBOLS = {
+      0 => "\u2600",   # Clear sky
+      1 => "\u{1F324}", # Mostly clear
+      2 => "\u26C5",   # Partly cloudy
+      3 => "\u2601",   # Cloudy
+      5 => "\u{1F326}", # Rain showers
+      6 => "\u{1F327}", # Rain
+      8 => "\u{1F328}", # Snow
+      9 => "\u{1F329}", # Thunder
+    }.freeze
+
+    # Fetch weather forecast from met.no
+    # Returns hash of date_str => { temp_high:, temp_low:, symbol:, wind:, description: }
+    def self.fetch(lat, lon, db = nil)
+      # Check cache first (6 hour TTL)
+      if db
+        cached = db.execute(
+          "SELECT data, fetched_at FROM weather_cache WHERE date = 'forecast' LIMIT 1"
+        ).first
+        if cached && (Time.now.to_i - cached['fetched_at'].to_i) < 21600
+          return JSON.parse(cached['data']) rescue {}
+        end
+      end
+
+      uri = URI("https://api.met.no/weatherapi/locationforecast/2.0/complete?lat=#{lat}&lon=#{lon}")
+      req = Net::HTTP::Get.new(uri)
+      req['User-Agent'] = 'timely-calendar/0.1 g@isene.com'
+
+      res = Net::HTTP.start(uri.hostname, uri.port,
+                            use_ssl: true,
+                            read_timeout: 10,
+                            open_timeout: 5) do |http|
+        http.request(req)
+      end
+
+      return {} unless res.is_a?(Net::HTTPSuccess)
+
+      series = JSON.parse(res.body).dig('properties', 'timeseries') || []
+
+      # Group by date, find high/low temps and midday conditions
+      by_date = {}
+      series.each do |ts|
+        det = ts.dig('data', 'instant', 'details')
+        next unless det
+        time = ts['time']
+        date = time[0..9]
+        hour = time[11..12].to_i
+        temp = det['air_temperature'].to_f
+
+        by_date[date] ||= { temps: [], wind: 0, cloud: 0, midday_temp: nil }
+        by_date[date][:temps] << temp
+        # Capture midday (12:00) conditions for the symbol
+        if hour == 12
+          by_date[date][:midday_temp] = temp
+          by_date[date][:wind] = det['wind_speed'].to_f.round(1)
+          by_date[date][:cloud] = det['cloud_area_fraction'].to_i
+        end
+      end
+
+      forecast = {}
+      by_date.each do |date, data|
+        cloud = data[:cloud]
+        symbol = if cloud < 15
+          SYMBOLS[0]
+        elsif cloud < 40
+          SYMBOLS[1]
+        elsif cloud < 70
+          SYMBOLS[2]
+        else
+          SYMBOLS[3]
+        end
+
+        temps = data[:temps]
+        forecast[date] = {
+          'temp_high' => temps.max.round(1),
+          'temp_low' => temps.min.round(1),
+          'temp_mid' => (data[:midday_temp] || temps[temps.size / 2]).round(1),
+          'symbol' => symbol,
+          'wind' => data[:wind],
+          'cloud' => cloud
+        }
+      end
+
+      # Cache result
+      if db
+        db.execute(
+          "INSERT OR REPLACE INTO weather_cache (date, hour, data, fetched_at) VALUES (?, ?, ?, ?)",
+          'forecast', '00', JSON.generate(forecast), Time.now.to_i
+        )
+      end
+
+      forecast
+    rescue SocketError, Timeout::Error, Net::OpenTimeout, Errno::ECONNREFUSED => e
+      {}
+    end
+
+    # Get a short weather string for a date: "☀ 12°"
+    def self.short_for_date(forecast, date)
+      date_str = date.strftime('%Y-%m-%d')
+      w = forecast[date_str]
+      return nil unless w
+      "#{w['symbol']} #{w['temp_mid']}°"
+    end
+  end
+end

data/lib/timely.rb

@@ -0,0 +1,45 @@
+# Main Timely module
+require 'fileutils'
+require 'yaml'
+require 'json'
+require 'sqlite3'
+require 'time'
+require 'date'
+
+# Create Timely home directory structure
+TIMELY_HOME = File.expand_path('~/.timely')
+TIMELY_DB = File.join(TIMELY_HOME, 'timely.db')
+TIMELY_CONFIG = File.join(TIMELY_HOME, 'config.yml')
+TIMELY_LOGS = File.join(TIMELY_HOME, 'logs')
+TIMELY_CACHE = File.join(TIMELY_HOME, 'cache')
+
+# Create directory structure
+[TIMELY_HOME, TIMELY_LOGS, TIMELY_CACHE].each do |dir|
+  FileUtils.mkdir_p(dir)
+end
+
+# Load all components
+require_relative 'timely/version'
+
+# Core infrastructure
+require_relative 'timely/database'
+require_relative 'timely/config'
+require_relative 'timely/event'
+require_relative 'timely/astronomy'
+require_relative 'timely/weather'
+
+# Sources and sync
+require_relative 'timely/sources/ics_file'
+require_relative 'timely/sources/google'
+require_relative 'timely/sources/outlook'
+require_relative 'timely/sync/poller'
+require_relative 'timely/notifications'
+
+# UI components
+require_relative 'timely/ui/panes'
+require_relative 'timely/ui/views/month'
+require_relative 'timely/ui/application'
+
+module Timely
+  class Error < StandardError; end
+end

data/timely.gemspec

@@ -0,0 +1,33 @@
+require_relative 'lib/timely/version'
+
+Gem::Specification.new do |spec|
+  spec.name          = 'timely-calendar'
+  spec.version       = Timely::VERSION
+  spec.authors       = ['Geir Isene', 'Claude Code']
+  spec.email         = ['g@isene.com']
+
+  spec.summary       = 'Terminal Calendar - companion to Heathrow'
+  spec.description   = 'A unified TUI calendar with Google Calendar and Outlook/365 integration, moon phases, weather, astronomy, desktop notifications, and Heathrow messaging handoff. Built on rcurses.'
+  spec.homepage      = 'https://github.com/isene/timely'
+  spec.license       = 'Unlicense'
+
+  spec.required_ruby_version = '>= 2.7.0'
+
+  spec.metadata['homepage_uri'] = spec.homepage
+  spec.metadata['source_code_uri'] = 'https://github.com/isene/timely'
+
+  # Specify which files should be added to the gem
+  spec.files = Dir.chdir(File.expand_path(__dir__)) do
+    `git ls-files -z`.split("\x0").reject do |f|
+      f.match(%r{\A(?:test|spec|features)/})
+    end
+  end
+
+  spec.bindir        = 'bin'
+  spec.executables   = ['timely']
+  spec.require_paths = ['lib']
+
+  # Runtime dependencies
+  spec.add_runtime_dependency 'rcurses', '>= 5.0'
+  spec.add_runtime_dependency 'sqlite3', '>= 1.4'
+end

metadata

@@ -0,0 +1,98 @@
+--- !ruby/object:Gem::Specification
+name: timely-calendar
+version: !ruby/object:Gem::Version
+  version: 1.0.0
+platform: ruby
+authors:
+- Geir Isene
+- Claude Code
+autorequire:
+bindir: bin
+cert_chain: []
+date: 2026-03-23 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 calendar with Google Calendar and Outlook/365 integration,
+  moon phases, weather, astronomy, desktop notifications, and Heathrow messaging handoff.
+  Built on rcurses.
+email:
+- g@isene.com
+executables:
+- timely
+extensions: []
+extra_rdoc_files: []
+files:
+- ".gitignore"
+- CLAUDE.md
+- README.md
+- bin/timely
+- img/timely.svg
+- lib/timely.rb
+- lib/timely/astronomy.rb
+- lib/timely/config.rb
+- lib/timely/database.rb
+- lib/timely/event.rb
+- lib/timely/notifications.rb
+- lib/timely/sources/google.rb
+- lib/timely/sources/ics_file.rb
+- lib/timely/sources/outlook.rb
+- lib/timely/sync/poller.rb
+- lib/timely/ui/application.rb
+- lib/timely/ui/panes.rb
+- lib/timely/ui/views/month.rb
+- lib/timely/version.rb
+- lib/timely/weather.rb
+- timely.gemspec
+homepage: https://github.com/isene/timely
+licenses:
+- Unlicense
+metadata:
+  homepage_uri: https://github.com/isene/timely
+  source_code_uri: https://github.com/isene/timely
+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: Terminal Calendar - companion to Heathrow
+test_files: []