pal-e-docs

Phase: Token Metrics

phase-pal-e-docs-token-metrics Phase

Project
Goal: Capture token usage per item, per sprint, per activity category. Feed into DORA correlation.
Owner: Dev agent
Repo: pal-e-docs
Issue: TBD
Model:
  • TokenUsage — id, sprint_item_id (FK nullable), sprint_id (FK nullable), repo_slug, activity (enum: planning/development/review/documentation), input_tokens (int), output_tokens (int), session_id (string, nullable), agent_type (string, nullable — betty-sue/dev/qa), recorded_at (datetime)
API routes:
  • POST /token-usage — record token usage
  • GET /token-usage/summary — aggregate by sprint, repo, activity
  • GET /sprints/{slug}/token-usage — token breakdown for a sprint
Integration points:
  • Hooks log token counts per agent spawn
  • DORA exporter pulls token metrics for Grafana
  • Sprint retro: review token spend breakdown from previous sprint
Deliverable: Token usage tracked per sprint item. Summary API shows cost per plan/phase/issue and per sprint.