@redhat-cloud-services/hcc-feo-mcp 0.0.1

package/dist/lib/tools/getFEOMigrationTemplate.js

@@ -0,0 +1,134 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.getFEOMigrationTemplateTool = getFEOMigrationTemplateTool;
+const types_js_1 = require("@modelcontextprotocol/sdk/types.js");
+const schemaCache_js_1 = require("../utils/schemaCache.js");
+const templateGenerators_js_1 = require("../utils/templateGenerators.js");
+const recommendations_js_1 = require("../utils/recommendations.js");
+const contentProviders_js_1 = require("../utils/contentProviders.js");
+function getFEOMigrationTemplateTool() {
+    async function tool(args) {
+        try {
+            const { appName, bundle, migrationType, displayTitle } = args;
+            if (!appName || !bundle || !migrationType) {
+                throw new types_js_1.McpError(types_js_1.ErrorCode.InvalidParams, 'Missing required parameters: appName, bundle, and migrationType are required');
+            }
+            const title = displayTitle || appName.split('-').map((word) => word.charAt(0).toUpperCase() + word.slice(1)).join(' ');
+            // Ensure schema is loaded for smart generation
+            await (0, schemaCache_js_1.ensureSchemaLoaded)();
+            let template = '';
+            switch (migrationType) {
+                case 'module':
+                    template = (0, templateGenerators_js_1.generateSmartTemplate)('module', {
+                        appName, bundle, title,
+                        manifestLocation: `/apps/${appName}/fed-mods.json`,
+                        documentTitle: `${title} | Red Hat Hybrid Cloud Console`,
+                        routes: [{ pathname: `/${bundle}/${appName}`, props: { bundle } }]
+                    });
+                    break;
+                case 'navigation':
+                    template = (0, templateGenerators_js_1.generateSmartTemplate)('navigation', {
+                        appName, bundle, title,
+                        position: (0, recommendations_js_1.getRecommendedPosition)(bundle),
+                        productName: (0, recommendations_js_1.getProductName)(bundle)
+                    });
+                    break;
+                case 'service-tiles':
+                    const serviceSection = (0, recommendations_js_1.getRecommendedServiceSection)(bundle);
+                    template = (0, templateGenerators_js_1.generateSmartTemplate)('serviceTiles', {
+                        appName, bundle, title,
+                        section: serviceSection.section,
+                        group: serviceSection.group,
+                        icon: (0, recommendations_js_1.getRecommendedIcon)(bundle)
+                    });
+                    break;
+                case 'search':
+                    template = (0, templateGenerators_js_1.generateSmartTemplate)('searchEntries', {
+                        appName, bundle, title
+                    });
+                    break;
+                case 'full':
+                    const fullServiceSection = (0, recommendations_js_1.getRecommendedServiceSection)(bundle);
+                    template = (0, templateGenerators_js_1.generateSmartTemplate)('full', {
+                        appName, bundle, title,
+                        position: (0, recommendations_js_1.getRecommendedPosition)(bundle),
+                        section: fullServiceSection.section,
+                        group: fullServiceSection.group,
+                        icon: (0, recommendations_js_1.getRecommendedIcon)(bundle),
+                        productName: (0, recommendations_js_1.getProductName)(bundle),
+                        manifestLocation: `/apps/${appName}/fed-mods.json`,
+                        documentTitle: `${title} | Red Hat Hybrid Cloud Console`,
+                        routes: [{ pathname: `/${bundle}/${appName}`, props: { bundle } }]
+                    });
+                    break;
+                default:
+                    throw new types_js_1.McpError(types_js_1.ErrorCode.InvalidParams, `Unknown migration type: ${migrationType}. Valid types are: module, navigation, service-tiles, search, full`);
+            }
+            return {
+                content: [
+                    {
+                        type: 'text',
+                        text: `# FEO Migration Template: ${migrationType}
+
+App: **${appName}** → **${title}**
+Bundle: **${bundle}**
+
+## Configuration to Add/Update
+
+\`\`\`yaml
+${template}
+\`\`\`
+
+## Migration Steps
+
+${(0, contentProviders_js_1.getMigrationSteps)(migrationType)}
+
+## Validation
+
+After applying this configuration:
+1. Run \`npm run build\` to validate
+2. Check for schema validation errors
+3. Test in development environment
+4. Mark corresponding items for replacement in chrome-service-backend`,
+                    },
+                ],
+            };
+        }
+        catch (error) {
+            if (error instanceof types_js_1.McpError) {
+                throw error;
+            }
+            throw new types_js_1.McpError(types_js_1.ErrorCode.InternalError, `Error generating migration template: ${error instanceof Error ? error.message : String(error)}`);
+        }
+    }
+    return [
+        'getFEOMigrationTemplate',
+        {
+            description: 'Generate customized migration template for converting existing app to FEO',
+            inputSchema: {
+                type: 'object',
+                properties: {
+                    appName: {
+                        type: 'string',
+                        description: 'Application name in kebab-case (e.g., "learning-resources")',
+                    },
+                    bundle: {
+                        type: 'string',
+                        description: 'Target bundle (insights, openshift, ansible, settings, etc.)',
+                    },
+                    migrationType: {
+                        type: 'string',
+                        enum: ['navigation', 'service-tiles', 'search', 'module', 'full'],
+                        description: 'Type of migration to generate template for',
+                    },
+                    displayTitle: {
+                        type: 'string',
+                        description: 'Human-readable application title (optional)',
+                    },
+                },
+                required: ['appName', 'bundle', 'migrationType'],
+            },
+        },
+        tool
+    ];
+}

