specweave 0.23.8 → 0.23.12

package/dist/src/cli/helpers/progress-tracker.js

@@ -0,0 +1,202 @@
+/**
+ * Progress Tracker
+ *
+ * Real-time progress tracking with percentage, ETA estimation, and final summary.
+ * Optimized for CLI workflows with throttled updates to prevent console spam.
+ *
+ * @module cli/helpers/progress-tracker
+ */
+import chalk from 'chalk';
+import { consoleLogger } from '../../utils/logger.js';
+/**
+ * Progress Tracker
+ *
+ * Tracks batch operation progress with:
+ * - Real-time percentage updates
+ * - ETA estimation (rolling average of last 10 items)
+ * - Throttled console updates (every N items)
+ * - Final summary (succeeded/failed/skipped counts)
+ *
+ * @example
+ * ```typescript
+ * const tracker = new ProgressTracker({ total: 127, updateFrequency: 5 });
+ *
+ * for (const project of projects) {
+ *   try {
+ *     await importProject(project);
+ *     tracker.update(project.key, 'success');
+ *   } catch (error) {
+ *     tracker.update(project.key, 'failure');
+ *   }
+ * }
+ *
+ * tracker.finish();
+ * // Output: ✅ Imported 125/127 projects (2 failed, 0 skipped) in 28s
+ * ```
+ */
+export class ProgressTracker {
+    constructor(options) {
+        this.completed = 0;
+        this.succeeded = 0;
+        this.failed = 0;
+        this.skipped = 0;
+        this.itemTimestamps = []; // For ETA calculation (rolling average)
+        this.lastRenderedProgress = ''; // For clearing previous output
+        this.total = options.total;
+        this.updateFrequency = options.updateFrequency ?? 5;
+        this.showEta = options.showEta ?? true;
+        this.progressBarWidth = options.progressBarWidth ?? 30;
+        this.logger = options.logger ?? consoleLogger;
+        this.startTime = Date.now();
+        this.lastUpdateTime = this.startTime;
+    }
+    /**
+     * Update progress with item result
+     *
+     * @param item - Item identifier (e.g., project key)
+     * @param status - Item status (success, failure, skip)
+     */
+    update(item, status) {
+        this.completed++;
+        if (status === 'success') {
+            this.succeeded++;
+        }
+        else if (status === 'failure') {
+            this.failed++;
+        }
+        else if (status === 'skip') {
+            this.skipped++;
+        }
+        // Track timestamp for ETA calculation
+        const now = Date.now();
+        this.itemTimestamps.push(now);
+        // Keep only last 10 timestamps (rolling average)
+        if (this.itemTimestamps.length > 10) {
+            this.itemTimestamps.shift();
+        }
+        // Throttle updates: only render every N items
+        if (this.completed % this.updateFrequency === 0 || this.completed === this.total) {
+            this.render();
+        }
+    }
+    /**
+     * Render progress bar to console
+     */
+    render() {
+        const percentage = Math.floor((this.completed / this.total) * 100);
+        const progressBar = this.getProgressBar(percentage);
+        const eta = this.showEta ? this.getEta() : '';
+        const message = `Fetching projects... ${this.completed}/${this.total} (${percentage}%) ${progressBar}${eta}`;
+        // Clear previous line if needed (terminal overwrite)
+        if (this.lastRenderedProgress) {
+            process.stdout.write('\r\x1b[K'); // Clear line
+        }
+        process.stdout.write(chalk.cyan(message));
+        this.lastRenderedProgress = message;
+    }
+    /**
+     * Generate ASCII progress bar
+     *
+     * @param percentage - Completion percentage (0-100)
+     * @returns ASCII progress bar string
+     */
+    getProgressBar(percentage) {
+        const filledWidth = Math.floor((percentage / 100) * this.progressBarWidth);
+        const emptyWidth = this.progressBarWidth - filledWidth;
+        const filled = '='.repeat(Math.max(0, filledWidth - 1)) + (filledWidth > 0 ? '>' : '');
+        const empty = ' '.repeat(emptyWidth);
+        return `[${filled}${empty}]`;
+    }
+    /**
+     * Calculate ETA using rolling average
+     *
+     * @returns ETA string (e.g., "~2m remaining") or empty if not enough data
+     */
+    getEta() {
+        if (this.itemTimestamps.length < 2) {
+            return ''; // Not enough data yet
+        }
+        // Calculate average time per item (rolling average of last 10)
+        const timestamps = this.itemTimestamps;
+        const intervals = [];
+        for (let i = 1; i < timestamps.length; i++) {
+            intervals.push(timestamps[i] - timestamps[i - 1]);
+        }
+        const avgTimePerItem = intervals.reduce((sum, interval) => sum + interval, 0) / intervals.length;
+        // Calculate remaining time
+        const remaining = this.total - this.completed;
+        const estimatedMs = remaining * avgTimePerItem;
+        // Format ETA
+        const estimatedSec = Math.ceil(estimatedMs / 1000);
+        const elapsed = Math.floor((Date.now() - this.startTime) / 1000);
+        if (estimatedSec < 60) {
+            return ` [${elapsed}s elapsed, ~${estimatedSec}s remaining]`;
+        }
+        else {
+            const estimatedMin = Math.ceil(estimatedSec / 60);
+            return ` [${elapsed}s elapsed, ~${estimatedMin}m remaining]`;
+        }
+    }
+    /**
+     * Finish tracking and show final summary
+     */
+    finish() {
+        // Clear progress line
+        if (this.lastRenderedProgress) {
+            process.stdout.write('\r\x1b[K');
+        }
+        const elapsed = Math.ceil((Date.now() - this.startTime) / 1000);
+        const elapsedStr = elapsed < 60 ? `${elapsed}s` : `${Math.ceil(elapsed / 60)}m`;
+        if (this.failed === 0 && this.skipped === 0) {
+            // Perfect success
+            this.logger.log(chalk.green(`✅ Imported ${this.succeeded}/${this.total} projects in ${elapsedStr}`));
+        }
+        else {
+            // Partial success
+            const summary = `✅ Imported ${this.succeeded}/${this.total}`;
+            const failures = this.failed > 0 ? chalk.red(`, ${this.failed} failed`) : '';
+            const skips = this.skipped > 0 ? chalk.yellow(`, ${this.skipped} skipped`) : '';
+            this.logger.log(`${summary}${failures}${skips} in ${elapsedStr}`);
+            // Suggest checking error log if failures exist
+            if (this.failed > 0) {
+                this.logger.log(chalk.yellow('⚠️  Check .specweave/logs/import-errors.log for details'));
+            }
+        }
+    }
+    /**
+     * Cancel tracking (for use with cancelation)
+     */
+    cancel() {
+        // Clear progress line
+        if (this.lastRenderedProgress) {
+            process.stdout.write('\r\x1b[K');
+        }
+        const elapsed = Math.ceil((Date.now() - this.startTime) / 1000);
+        const percentage = Math.floor((this.completed / this.total) * 100);
+        this.logger.log(chalk.yellow(`⚠️  Operation canceled. Imported ${this.completed}/${this.total} projects (${percentage}% complete) in ${elapsed}s`));
+    }
+    /**
+     * Get current progress summary
+     *
+     * @returns Progress summary object
+     */
+    getSummary() {
+        return {
+            total: this.total,
+            completed: this.completed,
+            succeeded: this.succeeded,
+            failed: this.failed,
+            skipped: this.skipped,
+            elapsed: Date.now() - this.startTime
+        };
+    }
+    /**
+     * Get current percentage (for testing)
+     *
+     * @returns Completion percentage (0-100)
+     */
+    getPercentage() {
+        return Math.floor((this.completed / this.total) * 100);
+    }
+}
+//# sourceMappingURL=progress-tracker.js.map

package/dist/src/cli/helpers/progress-tracker.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"progress-tracker.js","sourceRoot":"","sources":["../../../../src/cli/helpers/progress-tracker.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,OAAO,KAAK,MAAM,OAAO,CAAC;AAC1B,OAAO,EAAU,aAAa,EAAE,MAAM,uBAAuB,CAAC;AA8B9D;;;;;;;;;;;;;;;;;;;;;;;;;GAyBG;AACH,MAAM,OAAO,eAAe;IAkB1B,YAAY,OAAwB;QAX5B,cAAS,GAAG,CAAC,CAAC;QACd,cAAS,GAAG,CAAC,CAAC;QACd,WAAM,GAAG,CAAC,CAAC;QACX,YAAO,GAAG,CAAC,CAAC;QAIZ,mBAAc,GAAa,EAAE,CAAC,CAAC,wCAAwC;QAEvE,yBAAoB,GAAG,EAAE,CAAC,CAAC,+BAA+B;QAGhE,IAAI,CAAC,KAAK,GAAG,OAAO,CAAC,KAAK,CAAC;QAC3B,IAAI,CAAC,eAAe,GAAG,OAAO,CAAC,eAAe,IAAI,CAAC,CAAC;QACpD,IAAI,CAAC,OAAO,GAAG,OAAO,CAAC,OAAO,IAAI,IAAI,CAAC;QACvC,IAAI,CAAC,gBAAgB,GAAG,OAAO,CAAC,gBAAgB,IAAI,EAAE,CAAC;QACvD,IAAI,CAAC,MAAM,GAAG,OAAO,CAAC,MAAM,IAAI,aAAa,CAAC;QAE9C,IAAI,CAAC,SAAS,GAAG,IAAI,CAAC,GAAG,EAAE,CAAC;QAC5B,IAAI,CAAC,cAAc,GAAG,IAAI,CAAC,SAAS,CAAC;IACvC,CAAC;IAED;;;;;OAKG;IACH,MAAM,CAAC,IAAY,EAAE,MAAkB;QACrC,IAAI,CAAC,SAAS,EAAE,CAAC;QAEjB,IAAI,MAAM,KAAK,SAAS,EAAE,CAAC;YACzB,IAAI,CAAC,SAAS,EAAE,CAAC;QACnB,CAAC;aAAM,IAAI,MAAM,KAAK,SAAS,EAAE,CAAC;YAChC,IAAI,CAAC,MAAM,EAAE,CAAC;QAChB,CAAC;aAAM,IAAI,MAAM,KAAK,MAAM,EAAE,CAAC;YAC7B,IAAI,CAAC,OAAO,EAAE,CAAC;QACjB,CAAC;QAED,sCAAsC;QACtC,MAAM,GAAG,GAAG,IAAI,CAAC,GAAG,EAAE,CAAC;QACvB,IAAI,CAAC,cAAc,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;QAE9B,iDAAiD;QACjD,IAAI,IAAI,CAAC,cAAc,CAAC,MAAM,GAAG,EAAE,EAAE,CAAC;YACpC,IAAI,CAAC,cAAc,CAAC,KAAK,EAAE,CAAC;QAC9B,CAAC;QAED,8CAA8C;QAC9C,IAAI,IAAI,CAAC,SAAS,GAAG,IAAI,CAAC,eAAe,KAAK,CAAC,IAAI,IAAI,CAAC,SAAS,KAAK,IAAI,CAAC,KAAK,EAAE,CAAC;YACjF,IAAI,CAAC,MAAM,EAAE,CAAC;QAChB,CAAC;IACH,CAAC;IAED;;OAEG;IACK,MAAM;QACZ,MAAM,UAAU,GAAG,IAAI,CAAC,KAAK,CAAC,CAAC,IAAI,CAAC,SAAS,GAAG,IAAI,CAAC,KAAK,CAAC,GAAG,GAAG,CAAC,CAAC;QACnE,MAAM,WAAW,GAAG,IAAI,CAAC,cAAc,CAAC,UAAU,CAAC,CAAC;QACpD,MAAM,GAAG,GAAG,IAAI,CAAC,OAAO,CAAC,CAAC,CAAC,IAAI,CAAC,MAAM,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;QAE9C,MAAM,OAAO,GAAG,wBAAwB,IAAI,CAAC,SAAS,IAAI,IAAI,CAAC,KAAK,KAAK,UAAU,MAAM,WAAW,GAAG,GAAG,EAAE,CAAC;QAE7G,qDAAqD;QACrD,IAAI,IAAI,CAAC,oBAAoB,EAAE,CAAC;YAC9B,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,UAAU,CAAC,CAAC,CAAC,aAAa;QACjD,CAAC;QAED,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,KAAK,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC,CAAC;QAC1C,IAAI,CAAC,oBAAoB,GAAG,OAAO,CAAC;IACtC,CAAC;IAED;;;;;OAKG;IACK,cAAc,CAAC,UAAkB;QACvC,MAAM,WAAW,GAAG,IAAI,CAAC,KAAK,CAAC,CAAC,UAAU,GAAG,GAAG,CAAC,GAAG,IAAI,CAAC,gBAAgB,CAAC,CAAC;QAC3E,MAAM,UAAU,GAAG,IAAI,CAAC,gBAAgB,GAAG,WAAW,CAAC;QAEvD,MAAM,MAAM,GAAG,GAAG,CAAC,MAAM,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,WAAW,GAAG,CAAC,CAAC,CAAC,GAAG,CAAC,WAAW,GAAG,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC;QACvF,MAAM,KAAK,GAAG,GAAG,CAAC,MAAM,CAAC,UAAU,CAAC,CAAC;QAErC,OAAO,IAAI,MAAM,GAAG,KAAK,GAAG,CAAC;IAC/B,CAAC;IAED;;;;OAIG;IACK,MAAM;QACZ,IAAI,IAAI,CAAC,cAAc,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;YACnC,OAAO,EAAE,CAAC,CAAC,sBAAsB;QACnC,CAAC;QAED,+DAA+D;QAC/D,MAAM,UAAU,GAAG,IAAI,CAAC,cAAc,CAAC;QACvC,MAAM,SAAS,GAAa,EAAE,CAAC;QAE/B,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,UAAU,CAAC,MAAM,EAAE,CAAC,EAAE,EAAE,CAAC;YAC3C,SAAS,CAAC,IAAI,CAAC,UAAU,CAAC,CAAC,CAAC,GAAG,UAAU,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC;QACpD,CAAC;QAED,MAAM,cAAc,GAAG,SAAS,CAAC,MAAM,CAAC,CAAC,GAAG,EAAE,QAAQ,EAAE,EAAE,CAAC,GAAG,GAAG,QAAQ,EAAE,CAAC,CAAC,GAAG,SAAS,CAAC,MAAM,CAAC;QAEjG,2BAA2B;QAC3B,MAAM,SAAS,GAAG,IAAI,CAAC,KAAK,GAAG,IAAI,CAAC,SAAS,CAAC;QAC9C,MAAM,WAAW,GAAG,SAAS,GAAG,cAAc,CAAC;QAE/C,aAAa;QACb,MAAM,YAAY,GAAG,IAAI,CAAC,IAAI,CAAC,WAAW,GAAG,IAAI,CAAC,CAAC;QACnD,MAAM,OAAO,GAAG,IAAI,CAAC,KAAK,CAAC,CAAC,IAAI,CAAC,GAAG,EAAE,GAAG,IAAI,CAAC,SAAS,CAAC,GAAG,IAAI,CAAC,CAAC;QAEjE,IAAI,YAAY,GAAG,EAAE,EAAE,CAAC;YACtB,OAAO,KAAK,OAAO,eAAe,YAAY,cAAc,CAAC;QAC/D,CAAC;aAAM,CAAC;YACN,MAAM,YAAY,GAAG,IAAI,CAAC,IAAI,CAAC,YAAY,GAAG,EAAE,CAAC,CAAC;YAClD,OAAO,KAAK,OAAO,eAAe,YAAY,cAAc,CAAC;QAC/D,CAAC;IACH,CAAC;IAED;;OAEG;IACH,MAAM;QACJ,sBAAsB;QACtB,IAAI,IAAI,CAAC,oBAAoB,EAAE,CAAC;YAC9B,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,UAAU,CAAC,CAAC;QACnC,CAAC;QAED,MAAM,OAAO,GAAG,IAAI,CAAC,IAAI,CAAC,CAAC,IAAI,CAAC,GAAG,EAAE,GAAG,IAAI,CAAC,SAAS,CAAC,GAAG,IAAI,CAAC,CAAC;QAChE,MAAM,UAAU,GAAG,OAAO,GAAG,EAAE,CAAC,CAAC,CAAC,GAAG,OAAO,GAAG,CAAC,CAAC,CAAC,GAAG,IAAI,CAAC,IAAI,CAAC,OAAO,GAAG,EAAE,CAAC,GAAG,CAAC;QAEhF,IAAI,IAAI,CAAC,MAAM,KAAK,CAAC,IAAI,IAAI,CAAC,OAAO,KAAK,CAAC,EAAE,CAAC;YAC5C,kBAAkB;YAClB,IAAI,CAAC,MAAM,CAAC,GAAG,CAAC,KAAK,CAAC,KAAK,CAAC,cAAc,IAAI,CAAC,SAAS,IAAI,IAAI,CAAC,KAAK,gBAAgB,UAAU,EAAE,CAAC,CAAC,CAAC;QACvG,CAAC;aAAM,CAAC;YACN,kBAAkB;YAClB,MAAM,OAAO,GAAG,cAAc,IAAI,CAAC,SAAS,IAAI,IAAI,CAAC,KAAK,EAAE,CAAC;YAC7D,MAAM,QAAQ,GAAG,IAAI,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC,GAAG,CAAC,KAAK,IAAI,CAAC,MAAM,SAAS,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC;YAC7E,MAAM,KAAK,GAAG,IAAI,CAAC,OAAO,GAAG,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC,MAAM,CAAC,KAAK,IAAI,CAAC,OAAO,UAAU,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC;YAEhF,IAAI,CAAC,MAAM,CAAC,GAAG,CAAC,GAAG,OAAO,GAAG,QAAQ,GAAG,KAAK,OAAO,UAAU,EAAE,CAAC,CAAC;YAElE,+CAA+C;YAC/C,IAAI,IAAI,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;gBACpB,IAAI,CAAC,MAAM,CAAC,GAAG,CAAC,KAAK,CAAC,MAAM,CAAC,yDAAyD,CAAC,CAAC,CAAC;YAC3F,CAAC;QACH,CAAC;IACH,CAAC;IAED;;OAEG;IACH,MAAM;QACJ,sBAAsB;QACtB,IAAI,IAAI,CAAC,oBAAoB,EAAE,CAAC;YAC9B,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,UAAU,CAAC,CAAC;QACnC,CAAC;QAED,MAAM,OAAO,GAAG,IAAI,CAAC,IAAI,CAAC,CAAC,IAAI,CAAC,GAAG,EAAE,GAAG,IAAI,CAAC,SAAS,CAAC,GAAG,IAAI,CAAC,CAAC;QAChE,MAAM,UAAU,GAAG,IAAI,CAAC,KAAK,CAAC,CAAC,IAAI,CAAC,SAAS,GAAG,IAAI,CAAC,KAAK,CAAC,GAAG,GAAG,CAAC,CAAC;QAEnE,IAAI,CAAC,MAAM,CAAC,GAAG,CACb,KAAK,CAAC,MAAM,CACV,oCAAoC,IAAI,CAAC,SAAS,IAAI,IAAI,CAAC,KAAK,cAAc,UAAU,kBAAkB,OAAO,GAAG,CACrH,CACF,CAAC;IACJ,CAAC;IAED;;;;OAIG;IACH,UAAU;QACR,OAAO;YACL,KAAK,EAAE,IAAI,CAAC,KAAK;YACjB,SAAS,EAAE,IAAI,CAAC,SAAS;YACzB,SAAS,EAAE,IAAI,CAAC,SAAS;YACzB,MAAM,EAAE,IAAI,CAAC,MAAM;YACnB,OAAO,EAAE,IAAI,CAAC,OAAO;YACrB,OAAO,EAAE,IAAI,CAAC,GAAG,EAAE,GAAG,IAAI,CAAC,SAAS;SACrC,CAAC;IACJ,CAAC;IAED;;;;OAIG;IACH,aAAa;QACX,OAAO,IAAI,CAAC,KAAK,CAAC,CAAC,IAAI,CAAC,SAAS,GAAG,IAAI,CAAC,KAAK,CAAC,GAAG,GAAG,CAAC,CAAC;IACzD,CAAC;CACF"}

