feat(commands): manage height bounds with tab completion

2026-09-06 19:53:19 -04:00
parent fd601961eb
commit e802319f45
15 changed files with 484 additions and 10 deletions
@@ -6,6 +6,18 @@ description: Chronological record of material decisions affecting Spigot Heights

 # Spigot Heights Design Log

+## 2026-09-06T23:51:22Z — Settings commands completed
+
+- Added `/heights settings` and `/heights set min|max <value>` with `spigotheights.admin` (default op), generic sender support, and prefix-filtered tab completion of valid example values.
+- Validated changes are persisted through temporary-file replacement (atomic where supported) before activating shared live settings. Unrelated YAML values are preserved; malformed files and write failures do not activate new limits.
+- Updated gameplay listeners to read current settings without immediately resizing players or resetting launcher cooldowns.
+- Verified `./gradlew clean check jar`: all 26 tests passed. Inspected command registration and event wiring; live-server/client verification remains unperformed. Completed US-007 and the related US-004 change.
+
+## 2026-09-06T23:45:28Z — Settings commands approved and started
+
+- Approved [US-007](user-stories/us-007-manage-settings-commands.md): permission-protected min/max commands, tab completion, validation, and persistent live updates.
+- Existing players are not resized immediately; subsequent gameplay reads current limits. The exact `1.0` restoration exception remains intact.
+
 ## 2026-09-06T23:41:16Z — Restoration completed

 - Added the white Potion of Restoration with persistent identity and the approved Sugar upgrade recipe.