destroy

/destroy:working-tree

Safely remove git worktree directory and metadata files. Branch is preserved.

ARGUMENT SPECIFICATION

SYNTAX: /destroy:working-tree <worktree-path>

REQUIRED:
  <worktree-path>
    Type: path (absolute or relative)
    Validation: Must be registered git worktree
    Examples: "../myapp-feature-login", "/Users/dev/myapp-feature-login"

EXECUTION PROTOCOL

Execute steps sequentially. Each step must complete successfully before proceeding.

STEP 1: VALIDATE AND RESOLVE WORKTREE PATH

EXECUTE:

# Resolve to absolute path
if [[ "$WORKTREE_PATH_ARG" = /* ]]; then
    WORKTREE_PATH="$WORKTREE_PATH_ARG"
else
    WORKTREE_PATH=$(cd "$(dirname "$WORKTREE_PATH_ARG")" && pwd)/$(basename "$WORKTREE_PATH_ARG")
fi

VALIDATION:

• IF WORKTREE_PATH_ARG is empty → ERROR PATTERN "missing-path"
• WORKTREE_PATH must be absolute after resolution

NEXT:

• On success → STEP 2
• On failure → ABORT

STEP 2: CHECK PATH EXISTS

EXECUTE:

test -e "$WORKTREE_PATH"
EXISTS=$?

VALIDATION:

• IF EXISTS != 0 → ERROR PATTERN "path-not-exist"

NEXT:

• On EXISTS == 0 → STEP 3
• On EXISTS != 0 → ABORT

STEP 3: GET ALL WORKTREES AND VALIDATE

EXECUTE:

WORKTREE_LIST=$(git worktree list --porcelain 2>&1)
EXIT_CODE=$?

VALIDATION:

• IF EXIT_CODE != 0 → ERROR PATTERN "git-command-failed"

PARSE WORKTREE_LIST:

# Extract all worktree paths and branches
# Format: worktree /path\nHEAD hash\nbranch refs/heads/name\n\n
CURRENT_MAIN=$(echo "$WORKTREE_LIST" | head -1 | cut -d' ' -f2)
IS_MAIN_REPO=false

if [ "$WORKTREE_PATH" = "$CURRENT_MAIN" ]; then
    IS_MAIN_REPO=true
fi

# Find worktree entry for target path
WORKTREE_ENTRY=$(echo "$WORKTREE_LIST" | grep -A 3 "^worktree $WORKTREE_PATH$")
IS_REGISTERED=$(echo "$WORKTREE_ENTRY" | wc -l)

VALIDATION:

• IF IS_MAIN_REPO == true → ERROR PATTERN "cannot-destroy-main"
• IF IS_REGISTERED == 0 → ERROR PATTERN "not-a-worktree"

DATA EXTRACTION:

BRANCH_REF=$(echo "$WORKTREE_ENTRY" | grep "^branch " | cut -d' ' -f2)
BRANCH_NAME=$(echo "$BRANCH_REF" | sed 's|refs/heads/||')