Closes #

• feat — user-visible new capability
• fix — user-visible bug fix
• docs — documentation only
• refactor — internal change, no behavior change
• perf — performance improvement
• test — tests only
• build / ci — build system or CI configuration
• chore — maintenance, no user impact

• Commit messages follow Conventional Commits.
• CI is green: lint, test, and security scan.
• Docs updated in the same PR (if behavior changed).
• Tests added or updated in the same PR (if logic changed).
• No secrets, credentials, or .env files committed.
• PR is a single logical change — split into stacked PRs if larger.