specweave 0.17.0 → 0.17.1

package/dist/src/utils/docs-preview/sidebar-builder.js

@@ -0,0 +1,202 @@
+/**
+ * Sidebar builder for Docusaurus
+ * Automatically generates sidebar.js from .specweave/docs/ folder structure
+ */
+import * as path from 'path';
+import * as fs from 'fs-extra';
+/**
+ * Priority order for top-level folders
+ * Lower number = appears first in sidebar
+ */
+const FOLDER_PRIORITY = {
+    strategy: 1,
+    specs: 2,
+    architecture: 3,
+    delivery: 4,
+    operations: 5,
+    governance: 6,
+    projects: 7 // Multi-project support
+};
+/**
+ * Default folders to exclude from sidebar
+ */
+const DEFAULT_EXCLUDE_FOLDERS = [
+    'node_modules',
+    '.git',
+    '.DS_Store',
+    'legacy' // Brownfield imports (temporary, not for display)
+];
+/**
+ * Build sidebar from folder structure
+ */
+export async function buildSidebar(options) {
+    const { docsPath, excludeFolders = DEFAULT_EXCLUDE_FOLDERS, maxDepth = 5 } = options;
+    // Check if docs path exists
+    if (!await fs.pathExists(docsPath)) {
+        throw new Error(`Documentation path does not exist: ${docsPath}`);
+    }
+    // Scan folders and build sidebar items
+    const items = await scanFolder(docsPath, docsPath, excludeFolders, 0, maxDepth);
+    // Sort by priority (strategy first, governance last)
+    const sortedItems = sortByPriority(items);
+    return {
+        docs: sortedItems
+    };
+}
+/**
+ * Scan folder recursively and build sidebar items
+ */
+async function scanFolder(basePath, currentPath, excludeFolders, depth, maxDepth) {
+    if (depth >= maxDepth) {
+        return [];
+    }
+    const items = [];
+    try {
+        const entries = await fs.readdir(currentPath, { withFileTypes: true });
+        // Separate folders and files
+        const folders = entries.filter(e => e.isDirectory() && !excludeFolders.includes(e.name));
+        const files = entries.filter(e => e.isFile() && e.name.endsWith('.md'));
+        // Process folders first (categories)
+        for (const folder of folders) {
+            const folderPath = path.join(currentPath, folder.name);
+            const childItems = await scanFolder(basePath, folderPath, excludeFolders, depth + 1, maxDepth);
+            if (childItems.length > 0) {
+                items.push({
+                    type: 'category',
+                    label: formatLabel(folder.name),
+                    items: childItems
+                });
+            }
+        }
+        // Process markdown files (docs)
+        for (const file of files) {
+            const relativePath = path.relative(basePath, path.join(currentPath, file.name));
+            const docId = relativePath.replace(/\.md$/, '').replace(/\\/g, '/');
+            items.push({
+                type: 'doc',
+                id: docId
+            });
+        }
+        return items;
+    }
+    catch (error) {
+        console.error(`Error scanning folder ${currentPath}:`, error);
+        return [];
+    }
+}
+/**
+ * Sort sidebar items by priority
+ */
+function sortByPriority(items) {
+    return items.sort((a, b) => {
+        // Extract folder name from label
+        const aFolder = a.label?.toLowerCase().replace(/\s+/g, '-') || '';
+        const bFolder = b.label?.toLowerCase().replace(/\s+/g, '-') || '';
+        // Get priorities (default to 999 if not found)
+        const aPriority = FOLDER_PRIORITY[aFolder] || 999;
+        const bPriority = FOLDER_PRIORITY[bFolder] || 999;
+        // Sort by priority
+        if (aPriority !== bPriority) {
+            return aPriority - bPriority;
+        }
+        // If same priority, sort alphabetically
+        return aFolder.localeCompare(bFolder);
+    });
+}
+/**
+ * Format folder name to human-readable label
+ * Examples:
+ * - "strategy" → "Strategy"
+ * - "architecture" → "Architecture"
+ * - "adr" → "ADRs"
+ * - "my-feature-spec" → "My Feature Spec"
+ */
+function formatLabel(folderName) {
+    // Special cases
+    const specialCases = {
+        adr: 'ADRs',
+        adrs: 'ADRs',
+        hld: 'HLD',
+        lld: 'LLD',
+        prd: 'PRDs',
+        okr: 'OKRs',
+        api: 'API',
+        cli: 'CLI',
+        ui: 'UI',
+        ux: 'UX',
+        sre: 'SRE',
+        devops: 'DevOps',
+        mlops: 'MLOps',
+        k8s: 'Kubernetes'
+    };
+    const normalized = folderName.toLowerCase();
+    if (specialCases[normalized]) {
+        return specialCases[normalized];
+    }
+    // Convert kebab-case or snake_case to Title Case
+    return folderName
+        .replace(/[-_]/g, ' ')
+        .split(' ')
+        .map(word => word.charAt(0).toUpperCase() + word.slice(1).toLowerCase())
+        .join(' ');
+}
+/**
+ * Generate sidebars.js content as string
+ */
+export function generateSidebarsJS(sidebar) {
+    return `/**
+ * Auto-generated sidebar for SpecWeave documentation
+ * Generated: ${new Date().toISOString()}
+ *
+ * DO NOT EDIT THIS FILE MANUALLY
+ * Regenerate with: /specweave:docs preview
+ */
+
+module.exports = ${JSON.stringify(sidebar, null, 2)};
+`;
+}
+/**
+ * Write sidebar to file
+ */
+export async function writeSidebar(filePath, sidebar) {
+    const content = generateSidebarsJS(sidebar);
+    await fs.ensureDir(path.dirname(filePath));
+    await fs.writeFile(filePath, content, 'utf-8');
+}
+/**
+ * Count total documents in sidebar
+ */
+export function countDocuments(sidebar) {
+    let count = 0;
+    function traverse(items) {
+        for (const item of items) {
+            if (item.type === 'doc') {
+                count++;
+            }
+            else if (item.type === 'category' && item.items) {
+                traverse(item.items);
+            }
+        }
+    }
+    traverse(sidebar.docs);
+    return count;
+}
+/**
+ * Count total categories in sidebar
+ */
+export function countCategories(sidebar) {
+    let count = 0;
+    function traverse(items) {
+        for (const item of items) {
+            if (item.type === 'category') {
+                count++;
+                if (item.items) {
+                    traverse(item.items);
+                }
+            }
+        }
+    }
+    traverse(sidebar.docs);
+    return count;
+}
+//# sourceMappingURL=sidebar-builder.js.map

