swarm-controller: fix broken intra-doc links (private items, rustdoc lint)

swarm-controller/src/config_pr.rs

@@ -16,7 +16,7 @@
 //! - [`ConfigPrCache::apply_webhook_delivery`] — called from
 //!   `crate::webhook::post_webhook_forge` on a verified `ConfigPr` delivery.
 //!   The low-latency path: a PR opening or closing shows up immediately
-//!   instead of waiting up to [`POLL_INTERVAL`].
+//!   instead of waiting up to `POLL_INTERVAL`.
 //!
 //! Per mara's review call: ship both from the start rather than the poll
 //! alone — the eventual swarm-level replacement for `hive-c0re`'s own
@@ -93,6 +93,12 @@ impl ConfigPrCache {
             .cloned()
     }
 
+    /// ⚠️ Can race [`Self::apply_webhook_delivery`]: a scan started before a
+    /// PR opened may finish *after* the webhook already upserted it, and
+    /// this snapshot — taken before that PR existed — will overwrite the
+    /// fresh entry. Self-heals within one `POLL_INTERVAL` (the next scan
+    /// sees the PR), so not worth coordinating against; noted per argus's
+    /// review rather than left implicit.
     fn replace(&self, scan: HashMap<String, ConfigPrStatus>) {
         *self
             .0
@@ -152,7 +158,7 @@ impl ConfigPrCache {
 ///
 /// The scan runs immediately on the first tick (`tokio::time::interval`'s
 /// default), so the cache is populated on startup rather than staying empty
-/// for a full [`POLL_INTERVAL`] after boot.
+/// for a full `POLL_INTERVAL` after boot.
 pub fn spawn(client: Arc<Client>) -> Arc<ConfigPrCache> {
     let cache = Arc::new(ConfigPrCache::new());
     let cache_for_task = Arc::clone(&cache);