specweave 0.6.8 → 0.7.0

package/dist/hooks/lib/translate-file.js

@@ -0,0 +1,350 @@
+/**
+ * File Translation CLI Utility
+ *
+ * Translates a single file from detected source language to target language
+ * using the translation utilities and LLM invocation.
+ *
+ * This script is called from:
+ * - Post-increment-planning hook (auto-translate spec.md, plan.md, tasks.md)
+ * - Post-task-completion hook (auto-translate living docs)
+ * - Manual /specweave:translate command
+ *
+ * Usage:
+ *   node translate-file.js <file-path> [--target-lang en] [--preview]
+ *
+ * @see src/utils/translation.ts
+ * @see .specweave/increments/0006-llm-native-i18n/reports/DESIGN-POST-GENERATION-TRANSLATION.md
+ */
+import fs from 'fs-extra';
+import { detectLanguage, prepareTranslation, postProcessTranslation, validateTranslation, getLanguageName, formatCost, } from '../../utils/translation.js';
+/**
+ * Main translation function
+ *
+ * @param options - CLI options
+ * @returns Translation result
+ */
+export async function translateFile(options) {
+    const { filePath, targetLang, preview, verbose } = options;
+    // 1. Validate file exists
+    if (!await fs.pathExists(filePath)) {
+        throw new Error(`File not found: ${filePath}`);
+    }
+    if (verbose) {
+        console.log(`📄 Reading file: ${filePath}`);
+    }
+    // 2. Read original content
+    const originalContent = await fs.readFile(filePath, 'utf-8');
+    // 3. Detect source language
+    const detectionResult = detectLanguage(originalContent);
+    const sourceLanguage = detectionResult.language;
+    if (verbose) {
+        console.log(`🔍 Detected language: ${getLanguageName(sourceLanguage)} (confidence: ${(detectionResult.confidence * 100).toFixed(0)}%)`);
+    }
+    // 4. Check if already in target language
+    if (sourceLanguage === targetLang) {
+        if (verbose) {
+            console.log(`✅ File already in ${getLanguageName(targetLang)}, skipping translation`);
+        }
+        return {
+            success: true,
+            filePath,
+            sourceLanguage,
+            targetLanguage: targetLang,
+            warnings: [`Already in ${getLanguageName(targetLang)}`],
+            cost: 0,
+            tokensUsed: 0,
+        };
+    }
+    // 5. Check if source language is unknown
+    if (sourceLanguage === 'unknown') {
+        if (verbose) {
+            console.warn(`⚠️  Could not detect language, assuming English`);
+        }
+        // Assume English if detection fails
+        return {
+            success: false,
+            filePath,
+            sourceLanguage: 'unknown',
+            targetLanguage: targetLang,
+            warnings: ['Language detection failed - file may already be in English or mixed language'],
+            cost: 0,
+            tokensUsed: 0,
+        };
+    }
+    // 6. Prepare translation
+    if (verbose) {
+        console.log(`🌐 Translating from ${getLanguageName(sourceLanguage)} to ${getLanguageName(targetLang)}...`);
+        console.log(`💰 Estimated cost: ${formatCost(0.003)} (using Haiku)`);
+    }
+    const prepared = prepareTranslation(originalContent, sourceLanguage, targetLang);
+    // 7. Invoke LLM for translation
+    // NOTE: This is where we call the actual LLM
+    // For now, we'll create a simple prompt that can be used with Claude Code's Task tool
+    const translatedContent = await invokeLLMTranslation(prepared.prompt, verbose);
+    // 8. Post-process translation
+    const finalContent = postProcessTranslation(translatedContent, prepared.preserved);
+    // 9. Validate translation
+    const warnings = validateTranslation(originalContent, finalContent);
+    if (warnings.length > 0 && verbose) {
+        console.warn(`⚠️  Translation warnings:`);
+        warnings.forEach(w => console.warn(`   - ${w}`));
+    }
+    // 10. Preview or write
+    if (preview) {
+        if (verbose) {
+            console.log(`\n📋 PREVIEW (first 500 chars):\n`);
+            console.log(finalContent.substring(0, 500));
+            console.log(`\n... (${finalContent.length} total characters)\n`);
+        }
+        return {
+            success: true,
+            filePath,
+            sourceLanguage,
+            targetLanguage: targetLang,
+            warnings,
+            cost: prepared.estimatedCost,
+            tokensUsed: prepared.estimatedTokens,
+            preview: finalContent,
+        };
+    }
+    else {
+        // Write translated content back to file
+        await fs.writeFile(filePath, finalContent, 'utf-8');
+        if (verbose) {
+            console.log(`✅ Translation complete: ${filePath}`);
+            console.log(`   Tokens used: ${prepared.estimatedTokens.toLocaleString()}`);
+            console.log(`   Cost: ${formatCost(prepared.estimatedCost)}`);
+        }
+        return {
+            success: true,
+            filePath,
+            sourceLanguage,
+            targetLanguage: targetLang,
+            warnings,
+            cost: prepared.estimatedCost,
+            tokensUsed: prepared.estimatedTokens,
+        };
+    }
+}
+/**
+ * Invokes LLM for translation using Anthropic API
+ *
+ * PRODUCTION IMPLEMENTATION:
+ * 1. Checks for ANTHROPIC_API_KEY in environment
+ * 2. If available: Uses Anthropic API directly (fully automatic)
+ * 3. If not available: Provides clear instructions for manual translation
+ *
+ * @param prompt - Translation prompt
+ * @param verbose - Show detailed output
+ * @returns Translated content
+ */
+async function invokeLLMTranslation(prompt, verbose) {
+    // Extract the content to translate (between --- markers)
+    const contentMatch = prompt.match(/SOURCE DOCUMENT[^\n]*:\n---\n([\s\S]*?)\n---/);
+    const contentToTranslate = contentMatch ? contentMatch[1] : '';
+    // Check if ANTHROPIC_API_KEY is available
+    const apiKey = process.env.ANTHROPIC_API_KEY;
+    if (apiKey) {
+        // Fully automatic translation using Anthropic API
+        if (verbose) {
+            console.log(`\n🤖 Translating via Anthropic API (Haiku model)...`);
+        }
+        try {
+            // Dynamic import of Anthropic SDK (allows graceful fallback if not installed)
+            const Anthropic = await import('@anthropic-ai/sdk').then(m => m.default);
+            const anthropic = new Anthropic({
+                apiKey,
+            });
+            const message = await anthropic.messages.create({
+                model: 'claude-3-haiku-20240307',
+                max_tokens: 8000,
+                messages: [
+                    {
+                        role: 'user',
+                        content: prompt,
+                    },
+                ],
+            });
+            // Extract translated content from response
+            const translatedContent = message.content[0].type === 'text'
+                ? message.content[0].text
+                : contentToTranslate;
+            if (verbose) {
+                console.log(`✅ Translation complete via API`);
+                console.log(`   Model: claude-3-haiku-20240307`);
+                console.log(`   Input tokens: ${message.usage.input_tokens}`);
+                console.log(`   Output tokens: ${message.usage.output_tokens}`);
+                console.log(`   Cost: ~$${((message.usage.input_tokens * 0.25 + message.usage.output_tokens * 1.25) / 1000000).toFixed(4)}`);
+            }
+            return translatedContent;
+        }
+        catch (error) {
+            console.error(`\n❌ API translation failed: ${error.message}`);
+            console.error(`   Falling back to manual translation instructions\n`);
+            // Fall through to manual instructions
+        }
+    }
+    // Fallback: Manual translation instructions
+    const isInteractive = process.stdout.isTTY && process.env.CLAUDE_CODE_SESSION;
+    if (isInteractive) {
+        // Interactive mode: Output prompt for Claude to process
+        if (verbose) {
+            console.log(`\n🤖 Invoking Claude Code translator skill...`);
+            console.log(`   (Tip: Set ANTHROPIC_API_KEY for fully automatic translation)\n`);
+        }
+        // Output the translation prompt
+        // The translator skill should auto-activate on this prompt
+        console.log('\n' + '='.repeat(80));
+        console.log('TRANSLATION REQUEST (translator skill will auto-activate):');
+        console.log('='.repeat(80));
+        console.log(prompt);
+        console.log('='.repeat(80) + '\n');
+        // In interactive mode, we expect the user/Claude to provide translation
+        // For now, return a marker indicating manual intervention needed
+        return `<!-- ⚠️ TRANSLATION IN PROGRESS - Manual translation required via translator skill -->\n\n${contentToTranslate}`;
+    }
+    else {
+        // Non-interactive/automated mode: Provide clear instructions
+        if (verbose) {
+            console.log(`\n🤖 Generating translation (automated mode)...`);
+        }
+        console.error('\n⚠️  AUTO-TRANSLATION REQUIRES MANUAL STEP:');
+        console.error('   Option A (Recommended): Set ANTHROPIC_API_KEY environment variable');
+        console.error('   Option B: Run /specweave:translate <file-path>');
+        console.error('   Option C: Manually translate the content\n');
+        // Return original content with clear marker
+        return `<!-- ⚠️ AUTO-TRANSLATION PENDING -->\n<!-- Set ANTHROPIC_API_KEY for automatic translation -->\n<!-- Or run: /specweave:translate to complete -->\n<!-- Original content below -->\n\n${contentToTranslate}`;
+    }
+}
+/**
+ * Batch translate multiple files
+ *
+ * @param filePaths - Array of file paths to translate
+ * @param targetLang - Target language
+ * @param preview - Preview mode
+ * @param verbose - Verbose output
+ * @returns Array of translation results
+ */
+export async function batchTranslateFiles(filePaths, targetLang = 'en', preview = false, verbose = false) {
+    const results = [];
+    if (verbose) {
+        console.log(`\n🔄 Batch translating ${filePaths.length} file(s) to ${getLanguageName(targetLang)}...\n`);
+    }
+    for (const filePath of filePaths) {
+        try {
+            const result = await translateFile({
+                filePath,
+                targetLang,
+                preview,
+                verbose,
+            });
+            results.push(result);
+        }
+        catch (error) {
+            if (verbose) {
+                console.error(`❌ Error translating ${filePath}: ${error.message}`);
+            }
+            results.push({
+                success: false,
+                filePath,
+                sourceLanguage: 'unknown',
+                targetLanguage: targetLang,
+                warnings: [error.message],
+                cost: 0,
+                tokensUsed: 0,
+            });
+        }
+    }
+    // Summary
+    if (verbose) {
+        const successful = results.filter(r => r.success).length;
+        const totalCost = results.reduce((sum, r) => sum + r.cost, 0);
+        const totalTokens = results.reduce((sum, r) => sum + r.tokensUsed, 0);
+        console.log(`\n📊 Batch Translation Summary:`);
+        console.log(`   Successful: ${successful}/${filePaths.length}`);
+        console.log(`   Total tokens: ${totalTokens.toLocaleString()}`);
+        console.log(`   Total cost: ${formatCost(totalCost)}`);
+    }
+    return results;
+}
+/**
+ * Parse CLI arguments
+ */
+function parseArgs() {
+    const args = process.argv.slice(2);
+    if (args.length === 0 || args[0] === '--help' || args[0] === '-h') {
+        console.log(`
+Translation CLI Utility
+
+Usage:
+  node translate-file.js <file-path> [options]
+
+Options:
+  --target-lang <code>  Target language (default: en)
+  --preview             Preview translation without writing to file
+  --verbose, -v         Show detailed output
+  --help, -h            Show this help message
+
+Supported Languages:
+  en (English), ru (Russian), es (Spanish), zh (Chinese),
+  de (German), fr (French), ja (Japanese), ko (Korean),
+  pt (Portuguese), ar (Arabic), he (Hebrew)
+
+Examples:
+  # Translate Russian file to English
+  node translate-file.js .specweave/increments/0001/spec.md
+
+  # Preview translation
+  node translate-file.js spec.md --preview --verbose
+
+  # Translate to Spanish
+  node translate-file.js plan.md --target-lang es
+    `.trim());
+        process.exit(0);
+    }
+    const filePath = args[0];
+    let targetLang = 'en';
+    let preview = false;
+    let verbose = false;
+    // Parse options
+    for (let i = 1; i < args.length; i++) {
+        const arg = args[i];
+        if (arg === '--target-lang' && args[i + 1]) {
+            targetLang = args[i + 1];
+            i++;
+        }
+        else if (arg === '--preview') {
+            preview = true;
+        }
+        else if (arg === '--verbose' || arg === '-v') {
+            verbose = true;
+        }
+    }
+    return {
+        filePath,
+        targetLang,
+        preview,
+        verbose,
+    };
+}
+/**
+ * CLI entry point
+ */
+async function main() {
+    try {
+        const options = parseArgs();
+        const result = await translateFile(options);
+        // Exit with appropriate code
+        process.exit(result.success ? 0 : 1);
+    }
+    catch (error) {
+        console.error(`❌ Translation failed: ${error.message}`);
+        process.exit(1);
+    }
+}
+// Check if running as main module (ESM)
+const isMainModule = import.meta.url === `file://${process.argv[1]}`;
+if (isMainModule) {
+    main();
+}
+//# sourceMappingURL=translate-file.js.map

