V2 phase1 architecture

.github/ISSUE_TEMPLATE/audio_field_report.yml

@@ -0,0 +1,51 @@
+name: "🔊 Audio field report (Music Assistant / F441)"
+description: "Report how multi-room audio behaves on your plant. Passing runs count too."
+title: "[Audio]: "
+labels: ["audio", "field-report"]
+body:
+  - type: markdown
+    attributes:
+      value: |
+        ## Audio field report
+
+        Grouping is where Music Assistant and the analog matrix meet, and each plant behaves a little differently.
+        The four checks below are the ones we replay as tests. Please attach the **diagnostics file**
+        (*Settings → Devices & services → MyHOME → ⋮ → Download diagnostics*) and, for Music Assistant problems,
+        its log from around the time it happened.
+
+  - type: input
+    id: plant
+    attributes:
+      label: Plant
+      description: Gateway model, matrix (F441 / F441M), number of zones, decoder(s).
+      placeholder: "MH200 + F441M, 6 zones, Squeezelite + Cambridge CXN"
+    validations:
+      required: true
+
+  - type: input
+    id: versions
+    attributes:
+      label: Versions
+      description: MyHOME, Home Assistant and Music Assistant versions.
+      placeholder: "MyHOME 2.0.0b14, HA 2026.9.2, Music Assistant 2.x"
+    validations:
+      required: true
+
+  - type: checkboxes
+    id: checks
+    attributes:
+      label: Which checks passed?
+      description: Tick what worked. Leave unticked what did not, and describe it below.
+      options:
+        - label: "Played to the Music Assistant Sync Group, added a third room, dropped the leader: matrix and queue stayed in step"
+        - label: "Volume of one member set to 0 and raised again: the slider did not lock"
+        - label: "After the anti-hiss auto-off silenced the house, play brought the parked members back as a group"
+        - label: "Cambridge decoder only: diagnostics show the DLNA/UPnP renderer as companion, not a Music Assistant clone"
+
+  - type: textarea
+    id: what_happened
+    attributes:
+      label: What you did, and when
+      description: "For example: 21:48, pressed play on the Huis group, Bureau's slider would not move."
+    validations:
+      required: true

.github/ISSUE_TEMPLATE/bug_report.yml

