connectry-architect-mcp 0.1.1 → 0.1.2

package/dist/index.js

@@ -183,6 +183,33 @@ function loadOrCreateUserConfig() {
 // src/tools/submit-answer.ts
 import { z } from "zod";
 
+// src/tools/elicit.ts
+async function elicitSingleSelect(mcpServer, message, fieldName, options) {
+  try {
+    const result = await mcpServer.server.elicitInput({
+      mode: "form",
+      message,
+      requestedSchema: {
+        type: "object",
+        properties: {
+          [fieldName]: {
+            type: "string",
+            title: fieldName,
+            oneOf: options.map((o) => ({ const: o.value, title: o.title }))
+          }
+        },
+        required: [fieldName]
+      }
+    });
+    if (result.action === "accept" && result.content) {
+      return result.content[fieldName];
+    }
+    return null;
+  } catch {
+    return null;
+  }
+}
+
 // src/engine/grading.ts
 function gradeAnswer(question, userAnswer) {
   const normalizedAnswer = userAnswer.toUpperCase();
@@ -396,6 +423,17 @@ function registerSubmitAnswer(server2, db2, userConfig2) {
         { key: "handout", label: "Show me the handout" },
         { key: "project", label: "Show me in the reference project" }
       ];
+      const elicitOptions = followUpOptions.map((opt) => ({
+        value: opt.key,
+        title: opt.label
+      }));
+      const elicitMessage = result.isCorrect ? "Nice work! What would you like to do next?" : "What would you like to do next?";
+      const selectedFollowUp = await elicitSingleSelect(
+        server2,
+        elicitMessage,
+        "followUp",
+        elicitOptions
+      );
       const response = {
         questionId: result.questionId,
         isCorrect: result.isCorrect,
@@ -403,7 +441,8 @@ function registerSubmitAnswer(server2, db2, userConfig2) {
         explanation: result.explanation,
         whyYourAnswerWasWrong: result.whyUserWasWrong,
         references: result.references,
-        followUpOptions
+        followUpOptions,
+        ...selectedFollowUp != null ? { selectedFollowUp } : {}
       };
       return {
         content: [{ type: "text", text: JSON.stringify(response, null, 2) }]
@@ -561,6 +600,23 @@ function findUnansweredForTaskStatement(questions, taskStatement, answeredIds) {
 }
 
 // src/tools/get-practice-question.ts
+var OPTION_KEYS = ["A", "B", "C", "D"];
+function formatQuestionText(question) {
+  const lines = [
+    `**Question ${question.id}** (Domain ${question.domainId} | ${question.difficulty})`,
+    "",
+    `**Task:** ${question.taskStatement}`,
+    "",
+    "---",
+    "",
+    question.scenario,
+    "",
+    `**${question.text}**`,
+    "",
+    ...OPTION_KEYS.map((key) => `  **${key}.** ${question.options[key]}`)
+  ];
+  return lines.join("\n");
+}
 function registerGetPracticeQuestion(server2, db2, userConfig2) {
   server2.tool(
     "get_practice_question",
@@ -585,16 +641,39 @@ function registerGetPracticeQuestion(server2, db2, userConfig2) {
           content: [{ type: "text", text: "No more questions available for the selected criteria. Try a different domain or difficulty." }]
         };
       }
-      const response = {
-        questionId: question.id,
-        taskStatement: question.taskStatement,
-        domainId: question.domainId,
-        difficulty: question.difficulty,
-        scenario: question.scenario,
-        text: question.text,
-        options: question.options
-      };
-      return { content: [{ type: "text", text: JSON.stringify(response, null, 2) }] };
+      const questionText = formatQuestionText(question);
+      const elicitOptions = OPTION_KEYS.map((key) => ({
+        value: key,
+        title: `${key}. ${question.options[key]}`
+      }));
+      const selectedAnswer = await elicitSingleSelect(
+        server2,
+        questionText,
+        "answer",
+        elicitOptions
+      );
+      if (selectedAnswer) {
+        const responseText = [
+          questionText,
+          "",
+          "---",
+          "",
+          `**Selected answer: ${selectedAnswer}**`,
+          "",
+          `Use submit_answer with questionId "${question.id}" and answer "${selectedAnswer}" to grade this response.`
+        ].join("\n");
+        return { content: [{ type: "text", text: responseText }] };
+      }
+      const fallbackText = [
+        questionText,
+        "",
+        "---",
+        "",
+        `Question ID: ${question.id}`,
+        "",
+        "Use submit_answer with the question ID and your chosen answer (A, B, C, or D) to check your response."
+      ].join("\n");
+      return { content: [{ type: "text", text: fallbackText }] };
     }
   );
 }
@@ -1044,38 +1123,48 @@ function registerStartPracticeExam(server2, db2, userConfig2) {
         return `  D${domainId}: ${title} \u2014 ${count} questions (${domainScores[`d${domainId}`].weight}%)`;
       });
       const firstQuestion = examQuestions[0];
+      const text = [
+        "\u2550\u2550\u2550 PRACTICE EXAM STARTED \u2550\u2550\u2550",
+        "",
+        "Simulating the Claude Certified Architect \u2014 Foundations exam.",
+        "",
+        `Exam ID: ${examId}`,
+        "Total Questions: 60",
+        "Passing Score: 720/1000",
+        "",
+        "Question Distribution:",
+        ...distribution,
+        "",
+        "\u2500\u2500\u2500 Question 1 of 60 \u2500\u2500\u2500",
+        "",
+        `Domain: D${firstQuestion.domainId}`,
+        `Task: ${firstQuestion.taskStatement}`,
+        `Difficulty: ${firstQuestion.difficulty}`,
+        "",
+        `Scenario: ${firstQuestion.scenario}`,
+        "",
+        firstQuestion.text,
+        "",
+        `A) ${firstQuestion.options.A}`,
+        `B) ${firstQuestion.options.B}`,
+        `C) ${firstQuestion.options.C}`,
+        `D) ${firstQuestion.options.D}`,
+        "",
+        `[Submit your answer using submit_exam_answer with examId: ${examId} and questionId: "${firstQuestion.id}"]`
+      ].join("\n");
+      const selected = await elicitSingleSelect(server2, "Select your answer:", "answer", [
+        { value: "A", title: `A) ${firstQuestion.options.A}` },
+        { value: "B", title: `B) ${firstQuestion.options.B}` },
+        { value: "C", title: `C) ${firstQuestion.options.C}` },
+        { value: "D", title: `D) ${firstQuestion.options.D}` }
+      ]);
+      const responseText = selected !== null ? `${text}
+
+User selected: ${selected}` : text;
       return {
         content: [{
           type: "text",
-          text: [
-            "\u2550\u2550\u2550 PRACTICE EXAM STARTED \u2550\u2550\u2550",
-            "",
-            "Simulating the Claude Certified Architect \u2014 Foundations exam.",
-            "",
-            `Exam ID: ${examId}`,
-            "Total Questions: 60",
-            "Passing Score: 720/1000",
-            "",
-            "Question Distribution:",
-            ...distribution,
-            "",
-            "\u2500\u2500\u2500 Question 1 of 60 \u2500\u2500\u2500",
-            "",
-            `Domain: D${firstQuestion.domainId}`,
-            `Task: ${firstQuestion.taskStatement}`,
-            `Difficulty: ${firstQuestion.difficulty}`,
-            "",
-            `Scenario: ${firstQuestion.scenario}`,
-            "",
-            firstQuestion.text,
-            "",
-            `A) ${firstQuestion.options.A}`,
-            `B) ${firstQuestion.options.B}`,
-            `C) ${firstQuestion.options.C}`,
-            `D) ${firstQuestion.options.D}`,
-            "",
-            `[Submit your answer using submit_exam_answer with examId: ${examId} and questionId: "${firstQuestion.id}"]`
-          ].join("\n")
+          text: responseText
         }]
       };
     }
