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,15 +0,0 @@
-info:
-  name: Add Books to Kobo Shelf
-  type: http
-  seq: 1
-http:
-  method: POST
-  url: '{{baseURL}}/api/devices/{{deviceID}}/shelves'
-  auth: inherit
-  body:
-    type: json
-    data: "{\n    \"media_item_ids\": [\n      \"{{bookUUID1"
-  headers:
-  - key: Authorization
-    value: Bearer {{userToken
-docs: "## Add Books to Kobo Shelf\n\n  Add one or more books to a Kobo device shelf. Manages which books should be synced to a specific Kobo device. Supports multiple shelves for organization.\n\n  **Method:** POST\n\n  **Endpoint:** /api/devices/{deviceID"
@@ -1,12 +0,0 @@
-info:
-  name: Check Registration Status
-  type: http
-  seq: 2
-http:
-  method: POST
-  url: '{{base_url}}/api/devices/register/status'
-  auth: none
-  body:
-    type: json
-    data: "{\n    \"registration_id\": \"{{registrationId}}"
-docs: "## Check Registration Status\n\n  Checks the current status of a device registration request.\n\n  **Method:** POST\n\n  **Endpoint:** /api/devices/register/status\n\n  **Authentication:** None\n\n  **Request Body:**\n  - `registration_id` (string, required): Registration request ID\n\n  **Response:**\n  - `status` (string): Registration status (pending, approved, rejected, expired)\n  - `device_name` (string): Device name\n  - `device_type` (string): Device type\n  - `created_at` (string): Request timestamp\n  - `expires_at` (string): Expiration timestamp\n\n  **Status Codes:**\n  - 200: Success\n  - 404: Registration ID not found\n  - 410: Registration expired"
@@ -1,22 +0,0 @@
-info:
-  name: Clear Kobo Shelf
-  type: http
-  seq: 1
-http:
-  method: DELETE
-  url: '{{baseURL}}/api/devices/{{deviceID}}/shelves/clear?shelf={{shelfName}}'
-  auth: inherit
-  body:
-    type: none
-  headers:
-  - key: Authorization
-    value: Bearer {{userToken
-
-docs: |-
-  ## Clear Kobo Shelf
-  
-    Clear all books from a Kobo device shelf, or all shelves if no shelf name is specified.
-  
-    **Method:** DELETE
-  
-    **Endpoint:** /api/devices/{deviceID
@@ -1,19 +0,0 @@
-info:
-  name: Create Device File Alias
-  type: http
-  seq: 1
-http:
-  method: POST
-  url: '{{base_url}}/api/devices/{{device_id}}/file-aliases'
-  auth: inherit
-  body:
-    type: json
-    data: "{\n    \"file_path\": \"/mnt/sd/books/my-book.kepub.epub\",\n    \"media_item_id\": \"{{media_item_id"
-  headers:
-  - key: Content-Type
-    value: application/json
-runtime:
-  scripts:
-  - type: tests
-    code: "test_create_device_file_alias_success(status, headers, body) {\n    if (status !== 201 && status !== 200) {\n      throw new Error(\"Expected status 201 or 200, got \" + status);"
-docs: "## Create Device File Alias\n\n  Creates a new file alias for a device. File aliases map device-specific file paths to media items.\n\n  **Method:** POST\n\n  **Endpoint:** /api/devices/:id/file-aliases\n\n  **Authentication:** Required (Bearer token)\n\n  **Path Parameters:**\n  - `id` (string, required): Device UUID\n\n  **Request Body:**\n  - `file_path` (string, required): Device-specific file path\n  - `media_item_id` (string, required): Media item UUID to link to\n\n  **Response:** Created file alias object\n  - `id` (string): Alias UUID\n  - `device_id` (string): Device UUID\n  - `file_path` (string): Device-specific file path\n  - `media_item_id` (string): Associated media item UUID\n  - `created_at` (string): Creation timestamp\n  - `updated_at` (string): Last update timestamp\n\n  **Status Codes:**\n  - 201: Created\n  - 200: Success\n  - 400: Invalid request body\n  - 401: Unauthorized\n  - 404: Device not found\n  - 500: Internal server error"
@@ -1,22 +0,0 @@
-info:
-  name: Delete Device
-  type: http
-  seq: 6
-http:
-  method: DELETE
-  url: '{{base_url}}/api/devices/{{device_id}}'
-  auth: inherit
-  body:
-    type: none
-  headers:
-  - key: Authorization
-    value: Bearer {{token
-
-docs: |-
-  ## Delete Device
-  
-    Deletes a device and unregisters it from the user's account.
-  
-    **Method:** DELETE
-  
-    **Endpoint:** /api/devices/{deviceId
@@ -1,22 +0,0 @@
-info:
-  name: Get Kobo Shelf Books
-  type: http
-  seq: 1
-http:
-  method: GET
-  url: '{{baseURL}}/api/devices/{{deviceID}}/shelves?shelf={{shelfName}}'
-  auth: inherit
-  body:
-    type: none
-  headers:
-  - key: Authorization
-    value: Bearer {{userToken
-
-docs: |-
-  ## Get Kobo Shelf Books
-  
-    Get all books on a Kobo device shelf, optionally filter by shelf name.
-  
-    **Method:** GET
-  
-    **Endpoint:** /api/devices/{deviceID
@@ -1,12 +0,0 @@
-info:
-  name: Initiate Device Registration
-  type: http
-  seq: 1
-http:
-  method: POST
-  url: '{{base_url}}/api/devices/register'
-  auth: none
-  body:
-    type: json
-    data: "{\n    \"device_name\": \"My Kindle Paperwhite\",\n    \"device_type\": \"koreader\",\n    \"device_identifier\": \"kindle-pw5-hardware-id-12345\""
-docs: "## Initiate Device Registration\n\n  Initiates a new device registration request that requires admin approval.\n\n  **Method:** POST\n\n  **Endpoint:** /api/devices/register\n\n  **Authentication:** None (open endpoint)\n\n  **Request Body:**\n  - `device_name` (string, required): Human-readable device name (max 100 chars)\n  - `device_type` (string, required): Device type (kobo, koreader, kindle, etc.)\n  - `device_identifier` (string, required): Unique hardware ID (max 200 chars)\n\n  **Response:**\n  - `registration_id` (string): Unique registration request ID\n  - `status` (string): Initial status (pending)\n  - `expires_at` (string): Expiration timestamp (usually 24 hours)\n  - `message` (string): Informational message\n\n  **Status Codes:**\n  - 201: Registration initiated\n  - 400: Invalid request\n  - 409: Device already registered"
@@ -1,22 +0,0 @@
-info:
-  name: Remove Book from Kobo Shelf
-  type: http
-  seq: 1
-http:
-  method: DELETE
-  url: '{{baseURL}}/api/devices/{{deviceID}}/shelves?media_item_id={{bookUUID}}'
-  auth: inherit
-  body:
-    type: none
-  headers:
-  - key: Authorization
-    value: Bearer {{userToken
-
-docs: |-
-  ## Remove Book from Kobo Shelf
-  
-    Remove a specific book from a Kobo device shelf, preventing it from syncing to that device.
-  
-    **Method:** DELETE
-  
-    **Endpoint:** /api/devices/{deviceID
@@ -1,12 +0,0 @@
-info:
-  name: Update Device
-  type: http
-  seq: 5
-http:
-  method: PUT
-  url: '{{base_url}}/api/devices/{{device_id}}'
-  auth: inherit
-  body:
-    type: json
-    data: "{\n    \"device_name\": \"My Updated Kindle\",\n    \"sync_enabled\": true,\n    \"auto_sync\": true,\n    \"sync_frequency_minutes\": 10"
-docs: "## Update Device\n\n  Updates device settings and synchronization preferences.\n\n  **Method:** PUT\n\n  **Endpoint:** /api/devices/{device_id}\n\n  **Authentication:** Required (Bearer token, admin or device owner)\n\n  **Path Parameters:**\n  - `device_id` (string): Device ID\n\n  **Request Body:**\n  - `device_name` (string, optional): New device name (max 100 chars)\n  - `sync_enabled` (boolean, optional): Enable/disable synchronization\n  - `auto_sync` (boolean, optional): Enable automatic synchronization\n  - `sync_frequency_minutes` (integer, optional): Sync frequency in minutes (5-1440)\n\n  **Response:**\n  - Updated device object\n\n  **Status Codes:**\n  - 200: Success\n  - 400: Invalid request\n  - 401: Unauthorized\n  - 403: Forbidden (not device owner)\n  - 404: Device not found"