abbu 0.1.2 → 0.2.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 6a2a430e28fa7792cb9f22a2e30f808a5d5752b0144cec428e64a88bde5740f9
-  data.tar.gz: 0c1e039e876c8a82b6a8ec52a046afe421f51d0236ceed9eab67f99a09261695
+  metadata.gz: 9926de7b6edc99155f0ddf18c39ebfab80677152caeba28bc7b2bce8b0e870bd
+  data.tar.gz: 8c7c8224f7799343d8ac994e4c21c2185b30f53aa8bd87783c5423f2ee09d1d8
 SHA512:
-  metadata.gz: 5978d9208cac2c0a6bff53184b1dcd1fa016c204a34aa4a7912f9a814d616d4bc7a482d868bf3dc47a4fc2a1b6671bbf7c8092432c28eae2fb1ec3f628248822
-  data.tar.gz: bd915874f2b2987640a2942beaec9fee6e034411c81fbfa0df127136e60353c5cc0327d638a84a2e959600209d2e9ba72143768b39568484ce4bcbb498e486f4
+  metadata.gz: 32b5f1d5496c8ae68f849756242588d6eac681305fee894156d1ba2a1717bb7e3b3fd8b03ce2504ff3c2340597451217a1b29fea9f7eb78e971d161c6b47072c
+  data.tar.gz: b1e62d48dca35bf1d3cb584728e7333f85c31971bcd28c01cc718949b8d093108c407efb159bbbf6017002fa3b6c2676c08906df8502fe1647ad6974787a9c9a

data/README.md

@@ -8,8 +8,10 @@ Read and process Apple Contacts `.abbu` archives in Ruby.
 
 - Parse ABBU (Apple Contacts export) bundles
 - SQLite-backed contact extraction (modern macOS)
-- Legacy plist format detection (stub, v0.2 roadmap)
-- Export to CSV, JSON, vCard
+- Legacy plist `.abcdp` parsing (older macOS)
+- Full Apple Contacts schema: names, nicknames, prefix/suffix, job title, department, phonetics, pronouns, and more
+- Rich relational data: addresses, URLs, notes, related names, social profiles
+- Export to CSV, JSON, vCard 3.0
 - CLI + Ruby API
 - Duplicate detection
 
@@ -35,9 +37,10 @@ require "abbu"
 archive = Abbu.open("Contacts.abbu")
 contacts = archive.contacts
 
