Improve connection handling stubs

Cargo.toml

@@ -10,6 +10,7 @@ tokio = { version = "1", default-features = false, features = ["net", "signal",
 futures = "0.3"
 async-trait = "0.1"
 bytes = "1"
+log = "0.4"
 
 [lints.clippy]
 pedantic = "warn"

README.md

@@ -78,6 +78,13 @@ WireframeServer::new(|| {
 This example showcases how derive macros and the framing abstraction simplify a
 binary protocol server【F:docs/rust-binary-router-library-design.md†L1120-L1150】.
 
+## Current Limitations
+
+Connection processing is not implemented yet. After the optional
+preamble is read, the server logs a warning and immediately closes the
+stream. Release builds fail to compile to prevent accidental production
+use.
+
 ## Roadmap
 
 Development priorities are tracked in [docs/roadmap.md](docs/roadmap.md). Key

src/app.rs

@@ -85,13 +85,17 @@ impl WireframeApp {
 
     /// Handle an accepted connection.
     ///
-    /// This placeholder simply drops the stream. Future implementations
-    /// will decode frames and dispatch them to registered handlers.
+    /// This placeholder immediately closes the connection after the
+    /// preamble phase. A warning is logged so tests and callers are
+    /// aware of the current limitation.
     pub async fn handle_connection<S>(&self, _stream: S)
     where
         S: tokio::io::AsyncRead + tokio::io::AsyncWrite + Send + Unpin + 'static,
     {
-        // Connection handling will be implemented later.
+        log::warn!(
+            "`WireframeApp::handle_connection` called, but connection handling \
+             is not implemented; closing stream"
+        );
         tokio::task::yield_now().await;
     }
 }

src/server.rs

@@ -1,4 +1,9 @@
 use std::io;
+
+#[cfg(not(debug_assertions))]
+compile_error!(
+    "`wireframe` server functionality is experimental and not intended for production use"
+);
 use std::net::{SocketAddr, TcpListener as StdTcpListener};
 use std::sync::Arc;
 
@@ -86,7 +91,10 @@ where
     ///
     /// # Examples
     ///
-    /// ```
+    /// ```ignore
+    /// # use wireframe::server::WireframeServer;
+    /// # let factory = || todo!();
+    /// # struct MyPreamble;
     /// let server = WireframeServer::new(factory).with_preamble::<MyPreamble>();
     /// ```
     #[must_use]