spigot-stealth/design/log.md

Spigot Stealth Design Log

2026-09-04

• Completion: Extended US-003 and US-004 with contextual, prefix-filtered command completion that suppresses generic player suggestions, plus an administrative list of all known online and offline unlocked players; verified the complete Gradle build and OKF bundle.

2026-08-14

• Completion: Completed US-004 with exact known online and offline targeting, complete status, idempotent grants, confirmed resets, active concealment discovery, operator-default permissions, asynchronous persisted replies, and console audits; verified the full Gradle build.
• Implementation: Began US-004 with test-first exact offline targeting, grant/reset transitions, concealed-player listing, permissions, confirmation, and audit logging.
• Completion: Completed US-002 with single-use durable prepared logins, join-announcement suppression, ProtocolLib tab-only removal, scoreboard overhead-name suppression, visible physical entities, periodic observer refresh, respawn restoration, and disconnect or disable cleanup; verified the full Gradle build.
• Implementation: Began US-002 with test-first prepared-login consumption, session-scoped concealment, join suppression, tab removal, and overhead-name presentation.
• Completion: Completed US-003 with /stealth progress, live unsaved interval inclusion, configured target and remaining output, concise duration formatting, and unlocked usage guidance; verified the full Gradle build.
• Implementation: Began US-003 with player-facing progress command and human-readable duration tests.
• Completion: Completed US-001 with direct potion-drink effect attribution, monotonic elapsed-time accumulation, safe refresh and stop transitions, durable UUID progress, exact-once unlocking, and title plus chat presentation; verified the full Gradle build.
• Implementation: Began US-001 with monotonic-clock progression tests and potion-cause event attribution.
• Completion: Completed US-005 with validated eight-hour defaults and configurable messages, UUID-keyed immutable state, RFC 3339 timing metadata, safe invalid-record defaults, unknown-field preservation, atomic YAML replacement, periodic saves, and serialized off-thread persistence; verified the full Gradle build.
• Implementation: Began US-005 with test-first validated settings, UUID-keyed state, and defensive asynchronous persistence.
• Completion: Completed US-006 with a Java 17 Gradle build, strict compiler linting, Spigot API, JUnit 5, Mockito, plugin metadata, OKF validation, Gitea CI, conventional-commit checks, semantic releases, and versioned release assets; verified the full build and a 1.2.3 release JAR.
• Implementation: Began US-006 with a test-driven Java 17, Gradle, Spigot, OKF validation, and Gitea delivery foundation modeled on Spigot Tyrant.
• Creation: Established the OKF v0.1 product record for Spigot Stealth.
• Decision: Only invisibility from a potion the player directly drinks contributes to the default eight-hour unlock requirement.
• Decision: An unlocked player who disconnects while their qualifying potion effect remains active conceals their identity for the entirety of their next online session.
• Decision: Each concealed session requires a new qualifying potion and disconnect; concealment never carries automatically into another session.
• Decision: Concealed players remain physically visible but have no join announcement, tab-list entry, or overhead name tag for any player, including administrators.
• Decision: Administrators can inspect and manage online or offline progression and list currently concealed players.