docs: add comprehensive v0.3 to v1.0 migration guide #442

	---
	name: Minimal Install Smoke Test
	on:
	push:
	branches: [main, 1.0-dev]
	paths-ignore:
	- '**.md'
	- 'LICENSE'
	- 'docs/**'
	- '.github/CODEOWNERS'
	- '.github/ISSUE_TEMPLATE/**'
	- '.github/PULL_REQUEST_TEMPLATE.md'
	- '.github/dependabot.yml'
	- '.gitignore'
	- '.git-blame-ignore-revs'
	- '.gemini/**'
	pull_request:
	paths-ignore:
	- '**.md'
	- 'LICENSE'
	- 'docs/**'
	- '.github/CODEOWNERS'
	- '.github/ISSUE_TEMPLATE/**'
	- '.github/PULL_REQUEST_TEMPLATE.md'
	- '.github/dependabot.yml'
	- '.gitignore'
	- '.git-blame-ignore-revs'
	- '.gemini/**'
	permissions:
	contents: read

	jobs:
	minimal-install:
	name: Verify base-only install
	runs-on: ubuntu-latest
	if: github.repository == 'a2aproject/a2a-python'
	strategy:
	matrix:
	python-version: ['3.10', '3.11', '3.12', '3.13', '3.14']
	steps:
	- name: Checkout code
	uses: actions/checkout@v6

	- name: Install uv
	uses: astral-sh/setup-uv@v7
	with:
	python-version: ${{ matrix.python-version }}

	- name: Build package
	run: uv build --wheel

	- name: Install with base dependencies only
	run: \|
	uv venv .venv-minimal
	# Install only the built wheel -- no extras, no dev deps.
	# This simulates what an end-user gets with `pip install a2a-sdk`.
	VIRTUAL_ENV=.venv-minimal uv pip install dist/*.whl

	- name: List installed packages
	run: VIRTUAL_ENV=.venv-minimal uv pip list

	- name: Run import smoke test
	run: .venv-minimal/bin/python scripts/test_minimal_install.py

Provide feedback