package/dist/lib/tools/getFEONavigationPositioning.d.ts

@@ -0,0 +1,3 @@
+import { McpTool } from '../types.js';
+export declare function getFEONavigationPositioningTool(): McpTool;
+//# sourceMappingURL=getFEONavigationPositioning.d.ts.map

package/dist/lib/tools/getFEONavigationPositioning.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"getFEONavigationPositioning.d.ts","sourceRoot":"","sources":["../../../src/lib/tools/getFEONavigationPositioning.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,OAAO,EAAE,MAAM,aAAa,CAAC;AAGtC,wBAAgB,+BAA+B,IAAI,OAAO,CAyCzD"}

package/dist/lib/tools/getFEONavigationPositioning.js

@@ -0,0 +1,43 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.getFEONavigationPositioningTool = getFEONavigationPositioningTool;
+const types_js_1 = require("@modelcontextprotocol/sdk/types.js");
+const contentProviders_js_1 = require("../utils/contentProviders.js");
+function getFEONavigationPositioningTool() {
+    async function tool(args) {
+        try {
+            const bundle = args?.bundle;
+            const guidance = (0, contentProviders_js_1.getNavigationPositioningGuidance)(bundle);
+            return {
+                content: [
+                    {
+                        type: 'text',
+                        text: `# Navigation Positioning Guidance${bundle ? ` for ${bundle}` : ''}
+
+${guidance}`,
+                    },
+                ],
+            };
+        }
+        catch (error) {
+            throw new types_js_1.McpError(types_js_1.ErrorCode.InternalError, `Error getting navigation positioning: ${error instanceof Error ? error.message : String(error)}`);
+        }
+    }
+    return [
+        'getFEONavigationPositioning',
+        {
+            description: 'Get guidance on navigation positioning and bundle segment organization',
+            inputSchema: {
+                type: 'object',
+                properties: {
+                    bundle: {
+                        type: 'string',
+                        description: 'Bundle to get positioning guidance for (optional)',
+                    },
+                },
+                additionalProperties: false,
+            },
+        },
+        tool
+    ];
+}

package/dist/lib/tools/getFEOSchema.d.ts

@@ -0,0 +1,3 @@
+import { McpTool } from '../types.js';
+export declare function getFEOSchemaTool(): McpTool;
+//# sourceMappingURL=getFEOSchema.d.ts.map

