Redesign error model: typed transport exceptions + operation result types (breaking)#101

Merged

pedro18x merged 33 commits into

error-model-redesign

Jun 19, 2026

Commits on Jun 5, 2026

docs: design spec for adbd-aware error model redesign

steviec
and
claude
committed
docs: justify error contract on merits, drop compat framing

steviec
and
claude
committed
docs: resolve result-type questions from adb source, drop open questions

steviec
and
claude
committed
docs: adopt Philosophy B — operation-specific result types throughout

steviec
and
claude
committed
docs: implementation plan for adbd-aware error model

steviec
and
claude
committed
feat: add AdbException transport exception hierarchy

steviec
and
claude
committed
feat: add operation result types

steviec
and
claude
committed
test: add FakeDadb fixture and wire byte-builders

steviec
and
claude
committed
fix: surface mid-stream socket faults as AdbConnectionClosedException

steviec
and
claude
committed
feat: map adbd handshake failures to typed AdbException subtypes

steviec
and
claude
committed
feat: map A_OPEN refusal to AdbStreamOpenException

steviec
and
claude
committed
feat: AdbSync throws internal AdbSyncFailException on FAIL

steviec
and
claude
committed
feat: push/pull return SyncResult
steviec
committed
feat: uninstall returns UninstallResult
steviec
committed
feat: install returns InstallResult and checks the pm-install result
steviec
committed
feat: installMultiple returns InstallResult; fix finalize message bug
steviec
committed
feat: root/unroot return RootResult; @Throws(AdbException) sweep
steviec
committed
docs: document the adbd-aware error model
steviec
committed
test: cover AdbProtocolException on sync packet desync
steviec
committed
fix: wrap raw socket faults in open() as AdbConnectionClosedException

steviec
and
claude
committed
test: move AdbStreamOpenException test to the direct-adbd impl only

steviec
and
claude
committed
feat: add opt-in onSuccess/onFailure/orThrow helpers to result types

steviec
and
claude
committed
chore: remove internal superpowers design docs from the branch

steviec
and
claude
committed

Commits on Jun 19, 2026