release: prepare ExcelAlchemy 2.2.7

[ruicore]

Summary

This PR prepares the 2.2.7 release of ExcelAlchemy.

It continues the stable 2.x line with stronger API-facing result payloads, a more complete FastAPI reference app, harder install-time smoke verification, and more consistent codec diagnostics.

What changed

Result payloads and API integration

• strengthen ImportResult, CellErrorMap, and RowIssueMap as API-facing result objects
• clarify the roles of:
  • code
  • message_key
  • message
  • display_message
• add richer summary helpers for field, row, and code aggregation
• add docs/api-response-cookbook.md

FastAPI reference app

• expand examples/fastapi_reference/ into a more copyable minimal application
• add request and response schemas
• add a structured API response builder
• align the reference app with the documented API response cookbook

Release and smoke hardening

• strengthen installed-package smoke verification
• verify:
  • successful imports
  • failed imports
  • structured error payloads
  • example-output asset generation
  • result-object and showcase docs
  • FastAPI reference HTTP behavior after dependency installation
• add scripts/smoke_docs_assets.py

Diagnostics polish

• unify codec fallback logging under excelalchemy.codecs
• make fallback wording more consistent across option, parse, and render paths

Compatibility notes

• no public import/export workflow API was removed
• ImportResult, CellErrorMap, and RowIssueMap remain stable public result objects in 2.x
• storage=... remains the recommended 2.x backend configuration path
• legacy built-in Minio fields remain part of the 2.x compatibility surface

Verification

• ./.venv/bin/ruff check .
• ./.venv/bin/uv run pyright
• ./.venv/bin/pytest -q
• ./.venv/bin/python scripts/smoke_package.py
• ./.venv/bin/python scripts/generate_example_output_assets.py
• ./.venv/bin/python scripts/smoke_docs_assets.py
• ./.venv/bin/uv run --with fastapi --with httpx --with python-multipart python scripts/smoke_examples.py
• ./.venv/bin/uv build
• ./.venv/bin/uvx twine check dist/*

Release intent

After merge, this branch is intended to be tagged and published as:

• v2.2.7

[codecov]

Codecov Report

❌ Patch coverage is 93.98496% with 8 lines in your changes missing coverage. Please review.
✅ Project coverage is 87.06%. Comparing base (52e07b0) to head (dee5649).
⚠️ Report is 4 commits behind head on main.

Files with missing lines	Patch %	Lines
src/excelalchemy/exceptions.py	83.33%	1 Missing and 1 partial ⚠️
src/excelalchemy/codecs/date_range.py	50.00%	1 Missing ⚠️
src/excelalchemy/codecs/multi_checkbox.py	66.66%	1 Missing ⚠️
src/excelalchemy/codecs/number.py	0.00%	1 Missing ⚠️
src/excelalchemy/codecs/organization.py	66.66%	1 Missing ⚠️
src/excelalchemy/codecs/radio.py	75.00%	1 Missing ⚠️
src/excelalchemy/codecs/staff.py	66.66%	1 Missing ⚠️

Additional details and impacted files

@@            Coverage Diff             @@
##             main      #67      +/-   ##
==========================================
- Coverage   87.30%   87.06%   -0.24%     
==========================================
  Files          48       48              
  Lines        3608     3882     +274     
  Branches      396      431      +35     
==========================================
+ Hits         3150     3380     +230     
- Misses        281      313      +32     
- Partials      177      189      +12     

☔ View full report in Codecov by Sentry.
📢 Have feedback on the report? Share it here.

🚀 New features to boost your workflow:

• ❄️ Test Analytics: Detect flaky tests, report on failures, and find test suite problems.