Fixed some issues with waiter gates

Author: Tiwas

.claude/settings.local.json

@@ -7,7 +7,8 @@
       "Bash(xargs ls:*)",
       "Bash(git add:*)",
       "Bash(git commit:*)",
-      "Bash(git push:*)"
+      "Bash(git push:*)",
+      "Bash(homey app build:*)"
     ]
   }
 }

.gitignore

@@ -32,4 +32,7 @@ codebase-manifest.*
 .codebaseignore
 *.rar
 *.tar.gz
-*.old
+*.old
+
+# Project Documentation (AI-generated, kept local)
+PROJECT_DOCUMENTATION.md

no.tiwas.booleantoolbox/.homeychangelog.json

@@ -34,5 +34,8 @@
   },
   "1.8.1": {
     "en": "Bug fix + better hints"
+  },
+  "1.8.2": {
+    "en": "Fixed some errors with IDs in waiter gates."
   }
 }

no.tiwas.booleantoolbox/.homeycompose/flow/actions/control_waiter.json

@@ -43,7 +43,7 @@
   },
   "args": [
     {
-      "type": "text",
+      "type": "autocomplete",
       "name": "waiter_id",
       "title": {
         "en": "Waiter ID",
@@ -60,18 +60,18 @@
         "ru": "ID Waiter"
       },
       "placeholder": {
-        "en": "my-waiter",
-        "no": "min-waiter",
-        "da": "min-waiter",
-        "de": "mein-waiter",
-        "es": "mi-waiter",
-        "fr": "mon-waiter",
-        "it": "mio-waiter",
-        "nl": "mijn-waiter",
-        "sv": "min-waiter",
-        "pl": "moj-waiter",
-        "fi": "oma-waiter",
-        "ru": "мой-waiter"
+        "en": "Select waiter ID",
+        "no": "Velg waiter ID",
+        "da": "Vælg waiter ID",
+        "de": "Waiter ID auswählen",
+        "es": "Seleccionar ID del Waiter",
+        "fr": "Sélectionner ID du Waiter",
+        "it": "Seleziona ID Waiter",
+        "nl": "Selecteer Waiter ID",
+        "sv": "Välj Waiter ID",
+        "pl": "Wybierz ID Waiter",
+        "fi": "Valitse Waiter ID",
+        "ru": "Выбрать ID Waiter"
       }
     },
     {

no.tiwas.booleantoolbox/.homeycompose/flow/conditions/wait_until_becomes_true.json

@@ -28,18 +28,18 @@
     "ru": "Ждать пока [[device]] [[capability]] станет [[target_value]] (timeout: [[timeout_value]] [[timeout_unit]], id: [[waiter_id]])"
   },
   "hint": {
-    "en": "This card waits until a device capability reaches a specific value. If the value is already correct, it proceeds immediately (YES). If timeout expires before the value matches, it takes the NO path. Leave Waiter ID empty for auto-generation.",
-    "no": "Dette kortet venter til en enhets capability når en bestemt verdi. Hvis verdien allerede er riktig, fortsetter det umiddelbart (JA). Hvis timeout utløper før verdien matcher, tar det NEI-stien. La Waiter ID stå tom for auto-generering.",
-    "da": "Dette kort venter indtil en enheds capability når en bestemt værdi. Hvis værdien allerede er korrekt, fortsætter det straks (JA). Hvis timeout udløber før værdien matcher, tager det NEJ-vejen. Lad Waiter ID være tom for auto-generering.",
-    "de": "Diese Karte wartet bis eine Geräte-Capability einen bestimmten Wert erreicht. Wenn der Wert bereits korrekt ist, wird sofort fortgesetzt (JA). Wenn Timeout abläuft bevor der Wert übereinstimmt, wird der NEIN-Pfad genommen. Lassen Sie Waiter ID leer für Auto-Generierung.",
-    "es": "Esta tarjeta espera hasta que una capability del dispositivo alcance un valor específico. Si el valor ya es correcto, procede inmediatamente (SÍ). Si el timeout expira antes de que el valor coincida, toma el camino NO. Deje el ID del Waiter vacío para auto-generación.",
-    "fr": "Cette carte attend qu'une capability d'appareil atteigne une valeur spécifique. Si la valeur est déjà correcte, elle continue immédiatement (OUI). Si le timeout expire avant que la valeur corresponde, elle prend le chemin NON. Laissez l'ID Waiter vide pour la génération automatique.",
-    "it": "Questa scheda attende fino a quando una capability del dispositivo raggiunge un valore specifico. Se il valore è già corretto, procede immediatamente (SÌ). Se il timeout scade prima che il valore corrisponda, prende il percorso NO. Lascia l'ID Waiter vuoto per la generazione automatica.",
-    "nl": "Deze kaart wacht tot een apparaat capability een specifieke waarde bereikt. Als de waarde al correct is, gaat het onmiddellijk verder (JA). Als timeout verloopt voordat de waarde overeenkomt, neemt het het NEE-pad. Laat Waiter ID leeg voor auto-generatie.",
-    "sv": "Detta kort väntar tills en enhets capability når ett specifikt värde. Om värdet redan är korrekt, fortsätter det omedelbart (JA). Om timeout löper ut innan värdet matchar, tar det NEJ-vägen. Lämna Waiter ID tomt för auto-generering.",
-    "pl": "Ta karta czeka aż capability urządzenia osiągnie określoną wartość. Jeśli wartość jest już prawidłowa, kontynuuje natychmiast (TAK). Jeśli timeout wygaśnie zanim wartość będzie się zgadzać, przechodzi ścieżką NIE. Pozostaw ID Waiter puste dla auto-generacji.",
-    "fi": "Tämä kortti odottaa kunnes laitteen capability saavuttaa tietyn arvon. Jos arvo on jo oikea, se jatkaa välittömästi (KYLLÄ). Jos timeout vanhenee ennen kuin arvo täsmää, se ottaa EI-polun. Jätä Waiter ID tyhjäksi automaattista luontia varten.",
-    "ru": "Эта карта ждет пока capability устройства достигнет определенного значения. Если значение уже правильное, она продолжает немедленно (ДА). Если timeout истекает до того как значение совпадет, она выбирает путь НЕТ. Оставьте ID Waiter пустым для автогенерации."
+    "en": "Waits until a device capability reaches a specific value. YES if value matches (or already correct), NO if timeout expires. A unique Waiter ID is auto-generated, or select an existing one to reuse.",
+    "no": "Venter til en enhets capability når en bestemt verdi. JA hvis verdien matcher (eller allerede er riktig), NEI hvis timeout utløper. En unik Waiter ID genereres automatisk, eller velg en eksisterende for å gjenbruke.",
+    "da": "Venter indtil en enheds capability når en bestemt værdi. JA hvis værdien matcher (eller allerede er korrekt), NEJ hvis timeout udløber. Et unikt Waiter ID genereres automatisk, eller vælg et eksisterende for at genbruge.",
+    "de": "Wartet bis eine Geräte-Capability einen bestimmten Wert erreicht. JA wenn Wert übereinstimmt (oder bereits korrekt), NEIN wenn Timeout abläuft. Eine eindeutige Waiter ID wird automatisch generiert, oder wählen Sie eine vorhandene zur Wiederverwendung.",
+    "es": "Espera hasta que una capability del dispositivo alcance un valor específico. SÍ si el valor coincide (o ya es correcto), NO si el timeout expira. Se genera automáticamente un ID de Waiter único, o seleccione uno existente para reutilizar.",
+    "fr": "Attend qu'une capability d'appareil atteigne une valeur spécifique. OUI si la valeur correspond (ou est déjà correcte), NON si le timeout expire. Un ID Waiter unique est généré automatiquement, ou sélectionnez-en un existant pour réutiliser.",
+    "it": "Attende fino a quando una capability del dispositivo raggiunge un valore specifico. SÌ se il valore corrisponde (o è già corretto), NO se il timeout scade. Un ID Waiter unico viene generato automaticamente, oppure selezionane uno esistente per riutilizzare.",
+    "nl": "Wacht tot een apparaat capability een specifieke waarde bereikt. JA als waarde overeenkomt (of al correct is), NEE als timeout verloopt. Een unieke Waiter ID wordt automatisch gegenereerd, of selecteer een bestaande om te hergebruiken.",
+    "sv": "Väntar tills en enhets capability når ett specifikt värde. JA om värdet matchar (eller redan är korrekt), NEJ om timeout löper ut. Ett unikt Waiter ID genereras automatiskt, eller välj ett befintligt för att återanvända.",
+    "pl": "Czeka aż capability urządzenia osiągnie określoną wartość. TAK jeśli wartość pasuje (lub już jest prawidłowa), NIE jeśli timeout wygaśnie. Unikalny ID Waiter jest generowany automatycznie, lub wybierz istniejący do ponownego użycia.",
+    "fi": "Odottaa kunnes laitteen capability saavuttaa tietyn arvon. KYLLÄ jos arvo täsmää (tai on jo oikea), EI jos timeout vanhenee. Uniikki Waiter ID luodaan automaattisesti, tai valitse olemassa oleva uudelleenkäyttöön.",
+    "ru": "Ждет пока capability устройства достигнет определенного значения. ДА если значение совпадает (или уже правильное), НЕТ если timeout истекает. Уникальный ID Waiter генерируется автоматически, или выберите существующий для повторного использования."
   },
   "args": [
     {
@@ -244,35 +244,35 @@
       ]
     },
     {
-      "type": "text",
+      "type": "autocomplete",
       "name": "waiter_id",
       "title": {
-        "en": "Waiter ID (optional)",
-        "no": "Waiter ID (valgfri)",
-        "da": "Waiter ID (valgfri)",
-        "de": "Waiter ID (optional)",
-        "es": "ID del Waiter (opcional)",
-        "fr": "ID du Waiter (optionnel)",
-        "it": "ID Waiter (opzionale)",
-        "nl": "Waiter ID (optioneel)",
-        "sv": "Waiter ID (valfritt)",
-        "pl": "ID Waiter (opcjonalne)",
-        "fi": "Waiter ID (valinnainen)",
-        "ru": "ID Waiter (необязательно)"
+        "en": "Waiter ID",
+        "no": "Waiter ID",
+        "da": "Waiter ID",
+        "de": "Waiter ID",
+        "es": "ID del Waiter",
+        "fr": "ID du Waiter",
+        "it": "ID Waiter",
+        "nl": "Waiter ID",
+        "sv": "Waiter ID",
+        "pl": "ID Waiter",
+        "fi": "Waiter ID",
+        "ru": "ID Waiter"
       },
       "placeholder": {
-        "en": "Leave empty for auto-generation",
-        "no": "La stå tom for auto-generering",
-        "da": "Lad stå tom for auto-generering",
-        "de": "Leer lassen für Auto-Generierung",
-        "es": "Dejar vacío para auto-generación",
-        "fr": "Laisser vide pour génération automatique",
-        "it": "Lascia vuoto per generazione automatica",
-        "nl": "Leeg laten voor auto-generatie",
-        "sv": "Lämna tomt för auto-generering",
-        "pl": "Pozostaw puste dla auto-generacji",
-        "fi": "Jätä tyhjäksi automaattista luontia varten",
-        "ru": "Оставьте пустым для автогенерации"
+        "en": "Select or type custom ID",
+        "no": "Velg eller skriv egen ID",
+        "da": "Vælg eller skriv brugerdefineret ID",
+        "de": "Auswählen oder eigene ID eingeben",
+        "es": "Seleccionar o escribir ID personalizado",
+        "fr": "Sélectionner ou saisir un ID personnalisé",
+        "it": "Seleziona o digita ID personalizzato",
+        "nl": "Selecteer of typ aangepaste ID",
+        "sv": "Välj eller skriv anpassat ID",
+        "pl": "Wybierz lub wpisz własne ID",
+        "fi": "Valitse tai kirjoita mukautettu ID",
+        "ru": "Выберите или введите пользовательский ID"
       }
     }
   ]

