specweave 0.12.6 → 0.13.0

package/plugins/specweave-ado/lib/ado-client-v2.ts

@@ -13,6 +13,7 @@ import {
   SyncProfile,
   AdoConfig,
   TimeRangePreset,
+  SyncContainer,
 } from '../../../src/core/types/sync-profile';
 
 // ============================================================================
@@ -69,13 +70,18 @@ export interface UpdateWorkItemRequest {
 
 export class AdoClientV2 {
   private organization: string;
-  private project: string;
+  private project?: string; // Optional for multi-project mode
   private workItemType: string;
   private areaPath?: string;
   private iterationPath?: string;
   private baseUrl: string;
   private authHeader: string;
 
+  // Multi-project support
+  private containers?: SyncContainer[];
+  private customQuery?: string;
+  private isMultiProject: boolean;
+
   /**
    * Create ADO client from sync profile
    */
@@ -86,12 +92,27 @@ export class AdoClientV2 {
 
     const config = profile.config as AdoConfig;
     this.organization = config.organization;
-    this.project = config.project;
     this.workItemType = config.workItemType || 'Epic';
-    this.areaPath = config.areaPath;
-    this.iterationPath = config.iterationPath;
 
-    this.baseUrl = `https://dev.azure.com/${this.organization}/${this.project}`;
+    // Detect mode: single-project vs multi-project
+    if (config.containers && config.containers.length > 0) {
+      // Multi-project mode
+      this.isMultiProject = true;
+      this.containers = config.containers;
+      this.baseUrl = `https://dev.azure.com/${this.organization}`;
+    } else if (config.customQuery) {
+      // Custom WIQL query mode
+      this.isMultiProject = true;
+      this.customQuery = config.customQuery;
+      this.baseUrl = `https://dev.azure.com/${this.organization}`;
+    } else {
+      // Single-project mode (backward compatible)
+      this.isMultiProject = false;
+      this.project = config.project;
+      this.areaPath = config.areaPath;
+      this.iterationPath = config.iterationPath;
+      this.baseUrl = `https://dev.azure.com/${this.organization}/${this.project}`;
+    }
 
     // Basic Auth: base64(":PAT")
     this.authHeader =
@@ -125,7 +146,13 @@ export class AdoClientV2 {
    */
   async testConnection(): Promise<{ success: boolean; error?: string }> {
     try {
-      await this.request('GET', `/_apis/projects/${this.project}?api-version=7.1`);
+      if (this.isMultiProject) {
+        // Test org-level access
+        await this.request('GET', `https://dev.azure.com/${this.organization}/_apis/projects?api-version=7.1`);
+      } else {
+        // Test project-level access
+        await this.request('GET', `/_apis/projects/${this.project}?api-version=7.1`);
+      }
       return { success: true };
     } catch (error: any) {
       return { success: false, error: error.message };
@@ -307,9 +334,12 @@ export class AdoClientV2 {
    * Execute WIQL query
    */
   async queryWorkItems(wiql: string): Promise<WorkItem[]> {
-    const url = `/_apis/wit/wiql?api-version=7.1`;
+    // For multi-project, use org-level API
+    const queryUrl = this.isMultiProject
+      ? `https://dev.azure.com/${this.organization}/_apis/wit/wiql?api-version=7.1`
+      : `/_apis/wit/wiql?api-version=7.1`;
 
-    const queryResult: WorkItemQueryResult = await this.request('POST', url, {
+    const queryResult: WorkItemQueryResult = await this.request('POST', queryUrl, {
       query: wiql,
     });
 
@@ -319,7 +349,11 @@ export class AdoClientV2 {
 
     // Get full work item details (batch request)
     const ids = queryResult.workItems.map((wi) => wi.id);
-    const batchUrl = `/_apis/wit/workitemsbatch?api-version=7.1`;
+
+    // For multi-project, use org-level batch API
+    const batchUrl = this.isMultiProject
+      ? `https://dev.azure.com/${this.organization}/_apis/wit/workitemsbatch?api-version=7.1`
+      : `/_apis/wit/workitemsbatch?api-version=7.1`;
 
     const workItems = await this.request('POST', batchUrl, {
       ids,
@@ -332,6 +366,9 @@ export class AdoClientV2 {
         'System.ChangedDate',
         'System.WorkItemType',
         'System.Tags',
+        'System.AreaPath',
+        'System.IterationPath',
+        'System.TeamProject',
       ],
     });
 
@@ -352,7 +389,17 @@ export class AdoClientV2 {
       customEnd
     );
 
-    // WIQL query for time range
+    // Use custom query if provided
+    if (this.customQuery) {
+      return this.queryWorkItems(this.customQuery);
+    }
+
+    // Multi-project mode with containers
+    if (this.isMultiProject && this.containers) {
+      return this.queryWorkItemsAcrossContainers(since, until);
+    }
+
+    // Single-project mode (backward compatible)
     const wiql = `
       SELECT [System.Id], [System.Title], [System.State], [System.CreatedDate]
       FROM WorkItems
@@ -365,6 +412,83 @@ export class AdoClientV2 {
     return this.queryWorkItems(wiql);
   }
 
+  /**
+   * Query work items across multiple containers (multi-project)
+   */
+  private async queryWorkItemsAcrossContainers(
+    since: string,
+    until: string
+  ): Promise<WorkItem[]> {
+    if (!this.containers || this.containers.length === 0) {
+      return [];
+    }
+
+    const allWorkItems: WorkItem[] = [];
+
+    for (const container of this.containers) {
+      const wiql = this.buildContainerWIQL(container, since, until);
+
+      try {
+        const workItems = await this.queryWorkItems(wiql);
+        allWorkItems.push(...workItems);
+      } catch (error: any) {
+        console.error(`Failed to query container ${container.id}:`, error.message);
+        // Continue with other containers
+      }
+    }
+
+    return allWorkItems;
+  }
+
+  /**
+   * Build WIQL query for a specific container with filters
+   */
+  private buildContainerWIQL(
+    container: SyncContainer,
+    since: string,
+    until: string
+  ): string {
+    const conditions: string[] = [];
+
+    // Project filter
+    conditions.push(`[System.TeamProject] = '${container.id}'`);
+
+    // Time range
+    conditions.push(`[System.CreatedDate] >= '${since}'`);
+    conditions.push(`[System.CreatedDate] <= '${until}'`);
+
+    // Area paths filter
+    if (container.filters?.areaPaths && container.filters.areaPaths.length > 0) {
+      const areaPathConditions = container.filters.areaPaths
+        .map(ap => `[System.AreaPath] UNDER '${container.id}\\${ap}'`)
+        .join(' OR ');
+      conditions.push(`(${areaPathConditions})`);
+    }
+
+    // Work item types filter
+    if (container.filters?.workItemTypes && container.filters.workItemTypes.length > 0) {
+      const typeConditions = container.filters.workItemTypes
+        .map(type => `[System.WorkItemType] = '${type}'`)
+        .join(' OR ');
+      conditions.push(`(${typeConditions})`);
+    }
+
+    // Iteration paths filter
+    if (container.filters?.iterationPaths && container.filters.iterationPaths.length > 0) {
+      const iterationConditions = container.filters.iterationPaths
+        .map(ip => `[System.IterationPath] UNDER '${container.id}\\${ip}'`)
+        .join(' OR ');
+      conditions.push(`(${iterationConditions})`);
+    }
+
+    return `
+      SELECT [System.Id], [System.Title], [System.State], [System.CreatedDate], [System.WorkItemType]
+      FROM WorkItems
+      WHERE ${conditions.join('\n      AND ')}
+      ORDER BY [System.CreatedDate] DESC
+    `;
+  }
+
   /**
    * Calculate date range from preset
    */

package/plugins/specweave-ado/lib/ado-client.d.js

@@ -0,0 +1,4 @@
+var ado_client_d_default = AdoClient;
+export {
+  ado_client_d_default as default
+};

package/plugins/specweave-ado/lib/ado-client.d.ts

@@ -0,0 +1,112 @@
+/**
+ * Azure DevOps REST API Client
+ *
+ * Provides TypeScript interface to Azure DevOps REST API v7.1
+ * for work item management and SpecWeave integration.
+ *
+ * @see https://learn.microsoft.com/en-us/rest/api/azure/devops/
+ */
+export interface AdoConfig {
+    organization: string;
+    project: string;
+    personalAccessToken: string;
+    workItemType?: 'Epic' | 'Feature' | 'User Story';
+    areaPath?: string;
+    iterationPath?: string;
+}
+export interface WorkItem {
+    id: number;
+    rev: number;
+    fields: {
+        'System.Title': string;
+        'System.Description'?: string;
+        'System.State': string;
+        'System.AreaPath'?: string;
+        'System.IterationPath'?: string;
+        'System.Tags'?: string;
+        [key: string]: any;
+    };
+    _links: {
+        html: {
+            href: string;
+        };
+    };
+    url: string;
+}
+export interface WorkItemComment {
+    id: number;
+    text: string;
+    createdBy: {
+        displayName: string;
+    };
+    createdDate: string;
+}
+export interface CreateWorkItemRequest {
+    title: string;
+    description?: string;
+    areaPath?: string;
+    iterationPath?: string;
+    tags?: string[];
+}
+export interface UpdateWorkItemRequest {
+    state?: string;
+    title?: string;
+    description?: string;
+    tags?: string[];
+}
+export declare class AdoClient {
+    private config;
+    private baseUrl;
+    private authHeader;
+    constructor(config: AdoConfig);
+    /**
+     * Create a new work item
+     *
+     * @see https://learn.microsoft.com/en-us/rest/api/azure/devops/wit/work-items/create
+     */
+    createWorkItem(request: CreateWorkItemRequest): Promise<WorkItem>;
+    /**
+     * Get work item by ID
+     *
+     * @see https://learn.microsoft.com/en-us/rest/api/azure/devops/wit/work-items/get-work-item
+     */
+    getWorkItem(id: number): Promise<WorkItem>;
+    /**
+     * Update work item
+     *
+     * @see https://learn.microsoft.com/en-us/rest/api/azure/devops/wit/work-items/update
+     */
+    updateWorkItem(id: number, request: UpdateWorkItemRequest): Promise<WorkItem>;
+    /**
+     * Delete work item (move to Recycle Bin)
+     *
+     * @see https://learn.microsoft.com/en-us/rest/api/azure/devops/wit/work-items/delete
+     */
+    deleteWorkItem(id: number): Promise<void>;
+    /**
+     * Add comment to work item
+     *
+     * @see https://learn.microsoft.com/en-us/rest/api/azure/devops/wit/comments/add
+     */
+    addComment(workItemId: number, text: string): Promise<WorkItemComment>;
+    /**
+     * Get comments for work item
+     *
+     * @see https://learn.microsoft.com/en-us/rest/api/azure/devops/wit/comments/list
+     */
+    getComments(workItemId: number): Promise<WorkItemComment[]>;
+    /**
+     * Make HTTP request to ADO API
+     */
+    private request;
+    /**
+     * Test connection to ADO
+     */
+    testConnection(): Promise<boolean>;
+}
+/**
+ * Create ADO client from environment variables and config
+ */
+export declare function createAdoClient(config?: Partial<AdoConfig>): AdoClient;
+export default AdoClient;
+//# sourceMappingURL=ado-client.d.ts.map

package/plugins/specweave-ado/lib/ado-client.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ado-client.d.ts","sourceRoot":"","sources":["ado-client.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAQH,MAAM,WAAW,SAAS;IACxB,YAAY,EAAE,MAAM,CAAC;IACrB,OAAO,EAAE,MAAM,CAAC;IAChB,mBAAmB,EAAE,MAAM,CAAC;IAC5B,YAAY,CAAC,EAAE,MAAM,GAAG,SAAS,GAAG,YAAY,CAAC;IACjD,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,aAAa,CAAC,EAAE,MAAM,CAAC;CACxB;AAED,MAAM,WAAW,QAAQ;IACvB,EAAE,EAAE,MAAM,CAAC;IACX,GAAG,EAAE,MAAM,CAAC;IACZ,MAAM,EAAE;QACN,cAAc,EAAE,MAAM,CAAC;QACvB,oBAAoB,CAAC,EAAE,MAAM,CAAC;QAC9B,cAAc,EAAE,MAAM,CAAC;QACvB,iBAAiB,CAAC,EAAE,MAAM,CAAC;QAC3B,sBAAsB,CAAC,EAAE,MAAM,CAAC;QAChC,aAAa,CAAC,EAAE,MAAM,CAAC;QACvB,CAAC,GAAG,EAAE,MAAM,GAAG,GAAG,CAAC;KACpB,CAAC;IACF,MAAM,EAAE;QACN,IAAI,EAAE;YAAE,IAAI,EAAE,MAAM,CAAA;SAAE,CAAC;KACxB,CAAC;IACF,GAAG,EAAE,MAAM,CAAC;CACb;AAED,MAAM,WAAW,eAAe;IAC9B,EAAE,EAAE,MAAM,CAAC;IACX,IAAI,EAAE,MAAM,CAAC;IACb,SAAS,EAAE;QAAE,WAAW,EAAE,MAAM,CAAA;KAAE,CAAC;IACnC,WAAW,EAAE,MAAM,CAAC;CACrB;AAED,MAAM,WAAW,qBAAqB;IACpC,KAAK,EAAE,MAAM,CAAC;IACd,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,IAAI,CAAC,EAAE,MAAM,EAAE,CAAC;CACjB;AAED,MAAM,WAAW,qBAAqB;IACpC,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,IAAI,CAAC,EAAE,MAAM,EAAE,CAAC;CACjB;AAMD,qBAAa,SAAS;IACpB,OAAO,CAAC,MAAM,CAAY;IAC1B,OAAO,CAAC,OAAO,CAAS;IACxB,OAAO,CAAC,UAAU,CAAS;gBAEf,MAAM,EAAE,SAAS;IAY7B;;;;OAIG;IACG,cAAc,CAAC,OAAO,EAAE,qBAAqB,GAAG,OAAO,CAAC,QAAQ,CAAC;IAoDvE;;;;OAIG;IACG,WAAW,CAAC,EAAE,EAAE,MAAM,GAAG,OAAO,CAAC,QAAQ,CAAC;IAKhD;;;;OAIG;IACG,cAAc,CAAC,EAAE,EAAE,MAAM,EAAE,OAAO,EAAE,qBAAqB,GAAG,OAAO,CAAC,QAAQ,CAAC;IA0CnF;;;;OAIG;IACG,cAAc,CAAC,EAAE,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAS/C;;;;OAIG;IACG,UAAU,CAAC,UAAU,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,eAAe,CAAC;IAQ5E;;;;OAIG;IACG,WAAW,CAAC,UAAU,EAAE,MAAM,GAAG,OAAO,CAAC,eAAe,EAAE,CAAC;IAYjE;;OAEG;YACW,OAAO;IA+DrB;;OAEG;IACG,cAAc,IAAI,OAAO,CAAC,OAAO,CAAC;CAUzC;AAMD;;GAEG;AACH,wBAAgB,eAAe,CAAC,MAAM,GAAE,OAAO,CAAC,SAAS,CAAM,GAAG,SAAS,CAuB1E;AAMD,eAAe,SAAS,CAAC"}

package/plugins/specweave-ado/lib/ado-client.js

@@ -0,0 +1,248 @@
+import https from "https";
+class AdoClient {
+  constructor(config) {
+    this.config = config;
+    this.baseUrl = `https://dev.azure.com/${config.organization}/${config.project}`;
+    this.authHeader = "Basic " + Buffer.from(`:${config.personalAccessToken}`).toString("base64");
+  }
+  // ==========================================================================
+  // Work Item Operations
+  // ==========================================================================
+  /**
+   * Create a new work item
+   * 
+   * @see https://learn.microsoft.com/en-us/rest/api/azure/devops/wit/work-items/create
+   */
+  async createWorkItem(request) {
+    const workItemType = this.config.workItemType || "Epic";
+    const url = `${this.baseUrl}/_apis/wit/workitems/$${workItemType}?api-version=7.1`;
+    const operations = [
+      {
+        op: "add",
+        path: "/fields/System.Title",
+        value: request.title
+      }
+    ];
+    if (request.description) {
+      operations.push({
+        op: "add",
+        path: "/fields/System.Description",
+        value: `<pre>${request.description}</pre>`
+      });
+    }
+    if (request.areaPath || this.config.areaPath) {
+      operations.push({
+        op: "add",
+        path: "/fields/System.AreaPath",
+        value: request.areaPath || this.config.areaPath
+      });
+    }
+    if (request.iterationPath || this.config.iterationPath) {
+      operations.push({
+        op: "add",
+        path: "/fields/System.IterationPath",
+        value: request.iterationPath || this.config.iterationPath
+      });
+    }
+    if (request.tags && request.tags.length > 0) {
+      operations.push({
+        op: "add",
+        path: "/fields/System.Tags",
+        value: request.tags.join("; ")
+      });
+    }
+    const response = await this.request("POST", url, operations, {
+      "Content-Type": "application/json-patch+json"
+    });
+    return response;
+  }
+  /**
+   * Get work item by ID
+   * 
+   * @see https://learn.microsoft.com/en-us/rest/api/azure/devops/wit/work-items/get-work-item
+   */
+  async getWorkItem(id) {
+    const url = `${this.baseUrl}/_apis/wit/workitems/${id}?api-version=7.1`;
+    return this.request("GET", url);
+  }
+  /**
+   * Update work item
+   * 
+   * @see https://learn.microsoft.com/en-us/rest/api/azure/devops/wit/work-items/update
+   */
+  async updateWorkItem(id, request) {
+    const url = `${this.baseUrl}/_apis/wit/workitems/${id}?api-version=7.1`;
+    const operations = [];
+    if (request.state) {
+      operations.push({
+        op: "add",
+        path: "/fields/System.State",
+        value: request.state
+      });
+    }
+    if (request.title) {
+      operations.push({
+        op: "add",
+        path: "/fields/System.Title",
+        value: request.title
+      });
+    }
+    if (request.description) {
+      operations.push({
+        op: "add",
+        path: "/fields/System.Description",
+        value: `<pre>${request.description}</pre>`
+      });
+    }
+    if (request.tags) {
+      operations.push({
+        op: "add",
+        path: "/fields/System.Tags",
+        value: request.tags.join("; ")
+      });
+    }
+    return this.request("PATCH", url, operations, {
+      "Content-Type": "application/json-patch+json"
+    });
+  }
+  /**
+   * Delete work item (move to Recycle Bin)
+   * 
+   * @see https://learn.microsoft.com/en-us/rest/api/azure/devops/wit/work-items/delete
+   */
+  async deleteWorkItem(id) {
+    const url = `${this.baseUrl}/_apis/wit/workitems/${id}?api-version=7.1`;
+    await this.request("DELETE", url);
+  }
+  // ==========================================================================
+  // Comment Operations
+  // ==========================================================================
+  /**
+   * Add comment to work item
+   * 
+   * @see https://learn.microsoft.com/en-us/rest/api/azure/devops/wit/comments/add
+   */
+  async addComment(workItemId, text) {
+    const url = `${this.baseUrl}/_apis/wit/workitems/${workItemId}/comments?api-version=7.1-preview.3`;
+    const response = await this.request("POST", url, { text });
+    return response;
+  }
+  /**
+   * Get comments for work item
+   *
+   * @see https://learn.microsoft.com/en-us/rest/api/azure/devops/wit/comments/list
+   */
+  async getComments(workItemId) {
+    const url = `${this.baseUrl}/_apis/wit/workitems/${workItemId}/comments?api-version=7.1-preview.3`;
+    const response = await this.request("GET", url);
+    return response.comments || [];
+  }
+  // ==========================================================================
+  // Helper Methods
+  // ==========================================================================
+  /**
+   * Make HTTP request to ADO API
+   */
+  async request(method, url, body, additionalHeaders) {
+    return new Promise((resolve, reject) => {
+      const urlObj = new URL(url);
+      const options = {
+        hostname: urlObj.hostname,
+        port: 443,
+        path: urlObj.pathname + urlObj.search,
+        method,
+        headers: {
+          "Authorization": this.authHeader,
+          "Accept": "application/json",
+          ...body ? { "Content-Type": "application/json" } : {},
+          ...additionalHeaders
+        },
+        timeout: 3e4
+        // 30 second timeout
+      };
+      const req = https.request(options, (res) => {
+        let data = "";
+        res.on("data", (chunk) => {
+          data += chunk;
+        });
+        res.on("end", () => {
+          if (res.statusCode && res.statusCode >= 200 && res.statusCode < 300) {
+            try {
+              const parsed = data ? JSON.parse(data) : {};
+              resolve(parsed);
+            } catch (error) {
+              reject(new Error(`Failed to parse JSON response: ${error}`));
+            }
+          } else {
+            let errorMessage = `ADO API error: ${res.statusCode} ${res.statusMessage}`;
+            try {
+              const errorData = JSON.parse(data);
+              if (errorData.message) {
+                errorMessage += ` - ${errorData.message}`;
+              }
+            } catch {
+            }
+            reject(new Error(errorMessage));
+          }
+        });
+      });
+      req.on("error", (error) => {
+        reject(new Error(`HTTP request failed: ${error.message}`));
+      });
+      req.on("timeout", () => {
+        req.destroy();
+        reject(new Error(`HTTP request timeout after 30 seconds`));
+      });
+      if (body) {
+        req.write(JSON.stringify(body));
+      }
+      req.end();
+    });
+  }
+  /**
+   * Test connection to ADO
+   */
+  async testConnection() {
+    try {
+      const url = `${this.baseUrl}/_apis/wit/workitemtypes?api-version=7.1`;
+      await this.request("GET", url);
+      return true;
+    } catch (error) {
+      if (error instanceof Error) {
+        console.error(`[ADO Client] Connection test failed:`, {
+          message: error.message,
+          organization: this.config.organization,
+          project: this.config.project,
+          baseUrl: this.baseUrl
+        });
+      }
+      return false;
+    }
+  }
+}
+function createAdoClient(config = {}) {
+  const fullConfig = {
+    organization: config.organization || process.env.AZURE_DEVOPS_ORG || "",
+    project: config.project || process.env.AZURE_DEVOPS_PROJECT || "",
+    personalAccessToken: config.personalAccessToken || process.env.AZURE_DEVOPS_PAT || "",
+    workItemType: config.workItemType,
+    areaPath: config.areaPath,
+    iterationPath: config.iterationPath
+  };
+  if (!fullConfig.organization) {
+    throw new Error("ADO organization not configured");
+  }
+  if (!fullConfig.project) {
+    throw new Error("ADO project not configured");
+  }
+  if (!fullConfig.personalAccessToken) {
+    throw new Error("AZURE_DEVOPS_PAT not set");
+  }
+  return new AdoClient(fullConfig);
+}
+var ado_client_default = AdoClient;
+export {
+  AdoClient,
+  createAdoClient,
+  ado_client_default as default
+};

package/plugins/specweave-ado/lib/ado-client.js.map

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

package/plugins/specweave-ado/lib/ado-client.ts

@@ -217,7 +217,7 @@ export class AdoClient {
    * @see https://learn.microsoft.com/en-us/rest/api/azure/devops/wit/comments/add
    */
   async addComment(workItemId: number, text: string): Promise<WorkItemComment> {
-    const url = `${this.baseUrl}/_apis/wit/workitems/${workItemId}/comments?api-version=7.1`;
+    const url = `${this.baseUrl}/_apis/wit/workitems/${workItemId}/comments?api-version=7.1-preview.3`;
 
     const response = await this.request<WorkItemComment>('POST', url, { text });
 
@@ -226,11 +226,11 @@ export class AdoClient {
 
   /**
    * Get comments for work item
-   * 
+   *
    * @see https://learn.microsoft.com/en-us/rest/api/azure/devops/wit/comments/list
    */
   async getComments(workItemId: number): Promise<WorkItemComment[]> {
-    const url = `${this.baseUrl}/_apis/wit/workitems/${workItemId}/comments?api-version=7.1`;
+    const url = `${this.baseUrl}/_apis/wit/workitems/${workItemId}/comments?api-version=7.1-preview.3`;
 
     const response = await this.request<{ comments: WorkItemComment[] }>('GET', url);
 
@@ -261,8 +261,10 @@ export class AdoClient {
         headers: {
           'Authorization': this.authHeader,
           'Accept': 'application/json',
+          ...(body ? { 'Content-Type': 'application/json' } : {}),
           ...additionalHeaders,
         },
+        timeout: 30000, // 30 second timeout
       };
 
       const req = https.request(options, (res) => {
@@ -299,6 +301,11 @@ export class AdoClient {
         reject(new Error(`HTTP request failed: ${error.message}`));
       });
 
+      req.on('timeout', () => {
+        req.destroy();
+        reject(new Error(`HTTP request timeout after 30 seconds`));
+      });
+
       if (body) {
         req.write(JSON.stringify(body));
       }
@@ -317,6 +324,15 @@ export class AdoClient {
       await this.request('GET', url);
       return true;
     } catch (error) {
+      // Enhanced error logging for debugging
+      if (error instanceof Error) {
+        console.error(`[ADO Client] Connection test failed:`, {
+          message: error.message,
+          organization: this.config.organization,
+          project: this.config.project,
+          baseUrl: this.baseUrl,
+        });
+      }
       return false;
     }
   }