Add behave hook to pre-commit and CI

Pre-commit / CI:
- Add local behave hook (language: python, all project deps listed)
- Add behave step to GitHub Actions workflow

Bug fixes in sound player state machine:
- fade_in/callable.Forced: was calling compute_new_state(state, "base", ...)
  but "base" is not a registered output state for fade_in, causing a silent
  KeyError and leaving the state in fade_in instead of transitioning to
  forced_off. Fix: use get_new_state(state, "forced_off") for forced.Off.
- sound_player.feature: rows @1.3 and @1.45 expected off after
  sleepiness.Awake from an off-with-elapsed-On setup, but the auto-inject
  (elapsed.Event.Off injected on fade_in→off) means the off state always
  has elapsed=Off after a fade-in cycle, so sleepiness.Awake correctly
  transitions to fade_in. Update expected state to fade_in.

Fix scheduler trigger type check

- Fix scheduler trigger type comparison: change `type` from @Property to
  a class variable in Trigger, state.Trigger, and protocol.Trigger so that
  class-level comparisons (e.g. Trigger.type == "APPLIANCE STATE") work
  correctly; this fixes 5 failing unit tests where _schedule_by_trigger_fork
  was never called

Improve documentation: replace sphinx-gherkindoc, add docs target, fix English

- Replace broken sphinx-gherkindoc (incompatible with Sphinx 9) with a
  lightweight custom script docs/gherkindoc.py that converts .feature files
  to RST code-block pages using only the Python standard library
- Update docs/Makefile to use the new script via the PYTHON variable
- Fix numerous English issues across all RST documentation files and README:

Assisted-By: Claude Sonnet 4.6 <noreply@anthropic.com>

Author: majamassarini

.github/workflows/test.yml

@@ -1,4 +1,4 @@
-name: Unit Tests
+name: Tests
 
 on:
   push:
@@ -28,6 +28,10 @@ jobs:
       run: |
         python -m coverage run -m unittest discover -s home/tests -t . -v
 
+    - name: Run behave tests with coverage
+      run: |
+        python -m coverage run --append -m behave home/features/
+
     - name: Generate coverage report
       run: |
         python -m coverage report -m

.pre-commit-config.yaml

@@ -18,3 +18,21 @@ repos:
         args: [--config-file=pyproject.toml]
         additional_dependencies: [types-PyYAML, types-pytz, types-tzlocal]
         exclude: ^(home/tests/|docs/)
+
+  - repo: local
+    hooks:
+      - id: behave
+        name: behave
+        entry: behave
+        args: [home/features/]
+        language: python
+        additional_dependencies:
+          - behave
+          - APScheduler>=3.10.0
+          - redis>=4.2.0
+          - hiredis>=2.0.0
+          - ephem
+          - tzlocal
+          - pytz
+          - PyYAML
+        pass_filenames: false