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

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

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: swbt-python
-Version: 0.5.0
+Version: 0.5.2
 Summary: Python library for presenting an NX-compatible virtual Bluetooth HID input device.
 Keywords: bluetooth,bluetooth-hid,controller,gamepad,hid,nx
 Author: niart120
@@ -55,12 +55,14 @@ uv sync --dev
 - [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/)
+- [AI エージェント向け要約](https://niart120.github.io/swbt-python/agent-brief/)
 
 同じ内容は `docs/` 配下でも確認できます。
 
 ## 利用例
+
 ### Pro Controller
+
 ```python
 import asyncio
 from swbt import Button, ProController
@@ -79,7 +81,9 @@ async def main() -> None:
 asyncio.run(main())
 ```
 
-Pro Controller 相当の一時的な仮想デバイスを作成し、ペアリング後に A ボタン入力を送信するコードの例です。接続情報を永続化する場合は `ProController.create_profile()` を使います。`local_address` を省略するとアダプタが現在報告する Bluetooth アドレスを維持し、揮発領域へ書き込みません。利用者管理のローカルアドレスへ切り替える手順は[利用例](docs/usage.md)、対応する専用 USB Bluetooth ドングルと復旧手順は[実機準備手順](docs/hardware.md)を参照してください。
+Pro Controller 相当の仮想デバイスを作成し、ペアリング後に A ボタン入力を送信する例です。
+
+接続情報を保存して再利用する場合は、先に `ProController.create_profile()` で `profile_path` を作成します。アドレスの選択方法と復旧手順は[利用例](docs/usage.md)、専用 USB Bluetooth ドングルの準備は[実機準備手順](docs/hardware.md)を参照してください。
 
 ### Joy-Con L/R
 
@@ -96,7 +100,6 @@ async def main() -> None:
         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()
@@ -105,9 +108,9 @@ async def main() -> None:
 asyncio.run(main())
 ```
 
-「持ちかた/順番を変える」画面で Joy-Con としてペアリングする場合は、接続後に `await left.tap(Button.SR, Button.SL)` のように SR+SL を送信する必要があります。
+「持ちかた/順番を変える」画面でペアリングするときも、登録用の SR+SL 入力を追加送信する必要はありません。`connect()` は Joy-Con 用の初期化とプレイヤーライトの設定が完了してから戻ります。
 
-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` は未実装です。
+`profile_path` はコントローラー形状と対象機器ごとに分けます。Joy-Con L では右スティックと A/B/X/Y、Joy-Con R では左スティックと十字キーを使えません。これらを指定すると `UnsupportedInputError` が送出されます。`JoyConPair` は未実装です。
 
 ## 接続方法
 
@@ -117,15 +120,11 @@ Pro Controller、周期送信型 Joy-Con、直接送信型はすべて、Bluetoo
 
 ### 確認済み構成
 
-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 のペアリング、保存済みペアリング情報を使う再接続、ボタン入力、ニュートラル復帰を記録しています。
+Windows 11 / CSR8510 A10 / WinUSB では、Pro Controller、Joy-Con L、Joy-Con R のペアリング、再接続、対応する入力操作を確認しています。macOS 15.7.7 / CSR8510 A10 では Pro Controller の限定的な動作を確認しています。条件と未確認範囲は[実機準備手順](https://niart120.github.io/swbt-python/hardware/)を参照してください。
 
 ### 実験的構成
 
-Linux は experimental です。手順は[実機準備手順](https://niart120.github.io/swbt-python/hardware/)に整備されていますが、専用 USB Bluetooth ドングルにアクセスできるか、ペアリングできるか、入力が反映されるかは未確認です。macOS は Pro Controller の一部挙動のみ検証済みです。Joy-Con、別ドングル、別ファームウェアでの互換性は未確認です。
+Linux は experimental です。専用 USB Bluetooth ドングルへのアクセス、ペアリング、入力反映は未確認です。macOS の Joy-Con、別ドングル、別ファームウェアでの互換性も未確認です。
 
 ## 開発
 

{swbt_python-0.5.0 → swbt_python-0.5.2}/README.md

@@ -29,12 +29,14 @@ uv sync --dev
 - [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/)
+- [AI エージェント向け要約](https://niart120.github.io/swbt-python/agent-brief/)
 
 同じ内容は `docs/` 配下でも確認できます。
 
 ## 利用例
+
 ### Pro Controller
+
 ```python
 import asyncio
 from swbt import Button, ProController
@@ -53,7 +55,9 @@ async def main() -> None:
 asyncio.run(main())
 ```
 
-Pro Controller 相当の一時的な仮想デバイスを作成し、ペアリング後に A ボタン入力を送信するコードの例です。接続情報を永続化する場合は `ProController.create_profile()` を使います。`local_address` を省略するとアダプタが現在報告する Bluetooth アドレスを維持し、揮発領域へ書き込みません。利用者管理のローカルアドレスへ切り替える手順は[利用例](docs/usage.md)、対応する専用 USB Bluetooth ドングルと復旧手順は[実機準備手順](docs/hardware.md)を参照してください。
+Pro Controller 相当の仮想デバイスを作成し、ペアリング後に A ボタン入力を送信する例です。
+
+接続情報を保存して再利用する場合は、先に `ProController.create_profile()` で `profile_path` を作成します。アドレスの選択方法と復旧手順は[利用例](docs/usage.md)、専用 USB Bluetooth ドングルの準備は[実機準備手順](docs/hardware.md)を参照してください。
 
 ### Joy-Con L/R
 
@@ -70,7 +74,6 @@ async def main() -> None:
         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()
@@ -79,9 +82,9 @@ async def main() -> None:
 asyncio.run(main())
 ```
 
-「持ちかた/順番を変える」画面で Joy-Con としてペアリングする場合は、接続後に `await left.tap(Button.SR, Button.SL)` のように SR+SL を送信する必要があります。
+「持ちかた/順番を変える」画面でペアリングするときも、登録用の SR+SL 入力を追加送信する必要はありません。`connect()` は Joy-Con 用の初期化とプレイヤーライトの設定が完了してから戻ります。
 
-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` は未実装です。
+`profile_path` はコントローラー形状と対象機器ごとに分けます。Joy-Con L では右スティックと A/B/X/Y、Joy-Con R では左スティックと十字キーを使えません。これらを指定すると `UnsupportedInputError` が送出されます。`JoyConPair` は未実装です。
 
 ## 接続方法
 
@@ -91,15 +94,11 @@ Pro Controller、周期送信型 Joy-Con、直接送信型はすべて、Bluetoo
 
 ### 確認済み構成
 
-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 のペアリング、保存済みペアリング情報を使う再接続、ボタン入力、ニュートラル復帰を記録しています。
+Windows 11 / CSR8510 A10 / WinUSB では、Pro Controller、Joy-Con L、Joy-Con R のペアリング、再接続、対応する入力操作を確認しています。macOS 15.7.7 / CSR8510 A10 では Pro Controller の限定的な動作を確認しています。条件と未確認範囲は[実機準備手順](https://niart120.github.io/swbt-python/hardware/)を参照してください。
 
 ### 実験的構成
 
-Linux は experimental です。手順は[実機準備手順](https://niart120.github.io/swbt-python/hardware/)に整備されていますが、専用 USB Bluetooth ドングルにアクセスできるか、ペアリングできるか、入力が反映されるかは未確認です。macOS は Pro Controller の一部挙動のみ検証済みです。Joy-Con、別ドングル、別ファームウェアでの互換性は未確認です。
+Linux は experimental です。専用 USB Bluetooth ドングルへのアクセス、ペアリング、入力反映は未確認です。macOS の Joy-Con、別ドングル、別ファームウェアでの互換性も未確認です。
 
 ## 開発
 

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

@@ -1,6 +1,6 @@
 [project]
 name = "swbt-python"
-version = "0.5.0"
+version = "0.5.2"
 description = "Python library for presenting an NX-compatible virtual Bluetooth HID input device."
 readme = "README.md"
 authors = [

{swbt_python-0.5.0/spec/wip → swbt_python-0.5.2/spec/complete}/unit_056/PAIRING_PROFILE_NAMING.md

@@ -61,16 +61,16 @@
 
 | status | item | type | layer | hardware | notes |
 |---|---|---|---|---|---|
-| implemented / smoke passed | `local_address` で作成した profile が従来の JSON payload を保存・読み込みできる | regression | unit | no | system Python の smoke test で確認。pytest は環境遮断 |
-| implemented / blocked | adapter identity 準備失敗が新しい例外型で復旧を要求する | regression | unit | no | adapter は開かない fake session。pytest は環境遮断 |
-| implemented / blocked | concrete controller が `local_address` で profile を作成して再利用できる | regression | integration | no | fake transport。pytest は環境遮断 |
+| green | `local_address` で作成した profile が従来の JSON payload を保存・読み込みできる | regression | unit | no | 現行 unit test と CI で確認 |
+| green | adapter identity 準備失敗が新しい例外型で復旧を要求する | regression | unit | no | adapterを開かない fake sessionで確認 |
+| green | concrete controller が `local_address` で profile を作成して再利用できる | regression | integration | no | fake transport integrationで確認 |
 
 ## 8. 文書検証計画
 
 | document | audience / task | source of truth | mechanical check | review result | unresolved |
 |---|---|---|---|---|---|
-| API / usage / hardware docs | profile の作成と再利用 | 本仕様 §6、実装 | `uv run mkdocs build --strict` | manual pass / build blocked | `uv` cache が read-only |
-| release notes / agent brief | 例外名と用語 | 本仕様 §6、実装 | link / build | manual pass / build blocked | `uv` cache が read-only |
+| API / usage / hardware docs | profile の作成と再利用 | 本仕様 §6、実装 | `uv run --group docs mkdocs build --strict` | done | none |
+| release notes / agent brief | 例外名と用語 | 本仕様 §6、実装 | link / diff review | done | none |
 
 ## 9. 設計メモ
 
@@ -97,10 +97,10 @@
 | GitHub Actions CI #142 | passed | 新規 shape-only 値の保存と `direct_*` の未対応扱いを含む unit / integration test |
 | `ruff 0.15.20 format --check .` | passed | CI と同じ Ruff version を一時領域で実行 |
 | `ruff 0.15.20 check .` | passed | CI と同じ Ruff version を一時領域で実行 |
-| `uv run ty check --no-progress` | blocked | 同上 |
-| `uv run pytest tests/unit` | blocked | 同上。Bumble を含む依存が未導入 |
-| `uv run pytest tests/integration` | blocked | 同上 |
-| `uv run mkdocs build --strict` | blocked | 同上 |
+| `uv run ty check --no-progress` | pass | current mainでAll checks passed |
+| `uv run pytest tests/unit` | pass | current mainで439 passed |
+| `uv run pytest tests/integration` | pass | current mainで154 passed |
+| `uv run --group docs mkdocs build --strict` | pass | current mainでstrict build成功 |
 
 ## 12. 実機実行条件
 
@@ -115,7 +115,7 @@
 
 ## 13. 先送り事項
 
-- ReportingMode 分類の削除は unit_057 で扱う。
+- none（ReportingMode 分類の削除は unit_057 で完了）
 
 ## 14. チェックリスト
 

{swbt_python-0.5.0/spec/wip → swbt_python-0.5.2/spec/complete}/unit_057/PAIRING_PROFILE_CONTROLLER_KIND.md

@@ -64,17 +64,17 @@ pairing profile の `controller_kind` から、入力レポートの送信方式
 
 | status | item | type | layer | hardware | notes |
 |---|---|---|---|---|---|
-| implemented / CI passed | 新規 profile が ReportingMode を含まない controller shape を保存する | regression | unit | no | 新規保存は `pro` / `joycon_l` / `joycon_r`。GitHub Actions CI #142 で確認 |
-| implemented / CI passed | 旧 direct kind を持つ JSON が未対応値として adapter open 前に失敗する | regression | unit | no | `direct_*` を特別扱いせず、既存の `controller_kind` 検証で拒否。GitHub Actions CI #142 で確認 |
-| implemented / local passed | 同じ controller shape の periodic / direct が profile を相互利用できる | regression | unit | no | Direct controller の `open()` が profile path と local address を fake transport factory へ渡すことを確認 |
-| implemented / CI passed | controller shape が異なる profile は adapter open 前に拒否される | regression | unit | no | `ControllerKind` 比較の guard を GitHub Actions CI #142 で確認 |
+| green | 新規 profile が ReportingMode を含まない controller shape を保存する | regression | unit | no | 新規保存は `pro` / `joycon_l` / `joycon_r`。CIと現行unitで確認 |
+| green | 旧 direct kind を持つ JSON が未対応値として adapter open 前に失敗する | regression | unit | no | `direct_*` を特別扱いせず、既存の `controller_kind` 検証で拒否 |
+| green | 同じ controller shape の periodic / direct が profile を相互利用できる | regression | unit | no | fake transport regression 3 passed |
+| green | controller shape が異なる profile は adapter open 前に拒否される | regression | unit | no | `ControllerKind`比較のguardを確認 |
 | deferred | Direct / Periodic 間 profile 再利用の実機 pairing / reconnect | characterization | hardware | yes | 明示承認と専用 adapter が必要 |
 
 ## 8. 文書検証計画
 
 | document | audience / task | source of truth | mechanical check | review result | unresolved |
 |---|---|---|---|---|---|
-| API / usage / hardware docs | プロファイルの再利用範囲 | 本仕様 §6、実装、対象 test | `uv run --with mkdocs mkdocs build --strict` | 2026-07-21 の docs-quality-review と strict build が pass | 実機共有は未検証 |
+| API / usage / hardware docs | プロファイルの再利用範囲 | 本仕様 §6、実装、対象 test | `uv run --group docs mkdocs build --strict` | done | Direct / Periodicの実機共有はdeferred |
 
 ## 9. 設計メモ
 
@@ -88,7 +88,7 @@ pairing profile の `controller_kind` から、入力レポートの送信方式
 |---|---|---|
 | `src/swbt/transport/_pairing_profile.py` | modify | `ControllerKind` 化と shape-only の値だけの受理 |
 | `src/swbt/gamepad/_config.py` | modify | profile kind config の削除 |
-| `src/swbt/gamepad/core.py` | modify | direct / periodic 共通の shape 利用 |
+| `src/swbt/gamepad/controllers.py` | modify | direct / periodic 共通の shape 利用 |
 | `src/swbt/gamepad/runtime.py` | modify | protocol profile の kind による guard |
 | `tests/` | modify | legacy / cross-mode / mismatch 回帰 |
 | `docs/`, `spec/initial/` | modify | profile 共有範囲の説明 |
@@ -102,10 +102,10 @@ pairing profile の `controller_kind` から、入力レポートの送信方式
 | GitHub Actions CI #142 | passed | 新規 shape-only 値の保存と `direct_*` の未対応扱いを含む unit / integration test |
 | `ruff 0.15.20 format --check .` | passed | CI と同じ Ruff version を一時領域で実行 |
 | `ruff 0.15.20 check .` | passed | CI と同じ Ruff version を一時領域で実行 |
-| `uv run ty check --no-progress` | blocked | 同上 |
-| `uv run pytest tests/unit` | blocked | 同上。Bumble を含む依存が未導入 |
-| `uv run pytest tests/integration` | blocked | 同上 |
-| `uv run mkdocs build --strict` | blocked | 同上 |
+| `uv run ty check --no-progress` | pass | current mainでAll checks passed |
+| `uv run pytest tests/unit` | pass | current mainで439 passed |
+| `uv run pytest tests/integration` | pass | current mainで154 passed |
+| `uv run --group docs mkdocs build --strict` | pass | current mainでstrict build成功 |
 | `uv run pytest tests/unit/test_pairing_profile_runtime.py::test_direct_controller_reuses_profile_for_the_same_controller_shape -q` | passed | 3 passed。P2 review finding の fake transport regression |
 | `uv run --with mkdocs mkdocs build --strict` | passed | 2026-07-21。公開 docs の strict build |
 
@@ -113,16 +113,16 @@ pairing profile の `controller_kind` から、入力レポートの送信方式
 
 | 項目 | 内容 |
 |---|---|
-| 実機要否 | required for deferred characterization |
-| 承認範囲 | dedicated adapter open、target Switch pairing、active reconnect、normal close |
-| adapter | 実行直前に確認する専用 adapter |
+| 実機要否 | not required for this unit（deferred characterization only） |
+| 承認範囲 | この完了ではなし。将来実行する場合は明示承認を取得する |
+| adapter | この完了では該当なし |
 | 実行遮断 | 環境変数による実行遮断は採用しない。明示承認、対象 adapter、command、cleanup plan で管理する |
-| log / artifact | `spec/hardware-test-log.md` に環境、command、result、cleanup を記録する |
-| cleanup | normal close 後に dedicated adapter を切り離す |
+| log / artifact | この完了では新規記録なし。将来実行時は `spec/hardware-test-log.md` に記録する |
+| cleanup | この完了では該当なし |
 
 ## 13. 先送り事項
 
-- Direct / Periodic 間での実機 pairing / reconnect は hardware characterization として別途実行する。
+- Direct / Periodic 間での実機 pairing / reconnect は、今回のprofile shape分離の完了条件に含めない。fake transportで公開契約を確認済みであり、実機再検証の追加価値は低いため、release gateで必要になった場合だけ専用hardware runとして扱う。
 
 ## 14. チェックリスト
 

swbt_python-0.5.2/spec/complete/unit_068/DIRECT_PRE_CLOSE_INPUT_REFLECTION.md

@@ -0,0 +1,143 @@
+# Direct close 前入力反映観測 仕様書
+
+## 1. 概要
+
+### 1.1 目的
+
+Direct controller の実機テストで、入力送信後に `close()` へ進む前の観測窓を設ける。通常送信中は入力が Switch へ届かず、切断前の ACL queue drain で初めて送られる退行を、従来の local state assertion だけで成功扱いしない。
+
+### 1.2 起点 / source
+
+| source | 内容 | path |
+|---|---|---|
+| external review / user request | Direct pairing 実機テストは `send()` 後に local state だけを確認して直ちに `close()` するため、close 前の Switch 入力反映を確認できない | `tests/hardware/test_pairing_profile.py` |
+| current transport contract | Direct の成功と `report_tx` は Bumble enqueue 受理を表し、Switch 反映を表さない。切断時は pending ACL queue を drain する | `spec/complete/unit_064/BUMBLE_ENQUEUE_COMPLETION_CONTRACT.md` |
+
+### 1.3 use case
+
+| actor / boundary | 入力または状態 | 期待する観測結果 | 制約 |
+|---|---|---|---|
+| hardware test operator | Switch の入力確認画面を開き、Direct controller の sentinel button を送信する | `close()` 開始前の観測窓で対象 button が表示される | 画面反映は pytest だけでは判定せず、利用者確認を hardware log に記録する |
+| transport regression | 通常 send の queue が close まで進行しない | pytest の trace 順序は通っても、close 前の Switch 画面確認が失敗する | close 時 drain による遅延送信を成功根拠にしない |
+
+## 2. 対象範囲
+
+- Direct Pro Controller / Joy-Con L / Joy-Con R の fresh pairing 実機テスト。
+- 実機 gate は Direct Pro / Button A の代表ケースを先に実行する。
+- Direct input の enqueue 後、neutral と `close()` の前に設ける手動観測窓。
+- operator の準備条件、期待 button、観測窓完了、close 開始、cleanup を trace に記録する。
+- pytest pass と Switch UI の目視結果を別の証拠として扱う。
+
+## 3. 対象外
+
+- `send()` を controller completion や Switch 反映まで待つ API への変更。
+- Bumble `DataPacketQueue` の内部計測や production diagnostics の追加。
+- CI での実機入力反映検証。
+- report bytes、button bit、controller profile の変更。
+- active reconnect の入力反映。今回の起点は fresh pairing test の acceptance gap であり、reconnect は別検証とする。
+
+## 4. 関連 docs
+
+- `spec/initial/api.md`
+- `spec/initial/lifecycle.md`
+- `spec/initial/testing.md`
+- `spec/complete/unit_050/DIRECT_REPORTING_TYPES.md`
+- `spec/complete/unit_054/EXP_LOCAL_ADDRESS_PROFILE_DIRECT.md`
+- `spec/complete/unit_064/BUMBLE_ENQUEUE_COMPLETION_CONTRACT.md`
+- `tests/hardware/README.md`
+
+## 5. 根拠監査
+
+| 項目 | 要否 | 状態 | 根拠 / 理由 |
+|---|---|---|---|
+| Switch HID / report bytes | not applicable | not applicable | 既存の sentinel `InputState` と report builder を変更しない |
+| Bumble / transport | required | done | unit_064 の enqueue 受理と disconnect 前 drain 契約を利用する。新しい transport 仮定は追加しない |
+| OS / driver / adapter | required | done | Windows 11、専用 `usb:0`、CSR8510 A10、WinUSB、Bumble 0.0.230、Python 3.13.5 で代表ケースを実行し、`spec/hardware-test-log.md` に記録した |
+
+## 6. 振る舞い仕様
+
+| 振る舞い | 入力・状態 | 期待結果 | 備考 |
+|---|---|---|---|
+| operator preparation | Direct fresh pairing を開始する | Switch の controller search / change grip order 画面、controller、button、観測秒数を trace と stderr に出す | 画面準備なしの run は input reflection の根拠にしない |
+| pre-close observation | `send(sentinel_state)` が正常終了する | local state と direct `report_tx` を確認し、neutral / close を呼ばず観測窓を維持する | `report_tx` 自体は enqueue 受理だけを表す |
+| cleanup ordering | 観測窓が完了する | 観測窓完了後に初めて `close(neutral=True)` を開始する | button pressed を残さない |
+| evidence classification | pytest が pass する | enqueue、trace 順序、profile、cleanup の成功として扱う | Switch UI は利用者確認が記録された場合だけ observed-pass |
+
+## 7. TDD Test List
+
+| status | item | type | layer | hardware | notes |
+|---|---|---|---|---|---|
+| green | fresh pairing の Direct input は close 前の観測窓を完了してから neutral close する | regression | hardware | yes | Pro / Button A の代表ケースが `1 passed in 33.27s`。Joy-Con L / R は collection のみ |
+| green | trace は direct enqueue、観測窓完了、close 開始、transport close の順序を保持する | regression | hardware | yes | direct `0x30` index 23、観測窓完了 71、close 開始 72、transport close 103、cleanup 104 |
+| green | Switch UI に対象 button が close 前に表示される | characterization | hardware | yes | 利用者が観測窓中の画面反応とコントローラー認識を目視確認した |
+
+## 8. 文書検証計画
+
+公開文書は変更しない。作業仕様、hardware test docstring、`tests/hardware/README.md` を照合し、pytest pass と人間の目視結果を混同していないことをレビューする。
+
+## 9. 設計メモ
+
+### Test Desiderata Review
+
+| test | value | trade-off | decision |
+|---|---|---|---|
+| fake transport Direct send | isolated、deterministic、fast、precise | Switch-facing queue progression を表さない | 既存 integration test を維持する |
+| Direct pre-close hardware observation | representative。close drain に隠れる退行を観測できる | 手動、低速、adapter と Switch 状態に依存する | CI 外の承認制 hardware test として追加する |
+| Bumble private queue assertion | queue 内部には precise | Bumble 内部構造へ密結合し、Switch 反映を証明しない | 追加しない |
+
+### Gaps
+
+- 自動化された Switch UI assertion はない。利用者確認と hardware log が必要。
+- 観測窓は queue completion の時刻を測定しない。close 前に入力反映を確認するための時間境界である。
+
+## 10. 対象ファイル
+
+| path | change | 内容 |
+|---|---|---|
+| `tests/hardware/test_pairing_profile.py` | modify | Direct fresh pairing に operator checkpoint と close 前観測窓を追加 |
+| `spec/complete/unit_068/DIRECT_PRE_CLOSE_INPUT_REFLECTION.md` | new | 対象範囲、検証境界、実機条件を記録 |
+| `spec/hardware-test-log.md` | modify | 実機 rerun、cleanup、利用者確認を記録 |
+
+## 11. 検証
+
+| command | result | notes |
+|---|---|---|
+| `uv sync --dev` | pass | 53 packages resolved |
+| `uv run ruff format --check .` | pass | 100 files already formatted |
+| `uv run ruff check .` | pass | All checks passed |
+| `uv run ty check --no-progress` | pass | All checks passed |
+| `uv run pytest tests/unit` | pass | 468 passed |
+| `uv run pytest tests/integration` | pass | 137 passed |
+| `uv run pytest tests/hardware/test_pairing_profile.py --collect-only -q` | pass | adapter を開かず14件を収集。Direct fresh / reconnect は各3 controller |
+| `uv run pytest tests/hardware/test_pairing_profile.py -q` | skipped | adapter option を指定せず14件すべて skip。実機経路は未実行 |
+| `uv sync --dev --group docs` | pass | docs dependencies を同期 |
+| `uv run mkdocs build --strict` | pass | strict build 成功 |
+| read-only adapter identity preflight / postflight | pass | HCI / CSR はともに `0E:08:71:C0:B4:5C`、postflight は `adapter_closed` |
+| Direct Pro fresh pairing / Button A | pass | `1 passed in 33.27s`。30秒の close 前観測窓と trace 順序 assertion が成功 |
+| Switch UI 目視 | observed-pass | 利用者が close 前に画面反応とコントローラー認識を確認 |
+| 先行 reconnect 2件 | failed before send | HCI authentication failure reason 5。Button A 送信と観測窓より前の失敗であり、input reflection の判定には使用しない |
+
+## 12. 実機実行条件
+
+| 項目 | 内容 |
+|---|---|
+| 実機要否 | required for input reflection completion |
+| 承認範囲 | 専用 adapter open、profile identity preparation、Direct HID fresh pairing、sentinel button 1件、close 前観測窓、neutral close |
+| adapter | dedicated `usb:0`、CSR8510 A10、VID:PID `0A12:0001`、WinUSB |
+| 実行遮断 | 環境変数による遮断は採用しない。明示承認、対象 adapter、command、cleanup plan で管理する |
+| log / artifact | `build/hardware/unit_068/direct-pro-fresh-pre-close-20260724-115129/` と利用者目視結果を `spec/hardware-test-log.md` に記録 |
+| cleanup | `close(neutral=True)`、disconnect、transport close、adapter release を実行。postflight で identity 一致と `adapter_closed` を確認 |
+
+## 13. 先送り事項
+
+- Joy-Con L / Joy-Con R の同一観測は未実行。今回の完了 gate は仕様どおり Direct Pro / Button A の代表ケースとし、両 variant は必要になった時点で同じ parameterized test を実行する。
+
+## 14. チェックリスト
+
+- [x] 対象範囲と対象外を確認した
+- [x] TDD Test List または文書検証計画を更新した
+- [x] 必要な根拠監査を記録した
+- [x] 実機実行条件を記録した
+- [x] close 前観測窓を実装した
+- [x] 非実機 gate の結果を記録した
+- [x] 実機 rerun と利用者確認を記録した