specweave 0.23.8 → 0.23.12

package/dist/src/core/cache/rate-limit-checker.js

@@ -0,0 +1,160 @@
+import { consoleLogger } from '../../utils/logger.js';
+/**
+ * RateLimitChecker - Detects API rate limits and prevents hitting limits
+ *
+ * Features:
+ * - Parses rate limit headers from JIRA, GitHub, ADO
+ * - Handles 429 (Too Many Requests) errors
+ * - Suggests using stale cache when rate limit low
+ * - Supports exponential backoff
+ *
+ * Supported headers:
+ * - X-RateLimit-Remaining (JIRA Cloud, GitHub)
+ * - X-RateLimit-Reset (JIRA Cloud, GitHub)
+ * - Retry-After (Standard HTTP, JIRA Server, ADO)
+ * - x-ms-ratelimit-remaining (Azure DevOps)
+ *
+ * Threshold: 10 requests remaining (configurable)
+ */
+export class RateLimitChecker {
+    constructor(options = {}) {
+        this.logger = options.logger ?? consoleLogger;
+        this.threshold = options.threshold ?? 10; // Default: warn when < 10 requests remaining
+    }
+    /**
+     * Check if safe to proceed with API call based on response headers
+     *
+     * @param headers Response headers from previous API call
+     * @returns RateLimitCheckResult with canProceed flag
+     */
+    shouldProceed(headers) {
+        const remaining = headers.remaining;
+        // No rate limit headers = assume safe to proceed
+        if (remaining === undefined) {
+            return { canProceed: true };
+        }
+        // Low rate limit = use stale cache instead
+        if (remaining < this.threshold) {
+            const reason = `Rate limit low (${remaining} requests remaining, threshold: ${this.threshold})`;
+            this.logger.warn(reason);
+            this.logger.warn('Suggestion: Use stale cache to avoid hitting rate limit');
+            return {
+                canProceed: false,
+                reason,
+                remaining,
+            };
+        }
+        // Safe to proceed
+        return {
+            canProceed: true,
+            remaining,
+        };
+    }
+    /**
+     * Handle 429 (Too Many Requests) error
+     *
+     * @param error Error object with response headers
+     * @returns Promise<void>
+     */
+    async handleRateLimitError(error) {
+        const retryAfter = this.extractRetryAfter(error);
+        const reset = this.extractReset(error);
+        if (retryAfter) {
+            this.logger.error(`Rate limit exceeded. Retry after ${retryAfter} seconds.`);
+            this.logger.warn('Suggestion: Use stale cache while waiting for rate limit reset');
+        }
+        else if (reset) {
+            const waitTime = Math.max(0, reset - Date.now() / 1000);
+            this.logger.error(`Rate limit exceeded. Reset in ${Math.ceil(waitTime)} seconds.`);
+            this.logger.warn('Suggestion: Use stale cache while waiting for rate limit reset');
+        }
+        else {
+            this.logger.error('Rate limit exceeded (no retry time provided)');
+            this.logger.warn('Suggestion: Use stale cache and retry later');
+        }
+    }
+    /**
+     * Extract rate limit headers from HTTP response
+     *
+     * Supports multiple header formats:
+     * - JIRA Cloud: X-RateLimit-Remaining, X-RateLimit-Reset
+     * - GitHub: X-RateLimit-Remaining, X-RateLimit-Reset
+     * - ADO: x-ms-ratelimit-remaining-resource, Retry-After
+     * - Standard: Retry-After
+     *
+     * @param response HTTP response or response-like object
+     * @returns RateLimitHeaders object
+     */
+    extractHeaders(response) {
+        const headers = {};
+        // Handle different response formats (axios, fetch, etc.)
+        const getHeader = (name) => {
+            if (response.headers) {
+                // Axios-style headers object
+                if (typeof response.headers.get === 'function') {
+                    return response.headers.get(name) ?? undefined;
+                }
+                // Plain object headers
+                return response.headers[name] ?? response.headers[name.toLowerCase()] ?? undefined;
+            }
+            return undefined;
+        };
+        // X-RateLimit-Remaining (JIRA Cloud, GitHub)
+        const remaining = getHeader('X-RateLimit-Remaining') || getHeader('x-ms-ratelimit-remaining-resource');
+        if (remaining) {
+            headers.remaining = parseInt(remaining, 10);
+        }
+        // X-RateLimit-Reset (JIRA Cloud, GitHub)
+        const reset = getHeader('X-RateLimit-Reset');
+        if (reset) {
+            headers.reset = parseInt(reset, 10);
+        }
+        // Retry-After (Standard HTTP, JIRA Server, ADO)
+        const retryAfter = getHeader('Retry-After');
+        if (retryAfter) {
+            headers.retryAfter = parseInt(retryAfter, 10);
+        }
+        return headers;
+    }
+    /**
+     * Extract Retry-After from error response
+     *
+     * @param error Error object
+     * @returns Retry-After in seconds, or null
+     */
+    extractRetryAfter(error) {
+        if (error.response?.headers) {
+            const retryAfter = error.response.headers['Retry-After'] || error.response.headers['retry-after'];
+            if (retryAfter) {
+                return parseInt(retryAfter, 10);
+            }
+        }
+        return null;
+    }
+    /**
+     * Extract X-RateLimit-Reset from error response
+     *
+     * @param error Error object
+     * @returns Reset timestamp (Unix seconds), or null
+     */
+    extractReset(error) {
+        if (error.response?.headers) {
+            const reset = error.response.headers['X-RateLimit-Reset'] ||
+                error.response.headers['x-ratelimit-reset'];
+            if (reset) {
+                return parseInt(reset, 10);
+            }
+        }
+        return null;
+    }
+    /**
+     * Check if error is a rate limit error (429 status)
+     *
+     * @param error Error object
+     * @returns True if 429 error
+     */
+    isRateLimitError(error) {
+        return error.response?.status === 429 || error.status === 429;
+    }
+}
+//# sourceMappingURL=rate-limit-checker.js.map

