specweave 0.14.0 → 0.15.0

package/dist/src/core/sync/project-context.js

@@ -0,0 +1,354 @@
+/**
+ * Project Context Manager
+ *
+ * Manages project contexts for multi-project sync.
+ * Handles project detection, specs folder organization, and project-increment mapping.
+ */
+import * as fs from 'fs-extra';
+import * as path from 'path';
+export class ProjectContextManager {
+    constructor(projectRoot) {
+        this.config = null;
+        this.projectRoot = projectRoot;
+        this.configPath = path.join(projectRoot, '.specweave', 'config.json');
+    }
+    // ==========================================================================
+    // Load/Save Operations
+    // ==========================================================================
+    /**
+     * Load sync configuration
+     */
+    async load() {
+        if (this.config) {
+            return this.config;
+        }
+        try {
+            const content = await fs.readFile(this.configPath, 'utf-8');
+            const fullConfig = JSON.parse(content);
+            this.config = fullConfig.sync || {
+                profiles: {},
+                projects: {},
+                settings: {
+                    autoDetectProject: true,
+                    defaultTimeRange: '1M',
+                    rateLimitProtection: true,
+                },
+            };
+            return this.config;
+        }
+        catch (error) {
+            if (error.code === 'ENOENT') {
+                this.config = {
+                    profiles: {},
+                    projects: {},
+                    settings: {
+                        autoDetectProject: true,
+                        defaultTimeRange: '1M',
+                        rateLimitProtection: true,
+                    },
+                };
+                return this.config;
+            }
+            throw error;
+        }
+    }
+    /**
+     * Save sync configuration
+     */
+    async save() {
+        if (!this.config) {
+            throw new Error('No configuration loaded. Call load() first.');
+        }
+        // Read full config
+        let fullConfig = {};
+        try {
+            const content = await fs.readFile(this.configPath, 'utf-8');
+            fullConfig = JSON.parse(content);
+        }
+        catch (error) {
+            if (error.code !== 'ENOENT') {
+                throw error;
+            }
+        }
+        // Merge sync section
+        fullConfig.sync = this.config;
+        // Write back
+        await fs.ensureDir(path.dirname(this.configPath));
+        await fs.writeFile(this.configPath, JSON.stringify(fullConfig, null, 2), 'utf-8');
+    }
+    // ==========================================================================
+    // Project CRUD Operations
+    // ==========================================================================
+    /**
+     * Get all projects
+     */
+    async getAllProjects() {
+        const config = await this.load();
+        return config.projects || {};
+    }
+    /**
+     * Get a specific project by ID
+     */
+    async getProject(projectId) {
+        const config = await this.load();
+        return config.projects?.[projectId] || null;
+    }
+    /**
+     * Create a new project context
+     */
+    async createProject(projectId, project) {
+        const config = await this.load();
+        // Validate ID format
+        if (!/^[a-z0-9-]+$/.test(projectId)) {
+            throw new Error('Project ID must contain only lowercase letters, numbers, and hyphens');
+        }
+        // Check if project already exists
+        if (config.projects?.[projectId]) {
+            throw new Error(`Project '${projectId}' already exists`);
+        }
+        // Create specs folder
+        const specsFolder = project.specsFolder || `.specweave/docs/internal/specs/${projectId}`;
+        const fullPath = path.join(this.projectRoot, specsFolder);
+        await fs.ensureDir(fullPath);
+        // Create README for the project
+        const readmePath = path.join(fullPath, 'README.md');
+        await fs.writeFile(readmePath, this.generateProjectReadme(projectId, project), 'utf-8');
+        // Add project
+        if (!config.projects) {
+            config.projects = {};
+        }
+        config.projects[projectId] = {
+            id: projectId,
+            ...project,
+            specsFolder,
+            increments: project.increments || [],
+        };
+        await this.save();
+    }
+    /**
+     * Update a project context
+     */
+    async updateProject(projectId, updates) {
+        const config = await this.load();
+        const existing = config.projects?.[projectId];
+        if (!existing) {
+            throw new Error(`Project '${projectId}' does not exist`);
+        }
+        // Merge updates
+        config.projects[projectId] = {
+            ...existing,
+            ...updates,
+            id: projectId, // Preserve ID
+        };
+        await this.save();
+    }
+    /**
+     * Delete a project context
+     */
+    async deleteProject(projectId, deleteSpecs = false) {
+        const config = await this.load();
+        const project = config.projects?.[projectId];
+        if (!project) {
+            throw new Error(`Project '${projectId}' does not exist`);
+        }
+        // Optionally delete specs folder
+        if (deleteSpecs && project.specsFolder) {
+            const fullPath = path.join(this.projectRoot, project.specsFolder);
+            await fs.remove(fullPath);
+        }
+        delete config.projects[projectId];
+        await this.save();
+    }
+    // ==========================================================================
+    // Project Detection
+    // ==========================================================================
+    /**
+     * Detect project from increment description
+     *
+     * @param description Increment description text
+     * @returns Detection result with matched project and confidence score
+     */
+    async detectProject(description) {
+        const config = await this.load();
+        const projects = config.projects || {};
+        if (Object.keys(projects).length === 0) {
+            return {
+                confidence: 0,
+                matchedKeywords: [],
+            };
+        }
+        const lowerDesc = description.toLowerCase();
+        let bestMatch;
+        let bestScore = 0;
+        let bestKeywords = [];
+        for (const project of Object.values(projects)) {
+            let score = 0;
+            const matchedKeywords = [];
+            // Check project name
+            if (lowerDesc.includes(project.name.toLowerCase())) {
+                score += 10;
+                matchedKeywords.push(project.name);
+            }
+            // Check team name
+            if (project.team && lowerDesc.includes(project.team.toLowerCase())) {
+                score += 5;
+                matchedKeywords.push(project.team);
+            }
+            // Check keywords
+            for (const keyword of project.keywords) {
+                if (lowerDesc.includes(keyword.toLowerCase())) {
+                    score += 3;
+                    matchedKeywords.push(keyword);
+                }
+            }
+            // Update best match
+            if (score > bestScore) {
+                bestScore = score;
+                bestMatch = project;
+                bestKeywords = matchedKeywords;
+            }
+        }
+        // Calculate confidence (0-1)
+        const confidence = bestScore > 0 ? Math.min(bestScore / 10, 1) : 0;
+        const result = {
+            project: bestMatch,
+            confidence,
+            matchedKeywords: bestKeywords,
+        };
+        // Add suggested profile if project has default
+        if (bestMatch?.defaultSyncProfile) {
+            result.suggestedProfile = bestMatch.defaultSyncProfile;
+        }
+        return result;
+    }
+    /**
+     * Link increment to project
+     */
+    async linkIncrementToProject(projectId, incrementId) {
+        const config = await this.load();
+        const project = config.projects?.[projectId];
+        if (!project) {
+            throw new Error(`Project '${projectId}' does not exist`);
+        }
+        // Add increment to project's increments list
+        if (!project.increments) {
+            project.increments = [];
+        }
+        if (!project.increments.includes(incrementId)) {
+            project.increments.push(incrementId);
+            await this.save();
+        }
+    }
+    /**
+     * Unlink increment from project
+     */
+    async unlinkIncrementFromProject(projectId, incrementId) {
+        const config = await this.load();
+        const project = config.projects?.[projectId];
+        if (!project) {
+            throw new Error(`Project '${projectId}' does not exist`);
+        }
+        if (project.increments) {
+            project.increments = project.increments.filter((id) => id !== incrementId);
+            await this.save();
+        }
+    }
+    // ==========================================================================
+    // Specs Folder Management
+    // ==========================================================================
+    /**
+     * Get specs folder path for a project
+     */
+    getSpecsFolder(projectId) {
+        return `.specweave/docs/internal/specs/${projectId}`;
+    }
+    /**
+     * Ensure specs folder exists for a project
+     */
+    async ensureSpecsFolder(projectId) {
+        const project = await this.getProject(projectId);
+        if (!project) {
+            throw new Error(`Project '${projectId}' does not exist`);
+        }
+        const fullPath = path.join(this.projectRoot, project.specsFolder);
+        await fs.ensureDir(fullPath);
+        return project.specsFolder;
+    }
+    /**
+     * Get all spec files for a project
+     */
+    async getProjectSpecs(projectId) {
+        const project = await this.getProject(projectId);
+        if (!project) {
+            throw new Error(`Project '${projectId}' does not exist`);
+        }
+        const fullPath = path.join(this.projectRoot, project.specsFolder);
+        try {
+            const files = await fs.readdir(fullPath);
+            return files
+                .filter((f) => f.startsWith('spec-') && f.endsWith('.md'))
+                .map((f) => path.join(project.specsFolder, f));
+        }
+        catch (error) {
+            if (error.code === 'ENOENT') {
+                return [];
+            }
+            throw error;
+        }
+    }
+    // ==========================================================================
+    // Helper Methods
+    // ==========================================================================
+    /**
+     * Generate README for project specs folder
+     */
+    generateProjectReadme(projectId, project) {
+        return `# ${project.name}
+
+${project.description}
+
+${project.team ? `**Team**: ${project.team}\n` : ''}
+**Keywords**: ${project.keywords.join(', ')}
+${project.defaultSyncProfile ? `**Default Sync**: ${project.defaultSyncProfile}\n` : ''}
+
+## Specifications
+
+This folder contains all specifications for the **${project.name}** project.
+
+- Each spec file follows the format: \`spec-NNN-feature-area.md\`
+- Specs are permanent, feature-level documentation
+- Updated continuously as features evolve
+
+## Related Increments
+
+${project.increments && project.increments.length > 0
+            ? project.increments.map((inc) => `- ${inc}`).join('\n')
+            : 'No increments yet.'}
+
+---
+
+**Last Updated**: ${new Date().toISOString().split('T')[0]}
+`;
+    }
+    /**
+     * Get statistics about projects
+     */
+    async getStats() {
+        const config = await this.load();
+        const projects = config.projects || {};
+        const stats = {
+            totalProjects: Object.keys(projects).length,
+            totalIncrements: 0,
+            projectsByTeam: {},
+        };
+        for (const project of Object.values(projects)) {
+            stats.totalIncrements += project.increments?.length || 0;
+            if (project.team) {
+                stats.projectsByTeam[project.team] =
+                    (stats.projectsByTeam[project.team] || 0) + 1;
+            }
+        }
+        return stats;
+    }
+}
+//# sourceMappingURL=project-context.js.map

