specweave 1.0.593 → 2.0.0

package/dist/src/integrations/ado/ado-dependency-loader.d.ts

@@ -1,99 +0,0 @@
-/**
- * AdoDependencyLoader - Three-Tier Dependency Loading for Azure DevOps
- *
- * Architecture (ADR-0056):
- * - Tier 1 (Init): Metadata only (< 5 seconds, 1 API call)
- * - Tier 2 (On-Demand): Lazy loading per project (2-5 seconds, 3-4 API calls)
- * - Tier 3 (Bulk): Optional pre-load command (1-2 minutes for 50 projects)
- *
- * Features:
- * - 24-hour TTL caching via CacheManager
- * - Rate limit detection (ADO: 200 req/hour, stricter than JIRA)
- * - Per-project dependency caching
- * - Automatic cache invalidation on 404 errors
- *
- * @module integrations/ado/ado-dependency-loader
- */
-import { CacheManager } from '../../core/cache/cache-manager.js';
-import { RateLimitChecker } from '../../core/cache/rate-limit-checker.js';
-import { AdoClient } from './ado-client.js';
-import { Logger } from '../../utils/logger.js';
-/**
- * Project metadata (Tier 1)
- */
-export interface AdoProjectMetadata {
-    id: string;
-    name: string;
-    description?: string;
-    visibility: string;
-    state: string;
-}
-/**
- * Project dependencies (Tier 2)
- */
-export interface AdoProjectDependencies {
-    projectId: string;
-    projectName: string;
-    areaPaths: Array<{
-        id: number;
-        name: string;
-        path: string;
-        hasChildren?: boolean;
-        children?: any[];
-    }>;
-    teams: Array<{
-        id: string;
-        name: string;
-        description?: string;
-    }>;
-    lastUpdated: string;
-}
-/**
- * AdoDependencyLoader - Three-tier dependency loading with smart caching
- */
-export declare class AdoDependencyLoader {
-    private cacheManager;
-    private rateLimitChecker;
-    private adoClient;
-    private logger;
-    constructor(options: {
-        adoClient: AdoClient;
-        cacheManager: CacheManager;
-        rateLimitChecker?: RateLimitChecker;
-        logger?: Logger;
-    });
-    /**
-     * Tier 1: Load project metadata only (init)
-     *
-     * Performance: < 5 seconds for 50 projects (1 API call)
-     * Cache: 24-hour TTL in `ado-projects.json`
-     *
-     * @param maxProjects Maximum projects to load (default: 50)
-     * @returns Array of project metadata
-     */
-    loadProjectMetadata(maxProjects?: number): Promise<AdoProjectMetadata[]>;
-    /**
-     * Tier 2: Load dependencies for specific project (on-demand)
-     *
-     * Performance: 2-5 seconds per project (3-4 API calls, cached)
-     * Cache: 24-hour TTL in `ado-{PROJECT}-deps.json`
-     *
-     * @param projectName Project name or ID
-     * @returns Project dependencies
-     */
-    loadProjectDependencies(projectName: string): Promise<AdoProjectDependencies>;
-    /**
-     * Tier 3: Bulk pre-load all dependencies (optional command)
-     *
-     * Performance: 1-2 minutes for 50 projects (150-200 API calls, batched)
-     * Progress: Real-time progress tracking with ProgressTracker, cancelation with CancelationHandler
-     *
-     * @param projectNames Array of project names to preload
-     * @returns void (results cached)
-     */
-    preloadAllDependencies(projectNames: string[], options?: {
-        onProgress?: (current: number, total: number) => void;
-        signal?: AbortSignal;
-    }): Promise<void>;
-}
-//# sourceMappingURL=ado-dependency-loader.d.ts.map

