glitchcraft/justfile

# GlitchCraft Development Commands
# Install just: https://github.com/casey/just

# Default recipe - show available commands
default:
    @just --list

# Development server management
# Start the development server
serve:
    python3 server.py

# Start server in background
serve-bg:
    python3 server.py &
    @echo "Server started in background"
    @echo "Use 'just stop' to stop it"

# Stop background server
stop:
    @echo "Stopping GlitchCraft server..."
    pkill -f "python.*server.py" || echo "No server process found"

# Code quality and linting
# Lint all JavaScript files
lint-js:
    bun run lint:js

# Lint and auto-fix JavaScript
fix-js:
    bun run lint:js:fix

# Format all code with Prettier
format:
    bun run format

# Check code formatting without modifying files
check-format:
    bun run check

# Lint Python code
lint-python:
    black --check server.py
    pylint server.py

# Format Python code
format-python:
    black server.py

# Lint and format everything
lint-all: lint-js lint-python
    @echo "✓ All linting completed"

# Format everything
format-all: format-python format
    @echo "✓ All formatting completed"

# Check everything (linting + formatting + references)
check-all: lint-all check-format validate-references
    @echo "✓ All checks passed"

# PWA icon generation
# Generate PNG icons (requires canvas package)
icons-png:
    bun add canvas
    node app/create-icons.js

# Open browser-based icon generator
icons-browser:
    @echo "Opening app/generate-icons.html..."
    @echo "Right-click each canvas to save icons"
    python3 -c "import webbrowser; webbrowser.open('app/generate-icons.html')"

# Development workflow
# Install dependencies
install:
    bun install

# Clean up generated files
clean:
    rm -rf node_modules/
    rm -f bun.lockb
    find . -name "*.pyc" -delete
    find . -name "__pycache__" -type d -exec rm -rf {} +

# Full setup from scratch
setup: install icons-png
    @echo "✓ GlitchCraft setup complete!"
    @echo "Run 'just serve' to start development"

# Testing and validation
# Validate HTML files
validate-html:
    bunx vnu-jar app/index.html app/generate-icons.html

# Test PWA manifest
validate-manifest:
    python3 -m json.tool app/manifest.json > /dev/null && echo "✓ Manifest is valid JSON"

# Check file references (HTML, manifest)
validate-references:
    python3 lint-references.py

# Run all validations
validate: validate-html validate-manifest validate-references check-all
    @echo "✓ All validations passed"

# Git helpers
# Create a commit with all changes
commit message:
    git add -A
    git commit -m "{{message}}\n\n🤖 Generated with [Claude Code](https://claude.ai/code)\n\nCo-Authored-By: Claude <noreply@anthropic.com>"

# Quick commit with lint/format
quick-commit message: format-all lint-all
    just commit "{{message}}"

# Development info
# Show project info
info:
    @echo "🎨 GlitchCraft - Artisanal text corruption, served fresh!"
    @echo ""
    @echo "📁 Project structure:"
    @echo "  app/          - Main application (deploy this directory)"
    @echo "  server.py     - Development server (IPv4/IPv6)"
    @echo "  justfile      - Development commands"
    @echo ""
    @echo "🚀 Quick start:"
    @echo "  just install  - Install dependencies"
    @echo "  just serve    - Start development server"
    @echo "  just check-all - Run all linting and validation"
    @echo ""
    @echo "🔗 Server URLs:"
    @echo "  http://localhost:8000/"
    @echo "  http://127.0.0.1:8000/     (IPv4)"
    @echo "  http://[::1]:8000/         (IPv6)"

# Show server status
status:
    @echo "Checking server status..."
    @pgrep -f "python.*server.py" > /dev/null && echo "✓ Server is running" || echo "✗ Server is not running"
    @echo "Use 'just serve' to start or 'just stop' to stop"