mycontext-cli 2.0.3 → 2.0.4

package/dist/config/build-strategies.json

@@ -1,12 +1,128 @@
 {
   "buildStrategies": {
     "metadata": {
-      "version": "1.0.0",
-      "description": "MyContext CLI Build Strategy Framework",
-      "lastUpdated": "2025-09-23",
+      "version": "2.0.0",
+      "description": "MyContext CLI Build Strategy Framework - Component-First Edition",
+      "lastUpdated": "2025-01-04",
       "author": "MyContext Team"
     },
     "strategies": [
+      {
+        "id": "component-first",
+        "name": "Component-First (Recommended)",
+        "description": "Generate and validate individual components with visual preview, then compose into complete application using Claude Agent SDK",
+        "icon": "🎨",
+        "complexity": "low",
+        "timeToFirstDemo": "3-5 days",
+        "bestFor": ["MVPs", "rapid prototyping", "solo developers", "internal tools", "standard patterns"],
+        "phases": [
+          {
+            "phase": 1,
+            "name": "Component Library Building",
+            "duration": "3-7 days",
+            "description": "Generate and validate core components one at a time with zero-error guarantees",
+            "tasks": [
+              "Run mycontext init to set up project structure",
+              "Generate authentication components (LoginForm, SignupForm, PasswordReset)",
+              "Validate each component (TypeScript, ESLint, build checks, tests)",
+              "Preview components in visual board (mycontext preview components)",
+              "Generate dashboard components (Sidebar, Header, DataTable, StatsCard)",
+              "Generate settings components (ProfileForm, SettingsPanel, AccountSettings)",
+              "Generate marketing components (Hero, Features, Pricing, Footer)",
+              "Build component library incrementally with validation at each step"
+            ],
+            "deliverables": [
+              "10-20 validated, production-ready components",
+              "Visual component preview board",
+              "Zero TypeScript/ESLint/build errors guaranteed",
+              "Component tests passing (100% coverage on generated code)",
+              "Component documentation auto-generated"
+            ],
+            "successCriteria": "All components validated and visible in preview board with zero errors"
+          },
+          {
+            "phase": 2,
+            "name": "AI-Powered Application Scaffolding",
+            "duration": "2-3 days",
+            "description": "Use Claude Agent SDK to detect components and generate intelligent integration layer",
+            "tasks": [
+              "Run mycontext build-app --interactive --complete-architecture",
+              "Claude Agent SDK detects existing validated components automatically",
+              "AI analyzes component names and groups (LoginForm → authentication)",
+              "AI maps components to Next.js routes intelligently (LoginForm → /login)",
+              "Generate server actions for component interactions (authenticateUser, createUser)",
+              "Generate custom hooks for shared logic (useAuth, useForm, useDashboard)",
+              "Create layouts for component grouping (AuthLayout, DashboardLayout)",
+              "Wire up routing, navigation, and state management",
+              "Validate scaffolding with build checks"
+            ],
+            "deliverables": [
+              "Complete Next.js App Router structure (app/, actions/, hooks/)",
+              "Routes generated for page components with proper layouts",
+              "Server actions integrated with type-safe interfaces",
+              "Custom hooks created for reusable logic",
+              "Layouts applied with proper component composition",
+              "Zero-error scaffolding guaranteed"
+            ],
+            "successCriteria": "Application scaffolding complete, all components integrated, app runs with zero errors"
+          },
+          {
+            "phase": 3,
+            "name": "Customization & Production Deployment",
+            "duration": "3-5 days",
+            "description": "Customize generated components for your unique use case and deploy to production",
+            "tasks": [
+              "Customize business logic in server actions (payment flows, data validation)",
+              "Adjust styling and branding (colors, fonts, logos)",
+              "Add unique product features (the 30% that makes your app special)",
+              "Integrate third-party services (Stripe, SendGrid, analytics)",
+              "Performance optimization (image optimization, code splitting)",
+              "Security hardening (rate limiting, input sanitization)",
+              "Final end-to-end testing",
+              "Deploy to Vercel/Netlify/self-hosted",
+              "Set up monitoring and analytics"
+            ],
+            "deliverables": [
+              "Fully customized application with unique features",
+              "Production-ready deployment",
+              "Monitoring and analytics configured",
+              "Documentation for maintenance"
+            ],
+            "successCriteria": "Application deployed, serving users, monitoring active"
+          }
+        ],
+        "pros": [
+          "Extremely fast - ship MVPs in 7-15 days, not months",
+          "Visual feedback from day 1 with component preview board",
+          "Zero-error components guaranteed before integration (TypeScript, ESLint, build)",
+          "Claude Agent SDK intelligently reuses and maps components to routes",
+          "Perfect for MVPs, internal tools, and rapid validation",
+          "Component library reusable across multiple projects",
+          "Focus on the 30% that's unique, not the 70% that's universal",
+          "Lower cost - generate standard patterns, pay developers for unique features"
+        ],
+        "cons": [
+          "Best for standard patterns, not highly custom UIs (Figma, Notion)",
+          "Requires customization for unique business logic (your competitive advantage)",
+          "May need refactoring for complex domain-specific integrations",
+          "Not ideal for apps where custom design IS the product"
+        ],
+        "workflow": {
+          "day1-2": "Generate 5-10 core components, preview in browser",
+          "day3-5": "Generate remaining components, validate all with tests",
+          "day6-7": "Run build-app, Claude maps components to routes, scaffolding generated",
+          "day8-12": "Customize business logic, add unique features",
+          "day13-15": "Testing, deployment, monitoring setup"
+        },
+        "cliCommands": [
+          "mycontext init my-app",
+          "mycontext generate-components LoginForm --with-tests",
+          "mycontext generate-components Dashboard --with-tests",
+          "mycontext preview components",
+          "mycontext build-app --interactive --complete-architecture",
+          "npm run build && vercel deploy"
+        ]
+      },
       {
         "id": "foundation-first",
         "name": "Foundation First",
@@ -427,46 +543,81 @@
       }
     ],
     "decisionMatrix": {
-      "clientWork": {
-        "recommended": ["foundation-first", "vertical-slice", "hybrid-approach"],
-        "reasoning": "Clients need to see progress and trust the development process. Complete features and solid foundations build confidence."
+      "mvpDevelopment": {
+        "recommended": ["component-first"],
+        "alternatives": ["vertical-slice", "iterative-scaffolding"],
+        "reasoning": "MVPs need speed and validation. Component-first gets you to production in 7-15 days with zero-error guarantees. Perfect for testing ideas quickly."
+      },
+      "rapidPrototyping": {
+        "recommended": ["component-first"],
+        "alternatives": ["iterative-scaffolding"],
+        "reasoning": "Component-first is specifically designed for rapid iteration with visual preview and automatic validation."
       },
       "personalProjects": {
-        "recommended": ["iterative-scaffolding", "horizontal-slice"],
-        "reasoning": "Personal projects benefit from speed and momentum. Quick visual progress keeps motivation high."
+        "recommended": ["component-first", "iterative-scaffolding"],
+        "alternatives": ["horizontal-slice"],
+        "reasoning": "Personal projects benefit from speed, visual feedback, and component reusability. Component-first provides all three."
+      },
+      "internalTools": {
+        "recommended": ["component-first"],
+        "alternatives": ["horizontal-slice"],
+        "reasoning": "Internal tools follow standard patterns (auth, CRUD, dashboards). Component-first generates these in days."
+      },
+      "clientWork": {
+        "recommended": ["component-first", "vertical-slice"],
+        "alternatives": ["foundation-first", "hybrid-approach"],
+        "reasoning": "Clients need to see progress fast. Component-first delivers visual demos in days. Use foundation-first for complex enterprise clients."
       },
       "teamDevelopment": {
         "recommended": ["horizontal-slice", "hybrid-approach"],
-        "reasoning": "Teams can work in parallel on different features. Clear boundaries and solid foundations prevent conflicts."
-      },
-      "mvpDevelopment": {
-        "recommended": ["vertical-slice", "iterative-scaffolding"],
-        "reasoning": "MVPs need quick results and demo-able features. Focus on core user journeys first."
+        "alternatives": ["component-first"],
+        "reasoning": "Teams can work in parallel on different features. Component-first works for small teams building standard patterns."
       },
       "enterpriseApplications": {
         "recommended": ["foundation-first", "hybrid-approach"],
-        "reasoning": "Enterprise apps need solid architecture and security. Foundation-first prevents technical debt."
+        "alternatives": ["component-first"],
+        "reasoning": "Enterprise apps with complex domains need solid architecture. Use component-first for admin dashboards and internal tools."
+      },
+      "standardPatterns": {
+        "recommended": ["component-first"],
+        "alternatives": [],
+        "reasoning": "Apps built on standard patterns (auth, dashboards, CRUD, settings) are PERFECT for component-first. The 70/30 rule applies."
+      },
+      "uniqueCustomUI": {
+        "recommended": ["foundation-first", "vertical-slice"],
+        "alternatives": [],
+        "reasoning": "Apps where custom UI IS the product (Figma, Notion) need full control. Component-first is NOT ideal here."
       }
     },
     "contextualFactors": {
       "appComplexity": {
-        "simple": ["iterative-scaffolding", "horizontal-slice"],
-        "medium": ["vertical-slice", "hybrid-approach"],
+        "simple": ["component-first", "iterative-scaffolding"],
+        "medium": ["component-first", "vertical-slice", "hybrid-approach"],
         "complex": ["foundation-first", "hybrid-approach"]
       },
       "userRoles": {
-        "single": ["horizontal-slice", "iterative-scaffolding"],
-        "multiple": ["foundation-first", "vertical-slice", "hybrid-approach"]
+        "single": ["component-first", "horizontal-slice"],
+        "multiple": ["component-first", "vertical-slice", "hybrid-approach"]
       },
       "timeline": {
-        "urgent": ["iterative-scaffolding", "vertical-slice"],
-        "moderate": ["horizontal-slice", "hybrid-approach"],
+        "urgent": ["component-first", "iterative-scaffolding"],
+        "moderate": ["component-first", "horizontal-slice"],
         "flexible": ["foundation-first", "hybrid-approach"]
       },
       "teamSize": {
-        "solo": ["iterative-scaffolding", "vertical-slice"],
-        "small": ["horizontal-slice", "hybrid-approach"],
+        "solo": ["component-first", "iterative-scaffolding"],
+        "small": ["component-first", "horizontal-slice"],
         "large": ["foundation-first", "horizontal-slice"]
+      },
+      "patternType": {
+        "standardPatterns": ["component-first"],
+        "mixedPatterns": ["component-first", "vertical-slice"],
+        "customPatterns": ["foundation-first", "hybrid-approach"]
+      },
+      "developmentGoal": {
+        "rapidValidation": ["component-first"],
+        "productionMVP": ["component-first", "vertical-slice"],
+        "enterpriseGrade": ["foundation-first", "hybrid-approach"]
       }
     },
     "implementationGuidance": {

package/dist/package.json

@@ -1,7 +1,7 @@
 {
   "name": "mycontext-cli",
-  "version": "2.0.3",
-  "description": "MyContext CLI - AI-powered full-stack application generator with complete architecture generation, server actions, Next.js 15 App Router, and self-documenting components",
+  "version": "2.0.4",
+  "description": "Component-first visual builder with zero-error guarantees. Generate and validate React/Next.js components one at a time, preview them visually, then scale to complete applications using Claude Agent SDK.",
   "main": "dist/cli.js",
   "bin": {
     "mycontext-cli": "dist/cli.js",

package/dist/utils/agentDefinitions.d.ts

@@ -45,6 +45,11 @@ export declare const refactoringAgent: AgentDefinition;
  * Optimizes code for better performance
  */
 export declare const performanceAgent: AgentDefinition;
+/**
+ * Component-First Builder Agent
+ * Intelligently reuses existing validated components or generates new ones
+ */
+export declare const componentFirstBuilderAgent: AgentDefinition;
 /**
  * Get all agent definitions
  */

package/dist/utils/agentDefinitions.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"agentDefinitions.d.ts","sourceRoot":"","sources":["../../src/utils/agentDefinitions.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,gCAAgC,CAAC;AAEtE;;;GAGG;AACH,eAAO,MAAM,uBAAuB,EAAE,eAyBrC,CAAC;AAEF;;;GAGG;AACH,eAAO,MAAM,iBAAiB,EAAE,eAoC/B,CAAC;AAEF;;;GAGG;AACH,eAAO,MAAM,kBAAkB,EAAE,eA4BhC,CAAC;AAEF;;;GAGG;AACH,eAAO,MAAM,YAAY,EAAE,eAiC1B,CAAC;AAEF;;;GAGG;AACH,eAAO,MAAM,iBAAiB,EAAE,eAkC/B,CAAC;AAEF;;;GAGG;AACH,eAAO,MAAM,aAAa,EAAE,eAgC3B,CAAC;AAEF;;;GAGG;AACH,eAAO,MAAM,gBAAgB,EAAE,eA8B9B,CAAC;AAEF;;;GAGG;AACH,eAAO,MAAM,gBAAgB,EAAE,eAmC9B,CAAC;AAEF;;GAEG;AACH,wBAAgB,sBAAsB,IAAI,MAAM,CAAC,MAAM,EAAE,eAAe,CAAC,CAWxE;AAED;;GAEG;AACH,wBAAgB,kBAAkB,CAAC,IAAI,EAAE,MAAM,GAAG,eAAe,GAAG,SAAS,CAG5E;AAED;;GAEG;AACH,wBAAgB,gBAAgB,CAAC,IAAI,EAAE,UAAU,GAAG,QAAQ,GAAG,MAAM,GAAG,MAAM,GAAG,WAAW,GAAG,UAAU,GAAG,UAAU,GAAG,UAAU,GAAG,eAAe,CAapJ"}
+{"version":3,"file":"agentDefinitions.d.ts","sourceRoot":"","sources":["../../src/utils/agentDefinitions.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,gCAAgC,CAAC;AAEtE;;;GAGG;AACH,eAAO,MAAM,uBAAuB,EAAE,eAyBrC,CAAC;AAEF;;;GAGG;AACH,eAAO,MAAM,iBAAiB,EAAE,eAoC/B,CAAC;AAEF;;;GAGG;AACH,eAAO,MAAM,kBAAkB,EAAE,eA4BhC,CAAC;AAEF;;;GAGG;AACH,eAAO,MAAM,YAAY,EAAE,eAiC1B,CAAC;AAEF;;;GAGG;AACH,eAAO,MAAM,iBAAiB,EAAE,eAkC/B,CAAC;AAEF;;;GAGG;AACH,eAAO,MAAM,aAAa,EAAE,eAgC3B,CAAC;AAEF;;;GAGG;AACH,eAAO,MAAM,gBAAgB,EAAE,eA8B9B,CAAC;AAEF;;;GAGG;AACH,eAAO,MAAM,gBAAgB,EAAE,eAmC9B,CAAC;AAEF;;;GAGG;AACH,eAAO,MAAM,0BAA0B,EAAE,eA4FxC,CAAC;AAEF;;GAEG;AACH,wBAAgB,sBAAsB,IAAI,MAAM,CAAC,MAAM,EAAE,eAAe,CAAC,CAYxE;AAED;;GAEG;AACH,wBAAgB,kBAAkB,CAAC,IAAI,EAAE,MAAM,GAAG,eAAe,GAAG,SAAS,CAG5E;AAED;;GAEG;AACH,wBAAgB,gBAAgB,CAAC,IAAI,EAAE,UAAU,GAAG,QAAQ,GAAG,MAAM,GAAG,MAAM,GAAG,WAAW,GAAG,UAAU,GAAG,UAAU,GAAG,UAAU,GAAG,eAAe,CAapJ"}

package/dist/utils/agentDefinitions.js

@@ -6,7 +6,7 @@
  * and custom system prompts.
  */
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.performanceAgent = exports.refactoringAgent = exports.securityAgent = exports.architectureAgent = exports.testingAgent = exports.documentationAgent = exports.codeReviewerAgent = exports.componentGeneratorAgent = void 0;
+exports.componentFirstBuilderAgent = exports.performanceAgent = exports.refactoringAgent = exports.securityAgent = exports.architectureAgent = exports.testingAgent = exports.documentationAgent = exports.codeReviewerAgent = exports.componentGeneratorAgent = void 0;
 exports.getAllAgentDefinitions = getAllAgentDefinitions;
 exports.getAgentDefinition = getAgentDefinition;
 exports.getAgentsForTask = getAgentsForTask;
@@ -303,6 +303,103 @@ exports.performanceAgent = {
 
 Provide measurable improvements with before/after comparisons where possible.`,
 };
+/**
+ * Component-First Builder Agent
+ * Intelligently reuses existing validated components or generates new ones
+ */
+exports.componentFirstBuilderAgent = {
+    description: 'Builds applications by intelligently reusing validated components and generating scaffolding',
+    tools: [
+        'Read', 'Write', 'Glob', 'Grep',
+        'DetectExistingComponents',
+        'MapComponentsToRoutes',
+        'GenerateScaffolding',
+        'AnalyzeComponent',
+        'ValidatePRD'
+    ],
+    model: 'sonnet',
+    prompt: `You are a component-first application builder. Your workflow emphasizes reusing validated components over regenerating everything.
+
+**Step 1: Detection Phase**
+Use DetectExistingComponents to analyze the project:
+- Check for existing validated components
+- Review validation status (TypeScript, ESLint, build, tests)
+- Analyze component groups and organization
+- Make data-driven decision: REUSE vs GENERATE
+
+**Step 2: Decision Making**
+
+REUSE_COMPONENTS mode (3+ validated components found):
+- ✅ Skip component generation entirely
+- ✅ Use existing validated components as foundation
+- ✅ Focus on scaffolding: routes, actions, hooks, layouts
+- ✅ Generate integration layer only
+
+PARTIAL_REUSE mode (1-2 validated components):
+- Use existing components where available
+- Generate missing components
+- Create unified scaffolding
+
+GENERATE_ALL mode (< 1 validated component):
+- Generate components from scratch
+- Validate each component (TypeScript, ESLint, build)
+- Then generate scaffolding
+
+**Step 3: Route Mapping**
+Use MapComponentsToRoutes to create intelligent mappings:
+- Analyze component names (LoginPage → /login, Dashboard → /dashboard)
+- Consider component groups (auth, admin, forms)
+- Read PRD context for app structure understanding
+- Design optimal route hierarchy
+- Identify required actions and hooks per component
+
+**Step 4: Scaffolding Generation**
+Use GenerateScaffolding to create:
+
+Routes (app/ directory):
+- Page components that import and use existing components
+- Proper layouts for component groups (AuthLayout, DashboardLayout)
+- Route handlers for dynamic routes
+
+Server Actions (actions/ directory):
+- Actions based on component needs (form submissions, auth, CRUD)
+- Type-safe action interfaces
+- Validation logic
+- Error handling
+
+Custom Hooks (hooks/ directory):
+- Shared logic extraction (useForm, useAuth, useData)
+- State management hooks
+- API integration hooks
+
+Layouts (components/layouts/):
+- Group-specific layouts (AuthLayout, FormLayout)
+- Shared UI patterns
+
+**Best Practices:**
+1. Always prefer reusing validated components - they're production-ready
+2. Generate minimal, focused scaffolding - no over-engineering
+3. Ensure type safety across all integrations
+4. Follow Next.js 15 App Router patterns
+5. Create clear component-to-route mappings
+6. Add proper error boundaries
+7. Include loading states
+8. Follow established project patterns
+
+**Communication:**
+- Clearly explain detection results
+- Show your decision (REUSE vs GENERATE)
+- Provide component mapping summary
+- List all generated scaffolding files
+- Offer clear next steps
+
+**Error Handling:**
+- If component detection fails, fall back to GENERATE_ALL
+- If mapping fails, provide manual mapping suggestions
+- If scaffolding fails, report specific file errors
+
+Your goal: Build production-ready applications that leverage existing validated components, minimizing regeneration and maximizing code reuse.`,
+};
 /**
  * Get all agent definitions
  */
@@ -316,6 +413,7 @@ function getAllAgentDefinitions() {
         security: exports.securityAgent,
         refactoring: exports.refactoringAgent,
         performance: exports.performanceAgent,
+        componentFirstBuilder: exports.componentFirstBuilderAgent,
     };
 }
 /**

package/dist/utils/agentDefinitions.js.map

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

package/dist/utils/mcpTools.d.ts

@@ -65,6 +65,77 @@ export declare const generateDocsTool: {
         outputPath?: string | undefined;
     }, extra: unknown) => Promise<CallToolResult>;
 };
+/**
+ * Detect existing validated components in the project
+ */
+export declare const detectExistingComponentsTool: {
+    name: string;
+    description: string;
+    inputSchema: {
+        projectPath: z.ZodString;
+        includeValidation: z.ZodOptional<z.ZodBoolean>;
+    };
+    handler: (args: {
+        projectPath: string;
+        includeValidation?: boolean | undefined;
+    }, extra: unknown) => Promise<CallToolResult>;
+};
+/**
+ * Map components to routes intelligently
+ */
+export declare const mapComponentsToRoutesTool: {
+    name: string;
+    description: string;
+    inputSchema: {
+        components: z.ZodArray<z.ZodObject<{
+            name: z.ZodString;
+            group: z.ZodString;
+            path: z.ZodString;
+        }, "strip", z.ZodTypeAny, {
+            name: string;
+            path: string;
+            group: string;
+        }, {
+            name: string;
+            path: string;
+            group: string;
+        }>, "many">;
+        prdContext: z.ZodOptional<z.ZodString>;
+        architectureType: z.ZodEnum<["nextjs-app-router", "nextjs-pages", "react-spa"]>;
+    };
+    handler: (args: {
+        components: {
+            name: string;
+            path: string;
+            group: string;
+        }[];
+        architectureType: "nextjs-app-router" | "nextjs-pages" | "react-spa";
+        prdContext?: string | undefined;
+    }, extra: unknown) => Promise<CallToolResult>;
+};
+/**
+ * Generate scaffolding for existing components
+ */
+export declare const generateScaffoldingTool: {
+    name: string;
+    description: string;
+    inputSchema: {
+        componentMappings: z.ZodAny;
+        projectPath: z.ZodString;
+        generateRoutes: z.ZodDefault<z.ZodBoolean>;
+        generateActions: z.ZodDefault<z.ZodBoolean>;
+        generateHooks: z.ZodDefault<z.ZodBoolean>;
+        generateLayouts: z.ZodDefault<z.ZodBoolean>;
+    };
+    handler: (args: {
+        projectPath: string;
+        generateRoutes: boolean;
+        generateActions: boolean;
+        generateHooks: boolean;
+        generateLayouts: boolean;
+        componentMappings?: any;
+    }, extra: unknown) => Promise<CallToolResult>;
+};
 /**
  * Get all available MCP tools
  */
@@ -112,6 +183,65 @@ export declare function getAllMCPTools(): ({
         componentPath: string;
         outputPath?: string | undefined;
     }, extra: unknown) => Promise<CallToolResult>;
+} | {
+    name: string;
+    description: string;
+    inputSchema: {
+        projectPath: z.ZodString;
+        includeValidation: z.ZodOptional<z.ZodBoolean>;
+    };
+    handler: (args: {
+        projectPath: string;
+        includeValidation?: boolean | undefined;
+    }, extra: unknown) => Promise<CallToolResult>;
+} | {
+    name: string;
+    description: string;
+    inputSchema: {
+        components: z.ZodArray<z.ZodObject<{
+            name: z.ZodString;
+            group: z.ZodString;
+            path: z.ZodString;
+        }, "strip", z.ZodTypeAny, {
+            name: string;
+            path: string;
+            group: string;
+        }, {
+            name: string;
+            path: string;
+            group: string;
+        }>, "many">;
+        prdContext: z.ZodOptional<z.ZodString>;
+        architectureType: z.ZodEnum<["nextjs-app-router", "nextjs-pages", "react-spa"]>;
+    };
+    handler: (args: {
+        components: {
+            name: string;
+            path: string;
+            group: string;
+        }[];
+        architectureType: "nextjs-app-router" | "nextjs-pages" | "react-spa";
+        prdContext?: string | undefined;
+    }, extra: unknown) => Promise<CallToolResult>;
+} | {
+    name: string;
+    description: string;
+    inputSchema: {
+        componentMappings: z.ZodAny;
+        projectPath: z.ZodString;
+        generateRoutes: z.ZodDefault<z.ZodBoolean>;
+        generateActions: z.ZodDefault<z.ZodBoolean>;
+        generateHooks: z.ZodDefault<z.ZodBoolean>;
+        generateLayouts: z.ZodDefault<z.ZodBoolean>;
+    };
+    handler: (args: {
+        projectPath: string;
+        generateRoutes: boolean;
+        generateActions: boolean;
+        generateHooks: boolean;
+        generateLayouts: boolean;
+        componentMappings?: any;
+    }, extra: unknown) => Promise<CallToolResult>;
 })[];
 /**
  * Get MCP tools by name
@@ -160,5 +290,64 @@ export declare function getMCPToolByName(name: string): {
         componentPath: string;
         outputPath?: string | undefined;
     }, extra: unknown) => Promise<CallToolResult>;
+} | {
+    name: string;
+    description: string;
+    inputSchema: {
+        projectPath: z.ZodString;
+        includeValidation: z.ZodOptional<z.ZodBoolean>;
+    };
+    handler: (args: {
+        projectPath: string;
+        includeValidation?: boolean | undefined;
+    }, extra: unknown) => Promise<CallToolResult>;
+} | {
+    name: string;
+    description: string;
+    inputSchema: {
+        components: z.ZodArray<z.ZodObject<{
+            name: z.ZodString;
+            group: z.ZodString;
+            path: z.ZodString;
+        }, "strip", z.ZodTypeAny, {
+            name: string;
+            path: string;
+            group: string;
+        }, {
+            name: string;
+            path: string;
+            group: string;
+        }>, "many">;
+        prdContext: z.ZodOptional<z.ZodString>;
+        architectureType: z.ZodEnum<["nextjs-app-router", "nextjs-pages", "react-spa"]>;
+    };
+    handler: (args: {
+        components: {
+            name: string;
+            path: string;
+            group: string;
+        }[];
+        architectureType: "nextjs-app-router" | "nextjs-pages" | "react-spa";
+        prdContext?: string | undefined;
+    }, extra: unknown) => Promise<CallToolResult>;
+} | {
+    name: string;
+    description: string;
+    inputSchema: {
+        componentMappings: z.ZodAny;
+        projectPath: z.ZodString;
+        generateRoutes: z.ZodDefault<z.ZodBoolean>;
+        generateActions: z.ZodDefault<z.ZodBoolean>;
+        generateHooks: z.ZodDefault<z.ZodBoolean>;
+        generateLayouts: z.ZodDefault<z.ZodBoolean>;
+    };
+    handler: (args: {
+        projectPath: string;
+        generateRoutes: boolean;
+        generateActions: boolean;
+        generateHooks: boolean;
+        generateLayouts: boolean;
+        componentMappings?: any;
+    }, extra: unknown) => Promise<CallToolResult>;
 } | undefined;
 //# sourceMappingURL=mcpTools.d.ts.map

package/dist/utils/mcpTools.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"mcpTools.d.ts","sourceRoot":"","sources":["../../src/utils/mcpTools.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAGH,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAKxB;;GAEG;AACH,eAAO,MAAM,oBAAoB;;;;;;;;;;;;;CAgFhC,CAAC;AAEF;;GAEG;AACH,eAAO,MAAM,eAAe;;;;;;;;;CAkG3B,CAAC;AAEF;;GAEG;AACH,eAAO,MAAM,cAAc;;;;;;;;;;;CAqF1B,CAAC;AAEF;;GAEG;AACH,eAAO,MAAM,gBAAgB;;;;;;;;;;;CA0F5B,CAAC;AAEF;;GAEG;AACH,wBAAgB,cAAc;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;KAO7B;AAED;;GAEG;AACH,wBAAgB,gBAAgB,CAAC,IAAI,EAAE,MAAM;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;cAG5C"}
+{"version":3,"file":"mcpTools.d.ts","sourceRoot":"","sources":["../../src/utils/mcpTools.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAGH,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAKxB;;GAEG;AACH,eAAO,MAAM,oBAAoB;;;;;;;;;;;;;CAgFhC,CAAC;AAEF;;GAEG;AACH,eAAO,MAAM,eAAe;;;;;;;;;CAkG3B,CAAC;AAEF;;GAEG;AACH,eAAO,MAAM,cAAc;;;;;;;;;;;CAqF1B,CAAC;AAEF;;GAEG;AACH,eAAO,MAAM,gBAAgB;;;;;;;;;;;CA0F5B,CAAC;AAEF;;GAEG;AACH,eAAO,MAAM,4BAA4B;;;;;;;;;;;CA0KxC,CAAC;AAEF;;GAEG;AACH,eAAO,MAAM,yBAAyB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CAqJrC,CAAC;AAEF;;GAEG;AACH,eAAO,MAAM,uBAAuB;;;;;;;;;;;;;;;;;;;CA6MnC,CAAC;AAEF;;GAEG;AACH,wBAAgB,cAAc;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;KAU7B;AAED;;GAEG;AACH,wBAAgB,gBAAgB,CAAC,IAAI,EAAE,MAAM;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;cAG5C"}