Skip to content
Merged
Show file tree
Hide file tree
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
88 changes: 88 additions & 0 deletions .github/ISSUE_TEMPLATE/bug_report.yml
Original file line number Diff line number Diff line change
@@ -0,0 +1,88 @@
name: Bug report
description: Report a reproducible problem in rationguard
title: "bug: "
labels: ["bug"]
body:
- type: markdown
attributes:
value: |
Thanks for reporting a problem. If rationguard flagged text that is not an excuse, or missed one
that is, use the **Excuse pattern report** form instead.
Redact tokens and private data from any output you paste.
- type: input
id: version
attributes:
label: rationguard version
description: Output of `npm ls -g @hivecommons/rationguard` (or the version in your project's lockfile).
placeholder: "0.13.0"
validations:
required: true
- type: input
id: environment
attributes:
label: Environment
description: Operating system, `node --version` (rationguard requires Node.js 20 or newer), and the pluk and `tmux -V` versions if you used `attach` or `watch`.
placeholder: "macOS 15, Node v22.11.0, pluk 0.10.0, tmux 3.5a"
validations:
required: true
- type: dropdown
id: command
attributes:
label: Command
description: Which rationguard command shows the problem?
options:
- attach
- watch
- check
- sessions
- prompt
- add
- list
- sightings
- library API (import from @hivecommons/rationguard)
- other
validations:
required: true
- type: dropdown
id: cli
attributes:
label: Agent CLI (`--cli`)
options:
- claude
- copilot
- gemini
- goose
- codex
- custom `--command`
- not applicable
validations:
required: true
- type: textarea
id: reproduce
attributes:
label: Steps to reproduce
description: The exact commands you ran, including flags.
placeholder: |
1. rationguard attach my-agent --cli=claude --rebuttal=send
2. ...
validations:
required: true
- type: textarea
id: expected
attributes:
label: Expected behavior
validations:
required: true
- type: textarea
id: actual
attributes:
label: Actual behavior
description: What happened instead, including any stderr output.
validations:
required: true
- type: textarea
id: logs
attributes:
label: Output or logs
description: Relevant output, for example from `--verbose` or `--json`.
render: shell
11 changes: 11 additions & 0 deletions .github/ISSUE_TEMPLATE/config.yml
Original file line number Diff line number Diff line change
@@ -0,0 +1,11 @@
blank_issues_enabled: true
contact_links:
- name: Report a security vulnerability
url: https://github.com/hivecommons/rationguard/blob/main/SECURITY.md
about: Please do not file vulnerabilities as public issues. Follow SECURITY.md instead.
- name: Join our Discord
url: https://hivecommons.dev/discord
about: Ask setup, contributor, and community questions in the Hive Commons Discord.
- name: Propose a project to join Hive Commons
url: https://github.com/hivecommons/.github/issues/new?template=join-hive-commons.yml
about: Project proposals for the Hive Commons family are handled in the hivecommons/.github repository.
64 changes: 64 additions & 0 deletions .github/ISSUE_TEMPLATE/excuse_pattern.yml
Original file line number Diff line number Diff line change
@@ -0,0 +1,64 @@
name: Excuse pattern report
description: rationguard flagged text that is not an excuse, missed one that is, or you want to propose a new default excuse
title: "patterns: "
labels: ["enhancement"]
body:
- type: markdown
attributes:
value: |
rationguard sorts excuses into five categories; see
[The 5 Excuse Categories](https://github.com/hivecommons/rationguard#the-5-excuse-categories) in the README.
You can record a local excuse with `rationguard add` while this is discussed
(see [Auto-Learning](https://github.com/hivecommons/rationguard#auto-learning)).
Redact tokens and private data from any agent output you paste.
- type: dropdown
id: kind
attributes:
label: Report type
options:
- False positive (text was flagged but is not an excuse)
- Missed excuse (an excuse was not flagged)
- New default excuse proposal
validations:
required: true
- type: input
id: version
attributes:
label: rationguard version
description: Output of `npm ls -g @hivecommons/rationguard`.
validations:
required: true
- type: textarea
id: text
attributes:
label: Agent text
description: The exact text that was (or should have been) flagged.
render: text
validations:
required: true
- type: textarea
id: check-output
attributes:
label: "`rationguard check --json` output"
description: The result of running `rationguard check --json` on the text above.
render: json
validations:
required: true
- type: dropdown
id: category
attributes:
label: Expected category
options:
- false-completion
- complexity-dodge
- deferral
- lane-confusion
- partial-credit
- none (should not match)
validations:
required: true
- type: textarea
id: rebuttal
attributes:
label: Proposed pattern or rebuttal (optional)
description: For a missed or new excuse, the phrase to match and the rebuttal the agent should receive.
29 changes: 29 additions & 0 deletions .github/ISSUE_TEMPLATE/feature_request.yml
Original file line number Diff line number Diff line change
@@ -0,0 +1,29 @@
name: Feature request
description: Suggest an improvement or new capability for rationguard
title: "feature: "
labels: ["enhancement"]
body:
- type: textarea
id: use-case
attributes:
label: Use case
description: What problem are you trying to solve, and who is affected?
validations:
required: true
- type: textarea
id: proposal
attributes:
label: Proposed solution
description: The command, flag, output format, or library API change you want.
validations:
required: true
- type: textarea
id: alternatives
attributes:
label: Alternatives considered
description: Workarounds or other designs you have considered.
- type: textarea
id: compatibility
attributes:
label: Compatibility
description: Would this change existing flags, `--json` output, the `~/.rationguard/` store format, or the library API?
Loading