swbt-python 0.5.4__tar.gz → 0.6.0__tar.gz

{swbt_python-0.5.4 → swbt_python-0.6.0}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: swbt-python
-Version: 0.5.4
+Version: 0.6.0
 Summary: Python library for presenting an NX-compatible virtual Bluetooth HID input device.
 Keywords: bluetooth,bluetooth-hid,controller,gamepad,hid,nx
 Author: niart120
@@ -14,14 +14,14 @@ Classifier: Operating System :: MacOS
 Classifier: Operating System :: Microsoft :: Windows
 Classifier: Operating System :: POSIX :: Linux
 Classifier: Programming Language :: Python :: 3
-Classifier: Programming Language :: Python :: 3.12
 Classifier: Programming Language :: Python :: 3.13
+Classifier: Programming Language :: Python :: 3.14
 Classifier: Topic :: Software Development :: Libraries
 Classifier: Typing :: Typed
 Requires-Dist: bumble==0.0.233
 Maintainer: niart120
 Maintainer-email: niart120 <38847256+niart120@users.noreply.github.com>
-Requires-Python: >=3.12
+Requires-Python: >=3.13
 Description-Content-Type: text/markdown
 
 # swbt-python
@@ -32,7 +32,7 @@ NX 向けの仮想 Bluetooth HID 入力デバイスを Python から扱うため
 
 ## 必要なもの
 
-- Python 3.12 以降
+- Python 3.13 以降
 - uv
 - Bumble が利用可能な専用 USB Bluetooth ドングル
 

{swbt_python-0.5.4 → swbt_python-0.6.0}/README.md

@@ -6,7 +6,7 @@ NX 向けの仮想 Bluetooth HID 入力デバイスを Python から扱うため
 
 ## 必要なもの
 
-- Python 3.12 以降
+- Python 3.13 以降
 - uv
 - Bumble が利用可能な専用 USB Bluetooth ドングル
 

{swbt_python-0.5.4 → swbt_python-0.6.0}/pyproject.toml

@@ -1,6 +1,6 @@
 [project]
 name = "swbt-python"
