qtimetrap 0.1.1

data/app/services/timetrap_gateway_start_helpers.rb

@@ -0,0 +1,28 @@
+# frozen_string_literal: true
+
+module QTimetrap
+  module Services
+    # Shared start workflow for Timetrap API/CLI adapters.
+    module TimetrapGatewayStartHelpers
+      private
+
+      def normalize_start_inputs(sheet, checkin_note)
+        [normalize_text(sheet).strip, normalize_text(checkin_note).strip]
+      end
+
+      def start_via_api(sheet, checkin_note)
+        Timetrap::Timer.current_sheet = sheet
+        Timetrap::Timer.start(checkin_note)
+      end
+
+      def start_via_cli(sheet, checkin_note)
+        sheet_ok, = run('sheet', sheet)
+        return unless sheet_ok
+
+        return run('in') if checkin_note.empty?
+
+        run('in', checkin_note)
+      end
+    end
+  end
+end

data/app/services/timetrap_gateway_update_note_helpers.rb

@@ -0,0 +1,48 @@
+# frozen_string_literal: true
+
+module QTimetrap
+  module Services
+    # Note update workflow for Timetrap API/CLI adapters.
+    module TimetrapGatewayUpdateNoteHelpers
+      def update_note(entry_id, note)
+        normalized_id = entry_id.to_i
+        normalized_note = normalize_text(note).strip
+        return if normalized_id.zero?
+
+        if api_available?
+          logger.log_api(
+            operation: 'update_note',
+            input: { entry_id: normalized_id, note: normalized_note },
+            output: 'requested'
+          )
+          result = update_note_via_api(normalized_id, normalized_note)
+          logger.log_api(operation: 'update_note', input: {}, output: result.to_s)
+          return result
+        end
+
+        update_note_via_cli(normalized_id, normalized_note)
+      end
+
+      private
+
+      def update_note_via_api(entry_id, note)
+        entry = resolve_entry_for_note_update(Timetrap::Entry[entry_id])
+        entry.note = note
+        entry.save
+      end
+
+      def update_note_via_cli(entry_id, note)
+        return run('edit', '--id', entry_id.to_s, '--clear') if note.empty?
+
+        run('edit', '--id', entry_id.to_s, note)
+      end
+
+      def resolve_entry_for_note_update(value)
+        entry = value
+        raise TypeError, "Unsupported entry lookup result: #{value.class}" unless entry
+
+        entry
+      end
+    end
+  end
+end

data/app/services/timetrap_gateway_update_task_helpers.rb

@@ -0,0 +1,47 @@
+# frozen_string_literal: true
+
+module QTimetrap
+  module Services
+    # Task/sheet move workflow for Timetrap API/CLI adapters.
+    module TimetrapGatewayUpdateTaskHelpers
+      def update_task(entry_id, sheet)
+        normalized_id = entry_id.to_i
+        normalized_sheet = normalize_text(sheet).strip
+        return if normalized_id.zero?
+
+        validate_target_sheet!(normalized_sheet)
+        return update_task_via_api_logged(normalized_id, normalized_sheet) if api_available?
+
+        update_task_via_cli(normalized_id, normalized_sheet)
+      end
+
+      private
+
+      def validate_target_sheet!(sheet)
+        raise ArgumentError, 'Sheet is required' if sheet.empty?
+      end
+
+      def update_task_via_api_logged(entry_id, sheet)
+        logger.log_api(
+          operation: 'update_task',
+          input: { entry_id: entry_id, sheet: sheet },
+          output: 'requested'
+        )
+        result = update_task_via_api(entry_id, sheet)
+        logger.log_api(operation: 'update_task', input: {}, output: result.to_s)
+        result
+      end
+
+      def update_task_via_api(entry_id, sheet)
+        entry = resolve_entry_for_note_update(Timetrap::Entry[entry_id])
+        active_entry = Timetrap::Timer.active_entry
+        Timetrap::Timer.current_sheet = sheet if active_entry&.id.to_i == entry.id.to_i
+        entry.update(sheet: sheet)
+      end
+
+      def update_task_via_cli(entry_id, sheet)
+        run('edit', '--id', entry_id.to_s, '--move', sheet)
+      end
+    end
+  end
+end

data/app/services/timetrap_gateway_update_time_helpers.rb

