@defai.digital/ax-cli 2.3.1 → 2.4.1

package/dist/utils/init-validator.js

@@ -0,0 +1,248 @@
+/**
+ * Validation utilities for init command
+ */
+import * as fs from 'fs';
+import * as path from 'path';
+import { parseJson, parseJsonFile } from './json-utils.js';
+export class InitValidator {
+    projectRoot;
+    constructor(projectRoot) {
+        this.projectRoot = projectRoot;
+    }
+    /**
+     * Run all validation checks
+     */
+    validate(projectInfo) {
+        const result = {
+            valid: true,
+            warnings: [],
+            errors: [],
+            suggestions: [],
+        };
+        // Check for package.json
+        this.checkPackageJson(result);
+        // Check for git repository
+        this.checkGitRepo(result);
+        // Check for existing AX CLI config
+        this.checkExistingConfig(result);
+        // Check project structure
+        this.checkProjectStructure(result);
+        // Check if project has minimum files
+        this.checkMinimumFiles(result);
+        // Validate project info if provided
+        if (projectInfo) {
+            this.validateProjectInfo(projectInfo, result);
+        }
+        // Set overall validity
+        result.valid = result.errors.length === 0;
+        return result;
+    }
+    /**
+     * Check for package.json
+     */
+    checkPackageJson(result) {
+        const packageJsonPath = path.join(this.projectRoot, 'package.json');
+        if (!fs.existsSync(packageJsonPath)) {
+            result.warnings.push('No package.json found - may not be a Node.js project');
+            result.suggestions.push('Run: npm init (if this is a Node.js project)');
+        }
+        else {
+            try {
+                const content = fs.readFileSync(packageJsonPath, 'utf-8');
+                // Check for empty file
+                if (!content || content.trim() === '') {
+                    result.errors.push('package.json is empty');
+                    return;
+                }
+                const parseResult = parseJson(content);
+                if (!parseResult.success) {
+                    result.errors.push(`Invalid package.json - ${parseResult.error}`);
+                    return;
+                }
+                const packageJson = parseResult.data;
+                // Check if package.json is actually an object
+                if (typeof packageJson !== 'object' || packageJson === null) {
+                    result.errors.push('package.json is not a valid JSON object');
+                    return;
+                }
+                // Check for common issues
+                if (!packageJson.name) {
+                    result.warnings.push('package.json missing "name" field');
+                }
+                if (!packageJson.version) {
+                    result.warnings.push('package.json missing "version" field');
+                }
+                // Check for type: module (ESM)
+                if (packageJson.type !== 'module') {
+                    result.suggestions.push('Consider adding "type": "module" for ESM support');
+                }
+            }
+            catch (error) {
+                result.errors.push(`Invalid package.json - ${error instanceof Error ? error.message : 'File read error'}`);
+            }
+        }
+    }
+    /**
+     * Check for git repository
+     */
+    checkGitRepo(result) {
+        const gitDir = path.join(this.projectRoot, '.git');
+        if (!fs.existsSync(gitDir)) {
+            result.warnings.push('Not a git repository');
+            result.suggestions.push('Run: git init (for version control)');
+        }
+    }
+    /**
+     * Check for existing AX CLI configuration
+     */
+    checkExistingConfig(result) {
+        const axCliDir = path.join(this.projectRoot, '.ax-cli');
+        const customMdPath = path.join(axCliDir, 'CUSTOM.md');
+        const indexPath = path.join(axCliDir, 'index.json');
+        if (fs.existsSync(customMdPath)) {
+            result.warnings.push('Existing CUSTOM.md found - will be overwritten unless --force is used');
+        }
+        if (fs.existsSync(indexPath)) {
+            const parseResult = parseJsonFile(indexPath);
+            if (parseResult.success) {
+                const indexData = parseResult.data;
+                const lastUpdated = indexData.lastAnalyzed || indexData.templateAppliedAt;
+                if (lastUpdated) {
+                    const date = new Date(lastUpdated);
+                    const daysSince = Math.floor((Date.now() - date.getTime()) / (1000 * 60 * 60 * 24));
+                    if (daysSince > 30) {
+                        result.suggestions.push(`CUSTOM.md is ${daysSince} days old - consider refreshing`);
+                    }
+                }
+            }
+            else {
+                result.warnings.push('Existing index.json is invalid');
+            }
+        }
+    }
+    /**
+     * Check project structure
+     */
+    checkProjectStructure(result) {
+        const commonDirs = ['src', 'lib', 'dist', 'build', 'test', 'tests', '__tests__'];
+        const foundDirs = commonDirs.filter(dir => fs.existsSync(path.join(this.projectRoot, dir)));
+        if (foundDirs.length === 0) {
+            result.warnings.push('No standard project directories found (src/, lib/, etc.)');
+            result.suggestions.push('Project may be empty or have non-standard structure');
+        }
+    }
+    /**
+     * Check for minimum files
+     */
+    checkMinimumFiles(result) {
+        try {
+            const files = fs.readdirSync(this.projectRoot);
+            const nonHiddenFiles = files.filter(f => !f.startsWith('.'));
+            if (nonHiddenFiles.length === 0) {
+                result.errors.push('Project directory is empty');
+                return;
+            }
+            if (nonHiddenFiles.length === 1 && nonHiddenFiles[0] === 'package.json') {
+                result.warnings.push('Project only contains package.json - no source files found');
+                result.suggestions.push('Add source files before initializing AX CLI');
+            }
+        }
+        catch (error) {
+            result.errors.push(`Cannot read project directory: ${error instanceof Error ? error.message : 'Unknown error'}`);
+        }
+    }
+    /**
+     * Validate project info
+     */
+    validateProjectInfo(projectInfo, result) {
+        // Check if project type was detected
+        if (projectInfo.projectType === 'unknown' || projectInfo.projectType === 'application') {
+            result.warnings.push('Could not determine specific project type');
+            result.suggestions.push('Consider using a template: ax-cli init --template <type>');
+        }
+        // Check if primary language was detected
+        if (projectInfo.primaryLanguage === 'Unknown') {
+            result.warnings.push('Could not determine primary programming language');
+        }
+        // Check if tech stack was detected
+        if (projectInfo.techStack.length === 0) {
+            result.warnings.push('No tech stack detected');
+            result.suggestions.push('Ensure package.json has dependencies listed');
+        }
+        // Check entry point
+        if (!projectInfo.entryPoint) {
+            result.warnings.push('No entry point detected');
+        }
+    }
+    /**
+     * Validate custom instructions content
+     */
+    static validateCustomInstructions(content) {
+        const result = {
+            valid: true,
+            warnings: [],
+            errors: [],
+            suggestions: [],
+        };
+        // Check minimum length
+        if (content.length < 100) {
+            result.errors.push('CUSTOM.md is too short (< 100 characters)');
+        }
+        // Check for required sections
+        const requiredSections = [
+            '## 🎯 Critical Rules',
+            '## 📋 Project Overview',
+            '## 🔧 Code Patterns',
+        ];
+        for (const section of requiredSections) {
+            if (!content.includes(section)) {
+                result.warnings.push(`Missing recommended section: ${section}`);
+            }
+        }
+        // Check token count (rough estimate)
+        const estimatedTokens = Math.ceil(content.length / 4);
+        if (estimatedTokens > 2000) {
+            result.warnings.push(`CUSTOM.md is large (~${estimatedTokens} tokens)`);
+            result.suggestions.push('Consider using template imports or reducing content');
+        }
+        // Check for common issues
+        if (content.includes('TODO') || content.includes('FIXME')) {
+            result.warnings.push('CUSTOM.md contains TODO/FIXME markers');
+        }
+        if (content.includes('__placeholder__') || content.includes('<insert')) {
+            result.errors.push('CUSTOM.md contains placeholder text');
+        }
+        result.valid = result.errors.length === 0;
+        return result;
+    }
+    /**
+     * Check if force flag is needed
+     */
+    needsForceFlag() {
+        const customMdPath = path.join(this.projectRoot, '.ax-cli', 'CUSTOM.md');
+        return fs.existsSync(customMdPath);
+    }
+    /**
+     * Get validation summary string
+     */
+    static formatValidationResult(result) {
+        const parts = [];
+        if (result.errors.length > 0) {
+            parts.push('❌ Errors:');
+            result.errors.forEach(e => parts.push(`   - ${e}`));
+        }
+        if (result.warnings.length > 0) {
+            parts.push('⚠️  Warnings:');
+            result.warnings.forEach(w => parts.push(`   - ${w}`));
+        }
+        if (result.suggestions.length > 0) {
+            parts.push('💡 Suggestions:');
+            result.suggestions.forEach(s => parts.push(`   - ${s}`));
+        }
+        if (result.valid && result.warnings.length === 0 && result.suggestions.length === 0) {
+            parts.push('✅ All validation checks passed');
+        }
+        return parts.join('\n');
+    }
+}
+//# sourceMappingURL=init-validator.js.map