package/dist/src/integrations/ado/ado-dependency-loader.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"ado-dependency-loader.d.ts","sourceRoot":"","sources":["../../../../src/integrations/ado/ado-dependency-loader.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;GAeG;AAEH,OAAO,EAAE,YAAY,EAAE,MAAM,mCAAmC,CAAC;AACjE,OAAO,EAAE,gBAAgB,EAAE,MAAM,wCAAwC,CAAC;AAC1E,OAAO,EAAE,SAAS,EAAE,MAAM,iBAAiB,CAAC;AAC5C,OAAO,EAAE,MAAM,EAAiB,MAAM,uBAAuB,CAAC;AAI9D;;GAEG;AACH,MAAM,WAAW,kBAAkB;IACjC,EAAE,EAAE,MAAM,CAAC;IACX,IAAI,EAAE,MAAM,CAAC;IACb,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,UAAU,EAAE,MAAM,CAAC;IACnB,KAAK,EAAE,MAAM,CAAC;CACf;AAED;;GAEG;AACH,MAAM,WAAW,sBAAsB;IACrC,SAAS,EAAE,MAAM,CAAC;IAClB,WAAW,EAAE,MAAM,CAAC;IACpB,SAAS,EAAE,KAAK,CAAC;QACf,EAAE,EAAE,MAAM,CAAC;QACX,IAAI,EAAE,MAAM,CAAC;QACb,IAAI,EAAE,MAAM,CAAC;QACb,WAAW,CAAC,EAAE,OAAO,CAAC;QACtB,QAAQ,CAAC,EAAE,GAAG,EAAE,CAAC;KAClB,CAAC,CAAC;IACH,KAAK,EAAE,KAAK,CAAC;QACX,EAAE,EAAE,MAAM,CAAC;QACX,IAAI,EAAE,MAAM,CAAC;QACb,WAAW,CAAC,EAAE,MAAM,CAAC;KACtB,CAAC,CAAC;IACH,WAAW,EAAE,MAAM,CAAC;CACrB;AAED;;GAEG;AACH,qBAAa,mBAAmB;IAC9B,OAAO,CAAC,YAAY,CAAe;IACnC,OAAO,CAAC,gBAAgB,CAAmB;IAC3C,OAAO,CAAC,SAAS,CAAY;IAC7B,OAAO,CAAC,MAAM,CAAS;gBAEX,OAAO,EAAE;QACnB,SAAS,EAAE,SAAS,CAAC;QACrB,YAAY,EAAE,YAAY,CAAC;QAC3B,gBAAgB,CAAC,EAAE,gBAAgB,CAAC;QACpC,MAAM,CAAC,EAAE,MAAM,CAAC;KACjB;IAOD;;;;;;;;OAQG;IACG,mBAAmB,CAAC,WAAW,GAAE,MAAW,GAAG,OAAO,CAAC,kBAAkB,EAAE,CAAC;IA+DlF;;;;;;;;OAQG;IACG,uBAAuB,CAAC,WAAW,EAAE,MAAM,GAAG,OAAO,CAAC,sBAAsB,CAAC;IAwFnF;;;;;;;;OAQG;IACG,sBAAsB,CAC1B,YAAY,EAAE,MAAM,EAAE,EACtB,OAAO,GAAE;QACP,UAAU,CAAC,EAAE,CAAC,OAAO,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,KAAK,IAAI,CAAC;QACtD,MAAM,CAAC,EAAE,WAAW,CAAC;KACjB,GACL,OAAO,CAAC,IAAI,CAAC;CAqEjB"}

package/dist/src/integrations/ado/ado-dependency-loader.js

