apple-notes-reference-architecture

# Apple Notes Reference Architecture ## Overview Apple Notes automation systems are fundamentally different from cloud SaaS integrations. There is no REST API, no server-side SDK, and no webhook infrastructure. Everything runs locally on macOS through the Apple Events IPC bridge. This reference architecture defines the standard layered approach: a Node.js application layer that calls JXA scripts via `osascript`, a local SQLite cache for fast queries, a change detection poller for event-driven workflows, and optional Shortcuts integration for cross-app automation. ## System Architecture ``` ┌─────────────────────────────────────────────────────┐ │ macOS Machine │ │ │ │ ┌──────────┐ ┌───────────┐ ┌────────────────┐ │ │ │ Your App │──▶│ osascript │──▶│ Notes.app │ │ │ │ (Node.js)│ │ (JXA) │ │ (local DB) │ │ │ └────┬─────┘ └───────────┘ └───────┬────────┘ │ │ │ │ │ │ ┌────▼─────┐ ┌───────────┐ ┌───────▼────────┐ │ │ │ SQLite │ │ Shortcuts │ │ iCloud Sync │ │ │ │ Cache │ │ Automations│ │ (bird/cloudd) │ │ │ └──────────┘ └───────────┘ └────────────────┘ │ │ │ │ │ │ ┌────▼─────┐ ┌────────▼───────┐ │ │ │ Poller / │ │ Other Apple │ │ │ │ FSEvents │ │ Devices ...