specweave 0.33.2 → 0.33.4

package/CLAUDE.md

@@ -77,42 +77,118 @@ MetadataManager.updateStatus(incrementId, IncrementStatus.COMPLETED);
 // Only succeeds if current status is "ready_for_review"
 ```
 
-### 2c. spec.md MUST Have project: (and board: for 2-level) (v0.31.0+)
+### 2c. spec.md MUST Have project: (and board: for 2-level) - RESOLVED VALUES ONLY! (v0.34.0+)
 
-**Increment creation WITHOUT project context = SYNC FAILURE**
+**Increment creation WITHOUT resolved project context = SYNC FAILURE**
+
+**⛔ YOU MUST RUN `specweave context projects` BEFORE GENERATING spec.md!**
+
+```bash
+# MANDATORY FIRST STEP - run this BEFORE generating any spec.md:
+specweave context projects
+
+# Parse the JSON output:
+# 1-level: {"level": 1, "projects": [{"id": "frontend-app"}, {"id": "backend-api"}]}
+# 2-level: {"level": 2, "projects": [...], "boardsByProject": {"project-id": [{"id": "board-1"}]}}
+
+# USE the actual IDs from the output - NEVER use placeholders!
+```
 
 ```yaml
-# 1-level structure (single project or multi-project):
+# 1-level structure (RESOLVED values only):
 ---
 increment: 0001-feature-name
-project: my-project          # ← MANDATORY
+project: frontend-app        # ← RESOLVED from context API (NOT {{PROJECT_ID}})
 ---
 
-# 2-level structure (ADO area paths, JIRA boards):
+# 2-level structure (BOTH RESOLVED):
 ---
 increment: 0001-feature-name
-project: acme-corp           # ← MANDATORY
-board: digital-operations    # ← MANDATORY for 2-level
+project: acme-corp           # ← RESOLVED from projects[].id
+board: digital-operations    # ← RESOLVED from boardsByProject[project][].id
 ---
 ```
 
-**Detection**: Use `src/utils/structure-level-detector.ts`:
-```typescript
-import { detectStructureLevel } from './utils/structure-level-detector.js';
-const config = detectStructureLevel(projectRoot);
-// config.level === 1 → project required
-// config.level === 2 → project AND board required
+**Per-US Project/Board (v0.34.0+ MANDATORY):**
+```markdown
+### US-001: Login Form
+**Project**: frontend-app     # ← RESOLVED value, not placeholder!
+**Board**: ui-team            # ← RESOLVED value (2-level only)
 ```
 
-**VALIDATION RULES:**
+**VALIDATION RULES (ENFORCED BY HOOK):**
 ```
-❌ FORBIDDEN: Creating spec.md with project: {{PROJECT_ID}} (unresolved placeholder)
-❌ FORBIDDEN: Creating spec.md for 2-level without board: field
-❌ FORBIDDEN: Vague increments without knowing sync target
-✅ REQUIRED: Always select project (and board for 2-level) BEFORE generating spec.md
+❌ FORBIDDEN: Generating spec.md WITHOUT running "specweave context projects" first
+❌ FORBIDDEN: Using {{PROJECT_ID}}, {{BOARD_ID}}, {{RESOLVED_PROJECT}} placeholders
+❌ FORBIDDEN: Inventing project/board names not in the API response
+❌ FORBIDDEN: User stories without **Project**: field
+❌ FORBIDDEN: User stories in 2-level without **Board**: field
+✅ REQUIRED: Run "specweave context projects" and parse output BEFORE generating
+✅ REQUIRED: Each US has **Project**: with RESOLVED value from API
+✅ REQUIRED: Each US (2-level) has **Board**: with RESOLVED value from API
 ```
 