-contacts.first.full_name   # => "Stan Carver"
-contacts.first.emails      # => ["stan@example.com"]
-contacts.first.phones      # => ["555-1234"]
+contacts.first.full_name   # => "Honorable Stan \"Stretch\" Carver II"
+contacts.first.emails      # => [{ address: "stan@example.com", label: "Work" }]
+contacts.first.phones      # => [{ number: "555-1234", label: "Mobile" }]
+contacts.first.job_title   # => "Engineer"
 ```
 
 ### Export
@@ -102,12 +105,7 @@ SQLite table schema, and format history.
 
 ## Roadmap
 
-| Version | Features                                    |
-|---------|---------------------------------------------|
-| v0.1.0  | SQLite parsing, CSV/JSON/vCard export, CLI  |
-| v0.2.0  | Plist parser, image extraction              |
-| v0.3.0  | Fuzzy dedupe (Levenshtein), merge engine    |
-| v1.0.0  | Sync adapters (Printavo, HubSpot, CRM)      |
+See [`docs/TODO.md`](docs/TODO.md) for the full release schedule and feature checklist.
 
 ## Development
 
@@ -120,7 +118,7 @@ mise exec -- bundle exec rubocop  # lint
 
 ## Contributing
 
-See [CONTRIBUTING.md](CONTRIBUTING.md).
+See [CONTRIBUTING.md](docs/CONTRIBUTING.md).
 
 ## License
 

data/docs/CONTRIBUTING.md

@@ -0,0 +1,51 @@
+<!-- CONTRIBUTING.md -->
+
+# Contributing to abbu
+
+Thank you for your interest in contributing!
+
+## Setup
+
+```bash
+git clone https://github.com/scarver2/abbu
+cd abbu
+mise exec -- bundle install
+```
+
+## DX Loop
+
+```bash
+mise exec -- bundle exec guard
+```
+
+This runs RSpec and RuboCop automatically on file changes.
+
+## Running Tests
+
+```bash
+mise exec -- bundle exec rspec
+```
+
+## Linting
+
+```bash
+mise exec -- bundle exec rubocop
+mise exec -- bundle exec rubocop -a   # autocorrect
+```
+
+## Pull Request Guidelines
+
+- Base branch: `master`
+- Commit style: [Conventional Commits](https://www.conventionalcommits.org/) (`feat:`, `fix:`, `docs:`, `chore:`)
+- All specs must pass and coverage must remain at 100%
+- RuboCop must pass with no offenses
+- Add an entry to `docs/CHANGELOG.md` under `[Unreleased]`
+
+## Reporting Issues
+
+Open an issue on GitHub with a minimal reproduction case.
+
+---
+Stan Carver II
+Made in Texas 🤠
+https://stancarver.com

data/docs/TODO.md

@@ -0,0 +1,172 @@
+<!-- docs/TODO.md -->
+
+# Abbu Roadmap & TODO
+
+Feature checklist organized by release version.
+
+---
+
+## v0.1.x — Foundation (Released)
+
+### v0.1.0 — Initial Release
+- [x] `Abbu.open(path)` entry point returning an `Archive`
+- [x] `Archive#contacts` — reads contacts from SQLite
+- [x] `Archive#sqlite?` — detects modern `.abcddb` bundles
+- [x] `Contact` model with `first_name`, `last_name`, `emails`, `phones`, `company`
+- [x] `Parsers::SqliteParser` — queries `ZABCDRECORD`, `ZABCDEMAILADDRESS`, `ZABCDPHONENUMBER`
+- [x] `Parsers::PlistParser` — stub with warning
+- [x] `Exporters::CsvExporter` — `to_file` and `to_stdout`
+- [x] `Exporters::JsonExporter` — `to_file` and `to_stdout`
+- [x] `Exporters::VcardExporter` — `to_file` and `to_stdout` (vCard 3.0)
+- [x] `Utils::Deduplicator` — groups contacts by first email
+- [x] `bin/abbu` CLI with `--format`, `--output`, `--stats`, `--dedupe`, `--version`
+- [x] Rake tasks: `abbu:export`, `abbu:dedupe`, `abbu:stats`
+- [x] `docs/ABBU.md` — file format reference
+- [x] RSpec test suite with 100% coverage target
+- [x] Guard + RuboCop DX loop
+- [x] GitHub Actions CI (Ruby 3.2 + 3.3)
+
+### v0.1.1 — Pathname Fix
+- [x] Fix missing `require 'pathname'` in `archive.rb`
+- [x] Regression guard spec for file require isolation
+
+### v0.1.2 — Full Apple Contacts Schema
+- [x] Nickname, prefix (`Title`), suffix fields
+- [x] Smart `full_name` formatting: `Honorable Stan "Stretch" Carver II`
+- [x] Job title, department, maiden name
+- [x] Phonetic first/last name, phonetic company
+- [x] Pronouns, ringtone, texttone
+- [x] Hash-based emails/phones preserving custom labels
+- [x] Address parsing from `ZABCDPOSTALADDRESS`
+- [x] Group membership from `Z_ABCDCONTACTGROUP`
+- [x] URL parsing from `ZABCDURLADDRESS`
+- [x] Notes from `ZABCDNOTE`
+- [x] Related names from `ZABCDRELATEDNAME`
+- [x] Social profiles from `ZABCDSOCIALPROFILE` (Twitter, etc.)
+- [x] CSV export with all fields (addresses, groups, URLs, notes, related names, social profiles)
+- [x] JSON export with all contact fields
+- [x] vCard 3.0 export with `ADR`, `URL`, `NICKNAME`, `TITLE`, `NOTE`, `X-SOCIALPROFILE`
+- [x] `rubocop-rspec` plugin integration
+- [x] SqliteParser refactored with `RECORD_FIELD_MAP` constant
+- [x] CsvExporter refactored into `core_fields` / `extended_fields`
+
+---
+
+## v0.2.0 — Plist Parser (In Progress)
+
+- [x] `PlistParser` — parse legacy `.abcdp` plist contact files
+- [x] Full field extraction matching SqliteParser output shape
+- [x] `FIELD_MAP` constant for flat-field mapping
+- [x] Multi-value field extraction (emails, phones, addresses, URLs, notes, related names, social profiles)
+- [x] Flexible input: directory path or array of file paths
+- [x] `Archive` scans `**/*.abcdp` across entire bundle tree
+- [x] `plist` gem (~> 3.7) runtime dependency
+- [x] Plist fixture files for integration testing
+- [x] Birthday / anniversary date parsing (plist `Birthday` key)
+- [x] Lunar birthday support
+- [x] Middle name extraction
+- [x] Instant messaging addresses (AIM, Jabber, etc.)
+- [x] Verification code field support
+
+---
+
+## v0.2.1 — Date Fields
+
+- [x] `dates` attribute on `Contact` (array of hashes: `{ label:, date: }`)
+- [x] SqliteParser: parse `ZABCDDATECOMPONENTS` (year/month/day separate columns)
+- [x] PlistParser: parse `Birthday` key
+- [x] Anniversary and custom date labels
+- [x] Lunar birthday handling
+- [x] CSV/JSON/vCard export of date fields (`BDAY`, `ANNIVERSARY` in vCard)
+
+---
+
+## v0.2.2 — Instant Messaging & Verification
+
+- [x] `instant_messages` attribute on `Contact`
+- [x] SqliteParser: parse `ZABCDMESSAGINGADDRESS`
+- [x] PlistParser: parse `InstantMessage` key
+- [x] Verification code field
+- [x] CSV/JSON/vCard export (`IMPP` in vCard)
+
+---
+
+## v0.2.3 — Middle Name & Completeness
+
+- [x] `middle_name` attribute on `Contact`
+- [x] Update `full_name` to include middle name
+- [x] SqliteParser: `ZMIDDLENAME` column
+- [x] PlistParser: `Middle` key
+- [x] Phonetic middle name support
+- [x] vCard `N` field with middle name component
+
+---
+
+## v0.3.0 — Image Extraction
+
+- [ ] Extract contact photos from `Images/` directory
+- [ ] Map image UUIDs to contacts via `ZIMAGEURI` or `ZHASIMAGE`
+- [ ] `Contact#image_path` accessor
+- [ ] CLI: `--extract-images` flag to export photos alongside contacts
+- [ ] Support JPEG, PNG, HEIC formats
+- [ ] Thumbnail vs. full-size image handling
+
+---
+
+## v0.4.0 — Fuzzy Deduplication
+
+- [ ] Levenshtein distance matching for name-based deduplication
+- [ ] Phone number normalization (strip formatting, compare digits)
+- [ ] Configurable similarity thresholds
+- [ ] `Deduplicator#fuzzy_duplicates` method
+- [ ] CLI: `--dedupe --fuzzy` flag
+- [ ] Merge suggestions output (side-by-side diff)
+
+---
+
+## v0.5.0 — Merge Engine
+
+- [ ] `Contact#merge(other)` — combine two contacts preserving all data
+- [ ] Conflict resolution strategies (keep-first, keep-last, keep-both)
+- [ ] `Archive#deduplicate!` — in-place merge with backup
+- [ ] CLI: `--merge` interactive mode
+- [ ] Export merged results to new `.abbu` bundle
+
+---
+
+## v0.6.0 — Filtering & Querying
+
+- [ ] `Archive#where(field: value)` query API
+- [ ] Filter by region (state, city, country)
+- [ ] Filter by group membership
+- [ ] Filter by date range (created, modified)
+- [ ] CLI: `--filter` flag with key=value syntax
+- [ ] Chainable query interface
+
+---
+
+## v0.7.0 — Write Support
+
+- [ ] Create new `.abbu` bundles from Contact objects
+- [ ] Write SQLite databases with correct schema
+- [ ] Write `.abcdp` plist files
+- [ ] Round-trip: read → modify → write
+- [ ] `Archive#save(path)` method
+
+---
+
+## v1.0.0 — Sync Adapters & Stable API
+
+- [ ] Adapter interface for external CRM sync
+- [ ] Printavo adapter
+- [ ] HubSpot adapter
+- [ ] Generic webhook/API adapter
+- [ ] Stable public API guarantee
+- [ ] Comprehensive API documentation (YARD)
+- [ ] Performance benchmarks for large archives (10k+ contacts)
+
+---
+
+Stan Carver II
+Made in Texas 🤠
+https://stancarver.com

