@jterrats/smart-deployment 1.0.3

package/lib/scanner/project-validator.js

@@ -0,0 +1,235 @@
+/**
+ * Project Structure Validator - US-084
+ * Validates SFDX project structure
+ *
+ * @ac US-084-AC-1: Validate sfdx-project.json schema
+ * @ac US-084-AC-2: Validate package directories exist
+ * @ac US-084-AC-3: Validate metadata structure
+ * @ac US-084-AC-4: Check for required files
+ * @ac US-084-AC-5: Generate validation report
+ * @ac US-084-AC-6: Suggest fixes for issues
+ * @issue #84
+ */
+import * as fs from 'node:fs';
+import * as path from 'node:path';
+import { getLogger } from '../utils/logger.js';
+import { SfdxProjectDetector } from './sfdx-project-detector.js';
+const logger = getLogger('ProjectValidator');
+/**
+ * @ac US-084-AC-1: Validate sfdx-project.json schema
+ */
+export class ProjectValidator {
+    /**
+     * Validate project structure
+     */
+    async validate(projectRoot) {
+        const startTime = Date.now();
+        const report = {
+            isValid: true,
+            issues: [],
+            checkedItems: [],
+            executionTime: 0,
+        };
+        try {
+            // Check 1: sfdx-project.json exists
+            this.validateSfdxProjectJson(projectRoot, report);
+            // Check 2: Package directories exist
+            await this.validatePackageDirectories(projectRoot, report);
+            // Check 3: Metadata structure
+            await this.validateMetadataStructure(projectRoot, report);
+            // Check 4: Required files
+            this.validateRequiredFiles(projectRoot, report);
+            // Determine overall validity
+            report.isValid = !report.issues.some((i) => i.severity === 'error');
+            report.executionTime = Date.now() - startTime;
+            logger.info('Project validation complete', {
+                isValid: report.isValid,
+                issues: report.issues.length,
+                executionTime: report.executionTime,
+            });
+            return report;
+        }
+        catch (error) {
+            report.isValid = false;
+            report.issues.push({
+                severity: 'error',
+                message: 'Validation failed: ' + (error instanceof Error ? error.message : String(error)),
+            });
+            report.executionTime = Date.now() - startTime;
+            return report;
+        }
+    }
+    /**
+     * @ac US-084-AC-1: Validate sfdx-project.json schema
+     */
+    validateSfdxProjectJson(projectRoot, report) {
+        report.checkedItems.push('sfdx-project.json existence');
+        const sfdxProjectPath = path.join(projectRoot, 'sfdx-project.json');
+        if (!fs.existsSync(sfdxProjectPath)) {
+            report.issues.push({
+                severity: 'error',
+                message: 'sfdx-project.json not found',
+                path: sfdxProjectPath,
+                suggestion: 'Run: sfdx force:project:create to initialize a new project',
+            });
+            return;
+        }
+        // Validate JSON structure
+        try {
+            const content = fs.readFileSync(sfdxProjectPath, 'utf-8');
+            const config = JSON.parse(content);
+            report.checkedItems.push('sfdx-project.json valid JSON');
+            // Check required fields
+            if (!config.packageDirectories) {
+                report.issues.push({
+                    severity: 'error',
+                    message: 'packageDirectories field missing in sfdx-project.json',
+                    path: sfdxProjectPath,
+                    suggestion: 'Add packageDirectories array to sfdx-project.json',
+                });
+            }
+            if (!config.namespace && !config.sfdcLoginUrl) {
+                report.issues.push({
+                    severity: 'warning',
+                    message: 'Neither namespace nor sfdcLoginUrl defined',
+                    path: sfdxProjectPath,
+                    suggestion: 'Consider adding sfdcLoginUrl for proper authentication',
+                });
+            }
+            report.checkedItems.push('sfdx-project.json schema');
+        }
+        catch {
+            report.issues.push({
+                severity: 'error',
+                message: 'Invalid JSON in sfdx-project.json',
+                path: sfdxProjectPath,
+                suggestion: 'Fix JSON syntax errors',
+            });
+        }
+    }
+    /**
+     * @ac US-084-AC-2: Validate package directories exist
+     */
+    async validatePackageDirectories(projectRoot, report) {
+        report.checkedItems.push('package directories');
+        const projectInfo = await SfdxProjectDetector.detect(projectRoot);
+        for (const packageDir of projectInfo.packageDirectories) {
+            const fullPath = path.join(projectRoot, packageDir);
+            if (!fs.existsSync(fullPath)) {
+                report.issues.push({
+                    severity: 'error',
+                    message: `Package directory does not exist: ${packageDir}`,
+                    path: fullPath,
+                    suggestion: `Create directory: mkdir -p ${packageDir}`,
+                });
+            }
+        }
+    }
+    /**
+     * @ac US-084-AC-3: Validate metadata structure
+     */
+    async validateMetadataStructure(projectRoot, report) {
+        report.checkedItems.push('metadata structure');
+        const projectInfo = await SfdxProjectDetector.detect(projectRoot);
+        for (const packageDir of projectInfo.packageDirectories) {
+            const packagePath = path.join(projectRoot, packageDir);
+            if (!fs.existsSync(packagePath))
+                continue;
+            // Check for common metadata folders
+            const commonFolders = ['classes', 'triggers', 'objects', 'lwc', 'aura'];
+            let hasMetadata = false;
+            for (const folder of commonFolders) {
+                const folderPath = path.join(packagePath, 'main', 'default', folder);
+                if (fs.existsSync(folderPath)) {
+                    hasMetadata = true;
+                    break;
+                }
+            }
+            if (!hasMetadata) {
+                report.issues.push({
+                    severity: 'info',
+                    message: `No metadata found in package: ${packageDir}`,
+                    path: packagePath,
+                    suggestion: 'This might be intentional for a new project',
+                });
+            }
+        }
+    }
+    /**
+     * @ac US-084-AC-4: Check for required files
+     */
+    validateRequiredFiles(projectRoot, report) {
+        report.checkedItems.push('required files');
+        const recommendedFiles = [
+            { file: '.gitignore', severity: 'warning', suggestion: 'Add .gitignore to exclude build artifacts' },
+            {
+                file: '.forceignore',
+                severity: 'warning',
+                suggestion: 'Add .forceignore to exclude files from deployment',
+            },
+            { file: 'README.md', severity: 'info', suggestion: 'Add README.md to document your project' },
+        ];
+        for (const { file, severity, suggestion } of recommendedFiles) {
+            const filePath = path.join(projectRoot, file);
+            if (!fs.existsSync(filePath)) {
+                report.issues.push({
+                    severity,
+                    message: `${file} not found`,
+                    path: filePath,
+                    suggestion,
+                });
+            }
+        }
+    }
+    /**
+     * @ac US-084-AC-5: Generate validation report
+     * @ac US-084-AC-6: Suggest fixes for issues
+     * Format validation report
+     */
+    formatReport(report) {
+        const lines = [];
+        lines.push('✓ Project Validation Report');
+        lines.push('═══════════════════════════════════════');
+        lines.push(`Status: ${report.isValid ? '✅ VALID' : '❌ INVALID'}`);
+        lines.push(`Checks Performed: ${report.checkedItems.length}`);
+        lines.push(`Issues Found: ${report.issues.length}`);
+        lines.push(`Execution Time: ${report.executionTime}ms`);
+        lines.push('');
+        if (report.issues.length > 0) {
+            const errors = report.issues.filter((i) => i.severity === 'error');
+            const warnings = report.issues.filter((i) => i.severity === 'warning');
+            const info = report.issues.filter((i) => i.severity === 'info');
+            if (errors.length > 0) {
+                lines.push(`❌ Errors (${errors.length}):`);
+                for (const issue of errors) {
+                    lines.push(`   ${issue.message}`);
+                    if (issue.suggestion) {
+                        lines.push(`   💡 ${issue.suggestion}`);
+                    }
+                }
+                lines.push('');
+            }
+            if (warnings.length > 0) {
+                lines.push(`⚠️  Warnings (${warnings.length}):`);
+                for (const issue of warnings) {
+                    lines.push(`   ${issue.message}`);
+                    if (issue.suggestion) {
+                        lines.push(`   💡 ${issue.suggestion}`);
+                    }
+                }
+                lines.push('');
+            }
+            if (info.length > 0) {
+                lines.push(`ℹ️  Info (${info.length}):`);
+                for (const issue of info) {
+                    lines.push(`   ${issue.message}`);
+                }
+            }
+        }
+        else {
+            lines.push('✅ No issues found - project structure is valid!');
+        }
+        return lines.join('\n');
+    }
+}
+//# sourceMappingURL=project-validator.js.map

