specweave 0.23.8 → 0.23.12

package/dist/src/cli/commands/migrate-config.js

@@ -0,0 +1,149 @@
+/**
+ * Migrate Config Command
+ *
+ * Migrates old .env-only configuration to split secrets/config format
+ *
+ * @module cli/commands/migrate-config
+ */
+import chalk from 'chalk';
+import inquirer from 'inquirer';
+import ora from 'ora';
+import { ConfigMigrator } from '../../core/config/config-migrator.js';
+/**
+ * Migrate configuration from .env-only to split format
+ *
+ * @param options - Command options
+ */
+export async function migrateConfig(options = {}) {
+    const { dryRun = false, force = false, yes = false } = options;
+    console.log(chalk.bold.cyan('\n🔄 SpecWeave Configuration Migration\n'));
+    console.log(chalk.gray('Migrating from .env-only to split secrets/config format\n'));
+    const migrator = new ConfigMigrator(process.cwd());
+    // Check if migration is needed
+    if (!force) {
+        const spinner = ora('Checking if migration is needed...').start();
+        const needed = await migrator.needsMigration();
+        if (!needed) {
+            spinner.succeed('Migration not needed');
+            console.log(chalk.green('\n✅ Your project already uses the split format!'));
+            console.log(chalk.gray('   Secrets are in .env, config is in .specweave/config.json\n'));
+            return;
+        }
+        spinner.succeed('Migration needed - old format detected');
+    }
+    // Preview migration
+    console.log(chalk.bold('\n📋 Migration Preview\n'));
+    const spinner = ora('Analyzing .env file...').start();
+    let preview;
+    try {
+        preview = await migrator.preview();
+        spinner.succeed('Analysis complete');
+    }
+    catch (error) {
+        spinner.fail('Analysis failed');
+        console.error(chalk.red(`\n❌ Error: ${error.message}\n`));
+        return;
+    }
+    // Display classification results
+    console.log(chalk.bold('\nClassification Results:'));
+    console.log(chalk.green(`  Secrets: ${preview.secretsCount} variables`));
+    console.log(chalk.blue(`  Config:  ${preview.configCount} variables`));
+    if (preview.warnings.length > 0) {
+        console.log(chalk.yellow('\n⚠️  Warnings:'));
+        preview.warnings.forEach(w => console.log(chalk.yellow(`  - ${w}`)));
+    }
+    // Show detailed breakdown
+    console.log(chalk.bold('\n📊 Detailed Breakdown:\n'));
+    const secretVars = preview.classified.filter(c => c.type === 'secret');
+    const configVars = preview.classified.filter(c => c.type === 'config');
+    if (secretVars.length > 0) {
+        console.log(chalk.green.bold('  Secrets (will stay in .env):'));
+        secretVars.forEach(v => {
+            const maskedValue = maskSecret(v.value);
+            console.log(chalk.gray(`    ${v.key}=${maskedValue}`));
+            console.log(chalk.gray(`    └─ ${v.reason}\n`));
+        });
+    }
+    if (configVars.length > 0) {
+        console.log(chalk.blue.bold('  Configuration (will move to config.json):'));
+        configVars.forEach(v => {
+            console.log(chalk.gray(`    ${v.key}=${v.value}`));
+            console.log(chalk.gray(`    └─ ${v.reason}\n`));
+        });
+    }
+    // Dry run mode - stop here
+    if (dryRun) {
+        console.log(chalk.yellow('\n🔍 Dry run mode - no changes made\n'));
+        console.log(chalk.gray('Run without --dry-run to perform migration\n'));
+        return;
+    }
+    // Confirm migration
+    if (!yes) {
+        console.log(chalk.bold('\n❓ Migration Actions:\n'));
+        console.log(chalk.gray('  1. Backup .env → .env.backup.TIMESTAMP'));
+        console.log(chalk.gray('  2. Update .env (keep only secrets)'));
+        console.log(chalk.gray('  3. Create/update .specweave/config.json (add config)'));
+        console.log(chalk.gray('  4. Generate .env.example (team template)\n'));
+        const { confirm } = await inquirer.prompt([
+            {
+                type: 'confirm',
+                name: 'confirm',
+                message: 'Proceed with migration?',
+                default: false
+            }
+        ]);
+        if (!confirm) {
+            console.log(chalk.yellow('\n⚠️  Migration cancelled\n'));
+            return;
+        }
+    }
+    // Perform migration
+    console.log(chalk.bold('\n🚀 Performing Migration...\n'));
+    const migrationSpinner = ora('Migrating configuration...').start();
+    let result;
+    try {
+        result = await migrator.migrate({ backup: true, force });
+        migrationSpinner.succeed('Migration complete');
+    }
+    catch (error) {
+        migrationSpinner.fail('Migration failed');
+        console.error(chalk.red(`\n❌ Error: ${error.message}\n`));
+        return;
+    }
+    // Display results
+    console.log(chalk.bold.green('\n✅ Migration Successful!\n'));
+    console.log(chalk.bold('Summary:'));
+    console.log(chalk.green(`  ✓ ${result.secretsCount} secrets kept in .env`));
+    console.log(chalk.blue(`  ✓ ${result.configCount} config items moved to config.json`));
+    if (result.backupPath) {
+        console.log(chalk.gray(`  ✓ Backup created: ${result.backupPath}`));
+    }
+    console.log(chalk.gray(`  ✓ .env.example generated\n`));
+    // Show next steps
+    console.log(chalk.bold('📝 Next Steps:\n'));
+    console.log(chalk.cyan('  1. Review .specweave/config.json (commit to git)'));
+    console.log(chalk.cyan('  2. Share .env.example with team (commit to git)'));
+    console.log(chalk.cyan('  3. Team members: cp .env.example .env (fill in tokens)'));
+    console.log(chalk.cyan('  4. Verify: specweave init . (should detect existing config)\n'));
+    console.log(chalk.bold('🎯 Benefits:\n'));
+    console.log(chalk.green('  ✓ Team shares configuration via git'));
+    console.log(chalk.green('  ✓ Secrets stay local (never committed)'));
+    console.log(chalk.green('  ✓ Type-safe configuration with validation'));
+    console.log(chalk.green('  ✓ Easy onboarding for new team members\n'));
+}
+/**
+ * Mask secret value for display
+ *
+ * @param value - Secret value
+ * @returns Masked value
+ */
+function maskSecret(value) {
+    if (value.length <= 8) {
+        return '***';
+    }
+    const visible = 4;
+    const start = value.substring(0, visible);
+    const end = value.substring(value.length - visible);
+    return `${start}${'*'.repeat(value.length - visible * 2)}${end}`;
+}
+//# sourceMappingURL=migrate-config.js.map

