bd sync was removed as a command but references persisted in: - CLI help text (--dolt-auto-commit flag description) - Code comments (dolt_autocommit.go, init_contributor.go) - Agent setup generators (aider, cursor, junie, mux) - Doctor agent remediation commands - Jujutsu hook alias (init_git_hooks.go) - Copilot integration docs All references now point to the current commands: - bd dolt commit (for committing changes) - bd dolt push (for pushing to remote) Tests updated to match. Complements #2389 (config/sync.mode removal) and #2419 (command removal). Remaining stale references in other docs tracked in GH#2435.
230 lines
6.8 KiB
Go
230 lines
6.8 KiB
Go
package setup
|
|
|
|
import (
|
|
"encoding/json"
|
|
"fmt"
|
|
"os"
|
|
)
|
|
|
|
const junieGuidelinesTemplate = `# Beads Issue Tracking Instructions
|
|
|
|
This project uses **Beads (bd)** for issue tracking. Use the bd CLI or MCP tools for all task management.
|
|
|
|
## Core Workflow Rules
|
|
|
|
1. **Track ALL work in bd** - Never use markdown TODOs or comment-based task lists
|
|
2. **Check ready work first** - Run ` + "`bd ready`" + ` to find unblocked issues
|
|
3. **Always include descriptions** - Provide meaningful context when creating issues
|
|
4. **Link discovered work** - Use ` + "`discovered-from`" + ` dependencies for issues found during work
|
|
5. **Sync at session end** - Run ` + "`bd dolt push`" + ` before ending your session
|
|
|
|
## Quick Command Reference
|
|
|
|
### Finding Work
|
|
` + "```bash" + `
|
|
bd ready # Show unblocked issues ready for work
|
|
bd list --status open # List all open issues
|
|
bd show <id> # View issue details
|
|
bd blocked # Show blocked issues and their blockers
|
|
` + "```" + `
|
|
|
|
### Creating Issues
|
|
` + "```bash" + `
|
|
bd create "Title" --description="Details" -t bug|feature|task -p 0-4 --json
|
|
bd create "Found bug" --description="Details" --deps discovered-from:bd-42 --json
|
|
` + "```" + `
|
|
|
|
### Working on Issues
|
|
` + "```bash" + `
|
|
bd update <id> --claim # Claim work atomically
|
|
bd update <id> --priority 1 # Change priority
|
|
bd close <id> --reason "Completed" # Mark complete
|
|
` + "```" + `
|
|
|
|
### Dependencies
|
|
` + "```bash" + `
|
|
bd dep add <issue> <depends-on> # Add dependency (issue depends on depends-on)
|
|
bd dep add <issue> <depends-on> --type=related # Soft link
|
|
` + "```" + `
|
|
|
|
### Syncing
|
|
` + "```bash" + `
|
|
bd dolt push # ALWAYS run at session end - commits and pushes changes
|
|
` + "```" + `
|
|
|
|
## Issue Types
|
|
|
|
- ` + "`bug`" + ` - Something broken that needs fixing
|
|
- ` + "`feature`" + ` - New functionality
|
|
- ` + "`task`" + ` - Work item (tests, docs, refactoring)
|
|
- ` + "`epic`" + ` - Large feature composed of multiple issues
|
|
- ` + "`chore`" + ` - Maintenance work (dependencies, tooling)
|
|
|
|
## Priorities
|
|
|
|
- ` + "`0`" + ` - Critical (security, data loss, broken builds)
|
|
- ` + "`1`" + ` - High (major features, important bugs)
|
|
- ` + "`2`" + ` - Medium (default, nice-to-have)
|
|
- ` + "`3`" + ` - Low (polish, optimization)
|
|
- ` + "`4`" + ` - Backlog (future ideas)
|
|
|
|
## MCP Tools Available
|
|
|
|
If the MCP server is configured, you can use these tools directly:
|
|
- ` + "`mcp_beads_ready`" + ` - Find ready tasks
|
|
- ` + "`mcp_beads_list`" + ` - List issues with filters
|
|
- ` + "`mcp_beads_show`" + ` - Show issue details
|
|
- ` + "`mcp_beads_create`" + ` - Create new issues
|
|
- ` + "`mcp_beads_update`" + ` - Update issue status/priority
|
|
- ` + "`mcp_beads_close`" + ` - Close completed issues
|
|
- ` + "`mcp_beads_dep`" + ` - Manage dependencies
|
|
- ` + "`mcp_beads_blocked`" + ` - Show blocked issues
|
|
- ` + "`mcp_beads_stats`" + ` - Get issue statistics
|
|
|
|
## Important Rules
|
|
|
|
- ✅ Use bd for ALL task tracking
|
|
- ✅ Always use ` + "`--json`" + ` flag for programmatic use
|
|
- ✅ Link discovered work with ` + "`discovered-from`" + ` dependencies
|
|
- ✅ Check ` + "`bd ready`" + ` before asking "what should I work on?"
|
|
- ✅ Run ` + "`bd dolt push`" + ` at end of session
|
|
- ❌ Do NOT create markdown TODO lists
|
|
- ❌ Do NOT use external issue trackers
|
|
- ❌ Do NOT duplicate tracking systems
|
|
|
|
For more details, run ` + "`bd --help`" + ` or see the project's AGENTS.md file.
|
|
`
|
|
|
|
// junieMCPConfig generates the MCP configuration for Junie
|
|
func junieMCPConfig() map[string]interface{} {
|
|
return map[string]interface{}{
|
|
"mcpServers": map[string]interface{}{
|
|
"beads": map[string]interface{}{
|
|
"command": "bd",
|
|
"args": []string{"mcp"},
|
|
},
|
|
},
|
|
}
|
|
}
|
|
|
|
// InstallJunie installs Junie integration
|
|
func InstallJunie() {
|
|
guidelinesPath := ".junie/guidelines.md"
|
|
mcpPath := ".junie/mcp/mcp.json"
|
|
|
|
fmt.Println("Installing Junie integration...")
|
|
|
|
// Ensure .junie directory exists
|
|
if err := EnsureDir(".junie", 0755); err != nil {
|
|
FatalError("%v", err)
|
|
}
|
|
|
|
// Ensure .junie/mcp directory exists
|
|
if err := EnsureDir(".junie/mcp", 0755); err != nil {
|
|
FatalError("%v", err)
|
|
}
|
|
|
|
// Write guidelines file
|
|
if err := atomicWriteFile(guidelinesPath, []byte(junieGuidelinesTemplate)); err != nil {
|
|
FatalError("write guidelines: %v", err)
|
|
}
|
|
|
|
// Write MCP config file
|
|
mcpConfig := junieMCPConfig()
|
|
mcpData, err := json.MarshalIndent(mcpConfig, "", " ")
|
|
if err != nil {
|
|
FatalError("marshal MCP config: %v", err)
|
|
}
|
|
|
|
if err := atomicWriteFile(mcpPath, mcpData); err != nil {
|
|
FatalError("write MCP config: %v", err)
|
|
}
|
|
|
|
fmt.Printf("\n✓ Junie integration installed\n")
|
|
fmt.Printf(" Guidelines: %s (agent instructions)\n", guidelinesPath)
|
|
fmt.Printf(" MCP Config: %s (MCP server configuration)\n", mcpPath)
|
|
fmt.Println("\nJunie will automatically read these files on session start.")
|
|
fmt.Println("The MCP server provides direct access to beads tools.")
|
|
}
|
|
|
|
// CheckJunie checks if Junie integration is installed
|
|
func CheckJunie() {
|
|
guidelinesPath := ".junie/guidelines.md"
|
|
mcpPath := ".junie/mcp/mcp.json"
|
|
|
|
guidelinesExists := false
|
|
mcpExists := false
|
|
|
|
if _, err := os.Stat(guidelinesPath); err == nil {
|
|
guidelinesExists = true
|
|
}
|
|
if _, err := os.Stat(mcpPath); err == nil {
|
|
mcpExists = true
|
|
}
|
|
|
|
if guidelinesExists && mcpExists {
|
|
fmt.Println("✓ Junie integration installed")
|
|
fmt.Printf(" Guidelines: %s\n", guidelinesPath)
|
|
fmt.Printf(" MCP Config: %s\n", mcpPath)
|
|
return
|
|
}
|
|
|
|
if guidelinesExists {
|
|
fmt.Println("⚠ Partial Junie integration (guidelines only)")
|
|
fmt.Printf(" Guidelines: %s\n", guidelinesPath)
|
|
fmt.Println(" Missing: MCP config")
|
|
FatalErrorWithHint("partial Junie integration", "Run: bd setup junie (to complete installation)")
|
|
}
|
|
|
|
if mcpExists {
|
|
fmt.Println("⚠ Partial Junie integration (MCP only)")
|
|
fmt.Printf(" MCP Config: %s\n", mcpPath)
|
|
fmt.Println(" Missing: Guidelines")
|
|
FatalErrorWithHint("partial Junie integration", "Run: bd setup junie (to complete installation)")
|
|
}
|
|
|
|
FatalErrorWithHint("Junie integration not installed", "Run: bd setup junie")
|
|
}
|
|
|
|
// RemoveJunie removes Junie integration
|
|
func RemoveJunie() {
|
|
guidelinesPath := ".junie/guidelines.md"
|
|
mcpPath := ".junie/mcp/mcp.json"
|
|
mcpDir := ".junie/mcp"
|
|
junieDir := ".junie"
|
|
|
|
fmt.Println("Removing Junie integration...")
|
|
|
|
removed := false
|
|
|
|
// Remove guidelines
|
|
if err := os.Remove(guidelinesPath); err != nil {
|
|
if !os.IsNotExist(err) {
|
|
FatalError("failed to remove guidelines: %v", err)
|
|
}
|
|
} else {
|
|
removed = true
|
|
}
|
|
|
|
// Remove MCP config
|
|
if err := os.Remove(mcpPath); err != nil {
|
|
if !os.IsNotExist(err) {
|
|
FatalError("failed to remove MCP config: %v", err)
|
|
}
|
|
} else {
|
|
removed = true
|
|
}
|
|
|
|
// Try to remove .junie/mcp directory if empty
|
|
_ = os.Remove(mcpDir)
|
|
|
|
// Try to remove .junie directory if empty
|
|
_ = os.Remove(junieDir)
|
|
|
|
if !removed {
|
|
fmt.Println("No Junie integration files found")
|
|
return
|
|
}
|
|
|
|
fmt.Println("✓ Removed Junie integration")
|
|
}
|