@plotday/twister 0.26.0 → 0.28.0

package/cli/templates/AGENTS.template.md

@@ -27,19 +27,40 @@ Plot Twists are TypeScript classes that extend the `Twist` base class. Twists in
 
 1. **Always create Activities with an initial Note** - The title is just a summary; detailed content goes in Notes
 2. **Add Notes to existing Activities for updates** - Don't create a new Activity for each related message
-3. **Use `source` field for deduplication** - Enables safe, idempotent sync from external systems
-4. **Most Activities should be `ActivityType.Note`** - Use `Action` only for tasks with `doneAt`, use `Event` only for items with `start`/`end`
+3. **Use Activity.source and Note.key for automatic upserts (Recommended)** - Set Activity.source to the external item's URL for deduplication, and use Note.key for upsertable note content. No manual ID tracking needed.
+4. **For advanced cases, use generated UUIDs** - Only when you need multiple Plot activities per external item (see SYNC_STRATEGIES.md)
+5. **Most Activities should be `ActivityType.Note`** - Use `Action` only for tasks with `done`, use `Event` only for items with `start`/`end`
 
-### Decision Tree
+### Recommended Decision Tree (Strategy 2: Upsert via Source/Key)
+
+```
+New event/task/conversation from external system?
+  ├─ Has stable URL or ID?
+  │   └─ Yes → Set Activity.source to the canonical URL/ID
+  │             Create Activity (Plot handles deduplication automatically)
+  │             Use Note.key for different note types:
+  │               - "description" for main content
+  │               - "metadata" for status/priority/assignee
+  │               - "comment-{id}" for individual comments
+  │
+  └─ No stable identifier OR need multiple Plot activities per external item?
+      └─ Use Advanced Pattern (Strategy 3: Generate and Store IDs)
+          See SYNC_STRATEGIES.md for details
+```
+
+### Advanced Decision Tree (Strategy 3: Generate and Store IDs)
+
+Only use when source/key upserts aren't sufficient (e.g., creating multiple activities from one external item):
 
 ```
 New event/task/conversation?
-  ├─ Yes → Create new Activity with initial Note
-  │         Include `source` field for deduplication
+  ├─ Yes → Generate UUID with Uuid.Generate()
+  │         Create new Activity with that UUID
+  │         Store mapping: external_id → activity_uuid
   │
-  └─ No (update/reply/comment) → Check for existing Activity
-      ├─ Found → Add Note to existing Activity
-      └─ Not found → Create new Activity with initial Note
+  └─ No (update/reply/comment) → Look up mapping by external_id
+      ├─ Found → Add Note to existing Activity using stored UUID
+      └─ Not found → Create new Activity with UUID + store mapping
 ```
 
 ## Twist Structure Pattern
@@ -52,6 +73,7 @@ import {
   twist,
 } from "@plotday/twister";
 import { Plot } from "@plotday/twister/tools/plot";
