[release] Rolls up work across Operon, Visual Composer, Prometheus, identity/external login, hardware templates, and broad localization.

.config/dotnet-tools.json

@@ -3,49 +3,49 @@
   "isRoot": true,
   "tools": {
     "AXSharp.ixc": {
-      "version": "0.24.0-preview.158",
+      "version": "0.47.0-alpha.459",
       "commands": [
         "ixc"
       ],
       "rollForward": false
     },
     "docfx": {
-      "version": "2.70.4",
+      "version": "2.78.5",
       "commands": [
         "docfx"
       ],
       "rollForward": false
     },
     "AXSharp.ixd": {
-      "version": "0.24.0-preview.158",
+      "version": "0.47.0-alpha.459",
       "commands": [
         "ixd"
       ],
       "rollForward": false
     },
     "AXSharp.ixr": {
-      "version": "0.24.0-preview.158",
+      "version": "0.47.0-alpha.459",
       "commands": [
         "ixr"
       ],
       "rollForward": false
     },
     "microsoft.visualstudio.slngen.tool": {
-      "version": "12.0.3",
+      "version": "12.0.32",
       "commands": [
         "slngen"
       ],
       "rollForward": false
     },
     "docfxtocgenerator": {
-      "version": "1.10.0",
+      "version": "1.40.0",
       "commands": [
         "DocFxTocGenerator"
       ],
       "rollForward": false
     },
     "gitversion.tool": {
-      "version": "5.12.0",
+      "version": "6.6.1",
       "commands": [
         "dotnet-gitversion"
       ],

.editorconfig

@@ -0,0 +1,6 @@
+root = true
+
+[*]
+charset = utf-8
+end_of_line = lf
+insert_final_newline = true

.gitattributes

@@ -0,0 +1,30 @@
+# Default: treat as text, normalize to LF in the repository
+* text=auto eol=lf
+
+# Typical source files (explicit, but the default already covers these)
+*.c      text eol=lf
+*.cpp    text eol=lf
+*.h      text eol=lf
+*.py     text eol=lf
+*.js     text eol=lf
+*.ts     text eol=lf
+*.sh     text eol=lf
+*.yaml   text eol=lf
+*.yml    text eol=lf
+*.json   text eol=lf
+*.css    text eol=lf
+*.cs     text eol=lf
+*.ps1    text eol=lf
+*.sln    text eol=lf
+
+
+# Windows-native scripts that often *must* be CRLF in the working tree
+# (repo still stores LF; checkout converts to CRLF)
+*.bat    text eol=crlf
+*.cmd    text eol=crlf
+
+# Binary files (never touch line endings)
+*.png    -text
+*.jpg    -text
+*.zip    -text
+*.pdf    -text

.github/.copilot-instructions.yml

@@ -0,0 +1,117 @@
+version: 1
+# Scope: steer Copilot's PR description output
+targets:
+  - pull_request.description
+
+rules:
+  - id: pr-description-structure
+    instruction: |
+      Write PR descriptions using the following sections and order:
+
+      ## Summary
+      - One or two sentences: what changed and why.
+      - Be specific; name the feature, behavior, or defect addressed.
+
+      ## Functional Changes
+      - Group by library. Use bullets.
+      - For each entry, include the layer:
+        - (PLC) for controller/PLC layer changes.
+        - (.NET) for higher-level framework changes.
+      - Example bullet format:
+        - **AuthLibrary (.NET):** Introduced `ValidationService` to centralize token checks.
+        - **OrderController (PLC):** Calls `ValidationService` before persisting orders.
+
+      ## Interdependencies
+      - List new or changed dependencies between libraries/components (with minimum required versions if relevant).
+      - Example:
+        - `AuthLibrary` now depends on `CoreLibrary.ValidationService` (>= v3.2).
+
+      ## Chores (non-functional)
+      - Keep chores separate from functional changes.
+      - Subsections to use as needed: Dependencies, CI/CD, Docs, Tooling, Formatting.
+      - Example bullets:
+        - **Dependencies:** Bump `Newtonsoft.Json` 13.0.1 → 13.0.2 in `CoreLibrary`.
+        - **CI/CD:** Switch pipeline to `dotnet test` on .NET 8.
+        - **Docs:** Update README with `ValidationService` usage.
+
+      ## Related Issues
+      - Link issues using GitHub keywords (e.g., Fixes #123, Closes #456).
+
+      ## Testing Notes
+      - How to verify the change (commands, environments, manual steps).
+      - Mention key unit/integration tests and their locations.
+
+      ## Checklist
+      - [ ] Builds pass
+      - [ ] Tests added/updated
+      - [ ] Docs updated (if needed)
+      - [ ] Interdependencies documented
+      - [ ] Chores separated
+
+  - id: pr-description-style
+    instruction: |
+      Style:
+      - Write clear, concrete, measurable statements.
+      - Prefer active, action verbs: Added, Removed, Updated, Refactored.
+      - Keep sentences short; use lists for readability.
+
+      Avoid:
+      - All-encompassing phrases: “overall improvements”, “general cleanup”, “improved everything”.
+      - Clichés/vague terms: “minor tweaks”, “various enhancements”, “quality improvements”.
+      - Empty summaries: “fixed bugs”.
+      Replace with specifics:
+      - “Refactored `OrderController` validation flow to remove duplication.”
+      - “Fixed null reference in `UserSessionStore` when token is missing.”
+
+  - id: libraries-and-paths
+    instruction: |
+      Organize Functional Changes by **library**. Infer libraries from changed paths (e.g., `src/CoreLibrary`, `libs/AuthLibrary`, `plc/OrderController`).
+      - Use the library’s canonical name in bold.
+      - Mark each entry with (PLC) or (.NET).
+      - If multiple files in the same library are changed, summarize at library level and call out notable classes/methods.
+
+  - id: interdependencies-mandatory
+    instruction: |
+      If any library now calls into another, or requires a minimum version/config, list it under **Interdependencies** with clear direction:
+      - who depends on whom
+      - what version/range is needed
+      - any migration notes for downstream consumers
+
+  - id: chores-separation
+    instruction: |
+      Put non-functional changes in **Chores** and NOT under Functional Changes.
+      Classify chores under: Dependencies, CI/CD, Docs, Tooling, Formatting.
+      Do not mix chores with PLC/.NET functional bullets.
+
+  - id: plc-vs-dotnet-tagging
+    instruction: |
+      For every Functional Changes bullet, explicitly tag the layer:
+      - (PLC) for controller/PLC code.
+      - (.NET) for higher-level framework or library code.
+
+  - id: examples
+    instruction: |
+      Example (use as a guide; adapt names):
+      ## Summary
+      Centralizes validation and aligns PLC controllers with new service.
+
+      ## Functional Changes
+      - **CoreLibrary (.NET):** Added `ValidationService` with email and token checks.
+      - **AuthLibrary (.NET):** Uses `ValidationService` before issuing tokens.
+      - **OrderController (PLC):** Validates input via `ValidationService` prior to persistence.
+
+      ## Interdependencies
+      - `AuthLibrary` depends on `CoreLibrary.ValidationService` (>= v3.2).
+      - PLC controllers require `CoreLibrary` v3.2+.
+
+      ## Chores
+      - **Dependencies:** Update `Serilog` 2.12 → 3.0 in `CoreLibrary`.
+      - **CI/CD:** Run integration tests on .NET 8.
+      - **Docs:** Add `ValidationService` usage to README.
+
+      ## Related Issues
+      Fixes #123
+
+      ## Testing Notes
+      - `dotnet test` in `tests/CoreLibrary.Tests` and `tests/PLC.Controllers.Tests`
+      - Manual: login flow + order creation with invalid email.

.github/dependabot.yml

@@ -0,0 +1,15 @@
+# To get started with Dependabot version updates, you'll need to specify which
+# package ecosystems to update and where the package manifests are located.
+# Please see the documentation for all configuration options:
+# https://docs.github.com/code-security/dependabot/dependabot-version-updates/configuration-options-for-the-dependabot.yml-file
+
+version: 2
+updates:
+  - package-ecosystem: "npm" # See documentation for possible values
+    directory: "/" # Location of package manifests
+    schedule:
+      interval: "weekly"
+  - package-ecosystem: "nuget" # See documentation for possible values
+    directory: "/" # Location of package manifests
+    schedule:
+      interval: "weekly"

.github/instructions/pull-request-description-instructions.md

@@ -0,0 +1,101 @@
+# 📝 GitHub Copilot Instructions: Pull Request Descriptions
+
+## Content Rules
+
+When drafting PR descriptions, **Copilot must**:
+
+1. Follow the PR template (Summary, Changes Introduced, Related Issues, Testing Notes, Checklist).
+2. Use precise, specific, and factual language.
+3. State explicitly **where changes were made**:
+
+   * If in the **PLC (Controller)** layer.
+   * If in the **higher-level framework (.NET)** part of the project.
+4. Organize functional changes **by library** if multiple libraries are affected.
+5. Clearly note **interdependencies** between libraries or components introduced or updated.
+6. Separate **chores** (non-functional tasks) from core changes.
+
+---
+
+## Style Rules
+
+Copilot **must avoid**:
+
+* **All-encompassing phrases**: e.g., “general cleanup”, “overall improvements”.
+* **Clichés and vague wording**: e.g., “minor tweaks”, “enhancements”.
+* **Unhelpful summaries**: e.g., “fixed bugs”.
+
+✅ Instead, Copilot should write:
+
+* *“Refactored `OrderController` in the PLC layer to centralize validation logic.”*
+* *“Bumped Newtonsoft.Json from 13.0.1 → 13.0.2 in CoreLibrary.”*
+
+---
+
+## Organization Guidelines
+
+PR descriptions should be structured in **distinct sections**:
+
+### 1. Functional Changes
+
+Group by library and indicate PLC vs framework.
+Example:
+
+* **Library A (DataAccess / .NET framework):** Introduced caching in query layer.
+* **Library B (OrderController / PLC):** Added call to caching layer before persisting orders.
+
+### 2. Interdependencies
+
+State explicit links between libraries or modules.
+Example:
+
+* *OrderController now requires DataAccess v2.1+ for caching compatibility.*
+
+### 3. Chores
+
+List non-functional changes separately.
+Examples:
+
+* **Dependencies:** Updated `Serilog` from 2.12 → 3.0.
+* **CI/CD:** Migrated pipeline to use `dotnet test` instead of `nunit-console`.
+* **Docs:** Updated README with usage instructions for `ValidationService`.
+
+---
+
+## Example PR Description
+
+**Summary**
+Adds centralized validation in PLC controllers and updates libraries for consistent error handling. Includes some dependency and CI housekeeping.
+
+**Functional Changes**
+
+* **PLC Layer**
+
+  * Refactored `UserController` and `OrderController` to use `ValidationService`.
+* **CoreLibrary (.NET Framework)**
+
+  * Added `ValidationService`.
+* **AuthLibrary (.NET Framework)**
+
+  * Updated token validation to use `ValidationService`.
+
+**Interdependencies**
+
+* `AuthLibrary` now depends on `CoreLibrary.ValidationService`.
+* All PLC controllers require CoreLibrary v3.2+.
+
+**Chores**
+
+* Bumped `Newtonsoft.Json` to 13.0.2 in CoreLibrary.
+* Updated CI pipeline to run integration tests on .NET 8.
+* Adjusted README with new validation examples.
+
+**Related Issues**
+
+* Fixes #123
+
+**Testing Notes**
+
+* Run `dotnet test` in `PLC.Controllers.Tests`.
+* Verify login and order creation flows manually.
+
+