docs(suite): handbook, PlantUML pipeline, site/repo layout docs #89

	name: CI

	on:
	push:
	branches: [main]
	pull_request:
	branches: [main]

	concurrency:
	group: ci-${{ github.ref }}
	cancel-in-progress: true

	jobs:
	lint:
	runs-on: ubuntu-latest
	steps:
	- uses: actions/checkout@v6
	- uses: actions/setup-python@v6
	with:
	python-version: "3.12"
	- run: pip install ruff
	- run: ruff check src/ tests/

	unit:
	runs-on: ubuntu-latest
	env:
	OPENAI_API_KEY: ${{ secrets.OPENAI_API_KEY }}
	PYTHONPATH: ${{ github.workspace }}/src
	strategy:
	matrix:
	python-version: ["3.10", "3.11", "3.12"]
	steps:
	- uses: actions/checkout@v6
	- uses: actions/setup-python@v6
	with:
	python-version: ${{ matrix.python-version }}
	- name: Install system dependencies
	run: \|
	set -euo pipefail
	attempt=1
	max_attempts=4
	backoff=4

	while [ "$attempt" -le "$max_attempts" ]; do
	echo "apt attempt $attempt/$max_attempts"
	if timeout 600s sudo apt-get -o Acquire::Retries=3 update \
	&& timeout 600s sudo apt-get -o Acquire::Retries=3 install -y --no-install-recommends ffmpeg tesseract-ocr; then
	exit 0
	fi

	if [ "$attempt" -eq "$max_attempts" ]; then
	echo "apt failed after $max_attempts attempts"
	exit 1
	fi

	echo "apt failed, retrying in ${backoff}s..."
	sleep "$backoff"
	backoff=$((backoff * 2))
	attempt=$((attempt + 1))
	done
	- run: pip install --no-cache-dir ".[dev]"
	- run: pytest tests/ -v --tb=short

Provide feedback