package/dist/src/cli/helpers/project-count-fetcher.d.ts

@@ -0,0 +1,69 @@
+/**
+ * Project Count Fetcher
+ *
+ * Lightweight query to get project count without fetching full metadata.
+ * Optimized for < 1 second response time with retry logic.
+ *
+ * @module cli/helpers/project-count-fetcher
+ */
+import { Logger } from '../../utils/logger.js';
+/**
+ * Supported issue tracker providers
+ */
+export type ProjectProvider = 'jira' | 'ado';
+/**
+ * Jira instance type (Cloud vs Server/Data Center)
+ */
+export type JiraInstanceType = 'cloud' | 'server';
+/**
+ * Jira credentials
+ */
+export interface JiraCredentials {
+    domain: string;
+    email: string;
+    token: string;
+    instanceType: JiraInstanceType;
+}
+/**
+ * Azure DevOps credentials
+ */
+export interface AdoCredentials {
+    organization: string;
+    pat: string;
+}
+/**
+ * Project count options
+ */
+export interface ProjectCountOptions {
+    credentials: JiraCredentials | AdoCredentials;
+    provider: ProjectProvider;
+    logger?: Logger;
+}
+/**
+ * Project count result
+ */
+export interface ProjectCountResult {
+    total: number;
+    accessible: number;
+    error?: string;
+}
+/**
+ * Get project count from issue tracker
+ *
+ * Performs lightweight count-only query (no metadata fetched).
+ * Target response time: < 1 second
+ *
+ * @param options - Project count options
+ * @returns Project count result
+ *
+ * @example
+ * ```typescript
+ * const result = await getProjectCount({
+ *   credentials: { domain: 'example.atlassian.net', email: 'user@example.com', token: 'xyz', instanceType: 'cloud' },
+ *   provider: 'jira'
+ * });
+ * console.log(`Found ${result.total} projects`);
+ * ```
+ */
+export declare function getProjectCount(options: ProjectCountOptions): Promise<ProjectCountResult>;
+//# sourceMappingURL=project-count-fetcher.d.ts.map

