[P1.17] `cf stats --task` is typed `int` but v2 task IDs are UUID strings

[frankbria]

Severity: high | Category: data-integrity | Phase: P1.17

Problem

tokens(task: Optional[int]) and export_data(task: Optional[int]) reject a UUID at Typer coercion and an int never matches a UUID-keyed row, so per-task cost/token reporting and export are broken for every real v2 task (even after P0.1 restores the table).

Evidence

codeframe/cli/stats_commands.py:80

Acceptance criteria

• --task is str; get_task_token_summary/get_batch_token_usage accept Union[int, str].
• Test: cf stats tokens --task <uuid> returns a saved UUID-keyed row.

Dependencies

blocked by #712 ([P0.1])

---

_{Filed from the SaaS launch-readiness audit. Atomic: one developer, one session. Work order: strictly P0.1 → P3.12 (no forward dependencies).}

[coderabbitai]

🔗 Related PRs

#442 - feat(metrics): token and cost tracking per task (#314) [merged]

---

📝 Issue Planner

_{Check the box below or use the @coderabbitai plan command to generate an implementation plan and prompts that you can use with your favorite coding assistant.}

• Create Plan

---

🧪 Issue enrichment is currently in open beta.

To disable automatic issue enrichment, add the following to your .coderabbit.yaml:

issue_enrichment:
  auto_enrich:
    enabled: false

💬 Have feedback or questions? Drop into our discord!