chore(release): first PyPI publish of create-awesome-python-app

[ulises-jeremias]

Summary

Ship the first public PyPI release of create-awesome-python-app (and publishable core if applicable) so end users can:

uvx create-awesome-python-app@latest my-app --template fastapi-starter

Workflow skeletons and OIDC Trusted Publishing docs already exist from the distribution epic; this issue tracks actually cutting and verifying the first release.

CNA mapping

CNA: published create-awesome-node-app on npm; cna-templates smoke tests use npx create-awesome-node-app.

CPA smoke-test today checks out create-python-app from source because the package is not on PyPI yet.

Acceptance criteria

• PyPI Trusted Publisher configured for the package (see closed PyPI Trusted Publishing (OIDC) for create-awesome-python-app #58 / docs/DISTRIBUTION_SETUP.md)
• Version bump to first public version (e.g. 0.1.0) with changelog/release notes
• Tag + GitHub Release triggers publish workflow successfully
• uvx create-awesome-python-app@<version> --help works from a clean machine
• Default catalog resolves to Create-Python-App/cpa-templates templates.json
• Smoke: scaffold fastapi-starter via published CLI (slug or URL)
• Update cpa-templates smoke-test to prefer uv tool install / uvx with source checkout as fallback
• Root README badges (PyPI version) live

Related (closed foundations)

• [Epic 8] Distribution — PyPI, Docker, AUR, Homebrew #9 Distribution epic
• Release workflow skeleton (tag → GitHub Release) #52 Release workflow skeleton
• PyPI Trusted Publishing (OIDC) for create-awesome-python-app #58 PyPI Trusted Publishing (OIDC)
• Distribution smoke tests (uvx / docker / brew) #62 Distribution smoke tests

Blocked by

Recommended (not hard): catalog wired (#138 ✅), cpa-templates bank live (#44 ✅).

Reference

• docs/DISTRIBUTION_SETUP.md
• .github/workflows/publish.yml
• Package: packages/create-awesome-python-app

[ulises-jeremias]

Release prep and tag create-awesome-python-app@0.1.0 are done (GitHub Release + artifacts built).

PyPI upload failed: Trusted Publisher not configured yet (invalid-publisher).

Next steps (human):

1. On https://pypi.org/manage/account/publishing/ add pending publishers for:
   • create-python-app-core
   • create-awesome-python-app
2. Owner: Create-Python-App, repo: create-python-app, workflow: publish.yml, environment: empty
3. Re-run the failed Release workflow (or delete/re-push the tag carefully)

Docs: docs/DISTRIBUTION_SETUP.md

[ulises-jeremias]

Release job now uses GitHub Actions environment pypi.

When configuring pending Trusted Publishers, set Environment name to pypi for both projects. Then re-run the failed Release workflow (or wait for a new tag after this lands on main — re-run needs the workflow file from the tag ref, so either:

1. Update publishers with pypi, then move the tag to current main and push, or
2. Re-create the tag after merge.

Recommended after merge:

git fetch origin
git tag -d create-awesome-python-app@0.1.0
git push origin :refs/tags/create-awesome-python-app@0.1.0
git checkout main && git pull
git tag -a create-awesome-python-app@0.1.0 -m "Release create-awesome-python-app 0.1.0"
git push origin create-awesome-python-app@0.1.0

[ulises-jeremias]

Both packages published to PyPI at 0.1.0: create-python-app-core + create-awesome-python-app.