Files
beads/cmd/bd/direct_mode.go
Steve Yegge 8b8a662acb Fix fresh clone UX with friendly error messages (bd-dmb)
When opening a database that exists but is missing issue_prefix config
(typical in fresh clone scenarios), show a helpful error message instead
of cryptic migration invariant errors.

The new message:
- Explains the database needs initialization
- Detects if a JSONL file exists and shows the issue count
- Suggests the exact command to run: bd import -i <path>
- Falls back to suggesting bd init --prefix if no JSONL exists

🤖 Generated with [Claude Code](https://claude.com/claude-code)

Co-Authored-By: Claude <noreply@anthropic.com>
2025-11-27 22:40:57 -08:00

91 lines
2.1 KiB
Go

package main
import (
"fmt"
"path/filepath"
"github.com/steveyegge/beads/internal/beads"
"github.com/steveyegge/beads/internal/debug"
"github.com/steveyegge/beads/internal/storage/sqlite"
)
// ensureDirectMode makes sure the CLI is operating in direct-storage mode.
// If the daemon is active, it is cleanly disconnected and the shared store is opened.
func ensureDirectMode(reason string) error {
if daemonClient != nil {
if err := fallbackToDirectMode(reason); err != nil {
return err
}
return nil
}
return ensureStoreActive()
}
// fallbackToDirectMode disables the daemon client and ensures a local store is ready.
func fallbackToDirectMode(reason string) error {
disableDaemonForFallback(reason)
return ensureStoreActive()
}
// disableDaemonForFallback closes the daemon client and updates status metadata.
func disableDaemonForFallback(reason string) {
if daemonClient != nil {
_ = daemonClient.Close()
daemonClient = nil
}
daemonStatus.Mode = "direct"
daemonStatus.Connected = false
daemonStatus.Degraded = true
if reason != "" {
daemonStatus.Detail = reason
}
if daemonStatus.FallbackReason == FallbackNone {
daemonStatus.FallbackReason = FallbackDaemonUnsupported
}
if reason != "" {
debug.Logf("Debug: %s\n", reason)
}
}
// ensureStoreActive guarantees that a local SQLite store is initialized and tracked.
func ensureStoreActive() error {
storeMutex.Lock()
active := storeActive && store != nil
storeMutex.Unlock()
if active {
return nil
}
if dbPath == "" {
if found := beads.FindDatabasePath(); found != "" {
dbPath = found
} else {
return fmt.Errorf("no beads database found. Hint: run 'bd init' in this directory")
}
}
sqlStore, err := sqlite.New(rootCtx, dbPath)
if err != nil {
// Check for fresh clone scenario (bd-dmb)
if isFreshCloneError(err) {
beadsDir := filepath.Dir(dbPath)
handleFreshCloneError(err, beadsDir)
return fmt.Errorf("database not initialized")
}
return fmt.Errorf("failed to open database: %w", err)
}
storeMutex.Lock()
store = sqlStore
storeActive = true
storeMutex.Unlock()
if autoImportEnabled {
autoImportIfNewer()
}
return nil
}