🔐 Enhanced Access Management & User Experience

✨ New Features

Explicit Access Request System

• All modules now explicitly request permissions before
  attempting operations
• Clear, actionable error messages when access is denied or
  missing
• Step-by-step instructions for granting required permissions
  in System Settings
• Graceful handling of both automation and system-level
  permissions

Improved Permission Detection

• Enhanced access checking for all Apple applications
• Better differentiation between automation access and system
  permissions
• Specific guidance for Full Disk Access requirements
  (Messages module)

🛠️ Improvements

Error Messages & User Guidance

• Before: Silent failures or generic "access denied" messages
• After: Detailed instructions with exact steps to resolve
  permission issues

Example:
Calendar access is required but not granted. Please:

1. Open System Settings > Privacy & Security > Automation
2. Find your terminal/app in the list and enable 'Calendar'
3. Alternatively, open System Settings > Privacy & Security >
   Calendars
4. Add your terminal/app to the allowed applications
5. Restart your terminal and try again

Module-Specific Access Functions

Each module now includes dedicated access request functions:

• requestContactsAccess() - Contacts permissions
• requestNotesAccess() - Notes automation
• requestMailAccess() - Mail automation
• requestMessagesAccess() - Messages + Full Disk Access
• requestRemindersAccess() - Reminders automation
• requestCalendarAccess() - Calendar permissions
• requestMapsAccess() - Maps automation

🔧 Technical Enhancements

Robust Error Handling

• Improved error propagation with context-aware messages
• Better distinction between access errors and operational
  errors
• Consistent error format across all modules

Permission Type Detection

• Automation Permissions: For AppleScript access to apps
• Privacy Permissions: For app-specific data access
  (Contacts, Calendars)
• Full Disk Access: For system-level data access (Messages
  database)

🚀 Developer Experience

Better Debugging

• Access status clearly indicated (GRANTED/NOT GRANTED)
• Specific permission requirements documented for each module
• Helpful error messages that guide users to solutions

Consistent API

• All modules follow the same access request pattern
• Standardized error message format
• Unified approach to permission handling

📱 Affected Modules

All core modules have been enhanced:

• Contacts - Enhanced contact access management
• Notes - Improved notes automation permissions
• Mail - Better mail application access handling
• Messages - Comprehensive Messages + database access
• Reminders - Enhanced reminder automation
• Calendar - Improved calendar permissions
• Maps - Better Maps application access

🔄 Migration Notes

This is a non-breaking change. Existing integrations will
continue to work, but will now provide much better error
messages and user guidance when permissions are missing.

🎯 Benefits

1. Better User Experience - Clear instructions instead of
   mysterious failures
2. Faster Setup - Users know exactly what permissions to
   grant
3. Reduced Support - Self-service permission resolution
4. More Reliable - Explicit permission checking prevents
   silent failures

DXT publish of apple MCP