@jterrats/smart-deployment 1.0.3

package/lib/scanner/structure-validator.js

@@ -0,0 +1,296 @@
+/**
+ * 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
+ */
+import { promises as fs } from 'node:fs';
+import * as path from 'node:path';
+import { getLogger } from '../utils/logger.js';
+const logger = getLogger('StructureValidator');
+/**
+ * @ac US-084-AC-1: Validate sfdx-project.json
+ */
+export class StructureValidator {
+    /**
+     * @ac US-084-AC-1: Validate sfdx-project.json
+     * Check sfdx-project.json structure and content
+     */
+    async validateSfdxProject(projectRoot) {
+        const issues = [];
+        const sfdxProjectPath = path.join(projectRoot, 'sfdx-project.json');
+        try {
+            const content = await fs.readFile(sfdxProjectPath, 'utf-8');
+            const config = JSON.parse(content);
+            // Check required fields
+            if (!config.packageDirectories) {
+                issues.push({
+                    severity: 'error',
+                    code: 'MISSING_PACKAGE_DIRS',
+                    message: 'packageDirectories is required in sfdx-project.json',
+                    path: sfdxProjectPath,
+                    suggestion: 'Add packageDirectories array to sfdx-project.json',
+                });
+            }
+            if (!config.sfdcLoginUrl && !config.sourceApiVersion) {
+                issues.push({
+                    severity: 'warning',
+                    code: 'MISSING_API_VERSION',
+                    message: 'sourceApiVersion is recommended in sfdx-project.json',
+                    path: sfdxProjectPath,
+                    suggestion: 'Add sourceApiVersion (e.g., "61.0")',
+                });
+            }
+            if (!config.namespace) {
+                issues.push({
+                    severity: 'info',
+                    code: 'NO_NAMESPACE',
+                    message: 'No namespace defined (OK for scratch orgs)',
+                    path: sfdxProjectPath,
+                });
+            }
+            // Validate package directories structure
+            if (config.packageDirectories && Array.isArray(config.packageDirectories)) {
+                for (const pkg of config.packageDirectories) {
+                    if (!pkg.path) {
+                        issues.push({
+                            severity: 'error',
+                            code: 'MISSING_PATH',
+                            message: 'Package directory missing "path" field',
+                            path: sfdxProjectPath,
+                        });
+                    }
+                }
+            }
+        }
+        catch (error) {
+            if (error.code === 'ENOENT') {
+                issues.push({
+                    severity: 'error',
+                    code: 'MISSING_SFDX_PROJECT',
+                    message: 'sfdx-project.json not found',
+                    path: projectRoot,
+                    suggestion: 'Initialize SFDX project: sf project generate',
+                });
+            }
+            else if (error instanceof SyntaxError) {
+                issues.push({
+                    severity: 'error',
+                    code: 'INVALID_JSON',
+                    message: 'sfdx-project.json contains invalid JSON',
+                    path: sfdxProjectPath,
+                    suggestion: 'Fix JSON syntax errors',
+                });
+            }
+        }
+        return issues;
+    }
+    /**
+     * @ac US-084-AC-2: Check package directories exist
+     * Validate package directories exist on filesystem
+     */
+    async validatePackageDirectories(projectRoot) {
+        const issues = [];
+        try {
+            const sfdxProjectPath = path.join(projectRoot, 'sfdx-project.json');
+            const content = await fs.readFile(sfdxProjectPath, 'utf-8');
+            const config = JSON.parse(content);
+            if (config.packageDirectories) {
+                const missingPackages = await Promise.all(config.packageDirectories.map(async (pkg) => {
+                    if (!pkg.path) {
+                        return undefined;
+                    }
+                    const fullPath = path.join(projectRoot, pkg.path);
+                    try {
+                        await fs.access(fullPath);
+                        return undefined;
+                    }
+                    catch {
+                        return {
+                            severity: 'error',
+                            code: 'PACKAGE_DIR_NOT_FOUND',
+                            message: `Package directory not found: ${pkg.path}`,
+                            path: fullPath,
+                            suggestion: `Create directory: mkdir -p ${pkg.path}`,
+                        };
+                    }
+                }));
+                issues.push(...missingPackages.filter(Boolean));
+            }
+        }
+        catch {
+            // Already handled in validateSfdxProject
+        }
+        return issues;
+    }
+    /**
+     * @ac US-084-AC-3: Validate .forceignore
+     * Check .forceignore file
+     */
+    async validateForceIgnore(projectRoot) {
+        const issues = [];
+        const forceIgnorePath = path.join(projectRoot, '.forceignore');
+        try {
+            await fs.access(forceIgnorePath);
+            // Read and check content
+            const content = await fs.readFile(forceIgnorePath, 'utf-8');
+            if (content.trim().length === 0) {
+                issues.push({
+                    severity: 'warning',
+                    code: 'EMPTY_FORCEIGNORE',
+                    message: '.forceignore is empty',
+                    path: forceIgnorePath,
+                    suggestion: 'Add common ignore patterns (e.g., **/*.dup, .sfdx/)',
+                });
+            }
+        }
+        catch {
+            issues.push({
+                severity: 'warning',
+                code: 'MISSING_FORCEIGNORE',
+                message: '.forceignore not found',
+                path: projectRoot,
+                suggestion: 'Create .forceignore to exclude unwanted files',
+            });
+        }
+        return issues;
+    }
+    /**
+     * @ac US-084-AC-4: Check for required files
+     * Check for other important files
+     */
+    async validateRequiredFiles(projectRoot) {
+        const issues = [];
+        const requiredFiles = [
+            { file: '.gitignore', severity: 'warning', suggestion: 'Add .gitignore for version control' },
+            { file: 'README.md', severity: 'info', suggestion: 'Add README.md for documentation' },
+        ];
+        const missingFiles = await Promise.all(requiredFiles.map(async ({ file, severity, suggestion }) => {
+            const filePath = path.join(projectRoot, file);
+            try {
+                await fs.access(filePath);
+                return undefined;
+            }
+            catch {
+                return {
+                    severity,
+                    code: `MISSING_${file.toUpperCase().replace(/\./g, '_')}`,
+                    message: `${file} not found`,
+                    path: projectRoot,
+                    suggestion,
+                };
+            }
+        }));
+        issues.push(...missingFiles.filter(Boolean));
+        return issues;
+    }
+    /**
+     * @ac US-084-AC-5: Detect structure issues
+     * Check for common structure problems
+     */
+    async detectStructureIssues(projectRoot) {
+        const issues = [];
+        // Check for metadata in wrong location
+        const commonMetadataDirs = ['classes', 'triggers', 'objects', 'lwc', 'aura'];
+        const misplacedDirs = await Promise.all(commonMetadataDirs.map(async (dir) => {
+            const wrongPath = path.join(projectRoot, dir);
+            try {
+                await fs.access(wrongPath);
+                return {
+                    severity: 'warning',
+                    code: 'METADATA_IN_ROOT',
+                    message: `Metadata directory found in project root: ${dir}`,
+                    path: wrongPath,
+                    suggestion: 'Move metadata into package directory (e.g., force-app/main/default/)',
+                };
+            }
+            catch {
+                return undefined;
+            }
+        }));
+        issues.push(...misplacedDirs.filter(Boolean));
+        return issues;
+    }
+    /**
+     * @ac US-084-AC-6: Generate validation report
+     * Validate entire project structure
+     */
+    async validate(projectRoot) {
+        const startTime = Date.now();
+        logger.info('Validating project structure', { projectRoot });
+        const issues = [];
+        const checkedPaths = [];
+        // Run all validations
+        issues.push(...(await this.validateSfdxProject(projectRoot)));
+        checkedPaths.push(path.join(projectRoot, 'sfdx-project.json'));
+        issues.push(...(await this.validatePackageDirectories(projectRoot)));
+        issues.push(...(await this.validateForceIgnore(projectRoot)));
+        checkedPaths.push(path.join(projectRoot, '.forceignore'));
+        issues.push(...(await this.validateRequiredFiles(projectRoot)));
+        issues.push(...(await this.detectStructureIssues(projectRoot)));
+        const hasErrors = issues.some((i) => i.severity === 'error');
+        const executionTime = Date.now() - startTime;
+        logger.info('Validation complete', {
+            isValid: !hasErrors,
+            totalIssues: issues.length,
+            errors: issues.filter((i) => i.severity === 'error').length,
+            warnings: issues.filter((i) => i.severity === 'warning').length,
+            executionTime,
+        });
+        return {
+            isValid: !hasErrors,
+            issues,
+            checkedPaths,
+            executionTime,
+        };
+    }
+    /**
+     * Format validation report
+     */
+    formatReport(report) {
+        const lines = [];
+        lines.push('✓ Project Structure Validation');
+        lines.push('═══════════════════════════════════════');
+        lines.push(`Status: ${report.isValid ? '✅ VALID' : '❌ INVALID'}`);
+        lines.push(`Checked Paths: ${report.checkedPaths.length}`);
+        lines.push(`Execution Time: ${report.executionTime}ms`);
+        lines.push('');
+        const errors = report.issues.filter((i) => i.severity === 'error');
+        const warnings = report.issues.filter((i) => i.severity === 'warning');
+        const infos = report.issues.filter((i) => i.severity === 'info');
+        if (errors.length > 0) {
+            lines.push(`🔴 Errors (${errors.length}):`);
+            for (const issue of errors) {
+                lines.push(`  [${issue.code}] ${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.code}] ${issue.message}`);
+                if (issue.suggestion) {
+                    lines.push(`    💡 ${issue.suggestion}`);
+                }
+            }
+            lines.push('');
+        }
+        if (infos.length > 0) {
+            lines.push(`ℹ️  Info (${infos.length}):`);
+            for (const issue of infos) {
+                lines.push(`  [${issue.code}] ${issue.message}`);
+            }
+        }
+        return lines.join('\n');
+    }
+}
+//# sourceMappingURL=structure-validator.js.map

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

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