data/lib/abbu/archive.rb

@@ -33,15 +33,15 @@ module Abbu
       @db_paths ||= @path.glob('**/*.abcddb')
     end
 
-    def records_path
-      @records_path ||= @path.join('Records')
+    def plist_paths
+      @plist_paths ||= @path.glob('**/*.abcdp').sort
     end
 
     def parser
       if sqlite?
         Parsers::SqliteParser.new(db_paths)
       else
-        Parsers::PlistParser.new(records_path)
+        Parsers::PlistParser.new(plist_paths)
       end
     end
   end

data/lib/abbu/contact.rb

@@ -3,9 +3,14 @@
 
 module Abbu
   class Contact
-    attr_accessor :first_name, :last_name, :emails, :phones, :company, :addresses, :groups, :nickname, :prefix, :suffix,
-                  :job_title, :department, :maiden_name, :phonetic_first_name, :phonetic_last_name, :phonetic_company,
-                  :pronouns, :ringtone, :texttone, :urls, :notes, :related_names, :social_profiles
+    attr_accessor :first_name, :middle_name, :last_name, :emails,
+                  :phones, :company, :addresses, :groups, :nickname,
+                  :prefix, :suffix, :job_title, :department, :maiden_name,
+                  :phonetic_first_name, :phonetic_middle_name, :phonetic_last_name,
+                  :phonetic_company, :pronouns, :ringtone, :texttone,
+                  :urls, :notes, :related_names, :social_profiles,
+                  :birthday, :anniversary, :dates, :instant_messages,
+                  :verification_code, :lunar_birthday
 
     def initialize
       @emails = []
