specweave 0.33.3 → 0.33.5

package/dist/src/sync/closure-metrics.js

@@ -0,0 +1,267 @@
+/**
+ * Closure Metrics - Telemetry for External Tool Sync Operations (v0.34.0)
+ *
+ * Tracks closure success/failure rates for GitHub, JIRA, and ADO.
+ * Persists metrics to .specweave/state/closure-metrics.json
+ *
+ * Usage:
+ *   const metrics = new ClosureMetrics(projectRoot);
+ *   metrics.recordClosure('github', 100, true); // Success
+ *   metrics.recordClosure('jira', 'TEST-123', false, 'Rate limited'); // Failure
+ *   metrics.getSummary(); // Get aggregated stats
+ */
+import { existsSync, readFileSync, writeFileSync, mkdirSync } from 'fs';
+import { join } from 'path';
+import { consoleLogger } from '../utils/logger.js';
+const METRICS_VERSION = 1;
+const MAX_RECORDS = 1000; // Keep last 1000 records
+const MAX_RECENT_ERRORS = 10; // Keep last 10 errors per tool
+export class ClosureMetrics {
+    constructor(options) {
+        this.operationStartTime = 0;
+        this.projectRoot = options.projectRoot;
+        this.currentIncrementId = options.incrementId || 'unknown';
+        this.logger = options.logger || consoleLogger;
+        const stateDir = join(this.projectRoot, '.specweave/state');
+        if (!existsSync(stateDir)) {
+            mkdirSync(stateDir, { recursive: true });
+        }
+        this.metricsFile = join(stateDir, 'closure-metrics.json');
+    }
+    /**
+     * Start timing an operation
+     */
+    startOperation() {
+        this.operationStartTime = Date.now();
+    }
+    /**
+     * Record a closure operation result
+     */
+    recordClosure(tool, itemId, success, error) {
+        const durationMs = this.operationStartTime > 0
+            ? Date.now() - this.operationStartTime
+            : undefined;
+        const record = {
+            tool,
+            itemId,
+            incrementId: this.currentIncrementId,
+            success,
+            error,
+            timestamp: new Date().toISOString(),
+            durationMs,
+        };
+        const metrics = this.loadMetrics();
+        metrics.records.push(record);
+        // Trim to max records
+        if (metrics.records.length > MAX_RECORDS) {
+            metrics.records = metrics.records.slice(-MAX_RECORDS);
+        }
+        // Update summary
+        this.updateSummary(metrics);
+        this.saveMetrics(metrics);
+        // Reset timer
+        this.operationStartTime = 0;
+    }
+    /**
+     * Record multiple closures in batch
+     */
+    recordBatch(tool, results) {
+        const metrics = this.loadMetrics();
+        for (const result of results) {
+            const record = {
+                tool,
+                itemId: result.itemId,
+                incrementId: this.currentIncrementId,
+                success: result.success,
+                error: result.error,
+                timestamp: new Date().toISOString(),
+            };
+            metrics.records.push(record);
+        }
+        // Trim to max records
+        if (metrics.records.length > MAX_RECORDS) {
+            metrics.records = metrics.records.slice(-MAX_RECORDS);
+        }
+        this.updateSummary(metrics);
+        this.saveMetrics(metrics);
+    }
+    /**
+     * Get metrics summary
+     */
+    getSummary() {
+        const metrics = this.loadMetrics();
+        return metrics.summary;
+    }
+    /**
+     * Get recent failures for alerting
+     */
+    getRecentFailures(hours = 24) {
+        const metrics = this.loadMetrics();
+        const cutoff = new Date(Date.now() - hours * 60 * 60 * 1000).toISOString();
+        return metrics.records.filter(r => !r.success && r.timestamp >= cutoff);
+    }
+    /**
+     * Check if failure rate exceeds threshold (for alerting)
+     */
+    isFailureRateHigh(tool, threshold = 0.2) {
+        const summary = this.getSummary();
+        const toolMetrics = summary[tool];
+        // Only alert if we have enough data (at least 5 attempts)
+        if (toolMetrics.totalAttempts < 5) {
+            return false;
+        }
+        const failureRate = 1 - toolMetrics.successRate;
+        return failureRate > threshold;
+    }
+    /**
+     * Format summary for display
+     */
+    formatSummary() {
+        const summary = this.getSummary();
+        const lines = [];
+        lines.push('📊 Closure Sync Metrics');
+        lines.push('═══════════════════════════════════════');
+        const formatTool = (name, metrics) => {
+            const result = [];
+            if (metrics.totalAttempts === 0) {
+                result.push(`  ${name}: No data`);
+                return result;
+            }
+            const successPct = (metrics.successRate * 100).toFixed(1);
+            const statusIcon = metrics.successRate >= 0.9 ? '✅' : metrics.successRate >= 0.7 ? '⚠️' : '❌';
+            result.push(`  ${name}: ${statusIcon} ${successPct}% success (${metrics.successful}/${metrics.totalAttempts})`);
+            if (metrics.avgDurationMs) {
+                result.push(`       Avg duration: ${metrics.avgDurationMs.toFixed(0)}ms`);
+            }
+            if (metrics.lastFailure && metrics.recentErrors.length > 0) {
+                result.push(`       Last error: ${metrics.recentErrors[0]}`);
+            }
+            return result;
+        };
+        lines.push(...formatTool('GitHub', summary.github));
+        lines.push(...formatTool('JIRA  ', summary.jira));
+        lines.push(...formatTool('ADO   ', summary.ado));
+        lines.push('───────────────────────────────────────');
+        const overallPct = (summary.overall.successRate * 100).toFixed(1);
+        lines.push(`  Overall: ${overallPct}% success (${summary.overall.successful}/${summary.overall.totalAttempts})`);
+        lines.push(`  Last updated: ${summary.lastUpdated}`);
+        return lines.join('\n');
+    }
+    /**
+     * Reset metrics (for testing or fresh start)
+     */
+    reset() {
+        const metrics = this.createEmptyMetrics();
+        this.saveMetrics(metrics);
+    }
+    // ========================================================================
+    // Private Methods
+    // ========================================================================
+    loadMetrics() {
+        if (!existsSync(this.metricsFile)) {
+            return this.createEmptyMetrics();
+        }
+        try {
+            const content = readFileSync(this.metricsFile, 'utf-8');
+            const metrics = JSON.parse(content);
+            // Version migration if needed
+            if (metrics.version !== METRICS_VERSION) {
+                this.logger.log('📊 Migrating metrics to new version...');
+                return this.createEmptyMetrics();
+            }
+            return metrics;
+        }
+        catch (error) {
+            this.logger.log(`⚠️ Failed to load metrics: ${error}`);
+            return this.createEmptyMetrics();
+        }
+    }
+    saveMetrics(metrics) {
+        try {
+            writeFileSync(this.metricsFile, JSON.stringify(metrics, null, 2));
+        }
+        catch (error) {
+            this.logger.log(`⚠️ Failed to save metrics: ${error}`);
+        }
+    }
+    createEmptyMetrics() {
+        const emptyToolMetrics = {
+            totalAttempts: 0,
+            successful: 0,
+            failed: 0,
+            successRate: 1,
+            recentErrors: [],
+        };
+        return {
+            version: METRICS_VERSION,
+            records: [],
+            summary: {
+                github: { ...emptyToolMetrics },
+                jira: { ...emptyToolMetrics },
+                ado: { ...emptyToolMetrics },
+                overall: {
+                    totalAttempts: 0,
+                    successful: 0,
+                    failed: 0,
+                    successRate: 1,
+                },
+                lastUpdated: new Date().toISOString(),
+            },
+        };
+    }
+    updateSummary(metrics) {
+        const tools = ['github', 'jira', 'ado'];
+        // Calculate per-tool metrics
+        for (const tool of tools) {
+            const toolRecords = metrics.records.filter(r => r.tool === tool);
+            const successful = toolRecords.filter(r => r.success).length;
+            const failed = toolRecords.filter(r => !r.success).length;
+            const total = toolRecords.length;
+            // Get durations for average calculation
+            const durations = toolRecords
+                .filter(r => r.durationMs !== undefined)
+                .map(r => r.durationMs);
+            const avgDurationMs = durations.length > 0
+                ? durations.reduce((a, b) => a + b, 0) / durations.length
+                : undefined;
+            // Get recent errors
+            const recentErrors = toolRecords
+                .filter(r => !r.success && r.error)
+                .slice(-MAX_RECENT_ERRORS)
+                .map(r => r.error)
+                .reverse();
+            // Find last success/failure timestamps
+            const lastSuccessRecord = toolRecords.filter(r => r.success).pop();
+            const lastFailureRecord = toolRecords.filter(r => !r.success).pop();
+            metrics.summary[tool] = {
+                totalAttempts: total,
+                successful,
+                failed,
+                successRate: total > 0 ? successful / total : 1,
+                lastSuccess: lastSuccessRecord?.timestamp,
+                lastFailure: lastFailureRecord?.timestamp,
+                avgDurationMs,
+                recentErrors,
+            };
+        }
+        // Calculate overall metrics
+        const allRecords = metrics.records;
+        const totalSuccessful = allRecords.filter(r => r.success).length;
+        const totalFailed = allRecords.filter(r => !r.success).length;
+        const totalAttempts = allRecords.length;
+        metrics.summary.overall = {
+            totalAttempts,
+            successful: totalSuccessful,
+            failed: totalFailed,
+            successRate: totalAttempts > 0 ? totalSuccessful / totalAttempts : 1,
+        };
+        metrics.summary.lastUpdated = new Date().toISOString();
+    }
+}
+/**
+ * Factory function for creating metrics instance
+ */
+export function createClosureMetrics(projectRoot, incrementId, logger) {
+    return new ClosureMetrics({ projectRoot, incrementId, logger });
+}
+//# sourceMappingURL=closure-metrics.js.map

