NodeJSmith
diff --git a/‎.github/copilot-instructions.md‎
Lines changed: 11 additions & 1 deletion b/‎.github/copilot-instructions.md‎
Lines changed: 11 additions & 1 deletion
diff --git a/‎CHANGELOG.md‎
Lines changed: 15 additions & 0 deletions b/‎CHANGELOG.md‎
Lines changed: 15 additions & 0 deletions
diff --git a/‎docs/apps.rst‎
Lines changed: 3 additions & 3 deletions b/‎docs/apps.rst‎
Lines changed: 3 additions & 3 deletions
@@ -23,6 +23,7 @@ These notes make AI coding agents productive quickly in this repo. Focus on the
 
 - Base classes: `src/hassette/core/resources/app/app.py` exposes `App[AppConfigT]` (async) and `AppSync`. Override lifecycle hooks (`before_initialize`, `on_initialize`, `after_initialize`, and matching shutdown hooks); `initialize()` / `shutdown()` are final.
 - Example async app:
+
   ```python
   from hassette import App, AppConfig
 
@@ -31,7 +32,7 @@ These notes make AI coding agents productive quickly in this repo. Focus on the
 
   class MyApp(App[MyConfig]):
       async def on_initialize(self):
-          self.bus.on_entity(
+          self.bus.on_state_change(
               self.app_config.light,
               handler=self.on_light_change,
               changed_to="on",
@@ -40,6 +41,7 @@ These notes make AI coding agents productive quickly in this repo. Focus on the
       async def on_light_change(self, event):
           await self.api.call_service("notify", "mobile_app_me", message="Light turned on")
   ```
+
 - Sync apps inherit `AppSync` and implement `on_initialize_sync` / `on_shutdown_sync`; use `self.api.sync.*` for blocking calls. `self.task_bucket` offers helpers (`spawn`, `run_in_thread`, `run_sync`) for background work.
 
 ## Event Bus Usage
@@ -102,3 +104,11 @@ These notes make AI coding agents productive quickly in this repo. Focus on the
 - Config: `src/hassette/config/{core_config.py,app_manifest.py,sources_helper.py}`
 - Events & models: `src/hassette/events/**`, `src/hassette/models/**`, `src/hassette/topics.py`
 - Examples & tests: `examples/`, `tests/` (fixtures in `tests/conftest.py`)
+
+## Code Conventions
+
+- Type hints: Strong typing is a first-class citizen. Use `typing` and `typing_extensions` features liberally (e.g. `TypeVar`, `Generic`, `Protocol`, `runtime_checkable`, `final`, `Literal`, `TypedDict`, etc.). Leverage existing types in `src/hassette/types.py` and domain-specific models in `src/hassette/models/`.
+- Pyrigh and Ruff: Type checking is enforced via Pyright (`pyrightconfig.json`) and linting via Ruff (`ruff.toml`). Follow their rules and fix violations promptly. Do not use mypy style type comments.
+- Docstrings: Document all public classes, methods, and functions with clear docstrings. Follow the Google style guide for consistency.
+- Examples: Include usage examples in docstrings where applicable, especially for complex methods or classes.
+- Documentation is written in reStructuredText (`.rst`) format and lives in the `docs/` directory. Update docs alongside code changes to keep them in sync. Docstring examples should be formatted for inclusion in the docs.
@@ -7,6 +7,8 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0
 
 ## Unreleased
 
+## [0.14.0] - 2025-10-19
+
 ### Added
 - Add validation for filename extension in AppManifest - add `.py` if no suffix, raise error if not `.py`
 - Bus handlers can now accept args and kwargs to be passed to the callback when the event is fired
@@ -23,6 +25,19 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0
 ### Fixed
 - Correct scheduler helpers `run_minutely`, `run_hourly`, and `run_daily` to not start immediately if no `start` was provided, but to start on the next interval instead.
 
+### Bus/Predicate Refactor
+- Refactored predicates to use composable `Predicates`, `Conditions`, and `Accessors`
+  - `Predicate` is a callable that takes an event and returns a bool
+    - E.g. `AttrFrom`, `AttrTo`, `DomainMatches`, `EntityMatches`, `ValueIs`, etc.
+  - `Condition` is a callable that takes a value and returns a bool
+    - E.g. `Glob`, `Contains`, `IsIn`, `IsOrContains`, `Intersects`, etc.
+  - `Accessor` is a callable that takes an event and returns a value
+    - E.g. `get_domain`, `get_entity_id`, `get_service_data`, `get_path`, etc.
+- Updated Bus methods to use new predicate system
+  - Only implementation changes, public API remains the same
+- Updated tests to use new predicate system
+- Add/update types for predicates, conditions, and accessors
+- Updated documentation for predicates and bus event listening to reflect new system
 
 ## [0.13.0] - 2025-10-14
 
 
@@ -29,7 +29,7 @@ Example
 
    class MyApp(App[MyAppConfig]):
        async def on_initialize(self):
-           self.on_change_listener = self.bus.on_entity(self.app_config.light, handler=self.on_change)
+           self.on_change_listener = self.bus.on_state_change(self.app_config.light, handler=self.on_change)
            self.minutely_logger = self.scheduler.run_minutely(self.log_every_minute)
 
        async def on_change(self, event: StateChangeEvent[states.LightState]):
@@ -54,7 +54,7 @@ App Capabilities
   - ``self.app_config``: The parsed config for this app instance, typed as the app's ``AppConfig`` class.
   - ``self.index``: The index of this app instance in the config list, or 0 if only a single instance.
   - ``self.instance_name``: The name of this app instance as set in the config, or ``<ClassName>.[index]`` if not set.
-  - ``self.now()``: Get the current time as ``SystemDateTime``.
+  - ``self.now()``: Get the current time as ``ZonedDateTime``.
 
 Advanced Capabilities
 ---------------------
@@ -136,7 +136,7 @@ The base AppConfig class includes two fields by default:
 
    class Presence(App[PresenceConfig]):
        async def on_initialize(self):
-           self.bus.on_entity(self.app_config.motion_sensor, handler=self.on_motion, changed_to="on")
+           self.bus.on_state_change(self.app_config.motion_sensor, handler=self.on_motion, changed_to="on")
 
        async def on_motion(self, event):
            for light in self.app_config.lights: