[PR] feat(runtime-host): add experimental direct peer transport [maka]

["M4n5ter (via GitHub)" <gi...@apache.org>]

M4n5ter opened a new pull request, #3877:
URL: https://github.com/apache/maka/pull/3877

   <details open>
   <summary>English</summary>
   
   ## Summary
   
   Add the Milestone 1 experimental direct-peer transport from #3842:
   
   - run rust-libp2p behind a small napi-rs boundary
   - adapt verified direct streams to the existing Runtime Host framing, handshake, credential, listener, reconnect, and shutdown contracts
   - pin profiles to the expected PeerId and Root ID while keeping route hints mutable
   - allow relay coordination for DCUtR, but never admit Runtime Host application traffic over a relayed connection
   - expose operator-only CLI configuration; managed distribution and Desktop onboarding remain follow-up work
   
   Refs #3842
   
   ## Verification
   
   - `cargo fmt --check` and `cargo clippy --locked --all-targets -- -D warnings`
   - native addon build and real Node endpoint startup on macOS and Linux
   - three-platform native admission workflow added for macOS, Linux, and Windows
   - `npm run lint`, `npm run format:check`, `npm run build`, and `npm run typecheck`
   - affected Runtime Host framing, profile, listener/kernel, and CLI suites
   - real Runtime Host status request over a verified local direct peer stream
   - macOS-to-Linux direct native stream over LAN
   - ASF source/header checks and required Knip checks
   
   The controlled NAT harness still needs one clean rerun before this leaves draft: its latest attempt also broke the independent reference spike because of the test host's policy-routing state, so that run is not treated as product evidence.
   
   ## AI use
   
   Select exactly one:
   
   - [ ] No generative tool made a substantive contribution
   - [x] Generative tooling made a substantive contribution
   
   Tool(s) and scope: Codex implemented and verified the change under the contributor's direction. Final human review remains required.
   
   ## Checklist
   
   - [x] Tests cover the change and fail without it
   - [x] Lint, format, typecheck and the affected suites pass locally
   
   Does this PR entail a change in behavior?
   
   - [x] Yes — described under Summary above
   - [ ] No
   
   </details>
   
   <details>
   <summary>中文</summary>
   
   ## 摘要
   
   实现 #3842 Milestone 1 的实验性 direct-peer transport：
   
   - 在精简的 napi-rs 边界后运行 rust-libp2p
   - 将已验证的 direct stream 适配到现有 Runtime Host framing、handshake、credential、listener、reconnect 与 shutdown 契约
   - profile 固定预期 PeerId 与 Root ID，同时允许 route hints 更新
   - 允许 Relay 协助 DCUtR 协调，但绝不允许 Runtime Host application traffic 经 relayed connection 进入
   - 本 PR 只提供 operator CLI 配置；managed distribution 与 Desktop onboarding 留给后续 PR
   
   Refs #3842
   
   ## 验证
   
   - `cargo fmt --check` 与 `cargo clippy --locked --all-targets -- -D warnings`
   - macOS、Linux 上构建 native addon 并真实启动 Node endpoint
   - 新增 macOS、Linux、Windows 三平台 native admission workflow
   - `npm run lint`、`npm run format:check`、`npm run build` 与 `npm run typecheck`
   - 受影响的 Runtime Host framing、profile、listener/kernel 与 CLI 测试
   - 真实 Runtime Host status request 经已验证的本地 direct peer stream 完成
   - macOS 到 Linux 的 LAN direct native stream
   - ASF source/header 检查与要求的 Knip 检查
   
   离开 Draft 前仍需干净重跑一次受控 NAT harness：最近一次测试中，测试机的 policy routing 状态也导致独立 reference spike 失败，因此该轮结果不作为产品证据。
   
   ## AI 使用
   
   请且仅选择一项：
   
   - [ ] 没有生成式工具作出实质贡献
   - [x] 生成式工具作出了实质贡献
   
   工具与范围：Codex 在贡献者指导下实现并验证本次改动；最终仍需人工审查。
   
   ## Checklist
   
   - [x] 测试覆盖本次变更，并会在缺少变更时失败
   - [x] lint、format、typecheck 与受影响测试已在本地通过
   
   本 PR 是否改变行为？
   
   - [x] 是——已在摘要中说明
   - [ ] 否
   
   </details>
   


-- 
This is an automated message from the Apache Git Service.
To respond to the message, please log on to GitHub and use the
URL above to go to the specific comment.

To unsubscribe, e-mail: commits-unsubscribe@maka.apache.org

For queries about this service, please contact Infrastructure at:
users@infra.apache.org


---------------------------------------------------------------------
To unsubscribe, e-mail: commits-unsubscribe@maka.apache.org
For additional commands, e-mail: commits-help@maka.apache.org

Re: [PR] feat(runtime-host): add experimental direct peer transport [maka]

["M4n5ter (via GitHub)" <gi...@apache.org>]

M4n5ter merged PR #3877:
URL: https://github.com/apache/maka/pull/3877


-- 
This is an automated message from the Apache Git Service.
To respond to the message, please log on to GitHub and use the
URL above to go to the specific comment.

To unsubscribe, e-mail: commits-unsubscribe@maka.apache.org

For queries about this service, please contact Infrastructure at:
users@infra.apache.org


---------------------------------------------------------------------
To unsubscribe, e-mail: commits-unsubscribe@maka.apache.org
For additional commands, e-mail: commits-help@maka.apache.org