specweave 0.6.8 → 0.7.0

package/dist/metrics/utils/percentile.d.ts

@@ -0,0 +1,25 @@
+/**
+ * Percentile Calculator
+ *
+ * Calculates Pth percentile of a dataset using linear interpolation
+ * Used for P50 (median) and P90 calculations in DORA metrics
+ */
+/**
+ * Calculate percentile value from array of numbers
+ *
+ * Uses linear interpolation method:
+ * 1. Sort values ascending
+ * 2. Calculate index: (P/100) * (n-1)
+ * 3. If index is integer, return value at that index
+ * 4. If index is fractional, interpolate between adjacent values
+ *
+ * @param values - Array of numeric values
+ * @param percentile - Percentile to calculate (0-100)
+ * @returns Percentile value
+ *
+ * @example
+ * calculatePercentile([1, 2, 3, 4, 5], 50) // Returns 3 (median)
+ * calculatePercentile([1, 2, 3, 4, 5], 90) // Returns 4.6 (P90)
+ */
+export declare function calculatePercentile(values: number[], percentile: number): number;
+//# sourceMappingURL=percentile.d.ts.map

package/dist/metrics/utils/percentile.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"percentile.d.ts","sourceRoot":"","sources":["../../../src/metrics/utils/percentile.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH;;;;;;;;;;;;;;;;GAgBG;AACH,wBAAgB,mBAAmB,CAAC,MAAM,EAAE,MAAM,EAAE,EAAE,UAAU,EAAE,MAAM,GAAG,MAAM,CA0BhF"}

package/dist/metrics/utils/percentile.js

@@ -0,0 +1,46 @@
+/**
+ * Percentile Calculator
+ *
+ * Calculates Pth percentile of a dataset using linear interpolation
+ * Used for P50 (median) and P90 calculations in DORA metrics
+ */
+/**
+ * Calculate percentile value from array of numbers
+ *
+ * Uses linear interpolation method:
+ * 1. Sort values ascending
+ * 2. Calculate index: (P/100) * (n-1)
+ * 3. If index is integer, return value at that index
+ * 4. If index is fractional, interpolate between adjacent values
+ *
+ * @param values - Array of numeric values
+ * @param percentile - Percentile to calculate (0-100)
+ * @returns Percentile value
+ *
+ * @example
+ * calculatePercentile([1, 2, 3, 4, 5], 50) // Returns 3 (median)
+ * calculatePercentile([1, 2, 3, 4, 5], 90) // Returns 4.6 (P90)
+ */
+export function calculatePercentile(values, percentile) {
+    if (values.length === 0)
+        return 0;
+    if (percentile < 0 || percentile > 100) {
+        throw new Error('Percentile must be between 0 and 100');
+    }
+    // Sort values ascending
+    const sorted = [...values].sort((a, b) => a - b);
+    // Calculate index
+    const index = (percentile / 100) * (sorted.length - 1);
+    // If index is integer, return exact value
+    if (Number.isInteger(index)) {
+        return sorted[index];
+    }
+    // Otherwise, interpolate between adjacent values
+    const lowerIndex = Math.floor(index);
+    const upperIndex = Math.ceil(index);
+    const fraction = index - lowerIndex;
+    const lowerValue = sorted[lowerIndex];
+    const upperValue = sorted[upperIndex];
+    return lowerValue + (upperValue - lowerValue) * fraction;
+}
+//# sourceMappingURL=percentile.js.map

