things-mcp 0.1.2 → 0.1.3

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 66584b39e6d5286abeb4a75f08f029bab5c7c1b7b7f42129ee12986086fa7927
-  data.tar.gz: bb7603686e15d0dc366f746e263dbb99cebb00ce35377e8ae49fb7f468658dc0
+  metadata.gz: c04d398fe0ae4d889f3b1283f170b7ea16d89d3aadb15c0729f02224051fb40c
+  data.tar.gz: 63edc670dfefbf746f0397a3a41e95e81ae977237421057e89564b4b77ce998b
 SHA512:
-  metadata.gz: 5ff846805290fb8e7e628b8809855c2538852be5f0ea69766d176fa6065081ae93af010b2958c68bdc4ce5014f580375939701bf7964a1d915ea3d72d0d5f30e
-  data.tar.gz: 8450f45b5c44b9cf8a37762e48cb7c4fe2b64a6e409ebcd2603036726c49535ad862b9ded6796dc13788694562c10e1406ec7547c7364c1bfa1d91b61312b8e9
+  metadata.gz: 749a56ffef198d8bfabf98212faa51e8d47f8b79280a09899910a49938ea20391ebe08e8a5387ef593ec3095bea9aa7d138ca7294058d3b995ed3f4385fc0ee0
+  data.tar.gz: 570aeb516c134b4de385a25b672677976879dcccab000be09ba697568de5ff03864ea328a695ba03212c49b28352f5be1e820402f2ed172483aba476df9a1eca

data/lib/things_mcp/database.rb

@@ -11,6 +11,10 @@ module ThingsMcp
   # This class provides read-only access to the Things 3 database, enabling retrieval of todos, projects, areas, and
   # tags. It handles dynamic database path resolution and provides formatted data structures.
   class Database
+    # Things date encoding constants
+    UNITS_PER_DAY = 128.0
+    EPOCH = Date.new(-814, 4, 1)
+
     class << self
       def database_path
         @database_path ||= find_database_path
@@ -62,7 +66,24 @@ module ThingsMcp
       end
 
       def get_today
-        get_todos_by_start(1)
+        # Get todos scheduled for today or overdue (startDate <= today's value)
+        today_value = (Date.today - EPOCH) * UNITS_PER_DAY
+
+        with_database do |db|
+          query = <<~SQL
+            SELECT #{todo_columns}
+            FROM TMTask
+            WHERE type = 0
+              AND status = 0
+              AND trashed = 0
+              AND startDate IS NOT NULL
+              AND startDate <= #{today_value.to_i}
+            ORDER BY "index"
+          SQL
+
+          results = db.execute(query).map { |row| format_todo(row) }
+          add_checklist_items_and_tags(db, results)
+        end
       end
 
       def get_upcoming
@@ -78,21 +99,56 @@ module ThingsMcp
             ORDER BY COALESCE(startDate, deadline)
           SQL
 
-          db.execute(query).map { |row| format_todo(row) }
+          results = db.execute(query).map { |row| format_todo(row) }
+          add_checklist_items_and_tags(db, results)
         end
       end
 
       def get_anytime
-        get_todos_by_start(2).reject { |t| t[:start_date] || t[:deadline] }
+        with_database do |db|
+          query = <<~SQL
+            SELECT #{todo_columns}
+            FROM TMTask
+            WHERE type = 0
+              AND status = 0
+              AND trashed = 0
+              AND start = 1
+            ORDER BY "index"
+          SQL
+
+          results = db.execute(query).map { |row| format_todo(row) }
+          add_checklist_items_and_tags(db, results)
+        end
       end
 
       def get_someday
-        get_todos_by_start(3)
+        # Get todos in someday: start=2 with no dates
+        # FIXME: Recurring items (like "Update mileage log") appear here when they should
+        # appear in Today or Scheduled based on their next occurrence. Things likely uses
+        # additional metadata to track recurring patterns that we haven't implemented.
+        with_database do |db|
+          query = <<~SQL
+            SELECT #{todo_columns}
+            FROM TMTask
+            WHERE type = 0
+              AND status = 0
+              AND trashed = 0
+              AND start = 2
+              AND startDate IS NULL
+              AND deadline IS NULL
+            ORDER BY "index"
+          SQL
+
+          results = db.execute(query).map { |row| format_todo(row) }
+          add_checklist_items_and_tags(db, results)
+        end
       end
 
       def get_logbook(period: "7d", limit: 50)
         days = parse_period(period)
         cutoff = Date.today - days
+        # stopDate is a REAL column with Unix timestamp
+        cutoff_timestamp = cutoff.to_time.to_i
 
         with_database do |db|
           query = <<~SQL
@@ -101,7 +157,7 @@ module ThingsMcp
             WHERE type = 0
               AND status IN (3, 2)
               AND trashed = 0
