Remove global daemon from docs, deprecate bd repos command

- Stub out 'bd repos' command with deprecation message
- Remove 140+ lines of global daemon/multi-repo docs from ADVANCED.md
- Add architecture section explaining daemon/MCP/beads roles (LSP model)
- Update AGENTS.md, MCP README, FAQ.md to emphasize per-project daemons
- Update commands/daemon.md and commands/repos.md

Closes #140

Global daemon was removed in v0.16.0 due to cross-project pollution
risks. bd now uses per-project local daemons (one per workspace) for
complete database isolation, following LSP architecture patterns.

Amp-Thread-ID: https://ampcode.com/threads/T-c45147dc-8939-43bf-8fbd-303ed4a8d845
Co-authored-by: Amp <amp@ampcode.com>
This commit is contained in:
Steve Yegge
2025-10-24 13:02:01 -07:00
parent 963181d7f8
commit f5feee0d20
8 changed files with 334 additions and 321 deletions

View File

@@ -11,14 +11,29 @@ import (
)
var reposCmd = &cobra.Command{
Use: "repos",
Short: "Multi-repository management (requires global daemon)",
Long: `Manage work across multiple repositories when using a global daemon.
Use: "repos",
Short: "Multi-repository management (DEPRECATED)",
Hidden: true,
Long: `DEPRECATED: This command required global daemon support, which has been removed.
This command requires a running global daemon (bd daemon --global).
It allows you to view and aggregate work across all cached repositories.`,
bd now uses per-project local daemons (LSP model) for complete database isolation.
Each project has its own daemon at .beads/bd.sock.
Global daemon was removed in v0.16.0 due to:
- Cross-project database pollution risks
- Git worktree conflicts
- Complexity in multi-workspace scenarios
For multi-repo workflows, use your editor/shell to switch between projects.`,
Run: func(cmd *cobra.Command, args []string) {
_ = cmd.Help()
fmt.Fprintf(os.Stderr, "Error: 'bd repos' command is deprecated and no longer functional\n\n")
fmt.Fprintf(os.Stderr, "Global daemon support was removed in v0.16.0.\n")
fmt.Fprintf(os.Stderr, "bd now uses per-project local daemons for database isolation.\n\n")
fmt.Fprintf(os.Stderr, "For multi-repo workflows:\n")
fmt.Fprintf(os.Stderr, " - Use your editor/shell to switch between project directories\n")
fmt.Fprintf(os.Stderr, " - Each project has its own daemon at .beads/bd.sock\n")
fmt.Fprintf(os.Stderr, " - Run 'bd ready' in each project individually\n\n")
os.Exit(1)
},
}