fix(graph): fix fmt import order and broken rustdoc intra-doc links

- graphql.rs: move graphql_rate_limit import before graphql_throttle (alpha order)
- graphql_throttle.rs: pre_flight_delay -> pre_flight_reserve in PluginBudget doc
- graphql_throttle.rs: remove unresolvable link brackets from module-level prose

Author: greysquirr3l

crates/stygian-graph/src/adapters/graphql.rs

@@ -17,10 +17,10 @@ use async_trait::async_trait;
 use serde_json::{Value, json};
 use tokio::sync::RwLock;
 
+use crate::adapters::graphql_rate_limit::{RequestRateLimit, rate_limit_acquire};
 use crate::adapters::graphql_throttle::{
     PluginBudget, pre_flight_reserve, reactive_backoff_ms, release_reservation, update_budget,
 };
-use crate::adapters::graphql_rate_limit::{RequestRateLimit, rate_limit_acquire};
 use crate::application::graphql_plugin_registry::GraphQlPluginRegistry;
 use crate::application::pipeline_parser::expand_template;
 use crate::domain::error::{Result, ServiceError, StygianError};

crates/stygian-graph/src/adapters/graphql_throttle.rs

@@ -18,9 +18,9 @@
 //! Before each request a *proactive* pre-flight delay is computed: if the
 //! projected available budget (accounting for elapsed restore time and
 //! in-flight reservations) will be too low, the caller sleeps until it
-//! recovers.  After the delay, [`pre_flight_reserve`] atomically reserves an
+//! recovers.  After the delay, `pre_flight_reserve` atomically reserves an
 //! estimated cost against the budget so concurrent callers immediately see a
-//! reduced balance.  Call [`release_reservation`] on every exit path (success
+//! reduced balance.  Call `release_reservation` on every exit path (success
 //! and error) to keep the pending balance accurate.  This eliminates wasted
 //! requests that would otherwise return `THROTTLED`.
 
@@ -123,7 +123,7 @@ impl LiveBudget {
 
 /// A shareable, cheaply-cloneable handle to a per-plugin `LiveBudget`.
 ///
-/// Create one per registered plugin and pass it to [`pre_flight_delay`] before
+/// Create one per registered plugin and pass it to [`pre_flight_reserve`] before
 /// each request.
 ///
 /// # Example