updating and further development ...

.eslintrc.json

@@ -0,0 +1,40 @@
+{
+    "root": true,
+    "env": {
+        "es6": true,
+        "node": true,
+        "mocha": true
+    },
+    "extends": [
+        "eslint:recommended"
+    ],
+    "plugins": [],
+    "rules": {
+        "indent": [
+            "error",
+            4,
+            {
+                "SwitchCase": 1
+            }
+        ],
+        "no-console": "off",
+        "no-var": "error",
+        "no-trailing-spaces": "error",
+        "prefer-const": "error",
+        "quotes": [
+            "error",
+            "single",
+            {
+                "avoidEscape": true,
+                "allowTemplateLiterals": true
+            }
+        ],
+        "semi": [
+            "error",
+            "always"
+        ]
+    },
+    "parserOptions": {
+        "ecmaVersion": 2018
+    }
+}

.github/FUNDING.yml

@@ -0,0 +1,5 @@
+# These are supported funding model platforms
+
+github: Apollon77
+patreon: Apollon77
+custom: ['https://paypal.me/Apollon77']

.github/ISSUE_TEMPLATE/bug_report.md

@@ -0,0 +1,37 @@
+---
+name: Bug report
+about: Something is not working as it should
+title: ''
+labels: ''
+assignees: ''
+---
+
+**Check if the Bug maybe is with Amazon**  
+The adapter is using the same API as the Alexa mobile App. This means:
+* If you can not do this what you want with the App then the Adapter also can not do it!
+* Also if the App can do it please test if the same effect then the bug also happens with the App (e.g. a speak command do not work on a certain device ... can you do a speak via Alexa App? If not - Amazon problem!)
+
+**Describe the bug**  
+A clear and concise description of what the bug is. Especially describe what you verified using the Alexa App (see above).
+
+**To Reproduce**  
+Steps to reproduce the behavior:
+1. Go to '...'
+2. Click on '...'
+3. Scroll down to '....'
+4. See error
+
+**Expected behavior**  
+A clear and concise description of what you expected to happen.
+
+**Screenshots & Logfiles**  
+If applicable, add screenshots and logfiles to help explain your problem.
+
+**Versions:**  
+ - Adapter version: <adapter-version>
+ - JS-Controller version: <js-controller-version> <!-- determine this with `iobroker -v` on the console -->
+ - Node version: <node-version> <!-- determine this with `node -v` on the console -->
+ - Operating system: <os-name>
+
+**Additional context**  
+Add any other context about the problem here.

.github/ISSUE_TEMPLATE/feature_request.md

@@ -0,0 +1,24 @@
+---
+name: Feature request
+about: Suggest an idea for this project
+title: ''
+labels: ''
+assignees: ''
+
+---
+**Consider the Reality**  
+The adapter is using the same API as the Alexa mobile App. This means:
+
+If you can not do this what you want with the App then the Adapter also can not do it! Also a feature rewuest most likely will not be possible.
+
+**Is your feature request related to a problem? Please describe.**
+A clear and concise description of what the problem is. Ex. I'm always frustrated when [...]
+
+**Describe the solution you'd like**
+A clear and concise description of what you want to happen.
+
+**Describe alternatives you've considered**
+A clear and concise description of any alternative solutions or features you've considered.
+
+**Additional context**
+Add any other context or screenshots about the feature request here.

.github/auto-merge.yml

@@ -0,0 +1,17 @@
+# Configure here which dependency updates should be merged automatically.
+# The recommended configuration is the following:
+- match:
+      # Only merge patches for production dependencies
+      dependency_type: production
+      update_type: "semver:patch"
+- match:
+      # Except for security fixes, here we allow minor patches
+      dependency_type: production
+      update_type: "security:minor"
+- match:
+      # and development dependencies can have a minor update, too
+      dependency_type: development
+      update_type: "semver:minor"
+
+# The syntax is based on the legacy dependabot v1 automerged_updates syntax, see:
+# https://dependabot.com/docs/config-file/#automerged_updates

.github/copilot-instructions.md