@@ -16,11 +21,13 @@ module Abbu
       @notes = []
       @related_names = []
       @social_profiles = []
+      @dates = []
+      @instant_messages = []
     end
 
     def full_name
       quoted_nickname = nickname ? "\"#{nickname}\"" : nil
-      [prefix, first_name, quoted_nickname, last_name, suffix].compact.join(' ')
+      [prefix, first_name, middle_name, quoted_nickname, last_name, suffix].compact.join(' ')
     end
 
     def to_s

data/lib/abbu/exporters/csv_exporter.rb

@@ -27,7 +27,8 @@ module Abbu
       private
 
       def headers
-        %w[Name Email Phone Company Address Groups URLs Notes RelatedNames SocialProfiles]
+        %w[Name First Middle Last Email Phone Company Address Groups URLs Notes RelatedNames SocialProfiles Birthday
+           Anniversary InstantMessages VerificationCode LunarBirthday]
       end
 
       def row(contact)
@@ -36,21 +37,20 @@ module Abbu
 
       def core_fields(contact)
         [
-          contact.full_name,
-          contact.emails.first&.fetch(:address, nil),
-          contact.phones.first&.fetch(:number, nil),
-          contact.company,
-          format_address(contact.addresses.first),
-          contact.groups.join(', ')
+          contact.full_name, contact.first_name, contact.middle_name,
+          contact.last_name, contact.emails.first&.fetch(:address, nil),
+          contact.phones.first&.fetch(:number, nil), contact.company,
+          format_address(contact.addresses.first), contact.groups.join(', ')
         ]
       end
 
-      def extended_fields(contact)
+      def extended_fields(contact) # rubocop:disable Metrics/AbcSize
         [
-          contact.urls.map { |u| u[:url] }.join(', '),
-          contact.notes.join("\n"),
-          format_related_names(contact.related_names),
-          format_social_profiles(contact.social_profiles)
+          contact.urls.map { |u| u[:url] }.join(', '), contact.notes.join("\n"),
+          format_related_names(contact.related_names), format_social_profiles(contact.social_profiles),
+          format_date(contact.birthday), format_date(contact.anniversary),
+          format_instant_messages(contact.instant_messages), contact.verification_code,
+          format_date(contact.lunar_birthday)
         ]
       end
 
@@ -67,6 +67,20 @@ module Abbu
       def format_social_profiles(profiles)
         profiles.map { |sp| "#{sp[:username]} on #{sp[:service]}" }.join(', ')
       end
+
+      def format_instant_messages(ims)
+        ims.map { |im| "#{im[:address]} (#{im[:service]})" }.join(', ')
+      end
+
+      def format_date(date)
+        return nil unless date
+
+        if date[:year]&.positive?
+          format('%<year>04d-%<month>02d-%<day>02d', year: date[:year], month: date[:month], day: date[:day])
+        else
+          format('--%<month>02d-%<day>02d', month: date[:month], day: date[:day])
+        end
+      end
     end
   end
 end

