docs(design): complete initial harvest stories
Release / release (push) Successful in 4m14s
CI / build (push) Successful in 53s

This commit is contained in:
dmg
2026-08-14 18:27:09 -04:00
parent e0a9413cb2
commit d35c0197f5
9 changed files with 121 additions and 99 deletions
@@ -2,7 +2,7 @@
type: User Story
title: "US-005: View crop progress and notifications"
description: Give players command and boss-bar feedback about each crop's current progression.
status: in-progress
status: done
---
# US-005: View crop progress and notifications
@@ -11,20 +11,20 @@ As a **player**, I want to inspect crop progression and see recent progress upda
## Acceptance criteria
- [ ] `/harvest` and `/harvest status` display a concise summary of all supported crop paths and the player's current boss-bar preference.
- [ ] `/harvest status <crop>` displays that crop's earned level, current level-local progress, next requirement, and current and next operation caps.
- [ ] Level X status clearly reports that the crop path is complete.
- [ ] `/harvest bossbar enable` enables progress boss bars idempotently, and `/harvest bossbar disable` disables them idempotently.
- [ ] Boss bars are enabled by default.
- [ ] Disabling boss bars does not affect progression, unlock notifications, or command-based status display.
- [ ] Crop names and boss-bar modes are offered through autocomplete, and invalid or extra arguments show friendly usage guidance.
- [ ] Every qualifying manual or automated harvest updates a crop-specific progress boss bar for the initiating player when boss bars are enabled.
- [ ] Boss-bar text identifies the crop and accurately displays current level-local progress and its requirement.
- [ ] Boss-bar fill never falls below zero or exceeds 100 percent.
- [ ] The boss bar remains visible for a configurable duration after the latest progress update, defaulting to five seconds.
- [ ] A new qualifying update resets the boss bar's disappearance timer.
- [ ] Unlocking a crop level displays a prominent one-time notification identifying the crop, new level, and new operation cap.
- [ ] Unlock notifications do not repeat after reconnecting or restarting.
- [x] `/harvest` and `/harvest status` display a concise summary of all supported crop paths and the player's current boss-bar preference.
- [x] `/harvest status <crop>` displays that crop's earned level, current level-local progress, next requirement, and current and next operation caps.
- [x] Level X status clearly reports that the crop path is complete.
- [x] `/harvest bossbar enable` enables progress boss bars idempotently, and `/harvest bossbar disable` disables them idempotently.
- [x] Boss bars are enabled by default.
- [x] Disabling boss bars does not affect progression, unlock notifications, or command-based status display.
- [x] Crop names and boss-bar modes are offered through autocomplete, and invalid or extra arguments show friendly usage guidance.
- [x] Every qualifying manual or automated harvest updates a crop-specific progress boss bar for the initiating player when boss bars are enabled.
- [x] Boss-bar text identifies the crop and accurately displays current level-local progress and its requirement.
- [x] Boss-bar fill never falls below zero or exceeds 100 percent.
- [x] The boss bar remains visible for a configurable duration after the latest progress update, defaulting to five seconds.
- [x] A new qualifying update resets the boss bar's disappearance timer.
- [x] Unlocking a crop level displays a prominent one-time notification identifying the crop, new level, and new operation cap.
- [x] Unlock notifications do not repeat after reconnecting or restarting.
## Related