package/dist/metrics/utils/percentile.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"percentile.js","sourceRoot":"","sources":["../../../src/metrics/utils/percentile.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH;;;;;;;;;;;;;;;;GAgBG;AACH,MAAM,UAAU,mBAAmB,CAAC,MAAgB,EAAE,UAAkB;IACtE,IAAI,MAAM,CAAC,MAAM,KAAK,CAAC;QAAE,OAAO,CAAC,CAAC;IAClC,IAAI,UAAU,GAAG,CAAC,IAAI,UAAU,GAAG,GAAG,EAAE,CAAC;QACvC,MAAM,IAAI,KAAK,CAAC,sCAAsC,CAAC,CAAC;IAC1D,CAAC;IAED,wBAAwB;IACxB,MAAM,MAAM,GAAG,CAAC,GAAG,MAAM,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC;IAEjD,kBAAkB;IAClB,MAAM,KAAK,GAAG,CAAC,UAAU,GAAG,GAAG,CAAC,GAAG,CAAC,MAAM,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC;IAEvD,0CAA0C;IAC1C,IAAI,MAAM,CAAC,SAAS,CAAC,KAAK,CAAC,EAAE,CAAC;QAC5B,OAAO,MAAM,CAAC,KAAK,CAAC,CAAC;IACvB,CAAC;IAED,iDAAiD;IACjD,MAAM,UAAU,GAAG,IAAI,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC;IACrC,MAAM,UAAU,GAAG,IAAI,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;IACpC,MAAM,QAAQ,GAAG,KAAK,GAAG,UAAU,CAAC;IAEpC,MAAM,UAAU,GAAG,MAAM,CAAC,UAAU,CAAC,CAAC;IACtC,MAAM,UAAU,GAAG,MAAM,CAAC,UAAU,CAAC,CAAC;IAEtC,OAAO,UAAU,GAAG,CAAC,UAAU,GAAG,UAAU,CAAC,GAAG,QAAQ,CAAC;AAC3D,CAAC"}

package/dist/metrics/utils/tier-classifier.d.ts

@@ -0,0 +1,61 @@
+/**
+ * DORA Tier Classifier
+ *
+ * Maps metric values to DORA performance tiers based on industry benchmarks
+ *
+ * @see https://dora.dev/ - DORA Research
+ */
+import { DORAType } from '../types';
+/**
+ * Classify Deployment Frequency
+ *
+ * Benchmarks (deploys per year):
+ * - Elite: >365 (on-demand, multiple per day)
+ * - High: 52-365 (weekly to daily)
+ * - Medium: 12-52 (monthly to weekly)
+ * - Low: <12 (less than monthly)
+ *
+ * @param deploysPerYear - Number of deployments per year
+ * @returns DORA tier
+ */
+export declare function classifyDeploymentFrequency(deploysPerYear: number): DORAType;
+/**
+ * Classify Lead Time for Changes
+ *
+ * Benchmarks (hours from commit to production):
+ * - Elite: <1 hour
+ * - High: 1 hour to 1 day (24 hours)
+ * - Medium: 1 day to 1 week (168 hours)
+ * - Low: 1 week to 1 month (720 hours)
+ *
+ * @param hours - Average lead time in hours
+ * @returns DORA tier
+ */
+export declare function classifyLeadTime(hours: number): DORAType;
+/**
+ * Classify Change Failure Rate
+ *
+ * Benchmarks (percentage of failed deployments):
+ * - Elite: <5%
+ * - High: 5-10%
+ * - Medium: 10-15%
+ * - Low: >15%
+ *
+ * @param percentage - Change failure rate (0-100)
+ * @returns DORA tier
+ */
+export declare function classifyChangeFailureRate(percentage: number): DORAType;
+/**
+ * Classify Mean Time to Recovery (MTTR)
+ *
+ * Benchmarks (minutes to recover from incident):
+ * - Elite: <60 minutes (1 hour)
+ * - High: 60 minutes to 1 day (1440 minutes)
+ * - Medium: 1 day to 1 week (10080 minutes)
+ * - Low: >1 week
+ *
+ * @param minutes - Average recovery time in minutes
+ * @returns DORA tier
+ */
+export declare function classifyMTTR(minutes: number): DORAType;
+//# sourceMappingURL=tier-classifier.d.ts.map