package/dist/src/utils/docs-preview/sidebar-builder.js.map

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

package/dist/src/utils/docs-preview/types.d.ts

@@ -0,0 +1,57 @@
+export interface DocusaurusConfig {
+    title: string;
+    tagline: string;
+    url: string;
+    baseUrl: string;
+    docsPath: string;
+    port?: number;
+    theme?: 'default' | 'classic' | 'dark';
+    excludeFolders?: string[];
+}
+export interface SidebarItem {
+    type: 'doc' | 'category';
+    label?: string;
+    id?: string;
+    items?: SidebarItem[];
+}
+export interface Sidebar {
+    docs: SidebarItem[];
+}
+export interface SetupOptions {
+    projectRoot: string;
+    targetDir: string;
+    docsPath: string;
+    config: DocusaurusConfig;
+    force?: boolean;
+}
+export interface ServerOptions {
+    port: number;
+    openBrowser: boolean;
+    host?: string;
+}
+export interface InstallOptions {
+    targetDir: string;
+    packages: string[];
+    dev?: boolean;
+}
+export interface NodeVersion {
+    version: string;
+    major: number;
+    minor: number;
+    patch: number;
+    compatible: boolean;
+}
+export interface BuildResult {
+    success: boolean;
+    outputPath: string;
+    size: number;
+    duration: number;
+    errors?: string[];
+}
+export interface ServerProcess {
+    pid: number;
+    port: number;
+    url: string;
+    stop: () => Promise<void>;
+}
+//# sourceMappingURL=types.d.ts.map