package/dist/utils/init-validator.js.map

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

package/dist/utils/onboarding-manager.js

@@ -4,6 +4,8 @@
 import * as fs from 'fs';
 import * as path from 'path';
 import * as os from 'os';
+import { fileURLToPath } from 'url';
+import { parseJsonFile } from './json-utils.js';
 export class OnboardingManager {
     static FIRST_RUN_MARKER = '.first-run-complete';
     static USER_CONFIG_DIR = '.ax-cli';
@@ -43,7 +45,24 @@ export class OnboardingManager {
             completedAt: new Date().toISOString(),
             version: this.getVersion(),
         };
-        fs.writeFileSync(markerPath, JSON.stringify(state, null, 2), 'utf-8');
+        // Atomic write using temp file
+        const tmpPath = `${markerPath}.tmp`;
+        try {
+            fs.writeFileSync(tmpPath, JSON.stringify(state, null, 2), 'utf-8');
+            fs.renameSync(tmpPath, markerPath); // Atomic on POSIX systems
+        }
+        catch (error) {
+            // Cleanup temp file on error
+            if (fs.existsSync(tmpPath)) {
+                try {
+                    fs.unlinkSync(tmpPath);
+                }
+                catch {
+                    // Ignore cleanup errors
+                }
+            }
+            throw error;
+        }
     }
     /**
      * Get current onboarding state
@@ -57,11 +76,8 @@ export class OnboardingManager {
                 version: this.getVersion(),
             };
         }
-        try {
-            const content = fs.readFileSync(markerPath, 'utf-8');
-            return JSON.parse(content);
-        }
-        catch {
+        const parseResult = parseJsonFile(markerPath);
+        if (!parseResult.success) {
             // If marker file is corrupted, treat as first run
             return {
                 isFirstRun: true,
@@ -69,6 +85,7 @@ export class OnboardingManager {
                 version: this.getVersion(),
             };
         }
+        return parseResult.data;
     }
     /**
      * Reset onboarding state (useful for testing)
@@ -90,10 +107,18 @@ export class OnboardingManager {
      */
     static getVersion() {
         try {
-            const packageJsonPath = path.join(process.cwd(), 'package.json');
+            // Use import.meta.url to find the actual CLI installation path
+            const currentModulePath = fileURLToPath(import.meta.url);
+            const cliRootPath = path.join(path.dirname(currentModulePath), '../..');
+            const packageJsonPath = path.join(cliRootPath, 'package.json');
             if (fs.existsSync(packageJsonPath)) {
-                const pkg = JSON.parse(fs.readFileSync(packageJsonPath, 'utf-8'));
-                return pkg.version || '0.0.0';
+                const parseResult = parseJsonFile(packageJsonPath);
+                if (parseResult.success) {
+                    const pkg = parseResult.data;
+                    if (pkg && typeof pkg === 'object' && 'version' in pkg && typeof pkg.version === 'string') {
+                        return pkg.version;
+                    }
+                }
             }
         }
         catch {

package/dist/utils/onboarding-manager.js.map

@@ -1 +1 @@
-{"version":3,"file":"onboarding-manager.js","sourceRoot":"","sources":["../../src/utils/onboarding-manager.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"onboarding-manager.js","sourceRoot":"","sources":["../../src/utils/onboarding-manager.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,KAAK,EAAE,MAAM,IAAI,CAAC;AACzB,OAAO,KAAK,IAAI,MAAM,MAAM,CAAC;AAC7B,OAAO,KAAK,EAAE,MAAM,IAAI,CAAC;AACzB,OAAO,EAAE,aAAa,EAAE,MAAM,KAAK,CAAC;AACpC,OAAO,EAAE,aAAa,EAAE,MAAM,iBAAiB,CAAC;AAShD,MAAM,OAAO,iBAAiB;IACpB,MAAM,CAAU,gBAAgB,GAAG,qBAAqB,CAAC;IACzD,MAAM,CAAU,eAAe,GAAG,SAAS,CAAC;IAEpD;;OAEG;IACK,MAAM,CAAC,gBAAgB;QAC7B,OAAO,IAAI,CAAC,IAAI,CAAC,EAAE,CAAC,OAAO,EAAE,EAAE,iBAAiB,CAAC,eAAe,CAAC,CAAC;IACpE,CAAC;IAED;;OAEG;IACK,MAAM,CAAC,aAAa;QAC1B,OAAO,IAAI,CAAC,IAAI,CACd,iBAAiB,CAAC,gBAAgB,EAAE,EACpC,iBAAiB,CAAC,gBAAgB,CACnC,CAAC;IACJ,CAAC;IAED;;OAEG;IACH,MAAM,CAAC,cAAc;QACnB,MAAM,UAAU,GAAG,iBAAiB,CAAC,aAAa,EAAE,CAAC;QACrD,OAAO,CAAC,EAAE,CAAC,UAAU,CAAC,UAAU,CAAC,CAAC;IACpC,CAAC;IAED;;OAEG;IACH,MAAM,CAAC,aAAa;QAClB,MAAM,SAAS,GAAG,iBAAiB,CAAC,gBAAgB,EAAE,CAAC;QACvD,MAAM,UAAU,GAAG,iBAAiB,CAAC,aAAa,EAAE,CAAC;QAErD,8CAA8C;QAC9C,IAAI,CAAC,EAAE,CAAC,UAAU,CAAC,SAAS,CAAC,EAAE,CAAC;YAC9B,EAAE,CAAC,SAAS,CAAC,SAAS,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC;QAC/C,CAAC;QAED,oCAAoC;QACpC,MAAM,KAAK,GAAoB;YAC7B,UAAU,EAAE,KAAK;YACjB,cAAc,EAAE,IAAI;YACpB,WAAW,EAAE,IAAI,IAAI,EAAE,CAAC,WAAW,EAAE;YACrC,OAAO,EAAE,IAAI,CAAC,UAAU,EAAE;SAC3B,CAAC;QAEF,+BAA+B;QAC/B,MAAM,OAAO,GAAG,GAAG,UAAU,MAAM,CAAC;QACpC,IAAI,CAAC;YACH,EAAE,CAAC,aAAa,CAAC,OAAO,EAAE,IAAI,CAAC,SAAS,CAAC,KAAK,EAAE,IAAI,EAAE,CAAC,CAAC,EAAE,OAAO,CAAC,CAAC;YACnE,EAAE,CAAC,UAAU,CAAC,OAAO,EAAE,UAAU,CAAC,CAAC,CAAC,0BAA0B;QAChE,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACf,6BAA6B;YAC7B,IAAI,EAAE,CAAC,UAAU,CAAC,OAAO,CAAC,EAAE,CAAC;gBAC3B,IAAI,CAAC;oBACH,EAAE,CAAC,UAAU,CAAC,OAAO,CAAC,CAAC;gBACzB,CAAC;gBAAC,MAAM,CAAC;oBACP,wBAAwB;gBAC1B,CAAC;YACH,CAAC;YACD,MAAM,KAAK,CAAC;QACd,CAAC;IACH,CAAC;IAED;;OAEG;IACH,MAAM,CAAC,eAAe;QACpB,MAAM,UAAU,GAAG,iBAAiB,CAAC,aAAa,EAAE,CAAC;QAErD,IAAI,CAAC,EAAE,CAAC,UAAU,CAAC,UAAU,CAAC,EAAE,CAAC;YAC/B,OAAO;gBACL,UAAU,EAAE,IAAI;gBAChB,cAAc,EAAE,KAAK;gBACrB,OAAO,EAAE,IAAI,CAAC,UAAU,EAAE;aAC3B,CAAC;QACJ,CAAC;QAED,MAAM,WAAW,GAAG,aAAa,CAAkB,UAAU,CAAC,CAAC;QAC/D,IAAI,CAAC,WAAW,CAAC,OAAO,EAAE,CAAC;YACzB,kDAAkD;YAClD,OAAO;gBACL,UAAU,EAAE,IAAI;gBAChB,cAAc,EAAE,KAAK;gBACrB,OAAO,EAAE,IAAI,CAAC,UAAU,EAAE;aAC3B,CAAC;QACJ,CAAC;QAED,OAAO,WAAW,CAAC,IAAI,CAAC;IAC1B,CAAC;IAED;;OAEG;IACH,MAAM,CAAC,eAAe;QACpB,MAAM,UAAU,GAAG,iBAAiB,CAAC,aAAa,EAAE,CAAC;QACrD,IAAI,EAAE,CAAC,UAAU,CAAC,UAAU,CAAC,EAAE,CAAC;YAC9B,EAAE,CAAC,UAAU,CAAC,UAAU,CAAC,CAAC;QAC5B,CAAC;IACH,CAAC;IAED;;OAEG;IACH,MAAM,CAAC,iBAAiB;QACtB,OAAO,iBAAiB,CAAC,cAAc,EAAE,CAAC;IAC5C,CAAC;IAED;;OAEG;IACK,MAAM,CAAC,UAAU;QACvB,IAAI,CAAC;YACH,+DAA+D;YAC/D,MAAM,iBAAiB,GAAG,aAAa,CAAC,MAAM,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;YACzD,MAAM,WAAW,GAAG,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC,OAAO,CAAC,iBAAiB,CAAC,EAAE,OAAO,CAAC,CAAC;YACxE,MAAM,eAAe,GAAG,IAAI,CAAC,IAAI,CAAC,WAAW,EAAE,cAAc,CAAC,CAAC;YAE/D,IAAI,EAAE,CAAC,UAAU,CAAC,eAAe,CAAC,EAAE,CAAC;gBACnC,MAAM,WAAW,GAAG,aAAa,CAAC,eAAe,CAAC,CAAC;gBACnD,IAAI,WAAW,CAAC,OAAO,EAAE,CAAC;oBACxB,MAAM,GAAG,GAAG,WAAW,CAAC,IAAW,CAAC;oBACpC,IAAI,GAAG,IAAI,OAAO,GAAG,KAAK,QAAQ,IAAI,SAAS,IAAI,GAAG,IAAI,OAAO,GAAG,CAAC,OAAO,KAAK,QAAQ,EAAE,CAAC;wBAC1F,OAAO,GAAG,CAAC,OAAO,CAAC;oBACrB,CAAC;gBACH,CAAC;YACH,CAAC;QACH,CAAC;QAAC,MAAM,CAAC;YACP,gBAAgB;QAClB,CAAC;QACD,OAAO,OAAO,CAAC;IACjB,CAAC"}

package/dist/utils/path-utils.d.ts

@@ -0,0 +1,83 @@
+/**
+ * Cross-platform path utility functions
+ *
+ * This module provides utilities for handling file paths consistently
+ * across different operating systems (Windows, macOS, Linux).
+ *
+ * @module path-utils
+ */
+/**
+ * Normalize path separators to forward slashes (for display and logging)
+ *
+ * This function converts all path separators to forward slashes, which is
+ * useful for consistent display across platforms and for comparison in tests.
+ *
+ * @example
+ * // Windows
+ * normalizePath('C:\\Users\\foo\\bar') // => 'C:/Users/foo/bar'
+ *
+ * // Unix
+ * normalizePath('/Users/foo/bar') // => '/Users/foo/bar'
+ *
+ * @param filePath - The path to normalize
+ * @returns Path with forward slashes (empty string if input is falsy)
+ */
+export declare function normalizePath(filePath: string): string;
+/**
+ * Convert path to platform-native format (for filesystem operations)
+ *
+ * This function normalizes the path to use the platform's native separator,
+ * which is necessary for filesystem operations.
+ *
+ * @example
+ * // Windows
+ * platformPath('foo/bar/baz') // => 'foo\\bar\\baz'
+ *
+ * // Unix
+ * platformPath('foo/bar/baz') // => 'foo/bar/baz'
+ *
+ * @param filePath - The path to convert
+ * @returns Path with platform-native separators (empty string if input is falsy)
+ */
+export declare function platformPath(filePath: string): string;
+/**
+ * Check if running on Windows
+ *
+ * @returns True if running on Windows platform
+ */
+export declare function isWindows(): boolean;
+/**
+ * Compare two paths for equality (ignoring separator differences)
+ *
+ * This function compares two paths by normalizing both to forward slashes
+ * and then comparing case-insensitively on Windows.
+ *
+ * @example
+ * // Windows
+ * pathsEqual('foo/bar', 'foo\\bar') // => true
+ * pathsEqual('Foo/Bar', 'foo/bar') // => true
+ *
+ * // Unix
+ * pathsEqual('foo/bar', 'foo/bar') // => true
+ * pathsEqual('Foo/Bar', 'foo/bar') // => false
+ *
+ * @param path1 - First path to compare
+ * @param path2 - Second path to compare
+ * @returns True if paths are equal
+ */
+export declare function pathsEqual(path1: string, path2: string): boolean;
+/**
+ * Check if a path contains a segment (cross-platform)
+ *
+ * This function checks if a full path contains a specific segment,
+ * normalizing both paths before comparison.
+ *
+ * @example
+ * pathContains('/foo/bar/baz', 'bar/baz') // => true
+ * pathContains('C:\\foo\\bar', 'bar') // => true
+ *
+ * @param fullPath - Full path to search in
+ * @param segment - Segment to search for
+ * @returns True if fullPath contains segment
+ */
+export declare function pathContains(fullPath: string, segment: string): boolean;

package/dist/utils/path-utils.js

@@ -0,0 +1,122 @@
+/**
+ * Cross-platform path utility functions
+ *
+ * This module provides utilities for handling file paths consistently
+ * across different operating systems (Windows, macOS, Linux).
+ *
+ * @module path-utils
+ */
+import path from 'node:path';
+import os from 'node:os';
+import { equalsIgnoreCase, containsIgnoreCase } from './string-utils.js';
+/**
+ * Normalize path separators to forward slashes (for display and logging)
+ *
+ * This function converts all path separators to forward slashes, which is
+ * useful for consistent display across platforms and for comparison in tests.
+ *
+ * @example
+ * // Windows
+ * normalizePath('C:\\Users\\foo\\bar') // => 'C:/Users/foo/bar'
+ *
+ * // Unix
+ * normalizePath('/Users/foo/bar') // => '/Users/foo/bar'
+ *
+ * @param filePath - The path to normalize
+ * @returns Path with forward slashes (empty string if input is falsy)
+ */
+export function normalizePath(filePath) {
+    if (!filePath)
+        return '';
+    // Replace all backslashes with forward slashes
+    // This works consistently across all platforms
+    return filePath.replace(/\\/g, '/');
+}
+/**
+ * Convert path to platform-native format (for filesystem operations)
+ *
+ * This function normalizes the path to use the platform's native separator,
+ * which is necessary for filesystem operations.
+ *
+ * @example
+ * // Windows
+ * platformPath('foo/bar/baz') // => 'foo\\bar\\baz'
+ *
+ * // Unix
+ * platformPath('foo/bar/baz') // => 'foo/bar/baz'
+ *
+ * @param filePath - The path to convert
+ * @returns Path with platform-native separators (empty string if input is falsy)
+ */
+export function platformPath(filePath) {
+    if (!filePath)
+        return '';
+    return path.normalize(filePath);
+}
+/**
+ * Check if running on Windows
+ *
+ * @returns True if running on Windows platform
+ */
+export function isWindows() {
+    return os.platform() === 'win32';
+}
+/**
+ * Compare two paths for equality (ignoring separator differences)
+ *
+ * This function compares two paths by normalizing both to forward slashes
+ * and then comparing case-insensitively on Windows.
+ *
+ * @example
+ * // Windows
+ * pathsEqual('foo/bar', 'foo\\bar') // => true
+ * pathsEqual('Foo/Bar', 'foo/bar') // => true
+ *
+ * // Unix
+ * pathsEqual('foo/bar', 'foo/bar') // => true
+ * pathsEqual('Foo/Bar', 'foo/bar') // => false
+ *
+ * @param path1 - First path to compare
+ * @param path2 - Second path to compare
+ * @returns True if paths are equal
+ */
+export function pathsEqual(path1, path2) {
+    // Handle null/undefined/empty cases
+    if (!path1 || !path2) {
+        return path1 === path2;
+    }
+    const normalized1 = normalizePath(path1);
+    const normalized2 = normalizePath(path2);
+    // Windows is case-insensitive
+    if (isWindows()) {
+        return equalsIgnoreCase(normalized1, normalized2);
+    }
+    return normalized1 === normalized2;
+}
+/**
+ * Check if a path contains a segment (cross-platform)
+ *
+ * This function checks if a full path contains a specific segment,
+ * normalizing both paths before comparison.
+ *
+ * @example
+ * pathContains('/foo/bar/baz', 'bar/baz') // => true
+ * pathContains('C:\\foo\\bar', 'bar') // => true
+ *
+ * @param fullPath - Full path to search in
+ * @param segment - Segment to search for
+ * @returns True if fullPath contains segment
+ */
+export function pathContains(fullPath, segment) {
+    if (!fullPath || !segment) {
+        return false;
+    }
+    const normalizedFull = normalizePath(fullPath);
+    const normalizedSegment = normalizePath(segment);
+    // Windows is case-insensitive
+    if (isWindows()) {
+        return containsIgnoreCase(normalizedFull, normalizedSegment);
+    }
+    return normalizedFull.includes(normalizedSegment);
+}
+//# sourceMappingURL=path-utils.js.map

package/dist/utils/path-utils.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"path-utils.js","sourceRoot":"","sources":["../../src/utils/path-utils.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,OAAO,IAAI,MAAM,WAAW,CAAC;AAC7B,OAAO,EAAE,MAAM,SAAS,CAAC;AACzB,OAAO,EAAE,gBAAgB,EAAE,kBAAkB,EAAE,MAAM,mBAAmB,CAAC;AAEzE;;;;;;;;;;;;;;;GAeG;AACH,MAAM,UAAU,aAAa,CAAC,QAAgB;IAC5C,IAAI,CAAC,QAAQ;QAAE,OAAO,EAAE,CAAC;IACzB,+CAA+C;IAC/C,+CAA+C;IAC/C,OAAO,QAAQ,CAAC,OAAO,CAAC,KAAK,EAAE,GAAG,CAAC,CAAC;AACtC,CAAC;AAED;;;;;;;;;;;;;;;GAeG;AACH,MAAM,UAAU,YAAY,CAAC,QAAgB;IAC3C,IAAI,CAAC,QAAQ;QAAE,OAAO,EAAE,CAAC;IACzB,OAAO,IAAI,CAAC,SAAS,CAAC,QAAQ,CAAC,CAAC;AAClC,CAAC;AAED;;;;GAIG;AACH,MAAM,UAAU,SAAS;IACvB,OAAO,EAAE,CAAC,QAAQ,EAAE,KAAK,OAAO,CAAC;AACnC,CAAC;AAED;;;;;;;;;;;;;;;;;;GAkBG;AACH,MAAM,UAAU,UAAU,CAAC,KAAa,EAAE,KAAa;IACrD,oCAAoC;IACpC,IAAI,CAAC,KAAK,IAAI,CAAC,KAAK,EAAE,CAAC;QACrB,OAAO,KAAK,KAAK,KAAK,CAAC;IACzB,CAAC;IAED,MAAM,WAAW,GAAG,aAAa,CAAC,KAAK,CAAC,CAAC;IACzC,MAAM,WAAW,GAAG,aAAa,CAAC,KAAK,CAAC,CAAC;IAEzC,8BAA8B;IAC9B,IAAI,SAAS,EAAE,EAAE,CAAC;QAChB,OAAO,gBAAgB,CAAC,WAAW,EAAE,WAAW,CAAC,CAAC;IACpD,CAAC;IAED,OAAO,WAAW,KAAK,WAAW,CAAC;AACrC,CAAC;AAED;;;;;;;;;;;;;GAaG;AACH,MAAM,UAAU,YAAY,CAAC,QAAgB,EAAE,OAAe;IAC5D,IAAI,CAAC,QAAQ,IAAI,CAAC,OAAO,EAAE,CAAC;QAC1B,OAAO,KAAK,CAAC;IACf,CAAC;IAED,MAAM,cAAc,GAAG,aAAa,CAAC,QAAQ,CAAC,CAAC;IAC/C,MAAM,iBAAiB,GAAG,aAAa,CAAC,OAAO,CAAC,CAAC;IAEjD,8BAA8B;IAC9B,IAAI,SAAS,EAAE,EAAE,CAAC;QAChB,OAAO,kBAAkB,CAAC,cAAc,EAAE,iBAAiB,CAAC,CAAC;IAC/D,CAAC;IAED,OAAO,cAAc,CAAC,QAAQ,CAAC,iBAAiB,CAAC,CAAC;AACpD,CAAC"}

package/dist/utils/progress-tracker.d.ts

@@ -0,0 +1,51 @@
+/**
+ * Progress tracking utility for init command
+ */
+export interface ProgressStep {
+    name: string;
+    status: 'pending' | 'in_progress' | 'completed' | 'failed';
+    startTime?: number;
+    endTime?: number;
+    details?: string;
+}
+export declare class ProgressTracker {
+    private steps;
+    private spinner?;
+    private currentStep?;
+    /**
+     * Add a step to track
+     */
+    addStep(id: string, name: string): void;
+    /**
+     * Start a step
+     */
+    startStep(id: string, message?: string): Promise<void>;
+    /**
+     * Complete a step
+     */
+    completeStep(id: string, details?: string): Promise<void>;
+    /**
+     * Fail a step
+     */
+    failStep(id: string, error: string): Promise<void>;
+    /**
+     * Update step message
+     */
+    updateMessage(message: string): void;
+    /**
+     * Format duration in human-readable form
+     */
+    private formatDuration;
+    /**
+     * Get summary of all steps
+     */
+    getSummary(): string;
+    /**
+     * Stop any active spinner
+     */
+    stop(): void;
+    /**
+     * Cleanup and destroy tracker
+     */
+    destroy(): void;
+}