-**Pre-tool-use hook `spec-project-validator.sh` BLOCKS spec.md without required fields (2-level).**
+**Pre-tool-use hook `spec-project-validator.sh` BLOCKS:**
+- spec.md with `{{...}}` placeholders
+- spec.md without `project:` field
+- spec.md (2-level) without `board:` field
+- User stories with unresolved `**Project**:` or `**Board**:` placeholders
+
+### 2c-bis. Each User Story MUST Have **Project**: (and **Board**: for 2-level) (v0.34.0+)
+
+**CRITICAL 1:1 MAPPING RULE: Each User Story maps to EXACTLY ONE project and ONE board!**
+
+```markdown
+### US-001: Login Form UI
+**Project**: frontend-app     ← MANDATORY (exactly ONE project)
+**Board**: ui-team            ← MANDATORY for 2-level (exactly ONE board)
+**As a** user, I want a login form...
+
+### US-002: Auth API Endpoints
+**Project**: backend-api      ← DIFFERENT project = OK
+**Board**: api-team           ← DIFFERENT board = OK
+**As a** developer, I want JWT auth API...
+```
+
+**1:1 MAPPING ENFORCEMENT:**
+```
+❌ FORBIDDEN: **Project**: frontend-app, backend-api  (MULTIPLE projects)
+❌ FORBIDDEN: **Board**: ui-team, api-team           (MULTIPLE boards)
+❌ FORBIDDEN: User Story without **Project**: field
+
+✅ REQUIRED: Each US has exactly ONE **Project**: value
+✅ REQUIRED: Each US has exactly ONE **Board**: value (2-level)
+✅ CROSS-PROJECT: Split into separate USs per project
+```
+
+**Cross-project features → Create SEPARATE User Stories:**
+```markdown
+## OAuth Feature (Cross-Project)
+
+### US-001: OAuth Login Form
+**Project**: frontend-app     ← One project per US
+...
+
+### US-002: OAuth API Endpoints
+**Project**: backend-api      ← Different project = separate US
+...
+
+### US-003: OAuth Mobile Screen
+**Project**: mobile-app       ← Different project = separate US
+...
+```
+
+**Pre-tool-use hook `per-us-project-validator.sh` BLOCKS spec.md with:**
+- Missing `**Project**:` field per US
+- Missing `**Board**:` field per US (2-level)
+- Multiple comma-separated projects
+- Multiple comma-separated boards
+
+**Bypass (EMERGENCY ONLY):**
+```bash
+SPECWEAVE_FORCE_PROJECT=1   # Skip all validation
+SPECWEAVE_LEGACY_SPEC=1     # Allow legacy specs without per-US fields
+```
 
 ### 2d. NEVER Create Files in _features/ Folder (OBSOLETE v5.0.0+)
 
