Add adoption onboarding and field-proof evidence

.github/ISSUE_TEMPLATE/config.yml

@@ -1,14 +1,14 @@
 blank_issues_enabled: false
 contact_links:
-  - name: Security vulnerability
-    url: https://github.com/masarray/arsas/security/advisories/new
-    about: Report exploitable vulnerabilities privately. Do not publish credentials, private endpoints, customer SCL, captures, relay settings, or disturbance records.
+  - name: ARSAS Quick Start
+    url: https://masarray.github.io/arsas/quick-start.html
+    about: Verify the package, network path and first read-only live value before reporting a defect.
+  - name: ARSAS FAQ
+    url: https://masarray.github.io/arsas/faq.html
+    about: Review setup, Npcap, SmartScreen, compatibility, safety and privacy answers.
   - name: Support and sanitization guidance
     url: https://github.com/masarray/arsas/blob/main/SUPPORT.md
-    about: Review troubleshooting information and required data sanitization before opening an issue.
-  - name: Product roadmap
-    url: https://github.com/masarray/arsas/blob/main/ROADMAP.md
-    about: Review current capability maturity and planned IEC 61850 milestones.
-  - name: Product website
-    url: https://masarray.github.io/arsas/
-    about: Explore ARSAS capabilities, architecture, Smart Control, and the full IEC 61850 product direction.
+    about: Remove credentials, private endpoints, confidential SCL, captures, settings and disturbance records before sharing evidence.
+  - name: Security vulnerability
+    url: https://github.com/masarray/arsas/security/advisories/new
+    about: Report security-sensitive findings privately. Do not open a public issue with credentials or exploit details.

.github/ISSUE_TEMPLATE/connection.yml

@@ -0,0 +1,38 @@
+name: MMS connection or port 102 problem
+description: Report routing, TCP 102, association or live-model discovery failures.
+title: "[Connection] "
+labels: ["connection", "needs-evidence"]
+body:
+  - type: input
+    id: arsas-version
+    attributes: {label: ARSAS version, placeholder: 1.6.18}
+    validations: {required: true}
+  - type: input
+    id: windows
+    attributes: {label: Windows and network adapter, placeholder: Windows 11 x64, Ethernet adapter}
+    validations: {required: true}
+  - type: input
+    id: device
+    attributes: {label: Device and firmware, description: Anonymize when disclosure is restricted.}
+    validations: {required: true}
+  - type: dropdown
+    id: stage
+    attributes: {label: Failing stage, options: [IP routing or ping, TCP port 102, ISO session, MMS association, Identity read, Live model discovery]}
+    validations: {required: true}
+  - type: textarea
+    id: steps
+    attributes: {label: Reproduction steps and expected result}
+    validations: {required: true}
+  - type: textarea
+    id: diagnostics
+    attributes: {label: Exact sanitized diagnostics, description: Include error text and timestamps; remove addresses when private.}
+    validations: {required: true}
+  - type: checkboxes
+    id: confirmation
+    attributes:
+      label: Confirmation
+      options:
+        - label: I tested only an endpoint I was authorized to access.
+          required: true
+        - label: I removed credentials and confidential project data.
+          required: true

.github/ISSUE_TEMPLATE/device-compatibility.yml

@@ -0,0 +1,67 @@
+name: Device compatibility evidence
+description: Report a bounded IEC 61850 service result for one device and ARSAS version.
+title: "[Compatibility] "
+labels: ["compatibility", "needs-evidence"]
+body:
+  - type: markdown
+    attributes:
+      value: |
+        Report service-level evidence, not a universal vendor conclusion. Remove credentials, private endpoints, customer names, confidential SCL, captures and disturbance records.
+  - type: input
+    id: arsas-version
+    attributes:
+      label: ARSAS version
+      placeholder: 1.6.18
+    validations:
+      required: true
+  - type: input
+    id: windows-version
+    attributes:
+      label: Windows version
+      placeholder: Windows 11 23H2 x64
+    validations:
+      required: true
+  - type: input
+    id: device
+    attributes:
+      label: Device vendor, model and firmware
+      description: Use anonymized identifiers when disclosure is not permitted.
+    validations:
+      required: true
+  - type: dropdown
+    id: service
+    attributes:
+      label: IEC 61850 service under test
+      options: [MMS association, Live model discovery, Reporting BRCB or URCB, FileDirectory or File transfer, GOOSE, SCL export, Direct or SBO control, Other]
+    validations:
+      required: true
+  - type: dropdown
+    id: result
+    attributes:
+      label: Observed result
+      options: [Verified repeatedly, Conditional success, Observed once, Failed with known evidence, Not tested]
+    validations:
+      required: true
+  - type: textarea
+    id: conditions
+    attributes:
+      label: Conditions and reproducible steps
+      description: Include network boundary, permissions, object or service path and exact sequence.
+    validations:
+      required: true
+  - type: textarea
+    id: diagnostics
+    attributes:
+      label: Sanitized diagnostics
+      description: Paste exact ARSAS text or attach a sanitized screenshot. Do not include secrets or confidential project data.
+    validations:
+      required: true
+  - type: checkboxes
+    id: confirmation
+    attributes:
+      label: Evidence confirmation
+      options:
+        - label: I removed credentials, private endpoints and confidential project or device data.
+          required: true
+        - label: I understand this report is service-specific and is not IEC 61850 conformance certification.
+          required: true

