teems 0.2.0 → 0.3.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 644504d1f8d334a4ddec54ef8f099424d1251dd6d15beef3c1b713da93f0ce0e
-  data.tar.gz: 9c93db615cbe58642f127856e6c70d8b9cd0eefd81625b666cdfab736095a4cd
+  metadata.gz: 6b2001d1f6e7653df296a0443a0a2f2bec80068ca05b4693bfd2b74c5f6a5240
+  data.tar.gz: 4f8e3920b836feb38237cd828a11ab63589855391f21cbea90eee6a54a34be9f
 SHA512:
-  metadata.gz: b72dbf0beb2fc14d5af939699526bcc060f7dab85afd9ee4f49d7fa5272add46fcda9f3a345afd67db81e8bc01ce40ca0e3b739d6dfed65d279be0ecb4172d8d
-  data.tar.gz: 537ef91ebb3e91424172d4c3e17b8fb884cadccb5c670deaa62ee41737ffef59f650edde0cb068a81b4271983ac94fcc05befd82cd0cb1d6077803c8a488f817
+  metadata.gz: 245ff54545cf04f3d0db0062ab51ae2e1dc001a474c45c05e7e7cde21e8a00a523813b5019b96acaba0665010b6a6d31b7922141cb01a4203a2850f10fe5ad56
+  data.tar.gz: dffaa23979af2e85fffb8b0d3b8b3d8688aee1ff7c6d53eeeb5c151c81836380e93921eb5c37e2f2acf7d633a2f73e02a007e0c70af59a01e68f0bcb31a87f99

data/CHANGELOG.md

@@ -1,5 +1,28 @@
 # Changelog
 
+## [0.3.0] - 2026-04-23
+
+### Added
+- `teems meeting --audio` - Download audio-only M4A alongside or instead of video (ideal for transcription)
+- `teems meeting --no-video` - Skip the video download for audio-only output
+- `teems ooo` now supports timed schedules via `--start`/`--end` (e.g., "today 14:00") in addition to all-day dates
+- `teems ooo --invite` - Override the configured notify list for a single invocation
+
+### Changed
+- Recording, audio, and transcript files share a common base name derived from the SharePoint file (e.g., `2026-01-20 - Team Sync.mp4`/`.m4a`/`.vtt`)
+
+### Fixed
+- `teems meeting` shows call duration once on the event header instead of repeating it per participant
+
+## [0.2.0] - 2026-04-14
+
+### Added
+- `teems meeting` - View meeting details, download transcripts, and download recordings
+- Auto-authentication when tokens are missing or expired (no manual `auth login` needed)
+
+### Fixed
+- `teems cal delete` now uses configured endpoints instead of hardcoded defaults
+
 ## [0.1.0] - 2026-04-10
 
 ### Added

data/lib/teems/commands/cal.rb

@@ -477,56 +477,6 @@ module Teems
       end
     end
 
-    # Time parsing for create subcommand
-    module CalTimeParsing
-      private
-
-      def parse_time_input(raw)
-        date, time_str = split_time_input(raw)
-        return unless time_str
-
-        date.is_a?(String) ? parse_absolute_time(date, time_str) : parse_relative_time(date, time_str)
-      end
-
-      def split_time_input(raw)
-        base = Date.today
-        split_tomorrow_time(raw, base) || split_today_time(raw, base) || split_absolute_time(raw)
-      end
-
-      def split_tomorrow_time(raw, base)
-        return unless raw.start_with?('tomorrow ')
-
-        [base + 1, raw.delete_prefix('tomorrow ')]
-      end
-
-      def split_today_time(raw, base)
-        return unless raw.match?(/\A(?:today\s+)?\d{1,2}:\d{2}\z/)
-
-        [base, raw.delete_prefix('today ')]
-      end
-
-      def split_absolute_time(raw)
-        return unless raw.match?(/\A\d{4}-\d{2}-\d{2}\s+\d{1,2}:\d{2}\z/)
-
-        raw.split(/\s+/, 2)
-      end
-
-      def parse_relative_time(date, time_str)
-        hour, min = time_str.split(':').map(&:to_i)
-        debug("Parsing time #{hour}:#{min} for #{@options[:date]}") if @options[:verbose]
-        Time.new(date.year, date.month, date.day, hour, min, 0)
-      rescue ArgumentError
-        nil
-      end
-
-      def parse_absolute_time(date_str, time_str)
-        date = Date.parse(date_str)
-        parse_relative_time(date, time_str)
-      rescue Date::Error
-        nil
-      end
-    end
-
     # Builds the event body hash fields for create requests
     module CalEventFields
       private