package/dist/lib/tools/getFEOSchema.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"getFEOSchema.d.ts","sourceRoot":"","sources":["../../../src/lib/tools/getFEOSchema.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,OAAO,EAAE,MAAM,aAAa,CAAC;AAGtC,wBAAgB,gBAAgB,IAAI,OAAO,CAqD1C"}

package/dist/lib/tools/getFEOSchema.js

@@ -0,0 +1,54 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.getFEOSchemaTool = getFEOSchemaTool;
+const types_js_1 = require("@modelcontextprotocol/sdk/types.js");
+const schemaCache_js_1 = require("../utils/schemaCache.js");
+function getFEOSchemaTool() {
+    async function tool(args) {
+        try {
+            const now = Date.now();
+            await (0, schemaCache_js_1.ensureSchemaLoaded)();
+            const schema = schemaCache_js_1.schemaCache.schema;
+            const cacheAge = Math.floor((now - schemaCache_js_1.schemaCache.timestamp) / 1000 / 60); // minutes
+            return {
+                content: [
+                    {
+                        type: 'text',
+                        text: `# Frontend Operator CRD Schema
+
+Latest schema from: ${schemaCache_js_1.FEO_SCHEMA_URL}
+Cache age: ${cacheAge} minutes (refreshes hourly)
+
+## Schema Structure
+- **Version**: ${schema.$schema || 'JSON Schema Draft 2020-12'}
+- **Title**: ${schema.title}
+- **Root Type**: ${schema.type}
+
+## Key Definitions
+${Object.keys(schema.$defs || {}).map((key) => `- **${key}**: ${schema.$defs[key].description || 'No description'}`).join('\n')}
+
+## Full Schema
+\`\`\`json
+${JSON.stringify(schema, null, 2)}
+\`\`\``,
+                    },
+                ],
+            };
+        }
+        catch (error) {
+            throw new types_js_1.McpError(types_js_1.ErrorCode.InternalError, `Error fetching FEO schema: ${error instanceof Error ? error.message : String(error)}`);
+        }
+    }
+    return [
+        'getFEOSchema',
+        {
+            description: 'Get the latest Frontend Operator CRD schema for validation and reference',
+            inputSchema: {
+                type: 'object',
+                properties: {},
+                additionalProperties: false,
+            },
+        },
+        tool
+    ];
+}

package/dist/lib/tools/getFEOServiceTilesSections.d.ts

@@ -0,0 +1,3 @@
+import { McpTool } from '../types.js';
+export declare function getFEOServiceTilesSectionsTool(): McpTool;
+//# sourceMappingURL=getFEOServiceTilesSections.d.ts.map

package/dist/lib/tools/getFEOServiceTilesSections.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"getFEOServiceTilesSections.d.ts","sourceRoot":"","sources":["../../../src/lib/tools/getFEOServiceTilesSections.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,OAAO,EAAE,MAAM,aAAa,CAAC;AAGtC,wBAAgB,8BAA8B,IAAI,OAAO,CAmCxD"}

package/dist/lib/tools/getFEOServiceTilesSections.js

@@ -0,0 +1,37 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.getFEOServiceTilesSectionsTool = getFEOServiceTilesSectionsTool;
+const types_js_1 = require("@modelcontextprotocol/sdk/types.js");
+const contentProviders_js_1 = require("../utils/contentProviders.js");
+function getFEOServiceTilesSectionsTool() {
+    async function tool(args) {
+        try {
+            const sections = (0, contentProviders_js_1.getServiceTilesSections)();
+            return {
+                content: [
+                    {
+                        type: 'text',
+                        text: `# Service Tiles Sections and Groups
+
+${sections}`,
+                    },
+                ],
+            };
+        }
+        catch (error) {
+            throw new types_js_1.McpError(types_js_1.ErrorCode.InternalError, `Error getting service tiles sections: ${error instanceof Error ? error.message : String(error)}`);
+        }
+    }
+    return [
+        'getFEOServiceTilesSections',
+        {
+            description: 'Get available service tiles sections and groups',
+            inputSchema: {
+                type: 'object',
+                properties: {},
+                additionalProperties: false,
+            },
+        },
+        tool
+    ];
+}

