aborting

Forge: Abort

Overview

Emergency cleanup for a forge session that needs to stop. Handles all the cleanup that would normally happen at the end of a successful execution, plus marks interrupted tasks appropriately.

Session

Session Resolution

1. From $ARGUMENTS: If the first token is a number or short identifier, use it as the session ID.
2. Auto-detect existing sessions:

   ls .forge/sessions/ 2>/dev/null | sort
   

   • 0 sessions → nothing to abort, tell the user.
   • 1 session → use it automatically; print "Aborting session <id>"
   • 2+ sessions → list them with in-progress task counts, AskQuestion "Which session to abort?"

SESSION_DIR = .forge/sessions/<id>/ — all file paths in this skill are relative to this directory.

Git namespace for this session: branches forge/s<id>/*, tags forge/checkpoint/s<id>/*.

Process

1. Survey the Damage

Gather current state:

• Read $SESSION_DIR/plan.md — find tasks with status in-progress
• List worktrees: git worktree list
• List session forge branches: git branch --list "forge/s<id>/*"
• List session checkpoint tags: git tag -l "forge/checkpoint/s<id>/*"
• Check $SESSION_DIR/worktrees/ directory for leftover directories
• Check $SESSION_DIR/contracts/ directory for leftover contract files

2. Clean Up Worktrees

For each forge worktree found under $SESSION_DIR/worktrees/:

# Force remove the worktree
git worktree remove "$SESSION_DIR/worktrees/batch-N" --force

# If that fails (locked), manual cleanup
rm -rf "$SESSION_DIR/worktrees/batch-N"
git worktree prune

3. Clean Up Branches

For each forge branch found matching forge/s<id>/*:

# Delete the branch (force, since it may not be fully merged)
git branch -D "forge/s<id>/batch-N-timestamp"

4. Clean Up Contract Files

rm -rf "$SESSION_DIR/contracts/"

5. Update Plan Status

In $SESSION_DIR/plan.md:

• Change all in-progress tasks to aborted
• Leave done tasks as done
• Leave pending tasks as pending
• Leave failed tasks as failed

6. Return to Clean State

# Make sure we're on the main branch
git checkout main 2>/dev/null || git checkout master

# Prune stale worktree references
git worktree prune

6.5. Integration Cleanup (if configured)

Check .forge/config.json — if integration is active:

Linear (non-blocking): Load linear-sync → Operation D (Cancel In-Progress Issues). Marks all in-progress issues as Cancelled and adds an abort comment.

Notion (non-blocking): Load notion-sync → Operation E (Update Page on Abort). Adds abort timestamp to the Notion plan page and refreshes task statuses.

7. Generate Report

## Forge Abort Report (session <id>)

### Cleanup Summary
- Worktrees removed: N
- Branches deleted: N
- Tasks aborted: N (were in-progress)
- Contract files removed: N

### Task Status After Abort
| Status  | Count |
|---------|-------|
| Done    | X     |
| Aborted | Y     |
| Pending | Z     |
| Failed  | W     |

### Checkpoint Tags (preserved)
- forge/checkpoint/s<id>/batch-1-pre-merge
- forge/checkpoint/s<id>/batch-2-pre-merge

💡 Use `forge rollback <id>` to revert to a checkpoint, or `forge execute <id>` to resume from pending tasks.

Rules

• ALWAYS clean up ALL worktrees and branches for this session — leave no stale state
• NEVER delete checkpoint tags — the user might want to rollback
• NEVER modify done task statuses — completed work is completed work
• NEVER delete $SESSION_DIR/plan.md — the user might want to resume or re-plan
• Only clean up artifacts that belong to THIS session (scoped by session ID in branch/tag names)
• If something fails during cleanup (e.g., locked worktree), report it and continue with the rest
• This command is safe to run multiple times (idempotent)