task-telemetry

Files (8)

• SKILL.md
• cursor-pricing.json
• backfill.py · scripts/
• measure.py · scripts/
• measure_cursor.py · scripts/
• measure_kimi.py · scripts/
• measure_session.py · scripts/
• usd-eur-fallback.json

SKILL.md (first lines)

# Task telemetry

Adaptée de la skill `task-telemetry` d'un projet voisin. Mesure la
consommation réelle d'une tâche Backlog.md et produit une ligne de note à
persister dans les notes de la tâche (source de vérité unique, à côté de
l'estimation d'effort éventuelle).

**Skill de développement** : elle vit dans `.kimi-code/skills/` — active en
travaillant sur ce dépôt, elle n'est pas livrée dans `skills/` et `install.sh`
ne l'installe pas.

## Quel runtime, quel script

| Qui a fait le travail | Runtime | Script | Fenêtre |
| --- | --- | --- | --- |
| Session courante | **Kimi Code** | `measure_kimi.py task` | marqueur In Progress → Done |
| Tâche finie avant le rituel | **Kimi Code** | `measure_kimi.py backfill` | (commit précédent, commit(s) de la tâche] |
| Vue d'ensemble (pas une tâche) | **Kimi Code** | `measure_kimi.py summary/sessions/calls/tools/context` | toutes sessions, ou `--since` |
| Session courante | **Claude Code** | `measure.py` | marqueur In Progress → dernier message |
| Sous-agent / vieille tâche | **Claude Code** | `backfill.py` | (commit précédent, commit(s) de la tâche] |
| Une session d'une tâche multi-sessions | **Claude Code** | `measure_session.py` | un transcript, du début à la fin |
| Session Agent / Auto | **Cursor** | `measure_cursor.py` | timestamps des tours × événements `cursor-usage` |

## Comment la source est détectée

Le script se choisit selon **l'outil qui a réellement fait le travail** — pas
selon le projet :

- **Kimi Code** : la session courante est Kimi Code (ce CLI), ou le projet a
  des sessions sous `~/.kimi-code/sessions/` dont le `workDir` (dans
  `~/.kimi-code/session_index.jsonl`) est le répertoire du projet →
  `measure_kimi.py`. Les wire.jsonl ne contiennent aucun bloc `usage` de style
  Anthropic ni prix.
- **Claude Code** : transcripts avec blocs `usage` Anthropic sous
  `~/.claude/projects/<chemin-assaini>/` → `measure.py` / `backfill.py` /
  `measure_session.py`.
- **Cursor** : transcripts d'agent sous `~/.cursor/projects/…/agent-transcripts/`
  + événements `cursor-usage` → `measure_cursor.py`.

Ne jamais mélanger les lignes de note de runtimes différents sans étiqueter la
source : les chiffres Claude Code sont des équivalents tarif API Anthropic, les
chiffres Cursor des équivalents tarif liste Cursor, et Kimi Code ne fournit que
des tokens (pas de prix). Ils ne sont pas comparables en une seule moyenne.

## Procédure Kimi Code (`measure_kimi.py`)

Source : `~/.kimi-code/sessions/wd_<slug>_<sha>/session_<id>/agents/<agent>/wire.jsonl`
(un wire.jsonl par agent : main, coder, explore…), indexé par
`~/.kimi-code/session_index.jsonl`. Les sessions du projet sont retrouvées par
`workDir`. Consommation : une ligne `usage.record` par tour
(`usageScope: "turn"`, `time` en epoch ms) — on les somme. Protocole vérifié :
**1.5** (le 2026-09-19) ; tout autre `protocol_version` déclenche un
avertissement sur stderr (`--strict` pour en faire une erreur).

1. Après le résumé final de la tâche, depuis le répertoire du projet :

   ```bash
   python3 .kimi-code/skills/task-telemetry/scripts/measure_kimi.py task --task-id <id>
   ```

   La fenêtre s'ouvre au marqueur `backlog task edit <id> -s "In Progress"`
   trouvé dans les appels Bash des wire.jsonl, et se ferme au marqueur
   `-s "Done"` le plus récent (ou `--end-ts <ISO>`, ou le dernier événement).
   Options : `--end-ts`, `--gap-threshold 120`, `--locale en`, `--json`,
   `--home`, `--strict`.

2. Tâche finie sans rituel (ou marqueur posé au dernier moment) :

   ```bash
   python3 .kimi-code/skills/task-telemetry/scripts/measure_kimi.py backfill --task-id <id>
   ```

   Fenêtre = (commit précédent, commit(s) de la tâche] — les sujets de commit
   doivent référencer `TASK-<id>` (`--id-pattern` sinon, `--commit SHA` en
   secours). Garder la mention « reconstruit » dans la ligne.

3. **Ce que les chiffres veulent dire — pas de prix côté Kimi.** Le schéma
   d'usage a un `total_cost_usd` optionnel **jamais rempli**. La ligne rendue
   rapporte des **tokens exacts** — avec le détail cache read / cache write,
   qui domine (~95 % de l'input : c'est ce qui tient le coût réel bas) — et
   marque le **coût comme indisponible**. Ne jamais inventer de tarif. Le quota
   (fenêtre 5 h, total mensuel) est côté serveur : c'est le rôle de `/usage` et
   de la console Kimi Code, pas de ce script.

4. Vues globales (héritées de l'ancienne skill kimi-telemetry) :

   ```bash
   python3 .kimi-code/skills/task-telemetry/scripts/measure_kimi.py summary
   python3 .kimi-code/skills/task-telemetry/scripts/measure_kimi.py sessions --since 2026-09-01
   python3 .kimi-code/skills/task-telemetry/scripts/measure_kimi.py tools --session session_8646
   ```

   | vue | répond à |
   |---|---|
   | `summary` | tokens totaux, par modèle et agent, taux de cache |
   | `sessions` | coût en tokens par session, avec répertoire de travail |
   | `calls` | chaque tour : tokens in/out, cache, modèle |
   | `tools` | nombre d'appels d'outils par agent |
   | `context` | taille de fenêtre de contexte mesurée par agent |

5. Persister :

   ```bash
   backlog task edit <id> --append-notes "<NOTE LINE imprimée par le script>"
   ```

## Procédure Claude Code (`measure.py`, `backfill.py`, `measure_session.py`)

Scripts copiés tels quels depuis le projet source ; voir leurs docstrings pour
le détail. En bref :

```bash
python3 .kimi-code/skills/task-telemetry/scripts/measure.py --task-id <id>
python3 .kimi-code/skills/task-telemetry/scripts/measure_session.py
python3 .kimi-code/skills/task-telemetry/scripts/backfill.py --task-id <id>
```

Points clés : déduplication par `message.id` ; découverte récursive des
transcripts (sous-agents inclus) ; coût = équivalent tarif liste API (snapshot

From elpfries/bob-sideshow, MIT.

More from elpfries/bob-sideshow