@@ -0,0 +1,50 @@
+# frozen_string_literal: true
+
+module QTimetrap
+  module Services
+    # Time bounds update workflow for Timetrap API/CLI adapters.
+    module TimetrapGatewayUpdateTimeHelpers
+      def update_time(entry_id, start_time:, end_time:)
+        normalized_id = entry_id.to_i
+        return if normalized_id.zero?
+
+        if api_available?
+          logger.log_api(
+            operation: 'update_time',
+            input: {
+              entry_id: normalized_id,
+              start_time: start_time&.iso8601,
+              end_time: end_time&.iso8601
+            },
+            output: 'requested'
+          )
+          result = update_time_via_api(normalized_id, start_time: start_time, end_time: end_time)
+          logger.log_api(operation: 'update_time', input: {}, output: result.to_s)
+          return result
+        end
+
+        update_time_via_cli(normalized_id, start_time: start_time, end_time: end_time)
+      end
+
+      private
+
+      def update_time_via_api(entry_id, start_time:, end_time:)
+        entry = resolve_entry_for_note_update(Timetrap::Entry[entry_id])
+        entry.start = start_time if start_time
+        entry.end = end_time if end_time
+        entry.save
+      end
+
+      def update_time_via_cli(entry_id, start_time:, end_time:)
+        args = ['edit', '--id', entry_id.to_s]
+        args += ['--start', format_cli_timestamp(start_time)] if start_time
+        args += ['--end', format_cli_timestamp(end_time)] if end_time
+        run(*args)
+      end
+
+      def format_cli_timestamp(time)
+        time.strftime('%Y-%m-%d %H:%M:%S %z')
+      end
+    end
+  end
+end

data/app/styles/theme.rb

@@ -0,0 +1,61 @@
+# frozen_string_literal: true
+
+module QTimetrap
+  module Styles
+    # Loads and composes QSS theme assets for the application.
+    class Theme
+      FILES = %w[application project_sidebar tracker_controls entries_list].freeze
+      DEFAULT = 'light'
+      SUPPORTED = %w[light dark].freeze
+
+      def initialize(name:, root:)
+        @name = normalize_name(name)
+        @root = root
+        @cache = {}
+      end
+
+      attr_reader :name, :root
+
+      def application_stylesheet
+        FILES.map { |file| stylesheet(file) }.join("\n")
+      end
+
+      def with_name(next_name)
+        self.class.new(name: next_name, root: root)
+      end
+
+      def snippet(snippet_name)
+        File.read(path_for_snippet(snippet_name))
+      end
+
+      def stylesheet(file_name)
+        cache.fetch(file_name) do
+          cache[file_name] = File.read(path_for(file_name))
+        end
+      end
+
+      private
+
+      attr_reader :cache
+
+      def path_for(file_name)
+        path = File.join(root, 'app', 'styles', 'themes', name, "#{file_name}.qss")
+        return path if File.exist?(path)
+
+        File.join(root, 'app', 'styles', 'themes', DEFAULT, "#{file_name}.qss")
+      end
+
+      def path_for_snippet(snippet_name)
+        path = File.join(root, 'app', 'styles', 'themes', name, 'snippets', "#{snippet_name}.qss")
+        return path if File.exist?(path)
+
+        File.join(root, 'app', 'styles', 'themes', DEFAULT, 'snippets', "#{snippet_name}.qss")
+      end
+
+      def normalize_name(value)
+        candidate = value.to_s.strip.downcase
+        SUPPORTED.include?(candidate) ? candidate : DEFAULT
+      end
+    end
+  end
+end

data/app/styles/themes/dark/application.qss

@@ -0,0 +1,8 @@
+QWidget#main_window {
+  background-color: #0f172a;
+}
+
+QLabel#app_background {
+  background-color: #0b1220;
+  border: 1px solid #243244;
+}

data/app/styles/themes/dark/entries_list.qss

