feat(gateway,adapters): /publish endpoint (ADR-068) + to_openapi 6-endpoint projection

gateway-publish:
- GatewayDispatch::invoke_sink (internal:false, forwarded_for:None)
- POST /publish: NDJSON body, first line {operation, chunk} (OQ-02
  resolved: first-line convention; terminal errors = plain HTTP status
  + JSON body, not NDJSON lines); 404 internal/unknown, 401/403 ACL,
  400 INVALID_OPERATION_TYPE for non-Pub
- ADR-068 + open-questions.md updated with the OQ-02 resolution

adapter-to-openapi:
- src/adapters/openapi_spec.rs: OpenAPISpec model (JSON/YAML/from_str
  JSON-first per ADR-051, $ref resolution) shared by from/to_openapi
- src/adapters/to_openapi.rs: 6-endpoint projection, info.version
  1.0.0 -> 1.1.0 (minor: /publish addition per ADR-045), /publish
  NDJSON doc with 400 oneOf (INVALID_INPUT + INVALID_OPERATION_TYPE),
  ADR-023 error fidelity (protocol statuses, HTTP_<status> passthrough,
  internal-op exclusion)
- GET /openapi.json wired into HttpAdapter's router (bearer-auth layer)

Verified: cargo test (136 lib), test --all-features (136+10 WS),
clippy -D warnings (both), fmt. Doc validates against openapiv3.
This commit is contained in:
2026-08-28 13:54:49 +00:00
parent ad975408e7
commit 42239a0af5
10 changed files with 2001 additions and 29 deletions
@@ -45,11 +45,11 @@ stream; the operation's final `ResponseEnvelope` is the HTTP response.
- Auth: `Authorization: Bearer <token>` — same as every gateway
endpoint ([ADR-004](004-auth-as-shared-core.md)).
- The target operation is named the same way as `/call` — the body's
first line (or a `?operation=` query parameter) carries
`{ "operation": "/{service}/{op}", "chunk": {...} }` for the first
chunk, with subsequent lines carrying `chunk` values only; see OQ-02
for the exact first-line convention before the gateway-spec version
bumps.
first line carries `{ "operation": "/{service}/{op}", "chunk": {...}`
for the first chunk, with subsequent lines carrying `chunk` values
only. (OQ-02 resolved: first-line convention, no query parameter, no
header; a `?operation=` parameter was rejected because it duplicates
the first-line field and complicates curl one-liners for no gain.)
### Dispatch
@@ -114,8 +114,10 @@ the doc does not preload operations.
indistinguishable from a network error to the server side (the
handler sees EOF either way). Callers needing explicit failure
semantics use the call protocol (WS channel 0).
- OQ-02 (first-line operation-naming convention) must settle before
the `/openapi.json` version bumps.
- ~~OQ-02 (first-line operation-naming convention) must settle before
the `/openapi.json` version bumps~~ — settled: first-line
`{operation, chunk}` convention; terminal errors are plain HTTP
status + JSON body (not an NDJSON line).
## References