package/dist/metrics/utils/tier-classifier.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"tier-classifier.d.ts","sourceRoot":"","sources":["../../../src/metrics/utils/tier-classifier.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,EAAE,QAAQ,EAAE,MAAM,UAAU,CAAC;AAEpC;;;;;;;;;;;GAWG;AACH,wBAAgB,2BAA2B,CAAC,cAAc,EAAE,MAAM,GAAG,QAAQ,CAM5E;AAED;;;;;;;;;;;GAWG;AACH,wBAAgB,gBAAgB,CAAC,KAAK,EAAE,MAAM,GAAG,QAAQ,CAMxD;AAED;;;;;;;;;;;GAWG;AACH,wBAAgB,yBAAyB,CAAC,UAAU,EAAE,MAAM,GAAG,QAAQ,CAMtE;AAED;;;;;;;;;;;GAWG;AACH,wBAAgB,YAAY,CAAC,OAAO,EAAE,MAAM,GAAG,QAAQ,CAMtD"}

package/dist/metrics/utils/tier-classifier.js

@@ -0,0 +1,100 @@
+/**
+ * DORA Tier Classifier
+ *
+ * Maps metric values to DORA performance tiers based on industry benchmarks
+ *
+ * @see https://dora.dev/ - DORA Research
+ */
+/**
+ * Classify Deployment Frequency
+ *
+ * Benchmarks (deploys per year):
+ * - Elite: >365 (on-demand, multiple per day)
+ * - High: 52-365 (weekly to daily)
+ * - Medium: 12-52 (monthly to weekly)
+ * - Low: <12 (less than monthly)
+ *
+ * @param deploysPerYear - Number of deployments per year
+ * @returns DORA tier
+ */
+export function classifyDeploymentFrequency(deploysPerYear) {
+    if (deploysPerYear === 0)
+        return 'N/A';
+    if (deploysPerYear > 365)
+        return 'Elite';
+    if (deploysPerYear >= 52)
+        return 'High';
+    if (deploysPerYear >= 12)
+        return 'Medium';
+    return 'Low';
+}
+/**
+ * Classify Lead Time for Changes
+ *
+ * Benchmarks (hours from commit to production):
+ * - Elite: <1 hour
+ * - High: 1 hour to 1 day (24 hours)
+ * - Medium: 1 day to 1 week (168 hours)
+ * - Low: 1 week to 1 month (720 hours)
+ *
+ * @param hours - Average lead time in hours
+ * @returns DORA tier
+ */
+export function classifyLeadTime(hours) {
+    if (hours === 0)
+        return 'N/A';
+    if (hours < 1)
+        return 'Elite';
+    if (hours < 24)
+        return 'High';
+    if (hours < 168)
+        return 'Medium'; // 7 days
+    return 'Low';
+}
+/**
+ * Classify Change Failure Rate
+ *
+ * Benchmarks (percentage of failed deployments):
+ * - Elite: <5%
+ * - High: 5-10%
+ * - Medium: 10-15%
+ * - Low: >15%
+ *
+ * @param percentage - Change failure rate (0-100)
+ * @returns DORA tier
+ */
+export function classifyChangeFailureRate(percentage) {
+    if (percentage < 0)
+        return 'N/A'; // Invalid
+    if (percentage < 5)
+        return 'Elite';
+    if (percentage < 10)
+        return 'High';
+    if (percentage < 15)
+        return 'Medium';
+    return 'Low';
+}
+/**
+ * Classify Mean Time to Recovery (MTTR)
+ *
+ * Benchmarks (minutes to recover from incident):
+ * - Elite: <60 minutes (1 hour)
+ * - High: 60 minutes to 1 day (1440 minutes)
+ * - Medium: 1 day to 1 week (10080 minutes)
+ * - Low: >1 week
+ *
+ * @param minutes - Average recovery time in minutes
+ * @returns DORA tier
+ */
+export function classifyMTTR(minutes) {
+    if (minutes === 0)
+        return 'N/A';
+    if (minutes < 60)
+        return 'Elite';
+    if (minutes < 1440)
+        return 'High'; // 24 hours
+    if (minutes < 10080)
+        return 'Medium'; // 7 days
+    return 'Low';
+}
+//# sourceMappingURL=tier-classifier.js.map

