Skip to content
Open
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
58 changes: 58 additions & 0 deletions .github/ISSUE_TEMPLATE/bug_report.yml
Original file line number Diff line number Diff line change
@@ -0,0 +1,58 @@
name: Bug report
description: Report a reproducible bug in btca
labels:
- bug
body:
- type: markdown
attributes:
value: |
Thanks for the report. Please include complete reproduction details so maintainers can investigate quickly.
- type: input
id: btca_version
attributes:
label: btca version
description: Output of `btca --version`
placeholder: 1.2.3
validations:
required: true
- type: input
id: bun_version
attributes:
label: Bun version
placeholder: 1.x.x
validations:
required: true
- type: input
id: os
attributes:
label: OS and shell
placeholder: macOS 14 + zsh
validations:
required: true
- type: textarea
id: command
attributes:
label: Command(s) run
description: Include the exact command and flags
validations:
required: true
- type: textarea
id: expected
attributes:
label: Expected behavior
validations:
required: true
- type: textarea
id: actual
attributes:
label: Actual behavior and logs
description: Include complete error output
validations:
required: true
- type: textarea
id: repro
attributes:
label: Minimal reproduction
description: Include config/resource snippets as needed
validations:
required: true
5 changes: 5 additions & 0 deletions .github/ISSUE_TEMPLATE/config.yml
Original file line number Diff line number Diff line change
@@ -0,0 +1,5 @@
blank_issues_enabled: true
contact_links:
- name: Support and triage policy
url: https://github.com/davis7dotsh/better-context/blob/main/SUPPORT.md
about: Review support scope, priorities, and reproduction requirements.
30 changes: 30 additions & 0 deletions .github/ISSUE_TEMPLATE/feature_request.yml
Original file line number Diff line number Diff line change
@@ -0,0 +1,30 @@
name: Feature request
description: Suggest an improvement for btca
labels:
- enhancement
body:
- type: input
id: summary
attributes:
label: Summary
placeholder: Add support for ...
validations:
required: true
- type: textarea
id: problem
attributes:
label: Problem statement
description: What is difficult today?
validations:
required: true
- type: textarea
id: proposed
attributes:
label: Proposed solution
description: Describe expected behavior or API
validations:
required: true
- type: textarea
id: alternatives
attributes:
label: Alternatives considered
4 changes: 4 additions & 0 deletions README.md
Original file line number Diff line number Diff line change
Expand Up @@ -33,6 +33,10 @@ Set up btca for this project: scan package.json for major dependencies (framewor

See the full [Getting Started guide](https://docs.btca.dev/guides/quickstart) for more details.

## Support

Review [SUPPORT.md](./SUPPORT.md) for triage priorities, expected response targets, and bug report requirements.

## Development

This is a Bun monorepo using Turborepo. **Only use `bun`** - never npm/yarn.
Expand Down
41 changes: 41 additions & 0 deletions SUPPORT.md
Original file line number Diff line number Diff line change
@@ -0,0 +1,41 @@
# Support and Triage Policy

This document explains how btca issues are prioritized and what maintainers need in order to resolve reports quickly.

## Priorities

1. P0: security bugs, data loss, or complete service outage
2. P1: broken core workflows (`btca ask`, resource add/load, auth)
3. P2: degraded UX or edge-case correctness issues
4. P3: feature requests and polish

## Expected Response Targets

1. P0/P1: initial triage within 72 hours
2. P2/P3: initial triage as capacity allows

These are best-effort targets, not strict SLAs.

## What To Include in Bug Reports

1. Exact btca version (`btca --version`)
2. Runtime and OS (Bun version, platform, shell/terminal)
3. Full command you ran
4. Full error output and stack trace (if present)
5. Minimal reproducible config/resource example

## Duplicate and Related Issues

Maintainers may close issues as duplicates and link to a canonical tracking issue. This helps keep investigation and status updates in one place.

## Support Scope

1. Local CLI and server behavior
2. Cloud/sandbox integration behavior
3. Documentation and migration guidance

## Out of Scope for Immediate Triage

1. Unreproducible reports with no logs
2. Provider-side incidents with no btca regression
3. Product strategy requests without implementation details