no.tiwas.booleantoolbox/DOCUMENTATION_PROMPT_TEMPLATE.md

@@ -0,0 +1,132 @@
+# Documentation Prompt Template
+
+## Purpose
+This prompt template is designed to be reused across projects to establish consistent documentation standards and AI assistant behavior guidelines.
+
+## The Prompt
+
+---
+
+I need to get this project documented. Therefore, I want you to go through all code files and:
+
+1. Explain each function and place this as a comment before the function itself
+
+2. Together with the explanation, list all functions that directly and indirectly call this function
+
+3. Create a separate file that explains the project as a whole, what each file in the project does. There must also be a dependency map for the project.
+
+4. Add instructions to robots.md (or CLAUDE.md / CONTRIBUTING.md) for keeping this updated for each session.
+
+5. All comments and documentation must be in English.
+
+6. Add to robots.md that all code must compile before being presented as a solution.
+
+7. Add to robots.md that existing code must not be modified.
+
+8. Add to robots.md that breaking changes must ALWAYS be avoided, and where not possible, must be thoroughly discussed with the user before being made - even when permission to write freely without code approval has been given.
+
+9. Save this prompt for later use in a suitable file for future use in other projects.
+
+---
+
+## Expected Output
+
+When this prompt is executed, the AI should:
+
+### 1. Function Documentation
+Add JSDoc-style comments before each function including:
+- Description of what the function does
+- @param tags for parameters
+- @returns tag for return value
+- "Called by:" section listing all callers
+- "Calls:" section listing all functions called
+
+Example:
+```javascript
+/**
+ * Calculates the total price including tax.
+ *
+ * Takes a base price and applies the configured tax rate to calculate
+ * the final price the customer will pay.
+ *
+ * @param {number} basePrice - The price before tax
+ * @param {number} taxRate - The tax rate as a decimal (e.g., 0.25 for 25%)
+ * @returns {number} The total price including tax
+ *
+ * Called by:
+ *   - checkout() in cart.js - When finalizing an order
+ *   - displayCart() in display.js - When showing cart totals
+ *
+ * Calls:
+ *   - roundToTwoDecimals() in utils.js - For currency formatting
+ */
+function calculateTotalPrice(basePrice, taxRate) {
+  // implementation
+}
+```
+
+### 2. Project Documentation File
+Create PROJECT_DOCUMENTATION.md containing:
+- High-level architecture overview
+- ASCII diagram of component relationships
+- File structure with descriptions
+- Detailed module descriptions
+- Dependency map (what imports what)
+- Data structures/schemas
+- Communication flows (for extensions/APIs)
+- Build process
+- Security considerations
+- Critical findings shall be reported to the user
+- This file shall be included in the .gitignore file
+- Orphaned functions shall be reported to the user
+- Ensure documentation is not pushed to git
+
+### 3. AI Instructions File
+Update robots.md (or create CLAUDE.md) with:
+- Core principles (complete code, no breaking changes, etc.)
+- Documentation maintenance instructions
+- Code quality guidelines
+- Session workflow (start/end procedures)
+
+## Files Created
+
+When this template is executed on a project, the following files are created:
+
+1. **robots.md** (or CLAUDE.md)
+   - AI assistant behavioral guidelines
+   - Documentation maintenance procedures
+   - Code quality requirements
+
+2. **PROJECT_DOCUMENTATION.md**
+   - Architecture overview
+   - File descriptions
+   - Dependency map
+   - Data structures
+
+3. **DOCUMENTATION_PROMPT_TEMPLATE.md** (this file)
+   - Reusable prompt for other projects
+
+4. Updated **.gitignore**
+   - Excludes PROJECT_DOCUMENTATION.md from version control
+
+## Usage
+
+To use this template on a new project:
+
+1. Copy this file to your new project
+2. Open a conversation with your AI assistant
+3. Paste the prompt from "The Prompt" section above
+4. The AI will analyze your codebase and create the documentation
+
+## Customization
+
+Feel free to modify this template to suit your specific needs:
+- Add project-specific guidelines to robots.md
+- Adjust the documentation format
+- Add additional sections to PROJECT_DOCUMENTATION.md
+- Modify the function documentation style
+
+---
+
+*Template version: 1.0*
+*Created: December 2024*