data/lib/abbu/exporters/json_exporter.rb

@@ -28,7 +28,11 @@ module Abbu
         {
           name: contact.full_name,
           first_name: contact.first_name,
+          middle_name: contact.middle_name,
           last_name: contact.last_name,
+          phonetic_first_name: contact.phonetic_first_name,
+          phonetic_middle_name: contact.phonetic_middle_name,
+          phonetic_last_name: contact.phonetic_last_name,
           nickname: contact.nickname,
           prefix: contact.prefix,
           suffix: contact.suffix,
@@ -42,7 +46,13 @@ module Abbu
           urls: contact.urls,
           notes: contact.notes,
           related_names: contact.related_names,
-          social_profiles: contact.social_profiles
+          social_profiles: contact.social_profiles,
+          birthday: contact.birthday,
+          anniversary: contact.anniversary,
+          dates: contact.dates,
+          instant_messages: contact.instant_messages,
+          verification_code: contact.verification_code,
+          lunar_birthday: contact.lunar_birthday
         }.compact
       end
     end

data/lib/abbu/exporters/vcard_exporter.rb

@@ -22,23 +22,63 @@ module Abbu
         @contacts.map { |c| vcard_for(c) }.join("\n")
       end
 
-      def vcard_for(contact) # rubocop:disable Metrics/AbcSize,Metrics/MethodLength
+      def vcard_for(contact) # rubocop:disable Metrics/MethodLength
         lines = ['BEGIN:VCARD', 'VERSION:3.0']
-        lines << "FN:#{contact.full_name}"
-        lines << "N:#{contact.last_name};#{contact.first_name};;;"
-        lines << "NICKNAME:#{contact.nickname}" if contact.nickname
-        lines << "ORG:#{contact.company}" if contact.company
-        lines << "TITLE:#{contact.job_title}" if contact.job_title
+
+        append_name_fields(lines, contact)
         append_emails(lines, contact)
         append_phones(lines, contact)
         append_addresses(lines, contact)
         append_urls(lines, contact)
         append_social_profiles(lines, contact)
-        contact.notes.each { |n| lines << "NOTE:#{n}" }
+        append_dates(lines, contact)
+        append_instant_messages(lines, contact)
+        append_verification_code(lines, contact)
+        append_notes(lines, contact)
+
         lines << 'END:VCARD'
         lines.join("\n")
       end
 
+      def append_name_fields(lines, contact)
+        lines << "FN:#{contact.full_name}"
+        lines << "N:#{name_components(contact).join(';')}"
+        append_nickname(lines, contact)
+        append_company(lines, contact)
+        append_title(lines, contact)
+        append_phonetic_names(lines, contact)
+      end
+
+      def name_components(contact)
+        [contact.last_name, contact.first_name, contact.middle_name, contact.prefix, contact.suffix]
+      end
+
+      def append_nickname(lines, contact)
+        lines << "NICKNAME:#{contact.nickname}" if contact.nickname
+      end
+
+      def append_company(lines, contact)
+        lines << "ORG:#{contact.company}" if contact.company
+      end
+
+      def append_title(lines, contact)
+        lines << "TITLE:#{contact.job_title}" if contact.job_title
+      end
+
+      def append_phonetic_names(lines, contact)
+        lines << "X-PHONETIC-FIRST-NAME:#{contact.phonetic_first_name}" if contact.phonetic_first_name
+        lines << "X-PHONETIC-MIDDLE-NAME:#{contact.phonetic_middle_name}" if contact.phonetic_middle_name
+        lines << "X-PHONETIC-LAST-NAME:#{contact.phonetic_last_name}" if contact.phonetic_last_name
+      end
+
+      def append_verification_code(lines, contact)
+        lines << "X-VERIFICATION-CODE:#{contact.verification_code}" if contact.verification_code
+      end
+
+      def append_notes(lines, contact)
+        contact.notes.each { |n| lines << "NOTE:#{n}" }
+      end
+
       def append_emails(lines, contact)
         contact.emails.each do |e|
           label = e[:label] || 'INTERNET'
@@ -71,6 +111,32 @@ module Abbu
           lines << "X-SOCIALPROFILE;TYPE=#{sp[:service]}:#{sp[:username]}"
         end
       end
