specweave 0.16.7 → 0.16.12

package/dist/plugins/specweave-ado/lib/ado-hierarchical-sync.js

@@ -0,0 +1,370 @@
+/**
+ * Azure DevOps Hierarchical Sync Implementation
+ *
+ * Supports three sync strategies:
+ * 1. Simple: One project, all work items (backward compatible)
+ * 2. Filtered: Multiple projects + area paths + filters
+ * 3. Custom: Raw WIQL query
+ */
+import { isSimpleStrategy, isFilteredStrategy, isCustomStrategy, } from '../../../src/core/types/sync-profile.js';
+import { getAreaPaths } from './ado-board-resolver.js';
+import https from 'https';
+/**
+ * Build hierarchical WIQL query from containers
+ *
+ * Example output:
+ * SELECT [System.Id], [System.Title], [System.State]
+ * FROM WorkItems
+ * WHERE (
+ *   ([System.TeamProject] = 'PROJECT-A' AND [System.AreaPath] UNDER 'PROJECT-A\\Team Alpha')
+ *   OR
+ *   ([System.TeamProject] = 'PROJECT-B' AND [System.AreaPath] UNDER 'PROJECT-B\\Platform')
+ * )
+ * AND [System.WorkItemType] IN ('User Story', 'Bug')
+ * AND [System.State] IN ('Active', 'New')
+ *
+ * @param organization Organization name
+ * @param pat Personal Access Token
+ * @param containers Array of containers (projects) with filters
+ * @returns WIQL query string
+ */
+export async function buildHierarchicalWIQL(organization, pat, containers) {
+    const projectClauses = [];
+    for (const container of containers) {
+        const parts = [];
+        // Project clause
+        parts.push(`[System.TeamProject] = '${container.id}'`);
+        // Area path filtering (sub-organizations)
+        if (container.subOrganizations && container.subOrganizations.length > 0) {
+            try {
+                const areaPaths = await getAreaPaths(organization, container.id, pat, container.subOrganizations);
+                if (areaPaths.length > 0) {
+                    const areaPathClauses = areaPaths
+                        .map((path) => `[System.AreaPath] UNDER '${path}'`)
+                        .join(' OR ');
+                    parts.push(`(${areaPathClauses})`);
+                }
+                else {
+                    console.warn(`⚠️  No valid area paths found for project ${container.id}, syncing all areas`);
+                }
+            }
+            catch (error) {
+                console.warn(`⚠️  Failed to resolve area paths for ${container.id}, syncing all areas:`, error.message);
+            }
+        }
+        // Combine parts with AND
+        projectClauses.push(`(${parts.join(' AND ')})`);
+    }
+    // Build WHERE clause with project clauses
+    let whereClause = projectClauses.join(' OR ');
+    // Add global filters (apply to all projects)
+    const filters = containers[0]?.filters;
+    if (filters) {
+        const filterClauses = buildFilterClauses(filters);
+        if (filterClauses.length > 0) {
+            whereClause = `(${whereClause}) AND ${filterClauses.join(' AND ')}`;
+        }
+    }
+    // Build complete WIQL query
+    return `
+    SELECT [System.Id], [System.Title], [System.Description], [System.State],
+           [System.CreatedDate], [System.ChangedDate], [System.WorkItemType],
+           [System.AreaPath], [System.IterationPath], [System.Tags]
+    FROM WorkItems
+    WHERE ${whereClause}
+    ORDER BY [System.CreatedDate] DESC
+  `.trim();
+}
+/**
+ * Build filter clauses from container filters
+ *
+ * @param filters Container filters
+ * @returns Array of WIQL filter clauses
+ */
+function buildFilterClauses(filters) {
+    const clauses = [];
+    // Work item types (ADO-specific)
+    if (filters.workItemTypes && filters.workItemTypes.length > 0) {
+        const types = filters.workItemTypes.map((t) => `'${t}'`).join(', ');
+        clauses.push(`[System.WorkItemType] IN (${types})`);
+    }
+    // Status categories (ADO uses State field)
+    if (filters.statusCategories && filters.statusCategories.length > 0) {
+        const states = filters.statusCategories.map((s) => `'${s}'`).join(', ');
+        clauses.push(`[System.State] IN (${states})`);
+    }
+    // Area paths (additional filtering beyond sub-organizations)
+    if (filters.areaPaths && filters.areaPaths.length > 0) {
+        const areaPathClauses = filters.areaPaths
+            .map((path) => `[System.AreaPath] UNDER '${path}'`)
+            .join(' OR ');
+        clauses.push(`(${areaPathClauses})`);
+    }
+    // Iteration paths (sprints in ADO)
+    if (filters.iterationPaths && filters.iterationPaths.length > 0) {
+        const iterationClauses = filters.iterationPaths
+            .map((path) => `[System.IterationPath] UNDER '${path}'`)
+            .join(' OR ');
+        clauses.push(`(${iterationClauses})`);
+    }
+    // Tags (labels in ADO)
+    if (filters.includeLabels && filters.includeLabels.length > 0) {
+        const tagClauses = filters.includeLabels
+            .map((tag) => `[System.Tags] CONTAINS '${tag}'`)
+            .join(' OR ');
+        clauses.push(`(${tagClauses})`);
+    }
+    // Exclude labels/tags
+    if (filters.excludeLabels && filters.excludeLabels.length > 0) {
+        for (const tag of filters.excludeLabels) {
+            clauses.push(`NOT [System.Tags] CONTAINS '${tag}'`);
+        }
+    }
+    // Assignees (assigned to)
+    if (filters.assignees && filters.assignees.length > 0) {
+        const assigneeClauses = filters.assignees
+            .map((assignee) => `[System.AssignedTo] = '${assignee}'`)
+            .join(' OR ');
+        clauses.push(`(${assigneeClauses})`);
+    }
+    return clauses;
+}
+/**
+ * Add time range filter to WIQL query
+ *
+ * @param wiql Base WIQL query
+ * @param timeRange Time range preset (1W, 1M, 3M, 6M, ALL)
+ * @returns WIQL with time range filter
+ */
+function addTimeRangeFilter(wiql, timeRange) {
+    if (timeRange === 'ALL') {
+        return wiql; // No time filter
+    }
+    const { since, until } = calculateTimeRange(timeRange);
+    // Add time range to WHERE clause
+    const timeFilter = `[System.CreatedDate] >= '${since}' AND [System.CreatedDate] <= '${until}'`;
+    // Insert before ORDER BY if present, otherwise append
+    if (wiql.includes('ORDER BY')) {
+        return wiql.replace('ORDER BY', `AND ${timeFilter} ORDER BY`);
+    }
+    else {
+        return `${wiql} AND ${timeFilter}`;
+    }
+}
+/**
+ * Calculate date range from time range preset
+ */
+function calculateTimeRange(timeRange) {
+    const now = new Date();
+    const since = new Date(now);
+    switch (timeRange) {
+        case '1W':
+            since.setDate(now.getDate() - 7);
+            break;
+        case '2W':
+            since.setDate(now.getDate() - 14);
+            break;
+        case '1M':
+            since.setMonth(now.getMonth() - 1);
+            break;
+        case '3M':
+            since.setMonth(now.getMonth() - 3);
+            break;
+        case '6M':
+            since.setMonth(now.getMonth() - 6);
+            break;
+        case '1Y':
+            since.setFullYear(now.getFullYear() - 1);
+            break;
+        case 'ALL':
+            return {
+                since: '1970-01-01T00:00:00Z',
+                until: now.toISOString(),
+            };
+    }
+    return {
+        since: since.toISOString(),
+        until: now.toISOString(),
+    };
+}
+/**
+ * Fetch work items hierarchically based on sync strategy
+ *
+ * @param profile Sync profile with strategy
+ * @param pat Personal Access Token
+ * @param timeRange Time range preset
+ * @returns Array of work items
+ */
+export async function fetchWorkItemsHierarchical(profile, pat, timeRange = '1M') {
+    const config = profile.config;
+    // Strategy 1: SIMPLE (backward compatible)
+    if (isSimpleStrategy(profile)) {
+        return fetchWorkItemsSimple(config, pat, timeRange);
+    }
+    // Strategy 2: CUSTOM (raw WIQL)
+    if (isCustomStrategy(profile)) {
+        return fetchWorkItemsCustom(config, pat, timeRange);
+    }
+    // Strategy 3: FILTERED (hierarchical)
+    if (isFilteredStrategy(profile)) {
+        return fetchWorkItemsFiltered(config, pat, timeRange);
+    }
+    // Default to simple if strategy not recognized
+    console.warn('⚠️  Unknown strategy, defaulting to simple');
+    return fetchWorkItemsSimple(config, pat, timeRange);
+}
+/**
+ * Fetch work items using SIMPLE strategy (one project, all work items)
+ *
+ * @param config ADO configuration
+ * @param pat Personal Access Token
+ * @param timeRange Time range preset
+ * @returns Array of work items
+ */
+async function fetchWorkItemsSimple(config, pat, timeRange) {
+    const organization = config.organization;
+    const project = config.project;
+    if (!project) {
+        throw new Error('Simple strategy requires project in config');
+    }
+    let wiql = `
+    SELECT [System.Id], [System.Title], [System.State], [System.CreatedDate]
+    FROM WorkItems
+    WHERE [System.TeamProject] = '${project}'
+  `.trim();
+    // Add time range
+    wiql = addTimeRangeFilter(wiql, timeRange);
+    console.log('🔍 Fetching work items (SIMPLE strategy):', wiql);
+    return executeQuery(organization, project, pat, wiql);
+}
+/**
+ * Fetch work items using CUSTOM strategy (raw WIQL)
+ *
+ * @param config ADO configuration
+ * @param pat Personal Access Token
+ * @param timeRange Time range preset
+ * @returns Array of work items
+ */
+async function fetchWorkItemsCustom(config, pat, timeRange) {
+    const organization = config.organization;
+    const project = config.project || 'DefaultProject';
+    const customQuery = config.customQuery;
+    if (!customQuery) {
+        throw new Error('Custom strategy requires customQuery in config');
+    }
+    // Add time range to custom query
+    const wiql = addTimeRangeFilter(customQuery, timeRange);
+    console.log('🔍 Fetching work items (CUSTOM strategy):', wiql);
+    return executeQuery(organization, project, pat, wiql);
+}
+/**
+ * Fetch work items using FILTERED strategy (multiple projects + area paths + filters)
+ *
+ * @param config ADO configuration
+ * @param pat Personal Access Token
+ * @param timeRange Time range preset
+ * @returns Array of work items
+ */
+async function fetchWorkItemsFiltered(config, pat, timeRange) {
+    const organization = config.organization;
+    const containers = config.containers;
+    if (!containers || containers.length === 0) {
+        throw new Error('Filtered strategy requires containers array in config');
+    }
+    // Build hierarchical WIQL
+    const baseWiql = await buildHierarchicalWIQL(organization, pat, containers);
+    // Add time range
+    const wiql = addTimeRangeFilter(baseWiql, timeRange);
+    console.log('🔍 Fetching work items (FILTERED strategy):', wiql);
+    // Use first project for API endpoint (WIQL can query across projects)
+    const project = containers[0].id;
+    return executeQuery(organization, project, pat, wiql);
+}
+/**
+ * Execute WIQL query and return work items
+ *
+ * @param organization Organization name
+ * @param project Project name
+ * @param pat Personal Access Token
+ * @param wiql WIQL query string
+ * @returns Array of work items
+ */
+async function executeQuery(organization, project, pat, wiql) {
+    const baseUrl = `https://dev.azure.com/${organization}/${project}`;
+    // Execute query
+    const queryUrl = `${baseUrl}/_apis/wit/wiql?api-version=7.1`;
+    const queryResult = await makeRequest(queryUrl, pat, 'POST', { query: wiql });
+    if (!queryResult.workItems || queryResult.workItems.length === 0) {
+        return [];
+    }
+    // Get full work item details (batch request)
+    const ids = queryResult.workItems.map((wi) => wi.id);
+    const batchUrl = `${baseUrl}/_apis/wit/workitemsbatch?api-version=7.1`;
+    const response = await makeRequest(batchUrl, pat, 'POST', {
+        ids,
+        fields: [
+            'System.Id',
+            'System.Title',
+            'System.Description',
+            'System.State',
+            'System.CreatedDate',
+            'System.ChangedDate',
+            'System.WorkItemType',
+            'System.AreaPath',
+            'System.IterationPath',
+            'System.Tags',
+        ],
+    });
+    return response.value || [];
+}
+/**
+ * Make HTTPS request to ADO API
+ */
+function makeRequest(url, pat, method = 'GET', body) {
+    return new Promise((resolve, reject) => {
+        const { hostname, pathname, search } = new URL(url);
+        const authHeader = 'Basic ' + Buffer.from(`:${pat}`).toString('base64');
+        const headers = {
+            Authorization: authHeader,
+            Accept: 'application/json',
+        };
+        if (body) {
+            headers['Content-Type'] = 'application/json';
+        }
+        const options = {
+            hostname,
+            path: pathname + search,
+            method,
+            headers,
+        };
+        const req = https.request(options, (res) => {
+            let data = '';
+            res.on('data', (chunk) => {
+                data += chunk;
+            });
+            res.on('end', () => {
+                try {
+                    const parsed = JSON.parse(data);
+                    if (res.statusCode && res.statusCode >= 200 && res.statusCode < 300) {
+                        resolve(parsed);
+                    }
+                    else {
+                        reject(new Error(`HTTP ${res.statusCode}: ${parsed.message || data}`));
+                    }
+                }
+                catch (error) {
+                    reject(new Error(`Failed to parse response: ${data}`));
+                }
+            });
+        });
+        req.on('error', (error) => {
+            reject(error);
+        });
+        // Send body if present
+        if (body) {
+            req.write(JSON.stringify(body));
+        }
+        req.end();
+    });
+}
+//# sourceMappingURL=ado-hierarchical-sync.js.map

package/dist/plugins/specweave-ado/lib/ado-hierarchical-sync.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"ado-hierarchical-sync.js","sourceRoot":"","sources":["../../../../plugins/specweave-ado/lib/ado-hierarchical-sync.ts"],"names":[],"mappings":"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"}

package/dist/plugins/specweave-ado/lib/ado-multi-project-sync.d.ts

@@ -0,0 +1,149 @@
+/**
+ * Azure DevOps Multi-Project Sync
+ *
+ * Supports two patterns:
+ * 1. **Multiple Projects**: Separate ADO projects for each team (FE, BE, MOBILE)
+ * 2. **Single Project + Area Paths**: One ADO project with area paths per team
+ *
+ * Hierarchical work item types:
+ * - Epic (> 13 story points): Large feature area
+ * - Feature (8-13 story points): Medium feature
+ * - User Story (3-7 story points): Standard user story
+ * - Task (1-2 story points): Small implementation task
+ *
+ * @module ado-multi-project-sync
+ */
+export interface AdoMultiProjectConfig {
+    organization: string;
+    pat: string;
+    projects?: string[];
+    project?: string;
+    areaPaths?: string[];
+    workItemTypes?: {
+        epic: string;
+        feature: string;
+        story: string;
+        task: string;
+    };
+    intelligentMapping?: boolean;
+    autoCreateEpics?: boolean;
+}
+export interface AdoWorkItem {
+    id: number;
+    rev: number;
+    fields: Record<string, any>;
+    url: string;
+}
+export interface AdoSyncResult {
+    project: string;
+    workItemId: number;
+    workItemType: string;
+    title: string;
+    url: string;
+    action: 'created' | 'updated' | 'skipped';
+    confidence?: number;
+}
+/**
+ * Azure DevOps Multi-Project Sync Client
+ */
+export declare class AdoMultiProjectSync {
+    private client;
+    private config;
+    constructor(config: AdoMultiProjectConfig);
+    /**
+     * Pre-flight validation: Verify all ADO projects exist
+     *
+     * @throws Error if any projects are missing
+     */
+    validateProjects(): Promise<void>;
+    /**
+     * Sync spec to ADO projects with intelligent mapping
+     *
+     * @param specPath Path to spec file
+     * @returns Array of sync results
+     */
+    syncSpec(specPath: string): Promise<AdoSyncResult[]>;
+    /**
+     * Pattern 1: Sync to multiple ADO projects (simple)
+     *
+     * Each team → separate ADO project
+     * - FE user stories → FE-Project
+     * - BE user stories → BE-Project
+     * - MOBILE user stories → MOBILE-Project
+     */
+    private syncMultipleProjects;
+    /**
+     * Pattern 2: Sync to single project with area paths (advanced)
+     *
+     * - Single ADO project with area paths for teams
+     * - Epic-level: Root area path
+     * - Story-level: Team-specific area paths
+     *
+     * Example:
+     * ADO Project: Shared-Project
+     *   Epic: User Authentication (Root area path)
+     *     User Story: Login UI (Area Path: Shared-Project\FE)
+     *     User Story: Auth API (Area Path: Shared-Project\BE)
+     *     User Story: Mobile Auth (Area Path: Shared-Project\MOBILE)
+     */
+    private syncAreaPathBased;
+    /**
+     * Create epic for project (Pattern 1: Multiple Projects)
+     */
+    private createEpicForProject;
+    /**
+     * Create epic in root area path (Pattern 2: Area Paths)
+     */
+    private createEpicInRootArea;
+    /**
+     * Create work item for user story (Pattern 1: Multiple Projects)
+     */
+    private createWorkItemForUserStory;
+    /**
+     * Create work item in area path (Pattern 2: Area Paths)
+     */
+    private createWorkItemInAreaPath;
+    /**
+     * Create work item via ADO REST API
+     */
+    private createWorkItem;
+    /**
+     * Link work items (parent-child relationship)
+     */
+    private linkWorkItems;
+    /**
+     * Map Jira-style item type to ADO work item type
+     */
+    private mapItemTypeToAdo;
+    /**
+     * Find ADO project name for project ID
+     *
+     * Maps project IDs to ADO project names:
+     * - FE → FE-Project
+     * - BE → BE-Project
+     * - MOBILE → MOBILE-Project
+     */
+    private findProjectForId;
+    /**
+     * Find area path for project ID
+     *
+     * Maps project IDs to area paths:
+     * - FE → FE
+     * - BE → BE
+     * - MOBILE → MOBILE
+     */
+    private findAreaPathForProjectId;
+}
+/**
+ * Format ADO sync results for display
+ */
+export declare function formatAdoSyncResults(results: AdoSyncResult[]): string;
+/**
+ * Validate ADO projects exist
+ *
+ * @param config ADO configuration
+ * @param projectNames Array of project names to validate
+ * @returns Validation results (missing projects)
+ */
+export declare function validateAdoProjects(config: AdoMultiProjectConfig, projectNames: string[]): Promise<string[]>;
+//# sourceMappingURL=ado-multi-project-sync.d.ts.map

package/dist/plugins/specweave-ado/lib/ado-multi-project-sync.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ado-multi-project-sync.d.ts","sourceRoot":"","sources":["../../../../plugins/specweave-ado/lib/ado-multi-project-sync.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;GAcG;AAWH,MAAM,WAAW,qBAAqB;IACpC,YAAY,EAAE,MAAM,CAAC;IACrB,GAAG,EAAE,MAAM,CAAC;IAGZ,QAAQ,CAAC,EAAE,MAAM,EAAE,CAAC;IAGpB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,SAAS,CAAC,EAAE,MAAM,EAAE,CAAC;IAGrB,aAAa,CAAC,EAAE;QACd,IAAI,EAAE,MAAM,CAAC;QACb,OAAO,EAAE,MAAM,CAAC;QAChB,KAAK,EAAE,MAAM,CAAC;QACd,IAAI,EAAE,MAAM,CAAC;KACd,CAAC;IAGF,kBAAkB,CAAC,EAAE,OAAO,CAAC;IAC7B,eAAe,CAAC,EAAE,OAAO,CAAC;CAC3B;AAED,MAAM,WAAW,WAAW;IAC1B,EAAE,EAAE,MAAM,CAAC;IACX,GAAG,EAAE,MAAM,CAAC;IACZ,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,CAAC;IAC5B,GAAG,EAAE,MAAM,CAAC;CACb;AAED,MAAM,WAAW,aAAa;IAC5B,OAAO,EAAE,MAAM,CAAC;IAChB,UAAU,EAAE,MAAM,CAAC;IACnB,YAAY,EAAE,MAAM,CAAC;IACrB,KAAK,EAAE,MAAM,CAAC;IACd,GAAG,EAAE,MAAM,CAAC;IACZ,MAAM,EAAE,SAAS,GAAG,SAAS,GAAG,SAAS,CAAC;IAC1C,UAAU,CAAC,EAAE,MAAM,CAAC;CACrB;AAED;;GAEG;AACH,qBAAa,mBAAmB;IAC9B,OAAO,CAAC,MAAM,CAAgB;IAC9B,OAAO,CAAC,MAAM,CAAwB;gBAE1B,MAAM,EAAE,qBAAqB;IAazC;;;;OAIG;IACG,gBAAgB,IAAI,OAAO,CAAC,IAAI,CAAC;IA0BvC;;;;;OAKG;IACG,QAAQ,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,aAAa,EAAE,CAAC;IAyB1D;;;;;;;OAOG;YACW,oBAAoB;IA2DlC;;;;;;;;;;;;;OAaG;YACW,iBAAiB;IA2C/B;;OAEG;YACW,oBAAoB;IAwClC;;OAEG;YACW,oBAAoB;IAyClC;;OAEG;YACW,0BAA0B;IAoDxC;;OAEG;YACW,wBAAwB;IAiDtC;;OAEG;YACW,cAAc;IAoB5B;;OAEG;YACW,aAAa;IAsB3B;;OAEG;IACH,OAAO,CAAC,gBAAgB;IAiBxB;;;;;;;OAOG;IACH,OAAO,CAAC,gBAAgB;IAyBxB;;;;;;;OAOG;IACH,OAAO,CAAC,wBAAwB;CAwBjC;AAED;;GAEG;AACH,wBAAgB,oBAAoB,CAAC,OAAO,EAAE,aAAa,EAAE,GAAG,MAAM,CAuCrE;AAED;;;;;;GAMG;AACH,wBAAsB,mBAAmB,CACvC,MAAM,EAAE,qBAAqB,EAC7B,YAAY,EAAE,MAAM,EAAE,GACrB,OAAO,CAAC,MAAM,EAAE,CAAC,CAmBnB"}