package/dist/src/cli/commands/migrate-config.js.map

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

package/dist/src/cli/helpers/async-project-loader.d.ts

@@ -0,0 +1,148 @@
+/**
+ * Async Project Loader
+ *
+ * Advanced batch fetching with:
+ * - Smart pagination (50-project batches)
+ * - Real-time progress tracking
+ * - Graceful cancelation (Ctrl+C)
+ * - Retry logic with exponential backoff
+ * - Rate limit handling
+ * - Graceful degradation (reduce batch size on timeout)
+ * - Continue-on-failure error handling
+ * - Comprehensive error logging
+ *
+ * @module cli/helpers/async-project-loader
+ */
+import { Logger } from '../../utils/logger.js';
+import type { JiraCredentials, AdoCredentials } from './project-count-fetcher.js';
+/**
+ * Project provider type
+ */
+export type ProjectProvider = 'jira' | 'ado';
+/**
+ * Project metadata
+ */
+export interface Project {
+    id: string;
+    key: string;
+    name: string;
+    projectTypeKey?: string;
+    simplified?: boolean;
+}
+/**
+ * Fetch options
+ */
+export interface FetchOptions {
+    batchSize?: number;
+    updateFrequency?: number;
+    showEta?: boolean;
+    stateFile?: string;
+    errorLogFile?: string;
+    logger?: Logger;
+}
+/**
+ * Fetch result
+ */
+export interface FetchResult {
+    projects: Project[];
+    succeeded: number;
+    failed: number;
+    skipped: number;
+    errors: FetchError[];
+    canceled?: boolean;
+}
+/**
+ * Fetch error with context
+ */
+export interface FetchError {
+    projectKey: string;
+    error: string;
+    timestamp: string;
+    suggestion: string;
+    retryAttempts?: number;
+}
+/**
+ * Async Project Loader
+ *
+ * Handles batch fetching from issue trackers with advanced features:
+ * - Smart pagination (50-project batches for optimal performance)
+ * - Real-time progress tracking with ETA
+ * - Graceful cancelation with state persistence
+ * - Retry logic with exponential backoff (1s, 2s, 4s)
+ * - Rate limit detection and throttling
+ * - Graceful degradation (reduce batch size on timeout)
+ * - Continue-on-failure (single error doesn't block batch)
+ * - Comprehensive error logging
+ *
+ * @example
+ * ```typescript
+ * const loader = new AsyncProjectLoader(credentials, 'jira', {
+ *   batchSize: 50,
+ *   showEta: true
+ * });
+ *
+ * const result = await loader.fetchAllProjects(127);
+ * console.log(`Imported ${result.succeeded}/${result.projects.length} projects`);
+ * ```
+ */
+export declare class AsyncProjectLoader {
+    private credentials;
+    private provider;
+    private options;
+    private progressTracker?;
+    private cancelHandler?;
+    private currentBatchSize;
+    constructor(credentials: JiraCredentials | AdoCredentials, provider: ProjectProvider, options?: FetchOptions);
+    /**
+     * Fetch all projects with smart pagination
+     *
+     * @param totalCount - Total number of projects to fetch
+     * @returns Fetch result with projects and statistics
+     */
+    fetchAllProjects(totalCount: number): Promise<FetchResult>;
+    /**
+     * Fetch single batch with pagination
+     *
+     * @param offset - Starting offset
+     * @param limit - Number of projects to fetch
+     * @returns Array of projects
+     */
+    fetchBatch(offset: number, limit: number): Promise<Project[]>;
+    /**
+     * Fetch JIRA batch with pagination
+     */
+    private fetchJiraBatch;
+    /**
+     * Fetch Azure DevOps batch with pagination
+     */
+    private fetchAdoBatch;
+    /**
+     * Fetch batch with retry logic and exponential backoff
+     */
+    private fetchBatchWithRetry;
+    /**
+     * Check rate limit headers and throttle if needed
+     */
+    private checkRateLimit;
+    /**
+     * Save partial state on cancelation
+     */
+    private savePartialState;
+    /**
+     * Log error to file
+     */
+    private logError;
+    /**
+     * Get suggestion for error
+     */
+    private getSuggestion;
+    /**
+     * Check if error is auth-related (4XX)
+     */
+    private isAuthError;
+    /**
+     * Check if error is timeout-related
+     */
+    private isTimeoutError;
+}
+//# sourceMappingURL=async-project-loader.d.ts.map

