@opensaas/stack-cli 0.4.0 → 0.6.0

package/src/mcp/lib/wizards/wizard-engine.ts

@@ -1,427 +0,0 @@
-/**
- * Wizard engine for multi-step feature implementation flows
- */
-
-import type { Feature, WizardSession, SessionStorage, FeatureQuestion } from '../types.js'
-import { getFeature } from '../features/catalog.js'
-import { FeatureGenerator } from '../generators/feature-generator.js'
-
-export class WizardEngine {
-  private sessions: SessionStorage = {}
-
-  /**
-   * Start a new feature implementation wizard
-   */
-  async startFeature(featureId: string): Promise<{
-    content: Array<{ type: string; text: string }>
-  }> {
-    const feature = getFeature(featureId)
-    if (!feature) {
-      return {
-        content: [
-          {
-            type: 'text',
-            text: `❌ Unknown feature: "${featureId}"\n\nAvailable features: authentication, blog, comments, file-upload, semantic-search`,
-          },
-        ],
-      }
-    }
-
-    const sessionId = this.generateSessionId()
-    const session = this.createSession(sessionId, feature)
-    this.sessions[sessionId] = session
-
-    const progressBar = this.renderProgressBar(1, feature.questions.length)
-    const firstQuestion = this.renderQuestion(feature.questions[0], session, 1)
-
-    return {
-      content: [
-        {
-          type: 'text',
-          text: `🚀 **${feature.name} Implementation**
-
-${feature.description}
-
-**What's included**:
-${feature.includes.map((item) => `- ${item}`).join('\n')}
-
-${feature.dependsOn && feature.dependsOn.length > 0 ? `\n⚠️ **Dependencies**: This feature requires: ${feature.dependsOn.join(', ')}\n` : ''}
-
----
-
-## Let's configure this feature
-
-${firstQuestion}
-
----
-
-**Progress**: ${progressBar} 1/${feature.questions.length}
-**Session ID**: \`${sessionId}\`
-
-<details>
-<summary>💡 **Instructions for Claude Code**</summary>
-
-1. Present this question to the user naturally in conversation
-2. When they respond, call \`opensaas_answer_feature\` with:
-   - sessionId: "${sessionId}"
-   - answer: <their response>
-3. Continue the conversation flow with the next question
-4. Keep it natural - don't mention session IDs to the user
-
-</details>`,
-        },
-      ],
-    }
-  }
-
-  /**
-   * Process an answer and move to next question or complete the wizard
-   */
-  async answerQuestion(
-    sessionId: string,
-    answer: string | boolean | string[],
-  ): Promise<{
-    content: Array<{ type: string; text: string }>
-  }> {
-    const session = this.sessions[sessionId]
-    if (!session) {
-      return {
-        content: [
-          {
-            type: 'text',
-            text: `❌ Session not found: ${sessionId}\n\nPlease start a new feature implementation.`,
-          },
-        ],
-      }
-    }
-
-    const currentQ = session.feature.questions[session.currentQuestionIndex]
-
-    // Validate answer
-    const validation = this.validateAnswer(answer, currentQ)
-    if (!validation.valid) {
-      return {
-        content: [
-          {
-            type: 'text',
-            text: `❌ **Invalid answer**: ${validation.message}\n\n${this.renderQuestion(currentQ, session, session.currentQuestionIndex + 1)}`,
-          },
-        ],
-      }
-    }
-
-    // Store answer
-    session.answers[currentQ.id] = answer
-    session.updatedAt = new Date()
-
-    // Check for follow-up questions
-    if (currentQ.followUp) {
-      const shouldAskFollowUp =
-        currentQ.followUp.if === answer ||
-        (typeof currentQ.followUp.if === 'boolean' && currentQ.followUp.if === answer)
-
-      if (shouldAskFollowUp) {
-        const followUpText = `**Follow-up**: ${currentQ.followUp.ask}`
-        return {
-          content: [
-            {
-              type: 'text',
-              text: `✓ Recorded: ${this.formatAnswer(answer)}\n\n${followUpText}\n\n---\n\n💡 **Claude Code**: Ask this follow-up question and call \`opensaas_answer_followup\` with sessionId "${sessionId}" and their response.`,
-            },
-          ],
-        }
-      }
-    }
-
-    // Move to next question
-    session.currentQuestionIndex++
-
-    // Check if complete
-    if (session.currentQuestionIndex >= session.feature.questions.length) {
-      session.isComplete = true
-      return this.generateFeatureImplementation(session)
-    }
-
-    // Render next question
-    const nextQ = session.feature.questions[session.currentQuestionIndex]
-    const questionNum = session.currentQuestionIndex + 1
-    const progressBar = this.renderProgressBar(questionNum, session.feature.questions.length)
-
-    return {
-      content: [
-        {
-          type: 'text',
-          text: `✓ Recorded: ${this.formatAnswer(answer)}\n\n${this.renderQuestion(nextQ, session, questionNum)}\n\n---\n\n**Progress**: ${progressBar} ${questionNum}/${session.feature.questions.length}`,
-        },
-      ],
-    }
-  }
-
-  /**
-   * Handle follow-up question answers
-   */
-  async answerFollowUp(
-    sessionId: string,
-    answer: string,
-  ): Promise<{
-    content: Array<{ type: string; text: string }>
-  }> {
-    const session = this.sessions[sessionId]
-    if (!session) {
-      return {
-        content: [
-          {
-            type: 'text',
-            text: `❌ Session not found: ${sessionId}`,
-          },
-        ],
-      }
-    }
-
-    const currentQ = session.feature.questions[session.currentQuestionIndex]
-    const followUpKey = `${currentQ.id}_followup`
-
-    // Store follow-up answer
-    session.followUpAnswers[followUpKey] = answer
-    session.updatedAt = new Date()
-
-    // Move to next question
-    session.currentQuestionIndex++
-
-    // Check if complete
-    if (session.currentQuestionIndex >= session.feature.questions.length) {
-      session.isComplete = true
-      return this.generateFeatureImplementation(session)
-    }
-
-    // Render next question
-    const nextQ = session.feature.questions[session.currentQuestionIndex]
-    const questionNum = session.currentQuestionIndex + 1
-    const progressBar = this.renderProgressBar(questionNum, session.feature.questions.length)
-
-    return {
-      content: [
-        {
-          type: 'text',
-          text: `✓ Recorded: ${answer}\n\n${this.renderQuestion(nextQ, session, questionNum)}\n\n---\n\n**Progress**: ${progressBar} ${questionNum}/${session.feature.questions.length}`,
-        },
-      ],
-    }
-  }
-
-  /**
-   * Generate the complete feature implementation
-   */
-  private async generateFeatureImplementation(session: WizardSession): Promise<{
-    content: Array<{ type: string; text: string }>
-  }> {
-    const generator = new FeatureGenerator(
-      session.feature,
-      session.answers,
-      session.followUpAnswers,
-    )
-
-    const implementation = generator.generate()
-
-    return {
-      content: [
-        {
-          type: 'text',
-          text: `✅ **${session.feature.name} Implementation Complete!**
-
----
-
-## 📝 Update \`opensaas.config.ts\`
-
-\`\`\`typescript
-${implementation.configUpdates}
-\`\`\`
-
----
-
-## 📁 Create these files:
-
-${implementation.files.map((file) => `### ${file.path}\n*${file.description}*\n\n\`\`\`${file.language}\n${file.content}\n\`\`\``).join('\n\n')}
-
----
-
-${
-  implementation.envVars && Object.keys(implementation.envVars).length > 0
-    ? `## 🔐 Environment Variables\n\nAdd these to your \`.env\` file:\n\n\`\`\`bash\n${Object.entries(
-        implementation.envVars,
-      )
-        .map(([key, value]) => `${key}=${value}`)
-        .join('\n')}\n\`\`\`\n\n---\n\n`
-    : ''
-}
-
-## 🚀 Next Steps
-
-${implementation.nextSteps.map((step, i) => `${i + 1}. ${step}`).join('\n')}
-
----
-
-## 📖 Feature Documentation
-
-Add this to your project's \`DEVELOPMENT.md\`:
-
-\`\`\`markdown
-${implementation.devGuideSection}
-\`\`\`
-
----
-
-🎉 **Your ${session.feature.name} feature is ready to use!**
-
-<details>
-<summary>💡 **Troubleshooting**</summary>
-
-If you encounter issues:
-1. Ensure all dependencies are installed: \`pnpm install\`
-2. Check that environment variables are set correctly
-3. Run \`pnpm generate\` to update Prisma schema
-4. Run \`pnpm db:push\` to update database
-
-For more help, see the docs at https://stack.opensaas.au/
-
-</details>`,
-        },
-      ],
-    }
-  }
-
-  /**
-   * Create a new wizard session
-   */
-  private createSession(sessionId: string, feature: Feature): WizardSession {
-    return {
-      id: sessionId,
-      featureId: feature.id,
-      feature,
-      currentQuestionIndex: 0,
-      answers: {},
-      followUpAnswers: {},
-      isComplete: false,
-      createdAt: new Date(),
-      updatedAt: new Date(),
-    }
-  }
-
-  /**
-   * Generate a unique session ID
-   */
-  private generateSessionId(): string {
-    return `session_${Date.now()}_${Math.random().toString(36).substring(2, 9)}`
-  }
-
-  /**
-   * Render a question for the user
-   */
-  private renderQuestion(
-    question: FeatureQuestion,
-    session: WizardSession,
-    questionNum: number,
-  ): string {
-    let rendered = `**Question ${questionNum}**: ${question.text}\n\n`
-
-    if (question.type === 'select' || question.type === 'multiselect') {
-      rendered += question.options!.map((opt) => `- ${opt}`).join('\n')
-      if (question.type === 'multiselect') {
-        rendered += '\n\n*You can select multiple options (comma-separated)*'
-      }
-    } else if (question.type === 'boolean') {
-      rendered += '*Answer: yes or no*'
-    } else if (question.type === 'textarea') {
-      rendered += '*Provide a detailed response*'
-    }
-
-    if (question.defaultValue !== undefined) {
-      rendered += `\n\n*Default: ${this.formatAnswer(question.defaultValue)}*`
-    }
-
-    return rendered
-  }
-
-  /**
-   * Validate an answer against question requirements
-   */
-  private validateAnswer(
-    answer: string | boolean | string[],
-    question: FeatureQuestion,
-  ): { valid: boolean; message?: string } {
-    if (question.required && !answer) {
-      return { valid: false, message: 'This question is required' }
-    }
-
-    if (question.type === 'boolean' && typeof answer !== 'boolean') {
-      return {
-        valid: false,
-        message: 'Please answer with yes/no or true/false',
-      }
-    }
-
-    if (
-      question.type === 'select' &&
-      question.options &&
-      !question.options.includes(answer as string)
-    ) {
-      return {
-        valid: false,
-        message: `Please select one of: ${question.options.join(', ')}`,
-      }
-    }
-
-    if (question.type === 'multiselect' && question.options) {
-      const answers = Array.isArray(answer) ? answer : [answer]
-      const invalid = answers.filter((a) => typeof a === 'string' && !question.options!.includes(a))
-      if (invalid.length > 0) {
-        return {
-          valid: false,
-          message: `Invalid options: ${invalid.join(', ')}. Valid options: ${question.options.join(', ')}`,
-        }
-      }
-    }
-
-    return { valid: true }
-  }
-
-  /**
-   * Render a progress bar
-   */
-  private renderProgressBar(current: number, total: number): string {
-    const filled = Math.round((current / total) * 10)
-    const empty = 10 - filled
-    return '▓'.repeat(filled) + '░'.repeat(empty)
-  }
-
-  /**
-   * Format an answer for display
-   */
-  private formatAnswer(answer: string | boolean | string[]): string {
-    if (typeof answer === 'boolean') {
-      return answer ? 'Yes' : 'No'
-    }
-    if (Array.isArray(answer)) {
-      return answer.join(', ')
-    }
-    return answer
-  }
-
-  /**
-   * Get session by ID (for debugging/testing)
-   */
-  getSession(sessionId: string): WizardSession | undefined {
-    return this.sessions[sessionId]
-  }
-
-  /**
-   * Clear completed sessions (cleanup)
-   */
-  clearCompletedSessions(): void {
-    Object.keys(this.sessions).forEach((id) => {
-      if (this.sessions[id].isComplete) {
-        delete this.sessions[id]
-      }
-    })
-  }
-}

