@stackmemoryai/stackmemory 0.2.4 → 0.2.6

package/dist/src/integrations/linear/auth.js

@@ -0,0 +1,319 @@
+/**
+ * Linear OAuth Authentication Setup
+ * Handles initial OAuth flow and token management for Linear integration
+ */
+import { createHash, randomBytes } from 'crypto';
+import { readFileSync, writeFileSync, existsSync } from 'fs';
+import { join } from 'path';
+import { logger } from '../../core/monitoring/logger.js';
+export class LinearAuthManager {
+    configPath;
+    tokensPath;
+    config;
+    constructor(projectRoot) {
+        const configDir = join(projectRoot, '.stackmemory');
+        this.configPath = join(configDir, 'linear-config.json');
+        this.tokensPath = join(configDir, 'linear-tokens.json');
+    }
+    /**
+     * Check if Linear integration is configured
+     */
+    isConfigured() {
+        return existsSync(this.configPath) && existsSync(this.tokensPath);
+    }
+    /**
+     * Save OAuth application configuration
+     */
+    saveConfig(config) {
+        writeFileSync(this.configPath, JSON.stringify(config, null, 2));
+        this.config = config;
+        logger.info('Linear OAuth configuration saved');
+    }
+    /**
+     * Load OAuth configuration
+     */
+    loadConfig() {
+        if (!existsSync(this.configPath)) {
+            return null;
+        }
+        try {
+            const configData = readFileSync(this.configPath, 'utf8');
+            this.config = JSON.parse(configData);
+            return this.config;
+        }
+        catch (error) {
+            logger.error('Failed to load Linear configuration:', error);
+            return null;
+        }
+    }
+    /**
+     * Generate OAuth authorization URL with PKCE
+     */
+    generateAuthUrl(state) {
+        if (!this.config) {
+            throw new Error('Linear OAuth configuration not loaded');
+        }
+        // Generate PKCE parameters
+        const codeVerifier = randomBytes(32).toString('base64url');
+        const codeChallenge = createHash('sha256')
+            .update(codeVerifier)
+            .digest('base64url');
+        const params = new URLSearchParams({
+            client_id: this.config.clientId,
+            redirect_uri: this.config.redirectUri,
+            response_type: 'code',
+            scope: this.config.scopes.join(' '),
+            code_challenge: codeChallenge,
+            code_challenge_method: 'S256',
+            actor: 'app', // Enable actor authorization for service accounts
+        });
+        if (state) {
+            params.set('state', state);
+        }
+        const authUrl = `https://linear.app/oauth/authorize?${params.toString()}`;
+        return { url: authUrl, codeVerifier };
+    }
+    /**
+     * Exchange authorization code for access token
+     */
+    async exchangeCodeForToken(authCode, codeVerifier) {
+        if (!this.config) {
+            throw new Error('Linear OAuth configuration not loaded');
+        }
+        const tokenUrl = 'https://api.linear.app/oauth/token';
+        const body = new URLSearchParams({
+            grant_type: 'authorization_code',
+            client_id: this.config.clientId,
+            client_secret: this.config.clientSecret,
+            redirect_uri: this.config.redirectUri,
+            code: authCode,
+            code_verifier: codeVerifier,
+        });
+        const response = await fetch(tokenUrl, {
+            method: 'POST',
+            headers: {
+                'Content-Type': 'application/x-www-form-urlencoded',
+                Accept: 'application/json',
+            },
+            body: body.toString(),
+        });
+        if (!response.ok) {
+            const errorText = await response.text();
+            throw new Error(`Token exchange failed: ${response.status} ${errorText}`);
+        }
+        const result = (await response.json());
+        // Calculate expiration time (tokens expire in 24 hours)
+        const expiresAt = Date.now() + result.expiresIn * 1000;
+        const tokens = {
+            accessToken: result.accessToken,
+            refreshToken: result.refreshToken,
+            expiresAt,
+            scope: result.scope.split(' '),
+        };
+        this.saveTokens(tokens);
+        return tokens;
+    }
+    /**
+     * Refresh access token using refresh token
+     */
+    async refreshAccessToken() {
+        if (!this.config) {
+            throw new Error('Linear OAuth configuration not loaded');
+        }
+        const currentTokens = this.loadTokens();
+        if (!currentTokens?.refreshToken) {
+            throw new Error('No refresh token available');
+        }
+        const tokenUrl = 'https://api.linear.app/oauth/token';
+        const body = new URLSearchParams({
+            grant_type: 'refresh_token',
+            client_id: this.config.clientId,
+            client_secret: this.config.clientSecret,
+            refresh_token: currentTokens.refreshToken,
+        });
+        const response = await fetch(tokenUrl, {
+            method: 'POST',
+            headers: {
+                'Content-Type': 'application/x-www-form-urlencoded',
+                Accept: 'application/json',
+            },
+            body: body.toString(),
+        });
+        if (!response.ok) {
+            const errorText = await response.text();
+            throw new Error(`Token refresh failed: ${response.status} ${errorText}`);
+        }
+        const result = (await response.json());
+        const tokens = {
+            accessToken: result.accessToken,
+            refreshToken: result.refreshToken || currentTokens.refreshToken,
+            expiresAt: Date.now() + result.expiresIn * 1000,
+            scope: result.scope.split(' '),
+        };
+        this.saveTokens(tokens);
+        return tokens;
+    }
+    /**
+     * Get valid access token (refresh if needed)
+     */
+    async getValidToken() {
+        const tokens = this.loadTokens();
+        if (!tokens) {
+            throw new Error('No Linear tokens found. Please complete OAuth setup.');
+        }
+        // Check if token expires in next 5 minutes
+        const fiveMinutes = 5 * 60 * 1000;
+        if (tokens.expiresAt - Date.now() < fiveMinutes) {
+            logger.info('Linear token expiring soon, refreshing...');
+            const newTokens = await this.refreshAccessToken();
+            return newTokens.accessToken;
+        }
+        return tokens.accessToken;
+    }
+    /**
+     * Save tokens to file
+     */
+    saveTokens(tokens) {
+        writeFileSync(this.tokensPath, JSON.stringify(tokens, null, 2));
+        logger.info('Linear tokens saved');
+    }
+    /**
+     * Load tokens from file
+     */
+    loadTokens() {
+        if (!existsSync(this.tokensPath)) {
+            return null;
+        }
+        try {
+            const tokensData = readFileSync(this.tokensPath, 'utf8');
+            return JSON.parse(tokensData);
+        }
+        catch (error) {
+            logger.error('Failed to load Linear tokens:', error);
+            return null;
+        }
+    }
+    /**
+     * Clear stored tokens and config
+     */
+    clearAuth() {
+        if (existsSync(this.tokensPath)) {
+            writeFileSync(this.tokensPath, '');
+        }
+        if (existsSync(this.configPath)) {
+            writeFileSync(this.configPath, '');
+        }
+        logger.info('Linear authentication cleared');
+    }
+}
+/**
+ * Default Linear OAuth scopes for task management
+ */
+export const DEFAULT_LINEAR_SCOPES = [
+    'read', // Read issues, projects, teams
+    'write', // Create and update issues
+    'admin', // Manage team settings and workflows
+];
+/**
+ * Linear OAuth setup helper
+ */
+export class LinearOAuthSetup {
+    authManager;
+    constructor(projectRoot) {
+        this.authManager = new LinearAuthManager(projectRoot);
+    }
+    /**
+     * Interactive setup for Linear OAuth
+     */
+    async setupInteractive() {
+        // For now, we'll provide manual setup instructions
+        // In a full implementation, this could open a browser or use a local server
+        const config = {
+            clientId: process.env.LINEAR_CLIENT_ID || '',
+            clientSecret: process.env.LINEAR_CLIENT_SECRET || '',
+            redirectUri: process.env.LINEAR_REDIRECT_URI ||
+                'http://localhost:3456/auth/linear/callback',
+            scopes: DEFAULT_LINEAR_SCOPES,
+        };
+        if (!config.clientId || !config.clientSecret) {
+            return {
+                authUrl: '',
+                instructions: [
+                    '1. Create a Linear OAuth application at https://linear.app/settings/api',
+                    '2. Set redirect URI to: http://localhost:3456/auth/linear/callback',
+                    '3. Copy your Client ID and Client Secret',
+                    '4. Set environment variables:',
+                    '   export LINEAR_CLIENT_ID="your_client_id"',
+                    '   export LINEAR_CLIENT_SECRET="your_client_secret"',
+                    '5. Re-run this setup command',
+                ],
+            };
+        }
+        this.authManager.saveConfig(config);
+        const { url, codeVerifier } = this.authManager.generateAuthUrl();
+        // Store code verifier temporarily (in a real app, this would be in a secure session store)
+        process.env._LINEAR_CODE_VERIFIER = codeVerifier;
+        return {
+            authUrl: url,
+            instructions: [
+                '1. Open this URL in your browser:',
+                url,
+                '',
+                '2. Approve the StackMemory integration',
+                '3. Copy the authorization code from the redirect URL',
+                '4. Run: stackmemory linear authorize <code>',
+            ],
+        };
+    }
+    /**
+     * Complete OAuth flow with authorization code
+     */
+    async completeAuth(authCode) {
+        try {
+            const codeVerifier = process.env._LINEAR_CODE_VERIFIER;
+            if (!codeVerifier) {
+                throw new Error('Code verifier not found. Please restart the setup process.');
+            }
+            await this.authManager.exchangeCodeForToken(authCode, codeVerifier);
+            delete process.env._LINEAR_CODE_VERIFIER;
+            logger.info('Linear OAuth setup completed successfully!');
+            return true;
+        }
+        catch (error) {
+            logger.error('Failed to complete Linear OAuth setup:', error);
+            return false;
+        }
+    }
+    /**
+     * Test the Linear connection
+     */
+    async testConnection() {
+        try {
+            const token = await this.authManager.getValidToken();
+            // Test with a simple GraphQL query
+            const response = await fetch('https://api.linear.app/graphql', {
+                method: 'POST',
+                headers: {
+                    Authorization: `Bearer ${token}`,
+                    'Content-Type': 'application/json',
+                },
+                body: JSON.stringify({
+                    query: 'query { viewer { id name email } }',
+                }),
+            });
+            if (response.ok) {
+                const result = (await response.json());
+                if (result.data?.viewer) {
+                    logger.info(`Connected to Linear as: ${result.data.viewer.name} (${result.data.viewer.email})`);
+                    return true;
+                }
+            }
+            return false;
+        }
+        catch (error) {
+            logger.error('Linear connection test failed:', error);
+            return false;
+        }
+    }
+}
+//# sourceMappingURL=auth.js.map