@@ -0,0 +1,235 @@
+QScrollArea#entries_scroll {
+  background-color: #111827;
+  border: 1px solid #2b3b4f;
+  border-radius: 10px;
+}
+
+QScrollArea#entries_scroll QScrollBar:vertical {
+  background: #0f172a;
+  width: 12px;
+  margin: 2px;
+  border: 1px solid #334155;
+  border-radius: 6px;
+}
+
+QScrollArea#entries_scroll QScrollBar::handle:vertical {
+  background: #475569;
+  min-height: 28px;
+  border-radius: 5px;
+}
+
+QWidget#entries_host {
+  background-color: #0f172a;
+  border: 0px;
+}
+
+QWidget#entries_toolbar {
+  background-color: #0f172a;
+  border: 0px;
+}
+
+QPushButton#entries_expand_all,
+QPushButton#entries_collapse_all {
+  background-color: #111827;
+  border: 1px solid #334155;
+  border-radius: 8px;
+  color: #cbd5e1;
+  font-size: 12px;
+  font-weight: 700;
+}
+
+QCheckBox#entries_time_filter_from_toggle,
+QCheckBox#entries_time_filter_to_toggle {
+  background-color: #111827;
+  border: 1px solid #334155;
+  border-radius: 8px;
+  color: #cbd5e1;
+  font-size: 12px;
+  font-weight: 700;
+}
+
+QCheckBox#entries_time_filter_from_toggle:checked,
+QCheckBox#entries_time_filter_to_toggle:checked {
+  background-color: #1e3a8a;
+  border: 1px solid #2563eb;
+}
+
+QDateTimeEdit#entries_time_filter_from,
+QDateTimeEdit#entries_time_filter_to {
+  background-color: #111827;
+  border: 1px solid #334155;
+  border-radius: 8px;
+  color: #cbd5e1;
+  font-size: 12px;
+  padding-left: 4px;
+}
+
+QPushButton#entry_node_week {
+  background-color: #21346A;
+  border: 1px solid #101A39;
+  border-radius: 8px;
+  color: #dbeafe;
+  font-size: 15px;
+  font-weight: 800;
+  text-align: left;
+  padding-left: 8px;
+}
+
+QPushButton#entry_node_week:hover {
+  background-color: #1e40af;
+}
+
+QPushButton#entry_node_week:pressed {
+  background-color: #1e3a8a;
+}
+
+QPushButton#entry_node_week:focus {
+  border: 2px solid #7dd3fc;
+}
+
+QPushButton#entry_node_day {
+  background-color: #1f2937;
+  border: 1px solid #334155;
+  border-radius: 8px;
+  color: #cbd5e1;
+  font-size: 14px;
+  font-weight: 700;
+  text-align: left;
+  padding-left: 8px;
+}
+
+QPushButton#entry_node_day:hover {
+  background-color: #243244;
+}
+
+QPushButton#entry_node_day:pressed {
+  background-color: #1e293b;
+}
+
+QPushButton#entry_node_day:focus {
+  border: 2px solid #7dd3fc;
+}
+
+QPushButton#entry_node_project {
+  background-color: #111827;
+  border: 1px solid #334155;
+  border-radius: 8px;
+  color: #e2e8f0;
+  font-size: 13px;
+  font-weight: 700;
+  text-align: left;
+  padding-left: 8px;
+}
+
+QPushButton#entry_node_project:hover {
+  background-color: #0b1220;
+}
+
+QPushButton#entry_node_project:pressed {
+  background-color: #020617;
+}
+
+QPushButton#entry_node_project:focus {
+  border: 2px solid #38bdf8;
+}
+
+QWidget#entry_node_entry_row {
+  background-color: #0b1220;
+  border: 1px solid #243244;
+  border-radius: 8px;
+}
+
+QLabel#entry_node_entry_prefix {
+  color: #94a3b8;
+  font-size: 12px;
+}
+
+QLabel#entry_node_entry_time_sep {
+  color: #94a3b8;
+  font-size: 12px;
+}
+
+QLineEdit#entry_node_entry_start,
+QLineEdit#entry_node_entry_end {
+  color: #94a3b8;
+  font-size: 12px;
+  background: transparent;
+  border: 0px;
+}
+
+QLineEdit#entry_node_entry_start:read-only,
+QLineEdit#entry_node_entry_end:read-only {
+  background: transparent;
+  border: 0px;
+}
+
+QLineEdit#entry_node_entry_start:focus,
+QLineEdit#entry_node_entry_end:focus {
+  background-color: #111827;
+  border: 1px solid #334155;
+  border-radius: 6px;
+}
+
+QLineEdit#entry_node_entry_note {
+  color: #94a3b8;
+  font-size: 12px;
+  background: transparent;
+  border: 0px;
+  padding-left: 2px;
+}
+
+QLineEdit#entry_node_entry_note:read-only {
+  background: transparent;
+  border: 0px;
+}
+
+QLineEdit#entry_node_entry_note:focus {
+  background-color: #111827;
+  border: 1px solid #334155;
+  border-radius: 6px;
+  padding-left: 6px;
+}
+
+QComboBox#entry_node_entry_task {
+  color: #94a3b8;
+  font-size: 12px;
+  background: transparent;
+  border: 0px;
+  padding-left: 2px;
+}
+
+QComboBox#entry_node_entry_task:focus {
+  background-color: #111827;
+  border: 1px solid #334155;
+  border-radius: 6px;
+}
+
+QComboBox#entry_node_entry_task QAbstractItemView {
+  background-color: #111827;
+  color: #e2e8f0;
+  border: 1px solid #334155;
+  selection-background-color: #1d4ed8;
+  selection-color: #f8fafc;
+}
+
+QPushButton#entry_node_entry_archive {
+  background-color: #111827;
+  border: 1px solid #334155;
+  border-radius: 6px;
+  color: #94a3b8;
+  font-size: 12px;
+  font-weight: 700;
+}
+
+QPushButton#entry_node_entry_archive:hover {
+  background-color: #0b1220;
+}
+
+QLabel#entry_node_empty {
+  background-color: #0f172a;
+  border: 1px solid #243244;
+  border-radius: 8px;
+  color: #94a3b8;
+  font-size: 12px;
+  padding-left: 8px;
+}

