Full Changelog: v1.2.4...v1.3.0

What's Changed

• Ensure static SVG renders snake segments by @miccy in #18
• docs: align changelog dates and enforce format by @miccy in #13
• feat(ui): sanitize snake preview html by @miccy in #12
• Clarify GIF support and validate CLI formats by @miccy in #14
• Support multi-output invocation for GitHub Action by @miccy in #15
• Parse contribution counts from GitHub HTML by @miccy in #16
• Fix frame delay handling in renderer and CLI by @miccy in #17
• CodeRabbit Generated Unit Tests: Add 80+ comprehensive unit tests and documentation by @coderabbitai[bot] in #20
• Dev by @miccy in #19

Full Changelog: v1.2.3...v1.2.4

✅ 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/[email protected]
  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/[email protected]   # 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

✨ Features

• CypherPunk Theme - New cyberpunk-inspired color scheme with blue/magenta tones
• Improved pathfinding - Snake intelligently hunts high-value contributions
• Better error handling - Clearer error messages and validation

🐛 Bug Fixes

• Fixed Glass theme SVG rendering (now GIF-only)
• Improved theme color consistency
• Better handling of edge cases in contribution graph

🎨 Available Themes

• github-dark (default)
• github-light
• ocean
• sunset
• neon-gamer
• cypherpunk (new!)
• glass (GIF only, coming in v1.3)

📦 CLI Package

The CLI is available as a separate bun package:

bunx @snake-evolution/cli@latest generate -u YOUR_USERNAME

or npm:

npx @snake-evolution/cli@latest generate -u YOUR_USERNAME

See more at https://www.npmjs.com/package/@snake-evolution/cli

What's Changed

• feat: Increment all package versions to 1.1.0, upgrade Bun to 1.3.5, … by @miccy in #8

Full Changelog: v1...v1.1.0

🐍 Snake Evolution v1.0.0

Transform your GitHub contribution graph into an animated snake!

✨ Features

• 🎮 Smart Pathfinding - Snake hunts high-value contributions first
• 🐍 Growing Snake - Gets longer as it eats (1→17+ segments)
• 🎨 6 Themes - github-light, github-dark, ocean, sunset, neon-gamer, cypherpunk
• ⚡ Smooth SMIL Animations - No JavaScript, pure SVG
• 🤖 GitHub Action - Easy integration with any profile README

🚀 Quick Start

Add to your profile repo's .github/workflows/snake.yml:

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

🎨 Available Themes

🔜 Coming in v1.1

• 🎬 GIF output format
• 🧊 Glass theme (liquid glass effect)
• 📦 npm package (npx @snake-evolution/cli)

🙏 Credits

Original snake concept inspired by Platane.