@@ -1,237 +0,0 @@
-/**
- * AdoDependencyLoader - Three-Tier Dependency Loading for Azure DevOps
- *
- * Architecture (ADR-0056):
- * - Tier 1 (Init): Metadata only (< 5 seconds, 1 API call)
- * - Tier 2 (On-Demand): Lazy loading per project (2-5 seconds, 3-4 API calls)
- * - Tier 3 (Bulk): Optional pre-load command (1-2 minutes for 50 projects)
- *
- * Features:
- * - 24-hour TTL caching via CacheManager
- * - Rate limit detection (ADO: 200 req/hour, stricter than JIRA)
- * - Per-project dependency caching
- * - Automatic cache invalidation on 404 errors
- *
- * @module integrations/ado/ado-dependency-loader
- */
-import { RateLimitChecker } from '../../core/cache/rate-limit-checker.js';
-import { consoleLogger } from '../../utils/logger.js';
-import { ProgressTracker } from '../../core/progress/progress-tracker.js';
-import { CancelationHandler } from '../../core/progress/cancelation-handler.js';
-/**
- * AdoDependencyLoader - Three-tier dependency loading with smart caching
- */
-export class AdoDependencyLoader {
-    constructor(options) {
-        this.adoClient = options.adoClient;
-        this.cacheManager = options.cacheManager;
-        this.rateLimitChecker = options.rateLimitChecker ?? new RateLimitChecker({ threshold: 20 }); // ADO stricter limit
-        this.logger = options.logger ?? consoleLogger;
-    }
-    /**
-     * Tier 1: Load project metadata only (init)
-     *
-     * Performance: < 5 seconds for 50 projects (1 API call)
-     * Cache: 24-hour TTL in `ado-projects.json`
-     *
-     * @param maxProjects Maximum projects to load (default: 50)
-     * @returns Array of project metadata
-     */
-    async loadProjectMetadata(maxProjects = 50) {
-        const cacheKey = 'ado-projects';
-        // Check cache first
-        const cached = await this.cacheManager.get(cacheKey);
-        if (cached) {
-            this.logger.log(`Cache hit: ${cacheKey} (${cached.projects.length} projects)`);
-            return cached.projects;
-        }
-        // Cache miss - fetch from API
-        this.logger.log(`Cache miss: ${cacheKey}, fetching from ADO API...`);
-        try {
-            // Use ADO search API for batch loading
-            const response = await this.adoClient.searchProjects({
-                top: maxProjects,
-            });
-            // Extract rate limit headers
-            const rateLimitHeaders = this.rateLimitChecker.extractHeaders(response);
-            const rateLimitCheck = this.rateLimitChecker.shouldProceed(rateLimitHeaders);
-            if (!rateLimitCheck.canProceed) {
-                this.logger.warn(`Rate limit warning: ${rateLimitCheck.reason}. Consider using cached data.`);
-            }
-            // Parse projects
-            const projects = response.value.map((project) => ({
-                id: project.id,
-                name: project.name,
-                description: project.description,
-                visibility: project.visibility || 'private',
-                state: project.state || 'wellFormed',
-            }));
-            // Cache result
-            await this.cacheManager.set(cacheKey, { projects });
-            this.logger.log(`Cached ${projects.length} projects with 24-hour TTL`);
-            return projects;
-        }
-        catch (error) {
-            // Check for rate limit error (429)
-            if (this.rateLimitChecker.isRateLimitError(error)) {
-                await this.rateLimitChecker.handleRateLimitError(error);
-                // Try to use stale cache
-                const staleCache = await this.cacheManager.getStale(cacheKey);
-                if (staleCache) {
-                    return staleCache.projects;
-                }
-            }
-            // Re-throw if not rate limit or no stale cache available
-            throw error;
-        }
-    }
-    /**
-     * Tier 2: Load dependencies for specific project (on-demand)
-     *
-     * Performance: 2-5 seconds per project (3-4 API calls, cached)
-     * Cache: 24-hour TTL in `ado-{PROJECT}-deps.json`
-     *
-     * @param projectName Project name or ID
-     * @returns Project dependencies
-     */
-    async loadProjectDependencies(projectName) {
-        const cacheKey = `ado-${projectName}-deps`;
-        // Check cache first
-        const cached = await this.cacheManager.get(cacheKey);
-        if (cached) {
-            this.logger.log(`Cache hit: ${cacheKey}`);
-            return cached;
-        }
-        // Cache miss - fetch from API
-        this.logger.log(`Cache miss: ${cacheKey}, fetching from ADO API...`);
-        try {
-            // Fetch area paths and teams in parallel
-            const [areaPathsResponse, teamsResponse] = await Promise.all([
-                this.adoClient.getAreaPaths(projectName, 10),
-                this.adoClient.getTeams(projectName),
-            ]);
-            // Flatten area path tree
-            const flattenAreaPaths = (node, parentPath = '') => {
-                const currentPath = parentPath ? `${parentPath}\\${node.name}` : node.name;
-                const result = [
-                    {
-                        id: node.id,
-                        name: node.name,
-                        path: currentPath,
-                        hasChildren: node.hasChildren || false,
-                    },
-                ];
-                if (node.children) {
-                    node.children.forEach((child) => {
-                        result.push(...flattenAreaPaths(child, currentPath));
-                    });
-                }
-                return result;
-            };
-            const areaPaths = areaPathsResponse ? flattenAreaPaths(areaPathsResponse) : [];
-            // Build dependencies object
-            const dependencies = {
-                projectId: projectName, // Will be updated if we get project details
-                projectName,
-                areaPaths,
-                teams: teamsResponse.map((team) => ({
-                    id: team.id,
-                    name: team.name,
-                    description: team.description,
-                })),
-                lastUpdated: new Date().toISOString(),
-            };
-            // Cache result
-            await this.cacheManager.set(cacheKey, dependencies);
-            this.logger.log(`Cached dependencies for ${projectName}: ${dependencies.areaPaths.length} area paths, ${dependencies.teams.length} teams`);
-            return dependencies;
-        }
-        catch (error) {
-            // Handle 404 (project not found) - invalidate cache
-            if (error.response?.status === 404) {
-                this.logger.warn(`Project ${projectName} not found (404), invalidating cache...`);
-                await this.cacheManager.delete(cacheKey);
-                throw new Error(`Project ${projectName} not found`);
-            }
-            // Handle rate limit errors
-            if (this.rateLimitChecker.isRateLimitError(error)) {
-                await this.rateLimitChecker.handleRateLimitError(error);
-                // Try to use stale cache
-                const staleCache = await this.cacheManager.getStale(cacheKey);
-                if (staleCache) {
-                    return staleCache;
-                }
-            }
-            // Re-throw if not handled
-            throw error;
-        }
-    }
-    /**
-     * Tier 3: Bulk pre-load all dependencies (optional command)
-     *
-     * Performance: 1-2 minutes for 50 projects (150-200 API calls, batched)
-     * Progress: Real-time progress tracking with ProgressTracker, cancelation with CancelationHandler
-     *
-     * @param projectNames Array of project names to preload
-     * @returns void (results cached)
-     */
-    async preloadAllDependencies(projectNames, options = {}) {
-        const { onProgress, signal } = options;
-        const total = projectNames.length;
-        this.logger.log(`Preloading dependencies for ${total} projects...`);
-        // Initialize ProgressTracker
-        const progressTracker = new ProgressTracker({
-            total,
-            label: 'Preloading ADO dependencies',
-            updateFrequency: 5, // Update every 5 projects
-            showEta: true,
-            logger: this.logger
-        });
-        // Initialize CancelationHandler
-        let succeeded = 0;
-        let failed = 0;
-        const cancelHandler = new CancelationHandler({
-            onSaveState: async () => {
-                this.logger.log(`\nPartial preload saved: ${succeeded}/${total} projects cached`);
-                this.logger.log(`Success: ${succeeded}, Failed: ${failed}`);
-            },
-            logger: this.logger
-        });
-        // Register SIGINT handler
-        cancelHandler.register();
-        for (let i = 0; i < total; i++) {
-            // Check for cancelation (both new handler and legacy signal)
-            if (cancelHandler.shouldCancel() || signal?.aborted) {
-                this.logger.warn('\n⚠️  Preload canceled by user');
-                this.logger.log(`\n💡 Resume with: sw:ado-preload-dependencies --resume`);
-                cancelHandler.unregister();
-                throw new Error('Preload canceled');
-            }
-            const projectName = projectNames[i];
-            try {
-                await this.loadProjectDependencies(projectName);
-                succeeded++;
-                // Update progress
-                progressTracker.update(projectName, 'success');
-                // Legacy callback support
-                if (onProgress) {
-                    onProgress(i + 1, total);
-                }
-            }
-            catch (error) {
-                failed++;
-                progressTracker.update(projectName, 'error');
-                this.logger.error(`Failed to preload ${projectName}: ${error.message}`);
-                // Continue with next project (don't fail entire batch)
-            }
-            // Add delay to avoid rate limiting (300ms between requests for ADO's stricter limits)
-            if (i < total - 1) {
-                await new Promise((resolve) => setTimeout(resolve, 300));
-            }
-        }
-        // Unregister handler and show final summary
-        cancelHandler.unregister();
-        progressTracker.finish(succeeded, failed, 0);
-    }
-}
-//# sourceMappingURL=ado-dependency-loader.js.map

