swbt-python 0.3.0__tar.gz → 0.5.0__tar.gz

{swbt_python-0.3.0 → swbt_python-0.5.0}/AGENTS.md

@@ -77,10 +77,18 @@
 | 実機観測 | `spec/hardware-test-log.md` |
 | 初期設計 | `spec/initial/` |
 
-作業仕様には、対象範囲、対象外、関連 docs、根拠監査、TDD Test List、検証、実機実行条件、先送り事項、チェックリストを含める。
+作業仕様には、対象範囲、対象外、関連 docs、根拠監査、TDD Test List または文書検証計画、検証、実機実行条件、先送り事項、チェックリストを含める。
 
 複数の作業仕様から参照する安定した判断は、既存の `spec/initial/` を更新するか、必要に応じて `spec/` 配下へ分ける。未確定の観測は `spec/dev-journal.md` に置く。
 
+## 文書の検証
+
+- 自然言語の意味要件を、固定語句の存在・不在 assertion に置き換えない。正しい言い換えを落とす検査、または誤った説明を通す検査は追加しない。
+- 自動検査の対象は、生成、構造、リンク、参照先、front matter、構造化データ、生成元との対応など、機械的に観測でき、失敗原因を切り分けられる契約に限る。
+- 説明の事実性、読者が手順を完了するための前提・操作・終了後の復帰手順、未検証範囲の伝達は、正本との照合を伴うレビューで検証する。pytest の成功をその根拠にしない。
+- docs / spec / skill だけの作業では、TDD Test List と pytest を必須にしない。選んだ自動検査、レビュー、未実行の検証を理由付きで記録する。
+- README、利用者向け docs、公開 API docstring、release notes を変更した場合は `docs-quality-review` を使い、未解決の修正必須事項を handoff または PR 本文に残す。
+
 ## Agent Skills
 
 repo-local skill は `.agents/skills` を正本として管理する。`.github/skills` には重複配置しない。
@@ -92,6 +100,7 @@ repo-local skill は `.agents/skills` を正本として管理する。`.github/
 - `spec-format`: `spec/wip` / `spec/complete` の作業仕様を作成、更新、完了移動する。
 - `dev-journal`: 小さい設計観測や先送り事項を `spec/dev-journal.md` に記録する。
 - `docs-wording`: README、docs、release notes の文言整理で、swbt-python 固有の訳語と残す英語表記をそろえる。
+- `docs-quality-review`: README、利用者向け docs、公開 API docstring、release notes を、対象読者の利用手順、根拠、未検証範囲、読みやすさの観点で確認する。
 - `source-audit`: Switch HID、Bumble、既存実装、実機ログ由来の値を根拠分類して記録する。
 - `hardware-harness`: Bumble adapter、Bluetooth dongle、Switch 実機を使う検証の承認境界と記録項目を確認する。
 - `tdd-workflow`: TDD Test List から red / green / refactor を進める。

{swbt_python-0.3.0 → swbt_python-0.5.0}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: swbt-python
-Version: 0.3.0
+Version: 0.5.0
 Summary: Python library for presenting an NX-compatible virtual Bluetooth HID input device.
 Keywords: bluetooth,bluetooth-hid,controller,gamepad,hid,nx
 Author: niart120
@@ -52,10 +52,10 @@ uv sync --dev
 
 [公開ドキュメント](https://niart120.github.io/swbt-python/) には API、利用例、実機準備手順、AI エージェント向け要約があります。
 
-- API 仕様: [API Reference](https://niart120.github.io/swbt-python/api/)
-- 利用例: [Usage Guide](https://niart120.github.io/swbt-python/usage/)
-- 実機準備手順とトラブルシューティング: [Hardware Guide](https://niart120.github.io/swbt-python/hardware/)
-- AI エージェント向け要約: [Agent Brief](https://niart120.github.io/swbt-python/agent-brief/)
+- [API リファレンス](https://niart120.github.io/swbt-python/api/)
+- [利用例](https://niart120.github.io/swbt-python/usage/)
+- [実機準備手順](https://niart120.github.io/swbt-python/hardware/)
+- [Agent Brief](https://niart120.github.io/swbt-python/agent-brief/)
 
 同じ内容は `docs/` 配下でも確認できます。
 
@@ -67,10 +67,7 @@ from swbt import Button, ProController
 
 
 async def main() -> None:
-    async with ProController(
-        adapter="usb:0",
-        key_store_path="switch-bond.json",
-    ) as pad:
+    async with ProController(adapter="usb:0") as pad:
         await pad.connect(
             timeout=30.0,
             allow_pairing=True,
@@ -82,11 +79,11 @@ async def main() -> None:
 asyncio.run(main())
 ```
 
