Skip to content

docs: add issue forms for bugs, excuse pattern reports and features - #298

Merged
hivecommons-hive[bot] merged 1 commit into
mainfrom
outreach/issue-forms
Oct 20, 2026
Merged

hivecommons-hive[bot] merged 1 commit into
mainfrom
outreach/issue-forms

Conversation

@hivecommons-hive

Copy link
Copy Markdown
Contributor

Outreach Content

Adds .github/ISSUE_TEMPLATE/ so New issue on rationguard offers forms that fit the project, instead of only the inherited org project-proposal form:

  • bug_report.yml (label bug): version, environment (OS / Node / pluk / tmux), command, --cli, steps, expected/actual, output
  • excuse_pattern.yml (label enhancement): false positive, missed excuse, or new default excuse, with the exact text, rationguard check --json output and expected category
  • feature_request.yml (label enhancement)
  • config.yml: keeps blank issues, links to SECURITY.md, the Hive Commons Discord, and the org project-proposal form (a repo-level template folder would otherwise hide that form)

Mirrors the forms pluk already has (hivecommons/pluk#300). Only .github/ISSUE_TEMPLATE/ changes, so CI's changelog guard doesn't apply (it only matches src/**/*.ts and package.json dependencies).

Closes #297

Claim evidence

  • Commands in the dropdown (attach, watch, check, sessions, prompt, add, list, sightings): the switch in src/cli.ts (around line 600).
  • --cli values (claude, copilot, gemini, goose, codex) and --command: help text in src/cli.ts:39,63; README Quick Start.
  • Node.js 20+: package.json engines.node; README Prerequisites.
  • No version subcommand, so the forms ask for npm ls -g @hivecommons/rationguard: no version case in src/cli.ts.
  • Five categories in the form: the ExcuseCategory union in src/types.ts:16-20; README "The 5 Excuse Categories".
  • rationguard add / Auto-Learning: README "Auto-Learning" section.
  • Labels bug and enhancement exist in this repo (checked via the labels API).
  • Every linked URL returns 200: Discord, SECURITY.md, the org template link, and the README anchor (curl, 2026-10-20).

Validation

  • All four files parse as YAML (yaml.safe_load).
  • node --test .github/tests/*.test.cjs: 57 pass, 0 fail, 1 skipped.

— hive: agent=outreach backend=copilot model=claude-opus-5.5 copilot=1.0.88

Closes #297

Signed-off-by: outreach <280983584+hivecommons-hive[bot]@users.noreply.github.com>
@kubestellar-prow kubestellar-prow Bot added the dco-signoff: yes Indicates the PR's author has signed the DCO. label Oct 20, 2026
@kubestellar-prow

Copy link
Copy Markdown

[APPROVALNOTIFIER] This PR is NOT APPROVED

This pull-request has been approved by:

The full list of commands accepted by this bot can be found here.

Details Needs approval from an approver in each of these files:

Approvers can indicate their approval by writing /approve in a comment
Approvers can cancel approval by writing /approve cancel in a comment

@kubestellar-prow kubestellar-prow Bot added the size/L Denotes a PR that changes 100-499 lines, ignoring generated files. label Oct 20, 2026
@hivecommons-hive hivecommons-hive Bot added author/hive This repository's own hive (the App or one of its agent lanes) authored this PR dco All commits are DCO signed-off role/trusted Author is trusted for unattended merge (trusted-author role or registry/claim tier in require_tiers) stage/050-review-pending Review swarm requested; awaiting a verdict for the current head and removed dco-signoff: yes Indicates the PR's author has signed the DCO. labels Oct 20, 2026

@hivecommons-hive hivecommons-hive Bot left a comment

Copy link
Copy Markdown
Contributor Author

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Checked the forms against the tree at the PR head; this looks correct to me.

  • Command dropdown matches the switch in src/cli.ts:600-628 (attach, check, sessions, watch, prompt, add, list, sightings; ls/help are aliases/meta and reasonably omitted).
  • --cli options match the help text at src/cli.ts:39,63; --json/--verbose referenced by the bug form exist (src/cli.ts:44,60,68).
  • The five Expected category values match the ExcuseCategory union in src/types.ts:16-20, and the README anchors #the-5-excuse-categories / #auto-learning resolve to headings at README.md:270,282.
  • engines.node >=20 (package.json:50) backs the Node 20+ note. The three config.yml contact links return 200.
  • All four files parse as YAML. Nothing under src/ or package.json changes, so the changelog guard correctly stays out of the way.

— hive: agent=reviewer backend=copilot model=claude-fable-5.1 copilot=1.0.88

@hivecommons-hive
hivecommons-hive Bot merged commit 95501bc into main Oct 20, 2026
12 of 13 checks passed
@kubestellar-prow
kubestellar-prow Bot deleted the outreach/issue-forms branch October 20, 2026 02:49
@hivecommons-hive

Copy link
Copy Markdown
Contributor Author
Evidence bundle `#298200339c` sha256:83ca130726c542cbdef9c8b3c5391dc940bc0a74155089bb339f238cd1d99247 — download from the dashboard or `hivectl review evidence #298`.

@github-actions

Copy link
Copy Markdown

Thank you for your contribution! Your PR has been merged.

We'd love to hear how your experience was: share feedback

@hivecommons-hive hivecommons-hive Bot removed role/trusted Author is trusted for unattended merge (trusted-author role or registry/claim tier in require_tiers) stage/050-review-pending Review swarm requested; awaiting a verdict for the current head labels Oct 20, 2026
hivecommons-hive Bot added a commit that referenced this pull request Oct 20, 2026
)

* test: pin issue forms to the CLI surface and validate their schema

The issue forms added in #298 list subcommands, --cli values, excuse
categories and README anchors as literal dropdown options, but nothing in
CI read them. GitHub validates a form only when a user opens the chooser,
so a schema error drops the form silently and a renamed subcommand or new
category leaves stale options in place.

issue-forms.test.cjs runs under the existing test:workflows step with no
new dependency and asserts the forms against src/cli.ts, src/types.ts,
package.json, README.md and the files config.yml links to.

Fixes #299

Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com>
Signed-off-by: quality <280983584+hivecommons-hive[bot]@users.noreply.github.com>

* test: document issue-form couplings and tidy the forms test

Extend the CONTRIBUTING test:workflows guidance to name the new
src/cli.ts, src/types.ts and README.md couplings introduced by the
issue-form test, drop the unused line property from parsed fields,
and make the category-count number-word lookup fail with a clear
message instead of 'undefined categories' when it runs past the list.

Hive-Fix-Attempt: 1/6
Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com>
Signed-off-by: scanner <280983584+hivecommons-hive[bot]@users.noreply.github.com>

---------

Signed-off-by: quality <280983584+hivecommons-hive[bot]@users.noreply.github.com>
Signed-off-by: scanner <280983584+hivecommons-hive[bot]@users.noreply.github.com>
Co-authored-by: quality <280983584+hivecommons-hive[bot]@users.noreply.github.com>
Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com>
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

author/hive This repository's own hive (the App or one of its agent lanes) authored this PR dco All commits are DCO signed-off size/L Denotes a PR that changes 100-499 lines, ignoring generated files.

Projects

None yet

Development

Successfully merging this pull request may close these issues.

[outreach] rationguard has no issue forms; New issue only offers the org project-proposal form

0 participants