package/dist/src/integrations/linear/auth.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"auth.js","sourceRoot":"","sources":["../../../../src/integrations/linear/auth.ts"],"names":[],"mappings":"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"}

package/dist/src/integrations/linear/auto-sync.d.ts

@@ -0,0 +1,77 @@
+/**
+ * Linear Auto-Sync Service
+ * Background service for automatic bidirectional synchronization
+ */
+import { SyncConfig } from './sync.js';
+export interface AutoSyncConfig extends SyncConfig {
+    enabled: boolean;
+    interval: number;
+    retryAttempts: number;
+    retryDelay: number;
+    quietHours?: {
+        start: number;
+        end: number;
+    };
+}
+export declare class LinearAutoSyncService {
+    private config;
+    private projectRoot;
+    private configManager;
+    private syncEngine?;
+    private intervalId?;
+    private isRunning;
+    private lastSyncTime;
+    private retryCount;
+    constructor(projectRoot: string, config?: Partial<AutoSyncConfig>);
+    /**
+     * Start the auto-sync service
+     */
+    start(): Promise<void>;
+    /**
+     * Stop the auto-sync service
+     */
+    stop(): void;
+    /**
+     * Get service status
+     */
+    getStatus(): {
+        running: boolean;
+        lastSyncTime: number;
+        nextSyncTime?: number;
+        retryCount: number;
+        config: AutoSyncConfig;
+    };
+    /**
+     * Update configuration
+     */
+    updateConfig(newConfig: Partial<AutoSyncConfig>): void;
+    /**
+     * Force immediate sync
+     */
+    forceSync(): Promise<void>;
+    /**
+     * Schedule next sync based on configuration
+     */
+    private scheduleNextSync;
+    /**
+     * Perform synchronization with error handling and retries
+     */
+    private performSync;
+    /**
+     * Check if current time is within quiet hours
+     */
+    private isInQuietHours;
+}
+/**
+ * Initialize global auto-sync service
+ */
+export declare function initializeAutoSync(projectRoot: string, config?: Partial<AutoSyncConfig>): LinearAutoSyncService;
+/**
+ * Get global auto-sync service
+ */
+export declare function getAutoSyncService(): LinearAutoSyncService | null;
+/**
+ * Stop global auto-sync service
+ */
+export declare function stopAutoSync(): void;
+//# sourceMappingURL=auto-sync.d.ts.map