.github/ISSUE_TEMPLATE/feature-request.yml

@@ -1,47 +1,40 @@
 name: Engineering feature request
-description: Propose a focused ArIED workflow, usability, diagnostics, monitoring, or control improvement.
+description: Propose a bounded ARSAS workflow, evidence, usability or diagnostic improvement.
 title: "[Feature] "
-labels: ["enhancement", "needs-triage"]
+labels: ["enhancement", "needs-evidence"]
 body:
   - type: markdown
     attributes:
       value: |
-        Describe the engineering problem before proposing the UI or implementation. Protocol behavior should remain in ARIEC61850; ArIED should consume typed engine services.
-
+        Describe the engineering problem before proposing the UI. Protocol behavior belongs in ARIEC61850; ARSAS should consume typed engine services.
   - type: dropdown
     id: area
     attributes:
       label: Product area
-      options:
-        - SCL / project workflow
-        - MMS explorer / discovery
-        - Signal selection
-        - Reporting / live monitoring
-        - Events / diagnostics
-        - Smart Control
-        - Performance / scalability
-        - Accessibility / keyboard workflow
-        - Packaging / release
-        - Documentation / website
+      options: [MMS and model discovery, Reporting and RCB, Multi-IED monitoring, GOOSE, File transfer and COMTRADE, SCL, Control, Diagnostics, Packaging and update, Website and guidance, Other]
     validations:
       required: true
-
   - type: textarea
     id: problem
     attributes:
       label: Engineering problem
-      description: What is difficult, slow, ambiguous, or currently impossible?
+      description: Describe the current workflow, blocker and affected role without naming confidential projects.
     validations:
       required: true
-
   - type: textarea
-    id: workflow
+    id: evidence
     attributes:
-      label: Desired workflow
-      description: Describe the user steps and expected evidence, not only the final screen.
+      label: Current evidence and workaround
+      description: Include protocol objects, service sequence, sanitized diagnostics or repeatable examples.
+    validations:
+      required: true
+  - type: textarea
+    id: outcome
+    attributes:
+      label: Desired bounded outcome
+      description: State what should become visible, repeatable or exportable. Avoid universal vendor claims.
     validations:
       required: true
-
   - type: textarea
     id: acceptance
     attributes:
@@ -52,25 +45,17 @@ body:
         - Then...
     validations:
       required: true
-
-  - type: textarea
-    id: protocol-boundary
-    attributes:
-      label: Application / engine boundary
-      description: Identify whether the request needs a new ARIEC61850 engine contract, an ArIED-only change, or both.
-
   - type: textarea
-    id: validation
+    id: boundary
     attributes:
-      label: Proposed validation
-      description: Unit test, simulator, loopback, laboratory IED, performance measurement, or UI verification.
-
+      label: Application and engine boundary
+      description: Identify whether the request needs an ARIEC61850 contract, an ARSAS-only change or both.
   - type: checkboxes
-    id: confirmations
+    id: confirmation
     attributes:
-      label: Confirmations
+      label: Confirmation
       options:
-        - label: This request does not include confidential or proprietary customer or employer material.
+        - label: This request contains no credentials or confidential project, employer or device material.
           required: true
-        - label: This request does not depend on copying another product's UI, wording, code, or documentation.
+        - label: I understand roadmap inclusion and timing are not guaranteed.
           required: true

.github/ISSUE_TEMPLATE/file-transfer.yml

@@ -0,0 +1,34 @@
+name: File transfer or fault-record problem
+description: Report FileDirectory, FileOpen, FileRead, COMTRADE grouping or local-save failures.
+title: "[File transfer] "
+labels: ["file-transfer", "needs-evidence"]
+body:
+  - type: input
+    id: arsas-version
+    attributes: {label: ARSAS version, placeholder: 1.6.18}
+    validations: {required: true}
+  - type: input
+    id: device
+    attributes: {label: Device and firmware, description: Anonymize when required.}
+    validations: {required: true}
+  - type: dropdown
+    id: stage
+    attributes: {label: Failing stage, options: [Directory discovery, Record grouping, FileOpen, FileRead, FileClose, Local write or validation, Redownload or overwrite, Other]}
+    validations: {required: true}
+  - type: textarea
+    id: files
+    attributes: {label: Sanitized remote paths, companion names and known sizes, description: Do not upload confidential disturbance contents.}
+    validations: {required: true}
+  - type: textarea
+    id: diagnostics
+    attributes: {label: Exact transfer diagnostics, description: Include invoke ID, FRSM, stage, session state and bounded request or response evidence when available.}
+    validations: {required: true}
+  - type: checkboxes
+    id: confirmation
+    attributes:
+      label: Confirmation
+      options:
+        - label: I understand transfer success does not prove record completeness or COMTRADE scaling.
+          required: true
+        - label: I removed credentials and confidential files or identifiers.
+          required: true

