This document tracks how ready putio-sdk-swift is for autonomous agent work and public package maintenance.
- deterministic package-level unit tests now exist under
Tests/PutioSDKTests - an opt-in live verification layer exists under
Tests/PutioSDKLiveTests - the shared transport now has a native async
URLSessionpath withDecodableboundary parsing for the modernized domains - typed failures now conform to
LocalizedErrorand carry recovery guidance, retryability, and classification helpers make verifyis the canonical deterministic guardrail and enforces a90%source line coverage floor forPutioSDK/Classesmake live-testis the opt-in real API verification lane
| Area | Status | Notes |
|---|---|---|
| Package boot | good |
make bootstrap and make verify are documented and exercised in CI |
| Unit verification | good |
request config, async transport, localized errors, and the modernized account/auth/history/files/media/grants/routes/subtitles/transfers/trash domains now have deterministic package coverage with a 90% source line floor enforced by make verify |
| Live verification | medium |
account, disposable file/trash, transfer read paths, and playback-adjacent file helpers are live-covered; more namespaces still need safe real-API targets |
| Native SDK baseline | good |
auth/OAuth, account/settings/security/2FA, files, search, transfers, history/events, trash, subtitles, and playback-adjacent helpers have typed async surfaces |
| Release readiness | good |
main stays verify-first, with semantic-release and optional CocoaPods publishing |
- add more live coverage for safe read and reversible mutation flows
- keep broadening deterministic tests as new namespaces land so the
90%floor stays comfortable - keep the example app aligned with the async-first package surface as auth and playback flows evolve