chore(github): create issue templates

.github/ISSUE_TEMPLATE/bug_report.yml

@@ -0,0 +1,151 @@
+name: Bug Report
+description: Report a bug or unexpected behavior in libcuid2
+title: "[Bug]: "
+labels: ["Issue: Pending Confirmation"]
+body:
+  - type: markdown
+    attributes:
+      value: |
+        Thanks for taking the time to report a bug! Please fill out the form below with as much detail as possible.
+
+  - type: textarea
+    id: description
+    attributes:
+      label: Bug Description
+      description: A clear and concise description of what the bug is.
+      placeholder: Describe the bug...
+    validations:
+      required: true
+
+  - type: textarea
+    id: reproduction
+    attributes:
+      label: Steps to Reproduce
+      description: Steps to reproduce the behavior
+      placeholder: |
+        1. Build the project with...
+        2. Run the command...
+        3. Call the function...
+        4. See error...
+    validations:
+      required: true
+
+  - type: textarea
+    id: expected
+    attributes:
+      label: Expected Behavior
+      description: What did you expect to happen?
+      placeholder: Describe what you expected...
+    validations:
+      required: true
+
+  - type: textarea
+    id: actual
+    attributes:
+      label: Actual Behavior
+      description: What actually happened?
+      placeholder: Describe what actually happened...
+    validations:
+      required: true
+
+  - type: dropdown
+    id: platform
+    attributes:
+      label: Platform
+      description: Which platform(s) are you experiencing this issue on?
+      multiple: true
+      options:
+        - macOS (Apple Silicon / ARM64)
+        - macOS (Intel / x86_64)
+        - Linux (x86_64)
+        - Linux (ARM64)
+        - FreeBSD (x86_64)
+        - FreeBSD (ARM64)
+        - OpenBSD (x86_64)
+        - OpenBSD (ARM64)
+        - NetBSD (x86_64)
+        - NetBSD (ARM64)
+        - Windows (x64)
+        - Windows (ARM64)
+    validations:
+      required: true
+
+  - type: input
+    id: os-version
+    attributes:
+      label: OS Version
+      description: What version of the operating system are you using?
+      placeholder: e.g., macOS 14.2, Ubuntu 22.04, Windows 11
+    validations:
+      required: true
+
+  - type: input
+    id: compiler
+    attributes:
+      label: Compiler & Version
+      description: Which compiler and version are you using?
+      placeholder: e.g., Clang 15.0, GCC 12.2, MSVC 19.35
+    validations:
+      required: true
+
+  - type: input
+    id: cmake-version
+    attributes:
+      label: CMake Version
+      description: What version of CMake are you using?
+      placeholder: e.g., 3.28.1
+    validations:
+      required: true
+
+  - type: dropdown
+    id: build-type
+    attributes:
+      label: Build Type
+      description: Which build configuration exhibits the issue?
+      options:
+        - Debug
+        - Release
+        - Both
+    validations:
+      required: true
+
+  - type: textarea
+    id: code-sample
+    attributes:
+      label: Code Sample
+      description: If applicable, provide a minimal code sample that reproduces the issue
+      render: cpp
+      placeholder: |
+        #include <cuid2/cuid2.hpp>
+
+        int main() {
+            // Your code here
+        }
+
+  - type: textarea
+    id: build-output
+    attributes:
+      label: Build/Runtime Output
+      description: Paste any relevant build errors, compiler warnings, or runtime output
+      render: shell
+      placeholder: Paste output here...
+
+  - type: textarea
+    id: additional-context
+    attributes:
+      label: Additional Context
+      description: Add any other context about the problem (stack traces, logs, etc.)
+      placeholder: Any additional information...
+
+  - type: checkboxes
+    id: checklist
+    attributes:
+      label: Pre-submission Checklist
+      description: Please verify the following before submitting
+      options:
+        - label: I have searched existing issues to ensure this is not a duplicate
+          required: true
+        - label: I have provided all required information above
+          required: true
+        - label: I have tested with the latest version of libcuid2
+          required: false

.github/ISSUE_TEMPLATE/build_issue.yml