package/dist/src/core/cache/rate-limit-checker.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"rate-limit-checker.js","sourceRoot":"","sources":["../../../../src/core/cache/rate-limit-checker.ts"],"names":[],"mappings":"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"}

package/dist/src/core/config/config-manager.d.ts

@@ -0,0 +1,135 @@
+/**
+ * SpecWeave Configuration Manager
+ *
+ * Manages .specweave/config.json for non-sensitive configuration
+ * (Secrets like API tokens go in .env, NOT in config.json)
+ *
+ * @module core/config/config-manager
+ */
+import { SpecWeaveConfig, ValidationResult } from './types.js';
+/**
+ * Manages SpecWeave configuration
+ */
+export declare class ConfigManager {
+    private configPath;
+    private config;
+    /**
+     * Create a new ConfigManager
+     *
+     * @param projectRoot - Path to project root (default: process.cwd())
+     */
+    constructor(projectRoot?: string);
+    /**
+     * Read configuration from disk
+     *
+     * @returns Configuration object
+     */
+    read(): Promise<SpecWeaveConfig>;
+    /**
+     * Read configuration synchronously
+     *
+     * @returns Configuration object
+     */
+    readSync(): SpecWeaveConfig;
+    /**
+     * Write configuration to disk
+     *
+     * @param config - Configuration to write
+     */
+    write(config: SpecWeaveConfig): Promise<void>;
+    /**
+     * Update configuration with partial values
+     *
+     * @param partial - Partial configuration to merge
+     */
+    update(partial: Partial<SpecWeaveConfig>): Promise<void>;
+    /**
+     * Get a specific configuration value by path
+     *
+     * @param path - Dot-separated path (e.g., "issueTracker.domain")
+     * @returns Configuration value
+     */
+    get(path: string): Promise<any>;
+    /**
+     * Set a specific configuration value by path
+     *
+     * @param path - Dot-separated path (e.g., "issueTracker.domain")
+     * @param value - Value to set
+     */
+    set(path: string, value: any): Promise<void>;
+    /**
+     * Check if configuration file exists
+     *
+     * @returns True if config exists
+     */
+    exists(): Promise<boolean>;
+    /**
+     * Validate configuration
+     *
+     * @param config - Configuration to validate (default: current config)
+     * @returns Validation result
+     */
+    validate(config?: SpecWeaveConfig): ValidationResult;
+    /**
+     * Merge configuration with defaults
+     *
+     * @param config - User configuration
+     * @returns Merged configuration
+     */
+    private mergeWithDefaults;
+    /**
+     * Deep merge two objects
+     *
+     * @param target - Target object
+     * @param source - Source object
+     * @returns Merged object
+     */
+    private deepMerge;
+    /**
+     * Get value by dot-separated path
+     *
+     * @param obj - Object to get value from
+     * @param path - Dot-separated path
+     * @returns Value at path
+     */
+    private getByPath;
+    /**
+     * Set value by dot-separated path
+     *
+     * @param obj - Object to set value in
+     * @param path - Dot-separated path
+     * @param value - Value to set
+     * @returns Updated object
+     */
+    private setByPath;
+    /**
+     * Clear cached configuration
+     */
+    clearCache(): void;
+}
+/**
+ * Get global config manager instance
+ *
+ * @param projectRoot - Path to project root (default: process.cwd())
+ * @returns ConfigManager instance
+ */
+export declare function getConfigManager(projectRoot?: string): ConfigManager;
+/**
+ * Read configuration
+ *
+ * Convenience function for reading config
+ *
+ * @param projectRoot - Path to project root (default: process.cwd())
+ * @returns Configuration object
+ */
+export declare function readConfig(projectRoot?: string): Promise<SpecWeaveConfig>;
+/**
+ * Write configuration
+ *
+ * Convenience function for writing config
+ *
+ * @param config - Configuration to write
+ * @param projectRoot - Path to project root (default: process.cwd())
+ */
+export declare function writeConfig(config: SpecWeaveConfig, projectRoot?: string): Promise<void>;
+//# sourceMappingURL=config-manager.d.ts.map

