@stackmemoryai/stackmemory 0.5.58 → 0.5.59

package/dist/src/integrations/linear/rest-client.js

@@ -0,0 +1,213 @@
+import { fileURLToPath as __fileURLToPath } from 'url';
+import { dirname as __pathDirname } from 'path';
+const __filename = __fileURLToPath(import.meta.url);
+const __dirname = __pathDirname(__filename);
+import { logger } from "../../core/monitoring/logger.js";
+import { IntegrationError, ErrorCode } from "../../core/errors/index.js";
+class LinearRestClient {
+  apiKey;
+  baseUrl = "https://api.linear.app/graphql";
+  taskCache = /* @__PURE__ */ new Map();
+  lastSync = 0;
+  cacheTTL = 5 * 60 * 1e3;
+  // 5 minutes
+  constructor(apiKey) {
+    this.apiKey = apiKey;
+  }
+  /**
+   * Get all tasks and store in memory
+   */
+  async getAllTasks(forceRefresh = false) {
+    const now = Date.now();
+    if (!forceRefresh && now - this.lastSync < this.cacheTTL && this.taskCache.size > 0) {
+      return Array.from(this.taskCache.values());
+    }
+    try {
+      const allTasks = [];
+      let hasNextPage = true;
+      let cursor;
+      while (hasNextPage) {
+        const query = `
+          query($after: String) {
+            issues(
+              filter: { team: { key: { eq: "ENG" } } }
+              first: 100
+              after: $after
+            ) {
+              nodes {
+                id
+                identifier
+                title
+                description
+                state {
+                  name
+                  type
+                }
+                priority
+                assignee {
+                  id
+                  name
+                }
+                estimate
+                createdAt
+                updatedAt
+                url
+              }
+              pageInfo {
+                hasNextPage
+                endCursor
+              }
+            }
+          }
+        `;
+        const variables = cursor ? { after: cursor } : {};
+        const response = await this.makeRequest(
+          query,
+          variables
+        );
+        const tasks = response.data.issues.nodes;
+        allTasks.push(...tasks);
+        tasks.forEach((task) => {
+          this.taskCache.set(task.id, task);
+        });
+        hasNextPage = response.data.issues.pageInfo.hasNextPage;
+        cursor = response.data.issues.pageInfo.endCursor;
+        logger.info(`Fetched ${tasks.length} tasks, total: ${allTasks.length}`);
+      }
+      this.lastSync = now;
+      logger.info(`Cached ${allTasks.length} Linear tasks in memory`);
+      return allTasks;
+    } catch (error) {
+      logger.error("Failed to fetch Linear tasks:", error);
+      return Array.from(this.taskCache.values());
+    }
+  }
+  /**
+   * Get tasks by status
+   */
+  async getTasksByStatus(status) {
+    const tasks = await this.getAllTasks();
+    return tasks.filter((task) => task.state.type === status);
+  }
+  /**
+   * Get tasks assigned to current user
+   */
+  async getMyTasks() {
+    try {
+      const viewer = await this.getViewer();
+      const tasks = await this.getAllTasks();
+      return tasks.filter((task) => task.assignee?.id === viewer.id);
+    } catch (error) {
+      logger.error("Failed to get assigned tasks:", error);
+      return [];
+    }
+  }
+  /**
+   * Get task count by status
+   */
+  async getTaskCounts() {
+    const tasks = await this.getAllTasks();
+    const counts = {};
+    tasks.forEach((task) => {
+      const status = task.state.type;
+      counts[status] = (counts[status] || 0) + 1;
+    });
+    return counts;
+  }
+  /**
+   * Search tasks by title or description
+   */
+  async searchTasks(query) {
+    const tasks = await this.getAllTasks();
+    const searchTerm = query.toLowerCase();
+    return tasks.filter(
+      (task) => task.title.toLowerCase().includes(searchTerm) || task.description?.toLowerCase().includes(searchTerm) || task.identifier.toLowerCase().includes(searchTerm)
+    );
+  }
+  /**
+   * Get current viewer info
+   */
+  async getViewer() {
+    const query = `
+      query {
+        viewer {
+          id
+          name
+          email
+        }
+      }
+    `;
+    const response = await this.makeRequest(query);
+    return response.data.viewer;
+  }
+  /**
+   * Get team info
+   */
+  async getTeam() {
+    const query = `
+      query {
+        teams(filter: { key: { eq: "ENG" } }, first: 1) {
+          nodes {
+            id
+            name
+            key
+          }
+        }
+      }
+    `;
+    const response = await this.makeRequest(query);
+    if (response.data.teams.nodes.length === 0) {
+      throw new IntegrationError(
+        "ENG team not found",
+        ErrorCode.LINEAR_API_ERROR
+      );
+    }
+    return response.data.teams.nodes[0];
+  }
+  /**
+   * Get cache stats
+   */
+  getCacheStats() {
+    const now = Date.now();
+    return {
+      size: this.taskCache.size,
+      lastSync: this.lastSync,
+      age: now - this.lastSync,
+      fresh: now - this.lastSync < this.cacheTTL
+    };
+  }
+  /**
+   * Clear cache
+   */
+  clearCache() {
+    this.taskCache.clear();
+    this.lastSync = 0;
+    logger.info("Linear task cache cleared");
+  }
+  /**
+   * Make GraphQL request
+   */
+  async makeRequest(query, variables = {}) {
+    const response = await fetch(this.baseUrl, {
+      method: "POST",
+      headers: {
+        Authorization: this.apiKey,
+        "Content-Type": "application/json"
+      },
+      body: JSON.stringify({ query, variables })
+    });
+    const result = await response.json();
+    if (!response.ok || result.errors) {
+      const errorMsg = result.errors?.[0]?.message || `${response.status} ${response.statusText}`;
+      throw new IntegrationError(
+        `Linear API error: ${errorMsg}`,
+        ErrorCode.LINEAR_API_ERROR
+      );
+    }
+    return result;
+  }
+}
+export {
+  LinearRestClient
+};
+//# sourceMappingURL=rest-client.js.map

