@jterrats/smart-deployment 1.0.3

package/lib/scanner/metadata-format-scanner.js

@@ -0,0 +1,282 @@
+/**
+ * Metadata API Format Scanner - US-080
+ * Supports legacy Metadata API format (package.xml + src/)
+ *
+ * @ac US-080-AC-1: Detect package.xml
+ * @ac US-080-AC-2: Scan src/ directory
+ * @ac US-080-AC-3: Parse metadata format files
+ * @ac US-080-AC-4: Convert to source format internally
+ * @ac US-080-AC-5: Handle Documents folder structure
+ * @ac US-080-AC-6: Handle DigitalExperience bundles
+ * @issue #80
+ */
+import * as fs from 'node:fs';
+import * as path from 'node:path';
+import { getLogger } from '../utils/logger.js';
+import { ErrorAggregator } from '../utils/error-aggregator.js';
+const logger = getLogger('MetadataFormatScanner');
+/**
+ * @ac US-080-AC-1: Detect package.xml
+ * @ac US-080-AC-2: Scan src/ directory
+ */
+export class MetadataFormatScanner {
+    errorAggregator = new ErrorAggregator();
+    /**
+     * @ac US-080-AC-1: Detect package.xml
+     * Check if project uses Metadata API format
+     */
+    detectFormat(projectRoot) {
+        const hasPackageXml = fs.existsSync(path.join(projectRoot, 'package.xml'));
+        const hasSrcDir = fs.existsSync(path.join(projectRoot, 'src'));
+        const hasSfdxProject = fs.existsSync(path.join(projectRoot, 'sfdx-project.json'));
+        logger.info('Detecting project format', {
+            hasPackageXml,
+            hasSrcDir,
+            hasSfdxProject,
+        });
+        if (hasPackageXml && hasSrcDir && !hasSfdxProject) {
+            return 'metadata-api';
+        }
+        if (hasSfdxProject && !hasPackageXml) {
+            return 'source-format';
+        }
+        if (hasPackageXml && hasSfdxProject) {
+            return 'mixed';
+        }
+        return 'source-format'; // Default
+    }
+    /**
+     * @ac US-080-AC-2: Scan src/ directory
+     * Scan Metadata API format project
+     */
+    async scan(projectRoot) {
+        const startTime = Date.now();
+        const result = {
+            format: this.detectFormat(projectRoot),
+            components: [],
+            warnings: [],
+            executionTime: 0,
+        };
+        if (result.format !== 'metadata-api' && result.format !== 'mixed') {
+            result.warnings.push('Project is not in Metadata API format');
+            result.executionTime = Date.now() - startTime;
+            return result;
+        }
+        try {
+            // Find package.xml
+            const packageXmlPath = path.join(projectRoot, 'package.xml');
+            if (fs.existsSync(packageXmlPath)) {
+                result.packageXmlPath = packageXmlPath;
+                const packageEntries = this.parsePackageXml(packageXmlPath);
+                logger.info('Parsed package.xml', { entries: packageEntries.length });
+            }
+            // Scan src/ directory
+            const srcDir = path.join(projectRoot, 'src');
+            if (fs.existsSync(srcDir)) {
+                result.srcDirectory = srcDir;
+                const components = await this.scanSrcDirectory(srcDir);
+                result.components = components;
+                logger.info('Scanned src/ directory', { components: components.length });
+            }
+            result.executionTime = Date.now() - startTime;
+            logger.info('Metadata format scan complete', {
+                format: result.format,
+                components: result.components.length,
+                executionTime: result.executionTime,
+            });
+            return result;
+        }
+        catch (error) {
+            this.errorAggregator.addError({
+                severity: 'HIGH',
+                message: 'Failed to scan Metadata API format',
+                context: { error: error instanceof Error ? error.message : String(error) },
+            });
+            result.warnings.push('Scan failed: ' + (error instanceof Error ? error.message : String(error)));
+            result.executionTime = Date.now() - startTime;
+            return result;
+        }
+    }
+    /**
+     * @ac US-080-AC-3: Parse metadata format files
+     * Parse package.xml
+     */
+    parsePackageXml(packageXmlPath) {
+        try {
+            const content = fs.readFileSync(packageXmlPath, 'utf-8');
+            const entries = [];
+            // Simple XML parsing for <types> elements
+            const typeBlocks = content.match(/<types>[\s\S]*?<\/types>/g) ?? [];
+            for (const block of typeBlocks) {
+                const typeMatch = /<name>(.*?)<\/name>/.exec(block);
+                const memberMatches = block.match(/<members>(.*?)<\/members>/g) ?? [];
+                if (typeMatch) {
+                    const type = typeMatch[1];
+                    for (const memberMatch of memberMatches) {
+                        const nameMatch = /<members>(.*?)<\/members>/.exec(memberMatch);
+                        if (nameMatch) {
+                            entries.push({
+                                type,
+                                name: nameMatch[1],
+                            });
+                        }
+                    }
+                }
+            }
+            logger.debug('Parsed package.xml', { entries: entries.length });
+            return entries;
+        }
+        catch (error) {
+            logger.error('Failed to parse package.xml', {
+                error: error instanceof Error ? error.message : String(error),
+            });
+            return [];
+        }
+    }
+    /**
+     * @ac US-080-AC-2: Scan src/ directory
+     * @ac US-080-AC-4: Convert to source format internally
+     * Scan Metadata API src/ directory
+     */
+    async scanSrcDirectory(srcDir) {
+        const components = [];
+        try {
+            const entries = fs.readdirSync(srcDir, { withFileTypes: true });
+            const typeComponents = await Promise.all(entries.map((entry) => {
+                if (!entry.isDirectory()) {
+                    return Promise.resolve([]);
+                }
+                const typeDir = path.join(srcDir, entry.name);
+                const metadataType = this.mapDirectoryToType(entry.name);
+                if (!metadataType) {
+                    logger.debug('Unknown metadata type directory', { dir: entry.name });
+                    return Promise.resolve([]);
+                }
+                return this.scanTypeDirectory(typeDir, metadataType);
+            }));
+            components.push(...typeComponents.flat());
+            return components;
+        }
+        catch (error) {
+            logger.error('Failed to scan src/ directory', {
+                error: error instanceof Error ? error.message : String(error),
+            });
+            return [];
+        }
+    }
+    /**
+     * @ac US-080-AC-3: Parse metadata format files
+     * Scan specific metadata type directory
+     */
+    scanTypeDirectory(typeDir, metadataType) {
+        const components = [];
+        try {
+            const files = fs.readdirSync(typeDir);
+            for (const file of files) {
+                // Skip meta.xml files
+                if (file.endsWith('-meta.xml'))
+                    continue;
+                const filePath = path.join(typeDir, file);
+                const stat = fs.statSync(filePath);
+                if (stat.isFile()) {
+                    const name = this.extractComponentName(file, metadataType);
+                    components.push({
+                        name,
+                        type: metadataType,
+                        filePath,
+                        dependencies: new Set(),
+                        dependents: new Set(),
+                        priorityBoost: 0,
+                    });
+                }
+                else if (stat.isDirectory()) {
+                    // Handle bundle types (e.g., Documents, DigitalExperience)
+                    const bundleComponents = this.scanBundleDirectory(filePath, metadataType);
+                    components.push(...bundleComponents);
+                }
+            }
+            return components;
+        }
+        catch (error) {
+            logger.error('Failed to scan type directory', {
+                typeDir,
+                error: error instanceof Error ? error.message : String(error),
+            });
+            return [];
+        }
+    }
+    /**
+     * @ac US-080-AC-5: Handle Documents folder structure
+     * @ac US-080-AC-6: Handle DigitalExperience bundles
+     * Scan bundle directory (for Documents, DigitalExperience, etc.)
+     */
+    scanBundleDirectory(bundleDir, metadataType) {
+        const components = [];
+        try {
+            const bundleName = path.basename(bundleDir);
+            // For bundles, create a single component representing the bundle
+            components.push({
+                name: bundleName,
+                type: metadataType,
+                filePath: bundleDir,
+                dependencies: new Set(),
+                dependents: new Set(),
+                priorityBoost: 0,
+            });
+            logger.debug('Scanned bundle directory', { bundleName, type: metadataType });
+            return components;
+        }
+        catch (error) {
+            logger.error('Failed to scan bundle directory', {
+                bundleDir,
+                error: error instanceof Error ? error.message : String(error),
+            });
+            return [];
+        }
+    }
+    /**
+     * @ac US-080-AC-4: Convert to source format internally
+     * Map Metadata API directory name to MetadataType
+     */
+    mapDirectoryToType(dirName) {
+        const mappings = {
+            classes: 'ApexClass',
+            triggers: 'ApexTrigger',
+            pages: 'VisualforcePage',
+            components: 'VisualforceComponent',
+            objects: 'CustomObject',
+            layouts: 'Layout',
+            profiles: 'Profile',
+            permissionsets: 'PermissionSet',
+            flows: 'Flow',
+            documents: 'Document',
+            email: 'EmailTemplate',
+            staticresources: 'StaticResource',
+            labels: 'CustomLabels',
+            quickActions: 'QuickAction',
+            flexipages: 'FlexiPage',
+            aura: 'AuraDefinitionBundle',
+            lwc: 'LightningComponentBundle',
+            sites: 'DigitalExperience',
+            experiences: 'DigitalExperience',
+        };
+        return mappings[dirName] ?? null;
+    }
+    /**
+     * Extract component name from filename
+     */
+    extractComponentName(filename, metadataType) {
+        void metadataType;
+        // Remove extension
+        const withoutExt = filename.replace(/\.[^.]+$/, '');
+        // For some types, remove suffix (e.g., .cls, .trigger, .page)
+        return withoutExt;
+    }
+    /**
+     * Get error report
+     */
+    getErrorReport() {
+        return this.errorAggregator.formatReport();
+    }
+}
+//# sourceMappingURL=metadata-format-scanner.js.map