package/dist/src/core/sync/project-context.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"project-context.js","sourceRoot":"","sources":["../../../../src/core/sync/project-context.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,KAAK,EAAE,MAAM,UAAU,CAAC;AAC/B,OAAO,KAAK,IAAI,MAAM,MAAM,CAAC;AAO7B,MAAM,OAAO,qBAAqB;IAKhC,YAAY,WAAmB;QAFvB,WAAM,GAA6B,IAAI,CAAC;QAG9C,IAAI,CAAC,WAAW,GAAG,WAAW,CAAC;QAC/B,IAAI,CAAC,UAAU,GAAG,IAAI,CAAC,IAAI,CAAC,WAAW,EAAE,YAAY,EAAE,aAAa,CAAC,CAAC;IACxE,CAAC;IAED,6EAA6E;IAC7E,uBAAuB;IACvB,6EAA6E;IAE7E;;OAEG;IACH,KAAK,CAAC,IAAI;QACR,IAAI,IAAI,CAAC,MAAM,EAAE,CAAC;YAChB,OAAO,IAAI,CAAC,MAAM,CAAC;QACrB,CAAC;QAED,IAAI,CAAC;YACH,MAAM,OAAO,GAAG,MAAM,EAAE,CAAC,QAAQ,CAAC,IAAI,CAAC,UAAU,EAAE,OAAO,CAAC,CAAC;YAC5D,MAAM,UAAU,GAAG,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC;YAEvC,IAAI,CAAC,MAAM,GAAG,UAAU,CAAC,IAAI,IAAI;gBAC/B,QAAQ,EAAE,EAAE;gBACZ,QAAQ,EAAE,EAAE;gBACZ,QAAQ,EAAE;oBACR,iBAAiB,EAAE,IAAI;oBACvB,gBAAgB,EAAE,IAAI;oBACtB,mBAAmB,EAAE,IAAI;iBAC1B;aACF,CAAC;YAEF,OAAO,IAAI,CAAC,MAAM,CAAC;QACrB,CAAC;QAAC,OAAO,KAAU,EAAE,CAAC;YACpB,IAAI,KAAK,CAAC,IAAI,KAAK,QAAQ,EAAE,CAAC;gBAC5B,IAAI,CAAC,MAAM,GAAG;oBACZ,QAAQ,EAAE,EAAE;oBACZ,QAAQ,EAAE,EAAE;oBACZ,QAAQ,EAAE;wBACR,iBAAiB,EAAE,IAAI;wBACvB,gBAAgB,EAAE,IAAI;wBACtB,mBAAmB,EAAE,IAAI;qBAC1B;iBACF,CAAC;gBACF,OAAO,IAAI,CAAC,MAAM,CAAC;YACrB,CAAC;YACD,MAAM,KAAK,CAAC;QACd,CAAC;IACH,CAAC;IAED;;OAEG;IACH,KAAK,CAAC,IAAI;QACR,IAAI,CAAC,IAAI,CAAC,MAAM,EAAE,CAAC;YACjB,MAAM,IAAI,KAAK,CAAC,6CAA6C,CAAC,CAAC;QACjE,CAAC;QAED,mBAAmB;QACnB,IAAI,UAAU,GAAQ,EAAE,CAAC;QACzB,IAAI,CAAC;YACH,MAAM,OAAO,GAAG,MAAM,EAAE,CAAC,QAAQ,CAAC,IAAI,CAAC,UAAU,EAAE,OAAO,CAAC,CAAC;YAC5D,UAAU,GAAG,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC;QACnC,CAAC;QAAC,OAAO,KAAU,EAAE,CAAC;YACpB,IAAI,KAAK,CAAC,IAAI,KAAK,QAAQ,EAAE,CAAC;gBAC5B,MAAM,KAAK,CAAC;YACd,CAAC;QACH,CAAC;QAED,qBAAqB;QACrB,UAAU,CAAC,IAAI,GAAG,IAAI,CAAC,MAAM,CAAC;QAE9B,aAAa;QACb,MAAM,EAAE,CAAC,SAAS,CAAC,IAAI,CAAC,OAAO,CAAC,IAAI,CAAC,UAAU,CAAC,CAAC,CAAC;QAClD,MAAM,EAAE,CAAC,SAAS,CAChB,IAAI,CAAC,UAAU,EACf,IAAI,CAAC,SAAS,CAAC,UAAU,EAAE,IAAI,EAAE,CAAC,CAAC,EACnC,OAAO,CACR,CAAC;IACJ,CAAC;IAED,6EAA6E;IAC7E,0BAA0B;IAC1B,6EAA6E;IAE7E;;OAEG;IACH,KAAK,CAAC,cAAc;QAClB,MAAM,MAAM,GAAG,MAAM,IAAI,CAAC,IAAI,EAAE,CAAC;QACjC,OAAO,MAAM,CAAC,QAAQ,IAAI,EAAE,CAAC;IAC/B,CAAC;IAED;;OAEG;IACH,KAAK,CAAC,UAAU,CAAC,SAAiB;QAChC,MAAM,MAAM,GAAG,MAAM,IAAI,CAAC,IAAI,EAAE,CAAC;QACjC,OAAO,MAAM,CAAC,QAAQ,EAAE,CAAC,SAAS,CAAC,IAAI,IAAI,CAAC;IAC9C,CAAC;IAED;;OAEG;IACH,KAAK,CAAC,aAAa,CACjB,SAAiB,EACjB,OAAmC;QAEnC,MAAM,MAAM,GAAG,MAAM,IAAI,CAAC,IAAI,EAAE,CAAC;QAEjC,qBAAqB;QACrB,IAAI,CAAC,cAAc,CAAC,IAAI,CAAC,SAAS,CAAC,EAAE,CAAC;YACpC,MAAM,IAAI,KAAK,CACb,sEAAsE,CACvE,CAAC;QACJ,CAAC;QAED,kCAAkC;QAClC,IAAI,MAAM,CAAC,QAAQ,EAAE,CAAC,SAAS,CAAC,EAAE,CAAC;YACjC,MAAM,IAAI,KAAK,CAAC,YAAY,SAAS,kBAAkB,CAAC,CAAC;QAC3D,CAAC;QAED,sBAAsB;QACtB,MAAM,WAAW,GAAG,OAAO,CAAC,WAAW,IAAI,kCAAkC,SAAS,EAAE,CAAC;QACzF,MAAM,QAAQ,GAAG,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC,WAAW,EAAE,WAAW,CAAC,CAAC;QAC1D,MAAM,EAAE,CAAC,SAAS,CAAC,QAAQ,CAAC,CAAC;QAE7B,gCAAgC;QAChC,MAAM,UAAU,GAAG,IAAI,CAAC,IAAI,CAAC,QAAQ,EAAE,WAAW,CAAC,CAAC;QACpD,MAAM,EAAE,CAAC,SAAS,CAChB,UAAU,EACV,IAAI,CAAC,qBAAqB,CAAC,SAAS,EAAE,OAAyB,CAAC,EAChE,OAAO,CACR,CAAC;QAEF,cAAc;QACd,IAAI,CAAC,MAAM,CAAC,QAAQ,EAAE,CAAC;YACrB,MAAM,CAAC,QAAQ,GAAG,EAAE,CAAC;QACvB,CAAC;QAED,MAAM,CAAC,QAAQ,CAAC,SAAS,CAAC,GAAG;YAC3B,EAAE,EAAE,SAAS;YACb,GAAG,OAAO;YACV,WAAW;YACX,UAAU,EAAE,OAAO,CAAC,UAAU,IAAI,EAAE;SACrC,CAAC;QAEF,MAAM,IAAI,CAAC,IAAI,EAAE,CAAC;IACpB,CAAC;IAED;;OAEG;IACH,KAAK,CAAC,aAAa,CACjB,SAAiB,EACjB,OAA4C;QAE5C,MAAM,MAAM,GAAG,MAAM,IAAI,CAAC,IAAI,EAAE,CAAC;QAEjC,MAAM,QAAQ,GAAG,MAAM,CAAC,QAAQ,EAAE,CAAC,SAAS,CAAC,CAAC;QAC9C,IAAI,CAAC,QAAQ,EAAE,CAAC;YACd,MAAM,IAAI,KAAK,CAAC,YAAY,SAAS,kBAAkB,CAAC,CAAC;QAC3D,CAAC;QAED,gBAAgB;QAChB,MAAM,CAAC,QAAS,CAAC,SAAS,CAAC,GAAG;YAC5B,GAAG,QAAQ;YACX,GAAG,OAAO;YACV,EAAE,EAAE,SAAS,EAAE,cAAc;SAC9B,CAAC;QAEF,MAAM,IAAI,CAAC,IAAI,EAAE,CAAC;IACpB,CAAC;IAED;;OAEG;IACH,KAAK,CAAC,aAAa,CAAC,SAAiB,EAAE,cAAuB,KAAK;QACjE,MAAM,MAAM,GAAG,MAAM,IAAI,CAAC,IAAI,EAAE,CAAC;QAEjC,MAAM,OAAO,GAAG,MAAM,CAAC,QAAQ,EAAE,CAAC,SAAS,CAAC,CAAC;QAC7C,IAAI,CAAC,OAAO,EAAE,CAAC;YACb,MAAM,IAAI,KAAK,CAAC,YAAY,SAAS,kBAAkB,CAAC,CAAC;QAC3D,CAAC;QAED,iCAAiC;QACjC,IAAI,WAAW,IAAI,OAAO,CAAC,WAAW,EAAE,CAAC;YACvC,MAAM,QAAQ,GAAG,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC,WAAW,EAAE,OAAO,CAAC,WAAW,CAAC,CAAC;YAClE,MAAM,EAAE,CAAC,MAAM,CAAC,QAAQ,CAAC,CAAC;QAC5B,CAAC;QAED,OAAO,MAAM,CAAC,QAAQ,CAAC,SAAS,CAAC,CAAC;QAClC,MAAM,IAAI,CAAC,IAAI,EAAE,CAAC;IACpB,CAAC;IAED,6EAA6E;IAC7E,oBAAoB;IACpB,6EAA6E;IAE7E;;;;;OAKG;IACH,KAAK,CAAC,aAAa,CAAC,WAAmB;QACrC,MAAM,MAAM,GAAG,MAAM,IAAI,CAAC,IAAI,EAAE,CAAC;QACjC,MAAM,QAAQ,GAAG,MAAM,CAAC,QAAQ,IAAI,EAAE,CAAC;QAEvC,IAAI,MAAM,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;YACvC,OAAO;gBACL,UAAU,EAAE,CAAC;gBACb,eAAe,EAAE,EAAE;aACpB,CAAC;QACJ,CAAC;QAED,MAAM,SAAS,GAAG,WAAW,CAAC,WAAW,EAAE,CAAC;QAC5C,IAAI,SAAqC,CAAC;QAC1C,IAAI,SAAS,GAAG,CAAC,CAAC;QAClB,IAAI,YAAY,GAAa,EAAE,CAAC;QAEhC,KAAK,MAAM,OAAO,IAAI,MAAM,CAAC,MAAM,CAAC,QAAQ,CAAC,EAAE,CAAC;YAC9C,IAAI,KAAK,GAAG,CAAC,CAAC;YACd,MAAM,eAAe,GAAa,EAAE,CAAC;YAErC,qBAAqB;YACrB,IAAI,SAAS,CAAC,QAAQ,CAAC,OAAO,CAAC,IAAI,CAAC,WAAW,EAAE,CAAC,EAAE,CAAC;gBACnD,KAAK,IAAI,EAAE,CAAC;gBACZ,eAAe,CAAC,IAAI,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC;YACrC,CAAC;YAED,kBAAkB;YAClB,IAAI,OAAO,CAAC,IAAI,IAAI,SAAS,CAAC,QAAQ,CAAC,OAAO,CAAC,IAAI,CAAC,WAAW,EAAE,CAAC,EAAE,CAAC;gBACnE,KAAK,IAAI,CAAC,CAAC;gBACX,eAAe,CAAC,IAAI,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC;YACrC,CAAC;YAED,iBAAiB;YACjB,KAAK,MAAM,OAAO,IAAI,OAAO,CAAC,QAAQ,EAAE,CAAC;gBACvC,IAAI,SAAS,CAAC,QAAQ,CAAC,OAAO,CAAC,WAAW,EAAE,CAAC,EAAE,CAAC;oBAC9C,KAAK,IAAI,CAAC,CAAC;oBACX,eAAe,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC;gBAChC,CAAC;YACH,CAAC;YAED,oBAAoB;YACpB,IAAI,KAAK,GAAG,SAAS,EAAE,CAAC;gBACtB,SAAS,GAAG,KAAK,CAAC;gBAClB,SAAS,GAAG,OAAO,CAAC;gBACpB,YAAY,GAAG,eAAe,CAAC;YACjC,CAAC;QACH,CAAC;QAED,6BAA6B;QAC7B,MAAM,UAAU,GAAG,SAAS,GAAG,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,GAAG,CAAC,SAAS,GAAG,EAAE,EAAE,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC;QAEnE,MAAM,MAAM,GAA2B;YACrC,OAAO,EAAE,SAAS;YAClB,UAAU;YACV,eAAe,EAAE,YAAY;SAC9B,CAAC;QAEF,+CAA+C;QAC/C,IAAI,SAAS,EAAE,kBAAkB,EAAE,CAAC;YAClC,MAAM,CAAC,gBAAgB,GAAG,SAAS,CAAC,kBAAkB,CAAC;QACzD,CAAC;QAED,OAAO,MAAM,CAAC;IAChB,CAAC;IAED;;OAEG;IACH,KAAK,CAAC,sBAAsB,CAC1B,SAAiB,EACjB,WAAmB;QAEnB,MAAM,MAAM,GAAG,MAAM,IAAI,CAAC,IAAI,EAAE,CAAC;QAEjC,MAAM,OAAO,GAAG,MAAM,CAAC,QAAQ,EAAE,CAAC,SAAS,CAAC,CAAC;QAC7C,IAAI,CAAC,OAAO,EAAE,CAAC;YACb,MAAM,IAAI,KAAK,CAAC,YAAY,SAAS,kBAAkB,CAAC,CAAC;QAC3D,CAAC;QAED,6CAA6C;QAC7C,IAAI,CAAC,OAAO,CAAC,UAAU,EAAE,CAAC;YACxB,OAAO,CAAC,UAAU,GAAG,EAAE,CAAC;QAC1B,CAAC;QAED,IAAI,CAAC,OAAO,CAAC,UAAU,CAAC,QAAQ,CAAC,WAAW,CAAC,EAAE,CAAC;YAC9C,OAAO,CAAC,UAAU,CAAC,IAAI,CAAC,WAAW,CAAC,CAAC;YACrC,MAAM,IAAI,CAAC,IAAI,EAAE,CAAC;QACpB,CAAC;IACH,CAAC;IAED;;OAEG;IACH,KAAK,CAAC,0BAA0B,CAC9B,SAAiB,EACjB,WAAmB;QAEnB,MAAM,MAAM,GAAG,MAAM,IAAI,CAAC,IAAI,EAAE,CAAC;QAEjC,MAAM,OAAO,GAAG,MAAM,CAAC,QAAQ,EAAE,CAAC,SAAS,CAAC,CAAC;QAC7C,IAAI,CAAC,OAAO,EAAE,CAAC;YACb,MAAM,IAAI,KAAK,CAAC,YAAY,SAAS,kBAAkB,CAAC,CAAC;QAC3D,CAAC;QAED,IAAI,OAAO,CAAC,UAAU,EAAE,CAAC;YACvB,OAAO,CAAC,UAAU,GAAG,OAAO,CAAC,UAAU,CAAC,MAAM,CAAC,CAAC,EAAE,EAAE,EAAE,CAAC,EAAE,KAAK,WAAW,CAAC,CAAC;YAC3E,MAAM,IAAI,CAAC,IAAI,EAAE,CAAC;QACpB,CAAC;IACH,CAAC;IAED,6EAA6E;IAC7E,0BAA0B;IAC1B,6EAA6E;IAE7E;;OAEG;IACH,cAAc,CAAC,SAAiB;QAC9B,OAAO,kCAAkC,SAAS,EAAE,CAAC;IACvD,CAAC;IAED;;OAEG;IACH,KAAK,CAAC,iBAAiB,CAAC,SAAiB;QACvC,MAAM,OAAO,GAAG,MAAM,IAAI,CAAC,UAAU,CAAC,SAAS,CAAC,CAAC;QACjD,IAAI,CAAC,OAAO,EAAE,CAAC;YACb,MAAM,IAAI,KAAK,CAAC,YAAY,SAAS,kBAAkB,CAAC,CAAC;QAC3D,CAAC;QAED,MAAM,QAAQ,GAAG,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC,WAAW,EAAE,OAAO,CAAC,WAAW,CAAC,CAAC;QAClE,MAAM,EAAE,CAAC,SAAS,CAAC,QAAQ,CAAC,CAAC;QAE7B,OAAO,OAAO,CAAC,WAAW,CAAC;IAC7B,CAAC;IAED;;OAEG;IACH,KAAK,CAAC,eAAe,CAAC,SAAiB;QACrC,MAAM,OAAO,GAAG,MAAM,IAAI,CAAC,UAAU,CAAC,SAAS,CAAC,CAAC;QACjD,IAAI,CAAC,OAAO,EAAE,CAAC;YACb,MAAM,IAAI,KAAK,CAAC,YAAY,SAAS,kBAAkB,CAAC,CAAC;QAC3D,CAAC;QAED,MAAM,QAAQ,GAAG,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC,WAAW,EAAE,OAAO,CAAC,WAAW,CAAC,CAAC;QAElE,IAAI,CAAC;YACH,MAAM,KAAK,GAAG,MAAM,EAAE,CAAC,OAAO,CAAC,QAAQ,CAAC,CAAC;YACzC,OAAO,KAAK;iBACT,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,UAAU,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC,QAAQ,CAAC,KAAK,CAAC,CAAC;iBACzD,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,IAAI,CAAC,IAAI,CAAC,OAAO,CAAC,WAAW,EAAE,CAAC,CAAC,CAAC,CAAC;QACnD,CAAC;QAAC,OAAO,KAAU,EAAE,CAAC;YACpB,IAAI,KAAK,CAAC,IAAI,KAAK,QAAQ,EAAE,CAAC;gBAC5B,OAAO,EAAE,CAAC;YACZ,CAAC;YACD,MAAM,KAAK,CAAC;QACd,CAAC;IACH,CAAC;IAED,6EAA6E;IAC7E,iBAAiB;IACjB,6EAA6E;IAE7E;;OAEG;IACK,qBAAqB,CAAC,SAAiB,EAAE,OAAuB;QACtE,OAAO,KAAK,OAAO,CAAC,IAAI;;EAE1B,OAAO,CAAC,WAAW;;EAEnB,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,aAAa,OAAO,CAAC,IAAI,IAAI,CAAC,CAAC,CAAC,EAAE;gBACnC,OAAO,CAAC,QAAQ,CAAC,IAAI,CAAC,IAAI,CAAC;EACzC,OAAO,CAAC,kBAAkB,CAAC,CAAC,CAAC,qBAAqB,OAAO,CAAC,kBAAkB,IAAI,CAAC,CAAC,CAAC,EAAE;;;;oDAInC,OAAO,CAAC,IAAI;;;;;;;;EAQ9D,OAAO,CAAC,UAAU,IAAI,OAAO,CAAC,UAAU,CAAC,MAAM,GAAG,CAAC;YACnD,CAAC,CAAC,OAAO,CAAC,UAAU,CAAC,GAAG,CAAC,CAAC,GAAG,EAAE,EAAE,CAAC,KAAK,GAAG,EAAE,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC;YACxD,CAAC,CAAC,oBACJ;;;;oBAIoB,IAAI,IAAI,EAAE,CAAC,WAAW,EAAE,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC;CACzD,CAAC;IACA,CAAC;IAED;;OAEG;IACH,KAAK,CAAC,QAAQ;QAKZ,MAAM,MAAM,GAAG,MAAM,IAAI,CAAC,IAAI,EAAE,CAAC;QACjC,MAAM,QAAQ,GAAG,MAAM,CAAC,QAAQ,IAAI,EAAE,CAAC;QAEvC,MAAM,KAAK,GAAG;YACZ,aAAa,EAAE,MAAM,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAC,MAAM;YAC3C,eAAe,EAAE,CAAC;YAClB,cAAc,EAAE,EAA4B;SAC7C,CAAC;QAEF,KAAK,MAAM,OAAO,IAAI,MAAM,CAAC,MAAM,CAAC,QAAQ,CAAC,EAAE,CAAC;YAC9C,KAAK,CAAC,eAAe,IAAI,OAAO,CAAC,UAAU,EAAE,MAAM,IAAI,CAAC,CAAC;YAEzD,IAAI,OAAO,CAAC,IAAI,EAAE,CAAC;gBACjB,KAAK,CAAC,cAAc,CAAC,OAAO,CAAC,IAAI,CAAC;oBAChC,CAAC,KAAK,CAAC,cAAc,CAAC,OAAO,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC,GAAG,CAAC,CAAC;YAClD,CAAC;QACH,CAAC;QAED,OAAO,KAAK,CAAC;IACf,CAAC;CACF"}

