@mcp-consultant-tools/powerplatform 27.0.0 → 28.0.0-beta.13

package/build/tools/solution-tools.js

@@ -0,0 +1,284 @@
+/**
+ * Solution Tools - 8 tools for solution management and validation
+ */
+import { z } from 'zod';
+import { descWithExamples, SOLUTION_NAME_EXAMPLES, ENTITY_NAME_EXAMPLES, COMPONENT_TYPE_EXAMPLES } from '../tool-examples.js';
+export function registerSolutionTools(server, ctx) {
+    server.tool("get-publishers", "Get all solution publishers (excluding system publishers)", {}, async () => {
+        try {
+            const service = ctx.pp;
+            const result = await service.getPublishers();
+            const publishers = result.value || [];
+            return {
+                content: [
+                    {
+                        type: "text",
+                        text: `Found ${publishers.length} publisher(s):\n\n` +
+                            publishers.map((p) => `- ${p.friendlyname} (${p.uniquename})\n  Prefix: ${p.customizationprefix}\n  ID: ${p.publisherid}`).join('\n')
+                    }
+                ]
+            };
+        }
+        catch (error) {
+            console.error("Error getting publishers:", error);
+            return {
+                content: [{ type: "text", text: `Failed to get publishers: ${error.message}` }],
+                isError: true
+            };
+        }
+    });
+    server.tool("get-solutions", "Get all visible solutions in the environment", {}, async () => {
+        try {
+            const service = ctx.pp;
+            const result = await service.getSolutions();
+            const solutions = result.value || [];
+            return {
+                content: [
+                    {
+                        type: "text",
+                        text: `Found ${solutions.length} solution(s):\n\n` +
+                            solutions.map((s) => `- ${s.friendlyname} (${s.uniquename})\n  Version: ${s.version}\n  ID: ${s.solutionid}`).join('\n')
+                    }
+                ]
+            };
+        }
+        catch (error) {
+            console.error("Error getting solutions:", error);
+            return {
+                content: [{ type: "text", text: `Failed to get solutions: ${error.message}` }],
+                isError: true
+            };
+        }
+    });
+    server.tool("get-solution-components", "List all components in a solution, grouped by component type. Returns component IDs, types, and behavior settings.", {
+        solutionUniqueName: z.string().describe(descWithExamples("The unique name of the solution to list components for", SOLUTION_NAME_EXAMPLES)),
+    }, async ({ solutionUniqueName }) => {
+        try {
+            const service = ctx.pp;
+            const result = await service.getSolutionComponents(solutionUniqueName);
+            const components = result.value || [];
+            const componentTypeNames = {
+                1: 'Entity', 2: 'Attribute', 3: 'Relationship', 9: 'OptionSet',
+                10: 'EntityRelationship', 13: 'ManagedProperty', 20: 'Policy',
+                24: 'Privilege', 25: 'PrivilegeObjectTypeCode', 26: 'Role',
+                29: 'Workflow', 31: 'Report', 36: 'Template', 37: 'Contract Template',
+                38: 'Article Template', 39: 'Mail Merge Template', 44: 'Duplicate Rule',
+                46: 'Duplicate Rule Condition', 48: 'Entity Map', 49: 'Attribute Map',
+                59: 'SavedQuery', 60: 'Form', 61: 'WebResource', 62: 'SiteMap',
+                63: 'Connection Role', 65: 'Hierarchy Rule', 66: 'Custom Control',
+                70: 'FieldSecurityProfile', 71: 'FieldPermission', 80: 'AppModule',
+                91: 'PluginAssembly', 92: 'PluginType', 93: 'SDKMessageProcessingStep',
+                95: 'ServiceEndpoint', 150: 'RoutingRule', 152: 'SLA',
+                154: 'ConvertRule', 300: 'Canvas App', 371: 'Connector',
+                372: 'EnvironmentVariableDefinition', 373: 'EnvironmentVariableValue',
+                380: 'AIModel', 381: 'AIConfiguration',
+            };
+            const grouped = {};
+            for (const c of components) {
+                const type = c.componenttype;
+                if (!grouped[type])
+                    grouped[type] = [];
+                grouped[type].push(c);
+            }
+            const lines = [`Found ${components.length} component(s) in solution '${solutionUniqueName}':\n`];
+            for (const [type, items] of Object.entries(grouped)) {
+                const typeName = componentTypeNames[Number(type)] || `Type ${type}`;
+                lines.push(`\n${typeName} (${items.length}):`);
+                for (const item of items) {
+                    lines.push(`  - ${item.objectid} (behavior: ${item.rootcomponentbehavior ?? 'include subcomponents'})`);
+                }
+            }
+            return {
+                content: [{ type: "text", text: lines.join('\n') }]
+            };
+        }
+        catch (error) {
+            console.error("Error getting solution components:", error);
+            return {
+                content: [{ type: "text", text: `Failed to get solution components: ${error.message}` }],
+                isError: true
+            };
+        }
+    });
+    server.tool("check-dependencies", "Check dependencies before deleting a component", {
+        componentId: z.string().describe("Component ID (GUID or MetadataId)"),
+        componentType: z.number().describe(descWithExamples("Component type code", COMPONENT_TYPE_EXAMPLES))
+    }, async ({ componentId, componentType }) => {
+        try {
+            const service = ctx.pp;
+            const result = await service.checkDependencies(componentId, componentType);
+            const dependencies = result.EntityCollection?.Entities || [];
+            return {
+                content: [
+                    {
+                        type: "text",
+                        text: `Found ${dependencies.length} dependenc${dependencies.length === 1 ? 'y' : 'ies'} for component '${componentId}':\n\n` +
+                            (dependencies.length > 0
+                                ? dependencies.map((d) => `- ${d.Attributes?.dependentcomponentobjectid || 'Unknown'}\n  Type: ${d.Attributes?.dependentcomponenttype || 'Unknown'}`).join('\n')
+                                : 'No dependencies found - component can be safely deleted')
+                    }
+                ]
+            };
+        }
+        catch (error) {
+            console.error("Error checking dependencies:", error);
+            return {
+                content: [{ type: "text", text: `Failed to check dependencies: ${error.message}` }],
+                isError: true
+            };
+        }
+    });
+    server.tool("validate-schema-name", "Validate a schema name against PowerPlatform naming rules", {
+        schemaName: z.string().describe("Schema name to validate"),
+        prefix: z.string().describe("Required customization prefix")
+    }, async ({ schemaName, prefix }) => {
+        try {
+            const service = ctx.pp;
+            const result = service.validateSchemaName(schemaName, prefix);
+            return {
+                content: [
+                    {
+                        type: "text",
+                        text: `Schema Name Validation for '${schemaName}':\n\n` +
+                            `Valid: ${result.valid ? '✅' : '❌'}\n\n` +
+                            (result.errors.length > 0
+                                ? `Errors:\n${result.errors.map(e => `- ${e}`).join('\n')}`
+                                : 'No validation errors')
+                    }
+                ]
+            };
+        }
+        catch (error) {
+            console.error("Error validating schema name:", error);
+            return {
+                content: [{ type: "text", text: `Failed to validate schema name: ${error.message}` }],
+                isError: true
+            };
+        }
+    });
+    server.tool("check-delete-eligibility", "Check if a component can be safely deleted by verifying it has no blocking dependencies.", {
+        componentId: z.string().describe("Component ID (GUID or MetadataId)"),
+        componentType: z.number().describe(descWithExamples("Component type code", COMPONENT_TYPE_EXAMPLES))
+    }, async ({ componentId, componentType }) => {
+        try {
+            const service = ctx.pp;
+            const result = await service.checkDeleteEligibility(componentId, componentType);
+            return {
+                content: [
+                    {
+                        type: "text",
+                        text: `Delete Eligibility for component '${componentId}':\n\n` +
+                            `Can Delete: ${result.canDelete ? '✅ Yes' : '❌ No'}\n` +
+                            `Dependencies: ${result.dependencies.length}\n\n` +
+                            (result.dependencies.length > 0
+                                ? `Blocking Dependencies:\n${result.dependencies.map((d) => `- ${d.Attributes?.dependentcomponentobjectid || 'Unknown'}`).join('\n')}`
+                                : 'No blocking dependencies - component can be safely deleted')
+                    }
+                ]
+            };
+        }
+        catch (error) {
+            console.error("Error checking delete eligibility:", error);
+            return {
+                content: [{ type: "text", text: `Failed to check delete eligibility: ${error.message}` }],
+                isError: true
+            };
+        }
+    });
+    server.tool("validate-dataverse", "Validate Dataverse entities against internal best practices for column naming, prefixes, configuration, and entity icons. Checks schema name casing, lookup naming conventions, option set scope (all must be global), required columns, publisher prefix compliance, and entity icon assignment. Supports solution-based validation or explicit entity list with configurable time range filtering.", {
+        solutionUniqueName: z.string().optional().describe(descWithExamples("Solution unique name to validate. Mutually exclusive with entityLogicalNames", SOLUTION_NAME_EXAMPLES)),
+        entityLogicalNames: z.array(z.string()).optional().describe(descWithExamples("Explicit list of entity logical names to validate. Mutually exclusive with solutionUniqueName", ENTITY_NAME_EXAMPLES)),
+        publisherPrefix: z.string().describe("Publisher prefix to validate against (e.g., 'sic_'). Required."),
+        recentDays: z.number().optional().describe("Only validate columns created in the last N days. Set to 0 to validate all columns regardless of age. Default: 30."),
+        includeRefDataTables: z.boolean().optional().describe("Include RefData tables (schema starts with prefix + 'ref_') in validation. Default: true."),
+        rules: z.array(z.string()).optional().describe("Specific rules to validate: 'prefix', 'lowercase', 'lookup', 'optionset', 'required-column', 'entity-icon'. Default: all rules."),
+        maxEntities: z.number().optional().describe("Maximum number of entities to validate (safety limit). Default: 0 (unlimited)."),
+        requiredColumns: z.array(z.string()).optional().describe("List of required column schema names to check for (without prefix). Use '{prefix}' placeholder which will be replaced with publisherPrefix at runtime. Default: ['{prefix}updatedbyprocess']. Example: ['{prefix}sqlcreatedon', '{prefix}sqlmodifiedon'] for SQL timestamp columns.")
+    }, async ({ solutionUniqueName, entityLogicalNames, publisherPrefix, recentDays, includeRefDataTables, rules, maxEntities, requiredColumns }) => {
+        try {
+            if (!solutionUniqueName && !entityLogicalNames) {
+                return {
+                    content: [{ type: "text", text: "Error: Either solutionUniqueName or entityLogicalNames must be provided" }],
+                    isError: true
+                };
+            }
+            if (solutionUniqueName && entityLogicalNames) {
+                return {
+                    content: [{ type: "text", text: "Error: solutionUniqueName and entityLogicalNames are mutually exclusive" }],
+                    isError: true
+                };
+            }
+            const service = ctx.pp;
+            const result = await service.validateBestPractices(solutionUniqueName, entityLogicalNames, publisherPrefix, recentDays ?? 30, includeRefDataTables ?? true, rules ?? ['prefix', 'lowercase', 'lookup', 'optionset', 'required-column', 'entity-icon'], maxEntities ?? 0, requiredColumns ?? ['{prefix}updatedbyprocess']);
+            return {
+                content: [{ type: "text", text: JSON.stringify(result, null, 2) }]
+            };
+        }
+        catch (error) {
+            console.error("Error validating best practices:", error);
+            return {
+                content: [{ type: "text", text: `Failed to validate best practices: ${error.message}` }],
+                isError: true
+            };
+        }
+    });
+    server.tool("generate-dbml-schema", `Generates DBML (Database Markup Language) schema from Dataverse entities.
+
+Accepts solution names, explicit entity lists, or both. Returns DBML text
+and a clickable dbdiagram.io URL for visualization.
+
+DBML output includes:
+- Table definitions with columns and types
+- Primary key markers [pk]
+- Foreign key relationships (Ref: statements) for all lookups
+
+Example output:
+\`\`\`dbml
+Table si_directdebit {
+    si_directdebitid uniqueidentifier [pk]
+    si_name nvarchar
+    si_accountid lookup
+}
+Ref: si_directdebit.si_accountid > account.accountid
+\`\`\``, {
+        solutions: z.array(z.string()).optional()
+            .describe('One or more solution unique names to extract entities from'),
+        entities: z.array(z.string()).optional()
+            .describe('Explicit list of entity logical names to include'),
+        includeSystemColumns: z.boolean().optional()
+            .describe('Include system columns like createdon, modifiedon (default: false)'),
+        includeStateStatus: z.boolean().optional()
+            .describe('Include statecode/statuscode columns (default: false)'),
+        prefix: z.string().optional()
+            .describe('Only include columns matching this prefix (e.g., "si_")'),
+        depth: z.number().optional()
+            .describe('Relationship traversal depth for discovering related entities (default: 0)'),
+        includePolymorphicLookups: z.boolean().optional()
+            .describe('Include Customer/Owner/PartyList lookups (default: true)'),
+    }, async (params) => {
+        try {
+            const service = ctx.pp;
+            const result = await service.generateDbmlSchema(params);
+            return {
+                content: [
+                    {
+                        type: "text",
+                        text: JSON.stringify(result, null, 2),
+                    },
+                ],
+            };
+        }
+        catch (error) {
+            console.error("Error generating DBML schema:", error);
+            return {
+                content: [
+                    {
+                        type: "text",
+                        text: `Failed to generate DBML schema: ${error.message}`,
+                    },
+                ],
+            };
+        }
+    });
+}
+//# sourceMappingURL=solution-tools.js.map

package/build/tools/solution-tools.js.map

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

package/build/types.d.ts

@@ -0,0 +1,9 @@
+/**
+ * Service context shared between MCP server and tool/prompt registrations.
+ * Uses a lazy getter to initialize the PowerPlatformService on-demand.
+ */
+import type { PowerPlatformService } from './PowerPlatformService.js';
+export interface ServiceContext {
+    readonly pp: PowerPlatformService;
+}
+//# sourceMappingURL=types.d.ts.map

package/build/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":"AAAA;;;GAGG;AACH,OAAO,KAAK,EAAE,oBAAoB,EAAE,MAAM,2BAA2B,CAAC;AAEtE,MAAM,WAAW,cAAc;IAC7B,QAAQ,CAAC,EAAE,EAAE,oBAAoB,CAAC;CACnC"}

package/build/types.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=types.js.map

package/build/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":""}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@mcp-consultant-tools/powerplatform",
-  "version": "27.0.0",
+  "version": "28.0.0-beta.13",
   "description": "MCP server for Microsoft PowerPlatform/Dataverse - read-only access (production-safe)",
   "type": "module",
   "main": "./build/index.js",
@@ -44,9 +44,10 @@
     "node": ">=16.0.0"
   },
   "dependencies": {
-    "@mcp-consultant-tools/core": "27.0.0-beta.1",
-    "@mcp-consultant-tools/powerplatform-core": "27.0.0-beta.2",
+    "@mcp-consultant-tools/core": "28.0.0-beta.13",
+    "@mcp-consultant-tools/powerplatform-core": "28.0.0-beta.13",
     "@modelcontextprotocol/sdk": "^1.24.3",
+    "commander": "^14.0.3",
     "express": "^4.21.0",
     "zod": "^3.24.1"
   },
@@ -59,6 +60,7 @@
     "mcp-consultant-tools-powerplatform": "build/index.js",
     "powerplatform": "build/index.js",
     "mcp-pp": "build/index.js",
-    "mcp-pp-http": "build/http-server.js"
+    "mcp-pp-http": "build/http-server.js",
+    "mcp-pp-cli": "build/cli.js"
   }
 }