bee-check 0.5.0

Retrievability checker for Ethereum Swarm references. Multi-vantage stewardship probes, per-chunk drill-down, and one-shot re-seed.
Documentation 
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67

# Walkthrough

A short tour of the SPA's surface.

![bee-check-web form](./images/01-form.png)

## The form

- **Swarm reference** — 64-hex address, or `feed:OWNER:TOPIC` for a
  feed.
- **Bee API URL(s)** — one per line. Each becomes a vantage.
- **Public gateway URL(s)** — one per line. Each becomes a gateway
  probe. Leave blank to skip.
- **Target overlay** — optional 64-hex. When set, vantages re-sort
  closest-first and gain a `target_proximity` badge.
- **Timeout** — per-request cap in seconds.
- **Per-chunk drill-down** — checkbox. When on, after the basic
  probe the page walks the manifest and probes every chunk.
- **Cold download** — checkbox. When on, the page also streams
  `GET /bytes/{ref}` from each Bee URL and `GET /bzz/{ref}/` from
  each gateway, recording total bytes and elapsed time.
- **Check** button — runs the probe. While drilling, the button
  shows live progress (`Probing chunks N/M…`).

## The report

![Basic probe result](./images/02-basic-result.png)

Renders top-to-bottom:

1. **Status pill + reference** at the top.
2. **Vantages table** — one row per Bee URL with: result pill,
   neighborhood/overlay + PO, Bee version, elapsed_ms, notes.
3. **Gateways table** — if any gateway URLs were given.
4. **Chunk stats per vantage** — if `--per-chunk` was enabled.
   Rows: vantage → found/total + p50/p95/max latency.
5. **Chunk stats per neighborhood** (slowest first) — same shape,
   keyed on chunk neighborhood. Top-10.
6. **Per-chunk matrix** — first 50 chunks × all vantages, with
   per-cell elapsed_ms + PO badges (× pill on miss).
7. **Resolution** — present when input was a feed handle.
8. **Show JSON** — toggle to expand the full report as raw JSON for
   copy/paste.

A `--per-chunk` run rendered:

![Per-chunk drill-down](./images/03-per-chunk.png)

## The re-seed panel

![Re-seed panel after pre-flighting an invalid batch](./images/04-reseed-panel.png)

Collapsed by default. Expand it to reveal:

- **Postage batch ID** — 64-hex.
- **Pre-flight stamp** button — calls `GET /stamps/{id}`, reports
  `exists / usable / TTL` and any warnings.
- **Re-seed now** button — only enabled after pre-flight reports
  healthy. Fires `PUT /stewardship/{ref}` against the first Bee URL.

## Drag-and-drop a report

Drop any `bee-check --output json` file anywhere on the page (or
any report file the SPA itself produced) and it'll render in place
of running a fresh probe. Useful for sharing diagnostics: a teammate
runs the CLI, attaches the JSON in a message, you drop it on the
page.