dmg/spigot-tree-feller
1
0
Fork 0
Code Issues Pull Requests Actions Packages Projects Releases 5 Wiki Activity

docs(design): define Tree Feller user stories

Browse Source
This commit is contained in:
dmg
2026-08-11 17:07:13 -04:00
commit de27d6519e
12 changed files with 333 additions and 0 deletions
Download Patch File Download Diff File Expand all files Collapse all files
design/user-stories/us-009-build-and-release-tree-feller.md
+32
View File
@@ -0,0 +1,32 @@
---
type: User Story
title: "US-009: Build and release Tree Feller"
description: Give maintainers repeatable Spigot builds, automated verification, and versioned Gitea releases.
status: backlog
---
# US-009: Build and release Tree Feller
As a **plugin maintainer**, I want automated builds and releases modeled on `spigot-getgud` so that tested, correctly versioned Tree Feller artifacts can be distributed consistently.
## Acceptance criteria
- [ ] The Gradle project compiles against Spigot API `26.2-R0.1-SNAPSHOT` using a Java 17 toolchain.
- [ ] Compiler lint warnings fail the build.
- [ ] Automated JUnit 5 tests run as part of the Gradle check lifecycle.
- [ ] Pushes and pull requests build and test Tree Feller in Gitea Actions.
- [ ] Pull requests validate conventional commit messages.
- [ ] CI stores a development Tree Feller JAR as a workflow artifact.
- [ ] Main-branch conventional commits drive semantic versioning.
- [ ] A successful release builds a versioned Tree Feller JAR and attaches it to the corresponding Gitea release.
- [ ] Build files, Gradle wrapper, workflows, release behavior, and Java dependency versions follow `../spigot-getgud/` where applicable while using Tree Feller names and identifiers.
- [ ] Plugin metadata declares the player and administrative command trees with separate permissions.
- [ ] The approved user-story bundle is committed before implementation begins.
- [ ] Subsequent implementation follows test-driven development where practical and keeps story statuses and acceptance criteria synchronized with verified behavior.
- [ ] No remote push is performed until the maintainer confirms that the Gitea repository and release token secret are ready.
## Related
- [US-007: Administer Tree Feller](us-007-administer-tree-feller.md)
- [US-008: Configure and persist Tree Feller](us-008-configure-and-persist-tree-feller.md)
- [User-story catalog](index.md)