package/dist/src/core/sync/rate-limiter.d.ts

@@ -0,0 +1,116 @@
+/**
+ * Rate Limiter for External Sync
+ *
+ * Provides rate limiting protection, estimation, and backoff strategies
+ * for GitHub, JIRA, and Azure DevOps sync operations.
+ */
+import { SyncProvider, TimeRangePreset, TimeRangeEstimate, RateLimitStatus } from '../types/sync-profile';
+export declare const PROVIDER_RATE_LIMITS: {
+    readonly github: {
+        readonly limit: 5000;
+        readonly window: "1h";
+        readonly thresholds: {
+            readonly low: 250;
+            readonly medium: 1000;
+            readonly high: 2500;
+        };
+    };
+    readonly jira: {
+        readonly limit: 100;
+        readonly window: "1m";
+        readonly thresholds: {
+            readonly low: 25;
+            readonly medium: 50;
+            readonly high: 75;
+        };
+    };
+    readonly ado: {
+        readonly limit: 200;
+        readonly window: "5m";
+        readonly thresholds: {
+            readonly low: 50;
+            readonly medium: 100;
+            readonly high: 150;
+        };
+    };
+};
+export declare class RateLimiter {
+    private provider;
+    constructor(provider: SyncProvider);
+    /**
+     * Estimate sync operation impact
+     *
+     * @param timeRange Time range preset
+     * @param customFactor Custom scaling factor (default: 1.0)
+     * @returns Estimate of items, API calls, duration, and impact
+     */
+    estimateSync(timeRange: TimeRangePreset, customFactor?: number): TimeRangeEstimate;
+    /**
+     * Calculate rate limit impact level
+     *
+     * @param apiCalls Number of API calls
+     * @returns Impact level: low, medium, high, or critical
+     */
+    private calculateImpact;
+    /**
+     * Check current rate limit status (provider-specific)
+     *
+     * @param client Provider client (e.g., GitHubClient)
+     * @returns Current rate limit status
+     */
+    checkRateLimitStatus(client: any): Promise<RateLimitStatus | null>;
+    /**
+     * Check GitHub rate limit status
+     */
+    private checkGitHubRateLimit;
+    /**
+     * Check JIRA rate limit status
+     * (JIRA doesn't expose rate limit info - return estimated)
+     */
+    private checkJiraRateLimit;
+    /**
+     * Check Azure DevOps rate limit status
+     * (ADO doesn't expose rate limit info - return estimated)
+     */
+    private checkAdoRateLimit;
+    /**
+     * Validate sync operation is safe to proceed
+     *
+     * @param estimate Sync estimate
+     * @param rateLimitStatus Current rate limit status (optional)
+     * @returns Validation result
+     */
+    validateSync(estimate: TimeRangeEstimate, rateLimitStatus?: RateLimitStatus | null): {
+        safe: boolean;
+        warnings: string[];
+        blockers: string[];
+    };
+    /**
+     * Get impact percentage for given API calls
+     */
+    private getImpactPercentage;
+    /**
+     * Calculate backoff delay when rate limited
+     *
+     * @param attempt Current retry attempt (0-indexed)
+     * @param maxBackoff Maximum backoff in milliseconds (default: 5 minutes)
+     * @returns Delay in milliseconds
+     */
+    calculateBackoff(attempt: number, maxBackoff?: number): number;
+    /**
+     * Wait for rate limit to reset
+     *
+     * @param resetAt ISO timestamp when rate limit resets
+     * @returns Promise that resolves when rate limit resets
+     */
+    waitForReset(resetAt: string): Promise<void>;
+    /**
+     * Format estimate for display
+     */
+    formatEstimate(estimate: TimeRangeEstimate): string;
+    /**
+     * Format rate limit status for display
+     */
+    formatRateLimitStatus(status: RateLimitStatus): string;
+}
+//# sourceMappingURL=rate-limiter.d.ts.map

