specweave 0.33.2 → 0.33.4

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":"AAAA;;;;;;;;;;;GAWG;AAEH,OAAO,EAAE,UAAU,EAAE,YAAY,EAAE,aAAa,EAAE,SAAS,EAAE,MAAM,IAAI,CAAC;AACxE,OAAO,EAAE,IAAI,EAAE,MAAM,MAAM,CAAC;AAC5B,OAAO,EAAU,aAAa,EAAE,MAAM,oBAAoB,CAAC;AA4C3D,MAAM,eAAe,GAAG,CAAC,CAAC;AAC1B,MAAM,WAAW,GAAG,IAAI,CAAC,CAAC,yBAAyB;AACnD,MAAM,iBAAiB,GAAG,EAAE,CAAC,CAAC,+BAA+B;AAE7D,MAAM,OAAO,cAAc;IAOzB,YAAY,OAIX;QANO,uBAAkB,GAAW,CAAC,CAAC;QAOrC,IAAI,CAAC,WAAW,GAAG,OAAO,CAAC,WAAW,CAAC;QACvC,IAAI,CAAC,kBAAkB,GAAG,OAAO,CAAC,WAAW,IAAI,SAAS,CAAC;QAC3D,IAAI,CAAC,MAAM,GAAG,OAAO,CAAC,MAAM,IAAI,aAAa,CAAC;QAE9C,MAAM,QAAQ,GAAG,IAAI,CAAC,IAAI,CAAC,WAAW,EAAE,kBAAkB,CAAC,CAAC;QAC5D,IAAI,CAAC,UAAU,CAAC,QAAQ,CAAC,EAAE,CAAC;YAC1B,SAAS,CAAC,QAAQ,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC;QAC3C,CAAC;QACD,IAAI,CAAC,WAAW,GAAG,IAAI,CAAC,QAAQ,EAAE,sBAAsB,CAAC,CAAC;IAC5D,CAAC;IAED;;OAEG;IACH,cAAc;QACZ,IAAI,CAAC,kBAAkB,GAAG,IAAI,CAAC,GAAG,EAAE,CAAC;IACvC,CAAC;IAED;;OAEG;IACH,aAAa,CACX,IAAkB,EAClB,MAAuB,EACvB,OAAgB,EAChB,KAAc;QAEd,MAAM,UAAU,GAAG,IAAI,CAAC,kBAAkB,GAAG,CAAC;YAC5C,CAAC,CAAC,IAAI,CAAC,GAAG,EAAE,GAAG,IAAI,CAAC,kBAAkB;YACtC,CAAC,CAAC,SAAS,CAAC;QAEd,MAAM,MAAM,GAAkB;YAC5B,IAAI;YACJ,MAAM;YACN,WAAW,EAAE,IAAI,CAAC,kBAAkB;YACpC,OAAO;YACP,KAAK;YACL,SAAS,EAAE,IAAI,IAAI,EAAE,CAAC,WAAW,EAAE;YACnC,UAAU;SACX,CAAC;QAEF,MAAM,OAAO,GAAG,IAAI,CAAC,WAAW,EAAE,CAAC;QACnC,OAAO,CAAC,OAAO,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC;QAE7B,sBAAsB;QACtB,IAAI,OAAO,CAAC,OAAO,CAAC,MAAM,GAAG,WAAW,EAAE,CAAC;YACzC,OAAO,CAAC,OAAO,GAAG,OAAO,CAAC,OAAO,CAAC,KAAK,CAAC,CAAC,WAAW,CAAC,CAAC;QACxD,CAAC;QAED,iBAAiB;QACjB,IAAI,CAAC,aAAa,CAAC,OAAO,CAAC,CAAC;QAE5B,IAAI,CAAC,WAAW,CAAC,OAAO,CAAC,CAAC;QAE1B,cAAc;QACd,IAAI,CAAC,kBAAkB,GAAG,CAAC,CAAC;IAC9B,CAAC;IAED;;OAEG;IACH,WAAW,CACT,IAAkB,EAClB,OAA6E;QAE7E,MAAM,OAAO,GAAG,IAAI,CAAC,WAAW,EAAE,CAAC;QAEnC,KAAK,MAAM,MAAM,IAAI,OAAO,EAAE,CAAC;YAC7B,MAAM,MAAM,GAAkB;gBAC5B,IAAI;gBACJ,MAAM,EAAE,MAAM,CAAC,MAAM;gBACrB,WAAW,EAAE,IAAI,CAAC,kBAAkB;gBACpC,OAAO,EAAE,MAAM,CAAC,OAAO;gBACvB,KAAK,EAAE,MAAM,CAAC,KAAK;gBACnB,SAAS,EAAE,IAAI,IAAI,EAAE,CAAC,WAAW,EAAE;aACpC,CAAC;YACF,OAAO,CAAC,OAAO,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC;QAC/B,CAAC;QAED,sBAAsB;QACtB,IAAI,OAAO,CAAC,OAAO,CAAC,MAAM,GAAG,WAAW,EAAE,CAAC;YACzC,OAAO,CAAC,OAAO,GAAG,OAAO,CAAC,OAAO,CAAC,KAAK,CAAC,CAAC,WAAW,CAAC,CAAC;QACxD,CAAC;QAED,IAAI,CAAC,aAAa,CAAC,OAAO,CAAC,CAAC;QAC5B,IAAI,CAAC,WAAW,CAAC,OAAO,CAAC,CAAC;IAC5B,CAAC;IAED;;OAEG;IACH,UAAU;QACR,MAAM,OAAO,GAAG,IAAI,CAAC,WAAW,EAAE,CAAC;QACnC,OAAO,OAAO,CAAC,OAAO,CAAC;IACzB,CAAC;IAED;;OAEG;IACH,iBAAiB,CAAC,QAAgB,EAAE;QAClC,MAAM,OAAO,GAAG,IAAI,CAAC,WAAW,EAAE,CAAC;QACnC,MAAM,MAAM,GAAG,IAAI,IAAI,CAAC,IAAI,CAAC,GAAG,EAAE,GAAG,KAAK,GAAG,EAAE,GAAG,EAAE,GAAG,IAAI,CAAC,CAAC,WAAW,EAAE,CAAC;QAE3E,OAAO,OAAO,CAAC,OAAO,CAAC,MAAM,CAC3B,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC,OAAO,IAAI,CAAC,CAAC,SAAS,IAAI,MAAM,CACzC,CAAC;IACJ,CAAC;IAED;;OAEG;IACH,iBAAiB,CAAC,IAAkB,EAAE,YAAoB,GAAG;QAC3D,MAAM,OAAO,GAAG,IAAI,CAAC,UAAU,EAAE,CAAC;QAClC,MAAM,WAAW,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;QAElC,0DAA0D;QAC1D,IAAI,WAAW,CAAC,aAAa,GAAG,CAAC,EAAE,CAAC;YAClC,OAAO,KAAK,CAAC;QACf,CAAC;QAED,MAAM,WAAW,GAAG,CAAC,GAAG,WAAW,CAAC,WAAW,CAAC;QAChD,OAAO,WAAW,GAAG,SAAS,CAAC;IACjC,CAAC;IAED;;OAEG;IACH,aAAa;QACX,MAAM,OAAO,GAAG,IAAI,CAAC,UAAU,EAAE,CAAC;QAClC,MAAM,KAAK,GAAa,EAAE,CAAC;QAE3B,KAAK,CAAC,IAAI,CAAC,yBAAyB,CAAC,CAAC;QACtC,KAAK,CAAC,IAAI,CAAC,yCAAyC,CAAC,CAAC;QAEtD,MAAM,UAAU,GAAG,CAAC,IAAY,EAAE,OAAoB,EAAY,EAAE;YAClE,MAAM,MAAM,GAAa,EAAE,CAAC;YAC5B,IAAI,OAAO,CAAC,aAAa,KAAK,CAAC,EAAE,CAAC;gBAChC,MAAM,CAAC,IAAI,CAAC,KAAK,IAAI,WAAW,CAAC,CAAC;gBAClC,OAAO,MAAM,CAAC;YAChB,CAAC;YAED,MAAM,UAAU,GAAG,CAAC,OAAO,CAAC,WAAW,GAAG,GAAG,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC;YAC1D,MAAM,UAAU,GAAG,OAAO,CAAC,WAAW,IAAI,GAAG,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,OAAO,CAAC,WAAW,IAAI,GAAG,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,GAAG,CAAC;YAE9F,MAAM,CAAC,IAAI,CAAC,KAAK,IAAI,KAAK,UAAU,IAAI,UAAU,cAAc,OAAO,CAAC,UAAU,IAAI,OAAO,CAAC,aAAa,GAAG,CAAC,CAAC;YAEhH,IAAI,OAAO,CAAC,aAAa,EAAE,CAAC;gBAC1B,MAAM,CAAC,IAAI,CAAC,wBAAwB,OAAO,CAAC,aAAa,CAAC,OAAO,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC;YAC5E,CAAC;YAED,IAAI,OAAO,CAAC,WAAW,IAAI,OAAO,CAAC,YAAY,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;gBAC3D,MAAM,CAAC,IAAI,CAAC,sBAAsB,OAAO,CAAC,YAAY,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC;YAC/D,CAAC;YAED,OAAO,MAAM,CAAC;QAChB,CAAC,CAAC;QAEF,KAAK,CAAC,IAAI,CAAC,GAAG,UAAU,CAAC,QAAQ,EAAE,OAAO,CAAC,MAAM,CAAC,CAAC,CAAC;QACpD,KAAK,CAAC,IAAI,CAAC,GAAG,UAAU,CAAC,QAAQ,EAAE,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC;QAClD,KAAK,CAAC,IAAI,CAAC,GAAG,UAAU,CAAC,QAAQ,EAAE,OAAO,CAAC,GAAG,CAAC,CAAC,CAAC;QAEjD,KAAK,CAAC,IAAI,CAAC,yCAAyC,CAAC,CAAC;QAEtD,MAAM,UAAU,GAAG,CAAC,OAAO,CAAC,OAAO,CAAC,WAAW,GAAG,GAAG,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC;QAClE,KAAK,CAAC,IAAI,CAAC,cAAc,UAAU,cAAc,OAAO,CAAC,OAAO,CAAC,UAAU,IAAI,OAAO,CAAC,OAAO,CAAC,aAAa,GAAG,CAAC,CAAC;QACjH,KAAK,CAAC,IAAI,CAAC,mBAAmB,OAAO,CAAC,WAAW,EAAE,CAAC,CAAC;QAErD,OAAO,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;IAC1B,CAAC;IAED;;OAEG;IACH,KAAK;QACH,MAAM,OAAO,GAAG,IAAI,CAAC,kBAAkB,EAAE,CAAC;QAC1C,IAAI,CAAC,WAAW,CAAC,OAAO,CAAC,CAAC;IAC5B,CAAC;IAED,2EAA2E;IAC3E,kBAAkB;IAClB,2EAA2E;IAEnE,WAAW;QACjB,IAAI,CAAC,UAAU,CAAC,IAAI,CAAC,WAAW,CAAC,EAAE,CAAC;YAClC,OAAO,IAAI,CAAC,kBAAkB,EAAE,CAAC;QACnC,CAAC;QAED,IAAI,CAAC;YACH,MAAM,OAAO,GAAG,YAAY,CAAC,IAAI,CAAC,WAAW,EAAE,OAAO,CAAC,CAAC;YACxD,MAAM,OAAO,GAAG,IAAI,CAAC,KAAK,CAAC,OAAO,CAAqB,CAAC;YAExD,8BAA8B;YAC9B,IAAI,OAAO,CAAC,OAAO,KAAK,eAAe,EAAE,CAAC;gBACxC,IAAI,CAAC,MAAM,CAAC,GAAG,CAAC,wCAAwC,CAAC,CAAC;gBAC1D,OAAO,IAAI,CAAC,kBAAkB,EAAE,CAAC;YACnC,CAAC;YAED,OAAO,OAAO,CAAC;QACjB,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACf,IAAI,CAAC,MAAM,CAAC,GAAG,CAAC,8BAA8B,KAAK,EAAE,CAAC,CAAC;YACvD,OAAO,IAAI,CAAC,kBAAkB,EAAE,CAAC;QACnC,CAAC;IACH,CAAC;IAEO,WAAW,CAAC,OAAyB;QAC3C,IAAI,CAAC;YACH,aAAa,CAAC,IAAI,CAAC,WAAW,EAAE,IAAI,CAAC,SAAS,CAAC,OAAO,EAAE,IAAI,EAAE,CAAC,CAAC,CAAC,CAAC;QACpE,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACf,IAAI,CAAC,MAAM,CAAC,GAAG,CAAC,8BAA8B,KAAK,EAAE,CAAC,CAAC;QACzD,CAAC;IACH,CAAC;IAEO,kBAAkB;QACxB,MAAM,gBAAgB,GAAgB;YACpC,aAAa,EAAE,CAAC;YAChB,UAAU,EAAE,CAAC;YACb,MAAM,EAAE,CAAC;YACT,WAAW,EAAE,CAAC;YACd,YAAY,EAAE,EAAE;SACjB,CAAC;QAEF,OAAO;YACL,OAAO,EAAE,eAAe;YACxB,OAAO,EAAE,EAAE;YACX,OAAO,EAAE;gBACP,MAAM,EAAE,EAAE,GAAG,gBAAgB,EAAE;gBAC/B,IAAI,EAAE,EAAE,GAAG,gBAAgB,EAAE;gBAC7B,GAAG,EAAE,EAAE,GAAG,gBAAgB,EAAE;gBAC5B,OAAO,EAAE;oBACP,aAAa,EAAE,CAAC;oBAChB,UAAU,EAAE,CAAC;oBACb,MAAM,EAAE,CAAC;oBACT,WAAW,EAAE,CAAC;iBACf;gBACD,WAAW,EAAE,IAAI,IAAI,EAAE,CAAC,WAAW,EAAE;aACtC;SACF,CAAC;IACJ,CAAC;IAEO,aAAa,CAAC,OAAyB;QAC7C,MAAM,KAAK,GAAmB,CAAC,QAAQ,EAAE,MAAM,EAAE,KAAK,CAAC,CAAC;QAExD,6BAA6B;QAC7B,KAAK,MAAM,IAAI,IAAI,KAAK,EAAE,CAAC;YACzB,MAAM,WAAW,GAAG,OAAO,CAAC,OAAO,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,IAAI,KAAK,IAAI,CAAC,CAAC;YACjE,MAAM,UAAU,GAAG,WAAW,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,MAAM,CAAC;YAC7D,MAAM,MAAM,GAAG,WAAW,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,MAAM,CAAC;YAC1D,MAAM,KAAK,GAAG,WAAW,CAAC,MAAM,CAAC;YAEjC,wCAAwC;YACxC,MAAM,SAAS,GAAG,WAAW;iBAC1B,MAAM,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,UAAU,KAAK,SAAS,CAAC;iBACvC,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,UAAW,CAAC,CAAC;YAE3B,MAAM,aAAa,GAAG,SAAS,CAAC,MAAM,GAAG,CAAC;gBACxC,CAAC,CAAC,SAAS,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC,GAAG,SAAS,CAAC,MAAM;gBACzD,CAAC,CAAC,SAAS,CAAC;YAEd,oBAAoB;YACpB,MAAM,YAAY,GAAG,WAAW;iBAC7B,MAAM,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC,OAAO,IAAI,CAAC,CAAC,KAAK,CAAC;iBAClC,KAAK,CAAC,CAAC,iBAAiB,CAAC;iBACzB,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,KAAM,CAAC;iBAClB,OAAO,EAAE,CAAC;YAEb,uCAAuC;YACvC,MAAM,iBAAiB,GAAG,WAAW,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,GAAG,EAAE,CAAC;YACnE,MAAM,iBAAiB,GAAG,WAAW,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,GAAG,EAAE,CAAC;YAEpE,OAAO,CAAC,OAAO,CAAC,IAAI,CAAC,GAAG;gBACtB,aAAa,EAAE,KAAK;gBACpB,UAAU;gBACV,MAAM;gBACN,WAAW,EAAE,KAAK,GAAG,CAAC,CAAC,CAAC,CAAC,UAAU,GAAG,KAAK,CAAC,CAAC,CAAC,CAAC;gBAC/C,WAAW,EAAE,iBAAiB,EAAE,SAAS;gBACzC,WAAW,EAAE,iBAAiB,EAAE,SAAS;gBACzC,aAAa;gBACb,YAAY;aACb,CAAC;QACJ,CAAC;QAED,4BAA4B;QAC5B,MAAM,UAAU,GAAG,OAAO,CAAC,OAAO,CAAC;QACnC,MAAM,eAAe,GAAG,UAAU,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,MAAM,CAAC;QACjE,MAAM,WAAW,GAAG,UAAU,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,MAAM,CAAC;QAC9D,MAAM,aAAa,GAAG,UAAU,CAAC,MAAM,CAAC;QAExC,OAAO,CAAC,OAAO,CAAC,OAAO,GAAG;YACxB,aAAa;YACb,UAAU,EAAE,eAAe;YAC3B,MAAM,EAAE,WAAW;YACnB,WAAW,EAAE,aAAa,GAAG,CAAC,CAAC,CAAC,CAAC,eAAe,GAAG,aAAa,CAAC,CAAC,CAAC,CAAC;SACrE,CAAC;QAEF,OAAO,CAAC,OAAO,CAAC,WAAW,GAAG,IAAI,IAAI,EAAE,CAAC,WAAW,EAAE,CAAC;IACzD,CAAC;CACF;AAED;;GAEG;AACH,MAAM,UAAU,oBAAoB,CAClC,WAAmB,EACnB,WAAoB,EACpB,MAAe;IAEf,OAAO,IAAI,cAAc,CAAC,EAAE,WAAW,EAAE,WAAW,EAAE,MAAM,EAAE,CAAC,CAAC;AAClE,CAAC"}

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)
      *