package/dist/src/cli/helpers/async-project-loader.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"async-project-loader.d.ts","sourceRoot":"","sources":["../../../../src/cli/helpers/async-project-loader.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;GAcG;AAKH,OAAO,EAAE,MAAM,EAAiB,MAAM,uBAAuB,CAAC;AAG9D,OAAO,KAAK,EAAE,eAAe,EAAE,cAAc,EAAoB,MAAM,4BAA4B,CAAC;AAEpG;;GAEG;AACH,MAAM,MAAM,eAAe,GAAG,MAAM,GAAG,KAAK,CAAC;AAE7C;;GAEG;AACH,MAAM,WAAW,OAAO;IACtB,EAAE,EAAE,MAAM,CAAC;IACX,GAAG,EAAE,MAAM,CAAC;IACZ,IAAI,EAAE,MAAM,CAAC;IACb,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB,UAAU,CAAC,EAAE,OAAO,CAAC;CACtB;AAED;;GAEG;AACH,MAAM,WAAW,YAAY;IAC3B,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,eAAe,CAAC,EAAE,MAAM,CAAC;IACzB,OAAO,CAAC,EAAE,OAAO,CAAC;IAClB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,MAAM,CAAC,EAAE,MAAM,CAAC;CACjB;AAED;;GAEG;AACH,MAAM,WAAW,WAAW;IAC1B,QAAQ,EAAE,OAAO,EAAE,CAAC;IACpB,SAAS,EAAE,MAAM,CAAC;IAClB,MAAM,EAAE,MAAM,CAAC;IACf,OAAO,EAAE,MAAM,CAAC;IAChB,MAAM,EAAE,UAAU,EAAE,CAAC;IACrB,QAAQ,CAAC,EAAE,OAAO,CAAC;CACpB;AAED;;GAEG;AACH,MAAM,WAAW,UAAU;IACzB,UAAU,EAAE,MAAM,CAAC;IACnB,KAAK,EAAE,MAAM,CAAC;IACd,SAAS,EAAE,MAAM,CAAC;IAClB,UAAU,EAAE,MAAM,CAAC;IACnB,aAAa,CAAC,EAAE,MAAM,CAAC;CACxB;AAED;;;;;;;;;;;;;;;;;;;;;;;GAuBG;AACH,qBAAa,kBAAkB;IAC7B,OAAO,CAAC,WAAW,CAAmC;IACtD,OAAO,CAAC,QAAQ,CAAkB;IAClC,OAAO,CAAC,OAAO,CAAyB;IAExC,OAAO,CAAC,eAAe,CAAC,CAAkB;IAC1C,OAAO,CAAC,aAAa,CAAC,CAAqB;IAE3C,OAAO,CAAC,gBAAgB,CAAS;gBAG/B,WAAW,EAAE,eAAe,GAAG,cAAc,EAC7C,QAAQ,EAAE,eAAe,EACzB,OAAO,GAAE,YAAiB;IAkB5B;;;;;OAKG;IACG,gBAAgB,CAAC,UAAU,EAAE,MAAM,GAAG,OAAO,CAAC,WAAW,CAAC;IAwGhE;;;;;;OAMG;IACG,UAAU,CAAC,MAAM,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,EAAE,CAAC;IAUnE;;OAEG;YACW,cAAc;IAwC5B;;OAEG;YACW,aAAa;IA8B3B;;OAEG;YACW,mBAAmB;IA4BjC;;OAEG;YACW,cAAc;IAiB5B;;OAEG;YACW,gBAAgB;IAgC9B;;OAEG;YACW,QAAQ;IAgBtB;;OAEG;IACH,OAAO,CAAC,aAAa;IA0BrB;;OAEG;IACH,OAAO,CAAC,WAAW;IAKnB;;OAEG;IACH,OAAO,CAAC,cAAc;CAKvB"}

