debug-control-plane 0.1.0__py3-none-any.whl

debug_control_plane-0.1.0.dist-info/METADATA

@@ -0,0 +1,98 @@
+Metadata-Version: 2.4
+Name: debug-control-plane
+Version: 0.1.0
+Summary: Multi-product reusable debug control plane (device discovery + MCP adapter).
+Author: tangxiaolu
+License: MIT
+Requires-Python: >=3.10
+Description-Content-Type: text/markdown
+License-File: LICENSE
+Requires-Dist: mcp<2,>=1.28
+Requires-Dist: httpx>=0.28
+Provides-Extra: test
+Requires-Dist: pytest>=7; extra == "test"
+Requires-Dist: pytest-cov>=4; extra == "test"
+Requires-Dist: ruff>=0.4; extra == "test"
+Dynamic: license-file
+
+# debug-control-plane (Python)
+
+Multi-product reusable debug control plane — Python slice.
+多产品复用的调试控制平面——Python 切片。
+
+Provides / 提供：
+- **device_discovery**: USB/WiFi device discovery + cross-identity pairing (USB identity source / LAN scan / VPN-immune subnet / device pool with TTL).
+  USB/WiFi 设备发现 + 跨身份配对（USB 身份源 / LAN 扫描 / VPN 免疫网段 / 带 TTL 的设备池）。
+- **mcp_plane**: MCP adapter over the R019 8-endpoint debug HTTP protocol — capability mirror (dynamic tools), bridge client, bare server, and a `SemanticProvider` protocol hook for product semantic sugar.
+  建立在 R019 8 端点调试 HTTP 协议之上的 MCP 适配器——能力镜像（动态 tools）、桥客户端、裸服务端，以及供产品语义糖接入的 `SemanticProvider` 协议钩子。
+
+## Dependency direction / 依赖方向
+
+```
+business app (pantas_launcher / future products)   业务应用（pantas_launcher / 未来产品）
+        │  depends on (downward)                     依赖（向下）
+        ▼
+debug_control_plane (this package)                        本包
+        │  depends on (downward)                     依赖（向下）
+        ▼
+  mcp (SDK) · httpx (HTTP client)
+```
+
+This package is **pure infrastructure**: it MUST NOT import any business package (`pantas_launcher`, `host4_flutter_gmacro`, gamepad/feature code). Business apps depend on this package; never the reverse.
+本包是**纯基础设施**：绝不 import 任何业务包（`pantas_launcher`、`host4_flutter_gmacro`、手柄/特性代码）。业务应用依赖本包，反之禁止。
+
+## Install / 安装
+
+```bash
+# editable install — picks up source changes without reinstall
+# 可编辑安装——源码改动即时生效，无需重装
+python -m pip install -e .
+
+# import sanity check / 导入自检
+python -c "import debug_control_plane; print(debug_control_plane.__version__)"
+```
+
+## Layout / 结构
+
+```
+python/
+├── pyproject.toml                  # single-package, two sub-packages / 单包双子包
+├── README.md                       # this file
+├── LICENSE                         # MIT
+└── debug_control_plane/
+    ├── __init__.py                 # __version__ = "0.1.0"
+    ├── device_discovery/           # USB/LAN device discovery + device pool
+    │   ├── device_candidates.py
+    │   ├── device_pool.py          # identity-keyed pool, TTL expiry / 身份键池，TTL 过期
+    │   ├── endpoint.py
+    │   ├── protocol.py
+    │   └── discovery/
+    │       ├── usb_identity.py     # USB identity source (adb / flutter devices) / USB 身份源
+    │       ├── lan_scan.py         # LAN /hello probe / LAN /hello 探测
+    │       ├── vpn_immune.py       # VPN-immune subnet calc / VPN 免疫网段计算
+    │       ├── cross_identify.py   # USB ⊕ LAN cross pairing / USB ⊕ LAN 交叉配对
+    │       └── manual_registry.py  # manually-told devices / 人工告知设备
+    └── mcp_plane/                  # MCP adapter
+        ├── capability_mirror.py    # dynamic tools from /hello / 由 /hello 动态镜像 tools
+        ├── bridge_client.py        # HTTP bridge client / HTTP 桥客户端
+        ├── server.py               # bare stdio MCP server / 裸 stdio MCP 服务端
+        └── semantic_provider.py    # SemanticProvider Protocol (product hook) / 语义糖协议钩子
+```
+
+## Console script / 控制台脚本
+
+```
+debug-control-plane-server
+```
+
+Points at `debug_control_plane.mcp_plane.server:main` — a bare server (no business capability assembly) for debugging / plane self-testing.
+指向 `debug_control_plane.mcp_plane.server:main`——裸服务端（无业务能力装配），用于调试 / 平面自测。
+
+## Version / 版本
+
+`0.1.0` — initial release, API unstable. 首发，API 不稳定。
+
+## License / 许可证
+
+Licensed under the MIT License — see [LICENSE](LICENSE).
+采用 MIT 许可证授权——见 [LICENSE](LICENSE)。

