beads/cmd/bd/setup_test.go
Kevin Chan 59cfc4a000
[codex] Add Kiro setup recipe (#4535)
* Add Kiro setup recipe

* docs: register integrations/kiro in docs.json navigation

The docsync guard (TestEveryDocsPageIsPublished) requires every docs/ page
in the Mintlify nav; it landed after this PR was written.

Agent-Signature: claude-fable-5-high on behalf of maphew
Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>
Claude-Session: https://claude.ai/code/session_01P3JtQ3ukoVmfg6LCKcKBBh

---------

Co-authored-by: matt wilkie <maphew@gmail.com>
Co-authored-by: Claude Fable 5 <noreply@anthropic.com>
2026-07-27 22:28:43 -07:00

292 lines
7.9 KiB
Go

//go:build cgo
package main
import (
"os"
"path/filepath"
"strings"
"testing"
"github.com/steveyegge/beads/internal/beads"
"github.com/steveyegge/beads/internal/git"
"github.com/steveyegge/beads/internal/recipes"
)
func resetSetupResolutionCaches(t *testing.T) {
t.Helper()
beads.ResetCaches()
git.ResetCaches()
t.Cleanup(func() {
beads.ResetCaches()
git.ResetCaches()
})
}
func resetSetupGlobals(t *testing.T) {
t.Helper()
originalProject := setupProject
originalGlobal := setupGlobal
originalCheck := setupCheck
originalRemove := setupRemove
originalStealth := setupStealth
originalPrint := setupPrint
originalOutput := setupOutput
originalList := setupList
originalAdd := setupAdd
setupProject = false
setupGlobal = false
setupCheck = false
setupRemove = false
setupStealth = false
setupPrint = false
setupOutput = ""
setupList = false
setupAdd = ""
t.Cleanup(func() {
setupProject = originalProject
setupGlobal = originalGlobal
setupCheck = originalCheck
setupRemove = originalRemove
setupStealth = originalStealth
setupPrint = originalPrint
setupOutput = originalOutput
setupList = originalList
setupAdd = originalAdd
})
}
func TestLoadSetupRecipes_NoWorkspaceUsesBuiltinsOnly(t *testing.T) {
tmpDir := t.TempDir()
orphanBeadsDir := filepath.Join(tmpDir, ".beads")
if err := recipes.SaveUserRecipe(orphanBeadsDir, "myeditor", ".myeditor/rules.md"); err != nil {
t.Fatalf("SaveUserRecipe: %v", err)
}
t.Chdir(tmpDir)
t.Setenv("BEADS_DIR", "")
resetSetupResolutionCaches(t)
allRecipes, usingWorkspaceRecipes, err := loadSetupRecipes()
if err != nil {
t.Fatalf("loadSetupRecipes: %v", err)
}
if usingWorkspaceRecipes {
t.Fatal("expected built-in-only recipe set without an active workspace")
}
if _, ok := allRecipes["cursor"]; !ok {
t.Fatal("expected built-in cursor recipe to be available")
}
if _, ok := allRecipes["myeditor"]; ok {
t.Fatal("unexpected orphan custom recipe outside active workspace")
}
}
func TestListRecipes_NoWorkspaceShowsBuiltinOnlyNote(t *testing.T) {
tmpDir := t.TempDir()
orphanBeadsDir := filepath.Join(tmpDir, ".beads")
if err := recipes.SaveUserRecipe(orphanBeadsDir, "myeditor", ".myeditor/rules.md"); err != nil {
t.Fatalf("SaveUserRecipe: %v", err)
}
t.Chdir(tmpDir)
t.Setenv("BEADS_DIR", "")
resetSetupResolutionCaches(t)
out := captureStdout(t, func() error {
listRecipes()
return nil
})
if !strings.Contains(out, "cursor") {
t.Fatalf("expected built-in recipes in output, got:\n%s", out)
}
if !strings.Contains(out, "copilot") {
t.Fatalf("expected copilot recipe in output, got:\n%s", out)
}
if strings.Contains(out, "myeditor") {
t.Fatalf("unexpected orphan custom recipe in output:\n%s", out)
}
if !strings.Contains(out, "Note: No active beads workspace found. Showing built-in recipes only.") {
t.Fatalf("expected built-in-only note in output, got:\n%s", out)
}
if !strings.Contains(out, "Hint: "+diagHint()) {
t.Fatalf("expected diagnostic hint in output, got:\n%s", out)
}
}
func TestAddRecipe_NoWorkspaceReturnsActiveWorkspaceError(t *testing.T) {
tmpDir := t.TempDir()
t.Chdir(tmpDir)
t.Setenv("BEADS_DIR", "")
resetSetupResolutionCaches(t)
err := addRecipe("myeditor", ".myeditor/rules.md")
if err == nil {
t.Fatal("expected addRecipe to fail without active workspace")
}
if !strings.Contains(err.Error(), activeWorkspaceNotFoundError()) {
t.Fatalf("expected active-workspace error, got: %v", err)
}
if !strings.Contains(err.Error(), diagHint()) {
t.Fatalf("expected diagnostic hint, got: %v", err)
}
if _, statErr := os.Stat(filepath.Join(tmpDir, ".beads", "recipes.toml")); !os.IsNotExist(statErr) {
t.Fatalf("expected no local recipes.toml, got err=%v", statErr)
}
}
func TestLookupSetupRecipe_NoWorkspaceIgnoresOrphanCustomRecipes(t *testing.T) {
tmpDir := t.TempDir()
orphanBeadsDir := filepath.Join(tmpDir, ".beads")
if err := recipes.SaveUserRecipe(orphanBeadsDir, "myeditor", ".myeditor/rules.md"); err != nil {
t.Fatalf("SaveUserRecipe: %v", err)
}
t.Chdir(tmpDir)
t.Setenv("BEADS_DIR", "")
resetSetupResolutionCaches(t)
_, err := lookupSetupRecipe("myeditor")
if err == nil {
t.Fatal("expected custom recipe lookup to fail without active workspace")
}
if !strings.Contains(err.Error(), "workspace-local custom recipes require an active beads workspace") {
t.Fatalf("expected explicit no-workspace message, got: %v", err)
}
}
func TestRunRecipe_BuiltinFileRecipeWorksWithoutWorkspace(t *testing.T) {
tmpDir := t.TempDir()
t.Chdir(tmpDir)
t.Setenv("BEADS_DIR", "")
resetSetupResolutionCaches(t)
resetSetupGlobals(t)
out := captureStdout(t, func() error {
runRecipe("windsurf")
return nil
})
if !strings.Contains(out, "Installing Windsurf integration") {
t.Fatalf("expected install output, got:\n%s", out)
}
installedPath := filepath.Join(tmpDir, ".windsurf", "rules", "beads.md")
data, err := os.ReadFile(installedPath)
if err != nil {
t.Fatalf("ReadFile(%q): %v", installedPath, err)
}
if string(data) != recipes.Template {
t.Fatalf("installed recipe contents did not match template")
}
if _, err := os.Stat(filepath.Join(tmpDir, ".beads")); !os.IsNotExist(err) {
t.Fatalf("expected no local .beads directory to be created, got err=%v", err)
}
}
func TestRunRecipe_KiroWorksWithoutWorkspace(t *testing.T) {
tmpDir := t.TempDir()
t.Chdir(tmpDir)
t.Setenv("BEADS_DIR", "")
resetSetupResolutionCaches(t)
resetSetupGlobals(t)
out := captureStdout(t, func() error {
runRecipe("kiro")
return nil
})
if !strings.Contains(out, "Installing Kiro CLI integration") {
t.Fatalf("expected install output, got:\n%s", out)
}
installedPath := filepath.Join(tmpDir, ".kiro", "steering", "beads.md")
data, err := os.ReadFile(installedPath)
if err != nil {
t.Fatalf("ReadFile(%q): %v", installedPath, err)
}
if string(data) != recipes.Template {
t.Fatalf("installed Kiro recipe contents did not match template")
}
if _, err := os.Stat(filepath.Join(tmpDir, ".beads")); !os.IsNotExist(err) {
t.Fatalf("expected no local .beads directory to be created, got err=%v", err)
}
}
func TestRunRecipe_CopilotWorksWithoutWorkspace(t *testing.T) {
tmpDir := t.TempDir()
t.Chdir(tmpDir)
t.Setenv("BEADS_DIR", "")
resetSetupResolutionCaches(t)
resetSetupGlobals(t)
out := captureStdout(t, func() error {
runRecipe("copilot")
return nil
})
if !strings.Contains(out, "GitHub Copilot CLI integration installed") {
t.Fatalf("expected copilot install output, got:\n%s", out)
}
if _, err := os.Stat(filepath.Join(tmpDir, ".copilot-plugin", "plugin.json")); err != nil {
t.Fatalf("expected copilot plugin manifest: %v", err)
}
if _, err := os.Stat(filepath.Join(tmpDir, ".github", "copilot-instructions.md")); err != nil {
t.Fatalf("expected copilot instructions: %v", err)
}
}
func TestRunRecipe_CopilotCheckWorksWithoutWorkspace(t *testing.T) {
tmpDir := t.TempDir()
t.Chdir(tmpDir)
t.Setenv("BEADS_DIR", "")
resetSetupResolutionCaches(t)
resetSetupGlobals(t)
runRecipe("copilot")
resetSetupGlobals(t)
setupCheck = true
out := captureStdout(t, func() error {
runRecipe("copilot")
return nil
})
if !strings.Contains(out, ".copilot-plugin/plugin.json") {
t.Fatalf("expected plugin manifest in check output, got:\n%s", out)
}
if !strings.Contains(out, ".github/copilot-instructions.md") {
t.Fatalf("expected instructions file in check output, got:\n%s", out)
}
}
func TestRunRecipe_CopilotRemoveWorksWithoutWorkspace(t *testing.T) {
tmpDir := t.TempDir()
t.Chdir(tmpDir)
t.Setenv("BEADS_DIR", "")
resetSetupResolutionCaches(t)
resetSetupGlobals(t)
runRecipe("copilot")
resetSetupGlobals(t)
setupRemove = true
runRecipe("copilot")
if _, err := os.Stat(filepath.Join(tmpDir, ".copilot-plugin", "plugin.json")); !os.IsNotExist(err) {
t.Fatalf("expected plugin manifest to be removed, got err=%v", err)
}
if _, err := os.Stat(filepath.Join(tmpDir, ".github", "copilot-instructions.md")); !os.IsNotExist(err) {
t.Fatalf("expected copilot instructions to be removed, got err=%v", err)
}
}