no.tiwas.booleantoolbox/README.txt

@@ -24,55 +24,8 @@ State Capture Device
 State Device
   Pre-define device states and apply them via flows. Configure states at setup time rather than capturing them dynamically.
 
-== FLOW CARDS ==
-
-Actions:
-  Logic Unit/Device:
-    - Evaluate formula / Evaluate all formulas
-    - Set input value (single or all via JSON)
-    - Clear error state
-    - Validate configuration
-
-  State Capture Device:
-    - Capture state (save to named slot)
-    - Apply captured state
-    - Delete captured state
-    - Push state (to stack)
-    - Pop state (from stack and apply)
-    - Peek and apply (view top without removing)
-    - Clear stack
-    - Export named states (JSON backup)
-    - Import named states (restore from JSON)
-
-  State Device:
-    - Apply state
-
-  Utilities:
-    - Wait (delay execution)
-    - Control waiter (pause/resume gates)
-    - Evaluate expression (inline logic)
-
-Conditions:
-  - Formula result is true/false
-  - Formula has timed out
-  - Device has error
-  - Captured state exists
-  - Stack is empty / Stack depth is X
-  - Wait until becomes true
-
-Triggers:
-  - Formula changed to true/false
-  - Formula timed out
-  - State changed
-  - State captured/applied
-  - Configuration alarm changed
-  - Error occurred
-
 == DOCUMENTATION ==
 
-Full documentation available at: https://tiwas.github.io/SmartComponentsToolkit/
+Full documentation available on GitHub
 
-== SUPPORT ==
 
-Community forum: https://community.homey.app/t/app-boolean-toolbox-create-advanced-logic-with-simple-formulas/143906
-Issues: https://github.com/Tiwas/SmartComponentsToolkit/issues