docs(01): phase 1 plans and research

This commit is contained in:
Pierre Martin
2026-03-23 13:16:15 +01:00
parent 1b81b56ae7
commit 929ee4ce7d
2 changed files with 7 additions and 7 deletions

View File

@@ -15,8 +15,8 @@ CLI one-shot (`vmux list`) qui détecte toutes les sessions Claude Code actives
### Détection des sessions
- **D-01:** Scanner `/proc` pour trouver les PID des processus Claude Code actifs, puis enrichir avec les fichiers JSONL dans `~/.claude/projects/`. Un JSONL sans PID correspondant = session terminée, ignorée.
- **D-02:** Utiliser `sessions-index.json` (présent dans chaque dossier projet sous `~/.claude/projects/`) comme source de métadonnées riches (sessionId, gitBranch, projectPath, summary, created, modified). Format vérifié sur le poste.
- **D-03:** Le matching PID → session se fait via le cwd du processus (`/proc/PID/cwd` → readlink) croisé avec le `projectPath` du sessions-index.
- **D-02:** ~~sessions-index.json~~ AMENDÉ : sessions-index.json est absent dans 85% des projets (découverte recherche). Utiliser uniquement les fichiers JSONL comme source de métadonnées. Le matching PID → JSONL se fait via l'encoding du cwd en nom de dossier.
- **D-03:** Le matching PID → session se fait via : `/proc/PID/cwd` → readlink → encoder le chemin (remplacer `/` par `-`) → chercher le dossier correspondant dans `~/.claude/projects/` → lire les fichiers JSONL dedans.
### Détection d'état
- **D-04:** Se baser uniquement sur le JSONL (tail-read de la dernière entrée) pour déterminer l'état. Pas de lecture CPU en Phase 1.