Add OskSim input-pipeline harness (+155 tests) and fix input bugs

.github/workflows/build.yml

@@ -21,8 +21,10 @@ jobs:
           # Full history so build.py can read the latest tag for the exe version.
           fetch-depth: 0
 
-      - name: Set up mise
-        uses: jdx/mise-action@3c2e0cf82a5b2e5249f0d3635a4d83d0ae861518 # v4.2.5
+      # mise provides python 3.12 (see mise.toml); action caches installs.
+      - uses: jdx/mise-action@3c2e0cf82a5b2e5249f0d3635a4d83d0ae861518 # v4.2.5
+        with:
+          cache: true
 
       - name: Install dependencies
         run: python -m pip install --upgrade pip && python -m pip install --prefer-binary -r requirements.txt

.github/workflows/tests.yml

@@ -14,12 +14,30 @@ permissions:
   pull-requests: write
 
 jobs:
+  lint:
+    # Platform-neutral gates (ruff, ruff-format, basedpyright, hygiene)
+    # on the cheap runner; pytest keeps its own Windows job below.
+    name: pre-commit
+    runs-on: windows-latest
+    timeout-minutes: 15
+    steps:
+      - uses: actions/checkout@3d3c42e5aac5ba805825da76410c181273ba90b1 # v7.0.1
+        with:
+          # Full history so pre-commit can diff origin/main..HEAD.
+          fetch-depth: 0
+      - uses: jdx/mise-action@3c2e0cf82a5b2e5249f0d3635a4d83d0ae861518 # v4.2.5
+      - name: Pre-commit (origin/main..HEAD)
+        run: mise exec -- pre-commit run -av --from-ref origin/main --to-ref HEAD
+
   tests:
     name: tests
     runs-on: windows-latest
     timeout-minutes: 30
     steps:
       - uses: actions/checkout@3d3c42e5aac5ba805825da76410c181273ba90b1 # v7.0.1
+        with:
+          # Full history so pre-commit can diff origin/main..HEAD.
+          fetch-depth: 0
       - name: Set up mise
         id: setup-mise
         uses: jdx/mise-action@3c2e0cf82a5b2e5249f0d3635a4d83d0ae861518 # v4.2.5

README.md

@@ -136,6 +136,28 @@ Quitting from the tray never dispatches the `/0` restore; if the appid
 changed another way, relaunch and open/close the keyboard once (or alt-tab)
 to make Steam re-evaluate.
 
+## Testing
+
+The OSK has a headless UI-test harness (an input-pipeline simulator (OskSim)) that
+drives the real input pipeline — controller frame parsing, the pad/click
+state machines, hold-to-repeat cadence and the variant-row defer model —
+with a virtual clock, recording every key/mouse injection at the OS
+boundary. No display, Steam, or controller required:
+
+```sh
+cd windows
+python -m pytest tests -q                 # whole suite (fast, headless)
+python -m pytest tests/test_diacritic_hold.py -q   # one layer-2 module
+```
+
+Layers: pure state-machine tests (`test_nav_cursor`), synthetic-input
+injection through `ControllerManager` + the shared drain loop
+(`tests/osk_sim.py`, used by `test_typing_flow`, `test_diacritic_hold`,
+`test_pad_pointer`). CI runs the same suite on every push via
+`.github/workflows/test.yml` (JUnit XML artifact). Known OS-level
+injection quirks on real hardware (pynput/SendInput desync) are out of
+scope for this harness — those need a physical device.
+
 ## Development Notes
 
 This project was built through AI-assisted development: a human set the

mise.toml

@@ -1,5 +1,4 @@
 [tools]
 python = "3.12"
-prek = "0.4.13"
-ruff = "0.16.3"
-"github:DetachHead/basedpyright" = "1.39.10"
+uv = "0.9.9"
+"pipx:pre-commit" = "4.6.2"

pyrightconfig.json

@@ -6,7 +6,9 @@
       "root": "windows"
     }
   ],
-  "include": ["windows"],
+  "include": [
+    "windows"
+  ],
   "reportMissingTypeStubs": "none",
   "reportMissingParameterType": "none",
   "reportUnknownMemberType": "none",
@@ -25,6 +27,6 @@
   "reportUnusedVariable": "none",
   "reportPrivateUsage": "none",
   "reportUnusedImport": "none",
-  "reportMissingImports": "warning",
+  "reportMissingImports": "none",
   "reportGeneralTypeIssues": "none"
 }

ruff.toml

@@ -13,4 +13,5 @@ ignore = [
 
 [lint.per-file-ignores]
 # Tests may use bare asserts and fixtures with unused params.
-"tests/*.py" = ["B017"]
+# (** crosses the per-module subdirs: tests/<module>/<name>.py)
+"tests/**/*.py" = ["B017"]