migrate

var OrphanCmd = &cobra.Command{
	Use:   "orphan",
	Short: "Manage orphaned CANARY tokens (tokens without specifications)",
	Long: `Generate specifications and plans for requirements with orphaned tokens.

Orphaned requirements are those that have CANARY tokens in the codebase but no
formal specification file in .canary/specs/. This typically happens when migrating
legacy code or when tokens were added without following the requirement-first workflow.

The orphan command:
1. Detects requirements with tokens but no specs
2. Generates spec.md from existing token metadata
3. Generates plan.md reflecting current implementation state
4. Filters out documentation/example tokens automatically`,
	Example: `  # Detect orphaned requirements
  canary orphan detect

  # Migrate a specific requirement
  canary orphan run CBIN-105

  # Migrate all orphaned requirements
  canary orphan run --all

  # Preview migration without creating files
  canary orphan run --all --dry-run`,
}