docs(phase-01): complete phase execution

.planning/STATE.md

@@ -2,14 +2,14 @@
 gsd_state_version: 1.0
 milestone: v1.0
 milestone_name: milestone
-status: Ready to execute
+status: Ready to plan
-stopped_at: Completed 01-01-PLAN.md
+stopped_at: Completed 01-02-PLAN.md
-last_updated: "2026-03-23T12:26:26.157Z"
+last_updated: "2026-03-23T13:44:01.494Z"
 progress:
   total_phases: 4
-  completed_phases: 0
+  completed_phases: 1
   total_plans: 2
-  completed_plans: 1
+  completed_plans: 2
 ---
 
 # Project State
@@ -23,8 +23,8 @@ See: .planning/PROJECT.md (updated 2026-03-23)
 
 ## Current Position
 
-Phase: 01 (session-discovery) — EXECUTING
+Phase: 2
-Plan: 2 of 2
+Plan: Not started
 
 ## Performance Metrics
 
@@ -47,6 +47,7 @@ Plan: 2 of 2
 
 *Updated after each plan completion*
 | Phase 01 P01 | 2min | 2 tasks | 5 files |
+| Phase 01 P02 | 4min | 2 tasks | 8 files |
 
 ## Accumulated Context
 
@@ -58,6 +59,7 @@ Recent decisions affecting current work:
 - Roadmap: CLI one-shot en Phase 1 (pas de daemon), daemon en Phase 2, hooks en Phase 3
 - Roadmap: 4 phases derives des 4 categories de requirements
 - [Phase 01]: procDir injectable pour testabilite (pas de /proc en dur)
+- [Phase 01]: IdleThreshold = 60s (constante, configurable plus tard)
 
 ### Pending Todos
 
@@ -69,6 +71,6 @@ None yet.
 
 ## Session Continuity
 
-Last session: 2026-03-23T12:26:26.155Z
+Last session: 2026-03-23T12:32:32.970Z
-Stopped at: Completed 01-01-PLAN.md
+Stopped at: Completed 01-02-PLAN.md
 Resume file: None

.planning/phases/01-session-discovery/01-VERIFICATION.md