package/dist/src/integrations/linear/rest-client.js.map

@@ -0,0 +1,7 @@
+{
+  "version": 3,
+  "sources": ["../../../../src/integrations/linear/rest-client.ts"],
+  "sourcesContent": ["/**\n * Linear REST Client for StackMemory\n * Provides memory-based task storage using REST API instead of GraphQL\n */\n\nimport { logger } from '../../core/monitoring/logger.js';\nimport { IntegrationError, ErrorCode } from '../../core/errors/index.js';\n\nexport interface LinearTask {\n  id: string;\n  identifier: string;\n  title: string;\n  description?: string;\n  state: {\n    name: string;\n    type: string;\n  };\n  priority: number;\n  assignee?: {\n    id: string;\n    name: string;\n  };\n  estimate?: number;\n  createdAt: string;\n  updatedAt: string;\n  url: string;\n}\n\nexport interface LinearTasksResponse {\n  data: {\n    issues: {\n      nodes: LinearTask[];\n      pageInfo: {\n        hasNextPage: boolean;\n        endCursor?: string;\n      };\n    };\n  };\n}\n\nexport class LinearRestClient {\n  private apiKey: string;\n  private baseUrl = 'https://api.linear.app/graphql';\n  private taskCache = new Map<string, LinearTask>();\n  private lastSync = 0;\n  private cacheTTL = 5 * 60 * 1000; // 5 minutes\n\n  constructor(apiKey: string) {\n    this.apiKey = apiKey;\n  }\n\n  /**\n   * Get all tasks and store in memory\n   */\n  async getAllTasks(forceRefresh = false): Promise<LinearTask[]> {\n    const now = Date.now();\n\n    // Return cached data if fresh\n    if (\n      !forceRefresh &&\n      now - this.lastSync < this.cacheTTL &&\n      this.taskCache.size > 0\n    ) {\n      return Array.from(this.taskCache.values());\n    }\n\n    try {\n      const allTasks: LinearTask[] = [];\n      let hasNextPage = true;\n      let cursor: string | undefined;\n\n      while (hasNextPage) {\n        const query = `\n          query($after: String) {\n            issues(\n              filter: { team: { key: { eq: \"ENG\" } } }\n              first: 100\n              after: $after\n            ) {\n              nodes {\n                id\n                identifier\n                title\n                description\n                state {\n                  name\n                  type\n                }\n                priority\n                assignee {\n                  id\n                  name\n                }\n                estimate\n                createdAt\n                updatedAt\n                url\n              }\n              pageInfo {\n                hasNextPage\n                endCursor\n              }\n            }\n          }\n        `;\n\n        const variables = cursor ? { after: cursor } : {};\n        const response = await this.makeRequest<LinearTasksResponse>(\n          query,\n          variables\n        );\n\n        const tasks = response.data.issues.nodes;\n        allTasks.push(...tasks);\n\n        // Update cache\n        tasks.forEach((task) => {\n          this.taskCache.set(task.id, task);\n        });\n\n        hasNextPage = response.data.issues.pageInfo.hasNextPage;\n        cursor = response.data.issues.pageInfo.endCursor;\n\n        logger.info(`Fetched ${tasks.length} tasks, total: ${allTasks.length}`);\n      }\n\n      this.lastSync = now;\n      logger.info(`Cached ${allTasks.length} Linear tasks in memory`);\n\n      return allTasks;\n    } catch (error: unknown) {\n      logger.error('Failed to fetch Linear tasks:', error as Error);\n      return Array.from(this.taskCache.values()); // Return cached data on error\n    }\n  }\n\n  /**\n   * Get tasks by status\n   */\n  async getTasksByStatus(status: string): Promise<LinearTask[]> {\n    const tasks = await this.getAllTasks();\n    return tasks.filter((task: any) => task.state.type === status);\n  }\n\n  /**\n   * Get tasks assigned to current user\n   */\n  async getMyTasks(): Promise<LinearTask[]> {\n    try {\n      const viewer = await this.getViewer();\n      const tasks = await this.getAllTasks();\n      return tasks.filter((task: any) => task.assignee?.id === viewer.id);\n    } catch (error: unknown) {\n      logger.error('Failed to get assigned tasks:', error as Error);\n      return [];\n    }\n  }\n\n  /**\n   * Get task count by status\n   */\n  async getTaskCounts(): Promise<Record<string, number>> {\n    const tasks = await this.getAllTasks();\n    const counts: Record<string, number> = {};\n\n    tasks.forEach((task) => {\n      const status = task.state.type;\n      counts[status] = (counts[status] || 0) + 1;\n    });\n\n    return counts;\n  }\n\n  /**\n   * Search tasks by title or description\n   */\n  async searchTasks(query: string): Promise<LinearTask[]> {\n    const tasks = await this.getAllTasks();\n    const searchTerm = query.toLowerCase();\n\n    return tasks.filter(\n      (task: any) =>\n        task.title.toLowerCase().includes(searchTerm) ||\n        task.description?.toLowerCase().includes(searchTerm) ||\n        task.identifier.toLowerCase().includes(searchTerm)\n    );\n  }\n\n  /**\n   * Get current viewer info\n   */\n  async getViewer(): Promise<{ id: string; name: string; email: string }> {\n    const query = `\n      query {\n        viewer {\n          id\n          name\n          email\n        }\n      }\n    `;\n\n    const response = await this.makeRequest<{\n      data: {\n        viewer: { id: string; name: string; email: string };\n      };\n    }>(query);\n\n    return response.data.viewer;\n  }\n\n  /**\n   * Get team info\n   */\n  async getTeam(): Promise<{ id: string; name: string; key: string }> {\n    const query = `\n      query {\n        teams(filter: { key: { eq: \"ENG\" } }, first: 1) {\n          nodes {\n            id\n            name\n            key\n          }\n        }\n      }\n    `;\n\n    const response = await this.makeRequest<{\n      data: {\n        teams: {\n          nodes: Array<{ id: string; name: string; key: string }>;\n        };\n      };\n    }>(query);\n\n    if (response.data.teams.nodes.length === 0) {\n      throw new IntegrationError(\n        'ENG team not found',\n        ErrorCode.LINEAR_API_ERROR\n      );\n    }\n\n    return response.data.teams.nodes[0]!;\n  }\n\n  /**\n   * Get cache stats\n   */\n  getCacheStats(): {\n    size: number;\n    lastSync: number;\n    age: number;\n    fresh: boolean;\n  } {\n    const now = Date.now();\n    return {\n      size: this.taskCache.size,\n      lastSync: this.lastSync,\n      age: now - this.lastSync,\n      fresh: now - this.lastSync < this.cacheTTL,\n    };\n  }\n\n  /**\n   * Clear cache\n   */\n  clearCache(): void {\n    this.taskCache.clear();\n    this.lastSync = 0;\n    logger.info('Linear task cache cleared');\n  }\n\n  /**\n   * Make GraphQL request\n   */\n  async makeRequest<T>(\n    query: string,\n    variables: Record<string, unknown> = {}\n  ): Promise<T> {\n    const response = await fetch(this.baseUrl, {\n      method: 'POST',\n      headers: {\n        Authorization: this.apiKey,\n        'Content-Type': 'application/json',\n      },\n      body: JSON.stringify({ query, variables }),\n    });\n\n    const result = (await response.json()) as {\n      data?: unknown;\n      errors?: Array<{ message: string }>;\n    };\n\n    if (!response.ok || result.errors) {\n      const errorMsg =\n        result.errors?.[0]?.message ||\n        `${response.status} ${response.statusText}`;\n      throw new IntegrationError(\n        `Linear API error: ${errorMsg}`,\n        ErrorCode.LINEAR_API_ERROR\n      );\n    }\n\n    return result as T;\n  }\n}\n"],
+  "mappings": "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",
+  "names": []
+}