package/dist/metrics/utils/tier-classifier.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"tier-classifier.js","sourceRoot":"","sources":["../../../src/metrics/utils/tier-classifier.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAIH;;;;;;;;;;;GAWG;AACH,MAAM,UAAU,2BAA2B,CAAC,cAAsB;IAChE,IAAI,cAAc,KAAK,CAAC;QAAE,OAAO,KAAK,CAAC;IACvC,IAAI,cAAc,GAAG,GAAG;QAAE,OAAO,OAAO,CAAC;IACzC,IAAI,cAAc,IAAI,EAAE;QAAE,OAAO,MAAM,CAAC;IACxC,IAAI,cAAc,IAAI,EAAE;QAAE,OAAO,QAAQ,CAAC;IAC1C,OAAO,KAAK,CAAC;AACf,CAAC;AAED;;;;;;;;;;;GAWG;AACH,MAAM,UAAU,gBAAgB,CAAC,KAAa;IAC5C,IAAI,KAAK,KAAK,CAAC;QAAE,OAAO,KAAK,CAAC;IAC9B,IAAI,KAAK,GAAG,CAAC;QAAE,OAAO,OAAO,CAAC;IAC9B,IAAI,KAAK,GAAG,EAAE;QAAE,OAAO,MAAM,CAAC;IAC9B,IAAI,KAAK,GAAG,GAAG;QAAE,OAAO,QAAQ,CAAC,CAAE,SAAS;IAC5C,OAAO,KAAK,CAAC;AACf,CAAC;AAED;;;;;;;;;;;GAWG;AACH,MAAM,UAAU,yBAAyB,CAAC,UAAkB;IAC1D,IAAI,UAAU,GAAG,CAAC;QAAE,OAAO,KAAK,CAAC,CAAE,UAAU;IAC7C,IAAI,UAAU,GAAG,CAAC;QAAE,OAAO,OAAO,CAAC;IACnC,IAAI,UAAU,GAAG,EAAE;QAAE,OAAO,MAAM,CAAC;IACnC,IAAI,UAAU,GAAG,EAAE;QAAE,OAAO,QAAQ,CAAC;IACrC,OAAO,KAAK,CAAC;AACf,CAAC;AAED;;;;;;;;;;;GAWG;AACH,MAAM,UAAU,YAAY,CAAC,OAAe;IAC1C,IAAI,OAAO,KAAK,CAAC;QAAE,OAAO,KAAK,CAAC;IAChC,IAAI,OAAO,GAAG,EAAE;QAAE,OAAO,OAAO,CAAC;IACjC,IAAI,OAAO,GAAG,IAAI;QAAE,OAAO,MAAM,CAAC,CAAE,WAAW;IAC/C,IAAI,OAAO,GAAG,KAAK;QAAE,OAAO,QAAQ,CAAC,CAAE,SAAS;IAChD,OAAO,KAAK,CAAC;AACf,CAAC"}

package/dist/utils/auth-helpers.d.ts

@@ -0,0 +1,58 @@
+/**
+ * Authentication Helpers for Issue Tracker Integration
+ *
+ * Provides unified authentication detection for GitHub, Azure DevOps, and Jira
+ * Works in both CLI (init flow) and test environments
+ *
+ * @module utils/auth-helpers
+ */
+export interface GitHubAuth {
+    token: string;
+    source: 'GITHUB_TOKEN' | 'GH_TOKEN' | 'gh-cli' | 'none';
+}
+export interface AzureDevOpsAuth {
+    pat: string;
+    org: string;
+    project: string;
+}
+export interface JiraAuth {
+    token: string;
+    email: string;
+    domain: string;
+}
+/**
+ * Get GitHub authentication token
+ * Priority: GITHUB_TOKEN (CI) > GH_TOKEN (custom) > gh CLI config (local)
+ */
+export declare function getGitHubAuth(): GitHubAuth;
+/**
+ * Get Azure DevOps authentication
+ * Requires: AZURE_DEVOPS_PAT, AZURE_DEVOPS_ORG, AZURE_DEVOPS_PROJECT
+ */
+export declare function getAzureDevOpsAuth(): AzureDevOpsAuth | null;
+/**
+ * Get Jira authentication
+ * Requires: JIRA_API_TOKEN, JIRA_EMAIL, JIRA_DOMAIN
+ */
+export declare function getJiraAuth(): JiraAuth | null;
+/**
+ * Check if integration tests should run
+ * Returns true if RUN_INTEGRATION_TESTS=true or if in CI environment
+ */
+export declare function shouldRunIntegrationTests(): boolean;
+/**
+ * Check if credentials are available for a service
+ */
+export declare function hasGitHubCredentials(): boolean;
+export declare function hasAzureDevOpsCredentials(): boolean;
+export declare function hasJiraCredentials(): boolean;
+/**
+ * Get credential status summary (for debugging)
+ */
+export declare function getCredentialStatus(): {
+    github: string;
+    ado: boolean;
+    jira: boolean;
+    integrationTestsEnabled: boolean;
+};
+//# sourceMappingURL=auth-helpers.d.ts.map

