@stellisoft/stellify-mcp 0.1.15 → 0.1.16

package/dist/index.js

@@ -1243,6 +1243,45 @@ The response includes actionable recommendations like:
             },
         },
     },
+    {
+        name: 'analyze_quality',
+        description: `Analyze Laravel code structure for quality issues. Detects missing relationships, fillables, casts, and route problems.
+
+Use this tool PROACTIVELY to:
+- Review code quality after creating models or controllers
+- Detect missing Eloquent relationships (belongsTo, hasMany)
+- Find migration fields not in $fillable
+- Suggest type casts for columns (json → array, datetime → datetime)
+- Identify broken route bindings (orphaned methods, missing controllers)
+
+ANALYSIS TYPES:
+- full: Comprehensive analysis of all categories with recommendations
+- relationships: Missing belongsTo/hasMany based on foreign keys
+- fillables: Migration fields not in Model $fillable array
+- casts: Columns that should have type casts
+- routes: Orphaned controller methods, routes pointing to missing methods
+
+EXAMPLE - Full analysis:
+{ "type": "full" }
+
+EXAMPLE - Check relationships only:
+{ "type": "relationships" }
+
+The response includes actionable suggestions like:
+- "Add belongsTo relationship: public function user() { return $this->belongsTo(User::class); }"
+- "Add 'published_at' to $fillable array"
+- "Add cast: 'metadata' => 'array'"`,
+        inputSchema: {
+            type: 'object',
+            properties: {
+                type: {
+                    type: 'string',
+                    enum: ['full', 'relationships', 'fillables', 'casts', 'routes'],
+                    description: 'Type of analysis to run (default: full)',
+                },
+            },
+        },
+    },
 ];
 // Server instructions for tool discovery (used by MCP Tool Search)
 const SERVER_INSTRUCTIONS = `Stellify is a coding platform where you code alongside AI on a codebase maintained and curated by AI. Build Laravel/PHP and Vue.js applications.
@@ -1868,6 +1907,40 @@ server.setRequestHandler(CallToolRequestSchema, async (request) => {
                     ],
                 };
             }
+            case 'analyze_quality': {
+                const result = await stellify.analyzeQuality(args);
+                const data = result.data || result;
+                const analysisType = args.type || 'full';
+                // Build message based on analysis type
+                let message = '';
+                const issues = data.issues || [];
+                if (analysisType === 'full') {
+                    const summary = data.summary || {};
+                    message = `Analyzed ${summary.models_analyzed || 0} models, ${summary.controllers_analyzed || 0} controllers`;
+                    if (summary.total_issues > 0) {
+                        message += ` - Found ${summary.total_issues} issue(s): ${summary.high_severity || 0} high, ${summary.medium_severity || 0} medium, ${summary.low_severity || 0} low`;
+                    }
+                    else {
+                        message += ' - No issues found';
+                    }
+                }
+                else {
+                    message = `Found ${issues.length} ${analysisType} issue(s)`;
+                }
+                return {
+                    content: [
+                        {
+                            type: 'text',
+                            text: JSON.stringify({
+                                success: true,
+                                message,
+                                analysis_type: analysisType,
+                                data,
+                            }, null, 2),
+                        },
+                    ],
+                };
+            }
             default:
                 throw new Error(`Unknown tool: ${name}`);
         }

package/dist/stellify-client.d.ts

@@ -163,4 +163,7 @@ export declare class StellifyClient {
         days?: number;
         limit?: number;
     }): Promise<any>;
+    analyzeQuality(params: {
+        type?: 'full' | 'relationships' | 'fillables' | 'casts' | 'routes';
+    }): Promise<any>;
 }

package/dist/stellify-client.js

@@ -169,4 +169,17 @@ export class StellifyClient {
         const response = await this.client.get(endpoint, { params: queryParams });
         return response.data;
     }
+    // Code quality analysis - analyze Laravel structure for issues
+    async analyzeQuality(params) {
+        const type = params.type || 'full';
+        // Map type to endpoint
+        const endpoint = type === 'full' ? '/quality/analyze' :
+            type === 'relationships' ? '/quality/relationships' :
+                type === 'fillables' ? '/quality/fillables' :
+                    type === 'casts' ? '/quality/casts' :
+                        type === 'routes' ? '/quality/routes' :
+                            '/quality/analyze';
+        const response = await this.client.get(endpoint);
+        return response.data;
+    }
 }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@stellisoft/stellify-mcp",
-  "version": "0.1.15",
+  "version": "0.1.16",
   "mcpName": "io.github.MattStellisoft/stellify-mcp",
   "description": "MCP server for Stellify - AI-native code generation platform",
   "main": "dist/index.js",