dangernoodle-io / breadboard / 27052976033

100%

push

github

fix: complete OpenAPI route descriptors (params, content-types, errors) + boot-progress doc (#353)

* fix: complete OpenAPI route descriptors — params, content-types, missing 500s

Tier 1 (descriptor wrong vs handler):
- GET /api/diag/coredump: add ?consume param (query, optional, string); add 500
  response {error:string}; fix 404 content-type to application/json + error schema
- GET /api/logs: add ?source param (query, optional, string); add 500 response
  {error:string}
- GET /api/diag/heap: add ?check param (query, optional, string)
- POST /api/update/push: all 5 responses were text/plain but handler sends JSON;
  change to application/json and add schemas (200: {status}, errors: {error})
- POST /api/log/level: 400 was text/plain but handler sends JSON {error:...};
  change to application/json + error schema

Tier 2 (reachable-but-undeclared 500 responses):
- GET /api/events: add 500 {error:string} (not initialized / async init failed)
- POST /api/update/apply: add 500 {error:string} (alloc / task create failed)
- POST /api/update/mark-valid: add 500 {error:string} (bb_ota_mark_valid error)
- GET /api/diag/tasks: add 500 {error:string} (malloc for TaskStatus_t array)
- GET /api/manifest: add 500 {error:string} (bb_manifest_emit / serialize failed)

Co-Authored-By: Claude Opus 4.8 <noreply@anthropic.com>

* docs: document boot-mode /api/update/progress transient endpoint

- CLAUDE.md: correct the boot-mode OTA section — when CONFIG_BB_OTA_BOOT_PROGRESS_HTTP=y
  the board serves a transient GET /api/update/progress during the boot-OTA download
  window (same {state,in_progress,progress_pct} schema as bb_ota_pull's progress route),
  absent in normal operation; without that config the client waits for the device to
  reappear with no progress feed
- components/bb_ota_boot/Kconfig: add help text to BB_OTA_BOOT_PROGRESS_HTTP noting
  the transient endpoint and clarifying it is absent from the normal OpenAPI spec

Co-Authored-By: Claude Opus 4.8 <norepl... (continued)

1418 of 1418 branches covered (100.0%)

Branch coverage included in aggregate %.

2400 of 2400 relevant lines covered (100.0%)

949.71 hits per line