From b3ab6ef0976c50d28fde2fbb579c73fb8d88466a Mon Sep 17 00:00:00 2001
From: "glm-5.2" <glm-5.2@alk.dev>
Date: Wed, 1 Jul 2026 23:37:35 +0000
Subject: [PATCH] docs(http): mark http/adapters/to-openapi completed + fix
 formatting

to_openapi gateway projection merged: 5-endpoint OpenAPI doc (ADR-042/045), pure
projection, info.version 1.0.0, error fidelity (ADR-023). 230 tests pass. Clippy clean.
---
 crates/alknet-http/src/server/adapter.rs    |  1 -
 crates/alknet-http/src/websocket/overlay.rs | 45 +++++++++++++--------
 tasks/http/adapters/to-openapi.md           | 11 ++++-
 3 files changed, 38 insertions(+), 19 deletions(-)

diff --git a/crates/alknet-http/src/server/adapter.rs b/crates/alknet-http/src/server/adapter.rs
index 5c2d7ab..3ac501a 100644
--- a/crates/alknet-http/src/server/adapter.rs
+++ b/crates/alknet-http/src/server/adapter.rs
@@ -695,7 +695,6 @@ mod tests {
         assert!(response.contains("location: https://example.com"));
     }
 
-
     #[tokio::test]
     async fn openapi_json_route_serves_gateway_spec() {
         let adapter = HttpAdapter::new(provider(), empty_registry());
diff --git a/crates/alknet-http/src/websocket/overlay.rs b/crates/alknet-http/src/websocket/overlay.rs
index 20ebae0..354562d 100644
--- a/crates/alknet-http/src/websocket/overlay.rs
+++ b/crates/alknet-http/src/websocket/overlay.rs
@@ -315,7 +315,10 @@ mod tests {
         let ctx = hub_root_context(
             "hub-acl-ok",
             &["ui/dragged"],
-            Some(CompositionAuthority::new("hub", vec!["ui:write".to_string()])),
+            Some(CompositionAuthority::new(
+                "hub",
+                vec!["ui:write".to_string()],
+            )),
             env.clone(),
         );
 
@@ -342,7 +345,10 @@ mod tests {
         let ctx = hub_root_context(
             "hub-acl-deny",
             &["ui/dragged"],
-            Some(CompositionAuthority::new("hub", vec!["ui:read".to_string()])),
+            Some(CompositionAuthority::new(
+                "hub",
+                vec!["ui:read".to_string()],
+            )),
             env.clone(),
         );
 
@@ -499,10 +505,12 @@ mod tests {
         assert!(conn.pending().lock().contains("ws-sub-root"));
         assert!(conn.pending().lock().contains("ws-sub-child"));
 
-        let failed = conn
-            .pending()
-            .lock()
-            .fail_all(alknet_call::protocol::wire::CallError::internal("connection closed"));
+        let failed =
+            conn.pending()
+                .lock()
+                .fail_all(alknet_call::protocol::wire::CallError::internal(
+                    "connection closed",
+                ));
         assert!(failed.contains(&"ws-sub-root".to_string()));
         assert!(failed.contains(&"ws-sub-child".to_string()));
         assert!(conn.pending().lock().is_empty());
@@ -526,10 +534,12 @@ mod tests {
             )
         };
 
-        let failed = conn
-            .pending()
-            .lock()
-            .fail_all(alknet_call::protocol::wire::CallError::internal("connection closed"));
+        let failed =
+            conn.pending()
+                .lock()
+                .fail_all(alknet_call::protocol::wire::CallError::internal(
+                    "connection closed",
+                ));
         assert!(failed.contains(&"hub-call-inflight".to_string()));
 
         let result = tokio::time::timeout(Duration::from_millis(100), rx).await;
@@ -566,7 +576,10 @@ mod tests {
             .await;
         let envelope: EventEnvelope = response.into();
         assert_eq!(envelope.r#type, EVENT_RESPONDED);
-        assert_eq!(envelope.payload.get("output"), Some(&serde_json::json!({ "v": 9 })));
+        assert_eq!(
+            envelope.payload.get("output"),
+            Some(&serde_json::json!({ "v": 9 }))
+        );
     }
 
     #[tokio::test]
@@ -667,10 +680,10 @@ mod tests {
 
     #[tokio::test]
     async fn browser_identity_resolved_at_upgrade_is_stored_on_connection() {
-        let provider = Arc::new(
-            StaticIdentityProvider::new()
-                .with_token("browser-token", identity_with_scopes("browser-user", &["ui:read"])),
-        );
+        let provider = Arc::new(StaticIdentityProvider::new().with_token(
+            "browser-token",
+            identity_with_scopes("browser-user", &["ui:read"]),
+        ));
         let registry = echo_registry();
         let dp = dispatcher(registry, Arc::clone(&provider) as Arc<dyn IdentityProvider>);
 
@@ -693,4 +706,4 @@ mod tests {
         let peer_ids = composed_env.peer_ids();
         assert_eq!(peer_ids, vec!["browser-user".to_string()]);
     }
-}
\ No newline at end of file
+}
diff --git a/tasks/http/adapters/to-openapi.md b/tasks/http/adapters/to-openapi.md
index 1e6d713..1c33108 100644
--- a/tasks/http/adapters/to-openapi.md
+++ b/tasks/http/adapters/to-openapi.md
@@ -1,7 +1,7 @@
 ---
 id: http/adapters/to-openapi
 name: Implement to_openapi gateway projection (5-endpoint OpenAPI doc, info.version semver, ADR-042/045)
-status: pending
+status: completed
 depends_on: [http/server/gateway-endpoints, http/gateway/gateway-dispatch-spine]
 scope: moderate
 risk: medium
@@ -185,4 +185,11 @@ out of scope.
 
 ## Summary
 
-> To be filled on completion
\ No newline at end of file
+> Implemented to_openapi(registry: &OperationRegistry) -> OpenAPISpec in src/adapters/
+> to_openapi.rs — pure projection generating fixed 5-endpoint gateway doc (/search,
+> /schema, /call, /batch, /subscribe) with info.version = 1.0.0 (ADR-045). /call responses
+> carry protocol-level errors (400/401/403/404/500/504) + operation-level errors from
+> registry error_schemas mapped by http_status (ADR-023). Per-caller operation surface
+> NOT preloaded (discovered via /search, ADR-042). /subscribe response is text/event-stream.
+> Wired GET /openapi.json in adapter.rs replacing placeholder 501. 16 new tests. 230
+> total tests pass. Clippy clean. Formatting fixed during merge.
\ No newline at end of file