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).
This commit is contained in:
John O'Keefe committed 2026-10-24 18:35:51 -04:00
1 parent 6fc501b35a
commit acd82fff0a
353 files changed
+5165 -5293

No files matched your search

-19
View File
@@ -1,19 +0,0 @@
info:
name: Get System Scan Settings
type: http
seq: 1
http:
method: GET
url: '{{base_url}}/api/libraries/scan-settings'
auth: inherit
headers:
- key: Content-Type
value: application/json
docs: |-
## Get System Scan Settings
Retrieves current system-wide scan settings for all libraries.
**Authentication**: Admin token required
**Response**: Current scan frequency and auto-scan status
+21
View File
@@ -0,0 +1,21 @@
info:
name: Get System Configuration
type: http
seq: 1
http:
method: GET
url: '{{base_url}}/api/system/config'
auth: inherit
settings:
encodeUrl: true
timeout: 0
followRedirects: true
maxRedirects: 5
docs: |-
# Get System Configuration
`GET /api/system/config` — auth: jwt+admin.
Canonical reference: `docs/developer/api/system/get_config.md` (docs site → Developer → API). This request is GENERATED from that doc; edit the doc, not this file.
+21
View File
@@ -0,0 +1,21 @@
info:
name: Get System Settings
type: http
seq: 2
http:
method: GET
url: '{{base_url}}/api/system/settings'
auth: inherit
settings:
encodeUrl: true
timeout: 0
followRedirects: true
maxRedirects: 5
docs: |-
# Get System Settings
`GET /api/system/settings` — auth: jwt+admin.
Canonical reference: `docs/developer/api/system/get_settings.md` (docs site → Developer → API). This request is GENERATED from that doc; edit the doc, not this file.
-15
View File
@@ -1,15 +0,0 @@
info:
name: Update System Scan Settings
type: http
seq: 2
http:
method: PUT
url: '{{base_url}}/api/libraries/scan-settings'
auth: inherit
body:
type: json
data: "{\n \"scan_poll_interval_seconds\": 30,\n \"auto_scan_enabled\": true\n}"
headers:
- key: Content-Type
value: application/json
docs: "## Update System Scan Settings\n\n Updates system-wide scan settings that apply to all libraries.\n\n **Authentication**: Admin token required\n **Request**: Scan frequency (15-1440 minutes) and enabled status\n **Response**: Success message"
+28
View File
@@ -0,0 +1,28 @@
info:
name: Update System Configuration
type: http
seq: 3
http:
method: PUT
url: '{{base_url}}/api/system/config'
auth: inherit
body:
type: json
data: |-
{
"base_url": "https://books.example.com",
"default_timezone": "UTC"
}
settings:
encodeUrl: true
timeout: 0
followRedirects: true
maxRedirects: 5
docs: |-
# Update System Configuration
`PUT /api/system/config` — auth: jwt+admin.
Canonical reference: `docs/developer/api/system/update_config.md` (docs site → Developer → API). This request is GENERATED from that doc; edit the doc, not this file.
+28
View File
@@ -0,0 +1,28 @@
info:
name: Update System Setting
type: http
seq: 4
http:
method: PUT
url: '{{base_url}}/api/system/settings'
auth: inherit
body:
type: json
data: |-
{
"key": "scan_poll_interval_seconds",
"value": "60"
}
settings:
encodeUrl: true
timeout: 0
followRedirects: true
maxRedirects: 5
docs: |-
# Update System Setting
`PUT /api/system/settings` — auth: jwt+admin.
Canonical reference: `docs/developer/api/system/update_setting.md` (docs site → Developer → API). This request is GENERATED from that doc; edit the doc, not this file.