package/dist/src/integrations/linear/sync-manager.js

@@ -0,0 +1,236 @@
+import { fileURLToPath as __fileURLToPath } from 'url';
+import { dirname as __pathDirname } from 'path';
+const __filename = __fileURLToPath(import.meta.url);
+const __dirname = __pathDirname(__filename);
+import { EventEmitter } from "events";
+import { logger } from "../../core/monitoring/logger.js";
+import { LinearSyncEngine } from "./sync.js";
+import { AsyncMutex } from "../../core/utils/async-mutex.js";
+class LinearSyncManager extends EventEmitter {
+  syncEngine;
+  syncTimer;
+  pendingSyncTimer;
+  config;
+  lastSyncTime = 0;
+  syncMutex;
+  taskStore;
+  constructor(taskStore, authManager, config, projectRoot) {
+    super();
+    this.taskStore = taskStore;
+    this.syncMutex = new AsyncMutex(3e5);
+    this.config = {
+      ...config,
+      autoSyncInterval: config.autoSyncInterval || 15,
+      syncOnTaskChange: config.syncOnTaskChange !== false,
+      syncOnSessionStart: config.syncOnSessionStart !== false,
+      syncOnSessionEnd: config.syncOnSessionEnd !== false,
+      debounceInterval: config.debounceInterval || 5e3
+      // 5 seconds
+    };
+    this.syncEngine = new LinearSyncEngine(
+      taskStore,
+      authManager,
+      config,
+      projectRoot
+    );
+    this.setupEventListeners();
+    this.setupPeriodicSync();
+  }
+  /**
+   * Setup event listeners for automatic sync triggers
+   */
+  setupEventListeners() {
+    if (this.config.syncOnTaskChange && this.taskStore) {
+      this.taskStore.on("sync:needed", (changeType) => {
+        logger.debug(`Task change detected: ${changeType}`);
+        this.scheduleDebouncedSync();
+      });
+      this.taskStore.on("task:created", (task) => {
+        logger.debug(`Task created: ${task.title}`);
+      });
+      this.taskStore.on("task:completed", (task) => {
+        logger.debug(`Task completed: ${task.title}`);
+      });
+      logger.info("Task change sync enabled via EventEmitter");
+    }
+  }
+  /**
+   * Setup periodic sync timer
+   */
+  setupPeriodicSync() {
+    if (!this.config.autoSync || !this.config.autoSyncInterval) {
+      return;
+    }
+    if (this.syncTimer) {
+      clearInterval(this.syncTimer);
+    }
+    const intervalMs = this.config.autoSyncInterval * 60 * 1e3;
+    this.syncTimer = setInterval(() => {
+      this.performSync("periodic");
+    }, intervalMs);
+    logger.info(
+      `Periodic Linear sync enabled: every ${this.config.autoSyncInterval} minutes`
+    );
+  }
+  /**
+   * Schedule a debounced sync to avoid too frequent syncs
+   */
+  scheduleDebouncedSync() {
+    if (!this.config.enabled) return;
+    if (this.pendingSyncTimer) {
+      clearTimeout(this.pendingSyncTimer);
+    }
+    this.pendingSyncTimer = setTimeout(() => {
+      this.performSync("task-change");
+    }, this.config.debounceInterval);
+  }
+  /**
+   * Perform a sync operation
+   * Uses mutex to prevent concurrent sync operations (thread-safe)
+   */
+  async performSync(trigger) {
+    if (!this.config.enabled) {
+      return {
+        success: false,
+        synced: { toLinear: 0, fromLinear: 0, updated: 0 },
+        conflicts: [],
+        errors: ["Sync is disabled"]
+      };
+    }
+    const release = this.syncMutex.tryAcquire(`linear-sync-${trigger}`);
+    if (!release) {
+      logger.warn(`Linear sync already in progress, skipping ${trigger} sync`);
+      return {
+        success: false,
+        synced: { toLinear: 0, fromLinear: 0, updated: 0 },
+        conflicts: [],
+        errors: ["Sync already in progress"]
+      };
+    }
+    try {
+      const now = Date.now();
+      const timeSinceLastSync = now - this.lastSyncTime;
+      const minInterval = 1e4;
+      if (trigger !== "manual" && timeSinceLastSync < minInterval) {
+        logger.debug(
+          `Skipping ${trigger} sync, too soon since last sync (${timeSinceLastSync}ms ago)`
+        );
+        return {
+          success: false,
+          synced: { toLinear: 0, fromLinear: 0, updated: 0 },
+          conflicts: [],
+          errors: [
+            `Too soon since last sync (wait ${minInterval - timeSinceLastSync}ms)`
+          ]
+        };
+      }
+      this.emit("sync:started", { trigger });
+      logger.info(`Starting Linear sync (trigger: ${trigger})`);
+      const result = await this.syncEngine.sync();
+      this.lastSyncTime = now;
+      if (result.success) {
+        logger.info(
+          `Linear sync completed: ${result.synced.toLinear} to Linear, ${result.synced.fromLinear} from Linear, ${result.synced.updated} updated`
+        );
+        this.emit("sync:completed", { trigger, result });
+      } else {
+        logger.error(`Linear sync failed: ${result.errors.join(", ")}`);
+        this.emit("sync:failed", { trigger, result });
+      }
+      return result;
+    } catch (error) {
+      const errorMessage = error instanceof Error ? error.message : String(error);
+      logger.error(`Linear sync error: ${errorMessage}`);
+      const result = {
+        success: false,
+        synced: { toLinear: 0, fromLinear: 0, updated: 0 },
+        conflicts: [],
+        errors: [errorMessage]
+      };
+      this.emit("sync:failed", { trigger, result, error });
+      return result;
+    } finally {
+      release();
+    }
+  }
+  /**
+   * Sync on session start
+   */
+  async syncOnStart() {
+    if (this.config.syncOnSessionStart) {
+      return await this.performSync("session-start");
+    }
+    return null;
+  }
+  /**
+   * Sync on session end
+   */
+  async syncOnEnd() {
+    if (this.config.syncOnSessionEnd) {
+      return await this.performSync("session-end");
+    }
+    return null;
+  }
+  /**
+   * Update sync configuration
+   */
+  updateConfig(newConfig) {
+    this.config = { ...this.config, ...newConfig };
+    this.syncEngine.updateConfig(newConfig);
+    if (newConfig.autoSyncInterval !== void 0 || newConfig.autoSync !== void 0) {
+      this.setupPeriodicSync();
+    }
+  }
+  /**
+   * Get sync status
+   */
+  getStatus() {
+    const nextSyncTime = this.config.autoSync && this.config.autoSyncInterval ? this.lastSyncTime + this.config.autoSyncInterval * 60 * 1e3 : null;
+    return {
+      enabled: this.config.enabled,
+      syncInProgress: this.syncMutex.isLocked(),
+      lastSyncTime: this.lastSyncTime,
+      nextSyncTime,
+      config: this.config
+    };
+  }
+  /**
+   * Stop all sync activities
+   */
+  stop() {
+    if (this.syncTimer) {
+      clearInterval(this.syncTimer);
+      this.syncTimer = void 0;
+    }
+    if (this.pendingSyncTimer) {
+      clearTimeout(this.pendingSyncTimer);
+      this.pendingSyncTimer = void 0;
+    }
+    this.removeAllListeners();
+    logger.info("Linear sync manager stopped");
+  }
+  /**
+   * Force an immediate sync
+   */
+  async forceSync() {
+    return await this.performSync("manual");
+  }
+}
+const DEFAULT_SYNC_MANAGER_CONFIG = {
+  enabled: true,
+  direction: "bidirectional",
+  autoSync: true,
+  autoSyncInterval: 15,
+  // minutes
+  conflictResolution: "newest_wins",
+  syncOnTaskChange: true,
+  syncOnSessionStart: true,
+  syncOnSessionEnd: true,
+  debounceInterval: 5e3
+  // 5 seconds
+};
+export {
+  DEFAULT_SYNC_MANAGER_CONFIG,
+  LinearSyncManager
+};
+//# sourceMappingURL=sync-manager.js.map

