specweave 0.16.5 → 0.16.11

package/dist/plugins/specweave-jira/lib/setup-wizard.js

@@ -0,0 +1,219 @@
+/**
+ * Smart Jira Setup Wizard
+ *
+ * Intelligent credential detection and setup flow:
+ * 1. Check .env for credentials (uses credentialsManager)
+ * 2. Interactive prompt only if missing
+ * 3. Never ask twice for same credentials
+ */
+import inquirer from 'inquirer';
+import { credentialsManager } from '../../../src/core/credentials-manager.js';
+// ============================================================================
+// Credential Detection
+// ============================================================================
+/**
+ * Smart credential detection - uses existing credentialsManager
+ */
+export async function detectJiraCredentials() {
+    if (credentialsManager.hasJiraCredentials()) {
+        try {
+            const credentials = credentialsManager.getJiraCredentials();
+            console.log('✅ Found Jira credentials in .env');
+            return {
+                found: true,
+                credentials,
+                source: 'env',
+            };
+        }
+        catch (error) {
+            // Credentials exist but invalid format
+            return { found: false };
+        }
+    }
+    return { found: false };
+}
+// ============================================================================
+// Interactive Setup
+// ============================================================================
+/**
+ * Interactive Jira credential setup
+ * Only runs if credentials not found
+ */
+export async function setupJiraCredentials() {
+    console.log('\n🔧 Jira Setup Wizard\n');
+    // Check for existing credentials first
+    const detected = await detectJiraCredentials();
+    if (detected.found) {
+        // Ask user if they want to use existing or re-enter
+        const { useExisting } = await inquirer.prompt([
+            {
+                type: 'confirm',
+                name: 'useExisting',
+                message: `Found credentials in ${detected.source}. Use these credentials?`,
+                default: true,
+            },
+        ]);
+        if (useExisting) {
+            return detected.credentials;
+        }
+        console.log('\n📝 Enter new credentials:\n');
+    }
+    else {
+        console.log('⚠️  No Jira credentials found\n');
+        console.log('📝 Let\'s set up your Jira connection:\n');
+    }
+    // Interactive credential entry
+    const answers = await inquirer.prompt([
+        {
+            type: 'list',
+            name: 'setupType',
+            message: 'How would you like to connect to Jira?',
+            choices: [
+                {
+                    name: 'Cloud (*.atlassian.net)',
+                    value: 'cloud',
+                },
+                {
+                    name: 'Server/Data Center (self-hosted)',
+                    value: 'server',
+                },
+            ],
+        },
+        {
+            type: 'input',
+            name: 'domain',
+            message: (answers) => answers.setupType === 'cloud'
+                ? 'Jira domain (e.g., mycompany.atlassian.net):'
+                : 'Jira server URL (e.g., jira.mycompany.com):',
+            validate: (value) => {
+                if (!value)
+                    return 'Domain is required';
+                if (answers.setupType === 'cloud' && !value.includes('.atlassian.net')) {
+                    return 'Cloud domain must end with .atlassian.net';
+                }
+                return true;
+            },
+        },
+        {
+            type: 'input',
+            name: 'email',
+            message: 'Email address:',
+            validate: (value) => {
+                if (!value)
+                    return 'Email is required';
+                if (!value.includes('@'))
+                    return 'Must be a valid email';
+                return true;
+            },
+        },
+        {
+            type: 'password',
+            name: 'apiToken',
+            message: 'API token:',
+            mask: '*',
+            validate: (value) => {
+                if (!value)
+                    return 'API token is required';
+                if (value.length < 10)
+                    return 'API token seems too short';
+                return true;
+            },
+        },
+    ]);
+    const credentials = {
+        domain: answers.domain,
+        email: answers.email,
+        apiToken: answers.apiToken,
+    };
+    // Test connection
+    console.log('\n🔍 Testing connection...');
+    const isValid = await testJiraConnection(credentials);
+    if (!isValid) {
+        console.log('❌ Failed to connect to Jira');
+        console.log('💡 Please check your credentials and try again\n');
+        const { retry } = await inquirer.prompt([
+            {
+                type: 'confirm',
+                name: 'retry',
+                message: 'Would you like to try again?',
+                default: true,
+            },
+        ]);
+        if (retry) {
+            return setupJiraCredentials();
+        }
+        throw new Error('Jira connection failed');
+    }
+    console.log('✅ Connection successful!\n');
+    // Save to .env using credentialsManager
+    await saveCredentialsToEnv(credentials);
+    return credentials;
+}
+/**
+ * Test Jira connection with credentials
+ */
+async function testJiraConnection(credentials) {
+    try {
+        const https = await import('https');
+        const auth = Buffer.from(`${credentials.email}:${credentials.apiToken}`).toString('base64');
+        return new Promise((resolve) => {
+            const req = https.request({
+                hostname: credentials.domain,
+                path: '/rest/api/3/myself',
+                method: 'GET',
+                headers: {
+                    Authorization: `Basic ${auth}`,
+                    'Content-Type': 'application/json',
+                },
+            }, (res) => {
+                resolve(res.statusCode === 200);
+            });
+            req.on('error', () => resolve(false));
+            req.setTimeout(5000, () => {
+                req.destroy();
+                resolve(false);
+            });
+            req.end();
+        });
+    }
+    catch (error) {
+        return false;
+    }
+}
+/**
+ * Save credentials to .env using credentialsManager
+ */
+async function saveCredentialsToEnv(credentials) {
+    console.log('💡 Save credentials to .env for future use\n');
+    const { saveToEnv } = await inquirer.prompt([
+        {
+            type: 'confirm',
+            name: 'saveToEnv',
+            message: 'Save credentials to .env file?',
+            default: true,
+        },
+    ]);
+    if (saveToEnv) {
+        credentialsManager.saveToEnvFile({ jira: credentials });
+        console.log('✅ Credentials saved to .env');
+        console.log('✅ .env added to .gitignore');
+    }
+    else {
+        console.log('⚠️  Credentials not saved. You\'ll need to enter them again next time.');
+    }
+}
+// ============================================================================
+// Export Helpers
+// ============================================================================
+/**
+ * Get Jira credentials - smart detection with fallback to interactive setup
+ */
+export async function getJiraCredentials() {
+    const detected = await detectJiraCredentials();
+    if (detected.found) {
+        return detected.credentials;
+    }
+    // Not found - run interactive setup
+    return setupJiraCredentials();
+}
+//# sourceMappingURL=setup-wizard.js.map