.github/ISSUE_TEMPLATE/goose.yml

@@ -0,0 +1,34 @@
+name: GOOSE capture or sequence problem
+description: Report adapter, Npcap, APPID, VLAN, stNum, sqNum, TAL or payload evidence.
+title: "[GOOSE] "
+labels: ["goose", "needs-evidence"]
+body:
+  - type: input
+    id: arsas-version
+    attributes: {label: ARSAS version, placeholder: 1.6.18}
+    validations: {required: true}
+  - type: input
+    id: environment
+    attributes: {label: Windows, Npcap version and adapter}
+    validations: {required: true}
+  - type: input
+    id: stream
+    attributes: {label: Sanitized stream identity, placeholder: APPID, VLAN and gocbRef without private addresses}
+    validations: {required: true}
+  - type: dropdown
+    id: symptom
+    attributes: {label: Symptom, options: [No frames captured, Stream not bound to model, stNum anomaly, sqNum anomaly, TAL or timeout problem, Payload order or value problem, Other]}
+    validations: {required: true}
+  - type: textarea
+    id: evidence
+    attributes: {label: Sanitized sequence and packet evidence, description: Include timestamps and expected behavior. Remove private MAC addresses when required.}
+    validations: {required: true}
+  - type: checkboxes
+    id: confirmation
+    attributes:
+      label: Confirmation
+      options:
+        - label: Capture was authorized on the selected adapter and network.
+          required: true
+        - label: I removed credentials and confidential project data.
+          required: true

.github/ISSUE_TEMPLATE/installation.yml

@@ -0,0 +1,37 @@
+name: Installation, update or package problem
+description: Report installer, portable ZIP, SmartScreen, checksum, startup or update failures.
+title: "[Installation] "
+labels: ["installation", "needs-evidence"]
+body:
+  - type: input
+    id: arsas-version
+    attributes: {label: ARSAS version, placeholder: 1.6.18}
+    validations: {required: true}
+  - type: input
+    id: windows
+    attributes: {label: Windows version and architecture, placeholder: Windows 11 23H2 x64}
+    validations: {required: true}
+  - type: dropdown
+    id: package
+    attributes: {label: Package, options: [Windows installer, Portable ZIP, Automatic update, Checksum file, Other]}
+    validations: {required: true}
+  - type: dropdown
+    id: symptom
+    attributes: {label: Symptom, options: [Download failed, SHA-256 mismatch, SmartScreen or antivirus warning, Install failed, Uninstall failed, Application does not start, Update failed, Missing dependency, Other]}
+    validations: {required: true}
+  - type: textarea
+    id: steps
+    attributes: {label: Reproduction steps and exact error}
+    validations: {required: true}
+  - type: input
+    id: checksum
+    attributes: {label: Observed SHA-256, description: Required for download or package-integrity problems.}
+  - type: checkboxes
+    id: confirmation
+    attributes:
+      label: Confirmation
+      options:
+        - label: I downloaded from the official ARSAS release or Download Center.
+          required: true
+        - label: I removed usernames, private paths, credentials and confidential data.
+          required: true

.github/ISSUE_TEMPLATE/reporting.yml

@@ -0,0 +1,34 @@
+name: Reporting, RCB or DataSet problem
+description: Report silent BRCB or URCB, ownership, DataSet coverage or fallback behavior.
+title: "[Reporting] "
+labels: ["reporting", "needs-evidence"]
+body:
+  - type: input
+    id: arsas-version
+    attributes: {label: ARSAS version, placeholder: 1.6.18}
+    validations: {required: true}
+  - type: input
+    id: device
+    attributes: {label: Device, firmware and RCB reference, description: Anonymize restricted identity.}
+    validations: {required: true}
+  - type: dropdown
+    id: symptom
+    attributes: {label: Symptom, options: [Reporting silent, RCB reserved or occupied, Empty or incomplete DataSet, RptEna or write rejected, Buffered recovery problem, Unexpected polling fallback, Other]}
+    validations: {required: true}
+  - type: textarea
+    id: selected-signals
+    attributes: {label: Selected object references and expected DataSet coverage}
+    validations: {required: true}
+  - type: textarea
+    id: evidence
+    attributes: {label: Sanitized RCB, DataSet and diagnostics evidence, description: Include report source, reason, owner and fallback state where visible.}
+    validations: {required: true}
+  - type: checkboxes
+    id: confirmation
+    attributes:
+      label: Confirmation
+      options:
+        - label: I did not force reservation, write or takeover outside an approved procedure.
+          required: true
+        - label: I removed credentials and confidential project data.
+          required: true