@@ -0,0 +1,131 @@
+# ioBroker.alexa2 Adapter
+ioBroker.alexa2 is a Node.js adapter for ioBroker that provides remote control for Amazon Alexa devices (Amazon Echo). The adapter integrates with the ioBroker home automation platform and allows control of Alexa devices, smart home devices, routines, and more.
+
+Always reference these instructions first and fallback to search or bash commands only when you encounter unexpected information that does not match the info here.
+
+## Working Effectively
+
+### Bootstrap, Build, and Test the Repository:
+- `npm install` -- Install dependencies. Takes ~40 seconds. NEVER CANCEL.
+- `npm test` -- Run complete test suite. Takes ~55 seconds. NEVER CANCEL. Set timeout to 90+ seconds.
+- `npx eslint main.js lib/ test/ --ext .js` -- Lint main code files. Admin files have known translation issues.
+
+### Timing Expectations:
+- **NEVER CANCEL**: npm install takes 40 seconds. Wait for completion.
+- **NEVER CANCEL**: npm test takes 55 seconds total. Set timeout to 90+ seconds minimum.
+- **NEVER CANCEL**: The test includes full ioBroker js-controller setup which can take 30+ seconds just for initialization.
+
+### Manual Validation After Changes:
+- ALWAYS run `npm test` after making any code changes to ensure adapter functionality
+- ALWAYS run ESLint on modified files: `npx eslint <modified-files> --ext .js`
+- The adapter cannot be run standalone - it requires ioBroker infrastructure
+- Tests automatically validate adapter startup, configuration, and shutdown sequences
+- DO NOT attempt to run main.js directly - it requires ioBroker adapter-core framework
+
+## Project Structure and Navigation
+
+### Key Directories and Files:
+```
+/home/runner/work/ioBroker.alexa2/ioBroker.alexa2/
+├── main.js                 # Main adapter entry point (352KB, core logic)
+├── package.json           # Dependencies and npm scripts
+├── io-package.json        # ioBroker adapter configuration
+├── README.md              # Comprehensive adapter documentation
+├── lib/
+│   ├── smarthomedevices.js # Smart home device definitions and controllers
+│   └── tools.js           # Utility functions
+├── admin/                 # Web UI configuration files
+│   ├── index_m.html       # Material Design admin interface
+│   ├── words.js           # i18n translations (has known ESLint issues)
+│   └── icons/             # Device type icons
+├── test/
+│   ├── testAdapter.js     # Main adapter functionality tests
+│   ├── testPackageFiles.js # Package validation tests
+│   └── lib/setup.js       # Test infrastructure and js-controller setup
+└── .github/workflows/     # CI/CD pipeline configuration
+```
+
+### Important Code Areas:
+- **main.js**: Core adapter logic, Alexa API integration, device management
+- **lib/smarthomedevices.js**: Smart home device capability definitions for various device types
+- **admin/index_m.html**: Admin configuration interface for credentials and settings  
+- **test/lib/setup.js**: Complex test infrastructure that sets up js-controller environment
+
+## Validation Scenarios
+
+### Always Run These Validation Steps:
+1. **Install and Test**: `npm install && npm test` - Ensures all dependencies work and adapter can start properly
+2. **Lint Check**: `npx eslint main.js lib/ test/ --ext .js` - Check code quality (ignore admin/words.js issues)
+3. **Package Validation**: Tests automatically validate package.json and io-package.json consistency
+
+### Manual Testing Scenarios:
+- The adapter requires Amazon Alexa account credentials which cannot be tested in CI
+- Tests validate adapter initialization, configuration loading, and proper shutdown
+- Real functionality requires proxy-based authentication flow with Amazon
+- Tests use mock/stub behavior for core adapter lifecycle validation
+
+## Common Tasks
+
+### Dependencies and Requirements:
+- **Node.js**: 16+ required (package.json engines), tested with 20.x
+- **npm**: Standard package manager, uses package-lock.json
+- **@iobroker/adapter-core**: ^3.2.3 - Core ioBroker adapter framework
+- **alexa-remote2**: ^8.0.2 - Amazon Alexa API integration library
+
+### npm Scripts Available:
+```bash
+npm test          # Run mocha test suite (takes ~55s)
+npm run release   # Release automation (requires tokens)
+npm run translate # Translation management
+```
+
+### Linting and Code Quality:
+- ESLint configured in .eslintrc.json with strict rules
+- Use single quotes, 4-space indentation, prefer const over let/var
+- Main code files should lint cleanly
+- admin/words.js has known translation format issues - ignore ESLint errors in this file
+
+### GitHub Actions Workflow:
+- Runs on Node.js 18.x, 20.x, 22.x, 24.x across Ubuntu, Windows, macOS
+- check-and-lint job: `npm ci` only (linting commented out in workflow)
+- adapter-tests job: `npm ci && npm test` 
+- Deployment triggers on tagged releases
+
+## Architecture Notes
+
+### ioBroker Adapter Pattern:
+- Extends @iobroker/adapter-core.Adapter class
+- Uses state-based communication with ioBroker objects/states databases
+- Implements standard adapter lifecycle: ready, unload, stateChange, objectChange
+- Creates device/state hierarchies under adapter namespace (alexa2.0.*)
+
+### External Dependencies:
+- alexa-remote2: Amazon Alexa API integration
+- https, nearest-color, rrule: Utility libraries
+- Sentry integration for error reporting (optional)
+
+### Test Infrastructure:
+- Uses complex test setup that installs and configures js-controller
+- Creates temporary ioBroker instance with Redis backends
+- Tests adapter lifecycle, not actual Amazon Alexa functionality
+- Mock/stub approach for external API dependencies
+
+## Troubleshooting
+
+### Common Issues:
+- **Test timeouts**: Always set 90+ second timeouts for npm test
+- **ESLint errors in admin/words.js**: These are translation files with specific format requirements - ignore
+- **Cannot run main.js directly**: Requires ioBroker adapter-core framework and configuration
+- **Missing dependencies**: Always run `npm install` before any other commands
+
+### Development Environment:
+- Use any modern IDE with Node.js support
+- ESLint integration recommended for code quality
+- Git hooks not configured - manually run linting before commits
+- No TypeScript - pure JavaScript codebase
+
+### CI/CD Pipeline:
+- Tests run automatically on pushes and PRs
+- Linting step commented out in workflow due to admin file issues
+- Releases automated via @alcalzone/release-script
+- Sentry integration for production error tracking