package/lib/scanner/metadata-format-scanner.js.map

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

package/lib/scanner/monorepo-scanner.d.ts

@@ -0,0 +1,71 @@
+/**
+ * Monorepo Scanner - US-082
+ * Support monorepo structures with multiple SF projects
+ *
+ * @ac US-082-AC-1: Detect multiple SFDX projects
+ * @ac US-082-AC-2: Scan each project independently
+ * @ac US-082-AC-3: Support shared dependencies
+ * @ac US-082-AC-4: Handle cross-project references
+ * @ac US-082-AC-5: Generate monorepo report
+ * @ac US-082-AC-6: Support workspace configuration
+ * @issue #82
+ */
+export type SfdxProject = {
+    name: string;
+    path: string;
+    sfdxProjectPath: string;
+    packageDirectories: string[];
+};
+export type MonorepoStructure = {
+    isMonorepo: boolean;
+    projects: SfdxProject[];
+    sharedDependencies: string[];
+    crossProjectRefs: Array<{
+        from: string;
+        to: string;
+        component: string;
+    }>;
+};
+export type MonorepoReport = {
+    structure: MonorepoStructure;
+    warnings: string[];
+    recommendations: string[];
+};
+/**
+ * @ac US-082-AC-1: Detect multiple SFDX projects
+ */
+export declare class MonorepoScanner {
+    /**
+     * @ac US-082-AC-1: Detect multiple SFDX projects
+     * Find all sfdx-project.json files in directory tree
+     */
+    detectProjects(rootDir: string, maxDepth?: number): Promise<SfdxProject[]>;
+    /**
+     * Recursively scan directory for sfdx-project.json
+     */
+    private scanDirectory;
+    /**
+     * @ac US-082-AC-3: Support shared dependencies
+     * Detect shared dependencies between projects
+     */
+    detectSharedDependencies(projects: SfdxProject[]): Promise<string[]>;
+    /**
+     * @ac US-082-AC-4: Handle cross-project references
+     * Detect cross-project references (simplified)
+     */
+    detectCrossProjectRefs(projects: SfdxProject[]): Array<{
+        from: string;
+        to: string;
+        component: string;
+    }>;
+    /**
+     * @ac US-082-AC-5: Generate monorepo report
+     * @ac US-082-AC-6: Support workspace configuration
+     * Scan monorepo and generate report
+     */
+    scanMonorepo(rootDir: string): Promise<MonorepoReport>;
+    /**
+     * Format monorepo report
+     */
+    formatReport(report: MonorepoReport): string;
+}