@@ -0,0 +1,139 @@
+name: "🐛 Bug Report"
+description: "File a bug report or defect with the MyHOME integration."
+title: "[Bug]: "
+labels: ["bug"]
+body:
+  - type: markdown
+    attributes:
+      value: |
+        ## Thank you for helping improve MyHOME!
+
+        To help us diagnose and fix issues quickly, please provide diagnostics and logs using any of the following methods:
+
+        ---
+
+        ### ⚡ How to provide diagnostic logs & bundles:
+        1. **One-Click Bus Trace Bundle** *(Fastest)*:
+           If you use the Lovelace **MyHOME Bus Monitor Card** (`<myhome-bus-card>`), click **"📋 Report Issue / Copy Trace"**. It copies your gateway model, firmware, queue telemetry, and recent bus frames to your clipboard to paste below.
+        2. **Home Assistant Diagnostics File**:
+           Go to **Settings ➔ Devices & Services ➔ MyHOME ➔ ⋮ (3 dots) ➔ Download diagnostics**. You can drag & drop the downloaded JSON file directly into the attachment box below!
+        3. **Home Assistant Full Log or Zip**:
+           Go to **Settings ➔ System ➔ Logs ➔ Download full log**. You can drag & drop your `.log` or `.zip` file directly into the attachment box below.
+
+        ---
+
+  - type: textarea
+    id: description
+    attributes:
+      label: Bug Description
+      description: A clear and concise description of what the bug is.
+      placeholder: What went wrong? What did you observe versus what did you expect?
+    validations:
+      required: true
+
+  - type: dropdown
+    id: gateway_model
+    attributes:
+      label: Gateway Model
+      description: Select your BTicino / Legrand OpenWebNet gateway hardware model.
+      options:
+        - "F454 (Audio/Video Gateway)"
+        - "F455 (Basic Gateway)"
+        - "MH200 (Scenario Programmer)"
+        - "MH200N (Scenario Programmer)"
+        - "MH202 (Scenario Programmer)"
+        - "AM4890 (Basic Gateway)"
+        - "MyHomeServer1 (MHS1)"
+        - "Legrand 3578 USB/Serial (Serial Interface)"
+        - "F452 / F453AV"
+        - "Other / Custom OpenWebNet Server"
+    validations:
+      required: true
+
+  - type: dropdown
+    id: connection_type
+    attributes:
+      label: Connection Type
+      description: How is Home Assistant communicating with your OpenWebNet gateway?
+      options:
+        - "Ethernet / IP (TCP port 20000, unencrypted OpenWebNet)"
+        - "Ethernet / IP (TCP port 20000, HMAC-SHA2 / SHA1 authenticated)"
+        - "USB / Serial (RS-232 / USB-to-serial adapter, e.g. Legrand 3578)"
+        - "Virtual / TCP Tunnel"
+        - "Other"
+    validations:
+      required: true
+
+  - type: input
+    id: ha_version
+    attributes:
+      label: Home Assistant Version
+      description: Find this under Settings -> About (e.g. 2024.9.0).
+      placeholder: "e.g. 2024.9.0"
+    validations:
+      required: true
+
+  - type: input
+    id: integration_version
+    attributes:
+      label: Integration Version
+      description: The version or commit of the MyHOME integration.
+      placeholder: "e.g. 1.0.0-beta (v2-phase1-architecture)"
+    validations:
+      required: true
+
+  - type: textarea
+    id: reproduction_steps
+    attributes:
+      label: Steps to Reproduce
+      description: Step-by-step instructions to reproduce the issue.
+      placeholder: |
+        1. Open Home Assistant dashboard
+        2. Toggle switch 'switch.living_room'
+        3. Observe that light physically switches on, but state flips back to off after 3 seconds...
+    validations:
+      required: true
+
+  - type: textarea
+    id: diagnostic_attachment
+    attributes:
+      label: "📎 Diagnostics File / Log File / Zip Attachment"
+      description: |
+        **Drag & drop files directly into this box** (GitHub supports `.log`, `.txt`, `.json`, `.zip`, `.tar.gz`):
+        - 📦 **Diagnostics JSON**: *Settings ➔ Devices & Services ➔ MyHOME ➔ ⋮ (3 dots) ➔ Download diagnostics*
+        - 📋 **Full Log File**: *Settings ➔ System ➔ Logs ➔ Download full log* (or zip of `/config/home-assistant.log`)
+      placeholder: "Drag and drop your home-assistant.log, .zip, or myhome_diagnostics.json file here..."
+    validations:
+      required: false
+
+  - type: textarea
+    id: diagnostic_payload
+    attributes:
+      label: Bus Monitor Diagnostic Payload / Bus Trace
+      description: |
+        Paste the clipboard content generated by clicking **"📋 Report Issue / Copy Trace"** in `<myhome-bus-card>` here.
+        Contains gateway parameters, buffer telemetry, and recent OpenWebNet frames.
+      render: markdown
+      placeholder: "Paste clipboard contents here (starts with ### MyHOME Diagnostic Bundle)..."
+    validations:
+      required: false
+
+  - type: textarea
+    id: logs
+    attributes:
+      label: Log Snippets / Python Tracebacks
+      description: Relevant log entries or traceback snippets from Settings -> System -> Logs.
+      render: text
+      placeholder: "Paste relevant traceback or error messages from custom_components.myhome here..."
+    validations:
+      required: false
+
+  - type: checkboxes
+    id: diagnostics_checklist
+    attributes:
+      label: Diagnostics Checklist
+      description: Attaching diagnostic bundles or logs significantly speeds up root-cause analysis and resolution.
+      options:
+        - label: "I have attached or pasted the MyHOME Bus Monitor diagnostic bundle or OpenWebNet frame trace."
+        - label: "I have attached the Home Assistant full log file (.log or .zip) or pasted the crash traceback."
+        - label: "I have attached the MyHOME integration diagnostics JSON (from Settings -> Devices & Services -> MyHOME)."