@@ -0,0 +1,177 @@
+name: Build/Installation Issue
+description: Report problems building or installing libcuid2
+title: "[Build]: "
+labels: ["Issue: Pending Confirmation"]
+body:
+  - type: markdown
+    attributes:
+      value: |
+        Having trouble building or installing libcuid2? Please provide the details below.
+
+  - type: textarea
+    id: description
+    attributes:
+      label: Issue Description
+      description: Describe the build or installation problem you're experiencing
+      placeholder: Describe the issue...
+    validations:
+      required: true
+
+  - type: dropdown
+    id: build-stage
+    attributes:
+      label: Build Stage
+      description: At what stage does the issue occur?
+      options:
+        - CMake Configuration
+        - Dependency Installation (vcpkg)
+        - Compilation
+        - Linking
+        - Installation (make install)
+        - Package Installation (DEB/RPM)
+        - Other
+    validations:
+      required: true
+
+  - type: dropdown
+    id: platform
+    attributes:
+      label: Platform
+      description: Which platform are you building on?
+      options:
+        - macOS (Apple Silicon / ARM64)
+        - macOS (Intel / x86_64)
+        - Linux (x86_64)
+        - Linux (ARM64)
+        - FreeBSD (x86_64)
+        - FreeBSD (ARM64)
+        - OpenBSD (x86_64)
+        - OpenBSD (ARM64)
+        - NetBSD (x86_64)
+        - NetBSD (ARM64)
+        - Windows (x64)
+        - Windows (ARM64)
+    validations:
+      required: true
+
+  - type: input
+    id: os-version
+    attributes:
+      label: OS Version
+      description: What version of the operating system?
+      placeholder: e.g., macOS 14.2, Ubuntu 22.04, Windows 11
+    validations:
+      required: true
+
+  - type: input
+    id: compiler
+    attributes:
+      label: Compiler & Version
+      description: Which compiler are you using?
+      placeholder: e.g., Clang 15.0, GCC 12.2, MSVC 19.35, MinGW64 13.1
+    validations:
+      required: true
+
+  - type: input
+    id: cmake-version
+    attributes:
+      label: CMake Version
+      description: What version of CMake?
+      placeholder: e.g., 3.28.1
+    validations:
+      required: true
+
+  - type: textarea
+    id: build-commands
+    attributes:
+      label: Build Commands
+      description: What commands did you run?
+      render: shell
+      placeholder: |
+        cmake -B build-macos-arm64-debug -DCMAKE_BUILD_TYPE=Debug
+        cmake --build build-macos-arm64-debug
+    validations:
+      required: true
+
+  - type: textarea
+    id: error-output
+    attributes:
+      label: Error Output
+      description: Paste the complete error output
+      render: shell
+      placeholder: Paste error output here...
+    validations:
+      required: true
+
+  - type: textarea
+    id: cmake-output
+    attributes:
+      label: CMake Configuration Output
+      description: Paste the output from CMake configuration (if applicable)
+      render: shell
+      placeholder: Paste CMake output here...
+
+  - type: dropdown
+    id: dependencies
+    attributes:
+      label: System Dependencies
+      description: Have you installed system dependencies as documented?
+      options:
+        - "Yes - Followed platform-specific instructions"
+        - "No - Used vcpkg only"
+        - "Unsure"
+        - "Not applicable (Windows)"
+    validations:
+      required: true
+
+  - type: textarea
+    id: dependency-versions
+    attributes:
+      label: Dependency Versions
+      description: What versions of system dependencies do you have installed?
+      placeholder: |
+        OpenSSL: 3.2.0
+        Boost: 1.83.0
+        fmt: 10.1.1
+      render: shell
+
+  - type: dropdown
+    id: build-preset
+    attributes:
+      label: Using CMake Presets?
+      description: Are you using CMake presets or manual configuration?
+      options:
+        - CMake Presets
+        - Manual Configuration
+    validations:
+      required: true
+
+  - type: textarea
+    id: cmake-cache
+    attributes:
+      label: CMake Cache (if relevant)
+      description: Output of `cmake -LA -N <build-dir>` may help diagnose issues
+      render: shell
+      placeholder: Paste CMake cache variables here...
+
+  - type: textarea
+    id: additional-context
+    attributes:
+      label: Additional Context
+      description: Any other relevant information (environment variables, custom toolchains, etc.)
+      placeholder: Any additional information...
+
+  - type: checkboxes
+    id: checklist
+    attributes:
+      label: Pre-submission Checklist
+      description: Please verify the following
+      options:
+        - label: I have reviewed the build instructions in CLAUDE.md
+          required: true
+        - label: I have installed platform-specific system dependencies (non-Windows)
+          required: false
+        - label: I have verified my CMake version is 3.22 or newer
+          required: true
+        - label: I have searched existing issues for similar build problems
+          required: true

.github/ISSUE_TEMPLATE/config.yml

@@ -0,0 +1,11 @@
+blank_issues_enabled: false
+contact_links:
+  - name: Security Vulnerability
+    url: https://github.com/visus-io/libcuid2/security/advisories/new
+    about: Please report security vulnerabilities through GitHub Security Advisories (not public issues)
+  - name: Discussions
+    url: https://github.com/visus-io/libcuid2/discussions
+    about: For general discussions, ideas, or community support
+  - name: Code of Conduct
+    url: https://github.com/visus-io/libcuid2/blob/main/CODE_OF_CONDUCT.md
+    about: Review our community guidelines (Contributor Covenant 3.0)