data/app/styles/themes/dark/project_sidebar.qss

@@ -0,0 +1,99 @@
+QWidget#sidebar_panel {
+  background-color: #111827;
+  border-right: 1px solid #2b3b4f;
+  border-top-right-radius: 10px;
+  border-bottom-right-radius: 10px;
+}
+
+QWidget#sidebar_logo {
+  background-color: transparent;
+}
+
+QLabel#sidebar_logo_text {
+  color: #e5e7eb;
+  font-size: 18px;
+  font-weight: 800;
+}
+
+QLabel#sidebar_heading {
+  color: #9ca3af;
+  font-size: 12px;
+}
+
+QLabel#sidebar_tasks_heading {
+  color: #94a3b8;
+  font-size: 11px;
+  margin-top: 8px;
+}
+
+QPushButton#project_button {
+  background-color: #0f172a;
+  border: 1px solid #334155;
+  border-radius: 8px;
+  color: #cbd5e1;
+  font-size: 12px;
+  font-weight: 700;
+  text-align: left;
+  padding-left: 10px;
+}
+
+QPushButton#project_button:checked {
+  background-color: #1e293b;
+  border: 2px solid #38bdf8;
+  color: #f8fafc;
+  font-weight: 800;
+}
+
+QPushButton#project_button:disabled {
+  color: #64748b;
+}
+
+QPushButton#task_button {
+  background-color: #111827;
+  border: 1px solid #334155;
+  border-radius: 8px;
+  color: #cbd5e1;
+  font-size: 11px;
+  text-align: left;
+  padding-left: 10px;
+}
+
+QPushButton#task_button:checked {
+  background-color: #1f2937;
+  border: 2px solid #38bdf8;
+  color: #f8fafc;
+}
+
+QPushButton#sidebar_toggle_button {
+  background-color: #0f172a;
+  border: 1px solid #334155;
+  border-radius: 8px;
+  color: #93c5fd;
+  font-size: 13px;
+  font-weight: 700;
+}
+
+QPushButton#sidebar_toggle_button:hover {
+  background-color: #111827;
+  border: 1px solid #38bdf8;
+}
+
+QPushButton#sidebar_archive_toggle {
+  background-color: #0b1220;
+  border: 1px solid #334155;
+  border-radius: 8px;
+  color: #94a3b8;
+  font-size: 16px;
+  font-weight: 700;
+}
+
+QPushButton#sidebar_archive_toggle:hover {
+  border: 1px solid #f59e0b;
+  color: #fbbf24;
+}
+
+QPushButton#sidebar_archive_toggle:checked {
+  background-color: #3b2f14;
+  border: 2px solid #f59e0b;
+  color: #fde68a;
+}

