From d04e98029b2aabd071ed670eede37c16bd66c96a Mon Sep 17 00:00:00 2001 From: Juan Sugg Date: Fri, 4 Sep 2026 21:06:54 -0300 Subject: [PATCH] docs: route security reports privately Keep vulnerability reports out of public issues and request sanitized doctor output for ordinary bugs. Leave blank issues enabled. --- .github/ISSUE_TEMPLATE/bug_report.md | 19 ++++++++++++++++--- .github/ISSUE_TEMPLATE/config.yml | 5 +++++ SECURITY.md | 2 ++ scripts/check-workflow-guards.sh | 7 +++++++ 4 files changed, 30 insertions(+), 3 deletions(-) create mode 100644 .github/ISSUE_TEMPLATE/config.yml diff --git a/.github/ISSUE_TEMPLATE/bug_report.md b/.github/ISSUE_TEMPLATE/bug_report.md index 2359a0c..60c05dc 100644 --- a/.github/ISSUE_TEMPLATE/bug_report.md +++ b/.github/ISSUE_TEMPLATE/bug_report.md @@ -4,6 +4,9 @@ about: Something broke or behaved differently from the docs labels: bug --- +For security problems, [send a private report](https://github.com/jsugg/atx/security/advisories/new) +instead of using this public form. + **What happened?** A clear description of the behavior you saw. @@ -20,8 +23,18 @@ Minimal steps, including the exact `atx` command: atx ... ``` -**Environment** +**Diagnostics** + +Run this command and paste its sanitized output: + +```console +atx doctor --json +``` + +Use the same `--state-dir` as the failing command, if you set one. +Remove credentials, environment values and private command output. +Redact paths or user names you don't want in a public issue. + +Include your OS version and `atx version` output too; doctor does not report them. -- OS and version: -- ATX version (`atx version`): - Session or durable mode: diff --git a/.github/ISSUE_TEMPLATE/config.yml b/.github/ISSUE_TEMPLATE/config.yml new file mode 100644 index 0000000..edaaf9e --- /dev/null +++ b/.github/ISSUE_TEMPLATE/config.yml @@ -0,0 +1,5 @@ +blank_issues_enabled: true +contact_links: + - name: Report a security problem privately + url: https://github.com/jsugg/atx/security/advisories/new + about: Send vulnerability reports privately, not in a public issue. diff --git a/SECURITY.md b/SECURITY.md index 396c332..c4c48f5 100644 --- a/SECURITY.md +++ b/SECURITY.md @@ -6,6 +6,8 @@ Please email `juanpedrosugg+github [at] gmail [dot] com` with a short reproducti and the affected version. Do not open a public issue for a vulnerability that could put someone's commands, environment, or local files at risk. +You can also [send a private report through GitHub](https://github.com/jsugg/atx/security/advisories/new). + There is no guaranteed response window yet; this is a one-person side-project. I will acknowledge a useful report as soon as I can and keep the reporter updated while checking it. diff --git a/scripts/check-workflow-guards.sh b/scripts/check-workflow-guards.sh index 23e30b7..182cb24 100755 --- a/scripts/check-workflow-guards.sh +++ b/scripts/check-workflow-guards.sh @@ -81,4 +81,11 @@ if grep -Fq -- '--no-verify' .github/workflows/publish-crates-io.yml; then exit 1 fi +require_literal .github/ISSUE_TEMPLATE/config.yml 'blank_issues_enabled: true' +require_literal .github/ISSUE_TEMPLATE/config.yml ' url: https://github.com/jsugg/atx/security/advisories/new' +require_literal .github/ISSUE_TEMPLATE/bug_report.md 'atx doctor --json' +require_literal .github/ISSUE_TEMPLATE/bug_report.md 'Remove credentials, environment values and private command output.' +require_literal .github/ISSUE_TEMPLATE/bug_report.md "Redact paths or user names you don't want in a public issue." +require_literal .github/ISSUE_TEMPLATE/bug_report.md "Include your OS version and \`atx version\` output too; doctor does not report them." + printf 'workflow-guards: PASS\n'