@@ -388,6 +464,44 @@ rm -f .specweave/state/.dedup-cache/*.lock
 
 **Mental model**: Bash = "run a program". Write/Edit/Read = "modify files".
 
+### 11. macOS Notifications - MUST Be Explicit (v0.33.3+)
+
+**Vague notifications = user confusion!** Every notification MUST clearly state:
+1. **WHO** sent it (always start with "SpecWeave:")
+2. **WHAT** happened (specific action, not vague alert)
+3. **ACTION** needed (or "No action needed" if informational)
+
+```
+❌ FORBIDDEN (vague, alarming):
+Title: "🚨 Zombie Cleanup"           ← What does this mean?!
+Sound: "Basso" (error sound)         ← Red alert icon, scary!
+Message: "Cleaned up 5 processes"    ← So what?
+
+✅ CORRECT (explicit, calm):
+Title: "SpecWeave: Cleanup Done"     ← Clear source
+Sound: "Pop" (neutral)               ← Not alarming
+Message: "Cleaned up 5 zombie processes. No action needed."
+```
+
+**Sound selection rules:**
+| Sound | When to use |
+|-------|-------------|
+| `Pop` | Success, completion (neutral) |
+| `Glass` | Informational (gentle) |
+| `Submarine` | Warning (not critical) |
+| `Basso` | ONLY critical errors requiring immediate action |
+
+**Use notification constants from `src/utils/notification-constants.ts`:**
+```typescript
+import { getTitleForType, buildNotificationMessage, getSoundForType } from './notification-constants.js';
+
+const title = getTitleForType('cleanup');  // "SpecWeave: Cleanup Done"
+const msg = buildNotificationMessage('cleanup', { count: 5 });  // "Cleaned up 5 zombie..."
+const sound = getSoundForType('cleanup');  // "Pop"
+```
+
+**Pre-commit hook validates notification messages in new code (v0.33.3+).**
+
 ---
 
 ## Development Setup

package/dist/plugins/specweave-ado/lib/per-us-sync.d.ts

@@ -0,0 +1,120 @@
+/**
+ * Per-US Azure DevOps Sync (v0.34.0+)
+ *
+ * Syncs each User Story to its explicitly declared project's ADO project/area.
+ * Uses the **Project**: and **Board**: fields in spec.md (NOT keyword-based classification).
+ *
+ * Key difference from multi-project-sync:
+ * - Multi-project sync uses keyword/heuristic classification
+ * - Per-US sync uses EXPLICIT **Project**: and **Board**: fields from spec.md
+ *
+ * @module per-us-sync
+ * @since v0.34.0
+ */
+import type { UserStoryData } from '../../../src/core/living-docs/types.js';
+import type { ProjectMappings } from '../../../src/core/types/config.js';
+import type { USExternalRefsMap } from '../../../src/core/types/increment-metadata.js';
+import { Logger } from '../../../src/utils/logger.js';
+/**
+ * Result of syncing a single US to ADO
+ */
+export interface USSyncResult {
+    usId: string;
+    projectId: string;
+    adoProject: string;
+    areaPath: string;
+    workItemId: number;
+    url: string;
+    action: 'created' | 'updated' | 'skipped';
+    error?: string;
+}
+/**
+ * Result of syncing all USs in an increment
+ */
+export interface PerUSSyncResult {
+    success: boolean;
+    synced: USSyncResult[];
+    failed: USSyncResult[];
+    externalRefs: USExternalRefsMap;
+    summary: {
+        total: number;
+        created: number;
+        updated: number;
+        skipped: number;
+        failed: number;
+    };
+}
+/**
+ * Options for per-US sync
+ */
+export interface PerUSSyncOptions {
+    dryRun?: boolean;
+    force?: boolean;
+    defaultProject?: string;
+    defaultBoard?: string;
+    logger?: Logger;
+}
+/**
+ * ADO client interface (to be injected)
+ */
+export interface AdoClient {
+    createWorkItem(project: string, workItemType: string, title: string, description: string, areaPath?: string): Promise<{
+        id: number;
+        url: string;
+    }>;
+    updateWorkItem(project: string, workItemId: number, title: string, description: string, areaPath?: string): Promise<void>;
+    searchWorkItems(project: string, query: string): Promise<Array<{
+        id: number;
+        fields: {
+            'System.Title': string;
+        };
+    }>>;
+    getWorkItemUrl(project: string, workItemId: number): string;
+}
+/**
+ * Per-US ADO Sync
+ *
+ * Syncs each US to its declared project's ADO project/area path.
+ * For 2-level structures, uses **Board**: to determine area path.
+ */
+export declare class PerUSAdoSync {
+    private projectMappings;
+    private adoClient;
+    private logger;
+    constructor(adoClient: AdoClient, projectMappings: ProjectMappings, options?: {
+        logger?: Logger;
+    });
+    /**
+     * Sync all user stories to their respective ADO projects
+     *
+     * @param userStories - User stories with explicit project/board fields
+     * @param featureId - Feature ID (e.g., "FS-137")
+     * @param options - Sync options
+     */
+    syncUserStories(userStories: UserStoryData[], featureId: string, options?: PerUSSyncOptions): Promise<PerUSSyncResult>;
+    /**
+     * Sync a single user story to ADO
+     *
+     * For 2-level structures:
+     * - **Project**: maps to ADO project
+     * - **Board**: maps to area path under the project
+     */
+    private syncUserStory;
+    /**
+     * Find existing work item by US ID in title
+     */
+    private findExistingWorkItem;
+    /**
+     * Build work item description from user story
+     */
+    private buildWorkItemDescription;
+    /**
+     * Group user stories by their explicit project field
+     */
+    private groupByProject;
+}
+/**
+ * Format per-US sync results for display
+ */
+export declare function formatPerUSSyncResults(result: PerUSSyncResult): string;
+//# sourceMappingURL=per-us-sync.d.ts.map