package/dist/src/integrations/ado/ado-dependency-loader.js.map

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

package/dist/src/integrations/ado/area-path-mapper.d.ts

@@ -1,137 +0,0 @@
-/**
- * Azure DevOps Area Path Mapper
- *
- * Fetches, parses, and maps ADO area paths to SpecWeave project IDs.
- * Supports hierarchical area paths with granularity selection:
- * - Top-level only (e.g., Backend, Frontend)
- * - Two-level (e.g., Backend-API, Backend-Database)
- * - Full tree (all levels)
- *
- * Enables multi-project organization in ADO
- *
- * @module integrations/ado/area-path-mapper
- */
-import type { Logger } from '../../utils/logger.js';
-export interface AreaPathNode {
-    id: string;
-    name: string;
-    path: string;
-    level: number;
-    parentPath?: string;
-    children?: AreaPathNode[];
-    hasChildren: boolean;
-}
-export interface AdoCredentials {
-    organization: string;
-    pat: string;
-}
-export type AreaPathGranularity = 'top-level' | 'two-level' | 'full-tree';
-export interface AreaPathMapperOptions {
-    credentials: AdoCredentials;
-    project: string;
-    logger?: Logger;
-}
-/**
- * Area Path Mapper for Azure DevOps
- *
- * Fetches hierarchical area path structures and maps them to SpecWeave project IDs.
- */
-export declare class AreaPathMapper {
-    private credentials;
-    private project;
-    private logger;
-    private apiVersion;
-    constructor(options: AreaPathMapperOptions);
-    /**
-     * Fetch area path tree from ADO
-     *
-     * Fetches the full hierarchical area path structure for the project.
-     * Uses $depth=10 to get deep hierarchies.
-     *
-     * @returns Root area path node with children
-     */
-    fetchAreaPaths(): Promise<AreaPathNode>;
-    /**
-     * Parse area path tree recursively
-     *
-     * Converts ADO API response to normalized AreaPathNode tree structure.
-     *
-     * @param node - Raw ADO API node
-     * @param level - Current depth level (0 = root)
-     * @param parentPath - Parent area path
-     * @returns Parsed area path node
-     */
-    parseAreaPathTree(node: any, level: number, parentPath: string): AreaPathNode;
-    /**
-     * Map area path to SpecWeave project ID
-     *
-     * Converts hierarchical area path to kebab-case project ID.
-     * Excludes root project name.
-     *
-     * Examples:
-     * - "Platform/Backend/API" → "backend-api"
-     * - "Platform/Frontend" → "frontend"
-     * - "Platform" → "platform"
-     *
-     * @param areaPath - Full area path (e.g., "Platform/Backend/API")
-     * @returns Kebab-case project ID
-     */
-    mapToProjectId(areaPath: string): string;
-    /**
-     * Convert string to kebab-case
-     *
-     * @param str - Input string
-     * @returns Kebab-case string
-     */
-    private toKebabCase;
-    /**
-     * Flatten area paths with granularity selection
-     *
-     * Extracts nodes at specific level(s) from the tree.
-     *
-     * @param root - Root area path node
-     * @param granularity - Desired granularity level
-     * @returns Flattened array of nodes
-     */
-    flattenAreaPaths(root: AreaPathNode, granularity: AreaPathGranularity): AreaPathNode[];
-    /**
-     * Get nodes at specific level
-     *
-     * Recursively collects nodes at the target depth level.
-     * If a branch doesn't reach the target level, includes the deepest node in that branch.
-     *
-     * @param node - Current node
-     * @param targetLevel - Target depth level
-     * @returns Nodes at target level (or deepest available)
-     */
-    private getNodesByLevel;
-    /**
-     * Get all nodes (flatten entire tree)
-     *
-     * @param node - Root node
-     * @returns All nodes in tree
-     */
-    private getAllNodes;
-    /**
-     * Prompt user for granularity selection
-     *
-     * Interactive CLI prompt to select area path granularity.
-     *
-     * @param areaPathTree - Area path tree for preview
-     * @returns Selected granularity
-     */
-    promptAreaPathGranularity(areaPathTree: AreaPathNode): Promise<AreaPathGranularity>;
-    /**
-     * Get area path suggestions for project
-     *
-     * Analyzes area path tree and suggests best granularity based on structure.
-     *
-     * @param areaPathTree - Area path tree
-     * @returns Suggested granularity with reasoning
-     */
-    suggestGranularity(areaPathTree: AreaPathNode): {
-        suggested: AreaPathGranularity;
-        reasoning: string;
-    };
-}
-//# sourceMappingURL=area-path-mapper.d.ts.map