package/dist/src/core/sync/rate-limiter.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"rate-limiter.d.ts","sourceRoot":"","sources":["../../../../src/core/sync/rate-limiter.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAGH,OAAO,EACL,YAAY,EACZ,eAAe,EACf,iBAAiB,EACjB,eAAe,EAChB,MAAM,uBAAuB,CAAC;AAM/B,eAAO,MAAM,oBAAoB;;;;;;;;;;;;;;;;;;;;;;;;;;;;CA4BvB,CAAC;AAkCX,qBAAa,WAAW;IACtB,OAAO,CAAC,QAAQ,CAAe;gBAEnB,QAAQ,EAAE,YAAY;IAQlC;;;;;;OAMG;IACH,YAAY,CACV,SAAS,EAAE,eAAe,EAC1B,YAAY,GAAE,MAAY,GACzB,iBAAiB;IAsBpB;;;;;OAKG;IACH,OAAO,CAAC,eAAe;IAoBvB;;;;;OAKG;IACG,oBAAoB,CAAC,MAAM,EAAE,GAAG,GAAG,OAAO,CAAC,eAAe,GAAG,IAAI,CAAC;IAiBxE;;OAEG;YACW,oBAAoB;IA+BlC;;;OAGG;YACW,kBAAkB;IAYhC;;;OAGG;YACW,iBAAiB;IAgB/B;;;;;;OAMG;IACH,YAAY,CACV,QAAQ,EAAE,iBAAiB,EAC3B,eAAe,CAAC,EAAE,eAAe,GAAG,IAAI,GACvC;QACD,IAAI,EAAE,OAAO,CAAC;QACd,QAAQ,EAAE,MAAM,EAAE,CAAC;QACnB,QAAQ,EAAE,MAAM,EAAE,CAAC;KACpB;IAoDD;;OAEG;IACH,OAAO,CAAC,mBAAmB;IAS3B;;;;;;OAMG;IACH,gBAAgB,CAAC,OAAO,EAAE,MAAM,EAAE,UAAU,GAAE,MAAsB,GAAG,MAAM;IAM7E;;;;;OAKG;IACG,YAAY,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAiBlD;;OAEG;IACH,cAAc,CAAC,QAAQ,EAAE,iBAAiB,GAAG,MAAM;IAWnD;;OAEG;IACH,qBAAqB,CAAC,MAAM,EAAE,eAAe,GAAG,MAAM;CAOvD"}