[WIP] Update StarForgeV3 contract and security documentation

[Copilot]

Thanks for asking me to work on this. I will get started on it and keep this PR's description up to date as I form a plan and make progress.

Original prompt

The user has provided the source code for StarForgeV3.sol along with documentation (STARFORGE_V3_SECURITY_FIXES.md, STARFORGE_V3_TEST_PLAN.md, STARFORGE_V3_VALIDATION.md) that outlines comprehensive security fixes and improvements (Fixes #1 through #15).

Please update the repository with these files.

Files to Create/Update:

1. contracts/StarForgeV3.sol: Use the provided Solidity code which includes all 15 fixes.
2. STARFORGE_V3_SECURITY_FIXES.md: Use the provided markdown content.
3. STARFORGE_V3_TEST_PLAN.md: Use the provided markdown content.
4. STARFORGE_V3_VALIDATION.md: Use the provided markdown content.

Critical Analysis note to include in the PR description:
While the provided code implements the security fixes listed (solvency, VRF validation, etc.), there is a potential logic gap identified in revealGame:
The contract verifies that the revealed patternId and multiplier match the committed hash, but it DOES NOT appear to verify that the generated grid actually matches the patternId requirements for a non-jackpot win. Currently, it pays out the committed multiplier unconditionally if the hash matches. This requires immediate attention: either the pattern validation logic is missing, or it's intended to be handled differently (which would be highly unusual for a provably fair game).

Action:

• Commit the files as provided to apply the requested fixes.
• Highlight the missing pattern validation in the PR description as a "Reviewer Note".

This pull request was created from Copilot chat.

---

💬 We'd love your input! Share your thoughts on Copilot coding agent in our 2 minute survey.