package/lib/scanner/project-validator.js.map

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

package/lib/scanner/sfdx-project-detector.d.ts

@@ -0,0 +1,86 @@
+/**
+ * SFDX Project Detector - US-079
+ * Detects and validates Salesforce DX project structure
+ *
+ * @ac US-079-AC-1: Detect sfdx-project.json
+ * @ac US-079-AC-2: Parse project configuration
+ * @ac US-079-AC-3: Validate project structure
+ * @ac US-079-AC-4: Detect package directories
+ * @ac US-079-AC-5: Support multi-package projects
+ * @ac US-079-AC-6: Report project metadata
+ * @issue #79
+ */
+export type SfdxProjectJson = {
+    packageDirectories: PackageDirectory[];
+    namespace?: string;
+    sourceApiVersion: string;
+    sfdcLoginUrl?: string;
+    plugins?: Record<string, unknown>;
+    [key: string]: unknown;
+};
+export type PackageDirectory = {
+    path: string;
+    default?: boolean;
+    package?: string;
+    versionName?: string;
+    versionNumber?: string;
+    dependencies?: PackageDependency[];
+};
+export type PackageDependency = {
+    package: string;
+    versionNumber: string;
+};
+export type ProjectDetectionResult = {
+    detected: boolean;
+    projectRoot: string;
+    projectFile: string;
+    projectConfig?: SfdxProjectJson;
+    packageDirectories: string[];
+    defaultPackageDirectory?: string;
+    isMultiPackage: boolean;
+    apiVersion: string;
+    namespace?: string;
+    errors: string[];
+    warnings: string[];
+};
+/**
+ * @ac US-079-AC-1: Detect sfdx-project.json
+ * @ac US-079-AC-2: Parse project configuration
+ */
+export declare class SfdxProjectDetector {
+    private static readonly PROJECT_FILE_NAME;
+    private static readonly MAX_SEARCH_DEPTH;
+    /**
+     * Detect SFDX project starting from a given directory
+     * Searches up the directory tree until finding sfdx-project.json
+     */
+    static detect(startPath: string): Promise<ProjectDetectionResult>;
+    /**
+     * @ac US-079-AC-1: Detect sfdx-project.json
+     * Search up the directory tree for sfdx-project.json
+     */
+    private static findProjectFile;
+    private static findProjectFileRecursive;
+    /**
+     * @ac US-079-AC-2: Parse project configuration
+     */
+    private static parseProjectFile;
+    /**
+     * @ac US-079-AC-3: Validate project structure
+     * @ac US-079-AC-4: Detect package directories
+     * @ac US-079-AC-5: Support multi-package projects
+     */
+    private static validateProjectStructure;
+    /**
+     * @ac US-079-AC-6: Report project metadata
+     */
+    static formatDetectionReport(result: ProjectDetectionResult): string;
+    /**
+     * Check if a path is within an SFDX project
+     */
+    static isInProject(path: string): Promise<boolean>;
+    /**
+     * Get project root for a given path
+     */
+    static getProjectRoot(path: string): Promise<string | null>;
+}

