chore(dev): add development helper scripts

Add Makefile with common commands for building, testing and running.
Create setup.sh script for easy developer onboarding.
Configure git hooks for pre-commit checks.

🤖 Generated with [Claude Code](https://claude.ai/code)
Co-Authored-By: Claude <noreply@anthropic.com>

Author: jonathan-irvin

Makefile

@@ -0,0 +1,58 @@
+.PHONY: help install test lint format clean run build docker-build docker-run
+
+# Help command
+help:
+	@echo "BINGO Application Makefile Commands"
+	@echo ""
+	@echo "Usage:"
+	@echo "  make install  - Install dependencies"
+	@echo "  make run      - Run the application"
+	@echo "  make test     - Run tests"
+	@echo "  make lint     - Run linters"
+	@echo "  make format   - Format code"
+	@echo "  make clean    - Clean build artifacts and cache"
+	@echo "  make build    - Build the package"
+	@echo "  make docker-build - Build Docker image"
+	@echo "  make docker-run   - Run Docker container"
+
+# Install dependencies
+install:
+	poetry install
+
+# Run application
+run:
+	poetry run python app.py
+
+# Run tests
+test:
+	poetry run pytest --cov=src
+
+# Run lints
+lint:
+	poetry run flake8 . --count --select=E9,F63,F7,F82 --show-source --statistics
+	poetry run flake8 . --count --exit-zero --max-complexity=10 --max-line-length=88 --statistics
+	poetry run black --check .
+	poetry run isort --check .
+
+# Format code
+format:
+	poetry run black .
+	poetry run isort .
+
+# Clean build artifacts and cache
+clean:
+	rm -rf dist
+	rm -rf .pytest_cache
+	rm -rf .coverage
+	find . -type d -name "__pycache__" -exec rm -rf {} +
+
+# Build package
+build:
+	poetry build
+
+# Docker commands
+docker-build:
+	docker build -t bingo .
+
+docker-run:
+	docker run -p 8080:8080 bingo

setup.sh

@@ -0,0 +1,49 @@
+#!/bin/bash
+set -e
+
+# Colors for output
+GREEN='\033[0;32m'
+YELLOW='\033[0;33m'
+NC='\033[0m' # No Color
+
+echo -e "${GREEN}Setting up bingo development environment...${NC}"
+
+# Check if Poetry is installed
+if ! command -v poetry &> /dev/null; then
+    echo -e "${YELLOW}Poetry not found. Installing poetry...${NC}"
+    curl -sSL https://install.python-poetry.org | python3 -
+fi
+
+# Install dependencies
+echo -e "${GREEN}Installing dependencies...${NC}"
+poetry install
+
+# Set up pre-commit hooks
+echo -e "${GREEN}Setting up git hooks...${NC}"
+cat > .git/hooks/pre-commit << 'EOF'
+#!/bin/bash
+set -e
+
+# Run black
+echo "Running black..."
+poetry run black .
+
+# Run isort
+echo "Running isort..."
+poetry run isort .
+
+# Run flake8
+echo "Running flake8..."
+poetry run flake8 . --count --select=E9,F63,F7,F82 --show-source --statistics
+poetry run flake8 . --count --exit-zero --max-complexity=10 --max-line-length=88 --statistics
+
+# Run tests
+echo "Running tests..."
+poetry run pytest
+EOF
+
+chmod +x .git/hooks/pre-commit
+
+echo -e "${GREEN}Setup complete! You're ready to start developing.${NC}"
+echo -e "${GREEN}Run 'poetry shell' to activate the virtual environment${NC}"
+echo -e "${GREEN}Run 'python app.py' to start the application${NC}"