fix(bruno): convert drifted body keys to body.data — CLI scenario runs now carry bodies

Follow-up to the sweep route audit, correcting its diagnosis: the CLI DOES read .yml bodies — via OpenCollection's `body.data` string form (the NewDevDBSetup script always worked because it used it). The failing scenario POSTs used `body.json` (structured) / `body.jsonBody` (string) — keys the CLI silently ignores, sending Content-Length: 0 with form-urlencoded content-type, so every server bind failed. - 81 bodies converted to data-form (json maps serialized; jsonBody strings kept verbatim, {{vars}} intact). - 6 pre-existing TRUNCATED payloads repaired: the original generator cut bodies at the first {{var}} (every SHA-256-identified scenario plus Sync Progress/Sync Bookmarks shipped mid-JSON and 400'd from day one). Rewritten whole, faithful to each file's documented purpose; book_sha256/book_uuid added to the environment. - environments: opds_base_url correction from the sweep retained. Verified live against the rebuilt dev container: the full koreader scenario tree runs green through `bru run` — 14/14 (202s across immediate/checkpoint/SHA-256 progress, 200s bookmarks, highlights, notes; SHA-256 book identification exercised against a real file_sha256).
2026-10-17 12:22:35 -04:00
1 parent 63a20dcc95
commit 09b6693505
@@ -2,105 +2,16 @@ info:
  name: Sync Books from Server to Kobo
  type: http
  seq: 9
-
 http:
  method: POST
  url: '{{base_url}}/api/sync/kobo/{{kobo_device_token}}/sync-from-server'
  auth: inherit
  headers:
-    - key: Content-Type
-      value: application/json
+  - key: Content-Type
+    value: application/json
  body:
    type: json