package/lib/scanner/sfdx-project-detector.js

@@ -0,0 +1,240 @@
+/**
+ * SFDX Project Detector - US-079
+ * Detects and validates Salesforce DX project structure
+ *
+ * @ac US-079-AC-1: Detect sfdx-project.json
+ * @ac US-079-AC-2: Parse project configuration
+ * @ac US-079-AC-3: Validate project structure
+ * @ac US-079-AC-4: Detect package directories
+ * @ac US-079-AC-5: Support multi-package projects
+ * @ac US-079-AC-6: Report project metadata
+ * @issue #79
+ */
+import { readFile, access } from 'node:fs/promises';
+import { resolve, dirname, join } from 'node:path';
+import { getLogger } from '../utils/logger.js';
+const logger = getLogger('SfdxProjectDetector');
+/**
+ * @ac US-079-AC-1: Detect sfdx-project.json
+ * @ac US-079-AC-2: Parse project configuration
+ */
+export class SfdxProjectDetector {
+    static PROJECT_FILE_NAME = 'sfdx-project.json';
+    static MAX_SEARCH_DEPTH = 5;
+    /**
+     * Detect SFDX project starting from a given directory
+     * Searches up the directory tree until finding sfdx-project.json
+     */
+    static async detect(startPath) {
+        logger.info('Detecting SFDX project', { startPath });
+        const result = {
+            detected: false,
+            projectRoot: '',
+            projectFile: '',
+            packageDirectories: [],
+            isMultiPackage: false,
+            apiVersion: '',
+            errors: [],
+            warnings: [],
+        };
+        try {
+            // Search for sfdx-project.json
+            const projectFile = await this.findProjectFile(startPath);
+            if (!projectFile) {
+                result.errors.push('sfdx-project.json not found');
+                logger.warn('SFDX project not detected', { startPath });
+                return result;
+            }
+            result.detected = true;
+            result.projectFile = projectFile;
+            result.projectRoot = dirname(projectFile);
+            // Parse and validate project configuration
+            const projectConfig = await this.parseProjectFile(projectFile);
+            result.projectConfig = projectConfig;
+            result.apiVersion = projectConfig.sourceApiVersion;
+            result.namespace = projectConfig.namespace;
+            // Extract package directories
+            const validation = this.validateProjectStructure(projectConfig, result.projectRoot);
+            result.packageDirectories = validation.packagePaths;
+            result.defaultPackageDirectory = validation.defaultPath;
+            result.isMultiPackage = validation.isMultiPackage;
+            result.errors.push(...validation.errors);
+            result.warnings.push(...validation.warnings);
+            logger.info('SFDX project detected', {
+                projectRoot: result.projectRoot,
+                packages: result.packageDirectories.length,
+                apiVersion: result.apiVersion,
+            });
+            return result;
+        }
+        catch (error) {
+            result.errors.push(`Detection failed: ${error instanceof Error ? error.message : String(error)}`);
+            logger.error('Project detection failed', { error, startPath });
+            return result;
+        }
+    }
+    /**
+     * @ac US-079-AC-1: Detect sfdx-project.json
+     * Search up the directory tree for sfdx-project.json
+     */
+    static async findProjectFile(startPath) {
+        return this.findProjectFileRecursive(resolve(startPath), 0);
+    }
+    static async findProjectFileRecursive(currentPath, depth) {
+        if (depth >= this.MAX_SEARCH_DEPTH) {
+            return null;
+        }
+        const projectFilePath = join(currentPath, this.PROJECT_FILE_NAME);
+        try {
+            await access(projectFilePath);
+            logger.debug('Found sfdx-project.json', { path: projectFilePath });
+            return projectFilePath;
+        }
+        catch {
+            const parentPath = dirname(currentPath);
+            if (parentPath === currentPath) {
+                return null;
+            }
+            return this.findProjectFileRecursive(parentPath, depth + 1);
+        }
+    }
+    /**
+     * @ac US-079-AC-2: Parse project configuration
+     */
+    static async parseProjectFile(filePath) {
+        logger.debug('Parsing sfdx-project.json', { filePath });
+        try {
+            const content = await readFile(filePath, 'utf-8');
+            const config = JSON.parse(content);
+            // Validate required fields
+            if (!config.packageDirectories || !Array.isArray(config.packageDirectories)) {
+                throw new Error('Missing or invalid packageDirectories');
+            }
+            if (!config.sourceApiVersion) {
+                throw new Error('Missing sourceApiVersion');
+            }
+            return config;
+        }
+        catch (error) {
+            throw new Error(`Failed to parse sfdx-project.json: ${error instanceof Error ? error.message : String(error)}`);
+        }
+    }
+    /**
+     * @ac US-079-AC-3: Validate project structure
+     * @ac US-079-AC-4: Detect package directories
+     * @ac US-079-AC-5: Support multi-package projects
+     */
+    static validateProjectStructure(config, projectRoot) {
+        const errors = [];
+        const warnings = [];
+        const packagePaths = [];
+        let defaultPath;
+        // Validate package directories
+        if (config.packageDirectories.length === 0) {
+            errors.push('No package directories defined');
+        }
+        let defaultCount = 0;
+        for (const pkgDir of config.packageDirectories) {
+            if (!pkgDir.path) {
+                errors.push('Package directory missing path');
+                continue;
+            }
+            const fullPath = resolve(projectRoot, pkgDir.path);
+            packagePaths.push(fullPath);
+            if (pkgDir.default) {
+                defaultCount++;
+                defaultPath = fullPath;
+            }
+        }
+        // Validate default package
+        if (defaultCount === 0) {
+            warnings.push('No default package directory specified');
+            // Use first package as default
+            if (packagePaths.length > 0) {
+                defaultPath = packagePaths[0];
+            }
+        }
+        else if (defaultCount > 1) {
+            errors.push('Multiple default package directories found');
+        }
+        // Check if multi-package
+        const isMultiPackage = config.packageDirectories.length > 1;
+        if (isMultiPackage) {
+            logger.info('Multi-package project detected', {
+                packages: config.packageDirectories.length,
+            });
+        }
+        return {
+            packagePaths,
+            defaultPath,
+            isMultiPackage,
+            errors,
+            warnings,
+        };
+    }
+    /**
+     * @ac US-079-AC-6: Report project metadata
+     */
+    static formatDetectionReport(result) {
+        const lines = [];
+        lines.push('📦 SFDX Project Detection Report');
+        lines.push('═══════════════════════════════════════');
+        if (!result.detected) {
+            lines.push('❌ No SFDX project detected');
+            if (result.errors.length > 0) {
+                lines.push('\nErrors:');
+                for (const error of result.errors) {
+                    lines.push(`  • ${error}`);
+                }
+            }
+            return lines.join('\n');
+        }
+        lines.push('✅ Project detected');
+        lines.push(`   Root: ${result.projectRoot}`);
+        lines.push(`   Config: ${result.projectFile}`);
+        lines.push('');
+        lines.push('📋 Configuration:');
+        lines.push(`   API Version: ${result.apiVersion}`);
+        if (result.namespace) {
+            lines.push(`   Namespace: ${result.namespace}`);
+        }
+        lines.push(`   Multi-Package: ${result.isMultiPackage ? 'Yes' : 'No'}`);
+        lines.push('');
+        lines.push(`📂 Package Directories (${result.packageDirectories.length}):`);
+        for (let i = 0; i < result.packageDirectories.length; i++) {
+            const pkgPath = result.packageDirectories[i];
+            const isDefault = pkgPath === result.defaultPackageDirectory;
+            lines.push(`   ${i + 1}. ${pkgPath}${isDefault ? ' (default)' : ''}`);
+        }
+        if (result.warnings.length > 0) {
+            lines.push('');
+            lines.push('⚠️  Warnings:');
+            for (const warning of result.warnings) {
+                lines.push(`   • ${warning}`);
+            }
+        }
+        if (result.errors.length > 0) {
+            lines.push('');
+            lines.push('❌ Errors:');
+            for (const error of result.errors) {
+                lines.push(`   • ${error}`);
+            }
+        }
+        return lines.join('\n');
+    }
+    /**
+     * Check if a path is within an SFDX project
+     */
+    static async isInProject(path) {
+        const result = await this.detect(path);
+        return result.detected;
+    }
+    /**
+     * Get project root for a given path
+     */
+    static async getProjectRoot(path) {
+        const result = await this.detect(path);
+        return result.detected ? result.projectRoot : null;
+    }
+}
+//# sourceMappingURL=sfdx-project-detector.js.map