package/dist/plugins/specweave-jira/lib/setup-wizard.js.map

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

package/dist/plugins/specweave-release/lib/dashboard-generator.d.ts

@@ -0,0 +1,23 @@
+/**
+ * DORA Dashboard Generator
+ *
+ * Generates living docs dashboard with trends and visual indicators
+ *
+ * Output: .specweave/docs/internal/delivery/dora-dashboard.md
+ *
+ * Features:
+ * - Current metrics with tier indicators (✅ Elite, 🟢 High, 🟡 Medium, 🔴 Low)
+ * - 7-day, 30-day, 90-day trend charts
+ * - Percentage changes with up/down arrows
+ * - Degradation alerts
+ * - Links to detailed reports and ADRs
+ */
+/**
+ * Generate DORA dashboard markdown
+ */
+export declare function generateDashboard(): string;
+/**
+ * Write dashboard to file
+ */
+export declare function writeDashboard(): void;
+//# sourceMappingURL=dashboard-generator.d.ts.map

package/dist/plugins/specweave-release/lib/dashboard-generator.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"dashboard-generator.d.ts","sourceRoot":"","sources":["../../../../plugins/specweave-release/lib/dashboard-generator.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;GAaG;AA8FH;;GAEG;AACH,wBAAgB,iBAAiB,IAAI,MAAM,CA6I1C;AAED;;GAEG;AACH,wBAAgB,cAAc,IAAI,IAAI,CAarC"}