+
+      def append_instant_messages(lines, contact)
+        contact.instant_messages.each do |im|
+          service = im[:service]&.downcase || 'unknown'
+          lines << "IMPP;TYPE=#{im[:label]}:#{service}:#{im[:address]}"
+        end
+      end
+
+      def append_dates(lines, contact)
+        lines << "BDAY:#{format_vcard_date(contact.birthday)}" if contact.birthday
+        lines << "X-LUNAR-BDAY:#{format_vcard_date(contact.lunar_birthday)}" if contact.lunar_birthday
+        return unless contact.anniversary
+
+        lines << "X-ABDATE;type=pref:#{format_vcard_date(contact.anniversary)}"
+        lines << 'X-ABLABEL:_$!<Anniversary>!$_'
+      end
+
+      def format_vcard_date(date)
+        return nil unless date
+
+        if date[:year]&.positive?
+          format('%<year>04d-%<month>02d-%<day>02d', year: date[:year], month: date[:month], day: date[:day])
+        else
+          format('--%<month>02d-%<day>02d', month: date[:month], day: date[:day])
+        end
+      end
     end
   end
 end

data/lib/abbu/parsers/plist_parser.rb

@@ -1,16 +1,154 @@
 # lib/abbu/parsers/plist_parser.rb
 # frozen_string_literal: true
 
+require 'plist'
+require_relative '../contact'
+
 module Abbu
   module Parsers
     class PlistParser
-      def initialize(path)
-        @path = path
+      # Maps plist keys → Contact attr_accessor names for simple string fields
+      FIELD_MAP = {
+        'First' => :first_name, 'Middle' => :middle_name,
+        'Last' => :last_name,
+        'Nickname' => :nickname,  'Title' => :prefix,
+        'Suffix' => :suffix,      'Organization' => :company,
+        'JobTitle' => :job_title, 'Department' => :department,
+        'MaidenName' => :maiden_name, 'VerificationCode' => :verification_code,
+        'PhoneticFirst' => :phonetic_first_name,
+        'PhoneticMiddle' => :phonetic_middle_name,
+        'PhoneticLast' => :phonetic_last_name
+      }.freeze
+
+      # Accepts either a directory path (scans for *.abcdp) or an array of file paths
+      def initialize(paths)
+        @paths = resolve_paths(paths)
       end
 
       def contacts
