Pull from ClickUp

Synchronize changes from ClickUp back to local roadmap files.

Arguments

$ARGUMENTS - Scope: "all", "epics", or specific epic ID

Instructions

Phase 1: Fetch Remote State

1. Read configuration from .roadmap/clickup-config.json

2. Fetch ClickUp data:

   • Use ClickUp MCP to get epic tasks
   • For each epic, get subtasks (milestones)

3. Compare with local:

   • Check sync mapping for linked items
   • Identify status changes
   • Identify new items in ClickUp

Phase 2: Present Changes

4. Show proposal:

   Pull from ClickUp
   =================
   
   UPDATES (4 items):
   | Epic | Milestone | Field | Change |
   |------|-----------|-------|--------|
   | Auth | M2 | status | review → done |
   | API | M1 | status | planned → in-progress |
   
   NEW IN CLICKUP (1 item):
   | Type | Name | Parent |
   |------|------|--------|
   | Milestone | Hotfix | Auth |
   
   Import new items? [Y/n/select]
   

5. Wait for confirmation

Phase 3: Apply

6. Update local files:

   • Update milestone status in epic files
   • Update completed_points in frontmatter
   • Update sprint files if milestone committed

7. Import new items (if approved):

   • Add milestone to epic file
   • Add to sync mapping

8. Show summary:

   Pull Complete
   =============
   Updated: 4 milestones
   Imported: 1 milestone
   
   Files modified:
   - .roadmap/epics/user-auth.md
   - .roadmap/epics/api-v2.md
   

Status Mapping