package/dist/src/core/config/config-manager.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"config-manager.d.ts","sourceRoot":"","sources":["../../../../src/core/config/config-manager.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAIH,OAAO,EACL,eAAe,EAEf,gBAAgB,EAEjB,MAAM,YAAY,CAAC;AAOpB;;GAEG;AACH,qBAAa,aAAa;IACxB,OAAO,CAAC,UAAU,CAAS;IAC3B,OAAO,CAAC,MAAM,CAAgC;IAE9C;;;;OAIG;gBACS,WAAW,GAAE,MAAsB;IAI/C;;;;OAIG;IACG,IAAI,IAAI,OAAO,CAAC,eAAe,CAAC;IAsBtC;;;;OAIG;IACH,QAAQ,IAAI,eAAe;IAuB3B;;;;OAIG;IACG,KAAK,CAAC,MAAM,EAAE,eAAe,GAAG,OAAO,CAAC,IAAI,CAAC;IAwBnD;;;;OAIG;IACG,MAAM,CAAC,OAAO,EAAE,OAAO,CAAC,eAAe,CAAC,GAAG,OAAO,CAAC,IAAI,CAAC;IAM9D;;;;;OAKG;IACG,GAAG,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,GAAG,CAAC;IAKrC;;;;;OAKG;IACG,GAAG,CAAC,IAAI,EAAE,MAAM,EAAE,KAAK,EAAE,GAAG,GAAG,OAAO,CAAC,IAAI,CAAC;IAMlD;;;;OAIG;IACG,MAAM,IAAI,OAAO,CAAC,OAAO,CAAC;IAShC;;;;;OAKG;IACH,QAAQ,CAAC,MAAM,CAAC,EAAE,eAAe,GAAG,gBAAgB;IA6EpD;;;;;OAKG;IACH,OAAO,CAAC,iBAAiB;IAIzB;;;;;;OAMG;IACH,OAAO,CAAC,SAAS;IAgBjB;;;;;;OAMG;IACH,OAAO,CAAC,SAAS;IAcjB;;;;;;;OAOG;IACH,OAAO,CAAC,SAAS;IAejB;;OAEG;IACH,UAAU,IAAI,IAAI;CAGnB;AAOD;;;;;GAKG;AACH,wBAAgB,gBAAgB,CAAC,WAAW,CAAC,EAAE,MAAM,GAAG,aAAa,CAKpE;AAED;;;;;;;GAOG;AACH,wBAAsB,UAAU,CAAC,WAAW,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,eAAe,CAAC,CAG/E;AAED;;;;;;;GAOG;AACH,wBAAsB,WAAW,CAAC,MAAM,EAAE,eAAe,EAAE,WAAW,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAG9F"}

package/dist/src/core/config/config-manager.js