package/dist/hooks/lib/translate-file.js.map

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

package/dist/locales/en/cli.json

@@ -66,6 +66,7 @@
       "header": "AI Tool Detection",
       "detected": "Detected: {{tool}}",
       "confirmPrompt": "Use {{tool}} for this project?",
+      "ciAutoConfirm": "CI environment detected - auto-confirming {{tool}}",
       "selectPrompt": "Which AI tool will you use?",
       "recommended": "Recommended - Full automation",
       "tools": {
@@ -87,7 +88,8 @@
       "copiedSkills": "✓ Copied {{count}} skill directories",
       "copiedHooks": "✓ Copied {{count}} hook files",
       "pluginAutoSetupDetails": "Claude Code will auto-load SpecWeave marketplace when you trust this folder",
-      "manualInstallInstructions": "Run manually: /plugin install specweave-core@specweave"
+      "manualInstallInstructions": "Run manually: /plugin install specweave-core@specweave",
+      "ciSkipPlugins": "CI environment detected - skipping plugin enablement (can configure manually later)"
     },
     "success": {
       "pluginAutoSetup": "Plugin marketplace configured for automatic loading",

package/dist/metrics/calculators/change-failure-rate.d.ts

@@ -0,0 +1,22 @@
+/**
+ * Change Failure Rate Calculator
+ *
+ * Calculates percentage of deployments that cause failures (DORA metric #3)
+ * Data source: GitHub Issues with labels "incident" or "production-bug"
+ */
+import { Release, Issue, ChangeFailureRateMetric } from '../types';
+/**
+ * Calculate Change Failure Rate
+ *
+ * Methodology:
+ * 1. Find issues labeled "incident" or "production-bug"
+ * 2. Link each incident to the most recent release before it
+ * 3. Calculate percentage of releases with incidents
+ * 4. Classify into DORA tier
+ *
+ * @param releases - Array of GitHub releases
+ * @param issues - Array of GitHub issues
+ * @returns Change failure rate metric
+ */
+export declare function calculateChangeFailureRate(releases: Release[], issues: Issue[]): ChangeFailureRateMetric;
+//# sourceMappingURL=change-failure-rate.d.ts.map

package/dist/metrics/calculators/change-failure-rate.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"change-failure-rate.d.ts","sourceRoot":"","sources":["../../../src/metrics/calculators/change-failure-rate.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,EAAE,OAAO,EAAE,KAAK,EAAE,uBAAuB,EAAE,MAAM,UAAU,CAAC;AAGnE;;;;;;;;;;;;GAYG;AACH,wBAAgB,0BAA0B,CACxC,QAAQ,EAAE,OAAO,EAAE,EACnB,MAAM,EAAE,KAAK,EAAE,GACd,uBAAuB,CAkEzB"}

package/dist/metrics/calculators/change-failure-rate.js

@@ -0,0 +1,70 @@
+/**
+ * Change Failure Rate Calculator
+ *
+ * Calculates percentage of deployments that cause failures (DORA metric #3)
+ * Data source: GitHub Issues with labels "incident" or "production-bug"
+ */
+import { classifyChangeFailureRate } from '../utils/tier-classifier';
+/**
+ * Calculate Change Failure Rate
+ *
+ * Methodology:
+ * 1. Find issues labeled "incident" or "production-bug"
+ * 2. Link each incident to the most recent release before it
+ * 3. Calculate percentage of releases with incidents
+ * 4. Classify into DORA tier
+ *
+ * @param releases - Array of GitHub releases
+ * @param issues - Array of GitHub issues
+ * @returns Change failure rate metric
+ */
+export function calculateChangeFailureRate(releases, issues) {
+    // Handle zero releases
+    if (releases.length === 0) {
+        return {
+            value: 0,
+            unit: 'percentage',
+            tier: 'N/A',
+            failedReleases: 0,
+            totalReleases: 0,
+        };
+    }
+    // Filter incidents (issues with incident or production-bug labels)
+    const incidents = issues.filter(issue => issue.labels.some(label => label.name === 'incident' || label.name === 'production-bug'));
+    // Handle zero incidents (perfect!)
+    if (incidents.length === 0) {
+        return {
+            value: 0,
+            unit: 'percentage',
+            tier: 'Elite',
+            failedReleases: 0,
+            totalReleases: releases.length,
+        };
+    }
+    // Sort releases by date (newest first)
+    const sortedReleases = [...releases].sort((a, b) => new Date(b.published_at).getTime() - new Date(a.published_at).getTime());
+    // Track which releases had incidents
+    const failedReleaseIds = new Set();
+    incidents.forEach(incident => {
+        const incidentDate = new Date(incident.created_at);
+        // Find most recent release before this incident
+        const applicableRelease = sortedReleases.find(release => new Date(release.published_at) <= incidentDate);
+        if (applicableRelease) {
+            failedReleaseIds.add(applicableRelease.id);
+        }
+    });
+    // Calculate failure rate
+    const failedReleases = failedReleaseIds.size;
+    const totalReleases = releases.length;
+    const failureRate = (failedReleases / totalReleases) * 100;
+    // Classify tier
+    const tier = classifyChangeFailureRate(failureRate);
+    return {
+        value: Math.round(failureRate * 10) / 10, // Round to 1 decimal
+        unit: 'percentage',
+        tier,
+        failedReleases,
+        totalReleases,
+    };
+}
+//# sourceMappingURL=change-failure-rate.js.map

package/dist/metrics/calculators/change-failure-rate.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"change-failure-rate.js","sourceRoot":"","sources":["../../../src/metrics/calculators/change-failure-rate.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAGH,OAAO,EAAE,yBAAyB,EAAE,MAAM,0BAA0B,CAAC;AAErE;;;;;;;;;;;;GAYG;AACH,MAAM,UAAU,0BAA0B,CACxC,QAAmB,EACnB,MAAe;IAEf,uBAAuB;IACvB,IAAI,QAAQ,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;QAC1B,OAAO;YACL,KAAK,EAAE,CAAC;YACR,IAAI,EAAE,YAAY;YAClB,IAAI,EAAE,KAAK;YACX,cAAc,EAAE,CAAC;YACjB,aAAa,EAAE,CAAC;SACjB,CAAC;IACJ,CAAC;IAED,mEAAmE;IACnE,MAAM,SAAS,GAAG,MAAM,CAAC,MAAM,CAAC,KAAK,CAAC,EAAE,CACtC,KAAK,CAAC,MAAM,CAAC,IAAI,CAAC,KAAK,CAAC,EAAE,CACxB,KAAK,CAAC,IAAI,KAAK,UAAU,IAAI,KAAK,CAAC,IAAI,KAAK,gBAAgB,CAC7D,CACF,CAAC;IAEF,mCAAmC;IACnC,IAAI,SAAS,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;QAC3B,OAAO;YACL,KAAK,EAAE,CAAC;YACR,IAAI,EAAE,YAAY;YAClB,IAAI,EAAE,OAAO;YACb,cAAc,EAAE,CAAC;YACjB,aAAa,EAAE,QAAQ,CAAC,MAAM;SAC/B,CAAC;IACJ,CAAC;IAED,uCAAuC;IACvC,MAAM,cAAc,GAAG,CAAC,GAAG,QAAQ,CAAC,CAAC,IAAI,CACvC,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC,IAAI,IAAI,CAAC,CAAC,CAAC,YAAY,CAAC,CAAC,OAAO,EAAE,GAAG,IAAI,IAAI,CAAC,CAAC,CAAC,YAAY,CAAC,CAAC,OAAO,EAAE,CAClF,CAAC;IAEF,qCAAqC;IACrC,MAAM,gBAAgB,GAAG,IAAI,GAAG,EAAU,CAAC;IAE3C,SAAS,CAAC,OAAO,CAAC,QAAQ,CAAC,EAAE;QAC3B,MAAM,YAAY,GAAG,IAAI,IAAI,CAAC,QAAQ,CAAC,UAAU,CAAC,CAAC;QAEnD,gDAAgD;QAChD,MAAM,iBAAiB,GAAG,cAAc,CAAC,IAAI,CAC3C,OAAO,CAAC,EAAE,CAAC,IAAI,IAAI,CAAC,OAAO,CAAC,YAAY,CAAC,IAAI,YAAY,CAC1D,CAAC;QAEF,IAAI,iBAAiB,EAAE,CAAC;YACtB,gBAAgB,CAAC,GAAG,CAAC,iBAAiB,CAAC,EAAE,CAAC,CAAC;QAC7C,CAAC;IACH,CAAC,CAAC,CAAC;IAEH,yBAAyB;IACzB,MAAM,cAAc,GAAG,gBAAgB,CAAC,IAAI,CAAC;IAC7C,MAAM,aAAa,GAAG,QAAQ,CAAC,MAAM,CAAC;IACtC,MAAM,WAAW,GAAG,CAAC,cAAc,GAAG,aAAa,CAAC,GAAG,GAAG,CAAC;IAE3D,gBAAgB;IAChB,MAAM,IAAI,GAAG,yBAAyB,CAAC,WAAW,CAAC,CAAC;IAEpD,OAAO;QACL,KAAK,EAAE,IAAI,CAAC,KAAK,CAAC,WAAW,GAAG,EAAE,CAAC,GAAG,EAAE,EAAG,qBAAqB;QAChE,IAAI,EAAE,YAAY;QAClB,IAAI;QACJ,cAAc;QACd,aAAa;KACd,CAAC;AACJ,CAAC"}

package/dist/metrics/calculators/deployment-frequency.d.ts

@@ -0,0 +1,20 @@
+/**
+ * Deployment Frequency Calculator
+ *
+ * Calculates how often deployments occur (DORA metric #1)
+ * Data source: GitHub Releases API
+ */
+import { Release, DeploymentFrequencyMetric } from '../types';
+/**
+ * Calculate Deployment Frequency from releases
+ *
+ * Methodology:
+ * 1. Count releases in last 30 days
+ * 2. Calculate deploys per month
+ * 3. Classify into DORA tier
+ *
+ * @param releases - Array of GitHub releases
+ * @returns Deployment frequency metric
+ */
+export declare function calculateDeploymentFrequency(releases: Release[]): DeploymentFrequencyMetric;
+//# sourceMappingURL=deployment-frequency.d.ts.map

package/dist/metrics/calculators/deployment-frequency.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"deployment-frequency.d.ts","sourceRoot":"","sources":["../../../src/metrics/calculators/deployment-frequency.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,EAAE,OAAO,EAAE,yBAAyB,EAAE,MAAM,UAAU,CAAC;AAG9D;;;;;;;;;;GAUG;AACH,wBAAgB,4BAA4B,CAC1C,QAAQ,EAAE,OAAO,EAAE,GAClB,yBAAyB,CA8C3B"}

package/dist/metrics/calculators/deployment-frequency.js

@@ -0,0 +1,61 @@
+/**
+ * Deployment Frequency Calculator
+ *
+ * Calculates how often deployments occur (DORA metric #1)
+ * Data source: GitHub Releases API
+ */
+import { classifyDeploymentFrequency } from '../utils/tier-classifier';
+/**
+ * Calculate Deployment Frequency from releases
+ *
+ * Methodology:
+ * 1. Count releases in last 30 days
+ * 2. Calculate deploys per month
+ * 3. Classify into DORA tier
+ *
+ * @param releases - Array of GitHub releases
+ * @returns Deployment frequency metric
+ */
+export function calculateDeploymentFrequency(releases) {
+    // Handle zero releases
+    if (releases.length === 0) {
+        return {
+            value: 0,
+            unit: 'deploys/month',
+            tier: 'N/A',
+            description: 'No releases yet',
+        };
+    }
+    // Count releases
+    const deployCount = releases.length;
+    // Calculate deploys per year (for tier classification)
+    // Assumes 30-day window, so multiply by 12 to get annual rate
+    const deploysPerYear = (deployCount / 30) * 365;
+    // Classify tier
+    const tier = classifyDeploymentFrequency(deploysPerYear);
+    // Generate description
+    let description = '';
+    switch (tier) {
+        case 'Elite':
+            description = 'On-demand deployment capability (multiple deploys per day)';
+            break;
+        case 'High':
+            description = 'High deployment frequency (weekly to daily)';
+            break;
+        case 'Medium':
+            description = 'Moderate deployment frequency (monthly to weekly)';
+            break;
+        case 'Low':
+            description = 'Low deployment frequency (less than monthly)';
+            break;
+        default:
+            description = 'No data available';
+    }
+    return {
+        value: deployCount,
+        unit: 'deploys/month',
+        tier,
+        description,
+    };
+}
+//# sourceMappingURL=deployment-frequency.js.map

package/dist/metrics/calculators/deployment-frequency.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"deployment-frequency.js","sourceRoot":"","sources":["../../../src/metrics/calculators/deployment-frequency.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAGH,OAAO,EAAE,2BAA2B,EAAE,MAAM,0BAA0B,CAAC;AAEvE;;;;;;;;;;GAUG;AACH,MAAM,UAAU,4BAA4B,CAC1C,QAAmB;IAEnB,uBAAuB;IACvB,IAAI,QAAQ,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;QAC1B,OAAO;YACL,KAAK,EAAE,CAAC;YACR,IAAI,EAAE,eAAe;YACrB,IAAI,EAAE,KAAK;YACX,WAAW,EAAE,iBAAiB;SAC/B,CAAC;IACJ,CAAC;IAED,iBAAiB;IACjB,MAAM,WAAW,GAAG,QAAQ,CAAC,MAAM,CAAC;IAEpC,uDAAuD;IACvD,8DAA8D;IAC9D,MAAM,cAAc,GAAG,CAAC,WAAW,GAAG,EAAE,CAAC,GAAG,GAAG,CAAC;IAEhD,gBAAgB;IAChB,MAAM,IAAI,GAAG,2BAA2B,CAAC,cAAc,CAAC,CAAC;IAEzD,uBAAuB;IACvB,IAAI,WAAW,GAAG,EAAE,CAAC;IACrB,QAAQ,IAAI,EAAE,CAAC;QACb,KAAK,OAAO;YACV,WAAW,GAAG,4DAA4D,CAAC;YAC3E,MAAM;QACR,KAAK,MAAM;YACT,WAAW,GAAG,6CAA6C,CAAC;YAC5D,MAAM;QACR,KAAK,QAAQ;YACX,WAAW,GAAG,mDAAmD,CAAC;YAClE,MAAM;QACR,KAAK,KAAK;YACR,WAAW,GAAG,8CAA8C,CAAC;YAC7D,MAAM;QACR;YACE,WAAW,GAAG,mBAAmB,CAAC;IACtC,CAAC;IAED,OAAO;QACL,KAAK,EAAE,WAAW;QAClB,IAAI,EAAE,eAAe;QACrB,IAAI;QACJ,WAAW;KACZ,CAAC;AACJ,CAAC"}

package/dist/metrics/calculators/lead-time.d.ts

@@ -0,0 +1,22 @@
+/**
+ * Lead Time for Changes Calculator
+ *
+ * Calculates time from commit to deployment (DORA metric #2)
+ * Data source: Git commits + GitHub Releases API
+ */
+import { Release, Commit, LeadTimeMetric } from '../types';
+/**
+ * Calculate Lead Time for Changes
+ *
+ * Methodology:
+ * 1. For each release, find all commits since previous release
+ * 2. Calculate time delta (commit date → release date) for each commit
+ * 3. Compute average, P50, P90
+ * 4. Classify into DORA tier
+ *
+ * @param releases - Array of GitHub releases (sorted by date desc)
+ * @param commits - Array of Git commits
+ * @returns Lead time metric
+ */
+export declare function calculateLeadTime(releases: Release[], commits: Commit[]): LeadTimeMetric;
+//# sourceMappingURL=lead-time.d.ts.map

package/dist/metrics/calculators/lead-time.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"lead-time.d.ts","sourceRoot":"","sources":["../../../src/metrics/calculators/lead-time.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,EAAE,OAAO,EAAE,MAAM,EAAE,cAAc,EAAE,MAAM,UAAU,CAAC;AAI3D;;;;;;;;;;;;GAYG;AACH,wBAAgB,iBAAiB,CAC/B,QAAQ,EAAE,OAAO,EAAE,EACnB,OAAO,EAAE,MAAM,EAAE,GAChB,cAAc,CAwEhB"}