[{"_1":2,"_177":-5,"_178":-5},"loaderData",{"_3":4,"_92":93},"root",{"_5":6,"_35":36,"_65":66},"ctx",{"_7":8,"_23":-5,"_24":25,"_26":27,"_28":20,"_29":20,"_30":20,"_31":32,"_33":20,"_34":20},"auth",{"_9":-5,"_10":-5,"_11":-5,"_12":-5,"_13":-5,"_14":-5,"_15":-5,"_16":-5,"_17":-5,"_18":-5,"_19":20,"_21":22},"sessionClaims","sessionId","sessionStatus","userId","actor","orgId","orgRole","orgSlug","orgPermissions","factorVerificationAge","isAuthenticated",false,"tokenType","session_token","user","preferencesKeybindings","default","preferencesTheme","light","preferencesFixers","preferencesCopilot","preferencesSelectionAi","notificationCount",0,"flagDenols","isTeamOrgMember","ENV",{"_37":38,"_39":40,"_41":42,"_43":44,"_45":46,"_47":48,"_49":50,"_51":52,"_53":54,"_55":56,"_57":58,"_59":60,"_61":62,"_63":64},"REACT_APP_SENTRY_DSN","https://586020d86f05489db63a554690acf1e9@o1398359.ingest.sentry.io/6724499","VAL_RUNTIME_NAME","prod","RENDER_GIT_COMMIT","5c349ef9e7d7333839a0634dd567aae2d49623a6","RENDER_GIT_BRANCH","main","CLERK_PUBLISHABLE_KEY","pk_live_Y2xlcmsudmFsLnRvd24k","POSTHOG_API_TOKEN","phc_nmoyuAkStEZuUp69rYlg1DZgrIt19Gx0Y4Hwf8tGgJP","POSTHOG_API_HOST","https://wart.val.town","WEB_API_TEMPLATE","https://{val}.web.val.run","APP_URL","https://www.val.town","MODULE_URL","https://esm.town","VANITY_WEB_API_TEMPLATE","https://{label}.val.run/","DENOLS_URL","https://lsp.val.town","NODE_ENV","production","API_URL","https://api.val.town","clerkState",{"_67":68},"__internal_clerk_state",{"_69":70,"_71":46,"_72":73,"_74":73,"_75":20,"_76":73,"_77":73,"_78":73,"_79":73,"_80":81,"_90":20,"_91":20},"__clerk_ssr_state",{"_21":22,"_9":-5,"_10":-5,"_11":-5,"_12":-5,"_13":-5,"_14":-5,"_15":-5,"_16":-5,"_17":-5,"_18":-5,"_19":20},"__publishableKey","__proxyUrl","","__domain","__isSatellite","__signInUrl","__signUpUrl","__afterSignInUrl","__afterSignUpUrl","__clerk_debug",{"_82":20,"_19":20,"_83":73,"_84":85,"_86":73,"_87":46,"_88":20,"_89":73},"isSignedIn","proxyUrl","reason","session-token-and-uat-missing","message","publishableKey","isSatellite","domain","__telemetryDisabled","__telemetryDebug","routes/embed.x.$handle.$name.$",{"_94":95,"_96":97,"_98":99,"_100":101,"_151":152,"_174":175,"_176":-5},"handle","liamh","name","google-calendar-linear-sync","path","src/actuator.ts","project",{"_102":103,"_96":97,"_104":105,"_106":-5,"_107":20,"_108":109,"_110":111,"_112":113,"_12":114,"_115":-5,"_116":20,"_117":-5,"_118":-5,"_119":120,"_14":121,"_122":123,"_124":123,"_125":126,"_127":126,"_128":126,"_129":123,"_130":123,"_23":131,"_134":135,"_137":138,"_150":20},"id","f8942846-25e7-11f0-ab4c-569c3dd06744","createdAt",["D",1746033868658],"deletedAt","legacyEnvVars","privacy","public","description","Bidirectional sync for Linear issues and Google Calendar events","imageUrl","https://imagedelivery.net/iHX6Ovru0O7AjmyT5yZRoA/67f68327-50ce-4f9c-2732-c233ac1ed200/square512","b7fc6d10-f2e9-11ef-89a3-8735e07158f4","pinnedFileId","pinPreview","pinMigrated","screenshotVersion","likeCount",1,"8238ec37-fbe0-436e-84ae-8442da6b5a1d","userPerm","r","valPerm","blobPerm","rw","emailPerm","sqlitePerm","projectPerm","telemetryPerm",{"_94":95,"_132":133},"profileImageUrl","https://img.clerk.com/eyJ0eXBlIjoicHJveHkiLCJzcmMiOiJodHRwczovL2ltYWdlcy5jbGVyay5kZXYvb2F1dGhfZ2l0aHViL2ltZ18ydFZBdXhGVTFxTlJibTdQYmFHT2pRV1JHb2sifQ","org",{"_94":95,"_136":133,"_12":114},"avatar","branch",{"_139":140,"_96":44,"_102":141,"_142":103,"_143":-5,"_144":-5,"_145":-5,"_146":-5,"_147":-5,"_148":97,"_149":95},"version",174,"f8948e30-25e7-11f0-ab4c-569c3dd06744","projectId","forkedBranchId","forkedBranchVersion","forkedProjectPrivacy","forkedProjectId","forkedProjectOrgId","projectName","userHandle","isOwned","file",{"_102":153,"_96":154,"_155":156,"_157":158,"_159":141,"_160":161,"_162":163,"_104":164,"_139":165,"_166":167,"_168":169,"_170":20,"_171":-5,"_98":172},"488cd6d2-a846-11f0-8f03-0224a6c84d84","actuator.ts","fileId","ec54253c-644d-11f0-94e7-0224a6c84d84","parentId","ec1207f6-644d-11f0-9a81-0224a6c84d84","branchId","branchVersion",173,"latest",true,["D",1760368026633],4,"fileType","script","content","/**\n * Actuator: Executes operations via Linear & Calendar APIs\n * Performs idempotent API calls to make external reality match canonical truth\n */\n\nimport {\n addPrefix,\n CanonicalItem,\n estimateToPoints,\n GCalEvent,\n LinearIssue,\n Operation,\n PREFIXES,\n SyncConfig,\n} from \"./types.ts\";\nimport { SmartScheduler } from \"./scheduler.ts\";\n\nexport interface ApiClients {\n linear: LinearApiClient;\n gcal: GCalApiClient;\n}\n\nexport interface LinearApiClient {\n createIssue(issue: Partial): Promise;\n updateIssue(id: string, updates: Partial): Promise;\n getIssues(teamId: string): Promise;\n getTargetedIssues(\n teamId: string,\n referencedIds: string[],\n ): Promise;\n}\n\nexport interface GCalApiClient {\n createEvent(event: Partial): Promise;\n updateEvent(id: string, updates: Partial): Promise;\n getEvents(\n calendarId: string,\n timeMin: string,\n timeMax: string,\n ): Promise;\n copyEventToCalendar(\n eventId: string,\n targetCalendarId: string,\n title?: string,\n ): Promise;\n}\n\nexport class Actuator {\n private scheduler: SmartScheduler;\n\n constructor(\n private clients: ApiClients,\n private config: SyncConfig,\n ) {\n this.scheduler = new SmartScheduler(config);\n }\n\n /**\n * Clean description by removing old Google Calendar event links\n */\n private cleanDescription(description: string): string {\n // Remove any existing Google Calendar event links from the description\n // This prevents accumulation of old event links during rollovers\n return description\n .split(\"\\n\")\n .filter((line) =>\n !line.includes(\"https://calendar.google.com/calendar/event?eid=\")\n )\n .join(\"\\n\")\n .trim();\n }\n\n async execute(operations: Operation[]): Promise {\n const results: ExecutionResult[] = [];\n\n for (const operation of operations) {\n try {\n const result = await this.executeOperation(operation);\n results.push({\n operation,\n success: true,\n result,\n error: null,\n });\n } catch (error) {\n results.push({\n operation,\n success: false,\n result: null,\n error: error instanceof Error ? error.message : String(error),\n });\n }\n }\n\n return results;\n }\n\n private async executeOperation(\n operation: Operation,\n ): Promise {\n switch (operation.type) {\n case \"createLinearIssue\":\n return this.createLinearIssue(operation.item);\n\n case \"createGCalEvent\":\n return this.createGCalEvent(operation.item);\n\n case \"patchGCalEvent\":\n return this.patchGCalEvent(operation.item);\n\n case \"patchLinearIssue\":\n return this.patchLinearIssue(operation.item);\n\n case \"createRescheduledEvent\":\n return this.createRescheduledEvent(operation.item);\n\n case \"createLinearIssueAndUpdateGCal\":\n return this.createLinearIssueAndUpdateGCal(operation.item);\n\n case \"createGCalEventAndUpdateLinear\":\n return this.createGCalEventAndUpdateLinear(operation.item);\n\n case \"noop\":\n return null;\n\n default:\n throw new Error(`Unknown operation type: ${(operation as any).type}`);\n }\n }\n\n private async createLinearIssue(item: CanonicalItem): Promise {\n // Include calendar metadata in description for linking\n let description = item.description || \"\";\n if (item.gcalId && item.startTime && item.durationMin) {\n const metadata =\n ` GoogleCalEventId:${item.gcalId} | Start:${item.startTime} | DurMin:${item.durationMin}`;\n description = description ? `${metadata}\\n\\n${description}` : metadata;\n }\n\n const issue: Partial = {\n title: addPrefix(item.title, PREFIXES.TRIAGE),\n description,\n state: \"Triage\",\n targetDate: item.startTime,\n estimate: item.estimate ? estimateToPoints(item.estimate) : 2, // Default to S (2 points)\n };\n\n return this.clients.linear.createIssue(issue);\n }\n\n private async createGCalEvent(item: CanonicalItem): Promise {\n let startTime = item.startTime;\n let endTime = item.endTime;\n\n // For Linear scheduled tasks, always create timed events (never all-day)\n // Use smart scheduling if times aren't set or if we have a date-only Linear target date\n const needsScheduling = !startTime || !endTime ||\n (startTime && startTime.length === 10);\n\n if (needsScheduling) {\n const existingEvents = await this.clients.gcal.getEvents(\n this.config.gcalCalendarId,\n \"\", // Will use default timeframes\n \"\",\n );\n\n const slot = await this.scheduler.findNextAvailableSlot(\n {\n estimate: item.estimate || \"S\",\n title: item.title,\n // If we have a date-only target date, use it as preferred date\n preferredDate: startTime && startTime.length === 10\n ? startTime\n : undefined,\n },\n existingEvents,\n );\n\n startTime = slot.startTime;\n endTime = slot.endTime;\n }\n\n // Always create timed events for Linear tasks (never all-day)\n const rawDescription = this.cleanDescription(item.description || \"\");\n\n // Build the clean description with Linear link\n let description = \"\";\n\n // Add Linear link to GCal description for easy navigation\n if (item.linearId) {\n const linearLink =\n `Linear issue: [${item.linearId}](https://linear.app/liamhorne/issue/${item.linearId})`;\n description = rawDescription\n ? `${linearLink}\\n\\n${rawDescription}`\n : linearLink;\n } else {\n description = rawDescription;\n }\n\n const event: Partial = {\n summary: addPrefix(item.title, PREFIXES.SCHEDULED),\n description,\n start: { dateTime: startTime },\n end: { dateTime: endTime },\n extendedProperties: {\n private: {\n uid: item.uid,\n linearIssueId: item.linearId,\n },\n },\n status: \"confirmed\",\n };\n\n return this.clients.gcal.createEvent(event);\n }\n\n private async patchGCalEvent(item: CanonicalItem): Promise {\n if (!item.gcalId) {\n throw new Error(\"Cannot patch GCal event without gcalId\");\n }\n\n const updates: Partial = {\n summary: item.title,\n };\n\n // Build description with Linear link\n const rawDescription = this.cleanDescription(item.description || \"\");\n\n // Build the clean description with Linear link\n let description = \"\";\n\n // Add Linear link to GCal description for easy navigation\n if (item.linearId) {\n const linearLink =\n `Linear issue: [${item.linearId}](https://linear.app/liamhorne/issue/${item.linearId})`;\n description = rawDescription\n ? `${linearLink}\\n\\n${rawDescription}`\n : linearLink;\n } else {\n description = rawDescription;\n }\n\n updates.description = description;\n\n // Add timing if present\n if (item.startTime && item.endTime) {\n updates.start = { dateTime: item.startTime };\n updates.end = { dateTime: item.endTime };\n }\n\n // Ensure UID is preserved/set\n updates.extendedProperties = {\n private: {\n uid: item.uid,\n linearIssueId: item.linearId,\n },\n };\n\n return this.clients.gcal.updateEvent(item.gcalId, updates);\n }\n\n private async patchLinearIssue(item: CanonicalItem): Promise {\n if (!item.linearId) {\n throw new Error(\"Cannot patch Linear issue without linearId\");\n }\n\n // Include calendar metadata in description for linking\n let description = item.description || \"\";\n if (item.gcalId && item.startTime && item.durationMin) {\n const metadata =\n ` GoogleCalEventId:${item.gcalId} | Start:${item.startTime} | DurMin:${item.durationMin}`;\n description = description ? `${metadata}\\n\\n${description}` : metadata;\n }\n\n const updates: Partial = {\n title: item.title,\n description,\n state: item.linearState,\n targetDate: item.startTime,\n };\n\n return this.clients.linear.updateIssue(item.linearId, updates);\n }\n\n /**\n * Creates a new Google Calendar event for overdue items.\n * This is used when a task goes overdue - we mark the original event as \"worked on\" (⏳)\n * and create this new event to continue tracking the task.\n */\n private async createRescheduledEvent(\n item: CanonicalItem,\n ): Promise {\n let startTime = item.startTime;\n let endTime = item.endTime;\n\n // Use smart scheduling for rescheduled events\n if (!startTime || !endTime) {\n const existingEvents = await this.clients.gcal.getEvents(\n this.config.gcalCalendarId,\n \"\", // Will use default timeframes\n \"\",\n );\n\n const slot = await this.scheduler.findNextAvailableSlot(\n {\n estimate: item.estimate || \"S\",\n title: item.title,\n preferredDate: undefined, // Let scheduler find next available\n },\n existingEvents,\n );\n\n startTime = slot.startTime;\n endTime = slot.endTime;\n }\n\n // Clean up the description from old Google Calendar links\n const rawDescription = this.cleanDescription(item.description || \"\");\n\n // Build the clean description with Linear link\n let description = \"\";\n if (item.linearId) {\n const linearLink =\n `Linear issue: [${item.linearId}](https://linear.app/liamhorne/issue/${item.linearId})`;\n description = rawDescription\n ? `${linearLink}\\n\\n${rawDescription}`\n : linearLink;\n } else {\n description = rawDescription;\n }\n\n const event: Partial = {\n summary: item.title, // Already has correct prefix from diff\n description,\n start: { dateTime: startTime },\n end: { dateTime: endTime },\n extendedProperties: {\n private: {\n uid: item.uid, // Same UID to maintain linkage\n linearIssueId: item.linearId,\n },\n },\n status: \"confirmed\",\n };\n\n return this.clients.gcal.createEvent(event);\n }\n\n /**\n * Combined operation: Create Linear issue first, then update GCal event with link\n * This ensures the GCal event gets updated with the Linear issue ID and proper title/description\n */\n private async createLinearIssueAndUpdateGCal(\n item: CanonicalItem,\n ): Promise {\n // Step 1: Create the Linear issue\n const createdIssue = await this.createLinearIssue(item);\n\n // Step 2: Update the GCal event with the new Linear issue ID and title\n if (item.gcalId) {\n // Clean up the description from old Google Calendar links\n const rawDescription = this.cleanDescription(item.description || \"\");\n\n const linearLink =\n `Linear issue: [${createdIssue.id}](https://linear.app/liamhorne/issue/${createdIssue.id})`;\n const description = rawDescription\n ? `${linearLink}\\n\\n${rawDescription}`\n : linearLink;\n\n const updates: Partial = {\n summary: item.title, // Should already have 📥 prefix from item\n description,\n extendedProperties: {\n private: {\n uid: item.uid,\n linearIssueId: createdIssue.id,\n },\n },\n };\n\n try {\n await this.clients.gcal.updateEvent(item.gcalId, updates);\n console.log(\n `✅ Updated GCal event \"${item.title}\" with Linear issue link`,\n );\n } catch (error) {\n console.warn(`⚠️ Failed to update GCal event: ${error}`);\n // Don't fail the whole operation if GCal update fails\n }\n }\n\n return createdIssue;\n }\n\n /**\n * Combined operation: Create GCal event first, then update Linear issue with link\n * This ensures the Linear issue gets updated with the calendar event ID and proper metadata\n */\n private async createGCalEventAndUpdateLinear(\n item: CanonicalItem,\n ): Promise {\n // Step 1: Create the GCal event\n const createdEvent = await this.createGCalEvent(item);\n\n // Step 2: Update the Linear issue with the new GCal event ID and metadata\n if (item.linearId) {\n // Include calendar metadata in description for linking\n let description = item.description || \"\";\n if (createdEvent.id && item.startTime && item.durationMin) {\n const metadata =\n ` GoogleCalEventId:${createdEvent.id} | Start:${item.startTime} | DurMin:${item.durationMin}`;\n description = description ? `${metadata}\\n\\n${description}` : metadata;\n }\n\n const updates: Partial = {\n description,\n // Keep other fields unchanged, just add the calendar link\n targetDate: item.startTime,\n };\n\n try {\n await this.clients.linear.updateIssue(item.linearId, updates);\n console.log(\n `✅ Updated Linear issue \"${item.title}\" with calendar event link`,\n );\n } catch (error) {\n console.warn(`⚠️ Failed to update Linear issue: ${error}`);\n // Don't fail the whole operation if Linear update fails\n }\n }\n\n return createdEvent;\n }\n}\n\nexport interface ExecutionResult {\n operation: Operation;\n success: boolean;\n result: LinearIssue | GCalEvent | null;\n error: string | null;\n}\n","deleted","label",[173,154],"src","permalink","https://www.val.town/x/liamh/google-calendar-linear-sync/code/src/actuator.ts","extension","actionData","errors"]