first commit

.github/ISSUE_TEMPLATE/bug_report.yml

@@ -0,0 +1,131 @@
+name: Bug report
+description: Report a problem or regression in Bifrost
+title: "[Bug]: <short summary>"
+labels: [bug]
+assignees: []
+body:
+  - type: markdown
+    attributes:
+      value: |
+        Thanks for taking the time to fill out a bug report! Please provide as much detail as possible.
+
+  - type: checkboxes
+    id: prerequisites
+    attributes:
+      label: Prerequisites
+      options:
+        - label: I have searched existing issues and discussions to avoid duplicates
+          required: true
+        - label: I am using the latest version (or have tested against main/nightly)
+          required: false
+
+  - type: textarea
+    id: description
+    attributes:
+      label: Description
+      description: What happened? Include screenshots if helpful.
+      placeholder: Clear and concise description of the bug
+    validations:
+      required: true
+
+  - type: textarea
+    id: reproduction
+    attributes:
+      label: Steps to reproduce
+      description: Provide a minimal, reproducible example. Link to a repo, gist, or include exact steps.
+      placeholder: |
+        1. Go to '...'
+        2. Run '...'
+        3. Observe '...'
+    validations:
+      required: true
+
+  - type: input
+    id: expected
+    attributes:
+      label: Expected behavior
+      placeholder: What did you expect to happen?
+    validations:
+      required: true
+
+  - type: input
+    id: actual
+    attributes:
+      label: Actual behavior
+      placeholder: What actually happened?
+    validations:
+      required: true
+
+  - type: dropdown
+    id: area
+    attributes:
+      label: Affected area(s)
+      multiple: true
+      options:
+        - Core (Go)
+        - Framework
+        - Transports (HTTP)
+        - Plugins
+        - UI (React)
+        - Docs
+    validations:
+      required: true
+
+  - type: input
+    id: version
+    attributes:
+      label: Version
+      description: Affected version(s).
+      placeholder: e.g., v1.0.3 
+    validations:
+      required: true
+
+  - type: textarea
+    id: env
+    attributes:
+      label: Environment
+      description: Include as many as apply.
+      placeholder: |
+        - OS: macOS 14.5, Linux x.y, Windows 11
+        - Go: 1.22.x
+        - Node: 20.x, npm/pnpm/yarn version
+        - Browser (if UI): Chrome/Firefox/Safari versions
+        - Bifrost components and versions (core, transports, ui)
+        - Any relevant environment flags/config
+      render: text
+    validations:
+      required: false
+
+  - type: textarea
+    id: logs
+    attributes:
+      label: Relevant logs/output
+      description: Paste error logs, stack traces, or console output.
+      render: shell
+      placeholder: |
+        <paste logs here>
+    validations:
+      required: false
+
+  - type: input
+    id: regression
+    attributes:
+      label: Regression?
+      description: If this worked in a previous version, which version?
+      placeholder: e.g., Worked in v0.8.0, broke in v0.9.0
+    validations:
+      required: false
+
+  - type: dropdown
+    id: severity
+    attributes:
+      label: Severity
+      options:
+        - Low (minor issue or cosmetic)
+        - Medium (some functionality impaired)
+        - High (major functionality broken)
+        - Critical (blocks releases or production)
+    validations:
+      required: true
+
+

.github/ISSUE_TEMPLATE/config.yml

@@ -0,0 +1,2 @@
+blank_issues_enabled: false
+

.github/ISSUE_TEMPLATE/docs_issue.yml

@@ -0,0 +1,45 @@
+name: Documentation issue
+description: Report missing, unclear, or incorrect documentation
+title: "[Docs]: <short summary>"
+labels: [documentation]
+assignees: []
+body:
+  - type: markdown
+    attributes:
+      value: |
+        Help us improve the docs! Please provide links and suggestions.
+
+  - type: checkboxes
+    id: prerequisites
+    attributes:
+      label: Prerequisites
+      options:
+        - label: I have searched existing issues and docs to avoid duplicates
+          required: true
+
+  - type: input
+    id: page
+    attributes:
+      label: Affected page(s)
+      description: Provide the path or URL to the affected doc(s)
+      placeholder: docs/usage/providers.md or https://...
+    validations:
+      required: true
+
+  - type: textarea
+    id: issue
+    attributes:
+      label: What’s wrong or missing?
+      description: Be as specific as possible.
+    validations:
+      required: true
+
+  - type: textarea
+    id: suggestion
+    attributes:
+      label: Suggested change
+      description: Propose wording or structure improvements.
+    validations:
+      required: false
+
+

.github/ISSUE_TEMPLATE/feature_request.yml

@@ -0,0 +1,69 @@
+name: Feature request
+description: Suggest an idea or enhancement for Bifrost
+title: "[Feature]: <short summary>"
+labels: [enhancement]
+assignees: []
+body:
+  - type: markdown
+    attributes:
+      value: |
+        Thanks for proposing a feature! Please fill out the details below.
+
+  - type: checkboxes
+    id: prerequisites
+    attributes:
+      label: Prerequisites
+      options:
+        - label: I have searched existing issues and discussions to avoid duplicates
+          required: true
+
+  - type: textarea
+    id: problem
+    attributes:
+      label: Problem to solve
+      description: What problem does this feature solve? Who benefits?
+      placeholder: Describe the problem clearly.
+    validations:
+      required: true
+
+  - type: textarea
+    id: proposal
+    attributes:
+      label: Proposed solution
+      description: Describe your proposed API/UX/CLI. Include examples if helpful.
+      placeholder: Provide details about how this should work.
+    validations:
+      required: true
+
+  - type: textarea
+    id: alternatives
+    attributes:
+      label: Alternatives considered
+      description: What other solutions or workarounds did you consider?
+    validations:
+      required: false
+
+  - type: dropdown
+    id: area
+    attributes:
+      label: Area(s)
+      multiple: true
+      options:
+        - Core (Go)
+        - Framework
+        - Transports (HTTP)
+        - Plugins
+        - UI (React)
+        - Docs
+    validations:
+      required: true
+
+  - type: textarea
+    id: additional
+    attributes:
+      label: Additional context
+      description: Add any other context, sketches, or references here.
+    validations:
+      required: false
+
+