docs(cli,rust): resumable external-signer finalize and evm-network devnet-manifest guardrail

[JimCollinson]

Prose updates for the two ant-client surfaces that changed against the audited head 9475782. Opened as a draft for a human to read the prose before promoting. Companion of the metadata sweep PR (claude/sweep-2026-08-26); the two PRs touch disjoint pages.

Upstream

• ant-client: a954ec8 → 9475782

Source artifacts inspected

• ant-core/src/data/client/file.rs — finalize_upload_resumable, finalize_upload_merkle_multi_resumable, finalize_resume (+ _with_progress), FinalizeOutcome, FinalizeResume, WaveFinalizeResume, MerkleFinalizeResume
• ant-core/src/data/mod.rs — confirms the new types re-export at ant_core::data
• ant-core/src/config.rs — resolve_evm_network (None + manifest-with-EVM → error; local → manifest custom network; preset alongside manifest EVM → warning)
• ant-cli/src/cli.rs, ant-cli/src/main.rs — --evm-network is now Option<String> resolved through ant_core::config::resolve_evm_network
• CHANGELOG.md

Developer-facing change

• The native Rust external-signer finalize surface gained resumable variants that recover a post-payment storage shortfall against the same on-chain payment, with no re-quoting, second signature, or double payment.
• The root --evm-network flag now requires an explicit value when a devnet manifest carrying an EVM block is loaded; it still defaults to arbitrum-one otherwise. No change for mainnet or read-only use.

Files changed in this PR

• docs/rust/library-reference.md
• docs/cli/command-reference.md

Why prose changed

• docs/rust/library-reference.md: the "External signer flows" section enumerates the finalize methods and progress variants; at head it was missing the resumable finalize surface. Added a paragraph describing finalize_upload_resumable / finalize_upload_merkle_multi_resumable / finalize_resume, the FinalizeOutcome (Complete / Partial) and FinalizeResume handle, the same-payment resume guarantee, the bound-the-loop caveat, and the every-sub-batch-paid requirement for the Merkle path; added FinalizeOutcome and FinalizeResume to the Key types table. Tracks ant-core/src/data/client/file.rs.
• docs/cli/command-reference.md: the root --evm-network row and a following note now state the devnet-manifest-with-EVM requirement and the preset-override warning. Tracks ant-core/src/config.rs and ant-cli/src/cli.rs.

Verification run

• python3 scripts/sweep_poll.py on this branch: status: "ok", no malformed-block errors; both edited pages are no longer drifted.
• Prohibited-words scan over the added lines: none.
• Type/export re-grep against the pinned 9475782 checkout: all cited symbols (finalize_upload_resumable, finalize_upload_merkle_multi_resumable, finalize_resume, FinalizeOutcome, FinalizeResume) exist and re-export at ant_core::data; resolve_evm_network returns the ambiguity error when a manifest EVM block is present and no --evm-network is given.
• No code samples were added, so no syntax check was required.
• markdownlint / link check: skipped — not installed in the routine environment.
• Envelope: changes limited to docs/**; no scripts/, .github/, repo-registry.yml, or component-registry.yml. SKILL.md body unchanged, so no linked skill release is triggered.

Suggested follow-ups
None.

Deferred ambiguous records
None — no record in this run was classified ambiguous.

---

🤖 Generated with Claude Code

---

Generated by Claude Code