-              AND stopDate >= julianday('#{cutoff}')
+              AND stopDate >= #{cutoff_timestamp}
             ORDER BY stopDate DESC
             LIMIT #{limit}
           SQL
@@ -247,11 +303,17 @@ module ThingsMcp
 
           # Date filters
           if filters[:start_date]
-            conditions << "startDate >= julianday('#{filters[:start_date]}')"
+            # startDate is INTEGER column with NSDate seconds
+            nsdate_epoch = Time.new(2001, 1, 1, 0, 0, 0, "+00:00")
+            start_timestamp = (Date.parse(filters[:start_date]).to_time - nsdate_epoch).to_i
+            conditions << "startDate >= #{start_timestamp}"
           end
 
           if filters[:deadline]
-            conditions << "deadline <= julianday('#{filters[:deadline]}')"
+            # deadline is INTEGER column with NSDate seconds
+            nsdate_epoch = Time.new(2001, 1, 1, 0, 0, 0, "+00:00")
+            deadline_timestamp = (Date.parse(filters[:deadline]).to_time - nsdate_epoch).to_i
+            conditions << "deadline <= #{deadline_timestamp}"
           end
 
           # Tag filter
@@ -285,6 +347,8 @@ module ThingsMcp
       def get_recent(period)
         days = parse_period(period)
         cutoff = Date.today - days
+        # creationDate is a REAL column with Unix timestamp
+        cutoff_timestamp = cutoff.to_time.to_i
 
         with_database do |db|
           query = <<~SQL
@@ -292,7 +356,7 @@ module ThingsMcp
             FROM TMTask
             WHERE type = 0
               AND trashed = 0
-              AND creationDate >= julianday('#{cutoff}')
+              AND creationDate >= #{cutoff_timestamp}
             ORDER BY creationDate DESC
           SQL
 
@@ -413,10 +477,10 @@ module ThingsMcp
           area: row["area"],
           tags: [],  # Tags will be populated separately
           when: format_when(row["start"]),
-          start_date: julian_to_date(row["startDate"]),
-          deadline: julian_to_date(row["deadline"]),
-          created: julian_to_date(row["creationDate"]),
-          modified: julian_to_date(row["userModificationDate"]),
+          start_date: things_date_to_date(row["startDate"]),
+          deadline: things_date_to_date(row["deadline"]),
+          created: unix_timestamp_to_date(row["creationDate"]),
+          modified: unix_timestamp_to_date(row["userModificationDate"]),
         }
       end
 
@@ -429,10 +493,10 @@ module ThingsMcp
           area: row["area"],
           tags: [],  # Tags will be populated separately for projects too
           when: format_when(row["start"]),
-          start_date: julian_to_date(row["startDate"]),
-          deadline: julian_to_date(row["deadline"]),
-          created: julian_to_date(row["creationDate"]),
-          modified: julian_to_date(row["userModificationDate"]),
+          start_date: things_date_to_date(row["startDate"]),
+          deadline: things_date_to_date(row["deadline"]),
+          created: unix_timestamp_to_date(row["creationDate"]),
+          modified: unix_timestamp_to_date(row["userModificationDate"]),
         }
       end
 
@@ -470,11 +534,20 @@ module ThingsMcp
         end
       end
 
-      def julian_to_date(julian_days)
-        return unless julian_days
+      def things_date_to_date(value)
+        return unless value
+
+        # Things uses custom date encoding: 128 units = 1 day (11.25 minutes per unit)
+        # Epoch calculated from reverse engineering known date values
+        days = value / UNITS_PER_DAY
+        (EPOCH + days).to_s
+      end
+
+      def unix_timestamp_to_date(value)
+        return unless value
 
-        # SQLite Julian day starts from noon on November 24, 4714 BC
-        Date.jd(julian_days.to_i + 2400001).to_s
+        # REAL columns (creationDate, userModificationDate): Unix timestamps (seconds since 1970-01-01)
+        Time.at(value.to_f).to_date.to_s
       end
 
       def parse_period(period)
@@ -501,6 +574,15 @@ module ThingsMcp
         # If decoding fails, return original title
         title
       end
+
+      # Helper method to consistently add checklist items and tags to todos
+      def add_checklist_items_and_tags(db, todos)
+        todos.each do |todo|
+          todo[:checklist_items] = get_checklist_items(db, todo[:uuid])
+          todo[:tags] = get_tags_for_task(db, todo[:uuid])
+        end
+        todos
+      end
     end
   end
 end

data/lib/things_mcp/version.rb

@@ -1,5 +1,5 @@
 # frozen_string_literal: true
 
 module ThingsMcp
-  VERSION = "0.1.2"
+  VERSION = "0.1.3"
 end

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: things-mcp
 version: !ruby/object:Gem::Version
-  version: 0.1.2
+  version: 0.1.3
 platform: ruby
 authors:
 - Hakan Ensari