@@ -0,0 +1,341 @@
+/**
+ * SpecWeave Configuration Manager
+ *
+ * Manages .specweave/config.json for non-sensitive configuration
+ * (Secrets like API tokens go in .env, NOT in config.json)
+ *
+ * @module core/config/config-manager
+ */
+import { promises as fs } from 'fs';
+import path from 'path';
+import { DEFAULT_CONFIG } from './types.js';
+/**
+ * Configuration file path
+ */
+const CONFIG_FILE_NAME = 'config.json';
+/**
+ * Manages SpecWeave configuration
+ */
+export class ConfigManager {
+    /**
+     * Create a new ConfigManager
+     *
+     * @param projectRoot - Path to project root (default: process.cwd())
+     */
+    constructor(projectRoot = process.cwd()) {
+        this.config = null;
+        this.configPath = path.join(projectRoot, '.specweave', CONFIG_FILE_NAME);
+    }
+    /**
+     * Read configuration from disk
+     *
+     * @returns Configuration object
+     */
+    async read() {
+        if (this.config) {
+            return this.config;
+        }
+        try {
+            const content = await fs.readFile(this.configPath, 'utf-8');
+            const parsed = JSON.parse(content);
+            // Merge with defaults (for backward compatibility)
+            this.config = this.mergeWithDefaults(parsed);
+            return this.config;
+        }
+        catch (error) {
+            if (error.code === 'ENOENT') {
+                // Config file doesn't exist, return defaults
+                this.config = { ...DEFAULT_CONFIG };
+                return this.config;
+            }
+            throw new Error(`Failed to read config: ${error.message}`);
+        }
+    }
+    /**
+     * Read configuration synchronously
+     *
+     * @returns Configuration object
+     */
+    readSync() {
+        if (this.config) {
+            return this.config;
+        }
+        try {
+            const { readFileSync } = require('fs');
+            const content = readFileSync(this.configPath, 'utf-8');
+            const parsed = JSON.parse(content);
+            // Merge with defaults
+            this.config = this.mergeWithDefaults(parsed);
+            return this.config;
+        }
+        catch (error) {
+            if (error.code === 'ENOENT') {
+                // Config file doesn't exist, return defaults
+                this.config = { ...DEFAULT_CONFIG };
+                return this.config;
+            }
+            throw new Error(`Failed to read config: ${error.message}`);
+        }
+    }
+    /**
+     * Write configuration to disk
+     *
+     * @param config - Configuration to write
+     */
+    async write(config) {
+        // Validate before writing
+        const validation = this.validate(config);
+        if (!validation.valid) {
+            const errorMessages = validation.errors.map(e => `${e.path}: ${e.message}`).join('\n');
+            throw new Error(`Invalid configuration:\n${errorMessages}`);
+        }
+        try {
+            // Ensure .specweave directory exists
+            const dir = path.dirname(this.configPath);
+            await fs.mkdir(dir, { recursive: true });
+            // Write with pretty formatting
+            const content = JSON.stringify(config, null, 2);
+            await fs.writeFile(this.configPath, content, 'utf-8');
+            // Update cached config
+            this.config = config;
+        }
+        catch (error) {
+            throw new Error(`Failed to write config: ${error.message}`);
+        }
+    }
+    /**
+     * Update configuration with partial values
+     *
+     * @param partial - Partial configuration to merge
+     */
+    async update(partial) {
+        const current = await this.read();
+        const updated = this.deepMerge(current, partial);
+        await this.write(updated);
+    }
+    /**
+     * Get a specific configuration value by path
+     *
+     * @param path - Dot-separated path (e.g., "issueTracker.domain")
+     * @returns Configuration value
+     */
+    async get(path) {
+        const config = await this.read();
+        return this.getByPath(config, path);
+    }
+    /**
+     * Set a specific configuration value by path
+     *
+     * @param path - Dot-separated path (e.g., "issueTracker.domain")
+     * @param value - Value to set
+     */
+    async set(path, value) {
+        const config = await this.read();
+        const updated = this.setByPath(config, path, value);
+        await this.write(updated);
+    }
+    /**
+     * Check if configuration file exists
+     *
+     * @returns True if config exists
+     */
+    async exists() {
+        try {
+            await fs.access(this.configPath);
+            return true;
+        }
+        catch {
+            return false;
+        }
+    }
+    /**
+     * Validate configuration
+     *
+     * @param config - Configuration to validate (default: current config)
+     * @returns Validation result
+     */
+    validate(config) {
+        const errors = [];
+        const cfg = config || this.config || DEFAULT_CONFIG;
+        // Validate version
+        if (!cfg.version) {
+            errors.push({
+                path: 'version',
+                message: 'Version is required',
+                value: cfg.version
+            });
+        }
+        // Validate repository provider
+        if (cfg.repository?.provider) {
+            const validProviders = ['local', 'github', 'bitbucket', 'ado', 'gitlab', 'generic'];
+            if (!validProviders.includes(cfg.repository.provider)) {
+                errors.push({
+                    path: 'repository.provider',
+                    message: `Invalid provider. Must be one of: ${validProviders.join(', ')}`,
+                    value: cfg.repository.provider
+                });
+            }
+        }
+        // Validate issue tracker provider
+        if (cfg.issueTracker?.provider) {
+            const validTrackers = ['none', 'jira', 'github', 'ado'];
+            if (!validTrackers.includes(cfg.issueTracker.provider)) {
+                errors.push({
+                    path: 'issueTracker.provider',
+                    message: `Invalid tracker. Must be one of: ${validTrackers.join(', ')}`,
+                    value: cfg.issueTracker.provider
+                });
+            }
+        }
+        // Validate Jira configuration
+        if (cfg.issueTracker?.provider === 'jira') {
+            if (!cfg.issueTracker.domain) {
+                errors.push({
+                    path: 'issueTracker.domain',
+                    message: 'Domain is required for Jira',
+                    value: cfg.issueTracker.domain
+                });
+            }
+            if (cfg.issueTracker.strategy) {
+                const validStrategies = ['single-project', 'project-per-team', 'component-based', 'board-based'];
+                if (!validStrategies.includes(cfg.issueTracker.strategy)) {
+                    errors.push({
+                        path: 'issueTracker.strategy',
+                        message: `Invalid strategy. Must be one of: ${validStrategies.join(', ')}`,
+                        value: cfg.issueTracker.strategy
+                    });
+                }
+            }
+        }
+        // Validate sync direction
+        if (cfg.sync?.direction) {
+            const validDirections = ['import', 'export', 'bidirectional'];
+            if (!validDirections.includes(cfg.sync.direction)) {
+                errors.push({
+                    path: 'sync.direction',
+                    message: `Invalid direction. Must be one of: ${validDirections.join(', ')}`,
+                    value: cfg.sync.direction
+                });
+            }
+        }
+        return {
+            valid: errors.length === 0,
+            errors
+        };
+    }
+    /**
+     * Merge configuration with defaults
+     *
+     * @param config - User configuration
+     * @returns Merged configuration
+     */
+    mergeWithDefaults(config) {
+        return this.deepMerge(DEFAULT_CONFIG, config);
+    }
+    /**
+     * Deep merge two objects
+     *
+     * @param target - Target object
+     * @param source - Source object
+     * @returns Merged object
+     */
+    deepMerge(target, source) {
+        const result = { ...target };
+        for (const key in source) {
+            if (source[key] !== undefined && source[key] !== null) {
+                if (typeof source[key] === 'object' && !Array.isArray(source[key])) {
+                    result[key] = this.deepMerge(result[key] || {}, source[key]);
+                }
+                else {
+                    result[key] = source[key];
+                }
+            }
+        }
+        return result;
+    }
+    /**
+     * Get value by dot-separated path
+     *
+     * @param obj - Object to get value from
+     * @param path - Dot-separated path
+     * @returns Value at path
+     */
+    getByPath(obj, path) {
+        const parts = path.split('.');
+        let current = obj;
+        for (const part of parts) {
+            if (current === null || current === undefined) {
+                return undefined;
+            }
+            current = current[part];
+        }
+        return current;
+    }
+    /**
+     * Set value by dot-separated path
+     *
+     * @param obj - Object to set value in
+     * @param path - Dot-separated path
+     * @param value - Value to set
+     * @returns Updated object
+     */
+    setByPath(obj, path, value) {
+        const parts = path.split('.');
+        const result = { ...obj };
+        let current = result;
+        for (let i = 0; i < parts.length - 1; i++) {
+            const part = parts[i];
+            current[part] = { ...(current[part] || {}) };
+            current = current[part];
+        }
+        current[parts[parts.length - 1]] = value;
+        return result;
+    }
+    /**
+     * Clear cached configuration
+     */
+    clearCache() {
+        this.config = null;
+    }
+}
+/**
+ * Global config manager instance
+ */
+let globalConfigManager = null;
+/**
+ * Get global config manager instance
+ *
+ * @param projectRoot - Path to project root (default: process.cwd())
+ * @returns ConfigManager instance
+ */
+export function getConfigManager(projectRoot) {
+    if (!globalConfigManager || projectRoot) {
+        globalConfigManager = new ConfigManager(projectRoot);
+    }
+    return globalConfigManager;
+}
+/**
+ * Read configuration
+ *
+ * Convenience function for reading config
+ *
+ * @param projectRoot - Path to project root (default: process.cwd())
+ * @returns Configuration object
+ */
+export async function readConfig(projectRoot) {
+    const manager = getConfigManager(projectRoot);
+    return manager.read();
+}
+/**
+ * Write configuration
+ *
+ * Convenience function for writing config
+ *
+ * @param config - Configuration to write
+ * @param projectRoot - Path to project root (default: process.cwd())
+ */
+export async function writeConfig(config, projectRoot) {
+    const manager = getConfigManager(projectRoot);
+    await manager.write(config);
+}
+//# sourceMappingURL=config-manager.js.map

package/dist/src/core/config/config-manager.js.map

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