-Pro Controller 相当の仮想デバイスを作成し、ペアリング後に A ボタン入力を送信するコードの例です。
+Pro Controller 相当の一時的な仮想デバイスを作成し、ペアリング後に A ボタン入力を送信するコードの例です。接続情報を永続化する場合は `ProController.create_profile()` を使います。`local_address` を省略するとアダプタが現在報告する Bluetooth アドレスを維持し、揮発領域へ書き込みません。利用者管理のローカルアドレスへ切り替える手順は[利用例](docs/usage.md)、対応する専用 USB Bluetooth ドングルと復旧手順は[実機準備手順](docs/hardware.md)を参照してください。
 
 ### Joy-Con L/R
 
-Joy-Con 相当の仮想デバイスは `JoyConL(...)` または `JoyConR(...)` で作成します。接続と入力の扱い方は `ProController` と同じです。
+Joy-Con 相当の仮想デバイスは `JoyConL(...)` または `JoyConR(...)` で作成します。以下の例は `JoyConL.create_profile()` で作成済みのプロファイルを再利用します。接続と入力の扱い方は `ProController` と同じです。
 
 ```python
 import asyncio
@@ -96,7 +93,7 @@ from swbt import Button, JoyConL, Stick
 async def main() -> None:
     async with JoyConL(
         adapter="usb:0",
-        key_store_path="switch-left-joycon-bond.json",
+        profile_path="switch-left-joycon-profile.json",
     ) as left:
         await left.connect(timeout=30.0, allow_pairing=True)
         await left.tap(Button.SR, Button.SL)
@@ -108,27 +105,27 @@ async def main() -> None:
 asyncio.run(main())
 ```
 
-"持ち方/順番を変える" 画面で Joy-Con としてペアリングする場合は、接続後に `await left.tap(Button.SR, Button.SL)` のように SR+SL を送信する必要があります。
+「持ちかた/順番を変える」画面で Joy-Con としてペアリングする場合は、接続後に `await left.tap(Button.SR, Button.SL)` のように SR+SL を送信する必要があります。
 
-Pro Controller、Joy-Con L、Joy-Con R では `key_store_path` を分けてください。Joy-Con L で右スティックや A/B/X/Y、Joy-Con R で左スティックや十字キーを入力すると `UnsupportedInputError` が送出されます。`JoyConPair` は未実装です。
+Pro Controller、周期送信型 Joy-Con、直接送信型はすべて、Bluetooth アドレスの選択方法とペアリングキーをまとめる `profile_path` を使います。新規プロファイルは各具象クラスの `create_profile()` で作成し、コントローラー形状と対象機器ごとに保存先を分けてください。v0.4.0 の `key_store_path` で使用していた JSON 形式のペアリング情報との互換経路はありません。Joy-Con L で右スティックや A/B/X/Y、Joy-Con R で左スティックや十字キーを入力すると `UnsupportedInputError` が送出されます。`JoyConPair` は未実装です。
 
 ## 接続方法
 
