Fix presence_mode_reset blueprint variable scoping issue

Move condition check into action sequence after variables are defined. Previously, the condition tried to use 'occupancy_sensors' before it was defined, causing UndefinedError during automation execution.
Add comprehensive documentation and testing tools
2025-12-21 15:35:23 -08:00 · 2025-12-21 14:30:53 -08:00 · 2025-12-21 14:30:41 -08:00 · 2025-12-20 15:36:06 -08:00 · 2025-12-20 15:33:41 -08:00
13 changed files with 1399 additions and 21 deletions
--- a/CHANGELOG.md
+++ b/CHANGELOG.md
@@ -0,0 +1,53 @@
+# Changelog
+
+All notable changes to the Adaptive Lighting Mode System will be documented in
+this file.
+
+The format is based on [Keep a Changelog](https://keepachangelog.com/en/1.0.0/).
+
+## [1.0.0] - 2025-12-20
+
+### Added
+
+**Blueprints**:
+- `inovelli_mode_cycling.yaml` - Config button cycles through lighting modes
+  with LED feedback
+- `inovelli_button_actions.yaml` - Multi-tap brightness controls with
+  auto-reset
+- `presence_mode_reset.yaml` - Auto-reset modes and manual control when room
+  empty
+
+**Package Templates**:
+- `adaptive_lighting_global.yaml` - Shared mode definitions and color mappings
+- `adaptive_lighting_bedroom_template.yaml` - Complete bedroom example with 5
+  modes
+- `adaptive_lighting_living_room_template.yaml` - Living room example with
+  entertainment modes
+- `adaptive_lighting_simple_template.yaml` - Minimal template for simple rooms
+
+**Documentation**:
+- `PACKAGE_SETUP_GUIDE.md` - Setup instructions and version control guide
+- `ROOM_CONFIGURATION_GUIDE.md` - Room-by-room configuration examples
+- `HARDWARE_TESTING_CHECKLIST.md` - Comprehensive testing checklist
+- Updated `README.md` with system overview and quick start
+
+**Features**:
+- Room-specific mode definitions (Adaptive, Reading, Theater, Sleep, etc.)
+- Visual LED feedback using ROYGBIV color scheme
+- Weekend mode with automatic sunrise/sunset adjustments
+- Multi-tap button actions (boost, max, night light)
+- Presence-based auto-reset
+- Version-controlled package-based configuration
+
+### Technical Details
+
+- Zigbee2MQTT integration for Inovelli Blue VZM31-SN switches
+- Home Assistant Adaptive Lighting integration required
+- Package-based architecture for easy version control
+- Template-driven room setup for scalability
+
+### Known Limitations
+
+- Zigbee2MQTT only (Z-Wave JS requires different MQTT topics)
+- Settings from `adaptive_lighting.change_switch_settings` reset on HA restart
+- Requires manual Inovelli switch configuration (Smart Bulb Mode, buttonDelay)
--- a/HARDWARE_TESTING_CHECKLIST.md
+++ b/HARDWARE_TESTING_CHECKLIST.md
@@ -0,0 +1,110 @@
+# Hardware Testing Checklist
+
+## Prerequisites
+
+- [ ] Inovelli Blue Dimmer VZM31-SN paired with Zigbee2MQTT
+- [ ] Switch in Smart Bulb Mode (select.xxx_smart_bulb_mode = "Smart Bulb
+  Mode")
+- [ ] buttonDelay set to 500ms or 700ms (select.xxx_button_delay)
+- [ ] Smart bulbs powered and responsive
+- [ ] Adaptive Lighting integration installed and configured
+- [ ] All packages and blueprints loaded
+
+## Switch Configuration Tests
+
+- [ ] Smart Bulb Mode enabled: Load always powered
+- [ ] LED bar displays color correctly
+- [ ] LED intensity acceptable (adjust if too bright/dim)
+- [ ] Button presses detected: event.xxx_action updates
+- [ ] Single tap: Shows "up_single" or "down_single"
+- [ ] Double tap: Shows "up_double" or "down_double" reliably
+- [ ] Triple tap: Shows "up_triple" or "down_triple" reliably
+- [ ] Config button: Shows "config_single"
+
+## Mode Cycling Tests
+
+- [ ] Config button press triggers automation
+- [ ] Mode cycles through all available modes
+- [ ] Mode cycles back to first after last mode
+- [ ] input_select updates in UI
+- [ ] LED color changes to match mode
+- [ ] LED flash pulse visible (3 seconds)
+- [ ] Colors distinguishable for each mode
+- [ ] Cycle works from any starting mode
+
+## Mode Application Tests
+
+For each mode:
+- [ ] Adaptive: AL settings reset to configuration defaults
+- [ ] Reading: Brightness increases, color cools
+- [ ] Theater: Brightness decreases, color warms
+- [ ] Sleep: Very dim, red/amber color
+- [ ] Manual Override: AL paused, manual control enabled
+
+## Button Action Tests
+
+- [ ] Double tap up: Brightness boosts +50%
+- [ ] Double tap up: Color temperature increases +1000K
+- [ ] Double tap down: Returns to AL control immediately
+- [ ] Triple tap up: Sets 100% brightness, 4000K (neutral)
+- [ ] Triple tap down: Sets 5% brightness, warm red
+- [ ] Auto-reset: Returns to AL after configured timeout
+- [ ] Auto-reset: Works after boost action
+- [ ] Auto-reset: Works after max brightness
+- [ ] Auto-reset: Works after night light
+
+## Weekend Mode Tests (if configured)
+
+- [ ] Enables automatically Friday 10pm
+- [ ] Disables automatically Sunday 10pm
+- [ ] Sunrise time shifts when enabled
+- [ ] Max brightness reduces when enabled
+- [ ] Settings restore when disabled
+- [ ] Triple-tap toggle works (if configured)
+- [ ] LED flash confirms toggle
+
+## Presence Integration Tests (if configured)
+
+- [ ] Presence sensor triggers correctly
+- [ ] Lights turn on when occupied
+- [ ] Lights stay on while occupied
+- [ ] Manual control resets after room empty
+- [ ] Mode resets after room empty (if configured)
+- [ ] Delay timing is appropriate
+- [ ] Works with multiple sensors (OR logic)
+
+## Edge Cases and Failure Modes
+
+- [ ] Rapid button presses don't cause errors
+- [ ] Mode change while lights off doesn't error
+- [ ] Switching modes rapidly doesn't break AL
+- [ ] Zigbee network congestion doesn't cause issues
+- [ ] Home Assistant restart preserves mode
+- [ ] AL switch off doesn't break mode system
+- [ ] Invalid mode name doesn't crash automation
+- [ ] Missing entity gracefully fails
+
+## Performance Tests
+
+- [ ] Mode change response < 1 second
+- [ ] LED update response < 1 second
+- [ ] Button action response < 1 second
+- [ ] AL adaptation smooth (no flicker)
+- [ ] No automation trace errors
+- [ ] No excessive log warnings
+
+## Multi-Room Tests
+
+- [ ] Multiple rooms work independently
+- [ ] Mode cycling doesn't affect other rooms
+- [ ] LED colors consistent across rooms
+- [ ] Performance acceptable with many rooms
+- [ ] Global package shared correctly
+
+## Documentation Accuracy
+
+- [ ] All entity IDs in examples are correct format
+- [ ] Zigbee2MQTT topics match actual topics
+- [ ] Service calls work as documented
+- [ ] Examples produce expected behavior
+- [ ] Troubleshooting guide solves real issues
--- a/PACKAGE_SETUP_GUIDE.md
+++ b/PACKAGE_SETUP_GUIDE.md
@@ -0,0 +1,220 @@
+# Package Setup Guide
+
+## Overview
+
+This guide explains how to set up Home Assistant packages for the Adaptive
+Lighting Mode System and configure version control.
+
+## What Are Packages?
+
+Packages allow you to organize Home Assistant configuration into multiple YAML
+files instead of one giant `configuration.yaml`. Each package file can contain
+automations, helpers, scripts, and other entities related to a specific feature
+or room.
+
+**Benefits**:
+- Organize configuration by room or feature
+- Version control specific areas independently
+- Easier to share and reuse configurations
+- Keep `configuration.yaml` clean and minimal
+
+## Prerequisites
+
+- Home Assistant installed and running
+- SSH or file editor access to your HA configuration directory
+- Git installed (optional, for version control)
+- Adaptive Lighting integration installed via HACS
+
+## Step 1: Enable Packages in Home Assistant
+
+**1.1 Edit your `configuration.yaml`**
+
+Add this line to the top of your `configuration.yaml`:
+
+```yaml
+homeassistant:
+  packages: !include_dir_named packages/
+```
+
+**1.2 Create the packages directory**
+
+SSH into your Home Assistant instance or use File Editor add-on:
+
+```bash
+cd /config
+mkdir packages
+```
+
+**1.3 Restart Home Assistant**
+
+Settings → System → Restart Home Assistant
+
+## Step 2: Install Global Definitions
+
+**2.1 Copy the global package**
+
+Download or copy `packages/adaptive_lighting_global.yaml` from this repository
+to your `/config/packages/` directory.
+
+**2.2 Reload YAML configuration**
+
+Developer Tools → YAML → Reload all YAML configuration
+
+**2.3 Verify helpers exist**
+
+Settings → Devices & Services → Helpers
+
+You should see:
+- `input_text.adaptive_lighting_mode_colors`
+- `input_text.adaptive_lighting_settings_adaptive`
+- `input_text.adaptive_lighting_settings_reading`
+- `input_text.adaptive_lighting_settings_relaxing`
+- `input_text.adaptive_lighting_settings_sleep`
+- And several more mode settings helpers
+
+## Step 3: Import Blueprints
+
+**3.1 Import via UI**
+
+Settings → Automations & Scenes → Blueprints → Import Blueprint
+
+Import these URLs:
+```
+https://git.johnogle.info/johno/home-assistant-blueprints/raw/branch/main/blueprints/automation/inovelli_mode_cycling.yaml
+https://git.johnogle.info/johno/home-assistant-blueprints/raw/branch/main/blueprints/automation/inovelli_button_actions.yaml
+https://git.johnogle.info/johno/home-assistant-blueprints/raw/branch/main/blueprints/automation/presence_mode_reset.yaml
+```
+
+**3.2 Verify blueprints imported**
+
+Settings → Automations & Scenes → Blueprints
+
+You should see all three blueprints listed.
+
+## Step 4: Configure Your First Room
+
+**4.1 Choose a template**
+
+Select the appropriate template for your room type:
+- Bedroom: `packages/adaptive_lighting_bedroom_template.yaml`
+- Living room: `packages/adaptive_lighting_living_room_template.yaml`
+- Simple (bathroom, closet): `packages/adaptive_lighting_simple_template.yaml`
+
+**4.2 Copy and customize**
+
+```bash
+cd /config/packages
+cp adaptive_lighting_bedroom_template.yaml adaptive_lighting_master_bedroom.yaml
+```
+
+Edit the file and update:
+- Replace "bedroom" with "master_bedroom" throughout
+- Update entity IDs (search for # UPDATE THIS comments)
+- Adjust available modes if desired
+- Customize mode settings
+
+**4.3 Reload configuration**
+
+Developer Tools → YAML → Reload all YAML configuration
+
+**4.4 Create blueprint automations**
+
+Settings → Automations & Scenes → Create Automation → Use Blueprint
+
+Create automations for:
+1. Inovelli Mode Cycling (config button)
+2. Inovelli Button Actions (multi-tap)
+3. Presence Mode Reset (if you have occupancy sensors)
+
+## Step 5: Version Control Setup (Optional)
+
+**5.1 Initialize git repository**
+
+```bash
+cd /config
+git init
+```
+
+**5.2 Create .gitignore**
+
+```bash
+cat > .gitignore << 'EOF'
+# Secrets and sensitive data
+secrets.yaml
+*.db
+*.db-shm
+*.db-wal
+*.log
+
+# Generated files
+*.pyc
+__pycache__/
+.storage/
+.cloud/
+.google.token
+
+# Add-on data
+.ssh/
+.vscode/
+
+# Keep these version controlled:
+# - packages/
+# - automations.yaml
+# - configuration.yaml
+# - blueprints/
+EOF
+```
+
+**5.3 Commit initial setup**
+
+```bash
+git add packages/ automations.yaml configuration.yaml
+git commit -m "Initial adaptive lighting mode system setup"
+```
+
+**5.4 Add remote (optional)**
+
+```bash
+git remote add origin your-git-repo-url
+git push -u origin main
+```
+
+## Troubleshooting
+
+### Packages not loading
+
+**Symptom**: Helpers don't appear after reloading
+
+**Solutions**:
+- Check `configuration.yaml` has packages line
+- Verify packages directory exists at `/config/packages/`
+- Check YAML syntax: `yamllint /config/packages/*.yaml`
+- Look for errors in Settings → System → Logs
+
+### Entity IDs don't match
+
+**Symptom**: Automations fail because entities not found
+
+**Solutions**:
+- Go to Settings → Devices & Services → MQTT
+- Find your Inovelli switch device
+- Note the exact entity IDs (event.xxx_action,
+  number.xxx_led_color_when_on)
+- Update package file with correct entity IDs
+- Reload YAML
+
+### Blueprints not working
+
+**Symptom**: Automation from blueprint doesn't trigger
+
+**Solutions**:
+- Check automation trace: Settings → Automations → [your automation] →
+  Traces
+- Verify trigger entity is correct
+- Ensure Inovelli buttonDelay is set to >= 500ms
+- Test button press in Developer Tools → States (watch event.xxx_action)
+
+## Next Steps
+
+See [ROOM_CONFIGURATION_GUIDE.md](ROOM_CONFIGURATION_GUIDE.md) for detailed
+room setup examples.
--- a/README.md
+++ b/README.md
@@ -2,49 +2,68 @@

 ## Adaptive Lighting Mode System

-A comprehensive mode-based lighting control system for Inovelli Blue Dimmer Switches with Adaptive Lighting integration.
+A comprehensive mode-based lighting control system for Inovelli Blue Dimmer
+Switches with Adaptive Lighting integration.

 ### Features

- **Room-specific modes**: Define custom lighting modes per room (Reading, Theater, Sleep, etc.)
+- **Room-specific modes**: Define custom lighting modes per room (Reading,
+  Theater, Sleep, etc.)
 - **Visual LED feedback**: LED bar color indicates current mode
 - **Config button control**: Press config button to cycle through modes
 - **Multi-tap actions**: Double-tap boost, triple-tap max/night light
- **Adaptive Lighting integration**: Dynamic brightness and color following sun position
+- **Adaptive Lighting integration**: Dynamic brightness and color following sun
+  position
 - **Version controlled**: All configuration in git-trackable package files

 ### System Components

 **Blueprints** (Reusable):
 - `inovelli_mode_cycling.yaml` - Config button cycles modes with LED feedback
- `inovelli_button_actions.yaml` - Multi-tap brightness controls (coming soon)
- `presence_mode_reset.yaml` - Auto-reset on room exit (coming soon)
+- `inovelli_button_actions.yaml` - Multi-tap brightness controls
+- `presence_mode_reset.yaml` - Auto-reset on room exit

 **Packages** (Templates):
 - `adaptive_lighting_global.yaml` - Shared mode definitions and colors
- `adaptive_lighting_bedroom_template.yaml` - Complete bedroom example (coming soon)
- `adaptive_lighting_living_room_template.yaml` - Living room example (coming soon)
+- `adaptive_lighting_bedroom_template.yaml` - Complete bedroom example
+- `adaptive_lighting_living_room_template.yaml` - Living room example
+- `adaptive_lighting_simple_template.yaml` - Minimal single-mode room

-### Quick Start
+### Setup Guide

-See [PACKAGE_SETUP_GUIDE.md](PACKAGE_SETUP_GUIDE.md) for detailed setup instructions.
+**Quick Start**:
+1. Install Adaptive Lighting integration via HACS
+2. Follow [PACKAGE_SETUP_GUIDE.md](PACKAGE_SETUP_GUIDE.md) to enable packages
+3. Copy templates from `packages/` directory
+4. Import blueprints via UI
+5. See [ROOM_CONFIGURATION_GUIDE.md](ROOM_CONFIGURATION_GUIDE.md) for examples

-**Prerequisites**:
- Home Assistant with Adaptive Lighting integration installed
- Inovelli Blue Dimmer Switches (VZM31-SN) via Zigbee2MQTT
- Switches configured in Smart Bulb Mode
+**Documentation**:
+- [PACKAGE_SETUP_GUIDE.md](PACKAGE_SETUP_GUIDE.md) - Initial setup and version
+  control
+- [ROOM_CONFIGURATION_GUIDE.md](ROOM_CONFIGURATION_GUIDE.md) - Room-by-room
+  examples
+- [ADAPTIVE_LIGHTING_CONTROL_SYSTEM_DESIGN.md](ADAPTIVE_LIGHTING_CONTROL_SYSTEM_DESIGN.md) -
+  Complete system design

-**Installation**:
-1. Enable packages in `configuration.yaml`
-2. Copy `packages/adaptive_lighting_global.yaml` to your `config/packages/` directory
-3. Import blueprints via Home Assistant UI
-4. Create automations from blueprints for each room
+**Files**:
+- `packages/adaptive_lighting_global.yaml` - Required for all rooms
+- `packages/adaptive_lighting_bedroom_template.yaml` - Template for bedrooms
+- `packages/adaptive_lighting_living_room_template.yaml` - Template for common
+  areas
+- `packages/adaptive_lighting_simple_template.yaml` - Template for simple rooms
+- `blueprints/automation/inovelli_mode_cycling.yaml` - Config button mode
+  cycling
+- `blueprints/automation/inovelli_button_actions.yaml` - Multi-tap actions
+- `blueprints/automation/presence_mode_reset.yaml` - Auto-reset on room exit

 ### Import URLs

 **Blueprints**:
 ```
 https://git.johnogle.info/johno/home-assistant-blueprints/raw/branch/main/blueprints/automation/inovelli_mode_cycling.yaml
+https://git.johnogle.info/johno/home-assistant-blueprints/raw/branch/main/blueprints/automation/inovelli_button_actions.yaml
+https://git.johnogle.info/johno/home-assistant-blueprints/raw/branch/main/blueprints/automation/presence_mode_reset.yaml
 ```

 ---
--- a/ROOM_CONFIGURATION_GUIDE.md
+++ b/ROOM_CONFIGURATION_GUIDE.md
@@ -0,0 +1,200 @@
+# Room Configuration Guide
+
+Complete examples of configuring different room types with the Adaptive
+Lighting Mode System.
+
+## Example 1: Master Bedroom
+
+**Goal**: Full control with optional AL, reading/sleep modes, weekend mode
+
+**Hardware**:
+- Inovelli Blue Dimmer: `bedroom_switch` (Zigbee2MQTT name)
+- Lights: `light.bedroom_ceiling`, `light.bedroom_lamp_1`,
+  `light.bedroom_lamp_2`
+- No presence sensor (privacy)
+
+**Adaptive Lighting Configuration** (in `configuration.yaml`):
+```yaml
+adaptive_lighting:
+  - name: bedroom
+    lights:
+      - light.bedroom_ceiling
+      - light.bedroom_lamp_1
+      - light.bedroom_lamp_2
+    interval: 90
+    transition: 45
+    take_over_control: true
+    autoreset_control_seconds: 3600  # 1 hour gentle reset
+```
+
+**Package File** (`packages/adaptive_lighting_master_bedroom.yaml`):
+
+Copy from `adaptive_lighting_bedroom_template.yaml`, customize:
+- Modes: Adaptive, Reading, Relaxing, Sleep, Manual Override
+- Weekend mode enabled
+- Default mode: Adaptive
+
+**Blueprint Automations** (create via UI):
+
+1. **Config Button Mode Cycling**:
+   - Blueprint: Inovelli Mode Cycling
+   - Switch Action Event: `event.bedroom_switch_action`
+   - Mode Input Select: `input_select.bedroom_lighting_mode`
+   - LED Color Entity: `number.bedroom_switch_led_color_when_on`
+   - Zigbee2MQTT Device Name: `bedroom_switch`
+
+2. **Button Actions**:
+   - Blueprint: Inovelli Button Actions
+   - Switch Action Event: `event.bedroom_switch_action`
+   - AL Switch: `switch.adaptive_lighting_bedroom`
+   - Target Lights: `light.bedroom_ceiling`, `light.bedroom_lamp_1`,
+     `light.bedroom_lamp_2`
+   - Auto-Reset: 30 minutes
+
+**Testing**:
+- [ ] Press config button → mode cycles through all 5 modes
+- [ ] LED changes color for each mode
+- [ ] Double-tap up → brightness boosts
+- [ ] Weekend mode enables Friday 10pm
+- [ ] Sunrise shifts to 10am on weekend
+
+## Example 2: Living Room (Common Area)
+
+**Goal**: Entertainment modes (Theater, Party), presence control
+
+**Hardware**:
+- Inovelli Blue Dimmer: `living_room_switch`
+- Lights: `light.living_room_ceiling`, `light.living_room_lamp_1`
+- Presence: `binary_sensor.living_room_occupancy`
+
+**Package File** (`packages/adaptive_lighting_living_room.yaml`):
+
+Copy from `adaptive_lighting_living_room_template.yaml`
+- Modes: Adaptive, Theater, Party, Reading
+- Auto-reset mode to Adaptive when lights turn off
+
+**Blueprint Automations**:
+
+1. **Config Button Mode Cycling** (same as bedroom)
+2. **Button Actions** (same as bedroom, adjust auto-reset to 15 min)
+3. **Presence Mode Reset**:
+   - Occupancy Sensors: `binary_sensor.living_room_occupancy`
+   - Empty Delay: 5 minutes
+   - AL Switch: `switch.adaptive_lighting_living_room`
+   - Mode Input Select: `input_select.living_room_lighting_mode`
+   - Default Mode: `Adaptive`
+
+**Testing**:
+- [ ] Enter room → lights turn on (via separate occupancy automation)
+- [ ] Press config button → cycles through 4 modes
+- [ ] Set to Theater mode, leave room → after 5 min, resets to Adaptive
+- [ ] Manual boost → leave room → manual control clears
+
+## Example 3: Bathroom (Simple)
+
+**Goal**: Always Adaptive, brightness boost only
+
+**Hardware**:
+- Inovelli Blue Dimmer: `bathroom_switch`
+- Lights: `light.bathroom_ceiling`, `light.bathroom_vanity`
+- Presence: `binary_sensor.bathroom_occupancy`
+
+**Package File** (`packages/adaptive_lighting_bathroom.yaml`):
+
+Copy from `adaptive_lighting_simple_template.yaml`
+- No modes (Adaptive only)
+- No weekend mode
+- Simple reset on presence end
+
+**Blueprint Automations**:
+
+1. **Button Actions ONLY**:
+   - Double-tap up: Boost brightness
+   - Triple-tap down: Night light
+   - Auto-reset: 10 minutes
+
+2. **Presence Mode Reset**:
+   - Reset manual control when empty 5 minutes
+   - No mode reset (no input_select)
+
+**Testing**:
+- [ ] Double-tap up → brightness boosts
+- [ ] Leave bathroom 5 min → manual control clears
+- [ ] Triple-tap down → night light mode
+- [ ] No config button action (not configured)
+
+## Entity ID Quick Reference
+
+### Finding Your Entities
+
+**Inovelli Switch Entities** (via Zigbee2MQTT):
+```
+event.{device_name}_action           # Button presses (event entity)
+number.{device_name}_led_color_when_on
+number.{device_name}_led_color_when_off
+number.{device_name}_led_intensity_when_on
+select.{device_name}_smart_bulb_mode
+select.{device_name}_button_delay
+```
+
+**Adaptive Lighting Entities**:
+```
+switch.adaptive_lighting_{name}
+switch.adaptive_lighting_sleep_mode_{name}
+switch.adaptive_lighting_adapt_brightness_{name}
+switch.adaptive_lighting_adapt_color_{name}
+```
+
+**Your Input Helpers**:
+```
+input_select.{room}_lighting_mode
+input_boolean.{room}_weekend_mode
+```
+
+## Common Customizations
+
+### Add a New Mode
+
+1. Edit package file, add mode to `input_select`:
+```yaml
+input_select:
+  bedroom_lighting_mode:
+    options:
+      - "Adaptive"
+      - "Reading"
+      - "NEW MODE HERE"  # Add this
+```
+
+2. Add color mapping to global package (or use existing color)
+
+3. Add mode application to automation:
+```yaml
+- conditions: "{{ mode == 'NEW MODE HERE' }}"
+  sequence:
+    - service: adaptive_lighting.change_switch_settings
+      data:
+        min_brightness: 50
+        max_brightness: 80
+        # ... settings
+```
+
+4. Reload YAML configuration
+
+### Change Auto-Reset Timeout
+
+Edit blueprint automation via UI:
+- Settings → Automations → [Your button action automation]
+- Click Edit
+- Adjust "Auto-Reset Timeout" slider
+- Save
+
+### Disable Weekend Mode
+
+Comment out weekend mode automations in package file:
+```yaml
+#  - id: bedroom_weekend_mode_auto_enable
+#    alias: "Bedroom: Enable Weekend Mode Friday/Saturday"
+#    # ... entire automation
+```
+
+Reload YAML configuration.
--- a/blueprints/automation/inovelli_button_actions.yaml
+++ b/blueprints/automation/inovelli_button_actions.yaml
@@ -0,0 +1,163 @@
+---
+# blueprints/automation/inovelli_button_actions.yaml
+#
+# Inovelli Button Actions for Adaptive Lighting
+#
+# Implements multi-tap actions:
+# - Double tap up: Brightness boost (+50% from current AL setting)
+# - Double tap down: Return to Adaptive Lighting control
+# - Triple tap up: Maximum brightness (100%, neutral white)
+# - Triple tap down: Night light mode (5%, warm red)
+#
+# Features:
+# - Auto-reset after configurable timeout
+# - Reads current AL settings for relative boost
+# - Works with any Inovelli Blue Dimmer via Zigbee2MQTT
+#
+# Requirements:
+# - Inovelli Blue Dimmer (VZM31-SN) with buttonDelay >= 500ms
+# - Adaptive Lighting switch for the room
+# - Light entities to control
+#
+# Reference: ADAPTIVE_LIGHTING_CONTROL_SYSTEM_DESIGN.md lines 308-421
+
+blueprint:
+  name: Inovelli Button Actions for Adaptive Lighting
+  description: Multi-tap brightness controls with adaptive lighting integration
+  domain: automation
+  input:
+    switch_action_event:
+      name: Switch Action Event
+      description: Event entity that reports button presses (event.xxx_action)
+      selector:
+        entity:
+          domain: event
+
+    adaptive_lighting_switch:
+      name: Adaptive Lighting Switch
+      description: The AL switch entity for this room
+      selector:
+        entity:
+          domain: switch
+          integration: adaptive_lighting
+
+    target_lights:
+      name: Target Lights
+      description: Light entities to control
+      selector:
+        target:
+          entity:
+            domain: light
+
+    auto_reset_minutes:
+      name: Auto-Reset Timeout (minutes)
+      description: Minutes before returning to AL after manual boost
+      default: 10
+      selector:
+        number:
+          min: 0
+          max: 120
+          step: 5
+          unit_of_measurement: minutes
+
+mode: restart
+max_exceeded: silent
+
+trigger:
+  - platform: state
+    entity_id: !input switch_action_event
+
+condition:
+  - condition: template
+    value_template: >-
+      {{
+        state_attr(trigger.entity_id, 'event_type') in
+        ['up_double', 'down_double', 'up_triple', 'down_triple']
+      }}
+
+action:
+  - variables:
+      action: "{{ state_attr(trigger.entity_id, 'event_type') }}"
+      al_switch: !input adaptive_lighting_switch
+      lights: !input target_lights
+      reset_minutes: !input auto_reset_minutes
+
+  - choose:
+      # ========================================================================
+      # DOUBLE TAP UP - Brightness Boost
+      # ========================================================================
+      - conditions: "{{ action == 'up_double' }}"
+        sequence:
+          - variables:
+              current_brightness: >-
+                {{ state_attr(al_switch, 'brightness_pct') | float(50) }}
+              boosted_brightness: "{{ [current_brightness + 50, 100] | min }}"
+              current_color_temp: >-
+                {{ state_attr(al_switch, 'color_temp_kelvin') | int(4000) }}
+              boosted_color_temp: >-
+                {{ [current_color_temp + 1000, 5500] | min }}
+
+          - service: light.turn_on
+            target: "{{ lights }}"
+            data:
+              brightness_pct: "{{ boosted_brightness }}"
+              color_temp_kelvin: "{{ boosted_color_temp }}"
+              transition: 1
+
+          # Auto-reset after timeout
+          - delay:
+              minutes: "{{ reset_minutes }}"
+          - service: adaptive_lighting.set_manual_control
+            data:
+              entity_id: "{{ al_switch }}"
+              manual_control: false
+
+      # ========================================================================
+      # DOUBLE TAP DOWN - Return to AL
+      # ========================================================================
+      - conditions: "{{ action == 'down_double' }}"
+        sequence:
+          - service: adaptive_lighting.set_manual_control
+            data:
+              entity_id: "{{ al_switch }}"
+              manual_control: false
+
+      # ========================================================================
+      # TRIPLE TAP UP - Max Brightness (Neutral White)
+      # ========================================================================
+      - conditions: "{{ action == 'up_triple' }}"
+        sequence:
+          - service: light.turn_on
+            target: "{{ lights }}"
+            data:
+              brightness_pct: 100
+              color_temp_kelvin: 4000
+              transition: 0.5
+
+          # Auto-reset after timeout
+          - delay:
+              minutes: "{{ reset_minutes }}"
+          - service: adaptive_lighting.set_manual_control
+            data:
+              entity_id: "{{ al_switch }}"
+              manual_control: false
+
+      # ========================================================================
+      # TRIPLE TAP DOWN - Night Light
+      # ========================================================================
+      - conditions: "{{ action == 'down_triple' }}"
+        sequence:
+          - service: light.turn_on
+            target: "{{ lights }}"
+            data:
+              brightness_pct: 5
+              rgb_color: [255, 50, 0]
+              transition: 1
+
+          # Auto-reset after timeout
+          - delay:
+              minutes: "{{ reset_minutes }}"
+          - service: adaptive_lighting.set_manual_control
+            data:
+              entity_id: "{{ al_switch }}"
+              manual_control: false
--- a/blueprints/automation/inovelli_mode_cycling.yaml
+++ b/blueprints/automation/inovelli_mode_cycling.yaml
@@ -8,7 +8,7 @@
 # Features:
 # - Cycles through available modes in input_select
 # - Updates LED color to match new mode (ROYGBIV scheme)
-# - Flashes LED to confirm mode change (3-second pulse)
+# - Flashes LED to confirm mode change (0.5-second pulse)
 #
 # Requirements:
 # - Inovelli Blue Dimmer (VZM31-SN) paired with Zigbee2MQTT
@@ -88,9 +88,9 @@ action:
    data:
      value: "{{ next_color }}"

-  # Flash LED to confirm mode change (3-second pulse)
+  # Flash LED to confirm mode change (0.5-second pulse)
  - service: mqtt.publish
    data:
      topic: "zigbee2mqtt/{{ zigbee2mqtt_device_name }}/set"
      payload: >-
-        {"led_effect": {"effect": "pulse", "color": {{ next_color }}, "level": 100, "duration": 3}}
+        {"led_effect": {"effect": "pulse", "color": {{ next_color }}, "level": 100, "duration": 0.5}}
--- a/blueprints/automation/presence_mode_reset.yaml
+++ b/blueprints/automation/presence_mode_reset.yaml
@@ -0,0 +1,116 @@
+---
+# blueprints/automation/presence_mode_reset.yaml
+#
+# Presence-Based Mode and Manual Control Reset
+#
+# Automatically resets lighting mode and clears manual control when room
+# becomes unoccupied for a configurable duration.
+#
+# Use Cases:
+# - Reset Theater mode to Adaptive when leaving living room
+# - Clear manual brightness boosts when bedroom becomes empty
+# - Return bathroom to normal AL after presence ends
+#
+# Requirements:
+# - Binary sensor(s) for occupancy/presence detection
+# - Adaptive Lighting switch (optional - for manual control reset)
+# - Mode input_select (optional - for mode reset)
+#
+# Reference: ADAPTIVE_LIGHTING_CONTROL_SYSTEM_DESIGN.md lines 437-451,
+#            709-719
+
+blueprint:
+  name: Presence-Based Mode and Manual Control Reset
+  description: >-
+    Reset lighting modes and AL manual control when room becomes empty
+  domain: automation
+  input:
+    occupancy_sensors:
+      name: Occupancy Sensors
+      description: Binary sensor(s) that detect room occupancy
+      selector:
+        entity:
+          domain: binary_sensor
+          device_class: occupancy
+          multiple: true
+
+    empty_delay:
+      name: Empty Delay
+      description: How long room must be empty before reset
+      default: 5
+      selector:
+        number:
+          min: 0
+          max: 60
+          step: 1
+          unit_of_measurement: minutes
+
+    adaptive_lighting_switch:
+      name: Adaptive Lighting Switch (Optional)
+      description: AL switch to reset manual control. Leave empty to skip.
+      default: {}
+      selector:
+        entity:
+          domain: switch
+          integration: adaptive_lighting
+
+    mode_input_select:
+      name: Mode Input Select (Optional)
+      description: Mode selector to reset to Adaptive. Leave empty to skip.
+      default: {}
+      selector:
+        entity:
+          domain: input_select
+
+    default_mode:
+      name: Default Mode
+      description: Mode to reset to when room becomes empty
+      default: "Adaptive"
+      selector:
+        text:
+
+mode: restart
+
+trigger:
+  - platform: state
+    entity_id: !input occupancy_sensors
+    to: 'off'
+    for:
+      minutes: !input empty_delay
+
+action:
+  - variables:
+      occupancy_sensors: !input occupancy_sensors
+      al_switch: !input adaptive_lighting_switch
+      mode_select: !input mode_input_select
+      default_mode: !input default_mode
+
+  # Ensure ALL sensors are off (room is truly empty)
+  - condition: template
+    value_template: >-
+      {{
+        expand(occupancy_sensors) |
+        selectattr('state', 'eq', 'on') |
+        list | count == 0
+      }}
+
+  # Reset manual control if AL switch provided
+  - if:
+      - condition: template
+        value_template: "{{ al_switch not in [none, {}, ''] }}"
+    then:
+      - service: adaptive_lighting.set_manual_control
+        data:
+          entity_id: "{{ al_switch }}"
+          manual_control: false
+
+  # Reset mode if input_select provided
+  - if:
+      - condition: template
+        value_template: "{{ mode_select not in [none, {}, ''] }}"
+    then:
+      - service: input_select.select_option
+        target:
+          entity_id: "{{ mode_select }}"
+        data:
+          option: "{{ default_mode }}"
--- a/examples/test_room_config.yaml
+++ b/examples/test_room_config.yaml
@@ -0,0 +1,66 @@
+---
+# examples/test_room_config.yaml
+#
+# Test configuration for validating the Adaptive Lighting Mode System
+# without real Inovelli hardware or Adaptive Lighting integration.
+#
+# This uses template sensors and manual input helpers to simulate the system.
+
+input_select:
+  test_room_lighting_mode:
+    name: "Test Room Lighting Mode"
+    options:
+      - "Adaptive"
+      - "Reading"
+      - "Sleep"
+    initial: "Adaptive"
+
+sensor:
+  - platform: template
+    sensors:
+      test_switch_action:
+        friendly_name: "Test Switch Action"
+        value_template: "{{ states('input_text.test_switch_action_sim') }}"
+
+input_text:
+  test_switch_action_sim:
+    name: "Simulate Switch Action"
+    initial: "none"
+
+input_number:
+  test_led_color:
+    name: "Test LED Color"
+    min: 0
+    max: 255
+    step: 1
+    initial: 170
+
+# Automation to test mode cycling logic
+automation:
+  - id: test_mode_cycling
+    alias: "Test: Mode Cycling"
+    trigger:
+      - platform: state
+        entity_id: input_text.test_switch_action_sim
+        to: "config_single"
+    variables:
+      mode_select: input_select.test_room_lighting_mode
+      current_mode: "{{ states(mode_select) }}"
+      available_modes: "{{ state_attr(mode_select, 'options') }}"
+      current_index: "{{ available_modes.index(current_mode) }}"
+      next_index: "{{ (current_index + 1) % (available_modes | length) }}"
+      next_mode: "{{ available_modes[next_index] }}"
+      mode_colors: >-
+        {{ states('input_text.adaptive_lighting_mode_colors') | from_json }}
+      next_color: "{{ mode_colors.get(next_mode, 170) }}"
+    action:
+      - service: input_select.select_option
+        target:
+          entity_id: input_select.test_room_lighting_mode
+        data:
+          option: "{{ next_mode }}"
+      - service: input_number.set_value
+        target:
+          entity_id: input_number.test_led_color
+        data:
+          value: "{{ next_color }}"
--- a/packages/adaptive_lighting_bedroom_template.yaml
+++ b/packages/adaptive_lighting_bedroom_template.yaml
@@ -0,0 +1,235 @@
+# packages/adaptive_lighting_bedroom_template.yaml
+#
+# Adaptive Lighting Mode System - Bedroom Template
+#
+# CUSTOMIZATION INSTRUCTIONS:
+# 1. Copy this file to a new file named after your room (e.g., adaptive_lighting_master_bedroom.yaml)
+# 2. Search and replace "bedroom" with your room name throughout
+# 3. Update entity IDs to match your actual devices
+# 4. Adjust available modes in input_select as desired
+# 5. Customize mode settings in the automation
+# 6. Place in config/packages/ directory
+#
+# Prerequisites:
+# - packages/adaptive_lighting_global.yaml loaded
+# - Adaptive Lighting integration installed
+# - Adaptive Lighting switch created for this room
+# - Inovelli Blue Dimmer paired with Zigbee2MQTT in Smart Bulb Mode
+#
+# Reference: ADAPTIVE_LIGHTING_CONTROL_SYSTEM_DESIGN.md lines 1589-1672
+
+# =============================================================================
+# INPUT HELPERS
+# =============================================================================
+
+input_select:
+  bedroom_lighting_mode:
+    name: "Bedroom Lighting Mode"
+    options:
+      - "Adaptive"       # Standard AL following sun
+      - "Reading"        # Bright, cool white
+      - "Relaxing"       # Dim, warm white
+      - "Sleep"          # Very dim, red/amber
+      - "Manual Override" # Full user control, AL paused
+    initial: "Adaptive"
+    icon: mdi:lightbulb-multiple
+
+input_boolean:
+  bedroom_weekend_mode:
+    name: "Bedroom Weekend Mode"
+    icon: mdi:sleep
+    initial: off
+
+# =============================================================================
+# AUTOMATIONS
+# =============================================================================
+
+automation:
+  # ---------------------------------------------------------------------------
+  # Mode Application
+  # ---------------------------------------------------------------------------
+  # When mode changes, apply appropriate Adaptive Lighting settings
+  # Reference: ADAPTIVE_LIGHTING_CONTROL_SYSTEM_DESIGN.md lines 192-306
+  # ---------------------------------------------------------------------------
+  - id: bedroom_apply_lighting_mode
+    alias: "Bedroom: Apply Lighting Mode Settings"
+    description: "Apply AL settings based on selected lighting mode"
+    mode: restart
+    trigger:
+      - platform: state
+        entity_id: input_select.bedroom_lighting_mode
+      - platform: homeassistant
+        event: start
+    variables:
+      mode: "{{ states('input_select.bedroom_lighting_mode') }}"
+      switch_entity: "switch.adaptive_lighting_bedroom"  # UPDATE THIS
+      mode_colors: "{{ states('input_text.adaptive_lighting_mode_colors') | from_json }}"
+    action:
+      - choose:
+          # Adaptive Mode - Standard AL following sun
+          - conditions:
+              - condition: template
+                value_template: "{{ mode == 'Adaptive' }}"
+            sequence:
+              - service: adaptive_lighting.set_manual_control
+                data:
+                  entity_id: "{{ switch_entity }}"
+                  manual_control: false
+              - service: adaptive_lighting.change_switch_settings
+                target:
+                  entity_id: "{{ switch_entity }}"
+                data:
+                  use_defaults: configuration
+
+          # Reading Mode - Bright cool white
+          # Option 1: Read from centralized settings (recommended for maintainability)
+          - conditions:
+              - condition: template
+                value_template: "{{ mode == 'Reading' }}"
+            sequence:
+              - variables:
+                  settings: "{{ states('input_text.adaptive_lighting_settings_reading') | from_json }}"
+              - service: adaptive_lighting.set_manual_control
+                data:
+                  entity_id: "{{ switch_entity }}"
+                  manual_control: false
+              - service: adaptive_lighting.change_switch_settings
+                target:
+                  entity_id: "{{ switch_entity }}"
+                data: "{{ settings | combine({'use_defaults': 'current'}) }}"
+
+          # Alternative: Hardcode values directly (simpler but less maintainable)
+          # - conditions:
+          #     - condition: template
+          #       value_template: "{{ mode == 'Reading' }}"
+          #   sequence:
+          #     - service: adaptive_lighting.change_switch_settings
+          #       data:
+          #         min_brightness: 80
+          #         max_brightness: 100
+          #         min_color_temp: 4500
+          #         max_color_temp: 5500
+          #         transition: 2
+          #         use_defaults: current
+
+          # Relaxing Mode - Dim warm white
+          - conditions:
+              - condition: template
+                value_template: "{{ mode == 'Relaxing' }}"
+            sequence:
+              - variables:
+                  settings: "{{ states('input_text.adaptive_lighting_settings_relaxing') | from_json }}"
+              - service: adaptive_lighting.set_manual_control
+                data:
+                  entity_id: "{{ switch_entity }}"
+                  manual_control: false
+              - service: adaptive_lighting.change_switch_settings
+                target:
+                  entity_id: "{{ switch_entity }}"
+                data: "{{ settings | combine({'use_defaults': 'current'}) }}"
+
+          # Sleep Mode - Very dim red/amber
+          - conditions:
+              - condition: template
+                value_template: "{{ mode == 'Sleep' }}"
+            sequence:
+              - variables:
+                  settings: "{{ states('input_text.adaptive_lighting_settings_sleep') | from_json }}"
+              - service: adaptive_lighting.set_manual_control
+                data:
+                  entity_id: "{{ switch_entity }}"
+                  manual_control: false
+              - service: adaptive_lighting.change_switch_settings
+                target:
+                  entity_id: "{{ switch_entity }}"
+                data: "{{ settings | combine({'use_defaults': 'current'}) }}"
+
+          # Manual Override - Pause AL completely
+          - conditions:
+              - condition: template
+                value_template: "{{ mode == 'Manual Override' }}"
+            sequence:
+              - service: adaptive_lighting.set_manual_control
+                data:
+                  entity_id: "{{ switch_entity }}"
+                  manual_control: true
+
+      # Update LED color on Inovelli switch to match mode
+      # NOTE: Update entity_id to match your switch
+      - service: number.set_value
+        target:
+          entity_id: number.bedroom_switch_led_color_when_on  # UPDATE THIS
+        data:
+          value: "{{ mode_colors.get(mode, 170) }}"
+
+  # ---------------------------------------------------------------------------
+  # Weekend Mode - Auto Enable/Disable
+  # ---------------------------------------------------------------------------
+  # Reference: ADAPTIVE_LIGHTING_CONTROL_SYSTEM_DESIGN.md lines 894-926
+  # ---------------------------------------------------------------------------
+  - id: bedroom_weekend_mode_auto_enable
+    alias: "Bedroom: Enable Weekend Mode Friday/Saturday"
+    trigger:
+      - platform: time
+        at: "22:00:00"
+    condition:
+      - condition: time
+        weekday: ["fri", "sat"]
+    action:
+      - service: input_boolean.turn_on
+        target:
+          entity_id: input_boolean.bedroom_weekend_mode
+
+  - id: bedroom_weekend_mode_auto_disable
+    alias: "Bedroom: Disable Weekend Mode Sunday-Thursday"
+    trigger:
+      - platform: time
+        at: "22:00:00"
+    condition:
+      - condition: time
+        weekday: ["sun", "mon", "tue", "wed", "thu"]
+    action:
+      - service: input_boolean.turn_off
+        target:
+          entity_id: input_boolean.bedroom_weekend_mode
+
+  # ---------------------------------------------------------------------------
+  # Weekend Mode - Apply AL Adjustments
+  # ---------------------------------------------------------------------------
+  # Reference: ADAPTIVE_LIGHTING_CONTROL_SYSTEM_DESIGN.md lines 928-961
+  # ---------------------------------------------------------------------------
+  - id: bedroom_weekend_mode_apply
+    alias: "Bedroom: Apply Weekend Mode AL Adjustments"
+    trigger:
+      - platform: state
+        entity_id: input_boolean.bedroom_weekend_mode
+      - platform: homeassistant
+        event: start
+    variables:
+      weekend_mode: "{{ is_state('input_boolean.bedroom_weekend_mode', 'on') }}"
+      switch_entity: "switch.adaptive_lighting_bedroom"  # UPDATE THIS
+    action:
+      - choose:
+          - conditions:
+              - condition: template
+                value_template: "{{ weekend_mode }}"
+            sequence:
+              # Weekend settings: Later sunrise, lower max brightness
+              - service: adaptive_lighting.change_switch_settings
+                target:
+                  entity_id: "{{ switch_entity }}"
+                data:
+                  sunrise_time: "10:00:00"
+                  sunset_time: "01:00:00"
+                  max_brightness: 60
+                  use_defaults: current
+          - conditions:
+              - condition: template
+                value_template: "{{ not weekend_mode }}"
+            sequence:
+              # Weekday settings: Reset to defaults
+              - service: adaptive_lighting.change_switch_settings
+                target:
+                  entity_id: "{{ switch_entity }}"
+                data:
+                  use_defaults: configuration
--- a/packages/adaptive_lighting_living_room_template.yaml
+++ b/packages/adaptive_lighting_living_room_template.yaml
@@ -0,0 +1,122 @@
+# packages/adaptive_lighting_living_room_template.yaml
+#
+# Adaptive Lighting Mode System - Living Room Template
+#
+# CUSTOMIZATION INSTRUCTIONS:
+# 1. Copy this file and rename for your room
+# 2. Search and replace "living_room" with your room name
+# 3. Update entity IDs to match your devices
+# 4. Adjust modes as desired
+# 5. Place in config/packages/ directory
+#
+# Reference: ADAPTIVE_LIGHTING_CONTROL_SYSTEM_DESIGN.md lines 1512-1587
+
+# =============================================================================
+# INPUT HELPERS
+# =============================================================================
+
+input_select:
+  living_room_lighting_mode:
+    name: "Living Room Lighting Mode"
+    options:
+      - "Adaptive"
+      - "Theater"
+      - "Party"
+      - "Reading"
+    initial: "Adaptive"
+    icon: mdi:lightbulb-multiple
+
+# =============================================================================
+# AUTOMATIONS
+# =============================================================================
+
+automation:
+  # ---------------------------------------------------------------------------
+  # Mode Application
+  # ---------------------------------------------------------------------------
+  - id: living_room_apply_lighting_mode
+    alias: "Living Room: Apply Lighting Mode Settings"
+    mode: restart
+    trigger:
+      - platform: state
+        entity_id: input_select.living_room_lighting_mode
+      - platform: homeassistant
+        event: start
+    variables:
+      mode: "{{ states('input_select.living_room_lighting_mode') }}"
+      switch_entity: "switch.adaptive_lighting_living_room"  # UPDATE THIS
+      mode_colors: "{{ states('input_text.adaptive_lighting_mode_colors') | from_json }}"
+    action:
+      - choose:
+          - conditions: "{{ mode == 'Adaptive' }}"
+            sequence:
+              - service: adaptive_lighting.set_manual_control
+                data:
+                  entity_id: "{{ switch_entity }}"
+                  manual_control: false
+              - service: adaptive_lighting.change_switch_settings
+                target:
+                  entity_id: "{{ switch_entity }}"
+                data:
+                  use_defaults: configuration
+
+          - conditions: "{{ mode == 'Theater' }}"
+            sequence:
+              - variables:
+                  settings: "{{ states('input_text.adaptive_lighting_settings_theater') | from_json }}"
+              - service: adaptive_lighting.set_manual_control
+                data:
+                  entity_id: "{{ switch_entity }}"
+                  manual_control: false
+              - service: adaptive_lighting.change_switch_settings
+                target:
+                  entity_id: "{{ switch_entity }}"
+                data: "{{ settings | combine({'use_defaults': 'current'}) }}"
+
+          - conditions: "{{ mode == 'Party' }}"
+            sequence:
+              - variables:
+                  settings: "{{ states('input_text.adaptive_lighting_settings_party') | from_json }}"
+              - service: adaptive_lighting.set_manual_control
+                data:
+                  entity_id: "{{ switch_entity }}"
+                  manual_control: false
+              - service: adaptive_lighting.change_switch_settings
+                target:
+                  entity_id: "{{ switch_entity }}"
+                data: "{{ settings | combine({'use_defaults': 'current'}) }}"
+
+          - conditions: "{{ mode == 'Reading' }}"
+            sequence:
+              - variables:
+                  settings: "{{ states('input_text.adaptive_lighting_settings_reading') | from_json }}"
+              - service: adaptive_lighting.set_manual_control
+                data:
+                  entity_id: "{{ switch_entity }}"
+                  manual_control: false
+              - service: adaptive_lighting.change_switch_settings
+                target:
+                  entity_id: "{{ switch_entity }}"
+                data: "{{ settings | combine({'use_defaults': 'current'}) }}"
+
+      - service: number.set_value
+        target:
+          entity_id: number.living_room_switch_led_color_when_on  # UPDATE THIS
+        data:
+          value: "{{ mode_colors.get(mode, 170) }}"
+
+  # ---------------------------------------------------------------------------
+  # Auto-Reset Mode to Adaptive When Lights Turn Off
+  # ---------------------------------------------------------------------------
+  - id: living_room_reset_mode_on_off
+    alias: "Living Room: Reset Mode to Adaptive When Off"
+    trigger:
+      - platform: state
+        entity_id: light.living_room_lights  # UPDATE THIS
+        to: 'off'
+    action:
+      - service: input_select.select_option
+        target:
+          entity_id: input_select.living_room_lighting_mode
+        data:
+          option: "Adaptive"
--- a/packages/adaptive_lighting_simple_template.yaml
+++ b/packages/adaptive_lighting_simple_template.yaml
@@ -0,0 +1,38 @@
+# packages/adaptive_lighting_simple_template.yaml
+#
+# Adaptive Lighting Mode System - Simple Template
+#
+# For rooms that only need basic Adaptive Lighting without mode switching.
+# Example: Bathrooms, closets, hallways
+#
+# CUSTOMIZATION INSTRUCTIONS:
+# 1. Copy and rename for your room
+# 2. Replace "simple_room" with your room name
+# 3. Update entity IDs
+# 4. This template has NO mode cycling (Adaptive only)
+#
+# For button actions like brightness boost, use the inovelli_button_actions blueprint
+
+# =============================================================================
+# CONFIGURATION
+# =============================================================================
+# No input_select needed - always in Adaptive mode
+
+# =============================================================================
+# AUTOMATIONS
+# =============================================================================
+
+automation:
+  # ---------------------------------------------------------------------------
+  # Ensure AL is Always Active
+  # ---------------------------------------------------------------------------
+  - id: simple_room_ensure_adaptive_lighting
+    alias: "Simple Room: Ensure Adaptive Lighting Active"
+    trigger:
+      - platform: homeassistant
+        event: start
+    action:
+      - service: adaptive_lighting.set_manual_control
+        data:
+          entity_id: switch.adaptive_lighting_simple_room  # UPDATE THIS
+          manual_control: false
--- a/scripts/validate_yaml.sh
+++ b/scripts/validate_yaml.sh
@@ -0,0 +1,36 @@
+#!/bin/bash
+# scripts/validate_yaml.sh
+#
+# Validates YAML syntax for all Adaptive Lighting system files
+
+set -e
+
+echo "Validating Adaptive Lighting Mode System YAML files..."
+echo "========================================================"
+
+# Check if yamllint is installed
+if ! command -v yamllint &> /dev/null; then
+    echo "ERROR: yamllint not found."
+    echo "Install with: pip install yamllint"
+    echo "Or run with: nix run nixpkgs#yamllint -- <files>"
+    exit 1
+fi
+
+# Validate packages
+echo ""
+echo "Validating packages..."
+for file in packages/*.yaml; do
+    echo "  - $file"
+    yamllint -d '{extends: default, rules: {line-length: {max: 120}}}' "$file"
+done
+
+# Validate blueprints
+echo ""
+echo "Validating blueprints..."
+for file in blueprints/automation/*.yaml; do
+    echo "  - $file"
+    yamllint -d '{extends: default, rules: {line-length: {max: 120}}}' "$file"
+done
+
+echo ""
+echo "✓ All YAML files are valid!"
Author	SHA1	Message	Date
John Ogle	4b285770d2	Fix presence_mode_reset blueprint variable scoping issue Move condition check into action sequence after variables are defined. Previously, the condition tried to use 'occupancy_sensors' before it was defined, causing UndefinedError during automation execution.	2025-12-21 15:35:23 -08:00
John Ogle	a5a6b9d4b6	Add comprehensive documentation and testing tools - Update README with complete setup guide and all blueprint URLs - Add PACKAGE_SETUP_GUIDE with step-by-step setup instructions - Add ROOM_CONFIGURATION_GUIDE with bedroom, living room, and bathroom examples - Add HARDWARE_TESTING_CHECKLIST for validating with real Inovelli switches - Add CHANGELOG documenting v1.0.0 release - Add validation script for automated YAML testing - Add test configuration example for testing without hardware	2025-12-21 14:30:53 -08:00
John Ogle	5eec41a43c	Add button actions and presence reset blueprints - Add inovelli_button_actions blueprint for multi-tap controls - Double-tap up: brightness boost (+50%) - Double-tap down: return to adaptive lighting - Triple-tap up: max brightness (100%, 4000K) - Triple-tap down: night light (5%, warm red) - Configurable auto-reset timeout - Add presence_mode_reset blueprint for occupancy integration - Auto-reset manual control when room empty - Optional mode reset to default - Configurable empty delay - Multiple occupancy sensor support - Fix entity name in living room template (light.living_room_lights)	2025-12-21 14:30:41 -08:00
John Ogle	602a2b7e78	Phase 2	2025-12-20 15:36:06 -08:00
John Ogle	27d322f09f	Update feedback flash to 0.5 seconds	2025-12-20 15:33:41 -08:00