@@ -1193,6 +1282,15 @@ function registerSubmitExamAnswer(server2, db2, userConfig2) {
             lines.push(`B) ${nextQuestion.options.B}`);
             lines.push(`C) ${nextQuestion.options.C}`);
             lines.push(`D) ${nextQuestion.options.D}`);
+            const selected = await elicitSingleSelect(server2, "Select your answer:", "answer", [
+              { value: "A", title: `A) ${nextQuestion.options.A}` },
+              { value: "B", title: `B) ${nextQuestion.options.B}` },
+              { value: "C", title: `C) ${nextQuestion.options.C}` },
+              { value: "D", title: `D) ${nextQuestion.options.D}` }
+            ]);
+            if (selected !== null) {
+              lines.push("", `User selected: ${selected}`);
+            }
           }
         }
       }
@@ -2214,6 +2312,16 @@ function handleAbandon(db2, userId) {
     buildId: build.id
   });
 }
+function appendSelectedAction(response, selected) {
+  if (!selected) return response;
+  const existingText = response.content[0].text;
+  return {
+    ...response,
+    content: [{ type: "text", text: `${existingText}
+
+User selected next action: ${selected}` }]
+  };
+}
 function registerCapstoneBuildStep(server2, db2, userConfig2) {
   server2.tool(
     "capstone_build_step",
@@ -2225,8 +2333,17 @@ function registerCapstoneBuildStep(server2, db2, userConfig2) {
       const userId = userConfig2.userId;
       ensureUser(db2, userId);
       switch (action) {
-        case "confirm":
-          return handleConfirm(db2, userId);
+        case "confirm": {
+          const result = handleConfirm(db2, userId);
+          if ("isError" in result) return result;
+          const selected = await elicitSingleSelect(
+            server2,
+            "Build confirmed! What would you like to do next?",
+            "nextAction",
+            [{ value: "quiz", title: "Start the first quiz" }]
+          );
+          return appendSelectedAction(result, selected);
+        }
         case "quiz":
           return handleQuiz(db2, userId);
         case "build": {
@@ -2237,10 +2354,33 @@ function registerCapstoneBuildStep(server2, db2, userConfig2) {
           if (build.status !== "building") {
             return errorResponse(`Build must be in "building" status. Current status: "${build.status}".`);
           }
-          return handleBuild(db2, userId, build);
+          const result = handleBuild(db2, userId, build);
+          if ("isError" in result) return result;
+          const selected = await elicitSingleSelect(
+            server2,
+            "Build instructions generated. What would you like to do next?",
+            "nextAction",
+            [
+              { value: "next", title: "Advance to the next step" },
+              { value: "status", title: "Check build progress" }
+            ]
+          );
+          return appendSelectedAction(result, selected);
+        }
+        case "next": {
+          const result = handleNext(db2, userId);
+          if ("isError" in result) return result;
+          const selected = await elicitSingleSelect(
+            server2,
+            "Step advanced. What would you like to do next?",
+            "nextAction",
+            [
+              { value: "quiz", title: "Start this step's quiz" },
+              { value: "status", title: "Check build progress" }
+            ]
+          );
+          return appendSelectedAction(result, selected);
         }
-        case "next":
-          return handleNext(db2, userId);
         case "status":
           return handleStatus(db2, userId);
         case "abandon":