data/app/styles/themes/dark/snippets/app_background.qss

@@ -0,0 +1,2 @@
+background-color: #0b1220;
+border: 1px solid #243244;

data/app/styles/themes/dark/snippets/button_ghost.qss

@@ -0,0 +1,5 @@
+background-color: #111827;
+border: 1px solid #334155;
+color: #cbd5e1;
+font-size: 13px;
+font-weight: 700;

data/app/styles/themes/dark/snippets/button_start.qss

@@ -0,0 +1,5 @@
+background-color: #0ea5e9;
+border: 1px solid #0284c7;
+color: #ffffff;
+font-size: 14px;
+font-weight: 800;

data/app/styles/themes/dark/snippets/button_stop.qss

@@ -0,0 +1,5 @@
+background-color: #ef4444;
+border: 1px solid #dc2626;
+color: #ffffff;
+font-size: 14px;
+font-weight: 800;

data/app/styles/themes/dark/snippets/entries_host.qss

@@ -0,0 +1,2 @@
+background-color: #0f172a;
+border: 0px;

data/app/styles/themes/dark/snippets/entries_scroll.qss

@@ -0,0 +1,16 @@
+QScrollArea {
+  background-color: #111827;
+  border: 1px solid #2b3b4f;
+}
+QScrollBar:vertical {
+  background: #0f172a;
+  width: 12px;
+  margin: 2px;
+  border: 1px solid #334155;
+  border-radius: 6px;
+}
+QScrollBar::handle:vertical {
+  background: #475569;
+  min-height: 28px;
+  border-radius: 5px;
+}

data/app/styles/themes/dark/snippets/entry_row_day.qss

@@ -0,0 +1,6 @@
+background-color: #1f2937;
+border: 1px solid #334155;
+color: #cbd5e1;
+font-size: 13px;
+font-weight: 700;
+padding-left: 12px;

data/app/styles/themes/dark/snippets/entry_row_detail.qss

@@ -0,0 +1,5 @@
+background-color: #0b1220;
+border: 1px solid #243244;
+color: #94a3b8;
+font-size: 12px;
+padding-left: 24px;

data/app/styles/themes/dark/snippets/entry_row_project.qss

@@ -0,0 +1,6 @@
+background-color: #111827;
+border: 1px solid #334155;
+color: #e2e8f0;
+font-size: 14px;
+font-weight: 700;
+padding-left: 12px;

data/app/styles/themes/dark/snippets/project_button.qss

@@ -0,0 +1,5 @@
+background-color: #0f172a;
+border: 1px solid #334155;
+color: #cbd5e1;
+font-size: 12px;
+font-weight: 700;

data/app/styles/themes/dark/snippets/project_button_active.qss

@@ -0,0 +1,5 @@
+background-color: #1e293b;
+border: 2px solid #38bdf8;
+color: #f8fafc;
+font-size: 12px;
+font-weight: 800;

data/app/styles/themes/dark/snippets/project_sidebar_heading.qss

@@ -0,0 +1,2 @@
+color: #9ca3af;
+font-size: 12px;

data/app/styles/themes/dark/snippets/project_sidebar_logo.qss

@@ -0,0 +1,3 @@
+color: #e5e7eb;
+font-size: 18px;
+font-weight: 800;

data/app/styles/themes/dark/snippets/project_sidebar_panel.qss

@@ -0,0 +1,2 @@
+background-color: #111827;
+border-right: 1px solid #2b3b4f;

data/app/styles/themes/dark/snippets/tracker_clock.qss

@@ -0,0 +1,2 @@
+color: #9ca3af;
+font-size: 12px;

data/app/styles/themes/dark/snippets/tracker_input.qss

@@ -0,0 +1,5 @@
+background-color: #111827;
+border: 1px solid #334155;
+color: #e2e8f0;
+font-size: 14px;
+padding-left: 8px;

data/app/styles/themes/dark/snippets/tracker_project_label.qss

@@ -0,0 +1,5 @@
+background-color: #111827;
+border: 1px solid #334155;
+color: #cbd5e1;
+font-size: 13px;
+font-weight: 700;

data/app/styles/themes/dark/snippets/tracker_row.qss

@@ -0,0 +1,3 @@
+background-color: #0f172a;
+border: 1px solid #2b3b4f;
+color: #e2e8f0;