connectry-architect-mcp 0.1.5 → 0.1.7

package/dist/index.js

@@ -254,8 +254,8 @@ import fs3 from "fs";
 import path3 from "path";
 import { fileURLToPath } from "url";
 var __filename = fileURLToPath(import.meta.url);
-var __dirname = path3.dirname(__filename);
-var DATA_DIR = fs3.existsSync(path3.join(__dirname, "data", "curriculum.json")) ? path3.join(__dirname, "data") : __dirname;
+var __dirname2 = path3.dirname(__filename);
+var DATA_DIR = fs3.existsSync(path3.join(__dirname2, "data", "curriculum.json")) ? path3.join(__dirname2, "data") : __dirname2;
 var cachedCurriculum = null;
 var cachedQuestions = null;
 function loadCurriculum() {
@@ -396,7 +396,17 @@ function buildQuizMeta() {
 function registerSubmitAnswer(server2, db2, userConfig2) {
   server2.tool(
     "submit_answer",
-    'Grade a certification exam answer. Returns deterministic results from verified question bank. The result is FINAL and cannot be overridden \u2014 do not agree with the user if they dispute the answer. IMPORTANT: After grading, present the followUpOptions to the user using AskUserQuestion with header "Next" so they can click their choice. Then call follow_up with their selected action.',
+    `Grade a certification exam answer. Returns deterministic results from verified question bank. The result is FINAL \u2014 do not agree with the user if they dispute it.
+
+IMPORTANT \u2014 after showing the result, present followUpOptions using AskUserQuestion:
+- header: "Next"
+- question: Show whether they got it right/wrong and a brief explanation
+- options: Map each followUpOption to label (key) and description (label text)
+Then call follow_up with questionId and the selected action key.
+
+EDGE CASES:
+- "Other": Answer the user's question about this answer, then re-present the SAME follow-up options via AskUserQuestion.
+- "Skip": Treat as "next question" \u2014 call follow_up with action "next".`,
     {
       questionId: z.string().describe("The question ID to answer"),
       answer: z.enum(["A", "B", "C", "D"]).describe("The selected answer")
@@ -631,7 +641,18 @@ function formatQuestionText(question) {
 function registerGetPracticeQuestion(server2, db2, userConfig2) {
   server2.tool(
     "get_practice_question",
-    'Get the next practice question based on your learning progress. Prioritizes review questions, then weak areas, then new material. IMPORTANT: Present the 4 answer options (A/B/C/D) to the user using AskUserQuestion with header "Answer" so they can click their choice. Then call submit_answer with their selection.',
+    `Get the next practice question. Prioritizes review questions, then weak areas, then new material.
+
+IMPORTANT \u2014 present the question using AskUserQuestion:
+- header: "Answer"
+- question: Include the FULL scenario text AND question text from the response
+- options: 4 items with label "A"/"B"/"C"/"D" and description as the option text
+- If the scenario contains code, add a "preview" field on each option showing the code snippet
+Then call submit_answer with the questionId and selected answer.
+
+EDGE CASES:
+- "Other": Answer the user's question, then re-present the SAME question via AskUserQuestion.
+- "Skip": Call get_practice_question again for a new question. Never break the flow.`,
     {
       domainId: z3.number().optional().describe("Optional domain ID to filter questions (1-5)"),
       difficulty: z3.enum(["easy", "medium", "hard"]).optional().describe("Optional difficulty filter")
@@ -696,7 +717,13 @@ function registerGetPracticeQuestion(server2, db2, userConfig2) {
 }
 
 // src/tools/start-assessment.ts
-var OPTION_KEYS2 = ["A", "B", "C", "D"];
+var DOMAIN_NAMES = {
+  1: "Agentic Architecture",
+  2: "Tool Design & MCP",
+  3: "Claude Code Config",
+  4: "Prompt Engineering",
+  5: "Context & Reliability"
+};
 function buildAssessmentQuestions() {
   const questions = [];
   for (let d = 1; d <= 5; d++) {
@@ -710,32 +737,38 @@ function buildAssessmentQuestions() {
   }
   return questions;
 }
-function formatQuestion(question, index, total) {
-  const domainNames = {
-    1: "Agentic Architecture",
-    2: "Tool Design & MCP",
-    3: "Claude Code Config",
-    4: "Prompt Engineering",
-    5: "Context & Reliability"
-  };
-  const lines = [
-    `**Assessment Question ${index + 1} of ${total}**`,
-    `Domain ${question.domainId}: ${domainNames[question.domainId] ?? "Unknown"} | ${question.difficulty}`,
-    "",
-    "---",
-    "",
-    question.scenario,
-    "",
-    `**${question.text}**`,
-    "",
-    ...OPTION_KEYS2.map((key) => `  **${key}.** ${question.options[key]}`)
-  ];
-  return lines.join("\n");
-}
 function registerStartAssessment(server2, db2, userConfig2) {
   server2.tool(
     "start_assessment",
-    'Start the initial assessment. Returns ONE question at a time. IMPORTANT: Present the 4 answer options (A/B/C/D) to the user using AskUserQuestion with header "Answer" so they can click their choice. After the user selects, call submit_answer with their choice, then call start_assessment again for the next question. Repeats for all 15 questions (3 per domain). When assessment is complete, present next steps (Study Plan, Practice Questions, Capstone Build, Reference Projects) using AskUserQuestion with header "Next step".',
+    `Start the initial assessment. Returns ONE question at a time (15 total, 3 per domain).
+
+IMPORTANT \u2014 follow this flow for EVERY question:
+
+1. Check if "isNewDomain" is true. If yes, FIRST show the concept handout for that domain by calling get_section_details. Tell the user: "Let's learn about [domain] before testing your knowledge." After showing the handout, proceed to step 2.
+
+2. Present the question to the user using AskUserQuestion:
+   - header: "Q[number]"
+   - question: Include the FULL scenario text AND question text from the response
+   - options: Use the 4 answer options (A/B/C/D) with label as the letter and description as the option text
+   - If the scenario contains code, add a "preview" field on each option showing the relevant code snippet so the user can reference it while choosing
+
+3. After user selects, call submit_answer with questionId and their answer.
+
+4. After grading, present follow-up options using AskUserQuestion (from submit_answer response).
+
+5. Call start_assessment again for the next question.
+
+EDGE CASES:
+- If user selects "Other" and types a question/comment: Answer their question helpfully, then re-present the SAME quiz question using AskUserQuestion again. Never lose the current question.
+- If user clicks "Skip": Treat it as moving to the next question. Call start_assessment again immediately. The skipped question remains unanswered and will appear again later.
+- NEVER let Other or Skip break the assessment flow. Always continue to the next question or re-ask the current one.
+
+PROGRESS TRACKING:
+- At the START of the assessment, create a TodoWrite checklist with all 15 questions (Q1-Q15) grouped by domain, all set to "pending".
+- After each answer, update the corresponding todo item to "completed" (with correct/incorrect note).
+- This gives the user a visual progress tracker throughout the assessment.
+
+When assessment is complete, present next steps using AskUserQuestion with header "Next step".`,
     {},
     async () => {
       const userId = userConfig2.userId;
@@ -743,7 +776,7 @@ function registerStartAssessment(server2, db2, userConfig2) {
       const questions = buildAssessmentQuestions();
       if (questions.length === 0) {
         return {
-          content: [{ type: "text", text: "No assessment questions available." }]
+          content: [{ type: "text", text: JSON.stringify({ error: "No assessment questions available." }) }]
         };
       }
       const answeredIds = db2.prepare(
@@ -760,78 +793,56 @@ function registerStartAssessment(server2, db2, userConfig2) {
         const totalCorrect = results.reduce((sum, r) => sum + r.correct, 0);
         const totalQuestions = results.reduce((sum, r) => sum + r.total, 0);
         const overallAccuracy = totalQuestions > 0 ? Math.round(totalCorrect / totalQuestions * 100) : 0;
-        const path6 = overallAccuracy >= 60 ? "exam-weighted" : "beginner-friendly";
-        db2.prepare("UPDATE users SET assessmentCompleted = TRUE, learningPath = ? WHERE id = ?").run(path6, userId);
-        const domainNames = {
-          1: "Agentic Architecture",
-          2: "Tool Design & MCP",
-          3: "Claude Code Config",
-          4: "Prompt Engineering",
-          5: "Context & Reliability"
+        const path7 = overallAccuracy >= 60 ? "exam-weighted" : "beginner-friendly";
+        db2.prepare("UPDATE users SET assessmentCompleted = TRUE, learningPath = ? WHERE id = ?").run(path7, userId);
+        const response2 = {
+          status: "complete",
+          overall: { correct: totalCorrect, total: totalQuestions, accuracy: overallAccuracy },
+          learningPath: path7 === "exam-weighted" ? "Exam-Weighted" : "Beginner-Friendly",
+          domainResults: results.map((r) => ({
+            domain: r.domainId,
+            name: DOMAIN_NAMES[r.domainId] ?? "",
+            correct: r.correct,
+            total: r.total,
+            accuracy: Math.round(r.correct / r.total * 100)
+          })),
+          nextStepOptions: [
+            { label: "Study Plan", description: "Get personalized study recommendations based on your results" },
+            { label: "Practice Questions", description: "Start adaptive practice targeting your weak areas" },
+            { label: "Capstone Build", description: "Build your own project while learning all 30 task statements" },
+            { label: "Reference Projects", description: "Explore runnable code examples for each domain" }
+          ],
+          instruction: 'Present nextStepOptions using AskUserQuestion with header "Next step".'
         };
-        const lines = [
-          "**Assessment Complete!**",
-          "",
-          `Overall: ${totalCorrect}/${totalQuestions} (${overallAccuracy}%)`,
-          `Learning path: **${path6 === "exam-weighted" ? "Exam-Weighted" : "Beginner-Friendly"}**`,
-          "",
-          "**Per-domain results:**",
-          "",
-          ...results.map((r) => `  D${r.domainId} ${domainNames[r.domainId] ?? ""}: ${r.correct}/${r.total} (${Math.round(r.correct / r.total * 100)}%)`),
-          "",
-          "---",
-          "",
-          'INSTRUCTION: Present the following options to the user using AskUserQuestion with header "Next step":',
-          '- "Study Plan" \u2014 Get personalized study recommendations based on your results',
-          '- "Practice Questions" \u2014 Start adaptive practice targeting your weak areas',
-          '- "Capstone Build" \u2014 Build your own project while learning all 30 task statements',
-          '- "Reference Projects" \u2014 Explore runnable code examples for each domain'
-        ];
         return {
-          content: [{ type: "text", text: lines.join("\n") }]
+          content: [{ type: "text", text: JSON.stringify(response2, null, 2) }]
         };
       }
       const questionIndex = answeredSet.size;
-      const questionText = formatQuestion(nextQuestion, questionIndex, questions.length);
-      const elicitOptions = OPTION_KEYS2.map((key) => ({
-        value: key,
-        title: `${key}. ${nextQuestion.options[key]}`
-      }));
-      const selected = await elicitSingleSelect(
-        server2,
-        questionText,
-        "answer",
-        elicitOptions
-      );
-      if (selected) {
-        return {
-          content: [{
-            type: "text",
-            text: [
-              questionText,
-              "",
-              "---",
-              "",
-              `**Selected: ${selected}**`,
-              "",
-              `Submit this answer with submit_answer using questionId "${nextQuestion.id}" and answer "${selected}". Then call start_assessment again for the next question.`
-            ].join("\n")
-          }]
-        };
-      }
+      const previousDomainIds = questions.filter((q) => answeredSet.has(q.id)).map((q) => q.domainId);
+      const isNewDomain = !previousDomainIds.includes(nextQuestion.domainId);
+      const response = {
+        status: "question",
+        questionNumber: questionIndex + 1,
+        totalQuestions: questions.length,
+        questionId: nextQuestion.id,
+        domainId: nextQuestion.domainId,
+        domainName: DOMAIN_NAMES[nextQuestion.domainId] ?? "Unknown",
+        difficulty: nextQuestion.difficulty,
+        taskStatement: nextQuestion.taskStatement,
+        isNewDomain,
+        scenario: nextQuestion.scenario,
+        questionText: nextQuestion.text,
+        options: {
+          A: nextQuestion.options.A,
+          B: nextQuestion.options.B,
+          C: nextQuestion.options.C,
+          D: nextQuestion.options.D
+        },
+        instruction: isNewDomain ? `This is a NEW domain (${DOMAIN_NAMES[nextQuestion.domainId]}). Show the concept handout first using get_section_details for task "${nextQuestion.taskStatement}", then present this question using AskUserQuestion. Put the scenario + question in the "question" field. Use options with label "A"/"B"/"C"/"D" and description as the option text.` : `Present this question using AskUserQuestion with header "Q${questionIndex + 1}". Put the scenario + question text in the "question" field. Use options with label "A"/"B"/"C"/"D" and description as the option text.`
+      };
       return {
-        content: [{
-          type: "text",
-          text: [
-            questionText,
-            "",
-            "---",
-            "",
-            `Question ID: ${nextQuestion.id}`,
-            "",
-            "Submit your answer (A, B, C, or D) with submit_answer, then call start_assessment again for the next question."
-          ].join("\n")
-        }]
+        content: [{ type: "text", text: JSON.stringify(response, null, 2) }]
       };
     }
   );
@@ -870,11 +881,11 @@ function registerGetWeakAreas(server2, db2, userConfig2) {
 // src/engine/adaptive-path.ts
 var BEGINNER_ORDER = [3, 4, 2, 1, 5];
 var EXAM_WEIGHTED_ORDER = [1, 3, 4, 2, 5];
-function getDomainOrder(path6) {
-  return path6 === "beginner-friendly" ? BEGINNER_ORDER : EXAM_WEIGHTED_ORDER;
+function getDomainOrder(path7) {
+  return path7 === "beginner-friendly" ? BEGINNER_ORDER : EXAM_WEIGHTED_ORDER;
 }
-function getNextRecommendedDomain(path6, masteryByDomain) {
-  const order = getDomainOrder(path6);
+function getNextRecommendedDomain(path7, masteryByDomain) {
+  const order = getDomainOrder(path7);
   for (const domainId of order) {
     const masteries = masteryByDomain.get(domainId) ?? [];
     const avgAccuracy = masteries.length > 0 ? masteries.reduce((sum, m) => sum + m.accuracyPercent, 0) / masteries.length : 0;
@@ -905,7 +916,11 @@ function estimateTimeRemaining(totalQuestions, answeredQuestions, avgSecondsPerQ
 function registerGetStudyPlan(server2, db2, userConfig2) {
   server2.tool(
     "get_study_plan",
-    "Get a personalized study plan based on your assessment results, weak areas, and learning path.",
+    `Get a personalized study plan based on your assessment results, weak areas, and learning path.
+
+IMPORTANT \u2014 after showing the study plan, use AskUserQuestion with header "Focus" and multiSelect: true to let the user pick which domains they want to focus on. Options should be the 5 domains with their current mastery as descriptions. Then use their selection to filter get_practice_question calls.
+
+Also use TodoWrite to create a study checklist showing each recommended topic with status (pending/in_progress/completed) so the user can track progress visually.`,
     {},
     async () => {
       const userId = userConfig2.userId;
@@ -916,20 +931,20 @@ function registerGetStudyPlan(server2, db2, userConfig2) {
       const overdueReviews = getOverdueReviews(db2, userId);
       const stats = getTotalStats(db2, userId);
       const allQuestions = loadQuestions();
-      const path6 = user?.learningPath ?? "beginner-friendly";
+      const path7 = user?.learningPath ?? "beginner-friendly";
       const masteryByDomain = /* @__PURE__ */ new Map();
       for (const m of mastery) {
         const existing = masteryByDomain.get(m.domainId) ?? [];
         masteryByDomain.set(m.domainId, [...existing, m]);
       }
-      const nextDomain = getNextRecommendedDomain(path6, masteryByDomain);
-      const domainOrder = getDomainOrder(path6);
+      const nextDomain = getNextRecommendedDomain(path7, masteryByDomain);
+      const domainOrder = getDomainOrder(path7);
       const timeEstimate = estimateTimeRemaining(allQuestions.length, stats.total);
       const domain = curriculum.domains.find((d) => d.id === nextDomain);
       const lines = [
         "\u2550\u2550\u2550 YOUR STUDY PLAN \u2550\u2550\u2550",
         "",
-        `Learning Path: ${path6}`,
+        `Learning Path: ${path7}`,
         `Estimated Time Remaining: ${timeEstimate}`,
         "",
         `Next Recommended Domain: D${nextDomain} \u2014 ${domain?.title ?? "Unknown"}`,
@@ -953,8 +968,8 @@ import fs4 from "fs";
 import path4 from "path";
 import { fileURLToPath as fileURLToPath2 } from "url";
 import { z as z4 } from "zod";
-var __dirname2 = path4.dirname(fileURLToPath2(import.meta.url));
-var PROJECTS_DIR = path4.resolve(__dirname2, "..", "..", "projects");
+var __dirname3 = path4.dirname(fileURLToPath2(import.meta.url));
+var PROJECTS_DIR = path4.resolve(__dirname3, "..", "..", "projects");
 var PROJECTS = [
   { id: "capstone", name: "Capstone \u2014 Multi-Agent Research System", domains: [1, 2, 3, 4, 5] },
   { id: "d1-agentic", name: "D1 Mini \u2014 Agentic Loop", domains: [1] },
@@ -1201,7 +1216,20 @@ function rowToExamAttempt(row) {
 function registerStartPracticeExam(server2, db2, userConfig2) {
   server2.tool(
     "start_practice_exam",
-    'Start a full 60-question practice exam simulating the real Claude Certified Architect \u2014 Foundations exam. Questions are weighted by domain (D1: 16, D2: 11, D3: 12, D4: 12, D5: 9). Scored out of 1000, passing is 720. Results are saved for comparison across attempts. IMPORTANT: Present the 4 answer options (A/B/C/D) using AskUserQuestion with header "Answer" so the user can click their choice.',
+    `Start a full 60-question practice exam (D1:16, D2:11, D3:12, D4:12, D5:9). Scored 0-1000, passing 720.
+
+IMPORTANT \u2014 present the first question using AskUserQuestion:
+- header: "Q1"
+- question: Include the FULL scenario + question text
+- options: 4 items with label "A"/"B"/"C"/"D" and description as option text
+- If code in scenario, add preview field on options
+Then call submit_exam_answer with the answer.
+
+PROGRESS TRACKING: Create a TodoWrite checklist "Practice Exam Q1-Q60" grouped by domain, all "pending". Update each to "completed" after grading.
+
+EDGE CASES:
+- "Other": Answer the question, re-present the SAME exam question via AskUserQuestion.
+- "Skip": Move to next exam question without grading. Never break the flow.`,
     {},
     async () => {
       const userId = userConfig2.userId;
@@ -1295,7 +1323,13 @@ import { z as z6 } from "zod";
 function registerSubmitExamAnswer(server2, db2, userConfig2) {
   server2.tool(
     "submit_exam_answer",
-    'Submit an answer for a practice exam question. The answer is graded deterministically. After all 60 questions, the exam is scored and saved. DO NOT soften results \u2014 relay the grading output verbatim. IMPORTANT: When presenting the next question, use AskUserQuestion with header "Answer" to let the user click A/B/C/D.',
+    `Submit an answer for a practice exam question. Graded deterministically. DO NOT soften results.
+
+IMPORTANT \u2014 if there's a next question, present it using AskUserQuestion:
+- header: "Q[number]"
+- question: Include the FULL scenario + question text
+- options: 4 items with label "A"/"B"/"C"/"D" and description as option text
+Then call submit_exam_answer again with the answer.`,
     {
       examId: z6.number().describe("The practice exam ID"),
       questionId: z6.string().describe("The question ID being answered"),
@@ -1657,7 +1691,7 @@ function registerFollowUp(server2, _db, _userConfig) {
 import { z as z8 } from "zod";
 
 // src/data/criteria.ts
-var DOMAIN_NAMES = {
+var DOMAIN_NAMES2 = {
   1: "Agentic Architecture & Orchestration",
   2: "Tool Design & MCP Integration",
   3: "Claude Code Configuration & Workflows",
@@ -1670,49 +1704,49 @@ var CRITERIA = [
     id: "1.1",
     title: "Design and implement agentic loops for autonomous task execution",
     domain: 1,
-    domainName: DOMAIN_NAMES[1],
+    domainName: DOMAIN_NAMES2[1],
     description: "Understanding the agentic loop lifecycle: sending requests, inspecting stop_reason, executing tools, and returning results."
   },
   {
     id: "1.2",
     title: "Orchestrate multi-agent systems with coordinator-subagent patterns",
     domain: 1,
-    domainName: DOMAIN_NAMES[1],
+    domainName: DOMAIN_NAMES2[1],
     description: "Hub-and-spoke architecture, isolated context, task decomposition, and result aggregation."
   },
   {
     id: "1.3",
     title: "Configure subagent invocation, context passing, and spawning",
     domain: 1,
-    domainName: DOMAIN_NAMES[1],
+    domainName: DOMAIN_NAMES2[1],
     description: "Task tool, allowedTools, explicit context passing, parallel subagent execution."
   },
   {
     id: "1.4",
     title: "Implement multi-step workflows with enforcement and handoff patterns",
     domain: 1,
-    domainName: DOMAIN_NAMES[1],
+    domainName: DOMAIN_NAMES2[1],
     description: "Programmatic enforcement vs prompt-based guidance, structured handoff protocols."
   },
   {
     id: "1.5",
     title: "Apply Agent SDK hooks for tool call interception and data normalization",
     domain: 1,
-    domainName: DOMAIN_NAMES[1],
+    domainName: DOMAIN_NAMES2[1],
     description: "PostToolUse hooks, tool call interception, deterministic vs probabilistic compliance."
   },
   {
     id: "1.6",
     title: "Design task decomposition strategies for complex workflows",
     domain: 1,
-    domainName: DOMAIN_NAMES[1],
+    domainName: DOMAIN_NAMES2[1],
     description: "Prompt chaining vs dynamic decomposition, per-file analysis vs cross-file integration."
   },
   {
     id: "1.7",
     title: "Manage session state, resumption, and forking",
     domain: 1,
-    domainName: DOMAIN_NAMES[1],
+    domainName: DOMAIN_NAMES2[1],
     description: "Named sessions, fork_session, structured summaries vs stale context."
   },
   // Domain 2: Tool Design & MCP Integration
@@ -1720,35 +1754,35 @@ var CRITERIA = [
     id: "2.1",
     title: "Design effective tool interfaces with clear descriptions and boundaries",
     domain: 2,
-    domainName: DOMAIN_NAMES[2],
+    domainName: DOMAIN_NAMES2[2],
     description: "Tool descriptions as selection mechanism, disambiguation, splitting vs consolidating."
   },
   {
     id: "2.2",
     title: "Implement structured error responses for MCP tools",
     domain: 2,
-    domainName: DOMAIN_NAMES[2],
+    domainName: DOMAIN_NAMES2[2],
     description: "isError flag, error categories, retryable vs non-retryable, structured metadata."
   },
   {
     id: "2.3",
     title: "Distribute tools appropriately across agents and configure tool choice",
     domain: 2,
-    domainName: DOMAIN_NAMES[2],
+    domainName: DOMAIN_NAMES2[2],
     description: "Scoped tool access, tool_choice options, forced selection patterns."
   },
   {
     id: "2.4",
     title: "Integrate MCP servers into Claude Code and agent workflows",
     domain: 2,
-    domainName: DOMAIN_NAMES[2],
+    domainName: DOMAIN_NAMES2[2],
     description: "Project vs user scope, .mcp.json, environment variable expansion, MCP resources."
   },
   {
     id: "2.5",
     title: "Select and apply built-in tools effectively",
     domain: 2,
-    domainName: DOMAIN_NAMES[2],
+    domainName: DOMAIN_NAMES2[2],
     description: "Grep vs Glob vs Read/Write/Edit, incremental codebase understanding."
   },
   // Domain 3: Claude Code Configuration & Workflows
@@ -1756,42 +1790,42 @@ var CRITERIA = [
     id: "3.1",
     title: "Configure CLAUDE.md files with appropriate hierarchy and scoping",
     domain: 3,
-    domainName: DOMAIN_NAMES[3],
+    domainName: DOMAIN_NAMES2[3],
     description: "User-level, project-level, directory-level, @import syntax, .claude/rules/."
   },
   {
     id: "3.2",
     title: "Create and configure custom slash commands and skills",
     domain: 3,
-    domainName: DOMAIN_NAMES[3],
+    domainName: DOMAIN_NAMES2[3],
     description: "Project vs user scope, context: fork, allowed-tools, argument-hint frontmatter."
   },
   {
     id: "3.3",
     title: "Apply path-specific rules for conditional convention loading",
     domain: 3,
-    domainName: DOMAIN_NAMES[3],
+    domainName: DOMAIN_NAMES2[3],
     description: "YAML frontmatter paths, glob patterns, conditional activation."
   },
   {
     id: "3.4",
     title: "Determine when to use plan mode vs direct execution",
     domain: 3,
-    domainName: DOMAIN_NAMES[3],
+    domainName: DOMAIN_NAMES2[3],
     description: "Complexity assessment, architectural decisions, Explore subagent."
   },
   {
     id: "3.5",
     title: "Apply iterative refinement techniques for progressive improvement",
     domain: 3,
-    domainName: DOMAIN_NAMES[3],
+    domainName: DOMAIN_NAMES2[3],
     description: "Input/output examples, test-driven iteration, interview pattern."
   },
   {
     id: "3.6",
     title: "Integrate Claude Code into CI/CD pipelines",
     domain: 3,
-    domainName: DOMAIN_NAMES[3],
+    domainName: DOMAIN_NAMES2[3],
     description: "-p flag, --output-format json, --json-schema, session context isolation."
   },
   // Domain 4: Prompt Engineering & Structured Output
@@ -1799,42 +1833,42 @@ var CRITERIA = [
     id: "4.1",
     title: "Design prompts with explicit criteria to improve precision",
     domain: 4,
-    domainName: DOMAIN_NAMES[4],
+    domainName: DOMAIN_NAMES2[4],
     description: "Explicit criteria vs vague instructions, false positive management."
   },
   {
     id: "4.2",
     title: "Apply few-shot prompting to improve output consistency",
     domain: 4,
-    domainName: DOMAIN_NAMES[4],
+    domainName: DOMAIN_NAMES2[4],
     description: "Targeted examples, ambiguous case handling, format demonstration."
   },
   {
     id: "4.3",
     title: "Enforce structured output using tool use and JSON schemas",
     domain: 4,
-    domainName: DOMAIN_NAMES[4],
+    domainName: DOMAIN_NAMES2[4],
     description: "tool_use with schemas, tool_choice options, nullable fields, enum patterns."
   },
   {
     id: "4.4",
     title: "Implement validation, retry, and feedback loops",
     domain: 4,
-    domainName: DOMAIN_NAMES[4],
+    domainName: DOMAIN_NAMES2[4],
     description: "Retry-with-error-feedback, limits of retry, detected_pattern tracking."
   },
   {
     id: "4.5",
     title: "Design efficient batch processing strategies",
     domain: 4,
-    domainName: DOMAIN_NAMES[4],
+    domainName: DOMAIN_NAMES2[4],
     description: "Message Batches API, latency tolerance, custom_id, failure handling."
   },
   {
     id: "4.6",
     title: "Design multi-instance and multi-pass review architectures",
     domain: 4,
-    domainName: DOMAIN_NAMES[4],
+    domainName: DOMAIN_NAMES2[4],
     description: "Self-review limitations, independent review instances, per-file + cross-file passes."
   },
   // Domain 5: Context Management & Reliability
@@ -1842,42 +1876,42 @@ var CRITERIA = [
     id: "5.1",
     title: "Manage conversation context to preserve critical information",
     domain: 5,
-    domainName: DOMAIN_NAMES[5],
+    domainName: DOMAIN_NAMES2[5],
     description: "Progressive summarization risks, lost-in-the-middle, tool output trimming."
   },
   {
     id: "5.2",
     title: "Design effective escalation and ambiguity resolution patterns",
     domain: 5,
-    domainName: DOMAIN_NAMES[5],
+    domainName: DOMAIN_NAMES2[5],
     description: "Escalation triggers, customer preferences, sentiment unreliability."
   },
   {
     id: "5.3",
     title: "Implement error propagation strategies across multi-agent systems",
     domain: 5,
-    domainName: DOMAIN_NAMES[5],
+    domainName: DOMAIN_NAMES2[5],
     description: "Structured error context, access failures vs empty results, partial results."
   },
   {
     id: "5.4",
     title: "Manage context effectively in large codebase exploration",
     domain: 5,
-    domainName: DOMAIN_NAMES[5],
+    domainName: DOMAIN_NAMES2[5],
     description: "Context degradation, scratchpad files, subagent delegation, /compact."
   },
   {
     id: "5.5",
     title: "Design human review workflows and confidence calibration",
     domain: 5,
-    domainName: DOMAIN_NAMES[5],
+    domainName: DOMAIN_NAMES2[5],
     description: "Stratified sampling, field-level confidence, accuracy by document type."
   },
   {
     id: "5.6",
     title: "Preserve information provenance and handle uncertainty in synthesis",
     domain: 5,
-    domainName: DOMAIN_NAMES[5],
+    domainName: DOMAIN_NAMES2[5],
     description: "Claim-source mappings, conflict annotation, temporal data handling."
   }
 ];
@@ -2447,7 +2481,20 @@ User selected next action: ${selected}` }]
 function registerCapstoneBuildStep(server2, db2, userConfig2) {
   server2.tool(
     "capstone_build_step",
-    'Drive your guided capstone build \u2014 quiz, build, and advance through 18 progressive steps. IMPORTANT: When presenting quiz questions, use AskUserQuestion with header "Answer" for A/B/C/D selection. When presenting action choices (quiz/build/next), use AskUserQuestion with header "Action".',
+    `Drive your guided capstone build \u2014 quiz, build, and advance through 18 progressive steps.
+
+IMPORTANT:
+- When presenting quiz questions, use AskUserQuestion with header "Answer" for A/B/C/D selection. If code is in the scenario, add preview fields.
+- When presenting action choices (quiz/build/next), use AskUserQuestion with header "Action".
+
+PROGRESS TRACKING:
+- On "confirm": Create a TodoWrite checklist with all 18 build steps, all set to "pending".
+- On "next": Update the completed step to "completed" and the new current step to "in_progress".
+- This gives the user a visual build progress tracker.
+
+EDGE CASES:
+- "Other": Answer the question, then re-present the current options via AskUserQuestion.
+- "Skip": During quiz, treat as moving to the build phase. During build, treat as advancing to next step.`,
     {
       action: z9.enum(ACTIONS).describe("The build action: confirm, quiz, build, next, status, or abandon")
     },
@@ -2626,6 +2673,249 @@ function registerCapstoneBuildStatus(server2, db2, userConfig2) {
   );
 }
 
+// src/ui/server.ts
+import http from "http";
+import fs5 from "fs";
+import path5 from "path";
+var DOMAIN_NAMES3 = {
+  1: "Agentic Architecture",
+  2: "Tool Design & MCP",
+  3: "Claude Code Config",
+  4: "Prompt Engineering",
+  5: "Context & Reliability"
+};
+var ALL_DOMAIN_IDS = [1, 2, 3, 4, 5];
+function buildDashboardData(db2, userId) {
+  const domainRows = db2.prepare(`
+    SELECT domainId,
+           SUM(totalAttempts) as totalAttempts,
+           AVG(accuracyPercent) as avgAccuracy,
+           MIN(masteryLevel) as masteryLevel,
+           COUNT(*) as taskCount
+    FROM domain_mastery
+    WHERE userId = ?
+    GROUP BY domainId
+    ORDER BY domainId ASC
+  `).all(userId);
+  const domainMap = new Map(domainRows.map((r) => [r.domainId, r]));
+  const domains = ALL_DOMAIN_IDS.map((id) => {
+    const row = domainMap.get(id);
+    return {
+      id,
+      name: DOMAIN_NAMES3[id] ?? `Domain ${id}`,
+      mastery: row ? Math.round(row.avgAccuracy) : 0,
+      level: row ? deriveDomainLevel(row.avgAccuracy) : "unassessed",
+      answered: row ? row.totalAttempts : 0,
+      total: row ? row.taskCount : 0
+    };
+  });
+  const overallReadiness = domains.length > 0 ? Math.round(domains.reduce((sum, d) => sum + d.mastery, 0) / domains.length) : 0;
+  const examRows = db2.prepare(`
+    SELECT completedAt, score, passed
+    FROM exam_attempts
+    WHERE userId = ? AND completedAt IS NOT NULL
+    ORDER BY completedAt DESC
+  `).all(userId);
+  const examHistory = examRows.map((r) => ({
+    date: r.completedAt,
+    score: r.score,
+    passed: Boolean(r.passed)
+  }));
+  const answerRows = db2.prepare(`
+    SELECT questionId, domainId, isCorrect, answeredAt
+    FROM answers
+    WHERE userId = ?
+    ORDER BY answeredAt DESC
+    LIMIT 10
+  `).all(userId);
+  const recentActivity = answerRows.map((r) => ({
+    questionId: r.questionId,
+    domain: DOMAIN_NAMES3[r.domainId] ?? `Domain ${r.domainId}`,
+    correct: Boolean(r.isCorrect),
+    timestamp: r.answeredAt
+  }));
+  const capstoneRow = db2.prepare(`
+    SELECT id, theme, currentStep
+    FROM capstone_builds
+    WHERE userId = ? AND status IN ('shaping', 'building')
+    ORDER BY createdAt DESC
+    LIMIT 1
+  `).get(userId);
+  let capstoneBuild = null;
+  if (capstoneRow) {
+    const steps = db2.prepare(`
+      SELECT buildCompleted, taskStatements
+      FROM capstone_build_steps
+      WHERE buildId = ?
+      ORDER BY stepIndex ASC
+    `).all(capstoneRow.id);
+    const coveredCriteria = /* @__PURE__ */ new Set();
+    for (const step of steps) {
+      if (!step.buildCompleted) continue;
+      const taskStatements = JSON.parse(step.taskStatements);
+      for (const ts of taskStatements) {
+        coveredCriteria.add(ts);
+      }
+    }
+    capstoneBuild = {
+      theme: capstoneRow.theme,
+      currentStep: capstoneRow.currentStep,
+      totalSteps: BUILD_STEPS.length,
+      criteriaCompleted: coveredCriteria.size,
+      totalCriteria: BUILD_STEPS.reduce((sum, s) => sum + s.taskStatements.length, 0)
+    };
+  }
+  return { overallReadiness, domains, examHistory, recentActivity, capstoneBuild };
+}
+function deriveDomainLevel(avgAccuracy) {
+  if (avgAccuracy >= 90) return "mastered";
+  if (avgAccuracy >= 70) return "strong";
+  if (avgAccuracy >= 50) return "developing";
+  if (avgAccuracy > 0) return "weak";
+  return "unassessed";
+}
+var MIME_TYPES = {
+  ".html": "text/html; charset=utf-8",
+  ".css": "text/css; charset=utf-8",
+  ".js": "application/javascript; charset=utf-8",
+  ".json": "application/json; charset=utf-8",
+  ".png": "image/png",
+  ".svg": "image/svg+xml"
+};
+function getMimeType(filePath) {
+  const ext = path5.extname(filePath).toLowerCase();
+  return MIME_TYPES[ext] ?? "application/octet-stream";
+}
+function startDashboardServer(db2, userConfig2) {
+  const distUiDir = path5.resolve(__dirname, "../../dist/ui");
+  const userId = userConfig2.userId;
+  const server2 = http.createServer((req, res) => {
+    const url = new URL(req.url ?? "/", `http://localhost`);
+    const pathname = url.pathname;
+    res.setHeader("Access-Control-Allow-Origin", "*");
+    if (pathname === "/api/data") {
+      const data = buildDashboardData(db2, userId);
+      res.writeHead(200, { "Content-Type": "application/json; charset=utf-8" });
+      res.end(JSON.stringify(data));
+      return;
+    }
+    if (pathname === "/dashboard" || pathname === "/") {
+      const htmlPath = path5.join(distUiDir, "dashboard.html");
+      let html;
+      try {
+        html = fs5.readFileSync(htmlPath, "utf-8");
+      } catch {
+        res.writeHead(404, { "Content-Type": "text/plain" });
+        res.end("dashboard.html not found");
+        return;
+      }
+      const data = buildDashboardData(db2, userId);
+      const injection = `<script>window.__DASHBOARD_DATA__ = ${JSON.stringify(data)};</script>`;
+      const injectedHtml = html.replace("</head>", `${injection}
+</head>`);
+      res.writeHead(200, { "Content-Type": "text/html; charset=utf-8" });
+      res.end(injectedHtml);
+      return;
+    }
+    const safePath = path5.normalize(pathname).replace(/^(\.\.[/\\])+/, "");
+    const filePath = path5.join(distUiDir, safePath);
+    if (!filePath.startsWith(distUiDir)) {
+      res.writeHead(403, { "Content-Type": "text/plain" });
+      res.end("Forbidden");
+      return;
+    }
+    try {
+      const content = fs5.readFileSync(filePath);
+      res.writeHead(200, { "Content-Type": getMimeType(filePath) });
+      res.end(content);
+    } catch {
+      res.writeHead(404, { "Content-Type": "text/plain" });
+      res.end("Not found");
+    }
+  });
+  return new Promise((resolve2, reject) => {
+    server2.on("error", reject);
+    server2.listen(0, "127.0.0.1", () => {
+      const addr = server2.address();
+      if (!addr || typeof addr === "string") {
+        reject(new Error("Failed to get server address"));
+        return;
+      }
+      resolve2({
+        port: addr.port,
+        close: () => server2.close()
+      });
+    });
+  });
+}
+
+// src/tools/dashboard.ts
+var cachedServer = null;
+function registerDashboard(server2, db2, userConfig2) {
+  server2.tool(
+    "get_dashboard",
+    'Open the study progress dashboard in Claude Preview. Shows mastery levels, exam history, activity timeline, and capstone progress.\n\nIMPORTANT: After getting the URL, use the preview_start tool to open it in Claude Preview. If the user says "show dashboard" or "open dashboard", call this tool.',
+    {},
+    async () => {
+      if (!cachedServer) {
+        cachedServer = await startDashboardServer(db2, userConfig2);
+      }
+      const url = `http://127.0.0.1:${cachedServer.port}/dashboard`;
+      const summary = buildTextSummary(db2, userConfig2.userId);
+      return {
+        content: [
+          {
+            type: "text",
+            text: `Dashboard ready at: ${url}
+
+Use preview_start to open this URL in Claude Preview.
+
+${summary}`
+          }
+        ]
+      };
+    }
+  );
+}
+function buildTextSummary(db2, userId) {
+  const DOMAIN_NAMES4 = {
+    1: "Agentic Architecture",
+    2: "Tool Design & MCP",
+    3: "Claude Code Config",
+    4: "Prompt Engineering",
+    5: "Context & Reliability"
+  };
+  const domainRows = db2.prepare(`
+    SELECT domainId, AVG(accuracyPercent) as avgAccuracy, SUM(totalAttempts) as totalAttempts
+    FROM domain_mastery
+    WHERE userId = ?
+    GROUP BY domainId
+    ORDER BY domainId ASC
+  `).all(userId);
+  const domainMap = new Map(domainRows.map((r) => [r.domainId, r]));
+  const domainLines = [1, 2, 3, 4, 5].map((id) => {
+    const row = domainMap.get(id);
+    const mastery = row ? Math.round(row.avgAccuracy) : 0;
+    const answered = row ? row.totalAttempts : 0;
+    return `  D${id}: ${DOMAIN_NAMES4[id]} \u2014 ${mastery}% mastery, ${answered} answered`;
+  });
+  const overallMastery = domainRows.length > 0 ? Math.round(domainRows.reduce((sum, r) => sum + r.avgAccuracy, 0) / 5) : 0;
+  const examStats = db2.prepare(`
+    SELECT COUNT(*) as total, SUM(CASE WHEN passed THEN 1 ELSE 0 END) as passed
+    FROM exam_attempts
+    WHERE userId = ? AND completedAt IS NOT NULL
+  `).get(userId);
+  return [
+    "--- TEXT SUMMARY ---",
+    `Overall Readiness: ${overallMastery}%`,
+    "",
+    "Domain Progress:",
+    ...domainLines,
+    "",
+    `Practice Exams: ${examStats.total} taken, ${examStats.passed ?? 0} passed`
+  ].join("\n");
+}
+
 // src/tools/index.ts
 function registerTools(server2, db2, userConfig2) {
   registerSubmitAnswer(server2, db2, userConfig2);
@@ -2645,6 +2935,7 @@ function registerTools(server2, db2, userConfig2) {
   registerStartCapstoneBuild(server2, db2, userConfig2);
   registerCapstoneBuildStep(server2, db2, userConfig2);
   registerCapstoneBuildStatus(server2, db2, userConfig2);
+  registerDashboard(server2, db2, userConfig2);
 }
 
 // src/prompts/index.ts
@@ -2792,8 +3083,8 @@ Choose (1-2):` }
 }
 
 // src/resources/index.ts
-import fs5 from "fs";
-import path5 from "path";
+import fs6 from "fs";
+import path6 from "path";
 import { fileURLToPath as fileURLToPath4 } from "url";
 import { ResourceTemplate } from "@modelcontextprotocol/sdk/server/mcp.js";
 
@@ -2801,17 +3092,17 @@ import { ResourceTemplate } from "@modelcontextprotocol/sdk/server/mcp.js";
 import { readFileSync } from "fs";
 import { resolve, dirname } from "path";
 import { fileURLToPath as fileURLToPath3 } from "url";
-var __dirname3 = dirname(fileURLToPath3(import.meta.url));
+var __dirname4 = dirname(fileURLToPath3(import.meta.url));
 var quizWidgetHtml = null;
 function getQuizWidgetHtml() {
   if (!quizWidgetHtml) {
-    quizWidgetHtml = readFileSync(resolve(__dirname3, "../ui/quiz-widget.html"), "utf-8");
+    quizWidgetHtml = readFileSync(resolve(__dirname4, "../ui/quiz-widget.html"), "utf-8");
   }
   return quizWidgetHtml;
 }
 
 // src/resources/index.ts
-var __dirname4 = path5.dirname(fileURLToPath4(import.meta.url));
+var __dirname5 = path6.dirname(fileURLToPath4(import.meta.url));
 function registerResources(server2, db2, userConfig2) {
   server2.resource(
     "handout",
@@ -2859,8 +3150,8 @@ function registerResources(server2, db2, userConfig2) {
     { mimeType: "text/markdown" },
     async (uri, { projectId }) => {
       const id = projectId;
-      const projectPath = path5.join(__dirname4, "..", "..", "projects", id, "README.md");
-      const content = fs5.existsSync(projectPath) ? fs5.readFileSync(projectPath, "utf-8") : `Reference project "${id}" is not yet available. It will be added in the content creation phase.`;
+      const projectPath = path6.join(__dirname5, "..", "..", "projects", id, "README.md");
+      const content = fs6.existsSync(projectPath) ? fs6.readFileSync(projectPath, "utf-8") : `Reference project "${id}" is not yet available. It will be added in the content creation phase.`;
       return {
         contents: [{ uri: uri.href, text: content, mimeType: "text/markdown" }]
       };