@@ -63,6 +76,26 @@ export declare class SyncCoordinator {
      * @returns Array of closed issue numbers
      */
     closeGitHubIssuesForUserStories(config: any): Promise<number[]>;
+    /**
+     * Close JIRA issues for completed user stories (v0.34.0)
+     *
+     * Transitions JIRA issues to "Done" status when increment is completed.
+     * Reads issue references from user story frontmatter (external.jira.issue_key).
+     *
+     * @param config - Project config with JIRA settings
+     * @returns Number of closed JIRA issues
+     */
+    closeJiraIssuesForUserStories(config: any): Promise<number>;
+    /**
+     * Close ADO work items for completed user stories (v0.34.0)
+     *
+     * Transitions ADO work items to "Closed" state when increment is completed.
+     * Reads work item references from user story frontmatter (external.ado.id).
+     *
+     * @param config - Project config with ADO settings
+     * @returns Number of closed ADO work items
+     */
+    closeAdoWorkItemsForUserStories(config: any): Promise<number>;
     /**
      * Sync increment closure to external tools (NEW in v0.28.1)
      *
@@ -79,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;AAG/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;IAyS3E;;;;;;;;;;;;;;;OAeG;IACG,+BAA+B,CAAC,MAAM,EAAE,GAAG,GAAG,OAAO,CAAC,MAAM,EAAE,CAAC;IAgHrE;;;;;;;;;;;;OAYG;IACG,oBAAoB,IAAI,OAAO,CAAC,UAAU,GAAG;QAAE,YAAY,EAAE,MAAM,EAAE,CAAA;KAAE,CAAC;IAiF9E;;;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;IAuEzC;;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"}