package/dist/plugins/specweave-release/lib/dashboard-generator.js

@@ -0,0 +1,258 @@
+/**
+ * DORA Dashboard Generator
+ *
+ * Generates living docs dashboard with trends and visual indicators
+ *
+ * Output: .specweave/docs/internal/delivery/dora-dashboard.md
+ *
+ * Features:
+ * - Current metrics with tier indicators (✅ Elite, 🟢 High, 🟡 Medium, 🔴 Low)
+ * - 7-day, 30-day, 90-day trend charts
+ * - Percentage changes with up/down arrows
+ * - Degradation alerts
+ * - Links to detailed reports and ADRs
+ */
+import * as fs from 'fs';
+import * as path from 'path';
+import { readHistory, calculateTrend, detectDegradation, getLatestSnapshot, } from './dora-tracker.js';
+// ============================================================================
+// Constants
+// ============================================================================
+const SPECWEAVE_ROOT = process.cwd();
+const DASHBOARD_PATH = path.join(SPECWEAVE_ROOT, '.specweave', 'docs', 'internal', 'delivery', 'dora-dashboard.md');
+// ============================================================================
+// Utility Functions
+// ============================================================================
+/**
+ * Get tier indicator icon
+ */
+function getTierIcon(tier) {
+    switch (tier) {
+        case 'elite': return '✅';
+        case 'high': return '🟢';
+        case 'medium': return '🟡';
+        case 'low': return '🔴';
+        default: return '⚪';
+    }
+}
+/**
+ * Format trend change with arrow
+ */
+function formatTrendChange(change) {
+    if (change > 0) {
+        return `↑ +${change.toFixed(1)}%`;
+    }
+    else if (change < 0) {
+        return `↓ ${change.toFixed(1)}%`;
+    }
+    else {
+        return `→ 0%`;
+    }
+}
+/**
+ * Get overall tier (worst of all 4 metrics)
+ */
+function getOverallTier(snapshot) {
+    const tiers = [
+        snapshot.deploymentFrequency.tier,
+        snapshot.leadTime.tier,
+        snapshot.changeFailureRate.tier,
+        snapshot.mttr.tier === 'n/a' ? 'elite' : snapshot.mttr.tier, // Treat N/A as elite (no incidents)
+    ];
+    // Count metrics at each tier
+    const count = {
+        elite: tiers.filter(t => t === 'elite').length,
+        high: tiers.filter(t => t === 'high').length,
+        medium: tiers.filter(t => t === 'medium').length,
+        low: tiers.filter(t => t === 'low').length,
+    };
+    // Overall tier = worst tier (prioritize low > medium > high > elite)
+    let overallTier = 'elite';
+    if (count.low > 0)
+        overallTier = 'low';
+    else if (count.medium > 0)
+        overallTier = 'medium';
+    else if (count.high > 0)
+        overallTier = 'high';
+    return {
+        tier: overallTier,
+        icon: getTierIcon(overallTier),
+        count,
+    };
+}
+// ============================================================================
+// Dashboard Generation
+// ============================================================================
+/**
+ * Generate DORA dashboard markdown
+ */
+export function generateDashboard() {
+    const latest = getLatestSnapshot();
+    if (!latest) {
+        return `# DORA Metrics Dashboard
+
+**Status**: No metrics data available
+
+Run \`npm run metrics:dora\` to calculate DORA metrics.
+`;
+    }
+    const overall = getOverallTier(latest);
+    const alerts = detectDegradation();
+    // Header
+    let markdown = `# DORA Metrics Dashboard
+
+**Last Updated**: ${new Date().toISOString().split('T')[0]} ${new Date().toTimeString().split(' ')[0]} UTC
+**Overall Rating**: ${overall.icon} **${overall.tier.charAt(0).toUpperCase() + overall.tier.slice(1)}** (${overall.count.elite} Elite, ${overall.count.high} High, ${overall.count.medium} Medium, ${overall.count.low} Low)
+
+---
+
+## Current Metrics
+
+`;
+    // Metrics table
+    const metrics = [
+        {
+            name: 'Deployment Frequency',
+            key: 'deploymentFrequency',
+            current: `${latest.deploymentFrequency.value} ${latest.deploymentFrequency.unit}`,
+            tier: latest.deploymentFrequency.tier,
+        },
+        {
+            name: 'Lead Time for Changes',
+            key: 'leadTime',
+            current: `${latest.leadTime.value} ${latest.leadTime.unit}`,
+            tier: latest.leadTime.tier,
+        },
+        {
+            name: 'Change Failure Rate',
+            key: 'changeFailureRate',
+            current: `${latest.changeFailureRate.value}%`,
+            tier: latest.changeFailureRate.tier,
+        },
+        {
+            name: 'Time to Restore Service (MTTR)',
+            key: 'mttr',
+            current: latest.mttr.tier === 'n/a' ? 'N/A (No incidents)' : `${latest.mttr.value} ${latest.mttr.unit}`,
+            tier: latest.mttr.tier,
+        },
+    ];
+    markdown += `| Metric | Current | 7-Day Trend | 30-Day Trend | 90-Day Trend | Tier |\n`;
+    markdown += `|--------|---------|-------------|--------------|--------------|------|\n`;
+    metrics.forEach(metric => {
+        const trend = calculateTrend(metric.key);
+        const sevenDay = trend ? formatTrendChange(trend.sevenDayChange) : '-';
+        const thirtyDay = trend ? formatTrendChange(trend.thirtyDayChange) : '-';
+        const ninetyDay = trend ? formatTrendChange(trend.ninetyDayChange) : '-';
+        markdown += `| **${metric.name}** | ${metric.current} | ${sevenDay} | ${thirtyDay} | ${ninetyDay} | ${getTierIcon(metric.tier)} ${metric.tier.charAt(0).toUpperCase() + metric.tier.slice(1)} |\n`;
+    });
+    markdown += `\n`;
+    // Degradation Alerts
+    if (alerts.length > 0) {
+        markdown += `## ⚠️ Degradation Alerts\n\n`;
+        alerts.forEach(alert => {
+            const icon = alert.severity === 'critical' ? '🔴' : '🟠';
+            markdown += `${icon} **${alert.metric}**: ${alert.message}\n`;
+            markdown += `- Previous (30-day avg): ${alert.previousValue.toFixed(2)}\n`;
+            markdown += `- Current: ${alert.currentValue.toFixed(2)}\n`;
+            markdown += `- Change: ${alert.percentageChange.toFixed(1)}%\n\n`;
+        });
+    }
+    else {
+        markdown += `## ✅ No Degradation Detected\n\nAll metrics are stable or improving compared to 30-day averages.\n\n`;
+    }
+    // Tier Reference
+    markdown += `---
+
+## DORA Performance Tiers
+
+| Metric | Elite | High | Medium | Low |
+|--------|-------|------|--------|-----|
+| **Deployment Frequency** | On-demand (multiple/day) | Weekly - Monthly | Monthly - 6 months | < 6 months |
+| **Lead Time for Changes** | < 1 hour | 1 day - 1 week | 1 week - 1 month | 1-6 months |
+| **Change Failure Rate** | 0-15% | 16-30% | 31-45% | > 45% |
+| **Time to Restore Service** | < 1 hour | < 1 day | 1 day - 1 week | > 1 week |
+
+**Source**: [DORA State of DevOps Research](https://dora.dev/)
+
+---
+
+## Historical Trends
+
+**Total Snapshots**: ${readHistory().length}
+
+**Data Retention**: All snapshots stored in \`.specweave/metrics/dora-history.jsonl\`
+
+**Calculation Frequency**: After every increment completion (automated via hooks)
+
+---
+
+## Related Documentation
+
+- [DORA Metrics (Detailed)](./dora-metrics.md) - Full methodology and measurement details
+- [Release Process](./release-process.md) - Release workflow and best practices
+- [Testing Strategy](./guides/testing-strategy.md) - Testing approach linked to change failure rate
+- [Branch Strategy](./branch-strategy.md) - Git workflow linked to lead time
+
+---
+
+## Actions
+
+**If metrics are degrading**:
+
+1. **Review Recent Changes** - What changed in the last 30 days?
+2. **Analyze Root Cause** - Use incident reports, test failures, deployment logs
+3. **Create ADR** - Document decision to address degradation
+4. **Implement Improvements** - Create increment to fix underlying issues
+5. **Monitor Progress** - Track metrics recovery over next 30 days
+
+**If metrics are improving**:
+
+1. **Document Success** - What practices led to improvement?
+2. **Share Knowledge** - Update team playbooks with learnings
+3. **Maintain Momentum** - Continue proven practices
+4. **Set New Goals** - Aim for next tier (High → Elite)
+
+---
+
+**Dashboard Auto-Generated**: ${new Date().toISOString()}
+**Generator**: \`plugins/specweave-release/lib/dashboard-generator.ts\`
+`;
+    return markdown;
+}
+/**
+ * Write dashboard to file
+ */
+export function writeDashboard() {
+    const markdown = generateDashboard();
+    // Ensure directory exists
+    const dir = path.dirname(DASHBOARD_PATH);
+    if (!fs.existsSync(dir)) {
+        fs.mkdirSync(dir, { recursive: true });
+    }
+    // Write dashboard
+    fs.writeFileSync(DASHBOARD_PATH, markdown, 'utf-8');
+    console.log(`✓ Dashboard generated: ${DASHBOARD_PATH}`);
+}
+// ============================================================================
+// CLI Entry Point
+// ============================================================================
+/**
+ * CLI tool for dashboard generation
+ *
+ * Usage: npm run dora:dashboard
+ */
+async function main() {
+    try {
+        writeDashboard();
+        console.log('✅ DORA dashboard generated successfully');
+    }
+    catch (error) {
+        console.error('❌ Failed to generate dashboard:', error);
+        process.exit(1);
+    }
+}
+// Run CLI if executed directly
+if (require.main === module) {
+    main().catch(console.error);
+}
+//# sourceMappingURL=dashboard-generator.js.map