package/lib/services/metadata-scanner-service.d.ts

@@ -0,0 +1,64 @@
+/**
+ * Metadata Scanner Service
+ * Orchestrates project scanning, parsing, and dependency analysis
+ *
+ * Integrates:
+ * - SfdxProjectDetector
+ * - ForceIgnoreParser
+ * - Metadata parsers (all types)
+ * - DependencyGraphBuilder
+ */
+import type { MetadataComponent } from '../types/metadata.js';
+import type { DependencyAnalysisResult } from '../types/dependency.js';
+export type ScanOptions = {
+    sourcePath?: string;
+    includeIgnored?: boolean;
+    maxDepth?: number;
+};
+export type ScanResult = {
+    components: MetadataComponent[];
+    dependencyResult: DependencyAnalysisResult;
+    projectRoot: string;
+    executionTime: number;
+    errors: string[];
+    warnings: string[];
+};
+/**
+ * Metadata file pattern matcher
+ * TODO: Use when implementing pattern-based metadata detection
+ */
+/**
+ * Metadata Scanner Service
+ * Scans project, parses metadata, and builds dependency graph
+ */
+export declare class MetadataScannerService {
+    private forceIgnoreParser?;
+    /**
+     * Scan project and analyze dependencies
+     */
+    scan(options?: ScanOptions): Promise<ScanResult>;
+    /**
+     * Scan metadata files from package directories
+     */
+    private scanMetadata;
+    /**
+     * Scan a package directory for all metadata types
+     */
+    private scanPackageDirectory;
+    /**
+     * Find files matching a glob pattern
+     */
+    private findFiles;
+    /**
+     * Find directories matching a glob pattern
+     */
+    private findDirectories;
+    /**
+     * Check if file should be ignored by .forceignore
+     */
+    private shouldIgnore;
+    /**
+     * Check if file/directory exists
+     */
+    private fileExists;
+}