gh-devkade-collaborator-skills-pkm-framework/.claude/commands/pkm:gcal-complete.md

You are helping mark task completion in Google Calendar using gcalcli.

Context

• Calendar: 00_Schedule (main calendar only)
• Tool: gcalcli CLI
• TaskNotes: Tasks complete with - [x] [[Task Name]] ✅ YYYY-MM-DD
• Integration: Sync task completion status to calendar

Task

When a TaskNotes task is marked complete, update the corresponding calendar event to reflect completion.

Use Cases

1. Mark single task complete:

/pkm:gcal-complete "[[SWSP25 Problem Definition]]"

Updates calendar event to show task is done.

2. Auto-sync completions:

/pkm:gcal-complete --sync

Syncs all completed tasks from today's daily note to calendar.

3. Daily review integration: Called automatically by /pkm:daily-review to update calendar after review.

Steps:

Single Task Completion

1. Parse task name:

   • Input: [[Task Name]]
   • Extract task name from wikilink

2. Find calendar event:

   gcalcli --calendar "00_Schedule" \
           search "Task Name"
   

   Look for events with task name in title or description.

3. Update event:

   # Option 1: Prepend ✅ to title
   gcalcli --calendar "00_Schedule" \
           edit "EVENT_ID" \
           --title "✅ Task Name"
   
   # Option 2: Add completion note to description
   gcalcli --calendar "00_Schedule" \
           edit "EVENT_ID" \
           --description "Completed: YYYY-MM-DD HH:MM"
   

4. Confirm:

   ✅ Calendar updated: [[Task Name]] marked complete
   

Auto-Sync Today's Completions

1. Read today's daily note:

   • Path: ~/Obsidian/Altellus/20_Notes/Journal/YYYY/Mnn/YYYY-MM-DD.md
   • Extract "오늘 완료" section
   • Find: - [x] [[Task Name]] ✅ YYYY-MM-DD

2. For each completed task:

   • Search calendar for matching event
   • If found, update with ✅ marker
   • If not found, skip (not time-blocked)

3. Summary:

   ✅ **Calendar sync complete:**
   
   Updated events:
   - ✅ [[Task: Daily 템플릿 확정]]
   - ✅ [[ELEGNT 논문 리뷰]]
   
   Not in calendar:
   - [[Quick email reply]] (not time-blocked)
   
   Total synced: 2/3 tasks
   

Output Format

Single task:

✅ **Calendar Event Updated:**

- **Task:** [[SWSP25 Problem Definition]]
- **Event:** "🎯 SWSP25 Problem Definition" → "✅ SWSP25 Problem Definition"
- **Completed:** 2025-11-19 15:45

Calendar reflects task completion ✅

Sync summary:

✅ **Daily Completion Sync:**

**Updated (3):**
- ✅ [[Task: Daily 템플릿 확정]] (09:00-10:30)
- ✅ [[Task: Weekly Summary 재작성]] (11:00-12:00)
- ✅ [[ELEGNT 논문 리뷰]] (15:00-17:00)

**Not time-blocked (2):**
- ✅ [[Quick email reply]]
- ✅ [[Update README]]

**Calendar sync:** 3/5 tasks

Update Strategies

Strategy 1: Title Update (Recommended)

• Before: 🎯 SWSP25 Problem Definition
• After: ✅ SWSP25 Problem Definition
• Visual: Easy to spot in calendar
• Preserves: Original event structure

Strategy 2: Color Change

• Change event color to green (completed)
• Requires: gcalcli color support
• Visual: Color-coded completion

Strategy 3: Description Note

• Add to description: Completed: 2025-11-19 15:45
• Preserves: Title unchanged
• Detail: Exact completion timestamp

Default: Strategy 1 (Title Update)

Integration with Daily Review

/pkm:daily-review automatically calls this command:

# Daily review workflow:
1. Extract completed tasks
2. Update calendar events: /pkm:gcal-complete --sync
3. Generate review section

User sees:

### 오늘 완료
- [x] [[Task: Daily 템플릿 확정]] ✅ 2025-11-18
  _Calendar updated_ ✅

Smart Matching

Find events by:

1. Exact title match: "🎯 Task Name" = "Task Name"
2. Description match: Contains "TaskNotes: Task Name"
3. Fuzzy match: Similar title (85%+ match)
4. Time range: Within today's events only

Disambiguation: If multiple matches:

• Prefer: Today's events over future
• Prefer: Exact title match over fuzzy
• Ask: User to confirm if ambiguous

Error Handling

If event not found:

• Message: "No calendar event found for Task Name"
• Reason: "Task was not time-blocked"
• Action: Skip (not an error)

If multiple matches:

• Message: "Multiple events found for Task Name:"
• List: All matching events with times
• Ask: "Which one to update? (1/2/3)"

If already marked complete:

• Message: "Event already marked complete: ✅ Task Name"
• Action: Skip (idempotent)

If gcalcli fails:

• Message: "Unable to update calendar. Check authentication."
• Suggest: Run gcalcli init

Advanced Features

1. Batch update:

/pkm:gcal-complete --all

Updates all completed tasks from today's note.

2. Retroactive sync:

/pkm:gcal-complete --date 2025-11-18

Syncs completions from a past date.

3. Undo completion:

/pkm:gcal-complete --undo "[[Task Name]]"

Removes ✅ marker (if task was uncompleted).

Completion Metadata

Store in event description:

Completed: 2025-11-19 15:45
Pomodoros: 3 🍅🍅🍅
Notes: Finished earlier than expected

Benefits:

• Track actual vs estimated time
• Review completion patterns
• Inform future time estimates

Weekly Review Integration

Weekly review shows:

### 주간 완료 태스크
- [x] [[Task A]] ✅ (90min, est 120min) - 25% faster
- [x] [[Task B]] ✅ (120min, est 90min) - 33% slower

**Insights:** Complex tasks taking longer than estimated.

Notes

• Only updates time-blocked tasks (calendar events exist)
• Non-blocked tasks skip update (normal behavior)
• Preserves event time and other details
• Completion marker: ✅ (universally recognized)
• Can manually undo in Google Calendar UI