-        warn 'Plist parsing not yet implemented — no .abcddb found in this archive.'
-        []
+        @paths.filter_map { |file| parse_file(file) }
+      end
+
+      private
+
+      def resolve_paths(paths)
+        case paths
+        when Array
+          paths.map { |p| Pathname.new(p) }
+        else
+          path = Pathname.new(paths)
+          return [] unless path.exist?
+
+          path.directory? ? path.glob('*.abcdp').sort : [path]
+        end
+      end
+
+      def parse_file(file)
+        data = Plist.parse_xml(file.to_s)
+        return nil unless data
+
+        build_contact(data)
+      end
+
+      def build_contact(data)
+        contact = Contact.new
+        assign_flat_fields(contact, data)
+        assign_multi_value_fields(contact, data)
+        contact
+      end
+
+      def assign_flat_fields(contact, data)
+        FIELD_MAP.each do |plist_key, attr|
+          contact.public_send(:"#{attr}=", data[plist_key])
+        end
+      end
+
+      def assign_multi_value_fields(contact, data) # rubocop:disable Metrics/AbcSize, Metrics/MethodLength
+        contact.emails          = extract_labeled_values(data, 'Email', :address)
+        contact.phones          = extract_labeled_values(data, 'Phone', :number)
+        contact.addresses       = extract_addresses(data)
+        contact.urls            = extract_labeled_values(data, 'URLs', :url)
+        contact.notes           = extract_notes(data)
+        contact.related_names   = extract_labeled_values(data, 'RelatedNames', :name)
+        contact.social_profiles = extract_social_profiles(data)
+        contact.instant_messages = extract_instant_messages(data)
+
+        contact.birthday = extract_birthday(data)
+        contact.lunar_birthday = extract_lunar_birthday(data)
+        contact.dates = extract_dates(data)
+        contact.anniversary = contact.dates.find { |d| d[:label] == '_$!<Anniversary>!$_' }
+      end
+
+      def extract_labeled_values(data, key, value_key)
+        return [] unless data[key]&.dig('values')
+
+        data[key]['values'].map do |entry|
+          { value_key => entry['value'], label: entry['label'] }
+        end
+      end
+
+      def extract_addresses(data) # rubocop:disable Metrics/MethodLength
+        return [] unless data['Address']&.dig('values')
+
+        data['Address']['values'].map do |entry|
+          addr = entry['value'] || {}
+          {
+            street: addr['Street'],
+            city: addr['City'],
+            state: addr['State'],
+            zip: addr['ZIP'],
+            country: addr['Country'],
+            label: entry['label']
+          }
+        end
+      end
+
+      def extract_notes(data)
+        note = data['Note']
+        note ? [note] : []
+      end
+
+      def extract_social_profiles(data)
+        return [] unless data['SocialProfile']&.dig('values')
+
+        data['SocialProfile']['values'].map do |entry|
+          profile = entry['value'] || {}
+          { service: profile['serviceName'], username: profile['username'] }
+        end
+      end
+
+      def extract_instant_messages(data)
+        return [] unless data['InstantMessage']&.dig('values')
+
+        data['InstantMessage']['values'].map do |entry|
+          msg = entry['value'] || {}
+          { address: msg['address'], label: entry['label'], service: msg['serviceName'] }
+        end
+      end
+
+      def extract_birthday(data)
+        val = data['Birthday']
+        return nil unless val.respond_to?(:year)
+
+        { year: val.year, month: val.month, day: val.day, label: '_$!<Birthday>!$_' }
+      end
+
+      def extract_lunar_birthday(data)
+        val = data['LunarBirthday']
+        return nil unless val.respond_to?(:year)
+
+        { year: val.year, month: val.month, day: val.day, label: '_$!<LunarBirthday>!$_' }
+      end
+
+      def extract_dates(data)
+        return [] unless data['Dates']&.dig('values')
+
+        data['Dates']['values'].filter_map do |entry|
+          val = entry['value']
+          next unless val.respond_to?(:year)
+
+          { year: val.year, month: val.month, day: val.day, label: entry['label'] }
+        end
       end
     end
   end

data/lib/abbu/parsers/sqlite_parser.rb

@@ -9,16 +9,19 @@ module Abbu
     class SqliteParser # rubocop:disable Metrics/ClassLength
       # Column-name → attr_accessor mapping for flat fields on ZABCDRECORD
       RECORD_FIELD_MAP = {
-        'ZFIRSTNAME' => :first_name, 'ZLASTNAME' => :last_name,
+        'ZFIRSTNAME' => :first_name, 'ZMIDDLENAME' => :middle_name,
+        'ZLASTNAME' => :last_name,
         'ZNICKNAME' => :nickname, 'ZTITLE' => :prefix,
         'ZSUFFIX' => :suffix, 'ZORGANIZATION' => :company,
         'ZJOBTITLE' => :job_title, 'ZDEPARTMENT' => :department,
         'ZMAIDENNAME' => :maiden_name,
         'ZPHONETICFIRSTNAME' => :phonetic_first_name,
+        'ZPHONETICMIDDLENAME' => :phonetic_middle_name,
         'ZPHONETICLASTNAME' => :phonetic_last_name,
         'ZPHONETICORGANIZATION' => :phonetic_company,
         'ZPRONOUNS' => :pronouns,
-        'ZRINGTONE' => :ringtone, 'ZTEXTTONE' => :texttone
+        'ZRINGTONE' => :ringtone, 'ZTEXTTONE' => :texttone,
+        'ZVERIFICATIONCODE' => :verification_code
       }.freeze
 
       def initialize(db_paths)
@@ -124,6 +127,28 @@ module Abbu
         []
       end
 
+      def dates_for(db, record_id)
+        db.execute(
+          'SELECT ZYEAR, ZMONTH, ZDAY, ZLABEL FROM ZABCDDATECOMPONENTS WHERE ZOWNER = ?',
+          record_id
+        ).map do |row|
+          { year: row['ZYEAR'], month: row['ZMONTH'], day: row['ZDAY'], label: row['ZLABEL'] }
+        end
+      rescue SQLite3::SQLException
+        []
+      end
+
+      def instant_messages_for(db, record_id)
+        db.execute(
+          'SELECT ZADDRESS, ZLABEL, ZSERVICENAME FROM ZABCDMESSAGINGADDRESS WHERE ZOWNER = ?',
+          record_id
+        ).map do |row|
+          { address: row['ZADDRESS'], label: row['ZLABEL'], service: row['ZSERVICENAME'] }
+        end
+      rescue SQLite3::SQLException
+        []
+      end
+
       def build_contact(db, row)
         contact = Contact.new
         assign_flat_fields(contact, row)