@@ -640,7 +590,7 @@ module Teems
 
     # Event creation subcommand
     module CalCreateActions
-      include CalTimeParsing
+      include Support::TimeParsing
       include CalEventFields
       include CalCreateValidation
 

data/lib/teems/commands/meeting.rb

@@ -19,6 +19,8 @@ module Teems
         --transcript     Download meeting transcript (WebVTT)
         --recording      Download meeting recording (MP4, requires ffmpeg)
                          Combine with --transcript to embed subtitles
+        --audio          Also save a separate audio file (M4A) — ideal for transcription
+        --no-video       Skip the video file; with --audio produces audio-only output
         --chat           Show meeting chat messages
         -o, --output-dir Directory for downloads (default: current directory)
         -v, --verbose    Show debug output
@@ -30,6 +32,8 @@ module Teems
         teems meeting 19:meeting_abc123@thread.v2
         teems meeting 19:meeting_abc123@thread.v2 --chat
         teems meeting 19:meeting_abc123@thread.v2 --transcript
+        teems meeting 19:meeting_abc123@thread.v2 --audio -o ~/Downloads          # video + audio
+        teems meeting 19:meeting_abc123@thread.v2 --audio --no-video -o ~/Downloads  # audio only
         teems meeting 19:meeting_abc123@thread.v2 --recording -o ~/Downloads
         teems meeting 19:meeting_abc123@thread.v2 --recording --transcript -o ~/Downloads
         teems meeting AAMkAGVmMDEz...        # By calendar event ID
