kubo/docs/changelogs
Guillaume Michel 16479ec692
Some checks are pending
CodeQL / codeql (push) Waiting to run
Docker Check / lint (push) Waiting to run
Docker Check / build (push) Waiting to run
Gateway Conformance / gateway-conformance (push) Waiting to run
Gateway Conformance / gateway-conformance-libp2p-experiment (push) Waiting to run
Go Build / go-build (push) Waiting to run
Go Check / go-check (push) Waiting to run
Go Lint / go-lint (push) Waiting to run
Go Test / go-test (push) Waiting to run
Interop / interop-prep (push) Waiting to run
Interop / helia-interop (push) Blocked by required conditions
Interop / ipfs-webui (push) Blocked by required conditions
Sharness / sharness-test (push) Waiting to run
Spell Check / spellcheck (push) Waiting to run
feat(provide): detailed ipfs provide stat (#11019)
* feat: provide stats

* added N/A

* format

* workers stats alignment

* ipfs provide stat --all --compact

* consolidating compact stat

* update column alignment

* flags combinations errors

* command description

* change schedule AvgPrefixLen to float

* changelog

* alignments

* provide stat description draft

* rephrased provide-stats.md

* linking provide-stats.md from command description

* documentation test

* fix: refactor provide stat command type handling

- add extractSweepingProvider() helper to reduce nested type switching
- extract lowWorkerThreshold constant for worker availability check
- fix --lan error handling to work with buffered providers

* docs: add clarifying comments

* fix(commands): improve provide stat compact mode

- prevent panic when both columns are empty
- fix column alignment with UTF-8 characters
- only track col0MaxWidth for first column (as intended)

* test: add tests for ipfs provide stat command

- test basic functionality, flags, JSON output
- test legacy provider behavior
- test integration with content scheduling
- test disabled provider configurations
- add parseSweepStats helper with t.Helper()

* docs: improve provide command help text

- update tagline to "Control and monitor content providing"
- simplify help descriptions
- make error messages more consistent
- update tests to match new error messages

* metrics rename

```
Next reprovide at:
Next prefix:
```
updated to:
```
Next region prefix:
Next region reprovide:
```

* docs: improve Provide system documentation clarity

Enhance documentation for the Provide system to better explain how provider
records work and the differences between sweep and legacy modes.

Changes to docs/config.md:
- Provide section: add clear explanation of provider records and their role
- Provide.DHT: add provider record lifecycle and two provider systems overview
- Provide.DHT.Interval: explain relationship to expiration, contrast sweep vs legacy behavior
- Provide.DHT.SweepEnabled: rewrite to explain legacy problem, sweep solution, and efficiency gains
- Monitoring section: prioritize command-line tools (ipfs provide stat) before Prometheus

Changes to core/commands/provide.go:
- ipfs provide stat help: add explanation of provider records, TTL expiration, and how sweep batching works

Changes to docs/changelogs/v0.39.md:
- Add context about why stats matter for monitoring provider health
- Emphasize real-time monitoring workflow with watch command
- Explain what users can observe (rates, queues, worker availability)

* depend on latest kad-dht master

* docs: nits

---------

Co-authored-by: Marcin Rataj <lidel@lidel.org>
2025-10-23 20:29:36 +02:00
..
v0.2.md feat(ci): reusable spellcheck from unified CI (#10873) 2025-08-14 00:35:35 +00:00
v0.3.md docs: bulk spelling edits (#9544) 2023-02-20 23:37:10 +01:00
v0.4.md feat(ci): reusable spellcheck from unified CI (#10873) 2025-08-14 00:35:35 +00:00
v0.5.md feat: Add CI for Spell Checking (#10637) 2025-01-30 17:50:51 +01:00
v0.6.md feat: Add CI for Spell Checking (#10637) 2025-01-30 17:50:51 +01:00
v0.7.md feat: Add CI for Spell Checking (#10637) 2025-01-30 17:50:51 +01:00
v0.8.md feat(ci): reusable spellcheck from unified CI (#10873) 2025-08-14 00:35:35 +00:00
v0.9.md feat(ci): reusable spellcheck from unified CI (#10873) 2025-08-14 00:35:35 +00:00
v0.10.md feat(ci): reusable spellcheck from unified CI (#10873) 2025-08-14 00:35:35 +00:00
v0.11.md feat: Add CI for Spell Checking (#10637) 2025-01-30 17:50:51 +01:00
v0.12.md feat: Add CI for Spell Checking (#10637) 2025-01-30 17:50:51 +01:00
v0.13.md collection of typo fixes (#10647) 2025-01-13 18:55:10 +01:00
v0.14.md feat: Add CI for Spell Checking (#10637) 2025-01-30 17:50:51 +01:00
v0.15.md docs: bulk spelling edits (#9544) 2023-02-20 23:37:10 +01:00
v0.16.md feat: Add CI for Spell Checking (#10637) 2025-01-30 17:50:51 +01:00
v0.17.md docs: bulk spelling edits (#9544) 2023-02-20 23:37:10 +01:00
v0.18.md feat(ci): reusable spellcheck from unified CI (#10873) 2025-08-14 00:35:35 +00:00
v0.19.md feat: Add CI for Spell Checking (#10637) 2025-01-30 17:50:51 +01:00
v0.20.md feat(ci): reusable spellcheck from unified CI (#10873) 2025-08-14 00:35:35 +00:00
v0.21.md feat(ci): reusable spellcheck from unified CI (#10873) 2025-08-14 00:35:35 +00:00
v0.22.md feat(ci): reusable spellcheck from unified CI (#10873) 2025-08-14 00:35:35 +00:00
v0.23.md feat: Add CI for Spell Checking (#10637) 2025-01-30 17:50:51 +01:00
v0.24.md feat: Add CI for Spell Checking (#10637) 2025-01-30 17:50:51 +01:00
v0.25.md feat: Add CI for Spell Checking (#10637) 2025-01-30 17:50:51 +01:00
v0.26.md chore: update changelog 2024-01-22 14:35:53 +01:00
v0.27.md feat: Add CI for Spell Checking (#10637) 2025-01-30 17:50:51 +01:00
v0.28.md chore: update changelog for v0.28 2024-04-15 07:15:38 +00:00
v0.29.md feat: Add CI for Spell Checking (#10637) 2025-01-30 17:50:51 +01:00
v0.30.md feat: Add CI for Spell Checking (#10637) 2025-01-30 17:50:51 +01:00
v0.31.md feat(ci): reusable spellcheck from unified CI (#10873) 2025-08-14 00:35:35 +00:00
v0.32.md Update to boxo with refactored providerQueryManager. (#10595) 2024-11-26 03:34:06 -08:00
v0.33.md Merge remote-tracking branch 'origin/master' into merge-release-v0.33.2 2025-02-14 01:30:03 +01:00
v0.34.md docs: Fix typo in v0.34 changelog (#10771) 2025-04-01 07:26:38 -07:00
v0.35.md chore: spellcheck to avoid ai fix prs 2025-05-21 20:21:33 +02:00
v0.36.md fix typos in docs and comments (#10920) 2025-08-18 08:43:25 -07:00
v0.37.md docs: fix typo in v0.37 changelog 2025-08-27 20:33:02 +02:00
v0.38.md chore: v0.38.1 2025-10-08 18:34:29 +02:00
v0.39.md feat(provide): detailed ipfs provide stat (#11019) 2025-10-23 20:29:36 +02:00