docs(interface): document SshSession recv/send stubs as planned future work

Add doc comments and TODO markers to SshSession::recv() and send()
explicitly marking them as Phase 1 stubs. Notes that call protocol
event bridging from SSH channels is planned for Phase 2/3.
This commit is contained in:
2026-06-08 05:35:43 +00:00
parent 64c54b965e
commit 5cac68f95c
2 changed files with 10 additions and 2 deletions

View File

@@ -586,10 +586,18 @@ impl SshSession {
#[async_trait]
impl InterfaceSession for SshSession {
/// Stub for Phase 1 — always returns `None`.
///
/// TODO: Bridge `alknet-control:0` channel events to call protocol
/// `InterfaceEvent` frames. Planned for Phase 2/3.
async fn recv(&mut self) -> Option<InterfaceEvent> {
None
}
/// Stub for Phase 1 — accepts silently and discards.
///
/// TODO: Bridge outgoing `EventEnvelope` frames to the SSH channel
/// established by the call protocol. Planned for Phase 2/3.
async fn send(&mut self, _envelope: EventEnvelope) -> Result<()> {
Ok(())
}