specweave 0.23.10 → 0.23.12

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;
             }[];

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

@@ -0,0 +1,119 @@
+import { Logger } from '../../utils/logger.js';
+/**
+ * Cached data wrapper with TTL metadata
+ */
+export interface CachedData<T> {
+    data: T;
+    timestamp: number;
+    ttl: number;
+}
+/**
+ * Cache statistics for monitoring and debugging
+ */
+export interface CacheStats {
+    totalFiles: number;
+    totalSize: number;
+    oldestCache: string | null;
+    oldestCacheAge: number | null;
+    providers: {
+        [provider: string]: {
+            files: number;
+            size: number;
+        };
+    };
+}
+/**
+ * CacheManager - Manages file-based caching with TTL validation
+ *
+ * Features:
+ * - 24-hour TTL by default (configurable)
+ * - Atomic writes (temp file + rename)
+ * - Corruption detection and auto-recovery
+ * - Per-project cache separation
+ * - Thread-safe operations
+ *
+ * Cache file format:
+ * {
+ *   "data": <T>,
+ *   "timestamp": 1700000000000,
+ *   "ttl": 86400000
+ * }
+ */
+export declare class CacheManager {
+    private cacheDir;
+    private logger;
+    private defaultTTL;
+    constructor(projectRoot: string, options?: {
+        logger?: Logger;
+        ttl?: number;
+    });
+    /**
+     * Get cached data if valid (within TTL)
+     *
+     * @param key Cache key (e.g., "jira-projects", "jira-BACKEND-deps")
+     * @returns Cached data or null if cache miss/expired/corrupted
+     */
+    get<T>(key: string): Promise<T | null>;
+    /**
+     * Get cached data even if expired (stale cache fallback)
+     *
+     * Used for rate limit fallback: when API rate limit hit,
+     * use stale cache instead of failing
+     *
+     * @param key Cache key
+     * @returns Cached data or null if missing/corrupted (ignores TTL)
+     */
+    getStale<T>(key: string): Promise<T | null>;
+    /**
+     * Set cached data with current timestamp and TTL
+     *
+     * Uses atomic write pattern (temp file + rename) to prevent corruption
+     *
+     * @param key Cache key
+     * @param data Data to cache
+     * @param ttl Optional custom TTL (overrides default)
+     */
+    set<T>(key: string, data: T, ttl?: number): Promise<void>;
+    /**
+     * Delete cached data
+     *
+     * @param key Cache key
+     */
+    delete(key: string): Promise<void>;
+    /**
+     * Clear all cached data
+     */
+    clearAll(): Promise<void>;
+    /**
+     * Get cache statistics for monitoring
+     */
+    getStats(): Promise<CacheStats>;
+    /**
+     * Delete caches older than specified age
+     *
+     * @param maxAgeMs Maximum age in milliseconds
+     * @returns Count of deleted caches
+     */
+    deleteOlderThan(maxAgeMs: number): Promise<number>;
+    /**
+     * Check if cached data is still valid (within TTL)
+     */
+    private isValid;
+    /**
+     * Validate cache structure has required fields
+     */
+    private isValidCacheStructure;
+    /**
+     * Get full cache file path for a key
+     */
+    private getCachePath;
+    /**
+     * Ensure cache directory exists
+     */
+    private ensureCacheDir;
+    /**
+     * Log cache errors to dedicated error log
+     */
+    private logCacheError;
+}
+//# sourceMappingURL=cache-manager.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"cache-manager.d.ts","sourceRoot":"","sources":["../../../../src/core/cache/cache-manager.ts"],"names":[],"mappings":"AAGA,OAAO,EAAE,MAAM,EAAiB,MAAM,uBAAuB,CAAC;AAE9D;;GAEG;AACH,MAAM,WAAW,UAAU,CAAC,CAAC;IAC3B,IAAI,EAAE,CAAC,CAAC;IACR,SAAS,EAAE,MAAM,CAAC;IAClB,GAAG,EAAE,MAAM,CAAC;CACb;AAED;;GAEG;AACH,MAAM,WAAW,UAAU;IACzB,UAAU,EAAE,MAAM,CAAC;IACnB,SAAS,EAAE,MAAM,CAAC;IAClB,WAAW,EAAE,MAAM,GAAG,IAAI,CAAC;IAC3B,cAAc,EAAE,MAAM,GAAG,IAAI,CAAC;IAC9B,SAAS,EAAE;QACT,CAAC,QAAQ,EAAE,MAAM,GAAG;YAClB,KAAK,EAAE,MAAM,CAAC;YACd,IAAI,EAAE,MAAM,CAAC;SACd,CAAC;KACH,CAAC;CACH;AAED;;;;;;;;;;;;;;;;GAgBG;AACH,qBAAa,YAAY;IACvB,OAAO,CAAC,QAAQ,CAAS;IACzB,OAAO,CAAC,MAAM,CAAS;IACvB,OAAO,CAAC,UAAU,CAA+B;gBAG/C,WAAW,EAAE,MAAM,EACnB,OAAO,GAAE;QACP,MAAM,CAAC,EAAE,MAAM,CAAC;QAChB,GAAG,CAAC,EAAE,MAAM,CAAC;KACT;IASR;;;;;OAKG;IACG,GAAG,CAAC,CAAC,EAAE,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,CAAC,GAAG,IAAI,CAAC;IA0C5C;;;;;;;;OAQG;IACG,QAAQ,CAAC,CAAC,EAAE,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,CAAC,GAAG,IAAI,CAAC;IAkCjD;;;;;;;;OAQG;IACG,GAAG,CAAC,CAAC,EAAE,GAAG,EAAE,MAAM,EAAE,IAAI,EAAE,CAAC,EAAE,GAAG,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAgC/D;;;;OAIG;IACG,MAAM,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IASxC;;OAEG;IACG,QAAQ,IAAI,OAAO,CAAC,IAAI,CAAC;IAgB/B;;OAEG;IACG,QAAQ,IAAI,OAAO,CAAC,UAAU,CAAC;IAwDrC;;;;;OAKG;IACG,eAAe,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC;IAkCxD;;OAEG;IACH,OAAO,CAAC,OAAO;IAMf;;OAEG;IACH,OAAO,CAAC,qBAAqB;IAY7B;;OAEG;IACH,OAAO,CAAC,YAAY;IAIpB;;OAEG;YACW,cAAc;IAM5B;;OAEG;YACW,aAAa;CAa5B"}