bruno: regenerate collection from canonical docs + permanent docs↔Bruno parity gate

WO4. The old collection was the drifted artifact AGENTS.md warned about: bodies pre-truncated at their first {{var}}, routes renamed server-side but not here (/api/notes/:media_id, /api/book-matching/search, /api/collections/:id/rules/test), an orphan universal-progress suite for routes that no longer exist. scripts/gen_bruno_from_docs.py emits one OpenCollection request per frontmatter'd endpoint doc (191 requests): gate-verified example-request JSON as body, {{env}} params per the environment file, device-token routes get an explicit Bearer {{device_token}} header, login/register/ refresh keep the token-capture after-response scripts that chain the collection. Old 1:1 mirrors deleted (128); hand-authored NewDevDBSetup, environments, and edge-case suites kept. 30 scenario files with truncated bodies (the documented corruption) deleted — they could not run. internal/docs/drift_test.go gains TestBrunoMirrorsDocs: every frontmatter'd doc must have a Bruno request with matching method+URL shape — the collection can never silently drift from the docs again. opencollection.yml README block replaced with the real run instructions. make test green (9 pkgs, parity test included in internal/docs).
2026-10-24 18:35:51 -04:00
1 parent 6fc501b35a
commit acd82fff0a
@@ -1,17 +0,0 @@
-info:
-  name: Auto-Link Unlinked Books
-  type: http
-  seq: 1
-http:
-  method: POST
-  url: '{{base_url}}/api/sync/auto-link-books'
-  auth: inherit
-  body:
-    type: json
-    data: "{\n    \"confidence_threshold\": 0.8,\n    \"limit\": 50"
-  headers:
-  - key: Content-Type
-    value: application/json
-  - key: Authorization
-    value: Bearer {{authToken
-docs: "## Auto-Link Unlinked Books\n\n  Automatically links unlinked books to media items based on title and author matching with a configurable confidence threshold.\n\n  **Method:** POST\n\n  **Endpoint:** /sync/auto-link-books\n\n  **Authentication:** Bearer token\n\n  **Request Body:**\n  - `confidence_threshold` (number, optional): Minimum confidence score for auto-linking (0-1, default: 0.8)\n  - `limit` (number, optional): Maximum number of books to auto-link (default: 50)\n\n  **Response:**\n  - `results` (array): Results for each auto-link attempt\n  - `total` (number): Total number of books processed\n  - `success` (number): Number of successful links\n  - `failed` (number): Number of failed links\n\n  **Status Codes:**\n  - 200: Success\n  - 400: Invalid request data\n  - 401: Unauthorized\n  - 500: Internal server error\n\n  **Note:** Higher confidence thresholds produce fewer but more accurate matches. Consider the tradeoff between automation and accuracy."
@@ -1,17 +0,0 @@
-info:
-  name: Bulk Link Unlinked Books
-  type: http
-  seq: 1
-http:
-  method: POST
-  url: '{{base_url}}/api/sync/bulk-link-books'
-  auth: inherit
-  body:
-    type: json
-    data: "{\n    \"links\": [\n      {\n        \"unlinked_book_id\": \"{{unlinkedBookId1"
-  headers:
-  - key: Content-Type
-    value: application/json
-  - key: Authorization
-    value: Bearer {{authToken
-docs: "## Bulk Link Unlinked Books\n\n  Links multiple unlinked books to media items in a single request.\n\n  **Method:** POST\n\n  **Endpoint:** /sync/bulk-link-books\n\n  **Authentication:** Bearer token\n\n  **Request Body:**\n  - `links` (array): Array of link objects\n    - `unlinked_book_id` (string): Unlinked book UUID\n    - `media_item_id` (string): Media item UUID to link to\n    - `confidence_score` (number): Match confidence (0-1)\n\n  **Response:**\n  - `results` (array): Results for each link attempt\n  - `total` (number): Total number of links processed\n  - `success` (number): Number of successful links\n  - `failed` (number): Number of failed links\n\n  **Status Codes:**\n  - 200: Success\n  - 400: Invalid request data\n  - 401: Unauthorized\n  - 500: Internal server error\n\n  **Note:** Use this endpoint after reviewing suggestions from the Get Unlinked Book Suggestions endpoint."
@@ -1,16 +0,0 @@
-info:
-  name: Sync from Bookhoard to Kobo
-  type: http
-  seq: 1
-http:
-  method: POST
-  url: '{{base_url}}/api/sync/kobo/{{kobo_device_token}}/sync-from-server'
-  auth: inherit
-  body:
-    type: json
-    data: "[\n    {\n      \"ContentId\": \"{{bookUUID"
-  headers:
-  - key: Authorization
-    value: Bearer {{koboToken
-docs: "## Sync from Bookhoard to Kobo\n\n  Server-initiated sync pushing progress, bookmarks, and highlights from Bookhoard to Kobo device. Two-way sync endpoint.\n\n  **Method:** POST\n\n  **Endpoint:** /api/sync/kobo/sync-from-server\n\n  **Authentication:** Bearer token with Kobo device identification\n\n  **Headers:**\n  - `x-kobo-device` (string): JSON string containing Kobo device info\n    - `DeviceId`: Kobo device ID\n    - `Model`: Kobo device model\n    - `SerialNumber`: Kobo device serial number\n\n  **Request Body:** Array of sync data objects\n  - `ContentId` (string): Book UUID\n  - `PercentRead` (number): Reading progress percentage (0-100)\n  - `LastModified` (string): ISO 8601 timestamp\n  - `Bookmarks` (array, optional): Array of bookmark objects\n    - `BookmarkId`: Unique bookmark ID\n    - `ContentId`: Book UUID\n    - `BookmarkText`: Bookmark text/note\n    - `BookmarkType`: Type (bookmark, annotation, etc.)\n    - `BookmarkTitle`: Bookmark title\n  - `Highlights` (array,\
-  \ optional): Array of highlight objects (same structure as bookmarks)\n\n  **Response:**\n  - Sync result confirmation\n\n  **Status Codes:**\n  - 200: Success\n  - 401: Unauthorized\n  - 500: Internal server error\n\n  **Note:** Allows Bookhoard server to push updates to Kobo device, including reading progress, bookmarks, and highlights."
@@ -1,15 +0,0 @@
-info:
-  name: Kobo Bookmark Sync
-  type: http
-  seq: 3
-http:
-  method: POST
-  url: '{{base_url}}/api/sync/kobo/{{kobo_device_token}}/bookmark'
-  auth: inherit
-  body:
-    type: json
-    data: "{\n    \"BookmarkSync\": [\n      {\n        \"BookmarkId\": \"bookmark_2\",\n        \"ContentId\": \"kobo_xyz789\",\n        \"BookmarkText\": \"Important note\",\n        \"BookmarkType\": \"bookmark\",\n        \"DateCreated\": \"2026-01-31T12:00:00Z\""
-  headers:
-  - key: Authorization
-    value: Bearer {{device_token
-docs: "## Kobo Bookmark Sync\n\n  Synchronizes bookmarks from a Kobo device to the Bookhoard server.\n\n  **Method:** POST\n\n  **Endpoint:** /api/v1/kobo/bookmark\n\n  **Authentication:** Bearer token (device token)\n\n  **Request Body:**\n  - `BookmarkSync` (array): Array of bookmark objects\n    - `BookmarkId` (string): Unique bookmark ID\n    - `ContentId` (string): Book/content ID\n    - `BookmarkText` (string): Bookmark text or note\n    - `BookmarkType` (string): Type (bookmark, highlight, note)\n    - `DateCreated` (string): ISO 8601 timestamp\n\n  **Response:**\n  - `Status` (string): Sync status (Success, Partial)\n  - `BookmarksSynced` (number): Number of bookmarks synced\n\n  **Status Codes:**\n  - 200: Success\n  - 401: Unauthorized\n  - 500: Internal server error"
@@ -1,39 +0,0 @@
-info:
-  name: Get Unlinked Books - User View
-  type: http
-  seq: 4
-http:
-  method: GET
-  url: '{{base_url}}/api/devices/{{device_id}}/sync/unlinked-books'
-  auth: inherit
-  body:
-    type: none
-  headers:
-  - key: Authorization
-    value: Bearer {{user_token
-
-docs: |-
-  ## Get Unlinked Books - User View
-  
-    Retrieves all unlinked books for the authenticated user that need manual linking.
-  
-    **Method:** GET
-  
-    **Endpoint:** /api/sync/unlinked-books
-  
-    **Authentication:** Bearer token
-  
-    **Response:**
-    - `unlinked` (array): Array of unlinked book objects
-      - `id` (string): Unlinked book UUID
-      - `title` (string): Book title
-      - `author` (string): Book author
-      - `device_id` (string): Source device ID
-      - `device_name` (string): Source device name
-      - `detected_at` (string): Detection timestamp
-    - `total` (number): Total count of unlinked books
-  
-    **Status Codes:**
-    - 200: Success
-    - 401: Unauthorized
-    - 500: Internal server error
@@ -1,15 +0,0 @@
-info:
-  name: Link Unlinked Book - Manual Resolution
-  type: http
-  seq: 5
-http:
-  method: POST
-  url: '{{base_url}}/api/devices/{{device_id}}/sync/link-book'
-  auth: inherit
-  body:
-    type: json
-    data: "{\n    \"unlinked_book_id\": \"{{unlinked_book_id"
-  headers:
-  - key: Authorization
-    value: Bearer {{user_token
-docs: "## Link Unlinked Book - Manual Resolution\n\n  Manually links an unlinked book to a media item in the library.\n\n  **Method:** POST\n\n  **Endpoint:** /api/sync/link-book\n\n  **Authentication:** Bearer token\n\n  **Request Body:**\n  - `unlinked_book_id` (string): Unlinked book UUID\n  - `media_item_id` (string): Media item UUID to link to\n  - `confidence_score` (number): Match confidence (0-1, 1.0 for manual)\n\n  **Response:**\n  - `status` (string): Link status (linked)\n  - `unlinked_book_id` (string): Unlinked book UUID\n  - `media_item_id` (string): Media item UUID\n  - `message` (string): Success message\n\n  **Status Codes:**\n  - 200: Success - book linked\n  - 400: Invalid request\n  - 401: Unauthorized\n  - 404: Book or media item not found\n  - 500: Internal server error"
@@ -1,15 +0,0 @@
-info:
-  name: Sync Bookmark - URL Path Token
-  type: http
-  seq: 2
-http:
-  method: POST
-  url: '{{base_url}}/api/sync/kobo/{{kobo_device_token}}/bookmark'
-  auth: none
-  body:
-    type: json
-    data: "{\n    \"ContentId\": \"book-uuid\",\n    \"BookmarkText\": \"Highlighted text\",\n    \"BookmarkType\": \"annotation\",\n    \"BookmarkTitle\": \"Chapter 3\""
-  headers:
-  - key: Content-Type
-    value: application/json
-docs: "## Sync Bookmark - URL Path Token\n\n  Synchronizes bookmarks and annotations from Kobo device using token in URL path.\n\n  **Method:** POST\n\n  **Endpoint:** /sync/kobo/{kobo_device_token"
@@ -1,15 +0,0 @@
-info:
-  name: Sync Markup - URL Path Token
-  type: http
-  seq: 1
-http:
-  method: POST
-  url: '{{base_url}}/api/sync/kobo/{{kobo_device_token}}/markup'
-  auth: none
-  body:
-    type: json
-    data: "{\n    \"ReadingSync\": [\n      {\n        \"ContentId\": \"book-uuid\",\n        \"PercentRead\": 45.6,\n        \"EntitlementId\": \"entitlement-id\",\n        \"RemainingTimeMinutes\": 120,\n        \"FirstReadTime\": \"2026-01-25T10:00:00Z\",\n        \"LastModified\": \"2026-01-30T20:00:00Z\""
-  headers:
-  - key: Content-Type
-    value: application/json
-docs: "## Sync Reading Progress - URL Path Token\n\n  Synchronizes reading progress from Kobo device using token in URL path.\n\n  **Method:** POST\n\n  **Endpoint:** /sync/kobo/{kobo_device_token"