Add Evernote-to-Notion migration CLI with Thrift binary protocol

[pollenjp]

Summary

This PR introduces a complete Evernote-to-Notion migration tool written in Rust. The implementation includes a custom Apache Thrift Binary Protocol implementation to communicate with Evernote's API, ENML-to-Notion block conversion, and rate-limited API clients for both services.

Key Changes

• Custom Thrift Binary Protocol Implementation (src/thrift/)

  • Minimal BinaryProtocolWriter and BinaryProtocolReader using bytes::{Buf, BufMut}
  • Supports message framing, struct/field serialization, and exception handling
  • HttpTransport for POST-based Thrift calls over HTTPS

• Evernote Client (src/evernote/)

  • Direct API calls to UserStore and NoteStore without external SDK
  • Methods: getUser(), findNotesMetadata(), getNote(), getResource()
  • Exception handling for EDAMUserException, EDAMSystemException, EDAMNotFoundException
  • Rate limit handling with configurable backoff

• Notion Client (src/notion/)

  • Database query for duplicate detection via Evernote URL property
  • Page creation with rich text blocks
  • Two-step file upload API integration

• ENML Converter (src/enml/)

  • Converts Evernote's ENML (HTML subset) to intermediate ConvertedBlock representation
  • Supports headings, paragraphs, lists, code blocks, and media references
  • Media references resolved to Notion file uploads via hash mapping

• Migrator (src/migrator.rs)

  • Orchestrates the migration workflow
  • Idempotent via Evernote URL tracking in Notion
  • Batch processing with configurable limits and dry-run mode

• Rate Limiting (src/rate_limit.rs)

  • Token bucket implementation for concurrent API calls
  • Respects Evernote's rateLimitDuration from system exceptions

• CLI & Configuration

  • main.rs with migrate and dry-run subcommands
  • Environment-based configuration for API tokens and endpoints
  • Structured logging with tracing

• Build & Testing

  • Cargo.toml with dependencies: tokio, reqwest, serde, quick-xml, thiserror
  • mise.toml for task automation (build, test, lint, fmt)
  • GitHub Actions CI workflow
  • Integration test skeleton with wiremock support

• Documentation

  • ADR-01 documenting architectural decisions
  • Agent log detailing implementation rationale
  • README with architecture diagram and usage instructions

Notable Implementation Details

• No external Thrift crate dependency; protocol implemented from scratch to minimize dependencies and maintain control over error handling
• Evernote exceptions decoded from Thrift result struct fields (IDs 1-3) following standard Thrift conventions
• ENML parsing uses quick-xml for robustness against malformed input
• Notion file uploads use multipart form data with signed URLs
• Concurrent rate limiting via shared TokenBucket across Evernote (2 RPS) and Notion (3 RPS) clients

https://claude.ai/code/session_014DFRXwuWKj8x5HVGUSf71F