# Chapitre 3 — Veille sans aspiration

> Mois 3 · Août 2026

---

## 3.1 Intention veille

La veille répond à : *« Qu'est-ce qui bouge dans mon écosystème sans que je le cherche ? »*

Ce n'est **pas** un fil infini. Ce n'est **pas** une alerte push. C'est un **digest pull** — trois ondes maximum par semaine, lisibles en langage humain.

---

## 3.2 Sources veille (GitHub API gratuit)

| Signal | Endpoint | Rythme collecte |
|--------|----------|-------------------|
| Releases org/repos | `GET /repos/{o}/{r}/releases` | 1×/jour |
| PR mergées récentes | `GET /repos/{o}/{r}/pulls` | 1×/jour |
| Check runs | `GET /repos/{o}/{r}/commits/{sha}/check-runs` | si commit du jour |
| Search nouveautés | `GET /search/issues` | 1×/semaine |
| Dependabot advisories | `GET /repos/{o}/{r}/dependabot/alerts` | 1×/semaine (repo privé + scope) |

Budget : 5 000 req/h (PAT) · collecte nocturne · cache JSON local.

Variable d'environnement : `GITHUB_TOKEN` ou `GH_TOKEN` (fine-grained, repos ciblés).

---

## 3.3 Format digest veille

Chaque entrée veille est une onde avec `veille: true` :

```json
{
  "id": "WAVE-2026-08-01-veille1",
  "seed": { "label": "Release express 4.x", "source": "github", "felt_insignificant": false },
  "ripples": [
    { "at": "...", "node": "vfg-hero", "effect": "lockfile à vérifier" },
    { "at": "...", "node": "vfgate", "effect": "proxy health à re-smoke" }
  ],
  "human_frame": "Une brique de ton échafaudage a bougé. Tu n'es pas obligé de tout lire — juste de savoir que l'onde existe.",
  "planet_frame": "Réparer et comprendre avant de remplacer — c'est déjà de la sobriété.",
  "veille": true
}
```

---

## 3.4 Règles anti-aspiration veille

1. **3 ondes max** par digest — le reste reste en annexe technique
2. **Pas de notif** — RSS ou visite volontaire companion
3. **Pas d'urgence artificielle** — pas de « critical » rouge clignotant
4. **Explicable** — chaque onde cite sa source (release tag, PR #)
5. **Session terminable** — une page, pas scroll infini

---

## 3.5 Veille et planète

La veille technique peut relier à des comportements « bons pour la planète » **sans sermon** :

- Mise à jour dep = moins de dette = moins de rush futur = moins de nuits blanches = moins de consommation panique
- Advisory sécurité = protéger les padawans qui utilisent tes outils
- Release amie = partager des fixes avec le collectif

`planet_frame` reste **optionnel** et **invitant**, jamais culpabilisant.

---

## 3.6 Où lire la veille

- Fichier : `data/waves/veille-latest.json`
- Companion : section « Veille de la semaine » dans [ondes.html](../demo/ondes.html)
- Pas dans admin `:4319` ops — trop froid pour l'intention padawan

---

*Suite : [04-retro-jeux.md](./04-retro-jeux.md)*