feat(infra): full-surface integration suite + docs sync + publish prep
Full-surface integration suite (tests/full_surface.rs, mcp feature): - one HttpAdapter over real TCP (ProtocolHandler::handle path) serving gateway endpoints, /openapi.json, /mcp, and the WS channels session - gateway: search/schema/call/subscribe/batch/publish presence, envelope shapes, error fidelity end-to-end - from_openapi import -> Internal-by-default invisible from the wire -> External facade composes it via env.invoke -> upstream HTTP API called end-to-end (ADR-015 composition model exercised) - to_openapi 6-path doc validated against openapiv3 over the wire - to_mcp: MCP client connects to /mcp on the served adapter, lists the 4 gateway tools, search returns ACL-filtered ops (Sub excluded) Production fix: the WS upgrade route was reserved but never wired into HttpAdapter's router (the ws-upgrade-session tests built their own router). Now wired with ws_bearer_auth (401 without a resolvable token) around ws_upgrade_handler. Docs sync: all 28 'Port notes' sections/blockquotes stripped from ported ADRs/specs; OQ-01/OQ-02 statuses corrected to resolved in overview.md, websocket.md, and the README table (open-questions.md was already current). Publish prep: cargo publish --dry-run --allow-dirty succeeds; cargo doc --no-deps warning-free (ADR link targets fixed); feature combinations (default / test-support / mcp / wss / all) compile warning-free under clippy -D warnings. Verified: cargo test (182 lib default), --all-features (227 lib + 29 integration), clippy -D warnings x3 feature sets, fmt, doc, publish --dry-run.
This commit is contained in:
@@ -285,12 +285,14 @@ invariant. See
|
||||
|
||||
See [open-questions.md](open-questions.md) for full details.
|
||||
|
||||
- **OQ-01** (open): WS message ↔ byte-stream adaptation — the channels
|
||||
demux consumes bytes; axum WS yields messages. The adapter's
|
||||
buffering/flush semantics are the core implementation risk.
|
||||
- **OQ-02** (open): `/publish` body framing details — NDJSON chunk
|
||||
shape, error position.
|
||||
- **OQ-03** (open): `from_wss` reconnection semantics.
|
||||
- **OQ-01** (resolved): WS message ↔ byte-stream adaptation — the
|
||||
production adapter (`src/websocket/byte_adapter.rs`) is validated in
|
||||
both directions (server upgrade path + `from_wss` client).
|
||||
- **OQ-02** (resolved): `/publish` body framing — first line
|
||||
`{operation, chunk}`; terminal errors as plain HTTP status + JSON
|
||||
body (ADR-068).
|
||||
- **OQ-03** (open): `from_wss` reconnection semantics — v1 = drop →
|
||||
retryable failures (ADR-070); policy deferred to the assembly layer.
|
||||
|
||||
## References
|
||||
|
||||
|
||||
Reference in New Issue
Block a user