Updates

network-stack/hyper-p2p-congestion-signal/README.md

@@ -1,6 +1,6 @@
 # hyper-p2p-congestion-signal
 
-Production network stack module: Hyperswarm discovery + Protomux when `topic` is set.
+Congestion hints from RTT/loss — `reportSample`, `getHint`, and `shouldThrottle` for adaptive send rates.
 
 **Category:** Network stack
 
@@ -29,6 +29,8 @@ await mod.close()
 
 ## Docs
 
+- [Category hub](../../docs/network-stack/README.md) — Wave 6 stack index
+- [Stack demo](../../examples/p2p-network-stack-demo/)
 - [docs/api.md](docs/api.md) — constructor, methods, events, errors
 - [docs/architecture.md](docs/architecture.md) — wire types, state, composition
 - [../_shared/PRODUCTION.md](../../_shared/PRODUCTION.md) — production checklist

network-stack/hyper-p2p-congestion-signal/docs/api.md

@@ -6,7 +6,7 @@
 
 ## Overview
 
-Production network stack module: Hyperswarm discovery + Protomux when `topic` is set.
+Gossiped RTT and packet-loss samples per peer; exposes throttle hints for senders. Pairs with `bucket-rate-limit` and `flow-shaper` in full stacks.
 
 ## Constructor