@@ -0,0 +1,121 @@
+---
+phase: 01-session-discovery
+verified: 2026-03-23T14:00:00Z
+status: passed
+score: 7/7 must-haves verified
+re_verification: false
+human_verification:
+  - test: "Tester vmux list sur le poste en direct"
+    expected: "Toutes les sessions Claude actives apparaissent, états cohérents avec leur activité réelle"
+    why_human: "Impossible de vérifier programmatiquement que l'état affiché (Working/NeedsInput/Idle) correspond à ce que l'utilisateur observerait visuellement dans ses workspaces"
+---
+
+# Phase 01: Session Discovery — Rapport de vérification
+
+**Objectif de la phase :** L'utilisateur peut lancer `vmux list` et voir toutes ses sessions Claude Code actives avec leur état.
+**Vérifié :** 2026-03-23T14:00:00Z
+**Statut :** passed
+**Re-vérification :** Non — vérification initiale
+
+## Résultat de l'objectif
+
+### Vérités observables
+
+| #  | Vérité | Statut | Preuve |
+|----|--------|--------|--------|
+| 1  | `vmux list` affiche toutes les sessions Claude Code actives (aucune session manquante) | VERIFIED | `./vmux list` produit 8 sessions depuis `/proc` + JSONL réels sur le poste |
+| 2  | Chaque session affiche son cwd, worktree git et branche git | VERIFIED | `display.go` ligne 42 : `[STATE] cwd (branch) [worktree: ...]` ; `resolveWorktree` dans `main.go` via `git rev-parse --show-toplevel` |
+| 3  | Chaque session affiche son état : Working, Needs Input ou Idle | VERIFIED | `DetectState` dans `state.go` — heuristique end_turn/tool_use/progress/idle threshold 60s |
+| 4  | Chaque session affiche un aperçu des dernières lignes de sortie | VERIFIED | `ExtractPreview` dans `state.go` — 3 premières lignes du dernier texte assistant, tronquées à 200 chars |
+| 5  | `FindClaudeProcesses()` retourne les processus Claude actifs avec PID et cwd | VERIFIED | `proc.go` — scan `/proc`, filtrage par `filepath.Base == "claude"`, `os.Readlink` pour le cwd |
+| 6  | `EncodePath()` convertit un chemin absolu en nom de dossier `~/.claude/projects/` | VERIFIED | `proc.go` — `strings.NewReplacer("/", "-", ".", "-")` |
+| 7  | Tous les tests passent | VERIFIED | `go test ./...` : 27 tests, 0 échec — durée 0.016s |
+
+**Score : 7/7 vérités confirmées**
+
+### Artefacts requis
+
+| Artefact | Attendu | Statut | Détails |
+|----------|---------|--------|---------|
+| `shell.nix` | Environnement NixOS avec Go | VERIFIED | Contient `go` et `gopls` dans `buildInputs` |
+| `go.mod` | Module Go | VERIFIED | `module github.com/pieMusic/vmux` |
+| `types.go` | Types partagés (Process, Session, SessionState) | VERIFIED | Working/NeedsInput/Idle/Unknown + String() |
+| `proc.go` | Scan /proc pour les processus Claude | VERIFIED | `FindClaudeProcesses` + `EncodePath` exportées |
+| `proc_test.go` | Tests unitaires proc | VERIFIED | 5 tests dont fake /proc fixtures |
+| `session.go` | Matching PID->JSONL, lecture JSONL | VERIFIED | `FindSessionForProcess` + `TailReadJSONL` exportées |
+| `session_test.go` | Tests session | VERIFIED | 7 tests dont exclusion subagents |
+| `state.go` | Heuristique d'état | VERIFIED | `DetectState` + `ExtractPreview` + `IdleThreshold = 60s` |
+| `state_test.go` | Tests état | VERIFIED | 10 tests couvrant tous les patterns + preview |
+| `display.go` | Affichage CLI avec couleurs ANSI | VERIFIED | `DisplaySessions(w io.Writer, sessions []Session, noColor bool)` |
+| `display_test.go` | Tests affichage | VERIFIED | 5 tests dont noColor, worktree, no-branch |
+| `main.go` | Point d'entrée CLI `vmux list` | VERIFIED | Pipeline complet FindClaudeProcesses -> FindSession -> DetectState -> DisplaySessions |
+
+### Vérification des liens clés
+
+| De | Vers | Via | Statut | Détails |
+|----|------|-----|--------|---------|
+| `session.go` | `~/.claude/projects/<encoded>/*.jsonl` | `EncodePath` + `filepath.Glob` | WIRED | Lignes 158-161 : `encoded := EncodePath(proc.Cwd)` puis `filepath.Glob(pattern)` |
+| `state.go` | `session.go` | `TailReadJSONL` fournit `[]JSONLMessage` à `DetectState` | WIRED | `session.go:191` appelle `TailReadJSONL` ; `main.go:58` passe les messages à `DetectState` |
+| `main.go` | `proc.go + session.go + state.go + display.go` | Pipeline complet | WIRED | `main.go:37,48,58,86` — les 4 appels enchaînés dans l'ordre |
+| `proc.go` | `/proc/*/cmdline` | `os.ReadFile` + split sur null bytes | WIRED | `proc.go:27-32` — `ReadFile` + `strings.TrimRight` + `strings.Split` |
+| `proc.go` | `/proc/*/cwd` | `os.Readlink` | WIRED | `proc.go:43` — `os.Readlink(filepath.Join(procDir, entry.Name(), "cwd"))` |
+
+### Trace data-flow (Niveau 4)
+
+| Artefact | Variable de données | Source | Produit des données réelles | Statut |
+|----------|--------------------|---------|-----------------------------|--------|
+| `main.go` (rendu final) | `sessions []Session` | `/proc` scan + JSONL réels via `FindClaudeProcesses` + `FindSessionForProcess` | Oui — test manuel : 8 sessions détectées sur le poste | FLOWING |
+| `display.go` | `sessions []Session` | Reçu de `main.go` via pipeline | Oui — prop non vide vérifiée par tests + test réel | FLOWING |
+| `state.go` | `messages []JSONLMessage` | `TailReadJSONL` lit les vrais fichiers JSONL | Oui — parsing JSON réel, pas de données statiques | FLOWING |
+
+### Vérifications comportementales (Spot-checks)
+
+| Comportement | Commande | Résultat | Statut |
+|--------------|----------|---------|--------|
+| `vmux list` affiche des sessions réelles | `/tmp/vmux-verify list --no-color` | 8 sessions affichées avec cwd, branche et aperçu | PASS |
+| Binaire compile | `go build -o /tmp/vmux-verify ./...` | BUILD OK | PASS |
+| 27 tests passent | `go test -v ./...` | PASS ok 0.016s | PASS |
+
+### Couverture des requirements
+
+| Requirement | Plan source | Description | Statut | Preuve |
+|-------------|-------------|-------------|--------|--------|
+| DISC-01 | 01-01 | vmux détecte automatiquement les processus Claude Code actifs | SATISFIED | `FindClaudeProcesses("/proc")` dans `main.go:37` — 8 sessions détectées en test réel |
+| DISC-02 | 01-01 | vmux identifie le cwd et le worktree git de chaque session | SATISFIED | `proc.Cwd` via `/proc/PID/cwd` + `resolveWorktree` via `git rev-parse --show-toplevel` |
+| DISC-03 | 01-02 | vmux affiche le nom de la branche git de chaque session | SATISFIED | `gitBranch` extrait des messages JSONL, affiché dans `display.go:34-36` |
+| STATE-01 | 01-02 | vmux détecte l'état de chaque session : travaille / attend input / idle | SATISFIED | `DetectState` avec heuristique end_turn/tool_use/AskUserQuestion/progress/idle 60s |
+| STATE-02 | 01-02 | vmux affiche un aperçu des dernières lignes de sortie | SATISFIED | `ExtractPreview` — 3 premières lignes du dernier texte assistant |
+
+Note REQUIREMENTS.md : DISC-01 et DISC-02 marqués `[x]` (complétés). DISC-03, STATE-01, STATE-02 marqués `[ ]` (en attente de mise à jour manuelle) — implémentation vérifiée comme présente et fonctionnelle.
+
+### Anti-patterns détectés
+
+| Fichier | Ligne | Pattern | Sévérité | Impact |
+|---------|-------|---------|----------|--------|
+| `main.go` | 73 | `_ = jsonlPath` | Info | Variable conservée pour usage debug futur — pas un stub, le chemin est utilisé en interne |
+| `session.go` | 145-151 | `extractCompleteLines` défini mais non utilisé dans le flux final | Info | Fonction helper intermédiaire laissée en place — `go vet` ne signale pas de warning car elle est appelée dans la boucle (ligne 82) |
+
+Aucun bloqueur. Aucun stub. Aucun placeholder.
+
+### Vérification humaine requise
+
+#### 1. Cohérence des états en temps réel
+
+**Test :** Lancer `vmux list` puis vérifier que les sessions marquées "Working" correspondent aux sessions Claude Code actuellement en train de traiter une requête.
+**Attendu :** L'état affiché correspond à ce que l'utilisateur observe visuellement dans ses terminaux.
+**Pourquoi humain :** L'heuristique repose sur le dernier message JSONL — impossible de vérifier programmatiquement que le seuil de 60s et les patterns stop_reason correspondent à la réalité perçue.
+
+#### 2. Affichage avec couleurs ANSI
+
+**Test :** Lancer `vmux list` dans un terminal (sans `--no-color`).
+**Attendu :** Working en vert, Needs Input en jaune, Idle en gris.
+**Pourquoi humain :** Impossible de vérifier le rendu couleur programmatiquement.
+
+### Résumé
+
+Les 5 requirements (DISC-01, DISC-02, DISC-03, STATE-01, STATE-02) sont tous implémentés et vérifiés. Le binaire `vmux list` fonctionne en production : il détecte 8 sessions Claude Code actives sur le poste, affiche leur cwd, branche, état et aperçu. Les 27 tests passent sans aucun échec. Aucun stub, aucun placeholder, aucun anti-pattern bloquant.
+
+---
+
+_Vérifié : 2026-03-23T14:00:00Z_
+_Vérificateur : Claude (gsd-verifier)_