11 KiB
11 KiB
phase, plan, type, wave, depends_on, files_modified, autonomous, requirements, must_haves
| phase | plan | type | wave | depends_on | files_modified | autonomous | requirements | must_haves | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
| 04-notifications-et-i3bar | 01 | execute | 1 |
|
true |
|
|
Purpose: Alerter l'utilisateur via dunst quand une session passe de Working a Needs Input, avec possibilite de supprimer temporairement les notifications via vmux focus <minutes>.
Output: notify.go, focus.go, integration dans daemon/hook, sous-commande vmux focus.
<execution_context> @$HOME/.claude/get-shit-done/workflows/execute-plan.md @$HOME/.claude/get-shit-done/templates/summary.md </execution_context>
@.planning/PROJECT.md @.planning/ROADMAP.md @.planning/STATE.md @.planning/phases/04-notifications-et-i3bar/04-RESEARCH.mdFrom daemon.go:
type Daemon struct {
registry *SessionRegistry
labels *LabelStore
sockPath string
procDir string
claudeDir string
workspaceResolver func(claudePID int) string
i3commander I3Commander
pollInterval time.Duration
stopCh chan struct{}
listener net.Listener
hookPort int
httpServer *http.Server
lastHookTime time.Time
mu sync.Mutex
}
func NewDaemon(sockPath, procDir, claudeDir string, labels *LabelStore) *Daemon
func (d *Daemon) handleConnection(conn net.Conn) // switch req.Action
From hook.go:
func (d *Daemon) processHookEvent(event HookEvent) // maps hook -> registry update
func (r *SessionRegistry) UpdateFromHook(sessionID, state, waitType, cwd string) // tracks PrevState
From protocol.go:
type Request struct {
Action string `json:"action"`
Args json.RawMessage `json:"args,omitempty"`
}
type Response struct {
OK bool `json:"ok"`
Error string `json:"error,omitempty"`
Sessions []SessionInfo `json:"sessions,omitempty"`
}
type SessionInfo struct {
PID, SessionID, Cwd, GitBranch, State, Preview, Workspace, Label, WaitType string
WaitingSince *time.Time
}
From daemon.go (TrackedSession):
type TrackedSession struct {
Info SessionInfo
PrevState string
}
**notify.go:**
- Interface `Notifier` avec methode `Notify(title, body string) error`
- `ExecNotifier` struct vide. Notify() utilise `exec.CommandContext` avec timeout 5s, appelle `notify-send --urgency=critical --app-name=vmux title body`. Per D-03: notify-send via os/exec.
- `NullNotifier` struct vide. Notify() retourne nil.
- Fonction `shortName(s SessionInfo) string` : retourne Label si non-vide, sinon `filepath.Base(s.Cwd)`.
**focus.go:**
- `FocusTimer` struct avec `mu sync.Mutex` et `expires time.Time`.
- `Set(d time.Duration)` : `expires = time.Now().Add(d)` sous verrou.
- `IsActive() bool` : `time.Now().Before(expires)` sous verrou. Per D-04: timer uniquement.
- `Remaining() time.Duration` : `time.Until(expires)` sous verrou, clamp a 0 si negatif.
Per D-05: le focus ne bloque que les notifications, pas l'i3bar.
**daemon.go:**
- Ajouter champs `notifier Notifier` et `focus *FocusTimer` dans Daemon struct
- Dans NewDaemon: initialiser `focus: &FocusTimer{}` et `notifier: &ExecNotifier{}`
- Dans handleConnection, ajouter case "focus":
- Parser FocusArgs, appeler `d.focus.Set(time.Duration(args.Minutes) * time.Minute)`
- Repondre `Response{OK: true, FocusRemaining: d.focus.Remaining().Minutes()}`
**hook.go — processHookEvent:**
- AVANT l'appel a `d.registry.UpdateFromHook`, lire le PrevState:
```go
d.registry.mu.RLock()
prevState := ""
if ts, ok := d.registry.sessions[event.SessionID]; ok {
prevState = ts.PrevState
}
d.registry.mu.RUnlock()
```
- APRES `d.registry.UpdateFromHook`, si `state == "Needs Input" && prevState == "Working"` (per D-01):
- Si `!d.focus.IsActive()` (per D-05): appeler `d.notifier.Notify("vmux: "+shortName(info), "Session needs input ("+waitType+")")`
- Pour le shortName, utiliser le SessionInfo du registre (qui a Label et Cwd)
**main.go:**
- Ajouter case "focus" dans le switch CLI:
- Parser argument `filteredArgs[1]` comme entier (minutes). Erreur si absent ou invalide. Per D-04: timer uniquement, pas de toggle.
- Envoyer action "focus" avec FocusArgs au daemon via client
- Afficher "Focus mode: notifications suppressed for N minutes"
- Ajouter "focus" dans printUsage: ` focus <minutes> Suppress notifications for N minutes`
- Dans runDaemon: le notifier est deja initialise par NewDaemon, rien a changer
**Pitfall PrevState (de RESEARCH):** Lire PrevState AVANT UpdateFromHook sous verrou separe. La lecture RLock puis l'ecriture Lock dans UpdateFromHook sont safe car RLock se relache avant.
**Pitfall notify-send timeout (de RESEARCH):** Deja gere dans ExecNotifier avec CommandContext 5s.
<success_criteria>
- Transition Working -> Needs Input declenche une notification dunst (via notify-send)
- Transitions Idle -> Needs Input et Working -> Idle ne declenchent PAS de notification
vmux focus 30supprime les notifications pendant 30 minutes- Le focus expire automatiquement
- Tous les tests passent avec -race </success_criteria>