-実機接続には、PC の通常 Bluetooth 機能と共有しない専用 USB Bluetooth ドングルと、OS ごとのドライバー準備が必要です。Windows では、[Zadig](https://zadig.akeo.ie/) などで専用ドングルに WinUSB / libwdi ドライバーを入れてから アダプタ名を確認します。
+実機接続には、PC の通常 Bluetooth 機能と共有しない専用 USB Bluetooth ドングルと、OS ごとのドライバー準備が必要です。Windows では、[Zadig](https://zadig.akeo.ie/) などで専用ドングルに WinUSB / libwdi ドライバーを入れてからアダプタ名を確認します。
 
-ドライバー準備、アダプタ名の確認、トラブルシューティングの詳細は [Hardware Guide](https://niart120.github.io/swbt-python/hardware/) にあります。
+ドライバー準備、アダプタ名の確認、トラブルシューティングの詳細は[実機準備手順](https://niart120.github.io/swbt-python/hardware/)にあります。
 
 ### 確認済み構成
 
-2026-07-07 時点では、Windows 11 / CSR8510 A10 / WinUSB / `usb:0` / Switch 2 firmware 22.1.0 で、Pro Controller のペアリング、保存済みペアリング情報を使う再接続、主要なボタン / スティック入力、ニュートラル復帰を確認済みです。
+2026-07-07 時点では、Windows 11 / CSR8510 A10 / WinUSB / `usb:0` / Switch 2 ファームウェア 22.1.0 で、Pro Controller のペアリング、保存済みペアリング情報を使う再接続、主要なボタン / スティック入力、ニュートラル復帰を確認済みです。
 
-同じ Windows 構成で、Joy-Con L/R も部分的に動作確認済みです。確認済み範囲と未確認範囲の詳細は Hardware Guide にあります。
+同じ Windows 構成で、Joy-Con L/R も部分的に動作確認済みです。確認済み範囲と未確認範囲の詳細は[実機準備手順](https://niart120.github.io/swbt-python/hardware/)にあります。
 
 macOS 15.7.7 / CSR8510 A10 では、Pro Controller のペアリング、保存済みペアリング情報を使う再接続、ボタン入力、ニュートラル復帰を記録しています。
 
 ### 実験的構成
 
-Linux は experimental です。手順は Hardware Guide に整備されていますが、専用 USB Bluetooth ドングルにアクセスできるか、ペアリングできるか、入力が反映されるかは未確認です。macOS は Pro Controller の一部挙動のみ検証済みです。Joy-Con、別ドングル、別ファームウェアでの互換性は未確認です。
+Linux は experimental です。手順は[実機準備手順](https://niart120.github.io/swbt-python/hardware/)に整備されていますが、専用 USB Bluetooth ドングルにアクセスできるか、ペアリングできるか、入力が反映されるかは未確認です。macOS は Pro Controller の一部挙動のみ検証済みです。Joy-Con、別ドングル、別ファームウェアでの互換性は未確認です。
 
 ## 開発
 

swbt_python-0.5.0/README.md

@@ -0,0 +1,121 @@
+# swbt-python
+
+NX 向けの仮想 Bluetooth HID 入力デバイスを Python から扱うためのライブラリです。
+
+本ライブラリは pre-alpha 版です。実機での動作は Bluetooth ドングル、ドライバー、対象機器の FW バージョンに依存します。
+
+## 必要なもの
+
+- Python 3.12 以降
+- uv
+- Bumble が利用可能な専用 USB Bluetooth ドングル
+
+## インストール
+
+```powershell
+pip install swbt-python
+```
+
+ソースから動かす場合は次を使います。
+
+```powershell
+uv sync --dev
+```
+
+## ドキュメント
+
+[公開ドキュメント](https://niart120.github.io/swbt-python/) には API、利用例、実機準備手順、AI エージェント向け要約があります。
+
+- [API リファレンス](https://niart120.github.io/swbt-python/api/)
+- [利用例](https://niart120.github.io/swbt-python/usage/)
+- [実機準備手順](https://niart120.github.io/swbt-python/hardware/)
+- [Agent Brief](https://niart120.github.io/swbt-python/agent-brief/)
+
+同じ内容は `docs/` 配下でも確認できます。
+
+## 利用例
+### Pro Controller
+```python
+import asyncio
+from swbt import Button, ProController
+
+
+async def main() -> None:
+    async with ProController(adapter="usb:0") as pad:
+        await pad.connect(
+            timeout=30.0,
+            allow_pairing=True,
+        )
+        await pad.tap(Button.A)
+        await pad.neutral()
+
+
+asyncio.run(main())
+```
+
+Pro Controller 相当の一時的な仮想デバイスを作成し、ペアリング後に A ボタン入力を送信するコードの例です。接続情報を永続化する場合は `ProController.create_profile()` を使います。`local_address` を省略するとアダプタが現在報告する Bluetooth アドレスを維持し、揮発領域へ書き込みません。利用者管理のローカルアドレスへ切り替える手順は[利用例](docs/usage.md)、対応する専用 USB Bluetooth ドングルと復旧手順は[実機準備手順](docs/hardware.md)を参照してください。
+
+### Joy-Con L/R
+
+Joy-Con 相当の仮想デバイスは `JoyConL(...)` または `JoyConR(...)` で作成します。以下の例は `JoyConL.create_profile()` で作成済みのプロファイルを再利用します。接続と入力の扱い方は `ProController` と同じです。
+
+```python
+import asyncio
+from swbt import Button, JoyConL, Stick
+
+
+async def main() -> None:
+    async with JoyConL(
+        adapter="usb:0",
+        profile_path="switch-left-joycon-profile.json",
+    ) as left:
+        await left.connect(timeout=30.0, allow_pairing=True)
+        await left.tap(Button.SR, Button.SL)
+        await left.tap(Button.L)
+        await left.lstick(Stick.left())
+        await left.neutral()
+
+
+asyncio.run(main())
+```
+
+「持ちかた/順番を変える」画面で Joy-Con としてペアリングする場合は、接続後に `await left.tap(Button.SR, Button.SL)` のように SR+SL を送信する必要があります。
+
+Pro Controller、周期送信型 Joy-Con、直接送信型はすべて、Bluetooth アドレスの選択方法とペアリングキーをまとめる `profile_path` を使います。新規プロファイルは各具象クラスの `create_profile()` で作成し、コントローラー形状と対象機器ごとに保存先を分けてください。v0.4.0 の `key_store_path` で使用していた JSON 形式のペアリング情報との互換経路はありません。Joy-Con L で右スティックや A/B/X/Y、Joy-Con R で左スティックや十字キーを入力すると `UnsupportedInputError` が送出されます。`JoyConPair` は未実装です。
+
+## 接続方法
+
+実機接続には、PC の通常 Bluetooth 機能と共有しない専用 USB Bluetooth ドングルと、OS ごとのドライバー準備が必要です。Windows では、[Zadig](https://zadig.akeo.ie/) などで専用ドングルに WinUSB / libwdi ドライバーを入れてからアダプタ名を確認します。
+
+ドライバー準備、アダプタ名の確認、トラブルシューティングの詳細は[実機準備手順](https://niart120.github.io/swbt-python/hardware/)にあります。
+
+### 確認済み構成
+
+2026-07-07 時点では、Windows 11 / CSR8510 A10 / WinUSB / `usb:0` / Switch 2 ファームウェア 22.1.0 で、Pro Controller のペアリング、保存済みペアリング情報を使う再接続、主要なボタン / スティック入力、ニュートラル復帰を確認済みです。
+
+同じ Windows 構成で、Joy-Con L/R も部分的に動作確認済みです。確認済み範囲と未確認範囲の詳細は[実機準備手順](https://niart120.github.io/swbt-python/hardware/)にあります。
+
+macOS 15.7.7 / CSR8510 A10 では、Pro Controller のペアリング、保存済みペアリング情報を使う再接続、ボタン入力、ニュートラル復帰を記録しています。
+
+### 実験的構成
+
+Linux は experimental です。手順は[実機準備手順](https://niart120.github.io/swbt-python/hardware/)に整備されていますが、専用 USB Bluetooth ドングルにアクセスできるか、ペアリングできるか、入力が反映されるかは未確認です。macOS は Pro Controller の一部挙動のみ検証済みです。Joy-Con、別ドングル、別ファームウェアでの互換性は未確認です。
+
+## 開発
+
+```powershell
+uv sync --dev
+uv run ruff format --check .
+uv run ruff check .
+uv run ty check --no-progress
+uv run pytest tests/unit
+uv run pytest tests/integration
+```
+
+## ライセンス
+
+MIT ライセンスです。全文は [LICENSE](https://github.com/niart120/swbt-python/blob/main/LICENSE) にあります。
+
+## 注記
+
+このプロジェクトは、対象機器や関連商標の権利者から承認、後援、提携を受けたものではありません。

{swbt_python-0.3.0 → swbt_python-0.5.0}/examples/hardware_bringup.py

@@ -17,7 +17,7 @@ from swbt import Button, DiagnosticsConfig, ProController
 async def run(
     *,
     adapter: str,
-    key_store_path: str | None,
+    profile_path: str,
     trace_path: Path,
     connect_timeout: float,
     tap_duration: float,
@@ -26,7 +26,7 @@ async def run(
 
     Args:
         adapter: Bumble adapter moniker, such as ``"usb:0"``.
-        key_store_path: Optional pairing key store path.
+        profile_path: Existing swbt profile path.
         trace_path: JSON Lines diagnostics trace output path.
         connect_timeout: Seconds to wait for reconnect or pairing.
         tap_duration: Seconds to keep Button A pressed.
@@ -35,7 +35,7 @@ async def run(
     with trace_path.open("w", encoding="utf-8") as trace_writer:
         await _bring_up_with_trace(
             adapter=adapter,
-            key_store_path=key_store_path,
+            profile_path=profile_path,
             connect_timeout=connect_timeout,
             tap_duration=tap_duration,
             trace_writer=trace_writer,
@@ -45,7 +45,7 @@ async def run(
 async def _bring_up_with_trace(
     *,
     adapter: str,
-    key_store_path: str | None,
+    profile_path: str,
     connect_timeout: float,
     tap_duration: float,
     trace_writer: TextIO,
@@ -53,7 +53,7 @@ async def _bring_up_with_trace(
     diagnostics = DiagnosticsConfig(trace_writer=trace_writer)
     async with ProController(
         adapter=adapter,
-        key_store_path=key_store_path,
+        profile_path=profile_path,
         diagnostics=diagnostics,
     ) as pad:
         await pad.connect(
@@ -77,7 +77,9 @@ def build_parser() -> argparse.ArgumentParser:
         ),
     )
     parser.add_argument("--adapter", default="usb:0", help="Bumble adapter moniker")
-    parser.add_argument("--key-store", dest="key_store_path", help="pairing key store path")
+    parser.add_argument(
+        "--profile", dest="profile_path", required=True, help="existing swbt profile path"
+    )
     parser.add_argument("--trace", required=True, type=Path, help="JSON Lines trace output path")
     parser.add_argument("--timeout", default=30.0, type=float, help="connection timeout seconds")
     parser.add_argument(
@@ -102,7 +104,7 @@ def main(argv: Sequence[str] | None = None) -> int:
     asyncio.run(
         run(
             adapter=args.adapter,
-            key_store_path=args.key_store_path,
+            profile_path=args.profile_path,
             trace_path=args.trace,
             connect_timeout=args.timeout,
             tap_duration=args.tap_duration,

swbt_python-0.5.0/examples/pairing_probe.py

@@ -0,0 +1,73 @@
+"""Create one Pro Controller profile after explicit hardware approval."""
+
+import argparse
+import asyncio
+from collections.abc import Sequence
+from pathlib import Path
+
+from swbt import DiagnosticsConfig, ProController
+
+
+async def run(
+    *,
+    adapter: str,
+    profile_path: str,
+    local_address: str,
+    trace_path: Path,
+    pair_timeout: float,
+) -> None:
+    """Create a profile and run its first approved pairing.
+
+    Args:
+        adapter: Bumble adapter moniker, such as ``"usb:0"``.
+        profile_path: New swbt profile path. It must not already exist.
+        local_address: Individual locally administered Bluetooth address.
+        trace_path: JSON Lines diagnostics trace output path.
+        pair_timeout: Seconds to wait for a host connection.
+    """
+    trace_path.parent.mkdir(parents=True, exist_ok=True)
+    with trace_path.open("w", encoding="utf-8") as trace_writer:
+        pad = await ProController.create_profile(
+            adapter=adapter,
+            profile_path=profile_path,
+            local_address=local_address,
+            pair_timeout=pair_timeout,
+            diagnostics=DiagnosticsConfig(trace_writer=trace_writer),
+        )
+        await pad.close()
+
+
+def build_parser() -> argparse.ArgumentParser:
+    """Build the example argument parser."""
+    parser = argparse.ArgumentParser(
+        description="Create a profile and pair after explicit approval with cleanup.",
+    )
+    parser.add_argument("--adapter", default="usb:0", help="Bumble adapter moniker")
+    parser.add_argument("--profile", required=True, help="new swbt profile path")
+    parser.add_argument(
+        "--local-address",
+        required=True,
+        help="individual locally administered Bluetooth address",
+    )
+    parser.add_argument("--trace", required=True, type=Path, help="JSON Lines trace output path")
+    parser.add_argument("--timeout", default=30.0, type=float, help="pairing timeout seconds")
+    return parser
+
+
+def main(argv: Sequence[str] | None = None) -> int:
+    """Run the example."""
+    args = build_parser().parse_args(argv)
+    asyncio.run(
+        run(
+            adapter=args.adapter,
+            profile_path=args.profile,
+            local_address=args.local_address,
+            trace_path=args.trace,
+            pair_timeout=args.timeout,
+        )
+    )
+    return 0
+
+
+if __name__ == "__main__":
+    raise SystemExit(main())

{swbt_python-0.3.0 → swbt_python-0.5.0}/examples/tap_a.py

@@ -29,7 +29,7 @@ async def tap_a_once(pad: SwitchGamepad, *, duration: float = 0.08) -> None:
 async def run(
     *,
     adapter: str,
-    key_store_path: str | None,
+    profile_path: str,
     connect_timeout: float,
     duration: float,
     allow_pairing: bool,
@@ -38,12 +38,12 @@ async def run(
 
     Args:
         adapter: Bumble adapter moniker, such as ``"usb:0"``.
-        key_store_path: Optional pairing key store path.
+        profile_path: Existing swbt profile path.
         connect_timeout: Seconds to wait for each connection attempt.
         duration: Seconds to keep Button A pressed.
         allow_pairing: If ``True``, allow first-time pairing when no bond exists.
     """
-    async with ProController(adapter=adapter, key_store_path=key_store_path) as pad:
+    async with ProController(adapter=adapter, profile_path=profile_path) as pad:
         await pad.connect(
             timeout=connect_timeout,
             allow_pairing=allow_pairing,
@@ -61,7 +61,9 @@ def build_parser() -> argparse.ArgumentParser:
         description="Tap Button A once through swbt-python.",
     )
     parser.add_argument("--adapter", default="usb:0", help="Bumble adapter moniker")
-    parser.add_argument("--key-store", dest="key_store_path", help="pairing key store path")
+    parser.add_argument(
+        "--profile", dest="profile_path", required=True, help="existing swbt profile path"
+    )
     parser.add_argument("--timeout", default=30.0, type=float, help="connection timeout seconds")
     parser.add_argument(
         "--duration",
@@ -90,7 +92,7 @@ def main(argv: Sequence[str] | None = None) -> int:
     asyncio.run(
         run(
             adapter=args.adapter,
-            key_store_path=args.key_store_path,
+            profile_path=args.profile_path,
             connect_timeout=args.timeout,
             duration=args.duration,
             allow_pairing=args.allow_pairing,

{swbt_python-0.3.0 → swbt_python-0.5.0}/pyproject.toml

@@ -1,6 +1,6 @@
 [project]
 name = "swbt-python"
-version = "0.3.0"
+version = "0.5.0"
 description = "Python library for presenting an NX-compatible virtual Bluetooth HID input device."
 readme = "README.md"
 authors = [
@@ -141,7 +141,7 @@ error-on-warning = true
 output-format = "concise"
 
 [tool.pytest.ini_options]
-addopts = "-ra --strict-config --strict-markers"
+addopts = "-ra --strict-config --strict-markers --basetemp=tmp/pytest"
 testpaths = ["tests"]
 markers = [
     "bumble: requires a dedicated USB Bluetooth dongle opened through Bumble",

{swbt_python-0.3.0 → swbt_python-0.5.0}/spec/complete/unit_005/M4_SUBCOMMAND_RESPONDER_HARDWARE.md

@@ -60,7 +60,7 @@ Switch から受け取る output report と subcommand sequence を実機 trace
 | 項目 | 要否 | 状態 | 根拠 / 理由 |
 |---|---|---|---|
 | Switch HID / report bytes | required | done | `tests/unit/fixtures/source_audit/switch_protocol_values.toml` の `output_report_parser_layout`、`subcommand_reply_0x21_layout`、`subcommand_reply_payloads`、`spi_flash_boundary_and_seed_map`、`raw_rumble_payload` を source fact / implementation fact として使う |
-| Bumble / transport | required | done | `bumble_hid_device_api`、`bumble_hidp_output_report_boundary`、`btstack_reference_hid_sdp_policy`、`bumble_reference_classic_link_policy`、`bumble_acl_packet_queue_drain_boundary` を使う。Bumble `0.0.230` の DATA / SET_REPORT callback 境界、参照実装の HID SDP policy、service name / language base 属性、daemon production の default link policy `ROLE_SWITCH|SNIFF_MODE` = `0x0005`、HID interrupt write 後の ACL queue drain 境界は根拠化済み。実機 sequence の callback timing は M4 実行時の hardware observation として別記録にする |
+| Bumble / transport | required | done | `bumble_hid_device_api`、`bumble_hidp_output_report_boundary`、`btstack_reference_hid_sdp_policy`、`bumble_reference_classic_link_policy`、`bumble_acl_packet_queue_drain_boundary` を使う。Bumble `0.0.230` の DATA / SET_REPORT callback 境界、参照実装の HID SDP policy、service name / language base 属性、daemon production の default link policy `ROLE_SWITCH|SNIFF_MODE` = `0x0005`、ACL queue の投入・drain 境界は根拠化済み。通常送信をenqueue受理、明示切断をdrain境界とする現行方針は unit_064 で更新した。実機 sequence の callback timing は M4 実行時の hardware observation として別記録にする |
 | OS / driver / adapter | required | done | `swbt_daemon_csr8510_winusb_observation` は既存 daemon の条件付き観測であり、Bumble / 別 firmware へ一般化しない。M4 実機 trace は adapter、driver、Bumble version、Switch firmware 付きで `docs/hardware-test-log.md` に記録する |
 
 ## 6. 振る舞い仕様