REST search API completeness pass
Summary¶
Audit and fill release-critical search API gaps for aMuTorrent and other local controllers.
Beta 0.7.3 Classification¶
Release Candidate. The search API is mostly complete for 1.0. The remaining release work is to document paging/bounds behavior and keep live corpus coverage meaningful; do not change stock search semantics for this item.
Execution Plan¶
Historical release context: Beta 0.7.3 REST and Arr execution plan.
Acceptance Criteria¶
- [x] aMuTorrent search views can render useful result rows without private adapter assumptions
- [x] server, global, Kad, and automatic search methods remain explicit
- [x] cancellation and missing-search behavior return stable typed errors
- [x] paging or bounding behavior is documented if result sets are limited
- [x] live coverage includes the release search corpus
Progress¶
- 2026-05-06: Closed the Beta 0.7.3 documentation gap. OpenAPI and the REST
contract now state that
GET /api/v1/searches/{searchId}returns the current native visible result snapshot, does not acceptlimitoroffsetin v1, and preserves stock eD2K/Kad search semantics. Live REST evidence already covers server/global/Kad/automatic search method handling through the release search corpus. - 2026-05-02: Native
mainaddedDELETE /api/v1/searchesandPOST /api/v1/searches/{searchId}/results/{hash}/operations/download. aMuTorrent now uses the native result-download route when it has a native search id and keeps the ED2K-link fallback for older frames.
Relationship To Other Items¶
- backs
CI-013andCI-014 - should not change default eD2K/Kad search semantics