@@ -137,15 +162,22 @@ module Abbu
         end
       end
 
-      def assign_relational_fields(contact, db, record_id) # rubocop:disable Metrics/AbcSize
-        contact.emails          = emails_for(db, record_id)
-        contact.phones          = phones_for(db, record_id)
-        contact.addresses       = addresses_for(db, record_id)
-        contact.groups          = groups_for(db, record_id)
-        contact.urls            = urls_for(db, record_id)
-        contact.notes           = notes_for(db, record_id)
-        contact.related_names   = related_names_for(db, record_id)
-        contact.social_profiles = social_profiles_for(db, record_id)
+      def assign_relational_fields(contact, db, record_id) # rubocop:disable Metrics/AbcSize,Metrics/MethodLength
+        contact.emails           = emails_for(db, record_id)
+        contact.phones           = phones_for(db, record_id)
+        contact.addresses        = addresses_for(db, record_id)
+        contact.groups           = groups_for(db, record_id)
+        contact.urls             = urls_for(db, record_id)
+        contact.notes            = notes_for(db, record_id)
+        contact.related_names    = related_names_for(db, record_id)
+        contact.social_profiles  = social_profiles_for(db, record_id)
+        contact.instant_messages = instant_messages_for(db, record_id)
+
+        all_dates = dates_for(db, record_id)
+        contact.dates = all_dates
+        contact.birthday    = all_dates.find { |d| d[:label] == '_$!<Birthday>!$_' }
+        contact.anniversary = all_dates.find { |d| d[:label] == '_$!<Anniversary>!$_' }
+        contact.lunar_birthday = all_dates.find { |d| d[:label] == '_$!<LunarBirthday>!$_' }
       end
     end
   end

data/lib/abbu/version.rb

@@ -2,5 +2,5 @@
 # frozen_string_literal: true
 
 module Abbu
-  VERSION = '0.1.2'
+  VERSION = '0.2.0'
 end

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: abbu
 version: !ruby/object:Gem::Version
-  version: 0.1.2
+  version: 0.2.0
 platform: ruby
 authors:
 - Stan Carver II
 autorequire:
 bindir: bin
 cert_chain: []
-date: 2026-04-26 00:00:00.000000000 Z
+date: 2026-05-03 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: sqlite3
@@ -38,6 +38,20 @@ dependencies:
     - - ">="
       - !ruby/object:Gem::Version
         version: '0'
+- !ruby/object:Gem::Dependency
+  name: plist
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '3.7'
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '3.7'
 - !ruby/object:Gem::Dependency
   name: guard
   requirement: !ruby/object:Gem::Requirement
@@ -108,6 +122,20 @@ dependencies:
     - - "~>"
       - !ruby/object:Gem::Version
         version: '3.13'
+- !ruby/object:Gem::Dependency
+  name: ruby-lsp
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '0.1'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '0.1'
 - !ruby/object:Gem::Dependency
   name: rubocop
   requirement: !ruby/object:Gem::Requirement
@@ -188,7 +216,6 @@ executables:
 extensions: []
 extra_rdoc_files: []
 files:
-- CHANGELOG.md
 - LICENSE
 - README.md
 - bin/abbu
@@ -199,6 +226,9 @@ files:
 - bin/outdated
 - bin/test
 - docs/ABBU.md
+- docs/CHANGELOG.md
+- docs/CONTRIBUTING.md
+- docs/TODO.md
 - examples/deduplicate_contacts.rb
 - examples/export_to_api.rb
 - examples/export_to_csv.rb
@@ -224,7 +254,7 @@ metadata:
   allowed_push_host: https://rubygems.org
   homepage_uri: https://github.com/scarver2/abbu
   source_code_uri: https://github.com/scarver2/abbu
-  changelog_uri: https://github.com/scarver2/abbu/blob/master/CHANGELOG.md
+  changelog_uri: https://github.com/scarver2/abbu/blob/master/docs/CHANGELOG.md
   rubygems_mfa_required: 'true'
 post_install_message:
 rdoc_options: []