@stellisoft/stellify-mcp 0.1.15 → 0.1.17

package/dist/index.js

@@ -1134,25 +1134,6 @@ SECURITY: Code runs in a sandboxed environment with limited permissions.`,
             required: ['file', 'method'],
         },
     },
-    {
-        name: 'get_capabilities',
-        description: `List available system-level capabilities in the Stellify framework.
-
-Returns what's currently available for:
-- Authentication (Sanctum, session, etc.)
-- File storage (local, S3, etc.)
-- Email/notifications
-- Queues/jobs
-- Caching
-- Other installed packages and services
-
-Use this BEFORE attempting to build features that might require system capabilities.
-If a capability you need is not listed, use request_capability to log it.`,
-        inputSchema: {
-            type: 'object',
-            properties: {},
-        },
-    },
     {
         name: 'request_capability',
         description: `Log a missing system-level capability request.
@@ -1243,6 +1224,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.
@@ -1273,7 +1293,7 @@ Examples of capabilities (packages you cannot write):
 
 **WORKFLOW:**
 
-1. When a user requests functionality that might need a package/library, call get_capabilities() FIRST.
+1. When a user requests functionality that might need a package/library, check the capabilities list from get_project FIRST.
 
 2. If status is "available" → package is installed, proceed with business logic.
 
@@ -1322,14 +1342,16 @@ server.setRequestHandler(CallToolRequestSchema, async (request) => {
         switch (name) {
             case 'get_project': {
                 const result = await stellify.getProject();
+                const projectData = result.data || result;
+                const projectMeta = projectData.project || {};
                 return {
                     content: [
                         {
                             type: 'text',
                             text: JSON.stringify({
                                 success: true,
-                                message: `Active project: "${result.data?.name || result.name}" (${result.data?.uuid || result.uuid})`,
-                                project: result.data || result,
+                                message: `Active project: "${projectMeta.name || 'unknown'}" (${projectMeta.uuid || 'unknown'})`,
+                                project: projectData,
                             }, null, 2),
                         },
                     ],
@@ -1791,21 +1813,6 @@ server.setRequestHandler(CallToolRequestSchema, async (request) => {
                     ],
                 };
             }
-            case 'get_capabilities': {
-                const result = await stellify.getCapabilities();
-                return {
-                    content: [
-                        {
-                            type: 'text',
-                            text: JSON.stringify({
-                                success: true,
-                                message: 'Available framework capabilities',
-                                capabilities: result.data || result,
-                            }, null, 2),
-                        },
-                    ],
-                };
-            }
             case 'request_capability': {
                 const result = await stellify.requestCapability(args);
                 return {
@@ -1868,6 +1875,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.17",
   "mcpName": "io.github.MattStellisoft/stellify-mcp",
   "description": "MCP server for Stellify - AI-native code generation platform",
   "main": "dist/index.js",