package/dist/plugins/specweave-release/lib/dashboard-generator.js.map

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

package/dist/plugins/specweave-release/lib/dora-tracker.d.ts

@@ -0,0 +1,82 @@
+/**
+ * DORA Metrics Persistent Tracking
+ *
+ * Stores DORA metrics in append-only JSONL format for historical tracking and trending
+ *
+ * Features:
+ * - Append-only JSONL storage (.specweave/metrics/dora-history.jsonl)
+ * - Trend calculation (7-day, 30-day, 90-day rolling averages)
+ * - Degradation detection (alert if metrics worsen >20%)
+ * - Living docs integration (auto-update dashboard)
+ */
+export interface DORAMetric {
+    value: number;
+    unit: string;
+    tier: 'elite' | 'high' | 'medium' | 'low' | 'n/a';
+}
+export interface DORASnapshot {
+    timestamp: string;
+    deploymentFrequency: DORAMetric;
+    leadTime: DORAMetric;
+    changeFailureRate: DORAMetric;
+    mttr: DORAMetric;
+}
+export interface TrendData {
+    current: number;
+    sevenDay: number;
+    thirtyDay: number;
+    ninetyDay: number;
+    sevenDayChange: number;
+    thirtyDayChange: number;
+    ninetyDayChange: number;
+}
+export interface DegradationAlert {
+    metric: string;
+    currentValue: number;
+    previousValue: number;
+    percentageChange: number;
+    severity: 'warning' | 'critical';
+    message: string;
+}
+/**
+ * Append DORA snapshot to history file (JSONL format)
+ *
+ * @param snapshot - DORA metrics snapshot
+ */
+export declare function appendSnapshot(snapshot: DORASnapshot): void;
+/**
+ * Read all DORA snapshots from history file
+ *
+ * @returns Array of DORA snapshots (oldest first)
+ */
+export declare function readHistory(): DORASnapshot[];
+/**
+ * Calculate trend data for a specific metric
+ *
+ * @param metricName - Name of metric ('deploymentFrequency', 'leadTime', etc.)
+ * @returns Trend data with current, 7-day, 30-day, 90-day averages and changes
+ */
+export declare function calculateTrend(metricName: keyof DORASnapshot): TrendData | null;
+/**
+ * Detect metric degradation (>20% worsening)
+ *
+ * @returns Array of degradation alerts (empty if no degradation detected)
+ */
+export declare function detectDegradation(): DegradationAlert[];
+/**
+ * Get latest DORA snapshot
+ *
+ * @returns Latest snapshot, or null if no history
+ */
+export declare function getLatestSnapshot(): DORASnapshot | null;
+/**
+ * Get snapshot count
+ *
+ * @returns Number of snapshots in history
+ */
+export declare function getSnapshotCount(): number;
+/**
+ * Clear history (use with caution!)
+ */
+export declare function clearHistory(): void;
+//# sourceMappingURL=dora-tracker.d.ts.map

