specweave 1.0.350 → 1.0.352

package/plugins/specweave/skills/team-lead/agents/testing.md

@@ -0,0 +1,57 @@
+You are the TESTING agent for increment [INCREMENT_ID].
+
+MASTER SPEC (SOURCE OF TRUTH):
+  The feature is fully specified in [MASTER_INCREMENT_PATH]/spec.md.
+  This spec defines scope, user stories, and acceptance criteria.
+  Your tests MUST cover ALL ACs from the master spec.
+  Read the master spec BEFORE planning any work.
+
+SKILLS TO INVOKE:
+  Skill({ skill: "testing:qa" })
+  Skill({ skill: "testing:e2e" })        // for E2E test suites
+  Skill({ skill: "testing:unit" })       // for unit test coverage
+
+FILE OWNERSHIP (WRITE access):
+  tests/**
+  __tests__/**
+  src/**/*.test.ts
+  src/**/*.test.tsx
+  src/**/*.spec.ts
+  e2e/**
+  playwright.config.ts  // if Playwright
+  cypress.config.ts     // if Cypress
+  test-utils/**
+  fixtures/**
+
+READ ACCESS: Any file in the repository
+
+WORKFLOW:
+  1. Set working directory to your assigned repo: cd repositories/{ORG}/{repo-name}
+  2. If .specweave/ doesn't exist in your repo, run: specweave init
+  3. Create YOUR increment in YOUR repo: .specweave/increments/[ID]/
+  4. Read the MASTER SPEC at [MASTER_INCREMENT_PATH]/spec.md for scope and ACs
+  5. Wait for ALL other agents to produce initial code
+  6. Create plan files (plan.md, tasks.md) for your increment
+  7. Send plan to team-lead and WAIT for approval:
+     SendMessage({ type: "message", recipient: "team-lead",
+       content: "PLAN_READY: [increment path]. [summary of test strategy, coverage plan].",
+       summary: "Testing plan ready for review" })
+  8. WAIT for "PLAN_APPROVED" message. If "PLAN_REJECTED", revise and re-submit.
+  9. Write unit tests for new services/components
+  10. Write integration tests for API endpoints
+  11. Write E2E tests for user journeys
+  12. Execute tasks autonomously: prefer /sw:auto for autonomous execution
+  13. Run all tests (unit + integration + E2E): npm test && npx playwright test
+  14. Do NOT signal completion until all tests pass -- if tests fail, fix and repeat
+  15. Run quality gate: /sw:grill
+  16. After auto completes, attempt closure via /sw:done
+  17. Signal completion via SendMessage to team-lead
+
+RULES:
+  - WRITE only to test files (listed above)
+  - READ any file for context
+  - Tests must cover all acceptance criteria from spec.md
+  - Follow existing test patterns and utilities
+  - E2E tests must include accessibility checks when applicable
+  - ALL repository operations MUST use `repositories/{ORG}/` directory structure
+  - Create .specweave/increments/ in YOUR assigned repo, NOT in the umbrella project root

package/plugins/specweave/skills/test-aware-planner/SKILL.md

@@ -1,5 +1,7 @@
 ---
 description: Generate tasks.md with embedded test plans in BDD format, one user story at a time to prevent crashes. Use for test-first task planning where each task includes Given/When/Then scenarios. Produces implementation tasks with inline test specifications.
+context: fork
+model: opus
 ---
 
 # Test-Aware Planner Skill

package/plugins/specweave-ado/hooks/post-task-completion.sh

@@ -10,7 +10,7 @@
 # Dependencies:
 # - Node.js for running sync scripts
 # - jq for JSON parsing
-# - metadata.json must have .ado.item field
+# - metadata.json must have .external_sync.ado.workItemId field (fallback: .ado.item)
 # - Azure DevOps PAT in .env
 
 set +e  # EMERGENCY FIX: Prevents Claude Code crashes
@@ -96,7 +96,7 @@ EOF
   exit 0
 fi
 
-ADO_ITEM=$(jq -r '.ado.item // empty' "$METADATA_FILE" 2>/dev/null)
+ADO_ITEM=$(jq -r '.external_sync.ado.workItemId // .ado.item // empty' "$METADATA_FILE" 2>/dev/null)
 
 if [ -z "$ADO_ITEM" ]; then
   echo "[$(date)] [ADO] ℹ️  No Azure DevOps work item linked to $CURRENT_INCREMENT, skipping sync" >> "$DEBUG_LOG" 2>/dev/null || true

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

@@ -41,6 +41,18 @@ class AdoClientV2 {
   // ==========================================================================
   // Authentication & Setup
   // ==========================================================================
+  /**
+   * Resolve PAT for an organization.
+   * Priority: AZURE_DEVOPS_PAT_{ORG_UPPER} > AZURE_DEVOPS_PAT > fallback
+   */
+  static resolvePatForOrg(organization, fallbackPat) {
+    const orgKey = `AZURE_DEVOPS_PAT_${organization.toUpperCase().replace(/-/g, "_")}`;
+    const orgPat = process.env[orgKey];
+    if (orgPat) return orgPat;
+    const genericPat = process.env.AZURE_DEVOPS_PAT;
+    if (genericPat) return genericPat;
+    return fallbackPat || "";
+  }
   /**
    * Test connection and authentication
    */
@@ -49,11 +61,16 @@ class AdoClientV2 {
       if (this.isMultiProject) {
         await this.request("GET", `https://dev.azure.com/${this.organization}/_apis/projects?api-version=7.1`);
       } else {
-        await this.request("GET", `/_apis/projects/${this.project}?api-version=7.1`);
+        await this.request("GET", `https://dev.azure.com/${this.organization}/_apis/projects/${this.project}?api-version=7.1`);
       }
       return { success: true };
     } catch (error) {
-      return { success: false, error: error.message };
+      const statusMatch = error.message?.match(/HTTP (\d+)/);
+      const status = statusMatch ? parseInt(statusMatch[1]) : 0;
+      let hint = "";
+      if (status === 401) hint = " (check your Personal Access Token)";
+      else if (status === 404) hint = " (check organization/project name)";
+      return { success: false, error: error.message + hint };
     }
   }
   // ==========================================================================
@@ -207,25 +224,32 @@ class AdoClientV2 {
     if (queryResult.workItems.length === 0) {
       return [];
     }
-    const ids = queryResult.workItems.map((wi) => wi.id);
+    const allIds = queryResult.workItems.map((wi) => wi.id);
     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,
-      fields: [
-        "System.Id",
-        "System.Title",
-        "System.Description",
-        "System.State",
-        "System.CreatedDate",
-        "System.ChangedDate",
-        "System.WorkItemType",
-        "System.Tags",
-        "System.AreaPath",
-        "System.IterationPath",
-        "System.TeamProject"
-      ]
-    });
-    return workItems.value || [];
+    const batchFields = [
+      "System.Id",
+      "System.Title",
+      "System.Description",
+      "System.State",
+      "System.CreatedDate",
+      "System.ChangedDate",
+      "System.WorkItemType",
+      "System.Tags",
+      "System.AreaPath",
+      "System.IterationPath",
+      "System.TeamProject"
+    ];
+    const PAGE_SIZE = 200;
+    const allWorkItems = [];
+    for (let i = 0; i < allIds.length; i += PAGE_SIZE) {
+      const pageIds = allIds.slice(i, i + PAGE_SIZE);
+      const workItems = await this.request("POST", batchUrl, {
+        ids: pageIds,
+        fields: batchFields
+      });
+      allWorkItems.push(...workItems.value || []);
+    }
+    return allWorkItems;
   }
   /**
    * List work items within time range
@@ -280,7 +304,13 @@ class AdoClientV2 {
     conditions.push(`[System.CreatedDate] >= '${since}'`);
     conditions.push(`[System.CreatedDate] <= '${until}'`);
     if (this.areaPaths && this.areaPaths.length > 0) {
-      const areaPathConditions = this.areaPaths.map((ap) => `[System.AreaPath] UNDER '${projectName}\\${ap}'`).join(" OR ");
+      const areaPathConditions = this.areaPaths.map((ap) => {
+        const normalizedAp = ap.replace(/\//g, "\\");
+        if (normalizedAp === projectName || normalizedAp.startsWith(`${projectName}\\`)) {
+          return `[System.AreaPath] UNDER '${normalizedAp}'`;
+        }
+        return `[System.AreaPath] UNDER '${projectName}\\${normalizedAp}'`;
+      }).join(" OR ");
       conditions.push(`(${areaPathConditions})`);
     }
     if (this.workItemTypes) {

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

@@ -137,6 +137,24 @@ export class AdoClientV2 {
   // Authentication & Setup
   // ==========================================================================
 
+  /**
+   * Resolve PAT for an organization.
+   * Priority: AZURE_DEVOPS_PAT_{ORG_UPPER} > AZURE_DEVOPS_PAT > fallback
+   */
+  static resolvePatForOrg(organization: string, fallbackPat?: string): string {
+    // Org-specific: AZURE_DEVOPS_PAT_CONTOSO (uppercased, hyphens → underscores)
+    const orgKey = `AZURE_DEVOPS_PAT_${organization.toUpperCase().replace(/-/g, '_')}`;
+    const orgPat = process.env[orgKey];
+    if (orgPat) return orgPat;
+
+    // Generic PAT
+    const genericPat = process.env.AZURE_DEVOPS_PAT;
+    if (genericPat) return genericPat;
+
+    // Fallback (e.g., profile-stored PAT)
+    return fallbackPat || '';
+  }
+
   /**
    * Test connection and authentication
    */
@@ -146,12 +164,17 @@ export class AdoClientV2 {
         // 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`);
+        // Test project-level access using absolute URL to avoid double project path
+        await this.request('GET', `https://dev.azure.com/${this.organization}/_apis/projects/${this.project}?api-version=7.1`);
       }
       return { success: true };
     } catch (error: any) {
-      return { success: false, error: error.message };
+      const statusMatch = error.message?.match(/HTTP (\d+)/);
+      const status = statusMatch ? parseInt(statusMatch[1]) : 0;
+      let hint = '';
+      if (status === 401) hint = ' (check your Personal Access Token)';
+      else if (status === 404) hint = ' (check organization/project name)';
+      return { success: false, error: error.message + hint };
     }
   }
 
@@ -344,32 +367,41 @@ export class AdoClientV2 {
       return [];
     }
 
-    // Get full work item details (batch request)
-    const ids = queryResult.workItems.map((wi) => wi.id);
+    // Get full work item details (batch request, paginated in chunks of 200)
+    const allIds = queryResult.workItems.map((wi) => wi.id);
 
     // 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,
-      fields: [
-        'System.Id',
-        'System.Title',
-        'System.Description',
-        'System.State',
-        'System.CreatedDate',
-        'System.ChangedDate',
-        'System.WorkItemType',
-        'System.Tags',
-        'System.AreaPath',
-        'System.IterationPath',
-        'System.TeamProject',
-      ],
-    });
+    const batchFields = [
+      'System.Id',
+      'System.Title',
+      'System.Description',
+      'System.State',
+      'System.CreatedDate',
+      'System.ChangedDate',
+      'System.WorkItemType',
+      'System.Tags',
+      'System.AreaPath',
+      'System.IterationPath',
+      'System.TeamProject',
+    ];
 
-    return workItems.value || [];
+    const PAGE_SIZE = 200;
+    const allWorkItems: WorkItem[] = [];
+
+    for (let i = 0; i < allIds.length; i += PAGE_SIZE) {
+      const pageIds = allIds.slice(i, i + PAGE_SIZE);
+      const workItems = await this.request('POST', batchUrl, {
+        ids: pageIds,
+        fields: batchFields,
+      });
+      allWorkItems.push(...(workItems.value || []));
+    }
+
+    return allWorkItems;
   }
 
   /**
@@ -457,7 +489,14 @@ export class AdoClientV2 {
     // Area paths filter (if configured)
     if (this.areaPaths && this.areaPaths.length > 0) {
       const areaPathConditions = this.areaPaths
-        .map((ap: string) => `[System.AreaPath] UNDER '${projectName}\\${ap}'`)
+        .map((ap: string) => {
+          // Avoid double-prepending project name if path already starts with it
+          const normalizedAp = ap.replace(/\//g, '\\');
+          if (normalizedAp === projectName || normalizedAp.startsWith(`${projectName}\\`)) {
+            return `[System.AreaPath] UNDER '${normalizedAp}'`;
+          }
+          return `[System.AreaPath] UNDER '${projectName}\\${normalizedAp}'`;
+        })
         .join(' OR ');
       conditions.push(`(${areaPathConditions})`);
     }

package/plugins/specweave-ado/lib/ado-duplicate-detector.js

@@ -53,11 +53,11 @@ class AdoDuplicateDetector {
     } catch (error) {
       this.logger.log(`\u26A0\uFE0F  Verification check failed: ${error.message}`);
       return {
-        success: true,
-        // Assume success on error
+        success: false,
         expectedCount,
-        actualCount: expectedCount,
-        duplicates: []
+        actualCount: -1,
+        duplicates: [],
+        error: `Verification failed: ${error.message}`
       };
     }
   }

package/plugins/specweave-ado/lib/ado-duplicate-detector.ts

@@ -122,11 +122,12 @@ export class AdoDuplicateDetector {
     } catch (error: any) {
       this.logger.log(`⚠️  Verification check failed: ${error.message}`);
       return {
-        success: true, // Assume success on error
+        success: false,
         expectedCount,
-        actualCount: expectedCount,
+        actualCount: -1,
         duplicates: [],
-      };
+        error: `Verification failed: ${error.message}`,
+      } as VerificationResult & { error: string };
     }
   }
 

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

@@ -33,16 +33,15 @@ async function buildHierarchicalWIQL(organization, pat, containers) {
         );
       }
     }
+    if (container.filters) {
+      const containerFilterClauses = buildFilterClauses(container.filters);
+      if (containerFilterClauses.length > 0) {
+        parts.push(...containerFilterClauses);
+      }
+    }
     projectClauses.push(`(${parts.join(" AND ")})`);
   }
   let whereClause = projectClauses.join(" OR ");
-  const filters = containers[0]?.filters;
-  if (filters) {
-    const filterClauses = buildFilterClauses(filters);
-    if (filterClauses.length > 0) {
-      whereClause = `(${whereClause}) AND ${filterClauses.join(" AND ")}`;
-    }
-  }
   return `
     SELECT [System.Id], [System.Title], [System.Description], [System.State],
            [System.CreatedDate], [System.ChangedDate], [System.WorkItemType],
@@ -91,11 +90,18 @@ function addTimeRangeFilter(wiql, timeRange) {
   }
   const { since, until } = calculateTimeRange(timeRange);
   const timeFilter = `[System.CreatedDate] >= '${since}' AND [System.CreatedDate] <= '${until}'`;
-  if (wiql.includes("ORDER BY")) {
-    return wiql.replace("ORDER BY", `AND ${timeFilter} ORDER BY`);
-  } else {
+  const orderByRegex = /\bORDER\s+BY\b/i;
+  const match = wiql.match(orderByRegex);
+  if (match && match.index !== void 0) {
+    const before = wiql.substring(0, match.index).trimEnd();
+    const after = wiql.substring(match.index);
+    return `${before} AND ${timeFilter} ${after}`;
+  }
+  const whereRegex = /\bWHERE\b/i;
+  if (whereRegex.test(wiql)) {
     return `${wiql} AND ${timeFilter}`;
   }
+  return `${wiql} WHERE ${timeFilter}`;
 }
 function calculateTimeRange(timeRange) {
   const now = /* @__PURE__ */ new Date();
@@ -179,6 +185,10 @@ async function fetchWorkItemsFiltered(config, pat, timeRange) {
   const baseWiql = await buildHierarchicalWIQL(organization, pat, containers);
   const wiql = addTimeRangeFilter(baseWiql, timeRange);
   console.log("\u{1F50D} Fetching work items (FILTERED strategy):", wiql);
+  const uniqueProjects = new Set(containers.map((c) => c.id));
+  if (uniqueProjects.size > 1) {
+    return executeQueryOrgLevel(organization, pat, wiql);
+  }
   const project = containers[0].id;
   return executeQuery(organization, project, pat, wiql);
 }
@@ -208,7 +218,34 @@ async function executeQuery(organization, project, pat, wiql) {
   });
   return response.value || [];
 }
-function makeRequest(url, pat, method = "GET", body) {
+async function executeQueryOrgLevel(organization, pat, wiql) {
+  const baseUrl = `https://dev.azure.com/${organization}`;
+  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 [];
+  }
+  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 || [];
+}
+const DEFAULT_REQUEST_TIMEOUT_MS = 3e4;
+function makeRequest(url, pat, method = "GET", body, timeoutMs = DEFAULT_REQUEST_TIMEOUT_MS) {
   return new Promise((resolve, reject) => {
     const { hostname, pathname, search } = new URL(url);
     const authHeader = "Basic " + Buffer.from(`:${pat}`).toString("base64");
@@ -223,7 +260,8 @@ function makeRequest(url, pat, method = "GET", body) {
       hostname,
       path: pathname + search,
       method,
-      headers
+      headers,
+      timeout: timeoutMs
     };
     const req = https.request(options, (res) => {
       let data = "";
@@ -243,6 +281,10 @@ function makeRequest(url, pat, method = "GET", body) {
         }
       });
     });
+    req.on("timeout", () => {
+      req.destroy();
+      reject(new Error(`ADO request timed out after ${timeoutMs}ms: ${method} ${url}`));
+    });
     req.on("error", (error) => {
       reject(error);
     });

package/plugins/specweave-ado/lib/ado-hierarchical-sync.ts

@@ -81,6 +81,14 @@ export async function buildHierarchicalWIQL(
       }
     }
 
+    // Per-container filters (each container applies its own filters)
+    if (container.filters) {
+      const containerFilterClauses = buildFilterClauses(container.filters);
+      if (containerFilterClauses.length > 0) {
+        parts.push(...containerFilterClauses);
+      }
+    }
+
     // Combine parts with AND
     projectClauses.push(`(${parts.join(' AND ')})`);
   }
@@ -88,15 +96,6 @@ export async function buildHierarchicalWIQL(
   // 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],
@@ -185,15 +184,29 @@ function addTimeRangeFilter(wiql: string, timeRange: string): string {
 
   const { since, until } = calculateTimeRange(timeRange as TimeRangePreset);
 
-  // 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 {
+  // Find the last ORDER BY outside of string literals (case-insensitive)
+  // Strategy: find ORDER BY keyword, ensuring it's not inside single quotes
+  const orderByRegex = /\bORDER\s+BY\b/i;
+  const match = wiql.match(orderByRegex);
+
+  if (match && match.index !== undefined) {
+    // Insert AND timeFilter before ORDER BY
+    const before = wiql.substring(0, match.index).trimEnd();
+    const after = wiql.substring(match.index);
+    return `${before} AND ${timeFilter} ${after}`;
+  }
+
+  // No ORDER BY — check if there's a WHERE clause
+  const whereRegex = /\bWHERE\b/i;
+  if (whereRegex.test(wiql)) {
+    // Append to existing WHERE clause
     return `${wiql} AND ${timeFilter}`;
   }
+
+  // No WHERE clause at all — add one
+  return `${wiql} WHERE ${timeFilter}`;
 }
 
 /**
@@ -364,9 +377,15 @@ async function fetchWorkItemsFiltered(
 
   console.log('🔍 Fetching work items (FILTERED strategy):', wiql);
 
-  // Use first project for API endpoint (WIQL can query across projects)
-  const project = containers[0].id;
+  // Detect multi-project: if containers span more than one project, use org-level endpoint
+  const uniqueProjects = new Set(containers.map(c => c.id));
+  if (uniqueProjects.size > 1) {
+    // Cross-project: use org-level WIQL endpoint
+    return executeQueryOrgLevel(organization, pat, wiql);
+  }
 
+  // Single-project: use project-scoped endpoint
+  const project = containers[0].id;
   return executeQuery(organization, project, pat, wiql);
 }
 
@@ -419,13 +438,58 @@ async function executeQuery(
 }
 
 /**
- * Make HTTPS request to ADO API
+ * Execute WIQL query at org level (cross-project)
+ */
+async function executeQueryOrgLevel(
+  organization: string,
+  pat: string,
+  wiql: string
+): Promise<WorkItem[]> {
+  const baseUrl = `https://dev.azure.com/${organization}`;
+
+  // Execute query at org level
+  const queryUrl = `${baseUrl}/_apis/wit/wiql?api-version=7.1`;
+  const queryResult: any = await makeRequest(queryUrl, pat, 'POST', { query: wiql });
+
+  if (!queryResult.workItems || queryResult.workItems.length === 0) {
+    return [];
+  }
+
+  // Get full work item details (batch request at org level)
+  const ids = queryResult.workItems.map((wi: any) => wi.id);
+  const batchUrl = `${baseUrl}/_apis/wit/workitemsbatch?api-version=7.1`;
+
+  const response: any = 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 || [];
+}
+
+/** Default request timeout in ms (configurable via ado.requestTimeoutMs) */
+const DEFAULT_REQUEST_TIMEOUT_MS = 30000;
+
+/**
+ * Make HTTPS request to ADO API with timeout
  */
 function makeRequest(
   url: string,
   pat: string,
   method: string = 'GET',
-  body?: any
+  body?: any,
+  timeoutMs: number = DEFAULT_REQUEST_TIMEOUT_MS
 ): Promise<any> {
   return new Promise((resolve, reject) => {
     const { hostname, pathname, search } = new URL(url);
@@ -446,6 +510,7 @@ function makeRequest(
       path: pathname + search,
       method,
       headers,
+      timeout: timeoutMs,
     };
 
     const req = https.request(options, (res) => {
@@ -470,6 +535,11 @@ function makeRequest(
       });
     });
 
+    req.on('timeout', () => {
+      req.destroy();
+      reject(new Error(`ADO request timed out after ${timeoutMs}ms: ${method} ${url}`));
+    });
+
     req.on('error', (error) => {
       reject(error);
     });

package/plugins/specweave-ado/lib/ado-profile-resolver.js

@@ -26,7 +26,7 @@ class AdoProfileResolver {
       };
     }
     const incrementProfile = await this.getIncrementProfile(incrementId);
-    const globalDefaultProfile = config.sync?.defaultProfile;
+    const globalDefaultProfile = config.sync?.activeProfile ?? config.sync?.defaultProfile;
     const profileName = incrementProfile || globalDefaultProfile;
     if (!profileName) {
       return {

package/plugins/specweave-ado/lib/ado-profile-resolver.ts

@@ -108,6 +108,7 @@ interface ConfigProfile {
  * Sync config from config.json
  */
 interface SyncConfig {
+  activeProfile?: string;
   defaultProfile?: string;
   profiles?: Record<string, ConfigProfile>;
 }
@@ -158,7 +159,8 @@ export class AdoProfileResolver {
     const incrementProfile = await this.getIncrementProfile(incrementId);
 
     // Determine which profile to use
-    const globalDefaultProfile = config.sync?.defaultProfile;
+    // Read both activeProfile (canonical) and defaultProfile (legacy) with fallback
+    const globalDefaultProfile = config.sync?.activeProfile ?? config.sync?.defaultProfile;
     const profileName = incrementProfile || globalDefaultProfile;
 
     if (!profileName) {