debug_control_plane-0.1.0.dist-info/RECORD

@@ -0,0 +1,23 @@
+debug_control_plane/__init__.py,sha256=TCTkdro2qRpkatqt0yjVF_Bom5I7RSG19zWv1e_hMws,283
+debug_control_plane/device_discovery/__init__.py,sha256=coHedH6e93514sX5DmGfxGS4t_imu17EitUxVp7vgEs,2493
+debug_control_plane/device_discovery/device_candidates.py,sha256=gC75X3jAALEn3KD6rcVTlw6JLK8osX0CUD7O-giB41U,10212
+debug_control_plane/device_discovery/device_pool.py,sha256=mvh8YW-Mhrcp9GoxJMB00IY5a6OLSxXKHq4ZCpiAQ4I,14746
+debug_control_plane/device_discovery/endpoint.py,sha256=3nTNIfgHvfWeJO5HG2_EVClPJSCmXsvJycmTR10UCmg,10619
+debug_control_plane/device_discovery/protocol.py,sha256=VbmMsmyQt4KShMzeqZWCS-1VkWw3VELGPtRvqVVC6MA,9082
+debug_control_plane/device_discovery/discovery/__init__.py,sha256=FE77P_yh-2OUEbz0tzRY0CYsXlp0_Tg6CXHM2VLMC8o,781
+debug_control_plane/device_discovery/discovery/cross_identify.py,sha256=RIhZjjxsgiy9QUuOrzLRJSIw_2gmdX7s2k1YRJGRjNE,17546
+debug_control_plane/device_discovery/discovery/lan_scan.py,sha256=eIN4OFdp6rt2HTo-dWd75EjsakaKfPqdkHqZQNfs7qQ,7048
+debug_control_plane/device_discovery/discovery/manual_registry.py,sha256=kKYGLFXv-o-_Nz6uN4eKoSM-_ckjce4KkSjCbf5XBpo,10327
+debug_control_plane/device_discovery/discovery/usb_identity.py,sha256=KnKXjurDg3XriaeewRecFH9B-Ol4sdijJJxOrQ3ORIk,10375
+debug_control_plane/device_discovery/discovery/vpn_immune.py,sha256=spOeCnOOho-4K57HAFP_VN8yqIpWKN4taHOMP7Af4Yc,4129
+debug_control_plane/mcp_plane/__init__.py,sha256=9Q_NQm89svWskptSsYIurUfEn3AqLacNkF4CSTWQGuc,1457
+debug_control_plane/mcp_plane/bridge_client.py,sha256=7X9sNkiFuEp1CKz7nxQrpM6aV_BbTZW-FKpuxnPMWFk,22077
+debug_control_plane/mcp_plane/capability_mirror.py,sha256=uAMlL6L3wndBuJM01s1AnnQAr_A7gBSLmo5Yb6ep51A,26889
+debug_control_plane/mcp_plane/semantic_provider.py,sha256=y8OauoMS8l05TkTuGnS7r8nJsmqixvtgpDMAWTwh_PY,2606
+debug_control_plane/mcp_plane/server.py,sha256=S3Fqq0pOxCICLzfF6ZcrGv7W1hwgBWGPAq-JfPLARcs,40924
+debug_control_plane-0.1.0.dist-info/licenses/LICENSE,sha256=qxYi0SeiUP4f92bHg1hLwb-wIr7900O27m_RCgJr0xQ,1075
+debug_control_plane-0.1.0.dist-info/METADATA,sha256=-4LR820UBGkDEgrCjDD5EJlu4cKy4-i6l7zqY9t-1Qs,4609
+debug_control_plane-0.1.0.dist-info/WHEEL,sha256=YVMoNqKzERt-wjUZwJ33xBGAwnFl-4cqbYkTtWa4itE,91
+debug_control_plane-0.1.0.dist-info/entry_points.txt,sha256=k5w44mHI2RTFclfTKX-jrBXCDxUsJ4MgC6Y0554kZ3U,89
+debug_control_plane-0.1.0.dist-info/top_level.txt,sha256=EQrD2n7aS1QZR4r9M0wO767ogy_yWiWk1U1RXI5ygEM,20
+debug_control_plane-0.1.0.dist-info/RECORD,,

debug_control_plane-0.1.0.dist-info/WHEEL

@@ -0,0 +1,5 @@
+Wheel-Version: 1.0
+Generator: setuptools (84.0.0)
+Root-Is-Purelib: true
+Tag: py3-none-any
+

debug_control_plane-0.1.0.dist-info/entry_points.txt

@@ -0,0 +1,2 @@
+[console_scripts]
+debug-control-plane-server = debug_control_plane.mcp_plane.server:main

debug_control_plane-0.1.0.dist-info/licenses/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026-present tangxiaolu
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

debug_control_plane-0.1.0.dist-info/top_level.txt

@@ -0,0 +1 @@
+debug_control_plane