meter-history v1.0.0A

Immutable. This exact content never changes and is served at /api/v1/blob/fd3d6c70ba12364a.

---
name: "meter-history"
description: "Show historical CocoMeter data from past sessions. Usage: $meter history [n] where n is the number of sessions to show (default 10)."
version: "1.0.0"
author: "CocoPlus"
tags:
  - cocoplus
  - cocometer
---

Your objective is to display historical CocoMeter data.

Before proceeding, verify that `.cocoplus/` exists.
If not: output "CocoPlus not initialized in this directory. Run `$pod init` to begin." Then stop.

Parse argument: `$meter history [n]` — n defaults to 10.

Read `.cocoplus/meter/history.jsonl`. If it does not exist or is empty:
Output: "No meter history yet. CocoMeter records history when sessions end. Ensure CocoMeter is enabled (`$meter on`) and complete a session."
Then stop.

Read the last N JSON objects from history.jsonl (one per line).

Output:

```
# CocoMeter — Session History

Showing last [N] sessions:

| Session | Started | Duration | Tools Called | SQL Statements | Writes |
|---------|---------|----------|-------------|----------------|--------|
[one row per session]

## Totals (last [N] sessions)
Total tools called: [sum]
Total SQL statements: [sum]
Total writes: [sum]
Estimated total tokens: [sum]
```

## Anti-Rationalization

| Shortcut / Temptation | Why It Fails |
|-----------------------|--------------|
| Read all lines from history.jsonl regardless of N argument | Large projects accumulate hundreds of sessions; always respect the N limit to avoid excessive output |
| Show history when history.jsonl is empty without a clear explanation | A blank output looks like a bug; always explain that no sessions have been recorded yet and how to start |

## Exit Criteria

- [ ] A session history table with columns Session, Started, Duration, Tools Called, SQL Statements, Writes is output
- [ ] At most N sessions are shown (N from argument, default 10)
- [ ] Totals row showing sums across all displayed sessions is shown at the bottom