+import { Uuid } from "@plotday/twister/utils/uuid";
 
 export default class MyTwist extends Twist<MyTwist> {
   build(build: ToolBuilder) {
@@ -267,7 +289,9 @@ async onAuthComplete(authResult: { authToken: string }, provider: string) {
 
 ## Sync Pattern
 
-Pattern for syncing external data - demonstrates adding Notes to existing Activities:
+### Recommended: Upsert via Source/Key (Strategy 2)
+
+Pattern for syncing external data using automatic upserts - **no manual ID tracking needed**:
 
 ```typescript
 async startSync(calendarId: string): Promise<void> {
@@ -282,29 +306,43 @@ async startSync(calendarId: string): Promise<void> {
 }
 
 async handleEvent(
-  incomingActivity: NewActivityWithNotes,
+  event: ExternalEvent,
   calendarId: string
 ): Promise<void> {
-  // Check if this activity already exists (using source for deduplication)
-  if (incomingActivity.source) {
-    const existing = await this.tools.plot.getActivityBySource(
-      incomingActivity.source
-    );
+  // Use the event's canonical URL as the source for automatic deduplication
+  const activity: NewActivityWithNotes = {
+    source: event.htmlLink, // or event.url, depending on your external system
+    type: ActivityType.Event,
+    title: event.summary || "(No title)",
+    start: event.start?.dateTime || event.start?.date || null,
+    end: event.end?.dateTime || event.end?.date || null,
+    notes: [],
+  };
 
-    if (existing) {
-      // Add update as a Note to existing Activity (add message to thread)
-      if (incomingActivity.notes?.[0]?.content) {
-        await this.tools.plot.createNote({
-          activity: { id: existing.id },
-          content: incomingActivity.notes[0].content,
-        });
-      }
-      return;
-    }
+  // Add description as an upsertable note
+  if (event.description) {
+    activity.notes.push({
+      activity: { source: event.htmlLink },
+      key: "description", // This key enables upserts - same key updates the note
+      content: event.description,
+    });
   }
 
-  // Create new Activity with initial Note (new thread with first message)
-  await this.tools.plot.createActivity(incomingActivity);
+  // Add attendees as an upsertable note
+  if (event.attendees?.length) {
+    const attendeeList = event.attendees
+      .map(a => `- ${a.email}${a.displayName ? ` (${a.displayName})` : ''}`)
+      .join('\n');
+
+    activity.notes.push({
+      activity: { source: event.htmlLink },
+      key: "attendees", // Different key for different note types
+      content: `## Attendees\n${attendeeList}`,
+    });
+  }
+
+  // Create or update - Plot automatically handles deduplication based on source
+  await this.tools.plot.createActivity(activity);
 }
 
 async stopSync(calendarId: string): Promise<void> {
@@ -313,6 +351,50 @@ async stopSync(calendarId: string): Promise<void> {
 }
 ```
 
+### Advanced: Generate and Store IDs (Strategy 3)
+
+Only use this pattern when you need to create multiple Plot activities from a single external item, or when the external system doesn't provide stable identifiers. See SYNC_STRATEGIES.md for details.
+
+```typescript
+async handleEventAdvanced(
+  incomingActivity: NewActivityWithNotes,
+  calendarId: string
+): Promise<void> {
+  // Extract external event ID from meta (adapt based on your tool's data)
+  const externalId = incomingActivity.meta?.eventId;
+
+  if (!externalId) {
+    console.error("Event missing external ID");
+    return;
+  }
+
+  // Check if we've already synced this event
+  const mappingKey = `event_mapping:${calendarId}:${externalId}`;
+  const existingActivityId = await this.get<Uuid>(mappingKey);
+
+  if (existingActivityId) {
+    // Event already exists - add update as a Note (add message to thread)
+    if (incomingActivity.notes?.[0]?.content) {
+      await this.tools.plot.createNote({
+        activity: { id: existingActivityId },
+        content: incomingActivity.notes[0].content,
+      });
+    }
+    return;
+  }
+
+  // New event - generate UUID and store mapping
+  const activityId = Uuid.Generate();
+  await this.set(mappingKey, activityId);
+
+  // Create new Activity with initial Note (new thread with first message)
+  await this.tools.plot.createActivity({
+    ...incomingActivity,
+    id: activityId,
+  });
+}
+```
+
 ## Calendar Selection Pattern
 
 Pattern for letting users select from multiple calendars/accounts:
@@ -405,13 +487,17 @@ async syncBatch(args: any, resourceId: string): Promise<void> {
   // Process one batch (keep under time limit)
   const result = await this.fetchBatch(state.nextPageToken);
 
-  // Process results (create activities with Notes)
+  // Process results using source/key pattern (automatic upserts, no manual tracking)
   for (const item of result.items) {
     await this.tools.plot.createActivity({
+      source: item.url, // Use item's canonical URL for automatic deduplication
       type: ActivityType.Note,
       title: item.title,
-      source: `external:${item.id}`, // For deduplication
-      notes: [{ content: item.description }],
+      notes: [{
+        activity: { source: item.url },
+        key: "description", // Use key for upsertable notes
+        content: item.description,
+      }],
     });
   }
 
@@ -471,9 +557,9 @@ try {
 - **Don't use instance variables for state** - Anything stored in memory is lost after function execution. Always use the Store tool for data that needs to persist.
 - **Processing self-created activities** - Other users may change an Activity created by the twist, resulting in an \`activity\` call. Be sure to check the \`changes === null\` and/or \`activity.author.id !== this.id\` to avoid re-processing.
 - **Always create Activities with Notes** - See "Understanding Activities and Notes" section above for the thread/message pattern and decision tree.
-- **Use correct Activity types** - Most should be `ActivityType.Note`. Only use `Action` for tasks with `doneAt`, and `Event` for items with `start`/`end`.
-- **Use `source` field for deduplication** - Always include `source` when syncing external data to enable safe, idempotent operations.
-- **Add Notes to existing Activities** - Check for existing Activities with `getActivityBySource()` before creating new ones. Think thread replies, not new threads.
+- **Use correct Activity types** - Most should be `ActivityType.Note`. Only use `Action` for tasks with `done`, and `Event` for items with `start`/`end`.
+- **Use Activity.source and Note.key for automatic upserts (Recommended)** - Set Activity.source to the external item's URL for automatic deduplication. Only use UUID generation and storage for advanced cases (see SYNC_STRATEGIES.md).
+- **Add Notes to existing Activities** - For source/key pattern, reference activities by source. For UUID pattern, look up stored mappings before creating new Activities. Think thread replies, not new threads.
 - Tools are declared in the `build` method and accessed via `this.tools.toolName` in twist methods.
 - **Don't forget runtime limits** - Each execution has ~10 seconds. Break long operations into batches with the Tasks tool. Process enough items per batch to be efficient, but few enough to stay under time limits.
 - **Always use Callbacks tool for persistent references** - Direct function references don't survive worker restarts.

package/dist/common/calendar.d.ts

@@ -1,4 +1,4 @@
-import type { ActivityLink, NewActivityWithNotes } from "../index";
+import type { ActivityLink, SyncUpdate } from "../index";
 /**
  * Represents successful calendar authorization.
  *
@@ -54,9 +54,13 @@ export interface SyncOptions {
  * 5. Start sync for selected calendars
  * 6. Process incoming events via callbacks
  *
+ * **Recommended Data Sync Strategy:**
+ * Use Activity.source and Note.key for automatic upserts without manual ID tracking.
+ * See SYNC_STRATEGIES.md for detailed patterns and when to use alternative approaches.
+ *
  * @example
  * ```typescript
- * // Typical calendar integration flow
+ * // Typical calendar integration flow using source/key upserts
  * class MyCalendarTwist extends Twist {
  *   private googleCalendar: GoogleCalendar;
  *
@@ -86,11 +90,13 @@ export interface SyncOptions {
  *   }
  *
  *   async onCalendarEvent(
- *     activity: NewActivityWithNotes,
+ *     syncUpdate: SyncUpdate,
  *     syncMeta: { initialSync: boolean }
  *   ) {
- *     // Step 4: Process synced events
- *     await this.plot.createActivity(activity);
+ *     // Step 4: Process synced events using source/key pattern
+ *     // The sync update will automatically use the event's URL as the source
+ *     // for deduplication - no manual ID tracking needed
+ *     await this.plot.createActivity(syncUpdate);
  *   }
  * }
  * ```
@@ -123,19 +129,25 @@ export interface CalendarTool {
      * event import and ongoing change notifications. The callback function
      * will be invoked for each synced event.
      *
-     * Tools implementing this should set activity.unread based on sync type:
-     * - Initial sync (historical data): Set activity.unread = false
-     * - Incremental updates (webhooks): Set activity.unread = true or leave undefined
+     * **Recommended Implementation** (Strategy 2 - Upsert via Source/Key):
+     * - Set Activity.source to the event's canonical URL (e.g., event.htmlLink)
+     * - Use Note.key for event details (description, attendees, etc.) to enable upserts
+     * - No manual ID tracking needed - Plot handles deduplication automatically
+     * - Send NewActivityWithNotes for all events (creates new or updates existing)
+     * - Set activity.unread = false for initial sync, true for incremental updates
+     *
+     * **Alternative** (Strategy 3 - Advanced cases):
+     * - Use Uuid.Generate() and store ID mappings when creating multiple activities per event
+     * - See SYNC_STRATEGIES.md for when this is appropriate
      *
      * @param authToken - Authorization token for calendar access
      * @param calendarId - ID of the calendar to sync
-     * @param callback - Function receiving (activity, ...extraArgs) for each synced event.
-     *                   The activity.unread field indicates whether this is from initial sync.
+     * @param callback - Function receiving (syncUpdate, ...extraArgs) for each synced event
      * @param extraArgs - Additional arguments to pass to the callback (type-checked)
      * @returns Promise that resolves when sync setup is complete
      * @throws When auth token is invalid or calendar doesn't exist
      */
-    startSync<TCallback extends (activity: NewActivityWithNotes, ...args: any[]) => any>(authToken: string, calendarId: string, callback: TCallback, ...extraArgs: TCallback extends (activity: any, ...rest: infer R) => any ? R : []): Promise<void>;
+    startSync<TCallback extends (syncUpdate: SyncUpdate, ...args: any[]) => any>(authToken: string, calendarId: string, callback: TCallback, ...extraArgs: TCallback extends (syncUpdate: any, ...rest: infer R) => any ? R : []): Promise<void>;
     /**
      * Stops synchronizing events from a specific calendar.
      *

package/dist/common/calendar.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"calendar.d.ts","sourceRoot":"","sources":["../../src/common/calendar.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,YAAY,EAAE,oBAAoB,EAAE,MAAM,UAAU,CAAC;AAEnE;;;;;;GAMG;AACH,MAAM,MAAM,YAAY,GAAG;IACzB,2CAA2C;IAC3C,SAAS,EAAE,MAAM,CAAC;CACnB,CAAC;AAEF;;;;;;GAMG;AACH,MAAM,WAAW,QAAQ;IACvB,6DAA6D;IAC7D,EAAE,EAAE,MAAM,CAAC;IACX,0CAA0C;IAC1C,IAAI,EAAE,MAAM,CAAC;IACb,oEAAoE;IACpE,WAAW,EAAE,MAAM,GAAG,IAAI,CAAC;IAC3B,0DAA0D;IAC1D,OAAO,EAAE,OAAO,CAAC;CAClB;AAED;;;;;GAKG;AACH,MAAM,WAAW,WAAW;IAC1B,oDAAoD;IACpD,OAAO,CAAC,EAAE,IAAI,CAAC;IACf,gDAAgD;IAChD,OAAO,CAAC,EAAE,IAAI,CAAC;CAChB;AAED;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAuDG;AACH,MAAM,WAAW,YAAY;IAC3B;;;;;;OAMG;IACH,WAAW,CAAC,SAAS,SAAS,CAAC,IAAI,EAAE,YAAY,EAAE,GAAG,IAAI,EAAE,GAAG,EAAE,KAAK,GAAG,EACvE,QAAQ,EAAE,SAAS,EACnB,GAAG,SAAS,EAAE,SAAS,SAAS,CAAC,IAAI,EAAE,GAAG,EAAE,GAAG,IAAI,EAAE,MAAM,CAAC,KAAK,GAAG,GAChE,CAAC,GACD,EAAE,GACL,OAAO,CAAC,YAAY,CAAC,CAAC;IAEzB;;;;;;;;;;OAUG;IACH,YAAY,CAAC,SAAS,EAAE,MAAM,GAAG,OAAO,CAAC,QAAQ,EAAE,CAAC,CAAC;IAErD;;;;;;;;;;;;;;;;;;OAkBG;IACH,SAAS,CACP,SAAS,SAAS,CAChB,QAAQ,EAAE,oBAAoB,EAC9B,GAAG,IAAI,EAAE,GAAG,EAAE,KACX,GAAG,EAER,SAAS,EAAE,MAAM,EACjB,UAAU,EAAE,MAAM,EAClB,QAAQ,EAAE,SAAS,EACnB,GAAG,SAAS,EAAE,SAAS,SAAS,CAC9B,QAAQ,EAAE,GAAG,EACb,GAAG,IAAI,EAAE,MAAM,CAAC,KACb,GAAG,GACJ,CAAC,GACD,EAAE,GACL,OAAO,CAAC,IAAI,CAAC,CAAC;IAEjB;;;;;;;;;;OAUG;IACH,QAAQ,CAAC,SAAS,EAAE,MAAM,EAAE,UAAU,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;CAChE"}
+{"version":3,"file":"calendar.d.ts","sourceRoot":"","sources":["../../src/common/calendar.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,YAAY,EAAwB,UAAU,EAAE,MAAM,UAAU,CAAC;AAE/E;;;;;;GAMG;AACH,MAAM,MAAM,YAAY,GAAG;IACzB,2CAA2C;IAC3C,SAAS,EAAE,MAAM,CAAC;CACnB,CAAC;AAEF;;;;;;GAMG;AACH,MAAM,WAAW,QAAQ;IACvB,6DAA6D;IAC7D,EAAE,EAAE,MAAM,CAAC;IACX,0CAA0C;IAC1C,IAAI,EAAE,MAAM,CAAC;IACb,oEAAoE;IACpE,WAAW,EAAE,MAAM,GAAG,IAAI,CAAC;IAC3B,0DAA0D;IAC1D,OAAO,EAAE,OAAO,CAAC;CAClB;AAED;;;;;GAKG;AACH,MAAM,WAAW,WAAW;IAC1B,oDAAoD;IACpD,OAAO,CAAC,EAAE,IAAI,CAAC;IACf,gDAAgD;IAChD,OAAO,CAAC,EAAE,IAAI,CAAC;CAChB;AAED;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA6DG;AACH,MAAM,WAAW,YAAY;IAC3B;;;;;;OAMG;IACH,WAAW,CAAC,SAAS,SAAS,CAAC,IAAI,EAAE,YAAY,EAAE,GAAG,IAAI,EAAE,GAAG,EAAE,KAAK,GAAG,EACvE,QAAQ,EAAE,SAAS,EACnB,GAAG,SAAS,EAAE,SAAS,SAAS,CAAC,IAAI,EAAE,GAAG,EAAE,GAAG,IAAI,EAAE,MAAM,CAAC,KAAK,GAAG,GAChE,CAAC,GACD,EAAE,GACL,OAAO,CAAC,YAAY,CAAC,CAAC;IAEzB;;;;;;;;;;OAUG;IACH,YAAY,CAAC,SAAS,EAAE,MAAM,GAAG,OAAO,CAAC,QAAQ,EAAE,CAAC,CAAC;IAErD;;;;;;;;;;;;;;;;;;;;;;;;OAwBG;IACH,SAAS,CACP,SAAS,SAAS,CAChB,UAAU,EAAE,UAAU,EACtB,GAAG,IAAI,EAAE,GAAG,EAAE,KACX,GAAG,EAER,SAAS,EAAE,MAAM,EACjB,UAAU,EAAE,MAAM,EAClB,QAAQ,EAAE,SAAS,EACnB,GAAG,SAAS,EAAE,SAAS,SAAS,CAC9B,UAAU,EAAE,GAAG,EACf,GAAG,IAAI,EAAE,MAAM,CAAC,KACb,GAAG,GACJ,CAAC,GACD,EAAE,GACL,OAAO,CAAC,IAAI,CAAC,CAAC;IAEjB;;;;;;;;;;OAUG;IACH,QAAQ,CAAC,SAAS,EAAE,MAAM,EAAE,UAAU,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;CAChE"}

package/dist/common/messaging.d.ts

@@ -1,4 +1,4 @@
-import type { ActivityLink, NewActivityWithNotes } from "../index";
+import type { ActivityLink, SyncUpdate } from "../index";
 /**
  * Represents a successful messaging service authorization.
  *
@@ -41,6 +41,10 @@ export interface MessageSyncOptions {
  *
  * All synced messages/emails are converted to ActivityWithNotes objects.
  * Each email thread or chat conversation becomes an Activity with Notes for each message.
+ *
+ * **Recommended Data Sync Strategy:**
+ * Use Activity.source (thread URL or ID) and Note.key (message ID) for automatic upserts.
+ * See SYNC_STRATEGIES.md for detailed patterns.
  */
 export interface MessagingTool {
     /**
@@ -61,18 +65,29 @@ export interface MessagingTool {
     /**
      * Begins synchronizing messages from a specific channel.
      *
-     * Email threads and chat conversations are converted to ActivityWithNotes objects.
-     * Each object contains an Activity (with subject/title) and Notes array (one per message).
-     * The Activity.id can be used as a stable conversation identifier.
+     * Email threads and chat conversations are converted to SyncUpdate objects,
+     * which can be either new items or updates to existing items.
+     *
+     * **Recommended Implementation** (Strategy 2 - Upsert via Source/Key):
+     * - Set Activity.source to the thread/conversation URL or stable ID (e.g., "slack:{channelId}:{threadTs}")
+     * - Use Note.key for individual messages (e.g., "message-{messageId}")
+     * - Each message becomes a separate note with unique key for upserts
+     * - No manual ID tracking needed - Plot handles deduplication automatically
+     * - Send NewActivityWithNotes for all threads (creates new or updates existing)
+     * - Set activity.unread = false for initial sync, true for incremental updates
+     *
+     * **Alternative** (Strategy 3 - Advanced cases):
+     * - Use Uuid.Generate() and store ID mappings when creating multiple activities per thread
+     * - See SYNC_STRATEGIES.md for when this is appropriate
      *
      * @param authToken - Authorization token for access
      * @param channelId - ID of the channel (e.g., channel, inbox) to sync
-     * @param callback - Function receiving (thread, ...extraArgs) for each synced conversation
+     * @param callback - Function receiving (syncUpdate, ...extraArgs) for each synced conversation
      * @param options - Optional configuration for limiting the sync scope (e.g., time range)
      * @param extraArgs - Additional arguments to pass to the callback (type-checked)
      * @returns Promise that resolves when sync setup is complete
      */
-    startSync<TCallback extends (thread: NewActivityWithNotes, ...args: any[]) => any>(authToken: string, channelId: string, callback: TCallback, options?: MessageSyncOptions, ...extraArgs: TCallback extends (thread: any, ...rest: infer R) => any ? R : []): Promise<void>;
+    startSync<TCallback extends (syncUpdate: SyncUpdate, ...args: any[]) => any>(authToken: string, channelId: string, callback: TCallback, options?: MessageSyncOptions, ...extraArgs: TCallback extends (syncUpdate: any, ...rest: infer R) => any ? R : []): Promise<void>;
     /**
      * Stops synchronizing messages from a specific channel.
      *

package/dist/common/messaging.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"messaging.d.ts","sourceRoot":"","sources":["../../src/common/messaging.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,YAAY,EAAE,oBAAoB,EAAE,MAAM,UAAU,CAAC;AAEnE;;;;;;GAMG;AACH,MAAM,MAAM,aAAa,GAAG;IAC1B,4CAA4C;IAC5C,SAAS,EAAE,MAAM,CAAC;CACnB,CAAC;AAEF;;;;;GAKG;AACH,MAAM,WAAW,cAAc;IAC7B,4DAA4D;IAC5D,EAAE,EAAE,MAAM,CAAC;IACX,uFAAuF;IACvF,IAAI,EAAE,MAAM,CAAC;IACb,mEAAmE;IACnE,WAAW,EAAE,MAAM,GAAG,IAAI,CAAC;IAC3B,4EAA4E;IAC5E,OAAO,EAAE,OAAO,CAAC;CAClB;AAED;;;;;GAKG;AACH,MAAM,WAAW,kBAAkB;IACjC,oDAAoD;IACpD,OAAO,CAAC,EAAE,IAAI,CAAC;CAChB;AAED;;;;;GAKG;AACH,MAAM,WAAW,aAAa;IAC5B;;;;;;OAMG;IACH,WAAW,CAAC,SAAS,SAAS,CAAC,IAAI,EAAE,aAAa,EAAE,GAAG,IAAI,EAAE,GAAG,EAAE,KAAK,GAAG,EACxE,QAAQ,EAAE,SAAS,EACnB,GAAG,SAAS,EAAE,SAAS,SAAS,CAAC,IAAI,EAAE,GAAG,EAAE,GAAG,IAAI,EAAE,MAAM,CAAC,KAAK,GAAG,GAChE,CAAC,GACD,EAAE,GACL,OAAO,CAAC,YAAY,CAAC,CAAC;IAEzB;;;;;OAKG;IACH,WAAW,CAAC,SAAS,EAAE,MAAM,GAAG,OAAO,CAAC,cAAc,EAAE,CAAC,CAAC;IAE1D;;;;;;;;;;;;;OAaG;IACH,SAAS,CACP,SAAS,SAAS,CAAC,MAAM,EAAE,oBAAoB,EAAE,GAAG,IAAI,EAAE,GAAG,EAAE,KAAK,GAAG,EAEvE,SAAS,EAAE,MAAM,EACjB,SAAS,EAAE,MAAM,EACjB,QAAQ,EAAE,SAAS,EACnB,OAAO,CAAC,EAAE,kBAAkB,EAC5B,GAAG,SAAS,EAAE,SAAS,SAAS,CAAC,MAAM,EAAE,GAAG,EAAE,GAAG,IAAI,EAAE,MAAM,CAAC,KAAK,GAAG,GAClE,CAAC,GACD,EAAE,GACL,OAAO,CAAC,IAAI,CAAC,CAAC;IAEjB;;;;;;OAMG;IACH,QAAQ,CAAC,SAAS,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;CAC/D"}
+{"version":3,"file":"messaging.d.ts","sourceRoot":"","sources":["../../src/common/messaging.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,YAAY,EAAwB,UAAU,EAAE,MAAM,UAAU,CAAC;AAE/E;;;;;;GAMG;AACH,MAAM,MAAM,aAAa,GAAG;IAC1B,4CAA4C;IAC5C,SAAS,EAAE,MAAM,CAAC;CACnB,CAAC;AAEF;;;;;GAKG;AACH,MAAM,WAAW,cAAc;IAC7B,4DAA4D;IAC5D,EAAE,EAAE,MAAM,CAAC;IACX,uFAAuF;IACvF,IAAI,EAAE,MAAM,CAAC;IACb,mEAAmE;IACnE,WAAW,EAAE,MAAM,GAAG,IAAI,CAAC;IAC3B,4EAA4E;IAC5E,OAAO,EAAE,OAAO,CAAC;CAClB;AAED;;;;;GAKG;AACH,MAAM,WAAW,kBAAkB;IACjC,oDAAoD;IACpD,OAAO,CAAC,EAAE,IAAI,CAAC;CAChB;AAED;;;;;;;;;GASG;AACH,MAAM,WAAW,aAAa;IAC5B;;;;;;OAMG;IACH,WAAW,CAAC,SAAS,SAAS,CAAC,IAAI,EAAE,aAAa,EAAE,GAAG,IAAI,EAAE,GAAG,EAAE,KAAK,GAAG,EACxE,QAAQ,EAAE,SAAS,EACnB,GAAG,SAAS,EAAE,SAAS,SAAS,CAAC,IAAI,EAAE,GAAG,EAAE,GAAG,IAAI,EAAE,MAAM,CAAC,KAAK,GAAG,GAChE,CAAC,GACD,EAAE,GACL,OAAO,CAAC,YAAY,CAAC,CAAC;IAEzB;;;;;OAKG;IACH,WAAW,CAAC,SAAS,EAAE,MAAM,GAAG,OAAO,CAAC,cAAc,EAAE,CAAC,CAAC;IAE1D;;;;;;;;;;;;;;;;;;;;;;;;OAwBG;IACH,SAAS,CACP,SAAS,SAAS,CAAC,UAAU,EAAE,UAAU,EAAE,GAAG,IAAI,EAAE,GAAG,EAAE,KAAK,GAAG,EAEjE,SAAS,EAAE,MAAM,EACjB,SAAS,EAAE,MAAM,EACjB,QAAQ,EAAE,SAAS,EACnB,OAAO,CAAC,EAAE,kBAAkB,EAC5B,GAAG,SAAS,EAAE,SAAS,SAAS,CAAC,UAAU,EAAE,GAAG,EAAE,GAAG,IAAI,EAAE,MAAM,CAAC,KAAK,GAAG,GACtE,CAAC,GACD,EAAE,GACL,OAAO,CAAC,IAAI,CAAC,CAAC;IAEjB;;;;;;OAMG;IACH,QAAQ,CAAC,SAAS,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;CAC/D"}

package/dist/common/projects.d.ts

@@ -1,4 +1,4 @@
-import type { ActivityLink, ActivityUpdate, NewActivityWithNotes } from "../index";
+import type { ActivityLink, ActivityUpdate, SyncUpdate } from "../index";
 /**
  * Represents a successful project management service authorization.
  *
@@ -41,6 +41,10 @@ export interface ProjectSyncOptions {
  *
  * All synced issues/tasks are converted to ActivityWithNotes objects.
  * Each issue becomes an Activity with Notes for the description and comments.
+ *
+ * **Recommended Data Sync Strategy:**
+ * Use Activity.source (issue URL) and Note.key for automatic upserts.
+ * See SYNC_STRATEGIES.md for detailed patterns.
  */
 export interface ProjectTool {
     /**
@@ -61,27 +65,31 @@ export interface ProjectTool {
     /**
      * Begins synchronizing issues from a specific project.
      *
-     * Issues and tasks are converted to ActivityWithNotes objects.
-     * Each object contains an Activity (with issue title and metadata) and Notes array
-     * (description as first note, followed by comments).
-     * The Activity.source should be set for deduplication.
+     * Issues and tasks are converted to SyncUpdate objects, which can be either
+     * new items or updates to existing items.
      *
-     * When an issue is updated, tools should check for existing Activity using
-     * getActivityBySource() and add a Note rather than creating a new Activity.
+     * **Recommended Implementation** (Strategy 2 - Upsert via Source/Key):
+     * - Set Activity.source to the issue's canonical URL (e.g., Linear issue URL, Jira issue URL)
+     * - Use Note.key for issue details:
+     *   - key: "description" for issue description (upserts on changes)
+     *   - key: "metadata" for status, priority, assignee, etc.
+     *   - key: "comment-{commentId}" for individual comments (unique per comment)
+     * - No manual ID tracking needed - Plot handles deduplication automatically
+     * - Send NewActivityWithNotes for all issues (creates new or updates existing)
+     * - Set activity.unread = false for initial sync, true for incremental updates
      *
-     * Tools implementing this should set issue.unread based on sync type:
-     * - Initial sync (historical data): Set issue.unread = false
-     * - Incremental updates (webhooks): Set issue.unread = true or leave undefined
+     * **Alternative** (Strategy 3 - Advanced cases):
+     * - Use Uuid.Generate() and store ID mappings when creating multiple activities per issue
+     * - See SYNC_STRATEGIES.md for when this is appropriate
      *
      * @param authToken - Authorization token for access
      * @param projectId - ID of the project to sync
-     * @param callback - Function receiving (issue, ...extraArgs) for each synced issue.
-     *                   The issue.unread field indicates whether this is from initial sync.
+     * @param callback - Function receiving (syncUpdate, ...extraArgs) for each synced issue
      * @param options - Optional configuration for limiting the sync scope (e.g., time range)
      * @param extraArgs - Additional arguments to pass to the callback (type-checked)
      * @returns Promise that resolves when sync setup is complete
      */
-    startSync<TCallback extends (issue: NewActivityWithNotes, ...args: any[]) => any>(authToken: string, projectId: string, callback: TCallback, options?: ProjectSyncOptions, ...extraArgs: TCallback extends (issue: any, ...rest: infer R) => any ? R : []): Promise<void>;
+    startSync<TCallback extends (syncUpdate: SyncUpdate, ...args: any[]) => any>(authToken: string, projectId: string, callback: TCallback, options?: ProjectSyncOptions, ...extraArgs: TCallback extends (syncUpdate: any, ...rest: infer R) => any ? R : []): Promise<void>;
     /**
      * Stops synchronizing issues from a specific project.
      *
@@ -97,10 +105,10 @@ export interface ProjectTool {
      * sync activity updates back to the external service.
      *
      * The update object contains only the fields that changed, plus id and source.
-     * Uses the combination of start and doneAt to determine workflow state:
-     * - doneAt set → Completed/Done state
-     * - doneAt null + start set → In Progress/Active state
-     * - doneAt null + start null → Backlog/Todo state
+     * Uses the combination of start and done to determine workflow state:
+     * - done set → Completed/Done state
+     * - done null + start set → In Progress/Active state
+     * - done null + start null → Backlog/Todo state
      *
      * @param authToken - Authorization token for access
      * @param update - ActivityUpdate with changed fields (includes id and source)

package/dist/common/projects.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"projects.d.ts","sourceRoot":"","sources":["../../src/common/projects.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EACV,YAAY,EACZ,cAAc,EACd,oBAAoB,EACrB,MAAM,UAAU,CAAC;AAElB;;;;;;GAMG;AACH,MAAM,MAAM,WAAW,GAAG;IACxB,qDAAqD;IACrD,SAAS,EAAE,MAAM,CAAC;CACnB,CAAC;AAEF;;;;;GAKG;AACH,MAAM,WAAW,OAAO;IACtB,4DAA4D;IAC5D,EAAE,EAAE,MAAM,CAAC;IACX,6EAA6E;IAC7E,IAAI,EAAE,MAAM,CAAC;IACb,mEAAmE;IACnE,WAAW,EAAE,MAAM,GAAG,IAAI,CAAC;IAC3B,gFAAgF;IAChF,GAAG,EAAE,MAAM,GAAG,IAAI,CAAC;CACpB;AAED;;;;;GAKG;AACH,MAAM,WAAW,kBAAkB;IACjC,oDAAoD;IACpD,OAAO,CAAC,EAAE,IAAI,CAAC;CAChB;AAED;;;;;GAKG;AACH,MAAM,WAAW,WAAW;IAC1B;;;;;;OAMG;IACH,WAAW,CAAC,SAAS,SAAS,CAAC,IAAI,EAAE,WAAW,EAAE,GAAG,IAAI,EAAE,GAAG,EAAE,KAAK,GAAG,EACtE,QAAQ,EAAE,SAAS,EACnB,GAAG,SAAS,EAAE,SAAS,SAAS,CAAC,IAAI,EAAE,GAAG,EAAE,GAAG,IAAI,EAAE,MAAM,CAAC,KAAK,GAAG,GAChE,CAAC,GACD,EAAE,GACL,OAAO,CAAC,YAAY,CAAC,CAAC;IAEzB;;;;;OAKG;IACH,WAAW,CAAC,SAAS,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,EAAE,CAAC,CAAC;IAEnD;;;;;;;;;;;;;;;;;;;;;;OAsBG;IACH,SAAS,CACP,SAAS,SAAS,CAChB,KAAK,EAAE,oBAAoB,EAC3B,GAAG,IAAI,EAAE,GAAG,EAAE,KACX,GAAG,EAER,SAAS,EAAE,MAAM,EACjB,SAAS,EAAE,MAAM,EACjB,QAAQ,EAAE,SAAS,EACnB,OAAO,CAAC,EAAE,kBAAkB,EAC5B,GAAG,SAAS,EAAE,SAAS,SAAS,CAC9B,KAAK,EAAE,GAAG,EACV,GAAG,IAAI,EAAE,MAAM,CAAC,KACb,GAAG,GACJ,CAAC,GACD,EAAE,GACL,OAAO,CAAC,IAAI,CAAC,CAAC;IAEjB;;;;;;OAMG;IACH,QAAQ,CAAC,SAAS,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IAE9D;;;;;;;;;;;;;;;OAeG;IACH,WAAW,CAAC,CAAC,SAAS,EAAE,MAAM,EAAE,MAAM,EAAE,cAAc,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IAEvE;;;;;;;;;;OAUG;IACH,eAAe,CAAC,CACd,SAAS,EAAE,MAAM,EACjB,OAAO,EAAE,MAAM,EACf,IAAI,EAAE,MAAM,GACX,OAAO,CAAC,IAAI,CAAC,CAAC;CAClB"}
+{"version":3,"file":"projects.d.ts","sourceRoot":"","sources":["../../src/common/projects.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EACV,YAAY,EACZ,cAAc,EAEd,UAAU,EACX,MAAM,UAAU,CAAC;AAElB;;;;;;GAMG;AACH,MAAM,MAAM,WAAW,GAAG;IACxB,qDAAqD;IACrD,SAAS,EAAE,MAAM,CAAC;CACnB,CAAC;AAEF;;;;;GAKG;AACH,MAAM,WAAW,OAAO;IACtB,4DAA4D;IAC5D,EAAE,EAAE,MAAM,CAAC;IACX,6EAA6E;IAC7E,IAAI,EAAE,MAAM,CAAC;IACb,mEAAmE;IACnE,WAAW,EAAE,MAAM,GAAG,IAAI,CAAC;IAC3B,gFAAgF;IAChF,GAAG,EAAE,MAAM,GAAG,IAAI,CAAC;CACpB;AAED;;;;;GAKG;AACH,MAAM,WAAW,kBAAkB;IACjC,oDAAoD;IACpD,OAAO,CAAC,EAAE,IAAI,CAAC;CAChB;AAED;;;;;;;;;GASG;AACH,MAAM,WAAW,WAAW;IAC1B;;;;;;OAMG;IACH,WAAW,CAAC,SAAS,SAAS,CAAC,IAAI,EAAE,WAAW,EAAE,GAAG,IAAI,EAAE,GAAG,EAAE,KAAK,GAAG,EACtE,QAAQ,EAAE,SAAS,EACnB,GAAG,SAAS,EAAE,SAAS,SAAS,CAAC,IAAI,EAAE,GAAG,EAAE,GAAG,IAAI,EAAE,MAAM,CAAC,KAAK,GAAG,GAChE,CAAC,GACD,EAAE,GACL,OAAO,CAAC,YAAY,CAAC,CAAC;IAEzB;;;;;OAKG;IACH,WAAW,CAAC,SAAS,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,EAAE,CAAC,CAAC;IAEnD;;;;;;;;;;;;;;;;;;;;;;;;;;OA0BG;IACH,SAAS,CACP,SAAS,SAAS,CAChB,UAAU,EAAE,UAAU,EACtB,GAAG,IAAI,EAAE,GAAG,EAAE,KACX,GAAG,EAER,SAAS,EAAE,MAAM,EACjB,SAAS,EAAE,MAAM,EACjB,QAAQ,EAAE,SAAS,EACnB,OAAO,CAAC,EAAE,kBAAkB,EAC5B,GAAG,SAAS,EAAE,SAAS,SAAS,CAC9B,UAAU,EAAE,GAAG,EACf,GAAG,IAAI,EAAE,MAAM,CAAC,KACb,GAAG,GACJ,CAAC,GACD,EAAE,GACL,OAAO,CAAC,IAAI,CAAC,CAAC;IAEjB;;;;;;OAMG;IACH,QAAQ,CAAC,SAAS,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IAE9D;;;;;;;;;;;;;;;OAeG;IACH,WAAW,CAAC,CAAC,SAAS,EAAE,MAAM,EAAE,MAAM,EAAE,cAAc,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IAEvE;;;;;;;;;;OAUG;IACH,eAAe,CAAC,CACd,SAAS,EAAE,MAAM,EACjB,OAAO,EAAE,MAAM,EACf,IAAI,EAAE,MAAM,GACX,OAAO,CAAC,IAAI,CAAC,CAAC;CAClB"}

package/dist/docs/assets/hierarchy.js

@@ -1 +1 @@
-window.hierarchyData = "eJyNkrFuwyAQht/l5guVbTCNt6iTl6pSu1VRRW3aIBNTwVUZIr97hd1WZIKFAb7//w7pruCdowDdq6yOCF5/WD2QcXOA7gqyiueszho66F+cs4AwmXmErqrvEb69hQ4Gq0LQ4Y6cs2yl2InOEV1foAMK4y7GdtsFwnAydvR6jl6OTVNj09YouEAhK2xria2sUPIKpdgfFwTJk0mKBimYY0FomjotvphAIVcd3mjl2IYXSNpUcujzAmXYoc8XCy6S4gdl7bsapoIPDH8o+w8V2G7XYSb96dW2K1mhSWiWRvPatpaJ9lHTxfkpb5w3kP0GCjw333uyjvKSL+uIRTRfL3la/0zO63x/iBhb4QKD2Ke7rELJJlDE2ArnDMvyA843XGE="
+window.hierarchyData = "eJyNkj1PwzAQhv/LzVfTJq2/toqpC0KCDVXIpIZGcWNkH+pQ5b8jJ4DMZC8e7Ofe506+GwTvKYJ+EZsjQrDvznbU+zGCvoHYpHM0FwsaDs/eO0AY+vEEetNIhK/gQEPnTIw23pH3js0UO9MlofMLaKB4WqWy1XKB0J17dwp2TN4ttlxhqxTuZIN8LZHzLYq1RCEkCsWPE4LYZp1UNVLRx4TQcpUHX/tIsRQdX2nm2IJXSFQu2R/KAtOz/aEcvJNNFnxvnHsz3VAxQPeLsr+iso2vZb4OI9mPYJZdKQr7jGZ5aYWW53//YOnqw1A2jgvIfgrKHvFvvEfnqSz5dJ5YQiviRR7/RD7Ycn5MGJvhCoPi+S6bWLMJlDA2wyXDNH0Dl09cpw=="

package/dist/docs/assets/navigation.js

@@ -1 +1 @@
-window.navigationData = "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"
+window.navigationData = "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"