- **Description** - Audit `src/` for bare `# type: ignore` and either: - Fix the typing (add annotations, generics, `TypedDict`/`Protocol`, `overload`, `cast`, `Literal`, `Final`, etc.), or - Use narrow suppressions (e.g., `# type: ignore[call-arg]`) with a short rationale. - Prefer real typing over ignores. No behavioral changes. - **Scope** - Files under `flare_ai_kit/src/*.py`. - No new runtime deps; `typing_extensions` is fine if needed for backports. - If a code change (beyond types) seems necessary, comment first. - **Acceptance criteria** - Zero bare `# type: ignore` in `src/` (all ignores are code-specific, e.g., `ignore[...])`. - Where possible, ignores replaced by proper types. - Pyright (no new errors) and CI green. - **Deliverables** - Updated annotations across `src/`. - List of remaining suppressions with reasons (in PR description). - **Key Files Involved (Proposed)** - `flare_ai_kit/src/*.py`