Skip to content

Flux-network re-design - #135

Open
Bronek wants to merge 1 commit into
mainfrom
bronek/api_server_design
Open

Flux-network re-design#135
Bronek wants to merge 1 commit into
mainfrom
bronek/api_server_design

Conversation

@Bronek

@Bronek Bronek commented Aug 25, 2026

Copy link
Copy Markdown

Includes documents:

  • CONTEXT.md: the workspace glossary (Tile, Spine, Signal, Waker; Stream, Group, Tenant, Raw group, Owned/External mode, Endpoint, Peer, Deadline, Draining, Lingering, Refused).
  • ADR 0001: poll ownership is a construction-time mode of the stream network, and protocol layers are tenants the network schedules — one driver owns deadline folding, routing by group, maintenance order and ticking; tenants expose their events by pull; hooks stay private behind an opaque TenantRef carrier.
  • ADR 0002: transports are the closed set Endpoint { Tcp, Unix }.
  • ADR 0003: Unix-domain socket files are probed (lstat, then connect) before a stale one is replaced, and removed on close.
  • docs/extension-points.md: eventual (streamed responses) and speculative (TLS, Unix socket file mode, QUIC) directions the design keeps open without deciding.

Assisted-by: Claude Code:claude-fable-5

…stream network

Record the design for flux-network before the implementation stack lands:

- CONTEXT.md: the workspace glossary (Tile, Spine, Signal, Waker; Stream, Group,
  Tenant, Raw group, Owned/External mode, Endpoint, Peer, Deadline, Draining,
  Lingering, Refused).
- ADR 0001: poll ownership is a construction-time mode of the stream network, and
  protocol layers are tenants the network schedules — one driver owns deadline
  folding, routing by group, maintenance order and ticking; tenants expose their
  events by pull; hooks stay private behind an opaque TenantRef carrier.
- ADR 0002: transports are the closed set Endpoint { Tcp, Unix }.
- ADR 0003: Unix-domain socket files are probed (lstat, then connect) before a
  stale one is replaced, and removed on close.
- docs/extension-points.md: eventual (streamed responses) and speculative (TLS,
  Unix socket file mode, QUIC) directions the design keeps open without deciding.

All three ADRs are accepted.

Assisted-by: Claude Code:claude-fable-5
@Bronek
Bronek requested a review from a team August 25, 2026 16:40
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant