@mcp-consultant-tools/powerplatform-core 26.0.0-beta.2

package/build/utils/best-practices-formatters.js

@@ -0,0 +1,238 @@
+/**
+ * Formatting utilities for best practices validation reports
+ * Transforms validation results into human-readable markdown reports
+ */
+/**
+ * Format complete best practices validation report as markdown
+ */
+export function formatBestPracticesReport(result) {
+    const sections = [];
+    // Header
+    sections.push('# Dataverse Best Practice Validation Report\n');
+    if (result.metadata.solutionName) {
+        sections.push(`**Solution**: ${result.metadata.solutionName} (\`${result.metadata.solutionUniqueName}\`)`);
+    }
+    else {
+        sections.push(`**Entities**: Custom entity validation`);
+    }
+    sections.push(`**Generated**: ${new Date(result.metadata.generatedAt).toLocaleString()}`);
+    sections.push(`**Publisher Prefix**: \`${result.metadata.publisherPrefix}\``);
+    sections.push(`**Time Filter**: Columns created in last ${result.metadata.recentDays} days`);
+    sections.push('');
+    sections.push('---\n');
+    // Summary
+    sections.push('## Summary\n');
+    sections.push('| Metric | Count |');
+    sections.push('|--------|-------|');
+    sections.push(`| Entities Checked | ${result.summary.entitiesChecked} |`);
+    sections.push(`| Attributes Checked | ${result.summary.attributesChecked} |`);
+    sections.push(`| **Total Violations** | **${result.summary.totalViolations}** |`);
+    sections.push(`| Critical (MUST) | ${result.summary.criticalViolations} |`);
+    sections.push(`| Warnings (SHOULD) | ${result.summary.warnings} |`);
+    sections.push(`| Compliant Entities | ${result.summary.compliantEntities} |`);
+    sections.push('');
+    if (result.summary.totalViolations > 0) {
+        sections.push('**Overall Status**: ⚠️ Issues Found\n');
+    }
+    else {
+        sections.push('**Overall Status**: ✅ All Compliant\n');
+    }
+    sections.push('---\n');
+    // Violations Summary - Complete Lists of Affected Items
+    if (result.summary.totalViolations > 0) {
+        sections.push('## 📋 Violations Summary (Complete Lists)\n');
+        sections.push('_This section provides complete lists of ALL affected tables and columns grouped by violation type._\n');
+        // Use pre-computed violations summary from the result
+        for (const ruleSummary of result.violationsSummary) {
+            const severityIcon = ruleSummary.severity === 'MUST' ? '🔴' : '⚠️';
+            sections.push(`### ${severityIcon} ${ruleSummary.rule} (${ruleSummary.severity})\n`);
+            sections.push(`**Affected Items**: ${ruleSummary.totalCount}\n`);
+            // Show affected tables (entity-level violations)
+            if (ruleSummary.affectedEntities.length > 0) {
+                sections.push(`**Affected Tables**:`);
+                const tableList = ruleSummary.affectedEntities.map((e) => `\`${e}\``).join(', ');
+                sections.push(tableList);
+                sections.push('');
+            }
+            // Show affected columns (column-level violations)
+            if (ruleSummary.affectedColumns.length > 0) {
+                sections.push(`**Affected Columns**:`);
+                const columnList = ruleSummary.affectedColumns.map((c) => `\`${c}\``).join(', ');
+                sections.push(columnList);
+                sections.push('');
+            }
+            // Add recommended action and recommendation
+            sections.push(`**Recommended Action**: ${ruleSummary.action}`);
+            if (ruleSummary.recommendation) {
+                sections.push(`**Why**: ${ruleSummary.recommendation}`);
+            }
+            sections.push('');
+        }
+        sections.push('---\n');
+    }
+    // Critical Violations (MUST Fix)
+    if (result.summary.criticalViolations > 0) {
+        sections.push('## 🔴 Critical Violations (MUST Fix)\n');
+        for (const entity of result.entities) {
+            const criticalViolations = entity.violations.filter((v) => v.severity === 'MUST');
+            if (criticalViolations.length > 0) {
+                sections.push(`### Entity: ${entity.displayName} (\`${entity.logicalName}\`)\n`);
+                for (const violation of criticalViolations) {
+                    if (violation.attributeLogicalName) {
+                        sections.push(`#### Column: ${violation.attributeLogicalName}${violation.createdOn ? ` (Created: ${new Date(violation.createdOn).toLocaleDateString()})` : ''}\n`);
+                    }
+                    else {
+                        sections.push(`#### Entity-Level Issue\n`);
+                    }
+                    sections.push(`- **Rule**: ${violation.rule}`);
+                    sections.push(`- **Issue**: ${violation.message}`);
+                    sections.push(`- **Current**: \`${violation.currentValue}\``);
+                    sections.push(`- **Expected**: \`${violation.expectedValue}\``);
+                    sections.push(`- **Action**: ${violation.action}`);
+                    if (violation.recommendation) {
+                        sections.push(`- **Recommendation**: ${violation.recommendation}`);
+                    }
+                    sections.push('');
+                }
+            }
+        }
+        sections.push('---\n');
+    }
+    // Warnings (SHOULD Fix)
+    if (result.summary.warnings > 0) {
+        sections.push('## ⚠️ Warnings (SHOULD Fix)\n');
+        for (const entity of result.entities) {
+            const warnings = entity.violations.filter((v) => v.severity === 'SHOULD');
+            if (warnings.length > 0) {
+                sections.push(`### Entity: ${entity.displayName} (\`${entity.logicalName}\`)\n`);
+                for (const violation of warnings) {
+                    if (violation.attributeLogicalName) {
+                        sections.push(`#### Column: ${violation.attributeLogicalName}${violation.createdOn ? ` (Created: ${new Date(violation.createdOn).toLocaleDateString()})` : ''}\n`);
+                    }
+                    else {
+                        sections.push(`#### Entity-Level Issue\n`);
+                    }
+                    sections.push(`- **Rule**: ${violation.rule}`);
+                    sections.push(`- **Issue**: ${violation.message}`);
+                    sections.push(`- **Current**: \`${violation.currentValue}\``);
+                    sections.push(`- **Expected**: \`${violation.expectedValue}\``);
+                    sections.push(`- **Recommendation**: ${violation.recommendation || violation.action}`);
+                    sections.push('');
+                }
+            }
+        }
+        sections.push('---\n');
+    }
+    // Compliant Entities
+    sections.push('## ✅ Compliant Entities\n');
+    const compliantEntities = result.entities.filter((e) => e.isCompliant);
+    if (compliantEntities.length > 0) {
+        sections.push('The following entities have no violations:\n');
+        for (const entity of compliantEntities) {
+            sections.push(`- **${entity.displayName}** (\`${entity.logicalName}\`) - ${entity.attributesChecked} columns checked${entity.isRefData ? ' (RefData table)' : ''}`);
+        }
+        sections.push('');
+    }
+    else {
+        sections.push('No fully compliant entities found.\n');
+    }
+    sections.push('---\n');
+    // Exclusions and Statistics
+    sections.push('## Exclusions\n');
+    sections.push(`- System columns excluded: ${result.statistics.systemColumnsExcluded}`);
+    sections.push(`- Columns older than ${result.metadata.recentDays} days: ${result.statistics.oldColumnsExcluded}`);
+    sections.push(`- RefData tables (updatedbyprocess check skipped): ${result.statistics.refDataTablesSkipped}`);
+    sections.push('');
+    sections.push('---\n');
+    // Footer
+    sections.push(`**Execution Time**: ${result.metadata.executionTimeMs}ms`);
+    return sections.join('\n');
+}
+/**
+ * Format violations grouped by severity
+ */
+export function formatViolationsBySeverity(violations) {
+    const sections = [];
+    const critical = violations.filter((v) => v.severity === 'MUST');
+    const warnings = violations.filter((v) => v.severity === 'SHOULD');
+    sections.push(`### Violations by Severity\n`);
+    sections.push(`- **Critical (MUST)**: ${critical.length}`);
+    sections.push(`- **Warnings (SHOULD)**: ${warnings.length}`);
+    sections.push(`- **Total**: ${violations.length}\n`);
+    if (critical.length > 0) {
+        sections.push('#### Critical Issues\n');
+        for (const violation of critical) {
+            sections.push(`- ${violation.rule}: ${violation.message}`);
+        }
+        sections.push('');
+    }
+    if (warnings.length > 0) {
+        sections.push('#### Warnings\n');
+        for (const violation of warnings) {
+            sections.push(`- ${violation.rule}: ${violation.message}`);
+        }
+        sections.push('');
+    }
+    return sections.join('\n');
+}
+/**
+ * Format compliant entities list
+ */
+export function formatCompliantEntities(entities) {
+    const sections = [];
+    const compliant = entities.filter((e) => e.isCompliant);
+    sections.push('### Compliant Entities\n');
+    if (compliant.length > 0) {
+        for (const entity of compliant) {
+            sections.push(`- **${entity.displayName}** (\`${entity.logicalName}\`)`);
+            sections.push(`  - Attributes checked: ${entity.attributesChecked}`);
+            sections.push(`  - Status: ✅ No violations`);
+            if (entity.isRefData) {
+                sections.push(`  - Type: RefData table`);
+            }
+            sections.push('');
+        }
+    }
+    else {
+        sections.push('No compliant entities found.');
+    }
+    return sections.join('\n');
+}
+/**
+ * Format execution statistics
+ */
+export function formatExecutionStats(result) {
+    const sections = [];
+    sections.push('### Execution Statistics\n');
+    sections.push('| Metric | Value |');
+    sections.push('|--------|-------|');
+    sections.push(`| Execution Time | ${result.metadata.executionTimeMs}ms |`);
+    sections.push(`| Entities Processed | ${result.summary.entitiesChecked} |`);
+    sections.push(`| Attributes Analyzed | ${result.summary.attributesChecked} |`);
+    sections.push(`| System Columns Excluded | ${result.statistics.systemColumnsExcluded} |`);
+    sections.push(`| Old Columns Excluded | ${result.statistics.oldColumnsExcluded} |`);
+    sections.push(`| RefData Tables | ${result.statistics.refDataTablesSkipped} |`);
+    sections.push('');
+    // Performance metrics
+    if (result.summary.entitiesChecked > 0) {
+        const avgTimePerEntity = Math.round(result.metadata.executionTimeMs / result.summary.entitiesChecked);
+        sections.push(`**Average time per entity**: ${avgTimePerEntity}ms`);
+    }
+    if (result.summary.attributesChecked > 0) {
+        const avgTimePerAttribute = Math.round(result.metadata.executionTimeMs / result.summary.attributesChecked);
+        sections.push(`**Average time per attribute**: ${avgTimePerAttribute}ms`);
+    }
+    return sections.join('\n');
+}
+/**
+ * Generate quick summary for CLI output
+ */
+export function formatQuickSummary(result) {
+    const lines = [];
+    lines.push(`Validation Complete: ${result.summary.entitiesChecked} entities checked`);
+    lines.push(`Total Violations: ${result.summary.totalViolations} (${result.summary.criticalViolations} critical, ${result.summary.warnings} warnings)`);
+    lines.push(`Compliant Entities: ${result.summary.compliantEntities}/${result.summary.entitiesChecked}`);
+    lines.push(`Execution Time: ${result.metadata.executionTimeMs}ms`);
+    return lines.join('\n');
+}
+//# sourceMappingURL=best-practices-formatters.js.map

package/build/utils/best-practices-formatters.js.map

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

package/build/utils/bestPractices.d.ts

@@ -0,0 +1,150 @@
+/**
+ * Best Practices Validation Module
+ *
+ * Hard-coded SmartImpact CRM best practices for entity and attribute customization.
+ * These rules are enforced during entity and attribute creation/update operations.
+ */
+export interface ValidationResult {
+    isValid: boolean;
+    issues: string[];
+    warnings: string[];
+    missingColumns?: RequiredColumn[];
+}
+export interface RequiredColumn {
+    schemaName: string;
+    displayName: string;
+    description: string;
+    type: string;
+    maxLength?: number;
+    format?: string;
+    behavior?: string;
+    [key: string]: unknown;
+}
+/**
+ * Hard-coded best practices rules for SmartImpact CRM customizations
+ */
+export declare const BEST_PRACTICES: {
+    publisher: {
+        prefix: string;
+        name: string;
+        optionValuePrefix: number;
+    };
+    entity: {
+        ownershipType: {
+            allowed: string[];
+            forbidden: string[];
+            default: string;
+        };
+        prefix: string;
+        refDataInfix: string;
+        caseRule: string;
+    };
+    attribute: {
+        lookupSuffix: string;
+        caseRule: string;
+        avoidBooleans: boolean;
+        dateTimeDefaultBehavior: string;
+    };
+    requiredColumns: {
+        allTables: {
+            schemaName: string;
+            displayName: string;
+            description: string;
+            type: string;
+            maxLength: number;
+        }[];
+        refDataTables: ({
+            schemaName: string;
+            displayName: string;
+            description: string;
+            type: string;
+            format: string;
+            behavior: string;
+            maxLength?: undefined;
+        } | {
+            schemaName: string;
+            displayName: string;
+            description: string;
+            type: string;
+            maxLength: number;
+            format?: undefined;
+            behavior?: undefined;
+        })[];
+    };
+    form: {
+        firstColumnMustBeName: boolean;
+        standardColumnOrder: string[];
+        colorPalette: {
+            amber: string;
+            green: string;
+            red: string;
+            grey: string;
+        };
+        timelineActivityLimit: number;
+    };
+    status: {
+        preferGlobalOptionSets: boolean;
+        avoidOOTBStateStatus: boolean;
+    };
+};
+/**
+ * Best Practices Validator Class
+ */
+export declare class BestPracticesValidator {
+    /**
+     * Validate entity naming conventions
+     */
+    validateEntityName(schemaName: string, isRefData: boolean): ValidationResult;
+    /**
+     * Validate attribute naming conventions
+     */
+    validateAttributeName(schemaName: string, isLookup: boolean): ValidationResult;
+    /**
+     * Validate entity ownership type
+     */
+    validateOwnershipType(ownershipType: string): ValidationResult;
+    /**
+     * Check if required columns are present
+     */
+    validateRequiredColumns(existingColumns: string[], isRefData: boolean): ValidationResult;
+    /**
+     * Validate boolean usage (discouraged)
+     */
+    validateBooleanUsage(attributeType: string, schemaName: string): ValidationResult;
+    /**
+     * Validate DateTime behavior
+     */
+    validateDateTimeBehavior(behavior: string | undefined): ValidationResult;
+    /**
+     * Get required columns for entity type
+     */
+    getRequiredColumns(isRefData: boolean): RequiredColumn[];
+    /**
+     * Validate option set value prefix
+     */
+    validateOptionSetValuePrefix(value: number): ValidationResult;
+    /**
+     * Generate next option set value with proper prefix
+     */
+    getNextOptionSetValue(existingValues: number[]): number;
+    /**
+     * Comprehensive entity validation
+     */
+    validateEntity(params: {
+        schemaName: string;
+        displayName: string;
+        ownershipType: string;
+        isRefData: boolean;
+        existingColumns?: string[];
+    }): ValidationResult;
+    /**
+     * Comprehensive attribute validation
+     */
+    validateAttribute(params: {
+        schemaName: string;
+        attributeType: string;
+        dateTimeBehavior?: string;
+    }): ValidationResult;
+}
+export declare const bestPracticesValidator: BestPracticesValidator;
+//# sourceMappingURL=bestPractices.d.ts.map

package/build/utils/bestPractices.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"bestPractices.d.ts","sourceRoot":"","sources":["../../src/utils/bestPractices.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,MAAM,WAAW,gBAAgB;IAC/B,OAAO,EAAE,OAAO,CAAC;IACjB,MAAM,EAAE,MAAM,EAAE,CAAC;IACjB,QAAQ,EAAE,MAAM,EAAE,CAAC;IACnB,cAAc,CAAC,EAAE,cAAc,EAAE,CAAC;CACnC;AAED,MAAM,WAAW,cAAc;IAC7B,UAAU,EAAE,MAAM,CAAC;IACnB,WAAW,EAAE,MAAM,CAAC;IACpB,WAAW,EAAE,MAAM,CAAC;IACpB,IAAI,EAAE,MAAM,CAAC;IACb,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC;CACxB;AAED;;GAEG;AACH,eAAO,MAAM,cAAc;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CA6F1B,CAAC;AAEF;;GAEG;AACH,qBAAa,sBAAsB;IACjC;;OAEG;IACH,kBAAkB,CAAC,UAAU,EAAE,MAAM,EAAE,SAAS,EAAE,OAAO,GAAG,gBAAgB;IA8B5E;;OAEG;IACH,qBAAqB,CAAC,UAAU,EAAE,MAAM,EAAE,QAAQ,EAAE,OAAO,GAAG,gBAAgB;IA4B9E;;OAEG;IACH,qBAAqB,CAAC,aAAa,EAAE,MAAM,GAAG,gBAAgB;IAuB9D;;OAEG;IACH,uBAAuB,CAAC,eAAe,EAAE,MAAM,EAAE,EAAE,SAAS,EAAE,OAAO,GAAG,gBAAgB;IA+BxF;;OAEG;IACH,oBAAoB,CAAC,aAAa,EAAE,MAAM,EAAE,UAAU,EAAE,MAAM,GAAG,gBAAgB;IAkBjF;;OAEG;IACH,wBAAwB,CAAC,QAAQ,EAAE,MAAM,GAAG,SAAS,GAAG,gBAAgB;IAmBxE;;OAEG;IACH,kBAAkB,CAAC,SAAS,EAAE,OAAO,GAAG,cAAc,EAAE;IAQxD;;OAEG;IACH,4BAA4B,CAAC,KAAK,EAAE,MAAM,GAAG,gBAAgB;IAsB7D;;OAEG;IACH,qBAAqB,CAAC,cAAc,EAAE,MAAM,EAAE,GAAG,MAAM;IAevD;;OAEG;IACH,cAAc,CAAC,MAAM,EAAE;QACrB,UAAU,EAAE,MAAM,CAAC;QACnB,WAAW,EAAE,MAAM,CAAC;QACpB,aAAa,EAAE,MAAM,CAAC;QACtB,SAAS,EAAE,OAAO,CAAC;QACnB,eAAe,CAAC,EAAE,MAAM,EAAE,CAAC;KAC5B,GAAG,gBAAgB;IA4BpB;;OAEG;IACH,iBAAiB,CAAC,MAAM,EAAE;QACxB,UAAU,EAAE,MAAM,CAAC;QACnB,aAAa,EAAE,MAAM,CAAC;QACtB,gBAAgB,CAAC,EAAE,MAAM,CAAC;KAC3B,GAAG,gBAAgB;CAuBrB;AAGD,eAAO,MAAM,sBAAsB,wBAA+B,CAAC"}