swbt-python 0.5.2__tar.gz → 0.5.3__tar.gz

{swbt_python-0.5.2 → swbt_python-0.5.3}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: swbt-python
-Version: 0.5.2
+Version: 0.5.3
 Summary: Python library for presenting an NX-compatible virtual Bluetooth HID input device.
 Keywords: bluetooth,bluetooth-hid,controller,gamepad,hid,nx
 Author: niart120
@@ -18,7 +18,7 @@ Classifier: Programming Language :: Python :: 3.12
 Classifier: Programming Language :: Python :: 3.13
 Classifier: Topic :: Software Development :: Libraries
 Classifier: Typing :: Typed
-Requires-Dist: bumble>=0.0.230,<0.0.231
+Requires-Dist: bumble==0.0.233
 Maintainer: niart120
 Maintainer-email: niart120 <38847256+niart120@users.noreply.github.com>
 Requires-Python: >=3.12

{swbt_python-0.5.2 → swbt_python-0.5.3}/pyproject.toml

@@ -1,6 +1,6 @@
 [project]
 name = "swbt-python"
-version = "0.5.2"
+version = "0.5.3"
 description = "Python library for presenting an NX-compatible virtual Bluetooth HID input device."
 readme = "README.md"
 authors = [
@@ -34,7 +34,7 @@ classifiers = [
     "Typing :: Typed",
 ]
 dependencies = [
-    "bumble>=0.0.230,<0.0.231",
+    "bumble==0.0.233",
 ]
 
 [project.scripts]

swbt_python-0.5.3/spec/complete/unit_083/PROFILE_SCHEMA_V2_CURRENT_KEY_ONLY.md

@@ -0,0 +1,133 @@
+# Pairing profile schema v2: current key only
+
+## 1. 概要
+
+### 1.1 目的
+
+pairing profile schema を v2 に上げ、現在選択中の Bluetooth address namespace だけへ pairing key を保存する。v1 profile は runtime で読み替えず、adapter を開く前に再ペアリングを案内する `InvalidProfileError` で拒否する。
+
+### 1.2 起点 / source
+
+| source | 内容 | path |
+|---|---|---|
+| GitHub Issue #143 | previous pairing key 世代の廃止、schema v2、破壊的変更の利用者案内 | `https://github.com/niart120/swbt-python/issues/143` |
+| 実装事実 | v1 は current key 更新時に `swbt.previous::` namespace を書き込む | `src/swbt/transport/_pairing_profile.py`, `src/swbt/transport/_bumble_key_store.py` |
+
+### 1.3 use case
+
+| actor / boundary | 入力または状態 | 期待する観測結果 | 制約 |
+|---|---|---|---|
+| 新規 explicit profile 利用者 | locally administered address を指定して profile を作成 | schema v2 と当該 address の空 namespace だけを保存する | previous namespace を作らない |
+| adapter-default profile 利用者 | profile 作成後、power-on で current address が解決する | 解決済み address の current namespace だけを key 更新する | profile 作成時は空 map |
+| v1 profile 利用者 | `profile_path` を runtime へ渡す | adapter open 前に v2 profile の作成と再ペアリングを示す `InvalidProfileError` | compatibility load / migration を提供しない |
+
+## 2. 対象範囲
+
+- schema version を 2 にする。
+- new profile、key update、diagnostics から previous 世代を除く。
+- current namespace の key lookup、複数 peer 拒否、atomic save、identity guard を維持する。
+- fake transport の pairing / reconnect と explicit / adapter-default variant を確認する。
+- 公開 docs と release notes に破壊的変更と再ペアリング手順を記載する。
+
+## 3. 対象外
+
+- BD_ADDR 切替、identity kind、CSR identity preparation の変更。
+- previous key fallback、復元 API / CLI、v1 互換読込、自動または in-place migration。
+- 実機 pairing / reconnect の実行。
+
+## 4. 関連 docs
+
+- `spec/initial/architecture.md`
+- `spec/initial/api.md`
+- `spec/initial/lifecycle.md`
+- `spec/initial/testing.md`
+- `docs/usage.md`
+- `docs/release-notes.md`
+
+## 5. 根拠監査
+
+| 項目 | 要否 | 状態 | 根拠 / 理由 |
+|---|---|---|---|
+| Switch HID / report bytes | not applicable | not applicable | report format、subcommand、input timing を変更しない。 |
+| Bumble / transport | not applicable | not applicable | Bumble API / SDP / L2CAP の仮定を追加せず、既存 key-store adapter の保存世代だけを変更する。 |
+| OS / driver / adapter | not applicable | not applicable | adapter open や driver 操作を変更しない。 |
+
+## 6. 振る舞い仕様
+
+| 振る舞い | 入力・状態 | 期待結果 | 備考 |
+|---|---|---|---|
+| v2 profile creation | explicit address | current address namespace だけを持つ schema v2 JSON | atomic create を維持 |
+| v1 early rejection | schema v1 JSON | adapter open 前に v2 と再ペアリングを案内する `InvalidProfileError` | migration しない |
+| current-only update | current key を新しい peer key で更新 | current namespace は新しい 1 peer だけ、previous namespace は作成しない | active lookup は current のみ |
+| diagnostics | key update 成功 / 失敗 | status、peer_address、失敗時 error_type/message だけを記録 | key material、generation、previous_saved は出さない |
+
+## 7. TDD Test List
+
+| status | item | type | layer | hardware | notes |
+|---|---|---|---|---|---|
+| refactor-skipped | explicit address の新規 profile は schema v2 と current namespace だけを保存する | regression | unit | no | `test_pairing_profile_create_new_atomically_saves_schema_v2_current_only_pro_envelope` が red から green。構造整理なし。 |
+| refactor-skipped | schema v1 profile は adapter open 前に再作成・再ペアリングを案内して拒否する | regression | unit | no | loader と runtime の両方で v1 を拒否し、transport creation 前の停止を確認。構造整理なし。 |
+| refactor-skipped | current key 更新は previous namespace を作らず、current key だけを置換する | regression | integration | no | `_PairingProfileKeyStore.update()` の 2 回更新を確認。構造整理なし。 |
+| refactor-skipped | adapter-default profile は power-on 後に解決した current namespace だけを更新する | regression | unit / integration | no | existing Bumble fake device test で遅延 namespace 選択を確認。構造整理なし。 |
+| refactor-skipped | key_store_update diagnostics は generation / previous_saved を記録しない | regression | unit | no | 成功・失敗 event の両方を確認。構造整理なし。 |
+| refactor-skipped | v2 profile は fake transport pairing と active reconnect で current key を利用する | regression | integration | no | integration suite の fake transport pairing / reconnect と profile key-store update を通過。構造整理なし。 |
+
+## 8. 文書検証計画
+
+| document | audience / task | source of truth | mechanical check | review result | unresolved |
+|---|---|---|---|---|---|
+| `docs/usage.md` | v1 profile の利用者が v2 profile を作り直して再ペアリングする | Issue #143 と profile loader | `uv run --group docs mkdocs build --strict` | done | none |
+| `docs/release-notes.md` | 破壊的変更と compatibility / migration 非提供を把握する | Issue #143 | `uv run --group docs mkdocs build --strict` | done | none |
+
+## 9. 設計メモ
+
+これは behavior change である。green 後の構造整理は、current-only 保存を変えない範囲に分離する。v1 error は loader に置き、adapter の生成・open より前に失敗させる。
+
+## 10. 対象ファイル
+
+| path | change | 内容 |
+|---|---|---|
+| `src/swbt/transport/_pairing_profile.py` | modify | v2 envelope creation と v1 rejection message |
+| `src/swbt/transport/_bumble_key_store.py` | modify | previous generation を除く current-only update と diagnostics |
+| `tests/unit/test_pairing_profile.py` | modify | v2 / v1 early rejection |
+| `tests/unit/test_bumble_transport.py` | modify | diagnostics と adapter-default current namespace |
+| `tests/integration/test_pairing_profile.py` | modify | fake transport pairing / reconnect の保存契約 |
+| `docs/usage.md` | modify | v1 profile の再作成・再ペアリング |
+| `docs/release-notes.md` | modify | breaking change |
+| `spec/initial/lifecycle.md` | modify | current-only key store と v1 非互換の設計判断 |
+
+## 11. 検証
+
+| command | result | notes |
+|---|---|---|
+| `uv run pytest tests/unit -q --basetemp tmp/issue143-unit` | passed, 448 passed | profile loader、runtime、Bumble fake device、diagnostics を含む |
+| `uv run pytest tests/integration -q --basetemp tmp/issue143-integration-all` | passed, 154 passed | fake transport pairing / reconnect と profile key-store update を含む |
+| `uv run ruff format --check .` | passed | 106 files formatted |
+| `uv run ruff check .` | passed | lint passed |
+| `uv run ty check --no-progress` | passed | type check passed |
+| `uv run --group docs mkdocs build --strict` | passed | public docs build passed |
+| `uv build` | passed | `swbt_python-0.5.2.tar.gz` と `swbt_python-0.5.2-py3-none-any.whl` を作成 |
+| `pytest -m bumble` / `pytest -m hardware` | not run | adapter / Switch 操作の明示承認がない。Issue の必須条件ではない。 |
+
+## 12. 実機実行条件
+
+| 項目 | 内容 |
+|---|---|
+| 実機要否 | not required |
+| 承認範囲 | 実機確認は Issue 完了条件に含めない。実行する場合は別途明示承認を得る。 |
+| adapter | not applicable |
+| 実行遮断 | 環境変数による遮断は採用しない。明示承認、対象 adapter、command、cleanup plan で管理する |
+| log / artifact | 実行時のみ `spec/hardware-test-log.md` に記録する |
+| cleanup | 実機未実行 |
+
+## 13. 先送り事項
+
+- none
+
+## 14. チェックリスト
+
+- [x] 対象範囲と対象外を確認した
+- [x] TDD Test List または文書検証計画を更新した
+- [x] 必要な根拠監査を記録した
+- [x] 実機実行条件を記録した
+- [x] 検証結果または未実行理由を記録した

{swbt_python-0.5.2 → swbt_python-0.5.3}/spec/hardware-test-log.md

@@ -6,6 +6,10 @@ Bumble adapter と対象機器に依存する観測を記録する正本であ
 
 ## Current Status
 
+- 2026-07-25 unit_084 Bumble 0.0.233 Switch 2 fresh pairing / Button A: Windows `Windows-11-10.0.26200-SP0` / dedicated `usb:0` / CSR8510 A10 / WinUSB / Bumble 0.0.233 / Python 3.13.5 / swbt-python 0.5.2 / Switch 2 firmware 22.5.0 で、`uv run pytest "tests/hardware/test_reply_holdoff.py::test_switch_reply_holdoff_variant_fresh_pairing_characterizes_readiness_and_a_input[0.3-True]" -m hardware --swbt-bumble-adapter usb:0 --swbt-hardware-artifact-dir tmp/hardware/unit_084/fresh-a-switch2-20260725` を実行し、`1 passed in 10.34s`。承認範囲は `usb:0` の Bumble adapter open、Pro Controller fresh pairing、HID advertising、Button A 送信、neutral close、adapter release である。BD_ADDR 書換えと active reconnect は実行していない。trace は fresh pairing、key store update、control / interrupt L2CAP、protocol ready、`reason=input` の `0x30` report、disconnect terminal `closed`、transport close complete を記録した。利用者は Switch 2 の画面上で Button A が反映されたこと、および firmware と driver identity が既存実験から不変であることを確認した。driver assignment の再照会はこの run ではしていない。artifact は `tmp/hardware/unit_084/fresh-a-switch2-20260725/reply-holdoff-fresh-periodic-0_300.json` と `tmp/hardware/unit_084/fresh-a-switch2-20260725/reply-holdoff-fresh-periodic-0_300.jsonl`。
+
+- 2026-07-25 unit_084 Bumble 0.0.233 adapter open-only: Windows `Windows-11-10.0.26200-SP0` / `usb:0` / Bumble 0.0.233 / Python 3.13.5 / swbt-python 0.5.2 で、`uv run pytest tests/hardware/test_context_manager_resource_scope.py -m bumble --swbt-bumble-adapter usb:0 --swbt-hardware-artifact-dir tmp/hardware/unit_084/bumble-open-only` を実行し `1 passed in 0.36s`。承認範囲は Bumble adapter open、transport 初期化、close / adapter release だけである。trace は `transport_open_complete`、`disconnect_request(status=unavailable, reason=channels_not_connected)`、`transport_close_complete` を記録し、`advertising_start` と `host_connection` は記録しなかった。Switch pairing、HID advertising、report loop、Switch-facing message は実行していない。driver identity はこの run で再確認していない。artifact は `tmp/hardware/unit_084/bumble-open-only/resource-open-only.jsonl`。
+
 - 2026-07-25 issue_139 reply holdoff comparison: Windows 11 `Windows-11-10.0.26200-SP0` / dedicated `usb:0` / Bumble 0.0.230 / Python 3.13.5 / swbt-python 0.5.1。既存の unit_066 profile は current public address `0E:08:71:C0:B4:5C` と namespace が一致していたが、Switch peer `C8:48:05:F7:B5:21` の authentication failure reason 5でprotocol handshake前に失敗した。当日の fresh pairing済み unit_081 Pro profileへ差し替えると、300 ms / 100 ms の PeriodicとDirectはいずれも active reconnect、protocol ready、Button A送信、5秒観測、neutral close、transport close completeまでpassした。300 ms はPeriodicでsubcommand reply 16件、handshake report-mode automatic report 2件、Directでreply 16件、handshake report-mode automatic report 3件だった。100 msはDirectでreply 16件、handshake report-mode automatic report 2件だったが、Periodicはreply 59件、handshake report-mode automatic report 895件まで増加し、`1 passed in 34.83s`だった。0 msはPeriodic / Directともsession stateが`protocol_ready=true`へ遷移したが、`ProtocolHandshake`がoutcomeを公開できず、public `protocol_ready` event 0件のままconnection timeoutとなった。Periodicはreply 231件、handshake report-mode automatic report 6,354件で外側の60秒実行上限後もchild processが残ったため、Switch-facing送信を停止し、`tools/csr_bd_addr_probe.py --adapter usb:0 --hci-reset`でHCI / CSR address一致と`adapter_closed`を確認した。Directもreply 89件、handshake report-mode automatic report 1,432件、connection timeoutを記録したが、後続のnormal closeで`transport_close_complete`を記録した。fresh pairingでは300 msが`1 passed in 10.23s`。100 msは`1 passed in 19.99s`だったが、利用者はButton A反映を確認できなかった。0 msは20秒timeoutで、利用者はSwitchがコントローラーとして認識しなかったと観測した。0 ms fresh traceはsession stateの`protocol_ready=true`後もoutcomeを公開できず、handshake report-mode automatic reportの送信キューが621件まで増えた。testの`finally`はcontrol / interrupt channel close、disconnect terminal `closed`、`transport_close_complete`を記録した。artifactは`build/hardware/unit_082/reply-holdoff-20260725-031941/`。driverはOS権限不足で今回再確認できず。承認範囲はadapter open、advertising、fresh pairing、active reconnect、neutral automatic report、Button A、neutral close、adapter release。BD_ADDR書換えは未実行。結論は300 msをshared automatic input holdoffとして維持する。ready後の新規subcommandは観測されず、initializing限定へ変更する根拠は得られなかった。
 
 - 2026-07-25 unit_081 Direct fresh pairing recovery: `usb:0` の認証失敗後、ユーザ承認下で新しいadapter-default Pro profileをfresh pairingで作成し、同じprofileで `test_switch_direct_adapter_default_profile_stops_automatic_reports_after_ready` を実行した。Windows 11 / CSR8510 A10 / WinUSB / Bumble 0.0.230 / Python 3.13.5 / swbt-python 0.5.1 で `2 passed in 9.87s`。Direct reconnect traceはbootstrap neutral 2件、最初の`0x02`でbootstrap停止、`0x03 30`後の`handshake_report_mode` neutral 3件、nonzero player lights reply後の`protocol_ready`、ready後1秒の自動report 0件、終了時direct neutral 1件、transport close completeを記録した。fresh pairingもroute=`pairing`でprotocol readyとtransport close completeを記録した。artifactは `tmp/hardware/unit_081/direct-fresh-20260725/`。advertising、fresh pairing、neutral-only HID report、Direct reconnect、neutral close、adapter releaseは承認範囲内。non-neutral inputとBD_ADDR書換えは未実行。

{swbt_python-0.5.2 → swbt_python-0.5.3}/spec/initial/lifecycle.md

@@ -202,9 +202,9 @@ reconnect は M6 で扱う。初期実装では次だけを考慮する。
 - injected transport では、`SwitchGamepad.profile_path is None` だけを根拠に reconnect 用 storage の有無を判断しない
 - pairing 情報の保存有無を diagnostics に記録する
 - current peer は自動 reconnect 対象の 1 件だけに正規化する
-- pair 成功時、その peer を current にし、旧 current peer は previous generation へ退避する
-- previous peer は自動 reconnect 対象にしない
-- 複数 current peer を含む key store は自動移行せず、再作成と再 pairing を要求する
+- pair 成功時、その peer を current にする。current namespace の既存 key は保持しない。
+- pairing profile schema v2 は current key だけを保存する。previous generation、復元経路、schema v1 の互換読込は提供しない。
+- schema v1 profile と複数 current peer を含む key store は自動移行せず、新しい profile path での再作成と再 pairing を要求する。
 
 M6 では次を追加する。
 

swbt_python-0.5.3/spec/wip/unit_084/BUMBLE_0_0_233.md

@@ -0,0 +1,142 @@
+# Bumble 0.0.233 への固定と transport 互換分岐の整理
+
+## 1. 概要
+
+### 1.1 目的
+
+Bumble の正式対応を `0.0.233` だけに固定し、transport 実装を同版の API shape に合わせる。旧版を許容する動的分岐を削除し、最新 Bumble による nonblocking canary CI で将来の差分を検知する。
+
+### 1.2 起点 / source
+
+| source | 内容 | path |
+|---|---|---|
+| GitHub Issue | Bumble 0.0.233 への固定、互換分岐整理、canary CI の完了条件 | `https://github.com/niart120/swbt-python/issues/144` |
+| 初期設計 | Bumble 依存を transport 境界内に閉じる | `spec/initial/transport-bumble.md` |
+| 初期設計 | fake transport と Bumble / hardware test の分離 | `spec/initial/testing.md` |
+
+### 1.3 use case
+
+| actor / boundary | 入力または状態 | 期待する観測結果 | 制約 |
+|---|---|---|---|
+| ライブラリ利用者 | `swbt` を import | Bumble を import / 解決しない | lazy import 境界を維持する |
+| CI | lock に固定された dependency | Bumble 0.0.233 で unit / integration が通る | adapter は開かない |
+| 保守者 | schedule / 手動の canary workflow | 最新 Bumble の失敗を通常 CI と独立して観測できる | required check にしない |
+
+## 2. 対象範囲
+
+- `bumble==0.0.233` への dependency と lock の更新。
+- Bumble 0.0.233 source に照合した transport の不要な互換分岐と専用 test の削除。
+- remaining workaround の理由を本仕様へ記録。
+- latest Bumble で unit / integration を実行する nonblocking canary workflow。
+
+## 3. 対象外
+
+- 複数 Bumble version の同時対応と runtime version check。
+- 明示承認なしの Bumble adapter、Switch pairing、HID advertising、report loop の実行。
+- HID report、subcommand、SPI、SDP 値、report timing の変更。
+- BD_ADDR 切替機能の縮小。
+
+## 4. 関連 docs
+
+- `spec/initial/architecture.md`
+- `spec/initial/transport-bumble.md`
+- `spec/initial/lifecycle.md`
+- `spec/initial/testing.md`
+
+## 5. 根拠監査
+
+| 項目 | 要否 | 状態 | 根拠 / 理由 |
+|---|---|---|---|
+| Switch HID / report bytes | not applicable | not applicable | protocol 値を変更しない |
+| Bumble / transport | required | done | 0.0.230 と 0.0.233 の installed source を照合した |
+| OS / driver / adapter | required | partial | dedicated `usb:0` / CSR8510 A10 / WinUSB と Switch 2 firmware 22.5.0 は利用者が既存実験から不変と確認した。driver assignment の再照会は今回未実行 |
+
+### 根拠監査の結果
+
+| 項目 | 値 / 判断 | 根拠分類 | source | status |
+|---|---|---|---|---|
+| HID SET_REPORT callback | `hid.Device.register_set_report_cb()` は 0.0.233 に存在するため、存在確認 fallback を削除する | source fact | `.venv/Lib/site-packages/bumble/hid.py:470-473` | done |
+| connection event | `Connection` の diagnostics event 定数は 0.0.233 に存在するため、event 名文字列 fallback を削除する | source fact | `.venv/Lib/site-packages/bumble/device.py:1729-1760` | done |
+| ACL queue | `connection.device.host.get_data_packet_queue(handle)` と `DataPacketQueue.drain(handle)` は 0.0.233 の正式経路である | source fact | `.venv/Lib/site-packages/bumble/host.py:182-186,882-885` | done |
+| address | `hci.Address.to_string(False)` は 0.0.233 に存在するため、文字列化 fallback を削除する | source fact | `.venv/Lib/site-packages/bumble/hci.py:2226-2320` | done |
+| incoming BR/EDR request | `Device.on_connection_request()` は 0.0.233 でも deprecated `host.send_command_sync()` を呼ぶ。host の一時 bridge はこの upstream 挙動だけを回避する | source fact | `.venv/Lib/site-packages/bumble/device.py:6069-6125` | retained |
+| public accept alternative | `Device.accept()` は request より前に待機する coroutine であり、継続 accept loop と close 時の task 管理が必要になる | source fact | `.venv/Lib/site-packages/bumble/device.py:4138-4270` | deferred |
+
+## 6. 振る舞い仕様
+
+| 振る舞い | 入力・状態 | 期待結果 | 備考 |
+|---|---|---|---|
+| 正式 dependency | project install | Bumble が `0.0.233` に固定される | lock と一致する |
+| transport callback | Bumble 0.0.233 の HID / connection object | 固定 API を使い、旧 API fallback を使わない | diagnostics 用 optional field は残せる |
+| close | explicit disconnect | pending ACL queue だけを drain する | 通常 report では待たない |
+| canary | schedule / 手動実行 | 最新 Bumble で unit / integration を実行する | `continue-on-error: true` |
+
+## 7. TDD Test List
+
+| status | item | type | layer | hardware | notes |
+|---|---|---|---|---|---|
+| refactor-done | 0.0.233 の固定 API で HID callback と connection listener を登録できる | characterization | unit | no | fixture を fixed API shape に更新し focused test で確認 |
+| refactor-done | explicit disconnect で 0.0.233 の ACL queue を drain する | regression | unit | no | host 経由の正式取得経路で focused test を確認 |
+| refactor-done | 旧 API fallback 専用の test を削除しても transport の既存契約を保つ | regression | unit / integration | no | source に残る deprecated sync workaround は維持する |
+| refactor-done | latest Bumble canary が schedule / 手動実行で unit / integration を起動する | new | CI config | no | YAML parse により trigger、nonblocking、両 test tree を確認 |
+| done | Switch 2 fresh pairing 後に Button A input report を送り、neutral close する | regression | hardware | yes | 0.3 s Periodic case が pytest と利用者の画面観測で成功 |
+| deferred | Pro Controller active reconnect と normal close を Bumble adapter で確認する | regression | bumble / hardware | yes | 明示承認後にだけ実行する |
+
+## 8. 文書検証計画
+
+not applicable。公開利用者向け文書は変更しない。
+
+## 9. 設計メモ
+
+- `getattr()` を一律に削除しない。診断用 optional field と source 上で欠落し得る値だけは残す。
+- Bumble source にない fallback は、0.0.233 固定後に互換性のため保持しない。
+- `Device.on_connection_request()` の deprecated sync helper は 0.0.233 に残る。public `Device.accept()` への移行には accept loop と lifecycle task の設計変更が必要なため、本 unit では既存の狭い bridge を維持する。
+
+## 10. 対象ファイル
+
+| path | change | 内容 |
+|---|---|---|
+| `pyproject.toml` | modify | Bumble exact pin |
+| `uv.lock` | modify | dependency lock |
+| `src/swbt/transport/**` | modify | 0.0.233 API に合わせた分岐整理 |
+| `tests/unit/**` | modify | obsolete fallback test の削除と fixed-API fixture |
+| `.github/workflows/**` | new / modify | latest Bumble canary |
+
+## 11. 検証
+
+| command | result | notes |
+|---|---|---|
+| `uv lock --check` | passed | Bumble 0.0.233 lock と一致 |
+| `uv run ruff format --check .` | passed | 106 files already formatted |
+| `uv run ruff check .` | passed | All checks passed |
+| `uv run ty check --no-progress` | passed | All checks passed |
+| `uv run pytest tests/unit` | passed | 448 passed |
+| `uv run pytest tests/integration` | passed | 154 passed |
+| `uv run --group docs mkdocs build --strict` | passed | strict build succeeded |
+| `uv build` | passed | sdist と wheel を build |
+| `uv run python -c "...yaml.safe_load(...)..."` | passed | canary の trigger、nonblocking、unit / integration command を確認 |
+| `uv run pytest tests/hardware/test_context_manager_resource_scope.py -m bumble --swbt-bumble-adapter usb:0 --swbt-hardware-artifact-dir tmp/hardware/unit_084/bumble-open-only` | passed | 1 passed。advertising / host connection なし、transport close complete を trace で確認 |
+| `uv run pytest "tests/hardware/test_reply_holdoff.py::test_switch_reply_holdoff_variant_fresh_pairing_characterizes_readiness_and_a_input[0.3-True]" -m hardware --swbt-bumble-adapter usb:0 --swbt-hardware-artifact-dir tmp/hardware/unit_084/fresh-a-switch2-20260725` | passed | 1 passed in 10.34s。fresh pairing、Button A の input report、neutral close を trace で確認し、利用者が Switch 2 UI への反映を確認 |
+
+## 12. 実機実行条件
+
+| 項目 | 内容 |
+|---|---|
+| 実機要否 | Bumble adapter open-only と Switch 2 fresh pairing / Button A は完了。active reconnect と normal close は未実行 |
+| 承認範囲 | `usb:0` の open-only Bumble marker に加え、Switch 2 の fresh pairing、HID advertising、Button A、neutral close、adapter release を実行済み。active reconnect は未承認 |
+| adapter | `usb:0` |
+| 実行遮断 | 環境変数による遮断は採用しない。明示承認、対象 adapter、command、cleanup plan で管理する |
+| log / artifact | `spec/hardware-test-log.md`、`tmp/hardware/unit_084/bumble-open-only/resource-open-only.jsonl`、`tmp/hardware/unit_084/fresh-a-switch2-20260725/reply-holdoff-fresh-periodic-0_300.jsonl` |
+| cleanup | open-only と Switch 2 fresh pairing の両方で `transport_close_complete` を確認。Switch 2 run では disconnect terminal `closed` と neutral close も記録 |
+
+## 13. 先送り事項
+
+- adapter を使う active reconnect と normal close の実機確認は、利用者の明示承認後に実行する。
+
+## 14. チェックリスト
+
+- [x] 対象範囲と対象外を確認した
+- [x] TDD Test List または文書検証計画を更新した
+- [x] 必要な根拠監査を記録した
+- [x] 実機実行条件を記録した
+- [x] 検証結果または未実行理由を記録した

swbt_python-0.5.3/src/swbt/transport/_bumble_acl.py

@@ -0,0 +1,17 @@
+"""ACL queue drain helper for the pinned Bumble HID transport."""
+
+from typing import Any, cast
+
+
+async def drain_bumble_acl_queue(l2cap_channel: object) -> None:
+    """Wait for the pinned Bumble connection's pending ACL packets to complete."""
+    channel = cast("Any", l2cap_channel)
+    connection = channel.connection
+    acl_packet_queue = connection.device.host.get_data_packet_queue(connection.handle)
+    if acl_packet_queue is None:
+        return
+    try:
+        await acl_packet_queue.drain(connection.handle)
+    except ValueError:
+        # Bumble raises when the queue has no state for a channel that was already drained.
+        return

{swbt_python-0.5.2 → swbt_python-0.5.3}/src/swbt/transport/_bumble_key_store.py

@@ -9,11 +9,9 @@ from swbt.diagnostics import DiagnosticsRecorder
 from swbt.errors import InvalidKeyStoreError
 from swbt.transport._pairing_profile import KeyStoreNamespaces, PairingProfile
 
-PREVIOUS_NAMESPACE_PREFIX = "swbt.previous::"
-
 
 class _PairingProfileKeyStore:
-    """Bumble-compatible profile key store with one previous generation."""
+    """Bumble-compatible profile key store for the current namespace."""
 
     def __init__(
         self,
@@ -24,7 +22,6 @@ class _PairingProfileKeyStore:
         self._profile_path = Path(profile_path)
         self._namespace = namespace if isinstance(namespace, str) else None
         self._namespace_resolver = None if isinstance(namespace, str) else namespace
-        self.last_update_previous_saved = False
 
     def _resolve_namespace(self) -> str:
         namespace = (
@@ -36,16 +33,9 @@ class _PairingProfileKeyStore:
         return namespace
 
     async def update(self, name: str, keys: object) -> None:
-        """Write current keys and keep the overwritten current value as previous."""
+        """Replace the current namespace with one peer's keys."""
         current_store = self._current_store()
         db, current_key_map = await current_store.load()
-        previous_namespace = self._previous_namespace(current_store)
-        previous_key_map = copy.deepcopy(current_key_map)
-        self.last_update_previous_saved = bool(previous_key_map)
-        if previous_key_map:
-            db[previous_namespace] = previous_key_map
-        else:
-            db.pop(previous_namespace, None)
         current_key_map.clear()
         current_key_map[name] = cast("Any", keys).to_dict()
         await current_store.save(db)
@@ -84,10 +74,6 @@ class _PairingProfileKeyStore:
             adapter_default=self._namespace_resolver is not None,
         )
 
-    @staticmethod
-    def _previous_namespace(current_store: "_PairingProfileNamespaceStore") -> str:
-        return f"{PREVIOUS_NAMESPACE_PREFIX}{current_store.namespace}"
-
 
 class _PairingProfileNamespaceStore:
     """JsonKeyStore-compatible view over one profile namespace map."""
@@ -169,20 +155,16 @@ class _DiagnosticKeyStore:
         try:
             await cast("Any", self._key_store).update(name, keys)
         except Exception as error:
-            fields = self._generation_fields()
             self._diagnostics.record_event(
                 "key_store_update",
-                **fields,
                 error_type=type(error).__name__,
                 message=str(error),
                 peer_address=name,
                 status="failed",
             )
             raise
-        fields = self._generation_fields()
         self._diagnostics.record_event(
             "key_store_update",
-            **fields,
             peer_address=name,
             status="succeeded",
         )
@@ -209,11 +191,3 @@ class _DiagnosticKeyStore:
 
     def __getattr__(self, name: str) -> object:
         return getattr(self._key_store, name)
-
-    def _generation_fields(self) -> dict[str, object]:
-        if not isinstance(self._key_store, _PairingProfileKeyStore):
-            return {}
-        return {
-            "generation": "current",
-            "previous_saved": self._key_store.last_update_previous_saved,
-        }

{swbt_python-0.5.2 → swbt_python-0.5.3}/src/swbt/transport/_bumble_lifecycle.py

@@ -25,20 +25,19 @@ class ConnectionDiagnostics:
         self._record_event = record_event
 
     def register(self, connection: object) -> None:
-        """Register all connection diagnostics callbacks supported by the connection."""
-        on_event = getattr(connection, "on", None)
-        if not callable(on_event):
-            return
+        """Register all diagnostics callbacks provided by Bumble 0.0.233."""
+        connection_with_attrs = cast("Any", connection)
+        on_event = connection_with_attrs.on
         on_event(
-            getattr(connection, "EVENT_DISCONNECTION", "disconnection"),
+            connection_with_attrs.EVENT_DISCONNECTION,
             self._handle_disconnection,
         )
         on_event(
-            getattr(connection, "EVENT_CLASSIC_PAIRING", "classic_pairing"),
+            connection_with_attrs.EVENT_CLASSIC_PAIRING,
             lambda *_args: self._record_event("classic_pairing", adapter=self._adapter),
         )
         on_event(
-            getattr(connection, "EVENT_CLASSIC_PAIRING_FAILURE", "classic_pairing_failure"),
+            connection_with_attrs.EVENT_CLASSIC_PAIRING_FAILURE,
             lambda reason=None, *_args: self._record_event(
                 "classic_pairing_failure",
                 adapter=self._adapter,
@@ -46,15 +45,15 @@ class ConnectionDiagnostics:
             ),
         )
         on_event(
-            getattr(connection, "EVENT_PAIRING_START", "pairing_start"),
+            connection_with_attrs.EVENT_PAIRING_START,
             lambda *_args: self._record_event("pairing_start", adapter=self._adapter),
         )
         on_event(
-            getattr(connection, "EVENT_PAIRING", "pairing"),
+            connection_with_attrs.EVENT_PAIRING,
             lambda keys=None, *_args: self._record_pairing_complete(connection, keys),
         )
         on_event(
-            getattr(connection, "EVENT_PAIRING_FAILURE", "pairing_failure"),
+            connection_with_attrs.EVENT_PAIRING_FAILURE,
             lambda reason=None, *_args: self._record_event(
                 "pairing_failure",
                 adapter=self._adapter,
@@ -62,15 +61,11 @@ class ConnectionDiagnostics:
             ),
         )
         on_event(
-            getattr(connection, "EVENT_CONNECTION_AUTHENTICATION", "connection_authentication"),
+            connection_with_attrs.EVENT_CONNECTION_AUTHENTICATION,
             lambda *_args: self._record_connection_authentication(connection),
         )
         on_event(
-            getattr(
-                connection,
-                "EVENT_CONNECTION_AUTHENTICATION_FAILURE",
-                "connection_authentication_failure",
-            ),
+            connection_with_attrs.EVENT_CONNECTION_AUTHENTICATION_FAILURE,
             lambda error=None, *_args: self._record_event(
                 "connection_authentication_failure",
                 adapter=self._adapter,
@@ -78,19 +73,11 @@ class ConnectionDiagnostics:
             ),
         )
         on_event(
-            getattr(
-                connection,
-                "EVENT_CONNECTION_ENCRYPTION_CHANGE",
-                "connection_encryption_change",
-            ),
+            connection_with_attrs.EVENT_CONNECTION_ENCRYPTION_CHANGE,
             lambda *_args: self._record_connection_encryption_change(connection),
         )
         on_event(
-            getattr(
-                connection,
-                "EVENT_CONNECTION_ENCRYPTION_FAILURE",
-                "connection_encryption_failure",
-            ),
+            connection_with_attrs.EVENT_CONNECTION_ENCRYPTION_FAILURE,
             lambda error=None, *_args: self._record_event(
                 "connection_encryption_failure",
                 adapter=self._adapter,
@@ -98,23 +85,19 @@ class ConnectionDiagnostics:
             ),
         )
         on_event(
-            getattr(
-                connection,
-                "EVENT_CONNECTION_ENCRYPTION_KEY_REFRESH",
-                "connection_encryption_key_refresh",
-            ),
+            connection_with_attrs.EVENT_CONNECTION_ENCRYPTION_KEY_REFRESH,
             lambda *_args: self._record_connection_encryption_refresh(connection),
         )
         on_event(
-            getattr(connection, "EVENT_LINK_KEY", "link_key"),
+            connection_with_attrs.EVENT_LINK_KEY,
             lambda *_args: self._record_event("link_key_available", adapter=self._adapter),
         )
         on_event(
-            getattr(connection, "EVENT_MODE_CHANGE", "mode_change"),
+            connection_with_attrs.EVENT_MODE_CHANGE,
             lambda *_args: self._record_classic_mode_change(connection),
         )
         on_event(
-            getattr(connection, "EVENT_MODE_CHANGE_FAILURE", "mode_change_failure"),
+            connection_with_attrs.EVENT_MODE_CHANGE_FAILURE,
             lambda status=None, *_args: self._record_event(
                 "classic_mode_change_failure",
                 adapter=self._adapter,
@@ -179,7 +162,8 @@ def register_connection_request_bridge(
     record_event: EventRecorder,
 ) -> None:
     """Wrap Bumble's connection request callback while avoiding deprecated sync APIs."""
-    original_connection_request = cast("Any", device).on_connection_request
+    device_with_attrs = cast("Any", device)
+    original_connection_request = device_with_attrs.on_connection_request
 
     def on_connection_request(
         bd_addr: object,
@@ -201,7 +185,6 @@ def register_connection_request_bridge(
             link_type,
         )
 
-    device_with_attrs = cast("Any", device)
     device_with_attrs.on_connection_request = on_connection_request
     replace_host_connection_request_listener(
         device,
@@ -267,24 +250,18 @@ def call_connection_request_without_deprecated_sync_command(
     link_type: int,
 ) -> None:
     """Run Bumble's connection request handler without its deprecated sync helper."""
-    host = getattr(device, "host", None)
-    send_async_command = getattr(host, "send_async_command", None)
-    if host is None or not callable(send_async_command):
-        connection_request(bd_addr, class_of_device, link_type)
-        return
+    device_with_attrs = cast("Any", device)
+    host = device_with_attrs.host
 
     from bumble import utils  # noqa: PLC0415
 
     missing = object()
-    host_dict = getattr(host, "__dict__", None)
-    previous_instance_attr = (
-        host_dict.get("send_command_sync", missing) if isinstance(host_dict, dict) else missing
-    )
+    previous_instance_attr = host.__dict__.get("send_command_sync", missing)
 
     def send_command_sync(command: object) -> None:
-        utils.AsyncRunner.spawn(send_async_command(command))
+        utils.AsyncRunner.spawn(host.send_async_command(command))
 
-    host_with_attrs = cast("Any", host)
+    host_with_attrs = host
     host_with_attrs.send_command_sync = send_command_sync
     try:
         connection_request(bd_addr, class_of_device, link_type)
@@ -300,12 +277,9 @@ def replace_host_connection_request_listener(
     original_connection_request: Callable[[object, int, int], None],
     replacement_connection_request: Callable[[object, int, int], None],
 ) -> None:
-    host = getattr(device, "host", None)
-    remove_listener = getattr(host, "remove_listener", None)
-    on = getattr(host, "on", None)
-    if not callable(remove_listener) or not callable(on):
-        return
+    device_with_attrs = cast("Any", device)
+    host = device_with_attrs.host
 
     with suppress(KeyError, ValueError):
-        remove_listener("connection_request", original_connection_request)
-    on("connection_request", replacement_connection_request)
+        host.remove_listener("connection_request", original_connection_request)
+    host.on("connection_request", replacement_connection_request)