package/dist/lib/tools/getFEOYamlSetupTemplate.d.ts

@@ -0,0 +1,3 @@
+import { McpTool } from '../types.js';
+export declare function getFEOYamlSetupTemplateTool(): McpTool;
+//# sourceMappingURL=getFEOYamlSetupTemplate.d.ts.map

package/dist/lib/tools/getFEOYamlSetupTemplate.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"getFEOYamlSetupTemplate.d.ts","sourceRoot":"","sources":["../../../src/lib/tools/getFEOYamlSetupTemplate.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,OAAO,EAAE,MAAM,aAAa,CAAC;AAKtC,wBAAgB,2BAA2B,IAAI,OAAO,CAgIrD"}

package/dist/lib/tools/getFEOYamlSetupTemplate.js

@@ -0,0 +1,117 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.getFEOYamlSetupTemplateTool = getFEOYamlSetupTemplateTool;
+const types_js_1 = require("@modelcontextprotocol/sdk/types.js");
+const schemaCache_js_1 = require("../utils/schemaCache.js");
+const templateGenerators_js_1 = require("../utils/templateGenerators.js");
+const recommendations_js_1 = require("../utils/recommendations.js");
+function getFEOYamlSetupTemplateTool() {
+    async function tool(args) {
+        try {
+            const { appName, displayTitle, bundle, description, includeNavigation = true, includeServiceTiles = true, includeSearch = true } = args;
+            if (!appName || !displayTitle || !bundle) {
+                throw new types_js_1.McpError(types_js_1.ErrorCode.InvalidParams, 'Missing required parameters: appName, displayTitle, and bundle are required');
+            }
+            const finalDescription = description || `[Brief description of what ${displayTitle} does]`;
+            // Ensure schema is loaded
+            await (0, schemaCache_js_1.ensureSchemaLoaded)();
+            const serviceSection = (0, recommendations_js_1.getRecommendedServiceSection)(bundle);
+            const template = (0, templateGenerators_js_1.generateSmartTemplate)('full', {
+                appName,
+                bundle,
+                title: displayTitle,
+                position: (0, recommendations_js_1.getRecommendedPosition)(bundle),
+                section: serviceSection.section,
+                group: serviceSection.group,
+                icon: (0, recommendations_js_1.getRecommendedIcon)(bundle),
+                productName: (0, recommendations_js_1.getProductName)(bundle),
+                manifestLocation: `/apps/${appName}/fed-mods.json`,
+                documentTitle: `${displayTitle} | Red Hat Hybrid Cloud Console`,
+                routes: [{ pathname: `/${bundle}/${appName}`, props: { bundle } }],
+                includeNavigation,
+                includeServiceTiles,
+                includeSearch,
+                description: finalDescription
+            });
+            return {
+                content: [
+                    {
+                        type: 'text',
+                        text: `# Complete Frontend.yaml Template
+
+Generated for: **${displayTitle}** (${appName})
+Bundle: **${bundle}**
+
+## Template
+
+\`\`\`yaml
+${template}
+\`\`\`
+
+## Next Steps
+
+1. **Save** this as \`deploy/frontend.yaml\` in your repository
+2. **Update values**:
+   - Replace \`[PRODUCTION-API-KEY]\` with your analytics key
+   - Replace \`[DEVELOPMENT-API-KEY]\` with your dev analytics key
+   - Adjust position value based on desired navigation placement
+   - Customize description and alt_title entries
+3. **Validate**:
+   \`\`\`bash
+   npm run build  # Will validate schema
+   \`\`\`
+4. **Test** in development environment
+5. **Deploy** to staging/production`,
+                    },
+                ],
+            };
+        }
+        catch (error) {
+            if (error instanceof types_js_1.McpError) {
+                throw error;
+            }
+            throw new types_js_1.McpError(types_js_1.ErrorCode.InternalError, `Error generating YAML setup template: ${error instanceof Error ? error.message : String(error)}`);
+        }
+    }
+    return [
+        'getFEOYamlSetupTemplate',
+        {
+            description: 'Generate complete frontend.yaml template for new applications',
+            inputSchema: {
+                type: 'object',
+                properties: {
+                    appName: {
+                        type: 'string',
+                        description: 'Application name in kebab-case (e.g., "my-new-app")',
+                    },
+                    displayTitle: {
+                        type: 'string',
+                        description: 'Human-readable application title',
+                    },
+                    bundle: {
+                        type: 'string',
+                        description: 'Target bundle (insights, openshift, ansible, settings, etc.)',
+                    },
+                    description: {
+                        type: 'string',
+                        description: 'Brief description of what the application does',
+                    },
+                    includeNavigation: {
+                        type: 'boolean',
+                        description: 'Include navigation bundle segment (default: true)',
+                    },
+                    includeServiceTiles: {
+                        type: 'boolean',
+                        description: 'Include service tiles configuration (default: true)',
+                    },
+                    includeSearch: {
+                        type: 'boolean',
+                        description: 'Include search entries (default: true)',
+                    },
+                },
+                required: ['appName', 'displayTitle', 'bundle'],
+            },
+        },
+        tool
+    ];
+}