-version = "0.5.4"
+version = "0.6.0"
 description = "Python library for presenting an NX-compatible virtual Bluetooth HID input device."
 readme = "README.md"
 authors = [
@@ -9,7 +9,7 @@ authors = [
 maintainers = [
     { name = "niart120", email = "38847256+niart120@users.noreply.github.com" }
 ]
-requires-python = ">=3.12"
+requires-python = ">=3.13"
 license = "MIT"
 license-files = ["LICENSE"]
 keywords = [
@@ -28,8 +28,8 @@ classifiers = [
     "Operating System :: Microsoft :: Windows",
     "Operating System :: POSIX :: Linux",
     "Programming Language :: Python :: 3",
-    "Programming Language :: Python :: 3.12",
     "Programming Language :: Python :: 3.13",
+    "Programming Language :: Python :: 3.14",
     "Topic :: Software Development :: Libraries",
     "Typing :: Typed",
 ]
@@ -75,7 +75,7 @@ source-exclude = [
 line-length = 100
 required-version = ">=0.15.16"
 src = ["src", "tests"]
-target-version = "py312"
+target-version = "py313"
 
 [tool.ruff.format]
 docstring-code-format = true
@@ -130,7 +130,7 @@ strict = true
 known-first-party = ["swbt"]
 
 [tool.ty.environment]
-python-version = "3.12"
+python-version = "3.13"
 root = ["./src"]
 
 [tool.ty.src]

swbt_python-0.6.0/spec/complete/unit_087/PYTHON_313_RUNTIME_FLOOR.md

@@ -0,0 +1,187 @@
+# Python 3.13 最低実行バージョン仕様書
+
+## 1. 概要
+
+### 1.1 目的
+
+Windows上のPython 3.12では、`time.monotonic_ns()`と`asyncio` event loopが
+`GetTickCount64()`の15.625 ms分解能に制約され、8 ms周期のquaternion IMU入力に
+カクつきが発生した。report生成やevent loopへ個別の時計補正を入れず、最低実行
+バージョンをPython 3.13へ引き上げる。CIでは最低バージョンの3.13と次の安定版
+3.14を検証する。
+
+### 1.2 起点 / source
+
+| source | 内容 | path |
+|---|---|---|
+| GitHub Issue | 8 ms送信時の周期的なカクつきとHCI credit仮説 | `https://github.com/niart120/swbt-python/issues/152` |
+| hardware observation | Python 3.12.10では8 ms区間がカクつき、Python 3.13.5では同条件でカクつきなし | `spec/hardware-test-log.md` |
+| local characterization | Python 3.12.10の`monotonic_ns()`は15.625 ms分解能、Python 3.13.5は100 ns分解能 | 2026-07-27のruntime比較 |
+| user decision | clock実装を変更せず、最低Pythonを3.13へ引き上げ、CIへ3.14を追加する | 2026-07-27 |
+
+### 1.3 use case
+
+| actor / boundary | 入力または状態 | 期待する観測結果 | 制約 |
+|---|---|---|---|
+| package利用者 | Python 3.13以上でinstallする | package metadataが対応runtimeを明示する | Python 3.12は対応対象外 |
+| contributor | CIを実行する | Python 3.13 / 3.14のunit、integration、buildを検証する | hardware gateは含めない |
+| Direct / Periodic利用者 | 8 ms周期の入力を扱う | CPython 3.13以降の高分解能なmonotonic clockを利用する | OS負荷による起床遅延までは保証しない |
+
+## 2. 対象範囲
+
+- `requires-python`を`>=3.13`へ変更する。
+- Python classifierを3.13 / 3.14へ揃える。
+- RuffとtyのPython対象バージョンを3.13へ変更する。
+- CI matrixをPython 3.13 / 3.14へ変更する。
+- Bumble canaryを最低対応バージョンのPython 3.13で実行する。
+- READMEと実機準備文書の必要Pythonバージョンを3.13へ変更する。
+- lockfileのPython要件を更新する。
+- package versionを0.6.0へ更新し、互換性変更と実機確認範囲をrelease notesへ記載する。
+- Issue #152の実験用HCI / USB probeと実機観測を記録する。
+
+## 3. 対象外
+
+- `ReportSender`、`ReportLoop`、Bumble、`asyncio` event loopのclock変更。
+- Python 3.12互換性の維持。
+- 8 ms周期やOS scheduler精度の保証。
+- HID report layout、IMU packing、既定report周期の変更。
+- Bluetooth air capture、別adapter、別OS、別Switch firmwareへの一般化。
+- TestPyPI / PyPI publish、tag、GitHub Release作成。
+
+## 4. 関連 docs
+
+- `README.md`
+- `spec/initial/testing.md`
+- `spec/initial/risks.md`
+- `spec/complete/unit_049/IMU_SESSION_AND_ENCODING_REDESIGN.md`
+- `spec/complete/unit_065/PERIODIC_DEADLINE_SCHEDULER.md`
+
+## 5. 根拠監査
+
+| 項目 | 要否 | 状態 | 根拠 / 理由 |
+|---|---|---|---|
+| Switch HID / report bytes | not required | done | report生成実装とbyte layoutは変更しない |
+| Bumble / transport | required | done | Bumble 0.0.230 / 0.0.233差では症状が変わらず、credit待ち最大0を実測した |
+| Python clock | required | done | 対象Windows環境で3.12.10と3.13.5のclock implementationと分解能を取得した |
+| OS / driver / adapter | required for observation | done | Windows 11 / CSR8510 A10 / WinUSB / `usb:0`で比較した。別環境へ一般化しない |
+
+### 根拠監査の結果
+
+| 項目 | 値 / 判断 | 根拠分類 | source | status |
+|---|---|---|---|---|
+| Python 3.12.10 Windows monotonic | `GetTickCount64()`、分解能15.625 ms | runtime fact | `time.get_clock_info("monotonic")` | done |
+| Python 3.13.5 Windows monotonic | `QueryPerformanceCounter()`、分解能100 ns | runtime fact | `time.get_clock_info("monotonic")` | done |
+| Python / Bumble比較 | 3.12.10ではBumble 0.0.230 / 0.0.233の両方でカクつき、3.13.5 / 0.0.230ではカクつきなし | hardware observation | 実機matrix | done |
+| HCI credit | 対象runのBumble queue待機packet最大0 | hardware observation | HCI credit probe | done |
+| clock修正案 | `ReportSender`と`ReportLoop`の`perf_counter_ns()`化でPeriodicは滑らかになったが、Directはcaller schedulerの補正も必要だった | experimental observation | 修正後route比較 | done |
+| final disposition | clock修正を製品へ採用せず、Python 3.13を最低対応runtimeとする | decision | user decision | done |
+
+## 6. 振る舞い仕様
+
+| 振る舞い | 入力・状態 | 期待結果 | 備考 |
+|---|---|---|---|
+| package runtime floor | package metadataを読む | `requires-python`が`>=3.13` | Python 3.12へのinstallを拒否する |
+| supported classifiers | PyPI metadataを読む | Python 3.13 / 3.14を列挙し、3.12を列挙しない | 実機互換性の保証ではない |
+| CI matrix | GitHub Actions CIを実行する | Ubuntu / macOSの各OSで3.13 / 3.14を検証する | Bumble / hardware testは実行しない |
+| static target | Ruff / tyを実行する | 最低対応バージョン3.13を基準に解析する | 新しい構文の採用を要求しない |
+| clock implementation | controllerを利用する | 既存の`monotonic_ns()`とclock注入境界を維持する | clockのglobal差し替えを行わない |
+
+## 7. TDD Test List
+
+| status | item | type | layer | hardware | notes |
+|---|---|---|---|---|---|
+| refactor-skipped | package metadataとstatic targetがPython 3.13以上を表す | regression | unit | no | REDは`requires-python >=3.12`で失敗。metadata変更後GREEN |
+| refactor-skipped | CIがPython 3.13 / 3.14を実行する | regression | unit | no | REDはmatrix 3.12 / 3.13で失敗。workflow変更後GREEN |
+| green | Python 3.13で標準gateが成功する | compatibility | gate | no | Python 3.13.5でstatic、451 unit、165 integration、buildがpass |
+| green | Python 3.14でunit / integration / buildが成功する | compatibility | gate | no | Python 3.14.6を明示し、static、451 unit、165 integration、buildがpass |
+
+## 8. 文書検証計画
+
+READMEの対象読者はpackage利用者であり、install前に必要なPythonバージョンを判断できる
+ことを確認する。正本は`pyproject.toml`の`requires-python`とする。README以外の公開
+文書にはPython 3.12要件がないことを検索し、`docs-quality-review`で正本との一致を
+確認する。
+
+## 9. 設計メモ
+
+- Python 3.13の採用理由は、今回のWindows実機で確認したclock分解能と画面観測である。
+- Python 3.13でも`asyncio.sleep(0.008)`の正確な起床や125 Hzを保証しない。
+- 3.14のCI追加は互換性検査であり、3.14固有機能の採用を意味しない。
+- clock注入引数は決定的test用の内部境界として維持する。
+
+## 10. 対象ファイル
+
+| path | change | 内容 |
+|---|---|---|
+| `pyproject.toml` | modify | version 0.6.0、runtime floor、classifier、Ruff / ty target |
+| `uv.lock` | modify | version 0.6.0、runtime floor |
+| `.github/workflows/ci.yml` | modify | Python 3.13 / 3.14 matrix |
+| `.github/workflows/bumble-canary.yml` | modify | Python 3.13 |
+| `tests/unit/test_ci_workflow.py` | modify | CI matrix契約 |
+| `tests/unit/test_package_metadata.py` | modify | package / static target契約 |
+| `README.md` | modify | 必要Pythonバージョン |
+| `docs/hardware.md` | modify | 実機準備の必要Pythonバージョン |
+| `docs/release-notes.md` | modify | v0.6.0の互換性変更と実機確認範囲 |
+| `tools/hci_credit_gyro_probe.py` | new | Issue #152実験用probe |
+| `spec/hardware-test-log.md` | modify | 実験結果と不採用判断 |
+| `spec/complete/unit_087/PYTHON_313_RUNTIME_FLOOR.md` | new | 完了した作業仕様 |
+
+## 11. 検証
+
+| command | result | notes |
+|---|---|---|
+| `uv run pytest tests/unit/test_ci_workflow.py tests/unit/test_package_metadata.py -q` | red, expected | CI matrixと`requires-python`が旧3.12境界のため2 failed、4 passed |
+| 同focused testのGREEN再実行 | passed | 6 passed |
+| `uv lock` | passed | 52 packages resolved |
+| `uv sync --dev --python 3.13` | passed | Python 3.13.5、40 packages checked |
+| Python 3.13.5 `ruff format --check` / `ruff check` / `ty check` | passed | 107 files formatted、lint / type errorなし |
+| Python 3.13.5 `pytest tests/unit` | passed | 451 passed |
+| Python 3.13.5 `pytest tests/integration` | passed | 165 passed |
+| Python 3.13.5 `uv build` | passed | sdist / wheel生成 |
+| `uv sync --dev --python 3.14` | passed | CPython 3.14.6を取得し、40 packages installed |
+| `uv run --python 3.14 ruff format --check .` / `ruff check .` / `ty check --no-progress` | passed | runtimeを明示し、format / lint / type errorなし |
+| `uv run --python 3.14 pytest tests/unit` | passed | Python 3.14.6、451 passed |
+| `uv run --python 3.14 pytest tests/integration` | passed | Python 3.14.6、165 passed |
+| `uv build --python 3.14` | passed | sdist / wheel生成。0.5.4 wheel metadataは`Requires-Python: >=3.13` |
+| runtime指定なしの並列`uv run`による3.14検証 | invalid, rerun | `.python-version`の3.13を再選択したため判定に使用せず、全commandへ`--python 3.14`を明示して再実行 |
+| `uv lock --check` | passed | 52 packages resolved |
+| `git diff --check` | passed | whitespace errorなし |
+| `uv run --python 3.13 --group docs mkdocs build --strict` | passed | 公開docsをstrict modeで生成 |
+| v0.6.0 release gate: `uv sync --dev --group docs --python 3.13` | passed | local packageを0.6.0へ更新 |
+| v0.6.0 release gate: Ruff / ty / unit / integration / MkDocs | passed | 451 unit、165 integration、static、docs strict build |
+| `uv build` | passed | `swbt_python-0.6.0` wheel / sdistを生成 |
+| `uvx --from twine twine check --strict dist\swbt_python-0.6.0-py3-none-any.whl dist\swbt_python-0.6.0.tar.gz` | passed | wheel / sdistともにPASSED |
+
+### Docs Quality Review
+
+- audience / task: package利用者がinstallまたは実機準備前に最低Pythonバージョンを判断する。
+- documents: `README.md`、`docs/hardware.md`、`docs/release-notes.md`
+- sources checked: `pyproject.toml`のversion / `requires-python`、classifiers、CI matrix、`v0.5.4..HEAD`と未コミット差分、`spec/hardware-test-log.md`
+- must-fix: なし
+- disposition: 利用要件をPython 3.13へ揃え、v0.6.0 release notesの先頭に破壊的変更、移行操作、実装非変更、CI範囲、実機確認と未確認範囲を記載した。
+- verification: `uv run --python 3.13 --group docs mkdocs build --strict`がpass。
+- remaining risk: Python 3.14の実機互換性は未検証であり、READMEでは保証していない。
+
+## 12. 実機実行条件
+
+| 項目 | 内容 |
+|---|---|
+| 今回の設定変更後実機検証 | not required |
+| 理由 | 製品report / transport実装を変更せず、採用判断の根拠となる実機比較は完了済み |
+| 過去の承認範囲 | dedicated `usb:0`、既存profile active reconnect、Direct / Periodic正Z yaw、neutral close、adapter release |
+| artifact | `tmp/hardware/issue_152/credit-gyro-20260727/` |
+
+## 13. 先送り事項
+
+- Python 3.14でのSwitch実機検証は未実行。今回のCI追加は実機なしの互換性gateに限る。
+- versionを0.6.0へ更新し、release notesを追加した。tag、PyPI / TestPyPI publish、GitHub Releaseはrelease実行時に扱う。
+- 別OSにおける8 ms周期の実機表示は未検証。
+
+## 14. チェックリスト
+
+- [x] 対象範囲と対象外を確認した
+- [x] TDD Test Listを更新した
+- [x] 必要な根拠監査を記録した
+- [x] 実機実行条件を記録した
+- [x] 検証結果または未実行理由を記録した
+- [x] docs-quality-reviewを完了した

{swbt_python-0.5.4 → swbt_python-0.6.0}/spec/hardware-test-log.md

@@ -6,6 +6,12 @@ Bumble adapter と対象機器に依存する観測を記録する正本であ
 
 ## Current Status
 
+- 2026-07-27 unit_087 Python 3.12 experimental clock比較と採否: Windows `Windows-11-10.0.26200-SP0` / dedicated `usb:0` / CSR8510 A10 `0A12:0001` / WinUSB / Bumble 0.0.233 / Python 3.12.10 / swbt-python 0.5.4 (`e4b6b4e`と実験差分)で、`ReportSender`と`ReportLoop`の既定clockを試験的に`perf_counter_ns`へ変更し、既存profileによるactive reconnect後に正Z yaw `1.0 rad/s`を送信した。Switch model / firmwareとdriver assignmentはこのrunでは再確認していない。Directを8 ms → 16 ms → 8 msの各8秒で実行すると、連続IMU block一致は全区間0件になったが、8 ms区間のACL dispatchは908 / 897件、2 ms未満gapは435 / 424件で、利用者はカクつきを目視した。credit待ちは最大0であり、clock修正だけではDirect呼び出し側のPython 3.12 `asyncio` schedulingは改善しない。同じDirect probeでevent loop clockも診断用に`perf_counter`へ差し替えると、ACL reportは1000 / 501 / 1001件、8 ms gap平均8.0082 / 8.0009 ms、2 ms未満gap 0件、連続IMU block一致0件となり、利用者は回転が滑らかになったと目視した。Periodicはevent loopを差し替えず、実験的clock修正だけで8 ms × 8秒を実行し、ACL report 998件、gap平均8.0081 ms（min 6.0196、max 15.6433）、2 ms未満gap 0件、連続IMU block一致0件、credit待ち最大0となり、利用者は滑らかな回転を目視した。全runでprofile不変、event drop 0、cleanup完了を確認した。Bumble stderrの`no pending response future to set`は各runで1件出たが、processは終了コード0。承認範囲は`usb:0` open、既存profile active reconnect、HID control / interrupt、Direct / Periodic正Z yaw、neutral close、adapter releaseで、新規pairing、button / stick、BD_ADDR書換えは実行していない。最終判断では、このclock修正とevent loop差し替えを製品へ採用せず、最低Pythonバージョンを3.13へ引き上げる。artifactは`tmp/hardware/issue_152/credit-gyro-20260727/py312-perf-clock-direct/`、`py312-perf-clock-highres-loop-direct/`、`py312-perf-clock-periodic-8ms/`。
+
+- 2026-07-27 Issue #152 Python / Bumble matrix and quaternion payload characterization: 同じ fresh-pairing profile、Switch 画面、正 Z yaw `1.0 rad/s`、8 ms → 16 ms → 8 ms の条件で比較した。Python 3.13.5 / Bumble 0.0.230 は利用者目視でカクつきなし。Python 3.12.10 / Bumble 0.0.233 と Python 3.12.10 / Bumble 0.0.230 は、どちらも8 ms区間でカクつき、16 ms区間だけ安定して見えた。したがって、この実験ではBumble 0.0.230 / 0.0.233の差は症状を支配していない。Python 3.12.10 / Bumble 0.0.233でasyncio loop clockだけを`perf_counter`へ差し替えると、ACL dispatchは8 ms区間で2 ms未満gap 0件、Bumble queue待機packet最大0となった。USB sink enqueue、OUT transfer slot取得、libusb transfer callbackも約8 ms間隔で、USB queue待機packet最大1だった。それでも利用者目視のカクつきは変わらず、16 ms区間だけ安定した。この構成ではHCI credit不足、Bumble `DataPacketQueue`待機、USB OUT transfer待機のいずれも、カクつきの必要条件ではない。実機を使わない追加characterizationでは、`FakeHidTransport`へ8 ms間隔で251件のquaternion IMU reportを生成した。Python 3.12.10は`time.monotonic_ns()`が`GetTickCount64()`、公称分解能15.625 msで、250区間中122区間が経過0 nsとなり、同じ122区間で連続する36-byte IMU blockが完全一致した。残る128区間は`monotonic_ns()`が15 msまたは16 ms進み、IMU blockも更新された。Python 3.13.5は`QueryPerformanceCounter()`、公称分解能100 nsで、経過0 nsと連続IMU block一致はともに0件だった。実装上、`ReportSender`は既定clockとして`time.monotonic_ns`を使い、quaternion modeは前reportとの差分時間で姿勢を積分するため、Python 3.12では8 ms入力が「姿勢更新なし」と「15–16 ms分の姿勢更新」を交互に含む。asyncio loop clockだけを差し替えても`ReportSender`の既定clockは変わらない。これらのimplementation fact、characterization、hardware observationは、Python 3.12でのquaternion payload時間量子化を今回のカクつきの主因とする説明に一致する。Switch model / firmwareはこのrunでは再取得しておらず、別OS、別Python patch version、別Switch firmwareへの一般化は未検証。artifactは`tmp/hardware/issue_152/credit-gyro-20260727/py313-bumble0230/`、`py312-bumble0233/`、`py312-bumble0230/`、`py312-bumble0233-highres-loop-rerun/`、`py312-highres-usb-probe/`。
+
+- 2026-07-27 Issue #152 Direct gyro / HCI credit A-B-A: Windows `Windows-11-10.0.26200-SP0` / dedicated `usb:0` / CSR8510 A10 `0A12:0001` / WinUSB service / libwdi `6.1.7600.16385` / Bumble 0.0.233 / Python 3.13.5 / swbt-python 0.5.4 (`e4b6b4e`) で実行した。Switch model / firmware はこの run では再取得していない。利用者が Switch 側の接続情報を削除し、「持ちかた／順番を変える」画面を準備した後、`test_switch_adapter_default_profile_fresh_pairing_and_close` を実行して `1 passed in 4.83s`。`classic_pairing`、`key_store_update(status=succeeded)`、`protocol_ready(route=pairing)`、neutral input、`transport_close_complete` を確認し、同じ profile を Direct 計測へ使用した。計測は Project_Demi の診断キー `J` と同じ正 Z yaw `1.0 rad/s`、静止時加速度 Z `1 G` を、固定 deadline で 8 ms × 8秒、16 ms × 8秒、8 ms × 8秒の順に送信した。Direct send / ACL dispatch は各区間 1,000 / 1,000件、500 / 500件、1,001 / 1,001件。ACL dispatch gap は順に mean 7.999949 ms（min 6.1956、max 10.0396）、mean 16.001558 ms（min 13.9599、max 18.0976）、mean 8.001519 ms（min 6.4098、max 9.6325）で、8 ms両区間の2 ms未満と12–20 ms gapはいずれも0件、report timer不連続も0件だった。Bumble `DataPacketQueue` は `max_in_flight=10` に対して実測最大 in-flight 4、enqueue後の待機packet最大0。全体でACL enqueue 2,530件、dispatch 2,530件、completion 2,530件で、各 `HCI Number Of Completed Packets` のpacket countはすべて1だった。利用者は3区間を通して周期的なカクつきは見えなかったと観測した。この構成ではIssue #152のBumble queue待機と近接送出を再現していない。終了時はprofile不変、trace `error` 0件、connection state `closed`、`transport_close_complete`を確認した。HCI disconnect requestは0.25秒でtimeoutし、Bumble stderrに`no pending response future to set`が1件出たが、adapterはpostflightのno-open列挙で再検出できた。承認範囲はfresh pairing、HID advertising、初期化応答、Direct正yaw、neutral close、adapter release。artifactは`tmp/hardware/issue_152/credit-gyro-20260727/`のprofile、fresh-pairing trace、`hci-credit-gyro-trace.jsonl`、`hci-credit-gyro-events.json`。
+
 - 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`。

{swbt_python-0.5.4 → swbt_python-0.6.0}/tests/unit/test_ci_workflow.py

@@ -27,7 +27,7 @@ def test_ci_runs_no_hardware_gate_on_ubuntu_and_macos() -> None:
     commands = _run_commands(python_job)
 
     assert matrix["os"] == ["ubuntu-latest", "macos-latest"]
-    assert matrix["python-version"] == ["3.12", "3.13"]
+    assert matrix["python-version"] == ["3.13", "3.14"]
     assert python_job["runs-on"] == "${{ matrix.os }}"
     assert "uv sync --locked --dev" in commands
     assert "uv run pytest tests/unit" in commands

{swbt_python-0.5.4 → swbt_python-0.6.0}/tests/unit/test_package_metadata.py

@@ -43,3 +43,16 @@ def test_package_metadata_includes_linux_and_macos_os_classifiers() -> None:
     assert "Operating System :: POSIX :: Linux" in classifiers
     assert "Operating System :: MacOS" in classifiers
     assert "Operating System :: MacOS :: MacOS X" not in classifiers
+
+
+def test_package_requires_python_313_and_declares_tested_versions() -> None:
+    pyproject = tomllib.loads(PYPROJECT.read_text(encoding="utf-8"))
+
+    project = pyproject["project"]
+
+    assert project["requires-python"] == ">=3.13"
+    assert "Programming Language :: Python :: 3.12" not in project["classifiers"]
+    assert "Programming Language :: Python :: 3.13" in project["classifiers"]
+    assert "Programming Language :: Python :: 3.14" in project["classifiers"]
+    assert pyproject["tool"]["ruff"]["target-version"] == "py313"
+    assert pyproject["tool"]["ty"]["environment"]["python-version"] == "3.13"