package/dist/src/cli/helpers/async-project-loader.js

@@ -0,0 +1,351 @@
+/**
+ * Async Project Loader
+ *
+ * Advanced batch fetching with:
+ * - Smart pagination (50-project batches)
+ * - Real-time progress tracking
+ * - Graceful cancelation (Ctrl+C)
+ * - Retry logic with exponential backoff
+ * - Rate limit handling
+ * - Graceful degradation (reduce batch size on timeout)
+ * - Continue-on-failure error handling
+ * - Comprehensive error logging
+ *
+ * @module cli/helpers/async-project-loader
+ */
+import { promises as fs } from 'fs';
+import path from 'path';
+import chalk from 'chalk';
+import { consoleLogger } from '../../utils/logger.js';
+import { ProgressTracker } from './progress-tracker.js';
+import { CancelationHandler } from './cancelation-handler.js';
+/**
+ * Async Project Loader
+ *
+ * Handles batch fetching from issue trackers with advanced features:
+ * - Smart pagination (50-project batches for optimal performance)
+ * - Real-time progress tracking with ETA
+ * - Graceful cancelation with state persistence
+ * - Retry logic with exponential backoff (1s, 2s, 4s)
+ * - Rate limit detection and throttling
+ * - Graceful degradation (reduce batch size on timeout)
+ * - Continue-on-failure (single error doesn't block batch)
+ * - Comprehensive error logging
+ *
+ * @example
+ * ```typescript
+ * const loader = new AsyncProjectLoader(credentials, 'jira', {
+ *   batchSize: 50,
+ *   showEta: true
+ * });
+ *
+ * const result = await loader.fetchAllProjects(127);
+ * console.log(`Imported ${result.succeeded}/${result.projects.length} projects`);
+ * ```
+ */
+export class AsyncProjectLoader {
+    constructor(credentials, provider, options = {}) {
+        this.credentials = credentials;
+        this.provider = provider;
+        // Set defaults
+        this.options = {
+            batchSize: options.batchSize ?? 50,
+            updateFrequency: options.updateFrequency ?? 5,
+            showEta: options.showEta ?? true,
+            stateFile: options.stateFile ?? '.specweave/cache/import-state.json',
+            errorLogFile: options.errorLogFile ?? '.specweave/logs/import-errors.log',
+            logger: options.logger ?? consoleLogger
+        };
+        this.currentBatchSize = this.options.batchSize;
+    }
+    /**
+     * Fetch all projects with smart pagination
+     *
+     * @param totalCount - Total number of projects to fetch
+     * @returns Fetch result with projects and statistics
+     */
+    async fetchAllProjects(totalCount) {
+        const projects = [];
+        const errors = [];
+        // Initialize progress tracker
+        this.progressTracker = new ProgressTracker({
+            total: totalCount,
+            updateFrequency: this.options.updateFrequency,
+            showEta: this.options.showEta,
+            logger: this.options.logger
+        });
+        // Initialize cancelation handler
+        this.cancelHandler = new CancelationHandler({
+            stateFile: this.options.stateFile,
+            logger: this.options.logger
+        });
+        // Register cleanup callback (save state on Ctrl+C)
+        this.cancelHandler.onCleanup(async () => {
+            await this.savePartialState(projects, totalCount, errors);
+        });
+        // Main fetch loop
+        let offset = 0;
+        while (offset < totalCount) {
+            // Check for cancelation
+            if (this.cancelHandler.shouldCancel()) {
+                this.progressTracker.cancel();
+                this.cancelHandler.suggestResume('/specweave-jira:import-projects --resume');
+                return {
+                    projects,
+                    succeeded: this.progressTracker.getSummary().succeeded,
+                    failed: this.progressTracker.getSummary().failed,
+                    skipped: this.progressTracker.getSummary().skipped,
+                    errors,
+                    canceled: true
+                };
+            }
+            // Calculate batch size (last batch may be smaller)
+            const limit = Math.min(this.currentBatchSize, totalCount - offset);
+            try {
+                // Fetch batch with retry logic
+                const batch = await this.fetchBatchWithRetry(offset, limit);
+                projects.push(...batch);
+                // Update progress for each item in batch
+                batch.forEach(project => {
+                    this.progressTracker.update(project.key, 'success');
+                });
+            }
+            catch (error) {
+                // Continue-on-failure: Log error, skip batch, continue
+                const batchKey = `BATCH_${offset}-${offset + limit}`;
+                const fetchError = {
+                    projectKey: batchKey,
+                    error: error.message,
+                    timestamp: new Date().toISOString(),
+                    suggestion: this.getSuggestion(error),
+                    retryAttempts: 3
+                };
+                errors.push(fetchError);
+                await this.logError(fetchError);
+                // Update progress (mark all as failed)
+                for (let i = 0; i < limit; i++) {
+                    this.progressTracker.update(`${batchKey}_${i}`, 'failure');
+                }
+                // Check if we should reduce batch size (graceful degradation)
+                if (this.isTimeoutError(error) && this.currentBatchSize > 10) {
+                    const oldSize = this.currentBatchSize;
+                    this.currentBatchSize = Math.max(10, Math.floor(this.currentBatchSize / 2));
+                    this.options.logger.log(chalk.yellow(`⚠️  Timeout detected. Reducing batch size: ${oldSize} → ${this.currentBatchSize}`));
+                }
+            }
+            offset += limit;
+        }
+        // Finish progress tracking
+        this.progressTracker.finish();
+        // Clear cancelation state (successful completion)
+        await this.cancelHandler.clearState();
+        // Cleanup
+        this.cancelHandler.dispose();
+        return {
+            projects,
+            succeeded: this.progressTracker.getSummary().succeeded,
+            failed: this.progressTracker.getSummary().failed,
+            skipped: this.progressTracker.getSummary().skipped,
+            errors
+        };
+    }
+    /**
+     * Fetch single batch with pagination
+     *
+     * @param offset - Starting offset
+     * @param limit - Number of projects to fetch
+     * @returns Array of projects
+     */
+    async fetchBatch(offset, limit) {
+        if (this.provider === 'jira') {
+            return this.fetchJiraBatch(offset, limit);
+        }
+        else if (this.provider === 'ado') {
+            return this.fetchAdoBatch(offset, limit);
+        }
+        else {
+            throw new Error(`Unsupported provider: ${this.provider}`);
+        }
+    }
+    /**
+     * Fetch JIRA batch with pagination
+     */
+    async fetchJiraBatch(offset, limit) {
+        const creds = this.credentials;
+        const { domain, email, token, instanceType } = creds;
+        const apiVersion = instanceType === 'cloud' ? '3' : '2';
+        const endpoint = instanceType === 'cloud'
+            ? `/rest/api/${apiVersion}/project/search?startAt=${offset}&maxResults=${limit}`
+            : `/rest/api/${apiVersion}/project?startAt=${offset}&maxResults=${limit}`;
+        const url = `https://${domain}${endpoint}`;
+        const response = await fetch(url, {
+            method: 'GET',
+            headers: {
+                Authorization: `Basic ${Buffer.from(`${email}:${token}`).toString('base64')}`,
+                Accept: 'application/json',
+                'Content-Type': 'application/json'
+            },
+            signal: AbortSignal.timeout(30000) // 30 second timeout
+        });
+        // Check rate limit
+        await this.checkRateLimit(response.headers);
+        if (!response.ok) {
+            const errorBody = await response.text().catch(() => 'No error body');
+            throw new Error(`JIRA API error: ${response.status} ${response.statusText}. ${errorBody}`);
+        }
+        if (instanceType === 'cloud') {
+            const data = (await response.json());
+            return data.values;
+        }
+        else {
+            // Server returns array directly
+            return (await response.json());
+        }
+    }
+    /**
+     * Fetch Azure DevOps batch with pagination
+     */
+    async fetchAdoBatch(offset, limit) {
+        const creds = this.credentials;
+        const { organization, pat } = creds;
+        const url = `https://dev.azure.com/${organization}/_apis/projects?$top=${limit}&$skip=${offset}&api-version=7.0`;
+        const response = await fetch(url, {
+            method: 'GET',
+            headers: {
+                Authorization: `Basic ${Buffer.from(`:${pat}`).toString('base64')}`,
+                Accept: 'application/json'
+            },
+            signal: AbortSignal.timeout(30000) // 30 second timeout
+        });
+        if (!response.ok) {
+            const errorBody = await response.text().catch(() => 'No error body');
+            throw new Error(`Azure DevOps API error: ${response.status} ${response.statusText}. ${errorBody}`);
+        }
+        const data = (await response.json());
+        return data.value.map(p => ({
+            id: p.id,
+            key: p.name.toUpperCase().replace(/\s+/g, '-'),
+            name: p.name
+        }));
+    }
+    /**
+     * Fetch batch with retry logic and exponential backoff
+     */
+    async fetchBatchWithRetry(offset, limit) {
+        const delays = [1000, 2000, 4000]; // 1s, 2s, 4s
+        let lastError = null;
+        for (let attempt = 0; attempt < 3; attempt++) {
+            try {
+                return await this.fetchBatch(offset, limit);
+            }
+            catch (error) {
+                lastError = error;
+                // Don't retry on auth failures (4XX except 429)
+                if (this.isAuthError(error) && !error.message.includes('429')) {
+                    throw error;
+                }
+                // Retry on network errors, 5XX, or 429 errors
+                if (attempt < 2) {
+                    this.options.logger.log(chalk.yellow(`⚠️  Retry ${attempt + 1}/3 after ${delays[attempt]}ms... (${error.message})`));
+                    await new Promise(resolve => setTimeout(resolve, delays[attempt]));
+                }
+            }
+        }
+        throw lastError || new Error('Failed to fetch batch after 3 attempts');
+    }
+    /**
+     * Check rate limit headers and throttle if needed
+     */
+    async checkRateLimit(headers) {
+        const remaining = headers.get('X-RateLimit-Remaining');
+        const reset = headers.get('X-RateLimit-Reset');
+        if (remaining && parseInt(remaining, 10) < 10) {
+            const resetTime = reset ? parseInt(reset, 10) * 1000 : Date.now() + 60000;
+            const waitMs = Math.max(0, resetTime - Date.now());
+            const waitSec = Math.ceil(waitMs / 1000);
+            this.options.logger.log(chalk.yellow(`⚠️  Rate limit threshold reached (${remaining} requests remaining). Pausing ${waitSec}s...`));
+            await new Promise(resolve => setTimeout(resolve, waitMs + 1000)); // Add 1s buffer
+        }
+    }
+    /**
+     * Save partial state on cancelation
+     */
+    async savePartialState(projects, total, errors) {
+        const summary = this.progressTracker.getSummary();
+        // Calculate remaining projects
+        const completed = projects.length;
+        const remaining = [];
+        // Note: We don't have the list of all projects here, so remaining will be empty
+        // In a real implementation, this would be populated from the initial project list
+        const state = {
+            operation: `${this.provider}-import`,
+            provider: this.provider,
+            domain: 'credentials' in this.credentials ? this.credentials.domain : undefined,
+            timestamp: new Date().toISOString(),
+            version: '1.0',
+            total,
+            completed,
+            succeeded: summary.succeeded,
+            failed: summary.failed,
+            skipped: summary.skipped,
+            remaining,
+            errors
+        };
+        await this.cancelHandler.saveState(state);
+    }
+    /**
+     * Log error to file
+     */
+    async logError(error) {
+        try {
+            // Ensure log directory exists
+            const logDir = path.dirname(this.options.errorLogFile);
+            await fs.mkdir(logDir, { recursive: true });
+            // Format log entry
+            const logEntry = `[${error.timestamp}] ${error.projectKey}: ${error.error} (${error.suggestion})\n`;
+            // Append to log file
+            await fs.appendFile(this.options.errorLogFile, logEntry, 'utf-8');
+        }
+        catch (logError) {
+            this.options.logger.error('Failed to write error log:', logError);
+        }
+    }
+    /**
+     * Get suggestion for error
+     */
+    getSuggestion(error) {
+        const message = error.message || '';
+        if (message.includes('401') || message.includes('403')) {
+            return 'Check credentials and project permissions';
+        }
+        if (message.includes('404')) {
+            return 'Project may have been deleted or archived';
+        }
+        if (message.includes('429')) {
+            return 'Rate limit exceeded (throttling applied)';
+        }
+        if (message.includes('ETIMEDOUT') || message.includes('timeout')) {
+            return 'Network timeout (try again or reduce batch size)';
+        }
+        if (message.includes('5')) {
+            return 'API server error (retrying with backoff)';
+        }
+        return 'Unknown error (check logs for details)';
+    }
+    /**
+     * Check if error is auth-related (4XX)
+     */
+    isAuthError(error) {
+        const message = error.message || '';
+        return /\b40[0134]\b/.test(message);
+    }
+    /**
+     * Check if error is timeout-related
+     */
+    isTimeoutError(error) {
+        const message = error.message || '';
+        const code = error.code || '';
+        return message.includes('timeout') || code === 'ETIMEDOUT' || message.includes('ETIMEDOUT');
+    }
+}
+//# sourceMappingURL=async-project-loader.js.map