Add Procedural Puzzle Generation Module

[Mkalbani]

Description

Implement a generator module that procedurally generates logic puzzles at runtime based on configurable parameters — difficulty, category, and chain depth. This ensures the game never runs out of content and allows daily challenge modes with fresh puzzles every session. Generated puzzles are validated through the logic module before being offered to the player, guaranteeing they are solvable.

Acceptance Criteria

• A generator module exists at src/generator/mod.rs
• generate(difficulty, category, seed) returns a valid Puzzle struct
• The seed parameter makes generation deterministic — same seed always produces the same puzzle
• Generated puzzles pass through the logic evaluator to confirm they have at least one valid solution
• Difficulty controls chain length and the number of red-herring conditions included
• A --daily-challenge CLI flag generates and launches a seeded puzzle based on the current date
• Generated puzzles can be exported to the standard puzzle JSON format for admin review and promotion
• Unit tests cover determinism, solvability validation, difficulty scaling, and export format correctness

[Menjay7]

Hi! I came across this issue and would love to work on it. I have experience with similar tasks and I'm confident I can investigate, implement a clean solution, and thoroughly test it before submitting a PR. If the issue is still open, I would appreciate it if you could assign it to me. Thank you!

[Truphile]

Hi team, I’d love to take this on!

I am a software engineer experienced in procedural generation engines, deterministic seed-based state machines, and algorithmic constraints validation. I am ready to implement this runtime logic puzzle generator.

I will deliver:

Procedural Engine (src/generator/mod.rs): Implement the core generator utilizing a seeded random number generator (rand_chacha) to ensure absolute determinism—producing identical puzzle structures for matching seed values.

Evaluator Validation & Difficulty Bounds: Route all generated structures through the internal logic evaluator before delivery to guarantee solvability. Difficulty parameters will scale linearly, controlling clue chain depth and the injection density of red-herring conditions.

Daily Challenge CLI Linkage: Wire up the --daily-challenge runtime flag to compute a deterministic seed based on the current calendar date, automatically serving a synchronized daily puzzle map across all client environments.

Export Utilities & Validation Suite: Provide JSON serialization endpoints to export generated sets for administrative curation, backed by comprehensive unit tests validating deterministic outputs, solvability loops, and format correctness.

Ready for assignment to drop a complete, robust PR immediately!

[mac-dubem]

I'd love to work on this issue. I can implement a deterministic puzzle generator with configurable difficulty, solvability validation, daily challenge support, JSON export, and comprehensive tests to ensure reliability and maintainability.

[Clement-coder]

Hi,

I’m a full-stack software and blockchain engineer with hands-on experience delivering production-ready solutions across frontend, backend, and blockchain systems.

I’d like to take ownership of this issue. I’ve reviewed the requirements and can implement a scalable, maintainable, and well-tested solution that fully satisfies the acceptance criteria.

Ready to start immediately and keep the team updated throughout the process.

[grantfox-oss]

🦊 GrantFox — @Truphile has been assigned to this issue as part of the Official Campaign | FWC26 campaign!

Next steps:

1. Open a Pull Request referencing this issue (e.g., Closes #46)
2. Your PR will be reviewed by the MindFlowInteractive maintainers

Good luck! Track your progress on GrantFox.