package/dist/src/integrations/linear/auto-sync.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"auto-sync.d.ts","sourceRoot":"","sources":["../../../../src/integrations/linear/auto-sync.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAKH,OAAO,EAAyC,UAAU,EAAE,MAAM,WAAW,CAAC;AAM9E,MAAM,WAAW,cAAe,SAAQ,UAAU;IAChD,OAAO,EAAE,OAAO,CAAC;IACjB,QAAQ,EAAE,MAAM,CAAC;IACjB,aAAa,EAAE,MAAM,CAAC;IACtB,UAAU,EAAE,MAAM,CAAC;IACnB,UAAU,CAAC,EAAE;QACX,KAAK,EAAE,MAAM,CAAC;QACd,GAAG,EAAE,MAAM,CAAC;KACb,CAAC;CACH;AAED,qBAAa,qBAAqB;IAChC,OAAO,CAAC,MAAM,CAAiB;IAC/B,OAAO,CAAC,WAAW,CAAS;IAC5B,OAAO,CAAC,aAAa,CAAsB;IAC3C,OAAO,CAAC,UAAU,CAAC,CAAmB;IACtC,OAAO,CAAC,UAAU,CAAC,CAAiB;IACpC,OAAO,CAAC,SAAS,CAAS;IAC1B,OAAO,CAAC,YAAY,CAAK;IACzB,OAAO,CAAC,UAAU,CAAK;gBAEX,WAAW,EAAE,MAAM,EAAE,MAAM,CAAC,EAAE,OAAO,CAAC,cAAc,CAAC;IA4BjE;;OAEG;IACG,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC;IAyD5B;;OAEG;IACH,IAAI,IAAI,IAAI;IAUZ;;OAEG;IACH,SAAS,IAAI;QACX,OAAO,EAAE,OAAO,CAAC;QACjB,YAAY,EAAE,MAAM,CAAC;QACrB,YAAY,CAAC,EAAE,MAAM,CAAC;QACtB,UAAU,EAAE,MAAM,CAAC;QACnB,MAAM,EAAE,cAAc,CAAC;KACxB;IAcD;;OAEG;IACH,YAAY,CAAC,SAAS,EAAE,OAAO,CAAC,cAAc,CAAC,GAAG,IAAI;IAYtD;;OAEG;IACG,SAAS,IAAI,OAAO,CAAC,IAAI,CAAC;IAShC;;OAEG;IACH,OAAO,CAAC,gBAAgB;IAYxB;;OAEG;YACW,WAAW;IAkFzB;;OAEG;IACH,OAAO,CAAC,cAAc;CAevB;AAOD;;GAEG;AACH,wBAAgB,kBAAkB,CAChC,WAAW,EAAE,MAAM,EACnB,MAAM,CAAC,EAAE,OAAO,CAAC,cAAc,CAAC,GAC/B,qBAAqB,CAOvB;AAED;;GAEG;AACH,wBAAgB,kBAAkB,IAAI,qBAAqB,GAAG,IAAI,CAEjE;AAED;;GAEG;AACH,wBAAgB,YAAY,IAAI,IAAI,CAKnC"}

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