package/dist/src/cli/helpers/project-count-fetcher.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"project-count-fetcher.d.ts","sourceRoot":"","sources":["../../../../src/cli/helpers/project-count-fetcher.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,OAAO,EAAE,MAAM,EAAiB,MAAM,uBAAuB,CAAC;AAE9D;;GAEG;AACH,MAAM,MAAM,eAAe,GAAG,MAAM,GAAG,KAAK,CAAC;AAE7C;;GAEG;AACH,MAAM,MAAM,gBAAgB,GAAG,OAAO,GAAG,QAAQ,CAAC;AAElD;;GAEG;AACH,MAAM,WAAW,eAAe;IAC9B,MAAM,EAAE,MAAM,CAAC;IACf,KAAK,EAAE,MAAM,CAAC;IACd,KAAK,EAAE,MAAM,CAAC;IACd,YAAY,EAAE,gBAAgB,CAAC;CAChC;AAED;;GAEG;AACH,MAAM,WAAW,cAAc;IAC7B,YAAY,EAAE,MAAM,CAAC;IACrB,GAAG,EAAE,MAAM,CAAC;CACb;AAED;;GAEG;AACH,MAAM,WAAW,mBAAmB;IAClC,WAAW,EAAE,eAAe,GAAG,cAAc,CAAC;IAC9C,QAAQ,EAAE,eAAe,CAAC;IAC1B,MAAM,CAAC,EAAE,MAAM,CAAC;CACjB;AAED;;GAEG;AACH,MAAM,WAAW,kBAAkB;IACjC,KAAK,EAAE,MAAM,CAAC;IACd,UAAU,EAAE,MAAM,CAAC;IACnB,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB;AAED;;;;;;;;;;;;;;;;;GAiBG;AACH,wBAAsB,eAAe,CACnC,OAAO,EAAE,mBAAmB,GAC3B,OAAO,CAAC,kBAAkB,CAAC,CAmB7B"}

