ci: issue templates, PR template, working tier-2 GLSL validation

.github/ISSUE_TEMPLATE/bug-report.yml

@@ -0,0 +1,88 @@
+name: Bug Report
+description: Something isn't rendering correctly or Iris shows compile errors
+labels: ["bug"]
+body:
+  - type: dropdown
+    id: bug-type
+    attributes:
+      label: What kind of bug?
+      options:
+        - Visual glitch / wrong effect
+        - Shader compile error in Iris
+        - Game crash after enabling shader
+        - Performance / FPS drop
+        - Effect not matching the selected profile
+    validations:
+      required: true
+
+  - type: textarea
+    id: description
+    attributes:
+      label: What happened?
+      description: What did you see, and what did you expect instead?
+    validations:
+      required: true
+
+  - type: textarea
+    id: repro
+    attributes:
+      label: Steps to reproduce
+      placeholder: |
+        1. Profile: Minimal / Moderate / …
+        2. Effects enabled: …
+        3. …
+    validations:
+      required: true
+
+  - type: input
+    id: mc-version
+    attributes:
+      label: Minecraft version
+      placeholder: "e.g. 1.21.1"
+    validations:
+      required: true
+
+  - type: input
+    id: iris-version
+    attributes:
+      label: Iris version
+      placeholder: "e.g. 1.7.5"
+    validations:
+      required: true
+
+  - type: input
+    id: shader-version
+    attributes:
+      label: Shader version
+      placeholder: "e.g. 0.8.0 — shown in the Iris shader menu"
+    validations:
+      required: true
+
+  - type: input
+    id: gpu
+    attributes:
+      label: GPU and driver
+      placeholder: "e.g. NVIDIA RTX 4080, driver 555.42 / AMD RX 6800, Mesa 24.x"
+
+  - type: textarea
+    id: log
+    attributes:
+      label: Log output
+      description: For compile errors or crashes — paste the relevant section from `.minecraft/logs/latest.log`
+      render: text
+
+  - type: textarea
+    id: screenshots
+    attributes:
+      label: Screenshots
+      description: For visual issues — before/after, with/without the affected effect
+
+  - type: checkboxes
+    id: checklist
+    attributes:
+      label: Before submitting
+      options:
+        - label: I checked there is no existing open issue for this
+          required: true
+        - label: The Iris version I'm using is listed in the README
+          required: false

.github/ISSUE_TEMPLATE/clinical-feedback.yml

@@ -0,0 +1,59 @@
+name: Clinical Accuracy Feedback
+description: Something looks wrong compared to how VSS actually presents — from a patient or clinician
+labels: ["clinical"]
+body:
+  - type: markdown
+    attributes:
+      value: |
+        This template is for people with VSS or clinical experience who notice
+        that an effect is unrealistic — wrong intensity, wrong behaviour, or
+        missing nuance. You don't need a GitHub account history or technical
+        knowledge. Just describe what you see.
+
+  - type: dropdown
+    id: affected-effect
+    attributes:
+      label: Which effect is inaccurate?
+      options:
+        - Static (core grain)
+        - Palinopsia (afterimages / trails)
+        - Photophobia (light sensitivity)
+        - Nyctalopia (night blindness)
+        - Floaters
+        - Blue Field Phenomenon
+        - Self-light / phosphenes
+        - General / multiple effects
+        - Not sure
+    validations:
+      required: true
+
+  - type: textarea
+    id: what-is-wrong
+    attributes:
+      label: What is wrong or missing?
+      description: How does the shader differ from what you actually perceive?
+    validations:
+      required: true
+
+  - type: textarea
+    id: how-it-should-look
+    attributes:
+      label: How should it look?
+      description: Describe as specifically as you can — colour, speed, intensity, when it occurs, etc.
+
+  - type: textarea
+    id: source
+    attributes:
+      label: Source or reference (optional)
+      description: Clinical paper, patient forum thread, or personal experience — all are useful.
+
+  - type: dropdown
+    id: background
+    attributes:
+      label: Your background (optional)
+      options:
+        - I have VSS (diagnosed)
+        - I have VSS (undiagnosed / self-identified)
+        - I'm a clinician or researcher
+        - I know someone with VSS
+        - Other / prefer not to say

.github/ISSUE_TEMPLATE/iris-compat.yml

@@ -0,0 +1,53 @@
+name: Iris Compatibility Issue
+description: Shader doesn't load or behaves differently on a specific Iris / Minecraft version
+labels: ["iris-compat", "bug"]
+body:
+  - type: input
+    id: mc-version
+    attributes:
+      label: Minecraft version
+      placeholder: "e.g. 1.20.1"
+    validations:
+      required: true
+
+  - type: input
+    id: iris-version
+    attributes:
+      label: Iris version
+      placeholder: "e.g. 1.6.17"
+    validations:
+      required: true
+
+  - type: input
+    id: shader-version
+    attributes:
+      label: Shader version
+      placeholder: "e.g. 0.8.0"
+    validations:
+      required: true
+
+  - type: dropdown
+    id: symptom
+    attributes:
+      label: What goes wrong?
+      options:
+        - Shader fails to compile / red error screen
+        - Effect looks different than on other versions
+        - Game crashes on shader load
+        - Shader loads but world geometry is wrong
+        - Other
+    validations:
+      required: true
+
+  - type: textarea
+    id: description
+    attributes:
+      label: Description
+    validations:
+      required: true
+
+  - type: textarea
+    id: log
+    attributes:
+      label: Relevant log output
+      render: text

.github/ISSUE_TEMPLATE/symptom-request.yml

@@ -0,0 +1,55 @@
+name: New Symptom / Feature Suggestion
+description: Suggest a new VSS effect or an improvement to an existing one
+labels: ["enhancement"]
+body:
+  - type: dropdown
+    id: request-type
+    attributes:
+      label: What kind of request?
+      options:
+        - New VSS symptom
+        - Adjust an existing effect (intensity, behavior, default)
+        - New profile
+        - UX / accessibility improvement
+        - Other
+    validations:
+      required: true
+
+  - type: textarea
+    id: description
+    attributes:
+      label: What are you proposing?
+      description: Describe the effect or change as concretely as possible.
+    validations:
+      required: true
+
+  - type: textarea
+    id: clinical-source
+    attributes:
+      label: Clinical source (required for new symptoms)
+      description: |
+        Link a peer-reviewed paper or PubMed entry. The shader only simulates
+        documented symptoms — we don't add effects without a source.
+      placeholder: |
+        Study: …
+        DOI / PubMed: …
+        Prevalence among VSS patients: …
+        How it looks perceptually: …
+
+  - type: textarea
+    id: lived-experience
+    attributes:
+      label: Personal experience (optional)
+      description: |
+        If you have VSS or suspect you have it, describing what you actually
+        see is valuable — even without a clinical source. It helps us tune
+        defaults to something realistic.
+
+  - type: checkboxes
+    id: willing
+    attributes:
+      label: Willing to help?
+      options:
+        - label: I'd like to open a PR for this myself
+        - label: I can help with testing
+        - label: Suggestion only