fix: normalize Python scaffold package names

[rogerchappel]

Summary

• normalize human-friendly project names into valid Python distribution names
• prefix generated import modules that would otherwise begin with a digit
• declare the Hatch wheel package path explicitly so normalized distribution and module names may differ
• build, install, and import representative spaced and punctuated Python API scaffolds in smoke coverage
• document how display, directory, distribution, and import names relate

Commits

• b04427c test: cover Python package name normalization
• 288f30a fix: normalize Python distribution and module names
• c7a2e9c docs: explain Python naming normalization

Verification

• pnpm install --frozen-lockfile
• pnpm run release:check
  • package-manager and documentation validation
  • TypeScript build and template registry test
  • generated Python wheels for My API and 123 Weird.API!
  • clean virtual-environment install and imports of my_api.main and _123_weird_api.main
  • generated Next.js install, lint, build, production audit, and validation
  • package smoke
• git diff --check origin/main...HEAD

All commits are authored and committed by Roger Chappel miscanalysis@gmail.com.

[rogerchappel]

Automated merge note

Triage class: auto-merge

Summary: Normalize Python scaffold distribution/module names while preserving directory and display names; add wheel packaging configuration, build/install/import smoke coverage, and naming documentation.

Checks run: Node 20 compatibility, Node 22 compatibility, Repository hygiene, Docs hygiene, and Generate branchbrief — all completed successfully. Worker verification also passed pnpm install --frozen-lockfile, pnpm run release:check, and git diff --check origin/main...HEAD.

Rebased/CI-repaired: no.

Verified head SHA: c7a2e9c77e402b45bcd15cd406db390c921c3570