package/dist/src/integrations/linear/sync-manager.js.map

@@ -0,0 +1,7 @@
+{
+  "version": 3,
+  "sources": ["../../../../src/integrations/linear/sync-manager.ts"],
+  "sourcesContent": ["/**\n * Linear Sync Manager\n * Handles periodic and event-based synchronization with Linear\n */\n\nimport { EventEmitter } from 'events';\nimport { logger } from '../../core/monitoring/logger.js';\nimport { LinearSyncEngine, SyncConfig, SyncResult } from './sync.js';\nimport { LinearTaskManager } from '../../features/tasks/linear-task-manager.js';\nimport { LinearAuthManager } from './auth.js';\nimport { AsyncMutex } from '../../core/utils/async-mutex.js';\n\nexport interface SyncManagerConfig extends SyncConfig {\n  autoSyncInterval?: number; // minutes\n  syncOnTaskChange?: boolean;\n  syncOnSessionStart?: boolean;\n  syncOnSessionEnd?: boolean;\n  debounceInterval?: number; // milliseconds\n}\n\nexport class LinearSyncManager extends EventEmitter {\n  private syncEngine: LinearSyncEngine;\n  private syncTimer?: NodeJS.Timeout;\n  private pendingSyncTimer?: NodeJS.Timeout;\n  private config: SyncManagerConfig;\n  private lastSyncTime: number = 0;\n  private syncMutex: AsyncMutex;\n  private taskStore: LinearTaskManager;\n\n  constructor(\n    taskStore: LinearTaskManager,\n    authManager: LinearAuthManager,\n    config: SyncManagerConfig,\n    projectRoot?: string\n  ) {\n    super();\n    this.taskStore = taskStore;\n    this.syncMutex = new AsyncMutex(300000); // 5 minute lock timeout\n    this.config = {\n      ...config,\n      autoSyncInterval: config.autoSyncInterval || 15,\n      syncOnTaskChange: config.syncOnTaskChange !== false,\n      syncOnSessionStart: config.syncOnSessionStart !== false,\n      syncOnSessionEnd: config.syncOnSessionEnd !== false,\n      debounceInterval: config.debounceInterval || 5000, // 5 seconds\n    };\n\n    this.syncEngine = new LinearSyncEngine(\n      taskStore,\n      authManager,\n      config,\n      projectRoot\n    );\n\n    this.setupEventListeners();\n    this.setupPeriodicSync();\n  }\n\n  /**\n   * Setup event listeners for automatic sync triggers\n   */\n  private setupEventListeners(): void {\n    if (this.config.syncOnTaskChange && this.taskStore) {\n      // Listen for task changes to trigger sync\n      this.taskStore.on('sync:needed', (changeType: string) => {\n        logger.debug(`Task change detected: ${changeType}`);\n        this.scheduleDebouncedSync();\n      });\n\n      // Listen for specific task events if needed for logging\n      this.taskStore.on('task:created', (task: any) => {\n        logger.debug(`Task created: ${task.title}`);\n      });\n\n      this.taskStore.on('task:completed', (task: any) => {\n        logger.debug(`Task completed: ${task.title}`);\n      });\n\n      logger.info('Task change sync enabled via EventEmitter');\n    }\n  }\n\n  /**\n   * Setup periodic sync timer\n   */\n  private setupPeriodicSync(): void {\n    if (!this.config.autoSync || !this.config.autoSyncInterval) {\n      return;\n    }\n\n    // Clear existing timer if any\n    if (this.syncTimer) {\n      clearInterval(this.syncTimer);\n    }\n\n    // Setup new timer\n    const intervalMs = this.config.autoSyncInterval * 60 * 1000;\n    this.syncTimer = setInterval(() => {\n      this.performSync('periodic');\n    }, intervalMs);\n\n    logger.info(\n      `Periodic Linear sync enabled: every ${this.config.autoSyncInterval} minutes`\n    );\n  }\n\n  /**\n   * Schedule a debounced sync to avoid too frequent syncs\n   */\n  private scheduleDebouncedSync(): void {\n    if (!this.config.enabled) return;\n\n    // Clear existing pending sync\n    if (this.pendingSyncTimer) {\n      clearTimeout(this.pendingSyncTimer);\n    }\n\n    // Schedule new sync\n    this.pendingSyncTimer = setTimeout(() => {\n      this.performSync('task-change');\n    }, this.config.debounceInterval);\n  }\n\n  /**\n   * Perform a sync operation\n   * Uses mutex to prevent concurrent sync operations (thread-safe)\n   */\n  async performSync(\n    trigger:\n      | 'manual'\n      | 'periodic'\n      | 'task-change'\n      | 'session-start'\n      | 'session-end'\n  ): Promise<SyncResult> {\n    if (!this.config.enabled) {\n      return {\n        success: false,\n        synced: { toLinear: 0, fromLinear: 0, updated: 0 },\n        conflicts: [],\n        errors: ['Sync is disabled'],\n      };\n    }\n\n    // Try to acquire lock without waiting (non-blocking check)\n    const release = this.syncMutex.tryAcquire(`linear-sync-${trigger}`);\n    if (!release) {\n      logger.warn(`Linear sync already in progress, skipping ${trigger} sync`);\n      return {\n        success: false,\n        synced: { toLinear: 0, fromLinear: 0, updated: 0 },\n        conflicts: [],\n        errors: ['Sync already in progress'],\n      };\n    }\n\n    try {\n      // Check minimum time between syncs (avoid rapid fire)\n      const now = Date.now();\n      const timeSinceLastSync = now - this.lastSyncTime;\n      const minInterval = 10000; // 10 seconds minimum between syncs\n\n      if (trigger !== 'manual' && timeSinceLastSync < minInterval) {\n        logger.debug(\n          `Skipping ${trigger} sync, too soon since last sync (${timeSinceLastSync}ms ago)`\n        );\n        return {\n          success: false,\n          synced: { toLinear: 0, fromLinear: 0, updated: 0 },\n          conflicts: [],\n          errors: [\n            `Too soon since last sync (wait ${minInterval - timeSinceLastSync}ms)`,\n          ],\n        };\n      }\n\n      this.emit('sync:started', { trigger });\n\n      logger.info(`Starting Linear sync (trigger: ${trigger})`);\n      const result = await this.syncEngine.sync();\n\n      this.lastSyncTime = now;\n\n      if (result.success) {\n        logger.info(\n          `Linear sync completed: ${result.synced.toLinear} to Linear, ${result.synced.fromLinear} from Linear, ${result.synced.updated} updated`\n        );\n        this.emit('sync:completed', { trigger, result });\n      } else {\n        logger.error(`Linear sync failed: ${result.errors.join(', ')}`);\n        this.emit('sync:failed', { trigger, result });\n      }\n\n      return result;\n    } catch (error: unknown) {\n      const errorMessage =\n        error instanceof Error ? error.message : String(error);\n      logger.error(`Linear sync error: ${errorMessage}`);\n\n      const result: SyncResult = {\n        success: false,\n        synced: { toLinear: 0, fromLinear: 0, updated: 0 },\n        conflicts: [],\n        errors: [errorMessage],\n      };\n\n      this.emit('sync:failed', { trigger, result, error });\n      return result;\n    } finally {\n      release(); // Always release the lock\n    }\n  }\n\n  /**\n   * Sync on session start\n   */\n  async syncOnStart(): Promise<SyncResult | null> {\n    if (this.config.syncOnSessionStart) {\n      return await this.performSync('session-start');\n    }\n    return null;\n  }\n\n  /**\n   * Sync on session end\n   */\n  async syncOnEnd(): Promise<SyncResult | null> {\n    if (this.config.syncOnSessionEnd) {\n      return await this.performSync('session-end');\n    }\n    return null;\n  }\n\n  /**\n   * Update sync configuration\n   */\n  updateConfig(newConfig: Partial<SyncManagerConfig>): void {\n    this.config = { ...this.config, ...newConfig };\n    this.syncEngine.updateConfig(newConfig);\n\n    // Restart periodic sync if interval changed\n    if (\n      newConfig.autoSyncInterval !== undefined ||\n      newConfig.autoSync !== undefined\n    ) {\n      this.setupPeriodicSync();\n    }\n  }\n\n  /**\n   * Get sync status\n   */\n  getStatus(): {\n    enabled: boolean;\n    syncInProgress: boolean;\n    lastSyncTime: number;\n    nextSyncTime: number | null;\n    config: SyncManagerConfig;\n  } {\n    const nextSyncTime =\n      this.config.autoSync && this.config.autoSyncInterval\n        ? this.lastSyncTime + this.config.autoSyncInterval * 60 * 1000\n        : null;\n\n    return {\n      enabled: this.config.enabled,\n      syncInProgress: this.syncMutex.isLocked(),\n      lastSyncTime: this.lastSyncTime,\n      nextSyncTime,\n      config: this.config,\n    };\n  }\n\n  /**\n   * Stop all sync activities\n   */\n  stop(): void {\n    if (this.syncTimer) {\n      clearInterval(this.syncTimer);\n      this.syncTimer = undefined;\n    }\n\n    if (this.pendingSyncTimer) {\n      clearTimeout(this.pendingSyncTimer);\n      this.pendingSyncTimer = undefined;\n    }\n\n    this.removeAllListeners();\n    logger.info('Linear sync manager stopped');\n  }\n\n  /**\n   * Force an immediate sync\n   */\n  async forceSync(): Promise<SyncResult> {\n    return await this.performSync('manual');\n  }\n}\n\n/**\n * Default sync manager configuration\n */\nexport const DEFAULT_SYNC_MANAGER_CONFIG: SyncManagerConfig = {\n  enabled: true,\n  direction: 'bidirectional',\n  autoSync: true,\n  autoSyncInterval: 15, // minutes\n  conflictResolution: 'newest_wins',\n  syncOnTaskChange: true,\n  syncOnSessionStart: true,\n  syncOnSessionEnd: true,\n  debounceInterval: 5000, // 5 seconds\n};\n"],
+  "mappings": "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",
+  "names": []
+}