@@ -40,6 +44,8 @@ module Teems
       ALL = {
         '--transcript' => ->(opts, _args) { opts[:transcript] = true },
         '--recording' => ->(opts, _args) { opts[:recording] = true },
+        '--audio' => ->(opts, _args) { opts[:audio] = true },
+        '--no-video' => ->(opts, _args) { opts[:no_video] = true },
         '--chat' => ->(opts, _args) { opts[:chat] = true },
         '-o' => ->(opts, args) { opts[:output_dir] = args.shift },
         '--output-dir' => ->(opts, args) { opts[:output_dir] = args.shift }
@@ -187,10 +193,12 @@ module Teems
 
       def parse_call_event(msg)
         content = msg['content'].to_s
+        parts = extract_partlist(content)
         build_msg_hash(msg).merge(
           call_id: content.match(CALLID_RE)&.captures&.first,
           ical_uid: content.match(INSTANCE_ICAL_RE)&.captures&.first,
-          participants: extract_partlist(content)
+          duration: parts.first&.dig(:duration),
+          participants: parts
         )
       end
 
@@ -272,7 +280,8 @@ module Teems
 
       def display_single_call_event(event)
         puts
-        puts "  #{output.bold('Call Event')} #{format_time_str(event[:time])}"
+        header = "  #{output.bold('Call Event')} #{format_time_str(event[:time])}"
+        puts "#{header} (#{format_call_duration(event[:duration])})"
         display_participants(event[:participants])
       end
 
@@ -280,12 +289,12 @@ module Teems
         return if parts.empty?
 
         puts "  Participants (#{parts.length}):"
-        parts.each { |entry| puts format_participant_line(entry[:name], entry[:identity], entry[:duration]) }
+        parts.each { |entry| puts format_participant_line(entry[:name], entry[:identity]) }
       end
 
-      def format_participant_line(name, identity, duration)
+      def format_participant_line(name, identity)
         resolved = needs_resolution?(name) ? resolve_participant_name(identity) : name
-        "    #{resolved} (#{format_call_duration(duration)})"
+        "    #{resolved}"
       end
 
       def needs_resolution?(name)
@@ -452,19 +461,27 @@ module Teems
           display_meeting_chat(classified[:chat_messages])
           return 0
         end
-        return download_recording_with_transcript(target, classified) if @options[:recording]
+        media = media_output_spec
+        return download_media_with_transcript(target, classified, media) if media
         return download_transcript(target, classified) || 0 if @options[:transcript]
 
         display_meeting_summary(target, classified)
         0
       end
 
-      def download_recording_with_transcript(target, classified)
+      def media_output_spec
+        audio, recording, no_video = @options.values_at(:audio, :recording, :no_video)
+        return nil unless audio || recording || no_video
+
+        { video: (recording || audio) && !no_video, audio: audio || no_video }
+      end
+
+      def download_media_with_transcript(target, classified, media)
         if @options[:transcript]
           result = download_transcript(target, classified)
-          warn('Transcript download failed; proceeding with recording') if result == 1
+          warn("Transcript download failed; proceeding with #{media[:video] ? 'recording' : 'audio'}") if result == 1
         end
-        download_recording(target, classified) || 0
+        download_recording(target, classified, media: media) || 0
       end
     end
   end

data/lib/teems/commands/meeting_recording.rb

@@ -176,32 +176,86 @@ module Teems
       end
     end
 
+    # Writes video/audio output files from downloaded DASH tracks via ffmpeg
+    module RecordingOutputWriter
+      private
+
+      def produce_outputs(video_path, audio_path, media)
+        video_result = media[:video] ? write_video_output(video_path, audio_path) : true
+        audio_result = media[:audio] ? write_audio_output(audio_path) : true
+        FileUtils.rm_f([video_path, audio_path].compact)
+        video_result && audio_result ? 0 : 1
+      end
+
+      def write_video_output(video_path, audio_path)
+        output_path = File.join(@rec_dir, "#{@recording_stem}.mp4")
+        info('Merging video and audio tracks...')
+        merged = run_ffmpeg('-i', video_path, '-i', audio_path, '-c', 'copy', output_path)
+        return error('ffmpeg merge failed') && false unless merged
+
+        embed_subtitle_if_available(output_path)
+        success("Recording saved to #{output_path}")
+        true
+      end
+
+      def write_audio_output(audio_path)
+        output_path = File.join(@rec_dir, "#{@recording_stem}.m4a")
+        info('Remuxing audio track...')
+        remuxed = run_ffmpeg('-i', audio_path, '-c', 'copy', output_path)
+        return error('ffmpeg audio remux failed') && false unless remuxed
+
+        success("Audio saved to #{output_path}")
+        true
+      end
+
+      def embed_subtitle_if_available(video_path)
+        vtt_path = paired_vtt_path(video_path)
+        return unless vtt_path
+
+        info('Embedding transcript as subtitle track...')
+        final_path = video_path.sub('.mp4', '_subs.mp4')
+        return unless run_ffmpeg('-i', video_path, '-i', vtt_path, '-c', 'copy', '-c:s', 'mov_text', final_path)
+
+        FileUtils.mv(final_path, video_path)
+      end
+
+      def paired_vtt_path(video_path)
+        paired = video_path.sub(/\.mp4\z/, '.vtt')
+        return paired if File.exist?(paired)
+
+        Dir.glob(File.join(File.dirname(video_path), '*.vtt')).first
+      end
+    end
+
     # Downloads meeting recordings via DASH streaming from SharePoint
     module MeetingRecording
+      include MeetingFilename
       include RecordingResolver
       include SegmentDownloader
+      include RecordingOutputWriter
 
       MANIFEST_PARAMS = 'format=dash&part=index'
 
       private
 
-      def download_recording(target, classified)
+      def download_recording(target, classified, media: { video: true, audio: false })
         sharing_url = target[:fileUrl] || classified[:recordings].filter_map { |rec| rec[:url] }.first
         return error('No recordings found for this meeting') unless sharing_url
         return error('ffmpeg is required. Install with: brew install ffmpeg') unless ffmpeg?
 
-        execute_recording_pipeline(sharing_url)
+        execute_recording_pipeline(sharing_url, media)
       end
 
-      def execute_recording_pipeline(sharing_url)
-        info('Fetching recording via SharePoint...')
+      def execute_recording_pipeline(sharing_url, media)
+        info("Fetching #{media[:video] ? 'recording' : 'audio'} via SharePoint...")
         file_info = resolve_recording_file_info(sharing_url)
         return 1 unless file_info
 
+        @recording_stem = derive_output_stem(file_info[:name])
         manifest = fetch_dash_manifest(file_info[:transform_url])
         return error('Could not fetch DASH manifest') unless manifest
 
-        download_and_assemble(manifest)
+        download_and_assemble(manifest, media)
       end
 
       def fetch_dash_manifest(transform_url)
@@ -227,29 +281,33 @@ module Teems
         nil
       end
 
-      def download_and_assemble(manifest_xml)
+      def download_and_assemble(manifest_xml, media)
         tracks = DashManifestParser.new(manifest_xml).parse
-        selected = select_tracks(tracks)
+        selected = select_tracks(tracks, media)
         return error('No video/audio tracks found in manifest') unless selected
 
-        assemble_recording(selected, manifest_xml)
+        assemble_recording(selected, manifest_xml, media)
       end
 
-      def select_tracks(tracks)
+      def select_tracks(tracks, media)
         grouped = tracks.group_by(&:type)
-        video = grouped['video']&.first
         audio = grouped['audio']&.first
-        video && audio ? { video: video, audio: audio } : nil
+        return nil unless audio
+
+        video = grouped['video']&.first
+        return nil if media[:video] && !video
+
+        { video: video, audio: audio }
       end
 
-      def assemble_recording(selected, manifest_xml)
+      def assemble_recording(selected, manifest_xml, media)
         @rec_dir = @options[:output_dir] || '.'
         FileUtils.mkdir_p(@rec_dir)
         @rec_base_url = manifest_xml.match(%r{<BaseURL>([^<]+)</BaseURL>})&.then { _1[1] } || ''
 
-        video_path = write_track(selected[:video], 'video')
         audio_path = write_track(selected[:audio], 'audio')
-        merge_and_finalize(video_path, audio_path, @rec_dir)
+        video_path = media[:video] ? write_track(selected[:video], 'video') : nil
+        produce_outputs(video_path, audio_path, media)
       end
 
       def write_track(track, label)
@@ -261,29 +319,6 @@ module Teems
         path
       end
 
-      def merge_and_finalize(video_path, audio_path, dir)
-        output_path = File.join(dir, 'recording.mp4')
-        info('Merging video and audio tracks...')
-        merged = run_ffmpeg('-i', video_path, '-i', audio_path, '-c', 'copy', output_path)
-        FileUtils.rm_f([video_path, audio_path])
-
-        return error('ffmpeg merge failed') unless merged
-
-        embed_subtitle_if_available(output_path)
-        success("Recording saved to #{output_path}")
-      end
-
-      def embed_subtitle_if_available(video_path)
-        vtt_path = Dir.glob(File.join(File.dirname(video_path), '*.vtt')).first
-        return unless vtt_path
-
-        info('Embedding transcript as subtitle track...')
-        final_path = video_path.sub('.mp4', '_subs.mp4')
-        return unless run_ffmpeg('-i', video_path, '-i', vtt_path, '-c', 'copy', '-c:s', 'mov_text', final_path)
-
-        FileUtils.mv(final_path, video_path)
-      end
-
       def run_ffmpeg(*)
         system('ffmpeg', '-y', *, out: File::NULL, err: File::NULL)
       end

data/lib/teems/commands/meeting_transcript.rb

@@ -2,6 +2,34 @@
 
 module Teems
   module Commands
+    # Derives a human-friendly output filename stem from a SharePoint recording/transcript name.
+    # SharePoint format is typically "<subject>-YYYYMMDD_HHMMSS[-Meeting Recording].<ext>"
+    # which we reshape into "YYYY-MM-DD - <subject>".
+    module MeetingFilename
+      SHAREPOINT_NAME_RE = /\A(.+)-(\d{4})(\d{2})(\d{2})_\d{6}\z/
+      UNSAFE_FILENAME_CHARS = %r{[/\\:*?"<>|\x00]}
+
+      private
+
+      def derive_output_stem(sharepoint_name)
+        base = File.basename(sharepoint_name.to_s, '.*').sub(/-Meeting Recording\z/, '')
+        sanitize_filename(reshape_sharepoint_name(base))
+      end
+
+      def reshape_sharepoint_name(base)
+        captures = base.match(SHAREPOINT_NAME_RE)&.captures
+        return base unless captures
+
+        subject, year, month, day = captures
+        "#{year}-#{month}-#{day} - #{subject}"
+      end
+
+      def sanitize_filename(name)
+        cleaned = name.gsub(UNSAFE_FILENAME_CHARS, '_').strip
+        cleaned.empty? ? 'recording' : cleaned
+      end
+    end
+
     # Parses SharePoint embed page HTML to extract file metadata
     module EmbedPageParser
       SP_ITEM_RE = %r{(https://[^/]+(?::\d+)?/.+?)/_api/v2\.\d+/drives/([^/]+)/items/([^/?]+)}
@@ -113,6 +141,7 @@ module Teems
     # Downloads meeting transcripts via SharePoint API (no Safari required)
     module MeetingTranscript
       include EmbedPageParser
+      include MeetingFilename
 
       private
 
@@ -196,11 +225,11 @@ module Teems
         url ? { url: url, name: File.basename(entry['name'] || 'transcript.vtt') } : nil
       end
 
+      # Prefers the recording's name (via @transcript_info) so transcript and recording share a stem.
       def save_transcript(transcript)
         dir = @options[:output_dir] || '.'
         FileUtils.mkdir_p(dir)
-        path = File.join(dir, File.basename(transcript[:name]))
-
+        path = File.join(dir, "#{derive_output_stem(@transcript_info[:name] || transcript[:name])}.vtt")
         info("Downloading transcript to #{path}...")
         vtt = fetch_and_convert_transcript(transcript[:url])
         return error('Failed to download transcript content') unless vtt

data/lib/teems/commands/ooo.rb

@@ -15,9 +15,14 @@ module Teems
 
       ON OPTIONS:
         --message TEXT       Auto-reply and status message
-        --start DATE         Schedule start (YYYY-MM-DD), enables scheduled mode
-        --end DATE           Schedule end (YYYY-MM-DD), required with --start
-        --event              Create an all-day OOO calendar event for notify list
+        --start TIME         Schedule start; enables scheduled mode. Formats:
+                               YYYY-MM-DD              (all-day)
+                               YYYY-MM-DD HH:MM        (timed)
+                               "today HH:MM", "tomorrow HH:MM", HH:MM
+        --end TIME           Schedule end, required with --start.
+                             Must match --start style (date or timed).
+        --event              Create an OOO calendar event for notify list
+        --invite EMAILS      Comma-separated invitees; overrides config notify list
         --no-status          Skip setting Teams status/presence
 
       CONFIGURATION:
@@ -38,10 +43,43 @@ module Teems
         teems ooo on                       # Enable OOO (always on)
         teems ooo on --message "Vacation"  # Custom message
         teems ooo on --start 2026-04-14 --end 2026-04-18
+        teems ooo on --start "today 14:00" --end "today 17:00" \\
+          --message "Dr appt"
         teems ooo off                      # Disable OOO
         teems ooo config                   # Show config
     HELP
 
+    # A parsed --start or --end value. Produces ISO datetime strings for
+    # auto-reply schedules and calendar events. Kind is :timed, :date, or
+    # :unscheduled; value is a Time, Date, or nil respectively.
+    OooScheduleEntry = Data.define(:kind, :value) do
+      def timed? = kind == :timed
+      def all_day? = kind == :date
+      def unscheduled? = kind == :unscheduled
+
+      def reply_start_iso
+        timed? ? value.strftime('%Y-%m-%dT%H:%M:%S') : "#{value}T00:00:00"
+      end
+
+      def reply_end_iso
+        timed? ? value.strftime('%Y-%m-%dT%H:%M:%S') : "#{value}T23:59:59"
+      end
+
+      def event_start_iso
+        base = value || Date.today
+        timed? ? base.strftime('%Y-%m-%dT%H:%M:%S') : "#{base}T00:00:00"
+      end
+
+      def event_end_iso
+        base = value || Date.today
+        return base.strftime('%Y-%m-%dT%H:%M:%S') if timed?
+
+        "#{base + 1}T00:00:00"
+      end
+    end
+
+    UNSCHEDULED_OOO_SCHEDULE = OooScheduleEntry.new(kind: :unscheduled, value: nil)
+
     # Displays current OOO status (auto-reply + presence)
     module OooDisplay
       private
@@ -90,13 +128,20 @@ module Teems
       end
 
       def render_schedule(replies)
-        start_dt = replies.dig('scheduledStartDateTime', 'dateTime')
-        end_dt = replies.dig('scheduledEndDateTime', 'dateTime')
-        puts "  Schedule: #{format_dt(start_dt)} to #{format_dt(end_dt)}" if start_dt
+        start_entry = replies['scheduledStartDateTime']
+        return unless start_entry
+
+        start_str = format_schedule_dt(start_entry)
+        end_str = format_schedule_dt(replies['scheduledEndDateTime'])
+        puts "  Schedule: #{start_str} to #{end_str} #{short_tz_label}"
       end
 
-      def format_dt(raw)
-        Time.parse(raw).strftime('%Y-%m-%d %H:%M')
+      def format_schedule_dt(entry)
+        return '' unless entry
+
+        raw = entry['dateTime']
+        time = entry['timeZone'] == 'UTC' ? Time.parse("#{raw} UTC").getlocal : Time.parse(raw)
+        time.strftime('%Y-%m-%d %H:%M')
       rescue ArgumentError
         raw.to_s
       end
@@ -118,6 +163,60 @@ module Teems
       end
     end
 
+    # Parses and validates --start/--end into @schedule_start and @schedule_end.
+    # Each parsed value is a tuple: [:date, Date] for all-day or [:timed, Time] for timed.
+    module OooSchedule
+      private
+
+      def validate_create_options
+        start_raw = @options[:start]
+        end_raw = @options[:end]
+        return unless start_raw
+        return missing_end_error unless end_raw
+
+        parse_schedule_pair(start_raw, end_raw)
+      end
+
+      def missing_end_error
+        error('--end is required when using --start')
+        1
+      end
+
+      def parse_schedule_pair(start_raw, end_raw)
+        @schedule_start = parse_schedule_value(start_raw)
+        return invalid_schedule_error(:start, start_raw) unless @schedule_start
+
+        @schedule_end = parse_schedule_value(end_raw)
+        return invalid_schedule_error(:end, end_raw) unless @schedule_end
+
+        return mixed_schedule_error if schedule_kind(@schedule_start) != schedule_kind(@schedule_end)
+
+        nil
+      end
+
+      def parse_schedule_value(raw)
+        time = parse_time_input(raw)
+        return OooScheduleEntry.new(kind: :timed, value: time) if time
+
+        OooScheduleEntry.new(kind: :date, value: Date.parse(raw))
+      rescue Date::Error
+        nil
+      end
+
+      def invalid_schedule_error(key, raw)
+        error("Invalid value for --#{key}: #{raw}. " \
+              "Use YYYY-MM-DD, HH:MM, 'today HH:MM', 'tomorrow HH:MM', or 'YYYY-MM-DD HH:MM'")
+        1
+      end
+
+      def mixed_schedule_error
+        error('--start and --end must both be dates or both include a time')
+        1
+      end
+
+      def schedule_kind(parsed) = parsed.kind
+    end
+
     # Enables/disables OOO: auto-reply, status message, presence, calendar event
     module OooActions
       private
@@ -139,28 +238,6 @@ module Teems
         results.values.all? ? 0 : 1
       end
 
-      def validate_create_options
-        validate_schedule_dates || validate_date_format(:start) || validate_date_format(:end)
-      end
-
-      def validate_schedule_dates
-        return unless @options[:start] && !@options[:end]
-
-        error('--end is required when using --start')
-        1
-      end
-
-      def validate_date_format(key)
-        value = @options[key]
-        return unless value
-
-        Date.parse(value)
-        nil
-      rescue ArgumentError
-        error("Invalid date for --#{key}: #{value}. Expected format: YYYY-MM-DD")
-        1
-      end
-
       def execute_ooo_steps
         results = {}
         results[:auto_reply] = set_auto_reply
@@ -261,37 +338,29 @@ module Teems
       end
 
       def add_schedule(settings)
-        tz = detect_timezone
-        settings[:scheduledStartDateTime] = { dateTime: "#{@options[:start]}T00:00:00", timeZone: tz }
-        settings[:scheduledEndDateTime] = { dateTime: "#{@options[:end]}T23:59:59", timeZone: tz }
+        timezone = detect_timezone
+        settings[:scheduledStartDateTime] = { dateTime: @schedule_start.reply_start_iso, timeZone: timezone }
+        settings[:scheduledEndDateTime] = { dateTime: @schedule_end.reply_end_iso, timeZone: timezone }
       end
 
       def build_ooo_event
+        timezone = detect_timezone
         { subject: status_message_text,
-          start: ooo_event_time(:start),
-          end: ooo_event_time(:end),
-          isAllDay: true,
-          showAs: 'free',
-          isReminderOn: false,
-          isOnlineMeeting: false,
+          start: { dateTime: @schedule_start.event_start_iso, timeZone: timezone },
+          end: { dateTime: @schedule_end.event_end_iso, timeZone: timezone },
+          isAllDay: !@schedule_start.timed?, showAs: 'free',
+          isReminderOn: false, isOnlineMeeting: false,
           transactionId: SecureRandom.uuid,
           attendees: notify_list.map { |email| ooo_attendee(email) },
           responseRequested: false }
       end
 
-      def ooo_event_time(field)
-        date = @options[field] || Date.today.to_s
-        end_date = field == :end ? (Date.parse(date) + 1).to_s : date
-        tz = detect_timezone
-        { dateTime: "#{end_date}T00:00:00", timeZone: tz }
-      end
-
       def ooo_attendee(email)
         { emailAddress: { address: email }, type: 'required' }
       end
 
       def notify_list
-        @notify_list ||= ooo_config('notify') || []
+        @notify_list ||= @options[:invite] || ooo_config('notify') || []
       end
 
       def ooo_config(key)
@@ -302,20 +371,27 @@ module Teems
     # Manage out-of-office: auto-reply, status, presence, and calendar event
     class Ooo < Base
       include Support::Timezone
+      include Support::TimeParsing
       include OooDisplay
+      include OooSchedule
       include OooActions
       include OooBuildHelpers
 
       def initialize(args, runner:)
         @options = {}
+        @schedule_start = UNSCHEDULED_OOO_SCHEDULE
+        @schedule_end = UNSCHEDULED_OOO_SCHEDULE
         super
       end
 
+      SPLIT_OOO_EMAILS = ->(raw) { raw ? raw.split(',').map(&:strip).reject(&:empty?) : [] }
+
       OOO_OPTIONS = {
         '--message' => ->(opts, args) { opts[:message] = args.shift },
         '--start' => ->(opts, args) { opts[:start] = args.shift },
         '--end' => ->(opts, args) { opts[:end] = args.shift },
         '--event' => ->(opts, _args) { opts[:event] = true },
+        '--invite' => ->(opts, args) { opts[:invite] = SPLIT_OOO_EMAILS.call(args.shift) },
         '--no-status' => ->(opts, _args) { opts[:no_status] = true }
       }.freeze
 

data/lib/teems/support/time_parsing.rb

@@ -0,0 +1,55 @@
+# frozen_string_literal: true
+
+module Teems
+  module Support
+    # Shared time-input parsing for commands that accept schedule inputs
+    # like "HH:MM", "today HH:MM", "tomorrow HH:MM", and "YYYY-MM-DD HH:MM".
+    module TimeParsing
+      private
+
+      def parse_time_input(raw)
+        date, time_str = split_time_input(raw)
+        return unless time_str
+
+        date.is_a?(String) ? parse_absolute_time(date, time_str) : parse_relative_time(date, time_str)
+      end
+
+      def split_time_input(raw)
+        base = Date.today
+        split_tomorrow_time(raw, base) || split_today_time(raw, base) || split_absolute_time(raw)
+      end
+
+      def split_tomorrow_time(raw, base)
+        return unless raw.start_with?('tomorrow ')
+
+        [base + 1, raw.delete_prefix('tomorrow ')]
+      end
+
+      def split_today_time(raw, base)
+        return unless raw.match?(/\A(?:today\s+)?\d{1,2}:\d{2}\z/)
+
+        [base, raw.delete_prefix('today ')]
+      end
+
+      def split_absolute_time(raw)
+        return unless raw.match?(/\A\d{4}-\d{2}-\d{2}\s+\d{1,2}:\d{2}\z/)
+
+        raw.split(/\s+/, 2)
+      end
+
+      def parse_relative_time(date, time_str)
+        hour, min = time_str.split(':').map(&:to_i)
+        Time.new(date.year, date.month, date.day, hour, min, 0)
+      rescue ArgumentError
+        nil
+      end
+
+      def parse_absolute_time(date_str, time_str)
+        date = Date.parse(date_str)
+        parse_relative_time(date, time_str)
+      rescue Date::Error
+        nil
+      end
+    end
+  end
+end

data/lib/teems/version.rb

@@ -1,5 +1,5 @@
 # frozen_string_literal: true
 
 module Teems
-  VERSION = '0.2.0'
+  VERSION = '0.3.0'
 end

data/lib/teems.rb

@@ -116,5 +116,6 @@ module Teems
     autoload :HelpFormatter, 'teems/support/help_formatter'
     autoload :ErrorLogger, 'teems/support/error_logger'
     autoload :Timezone, 'teems/support/timezone'
+    autoload :TimeParsing, 'teems/support/time_parsing'
   end
 end

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: teems
 version: !ruby/object:Gem::Version
-  version: 0.2.0
+  version: 0.3.0
 platform: ruby
 authors:
 - Eric Boehs
@@ -83,6 +83,7 @@ files:
 - lib/teems/services/token_store.rb
 - lib/teems/support/error_logger.rb
 - lib/teems/support/help_formatter.rb
+- lib/teems/support/time_parsing.rb
 - lib/teems/support/timezone.rb
 - lib/teems/support/xdg_paths.rb
 - lib/teems/version.rb
@@ -109,7 +110,7 @@ required_rubygems_version: !ruby/object:Gem::Requirement
     - !ruby/object:Gem::Version
       version: '0'
 requirements: []
-rubygems_version: 3.6.9
+rubygems_version: 4.0.10
 specification_version: 4
 summary: A command-line interface for Microsoft Teams
 test_files: []