package/dist/plugins/specweave-release/lib/dora-tracker.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"dora-tracker.d.ts","sourceRoot":"","sources":["../../../../plugins/specweave-release/lib/dora-tracker.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AASH,MAAM,WAAW,UAAU;IACzB,KAAK,EAAE,MAAM,CAAC;IACd,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,OAAO,GAAG,MAAM,GAAG,QAAQ,GAAG,KAAK,GAAG,KAAK,CAAC;CACnD;AAED,MAAM,WAAW,YAAY;IAC3B,SAAS,EAAE,MAAM,CAAC;IAClB,mBAAmB,EAAE,UAAU,CAAC;IAChC,QAAQ,EAAE,UAAU,CAAC;IACrB,iBAAiB,EAAE,UAAU,CAAC;IAC9B,IAAI,EAAE,UAAU,CAAC;CAClB;AAED,MAAM,WAAW,SAAS;IACxB,OAAO,EAAE,MAAM,CAAC;IAChB,QAAQ,EAAE,MAAM,CAAC;IACjB,SAAS,EAAE,MAAM,CAAC;IAClB,SAAS,EAAE,MAAM,CAAC;IAClB,cAAc,EAAE,MAAM,CAAC;IACvB,eAAe,EAAE,MAAM,CAAC;IACxB,eAAe,EAAE,MAAM,CAAC;CACzB;AAED,MAAM,WAAW,gBAAgB;IAC/B,MAAM,EAAE,MAAM,CAAC;IACf,YAAY,EAAE,MAAM,CAAC;IACrB,aAAa,EAAE,MAAM,CAAC;IACtB,gBAAgB,EAAE,MAAM,CAAC;IACzB,QAAQ,EAAE,SAAS,GAAG,UAAU,CAAC;IACjC,OAAO,EAAE,MAAM,CAAC;CACjB;AAeD;;;;GAIG;AACH,wBAAgB,cAAc,CAAC,QAAQ,EAAE,YAAY,GAAG,IAAI,CAW3D;AAED;;;;GAIG;AACH,wBAAgB,WAAW,IAAI,YAAY,EAAE,CAS5C;AAiCD;;;;;GAKG;AACH,wBAAgB,cAAc,CAAC,UAAU,EAAE,MAAM,YAAY,GAAG,SAAS,GAAG,IAAI,CA2C/E;AAED;;;;GAIG;AACH,wBAAgB,iBAAiB,IAAI,gBAAgB,EAAE,CAuDtD;AAED;;;;GAIG;AACH,wBAAgB,iBAAiB,IAAI,YAAY,GAAG,IAAI,CAGvD;AAED;;;;GAIG;AACH,wBAAgB,gBAAgB,IAAI,MAAM,CAEzC;AAED;;GAEG;AACH,wBAAgB,YAAY,IAAI,IAAI,CAKnC"}