package/dist/src/utils/docs-preview/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../../../src/utils/docs-preview/types.ts"],"names":[],"mappings":"AAAA,MAAM,WAAW,gBAAgB;IAC/B,KAAK,EAAE,MAAM,CAAC;IACd,OAAO,EAAE,MAAM,CAAC;IAChB,GAAG,EAAE,MAAM,CAAC;IACZ,OAAO,EAAE,MAAM,CAAC;IAChB,QAAQ,EAAE,MAAM,CAAC;IACjB,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,KAAK,CAAC,EAAE,SAAS,GAAG,SAAS,GAAG,MAAM,CAAC;IACvC,cAAc,CAAC,EAAE,MAAM,EAAE,CAAC;CAC3B;AAED,MAAM,WAAW,WAAW;IAC1B,IAAI,EAAE,KAAK,GAAG,UAAU,CAAC;IACzB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,EAAE,CAAC,EAAE,MAAM,CAAC;IACZ,KAAK,CAAC,EAAE,WAAW,EAAE,CAAC;CACvB;AAED,MAAM,WAAW,OAAO;IACtB,IAAI,EAAE,WAAW,EAAE,CAAC;CACrB;AAED,MAAM,WAAW,YAAY;IAC3B,WAAW,EAAE,MAAM,CAAC;IACpB,SAAS,EAAE,MAAM,CAAC;IAClB,QAAQ,EAAE,MAAM,CAAC;IACjB,MAAM,EAAE,gBAAgB,CAAC;IACzB,KAAK,CAAC,EAAE,OAAO,CAAC;CACjB;AAED,MAAM,WAAW,aAAa;IAC5B,IAAI,EAAE,MAAM,CAAC;IACb,WAAW,EAAE,OAAO,CAAC;IACrB,IAAI,CAAC,EAAE,MAAM,CAAC;CACf;AAED,MAAM,WAAW,cAAc;IAC7B,SAAS,EAAE,MAAM,CAAC;IAClB,QAAQ,EAAE,MAAM,EAAE,CAAC;IACnB,GAAG,CAAC,EAAE,OAAO,CAAC;CACf;AAED,MAAM,WAAW,WAAW;IAC1B,OAAO,EAAE,MAAM,CAAC;IAChB,KAAK,EAAE,MAAM,CAAC;IACd,KAAK,EAAE,MAAM,CAAC;IACd,KAAK,EAAE,MAAM,CAAC;IACd,UAAU,EAAE,OAAO,CAAC;CACrB;AAED,MAAM,WAAW,WAAW;IAC1B,OAAO,EAAE,OAAO,CAAC;IACjB,UAAU,EAAE,MAAM,CAAC;IACnB,IAAI,EAAE,MAAM,CAAC;IACb,QAAQ,EAAE,MAAM,CAAC;IACjB,MAAM,CAAC,EAAE,MAAM,EAAE,CAAC;CACnB;AAED,MAAM,WAAW,aAAa;IAC5B,GAAG,EAAE,MAAM,CAAC;IACZ,IAAI,EAAE,MAAM,CAAC;IACb,GAAG,EAAE,MAAM,CAAC;IACZ,IAAI,EAAE,MAAM,OAAO,CAAC,IAAI,CAAC,CAAC;CAC3B"}

package/dist/src/utils/docs-preview/types.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=types.js.map

package/dist/src/utils/docs-preview/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../../../src/utils/docs-preview/types.ts"],"names":[],"mappings":""}

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

@@ -0,0 +1,54 @@
+/**
+ * Environment File Generator
+ *
+ * Generates .env files with GitHub configuration for sync.
+ * Handles security (gitignore, permissions) and multi-provider support.
+ *
+ * Features:
+ * - Auto-generate .env with GitHub config
+ * - Add .env to .gitignore automatically
+ * - Create .env.example for team sharing
+ * - Multi-provider support (GitHub, JIRA, ADO)
+ *
+ * @module env-file-generator
+ */
+/**
+ * Repository mapping
+ */
+export interface RepoMapping {
+    id: string;
+    repo: string;
+}
+/**
+ * Environment configuration
+ */
+export interface EnvConfig {
+    githubToken?: string;
+    githubOwner?: string;
+    repos?: RepoMapping[];
+    syncEnabled?: boolean;
+    autoCreateIssue?: boolean;
+    syncDirection?: 'bidirectional' | 'export' | 'import';
+}
+/**
+ * Generate .env file with GitHub configuration
+ *
+ * @param projectRoot - Project root directory
+ * @param config - Environment configuration
+ */
+export declare function generateEnvFile(projectRoot: string, config: EnvConfig): Promise<void>;
+/**
+ * Check if .env file exists
+ *
+ * @param projectRoot - Project root directory
+ * @returns True if .env exists
+ */
+export declare function envFileExists(projectRoot: string): Promise<boolean>;
+/**
+ * Load configuration from .env file
+ *
+ * @param projectRoot - Project root directory
+ * @returns Environment configuration
+ */
+export declare function loadEnvConfig(projectRoot: string): Promise<EnvConfig | null>;
+//# sourceMappingURL=env-file-generator.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"env-file-generator.d.ts","sourceRoot":"","sources":["../../../src/utils/env-file-generator.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;GAaG;AAKH;;GAEG;AACH,MAAM,WAAW,WAAW;IAC1B,EAAE,EAAE,MAAM,CAAC;IACX,IAAI,EAAE,MAAM,CAAC;CACd;AAED;;GAEG;AACH,MAAM,WAAW,SAAS;IACxB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,KAAK,CAAC,EAAE,WAAW,EAAE,CAAC;IACtB,WAAW,CAAC,EAAE,OAAO,CAAC;IACtB,eAAe,CAAC,EAAE,OAAO,CAAC;IAC1B,aAAa,CAAC,EAAE,eAAe,GAAG,QAAQ,GAAG,QAAQ,CAAC;CACvD;AAED;;;;;GAKG;AACH,wBAAsB,eAAe,CACnC,WAAW,EAAE,MAAM,EACnB,MAAM,EAAE,SAAS,GAChB,OAAO,CAAC,IAAI,CAAC,CAqBf;AAmHD;;;;;GAKG;AACH,wBAAsB,aAAa,CAAC,WAAW,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC,CAGzE;AAED;;;;;GAKG;AACH,wBAAsB,aAAa,CAAC,WAAW,EAAE,MAAM,GAAG,OAAO,CAAC,SAAS,GAAG,IAAI,CAAC,CAmDlF"}

