backlog doctor
backlog doctor
Diagnose and fix task ID conflicts
Synopsis
Diagnose and fix task ID conflicts that can occur when creating tasks in separate Git branches. Conflicts arise when multiple branches generate the same task IDs.
This command provides conflict detection and resolution capabilities to maintain task ID uniqueness and data integrity.
Conflict types detected: - Duplicate IDs (same ID in multiple files) - Orphaned children (tasks with non-existent parents) - Invalid hierarchy (parent-child ID mismatch)
Examples: backlog doctor # Detect conflicts in text format backlog doctor --json # Detect conflicts in JSON format backlog doctor --fix # Detect and automatically fix conflicts backlog doctor --fix --dry-run # Show what would be fixed without making changes backlog doctor --fix --strategy=auto # Use auto-renumbering strategy
backlog doctor [flags]
Options
Environment Variables
(name) (default)
AUTO-COMMIT false
FOLDER .backlog
LOG-FILE
LOG-FORMAT text
LOG-LEVEL info
Flags
--dry-run Show what would be changed without making changes (use with --fix)
--fix Automatically fix detected conflicts
-h, --help help for doctor
-j, --json Output in JSON format
--strategy string Resolution strategy when using --fix (chronological|auto|manual) (default "chronological")
Options inherited from parent commands
--auto-commit Auto-committing changes to git repository
--folder string Directory for backlog tasks (default ".backlog")
--log-file string Log file path (defaults to stderr)
--log-format string Log format (json, text) (default "text")
--log-level string Log level (debug, info, warn, error) (default "info")
SEE ALSO
- backlog - Backlog is a git-native, markdown-based task manager