docs(research): remove hedging language from alknet-ssh and alknet-tty research

- alknet-ssh: remove paragraphs describing old hedging problem in channel
  decomposition section and DP-4 — state the insight directly
- alknet-tty: replace 'defer for v1' / 'reserved for future use' with
  'not needed for the current scope' in OQ-TTY-02
This commit is contained in:
2026-07-05 13:08:29 +00:00
parent 73724b8a1d
commit 45fb7efbfc
2 changed files with 8 additions and 13 deletions

View File

@@ -71,14 +71,9 @@ copied and also since rewritten.
## The Channel Decomposition (Core Insight)
The initial research framed alknet-ssh's scope as a single massive v1: server
+ client + SOCKS5 + bidirectional port forwarding, all at once. That framing
made the crate feel unmanageably large and produced hedging language
("v1 default," "can be revisited later," "two-way door, decide later") that
proposed shipping non-functional or half-built versions. This revision
dissolves that problem by recognizing that **SSH's channel multiplexer is the
natural decomposition point**, and the features that felt like a massive scope
are layers that stack on top of it — each functional on its own.
SSH's channel multiplexer is the natural decomposition point. The features
that make up alknet-ssh are layers that stack on top of it — each functional
on its own.
### How SSH channels work
@@ -427,8 +422,7 @@ choice in the ssh spec.
### DP-4: Client + forwarding + SOCKS5 + SFTP scope — reframed as layer order
*(Recommended: one-way door on "all in alknet-ssh"; two-way door on extraction)*
The initial research framed this as "is all of this in v1?" — a massive scope
question. The channel decomposition dissolves it. The question is not "do we
The channel decomposition answers the scope question. The question is not "do we
ship it all at once" but "what's the build order, and are all the layers in
alknet-ssh?"