learn-stats

name	learn-stats
description	Report spaced-repetition statistics: total facts, overdue count, retention rate, active decks, and facts added this week. Use when the user says "stats", "estatísticas", "como está meu aprendizado", "/learn-stats", or wants a dashboard of their learning loop.

Learn Stats

Reads workspace/learning/facts/ and workspace/learning/.state/review-log.jsonl to produce a markdown stats report.

Trigger

User wants a snapshot of their learning loop health.

Workflow

Step 1 — Read facts

1. Read all .md files in workspace/learning/facts/
2. Parse frontmatter of each file
3. Get today's date (YYYY-MM-DD)
4. Compute:
   • total = count of all fact files
   • overdue = count where next_review <= today
   • active_decks = count of unique deck values across all facts
   • added_this_week = count where created >= today - 7 days

If workspace/learning/facts/ does not exist or is empty:

"Nenhum fato encontrado. Use /learn-capture para adicionar fatos primeiro." Stop here.

Step 2 — Read review log

1. Read workspace/learning/.state/review-log.jsonl line by line (each line is a JSON object)
2. If the file does not exist or is empty: total_reviews = 0, retention_rate = "N/A"
3. If it exists:
   • total_reviews = count of all log entries
   • good_easy_count = count where grade == "good" OR grade == "easy"
   • retention_rate = round(good_easy_count / total_reviews * 100)%

Step 3 — Output report

Print in markdown, in pt-BR:

## 📊 Learning Loop — Stats

| Métrica             | Valor        |
|---------------------|--------------|
| Total de fatos      | {total}      |
| Vencidos hoje       | {overdue}    |
| Taxa de retenção    | {retention_rate} ({good_easy_count}/{total_reviews} revisões) |
| Decks ativos        | {active_decks} |
| Adicionados (7 dias)| {added_this_week} |

**Data:** {today YYYY-MM-DD}

If overdue > 0:

💡 Use /learn-review para revisar os fatos vencidos.

If total < 10:

💡 Use /learn-capture para adicionar mais fatos (meta v0: 20 fatos em 2 semanas).

Step 4 (optional) — List overdue facts

If overdue > 0 and overdue <= 10, list them:

### Fatos vencidos
- `{filename}` (deck: {deck}, venceu: {next_review})
  > {Retrieval Q — first 80 chars}

Constraints

• Read-only. Do NOT modify any file.
• Do NOT write to review-log.jsonl.
• If log is missing (user hasn't reviewed yet), show N/A for retention — do not error.
• Round retention_rate to nearest integer (no decimal places).