complete

Planning with Files - Complete Worktree Task

You are now completing a worktree task. This will:

1. Verify all phases are complete
2. CRITICAL: Commit code changes (planning files excluded)
3. Delete planning files from the worktree
4. Navigate to the root directory
5. Merge the task branch to target branch
6. Remove the worktree
7. Delete the task branch

Path Storage Modes

This command works with both new and legacy path storage modes:

New Mode (Default)

• Worktrees in: ~/.plan-cascade/<project-id>/.worktree/
• State files in: ~/.plan-cascade/<project-id>/.state/
• Cleanup removes files from user data directory

Legacy Mode

• Worktrees in: <project-root>/.worktree/
• State files in project root

The command auto-detects which mode is active based on .planning-config.json contents.

Step 1: Detect Current Location

Check if we're in a worktree or the root directory:

if [ -f ".planning-config.json" ]; then
    # We're in a worktree directory
    echo "Currently in worktree directory: $(pwd)"
    IN_WORKTREE=true
else
    # We're not in a worktree, check if there are any worktrees
    IN_WORKTREE=false

    # Check for worktrees
    WORKTREES=$(git worktree list 2>/dev/null | grep -v "\bare$" | wc -l)

    if [ "$WORKTREES" -eq 0 ]; then
        echo "ERROR: No worktrees found."
        echo "This command requires an existing worktree."
        echo ""
        echo "Create one first with:"
        echo "  /plan-cascade:worktree <task-name> <branch>"
        exit 1
    fi

    echo "Not in a worktree directory. Found $WORKTREES worktree(s):"
    echo ""
    git worktree list
    echo ""

    # Find all worktrees with .planning-config.json (check both new and legacy locations)
    echo "Scanning for planning worktrees..."
    WORKTREE_LIST=()

    # Get worktree base directory from PathResolver
    WORKTREE_BASE=$(uv run python -c "from plan_cascade.state.path_resolver import PathResolver; from pathlib import Path; print(PathResolver(Path.cwd()).get_worktree_dir())" 2>/dev/null || echo ".worktree")

    while IFS= read -r line; do
        worktree_path=$(echo "$line" | awk '{print $1}')
        worktree_branch=$(echo "$line" | awk '{print $2}')

        # Check if this is a planning worktree
        if [ -f "$worktree_path/.planning-config.json" ]; then
            # Exclude hybrid mode worktrees (those use /plan-cascade:hybrid-complete)
            mode=$(jq -r '.mode // empty' "$worktree_path/.planning-config.json" 2>/dev/null)
            if [ "$mode" != "hybrid" ]; then
                task_name=$(jq -r '.task_name // empty' "$worktree_path/.planning-config.json" 2>/dev/null)
                WORKTREE_LIST+=("$worktree_path|$task_name|$worktree_branch")
            fi
        fi
    done < <(git worktree list 2>/dev/null | grep -v "\bare$")

    if [ ${#WORKTREE_LIST[@]} -eq 0 ]; then
        echo "ERROR: No planning worktrees found."
        echo "Found worktrees but none are in planning mode."
        echo ""
        echo "Note: Hybrid mode worktrees should use /plan-cascade:hybrid-complete"
        exit 1
    fi

    echo "Found ${#WORKTREE_LIST[@]} planning worktree(s):"
    echo ""

    # Display options
    for i in "${!WORKTREE_LIST[@]}"; do
        IFS='|' read -r path name branch <<< "${WORKTREE_LIST[$i]}"
        echo "  [$((i+1))] $name"
        echo "      Path: $path"
        echo "      Branch: $branch"
        echo ""
    done

    # Ask user to select
    echo "Which worktree would you like to complete?"
    read -p "Enter number (or 0 to cancel): " selection

    if [ "$selection" = "0" ]; then
        echo "Cancelled."
        exit 0
    fi

    if [ "$selection" -lt 1 ] || [ "$selection" -gt ${#WORKTREE_LIST[@]} ]; then
        echo "Invalid selection."
        exit 1
    fi

    # Get the selected worktree
    selected="${WORKTREE_LIST[$((selection-1))]}"
    IFS='|' read -r WORKTREE_PATH TASK_NAME TASK_BRANCH <<< "$selected"

    echo ""
    echo "Selected: $TASK_NAME"
    echo "Navigating to worktree: $WORKTREE_PATH"

    # Change to worktree directory
    cd "$WORKTREE_PATH" || {
        echo "ERROR: Failed to navigate to worktree: $WORKTREE_PATH"
        exit 1
    }

    echo "✓ Now in worktree: $(pwd)"
    IN_WORKTREE=true
fi