Learn Stats

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