apple-notes-upgrade-migration

# Apple Notes Upgrade & Migration ## Overview Each macOS major release can change Apple Notes capabilities, JXA API behavior, and the underlying NoteStore database schema. Automation scripts that work on Ventura may fail on Sonoma due to new properties, changed Apple Events handling, or TCC permission resets. This guide covers version-specific changes, pre-upgrade backup procedures, post-upgrade validation, and a compatibility matrix for JXA features across macOS versions. ## macOS Version Compatibility Matrix | macOS Version | Notes Features Added | JXA Impact | Breaking Changes | |--------------|---------------------|------------|-----------------| | Monterey (12) | Quick Notes, #tags in body | No new JXA properties | None | | Ventura (13) | Shared notes, smart folders | Sharing not exposed in JXA | TCC changes; re-prompt required | | Sonoma (14) | Tags as first-class, link notes | Tag properties partially accessible | Smart folder API changed | | Sequoia (15) | Math expressions, audio recording | New content types in body HTML | Apple Events timeout behavior changed | ## Pre-Upgrade Backup ```bash #!/bin/bash # Run BEFORE upgrading macOS BACKUP_DIR="$HOME/notes-pre-upgrade-$(sw_vers -productVersion)-$(date +%Y%m%d)" mkdir -p "$BACKUP_DIR" echo "Backing up Apple Notes before macOS upgrade..." echo "Current macOS: $(sw_vers -productVersion)" # Full export with metadata osascript -l JavaScript -e ' const Notes = Application("Notes"); const data = Notes.accounts()....