diff --git a/.github/ISSUE_TEMPLATE/bug_report.yml b/.github/ISSUE_TEMPLATE/bug_report.yml new file mode 100644 index 0000000..d5e0f3e --- /dev/null +++ b/.github/ISSUE_TEMPLATE/bug_report.yml @@ -0,0 +1,88 @@ +name: Bug report +description: Report reproducible incorrect behavior in linear-axi +title: 'bug: ' +labels: + - bug +body: + - type: markdown + attributes: + value: | + Thank you for helping improve linear-axi. Never include a Linear API key or other credential. + + - type: textarea + id: summary + attributes: + label: Summary + description: What went wrong, and what operation were you trying to perform? + placeholder: A concise description of the failure. + validations: + required: true + + - type: textarea + id: reproduce + attributes: + label: Reproduction + description: Provide the smallest sequence that reliably demonstrates the problem. + placeholder: | + 1. Run `linear-axi ...` + 2. Observe ... + validations: + required: true + + - type: textarea + id: expected + attributes: + label: Expected behavior + placeholder: What should have happened? + validations: + required: true + + - type: textarea + id: actual + attributes: + label: Actual behavior + description: Include structured output or an error message after removing credentials and private workspace data. + render: shell + validations: + required: true + + - type: input + id: version + attributes: + label: linear-axi version + description: Output from `linear-axi --version`. + placeholder: 0.1.0 + validations: + required: true + + - type: dropdown + id: install + attributes: + label: Installation method + options: + - npm global install + - npx + - Nix or Home Manager + - Source checkout + - Other + validations: + required: true + + - type: input + id: environment + attributes: + label: Environment + description: Operating system, architecture, and Node.js version. + placeholder: macOS 15, arm64, Node 24.6.0 + validations: + required: true + + - type: checkboxes + id: checks + attributes: + label: Safety checks + options: + - label: I removed API keys, tokens, private issue content, and personal data from this report. + required: true + - label: I searched existing issues for the same behavior. + required: true diff --git a/.github/ISSUE_TEMPLATE/config.yml b/.github/ISSUE_TEMPLATE/config.yml new file mode 100644 index 0000000..51ada88 --- /dev/null +++ b/.github/ISSUE_TEMPLATE/config.yml @@ -0,0 +1,5 @@ +blank_issues_enabled: false +contact_links: + - name: Report a security vulnerability + url: https://github.com/apexcloudwise/linear-axi/security/advisories/new + about: Privately report vulnerabilities, exposed credentials, or sensitive data. diff --git a/.github/ISSUE_TEMPLATE/engineering_task.yml b/.github/ISSUE_TEMPLATE/engineering_task.yml new file mode 100644 index 0000000..27f6638 --- /dev/null +++ b/.github/ISSUE_TEMPLATE/engineering_task.yml @@ -0,0 +1,77 @@ +name: Engineering task +description: Define bounded maintenance, release, CI, or documentation work +title: 'chore: ' +body: + - type: markdown + attributes: + value: | + Use this form for work with a concrete outcome, bounded scope, and independently verifiable completion criteria. + + - type: textarea + id: outcome + attributes: + label: Outcome + description: What repository state or operational capability should exist when this is complete? + validations: + required: true + + - type: input + id: parent + attributes: + label: Parent or related issue + description: Link an epic, dependency, or related issue when one exists. + placeholder: '#1' + + - type: textarea + id: context + attributes: + label: Context + description: Record the present state, evidence, and reason the work is needed. + validations: + required: true + + - type: textarea + id: scope + attributes: + label: Scope + description: List the changes included in this task. + placeholder: | + - ... + - ... + validations: + required: true + + - type: textarea + id: boundaries + attributes: + label: Boundaries + description: State exclusions, owner-operated steps, or actions that must remain manual. + + - type: textarea + id: acceptance + attributes: + label: Acceptance criteria + description: Use checkboxes for observable and testable completion conditions. + placeholder: | + - [ ] ... + - [ ] ... + validations: + required: true + + - type: textarea + id: verification + attributes: + label: Verification plan + description: Identify the commands, CI jobs, or owner-operated evidence required. + validations: + required: true + + - type: checkboxes + id: safety + attributes: + label: Safety + options: + - label: This task does not include credentials or private Linear data. + required: true + - label: Destructive or outward-facing actions are explicitly identified above. + required: true diff --git a/.github/ISSUE_TEMPLATE/feature_request.yml b/.github/ISSUE_TEMPLATE/feature_request.yml new file mode 100644 index 0000000..4b3ea1e --- /dev/null +++ b/.github/ISSUE_TEMPLATE/feature_request.yml @@ -0,0 +1,74 @@ +name: Feature request +description: Propose a user-facing capability or behavior change +title: 'feat: ' +labels: + - enhancement +body: + - type: markdown + attributes: + value: | + Describe the outcome before the implementation. AXI changes should remain concise, deterministic, and agent-friendly. + + - type: textarea + id: problem + attributes: + label: Problem + description: What workflow is difficult or impossible today, and who encounters it? + validations: + required: true + + - type: textarea + id: outcome + attributes: + label: Desired outcome + description: Describe observable behavior rather than a preferred implementation. + validations: + required: true + + - type: textarea + id: interface + attributes: + label: Proposed CLI interface + description: Show representative commands and compact output, if known. + render: shell + + - type: textarea + id: scope + attributes: + label: Scope and boundaries + description: State what belongs in this change and what explicitly does not. + validations: + required: true + + - type: textarea + id: acceptance + attributes: + label: Acceptance criteria + description: List concrete conditions that would demonstrate completion. + placeholder: | + - [ ] ... + - [ ] ... + validations: + required: true + + - type: textarea + id: alternatives + attributes: + label: Alternatives considered + description: Include existing commands, GraphQL, or composition options that were considered. + + - type: textarea + id: risks + attributes: + label: Compatibility and safety + description: Note authentication, mutation, output-schema, token-cost, or backward-compatibility implications. + + - type: checkboxes + id: checks + attributes: + label: Checks + options: + - label: I searched existing issues for this request. + required: true + - label: This report contains no API keys, tokens, or private Linear data. + required: true