package/lib/scanner/sfdx-project-detector.js.map

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

package/lib/scanner/structure-validator.d.ts

@@ -0,0 +1,64 @@
+/**
+ * Project Structure Validator - US-084
+ * Validates project structure and configuration
+ *
+ * @ac US-084-AC-1: Validate sfdx-project.json
+ * @ac US-084-AC-2: Check package directories exist
+ * @ac US-084-AC-3: Validate .forceignore
+ * @ac US-084-AC-4: Check for required files
+ * @ac US-084-AC-5: Detect structure issues
+ * @ac US-084-AC-6: Generate validation report
+ * @issue #84
+ */
+export type ValidationIssue = {
+    severity: 'error' | 'warning' | 'info';
+    code: string;
+    message: string;
+    path?: string;
+    suggestion?: string;
+};
+export type ValidationReport = {
+    isValid: boolean;
+    issues: ValidationIssue[];
+    checkedPaths: string[];
+    executionTime: number;
+};
+/**
+ * @ac US-084-AC-1: Validate sfdx-project.json
+ */
+export declare class StructureValidator {
+    /**
+     * @ac US-084-AC-1: Validate sfdx-project.json
+     * Check sfdx-project.json structure and content
+     */
+    validateSfdxProject(projectRoot: string): Promise<ValidationIssue[]>;
+    /**
+     * @ac US-084-AC-2: Check package directories exist
+     * Validate package directories exist on filesystem
+     */
+    validatePackageDirectories(projectRoot: string): Promise<ValidationIssue[]>;
+    /**
+     * @ac US-084-AC-3: Validate .forceignore
+     * Check .forceignore file
+     */
+    validateForceIgnore(projectRoot: string): Promise<ValidationIssue[]>;
+    /**
+     * @ac US-084-AC-4: Check for required files
+     * Check for other important files
+     */
+    validateRequiredFiles(projectRoot: string): Promise<ValidationIssue[]>;
+    /**
+     * @ac US-084-AC-5: Detect structure issues
+     * Check for common structure problems
+     */
+    detectStructureIssues(projectRoot: string): Promise<ValidationIssue[]>;
+    /**
+     * @ac US-084-AC-6: Generate validation report
+     * Validate entire project structure
+     */
+    validate(projectRoot: string): Promise<ValidationReport>;
+    /**
+     * Format validation report
+     */
+    formatReport(report: ValidationReport): string;
+}