package/dist/lib/tools/validateFEOConfig.d.ts

@@ -0,0 +1,3 @@
+import { McpTool } from '../types.js';
+export declare function validateFEOConfigTool(): McpTool;
+//# sourceMappingURL=validateFEOConfig.d.ts.map

package/dist/lib/tools/validateFEOConfig.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"validateFEOConfig.d.ts","sourceRoot":"","sources":["../../../src/lib/tools/validateFEOConfig.ts"],"names":[],"mappings":"AAGA,OAAO,EAAE,OAAO,EAAE,MAAM,aAAa,CAAC;AAItC,wBAAgB,qBAAqB,IAAI,OAAO,CA6G/C"}

package/dist/lib/tools/validateFEOConfig.js

@@ -0,0 +1,100 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.validateFEOConfigTool = validateFEOConfigTool;
+const tslib_1 = require("tslib");
+const yaml_1 = tslib_1.__importDefault(require("yaml"));
+const ajv_1 = tslib_1.__importDefault(require("ajv"));
+const types_js_1 = require("@modelcontextprotocol/sdk/types.js");
+const schemaCache_js_1 = require("../utils/schemaCache.js");
+const contentProviders_js_1 = require("../utils/contentProviders.js");
+function validateFEOConfigTool() {
+    async function tool(args) {
+        try {
+            const { yamlContent, skipSchemaFetch = false } = args;
+            if (!yamlContent) {
+                throw new types_js_1.McpError(types_js_1.ErrorCode.InvalidParams, 'Missing required parameter: yamlContent');
+            }
+            // Parse YAML
+            let parsed;
+            try {
+                parsed = yaml_1.default.parse(yamlContent);
+            }
+            catch (parseError) {
+                throw new types_js_1.McpError(types_js_1.ErrorCode.InvalidParams, `YAML Parse Error: ${parseError instanceof Error ? parseError.message : String(parseError)}`);
+            }
+            // Get schema for validation
+            if (!skipSchemaFetch) {
+                await (0, schemaCache_js_1.ensureSchemaLoaded)();
+            }
+            if (!schemaCache_js_1.cachedSchema) {
+                return {
+                    content: [
+                        {
+                            type: 'text',
+                            text: 'Warning: Schema validation skipped (schema not available)',
+                        },
+                    ],
+                };
+            }
+            // Validate against schema
+            const ajv = new ajv_1.default({ allErrors: true, strict: false });
+            const validate = ajv.compile(schemaCache_js_1.cachedSchema);
+            const isValid = validate(parsed);
+            let result = `# FEO Configuration Validation
+
+## YAML Parse: ✅ Valid YAML structure
+
+## Schema Validation: ${isValid ? '✅ Valid' : '❌ Invalid'}
+`;
+            if (!isValid && validate.errors) {
+                result += `
+## Validation Errors:
+${validate.errors.map(error => `- **${error.instancePath || 'root'}**: ${error.message}`).join('\n')}
+`;
+            }
+            // Additional checks
+            const additionalChecks = (0, contentProviders_js_1.performAdditionalChecks)(parsed);
+            if (additionalChecks.length > 0) {
+                result += `
+## Additional Recommendations:
+${additionalChecks.map(check => `- ${check}`).join('\n')}
+`;
+            }
+            return {
+                content: [
+                    {
+                        type: 'text',
+                        text: result,
+                    },
+                ],
+            };
+        }
+        catch (error) {
+            if (error instanceof types_js_1.McpError) {
+                throw error;
+            }
+            throw new types_js_1.McpError(types_js_1.ErrorCode.InternalError, `Error validating FEO config: ${error instanceof Error ? error.message : String(error)}`);
+        }
+    }
+    return [
+        'validateFEOConfig',
+        {
+            description: 'Validate frontend.yaml configuration against FEO schema',
+            inputSchema: {
+                type: 'object',
+                properties: {
+                    yamlContent: {
+                        type: 'string',
+                        description: 'YAML content to validate',
+                    },
+                    skipSchemaFetch: {
+                        type: 'boolean',
+                        description: 'Skip fetching latest schema and use cached version (default: false)',
+                    },
+                },
+                required: ['yamlContent'],
+            },
+        },
+        tool
+    ];
+}