package/dist/src/utils/env-file-generator.js

@@ -0,0 +1,196 @@
+/**
+ * Environment File Generator
+ *
+ * Generates .env files with GitHub configuration for sync.
+ * Handles security (gitignore, permissions) and multi-provider support.
+ *
+ * Features:
+ * - Auto-generate .env with GitHub config
+ * - Add .env to .gitignore automatically
+ * - Create .env.example for team sharing
+ * - Multi-provider support (GitHub, JIRA, ADO)
+ *
+ * @module env-file-generator
+ */
+import fs from 'fs-extra';
+import path from 'path';
+/**
+ * Generate .env file with GitHub configuration
+ *
+ * @param projectRoot - Project root directory
+ * @param config - Environment configuration
+ */
+export async function generateEnvFile(projectRoot, config) {
+    const envPath = path.join(projectRoot, '.env');
+    const envExamplePath = path.join(projectRoot, '.env.example');
+    // Build .env content
+    const content = buildEnvContent(config);
+    const exampleContent = buildEnvExampleContent();
+    // Write .env file
+    await fs.writeFile(envPath, content, 'utf-8');
+    // Set secure permissions (owner read/write only)
+    if (process.platform !== 'win32') {
+        await fs.chmod(envPath, 0o600);
+    }
+    // Write .env.example
+    await fs.writeFile(envExamplePath, exampleContent, 'utf-8');
+    // Update .gitignore
+    await updateGitignore(projectRoot);
+}
+/**
+ * Build .env file content
+ *
+ * @param config - Environment configuration
+ * @returns .env content
+ */
+function buildEnvContent(config) {
+    const lines = [];
+    lines.push('# GitHub Configuration (Auto-generated by SpecWeave)');
+    lines.push(`# Created: ${new Date().toISOString()}`);
+    lines.push('');
+    // GitHub token
+    if (config.githubToken) {
+        lines.push(`GITHUB_TOKEN=${config.githubToken}`);
+    }
+    else {
+        lines.push('GITHUB_TOKEN=ghp_xxxxxxxxxxxxxxxxxxxx');
+    }
+    // GitHub owner
+    if (config.githubOwner) {
+        lines.push(`GITHUB_OWNER=${config.githubOwner}`);
+    }
+    else {
+        lines.push('GITHUB_OWNER=myorg');
+    }
+    lines.push('');
+    lines.push('# Repository Mapping (id:repo-name)');
+    // Repos
+    if (config.repos && config.repos.length > 0) {
+        const repoMappings = config.repos.map(r => `${r.id}:${r.repo}`).join(',');
+        lines.push(`GITHUB_REPOS=${repoMappings}`);
+    }
+    else {
+        lines.push('GITHUB_REPOS=parent:my-project-parent,frontend:my-project-frontend,backend:my-project-backend');
+    }
+    lines.push('');
+    lines.push('# Sync Configuration');
+    lines.push(`GITHUB_SYNC_ENABLED=${config.syncEnabled !== false ? 'true' : 'false'}`);
+    lines.push(`GITHUB_AUTO_CREATE_ISSUE=${config.autoCreateIssue !== false ? 'true' : 'false'}`);
+    lines.push(`GITHUB_SYNC_DIRECTION=${config.syncDirection || 'bidirectional'}`);
+    return lines.join('\n') + '\n';
+}
+/**
+ * Build .env.example file content
+ *
+ * @returns .env.example content
+ */
+function buildEnvExampleContent() {
+    const lines = [];
+    lines.push('# GitHub Configuration');
+    lines.push('# Copy this file to .env and fill in your values');
+    lines.push('');
+    lines.push('# GitHub Personal Access Token (get from https://github.com/settings/tokens)');
+    lines.push('GITHUB_TOKEN=ghp_xxxxxxxxxxxxxxxxxxxx');
+    lines.push('');
+    lines.push('# GitHub owner (user or organization)');
+    lines.push('GITHUB_OWNER=your-username-or-org');
+    lines.push('');
+    lines.push('# Repository Mapping (id:repo-name,id:repo-name,...)');
+    lines.push('GITHUB_REPOS=parent:my-project-parent,frontend:my-project-frontend,backend:my-project-backend');
+    lines.push('');
+    lines.push('# Sync Configuration');
+    lines.push('GITHUB_SYNC_ENABLED=true');
+    lines.push('GITHUB_AUTO_CREATE_ISSUE=true');
+    lines.push('GITHUB_SYNC_DIRECTION=bidirectional');
+    return lines.join('\n') + '\n';
+}
+/**
+ * Update .gitignore to exclude .env files
+ *
+ * @param projectRoot - Project root directory
+ */
+async function updateGitignore(projectRoot) {
+    const gitignorePath = path.join(projectRoot, '.gitignore');
+    let content = '';
+    if (await fs.pathExists(gitignorePath)) {
+        content = await fs.readFile(gitignorePath, 'utf-8');
+    }
+    // Check if .env patterns already exist
+    const hasEnvPattern = /^\.env$/m.test(content);
+    const hasEnvLocalPattern = /^\.env\.local$/m.test(content);
+    if (!hasEnvPattern || !hasEnvLocalPattern) {
+        const lines = content.split('\n');
+        // Add SpecWeave section if not exists
+        if (!content.includes('# SpecWeave - Environment variables')) {
+            lines.push('');
+            lines.push('# SpecWeave - Environment variables (contains secrets!)');
+            if (!hasEnvPattern) {
+                lines.push('.env');
+            }
+            if (!hasEnvLocalPattern) {
+                lines.push('.env.local');
+            }
+        }
+        await fs.writeFile(gitignorePath, lines.join('\n') + '\n', 'utf-8');
+    }
+}
+/**
+ * Check if .env file exists
+ *
+ * @param projectRoot - Project root directory
+ * @returns True if .env exists
+ */
+export async function envFileExists(projectRoot) {
+    const envPath = path.join(projectRoot, '.env');
+    return fs.pathExists(envPath);
+}
+/**
+ * Load configuration from .env file
+ *
+ * @param projectRoot - Project root directory
+ * @returns Environment configuration
+ */
+export async function loadEnvConfig(projectRoot) {
+    const envPath = path.join(projectRoot, '.env');
+    if (!await fs.pathExists(envPath)) {
+        return null;
+    }
+    const content = await fs.readFile(envPath, 'utf-8');
+    const lines = content.split('\n');
+    const config = {};
+    for (const line of lines) {
+        const trimmed = line.trim();
+        if (trimmed.startsWith('#') || !trimmed) {
+            continue;
+        }
+        const [key, value] = trimmed.split('=');
+        if (!key || !value) {
+            continue;
+        }
+        switch (key.trim()) {
+            case 'GITHUB_TOKEN':
+                config.githubToken = value.trim();
+                break;
+            case 'GITHUB_OWNER':
+                config.githubOwner = value.trim();
+                break;
+            case 'GITHUB_REPOS':
+                config.repos = value.trim().split(',').map(mapping => {
+                    const [id, repo] = mapping.split(':');
+                    return { id: id.trim(), repo: repo.trim() };
+                });
+                break;
+            case 'GITHUB_SYNC_ENABLED':
+                config.syncEnabled = value.trim() === 'true';
+                break;
+            case 'GITHUB_AUTO_CREATE_ISSUE':
+                config.autoCreateIssue = value.trim() === 'true';
+                break;
+            case 'GITHUB_SYNC_DIRECTION':
+                config.syncDirection = value.trim();
+                break;
+        }
+    }
+    return config;
+}
+//# sourceMappingURL=env-file-generator.js.map

package/dist/src/utils/env-file-generator.js.map

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

package/dist/src/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/src/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"}