Bump CI action versions and sync CLAUDE.md with code

- Move actions/checkout v4->v6, actions/setup-go v5->v6,
  actions/upload-artifact v4->v7, and dorny/test-reporter v1->v3 to
  keep CI on the latest stable majors. All run on Node 24 and remain
  compatible with the existing workflow inputs.
- Correct CLAUDE.md drift: list mock.go in the project tree and the
  JMAP component, note the JMAPClient interface shared by the real
  and mock clients, and update the /api/emails reference to describe
  the InboxInfo response shape (emails, totalCount) and the
  limit/offset query parameters.

Author: taskinen

.github/workflows/test.yml

@@ -16,10 +16,10 @@ jobs:
 
     steps:
     - name: Checkout code
-      uses: actions/checkout@v4
+      uses: actions/checkout@v6
 
     - name: Set up Go
-      uses: actions/setup-go@v5
+      uses: actions/setup-go@v6
       with:
         go-version: '1.21'
         cache: true
@@ -42,10 +42,10 @@ jobs:
 
     steps:
     - name: Checkout code
-      uses: actions/checkout@v4
+      uses: actions/checkout@v6
 
     - name: Set up Go
-      uses: actions/setup-go@v5
+      uses: actions/setup-go@v6
       with:
         go-version: '1.21'
         cache: true
@@ -74,7 +74,7 @@ jobs:
         go tool cover -func=coverage.out | grep -v "total:" | awk '{print "| " $1 " | " $3 " |"}' | sort -u >> $GITHUB_STEP_SUMMARY
 
     - name: Test Report
-      uses: dorny/test-reporter@v1
+      uses: dorny/test-reporter@v3
       if: always()
       with:
         name: Go Test Results
@@ -84,7 +84,7 @@ jobs:
         fail-on-empty: true
 
     - name: Upload coverage to GitHub
-      uses: actions/upload-artifact@v4
+      uses: actions/upload-artifact@v7
       with:
         name: coverage-report
         path: coverage.out

CLAUDE.md

@@ -33,8 +33,9 @@ mailboxzero/
 │   ├── config/
 │   │   └── config.go          # Configuration loading and validation
 │   ├── jmap/
-│   │   ├── client.go          # JMAP client implementation
-│   │   └── email.go           # Email data structures and operations
+│   │   ├── client.go          # JMAP client implementation and JMAPClient interface
+│   │   ├── email.go           # Email data structures and operations
+│   │   └── mock.go            # MockClient with built-in sample data for mock mode
 │   ├── server/
 │   │   └── server.go          # HTTP server and API handlers
 │   └── similarity/
@@ -59,12 +60,13 @@ mailboxzero/
   - Default similarity threshold
 
 #### 2. JMAP Client (`internal/jmap/`)
-- **Files:** `client.go`, `email.go`
+- **Files:** `client.go`, `email.go`, `mock.go`
 - **Purpose:** Handles communication with Fastmail's JMAP API
 - **Features:**
+  - `JMAPClient` interface implemented by both the real `Client` and the in-memory `MockClient` (selected via `mock_mode` in config)
   - Session authentication with Bearer tokens
   - Mailbox discovery (inbox, archive)
-  - Email querying and retrieval with body content
+  - Email querying and retrieval with body content, including a paginated `GetInboxEmailsWithCountPaginated` used by the `/api/emails` endpoint
   - Safe archive operations (move to archive folder)
   - Comprehensive error handling
 
@@ -158,10 +160,10 @@ default_similarity: 75          # Default similarity percentage (0-100)
 ## API Endpoints
 
 ### GET /api/emails
-- **Purpose:** Retrieve inbox emails
-- **Response:** JSON array of email objects
-- **Limit:** 100 emails for performance
-- **Fields:** ID, subject, from, preview, receivedAt, bodyValues
+- **Purpose:** Retrieve inbox emails (paginated)
+- **Query Parameters:** `limit` (default 100) and `offset` (default 0)
+- **Response:** JSON object `{ "emails": [...], "totalCount": N }` (`InboxInfo`)
+- **Email Fields:** ID, subject, from, preview, receivedAt, bodyValues
 
 ### POST /api/similar
 - **Purpose:** Find similar emails