package/dist/lib/types.d.ts

@@ -0,0 +1,6 @@
+import { CallToolResult } from '@modelcontextprotocol/sdk/types.js';
+export type McpTool = [string, {
+    description: string;
+    inputSchema: any;
+}, (args: any) => Promise<CallToolResult>];
+//# sourceMappingURL=types.d.ts.map

package/dist/lib/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../src/lib/types.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,cAAc,EAAE,MAAM,oCAAoC,CAAC;AAEpE,MAAM,MAAM,OAAO,GAAG,CAAC,MAAM,EAAE;IAAE,WAAW,EAAE,MAAM,CAAC;IAAC,WAAW,EAAE,GAAG,CAAA;CAAE,EAAE,CAAC,IAAI,EAAE,GAAG,KAAK,OAAO,CAAC,cAAc,CAAC,CAAC,CAAC"}

package/dist/lib/types.js

@@ -0,0 +1,2 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });

package/dist/lib/utils/contentProviders.d.ts

@@ -0,0 +1,7 @@
+export declare function getMigrationSteps(migrationType: string): string;
+export declare function getExamplesByType(type: string, bundle?: string): string;
+export declare function performAdditionalChecks(config: any): string[];
+export declare function getBestPracticesByCategory(category: string): string;
+export declare function getNavigationPositioningGuidance(bundle?: string): string;
+export declare function getServiceTilesSections(): string;
+//# sourceMappingURL=contentProviders.d.ts.map

package/dist/lib/utils/contentProviders.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"contentProviders.d.ts","sourceRoot":"","sources":["../../../src/lib/utils/contentProviders.ts"],"names":[],"mappings":"AAAA,wBAAgB,iBAAiB,CAAC,aAAa,EAAE,MAAM,GAAG,MAAM,CA4B/D;AAED,wBAAgB,iBAAiB,CAAC,IAAI,EAAE,MAAM,EAAE,MAAM,CAAC,EAAE,MAAM,GAAG,MAAM,CAgDvE;AAuDD,wBAAgB,uBAAuB,CAAC,MAAM,EAAE,GAAG,GAAG,MAAM,EAAE,CAe7D;AAED,wBAAgB,0BAA0B,CAAC,QAAQ,EAAE,MAAM,GAAG,MAAM,CAGnE;AAED,wBAAgB,gCAAgC,CAAC,MAAM,CAAC,EAAE,MAAM,GAAG,MAAM,CAExE;AAED,wBAAgB,uBAAuB,IAAI,MAAM,CAEhD"}