185119e580
- SUMMARY.md with protocol types, registry, labels, socket server - STATE.md updated: plan 3/3, decisions, metrics - ROADMAP.md updated: phase 02 progress - REQUIREMENTS.md: DISC-04, STATE-04 complete
91 lines
3.1 KiB
Markdown
91 lines
3.1 KiB
Markdown
# Requirements: vmux
|
|
|
|
**Defined:** 2026-03-23
|
|
**Core Value:** Savoir instantanément quelle session Claude Code a besoin de moi, sans scanner manuellement mes workspaces.
|
|
|
|
## v1 Requirements
|
|
|
|
Requirements for initial release. Each maps to roadmap phases.
|
|
|
|
### Session Discovery
|
|
|
|
- [x] **DISC-01**: vmux détecte automatiquement les processus Claude Code actifs sur le poste
|
|
- [x] **DISC-02**: vmux identifie le cwd et le worktree git de chaque session
|
|
- [ ] **DISC-03**: vmux affiche le nom de la branche git de chaque session
|
|
- [x] **DISC-04**: vmux permet d'associer un label humain à une session (ex: "review MR !456")
|
|
|
|
### State Detection
|
|
|
|
- [ ] **STATE-01**: vmux détecte l'état de chaque session : travaille / attend input / idle
|
|
- [ ] **STATE-02**: vmux affiche un aperçu des dernières lignes de sortie de chaque session
|
|
- [ ] **STATE-03**: vmux distingue le type d'attente (permission prompt, question utilisateur, idle prompt)
|
|
- [x] **STATE-04**: vmux affiche le temps écoulé depuis que la session attend ("depuis 3 min")
|
|
|
|
### i3 Integration
|
|
|
|
- [ ] **I3-01**: vmux mappe chaque session à son workspace i3
|
|
- [ ] **I3-02**: vmux permet de switcher vers le workspace i3 d'une session en une action
|
|
- [ ] **I3-03**: vmux fournit un widget i3bar affichant le statut des sessions en temps réel
|
|
|
|
### Notifications
|
|
|
|
- [ ] **NOTIF-01**: vmux notifie (dunst) quand une session passe de "travaille" à "attend input"
|
|
- [ ] **NOTIF-02**: vmux supporte un mode focus qui supprime temporairement les notifications
|
|
|
|
## v2 Requirements
|
|
|
|
Deferred to future release. Tracked but not in current roadmap.
|
|
|
|
### Presentation
|
|
|
|
- **PRES-01**: TUI interactive avec Bubble Tea (navigation, détails, actions)
|
|
- **PRES-02**: Multi-écran awareness (quel écran affiche quel workspace)
|
|
|
|
### Integration
|
|
|
|
- **INTG-01**: Intégration avec piaire (timetracking, features)
|
|
- **INTG-02**: Répondre à Claude Code depuis vmux sans switcher de workspace
|
|
|
|
### Intelligence
|
|
|
|
- **INTL-01**: Debounce intelligent des notifications (pas de spam lors d'enchaînements tool_use)
|
|
- **INTL-02**: Priorité des notifications par type d'attente
|
|
|
|
## Out of Scope
|
|
|
|
| Feature | Reason |
|
|
|---------|--------|
|
|
| Terminal intégré | Complexité trop élevée, dispatcher suffit pour la v1 |
|
|
| Lancement de sessions Claude Code | vmux observe, ne crée pas |
|
|
| Gestion du timetracking | Couvert par piaire |
|
|
| Dashboard web | L'approche i3-native (CLI + i3bar) est plus cohérente avec le workflow |
|
|
|
|
## Traceability
|
|
|
|
Which phases cover which requirements. Updated during roadmap creation.
|
|
|
|
| Requirement | Phase | Status |
|
|
|-------------|-------|--------|
|
|
| DISC-01 | Phase 1 | Complete |
|
|
| DISC-02 | Phase 1 | Complete |
|
|
| DISC-03 | Phase 1 | Pending |
|
|
| DISC-04 | Phase 2 | Complete |
|
|
| STATE-01 | Phase 1 | Pending |
|
|
| STATE-02 | Phase 1 | Pending |
|
|
| STATE-03 | Phase 3 | Pending |
|
|
| STATE-04 | Phase 2 | Complete |
|
|
| I3-01 | Phase 2 | Pending |
|
|
| I3-02 | Phase 2 | Pending |
|
|
| I3-03 | Phase 4 | Pending |
|
|
| NOTIF-01 | Phase 4 | Pending |
|
|
| NOTIF-02 | Phase 4 | Pending |
|
|
|
|
**Coverage:**
|
|
- v1 requirements: 13 total
|
|
- Mapped to phases: 13
|
|
- Unmapped: 0
|
|
|
|
---
|
|
*Requirements defined: 2026-03-23*
|
|
*Last updated: 2026-03-23 after roadmap creation*
|