From 0ede353724655c372daf0619b9c7c26ce754c98b Mon Sep 17 00:00:00 2001
From: l0ng-ai <24760907+l0ng-ai@users.noreply.github.com>
Date: Thu, 10 Sep 2026 18:11:20 +0800
Subject: [PATCH] chore(issues): split the issue form into bug and idea
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

The single form was doing two jobs: three of its five fields carried a
"(bugs)" suffix because they made no sense for an idea, which also meant
nothing bug-specific could be required without blocking the idea path.

Two forms instead. The bug form requires steps to reproduce, the expected
behaviour, the version and the platform, and adds a log field rendered as
code so pasted escape sequences survive markdown. The idea form asks for
the problem before the solution. Both auto-label and both open with a
duplicate-search checkbox, so the type dropdown is gone — picking the form
is picking the type.

Blank issues are off, since they let a reporter walk past every required
field. The Discussions contact link is dropped as well: the repo has
discussions disabled, so it was a dead link.

Claude-Session: https://claude.ai/code/session_01XLMiHJR7RXvAGsR8S7jkHa
---
 .github/ISSUE_TEMPLATE/bug.yml    | 89 +++++++++++++++++++++++++++++++
 .github/ISSUE_TEMPLATE/config.yml |  5 +-
 .github/ISSUE_TEMPLATE/idea.yml   | 35 ++++++++++++
 .github/ISSUE_TEMPLATE/issue.yml  | 43 ---------------
 4 files changed, 125 insertions(+), 47 deletions(-)
 create mode 100644 .github/ISSUE_TEMPLATE/bug.yml
 create mode 100644 .github/ISSUE_TEMPLATE/idea.yml
 delete mode 100644 .github/ISSUE_TEMPLATE/issue.yml

diff --git a/.github/ISSUE_TEMPLATE/bug.yml b/.github/ISSUE_TEMPLATE/bug.yml
new file mode 100644
index 00000000..9fab6a16
--- /dev/null
+++ b/.github/ISSUE_TEMPLATE/bug.yml
@@ -0,0 +1,89 @@
+name: Bug report
+description: Something in tty7 doesn't work as expected
+labels: ["bug"]
+body:
+  - type: checkboxes
+    id: checks
+    attributes:
+      label: Before you file
+      options:
+        - label: I searched the existing issues and this isn't a duplicate.
+          required: true
+        - label: I'm on the latest tty7 release, or I've said below why I can't be.
+          required: true
+
+  - type: textarea
+    id: summary
+    attributes:
+      label: What happened?
+      description: The behaviour you saw, in a sentence or two.
+    validations:
+      required: true
+
+  - type: textarea
+    id: repro
+    attributes:
+      label: Steps to reproduce
+      description: >
+        Numbered steps starting from a freshly opened tty7 window. If a
+        specific command or escape sequence triggers it, paste the exact one —
+        "some TUI app" is rarely enough to reproduce a terminal bug.
+      placeholder: |
+        1. Open a new tab
+        2. Run `printf '\e[?2004h'`
+        3. Type a character — the pane freezes
+    validations:
+      required: true
+
+  - type: textarea
+    id: expected
+    attributes:
+      label: What did you expect instead?
+    validations:
+      required: true
+
+  - type: input
+    id: version
+    attributes:
+      label: tty7 version
+      description: Run `tty7 --version`, or check the About window.
+      placeholder: "26.9.2"
+    validations:
+      required: true
+
+  - type: dropdown
+    id: platform
+    attributes:
+      label: Platform
+      options:
+        - macOS (Apple Silicon)
+        - macOS (Intel)
+        - Windows
+        - Linux
+    validations:
+      required: true
+
+  - type: input
+    id: context
+    attributes:
+      label: Shell and TUI app involved
+      description: >
+        The shell you were running, and the TUI app plus its version if one is
+        on screen when it happens.
+      placeholder: fish 3.7.1, neovim 0.10.2
+
+  - type: textarea
+    id: logs
+    attributes:
+      label: Log output
+      description: >
+        The tail of `~/.config/tty7/tty7.log`
+        (`%APPDATA%\tty7\tty7.log` on Windows), if it has anything from around
+        the time it broke. This is rendered as code, so no backticks needed.
+      render: shell
+
+  - type: textarea
+    id: extra
+    attributes:
+      label: Anything else?
+      description: Screenshots, a recording, or anything else worth knowing.
diff --git a/.github/ISSUE_TEMPLATE/config.yml b/.github/ISSUE_TEMPLATE/config.yml
index bcbeb42f..62e78b3f 100644
--- a/.github/ISSUE_TEMPLATE/config.yml
+++ b/.github/ISSUE_TEMPLATE/config.yml
@@ -1,8 +1,5 @@
-blank_issues_enabled: true
+blank_issues_enabled: false
 contact_links:
-  - name: Questions & ideas
-    url: https://github.com/l0ng-ai/tty7/discussions
-    about: Not sure it's a bug? Want to discuss an idea first? Start a discussion.
   - name: Security vulnerabilities
     url: https://github.com/l0ng-ai/tty7/security/advisories/new
     about: Please report security issues privately, not as public issues.
diff --git a/.github/ISSUE_TEMPLATE/idea.yml b/.github/ISSUE_TEMPLATE/idea.yml
new file mode 100644
index 00000000..8424395b
--- /dev/null
+++ b/.github/ISSUE_TEMPLATE/idea.yml
@@ -0,0 +1,35 @@
+name: Idea
+description: Suggest an improvement or a new capability
+labels: ["enhancement"]
+body:
+  - type: checkboxes
+    id: checks
+    attributes:
+      label: Before you file
+      options:
+        - label: I searched the existing issues and this isn't already proposed.
+          required: true
+
+  - type: textarea
+    id: problem
+    attributes:
+      label: What's the problem?
+      description: >
+        What you were trying to do, and where tty7 got in the way. Leave the
+        solution for the next box — the problem is the part we can't guess.
+    validations:
+      required: true
+
+  - type: textarea
+    id: behaviour
+    attributes:
+      label: How should it behave?
+      description: The shape you have in mind, if you have one.
+
+  - type: textarea
+    id: prior_art
+    attributes:
+      label: Prior art and workarounds
+      description: >
+        How other terminals handle it, and what you're doing today to work
+        around it.
diff --git a/.github/ISSUE_TEMPLATE/issue.yml b/.github/ISSUE_TEMPLATE/issue.yml
deleted file mode 100644
index d32ab16a..00000000
--- a/.github/ISSUE_TEMPLATE/issue.yml
+++ /dev/null
@@ -1,43 +0,0 @@
-name: Issue
-description: Report a bug or suggest an improvement
-body:
-  - type: dropdown
-    id: kind
-    attributes:
-      label: Type
-      options:
-        - Bug — something doesn't work as expected
-        - Idea — suggest an improvement or new capability
-    validations:
-      required: true
-  - type: textarea
-    id: detail
-    attributes:
-      label: What's going on?
-      description: >
-        For a bug: what you did, what you saw, and what you expected instead.
-        For an idea: the problem it solves and how it should behave.
-    validations:
-      required: true
-  - type: input
-    id: version
-    attributes:
-      label: tty7 version (bugs)
-      placeholder: v0.2.0
-  - type: dropdown
-    id: platform
-    attributes:
-      label: Platform (bugs)
-      options:
-        - macOS (Apple Silicon)
-        - macOS (Intel)
-        - Windows
-        - Linux
-  - type: textarea
-    id: extra
-    attributes:
-      label: Anything else?
-      description: >
-        Screenshots or recordings, the exact command / escape sequence that
-        triggers it, the shell you were using, or the TUI app (vim, htop, …)
-        and its version if one is involved.