bridgetown_readwise_curator 0.1.0

checksums.yaml

@@ -0,0 +1,7 @@
+---
+SHA256:
+  metadata.gz: 6f75f4f7b727786719b11287d1276acfa992e5a97ca27bc300ee33c52a69ceeb
+  data.tar.gz: 686a479fb624a7c889d09dbe42012d43007cbff687cc4c673a613701fff15496
+SHA512:
+  metadata.gz: 9ec0c6d400898efd5f992f81d130656e79dd4d2a81862edea6fc57516f05eeb900ac15267182142a2a9eafa5815a2e6d79441e332de0505e9782fb5604f06c3f
+  data.tar.gz: 44d930380bd8405b609912cef9fd4e138b035a52f9ffc0c17e0c343e18102e389f1c89a7b1c911d7c436eeb7208f2f2c206e7a5375cb0d25a63d687423563e10

data/.github/workflows/tests.yml

@@ -0,0 +1,32 @@
+name: Tests
+
+on:
+  pull_request:
+    branches:
+      - "*"
+  push:
+    branches:
+      - main
+
+jobs:
+  build:
+    runs-on: ubuntu-latest
+    strategy:
+      matrix:
+        ruby_version: [2.7.7, 3.0.5, 3.1.3, 3.2.0]
+        bridgetown_version: [1.2.0]
+    continue-on-error: ${{ endsWith(matrix.ruby, 'head') || matrix.ruby == 'debug' }}
+    # Has to be top level to cache properly
+    env:
+      BUNDLE_JOBS: 3
+      BUNDLE_PATH: "vendor/bundle"
+      BRIDGETOWN_VERSION: ${{ matrix.bridgetown_version }}
+    steps:
+      - uses: actions/checkout@master
+      - name: Setup Ruby
+        uses: ruby/setup-ruby@v1
+        with:
+          ruby-version: ${{ matrix.ruby_version }}
+          bundler-cache: true
+      - name: Test with Rake
+        run: script/cibuild

data/.gitignore

@@ -0,0 +1,40 @@
+/vendor
+/.bundle/
+/.yardoc
+/Gemfile.lock
+/_yardoc/
+/coverage/
+/doc/
+/pkg/
+/spec/reports/
+/tmp/
+*.bundle
+*.so
+*.o
+*.a
+mkmf.log
+*.gem
+Gemfile.lock
+.bundle
+.ruby-version
+
+# Node
+node_modules
+.npm
+.node_repl_history
+
+# Yarn
+yarn-error.log
+yarn-debug.log*
+.pnp/
+.pnp.js
+
+# Yarn Integrity file
+.yarn-integrity
+
+test/dest
+.bridgetown-metadata
+.bridgetown-cache
+.bridgetown-webpack
+
+.env

data/.rubocop.yml

@@ -0,0 +1,23 @@
+require: rubocop-bridgetown
+
+inherit_gem:
+  rubocop-bridgetown: .rubocop.yml
+
+AllCops:
+  TargetRubyVersion: 2.7
+
+  Exclude:
+    - .gitignore
+    - .rubocop.yml
+    - "*.gemspec"
+
+    - Gemfile.lock
+    - CHANGELOG.md
+    - LICENSE.txt
+    - README.md
+    - Rakefile
+    - bridgetown.automation.rb
+
+    - script/**/*
+    - test/fixtures/**/*
+    - vendor/**/*

data/CHANGELOG.md

@@ -0,0 +1,29 @@
+# Changelog
+
+All notable changes to this project will be documented in this file.
+
+The format is based on [Keep a Changelog](https://keepachangelog.com/en/1.0.0/),
+and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0.html).
+
+## [Unreleased]
+
+## [0.1.0] - 2025-08-30
+
+### Added
+- Interactive CLI for curating Readwise highlights with pagination
+- Bridgetown plugin integration with `bin/bt readwise` command
+- Highlight fetching from Readwise API with book selection
+- Multi-select highlight curation with preview
+- JSON data file generation in `src/_data/readwise/curated_highlights/`
+- Book collection integration for Bridgetown sites
+- Comprehensive test suite with 27 tests covering CLI, pagination, API integration, and error handling
+- Automation script for easy plugin installation
+- Support for environment variable and site config API key configuration
+
+### Features
+- **CLI Interface**: Thor-based command-line interface with intuitive menus
+- **Pagination**: Smart pagination for large book collections (10 items per page)
+- **Highlight Selection**: Multi-select interface with preview and filtering
+- **Data Integration**: Seamless integration with Bridgetown's data layer
+- **Error Handling**: Robust error handling for API failures and missing configuration
+- **Testing**: Full test coverage including unit, integration, and error handling tests

data/Gemfile

