connectry-architect-mcp 0.1.6 → 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() {
@@ -402,7 +402,11 @@ IMPORTANT \u2014 after showing the result, present followUpOptions using AskUser
 - 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.`,
+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")
@@ -643,7 +647,12 @@ 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
-Then call submit_answer with the questionId and selected answer.`,
+- 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")
@@ -741,6 +750,7 @@ IMPORTANT \u2014 follow this flow for EVERY question:
    - 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.
 
@@ -748,6 +758,16 @@ IMPORTANT \u2014 follow this flow for EVERY question:
 
 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 () => {
@@ -773,12 +793,12 @@ When assessment is complete, present next steps using AskUserQuestion with heade
         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 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: path6 === "exam-weighted" ? "Exam-Weighted" : "Beginner-Friendly",
+          learningPath: path7 === "exam-weighted" ? "Exam-Weighted" : "Beginner-Friendly",
           domainResults: results.map((r) => ({
             domain: r.domainId,
             name: DOMAIN_NAMES[r.domainId] ?? "",
@@ -861,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;
@@ -896,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;
@@ -907,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"}`,
@@ -944,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] },
@@ -1198,7 +1222,14 @@ 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
-Then call submit_exam_answer with the answer.`,
+- 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;
@@ -2450,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")
     },
@@ -2629,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);
@@ -2648,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
@@ -2795,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";
 
@@ -2804,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",
@@ -2862,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" }]
       };