@@ -0,0 +1,268 @@
+/**
+ * Linear Auto-Sync Service
+ * Background service for automatic bidirectional synchronization
+ */
+import { logger } from '../../core/monitoring/logger.js';
+import { PebblesTaskStore } from '../../features/tasks/pebbles-task-store.js';
+import { LinearAuthManager } from './auth.js';
+import { LinearSyncEngine, DEFAULT_SYNC_CONFIG } from './sync.js';
+import { LinearConfigManager } from './config.js';
+import Database from 'better-sqlite3';
+import { join } from 'path';
+import { existsSync } from 'fs';
+export class LinearAutoSyncService {
+    config;
+    projectRoot;
+    configManager;
+    syncEngine;
+    intervalId;
+    isRunning = false;
+    lastSyncTime = 0;
+    retryCount = 0;
+    constructor(projectRoot, config) {
+        this.projectRoot = projectRoot;
+        this.configManager = new LinearConfigManager(projectRoot);
+        // Load persisted config or use defaults
+        const persistedConfig = this.configManager.loadConfig();
+        const baseConfig = persistedConfig
+            ? this.configManager.toAutoSyncConfig(persistedConfig)
+            : {
+                ...DEFAULT_SYNC_CONFIG,
+                enabled: true,
+                interval: 5,
+                retryAttempts: 3,
+                retryDelay: 30000,
+                autoSync: true,
+                direction: 'bidirectional',
+                conflictResolution: 'newest_wins',
+                quietHours: { start: 22, end: 7 },
+            };
+        this.config = { ...baseConfig, ...config };
+        // Save any new config updates
+        if (config && Object.keys(config).length > 0) {
+            this.configManager.saveConfig(config);
+        }
+    }
+    /**
+     * Start the auto-sync service
+     */
+    async start() {
+        if (this.isRunning) {
+            logger.warn('Linear auto-sync service is already running');
+            return;
+        }
+        try {
+            // Verify Linear integration is configured
+            const authManager = new LinearAuthManager(this.projectRoot);
+            if (!authManager.isConfigured()) {
+                throw new Error('Linear integration not configured. Run "stackmemory linear setup" first.');
+            }
+            // Initialize sync engine
+            const dbPath = join(this.projectRoot, '.stackmemory', 'context.db');
+            if (!existsSync(dbPath)) {
+                throw new Error('StackMemory not initialized. Run "stackmemory init" first.');
+            }
+            const db = new Database(dbPath);
+            const taskStore = new PebblesTaskStore(this.projectRoot, db);
+            this.syncEngine = new LinearSyncEngine(taskStore, authManager, this.config);
+            // Test connection before starting
+            const token = await authManager.getValidToken();
+            if (!token) {
+                throw new Error('Unable to get valid Linear token. Check authentication.');
+            }
+            this.isRunning = true;
+            this.scheduleNextSync();
+            logger.info('Linear auto-sync service started', {
+                interval: this.config.interval,
+                direction: this.config.direction,
+                conflictResolution: this.config.conflictResolution,
+            });
+            // Perform initial sync
+            this.performSync();
+        }
+        catch (error) {
+            logger.error('Failed to start Linear auto-sync service:', error);
+            throw error;
+        }
+    }
+    /**
+     * Stop the auto-sync service
+     */
+    stop() {
+        if (this.intervalId) {
+            clearTimeout(this.intervalId);
+            this.intervalId = undefined;
+        }
+        this.isRunning = false;
+        logger.info('Linear auto-sync service stopped');
+    }
+    /**
+     * Get service status
+     */
+    getStatus() {
+        const nextSyncTime = this.intervalId
+            ? this.lastSyncTime + this.config.interval * 60 * 1000
+            : undefined;
+        return {
+            running: this.isRunning,
+            lastSyncTime: this.lastSyncTime,
+            nextSyncTime,
+            retryCount: this.retryCount,
+            config: this.config,
+        };
+    }
+    /**
+     * Update configuration
+     */
+    updateConfig(newConfig) {
+        this.config = { ...this.config, ...newConfig };
+        if (this.isRunning) {
+            // Restart with new config
+            this.stop();
+            this.start();
+        }
+        logger.info('Linear auto-sync config updated', newConfig);
+    }
+    /**
+     * Force immediate sync
+     */
+    async forceSync() {
+        if (!this.syncEngine) {
+            throw new Error('Sync engine not initialized');
+        }
+        logger.info('Forcing immediate Linear sync');
+        await this.performSync();
+    }
+    /**
+     * Schedule next sync based on configuration
+     */
+    scheduleNextSync() {
+        if (!this.isRunning)
+            return;
+        const delay = this.config.interval * 60 * 1000; // Convert minutes to milliseconds
+        this.intervalId = setTimeout(() => {
+            if (this.isRunning) {
+                this.performSync();
+            }
+        }, delay);
+    }
+    /**
+     * Perform synchronization with error handling and retries
+     */
+    async performSync() {
+        if (!this.syncEngine) {
+            logger.error('Sync engine not available');
+            return;
+        }
+        // Check quiet hours
+        if (this.isInQuietHours()) {
+            logger.debug('Skipping sync during quiet hours');
+            this.scheduleNextSync();
+            return;
+        }
+        try {
+            logger.debug('Starting Linear auto-sync');
+            const result = await this.syncEngine.sync();
+            if (result.success) {
+                this.lastSyncTime = Date.now();
+                this.retryCount = 0;
+                // Log sync results
+                const hasChanges = result.synced.toLinear > 0 ||
+                    result.synced.fromLinear > 0 ||
+                    result.synced.updated > 0;
+                if (hasChanges) {
+                    logger.info('Linear auto-sync completed with changes', {
+                        toLinear: result.synced.toLinear,
+                        fromLinear: result.synced.fromLinear,
+                        updated: result.synced.updated,
+                        conflicts: result.conflicts.length,
+                    });
+                }
+                else {
+                    logger.debug('Linear auto-sync completed - no changes');
+                }
+                // Handle conflicts
+                if (result.conflicts.length > 0) {
+                    logger.warn('Linear sync conflicts detected', {
+                        count: result.conflicts.length,
+                        conflicts: result.conflicts.map((c) => ({
+                            taskId: c.taskId,
+                            reason: c.reason,
+                        })),
+                    });
+                }
+            }
+            else {
+                throw new Error(`Sync failed: ${result.errors.join(', ')}`);
+            }
+        }
+        catch (error) {
+            logger.error('Linear auto-sync failed:', error);
+            this.retryCount++;
+            if (this.retryCount <= this.config.retryAttempts) {
+                logger.info(`Retrying Linear sync in ${this.config.retryDelay / 1000}s (attempt ${this.retryCount}/${this.config.retryAttempts})`);
+                // Schedule retry
+                setTimeout(() => {
+                    if (this.isRunning) {
+                        this.performSync();
+                    }
+                }, this.config.retryDelay);
+                return; // Don't schedule next sync yet
+            }
+            else {
+                logger.error(`Linear auto-sync failed after ${this.config.retryAttempts} attempts, skipping until next interval`);
+                this.retryCount = 0;
+            }
+        }
+        // Schedule next sync
+        this.scheduleNextSync();
+    }
+    /**
+     * Check if current time is within quiet hours
+     */
+    isInQuietHours() {
+        if (!this.config.quietHours)
+            return false;
+        const now = new Date();
+        const currentHour = now.getHours();
+        const { start, end } = this.config.quietHours;
+        if (start < end) {
+            // Quiet hours within same day (e.g., 22:00 - 07:00 next day)
+            return currentHour >= start || currentHour < end;
+        }
+        else {
+            // Quiet hours span midnight (e.g., 10:00 - 18:00)
+            return currentHour >= start && currentHour < end;
+        }
+    }
+}
+/**
+ * Global auto-sync service instance
+ */
+let autoSyncService = null;
+/**
+ * Initialize global auto-sync service
+ */
+export function initializeAutoSync(projectRoot, config) {
+    if (autoSyncService) {
+        autoSyncService.stop();
+    }
+    autoSyncService = new LinearAutoSyncService(projectRoot, config);
+    return autoSyncService;
+}
+/**
+ * Get global auto-sync service
+ */
+export function getAutoSyncService() {
+    return autoSyncService;
+}
+/**
+ * Stop global auto-sync service
+ */
+export function stopAutoSync() {
+    if (autoSyncService) {
+        autoSyncService.stop();
+        autoSyncService = null;
+    }
+}
+//# sourceMappingURL=auto-sync.js.map