package/dist/plugins/specweave-ado/lib/per-us-sync.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"per-us-sync.d.ts","sourceRoot":"","sources":["../../../../plugins/specweave-ado/lib/per-us-sync.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;GAYG;AAEH,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,wCAAwC,CAAC;AAC5E,OAAO,KAAK,EAAE,eAAe,EAAc,MAAM,mCAAmC,CAAC;AACrF,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,+CAA+C,CAAC;AACvF,OAAO,EAAE,MAAM,EAAiB,MAAM,8BAA8B,CAAC;AAErE;;GAEG;AACH,MAAM,WAAW,YAAY;IAC3B,IAAI,EAAE,MAAM,CAAC;IACb,SAAS,EAAE,MAAM,CAAC;IAClB,UAAU,EAAE,MAAM,CAAC;IACnB,QAAQ,EAAE,MAAM,CAAC;IACjB,UAAU,EAAE,MAAM,CAAC;IACnB,GAAG,EAAE,MAAM,CAAC;IACZ,MAAM,EAAE,SAAS,GAAG,SAAS,GAAG,SAAS,CAAC;IAC1C,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB;AAED;;GAEG;AACH,MAAM,WAAW,eAAe;IAC9B,OAAO,EAAE,OAAO,CAAC;IACjB,MAAM,EAAE,YAAY,EAAE,CAAC;IACvB,MAAM,EAAE,YAAY,EAAE,CAAC;IACvB,YAAY,EAAE,iBAAiB,CAAC;IAChC,OAAO,EAAE;QACP,KAAK,EAAE,MAAM,CAAC;QACd,OAAO,EAAE,MAAM,CAAC;QAChB,OAAO,EAAE,MAAM,CAAC;QAChB,OAAO,EAAE,MAAM,CAAC;QAChB,MAAM,EAAE,MAAM,CAAC;KAChB,CAAC;CACH;AAED;;GAEG;AACH,MAAM,WAAW,gBAAgB;IAC/B,MAAM,CAAC,EAAE,OAAO,CAAC;IACjB,KAAK,CAAC,EAAE,OAAO,CAAC;IAChB,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,MAAM,CAAC,EAAE,MAAM,CAAC;CACjB;AAED;;GAEG;AACH,MAAM,WAAW,SAAS;IACxB,cAAc,CACZ,OAAO,EAAE,MAAM,EACf,YAAY,EAAE,MAAM,EACpB,KAAK,EAAE,MAAM,EACb,WAAW,EAAE,MAAM,EACnB,QAAQ,CAAC,EAAE,MAAM,GAChB,OAAO,CAAC;QAAE,EAAE,EAAE,MAAM,CAAC;QAAC,GAAG,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC;IACxC,cAAc,CACZ,OAAO,EAAE,MAAM,EACf,UAAU,EAAE,MAAM,EAClB,KAAK,EAAE,MAAM,EACb,WAAW,EAAE,MAAM,EACnB,QAAQ,CAAC,EAAE,MAAM,GAChB,OAAO,CAAC,IAAI,CAAC,CAAC;IACjB,eAAe,CAAC,OAAO,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,GAAG,OAAO,CAAC,KAAK,CAAC;QAAE,EAAE,EAAE,MAAM,CAAC;QAAC,MAAM,EAAE;YAAE,cAAc,EAAE,MAAM,CAAA;SAAE,CAAA;KAAE,CAAC,CAAC,CAAC;IACpH,cAAc,CAAC,OAAO,EAAE,MAAM,EAAE,UAAU,EAAE,MAAM,GAAG,MAAM,CAAC;CAC7D;AAED;;;;;GAKG;AACH,qBAAa,YAAY;IACvB,OAAO,CAAC,eAAe,CAAkB;IACzC,OAAO,CAAC,SAAS,CAAY;IAC7B,OAAO,CAAC,MAAM,CAAS;gBAGrB,SAAS,EAAE,SAAS,EACpB,eAAe,EAAE,eAAe,EAChC,OAAO,GAAE;QAAE,MAAM,CAAC,EAAE,MAAM,CAAA;KAAO;IAOnC;;;;;;OAMG;IACG,eAAe,CACnB,WAAW,EAAE,aAAa,EAAE,EAC5B,SAAS,EAAE,MAAM,EACjB,OAAO,GAAE,gBAAqB,GAC7B,OAAO,CAAC,eAAe,CAAC;IAwF3B;;;;;;OAMG;YACW,aAAa;IAgF3B;;OAEG;YACW,oBAAoB;IAclC;;OAEG;IACH,OAAO,CAAC,wBAAwB;IAqChC;;OAEG;IACH,OAAO,CAAC,cAAc;CAiBvB;AAED;;GAEG;AACH,wBAAgB,sBAAsB,CAAC,MAAM,EAAE,eAAe,GAAG,MAAM,CAqCtE"}