package/dist/src/sync/closure-metrics.js.map

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

package/dist/src/sync/sync-coordinator.d.ts

@@ -7,6 +7,7 @@
 import { GitHubIssue } from '../../plugins/specweave-github/lib/types.js';
 import { Logger } from '../utils/logger.js';
 import { ResolvedAdoProfile } from '../integrations/ado/ado-client-factory.js';
+import { ClosureMetrics } from './closure-metrics.js';
 export interface SyncCoordinatorOptions {
     projectRoot: string;
     incrementId: string;
@@ -30,7 +31,19 @@ export declare class SyncCoordinator {
     private frontmatterUpdater;
     private projectId;
     private adoProfile?;
+    private metrics;
     constructor(options: SyncCoordinatorOptions);
+    /**
+     * Get closure sync metrics summary (v0.34.0)
+     *
+     * Returns aggregated metrics for all external tool closure operations.
+     * Useful for monitoring and alerting on sync health.
+     */
+    getClosureMetrics(): ReturnType<ClosureMetrics['getSummary']>;
+    /**
+     * Get formatted closure metrics for display (v0.34.0)
+     */
+    getFormattedClosureMetrics(): string;
     /**
      * Create GitHub issues for all User Stories in the feature (NEW in v0.25.0)
      *
@@ -99,6 +112,22 @@ export declare class SyncCoordinator {
     syncIncrementClosure(): Promise<SyncResult & {
         closedIssues: number[];
     }>;
+    /**
+     * Detect duplicate issues with different feature ID formats (v0.34.0)
+     *
+     * Searches for issues that match the user story but have a different feature ID format.
+     * This prevents creating duplicates like:
+     * - [FS-0128][US-001] (old bug format with leading zeros)
+     * - [FS-128][US-001] (correct format)
+     *
+     * The search uses a regex pattern that matches any FS-XXX format for the same US-XXX.
+     *
+     * @param client - GitHub client
+     * @param featureId - Current feature ID (e.g., "FS-128")
+     * @param userStoryId - User story ID (e.g., "US-001")
+     * @returns Duplicate info if found, null otherwise
+     */
+    private detectDuplicateIssue;
     /**
      * Update issue if it has placeholder content
      * Fetches issue from GitHub, checks for placeholder, and updates with rich content

package/dist/src/sync/sync-coordinator.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"sync-coordinator.d.ts","sourceRoot":"","sources":["../../../src/sync/sync-coordinator.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAQH,OAAO,EAAE,WAAW,EAAE,MAAM,6CAA6C,CAAC;AAC1E,OAAO,EAAE,MAAM,EAAiB,MAAM,oBAAoB,CAAC;AAK3D,OAAO,EAAE,kBAAkB,EAAE,MAAM,2CAA2C,CAAC;AAI/E,MAAM,WAAW,sBAAsB;IACrC,WAAW,EAAE,MAAM,CAAC;IACpB,WAAW,EAAE,MAAM,CAAC;IACpB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB;;;OAGG;IACH,UAAU,CAAC,EAAE,kBAAkB,CAAC;CACjC;AAED,MAAM,WAAW,UAAU;IACzB,OAAO,EAAE,OAAO,CAAC;IACjB,iBAAiB,EAAE,MAAM,CAAC;IAC1B,QAAQ,EAAE,cAAc,GAAG,WAAW,GAAG,WAAW,GAAG,aAAa,GAAG,kBAAkB,GAAG,mBAAmB,CAAC;IAChH,MAAM,EAAE,MAAM,EAAE,CAAC;CAClB;AAED,qBAAa,eAAe;IAC1B,OAAO,CAAC,WAAW,CAAS;IAC5B,OAAO,CAAC,WAAW,CAAS;IAC5B,OAAO,CAAC,MAAM,CAAS;IACvB,OAAO,CAAC,kBAAkB,CAAqB;IAC/C,OAAO,CAAC,SAAS,CAAS;IAC1B,OAAO,CAAC,UAAU,CAAC,CAAqB;gBAE5B,OAAO,EAAE,sBAAsB;IAW3C;;;;;;;;;;;;;OAaG;IACG,gCAAgC,CAAC,MAAM,EAAE,GAAG,GAAG,OAAO,CAAC,WAAW,EAAE,CAAC;IA0S3E;;;;;;;;;;;;;;;OAeG;IACG,+BAA+B,CAAC,MAAM,EAAE,GAAG,GAAG,OAAO,CAAC,MAAM,EAAE,CAAC;IAkHrE;;;;;;;;OAQG;IACG,6BAA6B,CAAC,MAAM,EAAE,GAAG,GAAG,OAAO,CAAC,MAAM,CAAC;IAsEjE;;;;;;;;OAQG;IACG,+BAA+B,CAAC,MAAM,EAAE,GAAG,GAAG,OAAO,CAAC,MAAM,CAAC;IAiGnE;;;;;;;;;;;;OAYG;IACG,oBAAoB,IAAI,OAAO,CAAC,UAAU,GAAG;QAAE,YAAY,EAAE,MAAM,EAAE,CAAA;KAAE,CAAC;IA6H9E;;;OAGG;YACW,wBAAwB;IA2DtC;;OAEG;IACH,OAAO,CAAC,mBAAmB;IAuB3B;;OAEG;IACG,uBAAuB,IAAI,OAAO,CAAC,UAAU,CAAC;IA6HpD;;OAEG;YACW,aAAa;IAwG3B;;OAEG;YACW,kBAAkB;IAmEhC;;OAEG;YACW,2BAA2B;IA6FzC;;OAEG;YACW,UAAU;IAWxB;;OAEG;YACW,gBAAgB;IA0B9B;;OAEG;IACH,OAAO,CAAC,0BAA0B;CAyCnC"}
+{"version":3,"file":"sync-coordinator.d.ts","sourceRoot":"","sources":["../../../src/sync/sync-coordinator.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAQH,OAAO,EAAE,WAAW,EAAE,MAAM,6CAA6C,CAAC;AAC1E,OAAO,EAAE,MAAM,EAAiB,MAAM,oBAAoB,CAAC;AAK3D,OAAO,EAAE,kBAAkB,EAAE,MAAM,2CAA2C,CAAC;AAG/E,OAAO,EAAE,cAAc,EAAwB,MAAM,sBAAsB,CAAC;AAE5E,MAAM,WAAW,sBAAsB;IACrC,WAAW,EAAE,MAAM,CAAC;IACpB,WAAW,EAAE,MAAM,CAAC;IACpB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB;;;OAGG;IACH,UAAU,CAAC,EAAE,kBAAkB,CAAC;CACjC;AAED,MAAM,WAAW,UAAU;IACzB,OAAO,EAAE,OAAO,CAAC;IACjB,iBAAiB,EAAE,MAAM,CAAC;IAC1B,QAAQ,EAAE,cAAc,GAAG,WAAW,GAAG,WAAW,GAAG,aAAa,GAAG,kBAAkB,GAAG,mBAAmB,CAAC;IAChH,MAAM,EAAE,MAAM,EAAE,CAAC;CAClB;AAED,qBAAa,eAAe;IAC1B,OAAO,CAAC,WAAW,CAAS;IAC5B,OAAO,CAAC,WAAW,CAAS;IAC5B,OAAO,CAAC,MAAM,CAAS;IACvB,OAAO,CAAC,kBAAkB,CAAqB;IAC/C,OAAO,CAAC,SAAS,CAAS;IAC1B,OAAO,CAAC,UAAU,CAAC,CAAqB;IACxC,OAAO,CAAC,OAAO,CAAiB;gBAEpB,OAAO,EAAE,sBAAsB;IAa3C;;;;;OAKG;IACH,iBAAiB,IAAI,UAAU,CAAC,cAAc,CAAC,YAAY,CAAC,CAAC;IAI7D;;OAEG;IACH,0BAA0B,IAAI,MAAM;IAIpC;;;;;;;;;;;;;OAaG;IACG,gCAAgC,CAAC,MAAM,EAAE,GAAG,GAAG,OAAO,CAAC,WAAW,EAAE,CAAC;IAqU3E;;;;;;;;;;;;;;;OAeG;IACG,+BAA+B,CAAC,MAAM,EAAE,GAAG,GAAG,OAAO,CAAC,MAAM,EAAE,CAAC;IA0HrE;;;;;;;;OAQG;IACG,6BAA6B,CAAC,MAAM,EAAE,GAAG,GAAG,OAAO,CAAC,MAAM,CAAC;IA8EjE;;;;;;;;OAQG;IACG,+BAA+B,CAAC,MAAM,EAAE,GAAG,GAAG,OAAO,CAAC,MAAM,CAAC;IAyGnE;;;;;;;;;;;;OAYG;IACG,oBAAoB,IAAI,OAAO,CAAC,UAAU,GAAG;QAAE,YAAY,EAAE,MAAM,EAAE,CAAA;KAAE,CAAC;IAqI9E;;;;;;;;;;;;;;OAcG;YACW,oBAAoB;IAsDlC;;;OAGG;YACW,wBAAwB;IA2DtC;;OAEG;IACH,OAAO,CAAC,mBAAmB;IAuB3B;;OAEG;IACG,uBAAuB,IAAI,OAAO,CAAC,UAAU,CAAC;IA6HpD;;OAEG;YACW,aAAa;IAwG3B;;OAEG;YACW,kBAAkB;IAmEhC;;OAEG;YACW,2BAA2B;IA6FzC;;OAEG;YACW,UAAU;IAWxB;;OAEG;YACW,gBAAgB;IA0B9B;;OAEG;IACH,OAAO,CAAC,0BAA0B;CAyCnC"}

package/dist/src/sync/sync-coordinator.js

@@ -17,6 +17,7 @@ import { UserStoryContentBuilder } from '../../plugins/specweave-github/lib/user
 import { AdoClient } from '../integrations/ado/ado-client.js';
 import { getAdoPat } from '../integrations/ado/ado-pat-provider.js';
 import { deriveFeatureId } from '../utils/feature-id-derivation.js';
+import { createClosureMetrics } from './closure-metrics.js';
 export class SyncCoordinator {
     constructor(options) {
         this.projectRoot = options.projectRoot;
@@ -27,6 +28,23 @@ export class SyncCoordinator {
         this.projectId = autoDetectProjectIdSync(this.projectRoot, { silent: true });
         // Store resolved ADO profile for multi-project sync
         this.adoProfile = options.adoProfile;
+        // Initialize closure metrics (v0.34.0)
+        this.metrics = createClosureMetrics(this.projectRoot, this.incrementId, this.logger);
+    }
+    /**
+     * Get closure sync metrics summary (v0.34.0)
+     *
+     * Returns aggregated metrics for all external tool closure operations.
+     * Useful for monitoring and alerting on sync health.
+     */
+    getClosureMetrics() {
+        return this.metrics.getSummary();
+    }
+    /**
+     * Get formatted closure metrics for display (v0.34.0)
+     */
+    getFormattedClosureMetrics() {
+        return this.metrics.formatSummary();
     }
     /**
      * Create GitHub issues for all User Stories in the feature (NEW in v0.25.0)
@@ -191,7 +209,32 @@ export class SyncCoordinator {
                         }
                         continue;
                     }
-                    // All 3 layers miss - create new issue
+                    // All 3 layers miss - but check for DUPLICATES with wrong format first!
+                    // ========================================================================
+                    // DUPLICATE DETECTION (v0.34.0): Prevent FS-0128 vs FS-128 duplicates
+                    // ========================================================================
+                    // Before creating, search for issues with similar titles but different feature ID formats.
+                    // This catches cases where an old bug created issues with leading zeros (FS-0128)
+                    // but the correct format is without (FS-128).
+                    const duplicateCheck = await this.detectDuplicateIssue(client, featureId, usFile.id);
+                    if (duplicateCheck) {
+                        this.logger.log(`  ⚠️  DUPLICATE DETECTED: Issue #${duplicateCheck.number} exists with format "${duplicateCheck.format}"`);
+                        this.logger.log(`     Current format: [${featureId}][${usFile.id}]`);
+                        this.logger.log(`     Existing issue: ${duplicateCheck.title}`);
+                        this.logger.log(`     ⏭️  Skipping creation to avoid duplicate. Use existing issue #${duplicateCheck.number}`);
+                        // Backfill metadata with the existing issue (even if wrong format)
+                        await this.frontmatterUpdater.updateUserStoryFrontmatter({
+                            projectRoot: this.projectRoot,
+                            featureId,
+                            userStoryId: usFile.id,
+                            githubIssue: {
+                                number: duplicateCheck.number,
+                                url: duplicateCheck.url,
+                                createdAt: new Date().toISOString(),
+                            },
+                        });
+                        continue;
+                    }
                     this.logger.log(`  📝 Creating GitHub issue for ${usFile.id}...`);
                     // Format issue body - use UserStoryContentBuilder for rich content with ACs
                     let issueBody;
@@ -369,9 +412,18 @@ Increment \`${this.incrementId}\` has been marked as **completed**.
 
 ---
 🤖 Auto-closed by SpecWeave on increment completion`;
-                    await client.closeIssue(existingIssue.number, completionComment);
-                    closedIssues.push(existingIssue.number);
-                    this.logger.log(`  ✅ Closed issue #${existingIssue.number}`);
+                    // Track metrics (v0.34.0)
+                    this.metrics.startOperation();
+                    try {
+                        await client.closeIssue(existingIssue.number, completionComment);
+                        closedIssues.push(existingIssue.number);
+                        this.metrics.recordClosure('github', existingIssue.number, true);
+                        this.logger.log(`  ✅ Closed issue #${existingIssue.number}`);
+                    }
+                    catch (closeError) {
+                        this.metrics.recordClosure('github', existingIssue.number, false, String(closeError));
+                        throw closeError;
+                    }
                 }
                 catch (error) {
                     this.logger.error(`  ❌ Failed to close issue for ${usFile.id}:`, error);
@@ -441,12 +493,21 @@ Increment \`${this.incrementId}\` has been marked as **completed**.
                     }
                     // Transition to Done
                     this.logger.log(`  🔒 Transitioning JIRA ${jiraKey} to ${targetStatus}...`);
-                    await jiraClient.updateIssue({
-                        key: jiraKey,
-                        status: targetStatus
-                    });
-                    this.logger.log(`  ✅ Transitioned ${jiraKey}`);
-                    closedCount++;
+                    // Track metrics (v0.34.0)
+                    this.metrics.startOperation();
+                    try {
+                        await jiraClient.updateIssue({
+                            key: jiraKey,
+                            status: targetStatus
+                        });
+                        this.metrics.recordClosure('jira', jiraKey, true);
+                        this.logger.log(`  ✅ Transitioned ${jiraKey}`);
+                        closedCount++;
+                    }
+                    catch (updateError) {
+                        this.metrics.recordClosure('jira', jiraKey, false, String(updateError));
+                        throw updateError;
+                    }
                 }
                 catch (error) {
                     this.logger.error(`  ❌ Failed to close JIRA issue for ${usFile.id}:`, error);
@@ -534,12 +595,21 @@ Increment \`${this.incrementId}\` has been marked as **completed**.
                     }
                     // Update to Closed state
                     this.logger.log(`  🔒 Closing ADO work item #${workItemId}...`);
-                    await adoClient.updateWorkItem({
-                        id: workItemId,
-                        state: targetState
-                    });
-                    this.logger.log(`  ✅ Closed #${workItemId}`);
-                    closedCount++;
+                    // Track metrics (v0.34.0)
+                    this.metrics.startOperation();
+                    try {
+                        await adoClient.updateWorkItem({
+                            id: workItemId,
+                            state: targetState
+                        });
+                        this.metrics.recordClosure('ado', workItemId, true);
+                        this.logger.log(`  ✅ Closed #${workItemId}`);
+                        closedCount++;
+                    }
+                    catch (updateError) {
+                        this.metrics.recordClosure('ado', workItemId, false, String(updateError));
+                        throw updateError;
+                    }
                 }
                 catch (error) {
                     this.logger.error(`  ❌ Failed to close ADO work item for ${usId}:`, error);
@@ -670,6 +740,13 @@ Increment \`${this.incrementId}\` has been marked as **completed**.
             if (result.errors.length > 0) {
                 this.logger.log(`   ⚠️  ${result.errors.length} error(s) occurred`);
             }
+            // Check for high failure rate and warn (v0.34.0 metrics)
+            const tools = ['github', 'jira', 'ado'];
+            for (const tool of tools) {
+                if (this.metrics.isFailureRateHigh(tool)) {
+                    this.logger.log(`   ⚠️  ${tool.toUpperCase()} has high failure rate - check credentials/permissions`);
+                }
+            }
             return result;
         }
         catch (error) {
@@ -678,6 +755,66 @@ Increment \`${this.incrementId}\` has been marked as **completed**.
             return result;
         }
     }
+    /**
+     * Detect duplicate issues with different feature ID formats (v0.34.0)
+     *
+     * Searches for issues that match the user story but have a different feature ID format.
+     * This prevents creating duplicates like:
+     * - [FS-0128][US-001] (old bug format with leading zeros)
+     * - [FS-128][US-001] (correct format)
+     *
+     * The search uses a regex pattern that matches any FS-XXX format for the same US-XXX.
+     *
+     * @param client - GitHub client
+     * @param featureId - Current feature ID (e.g., "FS-128")
+     * @param userStoryId - User story ID (e.g., "US-001")
+     * @returns Duplicate info if found, null otherwise
+     */
+    async detectDuplicateIssue(client, featureId, userStoryId) {
+        try {
+            // Extract the numeric part of the feature ID (e.g., "128" from "FS-128" or "FS-0128")
+            const featureNumMatch = featureId.match(/FS-0*(\d+)E?/i);
+            if (!featureNumMatch) {
+                return null;
+            }
+            const featureNum = featureNumMatch[1];
+            // Search for issues with ANY format of this feature ID + user story
+            // Patterns to check:
+            // - [FS-128][US-001]   (correct, no leading zeros)
+            // - [FS-0128][US-001]  (bug format, with leading zeros)
+            // - [FS-00128][US-001] (edge case, multiple leading zeros)
+            const searchPatterns = [
+                `[FS-${featureNum}][${userStoryId}]`, // FS-128
+                `[FS-0${featureNum}][${userStoryId}]`, // FS-0128
+                `[FS-00${featureNum}][${userStoryId}]`, // FS-00128
+                `[FS-${featureNum}E][${userStoryId}]`, // FS-128E (external)
+                `[FS-0${featureNum}E][${userStoryId}]`, // FS-0128E
+            ];
+            // Filter out the exact current format (we already checked that)
+            const currentFormat = `[${featureId}][${userStoryId}]`;
+            const alternatePatterns = searchPatterns.filter(p => p !== currentFormat);
+            for (const pattern of alternatePatterns) {
+                const existingIssue = await client.searchIssueByTitle(pattern, true); // Include closed
+                if (existingIssue) {
+                    // Extract the format from the issue title
+                    const formatMatch = existingIssue.title.match(/\[(FS-\d+E?)\]/i);
+                    const detectedFormat = formatMatch ? formatMatch[1] : 'unknown';
+                    return {
+                        number: existingIssue.number,
+                        url: existingIssue.html_url,
+                        title: existingIssue.title,
+                        format: detectedFormat,
+                    };
+                }
+            }
+            return null;
+        }
+        catch (error) {
+            // Don't block issue creation on duplicate detection failure
+            this.logger.log(`    ⚠️ Duplicate detection failed (non-blocking): ${error}`);
+            return null;
+        }
+    }
     /**
      * Update issue if it has placeholder content
      * Fetches issue from GitHub, checks for placeholder, and updates with rich content