Vibe-Coder MCP Server

Implementation Reference

• src/tool-handlers.ts:93-152 (handler)

  The main handler function for the 'provide_clarification' tool. It validates input using the schema, retrieves the feature, appends the clarification response, saves it, determines the next question, and returns appropriate response.

  const provideClarificationHandler: ToolHandler<z.infer<typeof ProvideClarificationSchema>> = async (params) => {
    try {
      const { featureId, question, answer } = ProvideClarificationSchema.parse(params);
      
      console.log(`\n[CLARIFICATION] Received request for feature ${featureId}\n  Question: "${question.substring(0, 50)}..."\n  Answer: "${answer.substring(0, 50)}..."`);
      
      // Get the feature
      const feature = getFeature(featureId);
      if (!feature) {
        console.log(`[CLARIFICATION] Feature ID ${featureId} not found`);
        return featureNotFoundError(featureId);
      }
      
      console.log(`[CLARIFICATION] Found feature: ${feature.name} with ${feature.clarificationResponses.length} existing responses`);
      
      // Add the clarification response to the feature
      feature.clarificationResponses.push({
        question,
        answer,
        timestamp: new Date()
      });
      
      console.log(`[CLARIFICATION] Added response, now has ${feature.clarificationResponses.length} responses`);
      
      // Save the feature with the updated clarification response
      updateFeature(featureId, feature);
      
      // Get the next question or indicate all questions are answered
      const nextQuestion = getNextClarificationQuestion(feature);
      
      if (nextQuestion) {
        // Check if nextQuestion is a string before using substring
        const questionPreview = typeof nextQuestion === 'string' 
          ? nextQuestion.substring(0, 50) + "..." 
          : "All questions answered";
        console.log(`[CLARIFICATION] Returning next question: "${questionPreview}"`);
        return {
          content: [{
            type: "text",
            text: `Response recorded. ${nextQuestion}`
          }]
        };
      } else {
        // All questions answered
        console.log(`[CLARIFICATION] All questions answered`);
        return {
          content: [{
            type: "text",
            text: "All clarification questions have been answered. You can now generate a PRD for this feature."
          }]
        };
      }
    } catch (error) {
      if (error instanceof z.ZodError) {
        const errorMessage = error.errors.map(e => `${e.path.join('.')}: ${e.message}`).join(', ');
        return createToolErrorResponse(`Validation error: ${errorMessage}`);
      }
      return createToolErrorResponse(error instanceof Error ? error.message : "Unknown error");
    }
  };

• src/tool-handlers.ts:84-88 (schema)

  Zod schema defining the input parameters for the provide_clarification tool: featureId, question, and answer.

  const ProvideClarificationSchema = z.object({
    featureId: z.string().min(1),
    question: z.string().min(1),
    answer: z.string().min(1)
  });

• src/tool-handlers.ts:540-574 (registration)

  Registration of the 'provide_clarification' tool in the toolRegistry, including name, handler, description, JSON schema, and examples.

  toolRegistry.register(
    'provide_clarification', 
    provideClarificationHandler,
    'Provide answer to a clarification question',
    {
      type: "object",
      properties: {
        featureId: {
          type: "string",
          description: "ID of the feature"
        },
        question: {
          type: "string",
          description: "Clarification question"
        },
        answer: {
          type: "string",
          description: "Answer to the clarification question"
        }
      },
      required: ["featureId", "question", "answer"]
    },
    [
      {
        featureId: "feature-123",
        question: "What problem does this feature solve?",
        answer: "This feature solves the problem of users forgetting their passwords by providing a secure password reset flow."
      },
      {
        featureId: "feature-456",
        question: "Who are the target users?",
        answer: "The target users are administrators who need to manage user accounts and permissions."
      }
    ]
  );

• src/mcp-server.ts:321-363 (handler)

  Alternative direct implementation of the 'provide_clarification' tool using server.tool, with inline schema and handler logic similar to tool-handlers.ts.

  server.tool(
    "provide_clarification",
    {
      featureId: z.string().min(1),
      question: z.string().min(1),
      answer: z.string().min(1)
    },
    async ({ featureId, question, answer }) => {
      // Get the feature
      const feature = getFeature(featureId);
      if (!feature) {
        throw new Error(`Feature ${featureId} not found`);
      }
      
      // Add the clarification response to the feature
      feature.clarificationResponses.push({
        question,
        answer,
        timestamp: new Date()
      });
      
      // Save the feature with the updated clarification response
      updateFeature(featureId, feature);
      
      // Get the next question or indicate all questions are answered
      const nextQuestion = getNextClarificationQuestion(feature);
      
      if (nextQuestion) {
        return {
          content: [{
            type: "text",
            text: `Response recorded. ${nextQuestion}`
          }]
        };
      } else {
        // All questions answered
        return {
          content: [{
            type: "text",
            text: "All clarification questions have been answered. You can now generate a PRD for this feature."
          }]
        };
      }