package/dist/utils/auth-helpers.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"auth-helpers.d.ts","sourceRoot":"","sources":["../../src/utils/auth-helpers.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAOH,MAAM,WAAW,UAAU;IACzB,KAAK,EAAE,MAAM,CAAC;IACd,MAAM,EAAE,cAAc,GAAG,UAAU,GAAG,QAAQ,GAAG,MAAM,CAAC;CACzD;AAED,MAAM,WAAW,eAAe;IAC9B,GAAG,EAAE,MAAM,CAAC;IACZ,GAAG,EAAE,MAAM,CAAC;IACZ,OAAO,EAAE,MAAM,CAAC;CACjB;AAED,MAAM,WAAW,QAAQ;IACvB,KAAK,EAAE,MAAM,CAAC;IACd,KAAK,EAAE,MAAM,CAAC;IACd,MAAM,EAAE,MAAM,CAAC;CAChB;AAED;;;GAGG;AACH,wBAAgB,aAAa,IAAI,UAAU,CA0B1C;AAED;;;GAGG;AACH,wBAAgB,kBAAkB,IAAI,eAAe,GAAG,IAAI,CAU3D;AAED;;;GAGG;AACH,wBAAgB,WAAW,IAAI,QAAQ,GAAG,IAAI,CAU7C;AAED;;;GAGG;AACH,wBAAgB,yBAAyB,IAAI,OAAO,CAYnD;AAED;;GAEG;AACH,wBAAgB,oBAAoB,IAAI,OAAO,CAG9C;AAED,wBAAgB,yBAAyB,IAAI,OAAO,CAEnD;AAED,wBAAgB,kBAAkB,IAAI,OAAO,CAE5C;AAED;;GAEG;AACH,wBAAgB,mBAAmB,IAAI;IACrC,MAAM,EAAE,MAAM,CAAC;IACf,GAAG,EAAE,OAAO,CAAC;IACb,IAAI,EAAE,OAAO,CAAC;IACd,uBAAuB,EAAE,OAAO,CAAC;CAClC,CAQA"}

package/dist/utils/auth-helpers.js

