Refine Naming Generator Epic

.beans/nuzlocke-tracker-c6ly--build-name-suggestion-engine.md

@@ -0,0 +1,28 @@
+---
+# nuzlocke-tracker-c6ly
+title: Build name suggestion engine
+status: todo
+type: task
+priority: normal
+created_at: 2026-02-11T15:56:44Z
+updated_at: 2026-02-11T15:56:48Z
+parent: nuzlocke-tracker-igl3
+blocking:
+    - nuzlocke-tracker-bi4e
+---
+
+Build the core logic that picks random name suggestions from the dictionary based on a selected naming scheme (category).
+
+## Requirements
+
+- Given a category and a list of already-used names in the run, return 5-10 unique suggestions
+- Suggestions must not include names already assigned to other Pokemon in the same run
+- Support regeneration (return a fresh batch, avoiding previously shown suggestions where possible)
+- Handle edge case where category is nearly exhausted gracefully (return fewer suggestions)
+
+## Checklist
+
+- [ ] Create a service/utility module for name suggestion logic
+- [ ] Implement random selection from a category with exclusion of used names
+- [ ] Implement regeneration that avoids repeating previous suggestions
+- [ ] Add unit tests for the suggestion logic