Release v1.2.3

✅ What's Changed

📚 Documentation Enhancements

• Reorganized structure: Separated public docs (docs/) from private agent materials (.agents/)
• Merged roadmap: Combined detailed agent roadmap into public-facing docs/ROADMAP.md
• Enhanced AGENTS.md: Complete development guide for progressing from v1.2 → v3.0
  • Detailed tasks for v1.3 (GIF support), v2.0 (web platform), v3.0 (PvP mode)
  • Test/lint instructions and workflows
  • Progress tracking and versioning strategies
• Improved CLI README: Added common use cases and troubleshooting section
• Enhanced LICENSE: Clear attribution to Platane

🔢 Version Synchronization

• All packages bumped to v1.2.3
• Fixed CLI CHANGELOG (corrected from incorrect 1.3.0)
• Updated version references across codebase (API, workflows, contributing guide)

✅ Testing & Quality

• Updated CLI tests to reflect standalone bundle structure (no bundledDependencies)
• Fixed PvP regex test to match actual README format
• All 124 tests passing ✅
• Zero markdown linting errors ✅

🔧 Workflow Fixes

• Removed empty changeset file causing parse errors
• Updated example-snake.yml to create PR instead of direct push (complies with branch protection)
• Disabled Changesets automatic GitHub releases to prevent package-specific tags

📊 Stats

• Commits: 20+
• Tests: 124 pass, 0 fail
• Files changed: 30+
• Lines: +388 insertions, -697 deletions

📦 Installation

CLI (npm)

# Run directly with npx (no install needed)
npx @snake-evolution/cli@latest generate -u YOUR_USERNAME

# Or install globally
npm install -g @snake-evolution/cli@latest

GitHub Action

- uses: miccy/snake-evolution@v1.2.3
  with:
    github_user_name: ${{ github.repository_owner }}
    outputs: dist/snake.svg

Or use tracking tags for auto-updates:

- uses: miccy/snake-evolution@v1     # Latest v1.x
- uses: miccy/snake-evolution@v1.2   # Latest v1.2.x

🔗 Links

• Changelog: CHANGELOG.md
• Documentation: docs/ROADMAP.md
• npm Package: @snake-evolution/cli
• Full Changelog: v1.2.2...v1.2.3

🚀 What's Next?

v1.3

• GIF output format support
• Glass theme fully functional with blur effects
• Performance optimizations

v2.0

• Interactive web playground
• Astro site with React islands
• Community gallery

v3.0

• PvP multiplayer mode
• Real-time snake battles
• Leaderboards and challenges

---

🛠 Built by @miccy with 💙

© 2025 ownCTRL™