FaceTime Integration & Call Automation

[ProjectLiminality]

Description

Implement AppleScript-based FaceTime integration to enable one-click call initiation from Obsidian commands, automatically transitioning to copilot mode for seamless conversation enhancement workflow.

Parent Specification: #269
Parent Epic: #257

Note: This feature is marked as Optional MVP - can be implemented after core copilot functionality is working.

Technical Approach

Metadata Structure

• Add optional email and phone fields to person DreamNode metadata
• Contact fields only applicable to person-type nodes (not idea-type)
• Graceful fallback when metadata missing

AppleScript Integration

• Create FaceTimeService for macOS FaceTime control
• Use AppleScript via Electron child_process for call initiation
• Design with future cross-platform abstraction in mind (Windows/Linux)

Implementation Phases

Phase 1: Basic FaceTime Launch

• Add contact metadata fields to DreamNode type definitions
• Implement AppleScript-based FaceTime call initiation
• Command: "InterBrain: Start Video Call" - launches FaceTime with selected person
• Command: "InterBrain: Set Contact Info" - temporary text input for testing metadata updates
• Error handling for missing contact info and FaceTime unavailability

Phase 2: Automatic Mode Switching

• Auto-switch to copilot mode when video call command triggered
• Command: "InterBrain: End Video Call" - exits copilot mode manually
• Smooth mode transition handling

Phase 3: Native Edit Mode UI Polish

• Add contact info fields to edit mode UI for person nodes
• Integrate contact editing into existing edit mode workflow
• Remove temporary "Set Contact Info" command

Enhanced Acceptance Criteria

Metadata & Contact Management

• Person DreamNode metadata includes optional email and phone fields
• Contact fields stored in .udd/metadata.json format
• Graceful error message when contact info missing
• Temporary command for quick contact info testing (Phase 1)
• Native edit mode UI for contact editing (Phase 3)

FaceTime Integration

• FaceTimeService class created with AppleScript integration
• Command "InterBrain: Start Video Call" initiates FaceTime call
• FaceTime launches with contact pre-filled from metadata
• Error handling for FaceTime app unavailability
• Cross-platform abstraction considered in service design

Mode Switching

• Automatic transition to copilot mode when call starts
• Command "InterBrain: End Video Call" exits copilot mode
• Smooth UX flow from call initiation to active copilot session
• Proper cleanup when exiting copilot mode

User Experience

• Clear error messages for all failure scenarios
• Contact info only relevant for person-type nodes
• Integration feels natural within existing InterBrain workflow
• Edit mode shows contact fields for person nodes (Phase 3)

Dependencies

• Complete Copilot System with Real-time Search (Complete Copilot System with Real-time Search #327) ✅
• Person DreamNode metadata structure
• macOS AppleScript capabilities
• Existing edit mode infrastructure

Definition of Done

• Person DreamNode metadata supports email and phone fields
• "InterBrain: Start Video Call" command successfully launches FaceTime
• Automatic mode switching to copilot works seamlessly
• "InterBrain: End Video Call" command exits copilot gracefully
• Error states handled with clear user feedback
• Edit mode UI allows editing contact info for person nodes
• All phases tested in Obsidian development vault
• Code follows project architectural patterns
• Tests passing with npm run check-all

Implementation Priority

Status: Ready to implement - Core copilot functionality (#327) is complete and working.

Approach: Incremental development on single feature branch with three phases, each tested before moving to next.

[ProjectLiminality]

✅ Feature implementation complete and merged to epic branch.

Implementation Summary

Complete AppleScript-based FaceTime integration with automatic copilot mode switching and native edit mode UI for contact management.

Phase 1 - Basic FaceTime Launch ✅

• Added email/phone optional fields to DreamNode and UDDFile types
• Implemented FaceTimeService with AppleScript integration
• Created "Start Video Call" command with comprehensive error handling
• Graceful fallback for missing contact info or unavailable FaceTime

Phase 2 - Automatic Mode Switching ✅

• Auto-transition to copilot mode when video call starts
• Created "End Video Call" command that exits copilot mode gracefully
• Leverages existing conversation mode commands for full functionality

Phase 3 - Native Edit Mode UI ✅

• Added email/phone input fields in edit mode (person nodes only)
• Full persistence through service layer architecture
• Fixed input responsiveness with optimized useEffect dependencies
• Removed temporary testing command

User Testing Results

✅ User testing completed successfully
✅ All functionality verified working
✅ No outstanding issues identified

Technical Notes

• Contact fields only appear for dreamer-type nodes
• Email/phone data stored in .udd metadata file
• Service layer handles read/write operations
• Input fields properly responsive with debounced store updates