mirror of
https://github.com/Kpa-clawbot/meshcore-analyzer.git
synced 2026-11-22 13:47:03 +00:00
Partial fix for #1670. Document the existing public `GET /api/known-channels` endpoint with a concrete response schema and its optional catalogue-region filter. The descriptions cover missing-cache sentinels, omitted fields, verbatim upstream strings, unspecified entry order, and the actual 30/300-second cache lifetimes. Catalogue entries do not establish observed traffic or successful decryption. Known route-description gaps decrease from 15 to 14 on this base. This changes generated API metadata only. Handler, parser, cache, authentication and configuration behavior are unchanged. No new dependencies or customizer settings. Validation: - Tests-only RED `fadc0fb5e` compiles and [fails the missing-documentation/schema assertions](https://github.com/Kpa-clawbot/CoreScope/actions/runs/44058546803/job/133954154417); all ten registered-handler cases already pass. - GREEN `5ed158aab` passes the byte-unchanged tests. Fixtures cover nil/unpopulated/empty caches, case and whitespace handling, arbitrary and unknown regions, raw metadata, omissions, public access and headers. - All 21 focused tests pass. Full native server and ingestor suites pass in 287.788s and 245.003s respectively. - Parent verified Swagger rendering and five real public queries against a cached catalogue while its source was offline, plus the disabled-cache response. [Exact-head GREEN CI](https://github.com/Kpa-clawbot/CoreScope/actions/runs/44065924428) and three independent reviews pass with no remaining findings. The remaining endpoints and broader parameter/schema work stay open under #1670. This change is independent of the area-configuration documentation in #2401. --------- Co-authored-by: n30nex <6686206+n30nex@users.noreply.github.com>