Skip to content

Document ant file download --all-peers diagnostic flag#65

Draft
JimCollinson wants to merge 1 commit into
mainfrom
claude/prose-2026-06-25-cli-file-download-all-peers
Draft

Document ant file download --all-peers diagnostic flag#65
JimCollinson wants to merge 1 commit into
mainfrom
claude/prose-2026-06-25-cli-file-download-all-peers

Conversation

@JimCollinson

Copy link
Copy Markdown
Collaborator

Upstream

  • ant-client: 4d0448453ab50c44

Source artifacts inspected

  • ant-cli/src/commands/data/file.rs upstream (the FileAction::Download clap definition, handle_file_download, and download_peer_check_count) at 3ab50c44.

Developer-facing change
ant file download gained an --all-peers flag (alias --try-all-peers). It downloads the file as usual and then fetches each chunk from every selected closest peer, printing ranked per-peer results. The number of peers swept per chunk comes from --peers (default: the client close-group size), and with --json the results are emitted as a chunk_peer_check object on the download result.

Files changed in this PR

  • docs/cli/command-reference.md: added the --all-peers row to the ant file download parameter table, a diagnostic example, and refreshed the ant-client verification stamp to 3ab50c44.

Why prose changed

  • docs/cli/command-reference.md: the ant file download command surface added a new flag. The new row and example track ant-cli/src/commands/data/file.rs at 3ab50c44, matching the existing ant chunk get --all-peers diagnostic documentation on the same page.

Verification run

  • Re-grepped the upstream file at 3ab50c44: the #[arg(long, alias = "try-all-peers")] all_peers: bool field, download_peer_check_count (defaulting to client.config().close_group_size), and the chunk_peer_check JSON field all confirmed present.
  • Re-ran python3 scripts/sweep_poll.py on this branch: status: "ok"; docs/cli/command-reference.md is no longer drifted. (The other 34 drifted records on this branch are the sweep pages, stamped on the linked sweep PR's branch.)
  • markdownlint / link checkers: skipped — not configured in this repo.
  • Stayed within the prose envelope: only docs/cli/command-reference.md changed; no skills/, scripts/, .github/, or registry files touched, so no linked skill-release fields apply.

Deferred ambiguous records: none.

Uncertainties

  • none.

Generated by Claude Code

ant-client gained a download peer-diagnostics mode: `ant file download`
accepts `--all-peers` (alias `--try-all-peers`), which downloads the file
as usual and then fetches each chunk from every selected closest peer and
prints ranked per-peer results. The number of peers swept per chunk comes
from `--peers`, defaulting to the client close-group size, and the results
are emitted as a `chunk_peer_check` object under `--json`.

Adds the flag to the `ant file download` parameter table and a diagnostic
example, and refreshes the page verification stamp to the audited commit.

Co-Authored-By: Claude Opus 4.8 <noreply@anthropic.com>
Claude-Session: https://claude.ai/code/session_01L4BB5P1sFk9RkYi78L1YMA
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant