specweave 0.30.5 → 0.30.8

package/dist/src/living-docs/epic-id-allocator.d.ts

@@ -102,7 +102,7 @@ export declare class EpicIdAllocator {
      * Create an Epic ID Allocator for a specific project
      *
      * @param projectRoot - Root directory of the SpecWeave project
-     * @param projectId - Project ID (e.g., "olysense", "parent"). Required for per-project epics.
+     * @param projectId - Project ID (e.g., "acme", "parent"). Required for per-project epics.
      * @param options - Optional configuration
      */
     constructor(projectRoot: string, projectId: string, options?: EpicIdAllocatorOptions);

package/dist/src/living-docs/epic-id-allocator.js

@@ -40,7 +40,7 @@ export class EpicIdAllocator {
      * Create an Epic ID Allocator for a specific project
      *
      * @param projectRoot - Root directory of the SpecWeave project
-     * @param projectId - Project ID (e.g., "olysense", "parent"). Required for per-project epics.
+     * @param projectId - Project ID (e.g., "acme", "parent"). Required for per-project epics.
      * @param options - Optional configuration
      */
     constructor(projectRoot, projectId, options) {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "specweave",
-  "version": "0.30.5",
+  "version": "0.30.8",
   "description": "Spec-driven development framework for Claude Code. AI-native workflow with living documentation, intelligent agents, and multilingual support (9 languages). Enterprise-grade traceability with permanent specs and temporary increments.",
   "type": "module",
   "main": "dist/index.js",

package/plugins/specweave-ado/commands/specweave-ado-close-workitem.md

@@ -165,9 +165,9 @@ Checking permissions...
   canUpdateStatus: true
 
 Resolving ADO profile...
-  Using: ado-nova-x-sandbox (from increment)
-  Organization: nova-systems
-  Project: Nova X Sandbox
+  Using: ado-my-project (from increment)
+  Organization: acme-corp
+  Project: My Project
 
 Validating completion...
   Tasks: 10/10 complete
@@ -176,13 +176,13 @@ Closing work item...
 
 ✅ Closed ADO Epic #12345
 
-Profile: ado-nova-x-sandbox
+Profile: ado-my-project
 Increment: 0005-payment-integration
 Status: 100% complete (10/10 tasks)
 Duration: 3 days
 
 Summary posted to ADO work item
-URL: https://dev.azure.com/nova-systems/Nova%20X%20Sandbox/_workitems/edit/12345
+URL: https://dev.azure.com/acme-corp/My%20Project/_workitems/edit/12345
 ```
 
 ### Permission Denied

package/plugins/specweave-ado/commands/specweave-ado-create-workitem.md

@@ -149,15 +149,15 @@ Claude: Checking ADO permissions...
         ✓ canUpdateExternalItems: true
 
         Resolving ADO profile...
-        ✓ Using profile: ado-nova-x-sandbox (from increment)
-        ✓ Organization: nova-systems
-        ✓ Project: Nova X Sandbox
+        ✓ Using profile: ado-my-project (from increment)
+        ✓ Organization: acme-corp
+        ✓ Project: My Project
 
         Creating work item...
         [Invokes ADO Manager Agent]
 
         ✅ Created ADO Epic #12345
-        URL: https://dev.azure.com/nova-systems/Nova%20X%20Sandbox/_workitems/edit/12345
+        URL: https://dev.azure.com/acme-corp/My%20Project/_workitems/edit/12345
 
 # If permission denied:
 Claude: Checking ADO permissions...

package/plugins/specweave-ado/commands/specweave-ado-sync.md

@@ -192,9 +192,9 @@ Checking permissions...
   canUpdateExternalItems: true
 
 Resolving ADO profile...
-  Using: ado-nova-x-sandbox (from increment)
-  Organization: nova-systems
-  Project: Nova X Sandbox
+  Using: ado-my-project (from increment)
+  Organization: acme-corp
+  Project: My Project
 
 Syncing...
 
@@ -210,8 +210,8 @@ TO ADO:
   Updated completion field: 60%
 
 Sync Complete!
-Profile: ado-nova-x-sandbox
-Work Item: https://dev.azure.com/nova-systems/Nova%20X%20Sandbox/_workitems/edit/12345
+Profile: ado-my-project
+Work Item: https://dev.azure.com/acme-corp/My%20Project/_workitems/edit/12345
 ```
 
 ### Permission Denied

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

@@ -11,7 +11,8 @@ class AdoProfileResolver {
    *
    * Priority:
    * 1. Increment's metadata.json -> external_sync.ado.profile
-   * 2. Config.json -> sync.activeProfile
+   * 2. Config.json -> sync.defaultProfile (v0.31.0+)
+   * 3. Config.json -> sync.activeProfile (legacy fallback)
    *
    * @param incrementId - Increment ID (e.g., "0093-my-feature")
    * @returns Profile resolution result
@@ -26,11 +27,12 @@ class AdoProfileResolver {
       };
     }
     const incrementProfile = await this.getIncrementProfile(incrementId);
-    const profileName = incrementProfile || config.sync?.activeProfile;
+    const globalDefaultProfile = config.sync?.defaultProfile ?? config.sync?.activeProfile;
+    const profileName = incrementProfile || globalDefaultProfile;
     if (!profileName) {
       return {
         success: false,
-        error: "No ADO profile configured. Set sync.activeProfile in config.json or external_sync.ado.profile in increment metadata.",
+        error: "No ADO profile configured. Set sync.defaultProfile in config.json or external_sync.ado.profile in increment metadata.",
         incrementId
       };
     }

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

@@ -4,10 +4,15 @@
  * Resolves the correct ADO profile to use for sync operations.
  * Priority:
  * 1. Increment's stored profile (metadata.json -> external_sync.ado.profile)
- * 2. Global activeProfile (config.json -> sync.activeProfile)
+ * 2. Global defaultProfile (config.json -> sync.defaultProfile)
+ * 3. Legacy: Global activeProfile (config.json -> sync.activeProfile)
  *
  * This allows each increment to sync to its designated ADO project
- * without requiring manual activeProfile switching.
+ * without requiring manual profile switching.
+ *
+ * NOTE (v0.31.0): Renamed from "activeProfile" to "defaultProfile" for clarity.
+ * The default profile is a FALLBACK, not a constraint. Bulk operations
+ * iterate ALL profiles.
  *
  * Usage:
  * ```typescript
@@ -105,6 +110,9 @@ interface ConfigProfile {
  * Sync config from config.json
  */
 interface SyncConfig {
+  /** @since v0.31.0 - preferred */
+  defaultProfile?: string;
+  /** @deprecated Use defaultProfile */
   activeProfile?: string;
   profiles?: Record<string, ConfigProfile>;
 }
@@ -135,7 +143,8 @@ export class AdoProfileResolver {
    *
    * Priority:
    * 1. Increment's metadata.json -> external_sync.ado.profile
-   * 2. Config.json -> sync.activeProfile
+   * 2. Config.json -> sync.defaultProfile (v0.31.0+)
+   * 3. Config.json -> sync.activeProfile (legacy fallback)
    *
    * @param incrementId - Increment ID (e.g., "0093-my-feature")
    * @returns Profile resolution result
@@ -154,13 +163,14 @@ export class AdoProfileResolver {
     // Try to get increment-specific profile first
     const incrementProfile = await this.getIncrementProfile(incrementId);
 
-    // Determine which profile to use
-    const profileName = incrementProfile || config.sync?.activeProfile;
+    // Determine which profile to use (defaultProfile preferred over activeProfile)
+    const globalDefaultProfile = config.sync?.defaultProfile ?? config.sync?.activeProfile;
+    const profileName = incrementProfile || globalDefaultProfile;
 
     if (!profileName) {
       return {
         success: false,
-        error: 'No ADO profile configured. Set sync.activeProfile in config.json or external_sync.ado.profile in increment metadata.',
+        error: 'No ADO profile configured. Set sync.defaultProfile in config.json or external_sync.ado.profile in increment metadata.',
         incrementId,
       };
     }

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

@@ -461,8 +461,8 @@ export async function createProjectFolders(
     case 'project-per-team':
       // Create folder for each project
       // CRITICAL FIX (2025-12-01): Use normalizeToProjectId() for consistent folder names
-      // Bug: Using raw project name created "Nova X Sandbox" folder while external-import.ts
-      // created "nova-x-sandbox", causing duplicate folders for the same ADO project
+      // Bug: Using raw project name created "My Project" folder while external-import.ts
+      // created "my-project", causing duplicate folders for the same ADO project
       for (const project of projects) {
         const normalizedName = normalizeToProjectId(project);
         const projectPath = path.join(specsPath, normalizedName);

package/src/templates/config.json.template

@@ -7,7 +7,7 @@
     "provider": "github",
     "includeStatus": true,
     "autoApplyLabels": true,
-    "activeProfile": "main",
+    "defaultProfile": "main",
 
     "settings": {
       "canUpsertInternalItems": false,