package/dist/plugins/specweave-ado/lib/per-us-sync.js

@@ -0,0 +1,276 @@
+/**
+ * Per-US Azure DevOps Sync (v0.34.0+)
+ *
+ * Syncs each User Story to its explicitly declared project's ADO project/area.
+ * Uses the **Project**: and **Board**: fields in spec.md (NOT keyword-based classification).
+ *
+ * Key difference from multi-project-sync:
+ * - Multi-project sync uses keyword/heuristic classification
+ * - Per-US sync uses EXPLICIT **Project**: and **Board**: fields from spec.md
+ *
+ * @module per-us-sync
+ * @since v0.34.0
+ */
+import { consoleLogger } from '../../../src/utils/logger.js';
+/**
+ * Per-US ADO Sync
+ *
+ * Syncs each US to its declared project's ADO project/area path.
+ * For 2-level structures, uses **Board**: to determine area path.
+ */
+export class PerUSAdoSync {
+    constructor(adoClient, projectMappings, options = {}) {
+        this.adoClient = adoClient;
+        this.projectMappings = projectMappings;
+        this.logger = options.logger ?? consoleLogger;
+    }
+    /**
+     * Sync all user stories to their respective ADO projects
+     *
+     * @param userStories - User stories with explicit project/board fields
+     * @param featureId - Feature ID (e.g., "FS-137")
+     * @param options - Sync options
+     */
+    async syncUserStories(userStories, featureId, options = {}) {
+        const synced = [];
+        const failed = [];
+        const externalRefs = {};
+        // Group USs by their declared project
+        const groups = this.groupByProject(userStories, options.defaultProject);
+        this.logger.log(`📡 Per-US ADO Sync: ${userStories.length} USs across ${groups.size} projects`);
+        for (const [projectId, stories] of groups) {
+            // Get ADO mapping for this project
+            const mapping = this.projectMappings[projectId]?.ado;
+            if (!mapping) {
+                // No ADO mapping for this project
+                this.logger.warn(`   ⚠️  No ADO mapping for project "${projectId}" - skipping ${stories.length} USs`);
+                for (const story of stories) {
+                    failed.push({
+                        usId: story.id,
+                        projectId,
+                        adoProject: 'N/A',
+                        areaPath: '',
+                        workItemId: 0,
+                        url: '',
+                        action: 'skipped',
+                        error: `No ADO mapping for project "${projectId}"`
+                    });
+                }
+                continue;
+            }
+            // Sync each US to this project's ADO project
+            for (const story of stories) {
+                try {
+                    const result = await this.syncUserStory(story, mapping, featureId, options);
+                    synced.push({
+                        ...result,
+                        projectId
+                    });
+                    // Build external ref
+                    if (!options.dryRun && result.action !== 'skipped') {
+                        externalRefs[story.id] = {
+                            ado: {
+                                provider: 'ado',
+                                issueNumber: result.workItemId,
+                                url: result.url,
+                                targetProject: projectId,
+                                lastSynced: new Date().toISOString()
+                            }
+                        };
+                    }
+                }
+                catch (error) {
+                    failed.push({
+                        usId: story.id,
+                        projectId,
+                        adoProject: mapping.project,
+                        areaPath: mapping.areaPath || '',
+                        workItemId: 0,
+                        url: '',
+                        action: 'skipped',
+                        error: error instanceof Error ? error.message : String(error)
+                    });
+                }
+            }
+        }
+        // Calculate summary
+        const created = synced.filter(r => r.action === 'created').length;
+        const updated = synced.filter(r => r.action === 'updated').length;
+        const skipped = synced.filter(r => r.action === 'skipped').length;
+        return {
+            success: failed.length === 0,
+            synced,
+            failed,
+            externalRefs,
+            summary: {
+                total: userStories.length,
+                created,
+                updated,
+                skipped,
+                failed: failed.length
+            }
+        };
+    }
+    /**
+     * Sync a single user story to ADO
+     *
+     * For 2-level structures:
+     * - **Project**: maps to ADO project
+     * - **Board**: maps to area path under the project
+     */
+    async syncUserStory(story, mapping, featureId, options) {
+        const title = `[${featureId}][${story.id}] ${story.title}`;
+        const description = this.buildWorkItemDescription(story, featureId);
+        // Determine area path:
+        // - Use story.board if available (2-level structure)
+        // - Fall back to mapping.areaPath
+        // - Fall back to project root
+        let areaPath = mapping.areaPath || mapping.project;
+        if (story.board) {
+            // 2-level structure: append board as area path segment
+            areaPath = `${mapping.project}\\${story.board}`;
+        }
+        if (options.dryRun) {
+            this.logger.log(`   🔍 [DRY-RUN] Would sync ${story.id} to ${mapping.project} (area: ${areaPath})`);
+            return {
+                usId: story.id,
+                projectId: story.project || 'unknown',
+                adoProject: mapping.project,
+                areaPath,
+                workItemId: 0,
+                url: '',
+                action: 'skipped'
+            };
+        }
+        // Check for existing work item
+        const existingItem = await this.findExistingWorkItem(mapping.project, story.id);
+        if (existingItem) {
+            // Update existing work item
+            await this.adoClient.updateWorkItem(mapping.project, existingItem.id, title, description, areaPath);
+            this.logger.log(`   🔄 Updated ${story.id} → ${mapping.project}/${existingItem.id}`);
+            return {
+                usId: story.id,
+                projectId: story.project || 'unknown',
+                adoProject: mapping.project,
+                areaPath,
+                workItemId: existingItem.id,
+                url: this.adoClient.getWorkItemUrl(mapping.project, existingItem.id),
+                action: 'updated'
+            };
+        }
+        else {
+            // Create new work item
+            const newItem = await this.adoClient.createWorkItem(mapping.project, 'User Story', title, description, areaPath);
+            this.logger.log(`   ✅ Created ${story.id} → ${mapping.project}/${newItem.id}`);
+            return {
+                usId: story.id,
+                projectId: story.project || 'unknown',
+                adoProject: mapping.project,
+                areaPath,
+                workItemId: newItem.id,
+                url: newItem.url,
+                action: 'created'
+            };
+        }
+    }
+    /**
+     * Find existing work item by US ID in title
+     */
+    async findExistingWorkItem(project, usId) {
+        try {
+            const query = `[System.Title] Contains '[${usId}]'`;
+            const results = await this.adoClient.searchWorkItems(project, query);
+            return results.length > 0 ? { id: results[0].id } : null;
+        }
+        catch {
+            return null;
+        }
+    }
+    /**
+     * Build work item description from user story
+     */
+    buildWorkItemDescription(story, featureId) {
+        const lines = [];
+        lines.push(`<h1>${story.title}</h1>`);
+        lines.push('');
+        if (story.description) {
+            lines.push(`<p>${story.description}</p>`);
+            lines.push('');
+        }
+        if (story.acceptanceCriteria && story.acceptanceCriteria.length > 0) {
+            lines.push('<h2>Acceptance Criteria</h2>');
+            lines.push('<ul>');
+            for (const ac of story.acceptanceCriteria) {
+                lines.push(`  <li>${ac}</li>`);
+            }
+            lines.push('</ul>');
+            lines.push('');
+        }
+        lines.push('<hr/>');
+        lines.push('');
+        lines.push(`<p><strong>Feature</strong>: ${featureId}</p>`);
+        lines.push(`<p><strong>User Story</strong>: ${story.id}</p>`);
+        if (story.project) {
+            lines.push(`<p><strong>Project</strong>: ${story.project}</p>`);
+        }
+        if (story.board) {
+            lines.push(`<p><strong>Board</strong>: ${story.board}</p>`);
+        }
+        lines.push('');
+        lines.push('<p><em>Auto-generated by SpecWeave</em></p>');
+        return lines.join('\n');
+    }
+    /**
+     * Group user stories by their explicit project field
+     */
+    groupByProject(userStories, defaultProject) {
+        const groups = new Map();
+        for (const story of userStories) {
+            const project = story.project || defaultProject || 'default';
+            if (!groups.has(project)) {
+                groups.set(project, []);
+            }
+            groups.get(project).push(story);
+        }
+        return groups;
+    }
+}
+/**
+ * Format per-US sync results for display
+ */
+export function formatPerUSSyncResults(result) {
+    const lines = [];
+    lines.push('');
+    lines.push('📊 Per-US ADO Sync Results');
+    lines.push('');
+    // Group by project
+    const byProject = new Map();
+    for (const r of [...result.synced, ...result.failed]) {
+        const existing = byProject.get(r.projectId) || [];
+        existing.push(r);
+        byProject.set(r.projectId, existing);
+    }
+    for (const [projectId, results] of byProject) {
+        const adoProject = results[0]?.adoProject || 'N/A';
+        const areaPath = results[0]?.areaPath || '';
+        lines.push(`**${projectId}** (→ ${adoProject}${areaPath ? ` [${areaPath}]` : ''}):`);
+        for (const r of results) {
+            const icon = r.action === 'created' ? '✅' :
+                r.action === 'updated' ? '🔄' :
+                    r.error ? '❌' : '⏭️';
+            if (r.workItemId > 0) {
+                lines.push(`  ${icon} ${r.usId} → ${r.adoProject}/${r.workItemId}`);
+            }
+            else if (r.error) {
+                lines.push(`  ${icon} ${r.usId}: ${r.error}`);
+            }
+            else {
+                lines.push(`  ${icon} ${r.usId} (${r.action})`);
+            }
+        }
+        lines.push('');
+    }
+    lines.push(`📈 Summary: ${result.summary.created} created, ${result.summary.updated} updated, ${result.summary.failed} failed`);
+    return lines.join('\n');
+}
+//# sourceMappingURL=per-us-sync.js.map

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

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