@@ -0,0 +1,12 @@
+# frozen_string_literal: true
+
+source "https://rubygems.org"
+gemspec
+
+gem "bridgetown", ENV["BRIDGETOWN_VERSION"] if ENV["BRIDGETOWN_VERSION"]
+
+group :test do
+  gem "minitest"
+  gem "minitest-profile"
+  gem "minitest-reporters"
+end

data/LICENSE.txt

@@ -0,0 +1,22 @@
+The MIT License (MIT)
+
+Copyright (c) 2020-present
+
+Permission is hereby granted, free of charge, to any person obtaining
+a copy of this software and associated documentation files (the
+"Software"), to deal in the Software without restriction, including
+without limitation the rights to use, copy, modify, merge, publish,
+distribute, sublicense, and/or sell copies of the Software, and to
+permit persons to whom the Software is furnished to do so, subject to
+the following conditions:
+
+The above copyright notice and this permission notice shall be
+included in all copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND,
+EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF
+MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND
+NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE
+LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION
+OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION
+WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.

data/README.md

@@ -0,0 +1,114 @@
+# Bridgetown Readwise Curator
+
+A Bridgetown plugin to curate and manage your Readwise highlights directly within your Bridgetown site.
+
+## Installation
+
+### Recommended: Automated Setup
+
+Run the automation script for guided setup that handles everything automatically:
+
+```shell
+bin/bridgetown apply https://github.com/pablojimeno/bridgetown_readwise_curator
+```
+
+This will:
+- Add the gem to your Gemfile
+- Install dotenv for environment variable management
+- Prompt for your Readwise API token
+- Set up all necessary configuration files
+- Create required directories
+
+### Manual Installation
+
+Alternatively, you can install manually:
+
+1. Add the gem to your Gemfile:
+```shell
+bundle add bridgetown_readwise_curator
+```
+
+2. Set up environment variables:
+
+Ensure `READWISE_TOKEN` is available in your environment using your preferred method (figaro, rails credentials, etc.)
+
+For example, using dotenv:
+```shell
+bundle add dotenv
+```
+Add your [Readwise API token](https://readwise.io/access_token) to `.env`:
+```
+READWISE_TOKEN=your_readwise_api_token_here
+```
+Add dotenv initializer to `config/initializers.rb`:
+```ruby
+init :dotenv
+```
+
+3. Add to `config/boot.rb`:
+```ruby
+require "bridgetown_readwise_curator"
+```
+
+4. Add the gem initializer to `config/initializers.rb`:
+```ruby
+init :bridgetown_readwise_curator
+```
+
+5. Create required directories:
+```shell
+mkdir -p src/_data/readwise
+mkdir -p src/_books
+```
+
+6. Run bundle install:
+```shell
+bundle install
+```
+
+## Usage
+
+### CLI Commands
+
+The plugin provides an interactive CLI accessible via:
+
+```shell
+bin/bt readwise
+```
+
+This launches an interactive menu with options to:
+- **Browse resources**: Paginated view of your Readwise library
+- **Search resources**: Find books by title or author
+- **Update Readwise data**: Sync latest data from Readwise API
+- **Quit**: Exit the CLI
+
+### Features
+
+- Interactive CLI for browsing and curating Readwise highlights
+- Search functionality across your book library  
+- Pagination for large libraries
+- Data synchronization with Readwise API
+- JSON file generation of selected highlights
+- Book page creation for curated highlights
+
+### Workflow
+
+1. Run `bin/bt readwise` to start the CLI
+2. Choose "Update Readwise data" to sync your library
+3. Browse or search for books you want to curate
+4. Select highlights from the chosen book
+5. The plugin generates markdown files in `src/_books/` with your curated highlights
+
+## Testing
+
+* Run `bundle exec rake test` to run the test suite
+* Or run `script/cibuild` to validate with Rubocop and Minitest together.
+
+## Contributing
+
+1. Fork it (https://github.com/pablojimeno/bridgetown_readwise_curator/fork)
+2. Clone the fork using `git clone` to your local development machine.
+3. Create your feature branch (`git checkout -b my-new-feature`)
+4. Commit your changes (`git commit -am 'Add some feature'`)
+5. Push to the branch (`git push origin my-new-feature`)
+6. Create a new Pull Request

data/Rakefile

@@ -0,0 +1,11 @@
+require "bundler/gem_tasks"
+require "rake/testtask"
+
+Rake::TestTask.new(:test) do |t|
+  t.libs << "test"
+  t.libs << "lib"
+  t.test_files = FileList["test/**/test_*.rb"]
+  t.warning = false
+end
+
+task :default => :test

data/bridgetown.automation.rb

@@ -0,0 +1,72 @@
+# Bridgetown Readwise Curator Plugin Setup Automation
+say_status :readwise, "Setting up Bridgetown Readwise Curator plugin..."
+
+# Add the gem to Gemfile
+add_gem "bridgetown_readwise_curator"
+
+# Prompt for Readwise API token
+api_token = ask "Please enter your Readwise API token (get it from https://readwise.io/access_token):"
+
+# Create or update .env file with the API token
+create_file ".env" do
+  if File.exist?(".env")
+    existing_content = File.read(".env")
+    if existing_content.include?("READWISE_TOKEN")
+      # Update existing token
+      updated_content = existing_content.gsub(/READWISE_TOKEN=.*/, "READWISE_TOKEN=#{api_token}")
+      updated_content
+    else
+      # Add token to existing file
+      "#{existing_content.chomp}\nREADWISE_TOKEN=#{api_token}\n"
+    end
+  else
+    # Create new .env file
+    "READWISE_TOKEN=#{api_token}\n"
+  end
+end
+
+
+# Add the readwise curator initializer
+add_initializer :"bridgetown_readwise_curator" do
+  <<~RUBY
+    # Bridgetown Readwise Curator configuration
+    # The API key will be automatically loaded from ENV['READWISE_TOKEN']
+  RUBY
+end
+
+# Add gem require to config/boot.rb
+create_file "config/boot.rb" do
+  if File.exist?("config/boot.rb")
+    existing_content = File.read("config/boot.rb")
+    unless existing_content.include?("bridgetown_readwise_curator")
+      "#{existing_content.chomp}\nrequire \"bridgetown_readwise_curator\"\n"
+    else
+      existing_content
+    end
+  else
+    "# config/boot.rb\nrequire \"bridgetown_readwise_curator\"\n"
+  end
+end
+
+# Ensure .env is in .gitignore
+gitignore_content = File.exist?(".gitignore") ? File.read(".gitignore") : ""
+unless gitignore_content.include?(".env")
+  append_to_file ".gitignore", "\n# Environment variables\n.env\n"
+end
+
+# Create data directory for Readwise data
+empty_directory "src/_data/readwise"
+
+# Create books collection directory
+empty_directory "src/_books"
+
+say_status :readwise, "Plugin setup complete!"
+say_status :readwise, "Run 'bundle install' to install dependencies"
+say_status :readwise, ""
+say_status :readwise, "IMPORTANT: Set up environment variables for READWISE_TOKEN"
+say_status :readwise, "The .env file has been created, but you may need to:"
+say_status :readwise, "1. Add 'dotenv' gem if you want to use .env files"
+say_status :readwise, "2. Add 'init :dotenv' to config/initializers.rb"
+say_status :readwise, "3. Or use your preferred environment management solution"
+say_status :readwise, ""
+say_status :readwise, "You can now run 'bin/bt readwise' to start curating highlights"

data/bridgetown_readwise_curator.gemspec

@@ -0,0 +1,34 @@
+# frozen_string_literal: true
+
+require_relative "lib/readwise_curator/version"
+
+Gem::Specification.new do |spec|
+  spec.name          = "bridgetown_readwise_curator"
+  spec.version       = ReadwiseCurator::VERSION
+  spec.author        = "Pablo Jimeno"
+  spec.email         = "hello@pablojimeno.com"
+  spec.summary       = "Curate Readwise highlights for Bridgetown sites"
+  spec.description   = "A Bridgetown plugin that provides an interactive CLI to curate and manage Readwise highlights directly within your Bridgetown site."
+  spec.homepage      = "https://github.com/pablojimeno/bridgetown_readwise_curator"
+  spec.license       = "MIT"
+
+  spec.files         = `git ls-files -z`.split("\x0").reject { |f| f.match(%r!^(test|script|spec|features|frontend)/!) }
+  spec.test_files    = spec.files.grep(%r!^test/!)
+  spec.require_paths = ["lib"]
+  spec.metadata         = {
+    "bridgetown_plugin" => "true",
+    "source_code_uri" => spec.homepage,
+    "bug_tracker_uri" => "#{spec.homepage}/issues",
+    "changelog_uri"   => "#{spec.homepage}/releases",
+    "homepage_uri"    => spec.homepage
+  }
+  
+  spec.required_ruby_version = ">= 2.7.0"
+
+  spec.add_dependency "bridgetown", ">= 2.0.0.beta5", "< 3.0"
+  spec.add_dependency "tty-prompt", "~> 0.23"
+
+  spec.add_development_dependency "bundler"
+  spec.add_development_dependency "rake", ">= 13.0"
+  spec.add_development_dependency "rubocop-bridgetown", "~> 0.3"
+end

data/components/readwise_curator/layout_help.liquid

@@ -0,0 +1 @@
+<p>Just use <code>layout: readwise_curator/layout</code> in your page's front matter.</p>

data/components/readwise_curator/plugin_component.rb

@@ -0,0 +1,17 @@
+# rubocop:disable all
+module ReadwiseCurator
+  class PluginComponent < Bridgetown::Component
+    def initialize(hi:)
+      @hi = hi
+    end
+
+    # You can remove this and add an ERB, Serbea, etc. template file…or you can
+    # use something like Phlex if you're feeling adventurous!
+    def template
+      <<~HTML
+        Well hello there #{hi}!
+      HTML
+    end
+  end
+end
+# rubocop:enable all

data/content/readwise_curator/example_page.md

@@ -0,0 +1,8 @@
+---
+layout: default
+title: Example Page
+---
+
+If all goes well, this page will be accessible as [`{{ resource.data.relative_url }}`]({{ resource.data.relative_url }}), and you will see a photo of a train:
+
+![Train on Rails]({{ "/readwise_curator/train-on-rails.jpeg" | relative_url }})

data/layouts/readwise_curator/layout.html

@@ -0,0 +1,9 @@
+---
+layout: default
+---
+
+<p>You can include this layout in your site! 🥳</p>
+
+{% render "readwise_curator/layout_help" %}
+
+{{ content }}

data/lib/bridgetown_readwise_curator.rb

@@ -0,0 +1,24 @@
+# frozen_string_literal: true
+
+require "bridgetown"
+
+# Load core components
+require_relative "readwise_curator/version"
+require_relative "readwise_curator/cli_helpers"
+require_relative "readwise_curator/builder"
+require_relative "readwise_curator/highlight_service"
+require_relative "readwise_curator/cli"
+
+# Register CLI command
+Bridgetown::Commands::Registrations.register do
+  desc "readwise", "Interactively curate Readwise highlights"
+  define_method :readwise do
+    ReadwiseCurator::CLI.start(["curate"])
+  end
+end
+
+# Configuration initializer
+Bridgetown.initializer :bridgetown_readwise_curator do |config|
+  config.readwise_curator ||= {}
+  config.readwise_curator.api_key ||= ENV.fetch("READWISE_TOKEN", nil)
+end

data/lib/readwise_curator/builder.rb

@@ -0,0 +1,46 @@
+# frozen_string_literal: true
+
+require "json"
+require "fileutils"
+
+module ReadwiseCurator
+  class Builder < Bridgetown::Builder
+    priority :low # Run after config load, but early
+
+    def build
+      api_key = config.readwise_curator&.api_key || ENV.fetch("READWISE_TOKEN", nil)
+      raise "Readwise API key not configured" unless api_key
+
+      all_books = fetch_all_books(api_key)
+      books_data = JSON.pretty_generate({
+        "count"    => all_books.length,
+        "next"     => nil,
+        "previous" => nil,
+        "results"  => all_books,
+      })
+
+      # Write consolidated response to _data/readwise/books.json
+      data_dir = File.join(site.root_dir, "src/_data/readwise")
+      FileUtils.mkdir_p(data_dir)
+      File.write(File.join(data_dir, "books.json"), books_data)
+    end
+
+    private
+
+    def fetch_all_books(api_key)
+      all_books = []
+      next_url = "https://readwise.io/api/v2/books/"
+
+      while next_url
+        response = get(next_url, headers: { "Authorization" => "Token #{api_key}" }) do |data|
+          data
+        end
+
+        all_books.concat(response["results"])
+        next_url = response["next"]
+      end
+
+      all_books
+    end
+  end
+end

data/lib/readwise_curator/cli.rb

@@ -0,0 +1,341 @@
+# frozen_string_literal: true
+
+require "thor"
+require "tty-prompt"
+require "tty-reader"
+require "json"
+require_relative "cli_helpers"
+
+# Environment variables are expected to be loaded by the host application
+
+module ReadwiseCurator
+  class CLI < Thor
+    include CLIHelpers
+
+    def self.exit_on_failure?
+      true
+    end
+
+    desc "curate", "Interactively curate Readwise highlights"
+    default_task :curate
+
+    def curate
+      prompt = TTY::Prompt.new
+      site = setup_site
+
+      loop do
+        action = prompt_for_action
+
+        case action
+        when :browse
+          browse_resources(prompt, site)
+        when :search
+          search_resources(prompt, site)
+        when :update
+          update_readwise_data(site)
+        when :quit
+          Bridgetown.logger.info "Goodbye!"
+          exit
+        end
+      end
+    end
+
+    private
+
+    def setup_site
+      site = Bridgetown::Site.new(Bridgetown.configuration)
+      site.read
+      site
+    end
+
+    def prompt_for_action
+      TTY::Prompt.new.select("What would you like to do?", [
+        { name: "» Browse resources", value: :browse },
+        { name: "» Search resources", value: :search },
+        { name: "» Update Readwise data", value: :update },
+        { name: "» Quit", value: :quit },
+      ])
+    end
+
+    def update_readwise_data(site)
+      builder = ReadwiseCurator::Builder.new(site)
+      builder.build
+      Bridgetown.logger.info "Books data updated."
+    end
+
+    def browse_resources(prompt, site)
+      service = create_highlight_service(site)
+      choices = build_book_choices(site)
+
+      loop do
+        book_id = select_book_with_pagination(prompt, choices)
+
+        # Handle special return values
+        return if book_id == :back_to_menu
+
+        highlights = fetch_book_highlights(service, book_id)
+
+        if highlights.empty?
+          handle_empty_highlights
+          prompt.keypress("Press any key to continue...")
+          next
+        end
+
+        selected_highlight_ids = select_highlights(prompt, service, book_id, highlights)
+
+        next if selected_highlight_ids.nil?
+
+        save_selected_highlights(service, book_id, highlights, selected_highlight_ids)
+        return
+      end
+    end
+
+    def search_resources(prompt, site)
+      service = create_highlight_service(site)
+      choices = build_book_choices(site)
+      search_result = search_books(prompt, choices)
+      return unless search_result.is_a?(Integer)
+
+      highlights = fetch_book_highlights(service, search_result)
+
+      if highlights.empty?
+        handle_empty_highlights
+        return
+      end
+
+      selected_highlight_ids = select_highlights(prompt, service, search_result, highlights)
+      return if selected_highlight_ids.nil?
+
+      save_selected_highlights(service, search_result, highlights, selected_highlight_ids)
+    end
+
+    def select_book_with_pagination(_prompt, choices)
+      reader = TTY::Reader.new
+      paginator = BookPaginator.new(choices)
+
+      loop do
+        display_pagination_page(paginator, choices)
+        key = reader.read_keypress(nonblock: false)
+        result = handle_pagination_input(key, paginator)
+        return result if result
+      end
+    end
+
+    def display_pagination_page(paginator, choices)
+      clear_screen
+      show_pagination_header(
+        choices, paginator.current_page, paginator.total_pages, paginator.page_size
+      )
+      display_page_items(paginator)
+      display_pagination_instructions
+    end
+
+    def display_page_items(paginator)
+      page_items = paginator.send(:page_choices)
+      page_items.each_with_index do |item, index|
+        Bridgetown.logger.info "[#{index}] #{item[:name]}"
+      end
+    end
+
+    def display_pagination_instructions
+      Bridgetown.logger.info "\nPress: [0-9] to select resource, [j/k] to paginate, " \
+                             "[↩︎ Enter] to go back to the menu"
+    end
+
+    def handle_pagination_input(key, paginator)
+      case key
+      when "j"
+        handle_next_page(paginator)
+      when "k"
+        handle_prev_page(paginator)
+      when %r{^[0-9]$}
+        handle_number_selection(key, paginator)
+      when "\r", "\n"
+        :back_to_menu
+      when "q"
+        exit
+      end
+    end
+
+    def handle_next_page(paginator)
+      return unless paginator.current_page < paginator.total_pages - 1
+
+      paginator.handle_selection(:next_page)
+    end
+
+    def handle_prev_page(paginator)
+      return unless paginator.current_page.positive?
+
+      paginator.handle_selection(:prev_page)
+    end
+
+    def handle_number_selection(key, paginator)
+      idx = key.to_i
+      page_items = paginator.send(:page_choices)
+      selected_item = page_items[idx]
+      selected_item[:value] if selected_item
+    end
+
+    class BookPaginator
+      attr_reader :choices, :current_page, :page_size
+
+      def initialize(choices, page_size = 10)
+        @choices = choices || []
+        @page_size = page_size
+        @current_page = 0
+      end
+
+      def total_pages
+        return 1 if @choices.empty?
+
+        (@choices.length.to_f / @page_size).ceil
+      end
+
+      def handle_selection(selection)
+        case selection
+        when :prev_page
+          @current_page = [@current_page - 1, 0].max
+        when :next_page
+          @current_page = [@current_page + 1, total_pages - 1].min
+        else
+          return selection # Book selection
+        end
+        nil # Continue pagination
+      end
+
+      private
+
+      def page_choices
+        return [] if @choices.empty?
+
+        start_idx = @current_page * @page_size
+        end_idx = [start_idx + @page_size - 1, @choices.length - 1].min
+        @choices[start_idx..end_idx] || []
+      end
+    end
+
+    def search_books(prompt, choices)
+      search_term = prompt.ask("Enter search term (title or author):") do |q|
+        q.required(true)
+      end
+
+      filtered_choices = filter_choices_by_search_term(choices, search_term)
+
+      if filtered_choices.empty?
+        handle_empty_search_results(prompt, choices, search_term)
+      else
+        display_search_results(prompt, choices, filtered_choices, search_term)
+      end
+    end
+
+    def filter_choices_by_search_term(choices, search_term)
+      choices.select do |choice|
+        matches_title_or_author?(choice, search_term)
+      end
+    end
+
+    def matches_title_or_author?(choice, search_term)
+      matches_title?(choice, search_term) || matches_author?(choice, search_term)
+    end
+
+    def matches_title?(choice, search_term)
+      choice[:title]&.downcase&.include?(search_term.downcase) || false
+    end
+
+    def matches_author?(choice, search_term)
+      choice[:author]&.downcase&.include?(search_term.downcase) || false
+    end
+
+    def handle_empty_search_results(prompt, _choices, search_term)
+      Bridgetown.logger.info "No books found matching '#{search_term}'"
+      prompt.keypress("Press any key to continue...")
+      # Return nil to go back to main menu instead of browse resources
+      nil
+    end
+
+    def display_search_results(prompt, choices, filtered_choices, search_term)
+      clear_screen
+      Bridgetown.logger.info "\n🔍 Search results for '#{search_term}' " \
+                             "(#{filtered_choices.length} found)\n\n"
+
+      search_choices = filtered_choices + [{ name: "← Back to full list", value: :back }]
+      selection = prompt.select("Select a book:", search_choices)
+
+      selection == :back ? select_book_with_pagination(prompt, choices) : selection
+    end
+
+    def create_highlight_service(site)
+      ReadwiseCurator::HighlightService.new(site)
+    end
+
+    def fetch_book_highlights(service, book_id)
+      service.fetch_highlights_for_book(book_id)
+    end
+
+    def build_book_choices(site)
+      books = site.data.dig("readwise", "books", "results") || []
+      books.map do |book|
+        slug = book["slug"]
+        has_page = File.exist?(File.join(site.root_dir, "src/_books/#{slug}.md"))
+
+        category_icon = get_category_icon(book["category"])
+        page_indicator = has_page ? "* " : ""
+
+        label = "#{category_icon} #{page_indicator}#{book["title"]} by #{book["author"]}"
+        { name: label, value: book["id"], title: book["title"], author: book["author"] }
+      end
+    end
+
+    def select_highlights(prompt, service, book_id, highlights)
+      selected_ids = load_existing_selections(service, book_id)
+      highlight_choices = build_highlight_choices(highlights, selected_ids)
+
+      Bridgetown.logger.info "\n📖 Found #{highlights.length} highlights for this book. " \
+                             "Select highlights to curate:"
+
+      result = prompt.multi_select("", highlight_choices,
+                                   per_page: 10, echo: false,
+                                   symbols: { marker: "‣", radio_on: "⬢", radio_off: "⬡" })
+
+      Bridgetown.logger.info "\nUse [↑/↓] to navigate, [SPACE] to select/deselect, " \
+                             "[↩︎ ENTER] when ✅ done."
+      Bridgetown.logger.info "Press [Ctrl+C] to go back to book selection."
+      result
+    rescue TTY::Reader::InputInterrupt
+      # User pressed Ctrl+C, return nil to go back to book selection
+      nil
+    end
+
+    def load_existing_selections(service, book_id)
+      service.load_existing_selections(book_id)
+    end
+
+    def build_highlight_choices(highlights, selected_ids)
+      highlights.map do |h|
+        snippet = h["text"][0, 80]
+        snippet += "..." if h["text"].length > 80
+        {
+          name: snippet,
+          value: h["id"],
+          checked: selected_ids.include?(h["id"]),
+        }
+      end
+    end
+
+    def save_selected_highlights(service, book_id, highlights, selected_highlight_ids)
+      return handle_no_selection if selected_highlight_ids.empty?
+
+      curated_highlights = filter_selected_highlights(highlights, selected_highlight_ids)
+      saved_file = save_highlights_to_file(service, book_id, curated_highlights)
+      log_save_success(saved_file)
+    end
+
+    def filter_selected_highlights(highlights, selected_ids)
+      highlights.select { |h| selected_ids.include?(h["id"]) }
+    end
+
+    def save_highlights_to_file(service, book_id, highlights)
+      service.save_curated_highlights(book_id, highlights)
+    end
+  end
+end

data/lib/readwise_curator/cli_helpers.rb

@@ -0,0 +1,61 @@
+# frozen_string_literal: true
+
+module ReadwiseCurator
+  module CLIHelpers
+    def clear_screen
+      system("clear") || system("cls")
+    end
+
+    def show_pagination_header(choices, current_page, total_pages, page_size)
+      start_item = (current_page * page_size) + 1
+      end_item = [((current_page + 1) * page_size), choices.length].min
+
+      Bridgetown.logger.info "\n📚 Readwise Library (#{choices.length} items)"
+      Bridgetown.logger.info "Icons: 📚 Books • 📄 Articles • 🐦 Tweets • 🎧 Podcasts • 📋 Supplementals"
+      Bridgetown.logger.info "* indicates existing page"
+      Bridgetown.logger.info "Page #{current_page + 1}/#{total_pages} " \
+                             "(showing #{start_item}-#{end_item})\n\n"
+    end
+
+    def display_book_count(count)
+      Bridgetown.logger.info "\n📚 Found #{count} items in your Readwise library"
+      Bridgetown.logger.info "Icons: 📚 Books • 📄 Articles • 🐦 Tweets • 🎧 Podcasts • 📋 Supplementals"
+      Bridgetown.logger.info "* indicates existing page • Use ↑/↓ to navigate, ENTER to select\n\n"
+    end
+
+    def get_category_icon(category)
+      case category&.downcase
+      when "books"
+        "📚"
+      when "tweets"
+        "🐦"
+      when "podcasts"
+        "🎧"
+      when "supplementals"
+        "📋"
+      else
+        "📄"
+      end
+    end
+
+    def handle_empty_highlights
+      Bridgetown.logger.info "\n📖 Found 0 highlights for this book"
+      Bridgetown.logger.info "This book has no highlights to curate."
+    end
+
+    def display_highlight_instructions(highlight_count)
+      Bridgetown.logger.info "\n📖 Found #{highlight_count} highlights for this book"
+      Bridgetown.logger.info "Use [↑/↓] to navigate, [SPACE] to select/deselect, " \
+                             "[↩︎ ENTER] when ✅ done."
+      Bridgetown.logger.info "Press [Ctrl+C] to go back to book selection.\n\n"
+    end
+
+    def handle_no_selection
+      Bridgetown.logger.info "No highlights selected."
+    end
+
+    def log_save_success(saved_file)
+      Bridgetown.logger.info "Curated highlights saved to #{saved_file}."
+    end
+  end
+end

data/lib/readwise_curator/highlight_service.rb

@@ -0,0 +1,66 @@
+# frozen_string_literal: true
+
+require "net/http"
+require "uri"
+require "json"
+require "fileutils"
+
+module ReadwiseCurator
+  class HighlightService
+    attr_reader :site, :api_key
+
+    def initialize(site, options = {})
+      @site = site
+      @api_key = options[:api_key] || site.config.readwise_curator&.api_key || ENV.fetch(
+        "READWISE_TOKEN", nil
+      )
+      raise "Readwise API key not configured" unless @api_key
+    end
+
+    def fetch_highlights_for_book(book_id)
+      highlights = []
+      next_url = "https://readwise.io/api/v2/highlights/?book_id=#{book_id}"
+
+      while next_url
+        response = make_request(next_url)
+        highlights.concat(response["results"])
+        next_url = response["next"]
+      end
+
+      highlights
+    end
+
+    def save_curated_highlights(book_id, highlights)
+      curated_dir = File.join(site.root_dir, "src/_data/readwise/curated_highlights")
+      FileUtils.mkdir_p(curated_dir)
+
+      curated_file = File.join(curated_dir, "#{book_id}.json")
+      minimal = highlights.map { |h| h.slice("id", "text", "note", "highlighted_at") }
+
+      File.write(curated_file, JSON.pretty_generate(minimal))
+      curated_file
+    end
+
+    def load_existing_selections(book_id)
+      curated_dir = File.join(site.root_dir, "src/_data/readwise/curated_highlights")
+      curated_file = File.join(curated_dir, "#{book_id}.json")
+
+      return [] unless File.exist?(curated_file)
+
+      JSON.parse(File.read(curated_file)).map { |h| h["id"] }
+    end
+
+    private
+
+    def make_request(url)
+      uri = URI(url)
+      http = Net::HTTP.new(uri.host, uri.port)
+      http.use_ssl = true
+      request = Net::HTTP::Get.new(uri)
+      request["Authorization"] = "Token #{@api_key}"
+
+      response = http.request(request)
+      JSON.parse(response.body)
+    end
+  end
+end

data/lib/readwise_curator/version.rb

@@ -0,0 +1,5 @@
+# frozen_string_literal: true
+
+module ReadwiseCurator
+  VERSION = "0.1.0"
+end

data/logfile

@@ -0,0 +1,9 @@
+2025-08-13 09:08:11.135 CEST [6019] LOG:  starting PostgreSQL 17.4 on aarch64-apple-darwin24.3.0, compiled by Apple clang version 16.0.0 (clang-1600.0.26.6), 64-bit
+2025-08-13 09:08:11.226 CEST [6019] LOG:  listening on IPv6 address "::1", port 5432
+2025-08-13 09:08:11.226 CEST [6019] LOG:  listening on IPv6 address "fe80::1%lo0", port 5432
+2025-08-13 09:08:11.226 CEST [6019] LOG:  listening on IPv4 address "127.0.0.1", port 5432
+2025-08-13 09:08:11.227 CEST [6019] LOG:  listening on Unix socket "/tmp/.s.PGSQL.5432"
+2025-08-13 09:08:11.343 CEST [6092] LOG:  database system was shut down at 2025-08-10 18:44:21 CEST
+2025-08-13 09:08:11.428 CEST [6019] LOG:  database system is ready to accept connections
+2025-08-13 09:13:11.272 CEST [6082] LOG:  checkpoint starting: time
+2025-08-13 09:13:11.279 CEST [6082] LOG:  checkpoint complete: wrote 3 buffers (0.0%); 0 WAL file(s) added, 0 removed, 0 recycled; write=0.002 s, sync=0.001 s, total=0.010 s; sync files=2, longest=0.001 s, average=0.001 s; distance=0 kB, estimate=0 kB; lsn=0/15527A8, redo lsn=0/1552750

data/package.json

@@ -0,0 +1,16 @@
+{
+  "name": "readwise_curator",
+  "version": "0.1.0",
+  "main": "frontend/javascript/index.js",
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/username/readwise_curator.git"
+  },
+  "author": "Bridgetown Maintainers <maintainers@bridgetownrb.com>",
+  "homepage": "https://www.bridgetownrb.com",
+  "license": "MIT",
+  "private": false,
+  "files": [
+    "frontend"
+  ]
+}

metadata

@@ -0,0 +1,147 @@
+--- !ruby/object:Gem::Specification
+name: bridgetown_readwise_curator
+version: !ruby/object:Gem::Version
+  version: 0.1.0
+platform: ruby
+authors:
+- Pablo Jimeno
+autorequire:
+bindir: bin
+cert_chain: []
+date: 2025-08-30 00:00:00.000000000 Z
+dependencies:
+- !ruby/object:Gem::Dependency
+  name: bridgetown
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: 2.0.0.beta5
+    - - "<"
+      - !ruby/object:Gem::Version
+        version: '3.0'
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: 2.0.0.beta5
+    - - "<"
+      - !ruby/object:Gem::Version
+        version: '3.0'
+- !ruby/object:Gem::Dependency
+  name: tty-prompt
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '0.23'
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '0.23'
+- !ruby/object:Gem::Dependency
+  name: bundler
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '0'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '0'
+- !ruby/object:Gem::Dependency
+  name: rake
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '13.0'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '13.0'
+- !ruby/object:Gem::Dependency
+  name: rubocop-bridgetown
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '0.3'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '0.3'
+description: A Bridgetown plugin that provides an interactive CLI to curate and manage
+  Readwise highlights directly within your Bridgetown site.
+email: hello@pablojimeno.com
+executables: []
+extensions: []
+extra_rdoc_files: []
+files:
+- ".github/workflows/tests.yml"
+- ".gitignore"
+- ".rubocop.yml"
+- CHANGELOG.md
+- Gemfile
+- LICENSE.txt
+- README.md
+- Rakefile
+- bridgetown.automation.rb
+- bridgetown_readwise_curator.gemspec
+- components/readwise_curator/layout_help.liquid
+- components/readwise_curator/plugin_component.rb
+- content/readwise_curator/example_page.md
+- content/readwise_curator/train-on-rails.jpeg
+- layouts/readwise_curator/layout.html
+- lib/bridgetown_readwise_curator.rb
+- lib/readwise_curator/builder.rb
+- lib/readwise_curator/cli.rb
+- lib/readwise_curator/cli_helpers.rb
+- lib/readwise_curator/highlight_service.rb
+- lib/readwise_curator/version.rb
+- logfile
+- package.json
+homepage: https://github.com/pablojimeno/bridgetown_readwise_curator
+licenses:
+- MIT
+metadata:
+  bridgetown_plugin: 'true'
+  source_code_uri: https://github.com/pablojimeno/bridgetown_readwise_curator
+  bug_tracker_uri: https://github.com/pablojimeno/bridgetown_readwise_curator/issues
+  changelog_uri: https://github.com/pablojimeno/bridgetown_readwise_curator/releases
+  homepage_uri: https://github.com/pablojimeno/bridgetown_readwise_curator
+post_install_message:
+rdoc_options: []
+require_paths:
+- lib
+required_ruby_version: !ruby/object:Gem::Requirement
+  requirements:
+  - - ">="
+    - !ruby/object:Gem::Version
+      version: 2.7.0
+required_rubygems_version: !ruby/object:Gem::Requirement
+  requirements:
+  - - ">="
+    - !ruby/object:Gem::Version
+      version: '0'
+requirements: []
+rubygems_version: 3.4.19
+signing_key:
+specification_version: 4
+summary: Curate Readwise highlights for Bridgetown sites
+test_files: []