feat: support alternate xlsx header formats and auto-load .env

[jeremyeder]

Summary

• Add HEADER_ALIASES so build_db.py accepts both original and alternate column names (e.g. "Scrum Team Name (miro)", "Jira Filter (Team reference)")
• Auto-detect xlsx file whose sheets match the configured TAB_ORG_MAP
• Load .env via python-dotenv so config is picked up without manual sourcing

Test plan

• scripts/test.sh — 11/11 passing
• Verified rebuild with both acme and real xlsx formats

🤖 Generated with Claude Code

[coderabbitai]

Caution

Review failed

The pull request is closed.

ℹ️ Recent review info

⚙️ Run configuration

Configuration used: Organization UI

Review profile: ASSERTIVE

Plan: Pro

Run ID: 431a962c-1be9-4ba8-af42-4f375bd8b88f

📥 Commits

Reviewing files that changed from the base of the PR and between 51185c9 and 548b45b.

⛔ Files ignored due to path filters (1)

• uv.lock is excluded by !**/*.lock

📒 Files selected for processing (2)

• pyproject.toml
• scripts/build_db.py

Cache: Disabled due to data retention organization setting

Knowledge base: Disabled due to data retention organization setting

---

Walkthrough

Added python-dotenv as a runtime dependency. Updated scripts/build_db.py to optionally load environment variables from .env, replaced static header list with aliases mapping, improved header matching logic, and refined XLSX discovery to prefer files with matching worksheet names.

Changes

Cohort / File(s)	Summary
Dependency Update pyproject.toml	Added python-dotenv>=1.0 as a required runtime dependency.
Script Logic Enhancements scripts/build_db.py	Implemented optional .env file loading; replaced EXPECTED_HEADERS static list with HEADER_ALIASES mapping for flexible header matching; updated _match_header to resolve headers via canonical names and aliases; refined find_xlsx to prioritize .xlsx files with worksheet names matching TAB_ORG_MAP keys; removed unused sort parameter and added early return for no-candidates case.

Estimated code review effort

🎯 3 (Moderate) | ⏱️ ~20 minutes

✨ Finishing Touches

📝 Generate docstrings

• Create stacked PR
• Commit on current branch

🧪 Generate unit tests (beta)

• Create PR with unit tests
• Commit unit tests in branch support-alternate-xlsx-headers

---

_{Comment @coderabbitai help to get the list of available commands and usage tips.}