package/dist/src/integrations/ado/area-path-mapper.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"area-path-mapper.d.ts","sourceRoot":"","sources":["../../../../src/integrations/ado/area-path-mapper.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;GAYG;AAEH,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,uBAAuB,CAAC;AAGpD,MAAM,WAAW,YAAY;IAC3B,EAAE,EAAE,MAAM,CAAC;IACX,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,MAAM,CAAC;IACb,KAAK,EAAE,MAAM,CAAC;IACd,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,QAAQ,CAAC,EAAE,YAAY,EAAE,CAAC;IAC1B,WAAW,EAAE,OAAO,CAAC;CACtB;AAED,MAAM,WAAW,cAAc;IAC7B,YAAY,EAAE,MAAM,CAAC;IACrB,GAAG,EAAE,MAAM,CAAC;CACb;AAED,MAAM,MAAM,mBAAmB,GAAG,WAAW,GAAG,WAAW,GAAG,WAAW,CAAC;AAE1E,MAAM,WAAW,qBAAqB;IACpC,WAAW,EAAE,cAAc,CAAC;IAC5B,OAAO,EAAE,MAAM,CAAC;IAChB,MAAM,CAAC,EAAE,MAAM,CAAC;CACjB;AAED;;;;GAIG;AACH,qBAAa,cAAc;IACzB,OAAO,CAAC,WAAW,CAAiB;IACpC,OAAO,CAAC,OAAO,CAAS;IACxB,OAAO,CAAC,MAAM,CAAS;IACvB,OAAO,CAAC,UAAU,CAAS;gBAEf,OAAO,EAAE,qBAAqB;IAM1C;;;;;;;OAOG;IACG,cAAc,IAAI,OAAO,CAAC,YAAY,CAAC;IA6B7C;;;;;;;;;OASG;IACH,iBAAiB,CACf,IAAI,EAAE,GAAG,EACT,KAAK,EAAE,MAAM,EACb,UAAU,EAAE,MAAM,GACjB,YAAY;IAsBf;;;;;;;;;;;;;OAaG;IACH,cAAc,CAAC,QAAQ,EAAE,MAAM,GAAG,MAAM;IAaxC;;;;;OAKG;IACH,OAAO,CAAC,WAAW;IAQnB;;;;;;;;OAQG;IACH,gBAAgB,CACd,IAAI,EAAE,YAAY,EAClB,WAAW,EAAE,mBAAmB,GAC/B,YAAY,EAAE;IAgBjB;;;;;;;;;OASG;IACH,OAAO,CAAC,eAAe;IA4BvB;;;;;OAKG;IACH,OAAO,CAAC,WAAW;IAYnB;;;;;;;OAOG;IACG,yBAAyB,CAC7B,YAAY,EAAE,YAAY,GACzB,OAAO,CAAC,mBAAmB,CAAC;IA8B/B;;;;;;;OAOG;IACH,kBAAkB,CAAC,YAAY,EAAE,YAAY,GAAG;QAC9C,SAAS,EAAE,mBAAmB,CAAC;QAC/B,SAAS,EAAE,MAAM,CAAC;KACnB;CAiCF"}