@@ -0,0 +1,108 @@
+/**
+ * Authentication Helpers for Issue Tracker Integration
+ *
+ * Provides unified authentication detection for GitHub, Azure DevOps, and Jira
+ * Works in both CLI (init flow) and test environments
+ *
+ * @module utils/auth-helpers
+ */
+import * as fs from 'fs';
+import * as path from 'path';
+import * as os from 'os';
+import * as yaml from 'js-yaml';
+/**
+ * Get GitHub authentication token
+ * Priority: GITHUB_TOKEN (CI) > GH_TOKEN (custom) > gh CLI config (local)
+ */
+export function getGitHubAuth() {
+    // 1. Check GITHUB_TOKEN (auto-provided in GitHub Actions)
+    if (process.env.GITHUB_TOKEN) {
+        return { token: process.env.GITHUB_TOKEN, source: 'GITHUB_TOKEN' };
+    }
+    // 2. Check GH_TOKEN (custom PAT from .env)
+    if (process.env.GH_TOKEN) {
+        return { token: process.env.GH_TOKEN, source: 'GH_TOKEN' };
+    }
+    // 3. Try to parse gh CLI config (~/.config/gh/hosts.yml)
+    try {
+        const ghConfigPath = path.join(os.homedir(), '.config', 'gh', 'hosts.yml');
+        if (fs.existsSync(ghConfigPath)) {
+            const config = yaml.load(fs.readFileSync(ghConfigPath, 'utf8'));
+            const token = config?.['github.com']?.oauth_token;
+            if (token) {
+                return { token, source: 'gh-cli' };
+            }
+        }
+    }
+    catch (error) {
+        // Silently fail - gh CLI config is optional
+    }
+    return { token: '', source: 'none' };
+}
+/**
+ * Get Azure DevOps authentication
+ * Requires: AZURE_DEVOPS_PAT, AZURE_DEVOPS_ORG, AZURE_DEVOPS_PROJECT
+ */
+export function getAzureDevOpsAuth() {
+    const pat = process.env.AZURE_DEVOPS_PAT;
+    const org = process.env.AZURE_DEVOPS_ORG;
+    const project = process.env.AZURE_DEVOPS_PROJECT;
+    if (!pat || !org || !project) {
+        return null;
+    }
+    return { pat, org, project };
+}
+/**
+ * Get Jira authentication
+ * Requires: JIRA_API_TOKEN, JIRA_EMAIL, JIRA_DOMAIN
+ */
+export function getJiraAuth() {
+    const token = process.env.JIRA_API_TOKEN;
+    const email = process.env.JIRA_EMAIL;
+    const domain = process.env.JIRA_DOMAIN;
+    if (!token || !email || !domain) {
+        return null;
+    }
+    return { token, email, domain };
+}
+/**
+ * Check if integration tests should run
+ * Returns true if RUN_INTEGRATION_TESTS=true or if in CI environment
+ */
+export function shouldRunIntegrationTests() {
+    // Explicitly enabled
+    if (process.env.RUN_INTEGRATION_TESTS === 'true') {
+        return true;
+    }
+    // In CI environment (GitHub Actions)
+    if (process.env.CI === 'true') {
+        return true;
+    }
+    return false;
+}
+/**
+ * Check if credentials are available for a service
+ */
+export function hasGitHubCredentials() {
+    const auth = getGitHubAuth();
+    return auth.source !== 'none';
+}
+export function hasAzureDevOpsCredentials() {
+    return getAzureDevOpsAuth() !== null;
+}
+export function hasJiraCredentials() {
+    return getJiraAuth() !== null;
+}
+/**
+ * Get credential status summary (for debugging)
+ */
+export function getCredentialStatus() {
+    const github = getGitHubAuth();
+    return {
+        github: github.source,
+        ado: hasAzureDevOpsCredentials(),
+        jira: hasJiraCredentials(),
+        integrationTestsEnabled: shouldRunIntegrationTests()
+    };
+}
+//# sourceMappingURL=auth-helpers.js.map

package/dist/utils/auth-helpers.js.map

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

package/dist/utils/env-file.d.ts