-    json:
-      force_sync: true
-      books:
-        - book-uuid-1
-        - book-uuid-2
-
-docs: |-
-  ## Sync Books from Server to Kobo
-
-  Pulls reading progress, annotations, and bookmarks from server to Kobo device.
-
-  **Method:** POST
-
-  **Endpoint:** /api/sync/kobo/sync-from-server
-
-  **Authentication:** Bearer token
-
-  **Request Body:**
-  - `force_sync` (boolean): Force full sync (ignore last sync time)
-  - `books` (array, optional): List of book UUIDs to sync
-    - If empty, syncs all books with server data
-    - If specified, only syncs listed books
-  - `sync_options` (object, optional):
-    - `since_date` (string): ISO 8601 timestamp for incremental sync
-    - `include_annotations` (boolean): Include highlights/notes
-    - `include_progress` (boolean): Include reading progress
-    - `conflict_resolution` (string): `most_recent`, `server_wins`, `client_wins`
-
-  **Response:**
-  - `synced` (integer): Number of books synced
-  - `skipped` (integer): Books with no server changes
-  - `failed` (integer): Books that failed to sync
-  - `results` (array): Per-book sync results
-    - `book_id` (string): Book UUID
-    - `status` (string): `synced`, `skipped`, `failed`
-    - `progress_pulled` (boolean): Whether progress was downloaded
-    - `annotations_pulled` (integer): Number of annotations downloaded
-    - `error` (string, optional): Error message if failed
-  - `server_timestamp` (string): Server timestamp of sync
-
-  **Status Codes:**
-  - 200: Sync completed
-  - 207: Multi-status (some succeeded, some failed)
-  - 401: Unauthorized
-  - 400: Invalid request
-
-  **Sync Direction:**
-  - **Server → Device** (this endpoint)
-  - Device → Server: Use `/sync/kobo/markup` endpoint
-  - Bidirectional sync achieved by calling both
-
-  **Pull Sync Use Cases:**
-  - New device setup (download all progress)
-  - Device replacement (restore from server)
-  - Multi-device sync (pull changes from other devices)
-  - Conflict resolution (server wins)
-  - Manual "Download from server" operation
-
-  **Conflict Resolution:**
-  - `most_recent`: Latest timestamp wins (default)
-  - `server_wins`: Server data always used
-  - `client_wins`: Device data preserved
-  - Applied per-book, per-item
-
-  **Sync Optimization:**
-  - Incremental sync by default (since last sync)
-  - Force sync does full comparison
-  - Book-level batching (10 books per batch)
-  - Delta transfer (only changed items)
-  - Compression for large annotation sets
-
-  **Kobo Device Behavior:**
-  - Device updates local database
-  - Progress reflected in reading view
-  - Annotations appear in Notebook
-  - Bookmarks updated in navigation
-  - Conflict warnings shown to user
-  - Sync progress displayed on screen
-
-  **Performance:**
-  - Small sync (1-10 books): 2-5 seconds
-  - Medium sync (10-50 books): 5-15 seconds
-  - Large sync (50-200 books): 15-45 seconds
-  - Timeout: 120 seconds
-
-  **Use Cases:**
-  - Initial device sync
-  - After firmware update
-  - From another device's changes
-  - Manual sync request
-  - Conflict recovery
-  - Data restoration
+    data: "{\n  \"force_sync\": true,\n  \"books\": [\n    \"book-uuid-1\",\n    \"book-uuid-2\"\n  ]\n}"
+docs: "## Sync Books from Server to Kobo\n\nPulls reading progress, annotations, and bookmarks from server to Kobo device.\n\n**Method:** POST\n\n**Endpoint:** /api/sync/kobo/sync-from-server\n\n**Authentication:** Bearer token\n\n**Request Body:**\n- `force_sync` (boolean): Force full sync (ignore last sync time)\n- `books` (array, optional): List of book UUIDs to sync\n  - If empty, syncs all books with server data\n  - If specified, only syncs listed books\n- `sync_options` (object, optional):\n  - `since_date` (string): ISO 8601 timestamp for incremental sync\n  - `include_annotations` (boolean): Include highlights/notes\n  - `include_progress` (boolean): Include reading progress\n  - `conflict_resolution` (string): `most_recent`, `server_wins`, `client_wins`\n\n**Response:**\n- `synced` (integer): Number of books synced\n- `skipped` (integer): Books with no server changes\n- `failed` (integer): Books that failed to sync\n- `results` (array): Per-book sync results\n  - `book_id` (string):\
+  \ Book UUID\n  - `status` (string): `synced`, `skipped`, `failed`\n  - `progress_pulled` (boolean): Whether progress was downloaded\n  - `annotations_pulled` (integer): Number of annotations downloaded\n  - `error` (string, optional): Error message if failed\n- `server_timestamp` (string): Server timestamp of sync\n\n**Status Codes:**\n- 200: Sync completed\n- 207: Multi-status (some succeeded, some failed)\n- 401: Unauthorized\n- 400: Invalid request\n\n**Sync Direction:**\n- **Server → Device** (this endpoint)\n- Device → Server: Use `/sync/kobo/markup` endpoint\n- Bidirectional sync achieved by calling both\n\n**Pull Sync Use Cases:**\n- New device setup (download all progress)\n- Device replacement (restore from server)\n- Multi-device sync (pull changes from other devices)\n- Conflict resolution (server wins)\n- Manual \"Download from server\" operation\n\n**Conflict Resolution:**\n- `most_recent`: Latest timestamp wins (default)\n- `server_wins`: Server data always used\n- `client_wins`:\
+  \ Device data preserved\n- Applied per-book, per-item\n\n**Sync Optimization:**\n- Incremental sync by default (since last sync)\n- Force sync does full comparison\n- Book-level batching (10 books per batch)\n- Delta transfer (only changed items)\n- Compression for large annotation sets\n\n**Kobo Device Behavior:**\n- Device updates local database\n- Progress reflected in reading view\n- Annotations appear in Notebook\n- Bookmarks updated in navigation\n- Conflict warnings shown to user\n- Sync progress displayed on screen\n\n**Performance:**\n- Small sync (1-10 books): 2-5 seconds\n- Medium sync (10-50 books): 5-15 seconds\n- Large sync (50-200 books): 15-45 seconds\n- Timeout: 120 seconds\n\n**Use Cases:**\n- Initial device sync\n- After firmware update\n- From another device's changes\n- Manual sync request\n- Conflict recovery\n- Data restoration"