package/src/mcp/server/index.ts

@@ -1,240 +0,0 @@
-/**
- * OpenSaaS Stack MCP Server - Main entry point
- */
-
-import { Server } from '@modelcontextprotocol/sdk/server/index.js'
-import { StdioServerTransport } from '@modelcontextprotocol/sdk/server/stdio.js'
-import {
-  ListToolsRequestSchema,
-  CallToolRequestSchema,
-  type Tool,
-} from '@modelcontextprotocol/sdk/types.js'
-import { StackMCPServer } from './stack-mcp-server.js'
-
-// Tool definitions
-const TOOLS: Tool[] = [
-  {
-    name: 'opensaas_implement_feature',
-    description:
-      'Start an interactive wizard to implement a complete feature (authentication, blog, comments, file-upload, semantic-search, or custom). Returns step-by-step guidance.',
-    inputSchema: {
-      type: 'object',
-      properties: {
-        feature: {
-          type: 'string',
-          description:
-            'Feature to implement: "authentication", "blog", "comments", "file-upload", "semantic-search", or "custom"',
-          enum: ['authentication', 'blog', 'comments', 'file-upload', 'semantic-search', 'custom'],
-        },
-        description: {
-          type: 'string',
-          description: 'Required if feature is "custom" - describe what you want to build',
-        },
-      },
-      required: ['feature'],
-    },
-  },
-  {
-    name: 'opensaas_answer_feature',
-    description:
-      'Answer a question in the feature implementation wizard. Use this after opensaas_implement_feature to progress through the wizard.',
-    inputSchema: {
-      type: 'object',
-      properties: {
-        sessionId: {
-          type: 'string',
-          description: 'Session ID from the wizard',
-        },
-        answer: {
-          description: 'Your answer to the current question',
-          oneOf: [
-            { type: 'string' },
-            { type: 'boolean' },
-            { type: 'array', items: { type: 'string' } },
-          ],
-        },
-      },
-      required: ['sessionId', 'answer'],
-    },
-  },
-  {
-    name: 'opensaas_answer_followup',
-    description: 'Answer a follow-up question in the wizard flow',
-    inputSchema: {
-      type: 'object',
-      properties: {
-        sessionId: {
-          type: 'string',
-          description: 'Session ID from the wizard',
-        },
-        answer: {
-          type: 'string',
-          description: 'Your answer to the follow-up question',
-        },
-      },
-      required: ['sessionId', 'answer'],
-    },
-  },
-  {
-    name: 'opensaas_feature_docs',
-    description:
-      'Search OpenSaaS Stack documentation for a specific topic. Returns relevant docs with code examples.',
-    inputSchema: {
-      type: 'object',
-      properties: {
-        topic: {
-          type: 'string',
-          description:
-            'Topic to search for (e.g., "access control", "field types", "hooks", "authentication")',
-        },
-      },
-      required: ['topic'],
-    },
-  },
-  {
-    name: 'opensaas_list_features',
-    description: 'List all available features that can be implemented with the wizard',
-    inputSchema: {
-      type: 'object',
-      properties: {},
-    },
-  },
-  {
-    name: 'opensaas_suggest_features',
-    description: 'Get feature suggestions based on what features are already implemented',
-    inputSchema: {
-      type: 'object',
-      properties: {
-        currentFeatures: {
-          type: 'array',
-          items: { type: 'string' },
-          description: 'List of features already implemented (e.g., ["authentication", "blog"])',
-        },
-      },
-    },
-  },
-  {
-    name: 'opensaas_validate_feature',
-    description: 'Validate that a feature is properly implemented according to best practices',
-    inputSchema: {
-      type: 'object',
-      properties: {
-        feature: {
-          type: 'string',
-          description: 'Feature to validate (e.g., "authentication")',
-        },
-        configPath: {
-          type: 'string',
-          description: 'Path to opensaas.config.ts (optional)',
-        },
-      },
-      required: ['feature'],
-    },
-  },
-]
-
-/**
- * Create and start the MCP server
- */
-export async function startMCPServer() {
-  const server = new Server(
-    {
-      name: 'opensaas-stack-mcp',
-      version: '0.1.0',
-    },
-    {
-      capabilities: {
-        tools: {},
-      },
-    },
-  )
-
-  const stackServer = new StackMCPServer()
-
-  // Register tool list handler
-  server.setRequestHandler(ListToolsRequestSchema, async () => {
-    return { tools: TOOLS }
-  })
-
-  // Register tool call handler
-  server.setRequestHandler(CallToolRequestSchema, async (request) => {
-    const { name, arguments: args } = request.params
-
-    try {
-      switch (name) {
-        case 'opensaas_implement_feature':
-          return await stackServer.implementFeature(
-            args as { feature: string; description?: string },
-          )
-
-        case 'opensaas_answer_feature':
-          return await stackServer.answerFeatureQuestion(
-            args as { sessionId: string; answer: string | boolean | string[] },
-          )
-
-        case 'opensaas_answer_followup':
-          return await stackServer.answerFollowUpQuestion(
-            args as { sessionId: string; answer: string },
-          )
-
-        case 'opensaas_feature_docs':
-          return await stackServer.searchFeatureDocs(args as { topic: string })
-
-        case 'opensaas_list_features':
-          return await stackServer.listFeatures()
-
-        case 'opensaas_suggest_features':
-          return await stackServer.suggestFeatures(args as { currentFeatures?: string[] })
-
-        case 'opensaas_validate_feature':
-          return await stackServer.validateFeature(args as { feature: string; configPath?: string })
-
-        default:
-          return {
-            content: [
-              {
-                type: 'text' as const,
-                text: `Unknown tool: ${name}`,
-              },
-            ],
-            isError: true,
-          }
-      }
-    } catch (error) {
-      const errorMessage = error instanceof Error ? error.message : String(error)
-      console.error(`Error executing tool ${name}:`, error)
-
-      return {
-        content: [
-          {
-            type: 'text' as const,
-            text: `Error: ${errorMessage}`,
-          },
-        ],
-        isError: true,
-      }
-    }
-  })
-
-  // Periodic cleanup
-  setInterval(
-    () => {
-      stackServer.cleanup()
-    },
-    1000 * 60 * 15,
-  ) // Every 15 minutes
-
-  // Start server
-  const transport = new StdioServerTransport()
-  await server.connect(transport)
-
-  console.error('OpenSaaS Stack MCP server running on stdio')
-}
-
-// Start if run directly
-if (import.meta.url === `file://${process.argv[1]}`) {
-  startMCPServer().catch((error) => {
-    console.error('Failed to start MCP server:', error)
-    process.exit(1)
-  })
-}