beads/cmd/bd/backup_auto.go
matt wilkie b8ec14d29c
fix: surface auto-export and auto-backup errors to stderr (#3122)
* fix: make auto-export and auto-backup errors visible on stderr

Previously, failures in auto-export (JSONL flush) and auto-backup were
logged only via debug.Logf, invisible to normal users. One user lost 46
issues because JSONL export silently stopped working with no warnings.

Upgrade critical error paths from debug.Logf to fmt.Fprintf(os.Stderr)
so users see warnings when their backup/export pipeline breaks. Keep
debug.Logf for non-critical diagnostics (throttle, no-change skip).

Closes #2489

Co-Authored-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com>

* docs: remove stale sync references

---------

Co-authored-by: Claude Opus 4.6 (1M context) <noreply@anthropic.com>
2026-04-07 20:37:13 -07:00

89 lines
2.6 KiB
Go

package main
import (
"context"
"fmt"
"os"
"time"
"github.com/steveyegge/beads/internal/config"
"github.com/steveyegge/beads/internal/debug"
"github.com/steveyegge/beads/internal/storage"
)
// isBackupAutoEnabled returns whether backup should run.
// If user explicitly configured backup.enabled, use that.
// Otherwise, auto-enable when a git remote exists.
func isBackupAutoEnabled() bool {
if config.GetValueSource("backup.enabled") != config.SourceDefault {
return config.GetBool("backup.enabled")
}
return primeHasGitRemote()
}
// maybeAutoBackup runs a Dolt-native backup if enabled and the throttle interval has passed.
// Called from PersistentPostRun after auto-commit.
func maybeAutoBackup(ctx context.Context) {
// Skip backup entirely when running as a git hook (post-checkout, post-merge, etc.).
// Git hooks call 'bd hooks run' which goes through PersistentPostRun — without this
// guard, every git checkout/merge/rebase triggers a backup on the current branch.
if os.Getenv("BD_GIT_HOOK") == "1" {
debug.Logf("backup: skipping — running as git hook\n")
return
}
if !isBackupAutoEnabled() {
return
}
if store == nil {
return
}
if lm, ok := storage.UnwrapStore(store).(storage.LifecycleManager); ok && lm.IsClosed() {
return
}
dir, err := backupDir()
if err != nil {
fmt.Fprintf(os.Stderr, "Warning: auto-backup skipped: %v\n", err)
return
}
state, err := loadBackupState(dir)
if err != nil {
fmt.Fprintf(os.Stderr, "Warning: auto-backup skipped: %v\n", err)
return
}
// Throttle: skip if we backed up recently
interval := config.GetDuration("backup.interval")
if interval == 0 {
interval = 15 * time.Minute
}
if !state.Timestamp.IsZero() && time.Since(state.Timestamp) < interval {
debug.Logf("backup: throttled (last backup %s ago, interval %s)\n",
time.Since(state.Timestamp).Round(time.Second), interval)
return
}
// Change detection: skip if nothing changed
currentCommit, err := store.GetCurrentCommit(ctx)
if err != nil {
fmt.Fprintf(os.Stderr, "Warning: auto-backup skipped: failed to get current commit: %v\n", err)
return
}
if currentCommit == state.LastDoltCommit && state.LastDoltCommit != "" {
debug.Logf("backup: no changes since last backup\n")
return
}
// Run the backup (force=true since we already checked change detection above)
if _, err := runBackupExport(ctx, true); err != nil {
if !isQuiet() && !jsonOutput {
fmt.Fprintf(os.Stderr, "Warning: auto-backup failed: %v\n", err)
}
debug.Logf("backup: error: %v\n", err)
return
}
debug.Logf("backup: completed successfully\n")
}