- All gsdDir/gsdRoot/gsdHome → sfDir/sfRootDir/sfHome - GSDWorkspace* → SFWorkspace* interfaces - bootstrapGsdProject → bootstrapProject - runGSDDoctor → runSFDoctor - GsdClient → SfClient, gsd-client.ts → sf-client.ts - .gsd/ → .sf/ in all tests, docs, docker, native, vscode - Auto-migration: headless detects .gsd/ → renames to .sf/ - Deleted gsd-phase-state.ts backward-compat re-export - Renamed bin/gsd-from-source → bin/sf-from-source - Updated mintlify docs, github workflows, docker configs
155 lines
4.2 KiB
YAML
155 lines
4.2 KiB
YAML
name: Bug report
|
|
description: Report crashes, regressions, incorrect behavior, or broken workflows in SF.
|
|
title: "[Bug]: "
|
|
labels:
|
|
- bug
|
|
body:
|
|
- type: markdown
|
|
attributes:
|
|
value: |
|
|
Thanks for filing a bug report. Keep it concise, reproducible, and evidence-based.
|
|
|
|
- type: dropdown
|
|
id: bug_type
|
|
attributes:
|
|
label: Bug type
|
|
description: Choose the category that best matches this report.
|
|
options:
|
|
- Regression (worked before, now fails)
|
|
- Crash or hang
|
|
- Incorrect behavior or output
|
|
- Performance problem
|
|
- Documentation or UX problem
|
|
validations:
|
|
required: true
|
|
|
|
- type: textarea
|
|
id: summary
|
|
attributes:
|
|
label: Summary
|
|
description: One sentence describing what is broken.
|
|
placeholder: Running `/sf inspect` reports "No SF database available" even though `.sf/sf.db` exists.
|
|
validations:
|
|
required: true
|
|
|
|
- type: textarea
|
|
id: repro
|
|
attributes:
|
|
label: Steps to reproduce
|
|
description: Provide the shortest reliable repro path.
|
|
placeholder: |
|
|
1. Run `...`
|
|
2. Open `...`
|
|
3. Execute `/sf ...`
|
|
4. Observe the failure
|
|
validations:
|
|
required: true
|
|
|
|
- type: textarea
|
|
id: expected
|
|
attributes:
|
|
label: Expected behavior
|
|
description: What should happen if the bug does not exist?
|
|
placeholder: SF should open the existing database and continue.
|
|
validations:
|
|
required: true
|
|
|
|
- type: textarea
|
|
id: actual
|
|
attributes:
|
|
label: Actual behavior
|
|
description: What happened instead, including user-visible errors.
|
|
placeholder: SF exits the unit and shows an error message.
|
|
validations:
|
|
required: true
|
|
|
|
- type: input
|
|
id: sf_version
|
|
attributes:
|
|
label: SF version
|
|
description: Run `sf --version` and paste the exact version.
|
|
placeholder: "e.g. 2.33.1"
|
|
validations:
|
|
required: true
|
|
|
|
- type: input
|
|
id: node_version
|
|
attributes:
|
|
label: Node.js version
|
|
description: Run `node --version`.
|
|
placeholder: "e.g. v24.14.0"
|
|
|
|
- type: input
|
|
id: os
|
|
attributes:
|
|
label: Operating system
|
|
description: OS and version where this occurs.
|
|
placeholder: macOS 15.4 / Ubuntu 24.04 / Windows 11
|
|
validations:
|
|
required: true
|
|
|
|
- type: dropdown
|
|
id: install_method
|
|
attributes:
|
|
label: Install method
|
|
description: How are you running SF?
|
|
options:
|
|
- npm global install
|
|
- npm link / local checkout
|
|
- npx
|
|
- Docker
|
|
- Other
|
|
validations:
|
|
required: true
|
|
|
|
- type: dropdown
|
|
id: affected_area
|
|
attributes:
|
|
label: Affected area
|
|
description: Which part of SF seems involved?
|
|
options:
|
|
- Auto-mode / dispatch loop
|
|
- Planning / roadmap / milestones
|
|
- Slice or task execution
|
|
- Completion / validation
|
|
- State / persistence / database
|
|
- Git / worktree isolation
|
|
- CLI / slash commands
|
|
- AI provider / model integration
|
|
- MCP / tools / extensions
|
|
- TUI / terminal UI
|
|
- Documentation
|
|
- Other
|
|
validations:
|
|
required: true
|
|
|
|
- type: input
|
|
id: model
|
|
attributes:
|
|
label: Model and provider
|
|
description: If relevant, include the effective model/provider used for the failing run.
|
|
placeholder: anthropic/claude-opus-4-1, openai/gpt-5, ollama/qwen3
|
|
|
|
- type: textarea
|
|
id: logs
|
|
attributes:
|
|
label: Logs, screenshots, and evidence
|
|
description: Include redacted logs, screenshots, stack traces, or forensic output that prove the behavior. Do not include secrets.
|
|
render: shell
|
|
|
|
- type: textarea
|
|
id: impact
|
|
attributes:
|
|
label: Impact
|
|
description: Explain severity, frequency, and practical consequence.
|
|
placeholder: |
|
|
Severity: blocks milestone completion
|
|
Frequency: 100% repro
|
|
Consequence: finalization crashes even though artifacts were written
|
|
|
|
- type: textarea
|
|
id: additional_information
|
|
attributes:
|
|
label: Additional information
|
|
description: Extra context, workarounds, last known good version, related issues, or environment details.
|
|
placeholder: Last known good version was ..., temporary workaround is ...
|