spigot-stealth/design/user-stories/us-006-build-test-and-release.md

type, title, description, status

type	title	description	status
User Story	US-006: Build, test, and release the plugin	Give maintainers repeatable builds, automated verification, and versioned Gitea releases.	backlog

US-006: Build, test, and release the plugin

As a plugin maintainer, I want automated builds and releases modeled on Spigot Tyrant so that tested, correctly versioned artifacts can be distributed consistently.

Acceptance criteria

• The Gradle Kotlin DSL project compiles against Spigot API 26.2-R0.1-SNAPSHOT using a Java 17 toolchain.
• Compiler lint warnings fail the build.
• Automated JUnit 5 and Mockito tests run as part of the Gradle check lifecycle.
• Pushes and pull requests build and test the plugin in Gitea Actions.
• Pull requests validate conventional commit messages.
• CI stores a spigot-stealth development JAR as a workflow artifact.
• Main-branch conventional commits drive semantic versioning.
• A successful release builds a versioned JAR and attaches it to the corresponding Gitea release.
• Build files, Gradle wrapper, workflows, and release behavior follow ../spigot-tyrant/ where applicable while using Spigot Stealth names and identifiers.
• OKF validation using okf-base.yaml runs locally through the repository validation script and in CI.

Related

• Configure and persist stealth progression