@@ -0,0 +1,88 @@
+/**
+ * Environment File Utilities
+ *
+ * Parse, update, and validate .env files
+ *
+ * @module utils/env-file
+ */
+export interface EnvVariable {
+    key: string;
+    value: string;
+}
+/**
+ * Parse .env file content into key-value pairs
+ *
+ * @param content - Content of .env file
+ * @returns Record of key-value pairs
+ */
+export declare function parseEnvFile(content: string): Record<string, string>;
+/**
+ * Update or add environment variable in .env content
+ *
+ * @param envContent - Current .env file content
+ * @param key - Environment variable key
+ * @param value - Environment variable value
+ * @returns Updated .env content
+ */
+export declare function updateEnvVar(envContent: string, key: string, value: string): string;
+/**
+ * Update multiple environment variables
+ *
+ * @param envContent - Current .env file content
+ * @param vars - Array of environment variables to update
+ * @returns Updated .env content
+ */
+export declare function updateEnvVars(envContent: string, vars: EnvVariable[]): string;
+/**
+ * Read .env file from project directory
+ *
+ * @param projectPath - Path to project root
+ * @returns Content of .env file, or empty string if not found
+ */
+export declare function readEnvFile(projectPath: string): string;
+/**
+ * Write .env file to project directory
+ *
+ * @param projectPath - Path to project root
+ * @param content - Content to write
+ */
+export declare function writeEnvFile(projectPath: string, content: string): void;
+/**
+ * Create .env file from .env.example template
+ *
+ * @param projectPath - Path to project root
+ * @returns Content of .env file (from template or empty)
+ */
+export declare function createEnvFromTemplate(projectPath: string): string;
+/**
+ * Verify .env is in .gitignore
+ *
+ * @param projectPath - Path to project root
+ * @returns True if .env is gitignored, false otherwise
+ */
+export declare function isEnvGitignored(projectPath: string): boolean;
+/**
+ * Add .env to .gitignore if not already present
+ *
+ * @param projectPath - Path to project root
+ */
+export declare function ensureEnvGitignored(projectPath: string): void;
+/**
+ * Validate required environment variables are present
+ *
+ * @param envContent - Content of .env file
+ * @param requiredKeys - Array of required keys
+ * @returns Object with validation result and missing keys
+ */
+export declare function validateEnvVars(envContent: string, requiredKeys: string[]): {
+    valid: boolean;
+    missing: string[];
+};
+/**
+ * Check if .env file exists in project
+ *
+ * @param projectPath - Path to project root
+ * @returns True if .env exists, false otherwise
+ */
+export declare function envFileExists(projectPath: string): boolean;
+//# sourceMappingURL=env-file.d.ts.map

package/dist/utils/env-file.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"env-file.d.ts","sourceRoot":"","sources":["../../src/utils/env-file.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAKH,MAAM,WAAW,WAAW;IAC1B,GAAG,EAAE,MAAM,CAAC;IACZ,KAAK,EAAE,MAAM,CAAC;CACf;AAED;;;;;GAKG;AACH,wBAAgB,YAAY,CAAC,OAAO,EAAE,MAAM,GAAG,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAyBpE;AAED;;;;;;;GAOG;AACH,wBAAgB,YAAY,CAAC,UAAU,EAAE,MAAM,EAAE,GAAG,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,GAAG,MAAM,CAWnF;AAED;;;;;;GAMG;AACH,wBAAgB,aAAa,CAC3B,UAAU,EAAE,MAAM,EAClB,IAAI,EAAE,WAAW,EAAE,GAClB,MAAM,CAQR;AAED;;;;;GAKG;AACH,wBAAgB,WAAW,CAAC,WAAW,EAAE,MAAM,GAAG,MAAM,CAQvD;AAED;;;;;GAKG;AACH,wBAAgB,YAAY,CAAC,WAAW,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,GAAG,IAAI,CAcvE;AAED;;;;;GAKG;AACH,wBAAgB,qBAAqB,CAAC,WAAW,EAAE,MAAM,GAAG,MAAM,CAQjE;AAED;;;;;GAKG;AACH,wBAAgB,eAAe,CAAC,WAAW,EAAE,MAAM,GAAG,OAAO,CAS5D;AAED;;;;GAIG;AACH,wBAAgB,mBAAmB,CAAC,WAAW,EAAE,MAAM,GAAG,IAAI,CAe7D;AAED;;;;;;GAMG;AACH,wBAAgB,eAAe,CAC7B,UAAU,EAAE,MAAM,EAClB,YAAY,EAAE,MAAM,EAAE,GACrB;IAAE,KAAK,EAAE,OAAO,CAAC;IAAC,OAAO,EAAE,MAAM,EAAE,CAAA;CAAE,CAcvC;AAED;;;;;GAKG;AACH,wBAAgB,aAAa,CAAC,WAAW,EAAE,MAAM,GAAG,OAAO,CAG1D"}