package/dist/plugins/specweave-github/lib/github-client-v2.d.ts

@@ -101,8 +101,11 @@ export declare class GitHubClientV2 {
      * Search for issue by exact title match
      *
      * IDEMPOTENCY: Use this before creating issues to prevent duplicates
+     *
+     * @param title - Title pattern to search for (e.g., "[FS-136][US-001]")
+     * @param includeClosedIssues - If true, searches all issues (open+closed). Default: false (open only)
      */
-    searchIssueByTitle(title: string): Promise<GitHubIssue | null>;
+    searchIssueByTitle(title: string, includeClosedIssues?: boolean): Promise<GitHubIssue | null>;
     /**
      * Update issue body
      */

package/dist/plugins/specweave-github/lib/github-client-v2.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"github-client-v2.d.ts","sourceRoot":"","sources":["../../../../plugins/specweave-github/lib/github-client-v2.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"github-client-v2.d.ts","sourceRoot":"","sources":["../../../../plugins/specweave-github/lib/github-client-v2.ts"],"names":[],"mappings":"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"}

package/dist/plugins/specweave-github/lib/github-client-v2.js

@@ -299,11 +299,14 @@ export class GitHubClientV2 {
      * Search for issue by exact title match
      *
      * IDEMPOTENCY: Use this before creating issues to prevent duplicates
+     *
+     * @param title - Title pattern to search for (e.g., "[FS-136][US-001]")
+     * @param includeClosedIssues - If true, searches all issues (open+closed). Default: false (open only)
      */
-    async searchIssueByTitle(title) {
+    async searchIssueByTitle(title, includeClosedIssues = false) {
         // Escape double quotes in title for gh search
         const escapedTitle = title.replace(/"/g, '\\"');
-        const result = await execFileNoThrow('gh', [
+        const args = [
             'issue',
             'list',
             '--repo',
@@ -314,7 +317,14 @@ export class GitHubClientV2 {
             'number,title,state,url,labels',
             '--limit',
             '50', // ✅ FIX: Increased from 1 to 50 to catch duplicates (Issue #0047)
-        ]);
+        ];
+        // v0.34.0: Add --state all to search closed issues too (for closure flow)
+        // Without this, closeGitHubIssuesForUserStories() can't find already-closed issues
+        // and reports "No GitHub issue found" instead of "already closed"
+        if (includeClosedIssues) {
+            args.push('--state', 'all');
+        }
+        const result = await execFileNoThrow('gh', args);
         if (result.exitCode !== 0) {
             // Search failed, return null (treat as not found)
             return null;