Merge pull request #2511 from MelsovCOZY/fix/global-prime-fallback

feat: support global ~/.config/beads/PRIME.md fallback (GH#2330)

Author: steveyegge

cmd/bd/prime.go

@@ -23,6 +23,26 @@ var (
 	primeExportMode  bool
 )
 
+// resolveGlobalPrimePath returns the path to ~/.config/beads/PRIME.md if it
+// exists. configDirOverride is used for testing; pass "" for production.
+func resolveGlobalPrimePath(configDirOverride string) string {
+	var configDir string
+	if configDirOverride != "" {
+		configDir = configDirOverride
+	} else {
+		var err error
+		configDir, err = os.UserConfigDir()
+		if err != nil {
+			return ""
+		}
+	}
+	p := filepath.Join(configDir, "beads", "PRIME.md")
+	if _, err := os.Stat(p); err == nil {
+		return p
+	}
+	return ""
+}
+
 var primeCmd = &cobra.Command{
 	Use:     "prime",
 	GroupID: "setup",
@@ -86,6 +106,14 @@ Workflow customization:
 				fmt.Print(string(content))
 				return
 			}
+			// Fall back to global config (~/.config/beads/PRIME.md)
+			// #nosec G304 -- path constructed from UserConfigDir which we control
+			if globalPath := resolveGlobalPrimePath(""); globalPath != "" {
+				if content, err := os.ReadFile(globalPath); err == nil {
+					fmt.Print(string(content))
+					return
+				}
+			}
 		}
 
 		// Output workflow context (adaptive based on MCP and stealth mode)

cmd/bd/prime_test.go

@@ -2,6 +2,8 @@ package main
 
 import (
 	"bytes"
+	"os"
+	"path/filepath"
 	"strings"
 	"testing"
 )
@@ -187,3 +189,40 @@ func stubPrimeHasGitRemote(hasRemote bool) func() {
 		primeHasGitRemote = original
 	}
 }
+
+func TestPrimeGlobalFallback(t *testing.T) {
+	// Create a temp directory to act as config dir
+	tmpDir := t.TempDir()
+	beadsConfigDir := filepath.Join(tmpDir, "beads")
+	if err := os.MkdirAll(beadsConfigDir, 0755); err != nil {
+		t.Fatalf("mkdir: %v", err)
+	}
+
+	content := "# Global PRIME override\nCustom instructions here.\n"
+	if err := os.WriteFile(filepath.Join(beadsConfigDir, "PRIME.md"), []byte(content), 0644); err != nil {
+		t.Fatalf("write PRIME.md: %v", err)
+	}
+
+	// Call the helper that resolves the global prime path
+	got := resolveGlobalPrimePath(tmpDir)
+	if got == "" {
+		t.Fatal("resolveGlobalPrimePath returned empty, want path to global PRIME.md")
+	}
+
+	data, err := os.ReadFile(got)
+	if err != nil {
+		t.Fatalf("ReadFile(%s): %v", got, err)
+	}
+	if string(data) != content {
+		t.Errorf("content = %q, want %q", string(data), content)
+	}
+}
+
+func TestPrimeGlobalFallback_Missing(t *testing.T) {
+	// When no global PRIME.md exists, should return empty string
+	tmpDir := t.TempDir()
+	got := resolveGlobalPrimePath(tmpDir)
+	if got != "" {
+		t.Errorf("resolveGlobalPrimePath = %q, want empty for missing file", got)
+	}
+}