package/lib/scanner/monorepo-scanner.js

@@ -0,0 +1,225 @@
+/**
+ * Monorepo Scanner - US-082
+ * Support monorepo structures with multiple SF projects
+ *
+ * @ac US-082-AC-1: Detect multiple SFDX projects
+ * @ac US-082-AC-2: Scan each project independently
+ * @ac US-082-AC-3: Support shared dependencies
+ * @ac US-082-AC-4: Handle cross-project references
+ * @ac US-082-AC-5: Generate monorepo report
+ * @ac US-082-AC-6: Support workspace configuration
+ * @issue #82
+ */
+import { promises as fs } from 'node:fs';
+import * as path from 'node:path';
+import { getLogger } from '../utils/logger.js';
+const logger = getLogger('MonorepoScanner');
+/**
+ * @ac US-082-AC-1: Detect multiple SFDX projects
+ */
+export class MonorepoScanner {
+    /**
+     * @ac US-082-AC-1: Detect multiple SFDX projects
+     * Find all sfdx-project.json files in directory tree
+     */
+    async detectProjects(rootDir, maxDepth = 3) {
+        logger.info('Detecting SFDX projects', { rootDir, maxDepth });
+        const projects = [];
+        await this.scanDirectory(rootDir, 0, maxDepth, projects);
+        logger.info('Projects detected', { count: projects.length });
+        return projects;
+    }
+    /**
+     * Recursively scan directory for sfdx-project.json
+     */
+    async scanDirectory(dir, depth, maxDepth, projects) {
+        if (depth > maxDepth)
+            return;
+        try {
+            const entries = await fs.readdir(dir, { withFileTypes: true });
+            // Check for sfdx-project.json
+            const hasSfdxProject = entries.some((e) => e.name === 'sfdx-project.json');
+            if (hasSfdxProject) {
+                const sfdxProjectPath = path.join(dir, 'sfdx-project.json');
+                try {
+                    const content = await fs.readFile(sfdxProjectPath, 'utf-8');
+                    const config = JSON.parse(content);
+                    const packageDirs = config.packageDirectories ? config.packageDirectories.map((p) => p.path) : [];
+                    projects.push({
+                        name: config.name ?? path.basename(dir),
+                        path: dir,
+                        sfdxProjectPath,
+                        packageDirectories: packageDirs,
+                    });
+                }
+                catch (error) {
+                    logger.warn('Failed to parse sfdx-project.json', {
+                        path: sfdxProjectPath,
+                        error: error instanceof Error ? error.message : String(error),
+                    });
+                }
+            }
+            // Scan subdirectories (skip node_modules, .git, etc.)
+            const dirsToScan = entries.filter((e) => e.isDirectory() && !['node_modules', '.git', '.sfdx', 'dist', 'build', 'coverage'].includes(e.name));
+            await Promise.all(dirsToScan.map(async (entry) => this.scanDirectory(path.join(dir, entry.name), depth + 1, maxDepth, projects)));
+        }
+        catch (error) {
+            logger.warn('Failed to scan directory', {
+                dir,
+                error: error instanceof Error ? error.message : String(error),
+            });
+        }
+    }
+    /**
+     * @ac US-082-AC-3: Support shared dependencies
+     * Detect shared dependencies between projects
+     */
+    async detectSharedDependencies(projects) {
+        const sharedDeps = new Set();
+        await Promise.all(projects.map(async (project) => {
+            try {
+                const content = await fs.readFile(project.sfdxProjectPath, 'utf-8');
+                const config = JSON.parse(content);
+                if (config.plugins) {
+                    for (const plugin of Object.keys(config.plugins)) {
+                        sharedDeps.add(plugin);
+                    }
+                }
+                if (config.packageAliases) {
+                    for (const alias of Object.keys(config.packageAliases)) {
+                        sharedDeps.add(alias);
+                    }
+                }
+            }
+            catch {
+                // Skip errors
+            }
+        }));
+        return Array.from(sharedDeps);
+    }
+    /**
+     * @ac US-082-AC-4: Handle cross-project references
+     * Detect cross-project references (simplified)
+     */
+    detectCrossProjectRefs(projects) {
+        const refs = [];
+        // Simplified: Check if projects reference each other in config
+        for (const project of projects) {
+            for (const otherProject of projects) {
+                if (project !== otherProject) {
+                    // Check if project path is mentioned in other project's package dirs
+                    const isReferenced = otherProject.packageDirectories.some((dir) => dir.includes(path.basename(project.path)));
+                    if (isReferenced) {
+                        refs.push({ from: project.name, to: otherProject.name, component: 'package' });
+                    }
+                }
+            }
+        }
+        return refs;
+    }
+    /**
+     * @ac US-082-AC-5: Generate monorepo report
+     * @ac US-082-AC-6: Support workspace configuration
+     * Scan monorepo and generate report
+     */
+    async scanMonorepo(rootDir) {
+        logger.info('Scanning monorepo', { rootDir });
+        const projects = await this.detectProjects(rootDir);
+        const isMonorepo = projects.length > 1;
+        const sharedDependencies = await this.detectSharedDependencies(projects);
+        const crossProjectRefs = this.detectCrossProjectRefs(projects);
+        const warnings = [];
+        const recommendations = [];
+        // Generate warnings
+        if (isMonorepo && crossProjectRefs.length > 0) {
+            warnings.push(`Cross-project references detected: ${crossProjectRefs.length}`);
+            recommendations.push('Consider consolidating shared code into a shared package');
+        }
+        if (isMonorepo && projects.length > 10) {
+            warnings.push(`Many projects detected: ${projects.length}`);
+            recommendations.push('Consider organizing projects into workspaces');
+        }
+        // Check for workspace configuration
+        try {
+            const workspaceConfig = path.join(rootDir, 'workspace.json');
+            await fs.access(workspaceConfig);
+            logger.info('Workspace configuration found');
+        }
+        catch {
+            if (isMonorepo) {
+                recommendations.push('Consider adding workspace.json for better monorepo management');
+            }
+        }
+        const structure = {
+            isMonorepo,
+            projects,
+            sharedDependencies,
+            crossProjectRefs,
+        };
+        logger.info('Monorepo scan complete', {
+            isMonorepo,
+            projectCount: projects.length,
+            sharedDeps: sharedDependencies.length,
+            crossRefs: crossProjectRefs.length,
+        });
+        return {
+            structure,
+            warnings,
+            recommendations,
+        };
+    }
+    /**
+     * Format monorepo report
+     */
+    formatReport(report) {
+        const lines = [];
+        lines.push('📦 Monorepo Structure Report');
+        lines.push('═══════════════════════════════════════');
+        lines.push(`Is Monorepo: ${report.structure.isMonorepo ? 'Yes' : 'No'}`);
+        lines.push(`Projects: ${report.structure.projects.length}`);
+        lines.push('');
+        if (report.structure.projects.length > 0) {
+            lines.push('Projects:');
+            for (const project of report.structure.projects) {
+                lines.push(`  • ${project.name} (${project.path})`);
+                lines.push(`    Package Dirs: ${project.packageDirectories.length}`);
+            }
+            lines.push('');
+        }
+        if (report.structure.sharedDependencies.length > 0) {
+            lines.push(`Shared Dependencies: ${report.structure.sharedDependencies.length}`);
+            for (const dep of report.structure.sharedDependencies.slice(0, 5)) {
+                lines.push(`  • ${dep}`);
+            }
+            if (report.structure.sharedDependencies.length > 5) {
+                lines.push(`  ... and ${report.structure.sharedDependencies.length - 5} more`);
+            }
+            lines.push('');
+        }
+        if (report.structure.crossProjectRefs.length > 0) {
+            lines.push(`Cross-Project References: ${report.structure.crossProjectRefs.length}`);
+            for (const ref of report.structure.crossProjectRefs.slice(0, 3)) {
+                lines.push(`  • ${ref.from} → ${ref.to} (${ref.component})`);
+            }
+            if (report.structure.crossProjectRefs.length > 3) {
+                lines.push(`  ... and ${report.structure.crossProjectRefs.length - 3} more`);
+            }
+            lines.push('');
+        }
+        if (report.warnings.length > 0) {
+            lines.push('⚠️  Warnings:');
+            for (const warning of report.warnings) {
+                lines.push(`  • ${warning}`);
+            }
+            lines.push('');
+        }
+        if (report.recommendations.length > 0) {
+            lines.push('💡 Recommendations:');
+            for (const rec of report.recommendations) {
+                lines.push(`  • ${rec}`);
+            }
+        }
+        return lines.join('\n');
+    }
+}
+//# sourceMappingURL=monorepo-scanner.js.map