package/dist/src/cli/helpers/project-count-fetcher.js

@@ -0,0 +1,173 @@
+/**
+ * Project Count Fetcher
+ *
+ * Lightweight query to get project count without fetching full metadata.
+ * Optimized for < 1 second response time with retry logic.
+ *
+ * @module cli/helpers/project-count-fetcher
+ */
+import { consoleLogger } from '../../utils/logger.js';
+/**
+ * Get project count from issue tracker
+ *
+ * Performs lightweight count-only query (no metadata fetched).
+ * Target response time: < 1 second
+ *
+ * @param options - Project count options
+ * @returns Project count result
+ *
+ * @example
+ * ```typescript
+ * const result = await getProjectCount({
+ *   credentials: { domain: 'example.atlassian.net', email: 'user@example.com', token: 'xyz', instanceType: 'cloud' },
+ *   provider: 'jira'
+ * });
+ * console.log(`Found ${result.total} projects`);
+ * ```
+ */
+export async function getProjectCount(options) {
+    const { provider, credentials, logger = consoleLogger } = options;
+    try {
+        if (provider === 'jira') {
+            return await getJiraProjectCount(credentials, logger);
+        }
+        else if (provider === 'ado') {
+            return await getAdoProjectCount(credentials, logger);
+        }
+        else {
+            throw new Error(`Unsupported provider: ${provider}`);
+        }
+    }
+    catch (error) {
+        logger.error('Error fetching project count:', error);
+        return {
+            total: 0,
+            accessible: 0,
+            error: error.message || 'Unknown error'
+        };
+    }
+}
+/**
+ * Get JIRA project count (Cloud or Server)
+ *
+ * API Endpoints:
+ * - Cloud: GET /rest/api/3/project/search?maxResults=0
+ * - Server: GET /rest/api/2/project?maxResults=0
+ *
+ * @param credentials - JIRA credentials
+ * @param logger - Logger instance
+ * @returns Project count result
+ */
+async function getJiraProjectCount(credentials, logger) {
+    const { domain, email, token, instanceType } = credentials;
+    // Determine API endpoint based on instance type
+    const apiVersion = instanceType === 'cloud' ? '3' : '2';
+    const endpoint = instanceType === 'cloud'
+        ? `/rest/api/${apiVersion}/project/search?maxResults=0`
+        : `/rest/api/${apiVersion}/project?maxResults=0`;
+    const url = `https://${domain}${endpoint}`;
+    // Retry logic: 3 attempts with exponential backoff (1s, 2s, 4s)
+    const delays = [1000, 2000, 4000];
+    let lastError = null;
+    for (let attempt = 0; attempt < 3; attempt++) {
+        try {
+            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(10000) // 10 second timeout
+            });
+            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') {
+                // Cloud returns { total: N, values: [] }
+                const data = (await response.json());
+                return {
+                    total: data.total,
+                    accessible: data.total
+                };
+            }
+            else {
+                // Server returns [] with X-Total-Count header
+                const totalHeader = response.headers.get('X-Total-Count');
+                const total = totalHeader ? parseInt(totalHeader, 10) : 0;
+                return {
+                    total,
+                    accessible: total
+                };
+            }
+        }
+        catch (error) {
+            lastError = error;
+            // Don't retry on auth failures (4XX except 429)
+            const isAuthError = error.message && /\b40[0134]\b/.test(error.message);
+            if (isAuthError && !error.message.includes('429')) {
+                throw error;
+            }
+            // Retry on network errors or 5XX/429 errors
+            if (attempt < 2) {
+                logger.log(`Retry ${attempt + 1}/3 after ${delays[attempt]}ms...`);
+                await new Promise(resolve => setTimeout(resolve, delays[attempt]));
+            }
+        }
+    }
+    throw lastError || new Error('Failed to get project count after 3 attempts');
+}
+/**
+ * Get Azure DevOps project count
+ *
+ * API Endpoint:
+ * - GET https://dev.azure.com/{org}/_apis/projects?$top=0
+ *
+ * @param credentials - ADO credentials
+ * @param logger - Logger instance
+ * @returns Project count result
+ */
+async function getAdoProjectCount(credentials, logger) {
+    const { organization, pat } = credentials;
+    const url = `https://dev.azure.com/${organization}/_apis/projects?$top=0&api-version=7.0`;
+    // Retry logic: 3 attempts with exponential backoff (1s, 2s, 4s)
+    const delays = [1000, 2000, 4000];
+    let lastError = null;
+    for (let attempt = 0; attempt < 3; attempt++) {
+        try {
+            const response = await fetch(url, {
+                method: 'GET',
+                headers: {
+                    Authorization: `Basic ${Buffer.from(`:${pat}`).toString('base64')}`,
+                    Accept: 'application/json'
+                },
+                signal: AbortSignal.timeout(10000) // 10 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 {
+                total: data.count,
+                accessible: data.count
+            };
+        }
+        catch (error) {
+            lastError = error;
+            // Don't retry on auth failures (4XX except 429)
+            const isAuthError = error.message && /\b40[0134]\b/.test(error.message);
+            if (isAuthError && !error.message.includes('429')) {
+                throw error;
+            }
+            // Retry on network errors or 5XX/429 errors
+            if (attempt < 2) {
+                logger.log(`Retry ${attempt + 1}/3 after ${delays[attempt]}ms...`);
+                await new Promise(resolve => setTimeout(resolve, delays[attempt]));
+            }
+        }
+    }
+    throw lastError || new Error('Failed to get ADO project count after 3 attempts');
+}
+//# sourceMappingURL=project-count-fetcher.js.map

package/dist/src/cli/helpers/project-count-fetcher.js.map

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

package/dist/src/config/types.d.ts

@@ -242,15 +242,15 @@ export declare const ResearchConfigSchema: z.ZodObject<{
             requirements: z.ZodOptional<z.ZodString>;
             url: z.ZodOptional<z.ZodString>;
         }, "strip", z.ZodTypeAny, {
+            provider?: string;
             url?: string;
             requirements?: string;
-            provider?: string;
             amount?: string;
             duration?: string;
         }, {
+            provider?: string;
             url?: string;
             requirements?: string;
-            provider?: string;
             amount?: string;
             duration?: string;
         }>, "many">;
@@ -302,9 +302,9 @@ export declare const ResearchConfigSchema: z.ZodObject<{
             at1M?: string;
         };
         cloudCredits?: {
+            provider?: string;
             url?: string;
             requirements?: string;
-            provider?: string;
             amount?: string;
             duration?: string;
         }[];
@@ -330,9 +330,9 @@ export declare const ResearchConfigSchema: z.ZodObject<{
             at1M?: string;
         };
         cloudCredits?: {
+            provider?: string;
             url?: string;
             requirements?: string;
-            provider?: string;
             amount?: string;
             duration?: string;
         }[];
@@ -385,9 +385,9 @@ export declare const ResearchConfigSchema: z.ZodObject<{
             at1M?: string;
         };
         cloudCredits?: {
+            provider?: string;
             url?: string;
             requirements?: string;
-            provider?: string;
             amount?: string;
             duration?: string;
         }[];
@@ -476,9 +476,9 @@ export declare const ResearchConfigSchema: z.ZodObject<{
             at1M?: string;
         };
         cloudCredits?: {
+            provider?: string;
             url?: string;
             requirements?: string;
-            provider?: string;
             amount?: string;
             duration?: string;
         }[];
@@ -814,15 +814,15 @@ export declare const SpecWeaveConfigSchema: z.ZodObject<{
                 requirements: z.ZodOptional<z.ZodString>;
                 url: z.ZodOptional<z.ZodString>;
             }, "strip", z.ZodTypeAny, {
+                provider?: string;
                 url?: string;
                 requirements?: string;
-                provider?: string;
                 amount?: string;
                 duration?: string;
             }, {
+                provider?: string;
                 url?: string;
                 requirements?: string;
-                provider?: string;
                 amount?: string;
                 duration?: string;
             }>, "many">;
@@ -874,9 +874,9 @@ export declare const SpecWeaveConfigSchema: z.ZodObject<{
                 at1M?: string;
             };
             cloudCredits?: {
+                provider?: string;
                 url?: string;
                 requirements?: string;
-                provider?: string;
                 amount?: string;
                 duration?: string;
             }[];
@@ -902,9 +902,9 @@ export declare const SpecWeaveConfigSchema: z.ZodObject<{
                 at1M?: string;
             };
             cloudCredits?: {
+                provider?: string;
                 url?: string;
                 requirements?: string;
-                provider?: string;
                 amount?: string;
                 duration?: string;
             }[];
@@ -957,9 +957,9 @@ export declare const SpecWeaveConfigSchema: z.ZodObject<{
                 at1M?: string;
             };
             cloudCredits?: {
+                provider?: string;
                 url?: string;
                 requirements?: string;
-                provider?: string;
                 amount?: string;
                 duration?: string;
             }[];
@@ -1048,9 +1048,9 @@ export declare const SpecWeaveConfigSchema: z.ZodObject<{
                 at1M?: string;
             };
             cloudCredits?: {
+                provider?: string;
                 url?: string;
                 requirements?: string;
-                provider?: string;
                 amount?: string;
                 duration?: string;
             }[];
@@ -1175,9 +1175,9 @@ export declare const SpecWeaveConfigSchema: z.ZodObject<{
                 at1M?: string;
             };
             cloudCredits?: {
+                provider?: string;
                 url?: string;
                 requirements?: string;
-                provider?: string;
                 amount?: string;
                 duration?: string;
             }[];
@@ -1277,9 +1277,9 @@ export declare const SpecWeaveConfigSchema: z.ZodObject<{
                 at1M?: string;
             };
             cloudCredits?: {
+                provider?: string;
                 url?: string;
                 requirements?: string;
-                provider?: string;
                 amount?: string;
                 duration?: string;
             }[];