.github/ISSUE_TEMPLATE/config.yml

@@ -0,0 +1,11 @@
+blank_issues_enabled: false
+contact_links:
+  - name: 💬 Community Discussions & Questions
+    url: https://github.com/OpenWebNet-HA/MyHOME/discussions
+    about: Ask questions, get help, or share your MyHOME automation setups with the community.
+  - name: 🧪 v2 Architecture Testing Thread (#229)
+    url: https://github.com/OpenWebNet-HA/MyHOME/issues/229
+    about: Join community testing feedback for the Phase 1 v2 architecture rewrite.
+  - name: 🔀 v2 Architecture Pull Request (#232)
+    url: https://github.com/OpenWebNet-HA/MyHOME/pull/232
+    about: Review code changes, architecture specs, and development progress in PR #232.

.github/ISSUE_TEMPLATE/device_request.yml

@@ -0,0 +1,83 @@
+name: "💡 New Device Request"
+description: "Request support for a new or currently unsupported BTicino / Legrand device."
+title: "[Device Request]: "
+labels: ["enhancement", "device-support"]
+body:
+  - type: markdown
+    attributes:
+      value: |
+        ## Request Support for BTicino / Legrand Hardware
+
+        Thank you for requesting support for a new BTicino / Legrand device!
+        Please fill out the technical details below so maintainers can verify the OpenWebNet protocol messages and implement native support.
+
+  - type: input
+    id: device_model
+    attributes:
+      label: Device Model / Commercial Catalog Code
+      description: The exact BTicino or Legrand catalog reference (e.g. F411/4, LN4652, 3456, F420, MH201).
+      placeholder: "e.g. F411/4"
+    validations:
+      required: true
+
+  - type: dropdown
+    id: who_system
+    attributes:
+      label: OpenWebNet WHO System Domain
+      description: Which OpenWebNet subsystem (WHO) does this device belong to?
+      options:
+        - "WHO=1 (Lighting / Relays / Actuators / Switches)"
+        - "WHO=2 (Automation / Shutters / Blinds / Motorized actuators)"
+        - "WHO=4 (Heating / Thermoregulation / Thermostats / Zones)"
+        - "WHO=15 (CEN Pushbuttons / Scenario Control)"
+        - "WHO=16 (Sound System / Audio Distribution)"
+        - "WHO=18 (Energy Management / Power Meters / Actuators)"
+        - "WHO=25 (CEN+ / Advanced Scenario Pushbuttons)"
+        - "WHO=13 (Gateway & System Diagnostics)"
+        - "Other / Unknown WHO"
+    validations:
+      required: true
+
+  - type: textarea
+    id: configuration
+    attributes:
+      label: Physical Configurators or Virtual Configuration
+      description: Describe the configuration plugs inserted in the physical sockets (e.g. A=1, PL=2, M=MOD) or virtual parameters set via MyHOME_Suite.
+      placeholder: "e.g. Configured with A=2, PL=3, M=0 (or virtual ID 12345 in MyHOME_Suite)"
+    validations:
+      required: true
+
+  - type: textarea
+    id: sample_bus_frames
+    attributes:
+      label: Sample OpenWebNet Bus Frames
+      description: |
+        Bus frames captured from this device via the Lovelace Bus Monitor Card or integration logs.
+        Please include frames for status queries, state transitions, button presses, etc.
+      render: markdown
+      placeholder: |
+        ```
+        *1*1*23##
+        *#1*23*1*0##
+        *1*0*23##
+        ```
+    validations:
+      required: true
+
+  - type: textarea
+    id: expected_behavior
+    attributes:
+      label: Expected Home Assistant Behavior
+      description: What Home Assistant entity type and controls should this device map to (e.g. Light, Switch, Cover, Climate, Sensor, Event)?
+      placeholder: "e.g. Should be exposed as a 4-channel cover entity with open/close/stop commands..."
+    validations:
+      required: false
+
+  - type: textarea
+    id: documentation_links
+    attributes:
+      label: Documentation / Technical Datasheets
+      description: Links to BTicino / Legrand product manuals, datasheets, or OpenWebNet protocol specifications.
+      placeholder: "https://..."
+    validations:
+      required: false

.github/pull_request_template.md

@@ -0,0 +1 @@
+- [ ] **V2 Architecture:** New entities implement `handle_event()` and do not manually subscribe via `async_dispatcher_connect`.

.github/workflows/crowdin.yml

@@ -0,0 +1,71 @@
+name: Crowdin Translation Sync
+
+on:
+  push:
+    branches: ["v2-phase1-architecture"]
+    paths:
+      - "custom_components/myhome/translations/en.json"
+      - "custom_components/myhome/strings.json"
+  schedule:
+    - cron: "0 2 * * 0" # Weekly on Sunday at 02:00 UTC
+  workflow_dispatch:
+    inputs:
+      upload_sources:
+        description: "Upload English source strings (en.json) to Crowdin"
+        required: true
+        type: boolean
+        default: true
+      upload_translations:
+        description: "Upload existing translations (nl, fr, it) to seed Crowdin (run once)"
+        required: false
+        type: boolean
+        default: false
+      download_translations:
+        description: "Download approved translated strings from Crowdin"
+        required: true
+        type: boolean
+        default: true
+
+permissions:
+  contents: write
+  pull-requests: write
+
+jobs:
+  crowdin:
+    name: Synchronize with Crowdin
+    runs-on: ubuntu-latest
+    steps:
+      - name: Checkout repository
+        uses: actions/checkout@v7
+        with:
+          fetch-depth: 0
+
+      - name: Check Crowdin credentials
+        id: check_creds
+        run: |
+          if [ -z "${{ secrets.CROWDIN_PROJECT_ID }}" ] || [ -z "${{ secrets.CROWDIN_PERSONAL_TOKEN }}" ]; then
+            echo "configured=false" >> "$GITHUB_OUTPUT"
+            echo "Crowdin credentials (CROWDIN_PROJECT_ID, CROWDIN_PERSONAL_TOKEN) are not set. Skipping Crowdin sync."
+          else
+            echo "configured=true" >> "$GITHUB_OUTPUT"
+          fi
+
+      - name: Crowdin Action
+        if: steps.check_creds.outputs.configured == 'true'
+        uses: crowdin/github-action@e4a6c1338b4063c77d46a81875265f9e8bd76f95 # v3.0.0
+        with:
+          upload_sources: ${{ github.event_name == 'push' || (github.event_name == 'workflow_dispatch' && inputs.upload_sources) }}
+          upload_translations: ${{ github.event_name == 'workflow_dispatch' && inputs.upload_translations }}
+          download_translations: ${{ github.event_name == 'schedule' || (github.event_name == 'workflow_dispatch' && inputs.download_translations) }}
+          skip_untranslated_strings: true
+          export_only_approved: true
+          create_pull_request: ${{ github.event_name == 'schedule' || (github.event_name == 'workflow_dispatch' && inputs.download_translations) }}
+          pull_request_title: "chore(translations): update community translations from Crowdin"
+          pull_request_body: "Automated pull request generated by Crowdin GitHub Action with approved community translations."
+          pull_request_base_branch_name: "v2-phase1-architecture"
+          localization_branch_name: "l10n_crowdin_v2"
+          commit_message: "chore(translations): sync community translations from Crowdin"
+        env:
+          GITHUB_TOKEN: ${{ secrets.GITHUB_TOKEN }}
+          CROWDIN_PROJECT_ID: ${{ secrets.CROWDIN_PROJECT_ID }}
+          CROWDIN_PERSONAL_TOKEN: ${{ secrets.CROWDIN_PERSONAL_TOKEN }}