Release v1.2.3

[miccy]

🎯 Release v1.2.3

Summary

Documentation restructuring, version consistency fixes, and comprehensive agent development guide.

---

✅ 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 (Q1 2025)

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

v2.0 (Q2 2025)

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

v3.0 (Q3 2025)

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

See the full roadmap for details.

---

This discussion was created from the release Release v1.2.3.