package/lib/scanner/monorepo-scanner.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"monorepo-scanner.js","sourceRoot":"","sources":["../../src/scanner/monorepo-scanner.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AAEH,OAAO,EAAE,QAAQ,IAAI,EAAE,EAAE,MAAM,SAAS,CAAC;AACzC,OAAO,KAAK,IAAI,MAAM,WAAW,CAAC;AAClC,OAAO,EAAE,SAAS,EAAE,MAAM,oBAAoB,CAAC;AAG/C,MAAM,MAAM,GAAG,SAAS,CAAC,iBAAiB,CAAC,CAAC;AAsB5C;;GAEG;AACH,MAAM,OAAO,eAAe;IAC1B;;;OAGG;IACI,KAAK,CAAC,cAAc,CAAC,OAAe,EAAE,QAAQ,GAAG,CAAC;QACvD,MAAM,CAAC,IAAI,CAAC,yBAAyB,EAAE,EAAE,OAAO,EAAE,QAAQ,EAAE,CAAC,CAAC;QAE9D,MAAM,QAAQ,GAAkB,EAAE,CAAC;QACnC,MAAM,IAAI,CAAC,aAAa,CAAC,OAAO,EAAE,CAAC,EAAE,QAAQ,EAAE,QAAQ,CAAC,CAAC;QAEzD,MAAM,CAAC,IAAI,CAAC,mBAAmB,EAAE,EAAE,KAAK,EAAE,QAAQ,CAAC,MAAM,EAAE,CAAC,CAAC;QAC7D,OAAO,QAAQ,CAAC;IAClB,CAAC;IAED;;OAEG;IACK,KAAK,CAAC,aAAa,CAAC,GAAW,EAAE,KAAa,EAAE,QAAgB,EAAE,QAAuB;QAC/F,IAAI,KAAK,GAAG,QAAQ;YAAE,OAAO;QAE7B,IAAI,CAAC;YACH,MAAM,OAAO,GAAG,MAAM,EAAE,CAAC,OAAO,CAAC,GAAG,EAAE,EAAE,aAAa,EAAE,IAAI,EAAE,CAAC,CAAC;YAE/D,8BAA8B;YAC9B,MAAM,cAAc,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,IAAI,KAAK,mBAAmB,CAAC,CAAC;YAE3E,IAAI,cAAc,EAAE,CAAC;gBACnB,MAAM,eAAe,GAAG,IAAI,CAAC,IAAI,CAAC,GAAG,EAAE,mBAAmB,CAAC,CAAC;gBAC5D,IAAI,CAAC;oBACH,MAAM,OAAO,GAAG,MAAM,EAAE,CAAC,QAAQ,CAAC,eAAe,EAAE,OAAO,CAAC,CAAC;oBAC5D,MAAM,MAAM,GAAG,IAAI,CAAC,KAAK,CAAC,OAAO,CAAwC,CAAC;oBAE1E,MAAM,WAAW,GAAG,MAAM,CAAC,kBAAkB,CAAC,CAAC,CAAC,MAAM,CAAC,kBAAkB,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC;oBAElG,QAAQ,CAAC,IAAI,CAAC;wBACZ,IAAI,EAAE,MAAM,CAAC,IAAI,IAAI,IAAI,CAAC,QAAQ,CAAC,GAAG,CAAC;wBACvC,IAAI,EAAE,GAAG;wBACT,eAAe;wBACf,kBAAkB,EAAE,WAAW;qBAChC,CAAC,CAAC;gBACL,CAAC;gBAAC,OAAO,KAAK,EAAE,CAAC;oBACf,MAAM,CAAC,IAAI,CAAC,mCAAmC,EAAE;wBAC/C,IAAI,EAAE,eAAe;wBACrB,KAAK,EAAE,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC;qBAC9D,CAAC,CAAC;gBACL,CAAC;YACH,CAAC;YAED,sDAAsD;YACtD,MAAM,UAAU,GAAG,OAAO,CAAC,MAAM,CAC/B,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,WAAW,EAAE,IAAI,CAAC,CAAC,cAAc,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,EAAE,OAAO,EAAE,UAAU,CAAC,CAAC,QAAQ,CAAC,CAAC,CAAC,IAAI,CAAC,CAC3G,CAAC;YAEF,MAAM,OAAO,CAAC,GAAG,CACf,UAAU,CAAC,GAAG,CAAC,KAAK,EAAE,KAAK,EAAE,EAAE,CAAC,IAAI,CAAC,aAAa,CAAC,IAAI,CAAC,IAAI,CAAC,GAAG,EAAE,KAAK,CAAC,IAAI,CAAC,EAAE,KAAK,GAAG,CAAC,EAAE,QAAQ,EAAE,QAAQ,CAAC,CAAC,CAC/G,CAAC;QACJ,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACf,MAAM,CAAC,IAAI,CAAC,0BAA0B,EAAE;gBACtC,GAAG;gBACH,KAAK,EAAE,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC;aAC9D,CAAC,CAAC;QACL,CAAC;IACH,CAAC;IAED;;;OAGG;IACI,KAAK,CAAC,wBAAwB,CAAC,QAAuB;QAC3D,MAAM,UAAU,GAAgB,IAAI,GAAG,EAAE,CAAC;QAE1C,MAAM,OAAO,CAAC,GAAG,CACf,QAAQ,CAAC,GAAG,CAAC,KAAK,EAAE,OAAO,EAAE,EAAE;YAC7B,IAAI,CAAC;gBACH,MAAM,OAAO,GAAG,MAAM,EAAE,CAAC,QAAQ,CAAC,OAAO,CAAC,eAAe,EAAE,OAAO,CAAC,CAAC;gBACpE,MAAM,MAAM,GAAG,IAAI,CAAC,KAAK,CAAC,OAAO,CAAmE,CAAC;gBAErG,IAAI,MAAM,CAAC,OAAO,EAAE,CAAC;oBACnB,KAAK,MAAM,MAAM,IAAI,MAAM,CAAC,IAAI,CAAC,MAAM,CAAC,OAAO,CAAC,EAAE,CAAC;wBACjD,UAAU,CAAC,GAAG,CAAC,MAAM,CAAC,CAAC;oBACzB,CAAC;gBACH,CAAC;gBAED,IAAI,MAAM,CAAC,cAAc,EAAE,CAAC;oBAC1B,KAAK,MAAM,KAAK,IAAI,MAAM,CAAC,IAAI,CAAC,MAAM,CAAC,cAAc,CAAC,EAAE,CAAC;wBACvD,UAAU,CAAC,GAAG,CAAC,KAAK,CAAC,CAAC;oBACxB,CAAC;gBACH,CAAC;YACH,CAAC;YAAC,MAAM,CAAC;gBACP,cAAc;YAChB,CAAC;QACH,CAAC,CAAC,CACH,CAAC;QAEF,OAAO,KAAK,CAAC,IAAI,CAAC,UAAU,CAAC,CAAC;IAChC,CAAC;IAED;;;OAGG;IACI,sBAAsB,CAAC,QAAuB;QACnD,MAAM,IAAI,GAA2D,EAAE,CAAC;QAExE,+DAA+D;QAC/D,KAAK,MAAM,OAAO,IAAI,QAAQ,EAAE,CAAC;YAC/B,KAAK,MAAM,YAAY,IAAI,QAAQ,EAAE,CAAC;gBACpC,IAAI,OAAO,KAAK,YAAY,EAAE,CAAC;oBAC7B,qEAAqE;oBACrE,MAAM,YAAY,GAAG,YAAY,CAAC,kBAAkB,CAAC,IAAI,CAAC,CAAC,GAAG,EAAE,EAAE,CAAC,GAAG,CAAC,QAAQ,CAAC,IAAI,CAAC,QAAQ,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;oBAE9G,IAAI,YAAY,EAAE,CAAC;wBACjB,IAAI,CAAC,IAAI,CAAC,EAAE,IAAI,EAAE,OAAO,CAAC,IAAI,EAAE,EAAE,EAAE,YAAY,CAAC,IAAI,EAAE,SAAS,EAAE,SAAS,EAAE,CAAC,CAAC;oBACjF,CAAC;gBACH,CAAC;YACH,CAAC;QACH,CAAC;QAED,OAAO,IAAI,CAAC;IACd,CAAC;IAED;;;;OAIG;IACI,KAAK,CAAC,YAAY,CAAC,OAAe;QACvC,MAAM,CAAC,IAAI,CAAC,mBAAmB,EAAE,EAAE,OAAO,EAAE,CAAC,CAAC;QAE9C,MAAM,QAAQ,GAAG,MAAM,IAAI,CAAC,cAAc,CAAC,OAAO,CAAC,CAAC;QACpD,MAAM,UAAU,GAAG,QAAQ,CAAC,MAAM,GAAG,CAAC,CAAC;QAEvC,MAAM,kBAAkB,GAAG,MAAM,IAAI,CAAC,wBAAwB,CAAC,QAAQ,CAAC,CAAC;QACzE,MAAM,gBAAgB,GAAG,IAAI,CAAC,sBAAsB,CAAC,QAAQ,CAAC,CAAC;QAE/D,MAAM,QAAQ,GAAa,EAAE,CAAC;QAC9B,MAAM,eAAe,GAAa,EAAE,CAAC;QAErC,oBAAoB;QACpB,IAAI,UAAU,IAAI,gBAAgB,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;YAC9C,QAAQ,CAAC,IAAI,CAAC,sCAAsC,gBAAgB,CAAC,MAAM,EAAE,CAAC,CAAC;YAC/E,eAAe,CAAC,IAAI,CAAC,0DAA0D,CAAC,CAAC;QACnF,CAAC;QAED,IAAI,UAAU,IAAI,QAAQ,CAAC,MAAM,GAAG,EAAE,EAAE,CAAC;YACvC,QAAQ,CAAC,IAAI,CAAC,2BAA2B,QAAQ,CAAC,MAAM,EAAE,CAAC,CAAC;YAC5D,eAAe,CAAC,IAAI,CAAC,8CAA8C,CAAC,CAAC;QACvE,CAAC;QAED,oCAAoC;QACpC,IAAI,CAAC;YACH,MAAM,eAAe,GAAG,IAAI,CAAC,IAAI,CAAC,OAAO,EAAE,gBAAgB,CAAC,CAAC;YAC7D,MAAM,EAAE,CAAC,MAAM,CAAC,eAAe,CAAC,CAAC;YACjC,MAAM,CAAC,IAAI,CAAC,+BAA+B,CAAC,CAAC;QAC/C,CAAC;QAAC,MAAM,CAAC;YACP,IAAI,UAAU,EAAE,CAAC;gBACf,eAAe,CAAC,IAAI,CAAC,+DAA+D,CAAC,CAAC;YACxF,CAAC;QACH,CAAC;QAED,MAAM,SAAS,GAAsB;YACnC,UAAU;YACV,QAAQ;YACR,kBAAkB;YAClB,gBAAgB;SACjB,CAAC;QAEF,MAAM,CAAC,IAAI,CAAC,wBAAwB,EAAE;YACpC,UAAU;YACV,YAAY,EAAE,QAAQ,CAAC,MAAM;YAC7B,UAAU,EAAE,kBAAkB,CAAC,MAAM;YACrC,SAAS,EAAE,gBAAgB,CAAC,MAAM;SACnC,CAAC,CAAC;QAEH,OAAO;YACL,SAAS;YACT,QAAQ;YACR,eAAe;SAChB,CAAC;IACJ,CAAC;IAED;;OAEG;IACI,YAAY,CAAC,MAAsB;QACxC,MAAM,KAAK,GAAa,EAAE,CAAC;QAE3B,KAAK,CAAC,IAAI,CAAC,8BAA8B,CAAC,CAAC;QAC3C,KAAK,CAAC,IAAI,CAAC,yCAAyC,CAAC,CAAC;QACtD,KAAK,CAAC,IAAI,CAAC,gBAAgB,MAAM,CAAC,SAAS,CAAC,UAAU,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,IAAI,EAAE,CAAC,CAAC;QACzE,KAAK,CAAC,IAAI,CAAC,aAAa,MAAM,CAAC,SAAS,CAAC,QAAQ,CAAC,MAAM,EAAE,CAAC,CAAC;QAC5D,KAAK,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;QAEf,IAAI,MAAM,CAAC,SAAS,CAAC,QAAQ,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;YACzC,KAAK,CAAC,IAAI,CAAC,WAAW,CAAC,CAAC;YACxB,KAAK,MAAM,OAAO,IAAI,MAAM,CAAC,SAAS,CAAC,QAAQ,EAAE,CAAC;gBAChD,KAAK,CAAC,IAAI,CAAC,OAAO,OAAO,CAAC,IAAI,KAAK,OAAO,CAAC,IAAI,GAAG,CAAC,CAAC;gBACpD,KAAK,CAAC,IAAI,CAAC,qBAAqB,OAAO,CAAC,kBAAkB,CAAC,MAAM,EAAE,CAAC,CAAC;YACvE,CAAC;YACD,KAAK,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;QACjB,CAAC;QAED,IAAI,MAAM,CAAC,SAAS,CAAC,kBAAkB,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;YACnD,KAAK,CAAC,IAAI,CAAC,wBAAwB,MAAM,CAAC,SAAS,CAAC,kBAAkB,CAAC,MAAM,EAAE,CAAC,CAAC;YACjF,KAAK,MAAM,GAAG,IAAI,MAAM,CAAC,SAAS,CAAC,kBAAkB,CAAC,KAAK,CAAC,CAAC,EAAE,CAAC,CAAC,EAAE,CAAC;gBAClE,KAAK,CAAC,IAAI,CAAC,OAAO,GAAG,EAAE,CAAC,CAAC;YAC3B,CAAC;YACD,IAAI,MAAM,CAAC,SAAS,CAAC,kBAAkB,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;gBACnD,KAAK,CAAC,IAAI,CAAC,aAAa,MAAM,CAAC,SAAS,CAAC,kBAAkB,CAAC,MAAM,GAAG,CAAC,OAAO,CAAC,CAAC;YACjF,CAAC;YACD,KAAK,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;QACjB,CAAC;QAED,IAAI,MAAM,CAAC,SAAS,CAAC,gBAAgB,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;YACjD,KAAK,CAAC,IAAI,CAAC,6BAA6B,MAAM,CAAC,SAAS,CAAC,gBAAgB,CAAC,MAAM,EAAE,CAAC,CAAC;YACpF,KAAK,MAAM,GAAG,IAAI,MAAM,CAAC,SAAS,CAAC,gBAAgB,CAAC,KAAK,CAAC,CAAC,EAAE,CAAC,CAAC,EAAE,CAAC;gBAChE,KAAK,CAAC,IAAI,CAAC,OAAO,GAAG,CAAC,IAAI,MAAM,GAAG,CAAC,EAAE,KAAK,GAAG,CAAC,SAAS,GAAG,CAAC,CAAC;YAC/D,CAAC;YACD,IAAI,MAAM,CAAC,SAAS,CAAC,gBAAgB,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;gBACjD,KAAK,CAAC,IAAI,CAAC,aAAa,MAAM,CAAC,SAAS,CAAC,gBAAgB,CAAC,MAAM,GAAG,CAAC,OAAO,CAAC,CAAC;YAC/E,CAAC;YACD,KAAK,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;QACjB,CAAC;QAED,IAAI,MAAM,CAAC,QAAQ,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;YAC/B,KAAK,CAAC,IAAI,CAAC,eAAe,CAAC,CAAC;YAC5B,KAAK,MAAM,OAAO,IAAI,MAAM,CAAC,QAAQ,EAAE,CAAC;gBACtC,KAAK,CAAC,IAAI,CAAC,OAAO,OAAO,EAAE,CAAC,CAAC;YAC/B,CAAC;YACD,KAAK,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;QACjB,CAAC;QAED,IAAI,MAAM,CAAC,eAAe,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;YACtC,KAAK,CAAC,IAAI,CAAC,qBAAqB,CAAC,CAAC;YAClC,KAAK,MAAM,GAAG,IAAI,MAAM,CAAC,eAAe,EAAE,CAAC;gBACzC,KAAK,CAAC,IAAI,CAAC,OAAO,GAAG,EAAE,CAAC,CAAC;YAC3B,CAAC;QACH,CAAC;QAED,OAAO,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;IAC1B,CAAC;CACF"}

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