.github/dependabot.yml

@@ -0,0 +1,20 @@
+# Dependabot will run on day 19 of each month at 02:38 (Europe/Berlin timezone)
+version: 2
+updates:
+
+  - package-ecosystem: "github-actions"
+    directory: "/"
+    schedule:
+      interval: "cron"
+      timezone: "Europe/Berlin"
+      cronjob: "38 2 19 * *"
+    open-pull-requests-limit: 15
+
+  - package-ecosystem: "npm"
+    directory: "/"
+    schedule:
+      interval: "cron"
+      timezone: "Europe/Berlin"
+      cronjob: "38 2 19 * *"
+    open-pull-requests-limit: 20
+    versioning-strategy: "increase"

.github/stale.yml

@@ -0,0 +1,79 @@
+# Configuration for probot-stale - https://github.com/probot/stale
+
+# Number of days of inactivity before an Issue or Pull Request becomes stale
+daysUntilStale: 90
+
+# Number of days of inactivity before an Issue or Pull Request with the stale label is closed.
+# Set to false to disable. If disabled, issues still need to be closed manually, but will remain marked as stale.
+daysUntilClose: 7
+
+# Only issues or pull requests with all of these labels are check if stale. Defaults to `[]` (disabled)
+onlyLabels: []
+
+# Issues or Pull Requests with these labels will never be considered stale. Set to `[]` to disable
+exemptLabels:
+  - enhancement
+  - security
+  - bug
+
+# Set to true to ignore issues in a project (defaults to false)
+exemptProjects: true
+
+# Set to true to ignore issues in a milestone (defaults to false)
+exemptMilestones: true
+
+# Set to true to ignore issues with an assignee (defaults to false)
+exemptAssignees: false
+
+# Label to use when marking as stale
+staleLabel: wontfix
+
+# Comment to post when marking as stale. Set to `false` to disable
+markComment: >
+  This issue has been automatically marked as stale because it has not had
+  recent activity. It will be closed if no further activity occurs within the next 7 days.
+  Please check if the issue is still relevant in the most current version of the adapter
+  and tell us. Also check that all relevant details, logs and reproduction steps
+  are included and update them if needed.
+  Thank you for your contributions.
+
+  Dieses Problem wurde automatisch als veraltet markiert, da es in letzter Zeit keine Aktivitäten gab.
+  Es wird geschlossen, wenn nicht innerhalb der nächsten 7 Tage weitere Aktivitäten stattfinden.
+  Bitte überprüft, ob das Problem auch in der aktuellsten Version des Adapters noch relevant ist,
+  und teilt uns dies mit. Überprüft auch, ob alle relevanten Details, Logs und Reproduktionsschritte
+  enthalten sind bzw. aktualisiert diese.
+  Vielen Dank für Eure Unterstützung.
+
+# Comment to post when removing the stale label.
+# unmarkComment: >
+#   Your comment here.
+
+# Comment to post when closing a stale Issue or Pull Request.
+closeComment: >
+  This issue has been automatically closed because of inactivity. Please open a new
+  issue if still relevant and make sure to include all relevant details, logs and
+  reproduction steps.
+  Thank you for your contributions.
+
+  Dieses Problem wurde aufgrund von Inaktivität automatisch geschlossen. Bitte öffnet ein
+  neues Issue, falls dies noch relevant ist und stellt sicher das alle relevanten Details,
+  Logs und Reproduktionsschritte enthalten sind.
+  Vielen Dank für Eure Unterstützung.
+
+# Limit the number of actions per hour, from 1-30. Default is 30
+limitPerRun: 30
+
+# Limit to only `issues` or `pulls`
+only: issues
+
+# Optionally, specify configuration settings that are specific to just 'issues' or 'pulls':
+# pulls:
+#   daysUntilStale: 30
+#   markComment: >
+#     This pull request has been automatically marked as stale because it has not had
+#     recent activity. It will be closed if no further activity occurs. Thank you
+#     for your contributions.
+
+# issues:
+#   exemptLabels:
+#     - confirmed