Add event-driven daemon architecture (Phase 1 foundation)

- Add fsnotify dependency for file watching - Create daemon_debouncer.go: batch rapid events (500ms window) - Create daemon_watcher.go: monitor JSONL and git refs changes - Create daemon_event_loop.go: event-driven sync loop - Add mutation channel to RPC server (create/update/close events) - Add BEADS_DAEMON_MODE env var (poll/events, default: poll) Phase 1 implementation: opt-in via BEADS_DAEMON_MODE=events Target: <500ms latency (vs 5000ms), ~60% CPU reduction Related: bd-49 (epic), bd-50, bd-51, bd-53, bd-54, bd-55, bd-56 Amp-Thread-ID: https://ampcode.com/threads/T-35a3d0d7-4e19-421d-8392-63755035036e Co-authored-by: Amp <amp@ampcode.com>
2025-10-28 13:12:37 -07:00
parent 97c676077d
commit 781e300d33
8 changed files with 2527 additions and 1 deletions
--- a/cmd/bd/daemon_event_loop.go
+++ b/cmd/bd/daemon_event_loop.go
@@ -0,0 +1,124 @@
+package main
+
+import (
+	"context"
+	"os"
+	"os/signal"
+	"time"
+
+	"github.com/steveyegge/beads/internal/rpc"
+	"github.com/steveyegge/beads/internal/storage"
+)
+
+// runEventDrivenLoop implements event-driven daemon architecture.
+// Replaces polling ticker with reactive event handlers for:
+// - File system changes (JSONL modifications)
+// - RPC mutations (create, update, delete)
+// - Git operations (via hooks, optional)
+func runEventDrivenLoop(
+	ctx context.Context,
+	cancel context.CancelFunc,
+	server *rpc.Server,
+	serverErrChan chan error,
+	store storage.Storage,
+	jsonlPath string,
+	doExport func(),
+	doAutoImport func(),
+	log daemonLogger,
+) {
+	sigChan := make(chan os.Signal, 1)
+	signal.Notify(sigChan, daemonSignals...)
+	defer signal.Stop(sigChan)
+
+	// Debounced sync actions
+	exportDebouncer := NewDebouncer(500*time.Millisecond, func() {
+		log.log("Export triggered by mutation events")
+		doExport()
+	})
+	defer exportDebouncer.Cancel()
+
+	importDebouncer := NewDebouncer(500*time.Millisecond, func() {
+		log.log("Import triggered by file change")
+		doAutoImport()
+	})
+	defer importDebouncer.Cancel()
+
+	// Start file watcher for JSONL changes
+	watcher, err := NewFileWatcher(jsonlPath, func() {
+		importDebouncer.Trigger()
+	})
+	if err != nil {
+		log.log("WARNING: File watcher unavailable (%v), mutations will trigger export only", err)
+		watcher = nil
+	} else {
+		watcher.Start(ctx, log)
+		defer watcher.Close()
+	}
+
+	// Handle mutation events from RPC server
+	mutationChan := server.MutationChan()
+	go func() {
+		for {
+			select {
+			case event := <-mutationChan:
+				log.log("Mutation detected: %s %s", event.Type, event.IssueID)
+				exportDebouncer.Trigger()
+
+			case <-ctx.Done():
+				return
+			}
+		}
+	}()
+
+	// Optional: Periodic health check (not a sync poll)
+	healthTicker := time.NewTicker(60 * time.Second)
+	defer healthTicker.Stop()
+
+	for {
+		select {
+		case <-healthTicker.C:
+			// Periodic health validation (not sync)
+			checkDaemonHealth(ctx, store, log)
+
+		case sig := <-sigChan:
+			if isReloadSignal(sig) {
+				log.log("Received reload signal, ignoring")
+				continue
+			}
+			log.log("Received signal %v, shutting down...", sig)
+			cancel()
+			if err := server.Stop(); err != nil {
+				log.log("Error stopping server: %v", err)
+			}
+			return
+
+		case <-ctx.Done():
+			log.log("Context canceled, shutting down")
+			if watcher != nil {
+				watcher.Close()
+			}
+			if err := server.Stop(); err != nil {
+				log.log("Error stopping server: %v", err)
+			}
+			return
+
+		case err := <-serverErrChan:
+			log.log("RPC server failed: %v", err)
+			cancel()
+			if watcher != nil {
+				watcher.Close()
+			}
+			return
+		}
+	}
+}
+
+// checkDaemonHealth performs periodic health validation.
+// Separate from sync operations - just validates state.
+func checkDaemonHealth(ctx context.Context, store storage.Storage, log daemonLogger) {
+	// TODO: Add health checks:
+	// - Database integrity check
+	// - Disk space check
+	// - Memory usage check
+	// For now, this is a no-op placeholder
+}