@@ -0,0 +1,55 @@
+/**
+ * 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
+ */
+export type ValidationIssue = {
+    severity: 'error' | 'warning' | 'info';
+    message: string;
+    path?: string;
+    suggestion?: string;
+};
+export type ValidationReport = {
+    isValid: boolean;
+    issues: ValidationIssue[];
+    checkedItems: string[];
+    executionTime: number;
+};
+/**
+ * @ac US-084-AC-1: Validate sfdx-project.json schema
+ */
+export declare class ProjectValidator {
+    /**
+     * Validate project structure
+     */
+    validate(projectRoot: string): Promise<ValidationReport>;
+    /**
+     * @ac US-084-AC-1: Validate sfdx-project.json schema
+     */
+    private validateSfdxProjectJson;
+    /**
+     * @ac US-084-AC-2: Validate package directories exist
+     */
+    private validatePackageDirectories;
+    /**
+     * @ac US-084-AC-3: Validate metadata structure
+     */
+    private validateMetadataStructure;
+    /**
+     * @ac US-084-AC-4: Check for required files
+     */
+    private validateRequiredFiles;
+    /**
+     * @ac US-084-AC-5: Generate validation report
+     * @ac US-084-AC-6: Suggest fixes for issues
+     * Format validation report
+     */
+    formatReport(report: ValidationReport): string;
+}